@amsterdamdatalabs/enact-operator 0.1.2

package/dist/shared/workflow/delivery/adoAuxiliaryRuntime.js

@@ -0,0 +1,166 @@
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { ensureLayout, layoutPath } from '../../../shared/core/contract.js';
+import { ensureDir, writeJson } from '../../../shared/core/json.js';
+const WorkItemSchema = z.object({
+    id: z.string().min(1),
+    title: z.string().min(1),
+    tags: z.array(z.string()).default([]),
+});
+const WorkWithWorkItemInputSchema = z.object({
+    workItem: WorkItemSchema,
+    lane: z.enum(['ultrawork', 'ralph']),
+    branchName: z.string().min(1),
+    worktreePath: z.string().min(1),
+    prTitle: z.string().min(1),
+    prUrl: z.string().url(),
+    commitSha: z.string().min(7),
+});
+const DeadcodeEvaluationInputSchema = z.object({
+    symbol: z.string().min(1),
+    references: z.array(z.string()).default([]),
+    entryPointGuards: z.array(z.string()).default([]),
+});
+const SecurityFindingSchema = z.object({
+    id: z.string().min(1),
+    title: z.string().min(1),
+    cwe: z.string().min(1),
+    cvssV4: z.number().min(0).max(10),
+    owaspCategory: z.string().min(1),
+    exploitability: z.string().min(1),
+});
+const SecurityResearchInputSchema = z.object({
+    sessionId: z.string().min(1),
+    autoCreateBugs: z.boolean().default(true),
+    findings: z.array(SecurityFindingSchema).min(1),
+});
+function workWithWorkItemDir(root, workItemId) {
+    return join(layoutPath(root, 'work-with-workitem'), workItemId);
+}
+function securityReportPath(root, sessionId) {
+    return layoutPath(root, 'security', sessionId, 'findings.md');
+}
+export function planWorkWithWorkItemDelivery(root, input) {
+    ensureLayout(root);
+    const parsed = WorkWithWorkItemInputSchema.parse(input);
+    const prCommand = [
+        'az repos pr create',
+        `--work-items ${parsed.workItem.id}`,
+        `--source-branch ${parsed.branchName}`,
+        `--title "${parsed.prTitle}"`,
+    ].join(' ');
+    const note = [
+        `PR: ${parsed.prUrl}`,
+        `Commit: ${parsed.commitSha}`,
+        `Lane: ${parsed.lane}`,
+        `Worktree cleaned up via ExitWorktree from ${parsed.worktreePath}`,
+    ].join(' | ');
+    const handoffPath = join(workWithWorkItemDir(root, parsed.workItem.id), 'handoff.json');
+    const plan = {
+        handoffPath,
+        prCommand,
+        toolCalls: [
+            {
+                name: 'factory_workitem_get',
+                args: { id: parsed.workItem.id },
+            },
+            {
+                name: 'factory_assignment_record',
+                args: {
+                    workItemId: parsed.workItem.id,
+                    prUrl: parsed.prUrl,
+                    commitSha: parsed.commitSha,
+                    note,
+                },
+            },
+        ],
+        assignmentRecord: {
+            workItemId: parsed.workItem.id,
+            prUrl: parsed.prUrl,
+            commitSha: parsed.commitSha,
+            note,
+        },
+        cleanup: {
+            command: 'ExitWorktree',
+            branchName: parsed.branchName,
+            worktreePath: parsed.worktreePath,
+        },
+        waitsForCi: false,
+        usesGithubApis: false,
+        steps: [
+            `factory_workitem_get ${parsed.workItem.id}`,
+            'EnterWorktree',
+            parsed.lane === 'ralph' ? '$ralph' : '$ultrawork',
+            'atomic commits',
+            prCommand,
+            'factory_assignment_record',
+            'ExitWorktree',
+        ],
+    };
+    writeJson(handoffPath, plan);
+    return plan;
+}
+export function evaluateDeadcodeCandidate(input) {
+    const parsed = DeadcodeEvaluationInputSchema.parse(input);
+    if (parsed.entryPointGuards.includes(parsed.symbol)) {
+        return {
+            deletable: false,
+            reason: `Symbol "${parsed.symbol}" is protected by the entry-point guard list.`,
+        };
+    }
+    if (parsed.references.length > 0) {
+        return {
+            deletable: false,
+            reason: `Symbol "${parsed.symbol}" still has ${parsed.references.length} live references.`,
+        };
+    }
+    return {
+        deletable: true,
+        reason: `Symbol "${parsed.symbol}" has zero references and is not guarded.`,
+    };
+}
+export function writeSecurityResearchFindings(root, input) {
+    ensureLayout(root);
+    const parsed = SecurityResearchInputSchema.parse(input);
+    const findings = [...parsed.findings].sort((a, b) => b.cvssV4 - a.cvssV4);
+    const reportPath = securityReportPath(root, parsed.sessionId);
+    const reportMarkdown = [
+        '# Security Research Findings',
+        `Session: ${parsed.sessionId}`,
+        '',
+        ...findings.map((finding) => [
+            `## ${finding.title}`,
+            '### Classification',
+            `- CWE: ${finding.cwe}`,
+            `- CVSS v4: ${finding.cvssV4.toFixed(1)}`,
+            `- OWASP: ${finding.owaspCategory}`,
+            '### Evidence',
+            `- Exploitability: ${finding.exploitability}`,
+            '### Suggested Action',
+            `- Triage ${finding.id} for remediation.`,
+            '### Blockers',
+            '- None recorded.',
+            '',
+        ].join('\n')),
+    ].join('\n');
+    ensureDir(join(layoutPath(root, 'security'), parsed.sessionId));
+    writeFileSync(reportPath, reportMarkdown, 'utf8');
+    const bugSyncRequests = parsed.autoCreateBugs
+        ? findings
+            .filter((finding) => finding.cvssV4 >= 9.0)
+            .map((finding) => ({
+            method: 'factory_workitem_sync_once',
+            kind: 'Bug',
+            title: `[Critical] ${finding.title}`,
+            severity: finding.cvssV4,
+            findingId: finding.id,
+        }))
+        : [];
+    return {
+        reportPath,
+        reportMarkdown,
+        bugSyncRequests,
+    };
+}
+//# sourceMappingURL=adoAuxiliaryRuntime.js.map

package/dist/shared/workflow/delivery/adoAuxiliaryRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adoAuxiliaryRuntime.js","sourceRoot":"","sources":["../../../../src/shared/workflow/delivery/adoAuxiliaryRuntime.ts"],"names":[],"mappings":"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"}

package/dist/shared/workflow/delivery/finalWave.d.ts

@@ -0,0 +1,57 @@
+export type FinalWaveReviewerId = 'f1' | 'f2' | 'f3' | 'f4';
+export type FinalWaveVerdict = 'GO' | 'NO-GO';
+export interface FinalWaveReviewer {
+    id: FinalWaveReviewerId;
+    label: 'F1' | 'F2' | 'F3' | 'F4';
+    name: string;
+    reviewer: string;
+}
+export interface FinalWaveReviewerResult {
+    reviewerId: FinalWaveReviewerId;
+    verdict: FinalWaveVerdict;
+    summary: string;
+    evidencePointers?: string[];
+    scopeViolations?: string[];
+}
+export interface FinalWaveStep {
+    reviewerId: FinalWaveReviewerId;
+    label: string;
+    name: string;
+    reviewer: string;
+    verdict: FinalWaveVerdict;
+    passed: boolean;
+    summary: string;
+    evidencePointers: string[];
+    scopeViolations: string[];
+}
+export interface WaveResult {
+    sessionId: string;
+    artefactPath: string;
+    passed: boolean;
+    blockers: string[];
+    steps: FinalWaveStep[];
+}
+export interface FinalWaveDispatchInput {
+    sessionId: string;
+    artefactPath: string;
+    reviewer: FinalWaveReviewer;
+}
+export type FinalWaveDispatcher = (input: FinalWaveDispatchInput) => Promise<FinalWaveReviewerResult> | FinalWaveReviewerResult;
+export interface FinalWaveDispatchArtifact {
+    reviewerId: FinalWaveReviewerId;
+    reviewer: string;
+    promptPath: string;
+    continuationId: string;
+    agentId: string;
+}
+export declare const FINAL_WAVE_REVIEWERS: readonly FinalWaveReviewer[];
+export declare function dispatchFinalWaveReviewers(sessionId: string, artefactPath: string, options?: {
+    root?: string;
+    parentLane?: string | null;
+    parentLaneId?: string | null;
+}): {
+    pendingResults: FinalWaveReviewerResult[];
+    dispatches: FinalWaveDispatchArtifact[];
+};
+export declare function runFinalWave(sessionId: string, artefactPath: string, source: FinalWaveReviewerResult[] | FinalWaveDispatcher): Promise<WaveResult>;
+//# sourceMappingURL=finalWave.d.ts.map

package/dist/shared/workflow/delivery/finalWave.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalWave.d.ts","sourceRoot":"","sources":["../../../../src/shared/workflow/delivery/finalWave.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,mBAAmB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAC5D,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,mBAAmB,CAAC;IACxB,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,mBAAmB,CAAC;IAChC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,mBAAmB,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED,MAAM,MAAM,mBAAmB,GAC7B,CAAC,KAAK,EAAE,sBAAsB,KAAK,OAAO,CAAC,uBAAuB,CAAC,GAAG,uBAAuB,CAAC;AAEhG,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,mBAAmB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,oBAAoB,EAAE,SAAS,iBAAiB,EAKnD,CAAC;AA0BX,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,GACL;IACD,cAAc,EAAE,uBAAuB,EAAE,CAAC;IAC1C,UAAU,EAAE,yBAAyB,EAAE,CAAC;CACzC,CA4CA;AAkDD,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,uBAAuB,EAAE,GAAG,mBAAmB,GACtD,OAAO,CAAC,UAAU,CAAC,CASrB"}

package/dist/shared/workflow/delivery/finalWave.js

@@ -0,0 +1,123 @@
+import { join } from 'node:path';
+import { writeFileSync } from 'node:fs';
+import { layoutPath, resolveOperatorRoot } from '../../../shared/core/contract.js';
+import { ensureDir } from '../../../shared/core/json.js';
+import { registerDelegatedSession } from '../../../shared/workflow/delegation/delegatedSession.js';
+import { recordSubagentHookStart } from '../../../shared/workflow/delegation/subagentRuntime.js';
+export const FINAL_WAVE_REVIEWERS = [
+    { id: 'f1', label: 'F1', name: 'Plan Compliance Audit', reviewer: 'architect' },
+    { id: 'f2', label: 'F2', name: 'Code Quality Review', reviewer: 'code-reviewer' },
+    { id: 'f3', label: 'F3', name: 'Real-Surface QA', reviewer: 'verifier' },
+    { id: 'f4', label: 'F4', name: 'Scope Fidelity Check', reviewer: 'scope-guard' },
+];
+function finalWaveDir(root, sessionId) {
+    return layoutPath(root, 'final-wave', sessionId);
+}
+function finalWavePromptPath(root, sessionId, reviewerId) {
+    return join(finalWaveDir(root, sessionId), `${reviewerId}.md`);
+}
+function finalWaveAgentId(sessionId, reviewerId) {
+    return `final-wave:${sessionId}:${reviewerId}`;
+}
+function buildFinalWavePrompt(input) {
+    return [
+        `# ${input.reviewer.label} ${input.reviewer.name}`,
+        '',
+        `Reviewer: ${input.reviewer.reviewer}`,
+        `Session: ${input.sessionId}`,
+        `Artefact: ${input.artefactPath}`,
+        '',
+        'Produce a GO or NO-GO review for this closure surface and return concrete evidence pointers.',
+    ].join('\n');
+}
+export function dispatchFinalWaveReviewers(sessionId, artefactPath, options = {}) {
+    const root = options.root ?? resolveOperatorRoot();
+    ensureDir(finalWaveDir(root, sessionId));
+    const dispatches = FINAL_WAVE_REVIEWERS.map((reviewer) => {
+        const promptPath = finalWavePromptPath(root, sessionId, reviewer.id);
+        writeFileSync(promptPath, buildFinalWavePrompt({ sessionId, artefactPath, reviewer }), 'utf8');
+        const agentId = finalWaveAgentId(sessionId, reviewer.id);
+        const delegated = registerDelegatedSession(root, {
+            kind: 'subagent',
+            externalRef: agentId,
+            parentLane: options.parentLane ?? null,
+            parentLaneId: options.parentLaneId ?? null,
+            reuseActive: false,
+            metadata: {
+                reviewerId: reviewer.id,
+                artefactPath,
+                source: 'final-wave-dispatch',
+            },
+        });
+        recordSubagentHookStart(root, {
+            agent_id: agentId,
+            session_id: sessionId,
+            parent_lane: options.parentLane ?? null,
+            parent_lane_id: options.parentLaneId ?? null,
+            continuation_id: delegated.continuationId,
+            task: `Final-wave ${reviewer.label} review`,
+        });
+        return {
+            reviewerId: reviewer.id,
+            reviewer: reviewer.reviewer,
+            promptPath,
+            continuationId: delegated.continuationId,
+            agentId,
+        };
+    });
+    return {
+        pendingResults: dispatches.map((dispatch) => ({
+            reviewerId: dispatch.reviewerId,
+            verdict: 'NO-GO',
+            summary: `Pending dispatched reviewer output for ${dispatch.reviewerId}.`,
+            evidencePointers: [dispatch.promptPath],
+        })),
+        dispatches,
+    };
+}
+function buildWaveResult(sessionId, artefactPath, results) {
+    const resultByReviewer = new Map(results.map((result) => [result.reviewerId, result]));
+    for (const reviewer of FINAL_WAVE_REVIEWERS) {
+        if (!resultByReviewer.has(reviewer.id)) {
+            throw new Error(`Missing final-wave reviewer result: ${reviewer.label}`);
+        }
+    }
+    const steps = FINAL_WAVE_REVIEWERS.map((reviewer) => {
+        const result = resultByReviewer.get(reviewer.id);
+        const scopeViolations = result.scopeViolations ?? [];
+        const passed = result.verdict === 'GO' && scopeViolations.length === 0;
+        return {
+            reviewerId: reviewer.id,
+            label: reviewer.label,
+            name: reviewer.name,
+            reviewer: reviewer.reviewer,
+            verdict: passed ? 'GO' : 'NO-GO',
+            passed,
+            summary: result.summary,
+            evidencePointers: result.evidencePointers ?? [],
+            scopeViolations,
+        };
+    });
+    const blockers = steps
+        .filter((step) => !step.passed)
+        .map((step) => {
+        const scopeSuffix = step.scopeViolations.length > 0
+            ? ` Scope violations: ${step.scopeViolations.join(', ')}`
+            : '';
+        return `${step.label} ${step.name} failed: ${step.summary}${scopeSuffix}`;
+    });
+    return {
+        sessionId,
+        artefactPath,
+        passed: blockers.length === 0,
+        blockers,
+        steps,
+    };
+}
+export async function runFinalWave(sessionId, artefactPath, source) {
+    const results = Array.isArray(source)
+        ? source
+        : await Promise.all(FINAL_WAVE_REVIEWERS.map((reviewer) => Promise.resolve(source({ sessionId, artefactPath, reviewer }))));
+    return buildWaveResult(sessionId, artefactPath, results);
+}
+//# sourceMappingURL=finalWave.js.map

package/dist/shared/workflow/delivery/finalWave.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalWave.js","sourceRoot":"","sources":["../../../../src/shared/workflow/delivery/finalWave.ts"],"names":[],"mappings":"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"}

package/dist/shared/workflow/delivery/lifecyclePushMap.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Phase 8 — Conservative lifecycle boolean flip mapping for eager AzDo push.
+ *
+ * When Ralph or Ultrawork transitions between phases, this module derives which
+ * AzDo lifecycle boolean (if any) should be flipped and enqueued to the
+ * governance-push-queue.  Only the three well-understood booleans are emitted:
+ *   planWritten          — a plan has been committed to
+ *   implementationComplete — implementation is done, entering verification
+ *   testsPassing         — gates/verifications passed, session completing
+ *
+ * All other transitions return null (no push enqueued).
+ *
+ * Team lane lifecycle transitions are also mapped here:
+ *   implementationComplete — task_completed (executor finishes work)
+ *   reviewPassed           — review_approved (reviewer approves, lane-local only)
+ *
+ * PR sidecar lifecycle transitions:
+ *   mergedToDevelop — PR merged into the develop branch
+ */
+import type { RalphPhase } from '../../../lanes/ralph/index.js';
+import type { UltraworkPhase } from '../../../lanes/ultrawork/index.js';
+/** Minimal PR sidecar shape for lifecycle push mapping (Governance package owns full prSidecar contract). */
+export interface PrSidecarState {
+    status: 'none' | 'pending' | 'opened' | 'merged' | 'closed' | 'failed';
+    target?: 'develop' | 'main' | string;
+}
+export type LifecycleFlip = Record<string, boolean>;
+/**
+ * Returns a partial lifecycle boolean map for a Ralph phase transition,
+ * or null if the transition carries no lifecycle signal.
+ */
+export declare function deriveRalphLifecycleFlip(from: RalphPhase, to: RalphPhase): LifecycleFlip | null;
+/**
+ * Returns a partial lifecycle boolean map for an Ultrawork phase transition,
+ * or null if the transition carries no lifecycle signal.
+ */
+export declare function deriveUltraworkLifecycleFlip(from: UltraworkPhase, to: UltraworkPhase): LifecycleFlip | null;
+/**
+ * Discriminated union for team-lane lifecycle transitions.
+ * task_completed: executor marks work done (status → 'review').
+ * review_approved: reviewer approves on lane-local path (canAutoClose=true).
+ */
+export type TeamTransition = {
+    kind: 'task_completed';
+    previousStatus: string;
+    nextStatus: string;
+} | {
+    kind: 'review_approved';
+};
+/**
+ * Returns a partial lifecycle boolean map for a Team-lane transition,
+ * or null if the transition carries no lifecycle signal.
+ *
+ * Conservative contract:
+ * - task_completed → implementationComplete: true (only when transitioning to 'review')
+ * - review_approved → reviewPassed: true (only on lane-local path; cross-repo Epic
+ *   callers must NOT call this — they defer via task_close_deferred instead)
+ */
+export declare function deriveTeamLifecycleFlip(transition: TeamTransition): LifecycleFlip | null;
+/**
+ * Returns { mergedToDevelop: true } when a PR sidecar transitions to merged
+ * on the develop branch, null for all other states or targets.
+ *
+ * 'main' merges are operator-triggered promotions and carry a separate signal,
+ * so they intentionally return null here.
+ */
+export declare function prMergeToLifecycleFlip(state: PrSidecarState): LifecycleFlip | null;
+//# sourceMappingURL=lifecyclePushMap.d.ts.map

package/dist/shared/workflow/delivery/lifecyclePushMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecyclePushMap.d.ts","sourceRoot":"","sources":["../../../../src/shared/workflow/delivery/lifecyclePushMap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,6GAA6G;AAC7G,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvE,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;CACtC;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,UAAU,GACb,aAAa,GAAG,IAAI,CAQtB;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,cAAc,EACpB,EAAE,EAAE,cAAc,GACjB,aAAa,GAAG,IAAI,CAWtB;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAEhC;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,cAAc,GAAG,aAAa,GAAG,IAAI,CAYxF;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,GAAG,IAAI,CAKlF"}

package/dist/shared/workflow/delivery/lifecyclePushMap.js

@@ -0,0 +1,82 @@
+/**
+ * Phase 8 — Conservative lifecycle boolean flip mapping for eager AzDo push.
+ *
+ * When Ralph or Ultrawork transitions between phases, this module derives which
+ * AzDo lifecycle boolean (if any) should be flipped and enqueued to the
+ * governance-push-queue.  Only the three well-understood booleans are emitted:
+ *   planWritten          — a plan has been committed to
+ *   implementationComplete — implementation is done, entering verification
+ *   testsPassing         — gates/verifications passed, session completing
+ *
+ * All other transitions return null (no push enqueued).
+ *
+ * Team lane lifecycle transitions are also mapped here:
+ *   implementationComplete — task_completed (executor finishes work)
+ *   reviewPassed           — review_approved (reviewer approves, lane-local only)
+ *
+ * PR sidecar lifecycle transitions:
+ *   mergedToDevelop — PR merged into the develop branch
+ */
+/**
+ * Returns a partial lifecycle boolean map for a Ralph phase transition,
+ * or null if the transition carries no lifecycle signal.
+ */
+export function deriveRalphLifecycleFlip(from, to) {
+    if (from === 'running' && to === 'verifying') {
+        return { implementationComplete: true };
+    }
+    if (from === 'verifying' && to === 'completed') {
+        return { testsPassing: true };
+    }
+    return null;
+}
+/**
+ * Returns a partial lifecycle boolean map for an Ultrawork phase transition,
+ * or null if the transition carries no lifecycle signal.
+ */
+export function deriveUltraworkLifecycleFlip(from, to) {
+    if (from === 'plan' && to === 'execute') {
+        return { planWritten: true };
+    }
+    if (from === 'execute' && to === 'verify') {
+        return { implementationComplete: true };
+    }
+    if (from === 'verify' && to === 'completed') {
+        return { testsPassing: true };
+    }
+    return null;
+}
+/**
+ * Returns a partial lifecycle boolean map for a Team-lane transition,
+ * or null if the transition carries no lifecycle signal.
+ *
+ * Conservative contract:
+ * - task_completed → implementationComplete: true (only when transitioning to 'review')
+ * - review_approved → reviewPassed: true (only on lane-local path; cross-repo Epic
+ *   callers must NOT call this — they defer via task_close_deferred instead)
+ */
+export function deriveTeamLifecycleFlip(transition) {
+    if (transition.kind === 'task_completed' &&
+        transition.nextStatus === 'review' &&
+        transition.previousStatus !== 'review') {
+        return { implementationComplete: true };
+    }
+    if (transition.kind === 'review_approved') {
+        return { reviewPassed: true };
+    }
+    return null;
+}
+/**
+ * Returns { mergedToDevelop: true } when a PR sidecar transitions to merged
+ * on the develop branch, null for all other states or targets.
+ *
+ * 'main' merges are operator-triggered promotions and carry a separate signal,
+ * so they intentionally return null here.
+ */
+export function prMergeToLifecycleFlip(state) {
+    if (state.status === 'merged' && (state.target === 'develop' || !state.target)) {
+        return { mergedToDevelop: true };
+    }
+    return null;
+}
+//# sourceMappingURL=lifecyclePushMap.js.map

package/dist/shared/workflow/delivery/lifecyclePushMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecyclePushMap.js","sourceRoot":"","sources":["../../../../src/shared/workflow/delivery/lifecyclePushMap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAYH;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAgB,EAChB,EAAc;IAEd,IAAI,IAAI,KAAK,SAAS,IAAI,EAAE,KAAK,WAAW,EAAE,CAAC;QAC7C,OAAO,EAAE,sBAAsB,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;IACD,IAAI,IAAI,KAAK,WAAW,IAAI,EAAE,KAAK,WAAW,EAAE,CAAC;QAC/C,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAC1C,IAAoB,EACpB,EAAkB;IAElB,IAAI,IAAI,KAAK,MAAM,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,IAAI,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,EAAE,sBAAsB,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,IAAI,EAAE,KAAK,WAAW,EAAE,CAAC;QAC5C,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAWD;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAA0B;IAChE,IACE,UAAU,CAAC,IAAI,KAAK,gBAAgB;QACpC,UAAU,CAAC,UAAU,KAAK,QAAQ;QAClC,UAAU,CAAC,cAAc,KAAK,QAAQ,EACtC,CAAC;QACD,OAAO,EAAE,sBAAsB,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC1C,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAqB;IAC1D,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/E,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;IACnC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/shared/workflow/delivery/prSidecar.d.ts

@@ -0,0 +1,7 @@
+export interface PrSidecarState {
+    status: 'none' | 'pending' | 'opened' | 'merged' | 'closed' | 'failed';
+    target: 'develop' | 'main' | string;
+    prUrl?: string;
+}
+export declare function isPrActive(state: PrSidecarState): boolean;
+//# sourceMappingURL=prSidecar.d.ts.map

package/dist/shared/workflow/delivery/prSidecar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prSidecar.d.ts","sourceRoot":"","sources":["../../../../src/shared/workflow/delivery/prSidecar.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvE,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAEzD"}

package/dist/shared/workflow/delivery/prSidecar.js

@@ -0,0 +1,4 @@
+export function isPrActive(state) {
+    return state.status === 'opened' || state.status === 'pending';
+}
+//# sourceMappingURL=prSidecar.js.map

package/dist/shared/workflow/delivery/prSidecar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prSidecar.js","sourceRoot":"","sources":["../../../../src/shared/workflow/delivery/prSidecar.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,UAAU,CAAC,KAAqB;IAC9C,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC;AACjE,CAAC"}

package/dist/shared/workflow/delivery/reviewStaleness.d.ts

@@ -0,0 +1,37 @@
+/**
+ * D2 — Review convergence / staleness logic.
+ *
+ * computeReviewStaleState implements the three-predicate model from Phase 5 Q1:
+ *   P1: newer run post-dates review evidenceHorizon.verificationRunTimestamp AND commit hash differs → stale
+ *   P2: newer run on same OR different commit explicitly passes gates the review flagged failing → superseded
+ *   P3: same commit, ≥2 newer runs all agree previously-failing gates now pass → stale (flake guard)
+ *
+ * Priority: P2 > P1 > P3 (first match wins in priority order).
+ */
+import type { OperatorReviewItem } from '../../../operator/runtime.js';
+/** A single verification run that can be compared against a review. */
+export interface VerificationRun {
+    runId: string;
+    runTimestamp: string;
+    commitHash: string;
+    /** Gate results recorded in this run. */
+    gateResults: Array<{
+        gateId: string;
+        passed: boolean;
+    }>;
+}
+export interface StaleStateResult {
+    staleState: 'current' | 'stale' | 'superseded';
+    trigger: 'P1' | 'P2' | 'P3' | null;
+}
+/**
+ * Compute whether a review is current, stale, or superseded relative to
+ * a list of verification runs that happened after the review was created.
+ *
+ * @param review  The review item to assess.
+ * @param runs    All verification runs to compare against (order irrelevant).
+ * @param failingGateIds  Optional explicit list of gate IDs the review flagged failing.
+ *                        If omitted, gate IDs are parsed from review.notes.
+ */
+export declare function computeReviewStaleState(review: OperatorReviewItem, runs: VerificationRun[], failingGateIds?: string[]): StaleStateResult;
+//# sourceMappingURL=reviewStaleness.d.ts.map

package/dist/shared/workflow/delivery/reviewStaleness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewStaleness.d.ts","sourceRoot":"","sources":["../../../../src/shared/workflow/delivery/reviewStaleness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,WAAW,EAAE,KAAK,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,SAAS,GAAG,OAAO,GAAG,YAAY,CAAC;IAC/C,OAAO,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;CACpC;AAqBD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,eAAe,EAAE,EACvB,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB,gBAAgB,CA8DlB"}