Go API

Package main wires the scafld command-line entrypoint to the CLI adapter.

github.com/nilstate/scafld/v2/cmd/scafld

Package cli is the scafld command line.

github.com/nilstate/scafld/v2/internal/adapters/cli

Package adapter renders deterministic provider-facing trigger packets.

github.com/nilstate/scafld/v2/internal/adapters/cli/adapter

Package agentcontract resolves source-backed role contracts for CLI commands.

github.com/nilstate/scafld/v2/internal/adapters/cli/agentcontract

Package config scans project files for CLI-driven config proposals.

github.com/nilstate/scafld/v2/internal/adapters/cli/config

Package fallback contains small error fallback helpers for CLI adapters.

github.com/nilstate/scafld/v2/internal/adapters/cli/fallback

Package finalize composes the scafld finalize CLI boundary.

github.com/nilstate/scafld/v2/internal/adapters/cli/finalize

Package finalizestdio serves finalize as an MCP tool over stdio, so an agent host can run the deterministic final gate through the scafld binary.

github.com/nilstate/scafld/v2/internal/adapters/cli/finalizestdio

Package harden builds the CLI-facing prompt context for hardening rounds.

github.com/nilstate/scafld/v2/internal/adapters/cli/harden

Package hardensubmit wires the hidden harden-submit-stdio command.

github.com/nilstate/scafld/v2/internal/adapters/cli/hardensubmit

Package help formats command help for the CLI adapter.

github.com/nilstate/scafld/v2/internal/adapters/cli/help

Package initcmd installs the CLI-facing workspace bootstrap assets.

github.com/nilstate/scafld/v2/internal/adapters/cli/initcmd

Package output formats human-readable command output for the CLI adapter.

github.com/nilstate/scafld/v2/internal/adapters/cli/output

Package providerinfo renders provider selection facts for CLI progress output shared by the review and harden subcommands.

github.com/nilstate/scafld/v2/internal/adapters/cli/providerinfo

Package review selects review providers and pass agendas for the CLI adapter.

github.com/nilstate/scafld/v2/internal/adapters/cli/review

Package reviewsubmit adapts the hidden review-submit-stdio command.

github.com/nilstate/scafld/v2/internal/adapters/cli/reviewsubmit

Package sessionstore composes CLI session persistence with receipt trust checks from the committed workspace config.

github.com/nilstate/scafld/v2/internal/adapters/cli/sessionstore

Package verify is the scafld verify command.

github.com/nilstate/scafld/v2/internal/adapters/cli/verify

Package clock provides runtime clock adapters for application use cases.

github.com/nilstate/scafld/v2/internal/adapters/clock

Package config loads and merges scafld workspace configuration files.

github.com/nilstate/scafld/v2/internal/adapters/config

Package corebundle installs embedded managed scafld core assets into workspaces.

github.com/nilstate/scafld/v2/internal/adapters/corebundle

Package filesystem owns workspace discovery and filesystem-backed bootstrap operations.

github.com/nilstate/scafld/v2/internal/adapters/filesystem

Package git inspects workspace state through Git-backed adapters.

github.com/nilstate/scafld/v2/internal/adapters/git

Package jsonstore persists session ledgers as atomic JSON files.

github.com/nilstate/scafld/v2/internal/adapters/jsonstore

Package markdown parses, renders, and stores living Markdown task specs.

github.com/nilstate/scafld/v2/internal/adapters/markdown

Package finalize exposes the host-facing finalize MCP transport.

github.com/nilstate/scafld/v2/internal/adapters/mcp/finalize

Package hardensubmit exposes the hidden MCP submit_harden transport.

github.com/nilstate/scafld/v2/internal/adapters/mcp/hardensubmit

Package reviewsubmit exposes the scafld review submission tool over MCP stdio.

github.com/nilstate/scafld/v2/internal/adapters/mcp/reviewsubmit

Package process runs external commands with streaming capture, watchdogs, and diagnostics.

github.com/nilstate/scafld/v2/internal/adapters/process

Package providers adapts external model providers to scafld review dossiers.

github.com/nilstate/scafld/v2/internal/adapters/providers

Package sign signs receipts with an Ed25519 private key kept on the host, and refuses a key file that its group or other users can read.

github.com/nilstate/scafld/v2/internal/adapters/sign

Package terminal contains small terminal output helpers.

github.com/nilstate/scafld/v2/internal/adapters/terminal

Package trustcheck adapts trusted-key files to the session replay trust port.

github.com/nilstate/scafld/v2/internal/adapters/trustcheck

Package acceptance runs and evaluates a task's acceptance criteria, from commands and recorded manual evidence, without changing lifecycle or session state.

github.com/nilstate/scafld/v2/internal/app/acceptance

Package approve implements the approval lifecycle use case.

github.com/nilstate/scafld/v2/internal/app/approve

Package audit contains workspace scope-auditing application logic.

github.com/nilstate/scafld/v2/internal/app/audit

Package bootstrap creates the project-owned scafld workspace layout.

github.com/nilstate/scafld/v2/internal/app/bootstrap

Package build advances phase-bounded execution and projects evidence back into specs.

github.com/nilstate/scafld/v2/internal/app/build

Package cancel records cancellation lifecycle state.

github.com/nilstate/scafld/v2/internal/app/cancel

Package complete closes reviewed work after the review gate has passed.

github.com/nilstate/scafld/v2/internal/app/complete

Package config prepares evidence-backed workspace configuration proposals.

github.com/nilstate/scafld/v2/internal/app/config

Package envelope defines stable JSON response envelopes for CLI automation.

github.com/nilstate/scafld/v2/internal/app/envelope

Package fail records failed lifecycle state and its reason.

github.com/nilstate/scafld/v2/internal/app/fail

Package finalize owns the host-facing accountability finalization use case.

github.com/nilstate/scafld/v2/internal/app/finalize

Package handoff renders model-facing handoff material from task specs.

github.com/nilstate/scafld/v2/internal/app/handoff

Package harden opens and completes spec hardening rounds.

github.com/nilstate/scafld/v2/internal/app/harden

Package list returns workspace task spec summaries.

github.com/nilstate/scafld/v2/internal/app/list

Package packetrepair writes operator-facing provider packet repair artifacts.

github.com/nilstate/scafld/v2/internal/app/packetrepair

Package plan creates draft specs from operator input.

github.com/nilstate/scafld/v2/internal/app/plan

Package reconcile rebuilds living spec projections from session evidence.

github.com/nilstate/scafld/v2/internal/app/reconcile

Package report aggregates workspace-level task metrics.

github.com/nilstate/scafld/v2/internal/app/report

Package review runs adversarial provider review and records review evidence.

github.com/nilstate/scafld/v2/internal/app/review

Package specsource loads exact Markdown source for agent-facing commands.

github.com/nilstate/scafld/v2/internal/app/specsource

Package status reads the current task state and suggested next action.

github.com/nilstate/scafld/v2/internal/app/status

Package taskstate contains the small workspace projections shared by taskless lifecycle entry points.

github.com/nilstate/scafld/v2/internal/app/taskstate

Package update refreshes managed scafld core assets.

github.com/nilstate/scafld/v2/internal/app/update

Package validate checks specs without mutating workspace state.

github.com/nilstate/scafld/v2/internal/app/validate

Package verify owns the CI-side receipt verification use case.

github.com/nilstate/scafld/v2/internal/app/verify

Package acceptance evaluates criterion evidence against expected result kinds.

github.com/nilstate/scafld/v2/internal/core/acceptance

Package agentcontract models role contracts delivered to agents.

github.com/nilstate/scafld/v2/internal/core/agentcontract

Package completion evaluates the review authority that allows a task to close.

github.com/nilstate/scafld/v2/internal/core/completion

Package diagnostics turns a provider failure into a compact one-line reason for status and ledgers, and names the artifact that keeps the full transcript.

github.com/nilstate/scafld/v2/internal/core/diagnostics

Package execution defines command execution requests and results.

github.com/nilstate/scafld/v2/internal/core/execution

Package gate defines deterministic failure payloads for lifecycle gates.

github.com/nilstate/scafld/v2/internal/core/gate

Package harden models provider-backed pre-approval hardening.

github.com/nilstate/scafld/v2/internal/core/harden

Package hardengate projects draft hardening evidence into the single state used by harden, approve, status, and handoff surfaces.

github.com/nilstate/scafld/v2/internal/core/hardengate

Package lifecycle defines allowed task state transitions.

github.com/nilstate/scafld/v2/internal/core/lifecycle

Package providerpacket shares rejected provider packet material across layers.

github.com/nilstate/scafld/v2/internal/core/providerpacket

Package receipt owns the signed classification shared by finalization and verification.

github.com/nilstate/scafld/v2/internal/core/receipt

Package reconcile projects session evidence onto living task specs.

github.com/nilstate/scafld/v2/internal/core/reconcile

Package review defines review dossiers, verdicts, and provider-output parsing.

github.com/nilstate/scafld/v2/internal/core/review

Package reviewcontext models the exact context packet given to review providers.

github.com/nilstate/scafld/v2/internal/core/reviewcontext

Package reviewevidence defines the canonical file evidence contract used by the receipt-grade review path.

github.com/nilstate/scafld/v2/internal/core/reviewevidence

Package reviewgate projects review-attempt and review evidence into the single gate state used by review, status, handoff, and completion commands.

github.com/nilstate/scafld/v2/internal/core/reviewgate

Package reviewmaterial projects the task-owned material surface shared by status, handoff, and API-style adapters.

github.com/nilstate/scafld/v2/internal/core/reviewmaterial

Package reviewscope derives the task-owned workspace surface used by review, status, handoff, and completion freshness checks.

github.com/nilstate/scafld/v2/internal/core/reviewscope

Package runartifact names where a task's runtime files live under .scafld/runs: its run directory, session ledger and lock, command diagnostics and provider packets.

github.com/nilstate/scafld/v2/internal/core/runartifact

Package session defines the append-only evidence ledger and replay model.

github.com/nilstate/scafld/v2/internal/core/session

Package spec defines the normalized model for living Markdown task specs.

github.com/nilstate/scafld/v2/internal/core/spec

Package trust reads, validates and writes .scafld/trusted-keys.json, the allowlist of Ed25519 public keys that receipt signatures are checked against, revoked keys included.

github.com/nilstate/scafld/v2/internal/core/trust

Package workspace defines workspace bootstrap and dirty-state snapshot models.

github.com/nilstate/scafld/v2/internal/core/workspace

Package atomicfile provides atomic file replacement primitives.

github.com/nilstate/scafld/v2/internal/platform/atomicfile

Package filelock provides advisory cross-process file locking for stores that read-modify-write shared state.

github.com/nilstate/scafld/v2/internal/platform/filelock

Package mcpsubmit serves a minimal MCP stdio server for one structured payload.

github.com/nilstate/scafld/v2/internal/platform/mcpsubmit

Package processguard hardens the scafld process while it handles secrets.

github.com/nilstate/scafld/v2/internal/platform/processguard

Package signal coordinates process-wide interrupt cancellation and escalation.

github.com/nilstate/scafld/v2/internal/platform/signal