skillwiki 0.7.0 → 0.8.0

package/dist/cli.js

@@ -2364,7 +2364,7 @@ Chronological action log. Newest entries last. Skill writes append entries; lint
 
 // src/commands/lint.ts
 import { existsSync as existsSync3 } from "fs";
-import { readFile as readFile15 } from "fs/promises";
+import { readFile as readFile15, rename as rename5 } from "fs/promises";
 import { join as join19 } from "path";
 
 // src/commands/topic-map-check.ts
@@ -2607,6 +2607,60 @@ async function runRawBodyDedup(vault) {
   };
 }
 
+// src/commands/path-too-long.ts
+var MAX_PATH_LENGTH = 240;
+async function runPathTooLong(input) {
+  const scan = await scanVault(input.vault);
+  if (!scan.ok) return { exitCode: ExitCode.VAULT_PATH_INVALID, result: scan };
+  const allPages = [...scan.data.typedKnowledge, ...scan.data.raw, ...scan.data.workItems, ...scan.data.compound];
+  const violations = [];
+  for (const page of allPages) {
+    if (page.relPath.length > MAX_PATH_LENGTH) {
+      violations.push({ relPath: page.relPath, length: page.relPath.length });
+    }
+  }
+  if (violations.length > 0) {
+    return {
+      exitCode: ExitCode.LINT_HAS_ERRORS,
+      result: ok({
+        violations,
+        humanHint: violations.map((v) => `${v.relPath}: ${v.length} chars (max ${MAX_PATH_LENGTH})`).join("\n")
+      })
+    };
+  }
+  return { exitCode: ExitCode.OK, result: ok({ violations, humanHint: "all paths within length limit" }) };
+}
+function truncateFilename(relPath, maxLength = MAX_PATH_LENGTH) {
+  if (relPath.length <= maxLength) return relPath;
+  const lastSlash = relPath.lastIndexOf("/");
+  const dir = lastSlash >= 0 ? relPath.slice(0, lastSlash) : "";
+  const filename = lastSlash >= 0 ? relPath.slice(lastSlash + 1) : relPath;
+  const hash = computeShortHash(relPath);
+  const ext = filename.endsWith(".md") ? ".md" : "";
+  const base = filename.endsWith(".md") ? filename.slice(0, -3) : filename;
+  const suffix = `-${hash}${ext}`;
+  const dirPrefix = dir ? dir + "/" : "";
+  const maxPrefixLen = maxLength - dirPrefix.length - suffix.length;
+  if (maxPrefixLen <= 0) {
+    const fallback = dirPrefix + hash + ext;
+    if (fallback.length > maxLength) {
+      const dirBudget = maxLength - suffix.length;
+      return dirPrefix.slice(0, Math.max(0, dirBudget)) + suffix;
+    }
+    return fallback;
+  }
+  const prefix = base.slice(0, maxPrefixLen).replace(/[-_\s]+$/, "");
+  return dirPrefix + prefix + suffix;
+}
+function computeShortHash(input) {
+  let hash = 2166136261;
+  for (let i = 0; i < input.length; i++) {
+    hash ^= input.charCodeAt(i);
+    hash = Math.imul(hash, 16777619);
+  }
+  return (hash >>> 0).toString(16).padStart(8, "0").slice(0, 8);
+}
+
 // src/utils/cli-surface.ts
 import { Command } from "commander";
 function buildCliSurface() {
@@ -2779,7 +2833,7 @@ function extractSourceEntries(rawFm) {
   }
   return entries;
 }
-var ERROR_ORDER = ["broken_wikilinks", "invalid_frontmatter", "raw_dedup", "broken_sources", "tag_not_in_taxonomy"];
+var ERROR_ORDER = ["broken_wikilinks", "invalid_frontmatter", "raw_dedup", "broken_sources", "tag_not_in_taxonomy", "path_too_long"];
 var WARNING_ORDER = ["raw_body_duplicate", "raw_subdirectory_duplicate", "file_source_url", "index_incomplete", "index_link_format", "stale_page", "page_too_large", "log_rotate_needed", "orphans", "compound_refs", "legacy_citation_style", "orphaned_citations", "duplicate_frontmatter", "work_item_health", "orphaned_project_pages", "missing_overview", "missing_diagram"];
 var INFO_ORDER = ["bridges", "page_structure", "topic_map_recommended", "frontmatter_wikilink", "wikilink_citation", "missing_tldr", "stale_sections", "cli_refs"];
 async function runLint(input) {
@@ -2839,6 +2893,8 @@ async function runLint(input) {
   }
   const compoundRefs = await validateCompoundReferences(input.vault);
   if (compoundRefs.ok && compoundRefs.data.length > 0) buckets.compound_refs = compoundRefs.data;
+  const pathCheck = await runPathTooLong({ vault: input.vault });
+  if (pathCheck.result.ok && pathCheck.result.data.violations.length > 0) buckets.path_too_long = pathCheck.result.data.violations;
   const scan = await scanVault(input.vault);
   const allPages = scan.ok ? [...scan.data.typedKnowledge, ...scan.data.raw, ...scan.data.workItems, ...scan.data.compound] : [];
   const slugs = scan.ok ? buildSlugMap(allPages) : /* @__PURE__ */ new Map();
@@ -3353,6 +3409,45 @@ ${newBody}`;
         else delete buckets.file_source_url;
       }
     }
+    const pathViolations = buckets.path_too_long;
+    if (input.fix && pathViolations && pathViolations.length > 0) {
+      const pathFixed = [];
+      for (const v of pathViolations) {
+        try {
+          const absPath = `${input.vault}/${v.relPath}`;
+          const newRelPath = truncateFilename(v.relPath);
+          const newAbsPath = `${input.vault}/${newRelPath}`;
+          await rename5(absPath, newAbsPath);
+          const oldPathEscaped = v.relPath.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+          for (const page of allPages) {
+            if (page.relPath === v.relPath) continue;
+            const content = await readFile15(page.absPath, "utf8");
+            if (!content.includes(v.relPath)) continue;
+            let updated = content;
+            const citationRe = new RegExp(`\\^\\[${oldPathEscaped}\\]`, "g");
+            updated = updated.replace(citationRe, `^[${newRelPath}]`);
+            const wikilinkRe = new RegExp(`\\[\\[${oldPathEscaped}(\\|[^\\]]*)?\\]\\]`, "g");
+            updated = updated.replace(wikilinkRe, (_m, alias) => `[[${newRelPath}${alias ?? ""}]]`);
+            if (updated !== content) {
+              const w = await safeWritePage(page.absPath, updated);
+              if (!w.ok) {
+                unresolved.push(`${page.relPath} (rewire)`);
+              }
+            }
+          }
+          pathFixed.push(v.relPath);
+        } catch {
+          unresolved.push(v.relPath);
+        }
+      }
+      fixed.push(...pathFixed);
+      if (pathFixed.length > 0) {
+        const fixedSet = new Set(pathFixed);
+        const remaining = pathViolations.filter((v) => !fixedSet.has(v.relPath));
+        if (remaining.length > 0) buckets.path_too_long = remaining;
+        else delete buckets.path_too_long;
+      }
+    }
   }
   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] }] : []);
@@ -4712,7 +4807,7 @@ async function runDoctor(input) {
 }
 
 // src/commands/archive.ts
-import { rename as rename5, mkdir as mkdir8, readFile as readFile18, writeFile as writeFile9 } from "fs/promises";
+import { rename as rename6, mkdir as mkdir8, readFile as readFile18, writeFile as writeFile9 } from "fs/promises";
 import { join as join25, dirname as dirname9 } from "path";
 function countWikilinks(body, slug) {
   const escaped = slug.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -4825,7 +4920,7 @@ ${fmRewritten}
       if (e instanceof Error && "code" in e && e.code !== "ENOENT") throw e;
     }
   }
-  await rename5(join25(input.vault, relPath), join25(input.vault, archivePath));
+  await rename6(join25(input.vault, relPath), join25(input.vault, archivePath));
   appendLastOp(input.vault, {
     operation: input.cascade ? "archive-cascade" : "archive",
     summary: `moved ${relPath} to ${archivePath}${input.cascade ? ` (cascade: ${cascade?.source_array_refs.length ?? 0} source arrays updated)` : ""}`,
@@ -7791,7 +7886,7 @@ program.command("log-rotate [vault]").description("rotate or trim the vault log
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
   else emit(await runLogRotate({ vault: v.vault, threshold: opts.threshold, apply: !!opts.apply }), v.vault);
 });
-program.command("lint [vault]").description("run all vault health checks").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("--only <bucket>", "run only the specified lint bucket").option("--wiki <name>", "wiki profile name").action(async (vault, opts) => {
+program.command("lint [vault]").description("run all vault health checks").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 supported lint violations").option("--only <bucket>", "run only the specified lint bucket").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({

package/package.json

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

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

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "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.7.0",
+  "version": "0.8.0",
   "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.7.0",
+  "version": "0.8.0",
   "private": true,
   "files": [
     "wiki-*",

package/skills/wiki-add-task/SKILL.md

@@ -8,7 +8,7 @@ Capture ad-hoc ideas, bugs, tasks, and notes into the vault. Three entry points
 | Entry | When | What happens |
 |-------|------|-------------|
 | `/wiki-add-task <text>` | You're in a Claude Code session (NOT Hermes compact) | Creates `raw/transcripts/YYYY-MM-DD-{type}-{slug}.md` with ad-hoc capture frontmatter |
-| `skillwiki add-task <text>` | Hermes Agent compact mode | Same as above — compact-compatible CLI trigger |
+| Filesystem drop | Hermes Agent compact mode (no slash commands available) | Same as above — create `.md` in `raw/transcripts/`, dev-loop discovers it |
 | Filesystem drop | You're NOT in a Claude session (Obsidian, editor, sync) | Create any `.md` file in `raw/transcripts/` using the vault template — dev-loop discovers it on next cycle |
 | Dev-loop discovery | Automatic, next cycle | Scans `raw/transcripts/` for new files since last cycle, surfaces as claimable work |
 **Path Rule:** Captures ALWAYS go to `$(skillwiki path)/raw/transcripts/` (Layer 1). Never under `projects/{slug}/raw/` — that violates SCHEMA.md Layer 1 immutability.