agentic-orchestrator 0.1.0

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

@@ -0,0 +1,189 @@
+import path from 'node:path';
+import { atomicWriteJson, readJson } from '../../core/fs.js';
+import { parseUnifiedDiff, touchedPathsFromDiff } from '../../core/patch.js';
+import { anyAreaMatch, normalizeRepoPath, sortResourcesDeterministically } from '../../core/path-rules.js';
+import { runGit } from '../../core/git.js';
+import { buildQaIndex, makeRequiredTests } from '../../core/qa-index.js';
+import { ERROR_CODES } from '../../core/error-codes.js';
+import { fail } from '../../core/response.js';
+function asArray(value) {
+    return Array.isArray(value) ? value : [];
+}
+function readObjectField(record, key) {
+    const value = record[key];
+    return value && typeof value === 'object' ? value : {};
+}
+function readHeldLocks(frontMatter) {
+    const locks = readObjectField(frontMatter, 'locks');
+    return asArray(locks.held).filter((item) => typeof item === 'string');
+}
+function normalizeFromWorktree(worktreePath, repoRoot, repoRelativeFromWorktree) {
+    const absolute = path.resolve(repoRoot, repoRelativeFromWorktree);
+    const maybeRelativeToWorktree = path.relative(worktreePath, absolute).replaceAll('\\\\', '/');
+    if (!maybeRelativeToWorktree.startsWith('../')) {
+        return maybeRelativeToWorktree;
+    }
+    return path.relative(repoRoot, absolute).replaceAll('\\\\', '/');
+}
+export class PatchService {
+    port;
+    constructor(port) {
+        this.port = port;
+    }
+    async loadAcceptedPlan(featureId) {
+        const plan = await readJson(this.port.planPath(featureId), null);
+        if (!plan && this.port.getPolicySnapshot().patch_policy.enforce_plan) {
+            throw {
+                normalizedResponse: fail(ERROR_CODES.PLAN_REQUIRED, 'Patch requires accepted plan', {
+                    feature_id: featureId,
+                    retryable: false,
+                    requires_human: true,
+                    suggested_next_actions: ['Submit plan before applying patches']
+                })
+            };
+        }
+        return plan;
+    }
+    requiredResourcesForPlan(plan) {
+        const resources = [];
+        const policy = this.port.getPolicySnapshot();
+        if (plan.contracts?.openapi === 'modify') {
+            resources.push(policy.locks.contract_to_resource.openapi);
+        }
+        if (plan.contracts?.events === 'modify') {
+            resources.push(policy.locks.contract_to_resource.events);
+        }
+        if (plan.contracts?.db === 'migration') {
+            resources.push(policy.locks.contract_to_resource.db);
+        }
+        return sortResourcesDeterministically(resources);
+    }
+    async assertPlanLocksHeld(featureId, plan) {
+        const state = await this.port.readState(featureId);
+        const held = new Set(readHeldLocks(state.frontMatter));
+        const required = await this.requiredResourcesForPlan(plan);
+        const missing = required.filter((resource) => !held.has(resource));
+        if (missing.length > 0) {
+            throw {
+                normalizedResponse: fail(ERROR_CODES.LOCK_NOT_HELD, 'Plan requires lock(s) that are not held', {
+                    feature_id: featureId,
+                    missing_resources: missing,
+                    retryable: true,
+                    requires_human: false,
+                    suggested_next_actions: ['Acquire required locks before applying patch']
+                })
+            };
+        }
+    }
+    async validatePatchPaths(featureId, parsedDiff, plan) {
+        const policy = this.port.getPolicySnapshot();
+        const repoRoot = this.port.getRepoRoot();
+        const matchingMode = policy.path_rules.matching;
+        const allowSymlinkTraversal = policy.path_rules.allow_symlink_traversal;
+        const touched = touchedPathsFromDiff(parsedDiff);
+        const normalizedTouched = [];
+        for (const touchedPath of touched) {
+            const normalized = await normalizeRepoPath(repoRoot, path.join(this.port.worktreePath(featureId), touchedPath), allowSymlinkTraversal)
+                .then((relativePath) => normalizeFromWorktree(this.port.worktreePath(featureId), repoRoot, relativePath))
+                .catch(async () => {
+                return await normalizeRepoPath(repoRoot, touchedPath, allowSymlinkTraversal);
+            });
+            normalizedTouched.push(normalized);
+        }
+        const allowed = asArray(plan?.allowed_areas);
+        const forbidden = asArray(plan?.forbidden_areas);
+        const protectedAreas = asArray(policy.protected_areas);
+        const plannedFiles = new Set([
+            ...asArray(plan?.files?.create),
+            ...asArray(plan?.files?.modify),
+            ...asArray(plan?.files?.delete)
+        ]);
+        const violations = [];
+        for (const filePath of normalizedTouched) {
+            if (policy.patch_policy.enforce_allowed_areas && allowed.length > 0 && !anyAreaMatch(filePath, allowed, matchingMode)) {
+                violations.push({ path: filePath, reason: 'outside_allowed_areas' });
+            }
+            if (forbidden.length > 0 && anyAreaMatch(filePath, forbidden, matchingMode)) {
+                violations.push({ path: filePath, reason: 'in_forbidden_areas' });
+            }
+            if (protectedAreas.length > 0 && anyAreaMatch(filePath, protectedAreas, matchingMode)) {
+                violations.push({ path: filePath, reason: 'in_protected_areas' });
+            }
+            if (plan && !plannedFiles.has(filePath)) {
+                violations.push({ path: filePath, reason: 'not_in_planned_file_set' });
+            }
+        }
+        if (violations.length > 0) {
+            throw {
+                normalizedResponse: fail(ERROR_CODES.PATCH_POLICY_VIOLATION, 'Patch violates plan/policy constraints', {
+                    feature_id: featureId,
+                    violations,
+                    retryable: false,
+                    requires_human: true
+                })
+            };
+        }
+        return normalizedTouched;
+    }
+    async repoApplyPatch(featureId, unifiedDiff) {
+        const plan = await this.loadAcceptedPlan(featureId);
+        const parsedDiff = parseUnifiedDiff(unifiedDiff);
+        await this.validatePatchPaths(featureId, parsedDiff, plan);
+        await this.assertPlanLocksHeld(featureId, plan ?? { contracts: { openapi: 'none', events: 'none', db: 'none' } });
+        const repoRoot = this.port.getRepoRoot();
+        const worktree = this.port.worktreePath(featureId);
+        const apply = await runGit(repoRoot, ['apply', '--whitespace=nowarn', '-'], {
+            cwd: worktree,
+            stdin: unifiedDiff
+        });
+        if (apply.code !== 0) {
+            throw {
+                normalizedResponse: fail(ERROR_CODES.GIT_FAILURE, 'git apply failed', {
+                    stderr: apply.stderr,
+                    retryable: true,
+                    requires_human: false
+                }, {
+                    command: ['git', 'apply', '--whitespace=nowarn', '-'],
+                    exit_code: apply.code
+                })
+            };
+        }
+        const status = await runGit(repoRoot, ['status', '--porcelain'], { cwd: worktree });
+        const changedFiles = (await runGit(repoRoot, ['diff', '--name-only'], { cwd: worktree })).stdout
+            .split('\n')
+            .map((line) => line.trim())
+            .filter(Boolean);
+        const previousQaIndex = await readJson(this.port.qaIndexPath(featureId), null);
+        const profileName = plan?.gate_profile ?? 'default';
+        const profile = this.port.getGatesConfig().profiles[profileName];
+        const requiredTests = makeRequiredTests(profileName, profile);
+        const qaIndex = buildQaIndex(featureId, parsedDiff, requiredTests, previousQaIndex);
+        const qaValidation = await this.port.validateSchema('qa_test_index.schema.json', qaIndex);
+        if (!qaValidation.valid) {
+            throw {
+                normalizedResponse: fail(ERROR_CODES.INTERNAL_ERROR, 'qa_test_index validation failed', {
+                    errors: qaValidation.errors,
+                    retryable: false,
+                    requires_human: true
+                })
+            };
+        }
+        await atomicWriteJson(this.port.qaIndexPath(featureId), qaIndex);
+        await this.port.updateState(featureId, null, (frontMatter, body) => Promise.resolve({
+            frontMatter: {
+                status: frontMatter.status,
+                gates: frontMatter.gates
+            },
+            body
+        }));
+        return {
+            data: {
+                feature_id: featureId,
+                changed_files: changedFiles,
+                status_porcelain: status.stdout.trim().split('\n').filter(Boolean),
+                qa_index_version: qaIndex.version
+            }
+        };
+    }
+}
+//# sourceMappingURL=patch-service.js.map

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

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

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

@@ -0,0 +1,60 @@
+type AnyRecord = Record<string, any>;
+type StateReadResult = {
+    frontMatter: AnyRecord;
+};
+type StateUpdater = (frontMatter: AnyRecord, body: string) => Promise<{
+    frontMatter?: AnyRecord;
+    body?: string;
+}>;
+export interface PlanServicePort {
+    getPolicySnapshot(): AnyRecord;
+    planPath(featureId: string): string;
+    featureDiscoverSpecs(): Promise<{
+        data: {
+            specs: Array<{
+                feature_id: string;
+            }>;
+        };
+    }>;
+    readState(featureId: string): Promise<StateReadResult>;
+    validateSchema(schemaName: string, value: unknown): Promise<{
+        valid: boolean;
+        errors?: unknown;
+    }>;
+    withFeatureLock<T>(featureId: string, operation: () => Promise<T>): Promise<T>;
+    withIndexLock<T>(operation: () => Promise<T>): Promise<T>;
+    readIndex(): Promise<AnyRecord>;
+    writeIndex(index: AnyRecord): Promise<void>;
+    updateState(featureId: string, expectedVersion: number | null, updater: StateUpdater): Promise<AnyRecord>;
+}
+export declare class PlanService {
+    private readonly port;
+    constructor(port: PlanServicePort);
+    planGet(featureId: string): Promise<{
+        data: {
+            feature_id: string;
+            plan: unknown;
+        };
+    }>;
+    collectAcceptedPlans(excludeFeatureId?: string | null): Promise<AnyRecord[]>;
+    requiredResourcesForPlan(plan: AnyRecord): string[];
+    assertPlanLocksHeld(featureId: string, plan: AnyRecord): Promise<void>;
+    validatePlanRevisionRules(existingPlan: AnyRecord | null, plan: AnyRecord, expectedPlanVersion?: number | null): void;
+    validatePlanSchema(plan: AnyRecord): Promise<void>;
+    checkPlanCollision(featureId: string, plan: AnyRecord): Promise<unknown>;
+    planSubmit(featureId: string | null, plan: AnyRecord | null, expectedVersion?: number | null): Promise<{
+        data: {
+            feature_id: string | null;
+            accepted: boolean;
+            plan_version: number;
+        };
+    }>;
+    planUpdate(featureId: string | null, expectedPlanVersion: number | null, plan: AnyRecord | null): Promise<{
+        data: {
+            feature_id: string | null;
+            accepted: boolean;
+            plan_version: number;
+        };
+    }>;
+}
+export {};

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

@@ -0,0 +1,234 @@
+import { atomicWriteJson, nowIso, readJson } from '../../core/fs.js';
+import { detectPlanCollisions } from '../../core/collisions.js';
+import { sortResourcesDeterministically } from '../../core/path-rules.js';
+import { ERROR_CODES } from '../../core/error-codes.js';
+import { fail } from '../../core/response.js';
+import { GATE_RESULT, STATUS } from '../../core/constants.js';
+function asArray(value) {
+    return Array.isArray(value) ? value : [];
+}
+function normalizeSet(array) {
+    return [...new Set(array)].sort((a, b) => a.localeCompare(b));
+}
+function readObjectField(record, key) {
+    const value = record[key];
+    return value && typeof value === 'object' ? value : {};
+}
+function readHeldLocks(frontMatter) {
+    const locks = readObjectField(frontMatter, 'locks');
+    return asArray(locks.held).filter((item) => typeof item === 'string');
+}
+export class PlanService {
+    port;
+    constructor(port) {
+        this.port = port;
+    }
+    async planGet(featureId) {
+        const plan = await readJson(this.port.planPath(featureId), null);
+        return {
+            data: {
+                feature_id: featureId,
+                plan
+            }
+        };
+    }
+    async collectAcceptedPlans(excludeFeatureId = null) {
+        const specs = await this.port.featureDiscoverSpecs();
+        const plans = [];
+        for (const item of specs.data.specs) {
+            if (item.feature_id === excludeFeatureId) {
+                continue;
+            }
+            const plan = await readJson(this.port.planPath(item.feature_id), null);
+            if (plan) {
+                plans.push(plan);
+            }
+        }
+        return plans;
+    }
+    requiredResourcesForPlan(plan) {
+        const resources = [];
+        const policy = this.port.getPolicySnapshot();
+        if (plan.contracts?.openapi === 'modify') {
+            resources.push(policy.locks.contract_to_resource.openapi);
+        }
+        if (plan.contracts?.events === 'modify') {
+            resources.push(policy.locks.contract_to_resource.events);
+        }
+        if (plan.contracts?.db === 'migration') {
+            resources.push(policy.locks.contract_to_resource.db);
+        }
+        return sortResourcesDeterministically(resources);
+    }
+    async assertPlanLocksHeld(featureId, plan) {
+        const state = await this.port.readState(featureId);
+        const held = new Set(readHeldLocks(state.frontMatter));
+        const required = await this.requiredResourcesForPlan(plan);
+        const missing = required.filter((resource) => !held.has(resource));
+        if (missing.length > 0) {
+            throw {
+                normalizedResponse: fail(ERROR_CODES.LOCK_NOT_HELD, 'Plan requires lock(s) that are not held', {
+                    feature_id: featureId,
+                    missing_resources: missing,
+                    retryable: true,
+                    requires_human: false,
+                    suggested_next_actions: ['Acquire required locks before submitting plan']
+                })
+            };
+        }
+    }
+    validatePlanRevisionRules(existingPlan, plan, expectedPlanVersion = null) {
+        if (!existingPlan) {
+            if (plan.plan_version !== 1 || plan.revision_of != null) {
+                throw {
+                    normalizedResponse: fail(ERROR_CODES.PLAN_VALIDATION_FAILED, 'Initial plan must be version 1 without revision_of', {
+                        retryable: false,
+                        requires_human: true
+                    })
+                };
+            }
+            return;
+        }
+        if (expectedPlanVersion == null || existingPlan.plan_version !== expectedPlanVersion) {
+            throw {
+                normalizedResponse: fail(ERROR_CODES.VERSION_CONFLICT, 'Plan version conflict', {
+                    expected_plan_version: expectedPlanVersion,
+                    actual_plan_version: existingPlan.plan_version,
+                    retryable: true,
+                    requires_human: false
+                })
+            };
+        }
+        if (plan.plan_version !== expectedPlanVersion + 1 || plan.revision_of !== expectedPlanVersion) {
+            throw {
+                normalizedResponse: fail(ERROR_CODES.PLAN_VALIDATION_FAILED, 'Invalid plan revision metadata', {
+                    retryable: false,
+                    requires_human: true
+                })
+            };
+        }
+    }
+    async validatePlanSchema(plan) {
+        const validation = await this.port.validateSchema('plan.schema.json', plan);
+        if (!validation.valid) {
+            throw {
+                normalizedResponse: fail(ERROR_CODES.PLAN_VALIDATION_FAILED, 'plan.json failed schema validation', {
+                    errors: validation.errors,
+                    retryable: false,
+                    requires_human: true
+                })
+            };
+        }
+    }
+    async checkPlanCollision(featureId, plan) {
+        const policy = this.port.getPolicySnapshot();
+        const acceptedPlans = await this.collectAcceptedPlans(featureId);
+        const collisionResult = detectPlanCollisions(plan, acceptedPlans, policy);
+        if (!collisionResult.hasCollisions) {
+            return collisionResult;
+        }
+        if (policy.collision_policy === 'reject') {
+            throw {
+                normalizedResponse: fail(ERROR_CODES.COLLISION_DETECTED, 'Plan collides with accepted plans', {
+                    feature_id: featureId,
+                    collisions: collisionResult.collisions,
+                    collision_fingerprint: collisionResult.fingerprint,
+                    conflicting_feature_ids: normalizeSet(collisionResult.collisions.files
+                        .map((x) => x.with_feature_id)
+                        .concat(collisionResult.collisions.areas.map((x) => x.with_feature_id), collisionResult.collisions.contracts.map((x) => x.with_feature_id))),
+                    retryable: false,
+                    requires_human: true,
+                    suggested_next_actions: [
+                        'Acquire relevant lock and resubmit',
+                        'Revise plan scope to avoid overlap',
+                        'Create shared prerequisite feature'
+                    ]
+                })
+            };
+        }
+        await this.port.withIndexLock(async () => {
+            const index = await this.port.readIndex();
+            index.blocked_queue.push({
+                feature_id: featureId,
+                plan_version: plan.plan_version,
+                detected_at: nowIso(),
+                collision_fingerprint: collisionResult.fingerprint,
+                required_resources: await this.requiredResourcesForPlan(plan),
+                plan_snapshot: plan
+            });
+            index.blocked_queue.sort((a, b) => a.detected_at.localeCompare(b.detected_at) || a.feature_id.localeCompare(b.feature_id));
+            index.version += 1;
+            index.updated_at = nowIso();
+            await this.port.writeIndex(index);
+        });
+        throw {
+            normalizedResponse: fail(ERROR_CODES.BLOCKED_BY_COLLISION_POLICY, 'Plan queued due to collision policy=block', {
+                feature_id: featureId,
+                collision_fingerprint: collisionResult.fingerprint,
+                collisions: collisionResult.collisions,
+                retryable: true,
+                requires_human: false
+            })
+        };
+    }
+    async planSubmit(featureId, plan, expectedVersion = null) {
+        if (!plan || typeof plan !== 'object') {
+            throw {
+                normalizedResponse: fail(ERROR_CODES.INVALID_ARGUMENT, 'plan_json is required', {
+                    retryable: false,
+                    requires_human: true
+                })
+            };
+        }
+        if (plan.feature_id !== featureId) {
+            throw {
+                normalizedResponse: fail(ERROR_CODES.INVALID_ARGUMENT, 'plan.feature_id must match feature_id', {
+                    feature_id: featureId,
+                    plan_feature_id: plan.feature_id,
+                    retryable: false,
+                    requires_human: true
+                })
+            };
+        }
+        await this.validatePlanSchema(plan);
+        await this.assertPlanLocksHeld(featureId, plan);
+        const existing = await readJson(this.port.planPath(featureId), null);
+        this.validatePlanRevisionRules(existing, plan, expectedVersion);
+        await this.checkPlanCollision(featureId, plan);
+        await this.port.withFeatureLock(featureId, async () => {
+            await atomicWriteJson(this.port.planPath(featureId), plan);
+        });
+        await this.port.updateState(featureId, null, (frontMatter, body) => {
+            const nextStatus = frontMatter.status === STATUS.PLANNING || frontMatter.status === STATUS.BLOCKED
+                ? STATUS.BUILDING
+                : frontMatter.status;
+            return Promise.resolve({
+                frontMatter: {
+                    gate_profile: plan.gate_profile,
+                    gates: {
+                        ...frontMatter.gates,
+                        plan: GATE_RESULT.PASS
+                    },
+                    status: nextStatus,
+                    collisions: {
+                        files: [],
+                        areas: [],
+                        contracts: []
+                    }
+                },
+                body
+            });
+        });
+        return {
+            data: {
+                feature_id: featureId,
+                accepted: true,
+                plan_version: plan.plan_version
+            }
+        };
+    }
+    async planUpdate(featureId, expectedPlanVersion, plan) {
+        return await this.planSubmit(featureId, plan, expectedPlanVersion);
+    }
+}
+//# sourceMappingURL=plan-service.js.map

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

@@ -0,0 +1 @@
+{"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/qa-index-service.d.ts

@@ -0,0 +1,26 @@
+type AnyRecord = Record<string, any>;
+export interface QaIndexServicePort {
+    qaIndexPath(featureId: string): string;
+    validateSchema(schemaName: string, value: unknown): Promise<{
+        valid: boolean;
+        errors?: unknown;
+    }>;
+}
+export declare class QaIndexService {
+    private readonly port;
+    constructor(port: QaIndexServicePort);
+    qaTestIndexGet(featureId: string): Promise<{
+        data: {
+            index: AnyRecord;
+            summary: AnyRecord;
+            pending_required_tests: AnyRecord;
+        };
+    }>;
+    qaTestIndexUpdate(featureId: string, expectedVersion: number | null, updates: unknown, evidenceRefs: unknown[]): Promise<{
+        data: {
+            feature_id: string;
+            version: number;
+        };
+    }>;
+}
+export {};

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

@@ -0,0 +1,66 @@
+import { atomicWriteJson, readJson, stableHash } from '../../core/fs.js';
+import { applyQaUpdates, summarizeQaIndex } from '../../core/qa-index.js';
+import { ERROR_CODES } from '../../core/error-codes.js';
+import { fail } from '../../core/response.js';
+export class QaIndexService {
+    port;
+    constructor(port) {
+        this.port = port;
+    }
+    async qaTestIndexGet(featureId) {
+        const index = await readJson(this.port.qaIndexPath(featureId), {
+            feature_id: featureId,
+            version: 1,
+            source_diff_ref: stableHash('empty'),
+            items: []
+        });
+        const validation = await this.port.validateSchema('qa_test_index.schema.json', index);
+        if (!validation.valid) {
+            throw {
+                normalizedResponse: fail(ERROR_CODES.INTERNAL_ERROR, 'qa_test_index file is invalid', {
+                    errors: validation.errors,
+                    retryable: false,
+                    requires_human: true
+                })
+            };
+        }
+        const summary = summarizeQaIndex(index);
+        return {
+            data: {
+                index,
+                summary: summary.summary,
+                pending_required_tests: summary.pending_by_file
+            }
+        };
+    }
+    async qaTestIndexUpdate(featureId, expectedVersion, updates, evidenceRefs) {
+        const current = await readJson(this.port.qaIndexPath(featureId), null);
+        if (!current) {
+            throw {
+                normalizedResponse: fail(ERROR_CODES.FILE_NOT_FOUND, 'qa_test_index.json not found', {
+                    retryable: false,
+                    requires_human: true
+                })
+            };
+        }
+        const next = applyQaUpdates(current, expectedVersion, updates, evidenceRefs);
+        const validation = await this.port.validateSchema('qa_test_index.schema.json', next);
+        if (!validation.valid) {
+            throw {
+                normalizedResponse: fail(ERROR_CODES.INTERNAL_ERROR, 'qa_test_index update failed validation', {
+                    errors: validation.errors,
+                    retryable: false,
+                    requires_human: true
+                })
+            };
+        }
+        await atomicWriteJson(this.port.qaIndexPath(featureId), next);
+        return {
+            data: {
+                feature_id: featureId,
+                version: next.version
+            }
+        };
+    }
+}
+//# sourceMappingURL=qa-index-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qa-index-service.js","sourceRoot":"","sources":["../../../../../apps/control-plane/src/application/services/qa-index-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAU9C,MAAM,OAAO,cAAc;IACR,IAAI,CAAqB;IAE1C,YAAY,IAAwB;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,SAAiB;QAOpC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE;YAC7D,UAAU,EAAE,SAAS;YACrB,OAAO,EAAE,CAAC;YACV,eAAe,EAAE,UAAU,CAAC,OAAO,CAAC;YACpC,KAAK,EAAE,EAAE;SACV,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;QACtF,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACtB,MAAM;gBACJ,kBAAkB,EAAE,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,+BAA+B,EAAE;oBACpF,MAAM,EAAE,UAAU,CAAC,MAAM;oBACzB,SAAS,EAAE,KAAK;oBAChB,cAAc,EAAE,IAAI;iBACrB,CAAC;aACH,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACxC,OAAO;YACL,IAAI,EAAE;gBACJ,KAAK;gBACL,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,sBAAsB,EAAE,OAAO,CAAC,eAAe;aAChD;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,SAAiB,EACjB,eAA8B,EAC9B,OAAgB,EAChB,YAAuB;QAEvB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;QACvE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM;gBACJ,kBAAkB,EAAE,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,8BAA8B,EAAE;oBACnF,SAAS,EAAE,KAAK;oBAChB,cAAc,EAAE,IAAI;iBACrB,CAAC;aACH,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,cAAc,CACzB,OAAO,EACP,eAAe,EACf,OAA+C,EAC/C,YAAoD,CACrD,CAAC;QACF,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,2BAA2B,EAAE,IAAI,CAAC,CAAC;QACrF,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACtB,MAAM;gBACJ,kBAAkB,EAAE,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,wCAAwC,EAAE;oBAC7F,MAAM,EAAE,UAAU,CAAC,MAAM;oBACzB,SAAS,EAAE,KAAK;oBAChB,cAAc,EAAE,IAAI;iBACrB,CAAC;aACH,CAAC;QACJ,CAAC;QAED,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;QAE9D,OAAO;YACL,IAAI,EAAE;gBACJ,UAAU,EAAE,SAAS;gBACrB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB;SACF,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,47 @@
+type AnyRecord = Record<string, any>;
+export interface ReportingServicePort {
+    collectAcceptedPlans(excludeFeatureId?: string | null): Promise<AnyRecord[]>;
+    getPolicySnapshot(): AnyRecord;
+    readIndex(): Promise<AnyRecord>;
+    statePath(featureId: string): string;
+    readState(featureId: string): Promise<{
+        frontMatter: AnyRecord;
+    }>;
+    featureStateGet(featureId: string): Promise<{
+        data: {
+            front_matter: AnyRecord;
+        };
+    }>;
+    repoDiffBundle(featureId: string): Promise<{
+        data: AnyRecord;
+    }>;
+    qaTestIndexGet(featureId: string): Promise<{
+        data: AnyRecord;
+    }>;
+}
+export declare class ReportingService {
+    private readonly port;
+    constructor(port: ReportingServicePort);
+    collisionsScan(): Promise<{
+        data: {
+            collisions: any[];
+        };
+    }>;
+    reportDashboard(): Promise<{
+        data: {
+            index: AnyRecord;
+            features: any[];
+        };
+    }>;
+    reportFeatureSummary(featureId: string | null): Promise<{
+        data: {
+            feature_id: string;
+            state: AnyRecord;
+            diff_stat: any;
+            touched_files: any;
+            last_gate_summary: any;
+            qa_summary: any;
+        };
+    }>;
+}
+export {};