@kontourai/flow-agents 0.1.1 → 0.2.0

package/src/tools/build-universal-bundles.ts

@@ -332,6 +332,268 @@ function buildCodex(agents: Agent[]): void {
   writeText(path.join(bundle, "install.sh"), installScript("Codex", "/path/to/workspace"));
   fs.chmodSync(path.join(bundle, "install.sh"), 0o755);
 }
+function exportOpencodeAgent(spec: Agent): string {
+  // Determine agent mode: orchestrator-like agents -> primary, others -> subagent
+  const primaryAgents = new Set(["dev"]);
+  const mode = primaryAgents.has(spec.name) ? "primary" : "subagent";
+  const prompt = appendExportNote(sanitizeText(spec.prompt, "opencode", "<bundle-root>"), "Kiro hook wiring and JSON-only runtime fields were omitted. If this agent mentions Kiro-specific scheduler or hook behavior, treat that as optional operational guidance rather than a hard dependency.");
+  const lines: string[] = ["---"];
+  lines.push(`description: ${String(spec.description ?? "").trim()}`);
+  lines.push(`mode: ${mode}`);
+  lines.push(`model: ${mapped("claude_model_map", spec.model)}`);
+  lines.push("---");
+  lines.push("");
+  lines.push(prompt);
+  return lines.join("\n");
+}
+function exportOpencodePlugin(): string {
+  // Generate the Flow Agents opencode plugin.
+  // opencode plugins are auto-loaded from .opencode/plugins/*.js at startup.
+  //
+  // NOTE: opencode has no direct user-prompt-submit hook. For prompt-submit
+  // workflow steering, we wire the steering command behind session.created
+  // (for session-start steering context) and tool.execute.before (for
+  // policy). This is the closest reasonable approximation — documented here
+  // as an honest gap matching the codex live-hook-influence caveat pattern.
+  return `/**
+ * Flow Agents opencode plugin.
+ *
+ * Auto-loaded from .opencode/plugins/flow-agents.js at opencode startup.
+ * Delegates policy and telemetry decisions to shared scripts in scripts/hooks/
+ * using the same payload contract as the claude/codex adapters.
+ *
+ * EVENT MAPPING NOTE: opencode has no direct user-prompt-submit hook.
+ * Workflow steering (workflow-steering.js) is wired to session.created
+ * (session-start context) and tool.execute.before (per-tool policy).
+ * This approximates the UserPromptSubmit behavior in other runtimes but
+ * cannot intercept mid-session user messages before they are processed.
+ * This is an accepted gap documented here analogously to the codex
+ * live-hook-influence caveat.
+ */
+
+import { spawnSync } from 'node:child_process';
+import { join, basename } from 'node:path';
+
+// opencode runs plugins inside its own compiled (Bun-based) binary, so
+// process.execPath points at opencode itself — spawning it with a script
+// path silently does nothing (caught by live acceptance smoke 2026-06-11).
+// Resolve a real node binary instead; fall back to PATH lookup.
+const NODE_BIN = basename(process.execPath).startsWith('node') ? process.execPath : 'node';
+
+export const FlowAgentsPlugin = async ({ project, client, $, directory, worktree }) => {
+  const root = directory || process.cwd();
+
+  // The hook scripts read the event payload from stdin; an empty stdin makes
+  // the telemetry pipeline silently skip the emit (fail-open), so every spawn
+  // must pass a payload (caught by live acceptance smoke 2026-06-11).
+  function hookPayload(eventName, detail) {
+    return JSON.stringify({ hook_event_name: eventName, cwd: root, ...(detail || {}) });
+  }
+
+  function runAdapter(adapterScript, eventName, detail, ...args) {
+    const adapterPath = join(root, 'scripts', 'hooks', adapterScript);
+    const result = spawnSync(NODE_BIN, [adapterPath, eventName, ...args], {
+      input: hookPayload(eventName, detail),
+      encoding: 'utf8',
+      cwd: root,
+      env: { ...process.env, FLOW_AGENTS_HOOK_RUNTIME: 'opencode' },
+      timeout: 30000,
+    });
+    try {
+      return JSON.parse(result.stdout || '{}');
+    } catch {
+      return { allow: true };
+    }
+  }
+
+  function runTelemetry(eventName, detail) {
+    const telemetryPath = join(root, 'scripts', 'hooks', 'opencode-telemetry-hook.js');
+    spawnSync(NODE_BIN, [telemetryPath, eventName, 'dev'], {
+      input: hookPayload(eventName, detail),
+      encoding: 'utf8',
+      cwd: root,
+      env: { ...process.env, FLOW_AGENTS_TELEMETRY_RUNTIME: 'opencode' },
+      timeout: 10000,
+    });
+  }
+
+  return {
+    'session.created': async (_input, _output) => {
+      runTelemetry('session.created');
+      // Wire workflow steering on session start for context injection
+      runAdapter('opencode-hook-adapter.js', 'session.created', null, 'workflow-steering', 'workflow-steering.js', 'default');
+    },
+    'tool.execute.before': async (input, output) => {
+      const detail = { tool: input && input.tool, args: output && output.args };
+      runTelemetry('tool.execute.before', detail);
+      const policyResult = runAdapter('opencode-hook-adapter.js', 'tool.execute.before', detail, 'config-protection', 'config-protection.js', 'default');
+      if (policyResult && policyResult.allow === false) {
+        throw new Error(policyResult.reason || 'Blocked by Flow Agents hook policy.');
+      }
+    },
+    'tool.execute.after': async (input, output) => {
+      const detail = { tool: input && input.tool };
+      runTelemetry('tool.execute.after', detail);
+      runAdapter('opencode-hook-adapter.js', 'tool.execute.after', detail, 'quality-gate', 'quality-gate.js', 'default');
+    },
+    'session.idle': async (_input, _output) => {
+      runTelemetry('session.idle');
+      runAdapter('opencode-hook-adapter.js', 'session.idle', null, 'stop-goal-fit', 'stop-goal-fit.js', 'default');
+    },
+    'session.error': async (_input, _output) => {
+      runTelemetry('session.error');
+    },
+    'session.compacted': async (_input, _output) => {
+      runTelemetry('session.compacted');
+    },
+    'permission.asked': async (_input, _output) => {
+      runTelemetry('permission.asked');
+    },
+    'file.edited': async (_input, _output) => {
+      runTelemetry('file.edited');
+    },
+  };
+};
+`;
+}
+function exportOpencodeConfig(): string {
+  // opencode's config schema requires `instructions` to be an ARRAY of
+  // instruction file paths/globs (a bare string fails validation and aborts
+  // startup). AGENTS.md is loaded natively by opencode, so the config stays
+  // minimal rather than double-including it.
+  return `${JSON.stringify({
+    $schema: "https://opencode.ai/config.json",
+  }, null, 2)}\n`;
+}
+function buildOpencode(agents: Agent[]): void {
+  const bundle = path.join(dist, "opencode");
+  resetDir(bundle);
+  copySharedContent(bundle, "opencode", "<bundle-root>");
+  writeText(path.join(bundle, manifest.opencode.task_dir, ".gitkeep"), "");
+  for (const spec of agents) {
+    writeText(path.join(bundle, ".opencode/agents", `${spec.name}.md`), exportOpencodeAgent(spec));
+  }
+  for (const skill of fs.readdirSync(path.join(root, "skills"))) {
+    const skillPath = path.join(root, "skills", skill, "SKILL.md");
+    if (fs.existsSync(skillPath)) writeText(path.join(bundle, ".opencode/skills", skill, "SKILL.md"), sanitizeText(readText(skillPath), "opencode", "<bundle-root>"));
+  }
+  writeText(path.join(bundle, ".opencode/plugins/flow-agents.js"), exportOpencodePlugin());
+  writeText(path.join(bundle, "opencode.json"), exportOpencodeConfig());
+  writeText(path.join(bundle, "AGENTS.md"), exportRootAgentsMd("opencode", agents, manifest.opencode.task_dir));
+  writeText(path.join(bundle, "README.md"), exportTargetReadme("opencode", "bash install.sh /path/to/workspace"));
+  writeText(path.join(bundle, "install.sh"), installScript("opencode", "/path/to/workspace"));
+  fs.chmodSync(path.join(bundle, "install.sh"), 0o755);
+}
+function exportPiExtension(): string {
+  // Generate the Flow Agents pi extension.
+  // pi extensions are auto-discovered from .pi/extensions/*.ts (needs project trust).
+  // pi has no named-subagent registry; agents are not exported. The extension
+  // provides workflow steering (via before_agent_start context injection),
+  // tool-call policy (via tool_call event), and telemetry delegation to shared scripts.
+  return `/**
+ * Flow Agents pi extension.
+ *
+ * Auto-discovered from .pi/extensions/flow-agents.ts at startup (needs project trust).
+ * Delegates policy and telemetry to shared scripts/hooks/ using spawnSync,
+ * mirroring the payload contract used by the claude/codex adapters.
+ *
+ * NOTE: pi has no named-subagent registry. Agents are not exported for pi.
+ * Rely on AGENTS.md + skills + this extension for workflow guidance.
+ */
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { spawnSync } from "node:child_process";
+import { join, basename } from "node:path";
+
+// pi may run extensions under a non-node runtime (Bun), where process.execPath
+// is not a node binary and spawning it with a script path silently fails.
+// Same failure class the opencode live smoke caught on 2026-06-11.
+const NODE_BIN = basename(process.execPath).startsWith("node") ? process.execPath : "node";
+
+export default function (pi: ExtensionAPI) {
+  const root = process.cwd();
+
+  function runAdapter(adapterScript: string, eventName: string, hookId: string, relScript: string): { allow: boolean; context?: string; reason?: string } {
+    const adapterPath = join(root, "scripts", "hooks", adapterScript);
+    const payload = JSON.stringify({ hook_event_name: eventName, cwd: root });
+    const result = spawnSync(NODE_BIN, [adapterPath, eventName, hookId, relScript, "default"], {
+      input: payload,
+      encoding: "utf8",
+      cwd: root,
+      env: { ...process.env, FLOW_AGENTS_HOOK_RUNTIME: "pi" },
+      timeout: 30000,
+    });
+    try {
+      return JSON.parse(result.stdout || "{}") as { allow: boolean; context?: string; reason?: string };
+    } catch {
+      return { allow: true };
+    }
+  }
+
+  function runTelemetry(eventName: string): void {
+    const telemetryPath = join(root, "scripts", "hooks", "pi-telemetry-hook.js");
+    const payload = JSON.stringify({ hook_event_name: eventName, cwd: root });
+    spawnSync(NODE_BIN, [telemetryPath, eventName, "dev"], {
+      input: payload,
+      encoding: "utf8",
+      cwd: root,
+      env: { ...process.env, FLOW_AGENTS_TELEMETRY_RUNTIME: "pi" },
+      timeout: 10000,
+    });
+  }
+
+  pi.on("session_start", async (_event, _ctx) => {
+    runTelemetry("session_start");
+  });
+
+  pi.on("before_agent_start", async (event, _ctx) => {
+    runTelemetry("before_agent_start");
+    // Inject workflow steering context at agent start
+    const result = runAdapter("pi-hook-adapter.js", "before_agent_start", "workflow-steering", "workflow-steering.js");
+    if (result.context) {
+      return {
+        systemPrompt: event.systemPrompt + "\\n\\n" + result.context,
+      };
+    }
+  });
+
+  pi.on("tool_call", async (event, _ctx) => {
+    runTelemetry("tool_call");
+    const result = runAdapter("pi-hook-adapter.js", "tool_call", "config-protection", "config-protection.js");
+    if (result && result.allow === false) {
+      return { block: true, reason: result.reason || "Blocked by Flow Agents hook policy." };
+    }
+  });
+
+  pi.on("tool_result", async (_event, _ctx) => {
+    runTelemetry("tool_result");
+    runAdapter("pi-hook-adapter.js", "tool_result", "quality-gate", "quality-gate.js");
+  });
+
+  pi.on("session_shutdown", async (_event, _ctx) => {
+    runTelemetry("session_shutdown");
+    runAdapter("pi-hook-adapter.js", "session_shutdown", "stop-goal-fit", "stop-goal-fit.js");
+  });
+}
+`;
+}
+function buildPi(agents: Agent[]): void {
+  const bundle = path.join(dist, "pi");
+  resetDir(bundle);
+  copySharedContent(bundle, "pi", "<bundle-root>");
+  writeText(path.join(bundle, manifest.pi.task_dir, ".gitkeep"), "");
+  // pi has no named-subagent registry; agents are left canonical/unexported.
+  // Skills are exported to .pi/skills/ (direct .md files supported in that dir).
+  for (const skill of fs.readdirSync(path.join(root, "skills"))) {
+    const skillPath = path.join(root, "skills", skill, "SKILL.md");
+    if (fs.existsSync(skillPath)) writeText(path.join(bundle, ".pi/skills", skill, "SKILL.md"), sanitizeText(readText(skillPath), "pi", "<bundle-root>"));
+  }
+  writeText(path.join(bundle, ".pi/extensions/flow-agents.ts"), exportPiExtension());
+  writeText(path.join(bundle, "AGENTS.md"), exportRootAgentsMd("pi", agents, manifest.pi.task_dir));
+  writeText(path.join(bundle, "README.md"), exportTargetReadme("pi", "bash install.sh /path/to/workspace"));
+  writeText(path.join(bundle, "install.sh"), installScript("pi", "/path/to/workspace"));
+  fs.chmodSync(path.join(bundle, "install.sh"), 0o755);
+}
 function buildCatalog(agents: Agent[]): Record<string, unknown> {
   const kitsCatalog = path.join(root, "kits/catalog.json");
   return {
@@ -350,6 +612,8 @@ export function main(): number {
   buildKiro(agents);
   buildClaudeCode(agents);
   buildCodex(agents);
+  buildOpencode(agents);
+  buildPi(agents);
   writeText(path.join(dist, "catalog.json"), `${JSON.stringify(buildCatalog(agents), null, 2)}\n`);
   writeText(path.join(dist, "README.md"), "# Universal Bundles\n\nRun `npm run build:bundles` from the repo root to regenerate these bundles.\n");
   console.log("Built bundles:");
@@ -357,6 +621,8 @@ export function main(): number {
   console.log(" - dist/kiro");
   console.log(" - dist/claude-code");
   console.log(" - dist/codex");
+  console.log(" - dist/opencode");
+  console.log(" - dist/pi");
   if (printDiagnostics && dropDiagnostics.length) {
     console.error("Export sanitization diagnostics:");
     for (const item of dropDiagnostics) console.error(` - ${item}`);

package/src/tools/filter-installed-packs.ts

@@ -107,10 +107,13 @@ export function main(argv = process.argv.slice(2)): number {
   removed += pruneNamedDirs(rootDir, "skills", allPackMembers(packs, "skills"), selected.skills, dryRun);
   removed += pruneNamedDirs(rootDir, ".claude/skills", allPackMembers(packs, "skills"), selected.skills, dryRun);
   removed += pruneNamedDirs(rootDir, ".codex/skills", allPackMembers(packs, "skills"), selected.skills, dryRun);
+  removed += pruneNamedDirs(rootDir, ".opencode/skills", allPackMembers(packs, "skills"), selected.skills, dryRun);
+  removed += pruneNamedDirs(rootDir, ".pi/skills", allPackMembers(packs, "skills"), selected.skills, dryRun);
   removed += pruneNamedDirs(rootDir, "powers", allPackMembers(packs, "powers"), selected.powers, dryRun);
   removed += pruneAgentFiles(rootDir, "agents", ".json", allPackMembers(packs, "agents"), selected.agents, dryRun);
   removed += pruneAgentFiles(rootDir, ".claude/agents", ".md", allPackMembers(packs, "agents"), selected.agents, dryRun);
   removed += pruneAgentFiles(rootDir, ".codex/agents", ".toml", allPackMembers(packs, "agents"), selected.agents, dryRun);
+  removed += pruneAgentFiles(rootDir, ".opencode/agents", ".md", allPackMembers(packs, "agents"), selected.agents, dryRun);
   const summary = {
     selected_packs: [...selectedNames].sort(),
     removed_entries: removed,

package/src/tools/validate-source-tree.ts

@@ -62,12 +62,17 @@ const hookFilePolicies = new Map<string, { category: string; requiredNeedles: st
   ["scripts/hooks/run-hook.js", { category: "hook runner", requiredNeedles: ["isHookEnabled", "Path traversal rejected"] }],
   ["scripts/hooks/config-protection.js", { category: "policy hook", requiredNeedles: ["Config Protection Hook"] }],
   ["scripts/hooks/governance-audit.sh", { category: "policy hook", requiredNeedles: ["governance-audit.sh", "audit_emit"] }],
+  ["scripts/hooks/opencode-hook-adapter.js", { category: "runtime adapter", requiredNeedles: ["opencode", "run-hook.js"] }],
+  ["scripts/hooks/opencode-telemetry-hook.js", { category: "telemetry shim", requiredNeedles: ["opencode", "telemetry"] }],
+  ["scripts/hooks/pi-hook-adapter.js", { category: "runtime adapter", requiredNeedles: ["pi", "run-hook.js"] }],
+  ["scripts/hooks/pi-telemetry-hook.js", { category: "telemetry shim", requiredNeedles: ["pi", "telemetry"] }],
   ["scripts/hooks/post-edit-accumulator.js", { category: "policy hook", requiredNeedles: ["Post-Edit"] }],
   ["scripts/hooks/pre-commit-quality.js", { category: "repo guardrail hook", requiredNeedles: ["staged"] }],
   ["scripts/hooks/quality-gate.js", { category: "policy hook", requiredNeedles: ["Quality"] }],
   ["scripts/hooks/report-only-guard.js", { category: "policy hook", requiredNeedles: ["Report-Only Guard Hook"] }],
   ["scripts/hooks/stop-format-typecheck.js", { category: "policy hook", requiredNeedles: ["Stop Hook", "typecheck"] }],
   ["scripts/hooks/stop-goal-fit.js", { category: "policy hook", requiredNeedles: ["Stop Hook", "Goal Fit"] }],
+  ["scripts/hooks/utterance-check.js", { category: "policy hook", requiredNeedles: ["Utterance Check Hook", "FLOW_AGENTS_UTTERANCE_CHECK_ENABLED"] }],
   ["scripts/hooks/workflow-steering.js", { category: "policy hook", requiredNeedles: ["Workflow Steering Hook"] }],
   ["scripts/hooks/desktop-notify.sh", { category: "local notification helper", requiredNeedles: ["desktop-notify.sh", "osascript"] }],
   ["scripts/hooks/lib/audit-transport.sh", { category: "shared hook library", requiredNeedles: ["audit_emit"] }],
@@ -94,7 +99,7 @@ const requiredUsageFeedbackFiles = [
 const fixtureOwnershipSelfAuditRefs = new Set([
   "evals/integration/test_fixture_retirement_audit.sh",
 ]);
-const pythonInventoryExcludes = new Set([".git", ".flow-agents", "node_modules", ".venv", "dist", "__pycache__", ".pytest_cache", ".cache", "build"]);
+const pythonInventoryExcludes = new Set([".git", ".flow-agents", "node_modules", ".venv", "dist", "__pycache__", ".pytest_cache", ".cache", "build", "integrations"]);
 const pythonCommandScanRoots = ["README.md", "docs", "context", "skills", "prompts", "agents", "evals", "scripts", "packaging", "package.json"];
 const allowedPythonCommandFiles = [
   /^agents\/tool-explore-deps\.json$/,

package/build/src/cli/docs-preview.js

@@ -1,39 +0,0 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-function esc(value) {
-    return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
-}
-function titleFor(file, text) {
-    return text.match(/^title:\s*(.+)$/m)?.[1].trim() ?? text.split(/\r?\n/).find((line) => line.startsWith("# "))?.slice(2).trim() ?? path.basename(file, ".md").replace(/-/g, " ");
-}
-function render(text) {
-    return text.replace(/^---\n.*?\n---\n/s, "").split(/\r?\n/).map((line) => {
-        if (line.startsWith("# "))
-            return `<h1>${esc(line.slice(2).trim())}</h1>`;
-        if (line.startsWith("## "))
-            return `<h2>${esc(line.slice(3).trim())}</h2>`;
-        if (line.startsWith("- "))
-            return `<li>${esc(line.slice(2).trim())}</li>`;
-        return line.trim() ? `<p>${esc(line.trim())}</p>` : "";
-    }).join("\n");
-}
-export function main() {
-    const root = path.resolve(path.dirname(process.argv[1]), "..");
-    const docs = path.join(root, "docs");
-    const out = path.join(root, "_site");
-    fs.rmSync(out, { recursive: true, force: true });
-    fs.mkdirSync(out, { recursive: true });
-    const assets = path.join(docs, "assets");
-    if (fs.existsSync(assets))
-        fs.cpSync(assets, path.join(out, "assets"), { recursive: true });
-    for (const file of fs.readdirSync(docs).filter((name) => name.endsWith(".md")).sort()) {
-        const source = path.join(docs, file);
-        const text = fs.readFileSync(source, "utf8");
-        const title = titleFor(file, text);
-        fs.writeFileSync(path.join(out, `${path.basename(file, ".md")}.html`), `<!doctype html><html><head><meta charset="utf-8"><title>${esc(title)}</title><link rel="stylesheet" href="assets/site.css"></head><body>${render(text)}<script src="assets/site.js" defer></script></body></html>`, "utf8");
-    }
-    console.log(`Built local docs preview: ${out}`);
-    return 0;
-}
-if (import.meta.url === `file://${process.argv[1]}`)
-    process.exit(main());

package/build/src/cli/export-bookmarks.js

@@ -1,38 +0,0 @@
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-function esc(value) {
-    return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
-}
-export function main(argv = process.argv.slice(2)) {
-    if (argv.length < 1) {
-        console.log("Usage: export-bookmarks <bookmarks.md> [output.html]");
-        return 1;
-    }
-    const input = argv[0];
-    const output = argv[1] ?? path.join(os.homedir(), "Downloads", "bookmarks_organized.html");
-    if (!fs.existsSync(input)) {
-        console.log(`Error: ${input} not found`);
-        return 1;
-    }
-    const links = Array.from(fs.readFileSync(input, "utf8").matchAll(/^- \*\*[\d-]+\*\* \[(\w+)\]: (.+?) — (https?:\/\/\S+)(?: — (.+))?$/gm), (m) => ({ tag: m[1], title: m[2], url: m[3] }));
-    const timestamp = Math.floor(Date.now() / 1000);
-    const byTag = new Map();
-    for (const link of links)
-        byTag.set(link.tag, [...(byTag.get(link.tag) ?? []), link]);
-    const lines = ["<!DOCTYPE NETSCAPE-Bookmark-file-1>", '<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8">', "<TITLE>Bookmarks</TITLE>", "<H1>Bookmarks</H1>", "<DL><p>"];
-    for (const tag of Array.from(byTag.keys()).sort()) {
-        lines.push(`    <DT><H3 ADD_DATE="${timestamp}" LAST_MODIFIED="${timestamp}">${esc(tag)}</H3>`, "    <DL><p>");
-        for (const link of (byTag.get(tag) ?? []).sort((a, b) => a.title.localeCompare(b.title)))
-            lines.push(`        <DT><A HREF="${esc(link.url)}" ADD_DATE="${timestamp}">${esc(link.title)}</A>`);
-        lines.push("    </DL><p>");
-    }
-    lines.push("</DL><p>");
-    fs.writeFileSync(output, lines.join("\n"), "utf8");
-    console.log("Bookmarks exported");
-    console.log(`Source: ${input} (${links.length} links)`);
-    console.log(`Output: ${output}`);
-    return 0;
-}
-if (import.meta.url === `file://${process.argv[1]}`)
-    process.exit(main());

package/build/src/cli/import-bookmarks.js

@@ -1,50 +0,0 @@
-import * as fs from "node:fs";
-const SKIP = [/mail\.google\.com/i, /outlook\.(office|live)\.com/i, /calendar\.google\.com/i, /linkedin\.com\/in\//i, /slack\.com\/archives/i, /zoom\.us\/j\//i, /teams\.microsoft\.com/i];
-const TAGS = [[/github\.com|gitlab\.com|codecommit|code\.amazon/i, "repo"], [/docs\.|documentation|\/docs\/|readme|userguide|developer-guide/i, "docs"], [/wiki\.|\/wiki\/|confluence|runbook/i, "wiki"], [/dashboard|console\.|portal|admin\.|grafana|cloudwatch/i, "tool"], [/learn\.|training\.|course|certification|workshop|tutorial/i, "training"], [/template|boilerplate|starter|scaffold/i, "template"], [/spec\.|standard|architecture|rfc|design-doc/i, "reference"]];
-function inferTag(url) {
-    return TAGS.find(([pattern]) => pattern.test(url))?.[1] ?? "external";
-}
-function existingUrls(file) {
-    if (!fs.existsSync(file))
-        return new Set();
-    return new Set(Array.from(fs.readFileSync(file, "utf8").matchAll(/-->\s*(https?:\/\/\S+)|—\s+(https?:\/\/\S+)/g), (match) => match[1] ?? match[2]));
-}
-export function main(argv = process.argv.slice(2)) {
-    if (argv.length < 2) {
-        console.log("Usage: import-bookmarks <bookmarks.html> <bookmarks.md>");
-        return 1;
-    }
-    const [htmlPath, mdPath] = argv;
-    if (!fs.existsSync(htmlPath)) {
-        console.log(`Error: ${htmlPath} not found`);
-        return 1;
-    }
-    const html = fs.readFileSync(htmlPath, "utf8");
-    const bookmarks = Array.from(html.matchAll(/<A\b[^>]*HREF=["']([^"']+)["'][^>]*>(.*?)<\/A>/gi), (match) => ({ url: match[1], title: match[2].replace(/<[^>]+>/g, "").trim() }));
-    console.log(`Found ${bookmarks.length} bookmarks in HTML`);
-    const seen = existingUrls(mdPath);
-    console.log(`Found ${seen.size} existing entries in bookmarks.md`);
-    const today = new Date().toISOString().slice(0, 10);
-    const entries = [];
-    let skipped = 0;
-    let preserved = 0;
-    for (const bookmark of bookmarks) {
-        if (!/^https?:\/\//.test(bookmark.url) || SKIP.some((pattern) => pattern.test(bookmark.url))) {
-            skipped += 1;
-            continue;
-        }
-        if (seen.has(bookmark.url)) {
-            preserved += 1;
-            continue;
-        }
-        entries.push(`- **${today}** [${inferTag(bookmark.url)}]: ${bookmark.title} — ${bookmark.url} — (imported from browser)`);
-    }
-    if (entries.length)
-        fs.appendFileSync(mdPath, `${fs.existsSync(mdPath) ? "\n" : ""}${entries.join("\n")}\n`, "utf8");
-    console.log(`Added ${entries.length} new bookmarks`);
-    console.log(`Preserved ${preserved} existing bookmarks`);
-    console.log(`Skipped ${skipped} routine/non-http bookmarks`);
-    return 0;
-}
-if (import.meta.url === `file://${process.argv[1]}`)
-    process.exit(main());

package/build/src/cli/instinct-cli.js

@@ -1,93 +0,0 @@
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-const SOUL_PATH = process.env.SOUL_PATH ?? path.join(os.homedir(), ".soul");
-const INSTINCTS_DIR = path.join(SOUL_PATH, "knowledge", "instincts");
-function parse(file) {
-    const text = fs.readFileSync(file, "utf8");
-    if (!text.startsWith("---"))
-        return null;
-    const [, fm, body] = text.split("---", 3);
-    const meta = {};
-    for (const line of fm.trim().split(/\r?\n/)) {
-        const idx = line.indexOf(":");
-        if (idx === -1)
-            continue;
-        const key = line.slice(0, idx).trim();
-        const raw = line.slice(idx + 1).trim().replace(/^["']|["']$/g, "");
-        meta[key] = key === "confidence" ? Number(raw) : key === "observation_count" ? Number.parseInt(raw, 10) : raw;
-    }
-    meta._body = body.trim();
-    meta._path = file;
-    return meta;
-}
-function files() {
-    const roots = [path.join(INSTINCTS_DIR, "global"), path.join(INSTINCTS_DIR, "projects")];
-    const out = [];
-    for (const root of roots) {
-        if (!fs.existsSync(root))
-            continue;
-        const stack = [root];
-        while (stack.length) {
-            const dir = stack.pop();
-            for (const name of fs.readdirSync(dir)) {
-                const file = path.join(dir, name);
-                if (fs.statSync(file).isDirectory())
-                    stack.push(file);
-                else if (file.endsWith(".md"))
-                    out.push(file);
-            }
-        }
-    }
-    return out;
-}
-function write(inst, file) {
-    const body = String(inst._body ?? "");
-    const lines = ["---"];
-    for (const [key, value] of Object.entries(inst))
-        if (!key.startsWith("_"))
-            lines.push(`${key}: ${typeof value === "number" ? value : String(value)}`);
-    lines.push("---", "", body);
-    fs.mkdirSync(path.dirname(file), { recursive: true });
-    fs.writeFileSync(file, `${lines.join("\n").trimEnd()}\n`, "utf8");
-}
-export function main(argv = process.argv.slice(2)) {
-    const [command, ...rest] = argv;
-    const instincts = files().map(parse).filter((item) => Boolean(item));
-    if (command === "status") {
-        const global = instincts.filter((item) => item.scope === "global").length;
-        console.log(`Total instincts: ${instincts.length}`);
-        console.log(`  Global: ${global}, Project: ${instincts.length - global}`);
-        return 0;
-    }
-    if (command === "list") {
-        for (const inst of instincts)
-            console.log(`  [${Number(inst.confidence ?? 0).toFixed(2)}] ${inst.id ?? "?"} - ${inst.trigger ?? "?"} (${inst.scope ?? "?"})`);
-        return 0;
-    }
-    if (command === "show") {
-        const found = instincts.find((item) => item.id === rest[0]);
-        if (!found) {
-            console.error(`Instinct '${rest[0]}' not found.`);
-            return 1;
-        }
-        console.log(fs.readFileSync(String(found._path), "utf8"));
-        return 0;
-    }
-    if (command === "create") {
-        const id = rest[rest.indexOf("--id") + 1];
-        const trigger = rest[rest.indexOf("--trigger") + 1];
-        const domain = rest[rest.indexOf("--domain") + 1];
-        const scope = rest.includes("--scope") ? rest[rest.indexOf("--scope") + 1] : "project";
-        if (!id || !trigger || !domain)
-            return 2;
-        const file = scope === "global" ? path.join(INSTINCTS_DIR, "global", `${id}.md`) : path.join(INSTINCTS_DIR, "projects", rest[rest.indexOf("--project-id") + 1] ?? "default", "instincts", `${id}.md`);
-        write({ id, trigger, confidence: 0.3, domain, source: "session-observation", scope, created: new Date().toISOString().slice(0, 10), last_observed: new Date().toISOString().slice(0, 10), observation_count: 1, _body: `# ${id}\n\n## Action\nTBD` }, file);
-        console.log(`Created ${file}`);
-        return 0;
-    }
-    console.error("usage: instinct-cli <status|list|show|create>");
-    return 2;
-}
-if (import.meta.url === `file://${process.argv[1]}`)
-    process.exit(main());