@planu/cli 0.15.2

package/dist/engine/doc-generator/team-generators.js

@@ -0,0 +1,233 @@
+// Planu — Team Document Generators
+// Generates team-type documents: architecture-decision-log, contributing
+// ── Private helpers ──────────────────────────────────────────────────────────
+function buildAdrIndexSection(adrs) {
+    return {
+        title: 'Index',
+        level: 2,
+        content: adrs
+            .map((s, idx) => {
+            const statusIcon = s.status === 'done' ? '✅' : s.status === 'implementing' ? '🔄' : '📝';
+            return `${idx + 1}. ${statusIcon} [${s.id}: ${s.title}](#${s.id.toLowerCase().replace(/[^a-z0-9]/g, '-')}) — ${s.status}`;
+        })
+            .join('\n'),
+    };
+}
+function buildAdrStatusSections(accepted, inProgress, pending, draft) {
+    const sections = [];
+    if (accepted.length > 0) {
+        sections.push({
+            title: 'Accepted Decisions',
+            level: 2,
+            content: accepted
+                .map((s) => [
+                `### ${s.id}: ${s.title}`,
+                '',
+                `**Status:** Accepted | **Date:** ${s.updatedAt}`,
+                s.tags.length > 0 ? `**Tags:** ${s.tags.join(', ')}` : '',
+                '',
+                `**Dependencies:** ${s.dependencies.length > 0 ? s.dependencies.join(', ') : 'none'}`,
+                '',
+                `See [${s.id}](${s.huPath}) for full details and acceptance criteria.`,
+            ]
+                .filter(Boolean)
+                .join('\n'))
+                .join('\n\n'),
+        });
+    }
+    if (inProgress.length > 0) {
+        sections.push({
+            title: 'In Progress',
+            level: 2,
+            content: inProgress
+                .map((s) => `### ${s.id}: ${s.title}\n\n**Status:** In Progress — decision being implemented.\n\nSee [${s.id}](${s.huPath}) for details.`)
+                .join('\n\n'),
+        });
+    }
+    /* v8 ignore start */ // pending-review branch — requires spec with 'pending' status (rare in tests)
+    if (pending.length > 0) {
+        sections.push({
+            title: 'Pending Review',
+            level: 2,
+            content: pending
+                .map((s) => `### ${s.id}: ${s.title}\n\n**Status:** Pending review — awaiting team approval.`)
+                .join('\n\n'),
+        });
+    }
+    /* v8 ignore stop */
+    if (draft.length > 0) {
+        sections.push({
+            title: 'Drafts',
+            level: 2,
+            content: draft
+                .map((s) => `### ${s.id}: ${s.title}\n\n**Status:** Draft — not yet finalized.`)
+                .join('\n\n'),
+        });
+    }
+    return sections;
+}
+function buildConventionLines(knowledge) {
+    const conventions = knowledge.conventions;
+    const linters = knowledge.linting.detectedLinters;
+    const lines = [];
+    for (const [key, value] of Object.entries(conventions)) {
+        lines.push(`- **${key}**: ${value}`);
+    }
+    if (linters.length > 0) {
+        const linterNames = linters.map((l) => l.tool).join(', ');
+        lines.push(`- **Linters**: ${linterNames}`);
+    }
+    if (knowledge.packageManager) {
+        lines.push(`- **Package manager**: ${knowledge.packageManager}`);
+    }
+    return lines;
+}
+function buildContributingConventionsSection(knowledge) {
+    const conventionLines = buildConventionLines(knowledge);
+    return {
+        title: 'Code Conventions',
+        level: 2,
+        content: conventionLines.length > 0
+            ? conventionLines.join('\n')
+            : [
+                '[EN DESARROLLO] No code conventions detected automatically.',
+                '',
+                'Configure `.editorconfig` and add linters to the project to auto-populate this section.',
+            ].join('\n'),
+    };
+}
+// ── Public generators ────────────────────────────────────────────────────────
+/**
+ * Generate a navigable Architecture Decision Log from all specs.
+ * Groups by status (accepted/in-progress/draft) and builds a cross-linked index.
+ */
+export function generateArchitectureDecisionLog(specs, _language) {
+    const adrs = specs.filter((s) => s.type === 'infra' || s.type === 'docs');
+    const accepted = adrs.filter((s) => s.status === 'done');
+    const inProgress = adrs.filter((s) => s.status === 'implementing');
+    const pending = adrs.filter((s) => s.status === 'approved' || s.status === 'review');
+    const draft = adrs.filter((s) => s.status === 'draft');
+    const sections = [
+        {
+            title: 'Overview',
+            level: 2,
+            content: [
+                'This document consolidates all Architecture Decision Records (ADRs) for this project.',
+                '',
+                `Total ADRs: ${adrs.length}`,
+                `- Accepted: ${accepted.length}`,
+                `- In Progress: ${inProgress.length}`,
+                `- Pending Review: ${pending.length}`,
+                `- Draft: ${draft.length}`,
+            ].join('\n'),
+        },
+    ];
+    if (adrs.length === 0) {
+        sections.push({
+            title: 'No ADRs Found',
+            level: 2,
+            content: [
+                '[EN DESARROLLO] No architectural decision records found.',
+                '',
+                'Create specs of type `infra` or `docs` to document architectural decisions.',
+                'Each decision should describe: context, options considered, decision made, and consequences.',
+            ].join('\n'),
+        });
+    }
+    else {
+        sections.push(buildAdrIndexSection(adrs));
+        sections.push(...buildAdrStatusSections(accepted, inProgress, pending, draft));
+    }
+    const content = `# Architecture Decision Log\n\n` +
+        sections.map((s) => `${'#'.repeat(s.level)} ${s.title}\n\n${s.content}`).join('\n\n');
+    return {
+        type: 'architecture-decision-log',
+        title: 'Architecture Decision Log',
+        path: 'docs/adr/index.md',
+        content,
+        audience: 'developer',
+        sections,
+        diagrams: [],
+        relatedSpecs: adrs.map((s) => s.id),
+    };
+}
+/**
+ * Generate CONTRIBUTING.md with code conventions, PR process, review criteria,
+ * and references to the SDD workflow detected from project configuration.
+ */
+export function generateContributing(knowledge, _language) {
+    const sections = [
+        {
+            title: 'Welcome',
+            level: 2,
+            content: [
+                'Thank you for contributing! This guide explains how to work on this project effectively.',
+                '',
+                'This project follows **Spec Driven Development (SDD)**: write the specification before writing code.',
+            ].join('\n'),
+        },
+        buildContributingConventionsSection(knowledge),
+        {
+            title: 'Development Workflow',
+            level: 2,
+            content: [
+                '### SDD Process',
+                '',
+                '1. **Create a spec** — Define what you want to build before writing code using `create_spec`.',
+                '2. **Get approval** — Review the spec with the team.',
+                '3. **Create a branch** — Branch from `main` with the spec ID (e.g., `feat/SPEC-042-auth`).',
+                '4. **Implement** — Follow the spec acceptance criteria step by step.',
+                '5. **Validate** — Run `validate_spec` to check implementation compliance.',
+                '6. **Open a PR** — Reference the spec ID in the PR title and description.',
+            ].join('\n'),
+        },
+        {
+            title: 'Pull Request Process',
+            level: 2,
+            content: [
+                `1. Ensure all tests pass: \`${knowledge.testCommand ?? 'npm test'}\``,
+                `2. Ensure the build succeeds: \`${knowledge.buildCommand ?? 'npm run build'}\``,
+                '3. Include the spec ID in your PR title: `feat(SPEC-042): add user authentication`',
+                '4. Link the PR to the spec in the description.',
+                '5. Request review from at least one team member.',
+                '6. Address all review comments before merging.',
+            ].join('\n'),
+        },
+        {
+            title: 'Review Criteria',
+            level: 2,
+            content: [
+                'Pull requests are reviewed for:',
+                '',
+                '- [ ] All spec acceptance criteria are met',
+                '- [ ] Tests cover new functionality (95%+ branch coverage)',
+                '- [ ] No linting errors or TypeScript type errors',
+                '- [ ] Code follows project conventions (see Code Conventions above)',
+                '- [ ] No sensitive data (secrets, PII) committed',
+                '- [ ] Documentation updated if public API changed',
+            ].join('\n'),
+        },
+        {
+            title: 'Getting Help',
+            level: 2,
+            content: [
+                '- Read the [Architecture Documentation](docs/architecture.md) to understand the codebase.',
+                `- Check existing specs in the \`${knowledge.specLocation}\` directory.`,
+                '- Ask in the team channel or open a GitHub Discussion.',
+            ].join('\n'),
+        },
+    ];
+    const content = `# Contributing Guide\n\n` +
+        sections.map((s) => `${'#'.repeat(s.level)} ${s.title}\n\n${s.content}`).join('\n\n');
+    return {
+        type: 'contributing',
+        title: 'Contributing Guide',
+        path: 'CONTRIBUTING.md',
+        content,
+        audience: 'developer',
+        sections,
+        diagrams: [],
+        relatedSpecs: [],
+    };
+}
+//# sourceMappingURL=team-generators.js.map

package/dist/engine/doc-generator/team-generators.js.map

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

package/dist/engine/doc-generator.d.ts

@@ -0,0 +1,15 @@
+import type { DocumentationType, GenerateDocsResult, GeneratedDocument, SpecDiagram, ProjectKnowledge, Spec } from '../types/index.js';
+/**
+ * Generate documentation for a project.
+ * Supports multiple document types and audiences.
+ */
+export declare function generateDocs(types: DocumentationType[], knowledge: ProjectKnowledge, specs?: Spec[], audience?: 'end-user' | 'developer' | 'stakeholder' | 'ops', language?: string): GenerateDocsResult;
+/**
+ * Generate a single document of a specific type.
+ */
+export declare function generateDocument(type: DocumentationType, knowledge: ProjectKnowledge, specs: Spec[], audience: string, language: string): GeneratedDocument;
+/**
+ * Generate a Mermaid diagram for a spec or architecture.
+ */
+export declare function generateDiagram(type: 'data-flow' | 'sequence' | 'er' | 'component' | 'architecture' | 'state-machine' | 'dependency' | 'deployment', knowledge: ProjectKnowledge, spec?: Spec): SpecDiagram;
+//# sourceMappingURL=doc-generator.d.ts.map

package/dist/engine/doc-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-generator.d.ts","sourceRoot":"","sources":["../../src/engine/doc-generator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,IAAI,EACL,MAAM,mBAAmB,CAAC;AA8C3B;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,iBAAiB,EAAE,EAC1B,SAAS,EAAE,gBAAgB,EAC3B,KAAK,GAAE,IAAI,EAAO,EAClB,QAAQ,GAAE,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,KAAmB,EACxE,QAAQ,SAAO,GACd,kBAAkB,CAapB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,iBAAiB,EACvB,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,IAAI,EAAE,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,iBAAiB,CAuCnB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EACA,WAAW,GACX,UAAU,GACV,IAAI,GACJ,WAAW,GACX,cAAc,GACd,eAAe,GACf,YAAY,GACZ,YAAY,EAChB,SAAS,EAAE,gBAAgB,EAC3B,IAAI,CAAC,EAAE,IAAI,GACV,WAAW,CAqBb"}

package/dist/engine/doc-generator.js

@@ -0,0 +1,91 @@
+// Planu — Documentation Generator Engine
+// Public API: generateDocs, generateDocument, generateDiagram
+// All implementation lives in src/engine/doc-generator/
+import { generateReadme, generateSetupGuide, generateArchitectureDoc, generateApiReference, generateUserGuide, generateDeploymentGuide, } from './doc-generator/guide-generators.js';
+import { generateChangelog, generateOnboarding, generateFaq, generateHelpArticles, } from './doc-generator/support-generators.js';
+import { generateReleaseNotes, generateRunbook, generateSecurityDoc, generateDatabaseDoc, } from './doc-generator/ops-generators.js';
+import { generateArchitectureDecisionLog, generateContributing, } from './doc-generator/team-generators.js';
+import { generateMobileDistributionGuide } from './doc-generator/mobile-distribution-guide.js';
+import { generateExecutiveSummary } from './doc-generator/executive-summary/index.js';
+import { generateArchitectureDiagram, generateComponentDiagram, generateDataFlowDiagram, generateSequenceDiagram, generateErDiagram, generateStateMachineDiagram, generateDependencyDiagram, generateDeploymentDiagram, } from './doc-generator/diagrams.js';
+// === Public API ===
+/**
+ * Generate documentation for a project.
+ * Supports multiple document types and audiences.
+ */
+export function generateDocs(types, knowledge, specs = [], audience = 'developer', language = 'en') {
+    const documents = [];
+    for (const docType of types) {
+        const doc = generateDocument(docType, knowledge, specs, audience, language);
+        documents.push(doc);
+    }
+    const typeNames = types.join(', ');
+    return {
+        documents,
+        message: `Generated ${documents.length} document(s): ${typeNames}`,
+    };
+}
+/**
+ * Generate a single document of a specific type.
+ */
+export function generateDocument(type, knowledge, specs, audience, language) {
+    const generators = {
+        'user-guide': () => generateUserGuide(knowledge, specs, language),
+        'api-reference': () => generateApiReference(knowledge, specs, language),
+        readme: () => generateReadme(knowledge, specs, language),
+        'setup-guide': () => generateSetupGuide(knowledge, language),
+        changelog: () => generateChangelog(specs, language),
+        onboarding: () => generateOnboarding(knowledge, language),
+        faq: () => generateFaq(knowledge, specs, language),
+        'architecture-doc': () => generateArchitectureDoc(knowledge, language),
+        'deployment-guide': () => generateDeploymentGuide(knowledge, language),
+        'database-doc': () => generateDatabaseDoc(knowledge, language),
+        'help-articles': () => generateHelpArticles(knowledge, specs, language),
+        'release-notes': () => generateReleaseNotes(specs, language),
+        runbook: () => generateRunbook(knowledge, language),
+        'security-doc': () => generateSecurityDoc(knowledge, language),
+        'architecture-decision-log': () => generateArchitectureDecisionLog(specs, language),
+        contributing: () => generateContributing(knowledge, language),
+        'mobile-distribution-guide': () => generateMobileDistributionGuide(knowledge, specs, language),
+        'executive-summary': () => generateExecutiveSummary(knowledge, specs, language),
+    };
+    const generator = generators[type];
+    if (!generator) {
+        return {
+            type,
+            title: `Unsupported: ${type}`,
+            path: `docs/${type}.md`,
+            content: `Documentation type "${type}" is not yet supported.`,
+            audience,
+            sections: [],
+            diagrams: [],
+            relatedSpecs: [],
+        };
+    }
+    const doc = generator();
+    doc.audience = audience;
+    return doc;
+}
+/**
+ * Generate a Mermaid diagram for a spec or architecture.
+ */
+export function generateDiagram(type, knowledge, spec) {
+    const generators = {
+        'data-flow': () => generateDataFlowDiagram(knowledge),
+        sequence: () => generateSequenceDiagram(spec),
+        er: () => generateErDiagram(knowledge),
+        component: () => generateComponentDiagram(knowledge),
+        architecture: () => generateArchitectureDiagram(knowledge),
+        'state-machine': () => generateStateMachineDiagram(spec),
+        dependency: () => generateDependencyDiagram(knowledge),
+        deployment: () => generateDeploymentDiagram(knowledge),
+    };
+    return (generators[type]?.() ?? {
+        type,
+        title: `${type} diagram`,
+        format: 'mermaid',
+        content: `graph LR\n  A[Not yet implemented] --> B[${type}]`,
+        description: `${type} diagram placeholder`,
+    });
+}
+//# sourceMappingURL=doc-generator.js.map

package/dist/engine/doc-generator.js.map

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

package/dist/engine/dor-dod/dod.d.ts

@@ -0,0 +1,16 @@
+import type { Spec, DefinitionOfDone, DoDItem, DoRDoDValidationResult } from '../../types/index.js';
+/**
+ * Generate a Definition of Done checklist derived from spec metadata.
+ * criteriaCount reflects how many acceptance criteria exist in HU.md.
+ */
+export declare function generateDoD(spec: Spec, criteriaCount?: number): DefinitionOfDone;
+/**
+ * Validate a spec's DoD.
+ * Both failed AND pending required items are blocking (manual items need explicit confirmation).
+ */
+export declare function validateDoD(spec: Spec): DoRDoDValidationResult;
+/**
+ * Add a custom item to an existing DoD checklist.
+ */
+export declare function addCustomDoDItem(dod: DefinitionOfDone, item: DoDItem): DefinitionOfDone;
+//# sourceMappingURL=dod.d.ts.map

package/dist/engine/dor-dod/dod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dod.d.ts","sourceRoot":"","sources":["../../../src/engine/dor-dod/dod.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAyGpG;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,SAAI,GAAG,gBAAgB,CAG3E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,sBAAsB,CAoB9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAGvF"}

package/dist/engine/dor-dod/dod.js

@@ -0,0 +1,136 @@
+// --- Internal builders ---
+function computeDoD(specId, items) {
+    const requiredItems = items.filter((i) => i.required);
+    const passedCount = items.filter((i) => i.status === 'passed').length;
+    const isDone = requiredItems.every((i) => i.status === 'passed');
+    return {
+        specId,
+        items,
+        passedCount,
+        requiredCount: requiredItems.length,
+        isDone,
+        completedAt: isDone ? new Date().toISOString() : null,
+    };
+}
+function buildDoDItems(spec, criteriaCount) {
+    const hasActuals = spec.actuals !== null;
+    const hasCriteria = criteriaCount > 0;
+    return [
+        {
+            id: 'dod-1',
+            description: `All ${hasCriteria ? criteriaCount : ''} acceptance criteria implemented`,
+            category: 'code',
+            required: true,
+            autoCheck: false,
+            status: 'pending',
+        },
+        {
+            id: 'dod-2',
+            description: 'No critical quality issues (validate score >= 80)',
+            category: 'quality',
+            required: true,
+            autoCheck: false,
+            status: 'pending',
+        },
+        {
+            id: 'dod-3',
+            description: 'Unit tests written and passing for new code',
+            category: 'tests',
+            required: true,
+            autoCheck: false,
+            status: 'pending',
+        },
+        {
+            id: 'dod-4',
+            description: 'No regressions in existing tests',
+            category: 'tests',
+            required: true,
+            autoCheck: false,
+            status: 'pending',
+        },
+        {
+            id: 'dod-5',
+            description: 'Linting and formatting clean (zero errors, zero warnings)',
+            category: 'quality',
+            required: true,
+            autoCheck: false,
+            status: 'pending',
+        },
+        {
+            id: 'dod-6',
+            description: 'Code reviewed and approved',
+            category: 'review',
+            required: false,
+            autoCheck: false,
+            status: 'pending',
+        },
+        {
+            id: 'dod-7',
+            description: 'Documentation updated (HU.md, FICHA-TECNICA.md, PLAN.md)',
+            category: 'docs',
+            required: false,
+            autoCheck: false,
+            status: 'pending',
+        },
+        {
+            id: 'dod-8',
+            description: 'Actuals recorded (hours, tokens, cost)',
+            category: 'review',
+            required: true,
+            autoCheck: true,
+            status: hasActuals ? 'passed' : 'pending',
+        },
+    ];
+}
+function buildDoDHumanMessage(title, blockingItems) {
+    /* v8 ignore start -- generateDoD always produces required pending items; zero-blocking path unreachable at runtime */
+    if (blockingItems.length === 0) {
+        return `Spec "${title}" is done and fully verified.`;
+    }
+    /* v8 ignore stop */
+    const count = blockingItems.length;
+    const listed = blockingItems.slice(0, 3).join('; ');
+    /* v8 ignore next — validateDoD always produces ≥5 blocking items; count≤3 path unreachable */
+    const extra = count > 3 ? ` (and ${count - 3} more)` : '';
+    return `Spec "${title}" is NOT done yet. Missing ${count} required item(s): ${listed}${extra}`;
+}
+// --- Public API ---
+/**
+ * Generate a Definition of Done checklist derived from spec metadata.
+ * criteriaCount reflects how many acceptance criteria exist in HU.md.
+ */
+export function generateDoD(spec, criteriaCount = 0) {
+    const items = buildDoDItems(spec, criteriaCount);
+    return computeDoD(spec.id, items);
+}
+/**
+ * Validate a spec's DoD.
+ * Both failed AND pending required items are blocking (manual items need explicit confirmation).
+ */
+export function validateDoD(spec) {
+    const dod = generateDoD(spec);
+    /* v8 ignore start -- auto-check DoD items are 'passed'|'pending', never 'failed' */
+    const failed = dod.items
+        .filter((i) => i.required && i.status === 'failed')
+        .map((i) => i.description);
+    /* v8 ignore stop */
+    const pendingRequired = dod.items
+        .filter((i) => i.required && !i.autoCheck && i.status === 'pending')
+        .map((i) => i.description);
+    const blockingItems = [...failed, ...pendingRequired];
+    const warningItems = dod.items
+        .filter((i) => !i.required && (i.status === 'failed' || i.status === 'pending'))
+        .map((i) => i.description);
+    const isValid = blockingItems.length === 0;
+    const humanMessage = buildDoDHumanMessage(spec.title, blockingItems);
+    const expertSummary = `DoD: ${dod.passedCount}/${dod.items.length} passed | Blocking: ${blockingItems.length} | Warnings: ${warningItems.length}`;
+    return { isValid, blockingItems, warningItems, humanMessage, expertSummary };
+}
+/**
+ * Add a custom item to an existing DoD checklist.
+ */
+export function addCustomDoDItem(dod, item) {
+    const items = [...dod.items, item];
+    return computeDoD(dod.specId, items);
+}
+//# sourceMappingURL=dod.js.map

package/dist/engine/dor-dod/dod.js.map

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

package/dist/engine/dor-dod/dor.d.ts

@@ -0,0 +1,20 @@
+import type { Spec, DefinitionOfReady, DoRItem, DoRDoDValidationResult } from '../../types/index.js';
+/**
+ * Generate a Definition of Ready checklist for a spec.
+ * Items are type/scope-aware and include auto-checkable conditions.
+ */
+export declare function generateDoR(spec: Spec): DefinitionOfReady;
+/**
+ * Validate a spec's DoR and return a structured result.
+ * Blocking = required items that failed; warnings = optional items that failed.
+ */
+export declare function validateDoR(spec: Spec): DoRDoDValidationResult;
+/**
+ * Add a custom item to an existing DoR checklist.
+ */
+export declare function addCustomDoRItem(dor: DefinitionOfReady, item: DoRItem): DefinitionOfReady;
+/**
+ * Mark DoR items as HIGH PRIORITY when they match known failure patterns.
+ */
+export declare function enrichDoRWithLearning(dor: DefinitionOfReady, failurePatterns: string[]): DefinitionOfReady;
+//# sourceMappingURL=dor.d.ts.map

package/dist/engine/dor-dod/dor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dor.d.ts","sourceRoot":"","sources":["../../../src/engine/dor-dod/dor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,IAAI,EACJ,iBAAiB,EACjB,OAAO,EACP,sBAAsB,EAGvB,MAAM,sBAAsB,CAAC;AAoK9B;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,iBAAiB,CAGzD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,sBAAsB,CAc9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,OAAO,GAAG,iBAAiB,CAGzF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,iBAAiB,EACtB,eAAe,EAAE,MAAM,EAAE,GACxB,iBAAiB,CAanB"}