arkaos 2.48.0 → 2.49.0

package/VERSION

@@ -1 +1 @@
-2.48.0
+2.49.0

package/config/hooks/stop.sh

@@ -162,6 +162,38 @@ try:
 except Exception:
     pass
 
+# PR30 v2.49.0 — Meta-tag soft block. Mirrors the KB cite-check
+# pipeline. Records whether the closing message carried the required
+# [arka:meta] one-liner; persists result to /tmp/arkaos-meta/<session>.json
+# so the next UserPromptSubmit can surface a nudge if missing.
+meta_passed = True
+meta_reason = "trivial"
+meta_suggestion: str | None = None
+try:
+    from core.governance.meta_tag_check import check_meta_tag
+    mr = check_meta_tag(last)
+    meta_passed = mr.passed
+    meta_reason = mr.reason
+    meta_suggestion = mr.suggestion
+    if safe_sid:
+        prev_umask = os.umask(0o077)
+        try:
+            meta_dir = Path("/tmp/arkaos-meta")
+            meta_dir.mkdir(parents=True, exist_ok=True)
+            meta_path = meta_dir / f"{safe_sid}.json"
+            meta_path.write_text(
+                json.dumps({
+                    "passed": mr.passed,
+                    "reason": mr.reason,
+                    "suggestion": mr.suggestion,
+                }),
+                encoding="utf-8",
+            )
+        finally:
+            os.umask(prev_umask)
+except Exception:
+    pass
+
 entry = {
     "ts": datetime.now(timezone.utc).isoformat(),
     "session_id": session_id,
@@ -178,6 +210,8 @@ entry = {
     "kb_cite_reason": cite_reason,
     "kb_cite_count": cite_count,
     "kb_cite_topic_score": cite_topic_score,
+    "meta_tag_check_passed": meta_passed,
+    "meta_tag_check_reason": meta_reason,
     "mode": "warn",
 }
 

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

@@ -393,11 +393,31 @@ if [ -n "$SESSION_ID" ]; then
   fi
 fi
 
+# ─── Meta-tag nudge (PR30 v2.49.0) ───────────────────────────────────────
+# Mirror of the KB citation nudge but for the [arka:meta] one-liner
+# contract. One-shot; deleted after read.
+_META_TAG_NUDGE=""
+if [ -n "$SESSION_ID" ]; then
+  _META_FILE="/tmp/arkaos-meta/${SESSION_ID}.json"
+  if [ -f "$_META_FILE" ]; then
+    if command -v jq &>/dev/null; then
+      _META_PASSED=$(jq -r '.passed' "$_META_FILE" 2>/dev/null)
+      _META_SUGGEST=$(jq -r '.suggestion // ""' "$_META_FILE" 2>/dev/null)
+      if [ "$_META_PASSED" = "false" ] && [ -n "$_META_SUGGEST" ] && [ "$_META_SUGGEST" != "null" ]; then
+        _META_TAG_NUDGE="[arka:suggest] ${_META_SUGGEST}"
+      fi
+    fi
+    rm -f "$_META_FILE" 2>/dev/null
+  fi
+fi
+
 # ─── Output ──────────────────────────────────────────────────────────────
 _OUT_CONTEXT="${_ARKA_GREETING:-}${_SYNC_NOTICE:-}${_ROUTE_REMINDER}${_WORKFLOW_DIRECTIVE} $python_result"
 [ -n "$_HYGIENE" ] && _OUT_CONTEXT="$_OUT_CONTEXT $_HYGIENE"
 [ -n "$_KB_CITE_NUDGE" ] && _OUT_CONTEXT="$_OUT_CONTEXT
 $_KB_CITE_NUDGE"
+[ -n "$_META_TAG_NUDGE" ] && _OUT_CONTEXT="$_OUT_CONTEXT
+$_META_TAG_NUDGE"
 [ -n "$_ARKA_CONTEXT_HITS" ] && _OUT_CONTEXT="$_OUT_CONTEXT
 $_ARKA_CONTEXT_HITS"
 # Escape for JSON

package/core/governance/meta_tag_check.py

@@ -0,0 +1,63 @@
+"""[arka:meta] one-liner soft-block check (PR30 v2.49.0).
+
+Response-side classifier. Inspects an assistant response for the
+``[arka:meta] kb=N research=X persona=Y gap=Z critic=W`` one-liner
+established by the session-start hook in PR12 v2.34.0.
+
+Soft-block contract — never raises. Hooks consume MetaTagResult and
+decide whether to surface a suggestion. Mirrors the shape of
+``core.governance.kb_cite_check`` (PR18 v2.40.0).
+"""
+
+from __future__ import annotations
+
+import re
+from dataclasses import dataclass
+
+_META_TAG_RE: re.Pattern[str] = re.compile(r"\[arka:meta\]", re.IGNORECASE)
+_BYPASS_DEFAULTS: tuple[str, ...] = ("[arka:trivial]",)
+_TRIVIAL_WORD_THRESHOLD: int = 15
+_SUGGESTION_TEXT: str = (
+    "Meta-tag missing — end substantive responses with a single "
+    "`[arka:meta] kb=N research=X persona=Y gap=Z critic=W` line. "
+    "Fields: kb=N (notes consulted), research=X (MCPs invoked or "
+    "'none'), persona=Y (advisor or 'orchestrator'), gap=Z (KB gap "
+    "or 'none'), critic=W (passed|failed|skipped)."
+)
+
+
+@dataclass(frozen=True)
+class MetaTagResult:
+    """Verdict of a meta-tag check. Immutable; safe to log as JSON."""
+    passed: bool
+    reason: str
+    suggestion: str | None
+
+
+def check_meta_tag(
+    response_text: str,
+    *,
+    bypass_markers: tuple[str, ...] = _BYPASS_DEFAULTS,
+) -> MetaTagResult:
+    """Classify whether a response carries the [arka:meta] one-liner.
+
+    Order matters: a SHORT response *with* the tag still counts as
+    `present` — the trivial-length bypass only short-circuits when
+    the tag genuinely isn't there.
+    """
+    text = response_text or ""
+    if _has_bypass_marker(text, bypass_markers):
+        return MetaTagResult(True, "trivial", None)
+    if _META_TAG_RE.search(text):
+        return MetaTagResult(True, "present", None)
+    if _is_trivial_length(text):
+        return MetaTagResult(True, "trivial", None)
+    return MetaTagResult(False, "missing", _SUGGESTION_TEXT)
+
+
+def _has_bypass_marker(text: str, markers: tuple[str, ...]) -> bool:
+    return any(marker in text for marker in markers)
+
+
+def _is_trivial_length(text: str) -> bool:
+    return len(text.split()) < _TRIVIAL_WORD_THRESHOLD

package/package.json

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

package/pyproject.toml

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