@tiangong-lca/cli 0.1.0 → 0.1.2

package/dist/src/lib/flow-regen-product.d.ts

@@ -0,0 +1,431 @@
+import { type FlowRecord, type JsonRecord } from './flow-governance.js';
+import { type SdkValidationEntity } from './tidas-sdk-validation.js';
+export type AutoPatchPolicy = 'disabled' | 'alias-only' | 'alias-or-unique-name';
+export type TidasMode = 'auto' | 'required' | 'skip';
+type PathPart = string | number;
+type LangEntry = {
+    lang: string;
+    text: string;
+};
+type ProcessIdentity = {
+    id: string;
+    version: string;
+    name: string;
+};
+type FlowIndex = {
+    records: FlowRecord[];
+    byUuid: Record<string, FlowRecord[]>;
+    byUuidVersion: Record<string, FlowRecord>;
+    byName: Record<string, FlowRecord[]>;
+};
+type ScanFinding = {
+    process_id: string;
+    process_version: string;
+    process_name: string;
+    exchange_internal_id: string;
+    exchange_direction: unknown;
+    reference_flow_id: string;
+    reference_flow_version: string;
+    reference_flow_text: string;
+    issue_type: string;
+    severity: 'info' | 'warning' | 'error';
+    evidence: JsonRecord;
+};
+type RepairAction = {
+    process_id: string;
+    process_version: string;
+    process_name: string;
+    exchange_internal_id: string;
+    current_flow_id: string;
+    current_flow_version: string;
+    exchange_direction: unknown;
+    exchange_text: string;
+    current_issue_type?: string;
+    auto_patch_policy: AutoPatchPolicy;
+    decision: 'keep_as_is' | 'auto_patch' | 'manual_review';
+    reason: string;
+    target_flow_id?: string;
+    target_flow_version?: string;
+    target_flow_name?: string;
+    target_reference?: JsonRecord;
+    candidate_count?: number;
+    candidate_refs?: Array<Record<string, string>>;
+};
+export type ProcessPatchValidationIssue = JsonRecord & {
+    type: string;
+    severity: 'error';
+};
+export type ProcessPatchValidationResult = {
+    process_id: string;
+    process_version: string;
+    process_name: string;
+    ok: boolean;
+    issues: ProcessPatchValidationIssue[];
+};
+export type ProcessPatchValidationSummary = {
+    patched_process_count: number;
+    passed: number;
+    failed: number;
+    tidas_validation: boolean;
+};
+export type ScanStageFiles = {
+    out_dir: string;
+    emergy_excluded_processes: string;
+    summary: string;
+    findings: string;
+    findings_jsonl: string;
+};
+export type RepairStageFiles = {
+    out_dir: string;
+    plan: string;
+    plan_jsonl: string;
+    manual_review_queue: string;
+    summary: string;
+};
+export type ApplyStageFiles = RepairStageFiles & {
+    patched_processes: string;
+    patch_root: string;
+};
+export type ValidateStageFiles = {
+    out_dir: string;
+    report: string;
+    failures: string;
+};
+export type FlowProcessRefScanSummary = {
+    process_count_before_emergy_exclusion: number;
+    process_count: number;
+    emergy_excluded_process_count: number;
+    exchange_count: number;
+    issue_counts: Record<string, number>;
+    processes_with_issues: number;
+};
+export type FlowProcessFlowRepairSummary = {
+    auto_patch_policy: AutoPatchPolicy;
+    process_count: number;
+    repair_item_count: number;
+    decision_counts: Record<string, number>;
+    patched_process_count: number;
+    process_pool_sync?: JsonRecord;
+};
+type FlowRegenProductFiles = {
+    report: string;
+    scan: ScanStageFiles;
+    repair: RepairStageFiles;
+    apply: ApplyStageFiles | null;
+    validate: ValidateStageFiles | null;
+};
+type FlowRegenProductCounts = {
+    process_count_before_emergy_exclusion: number;
+    process_count: number;
+    emergy_excluded_process_count: number;
+    exchange_count: number;
+    issue_counts: Record<string, number>;
+    processes_with_issues: number;
+    repair_item_count: number;
+    decision_counts: Record<string, number>;
+    patched_process_count: number;
+    validation_passed_count: number | null;
+    validation_failed_count: number | null;
+};
+export type FlowRegenProductReport = {
+    schema_version: 1;
+    generated_at_utc: string;
+    status: 'completed_local_flow_regen_product';
+    mode: 'plan' | 'apply';
+    processes_file: string;
+    scope_flow_files: string[];
+    catalog_flow_files: string[];
+    alias_map_file: string | null;
+    exclude_emergy: boolean;
+    auto_patch_policy: AutoPatchPolicy;
+    process_pool_file: string | null;
+    tidas_mode: TidasMode;
+    out_dir: string;
+    counts: FlowRegenProductCounts;
+    validation: {
+        enabled: boolean;
+        tidas_validation: boolean;
+        ok: boolean | null;
+    };
+    files: FlowRegenProductFiles;
+};
+export type RunFlowRegenProductOptions = {
+    processesFile: string;
+    scopeFlowFiles: string[];
+    catalogFlowFiles?: string[];
+    aliasMapFile?: string | null;
+    outDir: string;
+    excludeEmergy?: boolean;
+    autoPatchPolicy?: AutoPatchPolicy;
+    apply?: boolean;
+    processPoolFile?: string | null;
+    tidasMode?: TidasMode;
+};
+export type RunFlowValidateProcessesOptions = {
+    originalProcessesFile: string;
+    patchedProcessesFile: string;
+    scopeFlowFiles: string[];
+    outDir: string;
+    tidasMode?: TidasMode;
+};
+export type RunFlowScanProcessFlowRefsOptions = {
+    processesFile: string;
+    scopeFlowFiles: string[];
+    catalogFlowFiles?: string[];
+    aliasMapFile?: string | null;
+    excludeEmergy?: boolean;
+    outDir: string;
+};
+export type RunFlowPlanProcessFlowRepairsOptions = {
+    processesFile: string;
+    scopeFlowFiles: string[];
+    aliasMapFile?: string | null;
+    scanFindingsFile?: string | null;
+    autoPatchPolicy?: AutoPatchPolicy;
+    outDir: string;
+};
+export type RunFlowApplyProcessFlowRepairsOptions = {
+    processesFile: string;
+    scopeFlowFiles: string[];
+    aliasMapFile?: string | null;
+    scanFindingsFile?: string | null;
+    autoPatchPolicy?: AutoPatchPolicy;
+    processPoolFile?: string | null;
+    outDir: string;
+};
+export type FlowValidateProcessesReport = {
+    schema_version: 1;
+    generated_at_utc: string;
+    status: 'completed_local_flow_validate_processes';
+    original_processes_file: string;
+    patched_processes_file: string;
+    scope_flow_files: string[];
+    out_dir: string;
+    tidas_mode: TidasMode;
+    summary: ProcessPatchValidationSummary;
+    files: ValidateStageFiles;
+    results: ProcessPatchValidationResult[];
+};
+export type FlowScanProcessFlowRefsReport = {
+    schema_version: 1;
+    generated_at_utc: string;
+    status: 'completed_local_flow_scan_process_flow_refs';
+    processes_file: string;
+    scope_flow_files: string[];
+    catalog_flow_files: string[];
+    alias_map_file: string | null;
+    exclude_emergy: boolean;
+    out_dir: string;
+    summary: FlowProcessRefScanSummary;
+    files: ScanStageFiles;
+};
+export type FlowPlanProcessFlowRepairsReport = {
+    schema_version: 1;
+    generated_at_utc: string;
+    status: 'completed_local_flow_plan_process_flow_repairs';
+    processes_file: string;
+    scope_flow_files: string[];
+    alias_map_file: string | null;
+    scan_findings_file: string | null;
+    auto_patch_policy: AutoPatchPolicy;
+    out_dir: string;
+    summary: FlowProcessFlowRepairSummary;
+    files: RepairStageFiles;
+};
+export type FlowApplyProcessFlowRepairsReport = {
+    schema_version: 1;
+    generated_at_utc: string;
+    status: 'completed_local_flow_apply_process_flow_repairs';
+    processes_file: string;
+    scope_flow_files: string[];
+    alias_map_file: string | null;
+    scan_findings_file: string | null;
+    auto_patch_policy: AutoPatchPolicy;
+    process_pool_file: string | null;
+    out_dir: string;
+    summary: FlowProcessFlowRepairSummary;
+    files: ApplyStageFiles;
+};
+type ProcessSdkModule = {
+    createProcess?: (data?: unknown, validationConfig?: {
+        mode?: 'strict' | 'weak' | 'ignore';
+        throwOnError?: boolean;
+        deepValidation?: boolean;
+    }) => SdkValidationEntity;
+    location?: string;
+};
+type FlowRegenProductDeps = {
+    loadSdkModule?: () => ProcessSdkModule;
+    now?: () => Date;
+};
+type ScanStageResult = {
+    filteredProcesses: JsonRecord[];
+    emergyExcludedProcesses: JsonRecord[];
+    findings: ScanFinding[];
+    summary: FlowProcessRefScanSummary;
+    files: ScanStageFiles;
+};
+type RepairStageResult = {
+    plan: RepairAction[];
+    manualQueue: RepairAction[];
+    summary: FlowProcessFlowRepairSummary;
+    files: RepairStageFiles | ApplyStageFiles;
+    patchedRows: JsonRecord[];
+};
+type ValidateStageResult = {
+    summary: ProcessPatchValidationSummary;
+    results: ProcessPatchValidationResult[];
+    failures: ProcessPatchValidationResult[];
+    files: ValidateStageFiles;
+};
+declare function resolveCliRepoRoot(): string;
+declare function buildSdkCandidates(): string[];
+declare function resolveSdkModuleFromCandidates(requireFn: NodeJS.Require, candidates: string[]): ProcessSdkModule & {
+    location: string;
+};
+declare function resolveLocalSdkModule(): ProcessSdkModule & {
+    location: string;
+};
+declare function assertInputFile(inputFile: string, requiredCode: string, missingCode: string): string;
+declare function assertInputFiles(inputFiles: string[], requiredCode: string, missingCode: string): string[];
+declare function assertOutDir(outDir: string): string;
+declare function readJsonObjectFile(filePath: string, requiredCode: string, missingCode: string, invalidCode: string): JsonRecord;
+declare function processDatasetFromRow(row: JsonRecord): JsonRecord;
+declare function extractProcessIdentity(row: JsonRecord): ProcessIdentity;
+declare function exchangeRecords(processRow: JsonRecord): JsonRecord[];
+declare function extractProcessReferenceExchange(processRow: JsonRecord): JsonRecord | null;
+declare function extractReferenceText(ref: unknown): string;
+declare function extractProcessReferenceFlowRef(processRow: JsonRecord): {
+    flow_id: string;
+    flow_version: string;
+    flow_text: string;
+    exchange_internal_id: string;
+};
+declare function processRowKey(processRow: JsonRecord): string;
+declare function versionKey(version: string): number[];
+declare function compareVersionKeys(left: number[], right: number[]): number;
+declare function processRowSortComparator(left: JsonRecord, right: JsonRecord): number;
+declare function buildFlowIndex(rows: JsonRecord[]): FlowIndex;
+declare function aliasLookup(aliasMap: JsonRecord, flowUuid: string, flowVersion: string | null): JsonRecord | null;
+declare function buildLocalDatasetUri(datasetKind: string, uuidValue: string, version: string): string;
+declare function preserveShortDescriptionShape(existing: unknown, target: JsonRecord): unknown;
+declare function flowReferenceFromRecord(record: FlowRecord): JsonRecord;
+declare function patchedFlowReference(currentRef: unknown, record: FlowRecord): JsonRecord;
+declare function langEntries(value: unknown): LangEntry[];
+declare function textHasEmergyKeyword(text: string): boolean;
+declare function uniqueNonEmptyTexts(values: string[]): string[];
+declare function flowEmergyScopeDecision(row: JsonRecord): JsonRecord;
+declare function processEmergyScopeDecision(processRow: JsonRecord, flowIndex: FlowIndex | null): JsonRecord;
+declare function filterEmergyNamedProcesses(rows: JsonRecord[], flowIndex: FlowIndex | null): {
+    keptRows: JsonRecord[];
+    excludedRows: JsonRecord[];
+};
+declare function classifyExchangeRef(processRow: JsonRecord, exchange: JsonRecord, scopeIndex: FlowIndex, catalogIndex: FlowIndex, aliasMap: JsonRecord): ScanFinding;
+declare function buildFindingMap(findings: ScanFinding[]): Record<string, ScanFinding>;
+declare function planExchangeRepair(exchange: JsonRecord, scopeIndex: FlowIndex, aliasMap: JsonRecord, finding: ScanFinding | null, autoPatchPolicy: AutoPatchPolicy): RepairAction;
+declare function buildUnifiedJsonDiff(before: unknown, after: unknown): string;
+declare function deepDiffPaths(before: unknown, after: unknown, prefix?: PathPart[]): PathPart[][];
+declare function pathContainsReferenceToFlow(pathParts: PathPart[]): boolean;
+declare function safeProcessKey(processId: string, version: string): string;
+declare function writeRowsFile(filePath: string, rows: JsonRecord[]): string;
+declare function mergeRowsByIdentity(existingRows: JsonRecord[], incomingRows: JsonRecord[]): {
+    mergedRows: JsonRecord[];
+    counts: {
+        inserted: number;
+        updated: number;
+        unchanged: number;
+        skipped_invalid: number;
+    };
+};
+declare function syncProcessPoolFile(poolFile: string, incomingRows: JsonRecord[]): JsonRecord;
+declare function resolveProcessValidator(tidasMode: TidasMode, deps: FlowRegenProductDeps): {
+    createProcess: ProcessSdkModule['createProcess'] | null;
+    tidasValidation: boolean;
+};
+declare function formatValidationDetails(validation: unknown): string;
+declare function evaluateProcessSdkValidation(payload: JsonRecord, createProcess: NonNullable<ProcessSdkModule['createProcess']>): string | null;
+declare function validateProcessPatch(originalRow: JsonRecord | null, patchedRow: JsonRecord, scopeIndex: FlowIndex, createProcess: NonNullable<ProcessSdkModule['createProcess']> | null): ProcessPatchValidationResult;
+declare function buildScanStageFiles(outDir: string): ScanStageFiles;
+declare function buildRepairStageFiles(outDir: string): RepairStageFiles;
+declare function buildApplyStageFiles(outDir: string): ApplyStageFiles;
+declare function buildValidateStageFiles(outDir: string): ValidateStageFiles;
+declare function runScanStage(processes: JsonRecord[], scopeIndex: FlowIndex, catalogIndex: FlowIndex, aliasMap: JsonRecord, outDir: string, excludeEmergy: boolean): ScanStageResult;
+declare function runRepairStage(options: {
+    processes: JsonRecord[];
+    scopeIndex: FlowIndex;
+    aliasMap: JsonRecord;
+    scanFindings: ScanFinding[];
+    autoPatchPolicy: AutoPatchPolicy;
+    outDir: string;
+    apply: boolean;
+    processPoolFile: string | null;
+}): RepairStageResult;
+declare function runValidateStage(options: {
+    originalRows: JsonRecord[];
+    patchedRows: JsonRecord[];
+    scopeIndex: FlowIndex;
+    outDir: string;
+    tidasMode: TidasMode;
+    deps: FlowRegenProductDeps;
+}): ValidateStageResult;
+export declare function runFlowScanProcessFlowRefs(options: RunFlowScanProcessFlowRefsOptions, deps?: FlowRegenProductDeps): Promise<FlowScanProcessFlowRefsReport>;
+export declare function runFlowPlanProcessFlowRepairs(options: RunFlowPlanProcessFlowRepairsOptions, deps?: FlowRegenProductDeps): Promise<FlowPlanProcessFlowRepairsReport>;
+export declare function runFlowApplyProcessFlowRepairs(options: RunFlowApplyProcessFlowRepairsOptions, deps?: FlowRegenProductDeps): Promise<FlowApplyProcessFlowRepairsReport>;
+declare function buildReportFiles(outDir: string, apply: boolean): FlowRegenProductFiles;
+export declare function runFlowRegenProduct(options: RunFlowRegenProductOptions, deps?: FlowRegenProductDeps): Promise<FlowRegenProductReport>;
+export declare function runFlowValidateProcesses(options: RunFlowValidateProcessesOptions, deps?: FlowRegenProductDeps): Promise<FlowValidateProcessesReport>;
+export declare const __testInternals: {
+    resolveCliRepoRoot: typeof resolveCliRepoRoot;
+    assertInputFile: typeof assertInputFile;
+    assertInputFiles: typeof assertInputFiles;
+    assertOutDir: typeof assertOutDir;
+    readJsonObjectFile: typeof readJsonObjectFile;
+    resolveLocalSdkModule: typeof resolveLocalSdkModule;
+    processDatasetFromRow: typeof processDatasetFromRow;
+    extractProcessIdentity: typeof extractProcessIdentity;
+    exchangeRecords: typeof exchangeRecords;
+    extractProcessReferenceExchange: typeof extractProcessReferenceExchange;
+    extractReferenceText: typeof extractReferenceText;
+    extractProcessReferenceFlowRef: typeof extractProcessReferenceFlowRef;
+    processRowKey: typeof processRowKey;
+    versionKey: typeof versionKey;
+    compareVersionKeys: typeof compareVersionKeys;
+    processRowSortComparator: typeof processRowSortComparator;
+    buildFlowIndex: typeof buildFlowIndex;
+    aliasLookup: typeof aliasLookup;
+    buildLocalDatasetUri: typeof buildLocalDatasetUri;
+    preserveShortDescriptionShape: typeof preserveShortDescriptionShape;
+    flowReferenceFromRecord: typeof flowReferenceFromRecord;
+    patchedFlowReference: typeof patchedFlowReference;
+    langEntries: typeof langEntries;
+    textHasEmergyKeyword: typeof textHasEmergyKeyword;
+    uniqueNonEmptyTexts: typeof uniqueNonEmptyTexts;
+    flowEmergyScopeDecision: typeof flowEmergyScopeDecision;
+    processEmergyScopeDecision: typeof processEmergyScopeDecision;
+    filterEmergyNamedProcesses: typeof filterEmergyNamedProcesses;
+    classifyExchangeRef: typeof classifyExchangeRef;
+    buildFindingMap: typeof buildFindingMap;
+    planExchangeRepair: typeof planExchangeRepair;
+    buildUnifiedJsonDiff: typeof buildUnifiedJsonDiff;
+    deepDiffPaths: typeof deepDiffPaths;
+    pathContainsReferenceToFlow: typeof pathContainsReferenceToFlow;
+    safeProcessKey: typeof safeProcessKey;
+    writeRowsFile: typeof writeRowsFile;
+    mergeRowsByIdentity: typeof mergeRowsByIdentity;
+    syncProcessPoolFile: typeof syncProcessPoolFile;
+    buildSdkCandidates: typeof buildSdkCandidates;
+    resolveSdkModuleFromCandidates: typeof resolveSdkModuleFromCandidates;
+    resolveProcessValidator: typeof resolveProcessValidator;
+    formatValidationDetails: typeof formatValidationDetails;
+    evaluateProcessSdkValidation: typeof evaluateProcessSdkValidation;
+    validateProcessPatch: typeof validateProcessPatch;
+    buildScanStageFiles: typeof buildScanStageFiles;
+    buildRepairStageFiles: typeof buildRepairStageFiles;
+    buildApplyStageFiles: typeof buildApplyStageFiles;
+    buildValidateStageFiles: typeof buildValidateStageFiles;
+    runScanStage: typeof runScanStage;
+    runRepairStage: typeof runRepairStage;
+    runValidateStage: typeof runValidateStage;
+    buildReportFiles: typeof buildReportFiles;
+};
+export {};

package/dist/src/lib/flow-remediate.d.ts

@@ -0,0 +1,133 @@
+import { type JsonRecord } from './flow-governance.js';
+import { type SdkValidationEntity } from './tidas-sdk-validation.js';
+type FlowValidationIssue = {
+    validator: 'tidas_sdk';
+    path: string;
+    message: string;
+    code: string;
+};
+type FlowRemediationRowResult = {
+    row: JsonRecord;
+    valid: boolean;
+    appliedFixes: string[];
+    finalReasons: FlowValidationIssue[];
+    versionBefore: string;
+    versionAfter: string;
+};
+type FlowValidationResult = {
+    success: true;
+} | {
+    success: false;
+    issues: FlowValidationIssue[];
+};
+type FlowSdkModule = {
+    createFlow?: (data?: unknown, validationConfig?: {
+        mode?: 'strict' | 'weak' | 'ignore';
+        throwOnError?: boolean;
+        deepValidation?: boolean;
+    }) => SdkValidationEntity;
+};
+type FlowRemediationFiles = {
+    allRemediated: string;
+    readyForMcp: string;
+    residualManualQueue: string;
+    audit: string;
+    report: string;
+    prompt: string;
+};
+export type FlowRemediationReport = {
+    schema_version: 1;
+    generated_at_utc: string;
+    status: 'completed_local_flow_remediation';
+    input_file: string;
+    out_dir: string;
+    counts: {
+        input_rows: number;
+        state_code_0_rows: number;
+        state_code_100_rows: number;
+        remediated_rows: number;
+        ready_for_mcp_rows: number;
+        residual_manual_rows: number;
+    };
+    applied_fix_counts: Record<string, number>;
+    residual_manual_ids: string[];
+    validation_backend: 'tidas_sdk';
+    files: {
+        all_remediated: string;
+        ready_for_mcp: string;
+        residual_manual_queue: string;
+        audit: string;
+        prompt: string;
+        report: string;
+    };
+};
+export type RunFlowRemediateOptions = {
+    inputFile: string;
+    outDir: string;
+};
+type FlowRemediationDeps = {
+    loadSdkModule?: () => FlowSdkModule & {
+        location?: string;
+    };
+    now?: () => Date;
+};
+type FlowPropertyDescriptor = {
+    uuid: string;
+    name: string;
+    version: string;
+};
+declare function resolve_sdk_module_from_candidates(requireFn: NodeJS.Require, candidates: string[]): FlowSdkModule & {
+    location: string;
+};
+declare function assert_input_file(inputFile: string): string;
+declare function assert_out_dir(outDir: string): string;
+declare function build_output_files(outDir: string): FlowRemediationFiles;
+declare function build_local_dataset_uri(datasetKind: string, uuidValue: string, version: string): string;
+declare function build_dataset_format_reference(): JsonRecord;
+declare function normalize_multilang_entries(value: unknown): JsonRecord[] | null;
+declare function normalize_multilang_field(container: JsonRecord, key: string, fixes: string[]): void;
+declare function normalize_name_block(dataSetInfo: JsonRecord, fixes: string[]): void;
+declare function bump_ilcd_version(version: string): string;
+declare function version_from_uri(uri: string): string;
+declare function normalize_reference_block(ref: unknown, defaultType: string, shortDescriptionFallback: string): JsonRecord | null;
+declare function canonical_contact_reference(): JsonRecord;
+declare function canonical_compliance_block(): JsonRecord;
+declare function infer_flow_property_descriptor_from_hint(value: unknown): FlowPropertyDescriptor | null;
+declare function build_flow_property_item(descriptor: FlowPropertyDescriptor, internalId: string, meanValue: string): JsonRecord;
+declare function normalize_flow_properties(dataset: JsonRecord, fixes: string[]): {
+    items: JsonRecord[];
+    unresolved: FlowValidationIssue[];
+};
+declare function normalize_quantitative_reference(dataset: JsonRecord, normalizedFlowProperties: JsonRecord[], fixes: string[], unresolved: FlowValidationIssue[]): void;
+declare function update_permanent_dataset_uri(uriValue: unknown, targetVersion: string): unknown;
+declare function parse_validation_error(error: unknown): FlowValidationIssue[];
+declare function validate_flow_payload(payload: JsonRecord, deps: FlowRemediationDeps): FlowValidationResult;
+declare function remediate_row(row: JsonRecord, deps: FlowRemediationDeps): FlowRemediationRowResult;
+declare function build_prompt(manualRows: JsonRecord[], manualFile: string, promptFile: string): string;
+export declare function runFlowRemediate(options: RunFlowRemediateOptions, deps?: FlowRemediationDeps): Promise<FlowRemediationReport>;
+export declare const __testInternals: {
+    assert_input_file: typeof assert_input_file;
+    assert_out_dir: typeof assert_out_dir;
+    build_dataset_format_reference: typeof build_dataset_format_reference;
+    build_flow_property_item: typeof build_flow_property_item;
+    build_output_files: typeof build_output_files;
+    build_prompt: typeof build_prompt;
+    build_local_dataset_uri: typeof build_local_dataset_uri;
+    bump_ilcd_version: typeof bump_ilcd_version;
+    canonical_compliance_block: typeof canonical_compliance_block;
+    canonical_contact_reference: typeof canonical_contact_reference;
+    infer_flow_property_descriptor_from_hint: typeof infer_flow_property_descriptor_from_hint;
+    normalize_flow_properties: typeof normalize_flow_properties;
+    normalize_multilang_entries: typeof normalize_multilang_entries;
+    normalize_multilang_field: typeof normalize_multilang_field;
+    normalize_name_block: typeof normalize_name_block;
+    normalize_quantitative_reference: typeof normalize_quantitative_reference;
+    normalize_reference_block: typeof normalize_reference_block;
+    parse_validation_error: typeof parse_validation_error;
+    remediate_row: typeof remediate_row;
+    resolve_sdk_module_from_candidates: typeof resolve_sdk_module_from_candidates;
+    update_permanent_dataset_uri: typeof update_permanent_dataset_uri;
+    validate_flow_payload: typeof validate_flow_payload;
+    version_from_uri: typeof version_from_uri;
+};
+export {};

package/dist/src/lib/http.d.ts

@@ -0,0 +1,25 @@
+export type ResponseLike = {
+    ok: boolean;
+    status: number;
+    body?: ReadableStream<Uint8Array> | null;
+    headers: {
+        get(name: string): string | null;
+    };
+    text(): Promise<string>;
+    arrayBuffer?(): Promise<ArrayBuffer>;
+};
+export type FetchLike = (input: string, init?: RequestInit) => Promise<ResponseLike>;
+export declare function requireRemoteOkPayload(payload: unknown, url: string): unknown;
+export declare function postJson(options: {
+    url: string;
+    headers: Record<string, string>;
+    body: unknown;
+    timeoutMs: number;
+    fetchImpl: FetchLike;
+}): Promise<unknown>;
+export declare function getJson(options: {
+    url: string;
+    headers: Record<string, string>;
+    timeoutMs: number;
+    fetchImpl: FetchLike;
+}): Promise<unknown>;

package/dist/src/lib/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/lib/http.ts"],"names":[],"mappings":"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","sourcesContent":["import { CliError } from './errors.js';\n\ntype JsonObject = Record<string, unknown>;\n\nexport type ResponseLike = {\n  ok: boolean;\n  status: number;\n  headers: {\n    get(name: string): string | null;\n  };\n  text(): Promise<string>;\n  arrayBuffer?(): Promise<ArrayBuffer>;\n};\n\nexport type FetchLike = (input: string, init?: RequestInit) => Promise<ResponseLike>;\n\nfunction isRecord(value: unknown): value is JsonObject {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nasync function parseResponse(response: ResponseLike, url: string): Promise<unknown> {\n  const rawText = await response.text();\n  const contentType = response.headers.get('content-type') ?? '';\n\n  if (!response.ok) {\n    throw new CliError(`HTTP ${response.status} returned from ${url}`, {\n      code: 'REMOTE_REQUEST_FAILED',\n      exitCode: 1,\n      details: rawText,\n    });\n  }\n\n  if (contentType.includes('application/json')) {\n    try {\n      return JSON.parse(rawText);\n    } catch (error) {\n      throw new CliError(`Remote response was not valid JSON for ${url}`, {\n        code: 'REMOTE_INVALID_JSON',\n        exitCode: 1,\n        details: String(error),\n      });\n    }\n  }\n\n  return rawText;\n}\n\nexport function requireRemoteOkPayload(payload: unknown, url: string): unknown {\n  if (!isRecord(payload) || payload.ok !== false) {\n    return payload;\n  }\n\n  const code =\n    typeof payload.code === 'string' && payload.code.trim()\n      ? payload.code.trim()\n      : 'REMOTE_APPLICATION_ERROR';\n  const message =\n    typeof payload.message === 'string' && payload.message.trim()\n      ? payload.message.trim()\n      : `Remote application response returned ok:false for ${url}`;\n\n  throw new CliError(message, {\n    code,\n    exitCode: 1,\n    details: payload,\n  });\n}\n\nexport async function postJson(options: {\n  url: string;\n  headers: Record<string, string>;\n  body: unknown;\n  timeoutMs: number;\n  fetchImpl: FetchLike;\n}): Promise<unknown> {\n  const signal = AbortSignal.timeout(options.timeoutMs);\n  const response = await options.fetchImpl(options.url, {\n    method: 'POST',\n    headers: options.headers,\n    body: JSON.stringify(options.body),\n    signal,\n  });\n\n  return parseResponse(response, options.url);\n}\n\nexport async function getJson(options: {\n  url: string;\n  headers: Record<string, string>;\n  timeoutMs: number;\n  fetchImpl: FetchLike;\n}): Promise<unknown> {\n  const signal = AbortSignal.timeout(options.timeoutMs);\n  const response = await options.fetchImpl(options.url, {\n    method: 'GET',\n    headers: options.headers,\n    signal,\n  });\n\n  return parseResponse(response, options.url);\n}\n"]}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/lib/http.ts"],"names":[],"mappings":"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","sourcesContent":["import { CliError } from './errors.js';\n\ntype JsonObject = Record<string, unknown>;\n\nexport type ResponseLike = {\n  ok: boolean;\n  status: number;\n  body?: ReadableStream<Uint8Array> | null;\n  headers: {\n    get(name: string): string | null;\n  };\n  text(): Promise<string>;\n  arrayBuffer?(): Promise<ArrayBuffer>;\n};\n\nexport type FetchLike = (input: string, init?: RequestInit) => Promise<ResponseLike>;\n\nfunction isRecord(value: unknown): value is JsonObject {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nasync function parseResponse(response: ResponseLike, url: string): Promise<unknown> {\n  const rawText = await response.text();\n  const contentType = response.headers.get('content-type') ?? '';\n\n  if (!response.ok) {\n    throw new CliError(`HTTP ${response.status} returned from ${url}`, {\n      code: 'REMOTE_REQUEST_FAILED',\n      exitCode: 1,\n      details: rawText,\n    });\n  }\n\n  if (contentType.includes('application/json')) {\n    try {\n      return JSON.parse(rawText);\n    } catch (error) {\n      throw new CliError(`Remote response was not valid JSON for ${url}`, {\n        code: 'REMOTE_INVALID_JSON',\n        exitCode: 1,\n        details: String(error),\n      });\n    }\n  }\n\n  return rawText;\n}\n\nexport function requireRemoteOkPayload(payload: unknown, url: string): unknown {\n  if (!isRecord(payload) || payload.ok !== false) {\n    return payload;\n  }\n\n  const code =\n    typeof payload.code === 'string' && payload.code.trim()\n      ? payload.code.trim()\n      : 'REMOTE_APPLICATION_ERROR';\n  const message =\n    typeof payload.message === 'string' && payload.message.trim()\n      ? payload.message.trim()\n      : `Remote application response returned ok:false for ${url}`;\n\n  throw new CliError(message, {\n    code,\n    exitCode: 1,\n    details: payload,\n  });\n}\n\nexport async function postJson(options: {\n  url: string;\n  headers: Record<string, string>;\n  body: unknown;\n  timeoutMs: number;\n  fetchImpl: FetchLike;\n}): Promise<unknown> {\n  const signal = AbortSignal.timeout(options.timeoutMs);\n  const response = await options.fetchImpl(options.url, {\n    method: 'POST',\n    headers: options.headers,\n    body: JSON.stringify(options.body),\n    signal,\n  });\n\n  return parseResponse(response, options.url);\n}\n\nexport async function getJson(options: {\n  url: string;\n  headers: Record<string, string>;\n  timeoutMs: number;\n  fetchImpl: FetchLike;\n}): Promise<unknown> {\n  const signal = AbortSignal.timeout(options.timeoutMs);\n  const response = await options.fetchImpl(options.url, {\n    method: 'GET',\n    headers: options.headers,\n    signal,\n  });\n\n  return parseResponse(response, options.url);\n}\n"]}