skillwiki 0.9.23 → 0.9.26

package/dist/cli.js

@@ -3469,7 +3469,7 @@ function buildCliSurface() {
   program2.command("index-check").option("--wiki <name>");
   program2.command("index-link-format").option("--wiki <name>");
   program2.command("topic-map-check").option("--threshold <n>").option("--wiki <name>");
-  program2.command("stale").option("--archive").option("--days <n>").option("--force-scan").option("--project <slug>").option("--refresh").option("--wiki <name>");
+  program2.command("stale").option("--archive").option("--days <n>").option("--force-scan").option("--project <slug>").option("--wiki <name>");
   program2.command("claim").option("--project <slug>").option("--slug <slug>").option("--wiki <name>");
   program2.command("pagesize").option("--lines <n>").option("--wiki <name>");
   program2.command("log-rotate").option("--threshold <n>").option("--apply").option("--wiki <name>");
@@ -3512,7 +3512,7 @@ function buildCliSurface() {
   compoundCmd2.command("list").requiredOption("--project <slug>").option("--wiki <name>");
   compoundCmd2.command("delete").requiredOption("--project <slug>").option("--wiki <name>");
   const syncCmd2 = program2.commands.find((c) => c.name() === "sync");
-  syncCmd2.command("status").option("--wiki <name>");
+  syncCmd2.command("status").option("--wiki <name>").option("--include-stashes");
   syncCmd2.command("push").option("--wiki <name>");
   syncCmd2.command("pull").option("--wiki <name>");
   syncCmd2.command("lock").option("--summary <text>").option("--ttl-minutes <n>").option("--force").option("--wiki <name>");
@@ -3525,7 +3525,7 @@ function buildCliSurface() {
   memoryCmd2.command("topics").option("--project <slug>").option("--limit <n>").option("--wiki <name>");
   memoryCmd2.command("index").requiredOption("--project <slug>").option("--check").option("--if-stale").option("--wiki <name>");
   memoryCmd2.command("recall").requiredOption("--project <slug>").requiredOption("--topic <slug>").option("--scope <scope>").option("--limit <n>").option("--wiki <name>");
-  memoryCmd2.command("review").requiredOption("--project <slug>").option("--dry-run").option("--wiki <name>");
+  memoryCmd2.command("review").requiredOption("--project <slug>").option("--dry-run").option("--pre-action <target>").option("--wiki <name>");
   memoryCmd2.command("import").requiredOption("--from <path>").requiredOption("--project <slug>").option("--dry-run").option("--apply").option("--max-bytes <n>").option("--wiki <name>");
   const fleetCmd2 = program2.commands.find((c) => c.name() === "fleet");
   fleetCmd2.command("validate");
@@ -7004,9 +7004,12 @@ function summarizeChecks(checks) {
 function classifyLog(path, id, label, okPattern) {
   if (!existsSync12(path)) return { id, label, status: "warn", detail: `log file missing: ${path}` };
   const lines = readFileSync8(path, "utf8").split(/\r?\n/).filter(Boolean);
-  const last = lines[lines.length - 1] ?? "";
-  if (!last) return { id, label, status: "warn", detail: `log file empty: ${path}` };
-  if (/fail|error/i.test(last)) return { id, label, status: "error", detail: last.slice(0, 120) };
+  if (lines.length === 0) return { id, label, status: "warn", detail: `log file empty: ${path}` };
+  const statusLine = [...lines].reverse().find(
+    (line) => /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z /.test(line) && (okPattern.test(line) || /\bFAIL\b|\bERROR\b/i.test(line))
+  );
+  const last = statusLine ?? lines[lines.length - 1];
+  if (/\bFAIL\b|\bERROR\b/i.test(last)) return { id, label, status: "error", detail: last.slice(0, 120) };
   if (okPattern.test(last)) return { id, label, status: "pass", detail: last.slice(0, 120) };
   return { id, label, status: "warn", detail: last.slice(0, 120) };
 }
@@ -9156,6 +9159,11 @@ async function runMemoryReview(input) {
     indexState: state,
     reviewPages: state.reviewPages
   });
+  const preAction = input.preAction?.trim();
+  if (preAction) {
+    findings.push(...await buildPastFailureFindings(scan.data.allMarkdown, input.project, preAction));
+    findings.sort(compareMemoryReviewFindings);
+  }
   const generatedAt = (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d{3}Z$/, "Z");
   return {
     exitCode: ExitCode.OK,
@@ -9474,6 +9482,135 @@ function buildMemoryReviewFindings(input) {
   }
   return findings.sort(compareMemoryReviewFindings);
 }
+var COMMON_FAILURE_MATCH_TOKENS = /* @__PURE__ */ new Set([
+  "memory",
+  "review",
+  "test",
+  "tests",
+  "plugin",
+  "cache",
+  "command",
+  "feature",
+  "project",
+  "status",
+  "error",
+  "warning",
+  "warn",
+  "info",
+  "skillwiki",
+  "dev",
+  "loop"
+]);
+var FAILURE_MARKER_RE = /\b(?:miss|root cause|symptom|problem|friction|regression|bug)\b/i;
+async function buildPastFailureFindings(pages, project, target) {
+  const targetProfile = buildPastFailureTargetProfile(target);
+  if (!targetProfile) return [];
+  const findings = [];
+  for (const page of dedupePages(pages)) {
+    const body = await readPastFailureCandidateBody(page, project);
+    if (!body) continue;
+    const match = matchPastFailureTarget(targetProfile, body);
+    if (!match) continue;
+    findings.push({
+      id: `past_failure_match:${page.relPath}`,
+      severity: "warn",
+      kind: "past_failure_match",
+      path: page.relPath,
+      message: `${page.relPath} matches pre-action target ${targetProfile.summary}: ${match.reason}`,
+      suggested_action: `Read ${page.relPath} before executing; reuse the prior miss/root-cause notes if relevant.`
+    });
+  }
+  return findings.sort(compareMemoryReviewFindings);
+}
+function buildPastFailureTargetProfile(target) {
+  const normalizedTarget = normalizeMatchText(target);
+  if (!normalizedTarget) return null;
+  const distinctiveTokens = extractDistinctiveTargetTokens(target);
+  const includeFullPhrase = normalizedTarget.length >= 12 && distinctiveTokens.length >= 2;
+  const exactNeedles = uniqueStrings([
+    includeFullPhrase ? normalizedTarget : "",
+    ...extractPathLikeNeedles(target),
+    ...extractFlagNeedles(target),
+    ...extractCodeLikeNeedles(target)
+  ].map(normalizeMatchText).filter((needle) => needle.length >= 4).filter(hasDistinctiveNeedle));
+  if (exactNeedles.length === 0 && distinctiveTokens.length < 2) return null;
+  return {
+    summary: summarizeTarget(target),
+    exactNeedles,
+    distinctiveTokens
+  };
+}
+async function readPastFailureCandidateBody(page, project) {
+  if (isProjectRetroPath(page.relPath, project)) {
+    return bodyWithoutFrontmatter(await readPage(page));
+  }
+  if (!isRawBugCapturePath(page.relPath)) return null;
+  const text = await readPage(page);
+  const fm = extractFrontmatter(text);
+  if (!fm.ok || !frontmatterProjectMatches(fm.data.project, project)) return null;
+  return bodyWithoutFrontmatter(text);
+}
+function isProjectRetroPath(path, project) {
+  return path.startsWith(`projects/${project}/work/`) && path.endsWith("/retro.md") || path.startsWith(`projects/${project}/history/`) && path.endsWith("/retro.md");
+}
+function isRawBugCapturePath(path) {
+  return /^raw\/transcripts\/.*-bug-.*\.md$/.test(path);
+}
+function frontmatterProjectMatches(value, project) {
+  if (typeof value === "string") return wikilinkSlug2(value) === project;
+  if (Array.isArray(value)) {
+    return value.some((item) => typeof item === "string" && wikilinkSlug2(item) === project);
+  }
+  return false;
+}
+function bodyWithoutFrontmatter(text) {
+  const split = splitFrontmatter(text);
+  return split.ok ? split.data.body : text;
+}
+function matchPastFailureTarget(target, candidateBody) {
+  const candidate = normalizeMatchText(candidateBody);
+  if (!candidate) return null;
+  const exactMatch = target.exactNeedles.find((needle) => candidate.includes(needle));
+  if (exactMatch) {
+    return { reason: `exact signal "${exactMatch}" appeared in prior failure memory` };
+  }
+  if (!FAILURE_MARKER_RE.test(candidateBody)) return null;
+  const candidateTokens = new Set(tokenizeForMatch(candidate));
+  const overlappingTokens = target.distinctiveTokens.filter((token) => candidateTokens.has(token));
+  if (overlappingTokens.length >= 2) {
+    return { reason: `distinctive target terms overlapped prior failure memory (${overlappingTokens.slice(0, 4).join(", ")})` };
+  }
+  return null;
+}
+function extractPathLikeNeedles(value) {
+  return value.match(/[A-Za-z0-9_.-]+(?:\/[A-Za-z0-9_.-]+)+/g) ?? [];
+}
+function extractFlagNeedles(value) {
+  return value.match(/--[a-z][a-z0-9-]*/gi) ?? [];
+}
+function extractCodeLikeNeedles(value) {
+  return (value.match(/[A-Za-z0-9_.:-]*[_.:-][A-Za-z0-9_.:-]+/g) ?? []).filter((needle) => /[A-Za-z]/.test(needle));
+}
+function extractDistinctiveTargetTokens(value) {
+  return uniqueStrings(tokenizeForMatch(value).filter((token) => token.length >= 4).filter((token) => !/^\d+$/.test(token)).filter((token) => !COMMON_FAILURE_MATCH_TOKENS.has(token)));
+}
+function hasDistinctiveNeedle(value) {
+  return extractDistinctiveTargetTokens(value).length > 0;
+}
+function tokenizeForMatch(value) {
+  return normalizeMatchText(value).match(/[a-z0-9]+/g) ?? [];
+}
+function normalizeMatchText(value) {
+  return value.toLowerCase().replace(/[`"'“”‘’]/g, "").replace(/\s+/g, " ").trim();
+}
+function summarizeTarget(target) {
+  const summary = target.replace(/\s+/g, " ").trim();
+  if (summary.length <= 96) return JSON.stringify(summary);
+  return JSON.stringify(`${summary.slice(0, 93).trimEnd()}...`);
+}
+function uniqueStrings(values) {
+  return [...new Set(values.filter((value) => value.length > 0))];
+}
 function parseInvalidTopicWarning(warning) {
   const match = warning.match(/^(.*): invalid memory topic slug (.+)$/);
   if (!match) return null;
@@ -12019,13 +12156,14 @@ memoryCmd.command("recall [vault]").description("recall bounded source summaries
     limit: opts.limit
   }), v.vault, { postCommit: false });
 });
-memoryCmd.command("review [vault]").description("review deterministic memory gaps and cache drift without writing").requiredOption("--project <slug>", "project slug").option("--dry-run", "preview only; writes are not supported on this surface", false).option("--wiki <name>", "wiki profile name").action(async (vault, opts) => {
+memoryCmd.command("review [vault]").description("review deterministic memory gaps and cache drift without writing").requiredOption("--project <slug>", "project slug").option("--dry-run", "preview only; writes are not supported on this surface", false).option("--pre-action <target>", "target slug, file path, command, or error signature to check against past failure memory").option("--wiki <name>", "wiki profile name").action(async (vault, opts) => {
   const v = await resolveVaultArg(vault, opts.wiki);
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
   else emit(await runMemoryReview({
     vault: v.vault,
     project: opts.project,
-    dryRun: !!opts.dryRun
+    dryRun: !!opts.dryRun,
+    preAction: opts.preAction
   }), v.vault, { postCommit: false });
 });
 memoryCmd.command("import [vault]").description("preview or apply local memory imports into raw captures").requiredOption("--from <path>", "source file or directory to scan").requiredOption("--project <slug>", "project slug").option("--dry-run", "preview only; do not write captures", false).option("--apply", "write validated raw captures for ready entries", false).option("--max-bytes <n>", "reject source files above this size", (s) => parseInt(s, 10), 2e5).option("--wiki <name>", "wiki profile name").action(async (vault, opts) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.9.23",
+  "version": "0.9.26",
   "type": "module",
   "bin": {
     "skillwiki": "dist/cli.js"

package/skills/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.9.23",
+  "version": "0.9.26",
   "skills": "./",
   "description": "Project-aware Karpathy-style knowledge base for Claude Code: 18 prompt-only skills (wiki-*, proj-*, using-skillwiki) backed by the deterministic `skillwiki` CLI.",
   "author": {

package/skills/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.9.23",
+  "version": "0.9.26",
   "description": "Project-aware Karpathy-style knowledge base for Codex with 18 prompt-only skills backed by the deterministic skillwiki CLI.",
   "author": {
     "name": "karlorz",

package/skills/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillwiki/skills",
-  "version": "0.9.23",
+  "version": "0.9.26",
   "private": true,
   "files": [
     "wiki-*",