agentic-orchestrator 0.1.25 → 0.1.26

package/dist/apps/control-plane/application/services/plan-service.js

@@ -20,6 +20,57 @@ function readHeldLocks(frontMatter) {
     const locks = readObjectField(frontMatter, 'locks');
     return asArray(locks.held).filter((item) => typeof item === 'string');
 }
+/**
+ * Manages plan submission, validation, and collision detection.
+ *
+ * ## Responsibilities
+ * - Validate plan schema and policy compliance
+ * - Detect file/area/contract collisions with other features
+ * - Enforce lock requirements for protected resources
+ * - Manage plan versioning with optimistic concurrency
+ * - Select appropriate gate profiles based on plan intent
+ *
+ * ## Dependencies
+ * Depends on {@link PlanServicePort} for:
+ * - Policy and schema access
+ * - State and index operations
+ * - File locking primitives
+ *
+ * ## Key Methods
+ * - `planSubmit()` - submit initial plan with full validation
+ * - `planUpdate()` - submit versioned plan revision
+ * - `planGet()` - retrieve accepted plan
+ * - `checkPlanCollision()` - detect collisions with other features
+ * - `assertPlanLocksHeld()` - verify required locks are held
+ *
+ * ## Error Conditions
+ * - SCHEMA_VALIDATION_FAILED - plan fails JSON schema validation
+ * - PLAN_COLLISION - file/area/contract conflicts with another feature
+ * - LOCK_NOT_HELD - required resource locks not acquired
+ * - VERSION_CONFLICT - plan version mismatch (concurrent update)
+ * - DEPENDENCY_CYCLE - circular feature dependencies detected
+ *
+ * ## Thread Safety
+ * All mutations are protected by feature-level or index-level locks.
+ * Concurrent reads are safe. Concurrent writes are serialized.
+ *
+ * @example
+ * ```typescript
+ * const planService = new PlanService(port);
+ *
+ * // Submit initial plan
+ * await planService.planSubmit('my_feature', planData, null);
+ *
+ * // Update plan with version guard
+ * await planService.planUpdate('my_feature', updatedPlan, 1);
+ *
+ * // Check for collisions
+ * const result = await planService.checkPlanCollision('my_feature', planData);
+ * ```
+ *
+ * @see CollisionDetector - for collision detection algorithm
+ * @see GateSelectionService - for gate profile selection
+ */
 export class PlanService {
     port;
     gateSelectionService;
@@ -27,6 +78,19 @@ export class PlanService {
         this.port = port;
         this.gateSelectionService = new GateSelectionService(port);
     }
+    /**
+     * Retrieves the accepted plan for a feature.
+     *
+     * @param featureId - feature identifier
+     * @returns Plan data wrapped in success response
+     * @throws FILE_NOT_FOUND - plan file does not exist
+     *
+     * @example
+     * ```typescript
+     * const result = await planService.planGet('my_feature');
+     * console.log(result.data.plan);
+     * ```
+     */
     async planGet(featureId) {
         const plan = await readJson(this.port.planPath(featureId), null);
         return {
@@ -36,6 +100,20 @@ export class PlanService {
             },
         };
     }
+    /**
+     * Collects all accepted plans from discovered features.
+     *
+     * Used for collision detection and dependency analysis.
+     *
+     * @param excludeFeatureId - optional feature to exclude from collection
+     * @returns Array of plan objects
+     *
+     * @example
+     * ```typescript
+     * // Get all plans except current feature
+     * const plans = await planService.collectAcceptedPlans('my_feature');
+     * ```
+     */
     async collectAcceptedPlans(excludeFeatureId = null) {
         const specs = await this.port.featureDiscoverSpecs();
         const plans = [];
@@ -50,6 +128,20 @@ export class PlanService {
         }
         return plans;
     }
+    /**
+     * Determines required resource locks based on plan contracts.
+     *
+     * Maps contract modifications to resource identifiers per policy.
+     *
+     * @param plan - plan object with contracts section
+     * @returns Sorted array of required resource identifiers
+     *
+     * @example
+     * ```typescript
+     * const resources = planService.requiredResourcesForPlan(plan);
+     * // ['openapi', 'db_migrations']
+     * ```
+     */
     requiredResourcesForPlan(plan) {
         const resources = [];
         const policy = this.port.getPolicySnapshot();
@@ -64,6 +156,18 @@ export class PlanService {
         }
         return sortResourcesDeterministically(resources);
     }
+    /**
+     * Verifies that all required resource locks are held by the feature.
+     *
+     * @param featureId - feature identifier
+     * @param plan - plan object requiring locks
+     * @throws LOCK_NOT_HELD - required locks are not held
+     *
+     * @example
+     * ```typescript
+     * await planService.assertPlanLocksHeld('my_feature', plan);
+     * ```
+     */
     async assertPlanLocksHeld(featureId, plan) {
         const state = await this.port.readState(featureId);
         const held = new Set(readHeldLocks(state.frontMatter));
@@ -81,6 +185,20 @@ export class PlanService {
             };
         }
     }
+    /**
+     * Validates plan revision rules for versioning and optimistic concurrency.
+     *
+     * Enforces:
+     * - Initial plans must be version 1 without revision_of
+     * - Updates must increment version and reference previous version
+     * - Version guard must match current plan version
+     *
+     * @param existingPlan - current plan or null for initial submission
+     * @param plan - new plan to validate
+     * @param expectedPlanVersion - expected current version for concurrency guard
+     * @throws PLAN_VALIDATION_FAILED - revision rules violated
+     * @throws VERSION_CONFLICT - version mismatch (concurrent update)
+     */
     validatePlanRevisionRules(existingPlan, plan, expectedPlanVersion = null) {
         if (!existingPlan) {
             if (plan.plan_version !== 1 || plan.revision_of != null) {
@@ -112,6 +230,17 @@ export class PlanService {
             };
         }
     }
+    /**
+     * Validates plan against JSON schema.
+     *
+     * @param plan - plan object to validate
+     * @throws SCHEMA_VALIDATION_FAILED - plan does not conform to schema
+     *
+     * @example
+     * ```typescript
+     * await planService.validatePlanSchema(planData);
+     * ```
+     */
     async validatePlanSchema(plan) {
         const validation = await this.port.validateSchema('plan.schema.json', plan);
         if (!validation.valid) {
@@ -124,6 +253,24 @@ export class PlanService {
             };
         }
     }
+    /**
+     * Detects file, area, and contract collisions with other features.
+     *
+     * Compares plan against all accepted plans to find conflicts.
+     *
+     * @param featureId - feature identifier
+     * @param plan - plan to check for collisions
+     * @returns Collision matrix with conflicts by feature
+     * @throws PLAN_COLLISION - collisions detected (per policy)
+     *
+     * @example
+     * ```typescript
+     * const result = await planService.checkPlanCollision('my_feature', plan);
+     * if (result.data.has_collisions) {
+     *   console.log(result.data.collisions);
+     * }
+     * ```
+     */
     async checkPlanCollision(featureId, plan) {
         const policy = this.port.getPolicySnapshot();
         const acceptedPlans = await this.collectAcceptedPlans(featureId);
@@ -175,6 +322,17 @@ export class PlanService {
             }),
         };
     }
+    /**
+     * Validates feature dependencies and detects circular references.
+     *
+     * @param featureId - feature to check (null checks all features)
+     * @throws DEPENDENCY_CYCLE - circular dependency detected
+     *
+     * @example
+     * ```typescript
+     * await planService.checkDependencies('my_feature');
+     * ```
+     */
     async checkDependencies(featureId) {
         if (!featureId) {
             return;
@@ -225,6 +383,33 @@ export class PlanService {
             };
         }
     }
+    /**
+     * Submits initial plan with full validation pipeline.
+     *
+     * Validation steps:
+     * 1. Schema validation
+     * 2. Revision rules check
+     * 3. Lock requirement verification
+     * 4. Collision detection
+     * 5. Dependency cycle check
+     * 6. Gate profile selection
+     *
+     * @param featureId - feature identifier
+     * @param plan - plan object to submit
+     * @param expectedVersion - expected state version for concurrency guard
+     * @returns Acceptance result with plan version
+     * @throws INVALID_ARGUMENT - missing or invalid plan
+     * @throws SCHEMA_VALIDATION_FAILED - plan schema invalid
+     * @throws LOCK_NOT_HELD - required locks not held
+     * @throws PLAN_COLLISION - collisions detected
+     * @throws DEPENDENCY_CYCLE - circular dependencies
+     *
+     * @example
+     * ```typescript
+     * const result = await planService.planSubmit('my_feature', planData, null);
+     * console.log(`Plan accepted: version ${result.data.plan_version}`);
+     * ```
+     */
     async planSubmit(featureId, plan, expectedVersion = null) {
         if (!plan || typeof plan !== 'object') {
             throw {
@@ -289,6 +474,28 @@ export class PlanService {
             },
         };
     }
+    /**
+     * Submits versioned plan revision with full revalidation.
+     *
+     * Requires plan_version to be current_version + 1 and revision_of
+     * to reference current version. Runs full validation pipeline.
+     *
+     * @param featureId - feature identifier
+     * @param plan - updated plan object
+     * @param expectedPlanVersion - expected current plan version
+     * @returns Acceptance result with new plan version
+     * @throws VERSION_CONFLICT - plan version mismatch
+     * @throws PLAN_VALIDATION_FAILED - revision rules violated
+     * @throws SCHEMA_VALIDATION_FAILED - plan schema invalid
+     * @throws LOCK_NOT_HELD - required locks not held
+     * @throws PLAN_COLLISION - collisions detected
+     *
+     * @example
+     * ```typescript
+     * // Update plan from version 1 to version 2
+     * const result = await planService.planUpdate('my_feature', updatedPlan, 1);
+     * ```
+     */
     async planUpdate(featureId, expectedPlanVersion, plan) {
         return await this.planSubmit(featureId, plan, expectedPlanVersion);
     }

package/dist/apps/control-plane/application/services/plan-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"plan-service.js","sourceRoot":"","sources":["../../../../../apps/control-plane/src/application/services/plan-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plan-service.js","sourceRoot":"","sources":["../../../../../apps/control-plane/src/application/services/plan-service.ts"],"names":[],"mappings":"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"}

package/dist/apps/control-plane/application/services/pr-monitor-service.d.ts

@@ -30,15 +30,73 @@ export interface PrMonitorServiceDependencies {
     };
     ghRunner?: GhRunner;
 }
+/**
+ * Monitors pull request status and handles review feedback.
+ *
+ * ## Responsibilities
+ * - Detect PRs for feature branches
+ * - Monitor PR status and review decisions
+ * - Handle changes_requested events
+ * - Store PR metadata in feature state
+ *
+ * ## Dependencies
+ * - {@link SupervisorToolCaller} - for tool invocation
+ * - {@link NotifierService} - for PR notifications
+ * - GitHub CLI - for PR queries
+ *
+ * ## Key Methods
+ * - `detectPr()` - detect PR for feature branch
+ * - `checkAndUpdate()` - check PR status and update state
+ * - `handleChangesRequested()` - handle review feedback
+ * - `storePrState()` - persist PR metadata
+ *
+ * ## Error Conditions
+ * - PR detection failures are logged but don't block
+ *
+ * @example
+ * ```typescript
+ * const prMonitor = new PrMonitorService({ toolCaller, notifier });
+ * const pr = await prMonitor.detectPr('my_feature', 'my_feature');
+ * if (pr) {
+ *   await prMonitor.checkAndUpdate('my_feature', 'my_feature');
+ * }
+ * ```
+ */
 export declare class PrMonitorService {
     private readonly toolCaller;
     private readonly notifier;
     private readonly reactionsPolicy;
     private readonly ghRunner;
     constructor(dependencies: PrMonitorServiceDependencies);
+    /**
+     * Detects PR for feature branch.
+     *
+     * @param featureId - feature identifier
+     * @param branch - branch name
+     * @returns PR info or null if not found
+     */
     detectPr(featureId: string, branch: string): Promise<PrInfo | null>;
+    /**
+     * Stores PR metadata in feature state.
+     *
+     * @param featureId - feature identifier
+     * @param prInfo - PR information
+     */
     storePrState(featureId: string, prInfo: PrInfo): Promise<void>;
     computeMergeScore(prInfo: PrInfo): number;
+    /**
+     * Handles changes_requested review decision.
+     *
+     * @param featureId - feature identifier
+     * @param prInfo - PR information with review decision
+     */
     handleChangesRequested(featureId: string, prInfo: PrInfo): Promise<void>;
+    /**
+     * Checks PR status and updates feature state.
+     *
+     * @param featureId - feature identifier
+     * @param branch - branch name
+     * @returns Updated PR info or null
+     */
     checkAndUpdate(featureId: string, branch: string): Promise<PrInfo | null>;
 }

package/dist/apps/control-plane/application/services/pr-monitor-service.js

@@ -49,6 +49,38 @@ function mapReviewDecision(decision) {
             return 'none';
     }
 }
+/**
+ * Monitors pull request status and handles review feedback.
+ *
+ * ## Responsibilities
+ * - Detect PRs for feature branches
+ * - Monitor PR status and review decisions
+ * - Handle changes_requested events
+ * - Store PR metadata in feature state
+ *
+ * ## Dependencies
+ * - {@link SupervisorToolCaller} - for tool invocation
+ * - {@link NotifierService} - for PR notifications
+ * - GitHub CLI - for PR queries
+ *
+ * ## Key Methods
+ * - `detectPr()` - detect PR for feature branch
+ * - `checkAndUpdate()` - check PR status and update state
+ * - `handleChangesRequested()` - handle review feedback
+ * - `storePrState()` - persist PR metadata
+ *
+ * ## Error Conditions
+ * - PR detection failures are logged but don't block
+ *
+ * @example
+ * ```typescript
+ * const prMonitor = new PrMonitorService({ toolCaller, notifier });
+ * const pr = await prMonitor.detectPr('my_feature', 'my_feature');
+ * if (pr) {
+ *   await prMonitor.checkAndUpdate('my_feature', 'my_feature');
+ * }
+ * ```
+ */
 export class PrMonitorService {
     toolCaller;
     notifier;
@@ -60,6 +92,13 @@ export class PrMonitorService {
         this.reactionsPolicy = dependencies.reactionsPolicy;
         this.ghRunner = dependencies.ghRunner ?? createGhRunner();
     }
+    /**
+     * Detects PR for feature branch.
+     *
+     * @param featureId - feature identifier
+     * @param branch - branch name
+     * @returns PR info or null if not found
+     */
     async detectPr(featureId, branch) {
         const candidates = [
             ...new Set([branch, featureId, `feature/${featureId}`].map((value) => value.trim()).filter(Boolean)),
@@ -108,6 +147,12 @@ export class PrMonitorService {
         const merge_score = this.computeMergeScore({ ...partial, merge_score: 0 });
         return { ...partial, merge_score };
     }
+    /**
+     * Stores PR metadata in feature state.
+     *
+     * @param featureId - feature identifier
+     * @param prInfo - PR information
+     */
     async storePrState(featureId, prInfo) {
         const current = await this.toolCaller.callTool('orchestrator', TOOLS.FEATURE_STATE_GET, { feature_id: featureId });
         await this.toolCaller.callTool('orchestrator', TOOLS.FEATURE_STATE_PATCH, {
@@ -145,6 +190,12 @@ export class PrMonitorService {
         }
         return score;
     }
+    /**
+     * Handles changes_requested review decision.
+     *
+     * @param featureId - feature identifier
+     * @param prInfo - PR information with review decision
+     */
     async handleChangesRequested(featureId, prInfo) {
         const reaction = this.reactionsPolicy?.changes_requested;
         if (!reaction?.enabled) {
@@ -189,6 +240,13 @@ export class PrMonitorService {
             });
         }
     }
+    /**
+     * Checks PR status and updates feature state.
+     *
+     * @param featureId - feature identifier
+     * @param branch - branch name
+     * @returns Updated PR info or null
+     */
     async checkAndUpdate(featureId, branch) {
         const prInfo = await this.detectPr(featureId, branch);
         if (!prInfo) {

package/dist/apps/control-plane/application/services/pr-monitor-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"pr-monitor-service.js","sourceRoot":"","sources":["../../../../../apps/control-plane/src/application/services/pr-monitor-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pr-monitor-service.js","sourceRoot":"","sources":["../../../../../apps/control-plane/src/application/services/pr-monitor-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAOhD,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAwB1C,MAAM,UAAU,cAAc,CAAC,EAAa;IAC1C,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,EAAE,IAAc,EAAE,EAAE;QAC9B,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YACxE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACjC,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,GAA8B,CAAC;YACzC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC;gBAChD,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;YACvC,CAAC;YACD,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/D,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;QAClC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAsBD,SAAS,WAAW,CAAC,MAAmD;IACtE,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACvD,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,OAAO,CAAC,EAAE,CAAC;QACxD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IACE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,aAAa,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,SAAS,CAAC,EAChG,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAmC;IAC5D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,QAAQ,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;QAC/B,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB,KAAK,mBAAmB;YACtB,OAAO,mBAAmB,CAAC;QAC7B,KAAK,iBAAiB;YACpB,OAAO,SAAS,CAAC;QACnB;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,OAAO,gBAAgB;IACV,UAAU,CAAuB;IACjC,QAAQ,CAA8B;IACtC,eAAe,CAA6D;IAC5E,QAAQ,CAAW;IAEpC,YAAY,YAA0C;QACpD,IAAI,CAAC,UAAU,GAAG,YAAY,CAAC,UAAU,CAAC;QAC1C,IAAI,CAAC,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC;QACtC,IAAI,CAAC,eAAe,GAAG,YAAY,CAAC,eAAe,CAAC;QACpD,IAAI,CAAC,QAAQ,GAAG,YAAY,CAAC,QAAQ,IAAI,cAAc,EAAE,CAAC;IAC5D,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,MAAc;QAC9C,MAAM,UAAU,GAAG;YACjB,GAAG,IAAI,GAAG,CACR,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CACzF;SACF,CAAC;QACF,IAAI,MAAM,GAA0B,IAAI,CAAC;QACzC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC;gBACjC,IAAI;gBACJ,MAAM;gBACN,QAAQ;gBACR,SAAS;gBACT,QAAQ;gBACR,qEAAqE;aACtE,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;gBACnD,SAAS;YACX,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAmB,CAAC;gBAChE,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;oBACvB,MAAM,GAAG,WAAW,CAAC;oBACrB,MAAM;gBACR,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,iCAAiC;YACnC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACxD,MAAM,eAAe,GAAG,iBAAiB,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACjE,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,KAAK,aAAa,CAAC;QACzD,MAAM,WAAW,GACf,MAAM,CAAC,SAAS,KAAK,WAAW,IAAI,SAAS,KAAK,SAAS,IAAI,eAAe,KAAK,UAAU,CAAC;QAChG,MAAM,sBAAsB,GAAG,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;QAE9F,MAAM,OAAO,GAAgC;YAC3C,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,SAAS;YACT,eAAe;YACf,WAAW;YACX,sBAAsB;YACtB,aAAa;SACd,CAAC;QACF,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3E,OAAO,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAAC,SAAiB,EAAE,MAAc;QAClD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAC5C,cAAc,EACd,KAAK,CAAC,iBAAiB,EACvB,EAAE,UAAU,EAAE,SAAS,EAAE,CAC1B,CAAC;QAEF,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAC,mBAAmB,EAAE;YACxE,UAAU,EAAE,SAAS;YACrB,gBAAgB,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO;YACnD,KAAK,EAAE;gBACL,YAAY,EAAE;oBACZ,EAAE,EAAE;wBACF,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,GAAG,EAAE,MAAM,CAAC,GAAG;wBACf,SAAS,EAAE,MAAM,CAAC,SAAS;wBAC3B,eAAe,EAAE,MAAM,CAAC,eAAe;wBACvC,WAAW,EAAE,MAAM,CAAC,WAAW;wBAC/B,sBAAsB,EAAE,MAAM,CAAC,sBAAsB;wBACrD,aAAa,EAAE,MAAM,CAAC,aAAa;wBACnC,WAAW,EAAE,MAAM,CAAC,WAAW;qBAChC;iBACF;aACF;SACF,CAAC,CAAC;IACL,CAAC;IAED,iBAAiB,CAAC,MAAc;QAC9B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACnC,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;QACD,IAAI,MAAM,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;YAC1C,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC1B,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;QACD,IAAI,MAAM,CAAC,sBAAsB,KAAK,CAAC,EAAE,CAAC;YACxC,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,sBAAsB,CAAC,SAAiB,EAAE,MAAc;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,EAAE,iBAAiB,CAAC;QACzD,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,KAAK,8BAA8B,EAAE,CAAC;YACvD,OAAO;QACT,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC;YACvC,IAAI;YACJ,MAAM;YACN,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;YACrB,QAAQ;YACR,SAAS;SACV,CAAC,CAAC;QAEH,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,IAAI,YAAY,CAAC,QAAQ,KAAK,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9D,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAoB,CAAC;gBAClE,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAC/D,UAAU,GAAG,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC;YACtC,CAAC;YAAC,MAAM,CAAC;gBACP,sBAAsB;YACxB,CAAC;QACH,CAAC;QAED,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAC,kBAAkB,EAAE;YACvE,UAAU,EAAE,SAAS;YACrB,IAAI,EAAE,OAAO,MAAM,CAAC,MAAM,wCAAwC,UAAU,EAAE;SAC/E,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,UAAU;aAClB,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAC,oBAAoB,EAAE;YACpD,UAAU,EAAE,SAAS;YACrB,OAAO,EAAE,iCAAiC,UAAU,IAAI,2BAA2B,EAAE;SACtF,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAE1B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,mBAAmB,EAAE;gBAC9C,UAAU,EAAE,SAAS;gBACrB,OAAO,EAAE,OAAO,MAAM,CAAC,MAAM,uCAAuC,SAAS,IAAI;gBACjF,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE;aAC1D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,cAAc,CAAC,SAAiB,EAAE,MAAc;QACpD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAE3C,IAAI,MAAM,CAAC,eAAe,KAAK,mBAAmB,EAAE,CAAC;YACnD,MAAM,IAAI,CAAC,sBAAsB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACvD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/apps/control-plane/application/services/qa-index-service.d.ts

@@ -1,4 +1,7 @@
 type AnyRecord = Record<string, any>;
+/**
+ * @fileoverview QA test obligation tracking service.
+ */
 export interface QaIndexServicePort {
     qaIndexPath(featureId: string): string;
     validateSchema(schemaName: string, value: unknown): Promise<{
@@ -6,9 +9,56 @@ export interface QaIndexServicePort {
         errors?: unknown;
     }>;
 }
+/**
+ * Manages QA test obligation tracking.
+ *
+ * ## Responsibilities
+ * - Create qa_test_index.json from diff hunks
+ * - Track test status per hunk (pending/covered/skipped)
+ * - Link evidence to test obligations
+ * - Validate all obligations are resolved
+ *
+ * ## Dependencies
+ * Depends on {@link QaIndexServicePort} for:
+ * - QA index file path resolution
+ * - Schema validation
+ *
+ * ## Key Methods
+ * - `qaTestIndexGet()` - retrieve test index
+ * - `qaTestIndexUpdate()` - update hunk statuses with evidence
+ *
+ * ## Error Conditions
+ * - FILE_NOT_FOUND - index file does not exist
+ * - VERSION_CONFLICT - concurrent index update
+ * - SCHEMA_VALIDATION_FAILED - invalid index structure
+ *
+ * @example
+ * ```typescript
+ * const qaService = new QaIndexService(port);
+ * const index = await qaService.qaTestIndexGet('my_feature');
+ * await qaService.qaTestIndexUpdate('my_feature', updates, 1);
+ * ```
+ *
+ * ## Index Format
+ * Each hunk has: path, line range, required tests, status, evidence refs
+ */
 export declare class QaIndexService {
     private readonly port;
     constructor(port: QaIndexServicePort);
+    /**
+     * Retrieves QA test index for a feature.
+     *
+     * @param featureId - feature identifier
+     * @returns Test index with hunk obligations and pending summary
+     * @throws FILE_NOT_FOUND - index does not exist
+     *
+     * @example
+     * ```typescript
+     * const index = await qaService.qaTestIndexGet('my_feature');
+     * console.log(index.data.items);
+     * console.log(index.data.pending_obligations);
+     * ```
+     */
     qaTestIndexGet(featureId: string): Promise<{
         data: {
             index: AnyRecord;
@@ -16,6 +66,23 @@ export declare class QaIndexService {
             pending_required_tests: AnyRecord;
         };
     }>;
+    /**
+     * Updates hunk statuses with evidence references and version guard.
+     *
+     * @param featureId - feature identifier
+     * @param updates - hunk status updates with evidence refs
+     * @param expectedVersion - expected index version
+     * @returns Updated index
+     * @throws VERSION_CONFLICT - version mismatch
+     * @throws SCHEMA_VALIDATION_FAILED - invalid updates
+     *
+     * @example
+     * ```typescript
+     * await qaService.qaTestIndexUpdate('my_feature', {
+     *   items: [{ path: 'file.ts', status: 'covered', evidence_refs: ['gate_123'] }]
+     * }, 1);
+     * ```
+     */
     qaTestIndexUpdate(featureId: string, expectedVersion: number | null, updates: unknown, evidenceRefs: unknown[]): Promise<{
         data: {
             feature_id: string;