intent-cli-python 1.0.0__tar.gz → 1.1.0__tar.gz

{intent_cli_python-1.0.0/src/intent_cli_python.egg-info → intent_cli_python-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: intent-cli-python
-Version: 1.0.0
+Version: 1.1.0
 Summary: Semantic history for agent-driven development. Records what you did and why.
 Author: Zeng Deyang
 License-Expression: MIT
@@ -30,6 +30,16 @@ Semantic history for agent-driven development. Records **what you did** and **wh
 
 Intent CLI gives AI agents a structured way to track goals, interactions, and decisions across sessions. Instead of losing context when a conversation ends, agents persist their understanding into three simple objects stored alongside your code.
 
+## Why
+
+Git records how code changes. But it doesn't record **why you're on this path**, what you decided along the way, or where you left off.
+
+Today that context lives in chat logs, PR threads, and your head. It works — until the session ends, the agent forgets, or a teammate picks up your work blind.
+
+Intent treats these as a missing layer: **semantic history**. Not more docs, not better commit messages — a small set of formal objects that capture goals, interactions, and decisions so they survive context loss.
+
+> The shift is simple: development is moving from *writing code* to *guiding agents and distilling decisions*. The history layer should reflect that.
+
 ## Three objects, one graph
 
 | Object | What it captures |
@@ -62,12 +72,18 @@ pip install intent-cli-python
 
 Requires Python 3.9+ and Git.
 
-### Add the Claude Code skill
+### Install the skills.sh skill
 
 ```bash
-npx skills add dozybot001/Intent
+npx skills add dozybot001/Intent -g
 ```
 
+This installs the `intent-cli` skill into your global skills library for supported agents such as Codex and Claude Code.
+
+> **Tip:** `itt` is a new tool — current models have never seen it in training data. Your agent may forget to call it mid-conversation. A short nudge like *"use itt to record this"* is usually enough to bring it back on track.
+>
+> This isn't busywork — every record is a **semantic asset**. An upcoming platform, **IntHub**, will turn these assets into searchable, shareable project intelligence.
+
 ## Quick start
 
 ```bash
@@ -101,13 +117,14 @@ itt inspect
 | `itt version` | Print version |
 | `itt init` | Initialize `.intent/` in current git repo |
 | `itt inspect` | Show the live object graph snapshot |
+| `itt doctor` | Validate the object graph for broken references and invalid states |
 
 ### Intent
 
 | Command | Description |
 |---|---|
 | `itt intent create TITLE --query Q` | Create a new intent |
-| `itt intent list [--status S]` | List intents |
+| `itt intent list [--status S] [--decision ID]` | List intents |
 | `itt intent show ID` | Show intent details |
 | `itt intent activate ID` | Resume a suspended intent |
 | `itt intent suspend ID` | Suspend an active intent |
@@ -128,7 +145,7 @@ itt inspect
 | Command | Description |
 |---|---|
 | `itt decision create TITLE --rationale R` | Create a long-lived decision |
-| `itt decision list [--status S]` | List decisions |
+| `itt decision list [--status S] [--intent ID]` | List decisions |
 | `itt decision show ID` | Show decision details |
 | `itt decision deprecate ID` | Deprecate a decision |
 | `itt decision attach ID --intent ID` | Manually link a decision to an intent |

{intent_cli_python-1.0.0 → intent_cli_python-1.1.0}/README.md

@@ -6,6 +6,16 @@ Semantic history for agent-driven development. Records **what you did** and **wh
 
 Intent CLI gives AI agents a structured way to track goals, interactions, and decisions across sessions. Instead of losing context when a conversation ends, agents persist their understanding into three simple objects stored alongside your code.
 
+## Why
+
+Git records how code changes. But it doesn't record **why you're on this path**, what you decided along the way, or where you left off.
+
+Today that context lives in chat logs, PR threads, and your head. It works — until the session ends, the agent forgets, or a teammate picks up your work blind.
+
+Intent treats these as a missing layer: **semantic history**. Not more docs, not better commit messages — a small set of formal objects that capture goals, interactions, and decisions so they survive context loss.
+
+> The shift is simple: development is moving from *writing code* to *guiding agents and distilling decisions*. The history layer should reflect that.
+
 ## Three objects, one graph
 
 | Object | What it captures |
@@ -38,12 +48,18 @@ pip install intent-cli-python
 
 Requires Python 3.9+ and Git.
 
-### Add the Claude Code skill
+### Install the skills.sh skill
 
 ```bash
-npx skills add dozybot001/Intent
+npx skills add dozybot001/Intent -g
 ```
 
+This installs the `intent-cli` skill into your global skills library for supported agents such as Codex and Claude Code.
+
+> **Tip:** `itt` is a new tool — current models have never seen it in training data. Your agent may forget to call it mid-conversation. A short nudge like *"use itt to record this"* is usually enough to bring it back on track.
+>
+> This isn't busywork — every record is a **semantic asset**. An upcoming platform, **IntHub**, will turn these assets into searchable, shareable project intelligence.
+
 ## Quick start
 
 ```bash
@@ -77,13 +93,14 @@ itt inspect
 | `itt version` | Print version |
 | `itt init` | Initialize `.intent/` in current git repo |
 | `itt inspect` | Show the live object graph snapshot |
+| `itt doctor` | Validate the object graph for broken references and invalid states |
 
 ### Intent
 
 | Command | Description |
 |---|---|
 | `itt intent create TITLE --query Q` | Create a new intent |
-| `itt intent list [--status S]` | List intents |
+| `itt intent list [--status S] [--decision ID]` | List intents |
 | `itt intent show ID` | Show intent details |
 | `itt intent activate ID` | Resume a suspended intent |
 | `itt intent suspend ID` | Suspend an active intent |
@@ -104,7 +121,7 @@ itt inspect
 | Command | Description |
 |---|---|
 | `itt decision create TITLE --rationale R` | Create a long-lived decision |
-| `itt decision list [--status S]` | List decisions |
+| `itt decision list [--status S] [--intent ID]` | List decisions |
 | `itt decision show ID` | Show decision details |
 | `itt decision deprecate ID` | Deprecate a decision |
 | `itt decision attach ID --intent ID` | Manually link a decision to an intent |

{intent_cli_python-1.0.0 → intent_cli_python-1.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "intent-cli-python"
-version = "1.0.0"
+version = "1.1.0"
 description = "Semantic history for agent-driven development. Records what you did and why."
 requires-python = ">=3.9"
 readme = "README.md"

intent_cli_python-1.1.0/src/intent_cli/__init__.py

@@ -0,0 +1,8 @@
+"""Intent CLI — semantic history for agent-driven development."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("intent-cli-python")
+except PackageNotFoundError:
+    __version__ = "0.0.0"

{intent_cli_python-1.0.0 → intent_cli_python-1.1.0}/src/intent_cli/cli.py

@@ -5,14 +5,14 @@ import json
 import sys
 from datetime import datetime, timezone
 
+from intent_cli import __version__
 from intent_cli.output import success, error
 from intent_cli.store import (
     git_root, ensure_init, init_workspace,
     next_id, read_object, write_object, list_objects, read_config,
+    validate_graph, VALID_STATUSES,
 )
 
-VERSION = "1.0.0"
-
 
 def _now():
     return datetime.now(timezone.utc).isoformat()
@@ -30,12 +30,25 @@ def _require_init():
           suggested_fix="itt init")
 
 
+def _validate_status_filter(object_type, status):
+    """Validate a --status filter against the object's state machine."""
+    if status is None:
+        return
+    allowed = sorted(VALID_STATUSES[object_type])
+    if status not in allowed:
+        error(
+            "INVALID_INPUT",
+            f"Invalid status '{status}' for {object_type}. Allowed values: {', '.join(allowed)}.",
+            suggested_fix=f"Use one of: {', '.join(allowed)}",
+        )
+
+
 # ---------------------------------------------------------------------------
 # Global commands
 # ---------------------------------------------------------------------------
 
 def cmd_version(_args):
-    success("version", {"version": VERSION})
+    success("version", {"version": __version__})
 
 
 def cmd_init(_args):
@@ -107,6 +120,11 @@ def cmd_inspect(_args):
     }, indent=2, ensure_ascii=False))
 
 
+def cmd_doctor(_args):
+    base = _require_init()
+    success("doctor", validate_graph(base))
+
+
 # ---------------------------------------------------------------------------
 # Intent commands
 # ---------------------------------------------------------------------------
@@ -145,7 +163,11 @@ def cmd_intent_create(args):
 
 def cmd_intent_list(args):
     base = _require_init()
-    success("intent.list", list_objects(base, "intent", status=args.status))
+    _validate_status_filter("intent", args.status)
+    objects = list_objects(base, "intent", status=args.status)
+    if args.decision:
+        objects = [obj for obj in objects if args.decision in obj.get("decision_ids", [])]
+    success("intent.list", objects)
 
 
 def cmd_intent_show(args):
@@ -249,6 +271,7 @@ def cmd_snap_create(args):
 
 def cmd_snap_list(args):
     base = _require_init()
+    _validate_status_filter("snap", args.status)
     objects = list_objects(base, "snap", status=args.status)
     if args.intent:
         objects = [s for s in objects if s.get("intent_id") == args.intent]
@@ -324,7 +347,11 @@ def cmd_decision_create(args):
 
 def cmd_decision_list(args):
     base = _require_init()
-    success("decision.list", list_objects(base, "decision", status=args.status))
+    _validate_status_filter("decision", args.status)
+    objects = list_objects(base, "decision", status=args.status)
+    if args.intent:
+        objects = [obj for obj in objects if args.intent in obj.get("intent_ids", [])]
+    success("decision.list", objects)
 
 
 def cmd_decision_show(args):
@@ -384,6 +411,7 @@ def main():
     sub.add_parser("version")
     sub.add_parser("init")
     sub.add_parser("inspect")
+    sub.add_parser("doctor")
 
     # --- intent ---
     p_intent = sub.add_parser("intent")
@@ -396,6 +424,7 @@ def main():
 
     p = s_intent.add_parser("list")
     p.add_argument("--status", default=None)
+    p.add_argument("--decision", default=None)
 
     p = s_intent.add_parser("show")
     p.add_argument("id")
@@ -445,6 +474,7 @@ def main():
 
     p = s_decision.add_parser("list")
     p.add_argument("--status", default=None)
+    p.add_argument("--intent", default=None)
 
     p = s_decision.add_parser("show")
     p.add_argument("id")
@@ -467,6 +497,7 @@ def main():
         "version": cmd_version,
         "init": cmd_init,
         "inspect": cmd_inspect,
+        "doctor": cmd_doctor,
     }
     if args.command in dispatch_global:
         dispatch_global[args.command](args)

intent_cli_python-1.1.0/src/intent_cli/store.py

@@ -0,0 +1,228 @@
+"""Storage layer — .intent/ directory I/O and ID generation."""
+
+import json
+import subprocess
+from pathlib import Path
+
+INTENT_DIR = ".intent"
+SUBDIRS = {"intent": "intents", "snap": "snaps", "decision": "decisions"}
+VALID_STATUSES = {
+    "intent": {"active", "suspend", "done"},
+    "snap": {"active", "reverted"},
+    "decision": {"active", "deprecated"},
+}
+
+
+def git_root():
+    """Return git repo root as Path, or None."""
+    try:
+        out = subprocess.run(
+            ["git", "rev-parse", "--show-toplevel"],
+            capture_output=True, text=True, check=True,
+        )
+        return Path(out.stdout.strip())
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        return None
+
+
+def intent_dir():
+    """Return Path to .intent/, or None if not in a git repo."""
+    root = git_root()
+    return root / INTENT_DIR if root else None
+
+
+def ensure_init():
+    """Return .intent/ Path if initialized, else None."""
+    d = intent_dir()
+    return d if d and d.is_dir() else None
+
+
+def init_workspace():
+    """Create .intent/ structure. Returns (path, error_code)."""
+    root = git_root()
+    if root is None:
+        return None, "GIT_STATE_INVALID"
+    d = root / INTENT_DIR
+    if d.is_dir():
+        return None, "ALREADY_EXISTS"
+    d.mkdir()
+    for sub in SUBDIRS.values():
+        (d / sub).mkdir()
+    (d / "config.json").write_text(json.dumps({"schema_version": "1.0"}, indent=2))
+    return d, None
+
+
+def next_id(base, object_type):
+    """Generate next zero-padded ID for a given object type."""
+    subdir = base / SUBDIRS[object_type]
+    max_num = 0
+    for f in subdir.glob(f"{object_type}-*.json"):
+        try:
+            num = int(f.stem.split("-", 1)[1])
+            max_num = max(max_num, num)
+        except (ValueError, IndexError):
+            continue
+    return f"{object_type}-{max_num + 1:03d}"
+
+
+def read_object(base, object_type, obj_id):
+    """Read object JSON by ID. Returns dict or None."""
+    path = base / SUBDIRS[object_type] / f"{obj_id}.json"
+    if not path.is_file():
+        return None
+    return json.loads(path.read_text())
+
+
+def write_object(base, object_type, obj_id, data):
+    """Write object dict to JSON file."""
+    path = base / SUBDIRS[object_type] / f"{obj_id}.json"
+    path.write_text(json.dumps(data, indent=2, ensure_ascii=False))
+
+
+def list_objects(base, object_type, status=None):
+    """List all objects of a type, optionally filtered by status."""
+    subdir = base / SUBDIRS[object_type]
+    result = []
+    for f in sorted(subdir.glob(f"{object_type}-*.json")):
+        obj = json.loads(f.read_text())
+        if status is None or obj.get("status") == status:
+            result.append(obj)
+    return result
+
+
+def read_config(base):
+    """Read config.json. Returns dict."""
+    return json.loads((base / "config.json").read_text())
+
+
+def validate_graph(base):
+    """Validate the object graph and return a structured report."""
+    config = read_config(base)
+    intents = {obj["id"]: obj for obj in list_objects(base, "intent")}
+    snaps = {obj["id"]: obj for obj in list_objects(base, "snap")}
+    decisions = {obj["id"]: obj for obj in list_objects(base, "decision")}
+    issues = []
+
+    if config.get("schema_version") != "1.0":
+        issues.append({
+            "code": "SCHEMA_VERSION_MISMATCH",
+            "object": "config",
+            "id": "config.json",
+            "message": f"Unsupported schema_version '{config.get('schema_version')}'. Expected '1.0'.",
+        })
+
+    def add_issue(code, object_type, obj_id, message):
+        issues.append({
+            "code": code,
+            "object": object_type,
+            "id": obj_id,
+            "message": message,
+        })
+
+    for object_type, objects in (
+        ("intent", intents),
+        ("snap", snaps),
+        ("decision", decisions),
+    ):
+        for obj_id, obj in objects.items():
+            if obj.get("object") != object_type:
+                add_issue(
+                    "OBJECT_TYPE_MISMATCH",
+                    object_type,
+                    obj_id,
+                    f"Stored object type is '{obj.get('object')}', expected '{object_type}'.",
+                )
+            status = obj.get("status")
+            if status not in VALID_STATUSES[object_type]:
+                add_issue(
+                    "INVALID_STATUS",
+                    object_type,
+                    obj_id,
+                    f"Invalid status '{status}' for {object_type}.",
+                )
+
+    for intent_id, intent in intents.items():
+        for snap_id in intent.get("snap_ids", []):
+            snap = snaps.get(snap_id)
+            if snap is None:
+                add_issue(
+                    "MISSING_REFERENCE",
+                    "intent",
+                    intent_id,
+                    f"References missing snap {snap_id} in snap_ids.",
+                )
+                continue
+            if snap.get("intent_id") != intent_id:
+                add_issue(
+                    "BROKEN_LINK",
+                    "intent",
+                    intent_id,
+                    f"Snap {snap_id} points to intent {snap.get('intent_id')}, not {intent_id}.",
+                )
+        for decision_id in intent.get("decision_ids", []):
+            decision = decisions.get(decision_id)
+            if decision is None:
+                add_issue(
+                    "MISSING_REFERENCE",
+                    "intent",
+                    intent_id,
+                    f"References missing decision {decision_id} in decision_ids.",
+                )
+                continue
+            if intent_id not in decision.get("intent_ids", []):
+                add_issue(
+                    "BROKEN_LINK",
+                    "intent",
+                    intent_id,
+                    f"Decision {decision_id} does not link back to this intent.",
+                )
+
+    for snap_id, snap in snaps.items():
+        intent_id = snap.get("intent_id")
+        intent = intents.get(intent_id)
+        if intent is None:
+            add_issue(
+                "MISSING_REFERENCE",
+                "snap",
+                snap_id,
+                f"Points to missing intent {intent_id}.",
+            )
+            continue
+        if snap_id not in intent.get("snap_ids", []):
+            add_issue(
+                "BROKEN_LINK",
+                "snap",
+                snap_id,
+                f"Intent {intent_id} does not include this snap in snap_ids.",
+            )
+
+    for decision_id, decision in decisions.items():
+        for intent_id in decision.get("intent_ids", []):
+            intent = intents.get(intent_id)
+            if intent is None:
+                add_issue(
+                    "MISSING_REFERENCE",
+                    "decision",
+                    decision_id,
+                    f"References missing intent {intent_id} in intent_ids.",
+                )
+                continue
+            if decision_id not in intent.get("decision_ids", []):
+                add_issue(
+                    "BROKEN_LINK",
+                    "decision",
+                    decision_id,
+                    f"Intent {intent_id} does not link back to this decision.",
+                )
+
+    return {
+        "healthy": not issues,
+        "issue_count": len(issues),
+        "summary": {
+            "schema_version": config.get("schema_version", "1.0"),
+            "intent_count": len(intents),
+            "snap_count": len(snaps),
+            "decision_count": len(decisions),
+        },
+        "issues": issues,
+    }

{intent_cli_python-1.0.0 → intent_cli_python-1.1.0/src/intent_cli_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: intent-cli-python
-Version: 1.0.0
+Version: 1.1.0
 Summary: Semantic history for agent-driven development. Records what you did and why.
 Author: Zeng Deyang
 License-Expression: MIT
@@ -30,6 +30,16 @@ Semantic history for agent-driven development. Records **what you did** and **wh
 
 Intent CLI gives AI agents a structured way to track goals, interactions, and decisions across sessions. Instead of losing context when a conversation ends, agents persist their understanding into three simple objects stored alongside your code.
 
+## Why
+
+Git records how code changes. But it doesn't record **why you're on this path**, what you decided along the way, or where you left off.
+
+Today that context lives in chat logs, PR threads, and your head. It works — until the session ends, the agent forgets, or a teammate picks up your work blind.
+
+Intent treats these as a missing layer: **semantic history**. Not more docs, not better commit messages — a small set of formal objects that capture goals, interactions, and decisions so they survive context loss.
+
+> The shift is simple: development is moving from *writing code* to *guiding agents and distilling decisions*. The history layer should reflect that.
+
 ## Three objects, one graph
 
 | Object | What it captures |
@@ -62,12 +72,18 @@ pip install intent-cli-python
 
 Requires Python 3.9+ and Git.
 
-### Add the Claude Code skill
+### Install the skills.sh skill
 
 ```bash
-npx skills add dozybot001/Intent
+npx skills add dozybot001/Intent -g
 ```
 
+This installs the `intent-cli` skill into your global skills library for supported agents such as Codex and Claude Code.
+
+> **Tip:** `itt` is a new tool — current models have never seen it in training data. Your agent may forget to call it mid-conversation. A short nudge like *"use itt to record this"* is usually enough to bring it back on track.
+>
+> This isn't busywork — every record is a **semantic asset**. An upcoming platform, **IntHub**, will turn these assets into searchable, shareable project intelligence.
+
 ## Quick start
 
 ```bash
@@ -101,13 +117,14 @@ itt inspect
 | `itt version` | Print version |
 | `itt init` | Initialize `.intent/` in current git repo |
 | `itt inspect` | Show the live object graph snapshot |
+| `itt doctor` | Validate the object graph for broken references and invalid states |
 
 ### Intent
 
 | Command | Description |
 |---|---|
 | `itt intent create TITLE --query Q` | Create a new intent |
-| `itt intent list [--status S]` | List intents |
+| `itt intent list [--status S] [--decision ID]` | List intents |
 | `itt intent show ID` | Show intent details |
 | `itt intent activate ID` | Resume a suspended intent |
 | `itt intent suspend ID` | Suspend an active intent |
@@ -128,7 +145,7 @@ itt inspect
 | Command | Description |
 |---|---|
 | `itt decision create TITLE --rationale R` | Create a long-lived decision |
-| `itt decision list [--status S]` | List decisions |
+| `itt decision list [--status S] [--intent ID]` | List decisions |
 | `itt decision show ID` | Show decision details |
 | `itt decision deprecate ID` | Deprecate a decision |
 | `itt decision attach ID --intent ID` | Manually link a decision to an intent |

{intent_cli_python-1.0.0 → intent_cli_python-1.1.0}/tests/test_cli.py

@@ -1,9 +1,11 @@
-"""Tests for Intent CLI — covers all 19 commands, state machines, and error codes."""
+"""Tests for Intent CLI — covers all 20 commands, state machines, and error codes."""
 
 import json
 import os
 import subprocess
+import sys
 import tempfile
+from importlib import metadata
 from pathlib import Path
 
 import pytest
@@ -25,7 +27,7 @@ def workspace(tmp_path):
 def _run(cwd, *args):
     """Run itt command and return parsed JSON."""
     r = subprocess.run(
-        ["itt", *args],
+        [sys.executable, "-m", "intent_cli", *args],
         cwd=cwd, capture_output=True, text=True,
     )
     return json.loads(r.stdout)
@@ -39,7 +41,7 @@ class TestGlobal:
     def test_version(self, workspace):
         r = _run(workspace, "version")
         assert r["ok"] is True
-        assert "version" in r["result"]
+        assert r["result"]["version"] == metadata.version("intent-cli-python")
 
     def test_init_already_exists(self, workspace):
         r = _run(workspace, "init")
@@ -68,6 +70,12 @@ class TestGlobal:
         assert r["ok"] is False
         assert r["error"]["code"] == "NOT_INITIALIZED"
 
+    def test_doctor_healthy(self, workspace):
+        r = _run(workspace, "doctor")
+        assert r["ok"] is True
+        assert r["result"]["healthy"] is True
+        assert r["result"]["issue_count"] == 0
+
 
 # ---------------------------------------------------------------------------
 # Intent commands
@@ -101,6 +109,20 @@ class TestIntent:
         assert len(r["result"]) == 1
         assert r["result"][0]["id"] == "intent-002"
 
+    def test_list_filter_decision(self, workspace):
+        _run(workspace, "intent", "create", "A", "--query", "q")
+        _run(workspace, "intent", "create", "B", "--query", "q")
+        _run(workspace, "decision", "create", "Rule", "--rationale", "r")
+        _run(workspace, "decision", "deprecate", "decision-001")
+        _run(workspace, "decision", "create", "Rule 2", "--rationale", "r")
+        r = _run(workspace, "intent", "list", "--decision", "decision-001")
+        assert len(r["result"]) == 2
+
+    def test_list_invalid_status(self, workspace):
+        r = _run(workspace, "intent", "list", "--status", "paused")
+        assert r["ok"] is False
+        assert r["error"]["code"] == "INVALID_INPUT"
+
     def test_show(self, workspace):
         _run(workspace, "intent", "create", "A", "--query", "q")
         r = _run(workspace, "intent", "show", "intent-001")
@@ -188,6 +210,11 @@ class TestSnap:
         assert len(r["result"]) == 1
         assert r["result"][0]["id"] == "snap-002"
 
+    def test_list_invalid_status(self, workspace):
+        r = _run(workspace, "snap", "list", "--status", "done")
+        assert r["ok"] is False
+        assert r["error"]["code"] == "INVALID_INPUT"
+
     def test_feedback(self, workspace):
         _run(workspace, "intent", "create", "Goal", "--query", "q")
         _run(workspace, "snap", "create", "S", "--intent", "intent-001")
@@ -240,6 +267,22 @@ class TestDecision:
         r = _run(workspace, "decision", "list")
         assert len(r["result"]) == 2
 
+    def test_list_filter_intent(self, workspace):
+        _run(workspace, "intent", "create", "A", "--query", "q")
+        _run(workspace, "intent", "create", "B", "--query", "q")
+        _run(workspace, "decision", "create", "Rule A", "--rationale", "r")
+        _run(workspace, "decision", "deprecate", "decision-001")
+        _run(workspace, "intent", "done", "intent-002")
+        _run(workspace, "decision", "create", "Rule B", "--rationale", "r")
+        r = _run(workspace, "decision", "list", "--intent", "intent-002")
+        assert len(r["result"]) == 1
+        assert r["result"][0]["id"] == "decision-001"
+
+    def test_list_invalid_status(self, workspace):
+        r = _run(workspace, "decision", "list", "--status", "activeish")
+        assert r["ok"] is False
+        assert r["error"]["code"] == "INVALID_INPUT"
+
     def test_deprecate(self, workspace):
         _run(workspace, "decision", "create", "R", "--rationale", "r")
         r = _run(workspace, "decision", "deprecate", "decision-001")
@@ -302,3 +345,24 @@ class TestInspect:
         intent_file.unlink()
         r = _run(workspace, "inspect")
         assert any("Orphan" in w for w in r["warnings"])
+
+    def test_doctor_reports_broken_links(self, workspace):
+        _run(workspace, "intent", "create", "Goal", "--query", "q")
+        _run(workspace, "snap", "create", "S", "--intent", "intent-001")
+        snap_file = workspace / ".intent" / "snaps" / "snap-001.json"
+        data = json.loads(snap_file.read_text())
+        data["intent_id"] = "intent-999"
+        snap_file.write_text(json.dumps(data, indent=2))
+        r = _run(workspace, "doctor")
+        assert r["result"]["healthy"] is False
+        assert any(issue["code"] == "MISSING_REFERENCE" for issue in r["result"]["issues"])
+
+    def test_doctor_reports_invalid_status(self, workspace):
+        _run(workspace, "intent", "create", "Goal", "--query", "q")
+        intent_file = workspace / ".intent" / "intents" / "intent-001.json"
+        data = json.loads(intent_file.read_text())
+        data["status"] = "paused"
+        intent_file.write_text(json.dumps(data, indent=2))
+        r = _run(workspace, "doctor")
+        assert r["result"]["healthy"] is False
+        assert any(issue["code"] == "INVALID_STATUS" for issue in r["result"]["issues"])

intent_cli_python-1.0.0/src/intent_cli/__init__.py

@@ -1 +0,0 @@
-"""Intent CLI — semantic history for agent-driven development."""

intent_cli_python-1.0.0/src/intent_cli/store.py

@@ -1,90 +0,0 @@
-"""Storage layer — .intent/ directory I/O and ID generation."""
-
-import json
-import subprocess
-from pathlib import Path
-
-INTENT_DIR = ".intent"
-SUBDIRS = {"intent": "intents", "snap": "snaps", "decision": "decisions"}
-
-
-def git_root():
-    """Return git repo root as Path, or None."""
-    try:
-        out = subprocess.run(
-            ["git", "rev-parse", "--show-toplevel"],
-            capture_output=True, text=True, check=True,
-        )
-        return Path(out.stdout.strip())
-    except (subprocess.CalledProcessError, FileNotFoundError):
-        return None
-
-
-def intent_dir():
-    """Return Path to .intent/, or None if not in a git repo."""
-    root = git_root()
-    return root / INTENT_DIR if root else None
-
-
-def ensure_init():
-    """Return .intent/ Path if initialized, else None."""
-    d = intent_dir()
-    return d if d and d.is_dir() else None
-
-
-def init_workspace():
-    """Create .intent/ structure. Returns (path, error_code)."""
-    root = git_root()
-    if root is None:
-        return None, "GIT_STATE_INVALID"
-    d = root / INTENT_DIR
-    if d.is_dir():
-        return None, "ALREADY_EXISTS"
-    d.mkdir()
-    for sub in SUBDIRS.values():
-        (d / sub).mkdir()
-    (d / "config.json").write_text(json.dumps({"schema_version": "1.0"}, indent=2))
-    return d, None
-
-
-def next_id(base, object_type):
-    """Generate next zero-padded ID for a given object type."""
-    subdir = base / SUBDIRS[object_type]
-    max_num = 0
-    for f in subdir.glob(f"{object_type}-*.json"):
-        try:
-            num = int(f.stem.split("-", 1)[1])
-            max_num = max(max_num, num)
-        except (ValueError, IndexError):
-            continue
-    return f"{object_type}-{max_num + 1:03d}"
-
-
-def read_object(base, object_type, obj_id):
-    """Read object JSON by ID. Returns dict or None."""
-    path = base / SUBDIRS[object_type] / f"{obj_id}.json"
-    if not path.is_file():
-        return None
-    return json.loads(path.read_text())
-
-
-def write_object(base, object_type, obj_id, data):
-    """Write object dict to JSON file."""
-    path = base / SUBDIRS[object_type] / f"{obj_id}.json"
-    path.write_text(json.dumps(data, indent=2, ensure_ascii=False))
-
-
-def list_objects(base, object_type, status=None):
-    """List all objects of a type, optionally filtered by status."""
-    subdir = base / SUBDIRS[object_type]
-    result = []
-    for f in sorted(subdir.glob(f"{object_type}-*.json")):
-        obj = json.loads(f.read_text())
-        if status is None or obj.get("status") == status:
-            result.append(obj)
-    return result
-
-
-def read_config(base):
-    """Read config.json. Returns dict."""
-    return json.loads((base / "config.json").read_text())