{"_id":"@c-1k/sauce","name":"@c-1k/sauce","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@c-1k/sauce","version":"0.1.0","description":"Sauce (CoS) — The secret ingredient for parallel Claude Code agents","type":"module","main":"dist/index.js","types":"dist/index.d.ts","bin":{"sauce":"bin/sauce.ts","cielo":"bin/sauce.ts"},"scripts":{"dev":"bun run --hot src/index.ts","build":"bun build src/index.ts --outdir dist --target bun","test":"bun test","test:watch":"bun test --watch","lint":"biome check .","lint:fix":"biome check --write .","format":"biome format --write .","prepublishOnly":"bun run build"},"keywords":["sauce","cielo","claude","claude-code","ai-agents","coordination","parallel","git","workflow","multi-agent"],"author":"","license":"MIT","repository":{"type":"git","url":"git+https://github.com/sauce-labs/sauce.git"},"homepage":"https://github.com/sauce-labs/sauce#readme","bugs":{"url":"https://github.com/sauce-labs/sauce/issues"},"engines":{"node":">=18","bun":">=1.0"},"dependencies":{"minimatch":"^10.1.1","zod":"^3.23.8"},"devDependencies":{"@biomejs/biome":"^1.9.0","@types/bun":"^1.1.0","typescript":"^5.6.0"},"trustedDependencies":["@biomejs/biome"],"_id":"@c-1k/sauce@0.1.0","gitHead":"8c114e9c2af13a7bade0fcc7d987fbebb8f02885","_nodeVersion":"23.6.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-uatA9bcgXaxA7PyXXqdzv9ocweXAI0oUCfCGWnC0Y+RPN5H7qBAVzBxNfpekr9Oq2KBVCmiTvwWGD9vfhNH8bw==","shasum":"8af93a54702fca22ddcb6c206fe2514bb1b41906","tarball":"https://registry.npmjs.org/@c-1k/sauce/-/sauce-0.1.0.tgz","fileCount":61,"unpackedSize":602295,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCp2ZCy6mqKx2xVjnvIf2fA8Rl43PxuqUDzEyfNxQm1hgIhALLR3Ou9V/dXCmKEnpLrJcwWTsZd22mCTFGE2FHas1pc"}]},"_npmUser":{"name":"c-1k","email":"cam@camwhiteus.com"},"directories":{},"maintainers":[{"name":"c-1k","email":"cam@camwhiteus.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sauce_0.1.0_1770085406808_0.8735784615346183"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-03T02:23:26.745Z","0.1.0":"2026-02-03T02:23:27.040Z","modified":"2026-02-03T02:23:27.217Z"},"maintainers":[{"name":"c-1k","email":"cam@camwhiteus.com"}],"description":"Sauce (CoS) — The secret ingredient for parallel Claude Code agents","homepage":"https://github.com/sauce-labs/sauce#readme","keywords":["sauce","cielo","claude","claude-code","ai-agents","coordination","parallel","git","workflow","multi-agent"],"repository":{"type":"git","url":"git+https://github.com/sauce-labs/sauce.git"},"bugs":{"url":"https://github.com/sauce-labs/sauce/issues"},"license":"MIT","readme":"# Sauce\n\n<div align=\"center\">\n\n```\n  ███████╗ █████╗ ██╗   ██╗ ██████╗███████╗\n  ██╔════╝██╔══██╗██║   ██║██╔════╝██╔════╝\n  ███████╗███████║██║   ██║██║     █████╗\n  ╚════██║██╔══██║██║   ██║██║     ██╔══╝\n  ███████║██║  ██║╚██████╔╝╚██████╗███████╗\n  ╚══════╝╚═╝  ╚═╝ ╚═════╝  ╚═════╝╚══════╝\n       The Secret Ingredient for AI Swarms\n                  by Sauce Labs\n```\n\n[![CI](https://github.com/c-1k/sauce/actions/workflows/ci.yml/badge.svg)](https://github.com/c-1k/sauce/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![npm version](https://img.shields.io/npm/v/@c-1k/sauce.svg)](https://www.npmjs.com/package/@c-1k/sauce)\n[![Bun](https://img.shields.io/badge/Bun-1.0+-black?logo=bun)](https://bun.sh)\n\n**Run multiple Claude Code agents on the same codebase without conflicts.**\n\n[Quick Start](#quick-start) | [Demo](#demo) | [Architecture](#architecture) | [Documentation](#documentation)\n\n</div>\n\n---\n\n## Why Sauce?\n\nWhen you run multiple AI coding agents in parallel, things break:\n- **File conflicts** — Two agents edit the same file\n- **Merge chaos** — Conflicting branches pile up\n- **Coordination overhead** — You become the bottleneck, directing traffic\n\nSauce solves this with **scope-based write guards** and **role-based coordination**:\n\n```bash\n# Agent claims exclusive scope before editing\nsauce claim --scope \"src/auth/**\" --actor worker-alpha\n\n# Other agents cannot claim overlapping files\nsauce claim --scope \"src/auth/login.ts\" --actor worker-beta\n# ERROR: Scope conflict with worker-alpha\n```\n\n## Demo\n\n<!-- TODO: Replace with actual demo GIF -->\n> **Coming soon**: Watch a 2-worker swarm build a complete auth feature in under 5 minutes.\n>\n> See [docs/DEMO-SCRIPT.md](docs/DEMO-SCRIPT.md) for the demo scenario.\n\n## Quick Start\n\n```bash\n# Install\nbun add sauce\n\n# Initialize in your project\nbunx sauce init\n\n# Create worker worktrees\nbunx sauce setup --workers 2\n\n# Start the coordination system\nbunx sauce launch\n```\n\nThat's it. Your project now has:\n- `.coord/` — Coordination state (tasks, queue, leases)\n- `.claude/commands/` — Agent role prompts\n- `worktrees/` — Isolated working directories per agent\n\n## Features\n\n### Core Coordination\n\n| Feature | Description |\n|---------|-------------|\n| **Write Guards** | File-level scope locks prevent edit conflicts |\n| **Task Queue** | Priority-ordered work distribution |\n| **Branch Isolation** | Each task = one branch, auto-created |\n| **Integration Queue** | Orderly merging with conflict detection |\n| **Audit Trail** | Every action logged for observability |\n\n### Agent Roles\n\n| Role | Purpose |\n|------|---------|\n| **VP** | Strategic oversight, fleet command |\n| **Manager** | Decomposes requests into parallelizable tasks |\n| **Worker** | Implements tasks in isolated branches |\n| **Reviewer** | Validates work before integration |\n| **Integrator** | Merges approved branches to main |\n| **Scout** | Pre-planning research and codebase exploration |\n| **Sentinel** | System health monitoring and alerts |\n\n### v0.1.0 Highlights\n\n- **Skill-Based Routing** — Tasks matched to workers with relevant skills\n- **Pattern Memory** — Learn from past task solutions\n- **Typed Messaging** — Structured inter-agent communication with audit trail\n- **Board of Directors** — AI oversight layer with unanimous veto power\n\n## Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│                         Human Founder                           │\n├─────────────────────────────────────────────────────────────────┤\n│                    Board of Directors (Phase 6)                 │\n│                 Director-A ◄──────► Director-B                  │\n│                      Unanimous Veto = BLOCK                     │\n├─────────────────────────────────────────────────────────────────┤\n│                          VP / Manager                           │\n│             Task decomposition • Worker assignment              │\n├─────────────────────────────────────────────────────────────────┤\n│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐        │\n│  │ Worker-α │  │ Worker-β │  │  Scout   │  │ Sentinel │        │\n│  │ worktree │  │ worktree │  │ research │  │ monitor  │        │\n│  └────┬─────┘  └────┬─────┘  └──────────┘  └──────────┘        │\n│       │             │                                           │\n│       ▼             ▼                                           │\n│  ┌──────────────────────────────────────────────┐              │\n│  │              Integration Queue               │              │\n│  │         Reviewer → Integrator → main         │              │\n│  └──────────────────────────────────────────────┘              │\n├─────────────────────────────────────────────────────────────────┤\n│                    .coord/ State Directory                      │\n│   tasks.json • queue.json • leases.json • events.jsonl         │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n## Configuration\n\nCreate `sauce.config.json`:\n\n```json\n{\n  \"workers\": 2,\n  \"baseBranch\": \"main\",\n  \"stagingBranch\": \"staging\",\n  \"coordDir\": \".coord\",\n  \"skillRouting\": true,\n  \"patternMemory\": true\n}\n```\n\n## CLI Reference\n\n```bash\n# Project setup\nsauce init                    # Initialize coordination\nsauce setup --workers N       # Create N worker worktrees\nsauce launch                  # Start the agent fleet\n\n# Task management\nsauce task create --title \"...\" --scope \"src/**\"\nsauce task list [--status pending|assigned|completed]\nsauce task claim --worker worker-alpha\nsauce task complete --id T-0001\n\n# Write guards\nsauce claim --scope \"src/**\" --actor worker-alpha --intent \"Refactoring\"\nsauce release --actor worker-alpha\nsauce leases                  # Show active scope locks\n\n# Integration queue\nsauce queue list\nsauce queue process           # Merge next approved item\nsauce queue process --all     # Merge all approved items\n\n# Worker management\nsauce worker register --id worker-gamma --skills typescript,testing\nsauce worker list\nsauce status                  # System overview\n```\n\n## Governance Layer\n\nSauce includes a governance subsystem for policy enforcement and audit:\n\n```typescript\nimport { evaluatePolicy, emitReceipt, sendDirectMessage } from \"sauce\";\n\n// Policy evaluation before actions\nconst result = evaluatePolicy(\n  { actor: \"worker-alpha\", action: \"scope.acquire\", scope: [\"src/**\"] },\n  policyRules\n);\n\nif (result.decision === \"deny\") {\n  console.error(\"Policy violation:\", result.reasons);\n}\n\n// Audit trail\nemitReceipt({\n  kind: \"task\",\n  subsystem: \"worker\",\n  actor: \"worker-alpha\",\n  data: { event: \"task_started\", taskId: \"T-0001\" }\n});\n\n// Typed messaging\nsendDirectMessage(\"worker-alpha\", \"manager\", \"Task Complete\", \"T-0001 done\");\n```\n\n## Requirements\n\n- [Bun](https://bun.sh) v1.0+\n- Git 2.30+\n- [Claude Code](https://claude.com/claude-code) CLI\n\n## Documentation\n\n- [Quick Start Guide](docs/QUICKSTART.md) — Get running in 5 minutes\n- [Architecture Overview](docs/ARCHITECTURE.md) — How Sauce works\n- [Role Definitions](docs/ROLES.md) — Agent responsibilities\n- [CLI Reference](docs/CLI.md) — All commands documented\n- [Demo Script](docs/DEMO-SCRIPT.md) — Recording guide\n\n## Contributing\n\nWe welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n```bash\n# Development setup\ngit clone https://github.com/c-1k/sauce\ncd sauce\nbun install\nbun test\n```\n\n## Roadmap\n\n- [x] v0.1.0 — Core coordination, write guards, task queue\n- [x] v0.1.0 — Governance layer (policy, audit, messaging)\n- [x] v0.1.0 — Board of Directors oversight\n- [ ] v0.2.0 — Web dashboard for monitoring\n- [ ] v0.2.0 — Multi-repo coordination\n- [ ] v0.3.0 — Self-healing task recovery\n\n## License\n\nMIT — see [LICENSE](LICENSE)\n\n---\n\n<div align=\"center\">\n\n**Built by Sauce Labs — the first agent-run company.**\n\n*Sauce is the secret ingredient between one AI agent and many.*\n\n</div>\n","readmeFilename":"README.md","_rev":"1-7a9711efd310b9a69957d7b782ab0ccb"}