@vpxa/aikit 0.1.379 → 0.1.381

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

@@ -544,6 +544,8 @@ interface ReplayOptions {
   source?: 'mcp' | 'cli';
   /** Filter entries after this ISO timestamp */
   since?: string;
+  /** Approximate token limit for output. When set, entries are condensed to fit. */
+  maxTokens?: number;
 }
 /**
  * Append a replay entry to the audit log.
@@ -1082,6 +1084,11 @@ interface DigestResult {
   totalOriginalChars: number;
   totalCompressedChars: number;
   ratio: number;
+  /** Input token/char statistics for LLM budget decisions */
+  inputStats?: {
+    /** Total input characters across all sources */totalChars: number; /** Total estimated input tokens */
+    totalTokens: number;
+  };
 }
 /**
  * Compress multiple text sources into a single digest.
@@ -1436,6 +1443,10 @@ interface FileSummaryToolCard {
   riskTier: 'low' | 'medium' | 'high';
   tokenEstimate: number;
   originalTokenEstimate: number;
+  /** Optional ref ID for content recovery */
+  ref?: string;
+  /** Freshness timestamp (ISO) of last file modification */
+  freshness?: string;
 }
 interface FileSummaryToolResult {
   /** Card results when files were provided */
@@ -1444,6 +1455,8 @@ interface FileSummaryToolResult {
   text?: string;
   /** Reusable cache reference */
   ref?: string;
+  /** Freshness timestamp (ISO) of last file modification */
+  freshness?: string;
   /** Original size in chars (text/ref mode) */
   originalChars?: number;
   /** Compressed size in chars (text/ref mode) */
@@ -1605,6 +1618,8 @@ interface ScopeMapEntry {
   estimatedTokens: number;
   /** Relevance score (0-1) */
   relevance: number;
+  /** Confidence in relevance estimate (0-1) */
+  confidence?: number;
   /** Line ranges to focus on */
   focusRanges: Array<{
     start: number;
@@ -3600,6 +3615,20 @@ declare const SECTION_NAMES: Record<string, string>;
 declare const MAX_SKILL_CHARS = 4800;
 /** Name of the workspace skill SKILL.md file. */
 declare const WORKSPACE_SKILL_FILENAME = "SKILL.md";
+/**
+ * Compiled skill output bundle containing both the visible SKILL.md
+ * and the references/workspace-memory.md companion file.
+ */
+interface CompiledSkillBundle {
+  /** The visible SKILL.md content (compact, reference-backed). */
+  skillMarkdown: string;
+  /** The references/workspace-memory.md content (detailed, source-backed). */
+  referencesMarkdown: string;
+  /** Quality warnings generated during compilation. */
+  warnings: string[];
+  /** Content hash for staleness detection. */
+  contentHash: string;
+}
 interface PromotedKnowledgeEntry {
   title: string;
   insight: string;
@@ -3617,6 +3646,12 @@ interface SkillInput {
   adrSummaries?: string[];
   pitfalls?: string[];
   validationCommands?: string[];
+  userPreferences?: string[];
+  architectureMemory?: string[];
+  preventionRules?: string[];
+  reviewGates?: string[];
+  /** True if package.json exists in workspace root — structural sections are required. */
+  hasPackageJson?: boolean;
 }
 /** Input data for generating a flow briefing reference file. */
 interface FlowBriefingInput {
@@ -3666,10 +3701,12 @@ declare function computeSourceHash(input: SkillInput): string;
  */
 declare function computeFlowSourceHash(input: FlowBriefingInput): string;
 /**
- * Generate a workspace skill SKILL.md from workspace analysis data
- * and promoted knowledge.
+ * Generate a workspace skill SKILL.md and references/workspace-memory.md
+ * from workspace analysis data and promoted knowledge.
+ *
+ * Returns a CompiledSkillBundle containing both files plus warnings.
  */
-declare function generateWorkspaceSkill(input: SkillInput, version?: number): string;
+declare function generateWorkspaceSkill(input: SkillInput, version?: number): CompiledSkillBundle;
 /**
  * Generate a flow briefing reference file from flow execution state.
  */