@vpxa/aikit 0.1.174 → 0.1.176

package/packages/tools/dist/index.d.ts

@@ -267,42 +267,67 @@ interface Checkpoint {
   label: string;
   createdAt: string;
   data: Record<string, unknown>;
-  files?: string[];
   notes?: string;
-  gitSha?: string;
 }
-declare function checkpointSave(label: string, data: Record<string, unknown>, options?: {
-  files?: string[];
+interface CheckpointSummary {
+  id: string;
+  label: string;
+  createdAt: string;
+  notes?: string;
+}
+interface CheckpointStore {
+  checkpointSave(id: string, label: string, data: string, notes?: string): void;
+  checkpointLoad(id: string): {
+    id: string;
+    label: string;
+    data: string;
+    notes?: string;
+    createdAt: string;
+  } | undefined;
+  checkpointList(label?: string, limit?: number): CheckpointSummary[];
+  checkpointLatest(label?: string): {
+    id: string;
+    label: string;
+    data: string;
+    notes?: string;
+    createdAt: string;
+  } | undefined;
+  checkpointDelete(id: string): boolean;
+  checkpointDiff(fromId: string, toId: string): {
+    from: string;
+    to: string;
+  } | undefined;
+  checkpointHistory(label?: string, limit?: number): CheckpointSummary[];
+  checkpointGc(keepLast?: number, maxAgeDays?: number): number;
+}
+interface LegacyCheckpointOptions {
+  cwd?: string;
+  stateDir?: string;
+}
+declare function checkpointSave(stateStore: CheckpointStore, label: string, data: Record<string, unknown>, options?: {
   notes?: string;
   cwd?: string;
 }): Checkpoint;
-declare function checkpointLoad(id: string, cwd?: string): Checkpoint | undefined;
-declare function checkpointList(cwd?: string): Checkpoint[];
-declare function checkpointLatest(cwd?: string): Checkpoint | undefined;
-/**
- * Diff two checkpoints by ID — shows added/removed/modified keys in data.
- */
-declare function checkpointDiff(fromId: string, toId: string, cwd?: string): {
+declare function checkpointLoad(stateStore: CheckpointStore, id: string, options?: LegacyCheckpointOptions): Checkpoint | undefined;
+declare function checkpointList(stateStore: CheckpointStore, options?: LegacyCheckpointOptions & {
+  label?: string;
+  limit?: number;
+}): CheckpointSummary[];
+declare function checkpointLatest(stateStore: CheckpointStore, options?: LegacyCheckpointOptions & {
+  label?: string;
+}): Checkpoint | undefined;
+declare function checkpointDiff(stateStore: CheckpointStore, fromId: string, toId: string, options?: LegacyCheckpointOptions): {
   fromId: string;
   toId: string;
   added: string[];
   removed: string[];
   modified: string[];
 } | undefined;
-/**
- * List history of a checkpoint label — git log of that ref's commits.
- * Falls back to filesystem scan if git unavailable.
- */
-declare function checkpointHistory(label: string, options?: {
+declare function checkpointHistory(stateStore: CheckpointStore, label: string, options?: {
   cwd?: string;
   limit?: number;
-}): Array<{
-  sha?: string;
-  id: string;
-  createdAt: string;
-  label: string;
-}>;
-declare function checkpointGC(options?: {
+}): CheckpointSummary[];
+declare function checkpointGC(stateStore: CheckpointStore, options?: {
   label?: string;
   keepLast?: number;
   maxAgeDays?: number;
@@ -1873,11 +1898,27 @@ interface StashEntry {
   type: string;
   storedAt: string;
 }
-declare function stashSet(key: string, value: unknown, cwd?: string): StashEntry;
-declare function stashGet(key: string, cwd?: string): StashEntry | undefined;
-declare function stashList(cwd?: string): StashEntry[];
-declare function stashDelete(key: string, cwd?: string): boolean;
-declare function stashClear(cwd?: string): number;
+interface StashStore {
+  stashGet(key: string): string | undefined;
+  stashSet(key: string, value: string): void;
+  stashList(): Array<{
+    key: string;
+    value: string;
+    updatedAt: string;
+  }>;
+  stashDelete(key: string): boolean;
+  stashClear(): void;
+}
+interface LegacyStashOptions {
+  cwd?: string;
+  stateDir?: string;
+}
+declare function ensureLegacyStashImported(stateStore: StashStore, options?: LegacyStashOptions): void;
+declare function stashSet(stateStore: StashStore, key: string, value: unknown, cwd?: string): StashEntry;
+declare function stashGet(stateStore: StashStore, key: string, cwd?: string): StashEntry | undefined;
+declare function stashList(stateStore: StashStore, cwd?: string): StashEntry[];
+declare function stashDelete(stateStore: StashStore, key: string, cwd?: string): boolean;
+declare function stashClear(stateStore: StashStore, cwd?: string): number;
 //#endregion
 //#region packages/tools/src/session-digest.d.ts
 interface SessionDigestOptions {
@@ -1903,8 +1944,9 @@ interface SessionDigestResult {
 interface SessionDigestDeps {
   replayEntries?: ReplayEntry[];
   stashEntries?: StashEntry[];
-  checkpoints?: Checkpoint[];
+  checkpoints?: CheckpointSummary[];
   persistEntry?: (key: string, value: unknown) => StashEntry;
+  stateStore?: CheckpointStore & StashStore;
   now?: Date;
 }
 declare function sessionDigest(options?: SessionDigestOptions, deps?: SessionDigestDeps): SessionDigestResult;
@@ -2303,4 +2345,4 @@ declare function addToWorkset(name: string, files: string[], cwd?: string): Work
  */
 declare function removeFromWorkset(name: string, files: string[], cwd?: string): Workset | null;
 //#endregion
-export { type AikitNextHint, type AikitResponse, type AikitResponseMeta, type AikitToolError, type AikitToolErrorCode, type AuditCheck, type AuditData, type AuditOptions, type AuditRecommendation, type ChangelogEntry, type ChangelogFormat, type ChangelogOptions, type ChangelogResult, type CheckOptions, type CheckResult, type CheckSummaryResult, type Checkpoint, type ClassifyTrigger, type CodemodChange, type CodemodOptions, type CodemodResult, type CodemodRule, type CompactOptions, type CompactResult, type CompressOutputOptions, type CompressionContext, type CompressionMode, type CompressionResult, type CompressionRule, type ConstraintRef, type DeadSymbol, type DeadSymbolOptions, type DeadSymbolResult, type DelegateOptions, type DelegateResult, type DiffChange, type DiffFile, type DiffHunk, type DiffParseOptions, type DigestFieldEntry, type DigestOptions, type DigestResult, type DigestSource, type DogfoodLogEntry, type DogfoodLogGroupedEntry, type DogfoodLogOptions, type DogfoodLogResult, type EncodeOperation, type EncodeOptions, type EncodeResult, type EnvInfoOptions, type EnvInfoResult, type EvalOptions, type EvalResult, type EvidenceEntry, type EvidenceMapAction, type EvidenceMapResult, type EvidenceMapState, type EvidenceStatus, type Example, FileCache, type FileCacheEntry, type FileCacheStats, type FileMetrics, type FileSummaryOptions, type FileSummaryResult, type FindExamplesOptions, type FindExamplesResult, type FindOptions, type FindResult, type FindResults, type ForgeClassifyCeremony, type ForgeClassifyOptions, type ForgeClassifyResult, type ForgeGroundOptions, type ForgeGroundResult, type ForgeTier, GIT_REF_SLUG_PATTERN, type GateConfig, type GateDecision, type GateResult, type GitContextOptions, type GitContextResult, type GraphAugmentOptions, type GraphAugmentedResult, type GraphQueryOptions, type GraphQueryResult, type GuideRecommendation, type GuideResult, type HealthCheck, type HealthResult, type HotspotEntry, type HttpMethod, type HttpRequestOptions, type HttpRequestResult, type LaneDiffEntry, type LaneDiffResult, type LaneMergeResult, type LaneMeta, type Lease, type LeaseConflict, type ManagedProcess, type MeasureOptions, type MeasureResult, type OnboardMode, type OnboardOptions, type OnboardResult, type OnboardStepResult, type ParsedError, type ParsedGitStatus, type ParsedOutput, type ParsedTestResult, type ParsedTestSummary, type QueueItem, type QueueState, type RegexTestOptions, type RegexTestResult, type RenameChange, type RenameOptions, type RenameResult, type ReplayEntry, type ReplayOptions, type RestorePoint, type SafetyGate, type SafetyGateResult, type SchemaValidateOptions, type SchemaValidateResult, type ScopeMapEntry, type ScopeMapOptions, type ScopeMapResult, type SessionDigestOptions, type SessionDigestResult, type StashEntry, type StratumCard, type StratumCardOptions, type StratumCardResult, type SymbolGraphContext, type SymbolInfo, type SymbolOptions, type TestRunOptions, type TestRunResult, type TimeOptions, type TimeResult, type TimeoutAction, type TraceNode, type TraceOptions, type TraceResult, type TransformOptions, type TransformResult, type TypedUnknownSeed, type UnknownType, type ValidationError, type WatchEvent, type WatchHandle, type WatchOptions, type WebFetchMode, type WebFetchOptions, type WebFetchResult, type WebSearchOptions, type WebSearchResult, type WebSearchResultItem, type Workset, acquireLease, addToWorkset, analyzeFile, audit, autoClaimTestFailures, bookendReorder, bpeSurprise, changelog, check, checkpointDiff, checkpointGC, checkpointHistory, checkpointLatest, checkpointList, checkpointLoad, checkpointSave, classifyExitCode, codemod, compact, compressOutput, compressTerminalOutput, cosineSimilarity, createRestorePoint, dataTransform, delegate, delegateListModels, deleteWorkset, detectOutputTool, diffParse, digest, dogfoodLog, encode, envInfo, errorResponse, escapeRegExp, estimateTokens, evaluate, evidenceMap, fileSummary, find, findDeadSymbols, findExamples, forgeClassify, forgeGround, formatChangelog, getRegisteredRules, getWorkset, gitAvailable, gitCommitToRef, gitContext, gitExec, graphAugmentSearch, graphQuery, guide, headTailTruncate, health, httpRequest, laneCreate, laneDiff, laneDiscard, laneList, laneMerge, laneStatus, listActiveLeases, listRestorePoints, listWorksets, measure, okResponse, onboard, paragraphTruncate, parseBiome, parseGitStatus, parseOutput, parseSearchResults, parseTsc, parseVitest, processList, processLogs, processStart, processStatus, processStop, processStopAll, queueClear, queueCreate, queueDag, queueDelete, queueDone, queueFail, queueGet, queueList, queueNext, queuePush, regexTest, registerRule, registerRules, releaseLease, removeFromWorkset, rename, replayAppend, replayCapture, replayClear, replayList, replayTrim, resetGitCache, resolvePath, restoreFromPoint, saveWorkset, schemaValidate, scopeMap, scoreLine, scoreLines, segment, sessionDigest, sessionDigestSampling, shannonEntropy, slugForRef, stashClear, stashDelete, stashGet, stashList, stashSet, stratumCard, summarizeCheckResult, symbol, testRun, timeUtils, trace, truncateToTokenBudget, watchList, watchStart, watchStop, webFetch, webSearch };
+export { type AikitNextHint, type AikitResponse, type AikitResponseMeta, type AikitToolError, type AikitToolErrorCode, type AuditCheck, type AuditData, type AuditOptions, type AuditRecommendation, type ChangelogEntry, type ChangelogFormat, type ChangelogOptions, type ChangelogResult, type CheckOptions, type CheckResult, type CheckSummaryResult, type Checkpoint, type CheckpointSummary, type ClassifyTrigger, type CodemodChange, type CodemodOptions, type CodemodResult, type CodemodRule, type CompactOptions, type CompactResult, type CompressOutputOptions, type CompressionContext, type CompressionMode, type CompressionResult, type CompressionRule, type ConstraintRef, type DeadSymbol, type DeadSymbolOptions, type DeadSymbolResult, type DelegateOptions, type DelegateResult, type DiffChange, type DiffFile, type DiffHunk, type DiffParseOptions, type DigestFieldEntry, type DigestOptions, type DigestResult, type DigestSource, type DogfoodLogEntry, type DogfoodLogGroupedEntry, type DogfoodLogOptions, type DogfoodLogResult, type EncodeOperation, type EncodeOptions, type EncodeResult, type EnvInfoOptions, type EnvInfoResult, type EvalOptions, type EvalResult, type EvidenceEntry, type EvidenceMapAction, type EvidenceMapResult, type EvidenceMapState, type EvidenceStatus, type Example, FileCache, type FileCacheEntry, type FileCacheStats, type FileMetrics, type FileSummaryOptions, type FileSummaryResult, type FindExamplesOptions, type FindExamplesResult, type FindOptions, type FindResult, type FindResults, type ForgeClassifyCeremony, type ForgeClassifyOptions, type ForgeClassifyResult, type ForgeGroundOptions, type ForgeGroundResult, type ForgeTier, GIT_REF_SLUG_PATTERN, type GateConfig, type GateDecision, type GateResult, type GitContextOptions, type GitContextResult, type GraphAugmentOptions, type GraphAugmentedResult, type GraphQueryOptions, type GraphQueryResult, type GuideRecommendation, type GuideResult, type HealthCheck, type HealthResult, type HotspotEntry, type HttpMethod, type HttpRequestOptions, type HttpRequestResult, type LaneDiffEntry, type LaneDiffResult, type LaneMergeResult, type LaneMeta, type Lease, type LeaseConflict, type LegacyStashOptions, type ManagedProcess, type MeasureOptions, type MeasureResult, type OnboardMode, type OnboardOptions, type OnboardResult, type OnboardStepResult, type ParsedError, type ParsedGitStatus, type ParsedOutput, type ParsedTestResult, type ParsedTestSummary, type QueueItem, type QueueState, type RegexTestOptions, type RegexTestResult, type RenameChange, type RenameOptions, type RenameResult, type ReplayEntry, type ReplayOptions, type RestorePoint, type SafetyGate, type SafetyGateResult, type SchemaValidateOptions, type SchemaValidateResult, type ScopeMapEntry, type ScopeMapOptions, type ScopeMapResult, type SessionDigestOptions, type SessionDigestResult, type StashEntry, type StashStore, type StratumCard, type StratumCardOptions, type StratumCardResult, type SymbolGraphContext, type SymbolInfo, type SymbolOptions, type TestRunOptions, type TestRunResult, type TimeOptions, type TimeResult, type TimeoutAction, type TraceNode, type TraceOptions, type TraceResult, type TransformOptions, type TransformResult, type TypedUnknownSeed, type UnknownType, type ValidationError, type WatchEvent, type WatchHandle, type WatchOptions, type WebFetchMode, type WebFetchOptions, type WebFetchResult, type WebSearchOptions, type WebSearchResult, type WebSearchResultItem, type Workset, acquireLease, addToWorkset, analyzeFile, audit, autoClaimTestFailures, bookendReorder, bpeSurprise, changelog, check, checkpointDiff, checkpointGC, checkpointHistory, checkpointLatest, checkpointList, checkpointLoad, checkpointSave, classifyExitCode, codemod, compact, compressOutput, compressTerminalOutput, cosineSimilarity, createRestorePoint, dataTransform, delegate, delegateListModels, deleteWorkset, detectOutputTool, diffParse, digest, dogfoodLog, encode, ensureLegacyStashImported, envInfo, errorResponse, escapeRegExp, estimateTokens, evaluate, evidenceMap, fileSummary, find, findDeadSymbols, findExamples, forgeClassify, forgeGround, formatChangelog, getRegisteredRules, getWorkset, gitAvailable, gitCommitToRef, gitContext, gitExec, graphAugmentSearch, graphQuery, guide, headTailTruncate, health, httpRequest, laneCreate, laneDiff, laneDiscard, laneList, laneMerge, laneStatus, listActiveLeases, listRestorePoints, listWorksets, measure, okResponse, onboard, paragraphTruncate, parseBiome, parseGitStatus, parseOutput, parseSearchResults, parseTsc, parseVitest, processList, processLogs, processStart, processStatus, processStop, processStopAll, queueClear, queueCreate, queueDag, queueDelete, queueDone, queueFail, queueGet, queueList, queueNext, queuePush, regexTest, registerRule, registerRules, releaseLease, removeFromWorkset, rename, replayAppend, replayCapture, replayClear, replayList, replayTrim, resetGitCache, resolvePath, restoreFromPoint, saveWorkset, schemaValidate, scopeMap, scoreLine, scoreLines, segment, sessionDigest, sessionDigestSampling, shannonEntropy, slugForRef, stashClear, stashDelete, stashGet, stashList, stashSet, stratumCard, summarizeCheckResult, symbol, testRun, timeUtils, trace, truncateToTokenBudget, watchList, watchStart, watchStop, webFetch, webSearch };