Skip to content

Implement Sandman portfolio improvements from Boring Infra plan - #7

Merged
sgr0691 merged 1 commit into
mainfrom
cursor/sandman-portfolio-improvements-0ffb
Sep 26, 2026
Merged

sgr0691 merged 1 commit into
mainfrom
cursor/sandman-portfolio-improvements-0ffb

Conversation

@sgr0691

@sgr0691 sgr0691 commented Sep 26, 2026

Copy link
Copy Markdown
Collaborator

Summary

Implements the full Sandman improvement plan by adopting patterns from Campfire, Root, Harnie, Combie, and Meno across agent UX, infrastructure depth, portfolio integration, and distribution.

Agent UX

  • sandman.cli.v1 machine contract — versioned JSON envelopes with schema + command fields, budget truncation helpers, and docs/MACHINE-CONTRACT.md
  • Human-first flows — sandman (onboard), sandman up, sandman connect-agent --harness, sandman doctor --harness with readiness + nextAction
  • Handoff packages — sandman handoff <name> --to <harness> writes Markdown continuation packages to ~/.sandman/handoffs/
  • MCP server — sandman mcp serve exposes list/status/create/enable/connect/destroy tools with capability gating via ~/.sandman/mcp.toml

Infrastructure depth

  • Environment templates — web-app, data-pipeline, ai-agent via sandman templates and create --template
  • Provenance — createdBy, harness, session, goal fields on environment records
  • Checkpoints / rollback — local state snapshots with sandman checkpoint and sandman rollback --last
  • Provider shortcuts — init --use-aws-profile, --use-gcloud, --use-env
  • Cloudflare + Vercel — promoted to supported; real KV/project provisioning and destroy cleanup

Portfolio integration

  • Combie — sandman link <name> --combie writes link records for combie sync
  • Meno-compatible verify — sandman verify <name> evaluates proven/disproven/unknown claims
  • Loopback viewer — sandman view read-only dashboard (no secrets in browser)

Distribution & docs

  • install.sh, docs/FIRST-RUN.md, docs/OPERATOR.md, docs/architecture.md
  • sandman seed --reset deterministic fixture for evals/CI
  • CLI version now reads from package.json (fixes 0.2.0 hardcode)
  • Expanded evals/evals.json with handoff/MCP/template triggers

Test plan

  • npm run build passes
  • npm test — 121 tests passing
  • New portfolio command tests (handoff, seed, checkpoint/rollback, verify, link, templates)
  • Updated Cloudflare/Vercel adapter tests for real API provisioning
Open in Web Open in Cursor 

Add sandman.cli.v1 machine contract, human-first onboard/up flows,
handoff packages, MCP server, templates, checkpoints, and portfolio
integrations (Combie link, Meno-compatible verify, loopback viewer).
Promote Cloudflare and Vercel to supported providers with real API
provisioning, add auth shortcuts for init, seed fixtures, docs, and
install.sh.

Co-authored-by: Sergio Rovira <sgr0691@users.noreply.github.com>
@sgr0691
sgr0691 marked this pull request as ready for review September 26, 2026 20:57
@sgr0691
sgr0691 merged commit 6fb69bf into main Sep 26, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants