@rasensio/aidlc 0.1.0

package/dist/core/gate.js

@@ -0,0 +1,97 @@
+/**
+ * Gate evaluation with exit-code semantics for CI/CD integration.
+ *
+ * `evaluateGate()` checks whether a phase passes its gate:
+ * - Exit 0 (pass: true) iff phase status is 'complete'.
+ * - Otherwise, returns structured data naming missing artifacts and unsatisfied criteria.
+ *
+ * Requirements: 9.1, 9.6
+ */
+// ---------------------------------------------------------------------------
+// Gate evaluation
+// ---------------------------------------------------------------------------
+/**
+ * Evaluate whether a phase passes its gate check.
+ *
+ * Exit 0 (pass: true) iff the phase status is 'complete'.
+ * Otherwise, returns structured data naming what's missing (Req 9.6).
+ *
+ * @param phaseName - Name of the phase to check.
+ * @param phaseStates - Map of phase name → PhaseState for the instance.
+ * @param template - The resolved workflow template defining required artifacts.
+ * @returns A GateCheckResult indicating pass/fail with structured details.
+ */
+export function evaluateGate(phaseName, phaseStates, template) {
+    const state = phaseStates.get(phaseName);
+    // Phase not found in state
+    if (!state) {
+        return {
+            pass: false,
+            phase: phaseName,
+            missingArtifacts: [],
+            unsatisfiedCriteria: ['phase not found in instance state'],
+        };
+    }
+    // Phase is complete — gate passes
+    if (state.status === 'complete') {
+        return {
+            pass: true,
+            phase: phaseName,
+            missingArtifacts: [],
+            unsatisfiedCriteria: [],
+        };
+    }
+    // Phase is not complete — gather structured details about what's missing
+    const missingArtifacts = getMissingArtifacts(phaseName, state, template);
+    const unsatisfiedCriteria = getUnsatisfiedCriteria(state);
+    return {
+        pass: false,
+        phase: phaseName,
+        missingArtifacts,
+        unsatisfiedCriteria,
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Determine which required artifacts from the template are not yet 'complete'
+ * in the phase state.
+ */
+function getMissingArtifacts(phaseName, state, template) {
+    // Find the template phase definition
+    const templatePhase = template.phases.find((p) => p.name === phaseName);
+    if (!templatePhase) {
+        // Phase exists in state but not in template — no required artifacts to check
+        return [];
+    }
+    // Build a set of artifact names that are already complete in state
+    const completedArtifacts = new Set(state.artifacts
+        .filter((a) => a.status === 'complete')
+        .map((a) => a.name));
+    // Find required artifacts that are not complete
+    return templatePhase.required_artifacts
+        .filter((decl) => !completedArtifacts.has(decl.name))
+        .map((decl) => decl.name);
+}
+/**
+ * Describe unsatisfied criteria based on the current phase status.
+ */
+function getUnsatisfiedCriteria(state) {
+    const criteria = [];
+    switch (state.status) {
+        case 'pending':
+            criteria.push('phase has not been started (status: pending)');
+            break;
+        case 'in-progress':
+            criteria.push('phase is still in progress (status: in-progress)');
+            break;
+        case 'skipped':
+            criteria.push('phase was skipped (status: skipped)');
+            break;
+        default:
+            criteria.push(`phase status is "${state.status}" (expected: complete)`);
+    }
+    return criteria;
+}
+//# sourceMappingURL=gate.js.map

package/dist/core/gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.js","sourceRoot":"","sources":["../../src/core/gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsBH,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAiB,EACjB,WAAoC,EACpC,QAA0B;IAE1B,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAEzC,2BAA2B;IAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,SAAS;YAChB,gBAAgB,EAAE,EAAE;YACpB,mBAAmB,EAAE,CAAC,mCAAmC,CAAC;SAC3D,CAAC;IACJ,CAAC;IAED,kCAAkC;IAClC,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO;YACL,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,SAAS;YAChB,gBAAgB,EAAE,EAAE;YACpB,mBAAmB,EAAE,EAAE;SACxB,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IACzE,MAAM,mBAAmB,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAE1D,OAAO;QACL,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,SAAS;QAChB,gBAAgB;QAChB,mBAAmB;KACpB,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,mBAAmB,CAC1B,SAAiB,EACjB,KAAiB,EACjB,QAA0B;IAE1B,qCAAqC;IACrC,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CACxC,CAAC,CAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAC3C,CAAC;IAEF,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,6EAA6E;QAC7E,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,mEAAmE;IACnE,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAChC,KAAK,CAAC,SAAS;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CACtB,CAAC;IAEF,gDAAgD;IAChD,OAAO,aAAa,CAAC,kBAAkB;SACpC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACpD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAAC,KAAiB;IAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;QACrB,KAAK,SAAS;YACZ,QAAQ,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;YAC9D,MAAM;QACR,KAAK,aAAa;YAChB,QAAQ,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;YAClE,MAAM;QACR,KAAK,SAAS;YACZ,QAAQ,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;YACrD,MAAM;QACR;YACE,QAAQ,CAAC,IAAI,CAAC,oBAAoB,KAAK,CAAC,MAAM,wBAAwB,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './template-resolver.js';
+export * from './gate.js';
+export * from './lifecycle.js';
+export * from './lifecycle.js';
+export * from './lifecycle.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './template-resolver.js';
+export * from './gate.js';
+export * from './lifecycle.js';
+export * from './lifecycle.js';
+export * from './lifecycle.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

package/dist/core/lifecycle.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Pure lifecycle engine functions — completionPercent, isStalled, nextStep, evaluateTransition.
+ *
+ * These are stateless computations over typed state objects used for
+ * progress tracking, observability, continuation resolution, and gate evaluation.
+ * (Requirements 3.6, 6.6, 9.3, 11.2, 11.3, 24.6, 26.1, 26.5).
+ */
+import type { PhaseState, WorkflowTemplate, InstanceState, NextStep, FindingsIndex, TransitionResult } from './types.js';
+/**
+ * Calculate completion percentage for a lifecycle instance.
+ *
+ * Integer 0-100, floor of: (completed required artifacts) / (total required artifacts)
+ * across all applicable phases (filtered by scope).
+ *
+ * Algorithm:
+ *   1. Get applicable phases from the template (accounting for scope via phasesForScope)
+ *   2. Count total required artifacts across all applicable phases
+ *   3. Count completed artifacts (status === 'complete') from phase states
+ *   4. Return Math.floor((completed / total) * 100), or 0 if total is 0
+ *
+ * @param phaseStates - Map of phase name to PhaseState for this instance.
+ * @param template - The resolved workflow template (no `extends`).
+ * @param scope - The cycle scope to determine applicable phases.
+ * @returns Integer 0-100 representing completion percentage.
+ */
+export declare function completionPercent(phaseStates: Map<string, PhaseState>, template: WorkflowTemplate, scope?: InstanceState['scope']): number;
+/**
+ * Determine if an instance is stalled.
+ *
+ * Stalled = current phase has been active longer than thresholdDays
+ *           AND completionPercent < 100%.
+ * Never stalled at 100% — a completed instance is never flagged regardless
+ * of how long its current phase has been active.
+ *
+ * @param state - The instance state (provides current_phase and scope).
+ * @param phaseStates - Map of phase name to PhaseState for this instance.
+ * @param template - The resolved workflow template.
+ * @param now - Current time for age calculation.
+ * @param thresholdDays - Number of days before a phase is considered stalled.
+ * @returns true if the instance is stalled, false otherwise.
+ */
+export declare function isStalled(state: InstanceState, phaseStates: Map<string, PhaseState>, template: WorkflowTemplate, now: Date, thresholdDays: number): boolean;
+/**
+ * Continuation resolver — deterministic function of template and state.
+ *
+ * Returns the next action the instance should take:
+ *   - `{ kind: 'artifact', phase, artifact }` — produce this artifact next
+ *   - `{ kind: 'phase', phase }` — enter this phase next
+ *   - `{ kind: 'complete' }` — all phases and artifacts are done
+ *
+ * Algorithm:
+ *   1. Get the resolved phases for the current scope from the template.
+ *   2. Find the current phase in the resolved list.
+ *   3. In the current phase, find the first required artifact with status !== 'complete'.
+ *      → return `{ kind: 'artifact', phase: currentPhase, artifact: artifactName }`
+ *   4. If all required artifacts in the current phase are complete, find the next
+ *      pending phase (status not 'complete' and not 'skipped').
+ *      → return `{ kind: 'phase', phase: nextPhaseName }`
+ *   5. If no pending phases remain, return `{ kind: 'complete' }`.
+ *
+ * @param state - The current instance state.
+ * @param phaseStates - Map of phase name → PhaseState for all tracked phases.
+ * @param template - The fully resolved workflow template (no `extends`).
+ * @returns The next step the instance should take.
+ */
+export declare function nextStep(state: InstanceState, phaseStates: Map<string, PhaseState>, template: WorkflowTemplate): NextStep;
+/**
+ * Gate chain — evaluates whether a phase transition is allowed.
+ * Returns Allowed or Blocked (with EVERY unsatisfied condition).
+ *
+ * Gate evaluation order:
+ * 1. Required artifacts of the current phase all "complete"
+ * 2. Review gate (if template configures one for this phase): no critical+open findings
+ * 3. Ownership guard: warn + require override if actor ≠ recorded owner
+ * 4. Deployment entry: every preceding required phase has recorded status "complete" (from state only)
+ * 5. Blocking actions (placeholder — currently no-op)
+ *
+ * A blocked attempt reports every unsatisfied condition (Req 4.4).
+ *
+ * @param state - Current instance state.
+ * @param phaseStates - Map of phase name → PhaseState for all phases in the instance.
+ * @param template - The resolved workflow template (no `extends`).
+ * @param actor - Identity of the user/agent attempting the transition.
+ * @param findings - Findings index keyed by artifact name.
+ * @param override - If true, suppresses the ownership violation.
+ * @returns TransitionResult — `{ allowed: true }` or `{ allowed: false, violations: [...] }`.
+ */
+export declare function evaluateTransition(state: InstanceState, phaseStates: Map<string, PhaseState>, template: WorkflowTemplate, actor: string, findings: FindingsIndex, override?: boolean): TransitionResult;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/core/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/core/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,QAAQ,EAER,aAAa,EACb,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAOpB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,GAC7B,MAAM,CA2BR;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,QAAQ,EAAE,gBAAgB,EAC1B,GAAG,EAAE,IAAI,EACT,aAAa,EAAE,MAAM,GACpB,OAAO,CAeT;AAOD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,QAAQ,EAAE,gBAAgB,GACzB,QAAQ,CA+CV;AA8ED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,aAAa,EACvB,QAAQ,CAAC,EAAE,OAAO,GACjB,gBAAgB,CAiClB"}

package/dist/core/lifecycle.js

@@ -0,0 +1,356 @@
+/**
+ * Pure lifecycle engine functions — completionPercent, isStalled, nextStep, evaluateTransition.
+ *
+ * These are stateless computations over typed state objects used for
+ * progress tracking, observability, continuation resolution, and gate evaluation.
+ * (Requirements 3.6, 6.6, 9.3, 11.2, 11.3, 24.6, 26.1, 26.5).
+ */
+import { phasesForScope } from './template-resolver.js';
+// ---------------------------------------------------------------------------
+// completionPercent (Req 11.2)
+// ---------------------------------------------------------------------------
+/**
+ * Calculate completion percentage for a lifecycle instance.
+ *
+ * Integer 0-100, floor of: (completed required artifacts) / (total required artifacts)
+ * across all applicable phases (filtered by scope).
+ *
+ * Algorithm:
+ *   1. Get applicable phases from the template (accounting for scope via phasesForScope)
+ *   2. Count total required artifacts across all applicable phases
+ *   3. Count completed artifacts (status === 'complete') from phase states
+ *   4. Return Math.floor((completed / total) * 100), or 0 if total is 0
+ *
+ * @param phaseStates - Map of phase name to PhaseState for this instance.
+ * @param template - The resolved workflow template (no `extends`).
+ * @param scope - The cycle scope to determine applicable phases.
+ * @returns Integer 0-100 representing completion percentage.
+ */
+export function completionPercent(phaseStates, template, scope) {
+    const effectiveScope = scope ?? template.scope;
+    const applicablePhases = phasesForScope(template, effectiveScope);
+    let totalRequired = 0;
+    let completedCount = 0;
+    for (const templatePhase of applicablePhases) {
+        totalRequired += templatePhase.required_artifacts.length;
+        const phaseState = phaseStates.get(templatePhase.name);
+        if (!phaseState)
+            continue;
+        for (const artifact of phaseState.artifacts) {
+            // Only count artifacts that are declared as required in the template
+            const isRequired = templatePhase.required_artifacts.some((ra) => ra.name === artifact.name);
+            if (isRequired && artifact.status === 'complete') {
+                completedCount++;
+            }
+        }
+    }
+    if (totalRequired === 0)
+        return 0;
+    return Math.floor((completedCount / totalRequired) * 100);
+}
+// ---------------------------------------------------------------------------
+// isStalled (Req 11.3)
+// ---------------------------------------------------------------------------
+/**
+ * Determine if an instance is stalled.
+ *
+ * Stalled = current phase has been active longer than thresholdDays
+ *           AND completionPercent < 100%.
+ * Never stalled at 100% — a completed instance is never flagged regardless
+ * of how long its current phase has been active.
+ *
+ * @param state - The instance state (provides current_phase and scope).
+ * @param phaseStates - Map of phase name to PhaseState for this instance.
+ * @param template - The resolved workflow template.
+ * @param now - Current time for age calculation.
+ * @param thresholdDays - Number of days before a phase is considered stalled.
+ * @returns true if the instance is stalled, false otherwise.
+ */
+export function isStalled(state, phaseStates, template, now, thresholdDays) {
+    // Never stalled at 100% completion
+    const percent = completionPercent(phaseStates, template, state.scope);
+    if (percent >= 100)
+        return false;
+    // Find the current phase state
+    const currentPhaseState = phaseStates.get(state.current_phase);
+    if (!currentPhaseState || !currentPhaseState.entered_at)
+        return false;
+    // Calculate how long the phase has been active
+    const enteredAt = new Date(currentPhaseState.entered_at);
+    const elapsedMs = now.getTime() - enteredAt.getTime();
+    const elapsedDays = elapsedMs / (1000 * 60 * 60 * 24);
+    return elapsedDays > thresholdDays;
+}
+// ---------------------------------------------------------------------------
+// nextStep — Continuation Resolver (Req 26.1, 26.5)
+// ---------------------------------------------------------------------------
+/**
+ * Continuation resolver — deterministic function of template and state.
+ *
+ * Returns the next action the instance should take:
+ *   - `{ kind: 'artifact', phase, artifact }` — produce this artifact next
+ *   - `{ kind: 'phase', phase }` — enter this phase next
+ *   - `{ kind: 'complete' }` — all phases and artifacts are done
+ *
+ * Algorithm:
+ *   1. Get the resolved phases for the current scope from the template.
+ *   2. Find the current phase in the resolved list.
+ *   3. In the current phase, find the first required artifact with status !== 'complete'.
+ *      → return `{ kind: 'artifact', phase: currentPhase, artifact: artifactName }`
+ *   4. If all required artifacts in the current phase are complete, find the next
+ *      pending phase (status not 'complete' and not 'skipped').
+ *      → return `{ kind: 'phase', phase: nextPhaseName }`
+ *   5. If no pending phases remain, return `{ kind: 'complete' }`.
+ *
+ * @param state - The current instance state.
+ * @param phaseStates - Map of phase name → PhaseState for all tracked phases.
+ * @param template - The fully resolved workflow template (no `extends`).
+ * @returns The next step the instance should take.
+ */
+export function nextStep(state, phaseStates, template) {
+    // Step 1: Get applicable phases for the current scope
+    const applicablePhases = phasesForScope(template, state.scope);
+    if (applicablePhases.length === 0) {
+        return { kind: 'complete' };
+    }
+    // Step 2: Find the current phase in the applicable phases list
+    const currentPhaseIndex = applicablePhases.findIndex((p) => p.name === state.current_phase);
+    // If current phase is found, check for incomplete artifacts in it
+    if (currentPhaseIndex !== -1) {
+        const currentTemplatePhase = applicablePhases[currentPhaseIndex];
+        const currentPhaseState = phaseStates.get(state.current_phase);
+        // Step 3: Find the first incomplete required artifact in the current phase
+        const incompleteArtifact = findFirstIncompleteArtifact(currentTemplatePhase, currentPhaseState);
+        if (incompleteArtifact !== null) {
+            return {
+                kind: 'artifact',
+                phase: state.current_phase,
+                artifact: incompleteArtifact,
+            };
+        }
+    }
+    // Step 4: All artifacts in current phase are complete (or current phase not found).
+    // Find the next pending phase that is not the current phase.
+    const nextPendingPhase = findNextPendingPhase(applicablePhases, phaseStates, state.current_phase);
+    if (nextPendingPhase !== null) {
+        return { kind: 'phase', phase: nextPendingPhase };
+    }
+    // Step 5: No pending phases remain — all done.
+    return { kind: 'complete' };
+}
+/**
+ * Find the first required artifact in a template phase that is not yet complete.
+ *
+ * @returns The artifact name, or null if all required artifacts are complete.
+ */
+function findFirstIncompleteArtifact(templatePhase, phaseState) {
+    if (templatePhase.required_artifacts.length === 0) {
+        return null;
+    }
+    // Build a set of completed artifact names from the phase state
+    const completedArtifacts = new Set();
+    if (phaseState) {
+        for (const artifact of phaseState.artifacts) {
+            if (artifact.status === 'complete') {
+                completedArtifacts.add(artifact.name);
+            }
+        }
+    }
+    // Find the first required artifact that is not complete
+    for (const decl of templatePhase.required_artifacts) {
+        if (!completedArtifacts.has(decl.name)) {
+            return decl.name;
+        }
+    }
+    return null;
+}
+/**
+ * Find the next phase that is not yet complete or skipped, excluding the
+ * current phase (since we already checked its artifacts).
+ *
+ * Iterates through applicable phases in order. A phase is "pending" if
+ * its phase state status is not 'complete' and not 'skipped', or if
+ * no phase state exists for it yet (implicitly pending).
+ *
+ * @param currentPhase - The current phase to exclude from results.
+ * @returns The name of the next pending phase, or null if all are done/skipped.
+ */
+function findNextPendingPhase(applicablePhases, phaseStates, currentPhase) {
+    for (const templatePhase of applicablePhases) {
+        // Skip the current phase — its artifacts are already handled
+        if (templatePhase.name === currentPhase) {
+            continue;
+        }
+        const ps = phaseStates.get(templatePhase.name);
+        // No phase state → phase hasn't started → it's pending
+        if (!ps) {
+            return templatePhase.name;
+        }
+        // Phase exists but is neither complete nor skipped → still pending
+        if (ps.status !== 'complete' && ps.status !== 'skipped') {
+            return templatePhase.name;
+        }
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// evaluateTransition (Req 3.6, 6.6, 9.3, 24.6)
+// ---------------------------------------------------------------------------
+/**
+ * Gate chain — evaluates whether a phase transition is allowed.
+ * Returns Allowed or Blocked (with EVERY unsatisfied condition).
+ *
+ * Gate evaluation order:
+ * 1. Required artifacts of the current phase all "complete"
+ * 2. Review gate (if template configures one for this phase): no critical+open findings
+ * 3. Ownership guard: warn + require override if actor ≠ recorded owner
+ * 4. Deployment entry: every preceding required phase has recorded status "complete" (from state only)
+ * 5. Blocking actions (placeholder — currently no-op)
+ *
+ * A blocked attempt reports every unsatisfied condition (Req 4.4).
+ *
+ * @param state - Current instance state.
+ * @param phaseStates - Map of phase name → PhaseState for all phases in the instance.
+ * @param template - The resolved workflow template (no `extends`).
+ * @param actor - Identity of the user/agent attempting the transition.
+ * @param findings - Findings index keyed by artifact name.
+ * @param override - If true, suppresses the ownership violation.
+ * @returns TransitionResult — `{ allowed: true }` or `{ allowed: false, violations: [...] }`.
+ */
+export function evaluateTransition(state, phaseStates, template, actor, findings, override) {
+    const violations = [];
+    // Find the current phase in the resolved template
+    const currentPhaseName = state.current_phase;
+    const applicablePhases = phasesForScope(template, state.scope);
+    const currentTemplatePhase = applicablePhases.find((p) => p.name === currentPhaseName);
+    // Gate 1: Required artifacts — all must have status 'complete'
+    if (currentTemplatePhase) {
+        const currentPhaseState = phaseStates.get(currentPhaseName);
+        checkRequiredArtifacts(currentTemplatePhase, currentPhaseState, violations);
+    }
+    // Gate 2: Review gate — if template configures adversarial-review for this phase
+    checkReviewGate(template, currentPhaseName, findings, violations);
+    // Gate 3: Ownership guard — actor must match phase owner (unless override)
+    checkOwnership(phaseStates, currentPhaseName, actor, override, violations);
+    // Gate 4: Deployment entry — all preceding required phases must be complete
+    checkDeploymentEntry(applicablePhases, currentPhaseName, phaseStates, violations);
+    // Gate 5: Blocking actions (placeholder — no implementation yet)
+    // Future: check enabled blocking actions and add violations if any fail.
+    if (violations.length === 0) {
+        return { allowed: true };
+    }
+    return { allowed: false, violations };
+}
+// ---------------------------------------------------------------------------
+// Gate helpers
+// ---------------------------------------------------------------------------
+/**
+ * Check that all required artifacts in the current phase have status 'complete'.
+ */
+function checkRequiredArtifacts(templatePhase, phaseState, violations) {
+    if (!templatePhase.required_artifacts || templatePhase.required_artifacts.length === 0) {
+        return;
+    }
+    if (!phaseState) {
+        // Phase state doesn't exist — all artifacts are missing
+        for (const art of templatePhase.required_artifacts) {
+            violations.push({
+                gate: 'required-artifacts',
+                reason: `required artifact "${art.name}" is missing (no phase state)`,
+            });
+        }
+        return;
+    }
+    for (const requiredArt of templatePhase.required_artifacts) {
+        const tracked = phaseState.artifacts.find((a) => a.name === requiredArt.name);
+        if (!tracked || tracked.status !== 'complete') {
+            const status = tracked ? tracked.status : 'not-started';
+            violations.push({
+                gate: 'required-artifacts',
+                reason: `required artifact "${requiredArt.name}" is not complete (status: ${status})`,
+            });
+        }
+    }
+}
+/**
+ * If the template has an adversarial-review gate for the current phase,
+ * check that no finding with severity 'critical' and status 'open' exists.
+ */
+function checkReviewGate(template, currentPhaseName, findings, violations) {
+    const reviewGatePhases = template.gates?.['adversarial-review'];
+    if (!reviewGatePhases || !reviewGatePhases.includes(currentPhaseName)) {
+        return;
+    }
+    // Review gate is configured for this phase — check findings
+    const allFindings = Object.values(findings).flat();
+    // If no findings exist at all (no review has been done), block
+    if (allFindings.length === 0) {
+        violations.push({
+            gate: 'review-gate',
+            reason: `review gate requires a completed review for phase "${currentPhaseName}" but no findings exist`,
+        });
+        return;
+    }
+    // Block on any critical+open finding
+    const criticalOpen = allFindings.filter((f) => f.severity === 'critical' && f.status === 'open');
+    for (const finding of criticalOpen) {
+        violations.push({
+            gate: 'review-gate',
+            reason: `critical finding "${finding.id}" is still open: ${finding.title}`,
+        });
+    }
+}
+/**
+ * If phase ownership is set and actor ≠ owner, add an ownership violation
+ * (unless override is true).
+ */
+function checkOwnership(phaseStates, currentPhaseName, actor, override, violations) {
+    if (override) {
+        return;
+    }
+    const phaseState = phaseStates.get(currentPhaseName);
+    if (!phaseState || !phaseState.owner) {
+        return;
+    }
+    if (phaseState.owner !== actor) {
+        violations.push({
+            gate: 'ownership',
+            reason: `phase "${currentPhaseName}" is owned by "${phaseState.owner}" but transition attempted by "${actor}"; use override to proceed`,
+        });
+    }
+}
+/**
+ * If the next phase is 'deployment', verify that all preceding required phases
+ * have recorded status 'complete' or 'skipped' (from state only, not disk).
+ * The current phase is excluded from this check since its completion is
+ * validated by the required-artifacts gate.
+ */
+function checkDeploymentEntry(applicablePhases, currentPhaseName, phaseStates, violations) {
+    // Find the index of the current phase
+    const currentIdx = applicablePhases.findIndex((p) => p.name === currentPhaseName);
+    if (currentIdx === -1) {
+        return;
+    }
+    // Determine the next phase (the target of this transition)
+    const nextIdx = currentIdx + 1;
+    if (nextIdx >= applicablePhases.length) {
+        return;
+    }
+    const nextPhase = applicablePhases[nextIdx];
+    if (nextPhase.name !== 'deployment') {
+        return;
+    }
+    // Target is deployment — verify all preceding required phases (except current) are complete
+    for (let i = 0; i < currentIdx; i++) {
+        const phase = applicablePhases[i];
+        const ps = phaseStates.get(phase.name);
+        if (!ps || (ps.status !== 'complete' && ps.status !== 'skipped')) {
+            const status = ps ? ps.status : 'pending';
+            violations.push({
+                gate: 'deployment-entry',
+                reason: `phase "${phase.name}" must be complete before entering deployment (status: ${status})`,
+            });
+        }
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/core/lifecycle.js.map

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

package/dist/core/template-resolver.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Template resolution — inheritance, cycle-scope phase applicability.
+ *
+ * - `resolveTemplate()` applies the full inheritance chain (remove/override/add).
+ * - `loadTemplates()` loads all template YAML files from a directory.
+ * - `phasesForScope()` filters phases by cycle scope.
+ *
+ * Requirements: 8.1, 8.5, 5.1, 5.2
+ */
+import type { WorkflowTemplate, TemplatePhase, CycleScope } from './types.js';
+/**
+ * Error thrown when template resolution encounters a problem
+ * (cycle, missing parent, invalid insertion point).
+ */
+export declare class TemplateResolutionError extends Error {
+    constructor(message: string);
+}
+/**
+ * Get the applicable phases for a given cycle scope.
+ *
+ * Filters the resolved template's phases to include only those whose name
+ * appears in the scope's allowed phase set. Custom (non-core) phase names
+ * pass through for all scopes (they are never filtered out by scope rules).
+ *
+ * @param resolvedTemplate - A fully resolved template (no `extends`).
+ * @param scope - The cycle scope to filter by.
+ * @returns The subset of template phases applicable to the given scope.
+ */
+export declare function phasesForScope(resolvedTemplate: WorkflowTemplate, scope: CycleScope): TemplatePhase[];
+/**
+ * Resolve a template by applying its inheritance chain.
+ *
+ * Resolution algorithm:
+ *   1. If no `extends` → template is already resolved (return a copy with
+ *      inheritance fields cleared).
+ *   2. Load parent template, resolve it recursively (cycle-detected).
+ *   3. Start with parent's resolved phases.
+ *   4. Apply `remove`: filter out listed phases.
+ *   5. Apply `override`: for each phase name in override map, merge fields.
+ *   6. Apply `add`: insert new phases at declared positions (before/after).
+ *
+ * @param template - The template to resolve.
+ * @param allTemplates - Map of all available templates by name.
+ * @returns A fully resolved WorkflowTemplate (no `extends`, all phases concrete).
+ * @throws {TemplateResolutionError} On circular inheritance or missing parent.
+ */
+export declare function resolveTemplate(template: WorkflowTemplate, allTemplates: Map<string, WorkflowTemplate>): WorkflowTemplate;
+/**
+ * Load all templates from a directory. Each `.yaml` or `.yml` file is parsed
+ * as a WorkflowTemplate. Invalid files are skipped with a warning to stderr.
+ *
+ * @param templateDir - Path to the directory containing template YAML files.
+ * @returns A Map of template name → WorkflowTemplate.
+ */
+export declare function loadTemplates(templateDir: string): Map<string, WorkflowTemplate>;
+//# sourceMappingURL=template-resolver.d.ts.map

package/dist/core/template-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-resolver.d.ts","sourceRoot":"","sources":["../../src/core/template-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EAGb,UAAU,EAEX,MAAM,YAAY,CAAC;AAMpB;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAwBD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,gBAAgB,EAClC,KAAK,EAAE,UAAU,GAChB,aAAa,EAAE,CAUjB;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,gBAAgB,EAC1B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC1C,gBAAgB,CAElB;AA6ID;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CA+BhF"}