@adhamalkhaja/seyola-runtime 0.11.4

package/dist/init/index.js

@@ -0,0 +1,414 @@
+/**
+ * seyola-runtime init — create a Client Alpha workspace.
+ *
+ * Idempotent. Safe to rerun. Never overwrites member-owned folders.
+ *
+ * What it does:
+ *   1. Validate args (workspace + pack paths).
+ *   2. Validate the pack via validate-pack (refuse to init from a broken pack).
+ *   3. Create substrate folders if missing (member-owned, never replace).
+ *   4. Copy the pack into <workspace>/.seyola/pack/ (system-owned, replaceable).
+ *   5. Copy approved skills into <workspace>/.claude/skills/ (system-owned, replaceable).
+ *   6. Write <workspace>/.seyola/version.json (system-owned).
+ *   7. Write <workspace>/.claude/settings.json (system-owned).
+ *   8. Write GETTING-STARTED.md and README.md if missing.
+ *
+ * Approved skills for Client Alpha:
+ *   - linkedin-writer
+ *   - brand-voice
+ *   - audience-profile-builder
+ *   - story-bank-builder
+ *   - seyola-orchestrator (optional, behind --include-orchestrator)
+ *
+ * Member-owned folders the init command MUST NOT overwrite if they exist:
+ *   _foundations, market, clients, runs, output
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, statSync, readdirSync, copyFileSync, rmSync } from "node:fs";
+import { join, resolve, dirname, sep } from "node:path";
+import { validatePack } from "../validate-pack/index.js";
+const APPROVED_SKILLS_BASE = [
+    { name: "linkedin-writer", source: "skills/layer-3/linkedin-writer" },
+    { name: "brand-voice", source: "skills/layer-1/brand-voice" },
+    { name: "audience-profile-builder", source: "skills/layer-1/audience-profile-builder" },
+    { name: "story-bank-builder", source: "skills/layer-1/story-bank-builder" },
+];
+const ORCHESTRATOR_SKILL = { name: "seyola-orchestrator", source: "skills/layer-3/seyola-orchestrator" };
+const MEMBER_OWNED_DIRS = ["_foundations", "market", "market/audience-profiles", "market/language-bank", "clients", "runs", "output"];
+const SYSTEM_OWNED_DIRS = [".seyola", ".seyola/pack", ".claude", ".claude/skills"];
+export async function runInit(args) {
+    const start = Date.now();
+    const workspacePath = resolve(args.workspacePath);
+    const packPath = resolve(args.packPath);
+    const result = {
+        exitCode: 0,
+        status: "success",
+        workspace_path: workspacePath,
+        pack_path: packPath,
+        pack_version: "",
+        runtime_version: readRuntimeVersion(),
+        created: [],
+        preserved: [],
+        warnings: [],
+        errors: [],
+        duration_ms: 0,
+    };
+    if (!existsSync(packPath) || !statSync(packPath).isDirectory()) {
+        result.exitCode = 1;
+        result.status = "failed";
+        result.errors.push({ code: "pack_not_found", message: `--pack '${packPath}' does not exist or is not a directory.` });
+        return finalize(args, result, start);
+    }
+    const manifestPath = join(packPath, "manifests", "universal.pack.json");
+    if (!existsSync(manifestPath)) {
+        result.exitCode = 1;
+        result.status = "failed";
+        result.errors.push({ code: "pack_manifest_missing", message: `Pack manifest not found at ${manifestPath}.` });
+        return finalize(args, result, start);
+    }
+    try {
+        const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+        result.pack_version = manifest.version ?? "unknown";
+    }
+    catch (err) {
+        result.warnings.push({ code: "pack_manifest_read_warning", message: `Could not read pack version: ${err.message}` });
+    }
+    // Preflight: pack must validate clean.
+    const validation = await validatePack({ packPath, json: true });
+    if (validation.exitCode !== 0) {
+        result.exitCode = 1;
+        result.status = "failed";
+        result.errors.push({ code: "pack_validation_failed", message: `Pack at '${packPath}' fails validate-pack. Refusing to init from a broken pack.` });
+        return finalize(args, result, start);
+    }
+    // Create workspace root if missing.
+    ensureDir(workspacePath, result);
+    // Create substrate folders (member-owned). Each is created only if missing.
+    for (const dir of MEMBER_OWNED_DIRS) {
+        const abs = join(workspacePath, dir);
+        if (existsSync(abs)) {
+            result.preserved.push(dir + "/");
+        }
+        else {
+            mkdirSync(abs, { recursive: true });
+            result.created.push(dir + "/");
+        }
+    }
+    // Create system-owned folders. These are always replaced (per distribution model).
+    for (const dir of SYSTEM_OWNED_DIRS) {
+        const abs = join(workspacePath, dir);
+        if (!existsSync(abs)) {
+            mkdirSync(abs, { recursive: true });
+            result.created.push(dir + "/");
+        }
+    }
+    // Copy pack into .seyola/pack/. System-owned: replace if present.
+    // Edge case: if the source --pack already IS the destination .seyola/pack/
+    // (bundle scenario where setup.sh passes the bundled pack), skip the copy
+    // entirely. Otherwise we'd wipe the source before copying and end up with
+    // an empty pack directory.
+    const seyolaPackDest = join(workspacePath, ".seyola", "pack");
+    const samePath = resolve(packPath) === resolve(seyolaPackDest);
+    if (samePath) {
+        if (!existsSync(seyolaPackDest))
+            mkdirSync(seyolaPackDest, { recursive: true });
+        result.preserved.push(".seyola/pack/  (already in place from bundle)");
+    }
+    else {
+        if (existsSync(seyolaPackDest) && !args.force) {
+            rmSync(seyolaPackDest, { recursive: true, force: true });
+            mkdirSync(seyolaPackDest, { recursive: true });
+        }
+        else if (!existsSync(seyolaPackDest)) {
+            mkdirSync(seyolaPackDest, { recursive: true });
+        }
+        copyDir(packPath, seyolaPackDest, {
+            excludeRel: [".git", "node_modules", "dist", "test"],
+        });
+        result.created.push(".seyola/pack/  (copied from " + packPath + ")");
+    }
+    // Approved skills: copy into .claude/skills/. System-owned: replace.
+    const skillsList = [...APPROVED_SKILLS_BASE];
+    if (args.includeOrchestrator)
+        skillsList.push(ORCHESTRATOR_SKILL);
+    const claudeSkillsDir = join(workspacePath, ".claude", "skills");
+    // Wipe any prior approved-skill directories (only the ones we manage).
+    for (const skill of [...APPROVED_SKILLS_BASE, ORCHESTRATOR_SKILL]) {
+        const candidate = join(claudeSkillsDir, skill.name);
+        if (existsSync(candidate)) {
+            rmSync(candidate, { recursive: true, force: true });
+        }
+    }
+    for (const skill of skillsList) {
+        const sourceAbs = join(packPath, skill.source);
+        if (!existsSync(sourceAbs)) {
+            result.warnings.push({
+                code: "approved_skill_missing",
+                message: `Approved skill '${skill.name}' source not found at ${sourceAbs}. Skipping.`,
+            });
+            continue;
+        }
+        const dest = join(claudeSkillsDir, skill.name);
+        mkdirSync(dest, { recursive: true });
+        copyDir(sourceAbs, dest, {});
+        result.created.push(`.claude/skills/${skill.name}/`);
+    }
+    // Write .seyola/version.json. Always rewritten.
+    const versionFile = {
+        workspace_version: "0.1.0",
+        pack_version: result.pack_version,
+        runtime_version: result.runtime_version,
+        bundle_created_at: new Date().toISOString().slice(0, 10),
+        last_updated_at: new Date().toISOString(),
+        update_channel: "alpha",
+        approved_skills: skillsList.map((s) => s.name),
+    };
+    writeFileSync(join(workspacePath, ".seyola", "version.json"), JSON.stringify(versionFile, null, 2) + "\n", "utf8");
+    result.created.push(".seyola/version.json");
+    // Write .claude/settings.json. Always rewritten. Use POSIX-style forward slashes
+    // because Bash on Windows strips backslash escapes from unquoted args.
+    const posixWorkspace = workspacePath.split(sep).join("/");
+    const posixPack = (posixWorkspace + "/.seyola/pack").replace(/\\/g, "/");
+    const settings = {
+        env: {
+            SEYOLA_PACK_PATH: posixPack,
+            SEYOLA_WORKSPACE_PATH: posixWorkspace,
+        },
+        permissions: {
+            allow: [
+                "Bash(seyola-runtime:*)",
+                "Read(.seyola/**)",
+            ],
+        },
+    };
+    writeFileSync(join(workspacePath, ".claude", "settings.json"), JSON.stringify(settings, null, 2) + "\n", "utf8");
+    result.created.push(".claude/settings.json");
+    // README.md and GETTING-STARTED.md — only write if missing (member can edit).
+    const readmePath = join(workspacePath, "README.md");
+    if (!existsSync(readmePath)) {
+        writeFileSync(readmePath, defaultReadme(result.pack_version, result.runtime_version), "utf8");
+        result.created.push("README.md");
+    }
+    else {
+        result.preserved.push("README.md");
+    }
+    const gettingStartedPath = join(workspacePath, "GETTING-STARTED.md");
+    if (!existsSync(gettingStartedPath)) {
+        writeFileSync(gettingStartedPath, defaultGettingStarted(), "utf8");
+        result.created.push("GETTING-STARTED.md");
+    }
+    else {
+        result.preserved.push("GETTING-STARTED.md");
+    }
+    return finalize(args, result, start);
+}
+function ensureDir(path, result) {
+    if (!existsSync(path)) {
+        mkdirSync(path, { recursive: true });
+        result.created.push(path + "/  (created workspace root)");
+    }
+}
+function copyDir(src, dest, opts) {
+    const exclude = new Set(opts.excludeRel ?? []);
+    if (!existsSync(dest))
+        mkdirSync(dest, { recursive: true });
+    const entries = readdirSync(src, { withFileTypes: true });
+    for (const entry of entries) {
+        if (exclude.has(entry.name))
+            continue;
+        const s = join(src, entry.name);
+        const d = join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDir(s, d, opts);
+        }
+        else if (entry.isFile()) {
+            mkdirSync(dirname(d), { recursive: true });
+            copyFileSync(s, d);
+        }
+    }
+}
+function readRuntimeVersion() {
+    try {
+        const here = dirname(new URL(import.meta.url).pathname.replace(/^\/([A-Za-z]:)/, "$1"));
+        for (const candidate of [resolve(here, "../../package.json"), resolve(here, "../../../package.json")]) {
+            try {
+                const pkg = JSON.parse(readFileSync(candidate, "utf8"));
+                if (pkg.version)
+                    return pkg.version;
+            }
+            catch {
+                // try next
+            }
+        }
+    }
+    catch {
+        // fall through
+    }
+    return "unknown";
+}
+function defaultReadme(packVersion, runtimeVersion) {
+    return `# Seyola — Client Alpha Workspace
+
+This is your Seyola workspace. Open this folder in your terminal, run \`claude\`, and use the slash commands documented in \`GETTING-STARTED.md\`.
+
+- Pack version: ${packVersion}
+- Runtime version: ${runtimeVersion}
+- Bundle channel: alpha
+
+For step-by-step instructions, see \`GETTING-STARTED.md\`.
+
+To check your workspace is healthy at any time:
+
+\`\`\`
+seyola-runtime doctor --workspace .
+\`\`\`
+`;
+}
+function defaultGettingStarted() {
+    return `# Getting Started with Seyola
+
+Welcome. This folder is your Seyola workspace. Everything you create stays here.
+
+## What you need first
+
+- Claude Code installed (https://claude.com/claude-code).
+- A Claude subscription (Max recommended for content workflows).
+- This folder open in your terminal.
+
+## Step-by-step (first run)
+
+### Step 1: Open this folder
+
+\`\`\`
+cd <path-to-this-folder>
+\`\`\`
+
+### Step 2: Run Claude Code
+
+\`\`\`
+claude
+\`\`\`
+
+Claude Code will pick up the slash commands available in this workspace.
+
+### Step 3: Build your voice profile
+
+\`\`\`
+/brand-voice
+\`\`\`
+
+Interactive interview, ~30 minutes. Builds \`_foundations/voice-profile.md\`. Every drafting workflow reads this — running it first matters.
+
+### Step 4: Build your audience profile
+
+\`\`\`
+/audience-profile-builder
+\`\`\`
+
+Interactive, ~20 minutes. One profile per session. Stored under \`market/audience-profiles/\`.
+
+### Step 5: Build your story bank
+
+\`\`\`
+/story-bank-builder
+\`\`\`
+
+Interactive, ~30-45 minutes. Surfaces 5-15 signature stories. Stored at \`_foundations/story-bank.md\`.
+
+### Step 6: Write a LinkedIn post
+
+\`\`\`
+/linkedin-writer
+\`\`\`
+
+Paste an idea or topic. The runtime drafts ONE post in your voice using the Hell-Heaven-Bridge structure. Output lands under \`runs/run-YYYY-MM-DD-li<NN>/\` plus a final exported copy under \`output/socials/\`.
+
+## What gets saved where
+
+| Folder | What lives there |
+|---|---|
+| \`_foundations/\` | Your voice profile, story bank. Member-owned. Never overwritten on update. |
+| \`market/\` | Audience profiles, language bank. Member-owned. |
+| \`clients/\` | Per-client engagement folders (proposals, calls, deliverables). Member-owned. |
+| \`runs/\` | Each run of a workflow gets its own folder with TaskSpec, derivation records, and outputs. Member-owned. |
+| \`output/\` | Final exported deliverables ready to ship. Member-owned. |
+| \`.seyola/\` | System parts (pack, runtime version pointer). Replaced on update. Do not edit. |
+| \`.claude/\` | Slash commands and settings. Regenerated on update. Do not edit. |
+
+## Health check
+
+If something feels off, run:
+
+\`\`\`
+seyola-runtime doctor --workspace .
+\`\`\`
+
+It surfaces any missing parts (Claude Code not installed, pack invalid, missing voice profile, etc.).
+
+## What to do if Claude Code is not installed or authenticated
+
+1. Install Claude Code from the official site.
+2. Run \`claude\` once and complete the authentication flow.
+3. Verify by running \`claude --version\` (any non-zero output means you're authenticated).
+4. Come back to this folder and start at Step 2.
+
+## Folders you own (never overwritten on update)
+
+\`_foundations/\`, \`market/\`, \`clients/\`, \`runs/\`, \`output/\` belong to you. Updates only touch \`.seyola/\` and \`.claude/\`. If you store anything important, put it under one of the member-owned folders.
+
+## Slash commands available in this alpha
+
+- \`/brand-voice\`
+- \`/audience-profile-builder\`
+- \`/story-bank-builder\`
+- \`/linkedin-writer\`
+
+That's the complete loop for the alpha. More workflows ship in later releases.
+`;
+}
+function finalize(args, result, start) {
+    result.duration_ms = Date.now() - start;
+    if (args.json) {
+        process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+    }
+    else {
+        process.stderr.write(formatHuman(result));
+    }
+    return result;
+}
+function formatHuman(result) {
+    const lines = [];
+    lines.push("");
+    lines.push(`seyola-runtime init: status=${result.status}, exitCode=${result.exitCode}`);
+    lines.push(`  workspace: ${result.workspace_path}`);
+    lines.push(`  pack:      ${result.pack_path}`);
+    lines.push(`  pack_version:    ${result.pack_version}`);
+    lines.push(`  runtime_version: ${result.runtime_version}`);
+    lines.push(`  duration:        ${result.duration_ms}ms`);
+    if (result.created.length > 0) {
+        lines.push("");
+        lines.push("  created:");
+        for (const c of result.created)
+            lines.push(`    + ${c}`);
+    }
+    if (result.preserved.length > 0) {
+        lines.push("");
+        lines.push("  preserved (member-owned, untouched):");
+        for (const p of result.preserved)
+            lines.push(`    = ${p}`);
+    }
+    if (result.warnings.length > 0) {
+        lines.push("");
+        lines.push("  warnings:");
+        for (const w of result.warnings)
+            lines.push(`    [${w.code}] ${w.message}`);
+    }
+    if (result.errors.length > 0) {
+        lines.push("");
+        lines.push("  errors:");
+        for (const e of result.errors)
+            lines.push(`    [${e.code}] ${e.message}`);
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+//# sourceMappingURL=index.js.map

package/dist/init/index.js.map

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

package/dist/lib/ajvSetup.d.ts

@@ -0,0 +1,30 @@
+import Ajv2020 from "ajv/dist/2020.js";
+import type { ValidateFunction, ErrorObject } from "ajv";
+/**
+ * Configures an Ajv instance for draft-2020-12 schemas with the relaxed
+ * settings the Seyola contracts require:
+ *
+ * - strict: false because our schemas use custom x-seyola-* keywords that
+ *   Ajv would otherwise reject as unknown.
+ * - validateFormats: true to enforce date / date-time formats.
+ * - $id schemes like "seyola://harness/task-spec/1.0.0" are allowed —
+ *   Ajv's $id validation is permissive about scheme.
+ */
+export declare function makeAjv(): Ajv2020;
+/**
+ * Compiles a schema. Returns either the validator or a structured error.
+ * Never throws.
+ */
+export interface CompileSuccess {
+    ok: true;
+    validate: ValidateFunction;
+}
+export interface CompileFailure {
+    ok: false;
+    message: string;
+}
+export type CompileResult = CompileSuccess | CompileFailure;
+export declare function compileSchema(ajv: Ajv2020, schema: unknown): CompileResult;
+/** Formats Ajv error objects into one human-readable line each. */
+export declare function formatAjvErrors(errors: ErrorObject[] | null | undefined): string[];
+//# sourceMappingURL=ajvSetup.d.ts.map

package/dist/lib/ajvSetup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ajvSetup.d.ts","sourceRoot":"","sources":["../../src/lib/ajvSetup.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,kBAAkB,CAAC;AAEvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAEzD;;;;;;;;;GASG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAQjC;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,IAAI,CAAC;IACT,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,KAAK,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,cAAc,CAAC;AAE5D,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,aAAa,CAU1E;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAOlF"}

package/dist/lib/ajvSetup.js

@@ -0,0 +1,44 @@
+import Ajv2020 from "ajv/dist/2020.js";
+import addFormats from "ajv-formats";
+/**
+ * Configures an Ajv instance for draft-2020-12 schemas with the relaxed
+ * settings the Seyola contracts require:
+ *
+ * - strict: false because our schemas use custom x-seyola-* keywords that
+ *   Ajv would otherwise reject as unknown.
+ * - validateFormats: true to enforce date / date-time formats.
+ * - $id schemes like "seyola://harness/task-spec/1.0.0" are allowed —
+ *   Ajv's $id validation is permissive about scheme.
+ */
+export function makeAjv() {
+    const ajv = new Ajv2020({
+        strict: false,
+        allErrors: true,
+        allowUnionTypes: true,
+    });
+    addFormats(ajv);
+    return ajv;
+}
+export function compileSchema(ajv, schema) {
+    try {
+        const validate = ajv.compile(schema);
+        return { ok: true, validate };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            message: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/** Formats Ajv error objects into one human-readable line each. */
+export function formatAjvErrors(errors) {
+    if (!errors || errors.length === 0)
+        return [];
+    return errors.map((e) => {
+        const path = e.instancePath || "(root)";
+        const params = e.params ? ` ${JSON.stringify(e.params)}` : "";
+        return `${path} ${e.message ?? ""}${params}`;
+    });
+}
+//# sourceMappingURL=ajvSetup.js.map

package/dist/lib/ajvSetup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ajvSetup.js","sourceRoot":"","sources":["../../src/lib/ajvSetup.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,kBAAkB,CAAC;AACvC,OAAO,UAAU,MAAM,aAAa,CAAC;AAGrC;;;;;;;;;GASG;AACH,MAAM,UAAU,OAAO;IACrB,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC;QACtB,MAAM,EAAE,KAAK;QACb,SAAS,EAAE,IAAI;QACf,eAAe,EAAE,IAAI;KACtB,CAAC,CAAC;IACH,UAAU,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,GAAG,CAAC;AACb,CAAC;AAkBD,MAAM,UAAU,aAAa,CAAC,GAAY,EAAE,MAAe;IACzD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAgB,CAAC,CAAC;QAC/C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SAC1D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,eAAe,CAAC,MAAwC;IACtE,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACtB,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,IAAI,QAAQ,CAAC;QACxC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,OAAO,GAAG,IAAI,IAAI,CAAC,CAAC,OAAO,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/loadJson.d.ts

@@ -0,0 +1,21 @@
+export interface LoadedJson<T = unknown> {
+    ok: true;
+    path: string;
+    data: T;
+}
+export interface LoadJsonError {
+    ok: false;
+    path: string;
+    code: "file_not_found" | "read_error" | "parse_error";
+    message: string;
+}
+export type LoadJsonResult<T = unknown> = LoadedJson<T> | LoadJsonError;
+/**
+ * Reads a JSON file, parses it, and attaches the source path to any error
+ * so downstream validators can point users at the offending file.
+ *
+ * Never throws. Returns a discriminated union so callers handle failure
+ * explicitly.
+ */
+export declare function loadJson<T = unknown>(absolutePath: string): LoadJsonResult<T>;
+//# sourceMappingURL=loadJson.d.ts.map

package/dist/lib/loadJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadJson.d.ts","sourceRoot":"","sources":["../../src/lib/loadJson.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,gBAAgB,GAAG,YAAY,GAAG,aAAa,CAAC;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC;AAExE;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAiC7E"}

package/dist/lib/loadJson.js

@@ -0,0 +1,43 @@
+import { readFileSync, existsSync } from "node:fs";
+/**
+ * Reads a JSON file, parses it, and attaches the source path to any error
+ * so downstream validators can point users at the offending file.
+ *
+ * Never throws. Returns a discriminated union so callers handle failure
+ * explicitly.
+ */
+export function loadJson(absolutePath) {
+    if (!existsSync(absolutePath)) {
+        return {
+            ok: false,
+            path: absolutePath,
+            code: "file_not_found",
+            message: `File not found: ${absolutePath}`,
+        };
+    }
+    let raw;
+    try {
+        raw = readFileSync(absolutePath, "utf8");
+    }
+    catch (err) {
+        return {
+            ok: false,
+            path: absolutePath,
+            code: "read_error",
+            message: `Could not read file: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    try {
+        const data = JSON.parse(raw);
+        return { ok: true, path: absolutePath, data };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            path: absolutePath,
+            code: "parse_error",
+            message: `Invalid JSON: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+//# sourceMappingURL=loadJson.js.map

package/dist/lib/loadJson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadJson.js","sourceRoot":"","sources":["../../src/lib/loadJson.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAiBnD;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAc,YAAoB;IACxD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,mBAAmB,YAAY,EAAE;SAC3C,CAAC;IACJ,CAAC;IAED,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,wBAAwB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SACpF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;QAClC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAChD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,iBAAiB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SAC7E,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/lib/loadYaml.d.ts

@@ -0,0 +1,18 @@
+export interface LoadedYaml<T = unknown> {
+    ok: true;
+    path: string;
+    data: T;
+}
+export interface LoadYamlError {
+    ok: false;
+    path: string;
+    code: "file_not_found" | "read_error" | "parse_error";
+    message: string;
+}
+export type LoadYamlResult<T = unknown> = LoadedYaml<T> | LoadYamlError;
+/**
+ * Reads a YAML file and parses it. Used for TaskSpec and WorkPlan examples.
+ * Returns discriminated union so callers handle failure explicitly.
+ */
+export declare function loadYaml<T = unknown>(absolutePath: string): LoadYamlResult<T>;
+//# sourceMappingURL=loadYaml.d.ts.map

package/dist/lib/loadYaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadYaml.d.ts","sourceRoot":"","sources":["../../src/lib/loadYaml.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,gBAAgB,GAAG,YAAY,GAAG,aAAa,CAAC;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC;AAExE;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAiC7E"}

package/dist/lib/loadYaml.js

@@ -0,0 +1,41 @@
+import { readFileSync, existsSync } from "node:fs";
+import { parse as parseYaml } from "yaml";
+/**
+ * Reads a YAML file and parses it. Used for TaskSpec and WorkPlan examples.
+ * Returns discriminated union so callers handle failure explicitly.
+ */
+export function loadYaml(absolutePath) {
+    if (!existsSync(absolutePath)) {
+        return {
+            ok: false,
+            path: absolutePath,
+            code: "file_not_found",
+            message: `File not found: ${absolutePath}`,
+        };
+    }
+    let raw;
+    try {
+        raw = readFileSync(absolutePath, "utf8");
+    }
+    catch (err) {
+        return {
+            ok: false,
+            path: absolutePath,
+            code: "read_error",
+            message: `Could not read file: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    try {
+        const data = parseYaml(raw);
+        return { ok: true, path: absolutePath, data };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            path: absolutePath,
+            code: "parse_error",
+            message: `Invalid YAML: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+//# sourceMappingURL=loadYaml.js.map

package/dist/lib/loadYaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadYaml.js","sourceRoot":"","sources":["../../src/lib/loadYaml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAiB1C;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAc,YAAoB;IACxD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,mBAAmB,YAAY,EAAE;SAC3C,CAAC;IACJ,CAAC;IAED,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,wBAAwB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SACpF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAM,CAAC;QACjC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAChD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,iBAAiB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SAC7E,CAAC;IACJ,CAAC;AACH,CAAC"}