@delfini/cli 0.1.2 → 0.2.1

package/dist/cli.js

@@ -1,7 +1,7 @@
 import {
   main
-} from "./chunk-IDYMVTTU.js";
-import "./chunk-MUW24ZC4.js";
+} from "./chunk-K5X5TSUR.js";
+import "./chunk-LJKEHO6F.js";
 export {
   main
 };

package/dist/index.cjs

@@ -33,10 +33,10 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), 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/cjs_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/cjs_shims.js
 var getImportMetaUrl, importMetaUrl;
 var init_cjs_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/cjs_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/cjs_shims.js"() {
     "use strict";
     getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
     importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
@@ -7402,9 +7402,74 @@ async function runInstall(targetPath, options) {
   const resolvedTarget = (0, import_node_path3.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 = (0, import_node_path3.join)(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 = (0, import_promises.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";
@@ -8110,10 +8175,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(

package/dist/index.d.cts

@@ -63,6 +63,18 @@ interface RunInstallOptions {
      * non-TTY stdin (never blocks, never forces opt-in without consent).
      */
     confirmAutoInvoke?: () => Promise<boolean>;
+    /**
+     * Resolves the doc-scope path list. When provided, `runInstall` uses it
+     * directly (the `--scope` CLI flag and the test seam) and never prompts —
+     * a non-empty list is persisted to `doc-scope.json` (overwriting any
+     * existing file, since an explicit `--scope` is intent-to-overwrite); an
+     * empty list is a no-op. When omitted, `runInstall` prompts interactively
+     * on a TTY only if no `doc-scope.json` exists yet; on a non-TTY stdin, or
+     * when a scope is already configured, it leaves `doc-scope.json` untouched.
+     * Invalid paths (rejected by `writeDocScope`) warn-and-skip — the scaffold
+     * always completes; the SKILL.md first-run prompt re-seeds the scope later.
+     */
+    provideDocScope?: () => Promise<string[]>;
 }
 declare class InstallToolNotSupportedError extends Error {
     readonly code: "INSTALL_TOOL_NOT_SUPPORTED";

package/dist/index.d.ts

@@ -63,6 +63,18 @@ interface RunInstallOptions {
      * non-TTY stdin (never blocks, never forces opt-in without consent).
      */
     confirmAutoInvoke?: () => Promise<boolean>;
+    /**
+     * Resolves the doc-scope path list. When provided, `runInstall` uses it
+     * directly (the `--scope` CLI flag and the test seam) and never prompts —
+     * a non-empty list is persisted to `doc-scope.json` (overwriting any
+     * existing file, since an explicit `--scope` is intent-to-overwrite); an
+     * empty list is a no-op. When omitted, `runInstall` prompts interactively
+     * on a TTY only if no `doc-scope.json` exists yet; on a non-TTY stdin, or
+     * when a scope is already configured, it leaves `doc-scope.json` untouched.
+     * Invalid paths (rejected by `writeDocScope`) warn-and-skip — the scaffold
+     * always completes; the SKILL.md first-run prompt re-seeds the scope later.
+     */
+    provideDocScope?: () => Promise<string[]>;
 }
 declare class InstallToolNotSupportedError extends Error {
     readonly code: "INSTALL_TOOL_NOT_SUPPORTED";

package/dist/index.js

@@ -22,10 +22,10 @@ import {
   writeDocScope,
   writeRetryAttemptFile,
   writeTraceFile
-} from "./chunk-IDYMVTTU.js";
+} from "./chunk-K5X5TSUR.js";
 import {
   init_esm_shims
-} from "./chunk-MUW24ZC4.js";
+} from "./chunk-LJKEHO6F.js";
 
 // src/index.ts
 init_esm_shims();

package/package.json

@@ -1,6 +1,12 @@
 {
   "name": "@delfini/cli",
-  "version": "0.1.2",
+  "version": "0.2.1",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Legends-of-Tech/delfini.git",
+    "directory": "packages/cli"
+  },
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -26,7 +32,7 @@
     "simple-git": "^3.27.0",
     "tinyglobby": "^0.2.16",
     "zod": "^3.24.0",
-    "@delfini/drift-engine": "0.2.0"
+    "@delfini/drift-engine": "0.2.1"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",