@chankov/agent-fleet 0.0.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/.claude/commands/build.md +44 -0
- package/.claude/commands/code-simplify.md +22 -0
- package/.claude/commands/design-agent.md +14 -0
- package/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.claude/commands/orchestrate.md +112 -0
- package/.claude/commands/plan.md +16 -0
- package/.claude/commands/prime.md +22 -0
- package/.claude/commands/review.md +16 -0
- package/.claude/commands/setup-agent-fleet.md +25 -0
- package/.claude/commands/ship.md +72 -0
- package/.claude/commands/spec.md +15 -0
- package/.claude/commands/test.md +19 -0
- package/.claude/commands/webperf.md +32 -0
- package/.claude/orchestrate-teams.yaml +24 -0
- package/.opencode/commands/af-build.md +17 -0
- package/.opencode/commands/af-code-simplify.md +16 -0
- package/.opencode/commands/af-compound.md +16 -0
- package/.opencode/commands/af-design-agent.md +15 -0
- package/.opencode/commands/af-doctor-agent-fleet.md +15 -0
- package/.opencode/commands/af-orchestrate.md +112 -0
- package/.opencode/commands/af-plan.md +16 -0
- package/.opencode/commands/af-prime.md +22 -0
- package/.opencode/commands/af-review.md +15 -0
- package/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.opencode/commands/af-ship.md +16 -0
- package/.opencode/commands/af-spec.md +16 -0
- package/.opencode/commands/af-test.md +21 -0
- package/.opencode/commands/af-webperf.md +32 -0
- package/.opencode/orchestrate-teams.yaml +24 -0
- package/.pi/agents/dispatch-policy.yaml +32 -0
- package/.pi/agents/model-profiles.yaml +20 -0
- package/.pi/agents/peers.yaml +142 -0
- package/.pi/agents/teams.yaml +39 -0
- package/.pi/damage-control-rules.yaml +297 -0
- package/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.pi/extensions/btw/README.md +118 -0
- package/.pi/extensions/btw/index.ts +917 -0
- package/.pi/extensions/btw/package.json +6 -0
- package/.pi/extensions/btw/state.js +179 -0
- package/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
- package/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.pi/extensions/package-lock.json +1143 -0
- package/.pi/extensions/package.json +9 -0
- package/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.pi/harnesses/agent-hub/README.md +562 -0
- package/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.pi/harnesses/agent-hub/delegate.ts +363 -0
- package/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.pi/harnesses/agent-hub/helpers.ts +165 -0
- package/.pi/harnesses/agent-hub/index.ts +7098 -0
- package/.pi/harnesses/agent-hub/package.json +6 -0
- package/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.pi/harnesses/agent-hub/spawn.ts +179 -0
- package/.pi/harnesses/ask-user-remote/README.md +10 -0
- package/.pi/harnesses/ask-user-remote/index.ts +253 -0
- package/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.pi/harnesses/coms/README.md +71 -0
- package/.pi/harnesses/coms/index.ts +1743 -0
- package/.pi/harnesses/coms/package.json +6 -0
- package/.pi/harnesses/damage-control/README.md +65 -0
- package/.pi/harnesses/damage-control/index.ts +250 -0
- package/.pi/harnesses/damage-control/package.json +6 -0
- package/.pi/harnesses/damage-control/shared.ts +183 -0
- package/.pi/harnesses/damage-control-continue/README.md +116 -0
- package/.pi/harnesses/damage-control-continue/index.ts +522 -0
- package/.pi/harnesses/damage-control-continue/package.json +6 -0
- package/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.pi/harnesses/package-lock.json +35 -0
- package/.pi/harnesses/package.json +9 -0
- package/.pi/prompts/build.md +24 -0
- package/.pi/prompts/code-simplify.md +22 -0
- package/.pi/prompts/doctor-agent-fleet.md +15 -0
- package/.pi/prompts/plan.md +16 -0
- package/.pi/prompts/review.md +16 -0
- package/.pi/prompts/setup-agent-fleet.md +27 -0
- package/.pi/prompts/ship.md +17 -0
- package/.pi/prompts/spec.md +15 -0
- package/.pi/prompts/test.md +19 -0
- package/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.1/.claude/commands/build.md +44 -0
- package/.versions/0.0.1/.claude/commands/code-simplify.md +22 -0
- package/.versions/0.0.1/.claude/commands/design-agent.md +14 -0
- package/.versions/0.0.1/.claude/commands/doctor-agent-fleet.md +17 -0
- package/.versions/0.0.1/.claude/commands/orchestrate.md +112 -0
- package/.versions/0.0.1/.claude/commands/plan.md +16 -0
- package/.versions/0.0.1/.claude/commands/prime.md +22 -0
- package/.versions/0.0.1/.claude/commands/review.md +16 -0
- package/.versions/0.0.1/.claude/commands/setup-agent-fleet.md +25 -0
- package/.versions/0.0.1/.claude/commands/ship.md +72 -0
- package/.versions/0.0.1/.claude/commands/spec.md +15 -0
- package/.versions/0.0.1/.claude/commands/test.md +19 -0
- package/.versions/0.0.1/.claude/commands/webperf.md +32 -0
- package/.versions/0.0.1/.claude/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.1/.opencode/commands/af-build.md +17 -0
- package/.versions/0.0.1/.opencode/commands/af-code-simplify.md +16 -0
- package/.versions/0.0.1/.opencode/commands/af-compound.md +16 -0
- package/.versions/0.0.1/.opencode/commands/af-design-agent.md +15 -0
- package/.versions/0.0.1/.opencode/commands/af-doctor-agent-fleet.md +15 -0
- package/.versions/0.0.1/.opencode/commands/af-orchestrate.md +112 -0
- package/.versions/0.0.1/.opencode/commands/af-plan.md +16 -0
- package/.versions/0.0.1/.opencode/commands/af-prime.md +22 -0
- package/.versions/0.0.1/.opencode/commands/af-review.md +15 -0
- package/.versions/0.0.1/.opencode/commands/af-setup-agent-fleet.md +15 -0
- package/.versions/0.0.1/.opencode/commands/af-ship.md +16 -0
- package/.versions/0.0.1/.opencode/commands/af-spec.md +16 -0
- package/.versions/0.0.1/.opencode/commands/af-test.md +21 -0
- package/.versions/0.0.1/.opencode/commands/af-webperf.md +32 -0
- package/.versions/0.0.1/.opencode/orchestrate-teams.yaml +24 -0
- package/.versions/0.0.1/.pi/agents/dispatch-policy.yaml +32 -0
- package/.versions/0.0.1/.pi/agents/model-profiles.yaml +20 -0
- package/.versions/0.0.1/.pi/agents/peers.yaml +142 -0
- package/.versions/0.0.1/.pi/agents/teams.yaml +39 -0
- package/.versions/0.0.1/.pi/damage-control-rules.yaml +297 -0
- package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/README.md +58 -0
- package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
- package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/btw/README.md +118 -0
- package/.versions/0.0.1/.pi/extensions/btw/index.ts +917 -0
- package/.versions/0.0.1/.pi/extensions/btw/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/btw/state.js +179 -0
- package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
- package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
- package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
- package/.versions/0.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
- package/.versions/0.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
- package/.versions/0.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
- package/.versions/0.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/package-lock.json +1143 -0
- package/.versions/0.0.1/.pi/extensions/package.json +9 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/README.md +201 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
- package/.versions/0.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/README.md +562 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/artifacts.js +92 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/backend-policy.js +153 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/delegate.ts +363 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/helpers.ts +165 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/index.ts +7098 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/package.json +6 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/return-contract.js +215 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
- package/.versions/0.0.1/.pi/harnesses/agent-hub/spawn.ts +179 -0
- package/.versions/0.0.1/.pi/harnesses/ask-user-remote/README.md +10 -0
- package/.versions/0.0.1/.pi/harnesses/ask-user-remote/index.ts +253 -0
- package/.versions/0.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
- package/.versions/0.0.1/.pi/harnesses/coms/README.md +71 -0
- package/.versions/0.0.1/.pi/harnesses/coms/index.ts +1743 -0
- package/.versions/0.0.1/.pi/harnesses/coms/package.json +6 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control/README.md +65 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control/index.ts +250 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control/package.json +6 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control/shared.ts +183 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control-continue/README.md +116 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control-continue/index.ts +522 -0
- package/.versions/0.0.1/.pi/harnesses/damage-control-continue/package.json +6 -0
- package/.versions/0.0.1/.pi/harnesses/lib/herdr-client.ts +458 -0
- package/.versions/0.0.1/.pi/harnesses/lib/herdr-presence.ts +288 -0
- package/.versions/0.0.1/.pi/harnesses/package-lock.json +35 -0
- package/.versions/0.0.1/.pi/harnesses/package.json +9 -0
- package/.versions/0.0.1/.pi/prompts/build.md +24 -0
- package/.versions/0.0.1/.pi/prompts/code-simplify.md +22 -0
- package/.versions/0.0.1/.pi/prompts/doctor-agent-fleet.md +15 -0
- package/.versions/0.0.1/.pi/prompts/plan.md +16 -0
- package/.versions/0.0.1/.pi/prompts/review.md +16 -0
- package/.versions/0.0.1/.pi/prompts/setup-agent-fleet.md +27 -0
- package/.versions/0.0.1/.pi/prompts/ship.md +17 -0
- package/.versions/0.0.1/.pi/prompts/spec.md +15 -0
- package/.versions/0.0.1/.pi/prompts/test.md +19 -0
- package/.versions/0.0.1/.pi/skills/bowser/SKILL.md +145 -0
- package/.versions/0.0.1/.version +1 -0
- package/.versions/0.0.1/agents/architect.md +21 -0
- package/.versions/0.0.1/agents/bowser.md +25 -0
- package/.versions/0.0.1/agents/builder.md +52 -0
- package/.versions/0.0.1/agents/code-reviewer.md +205 -0
- package/.versions/0.0.1/agents/deep-researcher.md +31 -0
- package/.versions/0.0.1/agents/documenter.md +16 -0
- package/.versions/0.0.1/agents/orchestrator.md +43 -0
- package/.versions/0.0.1/agents/plan-reviewer.md +60 -0
- package/.versions/0.0.1/agents/planner.md +69 -0
- package/.versions/0.0.1/agents/releaser.md +22 -0
- package/.versions/0.0.1/agents/researcher.md +28 -0
- package/.versions/0.0.1/agents/security-auditor.md +166 -0
- package/.versions/0.0.1/agents/test-engineer.md +144 -0
- package/.versions/0.0.1/agents/web-debugger.md +42 -0
- package/.versions/0.0.1/agents/web-performance-auditor.md +192 -0
- package/.versions/0.0.1/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/.versions/0.0.1/hooks/coms-stop-hook.mjs +73 -0
- package/.versions/0.0.1/hooks/hooks.json +14 -0
- package/.versions/0.0.1/hooks/session-start.sh +74 -0
- package/.versions/0.0.1/hooks/simplify-ignore.sh +302 -0
- package/.versions/0.0.1/justfile +143 -0
- package/.versions/0.0.1/references/accessibility-checklist.md +160 -0
- package/.versions/0.0.1/references/definition-of-done.md +67 -0
- package/.versions/0.0.1/references/fleet-coordination-patterns.md +151 -0
- package/.versions/0.0.1/references/observability-checklist.md +91 -0
- package/.versions/0.0.1/references/orchestration-patterns.md +370 -0
- package/.versions/0.0.1/references/performance-checklist.md +153 -0
- package/.versions/0.0.1/references/prompting-patterns.md +380 -0
- package/.versions/0.0.1/references/security-checklist.md +179 -0
- package/.versions/0.0.1/references/testing-patterns.md +236 -0
- package/.versions/0.0.1/scripts/coms-claude-bridge.ts +286 -0
- package/.versions/0.0.1/scripts/coms-cli.ts +372 -0
- package/.versions/0.0.1/scripts/coms-hermes-bridge.ts +399 -0
- package/.versions/0.0.1/scripts/lib/claude-bridge-core.ts +100 -0
- package/.versions/0.0.1/scripts/lib/coms-envelope.ts +494 -0
- package/.versions/0.0.1/scripts/lib/herdr-layout.ts +235 -0
- package/.versions/0.0.1/scripts/lib/hermes-bridge-core.ts +238 -0
- package/.versions/0.0.1/scripts/lib/persona-banner.ts +62 -0
- package/.versions/0.0.1/scripts/lib/team-project.ts +75 -0
- package/.versions/0.0.1/scripts/lib/team-snapshot.ts +146 -0
- package/.versions/0.0.1/scripts/peer-banner.ts +40 -0
- package/.versions/0.0.1/scripts/team-snapshot.ts +221 -0
- package/.versions/0.0.1/scripts/team-up.ts +245 -0
- package/.versions/0.0.1/skills/_internal/grilling.md +11 -0
- package/.versions/0.0.1/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/.versions/0.0.1/skills/code-review-and-quality/SKILL.md +381 -0
- package/.versions/0.0.1/skills/compound-learning/SKILL.md +137 -0
- package/.versions/0.0.1/skills/context-engineering/SKILL.md +291 -0
- package/.versions/0.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
- package/.versions/0.0.1/skills/designing-agents/SKILL.md +394 -0
- package/.versions/0.0.1/skills/designing-agents/pi-harness-authoring.md +209 -0
- package/.versions/0.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/.versions/0.0.1/skills/guided-workspace-setup/SKILL.md +506 -0
- package/.versions/0.0.1/skills/idea-refine/SKILL.md +182 -0
- package/.versions/0.0.1/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.1/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.1/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.1/skills/incremental-implementation/SKILL.md +287 -0
- package/.versions/0.0.1/skills/interview-me/SKILL.md +226 -0
- package/.versions/0.0.1/skills/orchestration-verification/SKILL.md +181 -0
- package/.versions/0.0.1/skills/peer-coms/SKILL.md +81 -0
- package/.versions/0.0.1/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.1/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/.versions/0.0.1/skills/security-and-hardening/SKILL.md +461 -0
- package/.versions/0.0.1/skills/spec-driven-development/SKILL.md +245 -0
- package/.versions/0.0.1/skills/using-agent-skills/SKILL.md +199 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/README.md +11 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/.versions/0.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
- package/CHANGELOG.md +65 -0
- package/LICENSE +21 -0
- package/README.md +458 -0
- package/agents/architect.md +21 -0
- package/agents/bowser.md +25 -0
- package/agents/builder.md +52 -0
- package/agents/code-reviewer.md +205 -0
- package/agents/deep-researcher.md +31 -0
- package/agents/documenter.md +16 -0
- package/agents/orchestrator.md +43 -0
- package/agents/plan-reviewer.md +60 -0
- package/agents/planner.md +69 -0
- package/agents/releaser.md +22 -0
- package/agents/researcher.md +28 -0
- package/agents/security-auditor.md +166 -0
- package/agents/test-engineer.md +144 -0
- package/agents/web-debugger.md +42 -0
- package/agents/web-performance-auditor.md +192 -0
- package/bin/cli.js +633 -0
- package/bin/force-patch-changesets.js +44 -0
- package/bin/lib/bootstrap.js +323 -0
- package/bin/lib/detect-agent.js +49 -0
- package/bin/lib/doctor.js +302 -0
- package/bin/lib/transform-persona.js +180 -0
- package/bin/lib/update-notifier.js +195 -0
- package/bin/lib/validate-overrides.js +229 -0
- package/bin/snapshot-version.js +91 -0
- package/docs/agent-fleet-setup.md +355 -0
- package/docs/claude-code-coms-bridge.md +93 -0
- package/docs/getting-started.md +169 -0
- package/docs/npm-install.md +335 -0
- package/docs/opencode-setup.md +248 -0
- package/docs/pi-extensions.md +237 -0
- package/docs/pi-setup.md +455 -0
- package/docs/skill-anatomy.md +150 -0
- package/hooks/SIMPLIFY-IGNORE.md +90 -0
- package/hooks/coms-stop-hook.mjs +73 -0
- package/hooks/hooks.json +14 -0
- package/hooks/session-start.sh +74 -0
- package/hooks/simplify-ignore.sh +302 -0
- package/justfile +143 -0
- package/node_modules/pi-ask-user/LICENSE +21 -0
- package/node_modules/pi-ask-user/README.md +156 -0
- package/node_modules/pi-ask-user/index.ts +1795 -0
- package/node_modules/pi-ask-user/package.json +51 -0
- package/node_modules/pi-ask-user/single-select-layout.ts +203 -0
- package/node_modules/pi-ask-user/skills/ask-user/SKILL.md +162 -0
- package/node_modules/pi-ask-user/skills/ask-user/references/ask-user-skill-extension-spec.md +96 -0
- package/package.json +121 -0
- package/references/accessibility-checklist.md +160 -0
- package/references/definition-of-done.md +67 -0
- package/references/fleet-coordination-patterns.md +151 -0
- package/references/observability-checklist.md +91 -0
- package/references/orchestration-patterns.md +370 -0
- package/references/performance-checklist.md +153 -0
- package/references/prompting-patterns.md +380 -0
- package/references/security-checklist.md +179 -0
- package/references/testing-patterns.md +236 -0
- package/scripts/coms-claude-bridge.ts +286 -0
- package/scripts/coms-cli.ts +372 -0
- package/scripts/coms-hermes-bridge.ts +399 -0
- package/scripts/lib/claude-bridge-core.ts +100 -0
- package/scripts/lib/coms-envelope.ts +494 -0
- package/scripts/lib/herdr-layout.ts +235 -0
- package/scripts/lib/hermes-bridge-core.ts +238 -0
- package/scripts/lib/persona-banner.ts +62 -0
- package/scripts/lib/team-project.ts +75 -0
- package/scripts/lib/team-snapshot.ts +146 -0
- package/scripts/peer-banner.ts +40 -0
- package/scripts/team-snapshot.ts +221 -0
- package/scripts/team-up.ts +245 -0
- package/skills/_internal/grilling.md +11 -0
- package/skills/browser-testing-with-devtools/SKILL.md +352 -0
- package/skills/code-review-and-quality/SKILL.md +381 -0
- package/skills/compound-learning/SKILL.md +137 -0
- package/skills/context-engineering/SKILL.md +291 -0
- package/skills/deprecation-and-migration/SKILL.md +206 -0
- package/skills/designing-agents/SKILL.md +394 -0
- package/skills/designing-agents/pi-harness-authoring.md +209 -0
- package/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/skills/git-workflow-and-versioning/SKILL.md +316 -0
- package/skills/guided-workspace-setup/SKILL.md +506 -0
- package/skills/idea-refine/SKILL.md +182 -0
- package/skills/idea-refine/examples.md +238 -0
- package/skills/idea-refine/frameworks.md +99 -0
- package/skills/idea-refine/refinement-criteria.md +113 -0
- package/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/skills/incremental-implementation/SKILL.md +287 -0
- package/skills/interview-me/SKILL.md +226 -0
- package/skills/orchestration-verification/SKILL.md +181 -0
- package/skills/peer-coms/SKILL.md +81 -0
- package/skills/performance-optimization/SKILL.md +350 -0
- package/skills/planning-and-task-breakdown/SKILL.md +236 -0
- package/skills/security-and-hardening/SKILL.md +461 -0
- package/skills/spec-driven-development/SKILL.md +245 -0
- package/skills/using-agent-skills/SKILL.md +199 -0
- package/vendor/agent-skills-upstream/LICENSE +21 -0
- package/vendor/agent-skills-upstream/README.md +11 -0
- package/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
- package/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
- package/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
- package/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
- package/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
- package/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
- package/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
- package/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
- package/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
- package/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
- package/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
- package/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
- package/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
- package/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
- package/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
- package/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
- package/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
- package/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
- package/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
- package/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
- package/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
- package/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
- package/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
- package/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
- package/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
- package/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
- package/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
- package/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
# simplify-ignore hook
|
|
2
|
+
|
|
3
|
+
Block-level protection for `/code-simplify`. Mark code that should never be simplified — the model won't see it.
|
|
4
|
+
|
|
5
|
+
## Setup
|
|
6
|
+
|
|
7
|
+
1. Annotate blocks you want to protect:
|
|
8
|
+
|
|
9
|
+
```js
|
|
10
|
+
/* simplify-ignore-start: perf-critical */
|
|
11
|
+
// manually unrolled XOR — 3x faster than a loop
|
|
12
|
+
result[0] = buf[0] ^ key[0];
|
|
13
|
+
result[1] = buf[1] ^ key[1];
|
|
14
|
+
result[2] = buf[2] ^ key[2];
|
|
15
|
+
result[3] = buf[3] ^ key[3];
|
|
16
|
+
/* simplify-ignore-end */
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
2. Add hooks to `.claude/settings.json`:
|
|
20
|
+
|
|
21
|
+
```json
|
|
22
|
+
{
|
|
23
|
+
"hooks": {
|
|
24
|
+
"PreToolUse": [
|
|
25
|
+
{
|
|
26
|
+
"matcher": "Read",
|
|
27
|
+
"hooks": [{ "type": "command", "command": "bash ${CLAUDE_PROJECT_DIR}/hooks/simplify-ignore.sh" }]
|
|
28
|
+
}
|
|
29
|
+
],
|
|
30
|
+
"PostToolUse": [
|
|
31
|
+
{
|
|
32
|
+
"matcher": "Edit|Write",
|
|
33
|
+
"hooks": [{ "type": "command", "command": "bash ${CLAUDE_PROJECT_DIR}/hooks/simplify-ignore.sh" }]
|
|
34
|
+
}
|
|
35
|
+
],
|
|
36
|
+
"Stop": [
|
|
37
|
+
{
|
|
38
|
+
"hooks": [{ "type": "command", "command": "bash ${CLAUDE_PROJECT_DIR}/hooks/simplify-ignore.sh" }]
|
|
39
|
+
}
|
|
40
|
+
]
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
3. Run `/code-simplify` — protected blocks become `/* BLOCK_de115a1d: perf-critical */` placeholders. The model reasons about surrounding code without seeing the protected implementation.
|
|
46
|
+
|
|
47
|
+
> **Note:** The hook stores temporary backups in `.claude/.simplify-ignore-cache/`. Make sure this path is in your `.gitignore`.
|
|
48
|
+
|
|
49
|
+
## How it works
|
|
50
|
+
|
|
51
|
+
One script, three hook events:
|
|
52
|
+
|
|
53
|
+
| Event | Action |
|
|
54
|
+
|---|---|
|
|
55
|
+
| `PreToolUse Read` | Backs up file, replaces blocks with `BLOCK_<hash>` placeholders in-place |
|
|
56
|
+
| `PostToolUse Edit\|Write` | Expands placeholders back to real code, saves model's changes, re-filters |
|
|
57
|
+
| `Stop` | Restores all files from backup when session ends |
|
|
58
|
+
|
|
59
|
+
Each block is content-hashed (8 hex chars via `shasum`/`sha1sum`) so the round-trip is unambiguous even if the model duplicates or reorders placeholders. Cache is project-scoped to prevent cross-session interference.
|
|
60
|
+
|
|
61
|
+
## Annotation syntax
|
|
62
|
+
|
|
63
|
+
```js
|
|
64
|
+
/* simplify-ignore-start */ // basic — hides the block
|
|
65
|
+
/* simplify-ignore-start: reason */ // with reason — appears in placeholder
|
|
66
|
+
/* simplify-ignore-end */
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
Any comment style works (`//`, `/*`, `#`, `<!--`). Multiple blocks per file and single-line blocks supported. Placeholders preserve the original comment syntax (e.g. `# BLOCK_xxx` for Python, `<!-- BLOCK_xxx -->` for HTML).
|
|
70
|
+
|
|
71
|
+
## Crash recovery
|
|
72
|
+
|
|
73
|
+
If Claude Code crashes without triggering the Stop hook, files on disk may still have `BLOCK_<hash>` placeholders. To restore manually:
|
|
74
|
+
|
|
75
|
+
```bash
|
|
76
|
+
echo '{}' | bash hooks/simplify-ignore.sh
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
Backups are stored in `.claude/.simplify-ignore-cache/` within your project directory.
|
|
80
|
+
|
|
81
|
+
## Known limitations
|
|
82
|
+
|
|
83
|
+
- **Single-line blocks hide the entire line.** If `simplify-ignore-start` and `simplify-ignore-end` appear on the same line as other code, the whole line is hidden from the model, not just the annotated portion. Use dedicated lines for annotations.
|
|
84
|
+
- **Comment suffix detection covers `*/` and `-->` only.** Template engines with non-standard comment closers (ERB `%>`, Blade `--}}`) may produce unbalanced placeholders. Use `#` or `//` style comments instead.
|
|
85
|
+
- **Fallback expansion is progressive, not exact.** If the model alters a placeholder's formatting (e.g. changes the reason text), the hook tries progressively simpler matches: full placeholder → prefix+hash+suffix → hash-only. The hash-only fallback may leave cosmetic debris (e.g. stray `:` or reason text). A warning is printed to stderr when this happens.
|
|
86
|
+
- **File renaming leaves placeholders.** If the model renames or moves a file via a shell command, the new file will retain `BLOCK_<hash>` placeholders. The original code is saved as `<old-filename>.recovered` when the session stops. You must manually restore the recovered code into the new file.
|
|
87
|
+
|
|
88
|
+
## Requirements
|
|
89
|
+
|
|
90
|
+
- `jq`, `shasum` or `sha1sum` (auto-detected), Bash 3.2+
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// hooks/coms-stop-hook.mjs — Claude Code Stop hook for the coms bridge.
|
|
3
|
+
//
|
|
4
|
+
// Writes the final assistant message of each turn to the file the
|
|
5
|
+
// coms-claude-bridge watches (~/.pi/coms/claude-bridge/<pane>/last-message.json,
|
|
6
|
+
// keyed by HERDR_PANE_ID), making the hook the bridge's PRIMARY completion
|
|
7
|
+
// path (exact text, no pane scraping). Outside a herdr pane it does nothing.
|
|
8
|
+
//
|
|
9
|
+
// Install (project or user settings.json):
|
|
10
|
+
// {
|
|
11
|
+
// "hooks": {
|
|
12
|
+
// "Stop": [{ "hooks": [{ "type": "command",
|
|
13
|
+
// "command": "node /path/to/agent-fleet/hooks/coms-stop-hook.mjs" }] }]
|
|
14
|
+
// }
|
|
15
|
+
// }
|
|
16
|
+
//
|
|
17
|
+
// The hook receives {session_id, transcript_path, …} as JSON on stdin and
|
|
18
|
+
// must never fail the turn: every error path exits 0.
|
|
19
|
+
|
|
20
|
+
import * as fs from "node:fs";
|
|
21
|
+
import * as os from "node:os";
|
|
22
|
+
import * as path from "node:path";
|
|
23
|
+
|
|
24
|
+
function lastAssistantText(transcriptPath) {
|
|
25
|
+
const raw = fs.readFileSync(transcriptPath, "utf-8");
|
|
26
|
+
let text = null;
|
|
27
|
+
for (const line of raw.split("\n")) {
|
|
28
|
+
if (!line.trim()) continue;
|
|
29
|
+
let entry;
|
|
30
|
+
try {
|
|
31
|
+
entry = JSON.parse(line);
|
|
32
|
+
} catch {
|
|
33
|
+
continue;
|
|
34
|
+
}
|
|
35
|
+
if (entry?.type !== "assistant") continue;
|
|
36
|
+
const content = entry?.message?.content;
|
|
37
|
+
if (!Array.isArray(content)) continue;
|
|
38
|
+
const parts = content.filter((c) => c?.type === "text" && typeof c.text === "string").map((c) => c.text);
|
|
39
|
+
if (parts.length > 0) text = parts.join("\n");
|
|
40
|
+
}
|
|
41
|
+
return text;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
try {
|
|
45
|
+
const paneId = process.env.HERDR_PANE_ID;
|
|
46
|
+
if (!paneId) process.exit(0); // not in a herdr pane — nothing to bridge
|
|
47
|
+
|
|
48
|
+
const input = JSON.parse(fs.readFileSync(0, "utf-8"));
|
|
49
|
+
const transcriptPath = input?.transcript_path;
|
|
50
|
+
if (!transcriptPath || !fs.existsSync(transcriptPath)) process.exit(0);
|
|
51
|
+
|
|
52
|
+
const text = lastAssistantText(transcriptPath);
|
|
53
|
+
if (text == null) process.exit(0);
|
|
54
|
+
|
|
55
|
+
const dir = path.join(
|
|
56
|
+
os.homedir(),
|
|
57
|
+
".pi",
|
|
58
|
+
"coms",
|
|
59
|
+
"claude-bridge",
|
|
60
|
+
paneId.replace(/[^A-Za-z0-9_-]/g, "_"),
|
|
61
|
+
);
|
|
62
|
+
fs.mkdirSync(dir, { recursive: true });
|
|
63
|
+
const file = path.join(dir, "last-message.json");
|
|
64
|
+
const tmp = `${file}.tmp-${process.pid}`;
|
|
65
|
+
fs.writeFileSync(
|
|
66
|
+
tmp,
|
|
67
|
+
JSON.stringify({ text, session_id: input.session_id ?? null, written_at: new Date().toISOString() }),
|
|
68
|
+
);
|
|
69
|
+
fs.renameSync(tmp, file);
|
|
70
|
+
} catch {
|
|
71
|
+
// never fail the turn
|
|
72
|
+
}
|
|
73
|
+
process.exit(0);
|
package/hooks/hooks.json
ADDED
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
{
|
|
2
|
+
"hooks": {
|
|
3
|
+
"SessionStart": [
|
|
4
|
+
{
|
|
5
|
+
"hooks": [
|
|
6
|
+
{
|
|
7
|
+
"type": "command",
|
|
8
|
+
"command": "SCRIPT=\"${CLAUDE_PLUGIN_ROOT}/hooks/session-start.sh\"; [ -f \"$SCRIPT\" ] || SCRIPT=\"${CLAUDE_PROJECT_DIR}/.claude/hooks/session-start.sh\"; [ -f \"$SCRIPT\" ]&& bash \"$SCRIPT\" || true"
|
|
9
|
+
}
|
|
10
|
+
]
|
|
11
|
+
}
|
|
12
|
+
]
|
|
13
|
+
}
|
|
14
|
+
}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
#!/bin/bash
|
|
2
|
+
# agent-fleet session start hook (Claude Code).
|
|
3
|
+
#
|
|
4
|
+
# Two responsibilities:
|
|
5
|
+
# 1. Inject the using-agent-skills meta-skill into the session context so
|
|
6
|
+
# Claude can route tasks to the right skill.
|
|
7
|
+
# 2. Surface a one-line "update available" banner when the installed
|
|
8
|
+
# package is behind the published version on npm.
|
|
9
|
+
#
|
|
10
|
+
# Both are best-effort. Network errors, missing files, and missing tools
|
|
11
|
+
# never block session start — the hook always exits 0 and prints a valid
|
|
12
|
+
# JSON object on stdout.
|
|
13
|
+
|
|
14
|
+
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
|
|
15
|
+
PACKAGE_ROOT="$(dirname "$SCRIPT_DIR")"
|
|
16
|
+
SKILLS_DIR="$PACKAGE_ROOT/skills"
|
|
17
|
+
META_SKILL="$SKILLS_DIR/using-agent-skills/SKILL.md"
|
|
18
|
+
CHECK_SCRIPT="$PACKAGE_ROOT/bin/cli.js"
|
|
19
|
+
|
|
20
|
+
# ── 1. Meta-skill content ────────────────────────────────────────────────
|
|
21
|
+
if [ -f "$META_SKILL" ]; then
|
|
22
|
+
META_CONTENT=$(cat "$META_SKILL")
|
|
23
|
+
PRIORITY="IMPORTANT"
|
|
24
|
+
BASE_MESSAGE="agent-fleet loaded. Use the skill discovery flowchart to find the right skill for your task."
|
|
25
|
+
else
|
|
26
|
+
META_CONTENT=""
|
|
27
|
+
PRIORITY="INFO"
|
|
28
|
+
BASE_MESSAGE="agent-fleet: using-agent-skills meta-skill not found. Skills may still be available individually."
|
|
29
|
+
fi
|
|
30
|
+
|
|
31
|
+
# ── 2. Update banner (silent on any error) ───────────────────────────────
|
|
32
|
+
UPDATE_BANNER=""
|
|
33
|
+
if [ "$AGENT_SKILLS_NO_UPDATE_CHECK" != "1" ] \
|
|
34
|
+
&& [ "$NO_UPDATE_NOTIFIER" != "1" ] \
|
|
35
|
+
&& [ "$CI" != "true" ] \
|
|
36
|
+
&& command -v node >/dev/null 2>&1 \
|
|
37
|
+
&& [ -f "$CHECK_SCRIPT" ]; then
|
|
38
|
+
# Run with a 3-second wall-clock cap so a hung registry never stalls the
|
|
39
|
+
# session. The check-update subcommand emits the banner on stdout when an
|
|
40
|
+
# upgrade is available, nothing otherwise. Errors go to /dev/null.
|
|
41
|
+
if command -v timeout >/dev/null 2>&1; then
|
|
42
|
+
UPDATE_BANNER=$(timeout 3 node "$CHECK_SCRIPT" check-update 2>/dev/null || true)
|
|
43
|
+
else
|
|
44
|
+
UPDATE_BANNER=$(node "$CHECK_SCRIPT" check-update 2>/dev/null || true)
|
|
45
|
+
fi
|
|
46
|
+
fi
|
|
47
|
+
|
|
48
|
+
# ── Compose the message ──────────────────────────────────────────────────
|
|
49
|
+
FULL_MESSAGE="$BASE_MESSAGE"
|
|
50
|
+
if [ -n "$UPDATE_BANNER" ]; then
|
|
51
|
+
FULL_MESSAGE=$(printf '%s\n\n%s' "$FULL_MESSAGE" "$UPDATE_BANNER")
|
|
52
|
+
fi
|
|
53
|
+
if [ -n "$META_CONTENT" ]; then
|
|
54
|
+
FULL_MESSAGE=$(printf '%s\n\n%s' "$FULL_MESSAGE" "$META_CONTENT")
|
|
55
|
+
fi
|
|
56
|
+
|
|
57
|
+
# ── Emit JSON (node handles escaping correctly) ──────────────────────────
|
|
58
|
+
if command -v node >/dev/null 2>&1; then
|
|
59
|
+
printf '%s' "$FULL_MESSAGE" | node -e '
|
|
60
|
+
let msg = "";
|
|
61
|
+
process.stdin.setEncoding("utf8");
|
|
62
|
+
process.stdin.on("data", c => { msg += c; });
|
|
63
|
+
process.stdin.on("end", () => {
|
|
64
|
+
process.stdout.write(JSON.stringify({
|
|
65
|
+
priority: process.env.PRIORITY || "INFO",
|
|
66
|
+
message: msg,
|
|
67
|
+
}) + "\n");
|
|
68
|
+
});
|
|
69
|
+
'
|
|
70
|
+
else
|
|
71
|
+
# Fallback: ship just the base message with minimal escaping.
|
|
72
|
+
SAFE_MSG=$(printf '%s' "$BASE_MESSAGE" | sed 's/\\/\\\\/g; s/"/\\"/g')
|
|
73
|
+
printf '{"priority": "%s", "message": "%s"}\n' "$PRIORITY" "$SAFE_MSG"
|
|
74
|
+
fi
|
|
@@ -0,0 +1,302 @@
|
|
|
1
|
+
#!/bin/bash
|
|
2
|
+
# simplify-ignore.sh — Hook for Read (PreToolUse), Edit|Write (PostToolUse), Stop
|
|
3
|
+
#
|
|
4
|
+
# PreToolUse Read → backs up file, replaces blocks with BLOCK_<hash> in-place
|
|
5
|
+
# PostToolUse Edit → expands placeholders, re-filters so file stays hidden
|
|
6
|
+
# PostToolUse Write → expands placeholders, re-filters so file stays hidden
|
|
7
|
+
# Stop → restores real file content from backup
|
|
8
|
+
#
|
|
9
|
+
# The file on disk ALWAYS has placeholders while the session is active.
|
|
10
|
+
# The real content (with model's changes applied) lives in the backup.
|
|
11
|
+
#
|
|
12
|
+
# Dependencies: jq, shasum or sha1sum (auto-detected)
|
|
13
|
+
|
|
14
|
+
set -euo pipefail
|
|
15
|
+
|
|
16
|
+
if ! command -v jq >/dev/null 2>&1; then
|
|
17
|
+
printf '%s\n' "error: missing jq" >&2; exit 1
|
|
18
|
+
fi
|
|
19
|
+
|
|
20
|
+
CACHE="${CLAUDE_PROJECT_DIR:-.}/.claude/.simplify-ignore-cache"
|
|
21
|
+
if [ -t 0 ]; then INPUT="{}"; else INPUT=$(cat); fi
|
|
22
|
+
|
|
23
|
+
# Parse hook input — trap errors explicitly so set -e doesn't cause
|
|
24
|
+
# a silent exit on malformed JSON, and surface a useful diagnostic.
|
|
25
|
+
parse_error=""
|
|
26
|
+
TOOL_NAME=$(printf '%s' "$INPUT" | jq -r '.tool_name // empty' 2>/dev/null) || {
|
|
27
|
+
parse_error="failed to parse .tool_name from hook input"
|
|
28
|
+
TOOL_NAME=""
|
|
29
|
+
}
|
|
30
|
+
FILE_PATH=$(printf '%s' "$INPUT" | jq -r '.tool_input.file_path // empty' 2>/dev/null) || {
|
|
31
|
+
parse_error="failed to parse .tool_input.file_path from hook input"
|
|
32
|
+
FILE_PATH=""
|
|
33
|
+
}
|
|
34
|
+
if [ -n "$parse_error" ]; then
|
|
35
|
+
printf 'Warning: %s (input: %.120s)\n' "$parse_error" "$INPUT" >&2
|
|
36
|
+
fi
|
|
37
|
+
|
|
38
|
+
hash_cmd() {
|
|
39
|
+
if command -v shasum >/dev/null 2>&1; then shasum
|
|
40
|
+
elif command -v sha1sum >/dev/null 2>&1; then sha1sum
|
|
41
|
+
else printf '%s\n' "error: missing shasum or sha1sum" >&2; exit 1; fi
|
|
42
|
+
}
|
|
43
|
+
file_id() { printf '%s' "$1" | hash_cmd | cut -c1-16; }
|
|
44
|
+
block_hash() { printf '%s' "$1" | hash_cmd | cut -c1-8; }
|
|
45
|
+
# Escape glob metacharacters so ${var/pattern/repl} treats pattern as literal.
|
|
46
|
+
# Needed for Bash 3.2 (macOS) where quotes don't suppress globbing in PE patterns.
|
|
47
|
+
escape_glob() {
|
|
48
|
+
local s="$1"
|
|
49
|
+
s="${s//\\/\\\\}"
|
|
50
|
+
s="${s//\*/\\*}"
|
|
51
|
+
s="${s//\?/\\?}"
|
|
52
|
+
s="${s//\[/\\[}"
|
|
53
|
+
printf '%s' "$s"
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
# ── filter_file: replace simplify-ignore blocks with BLOCK_<hash> placeholders ─
|
|
57
|
+
# Reads $1 (source), writes filtered version to $2 (dest), saves blocks to cache.
|
|
58
|
+
# Returns 0 if blocks were found, 1 if none.
|
|
59
|
+
filter_file() {
|
|
60
|
+
local src="$1" dest="$2" fid="$3"
|
|
61
|
+
: > "$dest"
|
|
62
|
+
rm -f "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
|
|
63
|
+
|
|
64
|
+
local count=0 in_block=0 buf="" reason="" prefix="" suffix=""
|
|
65
|
+
|
|
66
|
+
while IFS= read -r line || [ -n "$line" ]; do
|
|
67
|
+
# Check for start marker (no fork — uses bash case)
|
|
68
|
+
if [ $in_block -eq 0 ]; then
|
|
69
|
+
case "$line" in *simplify-ignore-start*)
|
|
70
|
+
in_block=1
|
|
71
|
+
buf="$line"
|
|
72
|
+
# Extract comment prefix/suffix to preserve language-appropriate syntax
|
|
73
|
+
prefix="${line%%simplify-ignore-start*}"
|
|
74
|
+
suffix=""
|
|
75
|
+
case "$line" in *'*/'*) suffix=" */" ;; *'-->'*) suffix=" -->" ;; esac
|
|
76
|
+
reason=$(printf '%s' "$line" | sed -n 's/.*simplify-ignore-start:[[:space:]]*//p' \
|
|
77
|
+
| sed 's/[[:space:]]*\*\/.*$//' | sed 's/[[:space:]]*-->.*$//' | sed 's/[[:space:]]*$//')
|
|
78
|
+
# Handle single-line block (start + end on same line)
|
|
79
|
+
case "$line" in *simplify-ignore-end*)
|
|
80
|
+
in_block=0
|
|
81
|
+
# Write single-line block immediately and skip to next line
|
|
82
|
+
# to avoid the end-marker check below firing again
|
|
83
|
+
local h; h=$(block_hash "$buf")
|
|
84
|
+
count=$((count + 1))
|
|
85
|
+
printf '%s' "$buf" > "$CACHE/${fid}.block.${h}"
|
|
86
|
+
[ -n "$reason" ] && printf '%s' "$reason" > "$CACHE/${fid}.reason.${h}"
|
|
87
|
+
printf '%s' "$prefix" > "$CACHE/${fid}.prefix.${h}"
|
|
88
|
+
printf '%s' "$suffix" > "$CACHE/${fid}.suffix.${h}"
|
|
89
|
+
if [ -n "$reason" ]; then
|
|
90
|
+
printf '%s\n' "${prefix}BLOCK_${h}: ${reason}${suffix}" >> "$dest"
|
|
91
|
+
else
|
|
92
|
+
printf '%s\n' "${prefix}BLOCK_${h}${suffix}" >> "$dest"
|
|
93
|
+
fi
|
|
94
|
+
buf=""; reason=""; prefix=""; suffix=""
|
|
95
|
+
continue
|
|
96
|
+
;; *)
|
|
97
|
+
continue
|
|
98
|
+
;;
|
|
99
|
+
esac
|
|
100
|
+
;; esac
|
|
101
|
+
fi
|
|
102
|
+
# Accumulate block content
|
|
103
|
+
if [ $in_block -eq 1 ]; then
|
|
104
|
+
buf="${buf}
|
|
105
|
+
${line}"
|
|
106
|
+
fi
|
|
107
|
+
# Check for end marker
|
|
108
|
+
case "$line" in *simplify-ignore-end*)
|
|
109
|
+
if [ $in_block -eq 1 ]; then
|
|
110
|
+
local h; h=$(block_hash "$buf")
|
|
111
|
+
count=$((count + 1))
|
|
112
|
+
printf '%s' "$buf" > "$CACHE/${fid}.block.${h}"
|
|
113
|
+
[ -n "$reason" ] && printf '%s' "$reason" > "$CACHE/${fid}.reason.${h}"
|
|
114
|
+
printf '%s' "$prefix" > "$CACHE/${fid}.prefix.${h}"
|
|
115
|
+
printf '%s' "$suffix" > "$CACHE/${fid}.suffix.${h}"
|
|
116
|
+
if [ -n "$reason" ]; then
|
|
117
|
+
printf '%s\n' "${prefix}BLOCK_${h}: ${reason}${suffix}" >> "$dest"
|
|
118
|
+
else
|
|
119
|
+
printf '%s\n' "${prefix}BLOCK_${h}${suffix}" >> "$dest"
|
|
120
|
+
fi
|
|
121
|
+
in_block=0; buf=""; reason=""; prefix=""; suffix=""
|
|
122
|
+
continue
|
|
123
|
+
fi
|
|
124
|
+
;;
|
|
125
|
+
esac
|
|
126
|
+
[ $in_block -eq 0 ] && printf '%s\n' "$line" >> "$dest"
|
|
127
|
+
done < "$src"
|
|
128
|
+
|
|
129
|
+
# Unclosed block → flush as-is
|
|
130
|
+
if [ $in_block -eq 1 ] && [ -n "$buf" ]; then
|
|
131
|
+
printf 'Warning: unclosed simplify-ignore-start in %s (block not hidden)\n' "$src" >&2
|
|
132
|
+
printf '%s\n' "$buf" >> "$dest"
|
|
133
|
+
fi
|
|
134
|
+
|
|
135
|
+
# Preserve trailing newline status of source
|
|
136
|
+
if [ -s "$dest" ] && [ -s "$src" ] && [ -n "$(tail -c 1 "$src")" ]; then
|
|
137
|
+
perl -pe 'chomp if eof' "$dest" > "${dest}.nnl" && \
|
|
138
|
+
cat "${dest}.nnl" > "$dest" && rm -f "${dest}.nnl"
|
|
139
|
+
fi
|
|
140
|
+
|
|
141
|
+
[ $count -gt 0 ] && return 0 || return 1
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
# ── Stop: restore all files from backup ───────────────────────────────────────
|
|
145
|
+
if [ -z "$TOOL_NAME" ]; then
|
|
146
|
+
[ -d "$CACHE" ] || exit 0
|
|
147
|
+
for bak in "$CACHE"/*.bak; do
|
|
148
|
+
[ -f "$bak" ] || continue
|
|
149
|
+
fid="${bak##*/}"; fid="${fid%.bak}"
|
|
150
|
+
pathfile="$CACHE/${fid}.path"
|
|
151
|
+
[ -f "$pathfile" ] || { rm -f "$bak"; continue; }
|
|
152
|
+
orig=$(cat "$pathfile")
|
|
153
|
+
if [ -f "$orig" ]; then
|
|
154
|
+
cat "$bak" > "$orig"
|
|
155
|
+
rm -f "$bak" "$pathfile" "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
|
|
156
|
+
rmdir "$CACHE/${fid}.lock" 2>/dev/null
|
|
157
|
+
else
|
|
158
|
+
# File was moved/deleted — save backup as .recovered, don't destroy it
|
|
159
|
+
mkdir -p "$(dirname "${orig}.recovered")"
|
|
160
|
+
mv "$bak" "${orig}.recovered"
|
|
161
|
+
rm -f "$pathfile" "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
|
|
162
|
+
rmdir "$CACHE/${fid}.lock" 2>/dev/null
|
|
163
|
+
printf 'Warning: %s was moved/deleted. Recovered original to %s.recovered\n' "$orig" "$orig" >&2
|
|
164
|
+
fi
|
|
165
|
+
done
|
|
166
|
+
# Clean orphan locks (created but crash before backup)
|
|
167
|
+
for lockdir in "$CACHE"/*.lock; do
|
|
168
|
+
[ -d "$lockdir" ] || continue
|
|
169
|
+
rmdir "$lockdir" 2>/dev/null
|
|
170
|
+
done
|
|
171
|
+
exit 0
|
|
172
|
+
fi
|
|
173
|
+
|
|
174
|
+
[ -z "$FILE_PATH" ] && exit 0
|
|
175
|
+
|
|
176
|
+
# ── PreToolUse Read: filter in-place ──────────────────────────────────────────
|
|
177
|
+
if [ "$TOOL_NAME" = "Read" ]; then
|
|
178
|
+
[ -f "$FILE_PATH" ] || exit 0
|
|
179
|
+
case "$(basename "$FILE_PATH")" in simplify-ignore*|SIMPLIFY-IGNORE*) exit 0 ;; esac
|
|
180
|
+
|
|
181
|
+
mkdir -p "$CACHE"
|
|
182
|
+
ID=$(file_id "$FILE_PATH")
|
|
183
|
+
|
|
184
|
+
# If backup exists, file is already filtered — skip
|
|
185
|
+
[ -f "$CACHE/${ID}.bak" ] && exit 0
|
|
186
|
+
|
|
187
|
+
grep -q 'simplify-ignore-start' -- "$FILE_PATH" || exit 0
|
|
188
|
+
|
|
189
|
+
# Atomic lock: mkdir fails if another session races us
|
|
190
|
+
if ! mkdir "$CACHE/${ID}.lock" 2>/dev/null; then
|
|
191
|
+
# Lock exists — reclaim only if stale (>60s old, no backup = crash leftover)
|
|
192
|
+
if [ ! -f "$CACHE/${ID}.bak" ] && \
|
|
193
|
+
[ -n "$(find "$CACHE/${ID}.lock" -maxdepth 0 -mmin +1 2>/dev/null)" ]; then
|
|
194
|
+
rmdir "$CACHE/${ID}.lock" 2>/dev/null || true
|
|
195
|
+
mkdir "$CACHE/${ID}.lock" 2>/dev/null || exit 0
|
|
196
|
+
else
|
|
197
|
+
exit 0
|
|
198
|
+
fi
|
|
199
|
+
fi
|
|
200
|
+
|
|
201
|
+
# Back up the original (preserve trailing newline status)
|
|
202
|
+
cp -p "$FILE_PATH" "$CACHE/${ID}.bak" 2>/dev/null || cp "$FILE_PATH" "$CACHE/${ID}.bak"
|
|
203
|
+
printf '%s' "$FILE_PATH" > "$CACHE/${ID}.path"
|
|
204
|
+
|
|
205
|
+
# Filter in-place (cat > preserves inode and permissions)
|
|
206
|
+
FILTERED="$CACHE/${ID}.$$.tmp"
|
|
207
|
+
rm -f "$FILTERED"
|
|
208
|
+
if filter_file "$FILE_PATH" "$FILTERED" "$ID"; then
|
|
209
|
+
cat "$FILTERED" > "$FILE_PATH"
|
|
210
|
+
rm -f "$FILTERED"
|
|
211
|
+
else
|
|
212
|
+
rm -f "$FILTERED" "$CACHE/${ID}.bak" "$CACHE/${ID}.path"
|
|
213
|
+
rmdir "$CACHE/${ID}.lock" 2>/dev/null
|
|
214
|
+
fi
|
|
215
|
+
exit 0
|
|
216
|
+
fi
|
|
217
|
+
|
|
218
|
+
# ── PostToolUse Edit|Write: expand, then re-filter ────────────────────────────
|
|
219
|
+
if [ "$TOOL_NAME" = "Edit" ] || [ "$TOOL_NAME" = "Write" ]; then
|
|
220
|
+
ID=$(file_id "$FILE_PATH")
|
|
221
|
+
[ -f "$CACHE/${ID}.bak" ] || exit 0
|
|
222
|
+
ls "$CACHE/${ID}".block.* >/dev/null 2>&1 || exit 0
|
|
223
|
+
|
|
224
|
+
# Expand placeholders, preserving any inline code the model added around them
|
|
225
|
+
EXPANDED="$CACHE/${ID}.$$.expanded"
|
|
226
|
+
rm -f "$EXPANDED"
|
|
227
|
+
while IFS= read -r line || [ -n "$line" ]; do
|
|
228
|
+
case "$line" in *BLOCK_*)
|
|
229
|
+
# Expand all placeholders on this line (supports multiple per line)
|
|
230
|
+
for bf in "$CACHE/${ID}".block.*; do
|
|
231
|
+
[ -f "$bf" ] || continue
|
|
232
|
+
h="${bf##*.}"
|
|
233
|
+
case "$line" in *"BLOCK_${h}"*)
|
|
234
|
+
# Reconstruct the exact placeholder pattern
|
|
235
|
+
bp=""; bs=""; br=""
|
|
236
|
+
[ -f "$CACHE/${ID}.prefix.${h}" ] && bp=$(cat "$CACHE/${ID}.prefix.${h}")
|
|
237
|
+
[ -f "$CACHE/${ID}.suffix.${h}" ] && bs=$(cat "$CACHE/${ID}.suffix.${h}")
|
|
238
|
+
[ -f "$CACHE/${ID}.reason.${h}" ] && br=$(cat "$CACHE/${ID}.reason.${h}")
|
|
239
|
+
if [ -n "$br" ]; then
|
|
240
|
+
placeholder="${bp}BLOCK_${h}: ${br}${bs}"
|
|
241
|
+
else
|
|
242
|
+
placeholder="${bp}BLOCK_${h}${bs}"
|
|
243
|
+
fi
|
|
244
|
+
block_content=$(cat "$bf"; printf x); block_content="${block_content%x}"
|
|
245
|
+
# Escape glob metacharacters (* ? [ \) in the pattern
|
|
246
|
+
esc_placeholder=$(escape_glob "$placeholder")
|
|
247
|
+
# Bash native substitution (// = global replace): replace placeholder, keep surrounding code
|
|
248
|
+
line="${line//$esc_placeholder/$block_content}"
|
|
249
|
+
# Fallback: if model altered the reason text, try without reason
|
|
250
|
+
# (only trigger if BLOCK_hash is still present AND wasn't in the original block content)
|
|
251
|
+
case "$block_content" in *"BLOCK_${h}"*) ;; *)
|
|
252
|
+
case "$line" in *"BLOCK_${h}"*)
|
|
253
|
+
printf 'Warning: placeholder BLOCK_%s was modified by model, using fuzzy match\n' "$h" >&2
|
|
254
|
+
esc_fuzzy=$(escape_glob "${bp}BLOCK_${h}${bs}")
|
|
255
|
+
line="${line//$esc_fuzzy/$block_content}"
|
|
256
|
+
# Last resort: match just the hash token
|
|
257
|
+
case "$line" in *"BLOCK_${h}"*)
|
|
258
|
+
line="${line//BLOCK_${h}/$block_content}"
|
|
259
|
+
;; esac
|
|
260
|
+
;; esac
|
|
261
|
+
;; esac
|
|
262
|
+
;; esac
|
|
263
|
+
done
|
|
264
|
+
;; esac
|
|
265
|
+
printf '%s\n' "$line" >> "$EXPANDED"
|
|
266
|
+
done < "$FILE_PATH"
|
|
267
|
+
# Preserve trailing newline status
|
|
268
|
+
if [ -s "$EXPANDED" ] && [ -s "$FILE_PATH" ] && [ -n "$(tail -c 1 "$FILE_PATH")" ]; then
|
|
269
|
+
perl -pe 'chomp if eof' "$EXPANDED" > "${EXPANDED}.nnl" && \
|
|
270
|
+
cat "${EXPANDED}.nnl" > "$EXPANDED" && rm -f "${EXPANDED}.nnl"
|
|
271
|
+
fi
|
|
272
|
+
# Warn if model deleted a protected block entirely
|
|
273
|
+
for bf in "$CACHE/${ID}".block.*; do
|
|
274
|
+
[ -f "$bf" ] || continue
|
|
275
|
+
bh="${bf##*.}"
|
|
276
|
+
# After expansion, blocks appear as original code (simplify-ignore-start).
|
|
277
|
+
# If neither the expanded code nor the placeholder is in EXPANDED, it was deleted.
|
|
278
|
+
if ! grep -qF "BLOCK_${bh}" "$EXPANDED" 2>/dev/null; then
|
|
279
|
+
# Get first line of block to check if it was expanded back
|
|
280
|
+
first_line=$(head -1 "$bf")
|
|
281
|
+
if ! grep -qF "$first_line" "$EXPANDED" 2>/dev/null; then
|
|
282
|
+
printf 'Warning: protected block BLOCK_%s was deleted by model\n' "$bh" >&2
|
|
283
|
+
fi
|
|
284
|
+
fi
|
|
285
|
+
done
|
|
286
|
+
# Preserve inode and permissions
|
|
287
|
+
cat "$EXPANDED" > "$FILE_PATH"
|
|
288
|
+
rm -f "$EXPANDED"
|
|
289
|
+
|
|
290
|
+
# Save expanded version as new backup (this is the "real" file with model's changes)
|
|
291
|
+
cp "$FILE_PATH" "$CACHE/${ID}.bak"
|
|
292
|
+
|
|
293
|
+
# Re-filter in-place so the file on disk stays with placeholders
|
|
294
|
+
FILTERED="$CACHE/${ID}.$$.tmp"
|
|
295
|
+
rm -f "$FILTERED"
|
|
296
|
+
if filter_file "$FILE_PATH" "$FILTERED" "$ID"; then
|
|
297
|
+
cat "$FILTERED" > "$FILE_PATH"
|
|
298
|
+
rm -f "$FILTERED"
|
|
299
|
+
fi
|
|
300
|
+
|
|
301
|
+
exit 0
|
|
302
|
+
fi
|