behavior-contracts 0.1.3 → 0.2.0

package/dist/generator/core.d.ts

@@ -0,0 +1,89 @@
+import type { ComponentGraphIR } from "../behavior.js";
+export type GeneratorFailureCode = "INPUT_NOT_PORTABLE_IR" | "UNSUPPORTED_IR_VERSION" | "UNSUPPORTED_EXPR_VERSION" | "EMPTY_IR" | "DUPLICATE_COMPONENT" | "UNKNOWN_LANGUAGE";
+export declare class GeneratorFailure extends Error {
+    code: GeneratorFailureCode;
+    constructor(code: GeneratorFailureCode, message: string);
+}
+/** 生成時に emitter へ渡される言語中立コンテキスト（検証済み）。 */
+export interface EmitContext {
+    /** 検証済み可搬 IR（構造は入力のまま — キー順保存）。 */
+    ir: ComponentGraphIR;
+    /** source IR の fingerprint（`"fnv1a64:<16hex>"`）。 */
+    fingerprint: string;
+    /** 生成時 SPEC_VERSIONS のうち実行経路が依存する版（焼き込み対象）。 */
+    specVersions: {
+        behavior: number;
+        expression: number;
+        plan: number;
+    };
+    /** IR 内の component 名（宣言順）。 */
+    componentNames: string[];
+    /** runtime-core を import するモジュール指定子（emitter の既定を上書き可）。 */
+    runtimeImport: string;
+}
+/** 言語 emitter プラグイン。DSL 非依存の EmitContext からモジュール全文を emit する。 */
+export interface EmitterPlugin {
+    /** 言語識別子（`generateModule` の `language`）。 */
+    language: string;
+    /** 生成ファイルの拡張子（`.ts` / `.py` …）。 */
+    fileExtension: string;
+    /** runtime-core の既定 import 指定子（`"behavior-contracts"` / `"behavior_contracts"`）。 */
+    defaultRuntimeImport: string;
+    /**
+     * 推奨ファイル名の上書き（省略時は `behaviors.generated` + fileExtension）。
+     * Rust のように `.` 区切りがモジュール名として使えない言語が指定する。
+     */
+    filenameHint?: string;
+    /** モジュール全文を emit（決定的であること）。 */
+    emit(ctx: EmitContext): string;
+}
+/**
+ * registerEmitter — 言語 emitter を登録する（consumer / 後続 SP の言語追加 seam）。
+ * 同名言語の再登録は上書き（テスト・差し替え用）。
+ */
+export declare function registerEmitter(plugin: EmitterPlugin): void;
+/** 登録済み言語の一覧（宣言順不定 — 表示用途はソートして使う）。 */
+export declare function registeredLanguages(): string[];
+export interface GenerateOptions {
+    /** 生成先言語（登録済み emitter の識別子。SP1: "typescript" | "python"）。 */
+    language: string;
+    /**
+     * runtime-core を import するモジュール指定子。省略時は emitter の既定
+     * （npm/PyPI パッケージ名）。テスト・vendored 配置ではソースへの相対パス等を渡す。
+     * 生成コードの決定性は指定子込み（同一 IR + 同一オプション → byte-identical）。
+     */
+    runtimeImport?: string;
+}
+export interface GeneratedModule {
+    /** 生成言語。 */
+    language: string;
+    /** モジュール全文（実行可能なソースコード）。 */
+    code: string;
+    /** source IR の fingerprint（生成コードにも定数として焼き込み済み）。 */
+    fingerprint: string;
+    /** 焼き込んだ spec versions。 */
+    specVersions: {
+        behavior: number;
+        expression: number;
+        plan: number;
+    };
+    /** bind で公開される component 名（IR 宣言順）。 */
+    componentNames: string[];
+    /** 推奨ファイル名（`behaviors.generated` + 言語拡張子）。 */
+    filenameHint: string;
+}
+/**
+ * generateModule — 可搬 component-graph IR から言語ネイティブの実行モジュールを生成する。
+ *
+ * 生成物の形（全言語共通の契約）:
+ *   - IR がネイティブリテラル定数として埋め込まれる（実行時 JSON パースなし）。
+ *   - `EXPECTED_SPEC_VERSIONS` / `IR_FINGERPRINT` 定数 + ロード時 fail-closed 検査。
+ *   - `bind(handlers)`（TS はさらに `bindAsync`）: handler 注入を受けて
+ *     `{component名: (input) => runBehavior(IR, handlers, input, name)}` を返す薄い束ね。
+ *     **handler は常に境界注入**であり、生成対象にならない（C4）。
+ *
+ * @throws {GeneratorFailure} 入力が可搬 IR でない / 版超過 / 未知言語（fail-closed）。
+ * @throws {PortabilityError} IR が Portability Guard に違反するとき。
+ */
+export declare function generateModule(ir: unknown, options: GenerateOptions): GeneratedModule;
+//# sourceMappingURL=core.d.ts.map

package/dist/generator/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/generator/core.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,MAAM,MAAM,oBAAoB,GAC5B,uBAAuB,GACvB,wBAAwB,GACxB,0BAA0B,GAC1B,UAAU,GACV,qBAAqB,GACrB,kBAAkB,CAAC;AAEvB,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,IAAI,EAAE,oBAAoB,CAAC;gBACf,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM;CAKxD;AAOD,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,EAAE,EAAE,gBAAgB,CAAC;IACrB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,YAAY,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,8BAA8B;IAC9B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,oBAAoB,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAAC;CAChC;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAE3D;AAED,uCAAuC;AACvC,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AA8CD,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,YAAY,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,uCAAuC;IACvC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,eAAe,CA+BrF"}

package/dist/generator/core.js

@@ -0,0 +1,124 @@
+/**
+ * core.ts — SCP Runtime Code Generation Layer: 共通 Generator 本体（bc#13 SP1）。
+ *
+ * docs/scp-ir-architecture.md §7.2–§7.4 の規範実装:
+ *   - **入力は可搬 IR のみ**（§5 の component-graph ドキュメント。ソース/内部 IR は拒否 —
+ *     concept.md §5.6 Generator Interface）。生成時に envelope（irVersion / exprVersion）と
+ *     assertPortableComponentGraph を fail-closed で検査する。
+ *   - **DSL 非依存**: components[] / Expression IR / plan という DSL 不変部（§7.4）だけを
+ *     消費する。DSL 固有部（catalog 実装・handler）は生成コードに載らず、実行時に
+ *     `IR + {effects,config,hooks}` 境界で注入される（concept.md §4.4）。
+ *   - **実行ロジックを再実装しない**: 生成コードは事前構築済みネイティブリテラルを既存の
+ *     runtime-core API（runBehavior / runBehaviorAsync / run_behavior）へ渡す薄い束ね
+ *     （runtime≈0 追加。graphddb #208 の AOT パターンの一般化）。
+ *   - **決定的**: 同一 IR ドキュメント → byte-identical な生成コード（タイムスタンプ・
+ *     絶対パス等の非決定要素を埋め込まない）。
+ *   - **spec-version / fingerprint 焼き込み**: 生成時の SPEC_VERSIONS（behavior /
+ *     expression / plan）と source IR の fingerprint を定数として焼き込み、生成モジュールは
+ *     ロード時に runtime の定数と照合して skew を LOUD reject する（#208 の
+ *     prepared-artifact 規律）。
+ *
+ * 経路の恒久併存（§7.2）: この codegen 経路（エンドポイント 3）は動的 JSON 経路
+ * （エンドポイント 2）を置き換えない。両経路は同一 IR に対して観測等価であることが
+ * conformance ゲート（§7.3 — ts/test/codegen-conformance.test.ts）で強制される。
+ */
+import { SPEC_VERSIONS } from "../index.js";
+import { assertPortableComponentGraph } from "../guard.js";
+import { fingerprintComponentGraph } from "./fingerprint.js";
+export class GeneratorFailure extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "GeneratorFailure";
+    }
+}
+function gfail(code, message) {
+    throw new GeneratorFailure(code, message);
+}
+const registry = new Map();
+/**
+ * registerEmitter — 言語 emitter を登録する（consumer / 後続 SP の言語追加 seam）。
+ * 同名言語の再登録は上書き（テスト・差し替え用）。
+ */
+export function registerEmitter(plugin) {
+    registry.set(plugin.language, plugin);
+}
+/** 登録済み言語の一覧（宣言順不定 — 表示用途はソートして使う）。 */
+export function registeredLanguages() {
+    return [...registry.keys()].sort();
+}
+// ── 入力検証（生成時 fail-closed）────────────────────────────────────────────
+/**
+ * 可搬 IR envelope 検査 + Portability Guard。**可搬 component-graph IR 以外は LOUD reject**
+ * （graphddb operations.json のような consumer bundle・内部 IR・任意 JSON を黙って
+ * 受け付けない）。
+ */
+function validateGeneratorInput(ir) {
+    if (ir === null || typeof ir !== "object" || Array.isArray(ir))
+        gfail("INPUT_NOT_PORTABLE_IR", "generator input must be a portable component-graph IR document ({irVersion, exprVersion, components[]} — scp-ir-architecture.md §5); got a non-object (fail-closed)");
+    const doc = ir;
+    if (doc.irVersion === undefined || doc.components === undefined)
+        gfail("INPUT_NOT_PORTABLE_IR", "generator input must be a portable component-graph IR document ({irVersion, exprVersion, components[]}); the codegen path consumes portable IR ONLY — never source/internal IR or consumer bundles (fail-closed)");
+    if (doc.irVersion !== 1)
+        gfail("UNSUPPORTED_IR_VERSION", `irVersion ${String(doc.irVersion)} is not supported (supported: 1) (fail-closed)`);
+    const exprVersion = doc.exprVersion;
+    if (typeof exprVersion !== "number" || !Number.isInteger(exprVersion) || exprVersion < 1)
+        gfail("INPUT_NOT_PORTABLE_IR", `exprVersion must be a positive integer, got ${String(exprVersion)} (fail-closed)`);
+    if (exprVersion > SPEC_VERSIONS.expression)
+        gfail("UNSUPPORTED_EXPR_VERSION", `exprVersion ${exprVersion} exceeds supported expression version ${SPEC_VERSIONS.expression} (fail-closed)`);
+    // Portability Guard（P0-2）: 関数残存・非文字列 component 参照・未知 operator を静的拒否。
+    assertPortableComponentGraph(ir);
+    const components = doc.components;
+    if (components.length === 0)
+        gfail("EMPTY_IR", "IR has no components — nothing to generate (fail-closed)");
+    const seen = new Set();
+    for (const c of components) {
+        if (seen.has(c.name))
+            gfail("DUPLICATE_COMPONENT", `component name '${c.name}' appears more than once — bind() keys must be unique (fail-closed)`);
+        seen.add(c.name);
+    }
+    return ir;
+}
+/**
+ * generateModule — 可搬 component-graph IR から言語ネイティブの実行モジュールを生成する。
+ *
+ * 生成物の形（全言語共通の契約）:
+ *   - IR がネイティブリテラル定数として埋め込まれる（実行時 JSON パースなし）。
+ *   - `EXPECTED_SPEC_VERSIONS` / `IR_FINGERPRINT` 定数 + ロード時 fail-closed 検査。
+ *   - `bind(handlers)`（TS はさらに `bindAsync`）: handler 注入を受けて
+ *     `{component名: (input) => runBehavior(IR, handlers, input, name)}` を返す薄い束ね。
+ *     **handler は常に境界注入**であり、生成対象にならない（C4）。
+ *
+ * @throws {GeneratorFailure} 入力が可搬 IR でない / 版超過 / 未知言語（fail-closed）。
+ * @throws {PortabilityError} IR が Portability Guard に違反するとき。
+ */
+export function generateModule(ir, options) {
+    const plugin = registry.get(options.language);
+    if (!plugin)
+        gfail("UNKNOWN_LANGUAGE", `no emitter registered for language '${options.language}' (registered: ${registeredLanguages().join(", ")}) (fail-closed)`);
+    const validated = validateGeneratorInput(ir);
+    const fingerprint = fingerprintComponentGraph(validated);
+    const specVersions = {
+        behavior: SPEC_VERSIONS.behavior,
+        expression: SPEC_VERSIONS.expression,
+        plan: SPEC_VERSIONS.plan,
+    };
+    const componentNames = validated.components.map((c) => c.name);
+    const ctx = {
+        ir: validated,
+        fingerprint,
+        specVersions,
+        componentNames,
+        runtimeImport: options.runtimeImport ?? plugin.defaultRuntimeImport,
+    };
+    return {
+        language: plugin.language,
+        code: plugin.emit(ctx),
+        fingerprint,
+        specVersions,
+        componentNames,
+        filenameHint: plugin.filenameHint ?? `behaviors.generated${plugin.fileExtension}`,
+    };
+}
+//# sourceMappingURL=core.js.map

package/dist/generator/core.js.map

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

package/dist/generator/emit-go.d.ts

@@ -0,0 +1,19 @@
+/**
+ * emit-go.ts — Go emitter（共通 Generator, bc#13 SP2）。
+ *
+ * 生成物: 可搬 IR を **JNode ネイティブ複合リテラル**（`dslcontracts.JObjOf` /
+ * `[]dslcontracts.JNode` / `json.Number` — RunBehavior が消費する JNode ドメイン。
+ * dynamic 経路の ParseJSONOrdered 出力と同型）として埋め込み、runtime-core の
+ * `RunBehavior` に handler 注入で渡す薄い accessor（`Bind`）を公開する .go ファイル。
+ *
+ * ロード時検査は **init 時**（package import 時）: spec-version skew / fingerprint
+ * mismatch は `init()` の panic で LOUD reject — 生成 package を import しただけで
+ * プロセスが起動不能になる（#208 prepared-artifact 規律。first-Bind 遅延ではなく
+ * init を選ぶ: Go では import 副作用が慣用で、検査漏れの窓が生じない）。
+ *
+ * 出力は gofmt-clean（tab インデント・trailing comma）— CI の gofmt -l ゲートと
+ * fixture byte-drift ゲートの両立のため、emitter 出力自体が gofmt 不動点である。
+ */
+import type { EmitterPlugin } from "./core.js";
+export declare const goEmitter: EmitterPlugin;
+//# sourceMappingURL=emit-go.d.ts.map

package/dist/generator/emit-go.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-go.d.ts","sourceRoot":"","sources":["../../src/generator/emit-go.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,WAAW,CAAC;AA2E5D,eAAO,MAAM,SAAS,EAAE,aAKvB,CAAC"}

package/dist/generator/emit-go.js

@@ -0,0 +1,79 @@
+import { emitDocLiteral } from "./literal.js";
+function emit(ctx) {
+    const { fingerprint, specVersions, componentNames, runtimeImport } = ctx;
+    const names = componentNames.map((n) => JSON.stringify(n)).join(", ");
+    const irLiteral = emitDocLiteral(ctx.ir, "go");
+    return `// GENERATED by behavior-contracts common generator (bc#13) — DO NOT EDIT.
+// Input: portable component-graph IR only (scp-ir-architecture.md §5/§7.4).
+// This module is the codegen endpoint (§7.3 endpoint 3): the IR is embedded as a
+// native JNode composite literal and handed to the EXISTING runtime core
+// (RunBehavior) — no execution logic is generated. Handlers are ALWAYS injected
+// at the boundary (IR + {effects,config,hooks} — concept.md §4.4); they are
+// never generated.
+// irFingerprint: ${fingerprint}
+
+package behaviors
+
+import (
+	"encoding/json"
+	"fmt"
+
+	dslcontracts ${JSON.stringify(runtimeImport)}
+)
+
+// ExpectedSpecVersions are the spec versions baked at generation time
+// (fail-closed constant comparison at init).
+var ExpectedSpecVersions = map[string]int64{"behavior": ${specVersions.behavior}, "expression": ${specVersions.expression}, "plan": ${specVersions.plan}}
+
+// IRFingerprint is the FNV-1a 64 fingerprint of the source portable IR
+// (CanonicalJSON discipline, #208).
+const IRFingerprint = ${JSON.stringify(fingerprint)}
+
+// ComponentNames are the components exposed by Bind(), in IR declaration order.
+var ComponentNames = []string{${names}}
+
+// IR is the portable component-graph IR, embedded as a native JNode composite
+// literal (no JSON parse at runtime).
+var IR dslcontracts.JNode = ${irLiteral}
+
+// init — load-time fail-closed checks (#208 prepared-artifact discipline).
+// A spec-version skew or fingerprint mismatch panics at package initialization,
+// so importing a stale/tampered generated module fails LOUDLY before any
+// behavior can run.
+func init() {
+	for k, want := range ExpectedSpecVersions {
+		if got := dslcontracts.SpecVersions[k]; got != want {
+			panic(fmt.Sprintf("behavior-contracts generated module: spec-version skew for '%s' (generated=%d, runtime=%d) — regenerate against this runtime (fail-closed)", k, want, got))
+		}
+	}
+	got, err := dslcontracts.FingerprintComponentGraph(IR)
+	if err != nil {
+		panic(fmt.Sprintf("behavior-contracts generated module: fingerprint recompute failed: %v (fail-closed)", err))
+	}
+	if got != IRFingerprint {
+		panic(fmt.Sprintf("behavior-contracts generated module: IR fingerprint mismatch (baked=%s, embedded literal=%s) — the generated code was modified or corrupted (fail-closed)", IRFingerprint, got))
+	}
+}
+
+// Bind — inject handlers (boundary injection; catalog name → implementation) and
+// get one executor func per component. Each call delegates to the runtime core's
+// RunBehavior over the embedded IR (dynamic-path equivalent — §7.3).
+func Bind(handlers dslcontracts.ComponentExec) map[string]func(input *dslcontracts.Obj) (dslcontracts.Value, error) {
+	bound := make(map[string]func(input *dslcontracts.Obj) (dslcontracts.Value, error), len(ComponentNames))
+	for _, name := range ComponentNames {
+		n := name
+		bound[n] = func(input *dslcontracts.Obj) (dslcontracts.Value, error) {
+			return dslcontracts.RunBehavior(IR, handlers, input, n)
+		}
+	}
+	return bound
+}
+`;
+}
+export const goEmitter = {
+    language: "go",
+    fileExtension: ".go",
+    defaultRuntimeImport: "github.com/foo-ogawa/behavior-contracts/go",
+    emit,
+};
+//# sourceMappingURL=emit-go.js.map

package/dist/generator/emit-go.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-go.js","sourceRoot":"","sources":["../../src/generator/emit-go.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,SAAS,IAAI,CAAC,GAAgB;IAC5B,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,GAAG,GAAG,CAAC;IACzE,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC/C,OAAO;;;;;;;oBAOW,WAAW;;;;;;;;gBAQf,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;;;;;0DAKa,YAAY,CAAC,QAAQ,mBAAmB,YAAY,CAAC,UAAU,aAAa,YAAY,CAAC,IAAI;;;;wBAI/H,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;;;gCAGnB,KAAK;;;;8BAIP,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCtC,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAkB;IACtC,QAAQ,EAAE,IAAI;IACd,aAAa,EAAE,KAAK;IACpB,oBAAoB,EAAE,4CAA4C;IAClE,IAAI;CACL,CAAC"}

package/dist/generator/emit-php.d.ts

@@ -0,0 +1,20 @@
+/**
+ * emit-php.ts — PHP emitter（共通 Generator, bc#13 SP2）。
+ *
+ * 生成物: 可搬 IR を **ネイティブ配列/stdClass リテラル**（`(object) [...]` /
+ * `[...]` — Behavior::runBehavior が消費する json_decode(.., false) 同型ドメイン）
+ * として埋め込み、`Behavior::runBehavior` に handler 注入で渡す accessor
+ * （`bind` クロージャ）を公開する .php ファイル。
+ *
+ * ロード形: PHP に「モジュール」概念は無いため、生成ファイルは **require の戻り値**
+ * としてモジュールオブジェクト（stdClass: EXPECTED_SPEC_VERSIONS / IR_FINGERPRINT /
+ * COMPONENT_NAMES / IR / bind）を返す。トップレベルシンボルを定義しないので、
+ * 同一プロセスで複数の生成モジュールを衝突なく require できる
+ * （変数スコープ漏れを避けるにはクロージャ内で require すること）。
+ *
+ * ロード時検査は **require 時**: spec-version skew / fingerprint mismatch は
+ * RuntimeException で LOUD reject（#208 prepared-artifact 規律）。
+ */
+import type { EmitterPlugin } from "./core.js";
+export declare const phpEmitter: EmitterPlugin;
+//# sourceMappingURL=emit-php.d.ts.map

package/dist/generator/emit-php.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-php.d.ts","sourceRoot":"","sources":["../../src/generator/emit-php.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,WAAW,CAAC;AAyE5D,eAAO,MAAM,UAAU,EAAE,aAKxB,CAAC"}

package/dist/generator/emit-php.js

@@ -0,0 +1,76 @@
+import { emitDocLiteral } from "./literal.js";
+/** PHP 単一引用符リテラル（識別子・fingerprint 用 — ASCII 前提）。 */
+function phpSq(s) {
+    return `'${s.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
+}
+function emit(ctx) {
+    const { fingerprint, specVersions, componentNames, runtimeImport } = ctx;
+    const names = componentNames.map(phpSq).join(", ");
+    const irLiteral = emitDocLiteral(ctx.ir, "php");
+    return `<?php
+
+// GENERATED by behavior-contracts common generator (bc#13) — DO NOT EDIT.
+// Input: portable component-graph IR only (scp-ir-architecture.md §5/§7.4).
+// This module is the codegen endpoint (§7.3 endpoint 3): the IR is embedded as a
+// native stdClass/array literal and handed to the EXISTING runtime core
+// (Behavior::runBehavior) — no execution logic is generated. Handlers are ALWAYS
+// injected at the boundary (IR + {effects,config,hooks} — concept.md §4.4); they
+// are never generated.
+// irFingerprint: ${fingerprint}
+
+declare(strict_types=1);
+
+// Spec versions baked at generation time (fail-closed constant comparison at require).
+$expectedSpecVersions = ['behavior' => ${specVersions.behavior}, 'expression' => ${specVersions.expression}, 'plan' => ${specVersions.plan}];
+
+// FNV-1a 64 fingerprint of the source portable IR (canonical-json discipline, #208).
+$irFingerprint = ${phpSq(fingerprint)};
+
+// Component names exposed by bind(), in IR declaration order.
+$componentNames = [${names}];
+
+// The portable component-graph IR, embedded as a native literal (no JSON parse at require).
+$ir = ${irLiteral};
+
+// Require-time fail-closed checks (#208 prepared-artifact discipline).
+$runtimeSpecVersions = [
+    'behavior' => \\${runtimeImport}\\SpecVersions::BEHAVIOR,
+    'expression' => \\${runtimeImport}\\SpecVersions::EXPRESSION,
+    'plan' => \\${runtimeImport}\\SpecVersions::PLAN,
+];
+foreach ($expectedSpecVersions as $specKey => $specWant) {
+    $specGot = $runtimeSpecVersions[$specKey] ?? null;
+    if ($specGot !== $specWant) {
+        throw new \\RuntimeException("behavior-contracts generated module: spec-version skew for '{$specKey}' (generated={$specWant}, runtime={$specGot}) — regenerate against this runtime (fail-closed)");
+    }
+}
+$gotFingerprint = \\${runtimeImport}\\Fingerprint::componentGraph($ir);
+if ($gotFingerprint !== $irFingerprint) {
+    throw new \\RuntimeException("behavior-contracts generated module: IR fingerprint mismatch (baked={$irFingerprint}, embedded literal={$gotFingerprint}) — the generated code was modified or corrupted (fail-closed)");
+}
+
+// bind — inject handlers (boundary injection; catalog name → implementation) and
+// get one executor closure per component. Each call delegates to the runtime
+// core's Behavior::runBehavior over the embedded IR (dynamic-path equivalent — §7.3).
+return (object) [
+    'EXPECTED_SPEC_VERSIONS' => $expectedSpecVersions,
+    'IR_FINGERPRINT' => $irFingerprint,
+    'COMPONENT_NAMES' => $componentNames,
+    'IR' => $ir,
+    'bind' => static function (array $handlers) use ($ir, $componentNames): array {
+        $bound = [];
+        foreach ($componentNames as $name) {
+            $bound[$name] = static fn (array $input = []): mixed => \\${runtimeImport}\\Behavior::runBehavior($ir, $handlers, $input, $name);
+        }
+        return $bound;
+    },
+];
+`;
+}
+export const phpEmitter = {
+    language: "php",
+    fileExtension: ".php",
+    defaultRuntimeImport: "BehaviorContracts",
+    emit,
+};
+//# sourceMappingURL=emit-php.js.map

package/dist/generator/emit-php.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-php.js","sourceRoot":"","sources":["../../src/generator/emit-php.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,mDAAmD;AACnD,SAAS,KAAK,CAAC,CAAS;IACtB,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;AAC9D,CAAC;AAED,SAAS,IAAI,CAAC,GAAgB;IAC5B,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,GAAG,GAAG,CAAC;IACzE,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAChD,OAAO;;;;;;;;;oBASW,WAAW;;;;;yCAKU,YAAY,CAAC,QAAQ,qBAAqB,YAAY,CAAC,UAAU,eAAe,YAAY,CAAC,IAAI;;;mBAGvH,KAAK,CAAC,WAAW,CAAC;;;qBAGhB,KAAK;;;QAGlB,SAAS;;;;sBAIK,aAAa;wBACX,aAAa;kBACnB,aAAa;;;;;;;;sBAQT,aAAa;;;;;;;;;;;;;;;;wEAgBqC,aAAa;;;;;CAKpF,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAkB;IACvC,QAAQ,EAAE,KAAK;IACf,aAAa,EAAE,MAAM;IACrB,oBAAoB,EAAE,mBAAmB;IACzC,IAAI;CACL,CAAC"}

package/dist/generator/emit-python.d.ts

@@ -0,0 +1,10 @@
+/**
+ * emit-python.ts — Python emitter（共通 Generator, bc#13 SP1）。
+ *
+ * 生成物: 可搬 IR を **dict リテラル**として埋め込み、`behavior_contracts.run_behavior` に
+ * handler 注入で渡す薄い accessor（`bind`）を公開する .py モジュール。TS emitter と同形:
+ * spec-version / fingerprint 定数の焼き込み + ロード時 fail-closed 検査。
+ */
+import type { EmitterPlugin } from "./core.js";
+export declare const pythonEmitter: EmitterPlugin;
+//# sourceMappingURL=emit-python.d.ts.map

package/dist/generator/emit-python.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-python.d.ts","sourceRoot":"","sources":["../../src/generator/emit-python.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,WAAW,CAAC;AAwE5D,eAAO,MAAM,aAAa,EAAE,aAK3B,CAAC"}

package/dist/generator/emit-python.js

@@ -0,0 +1,75 @@
+import { emitDocLiteral } from "./literal.js";
+/** Python 文字列リテラル（JSON エスケープは Python でも合法）。 */
+function pyStr(s) {
+    return JSON.stringify(s);
+}
+function emit(ctx) {
+    const { fingerprint, specVersions, componentNames, runtimeImport } = ctx;
+    const names = componentNames.map(pyStr).join(", ");
+    const namesTuple = componentNames.length === 1 ? `(${names},)` : `(${names})`;
+    const irLiteral = emitDocLiteral(ctx.ir, "py");
+    return `# GENERATED by behavior-contracts common generator (bc#13) — DO NOT EDIT.
+# Input: portable component-graph IR only (scp-ir-architecture.md §5/§7.4).
+# This module is the codegen endpoint (§7.3 endpoint 3): the IR is embedded as a
+# native dict literal and handed to the EXISTING runtime core (run_behavior) —
+# no execution logic is generated. Handlers are ALWAYS injected at the boundary
+# (IR + {effects,config,hooks}); they are never generated.
+# irFingerprint: ${fingerprint}
+from ${runtimeImport} import SPEC_VERSIONS, fingerprint_component_graph, run_behavior
+
+# Spec versions baked at generation time (fail-closed constant comparison at load).
+EXPECTED_SPEC_VERSIONS = {"behavior": ${specVersions.behavior}, "expression": ${specVersions.expression}, "plan": ${specVersions.plan}}
+
+# FNV-1a 64 fingerprint of the source portable IR (canonical_json discipline, #208).
+IR_FINGERPRINT = ${pyStr(fingerprint)}
+
+# Component names exposed by bind(), in IR declaration order.
+COMPONENT_NAMES = ${namesTuple}
+
+# The portable component-graph IR, embedded as a native dict literal (no JSON parse at runtime).
+IR = ${irLiteral}
+
+
+def _check_generated_module() -> None:
+    # load-time fail-closed checks (#208 prepared-artifact discipline).
+    for _k, _want in EXPECTED_SPEC_VERSIONS.items():
+        _got = SPEC_VERSIONS.get(_k)
+        if _got != _want:
+            raise RuntimeError(
+                "behavior-contracts generated module: spec-version skew for '%s' "
+                "(generated=%s, runtime=%s) — regenerate against this runtime (fail-closed)"
+                % (_k, _want, _got)
+            )
+    _got_fp = fingerprint_component_graph(IR)
+    if _got_fp != IR_FINGERPRINT:
+        raise RuntimeError(
+            "behavior-contracts generated module: IR fingerprint mismatch "
+            "(baked=%s, embedded literal=%s) — the generated code was modified or corrupted (fail-closed)"
+            % (IR_FINGERPRINT, _got_fp)
+        )
+
+
+_check_generated_module()
+
+
+def bind(handlers):
+    """Inject handlers (boundary injection; catalog name -> implementation) and get
+    one callable per component. Each call delegates to the runtime core's
+    run_behavior over the embedded IR (dynamic-path equivalent — §7.3)."""
+
+    def _make(name):
+        def _call(input=None):
+            return run_behavior(IR, handlers, dict(input or {}), name)
+
+        return _call
+
+    return {name: _make(name) for name in COMPONENT_NAMES}
+`;
+}
+export const pythonEmitter = {
+    language: "python",
+    fileExtension: ".py",
+    defaultRuntimeImport: "behavior_contracts",
+    emit,
+};
+//# sourceMappingURL=emit-python.js.map

package/dist/generator/emit-python.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-python.js","sourceRoot":"","sources":["../../src/generator/emit-python.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,+CAA+C;AAC/C,SAAS,KAAK,CAAC,CAAS;IACtB,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,IAAI,CAAC,GAAgB;IAC5B,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,GAAG,GAAG,CAAC;IACzE,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC;IAC9E,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC/C,OAAO;;;;;;mBAMU,WAAW;OACvB,aAAa;;;wCAGoB,YAAY,CAAC,QAAQ,mBAAmB,YAAY,CAAC,UAAU,aAAa,YAAY,CAAC,IAAI;;;mBAGlH,KAAK,CAAC,WAAW,CAAC;;;oBAGjB,UAAU;;;OAGvB,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCf,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,QAAQ,EAAE,QAAQ;IAClB,aAAa,EAAE,KAAK;IACpB,oBAAoB,EAAE,oBAAoB;IAC1C,IAAI;CACL,CAAC"}

package/dist/generator/emit-rust.d.ts

@@ -0,0 +1,25 @@
+/**
+ * emit-rust.ts — Rust emitter（共通 Generator, bc#13 SP2）。
+ *
+ * 生成物: 可搬 IR を **`serde_json::json!` マクロのネイティブ構築コード**として埋め込み
+ * （JSON テキストの実行時パースなし・構文はコンパイル時検査）、runtime-core の
+ * `run_behavior` に handler 注入で渡す accessor（`bind` → `Bound::call`）を公開する
+ * .rs モジュール。
+ *
+ * **「true const」からの正直な逸脱（SP1 audit の SP2 指針 (c)）**:
+ * Rust runtime は IR を `serde_json::Value` で消費するが、`Value` は const 構築
+ * できない。そのため IR は `std::sync::LazyLock`（std, Rust >= 1.80）で**初回使用時に
+ * 一度だけ**ネイティブ構築される（以後は共有参照）。実行時 JSON パースは行わず、
+ * 構築コストは初回 1 回のみ。const-friendly な型付き IR 受け皿を runtime に足す案は
+ * runtime 再設計を伴うため将来 issue（本 SP のスコープ外）。
+ *
+ * ロード時検査は **first-use 時**: `IR` の LazyLock 初期化子の中で spec-version /
+ * fingerprint を検査し、skew は panic で LOUD reject（`bind()` が最初に force する）。
+ *
+ * 出力は rustfmt-clean（rustfmt は json! マクロ本体を触らないため、emitter の
+ * レイアウトが不動点になる）— fixture byte-drift ゲートと `cargo fmt --check` 系
+ * ゲートの両立のため。
+ */
+import type { EmitterPlugin } from "./core.js";
+export declare const rustEmitter: EmitterPlugin;
+//# sourceMappingURL=emit-rust.d.ts.map

package/dist/generator/emit-rust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-rust.d.ts","sourceRoot":"","sources":["../../src/generator/emit-rust.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,WAAW,CAAC;AAyH5D,eAAO,MAAM,WAAW,EAAE,aAMzB,CAAC"}