skillwiki 0.8.1-beta.4 → 0.8.1-beta.6

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})`);
@@ -5057,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));

package/package.json

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

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

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.8.1-beta.4",
+  "version": "0.8.1-beta.6",
   "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.4",
+  "version": "0.8.1-beta.6",
   "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/hooks/session-start

@@ -21,7 +21,7 @@ escape_for_json() {
 }
 
 skill_escaped=$(escape_for_json "$skill_content")
-session_context="<EXTREMELY_IMPORTANT>\nYou have skillwiki.\n\n**Below is the full content of your 'skillwiki:using-skillwiki' skill - your introduction to the skillwiki skills. For all other skills, use the 'Skill' tool:**\n\n${skill_escaped}\n</EXTREMELY_IMPORTANT>"
+session_context="### Skillwiki Activation\n\nSkillwiki is active for this workspace. Below are the capability guidelines for local reference:\n\n${skill_escaped}"
 
 # Uses printf instead of heredoc to work around bash 5.3+ heredoc hang.
 printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "SessionStart",\n    "additionalContext": "%s"\n  }\n}\n' "$session_context"

package/skills/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillwiki/skills",
-  "version": "0.8.1-beta.4",
+  "version": "0.8.1-beta.6",
   "private": true,
   "files": [
     "wiki-*",

package/skills/using-skillwiki/SKILL.md

@@ -3,16 +3,15 @@ version: 0.2.2
 name: using-skillwiki
 description: Invoke at session start or when knowledge-base tasks arise — maps skillwiki skills, dev-loop alignment, and PRD/TDD routing with plan-mode gate checks
 ---
-<SUBAGENT-STOP>
-If you were dispatched as a subagent to execute a specific task, skip this skill.
-</SUBAGENT-STOP>
+*Note: If executing as a background subagent, skip this skill section.*
+
 # using-skillwiki
 You have skillwiki — a project-aware Karpathy-style knowledge base for Claude Code.
 
 ## Last Hook Gate (SessionStart)
 
-This skill is injected by the plugin SessionStart hook on `startup|clear|compact`.
-Treat this section as the final gate before planning work:
+This skill is activated by the plugin during `startup|clear|compact` lifecycle events.
+Use this section as procedural planning guidelines:
 
 1. If the task requires spec/plan work, route through PRD skills (not built-in plan mode).
 2. If `prd_layer` is `superpowers` or `tdd`, ensure `EnterPlanMode` is gated (`wiki-gate-plan-mode on` or `status` if uncertain).