@vortex-os/base 0.8.0 → 0.9.0

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;
 }
@@ -3096,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,
@@ -3141,6 +3174,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;
@@ -3318,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
@@ -3851,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;
@@ -3895,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;
@@ -3908,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;
@@ -3917,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;
@@ -3934,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;
@@ -3942,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_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, 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 };