skillwiki 0.10.28 → 0.10.30

package/dist/{chunk-W7NPTDIU.js → chunk-6EEI6REK.js}

@@ -4817,19 +4817,24 @@ async function runQuery(input) {
     });
   }
   const seedPaths = /* @__PURE__ */ new Set();
+  const operationalSeedPaths = /* @__PURE__ */ new Set();
   let historicalCyclePageCount = 0;
   let hasDirectOperationalSeed = false;
   for (const page of pages) {
     if (page.historicalCycle) historicalCyclePageCount += 1;
     if (page.keywordScore <= 0) continue;
     seedPaths.add(page.relPath);
-    if (!page.historicalCycle) hasDirectOperationalSeed = true;
+    if (!page.historicalCycle) {
+      operationalSeedPaths.add(page.relPath);
+      hasDirectOperationalSeed = true;
+    }
   }
   const suppressRepetitiveHistoricalCycles = historicalCyclePageCount >= 3 && hasDirectOperationalSeed;
+  const structuralSeedPaths = suppressRepetitiveHistoricalCycles ? operationalSeedPaths : seedPaths;
   const results = pages.map((page) => {
-    const sourceOverlap = scoreSourceOverlap(page, pages, seedPaths);
-    const wikilink = scoreWikilink(page.relPath, seedPaths, graph);
-    const aa = scoreAdamicAdar(page.relPath, seedPaths, graph);
+    const sourceOverlap = scoreSourceOverlap(page, pages, structuralSeedPaths);
+    const wikilink = scoreWikilink(page.relPath, structuralSeedPaths, graph);
+    const aa = scoreAdamicAdar(page.relPath, structuralSeedPaths, graph);
     const typeAffinity = scoreTypeAffinity(page.type, queryTerms);
     const isSeed = page.keywordScore > 0;
     const structuralBoost = sourceOverlap * W_SOURCE_OVERLAP + wikilink * W_WIKILINK + aa * W_ADAMIC_ADAR;

package/dist/cli.js

@@ -38,7 +38,7 @@ import {
   scanConflictMarkerBlocksInText,
   snapshotterHealthChecks,
   upsertIndexEntry
-} from "./chunk-W7NPTDIU.js";
+} from "./chunk-6EEI6REK.js";
 import {
   normalizeDistTag,
   readCache,

package/dist/skillwiki-mcp.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runSkillwikiMcpStdio
-} from "./chunk-W7NPTDIU.js";
+} from "./chunk-6EEI6REK.js";
 import "./chunk-7I2TPIV5.js";
 import "./chunk-OJVIND5D.js";
 import "./chunk-5XQWYC5K.js";

package/package.json

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

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

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.28",
+  "version": "0.10.30",
   "skills": "./",
   "description": "Project-aware Karpathy-style knowledge base for Claude Code: 19 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.10.28",
+  "version": "0.10.30",
   "description": "Project-aware Karpathy-style knowledge base for Codex with 19 prompt-only skills backed by the deterministic skillwiki CLI.",
   "author": {
     "name": "karlorz",

package/skills/agents/proj-decide.md

@@ -1,7 +1,7 @@
 ---
 name: proj-decide
 description: Use this agent when recording architectural decisions during automated maintenance cycles. Typical triggers include dev-loop IDLE DISCOVERY maintenance, capturing design decisions from work items, or generalizing decisions into concept pages. See "When to invoke" in the agent body for worked scenarios.
-model: sonnet
+model: inherit
 color: yellow
 tools: ["Read", "Write", "Edit", "Bash", "Grep", "Glob"]
 ---

package/skills/agents/proj-work.md

@@ -1,7 +1,7 @@
 ---
 name: proj-work
 description: Use this agent when creating or executing work items during automated development cycles. Typical triggers include dev-loop work item creation from captured tasks, executing existing work items, or managing status transitions. See "When to invoke" in the agent body for worked scenarios.
-model: sonnet
+model: inherit
 color: green
 tools: ["Read", "Write", "Edit", "Bash", "Grep", "Glob"]
 ---

package/skills/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillwiki/skills",
-  "version": "0.10.28",
+  "version": "0.10.30",
   "private": true,
   "files": [
     "wiki-*",

package/skills/proj-decide/SKILL.md

@@ -5,6 +5,14 @@ description: Write an Architectural Decision Record (ADR). If the decision gener
 
 # proj-decide
 
+## Model routing
+
+`proj-decide` authors architectural decisions and ADRs, so its companion
+agent must run at the invoking main-agent model. Keep `model: inherit` in
+`packages/skills/agents/proj-decide.md`; do not pin decision-making work to
+`sonnet`, `haiku`, or `opus`. Do not add a `model` field to this `SKILL.md`
+frontmatter.
+
 ## When to invoke
 - User commits to an architectural decision worth recording for future reference.
 

package/skills/proj-work/SKILL.md

@@ -5,6 +5,13 @@ description: Open or run a work item under projects/{slug}/work/YYYY-MM-DD-{slug
 
 # proj-work
 
+## Model routing
+
+`proj-work` authors implementation specifications and plans, so its companion
+agent must run at the invoking main-agent model. Keep `model: inherit` in
+`packages/skills/agents/proj-work.md`; do not pin planning work to `sonnet`,
+`haiku`, or `opus`. Do not add a `model` field to this `SKILL.md` frontmatter.
+
 ## When to invoke
 - User starts a feature, issue, refactor, or decision inside an existing project.
 - User asks to "get work of X" or "run work item Y" to review/execute an existing item.

package/skills/skills/proj-decide/SKILL.md

@@ -5,6 +5,14 @@ description: Write an Architectural Decision Record (ADR). If the decision gener
 
 # proj-decide
 
+## Model routing
+
+`proj-decide` authors architectural decisions and ADRs, so its companion
+agent must run at the invoking main-agent model. Keep `model: inherit` in
+`packages/skills/agents/proj-decide.md`; do not pin decision-making work to
+`sonnet`, `haiku`, or `opus`. Do not add a `model` field to this `SKILL.md`
+frontmatter.
+
 ## When to invoke
 - User commits to an architectural decision worth recording for future reference.
 

package/skills/skills/proj-work/SKILL.md

@@ -5,6 +5,13 @@ description: Open or run a work item under projects/{slug}/work/YYYY-MM-DD-{slug
 
 # proj-work
 
+## Model routing
+
+`proj-work` authors implementation specifications and plans, so its companion
+agent must run at the invoking main-agent model. Keep `model: inherit` in
+`packages/skills/agents/proj-work.md`; do not pin planning work to `sonnet`,
+`haiku`, or `opus`. Do not add a `model` field to this `SKILL.md` frontmatter.
+
 ## When to invoke
 - User starts a feature, issue, refactor, or decision inside an existing project.
 - User asks to "get work of X" or "run work item Y" to review/execute an existing item.

package/skills/skills/using-skillwiki/SKILL.md

@@ -17,6 +17,17 @@ Use this section as procedural planning guidelines:
 3. If `prd_layer` is `manual` or `none`, do not force the gate; follow project policy.
 4. Always apply the PRD bridge: spec/plan outputs go to vault work-item paths, never `docs/superpowers/`.
 
+## Activation File (Cross-Harness Alternative to SessionStart)
+
+On harnesses where the SessionStart hook does not fire (Grok, Codex), SkillWiki activation context is delivered via a compact file installed at session start. Run `npm run install:activation` from the repo to install:
+
+- `~/.grok/skillwiki.md` and `~/.claude/skillwiki.md` - compact derivative (~31 lines) covering identity, CLI probe, skill map, PRD bridge, fail-closed boundary, and drift warning.
+- `~/.grok/AGENTS.md` and `~/.claude/CLAUDE.md` - prepended with a marker-wrapped reference: `Read @skillwiki.md for SkillWiki activation context.`
+
+The activation file is self-contained literal text (ADR-3). On harnesses with `@file` import support (Claude Code, Cursor, Gemini), the reference is inlined automatically. On harnesses without it (Grok, Codex), the agent reads the file manually.
+
+The template lives at `packages/skills/using-skillwiki/activation.md`. Run `npm run install:activation:check` to verify the installed copy matches the template.
+
 ## When to Use These Skills
 Invoke a skillwiki skill when the user:
 - Wants to create, build, or start a vault/wiki/knowledge base

package/skills/skills/using-skillwiki/activation.md

@@ -0,0 +1,57 @@
+# SkillWiki Activation
+
+You have SkillWiki - a project-aware knowledge-base CLI + skill suite for agent harnesses.
+This file is loaded at session start. For full operational detail, invoke `/using-skillwiki`.
+
+## CLI Probe
+
+If `skillwiki --help` fails, the CLI is unavailable. Degrade to manual file ops (grep/find) for read-only queries. Fail closed for managed mutations - never write typed pages, index, or log directly.
+
+## When to Route
+
+Invoke a SkillWiki skill when the user: wants vault/wiki/knowledge-base operations, ingests sources or URLs, searches/queries vault content, runs health checks or lint, crystallizes a session, works with project workspaces/ADRs, captures ideas/bugs/tasks, archives pages, removes paths, detects source drift, ingests foreign PRD formats, syncs vault git, or visualizes the vault graph.
+
+## Skill Map
+
+| Skill | When to Invoke |
+|-------|----------------|
+| `wiki-init` | Bootstrap a vault |
+| `wiki-ingest` | Convert URLs/files/text into typed-knowledge pages |
+| `wiki-query` | Search typed knowledge |
+| `wiki-lint` | Vault health and lint checks |
+| `wiki-crystallize` | Distill current session into a typed page |
+| `wiki-audit` | Verify raw provenance and source integrity |
+| `wiki-archive` | Archive typed pages or preserve-move raw sources |
+| `wiki-remove` | Hard-delete vault paths without snapshot resurrection |
+| `wiki-reingest` | Detect source drift and re-ingest updated content |
+| `wiki-add-task` | Quick-capture ideas, bugs, tasks, notes |
+| `wiki-adapter-prd` | Map foreign PRD formats (CodeStable, RFC, AIDE, Hermes) |
+| `wiki-sync` | Safely sync vault git repository |
+| `wiki-canvas` | Generate Obsidian Canvas visualization |
+| `wiki-gate-plan-mode` | Toggle EnterPlanMode gating for superpowers planning |
+| `proj-init` | Bootstrap a project workspace |
+| `proj-work` | Open or run a work item |
+| `proj-distill` | Distill project compound entries into concept pages |
+| `proj-decide` | Write an Architectural Decision Record (ADR) |
+| `dev-loop:research` | Research scan of repo + vault health |
+
+## PRD Bridge
+
+Route PRD/spec/plan work to `wiki-adapter-prd` and `proj-work`, not `docs/superpowers/`. Spec and plan outputs must land in vault work-item paths. Never create `docs/superpowers/` in any repo.
+
+## Fail-Closed Boundary
+
+Never write typed pages, `index.md`, or `log.md` directly. Never bare `rm` or `git rm` as a fleet delete (snapshot resurrects from S3). Never auto `npm install -g skillwiki` in headless/goal/satellite sessions. If `skillwiki page publish --help` is unavailable, fail closed.
+
+## Sensitive Content
+
+Never commit secrets, credentials, API keys, tokens, passwords, or PII to the vault. Redact using `[REDACTED:<kind>]` before filing.
+
+## Drift Warning
+
+If `skillwiki doctor` mentions a version newer than this file, re-read the full `/using-skillwiki` skill for updated content.
+
+## Canonical Paths
+
+- Full skill: `packages/skills/using-skillwiki/SKILL.md`
+- Vault schema: `SCHEMA.md` at the vault root (run `skillwiki path` to resolve)

package/skills/using-skillwiki/SKILL.md

@@ -17,6 +17,17 @@ Use this section as procedural planning guidelines:
 3. If `prd_layer` is `manual` or `none`, do not force the gate; follow project policy.
 4. Always apply the PRD bridge: spec/plan outputs go to vault work-item paths, never `docs/superpowers/`.
 
+## Activation File (Cross-Harness Alternative to SessionStart)
+
+On harnesses where the SessionStart hook does not fire (Grok, Codex), SkillWiki activation context is delivered via a compact file installed at session start. Run `npm run install:activation` from the repo to install:
+
+- `~/.grok/skillwiki.md` and `~/.claude/skillwiki.md` - compact derivative (~31 lines) covering identity, CLI probe, skill map, PRD bridge, fail-closed boundary, and drift warning.
+- `~/.grok/AGENTS.md` and `~/.claude/CLAUDE.md` - prepended with a marker-wrapped reference: `Read @skillwiki.md for SkillWiki activation context.`
+
+The activation file is self-contained literal text (ADR-3). On harnesses with `@file` import support (Claude Code, Cursor, Gemini), the reference is inlined automatically. On harnesses without it (Grok, Codex), the agent reads the file manually.
+
+The template lives at `packages/skills/using-skillwiki/activation.md`. Run `npm run install:activation:check` to verify the installed copy matches the template.
+
 ## When to Use These Skills
 Invoke a skillwiki skill when the user:
 - Wants to create, build, or start a vault/wiki/knowledge base

package/skills/using-skillwiki/activation.md

@@ -0,0 +1,57 @@
+# SkillWiki Activation
+
+You have SkillWiki - a project-aware knowledge-base CLI + skill suite for agent harnesses.
+This file is loaded at session start. For full operational detail, invoke `/using-skillwiki`.
+
+## CLI Probe
+
+If `skillwiki --help` fails, the CLI is unavailable. Degrade to manual file ops (grep/find) for read-only queries. Fail closed for managed mutations - never write typed pages, index, or log directly.
+
+## When to Route
+
+Invoke a SkillWiki skill when the user: wants vault/wiki/knowledge-base operations, ingests sources or URLs, searches/queries vault content, runs health checks or lint, crystallizes a session, works with project workspaces/ADRs, captures ideas/bugs/tasks, archives pages, removes paths, detects source drift, ingests foreign PRD formats, syncs vault git, or visualizes the vault graph.
+
+## Skill Map
+
+| Skill | When to Invoke |
+|-------|----------------|
+| `wiki-init` | Bootstrap a vault |
+| `wiki-ingest` | Convert URLs/files/text into typed-knowledge pages |
+| `wiki-query` | Search typed knowledge |
+| `wiki-lint` | Vault health and lint checks |
+| `wiki-crystallize` | Distill current session into a typed page |
+| `wiki-audit` | Verify raw provenance and source integrity |
+| `wiki-archive` | Archive typed pages or preserve-move raw sources |
+| `wiki-remove` | Hard-delete vault paths without snapshot resurrection |
+| `wiki-reingest` | Detect source drift and re-ingest updated content |
+| `wiki-add-task` | Quick-capture ideas, bugs, tasks, notes |
+| `wiki-adapter-prd` | Map foreign PRD formats (CodeStable, RFC, AIDE, Hermes) |
+| `wiki-sync` | Safely sync vault git repository |
+| `wiki-canvas` | Generate Obsidian Canvas visualization |
+| `wiki-gate-plan-mode` | Toggle EnterPlanMode gating for superpowers planning |
+| `proj-init` | Bootstrap a project workspace |
+| `proj-work` | Open or run a work item |
+| `proj-distill` | Distill project compound entries into concept pages |
+| `proj-decide` | Write an Architectural Decision Record (ADR) |
+| `dev-loop:research` | Research scan of repo + vault health |
+
+## PRD Bridge
+
+Route PRD/spec/plan work to `wiki-adapter-prd` and `proj-work`, not `docs/superpowers/`. Spec and plan outputs must land in vault work-item paths. Never create `docs/superpowers/` in any repo.
+
+## Fail-Closed Boundary
+
+Never write typed pages, `index.md`, or `log.md` directly. Never bare `rm` or `git rm` as a fleet delete (snapshot resurrects from S3). Never auto `npm install -g skillwiki` in headless/goal/satellite sessions. If `skillwiki page publish --help` is unavailable, fail closed.
+
+## Sensitive Content
+
+Never commit secrets, credentials, API keys, tokens, passwords, or PII to the vault. Redact using `[REDACTED:<kind>]` before filing.
+
+## Drift Warning
+
+If `skillwiki doctor` mentions a version newer than this file, re-read the full `/using-skillwiki` skill for updated content.
+
+## Canonical Paths
+
+- Full skill: `packages/skills/using-skillwiki/SKILL.md`
+- Vault schema: `SCHEMA.md` at the vault root (run `skillwiki path` to resolve)