gentle-pi 3.7.0 → 4.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/README.md +155 -10
- package/assets/agents/gentle-ai-explore.md +13 -6
- package/assets/agents/gentle-ai-verify.md +27 -6
- package/assets/agents/gentle-ai-worker.md +13 -15
- package/assets/install-wizard/index.html +47 -0
- package/assets/install-wizard/wizard.css +1279 -0
- package/assets/install-wizard/wizard.js +951 -0
- package/assets/orchestrator-delegation.md +75 -169
- package/assets/orchestrator-memory.md +12 -26
- package/assets/orchestrator-prompts.md +48 -0
- package/assets/orchestrator-skills.md +1 -1
- package/assets/orchestrator-tracking.md +53 -0
- package/assets/orchestrator-verification.md +28 -0
- package/assets/orchestrator-writer.md +38 -0
- package/assets/orchestrator.md +30 -38
- package/assets/sounds/LICENSE.md +52 -0
- package/assets/sounds/attention.wav +0 -0
- package/assets/sounds/error.wav +0 -0
- package/assets/sounds/success.wav +0 -0
- package/assets/support/strict-tdd-verify.md +4 -266
- package/assets/support/strict-tdd.md +8 -360
- package/bin/engram-guard +9 -0
- package/bin/gentle-shell-install.mjs +302 -0
- package/bin/gentle-shell.mjs +956 -50
- package/contracts/review-provider-contract-mirror/provider-contract.lock.json +7 -7
- package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/bundle/manifest.json +2 -2
- package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/bundle/orchestration/pi.md +16 -4
- package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/generated/provider-capabilities.baseline.json +2 -2
- package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/generated/provider-roles.baseline.json +1 -1
- package/docs/bundled-install.md +397 -0
- package/docs/delegated-verification.md +27 -4
- package/docs/gentle-agents-activity.md +537 -0
- package/docs/gentle-shell-uninstall.md +136 -0
- package/docs/gentle-shell.md +165 -51
- package/docs/install-wizard.md +2040 -0
- package/docs/native-authority-architecture.md +3 -3
- package/docs/permission-modes.md +82 -0
- package/docs/prompt-history.md +280 -0
- package/docs/readme-reference.md +364 -231
- package/docs/render-cache-performance.md +28 -0
- package/docs/sound-notifications-proposal.md +191 -0
- package/docs/sound-notifications.md +114 -0
- package/docs/telemetry.md +1 -1
- package/docs/yolo-mode.md +86 -0
- package/extensions/child-context.ts +35 -0
- package/extensions/child-safety.ts +25 -0
- package/extensions/codegraph-tools.ts +18 -5
- package/extensions/gentle-agents.ts +1093 -326
- package/extensions/gentle-ai.ts +1636 -890
- package/extensions/gentle-herdr-activity.ts +81 -0
- package/extensions/gentle-notifications.ts +104 -0
- package/extensions/gentle-shell.ts +1619 -136
- package/extensions/gentle-stats.ts +101 -0
- package/extensions/gentle-todo.ts +126 -20
- package/extensions/history/atomic-write.ts +38 -0
- package/extensions/history/hide-prompts.ts +183 -0
- package/extensions/history/index.ts +1424 -0
- package/extensions/history/load-shared-history.ts +39 -0
- package/extensions/history/selector-helpers.ts +538 -0
- package/extensions/history/session-scan.ts +233 -0
- package/extensions/history/store.ts +1119 -0
- package/extensions/nan-provider.ts +6 -0
- package/extensions/pi-pretty.ts +39 -3
- package/extensions/quiet-tools.ts +254 -92
- package/extensions/resume-hint.ts +60 -0
- package/extensions/skill-registry.ts +191 -58
- package/extensions/startup-banner.ts +71 -33
- package/lib/agent-assets.ts +604 -0
- package/lib/agent-home.ts +10 -1
- package/lib/agent-model-resolution.ts +80 -0
- package/lib/agent-profile-pin.ts +12 -0
- package/lib/agent-profiles.ts +13 -3
- package/lib/agents-completion-delivery.ts +11 -3
- package/lib/agents-message-delivery.ts +181 -0
- package/lib/agents-messaging.ts +1 -1
- package/lib/agents-protocol.ts +99 -0
- package/lib/agents-runner.ts +180 -107
- package/lib/agents-view.ts +26 -3
- package/lib/agents-widget.ts +16 -9
- package/lib/append-system-prompt.ts +21 -0
- package/lib/auto-permission-classifier.ts +280 -0
- package/lib/auto-permission-runtime.ts +268 -0
- package/lib/background-jobs-tools.ts +202 -0
- package/lib/background-jobs.ts +253 -0
- package/lib/background-monitor.ts +154 -0
- package/lib/bounded-writer-admission.ts +220 -0
- package/lib/builtin-codemode-optout.ts +166 -0
- package/lib/card-content-policy.ts +85 -0
- package/lib/card-style-policy.ts +60 -0
- package/lib/child-context-files.ts +166 -0
- package/lib/child-package-injection.ts +62 -0
- package/lib/codemode-renderer.ts +195 -0
- package/lib/command-palette-catalog.ts +5 -10
- package/lib/command-palette.ts +25 -14
- package/lib/context-threshold.ts +26 -0
- package/lib/destructive-command-guard.ts +144 -0
- package/lib/gentle-ai-binary.ts +109 -4
- package/lib/gentle-ai-elapsed-store.ts +87 -0
- package/lib/gentle-ai-renderer.ts +196 -39
- package/lib/gentle-shell-bundled.ts +517 -0
- package/lib/gentle-shell-launcher.ts +89 -27
- package/lib/gentle-shell-resume-hint.ts +176 -0
- package/lib/gentle-shell-startup-flow.ts +54 -0
- package/lib/gentle-shell-startup-update.ts +92 -0
- package/lib/gentle-shell-uninstall.ts +840 -0
- package/lib/gentle-shell-update-panel.ts +231 -0
- package/lib/herdr-activity.ts +183 -0
- package/lib/history-capture-policy.ts +95 -0
- package/lib/inprocess-reviewer.ts +3 -0
- package/lib/jobs-sidebar-state.ts +20 -0
- package/lib/jobs-view.ts +161 -0
- package/lib/model-price-ratio.ts +83 -0
- package/lib/model-routing-authority.ts +5 -1
- package/lib/nan-provider.ts +249 -0
- package/lib/native-review-cli.ts +242 -180
- package/lib/notification-audio-native.ts +162 -0
- package/lib/notification-audio-windows.ts +399 -0
- package/lib/notification-audio.ts +332 -0
- package/lib/notification-customize.ts +241 -0
- package/lib/notification-events.ts +113 -0
- package/lib/notification-policy.ts +148 -0
- package/lib/notification-pulse-client.ts +367 -0
- package/lib/notification-pulse-protocol.ts +305 -0
- package/lib/notification-pulse-stream.ts +213 -0
- package/lib/notification-pulse-worker.ts +66 -0
- package/lib/notification-scheduler.ts +173 -0
- package/lib/notification-service.ts +202 -0
- package/lib/notification-ui.ts +87 -0
- package/lib/odd-phase-inference.ts +231 -0
- package/lib/odd-phase.ts +141 -0
- package/lib/orchestrator-alias.ts +20 -0
- package/lib/orchestrator-catalog.ts +79 -0
- package/lib/orchestrator-consultation.ts +61 -0
- package/lib/orchestrator-discovery.ts +49 -0
- package/lib/orchestrator-helper-consent.ts +122 -0
- package/lib/orchestrator-helper.ts +167 -0
- package/lib/orchestrator-message-card.ts +105 -0
- package/lib/orchestrator-presence.ts +115 -14
- package/lib/orchestrator-scope.ts +80 -0
- package/lib/orchestrator-state.ts +107 -0
- package/lib/orchestrator-tool-card.ts +280 -0
- package/lib/orchestrator-work-search.ts +218 -0
- package/lib/orchestrator-work.ts +79 -0
- package/lib/overlay-repaint.ts +26 -0
- package/lib/permission-mode-policy.ts +59 -0
- package/lib/pi-tui-keys.ts +53 -0
- package/lib/review-candidate-view-owner.ts +73 -21
- package/lib/review-candidate-view.ts +115 -27
- package/lib/review-compact-contract.ts +2 -2
- package/lib/review-host-relay.ts +7 -2
- package/lib/review-integration-v2.ts +100 -22
- package/lib/review-publication-gate.ts +1 -1
- package/lib/review-reminder-receipt.ts +48 -8
- package/lib/review-risk-assessment.ts +227 -56
- package/lib/review-sidebar-state.ts +224 -0
- package/lib/review-transaction.ts +72 -3
- package/lib/runtime-metrics-children.ts +1 -1
- package/lib/runtime-metrics-native.ts +3 -2
- package/lib/selection-engine.ts +527 -0
- package/lib/session-change-capture.ts +5 -4
- package/lib/session-changes.ts +27 -22
- package/lib/session-messaging-grants.ts +135 -0
- package/lib/session-profile-binding.ts +83 -0
- package/lib/session-profile-freeze.ts +266 -0
- package/lib/session-worktree-registry.ts +87 -9
- package/lib/shell-bar.ts +215 -30
- package/lib/shell-card.ts +287 -18
- package/lib/shell-changes-view.ts +42 -14
- package/lib/shell-changes.ts +86 -71
- package/lib/shell-prompt.ts +102 -6
- package/lib/shell-sidebar-layout.ts +83 -15
- package/lib/shell-sidebar.ts +15 -1
- package/lib/shell-todo.ts +84 -31
- package/lib/shell-usage-view.ts +9 -4
- package/lib/shell-usage.ts +70 -13
- package/lib/stats-collector.ts +381 -0
- package/lib/stats-view.ts +431 -0
- package/lib/status-timing-diagnostics.ts +201 -0
- package/lib/telemetry-trigger.ts +3 -1
- package/lib/theme-customization.ts +52 -0
- package/lib/vim-editor-adapter.ts +383 -0
- package/lib/vim-normal-engine.ts +154 -0
- package/lib/vim-operator-engine.ts +416 -0
- package/lib/vim-policy.ts +49 -0
- package/lib/vim-visual-engine.ts +107 -0
- package/lib/visual-customization-policy.ts +119 -0
- package/lib/visual-customize-view.ts +481 -0
- package/lib/visual-profiles.ts +228 -0
- package/lib/writer-surfaces.ts +162 -0
- package/lib/yolo-session-policy.ts +317 -0
- package/package.json +20 -8
- package/runtime/child-package-injection.mjs +63 -0
- package/runtime/gentle-ai-binary.mjs +109 -4
- package/runtime/gentle-shell-bundled.mjs +518 -0
- package/runtime/gentle-shell-launcher.mjs +87 -25
- package/runtime/gentle-shell-resume-hint.mjs +177 -0
- package/runtime/gentle-shell-startup-flow.mjs +55 -0
- package/runtime/gentle-shell-startup-update.mjs +93 -0
- package/runtime/gentle-shell-uninstall.mjs +841 -0
- package/runtime/gentle-shell-update-panel.mjs +232 -0
- package/runtime/native-review-cli.mjs +239 -177
- package/runtime/review-integration-v2.mjs +100 -22
- package/runtime/review-risk-assessment.mjs +225 -54
- package/runtime/status-timing-diagnostics.mjs +202 -0
- package/runtime/telemetry-trigger.mjs +3 -1
- package/scripts/bootstrap.cmd +255 -0
- package/scripts/bootstrap.sh +168 -0
- package/scripts/build-distribution.mjs +157 -0
- package/scripts/build-installer-bundles.mjs +136 -0
- package/scripts/build-runtime-modules.mjs +8 -0
- package/scripts/bundled-install.mjs +1308 -0
- package/scripts/bundled-wizard.mjs +399 -0
- package/scripts/check-types.mjs +4 -6
- package/scripts/gentle-ai-installer.mjs +83 -35
- package/scripts/install-gentle-ai.mjs +48 -1
- package/scripts/install-tui-mode-setting.mjs +10 -1
- package/scripts/install-wizard-preview.mjs +154 -0
- package/scripts/installer-downloads.mjs +648 -0
- package/scripts/installer-preflight.mjs +387 -0
- package/scripts/installer-probes.mjs +564 -0
- package/scripts/installer-runner.mjs +1102 -0
- package/scripts/installer-server.mjs +881 -0
- package/scripts/installer-windows-artifacts.json +15 -0
- package/scripts/installer-windows.mjs +752 -0
- package/scripts/main-channel.mjs +452 -0
- package/scripts/mirror-odd-routing.mjs +2 -2
- package/scripts/npm-pack-result.mjs +31 -0
- package/scripts/render-cache-performance-worker.mjs +205 -0
- package/scripts/render-cache-performance.mjs +115 -0
- package/scripts/run-test-suite.mjs +90 -0
- package/scripts/test-installer-acceptance.sh +161 -0
- package/scripts/test-packed-runner.mjs +54 -19
- package/scripts/types-baseline.json +2 -92
- package/scripts/verify-package-files.mjs +91 -38
- package/skills/branch-pr/SKILL.md +24 -52
- package/skills/chained-pr/SKILL.md +31 -15
- package/skills/chained-pr/references/chaining-details.md +31 -20
- package/skills/gentle-ai/SKILL.md +16 -21
- package/skills/issue-creation/SKILL.md +8 -2
- package/skills/issue-creation/references/delegated-workflow-actions.md +19 -0
- package/skills/work-unit-commits/SKILL.md +4 -3
- package/tests/agent-home.test.ts +56 -3
- package/tests/agent-model-resolution.test.ts +113 -0
- package/tests/agent-profiles.test.ts +30 -0
- package/tests/agent-risk-escalation.test.ts +123 -0
- package/tests/agents-completion-delivery.test.ts +17 -0
- package/tests/agents-fake-child.ts +2 -2
- package/tests/agents-message-delivery.test.ts +106 -0
- package/tests/agents-protocol.test.ts +97 -0
- package/tests/agents-queries.test.ts +9 -9
- package/tests/agents-runner-process.test.ts +31 -0
- package/tests/agents-runner.test.ts +467 -93
- package/tests/agents-view-thread-identity.test.ts +169 -0
- package/tests/agents-view.test.ts +8 -2
- package/tests/agents-widget.test.ts +154 -15
- package/tests/append-system-prompt-route.test.ts +160 -0
- package/tests/append-system-prompt.test.ts +46 -0
- package/tests/artifact-language.test.ts +19 -213
- package/tests/ask-user-question.test.ts +44 -1
- package/tests/asset-installation-runtime.test.ts +5 -16
- package/tests/auto-mode-invariants.test.ts +258 -0
- package/tests/auto-mode-sdk.test.ts +57 -0
- package/tests/auto-mode.test.ts +49 -0
- package/tests/auto-permission-classifier.test.ts +283 -0
- package/tests/auto-permission-runtime.test.ts +196 -0
- package/tests/autonomous-guard.test.ts +69 -1
- package/tests/background-cache-warming.test.ts +2 -1
- package/tests/background-jobs.test.ts +227 -0
- package/tests/background-monitor.test.ts +195 -0
- package/tests/background-subagents-default-mode.test.ts +28 -5
- package/tests/bounded-stop-contract.test.ts +85 -0
- package/tests/bounded-writer-admission.test.ts +146 -0
- package/tests/branch-pr-skill.test.ts +43 -0
- package/tests/bridge-wake-lifecycle.test.ts +129 -0
- package/tests/bridge-wake-rendering.test.ts +56 -0
- package/tests/build-distribution.test.ts +269 -0
- package/tests/builtin-codemode-optout.test.ts +242 -0
- package/tests/bundled-install.test.ts +1319 -0
- package/tests/bundled-wizard.test.ts +505 -0
- package/tests/card-content-policy.test.ts +68 -0
- package/tests/card-style-policy.test.ts +87 -0
- package/tests/chained-pr-skill.test.ts +124 -0
- package/tests/child-codegraph-bootstrap.test.ts +74 -0
- package/tests/child-context-files.test.ts +255 -0
- package/tests/child-package-entrypoints.test.ts +65 -0
- package/tests/child-package-injection.test.ts +74 -0
- package/tests/child-safety.test.ts +94 -0
- package/tests/child-web-package.test.ts +224 -0
- package/tests/codegraph-tools.test.ts +35 -0
- package/tests/codemode-rendering.test.ts +596 -0
- package/tests/command-palette.test.ts +43 -7
- package/tests/context-threshold.test.ts +31 -0
- package/tests/delegate-for-reason-contract.test.ts +327 -0
- package/tests/delegated-key-learnings-contract.test.ts +3 -78
- package/tests/destructive-command-guard.test.ts +84 -0
- package/tests/devbinary/native-review-parity.devtest.ts +171 -3
- package/tests/devbinary/non-git-subagent-bootstrap.devtest.ts +193 -0
- package/tests/devbinary/pi-host-relay.devtest.ts +173 -3
- package/tests/engram-safety.test.ts +288 -0
- package/tests/fixtures/stats/sessions/--work-alpha--/2026-09-28T10-00-00-000Z_aaa.jsonl +7 -0
- package/tests/fixtures/stats/sessions/--work-alpha--/2026-09-29T23-00-00-000Z_bbb.jsonl +3 -0
- package/tests/fixtures/stats/sessions/--work-alpha--/2026-09-30T08-00-00-000Z_ddd.jsonl +2 -0
- package/tests/fixtures/stats/sessions/--work-alpha--/2026-09-30T09-00-00-000Z_eee.jsonl +3 -0
- package/tests/fixtures/stats/sessions/--work-alpha--/run-1/session.jsonl +2 -0
- package/tests/fixtures/stats/sessions/--work-beta--/2026-09-01T12-00-00-000Z_ccc.jsonl +2 -0
- package/tests/fixtures/stats/user-pi/sessions/--work-alpha--/2026-09-28T10-00-00-000Z_aaa.jsonl +2 -0
- package/tests/fixtures/stats/user-pi/sessions/--work-alpha--/2026-09-29T23-00-00-000Z_bbb.jsonl +4 -0
- package/tests/fixtures/stats/user-pi/sessions/--work-gamma--/2026-09-20T09-00-00-000Z_fff.jsonl +3 -0
- package/tests/generic-agent-tools.test.ts +69 -0
- package/tests/gentle-agents.test.ts +2804 -346
- package/tests/gentle-ai-binary-isolation.test.ts +135 -0
- package/tests/gentle-ai-binary.test.ts +21 -4
- package/tests/gentle-ai-child-guards.test.ts +202 -0
- package/tests/gentle-ai-dev-binary-surfacing.test.ts +125 -15
- package/tests/gentle-ai-elapsed-store.test.ts +68 -0
- package/tests/gentle-ai-installer.test.ts +566 -62
- package/tests/gentle-ai-prompt-model-routing.test.ts +123 -0
- package/tests/gentle-ai-renderer.test.ts +493 -14
- package/tests/gentle-ai.test.ts +1427 -236
- package/tests/gentle-card-text.ts +2 -1
- package/tests/gentle-herdr-activity.test.ts +100 -0
- package/tests/gentle-notifications.test.ts +427 -0
- package/tests/gentle-shell-bin.test.ts +896 -115
- package/tests/gentle-shell-bundled.test.ts +1002 -0
- package/tests/gentle-shell-launcher.test.ts +333 -65
- package/tests/gentle-shell-resume-hint.test.ts +270 -0
- package/tests/gentle-shell-startup-flow.test.ts +75 -0
- package/tests/gentle-shell-startup-update.test.ts +85 -0
- package/tests/gentle-shell-uninstall.test.ts +978 -0
- package/tests/gentle-shell-update-panel.test.ts +158 -0
- package/tests/gentle-shell.test.ts +4216 -119
- package/tests/gentle-stats.test.ts +152 -0
- package/tests/gentle-theme.test.ts +4 -1
- package/tests/gentle-todo.test.ts +333 -10
- package/tests/herdr-activity.test.ts +243 -0
- package/tests/history-agent-home.test.ts +81 -0
- package/tests/history-atomic-write.test.ts +57 -0
- package/tests/history-capture-policy.test.ts +102 -0
- package/tests/history-child-guard.test.ts +70 -0
- package/tests/history-command-registration.test.ts +164 -0
- package/tests/history-dedupe-entries.test.ts +123 -0
- package/tests/history-delete-backfill.test.ts +190 -0
- package/tests/history-delete-confirm.test.ts +460 -0
- package/tests/history-dispatch.test.ts +180 -0
- package/tests/history-drain-hidden.test.ts +110 -0
- package/tests/history-drain-order.test.ts +98 -0
- package/tests/history-expanded-globals.test.ts +62 -0
- package/tests/history-gc.test.ts +832 -0
- package/tests/history-header-layout.test.ts +265 -0
- package/tests/history-hide-prompts.test.ts +275 -0
- package/tests/history-lazy-windowing.test.ts +508 -0
- package/tests/history-legacy-migrate-v2.test.ts +297 -0
- package/tests/history-load-shared-history.test.ts +53 -0
- package/tests/history-max-results-cap.test.ts +76 -0
- package/tests/history-multi-reader.test.ts +203 -0
- package/tests/history-off-path.test.ts +170 -0
- package/tests/history-openflow-integration.test.ts +173 -0
- package/tests/history-overlay-margin.test.ts +326 -0
- package/tests/history-preview-layout.test.ts +93 -0
- package/tests/history-registry.test.ts +143 -0
- package/tests/history-scope-delete.test.ts +411 -0
- package/tests/history-search-caret-keys.test.ts +142 -0
- package/tests/history-seed-bootstrap.test.ts +170 -0
- package/tests/history-seed-regen.test.ts +129 -0
- package/tests/history-selector-windowing.test.ts +94 -0
- package/tests/history-session-scan-directory.test.ts +87 -0
- package/tests/history-session-scan-extract.test.ts +583 -0
- package/tests/history-session-writer.test.ts +351 -0
- package/tests/history-store-paths.test.ts +79 -0
- package/tests/history-tombstone-exact.test.ts +139 -0
- package/tests/history-wheel-mouse.test.ts +242 -0
- package/tests/inprocess-reviewer.test.ts +49 -19
- package/tests/install-gentle-ai-failure.test.ts +69 -0
- package/tests/install-tui-mode-setting.test.ts +15 -0
- package/tests/install-wizard.test.ts +1223 -0
- package/tests/installer-bundles.test.ts +122 -0
- package/tests/installer-posix-bootstrap.test.ts +1201 -0
- package/tests/installer-preflight.test.ts +750 -0
- package/tests/installer-probes.test.ts +1106 -0
- package/tests/installer-runner.test.ts +2158 -0
- package/tests/installer-server.test.ts +1567 -0
- package/tests/installer-windows-bootstrap.test.ts +2410 -0
- package/tests/issue-creation-skill.test.ts +61 -0
- package/tests/jobs-view.test.ts +160 -0
- package/tests/main-channel-upgrade.test.ts +389 -0
- package/tests/main-channel.test.ts +344 -0
- package/tests/maintainer/provider-relay.maintest.ts +13 -12
- package/tests/model-price-ratio.test.ts +116 -0
- package/tests/model-profiles-preservation.test.ts +153 -0
- package/tests/model-routing-authority.test.ts +16 -0
- package/tests/model-routing-package.test.ts +10 -0
- package/tests/nan-provider-runtime.test.ts +156 -0
- package/tests/nan-provider.test.ts +481 -0
- package/tests/native-binary-gate.test.ts +2 -0
- package/tests/native-review-capability-contract.test.ts +13 -1
- package/tests/native-review-cli.test.ts +239 -118
- package/tests/native-review-consent.test.ts +2 -2
- package/tests/native-review-parity-runtime.test.ts +101 -4
- package/tests/native-review-parity.test.ts +12 -48
- package/tests/native-risk-evidence-parity.test.ts +21 -0
- package/tests/no-self-pause-contract.test.ts +87 -0
- package/tests/notification-audio-native.test.ts +281 -0
- package/tests/notification-audio-windows.test.ts +581 -0
- package/tests/notification-audio.test.ts +548 -0
- package/tests/notification-customize.test.ts +655 -0
- package/tests/notification-events.test.ts +115 -0
- package/tests/notification-policy.test.ts +201 -0
- package/tests/notification-pulse-client.test.ts +356 -0
- package/tests/notification-pulse-protocol.test.ts +213 -0
- package/tests/notification-pulse-stream.test.ts +320 -0
- package/tests/notification-scheduler.test.ts +258 -0
- package/tests/notification-ui.test.ts +157 -0
- package/tests/npm-pack-result.test.ts +41 -0
- package/tests/odd-integration.test.ts +76 -0
- package/tests/odd-phase-inference.test.ts +213 -0
- package/tests/odd-phase-loader.test.ts +253 -0
- package/tests/odd-phase.test.ts +307 -0
- package/tests/odd-routing-canonical-ratchet.test.ts +60 -14
- package/tests/odd-routing-contract.test.ts +158 -50
- package/tests/orchestrator-budget.test.ts +43 -45
- package/tests/orchestrator-catalog.test.ts +146 -0
- package/tests/orchestrator-consultation-sdk.test.ts +614 -0
- package/tests/orchestrator-consultation.test.ts +111 -0
- package/tests/orchestrator-discovery.test.ts +241 -0
- package/tests/orchestrator-helper-consent.test.ts +171 -0
- package/tests/orchestrator-helper.test.ts +297 -0
- package/tests/orchestrator-message-card.test.ts +190 -0
- package/tests/orchestrator-presence.test.ts +23 -0
- package/tests/orchestrator-rdd-ownership.test.ts +8 -7
- package/tests/orchestrator-scope.test.ts +107 -0
- package/tests/orchestrator-state.test.ts +114 -0
- package/tests/orchestrator-status-publication-contract.test.ts +34 -0
- package/tests/orchestrator-tool-card.test.ts +398 -0
- package/tests/orchestrator-work-search.test.ts +318 -0
- package/tests/orchestrator-work.test.ts +147 -0
- package/tests/overlay-repaint.test.ts +74 -0
- package/tests/package-manifest.test.ts +344 -123
- package/tests/packed-runner-owned-path.test.ts +80 -0
- package/tests/parallel-reason-contract.test.ts +21 -0
- package/tests/parallel-writer-admission.test.ts +210 -0
- package/tests/permission-mode-policy.test.ts +194 -0
- package/tests/persona-single-channel.test.ts +10 -18
- package/tests/pi-pretty.test.ts +56 -0
- package/tests/provider-defect-handoff.test.ts +7 -14
- package/tests/quiet-bash-runtime.test.ts +76 -0
- package/tests/quiet-tool-rendering.test.ts +569 -187
- package/tests/rdd-aware-verification-contract.test.ts +103 -40
- package/tests/rdd-status-line.test.ts +9 -4
- package/tests/render-cache-performance.test.ts +48 -0
- package/tests/resume-hint-extension.test.ts +122 -0
- package/tests/review-agent-end-preflight.test.ts +237 -21
- package/tests/review-candidate-owner-retry.test.ts +22 -1
- package/tests/review-candidate-view.test.ts +399 -12
- package/tests/review-contract-prompt.test.ts +138 -44
- package/tests/review-controller-lock-status.test.ts +0 -1
- package/tests/review-controller-native-recovery.test.ts +327 -17
- package/tests/review-controller-native-routing.test.ts +866 -6
- package/tests/review-controller-workspace-root.test.ts +206 -6
- package/tests/review-controller.test.ts +2 -2
- package/tests/review-correction-lifecycle.test.ts +2 -1
- package/tests/review-gate.test.ts +7 -4
- package/tests/review-graph-schema.test.ts +2 -2
- package/tests/review-host-relay-routing.test.ts +342 -4
- package/tests/review-host-relay.test.ts +49 -2
- package/tests/review-integration-v2-forward.test.ts +221 -1
- package/tests/review-json-arguments.test.ts +167 -0
- package/tests/review-last-event-closure.test.ts +157 -8
- package/tests/review-ledger-contract.test.ts +14 -37
- package/tests/review-policy-judgment-day.test.ts +1 -1
- package/tests/review-policy-ordinary.test.ts +2 -2
- package/tests/review-relay-transport-agent.test.ts +66 -1
- package/tests/review-reminder-receipt.test.ts +47 -1
- package/tests/review-risk-assessment.test.ts +594 -26
- package/tests/review-session-standing-permission-controller.test.ts +16 -17
- package/tests/review-session-standing-permission-ipc.test.ts +6 -5
- package/tests/review-sidebar-state.test.ts +402 -0
- package/tests/review-test-fixtures.ts +7 -1
- package/tests/review-transaction.test.ts +18 -1
- package/tests/run-test-suite.test.ts +202 -0
- package/tests/runtime-harness.mjs +186 -800
- package/tests/runtime-metrics-children.test.ts +16 -23
- package/tests/runtime-metrics-extension.test.ts +1 -1
- package/tests/runtime-metrics-native.test.ts +31 -1
- package/tests/selection-engine.test.ts +451 -0
- package/tests/session-change-capture.test.ts +10 -10
- package/tests/session-changes-shell.test.ts +242 -48
- package/tests/session-changes.test.ts +17 -24
- package/tests/session-messaging-grants.test.ts +255 -0
- package/tests/session-profile-binding.test.ts +163 -0
- package/tests/session-profile-freeze.test.ts +381 -0
- package/tests/session-subject-routing-contract.test.ts +34 -0
- package/tests/session-worktree-registry.test.ts +134 -2
- package/tests/shell-bar.test.ts +422 -1
- package/tests/shell-card.test.ts +353 -1
- package/tests/shell-changes-view.test.ts +135 -32
- package/tests/shell-changes.test.ts +61 -62
- package/tests/shell-prompt.test.ts +94 -2
- package/tests/shell-render-cache-runtime.test.ts +69 -0
- package/tests/shell-render-cache.test.ts +129 -0
- package/tests/shell-sidebar-layout.test.ts +351 -22
- package/tests/shell-sidebar-scroll-benchmark.test.ts +255 -0
- package/tests/shell-todo.test.ts +207 -3
- package/tests/shell-usage-view.test.ts +28 -1
- package/tests/shell-usage.test.ts +108 -0
- package/tests/short-check-routing-contract.test.ts +49 -0
- package/tests/skill-registry-watcher.test.ts +119 -0
- package/tests/skill-registry.test.ts +357 -2
- package/tests/startup-banner.test.ts +246 -4
- package/tests/startup-home-repo.test.ts +170 -0
- package/tests/stats-collector.test.ts +195 -0
- package/tests/stats-view.test.ts +202 -0
- package/tests/status-timing-diagnostics.test.ts +283 -0
- package/tests/support/orchestrator-modules.ts +19 -0
- package/tests/task-size-routing-contract.test.ts +241 -0
- package/tests/telemetry-trigger.test.ts +107 -20
- package/tests/test-strength-contract.test.ts +124 -0
- package/tests/theme-customization.test.ts +72 -0
- package/tests/verify-agent-contract.test.ts +90 -0
- package/tests/verify-first-launch-contract.test.ts +139 -0
- package/tests/verify-package-files.test.ts +56 -0
- package/tests/vim-editor-adapter-host-resolution.test.ts +37 -0
- package/tests/vim-editor-adapter.test.ts +804 -0
- package/tests/vim-normal-engine.test.ts +101 -0
- package/tests/vim-operator-engine.test.ts +215 -0
- package/tests/vim-policy.test.ts +19 -0
- package/tests/vim-visual-engine.test.ts +52 -0
- package/tests/visual-customization-policy.test.ts +139 -0
- package/tests/visual-customize-view.test.ts +696 -0
- package/tests/visual-profiles.test.ts +87 -0
- package/tests/writer-edit-surface-scope.test.ts +59 -2
- package/tests/writer-surfaces.test.ts +199 -0
- package/tests/yolo-customize.test.ts +271 -0
- package/tests/yolo-mode-runtime.test.ts +188 -0
- package/tests/yolo-mode.test.ts +289 -0
- package/tests/yolo-session-policy.test.ts +59 -0
- package/themes/Gentle.json +2 -1
- package/themes/Gentleman-Cute.json +2 -1
- package/themes/Gentleman-Sexy.json +2 -1
- package/assets/agents/sdd-apply.md +0 -159
- package/assets/agents/sdd-archive.md +0 -228
- package/assets/agents/sdd-design.md +0 -49
- package/assets/agents/sdd-explore.md +0 -48
- package/assets/agents/sdd-init.md +0 -56
- package/assets/agents/sdd-onboard.md +0 -52
- package/assets/agents/sdd-proposal.md +0 -64
- package/assets/agents/sdd-remediate.md +0 -37
- package/assets/agents/sdd-research.md +0 -49
- package/assets/agents/sdd-spec.md +0 -192
- package/assets/agents/sdd-status.md +0 -54
- package/assets/agents/sdd-tasks.md +0 -108
- package/assets/agents/sdd-verify.md +0 -124
- package/assets/chains/sdd-full.chain.md +0 -83
- package/assets/chains/sdd-plan.chain.md +0 -56
- package/assets/chains/sdd-verify.chain.md +0 -43
- package/assets/sdd-orchestrator-workflow.md +0 -319
- package/assets/support/sdd-status-contract.md +0 -77
- package/docs/assets/diagrams/sdd-cycle.svg +0 -14
- package/extensions/sdd-init.ts +0 -816
- package/lib/openspec-deltas.ts +0 -156
- package/lib/sdd-preflight.ts +0 -1066
- package/lib/sdd-research-capabilities.ts +0 -94
- package/lib/sdd-status.ts +0 -26
- package/tests/fixtures/legacy/sdd-research-v2.5.0.md +0 -54
- package/tests/fixtures/native-review-cli/v2.1.3/bind-sdd.json +0 -25
- package/tests/fixtures/v0.10.7/assets/agents/sdd-apply.md +0 -132
- package/tests/openspec-deltas.test.ts +0 -209
- package/tests/sdd-agent-tools.test.ts +0 -156
- package/tests/sdd-archive-replay.test.ts +0 -82
- package/tests/sdd-classical-continuation.test.ts +0 -74
- package/tests/sdd-execution-routing-contract.test.ts +0 -44
- package/tests/sdd-managed-runtime-settlement.test.ts +0 -155
- package/tests/sdd-native-managed-uptake.test.ts +0 -243
- package/tests/sdd-no-attempts-contract.test.ts +0 -15
- package/tests/sdd-odd-integration.test.ts +0 -33
- package/tests/sdd-optional-research.test.ts +0 -124
- package/tests/sdd-planning-routing-contract.test.ts +0 -45
- package/tests/sdd-preflight-rpc-input.test.ts +0 -125
- package/tests/sdd-preflight.test.ts +0 -541
- package/tests/sdd-research-capabilities.test.ts +0 -114
- package/tests/sdd-research-live.test.ts +0 -241
- package/tests/sdd-selection-transport.test.ts +0 -653
- package/tests/sdd-status.test.ts +0 -9
- package/tests/sdd-task-truth.test.ts +0 -43
- /package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/bundle/README.md +0 -0
- /package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/bundle/schemas/lens.schema.json +0 -0
- /package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/bundle/schemas/refuter.schema.json +0 -0
- /package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/bundle/schemas/targeted-validator.schema.json +0 -0
- /package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/bundle/vectors/lens.json +0 -0
- /package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/bundle/vectors/refuter.json +0 -0
- /package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/bundle/vectors/targeted-validator.json +0 -0
|
@@ -1,159 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: sdd-apply
|
|
3
|
-
description: Implement SDD tasks with strict TDD evidence and review workload guard.
|
|
4
|
-
tools:
|
|
5
|
-
- read
|
|
6
|
-
- grep
|
|
7
|
-
- find
|
|
8
|
-
- edit
|
|
9
|
-
- write
|
|
10
|
-
- bash
|
|
11
|
-
- mem_search
|
|
12
|
-
- mem_get_observation
|
|
13
|
-
- mem_save
|
|
14
|
-
- mem_update
|
|
15
|
-
---
|
|
16
|
-
|
|
17
|
-
You are the SDD apply executor for Gentle AI.
|
|
18
|
-
|
|
19
|
-
## Parent Preflight Transport
|
|
20
|
-
|
|
21
|
-
Consume the exact `## SDD Session Preflight` block from parent-provided context. It is parent authority, not a prompt to infer or persist defaults. If absent or malformed, return `blocked` without phase work. A delegated RPC child never confirms or persists SDD choices.
|
|
22
|
-
|
|
23
|
-
## Skill Resolution Contract
|
|
24
|
-
|
|
25
|
-
Use your assigned executor/phase skill for this SDD phase. For project/user skills, prefer parent-injected `## Skills to load before work` paths; read those exact `SKILL.md` files before work. Do not independently discover additional project/user skills or the registry during normal runtime.
|
|
26
|
-
|
|
27
|
-
If skill paths are missing, explicit fallback loading is allowed only as degraded self-healing. Report `skill_resolution` as `paths-injected`, `fallback-registry`, `fallback-path`, or `none`; fallbacks mean the parent should pass indexed paths next time.
|
|
28
|
-
|
|
29
|
-
## Memory Contract
|
|
30
|
-
|
|
31
|
-
Read your own input artifacts directly from the active backend before doing the phase work; do not wait for the parent to inline them. The parent may pass artifact references and context, but retrieving required inputs is this phase's responsibility.
|
|
32
|
-
|
|
33
|
-
Inputs to read (`engram`/`both`: use the injected Engram memory read tools for the topic key, then fetch the full observation; `openspec`: read the file under `openspec/changes/{change}/`):
|
|
34
|
-
- Tasks (required): `sdd/{change}/tasks`
|
|
35
|
-
- Spec (required): `sdd/{change}/spec`
|
|
36
|
-
- Design (required): `sdd/{change}/design`
|
|
37
|
-
- Previous apply-progress (if it exists): `sdd/{change}/apply-progress` — read and MERGE with your new progress; do NOT overwrite.
|
|
38
|
-
|
|
39
|
-
Persist this phase's artifact to the active backend before returning (mandatory):
|
|
40
|
-
- `engram`/`both`: call the injected Engram save tool with title and `topic_key` `"sdd/{change}/apply-progress"`, `type: "architecture"`, `project` from context, and `capture_prompt: false` when the tool schema supports it (omit the field if an older schema rejects it).
|
|
41
|
-
- Also update the tasks artifact checkboxes via the injected Engram update tool (`engram`/`both`) or file edit (`openspec`/`both`).
|
|
42
|
-
- `openspec` / `both`: write/update the apply-progress and tasks files under `openspec/changes/{change}/`.
|
|
43
|
-
- `none`: return progress inline.
|
|
44
|
-
|
|
45
|
-
For `both`, read back each selected backend and report its actual result. File and Engram writes are not atomic: retain successful writes and cumulative progress, disclose failed or divergent copies, and do not claim complete persistence or switch stores to hide a failure.
|
|
46
|
-
|
|
47
|
-
Never claim persistence you did not perform.
|
|
48
|
-
|
|
49
|
-
## Status and Action Context Guard
|
|
50
|
-
|
|
51
|
-
Before writing code, consume validated native `gentle-ai.sdd-status` v2 from the parent. If missing, request native read-only status for the selected change and canonical workspace. Never reconstruct readiness locally or from Engram artifacts; native `nextRecommended` and `phaseInstructions` own the route for every store. Reject malformed or unsupported actions before work, without prose inference or fallback.
|
|
52
|
-
|
|
53
|
-
Read artifacts from the selected backend for implementation context, not as replacement lifecycle authority. Status grants no writes. Explicit continuation may prepare only the exact canonical marker path confirmed by the current human; denial, cancellation, missing UI, and workspace mismatch prohibit mutation. Marker preparation grants no source roots or persistent authority.
|
|
54
|
-
|
|
55
|
-
Stop with `blocked` before editing if:
|
|
56
|
-
|
|
57
|
-
- active change selection is missing or ambiguous;
|
|
58
|
-
- native apply dependency is blocked;
|
|
59
|
-
- required apply artifacts are missing (confirmed by artifact store);
|
|
60
|
-
- `actionContext.mode: workspace-planning` and no `allowedEditRoots` are provided;
|
|
61
|
-
- any target file is outside the authoritative workspace or allowed edit roots.
|
|
62
|
-
|
|
63
|
-
If status says `applyState: all_done`, do not edit. Report that implementation is complete and return the fresh native recommendation (classically `archive`; an older provider may still require `verify`). Do not recommend apply again after all implementation tasks are complete.
|
|
64
|
-
|
|
65
|
-
## Before Writing Code
|
|
66
|
-
|
|
67
|
-
Read structured status, proposal, specs, design, tasks, existing code, tests, `apply-progress.md` if present, and `openspec/config.yaml` when present.
|
|
68
|
-
|
|
69
|
-
## Review Workload Gate
|
|
70
|
-
|
|
71
|
-
Before implementing, inspect `tasks.md` for `Review Workload Forecast` and these guard lines:
|
|
72
|
-
|
|
73
|
-
```text
|
|
74
|
-
Decision needed before apply: Yes|No
|
|
75
|
-
Chained PRs recommended: Yes|No
|
|
76
|
-
Chain strategy: stacked-to-main|feature-branch-chain|size-exception|pending
|
|
77
|
-
400-line budget risk: Low|Medium|High
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
If any of these are true:
|
|
81
|
-
|
|
82
|
-
- `Decision needed before apply: Yes`
|
|
83
|
-
- `Chained PRs recommended: Yes`
|
|
84
|
-
- `400-line budget risk: High`
|
|
85
|
-
|
|
86
|
-
then continue only when the parent prompt gives a resolved delivery path:
|
|
87
|
-
|
|
88
|
-
- `auto-chain` or chosen chained/stacked PR mode: implement only the assigned work-unit slice and report the PR boundary.
|
|
89
|
-
- `exception-ok` or `size:exception`: continue only if the prompt explicitly says the maintainer accepts the exception.
|
|
90
|
-
- `single-pr` above budget: continue only after explicit `size:exception` approval.
|
|
91
|
-
|
|
92
|
-
If no delivery decision is provided, STOP before writing code and return `blocked` with the exact decision needed.
|
|
93
|
-
|
|
94
|
-
The budget constrains how work is sliced, never the code itself. Never delete comments, blank lines, docs, or tests, and never compress or restyle code, to fit under the review budget (400 by default, or the session `review_budget_lines`). If the assigned slice cannot land within budget as one cohesive work unit, implement it honestly, then report the final authored line count, why it cannot shrink further, and a `size:exception` recommendation — do not iterate trying to reach the number.
|
|
95
|
-
|
|
96
|
-
## Strict TDD Gate
|
|
97
|
-
|
|
98
|
-
If `openspec/config.yaml` declares strict TDD and a test runner, or the parent prompt says strict TDD is active:
|
|
99
|
-
|
|
100
|
-
1. Read the global Gentle AI strict-TDD support guidance when available. If a project-local `.pi/gentle-ai/support/strict-tdd.md` exists, treat it as an override.
|
|
101
|
-
2. Follow RED → GREEN → TRIANGULATE → REFACTOR for every assigned task.
|
|
102
|
-
3. Do not write production code before a failing test or equivalent RED test is written.
|
|
103
|
-
4. Run relevant focused tests during GREEN and after refactors.
|
|
104
|
-
5. Write a `TDD Cycle Evidence` table in `apply-progress.md`.
|
|
105
|
-
|
|
106
|
-
If strict TDD is active and no external support file is available, follow the RED/GREEN/TRIANGULATE/REFACTOR contract from this prompt. Do not silently fall back to standard mode.
|
|
107
|
-
|
|
108
|
-
## Task Completion Boundary
|
|
109
|
-
|
|
110
|
-
Use native task progress and authorized scope to select and report the assigned work. Preserve historical ownership comments and task artifacts; do not parse their spelling or position into a local admission gate. Check off only actually completed implementation work with applicable proof, and leave unfinished work unchecked.
|
|
111
|
-
|
|
112
|
-
After implementation completion, return fresh native status to the parent: classically archive, with explicitly optional verification. Never bypass an older provider that still selects verify. Archive composes applicable specs and records closure without a post-SDD RDD dependency.
|
|
113
|
-
|
|
114
|
-
## Persisted Task Checkbox Contract
|
|
115
|
-
|
|
116
|
-
`sdd-apply` owns persisted task completion. In all modes, including strict TDD, mark each completed implementation task in the persisted tasks artifact immediately after completion:
|
|
117
|
-
|
|
118
|
-
- `openspec` / `both`: update `openspec/changes/{change}/tasks.md` from `- [ ]` to `- [x]` for completed tasks.
|
|
119
|
-
- `engram` / `both`: update the `sdd/{change}/tasks` observation when memory tools are explicitly available.
|
|
120
|
-
- `none`: report task progress inline and state that no persisted task artifact was updated.
|
|
121
|
-
|
|
122
|
-
Internal todos and `apply-progress.md` are not enough completion evidence.
|
|
123
|
-
|
|
124
|
-
Before returning, re-read the persisted tasks artifact and confirm every task you report as completed is visibly marked `- [x]`. If the artifact still shows a completed task as `- [ ]`, fix the checkbox before returning or return `blocked` explaining why it cannot be reconciled. Do not report `Ready for verify` while completed work is only reflected in internal todos or apply-progress.
|
|
125
|
-
|
|
126
|
-
## Standard Mode
|
|
127
|
-
|
|
128
|
-
If strict TDD is not active, implement assigned tasks against specs and design, update persisted task checkboxes as work completes, and record verification evidence.
|
|
129
|
-
|
|
130
|
-
## Apply Progress
|
|
131
|
-
|
|
132
|
-
Update `openspec/changes/{change}/apply-progress.md` cumulatively. If previous progress exists, merge it with new progress; never overwrite completed work.
|
|
133
|
-
|
|
134
|
-
Include:
|
|
135
|
-
|
|
136
|
-
- completed tasks and the matching persisted task checkbox updates;
|
|
137
|
-
- files changed;
|
|
138
|
-
- test commands run;
|
|
139
|
-
- TDD evidence when strict TDD is active;
|
|
140
|
-
- deviations from design;
|
|
141
|
-
- remaining tasks, including exact unchecked `- [ ]` lines when any remain;
|
|
142
|
-
- workload / PR boundary;
|
|
143
|
-
- structured status consumed or produced, including `actionContext` warnings.
|
|
144
|
-
|
|
145
|
-
Do NOT launch child subagents. Parent/orchestrator owns delegation. Never commit unless the user explicitly asks.
|
|
146
|
-
|
|
147
|
-
Rules:
|
|
148
|
-
|
|
149
|
-
- ALWAYS consume or produce structured status before implementation; do not infer readiness from conversation alone.
|
|
150
|
-
- STOP on unsafe `actionContext` or edit roots.
|
|
151
|
-
- Mark completed tasks in the persisted tasks artifact as you go, not only at the end.
|
|
152
|
-
- Before returning, re-read the persisted tasks artifact and ensure completed tasks are visibly marked `- [x]`; internal todos are not completion evidence.
|
|
153
|
-
|
|
154
|
-
Return the standard phase envelope with status, executive_summary, artifacts, next_recommended, risks, and skill_resolution.
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
## Key Learnings Closing
|
|
158
|
-
|
|
159
|
-
Close your final report text with a `## Key Learnings` block (no trailing colon). Use 1–5 numbered items, each a standalone factual sentence of at least 20 characters and at least 4 words. This applies to final report text only — not intermediate tool output or saved artifact content. The Engram memory provider automatically extracts and persists these items as passive capture; you do not parse the block or invoke passive-capture tools yourself. Omit the block when there is genuinely no reusable learning; no filler or speculation. This closing block is separate from explicit `mem_save` artifact/decision persistence.
|
|
@@ -1,228 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: sdd-archive
|
|
3
|
-
description: Archive a completed SDD change into OpenSpec source specs.
|
|
4
|
-
tools:
|
|
5
|
-
- read
|
|
6
|
-
- grep
|
|
7
|
-
- find
|
|
8
|
-
- write
|
|
9
|
-
- edit
|
|
10
|
-
- bash
|
|
11
|
-
- mem_search
|
|
12
|
-
- mem_get_observation
|
|
13
|
-
- mem_save
|
|
14
|
-
---
|
|
15
|
-
|
|
16
|
-
You are the SDD archive executor for Gentle AI.
|
|
17
|
-
|
|
18
|
-
## Parent Preflight Transport
|
|
19
|
-
|
|
20
|
-
Consume the exact `## SDD Session Preflight` block from parent-provided context. It is parent authority, not a prompt to infer or persist defaults. If absent or malformed, return `blocked` without phase work. A delegated RPC child never confirms or persists SDD choices.
|
|
21
|
-
|
|
22
|
-
## Skill Resolution Contract
|
|
23
|
-
|
|
24
|
-
Use your assigned executor/phase skill for this SDD phase. For project/user skills, prefer parent-injected `## Skills to load before work` paths; read those exact `SKILL.md` files before work. Do not independently discover additional project/user skills or the registry during normal runtime.
|
|
25
|
-
|
|
26
|
-
If skill paths are missing, explicit fallback loading is allowed only as degraded self-healing. Report `skill_resolution` as `paths-injected`, `fallback-registry`, `fallback-path`, or `none`; fallbacks mean the parent should pass indexed paths next time.
|
|
27
|
-
|
|
28
|
-
## Memory Contract
|
|
29
|
-
|
|
30
|
-
Read your own input artifacts directly from the active backend before doing the phase work; do not wait for the parent to inline them. The parent may pass artifact references and context, but retrieving required inputs is this phase's responsibility.
|
|
31
|
-
|
|
32
|
-
Inputs to read (`engram`/`both`: use the injected Engram memory read tools for the topic key, then fetch the full observation; `openspec`: read the files under `openspec/changes/{change}/`):
|
|
33
|
-
- All change artifacts: `sdd/{change}/proposal`, `sdd/{change}/spec`, `sdd/{change}/design`, `sdd/{change}/tasks`, `sdd/{change}/apply-progress`, `sdd/{change}/verify-report`, and `sdd/{change}/sync-report` if present.
|
|
34
|
-
|
|
35
|
-
Persist this phase's artifact to the active backend before returning (mandatory):
|
|
36
|
-
- `engram`/`both`: call the injected Engram save tool with title and `topic_key` `"sdd/{change}/archive-report"`, `type: "architecture"`, `project` from context, and `capture_prompt: false` when the tool schema supports it (omit the field if an older schema rejects it).
|
|
37
|
-
- `openspec`: write the archive report and perform the file moves described in the sections below.
|
|
38
|
-
- `none`: return the archive report inline.
|
|
39
|
-
|
|
40
|
-
Never claim persistence you did not perform.
|
|
41
|
-
|
|
42
|
-
## Purpose
|
|
43
|
-
|
|
44
|
-
Archive a completed SDD change. In file-backed modes, archive composes applicable delta specs into canonical specs, then moves the active change folder to the dated archive. In Engram-only mode, this records traceability without creating a canonical merge layer.
|
|
45
|
-
|
|
46
|
-
## Status and Action Context Guard
|
|
47
|
-
|
|
48
|
-
Before archive work, consume structured SDD status from the parent prompt. If missing, produce the same fields using this lookup order: project override `.pi/gentle-ai/support/sdd-status-contract.md`, then globally installed `~/.pi/agent/gentle-ai/support/sdd-status-contract.md`, then the embedded status contract. Do not use `assets/support/...` as a runtime path; that is only the package source path before installation.
|
|
49
|
-
|
|
50
|
-
Consume native `gentle-ai.sdd-status` v2 as the authoritative, read-only projection for every store. Do not recompute archive readiness from OpenSpec or Engram artifacts, fabricate status, or use a store-specific bypass. If native status is unavailable, malformed, or ambiguous, stop and report it; only its selected action, dependency, and `actionContext` can authorize archive work.
|
|
51
|
-
|
|
52
|
-
Stop with `blocked` if:
|
|
53
|
-
|
|
54
|
-
- active change selection is missing or ambiguous;
|
|
55
|
-
- `actionContext.mode: workspace-planning` and no `allowedEditRoots` are provided;
|
|
56
|
-
- archive paths, spec composition writes, or move targets are outside the authoritative workspace or allowed edit roots.
|
|
57
|
-
|
|
58
|
-
Archive does not own normal task completion. `sdd-apply` owns persisted task checkbox updates; `sdd-verify` and `sdd-archive` validate them.
|
|
59
|
-
|
|
60
|
-
## Archive Preconditions
|
|
61
|
-
|
|
62
|
-
Before archiving, read:
|
|
63
|
-
|
|
64
|
-
- `openspec/changes/{change}/proposal.md`
|
|
65
|
-
- `openspec/changes/{change}/specs/` or memory artifact `sdd/{change}/spec`
|
|
66
|
-
- `openspec/changes/{change}/design.md`
|
|
67
|
-
- `openspec/changes/{change}/tasks.md`
|
|
68
|
-
- `openspec/changes/{change}/verify-report.md` when verification was run
|
|
69
|
-
- `openspec/changes/{change}/sync-report.md` when file-backed sync was run
|
|
70
|
-
- `openspec/config.yaml` when present
|
|
71
|
-
|
|
72
|
-
Stop with `blocked` if:
|
|
73
|
-
|
|
74
|
-
- a current verification report records unresolved `FAIL`, `BLOCKED`, `CRITICAL`, or verification blockers; optional verification is not a missing-artifact gate;
|
|
75
|
-
- required artifacts are missing;
|
|
76
|
-
- tasks are incomplete and no explicit stale-checkbox reconciliation proof is recorded;
|
|
77
|
-
- `tasks.md` or the memory tasks artifact contains unchecked implementation task markers matching `^\s*- \[ \]` and no explicit stale-checkbox reconciliation instruction names those exact unchecked tasks with proof from apply-progress and verify-report;
|
|
78
|
-
- a legacy flat `openspec/changes/{change}/spec.md` is the only spec artifact in file-backed mode;
|
|
79
|
-
- the merge would be destructive and the parent prompt does not include explicit confirmation.
|
|
80
|
-
|
|
81
|
-
## Final Task Completion Gate
|
|
82
|
-
|
|
83
|
-
Immediately before any archive-time spec composition, archive report write, or folder move, re-read the persisted tasks artifact:
|
|
84
|
-
|
|
85
|
-
- `openspec` / `both`: `openspec/changes/{change}/tasks.md`
|
|
86
|
-
- `engram`: `sdd/{change}/tasks` observation when memory tools are explicitly available
|
|
87
|
-
|
|
88
|
-
If any implementation task remains unchecked (`- [ ]`):
|
|
89
|
-
|
|
90
|
-
1. STOP with status `blocked`.
|
|
91
|
-
2. Do not perform archive-time spec composition.
|
|
92
|
-
3. Do not move the change to `openspec/changes/archive/`.
|
|
93
|
-
4. Report the exact unchecked lines and state that `sdd-apply` must be rerun or corrected so it marks completed tasks in the persisted tasks artifact.
|
|
94
|
-
|
|
95
|
-
Only perform a mechanical checkbox repair during archive when the parent prompt explicitly instructs stale-checkbox reconciliation and `apply-progress.md` plus `verify-report.md` prove every unchecked task is complete. If this exceptional repair is performed, record the exact reconciliation reason and lines changed in `archive-report.md`.
|
|
96
|
-
|
|
97
|
-
CRITICAL verification issues always block archive and cannot be overridden. Explicit recorded exceptions are limited to non-critical partial archives or stale-checkbox reconciliation when apply-progress and verify-report prove completion. Missing proposal/spec/design artifacts require an explicit intentional partial-archive approval.
|
|
98
|
-
|
|
99
|
-
## Artifact Store Modes
|
|
100
|
-
|
|
101
|
-
- `openspec`: compose applicable filesystem delta specs, then perform the archive move.
|
|
102
|
-
- `both` / `hybrid`: compose applicable filesystem delta specs, move the archive, and save the archive report to memory when tools are available.
|
|
103
|
-
- `engram`: skip filesystem composition/archive. Engram is working memory; do not create or require `sdd/canonical/<domain>/spec` topics. Record proposal/spec/design/tasks and available verification observation IDs in the archive report.
|
|
104
|
-
- `none`: return a closure summary only.
|
|
105
|
-
|
|
106
|
-
## Archive-Time Spec Composition
|
|
107
|
-
|
|
108
|
-
Archive owns applicable file-backed spec composition; no separate sync phase or successful sync-report artifact is required. A legacy sync report is history, not permission to skip inspecting current deltas and canonical specs.
|
|
109
|
-
|
|
110
|
-
Do not start archive-time spec composition until the Final Task Completion Gate passes.
|
|
111
|
-
|
|
112
|
-
For each domain spec in:
|
|
113
|
-
|
|
114
|
-
```text
|
|
115
|
-
openspec/changes/{change}/specs/{domain}/spec.md
|
|
116
|
-
```
|
|
117
|
-
|
|
118
|
-
sync into:
|
|
119
|
-
|
|
120
|
-
```text
|
|
121
|
-
openspec/specs/{domain}/spec.md
|
|
122
|
-
```
|
|
123
|
-
|
|
124
|
-
### Resume prior composition
|
|
125
|
-
|
|
126
|
-
Before writing, inspect current deltas and canonical content together with existing change-specific artifacts and relevant repository history when available. A legacy `sync-report.md`, prior archive report, or apply-progress may identify domains, canonical files, operation names, recorded checks and destructive approvals. Read the actual supporting content; a PASS label or absence alone is not proof that this change applied an operation. Do not require a legacy report when ordinary artifacts/history already establish the result.
|
|
127
|
-
|
|
128
|
-
Classify each operation as already applied, pending, or unresolved:
|
|
129
|
-
|
|
130
|
-
| Operation | Already applied | Pending or unresolved |
|
|
131
|
-
| --- | --- | --- |
|
|
132
|
-
| ADDED / MODIFIED | The full current requirement block matches the intended delta result, and existing artifacts/history corroborate this change's application of that same operation. | Apply only a demonstrably pending operation. An existing ADDED target or differing current content after recorded application is unresolved; do not overwrite later work. |
|
|
133
|
-
| REMOVED | The target is absent and corroborating history establishes that the same requirement was removed by this change using the current delta, with its recorded destructive approval. | An existing target is pending only when its content and history agree with the intended removal; a missing target without corroborating history is unresolved. |
|
|
134
|
-
|
|
135
|
-
For mixed or interrupted composition, reconcile each operation separately; a domain-level success claim cannot skip pending operations. Apply only pending operations, leaving already-applied effects and unrelated canonical content unchanged. The strict delta helper rejects repeated ADDED/REMOVED operations: do not replay the full delta against an already-composed canonical spec or weaken that helper to treat absence as success.
|
|
136
|
-
|
|
137
|
-
Stop and report any unresolved operation before any canonical write or archive move. Name the affected requirement and the missing or conflicting fact; request clarification rather than fabricate application history. Current same-domain collision checks and explicit composition/archive order still apply, including to already-applied effects. Existing task completion, native readiness, grants/confinement and archive-destination checks also still apply. Destructive approval for a prior operation does not authorize new or changed destructive writes.
|
|
138
|
-
|
|
139
|
-
Record already-applied, pending and unresolved operations with supporting artifact/history references and current-content checks in the ordinary archive report. Do not create a new report schema, hash inventory, token or mandatory attestation; do not mutate historical sync reports. This reconciliation applies only to file-backed composition, not to an Engram-only canonical merge layer.
|
|
140
|
-
|
|
141
|
-
### New canonical spec
|
|
142
|
-
|
|
143
|
-
If `openspec/specs/{domain}/spec.md` does not exist, treat the change spec as a full domain spec and copy it to the canonical path.
|
|
144
|
-
|
|
145
|
-
### Existing canonical spec
|
|
146
|
-
|
|
147
|
-
If the canonical spec exists, apply operation sections by requirement name:
|
|
148
|
-
|
|
149
|
-
```text
|
|
150
|
-
## ADDED Requirements -> append each requirement to the canonical Requirements section
|
|
151
|
-
## MODIFIED Requirements -> replace the full matching canonical requirement block
|
|
152
|
-
## REMOVED Requirements -> delete the full matching canonical requirement block
|
|
153
|
-
```
|
|
154
|
-
|
|
155
|
-
Merge rules:
|
|
156
|
-
|
|
157
|
-
- Match requirements by exact `### Requirement: {Name}` heading.
|
|
158
|
-
- Preserve every canonical requirement not mentioned by the delta.
|
|
159
|
-
- Preserve heading hierarchy and Markdown formatting.
|
|
160
|
-
- Fail or block if a MODIFIED requirement is missing, or a REMOVED target is missing without corroborating history under Resume prior composition; only a proven already-applied operation is excluded from the pending delta.
|
|
161
|
-
- If another active change under `openspec/changes/*/specs/{domain}/spec.md` touches the same domain, report the collision and require the parent's explicit composition/archive order before writing.
|
|
162
|
-
- Block on unsupported `## RENAMED Requirements`; require a corrected ADDED/MODIFIED/REMOVED delta rather than improvising.
|
|
163
|
-
- Preserve completed `dependsOn` and archive-history checks from native status; never replace them with local readiness.
|
|
164
|
-
- Report all ADDED/MODIFIED/REMOVED requirement names in the archive report.
|
|
165
|
-
|
|
166
|
-
## Destructive Merge Guard
|
|
167
|
-
|
|
168
|
-
Before applying REMOVED requirements or large MODIFIED blocks:
|
|
169
|
-
|
|
170
|
-
- list affected requirement names;
|
|
171
|
-
- summarize the approximate removed/replaced line count;
|
|
172
|
-
- warn the parent/orchestrator;
|
|
173
|
-
- continue only if the parent prompt records explicit approval for the destructive sync.
|
|
174
|
-
|
|
175
|
-
Verification alone is not approval for destructive canonical spec changes.
|
|
176
|
-
|
|
177
|
-
Never silently drop scenarios from a MODIFIED requirement. If a MODIFIED delta appears partial, block and ask for a corrected full requirement block.
|
|
178
|
-
|
|
179
|
-
## Move to Archive
|
|
180
|
-
|
|
181
|
-
After applicable pending composition succeeds and already-applied effects are reconciled, move:
|
|
182
|
-
|
|
183
|
-
```text
|
|
184
|
-
openspec/changes/{change}/
|
|
185
|
-
-> openspec/changes/archive/YYYY-MM-DD-{change}/
|
|
186
|
-
```
|
|
187
|
-
|
|
188
|
-
Block rather than overwrite an existing archive destination. Check canonical and archive paths against authoritative roots, including resolved symlink targets, before writes or moves.
|
|
189
|
-
|
|
190
|
-
Use today's ISO date. Create `openspec/changes/archive/` if missing. The archive is an audit trail; never delete or modify archived changes silently.
|
|
191
|
-
|
|
192
|
-
## Archive Report
|
|
193
|
-
|
|
194
|
-
Archive report handling depends on mode:
|
|
195
|
-
|
|
196
|
-
- `openspec`: write `openspec/changes/{change}/archive-report.md` before moving the change.
|
|
197
|
-
- `both` / `hybrid`: write the file report before moving the change and save `sdd/{change}/archive-report` to memory when tools are available.
|
|
198
|
-
- `engram`: save or return the archive report with observation-ID traceability only; do not perform filesystem composition/archive.
|
|
199
|
-
|
|
200
|
-
Include:
|
|
201
|
-
|
|
202
|
-
- pass/fail archive status;
|
|
203
|
-
- artifacts read;
|
|
204
|
-
- domains synced;
|
|
205
|
-
- ADDED/MODIFIED/REMOVED requirement names;
|
|
206
|
-
- active same-domain change warnings;
|
|
207
|
-
- unchecked implementation task lines or confirmation that no `- [ ]` implementation task boxes remain;
|
|
208
|
-
- non-critical partial archive approval or stale-checkbox reconciliation details when present;
|
|
209
|
-
- structured status and `actionContext` findings;
|
|
210
|
-
- destructive merge approvals or blockers;
|
|
211
|
-
- archived path;
|
|
212
|
-
- memory observation IDs when using Engram or `both` / `hybrid` mode.
|
|
213
|
-
|
|
214
|
-
## Rules
|
|
215
|
-
|
|
216
|
-
- Read an existing verify report when present; a missing optional report is not a blocker.
|
|
217
|
-
- Re-read the persisted tasks artifact before any spec composition or move; block on unchecked implementation tasks unless explicit stale-checkbox reconciliation is recorded and backed by apply-progress/verify-report proof.
|
|
218
|
-
- Compose applicable file-backed specs inside archive before moving the change; retain explicit consent for destructive writes, not a separate permission prompt for ordinary composition.
|
|
219
|
-
- Preserve audit trail; never delete active artifacts silently.
|
|
220
|
-
- Apply `rules.archive` and applicable canonical-composition `rules.sync` from `openspec/config.yaml` when present.
|
|
221
|
-
- Do NOT launch child subagents. Parent/orchestrator owns delegation.
|
|
222
|
-
|
|
223
|
-
Return the standard phase envelope with status, executive_summary, artifacts, next_recommended, risks, and skill_resolution.
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
## Key Learnings Closing
|
|
227
|
-
|
|
228
|
-
Close your final report text with a `## Key Learnings` block (no trailing colon). Use 1–5 numbered items, each a standalone factual sentence of at least 20 characters and at least 4 words. This applies to final report text only — not intermediate tool output or saved artifact content. The Engram memory provider automatically extracts and persists these items as passive capture; you do not parse the block or invoke passive-capture tools yourself. Omit the block when there is genuinely no reusable learning; no filler or speculation. This closing block is separate from explicit `mem_save` artifact/decision persistence.
|
|
@@ -1,49 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: sdd-design
|
|
3
|
-
description: Design the technical approach for an SDD change.
|
|
4
|
-
tools:
|
|
5
|
-
- read
|
|
6
|
-
- grep
|
|
7
|
-
- find
|
|
8
|
-
- write
|
|
9
|
-
- edit
|
|
10
|
-
- mem_search
|
|
11
|
-
- mem_get_observation
|
|
12
|
-
- mem_save
|
|
13
|
-
---
|
|
14
|
-
|
|
15
|
-
You are the SDD design executor for Gentle AI.
|
|
16
|
-
|
|
17
|
-
## Parent Preflight Transport
|
|
18
|
-
|
|
19
|
-
Consume the exact `## SDD Session Preflight` block from parent-provided context. It is parent authority, not a prompt to infer or persist defaults. If absent or malformed, return `blocked` without phase work. A delegated RPC child never confirms or persists SDD choices.
|
|
20
|
-
|
|
21
|
-
## Skill Resolution Contract
|
|
22
|
-
|
|
23
|
-
Use your assigned executor/phase skill for this SDD phase. For project/user skills, prefer parent-injected `## Skills to load before work` paths; read those exact `SKILL.md` files before work. Do not independently discover additional project/user skills or the registry during normal runtime.
|
|
24
|
-
|
|
25
|
-
If skill paths are missing, explicit fallback loading is allowed only as degraded self-healing. Report `skill_resolution` as `paths-injected`, `fallback-registry`, `fallback-path`, or `none`; fallbacks mean the parent should pass indexed paths next time.
|
|
26
|
-
|
|
27
|
-
- Read proposal, specs, and relevant code before designing.
|
|
28
|
-
- Document decisions, data flow, file changes, contracts, tests, and rollout.
|
|
29
|
-
- Keep design centered on `packages/coding-agent` unless scope explicitly expands.
|
|
30
|
-
- Do NOT launch child subagents. Parent/orchestrator owns delegation.
|
|
31
|
-
- Return the SDD result contract.
|
|
32
|
-
## Memory Contract
|
|
33
|
-
|
|
34
|
-
Read your own input artifacts directly from the active backend before doing the phase work; do not wait for the parent to inline them. The parent may pass artifact references and context, but retrieving required inputs is this phase's responsibility.
|
|
35
|
-
|
|
36
|
-
Inputs to read (`engram`/`both`: use the injected Engram memory read tools for the topic key, then fetch the full observation; `openspec`: read the file under `openspec/changes/{change}/`):
|
|
37
|
-
- Proposal (required): `sdd/{change}/proposal`
|
|
38
|
-
|
|
39
|
-
Persist this phase's artifact to the active backend before returning (mandatory):
|
|
40
|
-
- `engram`/`both`: call the injected Engram save tool with title and `topic_key` `"sdd/{change}/design"`, `type: "architecture"`, `project` from context, and `capture_prompt: false` when the tool schema supports it (omit the field if an older schema rejects it).
|
|
41
|
-
- `openspec`: write/update `openspec/changes/{change}/design.md`.
|
|
42
|
-
- `none`: return the design inline.
|
|
43
|
-
|
|
44
|
-
Never claim persistence you did not perform.
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
## Key Learnings Closing
|
|
48
|
-
|
|
49
|
-
Close your final report text with a `## Key Learnings` block (no trailing colon). Use 1–5 numbered items, each a standalone factual sentence of at least 20 characters and at least 4 words. This applies to final report text only — not intermediate tool output or saved artifact content. The Engram memory provider automatically extracts and persists these items as passive capture; you do not parse the block or invoke passive-capture tools yourself. Omit the block when there is genuinely no reusable learning; no filler or speculation. This closing block is separate from explicit `mem_save` artifact/decision persistence.
|
|
@@ -1,48 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: sdd-explore
|
|
3
|
-
description: Explore an SDD change idea before proposal.
|
|
4
|
-
tools:
|
|
5
|
-
- read
|
|
6
|
-
- grep
|
|
7
|
-
- find
|
|
8
|
-
- codegraph
|
|
9
|
-
- edit
|
|
10
|
-
- write
|
|
11
|
-
- mem_save
|
|
12
|
-
---
|
|
13
|
-
|
|
14
|
-
You are the SDD explore executor for Gentle AI.
|
|
15
|
-
|
|
16
|
-
## Parent Preflight Transport
|
|
17
|
-
|
|
18
|
-
Consume the exact `## SDD Session Preflight` block from parent-provided context. It is parent authority, not a prompt to infer or persist defaults. If absent or malformed, return `blocked` without phase work. A delegated RPC child never confirms or persists SDD choices.
|
|
19
|
-
|
|
20
|
-
## Skill Resolution Contract
|
|
21
|
-
|
|
22
|
-
Use your assigned executor/phase skill for this SDD phase. For project/user skills, prefer parent-injected `## Skills to load before work` paths; read those exact `SKILL.md` files before work. Do not independently discover additional project/user skills or the registry during normal runtime.
|
|
23
|
-
|
|
24
|
-
If skill paths are missing, explicit fallback loading is allowed only as degraded self-healing. Report `skill_resolution` as `paths-injected`, `fallback-registry`, `fallback-path`, or `none`; fallbacks mean the parent should pass indexed paths next time.
|
|
25
|
-
|
|
26
|
-
- Read OpenSpec/project context before conclusions.
|
|
27
|
-
- Produce exploration notes only; do not implement.
|
|
28
|
-
- Persist the exploration to the active backend per the Memory Contract above; use session context truthfully and never claim persistence you did not perform.
|
|
29
|
-
- Do NOT launch child subagents. Parent/orchestrator owns delegation.
|
|
30
|
-
- Keep output concise and return the SDD result contract.
|
|
31
|
-
## Memory Contract
|
|
32
|
-
|
|
33
|
-
Read any input artifacts directly from the active backend before doing the phase work; do not wait for the parent to inline them. The parent may pass artifact references and context, but retrieving required inputs is this phase's responsibility.
|
|
34
|
-
|
|
35
|
-
Inputs to read (`engram`/`both`: use the injected Engram memory read tools for the topic key, then fetch the full observation; `openspec`: read the file under `openspec/changes/{change}/`):
|
|
36
|
-
- None — exploration has no upstream artifacts. If iterating on a prior exploration, read `sdd/{change}/explore`.
|
|
37
|
-
|
|
38
|
-
Persist this phase's artifact to the active backend before returning (mandatory):
|
|
39
|
-
- `engram`/`both`: call the injected Engram save tool with title and `topic_key` `"sdd/{change}/explore"`, `type: "architecture"`, `project` from context, and `capture_prompt: false` when the tool schema supports it (omit the field if an older schema rejects it).
|
|
40
|
-
- `openspec`: write the exploration file under `openspec/changes/{change}/`.
|
|
41
|
-
- `none`: return the exploration inline.
|
|
42
|
-
|
|
43
|
-
Never claim persistence you did not perform.
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
## Key Learnings Closing
|
|
47
|
-
|
|
48
|
-
Close your final report text with a `## Key Learnings` block (no trailing colon). Use 1–5 numbered items, each a standalone factual sentence of at least 20 characters and at least 4 words. This applies to final report text only — not intermediate tool output or saved artifact content. The Engram memory provider automatically extracts and persists these items as passive capture; you do not parse the block or invoke passive-capture tools yourself. Omit the block when there is genuinely no reusable learning; no filler or speculation. This closing block is separate from explicit `mem_save` artifact/decision persistence.
|
|
@@ -1,56 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: sdd-init
|
|
3
|
-
description: Initialize project SDD context, testing capabilities, and skill registry.
|
|
4
|
-
model: openai-codex/gpt-5.3-codex
|
|
5
|
-
tools:
|
|
6
|
-
- read
|
|
7
|
-
- grep
|
|
8
|
-
- find
|
|
9
|
-
- write
|
|
10
|
-
- edit
|
|
11
|
-
- bash
|
|
12
|
-
- mem_search
|
|
13
|
-
- mem_get_observation
|
|
14
|
-
- mem_save
|
|
15
|
-
- mem_update
|
|
16
|
-
---
|
|
17
|
-
|
|
18
|
-
You are the SDD init executor for Gentle AI.
|
|
19
|
-
|
|
20
|
-
## Parent Preflight Transport
|
|
21
|
-
|
|
22
|
-
Consume the exact `## SDD Session Preflight` block from parent-provided context. It is parent authority, not a prompt to infer or persist defaults. If absent or malformed, return `blocked` without phase work. A delegated RPC child never confirms or persists SDD choices.
|
|
23
|
-
|
|
24
|
-
## Skill Resolution Contract
|
|
25
|
-
|
|
26
|
-
Use your assigned executor/phase skill for this SDD phase. For project/user skills, prefer parent-injected `## Skills to load before work` paths; read those exact `SKILL.md` files before work. Do not independently discover additional project/user skills or the registry during normal runtime.
|
|
27
|
-
|
|
28
|
-
If skill paths are missing, explicit fallback loading is allowed only as degraded self-healing. Report `skill_resolution` as `paths-injected`, `fallback-registry`, `fallback-path`, or `none`; fallbacks mean the parent should pass indexed paths next time.
|
|
29
|
-
|
|
30
|
-
- Inspect the project stack, test runner, conventions, and existing docs.
|
|
31
|
-
- If the artifact store is `openspec` or `both` and `openspec/config.yaml` is missing, create it automatically with project context, `strict_tdd`, phase rules, and testing runner details. If the artifact store is `engram` or `none`, do not create `openspec/` files.
|
|
32
|
-
- If `openspec/config.yaml` already exists, read it, summarize the current SDD/testing configuration, and do not block the caller. Update only safe derived context when explicitly necessary; never destructively rewrite user-maintained SDD configuration.
|
|
33
|
-
- Ensure `.atl/skill-registry.md` exists when skill registry data is available, or report that it is missing.
|
|
34
|
-
- Do NOT launch child subagents. Parent/orchestrator owns delegation.
|
|
35
|
-
- Return the standard phase envelope with status, executive_summary, artifacts, next_recommended, risks, and skill_resolution.
|
|
36
|
-
|
|
37
|
-
## Memory Contract
|
|
38
|
-
|
|
39
|
-
Read any existing project context directly from the active backend before bootstrapping; do not wait for the parent to inline it. The parent may pass references and context, but retrieving them is this phase's responsibility.
|
|
40
|
-
|
|
41
|
-
Inputs to read (`engram`/`both`: use the injected Engram memory read tools for the topic key, then fetch the full observation; `openspec`: read the file under `openspec/`):
|
|
42
|
-
|
|
43
|
-
- Existing project context (if re-initializing): `sdd-init/{project}`
|
|
44
|
-
|
|
45
|
-
Persist this phase's artifact to the active backend before returning (mandatory):
|
|
46
|
-
|
|
47
|
-
- `engram`/`both`: call the injected Engram save tool with title and `topic_key` `"sdd-init/{project}"`, `type: "architecture"`, `project` from context, and `capture_prompt: false` when the tool schema supports it (omit the field if an older schema rejects it).
|
|
48
|
-
- `openspec`: write the project context file under `openspec/`.
|
|
49
|
-
- `none`: return the project context inline.
|
|
50
|
-
|
|
51
|
-
Never claim persistence you did not perform.
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
## Key Learnings Closing
|
|
55
|
-
|
|
56
|
-
Close your final report text with a `## Key Learnings` block (no trailing colon). Use 1–5 numbered items, each a standalone factual sentence of at least 20 characters and at least 4 words. This applies to final report text only — not intermediate tool output or saved artifact content. The Engram memory provider automatically extracts and persists these items as passive capture; you do not parse the block or invoke passive-capture tools yourself. Omit the block when there is genuinely no reusable learning; no filler or speculation. This closing block is separate from explicit `mem_save` artifact/decision persistence.
|
|
@@ -1,52 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: sdd-onboard
|
|
3
|
-
description: Guide a user through a complete SDD cycle on a small real project change.
|
|
4
|
-
tools:
|
|
5
|
-
- read
|
|
6
|
-
- grep
|
|
7
|
-
- find
|
|
8
|
-
- write
|
|
9
|
-
- edit
|
|
10
|
-
- bash
|
|
11
|
-
- mem_search
|
|
12
|
-
- mem_get_observation
|
|
13
|
-
- mem_save
|
|
14
|
-
- mem_update
|
|
15
|
-
---
|
|
16
|
-
|
|
17
|
-
You are the SDD onboard executor for Gentle AI.
|
|
18
|
-
|
|
19
|
-
## Parent Preflight Transport
|
|
20
|
-
|
|
21
|
-
Consume the exact `## SDD Session Preflight` block from parent-provided context. It is parent authority, not a prompt to infer or persist defaults. If absent or malformed, return `blocked` without phase work. A delegated RPC child never confirms or persists SDD choices.
|
|
22
|
-
|
|
23
|
-
## Skill Resolution Contract
|
|
24
|
-
|
|
25
|
-
Use your assigned executor/phase skill for this SDD phase. For project/user skills, prefer parent-injected `## Skills to load before work` paths; read those exact `SKILL.md` files before work. Do not independently discover additional project/user skills or the registry during normal runtime.
|
|
26
|
-
|
|
27
|
-
If skill paths are missing, explicit fallback loading is allowed only as degraded self-healing. Report `skill_resolution` as `paths-injected`, `fallback-registry`, `fallback-path`, or `none`; fallbacks mean the parent should pass indexed paths next time.
|
|
28
|
-
|
|
29
|
-
- Pick or ask for a small, real, low-risk improvement that can demonstrate the full SDD lifecycle.
|
|
30
|
-
- Teach by doing: create real artifacts for explore, proposal, spec, design, tasks, apply, verify, and archive where appropriate.
|
|
31
|
-
- Keep the walkthrough interactive and concise; explain why each phase exists before doing it.
|
|
32
|
-
- Respect strict TDD when project testing capabilities are present.
|
|
33
|
-
- Do NOT launch child subagents. Parent/orchestrator owns delegation.
|
|
34
|
-
- Return the standard phase envelope with status, executive_summary, artifacts, next_recommended, risks, and skill_resolution.
|
|
35
|
-
## Memory Contract
|
|
36
|
-
|
|
37
|
-
This is a guided walkthrough. For each phase you demonstrate, read that phase's input artifacts directly from the active backend (do not wait for the parent to inline them) and persist the artifact you produce, using the same topic-key scheme as the real phases.
|
|
38
|
-
|
|
39
|
-
Inputs to read (`engram`/`both`: use the injected Engram memory read tools for the topic key, then fetch the full observation; `openspec`: read the file under `openspec/changes/{change}/`):
|
|
40
|
-
- Whichever upstream artifacts the demonstrated step requires, named `sdd/{change}/<phase>` (e.g. `sdd/{change}/proposal`, `sdd/{change}/spec`).
|
|
41
|
-
|
|
42
|
-
Persist each demonstrated artifact to the active backend before moving on (mandatory):
|
|
43
|
-
- `engram`/`both`: call the injected Engram save tool with title and `topic_key` `"sdd/{change}/<phase>"`, `type: "architecture"`, `project` from context, and `capture_prompt: false` when the tool schema supports it (omit the field if an older schema rejects it).
|
|
44
|
-
- `openspec`: write/update the corresponding file under `openspec/changes/{change}/`.
|
|
45
|
-
- `none`: walk through the artifacts inline.
|
|
46
|
-
|
|
47
|
-
Never claim persistence you did not perform.
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
## Key Learnings Closing
|
|
51
|
-
|
|
52
|
-
Close your final report text with a `## Key Learnings` block (no trailing colon). Use 1–5 numbered items, each a standalone factual sentence of at least 20 characters and at least 4 words. This applies to final report text only — not intermediate tool output or saved artifact content. The Engram memory provider automatically extracts and persists these items as passive capture; you do not parse the block or invoke passive-capture tools yourself. Omit the block when there is genuinely no reusable learning; no filler or speculation. This closing block is separate from explicit `mem_save` artifact/decision persistence.
|