skillwiki 0.9.35 → 0.9.37

package/dist/cli.js

@@ -3303,6 +3303,7 @@ ${body}`;
 // src/commands/sync.ts
 import { existsSync as existsSync7 } from "fs";
 import { join as join18 } from "path";
+import { execFileSync as execFileSync2 } from "child_process";
 
 // src/utils/git.ts
 import { execFileSync } from "child_process";
@@ -3453,6 +3454,33 @@ function stageVaultContentChanges(vault) {
 }
 
 // src/commands/sync.ts
+function parseDirtyPaths(porcelain) {
+  if (!porcelain) return [];
+  return porcelain.split("\n").map((line) => line.trimEnd()).filter((line) => line.length >= 4).map((line) => {
+    const payload = line.length >= 3 && line[2] === " " ? line.slice(3) : line.length >= 2 && line[1] === " " ? line.slice(2) : line;
+    const arrow = payload.lastIndexOf(" -> ");
+    return arrow >= 0 ? payload.slice(arrow + 4) : payload;
+  }).filter((path) => path.length > 0);
+}
+function splitNonEmptyLines(text) {
+  if (!text) return [];
+  return text.split("\n").map((line) => line.trim()).filter((line) => line.length > 0);
+}
+function isTrackedNotePath(path) {
+  if (!path.endsWith(".md")) return false;
+  return !/^\.(skillwiki|claude|obsidian|antigravitycli|playwright-cli)\//.test(path);
+}
+function refHasPath(vault, ref, path) {
+  try {
+    execFileSync2("git", ["cat-file", "-e", `${ref}:${path}`], {
+      cwd: vault,
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
 function runSyncStatus(input) {
   const vault = input.vault;
   const includeStashes = input.includeStashes ?? false;
@@ -3464,6 +3492,8 @@ function runSyncStatus(input) {
         dirty: 0,
         ahead: 0,
         behind: 0,
+        unpromoted_note_paths: 0,
+        unpromoted_note_examples: [],
         last_commit: "never",
         status: "not_a_repo",
         humanHint: "not a git repository"
@@ -3473,6 +3503,8 @@ function runSyncStatus(input) {
   enableGitLongPathsOnWindows(vault);
   const porcelain = git(vault, ["status", "--porcelain"]);
   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;
@@ -3493,6 +3525,10 @@ function runSyncStatus(input) {
   } else {
     last_commit = "never";
   }
+  const remoteRef = git(vault, ["rev-parse", "--verify", "origin/main"]) ? "origin/main" : git(vault, ["rev-parse", "--verify", "origin/HEAD"]) ? "origin/HEAD" : "HEAD";
+  const unpromotedNoteAll = Array.from(/* @__PURE__ */ new Set([...dirtyPaths, ...untrackedPaths])).filter(isTrackedNotePath).filter((path) => !refHasPath(vault, remoteRef, path));
+  const unpromotedNoteExamples = unpromotedNoteAll.slice(0, 5);
+  const unpromotedNotePaths = unpromotedNoteAll.length;
   let status;
   if (dirty > 0) {
     status = "dirty";
@@ -3508,6 +3544,7 @@ function runSyncStatus(input) {
     `dirty: ${dirty}`,
     `ahead: ${ahead}`,
     `behind: ${behind}`,
+    `unpromoted_note_paths: ${unpromotedNotePaths}`,
     `last_commit: ${last_commit}`
   ];
   const exitCode = status === "clean" ? ExitCode.OK : ExitCode.LINT_HAS_WARNINGS;
@@ -3520,6 +3557,8 @@ function runSyncStatus(input) {
     dirty,
     ahead,
     behind,
+    unpromoted_note_paths: unpromotedNotePaths,
+    unpromoted_note_examples: unpromotedNoteExamples,
     last_commit,
     status,
     humanHint: hintLines.join("\n")

package/package.json

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

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

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.9.35",
+  "version": "0.9.37",
   "skills": "./",
   "description": "Project-aware Karpathy-style knowledge base for Claude Code: 18 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.9.35",
+  "version": "0.9.37",
   "description": "Project-aware Karpathy-style knowledge base for Codex with 18 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.9.35",
+  "version": "0.9.37",
   "private": true,
   "files": [
     "wiki-*",

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

@@ -216,9 +216,10 @@ git fetch origin main
 git reset --hard origin/main
 bash ~/.hermes/scripts/wiki-snapshot.sh  # Re-sync fresh
 ```
-**Prevention**: Avoid editing the GitHub repo directly via web interface or uncoordinated clones. The canonical flow is:
-- Server: rclone mount → rsync → git commit → git push
-- macOS/desktop: git pull → edit → git commit → git push → server pulls on next cron
+**Prevention**: Avoid editing the GitHub repo directly via web interface or uncoordinated clones. The canonical flow is **single-writer-git** (see `concepts/vault-write-authority-model.md`):
+- Server (sg01): rclone mount → rsync → git commit "Snapshot ..." → git push — **sole git writer to `main`**
+- macOS/desktop: edit → `wiki-push` rclone copy to S3 (NO git push) → consume sg01 snapshots via `wiki-fetch-notify` (opt-in `WIKI_FETCH_PULL_ON_DELTA=1`) or manual `skillwiki sync`
+- `wiki-sync` skill push is for **explicit** agent/human edit commits only, not automated background pushes
 2. **Slow rsync on rclone mounts**: The rclone FUSE mount can be slow for large directory listings. Use `rsync -q` (quiet) to reduce output overhead, and consider `--delete-delay` instead of `--delete` if file churn is high. The rclone mount latency can cause `du` and `find` operations to timeout — this is normal, not an error.
 3. **Golden Rule violation**: Never mix sync methods on the same vault. If using rclone mount + git snapshotting, do NOT also enable Obsidian Sync, Syncthing, or iCloud on `~/wiki`. The rclone mount IS the sync mechanism.
 4. **Credential exposure**: The rclone mount and git remote use different credentials. Ensure git credentials are cached or use HTTPS with token, but never commit rclone config to git.

package/skills/wiki-sync/SKILL.md

@@ -216,9 +216,10 @@ git fetch origin main
 git reset --hard origin/main
 bash ~/.hermes/scripts/wiki-snapshot.sh  # Re-sync fresh
 ```
-**Prevention**: Avoid editing the GitHub repo directly via web interface or uncoordinated clones. The canonical flow is:
-- Server: rclone mount → rsync → git commit → git push
-- macOS/desktop: git pull → edit → git commit → git push → server pulls on next cron
+**Prevention**: Avoid editing the GitHub repo directly via web interface or uncoordinated clones. The canonical flow is **single-writer-git** (see `concepts/vault-write-authority-model.md`):
+- Server (sg01): rclone mount → rsync → git commit "Snapshot ..." → git push — **sole git writer to `main`**
+- macOS/desktop: edit → `wiki-push` rclone copy to S3 (NO git push) → consume sg01 snapshots via `wiki-fetch-notify` (opt-in `WIKI_FETCH_PULL_ON_DELTA=1`) or manual `skillwiki sync`
+- `wiki-sync` skill push is for **explicit** agent/human edit commits only, not automated background pushes
 2. **Slow rsync on rclone mounts**: The rclone FUSE mount can be slow for large directory listings. Use `rsync -q` (quiet) to reduce output overhead, and consider `--delete-delay` instead of `--delete` if file churn is high. The rclone mount latency can cause `du` and `find` operations to timeout — this is normal, not an error.
 3. **Golden Rule violation**: Never mix sync methods on the same vault. If using rclone mount + git snapshotting, do NOT also enable Obsidian Sync, Syncthing, or iCloud on `~/wiki`. The rclone mount IS the sync mechanism.
 4. **Credential exposure**: The rclone mount and git remote use different credentials. Ensure git credentials are cached or use HTTPS with token, but never commit rclone config to git.