@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.
- package/README.md +77 -12
- package/README.zh-CN.md +202 -0
- package/cli.js +74066 -45247
- package/docs/context-debug-event-v1.schema.json +29 -0
- package/docs/context-debug-replay-v1.schema.json +33 -0
- package/docs/debug-tracing.md +86 -0
- package/docs/quickstart.md +23 -5
- package/package.json +8 -3
- package/plugins/README.md +60 -118
- package/plugins/README_CN.md +51 -102
- package/plugins/VERSION +1 -1
- package/plugins/claude/.claude-plugin/plugin.json +1 -1
- package/plugins/claude/commands/continue.md +61 -10
- package/plugins/claude/commands/init.md +26 -11
- package/plugins/codex/.codex-plugin/plugin.json +2 -2
- package/plugins/codex/skills/continue/SKILL.md +61 -11
- package/plugins/codex/skills/init/SKILL.md +28 -14
- package/plugins/cursor/.cursor-plugin/plugin.json +2 -3
- package/plugins/cursor/README.md +2 -2
- package/plugins/cursor/commands/context-continue.md +61 -10
- package/plugins/cursor/commands/context-init.md +26 -11
- package/plugins/skills/context-continue/SKILL.md +61 -11
- package/plugins/skills/context-init/SKILL.md +28 -14
- package/providers/context/actions/accept-package-templates.yaml +5 -0
- package/providers/context/actions/align-next.yaml +6 -0
- package/providers/context/actions/apply-managed-review.yaml +5 -0
- package/providers/context/actions/apply-structure-confirmation.yaml +5 -0
- package/providers/context/actions/build-next.yaml +5 -0
- package/providers/context/actions/capture-next.yaml +5 -0
- package/providers/context/actions/close-approved-knowledge.yaml +5 -0
- package/providers/context/actions/compile-next.yaml +5 -0
- package/providers/context/actions/configure-code-extraction.yaml +5 -0
- package/providers/context/actions/configure-document-capture.yaml +5 -0
- package/providers/context/actions/configure-package-output.yaml +5 -0
- package/providers/context/actions/configure-prose-lifecycle.yaml +5 -0
- package/providers/context/actions/extract-next.yaml +5 -0
- package/providers/context/actions/inspect-document-classification.yaml +5 -0
- package/providers/context/actions/inspect-repository-recovery.yaml +6 -0
- package/providers/context/actions/inspect-review.yaml +5 -0
- package/providers/context/actions/inspect-structure.yaml +5 -0
- package/providers/context/actions/maintain-evidence.yaml +6 -0
- package/providers/context/actions/materialize-context-view.yaml +8 -0
- package/providers/context/actions/reconcile-review-identities.yaml +5 -0
- package/providers/context/actions/register-source-batch.yaml +7 -0
- package/providers/context/actions/repair-project-entry.yaml +5 -0
- package/providers/context/actions/repair-verification.yaml +5 -0
- package/providers/context/actions/repair-workspace-state.yaml +5 -0
- package/providers/context/actions/restore-repository-sources.yaml +7 -0
- package/providers/context/codes.yaml +41 -0
- package/providers/context/graphs/workspace.yaml +536 -0
- package/providers/context/manifest.json +700 -0
- package/providers/context/provider.yaml +12 -0
- package/providers/context/resources/diagnostics/projection-stale.md +13 -0
- package/providers/context/resources/diagnostics/verification.md +21 -0
- package/providers/context/resources/diagnostics/workspace-state.md +27 -0
- package/providers/context/resources/dialogue/code-extraction.md +34 -0
- package/providers/context/resources/dialogue/document-capture.md +29 -0
- package/providers/context/resources/dialogue/document-classification.md +33 -0
- package/providers/context/resources/dialogue/evidence-maintenance.md +26 -0
- package/providers/context/resources/dialogue/human-gates.md +34 -0
- package/providers/context/resources/dialogue/knowledge-review.md +27 -0
- package/providers/context/resources/dialogue/package-output.md +30 -0
- package/providers/context/resources/dialogue/repository-source-recovery.md +23 -0
- package/providers/context/resources/dialogue/source-boundary.md +29 -0
- package/providers/context/resources/dialogue/structure-confirmation.md +44 -0
- package/providers/context/resources/manuals/guides/lark-resources.md +121 -0
- package/providers/context/resources/manuals/guides/package-outputs.md +267 -0
- package/providers/context/resources/manuals/reference/package-templates.md +378 -0
- package/providers/context/resources/manuals/reference/project-api.md +825 -0
- package/providers/context/resources/manuals/reference/template-variables.md +248 -0
- package/providers/context/resources/procedures/close-and-build.md +23 -0
- package/providers/context/resources/procedures/code-extraction.md +50 -0
- package/providers/context/resources/procedures/document-capture.md +49 -0
- package/providers/context/resources/procedures/document-classification.md +22 -0
- package/providers/context/resources/procedures/evidence-maintenance.md +20 -0
- package/providers/context/resources/procedures/knowledge-review.md +34 -0
- package/providers/context/resources/procedures/package-output.md +37 -0
- package/providers/context/resources/procedures/project-configuration.md +21 -0
- package/providers/context/resources/procedures/prose-align.md +68 -0
- package/providers/context/resources/procedures/prose-compile.md +23 -0
- package/providers/context/resources/procedures/repository-source-recovery.md +43 -0
- package/providers/context/resources/procedures/source-boundary.md +48 -0
- 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
- package/providers/context/resources/procedures/verify-and-repair.md +31 -0
- package/{plugins/claude/skills/skill-prose-align/references/internal-procedures/structure-planning/references → providers/context/resources/semantic/align}/candidate-resolution.md +17 -2
- package/{plugins/claude/skills/skill-prose-align/references/internal-procedures/structure-planning/references → providers/context/resources/semantic/align}/density-profile.md +11 -0
- 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
- package/{plugins/cursor/skills/skill-prose-align/references/internal-procedures → providers/context/resources/semantic/align}/structure-planning.md +62 -12
- package/providers/context/resources/semantic/compile/index.md +31 -0
- package/providers/context/resources/views/package-current.yaml +6 -0
- package/providers/context/resources/views/review-current.yaml +6 -0
- package/providers/context/resources/views/source-boundary.yaml +6 -0
- package/providers/context/resources/views/source-current.yaml +6 -0
- package/providers/context/resources/views/structure-current.yaml +6 -0
- package/providers/context/resources/views/verification-current.yaml +6 -0
- package/providers/context/resources/views/workspace-current.yaml +6 -0
- package/providers/context/schemas/evidence-maintenance-input.schema.json +30 -0
- package/providers/context/schemas/prose-structure-batch.schema.json +35 -0
- package/providers/context/schemas/repository-source-recovery.schema.json +40 -0
- package/providers/context/schemas/source-batch-input.schema.json +189 -0
- package/providers/context/scripts/render-context-view.mjs +21 -0
- package/plugins/claude/skills/skill-continue-workflow/SKILL.md +0 -235
- package/plugins/claude/skills/skill-init-workspace/SKILL.md +0 -74
- package/plugins/claude/skills/skill-package-output/SKILL.md +0 -180
- package/plugins/claude/skills/skill-prose-align/SKILL.md +0 -322
- package/plugins/claude/skills/skill-prose-align/references/internal-procedures/structure-planning/references/gates.md +0 -263
- package/plugins/claude/skills/skill-prose-align/references/internal-procedures/structure-planning.md +0 -282
- package/plugins/claude/skills/skill-prose-compile/SKILL.md +0 -287
- package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/close-gate.md +0 -132
- package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/compile-actions/references/action-domain-gates.md +0 -52
- package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/compile-actions/references/notes.md +0 -48
- package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/compile-actions/references/refresh-and-update.md +0 -85
- package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/compile-actions/references/structural-challenges.md +0 -73
- package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/compile-actions.md +0 -413
- package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/compile-judgment.md +0 -123
- package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/semantic-judgment/references/disposition-semantics.md +0 -81
- package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/semantic-judgment/references/leakage-and-ownership.md +0 -55
- package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/semantic-judgment/references/scope-review-and-omit.md +0 -93
- package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/semantic-judgment/references/temporal-and-evidence.md +0 -79
- package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/semantic-judgment/references/user-confirmation.md +0 -111
- package/plugins/claude/skills/skill-prose-compile/references/internal-procedures/semantic-judgment.md +0 -194
- package/plugins/claude/skills/skill-review-gate/SKILL.md +0 -138
- package/plugins/claude/skills/skill-source-scope/SKILL.md +0 -525
- package/plugins/claude/skills/skill-source-scope/references/capture-source.md +0 -201
- package/plugins/codex/skills/continue/references/internal-procedures/skill-continue-workflow.md +0 -235
- package/plugins/codex/skills/continue/references/internal-procedures/skill-init-workspace.md +0 -74
- package/plugins/codex/skills/continue/references/internal-procedures/skill-package-output.md +0 -180
- package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/candidate-resolution.md +0 -91
- package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/density-profile.md +0 -30
- package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/gates.md +0 -263
- package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning.md +0 -282
- package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-align.md +0 -322
- package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/close-gate.md +0 -132
- package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/action-domain-gates.md +0 -52
- package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/notes.md +0 -48
- package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/refresh-and-update.md +0 -85
- package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/structural-challenges.md +0 -73
- package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions.md +0 -413
- package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-judgment.md +0 -123
- package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/disposition-semantics.md +0 -81
- package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/leakage-and-ownership.md +0 -55
- package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/scope-review-and-omit.md +0 -93
- package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/temporal-and-evidence.md +0 -79
- package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/user-confirmation.md +0 -111
- package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment.md +0 -194
- package/plugins/codex/skills/continue/references/internal-procedures/skill-prose-compile.md +0 -287
- package/plugins/codex/skills/continue/references/internal-procedures/skill-review-gate.md +0 -138
- package/plugins/codex/skills/continue/references/internal-procedures/skill-source-scope.md +0 -525
- package/plugins/codex/skills/init/references/internal-procedures/skill-continue-workflow.md +0 -235
- package/plugins/codex/skills/init/references/internal-procedures/skill-init-workspace.md +0 -74
- package/plugins/codex/skills/init/references/internal-procedures/skill-package-output.md +0 -180
- package/plugins/codex/skills/init/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/candidate-resolution.md +0 -91
- package/plugins/codex/skills/init/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/density-profile.md +0 -30
- package/plugins/codex/skills/init/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning.md +0 -282
- package/plugins/codex/skills/init/references/internal-procedures/skill-prose-align.md +0 -322
- package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/close-gate.md +0 -132
- package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/action-domain-gates.md +0 -52
- package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/notes.md +0 -48
- package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/refresh-and-update.md +0 -85
- package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/structural-challenges.md +0 -73
- package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions.md +0 -413
- package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-judgment.md +0 -123
- package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/disposition-semantics.md +0 -81
- package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/leakage-and-ownership.md +0 -55
- package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/scope-review-and-omit.md +0 -93
- package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/temporal-and-evidence.md +0 -79
- package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/user-confirmation.md +0 -111
- package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment.md +0 -194
- package/plugins/codex/skills/init/references/internal-procedures/skill-prose-compile.md +0 -287
- package/plugins/codex/skills/init/references/internal-procedures/skill-review-gate.md +0 -138
- package/plugins/codex/skills/init/references/internal-procedures/skill-source-scope/references/capture-source.md +0 -201
- package/plugins/codex/skills/init/references/internal-procedures/skill-source-scope.md +0 -525
- package/plugins/cursor/skills/skill-continue-workflow/SKILL.md +0 -235
- package/plugins/cursor/skills/skill-init-workspace/SKILL.md +0 -74
- package/plugins/cursor/skills/skill-package-output/SKILL.md +0 -180
- package/plugins/cursor/skills/skill-prose-align/SKILL.md +0 -322
- package/plugins/cursor/skills/skill-prose-align/references/internal-procedures/structure-planning/references/candidate-resolution.md +0 -91
- package/plugins/cursor/skills/skill-prose-align/references/internal-procedures/structure-planning/references/density-profile.md +0 -30
- package/plugins/cursor/skills/skill-prose-align/references/internal-procedures/structure-planning/references/gates.md +0 -263
- package/plugins/cursor/skills/skill-prose-compile/SKILL.md +0 -287
- package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/close-gate.md +0 -132
- package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/compile-actions/references/action-domain-gates.md +0 -52
- package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/compile-actions/references/notes.md +0 -48
- package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/compile-actions/references/refresh-and-update.md +0 -85
- package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/compile-actions/references/structural-challenges.md +0 -73
- package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/compile-actions.md +0 -413
- package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/compile-judgment.md +0 -123
- package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/semantic-judgment/references/disposition-semantics.md +0 -81
- package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/semantic-judgment/references/leakage-and-ownership.md +0 -55
- package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/semantic-judgment/references/scope-review-and-omit.md +0 -93
- package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/semantic-judgment/references/temporal-and-evidence.md +0 -79
- package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/semantic-judgment/references/user-confirmation.md +0 -111
- package/plugins/cursor/skills/skill-prose-compile/references/internal-procedures/semantic-judgment.md +0 -194
- package/plugins/cursor/skills/skill-review-gate/SKILL.md +0 -138
- package/plugins/cursor/skills/skill-source-scope/SKILL.md +0 -525
- package/plugins/cursor/skills/skill-source-scope/references/capture-source.md +0 -201
- package/plugins/skills/context-continue/references/internal-procedures/skill-continue-workflow.md +0 -235
- package/plugins/skills/context-continue/references/internal-procedures/skill-init-workspace.md +0 -74
- package/plugins/skills/context-continue/references/internal-procedures/skill-package-output.md +0 -180
- package/plugins/skills/context-continue/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/candidate-resolution.md +0 -91
- package/plugins/skills/context-continue/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/density-profile.md +0 -30
- package/plugins/skills/context-continue/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/gates.md +0 -263
- package/plugins/skills/context-continue/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning.md +0 -282
- package/plugins/skills/context-continue/references/internal-procedures/skill-prose-align.md +0 -322
- package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/close-gate.md +0 -132
- package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/action-domain-gates.md +0 -52
- package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/notes.md +0 -48
- package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/refresh-and-update.md +0 -85
- package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/structural-challenges.md +0 -73
- package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions.md +0 -413
- package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-judgment.md +0 -123
- package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/disposition-semantics.md +0 -81
- package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/leakage-and-ownership.md +0 -55
- package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/scope-review-and-omit.md +0 -93
- package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/temporal-and-evidence.md +0 -79
- package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/user-confirmation.md +0 -111
- package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment.md +0 -194
- package/plugins/skills/context-continue/references/internal-procedures/skill-prose-compile.md +0 -287
- package/plugins/skills/context-continue/references/internal-procedures/skill-review-gate.md +0 -138
- package/plugins/skills/context-continue/references/internal-procedures/skill-source-scope/references/capture-source.md +0 -201
- package/plugins/skills/context-continue/references/internal-procedures/skill-source-scope.md +0 -525
- package/plugins/skills/context-init/references/internal-procedures/skill-continue-workflow.md +0 -235
- package/plugins/skills/context-init/references/internal-procedures/skill-init-workspace.md +0 -74
- package/plugins/skills/context-init/references/internal-procedures/skill-package-output.md +0 -180
- package/plugins/skills/context-init/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/candidate-resolution.md +0 -91
- package/plugins/skills/context-init/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/density-profile.md +0 -30
- package/plugins/skills/context-init/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning/references/gates.md +0 -263
- package/plugins/skills/context-init/references/internal-procedures/skill-prose-align/references/internal-procedures/structure-planning.md +0 -282
- package/plugins/skills/context-init/references/internal-procedures/skill-prose-align.md +0 -322
- package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/close-gate.md +0 -132
- package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/action-domain-gates.md +0 -52
- package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/notes.md +0 -48
- package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/refresh-and-update.md +0 -85
- package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions/references/structural-challenges.md +0 -73
- package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-actions.md +0 -413
- package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/compile-judgment.md +0 -123
- package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/disposition-semantics.md +0 -81
- package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/leakage-and-ownership.md +0 -55
- package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/scope-review-and-omit.md +0 -93
- package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/temporal-and-evidence.md +0 -79
- package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment/references/user-confirmation.md +0 -111
- package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile/references/internal-procedures/semantic-judgment.md +0 -194
- package/plugins/skills/context-init/references/internal-procedures/skill-prose-compile.md +0 -287
- package/plugins/skills/context-init/references/internal-procedures/skill-review-gate.md +0 -138
- package/plugins/skills/context-init/references/internal-procedures/skill-source-scope/references/capture-source.md +0 -201
- 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.
|
package/docs/quickstart.md
CHANGED
|
@@ -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,
|
|
48
|
-
|
|
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.
|
|
59
|
-
|
|
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.
|
|
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/
|
|
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
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
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
|
-
|
|
30
|
-
|
|
31
|
-
For a dry run:
|
|
19
|
+
For a source checkout, build the CLI and plugin first:
|
|
32
20
|
|
|
33
21
|
```bash
|
|
34
|
-
|
|
35
|
-
context plugin
|
|
22
|
+
bun run --filter @c4a/context-cli build
|
|
23
|
+
context plugin install --dev
|
|
36
24
|
```
|
|
37
25
|
|
|
38
|
-
|
|
26
|
+
Use `context plugin install --dry-run` to inspect installation and
|
|
27
|
+
`context plugin path` to locate the bundled marketplace.
|
|
39
28
|
|
|
40
|
-
|
|
29
|
+
## Agent entry
|
|
41
30
|
|
|
42
|
-
|
|
31
|
+
The public host surface stays small:
|
|
43
32
|
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
cd context
|
|
47
|
-
bun install
|
|
48
|
-
```
|
|
33
|
+
- `init` creates a Context workspace;
|
|
34
|
+
- `continue` observes and advances an existing workspace.
|
|
49
35
|
|
|
50
|
-
|
|
36
|
+
Continuation starts with:
|
|
51
37
|
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
38
|
+
```bash
|
|
39
|
+
context status --format json
|
|
40
|
+
```
|
|
55
41
|
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
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
|
-
|
|
65
|
-
|
|
66
|
-
|
|
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
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
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
|
-
##
|
|
62
|
+
## Human gates and managed sessions
|
|
80
63
|
|
|
81
|
-
|
|
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
|
-
```
|
|
84
|
-
|
|
68
|
+
```bash
|
|
69
|
+
context status --managed --format json
|
|
85
70
|
```
|
|
86
71
|
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
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
|
-
|
|
76
|
+
After the initial managed status, consecutive deterministic routes can be
|
|
77
|
+
collapsed with:
|
|
95
78
|
|
|
96
|
-
```
|
|
97
|
-
|
|
79
|
+
```bash
|
|
80
|
+
context run --managed --until blocked-or-complete --format json
|
|
98
81
|
```
|
|
99
82
|
|
|
100
|
-
|
|
101
|
-
|
|
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
|
-
|
|
125
|
-
- `continue`
|
|
87
|
+
## Workspace and SDK
|
|
126
88
|
|
|
127
|
-
|
|
128
|
-
|
|
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
|
-
|
|
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
|
-
|
|
137
|
-
|
|
138
|
-
|
|
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
|
-
|
|
158
|
-
|
|
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.
|
package/plugins/README_CN.md
CHANGED
|
@@ -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
|
|
8
|
-
|
|
9
|
-
|
|
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
|
-
|
|
28
|
-
|
|
29
|
-
只查看将执行的操作:
|
|
18
|
+
源码开发模式需要先构建:
|
|
30
19
|
|
|
31
20
|
```bash
|
|
32
|
-
|
|
33
|
-
context plugin
|
|
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
|
-
|
|
28
|
+
## Agent 入口
|
|
39
29
|
|
|
40
|
-
|
|
30
|
+
公开入口保持精简:
|
|
41
31
|
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
cd context
|
|
45
|
-
bun install
|
|
46
|
-
```
|
|
32
|
+
- `init`:创建 Context 工作区;
|
|
33
|
+
- `continue`:观察并推进已有工作区。
|
|
47
34
|
|
|
48
|
-
|
|
35
|
+
Continuation 从以下命令开始:
|
|
49
36
|
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
37
|
+
```bash
|
|
38
|
+
context status --format json
|
|
39
|
+
```
|
|
53
40
|
|
|
54
|
-
|
|
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
|
-
|
|
57
|
-
|
|
58
|
-
- `context review ...`
|
|
59
|
-
- `context close`
|
|
60
|
-
- `context build`
|
|
61
|
-
- `context verify`
|
|
51
|
+
Gate 的检查动作与决议动作分别保留自己的 Skill 和 Schema 位置。Agent 只在进入
|
|
52
|
+
相应阶段时加载这些条件资源,不会把它们提前混入 Route 的普通 required 资源。
|
|
62
53
|
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
校验失败仍会停下。该授权不会写入 `defineProject` 或工作区,新对话默认恢复普通
|
|
67
|
-
人工门禁。
|
|
54
|
+
这两个入口文档也用于生成仅支持 Agent Skills 的宿主入口。不再发布阶段型
|
|
55
|
+
Skill;来源、对齐、编译、审核和构建说明均由当前路线选择的 workflow resources
|
|
56
|
+
动态提供。
|
|
68
57
|
|
|
69
|
-
##
|
|
58
|
+
## 人工门禁与全托管会话
|
|
70
59
|
|
|
71
|
-
|
|
60
|
+
普通模式保留来源、读取权限、提取范围、结构、审阅和包形态等显式门禁。只有用户
|
|
61
|
+
在当前对话明确要求全托管时,才使用:
|
|
72
62
|
|
|
73
|
-
```
|
|
74
|
-
|
|
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
|
-
```
|
|
87
|
-
|
|
72
|
+
```bash
|
|
73
|
+
context run --managed --until blocked-or-complete --format json
|
|
88
74
|
```
|
|
89
75
|
|
|
90
|
-
Agent
|
|
91
|
-
|
|
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
|
-
|
|
123
|
-
`skill-package-output`。当前工作流不暴露 source 删除、purge 或撤回命令。
|
|
124
|
-
如果用户要求这类生命周期变更,先停下来说明当前 plugin 没有已批准门禁;
|
|
125
|
-
Agent 不得在当前工作流之外重建文件变更类操作。
|
|
79
|
+
## 工作区与 SDK
|
|
126
80
|
|
|
127
|
-
|
|
128
|
-
|
|
81
|
+
Plugin 应在初始化后的 Context 项目根目录运行。`src/index.ts` 保存项目声明;
|
|
82
|
+
来源状态、草稿状态、已批准知识、构建产物和临时运行状态均由 Context CLI 管理。
|
|
129
83
|
|
|
130
|
-
|
|
84
|
+
安装工作区依赖后,SDK 手册入口为:
|
|
131
85
|
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
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
|
-
|
|
141
|
-
|
|
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
|
+
0.6.3
|