@zigrivers/scaffold 2.1.0

package/dist/core/assembly/methodology-resolver.test.js

@@ -0,0 +1,87 @@
+import { describe, it, expect } from 'vitest';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { resolveEnablement } from './methodology-resolver.js';
+import { loadPreset } from './preset-loader.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const fixtureDir = path.resolve(__dirname, '../../../tests/fixtures/methodology');
+function makeConfig(overrides = {}) {
+    return {
+        version: 2,
+        methodology: 'deep',
+        platforms: ['claude-code'],
+        ...overrides,
+    };
+}
+function loadFixturePreset(name) {
+    const { preset } = loadPreset(path.join(fixtureDir, `${name}.yml`), []);
+    if (!preset)
+        throw new Error(`Failed to load preset: ${name}`);
+    return preset;
+}
+describe('resolveEnablement', () => {
+    it('preset-default returns enabled from preset', () => {
+        const preset = loadFixturePreset('deep');
+        const config = makeConfig();
+        const result = resolveEnablement('create-prd', config, preset);
+        expect(result.enabled).toBe(true);
+        expect(result.provenance).toBe('preset-default');
+    });
+    it('custom-override takes precedence over preset', () => {
+        const preset = loadFixturePreset('deep');
+        const config = makeConfig({
+            custom: {
+                steps: { 'create-prd': { enabled: false } },
+            },
+        });
+        const result = resolveEnablement('create-prd', config, preset);
+        expect(result.enabled).toBe(false);
+        expect(result.provenance).toBe('custom-override');
+    });
+    it('custom-override can enable a step', () => {
+        // Use a step that doesn't exist in mvp preset, then enable via custom
+        const preset = loadFixturePreset('mvp');
+        const config = makeConfig({
+            methodology: 'mvp',
+            custom: {
+                steps: { 'review-prd': { enabled: true } },
+            },
+        });
+        const result = resolveEnablement('review-prd', config, preset);
+        expect(result.enabled).toBe(true);
+        expect(result.provenance).toBe('custom-override');
+    });
+    it('step not in preset returns enabled=false', () => {
+        const preset = loadFixturePreset('mvp');
+        const config = makeConfig({ methodology: 'mvp' });
+        // 'domain-modeling' not in mvp.yml fixture
+        const result = resolveEnablement('domain-modeling', config, preset);
+        expect(result.enabled).toBe(false);
+        expect(result.provenance).toBe('preset-default');
+    });
+    it('MVP preset: create-prd enabled, domain-modeling disabled', () => {
+        const preset = loadFixturePreset('mvp');
+        const config = makeConfig({ methodology: 'mvp' });
+        const createPrdResult = resolveEnablement('create-prd', config, preset);
+        expect(createPrdResult.enabled).toBe(true);
+        expect(createPrdResult.provenance).toBe('preset-default');
+        const domainModelingResult = resolveEnablement('domain-modeling', config, preset);
+        expect(domainModelingResult.enabled).toBe(false);
+        expect(domainModelingResult.provenance).toBe('preset-default');
+    });
+    it('review-prd is enabled in deep preset', () => {
+        const preset = loadFixturePreset('deep');
+        const config = makeConfig();
+        const result = resolveEnablement('review-prd', config, preset);
+        expect(result.enabled).toBe(true);
+        expect(result.provenance).toBe('preset-default');
+    });
+    it('step not in any preset returns enabled=false with preset-default provenance', () => {
+        const preset = loadFixturePreset('deep');
+        const config = makeConfig();
+        const result = resolveEnablement('nonexistent-step', config, preset);
+        expect(result.enabled).toBe(false);
+        expect(result.provenance).toBe('preset-default');
+    });
+});
+//# sourceMappingURL=methodology-resolver.test.js.map

package/dist/core/assembly/methodology-resolver.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"methodology-resolver.test.js","sourceRoot":"","sources":["../../../src/core/assembly/methodology-resolver.test.ts"],"names":[],"mappings":"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"}

package/dist/core/assembly/preset-loader.d.ts

@@ -0,0 +1,26 @@
+import type { MethodologyPreset } from '../../types/index.js';
+import type { ScaffoldError, ScaffoldWarning } from '../../types/index.js';
+/**
+ * Load a methodology preset YAML file.
+ * @param presetPath - Absolute path to preset file
+ * @param knownStepNames - Step names from discovered meta-prompts (for validation)
+ * @returns { preset, errors, warnings }
+ */
+export declare function loadPreset(presetPath: string, knownStepNames: string[]): {
+    preset: MethodologyPreset | null;
+    errors: ScaffoldError[];
+    warnings: ScaffoldWarning[];
+};
+/**
+ * Load all three standard presets from the given directory.
+ * In production: pass the methodology/ dir from package installation root.
+ * In tests: pass the fixture directory.
+ */
+export declare function loadAllPresets(methodologyDir: string, knownStepNames: string[]): {
+    deep: MethodologyPreset | null;
+    mvp: MethodologyPreset | null;
+    custom: MethodologyPreset | null;
+    errors: ScaffoldError[];
+    warnings: ScaffoldWarning[];
+};
+//# sourceMappingURL=preset-loader.d.ts.map

package/dist/core/assembly/preset-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-loader.d.ts","sourceRoot":"","sources":["../../../src/core/assembly/preset-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAiB1E;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EAAE,GACvB;IAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,aAAa,EAAE,CAAC;IAAC,QAAQ,EAAE,eAAe,EAAE,CAAA;CAAE,CAyH5F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EAAE,GACvB;IACD,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAC9B,GAAG,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAC7B,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAChC,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,QAAQ,EAAE,eAAe,EAAE,CAAA;CAC5B,CAgCA"}

package/dist/core/assembly/preset-loader.js

@@ -0,0 +1,146 @@
+import { fileExists } from '../../utils/fs.js';
+import { presetMissing, presetParseError, presetInvalidStep, presetMissingStep } from '../../utils/errors.js';
+import yaml from 'js-yaml';
+import fs from 'node:fs';
+import path from 'node:path';
+/** Validate that a value is a valid DepthLevel (integer 1–5). */
+function isDepthLevel(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value >= 1 && value <= 5;
+}
+/** Validate kebab-case string (lowercase letters, digits, hyphens). */
+function isKebabCase(value) {
+    return /^[a-z0-9]+(-[a-z0-9]+)*$/.test(value);
+}
+/**
+ * Load a methodology preset YAML file.
+ * @param presetPath - Absolute path to preset file
+ * @param knownStepNames - Step names from discovered meta-prompts (for validation)
+ * @returns { preset, errors, warnings }
+ */
+export function loadPreset(presetPath, knownStepNames) {
+    const errors = [];
+    const warnings = [];
+    // 1. Check file exists
+    if (!fileExists(presetPath)) {
+        const presetName = path.basename(presetPath, '.yml');
+        errors.push(presetMissing(presetName, presetPath));
+        return { preset: null, errors, warnings };
+    }
+    // 2. Read file
+    const raw = fs.readFileSync(presetPath, 'utf8');
+    // 3. Parse YAML
+    let parsed;
+    try {
+        parsed = yaml.load(raw);
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        errors.push(presetParseError(presetPath, detail));
+        return { preset: null, errors, warnings };
+    }
+    // 4. Validate top-level structure
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        errors.push(presetParseError(presetPath, 'preset must be a YAML object'));
+        return { preset: null, errors, warnings };
+    }
+    const obj = parsed;
+    // Validate required fields
+    if (typeof obj['name'] !== 'string' || obj['name'].trim() === '') {
+        errors.push(presetParseError(presetPath, 'required field "name" must be a non-empty string'));
+    }
+    if (typeof obj['description'] !== 'string' || obj['description'].trim() === '') {
+        errors.push(presetParseError(presetPath, 'required field "description" must be a non-empty string'));
+    }
+    if (!isDepthLevel(obj['default_depth'])) {
+        const got = JSON.stringify(obj['default_depth']);
+        errors.push(presetParseError(presetPath, `"default_depth" must be an integer between 1 and 5, got ${got}`));
+    }
+    if (typeof obj['steps'] !== 'object' || obj['steps'] === null || Array.isArray(obj['steps'])) {
+        errors.push(presetParseError(presetPath, 'required field "steps" must be a YAML object'));
+        return { preset: null, errors, warnings };
+    }
+    if (errors.length > 0) {
+        return { preset: null, errors, warnings };
+    }
+    // 5. Validate steps entries
+    const stepsRaw = obj['steps'];
+    const presetName = obj['name'].trim();
+    const steps = {};
+    for (const [stepKey, stepValue] of Object.entries(stepsRaw)) {
+        // Key must be kebab-case
+        if (!isKebabCase(stepKey)) {
+            errors.push(presetParseError(presetPath, `step key "${stepKey}" must be kebab-case`));
+            continue;
+        }
+        // If knownStepNames is provided, each step must be known
+        if (knownStepNames.length > 0 && !knownStepNames.includes(stepKey)) {
+            errors.push(presetInvalidStep(stepKey, presetName));
+            continue;
+        }
+        // Validate step entry structure
+        if (typeof stepValue !== 'object' || stepValue === null || Array.isArray(stepValue)) {
+            errors.push(presetParseError(presetPath, `step "${stepKey}" must be an object with an "enabled" field`));
+            continue;
+        }
+        const stepObj = stepValue;
+        if (typeof stepObj['enabled'] !== 'boolean') {
+            errors.push(presetParseError(presetPath, `step "${stepKey}.enabled" must be a boolean`));
+            continue;
+        }
+        const entry = {
+            enabled: stepObj['enabled'],
+        };
+        if (stepObj['conditional'] !== undefined) {
+            if (stepObj['conditional'] !== 'if-needed') {
+                errors.push(presetParseError(presetPath, `step "${stepKey}.conditional" must be "if-needed" if present`));
+                continue;
+            }
+            entry.conditional = 'if-needed';
+        }
+        steps[stepKey] = entry;
+    }
+    if (errors.length > 0) {
+        return { preset: null, errors, warnings };
+    }
+    // Warn about known steps missing from the preset
+    if (knownStepNames.length > 0) {
+        for (const knownStep of knownStepNames) {
+            if (!(knownStep in steps)) {
+                warnings.push(presetMissingStep(knownStep, presetName));
+            }
+        }
+    }
+    const preset = {
+        name: presetName,
+        description: obj['description'].trim(),
+        default_depth: obj['default_depth'],
+        steps,
+    };
+    return { preset, errors, warnings };
+}
+/**
+ * Load all three standard presets from the given directory.
+ * In production: pass the methodology/ dir from package installation root.
+ * In tests: pass the fixture directory.
+ */
+export function loadAllPresets(methodologyDir, knownStepNames) {
+    const allErrors = [];
+    const allWarnings = [];
+    const { preset: deep, errors: deepErrors, warnings: deepWarnings } = loadPreset(path.join(methodologyDir, 'deep.yml'), knownStepNames);
+    allErrors.push(...deepErrors);
+    allWarnings.push(...deepWarnings);
+    const { preset: mvp, errors: mvpErrors, warnings: mvpWarnings } = loadPreset(path.join(methodologyDir, 'mvp.yml'), knownStepNames);
+    allErrors.push(...mvpErrors);
+    allWarnings.push(...mvpWarnings);
+    const { preset: custom, errors: customErrors, warnings: customWarnings } = loadPreset(path.join(methodologyDir, 'custom-defaults.yml'), knownStepNames);
+    allErrors.push(...customErrors);
+    allWarnings.push(...customWarnings);
+    return {
+        deep,
+        mvp,
+        custom,
+        errors: allErrors,
+        warnings: allWarnings,
+    };
+}
+//# sourceMappingURL=preset-loader.js.map

package/dist/core/assembly/preset-loader.js.map

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

package/dist/core/assembly/preset-loader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=preset-loader.test.d.ts.map

package/dist/core/assembly/preset-loader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-loader.test.d.ts","sourceRoot":"","sources":["../../../src/core/assembly/preset-loader.test.ts"],"names":[],"mappings":""}

package/dist/core/assembly/preset-loader.test.js

@@ -0,0 +1,107 @@
+import { describe, it, expect } from 'vitest';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { loadPreset, loadAllPresets } from './preset-loader.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const fixtureDir = path.resolve(__dirname, '../../../tests/fixtures/methodology');
+const knownSteps = ['create-prd', 'review-prd', 'user-stories'];
+describe('loadPreset', () => {
+    it('loads deep.yml preset successfully', () => {
+        const { preset, errors, warnings } = loadPreset(path.join(fixtureDir, 'deep.yml'), knownSteps);
+        expect(errors).toHaveLength(0);
+        expect(preset).not.toBeNull();
+        expect(preset.name).toBe('Deep');
+        expect(preset.description).toBe('Comprehensive enterprise-grade scaffolding with all steps enabled');
+        expect(preset.default_depth).toBe(5);
+        expect(preset.steps['create-prd'].enabled).toBe(true);
+        expect(preset.steps['review-prd'].enabled).toBe(true);
+        expect(preset.steps['user-stories'].enabled).toBe(true);
+        expect(warnings).toHaveLength(0);
+    });
+    it('loads mvp.yml with only 2 steps enabled, default_depth 1', () => {
+        const { preset, errors, warnings } = loadPreset(path.join(fixtureDir, 'mvp.yml'), knownSteps);
+        expect(errors).toHaveLength(0);
+        expect(preset).not.toBeNull();
+        expect(preset.name).toBe('MVP');
+        expect(preset.default_depth).toBe(1);
+        expect(Object.keys(preset.steps)).toHaveLength(2);
+        // review-prd is in knownSteps but not in mvp.yml → warning
+        expect(warnings).toHaveLength(1);
+        expect(warnings[0].code).toBe('PRESET_MISSING_STEP');
+        expect(warnings[0].context?.step).toBe('review-prd');
+    });
+    it('loads custom-defaults.yml with default_depth 3', () => {
+        const { preset, errors, warnings } = loadPreset(path.join(fixtureDir, 'custom-defaults.yml'), knownSteps);
+        expect(errors).toHaveLength(0);
+        expect(preset).not.toBeNull();
+        expect(preset.name).toBe('Custom');
+        expect(preset.default_depth).toBe(3);
+        expect(preset.steps['review-prd'].conditional).toBe('if-needed');
+        expect(warnings).toHaveLength(0);
+    });
+    it('returns PRESET_MISSING error for non-existent file', () => {
+        const { preset, errors } = loadPreset(path.join(fixtureDir, 'nonexistent.yml'), knownSteps);
+        expect(preset).toBeNull();
+        expect(errors).toHaveLength(1);
+        expect(errors[0].code).toBe('PRESET_MISSING');
+    });
+    it('returns PRESET_PARSE_ERROR for invalid YAML', () => {
+        // A .ts source file is not a valid preset YAML object — it will fail field validation
+        const { preset, errors } = loadPreset(path.join(__dirname, 'preset-loader.test.ts'), knownSteps);
+        // It will parse but fail field validation, not YAML parse error
+        // Let's check for either PRESET_PARSE_ERROR or field errors
+        expect(preset).toBeNull();
+        expect(errors.length).toBeGreaterThan(0);
+    });
+    it('returns PRESET_INVALID_STEP when preset references unknown step', () => {
+        // deep.yml has 3 known steps; if we pass fewer knownSteps that excludes one
+        const { preset, errors } = loadPreset(path.join(fixtureDir, 'deep.yml'), ['create-prd']);
+        expect(preset).toBeNull();
+        expect(errors.some(e => e.code === 'PRESET_INVALID_STEP')).toBe(true);
+        const invalidStepError = errors.find(e => e.code === 'PRESET_INVALID_STEP');
+        expect(['review-prd', 'user-stories']).toContain(invalidStepError.context?.step);
+    });
+    it('returns PRESET_MISSING_STEP warning when meta-prompt exists but not in preset', () => {
+        // mvp.yml only has create-prd and user-stories — review-prd is missing
+        const { warnings } = loadPreset(path.join(fixtureDir, 'mvp.yml'), knownSteps);
+        expect(warnings.some(w => w.code === 'PRESET_MISSING_STEP')).toBe(true);
+        const missingWarning = warnings.find(w => w.code === 'PRESET_MISSING_STEP');
+        expect(missingWarning.context?.step).toBe('review-prd');
+    });
+    it('returns structured MethodologyPreset with step enablement map', () => {
+        const { preset, errors } = loadPreset(path.join(fixtureDir, 'deep.yml'), knownSteps);
+        expect(errors).toHaveLength(0);
+        expect(preset).not.toBeNull();
+        expect(typeof preset.steps).toBe('object');
+        for (const step of Object.values(preset.steps)) {
+            expect(typeof step.enabled).toBe('boolean');
+        }
+    });
+    it('skips step validation when knownStepNames is empty', () => {
+        const { preset, errors, warnings } = loadPreset(path.join(fixtureDir, 'deep.yml'), []);
+        expect(errors).toHaveLength(0);
+        expect(warnings).toHaveLength(0);
+        expect(preset).not.toBeNull();
+    });
+});
+describe('loadAllPresets', () => {
+    it('loads all three presets from fixture directory', () => {
+        const result = loadAllPresets(fixtureDir, knownSteps);
+        expect(result.deep).not.toBeNull();
+        expect(result.mvp).not.toBeNull();
+        expect(result.custom).not.toBeNull();
+        expect(result.deep.name).toBe('Deep');
+        expect(result.mvp.name).toBe('MVP');
+        expect(result.custom.name).toBe('Custom');
+    });
+    it('returns null for presets that fail to load, continues with others', () => {
+        // Pass a directory that has no preset files
+        const result = loadAllPresets('/tmp/nonexistent-methodology-dir-xyz', knownSteps);
+        expect(result.deep).toBeNull();
+        expect(result.mvp).toBeNull();
+        expect(result.custom).toBeNull();
+        expect(result.errors.length).toBeGreaterThan(0);
+        expect(result.errors.some(e => e.code === 'PRESET_MISSING')).toBe(true);
+    });
+});
+//# sourceMappingURL=preset-loader.test.js.map

package/dist/core/assembly/preset-loader.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-loader.test.js","sourceRoot":"","sources":["../../../src/core/assembly/preset-loader.test.ts"],"names":[],"mappings":"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"}

package/dist/core/assembly/update-mode.d.ts

@@ -0,0 +1,25 @@
+import type { DepthLevel } from '../../types/enums.js';
+import type { PipelineState } from '../../types/state.js';
+import type { ExistingArtifact } from '../../types/assembly.js';
+import type { ScaffoldWarning } from '../../types/errors.js';
+export interface UpdateModeResult {
+    isUpdateMode: boolean;
+    existingArtifact?: ExistingArtifact;
+    previousDepth?: DepthLevel;
+    currentDepth: DepthLevel;
+    depthIncreased?: boolean;
+    warnings: ScaffoldWarning[];
+}
+/**
+ * Detect whether a step is being re-run (update mode).
+ * Update mode is active when:
+ *   1. The step status is 'completed', AND
+ *   2. At least one artifact produced by the step exists on disk.
+ */
+export declare function detectUpdateMode(options: {
+    step: string;
+    state: PipelineState;
+    currentDepth: DepthLevel;
+    projectRoot: string;
+}): UpdateModeResult;
+//# sourceMappingURL=update-mode.d.ts.map

package/dist/core/assembly/update-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-mode.d.ts","sourceRoot":"","sources":["../../../src/core/assembly/update-mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAI5D,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,OAAO,CAAA;IACrB,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,aAAa,CAAC,EAAE,UAAU,CAAA;IAC1B,YAAY,EAAE,UAAU,CAAA;IACxB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,EAAE,eAAe,EAAE,CAAA;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,aAAa,CAAA;IACpB,YAAY,EAAE,UAAU,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;CACpB,GAAG,gBAAgB,CA2EnB"}

package/dist/core/assembly/update-mode.js

@@ -0,0 +1,70 @@
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Detect whether a step is being re-run (update mode).
+ * Update mode is active when:
+ *   1. The step status is 'completed', AND
+ *   2. At least one artifact produced by the step exists on disk.
+ */
+export function detectUpdateMode(options) {
+    const { step, state, currentDepth, projectRoot } = options;
+    const stepEntry = state.steps[step];
+    // Not completed — definitely not update mode
+    if (!stepEntry || stepEntry.status !== 'completed') {
+        return { isUpdateMode: false, currentDepth, warnings: [] };
+    }
+    const produces = stepEntry.produces ?? [];
+    // No artifacts listed — not update mode
+    if (produces.length === 0) {
+        return { isUpdateMode: false, currentDepth, warnings: [] };
+    }
+    // Find the first artifact that exists on disk
+    let firstExistingRelPath;
+    for (const relativePath of produces) {
+        const fullPath = path.resolve(projectRoot, relativePath);
+        if (fs.existsSync(fullPath)) {
+            firstExistingRelPath = relativePath;
+            break;
+        }
+    }
+    // No artifacts exist on disk — not update mode
+    if (firstExistingRelPath === undefined) {
+        return { isUpdateMode: false, currentDepth, warnings: [] };
+    }
+    // Update mode triggered — read first artifact content
+    const fullPath = path.resolve(projectRoot, firstExistingRelPath);
+    const content = fs.readFileSync(fullPath, 'utf8');
+    const previousDepth = stepEntry.depth;
+    const completionTimestamp = stepEntry.at ?? '';
+    const existingArtifact = {
+        filePath: firstExistingRelPath,
+        content,
+        previousDepth: previousDepth,
+        completionTimestamp,
+    };
+    const warnings = [];
+    if (previousDepth !== undefined && previousDepth !== currentDepth) {
+        warnings.push({
+            code: 'ASM_DEPTH_CHANGED',
+            message: `Step '${step}' was previously executed at depth ${previousDepth}` +
+                `; now executing at depth ${currentDepth}`,
+        });
+        if (currentDepth < previousDepth) {
+            warnings.push({
+                code: 'ASM_DEPTH_DOWNGRADE',
+                message: `Re-running step '${step}' at a lower depth (${currentDepth})` +
+                    ` than original execution (${previousDepth})`,
+            });
+        }
+    }
+    const depthIncreased = previousDepth !== undefined ? currentDepth > previousDepth : undefined;
+    return {
+        isUpdateMode: true,
+        existingArtifact,
+        previousDepth,
+        currentDepth,
+        depthIncreased,
+        warnings,
+    };
+}
+//# sourceMappingURL=update-mode.js.map

package/dist/core/assembly/update-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-mode.js","sourceRoot":"","sources":["../../../src/core/assembly/update-mode.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAW5B;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAKhC;IACC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,OAAO,CAAA;IAC1D,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAEnC,6CAA6C;IAC7C,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACnD,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;IAC5D,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,IAAI,EAAE,CAAA;IAEzC,wCAAwC;IACxC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;IAC5D,CAAC;IAED,8CAA8C;IAC9C,IAAI,oBAAwC,CAAA;IAC5C,KAAK,MAAM,YAAY,IAAI,QAAQ,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC,CAAA;QACxD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,oBAAoB,GAAG,YAAY,CAAA;YACnC,MAAK;QACP,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,IAAI,oBAAoB,KAAK,SAAS,EAAE,CAAC;QACvC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;IAC5D,CAAC;IAED,sDAAsD;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAA;IAChE,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IACjD,MAAM,aAAa,GAAG,SAAS,CAAC,KAA+B,CAAA;IAC/D,MAAM,mBAAmB,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,CAAA;IAE9C,MAAM,gBAAgB,GAAqB;QACzC,QAAQ,EAAE,oBAAoB;QAC9B,OAAO;QACP,aAAa,EAAE,aAA2B;QAC1C,mBAAmB;KACpB,CAAA;IAED,MAAM,QAAQ,GAAsB,EAAE,CAAA;IAEtC,IAAI,aAAa,KAAK,SAAS,IAAI,aAAa,KAAK,YAAY,EAAE,CAAC;QAClE,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,mBAAmB;YACzB,OAAO,EACL,SAAS,IAAI,sCAAsC,aAAa,EAAE;gBAClE,4BAA4B,YAAY,EAAE;SAC7C,CAAC,CAAA;QAEF,IAAI,YAAY,GAAG,aAAa,EAAE,CAAC;YACjC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,qBAAqB;gBAC3B,OAAO,EACL,oBAAoB,IAAI,uBAAuB,YAAY,GAAG;oBAC9D,6BAA6B,aAAa,GAAG;aAChD,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,MAAM,cAAc,GAClB,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,GAAG,aAAa,CAAC,CAAC,CAAC,SAAS,CAAA;IAExE,OAAO;QACL,YAAY,EAAE,IAAI;QAClB,gBAAgB;QAChB,aAAa;QACb,YAAY;QACZ,cAAc;QACd,QAAQ;KACT,CAAA;AACH,CAAC"}

package/dist/core/assembly/update-mode.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=update-mode.test.d.ts.map

package/dist/core/assembly/update-mode.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-mode.test.d.ts","sourceRoot":"","sources":["../../../src/core/assembly/update-mode.test.ts"],"names":[],"mappings":""}