ai-dev-workspace 0.1.0b5__py3-none-any.whl

ai_dev_workspace-0.1.0b5.dist-info/METADATA

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: ai-dev-workspace
+Version: 0.1.0b5
+Summary: Shared task memory for AI coding assistants: Claude Code, Codex, Cursor, Copilot, Gemini CLI
+Home-page: https://github.com/Alenroyfeild/ai-dev-workspace
+License: MIT
+Project-URL: Documentation, https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/OVERVIEW.md
+Project-URL: Changelog, https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/Alenroyfeild/ai-dev-workspace/issues
+Project-URL: Source, https://github.com/Alenroyfeild/ai-dev-workspace
+Keywords: ai coding assistant memory claude-code codex cursor copilot gemini-cli mcp agents context handoff
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-python
+Dynamic: summary
+
+# AI Dev Workspace
+
+Switch between Claude Code and Codex without re-explaining your decisions. Your assistant remembers work between sessions in Markdown you own. It keeps decisions, the next step and what not to retry, and warns when files it names changed or disappeared. Try it before connecting a repo: `ws demo` · [5-minute tutorial](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/TUTORIAL.md) · [remove it](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/TUTORIAL.md#remove-it)
+<!-- Demo GIF -->
+## Quick start
+
+```bash
+pipx install ai-dev-workspace --pip-args='--pre'  # beta; omit --pip-args after a stable release
+cd ~/code/myapp && ws start
+```
+Without pipx: `python3 -m venv ~/.local/share/ai-dev-workspace && ~/.local/share/ai-dev-workspace/bin/pip install --pre ai-dev-workspace`; put its `bin` directory on `PATH` before `ws start`. Prefer a Claude Code plugin? See the [plugin preview](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/ADVANCED.md#claude-code-plugin-preview).
+## Example
+```text
+Session 1 — You: “Empty email returns missing_email; leave signup unchanged.”
+Assistant: “I’ll trace login and keep the decision with this task.”
+You: “Stop here; I’ll resume tomorrow.”
+Session 2 — You: “Continue the login fix.”
+Assistant: “The saved note says return missing_email and leave signup unchanged.”
+You: “Yes, continue.”
+```
+## Results (small synthetic samples, not general productivity)
+| Session 1 → session 2 | Without workspace | With workspace |
+|---|---:|---:|
+| Claude Code → Claude Code | 0/5 | **5/5** |
+| Claude Code → Codex | 0/5 | **5/5** |
+| Codex → Codex | 0/3 | **3/3** |
+
+Later Codex → Codex runs (n=5 each) were less favourable: the workspace passed 1/5 and 2/5, while a plain `HANDOFF.md` control passed 4/5 and 5/5. See [bench/README.md](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/bench/README.md).
+## Team sharing
+Your notes stay private. Share only what you approve, and your teammates' assistants start with it: after `ws start`, `ws team init <private-repo> --attest-private` (`--yes` in scripts) · `ws know add "Payments API rejects floats" --category domain --team` · `ws sync`. A teammate runs `ws team link <private-repo>`; their next brief shows the note, labelled as shared team context, and their own decisions still win. [Team quick start](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/TEAM-WORKSPACE.md#quick-start)
+## Compatibility
+| Client | macOS | Linux/Windows |
+|---|---|---|
+| Claude Code | supported, tested live on macOS | CI-tested |
+| Codex | supported, tested live on macOS | CI-tested |
+| Cursor | supported, fixture-tested; live reports welcome | CI-tested |
+| Copilot (VS Code) | supported, fixture-tested; live reports welcome | CI-tested |
+| Gemini CLI | supported, fixture-tested; live reports welcome | CI-tested |
+
+Testers on Cursor, Copilot (VS Code), or Gemini CLI: please share problems through [Something broke](https://github.com/Alenroyfeild/ai-dev-workspace/issues/new?template=bug.yml). · [Overview](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/OVERVIEW.md) · [Setup](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/SETUP.md) · [Commands](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/COMMANDS.md) · [Keeping corrections](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/COMMANDS.md#save-a-correction) · [Measurements](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/MEASUREMENTS.md) · [Client verification](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/CLIENT-VERIFICATION.md) · [Packs](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/PACKS.md) · [Team use](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/TEAM.md) · [Windows](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/WINDOWS.md) · [Roadmap](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/docs/ROADMAP.md) · [License](https://github.com/Alenroyfeild/ai-dev-workspace/blob/main/LICENSE) <!-- mcp-name: io.github.Alenroyfeild/ai-dev-workspace mcp-name: io.github.alenroyfeild/ai-dev-workspace -->

ai_dev_workspace-0.1.0b5.dist-info/RECORD

@@ -0,0 +1,130 @@
+ai_dev_workspace-0.1.0b5.dist-info/licenses/LICENSE,sha256=VmThDBN3Ouh53UKIIKI2083jz-oVePvykDZyqYrC8z4,1086
+ws/LICENSE,sha256=VmThDBN3Ouh53UKIIKI2083jz-oVePvykDZyqYrC8z4,1086
+ws/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ws/assist.py,sha256=U_Y6EDBENrvqhjAnBfxZYoy9nrEVdY3sOBAYizz5LA4,13614
+ws/audit.py,sha256=0hzWZqskQp7fBuHxZP_1cmn8Jn0IxEbwp4bp2VEBLoY,6305
+ws/cards.py,sha256=McIITUScoj3uwBBzrSbeav_eEkEUKC8D1ZZFbIri_p4,6543
+ws/cli.py,sha256=KdodBXAtpac4KyZCNtcmju-9OEO9iPUi26IJXaLJRMQ,70202
+ws/codeburn.py,sha256=vrhiVDsnpFn_t51Zs_QUilXjpxSfqUG0O8RusHonbPA,4982
+ws/core.py,sha256=3y4OM_aYJicFzLp1d1IxOK_AHfdyPELaL-vsjEXe8R4,180937
+ws/demo.py,sha256=v1sjiNozbhySwid4zITLTZSuCMZWqeuNUDZ0SiJf-qk,2732
+ws/discipline.py,sha256=NreQfSqEBs9JbIA8Ck859lCtZa99AzufvKnteIjxwVk,3695
+ws/folder_io.py,sha256=u_TFhz046wzH_XlUlnNhzX0J1NhswjDJzr8qSgYAzsw,4593
+ws/folder_publish.py,sha256=eYUJTr_IsVJbXvrGUmZo1Y2nZtL1P7xw5bq6s8fEEp8,5188
+ws/guards.py,sha256=2nbeXj4Z_dWQN8ib_qgibKlz0RXeSZWSjbQ5AyFTKTg,40230
+ws/kit.json,sha256=OzcAgQI1dK4NJDepTbXEetFbdSWwt1OA85EJIIm352Q,95
+ws/knowledge.py,sha256=D_44PtPHEbboLuHwsk2znXpWmMzDRHTZkc1U9nldEEw,12135
+ws/memory_import.py,sha256=pGsBGeGynX7vcEAYKT3k8AJzzAeUKrGZrRqAQzqfaSs,5396
+ws/native.py,sha256=10kT8f3efMeMq-TJBle-dEiZxp7P-DidwXNPTKZonoc,8925
+ws/orchestration.py,sha256=3sIRb7TJVSqfTnmlsCot3yGLqVKftu88m5KLJAHEv78,24717
+ws/packaging.py,sha256=u5PPDKYGrr14Kxx6WrGSz4uDtY9x_uBgJW8UuAtU7ug,233
+ws/packs.py,sha256=86LrZyAqRdwFj-RC9HO7sOcviOz0APWF9ZrAzsUHzaM,7766
+ws/plugin_runtime.py,sha256=lsx1BSUzc2al1tps830Zpt_hvRc2KqkDFBJFaVOxabg,1723
+ws/repo.py,sha256=oOwl35zxgxwafN-gxEnx2jY4QMjLdYG5Ifw3sG6Ezo4,46774
+ws/scope.py,sha256=N96HdCeGGup-20uhBISbPP_tg0VCSyubrZ9j9NIrY2Q,3299
+ws/setup.py,sha256=eLIdP8K47PIuKqEyu4FiUPwWbhQBpJQkRY65v5gB4PA,7839
+ws/sharing.py,sha256=cVTjUEXUrKPZaspQWfSpAOlL56mLJO1CrHFa32U4TsQ,15385
+ws/team.py,sha256=E2cdcWecXzEWjnRih0YwhooujVHzac-tUzyeVy1Kqw4,8747
+ws/team_auto.py,sha256=dCN06NmPJUXe5sgCsyZ6ZXr7AGvtbXDG_J1DmyqohoQ,5292
+ws/team_folder.py,sha256=1KIC0PMIVqoWOTNH72j1MPSUECxDo2xqUy4-E247sWI,12104
+ws/team_status.py,sha256=90iTHXVFZZH0x_EuHxsexIvtthtEiWifvUbQfey2ofs,6356
+ws/team_sync.py,sha256=-Dv8xIGgpQOpayum27wXyqD-EZlhXsA8kpdY2lpEF4E,11012
+ws/team_ui.py,sha256=FW3EXCey4QXarBHb9LSZOgmKa50rLCfArw0Ndgj9aXs,4289
+ws/tools.json,sha256=Cu5ePl0Bl_iOqj1NaMdmxpYuucsQlVMwhCBJ9qWQ6mk,3544
+ws/transcripts.py,sha256=uwygj22sMF5Ve8aN-CRBIkAMUIxc1AXvSSGi-2GHDXk,5315
+ws/upgrade.py,sha256=rbt4GBsmPhCgedka3Q-KRBSMeWmg26H5iyGmuNeFrgs,13538
+ws/workers.py,sha256=dQpCJf4UEJHLg0_4bhoK-b9a2Pnx9Po3oDshb7NcVZ4,29328
+ws/bin/publish-release,sha256=y6IckmC69LD6NqnrBOUGTJdSXcOSVz6ApuObzaJjpzQ,967
+ws/bin/release-smoke,sha256=dRmsSO9U9kScju2FeBas6pSmjC2wxHIFCC6kAQw5N6A,16796
+ws/bin/ws,sha256=KXjWUVdLuQEltNi9v59cXvGiXuuMj0-nVKzirW4uLrw,412
+ws/bin/ws-plugin,sha256=G3L52WubOOukkced-nNldvhd9ArqLZ5EF_NaX6RdRHE,374
+ws/bin/ws-python,sha256=IBZ4oZ_GNiEdWUSaSoPQtLrfOVma1seqVZvHbKCLRUI,469
+ws/docs/ADVANCED.md,sha256=mz_dTsH9NarwmtcfxwlP4WN9VP7kZjfnnP2OWbuyqhI,10550
+ws/docs/AGENT-ORCHESTRATION.md,sha256=orYX2ZvGj99ocyTHUDAkdefR40zArueYTgb__wKZu1s,9026
+ws/docs/ARCHITECTURE.md,sha256=NbCDWIzsQwQ8JCepo43jvkpNj2eSKa7S9FlCf8qtplk,5119
+ws/docs/ASSIST-FEATURES.md,sha256=vzJJgrk3Zebppnx2WWb4nkXlnK4sUwQ7809UrdJEx8c,668
+ws/docs/CLIENT-VERIFICATION.md,sha256=s4I439kTFmUtAF4VRYi3sb1mO_GQgfgupLJCQQL6G0M,7596
+ws/docs/COMMANDS.md,sha256=2aF-mMhyCJdyTjfCf8-tgpecTk4GvcWY3xGEZfkFJT8,37952
+ws/docs/CONCEPTS.md,sha256=8pMD_ybe4k7gww0aQmC9s9dcb4KJLX1EL_c997OThfA,2819
+ws/docs/DEMO.md,sha256=a06fDLFtYxEssxoNRUNsNeDDuI41MqdVQweeRzm-xbY,3730
+ws/docs/MAINTAINING.md,sha256=TNov6c9zHk2eRoRBrBqXGM5kTkh61X39VL8SvLhH14c,4338
+ws/docs/MCP-WORKFLOWS.md,sha256=FrP_Ob1KqE23nWHaH3fDp_9i5Om-aLIxSq3t8Edelnw,940
+ws/docs/MCP.md,sha256=8f6jwz15n5PC1DAJyDQCeNN2Sc_HN_TlEWEaDMmFzwM,2592
+ws/docs/MEASUREMENTS.md,sha256=FX6KX_K2Snboxlc0EsGUYmDcxoiPwf_ak6nvQOiokqs,5007
+ws/docs/OVERVIEW.md,sha256=H8duD1RYj5hw097iUVe5Ha6bCyfdqtgsxN9GScbqTNA,12875
+ws/docs/PACKS.md,sha256=wxQ3N2PIMHVcQvOa2UO5Fbys-NvS7rILS2PbTfulvdI,2348
+ws/docs/PARALLEL-WORKERS.md,sha256=BrN4yPfElydDBuC7sXZeka7_yvATiHZE7rXAIHC_xa0,8264
+ws/docs/PRINCIPLES.md,sha256=vIvv1KS8GUSenFOpGwYnJe0Lc2RZ8pOM2ofRdfUF9y8,1103
+ws/docs/PRIVATE-PACKS.md,sha256=FUc0qtf6P5RY4HQLAGRMNPenNlPXnow9IzCTfJI1QYA,859
+ws/docs/REPO-START.md,sha256=6XZt8b6EXZfUm7AEn566pno0S4GsuzI3dyJtgHbml5c,2902
+ws/docs/ROADMAP.md,sha256=wmTjaOAPL3qvehJCF71oQs2eZe--WGl_i9XzYfd4xyQ,2783
+ws/docs/SESSION-SEARCH.md,sha256=br-5-X0yVN21SlvZQ4XgMQPejJv0Qmd8WUkpKsyPNSE,1275
+ws/docs/SETUP.md,sha256=giocL2Va8XLT9PkaBIh3Dyg0UESaQTXZpj9ixZ_AjXA,16270
+ws/docs/TEAM-WORKSPACE.md,sha256=o695f_NoDj_9xtFCQAnLKqEanR1n23KWEUkuv2KrUnI,4233
+ws/docs/TEAM.md,sha256=ZV0lUSfkpURnythTO17-4t_RPpZj9CRSiwdQ0n4Xj_c,2684
+ws/docs/TUTORIAL.md,sha256=lHu76vVGyIWUctYCFLw-QQlkLw7DfAp03bArL6NWDFA,5611
+ws/docs/UPGRADE-CHECK.md,sha256=ojPTRQzHjlMbwK21es0dCnwM258mwLSye1MIKdtIJX8,2227
+ws/docs/WINDOWS.md,sha256=kSkaZPiX5xZdtSjgfsKbsHMbNBEolP9pq6E6AN1_gC8,1733
+ws/docs/demo.tape,sha256=wyydxz4fuNubolQ_BQd82CMQ2eWy7fzZzGRG0sMJ4Gk,834
+ws/docs/examples/mcp-protocol-proof.json,sha256=3S4_0vrJhKoKUBf_zZIGWzXYPX3nT8rDACfQ5ADdw84,504
+ws/docs/examples/frameworks/README.md,sha256=RcaxodmPlcvYte_TAmtGvXsrcbkTWYg9xhCzWBWFzDY,4142
+ws/docs/examples/frameworks/adk-requirements.txt,sha256=gvO5gzifMdc63AOZkKdJWTKZMA_59PTvyegR6gTU-fE,35
+ws/docs/examples/frameworks/adk_agent.py,sha256=9UYqtM2c8ijSAP86rQh-lFLb2HsUcLPIdIRzup59y_Q,2283
+ws/docs/examples/frameworks/common.py,sha256=itBd3r7y_xEIAALQl1f8znqnt7js0adtxY2kJ_9gaQY,1850
+ws/docs/examples/frameworks/langgraph-requirements.txt,sha256=eNcR6gBmIFxMKr8iv-HKGtflczAJGFBN13BcD3SgnMc,82
+ws/docs/examples/frameworks/langgraph_agent.py,sha256=9BA8mEUWdvUbC-IELeV1uTVhQxCMdEIS7kD_1uVWM8s,1653
+ws/docs/examples/frameworks/proof.json,sha256=WMIszYypd1qVgGOPgEisz5QxWZWigDBaQwvBetw64ls,1247
+ws/docs/examples/frameworks/prove.py,sha256=5bzIERpz7w219Kovg3kkVtAELT-EgVE5Cm4ktHeXWVE,2615
+ws/mcp/server.py,sha256=DuM_vbuU1LqR2yYd_7umbS7xFzwWMKf1PYe9qADUNi8,20681
+ws/packs/codex-worker/.gitignore,sha256=_c0Bg6S6vYlOfM6D7Ie9JPOFxCTMg1cQCe0HqzRyLZ8,9
+ws/packs/codex-worker/AGENTS.snippet.md,sha256=UNAmYF70B9ui68OMf1_qaY4bDeZLOWn4h3zQPU209WI,333
+ws/packs/codex-worker/investigate.sh,sha256=j7ztOpUWs6hl8AaFFxwr6I2WdaGmjXAYGKEhyYIAny8,1838
+ws/packs/codex-worker/pack.json,sha256=bdBfqbpBZKOU8IIlK8ZOJaR6L3_0fD9oWgwdWw5eD9g,634
+ws/packs/codex-worker/patch_modes.py,sha256=iYHPxDuJ93wDmVJOMZbKKLPwBhpmfwjz3ilVGyeXf3A,1544
+ws/packs/codex-worker/selftest.sh,sha256=Ydfkxr8j9A4FqEP_kmROFKvsatIUDIYtY7qtfvq3jPA,1601
+ws/packs/codex-worker/setup.sh,sha256=jTkFoJYZZZ7UIzcvgGhGux3wMTm4WritGN_gTIysptc,650
+ws/packs/discipline/AGENTS.snippet.md,sha256=HxfMvaq6hsAhOIYHsh7qD_IlNxnHkr8UfxzPVVu6-uw,193
+ws/packs/discipline/pack.json,sha256=pGh_1_-OmJS0M09oD1pgvsif2uKUOg-9AnT5KDiyX3Y,372
+ws/packs/guards/AGENTS.snippet.md,sha256=WyaqLZGs4VORSIJRNwyg1tc_NMY7NHScZDb1rbRg0qs,290
+ws/packs/guards/pack.json,sha256=vPbwS_kAJpHsMSbja6etEjLIPbH4RS8_qySvQ4cxM4E,475
+ws/packs/ios/AGENTS.snippet.md,sha256=24atlXkFNImvhQPqzINdQf2TiGCHBzNcha_auC2xarI,627
+ws/packs/ios/pack.json,sha256=jP7A0GwONjt7lZmIBDhgdehgfYD7qAKdbMLcyYFq3uk,412
+ws/packs/ios/vault/Runbooks/App Store review replies.md,sha256=e1B8WuMAd-PFgtyVZzYCBxmuPtAuRz2E6uRviO_yTYM,639
+ws/packs/ios/vault/Runbooks/iOS Simulator debugging.md,sha256=vtKKBldoeeKI9ZlsH6Lu7OX1WfOVFg1GaswMcK02My0,798
+ws/packs/ios/vault/Runbooks/iOS build triage.md,sha256=tYH07OJt0mWFNSnWq6qRw3g5n1-eeofqVxd6wRn3MiE,806
+ws/packs/library/AGENTS.snippet.md,sha256=y27A-Aoa3LljlZXNWW_U6JmchjqOfs-wtinNlspckns,348
+ws/packs/library/pack.json,sha256=ee9QTEH53nxMGu_GzFT533Gs_gVlfs1AqCl7-Zk25kU,197
+ws/packs/local-llm/AGENTS.snippet.md,sha256=T5DaECzKpoILmXZmlkc0gZ2T6S3jzt64-gIDg2BeJ14,213
+ws/packs/local-llm/pack.json,sha256=P1dCha-TrKU08RXLw_rwF2eI5nPkBk0TY3qbmAfybsU,361
+ws/packs/local-llm/summarize.py,sha256=sNvAq2_g6kMYJ2lykqAtyfW1qpOCNKijN2kL-I_DF3Y,2180
+ws/packs/ml/AGENTS.snippet.md,sha256=HEAO29-Zamk5Tw2XokMsaZ_kJILSGYIkJFLDgUJrcnE,380
+ws/packs/ml/pack.json,sha256=-D3OebuxFoj0_5_ifvAKpXAYGR52TZudxbQs_TXRtP8,215
+ws/packs/obsidian/AGENTS.snippet.md,sha256=Y17khpTcLy0BRru06ht0BgdfmaOvZgZUnVkD3gA9Yn8,186
+ws/packs/obsidian/pack.json,sha256=FVPzT6lEr6XK3ZcDB6eui7fE1GBfPrdF7FfRhQ6YG18,359
+ws/packs/obsidian/vault/.obsidian/app.json,sha256=CdGnLqKDfEtNAOeC0WJYrSa7H5pDKx-38Q8tXBWMhG8,179
+ws/packs/obsidian/vault/.obsidian/core-plugins.json,sha256=1h6jrUvQlD6p4YZfkD50roW5gnpNv_GHJBVJbLpdi4k,128
+ws/packs/obsidian/vault/.obsidian/templates.json,sha256=OT-W1jMt_AXyXrGdwMs8dfjJJGlrGzU0nkxmcuPDpxI,28
+ws/packs/web/AGENTS.snippet.md,sha256=xITAcWvYlUfXQ_TdWl5krPBoC1tjh7Lx4T6cKVhE6AU,366
+ws/packs/web/pack.json,sha256=R5mvndn67Udj3dl7rlGA4eQarpjVRHg7E0JMjn_2V2I,302
+ws/skills/handoff/SKILL.md,sha256=k1_smNEiWMxZy5iORGfBs1ODyXRxnoTs5ArFfWcLgPY,851
+ws/skills/lesson/SKILL.md,sha256=nueCd6GSeSnZaM2aY8_X3h5w1eRa5_3ulMD-AOq0X0o,721
+ws/skills/pickup/SKILL.md,sha256=xsFtt2GdYjZzVgnSLPvs4oAlnWQcpbNt-8U9ykIr24k,962
+ws/skills/thinkbeforeact/SKILL.md,sha256=WU3OBPTFfABoxXgIyokcBAJzGZHOdTSRSVwbtcM6OHo,2031
+ws/template/.gitignore,sha256=VkfiZs7hHe80sIOkHZp-tHtrksOVJgMh2_YuTY2LgJ0,16
+ws/template/AGENTS.md,sha256=joLRGnhSIU4PURVIHA9ii0Ccht4zW5rgnBUiWAFQXz0,2321
+ws/template/CLAUDE.md,sha256=M2zE-_Gb6q2nzPmYZBT6kYUajXoH37PMvoAKae7Qq0k,11
+ws/template/routing-presets.json,sha256=IHnkCXfvF7FTHEsQ-UwPPQZq7L_r72u_MmX7kvgYTf8,442
+ws/template/routing.json,sha256=7EYTkpk51KAjrf3OaMboR0w8h38PE8a9ROIcqlkBRxo,3663
+ws/template/vault/Feedback.md,sha256=PLfPxTTirDhdVkqIa_fGF-WguAx2zLEEzD15Hwo-EEw,120
+ws/template/vault/Learnings.md,sha256=XaA9x3f4a0jIT9sMC2bcPBf8e1mFcxo2ndDr8ciYWu8,89
+ws/template/vault/README.md,sha256=2FZzxHJN3r8Uzq87rxpkiypfsfAkySZTRdvlJEnvGU4,862
+ws/template/vault/Analysis/INDEX.md,sha256=jrmj5orQyYp46ah0ZmwkvzDzlzcl77EZzkjiGjuRrao,145
+ws/template/vault/Product/INDEX.md,sha256=5GYnJZNsmeya-kdfslbff-dn8bWUPKKm_IvYThgOY1s,114
+ws/template/vault/Project/INDEX.md,sha256=_mP4dWzrfR4cHOt0JEsootr8Fn6MSPXQGme6M-PZSMY,107
+ws/template/vault/Runbooks/Delegation.md,sha256=Pq0DcUcgCWyhK3dbgsQxU-sTrDuyGNSf9GgwSwAuuvc,1009
+ws/template/vault/Templates/Task.md,sha256=yhwAkDSJIKwdnzA5PgMhJSKLQngATKMT2W7T2zz_A8Y,342
+ai_dev_workspace-0.1.0b5.dist-info/METADATA,sha256=em9ijQen1tnMgd6XFS7Tb5CYZcxU-0acVs83R5HzuWo,5639
+ai_dev_workspace-0.1.0b5.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+ai_dev_workspace-0.1.0b5.dist-info/entry_points.txt,sha256=hejj-VP_6McbNhDHe0Rha0VU_uoOMyLYTMzWl_-l_as,70
+ai_dev_workspace-0.1.0b5.dist-info/top_level.txt,sha256=hJ3XTAUWCz6_-y1VRxZDN6IEt_iNAyLSXhhoTAotJIo,3
+ai_dev_workspace-0.1.0b5.dist-info/RECORD,,

ai_dev_workspace-0.1.0b5.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ai_dev_workspace-0.1.0b5.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+ai-dev-workspace = ws.cli:mcp_main
+ws = ws.cli:main

ai_dev_workspace-0.1.0b5.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI Dev Workspace contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ai_dev_workspace-0.1.0b5.dist-info/top_level.txt

@@ -0,0 +1 @@
+ws

ws/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI Dev Workspace contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ws/assist.py

@@ -0,0 +1,232 @@
+"""Local suggestions and explicit permission; never install or edit client config."""
+import datetime
+import json
+import re
+import shlex
+import subprocess
+import tempfile
+from pathlib import Path
+from . import core
+
+
+def state(root):
+    path = root / '.ws/assist.json'
+    return core.load_json(path.read_text(encoding='utf-8'), '.ws/assist.json', 'delete it (only snooze and offer history is lost)') if path.exists() else {}
+
+
+def save(root, data):
+    core.atomic_write(root / '.ws/assist.json', json.dumps(data) + '\n')
+
+
+def cost_data():
+    if not core.shutil.which('codeburn'):
+        return {}, {}
+    # notices runs at every session start: reuse one Codeburn scan per day instead of ~30 s of subprocesses.
+    cache = Path.home() / '.cache' / 'ai-dev-workspace' / 'codeburn-assist.json'
+    try:
+        cached = json.loads(cache.read_text(encoding='utf-8'))
+        if cached.get('day') == core.now()[:10]:
+            return _dict(cached['report']), _dict(cached['usage'])
+    except (OSError, ValueError, KeyError, AttributeError):
+        pass
+    report, usage = _scan()
+    if report or usage:
+        cache.parent.mkdir(parents=True, exist_ok=True)
+        core.atomic_write(cache, json.dumps({'day': core.now()[:10], 'report': report, 'usage': usage}))
+    return report, usage
+
+
+def _dict(value):
+    return value if isinstance(value, dict) else {}  # Codeburn output of any other shape is ignored
+
+
+def _rows(value):
+    return [row for row in value if isinstance(row, dict)] if isinstance(value, list) else []
+
+
+def _scan():
+    executable = core.shutil.which('codeburn') or 'codeburn'  # Windows npm shims are codeburn.CMD; only the full path launches
+    try:
+        report = subprocess.run([executable, 'optimize', '--format', 'json'], capture_output=True, encoding='utf-8', errors='replace', timeout=15)
+        since = (datetime.date.fromisoformat(core.now()[:10]) - datetime.timedelta(days=30)).isoformat()
+        with tempfile.TemporaryDirectory() as tmp:
+            path = Path(tmp) / 'usage.json'
+            export = subprocess.run([executable, 'export', '-f', 'json', '-o', str(path), '--from', since], capture_output=True, encoding='utf-8', errors='replace', timeout=15)
+            return _dict(json.loads(report.stdout)), _dict(json.loads(path.read_text(encoding='utf-8')) if export.returncode == 0 else {})
+    except (OSError, ValueError, RecursionError, subprocess.TimeoutExpired):
+        return {}, {}
+
+
+def observe(root, payload):
+    if not payload.get('session_id') and not payload.get('transcript_path'):
+        return
+    with core.lock(root):
+        data = state(root)
+        if payload.get('hook_event_name') in ('SessionStart', 'sessionStart') and payload.get('session_id'):
+            data.pop('long_session_bytes', None)
+            current = core.sole_local_claim(root)
+            bindings = data.setdefault('session_tasks', {}); sid = core.digest_text(str(payload['session_id']))
+            previous = bindings.pop(sid, current)
+            bindings[sid] = current if previous == current else ''
+            while len(bindings) > 200:
+                del bindings[next(iter(bindings))]
+            for task in core.task_list(root):
+                if task['id'] != current:
+                    continue
+                meta = core.task_read(root, task['id'], ['Next action'])['meta']
+                count = meta.get('checkpoint_count', '0')
+                record = data.setdefault('sessions', {}).setdefault(task['id'], {})
+                sid = core.digest_text(str(payload['session_id']))
+                if record.get('last') != sid:
+                    record.update(last=sid, count=(record.get('count', 0) if record.get('checkpoint') == count else 0) + 1, checkpoint=count)
+        try:
+            transcript = payload.get('transcript_path')
+            size = Path(transcript).stat().st_size if isinstance(transcript, str) and transcript else 0
+            if size > 2000000:
+                data['long_session_bytes'] = size
+        except OSError:
+            pass
+        save(root, data)
+
+
+def session_task(root, session_id):
+    if not session_id: return None  # Legacy hooks without a session ID retain claim selection.
+    try:
+        sid = core.digest_text(str(session_id))
+        return state(root).get('session_tasks', {}).get(sid, '')
+    except (OSError, ValueError, AttributeError): return ''  # Unknown bindings cannot authorize capture.
+
+
+def feature_suggestions(root, add):
+    if core.upgrade_due(root):
+        add('upgrade', 'Kit is newer than this workspace or .ws-new proposals await review', 'ws upgrade --dry-run', 'local-reversible')
+    from . import orchestration
+    path = root / '.ws/delegate-selftests.json'
+    try: records = json.loads(path.read_text(encoding='utf-8')) if path.is_file() else {}
+    except (OSError, ValueError): records = {}
+    if not isinstance(records, dict): records = {}
+    seen = set()
+    # Only users who delegate need a sandbox selftest; new workspaces get no paid-run pitch.
+    for role in ('worker', 'explorer', 'reviewer') if (root / '.ws/briefs').is_dir() else ():
+        try: binding = orchestration.route(root, role)
+        except core.WsError: continue
+        provider = binding.get('provider')
+        record = records.get(provider, {})
+        if (binding.get('available') and provider in ('codex', 'claude') and provider not in seen
+                and core._detected(provider) and not (isinstance(record, dict) and record.get('executed'))):
+            add('selftest-' + provider, 'Routed read-only provider has no executed selftest: ' + provider,
+                'ws delegate --selftest --provider ' + provider, 'paid-run' if provider == 'codex' else 'local-reversible')
+        seen.add(provider)
+    for client, checks in (('cursor', ['cursor', 'app:Cursor']), ('vscode', ['code', 'app:Visual Studio Code']), ('gemini', ['gemini'])):
+        if core._detected(checks) and not core.client_connected(root, client):
+            add('connect-' + client, 'Installed client has no matching workspace connection: ' + client, 'ws connect ' + client, 'changes-config')
+
+
+def _workspace_established(root):
+    checkpoints = 0
+    for task in core.task_list(root):
+        try:
+            checkpoints += int(core.task_read(root, task['id'], ['Next action'])['meta'].get('checkpoint_count', 0))
+        except (TypeError, ValueError):
+            pass
+    if checkpoints >= 3:
+        return True
+    try:
+        created = datetime.date.fromisoformat(str(core.config(root).get('created', ''))[:10])
+        today = datetime.date.fromisoformat(core.now()[:10])
+        return today - created >= datetime.timedelta(days=7)
+    except ValueError:
+        return False
+
+
+def suggestions(root, include_hidden=False):
+    data, items = state(root), []
+    def add(identifier, why, command, safety, saving='unmeasured'):
+        items.append(dict(id=identifier, why=' '.join(core.redact(why).split()), command=command, safety=safety, estimated_saving=saving))
+    feature_suggestions(root, add)
+    repos = core.config(root).get('repos', [])
+    mapped = core.vault(root) / 'Project/Codebase map.md'
+    if repos and (not mapped.exists() or core.time.time() - mapped.stat().st_mtime > 14 * 86400):
+        add('map', 'Configured repository map missing or older than 14 days', 'ws map ' + shlex.quote(repos[0]), 'local-reversible')
+    if repos and core.shutil.which('graphify') and not (Path(repos[0]) / 'graphify-out').exists():
+        add('graph', 'Graphify installed; configured repository has no graphify-out directory', 'graphify ' + shlex.quote(repos[0]), 'external')
+    tasks = core.task_list(root)
+    if not core.lesson_search(root, '') and sum(int(core.task_read(root, t['id'], ['Next action'])['meta'].get('checkpoint_count', 0)) for t in tasks) >= 5:
+        add('lesson', 'No lessons after at least 5 recorded checkpoints', 'ws lesson add "<what happened → rule>"', 'local-reversible')
+    for task in tasks:
+        record = data.get('sessions', {}).get(task['id'], {})
+        count = core.task_read(root, task['id'], ['Next action'])['meta'].get('checkpoint_count', '0')
+        if task['claimed_by'] and record.get('checkpoint') == count and record.get('count', 0) >= 3:
+            add('checkpoint-' + task['id'], 'Claim has spanned 3 sessions without a new checkpoint: ' + task['id'], '/handoff (Claude) or $handoff (Codex)', 'local-reversible')
+    if _workspace_established(root):
+        for tool in core.tools(root):
+            if (tool['level'] == 'recommended' and not tool['installed']
+                    and core.tool_policy(root, tool)['mode'] != 'off'):
+                add('tool-' + tool['name'],
+                    'Recommended tool is missing: ' + tool['name'] + '. Review options and ask before installing.',
+                    'ws tools', 'changes-config')
+    if data.get('long_session_bytes'):
+        add('long-session', f"Transcript exceeded 2000000 bytes ({data['long_session_bytes']}); start fresh after handoff", '/handoff (Claude) or $handoff (Codex)', 'local-reversible')
+    guard = core.repeat_guard(root)
+    if guard:
+        add('trace', guard, 'ws trace ' + guard.split()[1].rstrip(':'), 'local-reversible')
+        items.insert(0, items.pop())
+    report, usage = map(_dict, cost_data())
+    used = [row['Server'].lower() for row in _rows(usage.get('mcp')) if isinstance(row.get('Server'), str)
+            and isinstance(row.get('Calls'), (int, float)) and not isinstance(row.get('Calls'), bool) and row['Calls'] > 0]
+    pinned = [name.lower() for name, value in core.config(root).get('tool_overrides', {}).items() if value == 'on']
+    for finding in _rows(report.get('findings')):
+        text = json.dumps(finding).lower()
+        if any(name in text for name in ['ccd_', 'claude-in-chrome', 'ai-dev-workspace', 'workspace', *used, *pinned]):
+            continue
+        if 'mcp' in text and 'mcp' not in usage:
+            continue  # Missing usage evidence: fail closed for connector advice.
+        if finding.get('class') == 'keep':
+            continue
+        identifier = str(finding.get('id', ''))
+        if re.fullmatch(r'[a-zA-Z0-9_-]+', identifier):
+            try: saving = float(finding.get('estimatedSavingsUSD') or 0)
+            except (TypeError, ValueError): saving = 0.0
+            add('cost-' + identifier, 'Review Codeburn: ' + str(finding.get('title') or '') + '; ' + str(finding.get('explanation') or '')[:180],
+                'codeburn optimize --format json', 'changes-config', f'up to ${saving:.2f} in the scanned period (estimate)')
+    today = core.now()[:10]
+    return [item for item in items if include_hidden or data.get('permissions', {}).get(item['id'], {}).get('until', '') <= today][:2 if not include_hidden else len(items)]
+
+
+def decide(root, identifier, decision, until=None):
+    items = {item['id']: item for item in suggestions(root, True)}
+    if identifier not in items or decision not in ('accepted', 'declined', 'snoozed', 'always'):
+        raise core.WsError('Choose a current suggestion and accepted, declined, snoozed or always.')
+    if decision == 'always' and identifier not in ('map', 'trace'):
+        raise core.WsError('Always is allowed only for map and trace, never installs or configuration changes.')
+    if decision == 'snoozed':
+        # Strict YYYY-MM-DD: Python 3.11+ also accepts 20261001 or 2026-W43-1, which would compare wrongly as text.
+        if not re.fullmatch(r'\d{4}-\d{2}-\d{2}', until or ''): raise core.WsError('Snoozed requires --until YYYY-MM-DD.')
+        try: day = datetime.date.fromisoformat(until)
+        except ValueError: raise core.WsError('Snoozed requires --until YYYY-MM-DD.')
+        if day <= datetime.date.fromisoformat(core.now()[:10]): raise core.WsError(f'--until {until} is not in the future; pick a later date.')
+    if decision == 'declined':
+        until = (datetime.date.fromisoformat(core.now()[:10]) + datetime.timedelta(days=30)).isoformat()
+    with core.lock(root):
+        data = state(root); data.setdefault('permissions', {})[identifier] = dict(decision=decision, until=until or '')
+        save(root, data)
+    return {'id': identifier, 'decision': decision, 'until': until}
+
+
+def apply(root, identifier):
+    permission = state(root).get('permissions', {}).get(identifier, {}).get('decision')
+    items = {item['id']: item for item in suggestions(root, True)}
+    if identifier not in items or identifier not in ('map', 'trace') or permission not in ('accepted', 'always'):
+        raise core.WsError('Accept a current map/trace suggestion first; run other commands yourself after review.')
+    return core.codebase_map(root) if identifier == 'map' else core.trace(root, items['trace']['command'].split()[-1])
+
+
+def notices(root, limit, existing=()):
+    candidates = [dict(id='notice-' + core.digest_text(json.dumps(item)), notice=item) for item in existing] + suggestions(root, True)
+    with core.lock(root):
+        data = state(root); seen = data.get('offered', [])
+        items = [item for item in candidates if item['id'] not in seen and data.get('permissions', {}).get(item['id'], {}).get('until', '') <= core.now()[:10]][:limit]
+        data['offered'] = seen + [item['id'] for item in items]; save(root, data)
+    return [item['notice'] if 'notice' in item else dict(kind='toolbox' if item['id'].startswith('tool-') else 'assist', tool=item['id'].removeprefix('tool-'),
+                 message=item['why'] + (' Review options with ws tools before installing.' if item['id'].startswith('tool-') else ' Ask before applying.'),
+                 suggest=item['command']) for item in items]

ws/audit.py

@@ -0,0 +1,101 @@
+"""ws audit: read-only scorecard of a repo's AI assistant setup with the top fixes; no network, no writes."""
+import datetime
+import json
+import re
+import subprocess
+from pathlib import Path
+
+from . import core
+
+INSTRUCTIONS = ('CLAUDE.md', 'AGENTS.md', '.github/copilot-instructions.md', 'GEMINI.md')
+BIG = 2000  # words loaded into every session before the user types anything
+MCP_SERVERS = 5
+EXTENSIONLESS = {'Makefile', 'Dockerfile', 'Justfile', 'Procfile', 'Gemfile', 'Rakefile', 'Brewfile', 'Vagrantfile', 'LICENSE', 'CODEOWNERS'}  # @Name is a person otherwise
+STALE_DAYS = 14
+
+
+def _repo(path):
+    path = Path(path or '.').resolve()
+    try:
+        top = subprocess.run(['git', '-C', str(path), 'rev-parse', '--show-toplevel'], capture_output=True, encoding='utf-8', errors='replace', timeout=5)
+        return Path(top.stdout.strip()).resolve() if top.returncode == 0 else path
+    except (OSError, subprocess.SubprocessError):
+        return path
+
+
+def _refs(text):
+    """Files an instruction file points at: @imports, Markdown links and backticked relative paths."""
+    imports = [r.rstrip('.') for r in re.findall(r'(?m)(?:^|\s)@([\w.-]+(?:/[\w.-]+)*)', text)]
+    # @AGENTS.md is a file import; @openai/agents (no extension, with a slash) is a package name; @Makefile (capitalised, no slash) is a file.
+    found = ([r for r in imports if re.search(r'\.\w{1,8}$', r) or r.split('/')[-1] in EXTENSIONLESS] + re.findall(r'\]\(([^)#\s]+)', text)
+             + re.findall(r'`((?:[\w.-]+/)+[\w.-]+\.\w{1,8}|[\w-]+\.(?:md|py|json|toml|ya?ml|sh|js|ts))`', text))
+    return [r for r in dict.fromkeys(found) if '://' not in r and '*' not in r and not r.startswith(('mailto:', '/', '~', '$'))]
+
+
+def _session_start_command(path):
+    """True when a hooks file has at least one SessionStart command (not just an empty list)."""
+    try: entries = core.json_loads(path.read_text(encoding='utf-8')).get('hooks', {}).get('SessionStart')
+    except (OSError, ValueError, AttributeError): return False
+    if not isinstance(entries, list): return False
+    hooks = [h for e in entries if isinstance(e, dict) for h in (e.get('hooks') if isinstance(e.get('hooks'), list) else [e])]
+    return any(isinstance(h, dict) and isinstance(h.get('command'), str) and h['command'].strip() for h in hooks)
+
+
+def _mcp_servers(repo):
+    names = set()
+    try: servers = core.json_loads((repo / '.mcp.json').read_text(encoding='utf-8')).get('mcpServers')
+    except (OSError, ValueError, AttributeError): servers = None
+    if isinstance(servers, dict): names |= set(servers)
+    try: names |= set(re.findall(r'(?m)^\[mcp_servers\.([^\].]+)\]', (repo / '.codex/config.toml').read_text(encoding='utf-8')))
+    except OSError: pass
+    return sorted(names)
+
+
+def audit(path=None):
+    repo = _repo(path)
+    checks = []
+    def check(name, ok, detail, fix):
+        checks.append({'check': name, 'ok': bool(ok), 'detail': detail, 'fix': '' if ok else fix})
+
+    present = [n for n in INSTRUCTIONS if (repo / n).is_file()]
+    texts = {n: (repo / n).read_text(encoding='utf-8', errors='replace') for n in present}
+    words = sum(len(t.split()) for t in texts.values())
+    check('Instructions', {'CLAUDE.md', 'AGENTS.md'} & set(present), ', '.join(present) or 'none',
+          'Add AGENTS.md with the build and test commands and repo rules; CLAUDE.md can import it with @AGENTS.md.')
+    check('Instruction size', words <= BIG, f'{words:,} words loaded every session',
+          f'Trim the instruction files under {BIG:,} words; move rarely needed detail into linked docs.')
+    broken = [f'{n}: {r}' for n, t in texts.items() for r in _refs(t) if not ((repo / n).parent / r).exists() and not (repo / r).exists()]
+    check('References', not broken, ', '.join(broken[:5]) + (f' (+{len(broken) - 5} more)' if len(broken) > 5 else '') or 'all resolve',
+          'Fix or remove references to missing files: ' + ', '.join(broken[:3]) + '.')
+
+    root = None
+    try: root = core.find_root(repo) if (repo / '.ws-start.json').is_file() else None
+    except (core.WsError, OSError, ValueError): pass
+    check('Memory', root, 'connected' if root else 'not connected', 'Run ws start in this repo to give every session the saved decisions and next step.')
+    hooks = [label for label, rel in (('Claude Code', '.claude/settings.local.json'), ('Claude Code', '.claude/settings.json'), ('Codex', '.codex/hooks.json'))
+             if _session_start_command(repo / rel)]
+    check('Session hooks', hooks, ', '.join(dict.fromkeys(hooks)) or 'none',
+          'Run ws start: it adds SessionStart hooks so Claude Code and Codex load memory without being asked.')
+    servers = _mcp_servers(repo)
+    profile = core.config(root).get('mcp_tools', 'core') if root else 'core'
+    check('MCP budget', len(servers) <= MCP_SERVERS and profile != 'all', f"{len(servers)} servers" + (', ws lists all tools' if profile == 'all' else ''),
+          f'Each MCP server adds tool descriptions to every session; keep {MCP_SERVERS} or fewer'
+          + (' and set "mcp_tools": "core" in workspace.json.' if profile == 'all' else '.'))
+    if root:
+        cutoff = (datetime.datetime.now(datetime.timezone.utc) - datetime.timedelta(days=STALE_DAYS)).strftime('%Y-%m-%d')
+        stale = [t['id'] for t in core.task_list(root) if t['status'] == 'in_progress'
+                 and str(core.task_read(root, t['id'], ['Next action'])['meta'].get('updated', ''))[:10] < cutoff]
+        check('Stale tasks', not stale, ', '.join(stale[:5]) or 'none',
+              f'Checkpoint or close tasks idle for {STALE_DAYS}+ days: ' + ', '.join(stale[:3]) + '.')
+    passed = sum(c['ok'] for c in checks)
+    fixes = []
+    for fix in (c['fix'] for c in checks if c['fix']):
+        if not (fix.startswith('Run ws start') and any(f.startswith('Run ws start') for f in fixes)): fixes.append(fix)  # one start fixes both
+    return {'repo': repo.name, 'score': f'{passed}/{len(checks)}', 'checks': checks, 'fixes': fixes[:3]}
+
+
+def text(report):
+    lines = [f"AI setup audit for {report['repo']}: {report['score']}"]
+    lines += [f"  {'ok  ' if c['ok'] else 'fix '} {c['check']}: {c['detail']}" for c in report['checks']]
+    if report['fixes']: lines += ['Top fixes:'] + [f'{i}. {fix}' for i, fix in enumerate(report['fixes'], 1)]
+    return '\n'.join(lines)