@memnexus-ai/mx-agent-cli 0.1.294 → 0.1.296-next.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/dist/__tests__/agents-md-canonicalization.test.js +31 -1
- package/dist/__tests__/agents-md-canonicalization.test.js.map +1 -1
- package/dist/__tests__/behavioral-extraction.test.js +50 -0
- package/dist/__tests__/behavioral-extraction.test.js.map +1 -1
- package/dist/__tests__/bootstrap-behavioral-contract.test.js +6 -3
- package/dist/__tests__/bootstrap-behavioral-contract.test.js.map +1 -1
- package/dist/__tests__/bundle-config.test.js +28 -2
- package/dist/__tests__/bundle-config.test.js.map +1 -1
- package/dist/__tests__/catalog-interaction.test.d.ts +25 -0
- package/dist/__tests__/catalog-interaction.test.d.ts.map +1 -0
- package/dist/__tests__/catalog-interaction.test.js +269 -0
- package/dist/__tests__/catalog-interaction.test.js.map +1 -0
- package/dist/__tests__/catalog-named-memories.test.d.ts +2 -0
- package/dist/__tests__/catalog-named-memories.test.d.ts.map +1 -0
- package/dist/__tests__/catalog-named-memories.test.js +204 -0
- package/dist/__tests__/catalog-named-memories.test.js.map +1 -0
- package/dist/__tests__/catalog-origin-main.test.d.ts +15 -0
- package/dist/__tests__/catalog-origin-main.test.d.ts.map +1 -0
- package/dist/__tests__/catalog-origin-main.test.js +296 -0
- package/dist/__tests__/catalog-origin-main.test.js.map +1 -0
- package/dist/__tests__/catalog.test.d.ts +2 -0
- package/dist/__tests__/catalog.test.d.ts.map +1 -0
- package/dist/__tests__/catalog.test.js +131 -0
- package/dist/__tests__/catalog.test.js.map +1 -0
- package/dist/__tests__/claude-local-sanitizer.test.d.ts +24 -0
- package/dist/__tests__/claude-local-sanitizer.test.d.ts.map +1 -0
- package/dist/__tests__/claude-local-sanitizer.test.js +906 -0
- package/dist/__tests__/claude-local-sanitizer.test.js.map +1 -0
- package/dist/__tests__/cli-build-integration.test.d.ts +2 -0
- package/dist/__tests__/cli-build-integration.test.d.ts.map +1 -0
- package/dist/__tests__/cli-build-integration.test.js +64 -0
- package/dist/__tests__/cli-build-integration.test.js.map +1 -0
- package/dist/__tests__/cli-build.test.d.ts +2 -0
- package/dist/__tests__/cli-build.test.d.ts.map +1 -0
- package/dist/__tests__/cli-build.test.js +640 -0
- package/dist/__tests__/cli-build.test.js.map +1 -0
- package/dist/__tests__/codex-deploy-config.test.js +60 -0
- package/dist/__tests__/codex-deploy-config.test.js.map +1 -1
- package/dist/__tests__/completion-rows-discriminate.test.d.ts +20 -0
- package/dist/__tests__/completion-rows-discriminate.test.d.ts.map +1 -0
- package/dist/__tests__/completion-rows-discriminate.test.js +481 -0
- package/dist/__tests__/completion-rows-discriminate.test.js.map +1 -0
- package/dist/__tests__/config-fidelity-archived-symlinks.test.d.ts +2 -0
- package/dist/__tests__/config-fidelity-archived-symlinks.test.d.ts.map +1 -0
- package/dist/__tests__/config-fidelity-archived-symlinks.test.js +127 -0
- package/dist/__tests__/config-fidelity-archived-symlinks.test.js.map +1 -0
- package/dist/__tests__/config-fidelity-display.test.d.ts +2 -0
- package/dist/__tests__/config-fidelity-display.test.d.ts.map +1 -0
- package/dist/__tests__/config-fidelity-display.test.js +77 -0
- package/dist/__tests__/config-fidelity-display.test.js.map +1 -0
- package/dist/__tests__/config-fidelity.test.js +166 -33
- package/dist/__tests__/config-fidelity.test.js.map +1 -1
- package/dist/__tests__/config-generation-gate.test.js +78 -0
- package/dist/__tests__/config-generation-gate.test.js.map +1 -1
- package/dist/__tests__/config-sync.test.js +89 -1
- package/dist/__tests__/config-sync.test.js.map +1 -1
- package/dist/__tests__/coordination-401-production-wiring.test.js +12 -7
- package/dist/__tests__/coordination-401-production-wiring.test.js.map +1 -1
- package/dist/__tests__/coordination-401-recovery.test.js +39 -32
- package/dist/__tests__/coordination-401-recovery.test.js.map +1 -1
- package/dist/__tests__/coordination-brief-pin.test.js +21 -8
- package/dist/__tests__/coordination-brief-pin.test.js.map +1 -1
- package/dist/__tests__/coordination-client.test.js +316 -3
- package/dist/__tests__/coordination-client.test.js.map +1 -1
- package/dist/__tests__/coordination-credential-endpoint.test.d.ts +24 -0
- package/dist/__tests__/coordination-credential-endpoint.test.d.ts.map +1 -0
- package/dist/__tests__/coordination-credential-endpoint.test.js +1290 -0
- package/dist/__tests__/coordination-credential-endpoint.test.js.map +1 -0
- package/dist/__tests__/coordination-memory.test.js +20 -4
- package/dist/__tests__/coordination-memory.test.js.map +1 -1
- package/dist/__tests__/coordination-provision.test.js +22 -14
- package/dist/__tests__/coordination-provision.test.js.map +1 -1
- package/dist/__tests__/coordination-status-registration.test.d.ts +16 -0
- package/dist/__tests__/coordination-status-registration.test.d.ts.map +1 -0
- package/dist/__tests__/coordination-status-registration.test.js +480 -0
- package/dist/__tests__/coordination-status-registration.test.js.map +1 -0
- package/dist/__tests__/coordination-token-multitenant.test.js +24 -24
- package/dist/__tests__/coordination-token-multitenant.test.js.map +1 -1
- package/dist/__tests__/coordination-token.test.js +35 -28
- package/dist/__tests__/coordination-token.test.js.map +1 -1
- package/dist/__tests__/creation-pr-class-check.test.d.ts +17 -0
- package/dist/__tests__/creation-pr-class-check.test.d.ts.map +1 -0
- package/dist/__tests__/creation-pr-class-check.test.js +346 -0
- package/dist/__tests__/creation-pr-class-check.test.js.map +1 -0
- package/dist/__tests__/decision-check.test.d.ts +2 -0
- package/dist/__tests__/decision-check.test.d.ts.map +1 -0
- package/dist/__tests__/decision-check.test.js +105 -0
- package/dist/__tests__/decision-check.test.js.map +1 -0
- package/dist/__tests__/digest-team-omission.test.d.ts +15 -0
- package/dist/__tests__/digest-team-omission.test.d.ts.map +1 -0
- package/dist/__tests__/digest-team-omission.test.js +247 -0
- package/dist/__tests__/digest-team-omission.test.js.map +1 -0
- package/dist/__tests__/doctor-worktree-path.test.d.ts +17 -0
- package/dist/__tests__/doctor-worktree-path.test.d.ts.map +1 -0
- package/dist/__tests__/doctor-worktree-path.test.js +158 -0
- package/dist/__tests__/doctor-worktree-path.test.js.map +1 -0
- package/dist/__tests__/fleet-data.test.js +40 -7
- package/dist/__tests__/fleet-data.test.js.map +1 -1
- package/dist/__tests__/fleet-tmux.test.js +2 -2
- package/dist/__tests__/fleet-tmux.test.js.map +1 -1
- package/dist/__tests__/generate-claude.test.js +137 -3
- package/dist/__tests__/generate-claude.test.js.map +1 -1
- package/dist/__tests__/git-env.test.d.ts +14 -0
- package/dist/__tests__/git-env.test.d.ts.map +1 -0
- package/dist/__tests__/git-env.test.js +131 -0
- package/dist/__tests__/git-env.test.js.map +1 -0
- package/dist/__tests__/git-identity-isolation.test.d.ts +33 -0
- package/dist/__tests__/git-identity-isolation.test.d.ts.map +1 -0
- package/dist/__tests__/git-identity-isolation.test.js +626 -0
- package/dist/__tests__/git-identity-isolation.test.js.map +1 -0
- package/dist/__tests__/harness-extract.test.d.ts +19 -0
- package/dist/__tests__/harness-extract.test.d.ts.map +1 -0
- package/dist/__tests__/harness-extract.test.js +566 -0
- package/dist/__tests__/harness-extract.test.js.map +1 -0
- package/dist/__tests__/harness-wiring.test.d.ts +16 -0
- package/dist/__tests__/harness-wiring.test.d.ts.map +1 -0
- package/dist/__tests__/harness-wiring.test.js +469 -0
- package/dist/__tests__/harness-wiring.test.js.map +1 -0
- package/dist/__tests__/hook-heal.test.js +17 -0
- package/dist/__tests__/hook-heal.test.js.map +1 -1
- package/dist/__tests__/init-coordination-url.test.d.ts +11 -0
- package/dist/__tests__/init-coordination-url.test.d.ts.map +1 -0
- package/dist/__tests__/init-coordination-url.test.js +114 -0
- package/dist/__tests__/init-coordination-url.test.js.map +1 -0
- package/dist/__tests__/memory-autocreate.test.js +574 -8
- package/dist/__tests__/memory-autocreate.test.js.map +1 -1
- package/dist/__tests__/memory-log-result.test.d.ts +13 -0
- package/dist/__tests__/memory-log-result.test.d.ts.map +1 -0
- package/dist/__tests__/memory-log-result.test.js +113 -0
- package/dist/__tests__/memory-log-result.test.js.map +1 -0
- package/dist/__tests__/memory-named-exists.test.d.ts +16 -0
- package/dist/__tests__/memory-named-exists.test.d.ts.map +1 -0
- package/dist/__tests__/memory-named-exists.test.js +288 -0
- package/dist/__tests__/memory-named-exists.test.js.map +1 -0
- package/dist/__tests__/mx-agent-cli-pin-validation.test.js +23 -47
- package/dist/__tests__/mx-agent-cli-pin-validation.test.js.map +1 -1
- package/dist/__tests__/mx-agent-cli-version-pin.test.js +34 -88
- package/dist/__tests__/mx-agent-cli-version-pin.test.js.map +1 -1
- package/dist/__tests__/new-project-first-team.test.d.ts +15 -0
- package/dist/__tests__/new-project-first-team.test.d.ts.map +1 -0
- package/dist/__tests__/new-project-first-team.test.js +263 -0
- package/dist/__tests__/new-project-first-team.test.js.map +1 -0
- package/dist/__tests__/otel-env.test.d.ts +2 -0
- package/dist/__tests__/otel-env.test.d.ts.map +1 -0
- package/dist/__tests__/otel-env.test.js +127 -0
- package/dist/__tests__/otel-env.test.js.map +1 -0
- package/dist/__tests__/project-config.test.js +283 -1
- package/dist/__tests__/project-config.test.js.map +1 -1
- package/dist/__tests__/provision-behavioral-contract.test.js +96 -4
- package/dist/__tests__/provision-behavioral-contract.test.js.map +1 -1
- package/dist/__tests__/provision-catalog-precondition.test.d.ts +26 -0
- package/dist/__tests__/provision-catalog-precondition.test.d.ts.map +1 -0
- package/dist/__tests__/provision-catalog-precondition.test.js +620 -0
- package/dist/__tests__/provision-catalog-precondition.test.js.map +1 -0
- package/dist/__tests__/provision-completion-rows.test.d.ts +17 -0
- package/dist/__tests__/provision-completion-rows.test.d.ts.map +1 -0
- package/dist/__tests__/provision-completion-rows.test.js +3187 -0
- package/dist/__tests__/provision-completion-rows.test.js.map +1 -0
- package/dist/__tests__/provision-identity-gate.test.d.ts +20 -0
- package/dist/__tests__/provision-identity-gate.test.d.ts.map +1 -0
- package/dist/__tests__/provision-identity-gate.test.js +600 -0
- package/dist/__tests__/provision-identity-gate.test.js.map +1 -0
- package/dist/__tests__/provision-resume.test.d.ts +26 -0
- package/dist/__tests__/provision-resume.test.d.ts.map +1 -0
- package/dist/__tests__/provision-resume.test.js +1164 -0
- package/dist/__tests__/provision-resume.test.js.map +1 -0
- package/dist/__tests__/provision-roleguide-anchors.test.d.ts +27 -0
- package/dist/__tests__/provision-roleguide-anchors.test.d.ts.map +1 -0
- package/dist/__tests__/provision-roleguide-anchors.test.js +747 -0
- package/dist/__tests__/provision-roleguide-anchors.test.js.map +1 -0
- package/dist/__tests__/provision-skeleton-fill.test.d.ts +16 -0
- package/dist/__tests__/provision-skeleton-fill.test.d.ts.map +1 -0
- package/dist/__tests__/provision-skeleton-fill.test.js +488 -0
- package/dist/__tests__/provision-skeleton-fill.test.js.map +1 -0
- package/dist/__tests__/provision-teambuilder-flow.test.js +93 -7
- package/dist/__tests__/provision-teambuilder-flow.test.js.map +1 -1
- package/dist/__tests__/repo-guard-wiring.test.d.ts +21 -0
- package/dist/__tests__/repo-guard-wiring.test.d.ts.map +1 -0
- package/dist/__tests__/repo-guard-wiring.test.js +638 -0
- package/dist/__tests__/repo-guard-wiring.test.js.map +1 -0
- package/dist/__tests__/report-format.test.d.ts +2 -0
- package/dist/__tests__/report-format.test.d.ts.map +1 -0
- package/dist/__tests__/report-format.test.js +219 -0
- package/dist/__tests__/report-format.test.js.map +1 -0
- package/dist/__tests__/row15-detail-sanitizer.test.d.ts +20 -0
- package/dist/__tests__/row15-detail-sanitizer.test.d.ts.map +1 -0
- package/dist/__tests__/row15-detail-sanitizer.test.js +61 -0
- package/dist/__tests__/row15-detail-sanitizer.test.js.map +1 -0
- package/dist/__tests__/runtime-codex-gateway-pilot.test.d.ts +2 -0
- package/dist/__tests__/runtime-codex-gateway-pilot.test.d.ts.map +1 -0
- package/dist/__tests__/runtime-codex-gateway-pilot.test.js +309 -0
- package/dist/__tests__/runtime-codex-gateway-pilot.test.js.map +1 -0
- package/dist/__tests__/runtime-codex-gateway-provider.test.d.ts +2 -0
- package/dist/__tests__/runtime-codex-gateway-provider.test.d.ts.map +1 -0
- package/dist/__tests__/runtime-codex-gateway-provider.test.js +163 -0
- package/dist/__tests__/runtime-codex-gateway-provider.test.js.map +1 -0
- package/dist/__tests__/runtime-identity.test.d.ts +2 -0
- package/dist/__tests__/runtime-identity.test.d.ts.map +1 -0
- package/dist/__tests__/runtime-identity.test.js +117 -0
- package/dist/__tests__/runtime-identity.test.js.map +1 -0
- package/dist/__tests__/session-pause-provisioning.test.js +6 -1
- package/dist/__tests__/session-pause-provisioning.test.js.map +1 -1
- package/dist/__tests__/session-record-disclosure.test.d.ts +24 -0
- package/dist/__tests__/session-record-disclosure.test.d.ts.map +1 -0
- package/dist/__tests__/session-record-disclosure.test.js +494 -0
- package/dist/__tests__/session-record-disclosure.test.js.map +1 -0
- package/dist/__tests__/session.test.js +35 -0
- package/dist/__tests__/session.test.js.map +1 -1
- package/dist/__tests__/slug-validation.test.js +27 -21
- package/dist/__tests__/slug-validation.test.js.map +1 -1
- package/dist/__tests__/standards-injection.test.d.ts +2 -0
- package/dist/__tests__/standards-injection.test.d.ts.map +1 -0
- package/dist/__tests__/standards-injection.test.js +179 -0
- package/dist/__tests__/standards-injection.test.js.map +1 -0
- package/dist/__tests__/start-interactive-role.test.d.ts +22 -0
- package/dist/__tests__/start-interactive-role.test.d.ts.map +1 -0
- package/dist/__tests__/start-interactive-role.test.js +204 -0
- package/dist/__tests__/start-interactive-role.test.js.map +1 -0
- package/dist/__tests__/start-team-identity.test.d.ts +25 -0
- package/dist/__tests__/start-team-identity.test.d.ts.map +1 -0
- package/dist/__tests__/start-team-identity.test.js +307 -0
- package/dist/__tests__/start-team-identity.test.js.map +1 -0
- package/dist/__tests__/team-memory-commands.test.js +142 -19
- package/dist/__tests__/team-memory-commands.test.js.map +1 -1
- package/dist/__tests__/template-sync.test.d.ts +19 -0
- package/dist/__tests__/template-sync.test.d.ts.map +1 -0
- package/dist/__tests__/template-sync.test.js +270 -0
- package/dist/__tests__/template-sync.test.js.map +1 -0
- package/dist/__tests__/test-project.test.d.ts +18 -0
- package/dist/__tests__/test-project.test.d.ts.map +1 -0
- package/dist/__tests__/test-project.test.js +465 -0
- package/dist/__tests__/test-project.test.js.map +1 -0
- package/dist/__tests__/usage-per-call-grouping.test.d.ts +25 -0
- package/dist/__tests__/usage-per-call-grouping.test.d.ts.map +1 -0
- package/dist/__tests__/usage-per-call-grouping.test.js +952 -0
- package/dist/__tests__/usage-per-call-grouping.test.js.map +1 -0
- package/dist/__tests__/verify-hooks-check-all.test.d.ts +32 -0
- package/dist/__tests__/verify-hooks-check-all.test.d.ts.map +1 -0
- package/dist/__tests__/verify-hooks-check-all.test.js +553 -0
- package/dist/__tests__/verify-hooks-check-all.test.js.map +1 -0
- package/dist/__tests__/worktree-sync-fixture.test.d.ts +17 -0
- package/dist/__tests__/worktree-sync-fixture.test.d.ts.map +1 -0
- package/dist/__tests__/worktree-sync-fixture.test.js +519 -0
- package/dist/__tests__/worktree-sync-fixture.test.js.map +1 -0
- package/dist/__tests__/worktree-sync-hardening.test.d.ts +13 -0
- package/dist/__tests__/worktree-sync-hardening.test.d.ts.map +1 -0
- package/dist/__tests__/worktree-sync-hardening.test.js +919 -0
- package/dist/__tests__/worktree-sync-hardening.test.js.map +1 -0
- package/dist/__tests__/worktree-sync-shell-free.test.d.ts +25 -0
- package/dist/__tests__/worktree-sync-shell-free.test.d.ts.map +1 -0
- package/dist/__tests__/worktree-sync-shell-free.test.js +185 -0
- package/dist/__tests__/worktree-sync-shell-free.test.js.map +1 -0
- package/dist/__tests__/worktree.test.js +75 -1
- package/dist/__tests__/worktree.test.js.map +1 -1
- package/dist/agent-config/.mx-config-generation.json +2 -2
- package/dist/agent-config/AGENTS.md.template +2 -2
- package/dist/agent-config/agents/bar-raiser.md +34 -1
- package/dist/agent-config/agents/red-team.md +34 -1
- package/dist/agent-config/agents/security-reviewer.md +22 -1
- package/dist/agent-config/claude-md/CLAUDE.core.md +6 -1
- package/dist/agent-config/claude-md/CLAUDE.overlay.memnexus.md +1 -3
- package/dist/agent-config/coordination-rosters.generated.json +10 -0
- package/dist/agent-config/hooks/HOOK-TIMEOUTS.md +27 -1
- package/dist/agent-config/hooks/OR-TRUE-AUDIT.md +8 -8
- package/dist/agent-config/hooks/auto-capture-precompact.sh +180 -83
- package/dist/agent-config/hooks/auto-capture-session-end.sh +216 -87
- package/dist/agent-config/hooks/auto-checkpoint.sh +75 -5
- package/dist/agent-config/hooks/coordination-brief.sh +290 -245
- package/dist/agent-config/hooks/deploy-verification-reminder.sh +359 -22
- package/dist/agent-config/hooks/git-mutation-guard.sh +85 -13
- package/dist/agent-config/hooks/observability-sync.sh +46 -9
- package/dist/agent-config/hooks/session-idle-gate.sh +177 -12
- package/dist/agent-config/hooks/subagent-write-guard.sh +670 -0
- package/dist/agent-config/hooks/worktree-guard.sh +36 -7
- package/dist/agent-config/settings.json +15 -2
- package/dist/agent-config/shared/creation-pr-review-checklist.md +317 -0
- package/dist/commands/bootstrap.d.ts.map +1 -1
- package/dist/commands/bootstrap.js +22 -10
- package/dist/commands/bootstrap.js.map +1 -1
- package/dist/commands/config-sync.d.ts +37 -0
- package/dist/commands/config-sync.d.ts.map +1 -1
- package/dist/commands/config-sync.js +36 -18
- package/dist/commands/config-sync.js.map +1 -1
- package/dist/commands/config.d.ts.map +1 -1
- package/dist/commands/config.js +28 -1
- package/dist/commands/config.js.map +1 -1
- package/dist/commands/coordination.d.ts +150 -8
- package/dist/commands/coordination.d.ts.map +1 -1
- package/dist/commands/coordination.js +524 -25
- package/dist/commands/coordination.js.map +1 -1
- package/dist/commands/create.d.ts +922 -1
- package/dist/commands/create.d.ts.map +1 -1
- package/dist/commands/create.js +4934 -345
- package/dist/commands/create.js.map +1 -1
- package/dist/commands/dashboard.d.ts.map +1 -1
- package/dist/commands/dashboard.js +10 -2
- package/dist/commands/dashboard.js.map +1 -1
- package/dist/commands/decision.d.ts +20 -0
- package/dist/commands/decision.d.ts.map +1 -0
- package/dist/commands/decision.js +54 -0
- package/dist/commands/decision.js.map +1 -0
- package/dist/commands/digest.d.ts.map +1 -1
- package/dist/commands/digest.js +91 -7
- package/dist/commands/digest.js.map +1 -1
- package/dist/commands/fleet-tmux.js +1 -1
- package/dist/commands/fleet-tmux.js.map +1 -1
- package/dist/commands/init.d.ts +8 -0
- package/dist/commands/init.d.ts.map +1 -1
- package/dist/commands/init.js +26 -1
- package/dist/commands/init.js.map +1 -1
- package/dist/commands/list.d.ts +32 -1
- package/dist/commands/list.d.ts.map +1 -1
- package/dist/commands/list.js +98 -5
- package/dist/commands/list.js.map +1 -1
- package/dist/commands/monitor.d.ts.map +1 -1
- package/dist/commands/monitor.js +8 -2
- package/dist/commands/monitor.js.map +1 -1
- package/dist/commands/new.d.ts +2 -0
- package/dist/commands/new.d.ts.map +1 -1
- package/dist/commands/new.js +114 -21
- package/dist/commands/new.js.map +1 -1
- package/dist/commands/report.d.ts +33 -0
- package/dist/commands/report.d.ts.map +1 -0
- package/dist/commands/report.js +73 -0
- package/dist/commands/report.js.map +1 -0
- package/dist/commands/session.js +1 -1
- package/dist/commands/session.js.map +1 -1
- package/dist/commands/start.d.ts +42 -0
- package/dist/commands/start.d.ts.map +1 -1
- package/dist/commands/start.js +183 -8
- package/dist/commands/start.js.map +1 -1
- package/dist/commands/sync.d.ts +57 -0
- package/dist/commands/sync.d.ts.map +1 -1
- package/dist/commands/sync.js +117 -3
- package/dist/commands/sync.js.map +1 -1
- package/dist/commands/update.d.ts +13 -1
- package/dist/commands/update.d.ts.map +1 -1
- package/dist/commands/update.js +50 -1
- package/dist/commands/update.js.map +1 -1
- package/dist/commands/usage.d.ts +64 -0
- package/dist/commands/usage.d.ts.map +1 -1
- package/dist/commands/usage.js +96 -3
- package/dist/commands/usage.js.map +1 -1
- package/dist/commands/verify-hooks.d.ts +37 -1
- package/dist/commands/verify-hooks.d.ts.map +1 -1
- package/dist/commands/verify-hooks.js +114 -2
- package/dist/commands/verify-hooks.js.map +1 -1
- package/dist/commands/window.d.ts +10 -0
- package/dist/commands/window.d.ts.map +1 -0
- package/dist/commands/window.js +265 -0
- package/dist/commands/window.js.map +1 -0
- package/dist/commands/worktree-sync.d.ts +54 -0
- package/dist/commands/worktree-sync.d.ts.map +1 -0
- package/dist/commands/worktree-sync.js +135 -0
- package/dist/commands/worktree-sync.js.map +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +189 -14
- package/dist/index.js.map +1 -1
- package/dist/lib/agent-session.d.ts +12 -0
- package/dist/lib/agent-session.d.ts.map +1 -1
- package/dist/lib/agent-session.js +189 -42
- package/dist/lib/agent-session.js.map +1 -1
- package/dist/lib/behavioral-injection.d.ts +9 -0
- package/dist/lib/behavioral-injection.d.ts.map +1 -1
- package/dist/lib/behavioral-injection.js +10 -1
- package/dist/lib/behavioral-injection.js.map +1 -1
- package/dist/lib/catalog.d.ts +321 -2
- package/dist/lib/catalog.d.ts.map +1 -1
- package/dist/lib/catalog.js +490 -11
- package/dist/lib/catalog.js.map +1 -1
- package/dist/lib/claude.d.ts +113 -23
- package/dist/lib/claude.d.ts.map +1 -1
- package/dist/lib/claude.js +498 -32
- package/dist/lib/claude.js.map +1 -1
- package/dist/lib/cli-build.d.ts +172 -0
- package/dist/lib/cli-build.d.ts.map +1 -0
- package/dist/lib/cli-build.js +654 -0
- package/dist/lib/cli-build.js.map +1 -0
- package/dist/lib/code-context-file.d.ts +109 -0
- package/dist/lib/code-context-file.d.ts.map +1 -0
- package/dist/lib/code-context-file.js +219 -0
- package/dist/lib/code-context-file.js.map +1 -0
- package/dist/lib/code-context-file.test.d.ts +19 -0
- package/dist/lib/code-context-file.test.d.ts.map +1 -0
- package/dist/lib/code-context-file.test.js +202 -0
- package/dist/lib/code-context-file.test.js.map +1 -0
- package/dist/lib/config-fidelity.d.ts +40 -20
- package/dist/lib/config-fidelity.d.ts.map +1 -1
- package/dist/lib/config-fidelity.js +144 -56
- package/dist/lib/config-fidelity.js.map +1 -1
- package/dist/lib/coordination-client.d.ts +101 -0
- package/dist/lib/coordination-client.d.ts.map +1 -1
- package/dist/lib/coordination-client.js +232 -8
- package/dist/lib/coordination-client.js.map +1 -1
- package/dist/lib/coordination-token.d.ts +333 -6
- package/dist/lib/coordination-token.d.ts.map +1 -1
- package/dist/lib/coordination-token.js +875 -52
- package/dist/lib/coordination-token.js.map +1 -1
- package/dist/lib/decision-check.d.ts +48 -0
- package/dist/lib/decision-check.d.ts.map +1 -0
- package/dist/lib/decision-check.js +149 -0
- package/dist/lib/decision-check.js.map +1 -0
- package/dist/lib/fleet-data.d.ts +34 -0
- package/dist/lib/fleet-data.d.ts.map +1 -1
- package/dist/lib/fleet-data.js +37 -9
- package/dist/lib/fleet-data.js.map +1 -1
- package/dist/lib/fleet-render.js +1 -1
- package/dist/lib/fleet-render.js.map +1 -1
- package/dist/lib/git-identity.d.ts +302 -0
- package/dist/lib/git-identity.d.ts.map +1 -0
- package/dist/lib/git-identity.js +546 -0
- package/dist/lib/git-identity.js.map +1 -0
- package/dist/lib/harness/console/announce.d.ts +45 -0
- package/dist/lib/harness/console/announce.d.ts.map +1 -0
- package/dist/lib/harness/console/announce.js +48 -0
- package/dist/lib/harness/console/announce.js.map +1 -0
- package/dist/lib/harness/console/announce.test.d.ts +2 -0
- package/dist/lib/harness/console/announce.test.d.ts.map +1 -0
- package/dist/lib/harness/console/announce.test.js +104 -0
- package/dist/lib/harness/console/announce.test.js.map +1 -0
- package/dist/lib/harness/console/by-session.d.ts +50 -0
- package/dist/lib/harness/console/by-session.d.ts.map +1 -0
- package/dist/lib/harness/console/by-session.js +83 -0
- package/dist/lib/harness/console/by-session.js.map +1 -0
- package/dist/lib/harness/console/by-session.test.d.ts +2 -0
- package/dist/lib/harness/console/by-session.test.d.ts.map +1 -0
- package/dist/lib/harness/console/by-session.test.js +86 -0
- package/dist/lib/harness/console/by-session.test.js.map +1 -0
- package/dist/lib/harness/console/console.d.ts +67 -0
- package/dist/lib/harness/console/console.d.ts.map +1 -0
- package/dist/lib/harness/console/console.js +373 -0
- package/dist/lib/harness/console/console.js.map +1 -0
- package/dist/lib/harness/console/console.test.d.ts +2 -0
- package/dist/lib/harness/console/console.test.d.ts.map +1 -0
- package/dist/lib/harness/console/console.test.js +269 -0
- package/dist/lib/harness/console/console.test.js.map +1 -0
- package/dist/lib/harness/console/decision-request.d.ts +32 -0
- package/dist/lib/harness/console/decision-request.d.ts.map +1 -0
- package/dist/lib/harness/console/decision-request.js +112 -0
- package/dist/lib/harness/console/decision-request.js.map +1 -0
- package/dist/lib/harness/console/decision-request.test.d.ts +2 -0
- package/dist/lib/harness/console/decision-request.test.d.ts.map +1 -0
- package/dist/lib/harness/console/decision-request.test.js +75 -0
- package/dist/lib/harness/console/decision-request.test.js.map +1 -0
- package/dist/lib/harness/console/fixtures.d.ts +16 -0
- package/dist/lib/harness/console/fixtures.d.ts.map +1 -0
- package/dist/lib/harness/console/fixtures.js +49 -0
- package/dist/lib/harness/console/fixtures.js.map +1 -0
- package/dist/lib/harness/console/index.d.ts +15 -0
- package/dist/lib/harness/console/index.d.ts.map +1 -0
- package/dist/lib/harness/console/index.js +14 -0
- package/dist/lib/harness/console/index.js.map +1 -0
- package/dist/lib/harness/console/rank.d.ts +73 -0
- package/dist/lib/harness/console/rank.d.ts.map +1 -0
- package/dist/lib/harness/console/rank.js +113 -0
- package/dist/lib/harness/console/rank.js.map +1 -0
- package/dist/lib/harness/console/rank.test.d.ts +2 -0
- package/dist/lib/harness/console/rank.test.d.ts.map +1 -0
- package/dist/lib/harness/console/rank.test.js +124 -0
- package/dist/lib/harness/console/rank.test.js.map +1 -0
- package/dist/lib/harness/console/render.d.ts +22 -0
- package/dist/lib/harness/console/render.d.ts.map +1 -0
- package/dist/lib/harness/console/render.js +65 -0
- package/dist/lib/harness/console/render.js.map +1 -0
- package/dist/lib/harness/console/render.test.d.ts +2 -0
- package/dist/lib/harness/console/render.test.d.ts.map +1 -0
- package/dist/lib/harness/console/render.test.js +96 -0
- package/dist/lib/harness/console/render.test.js.map +1 -0
- package/dist/lib/harness/console/replay-cli.test.d.ts +2 -0
- package/dist/lib/harness/console/replay-cli.test.d.ts.map +1 -0
- package/dist/lib/harness/console/replay-cli.test.js +96 -0
- package/dist/lib/harness/console/replay-cli.test.js.map +1 -0
- package/dist/lib/harness/console/replay.d.ts +36 -0
- package/dist/lib/harness/console/replay.d.ts.map +1 -0
- package/dist/lib/harness/console/replay.js +59 -0
- package/dist/lib/harness/console/replay.js.map +1 -0
- package/dist/lib/harness/console/replay.test.d.ts +2 -0
- package/dist/lib/harness/console/replay.test.d.ts.map +1 -0
- package/dist/lib/harness/console/replay.test.js +81 -0
- package/dist/lib/harness/console/replay.test.js.map +1 -0
- package/dist/lib/harness/console/turn-reader.d.ts +50 -0
- package/dist/lib/harness/console/turn-reader.d.ts.map +1 -0
- package/dist/lib/harness/console/turn-reader.js +184 -0
- package/dist/lib/harness/console/turn-reader.js.map +1 -0
- package/dist/lib/harness/console/turn-reader.test.d.ts +2 -0
- package/dist/lib/harness/console/turn-reader.test.d.ts.map +1 -0
- package/dist/lib/harness/console/turn-reader.test.js +108 -0
- package/dist/lib/harness/console/turn-reader.test.js.map +1 -0
- package/dist/lib/harness/console/types.d.ts +109 -0
- package/dist/lib/harness/console/types.d.ts.map +1 -0
- package/dist/lib/harness/console/types.js +2 -0
- package/dist/lib/harness/console/types.js.map +1 -0
- package/dist/lib/harness/contract.d.ts +229 -0
- package/dist/lib/harness/contract.d.ts.map +1 -0
- package/dist/lib/harness/contract.js +22 -0
- package/dist/lib/harness/contract.js.map +1 -0
- package/dist/lib/harness/credential.d.ts +23 -0
- package/dist/lib/harness/credential.d.ts.map +1 -0
- package/dist/lib/harness/credential.js +81 -0
- package/dist/lib/harness/credential.js.map +1 -0
- package/dist/lib/harness/credential.test.d.ts +2 -0
- package/dist/lib/harness/credential.test.d.ts.map +1 -0
- package/dist/lib/harness/credential.test.js +74 -0
- package/dist/lib/harness/credential.test.js.map +1 -0
- package/dist/lib/harness/evaluate.d.ts +390 -0
- package/dist/lib/harness/evaluate.d.ts.map +1 -0
- package/dist/lib/harness/evaluate.js +988 -0
- package/dist/lib/harness/evaluate.js.map +1 -0
- package/dist/lib/harness/evaluate.test.d.ts +2 -0
- package/dist/lib/harness/evaluate.test.d.ts.map +1 -0
- package/dist/lib/harness/evaluate.test.js +621 -0
- package/dist/lib/harness/evaluate.test.js.map +1 -0
- package/dist/lib/harness/extract.d.ts +152 -0
- package/dist/lib/harness/extract.d.ts.map +1 -0
- package/dist/lib/harness/extract.js +1601 -0
- package/dist/lib/harness/extract.js.map +1 -0
- package/dist/lib/harness/gate.d.ts +48 -0
- package/dist/lib/harness/gate.d.ts.map +1 -0
- package/dist/lib/harness/gate.js +60 -0
- package/dist/lib/harness/gate.js.map +1 -0
- package/dist/lib/harness/gate.test.d.ts +2 -0
- package/dist/lib/harness/gate.test.d.ts.map +1 -0
- package/dist/lib/harness/gate.test.js +111 -0
- package/dist/lib/harness/gate.test.js.map +1 -0
- package/dist/lib/harness/self-check.d.ts +59 -0
- package/dist/lib/harness/self-check.d.ts.map +1 -0
- package/dist/lib/harness/self-check.js +56 -0
- package/dist/lib/harness/self-check.js.map +1 -0
- package/dist/lib/harness/self-check.test.d.ts +2 -0
- package/dist/lib/harness/self-check.test.d.ts.map +1 -0
- package/dist/lib/harness/self-check.test.js +43 -0
- package/dist/lib/harness/self-check.test.js.map +1 -0
- package/dist/lib/harness/transcript.d.ts +65 -0
- package/dist/lib/harness/transcript.d.ts.map +1 -0
- package/dist/lib/harness/transcript.js +144 -0
- package/dist/lib/harness/transcript.js.map +1 -0
- package/dist/lib/harness/transcript.test.d.ts +2 -0
- package/dist/lib/harness/transcript.test.d.ts.map +1 -0
- package/dist/lib/harness/transcript.test.js +118 -0
- package/dist/lib/harness/transcript.test.js.map +1 -0
- package/dist/lib/harness-wiring.d.ts +145 -0
- package/dist/lib/harness-wiring.d.ts.map +1 -0
- package/dist/lib/harness-wiring.js +280 -0
- package/dist/lib/harness-wiring.js.map +1 -0
- package/dist/lib/hook-staleness.d.ts +95 -0
- package/dist/lib/hook-staleness.d.ts.map +1 -0
- package/dist/lib/hook-staleness.js +304 -0
- package/dist/lib/hook-staleness.js.map +1 -0
- package/dist/lib/jsonl.d.ts +270 -2
- package/dist/lib/jsonl.d.ts.map +1 -1
- package/dist/lib/jsonl.js +472 -76
- package/dist/lib/jsonl.js.map +1 -1
- package/dist/lib/memory.d.ts +350 -23
- package/dist/lib/memory.d.ts.map +1 -1
- package/dist/lib/memory.js +751 -38
- package/dist/lib/memory.js.map +1 -1
- package/dist/lib/otel-env.d.ts +90 -0
- package/dist/lib/otel-env.d.ts.map +1 -0
- package/dist/lib/otel-env.js +98 -0
- package/dist/lib/otel-env.js.map +1 -0
- package/dist/lib/project-config.d.ts +167 -0
- package/dist/lib/project-config.d.ts.map +1 -1
- package/dist/lib/project-config.js +321 -5
- package/dist/lib/project-config.js.map +1 -1
- package/dist/lib/projects-registry.d.ts +82 -0
- package/dist/lib/projects-registry.d.ts.map +1 -0
- package/dist/lib/projects-registry.js +145 -0
- package/dist/lib/projects-registry.js.map +1 -0
- package/dist/lib/projects-registry.test.d.ts +2 -0
- package/dist/lib/projects-registry.test.d.ts.map +1 -0
- package/dist/lib/projects-registry.test.js +176 -0
- package/dist/lib/projects-registry.test.js.map +1 -0
- package/dist/lib/repo-guard-scope.d.ts +126 -0
- package/dist/lib/repo-guard-scope.d.ts.map +1 -0
- package/dist/lib/repo-guard-scope.js +249 -0
- package/dist/lib/repo-guard-scope.js.map +1 -0
- package/dist/lib/report-format.d.ts +132 -0
- package/dist/lib/report-format.d.ts.map +1 -0
- package/dist/lib/report-format.js +317 -0
- package/dist/lib/report-format.js.map +1 -0
- package/dist/lib/roster.d.ts +99 -0
- package/dist/lib/roster.d.ts.map +1 -0
- package/dist/lib/roster.js +336 -0
- package/dist/lib/roster.js.map +1 -0
- package/dist/lib/roster.test.d.ts +15 -0
- package/dist/lib/roster.test.d.ts.map +1 -0
- package/dist/lib/roster.test.js +299 -0
- package/dist/lib/roster.test.js.map +1 -0
- package/dist/lib/runtime/codex-adapter.d.ts.map +1 -1
- package/dist/lib/runtime/codex-adapter.js +5 -0
- package/dist/lib/runtime/codex-adapter.js.map +1 -1
- package/dist/lib/runtime/codex-config.d.ts +129 -0
- package/dist/lib/runtime/codex-config.d.ts.map +1 -1
- package/dist/lib/runtime/codex-config.js +225 -0
- package/dist/lib/runtime/codex-config.js.map +1 -1
- package/dist/lib/runtime/identity.d.ts +72 -0
- package/dist/lib/runtime/identity.d.ts.map +1 -0
- package/dist/lib/runtime/identity.js +128 -0
- package/dist/lib/runtime/identity.js.map +1 -0
- package/dist/lib/standards.d.ts +99 -0
- package/dist/lib/standards.d.ts.map +1 -0
- package/dist/lib/standards.js +201 -0
- package/dist/lib/standards.js.map +1 -0
- package/dist/lib/team-identity.d.ts +134 -0
- package/dist/lib/team-identity.d.ts.map +1 -0
- package/dist/lib/team-identity.js +193 -0
- package/dist/lib/team-identity.js.map +1 -0
- package/dist/lib/templates.d.ts +29 -2
- package/dist/lib/templates.d.ts.map +1 -1
- package/dist/lib/templates.js +1042 -82
- package/dist/lib/templates.js.map +1 -1
- package/dist/lib/terminal-ui.d.ts.map +1 -1
- package/dist/lib/terminal-ui.js +12 -1
- package/dist/lib/terminal-ui.js.map +1 -1
- package/dist/lib/test-project.d.ts +95 -0
- package/dist/lib/test-project.d.ts.map +1 -0
- package/dist/lib/test-project.js +103 -0
- package/dist/lib/test-project.js.map +1 -0
- package/dist/lib/vault.d.ts +60 -0
- package/dist/lib/vault.d.ts.map +1 -0
- package/dist/lib/vault.js +102 -0
- package/dist/lib/vault.js.map +1 -0
- package/dist/lib/vault.test.d.ts +17 -0
- package/dist/lib/vault.test.d.ts.map +1 -0
- package/dist/lib/vault.test.js +169 -0
- package/dist/lib/vault.test.js.map +1 -0
- package/dist/lib/window-view.d.ts +63 -0
- package/dist/lib/window-view.d.ts.map +1 -0
- package/dist/lib/window-view.js +217 -0
- package/dist/lib/window-view.js.map +1 -0
- package/dist/lib/window-view.test.d.ts +2 -0
- package/dist/lib/window-view.test.d.ts.map +1 -0
- package/dist/lib/window-view.test.js +168 -0
- package/dist/lib/window-view.test.js.map +1 -0
- package/dist/lib/worktree-sync.d.ts +439 -0
- package/dist/lib/worktree-sync.d.ts.map +1 -0
- package/dist/lib/worktree-sync.js +1167 -0
- package/dist/lib/worktree-sync.js.map +1 -0
- package/dist/lib/worktree.d.ts +58 -1
- package/dist/lib/worktree.d.ts.map +1 -1
- package/dist/lib/worktree.js +91 -4
- package/dist/lib/worktree.js.map +1 -1
- package/dist/standards/decision-request.md +98 -0
- package/dist/standards/fail-loud-standard.md +495 -0
- package/dist/standards/po-communication-standard.md +126 -0
- package/dist/standards/report-format.md +128 -0
- package/dist/standards/writing-standard.md +382 -0
- package/package.json +3 -2
- package/scripts/generate-claude.mjs +119 -46
|
@@ -0,0 +1,280 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Connects the harness to a live session.
|
|
3
|
+
*
|
|
4
|
+
* `agent-session.ts` drives an Agent SDK loop and owns terminal input, the
|
|
5
|
+
* message bus and the resume cycle. This file owns everything between a tool
|
|
6
|
+
* call and a permission result, so that the session file holds no policy and
|
|
7
|
+
* this file holds no SDK.
|
|
8
|
+
*
|
|
9
|
+
* What it composes, all of which existed and none of which ran:
|
|
10
|
+
*
|
|
11
|
+
* credential.ts refuses to start a session that would bill as metered
|
|
12
|
+
* self-check.ts refuses to start when the callback would be shadowed, and
|
|
13
|
+
* proves afterwards that it fired
|
|
14
|
+
* evaluate.ts compiles the rules and decides
|
|
15
|
+
* extract.ts turns a tool call into what it would touch
|
|
16
|
+
* gate.ts joins them and fails closed
|
|
17
|
+
*
|
|
18
|
+
* Three decisions this file makes, each with the measurement behind it.
|
|
19
|
+
*
|
|
20
|
+
* **It replaces `checkWorktreeGuard`.** That function refused 28.6% of the
|
|
21
|
+
* commands it exists to refuse (`docs/guard-coverage.md`). Through this path
|
|
22
|
+
* the same 2,043 commands produce 50.1% (`scripts/gate-coverage.mjs`).
|
|
23
|
+
*
|
|
24
|
+
* **A session-level observe mode exists and is not the default.** Observe
|
|
25
|
+
* records the decision and runs the call. It is at the session edge rather than
|
|
26
|
+
* in the ruleset because flipping `mode` on a `RuleSource` contradicts that
|
|
27
|
+
* rule's own examples and the compiler refuses the ruleset.
|
|
28
|
+
*
|
|
29
|
+
* **`ask` asks.** `gate.ts` maps `ask` to deny because no rule may become an
|
|
30
|
+
* allow through nobody being present. This session has a person at a terminal,
|
|
31
|
+
* so the effect reaches them as a question. With no terminal it stays a deny.
|
|
32
|
+
*/
|
|
33
|
+
import chalk from 'chalk';
|
|
34
|
+
import { createGate } from './harness/gate.js';
|
|
35
|
+
import { extractor, hostAbsolute } from './harness/extract.js';
|
|
36
|
+
import { compileRuleset, RulesetRefused, STARTER_RULES, } from './harness/evaluate.js';
|
|
37
|
+
import { checkCallbackReachable, ProbeSelfCheck } from './harness/self-check.js';
|
|
38
|
+
import { checkCredential, refuseToStart } from './harness/credential.js';
|
|
39
|
+
/** The surface a permission callback is. Rules that name no other surface can
|
|
40
|
+
* only run here, and rules that do not name this one never reach it. */
|
|
41
|
+
export const SESSION_SURFACE = 'permission-callback';
|
|
42
|
+
/** Files that define policy. The rules refuse to compile when this list does
|
|
43
|
+
* not cover the paths their own examples name, which is how a wrong context is
|
|
44
|
+
* found at startup rather than by a rule silently never firing. */
|
|
45
|
+
export function governingRulePaths(repoRoot, worktreeRoot) {
|
|
46
|
+
const under = (root) => [
|
|
47
|
+
`${root}/.claude/settings.json`,
|
|
48
|
+
`${root}/.claude/hooks/**`,
|
|
49
|
+
`${root}/.claude/rules/**`,
|
|
50
|
+
`${root}/.mx-agent/**`,
|
|
51
|
+
];
|
|
52
|
+
return repoRoot === worktreeRoot ? under(repoRoot) : [...under(repoRoot), ...under(worktreeRoot)];
|
|
53
|
+
}
|
|
54
|
+
export function policyContext(repoRoot, worktreeRoot, testGuardedPaths = [], scratchRoots) {
|
|
55
|
+
return {
|
|
56
|
+
worktreeRoot,
|
|
57
|
+
repoRoot,
|
|
58
|
+
governingRulePaths: governingRulePaths(repoRoot, worktreeRoot),
|
|
59
|
+
testGuardedPaths,
|
|
60
|
+
...(scratchRoots ? { scratchRoots } : {}),
|
|
61
|
+
};
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* The rules this surface can enforce.
|
|
65
|
+
*
|
|
66
|
+
* A rule that names only `integration-lane` is not a rule this session is
|
|
67
|
+
* failing to run, it is a rule for a component that is not built. Selecting by
|
|
68
|
+
* surface keeps that distinction, and it also keeps the compiler from refusing
|
|
69
|
+
* the whole ruleset over a rule whose path token a project left empty.
|
|
70
|
+
*/
|
|
71
|
+
export function rulesForSurface(rules = STARTER_RULES) {
|
|
72
|
+
return rules.filter((r) => r.surfaces.includes(SESSION_SURFACE));
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
* Everything that has to be true before the first tool call.
|
|
76
|
+
*
|
|
77
|
+
* All three checks run even when the first one fails, so the operator sees
|
|
78
|
+
* every reason at once instead of fixing them one session at a time.
|
|
79
|
+
*/
|
|
80
|
+
export function prepareHarness(input) {
|
|
81
|
+
const lines = [];
|
|
82
|
+
let ok = true;
|
|
83
|
+
const credential = checkCredential({
|
|
84
|
+
env: input.env,
|
|
85
|
+
...(input.credentialsFile ? { credentialsFile: input.credentialsFile } : {}),
|
|
86
|
+
});
|
|
87
|
+
const billing = refuseToStart(credential, { allowMetered: input.allowMetered === true });
|
|
88
|
+
if (billing.refuse) {
|
|
89
|
+
ok = false;
|
|
90
|
+
lines.push(...(billing.message ?? '').split('\n'));
|
|
91
|
+
}
|
|
92
|
+
else if (credential.kind === 'api-key') {
|
|
93
|
+
lines.push(` [harness] metered billing accepted by --allow-metered (${credential.source})`);
|
|
94
|
+
}
|
|
95
|
+
const reachable = checkCallbackReachable({
|
|
96
|
+
...(input.permissionMode !== undefined ? { permissionMode: input.permissionMode } : {}),
|
|
97
|
+
canUseToolSupplied: input.canUseToolSupplied,
|
|
98
|
+
});
|
|
99
|
+
if (!reachable.ok) {
|
|
100
|
+
ok = false;
|
|
101
|
+
lines.push(...(reachable.message ?? '').split('\n'));
|
|
102
|
+
}
|
|
103
|
+
const selected = rulesForSurface(input.rules ?? STARTER_RULES);
|
|
104
|
+
const withheld = (input.rules ?? STARTER_RULES).filter((r) => !selected.includes(r));
|
|
105
|
+
let evaluator;
|
|
106
|
+
try {
|
|
107
|
+
evaluator = compileRuleset(selected, policyContext(input.repoRoot, input.worktreeRoot, input.testGuardedPaths ?? [], input.scratchRoots));
|
|
108
|
+
}
|
|
109
|
+
catch (err) {
|
|
110
|
+
ok = false;
|
|
111
|
+
if (err instanceof RulesetRefused) {
|
|
112
|
+
lines.push(' Refusing to start: the ruleset did not compile, so no rule would run.');
|
|
113
|
+
for (const r of err.refusals)
|
|
114
|
+
lines.push(` ${r.ruleId} [${r.code}]: ${r.detail}`);
|
|
115
|
+
}
|
|
116
|
+
else {
|
|
117
|
+
lines.push(` Refusing to start: the ruleset threw: ${err instanceof Error ? err.message : String(err)}`);
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
const notEnforcedHere = evaluator ? evaluator.unenforceableOn(SESSION_SURFACE) : [];
|
|
121
|
+
if (evaluator) {
|
|
122
|
+
lines.push(` [harness] enforcing ${evaluator.ruleIds.length} rule(s) on ${SESSION_SURFACE}: ${evaluator.ruleIds.join(', ')}`);
|
|
123
|
+
for (const r of withheld) {
|
|
124
|
+
lines.push(` [harness] not enforced here: ${r.id} (needs ${r.surfaces.join(' or ')})`);
|
|
125
|
+
}
|
|
126
|
+
for (const r of notEnforcedHere) {
|
|
127
|
+
lines.push(` [harness] holds but cannot enforce on this surface: ${r.id}`);
|
|
128
|
+
}
|
|
129
|
+
// The compiler's warnings are things a rule author could not be refused
|
|
130
|
+
// for and an operator should still know. Printing them at startup is the
|
|
131
|
+
// only place they reach anyone.
|
|
132
|
+
for (const w of evaluator.warnings) {
|
|
133
|
+
lines.push(` [harness] note on ${w.ruleId}: ${w.detail}`);
|
|
134
|
+
}
|
|
135
|
+
// A worktree named by a drive letter or a UNC share means the session runs
|
|
136
|
+
// on a Windows host, and the boundary rules compare paths as strings. That
|
|
137
|
+
// host names one file three ways: `C:/x`, `C:\x` and `/c/x`. The extractor
|
|
138
|
+
// folds the first two together and has no basis for folding the third,
|
|
139
|
+
// because `/c` is a legitimate directory on a POSIX host. Which spelling
|
|
140
|
+
// the model picks decides whether a write is inside the worktree.
|
|
141
|
+
//
|
|
142
|
+
// Measured on 2026-08-18 by `scripts/live-session-proof.mjs`: across live
|
|
143
|
+
// runs the model chose all three forms for the same file. On `/c/...` the
|
|
144
|
+
// rule refused a write into the session's own worktree.
|
|
145
|
+
//
|
|
146
|
+
// Every coverage figure comes from a corpus whose paths all begin
|
|
147
|
+
// `/workspace`, so none of them measures this. Saying so at startup is the
|
|
148
|
+
// only place it reaches an operator.
|
|
149
|
+
if (hostAbsolute(input.worktreeRoot)) {
|
|
150
|
+
lines.push(` [harness] note: the worktree ${input.worktreeRoot} is a Windows path. Boundary rules ` +
|
|
151
|
+
`compare paths textually, and this host spells one file as C:/x, C:\\x and /c/x. ` +
|
|
152
|
+
`The first two are folded together; /c/x reads as a different tree and a write there ` +
|
|
153
|
+
`into this worktree is refused. Run the session on a POSIX path to get the measured ` +
|
|
154
|
+
`behaviour.`);
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
// The evaluator is withheld when any check refused, so a caller that reads
|
|
158
|
+
// `evaluator` without reading `ok` cannot start an ungoverned session by
|
|
159
|
+
// accident. The compile still ran, and its result is in `lines` either way.
|
|
160
|
+
return { ok, lines, credential, ...(ok && evaluator ? { evaluator } : {}), notEnforcedHere };
|
|
161
|
+
}
|
|
162
|
+
/**
|
|
163
|
+
* A subagent's role is not disclosed by the runtime, so it is recorded as
|
|
164
|
+
* `subagent` rather than as the session's role. A rule bound to a role must not
|
|
165
|
+
* match a principal whose role nobody stated.
|
|
166
|
+
*/
|
|
167
|
+
export function principalFor(opts, meta) {
|
|
168
|
+
const subagentId = meta?.agentID ?? null;
|
|
169
|
+
return {
|
|
170
|
+
team: opts.team,
|
|
171
|
+
role: subagentId ? 'subagent' : opts.role,
|
|
172
|
+
subagentId,
|
|
173
|
+
sessionId: opts.sessionId,
|
|
174
|
+
};
|
|
175
|
+
}
|
|
176
|
+
export function createSessionGate(opts) {
|
|
177
|
+
const probe = new ProbeSelfCheck();
|
|
178
|
+
const now = opts.now ?? (() => new Date().toISOString());
|
|
179
|
+
const cwd = opts.cwd ?? opts.worktreeRoot;
|
|
180
|
+
let calls = 0;
|
|
181
|
+
let denied = 0;
|
|
182
|
+
let asked = 0;
|
|
183
|
+
let observed = 0;
|
|
184
|
+
async function decide(toolName, input, meta) {
|
|
185
|
+
calls += 1;
|
|
186
|
+
const principal = principalFor({ team: opts.team, role: opts.role, sessionId: opts.sessionId() }, meta);
|
|
187
|
+
let captured = null;
|
|
188
|
+
// Read through a call so control-flow analysis does not narrow `captured`
|
|
189
|
+
// to null: the only assignment happens inside the sink callback.
|
|
190
|
+
const takeCapture = () => captured;
|
|
191
|
+
const gate = createGate({
|
|
192
|
+
extractor,
|
|
193
|
+
evaluator: opts.evaluator,
|
|
194
|
+
principal,
|
|
195
|
+
surface: SESSION_SURFACE,
|
|
196
|
+
context: { cwd, worktreeRoot: opts.worktreeRoot },
|
|
197
|
+
sink: {
|
|
198
|
+
emit(event) {
|
|
199
|
+
if (event.type === 'decision')
|
|
200
|
+
captured = { attrs: event.attrs, decision: event.decision };
|
|
201
|
+
opts.sink?.emit(event);
|
|
202
|
+
},
|
|
203
|
+
},
|
|
204
|
+
onInvoked: () => probe.observe(),
|
|
205
|
+
now,
|
|
206
|
+
});
|
|
207
|
+
const call = {
|
|
208
|
+
name: toolName,
|
|
209
|
+
input,
|
|
210
|
+
...(meta?.toolUseID ? { callId: meta.toolUseID } : {}),
|
|
211
|
+
};
|
|
212
|
+
const result = await gate(call);
|
|
213
|
+
if (result.behavior === 'allow')
|
|
214
|
+
return result;
|
|
215
|
+
const seen = takeCapture();
|
|
216
|
+
// Observe mode: the decision is recorded and the call runs. The record is
|
|
217
|
+
// the point, so this reports rather than staying silent.
|
|
218
|
+
if (opts.mode === 'observe') {
|
|
219
|
+
observed += 1;
|
|
220
|
+
return { behavior: 'allow', updatedInput: input };
|
|
221
|
+
}
|
|
222
|
+
if (seen && seen.decision.effect === 'ask' && opts.askOperator) {
|
|
223
|
+
asked += 1;
|
|
224
|
+
const approved = await opts.askOperator(seen.decision, seen.attrs);
|
|
225
|
+
if (approved)
|
|
226
|
+
return { behavior: 'allow', updatedInput: input };
|
|
227
|
+
return result;
|
|
228
|
+
}
|
|
229
|
+
denied += 1;
|
|
230
|
+
return result;
|
|
231
|
+
}
|
|
232
|
+
return { probe, decide, stats: () => ({ calls, denied, asked, observed }) };
|
|
233
|
+
}
|
|
234
|
+
// ── Terminal output ──────────────────────────────────────────────────────────
|
|
235
|
+
/** Prints every decision that is not a plain allow. An allow is the common case
|
|
236
|
+
* and printing it would bury the refusals. */
|
|
237
|
+
export function terminalSink(mode, write = (s) => console.log(s)) {
|
|
238
|
+
return {
|
|
239
|
+
emit(event) {
|
|
240
|
+
if (event.type !== 'decision')
|
|
241
|
+
return;
|
|
242
|
+
const { decision, attrs } = event;
|
|
243
|
+
if (decision.effect === 'allow' && !decision.observedOnly)
|
|
244
|
+
return;
|
|
245
|
+
const who = event.principal.subagentId
|
|
246
|
+
? `${event.principal.team}/subagent ${event.principal.subagentId}`
|
|
247
|
+
: `${event.principal.team}/${event.principal.role}`;
|
|
248
|
+
const head = decision.observedOnly
|
|
249
|
+
? chalk.yellow(' [harness observed]')
|
|
250
|
+
: decision.effect === 'deny'
|
|
251
|
+
? chalk.red(' [harness refused]')
|
|
252
|
+
: chalk.yellow(' [harness asks]');
|
|
253
|
+
const suffix = mode === 'observe' && !decision.observedOnly ? chalk.dim(' (observe mode: the call ran)') : '';
|
|
254
|
+
write(`${head} ${attrs.operation} by ${who}${suffix}`);
|
|
255
|
+
if (decision.reason)
|
|
256
|
+
for (const line of decision.reason.split('\n'))
|
|
257
|
+
write(chalk.dim(` ${line}`));
|
|
258
|
+
if (attrs.command)
|
|
259
|
+
write(chalk.dim(` command: ${attrs.command.replace(/\s+/g, ' ').slice(0, 160)}`));
|
|
260
|
+
},
|
|
261
|
+
};
|
|
262
|
+
}
|
|
263
|
+
/** Sends one event to several sinks. A sink that throws does not stop the rest,
|
|
264
|
+
* because a reporting failure must not become a permission decision. */
|
|
265
|
+
export function fanOut(...sinks) {
|
|
266
|
+
const live = sinks.filter((s) => s !== undefined);
|
|
267
|
+
return {
|
|
268
|
+
emit(event) {
|
|
269
|
+
for (const s of live) {
|
|
270
|
+
try {
|
|
271
|
+
s.emit(event);
|
|
272
|
+
}
|
|
273
|
+
catch {
|
|
274
|
+
// A console that throws is a console defect, not a permission one.
|
|
275
|
+
}
|
|
276
|
+
}
|
|
277
|
+
},
|
|
278
|
+
};
|
|
279
|
+
}
|
|
280
|
+
//# sourceMappingURL=harness-wiring.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"harness-wiring.js","sourceRoot":"","sources":["../../src/lib/harness-wiring.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* hook-staleness.ts — is a MATERIALISED hook behind its source? (#306)
|
|
3
|
+
*
|
|
4
|
+
* PROBLEM. `hook-completeness.ts` answers "is a registered hook PRESENT". A hook
|
|
5
|
+
* that is present but STALE passes that check and is never reported. The
|
|
6
|
+
* measured harm (v23 runtime probe, 2026-08-30): the pre-#298
|
|
7
|
+
* `coordination-brief.sh` prints nothing on any stream and exits 0 when `az` is
|
|
8
|
+
* unavailable, so a session starts believing it has no coordination. The
|
|
9
|
+
* registration strings in `agent-config/settings.json` run a present hook
|
|
10
|
+
* directly (`[ -f "$H" ] && [ ! -L "$H" ] && exec bash "$H"`) and reach
|
|
11
|
+
* `hook-launcher.sh` only when the file is MISSING, so the launcher's auto-heal
|
|
12
|
+
* never sees this state. Before this module the only detector was
|
|
13
|
+
* `mx-agent doctor`, run by hand.
|
|
14
|
+
*
|
|
15
|
+
* WHAT IT COMPARES. The bytes of each materialised `.claude/hooks/<name>`
|
|
16
|
+
* against the bytes of `origin/<baseBranch>:<configSource>/hooks/<name>` — the
|
|
17
|
+
* same reference `verifyAndHealHooks` materialises from (claude.ts:1236-1287)
|
|
18
|
+
* and the same one `reportConfigFidelity` reads (config-fidelity.ts). One
|
|
19
|
+
* reference point, not two: #247's false-DRIFT mechanism needs a base layer at
|
|
20
|
+
* `origin/main` AND an overlay at the worktree's own base, and this check has
|
|
21
|
+
* only the first, so it is immune to #247 by construction.
|
|
22
|
+
*
|
|
23
|
+
* NO FETCH. A checker must not perform network I/O as a side effect
|
|
24
|
+
* (config-fidelity.ts:862-866). When `origin/<baseBranch>` is not present
|
|
25
|
+
* locally the verdict is COULD_NOT_COMPARE with a reason that names the fetch —
|
|
26
|
+
* never FRESH. Passed, failed and could-not-run are three outcomes.
|
|
27
|
+
*
|
|
28
|
+
* WHICH FILES. The candidate names are the intersection of (a) the entries of
|
|
29
|
+
* the worktree's `.claude/hooks/` and (b) the hook basenames the worktree's
|
|
30
|
+
* `.claude/settings.json` REGISTERS. Nothing else is read. The registered set is
|
|
31
|
+
* what bounds the printed file name to a reviewed value: anyone who can write
|
|
32
|
+
* into `.claude/hooks/` can otherwise choose the text this check prints into a
|
|
33
|
+
* session (#306 criterion 4).
|
|
34
|
+
*
|
|
35
|
+
* WHERE THE TWO SETTINGS COME FROM. `baseBranch` and `configSource` are read
|
|
36
|
+
* from `mx-agent.config.json` at the worktree path. That file is absent in most
|
|
37
|
+
* worktrees, and the defaults it falls back to (`main` and
|
|
38
|
+
* `mx-agent-system/agent-config`) are the intended answer for that case, not a
|
|
39
|
+
* degraded one: they are the same pair every other caller defaults to, and a
|
|
40
|
+
* worktree that has no project config is a worktree tracking the repository's
|
|
41
|
+
* own layout. `baseBranch` is checked against BASE_BRANCH_RE before use,
|
|
42
|
+
* because it is a worktree-writable value that would otherwise be printed
|
|
43
|
+
* verbatim into a session.
|
|
44
|
+
*
|
|
45
|
+
* SPAWN BUDGET. One `git cat-file --batch` for the whole set in the common
|
|
46
|
+
* (fresh) case, plus one `git hash-object` only when something is stale. The
|
|
47
|
+
* SessionStart budget is 300 ms for the whole command (#306 criterion 1d); a
|
|
48
|
+
* per-file `git show` would be 44 processes and would not meet it.
|
|
49
|
+
*/
|
|
50
|
+
export type HookStalenessVerdict = 'FRESH' | 'STALE' | 'COULD_NOT_COMPARE';
|
|
51
|
+
export interface StaleHook {
|
|
52
|
+
/** Basename under `.claude/hooks/`. Always matches HOOK_NAME_RE. */
|
|
53
|
+
name: string;
|
|
54
|
+
/** `git hash-object` of the deployed file. */
|
|
55
|
+
deployedOid: string;
|
|
56
|
+
/** Object id of `origin/<baseBranch>:<configSource>/hooks/<name>`. */
|
|
57
|
+
sourceOid: string;
|
|
58
|
+
}
|
|
59
|
+
export interface HookStalenessResult {
|
|
60
|
+
verdict: HookStalenessVerdict;
|
|
61
|
+
/** The branch the comparison ran against, for the caller's message. */
|
|
62
|
+
baseBranch: string;
|
|
63
|
+
/**
|
|
64
|
+
* The 40-character commit id `origin/<baseBranch>` resolved to, when it
|
|
65
|
+
* resolved at all. The whole verdict rests on that one local ref, which no
|
|
66
|
+
* fetch refreshed, so a reader who wants to check the claim before running
|
|
67
|
+
* the remedy needs to know which commit it was compared against. Absent when
|
|
68
|
+
* the check bailed before the ref probe.
|
|
69
|
+
*/
|
|
70
|
+
anchor?: string;
|
|
71
|
+
/** How many hooks were actually byte-compared. */
|
|
72
|
+
compared: number;
|
|
73
|
+
/** Deployed hooks whose bytes differ from the source. */
|
|
74
|
+
stale: StaleHook[];
|
|
75
|
+
/**
|
|
76
|
+
* Why a comparison could not be made. Non-empty means the FRESH answer is not
|
|
77
|
+
* available for at least part of the set — the caller must not report fresh.
|
|
78
|
+
*/
|
|
79
|
+
undetermined: string[];
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* Byte-compare every registered, materialised hook against
|
|
83
|
+
* `origin/<baseBranch>`. Never throws: every failure becomes an `undetermined`
|
|
84
|
+
* reason and the COULD_NOT_COMPARE verdict.
|
|
85
|
+
*
|
|
86
|
+
* `opts.path` is the worktree, and the project config is read from THAT
|
|
87
|
+
* directory rather than through `findProjectRoot()`, which ascends to the main
|
|
88
|
+
* worktree. The check reports on the worktree it runs in, and it must not read
|
|
89
|
+
* a directory outside it.
|
|
90
|
+
*/
|
|
91
|
+
export declare function checkHookStaleness(worktreePath: string, opts?: {
|
|
92
|
+
baseBranch?: string;
|
|
93
|
+
configSource?: string;
|
|
94
|
+
}): HookStalenessResult;
|
|
95
|
+
//# sourceMappingURL=hook-staleness.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hook-staleness.d.ts","sourceRoot":"","sources":["../../src/lib/hook-staleness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAgDH,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,OAAO,GAAG,mBAAmB,CAAC;AAE3E,MAAM,WAAW,SAAS;IACxB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB;;;OAGG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAwCD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GACxD,mBAAmB,CAsLrB"}
|