Deep Research Report

assetactive

Deep Research Report: Completing Missing Content Across the Alawein Workspace

Workspace-level audit of 17 GitHub repositories identifying governance gaps, documentation drift, CI trustworthiness issues, and metadata inconsistencies — with drafted content packs for each gap.

Provenance

Ingested from Workspace_Tools/deep-research-report.md (46KB) on 2026-03-28. Generated via Deep Research with GitHub and Notion connectors.

Executive Summary

Across 17 repositories, the dominant missing-content pattern is credibility and coherence debt, not "more features":

  • Governance contract gaps: _pkos lacks SSOT.md, root README.md, and explicit license file
  • Documentation drift: qmlab and simcore have templated READMEs not substantiated by SSOTs/CI
  • CI trustworthiness gaps: several repos run partial checks or ignore failures (gymboy), or only run tests without lint/type/build (qmlab, simcore)
  • Metadata inconsistencies: projects.json says repzcoach.com for Repz; repo README says repazapp.com
  • "Planning repo" implementation hole: adil CLI subcommands all stub as "Not yet implemented"

Prioritized Missing Items

| Missing Item | Repos | Priority | |---|---|---| | Add SSOT.md + README.md for hub repo | pkos | P0 | | Add SSOT.md | loopholelab | P0 | | Make CI non-blocking → blocking (remove \|\| true) | gymboy, qmlab, simcore | P0 | | Resolve domain drift (projects.json vs README) | repz | P0 | | Fix Python version consistency (badge vs pyproject vs Ruff) | edfp | P0 | | Fix impossible future timestamps in SSOT/AGENTS | neper | P0 | | Add CI workflow | scicomp | P1 | | Replace templated READMEs with SSOT-aligned docs | qmlab, simcore | P1 | | Implement minimal functional CLI core | adil | P1 | | CI for static site build verification | chshlab | P2 |

Repository Inventory

| Repo | Language | CI Status | License | Key Issue | |---|---|---|---|---| | alawein | Markdown/YAML | Unspecified | Unspecified | Workspace contract hub | | pkos | Markdown/YAML | Unspecified | Missing | Missing SSOT + README | | docs | Markdown | Unspecified | Unspecified | Cross-repo standards | | meshal-web | TS (React/Vite) | Strong | MIT | Gold standard exemplar | | repz | TS (React/Vite) | Multi-job CI | MIT | Domain drift | | gymboy | TS (React/Vite) | Non-blocking | MIT implied | CI ignores failures | | qmlab | TS (React/Vite) | Playwright only | MIT claimed | Missing lint/type/build in CI | | simcore | TS (React/Vite) | npm test only | MIT claimed | Missing lint/type/build in CI | | bolts | TS (Next.js) | Good | MIT | Baseline Tier-1 | | scribd | TS (Next.js) | Close to real | MIT claimed | Thin README | | edfp | Python | ruff/mypy/pytest | MIT | Version inconsistencies | | neper | Python | ruff/mypy/pytest | MIT | Future timestamps, naming | | scicomp | Python+MATLAB | No CI | MIT | Missing CI entirely | | loopholelab | Python+FastAPI | pytest only | Unspecified | Missing SSOT, needs secrets docs | | chshlab | HTML/CSS/JS | No CI | Unspecified | Static site, intentionally minimal | | helios | Markdown | Unspecified | Proprietary | Archive repo | | adil | Python | ruff/mypy/pytest | MIT | Stub-only CLI |

Drafted Content Packs

The report includes drop-in drafts for:

  • pkos/README.md and pkos/SSOT.md
  • loopholelab/SSOT.md
  • Replacement CI workflows for gymboy, qmlab, and simcore (lint/type/test/build as hard gates, Node 22)
  • SSOT-aligned README replacements for qmlab and simcore
  • edfp Python version + Ruff target-version patch
  • neper timestamp fix + docs/CONFIG.md for Pydantic nested settings
  • adil minimal implementation: store.py, ingest.py, search.py, test_store.py

Implementation Timeline

  • P0 (days 1-2): pkos docs, loopholelab SSOT, CI hardening, repz domain fix, edfp version fix
  • P1 (days 3-7): adil functional baseline, scicomp CI, neper fixes
  • P2 (week 2+): chshlab CI, loopholelab lint/type gates

External References Used

  • Vercel Build Output API spec
  • GitHub Actions official release lines (checkout@v4, setup-node@v4)
  • PEP 621 / PyPA pyproject specification
  • Ruff configuration docs (target-version)
  • Pydantic settings docs (env_nested_delimiter)
  • Contributor Covenant v2.1