@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,372 @@
|
|
|
1
|
+
// scripts/coms-cli.ts
|
|
2
|
+
//
|
|
3
|
+
// Envelope-protocol CLI: lets a NON-pi process (a plain shell, Claude Code
|
|
4
|
+
// via the peer-coms skill) participate in the coms pool. Speaks the exact
|
|
5
|
+
// coms wire protocol (scripts/lib/coms-envelope.ts) over the existing
|
|
6
|
+
// registry + unix sockets.
|
|
7
|
+
//
|
|
8
|
+
// list — live peers in scope (name, model, purpose)
|
|
9
|
+
// send <peer> <prompt> — send a prompt; prints the msg_id and returns
|
|
10
|
+
// (a detached waiter holds the reply socket);
|
|
11
|
+
// --await blocks and prints the reply instead
|
|
12
|
+
// await <msg_id> — block until the reply for msg_id arrives
|
|
13
|
+
// reply <msg_id> <text> — answer an inbound prompt (bridge/hook use)
|
|
14
|
+
//
|
|
15
|
+
// Identity: each invocation acts as peer `--name` (default "claude-cli"),
|
|
16
|
+
// registered EXPLICIT — visible to nobody's pool widget, addressable only by
|
|
17
|
+
// exact name — and read-only toward the registry except its own entry.
|
|
18
|
+
//
|
|
19
|
+
// usage: coms-cli <list|send|await|reply> [args] [--project <p>] [--name <me>]
|
|
20
|
+
// [--await] [--timeout <ms>] [--all]
|
|
21
|
+
|
|
22
|
+
import { spawn } from "node:child_process";
|
|
23
|
+
import * as fs from "node:fs";
|
|
24
|
+
import * as path from "node:path";
|
|
25
|
+
import { fileURLToPath } from "node:url";
|
|
26
|
+
|
|
27
|
+
import {
|
|
28
|
+
bindEndpoint,
|
|
29
|
+
COMS_DIR,
|
|
30
|
+
ensureComsDirs,
|
|
31
|
+
isPromptEnvelope,
|
|
32
|
+
isResponseEnvelope,
|
|
33
|
+
makeConnHandler,
|
|
34
|
+
makeEndpoint,
|
|
35
|
+
makePromptEnvelope,
|
|
36
|
+
makeResponseEnvelope,
|
|
37
|
+
nowIso,
|
|
38
|
+
pruneDeadEntries,
|
|
39
|
+
removeRegistryEntry,
|
|
40
|
+
sendEnvelope,
|
|
41
|
+
ulid,
|
|
42
|
+
writeAck,
|
|
43
|
+
writeNack,
|
|
44
|
+
writeRegistryAtomic,
|
|
45
|
+
type RegistryEntry,
|
|
46
|
+
type SenderIdentity,
|
|
47
|
+
} from "./lib/coms-envelope.ts";
|
|
48
|
+
|
|
49
|
+
const DEFAULT_NAME = process.env.COMS_CLI_NAME || "claude-cli";
|
|
50
|
+
const DEFAULT_AWAIT_MS = 300_000;
|
|
51
|
+
|
|
52
|
+
function flagValue(argv: string[], flag: string): string | null {
|
|
53
|
+
const i = argv.indexOf(flag);
|
|
54
|
+
return i >= 0 && i + 1 < argv.length ? argv[i + 1] : null;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
function die(msg: string): never {
|
|
58
|
+
console.error(msg);
|
|
59
|
+
process.exit(1);
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
function spoolDir(name: string): string {
|
|
63
|
+
return path.join(COMS_DIR, "cli", name);
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
function ensureSpool(name: string): { pending: string; responses: string; inbound: string } {
|
|
67
|
+
const base = spoolDir(name);
|
|
68
|
+
const dirs = {
|
|
69
|
+
pending: path.join(base, "pending"),
|
|
70
|
+
responses: path.join(base, "responses"),
|
|
71
|
+
inbound: path.join(base, "inbound"),
|
|
72
|
+
};
|
|
73
|
+
for (const d of Object.values(dirs)) fs.mkdirSync(d, { recursive: true });
|
|
74
|
+
return dirs;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
interface Scope {
|
|
78
|
+
project: string;
|
|
79
|
+
includeExplicit: boolean;
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
function scopeFrom(argv: string[]): Scope {
|
|
83
|
+
return { project: flagValue(argv, "--project") ?? "default", includeExplicit: argv.includes("--all") };
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
function peersInScope(scope: Scope, selfName: string): RegistryEntry[] {
|
|
87
|
+
return pruneDeadEntries(scope.project).filter(
|
|
88
|
+
(e) => e.name !== selfName && (scope.includeExplicit || !e.explicit),
|
|
89
|
+
);
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
function makeIdentity(name: string, sessionId: string): SenderIdentity {
|
|
93
|
+
return { session_id: sessionId, name, endpoint: makeEndpoint(sessionId), cwd: process.cwd() };
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
function registerCliEntry(id: SenderIdentity, project: string, purpose: string): void {
|
|
97
|
+
const entry: RegistryEntry = {
|
|
98
|
+
session_id: id.session_id,
|
|
99
|
+
name: id.name,
|
|
100
|
+
purpose,
|
|
101
|
+
model: "cli",
|
|
102
|
+
color: "#FEDE5D",
|
|
103
|
+
pid: process.pid,
|
|
104
|
+
endpoint: id.endpoint,
|
|
105
|
+
cwd: id.cwd,
|
|
106
|
+
started_at: nowIso(),
|
|
107
|
+
explicit: true,
|
|
108
|
+
version: 1,
|
|
109
|
+
};
|
|
110
|
+
writeRegistryAtomic(entry, project);
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
// ━━ list ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
114
|
+
|
|
115
|
+
function cmdList(argv: string[]): void {
|
|
116
|
+
const scope = scopeFrom(argv);
|
|
117
|
+
const name = flagValue(argv, "--name") ?? DEFAULT_NAME;
|
|
118
|
+
const peers = peersInScope(scope, name);
|
|
119
|
+
if (peers.length === 0) {
|
|
120
|
+
console.log(`(no live peers in project "${scope.project}")`);
|
|
121
|
+
return;
|
|
122
|
+
}
|
|
123
|
+
for (const p of peers) {
|
|
124
|
+
console.log(`${p.name}\t${p.model}\t${p.purpose}`);
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
// ━━ send ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
129
|
+
|
|
130
|
+
async function cmdSend(argv: string[]): Promise<void> {
|
|
131
|
+
const positional = argv.filter((a, i) => !a.startsWith("--") && (i === 0 || !argv[i - 1].startsWith("--")));
|
|
132
|
+
const [target, ...promptParts] = positional;
|
|
133
|
+
const prompt = promptParts.join(" ");
|
|
134
|
+
if (!target || !prompt) die("usage: coms-cli send <peer> <prompt…> [--await] [--timeout <ms>]");
|
|
135
|
+
|
|
136
|
+
const scope = scopeFrom(argv);
|
|
137
|
+
const name = flagValue(argv, "--name") ?? DEFAULT_NAME;
|
|
138
|
+
const timeoutMs = Number(flagValue(argv, "--timeout") ?? DEFAULT_AWAIT_MS);
|
|
139
|
+
const doAwait = argv.includes("--await");
|
|
140
|
+
|
|
141
|
+
const peer = peersInScope(scope, name).find((e) => e.name === target)
|
|
142
|
+
?? pruneDeadEntries(scope.project).find((e) => e.name === target && e.name !== name);
|
|
143
|
+
if (!peer) {
|
|
144
|
+
const names = peersInScope(scope, name).map((e) => e.name).join(", ") || "(none)";
|
|
145
|
+
die(`Peer "${target}" not found in project "${scope.project}". Live peers: ${names}`);
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
ensureComsDirs(scope.project);
|
|
149
|
+
const spool = ensureSpool(name);
|
|
150
|
+
|
|
151
|
+
if (doAwait) {
|
|
152
|
+
// One process does the whole round trip: bind → register → send → wait.
|
|
153
|
+
const id = makeIdentity(name, ulid());
|
|
154
|
+
let done: (v: { response: unknown; error?: string | null }) => void;
|
|
155
|
+
const reply = new Promise<{ response: unknown; error?: string | null }>((res) => (done = res));
|
|
156
|
+
const server = await bindEndpoint(
|
|
157
|
+
id.endpoint,
|
|
158
|
+
makeConnHandler((env, socket) => {
|
|
159
|
+
if (isResponseEnvelope(env)) {
|
|
160
|
+
writeAck(socket, env.msg_id);
|
|
161
|
+
done({ response: env.response, error: env.error ?? null });
|
|
162
|
+
} else if ((env as { type?: string }).type === "ping") {
|
|
163
|
+
writeAck(socket, (env as { msg_id?: string }).msg_id ?? "");
|
|
164
|
+
} else {
|
|
165
|
+
writeNack(socket, (env as { msg_id?: string }).msg_id ?? "", "cli awaits responses only");
|
|
166
|
+
}
|
|
167
|
+
}),
|
|
168
|
+
);
|
|
169
|
+
registerCliEntry(id, scope.project, `coms-cli (one-shot ask from ${name})`);
|
|
170
|
+
const cleanup = () => {
|
|
171
|
+
try { server.close(); } catch { /* ignore */ }
|
|
172
|
+
try { fs.unlinkSync(id.endpoint); } catch { /* ignore */ }
|
|
173
|
+
removeRegistryEntry(scope.project, id.name);
|
|
174
|
+
};
|
|
175
|
+
try {
|
|
176
|
+
const env = makePromptEnvelope(id, prompt);
|
|
177
|
+
await sendEnvelope(peer.endpoint, env);
|
|
178
|
+
console.error(`sent ${env.msg_id} → ${peer.name} (awaiting reply, timeout ${timeoutMs}ms)`);
|
|
179
|
+
const result = await Promise.race([
|
|
180
|
+
reply,
|
|
181
|
+
new Promise<never>((_r, rej) => setTimeout(() => rej(new Error(`timeout after ${timeoutMs}ms`)), timeoutMs)),
|
|
182
|
+
]);
|
|
183
|
+
if (result.error) die(`peer error: ${result.error}`);
|
|
184
|
+
console.log(typeof result.response === "string" ? result.response : JSON.stringify(result.response, null, 2));
|
|
185
|
+
} finally {
|
|
186
|
+
cleanup();
|
|
187
|
+
}
|
|
188
|
+
return;
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
// Detached mode: a waiter child owns the reply socket + registry entry;
|
|
192
|
+
// this process sends, prints the msg_id, and exits.
|
|
193
|
+
const sessionId = ulid();
|
|
194
|
+
const endpoint = makeEndpoint(sessionId);
|
|
195
|
+
const child = spawn(
|
|
196
|
+
process.execPath,
|
|
197
|
+
[
|
|
198
|
+
fileURLToPath(import.meta.url),
|
|
199
|
+
"_listen",
|
|
200
|
+
"--name", name,
|
|
201
|
+
"--project", scope.project,
|
|
202
|
+
"--session", sessionId,
|
|
203
|
+
"--ttl", String(timeoutMs),
|
|
204
|
+
],
|
|
205
|
+
{ detached: true, stdio: ["ignore", "pipe", "ignore"] },
|
|
206
|
+
);
|
|
207
|
+
await new Promise<void>((resolve, reject) => {
|
|
208
|
+
const t = setTimeout(() => reject(new Error("waiter did not become ready")), 5000);
|
|
209
|
+
child.stdout!.on("data", (d) => {
|
|
210
|
+
if (d.toString().includes("READY")) {
|
|
211
|
+
clearTimeout(t);
|
|
212
|
+
resolve();
|
|
213
|
+
}
|
|
214
|
+
});
|
|
215
|
+
child.on("exit", () => reject(new Error("waiter exited early")));
|
|
216
|
+
});
|
|
217
|
+
child.unref();
|
|
218
|
+
child.stdout!.destroy();
|
|
219
|
+
|
|
220
|
+
const id: SenderIdentity = { session_id: sessionId, name, endpoint, cwd: process.cwd() };
|
|
221
|
+
const env = makePromptEnvelope(id, prompt);
|
|
222
|
+
fs.writeFileSync(
|
|
223
|
+
path.join(spool.pending, `${env.msg_id}.json`),
|
|
224
|
+
JSON.stringify({ msg_id: env.msg_id, target: peer.name, sent_at: nowIso() }),
|
|
225
|
+
);
|
|
226
|
+
try {
|
|
227
|
+
await sendEnvelope(peer.endpoint, env);
|
|
228
|
+
} catch (err) {
|
|
229
|
+
try { fs.unlinkSync(path.join(spool.pending, `${env.msg_id}.json`)); } catch { /* ignore */ }
|
|
230
|
+
try { if (child.pid) process.kill(-child.pid, "SIGTERM"); } catch { /* ignore */ }
|
|
231
|
+
die(`send failed: ${err instanceof Error ? err.message : String(err)}`);
|
|
232
|
+
}
|
|
233
|
+
console.log(env.msg_id);
|
|
234
|
+
}
|
|
235
|
+
|
|
236
|
+
// ━━ _listen (internal detached waiter) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
237
|
+
|
|
238
|
+
async function cmdListen(argv: string[]): Promise<void> {
|
|
239
|
+
const name = flagValue(argv, "--name") ?? DEFAULT_NAME;
|
|
240
|
+
const project = flagValue(argv, "--project") ?? "default";
|
|
241
|
+
const sessionId = flagValue(argv, "--session") ?? ulid();
|
|
242
|
+
const ttl = Number(flagValue(argv, "--ttl") ?? DEFAULT_AWAIT_MS);
|
|
243
|
+
const id = makeIdentity(name, sessionId);
|
|
244
|
+
const spool = ensureSpool(name);
|
|
245
|
+
ensureComsDirs(project);
|
|
246
|
+
|
|
247
|
+
const server = await bindEndpoint(
|
|
248
|
+
id.endpoint,
|
|
249
|
+
makeConnHandler((env, socket) => {
|
|
250
|
+
if (isResponseEnvelope(env)) {
|
|
251
|
+
writeAck(socket, env.msg_id);
|
|
252
|
+
fs.writeFileSync(
|
|
253
|
+
path.join(spool.responses, `${env.msg_id}.json`),
|
|
254
|
+
JSON.stringify({ response: env.response, error: env.error ?? null, received_at: nowIso() }),
|
|
255
|
+
);
|
|
256
|
+
try { fs.unlinkSync(path.join(spool.pending, `${env.msg_id}.json`)); } catch { /* ignore */ }
|
|
257
|
+
maybeExit();
|
|
258
|
+
} else if (isPromptEnvelope(env)) {
|
|
259
|
+
// Bidirectionality bonus: inbound prompts spool for a human /
|
|
260
|
+
// hook to answer via `coms-cli reply <msg_id> …`.
|
|
261
|
+
writeAck(socket, env.msg_id);
|
|
262
|
+
fs.writeFileSync(
|
|
263
|
+
path.join(spool.inbound, `${env.msg_id}.json`),
|
|
264
|
+
JSON.stringify({
|
|
265
|
+
msg_id: env.msg_id,
|
|
266
|
+
prompt: env.prompt,
|
|
267
|
+
sender_name: env.sender_name,
|
|
268
|
+
sender_endpoint: env.sender_endpoint,
|
|
269
|
+
sender_session: env.sender_session,
|
|
270
|
+
hops: env.hops,
|
|
271
|
+
received_at: nowIso(),
|
|
272
|
+
}),
|
|
273
|
+
);
|
|
274
|
+
} else if ((env as { type?: string }).type === "ping") {
|
|
275
|
+
writeAck(socket, (env as { msg_id?: string }).msg_id ?? "");
|
|
276
|
+
} else {
|
|
277
|
+
writeNack(socket, (env as { msg_id?: string }).msg_id ?? "", "unsupported envelope");
|
|
278
|
+
}
|
|
279
|
+
}),
|
|
280
|
+
);
|
|
281
|
+
registerCliEntry(id, project, "coms-cli reply waiter");
|
|
282
|
+
console.log("READY");
|
|
283
|
+
|
|
284
|
+
const cleanup = () => {
|
|
285
|
+
try { server.close(); } catch { /* ignore */ }
|
|
286
|
+
try { fs.unlinkSync(id.endpoint); } catch { /* ignore */ }
|
|
287
|
+
removeRegistryEntry(project, id.name);
|
|
288
|
+
process.exit(0);
|
|
289
|
+
};
|
|
290
|
+
// Exit when no pending markers remain (grace period lets the sender write
|
|
291
|
+
// the first marker after READY).
|
|
292
|
+
const startedAt = Date.now();
|
|
293
|
+
function maybeExit(): void {
|
|
294
|
+
try {
|
|
295
|
+
const pendingLeft = fs.readdirSync(spool.pending).length;
|
|
296
|
+
if (pendingLeft === 0 && Date.now() - startedAt > 3000) cleanup();
|
|
297
|
+
} catch {
|
|
298
|
+
// ignore
|
|
299
|
+
}
|
|
300
|
+
}
|
|
301
|
+
setInterval(maybeExit, 5000);
|
|
302
|
+
setTimeout(cleanup, ttl); // TTL fallback
|
|
303
|
+
process.on("SIGTERM", cleanup);
|
|
304
|
+
process.on("SIGINT", cleanup);
|
|
305
|
+
}
|
|
306
|
+
|
|
307
|
+
// ━━ await ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
308
|
+
|
|
309
|
+
async function cmdAwait(argv: string[]): Promise<void> {
|
|
310
|
+
const msgId = argv.find((a) => !a.startsWith("--"));
|
|
311
|
+
if (!msgId) die("usage: coms-cli await <msg_id> [--timeout <ms>]");
|
|
312
|
+
const name = flagValue(argv, "--name") ?? DEFAULT_NAME;
|
|
313
|
+
const timeoutMs = Number(flagValue(argv, "--timeout") ?? DEFAULT_AWAIT_MS);
|
|
314
|
+
const spool = ensureSpool(name);
|
|
315
|
+
const file = path.join(spool.responses, `${msgId}.json`);
|
|
316
|
+
const deadline = Date.now() + timeoutMs;
|
|
317
|
+
while (Date.now() < deadline) {
|
|
318
|
+
if (fs.existsSync(file)) {
|
|
319
|
+
const rec = JSON.parse(fs.readFileSync(file, "utf-8"));
|
|
320
|
+
if (rec.error) die(`peer error: ${rec.error}`);
|
|
321
|
+
console.log(typeof rec.response === "string" ? rec.response : JSON.stringify(rec.response, null, 2));
|
|
322
|
+
return;
|
|
323
|
+
}
|
|
324
|
+
await new Promise((r) => setTimeout(r, 500));
|
|
325
|
+
}
|
|
326
|
+
die(`timeout: no reply for ${msgId} after ${timeoutMs}ms`);
|
|
327
|
+
}
|
|
328
|
+
|
|
329
|
+
// ━━ reply ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
330
|
+
|
|
331
|
+
async function cmdReply(argv: string[]): Promise<void> {
|
|
332
|
+
const positional = argv.filter((a, i) => !a.startsWith("--") && (i === 0 || !argv[i - 1].startsWith("--")));
|
|
333
|
+
const [msgId, ...textParts] = positional;
|
|
334
|
+
let text = textParts.join(" ");
|
|
335
|
+
if (!text && !process.stdin.isTTY) {
|
|
336
|
+
text = fs.readFileSync(0, "utf-8").trim();
|
|
337
|
+
}
|
|
338
|
+
if (!msgId || !text) die("usage: coms-cli reply <msg_id> <text…> (or pipe the text on stdin)");
|
|
339
|
+
const name = flagValue(argv, "--name") ?? DEFAULT_NAME;
|
|
340
|
+
const spool = ensureSpool(name);
|
|
341
|
+
const recFile = path.join(spool.inbound, `${msgId}.json`);
|
|
342
|
+
if (!fs.existsSync(recFile)) die(`No inbound prompt ${msgId} in ${spool.inbound}`);
|
|
343
|
+
const rec = JSON.parse(fs.readFileSync(recFile, "utf-8"));
|
|
344
|
+
const id = makeIdentity(name, ulid());
|
|
345
|
+
await sendEnvelope(rec.sender_endpoint, makeResponseEnvelope(id, msgId, text));
|
|
346
|
+
fs.unlinkSync(recFile);
|
|
347
|
+
console.log(`replied to ${rec.sender_name ?? rec.sender_session} (${msgId})`);
|
|
348
|
+
}
|
|
349
|
+
|
|
350
|
+
// ━━ main ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
351
|
+
|
|
352
|
+
async function main(): Promise<void> {
|
|
353
|
+
const [cmd, ...rest] = process.argv.slice(2);
|
|
354
|
+
switch (cmd) {
|
|
355
|
+
case "list":
|
|
356
|
+
return cmdList(rest);
|
|
357
|
+
case "send":
|
|
358
|
+
return cmdSend(rest);
|
|
359
|
+
case "await":
|
|
360
|
+
return cmdAwait(rest);
|
|
361
|
+
case "reply":
|
|
362
|
+
return cmdReply(rest);
|
|
363
|
+
case "_listen":
|
|
364
|
+
return cmdListen(rest);
|
|
365
|
+
default:
|
|
366
|
+
console.error("usage: coms-cli <list|send|await|reply> …");
|
|
367
|
+
process.exit(2);
|
|
368
|
+
}
|
|
369
|
+
}
|
|
370
|
+
|
|
371
|
+
const isEntry = process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
|
|
372
|
+
if (isEntry) void main();
|