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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: intent-cli-python
-Version: 1.1.0
+Version: 1.3.0
 Summary: Semantic history for agent-driven development. Records what you did and why.
 Author: Zeng Deyang
 License-Expression: MIT
@@ -72,6 +72,24 @@ pip install intent-cli-python
 
 Requires Python 3.9+ and Git.
 
+### Run the local IntHub shell
+
+The first read-only IntHub shell now ships with the package:
+
+```bash
+inthub-api --db-path .inthub/inthub.db
+inthub-web --api-base-url http://127.0.0.1:8000
+```
+
+If you are running from source instead of an installed package, the same entrypoints are available with:
+
+```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.
+
 ### Install the skills.sh skill
 
 ```bash
@@ -173,11 +191,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.3.0}/README.md

@@ -48,6 +48,24 @@ pip install intent-cli-python
 
 Requires Python 3.9+ and Git.
 
+### Run the local IntHub shell
+
+The first read-only IntHub shell now ships with the package:
+
+```bash
+inthub-api --db-path .inthub/inthub.db
+inthub-web --api-base-url http://127.0.0.1:8000
+```
+
+If you are running from source instead of an installed package, the same entrypoints are available with:
+
+```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.
+
 ### Install the skills.sh skill
 
 ```bash
@@ -149,11 +167,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.3.0/apps/__init__.py

@@ -0,0 +1 @@
+"""App packages for the Intent monorepo."""

intent_cli_python-1.3.0/apps/inthub_api/__init__.py

@@ -0,0 +1 @@
+"""IntHub API package."""

intent_cli_python-1.3.0/apps/inthub_api/__main__.py

@@ -0,0 +1,4 @@
+from apps.inthub_api.server import main
+
+
+main()

intent_cli_python-1.3.0/apps/inthub_api/common.py

@@ -0,0 +1,43 @@
+"""Shared helpers for the IntHub API."""
+
+import uuid
+from datetime import datetime, timezone
+
+
+def now_utc():
+    return datetime.now(timezone.utc).isoformat()
+
+
+def new_id(prefix):
+    return f"{prefix}_{uuid.uuid4().hex[:12]}"
+
+
+def make_remote_object_id(workspace_id, local_object_id):
+    return f"{workspace_id}__{local_object_id}"
+
+
+def split_remote_object_id(remote_object_id):
+    parts = remote_object_id.split("__", 1)
+    if len(parts) != 2:
+        raise ValueError("Invalid remote object ID.")
+    return parts[0], parts[1]
+
+
+class APIError(Exception):
+    def __init__(self, code, message, status=400, details=None):
+        super().__init__(message)
+        self.code = code
+        self.message = message
+        self.status = status
+        self.details = details or {}
+
+
+def require_repo(repo):
+    required = ("provider", "repo_id", "owner", "name")
+    missing = [key for key in required if not repo.get(key)]
+    if missing:
+        raise APIError(
+            "INVALID_INPUT",
+            f"Missing repo fields: {', '.join(missing)}.",
+            status=400,
+        )

intent_cli_python-1.3.0/apps/inthub_api/db.py

@@ -0,0 +1,47 @@
+"""SQLite helpers for the IntHub API."""
+
+import sqlite3
+from pathlib import Path
+
+
+def connect(db_path):
+    path = Path(db_path)
+    path.parent.mkdir(parents=True, exist_ok=True)
+    conn = sqlite3.connect(path, check_same_thread=False)
+    conn.row_factory = sqlite3.Row
+    init_db(conn)
+    return conn
+
+
+def init_db(conn):
+    conn.executescript(
+        """
+        CREATE TABLE IF NOT EXISTS projects (
+            id TEXT PRIMARY KEY,
+            name TEXT NOT NULL,
+            provider TEXT NOT NULL,
+            repo_id TEXT NOT NULL UNIQUE,
+            owner TEXT NOT NULL,
+            repo_name TEXT NOT NULL,
+            created_at TEXT NOT NULL
+        );
+
+        CREATE TABLE IF NOT EXISTS workspaces (
+            id TEXT PRIMARY KEY,
+            project_id TEXT NOT NULL,
+            provider TEXT NOT NULL,
+            repo_id TEXT NOT NULL,
+            created_at TEXT NOT NULL
+        );
+
+        CREATE TABLE IF NOT EXISTS sync_batches (
+            id TEXT PRIMARY KEY,
+            project_id TEXT NOT NULL,
+            workspace_id TEXT NOT NULL,
+            generated_at TEXT NOT NULL,
+            accepted_at TEXT NOT NULL,
+            payload_json TEXT NOT NULL
+        );
+        """
+    )
+    conn.commit()

intent_cli_python-1.3.0/apps/inthub_api/ingest.py

@@ -0,0 +1,170 @@
+"""Write-path logic for the IntHub API."""
+
+import json
+
+from apps.inthub_api.common import APIError, new_id, now_utc, require_repo
+from apps.inthub_api.db import connect
+
+
+def link_project(db_path, project_name, repo, workspace_id):
+    require_repo(repo)
+    if repo.get("provider") != "github":
+        raise APIError(
+            "PROVIDER_UNSUPPORTED",
+            f"Unsupported provider '{repo.get('provider')}'.",
+            status=400,
+        )
+
+    with connect(db_path) as conn:
+        project = conn.execute(
+            "SELECT * FROM projects WHERE provider = ? AND repo_id = ?",
+            (repo["provider"], repo["repo_id"]),
+        ).fetchone()
+
+        if project is None:
+            project_id = new_id("proj")
+            conn.execute(
+                """
+                INSERT INTO projects (id, name, provider, repo_id, owner, repo_name, created_at)
+                VALUES (?, ?, ?, ?, ?, ?, ?)
+                """,
+                (
+                    project_id,
+                    project_name or repo["name"],
+                    repo["provider"],
+                    repo["repo_id"],
+                    repo["owner"],
+                    repo["name"],
+                    now_utc(),
+                ),
+            )
+        else:
+            project_id = project["id"]
+
+        if not workspace_id:
+            workspace_id = new_id("wks")
+
+        workspace = conn.execute(
+            "SELECT * FROM workspaces WHERE id = ?",
+            (workspace_id,),
+        ).fetchone()
+        if workspace is None:
+            conn.execute(
+                """
+                INSERT INTO workspaces (id, project_id, provider, repo_id, created_at)
+                VALUES (?, ?, ?, ?, ?)
+                """,
+                (workspace_id, project_id, repo["provider"], repo["repo_id"], now_utc()),
+            )
+        else:
+            if workspace["project_id"] != project_id or workspace["repo_id"] != repo["repo_id"]:
+                raise APIError(
+                    "STATE_CONFLICT",
+                    f"Workspace {workspace_id} is already linked to another project or repo.",
+                    status=409,
+                )
+
+        conn.commit()
+        return {
+            "project_id": project_id,
+            "workspace_id": workspace_id,
+            "repo_binding": {
+                "provider": repo["provider"],
+                "repo_id": repo["repo_id"],
+                "owner": repo["owner"],
+                "name": repo["name"],
+            },
+        }
+
+
+def store_sync_batch(db_path, payload):
+    required = ("sync_batch_id", "project_id", "repo", "workspace", "snapshot")
+    missing = [key for key in required if key not in payload]
+    if missing:
+        raise APIError(
+            "INVALID_INPUT",
+            f"Missing sync batch fields: {', '.join(missing)}.",
+            status=400,
+        )
+
+    repo = payload["repo"]
+    workspace = payload["workspace"]
+    require_repo(repo)
+
+    workspace_id = workspace.get("workspace_id")
+    if not workspace_id:
+        raise APIError("INVALID_INPUT", "Missing workspace.workspace_id.", status=400)
+
+    with connect(db_path) as conn:
+        existing = conn.execute(
+            "SELECT accepted_at FROM sync_batches WHERE id = ?",
+            (payload["sync_batch_id"],),
+        ).fetchone()
+        if existing is not None:
+            return {
+                "sync_batch_id": payload["sync_batch_id"],
+                "project_id": payload["project_id"],
+                "workspace_id": workspace_id,
+                "accepted_at": existing["accepted_at"],
+                "duplicate": True,
+            }
+
+        project = conn.execute(
+            "SELECT * FROM projects WHERE id = ?",
+            (payload["project_id"],),
+        ).fetchone()
+        if project is None:
+            raise APIError(
+                "OBJECT_NOT_FOUND",
+                f"Project {payload['project_id']} not found.",
+                status=404,
+            )
+        if project["provider"] != repo["provider"] or project["repo_id"] != repo["repo_id"]:
+            raise APIError(
+                "STATE_CONFLICT",
+                "Sync batch repo does not match the linked project repo.",
+                status=409,
+            )
+
+        workspace_row = conn.execute(
+            "SELECT * FROM workspaces WHERE id = ? AND project_id = ?",
+            (workspace_id, payload["project_id"]),
+        ).fetchone()
+        if workspace_row is None:
+            raise APIError(
+                "OBJECT_NOT_FOUND",
+                f"Workspace {workspace_id} is not linked to project {payload['project_id']}.",
+                status=404,
+            )
+
+        snapshot = payload["snapshot"]
+        if snapshot.get("schema_version") != "1.0":
+            raise APIError(
+                "SCHEMA_VERSION_MISMATCH",
+                f"Unsupported schema_version '{snapshot.get('schema_version')}'.",
+                status=400,
+            )
+
+        accepted_at = now_utc()
+        conn.execute(
+            """
+            INSERT INTO sync_batches (id, project_id, workspace_id, generated_at, accepted_at, payload_json)
+            VALUES (?, ?, ?, ?, ?, ?)
+            """,
+            (
+                payload["sync_batch_id"],
+                payload["project_id"],
+                workspace_id,
+                payload.get("generated_at", accepted_at),
+                accepted_at,
+                json.dumps(payload, ensure_ascii=False),
+            ),
+        )
+        conn.commit()
+        return {
+            "sync_batch_id": payload["sync_batch_id"],
+            "project_id": payload["project_id"],
+            "workspace_id": workspace_id,
+            "accepted_at": accepted_at,
+            "duplicate": False,
+        }