ai-forge-cli 0.1.3__tar.gz → 0.1.5__tar.gz

{ai_forge_cli-0.1.3/src/ai_forge_cli.egg-info → ai_forge_cli-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ai-forge-cli
-Version: 0.1.3
+Version: 0.1.5
 Summary: Context walker for the Forge L0-L5 spec system
 Requires-Python: >=3.11
 License-File: LICENSE

{ai_forge_cli-0.1.3 → ai_forge_cli-0.1.5}/README.md

@@ -21,7 +21,7 @@ The agent drives the interview. The specs drive the code.
 
 ## What it is
 
-A six-layer YAML spec system, a Python CLI for context assembly, and **ten agent skills** that take a human from a vague product idea to working, audited, hardened, validated code — with the agent asking questions and the human answering, not the reverse.
+A six-layer YAML spec system, a Python CLI for context assembly, and **eleven agent skills** that take a human from a vague product idea to working, audited, hardened, validated code — with the agent asking questions and the human answering, not the reverse.
 
 Built on the premise that **people explain systems well under questioning but poorly when cold-prompted**. forge inverts the default "human prompts agent → agent implements" loop into "agent interviews human → structured spec emerges → agent implements from spec".
 
@@ -42,6 +42,8 @@ Runs in **Claude Code**, **OpenAI Codex CLI**, and any **agentskills.io-compatib
     ↓
   forge-compose     →  L4 composition   (flows + journeys from completed atoms)
     ↓
+  forge-cast        →  repo hydration   (existing codebase → draft Forge corpus + uncertainty report)
+    ↓
   forge-audit       →  quality gate     (seven audit passes, severity-ranked findings)
     ↓
   forge-armour      →  security hardening (trust model, policies, abuse-case review)
@@ -68,7 +70,7 @@ uv venv --python 3.13 .venv && uv pip install -e . pytest
 ./scripts/install-skills.sh install
 ```
 
-This wires the `forge` binary into `~/.local/bin/` and symlinks the ten skills into `~/.claude/skills/`, `~/.codex/skills/`, and `~/.agents/skills/` — discoverable by every supported client.
+This wires the `forge` binary into `~/.local/bin/` and symlinks the eleven skills into `~/.claude/skills/`, `~/.codex/skills/`, and `~/.agents/skills/` — discoverable by every supported client.
 
 ### Verify
 
@@ -110,7 +112,7 @@ forge init
       ✓ .forge/
       ✓ 6 spec subdirectories
       ✓ 12 schema templates → .forge/templates/
-      ✓ 30/30 skill symlinks → .claude/skills/, .codex/skills/, .agents/skills/
+      ✓ 33/33 skill symlinks → .claude/skills/, .codex/skills/, .agents/skills/
 
     ───── Next steps ─────
 
@@ -149,7 +151,7 @@ Full CLI guide: [`docs/cli-guide.md`](docs/cli-guide.md).
 
 ---
 
-## The ten skills
+## The eleven skills
 
 | Skill | Role | Input | Output |
 |---|---|---|---|
@@ -157,6 +159,7 @@ Full CLI guide: [`docs/cli-guide.md`](docs/cli-guide.md).
 | **forge-decompose** | Structural extractor | One bounded module | Exhaustive atom stubs (four-pass extraction) |
 | **forge-atom** | Contract specifier | One atom stub | Complete L3 spec + L0 cascades + module completions |
 | **forge-compose** | Composition specifier | Completed atoms + project decisions | L4 flow/journey specs with explicit boundary/retry/compensation/idempotency decisions |
+| **forge-cast** | Hydration specifier | Existing non-Forge codebase | Draft Forge corpus plus evidence-backed uncertainty report and clarification questions |
 | **forge-audit** | Challenger / reviewer | Completed specs | Severity-ranked findings with inline edits; seven audit passes |
 | **forge-armour** | Security challenger | Audited specs | Security hardening pass, trust-model capture, approved project/module/atom security edits |
 | **forge-implement** | Orchestrator | Audited spec corpus | Code + tests, dep-graph parallel, test-before-impl isolation |
@@ -196,11 +199,12 @@ forge/
 │   ├── cli/              Python CLI package (the forge command)
 │   ├── templates/        L0-L5 schema templates (symlinked into projects by forge init)
 │   └── example/          Working example spec corpus (used by tests)
-├── .agents/skills/       The 10 forge skills (installed into agent clients)
+├── .agents/skills/       The 11 forge skills (installed into agent clients)
 │   ├── forge-discover/
 │   ├── forge-decompose/
 │   ├── forge-atom/
 │   ├── forge-compose/
+│   ├── forge-cast/
 │   ├── forge-audit/
 │   ├── forge-armour/
 │   ├── forge-implement/

{ai_forge_cli-0.1.3 → ai_forge_cli-0.1.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ai-forge-cli"
-version = "0.1.3"
+version = "0.1.5"
 description = "Context walker for the Forge L0-L5 spec system"
 requires-python = ">=3.11"
 dependencies = ["pyyaml>=6.0"]

{ai_forge_cli-0.1.3 → ai_forge_cli-0.1.5/src/ai_forge_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ai-forge-cli
-Version: 0.1.3
+Version: 0.1.5
 Summary: Context walker for the Forge L0-L5 spec system
 Requires-Python: >=3.11
 License-File: LICENSE

{ai_forge_cli-0.1.3 → ai_forge_cli-0.1.5}/src/cli/__init__.py

@@ -1,2 +1,2 @@
 """Forge CLI — context walker for the L0-L5 spec system."""
-__version__ = "0.1.3"
+__version__ = "0.1.5"

{ai_forge_cli-0.1.3 → ai_forge_cli-0.1.5}/src/cli/commands/init.py

@@ -125,6 +125,7 @@ SKILL_NAMES = (
     "forge-decompose",
     "forge-atom",
     "forge-compose",
+    "forge-cast",
     "forge-audit",
     "forge-armour",
     "forge-implement",
@@ -341,6 +342,7 @@ def run(args: argparse.Namespace) -> int:
     print(f"    {_bold('\"I want to build a tool that does X\"')}")
     print(f"    {_bold('\"Decompose the PAY module into atoms\"')}")
     print(f"    {_bold('\"Compose flows and journeys from completed atoms\"')}")
+    print(f"    {_bold('\"Cast this existing repo into Forge docs\"')}")
     print(f"    {_bold('\"Audit the specs before implementation\"')}")
     print(f"    {_bold('\"Harden the specs for security before implementation\"')}")
     print(f"    {_bold('\"Validate the implementation against specs\"')}")
@@ -350,6 +352,7 @@ def run(args: argparse.Namespace) -> int:
           + _color(_FIRE_PRIMARY, "/forge-decompose")  + "  "
           + _color(_FIRE_PRIMARY, "/forge-atom")       + "  "
           + _color(_FIRE_PRIMARY, "/forge-compose")    + "  "
+          + _color(_FIRE_PRIMARY, "/forge-cast")       + "  "
           + _color(_FIRE_PRIMARY, "/forge-audit")      + "  "
           + _color(_FIRE_PRIMARY, "/forge-armour")     + "  "
           + _color(_FIRE_PRIMARY, "/forge-implement")  + "  "

{ai_forge_cli-0.1.3 → ai_forge_cli-0.1.5}/src/cli/walker.py

@@ -113,6 +113,13 @@ def expand_atom(idx: Index, atom: Entry, unresolved: list[str]) -> OrderedDict[s
     for aid in sorted(called_atom_ids):
         called_sigs[aid] = _atom_signature(idx, aid, unresolved)
 
+    shaped_fields = OrderedDict()
+    shaped_fields[atom.id] = _atom_shaped_fields(atom.data)
+    for aid in sorted(called_atom_ids):
+        entry = idx.get(aid)
+        if entry and entry.kind == "atom":
+            shaped_fields[aid] = _atom_shaped_fields(entry.data)
+
     l0_slice = _build_l0_slice(
         idx,
         type_ids=type_ids,
@@ -134,6 +141,7 @@ def expand_atom(idx: Index, atom: Entry, unresolved: list[str]) -> OrderedDict[s
     bundle["policies_applied"] = policies_applied
     bundle["l3_atom"] = atom.data
     bundle["called_atom_signatures"] = called_sigs
+    bundle["shaped_fields"] = shaped_fields
     if training_artifact is not None:
         bundle["training_artifact"] = training_artifact
     bundle["l4_callers"] = callers
@@ -238,6 +246,7 @@ def expand_journey(idx: Index, journey: Entry, unresolved: list[str]) -> Ordered
 
     handler_atoms: OrderedDict[str, Any] = OrderedDict()
     invoked_flows: OrderedDict[str, Any] = OrderedDict()
+    shaped_fields: OrderedDict[str, Any] = OrderedDict()
     aggregated_type_ids: set[str] = set()
     aggregated_errors: set[str] = set()
     aggregated_constants: set[str] = set()
@@ -250,6 +259,7 @@ def expand_journey(idx: Index, journey: Entry, unresolved: list[str]) -> Ordered
             entry = idx.get(aid)
             if entry:
                 handler_atoms[aid] = entry.data
+                shaped_fields[aid] = _atom_shaped_fields(entry.data)
                 spec = entry.data.get("spec") or {}
                 aggregated_type_ids |= _collect_type_ids(spec)
                 aggregated_errors |= _collect_error_codes(spec)
@@ -297,6 +307,7 @@ def expand_journey(idx: Index, journey: Entry, unresolved: list[str]) -> Ordered
     bundle["l4_journey"] = journey.data
     bundle["handler_atoms"] = handler_atoms
     bundle["invoked_orchestrations"] = invoked_flows
+    bundle["shaped_fields"] = shaped_fields
     bundle["l5_operations"] = idx.l5
     return bundle
 
@@ -309,6 +320,7 @@ def expand_flow(idx: Index, flow: Entry, unresolved: list[str]) -> OrderedDict[s
     sequence = flow.data.get("sequence") or []
 
     step_sigs: OrderedDict[str, Any] = OrderedDict()
+    shaped_fields: OrderedDict[str, Any] = OrderedDict()
     aggregated_type_ids: set[str] = set()
     aggregated_errors: set[str] = set()
     aggregated_markers: set[str] = set()
@@ -326,6 +338,7 @@ def expand_flow(idx: Index, flow: Entry, unresolved: list[str]) -> OrderedDict[s
             step_sigs[aid] = _atom_signature(idx, aid, unresolved)
             entry = idx.get(aid)
             if entry and entry.kind == "atom":
+                shaped_fields[aid] = _atom_shaped_fields(entry.data)
                 spec = entry.data.get("spec") or {}
                 aggregated_type_ids |= _collect_type_ids(spec)
                 aggregated_errors |= _collect_error_codes(spec)
@@ -354,6 +367,7 @@ def expand_flow(idx: Index, flow: Entry, unresolved: list[str]) -> OrderedDict[s
     bundle["l2_entry_points"] = entry_points
     bundle["l4_orchestration"] = flow.data
     bundle["step_atom_signatures"] = step_sigs
+    bundle["shaped_fields"] = shaped_fields
     bundle["l5_operations"] = idx.l5
     return bundle
 
@@ -392,8 +406,12 @@ def expand_artifact(idx: Index, artifact: Entry, unresolved: list[str]) -> Order
             unresolved.append(sid)
 
     consumers = OrderedDict()
+    shaped_fields: OrderedDict[str, Any] = OrderedDict()
     for cid in artifact.data.get("consumers") or []:
         consumers[cid] = _atom_signature(idx, cid, unresolved)
+        entry = idx.get(cid)
+        if entry and entry.kind == "atom":
+            shaped_fields[cid] = _atom_shaped_fields(entry.data)
 
     l0_slice = _build_l0_slice(
         idx,
@@ -415,6 +433,7 @@ def expand_artifact(idx: Index, artifact: Entry, unresolved: list[str]) -> Order
     bundle["producer_atom_signature"] = producer_sig
     bundle["source_artifacts"] = source_artifacts
     bundle["consumer_signatures"] = consumers
+    bundle["shaped_fields"] = shaped_fields
     return bundle
 
 
@@ -437,6 +456,37 @@ def _atom_signature(idx: Index, atom_id: str, unresolved: list[str]) -> dict[str
     }
 
 
+def _atom_shaped_fields(atom_data: dict[str, Any]) -> OrderedDict[str, Any]:
+    spec = atom_data.get("spec") or {}
+    shaped = OrderedDict()
+    for section_name, fields in (
+        ("input", spec.get("input")),
+        ("output.success", (spec.get("output") or {}).get("success")),
+        ("props", spec.get("props")),
+        ("local_state", spec.get("local_state")),
+        ("input_distribution", spec.get("input_distribution")),
+        ("output_distribution", spec.get("output_distribution")),
+    ):
+        _collect_shaped_fields(fields, section_name, shaped)
+    return shaped
+
+
+def _collect_shaped_fields(obj: Any, prefix: str, out: OrderedDict[str, Any]) -> None:
+    if not isinstance(obj, dict):
+        return
+    if "type" in obj and "shape" in obj and isinstance(obj["shape"], dict):
+        out[prefix] = {
+            "type": obj.get("type"),
+            "nullable": obj.get("nullable"),
+            "shape": obj.get("shape"),
+        }
+        return
+    for key, value in obj.items():
+        if isinstance(value, dict):
+            child = f"{prefix}.{key}" if prefix else key
+            _collect_shaped_fields(value, child, out)
+
+
 def _resolve(idx: Index, entity_id: str, expected_kind: str, unresolved: list[str]) -> Any:
     entry = idx.get(entity_id)
     if entry is None or entry.kind != expected_kind:

{ai_forge_cli-0.1.3 → ai_forge_cli-0.1.5}/tests/test_cli.py

@@ -32,7 +32,7 @@ def test_version_flag_prints_version_and_exits_0():
 
 def test_version_string_prefers_ai_forge_cli_distribution(monkeypatch):
     versions = {
-        "ai-forge-cli": "0.1.3",
+        "ai-forge-cli": "0.1.4",
         "forge-ai-cli": "0.1.1",
     }
 
@@ -42,7 +42,7 @@ def test_version_string_prefers_ai_forge_cli_distribution(monkeypatch):
         raise metadata.PackageNotFoundError
 
     monkeypatch.setattr(forge_mod.metadata, "version", fake_version)
-    assert forge_mod._version_string() == "0.1.3"
+    assert forge_mod._version_string() == "0.1.4"
 
 
 # ---------- context ----------

{ai_forge_cli-0.1.3 → ai_forge_cli-0.1.5}/tests/test_init.py

@@ -143,7 +143,7 @@ def test_resolve_forge_sources_uses_cached_repo_when_local_skills_missing(monkey
 
 def test_installed_cli_version_prefers_ai_forge_cli_distribution(monkeypatch):
     versions = {
-        "ai-forge-cli": "0.1.3",
+        "ai-forge-cli": "0.1.4",
         "forge-ai-cli": "0.1.1",
     }
 
@@ -153,4 +153,4 @@ def test_installed_cli_version_prefers_ai_forge_cli_distribution(monkeypatch):
         raise init_cmd.metadata.PackageNotFoundError
 
     monkeypatch.setattr(init_cmd.metadata, "version", fake_version)
-    assert init_cmd._installed_cli_version() == "0.1.3"
+    assert init_cmd._installed_cli_version() == "0.1.4"

{ai_forge_cli-0.1.3 → ai_forge_cli-0.1.5}/tests/test_walker.py

@@ -1,6 +1,9 @@
 """Walker tests against src/example/ fixtures."""
 
+from pathlib import Path
+
 from cli import walker
+from cli.index import Entry, Index
 
 
 # ---------- Atom ----------
@@ -66,6 +69,141 @@ def test_atom_unresolved_signatures(idx):
         assert aid in unresolved
 
 
+def test_atom_context_preserves_shape_metadata_for_target_and_called_signatures():
+    target_input_shape = {
+        "kind": "tagged_union",
+        "discriminator": "form",
+        "variants": [
+            {"form": "broadcast", "value": "all"},
+            {"form": "session", "pattern": "session:<int>"},
+        ],
+    }
+    target_output_shape = {
+        "kind": "enum",
+        "values": ["queued", "sent"],
+    }
+    called_output_shape = {
+        "kind": "json_schema",
+        "schema": {
+            "type": "array",
+            "items": {"type": "integer"},
+        },
+    }
+
+    idx = Index(spec_dir=Path("."))
+    idx.l1 = {"failure": {"propagation": {}}}
+    idx.l5 = {}
+    idx.entries = {
+        "MSG": Entry(
+            id="MSG",
+            kind="module",
+            data={
+                "id": "MSG",
+                "owned_atoms": ["atm.msg.send_message", "atm.msg.resolve_targets"],
+                "policies": [],
+                "interface": {"entry_points": []},
+            },
+        ),
+        "atm.msg.send_message": Entry(
+            id="atm.msg.send_message",
+            kind="atom",
+            data={
+                "id": "atm.msg.send_message",
+                "kind": "PROCEDURAL",
+                "owner_module": "MSG",
+                "description": "Send a message to a resolved target set.",
+                "spec": {
+                    "input": {
+                        "target": {
+                            "type": "string",
+                            "nullable": False,
+                            "shape": target_input_shape,
+                        },
+                        "body": {
+                            "type": "string",
+                            "nullable": False,
+                        },
+                    },
+                    "output": {
+                        "success": {
+                            "delivery_status": {
+                                "type": "string",
+                                "nullable": False,
+                                "shape": target_output_shape,
+                            }
+                        },
+                        "errors": [],
+                    },
+                    "logic": ["CALL atm.msg.resolve_targets"],
+                },
+            },
+        ),
+        "atm.msg.resolve_targets": Entry(
+            id="atm.msg.resolve_targets",
+            kind="atom",
+            data={
+                "id": "atm.msg.resolve_targets",
+                "kind": "PROCEDURAL",
+                "owner_module": "MSG",
+                "description": "Resolve a target selector into session ids.",
+                "spec": {
+                    "input": {
+                        "target": {
+                            "type": "string",
+                            "nullable": False,
+                            "shape": target_input_shape,
+                        },
+                    },
+                    "output": {
+                        "success": {
+                            "resolved_targets": {
+                                "type": "string",
+                                "nullable": False,
+                                "shape": called_output_shape,
+                            }
+                        },
+                        "errors": [],
+                    },
+                    "logic": [],
+                },
+            },
+        ),
+    }
+
+    bundle, unresolved = walker.walk(idx, "atm.msg.send_message")
+
+    assert unresolved == []
+    assert bundle["l3_atom"]["spec"]["input"]["target"]["shape"] == target_input_shape
+    assert bundle["l3_atom"]["spec"]["output"]["success"]["delivery_status"]["shape"] == target_output_shape
+    called_sig = bundle["called_atom_signatures"]["atm.msg.resolve_targets"]
+    assert called_sig["input"]["target"]["shape"] == target_input_shape
+    assert called_sig["output"]["success"]["resolved_targets"]["shape"] == called_output_shape
+    assert bundle["shaped_fields"]["atm.msg.send_message"] == {
+        "input.target": {
+            "type": "string",
+            "nullable": False,
+            "shape": target_input_shape,
+        },
+        "output.success.delivery_status": {
+            "type": "string",
+            "nullable": False,
+            "shape": target_output_shape,
+        },
+    }
+    assert bundle["shaped_fields"]["atm.msg.resolve_targets"] == {
+        "input.target": {
+            "type": "string",
+            "nullable": False,
+            "shape": target_input_shape,
+        },
+        "output.success.resolved_targets": {
+            "type": "string",
+            "nullable": False,
+            "shape": called_output_shape,
+        },
+    }
+
+
 # ---------- Module ----------
 
 def test_module_bundle_shape(idx):