v1.0.7

SMALL Protocol v1.0.7

Install with:

go install github.com/justyn-clark/small-protocol/cmd/small@v1.0.7

Or download pre-built binaries below.

Changelog

v1.0.6

SMALL Protocol v1.0.6

Install with:

go install github.com/justyn-clark/small-protocol/cmd/small@v1.0.6

Or download pre-built binaries below.

Changelog

v1.0.5

SMALL Protocol v1.0.5

Install with:

go install github.com/justyn-clark/small-protocol/cmd/small@v1.0.5

Or download pre-built binaries below.

Changelog

v1.0.4

SMALL Protocol v1.0.4

Install with:

go install github.com/justyn-clark/small-protocol/cmd/small@v1.0.4

Or download pre-built binaries below.

Changelog

Bug fixes

• 27b6da1 fix(ci): use auth-mode output in npm publish workflow

v1.0.3

SMALL Protocol v1.0.3

Install with:

go install github.com/justyn-clark/small-protocol/cmd/small@v1.0.3

Or download pre-built binaries below.

Changelog

Others

• 05151dc Bump CLI install instructions to v1.0.2 and clarify release notes
• 2d4c17d Unblock task-17 and update its status to pending in plan and progress

v1.0.2

SMALL Protocol v1.0.2

Install with:

go install github.com/justyn-clark/small-protocol/cmd/small@v1.0.2

Or download pre-built binaries below.

Changelog

Bug fixes

• aa52d74 fix(version): resolve tag version for go install; inject commit/date

Others

• e05b03a Update documentation to recommend v1.0.1 patch release

v1.0.1

SMALL Protocol v1.0.1

Install with:

go install github.com/justyn-clark/small-protocol/cmd/small@v1.0.1

Or download pre-built binaries below.

Changelog

Others

• 1d56446 This is a significant commit that modifies the codebase to introduce stricter checks for task completion and progress entry consistency. Here's a breakdown of the changes:
• 5dfe281 - Added emit command with JSON-only output and optional --check enforcement results.
• bb07593 Add GitHub release workflow and run lineage tracking
• 6127849 Add accept/draft commands, improve CLI output, and enhance run tracking
• 6c28ff8 Add commands and support for managing AGENTS.md harness block
• 65a8cc6 Add signal-first progress mode, workspace run tracking, and handoff state improvements
• 845c37d Delete AGENTS.md
• f23a1e3 Fix AgentsCheckResult struct field formatting
• 42621c3 Implemented the CLI upgrades and wired the new commands, plus added tests and updated apply behavior.
• d7f7c7f Refactor codebase to use native Go any type instead of interface{}
• 3710536 Update funding sources in FUNDING.yml
• 9e6ed98 lint: do not treat run previous_replay_id as secret
• c0d0a2b release: add build packaging scripts and checksums

v1.0.0

Deprecated: v1.0.0 had incorrect version reporting in some install paths. Use v1.0.1.

SMALL Protocol v1.0.0

SMALL v1.0.0 is the first stable release of the SMALL Protocol and CLI.

This release establishes a durable, enforceable contract for agent-legible project state with CI-grade guarantees and strict workspace isolation.

---

What v1.0.0 Guarantees

Deterministic replay

• Every execution run has a stable replayId
• Replay is scoped to run boundaries (bootstrap vs execution run)
• Replay authority lives in workspace metadata
• Manual replay IDs are accepted and normalized to lowercase

Runs are reproducible and traceable without ambiguity.

---

Strict execution audit

• Completed tasks require timestamped evidence
• Progress entries must be RFC3339Nano and strictly ordered
• Run-scoped progress validation (no cross-run leakage)
• Violations fail small verify and small check --strict

Strict mode is CI-safe and deterministic.

---

Workspace enforcement

• Explicit workspace metadata via .small/workspace.small.yml
• Hard S4 layout fence: only canonical artifacts allowed under .small/
• Scratch data moved to .small-cache/
• Bootstrap entries do not pollute run replay state
• Agents cannot write rogue files into protocol state

This prevents silent drift and agent corruption.

---

Signal-first progress

• Default progress mode is signal-only
• Only real task-* entries emitted during execution
• Optional audit mode for full telemetry
• small status summarizes actionable state, not noise

Human scan stays readable. CI remains strict.

---

CI enforcement

• small verify is a hard correctness gate
• small check --strict validates schema + invariants + replay scope
• Missing replayId, missing evidence, invalid artifacts, or layout violations fail builds

No soft warnings in strict mode.

---

CLI Commands (v1.0.0)

❯ small       
                                                                                            
  ██████  ███    ███  █████  ██      ██
 ██       ████  ████ ██   ██ ██      ██
  █████   ██ ████ ██ ███████ ██      ██
       ██ ██  ██  ██ ██   ██ ██      ██
 ██████  ██      ██ ██   ██ ███████ ███████

  Deterministic state with auditable lineage.


Usage:
  small [command]

Available Commands:
  accept      Accept draft artifacts into canonical files
  agents      Manage AGENTS.md harness block
  apply       Execute a command bounded by intent and constraints
  archive     Archive the current run state for lineage retention
  check       Run validate, lint, and verify
  checkpoint  Update plan and progress in one step
  completion  Generate the autocompletion script for the specified shell
  doctor      Diagnose SMALL workspace issues and suggest fixes
  draft       Create draft artifacts for human-owned files
  emit        Emit structured SMALL state in JSON
  fix         Normalize SMALL artifacts in-place
  handoff     Generate or update handoff.small.yml
  help        Help about any command
  init        Initialize a new SMALL v1.0.0 project
  lint        Lint SMALL artifacts for invariant violations
  plan        Create or update plan.small.yml
  progress    Manage progress.small.yml
  reset       Reset .small/ for a new run while preserving audit history
  run         Manage run history snapshots
  selftest    Run built-in self-test to verify CLI functionality
  start       Initialize or repair run handoff state
  status      Show SMALL project status summary
  validate    Validate all canonical SMALL artifacts
  verify      CI/local enforcement gate for SMALL artifacts
  version     Print CLI version and supported spec versions

Flags:
  -h, --help       help for small
      --no-color   Disable ANSI color output
      --quiet      Suppress non-error output

Use "small [command] --help" for more information about a command.
SMALL is a protocol for durable, agent-legible project state.

All commands above are part of the stable v1.0.0 surface and covered by tests.

---

Installation

go install github.com/justyn-clark/small-protocol/cmd/small@v1.0.0

Pre-built binaries for macOS, Linux, and Windows are attached below.
Verify integrity using checksums.txt.

---

Stability Promise

• This release defines the v1 contract
• No breaking changes without a version bump
• Artifacts produced by v1.0.0 remain valid across all v1.x releases
• Strict invariants will only tighten in backward-compatible ways

---

Notes

• Root .small/ directories are runtime state and should not be committed
• Example workspaces under examples/**/.small/ are canonical and versioned
• .small-cache/ is intentionally excluded from canonical protocol state
• Docs release/v1.0.0 branch is pinned to this tag commit