skillwiki 0.10.88 → 0.10.90

package/dist/{chunk-5QFHISNH.js → chunk-ZYVP52PM.js}

@@ -4512,10 +4512,16 @@ function isHygieneCommand(command) {
   }
   return false;
 }
+function isEventLedgerPath(rel) {
+  const n = rel.replace(/\\/g, "/").replace(/^\.\//, "");
+  return n === "meta/log-events" || n.startsWith("meta/log-events/");
+}
 function measureDirtyVolume(vault) {
   const empty = (extra = {}) => ({
     porcelain_lines: 0,
     expanded_files: 0,
+    content_files: 0,
+    ledger_files: 0,
     modified: 0,
     untracked: 0,
     buckets: [],
@@ -4545,7 +4551,13 @@ function measureDirtyVolume(vault) {
   let modified = 0;
   let untracked = 0;
   let expanded = 0;
+  let contentFiles = 0;
+  let ledgerFiles = 0;
   const bucketMap = /* @__PURE__ */ new Map();
+  const classify = (rel, n) => {
+    if (isEventLedgerPath(rel)) ledgerFiles += n;
+    else contentFiles += n;
+  };
   const addBucket = (rel, n) => {
     const top = rel.split(/[/\\]/)[0] || ".";
     bucketMap.set(top, (bucketMap.get(top) ?? 0) + n);
@@ -4567,20 +4579,27 @@ function measureDirtyVolume(vault) {
         const files = listFilesRecursive(abs);
         expanded += files.length;
         addBucket(rel, files.length);
+        for (const file of files) {
+          classify(relative2(vault, file).replace(/\\/g, "/"), 1);
+        }
       } else {
         expanded += 1;
         addBucket(rel, 1);
+        classify(rel, 1);
       }
     } else {
       modified += 1;
       expanded += 1;
       addBucket(rel, 1);
+      classify(rel, 1);
     }
   }
   const buckets = [...bucketMap.entries()].map(([bucket, count]) => ({ bucket, count })).sort((a, b) => b.count - a.count);
   return {
     porcelain_lines: lines.length,
     expanded_files: expanded,
+    content_files: contentFiles,
+    ledger_files: ledgerFiles,
     modified,
     untracked,
     buckets,
@@ -4613,7 +4632,7 @@ function evaluateDirtyVolumeGate(input) {
   const threshold = input.threshold ?? DEFAULT_DIRTY_VOLUME_THRESHOLD;
   const report = measureDirtyVolume(input.vault);
   report.threshold = threshold;
-  report.over_threshold = report.is_git_repo && report.expanded_files > threshold;
+  report.over_threshold = report.is_git_repo && report.content_files > threshold;
   if (input.skip) {
     return { allowed: true, reason: "skipped", report };
   }
@@ -4632,7 +4651,7 @@ function evaluateDirtyVolumeGate(input) {
     reason: "over_threshold",
     code: GateError.VAULT_DIRTY_BACKLOG,
     report,
-    humanHint: `Vault dirty volume ${report.expanded_files} exceeds threshold ${threshold} (porcelain ${report.porcelain_lines}; buckets: ${top || "none"}). Triage/commit keep-set before more non-hygiene writes. Hygiene commands still allowed.`
+    humanHint: `Vault content dirty volume ${report.content_files} exceeds threshold ${threshold} (event-ledger ${report.ledger_files} excluded; porcelain ${report.porcelain_lines}; buckets: ${top || "none"}). Triage/commit keep-set before more non-hygiene writes. Do not git add meta/log-events. Hygiene commands still allowed.`
   };
 }
 var SATURATION_PATTERNS = [
@@ -7828,6 +7847,7 @@ export {
   DEFAULT_CAPTURE_BUDGET,
   DEFAULT_NO_DECISION_STREAK,
   GateError,
+  measureDirtyVolume,
   evaluateDirtyVolumeGate,
   CAPTURE_HYGIENE_CONTRACT,
   runWritePreflight,

package/dist/cli.js

@@ -15,6 +15,7 @@ import {
   findPlugin,
   guardProtectedVaultWrite,
   isFailedRunStatus,
+  measureDirtyVolume,
   memoryAuthorityTiersRank,
   pruneVectorIndex,
   readCliPackageJson,
@@ -52,7 +53,7 @@ import {
   snapshotterHealthChecks,
   upsertIndexEntry,
   vectorIndexStatus
-} from "./chunk-5QFHISNH.js";
+} from "./chunk-ZYVP52PM.js";
 import {
   normalizeDistTag,
   readCache,
@@ -9348,57 +9349,83 @@ function githubRecord(p) {
   if (p.ageHours !== void 0) rec.age_hours = p.ageHours;
   return rec;
 }
+function withDirty(rec, p) {
+  if (p.dirty !== void 0) rec.dirty = p.dirty;
+  if (p.untracked !== void 0) rec.untracked = p.untracked;
+  if (p.ledger_untracked !== void 0) rec.ledger_untracked = p.ledger_untracked;
+  if (p.content_untracked !== void 0) rec.content_untracked = p.content_untracked;
+  return rec;
+}
 function localRecord(p, githubOid) {
   if (p.blockedReason) {
-    return {
-      state: "blocked",
-      oid: p.head,
-      behind: p.behind,
-      blocked_reason: p.blockedReason,
-      detail: p.detail ?? p.blockedReason
-    };
+    return withDirty(
+      {
+        state: "blocked",
+        oid: p.head,
+        behind: p.behind,
+        blocked_reason: p.blockedReason,
+        detail: p.detail ?? p.blockedReason
+      },
+      p
+    );
   }
   if (p.head && githubOid && p.head === githubOid && (p.behind === void 0 || p.behind === 0)) {
-    return {
-      state: "ok",
-      oid: p.head,
-      behind: p.behind,
-      detail: p.detail ?? "HEAD matches GitHub"
-    };
+    return withDirty(
+      {
+        state: "ok",
+        oid: p.head,
+        behind: p.behind,
+        detail: p.detail ?? "HEAD matches GitHub"
+      },
+      p
+    );
   }
   if (p.behind !== void 0 && p.behind > 0) {
-    return {
-      state: "stale",
-      oid: p.head,
-      behind: p.behind,
-      detail: p.detail ?? `behind origin/main by ${p.behind}`
-    };
+    return withDirty(
+      {
+        state: "stale",
+        oid: p.head,
+        behind: p.behind,
+        detail: p.detail ?? `behind origin/main by ${p.behind}`
+      },
+      p
+    );
   }
   if (p.head && githubOid && p.head !== githubOid) {
-    return {
-      state: "stale",
-      oid: p.head,
-      behind: p.behind,
-      detail: p.detail ?? "HEAD differs from GitHub"
-    };
+    return withDirty(
+      {
+        state: "stale",
+        oid: p.head,
+        behind: p.behind,
+        detail: p.detail ?? "HEAD differs from GitHub"
+      },
+      p
+    );
   }
   if (p.head) {
-    return {
-      state: "ok",
-      oid: p.head,
-      behind: p.behind,
-      detail: p.detail ?? "HEAD present"
-    };
+    return withDirty(
+      {
+        state: "ok",
+        oid: p.head,
+        behind: p.behind,
+        detail: p.detail ?? "HEAD present"
+      },
+      p
+    );
   }
-  return { state: "unknown", detail: p.detail ?? "leaf clone unmeasured" };
+  return withDirty({ state: "unknown", detail: p.detail ?? "leaf clone unmeasured" }, p);
 }
 function formatPlane(name, rec) {
   const parts = [`${name}: ${rec.state}`];
   if (rec.oid) parts.push(`oid=${rec.oid.slice(0, 12)}`);
   if (rec.behind !== void 0) parts.push(`behind=${rec.behind}`);
   if (rec.age_hours !== void 0) parts.push(`age_hours=${rec.age_hours}`);
+  if (rec.ledger_untracked !== void 0) parts.push(`ledger_untracked=${rec.ledger_untracked}`);
+  if (rec.content_untracked !== void 0) parts.push(`content_untracked=${rec.content_untracked}`);
+  if (rec.ledger_untracked === void 0 && rec.dirty !== void 0) parts.push(`dirty=${rec.dirty}`);
+  if (rec.ledger_untracked === void 0 && rec.untracked !== void 0) parts.push(`untracked=${rec.untracked}`);
   if (rec.blocked_reason) parts.push(rec.blocked_reason);
-  if (rec.detail) parts.push(rec.detail);
+  if (rec.detail && rec.detail !== rec.blocked_reason) parts.push(rec.detail);
   return parts.join(" ");
 }
 function composeCopyStatus(input) {
@@ -9466,11 +9493,21 @@ function defaultCopyStatusDeps(input) {
       const behind = behindRaw === "" ? void 0 : Number.parseInt(behindRaw, 10);
       const review = listReviewRequiredOps(input.vault)[0];
       const blockedReason = review ? `review-required:${review.opId}` : void 0;
+      const dirty = measureDirtyVolume(input.vault);
+      const dirtyCount = dirty.is_git_repo ? dirty.expanded_files : void 0;
+      const untrackedCount = dirty.is_git_repo ? dirty.untracked : void 0;
+      const ledgerUntracked = dirty.is_git_repo ? dirty.ledger_files : void 0;
+      const contentUntracked = dirty.is_git_repo ? dirty.content_files : void 0;
+      const dirtyHint = dirtyCount && dirtyCount > 0 ? ledgerUntracked && ledgerUntracked > 0 ? `event-ledger live-ahead of GitHub; do not git add` : `live-ahead of GitHub; do not git add` : void 0;
       return {
         head,
         behind: Number.isFinite(behind) ? behind : void 0,
         blockedReason,
-        detail: blockedReason
+        dirty: dirtyCount,
+        untracked: untrackedCount,
+        ledger_untracked: dirtyCount && dirtyCount > 0 ? ledgerUntracked : void 0,
+        content_untracked: dirtyCount && dirtyCount > 0 ? contentUntracked : void 0,
+        detail: dirtyHint ?? blockedReason
       };
     }
   };

package/dist/skillwiki-mcp.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runSkillwikiMcpStdio
-} from "./chunk-5QFHISNH.js";
+} from "./chunk-ZYVP52PM.js";
 import "./chunk-7I2TPIV5.js";
 import "./chunk-ZUHA2EXE.js";
 import "./chunk-6WE7E6VB.js";

package/dist/vault-sync/scripts/wiki-fetch-notify.sh

@@ -72,7 +72,17 @@ log() {
 }
 
 handle_existing_handoff() {
-  local blocker reason op identity previous_identity notified_at now
+  local blocker reason op identity previous_identity notified_at now before after
+  # Same altitude as managed-write preflight: a review-required whose target_oid
+  # is already in HEAD is obsolete. Preserve dirty live-ahead WIP; only real
+  # unresolved handoffs (target still ahead / sequencer / unmerged) skip pull.
+  before="$(vault_sync_op_find_review_required "$WIKI_DIR" 2>/dev/null || true)"
+  if vault_sync_op_supersede_stale_review_required "$WIKI_DIR" "wiki-fetch-notify" 2>/dev/null; then
+    after="$(vault_sync_op_find_review_required "$WIKI_DIR" 2>/dev/null || true)"
+    if [ -n "$before" ] && [ -z "$after" ]; then
+      log "OK superseded stale review-required handoff(s); fetch pull may proceed"
+    fi
+  fi
   blocker="$(vault_sync_op_preflight_blocker "$WIKI_DIR" 2>/dev/null || true)"
   [ -n "$blocker" ] || { rm -f "$HANDOFF_STATE_FILE" "$FETCH_HARD_PAUSE_COUNTER_FILE" 2>/dev/null || true; return 1; }
 

package/dist/vault-sync/scripts/wiki-snapshot.sh

@@ -100,6 +100,26 @@ CLOUD_REMOTE="${CLOUD_REMOTE:-cloud:cloud/wiki}"
 REPAIR_SCRIPT="${WIKI_GIT_REPAIR_SCRIPT:-$SCRIPT_DIR/wiki-git-repair-v3.sh}"
 MAX_S3_ONLY_NOTES="${WIKI_SNAPSHOT_MAX_S3_ONLY_NOTES:-200}"
 MAX_TOMBSTONE_PRUNES="${WIKI_SNAPSHOT_MAX_TOMBSTONE_PRUNES:-10}"
+
+# Classified inventory: event ledger + local scratch are not GitHub-promotable notes.
+# Cap and rclone must share this class. Do not raise MAX_S3_ONLY_NOTES instead.
+# meta/log-events stay S3-authoritative; snapshot copies them separately for --events-from.
+snapshot_non_promotable_path() {
+    local p="${1#./}"
+    case "$p" in
+        .skillwiki/*|.claude/*|.obsidian/*|.antigravitycli/*|.playwright-cli/*|.superpowers/*|.snapshots/*|.git/*|.drafts/*)
+            return 0 ;;
+        tmp/*|logs|logs/*|meta/log-events|meta/log-events/*)
+            return 0 ;;
+        raw/._.DS_Store|._.DS_Store)
+            return 0 ;;
+        ._*)
+            return 0 ;;
+        .conflict*|*.conflict-*)
+            return 0 ;;
+    esac
+    return 1
+}
 PROJECTION_PARITY_TIMEOUT_SECONDS="${WIKI_SNAPSHOT_PROJECTION_PARITY_TIMEOUT_SECONDS:-120}"
 PROJECTION_PARITY_POLL_SECONDS="${WIKI_SNAPSHOT_PROJECTION_PARITY_POLL_SECONDS:-2}"
 PROJECTION_READ_TIMEOUT_SECONDS="${WIKI_SNAPSHOT_PROJECTION_READ_TIMEOUT_SECONDS:-15}"
@@ -185,7 +205,14 @@ snapshot_direct_s3_preflight() {
     fi
     SNAPSHOT_REMOTE_INVENTORY_READY=1
 
-    grep -vE '^(\.skillwiki/|\.claude/|\.obsidian/|\.antigravitycli/|\.playwright-cli/|\.superpowers/|raw/\._\.DS_Store$|\._\.DS_Store$)' "$direct_paths" | LC_ALL=C sort -u > "$direct_notes" || true
+    : > "$direct_notes"
+    while IFS= read -r snapshot_inv_path || [ -n "$snapshot_inv_path" ]; do
+        [ -n "$snapshot_inv_path" ] || continue
+        if snapshot_non_promotable_path "$snapshot_inv_path"; then
+            continue
+        fi
+        printf '%s\n' "$snapshot_inv_path"
+    done < "$direct_paths" | LC_ALL=C sort -u > "$direct_notes" || true
     (
         cd "$SNAPSHOT_WORKTREE" || exit 1
         if git rev-parse --verify --quiet origin/main >/dev/null 2>&1; then
@@ -939,6 +966,11 @@ RCLONE_OPTS=(
     --exclude ".antigravitycli/**"
     --exclude ".playwright-cli/**"
     --exclude ".superpowers/**"
+    --exclude ".drafts/**"
+    --exclude "tmp/**"
+    --exclude "logs"
+    --exclude "logs/**"
+    --exclude "meta/log-events/**"
     --exclude "._*"
     --exclude ".conflict*"
     --exclude "*.conflict-*"

package/package.json

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

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

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.88",
+  "version": "0.10.90",
   "skills": "./",
   "description": "Project-aware Karpathy-style knowledge base for Claude Code: 21 prompt-only skills (wiki-*, proj-*, using-skillwiki, skillwiki-mcp) backed by the deterministic `skillwiki` CLI.",
   "author": {

package/skills/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.88",
+  "version": "0.10.90",
   "description": "Project-aware Karpathy-style knowledge base for Codex with 21 prompt-only skills backed by the deterministic skillwiki CLI.",
   "author": {
     "name": "karlorz",

package/skills/.cursor-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.88",
+  "version": "0.10.90",
   "description": "Project-aware Karpathy-style knowledge base: 21 prompt-only skills (wiki-*, proj-*, using-skillwiki, skillwiki-mcp) backed by HTTP MCP wiki_capture.",
   "author": {
     "name": "karlorz"

package/skills/package.json

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