arkaos 4.3.1 → 4.3.3

package/bin/arka-py

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+# ============================================================================
+# ArkaOS — Python entrypoint for agents and scripts.
+#
+# Resolves the ArkaOS interpreter (venv-first, via the shared resolver) and
+# execs it, so callers never depend on the ambient `python` having ArkaOS
+# deps (pyyaml, pydantic, ...). This is what SKILL.md commands invoke instead
+# of a bare `python -m core...` — the failure mode that broke `/arka update`
+# when the session's `python` had no yaml.
+#
+# Usage:  arka-py -m core.sync.update_orchestrator ...
+#         arka-py path/to/script.py ...
+#         arka-py -c "import core; ..."
+# ============================================================================
+set -euo pipefail
+
+# ─── Source the shared resolver, from the repo or the installed location ──
+_self="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
+for _lib in \
+    "$_self/../config/hooks/_lib/arka_python.sh" \
+    "$HOME/.arkaos/config/hooks/_lib/arka_python.sh"; do
+  if [ -f "$_lib" ]; then
+    # shellcheck source=/dev/null
+    # The resolver's ARKA_PY assignment is `|| true`-guarded internally, so
+    # sourcing never aborts under `set -e` even when it falls back.
+    . "$_lib"
+    break
+  fi
+done
+: "${ARKA_PY:=python3}"
+
+# ─── Make `-m core.*` resolvable regardless of cwd ────────────────────────
+# ARKAOS_ROOT (env) wins; else the installed repo pointer; else the repo this
+# shim lives in (dev checkout: bin/ -> repo root).
+_root="${ARKAOS_ROOT:-}"
+if [ -z "$_root" ] && [ -f "$HOME/.arkaos/.repo-path" ]; then
+  _root="$(cat "$HOME/.arkaos/.repo-path" 2>/dev/null || true)"
+fi
+if [ -z "$_root" ] && [ -f "$_self/../core/hooks/__init__.py" ]; then
+  _root="$(cd "$_self/.." && pwd)"
+fi
+if [ -n "$_root" ] && [ -d "$_root" ]; then
+  export PYTHONPATH="${_root}${PYTHONPATH:+:$PYTHONPATH}"
+fi
+
+exec "$ARKA_PY" "$@"

package/bin/arka-py.cmd

@@ -0,0 +1,9 @@
+@echo off
+REM ==========================================================================
+REM ArkaOS - Python entrypoint (cmd shim)
+REM
+REM Dispatches to bin\arka-py.ps1, forwarding all arguments, so `arka-py ...`
+REM works from cmd.exe, PowerShell, and Windows Terminal alike.
+REM ==========================================================================
+powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -File "%~dp0arka-py.ps1" %*
+exit /b %ERRORLEVEL%

package/bin/arka-py.ps1

@@ -0,0 +1,36 @@
+# ============================================================================
+# ArkaOS - Python entrypoint (Windows / PowerShell 5.1+)
+#
+# Port of bin/arka-py. Resolves the ArkaOS interpreter (venv-first, via the
+# shared PowerShell resolver) and execs it, so SKILL.md commands never run a
+# bare `python` that lacks ArkaOS deps (pyyaml, ...).
+#
+# Usage:  arka-py -m core.sync.update_orchestrator ...
+# Normally invoked through its .cmd shim (bin/arka-py.cmd).
+# ============================================================================
+$ErrorActionPreference = "Stop"
+
+# ─── Source the shared resolver, from the repo or the installed location ──
+$self = if ($PSScriptRoot) { $PSScriptRoot } else { Split-Path -Parent $MyInvocation.MyCommand.Path }
+$libs = @(
+    (Join-Path $self "..\config\hooks\_lib\arka_python.ps1"),
+    (Join-Path (if ($env:USERPROFILE) { $env:USERPROFILE } else { $HOME }) ".arkaos\config\hooks\_lib\arka_python.ps1")
+)
+foreach ($lib in $libs) {
+    if (Test-Path -LiteralPath $lib) { . $lib; break }
+}
+if (-not $env:ARKA_PY) { $env:ARKA_PY = "python" }
+
+# ─── Make `-m core.*` resolvable regardless of cwd ────────────────────────
+$root = $env:ARKAOS_ROOT
+if (-not $root) {
+    $rp = Join-Path (if ($env:USERPROFILE) { $env:USERPROFILE } else { $HOME }) ".arkaos\.repo-path"
+    if (Test-Path -LiteralPath $rp) { $root = (Get-Content -LiteralPath $rp -Raw).Trim() }
+}
+if ($root -and (Test-Path -LiteralPath $root)) {
+    $sep = [IO.Path]::PathSeparator
+    $env:PYTHONPATH = if ($env:PYTHONPATH) { "$root$sep$env:PYTHONPATH" } else { $root }
+}
+
+& $env:ARKA_PY @args
+exit $LASTEXITCODE

package/bin/arka-registry-gen

@@ -0,0 +1,185 @@
+#!/usr/bin/env bash
+# ============================================================================
+# ARKA OS — Commands Registry Generator
+# Scans SKILL.md files + keyword data to generate commands-registry.json
+# Usage: bash bin/arka-registry-gen
+# ============================================================================
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+KEYWORDS_FILE="$REPO_DIR/knowledge/commands-keywords.json"
+OUTPUT_FILE="$REPO_DIR/knowledge/commands-registry.json"
+ARKA_OS="${ARKA_OS:-$HOME/.claude/skills/arka}"
+TEMP_COMMANDS=$(mktemp)
+trap 'rm -f "$TEMP_COMMANDS"' EXIT
+
+# Require jq
+command -v jq &>/dev/null || { echo "Error: jq is required. Install: brew install jq"; exit 1; }
+
+# ─── Helper: Map department directory name to command prefix ───────────────
+dept_prefix_for() {
+  case "$1" in
+    dev)        echo "dev" ;;
+    marketing)  echo "mkt" ;;
+    ecommerce)  echo "ecom" ;;
+    finance)    echo "fin" ;;
+    operations) echo "ops" ;;
+    strategy)   echo "strat" ;;
+    knowledge)  echo "kb" ;;
+    brand)      echo "brand" ;;
+    *)          echo "$1" ;;
+  esac
+}
+
+# ─── Helper: Detect metadata for a command ─────────────────────────────────
+get_metadata() {
+  local command="$1"
+  local rw="false" mc="false" tier=2
+
+  case "$command" in
+    "/dev feature"*|"/dev api"*|"/dev debug"*|"/dev refactor"*|"/dev db"*)
+      rw="true"; mc="true"; tier=1 ;;
+    "/dev scaffold"*|"/dev deploy"*|"/dev test"*)
+      mc="true" ;;
+    "/dev security-audit"*)
+      tier=1 ;;
+  esac
+  echo "$rw $mc $tier"
+}
+
+# ─── Helper: Extract commands from a SKILL.md file ────────────────────────
+# Parses markdown tables: | `/<prefix> <command> [args]` | description |
+extract_commands() {
+  local file="$1"
+  local department="$2"
+  local source="${3:-builtin}"
+
+  [ -f "$file" ] || return 0
+
+  # Extract lead agent from frontmatter
+  local lead_agent=""
+  lead_agent=$(sed -n '/^---$/,/^---$/{ /^name:/s/.*: *//p; }' "$file" 2>/dev/null | head -1 | xargs 2>/dev/null || echo "")
+
+  # Parse command table rows
+  # Match: | `/<word> <word>...` | description |
+  # The backtick-wrapped command must START with / immediately after the backtick
+  grep -E '^\| *`/[a-z]' "$file" 2>/dev/null | while IFS= read -r line; do
+    # Extract command from backticks
+    local command
+    command=$(echo "$line" | sed -n 's/.*`\(\/[^`]*\)`.*/\1/p' | xargs 2>/dev/null)
+    [ -z "$command" ] && continue
+
+    # Extract description (second column)
+    local description
+    description=$(echo "$line" | sed 's/^[^|]*|[^|]*| *//' | sed 's/ *|.*//' | sed 's/^ *//;s/ *$//' | sed 's/^— *//;s/^- *//')
+    [ -z "$description" ] && continue
+    # Skip if description looks like a separator
+    echo "$description" | grep -qE '^[-]+$' && continue
+
+    # Generate command ID: /dev feature <desc> -> dev-feature
+    local id
+    id=$(echo "$command" | sed 's/ *<[^>]*>//g' | sed 's/ *\[.*//g' | sed 's/^\/\([^ ]*\) *\(.*\)/\1-\2/' | sed 's/-$//' | sed 's/ /-/g')
+    [ -z "$id" ] && continue
+
+    # Get metadata
+    local meta
+    meta=$(get_metadata "$command")
+    local rw mc tier
+    rw=$(echo "$meta" | cut -d' ' -f1)
+    mc=$(echo "$meta" | cut -d' ' -f2)
+    tier=$(echo "$meta" | cut -d' ' -f3)
+
+    # Output JSON line
+    jq -nc \
+      --arg id "$id" \
+      --arg command "$command" \
+      --arg department "$department" \
+      --arg description "$description" \
+      --arg lead_agent "$lead_agent" \
+      --argjson tier "$tier" \
+      --argjson requires_branch "$rw" \
+      --argjson modifies_code "$mc" \
+      --arg source "$source" \
+      '{id:$id,command:$command,department:$department,description:$description,lead_agent:$lead_agent,tier:$tier,requires_branch:$requires_branch,modifies_code:$modifies_code,keywords:[],examples:[],source:$source}'
+  done
+}
+
+# ─── Collect commands from all SKILL.md files ─────────────────────────────
+
+# Main orchestrator
+extract_commands "$REPO_DIR/arka/SKILL.md" "arka" >> "$TEMP_COMMANDS"
+
+# Department SKILL.md files
+for dept_dir in "$REPO_DIR"/departments/*/; do
+  [ -d "$dept_dir" ] || continue
+  dept_name=$(basename "$dept_dir")
+  dept_prefix=$(dept_prefix_for "$dept_name")
+
+  # Main department skill
+  [ -f "${dept_dir}SKILL.md" ] && extract_commands "${dept_dir}SKILL.md" "$dept_prefix" >> "$TEMP_COMMANDS"
+
+  # Sub-skills
+  for sub_skill in "${dept_dir}skills"/*/SKILL.md; do
+    [ -f "$sub_skill" ] || continue
+    extract_commands "$sub_skill" "$dept_prefix" >> "$TEMP_COMMANDS"
+  done
+done
+
+# External skills
+for ext_skill in "$HOME/.claude/skills"/arka-ext-*/SKILL.md; do
+  [ -f "$ext_skill" ] || continue
+  ext_name=$(basename "$(dirname "$ext_skill")" | sed 's/^arka-ext-//')
+  extract_commands "$ext_skill" "$ext_name" "external" >> "$TEMP_COMMANDS"
+done
+
+# Pro skills
+for pro_skill in "$HOME/.claude/skills"/arka-pro-*/SKILL.md; do
+  [ -f "$pro_skill" ] || continue
+  pro_name=$(basename "$(dirname "$pro_skill")" | sed 's/^arka-pro-//')
+  extract_commands "$pro_skill" "$pro_name" "pro" >> "$TEMP_COMMANDS"
+done
+
+# ─── Build commands array from temp file ───────────────────────────────────
+if [ -s "$TEMP_COMMANDS" ]; then
+  COMMANDS_JSON=$(jq -s '.' "$TEMP_COMMANDS")
+else
+  COMMANDS_JSON="[]"
+fi
+
+# ─── Deduplicate by command ID (keep first occurrence) ─────────────────────
+COMMANDS_JSON=$(echo "$COMMANDS_JSON" | jq '[group_by(.id) | .[] | .[0]]')
+
+# ─── Merge keywords and examples from seed data ───────────────────────────
+if [ -f "$KEYWORDS_FILE" ]; then
+  COMMANDS_JSON=$(jq --slurpfile kw "$KEYWORDS_FILE" '
+    [.[] | . as $cmd |
+      if $kw[0][$cmd.id] then
+        .keywords = ($kw[0][$cmd.id].keywords // []) |
+        .examples = ($kw[0][$cmd.id].examples // [])
+      else . end
+    ]
+  ' <<< "$COMMANDS_JSON")
+fi
+
+# ─── Build final registry ─────────────────────────────────────────────────
+TOTAL=$(echo "$COMMANDS_JSON" | jq 'length')
+NOW=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+
+jq -n \
+  --arg version "1.0.0" \
+  --arg generated "$NOW" \
+  --argjson total "$TOTAL" \
+  --arg generator "bin/arka-registry-gen" \
+  --argjson commands "$COMMANDS_JSON" \
+  '{
+    _meta: {
+      version: $version,
+      generated: $generated,
+      total_commands: $total,
+      generator: $generator
+    },
+    commands: $commands
+  }' > "$OUTPUT_FILE"
+
+echo "Registry generated: $OUTPUT_FILE ($TOTAL commands)"

package/bin/arka-skill

@@ -0,0 +1,300 @@
+#!/usr/bin/env bash
+# ============================================================================
+# ARKA OS — External Skill Manager
+# Install, list, remove, and update external skills.
+# ============================================================================
+set -e
+
+CYAN='\033[0;36m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m'
+
+ARKA_OS="${ARKA_OS:-$HOME/.claude/skills/arka}"
+EXT_DIR="$HOME/.arka-os/ext-skills"
+EXT_REGISTRY="$HOME/.arka-os/ext-registry.json"
+SKILLS_DIR="$HOME/.claude/skills"
+AGENTS_DIR="$HOME/.claude/agents"
+
+mkdir -p "$EXT_DIR" "$SKILLS_DIR" "$AGENTS_DIR"
+
+# Ensure ext-registry exists
+if [ ! -f "$EXT_REGISTRY" ]; then
+    echo '{"_meta":{"format_version":1},"skills":{}}' | jq '.' > "$EXT_REGISTRY"
+fi
+
+usage() {
+    echo -e "${CYAN}ARKA OS — External Skill Manager${NC}"
+    echo ""
+    echo "Usage: arka skill <command> [args]"
+    echo ""
+    echo "Commands:"
+    echo "  install <github-url>   Install an external skill"
+    echo "  list                   List installed external skills"
+    echo "  remove <name>          Remove an external skill"
+    echo "  update <name>          Update an external skill"
+    echo "  create <name>          Scaffold a new skill from template"
+    echo ""
+}
+
+# Version comparison (semver >=)
+version_gte() {
+    # $1 = current version, $2 = required version (e.g., ">=0.2.0")
+    local required="${2#>=}"
+    [ "$(printf '%s\n' "$required" "$1" | sort -V | head -1)" = "$required" ]
+}
+
+cmd_install() {
+    local url="$1"
+    if [ -z "$url" ]; then
+        echo -e "${RED}Error: GitHub URL required.${NC}"
+        echo "Usage: arka skill install <github-url>"
+        exit 1
+    fi
+
+    # Derive name from URL
+    local name
+    name=$(basename "$url" .git)
+
+    echo -e "${CYAN}Installing external skill: ${name}${NC}"
+    echo ""
+
+    # Step 1: Clone
+    local clone_dir="$EXT_DIR/$name"
+    if [ -d "$clone_dir" ]; then
+        echo -e "${YELLOW}Skill already installed. Use 'arka skill update $name' instead.${NC}"
+        exit 1
+    fi
+
+    git clone "$url" "$clone_dir"
+
+    # Step 2: Validate
+    if [ ! -f "$clone_dir/SKILL.md" ]; then
+        echo -e "${RED}Error: SKILL.md not found. Not a valid ARKA OS skill.${NC}"
+        rm -rf "$clone_dir"
+        exit 1
+    fi
+    if [ ! -f "$clone_dir/arka-skill.json" ]; then
+        echo -e "${RED}Error: arka-skill.json not found. Not a valid ARKA OS skill.${NC}"
+        rm -rf "$clone_dir"
+        exit 1
+    fi
+
+    # Step 3: Read metadata
+    local skill_version skill_desc skill_author requires_arka
+    skill_version=$(jq -r '.version' "$clone_dir/arka-skill.json")
+    skill_desc=$(jq -r '.description' "$clone_dir/arka-skill.json")
+    skill_author=$(jq -r '.author' "$clone_dir/arka-skill.json")
+    requires_arka=$(jq -r '.requires_arka_version // ""' "$clone_dir/arka-skill.json")
+
+    # Step 4: Check version compatibility
+    if [ -n "$requires_arka" ] && [ -f "$ARKA_OS/VERSION" ]; then
+        local current_version
+        current_version=$(cat "$ARKA_OS/VERSION" | tr -d '[:space:]')
+        if ! version_gte "$current_version" "$requires_arka"; then
+            echo -e "${RED}Error: Skill requires ARKA OS $requires_arka, but you have v$current_version${NC}"
+            rm -rf "$clone_dir"
+            exit 1
+        fi
+    fi
+
+    # Step 5: Install SKILL.md
+    local skill_install_dir="$SKILLS_DIR/arka-ext-$name"
+    mkdir -p "$skill_install_dir"
+    cp "$clone_dir/SKILL.md" "$skill_install_dir/SKILL.md"
+    echo -e "  ${GREEN}✓${NC} Skill: $name"
+
+    # Step 6: Install agents (if any)
+    local agent_count=0
+    if [ -d "$clone_dir/agents" ]; then
+        for agent_file in "$clone_dir"/agents/*.md; do
+            if [ -f "$agent_file" ]; then
+                local agent_base
+                agent_base=$(basename "$agent_file" .md)
+                cp "$agent_file" "$AGENTS_DIR/arka-ext-${name}-${agent_base}.md"
+                echo -e "  ${GREEN}✓${NC} Agent: $agent_base"
+                agent_count=$((agent_count + 1))
+            fi
+        done
+    fi
+
+    # Step 7: Merge external MCPs (if any)
+    if [ -f "$clone_dir/mcps/registry-ext.json" ] && [ -f "$ARKA_OS/mcps/registry.json" ]; then
+        # Merge without overwriting built-in MCPs
+        local temp_registry
+        temp_registry=$(mktemp)
+        jq -s '
+            .[0] as $base |
+            .[1].mcpServers as $ext |
+            $base | .mcpServers += ($ext // {} | to_entries | map(select(.key as $k | $base.mcpServers[$k] == null)) | from_entries)
+        ' "$ARKA_OS/mcps/registry.json" "$clone_dir/mcps/registry-ext.json" > "$temp_registry"
+        cp "$temp_registry" "$ARKA_OS/mcps/registry.json"
+        rm "$temp_registry"
+        echo -e "  ${GREEN}✓${NC} External MCPs merged"
+    fi
+
+    # Step 8: Register in ext-registry
+    jq --arg name "$name" --arg version "$skill_version" --arg desc "$skill_desc" \
+        --arg author "$skill_author" --arg url "$url" --arg date "$(date +%Y-%m-%d)" \
+        '.skills[$name] = {"version": $version, "description": $desc, "author": $author, "url": $url, "installed": $date}' \
+        "$EXT_REGISTRY" > "${EXT_REGISTRY}.tmp" && mv "${EXT_REGISTRY}.tmp" "$EXT_REGISTRY"
+
+    # Step 9: Report
+    echo ""
+    echo -e "${GREEN}═══ Skill Installed ═══${NC}"
+    echo -e "  Name:     ${CYAN}$name${NC} v$skill_version"
+    echo -e "  Author:   ${CYAN}$skill_author${NC}"
+    echo -e "  Desc:     $skill_desc"
+    echo -e "  Agents:   ${CYAN}$agent_count${NC}"
+    echo -e "${GREEN}═══════════════════════${NC}"
+}
+
+cmd_list() {
+    echo -e "${CYAN}ARKA OS — External Skills${NC}"
+    echo ""
+
+    local count
+    count=$(jq '.skills | length' "$EXT_REGISTRY" 2>/dev/null || echo "0")
+
+    if [ "$count" = "0" ]; then
+        echo "  No external skills installed."
+        echo ""
+        echo "  Install one: arka skill install <github-url>"
+        return
+    fi
+
+    jq -r '.skills | to_entries[] | "  \(.key)\tv\(.value.version)\t\(.value.description)"' "$EXT_REGISTRY" | column -t -s $'\t'
+    echo ""
+    echo -e "  Total: ${CYAN}$count${NC} skill(s)"
+}
+
+cmd_remove() {
+    local name="$1"
+    if [ -z "$name" ]; then
+        echo -e "${RED}Error: Skill name required.${NC}"
+        echo "Usage: arka skill remove <name>"
+        exit 1
+    fi
+
+    echo -e "${CYAN}Removing external skill: ${name}${NC}"
+
+    # Remove cloned source
+    [ -d "$EXT_DIR/$name" ] && rm -rf "$EXT_DIR/$name" && echo -e "  ${GREEN}✓${NC} Removed source"
+
+    # Remove installed skill
+    [ -d "$SKILLS_DIR/arka-ext-$name" ] && rm -rf "$SKILLS_DIR/arka-ext-$name" && echo -e "  ${GREEN}✓${NC} Removed skill"
+
+    # Remove installed agents
+    for agent in "$AGENTS_DIR"/arka-ext-${name}-*.md; do
+        [ -f "$agent" ] && rm "$agent" && echo -e "  ${GREEN}✓${NC} Removed $(basename "$agent")"
+    done
+
+    # Remove from registry
+    jq --arg name "$name" 'del(.skills[$name])' "$EXT_REGISTRY" > "${EXT_REGISTRY}.tmp" && mv "${EXT_REGISTRY}.tmp" "$EXT_REGISTRY"
+    echo -e "  ${GREEN}✓${NC} Removed from registry"
+
+    echo -e "${GREEN}Skill '$name' removed.${NC}"
+}
+
+cmd_update() {
+    local name="$1"
+    if [ -z "$name" ]; then
+        echo -e "${RED}Error: Skill name required.${NC}"
+        echo "Usage: arka skill update <name>"
+        exit 1
+    fi
+
+    local clone_dir="$EXT_DIR/$name"
+    if [ ! -d "$clone_dir/.git" ]; then
+        echo -e "${RED}Error: Skill '$name' not found.${NC}"
+        exit 1
+    fi
+
+    echo -e "${CYAN}Updating external skill: ${name}${NC}"
+
+    # Pull latest
+    cd "$clone_dir" && git pull --ff-only
+
+    # Re-install SKILL.md
+    local skill_install_dir="$SKILLS_DIR/arka-ext-$name"
+    mkdir -p "$skill_install_dir"
+    cp "$clone_dir/SKILL.md" "$skill_install_dir/SKILL.md"
+    echo -e "  ${GREEN}✓${NC} Skill updated"
+
+    # Re-install agents
+    if [ -d "$clone_dir/agents" ]; then
+        for agent_file in "$clone_dir"/agents/*.md; do
+            if [ -f "$agent_file" ]; then
+                local agent_base
+                agent_base=$(basename "$agent_file" .md)
+                cp "$agent_file" "$AGENTS_DIR/arka-ext-${name}-${agent_base}.md"
+                echo -e "  ${GREEN}✓${NC} Agent: $agent_base"
+            fi
+        done
+    fi
+
+    # Update registry version
+    local skill_version
+    skill_version=$(jq -r '.version' "$clone_dir/arka-skill.json" 2>/dev/null || echo "unknown")
+    jq --arg name "$name" --arg version "$skill_version" \
+        '.skills[$name].version = $version' \
+        "$EXT_REGISTRY" > "${EXT_REGISTRY}.tmp" && mv "${EXT_REGISTRY}.tmp" "$EXT_REGISTRY"
+
+    echo -e "${GREEN}Skill '$name' updated to v$skill_version.${NC}"
+}
+
+cmd_create() {
+    local name="$1"
+    if [ -z "$name" ]; then
+        echo -e "${RED}Error: Skill name required.${NC}"
+        echo "Usage: arka skill create <name>"
+        exit 1
+    fi
+
+    local template_dir="$ARKA_OS/skill-template"
+    local target_dir="./$name"
+
+    if [ -d "$target_dir" ]; then
+        echo -e "${RED}Error: Directory '$name' already exists.${NC}"
+        exit 1
+    fi
+
+    echo -e "${CYAN}Creating new skill: ${name}${NC}"
+
+    mkdir -p "$target_dir/agents" "$target_dir/mcps"
+
+    # Copy and process templates
+    if [ -f "$template_dir/SKILL.md.template" ]; then
+        sed "s/{{SKILL_NAME}}/$name/g" "$template_dir/SKILL.md.template" > "$target_dir/SKILL.md"
+    fi
+
+    if [ -f "$template_dir/arka-skill.json.template" ]; then
+        sed "s/{{SKILL_NAME}}/$name/g" "$template_dir/arka-skill.json.template" > "$target_dir/arka-skill.json"
+    fi
+
+    if [ -f "$template_dir/README.md.template" ]; then
+        sed "s/{{SKILL_NAME}}/$name/g" "$template_dir/README.md.template" > "$target_dir/README.md"
+    fi
+
+    echo -e "  ${GREEN}✓${NC} Created $target_dir/"
+    echo -e "  ${GREEN}✓${NC} SKILL.md"
+    echo -e "  ${GREEN}✓${NC} arka-skill.json"
+    echo -e "  ${GREEN}✓${NC} README.md"
+    echo ""
+    echo -e "Next steps:"
+    echo -e "  1. Edit ${CYAN}$target_dir/SKILL.md${NC} with your skill definition"
+    echo -e "  2. Edit ${CYAN}$target_dir/arka-skill.json${NC} with metadata"
+    echo -e "  3. Add agents to ${CYAN}$target_dir/agents/${NC} (optional)"
+    echo -e "  4. Push to GitHub and install with: ${CYAN}arka skill install <url>${NC}"
+}
+
+# Main routing
+case "${1:-}" in
+    install) shift; cmd_install "$@" ;;
+    list)    cmd_list ;;
+    remove)  shift; cmd_remove "$@" ;;
+    update)  shift; cmd_update "$@" ;;
+    create)  shift; cmd_create "$@" ;;
+    *)       usage ;;
+esac

package/bin/scheduler-daemon.py

@@ -0,0 +1,48 @@
+#!/usr/bin/env python3
+"""ArkaOS Scheduler Daemon — entry point for launchd/systemd/schtasks.
+
+Runs in a loop, checking every 60 seconds whether any scheduled cognitive
+task (Dreaming, Research) should execute at the current time.
+"""
+
+import sys
+import time
+from pathlib import Path
+
+# Ensure ArkaOS core is importable
+ARKAOS_ROOT = Path(__file__).resolve().parent.parent
+if str(ARKAOS_ROOT) not in sys.path:
+    sys.path.insert(0, str(ARKAOS_ROOT))
+
+from core.cognition.scheduler.daemon import ArkaScheduler  # noqa: E402
+
+HOME = Path.home()
+CONFIG_PATH = str(HOME / ".arkaos" / "schedules.yaml")
+LOG_DIR = str(HOME / ".arkaos" / "logs")
+LOCK_PATH = str(HOME / ".arkaos" / "scheduler.lock")
+
+
+def main() -> None:
+    scheduler = ArkaScheduler(
+        config_path=CONFIG_PATH,
+        log_dir=LOG_DIR,
+        lock_path=LOCK_PATH,
+    )
+
+    if not scheduler.acquire_lock():
+        print("Another scheduler instance is already running. Exiting.")
+        sys.exit(1)
+
+    print(f"ArkaOS Scheduler started — {len(scheduler.schedules)} tasks loaded")
+    try:
+        while True:
+            scheduler.run_once()
+            time.sleep(60)
+    except KeyboardInterrupt:
+        print("Scheduler stopped.")
+    finally:
+        scheduler.release_lock()
+
+
+if __name__ == "__main__":
+    main()

package/config/claude-agents/marta-cqo.md

@@ -23,7 +23,7 @@ evidence, not from model size.
 ## Review Rubric (evidence interpretation, not role-play)
 
 1. Run the engine first — no verdict without a report:
-   `python -m core.governance.evidence_checks <project_dir> [--changed-files ...] [--test-command '...'] --json`
+   `~/.arkaos/bin/arka-py -m core.governance.evidence_checks <project_dir> [--changed-files ...] [--test-command '...'] --json`
 2. Dispatch Eduardo (spellcheck + changed copy) and Francisca
    (lint/typecheck/tests/coverage/security-grep) with the report and the
    structured output schema `QG_VERDICT_JSON_SCHEMA` from

package/config/claude-agents/paulo-tech-lead.md

@@ -24,7 +24,7 @@ not cut corners to look fast.
    dispatch with `[arka:dispatch] paulo -> <specialist>`.
 3. Evidence over narration: a task is done when its tests RAN and exited 0
    on record — never when a subagent says it is done. Run
-   `python -m core.governance.evidence_checks <project_dir> --json` before
+   `~/.arkaos/bin/arka-py -m core.governance.evidence_checks <project_dir> --json` before
    claiming completion.
 4. Submit to the Quality Gate (marta-cqo) with the evidence report; expect
    a structured `QGVerdict` back. REJECTED means loop, not negotiate.