This is a public, read-only report. Striff reads this repository's docs, turns each sentence that makes a claim about the code into a rule, and checks the rule against the code on the default branch. How this works
The CLI has protected bootstrap files that must use ONLY Node.js built-in modules (node:fs, node:path, node:child_process, node:util).
5 rules from this sentence
packages/squad-cli/src/cli/core/detect-squad-dir.ts may only import node:fs, node:path, node:child_process and node:util
Holds
packages/squad-cli/src/cli/core/errors.ts may only import node:fs, node:path, node:child_process and node:util
Holds
packages/squad-cli/src/cli/core/gh-cli.ts may only import node:fs, node:path, node:child_process and node:util
Holds
packages/squad-cli/src/cli/core/output.ts may only import node:fs, node:path, node:child_process and node:util
Holds
packages/squad-cli/src/cli/core/history-split.ts may only import node:fs, node:path, node:child_process and node:util
Holds
❌ NEVER add import or require statements referencing packages outside node:* built-ins
5 rules from this sentence
packages/squad-cli/src/cli/core/detect-squad-dir.ts may only import node:*
Holds
packages/squad-cli/src/cli/core/errors.ts may only import node:*
Holds
packages/squad-cli/src/cli/core/gh-cli.ts may only import node:*
Holds
packages/squad-cli/src/cli/core/output.ts may only import node:*
Holds
packages/squad-cli/src/cli/core/history-split.ts may only import node:*
Holds
Adding import { X } from '@bradygaster/squad-sdk' to a bootstrap file
5 rules from this sentence
packages/squad-cli/src/cli/core/detect-squad-dir.ts may not import @bradygaster/squad-sdk
Holds
packages/squad-cli/src/cli/core/errors.ts may not import @bradygaster/squad-sdk
Holds
packages/squad-cli/src/cli/core/gh-cli.ts may not import @bradygaster/squad-sdk
Holds
packages/squad-cli/src/cli/core/output.ts may not import @bradygaster/squad-sdk
Holds
packages/squad-cli/src/cli/core/history-split.ts may not import @bradygaster/squad-sdk
Holds
We use a TypeScript interface (PlatformAdapter) rather than an abstract class.
PlatformAdapter is a contract
Holds
The harness supplies ApprovalRequest.hash when it raises an approval;
ApprovalRequest has hash
Holds
mergeMcpServer and applyProjection in packages/squad-sdk/src/client/adapters/.
2 rules from this sentence
mergeMcpServer is in packages/squad-sdk/src/client/adapters
checks “mergeMcpServer”
Holds
applyProjection is in packages/squad-sdk/src/client/adapters
checks “applyProjection in packages/squad-sdk/src/client/adapters/”
Holds
An approval record is { approvalId, version, scope, action, hash, payload?, state, runId, requestedAt, decidedAt?, decision?, reason? }.
12 rules from this sentence
ApprovalRecord has approvalId, version, scope and 9 more
Holdsall 12
The Git provider is GitRefClaimProvider in ralph/claims-git.ts, with an injectable GitTransport and clock.
GitRefClaimProvider depends on GitTransport
Holds
Resource POST /v1/conversations, SquadBackend method createConversation (idempotent per conversationId ), Canonical shape BackendConversation
SquadBackend has a createConversation method
Holds
Resource POST /v1/capabilities, SquadBackend method negotiate, Canonical shape NegotiatedCapabilities
SquadBackend has a negotiate method
Holds
Resource POST /v1/conversations/{id}/messages, SquadBackend method sendMessage (idempotent per (runId, seq) ), Canonical shape BackendMessage → BackendAdmission
SquadBackend has a sendMessage method
Holds
Resource GET /v1/conversations/{id}/transcript, SquadBackend method getTranscript, Canonical shape BackendMessage[]
SquadBackend has a getTranscript method
Holds
Resource GET /v1/conversations/{id}/events?after=&limit=&stream=, SquadBackend method readEvents, Canonical shape BackendEventPage of BackendEnvelope
SquadBackend has a readEvents method
Holds
Resource GET /v1/conversations/{id}/turns/{seq}, SquadBackend method getTurn, Canonical shape BackendTurn
SquadBackend has a getTurn method
Holds
Resource POST /v1/conversations/{id}/turns/{seq}/cancel, SquadBackend method cancelTurn, Canonical shape BackendTurn
SquadBackend has a cancelTurn method
Holds
Resource POST /v1/conversations/{id}/runs/{runId}/cancel, SquadBackend method cancelRun (stable run identity), Canonical shape BackendTurn
SquadBackend has a cancelRun method
Holds
Resource GET /v1/conversations/{id}/approvals, SquadBackend method getApprovals, Canonical shape ApprovalRecord[]
SquadBackend has a getApprovals method
Holds
Resource POST /v1/conversations/{id}/approvals/{approvalId}, SquadBackend method respondApproval (echoes the request hash ), Canonical shape ApprovalResponse → BackendTurn
SquadBackend has a respondApproval method
Holds
Resource GET /health/live , GET /health/ready, SquadBackend method health, Canonical shape operational, outside /v1
SquadBackend has a health method
Holds
Task state is only visible through BackendTurn.tasks as reported by a harness.
BackendTurn has tasks
Holds
approvalId, turnSeq, runId and a scope (turn by default);
4 rules from this sentence
ApprovalRecord has approvalId
checks “approvalId”
Holds
ApprovalRecord has turnSeq
checks “turnSeq”
Holds
ApprovalRecord has runId
checks “runId”
Holds
ApprovalRecord has scope
checks “a scope”
Holds
version (1 while pending, 2 once decided or cancelled) and state (pending, approved, denied, cancelled);
2 rules from this sentence
ApprovalRecord has version
checks “version”
Holds
ApprovalRecord has state
checks “state”
Holds
hash, an opaque string supplied by the harness together with the request;
ApprovalRecord has hash
Holds
requestedAt and, after the decision, decidedAt, decision and reason.
4 rules from this sentence
ApprovalRecord has requestedAt
checks “requestedAt”
Holds
ApprovalRecord has decidedAt
checks “decidedAt”
Holds
ApprovalRecord has decision
Holds
ApprovalRecord has reason
checks “reason”
Holds
A conversation carries one integer epoch (initially 1).
BackendConversation has epoch
Holds
Adapter HostProjection, Plane boundary workspace projection only, Responsibility writes, updates, and removes host-owned files without runtime or backend dependencies
2 rules from this sentence
HostProjection may not depend on packages/squad-sdk/src/runtime
Holdsclient → runtime
HostProjection may not depend on packages/squad-sdk/src/backend
Holdsclient → backend
The HarnessAdapter SPI is defined in packages/squad-sdk/src/backend/types.ts and exported from @bradygaster/squad-sdk/backend; the broker (LocalSquadBackend) calls it through a HarnessRegistry.
LocalSquadBackend depends on HarnessAdapter
Holds
The HarnessAdapter SPI is defined in packages/squad-sdk/src/backend/types.ts and exported from @bradygaster/squad-sdk/backend;
HarnessAdapter is in packages/squad-sdk/src/backend
Holds
the broker (LocalSquadBackend) calls it through a HarnessRegistry.
LocalSquadBackend depends on HarnessRegistry
Holds
describe and projectWorkspace on ClientAdapter let the broker reason about host capabilities and file projection without special-casing each client in coordinator logic.
HostProjection is in packages/squad-sdk/src/client
checks “adapter-contract.ts owns HostProjection”
Holds
ClientAdapter is in packages/squad-sdk/src/client
checks “adapter-contract.ts owns”
Holds
backend --> harness
SquadBackend depends on HarnessAdapter
Holds
The execution plane is the experimental HarnessAdapter SPI in @bradygaster/squad-sdk/backend (submit, subscribe, cancel, respondApproval, describe, registered via DefaultHarnessRegistry).
6 rules from this sentence
DefaultHarnessRegistry depends on HarnessAdapter
Holds
HarnessAdapter has submit
Holds
HarnessAdapter has subscribe
Holds
HarnessAdapter has cancel
Holds
HarnessAdapter has respondApproval
Holds
HarnessAdapter has describe
Holds
StorageProvider is Squad's I/O contract.
StorageProvider is a contract
Holds
createIfAbsent is the only conditional operation: it must create the key atomically and only when absent, reject with StateKeyConflictError when the key already exists, and reject with StateBackendUncertaintyError when the outcome cannot be determined.
StorageProvider has a createIfAbsent method
Holds
it must create the key atomically and only when absent, reject with StateKeyConflictError when the key already exists, and reject with StateBackendUncertaintyError when the outcome cannot be determined.
2 rules from this sentence
StorageProvider depends on StateKeyConflictError
checks “reject with StateKeyConflictError when the key already exists”
Holds
StorageProvider depends on StateBackendUncertaintyError
checks “reject with StateBackendUncertaintyError when the outcome cannot be determined”
Holds
The full interface also includes 12 deprecated synchronous variants (readSync, writeSync, appendSync, existsSync, listSync, deleteSync, deleteDirSync, isDirectorySync, mkdirSync, renameSync, copySync, statSync) — 24 methods total.
12 rules from this sentence
StorageProvider has a readSync method
checks “readSync”
Holds
StorageProvider has a writeSync method
checks “writeSync”
Holds
StorageProvider has an appendSync method
checks “appendSync”
Holds
StorageProvider has an existsSync method
checks “existsSync”
Holds
StorageProvider has a listSync method
checks “listSync”
Holds
StorageProvider has a deleteSync method
checks “deleteSync”
Holds
StorageProvider has a deleteDirSync method
checks “deleteDirSync”
Holds
StorageProvider has an isDirectorySync method
checks “isDirectorySync”
Holds
StorageProvider has a mkdirSync method
checks “mkdirSync”
Holds
StorageProvider has a renameSync method
checks “renameSync”
Holds
StorageProvider has a copySync method
checks “copySync”
Holds
StorageProvider has a statSync method
checks “statSync”
Holds
defineSquad() validates every nested section through its respective builder — defineTeam(), defineAgent(), defineRouting(), defineDefaults().
4 rules from this sentence
defineSquad depends on defineTeam
Holds
defineSquad depends on defineAgent
Holds
defineSquad depends on defineRouting
Holds
defineSquad depends on defineDefaults
Holds
SquadClient wraps @github/copilot-sdk with lifecycle management and auto-reconnection:
SquadClient imports @github/copilot-sdk
Holds
Use SquadClientWithPool for production workloads — it composes SquadClient, SessionPool, and EventBus:
2 rules from this sentence
SquadClientWithPool depends on SquadClient
Holdsclient → adapter
SquadClientWithPool depends on SessionPool
Holds
HealthMonitor runs periodic connection checks returning HealthCheckResult with status (healthy | degraded | unhealthy) and response time.
HealthMonitor depends on HealthCheckResult
Holds
SquadClientWithPool adds capacity limits, session lifecycle management, and an eventBus for session and pool events.
SquadClientWithPool has eventBus
Holds
describe(), projectWorkspace() and getCapabilities() work locally;
3 rules from this sentence
ClientAdapter has a describe method
checks “describe()”
Holds
ClientAdapter has a projectWorkspace method
checks “projectWorkspace()”
Holds
ClientAdapter has a getCapabilities method
checks “getCapabilities()”
Holds
submit, subscribe, cancel and respondApproval delegate to a bound RuntimeBinding and otherwise throw AdapterUnboundError.
4 rules from this sentence
ClientAdapter has submit
checks “submit”
Holds
ClientAdapter has subscribe
checks “subscribe”
Holds
ClientAdapter has cancel
checks “cancel”
Holds
ClientAdapter has respondApproval
checks “respondApproval”
Holds
createClientAdapter({ host, ctx, runtime? }) returns the spec-level ClientAdapter facade: describe(), projectWorkspace() and getCapabilities() work locally;
createClientAdapter depends on ClientAdapter
Holds
Squad ships the SquadBackend / HarnessAdapter interfaces, the local file/state-store backend, and the outbound durable-http client — it does not bundle a remote DurableSquad server, and server-side DurableSquad Phase 2 integration (remote durable approvals and lease-epoch coordination) is pending.
2 rules from this sentence
SquadBackend is a contract
Holds
HarnessAdapter is a contract
Holds
createSquadBackend(options) builds a SquadBackend for kind: 'local', kind: 'mcp', or kind: 'durable-http'.
SquadBackend has negotiate, createConversation, sendMessage and 8 more
Holdsall 11
HarnessAdapter and DefaultHarnessRegistry let custom execution runtimes plug into the broker (submit, subscribe, cancel, respondApproval, describe), with validateExtensions() enforcing x-<harness>.* extension namespaces.
5 rules from this sentence
HarnessAdapter has submit
checks “HarnessAdapter and DefaultHarnessRegistry let custom execution runtimes plug into the broker (submit”
Holds
HarnessAdapter has subscribe
checks “HarnessAdapter and DefaultHarnessRegistry let custom execution runtimes plug into the broker (submit, subscribe”
Holds
HarnessAdapter has cancel
checks “HarnessAdapter and DefaultHarnessRegistry let custom execution runtimes plug into the broker (submit, subscribe, cancel”
Holds
HarnessAdapter has respondApproval
checks “HarnessAdapter and DefaultHarnessRegistry let custom execution runtimes plug into the broker (submit, subscribe, cancel, respondApproval”
Holds
HarnessAdapter has describe
checks “HarnessAdapter and DefaultHarnessRegistry let custom execution runtimes plug into the broker (submit, subscribe, cancel, respondApproval, describe”
Holds
Implement HarnessAdapter (submit, subscribe, cancel, respondApproval, describe) and register it with DefaultHarnessRegistry.
HarnessAdapter has submit, subscribe, cancel, respondApproval and describe
Holds
All persistent storage — sessions, state, decisions, histories — flows through a pluggable StorageProvider interface.