arkaos 4.8.0 → 4.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "4.8.0",
+  "version": "4.10.0",
   "description": "The Operating System for AI Agent Teams",
   "type": "module",
   "bin": {

package/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "arkaos-core"
-version = "4.8.0"
+version = "4.10.0"
 description = "Core engine for ArkaOS — The Operating System for AI Agent Teams"
 readme = "README.md"
 license = {text = "MIT"}

package/scripts/dashboard-api.py

@@ -95,7 +95,7 @@ def _load_agents() -> list[dict]:
 def _load_commands() -> list[dict]:
     global _commands_cache
     if _commands_cache is None:
-        path = ARKAOS_ROOT / "knowledge" / "commands-registry-v2.json"
+        path = ARKAOS_ROOT / "knowledge" / "commands-registry.json"
         if path.exists():
             data = json.loads(path.read_text())
             _commands_cache = data.get("commands", [])
@@ -1730,7 +1730,7 @@ def health():
     check("agents_registry",
           (ARKAOS_ROOT / "knowledge" / "agents-registry-v2.json").exists())
     check("commands_registry",
-          (ARKAOS_ROOT / "knowledge" / "commands-registry-v2.json").exists())
+          (ARKAOS_ROOT / "knowledge" / "commands-registry.json").exists())
     check("hooks_dir", (arkaos_home / "config" / "hooks").exists(),
           "npx arkaos install")
 

package/scripts/synapse-bridge.py

@@ -112,7 +112,7 @@ def load_agents_registry(root: Path) -> dict:
 
 def load_commands_registry(root: Path) -> list:
     """Load commands registry JSON."""
-    path = root / "knowledge" / "commands-registry-v2.json"
+    path = root / "knowledge" / "commands-registry.json"
     if not path.exists():
         return []
     try:

package/scripts/tools/prompt_surface_benchmark.py

@@ -0,0 +1,144 @@
+"""Prompt-surface token benchmark (v4.1 Evidence Reform open item).
+
+Measures the UserPromptSubmit hook's injected context (additionalContext)
+across a canonical prompt set, optionally comparing the working tree
+against another git ref (extracted via `git archive`, no worktrees).
+
+Token estimate: bytes / 4 — the same coarse heuristic the Synapse layers
+use (`tokens_est`); good enough for a reduction ratio, not billing.
+
+Usage:
+    arka-py scripts/tools/prompt_surface_benchmark.py [--ref v4.0.2] [--json]
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import subprocess
+import sys
+import tarfile
+import tempfile
+from io import BytesIO
+from pathlib import Path
+
+REPO_ROOT = Path(__file__).resolve().parent.parent.parent
+
+CANONICAL_PROMPTS: dict[str, str] = {
+    "simple": "ok",
+    "question": "como funciona o sync de projetos?",
+    "code-modifying": "implementa auth no backend com testes",
+    "department-routed": "cria uma campanha de marketing para o lançamento",
+    "slash-command": "/dev feature user auth",
+}
+
+HOOK_REL = Path("config") / "hooks" / "user-prompt-submit.sh"
+
+
+def _run_hook(tree: Path, prompt: str) -> int:
+    """Return the additionalContext byte size the hook injects."""
+    payload = json.dumps(
+        {"prompt": prompt, "cwd": "/tmp", "session_id": "bench-1"}
+    )
+    proc = subprocess.run(
+        ["bash", str(tree / HOOK_REL)],
+        input=payload,
+        capture_output=True,
+        text=True,
+        timeout=30,
+        env={
+            "PATH": "/usr/bin:/bin:/usr/local/bin",
+            "HOME": str(Path.home()),
+            "ARKA_HOOK_FORCE_FALLBACK": "1",
+        },
+    )
+    out = proc.stdout.strip()
+    if not out:
+        return 0
+    try:
+        context = json.loads(out).get("additionalContext", "")
+    except json.JSONDecodeError:
+        context = out
+    return len(context.encode("utf-8"))
+
+
+def _extract_ref(ref: str, dest: Path) -> Path:
+    archive = subprocess.run(
+        ["git", "-C", str(REPO_ROOT), "archive", ref],
+        capture_output=True,
+        check=True,
+        timeout=60,
+    )
+    with tarfile.open(fileobj=BytesIO(archive.stdout)) as tar:
+        try:
+            tar.extractall(dest, filter="data")
+        except TypeError:  # Python < 3.12 has no filter param
+            tar.extractall(dest)  # trusted archive: local git, no network
+    return dest
+
+
+def measure(tree: Path) -> dict[str, dict[str, int]]:
+    results: dict[str, dict[str, int]] = {}
+    for name, prompt in CANONICAL_PROMPTS.items():
+        size = _run_hook(tree, prompt)
+        results[name] = {"bytes": size, "tokens_est": size // 4}
+    return results
+
+
+def compare(ref: str) -> dict:
+    with tempfile.TemporaryDirectory(prefix="arka-bench-") as tmp:
+        old_tree = _extract_ref(ref, Path(tmp))
+        before = measure(old_tree)
+    after = measure(REPO_ROOT)
+    total_before = sum(r["bytes"] for r in before.values())
+    total_after = sum(r["bytes"] for r in after.values())
+    reduction = (
+        round(100 * (1 - total_after / total_before), 1)
+        if total_before
+        else 0.0
+    )
+    return {
+        "ref": ref,
+        "before": before,
+        "after": after,
+        "total_bytes_before": total_before,
+        "total_bytes_after": total_after,
+        "reduction_pct": reduction,
+    }
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--ref", help="git ref to compare against")
+    parser.add_argument("--json", action="store_true", dest="as_json")
+    args = parser.parse_args(argv)
+
+    if args.ref:
+        report = compare(args.ref)
+    else:
+        report = {"current": measure(REPO_ROOT)}
+
+    if args.as_json:
+        print(json.dumps(report, indent=2, ensure_ascii=False))
+        return 0
+
+    if "current" in report:
+        for name, row in report["current"].items():
+            print(f"{name:20s} {row['bytes']:>6d} B  ~{row['tokens_est']} tok")
+        return 0
+
+    print(f"Prompt-surface benchmark: {report['ref']} -> HEAD")
+    for name in CANONICAL_PROMPTS:
+        b = report["before"][name]["bytes"]
+        a = report["after"][name]["bytes"]
+        print(f"{name:20s} {b:>6d} B -> {a:>6d} B")
+    print(
+        f"{'TOTAL':20s} {report['total_bytes_before']:>6d} B -> "
+        f"{report['total_bytes_after']:>6d} B "
+        f"({report['reduction_pct']}% reduction)"
+    )
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/knowledge/agents-registry.json

@@ -1,254 +0,0 @@
-{
-  "version": "1.0.0",
-  "generated": "2026-03-20",
-  "agents": [
-    {
-      "id": "cto",
-      "display_name": "Marco",
-      "role": "CTO",
-      "department": "dev",
-      "tier": 0,
-      "disc": { "primary": "D", "secondary": "C", "combination": "D+C", "label": "Driver-Analyst" },
-      "file": "departments/dev/agents/cto.md",
-      "memory_path": "~/.claude/agent-memory/arka-cto/MEMORY.md",
-      "key_authority": ["veto", "approve_architecture", "approve_tech_stack", "block_release"]
-    },
-    {
-      "id": "tech-lead",
-      "display_name": "Paulo",
-      "role": "Tech Lead",
-      "department": "dev",
-      "tier": 1,
-      "disc": { "primary": "I", "secondary": "S", "combination": "I+S", "label": "Inspirer-Supporter" },
-      "file": "departments/dev/agents/tech-lead.md",
-      "memory_path": "~/.claude/agent-memory/arka-tech-lead/MEMORY.md",
-      "key_authority": ["orchestrate", "assign_tasks"]
-    },
-    {
-      "id": "architect",
-      "display_name": "Gabriel",
-      "role": "Software Architect",
-      "department": "dev",
-      "tier": 1,
-      "disc": { "primary": "C", "secondary": "D", "combination": "C+D", "label": "Analyst-Driver" },
-      "file": "departments/dev/agents/architect.md",
-      "memory_path": "~/.claude/agent-memory/arka-architect/MEMORY.md",
-      "key_authority": ["design_architecture", "create_adr"]
-    },
-    {
-      "id": "senior-dev",
-      "display_name": "Andre",
-      "role": "Senior Backend Developer",
-      "department": "dev",
-      "tier": 2,
-      "disc": { "primary": "C", "secondary": "S", "combination": "C+S", "label": "Analyst-Supporter" },
-      "file": "departments/dev/agents/senior-dev.md",
-      "memory_path": "~/.claude/agent-memory/arka-senior-dev/MEMORY.md",
-      "key_authority": ["implement"]
-    },
-    {
-      "id": "frontend-dev",
-      "display_name": "Diana",
-      "role": "Senior Frontend Developer",
-      "department": "dev",
-      "tier": 2,
-      "disc": { "primary": "I", "secondary": "C", "combination": "I+C", "label": "Inspirer-Analyst" },
-      "file": "departments/dev/agents/frontend-dev.md",
-      "memory_path": "~/.claude/agent-memory/arka-frontend-dev/MEMORY.md",
-      "key_authority": ["implement"]
-    },
-    {
-      "id": "security",
-      "display_name": "Bruno",
-      "role": "Security Engineer",
-      "department": "dev",
-      "tier": 2,
-      "disc": { "primary": "C", "secondary": "D", "combination": "C+D", "label": "Analyst-Driver" },
-      "file": "departments/dev/agents/security.md",
-      "memory_path": "~/.claude/agent-memory/arka-security/MEMORY.md",
-      "key_authority": ["block_release", "security_audit"]
-    },
-    {
-      "id": "devops",
-      "display_name": "Carlos",
-      "role": "DevOps Lead",
-      "department": "dev",
-      "tier": 2,
-      "disc": { "primary": "D", "secondary": "C", "combination": "D+C", "label": "Driver-Analyst" },
-      "file": "departments/dev/agents/devops.md",
-      "memory_path": "~/.claude/agent-memory/arka-devops/MEMORY.md",
-      "key_authority": ["push", "deploy", "manage_ci"]
-    },
-    {
-      "id": "qa",
-      "display_name": "Rita",
-      "role": "QA Lead",
-      "department": "dev",
-      "tier": 3,
-      "disc": { "primary": "C", "secondary": "S", "combination": "C+S", "label": "Analyst-Supporter" },
-      "file": "departments/dev/agents/qa.md",
-      "memory_path": "~/.claude/agent-memory/arka-qa/MEMORY.md",
-      "key_authority": ["block_release", "validate"]
-    },
-    {
-      "id": "analyst",
-      "display_name": "Lucas",
-      "role": "Technical Analyst",
-      "department": "dev",
-      "tier": 3,
-      "disc": { "primary": "C", "secondary": "I", "combination": "C+I", "label": "Analyst-Inspirer" },
-      "file": "departments/dev/agents/analyst.md",
-      "memory_path": "~/.claude/agent-memory/arka-analyst/MEMORY.md",
-      "key_authority": ["research", "recommend"]
-    },
-    {
-      "id": "cfo",
-      "display_name": "Helena",
-      "role": "CFO",
-      "department": "finance",
-      "tier": 0,
-      "disc": { "primary": "D", "secondary": "C", "combination": "D+C", "label": "Driver-Analyst" },
-      "file": "departments/finance/agents/cfo.md",
-      "memory_path": "~/.claude/agent-memory/arka-cfo/MEMORY.md",
-      "key_authority": ["veto", "approve_budget", "financial_decisions"]
-    },
-    {
-      "id": "coo",
-      "display_name": "Sofia",
-      "role": "COO",
-      "department": "ops",
-      "tier": 0,
-      "disc": { "primary": "S", "secondary": "C", "combination": "S+C", "label": "Supporter-Analyst" },
-      "file": "departments/ops/agents/ops-lead.yaml",
-      "memory_path": "~/.claude/agent-memory/arka-coo/MEMORY.md",
-      "key_authority": ["veto", "approve_operations", "cross_department"]
-    },
-    {
-      "id": "content-creator",
-      "display_name": "Luna",
-      "role": "Content Creator",
-      "department": "marketing",
-      "tier": 1,
-      "disc": { "primary": "I", "secondary": "D", "combination": "I+D", "label": "Inspirer-Driver" },
-      "file": "departments/marketing/agents/content-creator.md",
-      "memory_path": "~/.claude/agent-memory/arka-content-creator/MEMORY.md",
-      "key_authority": ["create_content", "manage_campaigns"]
-    },
-    {
-      "id": "ecommerce-manager",
-      "display_name": "Ricardo",
-      "role": "E-commerce Manager",
-      "department": "ecom",
-      "tier": 1,
-      "disc": { "primary": "D", "secondary": "I", "combination": "D+I", "label": "Driver-Inspirer" },
-      "file": "departments/ecom/agents/ecom-director.yaml",
-      "memory_path": "~/.claude/agent-memory/arka-ecommerce-manager/MEMORY.md",
-      "key_authority": ["manage_store", "pricing_decisions"]
-    },
-    {
-      "id": "strategist",
-      "display_name": "Tomas",
-      "role": "Chief Strategist",
-      "department": "strategy",
-      "tier": 1,
-      "disc": { "primary": "I", "secondary": "D", "combination": "I+D", "label": "Inspirer-Driver" },
-      "file": "departments/strategy/agents/strategist.md",
-      "memory_path": "~/.claude/agent-memory/arka-strategist/MEMORY.md",
-      "key_authority": ["strategic_planning", "market_analysis"]
-    },
-    {
-      "id": "knowledge-curator",
-      "display_name": "Clara",
-      "role": "Knowledge Curator",
-      "department": "kb",
-      "tier": 1,
-      "disc": { "primary": "S", "secondary": "C", "combination": "S+C", "label": "Supporter-Analyst" },
-      "file": "departments/kb/agents/knowledge-curator.yaml",
-      "memory_path": "~/.claude/agent-memory/arka-knowledge-curator/MEMORY.md",
-      "key_authority": ["manage_knowledge", "create_personas"]
-    },
-    {
-      "id": "creative-director",
-      "display_name": "Valentina",
-      "role": "Creative Director",
-      "department": "brand",
-      "tier": 1,
-      "disc": { "primary": "S", "secondary": "I", "combination": "S+I", "label": "Supporter-Inspirer" },
-      "file": "departments/brand/agents/creative-director.md",
-      "memory_path": "~/.claude/agent-memory/arka-creative-director/MEMORY.md",
-      "key_authority": ["approve_brand", "create_brand", "manage_visuals", "orchestrate"]
-    },
-    {
-      "id": "brand-strategist",
-      "display_name": "Mateus",
-      "role": "Brand Strategist",
-      "department": "brand",
-      "tier": 2,
-      "disc": { "primary": "C", "secondary": "I", "combination": "C+I", "label": "Analyst-Inspirer" },
-      "file": "departments/brand/agents/brand-strategist.md",
-      "memory_path": "~/.claude/agent-memory/arka-brand-strategist/MEMORY.md",
-      "key_authority": ["brand_research", "brand_positioning", "recommend"]
-    },
-    {
-      "id": "visual-designer",
-      "display_name": "Isabel",
-      "role": "Visual Designer",
-      "department": "brand",
-      "tier": 2,
-      "disc": { "primary": "I", "secondary": "S", "combination": "I+S", "label": "Inspirer-Supporter" },
-      "file": "departments/brand/agents/visual-designer.md",
-      "memory_path": "~/.claude/agent-memory/arka-visual-designer/MEMORY.md",
-      "key_authority": ["generate_visuals", "create_assets", "implement"]
-    },
-    {
-      "id": "motion-designer",
-      "display_name": "Rafael",
-      "role": "Motion Designer",
-      "department": "brand",
-      "tier": 2,
-      "disc": { "primary": "D", "secondary": "I", "combination": "D+I", "label": "Driver-Inspirer" },
-      "file": "departments/brand/agents/motion-designer.md",
-      "memory_path": "~/.claude/agent-memory/arka-motion-designer/MEMORY.md",
-      "key_authority": ["generate_video", "create_motion", "implement"]
-    },
-    {
-      "id": "cqo",
-      "display_name": "Marta",
-      "role": "Chief Quality Officer",
-      "department": "quality",
-      "tier": 0,
-      "disc": { "primary": "C", "secondary": "D", "combination": "C+D", "label": "Analyst-Driver" },
-      "file": "departments/quality/agents/cqo.md",
-      "memory_path": "~/.claude/agent-memory/arka-cqo/MEMORY.md",
-      "key_authority": ["veto", "block_delivery", "block_release", "approve_quality"]
-    },
-    {
-      "id": "copy-director",
-      "display_name": "Eduardo",
-      "role": "Copy & Language Director",
-      "department": "quality",
-      "tier": 0,
-      "disc": { "primary": "C", "secondary": "S", "combination": "C+S", "label": "Analyst-Supporter" },
-      "file": "departments/quality/agents/copy-director.md",
-      "memory_path": "~/.claude/agent-memory/arka-copy-director/MEMORY.md",
-      "key_authority": ["veto", "block_delivery"]
-    },
-    {
-      "id": "tech-ux-director",
-      "display_name": "Francisca",
-      "role": "Technical & UX Quality Director",
-      "department": "quality",
-      "tier": 0,
-      "disc": { "primary": "D", "secondary": "C", "combination": "D+C", "label": "Driver-Analyst" },
-      "file": "departments/quality/agents/tech-ux-director.md",
-      "memory_path": "~/.claude/agent-memory/arka-tech-ux-director/MEMORY.md",
-      "key_authority": ["veto", "block_delivery", "block_release"]
-    }
-  ],
-  "team_composition": {
-    "by_disc_primary": { "D": 6, "I": 5, "S": 3, "C": 8 },
-    "by_tier": { "0": 6, "1": 7, "2": 7, "3": 2 },
-    "by_department": { "dev": 9, "finance": 1, "operations": 1, "marketing": 1, "ecommerce": 1, "strategy": 1, "knowledge": 1, "brand": 4, "quality": 3 },
-    "balance_notes": "22 agents across 9 departments. Quality Gate team (Marta, Eduardo, Francisca) adds 3 Tier 0 supervisors. C profile strong at 36% reflecting quality-driven culture."
-  }
-}