@moretea-labs/forge 1.5.0-rc.1
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/AGENTS.md +120 -0
- package/CHANGELOG.md +36 -0
- package/CLAUDE.md +120 -0
- package/CODE_OF_CONDUCT.md +23 -0
- package/CONTRIBUTING.md +77 -0
- package/LICENSE +22 -0
- package/NOTICE +9 -0
- package/README.en.md +5 -0
- package/README.es.md +12 -0
- package/README.fr.md +12 -0
- package/README.ja.md +12 -0
- package/README.md +132 -0
- package/README.zh-CN.md +84 -0
- package/SECURITY.md +50 -0
- package/SKILL.md +431 -0
- package/SUPPORT.md +31 -0
- package/THIRD_PARTY_NOTICES.md +18 -0
- package/agents/openai.yaml +4 -0
- package/assets/AGENTS.md +68 -0
- package/assets/CLAUDE.md +68 -0
- package/assets/branding/README.md +10 -0
- package/assets/branding/forge-controller-flow.mmd +8 -0
- package/assets/hooks/AGENTS.md +75 -0
- package/assets/hooks/CLAUDE.md +75 -0
- package/assets/hooks/anti-simplification.sh +12 -0
- package/assets/hooks/changelog-guard.sh +80 -0
- package/assets/hooks/codex.hooks.template.json +60 -0
- package/assets/hooks/first-principles-guard.sh +72 -0
- package/assets/hooks/hook-input.sh +618 -0
- package/assets/hooks/lib/session-state.sh +106 -0
- package/assets/hooks/lib/workflow-state.sh +1730 -0
- package/assets/hooks/post-bash.sh +215 -0
- package/assets/hooks/post-edit-guard.sh +256 -0
- package/assets/hooks/post-tool-observer.sh +99 -0
- package/assets/hooks/pre-edit-guard.sh +240 -0
- package/assets/hooks/prompt-guard.sh +1077 -0
- package/assets/hooks/run-hook.sh +67 -0
- package/assets/hooks/security-sentinel.sh +115 -0
- package/assets/hooks/session-start-context.sh +593 -0
- package/assets/hooks/settings.template.json +60 -0
- package/assets/hooks/stop-orchestrator.sh +171 -0
- package/assets/hooks/subagent-return-channel-guard.sh +107 -0
- package/assets/hooks/worktree-guard.sh +39 -0
- package/assets/initializer-question-pack.v1.json +132 -0
- package/assets/initializer-question-pack.v1.schema.json +46 -0
- package/assets/initializer-question-pack.v2.json +174 -0
- package/assets/initializer-question-pack.v3.json +206 -0
- package/assets/initializer-question-pack.v3.schema.json +92 -0
- package/assets/initializer-question-pack.v4.json +557 -0
- package/assets/initializer-question-pack.v4.schema.json +169 -0
- package/assets/partials/01-header.partial.md +10 -0
- package/assets/partials/02-iron-rules.partial.md +30 -0
- package/assets/partials/03-philosophy.partial.md +32 -0
- package/assets/partials/04-project-structure.partial.md +56 -0
- package/assets/partials/05-workflow.partial.md +79 -0
- package/assets/partials/06-cloudflare.partial.md +20 -0
- package/assets/partials/07-footer.partial.md +38 -0
- package/assets/partials/08-orchestration.partial.md +49 -0
- package/assets/partials/09-compact-instructions.partial.md +11 -0
- package/assets/partials/_assembly-order.md +40 -0
- package/assets/partials-agents/01-header.partial.md +8 -0
- package/assets/partials-agents/02-operating-mode.partial.md +44 -0
- package/assets/partials-agents/03-orchestration.partial.md +45 -0
- package/assets/partials-agents/04-task-protocol.partial.md +69 -0
- package/assets/partials-agents/05-coding-constraints.partial.md +20 -0
- package/assets/partials-agents/06-quality-safety.partial.md +23 -0
- package/assets/partials-agents/07-cloudflare.partial.md +9 -0
- package/assets/partials-agents/08-deep-docs.partial.md +32 -0
- package/assets/plan-map.json +301 -0
- package/assets/plugin-registry.v1.json +8 -0
- package/assets/project-structures/ai-native-collaborative-editor.txt +25 -0
- package/assets/project-structures/ai-native-product-copilot.txt +21 -0
- package/assets/project-structures/ai-native-runtime-console.txt +25 -0
- package/assets/project-structures/ai-native-sidecar-kernel.txt +19 -0
- package/assets/project-structures/astro-ssr.txt +25 -0
- package/assets/project-structures/expo-nativewind.txt +52 -0
- package/assets/project-structures/monorepo.txt +63 -0
- package/assets/project-structures/remix.txt +50 -0
- package/assets/project-structures/tanstack-start-workers.txt +51 -0
- package/assets/project-structures/vite-tanstack.txt +58 -0
- package/assets/reference-configs/AGENTS.md +13 -0
- package/assets/reference-configs/CLAUDE.md +13 -0
- package/assets/reference-configs/agentic-development-flow.md +94 -0
- package/assets/reference-configs/ai-workflows.md +14 -0
- package/assets/reference-configs/changelog-versioning.md +13 -0
- package/assets/reference-configs/coding-standards.md +14 -0
- package/assets/reference-configs/development-protocol.md +21 -0
- package/assets/reference-configs/document-generation.md +38 -0
- package/assets/reference-configs/evaluator-rubric.md +19 -0
- package/assets/reference-configs/external-tooling.md +374 -0
- package/assets/reference-configs/git-strategy.md +14 -0
- package/assets/reference-configs/global-working-rules.md +64 -0
- package/assets/reference-configs/handoff-protocol.md +38 -0
- package/assets/reference-configs/harness-overview.md +124 -0
- package/assets/reference-configs/heartbeat-triage.md +57 -0
- package/assets/reference-configs/hook-operations.md +96 -0
- package/assets/reference-configs/release-deploy.md +40 -0
- package/assets/reference-configs/spa-day-protocol.md +14 -0
- package/assets/reference-configs/sprint-contracts.md +89 -0
- package/assets/reference-configs/workflow-orchestration.md +14 -0
- package/assets/skill-hooks.json +41 -0
- package/assets/skill-version.json +189 -0
- package/assets/skills/claude-review/SKILL.md +231 -0
- package/assets/skills/codex-review/SKILL.md +103 -0
- package/assets/templates/AGENTS.md +13 -0
- package/assets/templates/CLAUDE.md +13 -0
- package/assets/templates/architecture.template.md +80 -0
- package/assets/templates/brief.template.md +38 -0
- package/assets/templates/contract.template.md +104 -0
- package/assets/templates/decisions.template.md +85 -0
- package/assets/templates/factor-factory/factor-backtest-report.template.md +36 -0
- package/assets/templates/factor-factory/factor-hypothesis.template.md +30 -0
- package/assets/templates/factor-factory/factor-registry.template.json +5 -0
- package/assets/templates/gitignore.template +53 -0
- package/assets/templates/guides/metro-esm-gotchas.template.md +46 -0
- package/assets/templates/helpers/architecture-event.ts +822 -0
- package/assets/templates/helpers/architecture-queue.sh +647 -0
- package/assets/templates/helpers/archive-architecture-request.sh +244 -0
- package/assets/templates/helpers/archive-workflow.sh +295 -0
- package/assets/templates/helpers/capability-config.ts +394 -0
- package/assets/templates/helpers/capability-resolver.ts +505 -0
- package/assets/templates/helpers/capture-plan.sh +335 -0
- package/assets/templates/helpers/check-agent-tooling.sh +1533 -0
- package/assets/templates/helpers/check-architecture-sync.sh +287 -0
- package/assets/templates/helpers/check-brain-manifest.sh +255 -0
- package/assets/templates/helpers/check-context-files.sh +49 -0
- package/assets/templates/helpers/check-deploy-sql-order.sh +117 -0
- package/assets/templates/helpers/check-skill-version.ts +193 -0
- package/assets/templates/helpers/check-task-sync.sh +65 -0
- package/assets/templates/helpers/check-task-workflow.sh +1002 -0
- package/assets/templates/helpers/codex-handoff-resume.sh +269 -0
- package/assets/templates/helpers/context-contract-sync.sh +516 -0
- package/assets/templates/helpers/contract-run.ts +465 -0
- package/assets/templates/helpers/contract-worktree.sh +725 -0
- package/assets/templates/helpers/ensure-task-workflow.sh +1218 -0
- package/assets/templates/helpers/harness-trace-grade.sh +150 -0
- package/assets/templates/helpers/heartbeat-triage.sh +361 -0
- package/assets/templates/helpers/inspect-project-state.ts +280 -0
- package/assets/templates/helpers/maintenance-triage.sh +167 -0
- package/assets/templates/helpers/migrate-project-template.sh +54 -0
- package/assets/templates/helpers/migrate-workflow-docs.ts +413 -0
- package/assets/templates/helpers/new-plan.sh +183 -0
- package/assets/templates/helpers/new-spec.sh +50 -0
- package/assets/templates/helpers/new-sprint.sh +49 -0
- package/assets/templates/helpers/plan-to-todo.sh +799 -0
- package/assets/templates/helpers/prepare-codex-handoff.sh +203 -0
- package/assets/templates/helpers/prepare-handoff.sh +81 -0
- package/assets/templates/helpers/refresh-current-status.sh +469 -0
- package/assets/templates/helpers/select-agent-context-blocks.sh +66 -0
- package/assets/templates/helpers/ship-worktrees.sh +561 -0
- package/assets/templates/helpers/sprint-backlog.sh +837 -0
- package/assets/templates/helpers/summarize-failures.sh +125 -0
- package/assets/templates/helpers/switch-plan.sh +153 -0
- package/assets/templates/helpers/sync-brain-docs.sh +381 -0
- package/assets/templates/helpers/verify-contract.sh +705 -0
- package/assets/templates/helpers/verify-sprint.sh +680 -0
- package/assets/templates/helpers/workflow-contract.ts +202 -0
- package/assets/templates/helpers/workstream-sync.sh +263 -0
- package/assets/templates/implementation-notes.template.md +37 -0
- package/assets/templates/packages.template.md +45 -0
- package/assets/templates/plan.template.md +77 -0
- package/assets/templates/prd.template.md +165 -0
- package/assets/templates/research.template.md +25 -0
- package/assets/templates/review.template.md +78 -0
- package/assets/templates/spec.template.md +31 -0
- package/assets/templates/sprint.template.md +69 -0
- package/assets/templates/tech-stack.template.md +57 -0
- package/assets/versions.json +77 -0
- package/assets/workflow-contract.v1.json +671 -0
- package/bin/forge-desktop-helper.mjs +204 -0
- package/bin/forge-hook.mjs +32 -0
- package/bin/forge-runtime-service.mjs +34 -0
- package/bin/forge-runtime.mjs +30 -0
- package/bin/forge.mjs +32 -0
- package/docs/CHANGELOG.md +978 -0
- package/docs/README.md +72 -0
- package/docs/README.zh-CN.md +58 -0
- package/docs/architecture/chatgpt-handoff-facade.md +393 -0
- package/docs/architecture/current/README.md +158 -0
- package/docs/architecture/current/approved-target-architecture.zh-CN.md +1501 -0
- package/docs/architecture/current/architecture-invariants.md +331 -0
- package/docs/architecture/current/automation-and-schedule-engine.md +453 -0
- package/docs/architecture/current/codegraph-context-provider.md +226 -0
- package/docs/architecture/current/control-plane-authority-inventory.md +82 -0
- package/docs/architecture/current/controller-repository-decoupling.md +148 -0
- package/docs/architecture/current/dispatch-and-agent-strategy.md +354 -0
- package/docs/architecture/current/entity-model.md +619 -0
- package/docs/architecture/current/external-plugin-governance.md +396 -0
- package/docs/architecture/current/failure-recovery.md +471 -0
- package/docs/architecture/current/governance.md +213 -0
- package/docs/architecture/current/human-interaction-plane.md +87 -0
- package/docs/architecture/current/implementation-status.md +128 -0
- package/docs/architecture/current/job-and-run-lifecycle.md +413 -0
- package/docs/architecture/current/local-workspace-target-grants.md +70 -0
- package/docs/architecture/current/migration-roadmap.md +105 -0
- package/docs/architecture/current/multi-repository-execution.md +371 -0
- package/docs/architecture/current/operations-runbook.md +45 -0
- package/docs/architecture/current/peer-supercontroller-runtime.md +32 -0
- package/docs/architecture/current/personal-assistant-plugin-baseline.md +207 -0
- package/docs/architecture/current/repository-access-modes.md +102 -0
- package/docs/architecture/current/route-policy.md +15 -0
- package/docs/architecture/current/route-session-concurrency.md +85 -0
- package/docs/architecture/current/runtime-architecture-simplification.md +214 -0
- package/docs/architecture/current/runtime-directory-map.md +49 -0
- package/docs/architecture/current/runtime-health-and-resource-lifecycle.md +85 -0
- package/docs/architecture/current/scheduler-and-resource-claims.md +432 -0
- package/docs/architecture/current/session-aware-execution-and-authorization.md +77 -0
- package/docs/architecture/current/system-overview.md +144 -0
- package/docs/architecture/current/target-requirements-traceability.md +202 -0
- package/docs/architecture/current/thin-harness-governance-policy.md +32 -0
- package/docs/architecture/current/thin-harness-v1.md +313 -0
- package/docs/architecture/current/verification-and-release-gates.md +391 -0
- package/docs/architecture/decisions/20260801-controller-home-sqlite-state.md +100 -0
- package/docs/architecture/decisions/20260803-canonical-skill-surface.md +40 -0
- package/docs/architecture/decisions/20260803-release-identity-binding-and-exit-policy.md +53 -0
- package/docs/architecture/diagrams/.gitkeep +1 -0
- package/docs/architecture/diagrams/agentic-dev-plugin-architecture.html +186 -0
- package/docs/architecture/domains/.gitkeep +0 -0
- package/docs/architecture/domains/public-surface.md +30 -0
- package/docs/architecture/domains/runtime-harness.md +33 -0
- package/docs/architecture/domains/verification.md +33 -0
- package/docs/architecture/domains/workflow-engine.md +30 -0
- package/docs/architecture/global-hook-runtime.md +162 -0
- package/docs/architecture/history.md +38 -0
- package/docs/architecture/index.md +114 -0
- package/docs/architecture/ios-semantic-automation-provider-v2.md +166 -0
- package/docs/architecture/modules/.gitkeep +0 -0
- package/docs/architecture/modules/controller-runtime/transport-lifecycle.md +24 -0
- package/docs/architecture/requests/.gitkeep +1 -0
- package/docs/architecture/requests/archive/2026/20260528-154740-ai-hooks-ai-hooks-hook-input-sh.md +59 -0
- package/docs/architecture/requests/archive/2026/20260528-154816-assets-hooks-assets-hooks-hook-input-sh.md +59 -0
- package/docs/architecture/requests/archive/2026/20260528-161851-ai-harness-workflow-contract-json-ai-harness-workflow-contract-json.md +59 -0
- package/docs/architecture/requests/archive/2026/20260528-161853-scripts-check-task-workflow-sh-scripts-check-task-workflow-sh.md +59 -0
- package/docs/architecture/requests/archive/2026/20260528-161911-assets-workflow-contract-v1-json-assets-workflow-contract-v1-json.md +59 -0
- package/docs/architecture/requests/archive/2026/20260528-222416-ai-hooks-ai-hooks-hook-input-sh.md +59 -0
- package/docs/architecture/requests/archive/2026/20260528-222444-ai-hooks-ai-hooks-pre-edit-guard-sh.md +59 -0
- package/docs/architecture/requests/archive/2026/20260528-222457-ai-hooks-ai-hooks-pre-edit-guard-sh.md +59 -0
- package/docs/architecture/requests/archive/2026/20260528-222648-ai-hooks-ai-hooks-pre-edit-guard-sh.md +59 -0
- package/docs/architecture/requests/archive/2026/20260528-222705-ai-hooks-ai-hooks-worktree-guard-sh.md +59 -0
- package/docs/architecture/requests/archive/2026/20260528-222726-ai-hooks-ai-hooks-prompt-guard-sh.md +59 -0
- package/docs/architecture/requests/archive/2026/20260528-222727-ai-hooks-ai-hooks-prompt-guard-sh.md +59 -0
- package/docs/architecture/requests/archive/2026/20260528-224736-ai-hooks-ai-hooks-hook-input-sh.md +59 -0
- package/docs/architecture/requests/archive/2026/20260528-233259-ai-hooks-ai-hooks-prompt-guard-sh.md +59 -0
- package/docs/architecture/requests/archive/2026/20260528-233335-assets-hooks-assets-hooks-prompt-guard-sh.md +59 -0
- package/docs/architecture/requests/archive/2026/20260528-233456-ai-hooks-ai-hooks-prompt-guard-sh.md +59 -0
- package/docs/architecture/requests/archive/2026/20260528-233457-assets-hooks-assets-hooks-prompt-guard-sh.md +59 -0
- package/docs/architecture/requests/archive/2026/20260528-233637-ai-hooks-ai-hooks-prompt-guard-sh.md +59 -0
- package/docs/architecture/requests/archive/2026/20260528-233638-assets-hooks-assets-hooks-prompt-guard-sh.md +59 -0
- package/docs/architecture/requests/archive/2026/20260529-000322-root-package-json.md +59 -0
- package/docs/architecture/requests/archive/2026/20260529-004238-ai-hooks-ai-hooks-lib-workflow-state-sh.md +59 -0
- package/docs/architecture/requests/archive/2026/20260529-020654-ai-harness-policy-json-ai-harness-policy-json.md +63 -0
- package/docs/architecture/requests/archive/2026/20260529-094236-ai-hooks-ai-hooks-prompt-guard-sh.md +60 -0
- package/docs/architecture/requests/archive/2026/20260529-094323-assets-hooks-assets-hooks-prompt-guard-sh.md +60 -0
- package/docs/architecture/requests/archive/2026/20260529-094331-ai-hooks-ai-hooks-prompt-guard-sh.md +60 -0
- package/docs/architecture/requests/archive/2026/20260529-094339-assets-hooks-assets-hooks-prompt-guard-sh.md +60 -0
- package/docs/architecture/requests/archive/2026/20260529-094430-assets-hooks-assets-hooks-session-start-context-sh.md +60 -0
- package/docs/architecture/requests/archive/2026/20260529-094446-ai-hooks-ai-hooks-session-start-context-sh.md +60 -0
- package/docs/architecture/requests/archive/2026/20260613-002040-runtime-harness-hook-adapters.md +68 -0
- package/docs/architecture/requests/archive/2026/root.md +68 -0
- package/docs/architecture/requests/archive/2026/runtime-harness-hook-adapters.md +76 -0
- package/docs/architecture/requests/archive/2026/verification-evals-checks.md +68 -0
- package/docs/architecture/requests/archive/2026/workflow-engine-contract-assets.md +69 -0
- package/docs/architecture/reviews/2026-07-11-access-surface-review.md +99 -0
- package/docs/architecture/snapshots/.gitkeep +1 -0
- package/docs/forge-autonomous-goal-loop.md +7 -0
- package/docs/forge-chatgpt-browser-engine.md +11 -0
- package/docs/forge-chatgpt-mcp-setup.md +239 -0
- package/docs/forge-chatgpt-supervised-automation.md +11 -0
- package/docs/forge-github-issue-launcher.md +7 -0
- package/docs/forge-plugin-management.md +95 -0
- package/docs/forge-provider-configuration.md +7 -0
- package/docs/forge-runtime-self-healing-loop.md +7 -0
- package/docs/images/forge-banner-cn.svg +1 -0
- package/docs/images/forge-banner.svg +1 -0
- package/docs/images/forge-controller-flow.svg +1 -0
- package/docs/images/image.png +0 -0
- package/docs/images/repo-harness-gptpro-cn.png +0 -0
- package/docs/images/repo-harness-gptpro.png +0 -0
- package/docs/images/repo-harness-hook-carrot.png +0 -0
- package/docs/operations/chatgpt-personal-assistant-runtime.md +83 -0
- package/docs/operations/checkout-route-integrity.md +22 -0
- package/docs/operations/controller-browser-plugin.md +299 -0
- package/docs/operations/controller-desktop-plugin.md +112 -0
- package/docs/operations/controller-performance-and-502.md +126 -0
- package/docs/operations/controller-reliability-runbook.md +134 -0
- package/docs/operations/environment-hardening.md +50 -0
- package/docs/operations/features.md +45 -0
- package/docs/operations/features.zh-CN.md +45 -0
- package/docs/operations/github-repository.md +60 -0
- package/docs/operations/gmail-assistant-routines.md +186 -0
- package/docs/operations/homebrew.md +26 -0
- package/docs/operations/local-system-assistant.md +46 -0
- package/docs/operations/local-system-assistant.zh-CN.md +46 -0
- package/docs/operations/mcp-tool-exposure.md +58 -0
- package/docs/operations/mobile-intents-shortcuts.md +117 -0
- package/docs/operations/open-source-release-hygiene.md +31 -0
- package/docs/operations/personal-assistant-operator-guide.md +61 -0
- package/docs/operations/platform-support.md +62 -0
- package/docs/operations/platform-support.zh-CN.md +61 -0
- package/docs/operations/provider-configuration.md +31 -0
- package/docs/operations/releasing.md +86 -0
- package/docs/operations/releasing.zh-CN.md +86 -0
- package/docs/operations/route-session-concurrency-baseline.json +893 -0
- package/docs/operations/route-session-concurrency-baseline.md +94 -0
- package/docs/operations/runtime-performance-diagnostics.md +14 -0
- package/docs/operations/sqlite-control-plane-recovery.md +65 -0
- package/docs/operations/standalone-disaster-recovery.md +136 -0
- package/docs/operations/troubleshooting.md +72 -0
- package/docs/operations/troubleshooting.zh-CN.md +70 -0
- package/docs/public-usage-guide.md +33 -0
- package/docs/public-usage-guide.zh-CN.md +33 -0
- package/docs/tutorials/01-install-and-start.md +93 -0
- package/docs/tutorials/01-install-and-start.zh-CN.md +93 -0
- package/docs/tutorials/02-connect-chatgpt.md +82 -0
- package/docs/tutorials/02-connect-chatgpt.zh-CN.md +80 -0
- package/docs/tutorials/03-first-repository-task.md +57 -0
- package/docs/tutorials/03-first-repository-task.zh-CN.md +57 -0
- package/docs/tutorials/README.md +13 -0
- package/docs/tutorials/README.zh-CN.md +13 -0
- package/docs/wiki/Architecture.md +85 -0
- package/docs/wiki/Core-Concepts.md +27 -0
- package/docs/wiki/Home.md +36 -0
- package/docs/wiki/Implementation.md +172 -0
- package/docs/wiki/Installation.md +50 -0
- package/docs/wiki/Integrations.md +29 -0
- package/docs/wiki/Operations.md +26 -0
- package/docs/wiki/Quick-Start.md +46 -0
- package/docs/wiki/Releases-and-Upgrades.md +34 -0
- package/docs/wiki/Runtime-Architecture.md +50 -0
- package/docs/wiki/Security-Model.md +31 -0
- package/docs/wiki/Troubleshooting.md +38 -0
- package/docs/wiki/Work-Lifecycle.md +31 -0
- package/docs/wiki/_Sidebar.md +21 -0
- package/install.ps1 +48 -0
- package/install.sh +66 -0
- package/package.json +156 -0
- package/scripts/activate-source-baseline.ts +335 -0
- package/scripts/architecture-event.ts +822 -0
- package/scripts/architecture-queue.sh +647 -0
- package/scripts/archive-architecture-request.sh +244 -0
- package/scripts/archive-workflow.sh +295 -0
- package/scripts/assemble-template.ts +1172 -0
- package/scripts/benchmark-controller-hotpath.ts +212 -0
- package/scripts/benchmark-controller-round2.ts +139 -0
- package/scripts/benchmark-ios-agent-device.ts +514 -0
- package/scripts/benchmark-route-session-concurrency.ts +714 -0
- package/scripts/benchmark-thin-harness-gateway-ab.ts +632 -0
- package/scripts/benchmark-thin-harness-mcp-e2e.ts +479 -0
- package/scripts/benchmark-thin-harness.ts +251 -0
- package/scripts/bootstrap-runtime-maintenance-recovery.sh +183 -0
- package/scripts/canary-global-hook.sh +263 -0
- package/scripts/capability-config.ts +394 -0
- package/scripts/capability-resolver.ts +505 -0
- package/scripts/capture-plan.sh +335 -0
- package/scripts/check-agent-tooling.sh +1549 -0
- package/scripts/check-architecture-sync.sh +373 -0
- package/scripts/check-brain-manifest.sh +255 -0
- package/scripts/check-ci.sh +16 -0
- package/scripts/check-context-files.sh +49 -0
- package/scripts/check-deploy-sql-order.sh +117 -0
- package/scripts/check-mcp-compatibility.ts +93 -0
- package/scripts/check-npm-release.sh +32 -0
- package/scripts/check-open-source-tracked-surface.sh +146 -0
- package/scripts/check-package-identity.mjs +117 -0
- package/scripts/check-platform-support.mjs +79 -0
- package/scripts/check-public-docs.sh +105 -0
- package/scripts/check-public-release-surface.sh +19 -0
- package/scripts/check-release-published.sh +57 -0
- package/scripts/check-release-readiness.sh +43 -0
- package/scripts/check-release-version.mjs +74 -0
- package/scripts/check-runtime-architecture.mjs +593 -0
- package/scripts/check-runtime-env.mjs +89 -0
- package/scripts/check-skill-version.ts +193 -0
- package/scripts/check-tarball-install-smoke.sh +66 -0
- package/scripts/check-task-sync.sh +65 -0
- package/scripts/check-task-workflow.sh +1002 -0
- package/scripts/check-third-party-notices.mjs +36 -0
- package/scripts/codex-handoff-resume.sh +269 -0
- package/scripts/complete-control-plane-cutover.ts +126 -0
- package/scripts/context-contract-sync.sh +516 -0
- package/scripts/contract-run.ts +465 -0
- package/scripts/contract-worktree.sh +725 -0
- package/scripts/controller-ngrok-rotation.sh +678 -0
- package/scripts/create-project-dirs.sh +282 -0
- package/scripts/ensure-codegraph.sh +16 -0
- package/scripts/ensure-task-workflow.sh +1218 -0
- package/scripts/export-requirement-portfolio.ts +28 -0
- package/scripts/factor-lab-check.sh +73 -0
- package/scripts/factor-lab-new.sh +96 -0
- package/scripts/factor-lab-promote.sh +86 -0
- package/scripts/factor-lab-reject.sh +68 -0
- package/scripts/harness-trace-grade.sh +150 -0
- package/scripts/heartbeat-triage.sh +361 -0
- package/scripts/hook-dispatch-diet-report.ts +234 -0
- package/scripts/hook-shim.sh +93 -0
- package/scripts/init-project.sh +505 -0
- package/scripts/initializer-question-pack.ts +200 -0
- package/scripts/inspect-project-state.ts +280 -0
- package/scripts/install-desktop-operator-registration.ts +45 -0
- package/scripts/install-standalone-recovery.ts +74 -0
- package/scripts/lib/AGENTS.md +13 -0
- package/scripts/lib/CLAUDE.md +13 -0
- package/scripts/lib/controller-home-env.sh +69 -0
- package/scripts/lib/project-init-lib.sh +2759 -0
- package/scripts/load-standalone-recovery.sh +17 -0
- package/scripts/loop-engine-cutover-gate.ts +324 -0
- package/scripts/maintenance-triage.sh +167 -0
- package/scripts/migrate-project-template.sh +1189 -0
- package/scripts/migrate-requirement-portfolio.ts +86 -0
- package/scripts/migrate-workflow-docs.ts +413 -0
- package/scripts/new-plan.sh +183 -0
- package/scripts/new-spec.sh +50 -0
- package/scripts/new-sprint.sh +49 -0
- package/scripts/open-source-audit-allowlist.txt +46 -0
- package/scripts/package-source-archive.sh +147 -0
- package/scripts/plan-to-todo.sh +799 -0
- package/scripts/prepare-codex-handoff.sh +203 -0
- package/scripts/prepare-handoff.sh +81 -0
- package/scripts/public-release-files.txt +39 -0
- package/scripts/public-release.ts +174 -0
- package/scripts/publish-release-tarball.sh +27 -0
- package/scripts/refresh-current-status.sh +469 -0
- package/scripts/refresh-ios-physical-runtime.ts +196 -0
- package/scripts/repair-executable-modes.ts +8 -0
- package/scripts/rollout-all-registered-repos.sh +7 -0
- package/scripts/route-nl-vs-ts-eval.ts +679 -0
- package/scripts/run-bun-test-file.ts +182 -0
- package/scripts/run-governed-gate.ts +140 -0
- package/scripts/run-mobile-monitor-bridge.ts +71 -0
- package/scripts/run-skill-evals.ts +1022 -0
- package/scripts/run-skill-hook.ts +244 -0
- package/scripts/run-supervised-command.ts +24 -0
- package/scripts/run-tests-portable.sh +20 -0
- package/scripts/select-agent-context-blocks.sh +66 -0
- package/scripts/setup-plugins.sh +43 -0
- package/scripts/ship-worktrees.sh +561 -0
- package/scripts/smoke-browser-cdp-bridge.ts +93 -0
- package/scripts/smoke-chatgpt-supervised-automation.ts +208 -0
- package/scripts/smoke-ios-physical-device.ts +114 -0
- package/scripts/smoke-mcp-http-runtime.ts +216 -0
- package/scripts/smoke-mcp-tool-surface.ts +117 -0
- package/scripts/smoke-runtime-recovery.ts +220 -0
- package/scripts/smoke-schedule-engine.ts +283 -0
- package/scripts/sprint-backlog.sh +837 -0
- package/scripts/stage-runtime-release.ts +38 -0
- package/scripts/summarize-failures.sh +125 -0
- package/scripts/switch-plan.sh +153 -0
- package/scripts/sync-brain-docs.sh +381 -0
- package/scripts/sync-codex-installed-copies.sh +183 -0
- package/scripts/test-governance.ts +75 -0
- package/scripts/verify-contract.sh +705 -0
- package/scripts/verify-forge-runtime.sh +31 -0
- package/scripts/verify-sprint.sh +680 -0
- package/scripts/windows-paths.d.mts +7 -0
- package/scripts/windows-paths.mjs +28 -0
- package/scripts/workflow-contract.ts +206 -0
- package/scripts/workstream-sync.sh +263 -0
- package/src/cli/agent-jobs/executable-resolver.ts +289 -0
- package/src/cli/agent-jobs/executor-health.ts +252 -0
- package/src/cli/agent-jobs/integration.ts +963 -0
- package/src/cli/agent-jobs/job-manager.ts +2030 -0
- package/src/cli/agent-jobs/types.ts +219 -0
- package/src/cli/agent-jobs/worker-lifecycle.ts +288 -0
- package/src/cli/chatgpt-browser/bind-server.ts +504 -0
- package/src/cli/chatgpt-browser/binding.ts +140 -0
- package/src/cli/chatgpt-browser/bridge-extension.ts +221 -0
- package/src/cli/chatgpt-browser/bridge-provider.ts +268 -0
- package/src/cli/chatgpt-browser/engine.ts +569 -0
- package/src/cli/chatgpt-browser/file-policy.ts +158 -0
- package/src/cli/chatgpt-browser/native-provider.ts +553 -0
- package/src/cli/chatgpt-browser/oracle-provider.ts +437 -0
- package/src/cli/chatgpt-browser/prompt-assembler.ts +29 -0
- package/src/cli/chatgpt-browser/session-store.ts +301 -0
- package/src/cli/chatgpt-browser/types.ts +172 -0
- package/src/cli/commands/adopt-plan.ts +186 -0
- package/src/cli/commands/brain-root.ts +132 -0
- package/src/cli/commands/brain.ts +609 -0
- package/src/cli/commands/capability-context.ts +613 -0
- package/src/cli/commands/chatgpt.ts +424 -0
- package/src/cli/commands/controller.ts +680 -0
- package/src/cli/commands/docs.ts +103 -0
- package/src/cli/commands/doctor.ts +476 -0
- package/src/cli/commands/global-runtime.ts +323 -0
- package/src/cli/commands/hook.ts +34 -0
- package/src/cli/commands/init-hook.ts +870 -0
- package/src/cli/commands/init.ts +829 -0
- package/src/cli/commands/install.ts +86 -0
- package/src/cli/commands/mcp.ts +315 -0
- package/src/cli/commands/migrate.ts +154 -0
- package/src/cli/commands/plugin.ts +74 -0
- package/src/cli/commands/prompt-guard-decision.ts +238 -0
- package/src/cli/commands/recovery.ts +667 -0
- package/src/cli/commands/repository.ts +224 -0
- package/src/cli/commands/run.ts +23 -0
- package/src/cli/commands/runtime.ts +191 -0
- package/src/cli/commands/security.ts +440 -0
- package/src/cli/commands/status.ts +137 -0
- package/src/cli/commands/tools.ts +167 -0
- package/src/cli/controller/check-runner.ts +1022 -0
- package/src/cli/controller/codex-continuation.ts +153 -0
- package/src/cli/controller/completion-backlog.ts +380 -0
- package/src/cli/controller/completion-orchestrator.ts +1807 -0
- package/src/cli/controller/completion-target.ts +96 -0
- package/src/cli/controller/composite-operations.ts +196 -0
- package/src/cli/controller/composite-result.ts +130 -0
- package/src/cli/controller/context-pack.ts +652 -0
- package/src/cli/controller/execution-completion.ts +175 -0
- package/src/cli/controller/execution-policy.ts +392 -0
- package/src/cli/controller/governance.ts +594 -0
- package/src/cli/controller/issue-store.ts +1421 -0
- package/src/cli/controller/launch-agents.ts +410 -0
- package/src/cli/controller/legacy-issue-cutover.ts +415 -0
- package/src/cli/controller/lifecycle-authority.ts +16 -0
- package/src/cli/controller/migrated-issue-decision.ts +237 -0
- package/src/cli/controller/operational-plan.ts +226 -0
- package/src/cli/controller/postcondition.ts +134 -0
- package/src/cli/controller/progress.ts +656 -0
- package/src/cli/controller/project-state.ts +147 -0
- package/src/cli/controller/requirement-portfolio-export.ts +146 -0
- package/src/cli/controller/requirement-portfolio-migration.ts +613 -0
- package/src/cli/controller/run-evidence.ts +43 -0
- package/src/cli/controller/runtime-config.ts +92 -0
- package/src/cli/controller/stuck-state-migration.ts +396 -0
- package/src/cli/controller/task-ledger.ts +632 -0
- package/src/cli/controller/task-status-resolver.ts +403 -0
- package/src/cli/controller/types.ts +273 -0
- package/src/cli/controller/work-mode.ts +186 -0
- package/src/cli/controller/worklog.ts +201 -0
- package/src/cli/diagnostic-entry.ts +39 -0
- package/src/cli/editing/edit-session.ts +1606 -0
- package/src/cli/editing/executable-modes.ts +70 -0
- package/src/cli/github/github.ts +274 -0
- package/src/cli/github/plugin.ts +345 -0
- package/src/cli/github/session.ts +104 -0
- package/src/cli/hook/prompt-guard-decision.ts +238 -0
- package/src/cli/hook/prompt-intents.ts +534 -0
- package/src/cli/hook/route-registry.ts +107 -0
- package/src/cli/hook/runtime.ts +303 -0
- package/src/cli/hook/state-snapshot.ts +388 -0
- package/src/cli/hook-entry.ts +51 -0
- package/src/cli/index.ts +574 -0
- package/src/cli/installer/managed-entries.ts +78 -0
- package/src/cli/installer/shared.ts +65 -0
- package/src/cli/installer/targets/claude.ts +136 -0
- package/src/cli/installer/targets/codex.ts +174 -0
- package/src/cli/installer/targets/registry.ts +28 -0
- package/src/cli/installer/types.ts +72 -0
- package/src/cli/local-bridge/connector-freshness.ts +529 -0
- package/src/cli/local-bridge/console-view-models.ts +324 -0
- package/src/cli/local-bridge/dashboard.ts +1312 -0
- package/src/cli/local-bridge/facade-api.ts +1877 -0
- package/src/cli/local-bridge/job-store.ts +1451 -0
- package/src/cli/local-bridge/mobile-intents.ts +344 -0
- package/src/cli/local-bridge/mobile-monitor.ts +209 -0
- package/src/cli/local-bridge/server.ts +3183 -0
- package/src/cli/local-bridge/types.ts +176 -0
- package/src/cli/mcp/access-mode.ts +132 -0
- package/src/cli/mcp/access-tools.ts +387 -0
- package/src/cli/mcp/audit.ts +32 -0
- package/src/cli/mcp/auth.ts +402 -0
- package/src/cli/mcp/instructions.ts +33 -0
- package/src/cli/mcp/legacy-context.ts +16 -0
- package/src/cli/mcp/legacy-tool-service.ts +5516 -0
- package/src/cli/mcp/multi-repository.ts +423 -0
- package/src/cli/mcp/oauth.ts +226 -0
- package/src/cli/mcp/paths.ts +134 -0
- package/src/cli/mcp/policy.ts +230 -0
- package/src/cli/mcp/proxy-env.ts +62 -0
- package/src/cli/mcp/readiness-projection.ts +24 -0
- package/src/cli/mcp/redaction.ts +21 -0
- package/src/cli/mcp/repo.ts +24 -0
- package/src/cli/mcp/repository-tools.ts +1295 -0
- package/src/cli/mcp/server.ts +341 -0
- package/src/cli/mcp/setup.ts +793 -0
- package/src/cli/mcp/tool-capability-cache.ts +87 -0
- package/src/cli/mcp/tools.ts +9 -0
- package/src/cli/mcp/toolset-names.ts +70 -0
- package/src/cli/mcp/toolset-selection.ts +41 -0
- package/src/cli/mcp/toolset.ts +300 -0
- package/src/cli/mcp/transports/AGENTS.md +39 -0
- package/src/cli/mcp/transports/CLAUDE.md +39 -0
- package/src/cli/mcp/transports/http.ts +1234 -0
- package/src/cli/mcp/transports/session-registry.ts +428 -0
- package/src/cli/mcp/transports/stdio.ts +8 -0
- package/src/cli/mcp/types.ts +41 -0
- package/src/cli/mcp/umbrella-tools.ts +117 -0
- package/src/cli/repo-adoption/reclaim-runtime.ts +681 -0
- package/src/cli/repositories/branch-name-policy.ts +57 -0
- package/src/cli/repositories/command-classifier.ts +600 -0
- package/src/cli/repositories/command-executor.ts +1066 -0
- package/src/cli/repositories/command-normalization.ts +53 -0
- package/src/cli/repositories/command-scope.ts +264 -0
- package/src/cli/repositories/controller-home.ts +88 -0
- package/src/cli/repositories/entity-migration.ts +199 -0
- package/src/cli/repositories/ephemeral-workspace.ts +62 -0
- package/src/cli/repositories/git-command-executor.ts +301 -0
- package/src/cli/repositories/goal-registry.ts +239 -0
- package/src/cli/repositories/identity.ts +64 -0
- package/src/cli/repositories/local-project-onboarding.ts +539 -0
- package/src/cli/repositories/locks.ts +262 -0
- package/src/cli/repositories/registry.ts +1057 -0
- package/src/cli/repositories/runtime-storage.ts +411 -0
- package/src/cli/repositories/safe-patch.ts +421 -0
- package/src/cli/repositories/selected-path-actions.ts +341 -0
- package/src/cli/repositories/structured-git.ts +257 -0
- package/src/cli/repositories/types.ts +155 -0
- package/src/cli/repositories/umbrella.ts +134 -0
- package/src/cli/repositories/workbench.ts +140 -0
- package/src/cli/repositories/worktree-storage.ts +137 -0
- package/src/cli/repository/inspector.ts +637 -0
- package/src/cli/repository/session-cache.ts +453 -0
- package/src/cli/runtime/helper-runner.ts +172 -0
- package/src/cli/runtime-invocation.ts +318 -0
- package/src/cli/tools/codegraph.ts +676 -0
- package/src/cli/v81-entry.ts +29 -0
- package/src/core/adoption/gitignore-plan.ts +127 -0
- package/src/core/adoption/helper-wrapper-plan.ts +159 -0
- package/src/core/adoption/manifest-templates.ts +60 -0
- package/src/core/adoption/modes.ts +7 -0
- package/src/core/adoption/operations.ts +126 -0
- package/src/core/adoption/plan.ts +149 -0
- package/src/core/adoption/render.ts +70 -0
- package/src/core/adoption/rollback.ts +62 -0
- package/src/core/adoption/summary.ts +43 -0
- package/src/core/adoption/workflow-contract-asset.ts +14 -0
- package/src/core/adoption/workflow-contract-plan.ts +31 -0
- package/src/effects/fs-transaction.ts +540 -0
- package/src/effects/git-executable.ts +59 -0
- package/src/effects/managed-block.ts +86 -0
- package/src/effects/path-safety.ts +47 -0
- package/src/effects/process-runner.ts +192 -0
- package/src/runtime/assistant/action-proposals.ts +279 -0
- package/src/runtime/assistant/intent.ts +395 -0
- package/src/runtime/assistant/model-provider.ts +460 -0
- package/src/runtime/assistant/openapi.ts +223 -0
- package/src/runtime/assistant/policy.ts +89 -0
- package/src/runtime/assistant/readiness.ts +258 -0
- package/src/runtime/assistant/routine-runtime.ts +477 -0
- package/src/runtime/assistant/schedule-binding.ts +171 -0
- package/src/runtime/assistant/standing-grants.ts +375 -0
- package/src/runtime/assistant/store.ts +243 -0
- package/src/runtime/assistant/types.ts +135 -0
- package/src/runtime/context/codegraph-read-provider.ts +347 -0
- package/src/runtime/context/codegraph-sidecar.cjs +207 -0
- package/src/runtime/control-plane/dispatch-priority.ts +67 -0
- package/src/runtime/control-plane/execution/direct-edit-work-completion.ts +151 -0
- package/src/runtime/control-plane/execution/execution-identity.ts +456 -0
- package/src/runtime/control-plane/execution/session-store.ts +175 -0
- package/src/runtime/control-plane/execution/validation.ts +117 -0
- package/src/runtime/control-plane/execution/verification-evidence.ts +191 -0
- package/src/runtime/control-plane/execution/work-handle-store.ts +225 -0
- package/src/runtime/control-plane/execution/work-prepare-request-store.ts +159 -0
- package/src/runtime/control-plane/execution/work-task-receipt.ts +445 -0
- package/src/runtime/control-plane/execution/work-terminal-cleanup.ts +821 -0
- package/src/runtime/control-plane/facade/capability-registry.ts +279 -0
- package/src/runtime/control-plane/facade/check-normalization.ts +233 -0
- package/src/runtime/control-plane/facade/codex-delegation.ts +196 -0
- package/src/runtime/control-plane/facade/controller-session-store.ts +199 -0
- package/src/runtime/control-plane/facade/facade-result.ts +41 -0
- package/src/runtime/control-plane/facade/goal-workloop-access.ts +177 -0
- package/src/runtime/control-plane/facade/goal-workloop.ts +1216 -0
- package/src/runtime/control-plane/facade/handoff-inbox-store.ts +221 -0
- package/src/runtime/control-plane/facade/index.ts +16 -0
- package/src/runtime/control-plane/facade/operation-digest.ts +528 -0
- package/src/runtime/control-plane/facade/plan-contract-store.ts +403 -0
- package/src/runtime/control-plane/facade/policy-gate.ts +149 -0
- package/src/runtime/control-plane/facade/requirement-board.ts +280 -0
- package/src/runtime/control-plane/facade/self-healing-loop.ts +555 -0
- package/src/runtime/control-plane/facade/suggested-actions.ts +108 -0
- package/src/runtime/control-plane/facade/types.ts +729 -0
- package/src/runtime/control-plane/facade/work-admission-policy.ts +93 -0
- package/src/runtime/control-plane/facade/work-continuation.ts +104 -0
- package/src/runtime/control-plane/facade/work-contract-store.ts +1118 -0
- package/src/runtime/control-plane/facade/work-task-projection.ts +66 -0
- package/src/runtime/control-plane/global-scheduler/reconciliation.ts +365 -0
- package/src/runtime/control-plane/global-scheduler/scheduler.ts +920 -0
- package/src/runtime/control-plane/global-scheduler/wake-signal.ts +89 -0
- package/src/runtime/control-plane/goal-loop/config-facade.ts +700 -0
- package/src/runtime/control-plane/goal-loop/config-store.ts +570 -0
- package/src/runtime/control-plane/goal-loop/config-types.ts +213 -0
- package/src/runtime/control-plane/goal-loop/executor-router.ts +109 -0
- package/src/runtime/control-plane/goal-loop/failure-taxonomy.ts +149 -0
- package/src/runtime/control-plane/goal-loop/goal-contract-store.ts +304 -0
- package/src/runtime/control-plane/goal-loop/goal-loop-engine.ts +1001 -0
- package/src/runtime/control-plane/goal-loop/handoff-packet.ts +160 -0
- package/src/runtime/control-plane/goal-loop/index.ts +13 -0
- package/src/runtime/control-plane/goal-loop/local-tools.ts +290 -0
- package/src/runtime/control-plane/goal-loop/policy-gates.ts +203 -0
- package/src/runtime/control-plane/goal-loop/provider-dispatch.ts +93 -0
- package/src/runtime/control-plane/goal-loop/provider-registry.ts +545 -0
- package/src/runtime/control-plane/goal-loop/types.ts +378 -0
- package/src/runtime/control-plane/governance/access-policy.ts +147 -0
- package/src/runtime/control-plane/governance/authorization.ts +195 -0
- package/src/runtime/control-plane/governance/external-effects.ts +43 -0
- package/src/runtime/control-plane/launcher/thin-launcher.ts +97 -0
- package/src/runtime/control-plane/persistence/metadata-payload-policy.ts +53 -0
- package/src/runtime/control-plane/persistence/requirement-store.ts +241 -0
- package/src/runtime/control-plane/persistence/sqlite-store.ts +539 -0
- package/src/runtime/control-plane/release-retention.ts +447 -0
- package/src/runtime/control-plane/repo-actor/actor.ts +181 -0
- package/src/runtime/control-plane/repo-actor/registry.ts +20 -0
- package/src/runtime/control-plane/routing/index.ts +1 -0
- package/src/runtime/control-plane/routing/route-policy.ts +379 -0
- package/src/runtime/control-plane/runtime-cleanup.ts +727 -0
- package/src/runtime/control-plane/runtime-generation.ts +509 -0
- package/src/runtime/control-plane/runtime-pid-ownership.ts +11 -0
- package/src/runtime/control-plane/runtime-status-client.ts +90 -0
- package/src/runtime/control-plane/startup-recovery.ts +198 -0
- package/src/runtime/diagnostics/connectivity-observability.ts +475 -0
- package/src/runtime/diagnostics/mcp-timing.ts +64 -0
- package/src/runtime/diagnostics/performance.ts +379 -0
- package/src/runtime/diagnostics/process-facade.ts +350 -0
- package/src/runtime/diagnostics/read-only-tool.ts +226 -0
- package/src/runtime/evidence/artifact-store.ts +154 -0
- package/src/runtime/evidence/event-ledger.ts +80 -0
- package/src/runtime/evidence/evidence-store.ts +68 -0
- package/src/runtime/evidence/process-check-receipt.ts +43 -0
- package/src/runtime/evidence/result-store.ts +209 -0
- package/src/runtime/evidence/sensitive-output.ts +353 -0
- package/src/runtime/execution/jobs/child-reference.ts +124 -0
- package/src/runtime/execution/jobs/legacy-adapter.ts +22 -0
- package/src/runtime/execution/jobs/receipt-recovery.ts +119 -0
- package/src/runtime/execution/jobs/receipt-store.ts +243 -0
- package/src/runtime/execution/jobs/store.ts +737 -0
- package/src/runtime/execution/jobs/timeouts.ts +109 -0
- package/src/runtime/execution/jobs/types.ts +230 -0
- package/src/runtime/execution/jobs/wait.ts +45 -0
- package/src/runtime/execution/process-runtime/canary.ts +26 -0
- package/src/runtime/execution/process-runtime/check-facade.ts +272 -0
- package/src/runtime/execution/process-runtime/check-receipt.ts +185 -0
- package/src/runtime/execution/process-runtime/check-runner-sidecar.ts +60 -0
- package/src/runtime/execution/process-runtime/command-facade.ts +321 -0
- package/src/runtime/execution/process-runtime/gc.ts +171 -0
- package/src/runtime/execution/process-runtime/index.ts +9 -0
- package/src/runtime/execution/process-runtime/interactive-admission.ts +23 -0
- package/src/runtime/execution/process-runtime/process-runner-entry.ts +466 -0
- package/src/runtime/execution/process-runtime/resource-claims.ts +440 -0
- package/src/runtime/execution/process-runtime/runtime.ts +1816 -0
- package/src/runtime/execution/process-runtime/store.ts +687 -0
- package/src/runtime/execution/process-runtime/types.ts +352 -0
- package/src/runtime/execution/thin-harness/async-process.ts +181 -0
- package/src/runtime/execution/thin-harness/batch-executor.ts +671 -0
- package/src/runtime/execution/thin-harness/execution-router.ts +700 -0
- package/src/runtime/execution/thin-harness/fast-executor.ts +1263 -0
- package/src/runtime/execution/thin-harness/fast-receipt.ts +235 -0
- package/src/runtime/execution/thin-harness/fingerprint-worker.ts +191 -0
- package/src/runtime/execution/thin-harness/index.ts +13 -0
- package/src/runtime/execution/thin-harness/latency-trace.ts +107 -0
- package/src/runtime/execution/thin-harness/lightweight-lanes.ts +745 -0
- package/src/runtime/execution/thin-harness/mutation-gate.ts +578 -0
- package/src/runtime/execution/thin-harness/proposal-store.ts +409 -0
- package/src/runtime/execution/thin-harness/request-ledger.ts +595 -0
- package/src/runtime/execution/thin-harness/search-worker.ts +114 -0
- package/src/runtime/execution/thin-harness/types.ts +313 -0
- package/src/runtime/execution/thin-harness/workspace-savepoint.ts +333 -0
- package/src/runtime/execution/workers/executor.ts +687 -0
- package/src/runtime/execution/workers/ownership.ts +94 -0
- package/src/runtime/execution/workers/worker-entry.ts +277 -0
- package/src/runtime/gateway/mcp/execution-tools.ts +2009 -0
- package/src/runtime/gateway/mcp/persisted-check-process.ts +255 -0
- package/src/runtime/gateway/mcp/process-tools.ts +230 -0
- package/src/runtime/gateway/mcp/resource-policy.ts +195 -0
- package/src/runtime/gateway/mcp/router.ts +1088 -0
- package/src/runtime/gateway/mcp/runtime-tools.ts +5994 -0
- package/src/runtime/gateway/mcp/work-validation-reconciler.ts +219 -0
- package/src/runtime/health/evaluator.ts +474 -0
- package/src/runtime/health/index.ts +2 -0
- package/src/runtime/health/operational-view.ts +198 -0
- package/src/runtime/maintenance/cleanup.ts +419 -0
- package/src/runtime/model-clients/deepseek-adapter.ts +312 -0
- package/src/runtime/model-clients/index.ts +2 -0
- package/src/runtime/model-clients/types.ts +101 -0
- package/src/runtime/observability/gateway-contention-metrics.ts +129 -0
- package/src/runtime/observability/route-session-benchmark.ts +110 -0
- package/src/runtime/personal-assistant/gmail-triage-manager.ts +231 -0
- package/src/runtime/personal-assistant/reporting-runtime.ts +344 -0
- package/src/runtime/personal-assistant/triage-runtime.ts +748 -0
- package/src/runtime/plugins/app-store-connect-adapter.ts +868 -0
- package/src/runtime/plugins/browser-adapter.ts +2812 -0
- package/src/runtime/plugins/browser-automation-service.ts +46 -0
- package/src/runtime/plugins/browser-handoff-host.ts +304 -0
- package/src/runtime/plugins/browser-handoff.ts +371 -0
- package/src/runtime/plugins/browser-macos-bridge.ts +865 -0
- package/src/runtime/plugins/browser-node-bridge-host.ts +64 -0
- package/src/runtime/plugins/browser-node-bridge.ts +249 -0
- package/src/runtime/plugins/desktop-adapter.ts +374 -0
- package/src/runtime/plugins/desktop-operator-registration.ts +418 -0
- package/src/runtime/plugins/errors.ts +39 -0
- package/src/runtime/plugins/execution-origin.ts +26 -0
- package/src/runtime/plugins/external-adapter.ts +322 -0
- package/src/runtime/plugins/external-registration.ts +308 -0
- package/src/runtime/plugins/external-unix-socket-probe.cjs +79 -0
- package/src/runtime/plugins/external-unix-socket.ts +238 -0
- package/src/runtime/plugins/first-party-registry.ts +37 -0
- package/src/runtime/plugins/github-adapter.ts +266 -0
- package/src/runtime/plugins/gmail-adapter.ts +729 -0
- package/src/runtime/plugins/google-calendar-adapter.ts +468 -0
- package/src/runtime/plugins/google-shared.ts +578 -0
- package/src/runtime/plugins/google-tasks-adapter.ts +535 -0
- package/src/runtime/plugins/interaction-session.ts +252 -0
- package/src/runtime/plugins/ios/agent-device-capabilities.ts +258 -0
- package/src/runtime/plugins/ios/agent-device-failures.ts +95 -0
- package/src/runtime/plugins/ios/agent-device-provider.ts +63 -0
- package/src/runtime/plugins/ios/agent-device-typed-provider.ts +268 -0
- package/src/runtime/plugins/ios/app-adapters.ts +122 -0
- package/src/runtime/plugins/ios-adapter.ts +509 -0
- package/src/runtime/plugins/ios-agent-device.ts +2311 -0
- package/src/runtime/plugins/ios-physical-device.ts +955 -0
- package/src/runtime/plugins/local-system-adapter.ts +1016 -0
- package/src/runtime/plugins/macos-capability-broker.ts +73 -0
- package/src/runtime/plugins/managed-process-adapter.ts +366 -0
- package/src/runtime/plugins/resend-adapter.ts +506 -0
- package/src/runtime/plugins/store.ts +1025 -0
- package/src/runtime/plugins/types.ts +138 -0
- package/src/runtime/projections/controller-context.ts +596 -0
- package/src/runtime/projections/git-status-sampler.ts +84 -0
- package/src/runtime/projections/invalidation.ts +250 -0
- package/src/runtime/projections/materialized-view.ts +694 -0
- package/src/runtime/recovery/actions.ts +158 -0
- package/src/runtime/recovery/audit.ts +38 -0
- package/src/runtime/recovery/classifier.ts +163 -0
- package/src/runtime/recovery/index.ts +9 -0
- package/src/runtime/recovery/local-jobs-repair.ts +393 -0
- package/src/runtime/recovery/maintenance-executor.ts +822 -0
- package/src/runtime/recovery/patch-handoff.ts +50 -0
- package/src/runtime/recovery/probe.ts +308 -0
- package/src/runtime/recovery/store.ts +35 -0
- package/src/runtime/recovery/types.ts +175 -0
- package/src/runtime/release/identity.ts +101 -0
- package/src/runtime/release/release-gate.ts +137 -0
- package/src/runtime/resources/claims/conflicts.ts +205 -0
- package/src/runtime/resources/index.ts +1 -0
- package/src/runtime/resources/leases/store.ts +539 -0
- package/src/runtime/resources/leases/types.ts +50 -0
- package/src/runtime/resources/ownership.ts +72 -0
- package/src/runtime/root/controller-services.ts +42 -0
- package/src/runtime/root/entry.ts +70 -0
- package/src/runtime/root/gateway-adapter.ts +46 -0
- package/src/runtime/root/local-bridge.ts +72 -0
- package/src/runtime/root/mcp-transport.ts +198 -0
- package/src/runtime/root/ownership.ts +94 -0
- package/src/runtime/root/readiness.ts +69 -0
- package/src/runtime/root/release-manifest.ts +147 -0
- package/src/runtime/root/release-materialize.ts +509 -0
- package/src/runtime/root/release-store.ts +236 -0
- package/src/runtime/root/runtime.ts +318 -0
- package/src/runtime/root/scheduler.ts +58 -0
- package/src/runtime/root/service-runner-entry.ts +20 -0
- package/src/runtime/root/service-runner.ts +69 -0
- package/src/runtime/root/service.ts +291 -0
- package/src/runtime/root/status.ts +127 -0
- package/src/runtime/root/types.ts +112 -0
- package/src/runtime/root/write-fence.ts +309 -0
- package/src/runtime/safe-tooling/browser-safe.ts +133 -0
- package/src/runtime/safe-tooling/external-filesystem.ts +304 -0
- package/src/runtime/safe-tooling/google-credential-store.ts +95 -0
- package/src/runtime/safe-tooling/google-oauth-broker.ts +286 -0
- package/src/runtime/safe-tooling/index.ts +11 -0
- package/src/runtime/safe-tooling/ios-development.ts +1039 -0
- package/src/runtime/safe-tooling/job-summary.ts +361 -0
- package/src/runtime/safe-tooling/plugin-summary.ts +53 -0
- package/src/runtime/safe-tooling/resend-oauth.ts +387 -0
- package/src/runtime/safe-tooling/review-artifacts.ts +133 -0
- package/src/runtime/safe-tooling/types.ts +103 -0
- package/src/runtime/safe-tooling/workspace-auth.ts +116 -0
- package/src/runtime/shared/bounded-child-supervisor.ts +235 -0
- package/src/runtime/shared/idempotent-retry.ts +128 -0
- package/src/runtime/shared/json-files.ts +43 -0
- package/src/runtime/shared/local-bridge-surface.ts +231 -0
- package/src/runtime/shared/managed-env.ts +154 -0
- package/src/runtime/shared/node-ts-loader.mjs +50 -0
- package/src/runtime/shared/process-environment.ts +97 -0
- package/src/runtime/shared/process-identity.ts +72 -0
- package/src/runtime/shared/process-tree.ts +227 -0
- package/src/runtime/shared/response-budget.ts +246 -0
- package/src/runtime/standalone-recovery/core.ts +2275 -0
- package/src/runtime/standalone-recovery/entry.ts +686 -0
- package/src/runtime/standalone-recovery/http-transport.ts +317 -0
- package/src/runtime/standalone-recovery/installer.ts +747 -0
- package/src/runtime/standalone-recovery/release.ts +241 -0
- package/src/runtime/watchdog/workflow-watchdog.ts +118 -0
- package/src/runtime/workflow/campaigns/cleanup.ts +263 -0
- package/src/runtime/workflow/campaigns/engine.ts +112 -0
- package/src/runtime/workflow/campaigns/normalize.ts +100 -0
- package/src/runtime/workflow/campaigns/review.ts +315 -0
- package/src/runtime/workflow/campaigns/store.ts +526 -0
- package/src/runtime/workflow/campaigns/supervisor.ts +112 -0
- package/src/runtime/workflow/campaigns/types.ts +290 -0
- package/src/runtime/workflow/campaigns/workspace-agent.ts +155 -0
- package/src/runtime/workflow/campaigns/workspace.ts +200 -0
- package/src/runtime/workflow/findings/store.ts +165 -0
- package/src/runtime/workflow/findings/types.ts +36 -0
- package/src/runtime/workflow/portfolio/engine.ts +20 -0
- package/src/runtime/workflow/portfolio/store.ts +185 -0
- package/src/runtime/workflow/portfolio/types.ts +29 -0
- package/src/runtime/workflow/schedules/engine.ts +620 -0
- package/src/runtime/workflow/schedules/settlement.ts +144 -0
- package/src/runtime/workflow/schedules/store.ts +417 -0
- package/src/runtime/workflow/schedules/types.ts +124 -0
- package/src/runtime/workspace-targets/index.ts +24 -0
- package/src/runtime/workspace-targets/target-grant.ts +721 -0
- package/src/testing/test-governance.ts +626 -0
- package/src/version.ts +21 -0
|
@@ -0,0 +1,555 @@
|
|
|
1
|
+
import { randomUUID } from 'crypto';
|
|
2
|
+
import { createHandoffItem, type HandoffInboxStoreOptions } from './handoff-inbox-store';
|
|
3
|
+
import { buildFacadeResult } from './facade-result';
|
|
4
|
+
import { evaluatePolicyGate } from './policy-gate';
|
|
5
|
+
import { validateSuggestedNextActions } from './suggested-actions';
|
|
6
|
+
import type { FacadeResult, PolicyDecision, SuggestedNextAction } from './types';
|
|
7
|
+
|
|
8
|
+
export type SelfHealingOperation = 'diagnose' | 'repair' | 'verify' | 'handoff';
|
|
9
|
+
|
|
10
|
+
export type SelfHealingIssueKind =
|
|
11
|
+
| 'stuck_execution_job'
|
|
12
|
+
| 'stale_local_job'
|
|
13
|
+
| 'runtime_projection_dirty'
|
|
14
|
+
| 'mcp_tool_result_too_large'
|
|
15
|
+
| 'invalid_check_id_pollution'
|
|
16
|
+
| 'plugin_capability_unavailable'
|
|
17
|
+
| 'codex_claude_unavailable'
|
|
18
|
+
| 'controller_daemon_health'
|
|
19
|
+
| 'durable_scheduler_health'
|
|
20
|
+
| 'local_bridge_health';
|
|
21
|
+
|
|
22
|
+
export interface SelfHealingIssue {
|
|
23
|
+
kind: SelfHealingIssueKind;
|
|
24
|
+
summary: string;
|
|
25
|
+
severity: 'info' | 'warning' | 'error';
|
|
26
|
+
safeToAutoRepair: boolean;
|
|
27
|
+
requiresApproval: boolean;
|
|
28
|
+
suggestedAction: string;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
export interface SelfHealingInput {
|
|
32
|
+
operation?: SelfHealingOperation;
|
|
33
|
+
/** Defaults to true for diagnose and repair. */
|
|
34
|
+
dryRun?: boolean;
|
|
35
|
+
approvalConfirmed?: boolean;
|
|
36
|
+
workId?: string;
|
|
37
|
+
/** Observed/simulated issues for deterministic testing and facade injection. */
|
|
38
|
+
issues?: SelfHealingIssue[];
|
|
39
|
+
/** Bounded maintenance status snapshot from buildRuntimeMaintenanceStatus (optional). */
|
|
40
|
+
maintenanceStatus?: {
|
|
41
|
+
readyForExecution?: boolean;
|
|
42
|
+
recommendedActions?: string[];
|
|
43
|
+
candidates?: Array<{ kind?: string; reason?: string; suggestedAction?: string; safe?: boolean }>;
|
|
44
|
+
warnings?: string[];
|
|
45
|
+
};
|
|
46
|
+
/** Optional watchdog/performance digests (bounded). */
|
|
47
|
+
diagnostics?: {
|
|
48
|
+
watchdogSummary?: string;
|
|
49
|
+
performanceSummary?: string;
|
|
50
|
+
codexUnavailable?: boolean;
|
|
51
|
+
grokUnavailable?: boolean;
|
|
52
|
+
pluginUnavailable?: boolean;
|
|
53
|
+
controllerDaemonUnhealthy?: boolean;
|
|
54
|
+
schedulerUnhealthy?: boolean;
|
|
55
|
+
localBridgeUnhealthy?: boolean;
|
|
56
|
+
};
|
|
57
|
+
/** ChatGPT pull failure must not become task failure. */
|
|
58
|
+
chatgptPullFailed?: boolean;
|
|
59
|
+
destructive?: boolean;
|
|
60
|
+
remoteEffect?: boolean;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
export interface SelfHealingContext {
|
|
64
|
+
repoId: string;
|
|
65
|
+
handoffStore: HandoffInboxStoreOptions;
|
|
66
|
+
now?: () => string;
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
const DEFAULT_ISSUES: SelfHealingIssue[] = [];
|
|
70
|
+
|
|
71
|
+
function mapMaintenanceCandidate(candidate: {
|
|
72
|
+
kind?: string;
|
|
73
|
+
reason?: string;
|
|
74
|
+
suggestedAction?: string;
|
|
75
|
+
safe?: boolean;
|
|
76
|
+
}): SelfHealingIssue {
|
|
77
|
+
const kindText = `${candidate.kind ?? ''} ${candidate.suggestedAction ?? ''}`.toLowerCase();
|
|
78
|
+
let kind: SelfHealingIssueKind = 'runtime_projection_dirty';
|
|
79
|
+
if (kindText.includes('local_job') || kindText.includes('stale') || kindText.includes('reconcile')) {
|
|
80
|
+
kind = kindText.includes('stuck') ? 'stuck_execution_job' : 'stale_local_job';
|
|
81
|
+
} else if (kindText.includes('projection') || kindText.includes('storage')) {
|
|
82
|
+
kind = 'runtime_projection_dirty';
|
|
83
|
+
}
|
|
84
|
+
const safe = candidate.safe !== false;
|
|
85
|
+
return {
|
|
86
|
+
kind,
|
|
87
|
+
summary: (candidate.reason || candidate.suggestedAction || 'Runtime maintenance candidate').slice(0, 400),
|
|
88
|
+
severity: safe ? 'warning' : 'error',
|
|
89
|
+
safeToAutoRepair: safe,
|
|
90
|
+
requiresApproval: !safe,
|
|
91
|
+
suggestedAction: candidate.suggestedAction || 'runtime_maintenance_status',
|
|
92
|
+
};
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
function defaultDiagnoseIssues(input: SelfHealingInput): SelfHealingIssue[] {
|
|
96
|
+
if (input.issues && input.issues.length > 0) return input.issues;
|
|
97
|
+
const issues: SelfHealingIssue[] = [...DEFAULT_ISSUES];
|
|
98
|
+
if (input.chatgptPullFailed) {
|
|
99
|
+
issues.push({
|
|
100
|
+
kind: 'mcp_tool_result_too_large',
|
|
101
|
+
summary: 'ChatGPT pull/result delivery failed or exceeded bounds; treat as bounded artifact/handoff/retry, not task failure.',
|
|
102
|
+
severity: 'warning',
|
|
103
|
+
safeToAutoRepair: true,
|
|
104
|
+
requiresApproval: false,
|
|
105
|
+
suggestedAction: 'retry_with_bounded_artifact',
|
|
106
|
+
});
|
|
107
|
+
}
|
|
108
|
+
for (const candidate of input.maintenanceStatus?.candidates ?? []) {
|
|
109
|
+
issues.push(mapMaintenanceCandidate(candidate));
|
|
110
|
+
}
|
|
111
|
+
if (input.diagnostics?.codexUnavailable || input.diagnostics?.grokUnavailable) {
|
|
112
|
+
issues.push({
|
|
113
|
+
kind: 'codex_claude_unavailable',
|
|
114
|
+
summary: 'Codex/Grok small-brain helper unavailable; prefer handoff or retry, not acceptance failure.',
|
|
115
|
+
severity: 'warning',
|
|
116
|
+
safeToAutoRepair: false,
|
|
117
|
+
requiresApproval: false,
|
|
118
|
+
suggestedAction: 'handoff_or_retry_later',
|
|
119
|
+
});
|
|
120
|
+
}
|
|
121
|
+
if (input.diagnostics?.pluginUnavailable) {
|
|
122
|
+
issues.push({
|
|
123
|
+
kind: 'plugin_capability_unavailable',
|
|
124
|
+
summary: 'Plugin capability unavailable.',
|
|
125
|
+
severity: 'warning',
|
|
126
|
+
safeToAutoRepair: false,
|
|
127
|
+
requiresApproval: false,
|
|
128
|
+
suggestedAction: 'handoff_or_retry_later',
|
|
129
|
+
});
|
|
130
|
+
}
|
|
131
|
+
if (input.diagnostics?.controllerDaemonUnhealthy) {
|
|
132
|
+
issues.push({
|
|
133
|
+
kind: 'controller_daemon_health',
|
|
134
|
+
summary: 'Forge Runtime health issue detected. Runtime lifecycle recovery belongs to the external owner of the existing single Runtime.',
|
|
135
|
+
severity: 'error',
|
|
136
|
+
safeToAutoRepair: false,
|
|
137
|
+
requiresApproval: false,
|
|
138
|
+
suggestedAction: 'external_runtime_lifecycle_handoff',
|
|
139
|
+
});
|
|
140
|
+
}
|
|
141
|
+
if (input.diagnostics?.schedulerUnhealthy) {
|
|
142
|
+
issues.push({
|
|
143
|
+
kind: 'durable_scheduler_health',
|
|
144
|
+
summary: 'Durable scheduler heartbeat is stale or unavailable; inspect bounded runtime maintenance state.',
|
|
145
|
+
severity: 'error',
|
|
146
|
+
safeToAutoRepair: false,
|
|
147
|
+
requiresApproval: false,
|
|
148
|
+
suggestedAction: 'runtime_maintenance_status',
|
|
149
|
+
});
|
|
150
|
+
}
|
|
151
|
+
if (input.diagnostics?.localBridgeUnhealthy) {
|
|
152
|
+
issues.push({
|
|
153
|
+
kind: 'local_bridge_health',
|
|
154
|
+
summary: 'Local bridge health issue detected; use bounded handoff or retry rather than a component restart.',
|
|
155
|
+
severity: 'error',
|
|
156
|
+
safeToAutoRepair: false,
|
|
157
|
+
requiresApproval: false,
|
|
158
|
+
suggestedAction: 'handoff_or_retry_later',
|
|
159
|
+
});
|
|
160
|
+
}
|
|
161
|
+
return issues;
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
function repairPlanFor(issue: SelfHealingIssue): {
|
|
165
|
+
action: string;
|
|
166
|
+
dryRunDefault: boolean;
|
|
167
|
+
approvalRequired: boolean;
|
|
168
|
+
risk: 'readonly' | 'workspace_write' | 'destructive' | 'remote_write';
|
|
169
|
+
} {
|
|
170
|
+
switch (issue.kind) {
|
|
171
|
+
case 'stuck_execution_job':
|
|
172
|
+
case 'stale_local_job':
|
|
173
|
+
return {
|
|
174
|
+
action: 'reconcile_local_jobs',
|
|
175
|
+
dryRunDefault: true,
|
|
176
|
+
approvalRequired: false,
|
|
177
|
+
risk: 'workspace_write',
|
|
178
|
+
};
|
|
179
|
+
case 'runtime_projection_dirty':
|
|
180
|
+
return {
|
|
181
|
+
action: 'rebuild_projection',
|
|
182
|
+
dryRunDefault: true,
|
|
183
|
+
approvalRequired: false,
|
|
184
|
+
risk: 'workspace_write',
|
|
185
|
+
};
|
|
186
|
+
case 'mcp_tool_result_too_large':
|
|
187
|
+
return {
|
|
188
|
+
action: 'bound_and_retry_artifact',
|
|
189
|
+
dryRunDefault: true,
|
|
190
|
+
approvalRequired: false,
|
|
191
|
+
risk: 'readonly',
|
|
192
|
+
};
|
|
193
|
+
case 'invalid_check_id_pollution':
|
|
194
|
+
return {
|
|
195
|
+
action: 'normalize_and_drop_invalid_check_ids',
|
|
196
|
+
dryRunDefault: true,
|
|
197
|
+
approvalRequired: false,
|
|
198
|
+
risk: 'readonly',
|
|
199
|
+
};
|
|
200
|
+
case 'plugin_capability_unavailable':
|
|
201
|
+
case 'codex_claude_unavailable':
|
|
202
|
+
return {
|
|
203
|
+
action: 'handoff_or_retry_later',
|
|
204
|
+
dryRunDefault: true,
|
|
205
|
+
approvalRequired: false,
|
|
206
|
+
risk: 'readonly',
|
|
207
|
+
};
|
|
208
|
+
case 'controller_daemon_health':
|
|
209
|
+
return {
|
|
210
|
+
action: 'external_runtime_lifecycle_handoff',
|
|
211
|
+
dryRunDefault: true,
|
|
212
|
+
approvalRequired: false,
|
|
213
|
+
risk: 'readonly',
|
|
214
|
+
};
|
|
215
|
+
case 'durable_scheduler_health':
|
|
216
|
+
return {
|
|
217
|
+
action: 'runtime_maintenance_status',
|
|
218
|
+
dryRunDefault: true,
|
|
219
|
+
approvalRequired: false,
|
|
220
|
+
risk: 'readonly',
|
|
221
|
+
};
|
|
222
|
+
case 'local_bridge_health':
|
|
223
|
+
return {
|
|
224
|
+
action: 'handoff_or_retry_later',
|
|
225
|
+
dryRunDefault: true,
|
|
226
|
+
approvalRequired: false,
|
|
227
|
+
risk: 'readonly',
|
|
228
|
+
};
|
|
229
|
+
default:
|
|
230
|
+
return {
|
|
231
|
+
action: 'diagnose_only',
|
|
232
|
+
dryRunDefault: true,
|
|
233
|
+
approvalRequired: true,
|
|
234
|
+
risk: 'readonly',
|
|
235
|
+
};
|
|
236
|
+
}
|
|
237
|
+
}
|
|
238
|
+
|
|
239
|
+
function verificationSuggestion(workId?: string): SuggestedNextAction {
|
|
240
|
+
return {
|
|
241
|
+
label: 'Verify controller status after repair',
|
|
242
|
+
tool: 'rh_status',
|
|
243
|
+
operation: 'get',
|
|
244
|
+
payload: workId ? { work_id: workId } : undefined,
|
|
245
|
+
risk: 'readonly',
|
|
246
|
+
confidence: 'high',
|
|
247
|
+
reason: 'Repair must be followed by a real verification action.',
|
|
248
|
+
};
|
|
249
|
+
}
|
|
250
|
+
|
|
251
|
+
export function runSelfHealingLoop(ctx: SelfHealingContext, input: SelfHealingInput = {}): FacadeResult {
|
|
252
|
+
const operation: SelfHealingOperation = input.operation ?? 'diagnose';
|
|
253
|
+
// diagnose and repair default to dry_run=true unless explicitly false.
|
|
254
|
+
const dryRun = input.dryRun === undefined ? true : input.dryRun === true;
|
|
255
|
+
const issues = defaultDiagnoseIssues(input);
|
|
256
|
+
|
|
257
|
+
if (operation === 'diagnose') {
|
|
258
|
+
const plans = issues.map((issue) => ({
|
|
259
|
+
issue,
|
|
260
|
+
plan: repairPlanFor(issue),
|
|
261
|
+
}));
|
|
262
|
+
const suggested = validateSuggestedNextActions([
|
|
263
|
+
...(issues.length > 0
|
|
264
|
+
? [{
|
|
265
|
+
label: 'Preview repair (dry-run)',
|
|
266
|
+
tool: 'rh_work' as const,
|
|
267
|
+
operation: 'repair',
|
|
268
|
+
payload: { repair_operation: 'repair', dry_run: true, work_id: input.workId },
|
|
269
|
+
risk: 'readonly' as const,
|
|
270
|
+
confidence: 'high' as const,
|
|
271
|
+
}]
|
|
272
|
+
: [{
|
|
273
|
+
label: 'Controller status',
|
|
274
|
+
tool: 'rh_status' as const,
|
|
275
|
+
operation: 'get',
|
|
276
|
+
risk: 'readonly' as const,
|
|
277
|
+
confidence: 'medium' as const,
|
|
278
|
+
}]),
|
|
279
|
+
verificationSuggestion(input.workId),
|
|
280
|
+
]).actions;
|
|
281
|
+
|
|
282
|
+
return buildFacadeResult({
|
|
283
|
+
status: 'ok',
|
|
284
|
+
summary: issues.length
|
|
285
|
+
? `Diagnosed ${issues.length} self-healing issue(s). dry_run=${dryRun}.`
|
|
286
|
+
: 'No self-healing issues diagnosed.',
|
|
287
|
+
data: {
|
|
288
|
+
operation: 'diagnose',
|
|
289
|
+
dryRun: true,
|
|
290
|
+
issues,
|
|
291
|
+
plans,
|
|
292
|
+
maintenance: input.maintenanceStatus
|
|
293
|
+
? {
|
|
294
|
+
readyForExecution: input.maintenanceStatus.readyForExecution,
|
|
295
|
+
recommendedActions: (input.maintenanceStatus.recommendedActions ?? []).slice(0, 10),
|
|
296
|
+
candidateCount: input.maintenanceStatus.candidates?.length ?? 0,
|
|
297
|
+
}
|
|
298
|
+
: undefined,
|
|
299
|
+
diagnostics: input.diagnostics
|
|
300
|
+
? {
|
|
301
|
+
watchdogSummary: input.diagnostics.watchdogSummary?.slice(0, 240),
|
|
302
|
+
performanceSummary: input.diagnostics.performanceSummary?.slice(0, 240),
|
|
303
|
+
}
|
|
304
|
+
: undefined,
|
|
305
|
+
linkedTools: [
|
|
306
|
+
'runtime_maintenance_status',
|
|
307
|
+
'runtime_maintenance_apply',
|
|
308
|
+
'workflow_watchdog_report',
|
|
309
|
+
'runtime_performance_diagnostics',
|
|
310
|
+
],
|
|
311
|
+
isAcceptanceFailure: false,
|
|
312
|
+
chatgptPullFailed: input.chatgptPullFailed === true,
|
|
313
|
+
},
|
|
314
|
+
warnings: [
|
|
315
|
+
...(input.chatgptPullFailed
|
|
316
|
+
? ['ChatGPT pull failure is not a task/acceptance failure; use bounded artifact, handoff, or retry.']
|
|
317
|
+
: []),
|
|
318
|
+
...(input.maintenanceStatus?.warnings ?? []).slice(0, 5),
|
|
319
|
+
],
|
|
320
|
+
suggestedNextActions: suggested,
|
|
321
|
+
rawAvailable: false,
|
|
322
|
+
});
|
|
323
|
+
}
|
|
324
|
+
|
|
325
|
+
if (operation === 'verify') {
|
|
326
|
+
return buildFacadeResult({
|
|
327
|
+
status: 'ok',
|
|
328
|
+
summary: 'Self-healing verification suggestion only; run real registered checks via rh_work verify or rh_status.',
|
|
329
|
+
data: {
|
|
330
|
+
operation: 'verify',
|
|
331
|
+
dryRun,
|
|
332
|
+
isAcceptanceFailure: false,
|
|
333
|
+
},
|
|
334
|
+
suggestedNextActions: validateSuggestedNextActions([
|
|
335
|
+
verificationSuggestion(input.workId),
|
|
336
|
+
{
|
|
337
|
+
label: 'Run work verify if work_id known',
|
|
338
|
+
tool: 'rh_work',
|
|
339
|
+
operation: 'verify',
|
|
340
|
+
payload: { work_id: input.workId },
|
|
341
|
+
risk: 'workspace_write',
|
|
342
|
+
confidence: input.workId ? 'medium' : 'low',
|
|
343
|
+
},
|
|
344
|
+
]).actions,
|
|
345
|
+
});
|
|
346
|
+
}
|
|
347
|
+
|
|
348
|
+
if (operation === 'handoff') {
|
|
349
|
+
const handoff = createHandoffItem(ctx.handoffStore, {
|
|
350
|
+
id: `hnd-heal-${randomUUID().slice(0, 8)}`,
|
|
351
|
+
repoId: ctx.repoId,
|
|
352
|
+
workId: input.workId,
|
|
353
|
+
title: 'Self-healing needs judgement',
|
|
354
|
+
severity: 'needs_review',
|
|
355
|
+
creationReason: 'repeated_infrastructure_failure',
|
|
356
|
+
reason: 'Self-healing could not safely complete without ChatGPT or user decision.',
|
|
357
|
+
summary: issues.map((issue) => issue.summary).join(' | ').slice(0, 500) || 'Manual recovery decision required.',
|
|
358
|
+
currentState: {
|
|
359
|
+
repoId: ctx.repoId,
|
|
360
|
+
workId: input.workId,
|
|
361
|
+
statusSummary: 'self-healing handoff pending',
|
|
362
|
+
},
|
|
363
|
+
attemptedActions: ['self_healing_diagnose', 'self_healing_repair'],
|
|
364
|
+
evidenceRefs: [],
|
|
365
|
+
blockingDecision: 'Choose bounded metadata repair, external lifecycle handoff, retry later, or re-scope work.',
|
|
366
|
+
recommendedDecision: 'Prefer safe dry-run repairs; Runtime lifecycle changes belong to the external lifecycle owner.',
|
|
367
|
+
recommendedPrompt: 'Review self-healing handoff and choose repair or stop.',
|
|
368
|
+
suggestedNextActions: [
|
|
369
|
+
{
|
|
370
|
+
label: 'Diagnose again (dry-run)',
|
|
371
|
+
tool: 'rh_work',
|
|
372
|
+
operation: 'repair',
|
|
373
|
+
payload: { repair_operation: 'diagnose', dry_run: true },
|
|
374
|
+
risk: 'readonly',
|
|
375
|
+
},
|
|
376
|
+
],
|
|
377
|
+
});
|
|
378
|
+
|
|
379
|
+
return buildFacadeResult({
|
|
380
|
+
status: 'blocked',
|
|
381
|
+
summary: `Self-healing handoff ${handoff.id} created.`,
|
|
382
|
+
data: {
|
|
383
|
+
operation: 'handoff',
|
|
384
|
+
handoffId: handoff.id,
|
|
385
|
+
isAcceptanceFailure: false,
|
|
386
|
+
},
|
|
387
|
+
suggestedNextActions: [
|
|
388
|
+
{
|
|
389
|
+
label: 'Get handoff',
|
|
390
|
+
tool: 'rh_inbox',
|
|
391
|
+
operation: 'get',
|
|
392
|
+
payload: { handoff_id: handoff.id },
|
|
393
|
+
risk: 'readonly',
|
|
394
|
+
},
|
|
395
|
+
],
|
|
396
|
+
});
|
|
397
|
+
}
|
|
398
|
+
|
|
399
|
+
// operation === 'repair'
|
|
400
|
+
const needsStrongApproval =
|
|
401
|
+
input.destructive === true
|
|
402
|
+
|| input.remoteEffect === true
|
|
403
|
+
|| issues.some((issue) => issue.requiresApproval);
|
|
404
|
+
|
|
405
|
+
// Safe maintenance is allowed without ChatGPT approval; destructive/remote effects stay gated.
|
|
406
|
+
const policy: PolicyDecision = dryRun
|
|
407
|
+
? {
|
|
408
|
+
decision: 'dry_run_only',
|
|
409
|
+
reason: 'Repair is dry-run only; no mutation applied.',
|
|
410
|
+
capabilityId: 'maintenance.safe_repair',
|
|
411
|
+
warnings: [],
|
|
412
|
+
suggestedNextActions: [],
|
|
413
|
+
}
|
|
414
|
+
: needsStrongApproval
|
|
415
|
+
? evaluatePolicyGate({
|
|
416
|
+
capabilityId: 'maintenance.safe_repair',
|
|
417
|
+
risk: 'destructive',
|
|
418
|
+
dryRun: false,
|
|
419
|
+
approvalConfirmed: input.approvalConfirmed === true,
|
|
420
|
+
sideEffect: 'destructive_remote',
|
|
421
|
+
})
|
|
422
|
+
: {
|
|
423
|
+
decision: 'allowed',
|
|
424
|
+
reason: 'Safe maintenance actions are allowed without destructive side effects.',
|
|
425
|
+
capabilityId: 'maintenance.safe_repair',
|
|
426
|
+
warnings: [],
|
|
427
|
+
suggestedNextActions: [],
|
|
428
|
+
};
|
|
429
|
+
|
|
430
|
+
if (dryRun) {
|
|
431
|
+
const plans = issues.map((issue) => ({ issue, plan: repairPlanFor(issue) }));
|
|
432
|
+
return buildFacadeResult({
|
|
433
|
+
status: 'ok',
|
|
434
|
+
summary: `Repair dry-run preview for ${issues.length} issue(s). No mutation applied.`,
|
|
435
|
+
data: {
|
|
436
|
+
operation: 'repair',
|
|
437
|
+
dryRun: true,
|
|
438
|
+
applied: false,
|
|
439
|
+
plans,
|
|
440
|
+
policy,
|
|
441
|
+
isAcceptanceFailure: false,
|
|
442
|
+
},
|
|
443
|
+
suggestedNextActions: validateSuggestedNextActions([
|
|
444
|
+
{
|
|
445
|
+
label: 'Apply safe repair (requires approval if destructive)',
|
|
446
|
+
tool: 'rh_work',
|
|
447
|
+
operation: 'repair',
|
|
448
|
+
payload: {
|
|
449
|
+
repair_operation: 'repair',
|
|
450
|
+
dry_run: false,
|
|
451
|
+
approval_confirmed: needsStrongApproval,
|
|
452
|
+
work_id: input.workId,
|
|
453
|
+
},
|
|
454
|
+
risk: needsStrongApproval ? 'destructive' : 'workspace_write',
|
|
455
|
+
confidence: 'medium',
|
|
456
|
+
},
|
|
457
|
+
verificationSuggestion(input.workId),
|
|
458
|
+
]).actions,
|
|
459
|
+
warnings: policy.warnings,
|
|
460
|
+
});
|
|
461
|
+
}
|
|
462
|
+
|
|
463
|
+
if (policy.decision === 'approval_required' || policy.decision === 'denied') {
|
|
464
|
+
const handoff = createHandoffItem(ctx.handoffStore, {
|
|
465
|
+
id: `hnd-heal-approval-${randomUUID().slice(0, 8)}`,
|
|
466
|
+
repoId: ctx.repoId,
|
|
467
|
+
workId: input.workId,
|
|
468
|
+
title: 'Repair requires approval',
|
|
469
|
+
severity: 'blocked',
|
|
470
|
+
creationReason: input.destructive
|
|
471
|
+
? 'destructive_action_requires_confirmation'
|
|
472
|
+
: 'policy_approval_required',
|
|
473
|
+
reason: policy.reason,
|
|
474
|
+
summary: 'Destructive or remote repair requires explicit approval.',
|
|
475
|
+
currentState: {
|
|
476
|
+
repoId: ctx.repoId,
|
|
477
|
+
workId: input.workId,
|
|
478
|
+
statusSummary: 'repair blocked pending approval',
|
|
479
|
+
},
|
|
480
|
+
attemptedActions: ['self_healing_repair'],
|
|
481
|
+
evidenceRefs: [],
|
|
482
|
+
blockingDecision: 'Confirm destructive repair authorization or keep dry-run only.',
|
|
483
|
+
recommendedDecision: 'Approve only if a destructive or remote effect is intended.',
|
|
484
|
+
recommendedPrompt: 'Approve or dismiss self-healing repair.',
|
|
485
|
+
suggestedNextActions: [
|
|
486
|
+
{
|
|
487
|
+
label: 'List handoffs',
|
|
488
|
+
tool: 'rh_inbox',
|
|
489
|
+
operation: 'list',
|
|
490
|
+
risk: 'readonly',
|
|
491
|
+
},
|
|
492
|
+
],
|
|
493
|
+
});
|
|
494
|
+
|
|
495
|
+
return buildFacadeResult({
|
|
496
|
+
status: 'approval_required',
|
|
497
|
+
summary: `Repair not applied: ${policy.decision}. Handoff ${handoff.id} created.`,
|
|
498
|
+
data: {
|
|
499
|
+
operation: 'repair',
|
|
500
|
+
dryRun: false,
|
|
501
|
+
applied: false,
|
|
502
|
+
policy,
|
|
503
|
+
handoffId: handoff.id,
|
|
504
|
+
isAcceptanceFailure: false,
|
|
505
|
+
},
|
|
506
|
+
suggestedNextActions: [
|
|
507
|
+
{
|
|
508
|
+
label: 'Read approval handoff',
|
|
509
|
+
tool: 'rh_inbox',
|
|
510
|
+
operation: 'get',
|
|
511
|
+
payload: { handoff_id: handoff.id },
|
|
512
|
+
risk: 'readonly',
|
|
513
|
+
},
|
|
514
|
+
],
|
|
515
|
+
});
|
|
516
|
+
}
|
|
517
|
+
|
|
518
|
+
// This facade is policy/planning only. Never claim a mutation succeeded unless
|
|
519
|
+
// the Runtime caller has executed the authoritative maintenance executor.
|
|
520
|
+
const eligible = issues
|
|
521
|
+
.filter((issue) => issue.safeToAutoRepair && !issue.requiresApproval)
|
|
522
|
+
.map((issue) => ({
|
|
523
|
+
kind: issue.kind,
|
|
524
|
+
action: repairPlanFor(issue).action,
|
|
525
|
+
result: 'executor_required',
|
|
526
|
+
}));
|
|
527
|
+
|
|
528
|
+
return buildFacadeResult({
|
|
529
|
+
status: eligible.length > 0 ? 'blocked' : 'ok',
|
|
530
|
+
summary: eligible.length > 0
|
|
531
|
+
? `Safe repair has ${eligible.length} eligible maintenance action(s), but no maintenance executor result was provided; no mutation reported.`
|
|
532
|
+
: 'No safe maintenance mutation was required.',
|
|
533
|
+
data: {
|
|
534
|
+
operation: 'repair',
|
|
535
|
+
dryRun: false,
|
|
536
|
+
applied: false,
|
|
537
|
+
actions: eligible,
|
|
538
|
+
isAcceptanceFailure: false,
|
|
539
|
+
// Infrastructure recovery must not be framed as acceptance failure.
|
|
540
|
+
classification: 'infrastructure_recovery',
|
|
541
|
+
},
|
|
542
|
+
suggestedNextActions: validateSuggestedNextActions([
|
|
543
|
+
verificationSuggestion(input.workId),
|
|
544
|
+
{
|
|
545
|
+
label: 'Continue work if applicable',
|
|
546
|
+
tool: 'rh_work',
|
|
547
|
+
operation: 'continue',
|
|
548
|
+
payload: { work_id: input.workId },
|
|
549
|
+
risk: 'readonly',
|
|
550
|
+
confidence: input.workId ? 'medium' : 'low',
|
|
551
|
+
},
|
|
552
|
+
]).actions,
|
|
553
|
+
rawAvailable: false,
|
|
554
|
+
});
|
|
555
|
+
}
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
import { FACADE_TOOLS, type EvidenceRef, type FacadeTool, type SuggestedNextAction } from './types';
|
|
2
|
+
|
|
3
|
+
function expectedActionRisk(action: SuggestedNextAction): SuggestedNextAction['risk'] | undefined {
|
|
4
|
+
if (action.tool !== 'rh_work') return undefined;
|
|
5
|
+
switch (action.operation) {
|
|
6
|
+
case 'start':
|
|
7
|
+
case 'continue':
|
|
8
|
+
case 'verify':
|
|
9
|
+
case 'repair':
|
|
10
|
+
case 'stop':
|
|
11
|
+
case 'delegate':
|
|
12
|
+
case 'controller_claim':
|
|
13
|
+
case 'controller_release':
|
|
14
|
+
case 'launcher_start':
|
|
15
|
+
return 'workspace_write';
|
|
16
|
+
case 'controller_get_owner':
|
|
17
|
+
return 'readonly';
|
|
18
|
+
case 'plan_create':
|
|
19
|
+
case 'plan_get':
|
|
20
|
+
case 'plan_list':
|
|
21
|
+
return 'readonly';
|
|
22
|
+
case 'plan_approve':
|
|
23
|
+
case 'plan_supersede':
|
|
24
|
+
return 'workspace_write';
|
|
25
|
+
case 'finalize':
|
|
26
|
+
return 'local_repo_write';
|
|
27
|
+
default:
|
|
28
|
+
return undefined;
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
const ALLOWED_FACADE_OPERATIONS: Record<FacadeTool, readonly string[]> = {
|
|
33
|
+
rh_access: ['get', 'preview', 'set'],
|
|
34
|
+
rh_status: ['list', 'get', 'repair'],
|
|
35
|
+
rh_inbox: ['list', 'get', 'ack', 'accept', 'resolve', 'dismiss', 'create'],
|
|
36
|
+
rh_context: ['list', 'get', 'search'],
|
|
37
|
+
rh_work: ['start', 'continue', 'verify', 'repair', 'finalize', 'stop', 'delegate', 'controller_claim', 'controller_release', 'controller_get_owner', 'launcher_start', 'plan_create', 'plan_get', 'plan_list', 'plan_approve', 'plan_supersede'],
|
|
38
|
+
};
|
|
39
|
+
|
|
40
|
+
export interface SuggestedActionValidationOptions {
|
|
41
|
+
validCheckIds?: readonly string[];
|
|
42
|
+
evidenceRefs?: readonly EvidenceRef[];
|
|
43
|
+
validHandoffIds?: readonly string[];
|
|
44
|
+
validWorkIds?: readonly string[];
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
export interface SuggestedActionValidationResult {
|
|
48
|
+
actions: SuggestedNextAction[];
|
|
49
|
+
warnings: string[];
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
function actionUsesKnownCheck(action: SuggestedNextAction, validCheckIds: readonly string[] | undefined): boolean {
|
|
53
|
+
if (!validCheckIds || validCheckIds.length === 0) return true;
|
|
54
|
+
const checkId = action.payload && typeof action.payload.check_id === 'string' ? action.payload.check_id : undefined;
|
|
55
|
+
return !checkId || validCheckIds.includes(checkId);
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
function actionUsesKnownHandoff(action: SuggestedNextAction, validHandoffIds: readonly string[] | undefined): boolean {
|
|
59
|
+
if (!validHandoffIds || validHandoffIds.length === 0) return true;
|
|
60
|
+
const handoffId = action.payload && typeof action.payload.handoff_id === 'string' ? action.payload.handoff_id : undefined;
|
|
61
|
+
return !handoffId || validHandoffIds.includes(handoffId);
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
function actionUsesKnownWork(action: SuggestedNextAction, validWorkIds: readonly string[] | undefined): boolean {
|
|
65
|
+
if (!validWorkIds || validWorkIds.length === 0) return true;
|
|
66
|
+
const workId = action.payload && typeof action.payload.work_id === 'string' ? action.payload.work_id : undefined;
|
|
67
|
+
return !workId || validWorkIds.includes(workId);
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
export function allowedFacadeOperations(tool: FacadeTool): readonly string[] {
|
|
71
|
+
return ALLOWED_FACADE_OPERATIONS[tool];
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
export function validateSuggestedNextActions(
|
|
75
|
+
actions: readonly SuggestedNextAction[],
|
|
76
|
+
options: SuggestedActionValidationOptions = {},
|
|
77
|
+
): SuggestedActionValidationResult {
|
|
78
|
+
const warnings: string[] = [];
|
|
79
|
+
const valid = actions.flatMap((action) => {
|
|
80
|
+
if (!FACADE_TOOLS.includes(action.tool)) {
|
|
81
|
+
warnings.push(`Dropped suggested action ${action.label}: unsupported facade tool ${String(action.tool)}.`);
|
|
82
|
+
return [];
|
|
83
|
+
}
|
|
84
|
+
if (!ALLOWED_FACADE_OPERATIONS[action.tool].includes(action.operation)) {
|
|
85
|
+
warnings.push(`Dropped suggested action ${action.label}: unsupported ${action.tool}.${action.operation}.`);
|
|
86
|
+
return [];
|
|
87
|
+
}
|
|
88
|
+
if (!actionUsesKnownCheck(action, options.validCheckIds)) {
|
|
89
|
+
warnings.push(`Dropped suggested action ${action.label}: invalid check_id ${String(action.payload?.check_id)}.`);
|
|
90
|
+
return [];
|
|
91
|
+
}
|
|
92
|
+
if (!actionUsesKnownHandoff(action, options.validHandoffIds)) {
|
|
93
|
+
warnings.push(`Dropped suggested action ${action.label}: invalid handoff_id ${String(action.payload?.handoff_id)}.`);
|
|
94
|
+
return [];
|
|
95
|
+
}
|
|
96
|
+
if (!actionUsesKnownWork(action, options.validWorkIds)) {
|
|
97
|
+
warnings.push(`Dropped suggested action ${action.label}: invalid work_id ${String(action.payload?.work_id)}.`);
|
|
98
|
+
return [];
|
|
99
|
+
}
|
|
100
|
+
const expectedRisk = expectedActionRisk(action);
|
|
101
|
+
if (expectedRisk && action.risk !== expectedRisk) {
|
|
102
|
+
warnings.push(`Corrected suggested action ${action.label}: ${action.tool}.${action.operation} risk ${action.risk} -> ${expectedRisk}.`);
|
|
103
|
+
return [{ ...action, risk: expectedRisk }];
|
|
104
|
+
}
|
|
105
|
+
return [action];
|
|
106
|
+
});
|
|
107
|
+
return { actions: valid.slice(0, 8), warnings };
|
|
108
|
+
}
|