@shepai/cli 1.180.0 → 1.181.0-pr539.0993dc0

package/apis/json-schema/CavemanModeConfig.yaml

@@ -0,0 +1,14 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: CavemanModeConfig.yaml
+type: object
+properties:
+  enabled:
+    type: boolean
+    default: false
+    description: "Master toggle for caveman directive injection (default: false)"
+  directive:
+    type: string
+    description: Optional custom directive text (undefined = use factory default)
+required:
+  - enabled
+description: Caveman system-prompt directive configuration (optional, disabled by default)

package/apis/json-schema/PhaseTiming.yaml

@@ -64,6 +64,36 @@ properties:
   errorMessage:
     type: string
     description: Error details when exitCode is not success
+  originalTokenEstimate:
+    type: string
+    description: Estimated token count before optimization (chars / 4 heuristic)
+  optimizedTokenEstimate:
+    type: string
+    description: Estimated token count after optimization (chars / 4 heuristic)
+  savingsPercent:
+    type: number
+    description: Percentage of tokens saved by optimization ((original - optimized) / original * 100)
+  capabilitiesApplied:
+    type: string
+    description: JSON array of optimization capability names that were applied
+  outputFilterLinesRemoved:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: Number of lines removed by the command output filter
+  deltaContextFilesSkipped:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: Number of spec files replaced with compact summaries by delta-context
+  compressionRatio:
+    type: number
+    description: Compression ratio achieved by semantic text compression (compressed / original)
+  aliasesCreated:
+    type: integer
+    minimum: -2147483648
+    maximum: 2147483647
+    description: Number of alias substitutions created by the alias compression engine
 required:
   - agentRunId
   - phase

package/apis/json-schema/SubprocessFilterConfig.yaml

@@ -0,0 +1,11 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: SubprocessFilterConfig.yaml
+type: object
+properties:
+  enabled:
+    type: boolean
+    default: false
+    description: "Master toggle for subprocess output filtering (default: false)"
+required:
+  - enabled
+description: Subprocess output filter configuration (optional, disabled by default)

package/apis/json-schema/TokenOptimizationConfig.yaml

@@ -0,0 +1,36 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: TokenOptimizationConfig.yaml
+type: object
+properties:
+  enabled:
+    type: boolean
+    default: true
+    description: "Master toggle for the entire optimization layer (default: true)"
+  outputFiltering:
+    type: boolean
+    default: true
+    description: "Enable command output filtering to reduce test/build/git output tokens (default: true)"
+  skillRouting:
+    type: boolean
+    default: true
+    description: "Enable phase-aware skill routing directives in prompts (default: true)"
+  deltaContext:
+    type: boolean
+    default: true
+    description: "Enable delta-context diffing to skip unchanged spec files (default: true)"
+  semanticCompression:
+    type: boolean
+    default: true
+    description: "Enable rule-based semantic text compression on instruction sections (default: true)"
+  aliasCompression:
+    type: boolean
+    default: true
+    description: "Enable alias/meta-token compression for repeated long strings (default: true)"
+required:
+  - enabled
+  - outputFiltering
+  - skillRouting
+  - deltaContext
+  - semanticCompression
+  - aliasCompression
+description: Token optimization layer configuration with master toggle and per-capability controls

package/apis/json-schema/WorkflowConfig.yaml

@@ -67,6 +67,15 @@ properties:
   skillInjection:
     $ref: SkillInjectionConfig.yaml
     description: Skill injection configuration (optional, disabled by default)
+  tokenOptimization:
+    $ref: TokenOptimizationConfig.yaml
+    description: Token optimization configuration (optional, enabled by default)
+  cavemanMode:
+    $ref: CavemanModeConfig.yaml
+    description: Caveman mode configuration (optional, disabled by default)
+  subprocessFilter:
+    $ref: SubprocessFilterConfig.yaml
+    description: Subprocess output filter configuration (optional, disabled by default)
 required:
   - openPrOnImplementationComplete
   - approvalGateDefaults

package/dist/packages/core/src/application/ports/output/agents/agent-executor.interface.d.ts

@@ -88,6 +88,14 @@ export interface AgentExecutionOptions {
     disableMcp?: boolean;
     /** Restrict available built-in tools via --tools flag */
     tools?: string[];
+    /**
+     * Absolute path to the shep-filter shim directory to prepend to PATH.
+     * When set, the executor prepends this directory to the subprocess
+     * PATH so that commands like `git`, `npm`, `pnpm` are intercepted
+     * by shep-filter wrapper scripts that pipe output through token-
+     * reducing filters before Claude Code ingests the results.
+     */
+    subprocessFilterShimDir?: string;
 }
 /**
  * Port interface for executing prompts against an AI agent.

package/dist/packages/core/src/application/ports/output/agents/agent-executor.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-executor.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/agent-executor.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,uDAAuD;IACvD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,2DAA2D;IAC3D,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtC,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mEAAmE;IACnE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAExF;;;;;;OAMG;IACH,aAAa,CACX,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;CACjD"}
+{"version":3,"file":"agent-executor.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/agent-executor.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,uDAAuD;IACvD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,2DAA2D;IAC3D,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtC,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mEAAmE;IACnE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAExF;;;;;;OAMG;IACH,aAAa,CACX,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;CACjD"}

package/dist/packages/core/src/application/ports/output/agents/phase-timing-repository.interface.d.ts

@@ -25,7 +25,7 @@ export interface IPhaseTimingRepository {
      * @param id - The phase timing ID
      * @param updates - Fields to update (timing + optional token usage, exit code, error)
      */
-    update(id: string, updates: Partial<Pick<PhaseTiming, 'completedAt' | 'durationMs' | 'inputTokens' | 'outputTokens' | 'cacheCreationInputTokens' | 'cacheReadInputTokens' | 'costUsd' | 'numTurns' | 'durationApiMs' | 'exitCode' | 'errorMessage' | 'prompt'>>): Promise<void>;
+    update(id: string, updates: Partial<Pick<PhaseTiming, 'completedAt' | 'durationMs' | 'inputTokens' | 'outputTokens' | 'cacheCreationInputTokens' | 'cacheReadInputTokens' | 'costUsd' | 'numTurns' | 'durationApiMs' | 'exitCode' | 'errorMessage' | 'prompt' | 'originalTokenEstimate' | 'optimizedTokenEstimate' | 'savingsPercent' | 'capabilitiesApplied' | 'outputFilterLinesRemoved' | 'deltaContextFilesSkipped' | 'compressionRatio' | 'aliasesCreated'>>): Promise<void>;
     /**
      * Update approval wait timing fields on a phase timing record.
      *
@@ -33,6 +33,13 @@ export interface IPhaseTimingRepository {
      * @param updates - Approval wait fields to update
      */
     updateApprovalWait(id: string, updates: Partial<Pick<PhaseTiming, 'waitingApprovalAt' | 'approvalWaitMs'>>): Promise<void>;
+    /**
+     * Find a single phase timing record by its ID.
+     *
+     * @param id - The phase timing ID
+     * @returns The phase timing record, or null if not found
+     */
+    findById(id: string): Promise<PhaseTiming | null>;
     /**
      * Find all phase timings for an agent run.
      *

package/dist/packages/core/src/application/ports/output/agents/phase-timing-repository.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"phase-timing-repository.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/phase-timing-repository.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;;;;OAKG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CACd,IAAI,CACF,WAAW,EACT,aAAa,GACb,YAAY,GACZ,aAAa,GACb,cAAc,GACd,0BAA0B,GAC1B,sBAAsB,GACtB,SAAS,GACT,UAAU,GACV,eAAe,GACf,UAAU,GACV,cAAc,GACd,QAAQ,CACX,CACF,GACA,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,kBAAkB,CAChB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,mBAAmB,GAAG,gBAAgB,CAAC,CAAC,GAC1E,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAExD;;;;;OAKG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC5D"}
+{"version":3,"file":"phase-timing-repository.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/phase-timing-repository.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;;;;OAKG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CACd,IAAI,CACF,WAAW,EACT,aAAa,GACb,YAAY,GACZ,aAAa,GACb,cAAc,GACd,0BAA0B,GAC1B,sBAAsB,GACtB,SAAS,GACT,UAAU,GACV,eAAe,GACf,UAAU,GACV,cAAc,GACd,QAAQ,GACR,uBAAuB,GACvB,wBAAwB,GACxB,gBAAgB,GAChB,qBAAqB,GACrB,0BAA0B,GAC1B,0BAA0B,GAC1B,kBAAkB,GAClB,gBAAgB,CACnB,CACF,GACA,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,kBAAkB,CAChB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,mBAAmB,GAAG,gBAAgB,CAAC,CAAC,GAC1E,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAElD;;;;;OAKG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAExD;;;;;OAKG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC5D"}

package/dist/packages/core/src/application/ports/output/index.d.ts

@@ -8,6 +8,6 @@
  */
 export type { IAgentExecutor, AgentExecutionResult, AgentExecutionStreamEvent, AgentExecutionOptions, IAgentExecutorFactory, IAgentExecutorProvider, IAgentRegistry, AgentDefinitionWithFactory, IAgentRunner, AgentRunOptions, IAgentRunRepository, IAgentValidator, AgentValidationResult, IFeatureAgentProcessService, } from './agents/index.js';
 export type { IFeatureRepository, FeatureListFilters, ISettingsRepository, } from './repositories/index.js';
-export type { IExternalIssueFetcher, ExternalIssue, INotificationService, ISpecInitializerService, SpecInitializerResult, IVersionService, IWebServerService, IWorktreeService, WorktreeInfo, } from './services/index.js';
+export type { IExternalIssueFetcher, ExternalIssue, INotificationService, ISpecInitializerService, SpecInitializerResult, IVersionService, IWebServerService, IWorktreeService, WorktreeInfo, IPromptOptimizerService, PromptOptimizationContext, PromptOptimizationResult, OptimizationMetrics, ICommandOutputFilterService, CommandOutputFilterResult, ISkillRoutingService, SkillRoutingResult, IDeltaContextService, DeltaContextResult, SpecFileEntry, ISemanticCompressorService, SemanticCompressionResult, IAliasCompressionService, AliasCompressionResult, IOptimizationMetricsService, } from './services/index.js';
 export { IssueFetcherError, IssueNotFoundError, IssueAuthenticationError, IssueServiceUnavailableError, WorktreeError, WorktreeErrorCode, } from './services/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/packages/core/src/application/ports/output/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/ports/output/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,0BAA0B,EAC1B,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EACV,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,EAC5B,aAAa,EACb,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/ports/output/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,0BAA0B,EAC1B,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EACV,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,yBAAyB,EACzB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,EAC5B,aAAa,EACb,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}

package/dist/packages/core/src/application/ports/output/services/alias-compression.interface.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Alias Compression Service Interface
+ *
+ * Output port for session dictionary-based alias compression. Identifies
+ * repeated long strings (3+ occurrences, 20+ chars) in prompts and
+ * replaces them with short aliases ($A1, $A2, etc.) with a dictionary
+ * header prepended to the prompt.
+ *
+ * Following Clean Architecture:
+ * - Application layer depends on this interface
+ * - Infrastructure layer provides frequency analysis implementation
+ */
+/**
+ * Result of applying alias compression to a prompt.
+ */
+export interface AliasCompressionResult {
+    /** The prompt with aliases substituted and dictionary header prepended */
+    compressed: string;
+    /** The dictionary header text (empty string if no aliases created) */
+    dictionaryHeader: string;
+    /** Number of alias substitutions created */
+    aliasCount: number;
+}
+/**
+ * Service interface for alias/meta-token compression.
+ *
+ * Scans a prompt for repeated long strings, builds a session dictionary,
+ * and replaces occurrences with short aliases. A net-positive check
+ * ensures the dictionary header does not exceed the savings from aliasing.
+ */
+export interface IAliasCompressionService {
+    /**
+     * Apply alias compression to a prompt string.
+     *
+     * Identifies strings appearing 3+ times that are 20+ characters long,
+     * assigns aliases ($A1, $A2, ...), prepends a dictionary header, and
+     * replaces all occurrences. Returns the original text unchanged if
+     * aliasing would not achieve net-positive savings.
+     *
+     * @param text - Prompt text to compress via aliasing
+     * @returns Compressed text with dictionary, header text, and alias count
+     */
+    compress(text: string): AliasCompressionResult;
+}
+//# sourceMappingURL=alias-compression.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/services/alias-compression.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias-compression.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/alias-compression.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,gBAAgB,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,CAAC;CAChD"}

package/dist/packages/core/src/application/ports/output/services/alias-compression.interface.js

@@ -0,0 +1,13 @@
+/**
+ * Alias Compression Service Interface
+ *
+ * Output port for session dictionary-based alias compression. Identifies
+ * repeated long strings (3+ occurrences, 20+ chars) in prompts and
+ * replaces them with short aliases ($A1, $A2, etc.) with a dictionary
+ * header prepended to the prompt.
+ *
+ * Following Clean Architecture:
+ * - Application layer depends on this interface
+ * - Infrastructure layer provides frequency analysis implementation
+ */
+export {};

package/dist/packages/core/src/application/ports/output/services/command-output-filter.interface.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Command Output Filter Service Interface
+ *
+ * Output port for filtering command output (test runners, build tools,
+ * git operations) embedded in prompts. Applies configurable regex-based
+ * filter policies to reduce token consumption while preserving all
+ * error-relevant information.
+ *
+ * Following Clean Architecture:
+ * - Application layer depends on this interface
+ * - Infrastructure layer provides regex-based implementation
+ */
+/**
+ * Filter policy type identifying the kind of command output.
+ */
+export type OutputFilterPolicyType = 'jest' | 'vitest' | 'typescript-build' | 'git-diff' | 'pnpm-install' | 'generic';
+/**
+ * Result of applying the command output filter to a prompt.
+ */
+export interface CommandOutputFilterResult {
+    /** The filtered prompt string */
+    filtered: string;
+    /** Number of lines removed by the filter */
+    linesRemoved: number;
+}
+/**
+ * Service interface for filtering command output within prompts.
+ *
+ * Scans the prompt for recognizable command output blocks and applies
+ * reduction policies: removing passing test lines, truncating long diffs,
+ * collapsing blank lines, and summarizing passing sections with counts.
+ *
+ * Safety guarantee: any line containing error-related keywords (error,
+ * fail, warn, ENOENT, exception, stack, panic, timeout, denied, etc.)
+ * is preserved verbatim.
+ */
+export interface ICommandOutputFilterService {
+    /**
+     * Filter command output embedded in a prompt string.
+     *
+     * Detects output blocks (fenced code blocks, test runner output patterns)
+     * and applies reduction policies based on detected output type. Lines
+     * containing error-related keywords are always preserved.
+     *
+     * @param prompt - Raw prompt containing embedded command output
+     * @returns Filtered prompt and count of lines removed
+     */
+    filter(prompt: string): CommandOutputFilterResult;
+}
+//# sourceMappingURL=command-output-filter.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/services/command-output-filter.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-output-filter.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/command-output-filter.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAC9B,MAAM,GACN,QAAQ,GACR,kBAAkB,GAClB,UAAU,GACV,cAAc,GACd,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,yBAAyB,CAAC;CACnD"}

package/dist/packages/core/src/application/ports/output/services/command-output-filter.interface.js

@@ -0,0 +1,13 @@
+/**
+ * Command Output Filter Service Interface
+ *
+ * Output port for filtering command output (test runners, build tools,
+ * git operations) embedded in prompts. Applies configurable regex-based
+ * filter policies to reduce token consumption while preserving all
+ * error-relevant information.
+ *
+ * Following Clean Architecture:
+ * - Application layer depends on this interface
+ * - Infrastructure layer provides regex-based implementation
+ */
+export {};

package/dist/packages/core/src/application/ports/output/services/delta-context.interface.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Delta-Context Service Interface
+ *
+ * Output port for hash-based spec file change detection. Compares
+ * SHA-256 hashes of spec files against previous phase hashes and
+ * replaces unchanged files with compact summaries to reduce repeated
+ * context tokens across multi-phase workflows.
+ *
+ * Following Clean Architecture:
+ * - Application layer depends on this interface
+ * - Infrastructure layer provides hash-based implementation
+ */
+/**
+ * Description of a spec file to be checked for changes.
+ */
+export interface SpecFileEntry {
+    /** File name (e.g., 'spec.yaml', 'research.yaml') */
+    fileName: string;
+    /** Full file content as read from disk */
+    content: string;
+}
+/**
+ * Result of applying delta-context diffing to spec files.
+ */
+export interface DeltaContextResult {
+    /** Map of file names to their optimized content (full or summary) */
+    optimizedFiles: Record<string, string>;
+    /** Updated SHA-256 hashes for all files (store in LangGraph state) */
+    currentHashes: Record<string, string>;
+    /** Number of files that were replaced with compact summaries */
+    filesSkipped: number;
+}
+/**
+ * Service interface for delta-context spec file diffing.
+ *
+ * Computes SHA-256 hashes of spec file contents and compares them
+ * against hashes from the previous phase. Unchanged files are replaced
+ * with compact summaries (file name, line count, last-modified phase).
+ * Changed files and first-phase files are returned with full content.
+ */
+export interface IDeltaContextService {
+    /**
+     * Diff spec files against previous phase hashes.
+     *
+     * For unchanged files: replaces content with a compact summary
+     * "[file unchanged since {previousPhase} - {lineCount} lines, hash {shortHash}]"
+     *
+     * For changed files or first phase (no previous hashes): returns full content.
+     *
+     * @param files - Spec files with their current content
+     * @param previousHashes - SHA-256 hashes from the previous phase (empty for first phase)
+     * @param previousPhaseName - Name of the previous phase (for summary text)
+     * @returns Optimized file contents, updated hashes, and count of skipped files
+     */
+    diff(files: SpecFileEntry[], previousHashes: Record<string, string>, previousPhaseName?: string): DeltaContextResult;
+}
+//# sourceMappingURL=delta-context.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/services/delta-context.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta-context.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/delta-context.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,sEAAsE;IACtE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;;;;;OAYG;IACH,IAAI,CACF,KAAK,EAAE,aAAa,EAAE,EACtB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACtC,iBAAiB,CAAC,EAAE,MAAM,GACzB,kBAAkB,CAAC;CACvB"}

package/dist/packages/core/src/application/ports/output/services/delta-context.interface.js

@@ -0,0 +1,13 @@
+/**
+ * Delta-Context Service Interface
+ *
+ * Output port for hash-based spec file change detection. Compares
+ * SHA-256 hashes of spec files against previous phase hashes and
+ * replaces unchanged files with compact summaries to reduce repeated
+ * context tokens across multi-phase workflows.
+ *
+ * Following Clean Architecture:
+ * - Application layer depends on this interface
+ * - Infrastructure layer provides hash-based implementation
+ */
+export {};

package/dist/packages/core/src/application/ports/output/services/index.d.ts

@@ -21,6 +21,13 @@ export type { IGitHubRepositoryService, GitHubRepo, GitHubOrganization, ListUser
 export { GitHubAuthError, GitHubCloneError, GitHubUrlParseError, GitHubRepoListError, } from './github-repository-service.interface.js';
 export type { IInteractiveSessionService, StreamChunk, UnsubscribeFn, ChatState, } from './interactive-session-service.interface.js';
 export type { ISkillInjectorService, SkillInjectionResult } from './skill-injector.interface.js';
+export type { IPromptOptimizerService, PromptOptimizationContext, PromptOptimizationResult, OptimizationMetrics, } from './prompt-optimizer.interface.js';
+export type { ICommandOutputFilterService, CommandOutputFilterResult, OutputFilterPolicyType, } from './command-output-filter.interface.js';
+export type { ISkillRoutingService, SkillRoutingResult } from './skill-routing.interface.js';
+export type { IDeltaContextService, DeltaContextResult, SpecFileEntry, } from './delta-context.interface.js';
+export type { ISemanticCompressorService, SemanticCompressionResult, } from './semantic-compressor.interface.js';
+export type { IAliasCompressionService, AliasCompressionResult, } from './alias-compression.interface.js';
+export type { IOptimizationMetricsService } from './optimization-metrics.interface.js';
 export type { IFileSystemService } from './file-system-service.interface.js';
 export type { IApplicationBriefStore } from './application-brief-store.interface.js';
 export type { IApplicationFileSystemService, FileTreeEntry, ReadFileResult, ReadFileBufferResult, FileChangeKind, FileChangeEvent, FileChangeListener, UnsubscribeFn as FileWatchUnsubscribeFn, } from './application-file-system-service.interface.js';

package/dist/packages/core/src/application/ports/output/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACnF,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACjG,YAAY,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,YAAY,EACV,aAAa,EACb,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC3E,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjF,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC9F,YAAY,EACV,wBAAwB,EACxB,UAAU,EACV,kBAAkB,EAClB,2BAA2B,EAC3B,YAAY,EACZ,eAAe,GAChB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,0CAA0C,CAAC;AAClD,YAAY,EACV,0BAA0B,EAC1B,WAAW,EACX,aAAa,EACb,SAAS,GACV,MAAM,4CAA4C,CAAC;AACpD,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACjG,YAAY,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,YAAY,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,YAAY,EACV,6BAA6B,EAC7B,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,aAAa,IAAI,sBAAsB,GACxC,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gDAAgD,CAAC;AAC5F,YAAY,EACV,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,yCAAyC,CAAC;AACjD,YAAY,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AACpF,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EACV,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,yCAAyC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/index.ts"],"names":[],"mappings":"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"}

package/dist/packages/core/src/application/ports/output/services/optimization-metrics.interface.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Optimization Metrics Service Interface
+ *
+ * Output port for persisting token optimization metrics alongside
+ * existing PhaseTiming records. Records per-phase optimization data
+ * (token estimates, savings, per-capability stats) for observability
+ * and optimization tuning.
+ *
+ * Following Clean Architecture:
+ * - Application layer depends on this interface
+ * - Infrastructure layer provides persistence via PhaseTiming repository
+ */
+import type { OptimizationMetrics } from './prompt-optimizer.interface.js';
+/**
+ * Service interface for recording and retrieving optimization metrics.
+ *
+ * Persists optimization metrics as additional fields on PhaseTiming
+ * records. Uses the existing phase timing infrastructure so metrics
+ * are queryable alongside timing and cost data.
+ */
+export interface IOptimizationMetricsService {
+    /**
+     * Record optimization metrics for a phase timing entry.
+     *
+     * Updates the PhaseTiming record with optimization-specific fields:
+     * original/optimized token estimates, savings percent, capabilities
+     * applied, and per-capability stats.
+     *
+     * @param phaseTimingId - ID of the PhaseTiming record to update
+     * @param metrics - Optimization metrics to persist
+     */
+    record(phaseTimingId: string, metrics: OptimizationMetrics): Promise<void>;
+    /**
+     * Retrieve optimization metrics previously recorded for a phase timing.
+     *
+     * Returns null when no phase timing exists for the supplied ID, when
+     * the record exists but has no optimization columns populated, or when
+     * the underlying repository read fails.
+     *
+     * @param phaseTimingId - ID of the PhaseTiming record to query
+     * @returns Stored OptimizationMetrics or null if no metrics are present
+     */
+    getByPhaseTimingId(phaseTimingId: string): Promise<OptimizationMetrics | null>;
+}
+//# sourceMappingURL=optimization-metrics.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/services/optimization-metrics.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimization-metrics.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/optimization-metrics.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE3E;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;;;OASG;IACH,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3E;;;;;;;;;OASG;IACH,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;CAChF"}

package/dist/packages/core/src/application/ports/output/services/optimization-metrics.interface.js

@@ -0,0 +1,13 @@
+/**
+ * Optimization Metrics Service Interface
+ *
+ * Output port for persisting token optimization metrics alongside
+ * existing PhaseTiming records. Records per-phase optimization data
+ * (token estimates, savings, per-capability stats) for observability
+ * and optimization tuning.
+ *
+ * Following Clean Architecture:
+ * - Application layer depends on this interface
+ * - Infrastructure layer provides persistence via PhaseTiming repository
+ */
+export {};

package/dist/packages/core/src/application/ports/output/services/prompt-optimizer.interface.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Prompt Optimizer Service Interface
+ *
+ * Output port for the token optimization layer. Orchestrates all
+ * optimization capabilities (output filtering, skill routing,
+ * delta-context diffing, semantic compression, alias compression)
+ * to reduce prompt token consumption before LLM invocation.
+ *
+ * Following Clean Architecture:
+ * - Application layer depends on this interface
+ * - Infrastructure layer provides the composable pipeline implementation
+ */
+import type { TokenOptimizationConfig } from '../../../../domain/generated/output.js';
+/**
+ * Context provided to the optimizer for intelligent optimization decisions.
+ */
+export interface PromptOptimizationContext {
+    /** Current graph node / workflow phase name (e.g., 'analyze', 'implement') */
+    phaseName: string;
+    /** Model identifier for the downstream executor */
+    modelId?: string;
+    /** Feature ID for per-feature settings lookup */
+    featureId: string;
+    /** Agent run ID for metrics correlation */
+    agentRunId: string;
+    /** PhaseTiming row ID for persisting optimization metrics (if available) */
+    phaseTimingId?: string;
+    /** Previous spec file hashes for delta-context diffing */
+    previousSpecFileHashes?: Record<string, string>;
+    /** Optimization config override (if not provided, reads from global settings) */
+    config?: TokenOptimizationConfig;
+}
+/**
+ * Per-capability metrics collected during optimization.
+ */
+export interface OptimizationMetrics {
+    /** Estimated tokens before optimization (chars / 4 heuristic) */
+    originalTokenEstimate: number;
+    /** Estimated tokens after optimization (chars / 4 heuristic) */
+    optimizedTokenEstimate: number;
+    /** Percentage of tokens saved ((original - optimized) / original * 100) */
+    savingsPercent: number;
+    /** List of optimization capability names that were applied */
+    capabilitiesApplied: string[];
+    /** Lines removed by command output filter */
+    outputFilterLinesRemoved: number;
+    /** Spec files replaced with compact summaries by delta-context */
+    deltaContextFilesSkipped: number;
+    /** Compression ratio from semantic compression (compressed / original) */
+    compressionRatio: number;
+    /** Number of alias substitutions created */
+    aliasesCreated: number;
+}
+/**
+ * Result returned by the prompt optimizer.
+ */
+export interface PromptOptimizationResult {
+    /** The optimized prompt string */
+    prompt: string;
+    /** Optimization metrics for tracking and reporting */
+    metrics: OptimizationMetrics;
+    /** Updated spec file hashes for delta-context (store in LangGraph state) */
+    specFileHashes: Record<string, string>;
+}
+/**
+ * Service interface for the token optimization layer.
+ *
+ * Orchestrates all optimization capabilities based on settings toggles,
+ * applying them in sequence: output filter -> skill router -> delta-context
+ * -> semantic compressor -> alias engine.
+ */
+export interface IPromptOptimizerService {
+    /**
+     * Optimize a raw prompt string to reduce token consumption.
+     *
+     * Applies enabled optimization capabilities in sequence and returns
+     * the optimized prompt with metrics. If optimization is disabled
+     * (master toggle off), returns the original prompt with zero-delta metrics.
+     *
+     * @param prompt - Raw prompt string from buildPrompt()
+     * @param context - Phase context for intelligent optimization decisions
+     * @returns Optimized prompt, metrics, and updated spec file hashes
+     */
+    optimize(prompt: string, context: PromptOptimizationContext): Promise<PromptOptimizationResult>;
+}
+//# sourceMappingURL=prompt-optimizer.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/services/prompt-optimizer.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-optimizer.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/prompt-optimizer.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,iFAAiF;IACjF,MAAM,CAAC,EAAE,uBAAuB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gEAAgE;IAChE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,2EAA2E;IAC3E,cAAc,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,6CAA6C;IAC7C,wBAAwB,EAAE,MAAM,CAAC;IACjC,kEAAkE;IAClE,wBAAwB,EAAE,MAAM,CAAC;IACjC,0EAA0E;IAC1E,gBAAgB,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,OAAO,EAAE,mBAAmB,CAAC;IAC7B,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACjG"}

package/dist/packages/core/src/application/ports/output/services/prompt-optimizer.interface.js

@@ -0,0 +1,13 @@
+/**
+ * Prompt Optimizer Service Interface
+ *
+ * Output port for the token optimization layer. Orchestrates all
+ * optimization capabilities (output filtering, skill routing,
+ * delta-context diffing, semantic compression, alias compression)
+ * to reduce prompt token consumption before LLM invocation.
+ *
+ * Following Clean Architecture:
+ * - Application layer depends on this interface
+ * - Infrastructure layer provides the composable pipeline implementation
+ */
+export {};