skillwiki 0.9.33 → 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";
@@ -2386,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;
@@ -2408,6 +2422,7 @@ async function runSessionBrief(input) {
     const brief = capWords(renderBrief({
       project,
       generatedAt,
+      sessionPins,
       latestLogs,
       unclaimedCaptures,
       activeWork,
@@ -2443,6 +2458,7 @@ async function runSessionBrief(input) {
         index_updated: indexUpdated,
         log_updated: logUpdated,
         generated_at: generatedAt,
+        session_pins: sessionPins,
         memory_topics: memoryTopics,
         humanHint
       })
@@ -2544,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",
@@ -2552,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.");
@@ -2577,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.33",
+  "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.33",
+  "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.33",
+  "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.33",
+  "version": "0.9.34",
   "private": true,
   "files": [
     "wiki-*",