skillwiki 0.2.1-beta.10 → 0.2.1-beta.12

package/dist/cli.js

@@ -162,9 +162,25 @@ var CompoundSchema = z.object({
   promoted_to: wikilink.optional(),
   cssclasses: z.array(z.string()).optional()
 });
+var MetaSchema = z.object({
+  title: z.string().min(1),
+  aliases: z.array(z.string()).optional(),
+  created: isoDate,
+  updated: isoDate,
+  type: z.literal("meta"),
+  tags: z.array(z.string()),
+  confidence: z.enum(["high", "medium", "low"]).optional(),
+  provenance: z.enum(["research", "project", "mixed"]).optional(),
+  provenance_projects: z.array(wikilink).min(2, "meta pages must reference \u22652 projects")
+}).superRefine((v, ctx) => {
+  if (v.provenance && v.provenance !== "research" && (!v.provenance_projects || v.provenance_projects.length === 0)) {
+    ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["provenance_projects"], message: "required when provenance != research" });
+  }
+});
 function detectSchema(fm) {
   const COMPOUND_TYPES = /* @__PURE__ */ new Set(["lesson", "pattern", "antipattern", "gotcha"]);
   if (typeof fm.type === "string" && COMPOUND_TYPES.has(fm.type) && "project" in fm) return { schema: "compound" };
+  if (fm.type === "meta") return { schema: "meta" };
   if ("type" in fm && "sources" in fm) return { schema: "typed-knowledge" };
   if (typeof fm.sha256 === "string" && "ingested" in fm) return { schema: "raw" };
   if ("kind" in fm && "status" in fm) return { schema: "work-item" };
@@ -303,7 +319,8 @@ var SCHEMAS = {
   "typed-knowledge": TypedKnowledgeSchema,
   "raw": RawSourceSchema,
   "work-item": WorkItemSchema,
-  "compound": CompoundSchema
+  "compound": CompoundSchema,
+  "meta": MetaSchema
 };
 async function runValidate(input) {
   let text;
@@ -342,7 +359,7 @@ import { dirname } from "path";
 // src/utils/vault.ts
 import { readFile as readFile3, readdir, stat } from "fs/promises";
 import { join, relative, sep } from "path";
-var TYPED_DIRS = ["entities", "concepts", "comparisons", "queries"];
+var TYPED_DIRS = ["entities", "concepts", "comparisons", "queries", "meta"];
 async function scanVault(root) {
   try {
     await stat(join(root, "SCHEMA.md"));
@@ -1596,6 +1613,9 @@ Chronological action log. Newest entries last. Skill writes append entries; lint
   return { exitCode: ExitCode.OK, result: ok({ entries, threshold: input.threshold, rotated: true, rotated_to: rotatedName, humanHint: `rotated ${entries} entries to ${rotatedName}` }) };
 }
 
+// src/commands/lint.ts
+import { readFile as readFile12, writeFile as writeFile6 } from "fs/promises";
+
 // src/commands/topic-map-check.ts
 var DEFAULT_THRESHOLD = 200;
 async function runTopicMapCheck(input) {
@@ -1732,6 +1752,8 @@ var WARNING_ORDER = ["index_incomplete", "index_link_format", "stale_page", "pag
 var INFO_ORDER = ["bridges", "page_structure", "topic_map_recommended", "frontmatter_wikilink", "wikilink_citation"];
 async function runLint(input) {
   const buckets = {};
+  const fixed = [];
+  const unresolved = [];
   const links = await runLinks({ vault: input.vault });
   if (links.result.ok && links.result.data.broken.length > 0) buckets.broken_wikilinks = links.result.data.broken;
   if (!links.result.ok && links.result.error === "INVALID_FRONTMATTER") {
@@ -1822,6 +1844,105 @@ async function runLint(input) {
     if (noOverview.length > 0) buckets.missing_overview = noOverview;
     if (fmWikilinkFlags.length > 0) buckets.frontmatter_wikilink = fmWikilinkFlags;
     if (wikilinkCitationFlags.length > 0) buckets.wikilink_citation = wikilinkCitationFlags;
+    if (input.fix && legacyPages.length > 0) {
+      const FENCE_RE2 = /```[\s\S]*?```/g;
+      const INLINE_MARKER = /\^\[raw\/[^\]]+\]/g;
+      for (const relPath of legacyPages) {
+        try {
+          const absPath = `${input.vault}/${relPath}`;
+          const raw = await readFile12(absPath, "utf8");
+          const split = splitFrontmatter(raw);
+          if (!split.ok) {
+            unresolved.push(relPath);
+            continue;
+          }
+          const body = split.data.body;
+          const rawFm = split.data.rawFrontmatter;
+          const stripped = body.replace(FENCE_RE2, "");
+          const lines = stripped.split("\n");
+          const inlineMarkers = [];
+          let inSources = false;
+          for (const line of lines) {
+            if (/^## Sources\b/.test(line.trim())) {
+              inSources = true;
+              continue;
+            }
+            if (inSources) continue;
+            for (const m of line.matchAll(INLINE_MARKER)) {
+              inlineMarkers.push(m[0]);
+            }
+          }
+          if (inlineMarkers.length === 0) {
+            unresolved.push(relPath);
+            continue;
+          }
+          const bodyLines = body.split("\n");
+          let inSrc = false;
+          const newBodyLines = [];
+          const seen = /* @__PURE__ */ new Set();
+          for (const line of bodyLines) {
+            if (/^## Sources\b/.test(line.trim())) {
+              inSrc = true;
+              newBodyLines.push(line);
+              continue;
+            }
+            if (inSrc) {
+              newBodyLines.push(line);
+              continue;
+            }
+            const lineWithoutMarkers = line.replace(INLINE_MARKER, "").trim();
+            if (lineWithoutMarkers.length === 0 && INLINE_MARKER.test(line)) {
+              continue;
+            }
+            let cleaned = line;
+            for (const marker of inlineMarkers) {
+              if (seen.has(marker)) continue;
+              const escapedMarker = marker.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+              const trailingRe = new RegExp(`([.!?]\\s*)${escapedMarker}`);
+              if (trailingRe.test(cleaned)) {
+                cleaned = cleaned.replace(trailingRe, "$1");
+                seen.add(marker);
+              }
+              const midRe = new RegExp(`${escapedMarker}\\s*`);
+              if (!seen.has(marker) && midRe.test(cleaned)) {
+                cleaned = cleaned.replace(midRe, "");
+                seen.add(marker);
+              }
+            }
+            newBodyLines.push(cleaned);
+          }
+          let newBody = newBodyLines.join("\n");
+          const dedupedMarkers = [...new Set(inlineMarkers)];
+          if (inSrc) {
+            const existingSources = new Set(
+              body.split("\n").filter((l) => /^- \^\[raw\//.test(l.trim())).map((l) => l.trim().replace(/^- /, ""))
+            );
+            const newMarkers = dedupedMarkers.filter((m) => !existingSources.has(m));
+            const sourceLines = newMarkers.map((m) => `- ${m}`);
+            if (sourceLines.length > 0) {
+              newBody = newBody.trimEnd() + "\n" + sourceLines.join("\n") + "\n";
+            }
+          } else {
+            const sourceLines = dedupedMarkers.map((m) => `- ${m}`);
+            newBody = newBody.trimEnd() + "\n\n## Sources\n\n" + sourceLines.join("\n") + "\n";
+          }
+          const newContent = `---
+${rawFm}
+---
+${newBody}`;
+          await writeFile6(absPath, newContent, "utf8");
+          fixed.push(relPath);
+        } catch {
+          unresolved.push(relPath);
+        }
+      }
+      if (fixed.length > 0) {
+        const fixedSet = new Set(fixed);
+        const remaining = legacyPages.filter((p) => !fixedSet.has(p));
+        if (remaining.length > 0) buckets.legacy_citation_style = remaining;
+        else delete buckets.legacy_citation_style;
+      }
+    }
   }
   const errorOut = ERROR_ORDER.flatMap((k) => buckets[k] ? [{ kind: k, items: buckets[k] }] : []);
   const warningOut = WARNING_ORDER.flatMap((k) => buckets[k] ? [{ kind: k, items: buckets[k] }] : []);
@@ -1849,13 +1970,15 @@ async function runLint(input) {
       vault: { path: input.vault, source: input.source ?? "resolved" },
       summary,
       by_severity: { error: errorOut, warning: warningOut, info: infoOut },
+      fixed,
+      unresolved,
       humanHint: hintLines.join("\n")
     })
   };
 }
 
 // src/commands/config.ts
-import { readFile as readFile12 } from "fs/promises";
+import { readFile as readFile13 } from "fs/promises";
 import { existsSync } from "fs";
 import { join as join14 } from "path";
 function validateKey(key) {
@@ -1880,7 +2003,7 @@ async function runConfigSet(input) {
   try {
     let originalContent;
     try {
-      originalContent = await readFile12(filePath, "utf8");
+      originalContent = await readFile13(filePath, "utf8");
     } catch {
     }
     const existing = originalContent !== void 0 ? parseDotenvText(originalContent) : {};
@@ -2193,7 +2316,7 @@ async function runDoctor(input) {
 }
 
 // src/commands/archive.ts
-import { rename as rename3, mkdir as mkdir5, readFile as readFile13, writeFile as writeFile6 } from "fs/promises";
+import { rename as rename3, mkdir as mkdir5, readFile as readFile14, writeFile as writeFile7 } from "fs/promises";
 import { join as join18, dirname as dirname7 } from "path";
 async function runArchive(input) {
   const scan = await scanVault(input.vault);
@@ -2216,12 +2339,12 @@ async function runArchive(input) {
   if (!isRaw) {
     const indexPath = join18(input.vault, "index.md");
     try {
-      const idx = await readFile13(indexPath, "utf8");
+      const idx = await readFile14(indexPath, "utf8");
       const slug = relPath.replace(/\.md$/, "").split("/").pop();
       const originalLines = idx.split("\n");
       const filtered = originalLines.filter((l) => !l.includes(`[[${slug}]]`));
       if (filtered.length !== originalLines.length) {
-        await writeFile6(indexPath, filtered.join("\n"), "utf8");
+        await writeFile7(indexPath, filtered.join("\n"), "utf8");
         indexUpdated = true;
       }
     } catch (e) {
@@ -2234,7 +2357,7 @@ async function runArchive(input) {
 
 // src/commands/drift.ts
 import { createHash as createHash2 } from "crypto";
-import { writeFile as writeFile7 } from "fs/promises";
+import { writeFile as writeFile8 } from "fs/promises";
 
 // src/utils/fetch.ts
 async function controlledFetch(url, opts) {
@@ -2320,7 +2443,7 @@ async function runDrift(input) {
 ${newFm}
 ---
 ${body}`;
-      await writeFile7(raw.absPath, newText, "utf8");
+      await writeFile8(raw.absPath, newText, "utf8");
       results.push({
         raw_path: raw.relPath,
         source_url: sourceUrl,
@@ -2355,7 +2478,7 @@ ${body}`;
 }
 
 // src/commands/migrate-citations.ts
-import { writeFile as writeFile8 } from "fs/promises";
+import { writeFile as writeFile9 } from "fs/promises";
 var MARKER_RE2 = /\^\[(raw\/[^\]]+)\]/g;
 function moveMarkersToParagraphEnd(body) {
   const lines = body.split("\n");
@@ -2478,7 +2601,7 @@ ${migratedBody}${newFooter}`;
       continue;
     }
     if (!input.dryRun) {
-      await writeFile8(page.absPath, newText, "utf8");
+      await writeFile9(page.absPath, newText, "utf8");
     }
     migrated.push(page.relPath);
   }
@@ -2500,7 +2623,7 @@ ${migratedBody}${newFooter}`;
 }
 
 // src/commands/frontmatter-fix.ts
-import { writeFile as writeFile9 } from "fs/promises";
+import { writeFile as writeFile10 } from "fs/promises";
 function isoToday() {
   return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
 }
@@ -2542,7 +2665,7 @@ ${newBody}`;
       continue;
     }
     if (!input.dryRun) {
-      await writeFile9(page.absPath, newText, "utf8");
+      await writeFile10(page.absPath, newText, "utf8");
     }
     fixed.push(page.relPath);
   }
@@ -2626,7 +2749,7 @@ async function runUpdate(input) {
 }
 
 // src/commands/transcripts.ts
-import { readdir as readdir4, stat as stat6, readFile as readFile14 } from "fs/promises";
+import { readdir as readdir4, stat as stat6, readFile as readFile15 } from "fs/promises";
 import { join as join19 } from "path";
 async function runTranscripts(input) {
   const dir = join19(input.vault, "raw", "transcripts");
@@ -2640,7 +2763,7 @@ async function runTranscripts(input) {
   for (const entry of entries) {
     if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
     const filePath = join19(dir, entry.name);
-    const content = await readFile14(filePath, "utf8");
+    const content = await readFile15(filePath, "utf8");
     const fm = extractFrontmatter(content);
     if (!fm.ok) continue;
     const ingested = typeof fm.data.ingested === "string" ? fm.data.ingested : "";
@@ -2763,7 +2886,7 @@ program.command("log-rotate [vault]").option("--threshold <n>", "entry count thr
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
   else emit(await runLogRotate({ vault: v.vault, threshold: opts.threshold, apply: !!opts.apply }));
 });
-program.command("lint [vault]").option("--days <n>", "stale threshold", (s) => parseInt(s, 10), 90).option("--lines <n>", "pagesize threshold", (s) => parseInt(s, 10), 200).option("--log-threshold <n>", "log rotation threshold", (s) => parseInt(s, 10), 500).option("--wiki <name>", "wiki profile name").action(async (vault, opts) => {
+program.command("lint [vault]").option("--days <n>", "stale threshold", (s) => parseInt(s, 10), 90).option("--lines <n>", "pagesize threshold", (s) => parseInt(s, 10), 200).option("--log-threshold <n>", "log rotation threshold", (s) => parseInt(s, 10), 500).option("--fix", "auto-fix legacy_citation_style violations").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 runLint({
@@ -2771,7 +2894,8 @@ program.command("lint [vault]").option("--days <n>", "stale threshold", (s) => p
     source: vault ? "flag" : void 0,
     days: opts.days,
     lines: opts.lines,
-    logThreshold: opts.logThreshold
+    logThreshold: opts.logThreshold,
+    fix: opts.fix ?? false
   }));
 });
 var configCmd = program.command("config").description("manage skillwiki configuration");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.2.1-beta.10",
+  "version": "0.2.1-beta.12",
   "type": "module",
   "bin": {
     "skillwiki": "dist/cli.js"

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

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

package/skills/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillwiki/skills",
-  "version": "0.2.1-beta.10",
+  "version": "0.2.1-beta.12",
   "private": true,
   "files": [
     "wiki-*",