@delfini/cli 0.1.2 → 0.2.1

package/dist/{chunk-IDYMVTTU.js → chunk-K5X5TSUR.js}

@@ -10,7 +10,7 @@ import {
   normalizeDocScope,
   validateAndReconcile,
   validateDocScopeEntry
-} from "./chunk-MUW24ZC4.js";
+} from "./chunk-LJKEHO6F.js";
 
 // src/cli.ts
 init_esm_shims();
@@ -170,6 +170,199 @@ import { dirname, join as join2, resolve } from "path";
 import { createInterface } from "readline/promises";
 import { fileURLToPath } from "url";
 
+// src/doc-scope.ts
+init_esm_shims();
+import { promises as fs } from "fs";
+import path from "path";
+import { glob } from "tinyglobby";
+var DOC_SCOPE_RELATIVE_PATH = ".claude/skills/delfini/doc-scope.json";
+var DOC_SCOPE_VERSION = 1;
+var DOC_SCOPE_VERSION_MISMATCH_MESSAGE = "your doc-scope.json is for a newer @delfini/cli; please upgrade.";
+var REPO_ROOT_REL = ".";
+var DocScopeVersionMismatchError = class extends Error {
+  code = "DOC_SCOPE_VERSION_MISMATCH";
+  constructor(message = DOC_SCOPE_VERSION_MISMATCH_MESSAGE) {
+    super(message);
+    this.name = "DocScopeVersionMismatchError";
+  }
+};
+var DocScopeCorruptError = class extends Error {
+  code = "DOC_SCOPE_CORRUPT";
+  constructor(message) {
+    super(message);
+    this.name = "DocScopeCorruptError";
+  }
+};
+var DocScopeValidationError = class extends Error {
+  code = "DOC_SCOPE_VALIDATION";
+  constructor(message) {
+    super(message);
+    this.name = "DocScopeValidationError";
+  }
+};
+var docScopeSchemaV1 = external_exports.object({
+  version: external_exports.literal(1),
+  doc_scope: external_exports.array(external_exports.string().min(1))
+});
+var versionProbeSchema = external_exports.object({
+  version: external_exports.number().int().positive()
+});
+async function readDocScope(repoRoot) {
+  const root = repoRoot ?? await getRepoRoot();
+  const target = path.join(root, DOC_SCOPE_RELATIVE_PATH);
+  let raw;
+  try {
+    raw = await fs.readFile(target, "utf8");
+  } catch (err) {
+    if (isNoEntError(err)) return null;
+    throw err;
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (err) {
+    throw new DocScopeCorruptError(
+      `${DOC_SCOPE_RELATIVE_PATH} is malformed: ${err.message}`
+    );
+  }
+  const probe = versionProbeSchema.safeParse(parsed);
+  if (probe.success && probe.data.version > DOC_SCOPE_VERSION) {
+    throw new DocScopeVersionMismatchError();
+  }
+  const result = docScopeSchemaV1.safeParse(parsed);
+  if (!result.success) {
+    throw new DocScopeCorruptError(
+      `${DOC_SCOPE_RELATIVE_PATH} is malformed: ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`
+    );
+  }
+  return result.data;
+}
+async function writeDocScope(paths, options) {
+  const root = options?.repoRoot ?? await getRepoRoot();
+  if (!Array.isArray(paths) || paths.length === 0) {
+    throw new DocScopeValidationError("at least one path is required");
+  }
+  const errors = [];
+  for (const entry of paths) {
+    const err = validateDocScopeEntry(entry, REPO_ROOT_REL);
+    if (err !== null) errors.push(err);
+  }
+  if (errors.length > 0) {
+    throw new DocScopeValidationError(
+      `${DOC_SCOPE_RELATIVE_PATH}: invalid path(s):
+${errors.map((e) => `  - ${e}`).join("\n")}`
+    );
+  }
+  const normalised = normalizeDocScope(paths);
+  if (normalised.length === 0) {
+    throw new DocScopeValidationError(
+      `${DOC_SCOPE_RELATIVE_PATH}: every entry collapses to an empty scope after normalisation (e.g. '.', './', 'docs/..') \u2014 provide at least one concrete path`
+    );
+  }
+  const target = path.join(root, DOC_SCOPE_RELATIVE_PATH);
+  await fs.mkdir(path.dirname(target), { recursive: true });
+  const payload = { version: DOC_SCOPE_VERSION, doc_scope: normalised };
+  const json = `${JSON.stringify(payload, null, 2)}
+`;
+  await fs.writeFile(target, json, "utf8");
+}
+async function docScopeExists(repoRoot) {
+  const root = repoRoot ?? await getRepoRoot();
+  const target = path.join(root, DOC_SCOPE_RELATIVE_PATH);
+  try {
+    const st = await fs.stat(target);
+    return st.isFile();
+  } catch {
+    return false;
+  }
+}
+async function deleteDocScope(repoRoot) {
+  const root = repoRoot ?? await getRepoRoot();
+  const target = path.join(root, DOC_SCOPE_RELATIVE_PATH);
+  try {
+    await fs.unlink(target);
+  } catch (err) {
+    if (!isNoEntError(err)) throw err;
+  }
+}
+async function expandDocScope(paths, repoRoot) {
+  const root = repoRoot ?? await getRepoRoot();
+  const normalisedRoot = path.resolve(root);
+  const found = /* @__PURE__ */ new Set();
+  const missing = [];
+  for (const rawEntry of paths) {
+    if (typeof rawEntry !== "string") continue;
+    const normalised = normalizeDocScope([rawEntry]);
+    if (normalised.length === 0) {
+      if (rawEntry.trim().length > 0) missing.push(rawEntry);
+      continue;
+    }
+    const entry = normalised[0];
+    if (validateDocScopeEntry(entry, REPO_ROOT_REL) !== null) {
+      missing.push(rawEntry);
+      continue;
+    }
+    if (classifyEntry(entry) === "glob") {
+      const matches = await glob(entry, {
+        cwd: root,
+        absolute: true,
+        onlyFiles: true,
+        dot: false,
+        // Case-folding parity with the engine predicate (`nocase: true`).
+        caseSensitiveMatch: false,
+        // Migrating from fast-glob — disable tinyglobby's directory-pattern
+        // auto-expansion so a glob like `packages/*/README.md` keeps exact
+        // fast-glob semantics.
+        expandDirectories: false
+      });
+      const inRoot = matches.filter((m) => isInsideRoot(m, normalisedRoot));
+      if (inRoot.length === 0) {
+        missing.push(rawEntry);
+      } else {
+        for (const m of inRoot) found.add(m);
+      }
+      continue;
+    }
+    const absolute = path.resolve(root, entry);
+    let stat;
+    try {
+      stat = await fs.stat(absolute);
+    } catch (err) {
+      if (isNoEntError(err)) {
+        missing.push(rawEntry);
+        continue;
+      }
+      throw err;
+    }
+    if (stat.isDirectory()) {
+      const children = await glob("**/*.md", {
+        cwd: absolute,
+        absolute: true,
+        onlyFiles: true,
+        caseSensitiveMatch: false,
+        dot: false,
+        expandDirectories: false
+      });
+      for (const c of children) {
+        if (isInsideRoot(c, normalisedRoot)) found.add(c);
+      }
+    } else if (stat.isFile()) {
+      if (isInsideRoot(absolute, normalisedRoot)) found.add(absolute);
+    } else {
+      missing.push(rawEntry);
+    }
+  }
+  const files = Array.from(found).sort();
+  return { files, missingPaths: missing };
+}
+function isNoEntError(err) {
+  return typeof err === "object" && err !== null && err.code === "ENOENT";
+}
+function isInsideRoot(absolute, normalisedRoot) {
+  const resolved = path.resolve(absolute);
+  return resolved === normalisedRoot || resolved.startsWith(normalisedRoot + path.sep);
+}
+
 // src/trace.ts
 init_esm_shims();
 import {
@@ -285,9 +478,74 @@ async function runInstall(targetPath, options) {
   const resolvedTarget = resolve(process.cwd(), targetPath);
   const repoRoot = await getRepoRoot(resolvedTarget);
   writeSkillTemplate(repoRoot, logger);
+  await applyDocScope(repoRoot, logger, options?.provideDocScope);
   await applyAutoInvokeDecision(repoRoot, logger, options?.confirmAutoInvoke);
   appendGitignoreLine(repoRoot, logger);
 }
+function parseScopeInput(answer) {
+  return answer.split(/[\s,]+/u).map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+}
+function sanitiseScope(paths) {
+  return paths.map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+}
+async function applyDocScope(repoRoot, logger, provideDocScope) {
+  const target = join2(repoRoot, DOC_SCOPE_RELATIVE_PATH);
+  if (provideDocScope) {
+    const paths2 = sanitiseScope(await provideDocScope());
+    if (paths2.length === 0) {
+      log(logger, `doc-scope.json \u2192 ${target} (no paths provided, no change)`);
+      return;
+    }
+    await persistDocScope(repoRoot, logger, target, paths2);
+    return;
+  }
+  if (await docScopeExists(repoRoot)) {
+    log(logger, `doc-scope.json \u2192 ${target} (already configured, no change)`);
+    return;
+  }
+  if (!process.stdin.isTTY) {
+    log(
+      logger,
+      `doc-scope.json \u2192 ${target} (non-interactive shell: scope prompt skipped, no change)`
+    );
+    return;
+  }
+  const paths = await promptDocScope();
+  if (paths.length === 0) {
+    log(
+      logger,
+      `doc-scope.json \u2192 ${target} (no paths provided, no change \u2014 first /delfini run will prompt)`
+    );
+    return;
+  }
+  await persistDocScope(repoRoot, logger, target, paths);
+}
+async function promptDocScope() {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const answer = await rl.question(
+      "Which docs should Delfini track? Enter one or more paths \u2014 directories (recursive .md scan), files, or globs, space- or comma-separated (e.g. `docs/ specs/architecture.md packages/*/README.md`). Leave blank to skip: "
+    );
+    return parseScopeInput(answer);
+  } finally {
+    rl.close();
+  }
+}
+async function persistDocScope(repoRoot, logger, target, paths) {
+  try {
+    await writeDocScope(paths, { repoRoot });
+    log(logger, `doc-scope.json \u2192 ${target} (wrote ${paths.length} path(s))`);
+  } catch (err) {
+    if (err instanceof DocScopeValidationError) {
+      log(
+        logger,
+        `doc-scope.json \u2192 ${target} (skipped \u2014 ${err.message}). Fix the path(s) and re-run \`delfini install\`, edit the file directly, or set the scope on the first /delfini run.`
+      );
+      return;
+    }
+    throw err;
+  }
+}
 function parseYesNo(answer) {
   const normalised = answer.trim().toLowerCase();
   return normalised === "y" || normalised === "yes";
@@ -403,8 +661,8 @@ function log(logger, message) {
 
 // src/commands/local-finalize.ts
 init_esm_shims();
-import { promises as fs } from "fs";
-import path from "path";
+import { promises as fs2 } from "fs";
+import path2 from "path";
 var TRACE_DIR_RELATIVE = ".delfini-trace";
 var ANALYSIS_INPUT_FILENAME = "analysis-input.json";
 var REPORT_FILENAME = "report.md";
@@ -425,10 +683,10 @@ async function runLocalFinalize(options) {
   const stderr = options.stderr ?? process.stderr;
   const stdout = options.stdout ?? process.stdout;
   const repoRoot = options.repoRoot ?? await getRepoRoot();
-  const findingsPath = path.isAbsolute(options.findingsPath) ? options.findingsPath : path.join(repoRoot, options.findingsPath);
+  const findingsPath = path2.isAbsolute(options.findingsPath) ? options.findingsPath : path2.join(repoRoot, options.findingsPath);
   let findingsContent;
   try {
-    findingsContent = await fs.readFile(findingsPath, "utf8");
+    findingsContent = await fs2.readFile(findingsPath, "utf8");
   } catch (err) {
     return emitSchemaValidationError(stderr, [
       {
@@ -448,10 +706,10 @@ async function runLocalFinalize(options) {
       }
     ]);
   }
-  const analysisInputPath = path.join(repoRoot, TRACE_DIR_RELATIVE, ANALYSIS_INPUT_FILENAME);
+  const analysisInputPath = path2.join(repoRoot, TRACE_DIR_RELATIVE, ANALYSIS_INPUT_FILENAME);
   let docs;
   try {
-    const raw = await fs.readFile(analysisInputPath, "utf8");
+    const raw = await fs2.readFile(analysisInputPath, "utf8");
     const parsed = JSON.parse(raw);
     if (!Array.isArray(parsed.docs)) {
       return emitSchemaValidationError(stderr, [
@@ -666,201 +924,6 @@ import path3 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { promisify } from "util";
 import simpleGit3 from "simple-git";
-
-// src/doc-scope.ts
-init_esm_shims();
-import { promises as fs2 } from "fs";
-import path2 from "path";
-import { glob } from "tinyglobby";
-var DOC_SCOPE_RELATIVE_PATH = ".claude/skills/delfini/doc-scope.json";
-var DOC_SCOPE_VERSION = 1;
-var DOC_SCOPE_VERSION_MISMATCH_MESSAGE = "your doc-scope.json is for a newer @delfini/cli; please upgrade.";
-var REPO_ROOT_REL = ".";
-var DocScopeVersionMismatchError = class extends Error {
-  code = "DOC_SCOPE_VERSION_MISMATCH";
-  constructor(message = DOC_SCOPE_VERSION_MISMATCH_MESSAGE) {
-    super(message);
-    this.name = "DocScopeVersionMismatchError";
-  }
-};
-var DocScopeCorruptError = class extends Error {
-  code = "DOC_SCOPE_CORRUPT";
-  constructor(message) {
-    super(message);
-    this.name = "DocScopeCorruptError";
-  }
-};
-var DocScopeValidationError = class extends Error {
-  code = "DOC_SCOPE_VALIDATION";
-  constructor(message) {
-    super(message);
-    this.name = "DocScopeValidationError";
-  }
-};
-var docScopeSchemaV1 = external_exports.object({
-  version: external_exports.literal(1),
-  doc_scope: external_exports.array(external_exports.string().min(1))
-});
-var versionProbeSchema = external_exports.object({
-  version: external_exports.number().int().positive()
-});
-async function readDocScope(repoRoot) {
-  const root = repoRoot ?? await getRepoRoot();
-  const target = path2.join(root, DOC_SCOPE_RELATIVE_PATH);
-  let raw;
-  try {
-    raw = await fs2.readFile(target, "utf8");
-  } catch (err) {
-    if (isNoEntError(err)) return null;
-    throw err;
-  }
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch (err) {
-    throw new DocScopeCorruptError(
-      `${DOC_SCOPE_RELATIVE_PATH} is malformed: ${err.message}`
-    );
-  }
-  const probe = versionProbeSchema.safeParse(parsed);
-  if (probe.success && probe.data.version > DOC_SCOPE_VERSION) {
-    throw new DocScopeVersionMismatchError();
-  }
-  const result = docScopeSchemaV1.safeParse(parsed);
-  if (!result.success) {
-    throw new DocScopeCorruptError(
-      `${DOC_SCOPE_RELATIVE_PATH} is malformed: ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`
-    );
-  }
-  return result.data;
-}
-async function writeDocScope(paths, options) {
-  const root = options?.repoRoot ?? await getRepoRoot();
-  if (!Array.isArray(paths) || paths.length === 0) {
-    throw new DocScopeValidationError("at least one path is required");
-  }
-  const errors = [];
-  for (const entry of paths) {
-    const err = validateDocScopeEntry(entry, REPO_ROOT_REL);
-    if (err !== null) errors.push(err);
-  }
-  if (errors.length > 0) {
-    throw new DocScopeValidationError(
-      `${DOC_SCOPE_RELATIVE_PATH}: invalid path(s):
-${errors.map((e) => `  - ${e}`).join("\n")}`
-    );
-  }
-  const normalised = normalizeDocScope(paths);
-  if (normalised.length === 0) {
-    throw new DocScopeValidationError(
-      `${DOC_SCOPE_RELATIVE_PATH}: every entry collapses to an empty scope after normalisation (e.g. '.', './', 'docs/..') \u2014 provide at least one concrete path`
-    );
-  }
-  const target = path2.join(root, DOC_SCOPE_RELATIVE_PATH);
-  await fs2.mkdir(path2.dirname(target), { recursive: true });
-  const payload = { version: DOC_SCOPE_VERSION, doc_scope: normalised };
-  const json = `${JSON.stringify(payload, null, 2)}
-`;
-  await fs2.writeFile(target, json, "utf8");
-}
-async function docScopeExists(repoRoot) {
-  const root = repoRoot ?? await getRepoRoot();
-  const target = path2.join(root, DOC_SCOPE_RELATIVE_PATH);
-  try {
-    const st = await fs2.stat(target);
-    return st.isFile();
-  } catch {
-    return false;
-  }
-}
-async function deleteDocScope(repoRoot) {
-  const root = repoRoot ?? await getRepoRoot();
-  const target = path2.join(root, DOC_SCOPE_RELATIVE_PATH);
-  try {
-    await fs2.unlink(target);
-  } catch (err) {
-    if (!isNoEntError(err)) throw err;
-  }
-}
-async function expandDocScope(paths, repoRoot) {
-  const root = repoRoot ?? await getRepoRoot();
-  const normalisedRoot = path2.resolve(root);
-  const found = /* @__PURE__ */ new Set();
-  const missing = [];
-  for (const rawEntry of paths) {
-    if (typeof rawEntry !== "string") continue;
-    const normalised = normalizeDocScope([rawEntry]);
-    if (normalised.length === 0) {
-      if (rawEntry.trim().length > 0) missing.push(rawEntry);
-      continue;
-    }
-    const entry = normalised[0];
-    if (validateDocScopeEntry(entry, REPO_ROOT_REL) !== null) {
-      missing.push(rawEntry);
-      continue;
-    }
-    if (classifyEntry(entry) === "glob") {
-      const matches = await glob(entry, {
-        cwd: root,
-        absolute: true,
-        onlyFiles: true,
-        dot: false,
-        // Case-folding parity with the engine predicate (`nocase: true`).
-        caseSensitiveMatch: false,
-        // Migrating from fast-glob — disable tinyglobby's directory-pattern
-        // auto-expansion so a glob like `packages/*/README.md` keeps exact
-        // fast-glob semantics.
-        expandDirectories: false
-      });
-      const inRoot = matches.filter((m) => isInsideRoot(m, normalisedRoot));
-      if (inRoot.length === 0) {
-        missing.push(rawEntry);
-      } else {
-        for (const m of inRoot) found.add(m);
-      }
-      continue;
-    }
-    const absolute = path2.resolve(root, entry);
-    let stat;
-    try {
-      stat = await fs2.stat(absolute);
-    } catch (err) {
-      if (isNoEntError(err)) {
-        missing.push(rawEntry);
-        continue;
-      }
-      throw err;
-    }
-    if (stat.isDirectory()) {
-      const children = await glob("**/*.md", {
-        cwd: absolute,
-        absolute: true,
-        onlyFiles: true,
-        caseSensitiveMatch: false,
-        dot: false,
-        expandDirectories: false
-      });
-      for (const c of children) {
-        if (isInsideRoot(c, normalisedRoot)) found.add(c);
-      }
-    } else if (stat.isFile()) {
-      if (isInsideRoot(absolute, normalisedRoot)) found.add(absolute);
-    } else {
-      missing.push(rawEntry);
-    }
-  }
-  const files = Array.from(found).sort();
-  return { files, missingPaths: missing };
-}
-function isNoEntError(err) {
-  return typeof err === "object" && err !== null && err.code === "ENOENT";
-}
-function isInsideRoot(absolute, normalisedRoot) {
-  const resolved = path2.resolve(absolute);
-  return resolved === normalisedRoot || resolved.startsWith(normalisedRoot + path2.sep);
-}
-
-// src/commands/local-prepare.ts
 var execFileAsync = promisify(execFile);
 var UNTRACKED_DIFF_MAX_BUFFER = 64 * 1024 * 1024;
 var PROMPT_TOKEN_BUDGET = 15e4;
@@ -1188,10 +1251,16 @@ async function main(argv) {
   });
   program.command("install <path>").description(
     "Scaffold .claude/skills/delfini/SKILL.md + CLAUDE.md auto-invoke + .gitignore append"
-  ).option("--tool <agent>", "Coding agent target (only 'CLAUDE' supported in V1)", "CLAUDE").option("--auto-invoke", "append the CLAUDE.md auto-invoke block without prompting").option("--no-auto-invoke", "strip the CLAUDE.md auto-invoke block without prompting").action(async (targetPath, opts) => {
-    const confirmAutoInvoke = opts.autoInvoke === void 0 ? void 0 : () => Promise.resolve(opts.autoInvoke);
-    await runInstall(targetPath, { tool: opts.tool, confirmAutoInvoke });
-  });
+  ).option("--tool <agent>", "Coding agent target (only 'CLAUDE' supported in V1)", "CLAUDE").option("--auto-invoke", "append the CLAUDE.md auto-invoke block without prompting").option("--no-auto-invoke", "strip the CLAUDE.md auto-invoke block without prompting").option(
+    "--scope <paths>",
+    "Seed doc-scope.json with these paths (space- or comma-separated; overwrites any existing scope) without prompting. Omit to be prompted interactively on a TTY."
+  ).action(
+    async (targetPath, opts) => {
+      const confirmAutoInvoke = opts.autoInvoke === void 0 ? void 0 : () => Promise.resolve(opts.autoInvoke);
+      const provideDocScope = opts.scope === void 0 ? void 0 : () => Promise.resolve(parseScopeInput(opts.scope));
+      await runInstall(targetPath, { tool: opts.tool, confirmAutoInvoke, provideDocScope });
+    }
+  );
   program.command("local-prepare").description(
     "Compute diff + doc-scope + prompt + token-budget gate; write .delfini-trace/"
   ).option("--scope <paths>", "Comma-separated doc-scope paths (overrides doc-scope.json)").option("--base <ref>", "Diff base ref (default: git merge-base HEAD origin/main)").option(
@@ -1265,13 +1334,6 @@ export {
   RepoRootNotFoundError,
   getRepoRoot,
   runDiffStatus,
-  ensureTraceDir,
-  appendToGitignore,
-  writeTraceFile,
-  writeRetryAttemptFile,
-  InstallToolNotSupportedError,
-  runInstall,
-  runLocalFinalize,
   DOC_SCOPE_RELATIVE_PATH,
   DOC_SCOPE_VERSION,
   DocScopeVersionMismatchError,
@@ -1282,6 +1344,13 @@ export {
   docScopeExists,
   deleteDocScope,
   expandDocScope,
+  ensureTraceDir,
+  appendToGitignore,
+  writeTraceFile,
+  writeRetryAttemptFile,
+  InstallToolNotSupportedError,
+  runInstall,
+  runLocalFinalize,
   PROMPT_TOKEN_BUDGET,
   runLocalPrepare,
   main

package/dist/{chunk-MUW24ZC4.js → chunk-LJKEHO6F.js}

@@ -31,11 +31,11 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-// ../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.9_tsx@4.21.0_typescript@5.9.3/node_modules/tsup/assets/esm_shims.js
+// ../../node_modules/.pnpm/tsup@8.5.1_postcss@8.5.15_tsx@4.22.4_typescript@5.9.3/node_modules/tsup/assets/esm_shims.js
 import path from "path";
 import { fileURLToPath } from "url";
 var init_esm_shims = __esm({
-  "../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.9_tsx@4.21.0_typescript@5.9.3/node_modules/tsup/assets/esm_shims.js"() {
+  "../../node_modules/.pnpm/tsup@8.5.1_postcss@8.5.15_tsx@4.22.4_typescript@5.9.3/node_modules/tsup/assets/esm_shims.js"() {
     "use strict";
   }
 });