@vpxa/aikit 0.1.207 → 0.1.209

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

@@ -461,6 +461,92 @@ interface CompactResult {
  */
 declare function compact(embedder: IEmbedder, options: CompactOptions): Promise<CompactResult>;
 //#endregion
+//#region packages/tools/src/replay.d.ts
+/**
+ * Replay — append-only audit trail of tool/CLI invocations.
+ *
+ * Captures tool name, arguments (redacted), duration, and result summary
+ * to `.aikit-state/replay.jsonl`. Used by `aikit replay` CLI, `aikit_replay` MCP tool,
+ * and the TUI log panel.
+ */
+interface ReplayEntry {
+  /** ISO timestamp */
+  ts: string;
+  /** Source: 'mcp' | 'cli' */
+  source: 'mcp' | 'cli';
+  /** Tool or command name */
+  tool: string;
+  /** Redacted input summary (first 2000 chars of JSON) */
+  input: string;
+  /** Duration in milliseconds */
+  durationMs: number;
+  /** Result status */
+  status: 'ok' | 'error';
+  /** Short result summary (first 2000 chars) */
+  output: string;
+  /** Correlation ID linking to middleware requestId */
+  traceId: string;
+  /** Original output size in characters before truncation */
+  outputChars: number;
+}
+interface ReplayOptions {
+  /** Max entries to return (default: 20) */
+  last?: number;
+  /** Filter by tool name */
+  tool?: string;
+  /** Filter by source */
+  source?: 'mcp' | 'cli';
+  /** Filter entries after this ISO timestamp */
+  since?: string;
+}
+/**
+ * Append a replay entry to the audit log.
+ * Creates the state directory if it doesn't exist.
+ */
+declare function replayAppend(entry: ReplayEntry): void;
+/**
+ * Read replay entries with optional filters.
+ */
+declare function replayList(opts?: ReplayOptions): ReplayEntry[];
+/**
+ * Trim the replay log to MAX_ENTRIES, keeping the most recent.
+ * Async to avoid blocking the event loop on large logs.
+ */
+declare function replayTrim(): Promise<number>;
+/**
+ * Clear the entire replay log.
+ */
+declare function replayClear(): void;
+/**
+ * Helper: create a replay entry from a tool invocation.
+ * Use as a wrapper around tool execution.
+ */
+declare function replayCapture(source: 'mcp' | 'cli', tool: string, input: unknown, fn: () => Promise<unknown>, traceId?: string): Promise<unknown>;
+//#endregion
+//#region packages/tools/src/compliance-scorer.d.ts
+interface ComplianceViolation {
+  rule: string;
+  ruleId: string;
+  tool: string;
+  timestamp: string;
+  suggestion: string;
+}
+interface ComplianceReport {
+  score: number;
+  violations: ComplianceViolation[];
+  totalCalls: number;
+  summary: string;
+}
+interface ComplianceRule {
+  id: string;
+  description: string;
+  check: (entry: ReplayEntry) => ComplianceViolation | null;
+}
+interface ComplianceScoreOptions {
+  lastN?: number;
+}
+declare function scoreCompliance(entries: ReplayEntry[], options?: ComplianceScoreOptions): ComplianceReport;
+//#endregion
 //#region packages/tools/src/compression/types.d.ts
 /**
  * Compression mode determines how aggressively output is compressed.
@@ -1821,68 +1907,6 @@ interface RenameResult {
 }
 declare function rename(options: RenameOptions): Promise<RenameResult>;
 //#endregion
-//#region packages/tools/src/replay.d.ts
-/**
- * Replay — append-only audit trail of tool/CLI invocations.
- *
- * Captures tool name, arguments (redacted), duration, and result summary
- * to `.aikit-state/replay.jsonl`. Used by `aikit replay` CLI, `aikit_replay` MCP tool,
- * and the TUI log panel.
- */
-interface ReplayEntry {
-  /** ISO timestamp */
-  ts: string;
-  /** Source: 'mcp' | 'cli' */
-  source: 'mcp' | 'cli';
-  /** Tool or command name */
-  tool: string;
-  /** Redacted input summary (first 2000 chars of JSON) */
-  input: string;
-  /** Duration in milliseconds */
-  durationMs: number;
-  /** Result status */
-  status: 'ok' | 'error';
-  /** Short result summary (first 2000 chars) */
-  output: string;
-  /** Correlation ID linking to middleware requestId */
-  traceId: string;
-  /** Original output size in characters before truncation */
-  outputChars: number;
-}
-interface ReplayOptions {
-  /** Max entries to return (default: 20) */
-  last?: number;
-  /** Filter by tool name */
-  tool?: string;
-  /** Filter by source */
-  source?: 'mcp' | 'cli';
-  /** Filter entries after this ISO timestamp */
-  since?: string;
-}
-/**
- * Append a replay entry to the audit log.
- * Creates the state directory if it doesn't exist.
- */
-declare function replayAppend(entry: ReplayEntry): void;
-/**
- * Read replay entries with optional filters.
- */
-declare function replayList(opts?: ReplayOptions): ReplayEntry[];
-/**
- * Trim the replay log to MAX_ENTRIES, keeping the most recent.
- * Async to avoid blocking the event loop on large logs.
- */
-declare function replayTrim(): Promise<number>;
-/**
- * Clear the entire replay log.
- */
-declare function replayClear(): void;
-/**
- * Helper: create a replay entry from a tool invocation.
- * Use as a wrapper around tool execution.
- */
-declare function replayCapture(source: 'mcp' | 'cli', tool: string, input: unknown, fn: () => Promise<unknown>, traceId?: string): Promise<unknown>;
-//#endregion
 //#region packages/tools/src/restore-points.d.ts
 interface RestorePoint {
   id: string;
@@ -1928,6 +1952,37 @@ interface SchemaValidateResult {
 }
 declare function schemaValidate(options: SchemaValidateOptions): SchemaValidateResult;
 //#endregion
+//#region packages/tools/src/search-response.d.ts
+interface SearchResponseItem {
+  sourcePath: string;
+  contentType: string;
+  score: number;
+  headingPath?: string;
+  startLine?: number;
+  endLine?: number;
+  origin?: string;
+  category?: string;
+  tags?: string[];
+}
+interface SearchResponseData {
+  results: SearchResponseItem[];
+  totalResults: number;
+  searchMode: string;
+  query: string;
+}
+interface SearchSuccessResponseOptions {
+  text: string;
+  query: string;
+  searchMode: string;
+  limit: number;
+  results: SearchResponseItem[];
+  durationMs: number;
+  truncated?: boolean;
+  caveats?: string[];
+}
+declare function createSearchSuccessResponse(opts: SearchSuccessResponseOptions): AikitResponse<SearchResponseData>;
+declare function createSearchErrorResponse(message: string, durationMs: number): AikitResponse<never>;
+//#endregion
 //#region packages/tools/src/stash.d.ts
 interface StashEntry {
   key: string;
@@ -1989,6 +2044,26 @@ interface SessionDigestDeps {
 declare function sessionDigest(options?: SessionDigestOptions, deps?: SessionDigestDeps): SessionDigestResult;
 declare function sessionDigestSampling(options: SessionDigestOptions, samplingFn: (prompt: string, systemPrompt: string, maxTokens: number) => Promise<string>, deps?: SessionDigestDeps): Promise<SessionDigestResult>;
 //#endregion
+//#region packages/tools/src/skill-matcher.d.ts
+interface SkillTriggerExamples {
+  positive: string[];
+  negative: string[];
+}
+interface SkillTriggerMeta {
+  name: string;
+  triggerKeywords: string[];
+  triggerPatterns: string[];
+  triggerExamples: SkillTriggerExamples;
+  priority: number;
+}
+interface SkillMatch {
+  name: string;
+  score: number;
+  matchedKeywords: string[];
+  matchedPatterns: string[];
+}
+declare function matchSkills(query: string, skills: SkillTriggerMeta[]): SkillMatch[];
+//#endregion
 //#region packages/tools/src/stratum-card.d.ts
 interface StratumCardOptions {
   files: string[];
@@ -2382,4 +2457,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 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 PruneOptions, type PruneResult, 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, formatBytes, formatChangelog, getRegisteredRules, getWorkset, gitAvailable, gitCommitToRef, gitContext, gitExec, graphAugmentSearch, graphQuery, guide, headTailTruncate, health, httpRequest, laneCreate, laneDiff, laneDiscard, laneList, laneMerge, laneStatus, listActiveLeases, listRestorePoints, listWorksets, markPruneRun, measure, okResponse, onboard, paragraphTruncate, parseBiome, parseGitStatus, parseOutput, parseSearchResults, parseTsc, parseVitest, processList, processLogs, processStart, processStatus, processStop, processStopAll, prune, 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, shouldRunStartupPrune, 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 ComplianceReport, type ComplianceRule, type ComplianceScoreOptions, type ComplianceViolation, 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 PruneOptions, type PruneResult, 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 SearchResponseData, type SearchResponseItem, type SearchSuccessResponseOptions, type SessionDigestOptions, type SessionDigestResult, type SkillMatch, type SkillTriggerExamples, type SkillTriggerMeta, 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, createSearchErrorResponse, createSearchSuccessResponse, dataTransform, delegate, delegateListModels, deleteWorkset, detectOutputTool, diffParse, digest, dogfoodLog, encode, ensureLegacyStashImported, envInfo, errorResponse, escapeRegExp, estimateTokens, evaluate, evidenceMap, fileSummary, find, findDeadSymbols, findExamples, forgeClassify, forgeGround, formatBytes, formatChangelog, getRegisteredRules, getWorkset, gitAvailable, gitCommitToRef, gitContext, gitExec, graphAugmentSearch, graphQuery, guide, headTailTruncate, health, httpRequest, laneCreate, laneDiff, laneDiscard, laneList, laneMerge, laneStatus, listActiveLeases, listRestorePoints, listWorksets, markPruneRun, matchSkills, measure, okResponse, onboard, paragraphTruncate, parseBiome, parseGitStatus, parseOutput, parseSearchResults, parseTsc, parseVitest, processList, processLogs, processStart, processStatus, processStop, processStopAll, prune, 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, scoreCompliance, scoreLine, scoreLines, segment, sessionDigest, sessionDigestSampling, shannonEntropy, shouldRunStartupPrune, slugForRef, stashClear, stashDelete, stashGet, stashList, stashSet, stratumCard, summarizeCheckResult, symbol, testRun, timeUtils, trace, truncateToTokenBudget, watchList, watchStart, watchStop, webFetch, webSearch };