arkaos 2.0.1 → 2.0.3

package/departments/ops/agents/doc-writer.yaml

@@ -0,0 +1,51 @@
+id: doc-writer
+name: Isabel
+role: Documentation Writer
+department: ops
+tier: 3
+
+behavioral_dna:
+  disc:
+    primary: S
+    secondary: C
+    communication_style: "Clear, structured, audience-aware"
+    under_pressure: "Focuses on clarity and completeness"
+    motivator: "Making complex things accessible"
+  enneagram:
+    type: 1
+    wing: 2
+    core_motivation: "To produce correct, helpful documentation"
+    core_fear: "Publishing inaccurate information"
+    subtype: social
+  big_five:
+    openness: 75
+    conscientiousness: 92
+    extraversion: 40
+    agreeableness: 80
+    neuroticism: 30
+  mbti:
+    type: ISFJ
+
+authority:
+  veto: false
+  approve_budget: false
+  approve_architecture: false
+  approve_quality: false
+  block_release: false
+  block_delivery: false
+  orchestrate: false
+  delegates_to: []
+  escalates_to: ops-lead-daniel
+
+expertise:
+  domains: ["technical-writing", "API-docs", "user-guides", "SOPs"]
+  frameworks: ["Diátaxis", "Google Developer Documentation Style"]
+  depth: proficient
+  years_equivalent: 5
+
+communication:
+  language: en
+  tone: "Clear, concise, helpful"
+  vocabulary_level: accessible
+  preferred_format: "Step-by-step guides with examples"
+  avoid: ["jargon without explanation", "walls of text"]

package/departments/pm/agents/pm-director.yaml

@@ -42,7 +42,7 @@ authority:
     - product-owner
     - scrum-master
     - project-coordinator
-  escalates_to: cto-marco
+  escalates_to: coo-sofia
 
 expertise:
   domains:

package/installer/cli.js

@@ -36,6 +36,7 @@ ArkaOS v${VERSION} — The Operating System for AI Agent Teams
 Usage:
   npx arkaos install          Install ArkaOS in current environment
   npx arkaos install --runtime <runtime>  Install for specific runtime
+  npx arkaos init             Initialize project config (.arkaos.json)
   npx arkaos update           Update to latest version
   npx arkaos migrate          Migrate from v1 to v2
   npx arkaos doctor           Run health checks
@@ -57,6 +58,8 @@ Runtimes:
 Examples:
   npx arkaos install                    Auto-detect runtime and install
   npx arkaos install --runtime codex    Install for Codex CLI specifically
+  npx arkaos index                     Index knowledge base (Obsidian vault)
+  npx arkaos search "query"            Search indexed knowledge
   npx arkaos doctor                     Verify installation health
 `);
   process.exit(0);
@@ -69,6 +72,12 @@ async function main() {
       await install({ runtime, path: values.path, force: values.force });
       break;
 
+    case "init": {
+      const { init } = await import("./init.js");
+      await init({ path: values.path || process.cwd() });
+      break;
+    }
+
     case "doctor":
       const { doctor } = await import("./doctor.js");
       await doctor();
@@ -89,6 +98,33 @@ async function main() {
       await migrate();
       break;
 
+    case "index": {
+      const { execSync } = await import("node:child_process");
+      const indexArgs = positionals.slice(1).join(" ");
+      const repoRoot = dirname(fileURLToPath(import.meta.url)).replace(/\/installer$/, "");
+      try {
+        execSync(`python3 "${repoRoot}/scripts/knowledge-index.py" ${indexArgs || "--vault"}`, {
+          stdio: "inherit",
+          env: { ...process.env, ARKAOS_ROOT: repoRoot },
+        });
+      } catch { process.exit(1); }
+      break;
+    }
+
+    case "search": {
+      const { execSync } = await import("node:child_process");
+      const query = positionals.slice(1).join(" ");
+      if (!query) { console.error("Usage: npx arkaos search \"your query\""); process.exit(1); }
+      const repoRoot2 = dirname(fileURLToPath(import.meta.url)).replace(/\/installer$/, "");
+      try {
+        execSync(`python3 "${repoRoot2}/scripts/knowledge-index.py" --search "${query}"`, {
+          stdio: "inherit",
+          env: { ...process.env, ARKAOS_ROOT: repoRoot2 },
+        });
+      } catch { process.exit(1); }
+      break;
+    }
+
     default:
       console.error(`Unknown command: ${command}`);
       console.error('Run "npx arkaos help" for usage information.');

package/installer/init.js

@@ -0,0 +1,105 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join, basename } from "node:path";
+import { execSync } from "node:child_process";
+
+export async function init({ path }) {
+  const projectDir = path || process.cwd();
+  const configPath = join(projectDir, ".arkaos.json");
+  const projectName = basename(projectDir);
+
+  console.log(`\n  ArkaOS Project Init — ${projectName}\n`);
+
+  // Detect existing config
+  if (existsSync(configPath)) {
+    const existing = JSON.parse(readFileSync(configPath, "utf-8"));
+    console.log(`  Config already exists: ${configPath}`);
+    console.log(`  Department: ${existing.department || "auto"}`);
+    console.log(`  Stack: ${existing.stack || "auto"}`);
+    console.log(`\n  To reconfigure, delete .arkaos.json and run again.\n`);
+    return;
+  }
+
+  // Auto-detect stack
+  const stack = detectStack(projectDir);
+  console.log(`  Detected stack: ${stack}`);
+
+  // Auto-detect department
+  const department = detectDepartment(projectDir, stack);
+  console.log(`  Default department: ${department}`);
+
+  // Create config
+  const config = {
+    name: projectName,
+    department,
+    stack,
+    created: new Date().toISOString(),
+    arkaos_version: "2",
+    settings: {
+      quality_gate: true,
+      obsidian_output: true,
+      auto_index: true,
+    },
+  };
+
+  writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+  console.log(`  Created: ${configPath}`);
+
+  // Create .claude/settings.local.json if Claude Code project
+  const claudeDir = join(projectDir, ".claude");
+  const localSettings = join(claudeDir, "settings.local.json");
+  if (!existsSync(localSettings)) {
+    mkdirSync(claudeDir, { recursive: true });
+    writeFileSync(localSettings, JSON.stringify({
+      permissions: {},
+      hooks: {},
+    }, null, 2) + "\n");
+    console.log(`  Created: .claude/settings.local.json`);
+  }
+
+  console.log(`
+  Project initialized for ArkaOS.
+
+  Config: .arkaos.json
+  Stack:  ${stack}
+  Dept:   ${department}
+
+  ArkaOS will auto-detect this project's context via Synapse L3.
+  Use /dev, /mkt, /brand etc. or just describe what you need.
+  `);
+}
+
+function detectStack(dir) {
+  if (existsSync(join(dir, "composer.json"))) return "laravel";
+  if (existsSync(join(dir, "nuxt.config.ts")) || existsSync(join(dir, "nuxt.config.js"))) return "nuxt";
+  if (existsSync(join(dir, "next.config.js")) || existsSync(join(dir, "next.config.ts")) || existsSync(join(dir, "next.config.mjs"))) return "nextjs";
+  if (existsSync(join(dir, "vite.config.ts"))) {
+    try {
+      const pkg = JSON.parse(readFileSync(join(dir, "package.json"), "utf-8"));
+      if (pkg.dependencies?.vue) return "vue";
+      if (pkg.dependencies?.react) return "react";
+    } catch {}
+    return "vite";
+  }
+  if (existsSync(join(dir, "package.json"))) {
+    try {
+      const pkg = JSON.parse(readFileSync(join(dir, "package.json"), "utf-8"));
+      if (pkg.dependencies?.react) return "react";
+      if (pkg.dependencies?.vue) return "vue";
+      if (pkg.dependencies?.express) return "node-express";
+      return "node";
+    } catch {}
+  }
+  if (existsSync(join(dir, "pyproject.toml")) || existsSync(join(dir, "setup.py"))) return "python";
+  if (existsSync(join(dir, "Gemfile"))) return "ruby";
+  if (existsSync(join(dir, "go.mod"))) return "go";
+  if (existsSync(join(dir, "Cargo.toml"))) return "rust";
+  return "unknown";
+}
+
+function detectDepartment(dir, stack) {
+  // Code projects default to dev
+  if (["laravel", "nuxt", "nextjs", "react", "vue", "node", "python", "ruby", "go", "rust", "node-express", "vite"].includes(stack)) {
+    return "dev";
+  }
+  return "general";
+}

package/installer/migrate.js

@@ -1,4 +1,4 @@
-import { existsSync, readFileSync, renameSync, mkdirSync } from "node:fs";
+import { existsSync, readFileSync, renameSync, mkdirSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { homedir } from "node:os";
 import { execSync } from "node:child_process";
@@ -105,6 +105,9 @@ export async function migrate() {
     process.exit(1);
   }
 
+  // Mark as migrated so hook stops alerting
+  writeFileSync(join(V2_PATH, "migrated-from-v1"), new Date().toISOString());
+
   console.log(`
   Migration complete!
 

package/package.json

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

package/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "arkaos-core"
-version = "2.0.1"
+version = "2.0.3"
 description = "Core engine for ArkaOS — The Operating System for AI Agent Teams"
 readme = "README.md"
 license = {text = "MIT"}
@@ -28,6 +28,10 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
+knowledge = [
+    "fastembed>=0.8.0",
+    "sqlite-vss>=0.1.2",
+]
 dev = [
     "pytest>=8.0",
     "pytest-cov>=5.0",