@shepai/cli 1.175.1-pr536.17338e9 → 1.175.1-pr537.fc6a92c

package/apis/json-schema/AgentConfig.yaml

@@ -13,6 +13,9 @@ properties:
   token:
     type: string
     description: API token for token-based auth (optional)
+  permissionMode:
+    $ref: PermissionMode.yaml
+    description: Permission mode for tool approvals (optional, defaults to agent default)
 required:
   - type
   - authMethod

package/apis/json-schema/AgentType.yaml

@@ -9,5 +9,6 @@ enum:
   - aider
   - continue
   - cursor
+  - rovo-dev
   - dev
 description: AI coding agent tool selection

package/apis/json-schema/PermissionMode.yaml

@@ -0,0 +1,8 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: PermissionMode.yaml
+type: string
+enum:
+  - default
+  - strict
+  - autonomous
+description: Permission mode controlling how an agent handles tool approvals

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

@@ -20,7 +20,7 @@
  * }
  * ```
  */
-import type { AgentType, AgentFeature } from '../../../../domain/generated/output.js';
+import type { AgentType, AgentFeature, PermissionMode } from '../../../../domain/generated/output.js';
 /**
  * Token usage and execution statistics returned by an agent.
  */
@@ -88,6 +88,8 @@ export interface AgentExecutionOptions {
     disableMcp?: boolean;
     /** Restrict available built-in tools via --tools flag */
     tools?: string[];
+    /** Permission mode controlling how the agent handles tool approvals */
+    permissionMode?: PermissionMode;
 }
 /**
  * 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,EACV,SAAS,EACT,YAAY,EACZ,cAAc,EACf,MAAM,wCAAwC,CAAC;AAEhD;;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,uEAAuE;IACvE,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;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/agent-run-repository.interface.d.ts

@@ -66,6 +66,13 @@ export interface IAgentRunRepository {
      * @returns Array of running agent runs with the given PID
      */
     findRunningByPid(pid: number): Promise<AgentRun[]>;
+    /**
+     * Find multiple agent runs by their IDs in a single query.
+     *
+     * @param ids - The agent run IDs to look up
+     * @returns Array of found agent runs (missing IDs are silently skipped)
+     */
+    findByIds(ids: string[]): Promise<AgentRun[]>;
     /**
      * List all agent runs.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"agent-run-repository.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/agent-run-repository.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAEvF,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC9B,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAE/C;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAE3D;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7F;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnF;;;;;;OAMG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEnD;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE5B;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC"}
+{"version":3,"file":"agent-run-repository.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/agent-run-repository.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAEvF,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC9B,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAE/C;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAE3D;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7F;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnF;;;;;;OAMG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEnD;;;;;OAKG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE9C;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE5B;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC"}

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

@@ -40,6 +40,13 @@ export interface IPhaseTimingRepository {
      * @returns Array of phase timings ordered by creation
      */
     findByRunId(agentRunId: string): Promise<PhaseTiming[]>;
+    /**
+     * Find all phase timings for multiple agent runs in a single query.
+     *
+     * @param runIds - The agent run IDs to look up
+     * @returns Array of phase timings ordered by creation (across all runs)
+     */
+    findByRunIds(runIds: string[]): Promise<PhaseTiming[]>;
     /**
      * Find all phase timings for a feature (via agent_runs join).
      *

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,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,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAEvD;;;;;OAKG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC5D"}

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

@@ -8,5 +8,4 @@ export type { ISettingsRepository } from './settings.repository.interface.js';
 export type { IRepositoryRepository } from './repository-repository.interface.js';
 export type { IInteractiveSessionRepository } from './interactive-session-repository.interface.js';
 export type { IInteractiveMessageRepository } from './interactive-message-repository.interface.js';
-export type { IApplicationRepository } from './application-repository.interface.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/repositories/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAChG,YAAY,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,YAAY,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAClF,YAAY,EAAE,6BAA6B,EAAE,MAAM,+CAA+C,CAAC;AACnG,YAAY,EAAE,6BAA6B,EAAE,MAAM,+CAA+C,CAAC;AACnG,YAAY,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/repositories/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAChG,YAAY,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,YAAY,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAClF,YAAY,EAAE,6BAA6B,EAAE,MAAM,+CAA+C,CAAC;AACnG,YAAY,EAAE,6BAA6B,EAAE,MAAM,+CAA+C,CAAC"}

package/dist/packages/core/src/application/ports/output/services/file-system.interface.d.ts

@@ -0,0 +1,68 @@
+/**
+ * File System Service Interface
+ *
+ * Output port for file system operations used by application-layer code.
+ * Abstracts Node.js fs primitives behind a testable interface so that
+ * use cases and presentation layers never import fs directly.
+ *
+ * Following Clean Architecture:
+ * - Application / Presentation layers depend on this interface
+ * - Infrastructure layer provides the concrete Node.js fs implementation
+ */
+/**
+ * Port interface for file system operations.
+ *
+ * Implementations must:
+ * - Use path.join / path.resolve internally (no hardcoded separators)
+ * - Normalize paths to forward slashes where appropriate (cross-platform)
+ * - Propagate fs errors as-is — callers handle ENOENT etc.
+ */
+export interface IFileSystemService {
+    /**
+     * Read the entire contents of a file asynchronously.
+     *
+     * @param path - Absolute path to the file
+     * @returns Buffer with the file contents
+     */
+    readFile(path: string): Promise<Buffer>;
+    /**
+     * Read the entire contents of a file synchronously.
+     *
+     * @param path - Absolute path to the file
+     * @param encoding - Optional encoding (defaults to utf-8)
+     * @returns File contents as a string
+     */
+    readFileSync(path: string, encoding?: BufferEncoding): string;
+    /**
+     * Write data to a file, creating it if it does not exist and
+     * overwriting it if it does.
+     *
+     * @param path - Absolute path to the file
+     * @param data - Content to write
+     */
+    writeFile(path: string, data: string | Buffer): Promise<void>;
+    /**
+     * Check whether a file or directory exists at the given path.
+     *
+     * @param path - Absolute path to check
+     * @returns true if the path exists
+     */
+    exists(path: string): boolean;
+    /**
+     * List the entries (files and directories) in a directory.
+     *
+     * @param path - Absolute path to the directory
+     * @returns Array of entry names (not full paths)
+     */
+    readDir(path: string): string[];
+    /**
+     * Create a directory, optionally creating parent directories.
+     *
+     * @param path - Absolute path to the directory
+     * @param options - Optional; set recursive to create parent dirs
+     */
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): void;
+}
+//# sourceMappingURL=file-system.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/file-system.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAExC;;;;;;OAMG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC;IAE9D;;;;;;OAMG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9D;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAE9B;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEhC;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CAC9D"}

package/dist/packages/core/src/application/ports/output/services/file-system.interface.js

@@ -0,0 +1,12 @@
+/**
+ * File System Service Interface
+ *
+ * Output port for file system operations used by application-layer code.
+ * Abstracts Node.js fs primitives behind a testable interface so that
+ * use cases and presentation layers never import fs directly.
+ *
+ * Following Clean Architecture:
+ * - Application / Presentation layers depend on this interface
+ * - Infrastructure layer provides the concrete Node.js fs implementation
+ */
+export {};

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

@@ -21,4 +21,7 @@ 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 { IProcessMonitorService } from './process-monitor.interface.js';
+export type { IFileSystemService } from './file-system.interface.js';
+export type { ISettingsReader } from './settings-reader.interface.js';
 //# sourceMappingURL=index.d.ts.map

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"}
+{"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,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/packages/core/src/application/ports/output/services/process-monitor.interface.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Process Monitor Service Interface
+ *
+ * Output port for checking whether OS processes are alive.
+ * Infrastructure layer provides a concrete implementation using
+ * process.kill(pid, 0) (signal-0 probe).
+ *
+ * Following Clean Architecture:
+ * - Application / Presentation layers depend on this interface
+ * - Infrastructure layer provides concrete implementation
+ */
+/**
+ * Port interface for querying process liveness.
+ *
+ * Implementations must:
+ * - Return true only when the PID exists and is not a zombie
+ * - Return false for invalid PIDs (negative, NaN, non-finite)
+ * - Never throw — always return a boolean
+ */
+export interface IProcessMonitorService {
+    /**
+     * Check whether a process with the given PID is still running.
+     *
+     * @param pid - OS process identifier to probe
+     * @returns true if the process is alive, false otherwise
+     */
+    isAlive(pid: number): boolean;
+}
+//# sourceMappingURL=process-monitor.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"process-monitor.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/process-monitor.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B"}

package/dist/packages/core/src/application/ports/output/services/process-monitor.interface.js

@@ -0,0 +1,12 @@
+/**
+ * Process Monitor Service Interface
+ *
+ * Output port for checking whether OS processes are alive.
+ * Infrastructure layer provides a concrete implementation using
+ * process.kill(pid, 0) (signal-0 probe).
+ *
+ * Following Clean Architecture:
+ * - Application / Presentation layers depend on this interface
+ * - Infrastructure layer provides concrete implementation
+ */
+export {};

package/dist/packages/core/src/application/ports/output/services/settings-reader.interface.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Settings Reader Interface
+ *
+ * Output port for reading application settings.
+ * Infrastructure layer provides the concrete implementation that wraps
+ * the globalThis/process-based settings singleton.
+ *
+ * Following Clean Architecture:
+ * - Application layer depends on this interface (never on the infrastructure singleton)
+ * - Infrastructure layer provides the concrete SettingsReaderAdapter
+ */
+import type { Settings } from '../../../../domain/generated/output.js';
+/**
+ * Port interface for reading application settings.
+ *
+ * Implementations must:
+ * - Return the current in-memory Settings instance
+ * - Indicate whether settings have been initialized
+ */
+export interface ISettingsReader {
+    /**
+     * Get the current application settings.
+     *
+     * @returns Current settings instance
+     * @throws Error if settings haven't been initialized yet
+     */
+    getSettings(): Settings;
+    /**
+     * Check if settings have been initialized.
+     *
+     * @returns True if settings are initialized, false otherwise
+     */
+    hasSettings(): boolean;
+}
+//# sourceMappingURL=settings-reader.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings-reader.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/settings-reader.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,WAAW,IAAI,QAAQ,CAAC;IAExB;;;;OAIG;IACH,WAAW,IAAI,OAAO,CAAC;CACxB"}

package/dist/packages/core/src/application/ports/output/services/settings-reader.interface.js

@@ -0,0 +1,12 @@
+/**
+ * Settings Reader Interface
+ *
+ * Output port for reading application settings.
+ * Infrastructure layer provides the concrete implementation that wraps
+ * the globalThis/process-based settings singleton.
+ *
+ * Following Clean Architecture:
+ * - Application layer depends on this interface (never on the infrastructure singleton)
+ * - Infrastructure layer provides the concrete SettingsReaderAdapter
+ */
+export {};

package/dist/packages/core/src/application/use-cases/agents/get-agent-session.use-case.d.ts

@@ -6,6 +6,7 @@
  * if the session does not exist.
  */
 import type { AgentSession, AgentType } from '../../../domain/generated/output.js';
+import type { ISettingsReader } from '../../ports/output/services/settings-reader.interface.js';
 import { AgentSessionRepositoryRegistry } from '../../services/agents/agent-session-repository.registry.js';
 export interface GetAgentSessionInput {
     /** The session ID (provider-native filename without extension) */
@@ -17,7 +18,8 @@ export interface GetAgentSessionInput {
 }
 export declare class GetAgentSessionUseCase {
     private readonly registry;
-    constructor(registry: AgentSessionRepositoryRegistry);
+    private readonly settingsReader;
+    constructor(registry: AgentSessionRepositoryRegistry, settingsReader: ISettingsReader);
     execute(input: GetAgentSessionInput): Promise<AgentSession>;
     private resolveAgentType;
 }

package/dist/packages/core/src/application/use-cases/agents/get-agent-session.use-case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-agent-session.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/agents/get-agent-session.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAEnF,OAAO,EAAE,8BAA8B,EAAE,MAAM,4DAA4D,CAAC;AAG5G,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,yEAAyE;IACzE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBACa,sBAAsB;IAG/B,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,8BAA8B;IAGrD,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC;IAcjE,OAAO,CAAC,gBAAgB;CAGzB"}
+{"version":3,"file":"get-agent-session.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/agents/get-agent-session.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0DAA0D,CAAC;AAChG,OAAO,EAAE,8BAA8B,EAAE,MAAM,4DAA4D,CAAC;AAG5G,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,yEAAyE;IACzE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBACa,sBAAsB;IAG/B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAFd,QAAQ,EAAE,8BAA8B,EAExC,cAAc,EAAE,eAAe;IAG5C,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC;IAcjE,OAAO,CAAC,gBAAgB;CAGzB"}

package/dist/packages/core/src/application/use-cases/agents/get-agent-session.use-case.js

@@ -18,13 +18,14 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { injectable, inject } from 'tsyringe';
-import { getSettings } from '../../../infrastructure/services/settings.service.js';
 import { AgentSessionRepositoryRegistry } from '../../services/agents/agent-session-repository.registry.js';
 import { SessionNotFoundError } from '../../../domain/errors/session-not-found.error.js';
 let GetAgentSessionUseCase = class GetAgentSessionUseCase {
     registry;
-    constructor(registry) {
+    settingsReader;
+    constructor(registry, settingsReader) {
         this.registry = registry;
+        this.settingsReader = settingsReader;
     }
     async execute(input) {
         const agentType = this.resolveAgentType(input.agentType);
@@ -37,12 +38,13 @@ let GetAgentSessionUseCase = class GetAgentSessionUseCase {
         return session;
     }
     resolveAgentType(agentType) {
-        return agentType ?? getSettings().agent.type;
+        return agentType ?? this.settingsReader.getSettings().agent.type;
     }
 };
 GetAgentSessionUseCase = __decorate([
     injectable(),
     __param(0, inject(AgentSessionRepositoryRegistry)),
-    __metadata("design:paramtypes", [AgentSessionRepositoryRegistry])
+    __param(1, inject('ISettingsReader')),
+    __metadata("design:paramtypes", [AgentSessionRepositoryRegistry, Object])
 ], GetAgentSessionUseCase);
 export { GetAgentSessionUseCase };

package/dist/packages/core/src/application/use-cases/agents/list-agent-sessions.use-case.d.ts

@@ -6,6 +6,7 @@
  * emits a warning for providers not yet implemented (stub repositories).
  */
 import type { AgentSession, AgentType } from '../../../domain/generated/output.js';
+import type { ISettingsReader } from '../../ports/output/services/settings-reader.interface.js';
 import { AgentSessionRepositoryRegistry } from '../../services/agents/agent-session-repository.registry.js';
 export interface ListAgentSessionsInput {
     /** Agent type to query; falls back to configured default when omitted */
@@ -15,7 +16,8 @@ export interface ListAgentSessionsInput {
 }
 export declare class ListAgentSessionsUseCase {
     private readonly registry;
-    constructor(registry: AgentSessionRepositoryRegistry);
+    private readonly settingsReader;
+    constructor(registry: AgentSessionRepositoryRegistry, settingsReader: ISettingsReader);
     execute(input?: ListAgentSessionsInput): Promise<AgentSession[]>;
     private resolveAgentType;
 }

package/dist/packages/core/src/application/use-cases/agents/list-agent-sessions.use-case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-agent-sessions.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/agents/list-agent-sessions.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAEnF,OAAO,EAAE,8BAA8B,EAAE,MAAM,4DAA4D,CAAC;AAE5G,MAAM,WAAW,sBAAsB;IACrC,yEAAyE;IACzE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBACa,wBAAwB;IAGjC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,8BAA8B;IAGrD,OAAO,CAAC,KAAK,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAatE,OAAO,CAAC,gBAAgB;CAGzB"}
+{"version":3,"file":"list-agent-sessions.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/agents/list-agent-sessions.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0DAA0D,CAAC;AAChG,OAAO,EAAE,8BAA8B,EAAE,MAAM,4DAA4D,CAAC;AAE5G,MAAM,WAAW,sBAAsB;IACrC,yEAAyE;IACzE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBACa,wBAAwB;IAGjC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAFd,QAAQ,EAAE,8BAA8B,EAExC,cAAc,EAAE,eAAe;IAG5C,OAAO,CAAC,KAAK,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAatE,OAAO,CAAC,gBAAgB;CAGzB"}

package/dist/packages/core/src/application/use-cases/agents/list-agent-sessions.use-case.js

@@ -18,12 +18,13 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { injectable, inject } from 'tsyringe';
-import { getSettings } from '../../../infrastructure/services/settings.service.js';
 import { AgentSessionRepositoryRegistry } from '../../services/agents/agent-session-repository.registry.js';
 let ListAgentSessionsUseCase = class ListAgentSessionsUseCase {
     registry;
-    constructor(registry) {
+    settingsReader;
+    constructor(registry, settingsReader) {
         this.registry = registry;
+        this.settingsReader = settingsReader;
     }
     async execute(input) {
         const agentType = this.resolveAgentType(input?.agentType);
@@ -36,12 +37,13 @@ let ListAgentSessionsUseCase = class ListAgentSessionsUseCase {
         return repository.list({ limit });
     }
     resolveAgentType(agentType) {
-        return agentType ?? getSettings().agent.type;
+        return agentType ?? this.settingsReader.getSettings().agent.type;
     }
 };
 ListAgentSessionsUseCase = __decorate([
     injectable(),
     __param(0, inject(AgentSessionRepositoryRegistry)),
-    __metadata("design:paramtypes", [AgentSessionRepositoryRegistry])
+    __param(1, inject('ISettingsReader')),
+    __metadata("design:paramtypes", [AgentSessionRepositoryRegistry, Object])
 ], ListAgentSessionsUseCase);
 export { ListAgentSessionsUseCase };

package/dist/packages/core/src/application/use-cases/agents/reject-agent-run.use-case.js

@@ -77,7 +77,7 @@ let RejectAgentRunUseCase = class RejectAgentRunUseCase {
                 iteration,
                 message: feedback,
                 phase: rejectedPhase,
-                timestamp: new Date().toISOString(),
+                timestamp: new Date(),
                 ...(attachments && attachments.length > 0 ? { attachments } : {}),
             };
             spec.rejectionFeedback = [...existingFeedback, newEntry];

package/dist/packages/core/src/application/use-cases/features/create/create-feature.use-case.d.ts

@@ -25,6 +25,7 @@ import type { IRepositoryRepository } from '../../../ports/output/repositories/r
 import type { IGitPrService } from '../../../ports/output/services/git-pr-service.interface.js';
 import type { IAgentValidator } from '../../../ports/output/agents/agent-validator.interface.js';
 import type { ISkillInjectorService } from '../../../ports/output/services/skill-injector.interface.js';
+import type { ISettingsReader } from '../../../ports/output/services/settings-reader.interface.js';
 import { AttachmentStorageService } from '../../../../infrastructure/services/attachment-storage.service.js';
 import { MetadataGenerator } from './metadata-generator.js';
 import { SlugResolver } from './slug-resolver.js';
@@ -42,7 +43,8 @@ export declare class CreateFeatureUseCase {
     private readonly attachmentStorage;
     private readonly agentValidator;
     private readonly skillInjector;
-    constructor(featureRepo: IFeatureRepository, worktreeService: IWorktreeService, agentProcess: IFeatureAgentProcessService, runRepository: IAgentRunRepository, specInitializer: ISpecInitializerService, metadataGenerator: MetadataGenerator, slugResolver: SlugResolver, repositoryRepo: IRepositoryRepository, gitPrService: IGitPrService, attachmentStorage: AttachmentStorageService, agentValidator: IAgentValidator, skillInjector: ISkillInjectorService);
+    private readonly settingsReader;
+    constructor(featureRepo: IFeatureRepository, worktreeService: IWorktreeService, agentProcess: IFeatureAgentProcessService, runRepository: IAgentRunRepository, specInitializer: ISpecInitializerService, metadataGenerator: MetadataGenerator, slugResolver: SlugResolver, repositoryRepo: IRepositoryRepository, gitPrService: IGitPrService, attachmentStorage: AttachmentStorageService, agentValidator: IAgentValidator, skillInjector: ISkillInjectorService, settingsReader: ISettingsReader);
     /**
      * Full synchronous execution: creates record, initializes worktree/spec, spawns agent.
      * Used by the CLI which shows a spinner and needs everything done before returning.

package/dist/packages/core/src/application/use-cases/features/create/create-feature.use-case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/use-cases/features/create/create-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AAMtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oEAAoE,CAAC;AAC7G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8DAA8D,CAAC;AACrG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iEAAiE,CAAC;AACnH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gEAAgE,CAAC;AAC1G,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8DAA8D,CAAC;AAC5G,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uEAAuE,CAAC;AACnH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4DAA4D,CAAC;AAChG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2DAA2D,CAAC;AACjG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AAIxG,OAAO,EAAE,wBAAwB,EAAE,MAAM,mEAAmE,CAAC;AAC7G,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE9F,qBACa,oBAAoB;IAG7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAtBb,WAAW,EAAE,kBAAkB,EAE/B,eAAe,EAAE,gBAAgB,EAEjC,YAAY,EAAE,2BAA2B,EAEzC,aAAa,EAAE,mBAAmB,EAElC,eAAe,EAAE,uBAAuB,EAExC,iBAAiB,EAAE,iBAAiB,EAEpC,YAAY,EAAE,YAAY,EAE1B,cAAc,EAAE,qBAAqB,EAErC,YAAY,EAAE,aAAa,EAE3B,iBAAiB,EAAE,wBAAwB,EAE3C,cAAc,EAAE,eAAe,EAE/B,aAAa,EAAE,qBAAqB;IAGvD;;;OAGG;IACG,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAMtE;;;;OAIG;IACG,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAyI1E;;;OAGG;IACG,kBAAkB,CACtB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,kBAAkB,EACzB,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,CAAC;CAsK1D"}
+{"version":3,"file":"create-feature.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/use-cases/features/create/create-feature.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AAMtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oEAAoE,CAAC;AAC7G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8DAA8D,CAAC;AACrG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iEAAiE,CAAC;AACnH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gEAAgE,CAAC;AAC1G,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8DAA8D,CAAC;AAC5G,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uEAAuE,CAAC;AACnH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4DAA4D,CAAC;AAChG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2DAA2D,CAAC;AACjG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AACxG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6DAA6D,CAAC;AAGnG,OAAO,EAAE,wBAAwB,EAAE,MAAM,mEAAmE,CAAC;AAC7G,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE9F,qBACa,oBAAoB;IAG7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAxBd,WAAW,EAAE,kBAAkB,EAE/B,eAAe,EAAE,gBAAgB,EAEjC,YAAY,EAAE,2BAA2B,EAEzC,aAAa,EAAE,mBAAmB,EAElC,eAAe,EAAE,uBAAuB,EAExC,iBAAiB,EAAE,iBAAiB,EAEpC,YAAY,EAAE,YAAY,EAE1B,cAAc,EAAE,qBAAqB,EAErC,YAAY,EAAE,aAAa,EAE3B,iBAAiB,EAAE,wBAAwB,EAE3C,cAAc,EAAE,eAAe,EAE/B,aAAa,EAAE,qBAAqB,EAEpC,cAAc,EAAE,eAAe;IAGlD;;;OAGG;IACG,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAMtE;;;;OAIG;IACG,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAyI1E;;;OAGG;IACG,kBAAkB,CACtB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,kBAAkB,EACzB,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,CAAC;CAsK1D"}

package/dist/packages/core/src/application/use-cases/features/create/create-feature.use-case.js

@@ -30,7 +30,6 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 import { injectable, inject } from 'tsyringe';
 import { randomUUID } from 'node:crypto';
 import { SdlcLifecycle, AgentRunStatus, } from '../../../../domain/generated/output.js';
-import { getSettings } from '../../../../infrastructure/services/settings.service.js';
 import { createDefaultSettings } from '../../../../domain/factories/settings-defaults.factory.js';
 import { POST_IMPLEMENTATION } from '../../../../domain/lifecycle-gates.js';
 import { AttachmentStorageService } from '../../../../infrastructure/services/attachment-storage.service.js';
@@ -49,7 +48,8 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
     attachmentStorage;
     agentValidator;
     skillInjector;
-    constructor(featureRepo, worktreeService, agentProcess, runRepository, specInitializer, metadataGenerator, slugResolver, repositoryRepo, gitPrService, attachmentStorage, agentValidator, skillInjector) {
+    settingsReader;
+    constructor(featureRepo, worktreeService, agentProcess, runRepository, specInitializer, metadataGenerator, slugResolver, repositoryRepo, gitPrService, attachmentStorage, agentValidator, skillInjector, settingsReader) {
         this.featureRepo = featureRepo;
         this.worktreeService = worktreeService;
         this.agentProcess = agentProcess;
@@ -62,6 +62,7 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
         this.attachmentStorage = attachmentStorage;
         this.agentValidator = agentValidator;
         this.skillInjector = skillInjector;
+        this.settingsReader = settingsReader;
     }
     /**
      * Full synchronous execution: creates record, initializes worktree/spec, spawns agent.
@@ -176,7 +177,7 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
         };
         await this.featureRepo.create(feature);
         // Create agent run record (pending state — agent not spawned yet)
-        const settings = getSettings();
+        const settings = this.settingsReader.getSettings();
         const agentRun = {
             id: runId,
             agentType: input.agentType ?? settings.agent.type,
@@ -192,8 +193,8 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
                 : settings.models?.default
                     ? { modelId: settings.models.default }
                     : {}),
-            createdAt: now.toISOString(),
-            updatedAt: now.toISOString(),
+            createdAt: now,
+            updatedAt: now,
         };
         await this.runRepository.create(agentRun);
         return { feature, shouldSpawn };
@@ -260,7 +261,7 @@ let CreateFeatureUseCase = class CreateFeatureUseCase {
             }
         }
         // Inject curated skills into the worktree (opt-in, guarded by settings or CLI flag)
-        const settings = getSettings();
+        const settings = this.settingsReader.getSettings();
         const shouldInject = input.injectSkills ?? settings.workflow.skillInjection?.enabled ?? false;
         let injectedSkillNames;
         const skillConfig = settings.workflow.skillInjection ?? createDefaultSettings().workflow.skillInjection;
@@ -345,7 +346,8 @@ CreateFeatureUseCase = __decorate([
     __param(9, inject(AttachmentStorageService)),
     __param(10, inject('IAgentValidator')),
     __param(11, inject('ISkillInjectorService')),
+    __param(12, inject('ISettingsReader')),
     __metadata("design:paramtypes", [Object, Object, Object, Object, Object, MetadataGenerator,
-        SlugResolver, Object, Object, AttachmentStorageService, Object, Object])
+        SlugResolver, Object, Object, AttachmentStorageService, Object, Object, Object])
 ], CreateFeatureUseCase);
 export { CreateFeatureUseCase };

package/dist/packages/core/src/application/use-cases/features/rebase-feature-on-main.use-case.js

@@ -47,7 +47,7 @@ let RebaseFeatureOnMainUseCase = class RebaseFeatureOnMainUseCase {
             throw new Error(`Feature not found: "${featureId}"`);
         }
         // Create standalone agent run + phase timing for activity timeline
-        const now = new Date().toISOString();
+        const now = new Date();
         const agentRunId = randomUUID();
         const phaseTimingId = randomUUID();
         await this.agentRunRepo.create({
@@ -133,7 +133,7 @@ let RebaseFeatureOnMainUseCase = class RebaseFeatureOnMainUseCase {
         }
     }
     async completeTiming(agentRunId, phaseTimingId, startMs, exitCode, errorMessage) {
-        const completedAt = new Date().toISOString();
+        const completedAt = new Date();
         const durationMs = Date.now() - startMs;
         await this.phaseTimingRepo.update(phaseTimingId, {
             completedAt,