@planu/cli 0.63.7 → 0.64.0

package/dist/engine/ac-gap-detector/constants.js

@@ -0,0 +1,143 @@
+/** Numeric weight per priority (higher = more important). Used for sorting and scoring. */
+export const PRIORITY_ORDER = {
+    critical: 4,
+    high: 3,
+    medium: 2,
+    low: 1,
+};
+/** Keywords that indicate an existing AC already covers error handling. */
+export const ERROR_HANDLING_KEYWORDS = [
+    'error',
+    'fail',
+    'invalid',
+    'exception',
+    'reject',
+    '4xx',
+    '5xx',
+    'not found',
+    '404',
+    '500',
+    'timeout',
+    'unavailable',
+    'catch',
+    'handling',
+];
+/** Keywords that indicate existing ACs cover security concerns. */
+export const SECURITY_KEYWORDS = [
+    'auth',
+    'permission',
+    'role',
+    'unauthorized',
+    'forbidden',
+    'jwt',
+    'token',
+    'csrf',
+    'xss',
+    'inject',
+    'sanitize',
+    'rate limit',
+    'throttle',
+    'secure',
+    'encrypt',
+    'https',
+];
+/** Keywords that indicate existing ACs cover performance concerns. */
+export const PERFORMANCE_KEYWORDS = [
+    'performance',
+    'latency',
+    'response time',
+    'load',
+    'concurrent',
+    'throughput',
+    'cache',
+    'slow',
+    'fast',
+    'benchmark',
+    'sla',
+    'p95',
+    'p99',
+];
+/** Keywords that indicate existing ACs cover accessibility. */
+export const ACCESSIBILITY_KEYWORDS = [
+    'accessibility',
+    'a11y',
+    'wcag',
+    'aria',
+    'screen reader',
+    'keyboard',
+    'focus',
+    'contrast',
+    'alt text',
+];
+/** Keywords that indicate existing ACs cover input/data validation. */
+export const DATA_VALIDATION_KEYWORDS = [
+    'validate',
+    'validation',
+    'required field',
+    'max length',
+    'min length',
+    'format',
+    'schema',
+    'constraint',
+    'sanitize',
+    'input',
+    'boundary',
+];
+/** Keywords that indicate existing ACs cover observability. */
+export const OBSERVABILITY_KEYWORDS = [
+    'log',
+    'metric',
+    'trace',
+    'monitor',
+    'alert',
+    'audit',
+    'observability',
+    'telemetry',
+    'event',
+];
+/** Keywords that indicate existing ACs cover edge cases broadly. */
+export const EDGE_CASE_KEYWORDS = [
+    'edge',
+    'empty',
+    'null',
+    'boundary',
+    'concurrent',
+    'race condition',
+    'duplicate',
+    'overflow',
+    'underflow',
+    'missing',
+    'optional',
+];
+/** Keywords that indicate existing ACs cover rollback / undo. */
+export const ROLLBACK_KEYWORDS = [
+    'rollback',
+    'undo',
+    'revert',
+    'restore',
+    'migration',
+    'transaction',
+    'atomic',
+    'idempotent',
+];
+/** Signal words that suggest this spec likely has UI / frontend components. */
+export const WEB_UI_KEYWORDS = [
+    'ui',
+    'frontend',
+    'form',
+    'page',
+    'view',
+    'component',
+    'modal',
+    'button',
+    'screen',
+    'layout',
+    'render',
+    'display',
+    'react',
+    'vue',
+    'angular',
+    'html',
+    'css',
+];
+//# sourceMappingURL=constants.js.map

package/dist/engine/ac-gap-detector/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/engine/ac-gap-detector/constants.ts"],"names":[],"mappings":"AAGA,2FAA2F;AAC3F,MAAM,CAAC,MAAM,cAAc,GAAkC;IAC3D,QAAQ,EAAE,CAAC;IACX,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,GAAG,EAAE,CAAC;CACP,CAAC;AAEF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,uBAAuB,GAAsB;IACxD,OAAO;IACP,MAAM;IACN,SAAS;IACT,WAAW;IACX,QAAQ;IACR,KAAK;IACL,KAAK;IACL,WAAW;IACX,KAAK;IACL,KAAK;IACL,SAAS;IACT,aAAa;IACb,OAAO;IACP,UAAU;CACX,CAAC;AAEF,mEAAmE;AACnE,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,MAAM;IACN,YAAY;IACZ,MAAM;IACN,cAAc;IACd,WAAW;IACX,KAAK;IACL,OAAO;IACP,MAAM;IACN,KAAK;IACL,QAAQ;IACR,UAAU;IACV,YAAY;IACZ,UAAU;IACV,QAAQ;IACR,SAAS;IACT,OAAO;CACR,CAAC;AAEF,sEAAsE;AACtE,MAAM,CAAC,MAAM,oBAAoB,GAAsB;IACrD,aAAa;IACb,SAAS;IACT,eAAe;IACf,MAAM;IACN,YAAY;IACZ,YAAY;IACZ,OAAO;IACP,MAAM;IACN,MAAM;IACN,WAAW;IACX,KAAK;IACL,KAAK;IACL,KAAK;CACN,CAAC;AAEF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,sBAAsB,GAAsB;IACvD,eAAe;IACf,MAAM;IACN,MAAM;IACN,MAAM;IACN,eAAe;IACf,UAAU;IACV,OAAO;IACP,UAAU;IACV,UAAU;CACX,CAAC;AAEF,uEAAuE;AACvE,MAAM,CAAC,MAAM,wBAAwB,GAAsB;IACzD,UAAU;IACV,YAAY;IACZ,gBAAgB;IAChB,YAAY;IACZ,YAAY;IACZ,QAAQ;IACR,QAAQ;IACR,YAAY;IACZ,UAAU;IACV,OAAO;IACP,UAAU;CACX,CAAC;AAEF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,sBAAsB,GAAsB;IACvD,KAAK;IACL,QAAQ;IACR,OAAO;IACP,SAAS;IACT,OAAO;IACP,OAAO;IACP,eAAe;IACf,WAAW;IACX,OAAO;CACR,CAAC;AAEF,oEAAoE;AACpE,MAAM,CAAC,MAAM,kBAAkB,GAAsB;IACnD,MAAM;IACN,OAAO;IACP,MAAM;IACN,UAAU;IACV,YAAY;IACZ,gBAAgB;IAChB,WAAW;IACX,UAAU;IACV,WAAW;IACX,SAAS;IACT,UAAU;CACX,CAAC;AAEF,iEAAiE;AACjE,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,UAAU;IACV,MAAM;IACN,QAAQ;IACR,SAAS;IACT,WAAW;IACX,aAAa;IACb,QAAQ;IACR,YAAY;CACb,CAAC;AAEF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,IAAI;IACJ,UAAU;IACV,MAAM;IACN,MAAM;IACN,MAAM;IACN,WAAW;IACX,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,OAAO;IACP,KAAK;IACL,SAAS;IACT,MAAM;IACN,KAAK;CACN,CAAC"}

package/dist/engine/ac-gap-detector/gap-rules.d.ts

@@ -0,0 +1,16 @@
+import type { GapRule } from '../../types/ac-gap.js';
+export declare const ruleErrorHandling: GapRule;
+export declare const ruleSecurityAuth: GapRule;
+export declare const ruleDataValidation: GapRule;
+export declare const rulePerformance: GapRule;
+export declare const ruleAccessibility: GapRule;
+export declare const ruleEdgeCases: GapRule;
+export declare const ruleObservability: GapRule;
+export declare const ruleRollback: GapRule;
+/** All rules, ordered from highest to lowest default priority. */
+export declare const ALL_RULES: readonly GapRule[];
+/** Map from category name to its rule for targeted execution. */
+export declare const RULE_BY_CATEGORY: Record<string, GapRule>;
+/** Returns the rules to run given an optional category filter. */
+export declare function selectRules(categories?: string[]): readonly GapRule[];
+//# sourceMappingURL=gap-rules.d.ts.map

package/dist/engine/ac-gap-detector/gap-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gap-rules.d.ts","sourceRoot":"","sources":["../../../src/engine/ac-gap-detector/gap-rules.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAkB,OAAO,EAAE,MAAM,uBAAuB,CAAC;AA8BrE,eAAO,MAAM,iBAAiB,EAAE,OAe/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,OAoB9B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,OAmBhC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,OAmB7B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,OAkB/B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,OAmB3B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,OAmB/B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,OAmB1B,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,SAAS,EAAE,SAAS,OAAO,EASvC,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CASpD,CAAC;AAEF,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,OAAO,EAAE,CAOrE"}

package/dist/engine/ac-gap-detector/gap-rules.js

@@ -0,0 +1,180 @@
+import { containsAny } from './pattern-matcher.js';
+import { ERROR_HANDLING_KEYWORDS, SECURITY_KEYWORDS, PERFORMANCE_KEYWORDS, ACCESSIBILITY_KEYWORDS, DATA_VALIDATION_KEYWORDS, OBSERVABILITY_KEYWORDS, EDGE_CASE_KEYWORDS, ROLLBACK_KEYWORDS, } from './constants.js';
+/** Generates a sequential ID for a suggestion (e.g. "GAP-01"). */
+function nextId(ctx, prefix) {
+    const counter = ctx.idCounter;
+    counter.value += 1;
+    return `${prefix}-${String(counter.value).padStart(2, '0')}`;
+}
+/** Checks whether any existing AC already covers the given keywords. */
+function acCovers(acLines, keywords) {
+    const combined = acLines.join(' ').toLowerCase();
+    return containsAny(combined, keywords);
+}
+// ---------------------------------------------------------------------------
+// Individual gap rules
+// ---------------------------------------------------------------------------
+export const ruleErrorHandling = (ctx) => {
+    if (acCovers(ctx.acLines, ERROR_HANDLING_KEYWORDS)) {
+        return null;
+    }
+    return {
+        id: nextId(ctx, 'EH'),
+        category: 'error-handling',
+        priority: 'high',
+        suggestion: 'Add ACs covering error and failure scenarios',
+        rationale: 'No existing AC addresses error handling. Every user-facing operation should specify behavior on failure.',
+        example: 'When the operation fails due to a server error, the system shows an actionable error message and does not corrupt state.',
+    };
+};
+export const ruleSecurityAuth = (ctx) => {
+    if (acCovers(ctx.acLines, SECURITY_KEYWORDS)) {
+        return null;
+    }
+    // Only flag if the spec text mentions anything that could be user-facing or data-mutating
+    const mutableKeywords = ['create', 'update', 'delete', 'submit', 'write', 'post', 'put'];
+    if (!containsAny(ctx.fullText, mutableKeywords)) {
+        return null;
+    }
+    return {
+        id: nextId(ctx, 'SEC'),
+        category: 'security',
+        priority: 'critical',
+        suggestion: 'Add ACs specifying authentication and authorization requirements',
+        rationale: 'The spec describes mutable operations but no AC defines who is allowed to perform them.',
+        example: 'When an unauthenticated user attempts the action, the system returns 401 and logs the attempt.',
+    };
+};
+export const ruleDataValidation = (ctx) => {
+    if (acCovers(ctx.acLines, DATA_VALIDATION_KEYWORDS)) {
+        return null;
+    }
+    const inputKeywords = ['input', 'form', 'field', 'parameter', 'payload', 'body', 'request'];
+    if (!containsAny(ctx.fullText, inputKeywords)) {
+        return null;
+    }
+    return {
+        id: nextId(ctx, 'DV'),
+        category: 'data-validation',
+        priority: 'high',
+        suggestion: 'Add ACs covering input validation boundaries and constraints',
+        rationale: 'The spec references inputs or form fields but no AC defines validation rules, required fields, or format constraints.',
+        example: 'When the user submits a required field as empty, the system highlights the field and prevents submission.',
+    };
+};
+export const rulePerformance = (ctx) => {
+    if (acCovers(ctx.acLines, PERFORMANCE_KEYWORDS)) {
+        return null;
+    }
+    const heavyKeywords = ['list', 'search', 'query', 'load', 'export', 'report', 'bulk', 'batch'];
+    if (!containsAny(ctx.fullText, heavyKeywords)) {
+        return null;
+    }
+    return {
+        id: nextId(ctx, 'PERF'),
+        category: 'performance',
+        priority: 'medium',
+        suggestion: 'Add ACs defining acceptable response time or throughput',
+        rationale: 'The spec involves potentially expensive operations (search/list/bulk) but no AC defines performance expectations.',
+        example: 'When the user triggers a list/search, the response completes in under 2 seconds for up to 10,000 records.',
+    };
+};
+export const ruleAccessibility = (ctx) => {
+    if (!ctx.hasWebUi) {
+        return null;
+    }
+    if (acCovers(ctx.acLines, ACCESSIBILITY_KEYWORDS)) {
+        return null;
+    }
+    return {
+        id: nextId(ctx, 'A11Y'),
+        category: 'accessibility',
+        priority: 'medium',
+        suggestion: 'Add ACs verifying keyboard navigation and screen reader compatibility',
+        rationale: 'This spec appears to include UI components but no AC ensures WCAG accessibility compliance.',
+        example: 'When a keyboard-only user navigates the form, all interactive elements are reachable via Tab and operable via Enter/Space.',
+    };
+};
+export const ruleEdgeCases = (ctx) => {
+    if (acCovers(ctx.acLines, EDGE_CASE_KEYWORDS)) {
+        return null;
+    }
+    // Flag when there are fewer than 3 ACs — sparse specs likely miss edge cases
+    if (ctx.acLines.length >= 3) {
+        return null;
+    }
+    return {
+        id: nextId(ctx, 'EDGE'),
+        category: 'edge-cases',
+        priority: 'medium',
+        suggestion: 'Add ACs covering empty/null/boundary input conditions',
+        rationale: 'The spec has few acceptance criteria and likely misses edge cases such as empty collections, null values, or boundary inputs.',
+        example: 'When the dataset is empty, the system renders a clear empty-state message instead of an error.',
+    };
+};
+export const ruleObservability = (ctx) => {
+    if (acCovers(ctx.acLines, OBSERVABILITY_KEYWORDS)) {
+        return null;
+    }
+    const criticalKeywords = ['payment', 'billing', 'order', 'transaction', 'deploy', 'migration'];
+    if (!containsAny(ctx.fullText, criticalKeywords)) {
+        return null;
+    }
+    return {
+        id: nextId(ctx, 'OBS'),
+        category: 'observability',
+        priority: 'high',
+        suggestion: 'Add ACs specifying logging and audit trail requirements',
+        rationale: 'The spec involves business-critical operations that typically require audit logs or metrics.',
+        example: 'When the operation completes (or fails), an audit log entry is written with actor, timestamp, and outcome.',
+    };
+};
+export const ruleRollback = (ctx) => {
+    if (acCovers(ctx.acLines, ROLLBACK_KEYWORDS)) {
+        return null;
+    }
+    const migrationKeywords = ['migration', 'schema change', 'deploy', 'upgrade', 'rollout'];
+    if (!containsAny(ctx.fullText, migrationKeywords)) {
+        return null;
+    }
+    return {
+        id: nextId(ctx, 'RB'),
+        category: 'rollback',
+        priority: 'high',
+        suggestion: 'Add ACs covering rollback or undo behavior if the operation fails midway',
+        rationale: 'The spec describes a multi-step or migration-like operation but no AC defines the rollback strategy.',
+        example: 'When the migration fails partway through, the system rolls back all changes and the database is left in its original state.',
+    };
+};
+/** All rules, ordered from highest to lowest default priority. */
+export const ALL_RULES = [
+    ruleSecurityAuth,
+    ruleErrorHandling,
+    ruleDataValidation,
+    ruleRollback,
+    ruleObservability,
+    rulePerformance,
+    ruleAccessibility,
+    ruleEdgeCases,
+];
+/** Map from category name to its rule for targeted execution. */
+export const RULE_BY_CATEGORY = {
+    'error-handling': ruleErrorHandling,
+    security: ruleSecurityAuth,
+    'data-validation': ruleDataValidation,
+    performance: rulePerformance,
+    accessibility: ruleAccessibility,
+    'edge-cases': ruleEdgeCases,
+    observability: ruleObservability,
+    rollback: ruleRollback,
+};
+/** Returns the rules to run given an optional category filter. */
+export function selectRules(categories) {
+    if (!categories || categories.length === 0) {
+        return ALL_RULES;
+    }
+    return categories
+        .map((cat) => RULE_BY_CATEGORY[cat])
+        .filter((r) => r !== undefined);
+}
+//# sourceMappingURL=gap-rules.js.map

package/dist/engine/ac-gap-detector/gap-rules.js.map

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

package/dist/engine/ac-gap-detector/pattern-matcher.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Returns true if any keyword from the list appears in the text (case-insensitive).
+ */
+export declare function containsAny(text: string, keywords: readonly string[]): boolean;
+/**
+ * Extracts acceptance criteria lines from markdown text.
+ * Looks for lines starting with "- [ ]", "- [x]", "- [X]", numbered items, or "AC:" prefix.
+ * Returns an array of cleaned criterion strings.
+ */
+export declare function extractAcLines(markdown: string): string[];
+/**
+ * Computes a simple coverage score 0–100 based on how many gap categories
+ * are already addressed vs total expected categories.
+ */
+export declare function computeCoverageScore(coveredCategories: Set<string>, totalCategories: number): number;
+//# sourceMappingURL=pattern-matcher.d.ts.map

package/dist/engine/ac-gap-detector/pattern-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-matcher.d.ts","sourceRoot":"","sources":["../../../src/engine/ac-gap-detector/pattern-matcher.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAG9E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAwCzD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,EAC9B,eAAe,EAAE,MAAM,GACtB,MAAM,CAMR"}

package/dist/engine/ac-gap-detector/pattern-matcher.js

@@ -0,0 +1,62 @@
+// engine/ac-gap-detector/pattern-matcher.ts — Low-level keyword matching utilities (SPEC-156)
+/**
+ * Returns true if any keyword from the list appears in the text (case-insensitive).
+ */
+export function containsAny(text, keywords) {
+    const lower = text.toLowerCase();
+    return keywords.some((kw) => lower.includes(kw));
+}
+/**
+ * Extracts acceptance criteria lines from markdown text.
+ * Looks for lines starting with "- [ ]", "- [x]", "- [X]", numbered items, or "AC:" prefix.
+ * Returns an array of cleaned criterion strings.
+ */
+export function extractAcLines(markdown) {
+    const lines = markdown.split('\n');
+    const results = [];
+    // Track whether we are inside an acceptance criteria section.
+    // Sections start at a heading that matches AC keywords and end at the next heading.
+    const AC_HEADING = /^#{1,4}\s+(?:acceptance\s+criteria|ac\b)/i;
+    const ANY_HEADING = /^#{1,4}\s+/;
+    let insideAcSection = false;
+    for (const raw of lines) {
+        const line = raw.trim();
+        // Update section tracking when we hit a heading
+        if (ANY_HEADING.test(line)) {
+            insideAcSection = AC_HEADING.test(line);
+        }
+        // BDD / checkbox style: "- [ ] Given...", "- [x] When..." — always captured regardless of section
+        if (/^-\s*\[[ xX]\]/.test(line)) {
+            results.push(line.replace(/^-\s*\[[ xX]\]\s*/, '').trim());
+            continue;
+        }
+        // Numbered list: "1. When the user..." — always captured regardless of section
+        if (/^\d+\.\s+/.test(line)) {
+            results.push(line.replace(/^\d+\.\s+/, '').trim());
+            continue;
+        }
+        // "AC:" prefix — always captured regardless of section
+        if (/^ac:/i.test(line)) {
+            results.push(line.replace(/^ac:\s*/i, '').trim());
+            continue;
+        }
+        // Plain bullet (- or *) — only captured when inside an acceptance criteria section
+        // to avoid pulling in unrelated list items from other sections of the spec.
+        if (insideAcSection && /^[-*]\s+/.test(line) && line.length > 5) {
+            results.push(line.replace(/^[-*]\s+/, '').trim());
+        }
+    }
+    return results.filter((l) => l.length > 0);
+}
+/**
+ * Computes a simple coverage score 0–100 based on how many gap categories
+ * are already addressed vs total expected categories.
+ */
+export function computeCoverageScore(coveredCategories, totalCategories) {
+    if (totalCategories === 0) {
+        return 0;
+    }
+    const ratio = coveredCategories.size / totalCategories;
+    return Math.round(ratio * 100);
+}
+//# sourceMappingURL=pattern-matcher.js.map

package/dist/engine/ac-gap-detector/pattern-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-matcher.js","sourceRoot":"","sources":["../../../src/engine/ac-gap-detector/pattern-matcher.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAE9F;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,QAA2B;IACnE,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,8DAA8D;IAC9D,oFAAoF;IACpF,MAAM,UAAU,GAAG,2CAA2C,CAAC;IAC/D,MAAM,WAAW,GAAG,YAAY,CAAC;IACjC,IAAI,eAAe,GAAG,KAAK,CAAC;IAE5B,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAExB,gDAAgD;QAChD,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,eAAe,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;QAED,kGAAkG;QAClG,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3D,SAAS;QACX,CAAC;QACD,+EAA+E;QAC/E,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACnD,SAAS;QACX,CAAC;QACD,uDAAuD;QACvD,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAClD,SAAS;QACX,CAAC;QACD,mFAAmF;QACnF,4EAA4E;QAC5E,IAAI,eAAe,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,iBAA8B,EAC9B,eAAuB;IAEvB,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,GAAG,eAAe,CAAC;IACvD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;AACjC,CAAC"}

package/dist/engine/ac-gap-detector.d.ts

@@ -0,0 +1,3 @@
+export { analyzeAcGaps } from './ac-gap-detector/analyze-gaps.js';
+export { PRIORITY_ORDER } from './ac-gap-detector/constants.js';
+//# sourceMappingURL=ac-gap-detector.d.ts.map

package/dist/engine/ac-gap-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ac-gap-detector.d.ts","sourceRoot":"","sources":["../../src/engine/ac-gap-detector.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/engine/ac-gap-detector.js

@@ -0,0 +1,5 @@
+// engine/ac-gap-detector.ts — Analyzes a spec's acceptance criteria and finds gaps (SPEC-156)
+// Barrel re-export — implementation in src/engine/ac-gap-detector/ subdirectory
+export { analyzeAcGaps } from './ac-gap-detector/analyze-gaps.js';
+export { PRIORITY_ORDER } from './ac-gap-detector/constants.js';
+//# sourceMappingURL=ac-gap-detector.js.map

package/dist/engine/ac-gap-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ac-gap-detector.js","sourceRoot":"","sources":["../../src/engine/ac-gap-detector.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,gFAAgF;AAEhF,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/engine/audit-trail/attestation.d.ts

@@ -0,0 +1,11 @@
+import type { AttestationData } from '../../types/audit-trail.js';
+/**
+ * Generate an attestation document for all events of a given spec.
+ * Verifies chain integrity and embeds the result in the attestation.
+ *
+ * @param filePath  Absolute path to the project's audit-log.jsonl.
+ * @param projectId Project identifier.
+ * @param specId    Spec identifier to filter events for.
+ */
+export declare function generateAttestation(filePath: string, projectId: string, specId: string): Promise<AttestationData>;
+//# sourceMappingURL=attestation.d.ts.map

package/dist/engine/audit-trail/attestation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attestation.d.ts","sourceRoot":"","sources":["../../../src/engine/audit-trail/attestation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAA8B,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAe9F;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC,CAyB1B"}

package/dist/engine/audit-trail/attestation.js

@@ -0,0 +1,47 @@
+// engine/audit-trail/attestation.ts — Generate attestation document for a spec (SPEC-167)
+// Produces structured JSON (no runtime PDF deps required).
+import { randomUUID } from 'node:crypto';
+import { queryAuditLog } from './query.js';
+import { verifyChainIntegrity } from './verifier.js';
+/**
+ * Build an event-type frequency map from an array of events.
+ */
+function buildEventTypeSummary(events) {
+    const counts = {};
+    for (const ev of events) {
+        counts[ev.eventType] = (counts[ev.eventType] ?? 0) + 1;
+    }
+    return counts;
+}
+/**
+ * Generate an attestation document for all events of a given spec.
+ * Verifies chain integrity and embeds the result in the attestation.
+ *
+ * @param filePath  Absolute path to the project's audit-log.jsonl.
+ * @param projectId Project identifier.
+ * @param specId    Spec identifier to filter events for.
+ */
+export async function generateAttestation(filePath, projectId, specId) {
+    const [queryResult, chainResult] = await Promise.all([
+        queryAuditLog(filePath, { projectId, specId, limit: 1000 }),
+        verifyChainIntegrity(filePath),
+    ]);
+    const events = queryResult.events;
+    const timestamps = events.map((e) => e.timestamp).sort();
+    const summary = {
+        totalEvents: events.length,
+        firstEvent: timestamps[0],
+        lastEvent: timestamps[timestamps.length - 1],
+        eventTypes: buildEventTypeSummary(events),
+    };
+    return {
+        attestationId: randomUUID(),
+        generatedAt: new Date().toISOString(),
+        projectId,
+        specId,
+        events,
+        chainValid: chainResult.valid,
+        summary,
+    };
+}
+//# sourceMappingURL=attestation.js.map

package/dist/engine/audit-trail/attestation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attestation.js","sourceRoot":"","sources":["../../../src/engine/audit-trail/attestation.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,2DAA2D;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD;;GAEG;AACH,SAAS,qBAAqB,CAAC,MAAoB;IACjD,MAAM,MAAM,GAA4C,EAAE,CAAC;IAC3D,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;QACxB,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAAgB,EAChB,SAAiB,EACjB,MAAc;IAEd,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACnD,aAAa,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC3D,oBAAoB,CAAC,QAAQ,CAAC;KAC/B,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;IAClC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;IAEzD,MAAM,OAAO,GAAG;QACd,WAAW,EAAE,MAAM,CAAC,MAAM;QAC1B,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;QACzB,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5C,UAAU,EAAE,qBAAqB,CAAC,MAAM,CAAC;KAC1C,CAAC;IAEF,OAAO;QACL,aAAa,EAAE,UAAU,EAAE;QAC3B,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,SAAS;QACT,MAAM;QACN,MAAM;QACN,UAAU,EAAE,WAAW,CAAC,KAAK;QAC7B,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/engine/audit-trail/index.d.ts

@@ -0,0 +1,6 @@
+export { appendEvent } from './logger.js';
+export type { AppendEventInput } from './logger.js';
+export { queryAuditLog } from './query.js';
+export { verifyChainIntegrity } from './verifier.js';
+export { generateAttestation } from './attestation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/audit-trail/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/audit-trail/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/engine/audit-trail/index.js

@@ -0,0 +1,6 @@
+// engine/audit-trail/index.ts — Barrel export for audit-trail engine module (SPEC-167)
+export { appendEvent } from './logger.js';
+export { queryAuditLog } from './query.js';
+export { verifyChainIntegrity } from './verifier.js';
+export { generateAttestation } from './attestation.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/audit-trail/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/audit-trail/index.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAEvF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/engine/audit-trail/logger.d.ts

@@ -0,0 +1,17 @@
+import type { AuditEvent, AppendEventInput } from '../../types/audit-trail.js';
+export type { AppendEventInput };
+/**
+ * Compute SHA-256 hex digest of a string.
+ */
+export declare function sha256(input: string): string;
+/**
+ * Append a new audit event to the JSONL log at filePath.
+ * Each event's hash is derived from the previous entry's hash, forming a chain.
+ * The file is created (with parent dirs) if it does not exist.
+ *
+ * Writes are serialized per file via a promise queue to prevent race conditions
+ * that would break the hash chain when multiple events are appended concurrently.
+ */
+export declare function appendEvent(filePath: string, input: AppendEventInput): Promise<AuditEvent>;
+export { canonicalJson } from './utils.js';
+//# sourceMappingURL=logger.d.ts.map

package/dist/engine/audit-trail/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/engine/audit-trail/logger.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE/E,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5C;AA0DD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAgB1F;AAID,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}