stealthos-cli 0.1.0-alpha.3 → 0.1.0-alpha.5

package/ai/workflows/work.json

@@ -0,0 +1,91 @@
+{
+  "$schema": "./_schema.json",
+  "id": "work",
+  "version": "3.0.0",
+  "description": "Intent Runtime completo: carrega runtime-context compilado, classifica, faz gap analysis, pode pausar para clarification se complex, gera plan, pausa para approval, executa (LLM externa faz tool calls), valida, atualiza memory, snapshot final.",
+  "safety": { "project_files_readonly": false },
+  "guarantees": [
+    "runtime_context_compiled",
+    "task_classified",
+    "query_routed",
+    "memory_searched"
+  ],
+  "steps": [
+    {
+      "id": "load_runtime_context",
+      "tool": "aios_compile_runtime_context",
+      "args": { "max_modules": 10, "max_decisions": 5, "write": true },
+      "on_error": "continue"
+    },
+    {
+      "id": "classify",
+      "tool": "aios_classify_task",
+      "args": { "query": "${input.intent}" },
+      "on_error": "abort"
+    },
+    {
+      "id": "route",
+      "tool": "aios_route_query",
+      "args": { "query": "${input.intent}" },
+      "on_error": "abort"
+    },
+    {
+      "id": "search_memory_for_gap",
+      "tool": "aios_search_memory",
+      "args": { "query": "${input.intent}", "max_results": 10 },
+      "on_error": "continue"
+    },
+    {
+      "id": "clarification_gate",
+      "tool": "aios_state_set",
+      "args": { "path": "rotating.active_focus", "value": "work: clarification on '${input.intent}'" },
+      "on_error": "continue",
+      "pause_for": {
+        "when": "after",
+        "reason": "clarification_questions",
+        "prompt": "Antes de executar '${input.intent}': há ambiguidades, escopo incerto, ou decisão arquitetural envolvida? Responda 'ok' para prosseguir direto, ou descreva clarificações necessárias.",
+        "expected_input": "string"
+      }
+    },
+    {
+      "id": "build_focused_context",
+      "tool": "aios_build_context_package",
+      "args": {
+        "intent": "${input.intent}",
+        "max_modules": 8,
+        "write": false
+      },
+      "on_error": "continue"
+    },
+    {
+      "id": "approval_gate",
+      "tool": "aios_state_set",
+      "args": { "path": "rotating.active_focus", "value": "work: pending approval for '${input.intent}'" },
+      "on_error": "continue",
+      "pause_for": {
+        "when": "after",
+        "reason": "plan_approval",
+        "prompt": "Plano para '${input.intent}' montado pela LLM com base no runtime-context. Aprovar execução? ('ok' / 'ajustar: <detalhes>' / 'cancelar')",
+        "expected_input": "string"
+      }
+    },
+    {
+      "id": "validate_post_execution",
+      "tool": "aios_lint",
+      "args": {},
+      "on_error": "continue"
+    },
+    {
+      "id": "record_completion",
+      "tool": "aios_state_set",
+      "args": { "path": "rotating.active_focus", "value": "work: completed '${input.intent}'" },
+      "on_error": "continue"
+    },
+    {
+      "id": "post_snapshot",
+      "tool": "aios_snapshot",
+      "args": { "label": "work-${timestamp}" },
+      "on_error": "continue"
+    }
+  ]
+}

package/package.json

@@ -1,36 +1,42 @@
-{
-  "name": "stealthos-cli",
-  "version": "0.1.0-alpha.3",
-  "description": "StealthOS CLI — install/manage the StealthOS knowledge base in ~/.stealthos/. Subcommands: install, status, version.",
-  "type": "module",
-  "bin": {
-    "stealthos": "./bin.cjs"
-  },
-  "files": [
-    "bin.cjs",
-    "bin.mjs",
-    "src/",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "keywords": [
-    "stealthos",
-    "mcp",
-    "ai",
-    "cli",
-    "claude-code"
-  ],
-  "author": "Igor Kadu (https://github.com/IgorKadu)",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/IgorKadu/stealthos.git",
-    "directory": "packages/stealthos-cli"
-  },
-  "bugs": {
-    "url": "https://github.com/IgorKadu/stealthos/issues"
-  },
-  "homepage": "https://github.com/IgorKadu/stealthos/tree/main/packages/stealthos-cli#readme"
-}
+{
+  "name": "stealthos-cli",
+  "version": "0.1.0-alpha.5",
+  "scripts": {
+    "bundle-ai": "node scripts/bundle-ai.mjs",
+    "prepublishOnly": "node scripts/bundle-ai.mjs"
+  },
+  "description": "StealthOS CLI — install/manage the StealthOS knowledge base in ~/.stealthos/. Subcommands: install, status, version.",
+  "type": "module",
+  "bin": {
+    "stealthos": "./bin.cjs"
+  },
+  "files": [
+    "bin.cjs",
+    "bin.mjs",
+    "src/",
+    "scripts/",
+    "ai/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "stealthos",
+    "mcp",
+    "ai",
+    "cli",
+    "claude-code"
+  ],
+  "author": "Igor Kadu (https://github.com/IgorKadu)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/IgorKadu/stealthos.git",
+    "directory": "packages/stealthos-cli"
+  },
+  "bugs": {
+    "url": "https://github.com/IgorKadu/stealthos/issues"
+  },
+  "homepage": "https://github.com/IgorKadu/stealthos/tree/main/packages/stealthos-cli#readme"
+}

package/scripts/bundle-ai.mjs

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+// Copies the canonical .ai/ tree from the monorepo root into packages/stealthos-cli/ai/
+// Runs automatically via `prepublishOnly`. Output dir is gitignored.
+
+import { existsSync } from "node:fs";
+import { mkdir, readdir, copyFile, rm, stat } from "node:fs/promises";
+import { join, dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PKG_ROOT = resolve(__dirname, "..");
+const REPO_ROOT = resolve(PKG_ROOT, "..", "..");
+const SRC = join(REPO_ROOT, ".ai");
+const DST = join(PKG_ROOT, "ai");
+
+const EXCLUDES = new Set([
+  "node_modules",
+  ".runtime",
+  "runtime",
+  "artifacts",
+  "context",
+  "snapshots",
+]);
+
+async function copyDir(src, dst) {
+  await mkdir(dst, { recursive: true });
+  const entries = await readdir(src, { withFileTypes: true });
+  let count = 0;
+  for (const e of entries) {
+    if (EXCLUDES.has(e.name)) continue;
+    const s = join(src, e.name);
+    const d = join(dst, e.name);
+    if (e.isDirectory()) {
+      count += await copyDir(s, d);
+    } else if (e.isFile()) {
+      await copyFile(s, d);
+      count++;
+    }
+  }
+  return count;
+}
+
+async function main() {
+  if (!existsSync(SRC)) {
+    console.error(`✖ Source not found: ${SRC}`);
+    process.exit(1);
+  }
+  if (existsSync(DST)) {
+    await rm(DST, { recursive: true, force: true });
+  }
+  const n = await copyDir(SRC, DST);
+  console.log(`✓ Bundled ${n} files: ${SRC} → ${DST}`);
+}
+
+main().catch((e) => {
+  console.error("✖ bundle-ai failed:", e.message);
+  process.exit(1);
+});

package/src/cli.mjs

@@ -1,79 +1,83 @@
-// stealthos CLI router. Subcommand dispatcher.
-
-import { installCommand } from "./commands/install.mjs";
-import { statusCommand } from "./commands/status.mjs";
-
-const VERSION = "0.1.0-alpha.1";
-
-function usage() {
-  process.stdout.write(`
-stealthos v${VERSION}
-
-USAGE
-  stealthos <command> [options]
-
-COMMANDS
-  install     Install StealthOS knowledge base into ~/.stealthos/
-              Options:
-                --source <path>    Source .ai/ tree (default: auto-detect in monorepo)
-                --home <path>      Target home (default: ~/.stealthos)
-                --force            Overwrite existing files
-  status      Show ~/.stealthos/ install status (version, paths, project count)
-  version     Print stealthos CLI version
-  help        Show this message
-
-ENVIRONMENT
-  STEALTHOS_HOME          Override target home (default: ~/.stealthos)
-  STEALTHOS_SOURCE        Override source .ai/ path (default: auto-detect)
-  STEALTHOS_DEBUG=1       Print stack traces on errors
-
-EXAMPLES
-  stealthos install
-  stealthos install --home /opt/stealthos
-  stealthos status
-`);
-}
-
-export async function runCli(argv) {
-  const [cmd = "help", ...rest] = argv;
-  switch (cmd) {
-    case "install":
-      return installCommand(parseFlags(rest));
-    case "status":
-      return statusCommand(parseFlags(rest));
-    case "version":
-    case "-v":
-    case "--version":
-      process.stdout.write(`${VERSION}\n`);
-      return;
-    case "help":
-    case "-h":
-    case "--help":
-      usage();
-      return;
-    default:
-      process.stderr.write(`Unknown command: ${cmd}\n`);
-      usage();
-      process.exit(2);
-  }
-}
-
-function parseFlags(args) {
-  const out = { _positional: [] };
-  for (let i = 0; i < args.length; i++) {
-    const a = args[i];
-    if (a.startsWith("--")) {
-      const key = a.slice(2);
-      const next = args[i + 1];
-      if (next && !next.startsWith("--")) {
-        out[key] = next;
-        i++;
-      } else {
-        out[key] = true;
-      }
-    } else {
-      out._positional.push(a);
-    }
-  }
-  return out;
-}
+// stealthos CLI router. Subcommand dispatcher.
+
+import { installCommand } from "./commands/install.mjs";
+import { statusCommand } from "./commands/status.mjs";
+import { runCommand } from "./commands/run.mjs";
+
+const VERSION = "0.1.0-alpha.5";
+
+function usage() {
+  process.stdout.write(`
+stealthos v${VERSION}
+
+USAGE
+  stealthos <command> [options]
+
+COMMANDS
+  install     Install StealthOS knowledge base into ~/.stealthos/
+              Options:
+                --source <path>    Source .ai/ tree (default: auto-detect in monorepo)
+                --home <path>      Target home (default: ~/.stealthos)
+                --force            Overwrite existing files
+  status      Show ~/.stealthos/ install status (version, paths, project count)
+  run <wf>    Run a workflow via the local MCP server (init|sync|work [intent...])
+  version     Print stealthos CLI version
+  help        Show this message
+
+ENVIRONMENT
+  STEALTHOS_HOME          Override target home (default: ~/.stealthos)
+  STEALTHOS_SOURCE        Override source .ai/ path (default: auto-detect)
+  STEALTHOS_DEBUG=1       Print stack traces on errors
+
+EXAMPLES
+  stealthos install
+  stealthos install --home /opt/stealthos
+  stealthos status
+`);
+}
+
+export async function runCli(argv) {
+  const [cmd = "help", ...rest] = argv;
+  switch (cmd) {
+    case "install":
+      return installCommand(parseFlags(rest));
+    case "status":
+      return statusCommand(parseFlags(rest));
+    case "run":
+      return runCommand(parseFlags(rest));
+    case "version":
+    case "-v":
+    case "--version":
+      process.stdout.write(`${VERSION}\n`);
+      return;
+    case "help":
+    case "-h":
+    case "--help":
+      usage();
+      return;
+    default:
+      process.stderr.write(`Unknown command: ${cmd}\n`);
+      usage();
+      process.exit(2);
+  }
+}
+
+function parseFlags(args) {
+  const out = { _positional: [] };
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a.startsWith("--")) {
+      const key = a.slice(2);
+      const next = args[i + 1];
+      if (next && !next.startsWith("--")) {
+        out[key] = next;
+        i++;
+      } else {
+        out[key] = true;
+      }
+    } else {
+      out._positional.push(a);
+    }
+  }
+  return out;
+}

package/src/commands/install.mjs

@@ -5,10 +5,24 @@
 import { existsSync } from "node:fs";
 import { mkdir, writeFile, readFile } from "node:fs/promises";
 import { join } from "node:path";
-import { homedir } from "node:os";
+import { homedir, platform } from "node:os";
+import { spawn } from "node:child_process";
 import { resolveSource } from "../lib/resolve-source.mjs";
 import { copyTree } from "../lib/copy-tree.mjs";
 
+function runNpmInstall(cwd) {
+  return new Promise((resolve) => {
+    const npmCmd = platform() === "win32" ? "npm.cmd" : "npm";
+    const child = spawn(npmCmd, ["install", "--silent", "--no-audit", "--no-fund"], {
+      cwd,
+      stdio: ["ignore", "inherit", "inherit"],
+      shell: false,
+    });
+    child.on("close", (code) => resolve(code === 0));
+    child.on("error", () => resolve(false));
+  });
+}
+
 // Paths NOT to copy: runtime-generated outputs + project-specific history.
 // These get freshly initialized per project by the server.
 const DEFAULT_EXCLUDES = [
@@ -67,6 +81,7 @@ export async function installCommand(flags = {}) {
   const home = flags.home ? String(flags.home) : (process.env.STEALTHOS_HOME || join(homedir(), ".stealthos"));
   const source = resolveSource({ flagSource: flags.source });
   const force = !!flags.force;
+  const skipServerDeps = !!flags["skip-server-deps"];
 
   process.stdout.write(`\n╔══════════════════════════════════════════════╗\n`);
   process.stdout.write(`║  stealthos install                             ║\n`);
@@ -110,7 +125,7 @@ export async function installCommand(flags = {}) {
     installed_at: new Date().toISOString(),
     installed_from: source,
     source_version: sourceVersion,
-    cli_version: "0.1.0-alpha.3",
+    cli_version: "0.1.0-alpha.4",
   };
   await writeFile(join(home, ".stealthos-version.json"), JSON.stringify(versionMarker, null, 2), "utf8");
 
@@ -122,15 +137,24 @@ export async function installCommand(flags = {}) {
   process.stdout.write(`  • Memory templates:    ${templatesWritten}\n`);
   process.stdout.write(`  • Versão source:       ${sourceVersion}\n`);
 
-  // Check server/node_modules needs install
-  const serverPkgJson = join(home, "server", "package.json");
-  if (existsSync(serverPkgJson) && !existsSync(join(home, "server", "node_modules"))) {
-    process.stdout.write(`\n⚠ Próximo passo: instalar deps do server\n`);
-    process.stdout.write(`   cd "${join(home, "server")}" && npm install\n`);
+  // Auto-install server deps (unless --skip-server-deps)
+  const serverDir = join(home, "server");
+  const serverPkgJson = join(serverDir, "package.json");
+  if (existsSync(serverPkgJson) && !existsSync(join(serverDir, "node_modules"))) {
+    if (skipServerDeps) {
+      process.stdout.write(`\n⚠ Server deps NÃO instaladas (--skip-server-deps).\n`);
+      process.stdout.write(`   Rode depois: cd "${serverDir}" && npm install\n`);
+    } else {
+      process.stdout.write(`\n📦 Instalando deps do server (pode levar 30s)...\n`);
+      const ok = await runNpmInstall(serverDir);
+      if (ok) {
+        process.stdout.write(`✓ Server deps instaladas\n`);
+      } else {
+        process.stdout.write(`⚠ npm install no server falhou. Rode manualmente:\n`);
+        process.stdout.write(`   cd "${serverDir}" && npm install\n`);
+      }
+    }
   }
 
-  process.stdout.write(`\nPara usar em modo hybrid:\n`);
-  process.stdout.write(`  export STEALTHOS_MODE=hybrid\n`);
-  process.stdout.write(`  export STEALTHOS_HOME="${home}"\n`);
-  process.stdout.write(`  node "${join(home, "server", "aios-server.mjs")}" --http\n`);
+  process.stdout.write(`\n✓ Tudo pronto. Abra sua IDE no projeto e use /init, /sync ou /work.\n`);
 }

package/src/commands/run.mjs

@@ -0,0 +1,117 @@
+// `stealthos run <workflow> [intent...]`
+// Spawns aios-server.mjs as an MCP stdio process and sends a single
+// tools/call for aios_run_workflow. Streams stdout/stderr from the server
+// and prints the parsed tool result.
+//
+// Used by VSCode tasks (and as a generic CLI escape hatch) so users on IDEs
+// without MCP can still trigger workflows directly.
+
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+function resolveServerPath() {
+  const home = process.env.STEALTHOS_HOME || join(homedir(), ".stealthos");
+  const candidate = join(home, "server", "aios-server.mjs");
+  if (!existsSync(candidate)) {
+    throw new Error(
+      `aios-server.mjs nao encontrado em ${candidate}. ` +
+        `Rode 'stealthos install' primeiro.`,
+    );
+  }
+  return { home, server: candidate };
+}
+
+function sendRpc(child, payload) {
+  return new Promise((resolve, reject) => {
+    let buf = "";
+    const onData = (chunk) => {
+      buf += chunk.toString("utf8");
+      // MCP framing: each message terminated by newline
+      const lines = buf.split("\n");
+      buf = lines.pop();
+      for (const line of lines) {
+        if (!line.trim()) continue;
+        try {
+          const msg = JSON.parse(line);
+          if (msg.id === payload.id) {
+            child.stdout.off("data", onData);
+            resolve(msg);
+            return;
+          }
+        } catch {
+          // ignore non-JSON lines (server logs)
+        }
+      }
+    };
+    child.stdout.on("data", onData);
+    child.stdin.write(JSON.stringify(payload) + "\n");
+    setTimeout(() => {
+      child.stdout.off("data", onData);
+      reject(new Error("timeout aguardando resposta do MCP server"));
+    }, 60000);
+  });
+}
+
+export async function runCommand(opts) {
+  const positional = opts._positional || [];
+  const workflow = positional[0];
+  if (!workflow) {
+    throw new Error("Uso: stealthos run <workflow> [intent...]");
+  }
+  const intent = positional.slice(1).join(" ");
+
+  const { home, server } = resolveServerPath();
+  process.stdout.write(`▶ stealthos run ${workflow}${intent ? `  (intent: ${intent})` : ""}\n`);
+  process.stdout.write(`  home: ${home}\n  server: ${server}\n\n`);
+
+  const child = spawn(process.execPath, [server], {
+    stdio: ["pipe", "pipe", "inherit"],
+    env: {
+      ...process.env,
+      STEALTHOS_MODE: "hybrid",
+      STEALTHOS_HOME: home,
+      STEALTHOS_PROJECT_DIR: process.cwd(),
+    },
+  });
+
+  let exitCode = 0;
+  try {
+    // 1. initialize
+    await sendRpc(child, {
+      jsonrpc: "2.0",
+      id: 1,
+      method: "initialize",
+      params: { protocolVersion: "2024-11-05", capabilities: {}, clientInfo: { name: "stealthos-cli", version: "0.1" } },
+    });
+
+    // 2. tools/call aios_run_workflow
+    const resp = await sendRpc(child, {
+      jsonrpc: "2.0",
+      id: 2,
+      method: "tools/call",
+      params: {
+        name: "aios_run_workflow",
+        arguments: { name: workflow, input: { intent } },
+      },
+    });
+
+    if (resp.error) {
+      process.stderr.write(`Erro do MCP: ${JSON.stringify(resp.error, null, 2)}\n`);
+      exitCode = 1;
+    } else {
+      const content = resp.result?.content || [];
+      for (const part of content) {
+        if (part.type === "text") process.stdout.write(part.text + "\n");
+      }
+    }
+  } catch (err) {
+    process.stderr.write(`Erro: ${err.message}\n`);
+    exitCode = 1;
+  } finally {
+    child.stdin.end();
+    child.kill();
+  }
+  process.exit(exitCode);
+}

package/src/lib/resolve-source.mjs

@@ -1,9 +1,10 @@
 // Locate the source .ai/ tree to install from.
-// Strategy:
-//   1. Explicit --source flag wins
+// Strategy (in order):
+//   1. Explicit --source flag
 //   2. STEALTHOS_SOURCE env var
-//   3. Monorepo discovery: walk up from __dirname looking for sibling .ai/
-//   4. Fail loudly
+//   3. Bundled ai/ inside the published package (preferred for end users)
+//   4. Monorepo discovery: walk up looking for sibling .ai/ (dev mode)
+//   5. Fail loudly
 
 import { existsSync } from "node:fs";
 import { resolve, dirname, join } from "node:path";
@@ -12,22 +13,29 @@ import { fileURLToPath } from "node:url";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
 function resolveAiDir(abs) {
-  // Accept either <root> (contains .ai/manifest.json) or <root>/.ai (contains manifest.json)
+  // Accept either <root> (contains manifest.json) or <root>/.ai (contains manifest.json) or <root>/ai (bundled)
   if (existsSync(join(abs, "manifest.json"))) return abs;
-  const sub = join(abs, ".ai");
-  if (existsSync(join(sub, "manifest.json"))) return sub;
+  for (const sub of [".ai", "ai"]) {
+    const candidate = join(abs, sub);
+    if (existsSync(join(candidate, "manifest.json"))) return candidate;
+  }
   return null;
 }
 
 export function resolveSource({ flagSource } = {}) {
+  // 1. Explicit --source
   if (flagSource) {
     const abs = resolve(flagSource);
     const ai = resolveAiDir(abs);
     if (!ai) {
-      throw new Error(`--source path does not contain manifest.json (checked ${abs} and ${join(abs, ".ai")})`);
+      throw new Error(
+        `--source path does not contain manifest.json (checked ${abs}, ${join(abs, ".ai")}, ${join(abs, "ai")})`,
+      );
     }
     return ai;
   }
+
+  // 2. Env var
   if (process.env.STEALTHOS_SOURCE) {
     const abs = resolve(process.env.STEALTHOS_SOURCE);
     const ai = resolveAiDir(abs);
@@ -36,7 +44,15 @@ export function resolveSource({ flagSource } = {}) {
     }
     return ai;
   }
-  // Monorepo discovery: walk up from packages/stealthos-cli/src/lib/ to find sibling .ai/
+
+  // 3. Bundled inside the package itself (created by prepublishOnly)
+  //    __dirname = packages/stealthos-cli/src/lib  →  ../../ai
+  const bundled = resolve(__dirname, "..", "..", "ai");
+  if (existsSync(join(bundled, "manifest.json"))) {
+    return bundled;
+  }
+
+  // 4. Monorepo dev fallback: walk up from src/lib looking for sibling .ai/
   let dir = __dirname;
   for (let i = 0; i < 6; i++) {
     const candidate = join(dir, ".ai");
@@ -47,7 +63,8 @@ export function resolveSource({ flagSource } = {}) {
     if (parent === dir) break;
     dir = parent;
   }
+
   throw new Error(
-    "Could not locate source .ai/ tree. Pass --source <path> or set STEALTHOS_SOURCE env var.",
+    "Could not locate source .ai/ tree. The CLI should ship with bundled ai/ — reinstall stealthos-cli, or pass --source <path-to-stealthos-repo>.",
   );
 }