@coresource/hz 0.1.9 → 0.20.0

package/dist/hz.mjs

@@ -552,9 +552,11 @@ function normalizeMissionSummary(value) {
   return {
     completedFeatures: asFiniteNumber(value.completedFeatures),
     createdAt: asNonEmptyString(value.createdAt),
+    description: asNonEmptyString(value.description) ?? asNonEmptyString(value.taskDescription),
     missionId,
     passedAssertions: asFiniteNumber(value.passedAssertions),
     state: asNonEmptyString(value.state) ?? "unknown",
+    taskDescription: asNonEmptyString(value.taskDescription) ?? asNonEmptyString(value.description),
     totalAssertions: asFiniteNumber(value.totalAssertions),
     totalFeatures: asFiniteNumber(value.totalFeatures)
   };
@@ -579,6 +581,7 @@ function normalizeMissionState(value) {
     sandboxMinutesUsed: asNullableNumber(value.sandboxMinutesUsed),
     sealedMilestones: asFiniteNumber(value.sealedMilestones),
     state: asNonEmptyString(value.state) ?? "unknown",
+    taskDescription: asNonEmptyString(value.taskDescription),
     totalAssertions: asFiniteNumber(value.totalAssertions),
     totalFeatures: asFiniteNumber(value.totalFeatures),
     totalMilestones: asFiniteNumber(value.totalMilestones),
@@ -685,6 +688,27 @@ function formatPercent(part, total) {
   }
   return `${(part / total * 100).toFixed(1)}%`;
 }
+function truncateText(value, limit) {
+  if (value.length <= limit) {
+    return value;
+  }
+  return `${value.slice(0, Math.max(0, limit - 1)).trimEnd()}\u2026`;
+}
+function summarizeMissionDescription(value, limit = 72) {
+  if (!value) {
+    return "\u2014";
+  }
+  const taskSectionMatch = value.match(
+    /(?:^|\n)##\s*Task\s*\n+([\s\S]*?)(?:\n\s*\n|\n##\s|$)/i
+  );
+  const source = taskSectionMatch?.[1] ?? value;
+  const lines = source.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0);
+  const candidate = lines.find((line) => !line.startsWith("#") && !/^[-*]\s/.test(line)) ?? lines[0];
+  if (!candidate) {
+    return "\u2014";
+  }
+  return truncateText(candidate.replace(/\s+/g, " "), limit);
+}
 function plainCell(value) {
   return {
     display: value,
@@ -787,21 +811,42 @@ function registerMissionInfoCommand(mission, context, dependencies = {}) {
 }
 
 // src/commands/mission-list.ts
+async function resolveMissionDescription(apiClient, missionSummary) {
+  if (missionSummary.taskDescription || missionSummary.description) {
+    return missionSummary.taskDescription ?? missionSummary.description;
+  }
+  try {
+    const missionState = normalizeMissionState(
+      await apiClient.request({
+        path: `/missions/${missionSummary.missionId}/mission/state`
+      })
+    );
+    return missionState.taskDescription;
+  } catch {
+    return null;
+  }
+}
 function registerMissionListCommand(mission, context, dependencies = {}) {
   mission.command("list").description("List recent missions").action(async (_options, command) => {
     const apiClient = await createMissionApiClient(context, command, dependencies);
-    const missions = normalizeMissionSummaries(
+    const missionSummaries = normalizeMissionSummaries(
       await apiClient.request({
         path: "/missions"
       })
     );
-    if (missions.length === 0) {
+    if (missionSummaries.length === 0) {
       writeLine(context.stdout, "No missions found");
       return;
     }
+    const missions = await Promise.all(
+      missionSummaries.map(async (missionSummary) => ({
+        ...missionSummary,
+        description: await resolveMissionDescription(apiClient, missionSummary)
+      }))
+    );
     renderTable(
       context.stdout,
-      ["Mission ID", "State", "Created", "Features", "Assertions"],
+      ["Mission ID", "State", "Created", "Features", "Assertions", "Description"],
       missions.map((missionSummary) => [
         plainCell(missionSummary.missionId),
         coloredCell(
@@ -814,7 +859,8 @@ function registerMissionListCommand(mission, context, dependencies = {}) {
         ),
         plainCell(
           `${missionSummary.passedAssertions}/${missionSummary.totalAssertions}`
-        )
+        ),
+        plainCell(summarizeMissionDescription(missionSummary.description))
       ])
     );
   });
@@ -2149,17 +2195,9 @@ function defaultCreateWebSocket(url, options) {
   return new WebSocket(url, { headers: options.headers });
 }
 function defaultRegisterSignalHandler(signal, handler) {
-  let fired = false;
-  const wrapper = () => {
-    if (fired) {
-      process.exit(130);
-    }
-    fired = true;
-    handler();
-  };
-  process.on(signal, wrapper);
+  process.once(signal, handler);
   return () => {
-    process.off(signal, wrapper);
+    process.off(signal, handler);
   };
 }
 function createMissionWebSocketUrl(endpoint, missionId) {
@@ -2898,6 +2936,17 @@ function resolveResumeExitCode(state) {
       return null;
   }
 }
+function resolveWatchExitCode(state) {
+  switch (state) {
+    case "cancelled":
+    case "completed":
+      return 0;
+    case "failed":
+      return 1;
+    default:
+      return null;
+  }
+}
 async function runMissionResume(missionIdValue, command, context, dependencies) {
   const homeDir = resolveLifecycleHomeDir(context);
   const missionId = await resolveMissionId(missionIdValue, context, command, homeDir);
@@ -2969,6 +3018,48 @@ async function runMissionResume(missionIdValue, command, context, dependencies)
     throw new CommanderError(monitorResult.exitCode, "mission-monitor", "");
   }
 }
+async function runMissionWatch(missionIdValue, command, context, dependencies) {
+  const homeDir = resolveLifecycleHomeDir(context);
+  const missionId = await resolveMissionId(missionIdValue, context, command, homeDir);
+  const { apiClient, authConfig } = await createMissionClientContext(
+    context,
+    command,
+    dependencies,
+    homeDir
+  );
+  const snapshot = await fetchMissionSnapshot(apiClient, missionId);
+  writeLine(
+    context.stdout,
+    `Watching mission ${pc5.cyan(missionId)} from state ${pc5.bold(snapshot.state.state)}.`
+  );
+  renderMissionSnapshot(context.stdout, snapshot);
+  const watchExitCode = resolveWatchExitCode(snapshot.state.state);
+  if (watchExitCode === 0) {
+    return;
+  }
+  if (watchExitCode === 1) {
+    throw new CliError(
+      `Mission ${missionId} is currently ${snapshot.state.state}.`,
+      1
+    );
+  }
+  const monitorResult = await monitorMission({
+    apiClient,
+    apiKey: authConfig.apiKey,
+    createSpinner: dependencies.createSpinner,
+    createWebSocket: dependencies.createWebSocket,
+    endpoint: authConfig.endpoint,
+    missionId,
+    promptInput: dependencies.promptInput,
+    promptSelect: dependencies.promptSelect,
+    registerSignalHandler: dependencies.registerSignalHandler,
+    sleep: dependencies.sleep,
+    stdout: context.stdout
+  });
+  if (monitorResult.exitCode !== 0) {
+    throw new CommanderError(monitorResult.exitCode, "mission-monitor", "");
+  }
+}
 function registerMissionLifecycleCommands(mission, context, dependencies = {}) {
   mission.command("pause").description("Pause a mission").argument("[missionId]").action(async (missionId, _options, command) => {
     await runLifecycleMutation(
@@ -2982,6 +3073,9 @@ function registerMissionLifecycleCommands(mission, context, dependencies = {}) {
   mission.command("resume").description("Resume a mission").argument("[missionId]").action(async (missionId, _options, command) => {
     await runMissionResume(missionId, command, context, dependencies);
   });
+  mission.command("watch").description("Watch a mission's live progress").argument("[missionId]").action(async (missionId, _options, command) => {
+    await runMissionWatch(missionId, command, context, dependencies);
+  });
   mission.command("cancel").description("Cancel a mission").argument("[missionId]").action(async (missionId, _options, command) => {
     await runLifecycleMutation(
       "cancel",
@@ -2991,41 +3085,15 @@ function registerMissionLifecycleCommands(mission, context, dependencies = {}) {
       dependencies
     );
   });
-  mission.command("watch").description("Watch a mission's live progress").argument("[missionId]").option("--yes", "Automatically approve all triage prompts").action(async (missionId, options, command) => {
-    const homeDir = resolveLifecycleHomeDir(context);
-    const resolved = await resolveMissionId(missionId, context, command, homeDir);
-    const { apiClient, authConfig } = await createMissionClientContext(
-      context,
-      command,
-      dependencies,
-      homeDir
-    );
-    const monitorResult = await monitorMission({
-      apiClient,
-      apiKey: authConfig.apiKey,
-      autoApprove: options.yes === true,
-      createSpinner: dependencies.createSpinner,
-      createWebSocket: dependencies.createWebSocket,
-      endpoint: authConfig.endpoint,
-      missionId: resolved,
-      promptInput: dependencies.promptInput,
-      promptSelect: dependencies.promptSelect,
-      registerSignalHandler: dependencies.registerSignalHandler,
-      sleep: dependencies.sleep,
-      stdout: context.stdout
-    });
-    if (monitorResult.exitCode !== 0) {
-      throw new CommanderError(monitorResult.exitCode, "mission-monitor", "");
-    }
-  });
 }
 
 // src/commands/mission-run.ts
 import { stat as stat3 } from "fs/promises";
-import path6 from "path";
+import path7 from "path";
 import { CommanderError as CommanderError2 } from "commander";
 
 // src/planning.ts
+import path4 from "path";
 import {
   confirm as defaultConfirmPrompt,
   input as defaultInputPrompt2,
@@ -3233,25 +3301,85 @@ function renderFailures(stdout, failures) {
     writeLine(stdout, `- ${failure}`);
   });
 }
-async function promptForAnswers(options, questions, round) {
-  if (options.autoApprove) {
-    return {
-      answers: [],
-      transcript: []
-    };
+function tokenizeText(value) {
+  return value.toLowerCase().split(/[^a-z0-9]+/i).filter((token) => token.length > 1);
+}
+function summarizeRepoNames(repoPaths) {
+  return repoPaths.map((repoPath) => {
+    const repoName = path4.basename(repoPath);
+    return repoName.length > 0 ? repoName : repoPath;
+  });
+}
+function pickAutoApprovedOption(question, taskDescription, repoPaths) {
+  if (!question.options || question.options.length === 0) {
+    return null;
   }
+  const repoNames = summarizeRepoNames(repoPaths);
+  const references = (question.references ?? []).map((reference) => path4.basename(reference));
+  const contextTokens = /* @__PURE__ */ new Set([
+    ...tokenizeText(question.text),
+    ...tokenizeText(taskDescription),
+    ...repoNames.flatMap((repoName) => tokenizeText(repoName)),
+    ...references.flatMap((reference) => tokenizeText(reference))
+  ]);
+  let bestOption = question.options[0] ?? null;
+  let bestScore = Number.NEGATIVE_INFINITY;
+  for (const option of question.options) {
+    const label = `${option.label} ${option.description ?? ""} ${option.id}`.trim();
+    const optionTokens = tokenizeText(label);
+    let score = 0;
+    for (const token of optionTokens) {
+      if (contextTokens.has(token)) {
+        score += 3;
+      }
+      if (/continue|approve|yes|confirm|accept|keep|use|primary/.test(token)) {
+        score += 1;
+      }
+    }
+    if (score > bestScore) {
+      bestScore = score;
+      bestOption = option;
+    }
+  }
+  return bestOption;
+}
+function buildAutoApprovedDetail(question, taskDescription, repoPaths) {
+  if (question.inputDefault && question.inputDefault.trim().length > 0) {
+    return question.inputDefault.trim();
+  }
+  const repoNames = summarizeRepoNames(repoPaths);
+  const repoPhrase = repoNames.length === 1 ? `the \`${repoNames[0]}\` repository` : `the repositories ${repoNames.map((repoName) => `\`${repoName}\``).join(", ")}`;
+  const references = question.references && question.references.length > 0 ? ` Ground the answer in ${question.references.join(", ")}.` : "";
+  const questionText = question.text.toLowerCase();
+  const task = taskDescription.trim().replace(/\s+/g, " ");
+  if (/validation|test|package\.json/.test(questionText)) {
+    return `Validate the change in ${repoPhrase} with the referenced tests and package scripts, then run the relevant tests, typecheck, and build checks.${references}`;
+  }
+  if (/repo surface|repo path|scope|primary repo/.test(questionText)) {
+    return `Focus on ${repoPhrase} as the primary implementation surface for: ${task}.${references}`;
+  }
+  if (/debug info|api connection|endpoint|response status|http method|verbose/.test(questionText)) {
+    return `Implement ${task} so verbose mode shows safe API-connection diagnostics such as the configured endpoint, HTTP method, and response status without exposing secrets.${references}`;
+  }
+  if (/req-func|flag|command/.test(questionText) || /--[a-z0-9-]+/.test(task)) {
+    return `Implement ${task} in ${repoPhrase}, preserving the default output unless the requested flag or option is present.${references}`;
+  }
+  return `${task}. Use ${repoPhrase} as the source of truth.${references}`;
+}
+async function promptForAnswers(options, questions, round) {
   const promptSelect = options.promptSelect ?? defaultPromptSelect2;
   const promptInput = options.promptInput ?? defaultPromptInput2;
   const answers = [];
   const transcript = [];
   for (const question of questions) {
     if (question.options && question.options.length > 0) {
+      const autoSelectedOption = options.autoApprove ? pickAutoApprovedOption(question, options.taskDescription, options.repoPaths) : null;
       const choices = question.options.map((option) => ({
         description: option.description,
         name: option.label,
         value: option.id
       }));
-      const optionId2 = await promptSelect({
+      const optionId2 = autoSelectedOption?.id ?? await promptSelect({
         choices,
         message: question.text
       });
@@ -3270,7 +3398,7 @@ async function promptForAnswers(options, questions, round) {
       });
       continue;
     }
-    const detail = await promptInput({
+    const detail = options.autoApprove ? buildAutoApprovedDetail(question, options.taskDescription, options.repoPaths) : await promptInput({
       default: question.inputDefault,
       message: question.detailPrompt ?? question.text
     });
@@ -3519,7 +3647,7 @@ async function runPlanningFlow(options) {
 // src/upload.ts
 import { confirm } from "@inquirer/prompts";
 import { createReadStream as createReadStream2 } from "fs";
-import path5 from "path";
+import path6 from "path";
 import { Transform as Transform2 } from "stream";
 import ora3 from "ora";
 import pc7 from "picocolors";
@@ -3537,7 +3665,7 @@ import {
   rm as rm3,
   stat as stat2
 } from "fs/promises";
-import path4 from "path";
+import path5 from "path";
 import { createInterface } from "readline";
 import { Transform } from "stream";
 import { pipeline } from "stream/promises";
@@ -3561,7 +3689,7 @@ var SECRET_PATTERNS = [
   {
     kind: "stripe_live_key",
     message: "Found a Stripe live secret key.",
-    regex: /sk_live_[A-Za-z0-9]+/g
+    regex: /sk_live_[A-Za-z0-9]{16,}/g
   },
   {
     kind: "aws_access_key",
@@ -3571,7 +3699,7 @@ var SECRET_PATTERNS = [
   {
     kind: "github_personal_access_token",
     message: "Found a GitHub personal access token.",
-    regex: /ghp_[A-Za-z0-9]+/g
+    regex: /ghp_[A-Za-z0-9]{36,}/g
   },
   {
     kind: "private_key",
@@ -3608,7 +3736,7 @@ function compareStrings(left, right) {
   return left < right ? -1 : 1;
 }
 function toPosixPath(filePath) {
-  return filePath.split(path4.sep).join(path4.posix.sep);
+  return filePath.split(path5.sep).join(path5.posix.sep);
 }
 function splitNullTerminatedBuffer(buffer) {
   return buffer.toString("utf8").split("\0").filter((entry) => entry.length > 0);
@@ -3640,7 +3768,7 @@ async function ensureDirectory2(dirPath) {
 }
 async function validateDirectoryPath(repoPath, options) {
   const cwd = options.cwd ?? process.cwd();
-  const absolutePath = path4.resolve(cwd, repoPath);
+  const absolutePath = path5.resolve(cwd, repoPath);
   let directoryStats;
   try {
     directoryStats = await stat2(absolutePath);
@@ -3671,7 +3799,7 @@ async function resolveRepositoryInputs(repoPaths, options) {
   );
   const counts = /* @__PURE__ */ new Map();
   const baseNames = absolutePaths.map(
-    (absolutePath) => sanitizeIdentifier(path4.basename(absolutePath))
+    (absolutePath) => sanitizeIdentifier(path5.basename(absolutePath))
   );
   for (const baseName of baseNames) {
     counts.set(baseName, (counts.get(baseName) ?? 0) + 1);
@@ -3719,7 +3847,7 @@ function matchSecretPatterns(line, relativePath, lineNumber) {
 }
 async function scanRegularFileForSecrets(filePath, relativePath) {
   const findings = [];
-  const basename = path4.posix.basename(relativePath);
+  const basename = path5.posix.basename(relativePath);
   if (basename.startsWith(".env")) {
     findings.push({
       kind: "env_file",
@@ -3741,7 +3869,7 @@ async function scanRegularFileForSecrets(filePath, relativePath) {
   return findings;
 }
 async function classifyRepositoryEntry(repoPath, relativePath) {
-  const absolutePath = path4.join(repoPath, relativePath);
+  const absolutePath = path5.join(repoPath, relativePath);
   const entryStats = await lstat(absolutePath);
   if (entryStats.isDirectory()) {
     return null;
@@ -3770,8 +3898,8 @@ async function classifyRepositoryEntry(repoPath, relativePath) {
 }
 function shouldIgnoreNonGitEntry(relativePath, isDirectory) {
   const normalizedPath = toPosixPath(relativePath);
-  const basename = path4.posix.basename(normalizedPath);
-  const segments = normalizedPath.split(path4.posix.sep);
+  const basename = path5.posix.basename(normalizedPath);
+  const segments = normalizedPath.split(path5.posix.sep);
   if (segments.includes(GIT_DIR_NAME)) {
     return true;
   }
@@ -3781,13 +3909,13 @@ function shouldIgnoreNonGitEntry(relativePath, isDirectory) {
   return basename === ".DS_Store" || basename === ".env";
 }
 async function walkNonGitEntries(repoPath, currentRelativePath = "") {
-  const currentAbsolutePath = path4.join(repoPath, currentRelativePath);
+  const currentAbsolutePath = path5.join(repoPath, currentRelativePath);
   const dirEntries = await readdir3(currentAbsolutePath, { withFileTypes: true });
   const results = [];
   for (const dirEntry of dirEntries.sort(
     (left, right) => compareStrings(left.name, right.name)
   )) {
-    const relativePath = currentRelativePath ? path4.posix.join(currentRelativePath, dirEntry.name) : dirEntry.name;
+    const relativePath = currentRelativePath ? path5.posix.join(currentRelativePath, dirEntry.name) : dirEntry.name;
     if (shouldIgnoreNonGitEntry(relativePath, dirEntry.isDirectory())) {
       continue;
     }
@@ -3811,7 +3939,7 @@ async function pathExists(filePath) {
   }
 }
 async function isGitBackedRepository(repoPath) {
-  return pathExists(path4.join(repoPath, GIT_DIR_NAME));
+  return pathExists(path5.join(repoPath, GIT_DIR_NAME));
 }
 async function runGitCommand(repoPath, args, options = {}) {
   const encoding = options.encoding ?? "utf8";
@@ -3876,7 +4004,7 @@ async function discoverGitEntries(repoPath) {
   const candidateEntries = [.../* @__PURE__ */ new Set([...trackedEntries, ...untrackedEntries])].map((entry) => toPosixPath(entry)).filter((entry) => !entry.startsWith(".git/") && entry !== ".git");
   const relativePaths = [];
   for (const entry of candidateEntries.sort(compareStrings)) {
-    if (await pathExists(path4.join(repoPath, entry))) {
+    if (await pathExists(path5.join(repoPath, entry))) {
       relativePaths.push(entry);
     }
   }
@@ -3956,7 +4084,7 @@ async function analyzeRepository(input) {
 }
 async function writeDeterministicArchive(analysis, outputDir) {
   await ensureDirectory2(outputDir);
-  const finalArchivePath = path4.join(outputDir, `${analysis.input.repoId}.tar.zst`);
+  const finalArchivePath = path5.join(outputDir, `${analysis.input.repoId}.tar.zst`);
   const tempArchivePath = `${finalArchivePath}.${process.pid}.${Date.now()}.tmp`;
   const archiveHash = createHash2("sha256");
   let archiveBytes = 0;
@@ -4323,7 +4451,7 @@ async function runUploadPipeline(options) {
     repos = await snapshotRepositories({
       allowSecrets: options.allowSecrets === true,
       cwd: options.cwd,
-      outputDir: path5.join(launchSnapshot.paths.launchDir, "archives"),
+      outputDir: path6.join(launchSnapshot.paths.launchDir, "archives"),
       repoPaths: options.repoPaths
     });
   } catch (error) {
@@ -4333,7 +4461,7 @@ async function runUploadPipeline(options) {
     repos = await snapshotRepositories({
       allowSecrets: true,
       cwd: options.cwd,
-      outputDir: path5.join(launchSnapshot.paths.launchDir, "archives"),
+      outputDir: path6.join(launchSnapshot.paths.launchDir, "archives"),
       repoPaths: options.repoPaths
     });
     repos = repos.map((repo) => ({
@@ -4465,7 +4593,7 @@ async function resolveRepoPaths(repoValues, cwd = process.cwd()) {
   if (repoValues.length === 0) {
     throw new CliError("At least one `--repo` path is required.");
   }
-  const resolved = [...new Set(repoValues.map((repoPath) => path6.resolve(cwd, repoPath)))];
+  const resolved = [...new Set(repoValues.map((repoPath) => path7.resolve(cwd, repoPath)))];
   for (const repoPath of resolved) {
     let repoStats;
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coresource/hz",
-  "version": "0.1.9",
+  "version": "0.20.0",
   "type": "module",
   "bin": {
     "hz": "dist/hz.mjs"