@vortex-os/base 0.8.0 → 0.10.0

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

@@ -58,7 +58,7 @@ npx vortex --list           # list available commands
 npx vortex status           # instance state report
 npx vortex import --from X  # bring an existing notes folder into data/
 npx vortex session-start    # start-of-session boot report (git pull + counts + catch-up)
-npx vortex session-end      # worklog safety net
+npx vortex session-end      # no-op (kept for hook compatibility; gap handling is at session-start)
 npx vortex doctor           # health diagnosis
 npx vortex update           # refresh framework templates (never clobbers your edits)
 ```

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

@@ -146,6 +146,39 @@ interface AutoRecordConfig {
      * wait for you to merge.
      */
     readonly commitFrameworkChanges: boolean;
+    /**
+     * Use the dedicated session hand-off store (`data/_handoff/`) — a forward-
+     * looking baton kept separate from the worklog. On by default. When off,
+     * hand-offs fall back to the legacy `## 다음 작업` worklog section and no
+     * auto-archiving runs.
+     */
+    readonly handoff: boolean;
+    /**
+     * Days a hand-off stays "active" before session start sweeps it to
+     * `_handoff/_archive/` (deterministic, age-based — git keeps the history).
+     * Default 7 (covers a week-long absence); set lower to tidy faster, higher to
+     * keep more around. A non-positive / malformed value falls back to the default.
+     */
+    readonly handoffRetentionDays: number;
+    /**
+     * Auto-reindex the on-demand memory index (`_memory/_INDEX.md`) at session
+     * start when it looks stale (a memory file is newer than the index).
+     * Mechanical and idempotent — it only rewrites `_INDEX.md` from each memory's
+     * frontmatter, never a memory's content, and writes only when the rendered
+     * index actually changes (then refreshes the index's mtime so the stale flag
+     * clears). On by default; off → the start report just flags the stale index
+     * for the agent to fix instead of fixing it automatically.
+     */
+    readonly reindex: boolean;
+    /**
+     * Auto-backfill a missed worklog. When a past day had commits but no worklog,
+     * the in-session agent reconstructs and writes it at the next session start
+     * (zero-worklog days only, capped, labeled as reconstructed — see AI-RULES.md
+     * "Default behaviors"). Gated by `worklog` as well: turning `worklog` off
+     * suppresses backfill too. On by default; off → the start report still flags
+     * the gap but the agent leaves it for you.
+     */
+    readonly backfill: boolean;
 }
 /**
  * One environment label plus the signal that selects it. Rules are evaluated
@@ -896,11 +929,14 @@ interface WorklogFrontmatter {
  * A parsed worklog entry.
  *
  * `date` is the ISO date portion of the filename (`YYYY-MM-DD`).
+ * `time` is the optional `HHMM` creation-time segment (`YYYY-MM-DD_HHMM-…`);
+ * absent on legacy names that predate the time convention.
  * `keyword` is the trailing slug portion of the filename without `.md`.
  * `path` is the absolute path of the file on disk.
  */
 interface WorklogEntry {
     readonly date: string;
+    readonly time?: string;
     readonly keyword: string;
     readonly path: string;
     readonly frontmatter: WorklogFrontmatter;
@@ -929,7 +965,7 @@ declare class WorklogStore {
     /** Most recent entry by date (descending), then keyword (descending). */
     getLatest(): Promise<WorklogEntry | undefined>;
     /** Resolve the file path for a given (date, keyword), without creating it. */
-    pathFor(date: string, keyword: string): string;
+    pathFor(date: string, keyword: string, time?: string): string;
     private listSubdirs;
     private entriesIn;
 }
@@ -3012,6 +3048,16 @@ interface SessionStartReport {
  */
 declare const sessionStartCommand: Command<SessionStartReport>;
 
+/**
+ * The single gap-detection window (days). Worklog-gap detection compares two
+ * sets over the SAME span: worklog dates present (filtered here) and commit days
+ * (the hook supplies them). The commit lookup MUST use this same window — see
+ * `gapWindowSinceArg()` — or gaps older than the commit lookup are invisible
+ * while younger-than-the-worklog-window dates leak in. Keep them aligned.
+ */
+declare const DEFAULT_GAP_WINDOW_DAYS = 30;
+/** `git log --since=<this>` argument for commit-day lookup — aligned to the worklog window. */
+declare function gapWindowSinceArg(): string;
 interface RecentWorklog {
     /** Path relative to the data directory (e.g. `worklog/2026/05/2026-05-30-foo.md`). */
     readonly path: string;
@@ -3096,6 +3142,22 @@ interface SessionStartHookReport {
      * exist but `_INDEX.md` is missing, or a `_memory/*.md` is newer than it.
      */
     readonly memoryIndexStale: boolean;
+    /**
+     * Active session hand-offs (`data/_handoff/`, newest first) — the forward-
+     * looking "resume from here" batons, kept separate from the worklog. Each
+     * carries a SANITIZED title and its next-step lines. Multiple are NORMAL
+     * (concurrent sessions). When any exist they are the canonical resume surface
+     * and the render shows them in place of the worklog-derived `nextUp`.
+     */
+    readonly handoffs: readonly {
+        readonly date: string;
+        readonly time: string;
+        readonly path: string;
+        readonly title: string;
+        readonly nextUp: readonly string[];
+    }[];
+    /** Active hand-offs beyond the surfaced cap (0 = none). */
+    readonly handoffsOmitted: number;
 }
 /**
  * Gather the read-only facts for a start-of-session report: data-dir counts,
@@ -3141,6 +3203,10 @@ declare function renderSessionStartReport(report: SessionStartHookReport, extras
      */
     readonly baseVersion?: string | null;
     readonly missingWorklogDays?: readonly string[];
+    /** Hand-offs swept to `_handoff/_archive/` by the age-based prune this run. */
+    readonly handoffPrune?: {
+        readonly archived: number;
+    };
     readonly catchUp?: {
         readonly ingestedLocal: number;
         readonly indexedPulled: number;
@@ -3284,6 +3350,17 @@ interface ReindexResult {
  * directories are reported as `missing` (no write attempted).
  */
 declare const reindexCommand: Command<readonly ReindexResult[]>;
+/**
+ * Auto-reindex `_memory/_INDEX.md` at session start (gated by
+ * `autoRecord.reindex`). Mechanical and idempotent: it rewrites the index only
+ * when the rendered content changes, then refreshes the index file's mtime so
+ * the stale flag — newest `_memory/*.md` mtime > `_INDEX.md` mtime, see
+ * `scanMemoryTiers` — clears even when the content was unchanged (a memory's
+ * BODY changed but its one-line index row did not). Touching identical content
+ * changes only mtime, so there is no git churn. Best-effort: any error returns
+ * `"error"` and never blocks session start.
+ */
+declare function autoReindexMemory(ctx: ModuleContext): Promise<ReindexResult["status"] | "error">;
 
 interface NewDecisionResult {
     readonly path: string;
@@ -3318,6 +3395,94 @@ interface WorklogAppendResult {
  */
 declare const logCommand: Command<WorklogAppendResult>;
 
+interface HandoffCreateResult {
+    readonly path: string;
+    readonly date: string;
+    readonly time: string;
+}
+/**
+ * `/handoff [title]` — Create a new, empty session hand-off file under
+ * `data/_handoff/` (named `YYYY-MM-DD_HHMM.md`, with a `-2` suffix only on a
+ * same-minute collision) and return its path for the agent to fill in.
+ *
+ * Deliberately small, mirroring `/log`: the host creates the file SAFELY
+ * (atomic exclusive create, so a concurrent session never clobbers another's
+ * baton), and the agent writes the actual hand-off content into the returned
+ * file. The hand-off is a forward-looking baton kept separate from the worklog;
+ * old ones are swept to `_handoff/_archive/` automatically at session start.
+ */
+declare const handoffCommand: Command<HandoffCreateResult>;
+
+/**
+ * Session hand-off store: `data/_handoff/`.
+ *
+ * A hand-off is a forward-looking baton — "where this session stopped and what
+ * the next one should pick up" — kept SEPARATE from the worklog (the permanent,
+ * backward-looking record). One file per session, named
+ * `YYYY-MM-DD_HHMM.md` (a `-2`/`-3` suffix is added only when two sessions wrap
+ * in the same minute, so a concurrent session never clobbers another's baton).
+ * The file is created with an EXCLUSIVE open (`wx`) so that collision handling
+ * is atomic, not an LLM ritual. Old hand-offs are swept to `_handoff/_archive/`
+ * by {@link pruneHandoffs} (deterministic, age-based) — git keeps the history.
+ *
+ * Design rationale + the alternatives rejected (carry-forward, archive-on-
+ * consume): decision-log `2026-06-07-핸드오프-세션단위-분리-자동정리`.
+ */
+declare const HANDOFF_DIR = "_handoff";
+declare const HANDOFF_ARCHIVE_DIR = "_archive";
+interface HandoffWriteResult {
+    readonly path: string;
+    readonly name: string;
+    readonly date: string;
+    readonly time: string;
+}
+/**
+ * Create a new, EMPTY-skeleton hand-off file and return its path for the agent
+ * to fill in (mirrors `/log`: the host creates the file safely, the agent writes
+ * the content). Atomic exclusive create; on a same-minute collision a numeric
+ * suffix is appended so a concurrent session's file is never overwritten.
+ */
+declare function createHandoffSkeleton(dataDir: string, opts?: {
+    readonly now?: Date;
+    readonly title?: string;
+}): Promise<HandoffWriteResult>;
+interface HandoffSummary {
+    readonly date: string;
+    readonly time: string;
+    /** Path relative to the data dir, e.g. `_handoff/2026-06-07_1604.md`. */
+    readonly relPath: string;
+    /** First `# ` heading, else the filename. RAW — the caller sanitizes. */
+    readonly title: string;
+    /** Hand-off `## 다음 작업` lines (via {@link extractNextUp}). RAW. */
+    readonly nextUp: readonly string[];
+}
+/**
+ * List the ACTIVE hand-offs (everything under `_handoff/` except `_archive/`),
+ * newest first. Returns up to `max` summaries with the count omitted beyond it,
+ * so a busy stretch of many small hand-offs stays a bounded pointer at session
+ * start. Multiple active hand-offs are NORMAL (concurrent sessions) — the caller
+ * surfaces them all, not as an exceptional state.
+ */
+declare function scanHandoffs(dataDir: string, opts?: {
+    readonly max?: number;
+}): Promise<{
+    active: HandoffSummary[];
+    omitted: number;
+}>;
+/**
+ * Sweep hand-offs older than `retentionDays` into `_handoff/_archive/`
+ * (deterministic, age-based — NOT an LLM step, so it cannot drift). Idempotent
+ * and concurrency-tolerant: a file already moved by a racing session is simply
+ * skipped. Git keeps the full history, so this is a working-tree tidy, not a
+ * destructive delete. Returns how many were archived.
+ */
+declare function pruneHandoffs(dataDir: string, opts: {
+    readonly now?: Date;
+    readonly retentionDays: number;
+}): Promise<{
+    archived: number;
+}>;
+
 /**
  * "What should I do today?" — a read-only synthesis over existing records
  * (worklog + decision-log + open `- [ ]` checkboxes), the P2 work-management
@@ -3848,9 +4013,15 @@ type index_d_CuratePayload = CuratePayload;
 type index_d_CuratePayloadValidation = CuratePayloadValidation;
 type index_d_CuratePreviewResult = CuratePreviewResult;
 type index_d_CurateResult = CurateResult;
+declare const index_d_DEFAULT_GAP_WINDOW_DAYS: typeof DEFAULT_GAP_WINDOW_DAYS;
 type index_d_EnsureHooksResult = EnsureHooksResult;
 type index_d_EnsureWorklogResult = EnsureWorklogResult;
 type index_d_GitPullResult = GitPullResult;
+declare const index_d_HANDOFF_ARCHIVE_DIR: typeof HANDOFF_ARCHIVE_DIR;
+declare const index_d_HANDOFF_DIR: typeof HANDOFF_DIR;
+type index_d_HandoffCreateResult = HandoffCreateResult;
+type index_d_HandoffSummary = HandoffSummary;
+type index_d_HandoffWriteResult = HandoffWriteResult;
 type index_d_NewDecisionResult = NewDecisionResult;
 declare const index_d_OWNERSHIP_SCHEMA: typeof OWNERSHIP_SCHEMA;
 type index_d_OpenDecision = OpenDecision;
@@ -3883,6 +4054,7 @@ declare const index_d_agendaCommand: typeof agendaCommand;
 declare const index_d_aggregateHandoff: typeof aggregateHandoff;
 declare const index_d_applyGlobalSetup: typeof applyGlobalSetup;
 declare const index_d_argvToSlash: typeof argvToSlash;
+declare const index_d_autoReindexMemory: typeof autoReindexMemory;
 declare const index_d_buildInstallCommand: typeof buildInstallCommand;
 declare const index_d_buildOwnershipManifest: typeof buildOwnershipManifest;
 declare const index_d_buildRegistry: typeof buildRegistry;
@@ -3895,6 +4067,7 @@ declare const index_d_compareSemver: typeof compareSemver;
 declare const index_d_computeCurateFingerprint: typeof computeCurateFingerprint;
 declare const index_d_countUncommitted: typeof countUncommitted;
 declare const index_d_createAmbientRecaller: typeof createAmbientRecaller;
+declare const index_d_createHandoffSkeleton: typeof createHandoffSkeleton;
 declare const index_d_createRitualRegistry: typeof createRitualRegistry;
 declare const index_d_curateCommand: typeof curateCommand;
 declare const index_d_decisionCommand: typeof decisionCommand;
@@ -3904,10 +4077,12 @@ declare const index_d_ensureVortexHooks: typeof ensureVortexHooks;
 declare const index_d_ensureWorklogEntry: typeof ensureWorklogEntry;
 declare const index_d_extractNextUp: typeof extractNextUp;
 declare const index_d_extractOpenTasks: typeof extractOpenTasks;
+declare const index_d_gapWindowSinceArg: typeof gapWindowSinceArg;
 declare const index_d_globalMemoryPath: typeof globalMemoryPath;
 declare const index_d_globalSettingsHasHook: typeof globalSettingsHasHook;
 declare const index_d_globalSettingsPath: typeof globalSettingsPath;
 declare const index_d_globalStatePath: typeof globalStatePath;
+declare const index_d_handoffCommand: typeof handoffCommand;
 declare const index_d_inspectGlobalSetup: typeof inspectGlobalSetup;
 declare const index_d_inspectOwnership: typeof inspectOwnership;
 declare const index_d_isInstanceRoot: typeof isInstanceRoot;
@@ -3917,6 +4092,7 @@ declare const index_d_logCommand: typeof logCommand;
 declare const index_d_ownershipManifestPath: typeof ownershipManifestPath;
 declare const index_d_parseAdoptArgs: typeof parseAdoptArgs;
 declare const index_d_parseSettings: typeof parseSettings;
+declare const index_d_pruneHandoffs: typeof pruneHandoffs;
 declare const index_d_queryNpmLatest: typeof queryNpmLatest;
 declare const index_d_readGlobalInstancePointer: typeof readGlobalInstancePointer;
 declare const index_d_readInstalledBaseVersion: typeof readInstalledBaseVersion;
@@ -3934,6 +4110,7 @@ declare const index_d_runCurateDecline: typeof runCurateDecline;
 declare const index_d_runCuratePreview: typeof runCuratePreview;
 declare const index_d_runTemplatesUpdate: typeof runTemplatesUpdate;
 declare const index_d_runVortexCli: typeof runVortexCli;
+declare const index_d_scanHandoffs: typeof scanHandoffs;
 declare const index_d_serializeSettings: typeof serializeSettings;
 declare const index_d_sessionStartCommand: typeof sessionStartCommand;
 declare const index_d_templateDestRelPath: typeof templateDestRelPath;
@@ -3942,7 +4119,7 @@ declare const index_d_validateCuratePayload: typeof validateCuratePayload;
 declare const index_d_vortexCommand: typeof vortexCommand;
 declare const index_d_writeOwnershipManifest: typeof writeOwnershipManifest;
 declare namespace index_d {
-  export { type index_d_AgendaReport as AgendaReport, type index_d_AmbientRecallFactoryOptions as AmbientRecallFactoryOptions, type index_d_CatchUpOptions as CatchUpOptions, type index_d_CatchUpResult as CatchUpResult, type index_d_ClaudeSettings as ClaudeSettings, type index_d_CliIo as CliIo, type index_d_CollectAgendaOptions as CollectAgendaOptions, type index_d_CurateAcceptResult as CurateAcceptResult, type index_d_CurateActionKind as CurateActionKind, type index_d_CurateAnyProposal as CurateAnyProposal, type index_d_CurateCandidate as CurateCandidate, type index_d_CurateCandidatesResult as CurateCandidatesResult, type index_d_CurateDeclineResult as CurateDeclineResult, type index_d_CurateOptions as CurateOptions, type index_d_CuratePayload as CuratePayload, type index_d_CuratePayloadValidation as CuratePayloadValidation, type index_d_CuratePreviewResult as CuratePreviewResult, type index_d_CurateResult as CurateResult, type index_d_EnsureHooksResult as EnsureHooksResult, type index_d_EnsureWorklogResult as EnsureWorklogResult, type index_d_GitPullResult as GitPullResult, type index_d_NewDecisionResult as NewDecisionResult, index_d_OWNERSHIP_SCHEMA as OWNERSHIP_SCHEMA, type index_d_OpenDecision as OpenDecision, type index_d_OpenTask as OpenTask, type index_d_OwnershipDiagnosis as OwnershipDiagnosis, type index_d_OwnershipEntry as OwnershipEntry, type index_d_OwnershipManifest as OwnershipManifest, type index_d_RecallOptions as RecallOptions, type index_d_RecentWorklog as RecentWorklog, type index_d_ReindexResult as ReindexResult, type index_d_RitualRegistryOptions as RitualRegistryOptions, index_d_SESSION_END_COMMAND as SESSION_END_COMMAND, index_d_SESSION_START_COMMAND as SESSION_START_COMMAND, type index_d_SessionStartHookReport as SessionStartHookReport, type index_d_SessionStartReport as SessionStartReport, type index_d_UpdateCheckResult as UpdateCheckResult, type index_d_UpdateFileAction as UpdateFileAction, type index_d_UpdateFileActionKind as UpdateFileActionKind, type index_d_VortexHelpResult as VortexHelpResult, type index_d_VortexInitResult as VortexInitResult, type index_d_VortexPlannedResult as VortexPlannedResult, type index_d_VortexResult as VortexResult, type index_d_VortexSyncResult as VortexSyncResult, type index_d_VortexSyncStep as VortexSyncStep, type index_d_VortexSyncStepId as VortexSyncStepId, type index_d_VortexSyncStepStatus as VortexSyncStepStatus, type index_d_VortexUpdateResult as VortexUpdateResult, type index_d_WorklogAppendResult as WorklogAppendResult, index_d_agendaCommand as agendaCommand, index_d_aggregateHandoff as aggregateHandoff, index_d_applyGlobalSetup as applyGlobalSetup, index_d_argvToSlash as argvToSlash, index_d_buildInstallCommand as buildInstallCommand, index_d_buildOwnershipManifest as buildOwnershipManifest, index_d_buildRegistry as buildRegistry, index_d_catchUpSessions as catchUpSessions, index_d_checkBaseUpdate as checkBaseUpdate, index_d_collectAgenda as collectAgenda, index_d_collectCarryover as collectCarryover, index_d_collectSessionStartReport as collectSessionStartReport, index_d_compareSemver as compareSemver, index_d_computeCurateFingerprint as computeCurateFingerprint, index_d_countUncommitted as countUncommitted, index_d_createAmbientRecaller as createAmbientRecaller, index_d_createRitualRegistry as createRitualRegistry, index_d_curateCommand as curateCommand, index_d_decisionCommand as decisionCommand, index_d_detectInterruptedGitOp as detectInterruptedGitOp, index_d_detectWorklogGaps as detectWorklogGaps, index_d_ensureVortexHooks as ensureVortexHooks, index_d_ensureWorklogEntry as ensureWorklogEntry, index_d_extractNextUp as extractNextUp, index_d_extractOpenTasks as extractOpenTasks, index_d_globalMemoryPath as globalMemoryPath, index_d_globalSettingsHasHook as globalSettingsHasHook, index_d_globalSettingsPath as globalSettingsPath, index_d_globalStatePath as globalStatePath, index_d_inspectGlobalSetup as inspectGlobalSetup, index_d_inspectOwnership as inspectOwnership, index_d_isInstanceRoot as isInstanceRoot, index_d_isNewer as isNewer, index_d_isStableUpdate as isStableUpdate, index_d_logCommand as logCommand, index_d_ownershipManifestPath as ownershipManifestPath, index_d_parseAdoptArgs as parseAdoptArgs, index_d_parseSettings as parseSettings, index_d_queryNpmLatest as queryNpmLatest, index_d_readGlobalInstancePointer as readGlobalInstancePointer, index_d_readInstalledBaseVersion as readInstalledBaseVersion, index_d_recallCommand as recallCommand, index_d_recordGlobalSetupDecline as recordGlobalSetupDecline, index_d_reindexCommand as reindexCommand, index_d_renderAgenda as renderAgenda, index_d_renderGlobalBlock as renderGlobalBlock, index_d_renderSessionStartReport as renderSessionStartReport, index_d_repairOwnershipManifest as repairOwnershipManifest, index_d_resolveRepoRoot as resolveRepoRoot, index_d_runCurateAccept as runCurateAccept, index_d_runCurateCandidates as runCurateCandidates, index_d_runCurateDecline as runCurateDecline, index_d_runCuratePreview as runCuratePreview, index_d_runTemplatesUpdate as runTemplatesUpdate, index_d_runVortexCli as runVortexCli, index_d_serializeSettings as serializeSettings, index_d_sessionStartCommand as sessionStartCommand, index_d_templateDestRelPath as templateDestRelPath, index_d_upsertGlobalBlock as upsertGlobalBlock, index_d_validateCuratePayload as validateCuratePayload, index_d_vortexCommand as vortexCommand, index_d_writeOwnershipManifest as writeOwnershipManifest };
+  export { type index_d_AgendaReport as AgendaReport, type index_d_AmbientRecallFactoryOptions as AmbientRecallFactoryOptions, type index_d_CatchUpOptions as CatchUpOptions, type index_d_CatchUpResult as CatchUpResult, type index_d_ClaudeSettings as ClaudeSettings, type index_d_CliIo as CliIo, type index_d_CollectAgendaOptions as CollectAgendaOptions, type index_d_CurateAcceptResult as CurateAcceptResult, type index_d_CurateActionKind as CurateActionKind, type index_d_CurateAnyProposal as CurateAnyProposal, type index_d_CurateCandidate as CurateCandidate, type index_d_CurateCandidatesResult as CurateCandidatesResult, type index_d_CurateDeclineResult as CurateDeclineResult, type index_d_CurateOptions as CurateOptions, type index_d_CuratePayload as CuratePayload, type index_d_CuratePayloadValidation as CuratePayloadValidation, type index_d_CuratePreviewResult as CuratePreviewResult, type index_d_CurateResult as CurateResult, index_d_DEFAULT_GAP_WINDOW_DAYS as DEFAULT_GAP_WINDOW_DAYS, type index_d_EnsureHooksResult as EnsureHooksResult, type index_d_EnsureWorklogResult as EnsureWorklogResult, type index_d_GitPullResult as GitPullResult, index_d_HANDOFF_ARCHIVE_DIR as HANDOFF_ARCHIVE_DIR, index_d_HANDOFF_DIR as HANDOFF_DIR, type index_d_HandoffCreateResult as HandoffCreateResult, type index_d_HandoffSummary as HandoffSummary, type index_d_HandoffWriteResult as HandoffWriteResult, type index_d_NewDecisionResult as NewDecisionResult, index_d_OWNERSHIP_SCHEMA as OWNERSHIP_SCHEMA, type index_d_OpenDecision as OpenDecision, type index_d_OpenTask as OpenTask, type index_d_OwnershipDiagnosis as OwnershipDiagnosis, type index_d_OwnershipEntry as OwnershipEntry, type index_d_OwnershipManifest as OwnershipManifest, type index_d_RecallOptions as RecallOptions, type index_d_RecentWorklog as RecentWorklog, type index_d_ReindexResult as ReindexResult, type index_d_RitualRegistryOptions as RitualRegistryOptions, index_d_SESSION_END_COMMAND as SESSION_END_COMMAND, index_d_SESSION_START_COMMAND as SESSION_START_COMMAND, type index_d_SessionStartHookReport as SessionStartHookReport, type index_d_SessionStartReport as SessionStartReport, type index_d_UpdateCheckResult as UpdateCheckResult, type index_d_UpdateFileAction as UpdateFileAction, type index_d_UpdateFileActionKind as UpdateFileActionKind, type index_d_VortexHelpResult as VortexHelpResult, type index_d_VortexInitResult as VortexInitResult, type index_d_VortexPlannedResult as VortexPlannedResult, type index_d_VortexResult as VortexResult, type index_d_VortexSyncResult as VortexSyncResult, type index_d_VortexSyncStep as VortexSyncStep, type index_d_VortexSyncStepId as VortexSyncStepId, type index_d_VortexSyncStepStatus as VortexSyncStepStatus, type index_d_VortexUpdateResult as VortexUpdateResult, type index_d_WorklogAppendResult as WorklogAppendResult, index_d_agendaCommand as agendaCommand, index_d_aggregateHandoff as aggregateHandoff, index_d_applyGlobalSetup as applyGlobalSetup, index_d_argvToSlash as argvToSlash, index_d_autoReindexMemory as autoReindexMemory, index_d_buildInstallCommand as buildInstallCommand, index_d_buildOwnershipManifest as buildOwnershipManifest, index_d_buildRegistry as buildRegistry, index_d_catchUpSessions as catchUpSessions, index_d_checkBaseUpdate as checkBaseUpdate, index_d_collectAgenda as collectAgenda, index_d_collectCarryover as collectCarryover, index_d_collectSessionStartReport as collectSessionStartReport, index_d_compareSemver as compareSemver, index_d_computeCurateFingerprint as computeCurateFingerprint, index_d_countUncommitted as countUncommitted, index_d_createAmbientRecaller as createAmbientRecaller, index_d_createHandoffSkeleton as createHandoffSkeleton, index_d_createRitualRegistry as createRitualRegistry, index_d_curateCommand as curateCommand, index_d_decisionCommand as decisionCommand, index_d_detectInterruptedGitOp as detectInterruptedGitOp, index_d_detectWorklogGaps as detectWorklogGaps, index_d_ensureVortexHooks as ensureVortexHooks, index_d_ensureWorklogEntry as ensureWorklogEntry, index_d_extractNextUp as extractNextUp, index_d_extractOpenTasks as extractOpenTasks, index_d_gapWindowSinceArg as gapWindowSinceArg, index_d_globalMemoryPath as globalMemoryPath, index_d_globalSettingsHasHook as globalSettingsHasHook, index_d_globalSettingsPath as globalSettingsPath, index_d_globalStatePath as globalStatePath, index_d_handoffCommand as handoffCommand, index_d_inspectGlobalSetup as inspectGlobalSetup, index_d_inspectOwnership as inspectOwnership, index_d_isInstanceRoot as isInstanceRoot, index_d_isNewer as isNewer, index_d_isStableUpdate as isStableUpdate, index_d_logCommand as logCommand, index_d_ownershipManifestPath as ownershipManifestPath, index_d_parseAdoptArgs as parseAdoptArgs, index_d_parseSettings as parseSettings, index_d_pruneHandoffs as pruneHandoffs, index_d_queryNpmLatest as queryNpmLatest, index_d_readGlobalInstancePointer as readGlobalInstancePointer, index_d_readInstalledBaseVersion as readInstalledBaseVersion, index_d_recallCommand as recallCommand, index_d_recordGlobalSetupDecline as recordGlobalSetupDecline, index_d_reindexCommand as reindexCommand, index_d_renderAgenda as renderAgenda, index_d_renderGlobalBlock as renderGlobalBlock, index_d_renderSessionStartReport as renderSessionStartReport, index_d_repairOwnershipManifest as repairOwnershipManifest, index_d_resolveRepoRoot as resolveRepoRoot, index_d_runCurateAccept as runCurateAccept, index_d_runCurateCandidates as runCurateCandidates, index_d_runCurateDecline as runCurateDecline, index_d_runCuratePreview as runCuratePreview, index_d_runTemplatesUpdate as runTemplatesUpdate, index_d_runVortexCli as runVortexCli, index_d_scanHandoffs as scanHandoffs, index_d_serializeSettings as serializeSettings, index_d_sessionStartCommand as sessionStartCommand, index_d_templateDestRelPath as templateDestRelPath, index_d_upsertGlobalBlock as upsertGlobalBlock, index_d_validateCuratePayload as validateCuratePayload, index_d_vortexCommand as vortexCommand, index_d_writeOwnershipManifest as writeOwnershipManifest };
 }
 
 export { index_d$9 as aiCodingPitfalls, index_d$d as core, index_d$a as dataLint, index_d$5 as decisionLog, index_d$4 as indexGenerator, index_d$2 as linkRewriter, index_d$b as memorySystem, index_d$1 as proactiveCurator, index_d$7 as reportGenerator, index_d$3 as runbooks, index_d as sessionRituals, index_d$c as slashCommands, index_d$8 as toolRules, index_d$6 as worklog };