ai-forge-cli 2.1.4__tar.gz → 2.1.6__tar.gz

{ai_forge_cli-2.1.4/src/ai_forge_cli.egg-info → ai_forge_cli-2.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ai-forge-cli
-Version: 2.1.4
+Version: 2.1.6
 Summary: Forge V3 context CLI
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown

{ai_forge_cli-2.1.4 → ai_forge_cli-2.1.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ai-forge-cli"
-version = "2.1.4"
+version = "2.1.6"
 description = "Forge V3 context CLI"
 readme = "README.md"
 requires-python = ">=3.11"

{ai_forge_cli-2.1.4 → ai_forge_cli-2.1.6/src/ai_forge_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ai-forge-cli
-Version: 2.1.4
+Version: 2.1.6
 Summary: Forge V3 context CLI
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown

{ai_forge_cli-2.1.4 → ai_forge_cli-2.1.6}/src/cli/assets/audit_template.html

@@ -202,6 +202,25 @@
     .grid.grid-4 {
       grid-template-columns: repeat(4, minmax(0, 1fr));
     }
+    .section-header {
+      margin-bottom: 20px;
+    }
+    .section-eyebrow {
+      margin: 0 0 6px;
+      font-size: 13px;
+      font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+      color: var(--muted);
+    }
+    .section-title {
+      margin: 0 0 6px;
+      font-size: 22px;
+      line-height: 1.2;
+    }
+    .section-description {
+      margin: 0 0 18px;
+      color: var(--muted);
+      max-width: 720px;
+    }
     .horizontal-cards {
       display: grid;
       grid-auto-flow: column;
@@ -677,6 +696,9 @@
       font-size: 0.82rem;
       cursor: pointer;
     }
+    .action-pill {
+      margin-top: 8px;
+    }
     .flow-steps {
       display: grid;
       gap: 18px;
@@ -947,6 +969,7 @@
       </div>
     </div>
     <div class="brand-sep-v"></div>
+    <button class="tab" data-group="Overview">Overview</button>
     <button class="tab" data-group="System">System</button>
     <button class="tab" data-group="Flows">Flows</button>
     <button class="tab" data-group="Runtime">Runtime</button>
@@ -960,6 +983,9 @@
         __DYNAMIC_ITEM_BUTTONS_HTML__
       </div>
       <div class="artifact">
+        <section class="section" id="overview" data-group="Overview">
+          <div data-slot="overview-body">__OVERVIEW_BODY__</div>
+        </section>
         <section class="section" id="system-overview" data-group="System">
           <div data-slot="system-body">__SYSTEM_BODY__</div>
         </section>
@@ -1020,6 +1046,7 @@
     const tabs = Array.from(document.querySelectorAll('.tab'));
     const scrollRoot = document.querySelector('.artifact');
     const GROUP_OVERVIEW_TARGETS = {
+      Overview: 'overview',
       System: 'system-overview',
       Runtime: 'runtime-overview',
       Data: 'data-overview',
@@ -1654,7 +1681,7 @@
       });
     }
     bindNavigation();
-    const initial = window.location.hash.replace('#', '') || 'system-overview';
+    const initial = window.location.hash.replace('#', '') || 'overview';
     void activateSection(initial);
   </script>
 </body>

{ai_forge_cli-2.1.4 → ai_forge_cli-2.1.6}/src/cli/commands/audit.py

@@ -70,6 +70,7 @@ def _asset_data_url(filename: str, mime_type: str = "image/svg+xml") -> str:
 def render_audit_html(schema: ForgeSchema) -> str:
     data_entries = _build_data_entries(schema)
     sections: list[dict[str, str]] = [
+        {"id": "overview", "group": "Overview", "label": "Overview"},
         {"id": "system-overview", "group": "System", "label": "System"},
         {"id": "runtime-overview", "group": "Runtime", "label": "Runtime Overview"},
         {"id": "data-overview", "group": "Data", "label": "Data Overview"},
@@ -150,6 +151,7 @@ def render_audit_html(schema: ForgeSchema) -> str:
         "__DYNAMIC_ITEM_BUTTONS_HTML__": item_buttons,
         "__SYSTEM_ID__": escape(str(schema.system.get("id", "forge"))),
         "__AUDIT_DATA__": data_payload,
+        "__OVERVIEW_BODY__": _render_overview_section(schema, data_entries),
         "__SYSTEM_BODY__": _render_system_section(schema),
         "__RUNTIME_BODY__": _render_runtime_section(schema),
         "__DATA_BODY__": _render_data_section(data_entries),
@@ -174,6 +176,46 @@ def _interaction_payload(schema: ForgeSchema) -> dict[str, object]:
     }
 
 
+def _render_overview_section(schema: ForgeSchema, data_entries: list[dict[str, object]]) -> str:
+    summary_cards = [
+        ("System", str(schema.system.get("id", "forge")), None),
+        ("High-Level Flows", str(len(schema.high_level_flows)), "flow"),
+        ("Runtime Containers", str(len(schema.runtime.get("containers", []))), "runtime"),
+        ("Verticals", str(len(schema.verticals)), "vertical"),
+    ]
+    summary_html = "".join(
+        '<div class="card">'
+        f"<h3>{escape(title)}</h3>"
+        f"<p>{escape(value)}</p>"
+        "</div>"
+        for title, value, _kind in summary_cards
+    )
+    jump_cards = [
+        ("Jump To System", "Open the system boundary and external dependency view.", "Open System", "system-overview"),
+        ("Jump To Runtime", "Inspect the container graph and runtime boundaries.", "Open Runtime", "runtime-overview"),
+        ("Jump To Data", "Review promoted data shapes and persistent storage.", "Open Data", "data-overview"),
+        ("Jump To Deployment", "Review environment and node placement.", "Open Deployment", "deployment-overview"),
+    ]
+    jump_html = "".join(
+        '<div class="card">'
+        f"<h3>{escape(title)}</h3>"
+        f"<p>{escape(description)}</p>"
+        f'<button class="pill action-pill" type="button" data-target="{escape(target)}">{escape(label)}</button>'
+        "</div>"
+        for title, description, label, target in jump_cards
+    )
+    return (
+        _section_header(
+            "overview",
+            f"{schema.system.get('id', 'forge')} / Overview",
+            "Overview",
+            "System-wide audit summary and quick links into the architecture.",
+        )
+        + f'<div class="grid grid-4">{summary_html}</div>'
+        + f'<div class="grid grid-4">{jump_html}</div>'
+    )
+
+
 def _item_button(label: str, target: str, group: str) -> str:
     return f'<button class="toolbar-btn" data-target="{escape(target)}" data-group="{escape(group)}">{escape(label)}</button>'
 
@@ -216,7 +258,24 @@ def _toolbar_section_priority(section: dict[str, str]) -> int:
 
 
 def _section(section_id: str, group: str, title: str, description: str, body: str, system_id: str) -> str:
-    return f'<section class="section" id="{escape(section_id)}" data-group="{escape(group)}">{body}</section>'
+    breadcrumb = f"{system_id} / {title}"
+    return (
+        f'<section class="section" id="{escape(section_id)}" data-group="{escape(group)}">'
+        f"{_section_header(section_id, breadcrumb, title, description)}"
+        f"{body}"
+        "</section>"
+    )
+
+
+def _section_header(section_id: str, breadcrumb: str, title: str, description: str) -> str:
+    del section_id
+    return (
+        '<div class="section-header">'
+        f'<p class="section-eyebrow">{escape(breadcrumb)}</p>'
+        f'<h2 class="section-title">{escape(title)}</h2>'
+        f'<p class="section-description">{escape(description)}</p>'
+        "</div>"
+    )
 
 
 def _render_system_section(schema: ForgeSchema) -> str:

{ai_forge_cli-2.1.4 → ai_forge_cli-2.1.6}/src/cli/commands/init.py

@@ -27,6 +27,12 @@ SKILL_DIRS = [
     "forge-build",
 ]
 
+SKILL_SURFACES = [
+    ".claude/skills",
+    ".codex/skills",
+    ".agents/skills",
+]
+
 DOC_FILES = [
     "SCHEMA_REFERENCE_V3.md",
     "FRAMEWORK_V3.md",
@@ -169,7 +175,7 @@ def _scaffold_repository(target_root: Path, system_name: str, system_id: str) ->
     _copy_docs(forge_root)
     _copy_skills(forge_root)
     _rewrite_skill_references(forge_root)
-    _create_skill_symlinks(target_root, forge_root)
+    _create_surface_skills(target_root, forge_root)
 
 
 def _copy_docs(forge_root: Path) -> None:
@@ -203,15 +209,47 @@ def _rewrite_skill_references(forge_root: Path) -> None:
         skill_path.write_text(text, encoding="utf-8")
 
 
-def _create_skill_symlinks(target_root: Path, forge_root: Path) -> None:
-    for surface in (".claude/skills", ".codex/skills", ".agents/skills"):
+def _create_surface_skills(target_root: Path, forge_root: Path) -> None:
+    for surface in SKILL_SURFACES:
         surface_root = target_root / surface
         surface_root.mkdir(parents=True, exist_ok=True)
         for skill_name in SKILL_DIRS:
-            target = surface_root / skill_name
-            if target.exists() or target.is_symlink():
-                target.unlink()
-            target.symlink_to(_relative_symlink_target(surface_root, forge_root / "skills" / skill_name))
+            _create_surface_skill(surface_root, forge_root, skill_name)
+
+
+def _create_surface_skill(surface_root: Path, forge_root: Path, skill_name: str) -> None:
+    source_skill = forge_root / "skills" / skill_name
+    target_skill = surface_root / skill_name
+
+    if target_skill.exists() or target_skill.is_symlink():
+        if target_skill.is_symlink() or target_skill.is_file():
+            target_skill.unlink()
+        else:
+            shutil.rmtree(target_skill)
+    target_skill.mkdir(parents=True, exist_ok=True)
+
+    for child in source_skill.iterdir():
+        if child.name == "SKILL.md":
+            continue
+        target_child = target_skill / child.name
+        if target_child.exists() or target_child.is_symlink():
+            if target_child.is_symlink() or target_child.is_file():
+                target_child.unlink()
+            else:
+                shutil.rmtree(target_child)
+        target_child.symlink_to(_relative_symlink_target(target_skill, child), target_is_directory=child.is_dir())
+
+    surfaced_skill = _surface_skill_text(source_skill / "SKILL.md")
+    (target_skill / "SKILL.md").write_text(surfaced_skill, encoding="utf-8")
+
+
+def _surface_skill_text(skill_path: Path) -> str:
+    text = skill_path.read_text(encoding="utf-8")
+    return (
+        text.replace("../../SCHEMA_REFERENCE_V3.md", "../../../forge/SCHEMA_REFERENCE_V3.md")
+        .replace("../../FRAMEWORK_V3.md", "../../../forge/FRAMEWORK_V3.md")
+        .replace("../../USING_FORGE.md", "../../../forge/USING_FORGE.md")
+    )
 
 
 def _relative_symlink_target(link_parent: Path, destination: Path) -> Path:

{ai_forge_cli-2.1.4 → ai_forge_cli-2.1.6}/tests/test_context.py

@@ -100,9 +100,17 @@ def test_init_scaffolds_traversable_repo(tmp_path: Path, capsys) -> None:
     assert (forge_root / "skills" / "forge-schema" / "SKILL.md").exists()
     assert "dist/" in (root / ".gitignore").read_text(encoding="utf-8")
     assert "*.egg-info/" in (root / ".gitignore").read_text(encoding="utf-8")
-    assert (root / ".claude" / "skills" / "forge-schema").is_symlink()
-    assert (root / ".codex" / "skills" / "forge-build").is_symlink()
-    assert (root / ".agents" / "skills" / "forge-review").is_symlink()
+    codex_skill = root / ".codex" / "skills" / "forge-build"
+    assert codex_skill.is_dir()
+    assert not codex_skill.is_symlink()
+    assert (codex_skill / "SKILL.md").exists()
+    assert (codex_skill / "coding_agent_skills_reference").is_symlink()
+    surfaced_skill = (codex_skill / "SKILL.md").read_text(encoding="utf-8")
+    assert "../../../forge/SCHEMA_REFERENCE_V3.md" in surfaced_skill
+    assert "../../../forge/USING_FORGE.md" in surfaced_skill
+    assert "../forge-schema/SKILL.md" in surfaced_skill
+    assert (root / ".claude" / "skills" / "forge-schema" / "SKILL.md").exists()
+    assert (root / ".agents" / "skills" / "forge-review" / "SKILL.md").exists()
     rewritten_skill = (forge_root / "skills" / "forge-schema" / "SKILL.md").read_text(encoding="utf-8")
     assert "../../SCHEMA_REFERENCE_V3.md" in rewritten_skill
     assert "../../USING_FORGE.md" in rewritten_skill
@@ -140,11 +148,15 @@ def test_audit_generates_html(tmp_path: Path, capsys) -> None:
     text = output.read_text(encoding="utf-8")
     assert "Forge Audit" in text
     assert "class=\"subnav\"" in text
+    assert 'id="overview"' in text
+    assert '>Overview<' in text
     assert "system-overview" in text
     assert "runtime-overview" in text
     assert "data-overview" in text
     assert "deployment-overview" in text
     assert "container-ordering_api" in text
+    assert "artisan_goods_marketplace / Flow: place_order" in text
+    assert "High-level flow with nested runtime and component realization." in text
     assert "place_order_runtime" in text
     assert "&quot;order_id&quot;: &quot;string&quot;" in text
     assert "&quot;payment_status&quot;: &quot;enum[initiated, authorized, failed]&quot;" in text