@tiangong-lca/pcr 0.3.1 → 0.4.0

package/packages/pcr-core/src/contracts.js

@@ -0,0 +1,163 @@
+import { readFileSync } from "node:fs";
+import { isUnknownRecord } from './types.js';
+import { createSchemaRegistry } from "./schema-validation.js";
+import { readinessSemanticIssues, validationReportSemanticIssues, } from "./output-semantics.js";
+const CORE_SCHEMA_DEPENDENCY_FILES = ["controlled-vocabulary.schema.json"];
+const CORE_SCHEMA_FILES = [
+    "agent-review.schema.json",
+    "classification-coverage.schema.json",
+    "dataset-validation-input.schema.json",
+    "feedback-draft-output.schema.json",
+    "feedback.schema.json",
+    "guidance-output.schema.json",
+    "guidance-batch-request.schema.json",
+    "model-validation-input.schema.json",
+    "pcr-id-aliases.schema.json",
+    "readiness.schema.json",
+    "structured-projection.schema.json",
+    "validation-output.schema.json",
+];
+const schemaEntries = CORE_SCHEMA_FILES.map((fileName) => ({
+    fileName,
+    schema: readSchema(fileName),
+}));
+const schemaDependencies = CORE_SCHEMA_DEPENDENCY_FILES.map((fileName) => readSchema(fileName));
+const contractIds = new Map(schemaEntries.map(({ fileName, schema }) => [fileName, schema.$id]));
+const entityKindsByFile = {
+    "agent-review.schema.json": "agent_review",
+    "classification-coverage.schema.json": "classification_coverage",
+    "dataset-validation-input.schema.json": "dataset_validation_input",
+    "feedback-draft-output.schema.json": "feedback_draft_output",
+    "feedback.schema.json": "feedback_intake",
+    "guidance-output.schema.json": "guidance_output",
+    "guidance-batch-request.schema.json": "guidance_batch_request",
+    "model-validation-input.schema.json": "model_validation_input",
+    "pcr-id-aliases.schema.json": "pcr_id_aliases",
+    "readiness.schema.json": "readiness",
+    "structured-projection.schema.json": "structured_projection",
+    "validation-output.schema.json": "validation_report",
+};
+const registry = createSchemaRegistry([...schemaDependencies, ...schemaEntries.map(({ schema }) => schema)], Object.fromEntries(schemaEntries.map(({ fileName, schema }) => [schema.$id, (entityKindsByFile[fileName] ?? fileName)])));
+// These adapters run only after the corresponding exact schema succeeds.
+const semanticValidators = new Map([
+    [resolveContractId("readiness.schema.json"), value => readinessSemanticIssues(value)],
+    [resolveContractId("validation-output.schema.json"), value => validationReportSemanticIssues(value)],
+]);
+export class CoreContractSemanticError extends Error {
+    code;
+    contract;
+    entity_kind;
+    schema_id;
+    source;
+    issues;
+    errors;
+    constructor({ code = "PCR_SEMANTIC_CONTRACT_INVALID", contract, entityKind, source = null, issues, }) {
+        const location = source ? ` at ${source}` : "";
+        const details = issues.map((issue) => `${issue.instance_path}: ${issue.message}`).join("; ");
+        super(`${entityKind} semantic contract failed${location}: ${details}`);
+        this.name = "CoreContractSemanticError";
+        this.code = code;
+        this.contract = contract;
+        this.entity_kind = entityKind;
+        this.schema_id = contract;
+        this.source = source;
+        this.issues = structuredClone([...issues]);
+        this.errors = structuredClone([...issues]);
+    }
+    toJSON() {
+        return {
+            code: this.code,
+            entity_kind: this.entity_kind,
+            schema_id: this.schema_id,
+            source: this.source,
+            errors: structuredClone(this.errors),
+        };
+    }
+}
+export const CORE_SCHEMA_IDS = Object.freeze({
+    classificationCoverage: resolveContractId("classification-coverage.schema.json"),
+    structured: resolveContractId("structured-projection.schema.json"),
+    readiness: resolveContractId("readiness.schema.json"),
+    guidance: resolveContractId("guidance-output.schema.json"),
+    validationReport: resolveContractId("validation-output.schema.json"),
+    feedbackDraft: resolveContractId("feedback-draft-output.schema.json"),
+    feedbackIntake: resolveContractId("feedback.schema.json"),
+    modelInput: resolveContractId("model-validation-input.schema.json"),
+    datasetInput: resolveContractId("dataset-validation-input.schema.json"),
+    pcrIdAliases: resolveContractId("pcr-id-aliases.schema.json"),
+});
+export function assertCoreContract(contract, value, options = {}) {
+    const contractId = resolveContractId(contract);
+    registry.assert(contractId, value, options);
+    const issues = semanticValidators.get(contractId)?.(value) ?? [];
+    if (issues.length > 0) {
+        throw new CoreContractSemanticError({
+            code: options.code,
+            contract: contractId,
+            entityKind: options.entityKind ?? entityKindsByContract.get(contractId) ?? contractId,
+            source: options.source,
+            issues,
+        });
+    }
+    return value;
+}
+export function validateCoreContract(contract, value, options = {}) {
+    const contractId = resolveContractId(contract);
+    const result = registry.validate(contractId, value, options);
+    if (!result.valid) {
+        return result;
+    }
+    const errors = semanticValidators.get(contractId)?.(value) ?? [];
+    if (errors.length === 0) {
+        return result;
+    }
+    return {
+        ...result,
+        valid: false,
+        code: "PCR_SEMANTIC_CONTRACT_INVALID",
+        errors,
+        issues: errors,
+    };
+}
+export function coreContractId(fileName) {
+    return resolveContractId(fileName);
+}
+export const validateStructured = (value) => validateCoreContract("structured-projection.schema.json", value);
+export const assertStructured = (value, options = {}) => assertCoreContract("structured-projection.schema.json", value, options);
+export const validateReadiness = (value) => validateCoreContract("readiness.schema.json", value);
+export const assertReadiness = (value, options = {}) => assertCoreContract("readiness.schema.json", value, options);
+export const validateGuidance = (value) => validateCoreContract("guidance-output.schema.json", value);
+export const assertGuidance = (value, options = {}) => assertCoreContract("guidance-output.schema.json", value, options);
+export const validateValidationReport = (value) => validateCoreContract("validation-output.schema.json", value);
+export const assertValidationReport = (value, options = {}) => assertCoreContract("validation-output.schema.json", value, options);
+export const validateFeedbackDraft = (value) => validateCoreContract("feedback-draft-output.schema.json", value);
+export const assertFeedbackDraft = (value, options = {}) => assertCoreContract("feedback-draft-output.schema.json", value, options);
+export const validateFeedbackIntake = (value) => validateCoreContract("feedback.schema.json", value);
+export const assertFeedbackIntake = (value, options = {}) => assertCoreContract("feedback.schema.json", value, options);
+export const validateModelInput = (value) => validateCoreContract("model-validation-input.schema.json", value);
+export const assertModelInput = (value, options = {}) => assertCoreContract("model-validation-input.schema.json", value, options);
+export const validateDatasetInput = (value) => validateCoreContract("dataset-validation-input.schema.json", value);
+export const assertDatasetInput = (value, options = {}) => assertCoreContract("dataset-validation-input.schema.json", value, options);
+export const validateClassificationCoverage = (value) => validateCoreContract("classification-coverage.schema.json", value);
+export const assertClassificationCoverage = (value, options = {}) => assertCoreContract("classification-coverage.schema.json", value, options);
+export const validatePcrIdAliases = (value) => validateCoreContract("pcr-id-aliases.schema.json", value);
+export const assertPcrIdAliases = (value, options = {}) => assertCoreContract("pcr-id-aliases.schema.json", value, options);
+export const validateStructuredProjection = validateStructured;
+export const assertStructuredProjection = assertStructured;
+export const validateGuidanceOutput = validateGuidance;
+export const assertGuidanceOutput = assertGuidance;
+export const validateModelValidationInput = validateModelInput;
+export const assertModelValidationInput = assertModelInput;
+export const validateDatasetValidationInput = validateDatasetInput;
+export const assertDatasetValidationInput = assertDatasetInput;
+function resolveContractId(contract) {
+    return contractIds.get(contract) ?? contract;
+}
+const entityKindsByContract = new Map(schemaEntries.map(({ fileName, schema }) => [schema.$id, (entityKindsByFile[fileName] ?? fileName)]));
+function readSchema(fileName) {
+    const value = JSON.parse(readFileSync(new URL(`../schemas/${fileName}`, import.meta.url), "utf8"));
+    if (!isUnknownRecord(value) || typeof value.$id !== 'string' || !value.$id)
+        throw new Error(`Invalid core schema identity: ${fileName}`);
+    return { ...value, $id: value.$id };
+}
+//# sourceMappingURL=contracts.js.map

package/packages/pcr-core/src/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"pcr://source/","sources":["packages/pcr-core/src/contracts.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { isUnknownRecord, type ContractOptions, type ContractValidationResult, type SchemaIssue, type Readiness, type ValidationReport } from './types.ts';\n\nimport { createSchemaRegistry } from \"./schema-validation.ts\";\nimport {\n  readinessSemanticIssues,\n  validationReportSemanticIssues,\n} from \"./output-semantics.ts\";\n\nconst CORE_SCHEMA_DEPENDENCY_FILES = [\"controlled-vocabulary.schema.json\"];\nconst CORE_SCHEMA_FILES = [\n  \"agent-review.schema.json\",\n  \"classification-coverage.schema.json\",\n  \"dataset-validation-input.schema.json\",\n  \"feedback-draft-output.schema.json\",\n  \"feedback.schema.json\",\n  \"guidance-output.schema.json\",\n  \"guidance-batch-request.schema.json\",\n  \"model-validation-input.schema.json\",\n  \"pcr-id-aliases.schema.json\",\n  \"readiness.schema.json\",\n  \"structured-projection.schema.json\",\n  \"validation-output.schema.json\",\n];\n\nconst schemaEntries = CORE_SCHEMA_FILES.map((fileName) => ({\n  fileName,\n  schema: readSchema(fileName),\n}));\nconst schemaDependencies = CORE_SCHEMA_DEPENDENCY_FILES.map((fileName) =>\n  readSchema(fileName),\n);\nconst contractIds = new Map(schemaEntries.map(({ fileName, schema }) => [fileName, schema.$id]));\nconst entityKindsByFile: Record<string, string> = {\n  \"agent-review.schema.json\": \"agent_review\",\n  \"classification-coverage.schema.json\": \"classification_coverage\",\n  \"dataset-validation-input.schema.json\": \"dataset_validation_input\",\n  \"feedback-draft-output.schema.json\": \"feedback_draft_output\",\n  \"feedback.schema.json\": \"feedback_intake\",\n  \"guidance-output.schema.json\": \"guidance_output\",\n  \"guidance-batch-request.schema.json\": \"guidance_batch_request\",\n  \"model-validation-input.schema.json\": \"model_validation_input\",\n  \"pcr-id-aliases.schema.json\": \"pcr_id_aliases\",\n  \"readiness.schema.json\": \"readiness\",\n  \"structured-projection.schema.json\": \"structured_projection\",\n  \"validation-output.schema.json\": \"validation_report\",\n};\nconst registry = createSchemaRegistry(\n  [...schemaDependencies, ...schemaEntries.map(({ schema }) => schema)],\n  Object.fromEntries(\n    schemaEntries.map(({ fileName, schema }) => [schema.$id, (entityKindsByFile[fileName] ?? fileName)]),\n  ),\n);\n\n// These adapters run only after the corresponding exact schema succeeds.\nconst semanticValidators = new Map<string, (value: unknown) => SchemaIssue[]>([\n  [resolveContractId(\"readiness.schema.json\"), value => readinessSemanticIssues(value as Readiness)],\n  [resolveContractId(\"validation-output.schema.json\"), value => validationReportSemanticIssues(value as ValidationReport)],\n]);\n\nexport class CoreContractSemanticError extends Error {\n  readonly code: string;\n  readonly contract: string;\n  readonly entity_kind: string;\n  readonly schema_id: string;\n  readonly source: string | null;\n  readonly issues: SchemaIssue[];\n  readonly errors: SchemaIssue[];\n  constructor({\n    code = \"PCR_SEMANTIC_CONTRACT_INVALID\",\n    contract,\n    entityKind,\n    source = null,\n    issues,\n  }: { code?: string | undefined; contract: string; entityKind: string; source?: string | null | undefined; issues: readonly SchemaIssue[] }) {\n    const location = source ? ` at ${source}` : \"\";\n    const details = issues.map((issue) => `${issue.instance_path}: ${issue.message}`).join(\"; \");\n    super(`${entityKind} semantic contract failed${location}: ${details}`);\n    this.name = \"CoreContractSemanticError\";\n    this.code = code;\n    this.contract = contract;\n    this.entity_kind = entityKind;\n    this.schema_id = contract;\n    this.source = source;\n    this.issues = structuredClone([...issues]);\n    this.errors = structuredClone([...issues]);\n  }\n\n  toJSON() {\n    return {\n      code: this.code,\n      entity_kind: this.entity_kind,\n      schema_id: this.schema_id,\n      source: this.source,\n      errors: structuredClone(this.errors),\n    };\n  }\n}\n\nexport const CORE_SCHEMA_IDS = Object.freeze({\n  classificationCoverage: resolveContractId(\"classification-coverage.schema.json\"),\n  structured: resolveContractId(\"structured-projection.schema.json\"),\n  readiness: resolveContractId(\"readiness.schema.json\"),\n  guidance: resolveContractId(\"guidance-output.schema.json\"),\n  validationReport: resolveContractId(\"validation-output.schema.json\"),\n  feedbackDraft: resolveContractId(\"feedback-draft-output.schema.json\"),\n  feedbackIntake: resolveContractId(\"feedback.schema.json\"),\n  modelInput: resolveContractId(\"model-validation-input.schema.json\"),\n  datasetInput: resolveContractId(\"dataset-validation-input.schema.json\"),\n  pcrIdAliases: resolveContractId(\"pcr-id-aliases.schema.json\"),\n});\n\nexport function assertCoreContract<T>(contract: string, value: T, options: ContractOptions = {}): T {\n  const contractId = resolveContractId(contract);\n  registry.assert(contractId, value, options);\n  const issues = semanticValidators.get(contractId)?.(value) ?? [];\n  if (issues.length > 0) {\n    throw new CoreContractSemanticError({\n      code: options.code,\n      contract: contractId,\n      entityKind: options.entityKind ?? entityKindsByContract.get(contractId) ?? contractId,\n      source: options.source,\n      issues,\n    });\n  }\n  return value;\n}\n\nexport function validateCoreContract(contract: string, value: unknown, options: ContractOptions = {}): ContractValidationResult {\n  const contractId = resolveContractId(contract);\n  const result = registry.validate(contractId, value, options);\n  if (!result.valid) {\n    return result;\n  }\n  const errors = semanticValidators.get(contractId)?.(value) ?? [];\n  if (errors.length === 0) {\n    return result;\n  }\n  return {\n    ...result,\n    valid: false,\n    code: \"PCR_SEMANTIC_CONTRACT_INVALID\",\n    errors,\n    issues: errors,\n  };\n}\n\nexport function coreContractId(fileName: string): string {\n  return resolveContractId(fileName);\n}\n\nexport const validateStructured = (value: unknown) =>\n  validateCoreContract(\"structured-projection.schema.json\", value);\nexport const assertStructured = <T>(value: T, options: ContractOptions = {}): T =>\n  assertCoreContract(\"structured-projection.schema.json\", value, options);\nexport const validateReadiness = (value: unknown) => validateCoreContract(\"readiness.schema.json\", value);\nexport const assertReadiness = <T>(value: T, options: ContractOptions = {}): T =>\n  assertCoreContract(\"readiness.schema.json\", value, options);\nexport const validateGuidance = (value: unknown) => validateCoreContract(\"guidance-output.schema.json\", value);\nexport const assertGuidance = <T>(value: T, options: ContractOptions = {}): T =>\n  assertCoreContract(\"guidance-output.schema.json\", value, options);\nexport const validateValidationReport = (value: unknown) =>\n  validateCoreContract(\"validation-output.schema.json\", value);\nexport const assertValidationReport = <T>(value: T, options: ContractOptions = {}): T =>\n  assertCoreContract(\"validation-output.schema.json\", value, options);\nexport const validateFeedbackDraft = (value: unknown) =>\n  validateCoreContract(\"feedback-draft-output.schema.json\", value);\nexport const assertFeedbackDraft = <T>(value: T, options: ContractOptions = {}): T =>\n  assertCoreContract(\"feedback-draft-output.schema.json\", value, options);\nexport const validateFeedbackIntake = (value: unknown) =>\n  validateCoreContract(\"feedback.schema.json\", value);\nexport const assertFeedbackIntake = <T>(value: T, options: ContractOptions = {}): T =>\n  assertCoreContract(\"feedback.schema.json\", value, options);\nexport const validateModelInput = (value: unknown) =>\n  validateCoreContract(\"model-validation-input.schema.json\", value);\nexport const assertModelInput = <T>(value: T, options: ContractOptions = {}): T =>\n  assertCoreContract(\"model-validation-input.schema.json\", value, options);\nexport const validateDatasetInput = (value: unknown) =>\n  validateCoreContract(\"dataset-validation-input.schema.json\", value);\nexport const assertDatasetInput = <T>(value: T, options: ContractOptions = {}): T =>\n  assertCoreContract(\"dataset-validation-input.schema.json\", value, options);\nexport const validateClassificationCoverage = (value: unknown) =>\n  validateCoreContract(\"classification-coverage.schema.json\", value);\nexport const assertClassificationCoverage = <T>(value: T, options: ContractOptions = {}): T =>\n  assertCoreContract(\"classification-coverage.schema.json\", value, options);\nexport const validatePcrIdAliases = (value: unknown) =>\n  validateCoreContract(\"pcr-id-aliases.schema.json\", value);\nexport const assertPcrIdAliases = <T>(value: T, options: ContractOptions = {}): T =>\n  assertCoreContract(\"pcr-id-aliases.schema.json\", value, options);\n\nexport const validateStructuredProjection = validateStructured;\nexport const assertStructuredProjection = assertStructured;\nexport const validateGuidanceOutput = validateGuidance;\nexport const assertGuidanceOutput = assertGuidance;\nexport const validateModelValidationInput = validateModelInput;\nexport const assertModelValidationInput = assertModelInput;\nexport const validateDatasetValidationInput = validateDatasetInput;\nexport const assertDatasetValidationInput = assertDatasetInput;\n\nfunction resolveContractId(contract: string): string {\n  return contractIds.get(contract) ?? contract;\n}\n\nconst entityKindsByContract = new Map(\n  schemaEntries.map(({ fileName, schema }) => [schema.$id, (entityKindsByFile[fileName] ?? fileName)]),\n);\n\nfunction readSchema(fileName: string): Record<string, unknown> & { $id: string } {\n  const value: unknown = JSON.parse(readFileSync(new URL(`../schemas/${fileName}`, import.meta.url), \"utf8\"));\n  if (!isUnknownRecord(value) || typeof value.$id !== 'string' || !value.$id) throw new Error(`Invalid core schema identity: ${fileName}`);\n  return { ...value, $id: value.$id };\n}\n"]}

package/packages/pcr-core/src/generated/controlled-vocabulary.js

@@ -0,0 +1,39 @@
+// Generated by builder/scripts/generate-controlled-vocabulary.ts.
+// Do not edit this file directly; edit builder/vocab/*.yaml and run npm run vocab:generate.
+export const AMOUNT_RANGE_ROLE_VALUES = Object.freeze(["qa_guardrail", "typical_range", "allowed_range", "default_estimate", "uncertainty_range"]);
+export const AMOUNT_SPECIFICITY_VALUES = Object.freeze(["generic", "site_specific", "product_specific", "route_specific", "scenario_specific", "technology_specific", "not_applicable"]);
+export const AMOUNT_VALUE_MODE_VALUES = Object.freeze(["fixed_value", "foreground_record", "calculated_value", "modelled_estimate", "not_applicable"]);
+export const BASIS_KIND_VALUES = Object.freeze(["reference_flow", "process_output", "n_input", "fuel_inventory", "transport_service", "storage_duration", "crop_cycle"]);
+export const CLASSIFICATION_COVERAGE_STATUS_VALUES = Object.freeze(["mapped", "unmapped", "candidate_suggestion", "manual_review", "unknown"]);
+export const CLASSIFICATION_MAPPING_RELATION_VALUES = Object.freeze(["exact", "broader", "narrower", "proxy", "manual_review"]);
+export const CONTENT_MATURITY_VALUES = Object.freeze(["empty_scaffold", "draft_methodology", "authored_methodology", "reviewed_methodology", "published_methodology", "deprecated_methodology"]);
+export const EVIDENCE_KIND_VALUES = Object.freeze(["external_source", "observed_dataset", "method_formula", "foreground_data", "tiangong_default", "collected_record", "calculated_from_collection", "identity_reference", "source_rule", "reasoned_estimate"]);
+export const FEEDBACK_CONFIDENCE_VALUES = Object.freeze(["high", "medium", "low", "unknown"]);
+export const FEEDBACK_TYPE_VALUES = Object.freeze(["missing_pcr", "classification_mapping_gap", "unclear_reference_flow", "wrong_or_missing_uuid", "process_boundary_issue", "inventory_flow_gap", "range_evidence_update", "unit_or_flow_property_issue", "validation_rule_issue", "translation_mismatch", "source_update"]);
+export const FLOW_DIRECTION_VALUES = Object.freeze(["inputs", "outputs"]);
+export const FLOW_TYPE_VALUES = Object.freeze(["product", "waste", "elementary"]);
+export const PCR_STATUS_VALUES = Object.freeze(["scaffold", "candidate", "active", "published", "deprecated"]);
+export const PROCESS_INCLUSION_VALUES = Object.freeze(["required", "conditional", "optional", "excluded_by_default"]);
+export const SOURCE_TYPE_VALUES = Object.freeze(["official_guidance", "literature", "standard", "dataset", "method_factor", "extension_guidance", "handbook"]);
+export const TARGET_ENTITY_VALUES = Object.freeze(["flow", "process", "lifecyclemodel", "dataset"]);
+export const TRANSLATION_STATUS_VALUES = Object.freeze(["not_available", "scaffold", "scaffold_pending_translation", "draft_translation", "aligned", "reviewed", "out_of_sync"]);
+export const CONTROLLED_VOCABULARY = Object.freeze({
+    amount_range_role: AMOUNT_RANGE_ROLE_VALUES,
+    amount_specificity: AMOUNT_SPECIFICITY_VALUES,
+    amount_value_mode: AMOUNT_VALUE_MODE_VALUES,
+    basis_kind: BASIS_KIND_VALUES,
+    classification_coverage_status: CLASSIFICATION_COVERAGE_STATUS_VALUES,
+    classification_mapping_relation: CLASSIFICATION_MAPPING_RELATION_VALUES,
+    content_maturity: CONTENT_MATURITY_VALUES,
+    evidence_kind: EVIDENCE_KIND_VALUES,
+    feedback_confidence: FEEDBACK_CONFIDENCE_VALUES,
+    feedback_type: FEEDBACK_TYPE_VALUES,
+    flow_direction: FLOW_DIRECTION_VALUES,
+    flow_type: FLOW_TYPE_VALUES,
+    pcr_status: PCR_STATUS_VALUES,
+    process_inclusion: PROCESS_INCLUSION_VALUES,
+    source_type: SOURCE_TYPE_VALUES,
+    target_entity: TARGET_ENTITY_VALUES,
+    translation_status: TRANSLATION_STATUS_VALUES,
+});
+//# sourceMappingURL=controlled-vocabulary.js.map

package/packages/pcr-core/src/generated/controlled-vocabulary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controlled-vocabulary.js","sourceRoot":"pcr://source/","sources":["packages/pcr-core/src/generated/controlled-vocabulary.ts"],"names":[],"mappings":"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","sourcesContent":["// Generated by builder/scripts/generate-controlled-vocabulary.ts.\n// Do not edit this file directly; edit builder/vocab/*.yaml and run npm run vocab:generate.\n\nexport const AMOUNT_RANGE_ROLE_VALUES = Object.freeze([\"qa_guardrail\",\"typical_range\",\"allowed_range\",\"default_estimate\",\"uncertainty_range\"]);\nexport const AMOUNT_SPECIFICITY_VALUES = Object.freeze([\"generic\",\"site_specific\",\"product_specific\",\"route_specific\",\"scenario_specific\",\"technology_specific\",\"not_applicable\"]);\nexport const AMOUNT_VALUE_MODE_VALUES = Object.freeze([\"fixed_value\",\"foreground_record\",\"calculated_value\",\"modelled_estimate\",\"not_applicable\"]);\nexport const BASIS_KIND_VALUES = Object.freeze([\"reference_flow\",\"process_output\",\"n_input\",\"fuel_inventory\",\"transport_service\",\"storage_duration\",\"crop_cycle\"]);\nexport const CLASSIFICATION_COVERAGE_STATUS_VALUES = Object.freeze([\"mapped\",\"unmapped\",\"candidate_suggestion\",\"manual_review\",\"unknown\"]);\nexport const CLASSIFICATION_MAPPING_RELATION_VALUES = Object.freeze([\"exact\",\"broader\",\"narrower\",\"proxy\",\"manual_review\"]);\nexport const CONTENT_MATURITY_VALUES = Object.freeze([\"empty_scaffold\",\"draft_methodology\",\"authored_methodology\",\"reviewed_methodology\",\"published_methodology\",\"deprecated_methodology\"]);\nexport const EVIDENCE_KIND_VALUES = Object.freeze([\"external_source\",\"observed_dataset\",\"method_formula\",\"foreground_data\",\"tiangong_default\",\"collected_record\",\"calculated_from_collection\",\"identity_reference\",\"source_rule\",\"reasoned_estimate\"]);\nexport const FEEDBACK_CONFIDENCE_VALUES = Object.freeze([\"high\",\"medium\",\"low\",\"unknown\"]);\nexport const FEEDBACK_TYPE_VALUES = Object.freeze([\"missing_pcr\",\"classification_mapping_gap\",\"unclear_reference_flow\",\"wrong_or_missing_uuid\",\"process_boundary_issue\",\"inventory_flow_gap\",\"range_evidence_update\",\"unit_or_flow_property_issue\",\"validation_rule_issue\",\"translation_mismatch\",\"source_update\"]);\nexport const FLOW_DIRECTION_VALUES = Object.freeze([\"inputs\",\"outputs\"]);\nexport const FLOW_TYPE_VALUES = Object.freeze([\"product\",\"waste\",\"elementary\"]);\nexport const PCR_STATUS_VALUES = Object.freeze([\"scaffold\",\"candidate\",\"active\",\"published\",\"deprecated\"]);\nexport const PROCESS_INCLUSION_VALUES = Object.freeze([\"required\",\"conditional\",\"optional\",\"excluded_by_default\"]);\nexport const SOURCE_TYPE_VALUES = Object.freeze([\"official_guidance\",\"literature\",\"standard\",\"dataset\",\"method_factor\",\"extension_guidance\",\"handbook\"]);\nexport const TARGET_ENTITY_VALUES = Object.freeze([\"flow\",\"process\",\"lifecyclemodel\",\"dataset\"]);\nexport const TRANSLATION_STATUS_VALUES = Object.freeze([\"not_available\",\"scaffold\",\"scaffold_pending_translation\",\"draft_translation\",\"aligned\",\"reviewed\",\"out_of_sync\"]);\n\nexport const CONTROLLED_VOCABULARY = Object.freeze({\n  amount_range_role: AMOUNT_RANGE_ROLE_VALUES,\n  amount_specificity: AMOUNT_SPECIFICITY_VALUES,\n  amount_value_mode: AMOUNT_VALUE_MODE_VALUES,\n  basis_kind: BASIS_KIND_VALUES,\n  classification_coverage_status: CLASSIFICATION_COVERAGE_STATUS_VALUES,\n  classification_mapping_relation: CLASSIFICATION_MAPPING_RELATION_VALUES,\n  content_maturity: CONTENT_MATURITY_VALUES,\n  evidence_kind: EVIDENCE_KIND_VALUES,\n  feedback_confidence: FEEDBACK_CONFIDENCE_VALUES,\n  feedback_type: FEEDBACK_TYPE_VALUES,\n  flow_direction: FLOW_DIRECTION_VALUES,\n  flow_type: FLOW_TYPE_VALUES,\n  pcr_status: PCR_STATUS_VALUES,\n  process_inclusion: PROCESS_INCLUSION_VALUES,\n  source_type: SOURCE_TYPE_VALUES,\n  target_entity: TARGET_ENTITY_VALUES,\n  translation_status: TRANSLATION_STATUS_VALUES,\n});\n\n"]}