safeword 0.46.2 → 0.48.0

package/dist/check-OFMUQD3Q.js

@@ -0,0 +1,112 @@
+import {
+  isNewerVersion
+} from "./chunk-FJYRWU2V.js";
+import {
+  checkHealth,
+  reportHealthSummary
+} from "./chunk-42IGUF5V.js";
+import {
+  syncTickets
+} from "./chunk-2HB6H4G5.js";
+import "./chunk-NHXVS5FL.js";
+import "./chunk-IGULTNHR.js";
+import "./chunk-QLXFPFIC.js";
+import "./chunk-4J3GYDJF.js";
+import "./chunk-54KAYQTY.js";
+import "./chunk-LODQOJEK.js";
+import "./chunk-HSC7TELY.js";
+import {
+  header,
+  info,
+  keyValue,
+  success,
+  warn
+} from "./chunk-445LAX4Y.js";
+
+// src/commands/check.ts
+import process from "process";
+async function checkLatestVersion(timeout = 3e3) {
+  try {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => {
+      controller.abort();
+    }, timeout);
+    const response = await fetch("https://registry.npmjs.org/safeword/latest", {
+      signal: controller.signal
+    });
+    clearTimeout(timeoutId);
+    if (!response.ok) return void 0;
+    const data = await response.json();
+    return data.version ?? void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function reportUpdateStatus(health) {
+  info("\nChecking for updates...");
+  const latestVersion = await checkLatestVersion();
+  if (!latestVersion) {
+    warn("Couldn't check for updates (offline?)");
+    return;
+  }
+  health.latestVersion = latestVersion;
+  health.updateAvailable = isNewerVersion(health.cliVersion, latestVersion);
+  if (health.updateAvailable) {
+    warn(`Update available: v${latestVersion}`);
+    info("Run `bunx safeword@latest upgrade` to upgrade");
+  } else {
+    success("CLI is up to date");
+  }
+}
+function reportVersionMismatch(health) {
+  if (!health.projectVersion) return;
+  if (isNewerVersion(health.cliVersion, health.projectVersion)) {
+    warn(`Project config (v${health.projectVersion}) is newer than CLI (v${health.cliVersion})`);
+    info("Consider upgrading the CLI");
+  } else if (isNewerVersion(health.projectVersion, health.cliVersion)) {
+    info(`
+Upgrade available for project config`);
+    info(
+      `Run \`safeword upgrade\` to update from v${health.projectVersion} to v${health.cliVersion}`
+    );
+  }
+}
+function regenerateTicketIndex(cwd) {
+  try {
+    const result = syncTickets(cwd);
+    if (result.wrote) {
+      info("Regenerated ticket index (INDEX.md / INDEX-completed.md)");
+    }
+  } catch (error) {
+    if (process.env.DEBUG) {
+      console.error("[check] ticket index regen failed:", error);
+    }
+    return;
+  }
+}
+async function check(options) {
+  const cwd = process.cwd();
+  header("Safeword Health Check");
+  const health = await checkHealth(cwd);
+  if (!health.configured) {
+    info("Not configured. Run `safeword setup` to initialize.");
+    return;
+  }
+  regenerateTicketIndex(cwd);
+  keyValue("Safeword CLI", `v${health.cliVersion}`);
+  keyValue("Project config", health.projectVersion ? `v${health.projectVersion}` : "unknown");
+  if (options.offline) {
+    info("\nSkipped update check (offline mode)");
+  } else {
+    await reportUpdateStatus(health);
+  }
+  reportVersionMismatch(health);
+  const hasIssues = reportHealthSummary(health);
+  if (hasIssues) {
+    process.exit(1);
+  }
+}
+export {
+  check
+};
+//# sourceMappingURL=check-OFMUQD3Q.js.map

package/dist/check-OFMUQD3Q.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/check.ts"],"sourcesContent":["/**\n * Check command - Verify project health and configuration\n *\n * The config-health core lives in ../health.ts (shared with the setup/upgrade\n * self-verify, ticket 3293WH). This command adds the standalone-only\n * surfaces: npm update-check, version display, and ticket-index refresh.\n */\n\nimport process from 'node:process';\n\nimport { checkHealth, type HealthStatus, reportHealthSummary } from '../health.js';\nimport { syncTickets } from '../ticket-sync/index.js';\nimport { header, info, keyValue, success, warn } from '../utils/output.js';\nimport { isNewerVersion } from '../utils/version.js';\n\ninterface CheckOptions {\n  offline?: boolean;\n}\n\n/**\n * Check for latest version from npm (with timeout)\n * @param timeout\n */\nasync function checkLatestVersion(timeout = 3000): Promise<string | undefined> {\n  try {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => {\n      controller.abort();\n    }, timeout);\n\n    const response = await fetch('https://registry.npmjs.org/safeword/latest', {\n      signal: controller.signal,\n    });\n\n    clearTimeout(timeoutId);\n\n    if (!response.ok) return undefined;\n\n    const data = (await response.json()) as { version?: string };\n    return data.version ?? undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Check for CLI updates and report status\n * @param health\n */\nasync function reportUpdateStatus(health: HealthStatus): Promise<void> {\n  info('\\nChecking for updates...');\n  const latestVersion = await checkLatestVersion();\n\n  if (!latestVersion) {\n    warn(\"Couldn't check for updates (offline?)\");\n    return;\n  }\n\n  health.latestVersion = latestVersion;\n  health.updateAvailable = isNewerVersion(health.cliVersion, latestVersion);\n\n  if (health.updateAvailable) {\n    warn(`Update available: v${latestVersion}`);\n    info('Run `bunx safeword@latest upgrade` to upgrade');\n  } else {\n    success('CLI is up to date');\n  }\n}\n\n/**\n * Compare project version vs CLI version and report\n * @param health\n */\nfunction reportVersionMismatch(health: HealthStatus): void {\n  if (!health.projectVersion) return;\n\n  if (isNewerVersion(health.cliVersion, health.projectVersion)) {\n    warn(`Project config (v${health.projectVersion}) is newer than CLI (v${health.cliVersion})`);\n    info('Consider upgrading the CLI');\n  } else if (isNewerVersion(health.projectVersion, health.cliVersion)) {\n    info(`\\nUpgrade available for project config`);\n    info(\n      `Run \\`safeword upgrade\\` to update from v${health.projectVersion} to v${health.cliVersion}`,\n    );\n  }\n}\n\n/**\n * Regenerate the ticket discovery index, swallowing any error — index\n * freshness must never block or fail a health check. Reports only when it\n * actually rewrote a file.\n * @param cwd\n */\nfunction regenerateTicketIndex(cwd: string): void {\n  try {\n    const result = syncTickets(cwd);\n    if (result.wrote) {\n      info('Regenerated ticket index (INDEX.md / INDEX-completed.md)');\n    }\n  } catch (error: unknown) {\n    // Best-effort: index freshness must never fail the health check. Surface\n    // under DEBUG, then return — the deliberate swallow point.\n    if (process.env.DEBUG) {\n      console.error('[check] ticket index regen failed:', error);\n    }\n    return;\n  }\n}\n\n/**\n *\n * @param options\n */\nexport async function check(options: CheckOptions): Promise<void> {\n  const cwd = process.cwd();\n\n  header('Safeword Health Check');\n\n  const health = await checkHealth(cwd);\n\n  // Not configured\n  if (!health.configured) {\n    info('Not configured. Run `safeword setup` to initialize.');\n    return;\n  }\n\n  // Keep the ticket discovery index fresh at this checkpoint (best-effort —\n  // never fail the health check on index regen). Ticket 1GGD28.\n  regenerateTicketIndex(cwd);\n\n  // Show versions\n  keyValue('Safeword CLI', `v${health.cliVersion}`);\n  keyValue('Project config', health.projectVersion ? `v${health.projectVersion}` : 'unknown');\n\n  // Check for updates (unless offline)\n  if (options.offline) {\n    info('\\nSkipped update check (offline mode)');\n  } else {\n    await reportUpdateStatus(health);\n  }\n\n  reportVersionMismatch(health);\n  const hasIssues = reportHealthSummary(health);\n\n  if (hasIssues) {\n    process.exit(1);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,OAAO,aAAa;AAepB,eAAe,mBAAmB,UAAU,KAAmC;AAC7E,MAAI;AACF,UAAM,aAAa,IAAI,gBAAgB;AACvC,UAAM,YAAY,WAAW,MAAM;AACjC,iBAAW,MAAM;AAAA,IACnB,GAAG,OAAO;AAEV,UAAM,WAAW,MAAM,MAAM,8CAA8C;AAAA,MACzE,QAAQ,WAAW;AAAA,IACrB,CAAC;AAED,iBAAa,SAAS;AAEtB,QAAI,CAAC,SAAS,GAAI,QAAO;AAEzB,UAAM,OAAQ,MAAM,SAAS,KAAK;AAClC,WAAO,KAAK,WAAW;AAAA,EACzB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAMA,eAAe,mBAAmB,QAAqC;AACrE,OAAK,2BAA2B;AAChC,QAAM,gBAAgB,MAAM,mBAAmB;AAE/C,MAAI,CAAC,eAAe;AAClB,SAAK,uCAAuC;AAC5C;AAAA,EACF;AAEA,SAAO,gBAAgB;AACvB,SAAO,kBAAkB,eAAe,OAAO,YAAY,aAAa;AAExE,MAAI,OAAO,iBAAiB;AAC1B,SAAK,sBAAsB,aAAa,EAAE;AAC1C,SAAK,+CAA+C;AAAA,EACtD,OAAO;AACL,YAAQ,mBAAmB;AAAA,EAC7B;AACF;AAMA,SAAS,sBAAsB,QAA4B;AACzD,MAAI,CAAC,OAAO,eAAgB;AAE5B,MAAI,eAAe,OAAO,YAAY,OAAO,cAAc,GAAG;AAC5D,SAAK,oBAAoB,OAAO,cAAc,yBAAyB,OAAO,UAAU,GAAG;AAC3F,SAAK,4BAA4B;AAAA,EACnC,WAAW,eAAe,OAAO,gBAAgB,OAAO,UAAU,GAAG;AACnE,SAAK;AAAA,qCAAwC;AAC7C;AAAA,MACE,4CAA4C,OAAO,cAAc,QAAQ,OAAO,UAAU;AAAA,IAC5F;AAAA,EACF;AACF;AAQA,SAAS,sBAAsB,KAAmB;AAChD,MAAI;AACF,UAAM,SAAS,YAAY,GAAG;AAC9B,QAAI,OAAO,OAAO;AAChB,WAAK,0DAA0D;AAAA,IACjE;AAAA,EACF,SAAS,OAAgB;AAGvB,QAAI,QAAQ,IAAI,OAAO;AACrB,cAAQ,MAAM,sCAAsC,KAAK;AAAA,IAC3D;AACA;AAAA,EACF;AACF;AAMA,eAAsB,MAAM,SAAsC;AAChE,QAAM,MAAM,QAAQ,IAAI;AAExB,SAAO,uBAAuB;AAE9B,QAAM,SAAS,MAAM,YAAY,GAAG;AAGpC,MAAI,CAAC,OAAO,YAAY;AACtB,SAAK,qDAAqD;AAC1D;AAAA,EACF;AAIA,wBAAsB,GAAG;AAGzB,WAAS,gBAAgB,IAAI,OAAO,UAAU,EAAE;AAChD,WAAS,kBAAkB,OAAO,iBAAiB,IAAI,OAAO,cAAc,KAAK,SAAS;AAG1F,MAAI,QAAQ,SAAS;AACnB,SAAK,uCAAuC;AAAA,EAC9C,OAAO;AACL,UAAM,mBAAmB,MAAM;AAAA,EACjC;AAEA,wBAAsB,MAAM;AAC5B,QAAM,YAAY,oBAAoB,MAAM;AAE5C,MAAI,WAAW;AACb,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;","names":[]}

package/dist/{chunk-G2UYJDPN.js → chunk-2HB6H4G5.js}

@@ -3,7 +3,11 @@ import {
 } from "./chunk-NHXVS5FL.js";
 import {
   resolveTicketsDirectory
-} from "./chunk-3BMVTFFM.js";
+} from "./chunk-54KAYQTY.js";
+
+// src/ticket-sync/index.ts
+import { existsSync, readdirSync, readFileSync, writeFileSync } from "fs";
+import nodePath from "path";
 
 // src/utils/ticket-relations.ts
 function parseTicketIdList(raw) {
@@ -56,8 +60,6 @@ function findTicketsInCycles(nodes) {
 }
 
 // src/ticket-sync/index.ts
-import { existsSync, readdirSync, readFileSync, writeFileSync } from "fs";
-import nodePath from "path";
 var TICKETS_RELATIVE_PATH = "<namespace-root>/tickets";
 var INDEX_FILENAME = "INDEX.md";
 var COMPLETED_INDEX_FILENAME = "INDEX-completed.md";
@@ -242,4 +244,4 @@ export {
   readTickets,
   syncTickets
 };
-//# sourceMappingURL=chunk-G2UYJDPN.js.map
+//# sourceMappingURL=chunk-2HB6H4G5.js.map

package/dist/chunk-2HB6H4G5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ticket-sync/index.ts","../src/utils/ticket-relations.ts"],"sourcesContent":["/**\n * Ticket sync — generates capability-discovery indexes over the ticket corpus:\n * `<namespace-root>/tickets/INDEX.md` (active tickets, grouped by epic) and\n * `INDEX-completed.md` (the `completed/` archive). Mirrors `learning-sync`\n * (plain markdown + grep, no skill-description char cap) so \"is there already\n * a ticket for X?\" is one grep instead of a hundreds-of-folders hunt.\n *\n * Fired manually via `safeword sync-tickets`, as a `safeword check` step, and\n * after `ticket new`.\n *\n * Ticket 1GGD28.\n */\n\nimport { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport nodePath from 'node:path';\n\nimport { resolveTicketsDirectory } from '../utils/configured-paths.js';\nimport { formatTicketReference } from '../utils/ticket-reference.js';\nimport { deriveBlocks, parseTicketIdList } from '../utils/ticket-relations.js';\n\n/** Placeholder label for callers that read a directory without a project cwd. */\nexport const TICKETS_RELATIVE_PATH = '<namespace-root>/tickets';\nexport const INDEX_FILENAME = 'INDEX.md';\nexport const COMPLETED_INDEX_FILENAME = 'INDEX-completed.md';\nexport const COMPLETED_DIRNAME = 'completed';\n\nconst NO_EPIC_GROUP = '(no epic)';\nconst SKIP_DIRECTORIES = new Set([COMPLETED_DIRNAME, 'tmp']);\n\nexport interface TicketEntry {\n  id: string;\n  folder: string; // folder name, e.g. 1GGD28-ticket-discovery-index\n  relativePath: string; // e.g. <namespace-root>/tickets/1GGD28-ticket-discovery-index\n  title: string;\n  status: string;\n  epic: string | undefined; // undefined → grouped under \"(no epic)\"\n  goal: string | undefined; // the **Goal:** one-liner, when present\n  dependsOn: string[]; // ticket ids this one depends on (directed edge); [] when none\n}\n\nexport interface TicketSyncResult {\n  wrote: boolean;\n  active: TicketEntry[];\n  completed: TicketEntry[];\n  skipped: { folder: string; reason: string }[];\n  indexPath: string;\n  completedIndexPath: string;\n}\n\n/** Strip a single layer of matching surrounding quotes. */\nfunction stripQuotes(value: string): string {\n  if (\n    value.length >= 2 &&\n    ((value.startsWith(\"'\") && value.endsWith(\"'\")) ||\n      (value.startsWith('\"') && value.endsWith('\"')))\n  ) {\n    return value.slice(1, -1);\n  }\n  return value;\n}\n\n/** Parse the leading `--- … ---` frontmatter block into a key→value map. */\nfunction parseFrontmatter(content: string): { fields: Map<string, string>; bodyStart: number } {\n  const lines = content.split('\\n');\n  const fields = new Map<string, string>();\n  if (lines[0]?.trim() !== '---') return { fields, bodyStart: 0 };\n\n  for (let index = 1; index < lines.length; index += 1) {\n    const line = lines[index] ?? '';\n    if (line.trim() === '---') return { fields, bodyStart: index + 1 };\n    const match = /^([a-z_][\\w-]*):(.*)$/i.exec(line);\n    if (match?.[1] !== undefined) fields.set(match[1], stripQuotes((match[2] ?? '').trim()));\n  }\n  return { fields, bodyStart: 0 };\n}\n\n/** First `# H1` heading text in the body, if any. */\nfunction firstHeading(bodyLines: string[]): string | undefined {\n  for (const line of bodyLines) {\n    if (line.startsWith('# ')) return line.slice(2).trim();\n  }\n  return undefined;\n}\n\n/** The `**Goal:**` one-liner from the body, label stripped, if present. */\nfunction goalLine(bodyLines: string[]): string | undefined {\n  for (const line of bodyLines) {\n    const match = /^\\*\\*Goal:\\*\\*(.*)$/.exec(line.trim());\n    if (match?.[1] !== undefined) {\n      const goal = match[1].trim();\n      if (goal.length > 0) return goal;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Parse a single ticket.md. Returns the entry (minus relativePath) when it has\n * an `id:`, or a skip reason. Title resolves frontmatter `title` → first H1 →\n * frontmatter `slug` → folder name.\n */\nfunction parseTicket(\n  filePath: string,\n  folder: string,\n): { ok: true; entry: Omit<TicketEntry, 'relativePath'> } | { ok: false; reason: string } {\n  const content = readFileSync(filePath, 'utf8');\n  const { fields, bodyStart } = parseFrontmatter(content);\n\n  const id = fields.get('id');\n  if (id === undefined || id.length === 0) {\n    return { ok: false, reason: 'missing id: in frontmatter' };\n  }\n\n  const bodyLines = content.split('\\n').slice(bodyStart);\n  const title = fields.get('title') ?? firstHeading(bodyLines) ?? fields.get('slug') ?? folder;\n  const status = fields.get('status') ?? '—';\n  const epic = fields.get('epic');\n\n  return {\n    ok: true,\n    entry: {\n      id,\n      folder,\n      title,\n      status,\n      epic,\n      goal: goalLine(bodyLines),\n      dependsOn: parseTicketIdList(fields.get('depends_on')),\n    },\n  };\n}\n\n/** Parse every ticket folder directly under `directory`, returning entries +\n * skip reasons. Folders without a ticket.md are silently ignored (not skipped).\n * `pathPrefix` is prepended to the folder for the entry's relativePath. */\nfunction readTicketFolders(\n  directory: string,\n  pathPrefix: string,\n): { entries: TicketEntry[]; skipped: { folder: string; reason: string }[] } {\n  if (!existsSync(directory)) return { entries: [], skipped: [] };\n\n  const entries: TicketEntry[] = [];\n  const skipped: { folder: string; reason: string }[] = [];\n\n  const folders = readdirSync(directory, { withFileTypes: true })\n    .filter(dirent => dirent.isDirectory() && !SKIP_DIRECTORIES.has(dirent.name))\n    .map(dirent => dirent.name)\n    .toSorted((a, b) => a.localeCompare(b));\n\n  for (const folder of folders) {\n    const ticketPath = nodePath.join(directory, folder, 'ticket.md');\n    if (!existsSync(ticketPath)) continue; // not a ticket folder — ignore\n    const parsed = parseTicket(ticketPath, folder);\n    if (parsed.ok) {\n      entries.push({ ...parsed.entry, relativePath: `${pathPrefix}/${folder}` });\n    } else {\n      skipped.push({ folder, reason: parsed.reason });\n    }\n  }\n\n  return { entries, skipped };\n}\n\n/**\n * Read the corpus into active (top-level) and completed (`completed/`) entries,\n * each sorted by id, plus any skipped folders. INDEX*.md are files, so the\n * directory filter excludes them from being parsed as tickets.\n */\nexport function readTickets(\n  ticketsDirectory: string,\n  relativeLabel: string = TICKETS_RELATIVE_PATH,\n): {\n  active: TicketEntry[];\n  completed: TicketEntry[];\n  skipped: { folder: string; reason: string }[];\n} {\n  const active = readTicketFolders(ticketsDirectory, relativeLabel);\n  const completed = readTicketFolders(\n    nodePath.join(ticketsDirectory, COMPLETED_DIRNAME),\n    `${relativeLabel}/${COMPLETED_DIRNAME}`,\n  );\n\n  const byId = (a: TicketEntry, b: TicketEntry) => a.id.localeCompare(b.id);\n  return {\n    active: active.entries.toSorted(byId),\n    completed: completed.entries.toSorted(byId),\n    skipped: [...active.skipped, ...completed.skipped],\n  };\n}\n\n/** Render a list of related ticket ids slug-first, falling back to the bare id\n * for targets outside this index (cross-variant or not-yet-created). */\nfunction renderRelation(ids: string[], labelById: Map<string, string>): string {\n  return ids\n    .map(id => {\n      const title = labelById.get(id);\n      return title === undefined ? id : formatTicketReference(id, title);\n    })\n    .join(', ');\n}\n\n/** Render one entry as a block: header, optional goal, relation edges, path. */\nfunction renderEntry(\n  entry: TicketEntry,\n  blocks: Map<string, string[]>,\n  labelById: Map<string, string>,\n): string[] {\n  const epic = entry.epic ?? '—';\n  const lines = [\n    `- **${formatTicketReference(entry.id, entry.title)}** (${entry.status}, epic: ${epic})`,\n  ];\n  if (entry.goal !== undefined) lines.push(`  ${entry.goal}`);\n  if (entry.dependsOn.length > 0) {\n    lines.push(`  blocked by: ${renderRelation(entry.dependsOn, labelById)}`);\n  }\n  const blocking = blocks.get(entry.id) ?? [];\n  if (blocking.length > 0) lines.push(`  blocks: ${renderRelation(blocking, labelById)}`);\n  lines.push(`  → \\`${entry.relativePath}\\``);\n  return lines;\n}\n\n/** Group entries by epic; \"(no epic)\" sorts last, every other group alphabetical. */\nfunction groupByEpic(entries: TicketEntry[]): [string, TicketEntry[]][] {\n  const groups = new Map<string, TicketEntry[]>();\n  for (const entry of entries) {\n    const key = entry.epic ?? NO_EPIC_GROUP;\n    const bucket = groups.get(key);\n    if (bucket) bucket.push(entry);\n    else groups.set(key, [entry]);\n  }\n  return [...groups.entries()].toSorted(([a], [b]) => {\n    if (a === NO_EPIC_GROUP) return 1;\n    if (b === NO_EPIC_GROUP) return -1;\n    return a.localeCompare(b);\n  });\n}\n\n/**\n * Render the full index for one variant. Deterministic: same entries → same\n * bytes. No size cap — agents Read or grep the file.\n */\nexport function buildIndexContent(\n  entries: TicketEntry[],\n  options: { variant: 'active' | 'completed' },\n): string {\n  const isActive = options.variant === 'active';\n  const header = [\n    isActive ? '# Project Tickets — Index' : '# Project Tickets — Completed Archive',\n    '',\n    '<!-- Auto-generated by `safeword sync-tickets`. Do not edit by hand. -->',\n    isActive\n      ? '<!-- Active tickets, grouped by epic. Completed tickets live in INDEX-completed.md. -->'\n      : '<!-- Completed tickets (the completed/ archive), grouped by epic. -->',\n    '',\n  ];\n\n  if (entries.length === 0) {\n    return [...header, isActive ? 'No active tickets.' : 'No completed tickets.', ''].join('\\n');\n  }\n\n  const blocks = deriveBlocks(entries);\n  const labelById = new Map(entries.map(entry => [entry.id, entry.title]));\n\n  const lines = [...header, `## Tickets (${entries.length})`, ''];\n  for (const [epic, group] of groupByEpic(entries)) {\n    lines.push(`### ${epic}`, '');\n    for (const entry of group) lines.push(...renderEntry(entry, blocks, labelById));\n    lines.push('');\n  }\n  return lines.join('\\n');\n}\n\n/** Write `content` to `path` only when it differs; report whether it wrote. */\nfunction writeIfChanged(path: string, content: string): boolean {\n  const previous = existsSync(path) ? readFileSync(path, 'utf8') : undefined;\n  if (previous === content) return false;\n  writeFileSync(path, content);\n  return true;\n}\n\n/**\n * Generate/update both ticket indexes from the corpus. No-op (creates nothing)\n * when the tickets directory is absent. The completed archive is written when\n * a `completed/` directory exists or completed entries are present.\n */\nexport function syncTickets(cwd: string): TicketSyncResult {\n  const ticketsDirectory = resolveTicketsDirectory(cwd);\n  const relativeLabel = nodePath.relative(cwd, ticketsDirectory) || TICKETS_RELATIVE_PATH;\n  const indexPath = nodePath.join(ticketsDirectory, INDEX_FILENAME);\n  const completedIndexPath = nodePath.join(ticketsDirectory, COMPLETED_INDEX_FILENAME);\n\n  if (!existsSync(ticketsDirectory)) {\n    return { wrote: false, active: [], completed: [], skipped: [], indexPath, completedIndexPath };\n  }\n\n  const { active, completed, skipped } = readTickets(ticketsDirectory, relativeLabel);\n\n  const wroteActive = writeIfChanged(indexPath, buildIndexContent(active, { variant: 'active' }));\n\n  const completedDirectory = nodePath.join(ticketsDirectory, COMPLETED_DIRNAME);\n  const wroteCompleted =\n    completed.length > 0 || existsSync(completedDirectory)\n      ? writeIfChanged(completedIndexPath, buildIndexContent(completed, { variant: 'completed' }))\n      : false;\n\n  return {\n    wrote: wroteActive || wroteCompleted,\n    active,\n    completed,\n    skipped,\n    indexPath,\n    completedIndexPath,\n  };\n}\n","/**\n * Structured ticket relations (ticket AKZJXC).\n *\n * One canonical directed edge — `depends_on` — stored as an inline-array scalar\n * the hand-rolled frontmatter parser can hold. The inverse (`blocks`) is always\n * derived across the corpus; cycles and dangling refs surface as warnings, never\n * errors (mirrors safeword's tolerant ID resolution).\n */\n\n/** A ticket reduced to its id and its outgoing `depends_on` edges. */\nexport interface TicketNode {\n  id: string;\n  dependsOn: string[];\n}\n\n/**\n * Parse a `depends_on` frontmatter scalar into ticket ids. Accepts the inline\n * array form (`[A, B]`) or a bare comma list (`A, B`); trims each id and drops\n * empties. Missing/empty input → `[]`.\n * @param raw the raw frontmatter value, or undefined when the key is absent\n */\nexport function parseTicketIdList(raw?: string): string[] {\n  if (raw === undefined) return [];\n  const inner = raw.trim().replace(/^\\[/, '').replace(/\\]$/, '');\n  return inner\n    .split(',')\n    .map(id => id.trim())\n    .filter(id => id.length > 0);\n}\n\n/**\n * Invert the `depends_on` graph into `id → ids that depend on it` (the derived\n * `blocks` edges). Only ids that block something appear as keys; each value\n * preserves corpus order.\n * @param nodes every ticket's id + depends_on edges\n */\nexport function deriveBlocks(nodes: TicketNode[]): Map<string, string[]> {\n  const blocks = new Map<string, string[]>();\n  for (const node of nodes) {\n    for (const target of node.dependsOn) {\n      const blockers = blocks.get(target) ?? [];\n      blockers.push(node.id);\n      blocks.set(target, blockers);\n    }\n  }\n  return blocks;\n}\n\n/**\n * `depends_on` targets absent from the corpus, as `{from, missing}` pairs sorted\n * by from then missing. Warn-only — a target may live on another branch or in\n * completed/.\n * @param nodes every ticket's id + depends_on edges\n */\nexport function findDanglingDependencies(nodes: TicketNode[]): { from: string; missing: string }[] {\n  const known = new Set(nodes.map(node => node.id));\n  const dangling: { from: string; missing: string }[] = [];\n  for (const node of nodes) {\n    for (const target of node.dependsOn) {\n      if (!known.has(target)) dangling.push({ from: node.id, missing: target });\n    }\n  }\n  return dangling.toSorted(\n    (a, b) => a.from.localeCompare(b.from) || a.missing.localeCompare(b.missing),\n  );\n}\n\n/**\n * Sorted ids of tickets that participate in any `depends_on` cycle (a node\n * reachable from itself, including a self-edge). Warn-only. Dangling targets are\n * inert — they have no outgoing edges, so they can't form a cycle.\n * @param nodes every ticket's id + depends_on edges\n */\nexport function findTicketsInCycles(nodes: TicketNode[]): string[] {\n  const edges = new Map(nodes.map(node => [node.id, node.dependsOn]));\n  const inCycle = new Set<string>();\n\n  for (const start of edges.keys()) {\n    // DFS along depends_on edges; reaching `start` again means it's on a cycle.\n    const stack = [...(edges.get(start) ?? [])];\n    const seen = new Set<string>();\n    while (stack.length > 0) {\n      const next = stack.pop();\n      if (next === undefined) continue;\n      if (next === start) {\n        inCycle.add(start);\n        break;\n      }\n      if (seen.has(next)) continue;\n      seen.add(next);\n      stack.push(...(edges.get(next) ?? []));\n    }\n  }\n\n  return [...inCycle].toSorted((a, b) => a.localeCompare(b));\n}\n"],"mappings":"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","names":[]}

package/dist/{check-2RU6E3DW.js → chunk-42IGUF5V.js}

@@ -1,33 +1,35 @@
 import {
   findDanglingDependencies,
   findTicketsInCycles,
-  readTickets,
-  syncTickets
-} from "./chunk-G2UYJDPN.js";
+  readTickets
+} from "./chunk-2HB6H4G5.js";
 import {
   formatTicketReference
 } from "./chunk-NHXVS5FL.js";
 import {
   buildCoverageReport,
+  buildCoverageReportFromFeature,
   computeSkipMask,
   stripInlineComments
-} from "./chunk-PZ6ZWEF6.js";
+} from "./chunk-IGULTNHR.js";
 import {
-  isNewerVersion
-} from "./chunk-FJYRWU2V.js";
+  FeatureParseError,
+  findFeatureLineageIssues,
+  findFeatureSourcePath
+} from "./chunk-QLXFPFIC.js";
 import {
   SAFEWORD_SCHEMA,
   createProjectContext,
   getMissingPacks,
   reconcile
-} from "./chunk-2EH6Z7P3.js";
+} from "./chunk-4J3GYDJF.js";
 import {
   defaultConfiguredPath,
+  readConfiguredDocumentationSources,
   readConfiguredPath,
   resolveConfiguredPath,
   resolveTicketsDirectory
-} from "./chunk-3BMVTFFM.js";
-import "./chunk-LODQOJEK.js";
+} from "./chunk-54KAYQTY.js";
 import {
   VERSION
 } from "./chunk-HSC7TELY.js";
@@ -36,14 +38,13 @@ import {
   header,
   info,
   isDirectory,
-  keyValue,
   listItem,
   readFileSafe,
   success,
   warn
 } from "./chunk-445LAX4Y.js";
 
-// src/commands/check.ts
+// src/health.ts
 import { readdirSync as readdirSync2 } from "fs";
 import nodePath2 from "path";
 
@@ -365,7 +366,7 @@ function validatePersonas(parsed) {
   ];
 }
 
-// src/commands/check.ts
+// src/health.ts
 function findMissingFiles(cwd, actions) {
   const issues = [];
   for (const action of actions) {
@@ -427,6 +428,12 @@ function findGlossaryAdvisories(cwd) {
     `${nodePath2.relative(cwd, defaultPath)} exists but paths.glossary points to ${override} \u2014 legacy file is orphaned. Consider removing.`
   ];
 }
+function findDocumentationSourceIssues(cwd) {
+  return readConfiguredDocumentationSources(cwd).flatMap((source) => {
+    if (source.type !== "local") return [];
+    return exists(source.resolvedPath) ? [] : [`docs-source: ${source.path}: file or directory not found`];
+  });
+}
 function listTicketIds(ticketsRoot) {
   try {
     return readdirSync2(ticketsRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory() && entry.name !== "completed").map((entry) => entry.name);
@@ -465,22 +472,57 @@ function archAlignmentHasContent(implPlanContent) {
   if (body.length === 0) return false;
   return !(body.length === 1 && (body[0] ?? "").toLowerCase().startsWith("skip:"));
 }
-function findCoverageAdvisories(cwd) {
+function emptyCoverageDiagnostics() {
+  return { issues: [], advisories: [] };
+}
+function findCoverageDiagnostics(cwd) {
   const ticketsRoot = resolveTicketsDirectory(cwd);
-  return listTicketIds(ticketsRoot).flatMap(
-    (ticketId) => coverageAdvisoriesForTicket(ticketsRoot, ticketId)
-  );
+  const all = emptyCoverageDiagnostics();
+  for (const ticketId of listTicketIds(ticketsRoot)) {
+    const ticketDiagnostics = coverageDiagnosticsForTicket(cwd, ticketsRoot, ticketId);
+    all.issues.push(...ticketDiagnostics.issues);
+    all.advisories.push(...ticketDiagnostics.advisories);
+  }
+  return all;
 }
-function coverageAdvisoriesForTicket(ticketsRoot, ticketId) {
+function coverageDiagnosticsForTicket(cwd, ticketsRoot, ticketId) {
   const ticketDirectory = nodePath2.join(ticketsRoot, ticketId);
   const ticketContent = readFileSafe(nodePath2.join(ticketDirectory, "ticket.md"));
-  if (ticketContent === void 0 || !isInProgress(ticketContent)) return [];
+  if (ticketContent === void 0 || !isInProgress(ticketContent))
+    return emptyCoverageDiagnostics();
   const specContent = readFileSafe(nodePath2.join(ticketDirectory, "spec.md"));
-  if (specContent === void 0) return [];
-  const testDefinitionsContent = readFileSafe(
-    nodePath2.join(ticketDirectory, "test-definitions.md")
+  if (specContent === void 0) return emptyCoverageDiagnostics();
+  const featureSource = readFeatureSource(cwd, ticketId);
+  try {
+    const report = featureSource === void 0 ? buildCoverageReport(
+      specContent,
+      readFileSafe(nodePath2.join(ticketDirectory, "test-definitions.md"))
+    ) : buildCoverageReportFromFeature(specContent, featureSource.content);
+    const lineageIssues = featureSource === void 0 ? [] : formatFeatureLineageIssues(cwd, ticketId, featureSource);
+    return { issues: lineageIssues, advisories: formatCoverageReport(ticketId, report) };
+  } catch (parseError) {
+    if (parseError instanceof FeatureParseError && featureSource !== void 0) {
+      return {
+        issues: [
+          `${formatCoverageTicketLabel(ticketId)}: ${nodePath2.relative(cwd, featureSource.path)}: invalid Gherkin feature: ${parseError.message}`
+        ],
+        advisories: []
+      };
+    }
+    throw parseError;
+  }
+}
+function formatFeatureLineageIssues(cwd, ticketId, featureSource) {
+  const label = formatCoverageTicketLabel(ticketId);
+  const relativePath = nodePath2.relative(cwd, featureSource.path);
+  return findFeatureLineageIssues(featureSource.content).map(
+    (issue) => `${label}: ${relativePath}: ${issue}`
   );
-  return formatCoverageReport(ticketId, buildCoverageReport(specContent, testDefinitionsContent));
+}
+function readFeatureSource(cwd, ticketFolder) {
+  const featurePath = findFeatureSourcePath(cwd, ticketFolder);
+  const content = featurePath === void 0 ? void 0 : readFileSafe(featurePath);
+  return featurePath === void 0 || content === void 0 ? void 0 : { path: featurePath, content };
 }
 function isInProgress(ticketContent) {
   const lines = ticketContent.split("\n");
@@ -493,8 +535,7 @@ function isInProgress(ticketContent) {
   return false;
 }
 function formatCoverageReport(ticketId, report) {
-  const dashIndex = ticketId.indexOf("-");
-  const ticketLabel = dashIndex === -1 ? ticketId : formatTicketReference(ticketId.slice(0, dashIndex), ticketId.slice(dashIndex + 1));
+  const ticketLabel = formatCoverageTicketLabel(ticketId);
   return [
     ...report.uncovered.map(
       (acId) => `${ticketLabel}: acceptance criterion ${acId} has no scenario (uncovered)`
@@ -507,6 +548,10 @@ function formatCoverageReport(ticketId, report) {
     )
   ];
 }
+function formatCoverageTicketLabel(ticketId) {
+  const dashIndex = ticketId.indexOf("-");
+  return dashIndex === -1 ? ticketId : formatTicketReference(ticketId.slice(0, dashIndex), ticketId.slice(dashIndex + 1));
+}
 function findRelationAdvisories(cwd) {
   const ticketsDirectory = resolveTicketsDirectory(cwd);
   let entries;
@@ -545,24 +590,7 @@ function findMissingPatches(cwd, actions) {
   }
   return issues;
 }
-async function checkLatestVersion(timeout = 3e3) {
-  try {
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => {
-      controller.abort();
-    }, timeout);
-    const response = await fetch("https://registry.npmjs.org/safeword/latest", {
-      signal: controller.signal
-    });
-    clearTimeout(timeoutId);
-    if (!response.ok) return void 0;
-    const data = await response.json();
-    return data.version ?? void 0;
-  } catch {
-    return void 0;
-  }
-}
-async function checkHealth(cwd) {
+async function checkHealth(cwd, options = {}) {
   const safewordDirectory = nodePath2.join(cwd, ".safeword");
   if (!exists(safewordDirectory)) {
     return {
@@ -590,12 +618,15 @@ async function checkHealth(cwd) {
     ...findMissingFiles(cwd, actionsWithPath),
     ...findMissingPatches(cwd, actionsWithPath),
     ...findPersonaIssues(cwd),
-    ...findGlossaryIssues(cwd)
+    ...findGlossaryIssues(cwd),
+    ...findDocumentationSourceIssues(cwd)
   ];
   if (!exists(nodePath2.join(cwd, ".claude", "settings.json"))) {
     issues.push("Missing: .claude/settings.json");
   }
-  const missingPacks = getMissingPacks(cwd);
+  const missingPacks = options.skipPackageChecks ? [] : getMissingPacks(cwd);
+  const coverageDiagnostics = findCoverageDiagnostics(cwd);
+  issues.push(...coverageDiagnostics.issues);
   return {
     configured: true,
     projectVersion,
@@ -607,111 +638,64 @@ async function checkHealth(cwd) {
       ...findNamespaceAdvisories(cwd),
       ...findPersonaAdvisories(cwd),
       ...findGlossaryAdvisories(cwd),
-      ...findCoverageAdvisories(cwd),
+      ...coverageDiagnostics.advisories,
       ...findRelationAdvisories(cwd),
       ...findArchitectureAdvisories(cwd)
     ],
-    missingPackages: result.packagesToInstall,
+    missingPackages: options.skipPackageChecks ? [] : result.packagesToInstall,
     missingPacks
   };
 }
-async function reportUpdateStatus(health) {
-  info("\nChecking for updates...");
-  const latestVersion = await checkLatestVersion();
-  if (!latestVersion) {
-    warn("Couldn't check for updates (offline?)");
-    return;
-  }
-  health.latestVersion = latestVersion;
-  health.updateAvailable = isNewerVersion(health.cliVersion, latestVersion);
-  if (health.updateAvailable) {
-    warn(`Update available: v${latestVersion}`);
-    info("Run `bunx safeword@latest upgrade` to upgrade");
-  } else {
-    success("CLI is up to date");
-  }
-}
-function reportVersionMismatch(health) {
-  if (!health.projectVersion) return;
-  if (isNewerVersion(health.cliVersion, health.projectVersion)) {
-    warn(`Project config (v${health.projectVersion}) is newer than CLI (v${health.cliVersion})`);
-    info("Consider upgrading the CLI");
-  } else if (isNewerVersion(health.projectVersion, health.cliVersion)) {
-    info(`
-Upgrade available for project config`);
-    info(
-      `Run \`safeword upgrade\` to update from v${health.projectVersion} to v${health.cliVersion}`
-    );
-  }
-}
-function reportHealthSummary(health) {
-  if (health.advisories.length > 0) {
-    header("Advisories");
-    for (const advisory of health.advisories) {
-      warn(advisory);
-    }
-  }
+function firstFailureSection(health) {
   if (health.missingPacks.length > 0) {
-    header("Missing Language Packs");
-    for (const pack of health.missingPacks) {
-      listItem(`${pack} pack not installed`);
-    }
-    info("\nRun `safeword upgrade` to install missing packs");
-    return true;
+    return {
+      title: "Missing Language Packs",
+      lines: health.missingPacks.map((pack) => `${pack} pack not installed`),
+      render: listItem,
+      defaultHint: "Run `safeword upgrade` to install missing packs"
+    };
   }
   if (health.missingPackages.length > 0) {
-    header("Missing Packages");
-    for (const pkg of health.missingPackages) listItem(pkg);
-    info("\nRun `safeword upgrade` to install missing packages");
-    return true;
+    return {
+      title: "Missing Packages",
+      lines: health.missingPackages,
+      render: listItem,
+      defaultHint: "Run `safeword upgrade` to install missing packages"
+    };
   }
   if (health.issues.length > 0) {
-    header("Issues Found");
-    for (const issue of health.issues) {
-      warn(issue);
-    }
-    info("\nRun `safeword upgrade` to repair configuration");
-    return true;
+    return {
+      title: "Issues Found",
+      lines: health.issues,
+      render: warn,
+      defaultHint: "Run `safeword upgrade` to repair configuration"
+    };
   }
-  success("\nConfiguration is healthy");
-  return false;
+  return void 0;
 }
-function regenerateTicketIndex(cwd) {
-  try {
-    const result = syncTickets(cwd);
-    if (result.wrote) {
-      info("Regenerated ticket index (INDEX.md / INDEX-completed.md)");
-    }
-  } catch (error) {
-    if (process.env.DEBUG) {
-      console.error("[check] ticket index regen failed:", error);
+function reportHealthSummary(health, options = {}) {
+  if (health.advisories.length > 0) {
+    header("Advisories");
+    for (const advisory of health.advisories) {
+      warn(advisory);
     }
-    return;
   }
-}
-async function check(options) {
-  const cwd = process.cwd();
-  header("Safeword Health Check");
-  const health = await checkHealth(cwd);
-  if (!health.configured) {
-    info("Not configured. Run `safeword setup` to initialize.");
-    return;
+  const failure = firstFailureSection(health);
+  if (failure === void 0) {
+    success("\nConfiguration is healthy");
+    return false;
   }
-  regenerateTicketIndex(cwd);
-  keyValue("Safeword CLI", `v${health.cliVersion}`);
-  keyValue("Project config", health.projectVersion ? `v${health.projectVersion}` : "unknown");
-  if (options.offline) {
-    info("\nSkipped update check (offline mode)");
-  } else {
-    await reportUpdateStatus(health);
-  }
-  reportVersionMismatch(health);
-  const hasIssues = reportHealthSummary(health);
-  if (hasIssues) {
-    process.exit(1);
+  header(failure.title);
+  for (const line of failure.lines) {
+    failure.render(line);
   }
+  info(`
+${options.repairHint ?? failure.defaultHint}`);
+  return true;
 }
+
 export {
-  check
+  checkHealth,
+  reportHealthSummary
 };
-//# sourceMappingURL=check-2RU6E3DW.js.map
+//# sourceMappingURL=chunk-42IGUF5V.js.map