arkaos 4.3.1 → 4.3.3

package/core/workflow/state_reader.sh

@@ -5,6 +5,13 @@
 # Dependencies: jq (required)
 # ============================================================================
 
+# ─── Shared Python resolver (exports ARKA_PY) ──────────────────────────
+# The lib is not a sibling here; try the in-repo path then the installed tree.
+for _l in "$(dirname "${BASH_SOURCE[0]:-$0}")/../../config/hooks/_lib/arka_python.sh" "$HOME/.arkaos/config/hooks/_lib/arka_python.sh"; do
+  if [ -f "$_l" ]; then . "$_l"; break; fi
+done
+: "${ARKA_PY:=python3}"
+
 STATE_FILE="$HOME/.arkaos/workflow-state.json"
 
 if [ ! -f "$STATE_FILE" ]; then
@@ -73,11 +80,11 @@ case "$CMD" in
       echo "none"
       exit 0
     fi
-    if command -v python3 &>/dev/null; then
-      _F_NAME=$(FORGE_FILE="$_FORGE_FILE" python3 -c "import yaml,os; d=yaml.safe_load(open(os.environ['FORGE_FILE'])); print(d.get('name',''))" 2>/dev/null)
-      _F_STATUS=$(FORGE_FILE="$_FORGE_FILE" python3 -c "import yaml,os; d=yaml.safe_load(open(os.environ['FORGE_FILE'])); print(d.get('status',''))" 2>/dev/null)
-      _F_PHASES=$(FORGE_FILE="$_FORGE_FILE" python3 -c "import yaml,os; d=yaml.safe_load(open(os.environ['FORGE_FILE'])); print(len(d.get('plan_phases',[])))" 2>/dev/null)
-      _F_BRANCH=$(FORGE_FILE="$_FORGE_FILE" python3 -c "import yaml,os; d=yaml.safe_load(open(os.environ['FORGE_FILE'])); print(d.get('governance',{}).get('branch_strategy',''))" 2>/dev/null)
+    if command -v "$ARKA_PY" >/dev/null 2>&1; then
+      _F_NAME=$(FORGE_FILE="$_FORGE_FILE" "$ARKA_PY" -c "import yaml,os; d=yaml.safe_load(open(os.environ['FORGE_FILE'])); print(d.get('name',''))" 2>/dev/null)
+      _F_STATUS=$(FORGE_FILE="$_FORGE_FILE" "$ARKA_PY" -c "import yaml,os; d=yaml.safe_load(open(os.environ['FORGE_FILE'])); print(d.get('status',''))" 2>/dev/null)
+      _F_PHASES=$(FORGE_FILE="$_FORGE_FILE" "$ARKA_PY" -c "import yaml,os; d=yaml.safe_load(open(os.environ['FORGE_FILE'])); print(len(d.get('plan_phases',[])))" 2>/dev/null)
+      _F_BRANCH=$(FORGE_FILE="$_FORGE_FILE" "$ARKA_PY" -c "import yaml,os; d=yaml.safe_load(open(os.environ['FORGE_FILE'])); print(d.get('governance',{}).get('branch_strategy',''))" 2>/dev/null)
       echo "${_FORGE_ID}|${_F_NAME}|${_F_STATUS}|${_F_PHASES}|${_F_BRANCH}"
     else
       echo "${_FORGE_ID}|||0|"

package/departments/ops/skills/update/SKILL.md

@@ -23,7 +23,7 @@ Hybrid sync engine: Python handles deterministic operations (MCPs, settings, des
 
 1. **One-stop: npm refresh + engine (PR61 v2.78.0 orchestrator).**
    ```bash
-   cd $ARKAOS_ROOT && python -m core.sync.update_orchestrator --home ~/.arkaos --skills ~/.claude/skills --output json
+   cd $ARKAOS_ROOT && ~/.arkaos/bin/arka-py -m core.sync.update_orchestrator --home ~/.arkaos --skills ~/.claude/skills --output json
    ```
    The orchestrator detects whether the running ArkaOS is behind npm
    latest. When stale, it shells out to `npx arkaos@latest update`
@@ -38,7 +38,7 @@ Hybrid sync engine: Python handles deterministic operations (MCPs, settings, des
    silently skips the npm step and falls through to the engine.
 
    Fallback (no orchestrator): the underlying engine still runs the
-   same way via `python -m core.sync.engine ...` for callers that
+   same way via `~/.arkaos/bin/arka-py -m core.sync.engine ...` for callers that
    don't need the version-drift gate.
 
 2. **Phase 4 (intelligent, AI subagent):** After the engine completes, dispatch ONE subagent with the engine's JSON report + the feature registry (`core/sync/features/*.yaml`). The subagent injects/removes feature sections in each `~/.claude/skills/arka-{ecosystem}/SKILL.md` while preserving all custom content.

package/departments/ops/skills/update/references/sync-engine.md

@@ -7,7 +7,7 @@ Referenced from SKILL.md. Read only when needed.
 Run the sync engine from the ArkaOS repo root:
 
 ```bash
-cd $ARKAOS_ROOT && python -m core.sync.engine --home ~/.arkaos --skills ~/.claude/skills --output json
+cd $ARKAOS_ROOT && ~/.arkaos/bin/arka-py -m core.sync.engine --home ~/.arkaos --skills ~/.claude/skills --output json
 ```
 
 The engine handles deterministic operations and returns a JSON report.

package/departments/quality/SKILL.md

@@ -24,7 +24,7 @@ Any Department Workflow:
   ...
   Phase N-1: QUALITY GATE
     1. Run the evidence engine over the project/diff:
-         python -m core.governance.evidence_checks <project_dir> \
+         ~/.arkaos/bin/arka-py -m core.governance.evidence_checks <project_dir> \
            [--changed-files f1,f2] [--test-command '...'] --json
     2. Marta dispatches Eduardo + Francisca to INTERPRET the report:
        - Eduardo: spellcheck section + prose review of changed copy

package/installer/index.js

@@ -165,6 +165,12 @@ export async function install({ runtime, path, force, skipSystem, withOllama })
       copyFileSync(cmdSrc, join(binDir, "arka-claude.cmd"));
       installed = true;
     }
+    // arka-py — the ArkaOS Python entrypoint SKILL.md commands invoke.
+    const pyPsSrc  = join(ARKAOS_ROOT, "bin", "arka-py.ps1");
+    const pyCmdSrc = join(ARKAOS_ROOT, "bin", "arka-py.cmd");
+    if (existsSync(pyPsSrc))  copyFileSync(pyPsSrc,  join(binDir, "arka-py.ps1"));
+    if (existsSync(pyCmdSrc)) copyFileSync(pyCmdSrc, join(binDir, "arka-py.cmd"));
+    if (existsSync(pyPsSrc) || existsSync(pyCmdSrc)) ok("arka-py interpreter shim installed (.cmd + .ps1)");
     if (installed) {
       ok("arka-claude wrapper installed (.cmd + .ps1)");
       console.log(`         Add to PATH: setx PATH "%PATH%;%USERPROFILE%\\.arkaos\\bin"`);
@@ -179,6 +185,14 @@ export async function install({ runtime, path, force, skipSystem, withOllama })
       console.log(`         Add to PATH: export PATH="$HOME/.arkaos/bin:$PATH"`);
       console.log(`         Optional alias: alias claude="arka-claude"`);
     }
+    // arka-py — the ArkaOS Python entrypoint SKILL.md commands invoke so the
+    // agent never runs a bare `python` that lacks ArkaOS deps (pyyaml, ...).
+    const arkaPySrc = join(ARKAOS_ROOT, "bin", "arka-py");
+    if (existsSync(arkaPySrc)) {
+      copyFileSync(arkaPySrc, join(binDir, "arka-py"));
+      try { chmodSync(join(binDir, "arka-py"), 0o755); } catch {}
+      ok("arka-py interpreter shim installed");
+    }
   }
   const claudeMdSrc = join(ARKAOS_ROOT, "config", "user-claude.md");
   const userClaudeMd = join(homedir(), ".claude", "CLAUDE.md");

package/installer/update.js

@@ -217,6 +217,24 @@ export async function update() {
   }
   console.log("         ✓ Hook scripts updated");
 
+  // Shared hook libraries (config/hooks/_lib/ — the Python interpreter
+  // resolver lives here). Keep in lockstep with index.js::installHooks:
+  // the hooks deployed above source _lib/arka_python.sh from the install
+  // dir, so skipping this copy leaves them falling back to a bare
+  // `python3` without ArkaOS deps.
+  const srcLibDir = join(srcHooksDir, "_lib");
+  if (existsSync(srcLibDir)) {
+    const destLibDir = join(destHooksDir, "_lib");
+    mkdirSync(destLibDir, { recursive: true });
+    cpSync(srcLibDir, destLibDir, { recursive: true });
+    try {
+      for (const f of readdirSync(destLibDir)) {
+        if (f.endsWith(".sh")) chmodSync(join(destLibDir, f), 0o755);
+      }
+    } catch {}
+    console.log("         ✓ Hook lib updated (_lib/)");
+  }
+
   // Re-register hooks in the runtime's settings file.
   // Without this, updating from an older version leaves settings.json
   // frozen at the previous hook spec (missing new hooks, stale timeouts).
@@ -248,6 +266,13 @@ export async function update() {
     if (existsSync(psSrc) || existsSync(cmdSrc)) {
       console.log("         ✓ arka-claude wrapper updated (.cmd + .ps1)");
     }
+    const pyPsSrc  = join(ARKAOS_ROOT, "bin", "arka-py.ps1");
+    const pyCmdSrc = join(ARKAOS_ROOT, "bin", "arka-py.cmd");
+    if (existsSync(pyPsSrc))  copyFileSync(pyPsSrc,  join(binDir, "arka-py.ps1"));
+    if (existsSync(pyCmdSrc)) copyFileSync(pyCmdSrc, join(binDir, "arka-py.cmd"));
+    if (existsSync(pyPsSrc) || existsSync(pyCmdSrc)) {
+      console.log("         ✓ arka-py interpreter shim updated (.cmd + .ps1)");
+    }
   } else {
     const wrapperSrc = join(ARKAOS_ROOT, "bin", "arka-claude");
     if (existsSync(wrapperSrc)) {
@@ -255,6 +280,12 @@ export async function update() {
       try { chmodSync(join(binDir, "arka-claude"), 0o755); } catch {}
       console.log("         ✓ arka-claude wrapper updated");
     }
+    const arkaPySrc = join(ARKAOS_ROOT, "bin", "arka-py");
+    if (existsSync(arkaPySrc)) {
+      copyFileSync(arkaPySrc, join(binDir, "arka-py"));
+      try { chmodSync(join(binDir, "arka-py"), 0o755); } catch {}
+      console.log("         ✓ arka-py interpreter shim updated");
+    }
   }
   const userClaudeMd = join(homedir(), ".claude", "CLAUDE.md");
   const claudeMdSrc = join(ARKAOS_ROOT, "config", "user-claude.md");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "4.3.1",
+  "version": "4.3.3",
   "description": "The Operating System for AI Agent Teams",
   "type": "module",
   "bin": {
@@ -45,7 +45,7 @@
     "departments/",
     "scripts/",
     "config/",
-    "bin/arkaos",
+    "bin/",
     "arka/",
     "knowledge/",
     "dashboard/app/",
@@ -58,5 +58,8 @@
     "CONSTITUTION.md",
     "README.md",
     "LICENSE"
-  ]
+  ],
+  "devDependencies": {
+    "eslint": "^8.57.1"
+  }
 }

package/pyproject.toml

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

package/scripts/seed_initial_patterns.py

@@ -175,7 +175,7 @@ def main() -> int:
     for card in _INITIAL_PATTERNS:
         record_pattern(card)
     print(f"Seeded {len(_INITIAL_PATTERNS)} pattern cards.")
-    print("Inspect: python -m core.knowledge.pattern_cards_cli list")
+    print("Inspect: ~/.arkaos/bin/arka-py -m core.knowledge.pattern_cards_cli list")
     return 0