@theglitchking/semantic-memory 1.6.0 → 1.7.0

package/dist/{profile-UE4YVTDC.js → profile-SNULTJ27.js}

@@ -5,10 +5,11 @@ import {
   readSpeakerProfile,
   speakerProfileTemplate,
   updateProfileSection
-} from "./chunk-WZEKIUYG.js";
-import "./chunk-XAXK7NM4.js";
-import "./chunk-LGQPP5FQ.js";
-import "./chunk-OEF5U5GV.js";
+} from "./chunk-6TIKWOY4.js";
+import "./chunk-EXAUVIGW.js";
+import "./chunk-EYVFC745.js";
+import "./chunk-J7LYDRML.js";
+import "./chunk-H2BES6FU.js";
 import "./chunk-PZ5AY32C.js";
 export {
   PROFILE_SECTIONS,
@@ -18,4 +19,4 @@ export {
   speakerProfileTemplate,
   updateProfileSection
 };
-//# sourceMappingURL=profile-UE4YVTDC.js.map
+//# sourceMappingURL=profile-SNULTJ27.js.map

package/dist/profile-SNULTJ27.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{schema-LY6533NJ.js → schema-RDYUK6CC.js}

@@ -2,11 +2,12 @@ import {
   installDefaultSchema,
   loadSchema,
   validateNote
-} from "./chunk-FURCIJBO.js";
+} from "./chunk-Y7H76Q7F.js";
+import "./chunk-J7LYDRML.js";
 import "./chunk-PZ5AY32C.js";
 export {
   installDefaultSchema,
   loadSchema,
   validateNote
 };
-//# sourceMappingURL=schema-LY6533NJ.js.map
+//# sourceMappingURL=schema-RDYUK6CC.js.map

package/dist/schema-RDYUK6CC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{search-MZC4DC7H.js → search-325ULY57.js}

@@ -3,10 +3,11 @@ import {
   GraphBuilder,
   TextSearch,
   VectorIndex
-} from "./chunk-44BQDRXD.js";
+} from "./chunk-SHSOCFJH.js";
 import {
   Indexer
-} from "./chunk-IGHCVAAL.js";
+} from "./chunk-CJUY55GG.js";
+import "./chunk-J7LYDRML.js";
 import "./chunk-PZ5AY32C.js";
 
 // src/cli/search.ts
@@ -210,4 +211,4 @@ export {
   openSearch,
   runSearch
 };
-//# sourceMappingURL=search-MZC4DC7H.js.map
+//# sourceMappingURL=search-325ULY57.js.map

package/dist/{search-MZC4DC7H.js.map → search-325ULY57.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli/search.ts"],"sourcesContent":["import { join, resolve } from \"node:path\";\nimport { existsSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { Indexer } from \"../core/indexer.js\";\nimport { Embedder } from \"../core/embedder.js\";\nimport { GraphBuilder } from \"../core/graph.js\";\nimport { VectorIndex } from \"../core/vector.js\";\nimport { TextSearch } from \"../core/search-text.js\";\nimport type { IndexedDocument } from \"../core/types.js\";\n\nexport interface SearchCliOptions {\n  notes: string;\n  query: string;\n  limit?: number;\n  textOnly?: boolean;\n  json?: boolean;\n}\n\nexport interface SearchHit {\n  path: string;\n  title?: string;\n  score: number;\n  snippet?: string;\n  mtime?: string;\n}\n\nexport async function runSearch(opts: SearchCliOptions): Promise<SearchHit[]> {\n  const searcher = await openSearch(opts.notes, { textOnly: opts.textOnly });\n  return searcher.search(opts.query, opts.limit ?? 8);\n}\n\nexport interface Searcher {\n  search(query: string, limit?: number): Promise<SearchHit[]>;\n}\n\n/**\n * Load a notes folder once and search it many times — the same scoring the hook's CLI search uses.\n * The hook spawns `search` per prompt; the failure eval reuses one Searcher per corpus.\n */\nexport async function openSearch(notes: string, opts: { textOnly?: boolean } = {}): Promise<Searcher> {\n  const notesPath = resolve(notes);\n  if (!existsSync(notesPath)) {\n    throw new Error(`notes directory not found: ${notesPath}`);\n  }\n\n  const indexer = new Indexer(notesPath);\n  const indexPath = join(notesPath, \".semantic-sidekick-index\");\n\n  // Prefer the parsed-doc cache written by reindex — avoids re-parsing 500+ files\n  // on every hook call. Falls back to a full parse if the cache is missing.\n  let documents = existsSync(indexPath) ? await indexer.loadDocsCache(indexPath) : null;\n  if (!documents) {\n    documents = await indexer.indexAll();\n  }\n  if (documents.length === 0) return { search: async () => [] };\n  const docs = documents;\n\n  if (opts.textOnly) {\n    const textSearch = new TextSearch();\n    textSearch.setDocuments(docs);\n    return { search: async (query, limit = 8) => textHits(textSearch, docs, query, limit) };\n  }\n\n  // Hybrid path: load cached index, embed query, search + graph rerank.\n  if (!existsSync(indexPath)) {\n    throw new Error(`index not built at ${indexPath} — run: semantic-sidekick --notes ${notesPath} --reindex`);\n  }\n\n  const embedder = new Embedder();\n  await embedder.init();\n\n  const metaPath = join(indexPath, \"meta.json\");\n  if (existsSync(metaPath)) {\n    try {\n      const meta = JSON.parse(await readFile(metaPath, \"utf-8\")) as { model?: string };\n      if (meta.model && meta.model !== embedder.getModel()) {\n        throw new Error(`model mismatch (cached=${meta.model}, current=${embedder.getModel()}) — run --reindex`);\n      }\n    } catch (e) {\n      if (e instanceof Error && e.message.startsWith(\"model mismatch\")) throw e;\n    }\n  }\n\n  const vectorIndex = new VectorIndex(embedder.getDimensions());\n  const loaded = await vectorIndex.load(indexPath);\n  if (!loaded) {\n    throw new Error(`could not load vector index at ${indexPath} — run --reindex`);\n  }\n\n  const graph = new GraphBuilder();\n  await graph.load(indexPath);\n\n  const docByPath = new Map(docs.map((d) => [d.path, d]));\n  return {\n    async search(query, limit = 8) {\n      const queryEmbed = await embedder.embed(query);\n      const semantic = vectorIndex.search(queryEmbed, limit * 3);\n      const graphResults = graph.searchGraph(query, 2);\n      const graphPaths = new Set(graphResults.map((r) => r.path));\n\n      const hybrid = semantic\n        .map((r) => {\n          const doc = docByPath.get(r.path);\n          let score = graphPaths.has(r.path) ? r.score * 1.3 : r.score;\n          if (doc?.loadPriority !== undefined) {\n            score *= 1 + (doc.loadPriority - 5) * 0.04;\n          }\n          return { ...r, score };\n        })\n        .sort((a, b) => b.score - a.score)\n        .slice(0, limit);\n\n      return hybrid.map((r) => {\n        const doc = docByPath.get(r.path);\n        return {\n          path: r.path,\n          title: (r as any).title ?? doc?.title,\n          score: r.score,\n          snippet: (r as any).snippet,\n          mtime: doc?.mtime,\n        };\n      });\n    },\n  };\n}\n\nfunction textHits(textSearch: TextSearch, documents: IndexedDocument[], query: string, limit: number): SearchHit[] {\n  const keywords = extractKeywords(query);\n  if (keywords.length === 0) return [];\n  const scoreByPath = new Map<string, { hits: number; firstSnippet?: string; title?: string; mtime: string }>();\n  for (const kw of keywords) {\n    const results = textSearch.search({ pattern: kw, limit: 50 });\n    for (const r of results) {\n      const existing = scoreByPath.get(r.path);\n      const doc = documents.find((d) => d.path === r.path);\n      if (existing) {\n        existing.hits += 1;\n      } else {\n        scoreByPath.set(r.path, {\n          hits: 1,\n          firstSnippet: r.snippet,\n          title: r.title,\n          mtime: doc?.mtime ?? \"\",\n        });\n      }\n    }\n  }\n  return Array.from(scoreByPath.entries())\n    .map(([path, v]) => ({\n      path,\n      title: v.title,\n      score: v.hits / keywords.length,\n      snippet: v.firstSnippet,\n      mtime: v.mtime,\n    }))\n    .sort((a, b) => b.score - a.score)\n    .slice(0, limit);\n}\n\nconst STOPWORDS = new Set([\n  \"a\", \"an\", \"and\", \"are\", \"as\", \"at\", \"be\", \"by\", \"can\", \"do\", \"does\", \"for\", \"from\",\n  \"how\", \"i\", \"if\", \"in\", \"is\", \"it\", \"its\", \"of\", \"on\", \"or\", \"our\", \"should\", \"that\",\n  \"the\", \"this\", \"to\", \"was\", \"we\", \"what\", \"when\", \"where\", \"which\", \"why\", \"will\",\n  \"with\", \"you\", \"your\", \"have\", \"has\", \"had\", \"but\", \"not\", \"so\", \"any\", \"all\",\n  \"about\", \"there\", \"their\", \"they\", \"them\", \"these\", \"those\", \"would\", \"could\",\n  \"might\", \"may\", \"really\", \"just\", \"like\", \"some\", \"more\", \"than\", \"into\", \"out\",\n  \"up\", \"down\", \"need\", \"want\", \"get\", \"got\", \"also\", \"very\", \"much\",\n]);\n\nfunction extractKeywords(query: string): string[] {\n  const tokens = query\n    .toLowerCase()\n    .replace(/[^\\w\\s-]/g, \" \")\n    .split(/\\s+/)\n    .filter((t) => t.length > 2 && !STOPWORDS.has(t));\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const t of tokens) {\n    if (!seen.has(t)) {\n      seen.add(t);\n      out.push(t);\n    }\n    if (out.length >= 6) break;\n  }\n  return out;\n}\n"],"mappings":";;;;;;;;;;;;AAAA,SAAS,MAAM,eAAe;AAC9B,SAAS,kBAAkB;AAC3B,SAAS,gBAAgB;AAwBzB,eAAsB,UAAU,MAA8C;AAC5E,QAAM,WAAW,MAAM,WAAW,KAAK,OAAO,EAAE,UAAU,KAAK,SAAS,CAAC;AACzE,SAAO,SAAS,OAAO,KAAK,OAAO,KAAK,SAAS,CAAC;AACpD;AAUA,eAAsB,WAAW,OAAe,OAA+B,CAAC,GAAsB;AACpG,QAAM,YAAY,QAAQ,KAAK;AAC/B,MAAI,CAAC,WAAW,SAAS,GAAG;AAC1B,UAAM,IAAI,MAAM,8BAA8B,SAAS,EAAE;AAAA,EAC3D;AAEA,QAAM,UAAU,IAAI,QAAQ,SAAS;AACrC,QAAM,YAAY,KAAK,WAAW,0BAA0B;AAI5D,MAAI,YAAY,WAAW,SAAS,IAAI,MAAM,QAAQ,cAAc,SAAS,IAAI;AACjF,MAAI,CAAC,WAAW;AACd,gBAAY,MAAM,QAAQ,SAAS;AAAA,EACrC;AACA,MAAI,UAAU,WAAW,EAAG,QAAO,EAAE,QAAQ,YAAY,CAAC,EAAE;AAC5D,QAAM,OAAO;AAEb,MAAI,KAAK,UAAU;AACjB,UAAM,aAAa,IAAI,WAAW;AAClC,eAAW,aAAa,IAAI;AAC5B,WAAO,EAAE,QAAQ,OAAO,OAAO,QAAQ,MAAM,SAAS,YAAY,MAAM,OAAO,KAAK,EAAE;AAAA,EACxF;AAGA,MAAI,CAAC,WAAW,SAAS,GAAG;AAC1B,UAAM,IAAI,MAAM,sBAAsB,SAAS,0CAAqC,SAAS,YAAY;AAAA,EAC3G;AAEA,QAAM,WAAW,IAAI,SAAS;AAC9B,QAAM,SAAS,KAAK;AAEpB,QAAM,WAAW,KAAK,WAAW,WAAW;AAC5C,MAAI,WAAW,QAAQ,GAAG;AACxB,QAAI;AACF,YAAM,OAAO,KAAK,MAAM,MAAM,SAAS,UAAU,OAAO,CAAC;AACzD,UAAI,KAAK,SAAS,KAAK,UAAU,SAAS,SAAS,GAAG;AACpD,cAAM,IAAI,MAAM,0BAA0B,KAAK,KAAK,aAAa,SAAS,SAAS,CAAC,wBAAmB;AAAA,MACzG;AAAA,IACF,SAAS,GAAG;AACV,UAAI,aAAa,SAAS,EAAE,QAAQ,WAAW,gBAAgB,EAAG,OAAM;AAAA,IAC1E;AAAA,EACF;AAEA,QAAM,cAAc,IAAI,YAAY,SAAS,cAAc,CAAC;AAC5D,QAAM,SAAS,MAAM,YAAY,KAAK,SAAS;AAC/C,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,kCAAkC,SAAS,uBAAkB;AAAA,EAC/E;AAEA,QAAM,QAAQ,IAAI,aAAa;AAC/B,QAAM,MAAM,KAAK,SAAS;AAE1B,QAAM,YAAY,IAAI,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AACtD,SAAO;AAAA,IACL,MAAM,OAAO,OAAO,QAAQ,GAAG;AAC7B,YAAM,aAAa,MAAM,SAAS,MAAM,KAAK;AAC7C,YAAM,WAAW,YAAY,OAAO,YAAY,QAAQ,CAAC;AACzD,YAAM,eAAe,MAAM,YAAY,OAAO,CAAC;AAC/C,YAAM,aAAa,IAAI,IAAI,aAAa,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC;AAE1D,YAAM,SAAS,SACZ,IAAI,CAAC,MAAM;AACV,cAAM,MAAM,UAAU,IAAI,EAAE,IAAI;AAChC,YAAI,QAAQ,WAAW,IAAI,EAAE,IAAI,IAAI,EAAE,QAAQ,MAAM,EAAE;AACvD,YAAI,KAAK,iBAAiB,QAAW;AACnC,mBAAS,KAAK,IAAI,eAAe,KAAK;AAAA,QACxC;AACA,eAAO,EAAE,GAAG,GAAG,MAAM;AAAA,MACvB,CAAC,EACA,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK,EAChC,MAAM,GAAG,KAAK;AAEjB,aAAO,OAAO,IAAI,CAAC,MAAM;AACvB,cAAM,MAAM,UAAU,IAAI,EAAE,IAAI;AAChC,eAAO;AAAA,UACL,MAAM,EAAE;AAAA,UACR,OAAQ,EAAU,SAAS,KAAK;AAAA,UAChC,OAAO,EAAE;AAAA,UACT,SAAU,EAAU;AAAA,UACpB,OAAO,KAAK;AAAA,QACd;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAEA,SAAS,SAAS,YAAwB,WAA8B,OAAe,OAA4B;AACjH,QAAM,WAAW,gBAAgB,KAAK;AACtC,MAAI,SAAS,WAAW,EAAG,QAAO,CAAC;AACnC,QAAM,cAAc,oBAAI,IAAoF;AAC5G,aAAW,MAAM,UAAU;AACzB,UAAM,UAAU,WAAW,OAAO,EAAE,SAAS,IAAI,OAAO,GAAG,CAAC;AAC5D,eAAW,KAAK,SAAS;AACvB,YAAM,WAAW,YAAY,IAAI,EAAE,IAAI;AACvC,YAAM,MAAM,UAAU,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI;AACnD,UAAI,UAAU;AACZ,iBAAS,QAAQ;AAAA,MACnB,OAAO;AACL,oBAAY,IAAI,EAAE,MAAM;AAAA,UACtB,MAAM;AAAA,UACN,cAAc,EAAE;AAAA,UAChB,OAAO,EAAE;AAAA,UACT,OAAO,KAAK,SAAS;AAAA,QACvB,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AACA,SAAO,MAAM,KAAK,YAAY,QAAQ,CAAC,EACpC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO;AAAA,IACnB;AAAA,IACA,OAAO,EAAE;AAAA,IACT,OAAO,EAAE,OAAO,SAAS;AAAA,IACzB,SAAS,EAAE;AAAA,IACX,OAAO,EAAE;AAAA,EACX,EAAE,EACD,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK,EAChC,MAAM,GAAG,KAAK;AACnB;AAEA,IAAM,YAAY,oBAAI,IAAI;AAAA,EACxB;AAAA,EAAK;AAAA,EAAM;AAAA,EAAO;AAAA,EAAO;AAAA,EAAM;AAAA,EAAM;AAAA,EAAM;AAAA,EAAM;AAAA,EAAO;AAAA,EAAM;AAAA,EAAQ;AAAA,EAAO;AAAA,EAC7E;AAAA,EAAO;AAAA,EAAK;AAAA,EAAM;AAAA,EAAM;AAAA,EAAM;AAAA,EAAM;AAAA,EAAO;AAAA,EAAM;AAAA,EAAM;AAAA,EAAM;AAAA,EAAO;AAAA,EAAU;AAAA,EAC9E;AAAA,EAAO;AAAA,EAAQ;AAAA,EAAM;AAAA,EAAO;AAAA,EAAM;AAAA,EAAQ;AAAA,EAAQ;AAAA,EAAS;AAAA,EAAS;AAAA,EAAO;AAAA,EAC3E;AAAA,EAAQ;AAAA,EAAO;AAAA,EAAQ;AAAA,EAAQ;AAAA,EAAO;AAAA,EAAO;AAAA,EAAO;AAAA,EAAO;AAAA,EAAM;AAAA,EAAO;AAAA,EACxE;AAAA,EAAS;AAAA,EAAS;AAAA,EAAS;AAAA,EAAQ;AAAA,EAAQ;AAAA,EAAS;AAAA,EAAS;AAAA,EAAS;AAAA,EACtE;AAAA,EAAS;AAAA,EAAO;AAAA,EAAU;AAAA,EAAQ;AAAA,EAAQ;AAAA,EAAQ;AAAA,EAAQ;AAAA,EAAQ;AAAA,EAAQ;AAAA,EAC1E;AAAA,EAAM;AAAA,EAAQ;AAAA,EAAQ;AAAA,EAAQ;AAAA,EAAO;AAAA,EAAO;AAAA,EAAQ;AAAA,EAAQ;AAC9D,CAAC;AAED,SAAS,gBAAgB,OAAyB;AAChD,QAAM,SAAS,MACZ,YAAY,EACZ,QAAQ,aAAa,GAAG,EACxB,MAAM,KAAK,EACX,OAAO,CAAC,MAAM,EAAE,SAAS,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;AAClD,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,MAAgB,CAAC;AACvB,aAAW,KAAK,QAAQ;AACtB,QAAI,CAAC,KAAK,IAAI,CAAC,GAAG;AAChB,WAAK,IAAI,CAAC;AACV,UAAI,KAAK,CAAC;AAAA,IACZ;AACA,QAAI,IAAI,UAAU,EAAG;AAAA,EACvB;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/cli/search.ts"],"sourcesContent":["import { join, resolve } from \"node:path\";\nimport { existsSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { Indexer } from \"../core/indexer.js\";\nimport { Embedder } from \"../core/embedder.js\";\nimport { GraphBuilder } from \"../core/graph.js\";\nimport { VectorIndex } from \"../core/vector.js\";\nimport { TextSearch } from \"../core/search-text.js\";\nimport type { IndexedDocument } from \"../core/types.js\";\n\nexport interface SearchCliOptions {\n  notes: string;\n  query: string;\n  limit?: number;\n  textOnly?: boolean;\n  json?: boolean;\n}\n\nexport interface SearchHit {\n  path: string;\n  title?: string;\n  score: number;\n  snippet?: string;\n  mtime?: string;\n}\n\nexport async function runSearch(opts: SearchCliOptions): Promise<SearchHit[]> {\n  const searcher = await openSearch(opts.notes, { textOnly: opts.textOnly });\n  return searcher.search(opts.query, opts.limit ?? 8);\n}\n\nexport interface Searcher {\n  search(query: string, limit?: number): Promise<SearchHit[]>;\n}\n\n/**\n * Load a notes folder once and search it many times — the same scoring the hook's CLI search uses.\n * The hook spawns `search` per prompt; the failure eval reuses one Searcher per corpus.\n */\nexport async function openSearch(notes: string, opts: { textOnly?: boolean } = {}): Promise<Searcher> {\n  const notesPath = resolve(notes);\n  if (!existsSync(notesPath)) {\n    throw new Error(`notes directory not found: ${notesPath}`);\n  }\n\n  const indexer = new Indexer(notesPath);\n  const indexPath = join(notesPath, \".semantic-sidekick-index\");\n\n  // Prefer the parsed-doc cache written by reindex — avoids re-parsing 500+ files\n  // on every hook call. Falls back to a full parse if the cache is missing.\n  let documents = existsSync(indexPath) ? await indexer.loadDocsCache(indexPath) : null;\n  if (!documents) {\n    documents = await indexer.indexAll();\n  }\n  if (documents.length === 0) return { search: async () => [] };\n  const docs = documents;\n\n  if (opts.textOnly) {\n    const textSearch = new TextSearch();\n    textSearch.setDocuments(docs);\n    return { search: async (query, limit = 8) => textHits(textSearch, docs, query, limit) };\n  }\n\n  // Hybrid path: load cached index, embed query, search + graph rerank.\n  if (!existsSync(indexPath)) {\n    throw new Error(`index not built at ${indexPath} — run: semantic-sidekick --notes ${notesPath} --reindex`);\n  }\n\n  const embedder = new Embedder();\n  await embedder.init();\n\n  const metaPath = join(indexPath, \"meta.json\");\n  if (existsSync(metaPath)) {\n    try {\n      const meta = JSON.parse(await readFile(metaPath, \"utf-8\")) as { model?: string };\n      if (meta.model && meta.model !== embedder.getModel()) {\n        throw new Error(`model mismatch (cached=${meta.model}, current=${embedder.getModel()}) — run --reindex`);\n      }\n    } catch (e) {\n      if (e instanceof Error && e.message.startsWith(\"model mismatch\")) throw e;\n    }\n  }\n\n  const vectorIndex = new VectorIndex(embedder.getDimensions());\n  const loaded = await vectorIndex.load(indexPath);\n  if (!loaded) {\n    throw new Error(`could not load vector index at ${indexPath} — run --reindex`);\n  }\n\n  const graph = new GraphBuilder();\n  await graph.load(indexPath);\n\n  const docByPath = new Map(docs.map((d) => [d.path, d]));\n  return {\n    async search(query, limit = 8) {\n      const queryEmbed = await embedder.embed(query);\n      const semantic = vectorIndex.search(queryEmbed, limit * 3);\n      const graphResults = graph.searchGraph(query, 2);\n      const graphPaths = new Set(graphResults.map((r) => r.path));\n\n      const hybrid = semantic\n        .map((r) => {\n          const doc = docByPath.get(r.path);\n          let score = graphPaths.has(r.path) ? r.score * 1.3 : r.score;\n          if (doc?.loadPriority !== undefined) {\n            score *= 1 + (doc.loadPriority - 5) * 0.04;\n          }\n          return { ...r, score };\n        })\n        .sort((a, b) => b.score - a.score)\n        .slice(0, limit);\n\n      return hybrid.map((r) => {\n        const doc = docByPath.get(r.path);\n        return {\n          path: r.path,\n          title: (r as any).title ?? doc?.title,\n          score: r.score,\n          snippet: (r as any).snippet,\n          mtime: doc?.mtime,\n        };\n      });\n    },\n  };\n}\n\nfunction textHits(textSearch: TextSearch, documents: IndexedDocument[], query: string, limit: number): SearchHit[] {\n  const keywords = extractKeywords(query);\n  if (keywords.length === 0) return [];\n  const scoreByPath = new Map<string, { hits: number; firstSnippet?: string; title?: string; mtime: string }>();\n  for (const kw of keywords) {\n    const results = textSearch.search({ pattern: kw, limit: 50 });\n    for (const r of results) {\n      const existing = scoreByPath.get(r.path);\n      const doc = documents.find((d) => d.path === r.path);\n      if (existing) {\n        existing.hits += 1;\n      } else {\n        scoreByPath.set(r.path, {\n          hits: 1,\n          firstSnippet: r.snippet,\n          title: r.title,\n          mtime: doc?.mtime ?? \"\",\n        });\n      }\n    }\n  }\n  return Array.from(scoreByPath.entries())\n    .map(([path, v]) => ({\n      path,\n      title: v.title,\n      score: v.hits / keywords.length,\n      snippet: v.firstSnippet,\n      mtime: v.mtime,\n    }))\n    .sort((a, b) => b.score - a.score)\n    .slice(0, limit);\n}\n\nconst STOPWORDS = new Set([\n  \"a\", \"an\", \"and\", \"are\", \"as\", \"at\", \"be\", \"by\", \"can\", \"do\", \"does\", \"for\", \"from\",\n  \"how\", \"i\", \"if\", \"in\", \"is\", \"it\", \"its\", \"of\", \"on\", \"or\", \"our\", \"should\", \"that\",\n  \"the\", \"this\", \"to\", \"was\", \"we\", \"what\", \"when\", \"where\", \"which\", \"why\", \"will\",\n  \"with\", \"you\", \"your\", \"have\", \"has\", \"had\", \"but\", \"not\", \"so\", \"any\", \"all\",\n  \"about\", \"there\", \"their\", \"they\", \"them\", \"these\", \"those\", \"would\", \"could\",\n  \"might\", \"may\", \"really\", \"just\", \"like\", \"some\", \"more\", \"than\", \"into\", \"out\",\n  \"up\", \"down\", \"need\", \"want\", \"get\", \"got\", \"also\", \"very\", \"much\",\n]);\n\nfunction extractKeywords(query: string): string[] {\n  const tokens = query\n    .toLowerCase()\n    .replace(/[^\\w\\s-]/g, \" \")\n    .split(/\\s+/)\n    .filter((t) => t.length > 2 && !STOPWORDS.has(t));\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const t of tokens) {\n    if (!seen.has(t)) {\n      seen.add(t);\n      out.push(t);\n    }\n    if (out.length >= 6) break;\n  }\n  return out;\n}\n"],"mappings":"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","names":[]}

package/dist/skill-curator-D7HHZaUI.d.ts

@@ -0,0 +1,71 @@
+type LedgerAction = "land" | "patch" | "stale" | "archive" | "restore" | "promote" | "merge" | "reject" | "rollback";
+interface FileChange {
+    path: string;
+    /** sha256 of the bytes before (null: the file did not exist) */
+    before: string | null;
+    after: string | null;
+}
+interface LedgerEntry {
+    id: string;
+    ts: string;
+    action: LedgerAction;
+    actor: "user" | "curator" | "reviewer";
+    skill: string;
+    why: string;
+    files: FileChange[];
+    /** rollback: the entry it reversed */
+    reverts?: string;
+}
+declare function readLedger(repo: string): LedgerEntry[];
+/** Undo one entry: every file it touched goes back to its exact bytes before (or aside, if it did not exist). */
+declare function rollback(repo: string, id: string): LedgerEntry;
+
+declare const STALE_DAYS = 14;
+declare const ARCHIVE_DAYS = 30;
+declare const CURATOR_INTERVAL_DAYS = 7;
+declare const IDLE_HOURS = 2;
+declare const curatorStatePath: (repo: string) => string;
+interface CuratorState {
+    first_seen?: string;
+    last_run?: string;
+    last_report?: string;
+    flagged?: {
+        name: string;
+        reason: string;
+        at: string;
+    }[];
+}
+declare function readState(repo: string): CuratorState;
+interface CuratorAction {
+    skill: string;
+    path: string;
+    action: "stale" | "archive" | "reactivate" | "keep" | "skip";
+    why: string;
+}
+declare function plan(repo: string, now?: number, env?: NodeJS.ProcessEnv): CuratorAction[];
+/** Run the curator. Dry run: report only. Returns the actions (and the ledger ids of the changes made). */
+declare function curate(repo: string, opts?: {
+    dryRun?: boolean;
+    now?: number;
+    env?: NodeJS.ProcessEnv;
+}): {
+    actions: CuratorAction[];
+    ledger: string[];
+};
+/** Whether SessionStart should start the curator now (and records first sight of the repo). */
+declare function curatorDue(repo: string, now?: number): boolean;
+/** Bring an archived skill back where it was, active again. */
+declare function restore(repo: string, name: string): LedgerEntry;
+declare function listArchived(repo: string): string[];
+/** Run each landed learned skill's Verify command (they were approved by a person); flag failures, archive nothing. */
+declare function verifySkills(repo: string, opts?: {
+    timeoutMs?: number;
+    env?: NodeJS.ProcessEnv;
+}): {
+    skill: string;
+    result: "pass" | "fail" | "prose" | "none";
+    detail: string;
+}[];
+declare const curatorState: typeof readState;
+
+export { ARCHIVE_DAYS as A, CURATOR_INTERVAL_DAYS as C, IDLE_HOURS as I, type LedgerEntry as L, STALE_DAYS as S, restore as a, rollback as b, curate as c, type CuratorAction as d, curatorDue as e, curatorState as f, curatorStatePath as g, listArchived as l, plan as p, readLedger as r, verifySkills as v };

package/dist/skill-land-XU2APPBJ.js

@@ -0,0 +1,31 @@
+import {
+  approveDraft,
+  describeDrafts,
+  destinationFor,
+  evalDraft,
+  rejectDraft,
+  reviewedPrompts
+} from "./chunk-BEACL25M.js";
+import "./chunk-P3GLY42T.js";
+import "./chunk-TKHWVISV.js";
+import "./chunk-3FPUBAEW.js";
+import "./chunk-MQS7JEBD.js";
+import "./chunk-DBFD3MTT.js";
+import "./chunk-IEZVFKUT.js";
+import "./chunk-ZSWI3Y4Y.js";
+import "./chunk-J7LYDRML.js";
+import "./chunk-VQCNWRTL.js";
+import "./chunk-GYR7U6KA.js";
+import "./chunk-NIZLBNH4.js";
+import "./chunk-R6GNP7DS.js";
+import "./chunk-H2BES6FU.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  approveDraft,
+  describeDrafts,
+  destinationFor,
+  evalDraft,
+  rejectDraft,
+  reviewedPrompts
+};
+//# sourceMappingURL=skill-land-XU2APPBJ.js.map

package/dist/skill-land-XU2APPBJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/skill-ledger-AYXVNFX7.js

@@ -0,0 +1,18 @@
+import {
+  applyChange,
+  archiveDir,
+  ledgerPath,
+  readLedger,
+  rollback
+} from "./chunk-TKHWVISV.js";
+import "./chunk-R6GNP7DS.js";
+import "./chunk-H2BES6FU.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  applyChange,
+  archiveDir,
+  ledgerPath,
+  readLedger,
+  rollback
+};
+//# sourceMappingURL=skill-ledger-AYXVNFX7.js.map

package/dist/skill-ledger-AYXVNFX7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/skill-merge-GXBQLBZA.js

@@ -0,0 +1,24 @@
+import {
+  MERGE_MIN_OVERLAP,
+  consolidateOn,
+  mergeCandidates,
+  proposeMerges
+} from "./chunk-NCGM36NX.js";
+import "./chunk-P3GLY42T.js";
+import "./chunk-3FPUBAEW.js";
+import "./chunk-IEZVFKUT.js";
+import "./chunk-ZSWI3Y4Y.js";
+import "./chunk-J7LYDRML.js";
+import "./chunk-VQCNWRTL.js";
+import "./chunk-GYR7U6KA.js";
+import "./chunk-NIZLBNH4.js";
+import "./chunk-R6GNP7DS.js";
+import "./chunk-H2BES6FU.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  MERGE_MIN_OVERLAP,
+  consolidateOn,
+  mergeCandidates,
+  proposeMerges
+};
+//# sourceMappingURL=skill-merge-GXBQLBZA.js.map

package/dist/skill-merge-GXBQLBZA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/skill-review-BaW5n0Zg.d.ts

@@ -0,0 +1,179 @@
+import { ReviewJob } from './core/skill-queue.js';
+import { ReviewOutcome } from './core/skill-worker.js';
+
+declare const SKILL_SCOPES: readonly ["directory", "project", "global"];
+declare const SKILL_STATUSES: readonly ["draft", "active", "stale", "archived"];
+declare const SKILL_SECTIONS: readonly ["When to use", "Steps", "Pitfalls", "Verify"];
+type SkillScope = (typeof SKILL_SCOPES)[number];
+type SkillStatus = (typeof SKILL_STATUSES)[number];
+interface SkillLoopMeta {
+    schema: 1;
+    scope: SkillScope;
+    status: SkillStatus;
+    pinned: boolean;
+    triggers: string[];
+    applies_to: {
+        paths: string[];
+        commands: string[];
+    };
+    provenance: {
+        sessions: string[];
+        failures: string[];
+        corrections: string[];
+    };
+    cites: string[];
+    supersedes: string[];
+}
+interface ParsedSkill {
+    name: string;
+    description: string;
+    /** null when the file has no `skill_loop:` block: not a learned skill */
+    meta: SkillLoopMeta | null;
+    /** the raw `skill_loop` value, for lint messages on a malformed block */
+    rawMeta: unknown;
+    body: string;
+    /** `## ` headings in the body, in order */
+    sections: string[];
+    frontmatter: Record<string, unknown>;
+}
+declare function parseSkill(raw: string): ParsedSkill;
+/** A learned skill's SKILL.md text. Field order is fixed so a re-render of an unchanged skill is byte-identical. */
+declare function renderSkill(skill: {
+    name: string;
+    description: string;
+    meta: SkillLoopMeta;
+    body: string;
+    extra?: Record<string, unknown>;
+}): string;
+interface SkillFile {
+    path: string;
+    /** directory holding SKILL.md; its basename is the skill's name in Claude Code */
+    dir: string;
+    scope: SkillScope;
+    learned: boolean;
+    skill: ParsedSkill;
+}
+/** Every skill Claude Code would load for this repo: directory, project and global scope. */
+declare function findSkills(projectRoot: string, opts?: {
+    home?: string;
+    global?: boolean;
+}): SkillFile[];
+interface SkillFinding {
+    path: string;
+    rule: "frontmatter" | "name" | "description" | "skill_loop" | "provenance" | "sections" | "cites" | "applies_to" | "secrets" | "name_clash";
+    severity: "error" | "warn";
+    message: string;
+}
+interface SkillLintContext {
+    /** repo root the skill belongs to (applies_to paths resolve against it) */
+    projectRoot: string;
+    facts?: Set<string>;
+    /** every other skill Claude Code would load alongside (for name clashes) */
+    others?: SkillFile[];
+}
+/** Lint one learned skill. `dirName` is the folder name Claude Code will use (defaults to the skill's name). */
+declare function lintSkill(path: string, raw: string, ctx: SkillLintContext, dirName?: string): SkillFinding[];
+/** Lint every learned skill this repo would load (and its drafts, when given). */
+declare function lintSkills(projectRoot: string, opts?: {
+    home?: string;
+    extra?: string[];
+}): {
+    files: number;
+    findings: SkillFinding[];
+};
+
+interface ScopeDecision {
+    scope: Exclude<SkillScope, "global">;
+    /** directory scope: the subdirectory (repo-relative) */
+    directory?: string;
+    /** Jev said this holds in any repo: offer promotion once another repo has it too */
+    globalCandidate: boolean;
+    why: string;
+}
+declare function decideScope(repo: string, draft: {
+    name: string;
+    description: string;
+    body: string;
+    applies_to?: {
+        paths?: string[];
+    };
+}, env?: NodeJS.ProcessEnv): Promise<ScopeDecision>;
+
+declare const draftsDir: (repo: string) => string;
+interface DraftRecord {
+    id: string;
+    kind: "new" | "patch" | "merge";
+    name: string;
+    scope: SkillScope;
+    /** patch: the SKILL.md it replaces, and that file's sha256 when the draft was made */
+    target?: string;
+    base_sha256?: string;
+    session_id: string;
+    created: string;
+    warnings: string[];
+    /** directory scope: where it lands (repo-relative subdirectory) */
+    directory?: string;
+    scope_why?: string;
+    /** Jev thinks it holds in any repo */
+    global_candidate?: boolean;
+    /** other repos with the same lesson: review offers one global skill replacing the copies */
+    promotion?: {
+        repo: string;
+        path: string;
+    }[];
+    /** merge: the SKILL.md files the merged skill replaces (archived when it lands) */
+    supersedes?: string[];
+    /** filled by skill evals (Phase 14) when they run at approval time */
+    evals?: Record<string, unknown>;
+}
+/** The session's timeline from its transcript: prompts, tool calls, and the errors they returned. Fail-soft. */
+declare function transcriptTimeline(path: string | null, max?: number): string[];
+declare function buildBrief(job: ReviewJob, skills?: SkillFile[]): string;
+interface ReviewerDraft {
+    kind: "new" | "patch";
+    target?: string;
+    name: string;
+    description: string;
+    scope: string;
+    applies_to?: {
+        paths?: string[];
+        commands?: string[];
+    };
+    triggers?: string[];
+    provenance?: {
+        sessions?: string[];
+        failures?: string[];
+        corrections?: string[];
+    };
+    cites?: string[];
+    body: string;
+}
+/** The JSON object in the reviewer's answer (bare, or inside a ```json fence). */
+declare function parseReviewerJson(text: string): {
+    drafts: ReviewerDraft[];
+    none_reason?: string;
+} | null;
+type ScopeResolver = (d: ReviewerDraft) => Promise<ScopeDecision>;
+/**
+ * Turn one reviewer draft into a draft folder, or say why not. `resolveScope` decides the final scope
+ * (skill-scope.ts: deterministic rules, then Jev); the reviewer's own choice is never trusted for it.
+ */
+declare function materializeDraft(repo: string, job: ReviewJob, d: ReviewerDraft, skills: SkillFile[], resolveScope?: ScopeResolver, env?: NodeJS.ProcessEnv, merge?: {
+    supersedes: string[];
+}): Promise<{
+    id?: string;
+    rejected?: string;
+}>;
+declare function listDrafts(repo: string): {
+    dir: string;
+    record: DraftRecord;
+}[];
+interface ReviewOptions {
+    env?: NodeJS.ProcessEnv;
+    resolveScope?: ScopeResolver;
+    maxTurns?: number;
+}
+/** Review one queued session (the worker's review function). */
+declare function reviewSession(job: ReviewJob, opts?: ReviewOptions): Promise<ReviewOutcome>;
+
+export { type DraftRecord as D, type ParsedSkill as P, type ReviewOptions as R, type SkillLoopMeta as S, SKILL_SCOPES as a, SKILL_SECTIONS as b, SKILL_STATUSES as c, type SkillFile as d, type SkillFinding as e, type SkillScope as f, type SkillStatus as g, buildBrief as h, decideScope as i, draftsDir as j, findSkills as k, lintSkill as l, lintSkills as m, listDrafts as n, reviewSession as o, parseSkill as p, type ReviewerDraft as q, renderSkill as r, type ScopeResolver as s, materializeDraft as t, parseReviewerJson as u, transcriptTimeline as v };

package/dist/skill-schema-RVB3EHEF.js

@@ -0,0 +1,30 @@
+import {
+  GENERATED_BY,
+  SKILL_SCOPES,
+  SKILL_SECTIONS,
+  SKILL_STATUSES,
+  factIds,
+  findSkills,
+  isLearned,
+  lintSkill,
+  lintSkills,
+  parseSkill,
+  renderSkill
+} from "./chunk-ZSWI3Y4Y.js";
+import "./chunk-J7LYDRML.js";
+import "./chunk-H2BES6FU.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  GENERATED_BY,
+  SKILL_SCOPES,
+  SKILL_SECTIONS,
+  SKILL_STATUSES,
+  factIds,
+  findSkills,
+  isLearned,
+  lintSkill,
+  lintSkills,
+  parseSkill,
+  renderSkill
+};
+//# sourceMappingURL=skill-schema-RVB3EHEF.js.map

package/dist/skill-schema-RVB3EHEF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{telemetry-B4KP3UVE.js → telemetry-YAG3VA4Y.js}

@@ -6,9 +6,9 @@ import {
   selectionLogPath,
   telemetryEnabled,
   wasRecentlySearched
-} from "./chunk-NBY4TRP7.js";
-import "./chunk-LGQPP5FQ.js";
-import "./chunk-OEF5U5GV.js";
+} from "./chunk-7M34JDTH.js";
+import "./chunk-EYVFC745.js";
+import "./chunk-H2BES6FU.js";
 import "./chunk-PZ5AY32C.js";
 export {
   appendEvent,
@@ -19,4 +19,4 @@ export {
   telemetryEnabled,
   wasRecentlySearched
 };
-//# sourceMappingURL=telemetry-B4KP3UVE.js.map
+//# sourceMappingURL=telemetry-YAG3VA4Y.js.map

package/dist/telemetry-YAG3VA4Y.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/docs/regression-snapshot.md

@@ -27,13 +27,13 @@ Three snapshots:
 | Snapshot | Captures | Size |
 |---|---|---|
 | `tool-surface 1` | Full list of registered tools — name, description, complete JSON Schema for inputs | ~1000 lines |
-| `tool-name list (compact) 1` | Sorted list of tool names in default mode (33 entries) | ~35 lines |
-| `tool-name list in read-only mode 1` | Sorted list of tool names in `--read-only` mode (21 entries) | ~22 lines |
+| `tool-name list (compact) 1` | Sorted list of tool names in default mode (44 entries as of v1.6.1; 33 at baseline) | ~46 lines |
+| `tool-name list in read-only mode 1` | Sorted list of tool names in `--read-only` mode (20 entries as of v1.6.1; 21 at baseline) | ~21 lines |
 
 Plus structural assertions:
-- Default mode exposes exactly 33 tools
-- `--read-only` mode exposes exactly 21 tools
-- Read-only mode never exposes any of the 12 write tools (explicit name list)
+- Default mode exposes exactly 44 tools (33 at baseline)
+- `--read-only` mode exposes exactly 20 tools (21 at baseline; `log_event` became write-gated in v1.6.1)
+- Read-only mode never exposes any of the 13 listed write tools (explicit name list, `log_event` added in v1.6.1)
 
 ### `test/regression/tool-outputs.test.ts` — output contract
 

package/hooks/hooks.json

@@ -1,5 +1,5 @@
 {
-  "description": "semantic-sidekick activation + mode hooks. SessionStart reconciles .mcp.json + resets mode + preloads vault context. UserPromptSubmit injects vault search results (mode-aware, fingerprinted). Stop emits mode-specific transition-capture prompts (research\u2192synthesis, outage\u2192postmortem, vault-first\u2192generic capture). PostToolUseFailure (opt-in, SEMANTIC_MEMORY_FAILURE_HOOK=1) looks up a knowledge-base fact for a failed Bash/MCP call.",
+  "description": "semantic-sidekick activation + mode hooks. SessionStart reconciles .mcp.json + resets mode + preloads vault context. UserPromptSubmit injects vault search results (mode-aware, fingerprinted). Stop emits mode-specific transition-capture prompts (research\u2192synthesis, outage\u2192postmortem, vault-first\u2192generic capture). PostToolUseFailure (opt-in, SEMANTIC_MEMORY_FAILURE_HOOK=1) looks up a knowledge-base fact for a failed Bash/MCP call. PostToolUse (Skill) and SessionEnd feed the skill loop (v1.7, off by default: SEMANTIC_MEMORY_SKILL_LOOP=1).",
   "hooks": {
     "SessionStart": [
       {
@@ -11,6 +11,10 @@
           {
             "type": "command",
             "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/vault-context.js\""
+          },
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/skill-loop.js\""
           }
         ]
       }
@@ -45,6 +49,27 @@
           }
         ]
       }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Skill",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/skill-loop.js\""
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/skill-loop.js\""
+          }
+        ]
+      }
     ]
   }
 }