arkaos 2.17.0 → 2.17.1

package/VERSION

@@ -1 +1 @@
-2.17.0
+2.17.1

package/config/hooks/user-prompt-submit.ps1

@@ -263,8 +263,14 @@ if (-not $pythonResult) {
     $pythonResult = (@($l0, $l4, $l7) | Where-Object { $_ }) -join ' '
 }
 
+# --- Persistent Routing Reminder -------------------------------------------
+# High-salience tag - ensures squad routing persists across conversation turns,
+# and enforces visible KB citation when chunks are present.
+# See: docs/superpowers/specs/2026-04-14-persistent-routing-reminder-design.md
+$routeReminder = '[arka:route] Every response MUST route through a department squad. No generic assistant replies. Announce the squad before responding. When [knowledge:N chunks] is present in this context, you MUST cite at least one source and acknowledge KB was consulted; if absent on a non-trivial ArkaOS topic, query Obsidian before responding.'
+
 # --- Output ----------------------------------------------------------------
-$additionalContext = "$syncNotice$pythonResult"
+$additionalContext = "$syncNotice$routeReminder $pythonResult"
 [pscustomobject]@{ additionalContext = $additionalContext } | ConvertTo-Json -Compress
 
 # --- Metrics (JSONL append) ------------------------------------------------

package/config/hooks/user-prompt-submit.sh

@@ -193,8 +193,14 @@ if [ -f "$_HYGIENE_SCRIPT" ]; then
              bash "$_HYGIENE_SCRIPT" 2>/dev/null)
 fi
 
+# ─── Persistent Routing Reminder ────────────────────────────────────────
+# High-salience tag — ensures squad routing persists across conversation turns,
+# not just on turn 1 when /arka skill content is fresh. See spec:
+# docs/superpowers/specs/2026-04-14-persistent-routing-reminder-design.md
+_ROUTE_REMINDER="[arka:route] Every response MUST route through a department squad. No generic assistant replies. Announce the squad before responding. When [knowledge:N chunks] is present in this context, you MUST cite at least one source and acknowledge KB was consulted; if absent on a non-trivial ArkaOS topic, query Obsidian before responding."
+
 # ─── Output ──────────────────────────────────────────────────────────────
-_OUT_CONTEXT="${_ARKA_GREETING:-}${_SYNC_NOTICE:-}$python_result"
+_OUT_CONTEXT="${_ARKA_GREETING:-}${_SYNC_NOTICE:-}${_ROUTE_REMINDER} $python_result"
 [ -n "$_HYGIENE" ] && _OUT_CONTEXT="$_OUT_CONTEXT $_HYGIENE"
 # Escape for JSON
 _OUT_JSON=$(python3 -c "import json,sys; print(json.dumps(sys.stdin.read()))" <<< "$_OUT_CONTEXT" 2>/dev/null)

package/core/runtime/context_compactor.py

@@ -0,0 +1,63 @@
+"""Rule-based context compactor for subagent handoff.
+
+Builds a compact summary of recent conversation turns, files touched,
+and decisions, sized to fit a token budget. No LLM calls — deterministic
+and zero-latency. An LLM-backed variant may be added later behind a flag
+(see spec: docs/superpowers/specs/2026-04-14-subagent-context-handoff-design.md).
+"""
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+
+@dataclass
+class Turn:
+    """A single conversation turn for compaction."""
+    role: str  # "user" | "assistant"
+    content: str
+    files_touched: list[str] = field(default_factory=list)
+
+
+class ContextCompactor:
+    """Builds compact context summaries for subagent handoff."""
+
+    def build(self, turns: list[Turn], max_tokens: int = 600) -> str:
+        if not turns:
+            return ""
+
+        files: list[str] = []
+        for t in turns:
+            for f in t.files_touched:
+                if f not in files:
+                    files.append(f)
+
+        # Walk turns from most recent backwards, fitting into budget.
+        budget = max_tokens
+        if files:
+            files_line = "Files touched: " + ", ".join(files[:20])
+            budget -= len(files_line.split())
+        else:
+            files_line = ""
+
+        recent_summaries: list[str] = []
+        for turn in reversed(turns):
+            snippet = turn.content.strip().replace("\n", " ")
+            words = snippet.split()
+            if not words:
+                continue
+            label = "USER" if turn.role == "user" else "ASSISTANT"
+            line_words = [label + ":"] + words
+            if len(line_words) > budget:
+                line_words = line_words[: max(1, budget)]
+                if len(line_words) <= 1:
+                    break
+            recent_summaries.insert(0, " ".join(line_words))
+            budget -= len(line_words)
+            if budget <= 0:
+                break
+
+        parts = ["## Prior Context"]
+        if files_line:
+            parts.append(files_line)
+        parts.extend(recent_summaries)
+        return "\n".join(parts)

package/core/runtime/subagent.py

@@ -130,12 +130,25 @@ class SubagentDispatcher:
             task_description: What the subagent should do.
             relevant_files: File paths the subagent should read.
             context_summary: Compacted context from prior work.
+                Required when ARKAOS_STRICT_HANDOFF=1; otherwise emits a
+                warning. Use ContextCompactor.build() to construct.
             constraints: Boundaries for the subagent.
             expected_output: What format/content is expected back.
 
         Returns:
             HandoffArtifact ready for dispatch.
         """
+        import os, warnings
+        if not context_summary or not context_summary.strip():
+            msg = (
+                "create_handoff called without context_summary — subagent will "
+                "lack prior conversation context. Use ContextCompactor.build() "
+                "to construct one. Set ARKAOS_STRICT_HANDOFF=1 to enforce."
+            )
+            if os.environ.get("ARKAOS_STRICT_HANDOFF") == "1":
+                raise ValueError(msg)
+            warnings.warn(msg, DeprecationWarning, stacklevel=2)
+
         self._task_counter += 1
         task_id = f"task-{self._task_counter}"
 

package/package.json

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

package/pyproject.toml

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