intent-cli-python 2.0.0__py3-none-any.whl → 2.1.0__py3-none-any.whl

intent_cli/cli.py

@@ -4,28 +4,20 @@ import argparse
 import sys
 
 from intent_cli.commands.core import (
-    cmd_decision_attach,
     cmd_decision_create,
     cmd_decision_deprecate,
-    cmd_decision_list,
-    cmd_decision_show,
     cmd_doctor,
     cmd_init,
     cmd_inspect,
     cmd_intent_activate,
     cmd_intent_create,
     cmd_intent_done,
-    cmd_intent_list,
-    cmd_intent_show,
     cmd_intent_suspend,
     cmd_snap_create,
     cmd_snap_feedback,
-    cmd_snap_list,
-    cmd_snap_revert,
-    cmd_snap_show,
     cmd_version,
 )
-from intent_cli.commands.hub import cmd_hub_link, cmd_hub_login, cmd_hub_sync
+from intent_cli.commands.hub import cmd_hub_link, cmd_hub_sync
 
 
 def main():
@@ -42,10 +34,6 @@ def main():
     p_hub = sub.add_parser("hub")
     s_hub = p_hub.add_subparsers(dest="sub")
 
-    p = s_hub.add_parser("login")
-    p.add_argument("--api-base-url", default=None)
-    p.add_argument("--token", default=None)
-
     p = s_hub.add_parser("link")
     p.add_argument("--project-name", default=None)
     p.add_argument("--api-base-url", default=None)
@@ -65,21 +53,14 @@ def main():
     p.add_argument("--query", default="")
     p.add_argument("--rationale", default="")
 
-    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")
-
     p = s_intent.add_parser("activate")
-    p.add_argument("id")
+    p.add_argument("id", nargs="?")
 
     p = s_intent.add_parser("suspend")
-    p.add_argument("id")
+    p.add_argument("id", nargs="?")
 
     p = s_intent.add_parser("done")
-    p.add_argument("id")
+    p.add_argument("id", nargs="?")
 
     # --- snap ---
     p_snap = sub.add_parser("snap")
@@ -87,26 +68,19 @@ def main():
 
     p = s_snap.add_parser("create")
     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="")
-
-    p = s_snap.add_parser("list")
     p.add_argument("--intent", default=None)
-    p.add_argument("--status", default=None)
-
-    p = s_snap.add_parser("show")
-    p.add_argument("id")
+    p.add_argument(
+        "--origin",
+        default=None,
+        metavar="LABEL",
+        help="Override auto-detected snap origin label (default: from env, see docs)",
+    )
+    p.add_argument("--summary", required=True)
 
     p = s_snap.add_parser("feedback")
     p.add_argument("id")
     p.add_argument("feedback")
 
-    p = s_snap.add_parser("revert")
-    p.add_argument("id")
-
     # --- decision ---
     p_decision = sub.add_parser("decision")
     s_decision = p_decision.add_subparsers(dest="sub")
@@ -115,20 +89,9 @@ def main():
     p.add_argument("title")
     p.add_argument("--rationale", default="")
 
-    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")
-
     p = s_decision.add_parser("deprecate")
     p.add_argument("id")
 
-    p = s_decision.add_parser("attach")
-    p.add_argument("id")
-    p.add_argument("--intent", required=True)
-
     args = parser.parse_args()
 
     if args.command is None:
@@ -155,24 +118,15 @@ def main():
         sys.exit(1)
 
     dispatch = {
-        ("hub", "login"):              cmd_hub_login,
         ("hub", "link"):               cmd_hub_link,
         ("hub", "sync"):               cmd_hub_sync,
         ("intent", "create"):          cmd_intent_create,
-        ("intent", "list"):            cmd_intent_list,
-        ("intent", "show"):            cmd_intent_show,
         ("intent", "activate"):        cmd_intent_activate,
         ("intent", "suspend"):         cmd_intent_suspend,
         ("intent", "done"):            cmd_intent_done,
         ("snap", "create"):            cmd_snap_create,
-        ("snap", "list"):              cmd_snap_list,
-        ("snap", "show"):              cmd_snap_show,
         ("snap", "feedback"):          cmd_snap_feedback,
-        ("snap", "revert"):            cmd_snap_revert,
         ("decision", "create"):        cmd_decision_create,
-        ("decision", "list"):          cmd_decision_list,
-        ("decision", "show"):          cmd_decision_show,
         ("decision", "deprecate"):     cmd_decision_deprecate,
-        ("decision", "attach"):        cmd_decision_attach,
     }
     dispatch[(args.command, args.sub)](args)

intent_cli/commands/core.py

@@ -3,15 +3,15 @@
 import json
 
 from intent_cli import __version__
-from intent_cli.commands.common import now_utc, require_init, validate_status_filter
+from intent_cli.commands.common import now_utc, require_init
 from intent_cli.output import error, success
+from intent_cli.origin import detect_origin
 from intent_cli.store import (
     VALID_STATUSES,
     git_root,
     init_workspace,
     list_objects,
     next_id,
-    read_config,
     read_object,
     validate_graph,
     write_object,
@@ -41,43 +41,43 @@ def cmd_init(_args):
 
 def cmd_inspect(_args):
     base = require_init()
-    config = read_config(base)
+
+    all_snaps = list_objects(base, "snap")
+    snap_by_id = {snap["id"]: snap for snap in all_snaps}
 
     active_intents = []
-    suspend_intents = []
+    suspended = []
     for obj in list_objects(base, "intent"):
-        entry = {
-            "id": obj["id"],
-            "title": obj["title"],
-            "status": obj["status"],
-            "decision_ids": obj.get("decision_ids", []),
-            "latest_snap_id": obj["snap_ids"][-1] if obj.get("snap_ids") else None,
-        }
+        latest_snap_id = obj["snap_ids"][-1] if obj.get("snap_ids") else None
         if obj["status"] == "active":
-            active_intents.append(entry)
+            latest_snap = None
+            if latest_snap_id:
+                snap = snap_by_id.get(latest_snap_id)
+                if snap is not None:
+                    latest_snap = {
+                        "id": snap["id"],
+                        "title": snap["title"],
+                        "summary": snap.get("summary", ""),
+                        "feedback": snap.get("feedback", ""),
+                        "origin": snap.get("origin", ""),
+                    }
+            active_intents.append({
+                "id": obj["id"],
+                "title": obj["title"],
+                "latest_snap": latest_snap,
+            })
         elif obj["status"] == "suspend":
-            suspend_intents.append(entry)
+            suspended.append({
+                "id": obj["id"],
+                "title": obj["title"],
+                "latest_snap_id": latest_snap_id,
+            })
 
     active_decisions = []
     for obj in list_objects(base, "decision", status="active"):
         active_decisions.append({
             "id": obj["id"],
             "title": obj["title"],
-            "status": obj["status"],
-            "intent_ids": obj.get("intent_ids", []),
-        })
-
-    all_snaps = list_objects(base, "snap")
-    all_snaps.sort(key=lambda s: s.get("created_at", ""), reverse=True)
-    recent_snaps = []
-    for snap in all_snaps[:10]:
-        recent_snaps.append({
-            "id": snap["id"],
-            "title": snap["title"],
-            "intent_id": snap["intent_id"],
-            "status": snap["status"],
-            "summary": snap.get("summary", ""),
-            "feedback": snap.get("feedback", ""),
         })
 
     warnings = []
@@ -88,11 +88,9 @@ def cmd_inspect(_args):
 
     print(json.dumps({
         "ok": True,
-        "schema_version": config.get("schema_version", "1.0"),
         "active_intents": active_intents,
-        "suspend_intents": suspend_intents,
         "active_decisions": active_decisions,
-        "recent_snaps": recent_snaps,
+        "suspended": suspended,
         "warnings": warnings,
     }, indent=2, ensure_ascii=False))
 
@@ -102,6 +100,45 @@ def cmd_doctor(_args):
     success("doctor", validate_graph(base))
 
 
+def _intent_result_for_json(intent):
+    result = dict(intent)
+    result.pop("decision_ids", None)
+    return result
+
+
+def _resolve_inferred_intent_id(
+    base,
+    explicit_id,
+    *,
+    status,
+    none_code,
+    none_message,
+    multi_code,
+    multi_message,
+    suggested_fix,
+):
+    if explicit_id:
+        return explicit_id, False
+
+    candidates = sorted(
+        (
+            {"id": obj["id"], "title": obj["title"]}
+            for obj in list_objects(base, "intent", status=status)
+        ),
+        key=lambda c: c["id"],
+    )
+    if not candidates:
+        error(none_code, none_message, suggested_fix=suggested_fix)
+    if len(candidates) > 1:
+        error(
+            multi_code,
+            multi_message,
+            details={"candidates": candidates},
+            suggested_fix=suggested_fix,
+        )
+    return candidates[0]["id"], True
+
+
 def cmd_intent_create(args):
     base = require_init()
     obj_id = next_id(base, "intent")
@@ -131,36 +168,29 @@ def cmd_intent_create(args):
             decision.setdefault("intent_ids", []).append(obj_id)
             write_object(base, "decision", decision["id"], decision)
 
-    success("intent.create", intent, warnings)
-
-
-def cmd_intent_list(args):
-    base = require_init()
-    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):
-    base = require_init()
-    obj = read_object(base, "intent", args.id)
-    if obj is None:
-        error("OBJECT_NOT_FOUND", f"Intent {args.id} not found.")
-    success("intent.show", obj)
-
+    success("intent.create", _intent_result_for_json(intent), warnings)
 
 def cmd_intent_activate(args):
     base = require_init()
-    obj = read_object(base, "intent", args.id)
+    intent_id, inferred = _resolve_inferred_intent_id(
+        base,
+        args.id,
+        status="suspend",
+        none_code="NO_SUSPENDED_INTENT",
+        none_message="No suspended intent to activate.",
+        multi_code="MULTIPLE_SUSPENDED_INTENTS",
+        multi_message="Multiple suspended intents; specify which one with ID.",
+        suggested_fix="itt intent activate <id> or use: itt inspect",
+    )
+
+    obj = read_object(base, "intent", intent_id)
     if obj is None:
-        error("OBJECT_NOT_FOUND", f"Intent {args.id} not found.")
+        error("OBJECT_NOT_FOUND", f"Intent {intent_id} not found.")
     if obj["status"] != "suspend":
         error(
             "STATE_CONFLICT",
             f"Cannot activate intent with status '{obj['status']}'. Only 'suspend' intents can be activated.",
-            suggested_fix=f"itt intent show {args.id}",
+            suggested_fix="Use: itt inspect",
         )
 
     obj["status"] = "active"
@@ -169,51 +199,105 @@ def cmd_intent_activate(args):
     for decision in active_decisions:
         if decision["id"] not in obj["decision_ids"]:
             obj["decision_ids"].append(decision["id"])
-        if args.id not in decision.get("intent_ids", []):
-            decision.setdefault("intent_ids", []).append(args.id)
+        if intent_id not in decision.get("intent_ids", []):
+            decision.setdefault("intent_ids", []).append(intent_id)
             write_object(base, "decision", decision["id"], decision)
 
-    write_object(base, "intent", args.id, obj)
-    success("intent.activate", obj)
+    write_object(base, "intent", intent_id, obj)
+    warnings = []
+    if inferred:
+        warnings.append(f"Inferred intent {intent_id} (only suspended intent).")
+    success("intent.activate", _intent_result_for_json(obj), warnings)
 
 
 def cmd_intent_suspend(args):
     base = require_init()
-    obj = read_object(base, "intent", args.id)
+    intent_id, inferred = _resolve_inferred_intent_id(
+        base,
+        args.id,
+        status="active",
+        none_code="NO_ACTIVE_INTENT",
+        none_message="No active intent to suspend.",
+        multi_code="MULTIPLE_ACTIVE_INTENTS",
+        multi_message="Multiple active intents; specify which one with ID.",
+        suggested_fix="itt intent suspend <id> or use: itt inspect",
+    )
+
+    obj = read_object(base, "intent", intent_id)
     if obj is None:
-        error("OBJECT_NOT_FOUND", f"Intent {args.id} not found.")
+        error("OBJECT_NOT_FOUND", f"Intent {intent_id} not found.")
     if obj["status"] != "active":
         error(
             "STATE_CONFLICT",
             f"Cannot suspend intent with status '{obj['status']}'. Only 'active' intents can be suspended.",
-            suggested_fix=f"itt intent show {args.id}",
+            suggested_fix="Use: itt inspect",
         )
 
     obj["status"] = "suspend"
-    write_object(base, "intent", args.id, obj)
-    success("intent.suspend", obj)
+    write_object(base, "intent", intent_id, obj)
+    warnings = []
+    if inferred:
+        warnings.append(f"Inferred intent {intent_id} (only active intent).")
+    success("intent.suspend", _intent_result_for_json(obj), warnings)
 
 
 def cmd_intent_done(args):
     base = require_init()
-    obj = read_object(base, "intent", args.id)
+    intent_id, inferred = _resolve_inferred_intent_id(
+        base,
+        args.id,
+        status="active",
+        none_code="NO_ACTIVE_INTENT",
+        none_message="No active intent to mark done.",
+        multi_code="MULTIPLE_ACTIVE_INTENTS",
+        multi_message="Multiple active intents; specify which one with ID.",
+        suggested_fix="itt intent done <id> or use: itt inspect",
+    )
+
+    obj = read_object(base, "intent", intent_id)
     if obj is None:
-        error("OBJECT_NOT_FOUND", f"Intent {args.id} not found.")
+        error("OBJECT_NOT_FOUND", f"Intent {intent_id} not found.")
     if obj["status"] != "active":
         error(
             "STATE_CONFLICT",
             f"Cannot mark intent as done with status '{obj['status']}'. Only 'active' intents can be marked done.",
-            suggested_fix=f"itt intent show {args.id}",
+            suggested_fix="Use: itt inspect",
         )
 
     obj["status"] = "done"
-    write_object(base, "intent", args.id, obj)
-    success("intent.done", obj)
+    write_object(base, "intent", intent_id, obj)
+    warnings = []
+    if inferred:
+        warnings.append(f"Inferred intent {intent_id} (only active intent).")
+    success("intent.done", _intent_result_for_json(obj), warnings)
 
 
 def cmd_snap_create(args):
     base = require_init()
-    intent_id = args.intent
+    if args.intent:
+        intent_id = args.intent
+        inferred = False
+    else:
+        active = list_objects(base, "intent", status="active")
+        if not active:
+            error(
+                "NO_ACTIVE_INTENT",
+                "No active intent to attach the snap to.",
+                suggested_fix='Create or activate an intent first, e.g. itt intent create "TITLE" --query "..." or itt intent activate <id>',
+            )
+        if len(active) > 1:
+            candidates = sorted(
+                ({"id": o["id"], "title": o["title"]} for o in active),
+                key=lambda c: c["id"],
+            )
+            error(
+                "MULTIPLE_ACTIVE_INTENTS",
+                "Multiple active intents; specify which one with --intent ID.",
+                details={"candidates": candidates},
+                suggested_fix="itt snap create TITLE --intent <id> --summary ...",
+            )
+        intent_id = active[0]["id"]
+        inferred = True
 
     intent = read_object(base, "intent", intent_id)
     if intent is None:
@@ -225,6 +309,11 @@ def cmd_snap_create(args):
             suggested_fix=f"itt intent activate {intent_id}",
         )
 
+    if args.origin is not None:
+        origin = (args.origin or "").strip()
+    else:
+        origin = detect_origin()
+
     obj_id = next_id(base, "snap")
     snap = {
         "id": obj_id,
@@ -233,34 +322,19 @@ def cmd_snap_create(args):
         "title": args.title,
         "status": "active",
         "intent_id": intent_id,
-        "query": args.query,
-        "rationale": args.rationale,
         "summary": args.summary,
-        "feedback": args.feedback,
+        "feedback": "",
+        "origin": origin,
     }
     write_object(base, "snap", obj_id, snap)
 
     intent.setdefault("snap_ids", []).append(obj_id)
     write_object(base, "intent", intent_id, intent)
 
-    success("snap.create", snap)
-
-
-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 = [snap for snap in objects if snap.get("intent_id") == args.intent]
-    success("snap.list", objects)
-
-
-def cmd_snap_show(args):
-    base = require_init()
-    obj = read_object(base, "snap", args.id)
-    if obj is None:
-        error("OBJECT_NOT_FOUND", f"Snap {args.id} not found.")
-    success("snap.show", obj)
+    warnings = []
+    if inferred:
+        warnings.append(f"Inferred intent {intent_id} (only active intent).")
+    success("snap.create", snap, warnings)
 
 
 def cmd_snap_feedback(args):
@@ -273,23 +347,6 @@ def cmd_snap_feedback(args):
     success("snap.feedback", obj)
 
 
-def cmd_snap_revert(args):
-    base = require_init()
-    obj = read_object(base, "snap", args.id)
-    if obj is None:
-        error("OBJECT_NOT_FOUND", f"Snap {args.id} not found.")
-    if obj["status"] != "active":
-        error(
-            "STATE_CONFLICT",
-            f"Cannot revert snap with status '{obj['status']}'. Only 'active' snaps can be reverted.",
-            suggested_fix=f"itt snap show {args.id}",
-        )
-
-    obj["status"] = "reverted"
-    write_object(base, "snap", args.id, obj)
-    success("snap.revert", obj)
-
-
 def cmd_decision_create(args):
     base = require_init()
     obj_id = next_id(base, "decision")
@@ -320,23 +377,6 @@ def cmd_decision_create(args):
     success("decision.create", decision, warnings)
 
 
-def cmd_decision_list(args):
-    base = require_init()
-    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):
-    base = require_init()
-    obj = read_object(base, "decision", args.id)
-    if obj is None:
-        error("OBJECT_NOT_FOUND", f"Decision {args.id} not found.")
-    success("decision.show", obj)
-
-
 def cmd_decision_deprecate(args):
     base = require_init()
     obj = read_object(base, "decision", args.id)
@@ -346,31 +386,10 @@ def cmd_decision_deprecate(args):
         error(
             "STATE_CONFLICT",
             f"Cannot deprecate decision with status '{obj['status']}'. Only 'active' decisions can be deprecated.",
-            suggested_fix=f"itt decision show {args.id}",
+            suggested_fix="Use: itt inspect",
         )
 
     obj["status"] = "deprecated"
     write_object(base, "decision", args.id, obj)
     success("decision.deprecate", obj)
 
-
-def cmd_decision_attach(args):
-    base = require_init()
-    decision = read_object(base, "decision", args.id)
-    if decision is None:
-        error("OBJECT_NOT_FOUND", f"Decision {args.id} not found.")
-
-    intent_id = args.intent
-    intent = read_object(base, "intent", intent_id)
-    if intent is None:
-        error("OBJECT_NOT_FOUND", f"Intent {intent_id} not found.")
-
-    if intent_id not in decision.get("intent_ids", []):
-        decision.setdefault("intent_ids", []).append(intent_id)
-        write_object(base, "decision", args.id, decision)
-
-    if args.id not in intent.get("decision_ids", []):
-        intent.setdefault("decision_ids", []).append(args.id)
-        write_object(base, "intent", intent_id, intent)
-
-    success("decision.attach", decision)

intent_cli/commands/hub.py

@@ -13,33 +13,26 @@ from intent_cli.output import error, success
 from intent_cli.store import make_runtime_id, write_hub_config
 
 
-def cmd_hub_login(args):
+def cmd_hub_link(args):
     base = require_init()
     hub = load_hub(base)
+    repo = current_github_repo()
 
-    api_base_url = args.api_base_url or hub.get("api_base_url")
+    if args.api_base_url:
+        hub["api_base_url"] = args.api_base_url.rstrip("/")
+    api_base_url = hub.get("api_base_url")
     if not api_base_url:
         error(
-            "INVALID_INPUT",
-            "Missing IntHub API base URL.",
-            suggested_fix="Run: itt hub login --api-base-url http://127.0.0.1:8000",
+            "HUB_NOT_CONFIGURED",
+            "IntHub API base URL is not configured.",
+            suggested_fix="Run: itt hub link --api-base-url http://127.0.0.1:8000",
         )
 
-    hub["api_base_url"] = api_base_url.rstrip("/")
     if args.token:
         hub["auth_token"] = args.token
     elif "auth_token" not in hub:
         hub["auth_token"] = ""
 
-    write_hub_config(base, hub)
-    success("hub.login", sanitize_hub_config(hub))
-
-
-def cmd_hub_link(args):
-    base = require_init()
-    hub = load_hub(base)
-    repo = current_github_repo()
-    api_base_url = hub_api_base(base, args)
     token = hub_auth_token(base, args)
 
     workspace_id = hub.get("workspace_id") or make_runtime_id("wks")
@@ -59,7 +52,7 @@ def cmd_hub_link(args):
 
     updated = {
         "api_base_url": api_base_url,
-        "auth_token": token or hub.get("auth_token", ""),
+        "auth_token": hub.get("auth_token", ""),
         "workspace_id": result["workspace_id"],
         "project_id": result["project_id"],
         "repo_binding": result["repo_binding"],

intent_cli/hub/runtime.py

@@ -24,7 +24,7 @@ def hub_api_base(base, args):
         error(
             "HUB_NOT_CONFIGURED",
             "IntHub API base URL is not configured.",
-            suggested_fix="Run: itt hub login --api-base-url http://127.0.0.1:8000",
+            suggested_fix="Run: itt hub link --api-base-url http://127.0.0.1:8000",
         )
     return api_base_url.rstrip("/")
 

intent_cli/origin.py

@@ -0,0 +1,57 @@
+"""Infer snap origin (host / tool label) from the process environment.
+
+The `itt` subprocess inherits env from its parent (IDE terminal, CI, etc.).
+Override with ITT_ORIGIN or INTENT_ORIGIN.
+"""
+
+import os
+import re
+
+
+def _slugify_origin(value):
+    """Normalize a host/tool label into a short stable slug."""
+    text = re.sub(r"[^a-z0-9]+", "-", value.strip().lower())
+    return text.strip("-")
+
+
+def detect_origin(environ=None):
+    """Return a short stable label, or \"\" when unknown.
+
+    Precedence:
+    1. ITT_ORIGIN, then INTENT_ORIGIN (trimmed, non-empty)
+    2. Built-in heuristics for common host environments
+    """
+    env = environ if environ is not None else os.environ
+
+    for key in ("ITT_ORIGIN", "INTENT_ORIGIN"):
+        raw = (env.get(key) or "").strip()
+        if raw:
+            return raw
+
+    if env.get("CLAUDECODE"):
+        return "claude-code"
+
+    if env.get("CURSOR_TRACE_ID"):
+        return "cursor"
+
+    codex_originator = (env.get("CODEX_INTERNAL_ORIGINATOR_OVERRIDE") or "").strip()
+    if codex_originator:
+        return _slugify_origin(codex_originator)
+
+    if env.get("CODEX_THREAD_ID") or env.get("CODEX_SHELL") or env.get("CODEX_CI"):
+        return "codex"
+
+    term = (env.get("TERM_PROGRAM") or "").lower()
+    if term == "vscode":
+        return "vscode"
+
+    if env.get("CODESPACES") == "true":
+        return "codespaces"
+
+    if env.get("GITHUB_ACTIONS") == "true":
+        return "github-actions"
+
+    if env.get("GITPOD_WORKSPACE_ID"):
+        return "gitpod"
+
+    return ""

intent_cli/store.py

@@ -10,7 +10,7 @@ SUBDIRS = {"intent": "intents", "snap": "snaps", "decision": "decisions"}
 HUB_CONFIG = "hub.json"
 VALID_STATUSES = {
     "intent": {"active", "suspend", "done"},
-    "snap": {"active", "reverted"},
+    "snap": {"active"},
     "decision": {"active", "deprecated"},
 }
 
@@ -313,12 +313,5 @@ def validate_graph(base):
 
     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-2.1.0.dist-info/METADATA

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: intent-cli-python
+Version: 2.1.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 :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Intent
+
+[中文](README.CN.md) | English
+
+Semantic history for agent-driven development. Preserves **how the product took shape** and **how work resumes across sessions and agents**.
+
+## 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.
+
+Intent adds that missing layer: **semantic history** — a small set of formal objects that preserve product formation history and survive context loss.
+
+> Development is moving from *writing code* to *guiding agents and distilling decisions*. The history layer should reflect that.
+
+```mermaid
+flowchart LR
+  subgraph traditional["Traditional Coding"]
+    direction TB
+    H1["Human"]
+    C1["Code"]
+    H1 -->|"Git"| C1
+  end
+  subgraph agent["Agent Driven Development"]
+    direction TB
+    H2["Human"]
+    AG["Agent"]
+    C2["Code"]
+    H2 -."❌ no semantic history".-> AG
+    AG -->|"Git"| C2
+  end
+  subgraph withintent["Agent with Intent"]
+    direction TB
+    H3["Human"]
+    AG2["Agent"]
+    C3["Code"]
+    H3 -->|"Intent"| AG2
+    AG2 -->|"Git"| C3
+  end
+  traditional ~~~ agent ~~~ withintent
+```
+
+## Three objects, one graph
+
+| Object | What it captures |
+|---|---|
+| **Intent** | A goal recognized from your query |
+| **Snap** | A semantic checkpoint that captures what changed, what was learned, and later feedback |
+| **Decision** | A long-lived constraint that spans multiple intents |
+
+Objects link automatically. Decisions auto-attach to every active intent; intents auto-attach to every active decision. Relationships are bidirectional and append-only.
+
+```mermaid
+flowchart LR
+  D1["🔶 Decision 1"]
+  D2["🔶 Decision 2"]
+
+  subgraph Intent1["🎯 Intent 1"]
+    direction LR
+    S1["Snap 1"] --> S2["Snap 2"] --> S3["..."]
+  end
+
+  subgraph Intent2["🎯 Intent 2"]
+    direction LR
+    S4["Snap 1"] --> S5["Snap 2"] --> S6["..."]
+  end
+
+  D1 -- auto-attach --> Intent1
+  D1 -- auto-attach --> Intent2
+  D2 -- auto-attach --> Intent2
+```
+
+## Install
+
+```bash
+pipx install intent-cli-python   # CLI
+npx skills add dozybot001/Intent -g  # Agent skill
+```
+
+Requires Python 3.9+ and Git. The CLI provides the commands; the skill teaches the agent when to use them.
+
+> **Tips:** Because `itt` is a new command, agents are not trained on it yet. We recommend typing `/` at the start of each session, selecting the skill, and pressing Enter to enter the workflow.
+
+## IntHub
+
+```mermaid
+flowchart TB
+  Hub["IntHub — Collaboration Layer"]
+  Intent["Intent — Semantic History Layer"]
+  Git["Git — Code History Layer"]
+  Hub <--> Intent <--> Git
+```
+
+IntHub is the remote collaboration layer on top of Intent. The first path is **IntHub Local** — download from a [GitHub release](https://github.com/dozybot001/Intent/releases), then:
+
+```bash
+itt hub link --api-base-url http://127.0.0.1:7210
+itt hub sync
+```
+
+Open `http://127.0.0.1:7210` in the browser.
+
+## Docs
+
+- [Vision](docs/EN/vision.md) — why semantic history matters
+- [CLI Design](docs/EN/cli.md) — object model, commands, JSON contract
+- [Roadmap](docs/EN/roadmap.md) — phase plan
+- [Dogfooding](docs/EN/dogfooding.md) — cross-agent case study
+- [IntHub Local](docs/EN/inthub-local.md) — run a local IntHub instance
+
+## License
+
+MIT

intent_cli_python-2.1.0.dist-info/RECORD

@@ -0,0 +1,20 @@
+intent_cli/__init__.py,sha256=_19_tcL7KLgyD54NiZ-8tcAMCDKyqu_9k5K2-4Lc8ng,1058
+intent_cli/__main__.py,sha256=pWAakBzI50WtmbfDBrUudHbZYBPi8VJ_PlPbRRFGCP4,40
+intent_cli/cli.py,sha256=ShTjzjhK6e7UeKf0dw4Z7nhGtK-OaX35PHv9n1VjBIo,3761
+intent_cli/origin.py,sha256=m_vevJLJ5vUZDIuCC5k3K-LeVIl9YNtRsm7pBqXLQA0,1533
+intent_cli/output.py,sha256=_ZmivWZfY_AOcGRCWFMx09lUGB-Ku0g5xyjrqL6UWKg,680
+intent_cli/store.py,sha256=7GVgY6Y1Era_4ztMBtv8txfrpzF-6z9Kf3UgvWpr3lE,9846
+intent_cli/commands/__init__.py,sha256=XtBJys-Al_64_nLnWGXoOFR2pnYLmqbzanB5Nuy1BUM,43
+intent_cli/commands/common.py,sha256=P2MLcBf3S16Z_iuhxvQqAFV2ioAbvpgQd6XHj3ppROA,1193
+intent_cli/commands/core.py,sha256=tCBHdOAJh-sS6nNA85ujLU_TF-TjqsQHQgLCm0qWgS4,12599
+intent_cli/commands/hub.py,sha256=xiGF5IJNSPxg8PzOhQXUgBxewPhiQ4xAWPyUyLFdQ5s,3094
+intent_cli/hub/__init__.py,sha256=ujLxjGwZo_JCKhCXSlx1lwtJYDWd0y5tAoo57F1VaKM,46
+intent_cli/hub/client.py,sha256=QB6fsPZdAQD7iSnhCmbkBwPlEZVwl7QrYXE4E0S88to,1811
+intent_cli/hub/payload.py,sha256=fjweASqpHIu54HvoQDQd-ibJ0UJx6zpzjIsllVhWmrs,1930
+intent_cli/hub/runtime.py,sha256=O6dvJQMHbkMMa7yM7KV-wxu-IadykspHac4t9v8MD1I,1042
+intent_cli_python-2.1.0.dist-info/licenses/LICENSE,sha256=XWjTStLaoDw-UgLwMecejVxeaHH8JibnSFYARGzRc6I,1068
+intent_cli_python-2.1.0.dist-info/METADATA,sha256=YCQLSr36zpIfCo8rdwZ6r_v67zL1pCgNA-cyjz26T-s,4245
+intent_cli_python-2.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+intent_cli_python-2.1.0.dist-info/entry_points.txt,sha256=Y1kziqgaGUgTHg3CCfc2Su1XoDvIMJ2vi-dPEDZfuTo,44
+intent_cli_python-2.1.0.dist-info/top_level.txt,sha256=jkyOMCXA-G6FlEj69GA4SKn3RoO1KNL9w2iit7OUpuU,11
+intent_cli_python-2.1.0.dist-info/RECORD,,

intent_cli_python-2.0.0.dist-info/METADATA

@@ -1,218 +0,0 @@
-Metadata-Version: 2.4
-Name: intent-cli-python
-Version: 2.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 :: 5 - Production/Stable
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Software Development :: Version Control :: Git
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Dynamic: license-file
-
-# Intent CLI
-
-[中文](README.CN.md) | English
-
-Semantic history for agent-driven development. Records **what you did** and **why**.
-
-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 |
-|---|---|
-| **Intent** | A goal the agent identified from your query |
-| **Snap** | One agent interaction — query, summary, feedback |
-| **Decision** | A long-lived decision that spans multiple intents |
-
-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.
-
-### IntHub boundary
-
-`pipx install intent-cli-python` installs the CLI only.
-
-This repository is the umbrella project for both `Intent` and `IntHub`, but the distribution boundary is narrower than the repository boundary:
-
-- PyPI ships only the `itt` CLI
-- IntHub Web is a separate static frontend and is a good fit for GitHub Pages
-- IntHub API is a separate service and is not part of the PyPI package
-
-If you are running IntHub from source inside this repository, the current local entrypoints are:
-
-```bash
-python -m apps.inthub_api --db-path .inthub/inthub.db
-python -m apps.inthub_web --api-base-url http://127.0.0.1:8000
-```
-
-Then use `itt hub login`, `itt hub link`, and `itt hub sync` from a local Intent workspace to populate the read-only IntHub project view.
-
-### Versioning and releases
-
-`Intent` is the umbrella project and monorepo. It does not maintain one shared project version anymore.
-
-Release versions now belong to concrete deliverables:
-
-- CLI releases use the PyPI package version from `pyproject.toml` and Git tags like `cli-v2.0.0`
-- IntHub releases use their own track and Git tags like `hub-v0.1.0`
-
-Historical bare tags such as `v1.3.0` remain as history, but new releases use deliverable-prefixed tags.
-
-### Install the skills.sh skill
-
-```bash
-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
-# Initialize in any git repo
-itt init
-
-# Agent identifies a new intent from user query
-itt intent create "Fix the login timeout bug" \
-  --query "why does login timeout after 5s?"
-
-# Record what the agent did
-itt snap create "Raise timeout to 30s" \
-  --intent intent-001 \
-  --query "login timeout still fails on slow networks" \
-  --summary "Updated timeout config and ran the login test"
-
-# Capture a long-lived decision
-itt decision create "Timeout must stay configurable" \
-  --rationale "Different deployments have different latency envelopes"
-
-# See the full object graph
-itt inspect
-```
-
-## Commands
-
-### Global
-
-| Command | Description |
-|---|---|
-| `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] [--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 |
-| `itt intent done ID` | Mark intent as completed |
-
-### Snap
-
-| Command | Description |
-|---|---|
-| `itt snap create TITLE --intent ID` | Record an interaction snapshot |
-| `itt snap list [--intent ID] [--status S]` | List snaps |
-| `itt snap show ID` | Show snap details |
-| `itt snap feedback ID TEXT` | Set or overwrite feedback |
-| `itt snap revert ID` | Mark a snap as reverted |
-
-### Decision
-
-| Command | Description |
-|---|---|
-| `itt decision create TITLE --rationale R` | Create a long-lived decision |
-| `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 |
-
-## Design principles
-
-- **Agent-first**: designed to be called by AI agents, not typed by hand
-- **Append-only history**: content fields are immutable after creation; correct mistakes in new snaps, don't rewrite old ones
-- **Relationships only grow**: no detach — deprecate a decision instead
-- **All output is JSON**: machine-readable by default
-- **Zero dependencies**: pure Python, stdlib only
-
-## Storage
-
-All data lives in `.intent/` at your git repo root:
-
-```
-.intent/
-  config.json
-  intents/
-    intent-001.json
-  snaps/
-    snap-001.json
-  decisions/
-    decision-001.json
-```
-
-`.intent/` is local semantic-workspace metadata. It should stay out of Git history and should remain ignored by `.gitignore`.
-
-## 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
-- [IntHub MVP](docs/EN/inthub-mvp.md) — first remote collaboration-layer scope
-- [IntHub Sync Contract](docs/EN/inthub-sync-contract.md) — first sync, identity, and API contract
-
-## License
-
-MIT

intent_cli_python-2.0.0.dist-info/RECORD

@@ -1,19 +0,0 @@
-intent_cli/__init__.py,sha256=_19_tcL7KLgyD54NiZ-8tcAMCDKyqu_9k5K2-4Lc8ng,1058
-intent_cli/__main__.py,sha256=pWAakBzI50WtmbfDBrUudHbZYBPi8VJ_PlPbRRFGCP4,40
-intent_cli/cli.py,sha256=WUDi9hNUqOin2ETkSJOrrdaGGUN66gzZe5HyhPMmCM0,5245
-intent_cli/output.py,sha256=_ZmivWZfY_AOcGRCWFMx09lUGB-Ku0g5xyjrqL6UWKg,680
-intent_cli/store.py,sha256=AOVXbxA1OJ7gIxlvYSNzsXylJLyx_57TEmn0e9kRQN4,10119
-intent_cli/commands/__init__.py,sha256=XtBJys-Al_64_nLnWGXoOFR2pnYLmqbzanB5Nuy1BUM,43
-intent_cli/commands/common.py,sha256=P2MLcBf3S16Z_iuhxvQqAFV2ioAbvpgQd6XHj3ppROA,1193
-intent_cli/commands/core.py,sha256=X7G9ta0vfhneAN8DffW8zS0mNHhb7Zmauklu_sh7WG0,11874
-intent_cli/commands/hub.py,sha256=Hk_ZZB9LFPeXlE0Wv6yDzMLZr530ORvEAj9BZQL9VWo,3280
-intent_cli/hub/__init__.py,sha256=ujLxjGwZo_JCKhCXSlx1lwtJYDWd0y5tAoo57F1VaKM,46
-intent_cli/hub/client.py,sha256=QB6fsPZdAQD7iSnhCmbkBwPlEZVwl7QrYXE4E0S88to,1811
-intent_cli/hub/payload.py,sha256=fjweASqpHIu54HvoQDQd-ibJ0UJx6zpzjIsllVhWmrs,1930
-intent_cli/hub/runtime.py,sha256=U2U9uipBjB0MIeA10i-T1lJQariYv99iSovcgl6ca0M,1043
-intent_cli_python-2.0.0.dist-info/licenses/LICENSE,sha256=XWjTStLaoDw-UgLwMecejVxeaHH8JibnSFYARGzRc6I,1068
-intent_cli_python-2.0.0.dist-info/METADATA,sha256=2cSVuK778T_ayTowh9siWhEsjviMhb2ubOOOxzgf7b4,8134
-intent_cli_python-2.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-intent_cli_python-2.0.0.dist-info/entry_points.txt,sha256=Y1kziqgaGUgTHg3CCfc2Su1XoDvIMJ2vi-dPEDZfuTo,44
-intent_cli_python-2.0.0.dist-info/top_level.txt,sha256=jkyOMCXA-G6FlEj69GA4SKn3RoO1KNL9w2iit7OUpuU,11
-intent_cli_python-2.0.0.dist-info/RECORD,,