README.md

sightjack docs

Architecture

• conformance.md — What/Why/How conformance table (single source)

• siren-directory.md — .siren/ directory structure specification

• self-improvement-loop.md — How sightjack participates in the observable self-improvement loop

• policies.md — Event → Policy mapping (WHEN event THEN command)

• otel-backends.md — OpenTelemetry backend configuration (Jaeger, Weave)

• Claude subprocess isolation: mcp-config generate creates .mcp.json (MCP allowlist) and .claude/settings.json (plugin isolation); --setting-sources "" + --settings + --strict-mcp-config enforces it

• Claude log persistence: raw NDJSON saved to .run/claude-logs/ after each invocation

• dmail-protocol-conventions.md — D-Mail filename uniqueness and archive retention conventions

• testing.md — Test strategy, conventions, scenario test observers, wave lifecycle guards, and error fingerprinting

CLI Reference

• sightjack — Root command
• sightjack init — Create .siren/config.yaml
• sightjack config — View or update configuration
• sightjack config show — Show current configuration
• sightjack config set — Update configuration values
• sightjack scan — Classify and deep-scan Linear issues
• sightjack run — Interactive wave approval and apply loop
• sightjack waves — Generate waves from stdin ScanResult JSON
• sightjack show — Display last scan results
• sightjack select — Interactively pick a wave from stdin WavePlan
• sightjack discuss — Architect discussion from stdin Wave JSON
• sightjack apply — Apply a wave to Linear from stdin Wave JSON
• sightjack adr — Generate ADR Markdown from stdin DiscussResult
• sightjack nextgen — Generate follow-up waves from stdin ApplyResult
• sightjack status — Show operational status
• sightjack doctor — Check environment and tool availability
• sightjack clean — Remove state directory (.siren/)
• sightjack archive-prune — Prune expired d-mails and event files
• sightjack version — Print version, commit, and build information
• sightjack update — Self-update sightjack to the latest release

Architecture Decision Records

• adr/ — Tool-specific ADRs
• shared-adr/ — Cross-tool shared ADRs (S0001–S0035)