arkaos 2.0.0-alpha.1

package/installer/doctor.js

@@ -0,0 +1,105 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { execSync } from "node:child_process";
+
+const INSTALL_DIR = join(homedir(), ".arkaos");
+
+const checks = [
+  {
+    name: "install-dir",
+    description: "ArkaOS installation directory exists",
+    severity: "fail",
+    check: () => existsSync(INSTALL_DIR),
+    fix: "Run: npx arkaos install",
+  },
+  {
+    name: "manifest",
+    description: "Install manifest present",
+    severity: "fail",
+    check: () => existsSync(join(INSTALL_DIR, "install-manifest.json")),
+    fix: "Run: npx arkaos install",
+  },
+  {
+    name: "python",
+    description: "Python 3.11+ available",
+    severity: "fail",
+    check: () => {
+      try {
+        const v = execSync("python3 --version 2>&1", { stdio: "pipe" }).toString();
+        const m = v.match(/(\d+)\.(\d+)/);
+        return m && parseInt(m[1]) >= 3 && parseInt(m[2]) >= 11;
+      } catch { return false; }
+    },
+    fix: "Install Python 3.11+: https://python.org",
+  },
+  {
+    name: "hooks-dir",
+    description: "Hook scripts installed",
+    severity: "fail",
+    check: () => existsSync(join(INSTALL_DIR, "config", "hooks", "user-prompt-submit.sh")),
+    fix: "Run: npx arkaos install --force",
+  },
+  {
+    name: "constitution",
+    description: "Constitution YAML present",
+    severity: "warn",
+    check: () => existsSync(join(INSTALL_DIR, "config", "constitution.yaml")),
+    fix: "Run: npx arkaos install --force",
+  },
+  {
+    name: "repo-path",
+    description: "Repo path reference exists",
+    severity: "warn",
+    check: () => {
+      const p = join(INSTALL_DIR, ".repo-path");
+      if (!existsSync(p)) return false;
+      const root = readFileSync(p, "utf-8").trim();
+      return existsSync(root);
+    },
+    fix: "Run: npx arkaos install --force",
+  },
+  {
+    name: "profile",
+    description: "User profile exists",
+    severity: "warn",
+    check: () => existsSync(join(INSTALL_DIR, "profile.json")),
+    fix: "Run: npx arkaos install",
+  },
+  {
+    name: "python-core",
+    description: "Python core engine importable",
+    severity: "warn",
+    check: () => {
+      try {
+        execSync('python3 -c "from core.synapse.engine import SynapseEngine"', { stdio: "pipe" });
+        return true;
+      } catch { return false; }
+    },
+    fix: "Run: pip install -e <arkaos-root>",
+  },
+];
+
+export async function doctor() {
+  console.log("\n  ArkaOS Doctor — Health Checks\n");
+
+  let passed = 0;
+  let warned = 0;
+  let failed = 0;
+
+  for (const check of checks) {
+    const ok = check.check();
+    const icon = ok ? "\x1b[32m✓\x1b[0m" : (check.severity === "fail" ? "\x1b[31m✗\x1b[0m" : "\x1b[33m!\x1b[0m");
+    console.log(`  ${icon}  ${check.description}`);
+    if (!ok) {
+      console.log(`     Fix: ${check.fix}`);
+      if (check.severity === "fail") failed++;
+      else warned++;
+    } else {
+      passed++;
+    }
+  }
+
+  console.log(`\n  Results: ${passed} passed, ${warned} warnings, ${failed} failures\n`);
+  if (failed > 0) process.exit(1);
+}

package/installer/index.js

@@ -0,0 +1,199 @@
+import { existsSync, mkdirSync, copyFileSync, readFileSync, writeFileSync, readdirSync, chmodSync } from "node:fs";
+import { join, resolve, dirname } from "node:path";
+import { homedir } from "node:os";
+import { execSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { getRuntimeConfig } from "./detect-runtime.js";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const ARKAOS_ROOT = resolve(__dirname, "..");
+
+const VERSION = "2.0.0-alpha.1";
+
+export async function install({ runtime, path, force }) {
+  console.log(`\n  ArkaOS v${VERSION} — The Operating System for AI Agent Teams\n`);
+  console.log(`  Runtime: ${runtime}`);
+
+  const config = getRuntimeConfig(runtime);
+  const installDir = path || join(homedir(), ".arkaos");
+
+  console.log(`  Install dir: ${installDir}`);
+  console.log(`  Config dir: ${config.configDir}\n`);
+
+  // Step 1: Create directories
+  console.log("  [1/8] Creating directories...");
+  ensureDir(installDir);
+  ensureDir(join(installDir, "config"));
+  ensureDir(join(installDir, "config", "hooks"));
+  ensureDir(join(installDir, "agents"));
+  ensureDir(join(installDir, "media"));
+  ensureDir(join(installDir, "session-digests"));
+
+  // Step 2: Check Python
+  console.log("  [2/8] Checking Python...");
+  const pythonCmd = checkPython();
+  console.log(`         Found: ${pythonCmd}`);
+
+  // Step 3: Install Python core engine
+  console.log("  [3/8] Installing Python core engine...");
+  installPythonDeps(pythonCmd);
+
+  // Step 4: Copy config files
+  console.log("  [4/8] Copying configuration files...");
+  copyConfigFiles(installDir);
+
+  // Step 5: Install hooks
+  console.log("  [5/8] Installing hooks...");
+  installHooks(installDir);
+
+  // Step 6: Configure runtime
+  console.log("  [6/8] Configuring runtime...");
+  const adapter = await loadAdapter(runtime);
+  adapter.configureHooks(config, installDir);
+
+  // Step 7: Create references
+  console.log("  [7/8] Creating references...");
+  // .repo-path: so hooks can find the package
+  writeFileSync(join(installDir, ".repo-path"), ARKAOS_ROOT);
+  // Skills reference
+  const skillsDir = join(config.skillsDir, "arkaos");
+  ensureDir(skillsDir);
+  writeFileSync(join(skillsDir, ".arkaos-root"), ARKAOS_ROOT);
+  // Profile (first install only)
+  const profilePath = join(installDir, "profile.json");
+  if (!existsSync(profilePath)) {
+    console.log("         New installation — profile created.");
+    writeFileSync(profilePath, JSON.stringify({
+      version: "2",
+      created: new Date().toISOString(),
+    }, null, 2));
+  }
+
+  // Step 8: Finalize
+  console.log("  [8/8] Finalizing...");
+  const manifest = {
+    version: VERSION,
+    runtime,
+    installDir,
+    repoRoot: ARKAOS_ROOT,
+    configDir: config.configDir,
+    skillsDir,
+    installedAt: new Date().toISOString(),
+    pythonCmd,
+  };
+  writeFileSync(join(installDir, "install-manifest.json"), JSON.stringify(manifest, null, 2));
+
+  console.log(`
+  ArkaOS v${VERSION} installed successfully!
+
+  Runtime:     ${config.name}
+  Install dir: ${installDir}
+  Repo root:   ${ARKAOS_ROOT}
+
+  Get started:
+    Type any request in ${config.name} and ArkaOS will route it.
+    Use /do <description> for natural language commands.
+    Run: npx arkaos doctor    to verify installation.
+  `);
+}
+
+function ensureDir(dir) {
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+
+function checkPython() {
+  const candidates = ["python3", "python"];
+  for (const cmd of candidates) {
+    try {
+      const version = execSync(`${cmd} --version 2>&1`, { stdio: "pipe" }).toString().trim();
+      const match = version.match(/(\d+)\.(\d+)/);
+      if (match && parseInt(match[1]) >= 3 && parseInt(match[2]) >= 11) {
+        return cmd;
+      }
+    } catch {
+      continue;
+    }
+  }
+  console.error(
+    "\n  Python 3.11+ is required but not found.\n" +
+      "  Install Python: https://python.org/downloads/\n"
+  );
+  process.exit(1);
+}
+
+function installPythonDeps(pythonCmd) {
+  try {
+    try {
+      execSync("uv --version", { stdio: "pipe" });
+      execSync(`uv pip install -e "${ARKAOS_ROOT}"`, { stdio: "pipe" });
+      return;
+    } catch {
+      // uv not available
+    }
+    execSync(`${pythonCmd} -m pip install -e "${ARKAOS_ROOT}" --quiet`, { stdio: "pipe" });
+  } catch (err) {
+    console.warn("         Warning: Could not install Python deps. Core engine may not work.");
+    console.warn(`         ${err.message}`);
+  }
+}
+
+function copyConfigFiles(installDir) {
+  // Constitution
+  const constitutionSrc = join(ARKAOS_ROOT, "config", "constitution.yaml");
+  if (existsSync(constitutionSrc)) {
+    copyFileSync(constitutionSrc, join(installDir, "config", "constitution.yaml"));
+  }
+}
+
+function installHooks(installDir) {
+  const hooksDir = join(installDir, "config", "hooks");
+  ensureDir(hooksDir);
+
+  // Copy v2 hooks, rename to standard names (without -v2 suffix)
+  const hookMap = {
+    "user-prompt-submit-v2.sh": "user-prompt-submit.sh",
+    "post-tool-use-v2.sh": "post-tool-use.sh",
+    "pre-compact-v2.sh": "pre-compact.sh",
+  };
+
+  const srcHooksDir = join(ARKAOS_ROOT, "config", "hooks");
+
+  for (const [src, dest] of Object.entries(hookMap)) {
+    const srcPath = join(srcHooksDir, src);
+    const destPath = join(hooksDir, dest);
+    if (existsSync(srcPath)) {
+      // Read, replace ARKAOS_ROOT placeholder, write
+      let content = readFileSync(srcPath, "utf-8");
+      // Ensure hooks use the install directory
+      content = content.replace(
+        /ARKAOS_ROOT="\$\{ARKA_OS:-\$HOME\/\.claude\/skills\/arkaos\}"/g,
+        `ARKAOS_ROOT="${installDir}"`
+      );
+      content = content.replace(
+        /ARKAOS_HOME="\$\{HOME\}\/\.arkaos"/g,
+        `ARKAOS_HOME="${installDir}"`
+      );
+      writeFileSync(destPath, content);
+      try {
+        chmodSync(destPath, 0o755);
+      } catch { /* ignore on Windows */ }
+      console.log(`         Installed: ${dest}`);
+    }
+  }
+}
+
+async function loadAdapter(runtime) {
+  try {
+    const mod = await import(`./adapters/${runtime}.js`);
+    return mod.default;
+  } catch {
+    return {
+      configureHooks(config, installDir) {
+        console.log(`         Using generic configuration for ${runtime}`);
+      },
+    };
+  }
+}

package/installer/uninstall.js

@@ -0,0 +1,46 @@
+import { existsSync, rmSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+export async function uninstall() {
+  const installDir = join(homedir(), ".arkaos");
+
+  console.log("\n  ArkaOS Uninstall\n");
+
+  if (!existsSync(installDir)) {
+    console.log("  ArkaOS is not installed.");
+    return;
+  }
+
+  // Remove Claude Code hooks (restore clean settings)
+  const settingsPath = join(homedir(), ".claude", "settings.json");
+  if (existsSync(settingsPath)) {
+    try {
+      const settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
+      delete settings.hooks;
+      writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+      console.log("  Removed hooks from Claude Code settings.");
+    } catch {
+      console.log("  Could not clean Claude Code settings.");
+    }
+  }
+
+  // Remove install directory
+  try {
+    rmSync(installDir, { recursive: true, force: true });
+    console.log(`  Removed: ${installDir}`);
+  } catch (err) {
+    console.error(`  Could not remove ${installDir}: ${err.message}`);
+  }
+
+  // Remove skills reference
+  const skillsRef = join(homedir(), ".claude", "skills", "arkaos");
+  if (existsSync(skillsRef)) {
+    try {
+      rmSync(skillsRef, { recursive: true, force: true });
+      console.log(`  Removed: ${skillsRef}`);
+    } catch {}
+  }
+
+  console.log("\n  ArkaOS uninstalled. Goodbye.\n");
+}

package/installer/update.js

@@ -0,0 +1,39 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { execSync } from "node:child_process";
+
+export async function update() {
+  const installDir = join(homedir(), ".arkaos");
+  const manifestPath = join(installDir, "install-manifest.json");
+
+  if (!existsSync(manifestPath)) {
+    console.error("  ArkaOS is not installed. Run: npx arkaos install");
+    process.exit(1);
+  }
+
+  const manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
+  console.log(`\n  ArkaOS Update — Current: v${manifest.version}\n`);
+
+  const repoRoot = manifest.repoRoot;
+  if (!repoRoot || !existsSync(repoRoot)) {
+    console.log("  Updating via npm...");
+    try {
+      execSync("npm update -g arkaos", { stdio: "inherit" });
+    } catch {
+      console.log("  Reinstalling...");
+      execSync("npx arkaos install --force", { stdio: "inherit" });
+    }
+    return;
+  }
+
+  console.log(`  Updating from: ${repoRoot}`);
+  try {
+    execSync("git pull", { cwd: repoRoot, stdio: "inherit" });
+    execSync("npx arkaos install --force", { stdio: "inherit" });
+    console.log("\n  Update complete.");
+  } catch (err) {
+    console.error(`  Update failed: ${err.message}`);
+    process.exit(1);
+  }
+}