@vortex-os/base 0.7.2 → 0.9.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

@@ -128,7 +128,7 @@ Each internal workspace is exposed as a top-level namespace on the package:
 | `runbooks` | `@vortex-os/runbooks` | Runbook store with `last_tested`-based stale detection |
 | `linkRewriter` | `@vortex-os/link-rewriter` | Wiki-link extract / resolve / check / rewrite |
 | `proactiveCurator` | `@vortex-os/proactive-curator` | Topic-aware proposal engine — in-session insight capture + hub auto-curation with 4-action active placement (`create-folder` / `create-file` / `append-section` / `update-file`). Asymmetric LLM gate for hub thresholds (3 weak / 5 strong). Decline durability + Claude Code `LLMJudge` adapter. |
-| `sessionRituals` | `@vortex-os/session-rituals` | Daily session-loop slash commands: `/session-start`, `/reindex`, `/decision`, `/log`, `/vortex`, `/curate`, `/recall` |
+| `sessionRituals` | `@vortex-os/session-rituals` | Daily session-loop slash commands: `/session-start`, `/log`, `/handoff`, `/decision`, `/agenda`, `/reindex`, `/resume`, `/vortex`, `/curate`, `/recall` |
 
 ## Capability add-ons
 

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-KIHTAUPX.js → catch-up-GDDKPZHJ.js}

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

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

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

package/dist/chunk-3L5DLEGP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../plugins/session-rituals/src/catch-up.ts"],"sourcesContent":["import type { ModuleContext } from \"@vortex-os/core\";\n// Type-only — erased at compile time, so importing it does NOT pull the\n// `@vortex-os/memory-extended` add-on (or its native sqlite/level deps) into\n// the module graph of consumers that only need the types. The runtime engine\n// is loaded lazily inside the function body via `await import(...)`.\nimport type { sessionArchive } from \"@vortex-os/memory-extended\";\n\n/**\n * Start-of-session \"catch-up\": fold conversation transcripts into the local\n * search archive without the user ever having to wrap up a session.\n *\n * Two sources, one pass:\n *  - **local (a)** — this machine's own transcripts that are not archived yet,\n *    read from every detected agent host's transcript store (Claude Code,\n *    Codex, Gemini) and scoped to the current project. Because all hosts are\n *    swept on every start, a single Claude Code session-start also folds in the\n *    Codex/Gemini sessions you ran in the same project, into one archive.\n *  - **pulled (b)** — transcripts created on another machine that arrived as\n *    normalized text via git sync. Their text is present but this machine's\n *    DB (local, derived, gitignored) has never indexed them.\n *\n * Text only — vectorization is deferred to recall/rebuild so session start\n * stays fast. The whole step is gated by `autoRecord.archive` at the call site\n * and is best-effort: callers should treat a thrown archive backend (e.g. the\n * native sqlite module not built) as \"skip\", never as a fatal start error.\n */\nexport interface CatchUpResult {\n  /** Local transcripts newly archived this run (source a). */\n  readonly ingestedLocal: number;\n  /** Normalized transcripts from another machine newly indexed (source b). */\n  readonly indexedPulled: number;\n  /** Per-session ingest errors (source a). */\n  readonly errors: number;\n}\n\nexport interface CatchUpOptions {\n  /** Restrict local ingest to one project's transcripts. Default: `ctx.repoRoot`. */\n  readonly cwd?: string;\n  /**\n   * Transcript adapters for local ingest. Default: all CLI hosts — Claude Code,\n   * Codex, and Gemini. Each adapter's `detect()` returns false when its host is\n   * absent, so registering all three is ~free on a machine that only uses one.\n   * (Claude Desktop is opt-in — it needs the `classic-level` dependency — so it\n   * is not in the default set; a caller can add it.) Tests inject fakes (or a\n   * sandbox `env.home`) so the scan never touches the real home directory.\n   */\n  readonly adapters?: sessionArchive.IngestParams[\"adapters\"];\n  /** Adapter environment override (e.g. a sandbox HOME). Tests use this. */\n  readonly env?: sessionArchive.IngestParams[\"env\"];\n}\n\nexport async function catchUpSessions(\n  ctx: ModuleContext,\n  opts?: CatchUpOptions,\n): Promise<CatchUpResult> {\n  // Lazy-load the optional add-on. Base ships without `memory-extended`; this\n  // import resolves only when the add-on is installed alongside it. The call\n  // site already gates this step on `autoRecord.archive` and treats a thrown\n  // backend as \"skip\", so a missing add-on surfaces as a normal load error\n  // the caller can catch.\n  const { sessionArchive } = await import(\"@vortex-os/memory-extended\");\n\n  const dataDir = ctx.dataDir;\n  const cwd = opts?.cwd ?? ctx.repoRoot;\n  const adapters = opts?.adapters ?? [\n    sessionArchive.claudeCodeAdapter,\n    sessionArchive.codexAdapter,\n    sessionArchive.geminiAdapter,\n  ];\n\n  // (a) Ingest this machine's not-yet-archived transcripts for the current\n  // project. Writes the normalized copy into the archive (which git syncs) and\n  // a local DB row. Text only — no vectorization here.\n  const ingestResult = await sessionArchive.ingest({ adapters, dataDir, cwd, env: opts?.env });\n\n  // (b) Index normalized transcripts that arrived from another machine via git\n  // pull — their text is on disk but this machine's DB has no row yet.\n  const store = new sessionArchive.SessionArchiveStore(dataDir);\n  let indexedPulled = 0;\n  try {\n    indexedPulled = store.reindexFromNormalized().indexed;\n  } finally {\n    store.close();\n  }\n\n  return {\n    ingestedLocal: ingestResult.sessionsIngested,\n    indexedPulled,\n    errors: ingestResult.errors.length,\n  };\n}\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,20 @@ 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;
 }
 /**
  * One environment label plus the signal that selects it. Rules are evaluated
@@ -896,11 +910,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 +946,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;
 }
@@ -3034,11 +3051,30 @@ interface SessionStartHookReport {
     readonly dataDir: string;
     readonly counts: Readonly<Record<string, number>>;
     readonly missing: readonly string[];
+    /**
+     * The single "most recent" worklog pointer — the representative of the latest
+     * day (the full set is in {@link recentWorklogs}). Null when there are none.
+     */
     readonly recentWorklog: RecentWorklog | null;
     /**
-     * Up to 3 short "next up" lines lifted from the MOST RECENT worklog's
-     * hand-off section (else its unchecked tasks), each capped — the
-     * "what you were about to do" pointer. Honest-empty when nothing is captured.
+     * EVERY worklog sharing the latest day (a day can hold several topic/session
+     * worklogs). Sorted by path; `recentWorklog` is its representative. The render
+     * lists them all when there is more than one, so a same-day worklog is never
+     * hidden behind another (it used to surface only the lexically-greatest file).
+     */
+    readonly recentWorklogs: readonly RecentWorklog[];
+    /**
+     * Same-day worklogs beyond the read cap that were NOT opened (0 normally) —
+     * so the rendered count stays honest on a pathological day. See
+     * {@link recentWorklogs}.
+     */
+    readonly recentWorklogsOmitted: number;
+    /**
+     * Short "next up" lines for the "what you were about to do" pointer —
+     * aggregated across ALL of the latest day's worklogs (round-robin, so each
+     * contributes its top step), from each one's hand-off section (else its
+     * unchecked tasks), each sanitized and capped. Honest-empty when nothing is
+     * captured.
      */
     readonly nextUp: readonly string[];
     /** Worklog dates (`YYYY-MM-DD`) present within the gap window — for backfill detection. */
@@ -3077,6 +3113,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,
@@ -3114,7 +3166,18 @@ declare function countUncommitted(porcelain: string, ignore?: (repoRelPosixPath:
  */
 declare function renderSessionStartReport(report: SessionStartHookReport, extras?: {
     readonly git?: GitPullResult | null;
+    /**
+     * Installed `@vortex-os/base` version (resolved locally, no network — from
+     * the shipped template index). Rendered as an always-present line so the
+     * running framework version is visible EVERY session, not only when an
+     * update happens to be available (the 📦/⬆️ lines below appear only then).
+     */
+    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;
@@ -3292,6 +3355,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
@@ -3360,7 +3511,9 @@ interface CollectAgendaOptions {
  * Korean: "next", "next up", "todo", "다음 작업", "다음 세션", "후속", "📋").
  * Returns the section's content lines (bullets de-marked, blanks dropped),
  * capped. Empty if no such section. Stops at the next heading of the
- * same-or-higher level.
+ * same-or-higher level. A CHECKED checkbox (`- [x]`) under the heading is
+ * completed work, not "next up", so it is skipped; an unchecked `- [ ]` and
+ * plain bullets/prose are kept.
  */
 declare function extractNextUp(body: string, max?: number): string[];
 /**
@@ -3368,19 +3521,30 @@ declare function extractNextUp(body: string, max?: number): string[];
  * worklog body. Checked items (`- [x]`) are ignored. Returns the trimmed label.
  */
 declare function extractOpenTasks(body: string): string[];
+/**
+ * Merge the "next up" pointers of SEVERAL worklogs (e.g. every entry sharing the
+ * latest day) into one bounded, fair list — so a day with multiple topic/session
+ * worklogs doesn't bury all but one hand-off (the old "pick the single
+ * lexically-greatest file" bug). Per worklog the hand-off section
+ * (`extractNextUp`) is preferred; with `fallbackToOpenTasks` (default on) a
+ * worklog lacking a `## Next`-style heading contributes its own unchecked tasks
+ * instead, so it still surfaces. The per-worklog queues are merged ROUND-ROBIN
+ * (one item from each, then the seconds, …) up to `maxTotal`, so every worklog
+ * gets its top step in before any gets a second. Order across worklogs follows
+ * the input order — callers pass a deterministic (path-sorted) group.
+ *
+ * `fallbackToOpenTasks: false` is for callers (like `/agenda`) that already list
+ * open tasks separately, to avoid showing the same task twice.
+ */
+declare function aggregateHandoff(bodies: readonly string[], maxTotal: number, opts?: {
+    readonly fallbackToOpenTasks?: boolean;
+}): string[];
 /**
  * Collect the agenda inputs. Read-only; tolerant of missing dirs (both stores
  * return empty rather than throwing), so a brand-new instance yields an empty —
  * but well-formed — report.
  */
 declare function collectAgenda(ctx: ModuleContext, opts?: CollectAgendaOptions): Promise<AgendaReport>;
-/**
- * Render the agenda as a compact markdown block. Branches on data state so the
- * output is sensible whether the instance is brand-new, quiet, or busy:
- *   - brand-new (no records)     → a short "getting started" nudge
- *   - records but nothing open   → "you're clear" + last activity
- *   - open tasks / decisions     → an actionable list
- */
 declare function renderAgenda(report: AgendaReport): string;
 
 /**
@@ -3812,6 +3976,11 @@ type index_d_CurateResult = CurateResult;
 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;
@@ -3841,6 +4010,7 @@ type index_d_VortexSyncStepStatus = VortexSyncStepStatus;
 type index_d_VortexUpdateResult = VortexUpdateResult;
 type index_d_WorklogAppendResult = WorklogAppendResult;
 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_buildInstallCommand: typeof buildInstallCommand;
@@ -3855,6 +4025,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;
@@ -3868,6 +4039,7 @@ 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;
@@ -3877,6 +4049,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;
@@ -3894,6 +4067,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;
@@ -3902,7 +4076,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_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, 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_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_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 };