skillwiki 0.8.1-beta.3 → 0.8.1-beta.5

package/dist/cli.js

@@ -4103,6 +4103,37 @@ function writeTest(dir) {
   }
   return { success: true, writeMs, readMs: Date.now() - readStart, size: Buffer.byteLength(payload, "utf8") };
 }
+var DURATION_UNIT_SECONDS = {
+  ms: 1 / 1e3,
+  s: 1,
+  m: 60,
+  h: 3600,
+  d: 86400,
+  w: 604800
+};
+function parseDurationSeconds(raw) {
+  const input = raw.trim().toLowerCase();
+  if (!input) return null;
+  if (/^\d+(?:\.\d+)?$/.test(input)) {
+    const num = parseFloat(input);
+    return Number.isFinite(num) ? num : null;
+  }
+  const re = /(\d+(?:\.\d+)?)(ms|s|m|h|d|w)/g;
+  let total = 0;
+  let consumed = 0;
+  for (const match of input.matchAll(re)) {
+    const full = match[0];
+    const value = parseFloat(match[1]);
+    const unit = match[2];
+    if (!Number.isFinite(value)) return null;
+    const factor = DURATION_UNIT_SECONDS[unit];
+    if (factor === void 0) return null;
+    total += value * factor;
+    consumed += full.length;
+  }
+  if (consumed !== input.length) return null;
+  return total;
+}
 var FLAG_THRESHOLDS = {
   "--vfs-write-back": { min: 15, unit: "s", label: "VFS write-back window" },
   "--vfs-write-wait": { min: 10, unit: "s", label: "VFS write-wait" },
@@ -4495,6 +4526,73 @@ function checkS3MountPerf(resolvedPath) {
     `S3 FUSE mount, cache warm (rg scan: ${elapsed.toFixed(3)}s)`
   );
 }
+var MAX_DIR_CACHE_TIME_SECONDS = 15 * 60;
+function formatDurationForHumans(seconds) {
+  if (!Number.isFinite(seconds)) return `${seconds}s`;
+  if (seconds >= 3600) return `${(seconds / 3600).toFixed(1)}h`;
+  if (seconds >= 60) return `${(seconds / 60).toFixed(1)}m`;
+  if (seconds >= 1) return `${seconds.toFixed(1)}s`;
+  return `${Math.round(seconds * 1e3)}ms`;
+}
+function checkS3MountFreshness(resolvedPath) {
+  if (!resolvedPath) {
+    return check("pass", "s3_mount_freshness", "S3 visibility freshness", "No vault path \u2014 check skipped");
+  }
+  const fuse = detectFuseMount(resolvedPath);
+  if (!fuse) {
+    return check("pass", "s3_mount_freshness", "S3 visibility freshness", "local disk \u2014 check skipped");
+  }
+  const pid = findRcloneMountPid();
+  if (pid === null) {
+    return check(
+      "warn",
+      "s3_mount_freshness",
+      "S3 visibility freshness",
+      `S3 FUSE mount (${fuse.mountPoint}) but no rclone process found \u2014 cannot audit --dir-cache-time`
+    );
+  }
+  const flags = parseRcloneFlags(pid);
+  if (flags.size === 0) {
+    return check(
+      "warn",
+      "s3_mount_freshness",
+      "S3 visibility freshness",
+      `rclone PID ${pid} found but could not parse flags`
+    );
+  }
+  const raw = flags.get("--dir-cache-time");
+  if (!raw) {
+    return check(
+      "pass",
+      "s3_mount_freshness",
+      "S3 visibility freshness",
+      "PID " + pid + ": --dir-cache-time not set (rclone default 5m, within <=15m SLA)"
+    );
+  }
+  const seconds = parseDurationSeconds(raw);
+  if (seconds === null) {
+    return check(
+      "warn",
+      "s3_mount_freshness",
+      "S3 visibility freshness",
+      `PID ${pid}: could not parse --dir-cache-time=${raw}`
+    );
+  }
+  if (seconds > MAX_DIR_CACHE_TIME_SECONDS) {
+    return check(
+      "warn",
+      "s3_mount_freshness",
+      "S3 visibility freshness",
+      `PID ${pid}: --dir-cache-time=${raw} (${formatDurationForHumans(seconds)}) exceeds 15m SLA \u2014 external S3 changes may remain invisible`
+    );
+  }
+  return check(
+    "pass",
+    "s3_mount_freshness",
+    "S3 visibility freshness",
+    `PID ${pid}: --dir-cache-time=${raw} (${formatDurationForHumans(seconds)}), within <=15m SLA`
+  );
+}
 function checkRcloneFlagAudit(resolvedPath) {
   if (!resolvedPath) {
     return check("pass", "rclone_flags", "rclone VFS flags", "No vault path \u2014 check skipped");
@@ -4518,11 +4616,8 @@ function checkRcloneFlagAudit(resolvedPath) {
       warnings.push(`${flag} not set (default may be unsafe)`);
       continue;
     }
-    const value = parseFloat(raw);
-    if (isNaN(value)) continue;
-    let inSeconds = value;
-    if (raw.endsWith("h")) inSeconds = value * 3600;
-    else if (raw.endsWith("m")) inSeconds = value * 60;
+    const inSeconds = parseDurationSeconds(raw);
+    if (inSeconds === null) continue;
     const thresholdSec = threshold.unit === "h" ? threshold.min * 3600 : threshold.unit === "m" ? threshold.min * 60 : threshold.min;
     if (inSeconds < thresholdSec) {
       warnings.push(`${flag}=${raw} (recommended \u2265${threshold.min}${threshold.unit})`);
@@ -4986,6 +5081,55 @@ function findSkillNames(dir) {
   }
   return results;
 }
+var METRIC_TYPES = ["entities", "concepts", "comparisons", "queries", "meta"];
+async function vaultMetrics(resolvedPath) {
+  const ids = [
+    ["vault_metric_pages", "Vault pages by type"],
+    ["vault_metric_orphans", "Vault orphan rate"],
+    ["vault_metric_bridges", "Vault bridge count"],
+    ["vault_metric_cohesion", "Mean community cohesion"],
+    ["vault_metric_log_size", "Vault log size"]
+  ];
+  const noVault = () => ids.map(([id, label]) => check("info", id, label, "no vault configured"));
+  if (!resolvedPath) return noVault();
+  const scan = await scanVault(resolvedPath);
+  if (!scan.ok) return noVault();
+  const tk = scan.data.typedKnowledge;
+  const perType = METRIC_TYPES.map((d) => `${d} ${tk.filter((p) => p.relPath.startsWith(d + "/")).length}`).join(", ");
+  const adj = await buildWikilinkAdjacency(tk);
+  const g = toUndirectedWeighted(adj);
+  const nodes = [...g.keys()];
+  const total = nodes.length;
+  const orphanCount = nodes.filter((n) => g.get(n).size === 0).length;
+  const orphanRate = total > 0 ? Math.round(orphanCount / total * 1e3) / 10 : 0;
+  const comm = louvain(g);
+  const groups = /* @__PURE__ */ new Map();
+  for (const [node, c] of comm) {
+    const arr = groups.get(c);
+    if (arr) arr.push(node);
+    else groups.set(c, [node]);
+  }
+  const cohesions = [...groups.values()].filter((m) => m.length >= 2).map((m) => communityCohesion(m, g));
+  const meanCohesion = cohesions.length > 0 ? Math.round(cohesions.reduce((a, b) => a + b, 0) / cohesions.length * 1e3) / 1e3 : 0;
+  let bridges = 0;
+  for (const n of nodes) {
+    const nbrComms = /* @__PURE__ */ new Set();
+    for (const nb of g.get(n).keys()) nbrComms.add(comm.get(nb));
+    if (nbrComms.size >= 3) bridges++;
+  }
+  let logLines = 0;
+  try {
+    logLines = readFileSync7(join26(resolvedPath, "log.md"), "utf8").split("\n").length;
+  } catch {
+  }
+  return [
+    check("info", "vault_metric_pages", "Vault pages by type", `${total} typed (${perType})`),
+    check("info", "vault_metric_orphans", "Vault orphan rate", `${orphanRate}% (${orphanCount}/${total} degree-0)`),
+    check("info", "vault_metric_bridges", "Vault bridge count", `${bridges} page(s) link >= 3 communities`),
+    check("info", "vault_metric_cohesion", "Mean community cohesion", `${meanCohesion} across ${cohesions.length} communities (size >= 2)`),
+    check("info", "vault_metric_log_size", "Vault log size", `${logLines} lines`)
+  ];
+}
 async function runDoctor(input) {
   const checks = [];
   const vsConfig = readVaultSyncConfig(input.home);
@@ -5008,6 +5152,7 @@ async function runDoctor(input) {
   checks.push(checkSyncLastPush(resolvedPath));
   checks.push(checkDotStoreClean(resolvedPath));
   checks.push(checkS3MountPerf(resolvedPath));
+  checks.push(checkS3MountFreshness(resolvedPath));
   checks.push(checkRcloneFlagAudit(resolvedPath));
   checks.push(checkRcloneVersion(resolvedPath, vsConfig.installed));
   checks.push(checkWriteTest(resolvedPath));
@@ -5021,6 +5166,7 @@ async function runDoctor(input) {
     vaultSyncInstalled: vsConfig.installed,
     vaultSyncRole: vsConfig.role
   }));
+  checks.push(...await vaultMetrics(resolvedPath));
   const summary = {
     pass: checks.filter((c) => c.status === "pass").length,
     info: checks.filter((c) => c.status === "info").length,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.8.1-beta.3",
+  "version": "0.8.1-beta.5",
   "type": "module",
   "bin": {
     "skillwiki": "dist/cli.js"

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

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.8.1-beta.3",
+  "version": "0.8.1-beta.5",
   "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.8.1-beta.3",
+  "version": "0.8.1-beta.5",
   "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.8.1-beta.3",
+  "version": "0.8.1-beta.5",
   "private": true,
   "files": [
     "wiki-*",