ai-docs-toolkit 0.19.0__tar.gz → 0.20.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (300) hide show
  1. {ai_docs_toolkit-0.19.0/src/ai_docs_toolkit.egg-info → ai_docs_toolkit-0.20.2}/PKG-INFO +31 -7
  2. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/README.md +11 -2
  3. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/packaging/pypi/README.md +30 -6
  4. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/pyproject.toml +2 -1
  5. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/scripts/build_codex_plugin.py +45 -9
  6. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/scripts/build_codex_plugin_linux.py +1 -1
  7. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/scripts/publish_codex_plugin_release.py +47 -2
  8. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/__init__.py +1 -1
  9. ai_docs_toolkit-0.20.2/src/ai_docs_toolkit/distribution/app_projects.py +182 -0
  10. ai_docs_toolkit-0.20.2/src/ai_docs_toolkit/distribution/project_inspection.py +133 -0
  11. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/docs/agent-installation.md +180 -0
  12. ai_docs_toolkit-0.20.2/src/ai_docs_toolkit/docs/project-update-prompt.md +12 -0
  13. ai_docs_toolkit-0.20.2/src/ai_docs_toolkit/mcp/assets/projects.html +206 -0
  14. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/mcp/plugin.py +42 -5
  15. ai_docs_toolkit-0.20.2/src/ai_docs_toolkit/mcp/projects_ui.py +88 -0
  16. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/reference/documentation-change-review-skill.md +8 -0
  17. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/reference/planning-document-model.md +39 -0
  18. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/skills/planning-task-execution/SKILL.md +3 -0
  19. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/workflows/plan-stage-workflow.md +5 -0
  20. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2/src/ai_docs_toolkit.egg-info}/PKG-INFO +31 -7
  21. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit.egg-info/SOURCES.txt +8 -0
  22. ai_docs_toolkit-0.20.2/tests/test_app_projects.py +128 -0
  23. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_cli_baseline.py +2 -2
  24. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_codex_plugin.py +62 -0
  25. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_codex_plugin_publication.py +32 -1
  26. ai_docs_toolkit-0.20.2/tests/test_project_inspection.py +101 -0
  27. ai_docs_toolkit-0.20.2/tests/test_projects_ui.py +142 -0
  28. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/LICENSE +0 -0
  29. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/MANIFEST.in +0 -0
  30. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/packaging/codex-plugin/entrypoint.py +0 -0
  31. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/packaging/codex-plugin/hooks/hook-ai_docs_toolkit.py +0 -0
  32. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/packaging/codex-plugin/linux-x86_64.json +0 -0
  33. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/packaging/codex-plugin/mcp.json +0 -0
  34. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/packaging/codex-plugin/native-components.json +0 -0
  35. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/packaging/codex-plugin/plugin.json +0 -0
  36. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/packaging/codex-plugin/requirements-linux-x86_64.lock +0 -0
  37. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/packaging/codex-plugin/skills/ai-docs-toolkit/SKILL.md +0 -0
  38. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/packaging/codex-plugin/vendor-licenses/sqlite3-LICENSE.txt +0 -0
  39. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/packaging/codex-plugin/vendor-licenses/zstd-COPYING.txt +0 -0
  40. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/packaging/codex-plugin/vendor-licenses/zstd-LICENSE.txt +0 -0
  41. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/scripts/evaluate_codex_plugin.py +0 -0
  42. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/scripts/prepare_codex_plugin_release.py +0 -0
  43. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/scripts/smoke_codex_plugin.py +0 -0
  44. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/setup.cfg +0 -0
  45. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/__main__.py +0 -0
  46. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/cli/__init__.py +0 -0
  47. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/cli/analysis.py +0 -0
  48. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/cli/external_work.py +0 -0
  49. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/cli/help.py +0 -0
  50. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/cli/mcp.py +0 -0
  51. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/cli/measurement.py +0 -0
  52. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/cli/planning.py +0 -0
  53. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/cli/project.py +0 -0
  54. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/cli/quality.py +0 -0
  55. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/cli/releases.py +0 -0
  56. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/cli/workspace.py +0 -0
  57. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/context/__init__.py +0 -0
  58. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/context/markdown_output.py +0 -0
  59. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/__init__.py +0 -0
  60. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/artifacts.py +0 -0
  61. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/azure_devops_provider.py +0 -0
  62. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/changed_files.py +0 -0
  63. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/code_links.py +0 -0
  64. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/config.py +0 -0
  65. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/context.py +0 -0
  66. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/context_diagnostics.py +0 -0
  67. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/doctor.py +0 -0
  68. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/documentation_checks.py +0 -0
  69. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/file_lookup.py +0 -0
  70. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/frontmatter.py +0 -0
  71. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/graph.py +0 -0
  72. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/impact.py +0 -0
  73. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/init.py +0 -0
  74. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/module_context.py +0 -0
  75. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/path_resolution.py +0 -0
  76. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/planning_operations.py +0 -0
  77. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/planning_scaffold.py +0 -0
  78. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/project.py +0 -0
  79. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/registry.py +0 -0
  80. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/requirement_capture.py +0 -0
  81. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/scanner.py +0 -0
  82. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/schema_capabilities.py +0 -0
  83. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/schema_validation.py +0 -0
  84. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/section_fix.py +0 -0
  85. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/structure_validation.py +0 -0
  86. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/task_export.py +0 -0
  87. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/core/yaml_loading.py +0 -0
  88. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/distribution/__init__.py +0 -0
  89. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/distribution/artifacts.py +0 -0
  90. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/distribution/doctor.py +0 -0
  91. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/distribution/init.py +0 -0
  92. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/distribution/launcher.py +0 -0
  93. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/distribution/plugin_bundle.py +0 -0
  94. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/distribution/plugin_notices.py +0 -0
  95. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/distribution/release_execution.py +0 -0
  96. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/distribution/release_migration.py +0 -0
  97. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/distribution/releases.py +0 -0
  98. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/distribution/schema_capabilities.py +0 -0
  99. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/doc_audit/__init__.py +0 -0
  100. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/doc_audit/boilerplate.py +0 -0
  101. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/doc_audit/boundaries.py +0 -0
  102. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/doc_audit/check.py +0 -0
  103. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/doc_audit/cli.py +0 -0
  104. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/doc_audit/markdown.py +0 -0
  105. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/doc_audit/migration.py +0 -0
  106. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/doc_audit/ownership.py +0 -0
  107. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/doc_audit/quality.py +0 -0
  108. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/doc_audit/section_fix.py +0 -0
  109. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/external_work/__init__.py +0 -0
  110. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/external_work/config.py +0 -0
  111. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/external_work/delivery.py +0 -0
  112. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/external_work/gitlab.py +0 -0
  113. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/external_work/ledger.py +0 -0
  114. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/external_work/local.py +0 -0
  115. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/external_work/local_context.py +0 -0
  116. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/external_work/local_gitlab.py +0 -0
  117. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/external_work/local_store.py +0 -0
  118. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/external_work/model.py +0 -0
  119. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/external_work/owners.py +0 -0
  120. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/external_work/service.py +0 -0
  121. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/graph/__init__.py +0 -0
  122. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/graph/json_output.py +0 -0
  123. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/impact/__init__.py +0 -0
  124. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/impact/json_output.py +0 -0
  125. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/mcp/__init__.py +0 -0
  126. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/mcp/__main__.py +0 -0
  127. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/mcp/server.py +0 -0
  128. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/mcp/setup.py +0 -0
  129. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/measurement/__init__.py +0 -0
  130. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/measurement/codex.py +0 -0
  131. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/measurement/service.py +0 -0
  132. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/measurement/store.py +0 -0
  133. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/planning/__init__.py +0 -0
  134. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/planning/export.py +0 -0
  135. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/planning/file_lookup.py +0 -0
  136. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/planning/operations.py +0 -0
  137. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/planning/requirements.py +0 -0
  138. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/planning/scaffold.py +0 -0
  139. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/providers/__init__.py +0 -0
  140. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/providers/azure_devops.py +0 -0
  141. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/review/__init__.py +0 -0
  142. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/review/check.py +0 -0
  143. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/review/record.py +0 -0
  144. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/.gitignore +0 -0
  145. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/bin/ai-docs.py +0 -0
  146. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/examples/skills/release-publication/SKILL.md +0 -0
  147. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/reference/architecture-boundaries.md +0 -0
  148. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/reference/documentation-cascade-authoring-skill.md +0 -0
  149. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/reference/economical-evidence.md +0 -0
  150. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/reference/external-work.md +0 -0
  151. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/reference/incoming-request-model.md +0 -0
  152. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/reference/incoming-request-triage-skill.md +0 -0
  153. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/reference/init-command-contract.md +0 -0
  154. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/reference/module-documentation.md +0 -0
  155. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/reference/observability-design.md +0 -0
  156. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/reference/runtime-launcher.md +0 -0
  157. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/reference/test-evidence.md +0 -0
  158. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/reference/toolkit-maintenance-context-routing.md +0 -0
  159. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/reference/workspace-analysis.md +0 -0
  160. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/document-types/acceptance.schema.yaml +0 -0
  161. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/document-types/architecture-decision.schema.yaml +0 -0
  162. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/document-types/asset.schema.yaml +0 -0
  163. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/document-types/business-rule.schema.yaml +0 -0
  164. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/document-types/contract.schema.yaml +0 -0
  165. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/document-types/guide.schema.yaml +0 -0
  166. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/document-types/implementation-task.schema.yaml +0 -0
  167. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/document-types/index.schema.yaml +0 -0
  168. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/document-types/inventory.schema.yaml +0 -0
  169. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/document-types/module.schema.yaml +0 -0
  170. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/document-types/operation.schema.yaml +0 -0
  171. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/document-types/plan-stage.schema.yaml +0 -0
  172. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/document-types/plan.schema.yaml +0 -0
  173. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/document-types/runbook.schema.yaml +0 -0
  174. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/document-types/scenario.schema.yaml +0 -0
  175. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/document-types/standalone-task.schema.yaml +0 -0
  176. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/document-types/task-registry.schema.yaml +0 -0
  177. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/document-types/test-case.schema.yaml +0 -0
  178. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/frontmatter.schema.yaml +0 -0
  179. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/workspace/manifest-v1.schema.yaml +0 -0
  180. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/workspace/repository-v1.schema.yaml +0 -0
  181. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/workspace/request-v1.schema.yaml +0 -0
  182. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/schemas/workspace/result-v1.schema.yaml +0 -0
  183. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/skills/architecture-boundaries/SKILL.md +0 -0
  184. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/skills/documentation-cascade-authoring/SKILL.md +0 -0
  185. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/skills/documentation-change-review/SKILL.md +0 -0
  186. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/skills/economical-evidence/SKILL.md +0 -0
  187. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/skills/incoming-request-triage/SKILL.md +0 -0
  188. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/skills/index.md +0 -0
  189. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/skills/planning-record-generation/SKILL.md +0 -0
  190. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/skills/toolkit-consumer-policy/SKILL.md +0 -0
  191. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/skills/update-ai-docs-toolkit/SKILL.md +0 -0
  192. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/templates/release/agent-context-architecture-beta-18.md +0 -0
  193. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/templates/release/archive-validation-beta-12.md +0 -0
  194. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/templates/release/cascade-impact-beta-14.md +0 -0
  195. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/templates/release/consumer-migration-hardening.md +0 -0
  196. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/templates/release/decision-visibility-beta-13.md +0 -0
  197. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/templates/release/doctor-filesystem-traversal-beta-19.md +0 -0
  198. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/templates/release/doctor-json-provenance-beta-20.md +0 -0
  199. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/templates/release/documentation-cascade-authoring-beta-23.md +0 -0
  200. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/templates/release/documentation-change-review-beta-21.md +0 -0
  201. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/templates/release/incoming-request-storage-beta-17.md +0 -0
  202. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/templates/release/incoming-request-triage-beta-22.md +0 -0
  203. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/templates/release/migration-note.md +0 -0
  204. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/templates/release/post-publication-checks.md +0 -0
  205. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/templates/release/release-task.md +0 -0
  206. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/templates/release/routing-restoration-beta-15.md +0 -0
  207. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/templates/release/task-retirement-beta-16.md +0 -0
  208. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/templates/release/validation-evidence.md +0 -0
  209. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/templates/release/version-change-checklist.md +0 -0
  210. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/templates/runtime.example.json +0 -0
  211. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/workflows/documentation-cascade-adoption.md +0 -0
  212. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/.ai-docs/workflows/toolkit-migration-workflow.md +0 -0
  213. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/AGENTS.md +0 -0
  214. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/ai-docs-index.md +0 -0
  215. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/templates/project/ai-docs.config.yaml +0 -0
  216. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/test_evidence/__init__.py +0 -0
  217. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/test_evidence/adapters.py +0 -0
  218. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/test_evidence/check.py +0 -0
  219. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/test_evidence/cli.py +0 -0
  220. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/test_evidence/model.py +0 -0
  221. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/test_evidence/pytest_adapter.py +0 -0
  222. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/test_evidence/pytest_runner.py +0 -0
  223. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/test_evidence/reports.py +0 -0
  224. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/test_evidence/run_cli.py +0 -0
  225. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/test_evidence/runs.py +0 -0
  226. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/validation/__init__.py +0 -0
  227. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/validation/human.py +0 -0
  228. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/workspace/__init__.py +0 -0
  229. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/workspace/analysis.py +0 -0
  230. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/workspace/config.py +0 -0
  231. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/workspace/result.py +0 -0
  232. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit/workspace/schemas.py +0 -0
  233. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit.egg-info/dependency_links.txt +0 -0
  234. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit.egg-info/entry_points.txt +0 -0
  235. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit.egg-info/requires.txt +0 -0
  236. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/src/ai_docs_toolkit.egg-info/top_level.txt +0 -0
  237. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_artifacts.py +0 -0
  238. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_azure_devops_provider.py +0 -0
  239. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_bootstrap_templates.py +0 -0
  240. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_cli_dispatch.py +0 -0
  241. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_code_links.py +0 -0
  242. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_codex_plugin_distribution.py +0 -0
  243. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_codex_plugin_eval.py +0 -0
  244. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_codex_plugin_release.py +0 -0
  245. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_config_loader_and_scanner.py +0 -0
  246. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_consumer_matrix.py +0 -0
  247. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_context_cli_json.py +0 -0
  248. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_context_cli_markdown.py +0 -0
  249. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_context_depth.py +0 -0
  250. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_context_policy.py +0 -0
  251. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_context_selector.py +0 -0
  252. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_discovery_report.py +0 -0
  253. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_doc_audit.py +0 -0
  254. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_doctor_schema_capabilities.py +0 -0
  255. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_document_context.py +0 -0
  256. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_document_graph.py +0 -0
  257. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_document_registry.py +0 -0
  258. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_documentation_quality.py +0 -0
  259. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_execution_evals.py +0 -0
  260. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_explicit_owner_context.py +0 -0
  261. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_external_work.py +0 -0
  262. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_external_work_local.py +0 -0
  263. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_external_work_model.py +0 -0
  264. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_frontmatter_parser.py +0 -0
  265. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_graph_cli_json.py +0 -0
  266. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_ham_workspace_evaluation.py +0 -0
  267. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_ham_workspace_reverification.py +0 -0
  268. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_impact_analysis.py +0 -0
  269. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_impact_cli_human.py +0 -0
  270. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_impact_cli_json.py +0 -0
  271. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_init_cli.py +0 -0
  272. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_mcp_server.py +0 -0
  273. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_measurement.py +0 -0
  274. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_measurement_codex.py +0 -0
  275. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_mixed_roots.py +0 -0
  276. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_module_context.py +0 -0
  277. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_multi_repository_pilot.py +0 -0
  278. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_navigation_context_audit.py +0 -0
  279. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_ownership_report.py +0 -0
  280. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_package_boundaries.py +0 -0
  281. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_path_resolution.py +0 -0
  282. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_project_loading.py +0 -0
  283. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_project_releases.py +0 -0
  284. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_pytest_evidence.py +0 -0
  285. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_release_migration.py +0 -0
  286. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_repository_maintenance.py +0 -0
  287. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_review_check.py +0 -0
  288. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_runtime_launcher.py +0 -0
  289. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_schema_validation.py +0 -0
  290. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_skill_eval_harness.py +0 -0
  291. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_structure_validation.py +0 -0
  292. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_task_export.py +0 -0
  293. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_test_evidence.py +0 -0
  294. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_validate_cli_human.py +0 -0
  295. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_validate_cli_json.py +0 -0
  296. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_workspace.py +0 -0
  297. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_workspace_adapters.py +0 -0
  298. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_workspace_bootstrap.py +0 -0
  299. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_workspace_schemas.py +0 -0
  300. {ai_docs_toolkit-0.19.0 → ai_docs_toolkit-0.20.2}/tests/test_yaml_loading.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: ai-docs-toolkit
3
- Version: 0.19.0
3
+ Version: 0.20.2
4
4
  Summary: AI-oriented documentation toolkit.
5
5
  License-Expression: MIT
6
6
  Requires-Python: >=3.14
@@ -36,7 +36,7 @@ The core idea is that documentation should not be a secondary artifact created a
36
36
 
37
37
  ## Current Status
38
38
 
39
- Version 0.19.0 includes:
39
+ Version 0.20.2 includes:
40
40
 
41
41
  - schema and structure validation for Markdown documents with YAML front matter;
42
42
  - read-only ownership and declared-dependency diagnostics through `ownership-report`;
@@ -64,30 +64,54 @@ and compatible. Both modes require explicit config; credentials stay at runtime.
64
64
 
65
65
  ## Installation
66
66
 
67
- After publication, install 0.19.0 with Python 3.14 or newer. Before publication,
68
- use only a reviewed local wheel/native artifact:
67
+ After publication, install 0.20.2 with Python 3.14 or newer. Before publication,
68
+ use only a reviewed local wheel:
69
69
 
70
70
  ```bash
71
- python -m pip install ai-docs-toolkit==0.19.0
71
+ python -m pip install ai-docs-toolkit==0.20.2
72
72
  ai-docs --version
73
73
  ```
74
74
 
75
75
  For ephemeral execution with `uvx`:
76
76
 
77
77
  ```bash
78
- uvx --python 3.14 --from ai-docs-toolkit==0.19.0 ai-docs --version
78
+ uvx --python 3.14 --from ai-docs-toolkit==0.20.2 ai-docs --version
79
79
  ```
80
80
 
81
81
  For the optional local MCP runtime:
82
82
 
83
83
  ```bash
84
- python -m pip install "ai-docs-toolkit[mcp]==0.19.0"
84
+ python -m pip install "ai-docs-toolkit[mcp]==0.20.2"
85
85
  ai-docs-mcp --project-root .
86
86
  ```
87
87
 
88
88
  For the latest stable release, use `python -m pip install --upgrade ai-docs-toolkit`
89
89
  without an exact version pin.
90
90
 
91
+ ## Release 0.20.2
92
+
93
+ Adds proportional performance evidence guidance to existing Test Plan/Validation
94
+ and review instructions: comparable baseline/candidate, CPU/memory boundaries,
95
+ raw results and limitations. No new schema, mandatory benchmark or project-document
96
+ migration. Review and apply the normal managed-file refresh after upgrading.
97
+ See packaged agent-installation.md, Migration 0.20.1 To 0.20.2, for exact commands.
98
+ This release targets Python wheel/sdist; it does not update an installed native
99
+ adapter or project-bound native runtime.
100
+
101
+ ## Release 0.20.1
102
+
103
+ The native Codex plugin now includes AI Docs projects settings. Each project-folder
104
+ row can open a new chat with a prepared Toolkit update prompt; the user sends it
105
+ explicitly. The panel keeps a copyable prompt when navigation is unavailable.
106
+ Projects are discovered from the local App profile, without a separate registry.
107
+
108
+ Python delivery and the seven read-only project tools remain supported. Updating
109
+ the adapter preserves project pins and instructions. No schema, document-layout
110
+ or required managed-content migration is introduced from 0.19.0. Review normal
111
+ init preview/provenance, keep Native + Python versions aligned when adopted, and
112
+ run Toolkit and owner checks. Packaged agent-installation.md contains exact
113
+ Migration 0.19.0 To 0.20.1 commands, preservation and recovery instructions.
114
+
91
115
  ## Release 0.19.0
92
116
 
93
117
  The Python package remains a supported distribution channel. The native Codex
@@ -241,8 +241,11 @@ initialize or migrate project documentation.
241
241
  Each project explicitly pins a complete release containing its runtime and
242
242
  instructions. Plugin updates preserve that pin; target migration is a separate
243
243
  operation. See [project releases](ai-docs/product/modules/distribution/project-releases.md).
244
- The [0.19.0 candidate](ai-docs/reference/releases/0-19-0.md) is prepared locally;
245
- publication and consumer installation require the separate release gate.
244
+ [0.20.1](ai-docs/reference/releases/0-20-1.md) is available in
245
+ [GitLab Release](https://gitlab.com/belkov.ai-tools/ai-docs-toolkit/-/releases/v0.20.1)
246
+ and [Public PyPI](https://pypi.org/project/ai-docs-toolkit/0.20.1/).
247
+ See [native installation](ai-docs/product/modules/distribution/native-installation.md)
248
+ for exact downloads and explicit project adoption.
246
249
 
247
250
  ### CLI
248
251
 
@@ -349,6 +352,12 @@ AI Docs Toolkit is licensed under the [MIT License](LICENSE).
349
352
 
350
353
  ## Repeatable Quality Gate
351
354
 
355
+ Python package 0.20.2 adds guidance for performance-sensitive changes using the existing
356
+ [Test Plan and Validation evidence](.ai-docs/reference/planning-document-model.md#performance-evidence)
357
+ for baseline/candidate identity, comparable scenarios, raw results and limitations.
358
+ This adds no universal benchmark requirement or schema gate. See the
359
+ [0.20.2 release and migration](ai-docs/reference/releases/0-20-2.md).
360
+
352
361
  Use `ai-docs ownership-report --format json` for file/document owners, declared
353
362
  dependencies and advisory cross-owner reference review. It does not infer runtime
354
363
  dependencies or require universal coverage.
@@ -16,7 +16,7 @@ The core idea is that documentation should not be a secondary artifact created a
16
16
 
17
17
  ## Current Status
18
18
 
19
- Version 0.19.0 includes:
19
+ Version 0.20.2 includes:
20
20
 
21
21
  - schema and structure validation for Markdown documents with YAML front matter;
22
22
  - read-only ownership and declared-dependency diagnostics through `ownership-report`;
@@ -44,30 +44,54 @@ and compatible. Both modes require explicit config; credentials stay at runtime.
44
44
 
45
45
  ## Installation
46
46
 
47
- After publication, install 0.19.0 with Python 3.14 or newer. Before publication,
48
- use only a reviewed local wheel/native artifact:
47
+ After publication, install 0.20.2 with Python 3.14 or newer. Before publication,
48
+ use only a reviewed local wheel:
49
49
 
50
50
  ```bash
51
- python -m pip install ai-docs-toolkit==0.19.0
51
+ python -m pip install ai-docs-toolkit==0.20.2
52
52
  ai-docs --version
53
53
  ```
54
54
 
55
55
  For ephemeral execution with `uvx`:
56
56
 
57
57
  ```bash
58
- uvx --python 3.14 --from ai-docs-toolkit==0.19.0 ai-docs --version
58
+ uvx --python 3.14 --from ai-docs-toolkit==0.20.2 ai-docs --version
59
59
  ```
60
60
 
61
61
  For the optional local MCP runtime:
62
62
 
63
63
  ```bash
64
- python -m pip install "ai-docs-toolkit[mcp]==0.19.0"
64
+ python -m pip install "ai-docs-toolkit[mcp]==0.20.2"
65
65
  ai-docs-mcp --project-root .
66
66
  ```
67
67
 
68
68
  For the latest stable release, use `python -m pip install --upgrade ai-docs-toolkit`
69
69
  without an exact version pin.
70
70
 
71
+ ## Release 0.20.2
72
+
73
+ Adds proportional performance evidence guidance to existing Test Plan/Validation
74
+ and review instructions: comparable baseline/candidate, CPU/memory boundaries,
75
+ raw results and limitations. No new schema, mandatory benchmark or project-document
76
+ migration. Review and apply the normal managed-file refresh after upgrading.
77
+ See packaged agent-installation.md, Migration 0.20.1 To 0.20.2, for exact commands.
78
+ This release targets Python wheel/sdist; it does not update an installed native
79
+ adapter or project-bound native runtime.
80
+
81
+ ## Release 0.20.1
82
+
83
+ The native Codex plugin now includes AI Docs projects settings. Each project-folder
84
+ row can open a new chat with a prepared Toolkit update prompt; the user sends it
85
+ explicitly. The panel keeps a copyable prompt when navigation is unavailable.
86
+ Projects are discovered from the local App profile, without a separate registry.
87
+
88
+ Python delivery and the seven read-only project tools remain supported. Updating
89
+ the adapter preserves project pins and instructions. No schema, document-layout
90
+ or required managed-content migration is introduced from 0.19.0. Review normal
91
+ init preview/provenance, keep Native + Python versions aligned when adopted, and
92
+ run Toolkit and owner checks. Packaged agent-installation.md contains exact
93
+ Migration 0.19.0 To 0.20.1 commands, preservation and recovery instructions.
94
+
71
95
  ## Release 0.19.0
72
96
 
73
97
  The Python package remains a supported distribution channel. The native Codex
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "ai-docs-toolkit"
7
- version = "0.19.0"
7
+ version = "0.20.2"
8
8
  description = "AI-oriented documentation toolkit."
9
9
  readme = "packaging/pypi/README.md"
10
10
  requires-python = ">=3.14"
@@ -37,6 +37,7 @@ where = ["src"]
37
37
 
38
38
  [tool.setuptools.package-data]
39
39
  ai_docs_toolkit = [
40
+ "mcp/assets/*.html",
40
41
  "docs/*.md",
41
42
  "templates/project/.ai-docs/.gitignore",
42
43
  "templates/project/.ai-docs/bin/*.py",
@@ -36,7 +36,9 @@ def source_hashes() -> dict[str, str]:
36
36
  for p in sorted(set(paths)) if p.is_file() and "__pycache__" not in p.parts}
37
37
 
38
38
 
39
- def assemble_plugin(output: Path, runtime: Path, *, release=None) -> None:
39
+ def assemble_plugin(output: Path, runtime: Path, *, release=None, projects_preview=False,
40
+ projects_codex=None, projects_home=None, projects_ui_only=False,
41
+ with_projects_ui=False) -> None:
40
42
  output = Path(output)
41
43
  if output.exists():
42
44
  raise FileExistsError(f"Output already exists; choose a new build directory: {output}")
@@ -45,13 +47,30 @@ def assemble_plugin(output: Path, runtime: Path, *, release=None) -> None:
45
47
  raise RuntimeError(f"Missing executable frozen runtime: {executable}")
46
48
  output.mkdir(parents=True)
47
49
  try:
48
- plugin = output / "plugins/ai-docs-toolkit"
50
+ plugin_name = "ai-docs-toolkit-projects" if projects_ui_only else "ai-docs-toolkit"
51
+ plugin = output / "plugins" / plugin_name
49
52
  shutil.copytree(runtime, plugin / "bin", symlinks=True)
50
- shutil.copytree(PLUGIN_SOURCES / "skills", plugin / "skills")
53
+ if not projects_ui_only:
54
+ shutil.copytree(PLUGIN_SOURCES / "skills", plugin / "skills")
51
55
  shutil.copy2(PLUGIN_SOURCES / "mcp.json", plugin / "mcp.json")
52
56
  shutil.copy2(ROOT / "LICENSE", plugin / "LICENSE")
53
57
  manifest = json.loads((PLUGIN_SOURCES / "plugin.json").read_text(encoding="utf-8"))
54
58
  manifest["version"] = __version__
59
+ if projects_preview or projects_ui_only:
60
+ manifest["extensions"]["com.openai"]["interface"]["displayName"] = "AI Docs Toolkit · Projects preview"
61
+ if projects_preview or projects_ui_only or with_projects_ui:
62
+ mcp = json.loads((plugin / "mcp.json").read_text())
63
+ arguments = mcp["mcpServers"]["ai-docs-toolkit"]["args"]
64
+ arguments.append("--projects-ui-only" if projects_ui_only else "--projects-ui")
65
+ for flag, value in [("--projects-codex", projects_codex), ("--projects-home", projects_home)]:
66
+ if value is not None:
67
+ arguments.extend([flag, str(value)])
68
+ if projects_ui_only:
69
+ manifest["name"] = plugin_name
70
+ manifest["description"] = "Local Toolkit project versions and instruction status."
71
+ manifest["extensions"]["com.openai"]["interface"]["shortDescription"] = "Local project versions and instruction status"
72
+ mcp["mcpServers"] = {plugin_name: mcp["mcpServers"].pop("ai-docs-toolkit")}
73
+ write_json(plugin / "mcp.json", mcp)
55
74
  write_json(plugin / "plugin.json", manifest)
56
75
  info = {
57
76
  "engine_version": __version__, "python": platform.python_version(),
@@ -86,11 +105,11 @@ def assemble_plugin(output: Path, runtime: Path, *, release=None) -> None:
86
105
  else:
87
106
  write_json(plugin / "checksums.json", file_hashes(plugin))
88
107
  write_json(output / ".agents/plugins/marketplace.json", {
89
- "name": "ai-docs-toolkit-local",
108
+ "name": "ai-docs-toolkit-projects-preview" if projects_preview or projects_ui_only else "ai-docs-toolkit-local",
90
109
  "interface": {"displayName": "AI Docs Toolkit local builds"},
91
110
  "plugins": [{
92
- "name": "ai-docs-toolkit",
93
- "source": {"source": "local", "path": "./plugins/ai-docs-toolkit"},
111
+ "name": plugin_name,
112
+ "source": {"source": "local", "path": f"./plugins/{plugin_name}"},
94
113
  "policy": {"installation": "AVAILABLE", "authentication": "ON_INSTALL"},
95
114
  "category": "Productivity",
96
115
  }],
@@ -100,7 +119,9 @@ def assemble_plugin(output: Path, runtime: Path, *, release=None) -> None:
100
119
  raise
101
120
 
102
121
 
103
- def build_plugin(output: Path, *, release_policy=None) -> None:
122
+ def build_plugin(output: Path, *, release_policy=None, projects_preview=False,
123
+ projects_codex=None, projects_home=None, projects_ui_only=False,
124
+ with_projects_ui=False) -> None:
104
125
  output = Path(output).absolute()
105
126
  if output.exists():
106
127
  raise FileExistsError(f"Output already exists; choose a new build directory: {output}")
@@ -131,20 +152,35 @@ def build_plugin(output: Path, *, release_policy=None) -> None:
131
152
  "--exclude-module", "readline",
132
153
  "--collect-data", "jsonschema_specifications",
133
154
  "--add-data", f"{ROOT / 'src/ai_docs_toolkit/templates'}:ai_docs_toolkit/templates",
155
+ "--add-data", f"{ROOT / 'src/ai_docs_toolkit/mcp/assets'}:ai_docs_toolkit/mcp/assets",
156
+ "--add-data", f"{ROOT / 'src/ai_docs_toolkit/docs'}:ai_docs_toolkit/docs",
134
157
  str(PLUGIN_SOURCES / "entrypoint.py"),
135
158
  ], cwd=ROOT, check=True)
136
159
  release = (release_policy, work / "work/ai-docs-toolkit/Analysis-00.toc") if release_policy else None
137
- assemble_plugin(output, work / "dist/ai-docs-toolkit", release=release)
160
+ assemble_plugin(output, work / "dist/ai-docs-toolkit", release=release,
161
+ projects_preview=projects_preview, projects_codex=projects_codex, projects_home=projects_home,
162
+ projects_ui_only=projects_ui_only, with_projects_ui=with_projects_ui)
138
163
 
139
164
 
140
165
  def main(argv: list[str] | None = None) -> int:
141
166
  parser = argparse.ArgumentParser(description="Build an autonomous Linux Codex plugin marketplace.")
142
167
  parser.add_argument("--output", required=True, type=Path, help="New marketplace root; existing paths are refused.")
143
168
  parser.add_argument("--release-policy", type=Path, help="Require the pinned native build environment and notices.")
169
+ preview = parser.add_mutually_exclusive_group()
170
+ preview.add_argument("--projects-preview", action="store_true", help="Build the combined workflow and Projects UI preview.")
171
+ preview.add_argument("--projects-ui-only", action="store_true", help="Build a separate Projects UI plugin without project tools or skills.")
172
+ preview.add_argument("--with-projects-ui", action="store_true", help="Include Projects settings in the main Toolkit plugin.")
173
+ parser.add_argument("--projects-codex", type=Path, help="Absolute App backend executable for the Projects preview.")
174
+ parser.add_argument("--projects-home", type=Path, help="Absolute CODEX_HOME of the App profile.")
144
175
  args = parser.parse_args(argv)
176
+ if any(value is not None and (not (args.projects_preview or args.projects_ui_only) or not value.is_absolute())
177
+ for value in [args.projects_codex, args.projects_home]):
178
+ parser.error("Projects source options require a Projects UI mode and absolute paths")
145
179
  try:
146
180
  policy = json.loads(args.release_policy.read_text()) if args.release_policy else None
147
- build_plugin(args.output, release_policy=policy)
181
+ build_plugin(args.output, release_policy=policy, projects_preview=args.projects_preview,
182
+ projects_codex=args.projects_codex, projects_home=args.projects_home,
183
+ projects_ui_only=args.projects_ui_only, with_projects_ui=args.with_projects_ui)
148
184
  except (OSError, ValueError, RuntimeError, subprocess.CalledProcessError) as exc:
149
185
  print(f"Plugin build failed: {exc}", file=sys.stderr)
150
186
  return 1
@@ -135,7 +135,7 @@ def inside_build(output, policy, epoch, revision, wheelhouse, python_source):
135
135
  subprocess.run(install, check=True, env=env)
136
136
  marketplace = output / "marketplace"
137
137
  subprocess.run([str(python), str(source / "scripts/build_codex_plugin.py"), "--output", str(marketplace),
138
- "--release-policy", str(source / "packaging/codex-plugin/linux-x86_64.json")],
138
+ "--with-projects-ui", "--release-policy", str(source / "packaging/codex-plugin/linux-x86_64.json")],
139
139
  cwd=source, env=env, check=True)
140
140
  plugin = marketplace / "plugins/ai-docs-toolkit"
141
141
  metadata = json.loads((plugin / "build-info.json").read_text())
@@ -66,6 +66,49 @@ class GitLab:
66
66
  raise RuntimeError(f"GitLab {method} {path}: connection failed; reconcile remote state before retry") from None
67
67
 
68
68
 
69
+ class ContainerCurlGitLab(GitLab):
70
+ """Use the pinned producer image when the host HTTPS stack is incompatible."""
71
+
72
+ def request(self, method, path, data=None, *, binary=False, read=False):
73
+ image = json.loads((ROOT / "packaging/codex-plugin/linux-x86_64.json").read_text())["image"]
74
+ url = "https://gitlab.com/api/graphql" if path == "graphql" else API + path
75
+ payload = data if isinstance(data, bytes) else json.dumps(data).encode() if data is not None else None
76
+ attempts = 3 if method == "GET" or read else 1
77
+
78
+ def quote(value):
79
+ return '"' + str(value).replace("\\", "\\\\").replace('"', '\\"').replace("\n", "\\n").replace("\r", "\\r") + '"'
80
+
81
+ for attempt in range(attempts):
82
+ with tempfile.TemporaryDirectory(prefix="ai-docs-publish-http-") as folder:
83
+ root = Path(folder)
84
+ config = ["silent", "show-error", "http1.1", 'proto = "=https"', 'proto-redir = "=https"',
85
+ "connect-timeout = 15", "max-time = 180", "url = " + quote(url),
86
+ "request = " + quote(method), 'output = "/http/response"', 'write-out = "%{http_code}"']
87
+ if binary and method == "GET":
88
+ config.append("location")
89
+ else:
90
+ config.append("header = " + quote("PRIVATE-TOKEN: " + self.token))
91
+ if payload is not None:
92
+ (root / "body").write_bytes(payload)
93
+ config.append("header = " + quote("Content-Type: " + ("application/octet-stream" if binary else "application/json")))
94
+ config.append(('upload-file = "/http/body"' if method == "PUT" else 'data-binary = "@/http/body"'))
95
+ command = ["docker", "run", "--rm", "-i", "--read-only", "--tmpfs", "/tmp", "--user", f"{os.getuid()}:{os.getgid()}",
96
+ "--label", "ai-docs.owner=codex-plugin-publication-transport", "--mount", f"type=bind,src={root},dst=/http",
97
+ image, "/usr/bin/curl", "-q", "--config", "-"]
98
+ result = subprocess.run(command, input="\n".join(config) + "\n", capture_output=True, text=True)
99
+ if result.returncode:
100
+ if attempt + 1 < attempts:
101
+ continue
102
+ raise RuntimeError(f"Container HTTPS {method} {path}: failed; reconcile remote state")
103
+ status = int(result.stdout)
104
+ if status == 404 and method == "GET":
105
+ return None
106
+ if not 200 <= status < 300:
107
+ raise RuntimeError(f"GitLab {method} {path}: HTTP {status}")
108
+ content = (root / "response").read_bytes()
109
+ return content if binary else json.loads(content)
110
+
111
+
69
112
  def packet_inputs(packet, ref):
70
113
  packet = Path(packet)
71
114
  if not re.fullmatch(r"[a-f0-9]{40}", ref):
@@ -114,7 +157,7 @@ def packet_inputs(packet, ref):
114
157
  def registry_preflight(api):
115
158
  base = "/projects/" + api.project
116
159
  project = api.request("GET", base)
117
- if project["path_with_namespace"] != "belkov.ai-tools/ai-docs-toolkit" or project["package_registry_access_level"] == "disabled":
160
+ if project["path_with_namespace"] != "belkov.ai-tools/ai-docs-toolkit" or project["visibility"] != "public" or project["package_registry_access_level"] == "disabled":
118
161
  raise ValueError("Unexpected project or disabled package registry.")
119
162
  group = project["namespace"]["full_path"]
120
163
  query = "query {group(fullPath:" + json.dumps(group) + "){packageSettings{genericDuplicatesAllowed genericDuplicateExceptionRegex}} project(fullPath:" + json.dumps(project["path_with_namespace"]) + "){packagesCleanupPolicy{keepNDuplicatedPackageFiles}}}"
@@ -224,10 +267,12 @@ def main(argv=None):
224
267
  parser.add_argument("--notes", required=True, type=Path)
225
268
  parser.add_argument("--report", required=True, type=Path)
226
269
  parser.add_argument("--apply", action="store_true")
270
+ parser.add_argument("--transport", choices=["urllib", "container-curl"], default="urllib")
227
271
  args = parser.parse_args(argv)
228
272
  try:
229
273
  review, files = packet_inputs(args.packet, args.ref)
230
- result = publish(GitLab(args.project), review, files, ref=args.ref, tag=args.tag,
274
+ api = (ContainerCurlGitLab if args.transport == "container-curl" else GitLab)(args.project)
275
+ result = publish(api, review, files, ref=args.ref, tag=args.tag,
231
276
  notes=args.notes.read_text(), apply=args.apply)
232
277
  except (OSError, RuntimeError, ValueError, KeyError, subprocess.CalledProcessError, tarfile.TarError) as exc:
233
278
  print(json.dumps(dict(ok=False, error=str(exc))))
@@ -1,3 +1,3 @@
1
1
  """AI Docs Toolkit package baseline."""
2
2
 
3
- __version__ = "0.19.0"
3
+ __version__ = "0.20.2"
@@ -0,0 +1,182 @@
1
+ """Read local App projects through an owned, credential-free app-server process."""
2
+ import asyncio
3
+ from contextlib import asynccontextmanager
4
+ from datetime import datetime, timezone
5
+ import json
6
+ import os
7
+ from pathlib import Path
8
+ import shutil
9
+ import signal
10
+
11
+ from .project_inspection import inspect_project
12
+
13
+
14
+ TIMEOUT = 10
15
+ MAX_BYTES = 4 * 1024 * 1024
16
+ MAX_PROJECTS = 1000
17
+ MAX_ROWS = 2000
18
+
19
+
20
+ class ProjectsError(ValueError):
21
+ pass
22
+
23
+
24
+ def source_options(codex=None, home=None):
25
+ bundled = Path('/usr/lib/chatgpt/resources/codex')
26
+ executable = codex or (bundled if bundled.is_file() else shutil.which('codex'))
27
+ if not executable or not Path(executable).is_absolute():
28
+ raise ProjectsError('projects.executable_missing')
29
+ executable = Path(executable)
30
+ profile = Path(home or os.environ.get('CODEX_HOME') or Path.home() / '.codex')
31
+ if not executable.is_file() or not os.access(executable, os.X_OK):
32
+ raise ProjectsError('projects.executable_missing')
33
+ if not profile.is_absolute() or not profile.is_dir():
34
+ raise ProjectsError('projects.profile_missing')
35
+ return executable, profile
36
+
37
+
38
+ class _Client:
39
+ def __init__(self, process):
40
+ self.process = process
41
+ self.sequence = 0
42
+ self.bytes = 0
43
+
44
+ async def send(self, value):
45
+ self.process.stdin.write((json.dumps(value) + '\n').encode())
46
+ await self.process.stdin.drain()
47
+
48
+ async def request(self, method, params):
49
+ self.sequence += 1
50
+ number = self.sequence
51
+ await self.send(dict(id=number, method=method, params=params))
52
+ for _ in range(1000):
53
+ try:
54
+ line = await self.process.stdout.readline()
55
+ except ValueError as exc:
56
+ raise ProjectsError('projects.limit') from exc
57
+ if not line:
58
+ raise ProjectsError('projects.unavailable')
59
+ self.bytes += len(line)
60
+ if self.bytes > MAX_BYTES:
61
+ raise ProjectsError('projects.limit')
62
+ try:
63
+ value = json.loads(line)
64
+ except (ValueError, RecursionError) as exc:
65
+ raise ProjectsError('projects.protocol') from exc
66
+ if not isinstance(value, dict):
67
+ raise ProjectsError('projects.protocol')
68
+ if 'method' in value:
69
+ if 'id' in value:
70
+ await self.send(dict(id=value['id'], error=dict(code=-32601, message='Read-only project discovery.')))
71
+ continue
72
+ if value.get('id') != number:
73
+ raise ProjectsError('projects.protocol')
74
+ if 'error' in value:
75
+ error = value['error']
76
+ code = 'projects.unsupported' if isinstance(error, dict) and error.get('code') == -32601 else 'projects.unavailable'
77
+ raise ProjectsError(code)
78
+ if not isinstance(value.get('result'), dict):
79
+ raise ProjectsError('projects.protocol')
80
+ return value['result']
81
+ raise ProjectsError('projects.limit')
82
+
83
+
84
+ @asynccontextmanager
85
+ async def _client(executable, profile):
86
+ env = dict(HOME=str(Path.home()), CODEX_HOME=str(profile), PATH=os.defpath,
87
+ LANG='C.UTF-8', NO_BROWSER='1')
88
+ if os.name == 'nt' and 'SystemRoot' in os.environ:
89
+ env['SystemRoot'] = os.environ['SystemRoot']
90
+ process = await asyncio.create_subprocess_exec(
91
+ str(executable), '-c', 'features.apps=false', '-c', 'cli_auth_credentials_store="ephemeral"',
92
+ 'app-server', '--stdio', cwd=str(profile), env=env,
93
+ stdin=asyncio.subprocess.PIPE, stdout=asyncio.subprocess.PIPE, stderr=asyncio.subprocess.DEVNULL,
94
+ start_new_session=os.name == 'posix', limit=MAX_BYTES + 1)
95
+ try:
96
+ yield _Client(process)
97
+ finally:
98
+ if os.name == 'posix':
99
+ try:
100
+ os.killpg(process.pid, signal.SIGTERM)
101
+ except ProcessLookupError:
102
+ pass
103
+ elif process.returncode is None:
104
+ process.terminate()
105
+ try:
106
+ await asyncio.wait_for(process.wait(), 1)
107
+ except TimeoutError:
108
+ if os.name == 'posix':
109
+ try:
110
+ os.killpg(process.pid, signal.SIGKILL)
111
+ except ProcessLookupError:
112
+ pass
113
+ else:
114
+ process.kill()
115
+ await process.wait()
116
+ finally:
117
+ if os.name == 'posix':
118
+ try:
119
+ os.killpg(process.pid, signal.SIGKILL)
120
+ except ProcessLookupError:
121
+ pass
122
+
123
+
124
+ async def read_projects(*, codex=None, home=None):
125
+ executable, profile = source_options(codex, home)
126
+ try:
127
+ async with _client(executable, profile) as client:
128
+ async with asyncio.timeout(TIMEOUT):
129
+ await client.request('initialize', dict(
130
+ clientInfo=dict(name='ai-docs-projects', version='1'),
131
+ capabilities=dict(experimentalApi=True)))
132
+ await client.send(dict(method='initialized'))
133
+ projects, ids, cursors = [], set(), set()
134
+ cursor = None
135
+ while True:
136
+ page = await client.request('project/list', dict(limit=100, cursor=cursor))
137
+ items = page.get('data')
138
+ if not isinstance(items, list):
139
+ raise ProjectsError('projects.protocol')
140
+ for item in items:
141
+ if (not isinstance(item, dict) or not isinstance(item.get('id'), str)
142
+ or not item['id'] or item['id'] in ids
143
+ or not isinstance(item.get('name'), str) or len(item['name']) > 4096
144
+ or not isinstance(item.get('roots'), list)):
145
+ raise ProjectsError('projects.protocol')
146
+ ids.add(item['id'])
147
+ roots = []
148
+ for root in item['roots']:
149
+ path = root.get('path') if isinstance(root, dict) else None
150
+ if (not isinstance(path, str) or not path or len(path) > 4096
151
+ or '\0' in path or not Path(path).is_absolute()):
152
+ raise ProjectsError('projects.protocol')
153
+ roots.append(path)
154
+ projects.append(dict(id=item['id'], name=item['name'], roots=roots))
155
+ if len(projects) > MAX_PROJECTS or sum(len(p['roots']) for p in projects) > MAX_ROWS:
156
+ raise ProjectsError('projects.limit')
157
+ cursor = page.get('nextCursor')
158
+ if cursor is None:
159
+ return projects
160
+ if not isinstance(cursor, str) or not cursor or cursor in cursors:
161
+ raise ProjectsError('projects.protocol')
162
+ cursors.add(cursor)
163
+ except TimeoutError as exc:
164
+ raise ProjectsError('projects.timeout') from exc
165
+ except (OSError, ValueError, ConnectionError) as exc:
166
+ if isinstance(exc, ProjectsError):
167
+ raise
168
+ raise ProjectsError('projects.unavailable') from exc
169
+
170
+
171
+ async def projects_snapshot(*, codex=None, home=None):
172
+ projects = await read_projects(codex=codex, home=home)
173
+ rows, inspected = [], {}
174
+ for project in projects:
175
+ for path in project['roots']:
176
+ if path not in inspected:
177
+ inspected[path] = inspect_project(path)
178
+ rows.append({**inspected[path], 'name': project['name'], 'project_id': project['id'],
179
+ 'folder_name': Path(path).name or path})
180
+ return dict(projects=rows, project_count=sum(bool(p['roots']) for p in projects),
181
+ checked_at=datetime.now(timezone.utc).isoformat(),
182
+ scope='app_project_folders', version_evidence='passive_metadata')