@tiangong-lca/cli 0.0.1

package/dist/src/lib/process-get.js

@@ -0,0 +1,66 @@
+import { CliError } from './errors.js';
+import { fetchExactOrLatestProcessRow, normalizeSupabaseProcessPayload, requireSupabaseRestRuntime, } from './supabase-rest.js';
+import { createSupabaseDataRuntime } from './supabase-session.js';
+const PROCESS_GET_TIMEOUT_MS = 10_000;
+function normalizeToken(value) {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed ? trimmed : null;
+}
+function nowIso(now = new Date()) {
+    return now.toISOString();
+}
+export async function runProcessGet(options) {
+    const processId = normalizeToken(options.processId);
+    if (!processId) {
+        throw new CliError('Missing required --id value.', {
+            code: 'PROCESS_ID_REQUIRED',
+            exitCode: 2,
+        });
+    }
+    const requestedVersion = normalizeToken(options.version ?? null);
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const timeoutMs = options.timeoutMs ?? PROCESS_GET_TIMEOUT_MS;
+    const runtime = createSupabaseDataRuntime({
+        runtime: requireSupabaseRestRuntime(options.env ?? process.env),
+        fetchImpl,
+        timeoutMs,
+        now: options.now,
+    });
+    const lookup = await fetchExactOrLatestProcessRow({
+        runtime,
+        id: processId,
+        version: requestedVersion,
+        timeoutMs,
+        fetchImpl,
+        fallbackToLatest: requestedVersion !== null,
+    });
+    if (!lookup) {
+        throw new CliError(requestedVersion
+            ? `Could not resolve process dataset for ${processId}@${requestedVersion}.`
+            : `Could not resolve process dataset for ${processId}.`, {
+            code: 'PROCESS_GET_NOT_FOUND',
+            exitCode: 2,
+            details: {
+                process_id: processId,
+                version: requestedVersion,
+            },
+        });
+    }
+    return {
+        schema_version: 1,
+        generated_at_utc: nowIso(options.now),
+        status: 'resolved_remote_process',
+        process_id: lookup.row.id || processId,
+        requested_version: requestedVersion,
+        resolved_version: lookup.row.version || requestedVersion || '',
+        resolution: lookup.resolution,
+        source_url: lookup.sourceUrl,
+        modified_at: lookup.row.modified_at,
+        state_code: lookup.row.state_code,
+        process: normalizeSupabaseProcessPayload(lookup.row.json, requestedVersion ? `${processId}@${requestedVersion}` : processId),
+    };
+}
+//# sourceMappingURL=process-get.js.map

package/dist/src/lib/process-get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-get.js","sourceRoot":"","sources":["../../../src/lib/process-get.ts"],"names":[],"mappings":"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","sourcesContent":["import { CliError } from './errors.js';\nimport type { FetchLike } from './http.js';\nimport {\n  fetchExactOrLatestProcessRow,\n  normalizeSupabaseProcessPayload,\n  requireSupabaseRestRuntime,\n  type SupabaseProcessLookup,\n} from './supabase-rest.js';\nimport { createSupabaseDataRuntime } from './supabase-session.js';\n\ntype JsonObject = Record<string, unknown>;\n\nconst PROCESS_GET_TIMEOUT_MS = 10_000;\n\nexport type RunProcessGetOptions = {\n  processId: string;\n  version?: string | null;\n  env?: NodeJS.ProcessEnv;\n  fetchImpl?: FetchLike;\n  timeoutMs?: number;\n  now?: Date;\n};\n\nexport type ProcessGetReport = {\n  schema_version: 1;\n  generated_at_utc: string;\n  status: 'resolved_remote_process';\n  process_id: string;\n  requested_version: string | null;\n  resolved_version: string;\n  resolution: SupabaseProcessLookup['resolution'];\n  source_url: string;\n  modified_at: string | null;\n  state_code: number | null;\n  process: JsonObject;\n};\n\nfunction normalizeToken(value: string | null | undefined): string | null {\n  if (typeof value !== 'string') {\n    return null;\n  }\n\n  const trimmed = value.trim();\n  return trimmed ? trimmed : null;\n}\n\nfunction nowIso(now: Date = new Date()): string {\n  return now.toISOString();\n}\n\nexport async function runProcessGet(options: RunProcessGetOptions): Promise<ProcessGetReport> {\n  const processId = normalizeToken(options.processId);\n  if (!processId) {\n    throw new CliError('Missing required --id value.', {\n      code: 'PROCESS_ID_REQUIRED',\n      exitCode: 2,\n    });\n  }\n\n  const requestedVersion = normalizeToken(options.version ?? null);\n  const fetchImpl = options.fetchImpl ?? (fetch as FetchLike);\n  const timeoutMs = options.timeoutMs ?? PROCESS_GET_TIMEOUT_MS;\n  const runtime = createSupabaseDataRuntime({\n    runtime: requireSupabaseRestRuntime(options.env ?? process.env),\n    fetchImpl,\n    timeoutMs,\n    now: options.now,\n  });\n  const lookup = await fetchExactOrLatestProcessRow({\n    runtime,\n    id: processId,\n    version: requestedVersion,\n    timeoutMs,\n    fetchImpl,\n    fallbackToLatest: requestedVersion !== null,\n  });\n\n  if (!lookup) {\n    throw new CliError(\n      requestedVersion\n        ? `Could not resolve process dataset for ${processId}@${requestedVersion}.`\n        : `Could not resolve process dataset for ${processId}.`,\n      {\n        code: 'PROCESS_GET_NOT_FOUND',\n        exitCode: 2,\n        details: {\n          process_id: processId,\n          version: requestedVersion,\n        },\n      },\n    );\n  }\n\n  return {\n    schema_version: 1,\n    generated_at_utc: nowIso(options.now),\n    status: 'resolved_remote_process',\n    process_id: lookup.row.id || processId,\n    requested_version: requestedVersion,\n    resolved_version: lookup.row.version || requestedVersion || '',\n    resolution: lookup.resolution,\n    source_url: lookup.sourceUrl,\n    modified_at: lookup.row.modified_at,\n    state_code: lookup.row.state_code,\n    process: normalizeSupabaseProcessPayload(\n      lookup.row.json,\n      requestedVersion ? `${processId}@${requestedVersion}` : processId,\n    ),\n  };\n}\n"]}

package/dist/src/lib/process-publish-build.js

@@ -0,0 +1,451 @@
+import { existsSync, readdirSync } from 'node:fs';
+import path from 'node:path';
+import { readJsonArtifact, writeJsonArtifact } from './artifacts.js';
+import { CliError } from './errors.js';
+import { normalizePublishRequest } from './publish.js';
+import { withStateFileLock } from './state-lock.js';
+function isRecord(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+function nonEmptyString(value) {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const normalized = value.trim();
+    return normalized || null;
+}
+function copyJson(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+function readRequiredJsonObject(filePath, missingCode, invalidCode, label) {
+    if (!existsSync(filePath)) {
+        throw new CliError(`Required process publish artifact not found: ${filePath}`, {
+            code: missingCode,
+            exitCode: 2,
+            details: { label, filePath },
+        });
+    }
+    const value = readJsonArtifact(filePath);
+    if (!isRecord(value)) {
+        throw new CliError(`Expected process publish artifact JSON object: ${filePath}`, {
+            code: invalidCode,
+            exitCode: 2,
+            details: { label, filePath },
+        });
+    }
+    return value;
+}
+function buildLayout(runRoot, runId) {
+    return {
+        runId,
+        runRoot,
+        collectionDir: path.dirname(runRoot),
+        cacheDir: path.join(runRoot, 'cache'),
+        manifestsDir: path.join(runRoot, 'manifests'),
+        reportsDir: path.join(runRoot, 'reports'),
+        processExportsDir: path.join(runRoot, 'exports', 'processes'),
+        sourceExportsDir: path.join(runRoot, 'exports', 'sources'),
+        publishStageDir: path.join(runRoot, 'stage_outputs', '10_publish'),
+        statePath: path.join(runRoot, 'cache', 'process_from_flow_state.json'),
+        handoffSummaryPath: path.join(runRoot, 'cache', 'agent_handoff_summary.json'),
+        runManifestPath: path.join(runRoot, 'manifests', 'run-manifest.json'),
+        invocationIndexPath: path.join(runRoot, 'manifests', 'invocation-index.json'),
+        publishBundlePath: path.join(runRoot, 'stage_outputs', '10_publish', 'publish-bundle.json'),
+        publishRequestPath: path.join(runRoot, 'stage_outputs', '10_publish', 'publish-request.json'),
+        publishIntentPath: path.join(runRoot, 'stage_outputs', '10_publish', 'publish-intent.json'),
+        reportPath: path.join(runRoot, 'reports', 'process-publish-build-report.json'),
+    };
+}
+function resolveLayout(options) {
+    const runId = nonEmptyString(options.runId);
+    const runDir = nonEmptyString(options.runDir);
+    if (!runId && !runDir) {
+        throw new CliError('Missing required --run-id or --run-dir for process publish-build.', {
+            code: 'PROCESS_PUBLISH_RUN_REQUIRED',
+            exitCode: 2,
+        });
+    }
+    const runRoot = runDir
+        ? path.resolve(runDir)
+        : path.resolve('artifacts', 'process_from_flow', runId);
+    const derivedRunId = path.basename(runRoot);
+    if (runDir && runId && derivedRunId !== runId) {
+        throw new CliError(`process publish-build run-id does not match run-dir basename: ${runId} !== ${derivedRunId}`, {
+            code: 'PROCESS_PUBLISH_RUN_ID_MISMATCH',
+            exitCode: 2,
+        });
+    }
+    return buildLayout(runRoot, runId ?? derivedRunId);
+}
+function ensureRunRootExists(layout) {
+    if (!existsSync(layout.runRoot)) {
+        throw new CliError(`process publish-build run root not found: ${layout.runRoot}`, {
+            code: 'PROCESS_PUBLISH_RUN_NOT_FOUND',
+            exitCode: 2,
+        });
+    }
+}
+function readRequiredRunManifest(layout) {
+    const manifest = readRequiredJsonObject(layout.runManifestPath, 'PROCESS_PUBLISH_RUN_MANIFEST_MISSING', 'PROCESS_PUBLISH_RUN_MANIFEST_INVALID', 'run-manifest');
+    const manifestRunId = nonEmptyString(manifest.runId);
+    if (manifestRunId && manifestRunId !== layout.runId) {
+        throw new CliError(`process publish-build run manifest runId mismatch: ${layout.runManifestPath}`, {
+            code: 'PROCESS_PUBLISH_RUN_MANIFEST_MISMATCH',
+            exitCode: 2,
+            details: {
+                expected: layout.runId,
+                actual: manifestRunId,
+            },
+        });
+    }
+    return manifest;
+}
+function readRequiredState(layout) {
+    const state = readRequiredJsonObject(layout.statePath, 'PROCESS_PUBLISH_STATE_MISSING', 'PROCESS_PUBLISH_STATE_INVALID', 'state');
+    const stateRunId = nonEmptyString(state.run_id);
+    if (stateRunId && stateRunId !== layout.runId) {
+        throw new CliError(`process publish-build state run_id mismatch: ${layout.statePath}`, {
+            code: 'PROCESS_PUBLISH_STATE_RUN_ID_MISMATCH',
+            exitCode: 2,
+            details: {
+                expected: layout.runId,
+                actual: stateRunId,
+            },
+        });
+    }
+    return state;
+}
+function readRequiredHandoffSummary(layout) {
+    return readRequiredJsonObject(layout.handoffSummaryPath, 'PROCESS_PUBLISH_HANDOFF_MISSING', 'PROCESS_PUBLISH_HANDOFF_INVALID', 'handoff-summary');
+}
+function readInvocationIndex(layout) {
+    if (!existsSync(layout.invocationIndexPath)) {
+        return {
+            schema_version: 1,
+            invocations: [],
+        };
+    }
+    const value = readJsonArtifact(layout.invocationIndexPath);
+    if (!isRecord(value)) {
+        throw new CliError(`Expected process publish invocation index JSON object: ${layout.invocationIndexPath}`, {
+            code: 'PROCESS_PUBLISH_INVOCATION_INDEX_INVALID',
+            exitCode: 2,
+        });
+    }
+    if (value.invocations === undefined) {
+        return {
+            schema_version: 1,
+            invocations: [],
+        };
+    }
+    if (!Array.isArray(value.invocations)) {
+        throw new CliError(`Expected process publish invocation index to contain an invocations array: ${layout.invocationIndexPath}`, {
+            code: 'PROCESS_PUBLISH_INVOCATION_INDEX_INVALID',
+            exitCode: 2,
+        });
+    }
+    return value;
+}
+function buildStateSummary(state) {
+    return {
+        build_status: nonEmptyString(state.build_status),
+        next_stage: nonEmptyString(state.next_stage),
+        stop_after: nonEmptyString(state.stop_after),
+    };
+}
+function readDatasetArrayFromState(state, key) {
+    if (state[key] === undefined) {
+        return [];
+    }
+    if (!Array.isArray(state[key])) {
+        throw new CliError(`process publish-build expected state.${key} to be an array.`, {
+            code: 'PROCESS_PUBLISH_STATE_DATASETS_INVALID',
+            exitCode: 2,
+            details: { key },
+        });
+    }
+    return state[key].map((item, index) => {
+        if (!isRecord(item)) {
+            throw new CliError(`process publish-build expected state.${key}[${index}] to be an object.`, {
+                code: 'PROCESS_PUBLISH_STATE_DATASETS_INVALID',
+                exitCode: 2,
+                details: { key, index },
+            });
+        }
+        return item;
+    });
+}
+function readDatasetDir(dirPath, label) {
+    if (!existsSync(dirPath)) {
+        return [];
+    }
+    return readdirSync(dirPath)
+        .filter((entry) => entry.endsWith('.json'))
+        .sort()
+        .map((entry) => {
+        const filePath = path.join(dirPath, entry);
+        const value = readJsonArtifact(filePath);
+        if (!isRecord(value)) {
+            throw new CliError(`Expected ${label} export JSON object: ${filePath}`, {
+                code: 'PROCESS_PUBLISH_EXPORT_INVALID',
+                exitCode: 2,
+                details: { label, filePath },
+            });
+        }
+        return value;
+    });
+}
+function collectCanonicalDatasets(layout, state) {
+    const processExports = readDatasetDir(layout.processExportsDir, 'process');
+    const sourceExports = readDatasetDir(layout.sourceExportsDir, 'source');
+    const stateProcesses = readDatasetArrayFromState(state, 'process_datasets');
+    const stateSources = readDatasetArrayFromState(state, 'source_datasets');
+    return {
+        processes: processExports.length > 0 ? processExports : stateProcesses,
+        processOrigin: processExports.length > 0 ? 'exports' : 'state',
+        sources: sourceExports.length > 0 ? sourceExports : stateSources,
+        sourceOrigin: sourceExports.length > 0 ? 'exports' : 'state',
+    };
+}
+function updateStepMarkers(stepMarkers, completedAt) {
+    const markers = isRecord(stepMarkers) ? { ...stepMarkers } : {};
+    markers.publish_handoff_prepared = {
+        status: 'completed',
+        completed_at: completedAt,
+    };
+    return markers;
+}
+function buildUpdatedState(state, layout, counts, datasetOrigins, now) {
+    return {
+        ...state,
+        publish_build_requested_at: now.toISOString(),
+        last_publish_build: {
+            status: 'prepared_local_process_publish_bundle',
+            prepared_at: now.toISOString(),
+            publish_bundle_path: layout.publishBundlePath,
+            publish_request_path: layout.publishRequestPath,
+            publish_intent_path: layout.publishIntentPath,
+            process_count: counts.processes,
+            source_count: counts.sources,
+            relation_count: counts.relations,
+            dataset_origins: datasetOrigins,
+        },
+        step_markers: updateStepMarkers(state.step_markers, now.toISOString()),
+    };
+}
+function buildInvocationIndex(layout, invocationIndex, options, now) {
+    const priorInvocations = Array.isArray(invocationIndex.invocations)
+        ? [...invocationIndex.invocations]
+        : [];
+    const command = ['process', 'publish-build'];
+    if (options.runId) {
+        command.push('--run-id', options.runId);
+    }
+    if (options.runDir) {
+        command.push('--run-dir', options.runDir);
+    }
+    return {
+        ...invocationIndex,
+        schema_version: typeof invocationIndex.schema_version === 'number' ? invocationIndex.schema_version : 1,
+        invocations: [
+            ...priorInvocations,
+            {
+                command,
+                cwd: options.cwd ?? process.cwd(),
+                created_at: now.toISOString(),
+                run_id: layout.runId,
+                run_root: layout.runRoot,
+                report_path: layout.reportPath,
+                publish_request_path: layout.publishRequestPath,
+            },
+        ],
+    };
+}
+function buildPublishBundle(layout, state, runManifest, processes, sources, counts, datasetOrigins, now) {
+    return {
+        generated_at_utc: now.toISOString(),
+        run_id: layout.runId,
+        run_root: layout.runRoot,
+        request_id: nonEmptyString(state.request_id),
+        status: 'prepared_local_process_publish_bundle',
+        counts,
+        dataset_origins: datasetOrigins,
+        source_run: {
+            build_status: nonEmptyString(state.build_status),
+            next_stage: nonEmptyString(state.next_stage),
+            stop_after: nonEmptyString(state.stop_after),
+            run_manifest: copyJson(runManifest),
+        },
+        processes: copyJson(processes),
+        sources: copyJson(sources),
+        relations: [],
+    };
+}
+function buildPublishRequest() {
+    return {
+        inputs: {
+            bundle_paths: ['./publish-bundle.json'],
+        },
+        publish: {
+            commit: false,
+            publish_lifecyclemodels: false,
+            publish_processes: true,
+            publish_sources: true,
+            publish_relations: true,
+            publish_process_build_runs: false,
+            relation_mode: 'local_manifest_only',
+        },
+        out_dir: './publish-run',
+    };
+}
+function buildPublishIntent(layout, counts) {
+    return {
+        ok: true,
+        command: 'publish run',
+        input_path: layout.publishRequestPath,
+        run_id: layout.runId,
+        run_root: layout.runRoot,
+        status: 'prepared_local_process_publish_bundle',
+        process_count: counts.processes,
+        source_count: counts.sources,
+        relation_count: counts.relations,
+    };
+}
+function buildNextActions(layout) {
+    return [
+        `inspect: ${layout.publishBundlePath}`,
+        `inspect: ${layout.publishRequestPath}`,
+        `run: tiangong publish run --input ${layout.publishRequestPath}`,
+        'future: wire publish executors before remote commit mode is expected',
+    ];
+}
+function stateArrayLength(value) {
+    return Array.isArray(value) ? value.length : 0;
+}
+function buildAgentHandoffSummary(layout, state, counts, now) {
+    return {
+        schema_version: 1,
+        generated_at_utc: now.toISOString(),
+        run_id: layout.runId,
+        command: 'process publish-build',
+        flow_path: nonEmptyString(state.flow_path),
+        operation: nonEmptyString(state.operation),
+        stop_after: nonEmptyString(state.stop_after),
+        process_count: counts.processes,
+        matched_exchange_count: stateArrayLength(state.matched_process_exchanges),
+        process_dataset_count: counts.processes,
+        source_dataset_count: counts.sources,
+        remaining_placeholder_refs: stateArrayLength(state.placeholder_resolutions),
+        placeholder_examples: [],
+        publish_summary: {},
+        artifacts: {
+            state_path: layout.statePath,
+            publish_bundle: layout.publishBundlePath,
+            publish_request: layout.publishRequestPath,
+            publish_intent: layout.publishIntentPath,
+            process_update_report: null,
+            flow_auto_build_manifest: null,
+            publish_summary: null,
+            timing_report: null,
+            llm_cost_report: null,
+        },
+        next_actions: buildNextActions(layout),
+        extra: {
+            status: 'prepared_local_process_publish_bundle',
+            request_id: nonEmptyString(state.request_id),
+        },
+    };
+}
+function buildReport(layout, state, counts, datasetOrigins, publishDefaults, now) {
+    return {
+        schema_version: 1,
+        generated_at_utc: now.toISOString(),
+        status: 'prepared_local_process_publish_bundle',
+        run_id: layout.runId,
+        run_root: layout.runRoot,
+        request_id: nonEmptyString(state.request_id),
+        state_summary: buildStateSummary(state),
+        dataset_origins: datasetOrigins,
+        counts,
+        publish_defaults: publishDefaults,
+        files: {
+            state: layout.statePath,
+            handoff_summary: layout.handoffSummaryPath,
+            run_manifest: layout.runManifestPath,
+            invocation_index: layout.invocationIndexPath,
+            publish_bundle: layout.publishBundlePath,
+            publish_request: layout.publishRequestPath,
+            publish_intent: layout.publishIntentPath,
+            report: layout.reportPath,
+        },
+        next_actions: buildNextActions(layout),
+    };
+}
+export async function runProcessPublishBuild(options) {
+    const now = options.now ?? new Date();
+    const layout = resolveLayout(options);
+    ensureRunRootExists(layout);
+    const runManifest = readRequiredRunManifest(layout);
+    readRequiredHandoffSummary(layout);
+    const invocationIndex = readInvocationIndex(layout);
+    return await withStateFileLock(layout.statePath, { reason: 'process-publish-build.prepare_publish', now }, () => {
+        const state = readRequiredState(layout);
+        const datasets = collectCanonicalDatasets(layout, state);
+        if (datasets.processes.length === 0) {
+            throw new CliError('process publish-build run does not contain any process datasets to publish.', {
+                code: 'PROCESS_PUBLISH_PROCESSES_MISSING',
+                exitCode: 2,
+            });
+        }
+        const counts = {
+            processes: datasets.processes.length,
+            sources: datasets.sources.length,
+            relations: 0,
+        };
+        const datasetOrigins = {
+            processes: datasets.processOrigin,
+            sources: datasets.sourceOrigin,
+        };
+        const publishBundle = buildPublishBundle(layout, state, runManifest, datasets.processes, datasets.sources, counts, datasetOrigins, now);
+        const publishRequest = buildPublishRequest();
+        const normalizedPublishRequest = normalizePublishRequest(publishRequest, {
+            requestPath: layout.publishRequestPath,
+            now,
+        });
+        const publishIntent = buildPublishIntent(layout, counts);
+        const updatedState = buildUpdatedState(state, layout, counts, datasetOrigins, now);
+        const updatedInvocationIndex = buildInvocationIndex(layout, invocationIndex, options, now);
+        const handoffSummary = buildAgentHandoffSummary(layout, updatedState, counts, now);
+        const report = buildReport(layout, updatedState, counts, datasetOrigins, {
+            commit: normalizedPublishRequest.publish.commit,
+            publish_lifecyclemodels: normalizedPublishRequest.publish.publish_lifecyclemodels,
+            publish_processes: normalizedPublishRequest.publish.publish_processes,
+            publish_sources: normalizedPublishRequest.publish.publish_sources,
+            publish_relations: normalizedPublishRequest.publish.publish_relations,
+            publish_process_build_runs: normalizedPublishRequest.publish.publish_process_build_runs,
+            relation_mode: normalizedPublishRequest.publish.relation_mode,
+        }, now);
+        writeJsonArtifact(layout.statePath, updatedState);
+        writeJsonArtifact(layout.invocationIndexPath, updatedInvocationIndex);
+        writeJsonArtifact(layout.publishBundlePath, publishBundle);
+        writeJsonArtifact(layout.publishRequestPath, publishRequest);
+        writeJsonArtifact(layout.publishIntentPath, publishIntent);
+        writeJsonArtifact(layout.handoffSummaryPath, handoffSummary);
+        writeJsonArtifact(layout.reportPath, report);
+        return report;
+    });
+}
+export const __testInternals = {
+    buildLayout,
+    resolveLayout,
+    buildStateSummary,
+    readDatasetArrayFromState,
+    collectCanonicalDatasets,
+    buildPublishRequest,
+    buildPublishIntent,
+    buildUpdatedState,
+    buildInvocationIndex,
+    buildNextActions,
+    buildReport,
+};
+//# sourceMappingURL=process-publish-build.js.map

package/dist/src/lib/process-publish-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-publish-build.js","sourceRoot":"","sources":["../../../src/lib/process-publish-build.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readdirSync } from 'node:fs';\nimport path from 'node:path';\nimport { readJsonArtifact, writeJsonArtifact } from './artifacts.js';\nimport { CliError } from './errors.js';\nimport { normalizePublishRequest } from './publish.js';\nimport { withStateFileLock } from './state-lock.js';\n\ntype JsonRecord = Record<string, unknown>;\n\ntype DatasetOrigin = 'exports' | 'state';\n\nexport type ProcessPublishBuildLayout = {\n  runId: string;\n  runRoot: string;\n  collectionDir: string;\n  cacheDir: string;\n  manifestsDir: string;\n  reportsDir: string;\n  processExportsDir: string;\n  sourceExportsDir: string;\n  publishStageDir: string;\n  statePath: string;\n  handoffSummaryPath: string;\n  runManifestPath: string;\n  invocationIndexPath: string;\n  publishBundlePath: string;\n  publishRequestPath: string;\n  publishIntentPath: string;\n  reportPath: string;\n};\n\nexport type ProcessPublishBuildReport = {\n  schema_version: 1;\n  generated_at_utc: string;\n  status: 'prepared_local_process_publish_bundle';\n  run_id: string;\n  run_root: string;\n  request_id: string | null;\n  state_summary: {\n    build_status: string | null;\n    next_stage: string | null;\n    stop_after: string | null;\n  };\n  dataset_origins: {\n    processes: DatasetOrigin;\n    sources: DatasetOrigin;\n  };\n  counts: {\n    processes: number;\n    sources: number;\n    relations: number;\n  };\n  publish_defaults: {\n    commit: boolean;\n    publish_lifecyclemodels: boolean;\n    publish_processes: boolean;\n    publish_sources: boolean;\n    publish_relations: boolean;\n    publish_process_build_runs: boolean;\n    relation_mode: 'local_manifest_only';\n  };\n  files: {\n    state: string;\n    handoff_summary: string;\n    run_manifest: string;\n    invocation_index: string;\n    publish_bundle: string;\n    publish_request: string;\n    publish_intent: string;\n    report: string;\n  };\n  next_actions: string[];\n};\n\nexport type RunProcessPublishBuildOptions = {\n  runId?: string;\n  runDir?: string | null;\n  now?: Date;\n  cwd?: string;\n};\n\nfunction isRecord(value: unknown): value is JsonRecord {\n  return Boolean(value && typeof value === 'object' && !Array.isArray(value));\n}\n\nfunction nonEmptyString(value: unknown): string | null {\n  if (typeof value !== 'string') {\n    return null;\n  }\n\n  const normalized = value.trim();\n  return normalized || null;\n}\n\nfunction copyJson<T>(value: T): T {\n  return JSON.parse(JSON.stringify(value)) as T;\n}\n\nfunction readRequiredJsonObject(\n  filePath: string,\n  missingCode: string,\n  invalidCode: string,\n  label: string,\n): JsonRecord {\n  if (!existsSync(filePath)) {\n    throw new CliError(`Required process publish artifact not found: ${filePath}`, {\n      code: missingCode,\n      exitCode: 2,\n      details: { label, filePath },\n    });\n  }\n\n  const value = readJsonArtifact(filePath);\n  if (!isRecord(value)) {\n    throw new CliError(`Expected process publish artifact JSON object: ${filePath}`, {\n      code: invalidCode,\n      exitCode: 2,\n      details: { label, filePath },\n    });\n  }\n\n  return value;\n}\n\nfunction buildLayout(runRoot: string, runId: string): ProcessPublishBuildLayout {\n  return {\n    runId,\n    runRoot,\n    collectionDir: path.dirname(runRoot),\n    cacheDir: path.join(runRoot, 'cache'),\n    manifestsDir: path.join(runRoot, 'manifests'),\n    reportsDir: path.join(runRoot, 'reports'),\n    processExportsDir: path.join(runRoot, 'exports', 'processes'),\n    sourceExportsDir: path.join(runRoot, 'exports', 'sources'),\n    publishStageDir: path.join(runRoot, 'stage_outputs', '10_publish'),\n    statePath: path.join(runRoot, 'cache', 'process_from_flow_state.json'),\n    handoffSummaryPath: path.join(runRoot, 'cache', 'agent_handoff_summary.json'),\n    runManifestPath: path.join(runRoot, 'manifests', 'run-manifest.json'),\n    invocationIndexPath: path.join(runRoot, 'manifests', 'invocation-index.json'),\n    publishBundlePath: path.join(runRoot, 'stage_outputs', '10_publish', 'publish-bundle.json'),\n    publishRequestPath: path.join(runRoot, 'stage_outputs', '10_publish', 'publish-request.json'),\n    publishIntentPath: path.join(runRoot, 'stage_outputs', '10_publish', 'publish-intent.json'),\n    reportPath: path.join(runRoot, 'reports', 'process-publish-build-report.json'),\n  };\n}\n\nfunction resolveLayout(options: RunProcessPublishBuildOptions): ProcessPublishBuildLayout {\n  const runId = nonEmptyString(options.runId);\n  const runDir = nonEmptyString(options.runDir);\n\n  if (!runId && !runDir) {\n    throw new CliError('Missing required --run-id or --run-dir for process publish-build.', {\n      code: 'PROCESS_PUBLISH_RUN_REQUIRED',\n      exitCode: 2,\n    });\n  }\n\n  const runRoot = runDir\n    ? path.resolve(runDir)\n    : path.resolve('artifacts', 'process_from_flow', runId as string);\n  const derivedRunId = path.basename(runRoot);\n\n  if (runDir && runId && derivedRunId !== runId) {\n    throw new CliError(\n      `process publish-build run-id does not match run-dir basename: ${runId} !== ${derivedRunId}`,\n      {\n        code: 'PROCESS_PUBLISH_RUN_ID_MISMATCH',\n        exitCode: 2,\n      },\n    );\n  }\n\n  return buildLayout(runRoot, runId ?? derivedRunId);\n}\n\nfunction ensureRunRootExists(layout: ProcessPublishBuildLayout): void {\n  if (!existsSync(layout.runRoot)) {\n    throw new CliError(`process publish-build run root not found: ${layout.runRoot}`, {\n      code: 'PROCESS_PUBLISH_RUN_NOT_FOUND',\n      exitCode: 2,\n    });\n  }\n}\n\nfunction readRequiredRunManifest(layout: ProcessPublishBuildLayout): JsonRecord {\n  const manifest = readRequiredJsonObject(\n    layout.runManifestPath,\n    'PROCESS_PUBLISH_RUN_MANIFEST_MISSING',\n    'PROCESS_PUBLISH_RUN_MANIFEST_INVALID',\n    'run-manifest',\n  );\n\n  const manifestRunId = nonEmptyString(manifest.runId);\n  if (manifestRunId && manifestRunId !== layout.runId) {\n    throw new CliError(\n      `process publish-build run manifest runId mismatch: ${layout.runManifestPath}`,\n      {\n        code: 'PROCESS_PUBLISH_RUN_MANIFEST_MISMATCH',\n        exitCode: 2,\n        details: {\n          expected: layout.runId,\n          actual: manifestRunId,\n        },\n      },\n    );\n  }\n\n  return manifest;\n}\n\nfunction readRequiredState(layout: ProcessPublishBuildLayout): JsonRecord {\n  const state = readRequiredJsonObject(\n    layout.statePath,\n    'PROCESS_PUBLISH_STATE_MISSING',\n    'PROCESS_PUBLISH_STATE_INVALID',\n    'state',\n  );\n\n  const stateRunId = nonEmptyString(state.run_id);\n  if (stateRunId && stateRunId !== layout.runId) {\n    throw new CliError(`process publish-build state run_id mismatch: ${layout.statePath}`, {\n      code: 'PROCESS_PUBLISH_STATE_RUN_ID_MISMATCH',\n      exitCode: 2,\n      details: {\n        expected: layout.runId,\n        actual: stateRunId,\n      },\n    });\n  }\n\n  return state;\n}\n\nfunction readRequiredHandoffSummary(layout: ProcessPublishBuildLayout): JsonRecord {\n  return readRequiredJsonObject(\n    layout.handoffSummaryPath,\n    'PROCESS_PUBLISH_HANDOFF_MISSING',\n    'PROCESS_PUBLISH_HANDOFF_INVALID',\n    'handoff-summary',\n  );\n}\n\nfunction readInvocationIndex(layout: ProcessPublishBuildLayout): JsonRecord {\n  if (!existsSync(layout.invocationIndexPath)) {\n    return {\n      schema_version: 1,\n      invocations: [],\n    };\n  }\n\n  const value = readJsonArtifact(layout.invocationIndexPath);\n  if (!isRecord(value)) {\n    throw new CliError(\n      `Expected process publish invocation index JSON object: ${layout.invocationIndexPath}`,\n      {\n        code: 'PROCESS_PUBLISH_INVOCATION_INDEX_INVALID',\n        exitCode: 2,\n      },\n    );\n  }\n\n  if (value.invocations === undefined) {\n    return {\n      schema_version: 1,\n      invocations: [],\n    };\n  }\n\n  if (!Array.isArray(value.invocations)) {\n    throw new CliError(\n      `Expected process publish invocation index to contain an invocations array: ${layout.invocationIndexPath}`,\n      {\n        code: 'PROCESS_PUBLISH_INVOCATION_INDEX_INVALID',\n        exitCode: 2,\n      },\n    );\n  }\n\n  return value;\n}\n\nfunction buildStateSummary(state: JsonRecord): ProcessPublishBuildReport['state_summary'] {\n  return {\n    build_status: nonEmptyString(state.build_status),\n    next_stage: nonEmptyString(state.next_stage),\n    stop_after: nonEmptyString(state.stop_after),\n  };\n}\n\nfunction readDatasetArrayFromState(\n  state: JsonRecord,\n  key: 'process_datasets' | 'source_datasets',\n): JsonRecord[] {\n  if (state[key] === undefined) {\n    return [];\n  }\n\n  if (!Array.isArray(state[key])) {\n    throw new CliError(`process publish-build expected state.${key} to be an array.`, {\n      code: 'PROCESS_PUBLISH_STATE_DATASETS_INVALID',\n      exitCode: 2,\n      details: { key },\n    });\n  }\n\n  return state[key].map((item, index) => {\n    if (!isRecord(item)) {\n      throw new CliError(`process publish-build expected state.${key}[${index}] to be an object.`, {\n        code: 'PROCESS_PUBLISH_STATE_DATASETS_INVALID',\n        exitCode: 2,\n        details: { key, index },\n      });\n    }\n\n    return item;\n  });\n}\n\nfunction readDatasetDir(dirPath: string, label: string): JsonRecord[] {\n  if (!existsSync(dirPath)) {\n    return [];\n  }\n\n  return readdirSync(dirPath)\n    .filter((entry) => entry.endsWith('.json'))\n    .sort()\n    .map((entry) => {\n      const filePath = path.join(dirPath, entry);\n      const value = readJsonArtifact(filePath);\n      if (!isRecord(value)) {\n        throw new CliError(`Expected ${label} export JSON object: ${filePath}`, {\n          code: 'PROCESS_PUBLISH_EXPORT_INVALID',\n          exitCode: 2,\n          details: { label, filePath },\n        });\n      }\n\n      return value;\n    });\n}\n\nfunction collectCanonicalDatasets(\n  layout: ProcessPublishBuildLayout,\n  state: JsonRecord,\n): {\n  processes: JsonRecord[];\n  processOrigin: DatasetOrigin;\n  sources: JsonRecord[];\n  sourceOrigin: DatasetOrigin;\n} {\n  const processExports = readDatasetDir(layout.processExportsDir, 'process');\n  const sourceExports = readDatasetDir(layout.sourceExportsDir, 'source');\n\n  const stateProcesses = readDatasetArrayFromState(state, 'process_datasets');\n  const stateSources = readDatasetArrayFromState(state, 'source_datasets');\n\n  return {\n    processes: processExports.length > 0 ? processExports : stateProcesses,\n    processOrigin: processExports.length > 0 ? 'exports' : 'state',\n    sources: sourceExports.length > 0 ? sourceExports : stateSources,\n    sourceOrigin: sourceExports.length > 0 ? 'exports' : 'state',\n  };\n}\n\nfunction updateStepMarkers(stepMarkers: unknown, completedAt: string): JsonRecord {\n  const markers = isRecord(stepMarkers) ? { ...stepMarkers } : {};\n  markers.publish_handoff_prepared = {\n    status: 'completed',\n    completed_at: completedAt,\n  };\n  return markers;\n}\n\nfunction buildUpdatedState(\n  state: JsonRecord,\n  layout: ProcessPublishBuildLayout,\n  counts: ProcessPublishBuildReport['counts'],\n  datasetOrigins: ProcessPublishBuildReport['dataset_origins'],\n  now: Date,\n): JsonRecord {\n  return {\n    ...state,\n    publish_build_requested_at: now.toISOString(),\n    last_publish_build: {\n      status: 'prepared_local_process_publish_bundle',\n      prepared_at: now.toISOString(),\n      publish_bundle_path: layout.publishBundlePath,\n      publish_request_path: layout.publishRequestPath,\n      publish_intent_path: layout.publishIntentPath,\n      process_count: counts.processes,\n      source_count: counts.sources,\n      relation_count: counts.relations,\n      dataset_origins: datasetOrigins,\n    },\n    step_markers: updateStepMarkers(state.step_markers, now.toISOString()),\n  };\n}\n\nfunction buildInvocationIndex(\n  layout: ProcessPublishBuildLayout,\n  invocationIndex: JsonRecord,\n  options: RunProcessPublishBuildOptions,\n  now: Date,\n): JsonRecord {\n  const priorInvocations = Array.isArray(invocationIndex.invocations)\n    ? [...invocationIndex.invocations]\n    : [];\n  const command = ['process', 'publish-build'];\n\n  if (options.runId) {\n    command.push('--run-id', options.runId);\n  }\n  if (options.runDir) {\n    command.push('--run-dir', options.runDir);\n  }\n\n  return {\n    ...invocationIndex,\n    schema_version:\n      typeof invocationIndex.schema_version === 'number' ? invocationIndex.schema_version : 1,\n    invocations: [\n      ...priorInvocations,\n      {\n        command,\n        cwd: options.cwd ?? process.cwd(),\n        created_at: now.toISOString(),\n        run_id: layout.runId,\n        run_root: layout.runRoot,\n        report_path: layout.reportPath,\n        publish_request_path: layout.publishRequestPath,\n      },\n    ],\n  };\n}\n\nfunction buildPublishBundle(\n  layout: ProcessPublishBuildLayout,\n  state: JsonRecord,\n  runManifest: JsonRecord,\n  processes: JsonRecord[],\n  sources: JsonRecord[],\n  counts: ProcessPublishBuildReport['counts'],\n  datasetOrigins: ProcessPublishBuildReport['dataset_origins'],\n  now: Date,\n): JsonRecord {\n  return {\n    generated_at_utc: now.toISOString(),\n    run_id: layout.runId,\n    run_root: layout.runRoot,\n    request_id: nonEmptyString(state.request_id),\n    status: 'prepared_local_process_publish_bundle',\n    counts,\n    dataset_origins: datasetOrigins,\n    source_run: {\n      build_status: nonEmptyString(state.build_status),\n      next_stage: nonEmptyString(state.next_stage),\n      stop_after: nonEmptyString(state.stop_after),\n      run_manifest: copyJson(runManifest),\n    },\n    processes: copyJson(processes),\n    sources: copyJson(sources),\n    relations: [],\n  };\n}\n\nfunction buildPublishRequest(): JsonRecord {\n  return {\n    inputs: {\n      bundle_paths: ['./publish-bundle.json'],\n    },\n    publish: {\n      commit: false,\n      publish_lifecyclemodels: false,\n      publish_processes: true,\n      publish_sources: true,\n      publish_relations: true,\n      publish_process_build_runs: false,\n      relation_mode: 'local_manifest_only',\n    },\n    out_dir: './publish-run',\n  };\n}\n\nfunction buildPublishIntent(\n  layout: ProcessPublishBuildLayout,\n  counts: ProcessPublishBuildReport['counts'],\n): JsonRecord {\n  return {\n    ok: true,\n    command: 'publish run',\n    input_path: layout.publishRequestPath,\n    run_id: layout.runId,\n    run_root: layout.runRoot,\n    status: 'prepared_local_process_publish_bundle',\n    process_count: counts.processes,\n    source_count: counts.sources,\n    relation_count: counts.relations,\n  };\n}\n\nfunction buildNextActions(layout: ProcessPublishBuildLayout): string[] {\n  return [\n    `inspect: ${layout.publishBundlePath}`,\n    `inspect: ${layout.publishRequestPath}`,\n    `run: tiangong publish run --input ${layout.publishRequestPath}`,\n    'future: wire publish executors before remote commit mode is expected',\n  ];\n}\n\nfunction stateArrayLength(value: unknown): number {\n  return Array.isArray(value) ? value.length : 0;\n}\n\nfunction buildAgentHandoffSummary(\n  layout: ProcessPublishBuildLayout,\n  state: JsonRecord,\n  counts: ProcessPublishBuildReport['counts'],\n  now: Date,\n): JsonRecord {\n  return {\n    schema_version: 1,\n    generated_at_utc: now.toISOString(),\n    run_id: layout.runId,\n    command: 'process publish-build',\n    flow_path: nonEmptyString(state.flow_path),\n    operation: nonEmptyString(state.operation),\n    stop_after: nonEmptyString(state.stop_after),\n    process_count: counts.processes,\n    matched_exchange_count: stateArrayLength(state.matched_process_exchanges),\n    process_dataset_count: counts.processes,\n    source_dataset_count: counts.sources,\n    remaining_placeholder_refs: stateArrayLength(state.placeholder_resolutions),\n    placeholder_examples: [],\n    publish_summary: {},\n    artifacts: {\n      state_path: layout.statePath,\n      publish_bundle: layout.publishBundlePath,\n      publish_request: layout.publishRequestPath,\n      publish_intent: layout.publishIntentPath,\n      process_update_report: null,\n      flow_auto_build_manifest: null,\n      publish_summary: null,\n      timing_report: null,\n      llm_cost_report: null,\n    },\n    next_actions: buildNextActions(layout),\n    extra: {\n      status: 'prepared_local_process_publish_bundle',\n      request_id: nonEmptyString(state.request_id),\n    },\n  };\n}\n\nfunction buildReport(\n  layout: ProcessPublishBuildLayout,\n  state: JsonRecord,\n  counts: ProcessPublishBuildReport['counts'],\n  datasetOrigins: ProcessPublishBuildReport['dataset_origins'],\n  publishDefaults: ProcessPublishBuildReport['publish_defaults'],\n  now: Date,\n): ProcessPublishBuildReport {\n  return {\n    schema_version: 1,\n    generated_at_utc: now.toISOString(),\n    status: 'prepared_local_process_publish_bundle',\n    run_id: layout.runId,\n    run_root: layout.runRoot,\n    request_id: nonEmptyString(state.request_id),\n    state_summary: buildStateSummary(state),\n    dataset_origins: datasetOrigins,\n    counts,\n    publish_defaults: publishDefaults,\n    files: {\n      state: layout.statePath,\n      handoff_summary: layout.handoffSummaryPath,\n      run_manifest: layout.runManifestPath,\n      invocation_index: layout.invocationIndexPath,\n      publish_bundle: layout.publishBundlePath,\n      publish_request: layout.publishRequestPath,\n      publish_intent: layout.publishIntentPath,\n      report: layout.reportPath,\n    },\n    next_actions: buildNextActions(layout),\n  };\n}\n\nexport async function runProcessPublishBuild(\n  options: RunProcessPublishBuildOptions,\n): Promise<ProcessPublishBuildReport> {\n  const now = options.now ?? new Date();\n  const layout = resolveLayout(options);\n  ensureRunRootExists(layout);\n  const runManifest = readRequiredRunManifest(layout);\n  readRequiredHandoffSummary(layout);\n  const invocationIndex = readInvocationIndex(layout);\n\n  return await withStateFileLock(\n    layout.statePath,\n    { reason: 'process-publish-build.prepare_publish', now },\n    () => {\n      const state = readRequiredState(layout);\n      const datasets = collectCanonicalDatasets(layout, state);\n\n      if (datasets.processes.length === 0) {\n        throw new CliError(\n          'process publish-build run does not contain any process datasets to publish.',\n          {\n            code: 'PROCESS_PUBLISH_PROCESSES_MISSING',\n            exitCode: 2,\n          },\n        );\n      }\n\n      const counts: ProcessPublishBuildReport['counts'] = {\n        processes: datasets.processes.length,\n        sources: datasets.sources.length,\n        relations: 0,\n      };\n      const datasetOrigins: ProcessPublishBuildReport['dataset_origins'] = {\n        processes: datasets.processOrigin,\n        sources: datasets.sourceOrigin,\n      };\n      const publishBundle = buildPublishBundle(\n        layout,\n        state,\n        runManifest,\n        datasets.processes,\n        datasets.sources,\n        counts,\n        datasetOrigins,\n        now,\n      );\n      const publishRequest = buildPublishRequest();\n      const normalizedPublishRequest = normalizePublishRequest(publishRequest, {\n        requestPath: layout.publishRequestPath,\n        now,\n      });\n      const publishIntent = buildPublishIntent(layout, counts);\n      const updatedState = buildUpdatedState(state, layout, counts, datasetOrigins, now);\n      const updatedInvocationIndex = buildInvocationIndex(layout, invocationIndex, options, now);\n      const handoffSummary = buildAgentHandoffSummary(layout, updatedState, counts, now);\n      const report = buildReport(\n        layout,\n        updatedState,\n        counts,\n        datasetOrigins,\n        {\n          commit: normalizedPublishRequest.publish.commit,\n          publish_lifecyclemodels: normalizedPublishRequest.publish.publish_lifecyclemodels,\n          publish_processes: normalizedPublishRequest.publish.publish_processes,\n          publish_sources: normalizedPublishRequest.publish.publish_sources,\n          publish_relations: normalizedPublishRequest.publish.publish_relations,\n          publish_process_build_runs: normalizedPublishRequest.publish.publish_process_build_runs,\n          relation_mode: normalizedPublishRequest.publish.relation_mode,\n        },\n        now,\n      );\n\n      writeJsonArtifact(layout.statePath, updatedState);\n      writeJsonArtifact(layout.invocationIndexPath, updatedInvocationIndex);\n      writeJsonArtifact(layout.publishBundlePath, publishBundle);\n      writeJsonArtifact(layout.publishRequestPath, publishRequest);\n      writeJsonArtifact(layout.publishIntentPath, publishIntent);\n      writeJsonArtifact(layout.handoffSummaryPath, handoffSummary);\n      writeJsonArtifact(layout.reportPath, report);\n\n      return report;\n    },\n  );\n}\n\nexport const __testInternals = {\n  buildLayout,\n  resolveLayout,\n  buildStateSummary,\n  readDatasetArrayFromState,\n  collectCanonicalDatasets,\n  buildPublishRequest,\n  buildPublishIntent,\n  buildUpdatedState,\n  buildInvocationIndex,\n  buildNextActions,\n  buildReport,\n};\n"]}