skillwiki 0.2.0-beta.8 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.2.0-beta.8",
+  "version": "0.2.0",
   "type": "module",
   "bin": {
     "skillwiki": "dist/cli.js"
@@ -15,7 +15,8 @@
     "build": "tsup && rm -rf ./skills && cp -r ../skills ./skills",
     "test": "vitest run",
     "test:watch": "vitest",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
   },
   "dependencies": {
     "commander": "^12.1.0",

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

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.2.0-beta.8",
+  "version": "0.2.0",
   "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/bin/skillwiki

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+# skillwiki CLI wrapper — delegates to npx so the CLI is available
+# automatically when this plugin is enabled (Claude Code adds bin/ to PATH).
+set -euo pipefail
+exec npx -y skillwiki@beta "$@"

package/skills/package.json

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

package/skills/proj-decide/SKILL.md

@@ -13,7 +13,7 @@ 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.
-2. `npx skillwiki validate <adr>`. If non-zero, STOP.
+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

@@ -31,7 +31,7 @@ When reading retros as source material:
 2. **Step 2 — Generate.** Compose the vault concept page with
    `provenance: project` and
    `provenance_projects: ["[[slug]]"]`. Validate with
-   `npx skillwiki validate`.
+   `skillwiki validate`.
 3. **Backlink.** Set `promoted_to: "[[concept-slug]]"` on the source
    compound entry. For retro-sourced distillation, skip backlink (log.md
    entries are append-only) and instead add `sources:` citing the vault

package/skills/proj-work/SKILL.md

@@ -16,7 +16,7 @@ Standard four + project context (project README, last ~5 work logs).
 1. Determine `kind:` (feature | issue | refactor | decision) and slug.
 2. Create folder `projects/{slug}/work/YYYY-MM-DD-{work-slug}/`.
 3. Override default output paths for any nested skill: `spec.md`, `plan.md`, and `log.md` are written here, not at vault root.
-4. Validate work-item frontmatter via `npx skillwiki validate <spec.md>`. If non-zero, STOP.
+4. Validate work-item frontmatter via `skillwiki validate <spec.md>`. If non-zero, STOP.
 5. Manage status transitions: `planned` → `in-progress` → `completed` (set `completed:` date) or `abandoned`.
 6. Append vault `log.md` entry on creation and on each status transition.
 

package/skills/using-skillwiki/SKILL.md

@@ -25,6 +25,31 @@ Invoke a skillwiki skill when the user:
 - Has a spec/plan in a non-skillwiki format (CodeStable, RFC, AIDE)
 - Asks about their skillwiki configuration or setup health
 
+## Vault Structure
+
+A skillwiki vault has two layers:
+
+**Layer 1 — Raw (`raw/`):** Immutable source material. Never modify after ingest.
+
+```
+raw/
+├── articles/    # Web articles, clippings
+├── papers/      # PDFs, arxiv papers
+├── transcripts/ # Meeting notes, interviews
+└── assets/      # Images, diagrams referenced by sources
+```
+
+Raw frontmatter:
+```yaml
+---
+source_url: https://…
+ingested: YYYY-MM-DD
+sha256:          # computed by skillwiki hash over body bytes after closing ---
+---
+```
+
+**Layer 2 — Agent-owned pages:** `entities/`, `concepts/`, `comparisons/`, `queries/`, `meta/`, `projects/`. Citations use `^[raw/articles/source-file.md]` markers at paragraph-end.
+
 ## Skill Map
 
 | Skill | When to Invoke |
@@ -63,3 +88,35 @@ Run `skillwiki doctor` to diagnose setup issues. Run `skillwiki config list` to
 For longer-running project work, use `proj-init` → `proj-work` → `proj-distill` / `proj-decide`.
 
 Maintenance: **Archive** (`wiki-archive`) superseded pages, **Drift** (`wiki-reingest`) to detect stale sources, **Adapter** (`wiki-adapter-prd`) for foreign PRD format ingestion.
+
+## Multi-Wiki Profiles
+
+skillwiki supports named wiki profiles for working with multiple vaults. Set `WIKI_DEFAULT` to control which wiki all skills target by default.
+
+**Manage profiles:**
+- `skillwiki config set wiki.<name>.path <dir>` — register a profile
+- `skillwiki config set default <name>` — set active profile
+- `skillwiki config list --profiles` — list all profiles
+- `skillwiki --wiki <name> lint` — override per-command
+
+**Project-local override:** Place a `./skillwiki/.env` in a project root to bind that project to a specific wiki. Skills will use it automatically when running from that directory.
+
+## PRD Bridge — Redirect Spec/Plan Output to Vault
+
+When skillwiki is installed, **all spec and plan documents must land in the vault**, not in repo-local directories like `docs/superpowers/`. This applies to any PRD/design skill (superpowers:brainstorming, superpowers:writing-plans, CodeStable, AIDE, Hermes, etc.).
+
+**Rule:** Before a PRD skill writes a spec or plan file, redirect its save path:
+1. Resolve the vault path: `skillwiki path`
+2. If the cwd is inside a project (check for `projects/{slug}/` via `skillwiki path --init-time` or look for `./skillwiki/.env`), use that project's work directory
+3. Create or locate the work item via `proj-work`, which emits redirect paths for `spec.md` and `plan.md`
+4. Pass those vault paths to the PRD skill as its save location
+
+**Concrete overrides for superpowers:**
+- `superpowers:brainstorming` step 6: override `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md` → vault work-item `spec.md` path from `proj-work`
+- `superpowers:writing-plans` header: override `docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md` → vault work-item `plan.md` path from `proj-work`
+
+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`.
+
+**Never create `docs/superpowers/` in any repo.**

package/skills/wiki-archive/SKILL.md

@@ -24,7 +24,8 @@ Standard four reads (SCHEMA, index, log, project context if applicable).
 1. Identify the target page. Confirm with the user which page to archive (show full relPath).
 2. Run `skillwiki archive <page> [vault]`. Read the JSON output.
 3. Verify with `skillwiki index-check [vault]` — confirm no ghost entries remain.
-4. Append a `log.md` entry: `## [{date}] archive | {relPath} → _archive/{subdir}/`.
+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}/`.
 
 ## Reversibility
 

package/skills/wiki-audit/SKILL.md

@@ -19,7 +19,7 @@ Standard four reads.
 
 ## Steps
 0. **Resolve vault and language.** Run `skillwiki path` (fail if NO_VAULT_CONFIGURED) and `skillwiki lang`.
-1. `npx skillwiki audit <page>`. Read the JSON report.
+1. `skillwiki audit <page>`. Read the JSON report.
 2. Reason over the report:
    - For each unresolved marker: suggest ingesting the missing source or correcting the path.
    - For each `unused_sources` entry: suggest adding a body marker or removing from `sources:`.

package/skills/wiki-crystallize/SKILL.md

@@ -22,7 +22,7 @@ Standard four reads. If cwd is inside `projects/{slug}/`, also read project READ
 1. Identify type: entity / concept / comparison / query / summary.
 2. Set `provenance:`. Default `research`. If in project context: `project` with `provenance_projects: ["[[slug]]"]`.
 3. Compose the page with citations pre-attached. Reuse existing `raw/` sources where possible.
-4. `npx skillwiki validate <page>`. If non-zero, STOP.
+4. `skillwiki validate <page>`. If non-zero, STOP.
 5. Apply writes: page → `index.md` → `log.md`.
 
 ## Stop conditions

package/skills/wiki-ingest/SKILL.md

@@ -23,11 +23,11 @@ Run `skillwiki lang` at the start. Generate page-body prose, narrative sections,
 
 ## Steps (in order — N6, N7, N8)
 0. **Resolve vault and language.** Run `skillwiki path` (fail if NO_VAULT_CONFIGURED) and `skillwiki lang`. Use the resolved vault path for all writes; use the canonical language for all generated prose.
-1. **Guard.** For each URL: run `npx skillwiki fetch-guard <url>`. If exit ≠ 0, STOP and surface the error. Do not retry.
+1. **Guard.** For each URL: run `skillwiki fetch-guard <url>`. If exit ≠ 0, STOP and surface the error. Do not retry.
 2. **Fetch.** Use `web_fetch` (or read local file) under Layer 2 controls (the CLI Layer 2 fetcher applies in tests; in skill runtime use `web_fetch` directly and treat any error as STOP).
-3. **Hash.** Write the raw file (frontmatter + body). Run `npx skillwiki hash <raw-file>` and embed the result in raw frontmatter `sha256:`.
+3. **Hash.** Write the raw file (frontmatter + body). Run `skillwiki hash <raw-file>` and embed the result in raw frontmatter `sha256:`.
 4. **Generate page(s).** Compose typed-knowledge page(s) with citations pre-attached (`^[raw/...]` markers).
-5. **Validate.** For each generated page: run `npx skillwiki validate <page>`. If exit ≠ 0, STOP — do not write index/log.
+5. **Validate.** For each generated page: run `skillwiki validate <page>`. If exit ≠ 0, STOP — do not write index/log.
 6. **Apply writes in order.** raw → page(s) → `index.md` → `log.md`.
 7. **Confidence flag.** If only one source is cited, set `confidence: low`.
 

package/skills/wiki-lint/SKILL.md

@@ -18,7 +18,7 @@ Standard four reads.
 
 0. Resolve vault: `skillwiki path` (record source for context).
 1. Run `skillwiki lint <vault>`. Read the JSON.
-2. Reason over findings; present grouped by severity with concrete suggested actions per kind.
+2. Reason over findings; present grouped by severity with concrete suggested actions per kind. If the CLI was recently updated with new lint checks, re-running lint on the full vault may flag pre-existing pages that predate the new rule — treat these as legitimate findings, not false positives.
 3. If `log_rotate_needed` is present and the user consents, run `skillwiki log-rotate <vault> --apply`. Otherwise leave alone.
 4. Append one `log.md` entry summarizing the lint counts (errors/warnings/info).
 

package/skills/wiki-query/SKILL.md

@@ -20,8 +20,8 @@ Standard four reads (SCHEMA, index, log, project context if applicable).
 ## Steps
 0. **Resolve vault and language.** Run `skillwiki path` (fail if NO_VAULT_CONFIGURED) and `skillwiki lang`.
 1. **Determine scope.** Ask the user once if ambiguous: vault | current project | project+concepts.
-2. **Refresh graph.** If `.skillwiki/graph.json` is missing or older than 24h: `npx skillwiki graph build <vault>`.
-3. **Compute overlap.** `npx skillwiki overlap <vault>`.
+2. **Refresh graph.** If `.skillwiki/graph.json` is missing or older than 24h: `skillwiki graph build <vault>`.
+3. **Compute overlap.** `skillwiki overlap <vault>`.
 4. **Score candidates** in prompt using the 4 signals:
    - Direct wikilink: 3.0×
    - Source overlap: 4.0× (read from overlap output)

package/templates/SCHEMA.md

@@ -49,7 +49,8 @@ Rule: every tag on every page MUST appear in this taxonomy. Add new tags here fi
 
 - File names: lowercase-hyphenated, no spaces.
 - Wikilinks in YAML: quoted, `"[[name]]"`. Body wikilinks: unquoted `[[name]]`.
-- Citations in body: `^[raw/...]` markers; every entry in `sources:` MUST appear in body.
+- Citations in body: `^[raw/...]` markers at paragraph-end; every entry in `sources:` MUST appear in body and in `## Sources` footer.
+- Legacy inline `^[raw/...]` markers remain valid; `migrate-citations` converts them.
 - sha256 in `raw/` frontmatter is computed by `skillwiki hash` over body bytes after closing `---`.
 
 ## Obsidian Integration