@sidub-inc/docuoria.cli 1.0.15

package/dist/index.js

@@ -0,0 +1,1056 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// package.json
+var require_package = __commonJS({
+  "package.json"(exports2, module2) {
+    module2.exports = {
+      name: "@sidub-inc/docuoria.cli",
+      version: "0.0.0",
+      description: "Install the Docuoria AI plugin into any AI tool skill directory.",
+      keywords: ["docuoria", "ai-agent", "skill", "agentskills", "pdf", "extraction"],
+      license: "MIT",
+      author: "Sidub Inc.",
+      homepage: "https://github.com/Sidub-Inc/Docuoria",
+      repository: {
+        type: "git",
+        url: "https://github.com/Sidub-Inc/Docuoria.git",
+        directory: "src/hosts/docuoria-cli-npm"
+      },
+      bugs: {
+        url: "https://github.com/Sidub-Inc/Docuoria/issues"
+      },
+      engines: {
+        node: ">=20.0.0",
+        pnpm: ">=9.0.0"
+      },
+      bin: {
+        docuoria: "./bin/docuoria.js"
+      },
+      main: "./dist/index.js",
+      files: [
+        "bin/",
+        "dist/",
+        "payload/"
+      ],
+      publishConfig: {
+        access: "public"
+      },
+      scripts: {
+        build: "tsup",
+        test: "vitest run",
+        prepublishOnly: "node scripts/verify-payload.mjs"
+      },
+      dependencies: {
+        "@inquirer/prompts": "^7.0.0",
+        commander: "^12.0.0",
+        picocolors: "^1.1.0"
+      },
+      devDependencies: {
+        "@types/node": "^20.0.0",
+        tsup: "^8.0.0",
+        typescript: "^5.4.0",
+        vitest: "^2.0.0"
+      }
+    };
+  }
+});
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  run: () => run
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/cli/index.ts
+var import_commander6 = require("commander");
+
+// src/cli/exit-codes.ts
+var EXIT_OK = 0;
+var EXIT_ERROR = 1;
+var EXIT_BAD_USAGE = 2;
+var EXIT_CONFLICT = 3;
+
+// src/cli/commands/init.ts
+var import_commander = require("commander");
+var import_node_fs5 = require("fs");
+var import_node_path5 = require("path");
+
+// src/adapters/agents-md.ts
+var agentsMdAdapter = {
+  toolId: "agents-md",
+  displayName: "AGENTS.md (universal fallback)",
+  detectionRoots: [],
+  skill: {
+    relativeDir: ".",
+    skillFolderName: "AGENTS.md",
+    frontmatterDialect: "html-comment"
+  },
+  command: void 0,
+  isGlobal: false
+};
+
+// src/adapters/claude.ts
+var claudeAdapter = {
+  toolId: "claude",
+  displayName: "Claude Code",
+  detectionRoots: [".claude"],
+  skill: { relativeDir: ".claude/skills" },
+  command: { relativeDir: ".claude/commands", filenamePattern: "docuoria-{id}.md" },
+  isGlobal: false
+};
+
+// src/adapters/cursor.ts
+var cursorAdapter = {
+  toolId: "cursor",
+  displayName: "Cursor",
+  detectionRoots: [".cursor"],
+  skill: { relativeDir: ".cursor/skills" },
+  command: { relativeDir: ".cursor/commands", filenamePattern: "docuoria-{id}.md" },
+  isGlobal: false
+};
+
+// src/adapters/github-copilot.ts
+var githubCopilotAdapter = {
+  toolId: "github-copilot",
+  displayName: "GitHub Copilot",
+  detectionRoots: [".github/copilot-instructions.md", ".github/prompts"],
+  skill: { relativeDir: ".github/skills" },
+  command: {
+    relativeDir: ".github/prompts",
+    filenamePattern: "docuoria-{id}.prompt.md"
+  },
+  isGlobal: false
+};
+
+// src/adapters/codex.ts
+var codexAdapter = {
+  toolId: "codex",
+  displayName: "Codex",
+  detectionRoots: [".codex"],
+  skill: void 0,
+  command: { relativeDir: "prompts", filenamePattern: "docuoria-{id}.md" },
+  isGlobal: true
+};
+
+// src/adapters/windsurf.ts
+var windsurfAdapter = {
+  toolId: "windsurf",
+  displayName: "Windsurf",
+  detectionRoots: [".windsurf"],
+  skill: { relativeDir: ".windsurf/skills" },
+  command: { relativeDir: ".windsurf/workflows", filenamePattern: "docuoria-{id}.md" },
+  isGlobal: false
+};
+
+// src/adapters/aitk.ts
+var aitkAdapter = {
+  toolId: "aitk",
+  displayName: "VS Code AI Toolkit",
+  detectionRoots: [".aitk"],
+  skill: { relativeDir: ".aitk/skills" },
+  command: void 0,
+  isGlobal: false
+};
+
+// src/adapters/registry.ts
+var ToolAdapterRegistry = class {
+  _adapters = [];
+  _byId = /* @__PURE__ */ new Map();
+  constructor() {
+    this.register(agentsMdAdapter);
+    this.register(claudeAdapter);
+    this.register(cursorAdapter);
+    this.register(githubCopilotAdapter);
+    this.register(codexAdapter);
+    this.register(windsurfAdapter);
+    this.register(aitkAdapter);
+  }
+  register(adapter) {
+    const key = adapter.toolId.toLowerCase();
+    if (this._byId.has(key)) {
+      throw new Error(
+        `ToolAdapterRegistry: duplicate toolId '${adapter.toolId}'. Each adapter must have a unique ID.`
+      );
+    }
+    this._adapters.push(adapter);
+    this._byId.set(key, adapter);
+  }
+  /**
+   * The ordered catalog of all registered adapters. This is the single
+   * source of truth for the --tools flag, list-tools, and the interactive picker.
+   */
+  get AI_TOOLS() {
+    return this._adapters;
+  }
+  /** Returns the adapter for the given tool ID, or undefined if not found (case-insensitive). */
+  tryGet(toolId) {
+    return this._byId.get(toolId.toLowerCase());
+  }
+  /** Returns the adapter for the given tool ID, throwing if not found. */
+  get(toolId) {
+    const adapter = this.tryGet(toolId);
+    if (!adapter) {
+      throw new Error(
+        `Unknown tool ID: '${toolId}'. Run 'docuoria list-tools' to see valid IDs.`
+      );
+    }
+    return adapter;
+  }
+};
+var toolAdapterRegistry = new ToolAdapterRegistry();
+
+// src/detection/detection-scanner.ts
+var import_node_fs2 = require("fs");
+var import_node_path2 = require("path");
+
+// src/detection/global-path-resolver.ts
+var import_node_os = require("os");
+var import_node_path = require("path");
+function resolveGlobalRoot(toolId) {
+  if (toolId === "codex") {
+    const codexHome = process.env["CODEX_HOME"];
+    if (codexHome) return codexHome;
+    return (0, import_node_path.join)((0, import_node_os.homedir)(), ".codex");
+  }
+  throw new Error(`No global path resolver for tool '${toolId}'.`);
+}
+
+// src/detection/frontmatter-reader.ts
+var import_node_fs = require("fs");
+function tryReadFrontmatterSync(filePath) {
+  if (!(0, import_node_fs.existsSync)(filePath)) return void 0;
+  try {
+    const content = (0, import_node_fs.readFileSync)(filePath, { encoding: "utf8", flag: "r" }).slice(0, 4096);
+    return parseYaml(content) ?? parseToml(content) ?? parseHtmlComment(content);
+  } catch {
+    return void 0;
+  }
+}
+function parseYaml(text) {
+  if (!text.startsWith("---")) return void 0;
+  const end = text.indexOf("\n---", 3);
+  if (end < 0) return void 0;
+  return parseKV(text.slice(3, end));
+}
+function parseToml(text) {
+  if (!text.startsWith("+++")) return void 0;
+  const end = text.indexOf("\n+++", 3);
+  if (end < 0) return void 0;
+  return parseKV(text.slice(3, end));
+}
+function parseHtmlComment(text) {
+  if (!text.startsWith("<!--")) return void 0;
+  const end = text.indexOf("-->", 4);
+  if (end < 0) return void 0;
+  return parseKV(text.slice(4, end));
+}
+function parseKV(block) {
+  let isManaged = false;
+  let version;
+  for (const raw of block.split(/[\r\n]+/)) {
+    const line = raw.trim();
+    if (/^docuoria-generated:/i.test(line)) {
+      const val = line.replace(/^docuoria-generated:\s*/i, "").replace(/['"]/g, "").trim();
+      isManaged = val.toLowerCase() === "true";
+    } else if (/^docuoria-version:/i.test(line)) {
+      version = line.replace(/^docuoria-version:\s*/i, "").replace(/['"]/g, "").trim() || void 0;
+    }
+  }
+  return { isManaged, version };
+}
+
+// src/detection/detection-scanner.ts
+function scanAll(projectRoot) {
+  return toolAdapterRegistry.AI_TOOLS.map((adapter) => scan(adapter, projectRoot));
+}
+function scan(adapter, projectRoot) {
+  const detectedRoots = findDetectedRoots(adapter, projectRoot);
+  const writeRoot = adapter.isGlobal ? resolveGlobalRoot(adapter.toolId) : projectRoot;
+  const state = determineState(adapter, detectedRoots, writeRoot);
+  const installedVersion = readFirstStampVersion(adapter, writeRoot);
+  return {
+    toolId: adapter.toolId,
+    state,
+    detectedRoots,
+    installedPayloadVersion: installedVersion ?? void 0,
+    installedCliVersion: installedVersion ?? void 0
+  };
+}
+function findDetectedRoots(adapter, projectRoot) {
+  if (adapter.isGlobal) {
+    const globalRoot = resolveGlobalRoot(adapter.toolId);
+    return (0, import_node_fs2.existsSync)(globalRoot) ? [globalRoot] : [];
+  }
+  return adapter.detectionRoots.map((rel) => (0, import_node_path2.join)(projectRoot, rel)).filter((abs) => (0, import_node_fs2.existsSync)(abs));
+}
+function determineState(adapter, detectedRoots, writeRoot) {
+  if (detectedRoots.length === 0) return "available";
+  if (!hasAnyPayloadFile(adapter, writeRoot)) return "detected";
+  const stamp = readFirstStamp(adapter, writeRoot);
+  if (!stamp?.isManaged) return "configured";
+  const current = getCurrentCliVersion();
+  if (stamp.version && current && stamp.version !== current) return "stale";
+  return "configured";
+}
+function hasAnyPayloadFile(adapter, writeRoot) {
+  if (adapter.skill) {
+    const skillDir = (0, import_node_path2.join)(writeRoot, adapter.skill.relativeDir, adapter.skill.skillFolderName ?? "docuoria");
+    if ((0, import_node_fs2.existsSync)(skillDir) && (0, import_node_fs2.readdirSync)(skillDir).length > 0) return true;
+  }
+  if (adapter.command) {
+    const cmdDir = (0, import_node_path2.join)(writeRoot, adapter.command.relativeDir);
+    if ((0, import_node_fs2.existsSync)(cmdDir)) {
+      const prefix = adapter.command.filenamePattern.split("{id}")[0];
+      if ((0, import_node_fs2.readdirSync)(cmdDir).some((f) => f.startsWith(prefix))) return true;
+    }
+  }
+  return false;
+}
+function readFirstStamp(adapter, writeRoot) {
+  if (adapter.skill) {
+    const skillDir = (0, import_node_path2.join)(writeRoot, adapter.skill.relativeDir, adapter.skill.skillFolderName ?? "docuoria");
+    if ((0, import_node_fs2.existsSync)(skillDir)) {
+      const first = (0, import_node_fs2.readdirSync)(skillDir).find((f) => f.endsWith(".md"));
+      if (first) return tryReadFrontmatterSync((0, import_node_path2.join)(skillDir, first));
+    }
+  }
+  if (adapter.command) {
+    const cmdDir = (0, import_node_path2.join)(writeRoot, adapter.command.relativeDir);
+    if ((0, import_node_fs2.existsSync)(cmdDir)) {
+      const prefix = adapter.command.filenamePattern.split("{id}")[0];
+      const first = (0, import_node_fs2.readdirSync)(cmdDir).find((f) => f.startsWith(prefix));
+      if (first) return tryReadFrontmatterSync((0, import_node_path2.join)(cmdDir, first));
+    }
+  }
+  return void 0;
+}
+function readFirstStampVersion(adapter, writeRoot) {
+  return readFirstStamp(adapter, writeRoot)?.version ?? null;
+}
+function getCurrentCliVersion() {
+  try {
+    const pkg = require_package();
+    return pkg.version;
+  } catch {
+    return void 0;
+  }
+}
+
+// src/installer/write.ts
+var import_node_crypto = require("crypto");
+var import_node_fs3 = require("fs");
+var import_node_path3 = require("path");
+
+// src/adapters/types.ts
+var WORKFLOWS = [
+  "extract",
+  "classify",
+  "diagnose",
+  "validate-template",
+  "inspect"
+];
+
+// src/installer/frontmatter-stamp.ts
+function injectStamp(sourceContent, payloadVersion, dialect) {
+  const body = stripExistingFrontmatter(sourceContent, dialect);
+  const block = buildBlock(payloadVersion, dialect);
+  return block + body;
+}
+function buildBlock(version, dialect) {
+  switch (dialect) {
+    case "yaml":
+      return `---
+docuoria-generated: true
+docuoria-version: ${version}
+---
+`;
+    case "toml":
+      return `+++
+docuoria-generated = true
+docuoria-version = "${version}"
++++
+`;
+    case "html-comment":
+      return `<!-- docuoria-generated: true
+     docuoria-version: ${version} -->
+`;
+    case "none":
+      return "";
+  }
+}
+function stripExistingFrontmatter(content, dialect) {
+  switch (dialect) {
+    case "yaml":
+      return stripDelimited(content, "---", "\n---");
+    case "toml":
+      return stripDelimited(content, "+++", "\n+++");
+    case "html-comment":
+      return stripDelimited(content, "<!--", "-->");
+    case "none":
+      return content;
+  }
+}
+function stripDelimited(content, open, close) {
+  if (!content.startsWith(open)) return content;
+  const closeIdx = content.indexOf(close, open.length);
+  if (closeIdx < 0) return content;
+  let after = closeIdx + close.length;
+  if (content[after] === "\n") after++;
+  return content.slice(after);
+}
+
+// src/installer/write.ts
+function writeAdapter(adapter, payloadRoot, payloadVersion, writeRoot, delivery, force) {
+  let copied = 0;
+  let skipped = 0;
+  const conflicts = [];
+  if (shouldWriteSkills(adapter, delivery)) {
+    const r = writeSkillChannel(adapter, payloadRoot, payloadVersion, writeRoot, force, conflicts);
+    copied += r.copied;
+    skipped += r.skipped;
+  } else if (delivery !== "commands" && !adapter.skill) {
+    process.stderr.write(`docuoria: skills skipped for: ${adapter.toolId} (no adapter support)
+`);
+  }
+  if (shouldWriteCommands(adapter, delivery)) {
+    const r = writeCommandChannel(adapter, payloadRoot, payloadVersion, writeRoot, force, conflicts);
+    copied += r.copied;
+    skipped += r.skipped;
+  } else if (delivery !== "skills" && !adapter.command) {
+    process.stderr.write(`docuoria: commands skipped for: ${adapter.toolId} (no adapter support)
+`);
+  }
+  return { toolId: adapter.toolId, copied, skipped, conflicts };
+}
+function writeSkillChannel(adapter, payloadRoot, payloadVersion, writeRoot, force, conflicts) {
+  const layout = adapter.skill;
+  const srcDir = (0, import_node_path3.join)(payloadRoot, "skill");
+  const dstDir = (0, import_node_path3.join)(writeRoot, layout.relativeDir, layout.skillFolderName ?? "docuoria");
+  return writeDirectory(srcDir, dstDir, layout.frontmatterDialect ?? "yaml", payloadVersion, force, conflicts);
+}
+function writeCommandChannel(adapter, payloadRoot, payloadVersion, writeRoot, force, conflicts) {
+  const layout = adapter.command;
+  const srcDir = (0, import_node_path3.join)(payloadRoot, "commands");
+  const dstDir = (0, import_node_path3.join)(writeRoot, layout.relativeDir);
+  let copied = 0;
+  let skipped = 0;
+  for (const workflowId of WORKFLOWS) {
+    const srcFile = (0, import_node_path3.join)(srcDir, `${workflowId}.md`);
+    if (!(0, import_node_fs3.existsSync)(srcFile)) continue;
+    const filename = layout.filenamePattern.replace("{id}", workflowId);
+    const dstFile = (0, import_node_path3.join)(dstDir, filename);
+    const outcome = writeFile(srcFile, dstFile, "yaml", payloadVersion, force);
+    if (outcome === "copied") copied++;
+    else if (outcome === "skipped") skipped++;
+    else conflicts.push(filename);
+  }
+  return { copied, skipped };
+}
+function writeDirectory(srcDir, dstDir, dialect, payloadVersion, force, conflicts) {
+  if (!(0, import_node_fs3.existsSync)(srcDir)) return { copied: 0, skipped: 0 };
+  let copied = 0;
+  let skipped = 0;
+  for (const entry of (0, import_node_fs3.readdirSync)(srcDir, { recursive: true, withFileTypes: true })) {
+    if (!entry.isFile()) continue;
+    const srcFile = (0, import_node_path3.join)(entry.parentPath ?? entry.path, entry.name);
+    const rel = (0, import_node_path3.relative)(srcDir, srcFile);
+    const dstFile = (0, import_node_path3.join)(dstDir, rel);
+    const outcome = writeFile(srcFile, dstFile, dialect, payloadVersion, force);
+    if (outcome === "copied") copied++;
+    else if (outcome === "skipped") skipped++;
+    else conflicts.push(rel);
+  }
+  return { copied, skipped };
+}
+function writeFile(srcPath, dstPath, dialect, payloadVersion, force) {
+  const isMarkdown = (0, import_node_path3.extname)(srcPath).toLowerCase() === ".md";
+  let srcBytes;
+  if (isMarkdown && dialect !== "none") {
+    const raw = (0, import_node_fs3.readFileSync)(srcPath, "utf8");
+    const stamped = injectStamp(raw, payloadVersion, dialect);
+    srcBytes = Buffer.from(stamped, "utf8");
+  } else {
+    srcBytes = (0, import_node_fs3.readFileSync)(srcPath);
+  }
+  if ((0, import_node_fs3.existsSync)(dstPath)) {
+    const dstBytes = (0, import_node_fs3.readFileSync)(dstPath);
+    if (sha256Equal(srcBytes, dstBytes)) return "skipped";
+    const stamp = tryReadFrontmatterSync(dstPath);
+    if (!stamp?.isManaged && !force) return "conflict";
+  }
+  (0, import_node_fs3.mkdirSync)((0, import_node_path3.dirname)(dstPath), { recursive: true });
+  atomicWrite(dstPath, srcBytes);
+  return "copied";
+}
+function sha256Equal(a, b) {
+  if (a.length !== b.length) return false;
+  return (0, import_node_crypto.createHash)("sha256").update(a).digest("hex") === (0, import_node_crypto.createHash)("sha256").update(b).digest("hex");
+}
+function atomicWrite(destination, content) {
+  const dir = (0, import_node_path3.dirname)(destination);
+  const tmp = (0, import_node_path3.join)(dir, (0, import_node_crypto.randomUUID)());
+  try {
+    (0, import_node_fs3.writeFileSync)(tmp, content);
+    (0, import_node_fs3.renameSync)(tmp, destination);
+  } catch (err) {
+    try {
+      (0, import_node_fs3.unlinkSync)(tmp);
+    } catch {
+    }
+    throw err;
+  }
+}
+function shouldWriteSkills(adapter, d) {
+  return !!adapter.skill && (d === "skills" || d === "both");
+}
+function shouldWriteCommands(adapter, d) {
+  return !!adapter.command && (d === "commands" || d === "both");
+}
+
+// src/installer/lockfile.ts
+var import_node_fs4 = require("fs");
+var import_node_path4 = require("path");
+var import_node_crypto2 = require("crypto");
+var SCHEMA_VERSION = 1;
+var DIR = ".docuoria";
+var FILENAME = "installed.json";
+function getLockfilePath(projectRoot) {
+  return (0, import_node_path4.join)(projectRoot, DIR, FILENAME);
+}
+function tryReadLockfile(projectRoot) {
+  const path = getLockfilePath(projectRoot);
+  if (!(0, import_node_fs4.existsSync)(path)) return void 0;
+  try {
+    return JSON.parse((0, import_node_fs4.readFileSync)(path, "utf8"));
+  } catch {
+    return void 0;
+  }
+}
+function writeLockfile(projectRoot, data) {
+  const dir = (0, import_node_path4.join)(projectRoot, DIR);
+  (0, import_node_fs4.mkdirSync)(dir, { recursive: true });
+  const path = getLockfilePath(projectRoot);
+  atomicWrite2(path, JSON.stringify({ ...data, schemaVersion: SCHEMA_VERSION }, null, 2) + "\n");
+}
+function mergeLockfile(projectRoot, cliVersion, payloadVersion, newTools, newGlobalTools) {
+  const existing = tryReadLockfile(projectRoot);
+  const mergedTools = [.../* @__PURE__ */ new Set([...existing?.tools ?? [], ...newTools])].sort();
+  const mergedGlobal = [.../* @__PURE__ */ new Set([...existing?.globalTools ?? [], ...newGlobalTools])].sort();
+  writeLockfile(projectRoot, {
+    schemaVersion: SCHEMA_VERSION,
+    cliVersion,
+    payloadVersion,
+    installedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    tools: mergedTools,
+    globalTools: mergedGlobal
+  });
+}
+function atomicWrite2(destination, content) {
+  const dir = (0, import_node_path4.join)(destination, "..");
+  const tmp = (0, import_node_path4.join)(dir, (0, import_node_crypto2.randomUUID)());
+  try {
+    (0, import_node_fs4.writeFileSync)(tmp, content, "utf8");
+    (0, import_node_fs4.renameSync)(tmp, destination);
+  } catch (err) {
+    try {
+      (0, import_node_fs4.unlinkSync)(tmp);
+    } catch {
+    }
+    throw err;
+  }
+}
+
+// src/installer/global-confirm.ts
+var import_node_readline = require("readline");
+async function confirmGlobalWrite(adapter) {
+  if (!adapter.isGlobal) return true;
+  const globalRoot = resolveGlobalRoot(adapter.toolId);
+  const message = `docuoria: ${adapter.toolId} writes to ${globalRoot} (global, shared across projects). Continue? [Y/n] `;
+  const isInteractive = process.stdin.isTTY && process.stdout.isTTY;
+  if (!isInteractive) {
+    process.stderr.write(message.trimEnd() + "\n");
+    return true;
+  }
+  return new Promise((resolve3) => {
+    const rl = (0, import_node_readline.createInterface)({ input: process.stdin, output: process.stdout });
+    rl.question(message, (answer) => {
+      rl.close();
+      const a = answer.trim().toLowerCase();
+      resolve3(a === "" || a === "y" || a === "yes");
+    });
+  });
+}
+
+// src/cli/banner.ts
+var import_picocolors = __toESM(require("picocolors"));
+var BANNER = `
+  \u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557   \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557
+  \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557
+  \u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551
+  \u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551
+  \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551
+  \u255A\u2550\u2550\u2550\u2550\u2550\u255D  \u255A\u2550\u2550\u2550\u2550\u2550\u255D  \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D  \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D
+`;
+function showBanner() {
+  process.stdout.write(import_picocolors.default.blue(BANNER));
+  process.stdout.write(import_picocolors.default.dim("  Scaffold AI skills for your AI-agent tools.\n\n"));
+}
+
+// src/cli/interactive.ts
+var import_prompts = require("@inquirer/prompts");
+var import_picocolors2 = __toESM(require("picocolors"));
+function isInteractiveTTY() {
+  return Boolean(process.stdin.isTTY) && !process.env["CI"];
+}
+async function promptToolSelection(detectionResults) {
+  const stateOrder = {
+    configured: 0,
+    detected: 1,
+    stale: 2,
+    available: 3
+  };
+  const sorted = [...detectionResults].sort((a, b) => {
+    const diff = (stateOrder[a.state] ?? 3) - (stateOrder[b.state] ?? 3);
+    if (diff !== 0) return diff;
+    return a.toolId.localeCompare(b.toolId);
+  });
+  const choices = sorted.map((r) => {
+    const adapter = toolAdapterRegistry.get(r.toolId);
+    const ver = r.installedPayloadVersion ? ` v${r.installedPayloadVersion}` : "";
+    let stateTag;
+    switch (r.state) {
+      case "configured":
+        stateTag = import_picocolors2.default.green(`[configured \u2713${ver}]`);
+        break;
+      case "stale":
+        stateTag = import_picocolors2.default.yellow(`[stale${ver}]`);
+        break;
+      case "detected":
+        stateTag = import_picocolors2.default.cyan("[detected]");
+        break;
+      default:
+        stateTag = import_picocolors2.default.dim("[available]");
+    }
+    const name = `${r.toolId.padEnd(20)} ${adapter.displayName.padEnd(28)} ${stateTag}`;
+    return {
+      name,
+      value: r.toolId,
+      // 6.3 — Pre-select configured/detected tools.
+      checked: r.state === "configured" || r.state === "detected"
+    };
+  });
+  let selected;
+  try {
+    selected = await (0, import_prompts.checkbox)({
+      message: "Select AI tools to scaffold Docuoria skills for:",
+      choices,
+      pageSize: 12,
+      // 6.4 — Validate at-least-one selection.
+      validate: (s) => s.length > 0 || "Select at least one tool"
+    });
+  } catch {
+    return void 0;
+  }
+  if (selected.length === 0) return void 0;
+  return selected.map((id) => toolAdapterRegistry.tryGet(id)).filter((a) => a != null);
+}
+
+// src/cli/commands/init.ts
+var import_meta = {};
+function cmdInit() {
+  return new import_commander.Command("init").description("Scaffold Docuoria AI skills for the selected tools.").argument("[path]", "target directory (default: .)").option("--tools <list>", "comma-separated tool IDs, or 'all'/'none'").option("--delivery <channel>", "skills, commands, or both (default: both)", "both").option("--force", "overwrite locally-modified files").option("--profile <name>", "payload profile (core | custom)").option("--no-interactive", "suppress interactive prompts").exitOverride().action(async (pathArg, opts) => {
+    const targetDir = resolveTargetDir(pathArg ?? ".");
+    if (!targetDir) {
+      process.exitCode = EXIT_ERROR;
+      return;
+    }
+    const delivery = parseDelivery(opts.delivery);
+    if (!delivery) {
+      process.exitCode = EXIT_BAD_USAGE;
+      return;
+    }
+    const interactive = !opts.noInteractive && opts.tools == null && isInteractiveTTY();
+    let adapters;
+    if (!interactive) {
+      const parsed = parseTools(opts.tools ?? "all");
+      if (!parsed) {
+        process.exitCode = EXIT_BAD_USAGE;
+        return;
+      }
+      adapters = parsed;
+    } else {
+      showBanner();
+      const results = scanAll(targetDir);
+      const picked = await promptToolSelection(results);
+      if (!picked) {
+        process.exitCode = EXIT_ERROR;
+        return;
+      }
+      adapters = picked;
+    }
+    process.exitCode = await executeInit(targetDir, adapters, delivery, opts.force ?? false);
+  });
+}
+async function executeInit(targetDir, adapters, delivery, force) {
+  const payloadRoot = resolvePayloadRoot();
+  const payloadVersion = readPayloadVersion(payloadRoot);
+  const cliVersion = readCliVersion();
+  let exitCode = EXIT_OK;
+  const installedTools = [];
+  const installedGlobal = [];
+  for (const adapter of adapters) {
+    if (adapter.isGlobal) {
+      const proceed = await confirmGlobalWrite(adapter);
+      if (!proceed) {
+        process.stderr.write(`docuoria: skipping ${adapter.toolId} (user declined).
+`);
+        continue;
+      }
+    }
+    const writeRoot = adapter.isGlobal ? resolveGlobalRoot(adapter.toolId) : targetDir;
+    let result;
+    try {
+      result = writeAdapter(adapter, payloadRoot, payloadVersion, writeRoot, delivery, force);
+    } catch (err) {
+      if (err.code === "EACCES") {
+        process.stderr.write(
+          `docuoria: insufficient permissions writing to ${writeRoot}: ${String(err)}
+`
+        );
+        exitCode = EXIT_ERROR;
+        continue;
+      }
+      throw err;
+    }
+    if (result.conflicts.length > 0) {
+      process.stderr.write(
+        `docuoria: refusing to overwrite ${result.conflicts.length} modified file(s) (rerun with --force):
+`
+      );
+      for (const c of result.conflicts) process.stderr.write(`  - ${c}
+`);
+      exitCode = EXIT_CONFLICT;
+      continue;
+    }
+    process.stdout.write(`  ${adapter.toolId}: copied=${result.copied} skipped=${result.skipped}
+`);
+    if (adapter.isGlobal) installedGlobal.push(adapter.toolId);
+    else installedTools.push(adapter.toolId);
+  }
+  if (installedTools.length > 0 || installedGlobal.length > 0) {
+    mergeLockfile(targetDir, cliVersion, payloadVersion, installedTools, installedGlobal);
+  }
+  return exitCode;
+}
+function resolveTargetDir(path) {
+  const abs = (0, import_node_path5.resolve)(path);
+  if (!(0, import_node_fs5.existsSync)(abs)) {
+    const parent = (0, import_node_path5.dirname)(abs);
+    if (!(0, import_node_fs5.existsSync)(parent)) {
+      process.stderr.write(
+        `docuoria init: cannot access path '${path}': parent directory does not exist
+`
+      );
+      return void 0;
+    }
+    (0, import_node_fs5.mkdirSync)(abs, { recursive: true });
+  }
+  return abs;
+}
+function parseTools(toolsArg) {
+  if (!toolsArg || toolsArg === "all") {
+    return [...toolAdapterRegistry.AI_TOOLS];
+  }
+  if (toolsArg === "none") return [];
+  const ids = toolsArg.split(",").map((s) => s.trim()).filter(Boolean);
+  const result = [];
+  for (const id of ids) {
+    const adapter = toolAdapterRegistry.tryGet(id);
+    if (!adapter) {
+      process.stderr.write(
+        `docuoria: unknown tool id '${id}'. Run 'docuoria list-tools' to see valid ids.
+`
+      );
+      return void 0;
+    }
+    result.push(adapter);
+  }
+  return result;
+}
+function parseDelivery(val) {
+  if (val === "skills" || val === "commands" || val === "both") return val;
+  process.stderr.write(
+    `docuoria: --delivery must be 'skills', 'commands', or 'both' \u2014 got '${val}'.
+`
+  );
+  return void 0;
+}
+function resolvePayloadRoot() {
+  return new URL("../../../payload", import_meta.url).pathname;
+}
+function readPayloadVersion(payloadRoot) {
+  try {
+    const manifest = require(payloadRoot + "/MANIFEST.json");
+    return manifest.version ?? "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+function readCliVersion() {
+  try {
+    return require_package().version;
+  } catch {
+    return "0.0.0";
+  }
+}
+
+// src/cli/commands/update.ts
+var import_commander2 = require("commander");
+var import_node_path6 = require("path");
+function cmdUpdate() {
+  return new import_commander2.Command("update").description("Re-apply the bundled payload to previously-installed tools.").argument("[path]", "target directory (default: .)").exitOverride().action(async (pathArg) => {
+    const targetDir = (0, import_node_path6.resolve)(pathArg ?? ".");
+    const lockfile = tryReadLockfile(targetDir);
+    if (!lockfile) {
+      process.stderr.write(
+        "docuoria update: no .docuoria/installed.json found \u2014 run 'docuoria init' first.\n"
+      );
+      process.exitCode = EXIT_ERROR;
+      return;
+    }
+    const allToolIds = [...lockfile.tools, ...lockfile.globalTools];
+    const adapters = allToolIds.map((id) => toolAdapterRegistry.tryGet(id)).filter((a) => a != null);
+    process.exitCode = await executeInit(targetDir, adapters, "both", false);
+  });
+}
+
+// src/cli/commands/list-tools.ts
+var import_commander3 = require("commander");
+var import_picocolors3 = __toESM(require("picocolors"));
+function cmdListTools() {
+  return new import_commander3.Command("list-tools").description("List all supported AI tools with their detection status.").exitOverride().action(() => {
+    const cwd = process.cwd();
+    const results = scanAll(cwd);
+    const ordered = [...results].sort((a, b) => {
+      const stateOrder = {
+        configured: 0,
+        detected: 1,
+        stale: 2,
+        available: 3
+      };
+      return stateOrder[a.state] - stateOrder[b.state] || a.toolId.localeCompare(b.toolId);
+    });
+    process.stdout.write("\n");
+    process.stdout.write(
+      `  ${"Tool ID".padEnd(20)} ${"Display Name".padEnd(30)} Status
+`
+    );
+    process.stdout.write(
+      `  ${"\u2500".repeat(19)} ${"\u2500".repeat(29)} ${"\u2500".repeat(13)}
+`
+    );
+    for (const r of ordered) {
+      const adapter = toolAdapterRegistry.get(r.toolId);
+      const ver = r.installedPayloadVersion ? ` v${r.installedPayloadVersion}` : "";
+      let stateLabel;
+      switch (r.state) {
+        case "configured":
+          stateLabel = import_picocolors3.default.green(`configured \u2713${ver}`);
+          break;
+        case "stale":
+          stateLabel = import_picocolors3.default.yellow(`stale${ver}`);
+          break;
+        case "detected":
+          stateLabel = import_picocolors3.default.cyan("detected");
+          break;
+        default:
+          stateLabel = import_picocolors3.default.dim("available");
+      }
+      process.stdout.write(
+        `  ${r.toolId.padEnd(20)} ${adapter.displayName.padEnd(30)} ${stateLabel}
+`
+      );
+    }
+    process.stdout.write("\n");
+    process.exitCode = EXIT_OK;
+  });
+}
+
+// src/cli/commands/doctor.ts
+var import_commander4 = require("commander");
+var import_picocolors4 = __toESM(require("picocolors"));
+var import_meta2 = {};
+function cmdDoctor() {
+  return new import_commander4.Command("doctor").description("Check Docuoria installation health and report drift.").exitOverride().action(() => {
+    const cwd = process.cwd();
+    const results = scanAll(cwd);
+    const lockfile = tryReadLockfile(cwd);
+    const cliVersion = readCliVersion2();
+    const payloadVersion = readPayloadVersion2();
+    process.stdout.write(`docuoria doctor
+`);
+    process.stdout.write(`  runtime:          Node.js ${process.version}
+`);
+    process.stdout.write(`  CLI version:      ${cliVersion}
+`);
+    process.stdout.write(`  payload version:  ${payloadVersion}
+
+`);
+    let hasDrift = false;
+    if (lockfile) {
+      process.stdout.write(`  installed tools:  ${lockfile.tools.join(", ") || "(none)"}
+`);
+      process.stdout.write(`  installed global: ${lockfile.globalTools.join(", ") || "(none)"}
+`);
+      process.stdout.write(`  installed at:     ${lockfile.installedAt}
+
+`);
+      const allInstalled = [...lockfile.tools, ...lockfile.globalTools];
+      for (const id of allInstalled) {
+        const r = results.find((x) => x.toolId === id);
+        if (r?.state === "stale") {
+          process.stdout.write(
+            import_picocolors4.default.yellow(`  DRIFT: ${id} is at ${r.installedPayloadVersion} (current: ${payloadVersion})
+`)
+          );
+          hasDrift = true;
+        }
+      }
+    } else {
+      process.stdout.write("  not initialised (no .docuoria/installed.json)\n");
+    }
+    process.exitCode = hasDrift ? EXIT_ERROR : EXIT_OK;
+  });
+}
+function readCliVersion2() {
+  try {
+    return require_package().version;
+  } catch {
+    return "unknown";
+  }
+}
+function readPayloadVersion2() {
+  try {
+    const payloadRoot = new URL("../../../payload", import_meta2.url).pathname;
+    return require(payloadRoot + "/MANIFEST.json").version ?? "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+
+// src/cli/commands/version.ts
+var import_commander5 = require("commander");
+var import_meta3 = {};
+function cmdVersion() {
+  return new import_commander5.Command("version").description("Print CLI and payload versions.").exitOverride().action(() => {
+    const cliVersion = readCliVersion3();
+    process.stdout.write(`docuoria CLI: ${cliVersion}
+`);
+    try {
+      const payloadRoot = new URL("../../../payload", import_meta3.url).pathname;
+      const manifest = require(payloadRoot + "/MANIFEST.json");
+      const pkg = manifest.package ?? "?";
+      const ver = manifest.version ?? "?";
+      const built = manifest.builtAt ?? "?";
+      process.stdout.write(`Skill package:   ${pkg} ${ver} (built ${built})
+`);
+    } catch {
+      process.stdout.write("Skill package:   (MANIFEST.json not found alongside CLI)\n");
+    }
+    process.exitCode = EXIT_OK;
+  });
+}
+function readCliVersion3() {
+  try {
+    return require_package().version;
+  } catch {
+    return "unknown";
+  }
+}
+
+// src/cli/index.ts
+function buildProgram() {
+  const program = new import_commander6.Command("docuoria").description("Scaffold Docuoria AI skills into your AI-agent tool directories.").addHelpText("after", "\nRun 'docuoria help' for the full command reference.").exitOverride();
+  program.addCommand(cmdInit());
+  program.addCommand(cmdUpdate());
+  program.addCommand(cmdListTools());
+  program.addCommand(cmdDoctor());
+  program.addCommand(cmdVersion());
+  program.command("install", { hidden: true }).description("[deprecated] Use 'init' instead.").option("--agent <name>", "agent name (translated to --tools)").option("--force", "overwrite locally-modified files").allowUnknownOption().action(async (opts, cmd) => {
+    process.stderr.write(
+      "docuoria: 'install' is deprecated; use 'init' (translating --agent \u2192 --tools).\n"
+    );
+    const translatedArgs = [];
+    if (opts.agent) {
+      translatedArgs.push("--tools", opts.agent);
+    }
+    if (opts.force) translatedArgs.push("--force");
+    const init = cmdInit();
+    await init.parseAsync(translatedArgs, { from: "user" });
+  });
+  program.command("list-agents", { hidden: true }).description("[deprecated] Use 'list-tools' instead.").action(async () => {
+    process.stderr.write(
+      "docuoria: 'list-agents' is deprecated; use 'list-tools'.\n"
+    );
+    const lt = cmdListTools();
+    await lt.parseAsync([], { from: "user" });
+  });
+  program.on("command:*", (operands) => {
+    process.stderr.write(
+      `docuoria: unknown command '${operands[0]}'. Valid commands: init, update, list-tools, doctor, version, help
+`
+    );
+    process.exitCode = EXIT_BAD_USAGE;
+  });
+  return program;
+}
+async function run(argv) {
+  const program = buildProgram();
+  try {
+    await program.parseAsync(argv ?? process.argv);
+  } catch (err) {
+    if (err && typeof err === "object" && "code" in err) {
+      const code = err.exitCode;
+      if (code != null) process.exitCode = code;
+    } else {
+      process.stderr.write(`docuoria: ${String(err)}
+`);
+      process.exitCode = EXIT_BAD_USAGE;
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  run
+});