aes-cli 0.5.0__tar.gz → 0.7.0__tar.gz

{aes_cli-0.5.0 → aes_cli-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aes-cli
-Version: 0.5.0
+Version: 0.7.0
 Summary: CLI tool for the Agentic Engineering Standard
 Author: Hiro
 License: Apache-2.0

{aes_cli-0.5.0 → aes_cli-0.7.0}/aes/__init__.py

@@ -2,4 +2,4 @@
 
 from __future__ import annotations
 
-__version__ = "0.5.0"
+__version__ = "0.7.0"

{aes_cli-0.5.0 → aes_cli-0.7.0}/aes/__main__.py

@@ -16,6 +16,8 @@ from aes.commands.install import install_cmd
 from aes.commands.search import search_cmd
 from aes.commands.status import status_cmd
 from aes.commands.sync import sync_cmd
+from aes.commands.upgrade import upgrade_cmd
+from aes.commands.bom import bom_cmd
 
 
 def _prompt_language() -> None:
@@ -77,6 +79,8 @@ cli.add_command(install_cmd, "install")
 cli.add_command(sync_cmd, "sync")
 cli.add_command(status_cmd, "status")
 cli.add_command(search_cmd, "search")
+cli.add_command(upgrade_cmd, "upgrade")
+cli.add_command(bom_cmd, "bom")
 
 
 if __name__ == "__main__":

aes_cli-0.7.0/aes/commands/bom.py

@@ -0,0 +1,131 @@
+"""aes bom — Display the Agent Bill of Materials."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import click
+import yaml
+from rich.console import Console
+from rich.table import Table
+
+from aes.config import AGENT_DIR, BOM_FILE
+from aes.i18n import t
+
+console = Console()
+
+
+def _load_bom(agent_dir: Path) -> dict:
+    """Load and return bom.yaml, or empty dict."""
+    bom_path = agent_dir / BOM_FILE
+    if not bom_path.exists():
+        return {}
+    with open(bom_path) as f:
+        data = yaml.safe_load(f)
+    return data if isinstance(data, dict) else {}
+
+
+@click.command("bom")
+@click.argument("path", default=".", type=click.Path(exists=True))
+def bom_cmd(path: str) -> None:
+    """Display the Agent Bill of Materials (AI-BOM).
+
+    Shows all models, frameworks, tools, and data sources
+    declared in .agent/bom.yaml.
+
+    \b
+    Examples:
+      aes bom                    # current project
+      aes bom ./my-project       # specific project
+    """
+    project_root = Path(path).resolve()
+    agent_dir = project_root / AGENT_DIR
+
+    if not agent_dir.exists():
+        console.print(f"[red]{t('common.error')}:[/] {t('common.no_agent_dir', agent_dir=AGENT_DIR, path=project_root)}")
+        raise SystemExit(1)
+
+    bom = _load_bom(agent_dir)
+    if not bom:
+        console.print(f"\n  [dim]{t('bom.not_found')}[/]\n")
+        return
+
+    console.print(f"\n[bold]{t('bom.title')}[/]  [dim](AES {bom.get('aes_bom', '?')})[/]\n")
+
+    # Models
+    models = bom.get("models", [])
+    if models:
+        table = Table(title=t("bom.models_table"), show_header=True, header_style="bold")
+        table.add_column(t("bom.col_name"), style="cyan")
+        table.add_column(t("bom.col_provider"))
+        table.add_column(t("bom.col_purpose"))
+        table.add_column(t("bom.col_license"))
+        for m in models:
+            table.add_row(
+                m.get("name", "?"),
+                m.get("provider", "?"),
+                m.get("purpose", "-"),
+                m.get("license", "-"),
+            )
+        console.print(table)
+        console.print()
+
+    # Frameworks
+    frameworks = bom.get("frameworks", [])
+    if frameworks:
+        table = Table(title=t("bom.frameworks_table"), show_header=True, header_style="bold")
+        table.add_column(t("bom.col_name"), style="cyan")
+        table.add_column(t("bom.col_version"))
+        table.add_column(t("bom.col_license"))
+        for fw in frameworks:
+            table.add_row(
+                fw.get("name", "?"),
+                fw.get("version", "-"),
+                fw.get("license", "-"),
+            )
+        console.print(table)
+        console.print()
+
+    # Tools
+    tools = bom.get("tools", [])
+    if tools:
+        table = Table(title=t("bom.tools_table"), show_header=True, header_style="bold")
+        table.add_column(t("bom.col_name"), style="cyan")
+        table.add_column(t("bom.col_type"))
+        table.add_column(t("bom.col_version"))
+        table.add_column(t("bom.col_source"))
+        for tool in tools:
+            table.add_row(
+                tool.get("name", "?"),
+                tool.get("type", "?"),
+                tool.get("version", "-"),
+                tool.get("source", "-"),
+            )
+        console.print(table)
+        console.print()
+
+    # Data Sources
+    data_sources = bom.get("data_sources", [])
+    if data_sources:
+        table = Table(title=t("bom.data_sources_table"), show_header=True, header_style="bold")
+        table.add_column(t("bom.col_name"), style="cyan")
+        table.add_column(t("bom.col_type"))
+        table.add_column(t("bom.col_uri"))
+        table.add_column(t("bom.col_license"))
+        for ds in data_sources:
+            table.add_row(
+                ds.get("name", "?"),
+                ds.get("type", "?"),
+                ds.get("uri", "-"),
+                ds.get("license", "-"),
+            )
+        console.print(table)
+        console.print()
+
+    # Summary
+    console.print(f"[bold]{t('bom.summary')}[/]")
+    console.print(f"  {t('bom.models_count', count=len(models))}")
+    console.print(f"  {t('bom.frameworks_count', count=len(frameworks))}")
+    console.print(f"  {t('bom.tools_count', count=len(tools))}")
+    console.print(f"  {t('bom.data_sources_count', count=len(data_sources))}")
+    console.print()

{aes_cli-0.5.0 → aes_cli-0.7.0}/aes/commands/init.py

@@ -20,6 +20,8 @@ from rich.tree import Tree
 from aes.config import (
     AGENT_DIR,
     AGENTIGNORE_FILE,
+    BOM_FILE,
+    DECISIONS_DIR,
     LOCAL_EXAMPLE_FILE,
     LOCAL_FILE,
     SCAFFOLD_DIR,
@@ -252,6 +254,7 @@ def _get_agent_integrated_types() -> list:
     return [
         (t("init.type_ml"), "ml"),
         (t("init.type_research"), "research"),
+        (t("init.type_assistant"), "assistant"),
         (t("init.type_custom"), "other"),
     ]
 
@@ -620,6 +623,7 @@ def init_cmd(
     agent_dir.mkdir(exist_ok=True)
     (agent_dir / MEMORY_DIR).mkdir(exist_ok=True)
     (agent_dir / MEMORY_DIR / "sessions").mkdir(exist_ok=True)
+    (agent_dir / DECISIONS_DIR).mkdir(parents=True, exist_ok=True)
     (agent_dir / OVERRIDES_DIR).mkdir(exist_ok=True)
 
     if skills:
@@ -664,6 +668,10 @@ def init_cmd(
     content = _render_template(env, "permissions.yaml.jinja", context)
     (agent_dir / "permissions.yaml").write_text(content)
 
+    # bom.yaml
+    content = _render_template(env, "bom.yaml.jinja", context)
+    (agent_dir / BOM_FILE).write_text(content)
+
     # .agentignore
     agentignore_path = project_root / AGENTIGNORE_FILE
     if not agentignore_path.exists():

{aes_cli-0.5.0 → aes_cli-0.7.0}/aes/commands/inspect.py

@@ -12,7 +12,7 @@ import yaml
 from rich.console import Console
 from rich.table import Table
 
-from aes.config import AGENT_DIR
+from aes.config import AGENT_DIR, BOM_FILE, DECISIONS_DIR
 from aes.i18n import t
 from aes.registry import (
     fetch_index,
@@ -205,6 +205,47 @@ def _inspect_local(path: str) -> None:
         console.print(table)
         console.print()
 
+    # Models
+    models = manifest.get("models", [])
+    if models:
+        console.print(f"[bold]{t('inspect.models_section')}[/]")
+        for m in models:
+            purpose = m.get("purpose", "")
+            purpose_str = f" [dim]({purpose})[/]" if purpose else ""
+            console.print(f"  {m.get('name', '?')} — {m.get('provider', '?')}{purpose_str}")
+        console.print()
+
+    # Provenance
+    provenance = manifest.get("provenance", {})
+    if provenance:
+        console.print(f"[bold]{t('inspect.provenance_section')}[/]")
+        if provenance.get("created_by"):
+            console.print(f"  {t('inspect.provenance_created_by', value=provenance['created_by'])}")
+        if provenance.get("source"):
+            console.print(f"  {t('inspect.provenance_source', value=provenance['source'])}")
+        console.print()
+
+    # BOM summary
+    bom_path = agent_dir / BOM_FILE
+    if bom_path.exists():
+        bom = _load_yaml(bom_path)
+        n_models = len(bom.get("models", []))
+        n_frameworks = len(bom.get("frameworks", []))
+        n_tools = len(bom.get("tools", []))
+        n_data = len(bom.get("data_sources", []))
+        console.print(f"[bold]{t('inspect.bom_section')}[/]")
+        console.print(f"  {t('inspect.bom_summary', models=n_models, frameworks=n_frameworks, tools=n_tools, data=n_data)}")
+        console.print()
+
+    # Decision records count
+    decisions_dir = agent_dir / DECISIONS_DIR
+    if decisions_dir.exists() and decisions_dir.is_dir():
+        dr_count = len(list(decisions_dir.glob("*.yaml")))
+        if dr_count > 0:
+            console.print(f"[bold]{t('inspect.decisions_section')}[/]")
+            console.print(f"  {t('inspect.decisions_count', count=dr_count)}")
+            console.print()
+
     # Summary
     console.print(f"[bold]{t('inspect.summary')}[/]")
     console.print(f"  {t('inspect.skills_count', count=len(skills))}")

{aes_cli-0.5.0 → aes_cli-0.7.0}/aes/commands/publish.py

@@ -3,6 +3,8 @@
 from __future__ import annotations
 
 import fnmatch
+import hashlib
+import json
 import shutil
 import sys
 import tarfile
@@ -14,7 +16,7 @@ import click
 import yaml
 from rich.console import Console
 
-from aes.config import AGENT_DIR, MANIFEST_FILE
+from aes.config import AGENT_DIR, BOM_FILE, MANIFEST_FILE
 from aes.i18n import t
 
 console = Console()
@@ -171,6 +173,53 @@ def _validate_before_publish(project_root: Path) -> bool:
     return True
 
 
+def _media_type_for_path(path: str) -> str:
+    """Return a media type string for a file path."""
+    if path.endswith(".yaml") or path.endswith(".yml"):
+        return "application/vnd.aes.agent-config.v1+yaml"
+    if path.endswith(".md"):
+        return "text/markdown"
+    if path.endswith(".json"):
+        return "application/json"
+    return "application/octet-stream"
+
+
+def _build_package_manifest(
+    name: str,
+    version: str,
+    aes_version: str,
+    pkg_type: str,
+    files: List[tuple],
+) -> dict:
+    """Build an aes-manifest.json dict.
+
+    *files* is a list of ``(arcname, file_path)`` tuples.
+    """
+    layers = []
+    for arcname, file_path in files:
+        data = file_path.read_bytes()
+        digest = hashlib.sha256(data).hexdigest()
+        layers.append({
+            "mediaType": _media_type_for_path(arcname),
+            "digest": f"sha256:{digest}",
+            "size": len(data),
+            "path": arcname,
+        })
+
+    return {
+        "schemaVersion": 1,
+        "mediaType": "application/vnd.aes.package.v1+tar+gzip",
+        "config": {
+            "name": name,
+            "version": version,
+            "type": pkg_type,
+            "aes": aes_version,
+        },
+        "layers": layers,
+        "signature": None,
+    }
+
+
 def _publish_template_dir(
     project_root: Path,
     output_dir: Path,
@@ -194,6 +243,7 @@ def _publish_template_dir(
 
     name = manifest.get("name", "unknown")
     version = manifest.get("version", "0.0.0")
+    aes_version = manifest.get("aes", "1.0")
 
     # Build exclusion list
     if include_all:
@@ -208,17 +258,35 @@ def _publish_template_dir(
     tarball_name = f"{name}-{version}.tar.gz"
     tarball_path = output_dir / tarball_name
 
+    # Collect files and build package manifest
+    included_files: List[tuple] = []  # (rel_path_in_agent, absolute_path)
+
+    for file_path in sorted(agent_dir.rglob("*")):
+        if not file_path.is_file():
+            continue
+        rel = file_path.relative_to(agent_dir)
+        rel_str = str(rel)
+        if _is_excluded(rel_str, excludes):
+            continue
+        included_files.append((f"{AGENT_DIR}/{rel_str}", file_path))
+
+    # Generate aes-manifest.json
+    pkg_manifest = _build_package_manifest(
+        name, version, aes_version, "template", included_files,
+    )
+
     with tarfile.open(tarball_path, "w:gz") as tar:
-        for file_path in sorted(agent_dir.rglob("*")):
-            if not file_path.is_file():
-                continue
-            rel = file_path.relative_to(agent_dir)
-            rel_str = str(rel)
-            if _is_excluded(rel_str, excludes):
-                continue
-            arcname = f"{name}/{AGENT_DIR}/{rel_str}"
+        for rel_path, file_path in included_files:
+            arcname = f"{name}/{rel_path}"
             tar.add(file_path, arcname=arcname)
 
+        # Add aes-manifest.json at the package root
+        manifest_json = json.dumps(pkg_manifest, indent=2).encode()
+        import io
+        info = tarfile.TarInfo(name=f"{name}/aes-manifest.json")
+        info.size = len(manifest_json)
+        tar.addfile(info, io.BytesIO(manifest_json))
+
     return tarball_path
 
 

{aes_cli-0.5.0 → aes_cli-0.7.0}/aes/commands/status.py

@@ -70,7 +70,12 @@ def status_cmd(path: str) -> None:
 
     for name in TARGET_NAMES:
         adapter = TARGETS[name]()
-        plan = adapter.plan(ctx, force=True)
+        try:
+            plan = adapter.plan(ctx, force=True)
+        except Exception:
+            # Target-specific validation failure (e.g. openclaw requires
+            # identity/model) — skip incompatible targets silently in status.
+            continue
         for gf in plan.files:
             would_generate[gf.relative_path] = gf.content
 

{aes_cli-0.5.0 → aes_cli-0.7.0}/aes/commands/sync.py

@@ -64,7 +64,15 @@ def run_sync(
     all_plans: List[SyncPlan] = []
     for name in selected:
         adapter = TARGETS[name]()
-        all_plans.append(adapter.plan(ctx, force))
+        try:
+            all_plans.append(adapter.plan(ctx, force))
+        except click.ClickException:
+            # Target-specific validation failure — skip when syncing
+            # multiple targets (e.g. openclaw requires identity/model
+            # which non-assistant projects won't have).
+            if len(selected) == 1:
+                raise
+            continue
 
     sync_manifest = _load_sync_manifest(project_root)
     written = 0
@@ -158,6 +166,14 @@ def _load_agent_context(project_root: Path) -> AgentContext:
                     "negative_triggers": skill_data.get("negative_triggers", []),
                     "activation": skill_data.get("activation", "explicit"),
                     "allowed_tools": skill_data.get("allowed_tools"),
+                    "version": skill_data.get("version", "0.1.0"),
+                    "emoji": skill_data.get("emoji", ""),
+                    "license": skill_data.get("license", "MIT"),
+                    "user_invocable": skill_data.get("user_invocable", True),
+                    "primary_env": skill_data.get("primary_env", ""),
+                    "requires_bins": (skill_data.get("requires") or {}).get("bins", []),
+                    "requires_env": (skill_data.get("requires") or {}).get("env", []),
+                    "mcp_server": skill_data.get("mcp_server"),
                 }
         if skill_id not in skill_metadata:
             skill_metadata[skill_id] = {
@@ -305,7 +321,19 @@ def sync_cmd(
     all_plans: List[SyncPlan] = []
     for target_name in selected:
         adapter = TARGETS[target_name]()
-        sync_plan = adapter.plan(ctx, force)
+        try:
+            sync_plan = adapter.plan(ctx, force)
+        except click.ClickException as exc:
+            # Target-specific validation failure (e.g. openclaw requires
+            # identity/model). When syncing a single explicit target, re-raise
+            # so the user sees the error. When syncing all targets, skip and
+            # warn — not every project is compatible with every target.
+            if len(selected) == 1:
+                raise
+            console.print(
+                f"  [yellow]⚠ {target_name}:[/] {exc.format_message()}"
+            )
+            continue
         all_plans.append(sync_plan)
 
     # Execute plans