@vortex-os/base 0.2.3 → 0.3.0

package/dist/index.js

@@ -1,8 +1,7 @@
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
+import {
+  __export,
+  catchUpSessions
+} from "./chunk-6SO4DAWJ.js";
 
 // ../core/dist/index.js
 var dist_exports = {};
@@ -1873,7 +1872,7 @@ __export(dist_exports8, {
 
 // ../modules/worklog/dist/store.js
 import { readdir as readdir6, readFile as readFile6, stat as stat2 } from "fs/promises";
-import { join as join9 } from "path";
+import { join as join9, resolve as resolve2, sep } from "path";
 var FILENAME_PATTERN = /^(\d{4}-\d{2}-\d{2})-(.+)\.md$/;
 var MONTH_PATTERN = /^\d{2}$/;
 var YEAR_PATTERN = /^\d{4}$/;
@@ -1923,11 +1922,14 @@ var WorklogStore = class {
   }
   /** Resolve the file path for a given (date, keyword), without creating it. */
   pathFor(date, keyword) {
-    const [year, month] = date.split("-");
-    if (!year || !month) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(date)) {
       throw new Error(`Invalid date: ${date} (expected YYYY-MM-DD)`);
     }
-    return join9(this.rootDir, year, month, `${date}-${keyword}.md`);
+    const [year, month] = date.split("-");
+    validateSegment("keyword", keyword);
+    const abs = join9(this.rootDir, year, month, `${date}-${keyword}.md`);
+    assertContained(abs, this.rootDir);
+    return abs;
   }
   async listSubdirs(dir, pattern) {
     try {
@@ -1970,6 +1972,26 @@ var WorklogStore = class {
     return out;
   }
 };
+function validateSegment(label, value) {
+  const v2 = (value ?? "").trim();
+  if (v2.length === 0)
+    throw new Error(`${label} is required`);
+  if (v2.includes("/") || v2.includes("\\"))
+    throw new Error(`${label} must not contain path separators: ${value}`);
+  if (/(^|[\\/])\.\.([\\/]|$)/.test(v2) || v2 === "..")
+    throw new Error(`${label} must not contain '..': ${value}`);
+  if (v2.startsWith("/") || v2.startsWith("\\") || /^[a-zA-Z]:/.test(v2))
+    throw new Error(`${label} must be a relative name, not an absolute path: ${value}`);
+  if (/[\u0000-\u001f\u007f]/.test(v2))
+    throw new Error(`${label} must not contain NUL or control characters: ${value}`);
+}
+function assertContained(abs, rootDir) {
+  const root = resolve2(rootDir);
+  const target = resolve2(abs);
+  if (target !== root && !(target + sep).startsWith(root + sep)) {
+    throw new Error(`Refusing to write outside the store directory: ${abs}`);
+  }
+}
 
 // ../modules/worklog/dist/append.js
 import { readFile as readFile7, writeFile as writeFile3 } from "fs/promises";
@@ -1996,7 +2018,7 @@ __export(dist_exports9, {
 
 // ../modules/decision-log/dist/store.js
 import { readdir as readdir7, readFile as readFile8, stat as stat3 } from "fs/promises";
-import { join as join10 } from "path";
+import { join as join10, resolve as resolve3, sep as sep2 } from "path";
 var FILENAME_PATTERN2 = /^(\d{4}-\d{2}-\d{2})-(.+)\.md$/;
 var DecisionStore = class {
   rootDir;
@@ -2089,9 +2111,32 @@ var DecisionStore = class {
     if (!/^\d{4}-\d{2}-\d{2}$/.test(date)) {
       throw new Error(`Invalid date: ${date} (expected YYYY-MM-DD)`);
     }
-    return join10(this.rootDir, `${date}-${slug}.md`);
+    validateSegment2("slug", slug);
+    const abs = join10(this.rootDir, `${date}-${slug}.md`);
+    assertContained2(abs, this.rootDir);
+    return abs;
   }
 };
+function validateSegment2(label, value) {
+  const v2 = (value ?? "").trim();
+  if (v2.length === 0)
+    throw new Error(`${label} is required`);
+  if (v2.includes("/") || v2.includes("\\"))
+    throw new Error(`${label} must not contain path separators: ${value}`);
+  if (/(^|[\\/])\.\.([\\/]|$)/.test(v2) || v2 === "..")
+    throw new Error(`${label} must not contain '..': ${value}`);
+  if (v2.startsWith("/") || v2.startsWith("\\") || /^[a-zA-Z]:/.test(v2))
+    throw new Error(`${label} must be a relative name, not an absolute path: ${value}`);
+  if (/[\u0000-\u001f\u007f]/.test(v2))
+    throw new Error(`${label} must not contain NUL or control characters: ${value}`);
+}
+function assertContained2(abs, rootDir) {
+  const root = resolve3(rootDir);
+  const target = resolve3(abs);
+  if (target !== root && !(target + sep2).startsWith(root + sep2)) {
+    throw new Error(`Refusing to write outside the store directory: ${abs}`);
+  }
+}
 
 // ../modules/decision-log/dist/template.js
 function renderTemplate(input) {
@@ -2838,12 +2883,15 @@ function isActive(entry, nowMs) {
   const expiresMs = new Date(entry.expiresAt).getTime();
   return Number.isFinite(expiresMs) && expiresMs > nowMs;
 }
+var DANGEROUS_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
 function purgeExpired(entries, now) {
   if (!entries)
     return {};
-  const out = {};
+  const out = /* @__PURE__ */ Object.create(null);
   const nowMs = now.getTime();
   for (const [fp, entry] of Object.entries(entries)) {
+    if (DANGEROUS_KEYS.has(fp))
+      continue;
     if (isActive(entry, nowMs))
       out[fp] = entry;
   }
@@ -3898,6 +3946,7 @@ __export(dist_exports14, {
   SESSION_END_COMMAND: () => SESSION_END_COMMAND,
   SESSION_START_COMMAND: () => SESSION_START_COMMAND,
   agendaCommand: () => agendaCommand,
+  buildRegistry: () => buildRegistry,
   catchUpSessions: () => catchUpSessions,
   collectAgenda: () => collectAgenda,
   collectSessionStartReport: () => collectSessionStartReport,
@@ -3916,6 +3965,8 @@ __export(dist_exports14, {
   reindexCommand: () => reindexCommand,
   renderAgenda: () => renderAgenda,
   renderSessionStartReport: () => renderSessionStartReport,
+  resolveRepoRoot: () => resolveRepoRoot,
+  runVortexCli: () => runVortexCli,
   serializeSettings: () => serializeSettings,
   sessionStartCommand: () => sessionStartCommand,
   vortexCommand: () => vortexCommand
@@ -4399,8 +4450,8 @@ import { basename as basename7, dirname as dirname4, join as join22 } from "path
 import { fileURLToPath } from "url";
 
 // ../plugins/session-rituals/dist/ensure-hooks.js
-var SESSION_START_COMMAND = "node plugins/session-rituals/scripts/session-start-hook.mjs";
-var SESSION_END_COMMAND = "node plugins/session-rituals/scripts/session-end-hook.mjs";
+var SESSION_START_COMMAND = "npx --no-install -p @vortex-os/base vortex session-start";
+var SESSION_END_COMMAND = "npx --no-install -p @vortex-os/base vortex session-end";
 function parseSettings(text) {
   const trimmed = (text ?? "").trim();
   if (trimmed.length === 0)
@@ -4536,43 +4587,133 @@ function runHelp() {
     ]
   };
 }
-async function installCommandTemplates(repoRoot) {
+function resolveTemplatesDir() {
   const here = dirname4(fileURLToPath(import.meta.url));
-  const templatesDir = join22(here, "..", "..", "templates", "commands");
-  if (!existsSync8(templatesDir))
+  const candidates = [
+    join22(here, "..", "..", "templates"),
+    // session-rituals: dist/commands -> templates
+    join22(here, "..", "templates"),
+    // base aggregate: dist -> templates
+    join22(here, "templates")
+    // defensive: alongside the bundle
+  ];
+  for (const c of candidates) {
+    if (existsSync8(join22(c, "commands")) || existsSync8(join22(c, "routers")))
+      return c;
+  }
+  return null;
+}
+async function installCommandTemplates(repoRoot, templatesDir) {
+  if (!templatesDir)
+    return [];
+  const commandsDir = join22(templatesDir, "commands");
+  if (!existsSync8(commandsDir))
     return [];
   const destDir = join22(repoRoot, ".claude", "commands");
   await mkdir5(destDir, { recursive: true });
   const written = [];
-  for (const name of await readdir15(templatesDir)) {
+  for (const name of await readdir15(commandsDir)) {
     if (!name.endsWith(".md"))
       continue;
     const dest = join22(destDir, name);
     if (existsSync8(dest))
       continue;
-    await copyFile(join22(templatesDir, name), dest);
+    await copyFile(join22(commandsDir, name), dest);
+    written.push(dest);
+  }
+  return written;
+}
+var ROUTER_FILES = [
+  "AGENT.md",
+  "CLAUDE.md",
+  "CODEX.md",
+  "GEMINI.md",
+  ".cursorrules"
+];
+async function installRouterTemplates(repoRoot, templatesDir) {
+  if (!templatesDir)
+    return [];
+  const routersDir = join22(templatesDir, "routers");
+  if (!existsSync8(routersDir))
+    return [];
+  const written = [];
+  for (const name of ROUTER_FILES) {
+    const src = join22(routersDir, name);
+    if (!existsSync8(src))
+      continue;
+    const dest = join22(repoRoot, name);
+    if (existsSync8(dest))
+      continue;
+    await copyFile(src, dest);
     written.push(dest);
   }
   return written;
 }
+async function seedInstanceConfig(repoRoot, templatesDir) {
+  const written = [];
+  const agentDir = join22(repoRoot, ".agent");
+  const vortexJson = join22(agentDir, "vortex.json");
+  if (!existsSync8(vortexJson)) {
+    await mkdir5(agentDir, { recursive: true });
+    const tmpl = templatesDir ? join22(templatesDir, "config", "vortex.json") : null;
+    if (tmpl && existsSync8(tmpl)) {
+      await copyFile(tmpl, vortexJson);
+    } else {
+      await writeFile10(vortexJson, JSON.stringify({
+        autoRecord: {
+          sessionStart: true,
+          worklog: true,
+          decision: true,
+          ambientRecall: true,
+          archive: true
+        },
+        environments: []
+      }, null, 2) + "\n", "utf8");
+    }
+    written.push(vortexJson);
+  }
+  const pkgPath = join22(repoRoot, "package.json");
+  if (!existsSync8(pkgPath)) {
+    await writeFile10(pkgPath, JSON.stringify({
+      name: "vortex-instance",
+      version: "0.0.0",
+      private: true,
+      type: "module",
+      description: "A VortEX instance (created by `vortex init`)."
+    }, null, 2) + "\n", "utf8");
+    written.push(pkgPath);
+  }
+  return written;
+}
 async function runInit(input, tokens) {
   const args = parseInitArgs(tokens);
-  const { dataDir } = input.context;
+  const { dataDir, repoRoot } = input.context;
+  const templatesDir = resolveTemplatesDir();
   const requiredDirs = ["_memory", "worklog", "decision-log", "hubs", "inbox", "runbooks"];
   for (const d2 of requiredDirs) {
     const p = join22(dataDir, d2);
     if (!existsSync8(p))
       await mkdir5(p, { recursive: true });
   }
+  const scaffolded = [];
+  try {
+    scaffolded.push(...await installRouterTemplates(repoRoot, templatesDir));
+  } catch {
+  }
+  try {
+    scaffolded.push(...await seedInstanceConfig(repoRoot, templatesDir));
+  } catch {
+  }
   const profilePath = join22(dataDir, "_memory", "user_profile.md");
   if (existsSync8(profilePath) && !args.force) {
     return {
       subcommand: "init",
       status: "already-initialized",
-      created: [],
+      created: scaffolded,
       nextActions: [
         `VortEX instance is already initialized (${profilePath} exists).`,
-        "To re-run, pass `--force` (existing user_profile / first worklog / first hub will be overwritten).",
+        scaffolded.length > 0 ? `Seeded ${scaffolded.length} missing scaffolding file(s): ${scaffolded.map((p) => p.replace(repoRoot, ".")).join(", ")}.` : "All scaffolding (routers, .agent/vortex.json, package.json) already present.",
+        "To re-run, pass `--force` (existing user_profile / first worklog will be overwritten).",
         "To check current state, try `/session-start`."
       ]
     };
@@ -4610,7 +4751,12 @@ async function runInit(input, tokens) {
     };
   }
   const today2 = todayIso3();
-  const created = [];
+  const created = [...scaffolded];
+  const scaffoldNotes = [];
+  if (scaffolded.length > 0) {
+    const names = scaffolded.map((p) => p.replace(repoRoot, ".").replace(/\\/g, "/"));
+    scaffoldNotes.push(`Seeded instance scaffolding: ${names.join(", ")}.`);
+  }
   await writeFile10(profilePath, renderUserProfile(args.name, args.role, args.task, today2), "utf8");
   created.push(profilePath);
   const [year, month] = today2.split("-");
@@ -4636,7 +4782,7 @@ async function runInit(input, tokens) {
     hookNotes.push(`\u26A0\uFE0F Could not wire session hooks automatically: ${e.message} Copy .claude/settings.example.json to .claude/settings.json by hand to enable the boot report.`);
   }
   try {
-    const cmds = await installCommandTemplates(input.context.repoRoot);
+    const cmds = await installCommandTemplates(input.context.repoRoot, templatesDir);
     created.push(...cmds);
     if (cmds.length > 0) {
       hookNotes.push(`Installed ${cmds.length} slash command(s) into .claude/commands/ (${cmds.map((c) => "/" + basename7(c, ".md")).join(", ")}).`);
@@ -4647,6 +4793,7 @@ async function runInit(input, tokens) {
   const externalFolders = await detectExternalFolders(input.context.repoRoot);
   const baseNext = [
     `Done. Created ${created.length} files.`,
+    ...scaffoldNotes,
     ...hookNotes,
     "Next 3 things you can try right now:",
     "  /log <one-line update>       \u2014 append a section to today's worklog",
@@ -5653,7 +5800,7 @@ async function runSync(input, tokens) {
 var SYNC_TAIL_LENGTH = 1e3;
 async function runShellCommand(cmd, cmdArgs, cwd) {
   const start = Date.now();
-  return new Promise((resolve2) => {
+  return new Promise((resolve4) => {
     let stdout = "";
     let stderr = "";
     const child = spawn(cmd, [...cmdArgs], { cwd, shell: true });
@@ -5664,7 +5811,7 @@ async function runShellCommand(cmd, cmdArgs, cwd) {
       stderr += chunk.toString("utf8");
     });
     child.on("close", (code) => {
-      resolve2({
+      resolve4({
         exitCode: code ?? -1,
         durationMs: Date.now() - start,
         stdoutTail: tailString(stdout, SYNC_TAIL_LENGTH),
@@ -5672,7 +5819,7 @@ async function runShellCommand(cmd, cmdArgs, cwd) {
       });
     });
     child.on("error", (err) => {
-      resolve2({
+      resolve4({
         exitCode: -1,
         durationMs: Date.now() - start,
         stdoutTail: tailString(stdout, SYNC_TAIL_LENGTH),
@@ -5864,43 +6011,16 @@ function createRitualRegistry(options) {
   return registry;
 }
 
-// ../plugins/session-rituals/dist/ambient-recall.js
-import { join as join23 } from "path";
-function defaultDbPath2(ctx) {
-  return join23(ctx.dataDir, "_indexes", "memory.sqlite");
-}
-function createAmbientRecaller(ctx, options) {
-  const resolveDb = options.dbPath ?? defaultDbPath2;
-  const dbPath = resolveDb(ctx);
-  return new AmbientRecaller({
-    ...options.minScore !== void 0 ? { minScore: options.minScore } : {},
-    ...options.maxSuggestions !== void 0 ? { maxSuggestions: options.maxSuggestions } : {},
-    ...options.minQueryChars !== void 0 ? { minQueryChars: options.minQueryChars } : {},
-    recall: async (query, opts) => {
-      const { sqlite, vector, recall: recallEngine } = await import("@vortex-os/memory-extended");
-      const sqlStore = new sqlite.MemorySqliteStore(dbPath);
-      const vecStore = new vector.MemoryVectorStore({ db: dbPath });
-      const chunkStore = new vector.SessionChunkStore(dbPath);
-      try {
-        const result = await recallEngine.recall({
-          query,
-          ...opts?.k !== void 0 ? { k: opts.k } : {},
-          ...options.source !== void 0 ? { source: options.source } : {}
-        }, { sqlite: sqlStore, vector: vecStore, embed: options.embed, sessionChunks: chunkStore });
-        return { hits: result.hits };
-      } finally {
-        chunkStore.close();
-        vecStore.close();
-        sqlStore.close();
-      }
-    }
-  });
-}
+// ../plugins/session-rituals/dist/cli-dispatch.js
+import { execFileSync } from "child_process";
+import { existsSync as existsSync10, readFileSync as readFileSync2 } from "fs";
+import { hostname } from "os";
+import { join as join25 } from "path";
 
 // ../plugins/session-rituals/dist/session-start-report.js
 import { existsSync as existsSync9 } from "fs";
 import { readdir as readdir16, readFile as readFile18 } from "fs/promises";
-import { join as join24 } from "path";
+import { join as join23 } from "path";
 var COUNTED_DIRS2 = ["_memory", "worklog", "decision-log"];
 var DEFAULT_GAP_WINDOW_DAYS = 30;
 var BOOT_BANNER = String.raw`
@@ -5914,7 +6034,7 @@ async function collectSessionStartReport(ctx, opts) {
   const counts = {};
   const missing = [];
   for (const name of COUNTED_DIRS2) {
-    const dir = join24(ctx.dataDir, name);
+    const dir = join23(ctx.dataDir, name);
     if (!existsSync9(dir)) {
       missing.push(name);
       counts[name] = 0;
@@ -5986,13 +6106,13 @@ async function countMarkdown3(dir, recursive) {
     } else if (e.isDirectory() && recursive) {
       if (e.name.startsWith(".") || e.name.startsWith("_"))
         continue;
-      total += await countMarkdown3(join24(dir, e.name), recursive);
+      total += await countMarkdown3(join23(dir, e.name), recursive);
     }
   }
   return total;
 }
 async function scanWorklog(dataDir) {
-  const root = join24(dataDir, "worklog");
+  const root = join23(dataDir, "worklog");
   if (!existsSync9(root))
     return { recent: null, dates: [] };
   let bestRel = null;
@@ -6007,7 +6127,7 @@ async function scanWorklog(dataDir) {
     for (const e of entries) {
       const childRel = rel ? `${rel}/${e.name}` : e.name;
       if (e.isDirectory()) {
-        await walk5(join24(absDir, e.name), childRel);
+        await walk5(join23(absDir, e.name), childRel);
       } else if (e.isFile()) {
         const m2 = e.name.match(/^(\d{4}-\d{2}-\d{2})-.+\.md$/);
         if (!m2)
@@ -6019,7 +6139,7 @@ async function scanWorklog(dataDir) {
     }
   }
   await walk5(root, "");
-  const recent = bestRel === null ? null : { path: `worklog/${bestRel}`, title: await readTitle(join24(root, bestRel)) };
+  const recent = bestRel === null ? null : { path: `worklog/${bestRel}`, title: await readTitle(join23(root, bestRel)) };
   return { recent, dates: [...dates] };
 }
 async function readTitle(absPath) {
@@ -6047,11 +6167,11 @@ function isoDate(d2) {
 
 // ../plugins/session-rituals/dist/worklog-write.js
 import { mkdir as mkdir6, writeFile as writeFile11 } from "fs/promises";
-import { dirname as dirname5, join as join25 } from "path";
+import { dirname as dirname5, join as join24 } from "path";
 async function ensureWorklogEntry(ctx, opts) {
   const date = isoDate2(opts?.now ?? /* @__PURE__ */ new Date());
   const keyword = (opts?.keyword ?? "worklog").trim() || "worklog";
-  const store = new WorklogStore(join25(ctx.dataDir, "worklog"));
+  const store = new WorklogStore(join24(ctx.dataDir, "worklog"));
   const existing = await store.get(date);
   if (existing) {
     return { path: existing.path, date: existing.date, keyword: existing.keyword, created: false };
@@ -6083,25 +6203,205 @@ function isoDate2(d2) {
   return `${y2}-${m2}-${day}`;
 }
 
-// ../plugins/session-rituals/dist/catch-up.js
-async function catchUpSessions(ctx, opts) {
-  const { sessionArchive } = await import("@vortex-os/memory-extended");
-  const dataDir = ctx.dataDir;
-  const cwd = opts?.cwd ?? ctx.repoRoot;
-  const adapters = opts?.adapters ?? [sessionArchive.claudeCodeAdapter];
-  const ingestResult = await sessionArchive.ingest({ adapters, dataDir, cwd, env: opts?.env });
-  const store = new sessionArchive.SessionArchiveStore(dataDir);
-  let indexedPulled = 0;
+// ../plugins/session-rituals/dist/cli-dispatch.js
+var VORTEX_SUBCOMMANDS = ["init", "status", "import", "doctor", "sync"];
+async function buildRegistry() {
   try {
-    indexedPulled = store.reindexFromNormalized().indexed;
-  } finally {
-    store.close();
+    const { vector } = await import("@vortex-os/memory-extended");
+    return createRitualRegistry({ recall: { embed: vector.createLocalEmbedder() } });
+  } catch {
+    return createRitualRegistry();
   }
-  return {
-    ingestedLocal: ingestResult.sessionsIngested,
-    indexedPulled,
-    errors: ingestResult.errors.length
-  };
+}
+function resolveRepoRoot() {
+  return process.env.VORTEX_REPO_ROOT?.trim() || process.cwd();
+}
+function requote(token) {
+  if (!/\s/.test(token))
+    return token;
+  if (token.includes('"') && !token.includes("'"))
+    return `'${token}'`;
+  return `"${token.replace(/"/g, "")}"`;
+}
+async function runVortexCli(argv, io) {
+  const out = io?.stdout ?? ((s) => process.stdout.write(s));
+  const err = io?.stderr ?? ((s) => process.stderr.write(s));
+  const repoRoot = resolveRepoRoot();
+  try {
+    if (argv[0] === "session-start") {
+      await runSessionStart(repoRoot, out);
+      return 0;
+    }
+    if (argv[0] === "session-end") {
+      await runSessionEnd(repoRoot, out);
+      return 0;
+    }
+    const registry = await buildRegistry();
+    if (argv.length === 0 || argv[0] === "--list" || argv[0] === "--help") {
+      const names = registry.list().map((c) => `  ${c.name}  \u2014  ${c.description}`).join("\n");
+      err(`vortex \u2014 headless ritual runner
+
+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)
+
+Instance shortcuts (also available as \`/vortex <sub>\`):
+  init   \u2014  first-time setup: routers + data/ + hooks + slash-commands
+  status \u2014  instance state report
+  import \u2014  bring an existing notes folder into data/
+  doctor \u2014  health diagnosis
+
+Usage: vortex <command> [args...]
+`);
+      return 0;
+    }
+    const name = argv[0];
+    const isVortexSub = VORTEX_SUBCOMMANDS.includes(name);
+    const body = (isVortexSub ? argv : argv.slice(1)).map(requote).join(" ");
+    const slash = isVortexSub ? `/vortex ${body}` : `/${name} ${body}`;
+    const context = makeContext(repoRoot);
+    const result = await runSlash(slash.trim(), { registry, context });
+    out(JSON.stringify(result, null, 2) + "\n");
+    return 0;
+  } catch (e) {
+    if (e instanceof CommandNotFoundError) {
+      err(`[vortex] unknown command: ${e.message}
+Run \`vortex --list\` to see available commands.
+`);
+    } else {
+      err(`[vortex] error: ${e?.message ?? e}
+`);
+    }
+    return 1;
+  }
+}
+async function runSessionStart(repoRoot, out) {
+  const ctx = makeContext(repoRoot);
+  const config = loadVortexConfig(ctx);
+  if (!config.autoRecord.sessionStart)
+    return;
+  const environment = resolveSessionEnvironment(ctx, config);
+  let git = null;
+  try {
+    const remotes = gitOut(repoRoot, ["remote"]).trim();
+    if (remotes) {
+      try {
+        const pulled = gitOut(repoRoot, ["pull", "--ff-only"]);
+        const lastLine = pulled.trim().split(/\r?\n/).pop() || "up to date";
+        git = { ran: true, summary: lastLine, conflict: false };
+      } catch {
+        git = {
+          ran: true,
+          summary: "fast-forward pull failed (diverged or dirty tree)",
+          conflict: true
+        };
+      }
+    }
+  } catch {
+  }
+  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 {
+  }
+  let catchUp = null;
+  if (config.autoRecord.archive) {
+    try {
+      const { catchUpSessions: catchUpSessions2 } = await import("./catch-up-ZQN7HMMN.js");
+      catchUp = await catchUpSessions2(ctx);
+    } catch {
+    }
+  }
+  out(renderSessionStartReport(report, {
+    git,
+    missingWorklogDays,
+    catchUp: catchUp ?? 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}
+`);
+  }
+}
+function gitOut(cwd, gitArgs) {
+  return execFileSync("git", [...gitArgs], {
+    cwd,
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "ignore"]
+  });
+}
+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(),
+    env: process.env,
+    pathExists: existsSync10
+  });
+  if (!environment)
+    environment = process.env.VORTEX_ENV?.trim() || null;
+  if (!environment) {
+    const envFile = join25(ctx.repoRoot, ".agent", "environment");
+    if (existsSync10(envFile)) {
+      environment = readFileSync2(envFile, "utf8").split(/\r?\n/)[0]?.trim() || null;
+    }
+  }
+  return environment;
+}
+
+// ../plugins/session-rituals/dist/ambient-recall.js
+import { join as join26 } from "path";
+function defaultDbPath2(ctx) {
+  return join26(ctx.dataDir, "_indexes", "memory.sqlite");
+}
+function createAmbientRecaller(ctx, options) {
+  const resolveDb = options.dbPath ?? defaultDbPath2;
+  const dbPath = resolveDb(ctx);
+  return new AmbientRecaller({
+    ...options.minScore !== void 0 ? { minScore: options.minScore } : {},
+    ...options.maxSuggestions !== void 0 ? { maxSuggestions: options.maxSuggestions } : {},
+    ...options.minQueryChars !== void 0 ? { minQueryChars: options.minQueryChars } : {},
+    recall: async (query, opts) => {
+      const { sqlite, vector, recall: recallEngine } = await import("@vortex-os/memory-extended");
+      const sqlStore = new sqlite.MemorySqliteStore(dbPath);
+      const vecStore = new vector.MemoryVectorStore({ db: dbPath });
+      const chunkStore = new vector.SessionChunkStore(dbPath);
+      try {
+        const result = await recallEngine.recall({
+          query,
+          ...opts?.k !== void 0 ? { k: opts.k } : {},
+          ...options.source !== void 0 ? { source: options.source } : {}
+        }, { sqlite: sqlStore, vector: vecStore, embed: options.embed, sessionChunks: chunkStore });
+        return { hits: result.hits };
+      } finally {
+        chunkStore.close();
+        vecStore.close();
+        sqlStore.close();
+      }
+    }
+  });
 }
 export {
   dist_exports5 as aiCodingPitfalls,