@vortex-os/base 0.7.1 → 0.7.2

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 vortex-os-project
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 vortex-os-project
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -40,7 +40,7 @@ npx vortex init                                          # scaffold the instance
 
 - the per-agent files — `AGENTS.md` (the thin Codex-CLI entry, auto-loaded by Codex and other `AGENTS.md`-aware tools) plus thin routers `CLAUDE.md`, `GEMINI.md`, `.cursorrules`, all pointing at `AI-RULES.md` (the single source of truth for shared rules) — so any agent host finds VortEX's behavior contract (these are generic templates you personalize over time);
 - the `data/` skeleton (`_memory/`, `worklog/`, `decision-log/`, `runbooks/`, `hubs/`, `inbox/`), your user-profile memory, and today's first worklog;
-- `.claude/settings.json` with the session hooks wired as `npx --no-install -p @vortex-os/base vortex session-start` / `… session-end` (the `--no-install` flag and explicit `-p` package make the auto-firing hook fail closed rather than install or shadow), plus the agent-mediated slash-commands in `.claude/commands/`;
+- `.claude/settings.json` with the session hooks wired as `npx --no-install vortex session-start` / `… session-end` (the `--no-install` flag makes the auto-firing hook fail closed rather than install on a cache miss; resolving the bare `vortex` bin — local `node_modules/.bin` first, then PATH — lets the `global-setup` hook fire from any folder, not only where a local install exists), plus the agent-mediated slash-commands in `.claude/commands/`;
 - `.agent/vortex.json` (auto-record config) and a minimal `package.json` with `"type":"module"` if none exists.
 
 `vortex import --from <folder>` brings an existing notes folder in — markdown is auto-classified (worklog / decision-log / …) and **attachments (PDFs, images, …) are copied byte-for-byte** into the same layout; credential files (`*.key`, `.env`, `secrets/` …) and oversized files are skipped and reported. As the framework improves, `vortex update` refreshes the installed templates **without ever overwriting a file you edited** (your edit is parked at `<file>.new`); `vortex doctor` checks instance health.

package/bin/vortex.mjs

@@ -1,17 +1,17 @@
-#!/usr/bin/env node
-// `vortex` — the CLI shipped by @vortex-os/base.
-//
-// `npm i @vortex-os/base` puts this on the instance's path (node_modules/.bin),
-// so `npx vortex init` / `npx vortex session-start` / `npx vortex --list` work
-// without any monorepo checkout. It is a thin wrapper over the canonical
-// dispatch (`runVortexCli`), which is bundled into base from
-// `@vortex-os/session-rituals` — exactly one source of truth for the CLI logic.
-//
-// The dispatch lazily probes the optional `@vortex-os/memory-extended` add-on:
-// when it is installed alongside base, `/recall` lights up; on a lean base-only
-// install the probe is caught and the CLI runs with every other command.
-
-import { sessionRituals } from "../dist/index.js";
-
-const code = await sessionRituals.runVortexCli(process.argv.slice(2));
-process.exitCode = code;
+#!/usr/bin/env node
+// `vortex` — the CLI shipped by @vortex-os/base.
+//
+// `npm i @vortex-os/base` puts this on the instance's path (node_modules/.bin),
+// so `npx vortex init` / `npx vortex session-start` / `npx vortex --list` work
+// without any monorepo checkout. It is a thin wrapper over the canonical
+// dispatch (`runVortexCli`), which is bundled into base from
+// `@vortex-os/session-rituals` — exactly one source of truth for the CLI logic.
+//
+// The dispatch lazily probes the optional `@vortex-os/memory-extended` add-on:
+// when it is installed alongside base, `/recall` lights up; on a lean base-only
+// install the probe is caught and the CLI runs with every other command.
+
+import { sessionRituals } from "../dist/index.js";
+
+const code = await sessionRituals.runVortexCli(process.argv.slice(2));
+process.exitCode = code;

package/dist/{catch-up-GDDKPZHJ.js → catch-up-KIHTAUPX.js}

@@ -1,8 +1,8 @@
 import {
   catchUpSessions
-} from "./chunk-3L5DLEGP.js";
+} from "./chunk-7SNLVGBO.js";
 import "./chunk-PZ5AY32C.js";
 export {
   catchUpSessions
 };
-//# sourceMappingURL=catch-up-GDDKPZHJ.js.map
+//# sourceMappingURL=catch-up-KIHTAUPX.js.map

package/dist/{chunk-3L5DLEGP.js → chunk-7SNLVGBO.js}

@@ -26,4 +26,4 @@ async function catchUpSessions(ctx, opts) {
 export {
   catchUpSessions
 };
-//# sourceMappingURL=chunk-3L5DLEGP.js.map
+//# sourceMappingURL=chunk-7SNLVGBO.js.map

package/dist/chunk-7SNLVGBO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../plugins/session-rituals/src/catch-up.ts"],"sourcesContent":["import type { ModuleContext } from \"@vortex-os/core\";\r\n// Type-only — erased at compile time, so importing it does NOT pull the\r\n// `@vortex-os/memory-extended` add-on (or its native sqlite/level deps) into\r\n// the module graph of consumers that only need the types. The runtime engine\r\n// is loaded lazily inside the function body via `await import(...)`.\r\nimport type { sessionArchive } from \"@vortex-os/memory-extended\";\r\n\r\n/**\r\n * Start-of-session \"catch-up\": fold conversation transcripts into the local\r\n * search archive without the user ever having to wrap up a session.\r\n *\r\n * Two sources, one pass:\r\n *  - **local (a)** — this machine's own transcripts that are not archived yet,\r\n *    read from every detected agent host's transcript store (Claude Code,\r\n *    Codex, Gemini) and scoped to the current project. Because all hosts are\r\n *    swept on every start, a single Claude Code session-start also folds in the\r\n *    Codex/Gemini sessions you ran in the same project, into one archive.\r\n *  - **pulled (b)** — transcripts created on another machine that arrived as\r\n *    normalized text via git sync. Their text is present but this machine's\r\n *    DB (local, derived, gitignored) has never indexed them.\r\n *\r\n * Text only — vectorization is deferred to recall/rebuild so session start\r\n * stays fast. The whole step is gated by `autoRecord.archive` at the call site\r\n * and is best-effort: callers should treat a thrown archive backend (e.g. the\r\n * native sqlite module not built) as \"skip\", never as a fatal start error.\r\n */\r\nexport interface CatchUpResult {\r\n  /** Local transcripts newly archived this run (source a). */\r\n  readonly ingestedLocal: number;\r\n  /** Normalized transcripts from another machine newly indexed (source b). */\r\n  readonly indexedPulled: number;\r\n  /** Per-session ingest errors (source a). */\r\n  readonly errors: number;\r\n}\r\n\r\nexport interface CatchUpOptions {\r\n  /** Restrict local ingest to one project's transcripts. Default: `ctx.repoRoot`. */\r\n  readonly cwd?: string;\r\n  /**\r\n   * Transcript adapters for local ingest. Default: all CLI hosts — Claude Code,\r\n   * Codex, and Gemini. Each adapter's `detect()` returns false when its host is\r\n   * absent, so registering all three is ~free on a machine that only uses one.\r\n   * (Claude Desktop is opt-in — it needs the `classic-level` dependency — so it\r\n   * is not in the default set; a caller can add it.) Tests inject fakes (or a\r\n   * sandbox `env.home`) so the scan never touches the real home directory.\r\n   */\r\n  readonly adapters?: sessionArchive.IngestParams[\"adapters\"];\r\n  /** Adapter environment override (e.g. a sandbox HOME). Tests use this. */\r\n  readonly env?: sessionArchive.IngestParams[\"env\"];\r\n}\r\n\r\nexport async function catchUpSessions(\r\n  ctx: ModuleContext,\r\n  opts?: CatchUpOptions,\r\n): Promise<CatchUpResult> {\r\n  // Lazy-load the optional add-on. Base ships without `memory-extended`; this\r\n  // import resolves only when the add-on is installed alongside it. The call\r\n  // site already gates this step on `autoRecord.archive` and treats a thrown\r\n  // backend as \"skip\", so a missing add-on surfaces as a normal load error\r\n  // the caller can catch.\r\n  const { sessionArchive } = await import(\"@vortex-os/memory-extended\");\r\n\r\n  const dataDir = ctx.dataDir;\r\n  const cwd = opts?.cwd ?? ctx.repoRoot;\r\n  const adapters = opts?.adapters ?? [\r\n    sessionArchive.claudeCodeAdapter,\r\n    sessionArchive.codexAdapter,\r\n    sessionArchive.geminiAdapter,\r\n  ];\r\n\r\n  // (a) Ingest this machine's not-yet-archived transcripts for the current\r\n  // project. Writes the normalized copy into the archive (which git syncs) and\r\n  // a local DB row. Text only — no vectorization here.\r\n  const ingestResult = await sessionArchive.ingest({ adapters, dataDir, cwd, env: opts?.env });\r\n\r\n  // (b) Index normalized transcripts that arrived from another machine via git\r\n  // pull — their text is on disk but this machine's DB has no row yet.\r\n  const store = new sessionArchive.SessionArchiveStore(dataDir);\r\n  let indexedPulled = 0;\r\n  try {\r\n    indexedPulled = store.reindexFromNormalized().indexed;\r\n  } finally {\r\n    store.close();\r\n  }\r\n\r\n  return {\r\n    ingestedLocal: ingestResult.sessionsIngested,\r\n    indexedPulled,\r\n    errors: ingestResult.errors.length,\r\n  };\r\n}\r\n"],"mappings":";AAmDA,eAAsB,gBACpB,KACA,MAAqB;AAOrB,QAAM,EAAE,eAAc,IAAK,MAAM,OAAO,4BAA4B;AAEpE,QAAM,UAAU,IAAI;AACpB,QAAM,MAAM,MAAM,OAAO,IAAI;AAC7B,QAAM,WAAW,MAAM,YAAY;IACjC,eAAe;IACf,eAAe;IACf,eAAe;;AAMjB,QAAM,eAAe,MAAM,eAAe,OAAO,EAAE,UAAU,SAAS,KAAK,KAAK,MAAM,IAAG,CAAE;AAI3F,QAAM,QAAQ,IAAI,eAAe,oBAAoB,OAAO;AAC5D,MAAI,gBAAgB;AACpB,MAAI;AACF,oBAAgB,MAAM,sBAAqB,EAAG;EAChD;AACE,UAAM,MAAK;EACb;AAEA,SAAO;IACL,eAAe,aAAa;IAC5B;IACA,QAAQ,aAAa,OAAO;;AAEhC;","names":[]}

package/dist/index.d.ts

@@ -2684,8 +2684,8 @@ declare function collectCarryover(repoRoot: string, ignore?: (repoRelPosixPath:
  * file read/write around them. Keeping them pure makes the merge unit-testable
  * and the "writes only what's missing" guarantee verifiable.
  */
-declare const SESSION_START_COMMAND = "npx --no-install -p @vortex-os/base vortex session-start || exit 0";
-declare const SESSION_END_COMMAND = "npx --no-install -p @vortex-os/base vortex session-end || exit 0";
+declare const SESSION_START_COMMAND = "npx --no-install vortex session-start || exit 0";
+declare const SESSION_END_COMMAND = "npx --no-install vortex session-end || exit 0";
 interface HookCommand {
     readonly type: "command";
     readonly command: string;

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   catchUpSessions
-} from "./chunk-3L5DLEGP.js";
+} from "./chunk-7SNLVGBO.js";
 import {
   __export
 } from "./chunk-PZ5AY32C.js";
@@ -4780,11 +4780,17 @@ import { basename as basename7, dirname as dirname5, extname as extname11, join
 import { fileURLToPath } from "url";
 
 // ../plugins/session-rituals/dist/ensure-hooks.js
-var SESSION_START_COMMAND = "npx --no-install -p @vortex-os/base vortex session-start || exit 0";
-var SESSION_END_COMMAND = "npx --no-install -p @vortex-os/base vortex session-end || exit 0";
+var SESSION_START_COMMAND = "npx --no-install vortex session-start || exit 0";
+var SESSION_END_COMMAND = "npx --no-install vortex session-end || exit 0";
 var LEGACY_COMMANDS = {
-  SessionStart: "npx --no-install -p @vortex-os/base vortex session-start",
-  SessionEnd: "npx --no-install -p @vortex-os/base vortex session-end"
+  SessionStart: [
+    "npx --no-install -p @vortex-os/base vortex session-start || exit 0",
+    "npx --no-install -p @vortex-os/base vortex session-start"
+  ],
+  SessionEnd: [
+    "npx --no-install -p @vortex-os/base vortex session-end || exit 0",
+    "npx --no-install -p @vortex-os/base vortex session-end"
+  ]
 };
 function parseSettings(text) {
   const trimmed = (text ?? "").trim();
@@ -4814,7 +4820,7 @@ function ensureVortexHooks(existing) {
     for (const g of src) {
       const hookList = [];
       for (const h of g.hooks ?? []) {
-        const migrated = h.command === legacy;
+        const migrated = legacy.includes(h.command);
         const cmd = migrated ? command : h.command;
         if (cmd === command) {
           if (kept) {
@@ -8647,7 +8653,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);
@@ -8719,7 +8725,7 @@ async function runSessionStart(repoRoot, out) {
   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 {
     }
@@ -8738,7 +8744,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 {
       }