skillwiki 0.10.48 → 0.10.49

package/dist/{chunk-S4NZQOXI.js → chunk-F7LXKP4T.js}

@@ -1734,6 +1734,82 @@ function checkDuplicateSkills(home) {
   const status = cliDuplicates.length > 0 ? "warn" : "info";
   return check(status, "skills_duplicate", "Skills not duplicated", parts.join("; "));
 }
+var GROK_ACTIVATION_REFERENCE = "Read @~/.grok/skillwiki.md for SkillWiki activation context.";
+var STALE_GROK_ACTIVATION_REFERENCE = "Read @skillwiki.md";
+var ACTIVATION_FIX_HINT = "run `npm run install:activation` from the llm-wiki repo";
+function findGrokActivationTemplate(home, cwd) {
+  if (cwd) {
+    const src = join10(cwd, "packages", "skills", "using-skillwiki", "activation.md");
+    if (existsSync7(src)) return src;
+  }
+  const pluginsRoot = join10(home, ".grok", "installed-plugins");
+  if (!existsSync7(pluginsRoot)) return void 0;
+  let entries;
+  try {
+    entries = readdirSync3(pluginsRoot, { withFileTypes: true });
+  } catch {
+    return void 0;
+  }
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const root = join10(pluginsRoot, entry.name);
+    for (const rel of ["using-skillwiki/activation.md", "skills/using-skillwiki/activation.md"]) {
+      const candidate = join10(root, rel);
+      if (existsSync7(candidate)) return candidate;
+    }
+  }
+  return void 0;
+}
+function checkGrokActivation(home, cwd) {
+  const grokDir = join10(home, ".grok");
+  if (!existsSync7(grokDir)) {
+    return check("pass", "activation_grok", "Grok activation", "Not a Grok host");
+  }
+  const activationPath = join10(grokDir, "skillwiki.md");
+  const agentsPath = join10(grokDir, "AGENTS.md");
+  const hasActivation = existsSync7(activationPath);
+  const issues = [];
+  if (!hasActivation) {
+    issues.push("~/.grok/skillwiki.md missing");
+  }
+  if (!existsSync7(agentsPath)) {
+    issues.push("~/.grok/AGENTS.md missing");
+  } else {
+    const agents = readFileSync6(agentsPath, "utf8");
+    const hasBegin = agents.includes("<!-- skillwiki:begin -->");
+    const hasExpected = agents.includes(GROK_ACTIVATION_REFERENCE);
+    const hasStale = agents.includes(STALE_GROK_ACTIVATION_REFERENCE);
+    if (!hasBegin) {
+      issues.push("AGENTS.md marker missing");
+    } else if (hasStale && !hasExpected) {
+      issues.push("AGENTS.md marker is stale (@skillwiki.md)");
+    } else if (!hasExpected) {
+      issues.push("AGENTS.md marker is stale");
+    }
+  }
+  if (hasActivation) {
+    const template = findGrokActivationTemplate(home, cwd);
+    if (template) {
+      try {
+        const installed = readFileSync6(activationPath, "utf8");
+        const expected = readFileSync6(template, "utf8");
+        if (installed !== expected) {
+          issues.push("~/.grok/skillwiki.md differs from template");
+        }
+      } catch {
+      }
+    }
+  }
+  if (issues.length > 0) {
+    return check(
+      "warn",
+      "activation_grok",
+      "Grok activation",
+      `${issues.join("; ")} \u2014 ${ACTIVATION_FIX_HINT}`
+    );
+  }
+  return check("pass", "activation_grok", "Grok activation", "Marker and compact file are current");
+}
 function checkNpmUpdate(home, currentVersion) {
   const { hasUpdate, latest, distTag } = latestFromCache(home, currentVersion);
   if (!latest) {
@@ -3259,6 +3335,7 @@ async function runDoctor(input) {
   checks.push(checkVfsCacheHealth(resolvedPath));
   checks.push(checkSkillsInstalled(input.home, input.cwd));
   checks.push(checkDuplicateSkills(input.home));
+  checks.push(checkGrokActivation(input.home, input.cwd));
   checks.push(checkNpmUpdate(input.home, input.currentVersion));
   checks.push(checkPluginVersionDrift(input.home, input.currentVersion, devSourceRun));
   checks.push(...vaultSyncChecks({

package/dist/cli.js

@@ -40,7 +40,7 @@ import {
   scanConflictMarkerBlocksInText,
   snapshotterHealthChecks,
   upsertIndexEntry
-} from "./chunk-S4NZQOXI.js";
+} from "./chunk-F7LXKP4T.js";
 import {
   normalizeDistTag,
   readCache,

package/dist/skillwiki-mcp.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runSkillwikiMcpStdio
-} from "./chunk-S4NZQOXI.js";
+} from "./chunk-F7LXKP4T.js";
 import "./chunk-7I2TPIV5.js";
 import "./chunk-GAU4D25O.js";
 import "./chunk-FXASPB3C.js";

package/package.json

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

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

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.48",
+  "version": "0.10.49",
   "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.48",
+  "version": "0.10.49",
   "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/package.json

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

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

@@ -1,6 +1,6 @@
 ---
 name: using-skillwiki
-description: Invoke at session start or when knowledge-base tasks arise — maps skillwiki skills, dev-loop alignment, adaptive workflow profiles, and vault routing
+description: Invoke when vault, wiki, knowledge-base, or SkillWiki setup work arises — maps skillwiki skills, dev-loop alignment, adaptive workflow profiles, and vault routing. Do not invoke for unrelated coding or creative tasks.
 ---
 *Note: If executing as a background subagent, skip this skill section.*
 
@@ -30,19 +30,21 @@ Use this section as procedural planning guidelines:
 
 **Claude Code** and **Codex** activate SkillWiki via the plugin SessionStart hook (`hooks/session-start` / `hooks/session-start-codex`). Do **not** install activation markers into `~/.claude/CLAUDE.md` or `~/.codex/AGENTS.md` when the plugin is present — that double-injects context and pollutes user-scope instruction files.
 
-On harnesses where SessionStart `additionalContext` does **not** fire (**Grok**), SkillWiki activation context is delivered via a compact file. Run `npm run install:activation` from the repo to install:
+On harnesses where SessionStart `additionalContext` does **not** fire (**Grok**), SkillWiki activation context is delivered via a compact file. Run `npm run install:activation` from the llm-wiki repo to install:
 
 - `~/.grok/skillwiki.md` — compact derivative covering identity, CLI probe, skill map, PRD bridge, fail-closed boundary, and drift warning.
-- `~/.grok/AGENTS.md` — prepended with a marker-wrapped reference: `Read @skillwiki.md for SkillWiki activation context.`
+- `~/.grok/AGENTS.md` — prepended with a marker-wrapped reference: `Read @~/.grok/skillwiki.md for SkillWiki activation context.`
 
 Default install is **Grok only**. Re-running `install:activation` also **removes** any prior Claude/Codex activation marker and matching `skillwiki.md` (cleanup for the earlier dual-target installer). Opt-in fallbacks only when the plugin SessionStart path is unavailable:
 
-- `npm run install:activation -- --with-claude` — `~/.claude/skillwiki.md` + `CLAUDE.md` marker
-- `npm run install:activation -- --with-codex` — `~/.codex/skillwiki.md` + `AGENTS.md` marker
+- `npm run install:activation -- --with-claude` — `~/.claude/skillwiki.md` + `CLAUDE.md` marker `Read @~/.claude/skillwiki.md …`
+- `npm run install:activation -- --with-codex` — `~/.codex/skillwiki.md` + `AGENTS.md` marker `Read @~/.codex/skillwiki.md …`
 
-The activation file is self-contained literal text (ADR-3). On harnesses with `@file` import support, the reference is inlined automatically. On Grok (no `@file` support), the agent reads the file manually when it sees the instructional reference.
+The activation file is self-contained literal text (ADR-3). On harnesses with `@file` import support, `@~/.grok/skillwiki.md` (or the Claude/Codex home path) is inlined. On Grok (no `@file` support), `read_file` the exact path `~/.grok/skillwiki.md`. Never `~/skillwiki.md`. Never a cwd-relative `skillwiki.md`. If that file is missing, say activation is absent and suggest `npm run install:activation` from the llm-wiki repo; do not create a home-level `skillwiki.md`.
 
-The template lives at `packages/skills/using-skillwiki/activation.md`. Run `npm run install:activation:check` to verify the Grok install matches the template and that Claude/Codex are not still carrying the activation block.
+The compact `~/.grok/skillwiki.md` is the session-start context. This full skill is for vault/wiki/setup work only — do not load it at the start of an unrelated session.
+
+The template lives at `packages/skills/using-skillwiki/activation.md`. Run `npm run install:activation:check` to verify the Grok install matches the template and that Claude/Codex are not still carrying the activation block. `skillwiki doctor` reports a warn on a missing file, a stale `@skillwiki.md` marker, or compact-file drift.
 
 ## When to Use These Skills
 Invoke a skillwiki skill when the user:

package/skills/using-skillwiki/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: using-skillwiki
-description: Invoke at session start or when knowledge-base tasks arise — maps skillwiki skills, dev-loop alignment, adaptive workflow profiles, and vault routing
+description: Invoke when vault, wiki, knowledge-base, or SkillWiki setup work arises — maps skillwiki skills, dev-loop alignment, adaptive workflow profiles, and vault routing. Do not invoke for unrelated coding or creative tasks.
 ---
 *Note: If executing as a background subagent, skip this skill section.*
 
@@ -30,19 +30,21 @@ Use this section as procedural planning guidelines:
 
 **Claude Code** and **Codex** activate SkillWiki via the plugin SessionStart hook (`hooks/session-start` / `hooks/session-start-codex`). Do **not** install activation markers into `~/.claude/CLAUDE.md` or `~/.codex/AGENTS.md` when the plugin is present — that double-injects context and pollutes user-scope instruction files.
 
-On harnesses where SessionStart `additionalContext` does **not** fire (**Grok**), SkillWiki activation context is delivered via a compact file. Run `npm run install:activation` from the repo to install:
+On harnesses where SessionStart `additionalContext` does **not** fire (**Grok**), SkillWiki activation context is delivered via a compact file. Run `npm run install:activation` from the llm-wiki repo to install:
 
 - `~/.grok/skillwiki.md` — compact derivative covering identity, CLI probe, skill map, PRD bridge, fail-closed boundary, and drift warning.
-- `~/.grok/AGENTS.md` — prepended with a marker-wrapped reference: `Read @skillwiki.md for SkillWiki activation context.`
+- `~/.grok/AGENTS.md` — prepended with a marker-wrapped reference: `Read @~/.grok/skillwiki.md for SkillWiki activation context.`
 
 Default install is **Grok only**. Re-running `install:activation` also **removes** any prior Claude/Codex activation marker and matching `skillwiki.md` (cleanup for the earlier dual-target installer). Opt-in fallbacks only when the plugin SessionStart path is unavailable:
 
-- `npm run install:activation -- --with-claude` — `~/.claude/skillwiki.md` + `CLAUDE.md` marker
-- `npm run install:activation -- --with-codex` — `~/.codex/skillwiki.md` + `AGENTS.md` marker
+- `npm run install:activation -- --with-claude` — `~/.claude/skillwiki.md` + `CLAUDE.md` marker `Read @~/.claude/skillwiki.md …`
+- `npm run install:activation -- --with-codex` — `~/.codex/skillwiki.md` + `AGENTS.md` marker `Read @~/.codex/skillwiki.md …`
 
-The activation file is self-contained literal text (ADR-3). On harnesses with `@file` import support, the reference is inlined automatically. On Grok (no `@file` support), the agent reads the file manually when it sees the instructional reference.
+The activation file is self-contained literal text (ADR-3). On harnesses with `@file` import support, `@~/.grok/skillwiki.md` (or the Claude/Codex home path) is inlined. On Grok (no `@file` support), `read_file` the exact path `~/.grok/skillwiki.md`. Never `~/skillwiki.md`. Never a cwd-relative `skillwiki.md`. If that file is missing, say activation is absent and suggest `npm run install:activation` from the llm-wiki repo; do not create a home-level `skillwiki.md`.
 
-The template lives at `packages/skills/using-skillwiki/activation.md`. Run `npm run install:activation:check` to verify the Grok install matches the template and that Claude/Codex are not still carrying the activation block.
+The compact `~/.grok/skillwiki.md` is the session-start context. This full skill is for vault/wiki/setup work only — do not load it at the start of an unrelated session.
+
+The template lives at `packages/skills/using-skillwiki/activation.md`. Run `npm run install:activation:check` to verify the Grok install matches the template and that Claude/Codex are not still carrying the activation block. `skillwiki doctor` reports a warn on a missing file, a stale `@skillwiki.md` marker, or compact-file drift.
 
 ## When to Use These Skills
 Invoke a skillwiki skill when the user: