spine-cli 0.1.0__tar.gz

spine_cli-0.1.0/.agents/skills/build/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: build
+description: Implement a software work item in doing. Use when the item is claimed and status is doing.
+---
+
+# build
+
+```
+spine claim docs/spine/work-items/NN-slug.md
+spine set-status docs/spine/work-items/NN-slug.md doing
+```
+
+Agents own content. CLI owns metadata. Install craft: `npx skills add mattpocock/skills -s implement -s tdd -s codebase-design -y`.
+
+## Gate
+doing (agent-drivable). Next: checking.

spine_cli-0.1.0/.agents/skills/doctor/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: doctor
+description: Recover mechanical drift in a spine target. Use at session start and when files look wrong.
+---
+
+# doctor
+
+```
+spine doctor
+spine evolve
+```
+
+Doctor auto-fixes stale claims, CLI-owned links, and rollups. It reports unknown statuses, missing spec files, gitignore drift. Never rewrite content sections by hand to fake a fix.
+
+## Gate
+Recovery loop. Not a harness hook.

spine_cli-0.1.0/.agents/skills/eval/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: eval
+description: Check a software work item against acceptance. Use when status is checking.
+---
+
+# eval
+
+Write proof under `.spine/evals/`. Then:
+
+```
+spine set-status docs/spine/work-items/NN-slug.md reviewing
+```
+
+Craft: `npx skills add mattpocock/skills -s qa -y`.
+
+## Gate
+checking (agent-drivable). Software profile requires this before done.

spine_cli-0.1.0/.agents/skills/new/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: new
+description: Capture a map ticket or work item via the spine CLI. Use when something new must be recorded in the target.
+---
+
+# new
+
+Mint artifacts with the CLI. Do not hand-edit status, owner, claim, links, or numbers.
+
+```
+spine new ticket --title "..." --type grilling
+spine new work-item --title "..." --profile software
+```
+
+Craft skills for interviewing live on skills.sh. Default wire: `mattpocock/skills` `grill-me` / `wayfinder` (`npx skills add mattpocock/skills -s grill-me -s wayfinder -y`). See `docs/spine/wires.yaml`.
+
+## Gate
+creating-work-item is HITL. Tickets start `open`. Work items start `ready`.

spine_cli-0.1.0/.agents/skills/next/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: next
+description: Pick the next spine action from the map frontier and work-item board.
+---
+
+# next
+
+Run `spine doctor` then `spine status`. Take the first open unblocked unclaimed ticket, or the work item whose status is the next gate.
+
+```
+spine doctor
+spine status
+```
+
+Craft router (optional): `npx skills add mattpocock/skills -s ask-matt -s implement -y`.
+
+## Gate
+Respect HITL: do not `set-status` to `reviewing` verdicts or mint work items without a human if the contract marks them HITL.

spine_cli-0.1.0/.agents/skills/review/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: review
+description: Review a software work item. Use when status is reviewing.
+---
+
+# review
+
+HITL verdict. Proof under `.spine/reviews/`. Pass:
+
+```
+spine set-status docs/spine/work-items/NN-slug.md done
+```
+
+Bounce:
+
+```
+spine set-status docs/spine/work-items/NN-slug.md changes-requested
+```
+
+Craft: `npx skills add mattpocock/skills -s code-review -y`.
+
+## Gate
+reviewing (HITL). Software profile requires this before done.

spine_cli-0.1.0/.agents/skills/wayfind/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: wayfind
+description: Plan with a spine map and tickets. Use when the way to a destination is foggy or multi-session.
+---
+
+# wayfind
+
+Planning lives on the map, not on the work item. Load `docs/spine/maps/`, work frontier tickets under `docs/spine/tickets/`. Claim a ticket with the CLI before work.
+
+```
+spine status
+spine new ticket --title "..." --type research
+spine claim tickets/NN-slug.md
+```
+
+Do not vendor Wayfinder. Install craft from skills.sh: `npx skills add mattpocock/skills -s wayfinder -s grilling -s domain-modeling -y`.
+
+## Gate
+No work-item status for planning. Create a work item at `ready` only when the way is clear.

spine_cli-0.1.0/.claude/skills/build/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: build
+description: Implement a software work item in doing. Use when the item is claimed and status is doing.
+---
+
+# build
+
+```
+spine claim docs/spine/work-items/NN-slug.md
+spine set-status docs/spine/work-items/NN-slug.md doing
+```
+
+Agents own content. CLI owns metadata. Install craft: `npx skills add mattpocock/skills -s implement -s tdd -s codebase-design -y`.
+
+## Gate
+doing (agent-drivable). Next: checking.

spine_cli-0.1.0/.claude/skills/doctor/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: doctor
+description: Recover mechanical drift in a spine target. Use at session start and when files look wrong.
+---
+
+# doctor
+
+```
+spine doctor
+spine evolve
+```
+
+Doctor auto-fixes stale claims, CLI-owned links, and rollups. It reports unknown statuses, missing spec files, gitignore drift. Never rewrite content sections by hand to fake a fix.
+
+## Gate
+Recovery loop. Not a harness hook.

spine_cli-0.1.0/.claude/skills/eval/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: eval
+description: Check a software work item against acceptance. Use when status is checking.
+---
+
+# eval
+
+Write proof under `.spine/evals/`. Then:
+
+```
+spine set-status docs/spine/work-items/NN-slug.md reviewing
+```
+
+Craft: `npx skills add mattpocock/skills -s qa -y`.
+
+## Gate
+checking (agent-drivable). Software profile requires this before done.

spine_cli-0.1.0/.claude/skills/new/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: new
+description: Capture a map ticket or work item via the spine CLI. Use when something new must be recorded in the target.
+---
+
+# new
+
+Mint artifacts with the CLI. Do not hand-edit status, owner, claim, links, or numbers.
+
+```
+spine new ticket --title "..." --type grilling
+spine new work-item --title "..." --profile software
+```
+
+Craft skills for interviewing live on skills.sh. Default wire: `mattpocock/skills` `grill-me` / `wayfinder` (`npx skills add mattpocock/skills -s grill-me -s wayfinder -y`). See `docs/spine/wires.yaml`.
+
+## Gate
+creating-work-item is HITL. Tickets start `open`. Work items start `ready`.

spine_cli-0.1.0/.claude/skills/next/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: next
+description: Pick the next spine action from the map frontier and work-item board.
+---
+
+# next
+
+Run `spine doctor` then `spine status`. Take the first open unblocked unclaimed ticket, or the work item whose status is the next gate.
+
+```
+spine doctor
+spine status
+```
+
+Craft router (optional): `npx skills add mattpocock/skills -s ask-matt -s implement -y`.
+
+## Gate
+Respect HITL: do not `set-status` to `reviewing` verdicts or mint work items without a human if the contract marks them HITL.

spine_cli-0.1.0/.claude/skills/review/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: review
+description: Review a software work item. Use when status is reviewing.
+---
+
+# review
+
+HITL verdict. Proof under `.spine/reviews/`. Pass:
+
+```
+spine set-status docs/spine/work-items/NN-slug.md done
+```
+
+Bounce:
+
+```
+spine set-status docs/spine/work-items/NN-slug.md changes-requested
+```
+
+Craft: `npx skills add mattpocock/skills -s code-review -y`.
+
+## Gate
+reviewing (HITL). Software profile requires this before done.

spine_cli-0.1.0/.claude/skills/wayfind/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: wayfind
+description: Plan with a spine map and tickets. Use when the way to a destination is foggy or multi-session.
+---
+
+# wayfind
+
+Planning lives on the map, not on the work item. Load `docs/spine/maps/`, work frontier tickets under `docs/spine/tickets/`. Claim a ticket with the CLI before work.
+
+```
+spine status
+spine new ticket --title "..." --type research
+spine claim tickets/NN-slug.md
+```
+
+Do not vendor Wayfinder. Install craft from skills.sh: `npx skills add mattpocock/skills -s wayfinder -s grilling -s domain-modeling -y`.
+
+## Gate
+No work-item status for planning. Create a work item at `ready` only when the way is clear.

spine_cli-0.1.0/.cursor/skills/build/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: build
+description: Implement a software work item in doing. Use when the item is claimed and status is doing.
+---
+
+# build
+
+```
+spine claim docs/spine/work-items/NN-slug.md
+spine set-status docs/spine/work-items/NN-slug.md doing
+```
+
+Agents own content. CLI owns metadata. Install craft: `npx skills add mattpocock/skills -s implement -s tdd -s codebase-design -y`.
+
+## Gate
+doing (agent-drivable). Next: checking.

spine_cli-0.1.0/.cursor/skills/doctor/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: doctor
+description: Recover mechanical drift in a spine target. Use at session start and when files look wrong.
+---
+
+# doctor
+
+```
+spine doctor
+spine evolve
+```
+
+Doctor auto-fixes stale claims, CLI-owned links, and rollups. It reports unknown statuses, missing spec files, gitignore drift. Never rewrite content sections by hand to fake a fix.
+
+## Gate
+Recovery loop. Not a harness hook.

spine_cli-0.1.0/.cursor/skills/eval/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: eval
+description: Check a software work item against acceptance. Use when status is checking.
+---
+
+# eval
+
+Write proof under `.spine/evals/`. Then:
+
+```
+spine set-status docs/spine/work-items/NN-slug.md reviewing
+```
+
+Craft: `npx skills add mattpocock/skills -s qa -y`.
+
+## Gate
+checking (agent-drivable). Software profile requires this before done.

spine_cli-0.1.0/.cursor/skills/new/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: new
+description: Capture a map ticket or work item via the spine CLI. Use when something new must be recorded in the target.
+---
+
+# new
+
+Mint artifacts with the CLI. Do not hand-edit status, owner, claim, links, or numbers.
+
+```
+spine new ticket --title "..." --type grilling
+spine new work-item --title "..." --profile software
+```
+
+Craft skills for interviewing live on skills.sh. Default wire: `mattpocock/skills` `grill-me` / `wayfinder` (`npx skills add mattpocock/skills -s grill-me -s wayfinder -y`). See `docs/spine/wires.yaml`.
+
+## Gate
+creating-work-item is HITL. Tickets start `open`. Work items start `ready`.

spine_cli-0.1.0/.cursor/skills/next/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: next
+description: Pick the next spine action from the map frontier and work-item board.
+---
+
+# next
+
+Run `spine doctor` then `spine status`. Take the first open unblocked unclaimed ticket, or the work item whose status is the next gate.
+
+```
+spine doctor
+spine status
+```
+
+Craft router (optional): `npx skills add mattpocock/skills -s ask-matt -s implement -y`.
+
+## Gate
+Respect HITL: do not `set-status` to `reviewing` verdicts or mint work items without a human if the contract marks them HITL.

spine_cli-0.1.0/.cursor/skills/review/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: review
+description: Review a software work item. Use when status is reviewing.
+---
+
+# review
+
+HITL verdict. Proof under `.spine/reviews/`. Pass:
+
+```
+spine set-status docs/spine/work-items/NN-slug.md done
+```
+
+Bounce:
+
+```
+spine set-status docs/spine/work-items/NN-slug.md changes-requested
+```
+
+Craft: `npx skills add mattpocock/skills -s code-review -y`.
+
+## Gate
+reviewing (HITL). Software profile requires this before done.

spine_cli-0.1.0/.cursor/skills/wayfind/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: wayfind
+description: Plan with a spine map and tickets. Use when the way to a destination is foggy or multi-session.
+---
+
+# wayfind
+
+Planning lives on the map, not on the work item. Load `docs/spine/maps/`, work frontier tickets under `docs/spine/tickets/`. Claim a ticket with the CLI before work.
+
+```
+spine status
+spine new ticket --title "..." --type research
+spine claim tickets/NN-slug.md
+```
+
+Do not vendor Wayfinder. Install craft from skills.sh: `npx skills add mattpocock/skills -s wayfinder -s grilling -s domain-modeling -y`.
+
+## Gate
+No work-item status for planning. Create a work item at `ready` only when the way is clear.

spine_cli-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+.venv/
+__pycache__/
+*.pyc
+.pytest_cache/
+.spine/
+dist/
+*.egg-info/

spine_cli-0.1.0/AGENTS.md

@@ -0,0 +1,16 @@
+# Implementation notes (this repo is also the first target)
+
+Implement spine from [spec.md](spec.md) plus this file. Product code lives here now.
+
+## Every session
+
+1. Read [spec.md](spec.md), [CONTEXT.md](CONTEXT.md).
+2. Verify: `uv run pytest`.
+3. CLI owns metadata; agents own content. Binder skills never restate the contract.
+4. Craft skills come from skills.sh (`npx skills add mattpocock/skills`), not vendored.
+
+## Standing constraints
+
+- Harness/agent/platform agnostic. No required plugin API.
+- Auto-evolve: `spine evolve`. Self-recover: `spine doctor`.
+- Do not edit `/Users/akshay/Development/generic-workflows`.

spine_cli-0.1.0/CONTEXT.md

@@ -0,0 +1,57 @@
+# Spine
+
+A public, harness-agnostic process spine. Planning and execution survive sessions as files in a target repo. This glossary is for the product; implementation detail does not belong here.
+
+## Language
+
+**Spine**:
+The toolkit: a versioned contract, a CLI that owns metadata, binder skills, and a doctor. Installed into a target.
+_Avoid_: Generic Workflows, plugin, pipeline-as-the-product
+
+**Target**:
+A git repository `spine` inits. Artifact files live here. They are the source of truth.
+_Avoid_: host, workspace (ambiguous with the agent’s cwd)
+
+**Map**:
+The durable planning artifact in the target: destination, notes, decisions-so-far, fog, out of scope. Tickets are its children.
+_Avoid_: board, PRD, roadmap
+
+**Ticket**:
+One decision or investigation on a map. Types: research, prototype, grilling, task.
+_Avoid_: issue (overloaded with work item), card
+
+**Work item**:
+The durable execution artifact: status, owner, claim, links, next gate.
+_Avoid_: task (overloaded with Wayfinder task tickets and Generic Workflows’ pipeline file), issue
+
+**Contract**:
+The versioned machine: statuses, transitions, gates, type profiles. Skills and the CLI reference it; they never restate it.
+_Avoid_: lifecycle.json as a proper noun, config, schema (too generic)
+
+**Binder**:
+Concern → skill routing. Skills never restate the contract.
+_Avoid_: router, catalog, palette (unless we later name the user-facing surface)
+
+**CLI**:
+Harness-agnostic command-line tool on PATH. It inits a target and is the only writer of machine-driving metadata.
+_Avoid_: plugin, hook, wf.py
+
+**Doctor**:
+A CLI command that reports mechanical drift and may auto-fix it. Not a harness hook.
+_Avoid_: health hook, UserPromptSubmit
+
+**Software profile**:
+A type profile on the same contract for code work (build / eval / review). Optional relative to the agnostic spine; in v1 spec.
+_Avoid_: the pipeline, 16-status machine
+
+**Claim**:
+Solo-first lock on a work item (owner + stale release) so a second agent or human does not require a rewrite.
+_Avoid_: assignee (tracker-specific), lock
+
+**Spec tier**:
+Checked-in artifact files in the target (maps, tickets, work items, decisions). Shared with clones.
+_Avoid_: source of truth (the whole target-file set is SSoT, including local execution files on that machine)
+
+**Execution tier**:
+Gitignored local files (claims runtime, evals, handoffs, doctor output). Not required for a clone to be correct, required for a running session to resume on that machine.
+_Avoid_: state, cache

spine_cli-0.1.0/HANDOFF.md

@@ -0,0 +1,21 @@
+# Handoff: spine implementation
+
+Last updated: 2026-09-19
+
+## Objective
+
+v1 spine-cli from spec.md. Auto-evolvable, skills.sh wires, Matt Pocock default pack, doctor recovery.
+
+## Current State
+
+Working CLI. `uv run pytest` — 19 passed. Wheel packs binder + contract.
+
+Software `checking → reviewing` needs `.spine/evals/` proof named for the item; `reviewing → done` needs `.spine/reviews/`. `spine wire --install` builds `npx skills add <pack> -s …` from `wires.yaml`. Doctor reports missing spec files (README, contract, wires, map) and gitignore drift (no auto-fix). Not published. GitHub not created.
+
+Builder queue (SpineDoctor/Binder/Evolve/Serial) died with Metal GPU OOM; do not parallel-spawn local Qwen for this tree.
+
+## Next Steps
+
+- Create `ASabale/spine` and publish `spine-cli` only when asked.
+- Do not edit generic-workflows.
+- One small builder at a time if using the local model.

spine_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ASabale
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTY OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.