@superzerodev/core 0.1.0

package/dist/executor.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Executor（P0設計 §5.2）
+ *
+ * Change を依存順に実行する。
+ *
+ * ★ PE-3（部分失敗からの復帰）が最重要:
+ *   1件ごとに StateStore へコミットしてから次へ進む。全体をトランザクションで囲まない。
+ *   3件目で落ちても、1〜2件目の結果は残る。再実行すれば 3件目から続く。
+ *   これが「apply を何度でも叩ける」というエージェント前提の運用を成立させる。
+ */
+import { SuperzeroError } from './errors.js';
+import type { Logger, SecretResolver } from './adapter.js';
+import type { AdapterRegistry } from './registry.js';
+import type { Change, Plan, ResourceKind, ResourceRecord } from './types.js';
+/**
+ * Control Plane DB への永続化境界。
+ * core は SQL を知らない。実装は apps/control-plane 側が持つ。
+ */
+export interface StateStore {
+    /** UNIQUE (environment_id, kind, logical_name) で upsert する（PE-1 の担保） */
+    upsert(record: Omit<ResourceRecord, 'id'> & {
+        id?: string;
+    }): Promise<ResourceRecord>;
+    /** update / destroy が必要とする既存 state。未作成なら null */
+    load(environmentId: string, kind: ResourceKind, logicalName: string): Promise<ResourceRecord | null>;
+    /** plan が必要とする actual state の全件。Planner への入力になる */
+    list(environmentId: string): Promise<ResourceRecord[]>;
+    remove(environmentId: string, kind: ResourceKind, logicalName: string): Promise<void>;
+    /** deployments / changes テーブルへの記録。監査と再開に使う */
+    recordChange(deploymentId: string, change: Change, status: 'ok' | 'failed', error?: unknown): Promise<void>;
+}
+export interface ExecuteDeps {
+    registry: AdapterRegistry;
+    store: StateStore;
+    deploymentId: string;
+    environmentId: string;
+    projectName: string;
+    region: string;
+    secrets: SecretResolver;
+    logger: Logger;
+    /** このデプロイのソースが置かれたローカルディレクトリ（ビルドに要る） */
+    workspaceDir?: string;
+    /** デプロイ対象ソースの内容ハッシュ。plan と同じ値を渡すこと */
+    sourceHash?: string | undefined;
+    signal?: AbortSignal;
+}
+export interface ExecuteResult {
+    applied: Change[];
+    skipped: Change[];
+    failure?: {
+        change: Change;
+        error: ReturnType<SuperzeroError['toJSON']>;
+    };
+    /** resourceKey → 環境変数として注入できる接続情報 */
+    outputs: Record<string, Record<string, string>>;
+}
+export declare function execute(plan: Plan, deps: ExecuteDeps): Promise<ExecuteResult>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAiC,MAAM,aAAa,CAAA;AAC3E,OAAO,KAAK,EAAkB,MAAM,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE5E;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,wEAAwE;IACxE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IACrF,iDAAiD;IACjD,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IACpG,mDAAmD;IACnD,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;IACtD,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrF,8CAA8C;IAC9C,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,QAAQ,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5G;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,eAAe,CAAA;IACzB,KAAK,EAAE,UAAU,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,cAAc,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAA;KAAE,CAAA;IACzE,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAChD;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAoFnF"}

package/dist/executor.js

@@ -0,0 +1,157 @@
+/**
+ * Executor（P0設計 §5.2）
+ *
+ * Change を依存順に実行する。
+ *
+ * ★ PE-3（部分失敗からの復帰）が最重要:
+ *   1件ごとに StateStore へコミットしてから次へ進む。全体をトランザクションで囲まない。
+ *   3件目で落ちても、1〜2件目の結果は残る。再実行すれば 3件目から続く。
+ *   これが「apply を何度でも叩ける」というエージェント前提の運用を成立させる。
+ */
+import { SuperzeroError, isSuperzeroError, wrapUnknown } from './errors.js';
+export async function execute(plan, deps) {
+    const { registry, store, logger } = deps;
+    const outputs = {};
+    const applied = [];
+    const remaining = [...plan.changes];
+    while (remaining.length > 0) {
+        const change = remaining.shift();
+        if (!change)
+            break;
+        if (change.action === 'noop') {
+            /**
+             * ★ noop でも outputs は組み立てる。
+             *
+             *   ここを飛ばすと、依存側（compute）が DATABASE_URL を受け取れないまま起動する。
+             *   しかもエラーにならないので、アプリが「DB に繋がらない」状態で
+             *   正常にデプロイされたように見える。
+             *
+             *   これは例外的な経路ではなく、最も普通の経路で起きる:
+             *     - 部分失敗のあとの再実行（DB は作成済み → noop）
+             *     - アプリのコードだけ変えた再デプロイ（DB は変更なし → noop）
+             *   つまり2回目以降の apply でほぼ必ず踏む。
+             */
+            const current = await store.load(deps.environmentId, change.kind, change.logicalName);
+            if (current) {
+                outputs[change.key] = registry.get(change.kind).outputs(current.state);
+            }
+            applied.push(change);
+            continue;
+        }
+        const ctx = buildContext(deps, change, outputs);
+        const adapter = registry.get(change.kind);
+        try {
+            deps.signal?.throwIfAborted();
+            if (change.action === 'destroy') {
+                const current = await requireState(store, deps.environmentId, change);
+                await adapter.destroy(current.state, ctx);
+                await store.remove(deps.environmentId, change.kind, change.logicalName);
+            }
+            else {
+                const nextState = change.action === 'create'
+                    ? await adapter.create(change.spec, ctx)
+                    : await adapter.update(change.spec, (await requireState(store, deps.environmentId, change)).state, ctx);
+                await store.upsert({
+                    environmentId: deps.environmentId,
+                    kind: change.kind,
+                    logicalName: change.logicalName,
+                    provider: change.provider,
+                    // ★ アダプタに聞く。Control Plane はプロバイダごとの state の形を知らない
+                    externalId: adapter.externalId(nextState),
+                    state: nextState,
+                    status: 'ready',
+                });
+                outputs[change.key] = adapter.outputs(nextState);
+            }
+            await store.recordChange(deps.deploymentId, change, 'ok');
+            applied.push(change);
+            logger.info(`applied ${change.action} ${change.key}`);
+        }
+        catch (raw) {
+            const error = isSuperzeroError(raw) ? raw : wrapUnknown(change.provider, raw);
+            await store.recordChange(deps.deploymentId, change, 'failed', error.toJSON());
+            logger.error(`failed ${change.action} ${change.key}`, { code: error.code });
+            // ここで止める。既に適用済みの分は永続化されているので、再実行で続きから進む。
+            return {
+                applied,
+                skipped: remaining,
+                failure: { change, error: error.toJSON() },
+                outputs,
+            };
+        }
+    }
+    return { applied, skipped: [], outputs };
+}
+function buildContext(deps, change, outputs) {
+    const ctx = {
+        environmentId: deps.environmentId,
+        sourceHash: deps.sourceHash,
+        projectName: deps.projectName,
+        region: deps.region,
+        secrets: deps.secrets,
+        logger: deps.logger,
+        outputsOf(key) {
+            // dependsOn に宣言していない参照は事故のもとなので明示的に弾く
+            if (!change.dependsOn.includes(key)) {
+                throw new SuperzeroError({
+                    code: 'PLAN_MISSING_DEPENDENCY',
+                    message: `Adapter for "${change.key}" requested outputs of "${key}", ` +
+                        `but "${key}" is not declared in its dependsOn.`,
+                    suggestedFix: {
+                        description: `This is an adapter bug, not a configuration problem. ` +
+                            `Add "${key}" to the dependsOn of the change emitted by the "${change.provider}" adapter.`,
+                    },
+                });
+            }
+            /**
+             * ★ 無いときに {} を返さない。
+             *
+             *   空を返すと、接続情報が入らないまま起動して「動いているが繋がらない」
+             *   デプロイができあがる。エラーで止まるほうが必ず良い。
+             *   宣言はしたのに解決できていない＝こちらの実装の不具合なので、そう書く。
+             *
+             *   なお outputs が空の Record であること自体は正常（接続情報を配らない
+             *   リソースもある）。区別できるよう、キーの有無で判定している。
+             */
+            const resolved = outputs[key];
+            if (resolved === undefined) {
+                throw new SuperzeroError({
+                    code: 'APPLY_DEPENDENCY_OUTPUTS_MISSING',
+                    message: `"${change.key}" depends on "${key}", but no outputs were resolved for it. ` +
+                        `The dependency was neither applied nor loaded during this run.`,
+                    suggestedFix: {
+                        description: `This is a bug in Superzero, not in your configuration. ` +
+                            `Re-running apply is unlikely to help. Please report it with the resource keys above.`,
+                        command: 'superzero status',
+                    },
+                });
+            }
+            return resolved;
+        },
+    };
+    if (deps.workspaceDir)
+        ctx.workspaceDir = deps.workspaceDir;
+    if (deps.signal)
+        ctx.signal = deps.signal;
+    return ctx;
+}
+/**
+ * update / destroy は既存 state を必要とする。
+ * plan 時点では在ったが apply 時に消えている＝drift。明示的なエラーで止める。
+ */
+async function requireState(store, environmentId, change) {
+    const record = await store.load(environmentId, change.kind, change.logicalName);
+    if (!record) {
+        throw new SuperzeroError({
+            code: 'APPLY_CHANGE_FAILED',
+            message: `Cannot ${change.action} "${change.key}": it no longer exists in the state store. ` +
+                `It may have been removed outside of Superzero since the plan was created.`,
+            suggestedFix: {
+                description: 'Re-run plan to refresh the actual state, then apply again.',
+                command: 'superzero plan',
+            },
+        });
+    }
+    return record;
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

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

package/dist/graph.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 依存順の解決（PE-2）
+ *
+ * DB を作ってから接続情報を Compute の env に注入する、という順序を守るために、
+ * Change の dependsOn をトポロジカルソートする。
+ */
+import type { Change } from './types.js';
+/**
+ * Kahn のアルゴリズム。
+ * 未宣言の依存があれば missingDependency、閉路があれば circularDependency を throw する。
+ * 同順位の Change は key の辞書順で安定させる（plan 出力の再現性のため）。
+ */
+export declare function topoSort(changes: Change[]): Change[];
+/**
+ * destroy は依存の逆順で実行する。
+ * 参照されている側を先に消すと、参照している側の後始末ができなくなるため。
+ */
+export declare function orderForDestroy(changes: Change[]): Change[];
+//# sourceMappingURL=graph.d.ts.map

package/dist/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAmDpD;AAsBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAE3D"}

package/dist/graph.js

@@ -0,0 +1,92 @@
+/**
+ * 依存順の解決（PE-2）
+ *
+ * DB を作ってから接続情報を Compute の env に注入する、という順序を守るために、
+ * Change の dependsOn をトポロジカルソートする。
+ */
+import { circularDependency, missingDependency } from './errors.js';
+/**
+ * Kahn のアルゴリズム。
+ * 未宣言の依存があれば missingDependency、閉路があれば circularDependency を throw する。
+ * 同順位の Change は key の辞書順で安定させる（plan 出力の再現性のため）。
+ */
+export function topoSort(changes) {
+    const byKey = new Map();
+    for (const c of changes)
+        byKey.set(c.key, c);
+    const indegree = new Map();
+    const dependents = new Map();
+    for (const c of changes) {
+        indegree.set(c.key, c.dependsOn.length);
+        for (const dep of c.dependsOn) {
+            if (!byKey.has(dep))
+                throw missingDependency(c.key, dep);
+            const list = dependents.get(dep);
+            if (list)
+                list.push(c.key);
+            else
+                dependents.set(dep, [c.key]);
+        }
+    }
+    // 依存を持たないものから始める
+    const ready = [];
+    for (const [key, deg] of indegree) {
+        if (deg === 0)
+            ready.push(key);
+    }
+    ready.sort();
+    const sorted = [];
+    while (ready.length > 0) {
+        const key = ready.shift();
+        if (key === undefined)
+            break;
+        const change = byKey.get(key);
+        if (change)
+            sorted.push(change);
+        const next = dependents.get(key) ?? [];
+        const unlocked = [];
+        for (const d of next) {
+            const deg = (indegree.get(d) ?? 0) - 1;
+            indegree.set(d, deg);
+            if (deg === 0)
+                unlocked.push(d);
+        }
+        if (unlocked.length > 0) {
+            unlocked.sort();
+            ready.push(...unlocked);
+            ready.sort();
+        }
+    }
+    if (sorted.length !== changes.length) {
+        const remaining = changes.filter((c) => !sorted.includes(c)).map((c) => c.key);
+        throw circularDependency(findCycle(remaining, byKey));
+    }
+    return sorted;
+}
+/** エラーメッセージに載せる閉路を1つ見つける */
+function findCycle(candidates, byKey) {
+    const inCycle = new Set(candidates);
+    const start = candidates[0];
+    if (start === undefined)
+        return candidates;
+    const path = [];
+    const seen = new Set();
+    let current = start;
+    while (current !== undefined && !seen.has(current)) {
+        seen.add(current);
+        path.push(current);
+        const change = byKey.get(current);
+        current = change?.dependsOn.find((d) => inCycle.has(d));
+    }
+    if (current !== undefined)
+        path.push(current);
+    return path;
+}
+/**
+ * destroy は依存の逆順で実行する。
+ * 参照されている側を先に消すと、参照している側の後始末ができなくなるため。
+ */
+export function orderForDestroy(changes) {
+    return topoSort(changes).reverse();
+}
+//# sourceMappingURL=graph.js.map

package/dist/graph.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from './types.js';
+export * from './errors.js';
+export * from './source-archive.js';
+export * from './adapter.js';
+export * from './registry.js';
+export * from './graph.js';
+export * from './planner.js';
+export * from './executor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from './types.js';
+export * from './errors.js';
+export * from './source-archive.js';
+export * from './adapter.js';
+export * from './registry.js';
+export * from './graph.js';
+export * from './planner.js';
+export * from './executor.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA"}

package/dist/planner.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Planner（P0設計 §5.2）
+ *
+ * desired（宣言ファイル）と actual（Control Plane DB）の差分から Change[] を組み立てる。
+ * 副作用は一切持たない（PE-6）。`superzero plan` はこれを呼ぶだけ。
+ */
+import type { AdapterRegistry } from './registry.js';
+import { type Change, type Plan, type ResourceKind, type ResourceRecord } from './types.js';
+/** 宣言ファイルから切り出した1リソース */
+export interface DesiredResource<TSpec = unknown> {
+    kind: ResourceKind;
+    logicalName: string;
+    spec: TSpec;
+}
+export interface PlanOptions {
+    /** false のとき、destructive な Change が1件でもあれば throw する（PE-4） */
+    allowDestructive?: boolean;
+    /** デプロイ対象ソースの内容ハッシュ。アダプタの plan へそのまま渡す */
+    sourceHash?: string | undefined;
+}
+export declare function createPlan(registry: AdapterRegistry, desired: DesiredResource[], actual: ResourceRecord[], options?: PlanOptions): Plan;
+/** plan 出力の1行表現。CLI と MCP の両方がこれを使う */
+export declare function formatChange(change: Change): string;
+//# sourceMappingURL=planner.d.ts.map

package/dist/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../src/planner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAEL,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAA;AAEnB,yBAAyB;AACzB,MAAM,WAAW,eAAe,CAAC,KAAK,GAAG,OAAO;IAC9C,IAAI,EAAE,YAAY,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,KAAK,CAAA;CACZ;AAED,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAChC;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,eAAe,EAAE,EAC1B,MAAM,EAAE,cAAc,EAAE,EACxB,OAAO,GAAE,WAAgB,GACxB,IAAI,CAyCN;AAED,uCAAuC;AACvC,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWnD"}

package/dist/planner.js

@@ -0,0 +1,56 @@
+/**
+ * Planner（P0設計 §5.2）
+ *
+ * desired（宣言ファイル）と actual（Control Plane DB）の差分から Change[] を組み立てる。
+ * 副作用は一切持たない（PE-6）。`superzero plan` はこれを呼ぶだけ。
+ */
+import { destructiveChangeBlocked } from './errors.js';
+import { topoSort } from './graph.js';
+import { resourceKey, } from './types.js';
+export function createPlan(registry, desired, actual, options = {}) {
+    const desiredByKey = new Map();
+    for (const d of desired) {
+        desiredByKey.set(resourceKey(d.kind, d.logicalName), d);
+    }
+    const actualByKey = new Map();
+    for (const a of actual) {
+        actualByKey.set(resourceKey(a.kind, a.logicalName), a);
+    }
+    // 両側の和集合を取る。片側にしかないものが create / destroy になる。
+    const allKeys = new Set([...desiredByKey.keys(), ...actualByKey.keys()]);
+    const changes = [];
+    for (const key of [...allKeys].sort()) {
+        const d = desiredByKey.get(key);
+        const a = actualByKey.get(key);
+        // kind と logicalName は必ずどちらかから取れる
+        const kind = (d?.kind ?? a?.kind);
+        const logicalName = d?.logicalName ?? a?.logicalName ?? '';
+        const adapter = registry.get(kind);
+        const produced = adapter.plan({
+            logicalName,
+            desired: (d?.spec ?? null),
+            actual: (a ?? null),
+            sourceHash: options.sourceHash,
+        });
+        changes.push(...produced);
+    }
+    const ordered = topoSort(changes);
+    const destructiveKeys = ordered.filter((c) => c.destructive).map((c) => c.key);
+    if (destructiveKeys.length > 0 && options.allowDestructive !== true) {
+        throw destructiveChangeBlocked(destructiveKeys);
+    }
+    return { changes: ordered, ordered: true, destructiveKeys };
+}
+/** plan 出力の1行表現。CLI と MCP の両方がこれを使う */
+export function formatChange(change) {
+    const sign = change.action === 'create'
+        ? '+'
+        : change.action === 'destroy'
+            ? '-'
+            : change.action === 'update'
+                ? '~'
+                : ' ';
+    const flag = change.destructive ? ' [destructive]' : '';
+    return `${sign} ${change.key} (${change.provider}) — ${change.summary}${flag}`;
+}
+//# sourceMappingURL=planner.js.map

package/dist/planner.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,18 @@
+/**
+ * アダプタ登録簿
+ *
+ * kind ごとに1つのアダプタを選ぶ。差し替えはここ1箇所で完結する。
+ *   P0: compute → docker,      database → neon
+ *   P1: compute → firecracker, database → superzero-postgres
+ */
+import type { ProviderAdapter } from './adapter.js';
+import type { ResourceKind } from './types.js';
+export declare class AdapterRegistry {
+    #private;
+    register<TSpec, TState>(adapter: ProviderAdapter<TSpec, TState>): this;
+    /** 見つからない場合は suggestedFix つきで throw する */
+    get(kind: ResourceKind): ProviderAdapter<never, never>;
+    has(kind: ResourceKind): boolean;
+    kinds(): ResourceKind[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,qBAAa,eAAe;;IAG1B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,IAAI;IAKtE,0CAA0C;IAC1C,GAAG,CAAC,IAAI,EAAE,YAAY,GAAG,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC;IAiBtD,GAAG,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO;IAIhC,KAAK,IAAI,YAAY,EAAE;CAGxB"}

package/dist/registry.js

@@ -0,0 +1,38 @@
+/**
+ * アダプタ登録簿
+ *
+ * kind ごとに1つのアダプタを選ぶ。差し替えはここ1箇所で完結する。
+ *   P0: compute → docker,      database → neon
+ *   P1: compute → firecracker, database → superzero-postgres
+ */
+import { SuperzeroError, ErrorCode } from './errors.js';
+export class AdapterRegistry {
+    #byKind = new Map();
+    register(adapter) {
+        this.#byKind.set(adapter.kind, adapter);
+        return this;
+    }
+    /** 見つからない場合は suggestedFix つきで throw する */
+    get(kind) {
+        const adapter = this.#byKind.get(kind);
+        if (!adapter) {
+            throw new SuperzeroError({
+                code: ErrorCode.CONFIG_UNKNOWN_PROVIDER,
+                message: `No provider adapter is registered for resource kind "${kind}".`,
+                suggestedFix: {
+                    description: `Remove the "${kind}" block from superzero.config.ts, ` +
+                        `or upgrade the CLI if this resource kind was added in a newer version.`,
+                    command: 'npm install -g @superzerodev/cli@latest',
+                },
+            });
+        }
+        return adapter;
+    }
+    has(kind) {
+        return this.#byKind.has(kind);
+    }
+    kinds() {
+        return [...this.#byKind.keys()];
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAIvD,MAAM,OAAO,eAAe;IACjB,OAAO,GAAG,IAAI,GAAG,EAA+C,CAAA;IAEzE,QAAQ,CAAgB,OAAuC;QAC7D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAmD,CAAC,CAAA;QACnF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,0CAA0C;IAC1C,GAAG,CAAC,IAAkB;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACtC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,cAAc,CAAC;gBACvB,IAAI,EAAE,SAAS,CAAC,uBAAuB;gBACvC,OAAO,EAAE,wDAAwD,IAAI,IAAI;gBACzE,YAAY,EAAE;oBACZ,WAAW,EACT,eAAe,IAAI,oCAAoC;wBACvD,wEAAwE;oBAC1E,OAAO,EAAE,yCAAyC;iBACnD;aACF,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,GAAG,CAAC,IAAkB;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC;IAED,KAAK;QACH,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;IACjC,CAAC;CACF"}

package/dist/source-archive.d.ts

@@ -0,0 +1,85 @@
+/**
+ * デプロイするソースの受け渡し（CLI → Control Plane）
+ *
+ * ★ ここが無いと、遠隔の顧客は誰もアプリを載せられない。
+ *
+ *   以前は CLI が「宣言ファイルのあるディレクトリの絶対パス」を文字列で送り、
+ *   Control Plane がそれを *自分の* ファイルシステムのパスとして開いていた。
+ *   CLI とサーバーが同じホストに居るときだけ通る作りで、顧客の Mac から
+ *   api.superzero.dev を叩くと `ENOENT ... scandir '/Users/...'` で落ちていた。
+ *   受け入れ確認が通っていたのは、CLI をサーバー上で走らせていたため。
+ *
+ *   加えて、そのパスは無検証でサーバーの fs に渡っていた。認証済みの顧客が
+ *   `/etc/superzero` を指定すれば、基盤の秘密が自分のコンテナイメージに入った。
+ *   ソースを送る形にすると、この穴は構造的に消える（パスを受け取らなくなる）。
+ *
+ * ★ 外部依存を足さない。tar は自分で書く。
+ *   顧客の手元で走るコードなので、依存が増えるほど「入らない」が増える。
+ *   形式は ustar（長い名前は GNU の 'L' エントリ）なので、
+ *   `tar -tzf` でそのまま中身を確認できる。デバッグ手段を捨てない。
+ *
+ * ★ macOS の tar を呼ばない。
+ *   呼ぶと拡張属性が `._<name>` という別ファイルとして混ざり、Linux 側の
+ *   Nixpacks が "stream did not contain valid UTF-8" で落ちる
+ *   （docs/05-development.md の「macOS の tar が AppleDouble を混ぜる」）。
+ *   自分で書けば構造的に混ざらない。既にディスク上にある `._*` は明示的に外す。
+ */
+/**
+ * ビルドに関係しないので送らない。ソースの指紋（fingerprintOf）の
+ * 除外リストと同じ集合であること。ここがずれると、送っていないファイルを
+ * サーバーが数えようとして指紋が食い違う。
+ */
+export declare const DEFAULT_IGNORED_ENTRIES: ReadonlySet<string>;
+/**
+ * 名前だけで落とせるものを落とす。
+ *
+ * ★ `._*`（AppleDouble）は集合ではなく前置きで判定する。
+ *   名前が実行時に決まるので Set には入れられない。
+ */
+export declare function isIgnoredEntryName(name: string): boolean;
+export interface SourceLimits {
+    /** 送れるファイル数の上限 */
+    maxFiles: number;
+    /** 展開後の合計バイト数の上限。圧縮後ではなく展開後で数える（zip bomb 対策） */
+    maxBytes: number;
+}
+/**
+ * 上限。node_modules を外したアプリのソースとしては十分に広い。
+ * 超えるのはたいてい「送るべきでないもの」が混ざっている合図なので、
+ * 黙って通さずエラーにして気づかせる。
+ */
+export declare const DEFAULT_SOURCE_LIMITS: SourceLimits;
+export interface PackedSource {
+    /** gzip 済みの tar */
+    archive: Uint8Array;
+    fileCount: number;
+    /** 展開後の合計バイト数 */
+    bytes: number;
+    /** ファイルの選び方。利用者に「何を送ったか」を説明するために返す */
+    selection: 'git' | 'walk';
+}
+export interface PackOptions {
+    limits?: SourceLimits;
+    /** git の呼び出しを諦めるまでの時間。既定 10 秒 */
+    gitTimeoutMs?: number;
+    /** テスト用に git を使わせない */
+    useGit?: boolean;
+}
+export declare function packSource(rootDir: string, options?: PackOptions): Promise<PackedSource>;
+export interface UnpackedSource {
+    fileCount: number;
+    bytes: number;
+}
+/**
+ * アーカイブを destDir に展開する。
+ *
+ * ★ 中身は顧客が作ったもの。信用しない。
+ *   絶対パス・`..`・シンボリックリンク・デバイスファイルは全て拒否する。
+ *   通したら、顧客が Control Plane のホストの任意の場所に書けることになる。
+ *
+ * ★ 上限は「宣言されたサイズ」ではなく「実際に展開したバイト数」で数える。
+ *   ヘッダの数字を信じると、小さいと宣言した巨大なアーカイブを通してしまう。
+ */
+export declare function unpackSource(archive: Uint8Array, destDir: string, limits?: SourceLimits): Promise<UnpackedSource>;
+export declare function formatBytes(bytes: number): string;
+//# sourceMappingURL=source-archive.d.ts.map

package/dist/source-archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-archive.d.ts","sourceRoot":"","sources":["../src/source-archive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AASH;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAWtD,CAAA;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,MAAM,WAAW,YAAY;IAC3B,kBAAkB;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAGnC,CAAA;AAED,MAAM,WAAW,YAAY;IAC3B,mBAAmB;IACnB,OAAO,EAAE,UAAU,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,sCAAsC;IACtC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,uBAAuB;IACvB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AA0HD,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAqClG;AA0DD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,YAAoC,GAC3C,OAAO,CAAC,cAAc,CAAC,CAsEzB;AAqED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD"}