@schnick371/devsteps-shared 1.1.0-next.3 → 2.0.0-next.1

package/dist/core/host-setup.js

@@ -0,0 +1,277 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * `host-config.ts` owns the shape of what is written; this module owns the
+ * filesystem side and the report a caller shows the user.
+ *
+ * @see EPIC-056 STORY-399 TASK-776 TASK-777
+ */
+import { spawnSync } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { setupCodexProject } from '../utils/codex-setup.js';
+import { assertCodexOptions } from '../utils/codex-types.js';
+import { selectToolGroups } from '../utils/mcp-tool-groups.js';
+import { buildHostEntry, hostConfigPath, mergeHostDocument, UNMANAGED_SELECTION, } from './host-config.js';
+/** Binary a global install of the MCP server package puts on PATH. */
+const GLOBAL_SERVER_COMMAND = 'devsteps-mcp-server';
+/** npm package the npx fallback launches. */
+const SERVER_PACKAGE = '@schnick371/devsteps-mcp-server';
+/**
+ * Variable that names the model Claude Code gives a subagent by default.
+ *
+ * A subagent resolves its model as: invocation parameter → its own frontmatter
+ * → this variable → the main session's model. The built-in agent types carry no
+ * frontmatter, so without this they run on whatever the session runs on, which
+ * is the largest model in play.
+ */
+export const SUBAGENT_MODEL_ENV_VAR = 'CLAUDE_CODE_SUBAGENT_MODEL';
+/**
+ * Model an adapter offers when the user asks for one without naming it.
+ *
+ * Sonnet carries multi-step delegated work while costing a fraction of an
+ * Opus-class session; an agent that needs more says so in its own frontmatter,
+ * which takes precedence over this value. Never applied on its own — writing
+ * `.claude/settings.json` always follows an explicit request.
+ */
+export const DEFAULT_SUBAGENT_MODEL = 'sonnet';
+/** Public marketplace a consumer project declares to reach the plugin. */
+export const PLUGIN_MARKETPLACE = 'devsteps';
+export const PLUGIN_REPOSITORY = 'Schnick371/devsteps';
+export const PLUGIN_ID = 'devsteps@devsteps';
+/**
+ * Resolve how this machine should launch the MCP server.
+ *
+ * Global install first, npx second — the order the VS Code extension and the
+ * Claude Code plugin launcher also apply. A maintainer can install a prerelease
+ * globally and have every host pick it up; a pure npx configuration would bypass
+ * that, because npx resolves from the registry and its own cache rather than
+ * from the global npm prefix. Deliberately unpinned so an ordinary user gets the
+ * latest published release.
+ *
+ * The explicit `--package` form is required because the package declares three
+ * bins.
+ */
+export function resolveServerRuntime() {
+    const probe = spawnSync(process.platform === 'win32' ? 'where' : 'which', [
+        GLOBAL_SERVER_COMMAND,
+    ]);
+    if (probe.status === 0) {
+        return { command: GLOBAL_SERVER_COMMAND, args: [], strategy: 'global' };
+    }
+    return {
+        command: 'npx',
+        args: ['-y', `--package=${SERVER_PACKAGE}`, 'devsteps-mcp'],
+        strategy: 'npx',
+    };
+}
+/** Read a JSON document, treating an unparsable file as absent. */
+function readJson(path) {
+    if (!existsSync(path))
+        return undefined;
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        return typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)
+            ? parsed
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Settings may contain permission rules, so an unreadable existing file is never replaced. */
+function readClaudeSettings(projectPath) {
+    const path = join(projectPath, '.claude', 'settings.json');
+    const settings = readJson(path);
+    if (existsSync(path) && !settings) {
+        throw new Error(`Could not parse ${path} as a JSON object; settings left unchanged.`);
+    }
+    return settings;
+}
+/** Write a JSON document, creating the directory when the host needs one. */
+function writeJson(path, document) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(document, null, 2)}\n`);
+}
+/**
+ * Write the project-level Claude Code settings DevSteps owns.
+ *
+ * Both concerns share one file, so they share one read-modify-write: two passes
+ * would make the second overwrite the first's in-memory view.
+ */
+export function applyClaudeSettings(projectPath, options) {
+    const path = join(projectPath, '.claude', 'settings.json');
+    const existing = readClaudeSettings(projectPath);
+    const document = { ...existing };
+    if (options.plugin) {
+        const marketplaces = (existing?.extraKnownMarketplaces ?? {});
+        const enabled = (existing?.enabledPlugins ?? {});
+        document.extraKnownMarketplaces = {
+            ...marketplaces,
+            [PLUGIN_MARKETPLACE]: { source: { source: 'github', repo: PLUGIN_REPOSITORY } },
+        };
+        document.enabledPlugins = { ...enabled, [PLUGIN_ID]: true };
+    }
+    const env = { ...(existing?.env ?? {}) };
+    const declared = typeof env[SUBAGENT_MODEL_ENV_VAR] === 'string'
+        ? env[SUBAGENT_MODEL_ENV_VAR]
+        : undefined;
+    const subagentModel = options.subagentModelSource === 'fallback'
+        ? (declared ?? options.subagentModel)
+        : (options.subagentModel ?? declared);
+    if (subagentModel !== undefined && subagentModel !== declared) {
+        document.env = { ...env, [SUBAGENT_MODEL_ENV_VAR]: subagentModel };
+    }
+    const relative = '.claude/settings.json';
+    const before = existing ? JSON.stringify(existing) : undefined;
+    if (before === JSON.stringify(document)) {
+        return { path: relative, action: 'unchanged', subagentModel };
+    }
+    writeJson(path, document);
+    return {
+        path: relative,
+        action: existing ? 'updated' : 'created',
+        subagentModel,
+        ...(subagentModel !== undefined && subagentModel !== declared
+            ? { subagentModelChange: { previous: declared, current: subagentModel } }
+            : {}),
+    };
+}
+/**
+ * Declare the plugin in the project's `.claude/settings.json`.
+ *
+ * These are the two keys `claude plugin marketplace add --scope project` and
+ * `claude plugin install --scope project` produce. Writing them directly means a
+ * committed project brings the plugin with it, and nobody has to type a
+ * `/plugin` command in a fresh clone.
+ *
+ * The source is the public repository rather than a directory path, because a
+ * directory source resolves only on the machine that wrote it.
+ */
+export function declareClaudePlugin(projectPath) {
+    return applyClaudeSettings(projectPath, { plugin: true });
+}
+/**
+ * Configure one or both hosts for a project.
+ *
+ * An unrecognised group name is reported rather than written: the server falls
+ * back to the full catalog for a value it cannot parse, so writing it would
+ * produce a file that looks configured and changes nothing.
+ */
+function configureHostEntries(projectPath, options, runtime, selection) {
+    const files = [];
+    const notes = [];
+    const settings = options.hosts.includes('claude') ? readClaudeSettings(projectPath) : undefined;
+    const enabled = settings?.enabledPlugins;
+    const pluginSelected = options.plugin || enabled?.[PLUGIN_ID] === true;
+    for (const host of options.hosts) {
+        const relative = hostConfigPath(host);
+        const path = join(projectPath, relative);
+        if (host === 'claude' && pluginSelected) {
+            notes.push('The DevSteps plugin is declared; installation is not verified. ' +
+                'No project .mcp.json entry was added. ' +
+                (existsSync(path)
+                    ? 'Existing .mcp.json was preserved; check it for a duplicate DevSteps server.'
+                    : 'Install the declared plugin before starting Claude Code.'));
+            if (selection.managed) {
+                notes.push('The requested tool-group selection was not applied to the plugin server.');
+            }
+            continue;
+        }
+        const existing = readJson(path);
+        const entry = buildHostEntry(host, runtime, selection);
+        const document = mergeHostDocument(host, existing, entry, selection);
+        if (existing && JSON.stringify(existing) === JSON.stringify(document)) {
+            files.push({ path: relative, action: 'unchanged' });
+            continue;
+        }
+        writeJson(path, document);
+        files.push({ path: relative, action: existing ? 'updated' : 'created' });
+    }
+    return { files, notes };
+}
+/** Configure host entries and explicitly requested settings, reporting every change. */
+export function setupHost(projectPath, options) {
+    assertCodexOptions(options.hosts.includes('codex') ? 'codex' : 'legacy', options);
+    if (options.hosts.includes('codex'))
+        return setupCodexHost(projectPath, options);
+    if (options.dryRun !== undefined ||
+        options.force !== undefined ||
+        options.maxBackups !== undefined) {
+        throw new Error('Setup dry-run, force and retention require the codex host.');
+    }
+    const { selection, unknown } = options.tools
+        ? selectToolGroups(options.tools)
+        : { selection: UNMANAGED_SELECTION, unknown: [] };
+    const runtime = options.runtime
+        ? { ...options.runtime, strategy: 'global' }
+        : resolveServerRuntime();
+    const { files, notes } = configureHostEntries(projectPath, options, runtime, selection);
+    // `.claude/settings.json` is written only when asked for: it is where a
+    // project approves servers and enables plugins, so setting up a host must not
+    // create it as a side effect. Both triggers below are explicit requests.
+    let subagentModel;
+    let settingsChanged = false;
+    if (options.plugin || options.subagentModel) {
+        const settings = applyClaudeSettings(projectPath, {
+            plugin: options.plugin,
+            subagentModel: options.subagentModel,
+            subagentModelSource: options.subagentModelSource,
+        });
+        subagentModel = settings.subagentModel;
+        settingsChanged = settings.action !== 'unchanged';
+        files.push({
+            path: settings.path,
+            action: settings.action,
+            ...(settings.subagentModelChange
+                ? { subagentModelChange: settings.subagentModelChange }
+                : {}),
+        });
+    }
+    // Both a tool selection and a subagent model are read at host start, so a
+    // change to either only takes effect once the host restarts the server.
+    const hostFileChanged = files.some((file) => file.action !== 'unchanged' && file.path !== '.claude/settings.json');
+    return {
+        files,
+        runtime,
+        selection,
+        unknownGroups: unknown,
+        subagentModel,
+        restartRequired: (selection.managed && hostFileChanged) || settingsChanged,
+        notes,
+    };
+}
+/** Codex has a separate TOML planner; legacy JSON and runtime resolution remain unchanged. */
+function setupCodexHost(projectPath, options) {
+    if (options.hosts.length !== 1)
+        throw new Error('Configure Codex separately from other hosts.');
+    if (options.plugin !== undefined ||
+        options.subagentModel !== undefined ||
+        options.subagentModelSource !== undefined ||
+        options.runtime !== undefined) {
+        throw new Error('Codex inherits model/runtime policy; Claude plugin, model and runtime overrides are unsupported.');
+    }
+    const { selection, unknown } = options.tools
+        ? selectToolGroups(options.tools)
+        : { selection: UNMANAGED_SELECTION, unknown: [] };
+    if (unknown.length)
+        throw new Error(`Unknown tool groups: ${unknown.join(', ')}`);
+    const codex = setupCodexProject(projectPath, join(projectPath, '.devsteps'), options);
+    if (!codex.success)
+        throw new Error(`${codex.message} ${codex.error}`);
+    return {
+        codex,
+        dryRun: options.dryRun,
+        selection,
+        unknownGroups: [],
+        runtime: { command: 'node', args: [], strategy: 'global' },
+        files: codex.files.map((file) => ({
+            path: file.file,
+            action: file.status === 'added' ? 'created' : file.status === 'skipped' ? 'unchanged' : 'updated',
+        })),
+        restartRequired: !options.dryRun && codex.files.some((file) => file.status !== 'skipped'),
+        notes: [codex.message],
+    };
+}
+//# sourceMappingURL=host-setup.js.map

package/dist/core/host-setup.js.map

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

package/dist/core/import-excerpt.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Bounded classification context, never a durable copy of an imported document (BUG-245).
+ */
+/** Redact personal home prefixes while retaining the path below the home directory. */
+export declare function importExcerpt(content: string): string;
+//# sourceMappingURL=import-excerpt.d.ts.map

package/dist/core/import-excerpt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-excerpt.d.ts","sourceRoot":"","sources":["../../src/core/import-excerpt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQrD"}

package/dist/core/import-excerpt.js

@@ -0,0 +1,17 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Bounded classification context, never a durable copy of an imported document (BUG-245).
+ */
+/** Redact personal home prefixes while retaining the path below the home directory. */
+export function importExcerpt(content) {
+    return content
+        .split('\n')
+        .slice(0, 40)
+        .join('\n')
+        .replace(/(?:[a-z]:[\\/]|[\\/])(?:home|users)[\\/][^\\/\r\n"'<>`]+/gi, '[home]')
+        .replace(/\/root(?=[/\s]|$)/g, '[home]')
+        .slice(0, 8192);
+}
+//# sourceMappingURL=import-excerpt.js.map

package/dist/core/import-excerpt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-excerpt.js","sourceRoot":"","sources":["../../src/core/import-excerpt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uFAAuF;AACvF,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,OAAO;SACX,KAAK,CAAC,IAAI,CAAC;SACX,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACZ,IAAI,CAAC,IAAI,CAAC;SACV,OAAO,CAAC,4DAA4D,EAAE,QAAQ,CAAC;SAC/E,OAAO,CAAC,oBAAoB,EAAE,QAAQ,CAAC;SACvC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACpB,CAAC"}

package/dist/core/import-materialize.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Preflight and materialize document import sessions (STORY-524, BUG-245).
+ */
+export interface ImportCommitOptions {
+    session_id: string;
+    token: string;
+    dry_run?: boolean;
+    hierarchy?: Record<string, {
+        parent_id: string | null;
+        level?: number;
+    }>;
+}
+/** Serialize commits of one session and preflight every source before the first item is created. */
+export declare function commitImportSession(devstepsDir: string, options: ImportCommitOptions): Promise<{
+    success: boolean;
+    items_created: number;
+    bom_nodes_added: number;
+    skipped: number;
+    errors: {
+        path: string;
+        reason: string;
+    }[];
+    warnings: string[];
+    doc_items: string[];
+    written: {
+        id: string;
+        source: string;
+        bytes_written: number;
+    }[];
+    dry_run: boolean;
+    next_steps: string[];
+} | {
+    success: boolean;
+    error: string | undefined;
+    doc_items?: undefined;
+    dry_run?: undefined;
+    items_would_create?: undefined;
+    skipped?: undefined;
+    files?: undefined;
+    next_steps?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    doc_items: string[] | undefined;
+    dry_run?: undefined;
+    items_would_create?: undefined;
+    skipped?: undefined;
+    files?: undefined;
+    next_steps?: undefined;
+} | {
+    error?: undefined;
+    doc_items?: undefined;
+    success: boolean;
+    dry_run: boolean;
+    items_would_create: number;
+    skipped: number;
+    files: {
+        path: string;
+        bytes_to_write: number;
+    }[];
+    next_steps: string[];
+}>;
+//# sourceMappingURL=import-materialize.d.ts.map

package/dist/core/import-materialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-materialize.d.ts","sourceRoot":"","sources":["../../src/core/import-materialize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmBH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1E;AAiLD,oGAAoG;AACpG,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB;;;;;;cA5E7D,MAAM;gBAAU,MAAM;;;;;YADvB,MAAM;gBAAU,MAAM;uBAAiB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqHzE"}

package/dist/core/import-materialize.js

@@ -0,0 +1,217 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Preflight and materialize document import sessions (STORY-524, BUG-245).
+ */
+import { dirname, relative } from 'node:path';
+import { addItem } from './add.js';
+import { appendDocsMapNode, readDocsMap } from './docs-map.js';
+import { getItem } from './get.js';
+import { validateSession, withImportCommitLock, withSessionLock, writeSession, } from './import-session.js';
+import { readImportSource, selectImportSections } from './import-source.js';
+import { itemPaths } from './item-paths.js';
+import { linkItem } from './link.js';
+import { validateWorkspacePath } from './path-guard.js';
+import { updateItem } from './update.js';
+function slugFor(file) {
+    return file
+        .replace(/\.md$/, '')
+        .replace(/[^a-z0-9-]/gi, '-')
+        .toLowerCase();
+}
+async function planDocuments(devstepsDir, session, options) {
+    const workspace = dirname(devstepsDir);
+    const plan = [];
+    const nodeIds = new Set(readDocsMap(devstepsDir).nodes.map((node) => node.id));
+    for (const entry of session.classified) {
+        if (entry.decision === 'skip')
+            continue;
+        const file = session.files.find((source) => source.path === entry.path);
+        if (!file)
+            throw new Error(`Classified source was not scanned: ${entry.path}`);
+        const source = await readImportSource(workspace, file);
+        if (entry.decision === 'rewrite') {
+            plan.push({
+                source: entry.path,
+                path: entry.path,
+                title: `rewrite: ${slugFor(entry.path)}`,
+                description: `Marked for full rewrite. Original: ${entry.path}`,
+                tags: ['diataxis', 'rewrite', 'import'],
+                relatedItems: source.relatedItems,
+            });
+            continue;
+        }
+        const splits = entry.decision === 'split' ? entry.splits : undefined;
+        if (entry.decision === 'split' && !splits?.length)
+            throw new Error(`Missing splits for ${entry.path}`);
+        if (entry.decision === 'accept' && !entry.diataxis_type)
+            throw new Error(`Missing Diataxis type for ${entry.path}`);
+        const outputs = splits ?? [
+            { new_path: entry.path, diataxis_type: entry.diataxis_type, sections: undefined },
+        ];
+        for (const output of outputs) {
+            if (!validateWorkspacePath(output.new_path, workspace))
+                throw new Error(`Output path outside workspace: ${output.new_path}`);
+            const id = slugFor(output.new_path);
+            const parent = options.hierarchy?.[entry.path]?.parent_id ?? null;
+            if (nodeIds.has(id))
+                throw new Error(`BOM node already exists or is duplicated: ${id}`);
+            if (parent !== null && !nodeIds.has(parent))
+                throw new Error(`BOM parent not found: ${parent}`);
+            nodeIds.add(id);
+            plan.push({
+                source: entry.path,
+                path: output.new_path,
+                title: `${output.diataxis_type}: ${id}`,
+                description: output.sections
+                    ? selectImportSections(source.body, output.sections)
+                    : source.body,
+                tags: ['diataxis', output.diataxis_type, 'import'],
+                relatedItems: source.relatedItems,
+                node: { id, parent_id: parent },
+            });
+        }
+    }
+    return plan;
+}
+async function linkRelated(devstepsDir, id, targets, warnings) {
+    for (const target of targets) {
+        try {
+            await getItem(devstepsDir, target);
+        }
+        catch {
+            warnings.push(`related_items entry '${target}' not found — link skipped`);
+            continue;
+        }
+        try {
+            const result = await linkItem(devstepsDir, {
+                sourceId: id,
+                relationType: 'documents',
+                targetId: target,
+            });
+            if (!result.success)
+                warnings.push(`${id} documents ${target}: ${result.error}`);
+        }
+        catch (error) {
+            warnings.push(`${id} documents ${target}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}
+async function materialize(devstepsDir, session, plan) {
+    const items = [];
+    const written = [];
+    const errors = [];
+    const warnings = [];
+    let nodes = 0;
+    session.materialization_started = true;
+    await writeSession(devstepsDir, session);
+    for (const document of plan) {
+        try {
+            const created = await addItem(devstepsDir, {
+                type: 'doc',
+                title: document.title,
+                description: document.description,
+                tags: document.tags,
+                affected_paths: [document.path],
+            }, { preserveDescription: true });
+            items.push(created.itemId);
+            session.materialized_items = [...items];
+            await writeSession(devstepsDir, session);
+            // The imported master is authoritative even when the original source later changes.
+            // Keep source provenance as a second path; doc_read_content selects the master first.
+            await updateItem(devstepsDir, {
+                id: created.itemId,
+                affected_paths: [
+                    relative(dirname(devstepsDir), itemPaths(devstepsDir, created.itemId).description),
+                    document.path,
+                ],
+            });
+            await linkRelated(devstepsDir, created.itemId, document.relatedItems, warnings);
+            if (document.node) {
+                const added = appendDocsMapNode(devstepsDir, document.node.parent_id, {
+                    ...document.node,
+                    doc_id: created.itemId,
+                    title: document.title,
+                    order: (readDocsMap(devstepsDir).nodes.length + 1) * 10,
+                    devsteps_items: [created.itemId],
+                });
+                if (!added)
+                    throw new Error(`BOM parent disappeared: ${document.node.parent_id}`);
+                nodes++;
+            }
+            written.push({
+                id: created.itemId,
+                source: document.source,
+                bytes_written: Buffer.byteLength(document.description),
+            });
+        }
+        catch (error) {
+            errors.push({
+                path: document.source,
+                reason: error instanceof Error ? error.message : String(error),
+            });
+            break;
+        }
+    }
+    session.status = errors.length ? 'review' : 'committed';
+    await writeSession(devstepsDir, session);
+    return {
+        success: errors.length === 0,
+        items_created: items.length,
+        bom_nodes_added: nodes,
+        skipped: session.classified.filter((entry) => entry.decision === 'skip').length,
+        errors,
+        warnings,
+        doc_items: items,
+        written,
+        dry_run: false,
+        next_steps: errors.length
+            ? [
+                'Partial import. A failed add may have written files beyond doc_items. Inspect DOC folders and errors; do not retry this session blindly.',
+            ]
+            : [`Created ${items.length} DOC items with source content. Import session complete.`],
+    };
+}
+/** Serialize commits of one session and preflight every source before the first item is created. */
+export async function commitImportSession(devstepsDir, options) {
+    const commit = async () => {
+        const validation = await validateSession(devstepsDir, options.session_id, options.token);
+        if ('error' in validation)
+            return { success: false, error: validation.error };
+        const session = validation.session;
+        if (session.pending.length)
+            return {
+                success: false,
+                error: `Session has ${session.pending.length} pending files. Complete classification first.`,
+            };
+        if (session.status === 'committed')
+            return { success: false, error: 'Session already committed.' };
+        if (session.status === 'aborted')
+            return { success: false, error: 'Session was aborted.' };
+        if (session.materialization_started || session.materialized_items?.length)
+            return {
+                success: false,
+                error: 'Session has a partial materialization. Inspect existing DOC items before starting a new import.',
+                doc_items: session.materialized_items,
+            };
+        const plan = await planDocuments(devstepsDir, session, options);
+        if (options.dry_run)
+            return {
+                success: true,
+                dry_run: true,
+                items_would_create: plan.length,
+                skipped: session.classified.filter((entry) => entry.decision === 'skip').length,
+                files: plan.map((doc) => ({
+                    path: doc.source,
+                    bytes_to_write: Buffer.byteLength(doc.description),
+                })),
+                next_steps: ['Preflight passed. Call without dry_run to materialize the import.'],
+            };
+        return materialize(devstepsDir, session, plan);
+    };
+    return options.dry_run
+        ? commit()
+        : withImportCommitLock(devstepsDir, () => withSessionLock(devstepsDir, options.session_id, commit));
+}
+//# sourceMappingURL=import-materialize.js.map

package/dist/core/import-materialize.js.map

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