arkaos 2.19.0 → 2.19.2

package/README.md

@@ -161,7 +161,7 @@ ArkaOS doesn't just execute — it **learns, dreams, and researches**.
 Every solution you implement is captured and indexed. When you need authentication in a new Laravel project, ArkaOS already knows how you did it in the last three projects — with the exact pattern, configuration, and lessons learned.
 
 - **Dual-write**: Obsidian (human-readable) + Vector DB (semantic search)
-- **Cross-project**: Knowledge from Rockport applies to ClubeFashion
+- **Cross-project**: Knowledge from ClientRetail applies to ClientFashion
 - **Confidence scoring**: Patterns validated 3+ times become "validated patterns"
 
 ### Dreaming (runs at 02:00)
@@ -185,7 +185,7 @@ Pending reflections from Dreaming:
 
 2. [technical] Sync retry — improve
    Fixed backoff can cause thundering herd. Use exponential
-   backoff with jitter (validated pattern from Rockport).
+   backoff with jitter (validated pattern from ClientRetail).
 
 Want me to elaborate?
 ```
@@ -204,11 +204,11 @@ Intelligence Briefing — 2026-04-10
 
 ACTION REQUIRED:
 - Laravel 12.1.3 security patch — SQL injection in whereHas.
-  Affects: ClubeFashion, Fovory. Fix: composer update laravel/framework.
+  Affects: ClientFashion, ClientCommerce. Fix: composer update laravel/framework.
 
 OPPORTUNITIES:
-- Shopify Winter '26 bulk product API — Fovory sync could be 10x faster.
-- Nuxt 4 RC2 migration guide published — start preparing ZugaTV.
+- Shopify Winter '26 bulk product API — ClientCommerce sync could be 10x faster.
+- Nuxt 4 RC2 migration guide published — start preparing ClientVideo.
 
 COMPETITOR WATCH:
 - CrewAI v3 launched memory layer — similar to our Cognitive Layer
@@ -233,9 +233,9 @@ arkaos scheduler logs         # View logs
 ArkaOS manages client projects as **ecosystems** — groups of related projects with dedicated squads.
 
 ```
-/rockport          → Rockport ecosystem (4 projects: API, frontend, admin, docs)
-/fovory            → Fovory ecosystem (supplier sync + Shopify theme)
-/clubefashion      → ClubeFashion (6 projects: CRM, store, API, migration...)
+/client_retail          → ClientRetail ecosystem (4 projects: API, frontend, admin, docs)
+/client_commerce            → ClientCommerce ecosystem (supplier sync + Shopify theme)
+/client_fashion      → ClientFashion (6 projects: CRM, store, API, migration...)
 /edp               → EDP (3 projects: portal, API, analytics)
 ```
 

package/VERSION

@@ -1 +1 @@
-2.19.0
+2.19.2

package/arka/SKILL.md

@@ -12,6 +12,50 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 > **The Operating System for AI Agent Teams**
 > 65 agents. 17 departments. 244+ skills. Multi-runtime. Dashboard. Knowledge RAG.
 
+## ⛔ Enforcement contract (read before responding)
+
+This overrides every default. If the UserPromptSubmit hook injected a
+`[ARKA:WORKFLOW-REQUIRED]` tag, you MUST, on the first line of your reply:
+
+```
+[arka:routing] <department-slug> -> <lead-agent>
+```
+
+Example first lines (pick the right department for the ask):
+
+- `[arka:routing] dev -> Paulo` — code, features, refactors, tests
+- `[arka:routing] brand -> Valentina` — identity, design, logos, voice
+- `[arka:routing] kb -> Clara` — knowledge base, research, Obsidian
+- `[arka:routing] mkt -> Luna` — marketing, growth, SEO, campaigns
+- `[arka:routing] content -> Rafael` — content, video, social, copy
+- `[arka:routing] landing -> Ines` — landing pages, funnels, offers
+- `[arka:routing] ecom -> Ricardo` — e-commerce, stores, conversion
+- `[arka:routing] saas -> Tiago` — SaaS, validation, PLG, metrics
+- `[arka:routing] sales -> Miguel` — pipeline, discovery, negotiation
+- `[arka:routing] pm -> Carolina` — roadmap, sprints, backlog, stories
+- `[arka:routing] ops -> Daniel` — automation, SOPs, workflows
+- `[arka:routing] strat -> Tomas` — strategy, positioning, moats
+- `[arka:routing] fin -> Helena` — finance, modeling, budgets
+- `[arka:routing] lead -> Rodrigo` — team health, feedback, hiring
+- `[arka:routing] org -> Sofia` — org design, COO, operations
+- `[arka:routing] community -> Beatriz` — communities, platforms, retention
+
+After the routing line, in order:
+
+1. State the workflow name and its phase count.
+2. Run Phase 1 (usually spec via `arka-spec` or plan via `arka-forge`) BEFORE writing any code.
+3. Execute sequential phases with visibility (one at a time, report status).
+4. Run the Quality Gate (Marta CQO + Eduardo Copy + Francisca Tech, model Opus) BEFORE marking done.
+
+The only exception is a trivial 1-file edit under 10 lines. In that case emit:
+
+```
+[arka:trivial] <one-sentence reason>
+```
+
+and proceed directly. Anything else without a routing line is a constitution
+violation (squad-routing, arka-supremacy, spec-driven, mandatory-qa).
+
 ## System Commands
 
 | Command | Description |

package/config/cognition/prompts/dreaming.md

@@ -70,7 +70,7 @@ vector = VectorWriter(os.path.expanduser("~/.arkaos/knowledge.db"))
 
 - Compare today's errors with past errors — if same error type appears > 2 times, create Anti-Pattern entry
 - Compare today's solutions with past solutions — if same pattern appears > 2 times, promote to Validated Pattern
-- Detect inconsistencies between projects ("In Rockport used X, in ClubeFashion used Y for same problem")
+- Detect inconsistencies between projects ("In ClientRetail used X, in ClientFashion used Y for same problem")
 
 ## Phase 4: Curation and Consolidation
 
@@ -123,7 +123,7 @@ quality_score: 75
 entries_created: 4
 entries_updated: 2
 insights_generated: 3
-projects_active: [fovory, rockport, clubefashion]
+projects_active: [client_commerce, client_retail, client_fashion]
 ---
 
 # Dreaming Report — YYYY-MM-DD
@@ -199,7 +199,7 @@ Write structured metrics to `~/.arkaos/logs/dreaming/YYYY-MM-DD.json`:
     "entries_updated": 2,
     "insights_generated": 3,
     "captures_processed": 15,
-    "projects_reviewed": ["fovory", "rockport"]
+    "projects_reviewed": ["client_commerce", "client_retail"]
 }
 ```
 

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

@@ -275,8 +275,41 @@ NO generic assistant replies. Announce the squad before responding.
 When [knowledge:N chunks] is present, cite at least one source.
 If [knowledge:N chunks] is absent on a non-trivial ArkaOS topic, query Obsidian first."
 
+# ─── Workflow Classifier (hard enforcement for creation/implementation) ──
+# Classifies the user prompt. If it looks like a creation/implementation/
+# modification request that is NOT already routed with an explicit /prefix,
+# emits a directive that the agent MUST acknowledge with [arka:routing]
+# BEFORE using any write tool. Trivial quick questions pass through
+# untouched. Explicit slash commands pass through untouched.
+_WORKFLOW_DIRECTIVE=""
+if [ -n "$user_input" ]; then
+  # Skip: explicit slash command (already routed)
+  _FIRST_CHAR=$(echo "$user_input" | head -c 1)
+  if [ "$_FIRST_CHAR" != "/" ] && [ "$_FIRST_CHAR" != "!" ]; then
+    # Match creation/implementation verbs in EN and PT (case-insensitive).
+    _VERB_PATTERN='(criar?|crie[ms]?|cria[mr]?|adicionar?|adiciona[mr]?|implementar?|implementa[mr]?|desenvolver?|desenvolve[mr]?|construir?|constru[ií]a?[mr]?|fazer?|faz[ae][mr]?|refactor(izar?)?|corrigir?|corrige[mr]?|consertar?|conserta[mr]?|create[sd]?|creating|build(s|ing)?|add(s|ed|ing)?|implement(s|ed|ing)?|develop(s|ed|ing)?|fix(es|ed|ing)?|refactor(s|ed|ing)?|make[sd]?|making)'
+    _NOUN_PATTERN='(feature|funcionalidade|skill|squad|agent[e]?|workflow|endpoint|api|component[e]?|module|m[oó]dulo|page|p[aá]gina|hook|pipeline|integration|integra[cç][aã]o|dashboard|report|report[eó]|script|test[es]?)'
+    if echo "$user_input" | grep -qiE "\b${_VERB_PATTERN}\b"; then
+      _WORKFLOW_DIRECTIVE="
+[ARKA:WORKFLOW-REQUIRED] Your user request matched a CREATION/IMPLEMENTATION pattern.
+You MUST, before using any Write, Edit, Bash with side-effects, or Agent tool:
+  1. Output on the first line: [arka:routing] <department-slug> -> <lead-agent>
+     (e.g. [arka:routing] dev -> Paulo, [arka:routing] brand -> Valentina,
+      [arka:routing] kb -> Clara, [arka:routing] mkt -> Luna)
+  2. State the workflow name and phase count in one short sentence.
+  3. Begin phase 1 (spec or plan) BEFORE any code is written.
+  4. Run the Quality Gate (Marta + Eduardo + Francisca, Opus) before claiming done.
+Trivial override: if the request is a single-file edit under 10 lines AND the user
+used an imperative like 'rename X', 'fix typo', you MAY emit [arka:trivial] <reason>
+and proceed directly. Anything else requires routing. This is enforced, not advisory.
+Skipping routing violates constitution rules squad-routing, arka-supremacy,
+spec-driven, mandatory-qa, sequential-validation."
+    fi
+  fi
+fi
+
 # ─── Output ──────────────────────────────────────────────────────────────
-_OUT_CONTEXT="${_ARKA_GREETING:-}${_SYNC_NOTICE:-}${_ROUTE_REMINDER} $python_result"
+_OUT_CONTEXT="${_ARKA_GREETING:-}${_SYNC_NOTICE:-}${_ROUTE_REMINDER}${_WORKFLOW_DIRECTIVE} $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/sync/engine.py

@@ -184,14 +184,14 @@ def _discover_projects(arkaos_home: Path, skills_dir: Path) -> list:
     """
     del skills_dir  # retained for signature stability; unused.
 
-    descriptor_dir = resolve_projects_dir()
-    ecosystems_path = resolve_ecosystems_file()
-
-    # discover_all_projects treats missing paths as empty; pass a stable
-    # sentinel when the resolver returned None so downstream .exists()
-    # checks short-circuit cleanly.
-    descriptor_dir = descriptor_dir or (Path.home() / ".arkaos" / "projects")
-    ecosystems_path = ecosystems_path or (Path.home() / ".arkaos" / "ecosystems.json")
+    # resolve_*() returns None when neither the new nor legacy path exists.
+    # `discover_all_projects` requires concrete Path objects but calls
+    # `.exists()` internally, so substituting the (non-existent) canonical
+    # path keeps the contract: missing → returns an empty project list.
+    descriptor_dir = resolve_projects_dir() or (Path.home() / ".arkaos" / "projects")
+    ecosystems_path = resolve_ecosystems_file() or (
+        Path.home() / ".arkaos" / "ecosystems.json"
+    )
 
     scan_dirs = _load_scan_dirs_from_profile(arkaos_home)
 

package/installer/adapters/claude-code.js

@@ -105,19 +105,20 @@ export default {
     ];
 
     // Statusline — ArkaOS branded status bar
+    // Claude Code reads the camelCase "statusLine" key; the lowercase
+    // "statusline" variant is silently ignored.
     const configDir = join(installDir, "config");
     const statuslineFile = IS_WINDOWS ? "statusline.ps1" : "statusline.sh";
     const statuslinePath = join(configDir, statuslineFile);
     if (existsSync(statuslinePath)) {
-      if (IS_WINDOWS) {
-        settings.statusline = {
-          command: `powershell -NoProfile -ExecutionPolicy Bypass -File "${statuslinePath}"`,
-        };
-      } else {
-        settings.statusline = {
-          command: statuslinePath,
-        };
-      }
+      const command = IS_WINDOWS
+        ? `powershell -NoProfile -NonInteractive -ExecutionPolicy Bypass -File "${statuslinePath}"`
+        : statuslinePath;
+      settings.statusLine = {
+        type: "command",
+        command,
+        padding: 2,
+      };
     }
 
     writeFileSync(settingsPath, JSON.stringify(settings, null, 2));

package/installer/index.js

@@ -259,6 +259,27 @@ export async function install({ runtime, path, force }) {
   };
   writeFileSync(join(installDir, "install-manifest.json"), JSON.stringify(manifest, null, 2));
 
+  // Seed sync-state.json so session-start.sh does not read a missing file as
+  // version drift and permanently show [arka:update-available] on a fresh
+  // install. Schema aligned with core/sync/reporter.py write_sync_state.
+  const syncStatePath = join(installDir, "sync-state.json");
+  if (!existsSync(syncStatePath)) {
+    writeFileSync(
+      syncStatePath,
+      JSON.stringify(
+        {
+          version: VERSION,
+          last_sync: new Date().toISOString(),
+          projects_synced: 0,
+          skills_synced: 0,
+          errors: [],
+        },
+        null,
+        2,
+      ),
+    );
+  }
+
   const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
 
   console.log(`

package/installer/migrate-user-data.js

@@ -19,81 +19,16 @@ const LOGS_DIR = join(USER_DATA_ROOT, "logs");
  * @returns {{ moved: string[], skipped: string[], conflicts: string[], logPath: string|null }}
  */
 export function migrateUserData({ dryRun = false } = {}) {
-  const moved = [];
-  const skipped = [];
-  const conflicts = [];
+  ensureDataRoot();
 
-  if (!existsSync(USER_DATA_ROOT)) {
-    mkdirSync(USER_DATA_ROOT, { recursive: true });
-  }
-  if (!existsSync(NEW_PROJECTS)) {
-    mkdirSync(NEW_PROJECTS, { recursive: true });
-  }
+  const projectsResult = migrateProjects({ dryRun });
+  const ecosystemsResult = migrateEcosystems({ dryRun });
 
-  if (existsSync(LEGACY_PROJECTS) && statSync(LEGACY_PROJECTS).isDirectory()) {
-    for (const entry of readdirSync(LEGACY_PROJECTS)) {
-      const src = join(LEGACY_PROJECTS, entry);
-      const dst = join(NEW_PROJECTS, entry);
-      if (existsSync(dst)) {
-        conflicts.push(`projects/${entry}: destination already present, left source untouched`);
-        continue;
-      }
-      if (dryRun) {
-        moved.push(`projects/${entry} (dry-run)`);
-      } else {
-        try {
-          renameSync(src, dst);
-          moved.push(`projects/${entry}`);
-        } catch (err) {
-          conflicts.push(`projects/${entry}: ${err.message}`);
-        }
-      }
-    }
-  } else {
-    skipped.push("projects/: legacy directory absent");
-  }
-
-  if (existsSync(LEGACY_ECOSYSTEMS)) {
-    if (existsSync(NEW_ECOSYSTEMS)) {
-      conflicts.push("ecosystems.json: destination already present, left source untouched");
-    } else if (dryRun) {
-      moved.push("ecosystems.json (dry-run)");
-    } else {
-      try {
-        renameSync(LEGACY_ECOSYSTEMS, NEW_ECOSYSTEMS);
-        moved.push("ecosystems.json");
-      } catch (err) {
-        conflicts.push(`ecosystems.json: ${err.message}`);
-      }
-    }
-  } else {
-    skipped.push("ecosystems.json: legacy file absent");
-  }
-
-  let logPath = null;
-  if (moved.length > 0 || conflicts.length > 0) {
-    if (!existsSync(LOGS_DIR)) mkdirSync(LOGS_DIR, { recursive: true });
-    const stamp = new Date().toISOString().replace(/[:.]/g, "-");
-    logPath = join(LOGS_DIR, `migration-${stamp}.log`);
-    const body = [
-      `ArkaOS user-data migration — ${new Date().toISOString()}`,
-      `Source: ${LEGACY_SKILLS_ROOT}`,
-      `Destination: ${USER_DATA_ROOT}`,
-      `Dry-run: ${dryRun}`,
-      "",
-      `Moved (${moved.length}):`,
-      ...moved.map(m => `  - ${m}`),
-      "",
-      `Conflicts (${conflicts.length}):`,
-      ...conflicts.map(c => `  - ${c}`),
-      "",
-      `Skipped (${skipped.length}):`,
-      ...skipped.map(s => `  - ${s}`),
-      "",
-    ].join("\n");
-    if (!dryRun) writeFileSync(logPath, body);
-  }
+  const moved = [...projectsResult.moved, ...ecosystemsResult.moved];
+  const skipped = [...projectsResult.skipped, ...ecosystemsResult.skipped];
+  const conflicts = [...projectsResult.conflicts, ...ecosystemsResult.conflicts];
 
+  const logPath = writeReport({ moved, skipped, conflicts, dryRun });
   return { moved, skipped, conflicts, logPath };
 }
 
@@ -108,3 +43,90 @@ export function printMigrationReport(result) {
   for (const c of conflicts) console.log(`    ! ${c}`);
   if (logPath) console.log(`  Log: ${logPath}`);
 }
+
+function ensureDataRoot() {
+  if (!existsSync(USER_DATA_ROOT)) mkdirSync(USER_DATA_ROOT, { recursive: true });
+  if (!existsSync(NEW_PROJECTS)) mkdirSync(NEW_PROJECTS, { recursive: true });
+}
+
+function migrateProjects({ dryRun }) {
+  const moved = [];
+  const skipped = [];
+  const conflicts = [];
+
+  if (!existsSync(LEGACY_PROJECTS) || !statSync(LEGACY_PROJECTS).isDirectory()) {
+    skipped.push("projects/: legacy directory absent");
+    return { moved, skipped, conflicts };
+  }
+
+  for (const entry of readdirSync(LEGACY_PROJECTS)) {
+    const src = join(LEGACY_PROJECTS, entry);
+    const dst = join(NEW_PROJECTS, entry);
+    if (existsSync(dst)) {
+      conflicts.push(`projects/${entry}: destination already present, left source untouched`);
+      continue;
+    }
+    if (dryRun) {
+      moved.push(`projects/${entry} (dry-run)`);
+      continue;
+    }
+    try {
+      renameSync(src, dst);
+      moved.push(`projects/${entry}`);
+    } catch (err) {
+      conflicts.push(`projects/${entry}: ${err.message}`);
+    }
+  }
+  return { moved, skipped, conflicts };
+}
+
+function migrateEcosystems({ dryRun }) {
+  const moved = [];
+  const skipped = [];
+  const conflicts = [];
+
+  if (!existsSync(LEGACY_ECOSYSTEMS)) {
+    skipped.push("ecosystems.json: legacy file absent");
+    return { moved, skipped, conflicts };
+  }
+  if (existsSync(NEW_ECOSYSTEMS)) {
+    conflicts.push("ecosystems.json: destination already present, left source untouched");
+    return { moved, skipped, conflicts };
+  }
+  if (dryRun) {
+    moved.push("ecosystems.json (dry-run)");
+    return { moved, skipped, conflicts };
+  }
+  try {
+    renameSync(LEGACY_ECOSYSTEMS, NEW_ECOSYSTEMS);
+    moved.push("ecosystems.json");
+  } catch (err) {
+    conflicts.push(`ecosystems.json: ${err.message}`);
+  }
+  return { moved, skipped, conflicts };
+}
+
+function writeReport({ moved, skipped, conflicts, dryRun }) {
+  if (moved.length === 0 && conflicts.length === 0) return null;
+  if (!existsSync(LOGS_DIR)) mkdirSync(LOGS_DIR, { recursive: true });
+  const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+  const logPath = join(LOGS_DIR, `migration-${stamp}.log`);
+  const body = [
+    `ArkaOS user-data migration — ${new Date().toISOString()}`,
+    `Source: ${LEGACY_SKILLS_ROOT}`,
+    `Destination: ${USER_DATA_ROOT}`,
+    `Dry-run: ${dryRun}`,
+    "",
+    `Moved (${moved.length}):`,
+    ...moved.map(m => `  - ${m}`),
+    "",
+    `Conflicts (${conflicts.length}):`,
+    ...conflicts.map(c => `  - ${c}`),
+    "",
+    `Skipped (${skipped.length}):`,
+    ...skipped.map(s => `  - ${s}`),
+    "",
+  ].join("\n");
+  if (!dryRun) writeFileSync(logPath, body);
+  return logPath;
+}

package/installer/update.js

@@ -267,7 +267,7 @@ export async function update() {
   // main `/arka` skill, so any department skill (arka-dev, arka-brand,
   // etc.) or sub-skill (arka-code-review, arka-viral, etc.) or agent
   // persona added after the original install was silently missing on
-  // upgrade. Discovered during Marlon's bake-in: 233 top-level arka-*
+  // upgrade. Discovered during ClientAdvisory's bake-in: 233 top-level arka-*
   // skills on his WSL (deployed long ago by install.sh) vs 1 skill on
   // his Windows install (only the main /arka). The Node installer
   // never deployed anything else.

package/package.json

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

package/pyproject.toml

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