@planu/cli 0.91.0 → 0.93.0

package/dist/engine/api-spec-generator/ac-builder.d.ts

@@ -0,0 +1,5 @@
+import type { ApiGeneratedAC, ApiParsedOperation } from '../../types/index.js';
+export declare function buildACs(operation: ApiParsedOperation): ApiGeneratedAC[];
+/** Format ACs as a markdown checklist string */
+export declare function formatACsAsMarkdown(acs: ApiGeneratedAC[]): string;
+//# sourceMappingURL=ac-builder.d.ts.map

package/dist/engine/api-spec-generator/ac-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ac-builder.d.ts","sourceRoot":"","sources":["../../../src/engine/api-spec-generator/ac-builder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AA4G/E,wBAAgB,QAAQ,CAAC,SAAS,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAgBxE;AAED,gDAAgD;AAChD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,MAAM,CAEjE"}

package/dist/engine/api-spec-generator/ac-builder.js

@@ -0,0 +1,114 @@
+// engine/api-spec-generator/ac-builder.ts — Build Planu ACs from parsed API operations (SPEC-286)
+// ---------------------------------------------------------------------------
+// Pattern-based AC generators
+// ---------------------------------------------------------------------------
+function buildRequiredFieldACs(operation) {
+    return operation.fields
+        .filter((f) => f.required)
+        .map((f) => ({
+        text: `Debe retornar 400 si \`${f.name}\` no está presente`,
+        source: 'required-field',
+    }));
+}
+function buildEmailFormatACs(operation) {
+    return operation.fields
+        .filter((f) => f.format === 'email')
+        .map((f) => ({
+        text: `Debe validar formato de email en el campo \`${f.name}\``,
+        source: 'email-format',
+    }));
+}
+function buildResponseCodeACs(operation) {
+    const acs = [];
+    const statusCodes = new Set(operation.responses.map((r) => r.statusCode));
+    if (statusCodes.has(401)) {
+        acs.push({
+            text: 'Debe retornar 401 si el token de autenticación es inválido o está ausente',
+            source: 'response-code',
+        });
+    }
+    if (statusCodes.has(403)) {
+        acs.push({
+            text: 'Debe retornar 403 si el usuario no tiene permisos suficientes',
+            source: 'response-code',
+        });
+    }
+    if (statusCodes.has(404)) {
+        acs.push({
+            text: 'Debe retornar 404 si el recurso solicitado no existe',
+            source: 'response-code',
+        });
+    }
+    if (statusCodes.has(409)) {
+        acs.push({
+            text: 'Debe retornar 409 si hay conflicto con el estado actual del recurso',
+            source: 'response-code',
+        });
+    }
+    if (statusCodes.has(422)) {
+        acs.push({
+            text: 'Debe retornar 422 con detalles de validación cuando los datos son semánticamente inválidos',
+            source: 'response-code',
+        });
+    }
+    if (statusCodes.has(429)) {
+        acs.push({
+            text: 'Debe implementar rate limiting y retornar 429 cuando se excede el límite',
+            source: 'rate-limit',
+        });
+    }
+    return acs;
+}
+function buildEnumFieldACs(operation) {
+    return operation.fields
+        .filter((f) => (f.enumValues ?? []).length > 0)
+        .map((f) => ({
+        text: `Debe rechazar valores inválidos en \`${f.name}\` — valores permitidos: ${(f.enumValues ?? []).join(', ')}`,
+        source: 'pattern',
+    }));
+}
+function buildHappyPathAC(operation) {
+    const method = operation.method?.toLowerCase() ?? operation.operationType ?? 'execute';
+    const resource = operation.resourceGroup;
+    const actionLabel = {
+        get: `retornar ${resource} correctamente`,
+        post: `crear ${resource} y retornar 201 con el recurso creado`,
+        put: `actualizar ${resource} y retornar 200`,
+        patch: `actualizar parcialmente ${resource} y retornar 200`,
+        delete: `eliminar ${resource} y retornar 204 o 200`,
+        query: `retornar los datos de ${resource} correctamente`,
+        mutation: `ejecutar la mutación en ${resource} y confirmar con el resultado`,
+        subscription: `establecer la suscripción a ${resource} y recibir eventos`,
+    };
+    const action = actionLabel[method] ?? `procesar operación en ${resource}`;
+    return {
+        text: `Debe ${action} cuando los datos son válidos`,
+        source: 'pattern',
+    };
+}
+// ---------------------------------------------------------------------------
+// Public builder
+// ---------------------------------------------------------------------------
+export function buildACs(operation) {
+    const acs = [
+        buildHappyPathAC(operation),
+        ...buildRequiredFieldACs(operation),
+        ...buildEmailFormatACs(operation),
+        ...buildEnumFieldACs(operation),
+        ...buildResponseCodeACs(operation),
+    ];
+    // Deduplicate by text
+    const seen = new Set();
+    return acs.filter((ac) => {
+        if (seen.has(ac.text)) {
+            return false;
+        }
+        seen.add(ac.text);
+        return true;
+    });
+}
+/** Format ACs as a markdown checklist string */
+export function formatACsAsMarkdown(acs) {
+    return acs.map((ac) => `- [ ] ${ac.text}`).join('\n');
+}
+//# sourceMappingURL=ac-builder.js.map

package/dist/engine/api-spec-generator/ac-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ac-builder.js","sourceRoot":"","sources":["../../../src/engine/api-spec-generator/ac-builder.ts"],"names":[],"mappings":"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"}

package/dist/engine/api-spec-generator/graphql-parser.d.ts

@@ -0,0 +1,3 @@
+import type { OpenApiContract } from '../../types/index.js';
+export declare function parseGraphQL(sdl: string): OpenApiContract;
+//# sourceMappingURL=graphql-parser.d.ts.map

package/dist/engine/api-spec-generator/graphql-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-parser.d.ts","sourceRoot":"","sources":["../../../src/engine/api-spec-generator/graphql-parser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EAMhB,MAAM,sBAAsB,CAAC;AAwI9B,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CA8CzD"}

package/dist/engine/api-spec-generator/graphql-parser.js

@@ -0,0 +1,166 @@
+// engine/api-spec-generator/graphql-parser.ts — Parse GraphQL SDL strings (SPEC-286)
+// ---------------------------------------------------------------------------
+// Minimal SDL text parser
+// ---------------------------------------------------------------------------
+/** Strip comment lines from SDL */
+function stripComments(sdl) {
+    return sdl.replace(/#[^\n]*/g, '').trim();
+}
+/** Extract the inner type name, stripping [], !, wrapping */
+function unwrapType(typeStr) {
+    return typeStr.replace(/[[\]!]/g, '').trim();
+}
+/** Determine if a GraphQL type string is non-null (ends with !) */
+function isRequired(typeStr) {
+    const stripped = typeStr.replace(/\[.*\]/, '').trim();
+    return stripped.endsWith('!');
+}
+/** Parse fields from inside an SDL type body: "name: Type" lines */
+function parseTypeFields(body) {
+    const fields = [];
+    const fieldPattern = /^\s*(\w+)\s*(?:\([^)]*\))?\s*:\s*([^\s#]+)/gm;
+    let match;
+    while ((match = fieldPattern.exec(body)) !== null) {
+        const name = match[1] ?? '';
+        const typeStr = match[2] ?? '';
+        if (name.length === 0 || typeStr.length === 0) {
+            continue;
+        }
+        fields.push({
+            name,
+            type: unwrapType(typeStr),
+            required: isRequired(typeStr),
+        });
+    }
+    return fields;
+}
+/** Extract all type definitions as a map of name → fields */
+function extractTypeMap(sdl) {
+    const typeMap = new Map();
+    const typePattern = /(?:type|input)\s+(\w+)\s*(?:implements\s+\w+\s*)?{([^}]*)}/g;
+    let match;
+    while ((match = typePattern.exec(sdl)) !== null) {
+        const name = match[1] ?? '';
+        const body = match[2] ?? '';
+        if (name.length === 0) {
+            continue;
+        }
+        typeMap.set(name, parseTypeFields(body));
+    }
+    return typeMap;
+}
+/** Extract operations from Query/Mutation/Subscription type bodies */
+function extractOperations(sdl, typeMap) {
+    const operations = [];
+    const operationKinds = ['query', 'mutation', 'subscription'];
+    for (const kind of operationKinds) {
+        const typeName = kind.charAt(0).toUpperCase() + kind.slice(1);
+        const pattern = new RegExp(`type\\s+${typeName}\\s*{([^}]*)}`, 'i');
+        const match = pattern.exec(sdl);
+        if (match === null) {
+            continue;
+        }
+        const body = match[1] ?? '';
+        const opPattern = /^\s*(\w+)\s*(?:\(([^)]*)\))?\s*:\s*([^\s#\n]+)/gm;
+        let opMatch;
+        while ((opMatch = opPattern.exec(body)) !== null) {
+            const name = opMatch[1] ?? '';
+            const argsStr = opMatch[2] ?? '';
+            const returnTypeStr = opMatch[3] ?? '';
+            if (name.length === 0) {
+                continue;
+            }
+            const argFields = [];
+            if (argsStr.trim().length > 0) {
+                const argPattern = /(\w+)\s*:\s*([^\s,)]+)/g;
+                let argMatch;
+                while ((argMatch = argPattern.exec(argsStr)) !== null) {
+                    const argName = argMatch[1] ?? '';
+                    const argType = argMatch[2] ?? '';
+                    const innerType = unwrapType(argType);
+                    const inputFields = typeMap.get(innerType);
+                    if (inputFields !== undefined && inputFields.length > 0) {
+                        argFields.push(...inputFields);
+                    }
+                    else {
+                        argFields.push({
+                            name: argName,
+                            type: innerType,
+                            required: isRequired(argType),
+                        });
+                    }
+                }
+            }
+            operations.push({
+                name,
+                kind,
+                fields: argFields,
+                returnType: unwrapType(returnTypeStr),
+                description: '',
+            });
+        }
+    }
+    return operations;
+}
+/** Convert a camelCase operation name to a title */
+function operationTitle(name, kind) {
+    const spaced = name.replace(/([A-Z])/g, ' $1').trim();
+    const titled = spaced.charAt(0).toUpperCase() + spaced.slice(1);
+    if (kind === 'subscription') {
+        return `${titled} Subscription`;
+    }
+    return titled;
+}
+// ---------------------------------------------------------------------------
+// Synthetic response info for GraphQL
+// ---------------------------------------------------------------------------
+function syntheticResponses() {
+    return [
+        { statusCode: 200, description: 'Successful response with data payload' },
+        { statusCode: 200, description: 'Partial error: data with errors array' },
+    ];
+}
+// ---------------------------------------------------------------------------
+// Main parser
+// ---------------------------------------------------------------------------
+export function parseGraphQL(sdl) {
+    if (sdl.trim().length === 0) {
+        throw new Error('GraphQL SDL is empty');
+    }
+    const stripped = stripComments(sdl);
+    const typeMap = extractTypeMap(stripped);
+    const rawOperations = extractOperations(stripped, typeMap);
+    if (rawOperations.length === 0) {
+        throw new Error('No Query, Mutation, or Subscription types found in GraphQL SDL');
+    }
+    const operations = rawOperations.map((op) => {
+        const title = operationTitle(op.name, op.kind);
+        const resourceGroup = op.returnType.length > 0
+            ? op.returnType.charAt(0).toUpperCase() + op.returnType.slice(1)
+            : title;
+        const fields = op.fields.map((f) => ({
+            name: f.name,
+            type: f.type,
+            required: f.required,
+            description: f.description,
+        }));
+        return {
+            externalId: op.name,
+            title,
+            description: op.description ?? `GraphQL ${op.kind}: ${op.name}`,
+            operationType: op.kind,
+            tags: [op.kind],
+            fields,
+            responses: syntheticResponses(),
+            resourceGroup,
+        };
+    });
+    return {
+        source: 'graphql',
+        title: 'GraphQL API',
+        version: '1.0.0',
+        description: 'GraphQL schema operations',
+        operations,
+    };
+}
+//# sourceMappingURL=graphql-parser.js.map

package/dist/engine/api-spec-generator/graphql-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-parser.js","sourceRoot":"","sources":["../../../src/engine/api-spec-generator/graphql-parser.ts"],"names":[],"mappings":"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"}

package/dist/engine/api-spec-generator/openapi-parser.d.ts

@@ -0,0 +1,3 @@
+import type { OpenApiContract } from '../../types/index.js';
+export declare function parseOpenApi(jsonContent: string): OpenApiContract;
+//# sourceMappingURL=openapi-parser.d.ts.map

package/dist/engine/api-spec-generator/openapi-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-parser.d.ts","sourceRoot":"","sources":["../../../src/engine/api-spec-generator/openapi-parser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EAUhB,MAAM,sBAAsB,CAAC;AAwJ9B,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAuBjE"}

package/dist/engine/api-spec-generator/openapi-parser.js

@@ -0,0 +1,161 @@
+// engine/api-spec-generator/openapi-parser.ts — Parse OpenAPI 3.x / Swagger 2.0 JSON (SPEC-286)
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const HTTP_METHODS = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'];
+function resolveRef(ref, doc) {
+    const parts = ref.replace(/^#\//, '').split('/');
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let current = doc;
+    for (const part of parts) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
+        current = current?.[part];
+        if (current === undefined || current === null) {
+            return undefined;
+        }
+    }
+    return current;
+}
+function extractFieldsFromSchema(schema, doc, requiredFields = []) {
+    const resolvedSchema = schema.$ref !== undefined ? (resolveRef(schema.$ref, doc) ?? schema) : schema;
+    const schemaRequired = resolvedSchema.required ?? [];
+    const allRequired = [...new Set([...requiredFields, ...schemaRequired])];
+    const fields = [];
+    const properties = resolvedSchema.properties ?? {};
+    for (const [name, prop] of Object.entries(properties)) {
+        const resolved = prop.$ref !== undefined ? (resolveRef(prop.$ref, doc) ?? prop) : prop;
+        fields.push({
+            name,
+            type: resolved.type ?? 'string',
+            required: allRequired.includes(name),
+            format: resolved.format,
+            description: resolved.description,
+            enumValues: resolved.enum,
+        });
+    }
+    return fields;
+}
+function extractParameterFields(params, doc) {
+    return params.map((p) => {
+        const schema = p.schema ?? {};
+        const resolved = schema.$ref !== undefined ? (resolveRef(schema.$ref, doc) ?? schema) : schema;
+        return {
+            name: p.name ?? 'unknown',
+            type: resolved.type ?? 'string',
+            required: p.required === true,
+            format: resolved.format,
+            description: p.description ?? resolved.description,
+            enumValues: resolved.enum,
+        };
+    });
+}
+function extractRequestBodyFields(body, doc) {
+    const jsonContent = body.content?.['application/json'];
+    if (jsonContent === undefined) {
+        return [];
+    }
+    const schema = jsonContent.schema;
+    if (schema === undefined) {
+        return [];
+    }
+    return extractFieldsFromSchema(schema, doc);
+}
+function extractResponses(responses) {
+    return Object.entries(responses).map(([code, resp]) => ({
+        statusCode: parseInt(code, 10),
+        description: resp.description ?? '',
+    }));
+}
+function deriveResourceGroup(path, tags) {
+    if (tags.length > 0) {
+        return tags[0] ?? 'General';
+    }
+    const segments = path.split('/').filter((s) => s.length > 0 && !s.startsWith('{'));
+    const skip = new Set(['api', 'v1', 'v2', 'v3', 'rest']);
+    const meaningful = segments.find((s) => !skip.has(s.toLowerCase()));
+    if (meaningful === undefined) {
+        return 'General';
+    }
+    return meaningful.charAt(0).toUpperCase() + meaningful.slice(1);
+}
+function buildTitle(method, path, summary) {
+    if (summary !== undefined && summary.trim().length > 0) {
+        return summary.trim();
+    }
+    const methodLabel = {
+        get: 'Get',
+        post: 'Create',
+        put: 'Update',
+        patch: 'Patch',
+        delete: 'Delete',
+        head: 'Head',
+        options: 'Options',
+    };
+    const segments = path.split('/').filter((s) => s.length > 0 && !s.startsWith('{'));
+    const skip = new Set(['api', 'v1', 'v2', 'v3', 'rest']);
+    const resource = segments
+        .filter((s) => !skip.has(s.toLowerCase()))
+        .map((s) => s.charAt(0).toUpperCase() + s.slice(1))
+        .join(' ');
+    return `${methodLabel[method.toLowerCase()] ?? method.toUpperCase()} ${resource}`.trim();
+}
+// ---------------------------------------------------------------------------
+// Main parser helpers
+// ---------------------------------------------------------------------------
+function extractPathItemOperations(path, pathItem, doc) {
+    const ops = [];
+    for (const method of HTTP_METHODS) {
+        const op = pathItem[method];
+        if (op === undefined) {
+            continue;
+        }
+        const tags = op.tags ?? [];
+        const fields = [
+            ...extractParameterFields(op.parameters ?? [], doc),
+            ...(op.requestBody !== undefined ? extractRequestBodyFields(op.requestBody, doc) : []),
+        ];
+        const responses = op.responses !== undefined ? extractResponses(op.responses) : [];
+        const externalId = op.operationId !== undefined && op.operationId.length > 0
+            ? op.operationId
+            : `${method.toUpperCase()} ${path}`;
+        ops.push({
+            externalId,
+            title: buildTitle(method, path, op.summary),
+            description: op.description ?? op.summary ?? '',
+            method: method.toUpperCase(),
+            path,
+            tags,
+            fields,
+            responses,
+            resourceGroup: deriveResourceGroup(path, tags),
+        });
+    }
+    return ops;
+}
+// ---------------------------------------------------------------------------
+// Main parser
+// ---------------------------------------------------------------------------
+export function parseOpenApi(jsonContent) {
+    let doc;
+    try {
+        doc = JSON.parse(jsonContent);
+    }
+    catch {
+        throw new Error('Invalid OpenAPI JSON: failed to parse document');
+    }
+    const source = doc.swagger !== undefined ? 'swagger' : 'openapi';
+    const title = doc.info?.title ?? 'Untitled API';
+    const version = doc.info?.version ?? '1.0.0';
+    const description = doc.info?.description ?? '';
+    const paths = doc.paths ?? {};
+    const operations = [];
+    for (const [path, rawPathItem] of Object.entries(paths)) {
+        if (rawPathItem === null || rawPathItem === undefined || typeof rawPathItem !== 'object') {
+            continue;
+        }
+        const pathItem = rawPathItem;
+        operations.push(...extractPathItemOperations(path, pathItem, doc));
+    }
+    return { source, title, version, description, operations };
+}
+//# sourceMappingURL=openapi-parser.js.map

package/dist/engine/api-spec-generator/openapi-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-parser.js","sourceRoot":"","sources":["../../../src/engine/api-spec-generator/openapi-parser.ts"],"names":[],"mappings":"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"}

package/dist/engine/approval-workflow.d.ts

@@ -0,0 +1,21 @@
+import type { ApprovalPolicy, ApprovalRecord, ApprovalStatus, SLAStatus } from '../types/approval.js';
+/**
+ * Verify whether a spec meets the required approval count.
+ * Returns null when the gate is satisfied, or an error message when not.
+ */
+export declare function checkApprovalGate(records: ApprovalRecord[], policy: ApprovalPolicy, specId: string): string | null;
+/**
+ * Calculate how many hours a spec has been in review.
+ * reviewStartedAt should be an ISO 8601 string.
+ * Returns 0 when reviewStartedAt is not provided.
+ */
+export declare function hoursInReview(reviewStartedAt: string | undefined): number;
+/**
+ * Compute SLA breach status given the start of review and the policy.
+ */
+export declare function calculateSLAStatus(reviewStartedAt: string | undefined, policy: ApprovalPolicy | null): SLAStatus;
+/**
+ * Build the full ApprovalStatus for a spec.
+ */
+export declare function buildApprovalStatus(specId: string, records: ApprovalRecord[], policy: ApprovalPolicy | null, reviewStartedAt: string | undefined): ApprovalStatus;
+//# sourceMappingURL=approval-workflow.d.ts.map

package/dist/engine/approval-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-workflow.d.ts","sourceRoot":"","sources":["../../src/engine/approval-workflow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,SAAS,EACV,MAAM,sBAAsB,CAAC;AAM9B;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EAAE,EACzB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAWf;AASD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CASzE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,MAAM,EAAE,cAAc,GAAG,IAAI,GAC5B,SAAS,CAeX;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc,EAAE,EACzB,MAAM,EAAE,cAAc,GAAG,IAAI,EAC7B,eAAe,EAAE,MAAM,GAAG,SAAS,GAClC,cAAc,CAyBhB"}

package/dist/engine/approval-workflow.js

@@ -0,0 +1,82 @@
+// engine/approval-workflow.ts — Approval workflow business logic (SPEC-283)
+// Handles: gate check, SLA calculation, status aggregation.
+// ---------------------------------------------------------------------------
+// Gate check
+// ---------------------------------------------------------------------------
+/**
+ * Verify whether a spec meets the required approval count.
+ * Returns null when the gate is satisfied, or an error message when not.
+ */
+export function checkApprovalGate(records, policy, specId) {
+    const approvals = records.filter((r) => r.specId === specId && r.action === 'approved');
+    if (approvals.length >= policy.requiredApprovals) {
+        return null;
+    }
+    return (`Spec ${specId} requires ${String(policy.requiredApprovals)} approval(s), ` +
+        `currently has ${String(approvals.length)}. Use approve_spec to add approvals.`);
+}
+// ---------------------------------------------------------------------------
+// SLA calculation
+// ---------------------------------------------------------------------------
+/** Milliseconds in one hour. */
+const MS_PER_HOUR = 3_600_000;
+/**
+ * Calculate how many hours a spec has been in review.
+ * reviewStartedAt should be an ISO 8601 string.
+ * Returns 0 when reviewStartedAt is not provided.
+ */
+export function hoursInReview(reviewStartedAt) {
+    if (reviewStartedAt === undefined || reviewStartedAt === '') {
+        return 0;
+    }
+    const start = new Date(reviewStartedAt).getTime();
+    if (isNaN(start)) {
+        return 0;
+    }
+    return (Date.now() - start) / MS_PER_HOUR;
+}
+/**
+ * Compute SLA breach status given the start of review and the policy.
+ */
+export function calculateSLAStatus(reviewStartedAt, policy) {
+    const elapsed = hoursInReview(reviewStartedAt);
+    if (policy === null || elapsed === 0) {
+        return { slaBreached: false, slaBreachHours: 0, hoursInReview: elapsed };
+    }
+    const breach = elapsed > policy.reviewSLAHours;
+    const breachHours = breach ? elapsed - policy.reviewSLAHours : 0;
+    return {
+        slaBreached: breach,
+        slaBreachHours: Math.round(breachHours * 100) / 100,
+        hoursInReview: Math.round(elapsed * 100) / 100,
+    };
+}
+// ---------------------------------------------------------------------------
+// Status aggregation
+// ---------------------------------------------------------------------------
+/**
+ * Build the full ApprovalStatus for a spec.
+ */
+export function buildApprovalStatus(specId, records, policy, reviewStartedAt) {
+    const approvals = records.filter((r) => r.specId === specId && r.action === 'approved');
+    const approvalCount = approvals.length;
+    const required = policy?.requiredApprovals ?? 0;
+    const approvalsNeeded = Math.max(0, required - approvalCount);
+    const gateOpen = policy === null || approvalCount >= required;
+    const approvers = approvals.map((r) => r.reviewer);
+    const sla = calculateSLAStatus(reviewStartedAt, policy);
+    return {
+        specId,
+        approvalCount,
+        approvalsNeeded,
+        gateOpen,
+        approvers,
+        records,
+        slaBreached: sla.slaBreached,
+        slaBreachHours: sla.slaBreachHours,
+        hoursInReview: sla.hoursInReview,
+        reviewStartedAt,
+        policy: policy ?? undefined,
+    };
+}
+//# sourceMappingURL=approval-workflow.js.map

package/dist/engine/approval-workflow.js.map

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

package/dist/engine/best-practices-library.d.ts

@@ -0,0 +1,31 @@
+import type { DomainBestPractice, CriteriaSuggestion } from '../types/index.js';
+declare const COVERAGE_THRESHOLD = 0.75;
+/**
+ * Checks whether a criterion is already covered in existing spec content.
+ * Uses simple keyword-overlap (fuzzy): if any coverageKeyword appears in the spec
+ * content, the criterion is considered covered.
+ */
+export declare function isCriterionCovered(practice: DomainBestPractice, specContent: string): boolean;
+/**
+ * Compute a rough coverage score between 0..1 based on keyword overlap.
+ * Not used for hard decisions — exposed for testing and future UI use.
+ */
+export declare function coverageScore(practice: DomainBestPractice, specContent: string): number;
+/**
+ * Load all best practices from the 3-layer config system.
+ */
+export declare function loadBestPractices(projectHash?: string): DomainBestPractice[];
+/**
+ * Get best practices for a specific domain.
+ */
+export declare function getPracticesForDomain(domain: string, projectHash?: string): DomainBestPractice[];
+/**
+ * Compute criteria suggestions for a given list of detected domains and spec content.
+ *
+ * For each domain:
+ * - Filters out criteria already covered in spec content (fuzzy keyword match)
+ * - Returns suggested and already-covered criteria separately
+ */
+export declare function computeSuggestions(domains: string[], specContent: string, projectHash?: string): CriteriaSuggestion[];
+export { COVERAGE_THRESHOLD };
+//# sourceMappingURL=best-practices-library.d.ts.map