intent-cli-python 2.0.0__tar.gz → 2.1.0__tar.gz

intent_cli_python-2.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,112 @@
+# 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.0.0 → intent_cli_python-2.1.0}/pyproject.toml

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

{intent_cli_python-2.0.0 → intent_cli_python-2.1.0}/src/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)