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

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

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

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

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

intent_cli_python-1.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)}",
+        )