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

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,6 +1,10 @@
 {
   "name": "stealthos-cli",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.4",
+  "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": {
@@ -10,6 +14,8 @@
     "bin.cjs",
     "bin.mjs",
     "src/",
+    "scripts/",
+    "ai/",
     "README.md"
   ],
   "engines": {

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

@@ -3,7 +3,7 @@
 import { installCommand } from "./commands/install.mjs";
 import { statusCommand } from "./commands/status.mjs";
 
-const VERSION = "0.1.0-alpha.1";
+const VERSION = "0.1.0-alpha.4";
 
 function usage() {
   process.stdout.write(`

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/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>.",
   );
 }