agentic-orchestrator 0.1.27 → 0.2.0

package/dist/apps/control-plane/supervisor/organizer-sidecar-service.js

@@ -0,0 +1,311 @@
+import { readFile, writeFile, rename } from 'node:fs/promises';
+import { stableHash, nowIso } from '../core/fs.js';
+const DEFAULT_POLL_INTERVAL_MS = 10_000;
+const DEFAULT_MAX_SPEC_CONTENT_BYTES = 102_400;
+const DEFAULT_ARTIFACT_TTL_MS = 120_000;
+export class OrganizerSidecarService {
+    provider;
+    organizerSessionId;
+    kernel;
+    state;
+    artifactPath;
+    schemaValidator;
+    pollIntervalMs;
+    maxSpecContentBytes;
+    artifactTtlMs;
+    lastFingerprint = null;
+    timer = null;
+    reconcileInFlight = null;
+    started = false;
+    constructor(deps) {
+        this.provider = deps.provider;
+        this.organizerSessionId = deps.organizerSessionId;
+        this.kernel = deps.kernel;
+        this.state = deps.state;
+        this.artifactPath = deps.artifactPath;
+        this.schemaValidator = deps.schemaValidator;
+        this.pollIntervalMs = deps.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+        this.maxSpecContentBytes = deps.maxSpecContentBytes ?? DEFAULT_MAX_SPEC_CONTENT_BYTES;
+        this.artifactTtlMs = deps.artifactTtlMs ?? DEFAULT_ARTIFACT_TTL_MS;
+    }
+    start() {
+        if (this.started) {
+            return;
+        }
+        this.started = true;
+        this.timer = setInterval(() => {
+            void this.reconcile();
+        }, this.pollIntervalMs);
+        if (typeof this.timer.unref === 'function') {
+            this.timer.unref();
+        }
+    }
+    async stop() {
+        this.started = false;
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        if (this.reconcileInFlight !== null) {
+            await this.reconcileInFlight;
+        }
+    }
+    async reconcile() {
+        if (this.reconcileInFlight !== null) {
+            await this.reconcileInFlight;
+            return;
+        }
+        this.reconcileInFlight = this.performReconcile()
+            .catch((error) => {
+            const message = error instanceof Error ? error.message : String(error);
+            console.warn(`[organizer-sidecar] reconcile failed: ${message}`);
+        })
+            .finally(() => {
+            this.reconcileInFlight = null;
+        });
+        await this.reconcileInFlight;
+    }
+    async performReconcile() {
+        // Guard: skip if organizer session is not yet established
+        const sessionId = this.organizerSessionId();
+        if (!sessionId || sessionId === 'unknown' || sessionId === 'unassigned') {
+            return;
+        }
+        const pendingRequests = await this.readPendingRequests();
+        const specs = await this.collectSpecs(pendingRequests);
+        if (specs.length === 0) {
+            return;
+        }
+        const requestIds = pendingRequests
+            .filter((item) => item.status === 'pending')
+            .map((item) => item.request_id)
+            .sort();
+        const fingerprint = this.computeFingerprint(specs, requestIds);
+        if (fingerprint === this.lastFingerprint) {
+            return;
+        }
+        const { prompt, partial } = this.buildPrompt(specs);
+        const artifact = await this.dispatchAndParse(prompt, partial, fingerprint, requestIds);
+        if (!artifact) {
+            return;
+        }
+        await this.writeArtifactAtomically(artifact);
+        this.lastFingerprint = fingerprint;
+    }
+    async readPendingRequests() {
+        try {
+            const pending = await this.kernel.drainPendingExecutionRequests(this.state.runId, this.state.ownerInstanceId);
+            return pending.data.items;
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            console.warn(`[organizer-sidecar] failed to read execution control: ${msg}`);
+            return [];
+        }
+    }
+    async collectSpecs(requests) {
+        const specMap = new Map();
+        // Source 1: execution control (pending requests)
+        for (const request of requests) {
+            if (request.status !== 'pending') {
+                continue;
+            }
+            for (const feature of request.features) {
+                if (!specMap.has(feature.feature_id)) {
+                    specMap.set(feature.feature_id, {
+                        spec_path: feature.spec_path,
+                        status: 'pending',
+                    });
+                }
+            }
+        }
+        // Source 2: active/queued features from runtime state
+        for (const featureId of this.state.sessionsByFeature.keys()) {
+            if (!specMap.has(featureId)) {
+                await this.addFeatureFromState(specMap, featureId);
+            }
+        }
+        for (const queued of this.state.queue) {
+            if (!specMap.has(queued.feature_id)) {
+                await this.addFeatureFromState(specMap, queued.feature_id);
+            }
+        }
+        // Read spec file contents
+        const entries = [];
+        for (const [featureId, meta] of specMap) {
+            try {
+                const content = await readFile(meta.spec_path, 'utf8');
+                entries.push({
+                    feature_id: featureId,
+                    spec_path: meta.spec_path,
+                    status: meta.status,
+                    content,
+                });
+            }
+            catch {
+                console.warn(`[organizer-sidecar] spec file missing for ${featureId}: ${meta.spec_path}`);
+            }
+        }
+        return entries;
+    }
+    async addFeatureFromState(specMap, featureId) {
+        try {
+            const state = await this.kernel.readState(featureId);
+            const fm = state.frontMatter;
+            const specPath = typeof fm.spec_path === 'string' ? fm.spec_path : null;
+            const status = typeof fm.status === 'string' ? fm.status : 'unknown';
+            if (specPath) {
+                specMap.set(featureId, { spec_path: specPath, status });
+            }
+        }
+        catch {
+            // Feature state unreadable — skip
+        }
+    }
+    computeFingerprint(specs, requestIds) {
+        return stableHash(JSON.stringify({
+            featureIds: specs.map((s) => s.feature_id).sort(),
+            specPaths: specs.map((s) => s.spec_path).sort(),
+            requestIds,
+        }));
+    }
+    buildPrompt(specs) {
+        let totalBytes = 0;
+        let partial = false;
+        const included = [];
+        for (const spec of specs) {
+            const specBytes = Buffer.byteLength(spec.content, 'utf8');
+            if (totalBytes + specBytes > this.maxSpecContentBytes) {
+                partial = true;
+                console.warn(`[organizer-sidecar] spec content limit reached at ${included.length}/${specs.length} features`);
+                break;
+            }
+            totalBytes += specBytes;
+            included.push(spec);
+        }
+        const sections = included.map((spec) => `--- FEATURE: ${spec.feature_id} ---\nspec_path: ${spec.spec_path}\nstatus: ${spec.status}\n\n${spec.content}`);
+        const prompt = [
+            'Analyze the following feature specs and produce an ordering artifact.',
+            '',
+            `Active instance: ${this.state.ownerInstanceId}`,
+            `Total features: ${included.length}`,
+            '',
+            ...sections,
+            '',
+            '---',
+            '',
+            'Produce a single JSON object with the ordering analysis. No markdown fences.',
+        ].join('\n');
+        return { prompt, partial };
+    }
+    async dispatchAndParse(prompt, partial, fingerprint, requestIds) {
+        const output = await this.invokeOrganizer(prompt);
+        const firstAttempt = this.parseAndValidate(output, partial, fingerprint, requestIds);
+        if (firstAttempt) {
+            return firstAttempt;
+        }
+        // Retry once with correction
+        const errors = this.schemaValidator.errors;
+        const errorSummary = errors
+            ? errors.map((e) => `${e.instancePath} ${e.message}`).join('; ')
+            : 'invalid JSON structure';
+        const correctionPrompt = `Your previous response was invalid: ${errorSummary}. Please produce the ordering JSON again with the same specs.`;
+        const retryOutput = await this.invokeOrganizer(correctionPrompt);
+        const secondAttempt = this.parseAndValidate(retryOutput, partial, fingerprint, requestIds);
+        if (secondAttempt) {
+            return secondAttempt;
+        }
+        console.warn('[organizer-sidecar] artifact validation failed after retry, skipping write');
+        return null;
+    }
+    async invokeOrganizer(instructions) {
+        return await this.provider.runWorker({
+            role: 'organizer',
+            feature_id: 'global',
+            instructions,
+        });
+    }
+    parseAndValidate(output, partial, fingerprint, requestIds) {
+        const text = this.extractText(output);
+        if (!text) {
+            return null;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            // Try extracting JSON from embedded text
+            const firstBrace = text.indexOf('{');
+            const lastBrace = text.lastIndexOf('}');
+            if (firstBrace === -1 || lastBrace <= firstBrace) {
+                return null;
+            }
+            try {
+                parsed = JSON.parse(text.slice(firstBrace, lastBrace + 1));
+            }
+            catch {
+                return null;
+            }
+        }
+        // Unwrap { type: "ORDERING", ordering: { ... } } envelope
+        const ordering = parsed.type === 'ORDERING' && parsed.ordering && typeof parsed.ordering === 'object'
+            ? parsed.ordering
+            : parsed;
+        const artifact = {
+            version: 1,
+            generated_at: nowIso(),
+            expires_at: new Date(Date.now() + this.artifactTtlMs).toISOString(),
+            completion_status: partial ? 'partial' : 'complete',
+            backlog_fingerprint: fingerprint,
+            analyzed_requests: requestIds,
+            dependency_graph: ordering.dependency_graph ?? {},
+            ready_set: ordering.ready_set ?? [],
+            deferred_set: ordering.deferred_set ?? [],
+            blocked_set: ordering.blocked_set ?? [],
+        };
+        const valid = this.schemaValidator(artifact);
+        if (!valid) {
+            return null;
+        }
+        return artifact;
+    }
+    extractText(output) {
+        // Try common provider output text fields
+        if (typeof output.content === 'string' && output.content.length > 0) {
+            return output.content;
+        }
+        if (typeof output.text === 'string' && output.text.length > 0) {
+            return output.text;
+        }
+        if (typeof output.response === 'string' && output.response.length > 0) {
+            return output.response;
+        }
+        // Fallback: check outputs array (structured provider envelope)
+        if (Array.isArray(output.outputs)) {
+            for (const item of output.outputs) {
+                const record = item;
+                if (typeof record.content === 'string' && record.content.length > 0) {
+                    return record.content;
+                }
+            }
+        }
+        // Last resort: stringify the entire output
+        try {
+            const str = JSON.stringify(output);
+            if (str.length > 2) {
+                return str;
+            }
+        }
+        catch {
+            // empty
+        }
+        return null;
+    }
+    async writeArtifactAtomically(artifact) {
+        const tmpPath = this.artifactPath + '.tmp';
+        await writeFile(tmpPath, JSON.stringify(artifact, null, 2), 'utf8');
+        await rename(tmpPath, this.artifactPath);
+    }
+}
+//# sourceMappingURL=organizer-sidecar-service.js.map

package/dist/apps/control-plane/supervisor/organizer-sidecar-service.js.map

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

package/dist/apps/control-plane/supervisor/plan-conformance-scorer.js

@@ -1,4 +1,5 @@
 import { parseUnifiedDiff, touchedPathsFromDiff } from '../core/patch.js';
+import { areaMatches } from '../core/path-rules.js';
 function asNonEmptyString(value) {
     if (typeof value !== 'string') {
         return null;
@@ -57,11 +58,7 @@ function buildPlanScope(plan) {
     return { declaredFiles, allowedAreas };
 }
 function isPathAllowedByArea(filePath, allowedArea) {
-    if (filePath === allowedArea) {
-        return true;
-    }
-    const normalizedArea = allowedArea.endsWith('/') ? allowedArea : `${allowedArea}/`;
-    return filePath.startsWith(normalizedArea);
+    return areaMatches(filePath, allowedArea);
 }
 export class PlanConformanceScorer {
     stallThreshold;

package/dist/apps/control-plane/supervisor/plan-conformance-scorer.js.map

@@ -1 +1 @@
-{"version":3,"file":"plan-conformance-scorer.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/supervisor/plan-conformance-scorer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plan-conformance-scorer.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/supervisor/plan-conformance-scorer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAuBpD,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChE,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;SACrC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAe;IACxC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,iBAAiB,CAAC,MAA+B;IACxD,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;IAClE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnD,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5C,CAAC;IACD,IAAI,CAAC;QACH,OAAO,oBAAoB,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,MAA4B;IACrD,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACvC,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,UAAU,GAAG,gBAAgB,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;QACtE,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;YAC3B,SAAS;QACX,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,iBAAiB,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,cAAc,CAAC,IAA6B;IAInD,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,aAAa,GAAG,iBAAiB,CAAC;QACtC,GAAG,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC;QACjC,GAAG,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC;KAClC,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,iBAAiB,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IACzE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;AACzC,CAAC;AAED,SAAS,mBAAmB,CAAC,QAAgB,EAAE,WAAmB;IAChE,OAAO,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,OAAO,qBAAqB;IACf,cAAc,CAAS;IACvB,cAAc,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEtE,YAAY,OAAqC;QAC/C,IAAI,CAAC,cAAc;YACjB,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,OAAO,CAAC,cAAc,IAAI,CAAC;gBACpE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC;gBACpC,CAAC,CAAC,CAAC,CAAC;IACV,CAAC;IAED,KAAK,CACH,SAAiB,EACjB,MAA4B,EAC5B,IAA6B;QAE7B,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI;YAClD,wBAAwB,EAAE,CAAC;YAC3B,uBAAuB,EAAE,CAAC;YAC1B,eAAe,EAAE,CAAC;SACnB,CAAC;QACF,KAAK,CAAC,eAAe,IAAI,CAAC,CAAC;QAE3B,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACnD,MAAM,YAAY,GAAG,SAAS,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;QAC7F,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAC1C,OAAO;gBACL,UAAU,EAAE,IAAI;gBAChB,SAAS,EAAE,KAAK;gBAChB,wBAAwB,EAAE,KAAK,CAAC,wBAAwB;gBACxD,uBAAuB,EAAE,KAAK,CAAC,uBAAuB;gBACtD,iBAAiB,EAAE,SAAS,CAAC,aAAa;gBAC1C,gBAAgB;gBAChB,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,kBAAkB;aAC5B,CAAC;QACJ,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACzD,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YACpD,IAAI,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QACpF,CAAC,CAAC,CAAC;QAEH,IAAI,UAAU,EAAE,CAAC;YACf,KAAK,CAAC,wBAAwB,GAAG,CAAC,CAAC;YACnC,KAAK,CAAC,uBAAuB,GAAG,KAAK,CAAC,eAAe,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,wBAAwB,IAAI,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC1C,OAAO;YACL,UAAU;YACV,SAAS,EAAE,KAAK,CAAC,wBAAwB,IAAI,IAAI,CAAC,cAAc;YAChE,wBAAwB,EAAE,KAAK,CAAC,wBAAwB;YACxD,uBAAuB,EAAE,KAAK,CAAC,uBAAuB;YACtD,iBAAiB,EAAE,SAAS,CAAC,aAAa;YAC1C,gBAAgB;YAChB,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,SAAiB;QACrB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE;YACjC,wBAAwB,EAAE,CAAC;YAC3B,uBAAuB,EAAE,CAAC;YAC1B,eAAe,EAAE,CAAC;SACnB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,SAAiB;QACtB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/apps/control-plane/supervisor/planner-phase.d.ts

@@ -0,0 +1,3 @@
+export type PlannerPromptPhase = 'intake' | 'planning';
+export declare function resolvePlannerPhaseFromFrontMatter(frontMatter: unknown): PlannerPromptPhase;
+export declare function resolvePlannerPhaseFromContext(contextBundle: unknown): PlannerPromptPhase;

package/dist/apps/control-plane/supervisor/planner-phase.js

@@ -0,0 +1,70 @@
+import { STATUS } from '../core/constants.js';
+function asRecord(value) {
+    return value && typeof value === 'object' ? value : {};
+}
+function asString(value) {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function asNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? Math.floor(value) : null;
+}
+function hasOwn(record, key) {
+    return Object.prototype.hasOwnProperty.call(record, key);
+}
+function hasIntakeStateMarkers(frontMatter) {
+    const intake = asRecord(frontMatter.intake);
+    const humanInput = asRecord(frontMatter.human_input);
+    const status = asString(frontMatter.status);
+    const resumeStatus = asString(humanInput.resume_status);
+    return (status === STATUS.INTAKE ||
+        resumeStatus === STATUS.INTAKE ||
+        hasOwn(intake, 'status') ||
+        hasOwn(intake, 'bootstrap_manifest_version') ||
+        hasOwn(intake, 'verified_manifest_version'));
+}
+export function resolvePlannerPhaseFromFrontMatter(frontMatter) {
+    const normalizedFrontMatter = asRecord(frontMatter);
+    const intake = asRecord(normalizedFrontMatter.intake);
+    const humanInput = asRecord(normalizedFrontMatter.human_input);
+    const status = asString(normalizedFrontMatter.status);
+    const resumeStatus = asString(humanInput.resume_status);
+    const intakeStatus = asString(intake.status);
+    const verifiedManifestVersion = asNumber(intake.verified_manifest_version);
+    if (!hasIntakeStateMarkers(normalizedFrontMatter)) {
+        return 'planning';
+    }
+    if (status === STATUS.INTAKE || resumeStatus === STATUS.INTAKE) {
+        return 'intake';
+    }
+    if (intakeStatus === 'verified' || verifiedManifestVersion !== null) {
+        return 'planning';
+    }
+    return 'intake';
+}
+export function resolvePlannerPhaseFromContext(contextBundle) {
+    const bundle = asRecord(contextBundle);
+    const state = asRecord(bundle.state);
+    const frontMatter = asRecord(state.front_matter);
+    const intake = asRecord(bundle.intake);
+    const summary = asRecord(intake.summary);
+    const verifiedManifest = asRecord(intake.verified_manifest);
+    const summaryStatus = asString(summary.status);
+    const verifiedManifestVersion = asNumber(summary.verified_manifest_version);
+    if (summaryStatus === 'verified' || verifiedManifestVersion !== null) {
+        return 'planning';
+    }
+    if (summaryStatus === 'not_started' ||
+        summaryStatus === 'in_progress' ||
+        summaryStatus === 'awaiting_input') {
+        return 'intake';
+    }
+    if (Object.keys(verifiedManifest).length > 0) {
+        return 'planning';
+    }
+    return resolvePlannerPhaseFromFrontMatter(frontMatter);
+}
+//# sourceMappingURL=planner-phase.js.map

package/dist/apps/control-plane/supervisor/planner-phase.js.map

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

package/dist/apps/control-plane/supervisor/planning-wave-executor.d.ts

@@ -5,6 +5,9 @@ import type { WorkerMalformedOutputAction, WorkerNoProgressAction, WorkerProvide
 interface PlanningWaveExecutorDependencies {
     toolCaller: SupervisorToolCaller;
     planGenerator: InitialPlanGenerator;
+    plannerSessionSync?: {
+        syncPlannerSessions(featureIds: string[]): Promise<void>;
+    };
     workerDecisionRunner?: WorkerDecisionRunner;
     providerMode?: WorkerProviderMode;
     outputLoopDetector?: OutputLoopDetector;
@@ -19,13 +22,21 @@ interface PlanningWaveExecutorDependencies {
     runId?: string | (() => string);
     providerName?: string;
     modelName?: string;
+    safeCheckpointHook?: () => Promise<void>;
+    getPolicySnapshot?: () => Record<string, unknown>;
 }
 /**
  * @fileoverview Planning phase wave executor.
  */
+/**
+ * Executes the planning phase for one supervisor iteration wave.
+ * Handles intake verification, plan generation, worker decision dispatch,
+ * and post-QA reconciliation of accepted plans.
+ */
 export declare class PlanningWaveExecutor {
     private readonly toolCaller;
     private readonly planGenerator;
+    private readonly plannerSessionSync;
     private readonly workerDecisionRunner;
     private readonly providerMode;
     private readonly outputLoopDetector;
@@ -40,14 +51,39 @@ export declare class PlanningWaveExecutor {
     private readonly runId;
     private readonly providerName;
     private readonly modelName;
+    private readonly safeCheckpointHook;
+    private readonly getPolicySnapshot;
     private readonly noProgressByFeature;
     private readonly lastStatusByFeature;
     constructor(dependencies: PlanningWaveExecutorDependencies);
+    /**
+     * Runs a single planning wave: resolves planner phase (intake vs. planning), invokes workers,
+     * normalizes accepted plan state, and falls back to stub plan generation when not in live mode.
+     * @param featureIds Feature IDs eligible for planning in this wave.
+     */
     run(featureIds: string[]): Promise<void>;
+    /**
+     * Clears all per-feature tracking state (progress counters, status cache, loop detector).
+     * Called when a feature is removed from the active execution set.
+     * @param featureId The feature whose tracking data should be purged.
+     */
     clearFeatureTracking(featureId: string): void;
+    private instructionsForPlannerState;
+    private policyAllowsStubAutoPromotion;
+    private normalizeAcceptedPlanState;
+    /**
+     * Reconciles accepted plans against QA/gate findings after the QA wave completes.
+     * Evaluates gate freshness, plan-trace contract validity, and QA test summaries,
+     * then emits plan updates or invokes the planner worker for revisions when needed.
+     * @param featureIds Feature IDs in post-QA status to reconcile.
+     * @param iteration Current supervisor iteration number (used for decision logging).
+     */
     runPostQaReconciliation(featureIds: string[], iteration: number): Promise<void>;
     private evaluateReconciliationDecision;
     private buildUpdatedPlan;
+    private shouldInvokePlannerForGateFailure;
+    private shouldInvokePlannerForPlanTraceContract;
+    private extractGateFailureContext;
     private appendDecisionLog;
     private resolveRunId;
     private appendSemanticEvent;
@@ -55,6 +91,12 @@ export declare class PlanningWaveExecutor {
     private appendRuntimePolicyEvent;
     private enforceOutputLoopPolicy;
     private enforceWorkerExecutionPolicy;
+    private readOpenIntakeAmbiguities;
+    private readAnsweredIntakeAmbiguityIds;
+    private readAnsweredIntakeClarifications;
+    private buildIntakeClarificationPrompt;
+    private requestIntakeClarificationFallback;
+    private buildPlannerRecoveryFrontMatter;
     private applyWorkerPolicyAction;
 }
 export {};