@c4a/context-cli 0.6.1 → 0.6.3

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 (246) hide show
  1. package/README.md +77 -12
  2. package/README.zh-CN.md +202 -0
  3. package/cli.js +74066 -45247
  4. package/docs/context-debug-event-v1.schema.json +29 -0
  5. package/docs/context-debug-replay-v1.schema.json +33 -0
  6. package/docs/debug-tracing.md +86 -0
  7. package/docs/quickstart.md +23 -5
  8. package/package.json +8 -3
  9. package/plugins/README.md +60 -118
  10. package/plugins/README_CN.md +51 -102
  11. package/plugins/VERSION +1 -1
  12. package/plugins/claude/.claude-plugin/plugin.json +1 -1
  13. package/plugins/claude/commands/continue.md +61 -10
  14. package/plugins/claude/commands/init.md +26 -11
  15. package/plugins/codex/.codex-plugin/plugin.json +2 -2
  16. package/plugins/codex/skills/continue/SKILL.md +61 -11
  17. package/plugins/codex/skills/init/SKILL.md +28 -14
  18. package/plugins/cursor/.cursor-plugin/plugin.json +2 -3
  19. package/plugins/cursor/README.md +2 -2
  20. package/plugins/cursor/commands/context-continue.md +61 -10
  21. package/plugins/cursor/commands/context-init.md +26 -11
  22. package/plugins/skills/context-continue/SKILL.md +61 -11
  23. package/plugins/skills/context-init/SKILL.md +28 -14
  24. package/providers/context/actions/accept-package-templates.yaml +5 -0
  25. package/providers/context/actions/align-next.yaml +6 -0
  26. package/providers/context/actions/apply-managed-review.yaml +5 -0
  27. package/providers/context/actions/apply-structure-confirmation.yaml +5 -0
  28. package/providers/context/actions/build-next.yaml +5 -0
  29. package/providers/context/actions/capture-next.yaml +5 -0
  30. package/providers/context/actions/close-approved-knowledge.yaml +5 -0
  31. package/providers/context/actions/compile-next.yaml +5 -0
  32. package/providers/context/actions/configure-code-extraction.yaml +5 -0
  33. package/providers/context/actions/configure-document-capture.yaml +5 -0
  34. package/providers/context/actions/configure-package-output.yaml +5 -0
  35. package/providers/context/actions/configure-prose-lifecycle.yaml +5 -0
  36. package/providers/context/actions/extract-next.yaml +5 -0
  37. package/providers/context/actions/inspect-document-classification.yaml +5 -0
  38. package/providers/context/actions/inspect-repository-recovery.yaml +6 -0
  39. package/providers/context/actions/inspect-review.yaml +5 -0
  40. package/providers/context/actions/inspect-structure.yaml +5 -0
  41. package/providers/context/actions/maintain-evidence.yaml +6 -0
  42. package/providers/context/actions/materialize-context-view.yaml +8 -0
  43. package/providers/context/actions/reconcile-review-identities.yaml +5 -0
  44. package/providers/context/actions/register-source-batch.yaml +7 -0
  45. package/providers/context/actions/repair-project-entry.yaml +5 -0
  46. package/providers/context/actions/repair-verification.yaml +5 -0
  47. package/providers/context/actions/repair-workspace-state.yaml +5 -0
  48. package/providers/context/actions/restore-repository-sources.yaml +7 -0
  49. package/providers/context/codes.yaml +41 -0
  50. package/providers/context/graphs/workspace.yaml +536 -0
  51. package/providers/context/manifest.json +700 -0
  52. package/providers/context/provider.yaml +12 -0
  53. package/providers/context/resources/diagnostics/projection-stale.md +13 -0
  54. package/providers/context/resources/diagnostics/verification.md +21 -0
  55. package/providers/context/resources/diagnostics/workspace-state.md +27 -0
  56. package/providers/context/resources/dialogue/code-extraction.md +34 -0
  57. package/providers/context/resources/dialogue/document-capture.md +29 -0
  58. package/providers/context/resources/dialogue/document-classification.md +33 -0
  59. package/providers/context/resources/dialogue/evidence-maintenance.md +26 -0
  60. package/providers/context/resources/dialogue/human-gates.md +34 -0
  61. package/providers/context/resources/dialogue/knowledge-review.md +27 -0
  62. package/providers/context/resources/dialogue/package-output.md +30 -0
  63. package/providers/context/resources/dialogue/repository-source-recovery.md +23 -0
  64. package/providers/context/resources/dialogue/source-boundary.md +29 -0
  65. package/providers/context/resources/dialogue/structure-confirmation.md +44 -0
  66. package/providers/context/resources/manuals/guides/lark-resources.md +121 -0
  67. package/providers/context/resources/manuals/guides/package-outputs.md +267 -0
  68. package/providers/context/resources/manuals/reference/package-templates.md +378 -0
  69. package/providers/context/resources/manuals/reference/project-api.md +825 -0
  70. package/providers/context/resources/manuals/reference/template-variables.md +248 -0
  71. package/providers/context/resources/procedures/close-and-build.md +23 -0
  72. package/providers/context/resources/procedures/code-extraction.md +50 -0
  73. package/providers/context/resources/procedures/document-capture.md +49 -0
  74. package/providers/context/resources/procedures/document-classification.md +22 -0
  75. package/providers/context/resources/procedures/evidence-maintenance.md +20 -0
  76. package/providers/context/resources/procedures/knowledge-review.md +34 -0
  77. package/providers/context/resources/procedures/package-output.md +37 -0
  78. package/providers/context/resources/procedures/project-configuration.md +21 -0
  79. package/providers/context/resources/procedures/prose-align.md +68 -0
  80. package/providers/context/resources/procedures/prose-compile.md +23 -0
  81. package/providers/context/resources/procedures/repository-source-recovery.md +43 -0
  82. package/providers/context/resources/procedures/source-boundary.md +48 -0
  83. package/{plugins/codex/skills/continue/references/internal-procedures/skill-source-scope/references/capture-source.md → providers/context/resources/procedures/source-capture-detailed.md} +54 -19
  84. package/providers/context/resources/procedures/verify-and-repair.md +31 -0
  85. package/{plugins/claude/skills/skill-prose-align/references/internal-procedures/structure-planning/references → providers/context/resources/semantic/align}/candidate-resolution.md +17 -2
  86. package/{plugins/claude/skills/skill-prose-align/references/internal-procedures/structure-planning/references → providers/context/resources/semantic/align}/density-profile.md +11 -0
  87. package/{plugins/codex/skills/init/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references → providers/context/resources/semantic/align}/gates.md +13 -0
  88. package/{plugins/cursor/skills/skill-prose-align/references/internal-procedures → providers/context/resources/semantic/align}/structure-planning.md +62 -12
  89. package/providers/context/resources/semantic/compile/index.md +31 -0
  90. package/providers/context/resources/views/package-current.yaml +6 -0
  91. package/providers/context/resources/views/review-current.yaml +6 -0
  92. package/providers/context/resources/views/source-boundary.yaml +6 -0
  93. package/providers/context/resources/views/source-current.yaml +6 -0
  94. package/providers/context/resources/views/structure-current.yaml +6 -0
  95. package/providers/context/resources/views/verification-current.yaml +6 -0
  96. package/providers/context/resources/views/workspace-current.yaml +6 -0
  97. package/providers/context/schemas/evidence-maintenance-input.schema.json +30 -0
  98. package/providers/context/schemas/prose-structure-batch.schema.json +35 -0
  99. package/providers/context/schemas/repository-source-recovery.schema.json +40 -0
  100. package/providers/context/schemas/source-batch-input.schema.json +189 -0
  101. package/providers/context/scripts/render-context-view.mjs +21 -0
  102. package/plugins/claude/skills/skill-continue-workflow/SKILL.md +0 -235
  103. package/plugins/claude/skills/skill-init-workspace/SKILL.md +0 -74
  104. package/plugins/claude/skills/skill-package-output/SKILL.md +0 -180
  105. package/plugins/claude/skills/skill-prose-align/SKILL.md +0 -322
  106. package/plugins/claude/skills/skill-prose-align/references/internal-procedures/structure-planning/references/gates.md +0 -263
  107. package/plugins/claude/skills/skill-prose-align/references/internal-procedures/structure-planning.md +0 -282
  108. package/plugins/claude/skills/skill-prose-compile/SKILL.md +0 -287
  109. package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/close-gate.md +0 -132
  110. package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/compile-actions/references/action-domain-gates.md +0 -52
  111. package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/compile-actions/references/notes.md +0 -48
  112. package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/compile-actions/references/refresh-and-update.md +0 -85
  113. package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/compile-actions/references/structural-challenges.md +0 -73
  114. package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/compile-actions.md +0 -413
  115. package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/compile-judgment.md +0 -123
  116. package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/semantic-judgment/references/disposition-semantics.md +0 -81
  117. package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/semantic-judgment/references/leakage-and-ownership.md +0 -55
  118. package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/semantic-judgment/references/scope-review-and-omit.md +0 -93
  119. package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/semantic-judgment/references/temporal-and-evidence.md +0 -79
  120. package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/semantic-judgment/references/user-confirmation.md +0 -111
  121. package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/semantic-judgment.md +0 -194
  122. package/plugins/claude/skills/skill-review-gate/SKILL.md +0 -138
  123. package/plugins/claude/skills/skill-source-scope/SKILL.md +0 -525
  124. package/plugins/claude/skills/skill-source-scope/references/capture-source.md +0 -201
  125. package/plugins/codex/skills/continue/references/internal-procedures/skill-continue-workflow.md +0 -235
  126. package/plugins/codex/skills/continue/references/internal-procedures/skill-init-workspace.md +0 -74
  127. package/plugins/codex/skills/continue/references/internal-procedures/skill-package-output.md +0 -180
  128. package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/candidate-resolution.md +0 -91
  129. package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/density-profile.md +0 -30
  130. package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/gates.md +0 -263
  131. package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning.md +0 -282
  132. package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-align.md +0 -322
  133. package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/close-gate.md +0 -132
  134. package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/action-domain-gates.md +0 -52
  135. package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/notes.md +0 -48
  136. package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/refresh-and-update.md +0 -85
  137. package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/structural-challenges.md +0 -73
  138. package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions.md +0 -413
  139. package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-judgment.md +0 -123
  140. package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/disposition-semantics.md +0 -81
  141. package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/leakage-and-ownership.md +0 -55
  142. package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/scope-review-and-omit.md +0 -93
  143. package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/temporal-and-evidence.md +0 -79
  144. package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/user-confirmation.md +0 -111
  145. package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment.md +0 -194
  146. package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile.md +0 -287
  147. package/plugins/codex/skills/continue/references/internal-procedures/skill-review-gate.md +0 -138
  148. package/plugins/codex/skills/continue/references/internal-procedures/skill-source-scope.md +0 -525
  149. package/plugins/codex/skills/init/references/internal-procedures/skill-continue-workflow.md +0 -235
  150. package/plugins/codex/skills/init/references/internal-procedures/skill-init-workspace.md +0 -74
  151. package/plugins/codex/skills/init/references/internal-procedures/skill-package-output.md +0 -180
  152. package/plugins/codex/skills/init/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/candidate-resolution.md +0 -91
  153. package/plugins/codex/skills/init/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/density-profile.md +0 -30
  154. package/plugins/codex/skills/init/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning.md +0 -282
  155. package/plugins/codex/skills/init/references/internal-procedures/skill-prose-align.md +0 -322
  156. package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/close-gate.md +0 -132
  157. package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/action-domain-gates.md +0 -52
  158. package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/notes.md +0 -48
  159. package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/refresh-and-update.md +0 -85
  160. package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/structural-challenges.md +0 -73
  161. package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions.md +0 -413
  162. package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-judgment.md +0 -123
  163. package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/disposition-semantics.md +0 -81
  164. package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/leakage-and-ownership.md +0 -55
  165. package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/scope-review-and-omit.md +0 -93
  166. package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/temporal-and-evidence.md +0 -79
  167. package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/user-confirmation.md +0 -111
  168. package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment.md +0 -194
  169. package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile.md +0 -287
  170. package/plugins/codex/skills/init/references/internal-procedures/skill-review-gate.md +0 -138
  171. package/plugins/codex/skills/init/references/internal-procedures/skill-source-scope/references/capture-source.md +0 -201
  172. package/plugins/codex/skills/init/references/internal-procedures/skill-source-scope.md +0 -525
  173. package/plugins/cursor/skills/skill-continue-workflow/SKILL.md +0 -235
  174. package/plugins/cursor/skills/skill-init-workspace/SKILL.md +0 -74
  175. package/plugins/cursor/skills/skill-package-output/SKILL.md +0 -180
  176. package/plugins/cursor/skills/skill-prose-align/SKILL.md +0 -322
  177. package/plugins/cursor/skills/skill-prose-align/references/internal-procedures/structure-planning/references/candidate-resolution.md +0 -91
  178. package/plugins/cursor/skills/skill-prose-align/references/internal-procedures/structure-planning/references/density-profile.md +0 -30
  179. package/plugins/cursor/skills/skill-prose-align/references/internal-procedures/structure-planning/references/gates.md +0 -263
  180. package/plugins/cursor/skills/skill-prose-compile/SKILL.md +0 -287
  181. package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/close-gate.md +0 -132
  182. package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/compile-actions/references/action-domain-gates.md +0 -52
  183. package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/compile-actions/references/notes.md +0 -48
  184. package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/compile-actions/references/refresh-and-update.md +0 -85
  185. package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/compile-actions/references/structural-challenges.md +0 -73
  186. package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/compile-actions.md +0 -413
  187. package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/compile-judgment.md +0 -123
  188. package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/semantic-judgment/references/disposition-semantics.md +0 -81
  189. package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/semantic-judgment/references/leakage-and-ownership.md +0 -55
  190. package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/semantic-judgment/references/scope-review-and-omit.md +0 -93
  191. package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/semantic-judgment/references/temporal-and-evidence.md +0 -79
  192. package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/semantic-judgment/references/user-confirmation.md +0 -111
  193. package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/semantic-judgment.md +0 -194
  194. package/plugins/cursor/skills/skill-review-gate/SKILL.md +0 -138
  195. package/plugins/cursor/skills/skill-source-scope/SKILL.md +0 -525
  196. package/plugins/cursor/skills/skill-source-scope/references/capture-source.md +0 -201
  197. package/plugins/skills/context-continue/references/internal-procedures/skill-continue-workflow.md +0 -235
  198. package/plugins/skills/context-continue/references/internal-procedures/skill-init-workspace.md +0 -74
  199. package/plugins/skills/context-continue/references/internal-procedures/skill-package-output.md +0 -180
  200. package/plugins/skills/context-continue/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/candidate-resolution.md +0 -91
  201. package/plugins/skills/context-continue/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/density-profile.md +0 -30
  202. package/plugins/skills/context-continue/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/gates.md +0 -263
  203. package/plugins/skills/context-continue/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning.md +0 -282
  204. package/plugins/skills/context-continue/references/internal-procedures/skill-prose-align.md +0 -322
  205. package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/close-gate.md +0 -132
  206. package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/action-domain-gates.md +0 -52
  207. package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/notes.md +0 -48
  208. package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/refresh-and-update.md +0 -85
  209. package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/structural-challenges.md +0 -73
  210. package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions.md +0 -413
  211. package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-judgment.md +0 -123
  212. package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/disposition-semantics.md +0 -81
  213. package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/leakage-and-ownership.md +0 -55
  214. package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/scope-review-and-omit.md +0 -93
  215. package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/temporal-and-evidence.md +0 -79
  216. package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/user-confirmation.md +0 -111
  217. package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment.md +0 -194
  218. package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile.md +0 -287
  219. package/plugins/skills/context-continue/references/internal-procedures/skill-review-gate.md +0 -138
  220. package/plugins/skills/context-continue/references/internal-procedures/skill-source-scope/references/capture-source.md +0 -201
  221. package/plugins/skills/context-continue/references/internal-procedures/skill-source-scope.md +0 -525
  222. package/plugins/skills/context-init/references/internal-procedures/skill-continue-workflow.md +0 -235
  223. package/plugins/skills/context-init/references/internal-procedures/skill-init-workspace.md +0 -74
  224. package/plugins/skills/context-init/references/internal-procedures/skill-package-output.md +0 -180
  225. package/plugins/skills/context-init/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/candidate-resolution.md +0 -91
  226. package/plugins/skills/context-init/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/density-profile.md +0 -30
  227. package/plugins/skills/context-init/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/gates.md +0 -263
  228. package/plugins/skills/context-init/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning.md +0 -282
  229. package/plugins/skills/context-init/references/internal-procedures/skill-prose-align.md +0 -322
  230. package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/close-gate.md +0 -132
  231. package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/action-domain-gates.md +0 -52
  232. package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/notes.md +0 -48
  233. package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/refresh-and-update.md +0 -85
  234. package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/structural-challenges.md +0 -73
  235. package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions.md +0 -413
  236. package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-judgment.md +0 -123
  237. package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/disposition-semantics.md +0 -81
  238. package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/leakage-and-ownership.md +0 -55
  239. package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/scope-review-and-omit.md +0 -93
  240. package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/temporal-and-evidence.md +0 -79
  241. package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/user-confirmation.md +0 -111
  242. package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment.md +0 -194
  243. package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile.md +0 -287
  244. package/plugins/skills/context-init/references/internal-procedures/skill-review-gate.md +0 -138
  245. package/plugins/skills/context-init/references/internal-procedures/skill-source-scope/references/capture-source.md +0 -201
  246. package/plugins/skills/context-init/references/internal-procedures/skill-source-scope.md +0 -525
@@ -0,0 +1,29 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://context4.ai/schemas/context-debug-event-v1.schema.json",
4
+ "title": "Context debug event v1",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": ["schema", "trace_id", "sequence", "at", "kind", "data"],
8
+ "properties": {
9
+ "schema": { "const": "context.debug.event.v1" },
10
+ "trace_id": { "type": "string", "minLength": 1 },
11
+ "sequence": { "type": "integer", "minimum": 1 },
12
+ "at": { "type": "string", "format": "date-time" },
13
+ "kind": {
14
+ "enum": [
15
+ "debug.enabled",
16
+ "debug.disabled",
17
+ "cli.invoked",
18
+ "cli.completed",
19
+ "agent-graph.evaluated",
20
+ "workflow.action-started",
21
+ "workflow.action-completed",
22
+ "workflow.stopped"
23
+ ]
24
+ },
25
+ "invocation_id": { "type": "string", "minLength": 1 },
26
+ "parent_invocation_id": { "type": "string", "minLength": 1 },
27
+ "data": { "type": "object" }
28
+ }
29
+ }
@@ -0,0 +1,33 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://context4.ai/schemas/context-debug-replay-v1.schema.json",
4
+ "title": "Context debug replay v1",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": ["schema", "generated_at", "events", "transitions"],
8
+ "properties": {
9
+ "schema": { "const": "context.debug.replay.v1" },
10
+ "generated_at": { "type": "string", "format": "date-time" },
11
+ "trace_id": { "type": "string" },
12
+ "events": {
13
+ "type": "array",
14
+ "items": { "$ref": "./context-debug-event-v1.schema.json" }
15
+ },
16
+ "transitions": {
17
+ "type": "array",
18
+ "items": {
19
+ "type": "object",
20
+ "additionalProperties": false,
21
+ "required": ["sequence", "at", "current"],
22
+ "properties": {
23
+ "sequence": { "type": "integer", "minimum": 1 },
24
+ "at": { "type": "string", "format": "date-time" },
25
+ "invocation_id": { "type": "string" },
26
+ "previous": { "type": "object" },
27
+ "current": { "type": "object" },
28
+ "selected_route": { "type": "object" }
29
+ }
30
+ }
31
+ }
32
+ }
33
+ }
@@ -0,0 +1,86 @@
1
+ # Workspace debug tracing
2
+
3
+ Context debug tracing is an explicit, workspace-local observation mode. It is
4
+ disabled by default. It does not change Agent Graph facts, route selection,
5
+ human gates, command eligibility, lifecycle writes, or command exit status.
6
+
7
+ Enable it while initializing a workspace:
8
+
9
+ ```bash
10
+ context init context --debug
11
+ ```
12
+
13
+ Or enable it later:
14
+
15
+ ```bash
16
+ context debug enable
17
+ ```
18
+
19
+ Both forms set `package.json` `context.debug` to `true`. Disabling tracing
20
+ removes that property but keeps the existing trace for inspection:
21
+
22
+ ```bash
23
+ context debug disable
24
+ ```
25
+
26
+ ## Files
27
+
28
+ Tracing writes only below the ignored workspace `.tmp` directory:
29
+
30
+ ```text
31
+ .tmp/context-runtime/debug/
32
+ ├── events.jsonl
33
+ ├── state.json
34
+ └── replay.json
35
+ ```
36
+
37
+ - `events.jsonl` is the append-only source of truth. Each line conforms to
38
+ [`context.debug.event.v1`](./context-debug-event-v1.schema.json).
39
+ - `state.json` owns the trace id, monotonic sequence, and last observed graph
40
+ state. It is recorder state, not workflow state.
41
+ - `replay.json` is a disposable projection produced by `context debug export`
42
+ and conforms to [`context.debug.replay.v1`](./context-debug-replay-v1.schema.json).
43
+
44
+ No command stdout, source body, knowledge page, or resource body is copied into
45
+ the trace. Sensitive option values are redacted. Command receipts contain only
46
+ status, duration, byte counts, and hashes already available to the managed
47
+ runner.
48
+
49
+ ## Event model
50
+
51
+ The event stream records:
52
+
53
+ - CLI invocation and completion, including parent invocation identity for
54
+ managed child commands;
55
+ - Agent Graph evaluation revision, status, selected route, alternatives, and
56
+ whether the observable graph position changed;
57
+ - managed workflow action start and completion with deterministic receipts;
58
+ - the reason and graph position at which a managed loop stopped.
59
+
60
+ `trace_id` groups the workspace-local debug history, `sequence` defines replay order,
61
+ `invocation_id` groups work performed by one CLI process, and
62
+ `parent_invocation_id` connects managed child commands to their runner. A UI
63
+ can animate `agent-graph.evaluated` events whose `data.transition.changed` is
64
+ true, then associate intervening command and action events by sequence and
65
+ invocation identity.
66
+
67
+ ## Inspect and export
68
+
69
+ ```bash
70
+ context debug status --format json
71
+ context debug export --format json
72
+ ```
73
+
74
+ Status returns configuration, event counts, and relative trace paths. Export
75
+ mechanically derives a replay document containing the complete event stream and
76
+ its changed graph transitions. A custom export path must remain below the
77
+ workspace `.tmp` directory:
78
+
79
+ ```bash
80
+ context debug export --output .tmp/analysis/replay.json --format json
81
+ ```
82
+
83
+ Recorder failures are intentionally non-fatal. They can make a trace
84
+ incomplete, but they cannot alter the command being observed. Consumers should
85
+ therefore validate monotonic `sequence` values before presenting a replay as
86
+ complete.
@@ -31,6 +31,13 @@ Create a standalone workspace:
31
31
  context init context
32
32
  ```
33
33
 
34
+ Choose the generated workspace and starter-template language explicitly when
35
+ needed; the CLI does not infer it from terminal locale or conversation text:
36
+
37
+ ```bash
38
+ context init context --language zh-CN
39
+ ```
40
+
34
41
  Then enter it and install dependencies:
35
42
 
36
43
  ```bash
@@ -44,8 +51,8 @@ After initialization, read the workspace guidance:
44
51
  AGENTS.md
45
52
  ```
46
53
 
47
- `AGENTS.md` explains the current project, SDK references, plugin Skills, and
48
- the safe workflow for agents. It is the project-local starting point after
54
+ `AGENTS.md` explains the current project, SDK references, installed Agent
55
+ entry, and safe workflow contract. It is the project-local starting point after
49
56
  `context init`.
50
57
 
51
58
  ## 3. Work Through an Agent
@@ -54,15 +61,26 @@ Inside the workspace, ask the installed agent plugin to continue the workflow.
54
61
  The agent should:
55
62
 
56
63
  1. read `AGENTS.md`;
57
- 2. run `context status`;
58
- 3. follow the status `next` hint and CLI diagnostics;
59
- 4. stop at human gates such as source scope, structure confirmation, review,
64
+ 2. run `context status --format json`;
65
+ 3. treat `workflow.current` as the current-step authority, read each
66
+ `resources.required` item, and execute only the returned command or
67
+ configuration action;
68
+ 4. at a Gate, load an `inspection_action` Skill or Schema only for
69
+ pre-decision inspection and a `resolution_action` Skill or Schema only
70
+ after confirmation;
71
+ 5. stop at human gates such as source scope, structure confirmation, review,
60
72
  and package decisions.
61
73
 
62
74
  The CLI performs mechanical work such as source registration, capture,
63
75
  validation, review application, verify, close, and build. The agent performs
64
76
  semantic judgment only when the workflow asks for it.
65
77
 
78
+ When the user explicitly requests fully managed operation, the Agent starts with
79
+ `context run --managed --until blocked-or-complete --format json` to collapse
80
+ consecutive deterministic routes. The CLI re-evaluates every revision and
81
+ stops before semantic reads, configuration, missing authority, diagnostics, or
82
+ multiple commands.
83
+
66
84
  ## 4. Manual Orientation
67
85
 
68
86
  When operating without an agent plugin, start with:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@c4a/context-cli",
3
- "version": "0.6.1",
3
+ "version": "0.6.3",
4
4
  "type": "module",
5
5
  "description": "Local CLI for capturing, compiling, and governing knowledge workspaces",
6
6
  "license": "MIT",
@@ -16,12 +16,17 @@
16
16
  "claude-code",
17
17
  "claude-plugin"
18
18
  ],
19
+ "engines": {
20
+ "node": ">=20"
21
+ },
19
22
  "bin": {
20
- "context": "cli.js"
23
+ "context": "dist/cli.js"
21
24
  },
22
25
  "dependencies": {
23
- "@c4a/context": "0.6.1",
26
+ "@c4a/agent-graph": "0.2.4",
27
+ "@c4a/context": "0.6.3",
24
28
  "commander": "^11.0.0",
29
+ "fast-xml-parser": "^5.10.1",
25
30
  "handlebars": "^4.7.8",
26
31
  "ink": "^5.0.0",
27
32
  "jiti": "^2.7.0",
package/plugins/README.md CHANGED
@@ -4,155 +4,97 @@
4
4
 
5
5
  <p align="center"><img src="./assets/logo.svg" alt="C4A Context" width="180"/></p>
6
6
 
7
- Context provides agent commands for maintaining a project-local knowledge workspace. The plugin is installed globally for the agent, while each workspace keeps its own sources, pending review state, approved knowledge, and build output. Public agent entrypoints are intentionally small: initialize once, then use next-step guidance.
8
-
9
- Agent dialogue should follow the user's current conversation language. CLI
10
- commands, flags, ids, status values, JSONL keys, and `source_ref` tokens are
11
- protocol text and stay unchanged.
7
+ Context provides a thin Agent entry for project-local knowledge workspaces. The
8
+ plugin does not embed the whole workflow in one prompt. It starts from current
9
+ workspace facts, then Context CLI selects the legal route, commands, gates, and
10
+ Markdown/schema resources for that step.
12
11
 
13
12
  ## Install
14
13
 
15
- Install the CLI first:
16
-
17
14
  ```bash
18
15
  npm i -g @c4a/context-cli
19
- # or
20
- bun add -g @c4a/context-cli
21
- ```
22
-
23
- Then install the bundled plugin marketplace globally:
24
-
25
- ```bash
26
16
  context plugin install
27
17
  ```
28
18
 
29
- The installer resolves the plugin marketplace from the installed CLI package. Published packages use `dist/plugins`; source checkouts use the same generated tree after `bun run --filter @c4a/context-cli build`. For Codex, it materializes the bundled plugin into `~/.codex/plugins/cache/c4a/context/local/`, matching Codex's local-plugin cache convention.
30
-
31
- For a dry run:
19
+ For a source checkout, build the CLI and plugin first:
32
20
 
33
21
  ```bash
34
- context plugin install --dry-run
35
- context plugin path
22
+ bun run --filter @c4a/context-cli build
23
+ context plugin install --dev
36
24
  ```
37
25
 
38
- ## Workflow
26
+ Use `context plugin install --dry-run` to inspect installation and
27
+ `context plugin path` to locate the bundled marketplace.
39
28
 
40
- Run commands from the context project root.
29
+ ## Agent entry
41
30
 
42
- 1. Initialize a workspace:
31
+ The public host surface stays small:
43
32
 
44
- ```bash
45
- context init context
46
- cd context
47
- bun install
48
- ```
33
+ - `init` creates a Context workspace;
34
+ - `continue` observes and advances an existing workspace.
49
35
 
50
- 2. Continue through the installed agent entry:
36
+ Continuation starts with:
51
37
 
52
- ```bash
53
- <host-specific Context continuation command or skill>
54
- ```
38
+ ```bash
39
+ context status --format json
40
+ ```
55
41
 
56
- The continuation entry first runs `context status`, then follows CLI diagnostics. It
57
- executes safe mechanical `next:` steps instead of only reporting them, and stops
58
- at `Human gate:` / placeholder next steps, source registration, source scope
59
- selection, review, package output choice, or source-repo operations that require
60
- user approval. It must not infer repo sources or extraction scope from the
61
- surrounding monorepo.
62
- It uses lower-level CLI primitives only when the workspace state requires them:
42
+ `workflow.current` is the current-step authority. The Agent reads every required
43
+ resource marked `read_state: read-required`, executes only returned commands,
44
+ preserves revision and authority flags, and reevaluates status after each
45
+ action. Current-conversation read receipts may be passed back through
46
+ `context status --resource-receipts @<file>` so unchanged resources are marked
47
+ `current`. A dynamic materialization becomes a receipt only after the Agent
48
+ reads the complete returned file. `context.source-body/*` resources are source
49
+ text; source indexes and heading metadata never replace the body. Long procedures and semantic
50
+ judgment rules are published in the Context workflow bundle and loaded only
51
+ when the current route or operation selects them.
63
52
 
64
- - `context source ...`
65
- - `context run ...`
66
- - `context review ...`
67
- - `context close`
68
- - `context build`
69
- - `context verify`
53
+ Gate inspection and resolution Actions keep their own Skill and Schema
54
+ locators. The Agent loads those conditional resources only when it enters that
55
+ phase; they are not preloaded with the Route's ordinary required resources.
70
56
 
71
- When the user explicitly requests fully managed operation in the current
72
- conversation, continuation uses `context status --managed --format json` and
73
- follows its managed commands. Eligible classification, extraction-scope,
74
- structure-confirmation, Review, and package-output gates proceed automatically;
75
- source boundaries, unread source permission, external operations, and
76
- validation failures remain gated. No managed policy is written to the project,
77
- and a new conversation returns to ordinary gates.
57
+ The two entry documents are also the source for hosts that expose Agent Skills
58
+ instead of commands. There are no stage-specific skills: source, alignment,
59
+ compile, review, and package guidance comes from the route-selected workflow
60
+ resources.
78
61
 
79
- ## SDK Manual For Agents
62
+ ## Human gates and managed sessions
80
63
 
81
- After `bun install`, the project has a local SDK manual under:
64
+ Ordinary mode preserves source, read-permission, scope, structure, Review, and
65
+ package decisions as explicit gates. Fully managed mode is available only when
66
+ the user explicitly requests it in the current conversation:
82
67
 
83
- ```text
84
- node_modules/@c4a/context/docs/
68
+ ```bash
69
+ context status --managed --format json
85
70
  ```
86
71
 
87
- Recommended files:
88
-
89
- - `node_modules/@c4a/context/docs/guides/agent-dialogue.md`
90
- - `node_modules/@c4a/context/docs/guides/agent-guide.md`
91
- - `node_modules/@c4a/context/docs/reference/project-api.md`
92
- - `node_modules/@c4a/context/docs/reference/package-templates.md`
72
+ That session authority is not stored. It cannot choose source boundaries,
73
+ authorize unread external content, perform external repository operations, or
74
+ bypass validation and verification.
93
75
 
94
- Template examples are installed at:
76
+ After the initial managed status, consecutive deterministic routes can be
77
+ collapsed with:
95
78
 
96
- ```text
97
- node_modules/@c4a/context/templates/package-templates/
79
+ ```bash
80
+ context run --managed --until blocked-or-complete --format json
98
81
  ```
99
82
 
100
- Agents should read these files instead of probing `node_modules/@c4a/context/dist`
101
- with ad-hoc scripts.
102
-
103
- ## Workspace Shape
104
-
105
- Committed project state lives in:
106
-
107
- - `src/` — project flow and custom code;
108
- - `sources/repo/index.yaml`, `sources/file/index.yaml`, and
109
- `sources/lark/index.yaml` — source registries;
110
- - `unapproved/entities.jsonl` — draft/rejected/deprecated metadata;
111
- - `unapproved/structure.yaml` — unconfirmed or confirmed prose structure draft;
112
- - `knowledge/` — approved Markdown;
113
- - `knowledge/structure.yaml` — closed structure/edge projection derived from
114
- approved knowledge;
115
- - `dist/` — built packages;
116
- - `README.md`, `AGENTS.md`, `package.json`.
117
-
118
- Runtime scratch lives in `.tmp/context-runtime/` and is ignored.
119
-
120
- ## Agent Entry Points
121
-
122
- The global plugin exposes only the user-facing Context commands for the current workspace:
83
+ The loop stops before any route that needs Agent interpretation, configuration,
84
+ additional authority, or diagnostic repair, and returns the current workflow
85
+ route for normal progressive loading.
123
86
 
124
- - `init`
125
- - `continue`
87
+ ## Workspace and SDK
126
88
 
127
- The CLI still provides lower-level primitives, but they are not public slash
128
- commands. The continuation entry chooses them based on CLI output and user intent.
89
+ Run the plugin from the initialized Context project root. Project declarations
90
+ live in `src/index.ts`; source state, draft state, approved knowledge, generated
91
+ packages, and disposable runtime state remain owned by Context CLI.
129
92
 
130
- Current source registration, document capture discipline, structure planning,
131
- node classification, reading density, candidate resolution, edge gates,
132
- source-bound section drafting, refresh/update judgment, semantic conflict
133
- judgment, and close guidance live in internal procedures under
134
- `skill-source-scope`, `skill-prose-align`, and `skill-prose-compile`.
93
+ After workspace dependency installation, the SDK manual starts at:
135
94
 
136
- Package-time querying is generated into each built package as the
137
- `knowledge-query` skill. Package output decisions live in `skill-package-output`.
138
- The current workflow does not expose source deletion, purge, or retraction
139
- commands. If a user asks for that kind of lifecycle change, stop and explain
140
- that the current plugin has no approved gate for it; do not recreate
141
- file-mutating operations outside the current workflow.
142
-
143
- Agents should follow the current status route and internal procedures. Do not
144
- call or reconstruct command shapes or payload protocols that are absent from the
145
- current CLI/schema views.
146
-
147
- The CLI performs mechanical work only. It does not clone, checkout, reset, fetch, or call an LLM silently. When source repos are missing or at the wrong commit, it reports diagnostics and expects the agent to ask the user before running external repo operations.
148
-
149
- ## Current Workflow Surface
150
-
151
- This plugin exposes the current workflow through `init` and `continue`.
152
- `continue` starts from `context status`, follows the status route, and delegates
153
- to current source/capture phases, prose align evidence views, source-bound prose
154
- compile, review, close, verify/build/status guidance, OKF indexes, generated
155
- knowledge-query skills, and declared project phase previews.
95
+ ```text
96
+ node_modules/@c4a/context/docs/README.md
97
+ ```
156
98
 
157
- Agents must not simulate lifecycle or retraction work by deleting workspace
158
- files. Source deletion, purge, and retraction are not current plugin operations.
99
+ The plugin does not expose source deletion, purge, or retraction. It also does
100
+ not silently clone, fetch, checkout, install, build, test, or call an LLM.
@@ -4,139 +4,88 @@
4
4
 
5
5
  <p align="center"><img src="./assets/logo.svg" alt="C4A Context" width="180"/></p>
6
6
 
7
- Context 提供面向 Agent 的知识工作区命令。Plugin 安装到全局 Agent 环境;每个知识工作区只保存自己的源声明、待审状态、已批准知识和构建产物。公开入口刻意收口:初始化一次,之后通过 next-step guidance 推进。
8
-
9
- Agent 与用户对话时应使用当前对话语言;CLI 命令、参数、id、状态枚举、JSONL key 和 `source_ref` 属于协议文本,保持英文或原样。
7
+ Context 为项目内知识工作区提供轻量 Agent 入口。Plugin 不会把完整工作流塞进
8
+ 一份提示词,而是先观察当前工作区事实,再由 Context CLI 选择当前步骤允许的
9
+ 路线、命令、门禁以及 Markdown/schema 资源。
10
10
 
11
11
  ## 安装
12
12
 
13
- 先安装 CLI:
14
-
15
13
  ```bash
16
14
  npm i -g @c4a/context-cli
17
- # 或
18
- bun add -g @c4a/context-cli
19
- ```
20
-
21
- 再把随 CLI 包发布的 plugin marketplace 安装到全局:
22
-
23
- ```bash
24
15
  context plugin install
25
16
  ```
26
17
 
27
- 安装器会从当前 CLI 包动态解析 marketplace 目录。发布包使用 `dist/plugins`;源码 checkout 在执行 `bun run --filter @c4a/context-cli build` 后也使用同样的生成目录。对 Codex,安装器会把随包生成的插件复制到 `~/.codex/plugins/cache/c4a/context/local/`,符合 Codex 本地插件的 cache 约定。
28
-
29
- 只查看将执行的操作:
18
+ 源码开发模式需要先构建:
30
19
 
31
20
  ```bash
32
- context plugin install --dry-run
33
- context plugin path
21
+ bun run --filter @c4a/context-cli build
22
+ context plugin install --dev
34
23
  ```
35
24
 
36
- ## 工作流
25
+ 可用 `context plugin install --dry-run` 查看安装动作,用
26
+ `context plugin path` 定位随 CLI 发布的 marketplace。
37
27
 
38
- context 项目根目录执行命令。
28
+ ## Agent 入口
39
29
 
40
- 1. 初始化工作区:
30
+ 公开入口保持精简:
41
31
 
42
- ```bash
43
- context init context
44
- cd context
45
- bun install
46
- ```
32
+ - `init`:创建 Context 工作区;
33
+ - `continue`:观察并推进已有工作区。
47
34
 
48
- 2. 通过已安装的 Agent 入口继续推进:
35
+ Continuation 从以下命令开始:
49
36
 
50
- ```bash
51
- <当前宿主暴露的 Context continuation command 或 skill>
52
- ```
37
+ ```bash
38
+ context status --format json
39
+ ```
53
40
 
54
- Continuation 入口会先运行 `context status`,然后跟随 CLI 诊断。安全的机械 `next:` 步骤会直接执行,不会只把命令复述给用户;遇到 `Human gate:`、带占位符的 next、source 注册、source 范围选择、审阅、package 输出选择或需要用户授权的 source repo 操作才会停下来确认。它不能根据周边 monorepo 自行推断 repo source 或提取范围,只在工作区状态需要时调用底层 CLI 能力:
41
+ `workflow.current` 是当前步骤的权威协议。Agent 读取所有标记为
42
+ `read_state: read-required` 的 required 资源,只执行返回的命令,完整保留
43
+ revision 与 authority 参数,并在每次动作后重新求值。当前会话可通过
44
+ `context status --resource-receipts @<file>` 回传读取回执,使未变化资源标记为
45
+ `current`。动态资源的 materialize 结果只有在 Agent 完整读取返回文件后才可作为
46
+ 回执;`context.source-body/*` 是必须阅读的正文,source-index 和标题元数据不能
47
+ 替代正文。
48
+ 长篇流程与语义判断规则发布在 Context workflow bundle 中,仅在当前路线或操作
49
+ 选中时加载。
55
50
 
56
- - `context source ...`
57
- - `context run ...`
58
- - `context review ...`
59
- - `context close`
60
- - `context build`
61
- - `context verify`
51
+ Gate 的检查动作与决议动作分别保留自己的 Skill 和 Schema 位置。Agent 只在进入
52
+ 相应阶段时加载这些条件资源,不会把它们提前混入 Route 的普通 required 资源。
62
53
 
63
- 如果用户在当前对话明确要求“全托管”,Continuation 会改用 `context status
64
- --managed --format json` 并持续跟随其命令。分类、提取范围、结构确认、审阅和
65
- package 输出门禁可自动完成;来源边界、尚未授权的文档读取、外部仓库/系统操作和
66
- 校验失败仍会停下。该授权不会写入 `defineProject` 或工作区,新对话默认恢复普通
67
- 人工门禁。
54
+ 这两个入口文档也用于生成仅支持 Agent Skills 的宿主入口。不再发布阶段型
55
+ Skill;来源、对齐、编译、审核和构建说明均由当前路线选择的 workflow resources
56
+ 动态提供。
68
57
 
69
- ## Agent 可读的 SDK 手册
58
+ ## 人工门禁与全托管会话
70
59
 
71
- 执行 `bun install` 后,项目内会有 SDK 手册:
60
+ 普通模式保留来源、读取权限、提取范围、结构、审阅和包形态等显式门禁。只有用户
61
+ 在当前对话明确要求全托管时,才使用:
72
62
 
73
- ```text
74
- node_modules/@c4a/context/docs/
63
+ ```bash
64
+ context status --managed --format json
75
65
  ```
76
66
 
77
- 推荐先读:
78
-
79
- - `node_modules/@c4a/context/docs/guides/agent-dialogue.md`
80
- - `node_modules/@c4a/context/docs/guides/agent-guide.md`
81
- - `node_modules/@c4a/context/docs/reference/project-api.md`
82
- - `node_modules/@c4a/context/docs/reference/package-templates.md`
67
+ 该会话权限不会持久化,也不能选择来源边界、授权尚未允许读取的外部内容、执行
68
+ 外部仓库操作,或绕过校验与验证。
83
69
 
84
- 模板示例在:
70
+ 首次读取托管状态后,可用下面的命令合并连续的确定性步骤:
85
71
 
86
- ```text
87
- node_modules/@c4a/context/templates/package-templates/
72
+ ```bash
73
+ context run --managed --until blocked-or-complete --format json
88
74
  ```
89
75
 
90
- Agent 应读取这些文件,不要通过临时脚本反查 `node_modules/@c4a/context/dist`
91
- 来猜 SDK API。
92
-
93
- ## 工作区形态
94
-
95
- 需要提交的项目状态在:
96
-
97
- - `src/`:项目流程和定制代码;
98
- - `sources/repo/index.yaml`、`sources/file/index.yaml`、`sources/lark/index.yaml`:源 registry;
99
- - `unapproved/entities.jsonl`:draft/rejected/deprecated 元信息;
100
- - `unapproved/structure.yaml`:未确认或已确认的文档结构草稿;
101
- - `knowledge/`:approved Markdown;
102
- - `knowledge/structure.yaml`:由 approved knowledge 派生的结构与关系投影;
103
- - `dist/`:构建产物;
104
- - `README.md`、`AGENTS.md`、`package.json`。
105
-
106
- 运行缓存放在 `.tmp/context-runtime/`,并被忽略。
107
-
108
- ## Agent 入口
109
-
110
- 全局 plugin 只暴露面向用户的 Context 命令:
111
-
112
- - `init`
113
- - `continue`
114
-
115
- CLI 仍保留底层能力,但它们不是公开 slash command。Continuation 入口根据 CLI 输出和用户意图选择要调用的底层命令。
116
-
117
- 当前 source 注册、文档 capture 纪律、structure planning、Node 分类、阅读密度、
118
- 候选处理、edge gates、source-bound section drafting、refresh/update 判断、
119
- 语义冲突判断和 close 指引都在 `skill-source-scope`、`skill-prose-align`、
120
- `skill-prose-compile` 下面的内部 procedure。
76
+ 遇到需要 Agent 判断、配置修改、额外权限、诊断修复或多条命令的路线时,循环会
77
+ 立即停止,并返回当前 `workflow.current` 供 Agent 按需加载上下文。
121
78
 
122
- 包内查询能力在构建包时生成到 `knowledge-query` skill。package 输出决策在
123
- `skill-package-output`。当前工作流不暴露 source 删除、purge 或撤回命令。
124
- 如果用户要求这类生命周期变更,先停下来说明当前 plugin 没有已批准门禁;
125
- Agent 不得在当前工作流之外重建文件变更类操作。
79
+ ## 工作区与 SDK
126
80
 
127
- Agent 应按当前 status route 和内部 procedure 推进。不要调用或重建当前
128
- CLI/schema views 没有暴露的命令形态或 payload 协议。
81
+ Plugin 应在初始化后的 Context 项目根目录运行。`src/index.ts` 保存项目声明;
82
+ 来源状态、草稿状态、已批准知识、构建产物和临时运行状态均由 Context CLI 管理。
129
83
 
130
- CLI 只做机械操作。它不会静默 clone、checkout、reset、fetch,也不会调用 LLM。源仓库缺失或 commit 不匹配时,CLI 只返回诊断;Agent 需要先征询用户,再决定是否执行外部 repo 操作。
84
+ 安装工作区依赖后,SDK 手册入口为:
131
85
 
132
- ## 当前工作流入口
133
-
134
- 本 plugin 只暴露当前工作流入口: `init` 和 `continue`。`continue` 从
135
- `context status` 开始,按 status route 分发到 source/capture phase、prose
136
- align evidence views、source-bound prose compile、review、close、
137
- verify/build/status guidance、OKF indexes、生成包里的 knowledge-query skill,
138
- 以及已声明 project phase 的只读预览。
86
+ ```text
87
+ node_modules/@c4a/context/docs/README.md
88
+ ```
139
89
 
140
- Agent 不得通过直接删除 `sources/`、`knowledge/`、`unapproved/`、`dist/`
141
- `.tmp` 来模拟生命周期或撤回操作。source 删除、purge 和撤回不是当前
142
- plugin 操作。
90
+ 当前 Plugin 不暴露 source 删除、purge 或 retraction,也不会静默执行 clone、
91
+ fetch、checkout、install、build、test 或调用 LLM。
package/plugins/VERSION CHANGED
@@ -1 +1 @@
1
- 0.6.1
1
+ 0.6.3