skillwiki 0.10.64 → 0.10.67

package/dist/{chunk-CKDF4DWU.js → chunk-R5SDVKHS.js}

@@ -5803,6 +5803,17 @@ async function runVaultSyncPullHelper(input) {
 }
 
 // src/commands/sync.ts
+function countAheadBehind(vault) {
+  const revOutput = git(vault, ["rev-list", "--left-right", "--count", "origin/HEAD...HEAD"]);
+  let ahead = 0;
+  let behind = 0;
+  if (revOutput) {
+    const parts = revOutput.split(/\s+/);
+    behind = parseInt(parts[0], 10) || 0;
+    ahead = parseInt(parts[1], 10) || 0;
+  }
+  return { ahead, behind };
+}
 function parseDirtyPaths(porcelain) {
   if (!porcelain) return [];
   return porcelain.split("\n").map((line) => line.trimEnd()).filter((line) => line.length >= 4).map((line) => {
@@ -5854,14 +5865,7 @@ function runSyncStatus(input) {
   const dirty = porcelain ? porcelain.split("\n").filter((l) => l.trim().length > 0).length : 0;
   const dirtyPaths = parseDirtyPaths(porcelain);
   const untrackedPaths = splitNonEmptyLines(git(vault, ["ls-files", "--others", "--exclude-standard"]));
-  const revOutput = git(vault, ["rev-list", "--left-right", "--count", "origin/HEAD...HEAD"]);
-  let ahead = 0;
-  let behind = 0;
-  if (revOutput) {
-    const parts = revOutput.split(/\s+/);
-    behind = parseInt(parts[0], 10) || 0;
-    ahead = parseInt(parts[1], 10) || 0;
-  }
+  const { ahead, behind } = countAheadBehind(vault);
   const tsRaw = git(vault, ["log", "-1", "--format=%ct"]);
   let last_commit;
   if (tsRaw) {
@@ -5961,14 +5965,91 @@ async function runSyncPush(input) {
   const porcelain = git(vault, ["status", "--porcelain"]);
   const dirtyFiles = porcelain ? porcelain.split("\n").filter((l) => l.trim().length > 0) : [];
   if (dirtyFiles.length === 0) {
+    const { ahead } = countAheadBehind(vault);
+    if (ahead === 0) {
+      return {
+        exitCode: ExitCode.OK,
+        result: ok({
+          files_committed: 0,
+          commit_message: "",
+          pushed: false,
+          path_fixes: pathFixes,
+          humanHint: "nothing to commit, working tree clean"
+        })
+      };
+    }
+    let delta2 = { full_errors: 0, base_errors: 0, new_errors: 0, resolved_errors: 0 };
+    const preferredBase2 = git(vault, ["rev-parse", "--verify", "origin/main"]) ? "origin/main" : git(vault, ["rev-parse", "--verify", "origin/HEAD"]) ? "origin/HEAD" : "";
+    if (preferredBase2) {
+      const deltaResult = await runSyncLintDelta({ vault, baseRef: preferredBase2 });
+      if (!deltaResult.result.ok) {
+        return {
+          exitCode: ExitCode.LINT_HAS_ERRORS,
+          result: err("LINT_DELTA_UNAVAILABLE", {
+            message: "lint-delta evidence missing or failed \u2014 fail closed",
+            detail: deltaResult.result
+          })
+        };
+      }
+      delta2 = deltaResult.result.data;
+      if (delta2.new_errors > 0) {
+        return {
+          exitCode: ExitCode.LINT_HAS_ERRORS,
+          result: err("LINT_NEW_ERRORS_BLOCK_PUSH", {
+            full_errors: delta2.full_errors,
+            base_errors: delta2.base_errors,
+            new_errors: delta2.new_errors,
+            resolved_errors: delta2.resolved_errors,
+            new_fingerprints: deltaResult.result.data.new_fingerprints
+          })
+        };
+      }
+    } else {
+      const lintResult = await runLint({ vault, days: 90, lines: 200, logThreshold: 500 });
+      if (lintResult.result.ok) {
+        const fullErrors = lintResult.result.data.summary.errors;
+        delta2 = { full_errors: fullErrors, base_errors: 0, new_errors: fullErrors, resolved_errors: 0 };
+        if (fullErrors > 0) {
+          const buckets = "by_severity" in lintResult.result.data ? lintResult.result.data.by_severity.error : [];
+          return {
+            exitCode: ExitCode.LINT_HAS_ERRORS,
+            result: err("LINT_ERRORS_BLOCK_PUSH", {
+              errors: fullErrors,
+              buckets,
+              message: "no origin base ref for delta; absolute lint errors block push"
+            })
+          };
+        }
+      } else {
+        delta2 = { full_errors: 0, base_errors: 0, new_errors: 0, resolved_errors: 0 };
+      }
+    }
+    let pushed2 = false;
+    try {
+      gitStrict(vault, ["push", "origin", "HEAD"]);
+      pushed2 = true;
+    } catch (e) {
+      return {
+        exitCode: ExitCode.SYNC_PUSH_FAILED,
+        result: err("SYNC_PUSH_FAILED", {
+          pushed: false,
+          message: `push failed: ${String(e)}`
+        })
+      };
+    }
+    const inheritedNote2 = delta2.full_errors > 0 ? `; lint full=${delta2.full_errors} base=${delta2.base_errors} new=${delta2.new_errors} resolved=${delta2.resolved_errors} (inherited debt only)` : `; lint full=0 new=0`;
     return {
       exitCode: ExitCode.OK,
       result: ok({
         files_committed: 0,
         commit_message: "",
-        pushed: false,
+        pushed: pushed2,
         path_fixes: pathFixes,
-        humanHint: "nothing to commit, working tree clean"
+        lint_full_errors: delta2.full_errors,
+        lint_base_errors: delta2.base_errors,
+        lint_new_errors: delta2.new_errors,
+        lint_resolved_errors: delta2.resolved_errors,
+        humanHint: `pushed ${ahead} commit(s) on clean working tree${pathFixes > 0 ? ` after ${pathFixes} long-path fix(es)` : ""}${inheritedNote2}`
       })
     };
   }

package/dist/{chunk-SNHTWLGF.js → chunk-YKVJ2A3O.js}

@@ -40,7 +40,7 @@ import {
   snapshotterAliasForLocalHost,
   toUndirectedWeighted,
   writeDotenv
-} from "./chunk-CKDF4DWU.js";
+} from "./chunk-R5SDVKHS.js";
 import {
   atomicWriteText,
   prepareTypedPage

package/dist/cli.js

@@ -50,7 +50,7 @@ import {
   snapshotterHealthChecks,
   upsertIndexEntry,
   vectorIndexStatus
-} from "./chunk-SNHTWLGF.js";
+} from "./chunk-YKVJ2A3O.js";
 import {
   normalizeDistTag,
   readCache,
@@ -151,7 +151,7 @@ import {
   supersedeStaleReviewRequiredJournals,
   taxonomyCommentForPage,
   writeDotenv
-} from "./chunk-CKDF4DWU.js";
+} from "./chunk-R5SDVKHS.js";
 import {
   assertTargetInsideVault,
   atomicWriteText,
@@ -10410,7 +10410,7 @@ async function emitManagedVaultWrite(vault, command, mutate, opts) {
   if (dirty) {
     return emit(dirty, void 0, { postCommit: false });
   }
-  const { runManagedWriteTransaction: runManagedWriteTransaction2 } = await import("./managed-write-preflight-2MMVUXD3.js");
+  const { runManagedWriteTransaction: runManagedWriteTransaction2 } = await import("./managed-write-preflight-PUEJOXJO.js");
   const run = await runManagedWriteTransaction2({
     vault,
     command,

package/dist/{managed-write-preflight-2MMVUXD3.js → managed-write-preflight-PUEJOXJO.js}

@@ -6,7 +6,7 @@ import {
   runManagedWritePeerGate,
   runManagedWritePreflight,
   runManagedWriteTransaction
-} from "./chunk-CKDF4DWU.js";
+} from "./chunk-R5SDVKHS.js";
 import "./chunk-BPJ5KWIT.js";
 import "./chunk-OMO45AHI.js";
 import "./chunk-HJ4ALQG6.js";

package/dist/skillwiki-mcp.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   runSkillwikiMcpStdio
-} from "./chunk-SNHTWLGF.js";
+} from "./chunk-YKVJ2A3O.js";
 import "./chunk-7I2TPIV5.js";
 import "./chunk-KFEOMMWK.js";
-import "./chunk-CKDF4DWU.js";
+import "./chunk-R5SDVKHS.js";
 import "./chunk-BPJ5KWIT.js";
 import "./chunk-NPTIYO2S.js";
 import "./chunk-OMO45AHI.js";

package/package.json

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

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

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

package/skills/README.md

@@ -38,6 +38,12 @@ Each top-level skill subdirectory holds one canonical `SKILL.md`. The nested
 `skills/<skill>/SKILL.md` tree mirrors those files for Codex plugin discovery;
 keep it byte-for-byte in sync with the canonical top-level files.
 
+`description` is routing metadata for every skill, not a README. Author to
+180 characters (CI fails above 220). Unique-canonical totals are capped with
+agent-skills so the combined Codex catalog stays at 8,000 characters. See
+vault concept `concepts/codex-skill-catalog-budget.md`. Run
+`python3 scripts/lint-skill-descriptions.py --layout llm-wiki --max-total-chars 3200`.
+
 Codex installs through `packages/codex-skills`, a materialized plugin root that
 copies this package's `.codex-plugin/` manifest, `skills/` mirror, and
 Codex-specific hook files. That root exposes `hooks/hooks-codex.json` and

package/skills/package.json

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

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

@@ -1,6 +1,6 @@
 ---
 name: using-skillwiki
-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.
+description: Invoke for vault, wiki, or SkillWiki setup. Maps skills, workflow profiles, and vault routing. Skip unrelated coding.
 ---
 *Note: If executing as a background subagent, skip this skill section.*
 
@@ -287,7 +287,7 @@ skillwiki has multiple distribution channels that can drift:
 | Claude plugin | `~/.claude/plugins/cache/llm-wiki/` | `claude plugin update skillwiki@llm-wiki` |
 | Codex plugin | `~/.codex/plugins/cache/llm-wiki/` | `codex plugin marketplace upgrade llm-wiki`, then reinstall or restart Codex as needed |
 | Grok plugin | `~/.grok/installed-plugins/` (marketplace cache under `~/.grok/marketplace-cache/`) | `grok plugin update skillwiki`, then start a new session or reload plugins |
-| Cursor / Grok Bot (Team GitHub import) | `~/.cursor/plugins/cache/llm-wiki/` and `~/.cursor/plugins/marketplaces/github.com/karlorz/llm-wiki/<sha>/` | Cursor Dashboard → Plugins → **Refresh** or Enable Auto Refresh on `karlorz/llm-wiki`. Reinstall does not move a pinned snapshot. |
+| Cursor / Grok Bot (user GitHub add) | `~/.cursor/plugins/cache/llm-wiki/` and `~/.cursor/plugins/marketplaces/github.com/karlorz/llm-wiki/<sha>/` | `cursor-github-marketplace-repin` (`status.sh`). Team Dashboard Refresh only for a Team admin row. Reinstall does not move a pinned snapshot. |
 | Local git dev | source repo checkout | `npm link ./packages/cli` (from repo root) |
 **Check versions:** `skillwiki doctor` reports Plugin/CLI version mismatch warnings when installed channels disagree. For Grok, also inspect `~/.grok/installed-plugins/*/.claude-plugin/plugin.json` version and agent frontmatter under `agents/*.md`.
 **Plugin channel rule:** Plugin-managed skills and agents are not refreshed with `skillwiki install`. When Claude, Codex, or Grok plugin is installed and enabled, the plugin install root is the skill/agent provider; `skillwiki install` is only a legacy/standalone copier for `~/.claude/skills/`.

package/skills/skills/wiki-freshness-repair/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wiki-freshness-repair
-description: Repair stale vault sources end to end. Consumes skillwiki drift --affected-pages, re-ingests changed sources through wiki-reingest, then republishes the affected typed pages through the page publish approval flow. Attended only; never auto-repairs.
+description: Repair stale vault sources via drift, reingest, and attended republish. Use when skillwiki drift lists affected pages.
 ---
 
 # wiki-freshness-repair

package/skills/skills/wiki-sync/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wiki-sync
-description: Safely sync the vault git repository — multi-session safe via advisory lockfile. Handles rebase conflict storms from archive-commit × snapshot-stream patterns. Runs skillwiki sync status, then guides push or pull with lint guards and conflict resolution.
+description: Safely sync vault git with a lockfile and lint guards. Use to push or pull wiki changes across sessions.
 ---
 # wiki-sync
 ## When This Skill Activates

package/skills/using-skillwiki/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: using-skillwiki
-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.
+description: Invoke for vault, wiki, or SkillWiki setup. Maps skills, workflow profiles, and vault routing. Skip unrelated coding.
 ---
 *Note: If executing as a background subagent, skip this skill section.*
 
@@ -287,7 +287,7 @@ skillwiki has multiple distribution channels that can drift:
 | Claude plugin | `~/.claude/plugins/cache/llm-wiki/` | `claude plugin update skillwiki@llm-wiki` |
 | Codex plugin | `~/.codex/plugins/cache/llm-wiki/` | `codex plugin marketplace upgrade llm-wiki`, then reinstall or restart Codex as needed |
 | Grok plugin | `~/.grok/installed-plugins/` (marketplace cache under `~/.grok/marketplace-cache/`) | `grok plugin update skillwiki`, then start a new session or reload plugins |
-| Cursor / Grok Bot (Team GitHub import) | `~/.cursor/plugins/cache/llm-wiki/` and `~/.cursor/plugins/marketplaces/github.com/karlorz/llm-wiki/<sha>/` | Cursor Dashboard → Plugins → **Refresh** or Enable Auto Refresh on `karlorz/llm-wiki`. Reinstall does not move a pinned snapshot. |
+| Cursor / Grok Bot (user GitHub add) | `~/.cursor/plugins/cache/llm-wiki/` and `~/.cursor/plugins/marketplaces/github.com/karlorz/llm-wiki/<sha>/` | `cursor-github-marketplace-repin` (`status.sh`). Team Dashboard Refresh only for a Team admin row. Reinstall does not move a pinned snapshot. |
 | Local git dev | source repo checkout | `npm link ./packages/cli` (from repo root) |
 **Check versions:** `skillwiki doctor` reports Plugin/CLI version mismatch warnings when installed channels disagree. For Grok, also inspect `~/.grok/installed-plugins/*/.claude-plugin/plugin.json` version and agent frontmatter under `agents/*.md`.
 **Plugin channel rule:** Plugin-managed skills and agents are not refreshed with `skillwiki install`. When Claude, Codex, or Grok plugin is installed and enabled, the plugin install root is the skill/agent provider; `skillwiki install` is only a legacy/standalone copier for `~/.claude/skills/`.

package/skills/wiki-freshness-repair/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wiki-freshness-repair
-description: Repair stale vault sources end to end. Consumes skillwiki drift --affected-pages, re-ingests changed sources through wiki-reingest, then republishes the affected typed pages through the page publish approval flow. Attended only; never auto-repairs.
+description: Repair stale vault sources via drift, reingest, and attended republish. Use when skillwiki drift lists affected pages.
 ---
 
 # wiki-freshness-repair

package/skills/wiki-sync/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wiki-sync
-description: Safely sync the vault git repository — multi-session safe via advisory lockfile. Handles rebase conflict storms from archive-commit × snapshot-stream patterns. Runs skillwiki sync status, then guides push or pull with lint guards and conflict resolution.
+description: Safely sync vault git with a lockfile and lint guards. Use to push or pull wiki changes across sessions.
 ---
 # wiki-sync
 ## When This Skill Activates