skillwiki 0.9.32 → 0.9.34

package/dist/{chunk-OPXMAS4O.js → chunk-KUDZOG52.js}

@@ -152,6 +152,26 @@ var CompoundSchema = z.object({
   promoted_to: wikilink.optional(),
   cssclasses: z.array(z.string()).optional()
 });
+var sessionPinPath = z.string().regex(
+  /^(entities|concepts|comparisons|queries|meta)\/.+\.md$/,
+  "must reference a typed-knowledge markdown page"
+);
+var SessionPinSchema = z.object({
+  title: z.string().min(1),
+  path: sessionPinPath,
+  scope: z.enum(["global", "project"]),
+  project: wikilink.optional(),
+  summary: z.string().min(1).optional(),
+  updated: isoDate.optional()
+}).superRefine((v, ctx) => {
+  if (v.scope === "project" && v.project === void 0) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ["project"],
+      message: "project is required when scope is project"
+    });
+  }
+});
 var MetaSchema = z.object({
   title: z.string().min(1),
   aliases: z.array(z.string()).optional(),
@@ -164,9 +184,17 @@ var MetaSchema = z.object({
   provenance_projects: z.array(wikilink).optional(),
   generated_by: z.string().min(1).optional(),
   generated_at: z.string().datetime().optional(),
-  generated_kind: z.enum(["session-brief"]).optional()
+  generated_kind: z.enum(["session-brief"]).optional(),
+  meta_kind: z.enum(["session-pins"]).optional(),
+  stale_ttl: z.number().int().positive().optional(),
+  pins: z.array(SessionPinSchema).optional()
 }).superRefine((v, ctx) => {
-  if (v.generated_kind !== "session-brief" && (!v.provenance_projects || v.provenance_projects.length < 2)) {
+  const isGeneratedSessionBrief = v.generated_kind === "session-brief";
+  const isSessionPins = v.meta_kind === "session-pins";
+  if (isSessionPins && (!v.pins || v.pins.length === 0)) {
+    ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["pins"], message: "required when meta_kind is session-pins" });
+  }
+  if (!isGeneratedSessionBrief && !isSessionPins && (!v.provenance_projects || v.provenance_projects.length < 2)) {
     ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["provenance_projects"], message: "meta pages must reference \u22652 projects" });
   }
   if (v.provenance && v.provenance !== "research" && (!v.provenance_projects || v.provenance_projects.length === 0)) {
@@ -8848,6 +8876,7 @@ export {
   ok,
   err,
   TypedKnowledgeSchema,
+  MetaSchema,
   detectSchema,
   isBlockedHost,
   splitFrontmatter,

package/dist/cli.js

@@ -2,6 +2,7 @@
 import {
   ExitCode,
   FLEET_REL_PATH,
+  MetaSchema,
   SATELLITE_STALE_MS,
   TypedKnowledgeSchema,
   appendLastOp,
@@ -73,7 +74,7 @@ import {
   triggerAutoUpdate,
   writeCache,
   writeDotenv
-} from "./chunk-OPXMAS4O.js";
+} from "./chunk-KUDZOG52.js";
 import {
   normalizeDistTag
 } from "./chunk-E6UWZ3S3.js";
@@ -1082,6 +1083,19 @@ function runVaultSyncHealth(home, syncMode) {
   const filterPath = join9(home, ".config", "rclone", "wiki-push-filters.txt");
   const checks = [];
   const pushScript = join9(shareDir, "wiki-push.sh");
+  if (syncMode === "optional" && !existsSync3(pushScript)) {
+    return {
+      status: "pass",
+      blocking: false,
+      installed: false,
+      summary: { pass: 1, info: 0, warn: 0, error: 0, skipped: 1 },
+      checks: [{
+        id: "vault_sync_installed",
+        status: "pass",
+        detail: `vault-sync not installed at ${pushScript}; optional check skipped`
+      }]
+    };
+  }
   checks.push(existsSync3(pushScript) ? { id: "vault_sync_installed", label: "Vault sync installed", status: "pass", detail: `Found: ${pushScript}` } : { id: "vault_sync_installed", label: "Vault sync installed", status: "error", detail: `Script missing: ${pushScript}` });
   if (isMac) {
     const pushPlist = join9(home, "Library", "LaunchAgents", "com.karlchow.wiki-push.plist");
@@ -1221,6 +1235,7 @@ async function runHealth(input) {
   if (!lint.result.ok) return { exitCode: lint.exitCode, result: lint.result };
   const doctorStatus = statusFromCounts(doctor.result.data.summary);
   const vaultSync = runVaultSyncHealth(input.home, syncMode);
+  const vaultSyncCoverage = syncMode === "off" ? { state: "skipped", status: "pass", reason: "--sync off" } : !vaultSync.installed && vaultSync.summary.skipped > 0 && vaultSync.summary.warn === 0 && vaultSync.summary.error === 0 ? { state: "skipped", status: vaultSync.status, reason: "vault-sync not installed and --sync optional" } : { state: "checked", status: vaultSync.status };
   const queryReadiness = deriveQueryReadiness(lint.result.data);
   const sourceFreshness = {
     status: bucketCount(lint.result.data.buckets, "stale_page") > 0 || bucketCount(lint.result.data.buckets, "file_source_url") > 0 ? "warn" : "pass",
@@ -1273,7 +1288,7 @@ async function runHealth(input) {
     coverage: {
       doctor: { state: "checked", status: doctorStatus },
       lint: { state: "checked", status: lintComponent.status },
-      vault_sync: syncMode === "off" ? { state: "skipped", status: "pass", reason: "--sync off" } : { state: "checked", status: vaultSync.status },
+      vault_sync: vaultSyncCoverage,
       query_readiness: { state: "checked", status: queryReadiness.status },
       source_freshness: { state: "checked", status: sourceFreshness.status }
     },
@@ -2372,14 +2387,27 @@ async function runSessionBrief(input) {
   const today = generatedAt.slice(0, 10);
   const project = await resolveProject(input);
   try {
-    const transcripts = await loadTranscriptInfo(scan.data.raw);
-    const workItems = await loadWorkItems(scan.data.workItems);
-    const digests = await loadTrendDigests(scan.data.typedKnowledge);
+    const [
+      transcripts,
+      workItems,
+      digests,
+      baseHealthWarnings,
+      satelliteHealth,
+      sessionPins,
+      memoryTopics
+    ] = await Promise.all([
+      loadTranscriptInfo(scan.data.raw),
+      loadWorkItems(scan.data.workItems),
+      loadTrendDigests(scan.data.typedKnowledge),
+      loadHealthWarnings(input.vault),
+      loadSatelliteHealth(input.vault),
+      loadSessionPins(input.vault, project),
+      project ? loadMemoryTopics(input.vault, project) : Promise.resolve([])
+    ]);
     const healthWarnings = [
-      ...await loadHealthWarnings(input.vault),
-      ...satelliteHealthWarnings(await loadSatelliteHealth(input.vault))
+      ...baseHealthWarnings,
+      ...satelliteHealthWarnings(satelliteHealth)
     ];
-    const memoryTopics = project ? await loadMemoryTopics(input.vault, project) : [];
     const latestLogs = newest(transcripts.filter((t) => t.kind === "session-log"), 3);
     const unclaimedCaptures = newest(transcripts.filter((t) => {
       if (t.kind !== "task" && t.kind !== "bug") return false;
@@ -2394,6 +2422,7 @@ async function runSessionBrief(input) {
     const brief = capWords(renderBrief({
       project,
       generatedAt,
+      sessionPins,
       latestLogs,
       unclaimedCaptures,
       activeWork,
@@ -2429,6 +2458,7 @@ async function runSessionBrief(input) {
         index_updated: indexUpdated,
         log_updated: logUpdated,
         generated_at: generatedAt,
+        session_pins: sessionPins,
         memory_topics: memoryTopics,
         humanHint
       })
@@ -2530,6 +2560,29 @@ async function loadTrendDigests(typedPages) {
   }
   return out;
 }
+async function loadSessionPins(vault, project) {
+  const text = await readIfExists(join15(vault, "meta", "session-pins.md"));
+  if (!text) return [];
+  const fm = extractFrontmatter(text);
+  if (!fm.ok) return [];
+  const parsed = MetaSchema.safeParse(fm.data);
+  if (!parsed.success || parsed.data.meta_kind !== "session-pins") return [];
+  const registryUpdated = parsed.data.updated;
+  const out = [];
+  for (const pin of parsed.data.pins ?? []) {
+    const pinProject = wikilinkSlug(pin.project);
+    if (pin.scope === "project" && (!project || pinProject !== project)) continue;
+    out.push({
+      path: pin.path,
+      title: pin.title,
+      summary: pin.summary ?? "",
+      date: pin.updated ?? registryUpdated,
+      project: pinProject,
+      kind: "session-pin"
+    });
+  }
+  return newest(out, 5);
+}
 function renderBrief(input) {
   const lines = [
     "# Session Brief",
@@ -2538,6 +2591,7 @@ function renderBrief(input) {
     `Scope: ${input.project ? `[[${input.project}]] plus global context` : "global context"}`,
     ""
   ];
+  appendPinnedContextSection(lines, input.sessionPins);
   appendSection(lines, "Active Work", input.activeWork, "No active project work found.");
   appendSection(lines, "Unclaimed Captures", input.unclaimedCaptures, "No unclaimed task or bug captures found.");
   appendSection(lines, "Recent Session Logs", input.project ? input.projectLogs : input.latestLogs, "No recent session logs found.");
@@ -2563,6 +2617,16 @@ function appendMemoryTopicsSection(lines, project, topics) {
   }
   lines.push("");
 }
+function appendPinnedContextSection(lines, pins) {
+  if (pins.length === 0) return;
+  lines.push("## Pinned Context", "");
+  for (const pin of pins) {
+    const date = pin.date ? `${pin.date} ` : "";
+    const summary = pin.summary ? ` \u2014 ${pin.summary}` : "";
+    lines.push(`- ${date}${pin.title} (${pin.path})${summary}`);
+  }
+  lines.push("");
+}
 function appendSection(lines, title, items, empty) {
   lines.push(`## ${title}`, "");
   if (items.length === 0) {

package/dist/skillwiki-mcp.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runSkillwikiMcpStdio
-} from "./chunk-OPXMAS4O.js";
+} from "./chunk-KUDZOG52.js";
 import "./chunk-E6UWZ3S3.js";
 
 // src/mcp-entry.ts

package/package.json

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

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

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