@revisium/orchestrator 0.0.0

package/dist/playbook/catalog-loader.js

@@ -0,0 +1,145 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { PlaybookError } from './errors.js';
+import { resolvePathInside } from './source-resolver.js';
+const MODEL_LEVELS = new Set(['cheap', 'standard', 'deep']);
+function asRecord(value, context) {
+    if (value && typeof value === 'object' && !Array.isArray(value))
+        return value;
+    throw new PlaybookError('PLAYBOOK_INVALID_CATALOG', `${context} must be an object`);
+}
+function stringField(record, key, context) {
+    const value = record[key];
+    if (typeof value === 'string' && value.trim() !== '')
+        return value;
+    throw new PlaybookError('PLAYBOOK_INVALID_CATALOG', `${context}.${key} must be a non-empty string`);
+}
+function stringArrayField(record, key, context) {
+    const value = record[key];
+    if (Array.isArray(value) && value.every((v) => typeof v === 'string'))
+        return [...value];
+    throw new PlaybookError('PLAYBOOK_INVALID_CATALOG', `${context}.${key} must be a string array`);
+}
+function optionalRecord(record, key) {
+    const value = record[key];
+    if (value === undefined)
+        return {};
+    if (value && typeof value === 'object' && !Array.isArray(value)) {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            if (typeof v !== 'string') {
+                throw new PlaybookError('PLAYBOOK_INVALID_CATALOG', `${key}.${k} must be a string`);
+            }
+            out[k] = v;
+        }
+        return out;
+    }
+    throw new PlaybookError('PLAYBOOK_INVALID_CATALOG', `${key} must be an object`);
+}
+function assertUniqueIds(records, context) {
+    const seen = new Set();
+    for (const record of records) {
+        if (seen.has(record.id)) {
+            throw new PlaybookError('PLAYBOOK_INVALID_CATALOG', `Duplicate ${context} id: ${record.id}`);
+        }
+        seen.add(record.id);
+    }
+}
+function assertKnownRole(roleIds, roleId, context) {
+    if (roleIds.has(roleId))
+        return;
+    throw new PlaybookError('PLAYBOOK_INVALID_CATALOG', `${context} references unknown role id: ${roleId}`);
+}
+function assertPipelineRoleReferences(roles, pipelines) {
+    const roleIds = new Set(roles.map((role) => role.id));
+    for (const pipeline of pipelines) {
+        for (const roleId of pipeline.requiredRoles) {
+            assertKnownRole(roleIds, roleId, `pipeline ${pipeline.id}.required_roles`);
+        }
+        for (const roleId of pipeline.optionalRoles) {
+            assertKnownRole(roleIds, roleId, `pipeline ${pipeline.id}.optional_roles`);
+        }
+        for (const group of pipeline.alternativeRoles) {
+            for (const roleId of group.roles) {
+                assertKnownRole(roleIds, roleId, `pipeline ${pipeline.id}.alternative_roles.${group.group_id}`);
+            }
+        }
+    }
+}
+function parseRole(value, index, root) {
+    const context = `roles[${index}]`;
+    const record = asRecord(value, context);
+    const modelLevel = stringField(record, 'default_model_level', context);
+    if (!MODEL_LEVELS.has(modelLevel)) {
+        throw new PlaybookError('PLAYBOOK_INVALID_CATALOG', `${context}.default_model_level is invalid: ${modelLevel}`);
+    }
+    const path = stringField(record, 'path', context);
+    const resolvedPath = resolvePathInside(root, path);
+    if (!existsSync(resolvedPath)) {
+        throw new PlaybookError('PLAYBOOK_INVALID_CATALOG', `${context}.path does not exist: ${path}`);
+    }
+    return {
+        id: stringField(record, 'id', context),
+        path,
+        surface: stringField(record, 'surface', context),
+        rights: stringField(record, 'rights', context),
+        defaultModelLevel: modelLevel,
+        wrappers: optionalRecord(record, 'wrappers'),
+    };
+}
+function parseAlternativeRoles(value, context) {
+    if (!Array.isArray(value)) {
+        throw new PlaybookError('PLAYBOOK_INVALID_CATALOG', `${context}.alternative_roles must be an array`);
+    }
+    return value.map((entry, index) => {
+        const record = asRecord(entry, `${context}.alternative_roles[${index}]`);
+        return {
+            group_id: stringField(record, 'group_id', `${context}.alternative_roles[${index}]`),
+            roles: stringArrayField(record, 'roles', `${context}.alternative_roles[${index}]`),
+            resolution: stringField(record, 'resolution', `${context}.alternative_roles[${index}]`),
+        };
+    });
+}
+function parsePipeline(value, index, root) {
+    const context = `pipelines[${index}]`;
+    const record = asRecord(value, context);
+    const path = stringField(record, 'path', context);
+    const resolvedPath = resolvePathInside(root, path);
+    if (!existsSync(resolvedPath)) {
+        throw new PlaybookError('PLAYBOOK_INVALID_CATALOG', `${context}.path does not exist: ${path}`);
+    }
+    return {
+        id: stringField(record, 'id', context),
+        path,
+        triggers: stringArrayField(record, 'triggers', context),
+        requiredRoles: stringArrayField(record, 'required_roles', context),
+        alternativeRoles: parseAlternativeRoles(record.alternative_roles, context),
+        optionalRoles: stringArrayField(record, 'optional_roles', context),
+        routeGates: stringArrayField(record, 'route_gates', context),
+        platformInvocation: stringField(record, 'platform_invocation', context),
+        executionPolicy: record.execution_policy ?? {},
+    };
+}
+function readJsonArray(path, context) {
+    const parsed = JSON.parse(readFileSync(path, 'utf8'));
+    if (Array.isArray(parsed))
+        return parsed;
+    throw new PlaybookError('PLAYBOOK_INVALID_CATALOG', `${context} must be a JSON array`);
+}
+export function loadPlaybookCatalogs(root, manifest) {
+    const rolePath = resolvePathInside(root, manifest.catalogs.roles);
+    const pipelinePath = resolvePathInside(root, manifest.catalogs.pipelines);
+    try {
+        const roles = readJsonArray(rolePath, manifest.catalogs.roles).map((role, index) => parseRole(role, index, root));
+        const pipelines = readJsonArray(pipelinePath, manifest.catalogs.pipelines).map((pipeline, index) => parsePipeline(pipeline, index, root));
+        assertUniqueIds(roles, 'role');
+        assertUniqueIds(pipelines, 'pipeline');
+        assertPipelineRoleReferences(roles, pipelines);
+        return { roles, pipelines };
+    }
+    catch (error) {
+        if (error instanceof PlaybookError)
+            throw error;
+        throw new PlaybookError('PLAYBOOK_INVALID_CATALOG', 'Unable to load playbook catalogs', { error });
+    }
+}
+//# sourceMappingURL=catalog-loader.js.map

package/dist/playbook/catalog-loader.js.map

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

package/dist/playbook/errors.js

@@ -0,0 +1,14 @@
+export class PlaybookError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'PlaybookError';
+    }
+}
+export function isPlaybookError(error) {
+    return error instanceof PlaybookError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/playbook/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/playbook/errors.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,aAAc,SAAQ,KAAK;IAE3B;IAEA;IAHX,YACW,IAAuB,EAChC,OAAe,EACN,OAAiB;QAE1B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJN,SAAI,GAAJ,IAAI,CAAmB;QAEvB,YAAO,GAAP,OAAO,CAAU;QAG1B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,YAAY,aAAa,CAAC;AACxC,CAAC"}

package/dist/playbook/import-mapper.js

@@ -0,0 +1,186 @@
+import { createHash } from 'node:crypto';
+import { PlaybookError } from './errors.js';
+import { composeRolePrompt } from './prompt-composer.js';
+const RUNTIME_NAME_MAP = {
+    analyst: 'analyst',
+    architect: 'architect',
+    developer: 'developer',
+    reviewer: 'reviewer',
+    watcher: 'pr-watcher',
+    'deploy-watcher': 'deploy-watcher',
+    'qa-backend': 'qa-backend',
+    'qa-frontend': 'qa-frontend',
+};
+const ROW_ID_MAX_LENGTH = 64;
+const ROW_ID_HASH_LENGTH = 12;
+const RIGHTS_MAP = {
+    'read-only': { allowedTools: ['Read', 'Grep', 'Glob'], runtimeRunner: 'claude-code' },
+    'write-working-tree': {
+        allowedTools: ['Read', 'Grep', 'Glob', 'Edit', 'Write', 'Bash'],
+        runtimeRunner: 'claude-code',
+    },
+    'qa-live': { allowedTools: ['Read', 'Bash'], runtimeRunner: 'claude-code' },
+    'deploy-read': { allowedTools: ['Read', 'Bash'], runtimeRunner: 'claude-code' },
+    'git-gh': { allowedTools: ['Read', 'Bash'], runtimeRunner: 'script' },
+    'deterministic-script': { allowedTools: ['Read', 'Bash'], runtimeRunner: 'script' },
+};
+function stableStringify(value) {
+    if (Array.isArray(value))
+        return `[${value.map(stableStringify).join(',')}]`;
+    if (value && typeof value === 'object') {
+        const record = value;
+        return `{${Object.keys(record)
+            .sort((left, right) => left.localeCompare(right))
+            .map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`)
+            .join(',')}}`;
+    }
+    return JSON.stringify(value);
+}
+function hash(value) {
+    return createHash('sha256').update(stableStringify(value)).digest('hex');
+}
+function isSafeRowIdChar(value) {
+    const code = value.codePointAt(0) ?? 0;
+    return ((code >= 48 && code <= 57) ||
+        (code >= 65 && code <= 90) ||
+        (code >= 97 && code <= 122) ||
+        value === '_' ||
+        value === '-');
+}
+function trimTrailingHyphens(value) {
+    let end = value.length;
+    while (end > 0 && value[end - 1] === '-')
+        end -= 1;
+    return value.slice(0, end);
+}
+function safeRowIdPart(value) {
+    let safe = '';
+    let pendingHyphen = false;
+    for (const char of value) {
+        if (!isSafeRowIdChar(char) || char === '-') {
+            pendingHyphen = safe.length > 0;
+            continue;
+        }
+        if (pendingHyphen)
+            safe += '-';
+        safe += char;
+        pendingHyphen = false;
+    }
+    return safe || 'item';
+}
+export function scopedImportRowId(playbookId, itemId) {
+    const safePlaybookId = safeRowIdPart(playbookId);
+    const safeItemId = safeRowIdPart(itemId);
+    const raw = `${safePlaybookId}-${safeItemId}`;
+    const needsHash = raw.length > ROW_ID_MAX_LENGTH ||
+        safePlaybookId !== playbookId ||
+        safeItemId !== itemId;
+    if (!needsHash)
+        return raw;
+    const digest = hash({ itemId, playbookId }).slice(0, ROW_ID_HASH_LENGTH);
+    const prefixLength = ROW_ID_MAX_LENGTH - ROW_ID_HASH_LENGTH - 1;
+    const prefix = trimTrailingHyphens(raw.slice(0, prefixLength)) || 'item';
+    return `${prefix}-${digest}`;
+}
+export function runtimeRoleName(roleId) {
+    return RUNTIME_NAME_MAP[roleId] ?? roleId;
+}
+export function mapRights(rights) {
+    const mapped = RIGHTS_MAP[rights];
+    if (!mapped) {
+        throw new PlaybookError('PLAYBOOK_INVALID_CATALOG', `Unsupported playbook role rights: ${rights}`);
+    }
+    return { allowedTools: [...mapped.allowedTools], runtimeRunner: mapped.runtimeRunner };
+}
+function mapRole(root, playbookId, role, now) {
+    const rights = mapRights(role.rights);
+    const requiredPrompt = rights.runtimeRunner !== 'script';
+    const prompt = composeRolePrompt(root, role, requiredPrompt);
+    const runtimeName = runtimeRoleName(role.id);
+    const importedRoleId = scopedImportRowId(playbookId, role.id);
+    return {
+        table: 'roles',
+        rowId: importedRoleId,
+        data: {
+            id: importedRoleId,
+            name: role.id,
+            system_prompt: prompt.prompt || `Code-backed role imported from playbook role ${role.id}.`,
+            model_level: role.defaultModelLevel,
+            effort: role.defaultModelLevel === 'cheap' ? 'low' : 'high',
+            runner: rights.runtimeRunner,
+            allowed_tools: rights.allowedTools,
+            scope_rules: JSON.stringify({
+                surface: role.surface,
+                rights: role.rights,
+                playbook_role_id: role.id,
+                runtime_role_id: runtimeName,
+            }),
+            playbook_id: playbookId,
+            playbook_role_id: role.id,
+            source_path: role.path,
+            source_hash: prompt.sourceHash,
+            surface: role.surface,
+            rights: role.rights,
+            timeout_ms: 0,
+            permission_mode: 'default',
+            updated_at: now,
+        },
+    };
+}
+function mapPipeline(playbookId, pipeline, now) {
+    const importedPipelineId = scopedImportRowId(playbookId, pipeline.id);
+    return {
+        table: 'pipelines',
+        rowId: importedPipelineId,
+        data: {
+            id: importedPipelineId,
+            playbook_id: playbookId,
+            pipeline_id: pipeline.id,
+            path: pipeline.path,
+            triggers: pipeline.triggers,
+            required_roles: pipeline.requiredRoles,
+            alternative_roles_json: JSON.stringify(pipeline.alternativeRoles),
+            optional_roles: pipeline.optionalRoles,
+            route_gates: pipeline.routeGates,
+            platform_invocation: pipeline.platformInvocation,
+            execution_policy_json: JSON.stringify(pipeline.executionPolicy),
+            updated_at: now,
+        },
+    };
+}
+export function mapPlaybookRows(options) {
+    const now = options.now ?? new Date().toISOString();
+    const playbookId = options.nameOverride ?? options.manifest.id;
+    const version = options.versionOverride ?? options.source.version;
+    const catalogHash = hash({
+        manifest: options.manifest,
+        roles: options.catalogs.roles,
+        pipelines: options.catalogs.pipelines,
+    });
+    const playbook = {
+        table: 'playbooks',
+        rowId: playbookId,
+        data: {
+            id: playbookId,
+            name: options.manifest.name,
+            package_name: options.manifest.packageName || options.source.packageName,
+            source: options.source.source,
+            version,
+            schema_version: options.manifest.schemaVersion,
+            manifest_path: 'playbook.json',
+            roles_catalog_path: options.manifest.catalogs.roles,
+            pipelines_catalog_path: options.manifest.catalogs.pipelines,
+            catalog_hash: catalogHash,
+            installed_at: now,
+            updated_at: now,
+        },
+    };
+    return {
+        playbookId,
+        playbook,
+        roles: options.catalogs.roles.map((role) => mapRole(options.root, playbookId, role, now)),
+        pipelines: options.catalogs.pipelines.map((pipeline) => mapPipeline(playbookId, pipeline, now)),
+        catalogHash,
+    };
+}
+//# sourceMappingURL=import-mapper.js.map

package/dist/playbook/import-mapper.js.map

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

package/dist/playbook/manifest.js

@@ -0,0 +1,60 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { PlaybookError } from './errors.js';
+import { resolvePathInside } from './source-resolver.js';
+export const SUPPORTED_PLAYBOOK_SCHEMA_VERSION = 1;
+function asRecord(value, context) {
+    if (value && typeof value === 'object' && !Array.isArray(value))
+        return value;
+    throw new PlaybookError('PLAYBOOK_INVALID_MANIFEST', `${context} must be an object`);
+}
+function requireString(record, key) {
+    const value = record[key];
+    if (typeof value === 'string' && value.trim() !== '')
+        return value;
+    throw new PlaybookError('PLAYBOOK_INVALID_MANIFEST', `playbook.json is missing string field: ${key}`);
+}
+function optionalStringArray(record, key) {
+    const value = record[key];
+    if (value === undefined)
+        return [];
+    if (Array.isArray(value) && value.every((v) => typeof v === 'string'))
+        return [...value];
+    throw new PlaybookError('PLAYBOOK_INVALID_MANIFEST', `playbook.json field ${key} must be a string array`);
+}
+export function parsePlaybookManifest(raw) {
+    const record = asRecord(raw, 'playbook.json');
+    const catalogs = asRecord(record.catalogs, 'playbook.json.catalogs');
+    const schemaVersion = record.schema_version;
+    if (schemaVersion !== SUPPORTED_PLAYBOOK_SCHEMA_VERSION) {
+        throw new PlaybookError('PLAYBOOK_UNSUPPORTED_SCHEMA', `Unsupported playbook schema_version: ${String(schemaVersion)}`, { supported: [SUPPORTED_PLAYBOOK_SCHEMA_VERSION], actual: schemaVersion });
+    }
+    return {
+        id: requireString(record, 'id'),
+        name: requireString(record, 'name'),
+        schemaVersion,
+        packageName: requireString(record, 'package'),
+        catalogs: {
+            roles: requireString(catalogs, 'roles'),
+            pipelines: requireString(catalogs, 'pipelines'),
+        },
+        supportedRuntimes: optionalStringArray(record, 'supported_runtimes'),
+    };
+}
+export function readPlaybookManifest(root) {
+    const manifestPath = join(root, 'playbook.json');
+    try {
+        const manifest = parsePlaybookManifest(JSON.parse(readFileSync(manifestPath, 'utf8')));
+        resolvePathInside(root, manifest.catalogs.roles);
+        resolvePathInside(root, manifest.catalogs.pipelines);
+        return manifest;
+    }
+    catch (error) {
+        if (error instanceof PlaybookError)
+            throw error;
+        throw new PlaybookError('PLAYBOOK_INVALID_MANIFEST', `Unable to read playbook manifest: ${manifestPath}`, {
+            error,
+        });
+    }
+}
+//# sourceMappingURL=manifest.js.map

package/dist/playbook/manifest.js.map

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

package/dist/playbook/playbook-installer.js

@@ -0,0 +1,51 @@
+import { loadPlaybookCatalogs } from './catalog-loader.js';
+import { readPlaybookManifest } from './manifest.js';
+import { mapPlaybookRows } from './import-mapper.js';
+import { resolvePlaybookSource } from './source-resolver.js';
+export class PlaybookInstaller {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async install(options) {
+        const source = resolvePlaybookSource(options.source, this.deps.sourceResolverOptions);
+        const manifest = readPlaybookManifest(source.root);
+        const catalogs = loadPlaybookCatalogs(source.root, manifest);
+        const rows = mapPlaybookRows({
+            root: source.root,
+            source,
+            manifest,
+            catalogs,
+            nameOverride: options.name,
+            versionOverride: options.version,
+        });
+        const allRows = [rows.playbook, ...rows.roles, ...rows.pipelines];
+        const operations = options.dryRun
+            ? allRows.map((row) => ({ action: 'dry-run', table: row.table, rowId: row.rowId }))
+            : [];
+        if (!options.dryRun) {
+            for (const row of allRows) {
+                operations.push(await this.deps.access.upsertRow(row));
+            }
+        }
+        let revisionId;
+        if (options.commit && !options.dryRun) {
+            const commitMessage = `Install playbook ${manifest.name}@${options.version ?? source.version}`;
+            const revision = await this.deps.access.commit(commitMessage);
+            revisionId = typeof revision?.id === 'string' ? revision.id : undefined;
+        }
+        return {
+            playbookId: rows.playbookId,
+            name: manifest.name,
+            version: options.version ?? source.version,
+            source: source.source,
+            roles: rows.roles.length,
+            pipelines: rows.pipelines.length,
+            operations,
+            committed: Boolean(options.commit && !options.dryRun),
+            dryRun: Boolean(options.dryRun),
+            revisionId,
+        };
+    }
+}
+//# sourceMappingURL=playbook-installer.js.map

package/dist/playbook/playbook-installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbook-installer.js","sourceRoot":"","sources":["../../src/playbook/playbook-installer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,eAAe,EAAqB,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAA8B,MAAM,sBAAsB,CAAC;AA6BzF,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,IAA2B;QAA3B,SAAI,GAAJ,IAAI,CAAuB;IAAG,CAAC;IAE5D,KAAK,CAAC,OAAO,CAAC,OAA+B;QAC3C,MAAM,MAAM,GAAG,qBAAqB,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACtF,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM;YACN,QAAQ;YACR,QAAQ;YACR,YAAY,EAAE,OAAO,CAAC,IAAI;YAC1B,eAAe,EAAE,OAAO,CAAC,OAAO;SACjC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAmB,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QAClF,MAAM,UAAU,GAAgC,OAAO,CAAC,MAAM;YAC5D,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;YACnF,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;gBAC1B,UAAU,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QAED,IAAI,UAA8B,CAAC;QACnC,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACtC,MAAM,aAAa,GAAG,oBAAoB,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/F,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YAC9D,UAAU,GAAG,OAAO,QAAQ,EAAE,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,CAAC;QAED,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO;YAC1C,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;YACxB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM;YAChC,UAAU;YACV,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;YACrD,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;YAC/B,UAAU;SACX,CAAC;IACJ,CAAC;CACF"}

package/dist/playbook/prompt-composer.js

@@ -0,0 +1,34 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { createHash } from 'node:crypto';
+import { PlaybookError } from './errors.js';
+import { resolvePathInside } from './source-resolver.js';
+export function stripMarkdownFrontmatter(source) {
+    const lines = source.split(/\r?\n/);
+    if (lines[0] !== '---')
+        return source.trim();
+    const end = lines.findIndex((line, index) => index > 0 && line === '---');
+    if (end === -1)
+        return source.trim();
+    return lines.slice(end + 1).join('\n').trim();
+}
+export function sha256(value) {
+    return createHash('sha256').update(value).digest('hex');
+}
+export function composeRolePrompt(root, role, required = true) {
+    const rolePath = resolvePathInside(root, role.path);
+    if (!existsSync(rolePath)) {
+        if (!required)
+            return { prompt: '', sourceHash: '' };
+        throw new PlaybookError('PLAYBOOK_INVALID_CATALOG', `Role source is missing: ${role.path}`);
+    }
+    const roleBody = stripMarkdownFrontmatter(readFileSync(rolePath, 'utf8'));
+    const referencePath = join(rolePath, '..', 'references', 'core.md');
+    const parts = [roleBody];
+    if (existsSync(referencePath)) {
+        parts.push(stripMarkdownFrontmatter(readFileSync(referencePath, 'utf8')));
+    }
+    const prompt = parts.filter((part) => part.trim() !== '').join('\n\n');
+    return { prompt, sourceHash: sha256(prompt) };
+}
+//# sourceMappingURL=prompt-composer.js.map

package/dist/playbook/prompt-composer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-composer.js","sourceRoot":"","sources":["../../src/playbook/prompt-composer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAOzD,MAAM,UAAU,wBAAwB,CAAC,MAAc;IACrD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK;QAAE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IAC7C,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,KAAK,KAAK,CAAC,CAAC;IAC1E,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACrC,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,IAAuB,EAAE,QAAQ,GAAG,IAAI;IACtF,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QACrD,MAAM,IAAI,aAAa,CAAC,0BAA0B,EAAE,2BAA2B,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,QAAQ,GAAG,wBAAwB,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1E,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;IACpE,MAAM,KAAK,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzB,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AAChD,CAAC"}

package/dist/playbook/source-resolver.js

@@ -0,0 +1,105 @@
+import { createRequire } from 'node:module';
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { dirname, isAbsolute, join, relative, resolve } from 'node:path';
+import os from 'node:os';
+import { PlaybookError } from './errors.js';
+const requireFromHere = createRequire(import.meta.url);
+function expandHome(path) {
+    if (path === '~')
+        return os.homedir();
+    if (path.startsWith('~/'))
+        return join(os.homedir(), path.slice(2));
+    return path;
+}
+function defaultPackageRootResolver(specifier) {
+    return dirname(requireFromHere.resolve(`${specifier}/package.json`));
+}
+function readPackageMetadata(root) {
+    const packagePath = join(root, 'package.json');
+    if (!existsSync(packagePath))
+        return { name: '', version: '' };
+    const parsed = JSON.parse(readFileSync(packagePath, 'utf8'));
+    return {
+        name: typeof parsed.name === 'string' ? parsed.name : '',
+        version: typeof parsed.version === 'string' ? parsed.version : '',
+    };
+}
+function looksLikeRemoteSource(source) {
+    return (source.startsWith('github:') ||
+        source.startsWith('git+') ||
+        source.startsWith('https://') ||
+        /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/.test(source));
+}
+function localSourceIdentity(input, pkg) {
+    if (pkg.name) {
+        const versionSuffix = pkg.version ? `@${pkg.version}` : '';
+        return `local:${pkg.name}${versionSuffix}`;
+    }
+    return `local:${input}`;
+}
+function packageSourceIdentity(input, version) {
+    const versionSuffix = version ? `@${version}` : '';
+    return `npm:${input}${versionSuffix}`;
+}
+function looksLikePath(source) {
+    return source.startsWith('.') || source.startsWith('/') || source.startsWith('~');
+}
+export function assertPathInside(root, target) {
+    const rel = relative(root, target);
+    if (rel === '' || (!rel.startsWith('..') && !isAbsolute(rel)))
+        return;
+    throw new PlaybookError('PLAYBOOK_INVALID_PATH', `Path escapes playbook root: ${target}`, { root, target });
+}
+export function resolvePathInside(root, relativePath) {
+    if (relativePath === '' || isAbsolute(relativePath)) {
+        throw new PlaybookError('PLAYBOOK_INVALID_PATH', `Path must be relative inside playbook root: ${relativePath}`, {
+            root,
+            relativePath,
+        });
+    }
+    const target = resolve(root, relativePath);
+    assertPathInside(root, target);
+    return target;
+}
+export function resolvePlaybookSource(input, options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const packageRootResolver = options.packageRootResolver ?? defaultPackageRootResolver;
+    const localCandidate = resolve(cwd, expandHome(input));
+    if (looksLikePath(input) || (existsSync(localCandidate) && statSync(localCandidate).isDirectory())) {
+        const root = localCandidate;
+        if (!existsSync(root) || !statSync(root).isDirectory()) {
+            throw new PlaybookError('PLAYBOOK_SOURCE_NOT_FOUND', `Playbook source directory not found: ${input}`, { input });
+        }
+        const pkg = readPackageMetadata(root);
+        return {
+            type: 'local',
+            input,
+            root,
+            source: localSourceIdentity(input, pkg),
+            packageName: pkg.name,
+            version: pkg.version,
+        };
+    }
+    if (looksLikeRemoteSource(input) && !input.startsWith('@')) {
+        throw new PlaybookError('PLAYBOOK_SOURCE_NOT_IMPLEMENTED', `Remote playbook sources are not implemented in this slice: ${input}`, { input });
+    }
+    try {
+        const root = packageRootResolver(input);
+        const pkg = readPackageMetadata(root);
+        return {
+            type: 'package',
+            input,
+            root,
+            source: packageSourceIdentity(input, pkg.version),
+            packageName: pkg.name || input,
+            version: pkg.version,
+        };
+    }
+    catch (error) {
+        throw new PlaybookError('PLAYBOOK_SOURCE_NOT_FOUND', `Playbook package not found: ${input}`, {
+            input,
+            error,
+        });
+    }
+}
+//# sourceMappingURL=source-resolver.js.map