@pecot/visual-mcp 0.0.0-stage → 1.0.0

package/cli/dist/infra/_shared/patch-apply.js

@@ -0,0 +1,202 @@
+// patch-package で patches/ のパッチを当てる処理の共用先。
+//
+// 使うのはテーマの置き場への取得（infra/slidev-theme/store.ts）。
+// 「root の node_modules に入れた依存へ、patchesDirectory のパッチを当てる」形になる。
+//
+// 読むのは呼び出し元が渡す root と patchesDirectory の配下だけで、任意のパスは外から渡らない。
+// そのため本ファイル全体で security/detect-non-literal-fs-filename を disable する。
+/* eslint-disable security/detect-non-literal-fs-filename */
+import { readdirSync, readFileSync, realpathSync } from 'node:fs';
+import path from 'node:path';
+import { isRecord } from '../../domain/_shared/json.js';
+import { digestPatch, sortPatchDigests } from '../../domain/_shared/patch-digest.js';
+import { withFlock } from './flock.js';
+import { spawnPromise } from './process.js';
+/**
+パッチ適用の上限時間 (ms)。
+*/
+const PATCH_APPLY_TIMEOUT_MS = 600_000;
+/**
+patch-package が exit 0 のまま適用件数を満たさなかったときに返す exit code。
+
+patch-package 自身の exit code と取り違えないよう、この値を使う。
+*/
+export const PATCH_INCOMPLETE_EXIT_CODE = 65;
+/**
+ENOENT（対象が無い）か。それ以外の I/O 例外は「パッチ無し」に丸めない。
+*/
+function isNotFound(error) {
+    return isRecord(error) && error['code'] === 'ENOENT';
+}
+/**
+例外の表示文字列。
+*/
+function describeError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+patches/ 配下のパッチを patches/ 起点の相対パス順に (相対パス, 内容ハッシュ) で並べる。
+
+取得済み判定の印に入れるため。
+依存の宣言が変わらなくても、パッチの中身が変われば実体は別物になる。
+そこで、パッチだけの更新でも再取得と再適用を起こす。
+
+走査の規則は patch-package に合わせる。
+`klaw-sync(patchesDir, { nodir: true })` で再帰的に拾い、`.patch` で絞る。
+1 階層だけ見ると、サブディレクトリのパッチは適用されるのに印に入らない。
+すると、そのパッチだけを更新した版が「取得済み」と判定される。
+
+ENOENT だけを「パッチ無し」として扱い、他の例外は error として返す。
+全例外を空に丸めると、権限やディスクの問題で読めなかったときに、
+「当てるべきなのに当てない」まま印が置かれる。
+*/
+export function scanPatchDigests(patchesDirectory) {
+    const digests = [];
+    const error = collectPatchDigests(patchesDirectory, '', digests);
+    return error === undefined ? { digests: sortPatchDigests(digests), error: undefined } : { digests: [], error };
+}
+/**
+patches/ 配下を再帰的に辿って digests へ積む。読めなければ理由を返して打ち切る。
+*/
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types -- 再帰の accumulator
+function collectPatchDigests(root, relative, digests) {
+    const directory = path.join(root, relative);
+    let entries;
+    try {
+        entries = readdirSync(directory, { withFileTypes: true });
+    }
+    catch (error) {
+        return isNotFound(error) ? undefined : `patches ディレクトリを読めません (${directory}): ${describeError(error)}`;
+    }
+    for (const entry of entries) {
+        const child = path.join(relative, entry.name);
+        if (entry.isDirectory()) {
+            const nested = collectPatchDigests(root, child, digests);
+            if (nested !== undefined)
+                return nested;
+            continue;
+        }
+        if (!entry.isFile() || !entry.name.endsWith('.patch'))
+            continue;
+        try {
+            const contents = readFileSync(path.join(root, child));
+            digests.push(digestPatch(child, contents));
+        }
+        catch (error) {
+            if (isNotFound(error))
+                continue;
+            return `パッチファイルを読めません (${path.join(root, child)}): ${describeError(error)}`;
+        }
+    }
+    return undefined;
+}
+/**
+root の node_modules へ patchesDirectory のパッチを当てる。当てるものが無ければ undefined を返して飛ばす。
+
+起動する実体は、呼び出し元が渡す patch-package の index.js を node で直に実行する。
+PATH 上の patch-package や npx の解決には依存させない。
+
+patch-package は、`--patch-dir` が `/` 始まりだと throw する。
+メッセージは `--patch-dir must be a relative path` で、dist/index.js の patchDir を調べる処理が出す。
+そのため絶対パスは渡せない。
+パッチの置き場は root の外にあり得る。
+そこで cwd を root にして、root からの相対パスを渡す。
+patch-package は、cwd から package.json を遡って appPath を決める。
+
+`--error-on-fail` を付ける。
+付けないと patch-package はローカル実行で、「当たらなかった」を警告に留めて exit 0 で終える。
+すると版上げでパッチが外れても、取得成功として通ってしまう。
+ただし `--error-on-fail` が反応するのは、errors が非空のときだけ。
+patch-dir が実体を指さなければ、patch-package は `No patch files found` を出して exit 0 で終える。
+exit code だけでは 0 件適用を成功と取り違える。
+そこで stdout の適用結果を、patches の件数と比べる。
+
+パッチファイル名の版が install された版と違っても、内容が当たれば patch-package は warning 止まりで exit 0 を返す。
+`--error-on-warn` は付けていない。
+版ずれの検出は、呼び出し元のテストが担う。
+
+同じパッチを当て直しても失敗しない。
+パッチが 1 パッケージ 1 本の構成では、patch-package は逆当ての dry-run で適用済みを判定する。
+2 回目以降は no-op で exit 0 を返す。
+
+lockPath のロックで直列化する。
+ロックは子プロセス単位で取り直すため、呼び出し元の install 段との間は覆わない。
+*/
+export async function applyPatches(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types -- AbortSignal 用
+options) {
+    if (options.patches.length === 0)
+        return undefined;
+    // 子プロセスの `process.cwd()` は、symlink を解決した実体パスを返す。
+    // patch-package はその cwd から appPath を決めて、`--patch-dir` を継ぎ足す。
+    // 論理パスのまま相対化すると、パスの途中に symlink があったときに別の場所を指す。
+    // 確認した例では、worktree の .pecot/work が base への symlink で、論理パス基準の相対が base 側の patches/ に当たった。
+    // そこで両端を実体パスへ揃えてから相対化する。
+    // 解決できないまま論理パスへ倒すと、root と patches の基準が食い違った相対パスを渡すことになる。
+    // そのため失敗として返す。
+    const resolvedRoot = realpathOrUndefined(options.root);
+    const resolvedPatches = realpathOrUndefined(options.patchesDirectory);
+    if (resolvedRoot === undefined || resolvedPatches === undefined) {
+        return startFailure(`パッチ適用の基準パスを解決できません (${resolvedRoot === undefined ? options.root : options.patchesDirectory})`);
+    }
+    const locked = withFlock(options.lockPath, options.nodeCommand ?? process.execPath, [
+        options.patchPackageEntry,
+        '--patch-dir', path.relative(resolvedRoot, resolvedPatches),
+        '--error-on-fail',
+    ]);
+    const result = await (options.runner ?? spawnPromise)(locked.command, locked.commandArguments, {
+        cwd: options.root,
+        env: process.env,
+        timeoutMs: PATCH_APPLY_TIMEOUT_MS,
+        signal: options.signal,
+    });
+    if (result.exitCode !== 0)
+        return result;
+    const shortfall = patchAppShortfall(result.stdout, options.patches.length);
+    if (shortfall === undefined)
+        return result;
+    return {
+        ...result,
+        exitCode: PATCH_INCOMPLETE_EXIT_CODE,
+        stderr: result.stderr === '' ? shortfall : `${result.stderr}\n${shortfall}`,
+    };
+}
+/**
+patch-package の stdout から、適用件数が足りない理由を返す。足りていれば undefined。
+
+適用 1 件につき、`<pkg>@<version> ✔` を 1 行出す（dist/applyPatches.js の logPatchApplication）。
+patch-dir が実体を指さないときは、`No patch files found` だけを出して exit 0 で終える。
+*/
+function patchAppShortfall(stdout, expected) {
+    if (stdout.includes('No patch files found')) {
+        return `patch-package がパッチを 1 件も見つけませんでした (期待 ${String(expected)} 件)。--patch-dir の指す先が違います。`;
+    }
+    const applied = (stdout.match(/✔/gu) ?? []).length;
+    return applied >= expected ? undefined : `patch-package の適用が ${String(applied)} 件で、期待の ${String(expected)} 件に足りません。`;
+}
+/**
+起動する前に諦めた失敗。SpawnResult は起動なしを exitCode: null で表す。
+*/
+function startFailure(reason) {
+    return {
+        // eslint-disable-next-line unicorn/no-null -- SpawnResult は起動失敗を exitCode: null で表す
+        exitCode: null,
+        // eslint-disable-next-line unicorn/no-null -- 同上
+        signal: null,
+        stdout: '',
+        stderr: reason,
+        timedOut: false,
+    };
+}
+/**
+symlink を解決した実体パス。解決できなければ undefined。
+*/
+function realpathOrUndefined(target) {
+    try {
+        return realpathSync(target);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=patch-apply.js.map

package/cli/dist/infra/_shared/plugin-root.d.ts

@@ -0,0 +1,11 @@
+/**
+プラグインルートを解決する。
+
+`CLAUDE_PLUGIN_ROOT` を直接読む。依存ルート（`PECOTV_DEPENDENCY_ROOT`）には引きずられない。
+bin/pecotv は cli を実行用ミラー（`${データ置き場}/runtime/<hash>/cli/dist/`）から起動する。
+source 相対で解決すると、同梱アセットの無いミラー側を指す。そのため wrapper が env を必ず渡す。
+単体配布形態では bin shim が自ルートを立てる。`node dist/cli.js` の直叩き（開発）に備えた
+source 相対の fallback だけを残す。
+*/
+export declare function resolvePluginRoot(): string;
+//# sourceMappingURL=plugin-root.d.ts.map

package/cli/dist/infra/_shared/plugin-root.js

@@ -0,0 +1,25 @@
+// プラグインルート（= プラグイン形態の $CLAUDE_PLUGIN_ROOT / 単体配布形態の配布ルート）の解決。
+//
+// 同梱アセット（assets/drawio-icons・assets/slidev/templates・plugin.json）の起点。
+// dependency-root.ts の「実行時依存を探すルート」とは意味が違う。
+// 依存ルート側は「PECOTV_DEPENDENCY_ROOT、無ければ CLAUDE_PLUGIN_ROOT、それも無ければ永続層」という優先順位を持つ。
+// こちらは「必ず 1 つに決まる同梱アセットの起点」なので、変数も fallback の形も別になる。
+// 混ぜると、依存をデータ置き場のミラーへ向けたときに、アセットの読み先までミラーへ動く。
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { trimmedEnvironment } from './dependency-root.js';
+/**
+プラグインルートを解決する。
+
+`CLAUDE_PLUGIN_ROOT` を直接読む。依存ルート（`PECOTV_DEPENDENCY_ROOT`）には引きずられない。
+bin/pecotv は cli を実行用ミラー（`${データ置き場}/runtime/<hash>/cli/dist/`）から起動する。
+source 相対で解決すると、同梱アセットの無いミラー側を指す。そのため wrapper が env を必ず渡す。
+単体配布形態では bin shim が自ルートを立てる。`node dist/cli.js` の直叩き（開発）に備えた
+source 相対の fallback だけを残す。
+*/
+export function resolvePluginRoot() {
+    // <plugin-root>/cli/{src,dist}/infra/_shared/plugin-root.{ts,js} から 4 階層上がプラグインルート。
+    return trimmedEnvironment('CLAUDE_PLUGIN_ROOT')
+        ?? path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../../..');
+}
+//# sourceMappingURL=plugin-root.js.map

package/cli/dist/infra/_shared/pnpm.d.ts

@@ -0,0 +1,21 @@
+/**
+packageManager を読めないときの pnpm の版。
+plugins/pecot-visual/package.json の packageManager と同じ値にし、unit test で固定する。
+*/
+export declare const FALLBACK_PNPM_VERSION = "12.15.0";
+/**
+起動する pnpm のコマンドと、その先頭の引数。
+*/
+export interface PnpmCommand {
+    readonly command: string;
+    readonly commandArguments: readonly string[];
+}
+/**
+コマンドが PATH 上にあるか。テストが差し替える。
+*/
+export type CommandProbe = (command: string) => boolean;
+/**
+pnpm の起動コマンドを返す。pnpm が無く corepack も無いときは npx で版を指す。
+*/
+export declare function resolvePnpmCommand(pluginRoot: string, isAvailable?: CommandProbe): PnpmCommand;
+//# sourceMappingURL=pnpm.d.ts.map

package/cli/dist/infra/_shared/pnpm.js

@@ -0,0 +1,49 @@
+// pnpm の起動コマンドを解く。bin/_lib.sh の resolve_pnpm と同じ順を TypeScript に写したもの。
+//
+// 順は pnpm、corepack pnpm@<版>、`npx --yes pnpm@<版>`。
+// 版は package.json の packageManager から読み、読めなければ FALLBACK_PNPM_VERSION を使う。
+// 単体配布の package.json は packageManager を持たない（npx で起動する配布物に pnpm の宣言を載せると、
+// corepack を有効にした環境で止まる）。そのため定数が要る。
+import { accessSync, constants, readFileSync } from 'node:fs';
+import path from 'node:path';
+/**
+packageManager を読めないときの pnpm の版。
+plugins/pecot-visual/package.json の packageManager と同じ値にし、unit test で固定する。
+*/
+export const FALLBACK_PNPM_VERSION = '12.15.0';
+// `[^+"]*` は `+`（ビルドメタデータ区切り）か閉じる `"` の手前までを版とする。bin/_lib.sh の pnpm_version_from_manifest と同じ。
+const PACKAGE_MANAGER_PATTERN = /"packageManager": *"pnpm@([^+"]*)/u;
+function isOnPath(command) {
+    const directories = (process.env['PATH'] ?? '').split(path.delimiter).filter(directory => directory !== '');
+    return directories.some((directory) => {
+        try {
+            accessSync(path.join(directory, command), constants.X_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    });
+}
+function pnpmVersion(pluginRoot) {
+    try {
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- 対象は plugin root の package.json
+        const text = readFileSync(path.join(pluginRoot, 'package.json'), 'utf8');
+        const version = PACKAGE_MANAGER_PATTERN.exec(text)?.[1];
+        return version === undefined || version === '' ? FALLBACK_PNPM_VERSION : version;
+    }
+    catch {
+        return FALLBACK_PNPM_VERSION;
+    }
+}
+/**
+pnpm の起動コマンドを返す。pnpm が無く corepack も無いときは npx で版を指す。
+*/
+export function resolvePnpmCommand(pluginRoot, isAvailable = isOnPath) {
+    if (isAvailable('pnpm'))
+        return { command: 'pnpm', commandArguments: [] };
+    if (isAvailable('corepack'))
+        return { command: 'corepack', commandArguments: [`pnpm@${pnpmVersion(pluginRoot)}`] };
+    return { command: 'npx', commandArguments: ['--yes', `pnpm@${pnpmVersion(pluginRoot)}`] };
+}
+//# sourceMappingURL=pnpm.js.map

package/cli/dist/infra/_shared/process.d.ts

@@ -0,0 +1,29 @@
+import type { SpawnResult } from '../../domain/_shared/spawn-result.js';
+export interface SpawnPromiseOptions {
+    readonly cwd?: string;
+    readonly env?: Readonly<NodeJS.ProcessEnv>;
+    readonly timeoutMs: number;
+    /**
+    capture と並行して親へ relay する stream (任意)。
+    */
+    readonly stdoutRelay?: NodeJS.WritableStream;
+    readonly stderrRelay?: NodeJS.WritableStream;
+    /**
+    呼び出し元がキャンセルされたら子プロセスへ SIGTERM を送る (任意)。
+  
+    MCP の tools/call は ToolCallContext.signal でキャンセルされる。
+    配線しないと、クライアントが諦めたあとも、子プロセスが孤児として動き続ける。
+    */
+    readonly signal?: AbortSignal | undefined;
+}
+/**
+`cmd args` を spawn し、stdout / stderr を全件 capture した結果を返す。
+
+- shell:false で起動するためコマンド名 / 引数は user 入力をそのまま渡せる。
+- timeout 到達時は SIGTERM を送出し、`timedOut: true` を立てる。
+- 起動 error (ENOENT 等) は reject せず、`exitCode: null` + `stderr` に詰める。
+  コマンド層が exit code 監視で一律ハンドリングできるようにする。
+*/
+export declare function spawnPromise(command: string, arguments_: readonly string[], options: SpawnPromiseOptions): Promise<SpawnResult>;
+export declare function mergeStderr(captured: string, extra: string): string;
+//# sourceMappingURL=process.d.ts.map

package/cli/dist/infra/_shared/process.js

@@ -0,0 +1,101 @@
+// 子プロセス起動の Promise wrapper。stdout / stderr を全件 capture し、
+// timeout 経過時は SIGTERM を送出する。tech-advisor B2 に従い、capture と
+// 任意の親 stream への relay を両立する。
+import { spawn } from 'node:child_process';
+/**
+`cmd args` を spawn し、stdout / stderr を全件 capture した結果を返す。
+
+- shell:false で起動するためコマンド名 / 引数は user 入力をそのまま渡せる。
+- timeout 到達時は SIGTERM を送出し、`timedOut: true` を立てる。
+- 起動 error (ENOENT 等) は reject せず、`exitCode: null` + `stderr` に詰める。
+  コマンド層が exit code 監視で一律ハンドリングできるようにする。
+*/
+export async function spawnPromise(command, arguments_, 
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types -- stream は mutable 型
+options) {
+    return new Promise((resolve) => {
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        let isTimedOut = false;
+        let isSettled = false;
+        const spawnOptions = {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            shell: false,
+        };
+        if (options.cwd !== undefined)
+            spawnOptions.cwd = options.cwd;
+        if (options.env !== undefined)
+            spawnOptions.env = { ...options.env };
+        const child = spawn(command, [...arguments_], spawnOptions);
+        const timer = setTimeout(() => {
+            isTimedOut = true;
+            child.kill('SIGTERM');
+        }, options.timeoutMs);
+        timer.unref();
+        // 呼び出し元のキャンセル。abort 済みの signal に後からリスナを足しても発火しないため、
+        // 現在値を先に見てから購読する。
+        const onAbort = () => {
+            child.kill('SIGTERM');
+        };
+        if (options.signal?.aborted === true)
+            onAbort();
+        else
+            options.signal?.addEventListener('abort', onAbort, { once: true });
+        child.stdout?.on('data', (chunk) => {
+            const buffer = Buffer.from(chunk);
+            stdoutChunks.push(buffer);
+            options.stdoutRelay?.write(buffer);
+        });
+        child.stderr?.on('data', (chunk) => {
+            const buffer = Buffer.from(chunk);
+            stderrChunks.push(buffer);
+            options.stderrRelay?.write(buffer);
+        });
+        const finalize = (exitCode, signal, extraStderr) => {
+            if (isSettled)
+                return;
+            isSettled = true;
+            clearTimeout(timer);
+            options.signal?.removeEventListener('abort', onAbort);
+            // 防御 (tech-advisor B1): ENOENT 等で 'error' が先行した直後、'close' も発火する Node 仕様がある。
+            // 二重 finalize は settled で抑止しているが、稀に child が生存したまま残るケース (timer 競合など) がある。
+            // そのため念のため kill しておく。既に exited なら kill は no-op。
+            /* c8 ignore start -- killed が false のパスは既存テストで観測されない */
+            if (!child.killed) {
+                try {
+                    child.kill();
+                }
+                catch {
+                    // 既に終了済みの場合の防御。SpawnResult には影響しないので握り潰す。
+                }
+            }
+            /* c8 ignore stop */
+            const stdout = Buffer.concat(stdoutChunks).toString('utf8');
+            const captured = Buffer.concat(stderrChunks).toString('utf8');
+            // ENOENT 等の起動 error は extraStderr 経由でのみ流入する。
+            const stderr = mergeStderr(captured, extraStderr);
+            resolve({
+                exitCode,
+                signal,
+                stdout,
+                stderr,
+                timedOut: isTimedOut,
+            });
+        };
+        child.on('error', (error) => {
+            // eslint-disable-next-line unicorn/no-null -- exitCode / signal は SpawnResult 契約で null
+            finalize(null, null, error.message);
+        });
+        child.on('close', (code, signal) => {
+            finalize(code, signal, '');
+        });
+    });
+}
+export function mergeStderr(captured, extra) {
+    if (extra === '')
+        return captured;
+    if (captured === '')
+        return extra;
+    return `${captured}\n${extra}`;
+}
+//# sourceMappingURL=process.js.map

package/cli/dist/infra/_shared/runtime-install.d.ts

@@ -0,0 +1,146 @@
+import type { SpawnResult } from '../../domain/_shared/spawn-result.js';
+/**
+本体の実行時依存の manifest を置く dir。プラグインのルートからの相対パス。
+
+単体配布の install 対象はこの dir の package.json から得る。
+*/
+export declare const RUNTIME_MANIFEST_DIRECTORY: string;
+/**
+取得の上限時間 (ms)。
+
+計測では 631MB / 455 エントリで 37 秒かかった（`.pecot/work/982/exp/persist-deps.sh`）。
+chromium 取得（計測 33 秒に対し上限 300 秒）と同じだけの余裕を取る。
+*/
+export declare const RUNTIME_INSTALL_TIMEOUT_MS = 600000;
+/**
+slidev 中核パッケージの固定版。
+
+manifest は `@slidev/cli` / `@slidev/client` を完全一致の版で宣言する。ただし、宣言が範囲に変わっても固定版で入れる。
+永続層は `--no-package-lock` で install するため、そのまま渡すと時点ごとに別の 53.x へ解決される。
+slidev の中核パッケージは、互いを完全一致の版で要求する。
+npm レジストリの `@slidev/cli@53.0.0` の dependencies で確認した。
+`@slidev/parser` / `@slidev/client` / `@slidev/types` を、いずれも `53.0.0` 固定で引く。
+そのため cli だけが上位版へ動くと、nested に別版の parser / client が入る。
+すると、pptx 差分キャッシュの slideHash を求める parser と、slidev build の parser がずれる。
+cli/package.json の slidev-parser-pin-reason と同じ理由。
+
+対処として lockfile を持たせる案もある。
+ただし lockfile は「解決結果を再現する」だけで、中核パッケージ同士の版一致は保証しない。
+初回解決が cli 52.16 / parser 52.15 なら、その食い違いを固定してしまう。
+よって中核パッケージを同一版に固定する方を採る。
+この値はプラグイン配布の構成と同じで、中核 4 本（cli / client / parser / types）とも 53.0.0 になる。
+cli/package.json の `@slidev/parser` の pin と同値であることを、unit test で固定する。
+`@slidev/theme-default` は別の版系列（0.25.x）なので対象に含めない。
+*/
+export declare const SLIDEV_CORE_VERSION = "53.0.0";
+/**
+永続層へ入れる patch-package の版。完全一致で固定する。
+
+本体の実行時依存は patch を持たない。
+patch-package を入れる理由は、テーマの置き場が使うことにある。
+使う箇所は infra/slidev-theme/store.ts の applyThemePatches の中。
+`resolveDependency('patch-package/package.json')` で解決する。
+
+永続層は `--no-package-lock` で install するため、caret のままだと時点ごとに別の 8.x へ解決される。
+slidev 中核パッケージと同じ理由で、検証した版だけを配る（Epic #152）。
+
+監査 manifest（scripts/release/runtime-manifest.mjs）は同じ規則を写して、同値比較で固定している。
+
+値は plugins/pecot-visual/package.json の devDependencies と同値にし、unit test で固定する。
+*/
+export declare const PATCH_PACKAGE_RANGE = "8.0.1";
+/**
+永続層へ書く内容。specs は npm の引数、overrides は install 先 package.json へ写す。
+*/
+export interface RuntimeInstallPlan {
+    readonly specs: readonly string[];
+    readonly overrides: Readonly<Record<string, unknown>>;
+}
+/**
+永続層へ install する内容を実行時依存の manifest から組み立てる。
+
+specs には次を入れる。
+- manifest の `dependencies`。`workspace:` 等のローカル参照は除く。
+- `devDependencies` の `dom-to-pptx`。pptx 変換の bundle 供給元になる。
+- `@slidev/parser`。
+
+slidev 中核パッケージは、range ではなく `SLIDEV_CORE_VERSION` で固定する。
+
+overrides には、manifest の `overrides` をそのまま写す。
+manifest は推移依存の版を overrides で pin している。
+install 対象を manifest から導く設計なので、解決の pin だけ落とすと、
+永続層とプラグイン配布で別の推移依存を掴む。
+
+manifest が読めないときも、取得は諦めない。
+最低限 `@slidev/parser` は返し、npm 側のエラーを呼び出し元へ見せる。
+ここで空を返すと、「install は成功したのに何も入らない」という判別しづらい状態になる。
+*/
+export declare function runtimeInstallPlan(manifestPath: string): RuntimeInstallPlan;
+/**
+永続層へ install する specifier。
+*/
+export declare function runtimeInstallSpecs(manifestPath: string): readonly string[];
+/**
+永続層の取得済み判定に使う印。install 対象（specs と overrides）の内容から導く。
+
+永続層は版を持たない固定パスなので、利用者が新版へ上げて manifest の依存が変わっても、
+「解決できる」だけでは前の版の残骸と区別できない。
+印には、pecotv の版そのものではなく install 対象の内容を使う。
+依存が変わらない版上げで、600MB の再取得を強いないため。
+*/
+export declare function runtimeInstallStamp(manifestPath: string): string;
+/**
+永続層への取得を排他するロックのパス。場所を決められなければ undefined。
+
+chromium 側（installLockPath）は依存ルートの `node_modules` に置く。
+こちらは `node_modules` を作る側なので、永続層の直下に置く（install 前に mkdir する）。
+*/
+export declare function runtimeInstallLockPath(): string | undefined;
+/**
+失敗した段。取得は npm の 1 段だけで、失敗したときの回復手順は取得先とプロキシの確認になる。
+*/
+export type RuntimeInstallStage = 'npm';
+/**
+install の結果。失敗したときだけ failedStage が入る。
+*/
+export interface RuntimeInstallResult extends SpawnResult {
+    readonly failedStage?: RuntimeInstallStage | undefined;
+}
+export interface InstallRuntimeDependenciesOptions {
+    /**
+    実行時依存の manifest（package.json）の場所。
+    */
+    readonly manifestPath: string;
+    /**
+    呼び出し元（MCP の tools/call）がキャンセルされたら取得も打ち切る。
+    */
+    readonly signal?: AbortSignal | undefined;
+    /**
+    起動するパッケージマネージャ。既定は `npm`（テストが stub を差し込む）。
+    */
+    readonly npmCommand?: string | undefined;
+}
+/**
+永続層へ実行時依存を install する。取得先は無ければここで作る（runtimeDependencyRoot は作らない）。
+
+`--prefix` を有効にするには、install 先に package.json が必要になる。
+無いと npm は上位へ遡り、HOME 直下など意図しない場所へ書き込む。
+毎回書き直すのは冪等だからで、途中終了した前回の残骸（package.json だけ欠けた状態）から復帰する意味もある。
+
+単体配布は MCP クライアントごとに別プロセスが立つ。
+そのため複数セッションからの `setup` が、同じ `node_modules` へ同時に実行され得る。
+chromium 取得と同じ flock(1) で直列化する。
+flock(1) が無い環境では、ロックなしで実行する。
+
+stamp は install が成功したときにだけ置く。
+先に消しておくのは、途中で失敗した install の残骸を「取得済み」と誤判定させないため。
+
+npm 自体は、npx 経由の起動なら必ず同居する。
+解決できない環境では spawnPromise が `exitCode: null` を返し、呼び出し元が理由付きの失敗として扱う。
+
+env は利用者環境のものを引き継ぐ。
+取得先と proxy の指定は利用者側の変数で行われるため、絞り込まない。
+プロキシの CA は利用者が `NODE_EXTRA_CA_CERTS` で渡す。
+*/
+export declare function installRuntimeDependencies(options: Readonly<InstallRuntimeDependenciesOptions>): Promise<RuntimeInstallResult>;
+//# sourceMappingURL=runtime-install.d.ts.map