{"_id":"@alavida/agonda","_rev":"3-919d9467100c9568bb4ad5c510f63a96","name":"@alavida/agonda","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.1":{"name":"@alavida/agonda","version":"0.1.1","keywords":["cli","agonda","workspace","execution-plan"],"license":"UNLICENSED","_id":"@alavida/agonda@0.1.1","maintainers":[{"name":"alexalavida","email":"alex@alavida.ai"}],"homepage":"https://docs.alavida.ai","bugs":{"url":"https://github.com/alavida-ai/agonda/issues"},"bin":{"agonda":"dist/index.js"},"dist":{"shasum":"323894165eafe5675e837b56812e7677d60d7105","tarball":"https://registry.npmjs.org/@alavida/agonda/-/agonda-0.1.1.tgz","fileCount":53,"integrity":"sha512-viZWZVPJb2t0KMO8h/GFYKL2tFWzIRATJ8J2gYD7pjsZIhqrCPfz5uk7NTvdzTDzhBz9pIENsYG3QllsgcfISg==","signatures":[{"sig":"MEQCIFdL7YQU/i6ARwjRBHRrWzZBgXO2ndbuV5ZRvtUXX4IzAiBmy25pt9pF82n5ESS6tb3z5hgcemL4usUpI9SkZAvf/A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@alavida%2fagonda@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":150744},"type":"module","engines":{"node":">=20"},"gitHead":"927ffa9dc15bbcb740d6db5b0d39cd1065909cd4","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit","test":"vitest run","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"alexalavida","email":"alex@alavida.ai"},"repository":{"url":"git+https://github.com/alavida-ai/agonda.git","type":"git"},"_npmVersion":"10.8.2","description":"CLI for managing execution plans and workspace lifecycles in Agonda-structured repositories","directories":{},"_nodeVersion":"20.20.0","dependencies":{"boxen":"^8.0.1","chalk":"^5.4.1","figures":"^6.1.0","js-yaml":"^4.1.0","commander":"^14.0.1","string-width":"^7.2.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.6","vitest":"^3.2.4","typescript":"^5.9.2","@types/node":"^24.6.0","@types/js-yaml":"^4.0.9"},"_npmOperationalInternal":{"tmp":"tmp/agonda_0.1.1_1773227484158_0.707515388336553","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@alavida/agonda","version":"0.1.2","keywords":["cli","agonda","workspace","execution-plan"],"license":"UNLICENSED","_id":"@alavida/agonda@0.1.2","maintainers":[{"name":"alexalavida","email":"alex@alavida.ai"}],"homepage":"https://docs.alavida.ai","bugs":{"url":"https://github.com/alavida-ai/agonda/issues"},"bin":{"agonda":"dist/index.js","intent":"bin/intent.js"},"dist":{"shasum":"ec634ff025fca85d69f66e0429747cd84657fc41","tarball":"https://registry.npmjs.org/@alavida/agonda/-/agonda-0.1.2.tgz","fileCount":54,"integrity":"sha512-NQZ/+gEJh54kbSSAOjWhGRrCz0giCD2Q76QsL4AZcvhxRMNZMRwnwDRuQ18BLmJakaEHk0wxBmCjjBsLpbKf/g==","signatures":[{"sig":"MEUCIHITpBcwyXUh5bEbOWmcYa3p0DPLNPZwL+ztX06ze6qtAiEAxplJlaTrM/iOO+ePK7laZq8LhoRi7oCxHZ9H3JaQIAU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@alavida%2fagonda@0.1.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":167355},"type":"module","engines":{"node":">=20"},"gitHead":"8e8db7b6d23721a869d2551986f2bda129f145a7","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit","test":"vitest run","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"alexalavida","email":"alex@alavida.ai"},"repository":{"url":"git+https://github.com/alavida-ai/agonda.git","type":"git"},"_npmVersion":"10.8.2","description":"CLI for managing execution plans and workspace lifecycles in Agonda-structured repositories","directories":{},"_nodeVersion":"20.20.0","dependencies":{"boxen":"^8.0.1","chalk":"^5.4.1","figures":"^6.1.0","js-yaml":"^4.1.0","commander":"^14.0.1","string-width":"^7.2.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.6","vitest":"^3.2.4","typescript":"^5.9.2","@types/node":"^24.6.0","@types/js-yaml":"^4.0.9","@tanstack/intent":"^0.0.14"},"_npmOperationalInternal":{"tmp":"tmp/agonda_0.1.2_1773231488105_0.12739423633060798","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@alavida/agonda","version":"0.1.3","description":"CLI for managing execution plans and workspace lifecycles in Agonda-structured repositories","type":"module","bin":{"agonda":"dist/index.js","intent":"bin/intent.js"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"scripts":{"build":"tsc","dev":"tsx src/index.ts","test":"vitest run","prepublishOnly":"npm run build","lint":"tsc --noEmit"},"dependencies":{"boxen":"^8.0.1","chalk":"^5.4.1","commander":"^14.0.1","figures":"^6.1.0","js-yaml":"^4.1.0","string-width":"^7.2.0"},"devDependencies":{"@tanstack/intent":"^0.0.14","@types/js-yaml":"^4.0.9","@types/node":"^24.6.0","tsx":"^4.20.6","typescript":"^5.9.2","vitest":"^3.2.4"},"engines":{"node":">=20"},"keywords":["cli","agonda","workspace","execution-plan"],"repository":{"type":"git","url":"git+https://github.com/alavida-ai/agonda.git"},"homepage":"https://docs.alavida.ai","license":"UNLICENSED","_id":"@alavida/agonda@0.1.3","gitHead":"8b98c450b8fa7f5a62273fa7b4b867b9cc799d09","bugs":{"url":"https://github.com/alavida-ai/agonda/issues"},"_nodeVersion":"20.20.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-0n+dcPRdtw0HO16WjbsDmmqRXIviMvJ9DmtZ+YZqtM51/xSmSRJ2yTMs29TMYxoM5Q9vbHgDAhX0QnOQI/8XeQ==","shasum":"ed03b34a64bbdd419f4db13a5ac95ffdb039f730","tarball":"https://registry.npmjs.org/@alavida/agonda/-/agonda-0.1.3.tgz","fileCount":54,"unpackedSize":168096,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@alavida%2fagonda@0.1.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHYxXxzOWjh/ddXmgT1zZNWKjf+1xKolnZjxoZxrjORGAiEAqQWX+SzTE9+d4W7K6AMzo0DNpJJUT/N3n8LIpUtbsnk="}]},"_npmUser":{"name":"alexalavida","email":"alex@alavida.ai"},"directories":{},"maintainers":[{"name":"alexalavida","email":"alex@alavida.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agonda_0.1.3_1773236234793_0.5856143551617634"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-11T11:11:24.053Z","modified":"2026-03-11T13:37:15.328Z","0.1.1":"2026-03-11T11:11:24.302Z","0.1.2":"2026-03-11T12:18:08.246Z","0.1.3":"2026-03-11T13:37:14.940Z"},"bugs":{"url":"https://github.com/alavida-ai/agonda/issues"},"license":"UNLICENSED","homepage":"https://docs.alavida.ai","keywords":["cli","agonda","workspace","execution-plan"],"repository":{"type":"git","url":"git+https://github.com/alavida-ai/agonda.git"},"description":"CLI for managing execution plans and workspace lifecycles in Agonda-structured repositories","maintainers":[{"name":"alexalavida","email":"alex@alavida.ai"}],"readme":"# Agonda CLI\n\nCommand-line tool for managing execution plans and workspace lifecycles in Agonda-structured repositories.\n\nThe CLI manages two file-based data stores:\n\n- **plan.yaml** — your 12-week execution plan (goals, tactics, cycle metadata)\n- **workspace.json** — per-workspace manifests (owner, deliverable, status, links)\n\nIt is the single writer for both. Humans read the formatted output. Agents consume `--json`.\n\n## Install\n\n```bash\nnpm install -g agonda\n```\n\nRequires Node.js 20+.\n\n## Quick Start\n\n```bash\n# See your plan — goals, what's due, what's overdue\nagonda plan view\n\n# See all workspaces — who owns what, what's stale\nagonda workspace list\n\n# Create a workspace for a new piece of work\nagonda workspace create barryos-website \\\n  --workbench website-dev \\\n  --domain value \\\n  --owner Thomas \\\n  --deliverable \"Landing page with lead capture\" \\\n  --work-type business\n\n# Done with a workspace — queue it for synthesis\nagonda workspace complete barryos-website\n```\n\n## How It Works\n\nThe CLI governs the **direction** and **context** layers of your operations system:\n\n```\nDIRECTION     plan.yaml          Goals, tactics, cycle\nCONTEXT       workspace.json     Per-workspace: who, what, why, status\nEXECUTION     Linear             Tickets, assignments (not managed by CLI)\nKNOWLEDGE     domains/           Synthesized insights (not managed by CLI)\n```\n\nDirection flows down (plan → workspaces → tickets). Status flows up (tickets done → workspace complete → synthesis → domain knowledge).\n\nThe CLI never touches Linear. Agents interact with Linear via MCP. Humans use the Linear UI.\n\n## Commands\n\n### Plan\n\n| Command | What it does |\n|---------|-------------|\n| `agonda plan view` | Goals, tactics, due this week, overdue — one unified view |\n| `agonda plan validate` | Check plan.yaml for schema errors |\n| `agonda plan init` | Set cycle metadata (name, dates, vision) |\n| `agonda plan goal add` | Add a goal to the plan |\n| `agonda plan goal edit <id>` | Edit a goal |\n| `agonda plan goal remove <id>` | Remove a goal |\n| `agonda plan goal list` | List all goals |\n| `agonda plan tactic add` | Add a tactic (deliverable or habit) |\n| `agonda plan tactic edit <id>` | Edit a tactic |\n| `agonda plan tactic remove <id>` | Remove a tactic |\n| `agonda plan tactic list` | List/filter tactics |\n| `agonda plan tactic complete <id>` | Mark a deliverable done |\n| `agonda plan tactic reopen <id>` | Reopen a completed deliverable |\n\n### Workspace\n\n| Command | What it does |\n|---------|-------------|\n| `agonda workspace create <name>` | Scaffold a new workspace with manifest |\n| `agonda workspace list` | List/filter all workspaces |\n| `agonda workspace link` | Connect workspace to a plan tactic or Linear object |\n| `agonda workspace complete <name>` | Close workspace — queue for synthesis or archive |\n| `agonda workspace archive <name>` | Terminal transition after synthesis completes |\n| `agonda workspace graduate <name>` | Record that this workspace spawned a repo |\n| `agonda workspace validate` | Check all workspace.json files for integrity |\n\nEvery command supports `--json` for agent consumption.\n\n## Documentation\n\n| Doc | What it covers |\n|-----|---------------|\n| [Introduction](docs/introduction.mdx) | Core concepts, output modes, and design principles |\n| [Quick Start](docs/quickstart.mdx) | Install, first commands, and common flows |\n| [Plan Commands](docs/plan/overview.mdx) | Full plan command reference |\n| [Workspace Commands](docs/workspace/overview.mdx) | Full workspace command reference |\n| [Workspace Lifecycle](docs/concepts/lifecycle.mdx) | The four statuses, transitions, and archival rules |\n| [Schemas](docs/concepts/schemas.mdx) | plan.yaml and workspace.json field-level specifications |\n\n## For the Building Agent\n\nThe `spec/` directory contains the implementation specification and all design context:\n\n| File | Purpose |\n|------|---------|\n| [spec/implementation.md](spec/implementation.md) | Complete implementation spec — conventions, schemas, commands, JSON output shapes, testing strategy |\n| [spec/decisions.md](spec/decisions.md) | 17 locked design decisions with rationale |\n| [spec/domain-model.md](spec/domain-model.md) | Four-layer architecture, core objects, terminology |\n| [spec/user-stories.md](spec/user-stories.md) | 20 user/agent stories with coverage matrices |\n| [spec/phases.md](spec/phases.md) | Build phases with dependencies and acceptance criteria |\n| [spec/HANDOFF.md](spec/HANDOFF.md) | Start here — what to build first, key constraints, gotchas |\n\n## License\n\nPrivate — Alavida AI Ltd.\n","readmeFilename":"README.md"}