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

{intent_cli_python-1.1.0 → intent_cli_python-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: intent-cli-python
-Version: 1.1.0
+Version: 1.2.0
 Summary: Semantic history for agent-driven development. Records what you did and why.
 Author: Zeng Deyang
 License-Expression: MIT
@@ -173,11 +173,15 @@ All data lives in `.intent/` at your git repo root:
     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
 

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

@@ -149,11 +149,15 @@ All data lives in `.intent/` at your git repo root:
     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
 

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "intent-cli-python"
-version = "1.1.0"
+version = "1.2.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.2.0/src/intent_cli/cli.py

@@ -0,0 +1,178 @@
+"""Intent CLI — parser and command dispatch."""
+
+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
+
+
+def main():
+    parser = argparse.ArgumentParser(prog="itt", description="Intent CLI")
+    sub = parser.add_subparsers(dest="command")
+
+    # version / init / inspect / doctor
+    sub.add_parser("version")
+    sub.add_parser("init")
+    sub.add_parser("inspect")
+    sub.add_parser("doctor")
+
+    # --- hub ---
+    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)
+    p.add_argument("--token", default=None)
+
+    p = s_hub.add_parser("sync")
+    p.add_argument("--api-base-url", default=None)
+    p.add_argument("--token", default=None)
+    p.add_argument("--dry-run", action="store_true")
+
+    # --- intent ---
+    p_intent = sub.add_parser("intent")
+    s_intent = p_intent.add_subparsers(dest="sub")
+
+    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)
+    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 = s_intent.add_parser("suspend")
+    p.add_argument("id")
+
+    p = s_intent.add_parser("done")
+    p.add_argument("id")
+
+    # --- snap ---
+    p_snap = sub.add_parser("snap")
+    s_snap = p_snap.add_subparsers(dest="sub")
+
+    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 = 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")
+
+    p = s_decision.add_parser("create")
+    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:
+        parser.print_help()
+        sys.exit(1)
+
+    dispatch_global = {
+        "version": cmd_version,
+        "init": cmd_init,
+        "inspect": cmd_inspect,
+        "doctor": cmd_doctor,
+    }
+    if args.command in dispatch_global:
+        dispatch_global[args.command](args)
+        return
+
+    if not getattr(args, "sub", None):
+        {
+            "hub": p_hub,
+            "intent": p_intent,
+            "snap": p_snap,
+            "decision": p_decision,
+        }[args.command].print_help()
+        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_python-1.2.0/src/intent_cli/commands/__init__.py

@@ -0,0 +1 @@
+"""Command handlers for the Intent CLI."""

intent_cli_python-1.2.0/src/intent_cli/commands/common.py

@@ -0,0 +1,41 @@
+"""Shared helpers for CLI command handlers."""
+
+from datetime import datetime, timezone
+
+from intent_cli.output import error
+from intent_cli.store import VALID_STATUSES, ensure_init, git_root
+
+
+def now_utc():
+    return datetime.now(timezone.utc).isoformat()
+
+
+def require_init():
+    """Return .intent/ base path, or exit with a structured error."""
+    base = ensure_init()
+    if base is not None:
+        return base
+    if git_root() is None:
+        error(
+            "GIT_STATE_INVALID",
+            "Not inside a Git repository.",
+            suggested_fix="cd into a git repo and run: itt init",
+        )
+    error(
+        "NOT_INITIALIZED",
+        ".intent/ directory not found.",
+        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)}",
+        )

intent_cli_python-1.2.0/src/intent_cli/commands/core.py

@@ -0,0 +1,376 @@
+"""Core object command handlers for the Intent CLI."""
+
+import json
+
+from intent_cli import __version__
+from intent_cli.commands.common import now_utc, require_init, validate_status_filter
+from intent_cli.output import error, success
+from intent_cli.store import (
+    VALID_STATUSES,
+    git_root,
+    init_workspace,
+    list_objects,
+    next_id,
+    read_config,
+    read_object,
+    validate_graph,
+    write_object,
+)
+
+
+def cmd_version(_args):
+    success("version", {"version": __version__})
+
+
+def cmd_init(_args):
+    path, err = init_workspace()
+    if err == "GIT_STATE_INVALID":
+        error(
+            "GIT_STATE_INVALID",
+            "Not inside a Git repository.",
+            suggested_fix="cd into a git repo and run: itt init",
+        )
+    if err == "ALREADY_EXISTS":
+        error(
+            "ALREADY_EXISTS",
+            ".intent/ already exists.",
+            suggested_fix="Remove .intent/ first if you want to reinitialize.",
+        )
+    success("init", {"path": str(path)})
+
+
+def cmd_inspect(_args):
+    base = require_init()
+    config = read_config(base)
+
+    active_intents = []
+    suspend_intents = []
+    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,
+        }
+        if obj["status"] == "active":
+            active_intents.append(entry)
+        elif obj["status"] == "suspend":
+            suspend_intents.append(entry)
+
+    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 = []
+    intent_ids_on_disk = {obj["id"] for obj in list_objects(base, "intent")}
+    for snap in all_snaps:
+        if snap.get("intent_id") and snap["intent_id"] not in intent_ids_on_disk:
+            warnings.append(f"Orphan snap {snap['id']}: intent {snap['intent_id']} not found")
+
+    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,
+        "warnings": warnings,
+    }, indent=2, ensure_ascii=False))
+
+
+def cmd_doctor(_args):
+    base = require_init()
+    success("doctor", validate_graph(base))
+
+
+def cmd_intent_create(args):
+    base = require_init()
+    obj_id = next_id(base, "intent")
+
+    active_decisions = list_objects(base, "decision", status="active")
+    decision_ids = [decision["id"] for decision in active_decisions]
+
+    warnings = []
+    if not decision_ids:
+        warnings.append("No active decisions to attach.")
+
+    intent = {
+        "id": obj_id,
+        "object": "intent",
+        "created_at": now_utc(),
+        "title": args.title,
+        "status": "active",
+        "source_query": args.query,
+        "rationale": args.rationale,
+        "decision_ids": decision_ids,
+        "snap_ids": [],
+    }
+    write_object(base, "intent", obj_id, intent)
+
+    for decision in active_decisions:
+        if obj_id not in decision.get("intent_ids", []):
+            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)
+
+
+def cmd_intent_activate(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.")
+    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}",
+        )
+
+    obj["status"] = "active"
+
+    active_decisions = list_objects(base, "decision", status="active")
+    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)
+            write_object(base, "decision", decision["id"], decision)
+
+    write_object(base, "intent", args.id, obj)
+    success("intent.activate", obj)
+
+
+def cmd_intent_suspend(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.")
+    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}",
+        )
+
+    obj["status"] = "suspend"
+    write_object(base, "intent", args.id, obj)
+    success("intent.suspend", obj)
+
+
+def cmd_intent_done(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.")
+    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}",
+        )
+
+    obj["status"] = "done"
+    write_object(base, "intent", args.id, obj)
+    success("intent.done", obj)
+
+
+def cmd_snap_create(args):
+    base = require_init()
+    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["status"] != "active":
+        error(
+            "STATE_CONFLICT",
+            f"Cannot add snap to intent with status '{intent['status']}'. Only 'active' intents accept new snaps.",
+            suggested_fix=f"itt intent activate {intent_id}",
+        )
+
+    obj_id = next_id(base, "snap")
+    snap = {
+        "id": obj_id,
+        "object": "snap",
+        "created_at": now_utc(),
+        "title": args.title,
+        "status": "active",
+        "intent_id": intent_id,
+        "query": args.query,
+        "rationale": args.rationale,
+        "summary": args.summary,
+        "feedback": args.feedback,
+    }
+    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)
+
+
+def cmd_snap_feedback(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.")
+    obj["feedback"] = args.feedback
+    write_object(base, "snap", args.id, obj)
+    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")
+
+    active_intents = list_objects(base, "intent", status="active")
+    intent_ids = [intent["id"] for intent in active_intents]
+
+    warnings = []
+    if not intent_ids:
+        warnings.append("No active intents to attach.")
+
+    decision = {
+        "id": obj_id,
+        "object": "decision",
+        "created_at": now_utc(),
+        "title": args.title,
+        "status": "active",
+        "rationale": args.rationale,
+        "intent_ids": intent_ids,
+    }
+    write_object(base, "decision", obj_id, decision)
+
+    for intent in active_intents:
+        if obj_id not in intent.get("decision_ids", []):
+            intent.setdefault("decision_ids", []).append(obj_id)
+            write_object(base, "intent", intent["id"], intent)
+
+    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)
+    if obj is None:
+        error("OBJECT_NOT_FOUND", f"Decision {args.id} not found.")
+    if obj["status"] != "active":
+        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}",
+        )
+
+    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)