@adhamalkhaja/seyola-runtime 0.11.4

package/LICENSE

@@ -0,0 +1,56 @@
+Proprietary License — seyola-runtime
+
+Copyright (c) 2026 Adham Alkhaja. All rights reserved.
+
+This software (the "Runtime") is published on the npm registry to make
+installation convenient for Seyola members and integrators. Publication on
+npm does not grant any rights of use, copy, modification, distribution, or
+derivation beyond what is explicitly stated below.
+
+PERMITTED USES
+
+You may install and run the Runtime locally on machines you own or operate,
+solely for the purpose of executing official Seyola packs (such as the one
+distributed at https://github.com/seyola-community/seyola-paid) on your own
+behalf or on behalf of a Seyola member account in good standing.
+
+PROHIBITED USES
+
+Without prior written permission from the copyright holder, you may not:
+
+  1. Copy, modify, fork, or redistribute the Runtime source or compiled
+     output, in whole or in part.
+
+  2. Use the Runtime to execute non-Seyola packs, third-party packs, or
+     derivative packs.
+
+  3. Use the Runtime, or any technique it embodies, to build, sell, or
+     distribute a competing product.
+
+  4. Remove, alter, or obscure copyright notices, license notices, or
+     attribution.
+
+  5. Reverse-engineer, decompile, or otherwise attempt to derive the source
+     of any non-source files distributed with this package, except as
+     permitted by applicable law.
+
+  6. Sub-license, rent, lease, or otherwise transfer rights to the Runtime
+     to any third party.
+
+NO WARRANTY
+
+THE RUNTIME IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHOR OR COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING
+FROM, OUT OF, OR IN CONNECTION WITH THE RUNTIME OR THE USE OR OTHER
+DEALINGS IN THE RUNTIME.
+
+CONTACT
+
+For licensing inquiries, partnership requests, or written permission to
+exceed the permitted uses above, contact the copyright holder.
+
+This license may be updated in future versions. The license file shipped
+with each version of the Runtime governs that specific version.

package/README.md

@@ -0,0 +1,87 @@
+# seyola-runtime
+
+Local CLI runtime for the Seyola business operating system. Reads contracts and registries from a Seyola pack and executes them against a runtime backend (Claude Code local subprocess).
+
+This is the engine. The product (Seyola pack + workspace) is at https://github.com/seyola-community/seyola-paid for members.
+
+## Install
+
+```
+npm install -g @adhamalkhaja/seyola-runtime
+```
+
+Requires Node 20 or higher.
+
+Verify:
+
+```
+seyola-runtime --version
+```
+
+## Usage
+
+The runtime is invoked via subcommands. The most common flow for a Seyola member:
+
+```
+# Get a workspace (clone the client bundle).
+git clone https://github.com/seyola-community/seyola-paid.git my-seyola
+cd my-seyola
+
+# Initialize.
+seyola-runtime init --workspace . --pack ./.seyola/pack
+
+# Health check.
+seyola-runtime doctor --workspace .
+
+# Then open Claude Code and use the workflows.
+claude
+```
+
+In Claude Code: `/linkedin-writer`, `/brand-voice`, `/audience-profile-builder`, `/story-bank-builder`.
+
+## Subcommands
+
+| Command | Purpose |
+|---|---|
+| `seyola-runtime --version` | Print the runtime version. |
+| `seyola-runtime --help` | List all subcommands. |
+| `seyola-runtime validate-pack --pack <path>` | Validate a Seyola pack against its registries and schemas. |
+| `seyola-runtime compile-plan --task <path> --pack <path>` | Compile a TaskSpec into a deterministic WorkPlan. |
+| `seyola-runtime run-step --plan <path> --step <id> --backend claude-code-local` | Execute one WorkPlan step. |
+| `seyola-runtime run-plan --task <path> --backend claude-code-local --output-dir <path>` | Execute a full plan as a DAG. |
+| `seyola-runtime init --workspace <path> --pack <path>` | Initialize a Seyola workspace from a pack. |
+| `seyola-runtime doctor --workspace <path>` | Health-check a workspace. |
+| `seyola-runtime bundle --pack <path> --runtime <path> --out <path>` | Generate a Client Alpha distribution bundle. |
+
+Run `seyola-runtime <command> --help` for command-specific options.
+
+## How it works
+
+The runtime reads a Seyola pack (typed registries + skills + schemas), compiles a member's intent (a TaskSpec) into a deterministic WorkPlan, then executes each step against a backend. Today the only supported backend is `claude-code-local`, which spawns the official Claude Code CLI as a subprocess.
+
+The runtime does NOT:
+
+- Host or proxy any AI service.
+- Store, collect, or transmit Claude credentials.
+- Own member substrate (voice profiles, audience profiles, runs).
+- Ship contracts or skill content (those live in the pack).
+
+The pack is the product. The runtime is the executor.
+
+## Requirements
+
+- **Node.js 20+** — https://nodejs.org/
+- **Claude Code** — https://claude.com/claude-code (installed and authenticated). Required for `run-step` and `run-plan`.
+- **A Seyola pack** — typically the workspace cloned from https://github.com/seyola-community/seyola-paid (members only).
+
+The runtime alone, without a pack, has no workflows to execute. Get the pack from the Seyola community.
+
+## License
+
+Proprietary. See LICENSE. Use of this package is subject to the terms in the LICENSE file. The runtime is freely installable; the pack and methodology library are restricted to active Seyola members.
+
+## Support
+
+For installation issues with this runtime: open an issue on the source repository.
+
+For Seyola product questions, methodology, or member access: contact the Seyola community.

package/dist/adapters/claude-code-local/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Claude Code local adapter.
+ *
+ * Spawns Claude Code on the member's machine in non-interactive mode. The
+ * member's Claude Code authentication is used directly. This adapter does
+ * NOT store, collect, or proxy Claude credentials.
+ *
+ * The contract: pass a prompt + an output-schema requirement. Receive a
+ * JSON object the runtime can validate against the schema.
+ *
+ * Implementation strategy for v0.4.x:
+ *   1. Write the assembled prompt to a temp file.
+ *   2. Spawn the configured Claude Code binary with -p (print mode).
+ *   3. Capture stdout.
+ *   4. Extract the first JSON object from the response.
+ *   5. Return raw + parsed.
+ *
+ * The exact Claude Code CLI flag set may differ across releases. The
+ * adapter accepts overrides via:
+ *   - SEYOLA_CLAUDE_BIN env var (default: "claude")
+ *   - SEYOLA_CLAUDE_PRINT_FLAG env var (default: "-p")
+ *
+ * If SEYOLA_RUNTIME_MOCK_CLAUDE=1 is set, the adapter returns a canned
+ * response from the prompt's content for tests.
+ */
+export interface ExecuteArgs {
+    prompt: string;
+    outputSchema: unknown;
+    timeoutSeconds?: number;
+    modelHint?: string;
+}
+export interface ExecuteResult {
+    ok: boolean;
+    raw: string;
+    parsed?: unknown;
+    errors: Array<{
+        code: string;
+        message: string;
+    }>;
+    costEstimate?: {
+        wallClockSeconds: number;
+        modelId?: string;
+    };
+}
+export declare function executeStep(args: ExecuteArgs): Promise<ExecuteResult>;
+interface ExtractSuccess {
+    ok: true;
+    data: unknown;
+}
+interface ExtractFailure {
+    ok: false;
+    message: string;
+}
+/**
+ * Extracts the first JSON object from a string. Tolerates leading/trailing
+ * prose and markdown code fences.
+ */
+export declare function extractJson(raw: string): ExtractSuccess | ExtractFailure;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/claude-code-local/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude-code-local/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AASH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,YAAY,CAAC,EAAE;QACb,gBAAgB,EAAE,MAAM,CAAC;QACzB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAID,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAiF3E;AAED,UAAU,cAAc;IAAG,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;CAAE;AACrD,UAAU,cAAc;IAAG,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;CAAE;AAExD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,cAAc,CA2CxE"}

package/dist/adapters/claude-code-local/index.js

@@ -0,0 +1,270 @@
+/**
+ * Claude Code local adapter.
+ *
+ * Spawns Claude Code on the member's machine in non-interactive mode. The
+ * member's Claude Code authentication is used directly. This adapter does
+ * NOT store, collect, or proxy Claude credentials.
+ *
+ * The contract: pass a prompt + an output-schema requirement. Receive a
+ * JSON object the runtime can validate against the schema.
+ *
+ * Implementation strategy for v0.4.x:
+ *   1. Write the assembled prompt to a temp file.
+ *   2. Spawn the configured Claude Code binary with -p (print mode).
+ *   3. Capture stdout.
+ *   4. Extract the first JSON object from the response.
+ *   5. Return raw + parsed.
+ *
+ * The exact Claude Code CLI flag set may differ across releases. The
+ * adapter accepts overrides via:
+ *   - SEYOLA_CLAUDE_BIN env var (default: "claude")
+ *   - SEYOLA_CLAUDE_PRINT_FLAG env var (default: "-p")
+ *
+ * If SEYOLA_RUNTIME_MOCK_CLAUDE=1 is set, the adapter returns a canned
+ * response from the prompt's content for tests.
+ */
+import { execa } from "execa";
+import { writeFileSync, mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+const DEFAULT_TIMEOUT_SECONDS = 600;
+export async function executeStep(args) {
+    if (process.env.SEYOLA_RUNTIME_MOCK_CLAUDE === "1") {
+        return mockExecute(args);
+    }
+    const claudeBin = process.env.SEYOLA_CLAUDE_BIN ?? "claude";
+    const printFlag = process.env.SEYOLA_CLAUDE_PRINT_FLAG ?? "-p";
+    const timeout = (args.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS) * 1000;
+    // Stage prompt to a temp file. Avoids argv-length and quoting hazards
+    // across platforms.
+    const tempBase = mkdtempSync(join(tmpdir(), "seyola-runtime-"));
+    const promptFile = join(tempBase, "prompt.txt");
+    writeFileSync(promptFile, args.prompt);
+    const start = Date.now();
+    let result;
+    try {
+        result = await execa(claudeBin, [printFlag], {
+            input: args.prompt,
+            timeout,
+            reject: false,
+        });
+    }
+    catch (err) {
+        rmSync(tempBase, { recursive: true, force: true });
+        const e = err;
+        const rawStdout = typeof e.stdout === "string" ? e.stdout : "";
+        return {
+            ok: false,
+            raw: rawStdout,
+            errors: [
+                {
+                    code: "claude_code_spawn_failed",
+                    message: `Failed to invoke '${claudeBin} ${printFlag}': ${e.message}. Set SEYOLA_CLAUDE_BIN and SEYOLA_CLAUDE_PRINT_FLAG if your install differs.`,
+                },
+            ],
+        };
+    }
+    rmSync(tempBase, { recursive: true, force: true });
+    const wallClockSeconds = (Date.now() - start) / 1000;
+    const stdoutString = typeof result.stdout === "string" ? result.stdout : "";
+    const stderrString = typeof result.stderr === "string" ? result.stderr : "";
+    if (result.exitCode !== 0) {
+        return {
+            ok: false,
+            raw: stdoutString,
+            errors: [
+                {
+                    code: "claude_code_nonzero_exit",
+                    message: `Claude Code exited with code ${result.exitCode}. stderr: ${stderrString.slice(0, 500)}`,
+                },
+            ],
+            costEstimate: { wallClockSeconds },
+        };
+    }
+    const parsed = extractJson(stdoutString);
+    if (!parsed.ok) {
+        return {
+            ok: false,
+            raw: stdoutString,
+            errors: [
+                {
+                    code: "no_json_in_response",
+                    message: parsed.message,
+                },
+            ],
+            costEstimate: { wallClockSeconds },
+        };
+    }
+    void args.outputSchema;
+    return {
+        ok: true,
+        raw: stdoutString,
+        parsed: parsed.data,
+        errors: [],
+        costEstimate: { wallClockSeconds },
+    };
+}
+/**
+ * Extracts the first JSON object from a string. Tolerates leading/trailing
+ * prose and markdown code fences.
+ */
+export function extractJson(raw) {
+    if (!raw || raw.length === 0) {
+        return { ok: false, message: "Response was empty." };
+    }
+    // Strip markdown code fences if present.
+    const fenceMatch = raw.match(/```(?:json)?\s*\n([\s\S]*?)\n```/);
+    const candidate = fenceMatch ? fenceMatch[1] : raw;
+    // Find the first { and the last matching }.
+    const firstBrace = candidate.indexOf("{");
+    if (firstBrace < 0) {
+        return { ok: false, message: "No JSON object found in response (no opening brace)." };
+    }
+    // Walk forward tracking brace depth. Honors strings.
+    let depth = 0;
+    let inString = false;
+    let escape = false;
+    let endIndex = -1;
+    for (let i = firstBrace; i < candidate.length; i++) {
+        const ch = candidate[i];
+        if (escape) {
+            escape = false;
+            continue;
+        }
+        if (ch === "\\") {
+            escape = true;
+            continue;
+        }
+        if (ch === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (inString)
+            continue;
+        if (ch === "{")
+            depth++;
+        else if (ch === "}") {
+            depth--;
+            if (depth === 0) {
+                endIndex = i;
+                break;
+            }
+        }
+    }
+    if (endIndex < 0) {
+        return { ok: false, message: "JSON object in response was not balanced (no matching closing brace)." };
+    }
+    const slice = candidate.slice(firstBrace, endIndex + 1);
+    try {
+        const data = JSON.parse(slice);
+        return { ok: true, data };
+    }
+    catch (err) {
+        return { ok: false, message: `JSON.parse failed: ${err instanceof Error ? err.message : String(err)}` };
+    }
+}
+/**
+ * Test/dev helper. Returns a canned requirements-set when
+ * SEYOLA_RUNTIME_MOCK_CLAUDE=1. Detects which output schema is requested by
+ * looking for $type/title hints in the prompt.
+ */
+function mockExecute(args) {
+    // Identify requested output artifact type from the Step Contract block.
+    // The prompt assembled in src/run-step/contextPacket.ts includes a line:
+    //   "output_artifact_type: <name>"
+    const match = /output_artifact_type:\s*([\w-]+)/.exec(args.prompt);
+    const outputType = match ? match[1] : "";
+    if (outputType === "government-technical-proposal") {
+        const proposal = mockGovernmentProposal();
+        return {
+            ok: true,
+            raw: JSON.stringify(proposal, null, 2),
+            parsed: proposal,
+            errors: [],
+            costEstimate: { wallClockSeconds: 0 },
+        };
+    }
+    if (outputType !== "requirements-set") {
+        return {
+            ok: false,
+            raw: "",
+            errors: [{
+                    code: "mock_unsupported",
+                    message: `Mock adapter has no canned response for output_artifact_type='${outputType}'. Supported: requirements-set, government-technical-proposal.`,
+                }],
+        };
+    }
+    const canned = {
+        $type: "requirements-set",
+        $schema_version: "1.0.0",
+        source: {
+            artifact_type: "transcript",
+            ref: "mocked",
+            extracted_at: new Date().toISOString(),
+            extracted_by: "skills/layer-3/transcript-to-requirements/SKILL.md",
+        },
+        summary: "Mocked extraction from a hypothetical transcript. Two requirements captured for test purposes.",
+        requirements: [
+            {
+                id: "REQ-001",
+                statement: "The system must launch before fiscal year end.",
+                must_or_should: "must",
+                category: "timeline",
+                source_evidence: [
+                    { quote: "We have to have something running before fiscal year end.", speaker: "Deputy Minister", confidence: "explicit" },
+                ],
+                open_questions: [],
+                depends_on: [],
+            },
+            {
+                id: "REQ-002",
+                statement: "All client data must remain in the GCC region.",
+                must_or_should: "must",
+                category: "compliance",
+                source_evidence: [
+                    { quote: "Data residency is non-negotiable.", speaker: "IT Director", confidence: "explicit" },
+                ],
+                open_questions: [],
+                depends_on: [],
+            },
+        ],
+        gaps: ["No specific budget number named.", "No security audit requirements stated."],
+        completeness_assessment: "ready_for_drafting",
+    };
+    return {
+        ok: true,
+        raw: JSON.stringify(canned, null, 2),
+        parsed: canned,
+        errors: [],
+        costEstimate: { wallClockSeconds: 0 },
+    };
+}
+function mockGovernmentProposal() {
+    return {
+        $type: "government-technical-proposal",
+        $schema_version: "1.0.0",
+        metadata: {
+            title: "Mocked Pilot Proposal",
+            client: "Ministry of Public Sector",
+            date: "2026-05-12",
+            version: "v1",
+            proposing_entity: "Mock Proposer",
+            principal_proposer: "Mock Proposer",
+            rfp_reference: null,
+        },
+        sections: {
+            executive_summary: "This is a mock executive summary that exists to satisfy the shape contract during testing. It exceeds the 100-character minimum length required by the schema.",
+            problem_statement: "The Ministry needs faster legal document triage. This is a mock problem statement padded to exceed the 100-character minimum length required by the schema for testing.",
+            technical_solution: "The mock proposed system reads the document queue, classifies items by risk, and surfaces urgent items. This is mock content that exists to satisfy the 200-character minimum length required by the shape contract for testing purposes.",
+            implementation_plan: "Phased over six months. Discovery, build, pilot, cutover. This is mock content padded to satisfy the 100-character minimum length.",
+            risks_and_mitigations: "Five risks named with mitigations. Mock content padded to satisfy the 100-character minimum length required by the shape contract.",
+            pricing_or_commercials: "Fixed-fee engagement; mock pricing details for testing purposes only.",
+            compliance_appendix: "Data residency, NDA, indemnity, past performance. Mock content for testing.",
+        },
+        requirements_addressed: [
+            { requirement_id: "REQ-001", addressed_in_sections: ["executive_summary"], treatment: "addressed" },
+        ],
+        draft_state: "draft_v1",
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/claude-code-local/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/claude-code-local/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,KAAK,EAAc,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAsBjC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAiB;IACjD,IAAI,OAAO,CAAC,GAAG,CAAC,0BAA0B,KAAK,GAAG,EAAE,CAAC;QACnD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,QAAQ,CAAC;IAC5D,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,IAAI,CAAC;IAC/D,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,uBAAuB,CAAC,GAAG,IAAI,CAAC;IAExE,sEAAsE;IACtE,oBAAoB;IACpB,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAChD,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAEvC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,MAAmB,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC,SAAS,CAAC,EAAE;YAC3C,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,OAAO;YACP,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,MAAM,CAAC,GAAG,GAAiB,CAAC;QAC5B,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO;YACL,EAAE,EAAE,KAAK;YACT,GAAG,EAAE,SAAS;YACd,MAAM,EAAE;gBACN;oBACE,IAAI,EAAE,0BAA0B;oBAChC,OAAO,EAAE,qBAAqB,SAAS,IAAI,SAAS,MAAM,CAAC,CAAC,OAAO,+EAA+E;iBACnJ;aACF;SACF,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,gBAAgB,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC;IAErD,MAAM,YAAY,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,MAAM,YAAY,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAE5E,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,GAAG,EAAE,YAAY;YACjB,MAAM,EAAE;gBACN;oBACE,IAAI,EAAE,0BAA0B;oBAChC,OAAO,EAAE,gCAAgC,MAAM,CAAC,QAAQ,aAAa,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;iBAClG;aACF;YACD,YAAY,EAAE,EAAE,gBAAgB,EAAE;SACnC,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO;YACL,EAAE,EAAE,KAAK;YACT,GAAG,EAAE,YAAY;YACjB,MAAM,EAAE;gBACN;oBACE,IAAI,EAAE,qBAAqB;oBAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;iBACxB;aACF;YACD,YAAY,EAAE,EAAE,gBAAgB,EAAE;SACnC,CAAC;IACJ,CAAC;IAED,KAAK,IAAI,CAAC,YAAY,CAAC;IACvB,OAAO;QACL,EAAE,EAAE,IAAI;QACR,GAAG,EAAE,YAAY;QACjB,MAAM,EAAE,MAAM,CAAC,IAAI;QACnB,MAAM,EAAE,EAAE;QACV,YAAY,EAAE,EAAE,gBAAgB,EAAE;KACnC,CAAC;AACJ,CAAC;AAKD;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACvD,CAAC;IAED,yCAAyC;IACzC,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAEpD,4CAA4C;IAC5C,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,sDAAsD,EAAE,CAAC;IACxF,CAAC;IAED,qDAAqD;IACrD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC;IAClB,KAAK,IAAI,CAAC,GAAG,UAAU,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnD,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,MAAM,EAAE,CAAC;YAAC,MAAM,GAAG,KAAK,CAAC;YAAC,SAAS;QAAC,CAAC;QACzC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAAC,MAAM,GAAG,IAAI,CAAC;YAAC,SAAS;QAAC,CAAC;QAC7C,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAAC,QAAQ,GAAG,CAAC,QAAQ,CAAC;YAAC,SAAS;QAAC,CAAC;QACnD,IAAI,QAAQ;YAAE,SAAS;QACvB,IAAI,EAAE,KAAK,GAAG;YAAE,KAAK,EAAE,CAAC;aACnB,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACpB,KAAK,EAAE,CAAC;YACR,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAAC,QAAQ,GAAG,CAAC,CAAC;gBAAC,MAAM;YAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,uEAAuE,EAAE,CAAC;IACzG,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,sBAAsB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;IAC1G,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,IAAiB;IACpC,wEAAwE;IACxE,yEAAyE;IACzE,mCAAmC;IACnC,MAAM,KAAK,GAAG,kCAAkC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEzC,IAAI,UAAU,KAAK,+BAA+B,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAG,sBAAsB,EAAE,CAAC;QAC1C,OAAO;YACL,EAAE,EAAE,IAAI;YACR,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,EAAE;YACV,YAAY,EAAE,EAAE,gBAAgB,EAAE,CAAC,EAAE;SACtC,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,KAAK,kBAAkB,EAAE,CAAC;QACtC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,GAAG,EAAE,EAAE;YACP,MAAM,EAAE,CAAC;oBACP,IAAI,EAAE,kBAAkB;oBACxB,OAAO,EAAE,iEAAiE,UAAU,gEAAgE;iBACrJ,CAAC;SACH,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG;QACb,KAAK,EAAE,kBAAkB;QACzB,eAAe,EAAE,OAAO;QACxB,MAAM,EAAE;YACN,aAAa,EAAE,YAAY;YAC3B,GAAG,EAAE,QAAQ;YACb,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACtC,YAAY,EAAE,oDAAoD;SACnE;QACD,OAAO,EAAE,gGAAgG;QACzG,YAAY,EAAE;YACZ;gBACE,EAAE,EAAE,SAAS;gBACb,SAAS,EAAE,gDAAgD;gBAC3D,cAAc,EAAE,MAAM;gBACtB,QAAQ,EAAE,UAAU;gBACpB,eAAe,EAAE;oBACf,EAAE,KAAK,EAAE,2DAA2D,EAAE,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE;iBAC3H;gBACD,cAAc,EAAE,EAAE;gBAClB,UAAU,EAAE,EAAE;aACf;YACD;gBACE,EAAE,EAAE,SAAS;gBACb,SAAS,EAAE,gDAAgD;gBAC3D,cAAc,EAAE,MAAM;gBACtB,QAAQ,EAAE,YAAY;gBACtB,eAAe,EAAE;oBACf,EAAE,KAAK,EAAE,mCAAmC,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE;iBAC/F;gBACD,cAAc,EAAE,EAAE;gBAClB,UAAU,EAAE,EAAE;aACf;SACF;QACD,IAAI,EAAE,CAAC,kCAAkC,EAAE,wCAAwC,CAAC;QACpF,uBAAuB,EAAE,oBAAoB;KAC9C,CAAC;IACF,OAAO;QACL,EAAE,EAAE,IAAI;QACR,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,EAAE;QACV,YAAY,EAAE,EAAE,gBAAgB,EAAE,CAAC,EAAE;KACtC,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB;IAC7B,OAAO;QACL,KAAK,EAAE,+BAA+B;QACtC,eAAe,EAAE,OAAO;QACxB,QAAQ,EAAE;YACR,KAAK,EAAE,uBAAuB;YAC9B,MAAM,EAAE,2BAA2B;YACnC,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,IAAI;YACb,gBAAgB,EAAE,eAAe;YACjC,kBAAkB,EAAE,eAAe;YACnC,aAAa,EAAE,IAAI;SACpB;QACD,QAAQ,EAAE;YACR,iBAAiB,EAAE,gKAAgK;YACnL,iBAAiB,EAAE,yKAAyK;YAC5L,kBAAkB,EAAE,2OAA2O;YAC/P,mBAAmB,EAAE,oIAAoI;YACzJ,qBAAqB,EAAE,oIAAoI;YAC3J,sBAAsB,EAAE,uEAAuE;YAC/F,mBAAmB,EAAE,6EAA6E;SACnG;QACD,sBAAsB,EAAE;YACtB,EAAE,cAAc,EAAE,SAAS,EAAE,qBAAqB,EAAE,CAAC,mBAAmB,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE;SACpG;QACD,WAAW,EAAE,UAAU;KACxB,CAAC;AACJ,CAAC"}

package/dist/bundle/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * seyola-runtime bundle — generate a Client Alpha distribution folder.
+ *
+ * The bundle is meant to be zipped/copied to a friendly tester. The tester
+ * unzips, runs setup.ps1 (or setup.sh), and gets a working workspace.
+ *
+ * What bundle does:
+ *   1. Validate the pack (refuse to bundle from a broken pack).
+ *   2. Create the output directory if missing.
+ *   3. Create empty member-owned folders if missing (preserve if exist).
+ *   4. Copy the pack into <out>/.seyola/pack/.
+ *   5. Drop a runtime-info note at <out>/.seyola/runtime/.
+ *   6. Write <out>/.seyola/version.json with bundle metadata.
+ *   7. Write setup.ps1 (Windows) and setup.sh (mac/linux).
+ *   8. Write README.md and GETTING-STARTED.md only if missing.
+ *
+ * What bundle does NOT do:
+ *   - Run init. Init runs on the tester's machine, via setup script.
+ *   - Touch .claude/ — init creates .claude/skills + .claude/settings.json
+ *     using the TESTER's workspace path.
+ *   - Bundle Node.js or seyola-runtime itself. Setup script checks them
+ *     and fails loudly with install instructions if missing.
+ *
+ * Exposed skills (set when init runs on the tester's side):
+ *   linkedin-writer, brand-voice, audience-profile-builder, story-bank-builder.
+ */
+export interface BundleInputs {
+    packPath: string;
+    outPath: string;
+    bundleName?: string;
+    /** Path to a built seyola-runtime checkout. If omitted, the bundle ships a
+     *  placeholder note and the tester must install the runtime separately.
+     *  When provided, the runtime's package.json + dist/ + package-lock.json are
+     *  copied into <out>/.seyola/runtime/ and the setup script will install
+     *  production deps from there with `npm install --omit=dev`. */
+    runtimePath?: string;
+    json?: boolean;
+}
+export interface BundleResult {
+    exitCode: number;
+    status: "success" | "failed";
+    out_path: string;
+    pack_path: string;
+    pack_version: string;
+    runtime_version: string;
+    bundle_name: string;
+    files_written: string[];
+    runtime_bundled: boolean;
+    warnings: Array<{
+        code: string;
+        message: string;
+    }>;
+    errors: Array<{
+        code: string;
+        message: string;
+    }>;
+    duration_ms: number;
+}
+export declare function runBundle(args: BundleInputs): Promise<BundleResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/bundle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bundle/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;oEAIgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,wBAAsB,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAmKzE"}