maestro-flow 0.3.8 → 0.3.9

package/dist/src/hooks/team-monitor.js

@@ -90,6 +90,22 @@ export function runTeamMonitor(input) {
                     ? input.tool_input.path
                     : undefined;
             if (filePath) {
+                // Detect task file writes to .workflow/collab/tasks/
+                if (filePath.includes('.workflow/collab/tasks/') || filePath.includes('.workflow\\collab\\tasks\\')) {
+                    const match = filePath.match(/tasks[\\/](TASK-\d+)\.json$/);
+                    if (match) {
+                        reportActivity({
+                            user: self.uid,
+                            host: self.host,
+                            action: 'task.edit',
+                            task_id: match[1],
+                            target: action.toLowerCase(),
+                        });
+                        return; // Report once for task edits; skip generic heartbeat below.
+                    }
+                }
+                // Namespace guard: check file write operations stay within boundaries.
+                // V1 is advisory — log warning but never block.
                 const guardResult = evaluateNamespaceGuard(filePath, self.uid, getProjectRoot());
                 if (!guardResult.allowed) {
                     console.error(`[TeamMonitor] WARNING: namespace violation (advisory): ${guardResult.reason}`);

package/dist/src/hooks/team-monitor.js.map

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

package/dist/src/tools/collab-adapter.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Collaboration adapter interface and registry (team-lite collaboration).
+ *
+ * Provides a pluggable notification layer that maps collab events to external
+ * services (DingTalk, Linear, etc.). Adapters are configured via
+ * `.workflow/collab/adapters.json` and instantiated on demand.
+ *
+ * Fire-and-forget contract: `notifyAdapters()` is synchronous (void return),
+ * spawns async work internally, and NEVER throws -- matching the
+ * `reportActivity` pattern in `team-activity.ts`.
+ *
+ * Strict namespace separation: this module belongs to the HUMAN collaboration
+ * domain (`.workflow/collab/`).
+ */
+export type CollabEventType = 'task.created' | 'task.assigned' | 'task.status_changed' | 'task.checked' | 'role.changed';
+export interface CollabEvent {
+    type: CollabEventType;
+    payload: Record<string, unknown>;
+    recipients?: string[];
+}
+export interface CollabAdapter {
+    name: string;
+    sendNotification(event: CollabEvent): Promise<void>;
+    validateConfig(config: Record<string, unknown>): boolean;
+}
+/**
+ * Adapter configuration shape.
+ *
+ * `enabled` lists adapter names to activate. Every other top-level key holds
+ * the per-adapter config block (arbitrary key-value pairs).
+ *
+ * The index signature uses `unknown` values so that both `Record<string, unknown>`
+ * (adapter config blocks) and `string[]` (the `enabled` field) are valid values.
+ */
+export interface AdapterConfig {
+    enabled: string[];
+    [adapterName: string]: unknown;
+}
+/** DingTalk webhook adapter with HMAC-SHA256 signing. */
+export declare class DingTalkAdapter implements CollabAdapter {
+    readonly name = "dingtalk";
+    private webhook;
+    private secret;
+    validateConfig(config: Record<string, unknown>): boolean;
+    sendNotification(event: CollabEvent): Promise<void>;
+}
+/** Linear GraphQL API adapter. */
+export declare class LinearAdapter implements CollabAdapter {
+    readonly name = "linear";
+    private apiKey;
+    private teamId;
+    validateConfig(config: Record<string, unknown>): boolean;
+    sendNotification(event: CollabEvent): Promise<void>;
+}
+/** Absolute path to the adapter configuration file. */
+export declare function getAdaptersConfigPath(): string;
+/**
+ * Read and parse the adapter config file.
+ *
+ * Returns `{ enabled: [] }` if the file is missing, empty, or fails to parse.
+ * Never throws -- graceful fallback on any I/O or JSON error.
+ */
+export declare function loadAdapterConfig(): AdapterConfig;
+/**
+ * Instantiate adapter classes based on the `enabled` array in config.
+ *
+ * For each name in `config.enabled`:
+ *   1. Look up the constructor in the built-in registry.
+ *   2. Instantiate and call `validateConfig` with the matching config block.
+ *   3. Keep only valid adapters; skip unknown or invalid ones.
+ *
+ * Returns an empty array when no adapters are configured or valid.
+ */
+export declare function getEnabledAdapters(config: AdapterConfig): CollabAdapter[];
+/**
+ * Send a collab event to all enabled adapters.
+ *
+ * Fire-and-forget: this function is synchronous (returns void), dispatches
+ * notifications in parallel via `Promise.allSettled`, and NEVER throws.
+ * Individual adapter failures are logged to `console.error`.
+ *
+ * No-op when no adapters are configured.
+ */
+export declare function notifyAdapters(event: CollabEvent): void;
+//# sourceMappingURL=collab-adapter.d.ts.map

package/dist/src/tools/collab-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collab-adapter.d.ts","sourceRoot":"","sources":["../../../src/tools/collab-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAaH,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,eAAe,GACf,qBAAqB,GACrB,cAAc,GACd,cAAc,CAAC;AAEnB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;CAC1D;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;CAChC;AAMD,yDAAyD;AACzD,qBAAa,eAAgB,YAAW,aAAa;IACnD,QAAQ,CAAC,IAAI,cAAc;IAC3B,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,MAAM,CAAM;IAEpB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAQlD,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAoB1D;AAMD,kCAAkC;AAClC,qBAAa,aAAc,YAAW,aAAa;IACjD,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,MAAM,CAAM;IAEpB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAQlD,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAQ1D;AAeD,uDAAuD;AACvD,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,CAYjD;AAMD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,EAAE,CAqBzE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAqBvD"}

package/dist/src/tools/collab-adapter.js

@@ -0,0 +1,320 @@
+/**
+ * Collaboration adapter interface and registry (team-lite collaboration).
+ *
+ * Provides a pluggable notification layer that maps collab events to external
+ * services (DingTalk, Linear, etc.). Adapters are configured via
+ * `.workflow/collab/adapters.json` and instantiated on demand.
+ *
+ * Fire-and-forget contract: `notifyAdapters()` is synchronous (void return),
+ * spawns async work internally, and NEVER throws -- matching the
+ * `reportActivity` pattern in `team-activity.ts`.
+ *
+ * Strict namespace separation: this module belongs to the HUMAN collaboration
+ * domain (`.workflow/collab/`).
+ */
+import { createHmac } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { request } from 'node:https';
+import { getProjectRoot } from '../utils/path-validator.js';
+// ---------------------------------------------------------------------------
+// Built-in adapter: DingTalk
+// ---------------------------------------------------------------------------
+/** DingTalk webhook adapter with HMAC-SHA256 signing. */
+export class DingTalkAdapter {
+    name = 'dingtalk';
+    webhook = '';
+    secret = '';
+    validateConfig(config) {
+        if (typeof config.webhook !== 'string' || !config.webhook)
+            return false;
+        if (typeof config.secret !== 'string' || !config.secret)
+            return false;
+        this.webhook = config.webhook;
+        this.secret = config.secret;
+        return true;
+    }
+    async sendNotification(event) {
+        const timestamp = Date.now();
+        const stringToSign = `${timestamp}\n${this.secret}`;
+        const hmac = createHmac('sha256', this.secret);
+        hmac.update(stringToSign);
+        const sign = encodeURIComponent(hmac.digest('base64'));
+        const url = new URL(this.webhook);
+        url.searchParams.set('timestamp', String(timestamp));
+        url.searchParams.set('sign', sign);
+        const body = JSON.stringify({
+            msgtype: 'text',
+            text: {
+                content: formatEventSummary(event),
+            },
+        });
+        await postJSON(url.href, body);
+    }
+}
+// ---------------------------------------------------------------------------
+// Built-in adapter: Linear
+// ---------------------------------------------------------------------------
+/** Linear GraphQL API adapter. */
+export class LinearAdapter {
+    name = 'linear';
+    apiKey = '';
+    teamId = '';
+    validateConfig(config) {
+        if (typeof config.apiKey !== 'string' || !config.apiKey)
+            return false;
+        if (typeof config.teamId !== 'string' || !config.teamId)
+            return false;
+        this.apiKey = config.apiKey;
+        this.teamId = config.teamId;
+        return true;
+    }
+    async sendNotification(event) {
+        const { query, variables } = buildLinearMutation(event, this.teamId);
+        const body = JSON.stringify({ query, variables });
+        await postJSON('https://api.linear.app/graphql', body, {
+            Authorization: this.apiKey,
+        });
+    }
+}
+// ---------------------------------------------------------------------------
+// Adapter registry
+// ---------------------------------------------------------------------------
+const BUILTIN_ADAPTERS = {
+    dingtalk: DingTalkAdapter,
+    linear: LinearAdapter,
+};
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+/** Absolute path to the adapter configuration file. */
+export function getAdaptersConfigPath() {
+    return join(getProjectRoot(), '.workflow', 'collab', 'adapters.json');
+}
+// ---------------------------------------------------------------------------
+// Config loading
+// ---------------------------------------------------------------------------
+/**
+ * Read and parse the adapter config file.
+ *
+ * Returns `{ enabled: [] }` if the file is missing, empty, or fails to parse.
+ * Never throws -- graceful fallback on any I/O or JSON error.
+ */
+export function loadAdapterConfig() {
+    const configPath = getAdaptersConfigPath();
+    try {
+        const raw = readFileSync(configPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object')
+            return { enabled: [] };
+        const obj = parsed;
+        if (!Array.isArray(obj.enabled))
+            return { enabled: [] };
+        return parsed;
+    }
+    catch {
+        return { enabled: [] };
+    }
+}
+// ---------------------------------------------------------------------------
+// Adapter instantiation
+// ---------------------------------------------------------------------------
+/**
+ * Instantiate adapter classes based on the `enabled` array in config.
+ *
+ * For each name in `config.enabled`:
+ *   1. Look up the constructor in the built-in registry.
+ *   2. Instantiate and call `validateConfig` with the matching config block.
+ *   3. Keep only valid adapters; skip unknown or invalid ones.
+ *
+ * Returns an empty array when no adapters are configured or valid.
+ */
+export function getEnabledAdapters(config) {
+    const adapters = [];
+    for (const name of config.enabled) {
+        const Ctor = BUILTIN_ADAPTERS[name];
+        if (!Ctor) {
+            console.error(`[collab-adapter] unknown adapter: ${name}`);
+            continue;
+        }
+        try {
+            const instance = new Ctor();
+            const block = config[name];
+            if (!instance.validateConfig(block ?? {})) {
+                console.error(`[collab-adapter] invalid config for adapter: ${name}`);
+                continue;
+            }
+            adapters.push(instance);
+        }
+        catch (err) {
+            console.error(`[collab-adapter] failed to instantiate adapter: ${name}`, err);
+        }
+    }
+    return adapters;
+}
+// ---------------------------------------------------------------------------
+// Main entry point
+// ---------------------------------------------------------------------------
+/**
+ * Send a collab event to all enabled adapters.
+ *
+ * Fire-and-forget: this function is synchronous (returns void), dispatches
+ * notifications in parallel via `Promise.allSettled`, and NEVER throws.
+ * Individual adapter failures are logged to `console.error`.
+ *
+ * No-op when no adapters are configured.
+ */
+export function notifyAdapters(event) {
+    try {
+        const config = loadAdapterConfig();
+        const adapters = getEnabledAdapters(config);
+        if (adapters.length === 0)
+            return;
+        const promises = adapters.map((adapter) => adapter.sendNotification(event));
+        Promise.allSettled(promises).then((results) => {
+            for (let i = 0; i < results.length; i++) {
+                const result = results[i];
+                if (result.status === 'rejected') {
+                    console.error(`[collab-adapter] ${adapters[i].name} notification failed:`, result.reason);
+                }
+            }
+        });
+    }
+    catch (err) {
+        console.error('[collab-adapter] unexpected error in notifyAdapters:', err);
+    }
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/** Format a human-readable one-liner from a collab event. */
+function formatEventSummary(event) {
+    const p = event.payload;
+    const who = typeof p.actor === 'string' ? p.actor : 'unknown';
+    const task = typeof p.task_title === 'string' ? p.task_title : '';
+    switch (event.type) {
+        case 'task.created':
+            return `${who} created task: ${task}`;
+        case 'task.assigned':
+            return `${who} assigned task: ${task} -> ${p.assignee ?? 'unknown'}`;
+        case 'task.status_changed':
+            return `${who} changed status: ${task} -> ${p.status ?? 'unknown'}`;
+        case 'task.checked':
+            return `${who} checked item in: ${task}`;
+        case 'role.changed':
+            return `${who} changed role: ${p.member ?? 'unknown'} -> ${p.role ?? 'unknown'}`;
+        default:
+            return `${who}: ${event.type}`;
+    }
+}
+/** Build a Linear GraphQL mutation for the given event type. */
+function buildLinearMutation(event, teamId) {
+    const p = event.payload;
+    const title = typeof p.task_title === 'string' ? p.task_title : 'Untitled';
+    const description = typeof p.description === 'string' ? p.description : '';
+    switch (event.type) {
+        case 'task.created':
+            return {
+                query: `
+          mutation CreateIssue($title: String!, $teamId: String!, $description: String) {
+            issueCreate(input: { title: $title, teamId: $teamId, description: $description }) {
+              success
+              issue { id title }
+            }
+          }
+        `,
+                variables: { title, teamId, description },
+            };
+        case 'task.status_changed': {
+            const linearState = mapToLinearState(p.status);
+            return {
+                query: `
+          mutation UpdateIssueState($issueId: String!, $stateId: String!) {
+            issueUpdate(id: $issueId, input: { stateId: $stateId }) {
+              success
+            }
+          }
+        `,
+                variables: { issueId: p.task_id ?? '', stateId: linearState },
+            };
+        }
+        case 'task.assigned': {
+            return {
+                query: `
+          mutation AssignIssue($issueId: String!, $assigneeId: String!) {
+            issueUpdate(id: $issueId, input: { assigneeId: $assigneeId }) {
+              success
+            }
+          }
+        `,
+                variables: { issueId: p.task_id ?? '', assigneeId: p.assignee_id ?? '' },
+            };
+        }
+        default:
+            // For events without a direct Linear mapping, create a comment.
+            return {
+                query: `
+          mutation CreateComment($issueId: String!, $body: String!) {
+            commentCreate(input: { issueId: $issueId, body: $body }) {
+              success
+            }
+          }
+        `,
+                variables: {
+                    issueId: p.task_id ?? '',
+                    body: formatEventSummary(event),
+                },
+            };
+    }
+}
+/** Map collab status strings to Linear state IDs (placeholder heuristic). */
+function mapToLinearState(status) {
+    const map = {
+        todo: 'Todo',
+        in_progress: 'In Progress',
+        done: 'Done',
+        cancelled: 'Cancelled',
+        backlog: 'Backlog',
+    };
+    return map[status] ?? status;
+}
+/**
+ * POST a JSON body to an HTTPS URL.
+ *
+ * Returns a promise that resolves on 2xx status and rejects otherwise.
+ * Uses only Node.js built-in `node:https` -- no external dependencies.
+ */
+function postJSON(url, body, extraHeaders = {}) {
+    return new Promise((resolve, reject) => {
+        const parsed = new URL(url);
+        const options = {
+            hostname: parsed.hostname,
+            port: parsed.port || 443,
+            path: parsed.pathname + parsed.search,
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Length': Buffer.byteLength(body),
+                ...extraHeaders,
+            },
+        };
+        const req = request(options, (res) => {
+            // Drain the response to free the connection.
+            const chunks = [];
+            res.on('data', (chunk) => chunks.push(chunk));
+            res.on('end', () => {
+                if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
+                    resolve();
+                }
+                else {
+                    const responseBody = Buffer.concat(chunks).toString('utf-8');
+                    reject(new Error(`HTTP ${res.statusCode} from ${parsed.hostname}: ${responseBody.slice(0, 200)}`));
+                }
+            });
+        });
+        req.on('error', reject);
+        req.write(body);
+        req.end();
+    });
+}
+//# sourceMappingURL=collab-adapter.js.map

package/dist/src/tools/collab-adapter.js.map

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

package/dist/src/tools/namespace-guard.d.ts

@@ -12,6 +12,8 @@
  *   SHARED (writable by any member):
  *     .workflow/collab/activity.jsonl
  *     .workflow/collab/overlays/manifest.json
+ *     .workflow/collab/tasks/TASK-*.json
+ *     .workflow/collab/tasks/.counter
  *   BLOCKED:
  *     Other members' files in the above namespaces.
  *

package/dist/src/tools/namespace-guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"namespace-guard.d.ts","sourceRoot":"","sources":["../../../src/tools/namespace-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AASH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAeD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,oBAAoB,CA8EtB;AAMD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAUrF"}
+{"version":3,"file":"namespace-guard.d.ts","sourceRoot":"","sources":["../../../src/tools/namespace-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AASH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAeD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,oBAAoB,CAwFtB;AAMD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAWrF"}

package/dist/src/tools/namespace-guard.js

@@ -12,6 +12,8 @@
  *   SHARED (writable by any member):
  *     .workflow/collab/activity.jsonl
  *     .workflow/collab/overlays/manifest.json
+ *     .workflow/collab/tasks/TASK-*.json
+ *     .workflow/collab/tasks/.counter
  *   BLOCKED:
  *     Other members' files in the above namespaces.
  *
@@ -102,6 +104,15 @@ export function evaluateNamespaceGuard(filePath, selfUid, projectRoot) {
         // Other overlay files (not a bundle, not manifest) — allow.
         return { allowed: true };
     }
+    // --- Tasks namespace (shared writable by any member) ---
+    if (collabRel.startsWith('tasks/')) {
+        const fileName = collabRel.slice('tasks/'.length);
+        if (fileName === '.counter' || /^TASK-\d+\.json$/.test(fileName)) {
+            return { allowed: true };
+        }
+        // Unknown files under tasks/ — allow (finer checks in team-tasks.ts).
+        return { allowed: true };
+    }
     // Other paths under .workflow/collab/ — allow by default (not namespaced).
     return { allowed: true };
 }
@@ -121,6 +132,7 @@ export function getNamespaceBoundaries(selfUid, projectRoot) {
         // Shared paths
         `${prefix}/activity.jsonl`,
         `${prefix}/overlays/manifest.json`,
+        `${prefix}/tasks/`,
     ];
 }
 //# sourceMappingURL=namespace-guard.js.map

package/dist/src/tools/namespace-guard.js.map

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

package/dist/src/tools/phase-gate-evaluator.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Phase Gate Evaluator — computes whether a phase is ready to be marked complete.
+ *
+ * Called by transition-recorder before appending a transition entry.
+ * Returns a structured result indicating whether completion is allowed,
+ * with reasons for blocking and whether --force can override.
+ */
+export interface GateResult {
+    /** Whether the phase may be marked complete */
+    allowed: boolean;
+    /** Human-readable reasons for blocking */
+    reasons: string[];
+    /** Whether --force can override (false when review verdict is BLOCK) */
+    overridable: boolean;
+}
+/** Subset of phase index.json fields consumed by the evaluator */
+export interface PhaseGateInput {
+    review?: {
+        verdict?: string;
+        findings_count?: number;
+    };
+    verification?: {
+        status?: string;
+        gaps?: Array<{
+            id?: string;
+            severity?: string;
+            description?: string;
+        }>;
+    };
+    validation?: {
+        status?: string;
+        test_coverage?: {
+            statements?: number;
+            branches?: number;
+            functions?: number;
+            lines?: number;
+        } | number | null;
+    };
+}
+/**
+ * Evaluate whether a phase is ready to transition to `completed`.
+ * Pure function — no I/O.
+ */
+export declare function evaluatePhaseGate(phase: PhaseGateInput): GateResult;
+//# sourceMappingURL=phase-gate-evaluator.d.ts.map

package/dist/src/tools/phase-gate-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-gate-evaluator.d.ts","sourceRoot":"","sources":["../../../src/tools/phase-gate-evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,wEAAwE;IACxE,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,YAAY,CAAC,EAAE;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,KAAK,CAAC;YAAE,EAAE,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACxE,CAAC;IACF,UAAU,CAAC,EAAE;QACX,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,MAAM,GAAG,IAAI,CAAC;KAChH,CAAC;CACH;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,CAkCnE"}

package/dist/src/tools/phase-gate-evaluator.js

@@ -0,0 +1,42 @@
+/**
+ * Phase Gate Evaluator — computes whether a phase is ready to be marked complete.
+ *
+ * Called by transition-recorder before appending a transition entry.
+ * Returns a structured result indicating whether completion is allowed,
+ * with reasons for blocking and whether --force can override.
+ */
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Evaluate whether a phase is ready to transition to `completed`.
+ * Pure function — no I/O.
+ */
+export function evaluatePhaseGate(phase) {
+    const reasons = [];
+    let hasHardBlock = false;
+    // Hard rule: review verdict BLOCK — not overridable
+    if (phase.review?.verdict === 'BLOCK') {
+        reasons.push(`review verdict is BLOCK (${phase.review.findings_count ?? '?'} findings)`);
+        hasHardBlock = true;
+    }
+    // Soft rule: high-severity verification gaps
+    if (phase.verification?.status === 'gaps_found') {
+        const gaps = phase.verification.gaps ?? [];
+        const highGaps = gaps.filter((g) => g.severity === 'high' || g.severity === 'critical');
+        if (highGaps.length > 0) {
+            reasons.push(`${highGaps.length} high/critical verification gap(s): ${highGaps.map((g) => g.id ?? g.description ?? 'unknown').join(', ')}`);
+        }
+    }
+    // Soft rule: zero test coverage
+    const cov = phase.validation?.test_coverage;
+    if (cov != null && typeof cov === 'object' && cov.lines === 0) {
+        reasons.push('0% test coverage');
+    }
+    return {
+        allowed: reasons.length === 0,
+        reasons,
+        overridable: !hasHardBlock,
+    };
+}
+//# sourceMappingURL=phase-gate-evaluator.js.map

package/dist/src/tools/phase-gate-evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-gate-evaluator.js","sourceRoot":"","sources":["../../../src/tools/phase-gate-evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+BH,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAqB;IACrD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,YAAY,GAAG,KAAK,CAAC;IAEzB,oDAAoD;IACpD,IAAI,KAAK,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,EAAE,CAAC;QACtC,OAAO,CAAC,IAAI,CACV,4BAA4B,KAAK,CAAC,MAAM,CAAC,cAAc,IAAI,GAAG,YAAY,CAC3E,CAAC;QACF,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,6CAA6C;IAC7C,IAAI,KAAK,CAAC,YAAY,EAAE,MAAM,KAAK,YAAY,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,IAAI,IAAI,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,IAAI,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC;QACxF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CACV,GAAG,QAAQ,CAAC,MAAM,uCAAuC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,WAAW,IAAI,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC9H,CAAC;QACJ,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,EAAE,aAAa,CAAC;IAC5C,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;QAC9D,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACnC,CAAC;IAED,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC;QAC7B,OAAO;QACP,WAAW,EAAE,CAAC,YAAY;KAC3B,CAAC;AACJ,CAAC"}