skillwiki 0.2.0-beta.25 → 0.2.0-beta.26

package/dist/cli.js

@@ -2337,6 +2337,71 @@ ${migratedBody}${newFooter}`;
   };
 }
 
+// src/commands/frontmatter-fix.ts
+import { writeFile as writeFile8 } from "fs/promises";
+function isoToday() {
+  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+}
+function fixFrontmatter(rawFm) {
+  const additions = [];
+  if (!/^created:/m.test(rawFm)) additions.push(`created: ${isoToday()}`);
+  if (!/^updated:/m.test(rawFm)) additions.push(`updated: ${isoToday()}`);
+  if (!/^tags:/m.test(rawFm)) additions.push("tags: []");
+  if (!/^sources:/m.test(rawFm)) additions.push("sources: []");
+  if (!/^provenance:/m.test(rawFm)) additions.push("provenance: research");
+  if (additions.length === 0) return rawFm;
+  return rawFm.trimEnd() + "\n" + additions.join("\n") + "\n";
+}
+function removeOrphanTagsLines(body) {
+  return body.split("\n").filter((line) => !/^tags:\s*\[/.test(line.trim())).join("\n");
+}
+async function runFrontmatterFix(input) {
+  const scan = await scanVault(input.vault);
+  if (!scan.ok) return { exitCode: ExitCode.VAULT_PATH_INVALID, result: scan };
+  const fixed = [];
+  const skipped = [];
+  let unchanged = 0;
+  for (const page of scan.data.typedKnowledge) {
+    const text = await readPage(page);
+    const split = splitFrontmatter(text);
+    if (!split.ok) {
+      skipped.push(page.relPath);
+      continue;
+    }
+    const { rawFrontmatter, body } = split.data;
+    const newFm = fixFrontmatter(rawFrontmatter);
+    const newBody = removeOrphanTagsLines(body);
+    const newText = `---
+${newFm}
+---
+${newBody}`;
+    if (newText === text) {
+      unchanged++;
+      continue;
+    }
+    if (!input.dryRun) {
+      await writeFile8(page.absPath, newText, "utf8");
+    }
+    fixed.push(page.relPath);
+  }
+  const exitCode = fixed.length > 0 ? ExitCode.MIGRATION_APPLIED : ExitCode.OK;
+  const hintLines = [`scanned: ${fixed.length + skipped.length + unchanged}`];
+  if (fixed.length > 0) hintLines.push(`fixed: ${fixed.length}`);
+  if (skipped.length > 0) hintLines.push(`skipped (parse error): ${skipped.length}`);
+  if (unchanged > 0) hintLines.push(`unchanged: ${unchanged}`);
+  if (input.dryRun && fixed.length > 0) hintLines.push("(dry run \u2014 no files written)");
+  return {
+    exitCode,
+    result: ok({
+      scanned: fixed.length + skipped.length + unchanged,
+      fixed,
+      skipped,
+      unchanged,
+      humanHint: hintLines.join("\n")
+    })
+  };
+}
+
 // src/commands/update.ts
 import { execSync as execSync2 } from "child_process";
 import { readFileSync as readFileSync3 } from "fs";
@@ -2548,6 +2613,11 @@ program.command("migrate-citations [vault]").description("migrate ^[raw/...] mar
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
   else emit(await runMigrateCitations({ vault: v.vault, dryRun: !!opts.dryRun }));
 });
+program.command("frontmatter-fix [vault]").description("fix common frontmatter issues on typed-knowledge pages").option("--dry-run", "preview changes without writing", false).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 runFrontmatterFix({ vault: v.vault, dryRun: !!opts.dryRun }));
+});
 program.command("update").description("update skillwiki CLI to the latest version").option("--tag <tag>", "npm dist-tag", "beta").action(async (opts) => emit(await runUpdate({
   home: process.env.HOME ?? "",
   distTag: opts.tag

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.2.0-beta.25",
+  "version": "0.2.0-beta.26",
   "type": "module",
   "bin": {
     "skillwiki": "dist/cli.js"

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

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.2.0-beta.25",
+  "version": "0.2.0-beta.26",
   "skills": "./",
   "description": "Project-aware Karpathy-style knowledge base for Claude Code: 11 prompt-only skills (wiki-*, proj-*, using-skillwiki) backed by the deterministic `skillwiki` CLI (8 subcommands, JSON-by-default).",
   "author": {

package/skills/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillwiki/skills",
-  "version": "0.2.0-beta.25",
+  "version": "0.2.0-beta.26",
   "private": true,
   "files": [
     "wiki-*",