@voybio/ace-swarm 0.1.0
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/CHANGELOG.md +109 -0
- package/LICENSE +186 -0
- package/README.md +229 -0
- package/assets/.agents/ACE/ACE-Init/AGENTS.md +210 -0
- package/assets/.agents/ACE/ACE-Init/instructions.md +118 -0
- package/assets/.agents/ACE/ACE_coders/AGENTS.md +154 -0
- package/assets/.agents/ACE/ACE_coders/INSTRUCTIONS.md +216 -0
- package/assets/.agents/ACE/AGENT_REGISTRY.md +70 -0
- package/assets/.agents/ACE/AGENT_REGISTRY_7.md +9 -0
- package/assets/.agents/ACE/DIRECTIVE_KERNEL.md +234 -0
- package/assets/.agents/ACE/UI/AGENTS.md +115 -0
- package/assets/.agents/ACE/UI/instructions.md +178 -0
- package/assets/.agents/ACE/VOS/ACE_VOS_MISSING_INFO_MATRIX.md +42 -0
- package/assets/.agents/ACE/VOS/AGENTS.md +72 -0
- package/assets/.agents/ACE/VOS/instructions.md +211 -0
- package/assets/.agents/ACE/agent-astgrep/AGENTS.md +123 -0
- package/assets/.agents/ACE/agent-astgrep/instructions.md +91 -0
- package/assets/.agents/ACE/agent-builder/AGENTS.md +172 -0
- package/assets/.agents/ACE/agent-builder/instructions.md +137 -0
- package/assets/.agents/ACE/agent-docs/AGENTS.md +159 -0
- package/assets/.agents/ACE/agent-docs/instructions.md +133 -0
- package/assets/.agents/ACE/agent-eval/AGENTS.md +46 -0
- package/assets/.agents/ACE/agent-eval/instructions.md +56 -0
- package/assets/.agents/ACE/agent-memory/AGENTS.md +49 -0
- package/assets/.agents/ACE/agent-memory/instructions.md +50 -0
- package/assets/.agents/ACE/agent-observability/AGENTS.md +46 -0
- package/assets/.agents/ACE/agent-observability/instructions.md +50 -0
- package/assets/.agents/ACE/agent-ops/AGENTS.md +201 -0
- package/assets/.agents/ACE/agent-ops/instructions.md +136 -0
- package/assets/.agents/ACE/agent-qa/AGENTS.md +189 -0
- package/assets/.agents/ACE/agent-qa/instructions.md +121 -0
- package/assets/.agents/ACE/agent-release/AGENTS.md +48 -0
- package/assets/.agents/ACE/agent-release/instructions.md +49 -0
- package/assets/.agents/ACE/agent-research/AGENTS.md +160 -0
- package/assets/.agents/ACE/agent-research/instructions.md +118 -0
- package/assets/.agents/ACE/agent-security/AGENTS.md +48 -0
- package/assets/.agents/ACE/agent-security/instructions.md +50 -0
- package/assets/.agents/ACE/agent-skeptic/AGENTS.md +178 -0
- package/assets/.agents/ACE/agent-skeptic/instructions.md +196 -0
- package/assets/.agents/ACE/agent-spec/AGENTS.md +169 -0
- package/assets/.agents/ACE/agent-spec/instructions.md +116 -0
- package/assets/.agents/ACE/orchestrator/AGENTS.md +365 -0
- package/assets/.agents/ACE/orchestrator/instructions.md +231 -0
- package/assets/.agents/skills/ace-orchestrator/SKILL.md +63 -0
- package/assets/.agents/skills/ace-orchestrator/references/engineering-bootstrap-playbook.md +360 -0
- package/assets/.agents/skills/astgrep-index/SKILL.md +58 -0
- package/assets/.agents/skills/codemunch/SKILL.md +65 -0
- package/assets/.agents/skills/codemunch/references/ast-driven-protocol.md +543 -0
- package/assets/.agents/skills/codesnipe/SKILL.md +64 -0
- package/assets/.agents/skills/codesnipe/references/dual-codebase-playbook.md +671 -0
- package/assets/.agents/skills/eval-harness/SKILL.md +203 -0
- package/assets/.agents/skills/handoff-lint/SKILL.md +164 -0
- package/assets/.agents/skills/incident-commander/SKILL.md +174 -0
- package/assets/.agents/skills/landing-review-watcher/SKILL.md +68 -0
- package/assets/.agents/skills/memory-curator/SKILL.md +179 -0
- package/assets/.agents/skills/problem-triage/SKILL.md +57 -0
- package/assets/.agents/skills/problem-triage/agents/openai.yaml +3 -0
- package/assets/.agents/skills/release-sentry/SKILL.md +189 -0
- package/assets/.agents/skills/risk-quant/SKILL.md +190 -0
- package/assets/.agents/skills/schema-forge/SKILL.md +174 -0
- package/assets/.agents/skills/skill-auditor/SKILL.md +52 -0
- package/assets/.agents/skills/state-auditor/SKILL.md +182 -0
- package/assets/.github/hooks/ace-copilot.json +68 -0
- package/assets/agent-state/ACE_WORKFLOW.md +131 -0
- package/assets/agent-state/ARTIFACT_MANIFEST.json +5 -0
- package/assets/agent-state/AST_GREP_COMMANDS.md +121 -0
- package/assets/agent-state/AST_GREP_INDEX.json +13 -0
- package/assets/agent-state/AST_GREP_INDEX.md +15 -0
- package/assets/agent-state/DECISIONS.md +7 -0
- package/assets/agent-state/EVIDENCE_LOG.md +7 -0
- package/assets/agent-state/HANDOFF.json +24 -0
- package/assets/agent-state/INTERFACE_REGISTRY.md +75 -0
- package/assets/agent-state/MODULES/gates/gate-autonomy.json +7 -0
- package/assets/agent-state/MODULES/gates/gate-completeness.json +7 -0
- package/assets/agent-state/MODULES/gates/gate-correctness.json +7 -0
- package/assets/agent-state/MODULES/gates/gate-evaluation.json +7 -0
- package/assets/agent-state/MODULES/gates/gate-operability.json +7 -0
- package/assets/agent-state/MODULES/gates/gate-security.json +7 -0
- package/assets/agent-state/MODULES/gates/gate-typescript-public-surface.json +7 -0
- package/assets/agent-state/MODULES/registry.json +41 -0
- package/assets/agent-state/MODULES/roles/capability-astgrep.json +49 -0
- package/assets/agent-state/MODULES/roles/capability-build.json +39 -0
- package/assets/agent-state/MODULES/roles/capability-docs.json +38 -0
- package/assets/agent-state/MODULES/roles/capability-eval.json +20 -0
- package/assets/agent-state/MODULES/roles/capability-memory.json +20 -0
- package/assets/agent-state/MODULES/roles/capability-observability.json +20 -0
- package/assets/agent-state/MODULES/roles/capability-ops.json +45 -0
- package/assets/agent-state/MODULES/roles/capability-qa.json +40 -0
- package/assets/agent-state/MODULES/roles/capability-release.json +21 -0
- package/assets/agent-state/MODULES/roles/capability-research.json +44 -0
- package/assets/agent-state/MODULES/roles/capability-security.json +21 -0
- package/assets/agent-state/MODULES/roles/capability-skeptic.json +48 -0
- package/assets/agent-state/MODULES/roles/capability-spec.json +42 -0
- package/assets/agent-state/MODULES/schemas/ACE_RUNTIME_PROFILE.schema.json +289 -0
- package/assets/agent-state/MODULES/schemas/ARTIFACT_MANIFEST.schema.json +185 -0
- package/assets/agent-state/MODULES/schemas/HANDOFF.agent-state.schema.json +124 -0
- package/assets/agent-state/MODULES/schemas/HANDOFF.schema.json +55 -0
- package/assets/agent-state/MODULES/schemas/RUNTIME_EXECUTOR_SESSION_REGISTRY.schema.json +290 -0
- package/assets/agent-state/MODULES/schemas/RUNTIME_TOOL_SPEC_REGISTRY.schema.json +144 -0
- package/assets/agent-state/MODULES/schemas/STATUS_EVENT.schema.json +84 -0
- package/assets/agent-state/MODULES/schemas/SWARM_HANDOFF.schema.json +138 -0
- package/assets/agent-state/MODULES/schemas/TRACKER_SNAPSHOT.schema.json +134 -0
- package/assets/agent-state/MODULES/schemas/VERICIFY_BRIDGE_SNAPSHOT.schema.json +157 -0
- package/assets/agent-state/MODULES/schemas/VERICIFY_PROCESS_POST_LOG.schema.json +93 -0
- package/assets/agent-state/MODULES/schemas/WORKSPACE_SESSION_REGISTRY.schema.json +133 -0
- package/assets/agent-state/PROVENANCE_LOG.md +28 -0
- package/assets/agent-state/QUALITY_GATES.md +15 -0
- package/assets/agent-state/RISKS.md +8 -0
- package/assets/agent-state/SCOPE.md +20 -0
- package/assets/agent-state/SKILL_CATALOG.md +48 -0
- package/assets/agent-state/STATUS.md +8 -0
- package/assets/agent-state/STATUS_EVENTS.ndjson +1 -0
- package/assets/agent-state/TASK.md +18 -0
- package/assets/agent-state/TEAL_CONFIG.md +117 -0
- package/assets/agent-state/handoff-registry.json +5 -0
- package/assets/agent-state/index-fingerprints.json +7 -0
- package/assets/agent-state/index.json +32 -0
- package/assets/agent-state/run-ledger.json +5 -0
- package/assets/agent-state/runtime-executor-sessions.json +5 -0
- package/assets/agent-state/runtime-tool-specs.json +5 -0
- package/assets/agent-state/runtime-workspaces.json +5 -0
- package/assets/agent-state/todo-state.json +7 -0
- package/assets/agent-state/tracker-snapshot.json +7 -0
- package/assets/agent-state/vericify/ace-bridge.json +60 -0
- package/assets/agent-state/vericify/process-posts.json +5 -0
- package/assets/instructions/ACE.instructions.md +187 -0
- package/assets/instructions/ACE_Coder.instructions.md +146 -0
- package/assets/instructions/ACE_UI.instructions.md +178 -0
- package/assets/instructions/ACE_VOS.instructions.md +211 -0
- package/assets/scripts/ace-hook-dispatch.mjs +538 -0
- package/assets/scripts/bootstrap-workspace.sh +27 -0
- package/assets/scripts/copilot-hook-dispatch.mjs +3 -0
- package/assets/scripts/eval-harness.sh +68 -0
- package/assets/scripts/render-mcp-configs.sh +396 -0
- package/assets/tasks/README.md +48 -0
- package/assets/tasks/SWARM_HANDOFF.example.json +53 -0
- package/assets/tasks/SWARM_HANDOFF.example_ui_to_coders.json +55 -0
- package/assets/tasks/SWARM_HANDOFF.example_vos_to_ui.json +55 -0
- package/assets/tasks/SWARM_HANDOFF.template.json +52 -0
- package/assets/tasks/cli_work_split.md +22 -0
- package/assets/tasks/lessons.md +17 -0
- package/assets/tasks/role_tasks.md +206 -0
- package/assets/tasks/todo.md +23 -0
- package/dist/ace-autonomy.d.ts +137 -0
- package/dist/ace-autonomy.js +472 -0
- package/dist/ace-context.d.ts +29 -0
- package/dist/ace-context.js +240 -0
- package/dist/ace-internal-tools.d.ts +8 -0
- package/dist/ace-internal-tools.js +76 -0
- package/dist/ace-server-instructions.d.ts +12 -0
- package/dist/ace-server-instructions.js +324 -0
- package/dist/agent-runtime/role-adapters.d.ts +29 -0
- package/dist/agent-runtime/role-adapters.js +573 -0
- package/dist/astgrep-index.d.ts +24 -0
- package/dist/astgrep-index.js +476 -0
- package/dist/cli.d.ts +3 -0
- package/dist/cli.js +591 -0
- package/dist/git-ops.d.ts +53 -0
- package/dist/git-ops.js +238 -0
- package/dist/handoff-registry.d.ts +71 -0
- package/dist/handoff-registry.js +422 -0
- package/dist/helpers.d.ts +126 -0
- package/dist/helpers.js +1687 -0
- package/dist/index-store.d.ts +51 -0
- package/dist/index-store.js +328 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.js +7 -0
- package/dist/internal-tool-runtime.d.ts +21 -0
- package/dist/internal-tool-runtime.js +136 -0
- package/dist/job-scheduler.d.ts +175 -0
- package/dist/job-scheduler.js +1217 -0
- package/dist/kanban.d.ts +27 -0
- package/dist/kanban.js +339 -0
- package/dist/local-model-runtime.d.ts +40 -0
- package/dist/local-model-runtime.js +174 -0
- package/dist/model-bridge.d.ts +54 -0
- package/dist/model-bridge.js +587 -0
- package/dist/orchestrator-supervisor.d.ts +100 -0
- package/dist/orchestrator-supervisor.js +399 -0
- package/dist/problem-triage.d.ts +23 -0
- package/dist/problem-triage.js +448 -0
- package/dist/prompts.d.ts +7 -0
- package/dist/prompts.js +628 -0
- package/dist/public-surface.d.ts +30 -0
- package/dist/public-surface.js +316 -0
- package/dist/resources.d.ts +7 -0
- package/dist/resources.js +545 -0
- package/dist/run-ledger.d.ts +36 -0
- package/dist/run-ledger.js +257 -0
- package/dist/runtime-command.d.ts +18 -0
- package/dist/runtime-command.js +76 -0
- package/dist/runtime-executor.d.ts +104 -0
- package/dist/runtime-executor.js +985 -0
- package/dist/runtime-profile.d.ts +116 -0
- package/dist/runtime-profile.js +532 -0
- package/dist/runtime-tool-specs.d.ts +68 -0
- package/dist/runtime-tool-specs.js +527 -0
- package/dist/safe-edit.d.ts +52 -0
- package/dist/safe-edit.js +255 -0
- package/dist/schemas.d.ts +44 -0
- package/dist/schemas.js +830 -0
- package/dist/semantic-cache.d.ts +147 -0
- package/dist/semantic-cache.js +552 -0
- package/dist/semantic-hash.d.ts +83 -0
- package/dist/semantic-hash.js +346 -0
- package/dist/server.d.ts +10 -0
- package/dist/server.js +46 -0
- package/dist/shared.d.ts +136 -0
- package/dist/shared.js +269 -0
- package/dist/skill-auditor.d.ts +26 -0
- package/dist/skill-auditor.js +184 -0
- package/dist/skill-catalog.d.ts +60 -0
- package/dist/skill-catalog.js +305 -0
- package/dist/status-events.d.ts +40 -0
- package/dist/status-events.js +269 -0
- package/dist/store/ace-packed-store.d.ts +69 -0
- package/dist/store/ace-packed-store.js +434 -0
- package/dist/store/bootstrap-store.d.ts +46 -0
- package/dist/store/bootstrap-store.js +242 -0
- package/dist/store/catalog-builder.d.ts +21 -0
- package/dist/store/catalog-builder.js +68 -0
- package/dist/store/importer.d.ts +19 -0
- package/dist/store/importer.js +157 -0
- package/dist/store/knowledge-bake.d.ts +59 -0
- package/dist/store/knowledge-bake.js +339 -0
- package/dist/store/materializers/hook-context-materializer.d.ts +25 -0
- package/dist/store/materializers/hook-context-materializer.js +100 -0
- package/dist/store/materializers/host-file-materializer.d.ts +37 -0
- package/dist/store/materializers/host-file-materializer.js +271 -0
- package/dist/store/materializers/todo-syncer.d.ts +30 -0
- package/dist/store/materializers/todo-syncer.js +140 -0
- package/dist/store/materializers/vericify-projector.d.ts +38 -0
- package/dist/store/materializers/vericify-projector.js +239 -0
- package/dist/store/repositories/discovery-repository.d.ts +24 -0
- package/dist/store/repositories/discovery-repository.js +58 -0
- package/dist/store/repositories/handoff-repository.d.ts +31 -0
- package/dist/store/repositories/handoff-repository.js +67 -0
- package/dist/store/repositories/ledger-repository.d.ts +26 -0
- package/dist/store/repositories/ledger-repository.js +49 -0
- package/dist/store/repositories/runtime-kv-repository.d.ts +16 -0
- package/dist/store/repositories/runtime-kv-repository.js +36 -0
- package/dist/store/repositories/scheduler-repository.d.ts +50 -0
- package/dist/store/repositories/scheduler-repository.js +123 -0
- package/dist/store/repositories/session-repository.d.ts +33 -0
- package/dist/store/repositories/session-repository.js +82 -0
- package/dist/store/repositories/todo-repository.d.ts +31 -0
- package/dist/store/repositories/todo-repository.js +77 -0
- package/dist/store/repositories/tracker-repository.d.ts +25 -0
- package/dist/store/repositories/tracker-repository.js +43 -0
- package/dist/store/repositories/vericify-repository.d.ts +32 -0
- package/dist/store/repositories/vericify-repository.js +58 -0
- package/dist/store/skills-install.d.ts +28 -0
- package/dist/store/skills-install.js +86 -0
- package/dist/store/state-reader.d.ts +49 -0
- package/dist/store/state-reader.js +111 -0
- package/dist/store/store-artifacts.d.ts +12 -0
- package/dist/store/store-artifacts.js +138 -0
- package/dist/store/store-snapshot.d.ts +19 -0
- package/dist/store/store-snapshot.js +140 -0
- package/dist/store/topology-bake.d.ts +15 -0
- package/dist/store/topology-bake.js +215 -0
- package/dist/store/types.d.ts +155 -0
- package/dist/store/types.js +35 -0
- package/dist/store/workspace-snapshot.d.ts +26 -0
- package/dist/store/workspace-snapshot.js +107 -0
- package/dist/store/write-queue.d.ts +7 -0
- package/dist/store/write-queue.js +26 -0
- package/dist/todo-state.d.ts +41 -0
- package/dist/todo-state.js +399 -0
- package/dist/tools-agent.d.ts +7 -0
- package/dist/tools-agent.js +1542 -0
- package/dist/tools-discovery.d.ts +6 -0
- package/dist/tools-discovery.js +178 -0
- package/dist/tools-drift.d.ts +13 -0
- package/dist/tools-drift.js +357 -0
- package/dist/tools-files.d.ts +6 -0
- package/dist/tools-files.js +679 -0
- package/dist/tools-framework.d.ts +7 -0
- package/dist/tools-framework.js +1414 -0
- package/dist/tools-git.d.ts +6 -0
- package/dist/tools-git.js +183 -0
- package/dist/tools-handoff.d.ts +32 -0
- package/dist/tools-handoff.js +489 -0
- package/dist/tools-lifecycle.d.ts +6 -0
- package/dist/tools-lifecycle.js +205 -0
- package/dist/tools-memory.d.ts +6 -0
- package/dist/tools-memory.js +260 -0
- package/dist/tools-scheduler.d.ts +6 -0
- package/dist/tools-scheduler.js +228 -0
- package/dist/tools-skills.d.ts +3 -0
- package/dist/tools-skills.js +104 -0
- package/dist/tools-todo.d.ts +6 -0
- package/dist/tools-todo.js +154 -0
- package/dist/tools.d.ts +9 -0
- package/dist/tools.js +33 -0
- package/dist/tracker-adapters.d.ts +74 -0
- package/dist/tracker-adapters.js +776 -0
- package/dist/tracker-sync.d.ts +10 -0
- package/dist/tracker-sync.js +84 -0
- package/dist/tui/agent-runner.d.ts +137 -0
- package/dist/tui/agent-runner.js +466 -0
- package/dist/tui/agent-worker.d.ts +10 -0
- package/dist/tui/agent-worker.js +347 -0
- package/dist/tui/chat.d.ts +84 -0
- package/dist/tui/chat.js +368 -0
- package/dist/tui/commands.d.ts +57 -0
- package/dist/tui/commands.js +432 -0
- package/dist/tui/dashboard.d.ts +24 -0
- package/dist/tui/dashboard.js +110 -0
- package/dist/tui/index.d.ts +114 -0
- package/dist/tui/index.js +1059 -0
- package/dist/tui/input.d.ts +49 -0
- package/dist/tui/input.js +336 -0
- package/dist/tui/layout.d.ts +116 -0
- package/dist/tui/layout.js +367 -0
- package/dist/tui/ollama.d.ts +116 -0
- package/dist/tui/ollama.js +192 -0
- package/dist/tui/openai-compatible.d.ts +63 -0
- package/dist/tui/openai-compatible.js +370 -0
- package/dist/tui/provider-discovery.d.ts +59 -0
- package/dist/tui/provider-discovery.js +530 -0
- package/dist/tui/renderer.d.ts +166 -0
- package/dist/tui/renderer.js +304 -0
- package/dist/tui/tabs.d.ts +70 -0
- package/dist/tui/tabs.js +208 -0
- package/dist/tui/telemetry.d.ts +56 -0
- package/dist/tui/telemetry.js +106 -0
- package/dist/vericify-bridge.d.ts +146 -0
- package/dist/vericify-bridge.js +571 -0
- package/dist/vericify-context.d.ts +10 -0
- package/dist/vericify-context.js +72 -0
- package/dist/workspace-manager.d.ts +107 -0
- package/dist/workspace-manager.js +636 -0
- package/package.json +83 -0
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: schema-forge
|
|
3
|
+
description:
|
|
4
|
+
Evolve ACE interface schemas safely with versioning, compatibility analysis, and migration guidance. Use when handoff, status, or artifact contracts change or a schema violation must be repaired.
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Schema Forge
|
|
8
|
+
|
|
9
|
+
## Purpose
|
|
10
|
+
|
|
11
|
+
Guarantee interoperability by evolving schemas with strict validation, versioning, and consumer-safe migration rules.
|
|
12
|
+
Schema without versioning is a landmine. Schema with versioning is a contract.
|
|
13
|
+
|
|
14
|
+
## Canonical Use Cases
|
|
15
|
+
|
|
16
|
+
1. A handoff, status event, or artifact schema needs a new field or compatibility-safe evolution.
|
|
17
|
+
2. A breaking contract change is proposed and the team needs versioning, migration guidance, and producer/consumer mapping.
|
|
18
|
+
3. A schema violation exposed drift between contract and consumers, and the interface must be repaired safely.
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## MICE Boundaries
|
|
23
|
+
|
|
24
|
+
| Rule | Enforcement |
|
|
25
|
+
|---|---|
|
|
26
|
+
| **Modular** | Manages schema contracts; does NOT implement business logic or change routing. |
|
|
27
|
+
| **Interoperable** | Every schema follows JSON Schema draft-07+ with `$id` and `$schema` fields. |
|
|
28
|
+
| **Customizable** | Schema evolution respects `TEAL_CONFIG.md` consumer topology. |
|
|
29
|
+
| **Extensible** | New schemas are added with producer/consumer mapping, not ad-hoc. |
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## MICE/TEAL Alignment
|
|
34
|
+
|
|
35
|
+
- Interoperable-first skill: schema contracts are the module boundary glue.
|
|
36
|
+
- TEAL-aware: schema evolution must preserve producer/consumer compatibility across configured routes.
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
|
|
40
|
+
## Trigger Conditions
|
|
41
|
+
|
|
42
|
+
Use when:
|
|
43
|
+
|
|
44
|
+
- adding/changing handoff fields
|
|
45
|
+
- adding/changing status event payloads
|
|
46
|
+
- introducing new artifact manifests
|
|
47
|
+
- upgrading module interface versions
|
|
48
|
+
- post-incident contract repair
|
|
49
|
+
- any agent reports `schema_violation` via Wrong-Stuff Protocol
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## Inputs
|
|
54
|
+
|
|
55
|
+
- `agent-state/MODULES/schemas/*.json`
|
|
56
|
+
- `agent-state/INTERFACE_REGISTRY.md`
|
|
57
|
+
- `agent-state/TEAL_CONFIG.md`
|
|
58
|
+
- producer/consumer role manifests
|
|
59
|
+
- the proposed change (what fields are being added/changed/removed)
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
## Socratic Questions (Pre-Evolution)
|
|
64
|
+
|
|
65
|
+
- Which invariant is this schema enforcing?
|
|
66
|
+
- Who produces it and who consumes it?
|
|
67
|
+
- Is this additive or breaking for current consumers?
|
|
68
|
+
- What migration path is required?
|
|
69
|
+
- Can consumers tolerate this change without code modification?
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
73
|
+
## Version Bump Decision Matrix
|
|
74
|
+
|
|
75
|
+
| Change Type | Examples | Version Bump | Consumer Impact |
|
|
76
|
+
|---|---|---|---|
|
|
77
|
+
| New optional field | Adding `metadata.tags` | `patch` | None; consumers ignore unknown fields |
|
|
78
|
+
| New required field | Adding `context.priority` | `minor` | Consumers must handle; provide default |
|
|
79
|
+
| Field type change | String → Object | `major` | Breaking; migration required |
|
|
80
|
+
| Field removal | Removing `legacy_id` | `major` | Breaking; migration required |
|
|
81
|
+
| Enum value addition | Adding `ROLLBACK` to decision types | `minor` | Consumers must handle unknown enum gracefully |
|
|
82
|
+
| Enum value removal | Removing deprecated value | `major` | Breaking; migration required |
|
|
83
|
+
| Constraint tightening | maxLength 100 → 50 | `major` | Breaking for producers |
|
|
84
|
+
| Constraint relaxation | maxLength 50 → 100 | `patch` | None |
|
|
85
|
+
|
|
86
|
+
---
|
|
87
|
+
|
|
88
|
+
## Compatibility Rules
|
|
89
|
+
|
|
90
|
+
| Rule | Enforcement |
|
|
91
|
+
|---|---|
|
|
92
|
+
| **Backward Compatible** | Consumers on version N must still parse payloads from version N+1 (additive only). |
|
|
93
|
+
| **Forward Compatible** | Producers on version N+1 must still produce valid payloads for version N consumers (no removal). |
|
|
94
|
+
| **Breaking Change** | Requires: migration guide, consumer notification, deprecation period (>= 1 sprint), evidence of consumer readiness. |
|
|
95
|
+
| **Schema Coexistence** | During migration, both old and new schema versions must be loadable simultaneously. |
|
|
96
|
+
|
|
97
|
+
---
|
|
98
|
+
|
|
99
|
+
## Workflow — Mapped to Clarity Protocol
|
|
100
|
+
|
|
101
|
+
### `[STATE_ANALYSIS]`
|
|
102
|
+
1. Identify the schema being evolved and its current version.
|
|
103
|
+
2. Map all producers and consumers from `INTERFACE_REGISTRY.md`.
|
|
104
|
+
3. Assess the proposed change against compatibility rules.
|
|
105
|
+
|
|
106
|
+
### `[STRATEGY_SELECTOR]`
|
|
107
|
+
4. Determine version bump using decision matrix.
|
|
108
|
+
5. If `major`: plan migration guide, deprecation period, consumer notification.
|
|
109
|
+
6. If `minor/patch`: plan additive change with backward compatibility preserved.
|
|
110
|
+
|
|
111
|
+
### `[EXECUTION_LOG]`
|
|
112
|
+
7. Update schema file with version bump and change.
|
|
113
|
+
8. Add `$id` with new version number.
|
|
114
|
+
9. For breaking changes: write migration guide with before/after examples.
|
|
115
|
+
10. Validate updated schema against sample payloads (both old and new format).
|
|
116
|
+
11. Update `INTERFACE_REGISTRY.md` with new version and consumer mapping.
|
|
117
|
+
|
|
118
|
+
### `[ARTIFACT_UPDATE]`
|
|
119
|
+
12. Write updated schema to `agent-state/MODULES/schemas/<name>.json`.
|
|
120
|
+
13. Update `agent-state/INTERFACE_REGISTRY.md` entry.
|
|
121
|
+
14. Write `agent-state/SCHEMA_CHANGELOG.md` entry:
|
|
122
|
+
|
|
123
|
+
```markdown
|
|
124
|
+
### <version> — <ISO8601>
|
|
125
|
+
- **Schema:** <name>
|
|
126
|
+
- **Change:** <description>
|
|
127
|
+
- **Bump:** <patch | minor | major>
|
|
128
|
+
- **Compatibility:** <backward | forward | breaking>
|
|
129
|
+
- **Migration:** <N/A | see migration guide>
|
|
130
|
+
- **Producers:** <list>
|
|
131
|
+
- **Consumers:** <list>
|
|
132
|
+
- **Validated:** <sample payloads tested>
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
15. Append evidence to `EVIDENCE_LOG.md`.
|
|
136
|
+
|
|
137
|
+
### `[VERIFICATION]`
|
|
138
|
+
16. Schema validates against JSON Schema meta-schema.
|
|
139
|
+
17. Sample payloads (old + new format) validate against updated schema.
|
|
140
|
+
18. Version bump matches change type per decision matrix.
|
|
141
|
+
19. All producers and consumers are mapped in `INTERFACE_REGISTRY.md`.
|
|
142
|
+
20. Breaking changes have migration guide and deprecation plan.
|
|
143
|
+
|
|
144
|
+
---
|
|
145
|
+
|
|
146
|
+
## Output Contract
|
|
147
|
+
|
|
148
|
+
- Updated schema file(s) under `agent-state/MODULES/schemas/`
|
|
149
|
+
- Updated `agent-state/INTERFACE_REGISTRY.md`
|
|
150
|
+
- `agent-state/SCHEMA_CHANGELOG.md` entry
|
|
151
|
+
|
|
152
|
+
---
|
|
153
|
+
|
|
154
|
+
## Anti-Patterns
|
|
155
|
+
|
|
156
|
+
| Anti-Pattern | Correct Behavior |
|
|
157
|
+
|---|---|
|
|
158
|
+
| Changing schema without version bump | Every change gets a version bump per decision matrix |
|
|
159
|
+
| Breaking change without migration guide | Major bumps require migration guide with examples |
|
|
160
|
+
| Schema without producer/consumer mapping | Every schema has explicit ownership in `INTERFACE_REGISTRY.md` |
|
|
161
|
+
| "Just add the field" | Assess compatibility impact before adding |
|
|
162
|
+
| Schema without sample payloads | Every schema version has validated sample payloads |
|
|
163
|
+
|
|
164
|
+
---
|
|
165
|
+
|
|
166
|
+
## Failure Policy
|
|
167
|
+
|
|
168
|
+
Reject schema updates that:
|
|
169
|
+
|
|
170
|
+
- lack version updates
|
|
171
|
+
- omit compatibility notes
|
|
172
|
+
- have no producer/consumer mapping
|
|
173
|
+
- fail sample payload validation
|
|
174
|
+
- introduce breaking changes without migration guide
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: skill-auditor
|
|
3
|
+
description:
|
|
4
|
+
Audit discoverable ACE skills against the portable skill contract, validation expectations, and progressive-disclosure rules. Use when the user asks which skills are production-ready, what is missing from the skill catalog, or how to verify portability across Claude, Cursor, Codex, Antigravity, and similar clients.
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Skill Auditor
|
|
8
|
+
|
|
9
|
+
Use this skill to inspect the current ACE skill catalog before a remediation pass, release gate, or new skill rollout. Its job is to turn vague quality concerns into a concrete audit report and prioritized backlog.
|
|
10
|
+
|
|
11
|
+
## Canonical Use Cases
|
|
12
|
+
|
|
13
|
+
1. A user asks which existing skills are not yet production-ready.
|
|
14
|
+
2. The team needs a readiness rubric before hardening trigger metadata or validation canaries.
|
|
15
|
+
3. A portability change lands and someone needs to verify that `SKILL.md` remains canonical while any client overlays stay optional.
|
|
16
|
+
|
|
17
|
+
## Inputs
|
|
18
|
+
|
|
19
|
+
- The discoverable skill catalog from workspace and package-default skills.
|
|
20
|
+
- Each skill's `SKILL.md`, optional `agents/` overlays, and supporting `references/` directory if present.
|
|
21
|
+
- The current readiness criteria for trigger descriptions, core sections, validation, and portability.
|
|
22
|
+
|
|
23
|
+
## Workflow
|
|
24
|
+
|
|
25
|
+
1. Enumerate the discoverable skills and inspect each portable skill contract.
|
|
26
|
+
2. Check frontmatter, trigger-aware description quality, canonical use cases, inputs/workflow/outputs/failure sections, validation surface, portability notes, and progressive-disclosure discipline.
|
|
27
|
+
3. Record per-skill findings as pass, warn, or fail, keeping optional adapter overlays as neutral inventory rather than required readiness.
|
|
28
|
+
4. Write `agent-state/SKILL_AUDIT_REPORT.md` with summary counts, per-skill findings, and rollout backlog items.
|
|
29
|
+
|
|
30
|
+
## Outputs
|
|
31
|
+
|
|
32
|
+
- `agent-state/SKILL_AUDIT_REPORT.md`
|
|
33
|
+
- Per-skill pass/warn/fail findings with concrete remediation notes
|
|
34
|
+
- A rollout backlog for validation, portability, and progressive-disclosure gaps
|
|
35
|
+
|
|
36
|
+
## Validation
|
|
37
|
+
|
|
38
|
+
- Run the `skill_audit` MCP tool when it is available, or perform a direct catalog inspection of discoverable `SKILL.md` files, and verify that `agent-state/SKILL_AUDIT_REPORT.md` is written.
|
|
39
|
+
- Confirm that a skill missing required sections is flagged as `fail`.
|
|
40
|
+
- Confirm that a skill with optional client overlays but no portability note is flagged as `warn`, not as a hard failure for missing `openai.yaml`.
|
|
41
|
+
|
|
42
|
+
## Compatibility
|
|
43
|
+
|
|
44
|
+
- `SKILL.md` is the canonical source of truth for the audit.
|
|
45
|
+
- Files under `agents/` are optional overlays only and should be audited for parity, not treated as mandatory.
|
|
46
|
+
- The audit must stay meaningful even if no client-specific adapters exist at all.
|
|
47
|
+
|
|
48
|
+
## Failure Policy
|
|
49
|
+
|
|
50
|
+
- If the catalog cannot be read, stop and surface the specific filesystem problem.
|
|
51
|
+
- If a skill is ambiguous, lower confidence through `warn` findings instead of silently passing it.
|
|
52
|
+
- Do not treat the absence of a specific client adapter file as a failure unless the portable contract itself depends on it.
|
|
@@ -0,0 +1,182 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: state-auditor
|
|
3
|
+
description:
|
|
4
|
+
Deterministic integrity scanner for ACE state artifacts. Use before/after role transitions, release gates, or when status truth may have drifted.
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# State Auditor
|
|
8
|
+
|
|
9
|
+
## Purpose
|
|
10
|
+
|
|
11
|
+
Detect and repair state drift across `agent-state/` so autonomous execution remains coherent and reproducible.
|
|
12
|
+
State without audit is faith. State with audit is engineering.
|
|
13
|
+
|
|
14
|
+
## Canonical Use Cases
|
|
15
|
+
|
|
16
|
+
1. A role transition or handoff is about to occur and the team needs a fast check that core state files agree.
|
|
17
|
+
2. A blocker persists or contradictory state is suspected, and someone needs a deterministic drift report before acting.
|
|
18
|
+
3. A release or post-incident checkpoint needs proof that status, evidence, risks, and routing state are coherent.
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## MICE Boundaries
|
|
23
|
+
|
|
24
|
+
| Rule | Enforcement |
|
|
25
|
+
|---|---|
|
|
26
|
+
| **Modular** | Audits state consistency; does NOT implement features or change scope. |
|
|
27
|
+
| **Interoperable** | Audit reports follow canonical schema below. |
|
|
28
|
+
| **Customizable** | Recency thresholds adapt to sprint cadence in `TEAL_CONFIG.md`. |
|
|
29
|
+
| **Extensible** | New audit checks added as checklist rows, not prose. |
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## MICE/TEAL Alignment
|
|
34
|
+
|
|
35
|
+
- Modular: audits state only, does not implement feature logic.
|
|
36
|
+
- TEAL-aware: validates status/handoff consistency against active pipeline topology.
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
|
|
40
|
+
## Trigger Conditions
|
|
41
|
+
|
|
42
|
+
Use when:
|
|
43
|
+
|
|
44
|
+
- a role transition is about to occur
|
|
45
|
+
- handoff payload changed
|
|
46
|
+
- blockers persist > 1 cycle
|
|
47
|
+
- there is contradiction between `STATUS.md` and `EVIDENCE_LOG.md`
|
|
48
|
+
- pre-release gate check
|
|
49
|
+
- post-incident state verification
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## Inputs
|
|
54
|
+
|
|
55
|
+
- `agent-state/TASK.md`
|
|
56
|
+
- `agent-state/STATUS.md`
|
|
57
|
+
- `agent-state/SCOPE.md`
|
|
58
|
+
- `agent-state/DECISIONS.md`
|
|
59
|
+
- `agent-state/RISKS.md`
|
|
60
|
+
- `agent-state/EVIDENCE_LOG.md`
|
|
61
|
+
- `agent-state/HANDOFF.json`
|
|
62
|
+
- `agent-state/TEAL_CONFIG.md`
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## Audit Checklist
|
|
67
|
+
|
|
68
|
+
| # | Check | Pass Criteria | On Fail |
|
|
69
|
+
|---|---|---|---|
|
|
70
|
+
| 1 | **Artifact Presence** | All 8 required inputs exist on disk | CRITICAL: list missing files |
|
|
71
|
+
| 2 | **Artifact Recency** | All files modified within current sprint window | WARN if > 1 sprint; CRITICAL if > 2 |
|
|
72
|
+
| 3 | **Owner Consistency** | Current owner in `STATUS.md` matches `HANDOFF.json` `to` field | CRITICAL: contradictory ownership |
|
|
73
|
+
| 4 | **Phase Consistency** | Phase in `STATUS.md` matches `HANDOFF.json` context | WARN: possible stale handoff |
|
|
74
|
+
| 5 | **Evidence Anchors** | Every claimed transition in `STATUS.md` has `EVIDENCE_LOG.md` entry | CRITICAL: unanchored transitions |
|
|
75
|
+
| 6 | **Blocker Resolution** | Active blockers in `STATUS.md` have owner and due condition | WARN: orphaned blockers |
|
|
76
|
+
| 7 | **Decision Currency** | `DECISIONS.md` entries reference current (not superseded) evidence | WARN: stale decisions |
|
|
77
|
+
| 8 | **Risk Currency** | `RISKS.md` entries scored within current sprint | WARN: unscored risks |
|
|
78
|
+
| 9 | **Scope Alignment** | `SCOPE.md` boundaries not contradicted by `TASK.md` objectives | CRITICAL: scope/task misalignment |
|
|
79
|
+
| 10 | **TEAL Route Validity** | Configured routes in `TEAL_CONFIG.md` match actual agent topology | CRITICAL: invalid routes |
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
## Contradiction Detection Protocol
|
|
84
|
+
|
|
85
|
+
When contradictions are found between state files:
|
|
86
|
+
|
|
87
|
+
1. **Identify**: Which two files contain conflicting claims.
|
|
88
|
+
2. **Timestamp**: Which claim is more recent (evidence-linked).
|
|
89
|
+
3. **Classify**: Is this a stale-state issue or a genuine disagreement.
|
|
90
|
+
4. **Route**: Stale → update the older file. Genuine → emit `FIX_REQUIRED` to owner.
|
|
91
|
+
5. **Record**: Log contradiction and resolution in audit report.
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
## Workflow — Mapped to Clarity Protocol
|
|
96
|
+
|
|
97
|
+
### `[STATE_ANALYSIS]`
|
|
98
|
+
1. Check all 8 required artifacts for presence and recency.
|
|
99
|
+
2. Read `STATUS.md` current owner and phase.
|
|
100
|
+
3. Read `HANDOFF.json` for claimed transition state.
|
|
101
|
+
|
|
102
|
+
### `[STRATEGY_SELECTOR]`
|
|
103
|
+
4. Run full audit checklist (10 checks) in order.
|
|
104
|
+
5. Classify each result as `PASS`, `WARN`, or `CRITICAL`.
|
|
105
|
+
6. If any CRITICAL found, plan immediate routing.
|
|
106
|
+
|
|
107
|
+
### `[EXECUTION_LOG]`
|
|
108
|
+
7. Execute each audit check deterministically.
|
|
109
|
+
8. Cross-check owner/phase consistency between `STATUS.md` and handoff.
|
|
110
|
+
9. Verify evidence anchors exist for each claimed transition.
|
|
111
|
+
10. Detect contradictory statements across core state files using contradiction protocol.
|
|
112
|
+
11. Validate TEAL route configuration against actual topology.
|
|
113
|
+
|
|
114
|
+
### `[ARTIFACT_UPDATE]`
|
|
115
|
+
12. Write `agent-state/STATE_AUDIT_REPORT.md`:
|
|
116
|
+
|
|
117
|
+
```markdown
|
|
118
|
+
# State Audit Report
|
|
119
|
+
Generated: <ISO8601>
|
|
120
|
+
Overall: <PASS | WARN | CRITICAL>
|
|
121
|
+
|
|
122
|
+
## Checklist Results
|
|
123
|
+
| # | Check | Status | Detail |
|
|
124
|
+
|---|---|---|---|
|
|
125
|
+
| 1 | Artifact Presence | PASS/WARN/CRITICAL | <detail> |
|
|
126
|
+
| ... | ... | ... | ... |
|
|
127
|
+
|
|
128
|
+
## Critical Findings
|
|
129
|
+
- <finding with evidence ref and required action>
|
|
130
|
+
|
|
131
|
+
## Non-Blocking Findings
|
|
132
|
+
- <finding with evidence ref>
|
|
133
|
+
|
|
134
|
+
## Contradictions Detected
|
|
135
|
+
- <file1> vs <file2>: <description> → <resolution>
|
|
136
|
+
|
|
137
|
+
## Required Actions
|
|
138
|
+
| Action | Owner | Due Condition |
|
|
139
|
+
|---|---|---|
|
|
140
|
+
| <action> | <agent-role> | <what must happen> |
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
13. Append audit evidence to `EVIDENCE_LOG.md`.
|
|
144
|
+
|
|
145
|
+
### `[VERIFICATION]`
|
|
146
|
+
14. Every checklist row has a deterministic result.
|
|
147
|
+
15. All CRITICAL findings have owner + required action.
|
|
148
|
+
16. Contradictions are logged with both references.
|
|
149
|
+
17. Report is internally consistent (no contradictions within the report itself).
|
|
150
|
+
|
|
151
|
+
---
|
|
152
|
+
|
|
153
|
+
## Output Contract
|
|
154
|
+
|
|
155
|
+
- `agent-state/STATE_AUDIT_REPORT.md`
|
|
156
|
+
- `summary` (overall PASS/WARN/CRITICAL)
|
|
157
|
+
- `critical_findings` (with evidence refs and required actions)
|
|
158
|
+
- `non_blocking_findings` (with evidence refs)
|
|
159
|
+
- `contradictions` (with dual refs and resolution)
|
|
160
|
+
- `required_actions` (with owner and due condition)
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
## Anti-Patterns
|
|
165
|
+
|
|
166
|
+
| Anti-Pattern | Correct Behavior |
|
|
167
|
+
|---|---|
|
|
168
|
+
| "State looks fine" | Every check produces PASS/WARN/CRITICAL with evidence |
|
|
169
|
+
| Skipping contradiction detection | Always scan for cross-file contradictions |
|
|
170
|
+
| Audit without artifact presence check | Presence check is always step 1 |
|
|
171
|
+
| Reporting WARN but not tracking | All WARNs escalate to CRITICAL after 2 consecutive audits |
|
|
172
|
+
|
|
173
|
+
---
|
|
174
|
+
|
|
175
|
+
## Failure Policy
|
|
176
|
+
|
|
177
|
+
If critical contradiction is found:
|
|
178
|
+
|
|
179
|
+
- emit `GATE_FAILED` with `failure_type: state_drift`
|
|
180
|
+
- block downstream transitions
|
|
181
|
+
- assign owner and due condition in `STATUS.md`
|
|
182
|
+
- if > 3 CRITICAL findings in one audit, escalate to incident-commander
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
{
|
|
2
|
+
"hooks": {
|
|
3
|
+
"SessionStart": [
|
|
4
|
+
{
|
|
5
|
+
"type": "command",
|
|
6
|
+
"command": "node ./.agents/ACE/scripts/ace/ace-hook-dispatch.mjs",
|
|
7
|
+
"windows": "node .\\\\.agents\\\\ACE\\\\scripts\\\\ace\\\\ace-hook-dispatch.mjs",
|
|
8
|
+
"timeout": 10
|
|
9
|
+
}
|
|
10
|
+
],
|
|
11
|
+
"UserPromptSubmit": [
|
|
12
|
+
{
|
|
13
|
+
"type": "command",
|
|
14
|
+
"command": "node ./.agents/ACE/scripts/ace/ace-hook-dispatch.mjs",
|
|
15
|
+
"windows": "node .\\\\.agents\\\\ACE\\\\scripts\\\\ace\\\\ace-hook-dispatch.mjs",
|
|
16
|
+
"timeout": 10
|
|
17
|
+
}
|
|
18
|
+
],
|
|
19
|
+
"PreToolUse": [
|
|
20
|
+
{
|
|
21
|
+
"type": "command",
|
|
22
|
+
"command": "node ./.agents/ACE/scripts/ace/ace-hook-dispatch.mjs",
|
|
23
|
+
"windows": "node .\\\\.agents\\\\ACE\\\\scripts\\\\ace\\\\ace-hook-dispatch.mjs",
|
|
24
|
+
"timeout": 10
|
|
25
|
+
}
|
|
26
|
+
],
|
|
27
|
+
"PostToolUse": [
|
|
28
|
+
{
|
|
29
|
+
"type": "command",
|
|
30
|
+
"command": "node ./.agents/ACE/scripts/ace/ace-hook-dispatch.mjs",
|
|
31
|
+
"windows": "node .\\\\.agents\\\\ACE\\\\scripts\\\\ace\\\\ace-hook-dispatch.mjs",
|
|
32
|
+
"timeout": 10
|
|
33
|
+
}
|
|
34
|
+
],
|
|
35
|
+
"PreCompact": [
|
|
36
|
+
{
|
|
37
|
+
"type": "command",
|
|
38
|
+
"command": "node ./.agents/ACE/scripts/ace/ace-hook-dispatch.mjs",
|
|
39
|
+
"windows": "node .\\\\.agents\\\\ACE\\\\scripts\\\\ace\\\\ace-hook-dispatch.mjs",
|
|
40
|
+
"timeout": 10
|
|
41
|
+
}
|
|
42
|
+
],
|
|
43
|
+
"SubagentStart": [
|
|
44
|
+
{
|
|
45
|
+
"type": "command",
|
|
46
|
+
"command": "node ./.agents/ACE/scripts/ace/ace-hook-dispatch.mjs",
|
|
47
|
+
"windows": "node .\\\\.agents\\\\ACE\\\\scripts\\\\ace\\\\ace-hook-dispatch.mjs",
|
|
48
|
+
"timeout": 10
|
|
49
|
+
}
|
|
50
|
+
],
|
|
51
|
+
"SubagentStop": [
|
|
52
|
+
{
|
|
53
|
+
"type": "command",
|
|
54
|
+
"command": "node ./.agents/ACE/scripts/ace/ace-hook-dispatch.mjs",
|
|
55
|
+
"windows": "node .\\\\.agents\\\\ACE\\\\scripts\\\\ace\\\\ace-hook-dispatch.mjs",
|
|
56
|
+
"timeout": 10
|
|
57
|
+
}
|
|
58
|
+
],
|
|
59
|
+
"Stop": [
|
|
60
|
+
{
|
|
61
|
+
"type": "command",
|
|
62
|
+
"command": "node ./.agents/ACE/scripts/ace/ace-hook-dispatch.mjs",
|
|
63
|
+
"windows": "node .\\\\.agents\\\\ACE\\\\scripts\\\\ace\\\\ace-hook-dispatch.mjs",
|
|
64
|
+
"timeout": 10
|
|
65
|
+
}
|
|
66
|
+
]
|
|
67
|
+
}
|
|
68
|
+
}
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
---
|
|
2
|
+
ace_runtime_version: "1.0.0"
|
|
3
|
+
runtime:
|
|
4
|
+
mode: "interactive"
|
|
5
|
+
profile_name: "default"
|
|
6
|
+
workspace:
|
|
7
|
+
root: ".agents/ACE/.ace/workspaces"
|
|
8
|
+
retention: "delete"
|
|
9
|
+
hooks:
|
|
10
|
+
after_create: null
|
|
11
|
+
before_run: null
|
|
12
|
+
after_run: null
|
|
13
|
+
before_remove: null
|
|
14
|
+
executor:
|
|
15
|
+
command: null
|
|
16
|
+
approval_policy: "on-request"
|
|
17
|
+
thread_sandbox: "workspace-write"
|
|
18
|
+
turn_sandbox_policy: null
|
|
19
|
+
max_turns: 6
|
|
20
|
+
turn_timeout_ms: 300000
|
|
21
|
+
tools:
|
|
22
|
+
registry_path: "agent-state/runtime-tool-specs.json"
|
|
23
|
+
autonomy:
|
|
24
|
+
orchestrator_preflight: true
|
|
25
|
+
recall_context: true
|
|
26
|
+
state_sources: ["agent-state/TASK.md", "agent-state/SCOPE.md", "agent-state/QUALITY_GATES.md", "agent-state/STATUS.md", "agent-state/HANDOFF.json", "agent-state/EVIDENCE_LOG.md"]
|
|
27
|
+
before_run_checks: []
|
|
28
|
+
stop_checks: []
|
|
29
|
+
review_mode: null
|
|
30
|
+
continuity:
|
|
31
|
+
enabled: true
|
|
32
|
+
source_paths: ["agent-state/TASK.md", "agent-state/SCOPE.md", "agent-state/QUALITY_GATES.md", "agent-state/HANDOFF.json", "agent-state/STATUS.md", "agent-state/DECISIONS.md", "agent-state/RISKS.md", "agent-state/EVIDENCE_LOG.md"]
|
|
33
|
+
max_sources: 6
|
|
34
|
+
max_excerpt_chars: 450
|
|
35
|
+
max_total_chars: 2600
|
|
36
|
+
max_status_events: 6
|
|
37
|
+
max_run_ledger_entries: 4
|
|
38
|
+
include_snapshot: true
|
|
39
|
+
tracker:
|
|
40
|
+
kind: "none"
|
|
41
|
+
config: {}
|
|
42
|
+
observability:
|
|
43
|
+
http_enabled: false
|
|
44
|
+
http_port: null
|
|
45
|
+
vericify_bridge:
|
|
46
|
+
enabled: false
|
|
47
|
+
bridge_path: "agent-state/vericify/ace-bridge.json"
|
|
48
|
+
process_post_path: "agent-state/vericify/process-posts.json"
|
|
49
|
+
---
|
|
50
|
+
# ACE Runtime Prompt Template
|
|
51
|
+
|
|
52
|
+
Operate under ACE runtime profile `{{runtime.profile_name}}` in `{{runtime.mode}}` mode.
|
|
53
|
+
|
|
54
|
+
## Runtime Intent
|
|
55
|
+
- Use this profile for ACE execution that must stay aligned to file-backed state and managed workspace policy.
|
|
56
|
+
- Treat front matter as execution policy. If a field is `null`, `false`, or empty, do not invent extra runtime machinery.
|
|
57
|
+
- Preserve objective, boundary, evidence, and transition truth inside ACE artifacts rather than chat-local memory.
|
|
58
|
+
|
|
59
|
+
## Task
|
|
60
|
+
{{task}}
|
|
61
|
+
|
|
62
|
+
## Workspace
|
|
63
|
+
- Managed root: `{{workspace.root}}`
|
|
64
|
+
- Retention: `{{workspace.retention}}`
|
|
65
|
+
|
|
66
|
+
## Executor
|
|
67
|
+
- Command: `{{executor.command}}`
|
|
68
|
+
- Approval policy: `{{executor.approval_policy}}`
|
|
69
|
+
- Thread sandbox: `{{executor.thread_sandbox}}`
|
|
70
|
+
- Max turns: `{{executor.max_turns}}`
|
|
71
|
+
- Turn timeout ms: `{{executor.turn_timeout_ms}}`
|
|
72
|
+
|
|
73
|
+
## Runtime Tools
|
|
74
|
+
- Registry: `{{tools.registry_path}}`
|
|
75
|
+
|
|
76
|
+
## Autonomy
|
|
77
|
+
- Orchestrator preflight: `{{autonomy.orchestrator_preflight}}`
|
|
78
|
+
- Recall context: `{{autonomy.recall_context}}`
|
|
79
|
+
- State sources: `{{autonomy.state_sources}}`
|
|
80
|
+
- Before-run checks: `{{autonomy.before_run_checks}}`
|
|
81
|
+
- Stop checks: `{{autonomy.stop_checks}}`
|
|
82
|
+
- Review mode: `{{autonomy.review_mode}}`
|
|
83
|
+
|
|
84
|
+
## Autonomy Guidance
|
|
85
|
+
- `orchestrator_preflight` means validate ACE truth before substantial work or delegation.
|
|
86
|
+
- `recall_context` means prefer current task, status, handoff, and evidence state over stale thread assumptions.
|
|
87
|
+
- `before_run_checks` are blocking checks. If they fail, stop and surface the failure through ACE evidence and status channels.
|
|
88
|
+
- `stop_checks` are terminal or handoff checks. If they fail, do not continue optimistically.
|
|
89
|
+
- `review_mode` must stay inside existing ACE tools and artifacts; it is an overlay, not a second subsystem.
|
|
90
|
+
|
|
91
|
+
## Continuity
|
|
92
|
+
- Enabled: `{{continuity.enabled}}`
|
|
93
|
+
- Source paths: `{{continuity.source_paths}}`
|
|
94
|
+
- Max sources: `{{continuity.max_sources}}`
|
|
95
|
+
- Max excerpt chars: `{{continuity.max_excerpt_chars}}`
|
|
96
|
+
- Max total chars: `{{continuity.max_total_chars}}`
|
|
97
|
+
- Max status events: `{{continuity.max_status_events}}`
|
|
98
|
+
- Max run-ledger entries: `{{continuity.max_run_ledger_entries}}`
|
|
99
|
+
- Include snapshot: `{{continuity.include_snapshot}}`
|
|
100
|
+
|
|
101
|
+
## Continuity Guidance
|
|
102
|
+
- Continuity packets are derived from current ACE truth; they are not a replacement source of truth.
|
|
103
|
+
- Treat the configured budgets as source-side compaction rules for unattended execution and delegation, including recent status and run-ledger visibility.
|
|
104
|
+
- If continuity is disabled, do not synthesize a replacement packet in chat or hidden state.
|
|
105
|
+
|
|
106
|
+
## ACE Recall
|
|
107
|
+
{{ace_state_recall_md}}
|
|
108
|
+
|
|
109
|
+
## Context Snapshot
|
|
110
|
+
{{ace_context_snapshot_md}}
|
|
111
|
+
|
|
112
|
+
## Continuity Packet
|
|
113
|
+
{{ace_continuity_packet_md}}
|
|
114
|
+
|
|
115
|
+
## Tracker
|
|
116
|
+
- Kind: `{{tracker.kind}}`
|
|
117
|
+
|
|
118
|
+
## Sidecars
|
|
119
|
+
- Vericify bridge enabled: `{{observability.vericify_bridge.enabled}}`
|
|
120
|
+
- Vericify bridge path: `{{observability.vericify_bridge.bridge_path}}`
|
|
121
|
+
- Vericify process-post path: `{{observability.vericify_bridge.process_post_path}}`
|
|
122
|
+
|
|
123
|
+
## Notes
|
|
124
|
+
- Preserve ACE state artifacts as the durable source of truth.
|
|
125
|
+
- Treat Vericify as an optional sidecar, not a required ACE runtime dependency.
|
|
126
|
+
- Treat this template as additive execution guidance for future unattended flows.
|
|
127
|
+
|
|
128
|
+
## Failure Handling
|
|
129
|
+
- When the task contract, evidence, or hooks are contradictory, prefer hold/escalation over optimistic continuation.
|
|
130
|
+
- Record blockers in ACE artifacts with owners and evidence refs before handing off or stopping.
|
|
131
|
+
- If the profile is missing capabilities, keep the gap explicit rather than silently broadening the runtime contract.
|