git-intent 0.3.1__tar.gz → 0.3.2__tar.gz

{git_intent-0.3.1/src/git_intent.egg-info → git_intent-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: git-intent
-Version: 0.3.1
+Version: 0.3.2
 Summary: Semantic history for agent-driven development. Records what you did and why.
 Author: Zeng Deyang
 License-Expression: MIT
@@ -22,7 +22,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: license-file
 
-English | [简体中文](README.CN.md)
+English | [简体中文](https://github.com/dozybot001/Intent/blob/main/README.CN.md)
 
 # Intent
 
@@ -113,10 +113,12 @@ pip install -e .
 | `itt inspect` | Machine-readable workspace snapshot |
 | `itt list <intent\|snap>` | List objects |
 | `itt show <id>` | Show a single object |
+| `itt suspend` | Suspend the active intent |
+| `itt resume [id]` | Resume a suspended intent |
 | `itt adopt [id]` | Adopt a candidate snap |
 | `itt revert` | Revert the latest snap |
 
 ## Documentation
 
-- [CLI spec](docs/cli.EN.md) — objects, commands, JSON output contract
-- [Agent integration](docs/agent-integration.md) — copy-paste snippets for Claude Code, Cursor, AGENTS.md
+- [CLI spec](https://github.com/dozybot001/Intent/blob/main/docs/cli.EN.md) — objects, commands, JSON output contract
+- [Agent integration](https://github.com/dozybot001/Intent/blob/main/docs/agent-integration.md) — copy-paste snippets for Claude Code, Cursor, AGENTS.md

{git_intent-0.3.1 → git_intent-0.3.2}/README.md

@@ -1,4 +1,4 @@
-English | [简体中文](README.CN.md)
+English | [简体中文](https://github.com/dozybot001/Intent/blob/main/README.CN.md)
 
 # Intent
 
@@ -89,10 +89,12 @@ pip install -e .
 | `itt inspect` | Machine-readable workspace snapshot |
 | `itt list <intent\|snap>` | List objects |
 | `itt show <id>` | Show a single object |
+| `itt suspend` | Suspend the active intent |
+| `itt resume [id]` | Resume a suspended intent |
 | `itt adopt [id]` | Adopt a candidate snap |
 | `itt revert` | Revert the latest snap |
 
 ## Documentation
 
-- [CLI spec](docs/cli.EN.md) — objects, commands, JSON output contract
-- [Agent integration](docs/agent-integration.md) — copy-paste snippets for Claude Code, Cursor, AGENTS.md
+- [CLI spec](https://github.com/dozybot001/Intent/blob/main/docs/cli.EN.md) — objects, commands, JSON output contract
+- [Agent integration](https://github.com/dozybot001/Intent/blob/main/docs/agent-integration.md) — copy-paste snippets for Claude Code, Cursor, AGENTS.md

{git_intent-0.3.1 → git_intent-0.3.2}/pyproject.toml

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

{git_intent-0.3.1 → git_intent-0.3.2/src/git_intent.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: git-intent
-Version: 0.3.1
+Version: 0.3.2
 Summary: Semantic history for agent-driven development. Records what you did and why.
 Author: Zeng Deyang
 License-Expression: MIT
@@ -22,7 +22,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: license-file
 
-English | [简体中文](README.CN.md)
+English | [简体中文](https://github.com/dozybot001/Intent/blob/main/README.CN.md)
 
 # Intent
 
@@ -113,10 +113,12 @@ pip install -e .
 | `itt inspect` | Machine-readable workspace snapshot |
 | `itt list <intent\|snap>` | List objects |
 | `itt show <id>` | Show a single object |
+| `itt suspend` | Suspend the active intent |
+| `itt resume [id]` | Resume a suspended intent |
 | `itt adopt [id]` | Adopt a candidate snap |
 | `itt revert` | Revert the latest snap |
 
 ## Documentation
 
-- [CLI spec](docs/cli.EN.md) — objects, commands, JSON output contract
-- [Agent integration](docs/agent-integration.md) — copy-paste snippets for Claude Code, Cursor, AGENTS.md
+- [CLI spec](https://github.com/dozybot001/Intent/blob/main/docs/cli.EN.md) — objects, commands, JSON output contract
+- [Agent integration](https://github.com/dozybot001/Intent/blob/main/docs/agent-integration.md) — copy-paste snippets for Claude Code, Cursor, AGENTS.md

{git_intent-0.3.1 → git_intent-0.3.2}/src/intent_cli/__init__.py

@@ -26,4 +26,4 @@ if __version__ is None:
     try:
         __version__ = metadata.version(PACKAGE_NAME)
     except metadata.PackageNotFoundError:
-        __version__ = "0.3.1"
+        __version__ = "0.3.2"

{git_intent-0.3.1 → git_intent-0.3.2}/src/intent_cli/cli.py

@@ -48,6 +48,11 @@ def build_parser() -> argparse.ArgumentParser:
     revert_p = sub.add_parser("revert", help="Revert the latest adopted snap")
     revert_p.add_argument("-m", "--message", help="Rationale for revert")
 
+    sub.add_parser("suspend", help="Suspend the active intent")
+
+    resume_p = sub.add_parser("resume", help="Resume a suspended intent")
+    resume_p.add_argument("intent_id", nargs="?")
+
     done_p = sub.add_parser("done", help="Close the active intent")
     done_p.add_argument("intent_id", nargs="?")
 
@@ -105,6 +110,16 @@ def main(argv: Optional[list[str]] = None) -> int:
             emit(ok("revert", snap, warnings=warnings))
             return EXIT_SUCCESS
 
+        if args.command == "suspend":
+            intent, warnings = repo.suspend_intent()
+            emit(ok("suspend", intent, warnings=warnings))
+            return EXIT_SUCCESS
+
+        if args.command == "resume":
+            intent, warnings = repo.resume_intent(intent_id=args.intent_id)
+            emit(ok("resume", intent, warnings=warnings))
+            return EXIT_SUCCESS
+
         if args.command == "done":
             intent, warnings = repo.close_intent(intent_id=args.intent_id)
             emit(ok("done", intent, warnings=warnings))

{git_intent-0.3.1 → git_intent-0.3.2}/src/intent_cli/core.py

@@ -92,7 +92,7 @@ class IntentRepository:
                 EXIT_STATE_CONFLICT,
                 "STATE_CONFLICT",
                 f"Intent '{current['id']}' is still open.",
-                suggested_fix="itt done",
+                suggested_fix="itt done or itt suspend",
             )
 
         intent_id = self.store.next_id("intent")
@@ -141,6 +141,77 @@ class IntentRepository:
 
         return intent, []
 
+    def suspend_intent(self) -> Tuple[Dict[str, Any], List[str]]:
+        self.ensure_git()
+        self.ensure_initialized()
+        state = self._load_state()
+        intent = self._require_active_intent(state)
+
+        intent["status"] = "suspended"
+        intent["updated_at"] = utc_now()
+        self.store.save_object("intent", intent)
+
+        state["active_intent_id"] = None
+        state["workspace_status"] = "idle"
+        self._save_state(state)
+        return intent, []
+
+    def resume_intent(self, intent_id: Optional[str] = None) -> Tuple[Dict[str, Any], List[str]]:
+        self.ensure_git()
+        self.ensure_initialized()
+        state = self._load_state()
+
+        current = self._active_intent(state)
+        if current and current.get("status") == "open":
+            raise IntentError(
+                EXIT_STATE_CONFLICT,
+                "STATE_CONFLICT",
+                f"Intent '{current['id']}' is still open.",
+                suggested_fix="itt suspend or itt done",
+            )
+
+        suspended = [
+            i for i in self.store.list_objects("intent")
+            if i.get("status") == "suspended"
+        ]
+
+        if intent_id:
+            intent = self.store.require_object("intent", intent_id)
+            if intent.get("status") != "suspended":
+                raise IntentError(
+                    EXIT_STATE_CONFLICT,
+                    "STATE_CONFLICT",
+                    f"Intent '{intent_id}' is not suspended.",
+                )
+        elif len(suspended) == 1:
+            intent = suspended[0]
+        elif len(suspended) == 0:
+            raise IntentError(
+                EXIT_STATE_CONFLICT,
+                "STATE_CONFLICT",
+                "No suspended intents to resume.",
+                suggested_fix='itt start "Describe the problem"',
+            )
+        else:
+            raise IntentError(
+                EXIT_STATE_CONFLICT,
+                "STATE_CONFLICT",
+                "Multiple suspended intents. Specify which one to resume.",
+                details={
+                    "suspended": [{"id": i["id"], "title": i["title"]} for i in suspended],
+                },
+                suggested_fix=f"itt resume {suspended[-1]['id']}",
+            )
+
+        intent["status"] = "open"
+        intent["updated_at"] = utc_now()
+        self.store.save_object("intent", intent)
+
+        state["active_intent_id"] = intent["id"]
+        state["workspace_status"] = "active"
+        self._save_state(state)
+        return intent, []
+
     # --- snap lifecycle ---
 
     def create_snap(
@@ -276,6 +347,12 @@ class IntentRepository:
                 for c in self._candidate_snaps(intent["id"])
             ]
 
+        suspended_intents = [
+            {"id": i["id"], "title": i["title"]}
+            for i in self.store.list_objects("intent")
+            if i.get("status") == "suspended"
+        ]
+
         workspace_status = self._derive_workspace_status(state)
         if workspace_status != state.get("workspace_status"):
             state["workspace_status"] = workspace_status
@@ -286,7 +363,7 @@ class IntentRepository:
                 return None
             return {k: obj[k] for k in ("id", "title", "status", "rationale") if k in obj}
 
-        action = self._next_action(intent, candidate_snaps)
+        action = self._next_action(intent, candidate_snaps, suspended_intents)
 
         return {
             "ok": True,
@@ -295,6 +372,7 @@ class IntentRepository:
             "intent": brief(intent),
             "latest_snap": brief(latest_snap),
             "candidate_snaps": candidate_snaps,
+            "suspended_intents": suspended_intents,
             "suggested_next_action": action,
             "git": {
                 "branch": git_payload["branch"],
@@ -340,8 +418,14 @@ class IntentRepository:
         self,
         intent: Optional[Dict[str, Any]],
         candidates: List[Dict[str, Any]],
+        suspended: Optional[List[Dict[str, Any]]] = None,
     ) -> Optional[Dict[str, Any]]:
         if not intent or intent.get("status") != "open":
+            if suspended:
+                return {
+                    "command": f"itt resume {suspended[-1]['id']}",
+                    "reason": "Suspended intents exist.",
+                }
             return {"command": "itt start 'Describe the problem'", "reason": "No active intent."}
         if len(candidates) > 1:
             return {

{git_intent-0.3.1 → git_intent-0.3.2}/tests/test_cli.py

@@ -201,6 +201,66 @@ class IntentCliTests(unittest.TestCase):
         d, rc = self.itt_rc("done")
         self.assertFalse(d["ok"])
 
+    # --- suspend and resume ---
+
+    def test_suspend_and_resume(self):
+        self.itt("init")
+        self.itt("start", "Task A")
+
+        # suspend
+        d = self.itt("suspend")
+        self.assertEqual(d["result"]["status"], "suspended")
+
+        # workspace is idle
+        d = self.itt("inspect")
+        self.assertEqual(d["workspace_status"], "idle")
+        self.assertEqual(len(d["suspended_intents"]), 1)
+
+        # can start a new intent
+        self.itt("start", "Task B")
+        d = self.itt("inspect")
+        self.assertEqual(d["intent"]["title"], "Task B")
+
+        # done Task B
+        self.itt("done")
+
+        # resume Task A
+        d = self.itt("resume")
+        self.assertEqual(d["result"]["status"], "open")
+        d = self.itt("inspect")
+        self.assertEqual(d["intent"]["title"], "Task A")
+
+    def test_suspend_when_idle_fails(self):
+        self.itt("init")
+        d, rc = self.itt_rc("suspend")
+        self.assertFalse(d["ok"])
+
+    def test_resume_when_active_fails(self):
+        self.itt("init")
+        self.itt("start", "A")
+        self.itt("suspend")
+        self.itt("start", "B")
+        d, rc = self.itt_rc("resume", "intent-001")
+        self.assertFalse(d["ok"])
+        self.assertEqual(d["error"]["code"], "STATE_CONFLICT")
+
+    def test_resume_multiple_requires_id(self):
+        self.itt("init")
+        self.itt("start", "A")
+        self.itt("suspend")
+        self.itt("start", "B")
+        self.itt("suspend")
+
+        # resume without id fails
+        d, rc = self.itt_rc("resume")
+        self.assertFalse(d["ok"])
+        self.assertIn("candidates" if False else "suspended", str(d["error"].get("details", {})))
+
+        # resume with id works
+        d = self.itt("resume", "intent-001")
+        self.assertEqual(d["result"]["id"], "intent-001")
+        self.assertEqual(d["result"]["status"], "open")
+
     # --- list and show ---
 
     def test_list_and_show(self):
@@ -239,6 +299,8 @@ class IntentCliTests(unittest.TestCase):
             ["snap", "S2", "--candidate"],
             ["adopt"],
             ["revert"],
+            ["suspend"],
+            ["resume"],
             ["list", "intent"],
             ["list", "snap"],
             ["show", "intent-001"],