@contentful/experience-design-system-cli 2.26.1-dev-build-a852362.0 → 2.26.1-dev-build-f03f014.0

package/dist/src/runs/replay-helpers.js

@@ -1,164 +0,0 @@
-import { resolve } from 'node:path';
-import { resolveRunTarget } from './resolve-run-target.js';
-import { updateRun } from './store.js';
-import { pushRunSession } from './push-helpers.js';
-import { readExperiencesCredentials } from '../credentials-store.js';
-import { launchModifyWizard } from './modify-launcher.js';
-import { checkRunStaleness, formatStalenessDetail } from './staleness.js';
-function formatStalenessRefusal(run, detail) {
-    return [
-        `Refusing to replay run ${run.id} — source or saved files have drifted since the run was recorded.`,
-        ...detail,
-        '',
-        'Re-extract with `experiences import --project <path>` for a fresh run, or pass --force to bypass.',
-    ].join('\n');
-}
-const MISSING_CREDS_ERROR = "--push-from-run requires credentials (space-id / environment-id / cma-token). Pass --cma-token or run 'experiences setup' first.";
-/**
- * Push a prior run's recorded pipeline.db session directly to Contentful
- * without re-running extraction or generation, and without writing any
- * components.json / tokens.json to disk.
- *
- * Exposed as `experiences import --push-from-run <id-or-path>`.
- *
- * Credentials resolution order:
- *   1. Flags on the command (`--space-id`, `--environment-id`, `--cma-token`,
- *      `--host`).
- *   2. The run record's `pushedTo` field (space / env / host only — the
- *      CMA token is never persisted).
- *   3. `~/.config/experiences/credentials.json` (the `experiences setup`
- *      store) and matching env vars.
- *   4. If still incomplete and interactive: open the wizard's existing
- *      credentials step. If non-TTY: error.
- */
-export async function replayRun(opts) {
-    const run = await resolveRunTarget(opts.runIdOrPath);
-    // Staleness gate: refuse before any push side effect when source files or
-    // saved artifacts have drifted. Bypassed by --force.
-    if (!opts.force) {
-        const staleness = await checkRunStaleness(run);
-        if (staleness.stale) {
-            throw new Error(formatStalenessRefusal(run, formatStalenessDetail(staleness)));
-        }
-    }
-    const sessionId = run.generateSessionId ?? run.extractSessionId;
-    // Layered credentials resolution.
-    const stored = await readExperiencesCredentials();
-    let spaceId = opts.spaceId || run.pushedTo?.spaceId || stored.spaceId || '';
-    let environmentId = opts.environmentId || run.pushedTo?.environmentId || stored.environmentId || '';
-    let cmaToken = opts.cmaToken || stored.cmaToken || '';
-    let host = opts.host || run.pushedTo?.host || stored.host || '';
-    if (!spaceId || !environmentId || !cmaToken) {
-        if (!opts.interactive) {
-            throw new Error(MISSING_CREDS_ERROR);
-        }
-        const prompt = opts.promptForCredentials ??
-            (async (need) => {
-                const { promptForPushCredentials } = await import('./push-creds-prompt.js');
-                return promptForPushCredentials({
-                    ...(need.spaceId ? { initialSpaceId: need.spaceId } : {}),
-                    ...(need.environmentId ? { initialEnvironmentId: need.environmentId } : {}),
-                    ...(need.cmaToken ? { initialCmaToken: need.cmaToken } : {}),
-                    ...(need.host ? { initialHost: need.host } : {}),
-                    summary: `Push run ${run.id} → enter credentials. Defaults reflect the run record and your saved setup.`,
-                });
-            });
-        const collected = await prompt({
-            spaceId,
-            environmentId,
-            cmaToken,
-            host,
-        });
-        spaceId = collected.spaceId;
-        environmentId = collected.environmentId;
-        cmaToken = collected.cmaToken;
-        host = collected.host;
-        if (!spaceId || !environmentId || !cmaToken) {
-            throw new Error(MISSING_CREDS_ERROR);
-        }
-    }
-    const result = await pushRunSession({
-        sessionId,
-        spaceId,
-        environmentId,
-        cmaToken,
-        ...(host ? { host } : {}),
-        ...(opts.allowDeletions ? { allowDeletions: true } : {}),
-    });
-    if (!result.ok) {
-        throw new Error(result.error);
-    }
-    // Push the tokens session too when the run has one. Tokens live in their
-    // own pipeline.db session (separate from extract/generate), so a single
-    // `apply push --session <id>` only covers components. Without this second
-    // push, design tokens recorded by the run never reach Contentful on replay.
-    if (run.tokenSessionId) {
-        const tokenResult = await pushRunSession({
-            sessionId: run.tokenSessionId,
-            spaceId,
-            environmentId,
-            cmaToken,
-            ...(host ? { host } : {}),
-            ...(opts.allowDeletions ? { allowDeletions: true } : {}),
-        });
-        if (!tokenResult.ok) {
-            throw new Error(tokenResult.error);
-        }
-    }
-    await updateRun(run.id, {
-        pushedTo: { spaceId, environmentId, host: host || '' },
-    });
-    const componentLine = `Pushed ${run.componentCount} component${run.componentCount === 1 ? '' : 's'} to ${spaceId}/${environmentId}`;
-    const tokensLine = run.tokenCount > 0 ? ` (also: ${run.tokenCount} token${run.tokenCount === 1 ? '' : 's'})` : '';
-    process.stdout.write(`${componentLine}${tokensLine}\n`);
-}
-/**
- * Re-open the wizard with a prior run's extract/generate session pre-populated
- * so the operator can tweak fields. Exposed as
- * `experiences import --modify <id-or-path>`. Default entry step is
- * `final-review`.
- */
-export async function modifyRun(opts) {
-    if (opts.saveAsNew && opts.overwrite) {
-        throw new Error('--save-as-new and --overwrite are mutually exclusive.');
-    }
-    const run = await resolveRunTarget(opts.runIdOrPath);
-    if (!opts.force) {
-        const staleness = await checkRunStaleness(run);
-        if (staleness.stale) {
-            throw new Error(formatStalenessRefusal(run, formatStalenessDetail(staleness)));
-        }
-    }
-    const saveMode = opts.overwrite ? 'overwrite' : opts.saveAsNew ? 'new' : 'prompt';
-    // Credentials pre-fill precedence: run.pushedTo field-by-field, then
-    // credentials.json (which itself falls back to env vars). The modify entry
-    // step goes straight to final-review and does not surface the credentials
-    // step, so if `pushedTo` is null (last push failed or never happened) we
-    // must consult the on-disk store here — otherwise the wizard mounts with
-    // built-in defaults (environmentId='master', host='api.contentful.com')
-    // and preview fires against the wrong endpoint. CMA token is now included
-    // in the fallback because credentials-store.ts persists it (INTEG-4410);
-    // if it's still empty after the merge, the wizard's final-review preview
-    // will 401 and the operator sees a real gap — out of scope for this fix.
-    const stored = await readExperiencesCredentials();
-    const mergedSpaceId = run.pushedTo?.spaceId || stored.spaceId || '';
-    const mergedEnvironmentId = run.pushedTo?.environmentId || stored.environmentId || '';
-    const mergedHost = run.pushedTo?.host || stored.host || '';
-    const mergedCmaToken = stored.cmaToken || '';
-    await launchModifyWizard({
-        extractSessionId: run.extractSessionId,
-        generateSessionId: run.generateSessionId,
-        tokenSessionId: run.tokenSessionId,
-        projectPath: run.projectPath,
-        savePath: run.savePath,
-        entryStep: 'final-review',
-        saveMode,
-        ...(run.compositionMode ? { compositionMode: run.compositionMode } : {}),
-        ...(opts.outDir ? { outDirOverride: resolve(opts.outDir) } : {}),
-        ...(mergedSpaceId ? { initialSpaceId: mergedSpaceId } : {}),
-        ...(mergedEnvironmentId ? { initialEnvironmentId: mergedEnvironmentId } : {}),
-        ...(mergedHost ? { initialHost: mergedHost } : {}),
-        ...(mergedCmaToken ? { initialCmaToken: mergedCmaToken } : {}),
-        ...(opts.allowDeletions !== undefined ? { allowDeletions: opts.allowDeletions } : {}),
-    });
-}

package/dist/src/runs/resolve-run-target.js

@@ -1,45 +0,0 @@
-import { homedir } from 'node:os';
-import { resolve as resolvePath } from 'node:path';
-import { findAllRunsBySavePath, getRun } from './store.js';
-/**
- * Decide whether a positional CLI arg refers to a run-id or a filesystem path,
- * then look up the corresponding RunRecord.
- *
- * Mirrors `git checkout` accepting either a sha or a ref: anything that *looks
- * like* a path is treated as one; otherwise we fall back to a run-id lookup.
- *
- * Path detection: arg starts with `/`, `./`, `../`, or `~/`, OR equals `.`,
- * OR equals `~`.
- */
-export async function resolveRunTarget(arg) {
-    if (looksLikePath(arg)) {
-        const absolute = resolvePath(expandHome(arg));
-        const matches = await findAllRunsBySavePath(absolute);
-        if (matches.length === 0) {
-            throw new Error(`No run recorded for path ${absolute}. Run 'experiences runs' to list known runs.`);
-        }
-        if (matches.length === 1) {
-            return matches[0];
-        }
-        // Multi-match: newest createdAt wins. ISO UTC timestamps compare
-        // lexicographically (see store.ts: createdAt = new Date().toISOString()).
-        const sorted = [...matches].sort((a, b) => (a.createdAt < b.createdAt ? 1 : -1));
-        const newest = sorted[0];
-        const olderCount = matches.length - 1;
-        process.stderr.write(`Multiple runs at ${absolute}; using newest ${newest.id} (createdAt ${newest.createdAt}). ${olderCount} older candidates ignored.\n`);
-        return newest;
-    }
-    return getRun(arg);
-}
-function looksLikePath(arg) {
-    if (arg === '.' || arg === '~')
-        return true;
-    return arg.startsWith('/') || arg.startsWith('./') || arg.startsWith('../') || arg.startsWith('~/');
-}
-function expandHome(arg) {
-    if (arg === '~')
-        return homedir();
-    if (arg.startsWith('~/'))
-        return resolvePath(homedir(), arg.slice(2));
-    return arg;
-}

package/dist/src/runs/run-picker-mount.js

@@ -1,72 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { READABLE_VERSIONS, runsFilePath } from './store.js';
-function migrateRecord(rec) {
-    return {
-        ...rec,
-        tokensPath: rec.tokensPath ?? null,
-        tokenSessionId: rec.tokenSessionId ?? null,
-    };
-}
-function hasBlockingFlag(flags) {
-    if (flags.pushFromRun !== undefined)
-        return true;
-    if (flags.modify !== undefined)
-        return true;
-    if (flags.project !== undefined)
-        return true;
-    if (flags.autoAcceptScope)
-        return true;
-    if (flags.printPrompt)
-        return true;
-    if (flags.dryRun)
-        return true;
-    return false;
-}
-/**
- * Pure decision helper for whether the wizard should open with the run picker.
- *
- * Picker shows iff ALL hold:
- *   1. `~/.config/experiences/runs.json` exists
- *   2. The file has >=1 run entry
- *   3. None of `--push-from-run`, `--modify`, `--project`,
- *      `--auto-accept-scope`, `--print-prompt`, or `--dry-run` were passed
- *   4. stdin is a TTY
- *
- * On any failure (including ENOENT or a parse error), the helper returns
- * `{ shouldShow: false, runs: [] }`. We deliberately swallow parse errors
- * here: the wizard's normal entry point is more important than surfacing a
- * malformed runs.json — the operator can still use `experiences runs ls` to
- * diagnose later.
- */
-export async function shouldShowRunPicker(input) {
-    if (!input.isTTY)
-        return { shouldShow: false, runs: [] };
-    if (hasBlockingFlag(input.flags))
-        return { shouldShow: false, runs: [] };
-    const path = input.runsJsonPath ?? runsFilePath();
-    let raw;
-    try {
-        raw = await readFile(path, 'utf8');
-    }
-    catch {
-        return { shouldShow: false, runs: [] };
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        return { shouldShow: false, runs: [] };
-    }
-    // Accept any version this CLI can read (see store.ts READABLE_VERSIONS).
-    // Pre-PR-#78 v1 files are migrated to v2 in memory below; gating on strict
-    // equality with RUNS_FILE_VERSION would silently hide every v1 run.
-    if (!READABLE_VERSIONS.has(parsed.version)) {
-        return { shouldShow: false, runs: [] };
-    }
-    const rawRuns = Array.isArray(parsed.runs) ? parsed.runs : [];
-    if (rawRuns.length === 0)
-        return { shouldShow: false, runs: [] };
-    const runs = rawRuns.map(migrateRecord);
-    return { shouldShow: true, runs };
-}

package/dist/src/runs/run-picker.js

@@ -1,129 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState } from 'react';
-import { Box, Text } from 'ink';
-import { useImmediateInput } from '../analyze/select/tui/hooks/useImmediateInput.js';
-const COLLAPSED_LIMIT = 10;
-const COLLAPSE_THRESHOLD = 12;
-function formatCreatedAt(iso) {
-    const d = new Date(iso);
-    if (Number.isNaN(d.getTime()))
-        return iso;
-    const yyyy = d.getFullYear();
-    const mm = String(d.getMonth() + 1).padStart(2, '0');
-    const dd = String(d.getDate()).padStart(2, '0');
-    const hh = String(d.getHours()).padStart(2, '0');
-    const mi = String(d.getMinutes()).padStart(2, '0');
-    return `${yyyy}-${mm}-${dd} ${hh}:${mi}`;
-}
-function runLine(run) {
-    const date = formatCreatedAt(run.createdAt);
-    const pushedTag = run.pushedTo ? 'pushed' : 'not pushed';
-    const count = `${run.componentCount} component${run.componentCount === 1 ? '' : 's'}`;
-    return `${run.id} - ${date} - ${run.projectPath} (${count}, ${pushedTag})`;
-}
-const ACTION_OPTIONS = [
-    { key: 'push', label: 'Push', description: "Push this run's recorded session to Contentful." },
-    { key: 'modify', label: 'Modify', description: 'Re-open the wizard at final-review with this run pre-filled.' },
-    { key: 'cancel', label: 'Cancel', description: 'Back to the run list.' },
-];
-function ActionScreen({ runId, onChoose, onBack, }) {
-    const [focusIdx, setFocusIdx] = useState(0);
-    const fire = (opt) => {
-        if (opt === 'cancel')
-            return onBack();
-        onChoose(opt);
-    };
-    useImmediateInput((rawInput, key) => {
-        if (key.upArrow || rawInput === 'k') {
-            setFocusIdx((i) => (i - 1 + ACTION_OPTIONS.length) % ACTION_OPTIONS.length);
-            return;
-        }
-        if (key.downArrow || rawInput === 'j') {
-            setFocusIdx((i) => (i + 1) % ACTION_OPTIONS.length);
-            return;
-        }
-        if (key.return) {
-            fire(ACTION_OPTIONS[focusIdx].key);
-            return;
-        }
-        if (key.escape || rawInput === 'q') {
-            onBack();
-            return;
-        }
-    });
-    return (_jsxs(Box, { flexDirection: "column", gap: 1, paddingX: 2, paddingY: 1, children: [_jsx(Text, { bold: true, children: "Push or modify?" }), _jsxs(Text, { dimColor: true, children: ["Run ", runId] }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: ACTION_OPTIONS.map((opt, i) => {
-                    const focused = i === focusIdx;
-                    return (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: focused ? 'cyan' : undefined, children: focused ? '>' : ' ' }), _jsx(Text, { color: focused ? 'cyan' : undefined, children: opt.label }), _jsxs(Text, { dimColor: true, children: ["- ", opt.description] })] }, opt.key));
-                }) }), _jsxs(Box, { gap: 3, marginTop: 1, children: [_jsx(Text, { dimColor: true, children: "[j/k] Navigate" }), _jsx(Text, { dimColor: true, children: "[Enter] Select" }), _jsx(Text, { dimColor: true, children: "[Esc] Back" })] })] }));
-}
-function buildRows(runs, expanded) {
-    const showAll = expanded || runs.length < COLLAPSE_THRESHOLD;
-    const visible = showAll ? runs : runs.slice(0, COLLAPSED_LIMIT);
-    const rows = visible.map((run) => ({ kind: 'run', run }));
-    if (!showAll)
-        rows.push({ kind: 'show-all' });
-    rows.push({ kind: 'new' });
-    return rows;
-}
-export function RunPicker({ runs, staleRunIds, onSelect, onCancel }) {
-    const [expanded, setExpanded] = useState(false);
-    const [focusIdx, setFocusIdx] = useState(0);
-    const [actionRunId, setActionRunId] = useState(null);
-    const rows = buildRows(runs, expanded);
-    const clampedFocus = Math.min(focusIdx, rows.length - 1);
-    const selectRow = (row) => {
-        if (row.kind === 'show-all') {
-            setExpanded(true);
-            setFocusIdx(COLLAPSED_LIMIT);
-            return;
-        }
-        if (row.kind === 'new') {
-            onSelect({ runId: null, action: 'new' });
-            return;
-        }
-        setActionRunId(row.run.id);
-    };
-    useImmediateInput((rawInput, key) => {
-        if (actionRunId !== null) {
-            return;
-        }
-        if (key.upArrow || rawInput === 'k') {
-            setFocusIdx((i) => (i - 1 + rows.length) % rows.length);
-            return;
-        }
-        if (key.downArrow || rawInput === 'j') {
-            setFocusIdx((i) => (i + 1) % rows.length);
-            return;
-        }
-        if (rawInput === 'n') {
-            onSelect({ runId: null, action: 'new' });
-            return;
-        }
-        if (rawInput === 'q' || key.escape) {
-            onCancel();
-            return;
-        }
-        if (key.return) {
-            const row = rows[clampedFocus];
-            if (row)
-                selectRow(row);
-            return;
-        }
-    });
-    if (actionRunId !== null) {
-        return (_jsx(ActionScreen, { runId: actionRunId, onChoose: (action) => onSelect({ runId: actionRunId, action }), onBack: () => setActionRunId(null) }));
-    }
-    return (_jsxs(Box, { flexDirection: "column", gap: 1, paddingX: 2, paddingY: 1, children: [_jsxs(Text, { bold: true, children: ["Found ", runs.length, " prior run", runs.length === 1 ? '' : 's', ". Continue from one?"] }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: rows.map((row, i) => {
-                    const focused = i === clampedFocus;
-                    const color = focused ? 'cyan' : undefined;
-                    const cursor = focused ? '>' : ' ';
-                    if (row.kind === 'run') {
-                        const isStale = staleRunIds?.has(row.run.id) ?? false;
-                        return (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: color, children: cursor }), _jsx(Text, { color: color, children: runLine(row.run) }), isStale ? _jsx(Text, { dimColor: true, children: " (stale)" }) : null] }, `run-${row.run.id}`));
-                    }
-                    if (row.kind === 'show-all') {
-                        return (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: color, children: cursor }), _jsxs(Text, { color: color, children: ["Show all (", runs.length, ")"] })] }, "show-all"));
-                    }
-                    return (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: color, children: cursor }), _jsx(Text, { color: color, children: "[n] Start a new run" })] }, "new"));
-                }) }), _jsxs(Box, { gap: 3, marginTop: 1, children: [_jsx(Text, { dimColor: true, children: "[j/k] Navigate" }), _jsx(Text, { dimColor: true, children: "[Enter] Select" }), _jsx(Text, { dimColor: true, children: "[n] New" }), _jsx(Text, { dimColor: true, children: "[q] Quit" })] })] }));
-}

package/dist/src/runs/save-conflict.js

@@ -1,56 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState } from 'react';
-import { Box, Text } from 'ink';
-import { useImmediateInput } from '../analyze/select/tui/hooks/useImmediateInput.js';
-const OPTIONS = [
-    { key: 'overwrite', label: 'overwrite', description: 'Replace existing files at this path.' },
-    { key: 'new', label: 'new', description: 'Write to a timestamped subdirectory.' },
-    { key: 'cancel', label: 'cancel', description: 'Go back and pick a different path.' },
-];
-export function SaveConflictGate({ path, onOverwrite, onNew, onCancel }) {
-    // Default cursor on "new" (index 1) — the safer non-destructive choice.
-    const [focusIdx, setFocusIdx] = useState(1);
-    const fire = (opt) => {
-        if (opt === 'overwrite')
-            onOverwrite();
-        else if (opt === 'new')
-            onNew();
-        else
-            onCancel();
-    };
-    useImmediateInput((rawInput, key) => {
-        if (rawInput === 'o') {
-            fire('overwrite');
-            return;
-        }
-        if (rawInput === 'n') {
-            fire('new');
-            return;
-        }
-        if (rawInput === 'c') {
-            fire('cancel');
-            return;
-        }
-        if (key.upArrow) {
-            setFocusIdx((i) => (i - 1 + OPTIONS.length) % OPTIONS.length);
-            return;
-        }
-        if (key.downArrow) {
-            setFocusIdx((i) => (i + 1) % OPTIONS.length);
-            return;
-        }
-        if (key.return) {
-            fire(OPTIONS[focusIdx].key);
-            return;
-        }
-        if (key.escape) {
-            onCancel();
-            return;
-        }
-    });
-    return (_jsxs(Box, { flexDirection: "column", gap: 1, paddingX: 2, paddingY: 1, children: [_jsx(Text, { bold: true, color: "yellow", children: "A prior export exists at:" }), _jsx(Text, { children: path }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: OPTIONS.map((opt, i) => {
-                    const focused = i === focusIdx;
-                    const shortcut = opt.label[0];
-                    return (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: focused ? 'cyan' : undefined, children: focused ? '❯' : ' ' }), _jsxs(Text, { color: focused ? 'cyan' : undefined, children: ["[", shortcut, "]", opt.label.slice(1)] }), _jsxs(Text, { dimColor: true, children: ["\u2014 ", opt.description] })] }, opt.key));
-                }) }), _jsxs(Box, { gap: 3, marginTop: 1, children: [_jsx(Text, { dimColor: true, children: "[o/n/c] Shortcut" }), _jsx(Text, { dimColor: true, children: "[\u2191/\u2193 + Enter] Navigate" }), _jsx(Text, { dimColor: true, children: "[Esc] Cancel" })] })] }));
-}

package/dist/src/runs/save-path-resolver.js

@@ -1,75 +0,0 @@
-import { access } from 'node:fs/promises';
-import { join } from 'node:path';
-export const CONFLICT_MODES = ['overwrite', 'skip', 'fail'];
-export function isConflictMode(value) {
-    return CONFLICT_MODES.includes(value);
-}
-/**
- * The set of files the wizard / CLI may overwrite in the save directory.
- * Centralised so conflict detection and conflict reporting stay in lock-step.
- */
-const SAVE_FILES = ['components.json', 'tokens.json'];
-/**
- * Returns the subset of `SAVE_FILES` that already exist at `path`. Order is
- * stable so test assertions can reason about it.
- */
-async function listConflictingFiles(path) {
-    const conflicts = [];
-    for (const name of SAVE_FILES) {
-        try {
-            await access(join(path, name));
-            conflicts.push(name);
-        }
-        catch {
-            // ENOENT — file not present, keep checking the others.
-        }
-    }
-    return conflicts;
-}
-/**
- * Returns true if `components.json` or `tokens.json` already exists at `path`.
- * Used by the wizard to decide whether to render the save-conflict gate before
- * writing.
- */
-export async function detectSaveConflict(path) {
-    return (await listConflictingFiles(path)).length > 0;
-}
-function pad2(n) {
-    return n < 10 ? `0${n}` : String(n);
-}
-/**
- * Build a timestamped subdirectory under `base` for the "new" branch of the
- * save-conflict gate. Format: `<base>/dsi-YYYYMMDD-HHMMSS` (local time).
- */
-export function buildTimestampedSubdir(base, now = new Date()) {
-    const y = now.getFullYear();
-    const m = pad2(now.getMonth() + 1);
-    const d = pad2(now.getDate());
-    const hh = pad2(now.getHours());
-    const mm = pad2(now.getMinutes());
-    const ss = pad2(now.getSeconds());
-    return join(base, `dsi-${y}${m}${d}-${hh}${mm}${ss}`);
-}
-/**
- * Probe the requested save path and report whether the wizard needs to render
- * the conflict gate, or — when `onConflict` is supplied — resolve the conflict
- * headlessly using the chosen mode.
- */
-export async function resolveSavePath(path, options = {}) {
-    const conflicts = await listConflictingFiles(path);
-    const hasConflict = conflicts.length > 0;
-    if (options.onConflict === undefined) {
-        return hasConflict ? { kind: 'conflict', path } : { kind: 'no-conflict', path };
-    }
-    if (!hasConflict) {
-        return { kind: 'write', path };
-    }
-    switch (options.onConflict) {
-        case 'overwrite':
-            return { kind: 'write', path };
-        case 'skip':
-            return { kind: 'write', path: buildTimestampedSubdir(path, options.now ?? new Date()) };
-        case 'fail':
-            return { kind: 'fail', conflict: { path, files: conflicts } };
-    }
-}