skillwiki 0.10.16 → 0.10.17

package/dist/{chunk-NMUYMNNB.js → chunk-IGCW3DR2.js}

@@ -6,7 +6,7 @@ import {
   err,
   getErrorMessage,
   ok
-} from "./chunk-C5OLZRRM.js";
+} from "./chunk-Y6KRDGI2.js";
 
 // src/utils/index-projection.ts
 import { readFile as readFile4 } from "fs/promises";

package/dist/{chunk-24MVNAFJ.js → chunk-IVTI3BOH.js}

@@ -19,7 +19,7 @@ import {
   splitFrontmatter,
   vaultIoConcurrency,
   writeRootIndexProjection
-} from "./chunk-NMUYMNNB.js";
+} from "./chunk-IGCW3DR2.js";
 import {
   CONFIG_KEYS,
   git,
@@ -33,7 +33,7 @@ import {
   satelliteGateFromFleetLoad,
   snapshotterAliasForLocalHost,
   writeDotenv
-} from "./chunk-OWPQJOFG.js";
+} from "./chunk-VOVXDN56.js";
 import {
   CompoundSchema,
   ExitCode,
@@ -44,8 +44,11 @@ import {
   detectSchema,
   err,
   getErrorMessage,
-  ok
-} from "./chunk-C5OLZRRM.js";
+  isVaultSyncKey,
+  ok,
+  parseVaultSyncKeyValue,
+  systemdPropertyFor
+} from "./chunk-Y6KRDGI2.js";
 
 // src/commands/log-append.ts
 import { readFile as readFile2, stat } from "fs/promises";
@@ -4774,7 +4777,7 @@ import { readFile as readFile15 } from "fs/promises";
 import { existsSync as existsSync7 } from "fs";
 import { join as join19 } from "path";
 function validateKey(key) {
-  return CONFIG_KEYS.includes(key) || isValidWikiProfileKey(key);
+  return CONFIG_KEYS.includes(key) || isValidWikiProfileKey(key) || isVaultSyncKey(key);
 }
 function configPath(home) {
   return join19(home, ".skillwiki", ".env");
@@ -4791,6 +4794,12 @@ async function runConfigSet(input) {
   if (!validateKey(input.key)) {
     return { exitCode: ExitCode.INVALID_CONFIG_KEY, result: err("INVALID_CONFIG_KEY", { key: input.key }) };
   }
+  if (isVaultSyncKey(input.key)) {
+    const parsed = parseVaultSyncKeyValue(input.key, input.value);
+    if (!parsed.ok) {
+      return { exitCode: ExitCode.INVALID_CONFIG_VALUE, result: err("INVALID_CONFIG_VALUE", { key: input.key, value: input.value, message: parsed.message }) };
+    }
+  }
   const filePath = configPath(input.home);
   try {
     let originalContent;
@@ -6521,24 +6530,6 @@ function resolveSnapshotGitWorktree(config) {
   const defaultPath = "/root/wiki-git";
   return existsSync13(defaultPath) ? defaultPath : void 0;
 }
-var SNAPSHOT_SEMANTIC_TO_SYSTEMD = {
-  load_state: "LoadState",
-  unit_file_state: "UnitFileState",
-  active_state: "ActiveState",
-  sub_state: "SubState",
-  next_elapse: "NextElapseUSecRealtime",
-  result: "Result",
-  exec_main_status: "ExecMainStatus",
-  exec_main_code: "ExecMainCode",
-  active_enter_timestamp: "ActiveEnterTimestamp",
-  inactive_enter_timestamp: "InactiveEnterTimestamp",
-  exec_main_start_timestamp: "ExecMainStartTimestamp",
-  exec_main_exit_timestamp: "ExecMainExitTimestamp",
-  invocation_id: "InvocationID"
-};
-function semanticToSystemdProp(semantic) {
-  return SNAPSHOT_SEMANTIC_TO_SYSTEMD[semantic];
-}
 function normalizeSystemdValue(raw) {
   if (raw == null) return void 0;
   const v = raw.trim();
@@ -6577,7 +6568,7 @@ function snapshotProp(kind, prop, fixture, scope) {
     return v == null ? void 0 : String(v);
   }
   const unit = kind === "timer" ? "wiki-snapshot.timer" : "wiki-snapshot.service";
-  const liveProp = semanticToSystemdProp(prop);
+  const liveProp = systemdPropertyFor(prop);
   if (!liveProp) return void 0;
   return systemctlShowProperty(scope, unit, liveProp);
 }
@@ -6594,7 +6585,8 @@ function snapshotterHealthChecks(scope, logDir, env) {
   const fixture = loadSnapshotFixture(env);
   const cadence = fixture ? fixture.cadence_minutes : parseInt(env.VS_SNAPSHOT_CADENCE_MINUTES ?? "30", 10) || 30;
   const timeout = fixture ? fixture.service_timeout_seconds : parseInt(env.VS_SNAPSHOT_SERVICE_TIMEOUT_SECONDS ?? "900", 10) || 900;
-  const nowMs = fixture ? Date.parse(fixture.now) : Date.now();
+  const injectedNowMs = env.VS_SNAPSHOT_HEALTH_NOW ? Date.parse(env.VS_SNAPSHOT_HEALTH_NOW) : Number.NaN;
+  const nowMs = fixture ? Date.parse(fixture.now) : Number.isFinite(injectedNowMs) ? injectedNowMs : Date.now();
   const warnAge = cadence * 2 + 15;
   const errorAge = cadence * 4 + 15;
   const tUnitfile = snapshotProp("timer", "unit_file_state", fixture, scope);
@@ -6781,7 +6773,7 @@ function vaultSyncChecks(input) {
       execSync2(`launchctl print gui/${uid}/com.karlchow.wiki-push`, {
         encoding: "utf8",
         timeout: 2e3,
-        stdio: ["pipe", "pipe", "pipe"]
+        stdio: ["pipe", "ignore", "ignore"]
       });
       c2 = check(
         "pass",

package/dist/{chunk-UJLSUJB6.js → chunk-RNPDHSGX.js}

@@ -8,12 +8,12 @@ import {
   loadFleetManifestAndHost,
   runVaultSyncPullHelper,
   supersedeStaleReviewRequiredJournals
-} from "./chunk-OWPQJOFG.js";
+} from "./chunk-VOVXDN56.js";
 import {
   ExitCode,
   err,
   ok
-} from "./chunk-C5OLZRRM.js";
+} from "./chunk-Y6KRDGI2.js";
 
 // src/utils/managed-write-preflight.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";

package/dist/{chunk-OWPQJOFG.js → chunk-VOVXDN56.js}

@@ -3,8 +3,9 @@ import {
   ExitCode,
   FleetManifestSchema,
   err,
+  isVaultSyncKey,
   ok
-} from "./chunk-C5OLZRRM.js";
+} from "./chunk-Y6KRDGI2.js";
 
 // src/utils/dotenv.ts
 import { readFile, writeFile, mkdir } from "fs/promises";
@@ -40,7 +41,7 @@ function parseDotenvText(text) {
     if (eq <= 0) continue;
     const key = line.slice(0, eq).trim();
     const value = line.slice(eq + 1).trim();
-    if (!_whitelist.has(key) && !isValidWikiProfileKey(key)) continue;
+    if (!_whitelist.has(key) && !isValidWikiProfileKey(key) && !isVaultSyncKey(key)) continue;
     if (value.length === 0) continue;
     out[key] = value;
   }

package/dist/{chunk-C5OLZRRM.js → chunk-Y6KRDGI2.js}

@@ -55,7 +55,8 @@ var ExitCode = {
   FLEET_MANIFEST_INVALID: 50,
   SENSITIVE_CONTENT_DETECTED: 51,
   FLEET_SATELLITE_HEALTH_FAILED: 52,
-  PROTECTED_SNAPSHOTTER_WRITE_BLOCKED: 53
+  PROTECTED_SNAPSHOTTER_WRITE_BLOCKED: 53,
+  INVALID_CONFIG_VALUE: 54
 };
 
 // ../shared/src/json-output.ts
@@ -285,6 +286,47 @@ var FleetManifestSchema = z.object({
     }
   }
 });
+var vaultSyncRole = z.enum(["leaf", "snapshotter", "none"]);
+var vaultSyncScheduler = z.enum(["systemd", "launchd", "none"]);
+var vaultSyncScope = z.enum(["user", "system", "none"]);
+var vaultSyncBool = z.enum(["true", "false"]);
+var vaultSyncDuration = z.union([
+  z.string().regex(/^[1-9][0-9]*[mhs]$/, "must be <positive-int>m|h|s (e.g. 15m, 300s) or none"),
+  z.literal("none")
+]);
+var vaultSyncPathOrNone = z.union([
+  absolutePath,
+  z.literal("none")
+]);
+var VaultSyncConfigSchema = z.object({
+  "vault_sync.installed": vaultSyncBool,
+  "vault_sync.role": vaultSyncRole,
+  "vault_sync.scheduler": vaultSyncScheduler,
+  "vault_sync.service_scope": vaultSyncScope,
+  "vault_sync.snapshot_profile": vaultSyncPathOrNone,
+  "vault_sync.snapshot_script": vaultSyncPathOrNone,
+  "vault_sync.snapshot_worktree": vaultSyncPathOrNone,
+  "vault_sync.fuse_refresh_enabled": vaultSyncBool,
+  "vault_sync.fuse_refresh_interval": vaultSyncDuration,
+  "vault_sync.fuse_max_dir_cache": vaultSyncDuration,
+  "vault_sync.fuse_service_scope": vaultSyncScope
+}).strict();
+var VAULT_SYNC_KEYS = Object.keys(VaultSyncConfigSchema.shape);
+function isVaultSyncKey(key) {
+  return VAULT_SYNC_KEYS.includes(key);
+}
+function parseVaultSyncKeyValue(key, value) {
+  if (!isVaultSyncKey(key)) {
+    return { ok: false, message: `unknown vault_sync key: ${key}` };
+  }
+  const fieldSchema = VaultSyncConfigSchema.shape[key];
+  const parsed = fieldSchema.safeParse(value);
+  if (parsed.success) {
+    return { ok: true };
+  }
+  const first = parsed.error.issues[0];
+  return { ok: false, message: first?.message ?? "invalid value" };
+}
 function detectSchema(fm) {
   const COMPOUND_TYPES = /* @__PURE__ */ new Set(["lesson", "pattern", "antipattern", "gotcha"]);
   if (typeof fm.type === "string" && COMPOUND_TYPES.has(fm.type) && "project" in fm) return { schema: "compound" };
@@ -341,6 +383,29 @@ function getErrorMessage(e) {
   return e instanceof Error ? e.message : String(e);
 }
 
+// ../shared/src/systemd-property-catalog.json
+var systemd_property_catalog_default = {
+  load_state: "LoadState",
+  unit_file_state: "UnitFileState",
+  active_state: "ActiveState",
+  sub_state: "SubState",
+  next_elapse: "NextElapseUSecRealtime",
+  result: "Result",
+  exec_main_status: "ExecMainStatus",
+  exec_main_code: "ExecMainCode",
+  active_enter_timestamp: "ActiveEnterTimestamp",
+  inactive_enter_timestamp: "InactiveEnterTimestamp",
+  exec_main_start_timestamp: "ExecMainStartTimestamp",
+  exec_main_exit_timestamp: "ExecMainExitTimestamp",
+  invocation_id: "InvocationID"
+};
+
+// ../shared/src/systemd-property-catalog.ts
+var SYSTEMD_PROPERTY_CATALOG = Object.freeze({ ...systemd_property_catalog_default });
+function systemdPropertyFor(semantic) {
+  return SYSTEMD_PROPERTY_CATALOG[semantic];
+}
+
 export {
   ExitCode,
   ok,
@@ -351,7 +416,10 @@ export {
   CompoundSchema,
   MetaSchema,
   FleetManifestSchema,
+  isVaultSyncKey,
+  parseVaultSyncKeyValue,
   detectSchema,
   isBlockedHost,
-  getErrorMessage
+  getErrorMessage,
+  systemdPropertyFor
 };

package/dist/cli.js

@@ -83,7 +83,7 @@ import {
   upsertIndexEntry,
   validateLogEvent,
   writeLogEvent
-} from "./chunk-24MVNAFJ.js";
+} from "./chunk-IVTI3BOH.js";
 import {
   normalizeDistTag,
   readCache,
@@ -105,13 +105,13 @@ import {
   scanVault,
   splitFrontmatter,
   writeRootIndexProjection
-} from "./chunk-NMUYMNNB.js";
+} from "./chunk-IGCW3DR2.js";
 import {
   acquireManagedWriteLock,
   releaseManagedWriteLock,
   runManagedWritePreflight,
   runManagedWriteTransaction
-} from "./chunk-UJLSUJB6.js";
+} from "./chunk-RNPDHSGX.js";
 import {
   FLEET_REL_PATH,
   canSupersedeJournal,
@@ -138,7 +138,7 @@ import {
   snapshotterAliasForLocalHost,
   supersedeStaleReviewRequiredJournals,
   writeDotenv
-} from "./chunk-OWPQJOFG.js";
+} from "./chunk-VOVXDN56.js";
 import {
   ExitCode,
   MetaSchema,
@@ -146,7 +146,7 @@ import {
   err,
   isBlockedHost,
   ok
-} from "./chunk-C5OLZRRM.js";
+} from "./chunk-Y6KRDGI2.js";
 
 // src/cli.ts
 import { join as join37 } from "path";
@@ -3234,7 +3234,7 @@ ${fmRewritten}
   await rename2(join19(input.vault, relPath), join19(input.vault, archivePath));
   let indexUpdated = false;
   if (!isRaw) {
-    const { renderRootIndex: renderRootIndex2, writeRootIndexProjection: writeRootIndexProjection2 } = await import("./index-projection-MHXG7QO2.js");
+    const { renderRootIndex: renderRootIndex2, writeRootIndexProjection: writeRootIndexProjection2 } = await import("./index-projection-DENEYZTK.js");
     const before = await readFile7(join19(input.vault, "index.md"), "utf8").catch(() => "");
     const fullTarget = relPath.replace(/\.md$/, "");
     const bare = fullTarget.split("/").pop() ?? fullTarget;
@@ -3345,7 +3345,7 @@ async function runRemove(input) {
   if (relPath.endsWith(".md") && !relPath.startsWith("raw/")) {
     const { readFile: readFile17 } = await import("fs/promises");
     const { join: pathJoin } = await import("path");
-    const { renderRootIndex: renderRootIndex2, writeRootIndexProjection: writeRootIndexProjection2 } = await import("./index-projection-MHXG7QO2.js");
+    const { renderRootIndex: renderRootIndex2, writeRootIndexProjection: writeRootIndexProjection2 } = await import("./index-projection-DENEYZTK.js");
     const before = await readFile17(pathJoin(input.vault, "index.md"), "utf8").catch(() => "");
     const fullTarget = relPath.replace(/\.md$/, "");
     const bare = fullTarget.split("/").pop() ?? fullTarget;
@@ -7893,7 +7893,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-M2HL6DDY.js");
+  const { runManagedWriteTransaction: runManagedWriteTransaction2 } = await import("./managed-write-preflight-IDIQYSWI.js");
   const run = await runManagedWriteTransaction2({
     vault,
     command,

package/dist/{index-projection-MHXG7QO2.js → index-projection-DENEYZTK.js}

@@ -4,8 +4,8 @@ import {
   UNMANAGED_START,
   renderRootIndex,
   writeRootIndexProjection
-} from "./chunk-NMUYMNNB.js";
-import "./chunk-C5OLZRRM.js";
+} from "./chunk-IGCW3DR2.js";
+import "./chunk-Y6KRDGI2.js";
 export {
   UNMANAGED_END,
   UNMANAGED_START,

package/dist/{managed-write-preflight-M2HL6DDY.js → managed-write-preflight-IDIQYSWI.js}

@@ -2,9 +2,9 @@
 import {
   runManagedWritePreflight,
   runManagedWriteTransaction
-} from "./chunk-UJLSUJB6.js";
-import "./chunk-OWPQJOFG.js";
-import "./chunk-C5OLZRRM.js";
+} from "./chunk-RNPDHSGX.js";
+import "./chunk-VOVXDN56.js";
+import "./chunk-Y6KRDGI2.js";
 export {
   runManagedWritePreflight,
   runManagedWriteTransaction

package/dist/skillwiki-mcp.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   runSkillwikiMcpStdio
-} from "./chunk-24MVNAFJ.js";
+} from "./chunk-IVTI3BOH.js";
 import "./chunk-7I2TPIV5.js";
-import "./chunk-NMUYMNNB.js";
-import "./chunk-OWPQJOFG.js";
-import "./chunk-C5OLZRRM.js";
+import "./chunk-IGCW3DR2.js";
+import "./chunk-VOVXDN56.js";
+import "./chunk-Y6KRDGI2.js";
 
 // src/mcp-entry.ts
 runSkillwikiMcpStdio().catch((error) => {

package/dist/vault-sync/scripts/generate-systemd-property-catalog.mjs

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+
+import { readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const scriptDir = dirname(fileURLToPath(import.meta.url));
+const repoRoot = join(scriptDir, "..", "..", "..");
+const catalogPath = join(
+  repoRoot,
+  "packages",
+  "shared",
+  "src",
+  "systemd-property-catalog.json",
+);
+const outputPath = join(
+  repoRoot,
+  "packages",
+  "vault-sync",
+  "skills",
+  "vault-sync-status",
+  "systemd-property-catalog.sh",
+);
+const checkOnly = process.argv.includes("--check");
+
+const catalog = JSON.parse(readFileSync(catalogPath, "utf8"));
+const entries = Object.entries(catalog);
+const invalid = entries.find(([semantic, property]) =>
+  !/^[a-z][a-z0-9_]*$/.test(semantic)
+  || typeof property !== "string"
+  || !/^[A-Z][A-Za-z0-9]*$/.test(property)
+);
+if (invalid) {
+  throw new Error(`invalid systemd property catalog entry: ${JSON.stringify(invalid)}`);
+}
+
+const lines = [
+  "#!/usr/bin/env bash",
+  "# AUTO-GENERATED by packages/vault-sync/scripts/generate-systemd-property-catalog.mjs.",
+  "# Source: packages/shared/src/systemd-property-catalog.json",
+  "# Do not edit this file directly.",
+  "",
+  "snapshot_semantic_to_systemd_prop() {",
+  '  case "$1" in',
+  ...entries.map(([semantic, property]) =>
+    `    ${semantic}) printf '${property}\\n' ;;`
+  ),
+  "    # Closed map: never pass unknown/snake_case keys through to systemctl.",
+  "    *) return 1 ;;",
+  "  esac",
+  "}",
+  "",
+].join("\n");
+
+if (checkOnly) {
+  let current = "";
+  try {
+    current = readFileSync(outputPath, "utf8");
+  } catch {
+    // Report the same actionable drift error for a missing generated file.
+  }
+  if (current !== lines) {
+    console.error(
+      "systemd property catalog shell adapter is stale; run "
+      + "node packages/vault-sync/scripts/generate-systemd-property-catalog.mjs",
+    );
+    process.exit(1);
+  }
+  console.log("systemd property catalog shell adapter is current");
+} else {
+  writeFileSync(outputPath, lines);
+  console.log(`wrote ${outputPath}`);
+}

package/package.json

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

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

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.16",
+  "version": "0.10.17",
   "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.16",
+  "version": "0.10.17",
   "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.16",
+  "version": "0.10.17",
   "private": true,
   "files": [
     "wiki-*",