skillwiki 0.2.1-beta.27 → 0.2.1-beta.29

package/dist/cli.js

@@ -949,6 +949,7 @@ import { dirname as dirname3, resolve as resolve2, join as join5 } from "path";
 var FENCE2 = /```[\s\S]*?```/g;
 var INLINE_CODE = /``[^`\n]+``|`[^`\n]+`/g;
 var MARKER_RE = /\^\[(raw\/[^\]]+)\]/g;
+var FRONTMATTER = /^---\n[\s\S]*?\n---\n?/;
 function stripFences(body) {
   return body.replace(FENCE2, "").replace(INLINE_CODE, "");
 }
@@ -971,7 +972,7 @@ function isLegacyCitationStyle(body) {
   const markers = extractCitationMarkers(body);
   if (markers.length === 0) return false;
   if (!hasSourcesFooter(body)) return true;
-  const lines = stripFences(body).split("\n");
+  const lines = stripFences(body.replace(FRONTMATTER, "")).split("\n");
   let inSources = false;
   let lastNonBlankWasTable = false;
   for (const line of lines) {
@@ -992,12 +993,12 @@ function isLegacyCitationStyle(body) {
     const afterLast = line.slice(lastMatch.index + lastMatch[0].length).replace(MARKER_RE, "").trim();
     if (afterLast.length > 0) return true;
     const beforeFirst = line.slice(0, matches[0].index).trim();
-    if (beforeFirst.length > 0 && !/[.!?]\s*$/.test(beforeFirst)) return true;
+    if (beforeFirst.length > 0 && !/[.!?]["'"]*\s*$/.test(beforeFirst)) return true;
   }
   return false;
 }
 function hasOrphanedCitations(body) {
-  const stripped = stripFences(body);
+  const stripped = stripFences(body.replace(FRONTMATTER, ""));
   const lines = stripped.split("\n");
   let inSources = false;
   let sourcesEnded = false;
@@ -1030,7 +1031,8 @@ function hasOrphanedCitations(body) {
   }
   if (sourcesStartLine === -1) return false;
   if (sourcesEnded) {
-    for (let i = lastNonBlankInSources + 1; i < lines.length; i++) {
+    const scanStart = Math.max(lastNonBlankInSources + 1, sourcesStartLine + 1);
+    for (let i = scanStart; i < lines.length; i++) {
       if (/\^\[raw\//.test(lines[i])) {
         return true;
       }
@@ -2432,7 +2434,6 @@ async function runLint(input) {
           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;
@@ -2443,23 +2444,22 @@ async function runLint(input) {
               newBodyLines.push(line);
               continue;
             }
+            INLINE_MARKER.lastIndex = 0;
             const lineWithoutMarkers = line.replace(INLINE_MARKER, "").trim();
+            INLINE_MARKER.lastIndex = 0;
             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)) {
+              if (midRe.test(cleaned)) {
                 cleaned = cleaned.replace(midRe, "");
-                seen.add(marker);
               }
             }
             newBodyLines.push(cleaned);
@@ -3233,7 +3233,7 @@ async function runArchive(input) {
         indexUpdated = true;
       }
     } catch (e) {
-      if (e?.code !== "ENOENT") throw e;
+      if (e instanceof Error && "code" in e && e.code !== "ENOENT") throw e;
     }
   }
   await rename4(join22(input.vault, relPath), join22(input.vault, archivePath));
@@ -3263,7 +3263,7 @@ async function controlledFetch(url, opts) {
       res = await fetch(current, { redirect: "manual", signal: ctrl.signal });
     } catch (e) {
       clearTimeout(timer);
-      if (e?.name === "AbortError") return err("FETCH_TIMEOUT", { url: current });
+      if (e instanceof Error && e.name === "AbortError") return err("FETCH_TIMEOUT", { url: current });
       return err("FETCH_FAILED", { message: String(e) });
     }
     clearTimeout(timer);

package/package.json

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

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

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.2.1-beta.27",
+  "version": "0.2.1-beta.29",
   "skills": "./",
   "description": "Project-aware Karpathy-style knowledge base for Claude Code: 19 prompt-only skills (wiki-*, proj-*, dev-loop-research, 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.27",
+  "version": "0.2.1-beta.29",
   "private": true,
   "files": [
     "wiki-*",

package/skills/proj-decide/SKILL.md

@@ -13,7 +13,7 @@ description: Write an Architectural Decision Record (ADR). If the decision gener
 Standard four + project context.
 
 ## Steps
-1. Compose the ADR in `projects/{slug}/architecture/YYYY-MM-DD-{adr-slug}.md`. Frontmatter: kind=decision, status=in-progress or completed, project link.
+1. Compose the ADR in `projects/{slug}/architecture/YYYY-MM-DD-{adr-slug}.md`. Frontmatter: kind=decision, status=in-progress or completed, project link. If no project context exists, default to `playground`.
 2. `skillwiki validate <adr>`. If non-zero, STOP.
 3. **Generalization check.** If the decision applies beyond this project, create a `concepts/` page with `provenance: project` (or `mixed` if research-informed).
 4. Apply writes: ADR → (optional) concept page → vault `index.md` → vault `log.md` and project `log.md`.

package/skills/proj-distill/SKILL.md

@@ -16,7 +16,7 @@ Standard four + project context.
 
 ### Source selection
 
-Check `projects/{slug}/compound/` first. If empty, fall back to retro
+Check `projects/{slug}/compound/` first. If no project context exists, default to `playground`. If empty, fall back to retro
 entries in vault `log.md` (lines matching `## [YYYY-MM-DD] retro`).
 
 When reading retros as source material:

package/skills/proj-work/SKILL.md

@@ -9,6 +9,7 @@ description: Open or run a work item under projects/{slug}/work/YYYY-MM-DD-{slug
 ## When to invoke
 - User starts a feature, issue, refactor, or decision inside an existing project.
 - Brainstorming or writing-plans skills would otherwise default-write outside the project tree.
+- If no project context can be determined, default to the `playground` slug so redirect paths always emit and the PRD bridge chain works.
 
 ## Pre-orientation reads
 Standard four + project context (project README, last ~5 work logs).

package/skills/using-skillwiki/SKILL.md

@@ -139,6 +139,6 @@ When skillwiki is installed, **all spec and plan documents must land in the vaul
 
 Both skills say "User preferences for spec location override this default" — the vault work-item path IS the override.
 
-**If no project context exists** (standalone vault, not inside a project), save specs/plans directly under the vault root with the PRD skill's default naming, e.g. `<vault>/specs/YYYY-MM-DD-<slug>.md`.
+**If no project context exists** (standalone vault, not inside a project), default to the `playground` project slug. Invoke `proj-work` with `playground` as the slug so redirect paths are emitted normally and the PRD bridge chain works. The `playground` project is a pre-initialized catch-all workspace at `projects/playground/` for exploratory work, experiments, and unclassified features. Work items that mature can be moved to a real project later.
 
 **Never create `docs/superpowers/` in any repo.**

package/skills/wiki-archive/SKILL.md

@@ -26,7 +26,8 @@ Standard four reads (SCHEMA, index, log, project context if applicable).
 2. Run `skillwiki archive <page> [vault]`. Read the JSON output.
 3. Verify with `skillwiki index-check [vault]` — confirm no ghost entries remain.
 4. Run `skillwiki lint [vault]` — check for broken wikilinks from other pages that still reference the archived page. If found, update those pages to point to the replacement or remove the stale link.
-5. Append a `log.md` entry: `## [{date}] archive | {relPath} → _archive/{subdir}/`.
+5. **Raw file archiving (N9 Reingest Protocol only):** When archiving a `raw/` file due to content drift, update ALL `^[raw/...]` citation markers and `sources:` frontmatter entries that reference the old path. Change `raw/articles/foo.md` to `_archive/raw/articles/foo.md` in every referencing page. Verify with `skillwiki audit` that no broken markers remain.
+6. Append a `log.md` entry: `## [{date}] archive | {relPath} → _archive/{subdir}/`.
 
 ## Reversibility
 
@@ -39,6 +40,7 @@ Archiving is reversible: move the file back from `_archive/` to its original dir
 
 ## Forbidden
 
-- Archiving `raw/` files (N9 — raw is immutable).
+- Archiving `raw/` files outside the N9 Reingest Protocol (raw is immutable except during content-drift reingestion).
+- Archiving raw files without updating all `^[raw/...]` citation markers that reference them.
 - Archiving without user confirmation.
 - Deleting files (archive moves, never deletes).

package/skills/wiki-crystallize/SKILL.md

@@ -33,3 +33,4 @@ Standard four reads. If cwd is inside `projects/{slug}/`, also read project READ
 ## Forbidden
 - Filing without explicit `provenance:`.
 - Updating `index.md` before `validate` passes.
+- Writing `[[wikilinks]]` to pages that don't exist in the vault. Before linking, verify the target exists: check `index.md` or `ls` the target directory. If the target doesn't exist yet, use plain text instead of a wikilink.

package/skills/wiki-ingest/SKILL.md

@@ -46,6 +46,7 @@ Run `skillwiki lang` at the start. Generate page-body prose, narrative sections,
 - Skipping `fetch-guard`.
 - Updating `index.md` or `log.md` before all pages validate.
 - Modifying any existing file in `raw/`.
+- Writing `[[wikilinks]]` to pages that don't exist in the vault. Before linking, verify the target exists: check `index.md` or `ls` the target directory. If the target doesn't exist yet, use plain text instead of a wikilink.
 
 ## Batch Mode