arkaos 3.75.0 → 3.75.1

package/VERSION

@@ -1 +1 @@
-3.75.0
+3.75.1

package/arka/skills/flow/SKILL.md

@@ -171,9 +171,21 @@ For each item, in order:
    bookkeeping. The L2.6 Synapse layer
    (`core/synapse/agent_experiences_layer.py`) injects the lessons
    into the next dispatch automatically. APPROVED verdicts produce no
-   record (only failures are lessons). If a specialist is
-   missing, stop and advise the user
-   to create one via `/arka personas` + provide the knowledge.
+   `Experience` record (only failures are lessons).
+
+   **Pattern auto-stub convention (PR4.5 v3.75.1):** to populate the
+   Pattern Library on APPROVED outcomes, the orchestrator may include
+   `[arka:pattern-suggest <id> <name>]` in the CQO dispatch prompt
+   (e.g. `[arka:pattern-suggest force-specialist-dispatch Force
+   Specialist Dispatch]`). On APPROVED, the same PostToolUse hook
+   creates a stub `PatternCard` so the library remembers the feature
+   ID and name; the operator enriches it later via `record_pattern()`
+   or by editing `~/.arkaos/patterns/cards.jsonl`. Re-suggesting an
+   existing id is a no-op (never overwrites enriched cards).
+
+   If a specialist is missing, stop and advise the user to create one
+   via `/arka personas` + provide the knowledge.
+
    - Fail → back to the todo.
 6. Document — save the completed work to Obsidian + vector DB.
 7. Next todo.

package/config/agent-ownership.yaml

@@ -148,6 +148,15 @@ ownership:
     owners: [architect, security-eng]
     reason: "Governance code requires architecture + security review"
 
+  # PR4.5 v3.75.1 — extend coverage to knowledge + synapse (Marta PR4-QG #4)
+  - pattern: "core/knowledge/**/*.py"
+    owners: [architect, senior-dev]
+    reason: "Knowledge storage + retrieval require architecture review"
+
+  - pattern: "core/synapse/**/*.py"
+    owners: [architect, senior-dev]
+    reason: "Synapse engine + layers require architecture review"
+
   - pattern: "docs/adr/**"
     owners: [architect]
     reason: "ADRs are architect's responsibility"

package/config/hooks/post-tool-use.sh

@@ -81,23 +81,26 @@ fi
 # `agent-experience-persistence`). Never blocks the hook.
 if [ "$TOOL_NAME" = "Task" ] || [ "$TOOL_NAME" = "Agent" ]; then
   SUBAGENT_TYPE=$(echo "$input" | jq -r '.tool_input.subagent_type // ""' 2>/dev/null)
-  if [ "$SUBAGENT_TYPE" = "cqo" ] && echo "$TOOL_OUTPUT" | grep -qE 'Quality Gate Verdict:[[:space:]]*REJECTED'; then
+  if [ "$SUBAGENT_TYPE" = "cqo" ]; then
     TOOL_INPUT_PROMPT=$(echo "$input" | jq -r '.tool_input.prompt // ""' 2>/dev/null)
-    REVIEWING_TARGET=$(printf '%s' "$TOOL_INPUT_PROMPT" \
-      | grep -oE '\[arka:reviewing[[:space:]]+[A-Za-z0-9_.-]+\]' \
-      | head -1 \
-      | sed -E 's/.*\[arka:reviewing[[:space:]]+([A-Za-z0-9_.-]+)\].*/\1/')
-    if [ -n "$REVIEWING_TARGET" ]; then
-      _AE_ROOT="${ARKAOS_ROOT:-}"
-      if [ -z "$_AE_ROOT" ] && [ -f "$HOME/.arkaos/.repo-path" ]; then
-        _AE_ROOT=$(cat "$HOME/.arkaos/.repo-path" 2>/dev/null)
-      fi
-      [ -z "$_AE_ROOT" ] && _AE_ROOT="$HOME/.arkaos"
-      VERDICT_TEXT="$TOOL_OUTPUT" \
-      AGENT_ID="$REVIEWING_TARGET" \
-      SESSION_ID="$SESSION_ID_PTU" \
-      ARKAOS_ROOT="$_AE_ROOT" \
-      python3 - <<'PY' 2>/dev/null || true
+    _AE_ROOT="${ARKAOS_ROOT:-}"
+    if [ -z "$_AE_ROOT" ] && [ -f "$HOME/.arkaos/.repo-path" ]; then
+      _AE_ROOT=$(cat "$HOME/.arkaos/.repo-path" 2>/dev/null)
+    fi
+    [ -z "$_AE_ROOT" ] && _AE_ROOT="$HOME/.arkaos"
+
+    # ─── REJECTED → experience auto-record ────────────────────────────
+    if echo "$TOOL_OUTPUT" | grep -qE 'Quality Gate Verdict:[[:space:]]*REJECTED'; then
+      REVIEWING_TARGET=$(printf '%s' "$TOOL_INPUT_PROMPT" \
+        | grep -oE '\[arka:reviewing[[:space:]]+[A-Za-z0-9_.-]+\]' \
+        | head -1 \
+        | sed -E 's/.*\[arka:reviewing[[:space:]]+([A-Za-z0-9_.-]+)\].*/\1/')
+      if [ -n "$REVIEWING_TARGET" ]; then
+        VERDICT_TEXT="$TOOL_OUTPUT" \
+        AGENT_ID="$REVIEWING_TARGET" \
+        SESSION_ID="$SESSION_ID_PTU" \
+        ARKAOS_ROOT="$_AE_ROOT" \
+        python3 - <<'PY' 2>/dev/null || true
 import os, sys
 sys.path.insert(0, os.environ["ARKAOS_ROOT"])
 try:
@@ -111,6 +114,55 @@ try:
 except Exception:
     pass
 PY
+      fi
+    fi
+
+    # ─── APPROVED → pattern stub auto-create (PR4.5 v3.75.1) ──────────
+    # When the dispatch prompt contains `[arka:pattern-suggest <id> <name>]`
+    # AND the verdict is APPROVED, create a stub PatternCard. The
+    # operator enriches by editing ~/.arkaos/patterns/cards.jsonl or
+    # calling record_pattern() with the full metadata. Skips when the
+    # id already exists (never overwrites enriched cards).
+    if echo "$TOOL_OUTPUT" | grep -qE 'Quality Gate Verdict:[[:space:]]*APPROVED'; then
+      PATTERN_LINE=$(printf '%s' "$TOOL_INPUT_PROMPT" \
+        | grep -oE '\[arka:pattern-suggest[[:space:]]+[A-Za-z0-9_.-]+[[:space:]]+[^][]+\]' \
+        | head -1)
+      if [ -n "$PATTERN_LINE" ]; then
+        PID=$(printf '%s' "$PATTERN_LINE" | sed -E 's/\[arka:pattern-suggest[[:space:]]+([A-Za-z0-9_.-]+).*/\1/')
+        PNAME=$(printf '%s' "$PATTERN_LINE" | sed -E 's/\[arka:pattern-suggest[[:space:]]+[A-Za-z0-9_.-]+[[:space:]]+([^][]+)\]/\1/')
+        if [ -n "$PID" ] && [ -n "$PNAME" ]; then
+          PATTERN_ID="$PID" \
+          PATTERN_NAME="$PNAME" \
+          ARKAOS_ROOT="$_AE_ROOT" \
+          python3 - <<'PY' 2>/dev/null || true
+import os, sys
+sys.path.insert(0, os.environ["ARKAOS_ROOT"])
+try:
+    from datetime import datetime, timezone
+    from core.knowledge.pattern_cards import PatternCard, record_pattern, query_patterns
+    pid = os.environ["PATTERN_ID"]
+    existing = [c for c in query_patterns(limit=1000) if c.id == pid]
+    if not existing:
+        ts = datetime.now(timezone.utc).isoformat()
+        record_pattern(PatternCard(
+            id=pid,
+            name=os.environ["PATTERN_NAME"],
+            feature_keywords=[pid.replace("-", " "), os.environ["PATTERN_NAME"].lower()],
+            description="Stub auto-created from APPROVED CQO verdict — enrich via record_pattern() or by editing the JSONL.",
+            stack=[],
+            files=[],
+            acceptance_criteria=[],
+            edge_cases=[],
+            references=[],
+            projects_using=["arkaos"],
+            created_at=ts,
+            last_updated=ts,
+        ))
+except Exception:
+    pass
+PY
+        fi
+      fi
     fi
   fi
 fi

package/core/synapse/pattern_library_layer.py

@@ -20,17 +20,25 @@ from core.knowledge.pattern_cards import PatternCard, query_patterns
 from core.synapse.layers import Layer, LayerResult, PromptContext
 
 
-# Cheap keyword extractor — alphanumeric runs longer than 3 chars,
-# lowercased, stopword-filtered. Enough for v1 matching; a vector-DB
-# embedder will replace this in v3.75.x.
-_WORD_RE = re.compile(r"[A-Za-z][A-Za-z0-9_-]{3,}")
+# Cheap keyword extractor — letter-led runs of ≥4 chars, lowercased,
+# stopword-filtered. The character class includes Latin-1 Supplement
+# (À-ÿ, U+00C0–U+00FF) so pt-PT input like "autenticação", "paginação",
+# "implementação" is captured whole instead of truncated at the
+# accented character. Latin Extended-A (U+0100+) is intentionally
+# excluded — extend the class when adding CS/PL/HU/TR corpora
+# (š, ý, ě, ą, ł, ő, ı, etc.). Vector-DB embedder lands in v3.75.x.
+_WORD_RE = re.compile(r"[A-Za-zÀ-ÿ][A-Za-zÀ-ÿ0-9_-]{3,}")
 
 _STOPWORDS: frozenset[str] = frozenset({
+    # EN
     "this", "that", "with", "from", "into", "have", "want", "need",
     "should", "would", "could", "make", "made", "thing", "things",
     "there", "their", "about", "what", "when", "where", "which",
-    "while", "also", "just", "like", "para", "como", "isto",
-    "esta", "este", "isso", "essa", "esse", "depois", "antes",
+    "while", "also", "just", "like",
+    # PT
+    "para", "como", "isto", "esta", "este", "isso", "essa", "esse",
+    "depois", "antes", "pode", "deve", "muito", "pelo", "pela",
+    "desde", "ainda", "assim", "porque", "mais", "menos", "sobre",
 })
 
 

package/package.json

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

package/pyproject.toml

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