@rasensio/aidlc 0.1.0

package/dist/compile/adapters/kiro.js

@@ -0,0 +1,222 @@
+/**
+ * Kiro platform adapter for the AIDLC install pipeline.
+ *
+ * Emits an InstallPlan that:
+ * 1. Copies canonical skill bodies to `.aidlc/skills/`
+ * 2. Generates `.kiro/skills/aidlc-<name>/SKILL.md` per skill with:
+ *    - YAML frontmatter (name, description)
+ *    - Body: activation directive (from capability map) + pointer to canonical skill
+ * 3. Generates a `merge-block` steering file `.kiro/steering/aidlc.md`
+ *    (always-included, carries overview + context-doc references)
+ *
+ * Requirements: 1.1, 18.1
+ *
+ * @module
+ */
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Convert a skill name to a safe directory name for .kiro/skills/.
+ * Kiro convention: lowercase, hyphens only, max 64 chars, prefixed with `aidlc-`.
+ */
+function toKiroDirName(name) {
+    const safe = name
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+    const prefixed = safe.startsWith('aidlc-') ? safe : `aidlc-${safe}`;
+    return prefixed.slice(0, 64);
+}
+/**
+ * Resolve the activation directive for a skill on this platform.
+ *
+ * Precedence (Req 18.3, 18.4, 18.6):
+ * 1. skill.meta.native_mode_hint['kiro'] if present
+ * 2. Capability map entry covering the skill's phase
+ * 3. null (no native directive)
+ */
+function resolveActivation(skill, caps) {
+    // 1. Per-skill native_mode_hint
+    const hint = skill.meta.native_mode_hint?.kiro;
+    if (hint) {
+        return hint;
+    }
+    // 2. Capability map entry covering this phase
+    if (caps?.capabilities) {
+        for (const entry of Object.values(caps.capabilities)) {
+            if (entry.phases.includes(skill.meta.phase)) {
+                return entry.activation;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Generate the SKILL.md content for a Kiro skill shim.
+ */
+function generateSkillShim(skill, activation) {
+    const lines = [];
+    // Frontmatter
+    lines.push('---');
+    lines.push(`name: ${toKiroDirName(skill.meta.name)}`);
+    lines.push(`description: ${skill.meta.description}`);
+    lines.push('---');
+    lines.push('');
+    // Body: activation directive + pointer to canonical skill
+    if (activation) {
+        lines.push(activation);
+        lines.push('');
+    }
+    const canonicalPath = `.aidlc/skills/${skill.meta.name}.md`;
+    lines.push(`Read \`${canonicalPath}\` and follow the instructions within.`);
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Generate the steering file content (overview + context-doc references).
+ */
+function generateSteeringContent(skills, ctx) {
+    const lines = [];
+    lines.push('# AIDLC Framework');
+    lines.push('');
+    lines.push('This project uses the AI Development Lifecycle (AIDLC) framework. ' +
+        'Lifecycle skills are installed under `.aidlc/skills/` and activated ' +
+        'via `.kiro/skills/` shims.');
+    lines.push('');
+    // Context doc references (Req 1.8)
+    const contextEntries = Object.entries(ctx.contextDocs);
+    if (contextEntries.length > 0) {
+        lines.push('## Context Documents');
+        lines.push('');
+        for (const [name, relPath] of contextEntries) {
+            lines.push(`- **${name}**: \`.aidlc/context/${relPath}\``);
+        }
+        lines.push('');
+    }
+    // Guidance layer references
+    const guidanceEntries = Object.entries(ctx.guidanceLayers);
+    if (guidanceEntries.length > 0) {
+        lines.push('## Guidance Layers');
+        lines.push('');
+        for (const [name, relPath] of guidanceEntries) {
+            lines.push(`- **${name}**: \`.aidlc/guidance/${relPath}\``);
+        }
+        lines.push('');
+    }
+    // Available skills summary
+    lines.push('## Installed Skills');
+    lines.push('');
+    for (const skill of skills) {
+        lines.push(`- **${skill.meta.name}** (${skill.meta.phase}): ${skill.meta.description}`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Adapter
+// ---------------------------------------------------------------------------
+/**
+ * Kiro platform adapter.
+ *
+ * Implements the PlatformAdapter interface to produce an InstallPlan
+ * for Kiro's `.kiro/skills/` and `.kiro/steering/` layout.
+ */
+export const kiroAdapter = {
+    id: 'kiro',
+    plan(skills, caps, ctx) {
+        const ops = [];
+        const warnings = [];
+        // Validate capability map if provided (Req 18.7)
+        if (caps && caps.platform !== 'kiro') {
+            warnings.push(`capability map platform mismatch: expected 'kiro', got '${caps.platform}'; proceeding without capabilities`);
+            caps = null;
+        }
+        for (const skill of skills) {
+            // 1. Copy canonical skill body to .aidlc/skills/
+            ops.push({
+                kind: 'create',
+                path: `.aidlc/skills/${skill.meta.name}.md`,
+                content: formatCanonicalSkill(skill),
+            });
+            // 2. Generate .kiro/skills/aidlc-<name>/SKILL.md shim
+            const dirName = toKiroDirName(skill.meta.name);
+            const activation = resolveActivation(skill, caps);
+            if (!activation && caps) {
+                // Skill's phase not covered by any capability — note as warning
+                warnings.push(`skill '${skill.meta.name}' (phase: ${skill.meta.phase}) has no matching capability; using full structured guidance`);
+            }
+            const shimContent = generateSkillShim(skill, activation);
+            ops.push({
+                kind: 'create',
+                path: `.kiro/skills/${dirName}/SKILL.md`,
+                content: shimContent,
+            });
+        }
+        // 3. Generate merge-block steering file .kiro/steering/aidlc.md
+        const steeringContent = generateSteeringContent(skills, ctx);
+        ops.push({
+            kind: 'merge-block',
+            path: '.kiro/steering/aidlc.md',
+            blockId: 'aidlc-overview',
+            content: steeringContent,
+        });
+        return { ops, warnings };
+    },
+    validate(op) {
+        const errors = [];
+        const warnings = [];
+        // Validate SKILL.md paths follow Kiro conventions
+        if (op.path.startsWith('.kiro/skills/')) {
+            const pathParts = op.path.split('/');
+            // Expected: .kiro/skills/<dir-name>/SKILL.md
+            if (pathParts.length === 4) {
+                const dirName = pathParts[2];
+                // Must be lowercase with hyphens, max 64 chars
+                if (!/^[a-z0-9][a-z0-9-]*$/.test(dirName)) {
+                    errors.push(`skill directory name '${dirName}' must be lowercase alphanumeric with hyphens`);
+                }
+                if (dirName.length > 64) {
+                    errors.push(`skill directory name '${dirName}' exceeds 64 character limit (${dirName.length})`);
+                }
+                // File must be SKILL.md
+                if (pathParts[3] !== 'SKILL.md') {
+                    warnings.push(`expected SKILL.md, got '${pathParts[3]}'`);
+                }
+            }
+        }
+        // Validate steering files are markdown
+        if (op.path.startsWith('.kiro/steering/') && !op.path.endsWith('.md')) {
+            warnings.push(`steering file '${op.path}' should have .md extension`);
+        }
+        // Check content is non-empty for create/replace
+        if (op.kind !== 'merge-block' && op.content.trim() === '') {
+            errors.push(`empty content for file '${op.path}'`);
+        }
+        return { valid: errors.length === 0, errors, warnings };
+    },
+};
+// ---------------------------------------------------------------------------
+// Internal Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Format a canonical skill file with frontmatter + body.
+ */
+function formatCanonicalSkill(skill) {
+    const lines = [];
+    lines.push('---');
+    lines.push(`name: ${skill.meta.name}`);
+    lines.push(`description: ${skill.meta.description}`);
+    lines.push(`phase: ${skill.meta.phase}`);
+    if (skill.meta.priority !== undefined) {
+        lines.push(`priority: ${skill.meta.priority}`);
+    }
+    if (skill.meta.trigger) {
+        lines.push(`trigger: ${skill.meta.trigger}`);
+    }
+    lines.push('---');
+    lines.push(skill.body);
+    return lines.join('\n');
+}
+//# sourceMappingURL=kiro.js.map

package/dist/compile/adapters/kiro.js.map

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

package/dist/compile/adapters/windsurf.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Windsurf platform adapter for the AIDLC install pipeline.
+ *
+ * Windsurf imposes strict size limits:
+ * - ~6,000 chars per rule file
+ * - ~12,000 chars total across all rules
+ *
+ * Strategy:
+ * 1. Copy canonical skill bodies to `.aidlc/skills/` (same as other adapters).
+ * 2. Generate `.windsurf/rules/aidlc-overview.md` — always-on overview (compact, well under 6K).
+ * 3. Generate `.windsurf/rules/aidlc-<phase>.md` — per-phase pointer rules:
+ *    - Thin pointers: phase description + "Read and follow `.aidlc/skills/<file>`"
+ *    - Full skill bodies stay in `.aidlc/skills/`
+ *
+ * Size enforcement:
+ * - If a generated rule file would exceed 6000 chars, truncate to just the pointer.
+ * - Warn if total size approaches 12K.
+ *
+ * Requirements: 1.1
+ *
+ * @module
+ */
+import type { PlatformAdapter } from '../../core/types.js';
+export declare const windsurfAdapter: PlatformAdapter;
+//# sourceMappingURL=windsurf.d.ts.map

package/dist/compile/adapters/windsurf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.d.ts","sourceRoot":"","sources":["../../../src/compile/adapters/windsurf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EACV,eAAe,EAOhB,MAAM,qBAAqB,CAAC;AA0K7B,eAAO,MAAM,eAAe,EAAE,eA0G7B,CAAC"}

package/dist/compile/adapters/windsurf.js

@@ -0,0 +1,242 @@
+/**
+ * Windsurf platform adapter for the AIDLC install pipeline.
+ *
+ * Windsurf imposes strict size limits:
+ * - ~6,000 chars per rule file
+ * - ~12,000 chars total across all rules
+ *
+ * Strategy:
+ * 1. Copy canonical skill bodies to `.aidlc/skills/` (same as other adapters).
+ * 2. Generate `.windsurf/rules/aidlc-overview.md` — always-on overview (compact, well under 6K).
+ * 3. Generate `.windsurf/rules/aidlc-<phase>.md` — per-phase pointer rules:
+ *    - Thin pointers: phase description + "Read and follow `.aidlc/skills/<file>`"
+ *    - Full skill bodies stay in `.aidlc/skills/`
+ *
+ * Size enforcement:
+ * - If a generated rule file would exceed 6000 chars, truncate to just the pointer.
+ * - Warn if total size approaches 12K.
+ *
+ * Requirements: 1.1
+ *
+ * @module
+ */
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Maximum characters allowed per rule file. */
+const MAX_FILE_CHARS = 6000;
+/** Maximum total characters across all rule files. */
+const MAX_TOTAL_CHARS = 12000;
+/** Warning threshold — warn when total approaches this percentage of the limit. */
+const TOTAL_WARN_THRESHOLD = 0.85;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Derive a short filename-safe slug from a skill name.
+ * E.g., "aidlc-implementation" -> "aidlc-implementation"
+ */
+function skillSlug(skill) {
+    return skill.meta.name.toLowerCase().replace(/[^a-z0-9-]/g, '-');
+}
+/**
+ * Determine the canonical skill filename for `.aidlc/skills/`.
+ * Follows the naming convention from the skills/ directory.
+ */
+function canonicalSkillFilename(skill) {
+    return `${skillSlug(skill)}.md`;
+}
+/**
+ * Build canonical skill file content (frontmatter + body).
+ */
+function buildCanonicalContent(skill) {
+    const lines = ['---'];
+    lines.push(`name: ${skill.meta.name}`);
+    lines.push(`description: ${skill.meta.description}`);
+    lines.push(`phase: ${skill.meta.phase}`);
+    if (skill.meta.trigger) {
+        lines.push(`trigger: ${skill.meta.trigger}`);
+    }
+    if (skill.meta.priority !== undefined) {
+        lines.push(`priority: ${skill.meta.priority}`);
+    }
+    lines.push('---');
+    lines.push(skill.body);
+    return lines.join('\n');
+}
+/**
+ * Generate the overview rule content — a compact summary of the framework.
+ * Must stay well under 6K chars.
+ */
+function generateOverviewRule(skills, ctx) {
+    const lines = [];
+    lines.push('# AIDLC Framework Overview');
+    lines.push('');
+    lines.push('This project uses the AI Development Lifecycle (AIDLC) framework.');
+    lines.push('Full skill instructions live in `.aidlc/skills/` — read them when working on a phase.');
+    lines.push('');
+    lines.push('## Lifecycle Phases');
+    lines.push('');
+    lines.push('1. Ideation — Problem exploration, goals, constraints');
+    lines.push('2. Requirements — Acceptance criteria, user stories, scope');
+    lines.push('3. Design — Architecture, interfaces, data flow');
+    lines.push('4. Implementation — Code production following the design');
+    lines.push('5. Testing — Verification against requirements');
+    lines.push('6. Deployment — Release preparation and execution');
+    lines.push('7. Maintenance — Monitoring, iteration, documentation updates');
+    lines.push('');
+    lines.push('## State Protocol');
+    lines.push('');
+    lines.push('- State files: `.aidlc/state/<instance>/`');
+    lines.push('- Check current phase in `instance.yaml`');
+    lines.push('- Update artifact status in `phase-<name>.yaml`');
+    lines.push('- Append transitions to `transitions.log`');
+    lines.push('');
+    lines.push('## Available Skills');
+    lines.push('');
+    for (const skill of skills) {
+        const filename = canonicalSkillFilename(skill);
+        lines.push('- **' + skill.meta.phase + '**: `.aidlc/skills/' + filename + '`');
+    }
+    // Add context doc references if available
+    const contextEntries = Object.entries(ctx.contextDocs);
+    if (contextEntries.length > 0) {
+        lines.push('');
+        lines.push('## Project Context');
+        lines.push('');
+        for (const [name, path] of contextEntries) {
+            lines.push(`- ${name}: \`.aidlc/context/${path}\``);
+        }
+    }
+    // Add guidance layer references if available
+    const guidanceEntries = Object.entries(ctx.guidanceLayers);
+    if (guidanceEntries.length > 0) {
+        lines.push('');
+        lines.push('## Guidance Layers');
+        lines.push('');
+        for (const [name, path] of guidanceEntries) {
+            lines.push(`- ${name}: \`.aidlc/guidance/${path}\``);
+        }
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Generate a per-phase pointer rule.
+ * Includes phase description and a pointer to the full skill file.
+ */
+function generatePhasePointerRule(skill, caps) {
+    const filename = canonicalSkillFilename(skill);
+    const lines = [];
+    lines.push(`# ${skill.meta.phase.charAt(0).toUpperCase() + skill.meta.phase.slice(1)} Phase`);
+    lines.push('');
+    lines.push(skill.meta.description);
+    lines.push('');
+    // Add capability activation directive if available
+    if (caps) {
+        for (const [, entry] of Object.entries(caps.capabilities)) {
+            if (entry.phases.includes(skill.meta.phase)) {
+                lines.push(`> ${entry.activation}`);
+                lines.push('');
+                break;
+            }
+        }
+    }
+    lines.push(`Read and follow \`.aidlc/skills/${filename}\` for detailed instructions.`);
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Generate a minimal pointer (metadata + path only) for when content exceeds limits.
+ */
+function generateMinimalPointer(skill) {
+    const filename = canonicalSkillFilename(skill);
+    return [
+        `# ${skill.meta.phase.charAt(0).toUpperCase() + skill.meta.phase.slice(1)} Phase`,
+        '',
+        `Read and follow \`.aidlc/skills/${filename}\` for detailed instructions.`,
+        '',
+    ].join('\n');
+}
+// ---------------------------------------------------------------------------
+// Adapter Implementation
+// ---------------------------------------------------------------------------
+export const windsurfAdapter = {
+    id: 'windsurf',
+    plan(skills, caps, ctx) {
+        const ops = [];
+        const warnings = [];
+        // 1. Copy canonical skill bodies to .aidlc/skills/
+        for (const skill of skills) {
+            const filename = canonicalSkillFilename(skill);
+            ops.push({
+                kind: 'create',
+                path: `.aidlc/skills/${filename}`,
+                content: buildCanonicalContent(skill),
+            });
+        }
+        // 2. Generate .windsurf/rules/aidlc-overview.md
+        let overviewContent = generateOverviewRule(skills, ctx);
+        // Enforce size limit on overview
+        if (overviewContent.length > MAX_FILE_CHARS) {
+            warnings.push(`windsurf: overview rule exceeds ${MAX_FILE_CHARS} chars (${overviewContent.length}), truncating`);
+            // Truncate to a minimal overview
+            overviewContent = [
+                '# AIDLC Framework Overview',
+                '',
+                'This project uses the AIDLC framework. Full skills are in `.aidlc/skills/`.',
+                '',
+                'Read `.aidlc/skills/aidlc-overview.md` for the complete framework overview.',
+                '',
+            ].join('\n');
+        }
+        ops.push({
+            kind: 'create',
+            path: '.windsurf/rules/aidlc-overview.md',
+            content: overviewContent,
+        });
+        let totalChars = overviewContent.length;
+        // 3. Generate per-phase pointer rules
+        // Skip the overview skill (it's already covered by the overview rule)
+        const phaseSkills = skills.filter((s) => s.meta.name !== 'aidlc-overview');
+        for (const skill of phaseSkills) {
+            let ruleContent = generatePhasePointerRule(skill, caps);
+            // Enforce per-file size limit
+            if (ruleContent.length > MAX_FILE_CHARS) {
+                warnings.push(`windsurf: rule for ${skill.meta.name} exceeds ${MAX_FILE_CHARS} chars (${ruleContent.length}), using minimal pointer`);
+                ruleContent = generateMinimalPointer(skill);
+            }
+            totalChars += ruleContent.length;
+            ops.push({
+                kind: 'create',
+                path: `.windsurf/rules/aidlc-${skillSlug(skill)}.md`,
+                content: ruleContent,
+            });
+        }
+        // Warn if total approaches the limit
+        if (totalChars > MAX_TOTAL_CHARS * TOTAL_WARN_THRESHOLD) {
+            warnings.push(`windsurf: total rule size (${totalChars} chars) approaches the ${MAX_TOTAL_CHARS} char platform limit`);
+        }
+        return { ops, warnings };
+    },
+    validate(op) {
+        const errors = [];
+        const warnings = [];
+        // Only validate files in .windsurf/rules/
+        if (!op.path.startsWith('.windsurf/rules/')) {
+            return { valid: true, errors, warnings };
+        }
+        const content = op.kind === 'merge-block' ? op.content : op.content;
+        const charCount = content.length;
+        // Check per-file size limit
+        if (charCount > MAX_FILE_CHARS) {
+            errors.push(`file ${op.path} exceeds windsurf per-file limit: ${charCount} > ${MAX_FILE_CHARS} chars`);
+        }
+        // Warn when approaching file limit
+        if (charCount > MAX_FILE_CHARS * TOTAL_WARN_THRESHOLD && charCount <= MAX_FILE_CHARS) {
+            warnings.push(`file ${op.path} is approaching the per-file limit: ${charCount}/${MAX_FILE_CHARS} chars`);
+        }
+        return { valid: errors.length === 0, errors, warnings };
+    },
+};
+//# sourceMappingURL=windsurf.js.map

package/dist/compile/adapters/windsurf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.js","sourceRoot":"","sources":["../../../src/compile/adapters/windsurf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAYH,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,gDAAgD;AAChD,MAAM,cAAc,GAAG,IAAI,CAAC;AAE5B,sDAAsD;AACtD,MAAM,eAAe,GAAG,KAAK,CAAC;AAE9B,mFAAmF;AACnF,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAElC,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,SAAS,CAAC,KAAY;IAC7B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,SAAS,sBAAsB,CAAC,KAAY;IAC1C,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,KAAY;IACzC,MAAM,KAAK,GAAa,CAAC,KAAK,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACzC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAC3B,MAAe,EACf,GAAmB;IAEnB,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;IAChF,KAAK,CAAC,IAAI,CAAC,uFAAuF,CAAC,CAAC;IACpG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;IACpE,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IACzE,KAAK,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IAC9D,KAAK,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;IACvE,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IAC5E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IAC9D,KAAK,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,qBAAqB,GAAG,QAAQ,GAAG,GAAG,CAAC,CAAC;IACjF,CAAC;IAED,0CAA0C;IAC1C,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACvD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,cAAc,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,sBAAsB,IAAI,IAAI,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,6CAA6C;IAC7C,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC3D,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,eAAe,EAAE,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,uBAAuB,IAAI,IAAI,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,SAAS,wBAAwB,CAC/B,KAAY,EACZ,IAA0B;IAE1B,MAAM,QAAQ,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9F,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,mDAAmD;IACnD,IAAI,IAAI,EAAE,CAAC;QACT,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YAC1D,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAc,CAAC,EAAE,CAAC;gBACrD,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;gBACpC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,mCAAmC,QAAQ,+BAA+B,CAAC,CAAC;IACvF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAAC,KAAY;IAC1C,MAAM,QAAQ,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO;QACL,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ;QACjF,EAAE;QACF,mCAAmC,QAAQ,+BAA+B;QAC1E,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C,EAAE,EAAE,UAAU;IAEd,IAAI,CAAC,MAAe,EAAE,IAA0B,EAAE,GAAmB;QACnE,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,mDAAmD;QACnD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;YAC/C,GAAG,CAAC,IAAI,CAAC;gBACP,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,iBAAiB,QAAQ,EAAE;gBACjC,OAAO,EAAE,qBAAqB,CAAC,KAAK,CAAC;aACtC,CAAC,CAAC;QACL,CAAC;QAED,gDAAgD;QAChD,IAAI,eAAe,GAAG,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAExD,iCAAiC;QACjC,IAAI,eAAe,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;YAC5C,QAAQ,CAAC,IAAI,CACX,mCAAmC,cAAc,WAAW,eAAe,CAAC,MAAM,eAAe,CAClG,CAAC;YACF,iCAAiC;YACjC,eAAe,GAAG;gBAChB,4BAA4B;gBAC5B,EAAE;gBACF,6EAA6E;gBAC7E,EAAE;gBACF,6EAA6E;gBAC7E,EAAE;aACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;QAED,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,mCAAmC;YACzC,OAAO,EAAE,eAAe;SACzB,CAAC,CAAC;QAEH,IAAI,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC;QAExC,sCAAsC;QACtC,sEAAsE;QACtE,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC;QAE3E,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;YAChC,IAAI,WAAW,GAAG,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAExD,8BAA8B;YAC9B,IAAI,WAAW,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;gBACxC,QAAQ,CAAC,IAAI,CACX,sBAAsB,KAAK,CAAC,IAAI,CAAC,IAAI,YAAY,cAAc,WAAW,WAAW,CAAC,MAAM,0BAA0B,CACvH,CAAC;gBACF,WAAW,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;YAC9C,CAAC;YAED,UAAU,IAAI,WAAW,CAAC,MAAM,CAAC;YAEjC,GAAG,CAAC,IAAI,CAAC;gBACP,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,yBAAyB,SAAS,CAAC,KAAK,CAAC,KAAK;gBACpD,OAAO,EAAE,WAAW;aACrB,CAAC,CAAC;QACL,CAAC;QAED,qCAAqC;QACrC,IAAI,UAAU,GAAG,eAAe,GAAG,oBAAoB,EAAE,CAAC;YACxD,QAAQ,CAAC,IAAI,CACX,8BAA8B,UAAU,0BAA0B,eAAe,sBAAsB,CACxG,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED,QAAQ,CAAC,EAAU;QACjB,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,0CAA0C;QAC1C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC5C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAC3C,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC;QACpE,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;QAEjC,4BAA4B;QAC5B,IAAI,SAAS,GAAG,cAAc,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CACT,QAAQ,EAAE,CAAC,IAAI,qCAAqC,SAAS,MAAM,cAAc,QAAQ,CAC1F,CAAC;QACJ,CAAC;QAED,mCAAmC;QACnC,IAAI,SAAS,GAAG,cAAc,GAAG,oBAAoB,IAAI,SAAS,IAAI,cAAc,EAAE,CAAC;YACrF,QAAQ,CAAC,IAAI,CACX,QAAQ,EAAE,CAAC,IAAI,uCAAuC,SAAS,IAAI,cAAc,QAAQ,CAC1F,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC1D,CAAC;CACF,CAAC"}

package/dist/compile/install-plan.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Install plan executors for the AIDLC install pipeline.
+ *
+ * The plan/execute split ensures `--dry-run` is provably equivalent to a real
+ * install — same plan, different executor (Req 1.5).
+ *
+ * - `executePlan()`: applies a plan to the filesystem (creates dirs, writes files,
+ *   invokes `mergeBlock` for managed blocks).
+ * - `dryRunPlan()`: returns an identical report shape without touching the filesystem.
+ *
+ * Requirements: 1.2, 1.5, 17.2
+ *
+ * @module
+ */
+import type { InstallPlan } from '../core/types.js';
+/** Result of applying (or simulating) an install plan. */
+export interface ExecutionReport {
+    /** Paths of files that were written or updated. */
+    filesWritten: string[];
+    /** Paths that would not change (content already identical). */
+    filesSkipped: string[];
+    /** Non-fatal warnings forwarded from the plan. */
+    warnings: string[];
+}
+/**
+ * Apply an install plan to the filesystem.
+ *
+ * - `create`/`replace`: write file content, creating directories as needed.
+ * - `merge-block`: read existing file (or empty), call `mergeBlock()`, write result.
+ *
+ * Skips files whose computed content is identical to what's already on disk.
+ *
+ * @param plan - The install plan to execute.
+ * @param rootDir - Absolute path to the project root. All `op.path` entries are relative to this.
+ * @returns Report of what was written, skipped, and warnings.
+ */
+export declare function executePlan(plan: InstallPlan, rootDir: string): ExecutionReport;
+/**
+ * Simulate applying an install plan without writing to the filesystem.
+ *
+ * Computes the same content resolution as `executePlan()` to determine which
+ * files would be written or skipped, but never creates directories or writes files.
+ *
+ * @param plan - The install plan to simulate.
+ * @param rootDir - Absolute path to the project root.
+ * @returns Report of what would be written, skipped, and warnings.
+ */
+export declare function dryRunPlan(plan: InstallPlan, rootDir: string): ExecutionReport;
+//# sourceMappingURL=install-plan.d.ts.map

package/dist/compile/install-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-plan.d.ts","sourceRoot":"","sources":["../../src/compile/install-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAU,MAAM,kBAAkB,CAAC;AAO5D,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAuCD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,CAyB/E;AAMD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,CAiB9E"}