@sublang/slc 0.1.0

package/dist/config-file.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,82 @@
+import type { AgentAdapter, PermissionPolicy } from '@sublang/cligent';
+import type { PhaseExecutor } from './execution.js';
+import type { AgentClient } from './interpreter.js';
+import type { CompiledSelection } from './runner.js';
+/** Agent CLI ids the executable registers (CLI-7). */
+export declare const SUPPORTED_AGENTS: readonly ["claude-code", "codex", "gemini", "opencode"];
+/** One of the registered agent CLI ids (CLI-7). */
+export type SupportedAgent = (typeof SUPPORTED_AGENTS)[number];
+/** Constructs the Cligent adapter for a supported agent id (CLI-7). */
+export type AdapterFactory = (agent: SupportedAgent) => AgentAdapter;
+/** Default factory: Cligent's built-in adapters, constructed on demand (CLI-7). */
+export declare const defaultAdapterFactory: AdapterFactory;
+/** A resolved agent/model/effort selection (CLI-7). */
+export interface AgentSelection {
+    agent: SupportedAgent;
+    /** Optional model; omitted so the agent CLI uses its own default. */
+    model?: string;
+    /** Optional adapter-scoped reasoning effort; omitted for the default. */
+    effort?: string;
+}
+/** Machine-readable reason agent configuration was refused (CLI-12). */
+export type ConfigErrorCode = 'agent-unset' | 'agent-unsupported' | 'effort-unsupported';
+/** Raised when `SLC_AGENT` is unset or names an unsupported agent CLI (CLI-12). */
+export declare class ConfigError extends Error {
+    readonly code: ConfigErrorCode;
+    constructor(code: ConfigErrorCode, message: string);
+}
+/** Reports whether `agent` is one of the registered ids (CLI-7). */
+export declare function isSupportedAgent(agent: string): agent is SupportedAgent;
+/**
+ * Resolves the agent/model/effort selection from environment configuration
+ * (CLI-7, CLI-12): `SLC_AGENT` names a registered agent CLI, `SLC_MODEL`
+ * optionally names a model, and `SLC_EFFORT` optionally selects an
+ * adapter-scoped reasoning effort validated against Cligent's support
+ * metadata.
+ *
+ * @throws {ConfigError} when `SLC_AGENT` is unset/blank (`agent-unset`) or
+ *   outside the registered set (`agent-unsupported`), or when `SLC_EFFORT`
+ *   names a value the selected agent does not support
+ *   (`effort-unsupported`); no implicit default agent is applied.
+ */
+export declare function resolveAgentSelection(env: Record<string, string | undefined>): AgentSelection;
+/**
+ * Builds the interpreted {@link PhaseExecutor} for a selection (CLI-7, CLI-8):
+ * constructs the agent CLI's adapter, wraps it as a Cligent-backed transport,
+ * and binds the optional model as configuration, not phase semantics
+ * (PHEXEC-13). The adapter factory is injectable so tests can fake adapter
+ * construction; `permissions` is where a host configures the DR-003 write-scope
+ * sandbox.
+ */
+export declare function createConfiguredExecutor(selection: AgentSelection, opts?: {
+    adapterFactory?: AdapterFactory;
+    cwd?: string;
+    maxTurns?: number;
+    permissions?: PermissionPolicy;
+}): PhaseExecutor;
+/**
+ * Builds one Cligent-backed {@link AgentClient} for a selection (CLI-7): a fresh
+ * adapter wrapped as a transport. Each client is a single-flight Cligent
+ * instance that resumes its own agent session across calls, so callers wanting
+ * isolated sessions construct one client per role or player.
+ */
+export declare function createConfiguredAgentClient(selection: AgentSelection, opts?: {
+    adapterFactory?: AdapterFactory;
+    maxTurns?: number;
+    permissions?: PermissionPolicy;
+}): AgentClient;
+/**
+ * Builds the compiled-execution factory the bin injects as `SlcDeps.compiled`
+ * (CLI-8, PHEXEC-27): for a current pinned phase it drives the pinned `playbook`
+ * artifact — resolved against its pipeline directory — through the compiled
+ * executor, backing the runtime's player ports with one agent transport per
+ * player id and its Captain/judge ports with one shared transport (PHEXEC-25),
+ * and applying the selected model as the default per-player model (PHEXEC-13).
+ */
+export declare function createConfiguredCompiledFactory(selection: AgentSelection, opts?: {
+    adapterFactory?: AdapterFactory;
+    cwd?: string;
+    maxTurns?: number;
+    permissions?: PermissionPolicy;
+}): (choice: CompiledSelection) => PhaseExecutor;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAIvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,yDAKnB,CAAC;AAEX,mDAAmD;AACnD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,YAAY,CAAC;AAErE,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,EAAE,cAWnC,CAAC;AAEF,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,cAAc,CAAC;IACtB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wEAAwE;AACxE,MAAM,MAAM,eAAe,GACvB,aAAa,GACb,mBAAmB,GACnB,oBAAoB,CAAC;AAEzB,mFAAmF;AACnF,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;gBAEnB,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;CAKnD;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,cAAc,CA2BhB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,cAAc,EACzB,IAAI,GAAE;IACJ,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAC3B,GACL,aAAa,CAMf;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,cAAc,EACzB,IAAI,GAAE;IACJ,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAC3B,GACL,WAAW,CAUb;AAED;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,cAAc,EACzB,IAAI,GAAE;IACJ,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAC3B,GACL,CAAC,MAAM,EAAE,iBAAiB,KAAK,aAAa,CAc9C"}

package/dist/config.js

@@ -0,0 +1,161 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
+/**
+ * Agent/model configuration and executor construction for the `slc` bin (CLI-7,
+ * CLI-8, CLI-12, DR-004, DR-005).
+ *
+ * `resolveAgentSelection` reads `SLC_AGENT`/`SLC_MODEL` from the environment and
+ * refuses an unset or unsupported agent with no implicit default (CLI-12).
+ * `createConfiguredExecutor` builds the interpreted executor and
+ * `createConfiguredCompiledFactory` the compiled-execution factory pinned phases
+ * select, both over Cligent-backed transports for the selected agent, binding
+ * the optional model as configuration — not phase semantics (PHEXEC-13);
+ * credentials are left for the agent CLI to read from the inherited process
+ * environment. The adapter factory is injectable so tests can fake adapter
+ * construction. See specs/dev/cli.md.
+ */
+import { resolve } from 'node:path';
+import { ClaudeCodeAdapter } from '@sublang/cligent/adapters/claude-code';
+import { CodexAdapter } from '@sublang/cligent/adapters/codex';
+import { GeminiAdapter } from '@sublang/cligent/adapters/gemini';
+import { OpenCodeAdapter } from '@sublang/cligent/adapters/opencode';
+import { isEffortSupported, supportedEffortValues } from '@sublang/cligent';
+import { createCligentAgent } from './cligent-agent.js';
+import { createCompiledExecutor } from './compiled-executor.js';
+import { createInterpretedExecutor } from './interpreter.js';
+/** Agent CLI ids the executable registers (CLI-7). */
+export const SUPPORTED_AGENTS = [
+    'claude-code',
+    'codex',
+    'gemini',
+    'opencode',
+];
+/** Default factory: Cligent's built-in adapters, constructed on demand (CLI-7). */
+export const defaultAdapterFactory = (agent) => {
+    switch (agent) {
+        case 'claude-code':
+            return new ClaudeCodeAdapter();
+        case 'codex':
+            return new CodexAdapter();
+        case 'gemini':
+            return new GeminiAdapter();
+        case 'opencode':
+            return new OpenCodeAdapter();
+    }
+};
+/** Raised when `SLC_AGENT` is unset or names an unsupported agent CLI (CLI-12). */
+export class ConfigError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'ConfigError';
+        this.code = code;
+    }
+}
+/** Reports whether `agent` is one of the registered ids (CLI-7). */
+export function isSupportedAgent(agent) {
+    return SUPPORTED_AGENTS.includes(agent);
+}
+/**
+ * Resolves the agent/model/effort selection from environment configuration
+ * (CLI-7, CLI-12): `SLC_AGENT` names a registered agent CLI, `SLC_MODEL`
+ * optionally names a model, and `SLC_EFFORT` optionally selects an
+ * adapter-scoped reasoning effort validated against Cligent's support
+ * metadata.
+ *
+ * @throws {ConfigError} when `SLC_AGENT` is unset/blank (`agent-unset`) or
+ *   outside the registered set (`agent-unsupported`), or when `SLC_EFFORT`
+ *   names a value the selected agent does not support
+ *   (`effort-unsupported`); no implicit default agent is applied.
+ */
+export function resolveAgentSelection(env) {
+    const agent = (env.SLC_AGENT ?? '').trim();
+    if (agent === '') {
+        throw new ConfigError('agent-unset', `SLC_AGENT is not set; set it to one of: ${SUPPORTED_AGENTS.join(', ')}`);
+    }
+    if (!isSupportedAgent(agent)) {
+        throw new ConfigError('agent-unsupported', `SLC_AGENT "${agent}" is not a supported agent CLI; choose one of: ${SUPPORTED_AGENTS.join(', ')}`);
+    }
+    const model = (env.SLC_MODEL ?? '').trim();
+    const effort = (env.SLC_EFFORT ?? '').trim();
+    if (effort !== '' && !isEffortSupported(agent, effort)) {
+        throw new ConfigError('effort-unsupported', `SLC_EFFORT "${effort}" is not supported by ${agent}; choose one of: ${(supportedEffortValues(agent) ?? []).join(', ')}`);
+    }
+    return {
+        agent,
+        model: model === '' ? undefined : model,
+        effort: effort === '' ? undefined : effort,
+    };
+}
+/**
+ * Builds the interpreted {@link PhaseExecutor} for a selection (CLI-7, CLI-8):
+ * constructs the agent CLI's adapter, wraps it as a Cligent-backed transport,
+ * and binds the optional model as configuration, not phase semantics
+ * (PHEXEC-13). The adapter factory is injectable so tests can fake adapter
+ * construction; `permissions` is where a host configures the DR-003 write-scope
+ * sandbox.
+ */
+export function createConfiguredExecutor(selection, opts = {}) {
+    const agent = createConfiguredAgentClient(selection, opts);
+    return createInterpretedExecutor({
+        agent,
+        config: { model: selection.model, cwd: opts.cwd },
+    });
+}
+/**
+ * Builds one Cligent-backed {@link AgentClient} for a selection (CLI-7): a fresh
+ * adapter wrapped as a transport. Each client is a single-flight Cligent
+ * instance that resumes its own agent session across calls, so callers wanting
+ * isolated sessions construct one client per role or player.
+ */
+export function createConfiguredAgentClient(selection, opts = {}) {
+    const adapter = (opts.adapterFactory ?? defaultAdapterFactory)(selection.agent);
+    return createCligentAgent({
+        adapter,
+        maxTurns: opts.maxTurns,
+        permissions: opts.permissions,
+        effort: selection.effort,
+    });
+}
+/**
+ * Builds the compiled-execution factory the bin injects as `SlcDeps.compiled`
+ * (CLI-8, PHEXEC-27): for a current pinned phase it drives the pinned `playbook`
+ * artifact — resolved against its pipeline directory — through the compiled
+ * executor, backing the runtime's player ports with one agent transport per
+ * player id and its Captain/judge ports with one shared transport (PHEXEC-25),
+ * and applying the selected model as the default per-player model (PHEXEC-13).
+ */
+export function createConfiguredCompiledFactory(selection, opts = {}) {
+    const client = () => createConfiguredAgentClient(selection, opts);
+    return (choice) => createCompiledExecutor({
+        artifactPath: resolve(choice.pipelineDir, choice.record.artifact.path),
+        runRoot: opts.cwd ?? process.cwd(),
+        playbookId: choice.phase,
+        runtimeContract: runtimeContractForPin(choice),
+        player: () => client(),
+        judge: client(),
+        defaultModel: selection.model,
+        cwd: opts.cwd,
+    });
+}
+function runtimeContractForPin(choice) {
+    const provenance = choice.record.linkTarget.provenance;
+    if (provenance === undefined || provenance === '@sublang/playbook@0.9.0') {
+        return 'legacy';
+    }
+    // Playbook 0.10 ships the composed six-port contract (DR-011); artifacts
+    // linked against it run through the composed session profile. 1.0.0 is the
+    // published release of that same contract generation — 0.10.0 was cut
+    // locally and superseded before it ever reached the registry. 2.0.0 keeps
+    // the six-port boundary and structured results while moving Captain host
+    // failures onto the resolved `failed` path and emitting thin linked
+    // modules (DR-017), so all three provenances select the composed profile.
+    // 1.3.0 was never installed or reviewed and stays fail-closed.
+    if (provenance === '@sublang/playbook@0.10.0' ||
+        provenance === '@sublang/playbook@1.0.0' ||
+        provenance === '@sublang/playbook@2.0.0') {
+        return 'composed-v2';
+    }
+    throw new Error(`unsupported pinned Playbook runtime contract: ${provenance}`);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,0EAA0E;AAE1E;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAG7D,sDAAsD;AACtD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,aAAa;IACb,OAAO;IACP,QAAQ;IACR,UAAU;CACF,CAAC;AAQX,mFAAmF;AACnF,MAAM,CAAC,MAAM,qBAAqB,GAAmB,CAAC,KAAK,EAAE,EAAE;IAC7D,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,aAAa;YAChB,OAAO,IAAI,iBAAiB,EAAE,CAAC;QACjC,KAAK,OAAO;YACV,OAAO,IAAI,YAAY,EAAE,CAAC;QAC5B,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,EAAE,CAAC;QAC7B,KAAK,UAAU;YACb,OAAO,IAAI,eAAe,EAAE,CAAC;IACjC,CAAC;AACH,CAAC,CAAC;AAiBF,mFAAmF;AACnF,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAkB;IAE/B,YAAY,IAAqB,EAAE,OAAe;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,oEAAoE;AACpE,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAQ,gBAAsC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACjE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACnC,GAAuC;IAEvC,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,WAAW,CACnB,aAAa,EACb,2CAA2C,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACzE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,WAAW,CACnB,mBAAmB,EACnB,cAAc,KAAK,kDAAkD,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACnG,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,IAAI,MAAM,KAAK,EAAE,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,WAAW,CACnB,oBAAoB,EACpB,eAAe,MAAM,yBAAyB,KAAK,oBAAoB,CAAC,qBAAqB,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACzH,CAAC;IACJ,CAAC;IACD,OAAO;QACL,KAAK;QACL,KAAK,EAAE,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK;QACvC,MAAM,EAAE,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;KAC3C,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CACtC,SAAyB,EACzB,OAKI,EAAE;IAEN,MAAM,KAAK,GAAG,2BAA2B,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3D,OAAO,yBAAyB,CAAC;QAC/B,KAAK;QACL,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;KAClD,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,SAAyB,EACzB,OAII,EAAE;IAEN,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,qBAAqB,CAAC,CAC5D,SAAS,CAAC,KAAK,CAChB,CAAC;IACF,OAAO,kBAAkB,CAAC;QACxB,OAAO;QACP,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,SAAS,CAAC,MAAM;KACzB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,+BAA+B,CAC7C,SAAyB,EACzB,OAKI,EAAE;IAEN,MAAM,MAAM,GAAG,GAAgB,EAAE,CAC/B,2BAA2B,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/C,OAAO,CAAC,MAAM,EAAE,EAAE,CAChB,sBAAsB,CAAC;QACrB,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QACtE,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;QAClC,UAAU,EAAE,MAAM,CAAC,KAAK;QACxB,eAAe,EAAE,qBAAqB,CAAC,MAAM,CAAC;QAC9C,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;QACtB,KAAK,EAAE,MAAM,EAAE;QACf,YAAY,EAAE,SAAS,CAAC,KAAK;QAC7B,GAAG,EAAE,IAAI,CAAC,GAAG;KACd,CAAC,CAAC;AACP,CAAC;AAED,SAAS,qBAAqB,CAC5B,MAAyB;IAEzB,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC;IACvD,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,yBAAyB,EAAE,CAAC;QACzE,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,yEAAyE;IACzE,2EAA2E;IAC3E,sEAAsE;IACtE,0EAA0E;IAC1E,yEAAyE;IACzE,oEAAoE;IACpE,0EAA0E;IAC1E,+DAA+D;IAC/D,IACE,UAAU,KAAK,0BAA0B;QACzC,UAAU,KAAK,yBAAyB;QACxC,UAAU,KAAK,yBAAyB,EACxC,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,MAAM,IAAI,KAAK,CACb,iDAAiD,UAAU,EAAE,CAC9D,CAAC;AACJ,CAAC"}

package/dist/entry-module.d.ts

@@ -0,0 +1,22 @@
+/** Options for {@link emitEntryModule}. */
+export interface EmitEntryModuleOptions {
+    /** Invocation working directory the module is written into (DR-014). */
+    cwd: string;
+    /** The DR-001 basename naming the entry module and the bundle. */
+    basename: string;
+    /** Pipeline reference forming the bundle directory leaf `<basename>.<pipeline>`. */
+    pipeline: string;
+    /** The optimized gears artifact: players and script items. */
+    gearsPath: string;
+    /** The normalized (or entry-form) text source: title and lead line. */
+    textPath: string;
+}
+/** Emits the entry module and returns its path. */
+export declare function emitEntryModule(opts: EmitEntryModuleOptions): Promise<string>;
+/**
+ * The gears `Players:` declaration, verbatim in source order (SELFHOST-15).
+ * Alias declarations (`` `A` = `B` | `C` ``) are launcher options, not
+ * required roles, and are excluded.
+ */
+export declare function declaredPlayers(gears: string): string[];
+//# sourceMappingURL=entry-module.d.ts.map

package/dist/entry-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-module.d.ts","sourceRoot":"","sources":["../src/entry-module.ts"],"names":[],"mappings":"AAwBA,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,mDAAmD;AACnD,wBAAsB,eAAe,CACnC,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAiCjB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAoBvD"}

package/dist/entry-module.js

@@ -0,0 +1,216 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
+/**
+ * Deterministic entry-module emission (DR-014, DR-017, SELFHOST-15).
+ *
+ * After a successful full-link of the `playbook` pipeline, {@link
+ * emitEntryModule} writes `<cwd>/<basename>.ts`: an erasable-TypeScript module
+ * default-exporting a Playbook registry entry derived entirely from the
+ * compiled bundle — `id`/`command` from the basename, `requiredRoleIds` from
+ * the gears `Players:` declaration, `intent` from the normalized source's
+ * title and lead line, an option allowlist carrying `cwd` exactly when the
+ * source compiled a script item, and `createRuntime` wiring the linked default
+ * factory behind the DR-017 role-binding boundary, which maps the linked
+ * runtime's lowercased player ids back to the declared role ids at the
+ * session's `callPlayer` port. `playbook run ./<basename>.ts "<task>"`
+ * consumes it unchanged (SELFHOST-14). See specs/dev/self-hosting.md.
+ */
+import { readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { parseGearsItems } from './verify.js';
+/** Emits the entry module and returns its path. */
+export async function emitEntryModule(opts) {
+    const gears = await readFile(opts.gearsPath, 'utf8');
+    const text = await readFile(opts.textPath, 'utf8');
+    const players = declaredPlayers(gears);
+    // The role-binding boundary keys declared ids by their lowercased form; a
+    // case-insensitive collision would make the binding ambiguous (DR-017).
+    const byLowered = new Map();
+    for (const player of players) {
+        const existing = byLowered.get(player.toLowerCase());
+        if (existing !== undefined && existing !== player) {
+            throw new Error(`entry emission failed: declared players "${existing}" and "${player}" collide case-insensitively`);
+        }
+        byLowered.set(player.toLowerCase(), player);
+    }
+    const hasScript = parseGearsItems(gears).some((item) => item.actor === 'script');
+    const intent = deriveIntent(text) ?? opts.basename;
+    const path = join(opts.cwd, `${opts.basename}.ts`);
+    await writeFile(path, renderEntryModule({
+        basename: opts.basename,
+        bundleLeaf: `${opts.basename}.${opts.pipeline}`,
+        players,
+        hasScript,
+        intent,
+    }), 'utf8');
+    return path;
+}
+/**
+ * The gears `Players:` declaration, verbatim in source order (SELFHOST-15).
+ * Alias declarations (`` `A` = `B` | `C` ``) are launcher options, not
+ * required roles, and are excluded.
+ */
+export function declaredPlayers(gears) {
+    const players = [];
+    let inBlock = false;
+    for (const line of gears.split('\n')) {
+        if (/^Players:\s*$/.test(line)) {
+            inBlock = true;
+            continue;
+        }
+        if (!inBlock)
+            continue;
+        const bullet = /^-\s+(.*)$/.exec(line.trim());
+        if (bullet === null) {
+            if (line.trim() === '')
+                continue;
+            break;
+        }
+        const declaration = bullet[1];
+        if (declaration.includes('='))
+            continue;
+        const name = /^[`"“]?([^`"”]+?)[`"”]?\s*$/.exec(declaration.trim());
+        if (name !== null && name[1].length > 0)
+            players.push(name[1]);
+    }
+    return players;
+}
+/** Title and lead line of the normalized source, joined as the intent. */
+function deriveIntent(text) {
+    let title;
+    let lead;
+    for (const line of text.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed === '' || trimmed.startsWith('<!--'))
+            continue;
+        if (title === undefined) {
+            const heading = /^#\s+(.*)$/.exec(trimmed);
+            if (heading !== null) {
+                title = heading[1].trim();
+                continue;
+            }
+        }
+        if (trimmed.startsWith('#') ||
+            trimmed.startsWith('-') ||
+            /^Players:\s*$/.test(trimmed)) {
+            continue;
+        }
+        lead = trimmed;
+        break;
+    }
+    if (title !== undefined && lead !== undefined)
+        return `${title} — ${lead}`;
+    return title ?? lead;
+}
+function renderEntryModule(spec) {
+    const allowed = spec.hasScript ? `['cwd']` : `[]`;
+    const cwdWiring = spec.hasScript
+        ? `{\n      ...validated,\n      cwd: validated.cwd ?? process.cwd(),\n    }`
+        : `validated`;
+    return `// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
+//
+// Generated by slc (DR-014): the registry entry exposing the compiled
+// playbook to \`playbook run\`. Derived deterministically from the compiled
+// bundle; recompiling regenerates it. The role-binding boundary (DR-017)
+// hands the host's \`callPlayer\` port only declared role ids.
+
+import createPlaybookRuntime from './${spec.bundleLeaf}/${spec.basename}.playbook.ts';
+
+type RuntimeOptions = NonNullable<Parameters<typeof createPlaybookRuntime>[0]>;
+
+const ALLOWED_OPTION_KEYS: readonly string[] = ${allowed};
+
+const REQUIRED_ROLE_IDS: readonly string[] = [${spec.players.map(sourceString).join(', ')}];
+
+const ROLE_ID_BY_RESOLVED: ReadonlyMap<string, string> = new Map(
+  REQUIRED_ROLE_IDS.map((id): [string, string] => [id.toLowerCase(), id]),
+);
+
+function bindRoleIds(session: unknown): unknown {
+  if (typeof session !== 'object' || session === null) return session;
+  const ports = (session as { ports?: unknown }).ports;
+  if (typeof ports !== 'object' || ports === null) return session;
+  const callPlayer = (ports as Record<string, unknown>).callPlayer;
+  if (typeof callPlayer !== 'function') return session;
+  return {
+    ...session,
+    ports: {
+      ...(ports as Record<string, unknown>),
+      callPlayer: (playerId: unknown, ...rest: unknown[]) =>
+        (callPlayer as (...args: unknown[]) => unknown).call(
+          ports,
+          typeof playerId === 'string'
+            ? (ROLE_ID_BY_RESOLVED.get(playerId) ?? playerId)
+            : playerId,
+          ...rest,
+        ),
+    },
+  };
+}
+
+function withRoleBinding<T extends object>(runtime: T): T {
+  return new Proxy(runtime, {
+    get(target, property, receiver) {
+      const value = Reflect.get(target, property, receiver);
+      if (
+        (property === 'init' || property === 'restore') &&
+        typeof value === 'function'
+      ) {
+        return (session: unknown, ...rest: unknown[]) =>
+          (value as (...args: unknown[]) => unknown).call(
+            target,
+            bindRoleIds(session),
+            ...rest,
+          );
+      }
+      return value;
+    },
+  });
+}
+
+function validateOptions(value: unknown): RuntimeOptions {
+  if (value === undefined) return {};
+  if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+    throw new Error('playbook options must be an object');
+  }
+  const options: Record<string, string> = {};
+  for (const [key, option] of Object.entries(value)) {
+    if (!ALLOWED_OPTION_KEYS.includes(key)) {
+      throw new Error(
+        \`unknown option "\${key}" (allowed: \${ALLOWED_OPTION_KEYS.join(', ') || 'none'})\`,
+      );
+    }
+    if (typeof option !== 'string' || option === '') {
+      throw new Error(\`option "\${key}" must be a non-empty string\`);
+    }
+    options[key] = option;
+  }
+  return options as RuntimeOptions;
+}
+
+const entry = {
+  id: ${sourceString(spec.basename)},
+  command: ${sourceString(spec.basename)},
+  intent: ${sourceString(spec.intent)},
+  requiredRoleIds: [...REQUIRED_ROLE_IDS],
+  validateOptions,
+  createRuntime(options: { captainOptions?: unknown }) {
+    const validated = validateOptions(options.captainOptions);
+    return withRoleBinding(createPlaybookRuntime(${cwdWiring}));
+  },
+};
+
+export default entry;
+`;
+}
+function sourceString(value) {
+    // Single-quoted source form (the repo's prettier style), derived from the
+    // JSON escape so control characters stay escaped.
+    const json = JSON.stringify(value)
+        .replace(/\u2028/g, '\\u2028')
+        .replace(/\u2029/g, '\\u2029');
+    const inner = json.slice(1, -1).replace(/\\"/g, '"').replace(/'/g, "\\'");
+    return `'${inner}'`;
+}
+//# sourceMappingURL=entry-module.js.map

package/dist/entry-module.js.map

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

package/dist/execution.d.ts

@@ -0,0 +1,71 @@
+/** An opaque link option pair (PIPE-14), structurally compatible with the CLI's LinkOption. */
+export interface LinkOptionPair {
+    name: string;
+    value: string;
+}
+/** What a phase execution is asked to produce: a compile target or a linked artifact. */
+export type ExecuteRequest = {
+    kind: 'compile';
+    /** Path to the phase definition, the semantic source of truth (PHEXEC-2). */
+    definitionPath: string;
+    source: string;
+    target: string;
+    /**
+     * Read-only reference documents the definition tells the executor to
+     * consult — e.g. the entry-phase definition a generic normalize step
+     * rewrites the source toward (DR-013). Protected like definitions.
+     */
+    references?: readonly string[];
+} | {
+    kind: 'link';
+    /** Path to the `link.md` definition, the semantic source of truth (PHEXEC-2). */
+    definitionPath: string;
+    objects: string[];
+    linkTarget: string;
+    options: LinkOptionPair[];
+    linked: string;
+};
+/** Terminal status an executor reports for a phase run. */
+export type ExecutorStatus = 'ok' | 'blocked' | 'error';
+/** The outcome an executor returns, with diagnostics drained for every status. */
+export interface ExecutorResult {
+    status: ExecutorStatus;
+    diagnostics: string[];
+}
+/** Runs one phase or link execution; implemented by the interpreted/compiled executors. */
+export interface PhaseExecutor {
+    run(request: ExecuteRequest, signal: AbortSignal): Promise<ExecutorResult>;
+}
+/** A failure naming the phase, target path, and reasons (PHEXEC-9). */
+export interface FailureReport {
+    phase: string;
+    target: string;
+    reasons: string[];
+}
+/** The result of a generic-checked phase run. */
+export type PhaseResult = {
+    ok: true;
+    target: string;
+    diagnostics: string[];
+} | {
+    ok: false;
+    report: FailureReport;
+};
+/**
+ * Runs a single phase through the execution boundary: generic mechanics only,
+ * plus the DR-003 generic checks and blocked protocol (PHEXEC-1, PHEXEC-4..9).
+ */
+export declare function runPhase(opts: {
+    request: ExecuteRequest;
+    phase: string;
+    targetExt: string;
+    executor: PhaseExecutor;
+    /** Other chain definition files to protect; the executing phase's is always protected. */
+    definitions?: readonly string[];
+    /** Re-checks that the pipeline chain still infers; throws when it no longer does (PHEXEC-5). */
+    revalidate?: () => void | Promise<void>;
+    signal?: AbortSignal;
+}): Promise<PhaseResult>;
+/** Renders a failure report as a multi-line diagnostic string (PHEXEC-9). */
+export declare function formatFailureReport(report: FailureReport): string;
+//# sourceMappingURL=execution.d.ts.map

package/dist/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../src/execution.ts"],"names":[],"mappings":"AA4BA,+FAA+F;AAC/F,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,yFAAyF;AACzF,MAAM,MAAM,cAAc,GACtB;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,6EAA6E;IAC7E,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEN,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;AAExD,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,2FAA2F;AAC3F,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5E;AAED,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,iDAAiD;AACjD,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,GACnD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC;AAEzC;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,aAAa,CAAC;IACxB,0FAA0F;IAC1F,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,gGAAgG;IAChG,UAAU,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,WAAW,CAAC,CAyDvB;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAMjE"}