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

{intent_cli_python-0.6.0 → intent_cli_python-1.0.0}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: intent-cli-python
-Version: 0.6.0
+Version: 1.0.0
 Summary: Semantic history for agent-driven development. Records what you did and why.
 Author: Zeng Deyang
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/dozybot001/Intent
 Project-URL: Repository, https://github.com/dozybot001/Intent
 Keywords: agent,git,semantic-history,intent,developer-tools
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
@@ -40,14 +40,34 @@ Intent CLI gives AI agents a structured way to track goals, interactions, and de
 
 Objects link automatically: creating an intent attaches all active decisions; creating a decision attaches all active intents. Relationships are always bidirectional and append-only.
 
+### How decisions are created
+
+Decisions require human involvement. Two paths:
+
+- **Explicit**: include `decision-[text]` (or `决定-[text]`) in your query and the agent creates it directly. E.g. "decision-all API responses use envelope format"
+- **Agent-proposed**: the agent spots a potential long-term constraint in conversation and asks you to confirm before recording it
+
 ## Install
 
 ```bash
+# Clone the repository
+git clone https://github.com/dozybot001/Intent.git
+
+# Install the CLI (pipx recommended)
+pipx install intent-cli-python
+
+# Or using pip
 pip install intent-cli-python
 ```
 
 Requires Python 3.9+ and Git.
 
+### Add the Claude Code skill
+
+```bash
+npx skills add dozybot001/Intent
+```
+
 ## Quick start
 
 ```bash
@@ -136,6 +156,12 @@ All data lives in `.intent/` at your git repo root:
     decision-001.json
 ```
 
+## Docs
+
+- [Vision](docs/EN/vision.md) — why semantic history matters. **If this project interests you, start here.**
+- [CLI Design](docs/EN/cli.md) — object model, commands, JSON contract
+- [Roadmap](docs/EN/roadmap.md) — phase plan
+
 ## License
 
 MIT

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

@@ -16,14 +16,34 @@ Intent CLI gives AI agents a structured way to track goals, interactions, and de
 
 Objects link automatically: creating an intent attaches all active decisions; creating a decision attaches all active intents. Relationships are always bidirectional and append-only.
 
+### How decisions are created
+
+Decisions require human involvement. Two paths:
+
+- **Explicit**: include `decision-[text]` (or `决定-[text]`) in your query and the agent creates it directly. E.g. "decision-all API responses use envelope format"
+- **Agent-proposed**: the agent spots a potential long-term constraint in conversation and asks you to confirm before recording it
+
 ## Install
 
 ```bash
+# Clone the repository
+git clone https://github.com/dozybot001/Intent.git
+
+# Install the CLI (pipx recommended)
+pipx install intent-cli-python
+
+# Or using pip
 pip install intent-cli-python
 ```
 
 Requires Python 3.9+ and Git.
 
+### Add the Claude Code skill
+
+```bash
+npx skills add dozybot001/Intent
+```
+
 ## Quick start
 
 ```bash
@@ -112,6 +132,12 @@ All data lives in `.intent/` at your git repo root:
     decision-001.json
 ```
 
+## Docs
+
+- [Vision](docs/EN/vision.md) — why semantic history matters. **If this project interests you, start here.**
+- [CLI Design](docs/EN/cli.md) — object model, commands, JSON contract
+- [Roadmap](docs/EN/roadmap.md) — phase plan
+
 ## License
 
 MIT

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "intent-cli-python"
-version = "0.6.0"
+version = "1.0.0"
 description = "Semantic history for agent-driven development. Records what you did and why."
 requires-python = ">=3.9"
 readme = "README.md"
@@ -14,7 +14,7 @@ authors = [
 ]
 keywords = ["agent", "git", "semantic-history", "intent", "developer-tools"]
 classifiers = [
-    "Development Status :: 4 - Beta",
+    "Development Status :: 5 - Production/Stable",
     "Environment :: Console",
     "Intended Audience :: Developers",
     "Programming Language :: Python :: 3",

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

@@ -11,7 +11,7 @@ from intent_cli.store import (
     next_id, read_object, write_object, list_objects, read_config,
 )
 
-VERSION = "0.6.0"
+VERSION = "1.0.0"
 
 
 def _now():
@@ -98,7 +98,7 @@ def cmd_inspect(_args):
 
     print(json.dumps({
         "ok": True,
-        "schema_version": config.get("schema_version", "0.6"),
+        "schema_version": config.get("schema_version", "1.0"),
         "active_intents": active_intents,
         "suspend_intents": suspend_intents,
         "active_decisions": active_decisions,
@@ -129,6 +129,7 @@ def cmd_intent_create(args):
         "title": args.title,
         "status": "active",
         "source_query": args.query,
+        "rationale": args.rationale,
         "decision_ids": decision_ids,
         "snap_ids": [],
     }
@@ -234,6 +235,7 @@ def cmd_snap_create(args):
         "status": "active",
         "intent_id": intent_id,
         "query": args.query,
+        "rationale": args.rationale,
         "summary": args.summary,
         "feedback": args.feedback,
     }
@@ -390,6 +392,7 @@ def main():
     p = s_intent.add_parser("create")
     p.add_argument("title")
     p.add_argument("--query", default="")
+    p.add_argument("--rationale", default="")
 
     p = s_intent.add_parser("list")
     p.add_argument("--status", default=None)
@@ -414,6 +417,7 @@ def main():
     p.add_argument("title")
     p.add_argument("--intent", required=True)
     p.add_argument("--query", default="")
+    p.add_argument("--rationale", default="")
     p.add_argument("--summary", default="")
     p.add_argument("--feedback", default="")
 

{intent_cli_python-0.6.0 → intent_cli_python-1.0.0}/src/intent_cli/store.py

@@ -43,7 +43,7 @@ def init_workspace():
     d.mkdir()
     for sub in SUBDIRS.values():
         (d / sub).mkdir()
-    (d / "config.json").write_text(json.dumps({"schema_version": "0.6"}, indent=2))
+    (d / "config.json").write_text(json.dumps({"schema_version": "1.0"}, indent=2))
     return d, None
 
 

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

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: intent-cli-python
-Version: 0.6.0
+Version: 1.0.0
 Summary: Semantic history for agent-driven development. Records what you did and why.
 Author: Zeng Deyang
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/dozybot001/Intent
 Project-URL: Repository, https://github.com/dozybot001/Intent
 Keywords: agent,git,semantic-history,intent,developer-tools
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
@@ -40,14 +40,34 @@ Intent CLI gives AI agents a structured way to track goals, interactions, and de
 
 Objects link automatically: creating an intent attaches all active decisions; creating a decision attaches all active intents. Relationships are always bidirectional and append-only.
 
+### How decisions are created
+
+Decisions require human involvement. Two paths:
+
+- **Explicit**: include `decision-[text]` (or `决定-[text]`) in your query and the agent creates it directly. E.g. "decision-all API responses use envelope format"
+- **Agent-proposed**: the agent spots a potential long-term constraint in conversation and asks you to confirm before recording it
+
 ## Install
 
 ```bash
+# Clone the repository
+git clone https://github.com/dozybot001/Intent.git
+
+# Install the CLI (pipx recommended)
+pipx install intent-cli-python
+
+# Or using pip
 pip install intent-cli-python
 ```
 
 Requires Python 3.9+ and Git.
 
+### Add the Claude Code skill
+
+```bash
+npx skills add dozybot001/Intent
+```
+
 ## Quick start
 
 ```bash
@@ -136,6 +156,12 @@ All data lives in `.intent/` at your git repo root:
     decision-001.json
 ```
 
+## Docs
+
+- [Vision](docs/EN/vision.md) — why semantic history matters. **If this project interests you, start here.**
+- [CLI Design](docs/EN/cli.md) — object model, commands, JSON contract
+- [Roadmap](docs/EN/roadmap.md) — phase plan
+
 ## License
 
 MIT

{intent_cli_python-0.6.0 → intent_cli_python-1.0.0}/src/intent_cli_python.egg-info/SOURCES.txt

@@ -10,4 +10,5 @@ src/intent_cli_python.egg-info/PKG-INFO
 src/intent_cli_python.egg-info/SOURCES.txt
 src/intent_cli_python.egg-info/dependency_links.txt
 src/intent_cli_python.egg-info/entry_points.txt
-src/intent_cli_python.egg-info/top_level.txt
+src/intent_cli_python.egg-info/top_level.txt
+tests/test_cli.py

intent_cli_python-1.0.0/tests/test_cli.py

@@ -0,0 +1,304 @@
+"""Tests for Intent CLI — covers all 19 commands, state machines, and error codes."""
+
+import json
+import os
+import subprocess
+import tempfile
+from pathlib import Path
+
+import pytest
+
+
+@pytest.fixture
+def workspace(tmp_path):
+    """Create a git repo with .intent/ initialized."""
+    subprocess.run(["git", "init"], cwd=tmp_path, capture_output=True, check=True)
+    subprocess.run(
+        ["git", "commit", "--allow-empty", "-m", "init"],
+        cwd=tmp_path, capture_output=True, check=True,
+    )
+    result = _run(tmp_path, "init")
+    assert result["ok"] is True
+    return tmp_path
+
+
+def _run(cwd, *args):
+    """Run itt command and return parsed JSON."""
+    r = subprocess.run(
+        ["itt", *args],
+        cwd=cwd, capture_output=True, text=True,
+    )
+    return json.loads(r.stdout)
+
+
+# ---------------------------------------------------------------------------
+# Global commands
+# ---------------------------------------------------------------------------
+
+class TestGlobal:
+    def test_version(self, workspace):
+        r = _run(workspace, "version")
+        assert r["ok"] is True
+        assert "version" in r["result"]
+
+    def test_init_already_exists(self, workspace):
+        r = _run(workspace, "init")
+        assert r["ok"] is False
+        assert r["error"]["code"] == "ALREADY_EXISTS"
+
+    def test_init_not_git(self, tmp_path):
+        r = _run(tmp_path, "init")
+        assert r["ok"] is False
+        assert r["error"]["code"] == "GIT_STATE_INVALID"
+
+    def test_inspect_empty(self, workspace):
+        r = _run(workspace, "inspect")
+        assert r["ok"] is True
+        assert r["active_intents"] == []
+        assert r["active_decisions"] == []
+        assert r["recent_snaps"] == []
+
+    def test_not_initialized(self, tmp_path):
+        subprocess.run(["git", "init"], cwd=tmp_path, capture_output=True, check=True)
+        subprocess.run(
+            ["git", "commit", "--allow-empty", "-m", "init"],
+            cwd=tmp_path, capture_output=True, check=True,
+        )
+        r = _run(tmp_path, "inspect")
+        assert r["ok"] is False
+        assert r["error"]["code"] == "NOT_INITIALIZED"
+
+
+# ---------------------------------------------------------------------------
+# Intent commands
+# ---------------------------------------------------------------------------
+
+class TestIntent:
+    def test_create(self, workspace):
+        r = _run(workspace, "intent", "create", "Fix bug", "--query", "why crash?")
+        assert r["ok"] is True
+        assert r["result"]["id"] == "intent-001"
+        assert r["result"]["status"] == "active"
+        assert r["result"]["source_query"] == "why crash?"
+
+    def test_create_auto_attaches_decisions(self, workspace):
+        _run(workspace, "intent", "create", "Goal A", "--query", "q")
+        _run(workspace, "decision", "create", "Rule 1", "--rationale", "r")
+        r = _run(workspace, "intent", "create", "Goal B", "--query", "q")
+        assert "decision-001" in r["result"]["decision_ids"]
+
+    def test_list(self, workspace):
+        _run(workspace, "intent", "create", "A", "--query", "q")
+        _run(workspace, "intent", "create", "B", "--query", "q")
+        r = _run(workspace, "intent", "list")
+        assert len(r["result"]) == 2
+
+    def test_list_filter_status(self, workspace):
+        _run(workspace, "intent", "create", "A", "--query", "q")
+        _run(workspace, "intent", "create", "B", "--query", "q")
+        _run(workspace, "intent", "suspend", "intent-001")
+        r = _run(workspace, "intent", "list", "--status", "active")
+        assert len(r["result"]) == 1
+        assert r["result"][0]["id"] == "intent-002"
+
+    def test_show(self, workspace):
+        _run(workspace, "intent", "create", "A", "--query", "q")
+        r = _run(workspace, "intent", "show", "intent-001")
+        assert r["result"]["title"] == "A"
+
+    def test_show_not_found(self, workspace):
+        r = _run(workspace, "intent", "show", "intent-999")
+        assert r["error"]["code"] == "OBJECT_NOT_FOUND"
+
+    def test_suspend_activate(self, workspace):
+        _run(workspace, "intent", "create", "A", "--query", "q")
+        r = _run(workspace, "intent", "suspend", "intent-001")
+        assert r["result"]["status"] == "suspend"
+        r = _run(workspace, "intent", "activate", "intent-001")
+        assert r["result"]["status"] == "active"
+
+    def test_activate_catches_up_decisions(self, workspace):
+        _run(workspace, "intent", "create", "A", "--query", "q")
+        _run(workspace, "intent", "suspend", "intent-001")
+        _run(workspace, "decision", "create", "New rule", "--rationale", "r")
+        r = _run(workspace, "intent", "activate", "intent-001")
+        assert "decision-001" in r["result"]["decision_ids"]
+
+    def test_done(self, workspace):
+        _run(workspace, "intent", "create", "A", "--query", "q")
+        r = _run(workspace, "intent", "done", "intent-001")
+        assert r["result"]["status"] == "done"
+
+    def test_done_is_terminal(self, workspace):
+        _run(workspace, "intent", "create", "A", "--query", "q")
+        _run(workspace, "intent", "done", "intent-001")
+        r = _run(workspace, "intent", "activate", "intent-001")
+        assert r["error"]["code"] == "STATE_CONFLICT"
+
+    def test_suspend_only_active(self, workspace):
+        _run(workspace, "intent", "create", "A", "--query", "q")
+        _run(workspace, "intent", "done", "intent-001")
+        r = _run(workspace, "intent", "suspend", "intent-001")
+        assert r["error"]["code"] == "STATE_CONFLICT"
+
+
+# ---------------------------------------------------------------------------
+# Snap commands
+# ---------------------------------------------------------------------------
+
+class TestSnap:
+    def test_create(self, workspace):
+        _run(workspace, "intent", "create", "Goal", "--query", "q")
+        r = _run(workspace, "snap", "create", "Did X", "--intent", "intent-001",
+                 "--summary", "details")
+        assert r["ok"] is True
+        assert r["result"]["id"] == "snap-001"
+        assert r["result"]["intent_id"] == "intent-001"
+
+    def test_create_updates_intent_snap_ids(self, workspace):
+        _run(workspace, "intent", "create", "Goal", "--query", "q")
+        _run(workspace, "snap", "create", "S1", "--intent", "intent-001")
+        _run(workspace, "snap", "create", "S2", "--intent", "intent-001")
+        r = _run(workspace, "intent", "show", "intent-001")
+        assert r["result"]["snap_ids"] == ["snap-001", "snap-002"]
+
+    def test_create_requires_active_intent(self, workspace):
+        _run(workspace, "intent", "create", "Goal", "--query", "q")
+        _run(workspace, "intent", "done", "intent-001")
+        r = _run(workspace, "snap", "create", "S", "--intent", "intent-001")
+        assert r["error"]["code"] == "STATE_CONFLICT"
+
+    def test_create_intent_not_found(self, workspace):
+        r = _run(workspace, "snap", "create", "S", "--intent", "intent-999")
+        assert r["error"]["code"] == "OBJECT_NOT_FOUND"
+
+    def test_list(self, workspace):
+        _run(workspace, "intent", "create", "Goal", "--query", "q")
+        _run(workspace, "snap", "create", "S1", "--intent", "intent-001")
+        _run(workspace, "snap", "create", "S2", "--intent", "intent-001")
+        r = _run(workspace, "snap", "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, "snap", "create", "S1", "--intent", "intent-001")
+        _run(workspace, "snap", "create", "S2", "--intent", "intent-002")
+        r = _run(workspace, "snap", "list", "--intent", "intent-002")
+        assert len(r["result"]) == 1
+        assert r["result"][0]["id"] == "snap-002"
+
+    def test_feedback(self, workspace):
+        _run(workspace, "intent", "create", "Goal", "--query", "q")
+        _run(workspace, "snap", "create", "S", "--intent", "intent-001")
+        r = _run(workspace, "snap", "feedback", "snap-001", "looks good")
+        assert r["result"]["feedback"] == "looks good"
+
+    def test_feedback_overwrites(self, workspace):
+        _run(workspace, "intent", "create", "Goal", "--query", "q")
+        _run(workspace, "snap", "create", "S", "--intent", "intent-001")
+        _run(workspace, "snap", "feedback", "snap-001", "first")
+        r = _run(workspace, "snap", "feedback", "snap-001", "second")
+        assert r["result"]["feedback"] == "second"
+
+    def test_revert(self, workspace):
+        _run(workspace, "intent", "create", "Goal", "--query", "q")
+        _run(workspace, "snap", "create", "S", "--intent", "intent-001")
+        r = _run(workspace, "snap", "revert", "snap-001")
+        assert r["result"]["status"] == "reverted"
+
+    def test_revert_is_terminal(self, workspace):
+        _run(workspace, "intent", "create", "Goal", "--query", "q")
+        _run(workspace, "snap", "create", "S", "--intent", "intent-001")
+        _run(workspace, "snap", "revert", "snap-001")
+        r = _run(workspace, "snap", "revert", "snap-001")
+        assert r["error"]["code"] == "STATE_CONFLICT"
+
+
+# ---------------------------------------------------------------------------
+# Decision commands
+# ---------------------------------------------------------------------------
+
+class TestDecision:
+    def test_create(self, workspace):
+        r = _run(workspace, "decision", "create", "Rule", "--rationale", "reason")
+        assert r["ok"] is True
+        assert r["result"]["id"] == "decision-001"
+        assert r["result"]["status"] == "active"
+
+    def test_create_auto_attaches_intents(self, workspace):
+        _run(workspace, "intent", "create", "A", "--query", "q")
+        r = _run(workspace, "decision", "create", "Rule", "--rationale", "r")
+        assert "intent-001" in r["result"]["intent_ids"]
+        # Verify bidirectional
+        i = _run(workspace, "intent", "show", "intent-001")
+        assert "decision-001" in i["result"]["decision_ids"]
+
+    def test_list(self, workspace):
+        _run(workspace, "decision", "create", "R1", "--rationale", "r")
+        _run(workspace, "decision", "create", "R2", "--rationale", "r")
+        r = _run(workspace, "decision", "list")
+        assert len(r["result"]) == 2
+
+    def test_deprecate(self, workspace):
+        _run(workspace, "decision", "create", "R", "--rationale", "r")
+        r = _run(workspace, "decision", "deprecate", "decision-001")
+        assert r["result"]["status"] == "deprecated"
+
+    def test_deprecate_is_terminal(self, workspace):
+        _run(workspace, "decision", "create", "R", "--rationale", "r")
+        _run(workspace, "decision", "deprecate", "decision-001")
+        r = _run(workspace, "decision", "deprecate", "decision-001")
+        assert r["error"]["code"] == "STATE_CONFLICT"
+
+    def test_deprecated_not_auto_attached(self, workspace):
+        _run(workspace, "decision", "create", "R", "--rationale", "r")
+        _run(workspace, "decision", "deprecate", "decision-001")
+        r = _run(workspace, "intent", "create", "New goal", "--query", "q")
+        assert "decision-001" not in r["result"]["decision_ids"]
+
+    def test_attach(self, workspace):
+        _run(workspace, "intent", "create", "A", "--query", "q")
+        _run(workspace, "intent", "create", "B", "--query", "q")
+        _run(workspace, "decision", "create", "R", "--rationale", "r")
+        # decision-001 auto-attached to both. Manually attach to verify idempotency.
+        r = _run(workspace, "decision", "attach", "decision-001", "--intent", "intent-001")
+        assert r["ok"] is True
+
+    def test_attach_not_found(self, workspace):
+        _run(workspace, "decision", "create", "R", "--rationale", "r")
+        r = _run(workspace, "decision", "attach", "decision-001", "--intent", "intent-999")
+        assert r["error"]["code"] == "OBJECT_NOT_FOUND"
+
+
+# ---------------------------------------------------------------------------
+# Inspect
+# ---------------------------------------------------------------------------
+
+class TestInspect:
+    def test_full_graph(self, workspace):
+        _run(workspace, "intent", "create", "Active", "--query", "q")
+        _run(workspace, "intent", "create", "Will suspend", "--query", "q")
+        _run(workspace, "intent", "suspend", "intent-002")
+        _run(workspace, "decision", "create", "Rule", "--rationale", "r")
+        _run(workspace, "snap", "create", "S1", "--intent", "intent-001",
+             "--summary", "did something")
+
+        r = _run(workspace, "inspect")
+        assert r["ok"] is True
+        assert len(r["active_intents"]) == 1
+        assert r["active_intents"][0]["id"] == "intent-001"
+        assert r["active_intents"][0]["latest_snap_id"] == "snap-001"
+        assert len(r["suspend_intents"]) == 1
+        assert r["suspend_intents"][0]["id"] == "intent-002"
+        assert len(r["active_decisions"]) == 1
+        assert len(r["recent_snaps"]) == 1
+
+    def test_orphan_snap_warning(self, workspace):
+        _run(workspace, "intent", "create", "Goal", "--query", "q")
+        _run(workspace, "snap", "create", "S", "--intent", "intent-001")
+        # Delete intent file to create orphan
+        intent_file = workspace / ".intent" / "intents" / "intent-001.json"
+        intent_file.unlink()
+        r = _run(workspace, "inspect")
+        assert any("Orphan" in w for w in r["warnings"])