@vortex-os/base 0.9.0 → 0.10.0

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   catchUpSessions
-} from "./chunk-3L5DLEGP.js";
+} from "./chunk-7SNLVGBO.js";
 import {
   __export
 } from "./chunk-PZ5AY32C.js";
@@ -105,7 +105,7 @@ function moduleDir(ctx, moduleName) {
 import { existsSync, readFileSync } from "fs";
 import { join as join2 } from "path";
 var DEFAULT_CONFIG = {
-  autoRecord: { sessionStart: true, worklog: true, decision: true, ambientRecall: true, archive: true, vectorize: true, vectorizeAutoDownload: true, commitFrameworkChanges: true, handoff: true, handoffRetentionDays: 7 },
+  autoRecord: { sessionStart: true, worklog: true, decision: true, ambientRecall: true, archive: true, vectorize: true, vectorizeAutoDownload: true, commitFrameworkChanges: true, handoff: true, handoffRetentionDays: 7, reindex: true, backfill: true },
   updates: { check: "session" },
   environments: []
 };
@@ -149,6 +149,8 @@ function loadVortexConfig(ctx) {
     const vectorizeAutoDownload = rawAuto.vectorizeAutoDownload === void 0 ? true : rawAuto.vectorizeAutoDownload === true;
     const commitFrameworkChanges = rawAuto.commitFrameworkChanges === void 0 ? true : rawAuto.commitFrameworkChanges === true;
     const handoff = rawAuto.handoff === void 0 ? true : rawAuto.handoff === true;
+    const reindex = rawAuto.reindex === void 0 ? true : rawAuto.reindex === true;
+    const backfill = rawAuto.backfill === void 0 ? true : rawAuto.backfill === true;
     const rawDays = rawAuto.handoffRetentionDays;
     const handoffRetentionDays = typeof rawDays === "number" && Number.isFinite(rawDays) && rawDays > 0 ? Math.floor(rawDays) : DEFAULT_CONFIG.autoRecord.handoffRetentionDays;
     return {
@@ -158,7 +160,9 @@ function loadVortexConfig(ctx) {
         vectorizeAutoDownload,
         commitFrameworkChanges,
         handoff,
-        handoffRetentionDays
+        handoffRetentionDays,
+        reindex,
+        backfill
       },
       updates: { check },
       environments
@@ -4235,6 +4239,7 @@ var ClaudeDesktopLLMJudge = class extends InjectedLLMJudge {
 // ../plugins/session-rituals/dist/index.js
 var dist_exports14 = {};
 __export(dist_exports14, {
+  DEFAULT_GAP_WINDOW_DAYS: () => DEFAULT_GAP_WINDOW_DAYS,
   HANDOFF_ARCHIVE_DIR: () => HANDOFF_ARCHIVE_DIR,
   HANDOFF_DIR: () => HANDOFF_DIR,
   OWNERSHIP_SCHEMA: () => OWNERSHIP_SCHEMA,
@@ -4244,6 +4249,7 @@ __export(dist_exports14, {
   aggregateHandoff: () => aggregateHandoff,
   applyGlobalSetup: () => applyGlobalSetup,
   argvToSlash: () => argvToSlash,
+  autoReindexMemory: () => autoReindexMemory,
   buildInstallCommand: () => buildInstallCommand,
   buildOwnershipManifest: () => buildOwnershipManifest,
   buildRegistry: () => buildRegistry,
@@ -4266,6 +4272,7 @@ __export(dist_exports14, {
   ensureWorklogEntry: () => ensureWorklogEntry,
   extractNextUp: () => extractNextUp,
   extractOpenTasks: () => extractOpenTasks,
+  gapWindowSinceArg: () => gapWindowSinceArg,
   globalMemoryPath: () => globalMemoryPath,
   globalSettingsHasHook: () => globalSettingsHasHook,
   globalSettingsPath: () => globalSettingsPath,
@@ -4552,7 +4559,7 @@ function todayIso() {
 
 // ../plugins/session-rituals/dist/commands/reindex.js
 import { existsSync as existsSync7 } from "fs";
-import { readFile as readFile17, writeFile as writeFile9 } from "fs/promises";
+import { readFile as readFile17, writeFile as writeFile9, utimes } from "fs/promises";
 import { join as join21 } from "path";
 var TARGETS = [
   {
@@ -4706,6 +4713,52 @@ var reindexCommand = {
     return results;
   }
 };
+async function autoReindexMemory(ctx) {
+  try {
+    const target = TARGETS.find((t) => t.dir === "_memory");
+    if (!target)
+      return "missing";
+    const dir = join21(ctx.dataDir, target.dir);
+    if (!existsSync7(dir))
+      return "missing";
+    const entries = await scanDirectory(dir, {
+      recursive: target.recursive,
+      skipPrefixes: target.skipPrefixes,
+      skipFilenames: target.skipFilenames
+    });
+    const body = renderIndex({
+      title: target.title,
+      description: target.description,
+      entries,
+      privacy: target.privacy
+    });
+    const indexPath = join21(dir, "_INDEX.md");
+    let existing;
+    try {
+      existing = await readFile17(indexPath, "utf8");
+    } catch {
+      existing = void 0;
+    }
+    const sameListing = existing !== void 0 && stripIndexDate(existing) === stripIndexDate(body);
+    let status;
+    if (sameListing) {
+      status = "unchanged";
+    } else {
+      await writeFile9(indexPath, body, "utf8");
+      status = "written";
+    }
+    if (existsSync7(indexPath)) {
+      const now = /* @__PURE__ */ new Date();
+      await utimes(indexPath, now, now);
+    }
+    return status;
+  } catch {
+    return "error";
+  }
+}
+function stripIndexDate(body) {
+  return body.replace(/^updated: .*$/m, "updated:");
+}
 
 // ../plugins/session-rituals/dist/commands/session-start.js
 import { existsSync as existsSync8 } from "fs";
@@ -7813,7 +7866,7 @@ import { execFileSync as execFileSync2, spawn as spawn2 } from "child_process";
 import { existsSync as existsSync16, readFileSync as readFileSync4, mkdirSync, openSync, writeSync, closeSync, linkSync, rmSync, statSync } from "fs";
 import { createRequire } from "module";
 import { hostname } from "os";
-import { isAbsolute as isAbsolute5, join as join31 } from "path";
+import { isAbsolute as isAbsolute5, join as join30 } from "path";
 
 // ../plugins/session-rituals/dist/update-check.js
 import { execSync } from "child_process";
@@ -7931,6 +7984,9 @@ import { readdir as readdir17, readFile as readFile22, stat as stat9 } from "fs/
 import { join as join28 } from "path";
 var COUNTED_DIRS2 = ["_memory", "worklog", "decision-log"];
 var DEFAULT_GAP_WINDOW_DAYS = 30;
+function gapWindowSinceArg() {
+  return `${DEFAULT_GAP_WINDOW_DAYS} days ago`;
+}
 var BOOT_BANNER = String.raw`
  __   __       _   _____  __
  \ \ / ___ _ _| |_| __\ \/ /
@@ -8131,7 +8187,7 @@ function renderSessionStartReport(report, extras) {
     lines.push(`- always-on rules (loaded below): ${slugs}${over}`);
   }
   if (report.memoryIndexStale) {
-    lines.push("- \u26A0\uFE0F memory index may be stale \u2014 run `npx vortex reindex _memory`");
+    lines.push("- \u2139\uFE0F memory index is stale (auto-reindex off or failed) \u2014 recent memories may be missing from the index.");
   }
   const handoffs = report.handoffs ?? [];
   const nextUp = report.nextUp ?? [];
@@ -8171,14 +8227,14 @@ function renderSessionStartReport(report, extras) {
   }
   const gaps = extras?.missingWorklogDays ?? [];
   if (gaps.length) {
-    lines.push(`- \u26A0\uFE0F work without a worklog: ${gaps.join(", ")} \u2014 backfill from that day's commits`);
+    lines.push(`- \u21A9\uFE0F no worklog yet for: ${gaps.join(", ")} \u2014 backfill from that day's session archive or commits.`);
   }
   const carry = extras?.carryover;
   if (carry?.interrupted) {
     lines.push(carry.interrupted === "index.lock" ? `- \u26A0\uFE0F a git lock (\`index.lock\`) is present \u2014 another git process may be running, or it is stale from a crash; remove it if nothing is using git. \`/resume\` shows what stopped.` : `- \u26A0\uFE0F interrupted git op (\`${carry.interrupted}\`) \u2014 likely a crashed prior session; finish or abort it before new work. Run \`/resume\` to see what stopped.`);
   }
   if (carry && carry.uncommitted > 0) {
-    lines.push(`- \u21A9\uFE0F ${carry.uncommitted} uncommitted change(s) carried over from a prior session \u2014 run \`/resume\` if you're unsure they were meant to stay.`);
+    lines.push(`- \u21A9\uFE0F ${carry.uncommitted} uncommitted change(s) carried over from a prior session \u2014 likely normal work in progress.`);
   }
   const cu = extras?.catchUp;
   if (cu && (cu.ingestedLocal > 0 || cu.indexedPulled > 0 || cu.errors > 0)) {
@@ -8379,56 +8435,11 @@ function isoDate2(d2) {
   return `${y2}-${m2}-${day}`;
 }
 
-// ../plugins/session-rituals/dist/worklog-write.js
-import { mkdir as mkdir10, writeFile as writeFile12 } from "fs/promises";
-import { dirname as dirname6, join as join29 } from "path";
-async function ensureWorklogEntry(ctx, opts) {
-  const now = opts?.now ?? /* @__PURE__ */ new Date();
-  const date = isoDate3(now);
-  const time = isoTime2(now);
-  const keyword = (opts?.keyword ?? "worklog").trim() || "worklog";
-  const store = new WorklogStore(join29(ctx.dataDir, "worklog"));
-  const existing = await store.get(date);
-  if (existing) {
-    return { path: existing.path, date: existing.date, keyword: existing.keyword, created: false };
-  }
-  const path = store.pathFor(date, keyword, time);
-  const title = opts?.title ?? `${date} worklog`;
-  await mkdir10(dirname6(path), { recursive: true });
-  await writeFile12(path, renderWorklogFile(date, title, opts?.body ?? ""), "utf8");
-  return { path, date, keyword, created: true };
-}
-function renderWorklogFile(date, title, body) {
-  const trimmed = body.trimEnd();
-  return `---
-type: worklog
-created: ${date}
-updated: ${date}
-tags: [worklog]
----
-
-# ${title}
-` + (trimmed ? `
-${trimmed}
-` : ``);
-}
-function isoDate3(d2) {
-  const y2 = d2.getFullYear();
-  const m2 = String(d2.getMonth() + 1).padStart(2, "0");
-  const day = String(d2.getDate()).padStart(2, "0");
-  return `${y2}-${m2}-${day}`;
-}
-function isoTime2(d2) {
-  const h = String(d2.getHours()).padStart(2, "0");
-  const m2 = String(d2.getMinutes()).padStart(2, "0");
-  return `${h}${m2}`;
-}
-
 // ../plugins/session-rituals/dist/curate-cli.js
 import { existsSync as existsSync15 } from "fs";
 import { createHash as createHash3 } from "crypto";
 import { readFile as readFile23, readdir as readdir18 } from "fs/promises";
-import { join as join30 } from "path";
+import { join as join29 } from "path";
 var SYSTEM_META_DIRS3 = /* @__PURE__ */ new Set([
   "worklog",
   "decision-log",
@@ -8508,7 +8519,7 @@ function joinRel(...parts) {
 }
 async function runCurateCandidates(repoRoot, options) {
   const maxEntries = options?.maxEntries ?? 200;
-  const dataDir = join30(repoRoot, "data");
+  const dataDir = join29(repoRoot, "data");
   const candidates = [];
   let truncated = false;
   if (existsSync15(dataDir)) {
@@ -8534,7 +8545,7 @@ async function runCurateCandidates(repoRoot, options) {
             continue;
           if (atRoot && (SYSTEM_META_DIRS3.has(e.name) || e.name.startsWith("_")))
             continue;
-          await visit(join30(absDir, e.name), joinRel(relDir, e.name));
+          await visit(join29(absDir, e.name), joinRel(relDir, e.name));
         } else if (e.isFile() && e.name.endsWith(".md")) {
           if (NON_DOC_FILES.has(e.name))
             continue;
@@ -8543,7 +8554,7 @@ async function runCurateCandidates(repoRoot, options) {
           let topic = null;
           let tags = [];
           try {
-            const raw = await readFile23(join30(absDir, e.name), "utf8");
+            const raw = await readFile23(join29(absDir, e.name), "utf8");
             const parsed = parseFrontmatter(raw);
             if (typeof parsed.frontmatter.topic === "string") {
               topic = parsed.frontmatter.topic.trim().toLowerCase();
@@ -8581,7 +8592,7 @@ async function runCuratePreview(repoRoot, payload, now = /* @__PURE__ */ new Dat
     };
   }
   try {
-    validateDataRelativePath(join30(repoRoot, "data"), v2.effectiveRelPath);
+    validateDataRelativePath(join29(repoRoot, "data"), v2.effectiveRelPath);
   } catch (e) {
     return {
       subcommand: "curate-preview",
@@ -8598,10 +8609,10 @@ async function runCuratePreview(repoRoot, payload, now = /* @__PURE__ */ new Dat
   let targetExists;
   let wouldDo;
   if (payload.action === "create-file") {
-    targetExists = existsSync15(join30(repoRoot, "data", v2.effectiveRelPath));
+    targetExists = existsSync15(join29(repoRoot, "data", v2.effectiveRelPath));
     wouldDo = targetExists ? `create-file at ${v2.effectiveRelPath} \u2014 but the file already EXISTS, so accept would REFUSE (no overwrite).` : `create a new document at data/${v2.effectiveRelPath}.`;
   } else {
-    targetExists = existsSync15(join30(repoRoot, "data", v2.effectiveRelPath));
+    targetExists = existsSync15(join29(repoRoot, "data", v2.effectiveRelPath));
     wouldDo = targetExists ? `append a "## ${payload.sectionHeader}" section to data/${v2.effectiveRelPath}.` : `append-section to data/${v2.effectiveRelPath} \u2014 but the file does NOT exist, so accept would FAIL (append-section never creates).`;
   }
   const nextActions = [];
@@ -8812,7 +8823,7 @@ async function runVortexCli(argv, io) {
 Commands:
 ${names}
   session-start  \u2014  emit the start-of-session boot report (git pull + data counts + catch-up)
-  session-end    \u2014  worklog safety net (create today's worklog if work happened and none exists)
+  session-end    \u2014  no-op (kept for hook compatibility; worklog gap handling is at session-start)
   check-updates  \u2014  check the npm registry for a newer @vortex-os/base (read-only; prints the exact update command)
 
 Instance shortcuts (also available as \`/vortex <sub>\`):
@@ -8880,7 +8891,7 @@ function memoryExtendedPresent() {
 }
 var VECTORIZE_LOCK_TTL_MS = 6 * 60 * 60 * 1e3;
 function vectorizeLockPath(ctx) {
-  return join31(ctx.dataDir, "_indexes", ".vectorize.lock");
+  return join30(ctx.dataDir, "_indexes", ".vectorize.lock");
 }
 function vectorizeSetupInProgress(ctx) {
   const lock = vectorizeLockPath(ctx);
@@ -8906,8 +8917,8 @@ function spawnVectorizeSetup(repoRoot) {
 }
 async function runVectorizeSetup(repoRoot, out, err) {
   const ctx = makeContext(repoRoot);
-  const indexDir = join31(ctx.dataDir, "_indexes");
-  const finalDb = join31(indexDir, "memory.sqlite");
+  const indexDir = join30(ctx.dataDir, "_indexes");
+  const finalDb = join30(indexDir, "memory.sqlite");
   if (existsSync16(finalDb)) {
     out("recall index already present \u2014 nothing to do\n");
     return;
@@ -8939,7 +8950,7 @@ async function runVectorizeSetup(repoRoot, out, err) {
       return;
     }
   }
-  const tmpDb = join31(indexDir, `memory.sqlite.building-${process.pid}`);
+  const tmpDb = join30(indexDir, `memory.sqlite.building-${process.pid}`);
   const tmpSidecars = [tmpDb + "-wal", tmpDb + "-shm", tmpDb + "-journal"];
   const cleanTmp = () => {
     rmSync(tmpDb, { force: true });
@@ -8967,7 +8978,7 @@ async function runVectorizeSetup(repoRoot, out, err) {
       return;
     }
     cleanTmp();
-    const { vectorizeIndex } = await import("./vectorize-PN4Y7XMO.js");
+    const { vectorizeIndex } = await import("./vectorize-RBDBTSTW.js");
     const result = await vectorizeIndex(ctx, { dbPath: tmpDb, allowDownload: true });
     const sqliteSpecifier = "better-sqlite3";
     const mod = await import(sqliteSpecifier);
@@ -9028,18 +9039,23 @@ async function runSessionStart(repoRoot, out) {
   }
   const bookkeepingPrefix = frameworkBookkeepingPrefix(ctx);
   const carryover = collectCarryover(repoRoot, (p) => p.startsWith(bookkeepingPrefix));
+  if (config.autoRecord.reindex && !git2?.conflict) {
+    await autoReindexMemory(ctx);
+  }
   const report = await collectSessionStartReport(ctx, { environment });
   let missingWorklogDays = [];
-  try {
-    const log = gitOut(repoRoot, ["log", "--since=7 days ago", "--pretty=%cd", "--date=short"]);
-    const commitDays = log.split(/\r?\n/).map((s) => s.trim()).filter(Boolean);
-    missingWorklogDays = detectWorklogGaps(commitDays, report.recentWorklogDates);
-  } catch {
+  if (config.autoRecord.worklog && config.autoRecord.backfill && !git2?.conflict) {
+    try {
+      const log = gitOut(repoRoot, ["log", `--since=${gapWindowSinceArg()}`, "--pretty=%cd", "--date=short"]);
+      const commitDays = log.split(/\r?\n/).map((s) => s.trim()).filter(Boolean);
+      missingWorklogDays = detectWorklogGaps(commitDays, report.recentWorklogDates);
+    } catch {
+    }
   }
   let catchUp = null;
   if (config.autoRecord.archive) {
     try {
-      const { catchUpSessions: catchUpSessions2 } = await import("./catch-up-GDDKPZHJ.js");
+      const { catchUpSessions: catchUpSessions2 } = await import("./catch-up-KIHTAUPX.js");
       catchUp = await catchUpSessions2(ctx);
     } catch {
     }
@@ -9057,7 +9073,7 @@ async function runSessionStart(repoRoot, out) {
   let vectorized = null;
   let vectorizeSetupStarted = false;
   if (config.autoRecord.vectorize) {
-    const dbExists = existsSync16(join31(ctx.dataDir, "_indexes", "memory.sqlite"));
+    const dbExists = existsSync16(join30(ctx.dataDir, "_indexes", "memory.sqlite"));
     const action = decideVectorizeAction({
       vectorizeOn: true,
       dbExists,
@@ -9068,7 +9084,7 @@ async function runSessionStart(repoRoot, out) {
     });
     if (action === "inline") {
       try {
-        const { vectorizeIndex } = await import("./vectorize-PN4Y7XMO.js");
+        const { vectorizeIndex } = await import("./vectorize-RBDBTSTW.js");
         vectorized = await vectorizeIndex(ctx);
       } catch {
       }
@@ -9122,17 +9138,7 @@ async function runSessionStart(repoRoot, out) {
     handoffPrune: handoffPrune ?? void 0
   }));
 }
-async function runSessionEnd(repoRoot, out) {
-  const ctx = makeContext(repoRoot);
-  const config = loadVortexConfig(ctx);
-  if (config.autoRecord.worklog && hadActivityToday(repoRoot)) {
-    const res = await ensureWorklogEntry(ctx, {
-      body: "_Auto-created at session end (work detected but no worklog written). Enrich with the session's work, or remove if there is nothing to log._"
-    });
-    if (res.created)
-      out(`VortEX: created worklog ${res.path}
-`);
-  }
+async function runSessionEnd(_repoRoot, _out) {
 }
 function gitOut(cwd, gitArgs) {
   return execFileSync2("git", [...gitArgs], {
@@ -9156,7 +9162,7 @@ function detectInterruptedGitOp(repoRoot) {
     const resolved = gitOut(repoRoot, args).split(/\r?\n/).map((s) => s.trim());
     for (let i = 0; i < markers.length; i++) {
       const p = resolved[i];
-      if (p && existsSync16(isAbsolute5(p) ? p : join31(repoRoot, p)))
+      if (p && existsSync16(isAbsolute5(p) ? p : join30(repoRoot, p)))
         return markers[i];
     }
   } catch {
@@ -9172,19 +9178,6 @@ function collectCarryover(repoRoot, ignore) {
   }
   return uncommitted > 0 || interrupted ? { uncommitted, interrupted } : null;
 }
-function hadActivityToday(repoRoot) {
-  try {
-    const dirty = gitOut(repoRoot, ["status", "--porcelain"]).trim();
-    if (dirty)
-      return true;
-    const since = /* @__PURE__ */ new Date();
-    since.setHours(0, 0, 0, 0);
-    const commits = gitOut(repoRoot, ["log", "--oneline", `--since=${since.toISOString()}`]).trim();
-    return commits.length > 0;
-  } catch {
-    return false;
-  }
-}
 function resolveSessionEnvironment(ctx, config) {
   let environment = resolveEnvironment(config, {
     hostname: hostname(),
@@ -9194,7 +9187,7 @@ function resolveSessionEnvironment(ctx, config) {
   if (!environment)
     environment = process.env.VORTEX_ENV?.trim() || null;
   if (!environment) {
-    const envFile = join31(ctx.repoRoot, ".agent", "environment");
+    const envFile = join30(ctx.repoRoot, ".agent", "environment");
     if (existsSync16(envFile)) {
       environment = readFileSync4(envFile, "utf8").split(/\r?\n/)[0]?.trim() || null;
     }
@@ -9203,9 +9196,9 @@ function resolveSessionEnvironment(ctx, config) {
 }
 
 // ../plugins/session-rituals/dist/ambient-recall.js
-import { join as join32 } from "path";
+import { join as join31 } from "path";
 function defaultDbPath2(ctx) {
-  return join32(ctx.dataDir, "_indexes", "memory.sqlite");
+  return join31(ctx.dataDir, "_indexes", "memory.sqlite");
 }
 function createAmbientRecaller(ctx, options) {
   const resolveDb = options.dbPath ?? defaultDbPath2;
@@ -9240,6 +9233,51 @@ function createAmbientRecaller(ctx, options) {
     }
   });
 }
+
+// ../plugins/session-rituals/dist/worklog-write.js
+import { mkdir as mkdir10, writeFile as writeFile12 } from "fs/promises";
+import { dirname as dirname6, join as join32 } from "path";
+async function ensureWorklogEntry(ctx, opts) {
+  const now = opts?.now ?? /* @__PURE__ */ new Date();
+  const date = isoDate3(now);
+  const time = isoTime2(now);
+  const keyword = (opts?.keyword ?? "worklog").trim() || "worklog";
+  const store = new WorklogStore(join32(ctx.dataDir, "worklog"));
+  const existing = await store.get(date);
+  if (existing) {
+    return { path: existing.path, date: existing.date, keyword: existing.keyword, created: false };
+  }
+  const path = store.pathFor(date, keyword, time);
+  const title = opts?.title ?? `${date} worklog`;
+  await mkdir10(dirname6(path), { recursive: true });
+  await writeFile12(path, renderWorklogFile(date, title, opts?.body ?? ""), "utf8");
+  return { path, date, keyword, created: true };
+}
+function renderWorklogFile(date, title, body) {
+  const trimmed = body.trimEnd();
+  return `---
+type: worklog
+created: ${date}
+updated: ${date}
+tags: [worklog]
+---
+
+# ${title}
+` + (trimmed ? `
+${trimmed}
+` : ``);
+}
+function isoDate3(d2) {
+  const y2 = d2.getFullYear();
+  const m2 = String(d2.getMonth() + 1).padStart(2, "0");
+  const day = String(d2.getDate()).padStart(2, "0");
+  return `${y2}-${m2}-${day}`;
+}
+function isoTime2(d2) {
+  const h = String(d2.getHours()).padStart(2, "0");
+  const m2 = String(d2.getMinutes()).padStart(2, "0");
+  return `${h}${m2}`;
+}
 export {
   dist_exports5 as aiCodingPitfalls,
   dist_exports as core,