@c4a/context-cli 0.7.25 → 0.7.29

package/cli.js

@@ -76780,22 +76780,14 @@ var init_indexerSourceBoundary = __esm(() => {
 
 // src/project/indexerParserSourceMaterialization.ts
 import { execFile as execFile3 } from "node:child_process";
-import { lstat as lstat4, readFile as readFile18 } from "node:fs/promises";
+import { lstat as lstat4, readFile as readFile18, stat as stat6 } from "node:fs/promises";
 import { promisify as promisify3 } from "node:util";
 import { basename as basename4, extname as extname8, join as join17 } from "node:path";
 function sourceRefName(sourceRef) {
   return sourceRef.startsWith("repo:") ? sourceRef.slice("repo:".length) : null;
 }
 async function trackedPaths(root, ref2) {
-  try {
-    await execFileAsync2("git", ["diff", "--quiet", ref2, "--", "."], { cwd: root });
-  } catch (error) {
-    const exitCode = error !== null && typeof error === "object" && "code" in error ? error.code : null;
-    if (exitCode === 1) {
-      throw new TypeError(`materialized repository source differs from its pinned ref: ${root}`);
-    }
-    throw error;
-  }
+  await assertPinnedSource(root, ref2);
   const { stdout } = await execFileAsync2("git", ["ls-files", "-z", "--", "."], {
     cwd: root,
     encoding: "buffer",
@@ -76804,6 +76796,20 @@ async function trackedPaths(root, ref2) {
   return Buffer.from(stdout).toString("utf8").split("\x00").filter(Boolean).sort();
 }
 async function assertPinnedSource(root, ref2) {
+  const sourceStat = await stat6(root).catch((error) => {
+    if (error.code === "ENOENT" || error.code === "ENOTDIR")
+      return;
+    throw error;
+  });
+  if (!sourceStat?.isDirectory()) {
+    throw new ContextError(ExitCode.WorkspaceStateError, `Repository source directory is unavailable: ${root}. Inspect recovery with context source recovery-plan --format json.`, {
+      category: ErrorCategory.WorkspaceStateInvalid,
+      reason_code: "repository-source-directory-unavailable",
+      cwd: root,
+      next_action: { command: "context source recovery-plan --format json" },
+      input_schema: { type: "object", properties: {}, additionalProperties: false }
+    });
+  }
   try {
     await execFileAsync2("git", ["diff", "--quiet", ref2, "--", "."], { cwd: root });
   } catch (error) {
@@ -76811,6 +76817,15 @@ async function assertPinnedSource(root, ref2) {
     if (exitCode === 1) {
       throw new TypeError(`materialized repository source differs from its pinned ref: ${root}`);
     }
+    if (exitCode === "ENOENT") {
+      throw new ContextError(ExitCode.ExternalToolError, `Git could not start for repository source ${root}. Check git --version and the source directory in the same host environment.`, {
+        category: ErrorCategory.ExternalToolFailed,
+        reason_code: "repository-git-spawn-unavailable",
+        cwd: root,
+        next_action: { command: "git --version" },
+        input_schema: { type: "object", properties: {}, additionalProperties: false }
+      });
+    }
     throw error;
   }
 }
@@ -76874,6 +76889,9 @@ var init_indexerParserSourceMaterialization = __esm(() => {
   init_src2();
   init_indexerReadScopeAuthorization();
   init_indexerSourceBoundary();
+  init_errors3();
+  init_exitCode();
+  init_cliFeedback();
   execFileAsync2 = promisify3(execFile3);
 });
 
@@ -76882,7 +76900,7 @@ var exports_managedDocumentSnapshot = {};
 __export(exports_managedDocumentSnapshot, {
   readManagedDocumentSnapshot: () => readManagedDocumentSnapshot
 });
-import { readFile as readFile19, stat as stat6 } from "node:fs/promises";
+import { readFile as readFile19, stat as stat7 } from "node:fs/promises";
 import { basename as basename5, dirname as dirname15 } from "node:path";
 async function readManagedDocumentSnapshot(projectRoot, type, name2) {
   const absolutePath = await assertManagedDocumentPath(projectRoot, type, name2);
@@ -76891,7 +76909,7 @@ async function readManagedDocumentSnapshot(projectRoot, type, name2) {
   const manifest = createDocumentSnapshotManifest({
     sourceType: type,
     sourceName: name2,
-    capturedAt: (await stat6(absolutePath)).mtime.toISOString(),
+    capturedAt: (await stat7(absolutePath)).mtime.toISOString(),
     files: [{
       path: file,
       bytes: markdown,
@@ -79423,7 +79441,7 @@ __export(exports_productionStageStore, {
   PRODUCTION_STAGES_ROOT: () => PRODUCTION_STAGES_ROOT
 });
 import { constants as constants4 } from "node:fs";
-import { readFile as readFile28, access as access2, stat as stat7 } from "node:fs/promises";
+import { readFile as readFile28, access as access2, stat as stat8 } from "node:fs/promises";
 import { join as join31 } from "node:path";
 function productionStageDirectory(id3) {
   productionAgentDirectory(id3);
@@ -79442,7 +79460,7 @@ async function readOptional(root, path2) {
 async function hasReadableProjection(root, path2) {
   const absolute = await safeProjectTarget(root, path2);
   try {
-    if (!(await stat7(absolute)).isFile())
+    if (!(await stat8(absolute)).isFile())
       throw new TypeError(`Stage material must be a regular file: ${path2}`);
     await access2(absolute, constants4.R_OK);
     return true;
@@ -81693,19 +81711,19 @@ function failure(reason, message, next) {
 }
 async function entries(root, path2) {
   await safeProjectTarget(root, path2);
-  let stat8;
+  let stat9;
   try {
-    stat8 = await lstat7(join43(root, path2));
+    stat9 = await lstat7(join43(root, path2));
   } catch (error) {
     if (error.code === "ENOENT")
       return [];
     throw error;
   }
-  if (stat8.isSymbolicLink())
+  if (stat9.isSymbolicLink())
     failure("preparation-symlink", `Refusing to clean linked task state: ${path2}`, "Inspect and relocate the link without deleting its target, then preview again.");
-  if (stat8.isFile())
+  if (stat9.isFile())
     return [path2];
-  if (!stat8.isDirectory())
+  if (!stat9.isDirectory())
     failure("preparation-file-type", `Unsupported task-state file: ${path2}`, "Inspect this file before preparing the workspace.");
   const result = [];
   for (const name3 of (await readdir10(join43(root, path2))).sort())
@@ -86351,7 +86369,7 @@ var init_packageSiteExtensions = __esm(() => {
 // src/project/packageSite.ts
 import { createHash as createHash17 } from "node:crypto";
 import { spawn as spawn3 } from "node:child_process";
-import { mkdir as mkdir23, mkdtemp as mkdtemp2, readFile as readFile52, writeFile as writeFile19, rm as rm12, symlink as symlink2, cp, access as access5, stat as stat8 } from "node:fs/promises";
+import { mkdir as mkdir23, mkdtemp as mkdtemp2, readFile as readFile52, writeFile as writeFile19, rm as rm12, symlink as symlink2, cp, access as access5, stat as stat9 } from "node:fs/promises";
 import { createRequire as createRequire5 } from "node:module";
 import { dirname as dirname28, join as join64, posix as posix6 } from "node:path";
 function sitePagePath(identity) {
@@ -86675,7 +86693,7 @@ title: LLM Docs
       const placeholder = [".css", ".js", ".mjs", ".cjs"].includes(extension2) ? `/* Intentionally empty. */
 ` : [".html", ".htm"].includes(extension2) ? `<!-- Intentionally empty. -->
 ` : null;
-      if (placeholder !== null && (await stat8(file.absPath)).size === 0) {
+      if (placeholder !== null && (await stat9(file.absPath)).size === 0) {
         await writeFile19(file.absPath, placeholder);
       }
     }
@@ -89996,7 +90014,7 @@ var init_sourceInputMutation = __esm(() => {
 
 // src/project/documentCapture.ts
 import { createHash as createHash21 } from "node:crypto";
-import { mkdir as mkdir28, readdir as readdir18, readFile as readFile63, rm as rm17, stat as stat9, writeFile as writeFile23 } from "node:fs/promises";
+import { mkdir as mkdir28, readdir as readdir18, readFile as readFile63, rm as rm17, stat as stat10, writeFile as writeFile23 } from "node:fs/promises";
 import { basename as basename8, dirname as dirname34, extname as extname12, join as join75, relative as relative22, resolve as resolve24 } from "node:path";
 function toPosixPath7(path2) {
   return path2.split(/[\\/]+/u).filter((part) => part.length > 0).join("/");
@@ -90101,7 +90119,7 @@ function assignFlatSnapshotPaths(files, module) {
   });
 }
 async function walkMarkdownFiles(input) {
-  const rootStat = await stat9(input.localRoot);
+  const rootStat = await stat10(input.localRoot);
   if (rootStat.isFile()) {
     const sourcePath = normalizeSnapshotRelativePath(basename8(input.localRoot));
     return {
@@ -99938,15 +99956,15 @@ import { join as join100 } from "node:path";
 import { createHash as createHash30, randomUUID as randomUUID7 } from "node:crypto";
 async function inspectWriterLock(root2) {
   const path3 = await safeProjectTarget(root2, lockRelative);
-  let stat10;
+  let stat11;
   try {
-    stat10 = await lstat10(path3);
+    stat11 = await lstat10(path3);
   } catch (error) {
     if (error.code === "ENOENT")
       return null;
     throw error;
   }
-  if (!stat10.isDirectory() || stat10.isSymbolicLink())
+  if (!stat11.isDirectory() || stat11.isSymbolicLink())
     throw new Error("Writer lock must be a real directory.");
   const ownerPath = await safeProjectTarget(root2, `${lockRelative}/owner.json`);
   const bytes = await readFile82(ownerPath, "utf8");
@@ -99961,7 +99979,7 @@ async function inspectWriterLock(root2) {
     const code3 = error.code;
     processState = code3 === "ESRCH" ? "not-running" : code3 === "EPERM" ? "running" : "unknown";
   }
-  const digest6 = `sha256:${createHash30("sha256").update(`${stat10.dev}:${stat10.ino}:${stat10.birthtimeMs}:${bytes}`).digest("hex")}`;
+  const digest6 = `sha256:${createHash30("sha256").update(`${stat11.dev}:${stat11.ino}:${stat11.birthtimeMs}:${bytes}`).digest("hex")}`;
   return { ...owner, process_state: processState, digest: digest6, path: lockRelative };
 }
 async function recoverWriterLock(input) {
@@ -100033,22 +100051,22 @@ async function recoveryJournals(root2) {
   const entries2 = [];
   async function visit4(path3, depth) {
     await safeProjectTarget(root2, path3);
-    let stat10;
+    let stat11;
     try {
-      stat10 = await lstat11(join101(root2, path3));
+      stat11 = await lstat11(join101(root2, path3));
     } catch (error) {
       if (error.code === "ENOENT")
         return;
       throw error;
     }
-    if (stat10.isSymbolicLink())
+    if (stat11.isSymbolicLink())
       throw new TypeError("Recovery does not follow transaction symlinks.");
-    if (stat10.isDirectory()) {
+    if (stat11.isDirectory()) {
       if (depth > 3)
         throw new TypeError("Unexpected transaction directory depth; preserve it for diagnosis.");
       for (const name3 of (await readdir25(join101(root2, path3))).sort())
         await visit4(`${path3}/${name3}`, depth + 1);
-    } else if (stat10.isFile())
+    } else if (stat11.isFile())
       entries2.push({ path: path3, digest: indexerProtocolDigest(await recoveryText(root2, path3)) });
   }
   await visit4(TRANSACTIONS_PATH, 0);
@@ -112531,7 +112549,7 @@ function conflict(path3) {
     next: "Choose another --local directory, or move conflicting/customized skills aside before retrying."
   });
 }
-async function stat10(path3) {
+async function stat11(path3) {
   try {
     return await lstat14(path3);
   } catch (error) {
@@ -112541,7 +112559,7 @@ async function stat10(path3) {
   }
 }
 async function checkParents(path3) {
-  const entry = await stat10(path3);
+  const entry = await stat11(path3);
   if (entry && (!entry.isDirectory() || entry.isSymbolicLink()))
     conflict(path3);
   const parent = dirname46(path3);
@@ -112600,11 +112618,11 @@ ${frontmatter2[2].replace(/^disable-model-invocation:.*\r?\n?/mu, "")}${frontmat
       const target = join112(commandsRoot, entry.name);
       const marker = join112(commandsRoot, `.context-${entry.name}.json`);
       for (const file of [target, marker]) {
-        const existing = await stat10(file);
+        const existing = await stat11(file);
         if (existing && (!existing.isFile() || existing.isSymbolicLink()))
           conflict(file);
       }
-      if (await stat10(target)) {
+      if (await stat11(target)) {
         let previous3;
         try {
           previous3 = JSON.parse(await readFile94(marker, "utf8"));
@@ -112614,7 +112632,7 @@ ${frontmatter2[2].replace(/^disable-model-invocation:.*\r?\n?/mu, "")}${frontmat
         const current2 = createHash34("sha256").update(await readFile94(target)).digest("hex");
         if (previous3?.owner !== "context-plugin-local" || previous3.digest !== current2)
           conflict(target);
-      } else if (await stat10(marker))
+      } else if (await stat11(marker))
         conflict(marker);
       commandPlans.push({ name: entry.name, target, marker, content: content3, hash: createHash34("sha256").update(content3).digest("hex") });
     }
@@ -112623,21 +112641,21 @@ ${frontmatter2[2].replace(/^disable-model-invocation:.*\r?\n?/mu, "")}${frontmat
   }
   const plans = [];
   for (const entry of (await readdir29(sourceRoot2, { withFileTypes: true })).sort((a, b) => a.name.localeCompare(b.name))) {
-    if (!entry.isDirectory() || !await stat10(join112(sourceRoot2, entry.name, "SKILL.md")))
+    if (!entry.isDirectory() || !await stat11(join112(sourceRoot2, entry.name, "SKILL.md")))
       continue;
     const source2 = join112(sourceRoot2, entry.name);
     const target = join112(skillsRoot, entry.name);
     if (commandEntries.has(entry.name)) {
-      if (await stat10(target))
+      if (await stat11(target))
         conflict(`${target} (use a fresh host directory to avoid duplicate command/skill entries)`);
       continue;
     }
-    const existing = await stat10(target);
+    const existing = await stat11(target);
     if (existing) {
       if (!existing.isDirectory() || existing.isSymbolicLink())
         conflict(target);
       const markerPath = join112(target, MARKER);
-      if (!(await stat10(markerPath))?.isFile())
+      if (!(await stat11(markerPath))?.isFile())
         conflict(target);
       let marker;
       try {