@tiangong-lca/pcr 0.3.1 → 0.4.0

package/packages/pcr-core/src/consumption-calculation.js

@@ -0,0 +1,61 @@
+import { ConsumptionError, object, strictNumber } from "./consumption-data.js";
+function text(value, name) {
+    if (typeof value !== "string" || !value.trim())
+        throw new ConsumptionError("PCR_CALCULATION_INPUT", `${name} must state the unit, basis or evidence explicitly.`, { field: name });
+    return value;
+}
+// Arithmetic only: the Agent owns physical equivalence, applicability and evidence.
+export function calculate(request) {
+    if (!object(request))
+        throw new ConsumptionError("PCR_CALCULATION_INPUT", "Use a JSON object with operation normalize, convert or balance. See calculate --help.");
+    const evidence = text(request.evidence, "evidence");
+    const basis = text(request.basis, "basis");
+    let result;
+    let formula;
+    if (request.operation === "normalize") {
+        const amount = strictNumber(request.amount, "amount");
+        const sourceReference = strictNumber(request.source_reference, "source_reference", { positive: true });
+        const targetReference = strictNumber(request.target_reference, "target_reference", { positive: true });
+        const unit = text(request.unit, "unit");
+        text(request.reference_unit, "reference_unit");
+        result = { amount: amount * targetReference / sourceReference, unit, factor: targetReference / sourceReference };
+        formula = "amount * target_reference / source_reference; both reference quantities share reference_unit and the stated physical basis";
+    }
+    else if (request.operation === "convert") {
+        const amount = strictNumber(request.amount, "amount");
+        const factor = strictNumber(request.factor, "factor", { positive: true });
+        text(request.from_unit, "from_unit");
+        const unit = text(request.to_unit, "to_unit");
+        result = { amount: amount * factor, unit, factor };
+        formula = "amount * factor; factor is explicitly supplied in to_unit / from_unit";
+    }
+    else if (request.operation === "balance") {
+        const unit = text(request.unit, "unit");
+        const sums = { inputs: 0, outputs: 0 };
+        for (const name of ["inputs", "outputs"]) {
+            const items = request[name];
+            if (!Array.isArray(items) || !items.length)
+                throw new ConsumptionError("PCR_CALCULATION_INPUT", `${name} must be a non-empty array of {amount, label} in the declared common unit and basis.`);
+            sums[name] = items.reduce((sum, item, index) => {
+                if (!object(item))
+                    throw new ConsumptionError("PCR_CALCULATION_INPUT", `${name}[${index}] must be an amount/label object.`);
+                text(item.label, `${name}[${index}].label`);
+                return sum + strictNumber(item.amount, `${name}[${index}].amount`);
+            }, 0);
+        }
+        const accumulation = strictNumber(request.accumulation, "accumulation");
+        result = { input_total: sums.inputs, output_total: sums.outputs, accumulation, residual: sums.inputs - sums.outputs - accumulation, unit };
+        formula = "sum(inputs) - sum(outputs) - accumulation; positive residual is unaccounted net input";
+    }
+    else {
+        throw new ConsumptionError("PCR_CALCULATION_OPERATION", "Use operation normalize, convert or balance. No formulas, factors or units are inferred.");
+    }
+    if (Object.values(result).some((value) => typeof value === "number" && !Number.isFinite(value)))
+        throw new ConsumptionError("PCR_CALCULATION_OVERFLOW", "Calculation produced a non-finite number; rescale or correct the input quantities.");
+    return {
+        schema_version: 1, calculation_kind: "tiangong-pcr-arithmetic", operation: request.operation,
+        request, formula, result, basis, evidence,
+        interpretation: "Arithmetic only, using supplied values and JavaScript floating-point precision. Physical applicability, evidence quality, tolerance and anomaly judgment are not evaluated.",
+    };
+}
+//# sourceMappingURL=consumption-calculation.js.map

package/packages/pcr-core/src/consumption-calculation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumption-calculation.js","sourceRoot":"pcr://source/","sources":["packages/pcr-core/src/consumption-calculation.ts"],"names":[],"mappings":"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","sourcesContent":["import { ConsumptionError, object, strictNumber } from \"./consumption-data.ts\";\n\nfunction text(value: unknown, name: string): string {\n  if (typeof value !== \"string\" || !value.trim()) throw new ConsumptionError(\"PCR_CALCULATION_INPUT\", `${name} must state the unit, basis or evidence explicitly.`, { field: name });\n  return value;\n}\n\n// Arithmetic only: the Agent owns physical equivalence, applicability and evidence.\nexport function calculate(request: unknown) {\n  if (!object(request)) throw new ConsumptionError(\"PCR_CALCULATION_INPUT\", \"Use a JSON object with operation normalize, convert or balance. See calculate --help.\");\n  const evidence = text(request.evidence, \"evidence\");\n  const basis = text(request.basis, \"basis\");\n  let result: { amount: number; unit: string; factor: number } | { input_total: number; output_total: number; accumulation: number; residual: number; unit: string };\n  let formula;\n  if (request.operation === \"normalize\") {\n    const amount = strictNumber(request.amount, \"amount\");\n    const sourceReference = strictNumber(request.source_reference, \"source_reference\", { positive: true });\n    const targetReference = strictNumber(request.target_reference, \"target_reference\", { positive: true });\n    const unit = text(request.unit, \"unit\");\n    text(request.reference_unit, \"reference_unit\");\n    result = { amount: amount * targetReference / sourceReference, unit, factor: targetReference / sourceReference };\n    formula = \"amount * target_reference / source_reference; both reference quantities share reference_unit and the stated physical basis\";\n  } else if (request.operation === \"convert\") {\n    const amount = strictNumber(request.amount, \"amount\");\n    const factor = strictNumber(request.factor, \"factor\", { positive: true });\n    text(request.from_unit, \"from_unit\");\n    const unit = text(request.to_unit, \"to_unit\");\n    result = { amount: amount * factor, unit, factor };\n    formula = \"amount * factor; factor is explicitly supplied in to_unit / from_unit\";\n  } else if (request.operation === \"balance\") {\n    const unit = text(request.unit, \"unit\");\n    const sums = { inputs: 0, outputs: 0 };\n    for (const name of [\"inputs\", \"outputs\"] as const) {\n      const items = request[name];\n      if (!Array.isArray(items) || !items.length) throw new ConsumptionError(\"PCR_CALCULATION_INPUT\", `${name} must be a non-empty array of {amount, label} in the declared common unit and basis.`);\n      sums[name] = items.reduce((sum: number, item: unknown, index: number) => {\n        if (!object(item)) throw new ConsumptionError(\"PCR_CALCULATION_INPUT\", `${name}[${index}] must be an amount/label object.`);\n        text(item.label, `${name}[${index}].label`);\n        return sum + strictNumber(item.amount, `${name}[${index}].amount`);\n      }, 0);\n    }\n    const accumulation = strictNumber(request.accumulation, \"accumulation\");\n    result = { input_total: sums.inputs, output_total: sums.outputs, accumulation, residual: sums.inputs - sums.outputs - accumulation, unit };\n    formula = \"sum(inputs) - sum(outputs) - accumulation; positive residual is unaccounted net input\";\n  } else {\n    throw new ConsumptionError(\"PCR_CALCULATION_OPERATION\", \"Use operation normalize, convert or balance. No formulas, factors or units are inferred.\");\n  }\n  if (Object.values(result).some((value) => typeof value === \"number\" && !Number.isFinite(value))) throw new ConsumptionError(\"PCR_CALCULATION_OVERFLOW\", \"Calculation produced a non-finite number; rescale or correct the input quantities.\");\n  return {\n    schema_version: 1, calculation_kind: \"tiangong-pcr-arithmetic\", operation: request.operation,\n    request, formula, result, basis, evidence,\n    interpretation: \"Arithmetic only, using supplied values and JavaScript floating-point precision. Physical applicability, evidence quality, tolerance and anomaly judgment are not evaluated.\",\n  };\n}\n"]}

package/packages/pcr-core/src/consumption-data.js

@@ -0,0 +1,99 @@
+import { createHash } from 'node:crypto';
+import { readFileSync, statSync } from 'node:fs';
+import path from 'node:path';
+export class ConsumptionError extends Error {
+    code;
+    details;
+    constructor(code, message, details = {}) {
+        super(message);
+        this.name = 'ConsumptionError';
+        this.code = code;
+        this.details = details;
+    }
+}
+export const sha256 = (bytes) => `sha256:${createHash('sha256').update(bytes).digest('hex')}`;
+export const object = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+export const pointerToken = (value) => String(value).replaceAll('~', '~0').replaceAll('/', '~1');
+export function atPointer(value, pointer) {
+    if (typeof pointer !== 'string' || (pointer !== '' && !pointer.startsWith('/')) || /~(?:[^01]|$)/u.test(pointer)) {
+        throw new ConsumptionError('PCR_POINTER_INVALID', 'Use an RFC 6901 JSON Pointer, such as /processDataSet/exchanges/exchange/0.');
+    }
+    if (pointer === '')
+        return value;
+    let current = value;
+    for (const encoded of pointer.slice(1).split('/')) {
+        const key = encoded.replaceAll('~1', '/').replaceAll('~0', '~');
+        if (current === null || typeof current !== 'object' || !Object.hasOwn(current, key)
+            || (Array.isArray(current) && !/^(0|[1-9]\d*)$/u.test(key))) {
+            throw new ConsumptionError('PCR_POINTER_NOT_FOUND', `No value exists at ${pointer}. Inspect the summary or a paged section first.`, { pointer });
+        }
+        // Index by the exact decoded token: numeric coercion could round a large
+        // token to a different property. The own-property check excludes prototypes.
+        current = current[key];
+    }
+    return current;
+}
+function message(error) { return error instanceof Error ? error.message : String(error); }
+export function readJsonDocument(filename, maxBytes = 16 * 1024 * 1024) {
+    const file = path.resolve(filename);
+    let bytes;
+    try {
+        const stat = statSync(file);
+        if (!stat.isFile() || stat.size > maxBytes) {
+            throw new ConsumptionError('PCR_INPUT_SIZE', `Expected a JSON file no larger than ${maxBytes} bytes: ${file}`);
+        }
+        bytes = readFileSync(file);
+        if (bytes.length > maxBytes)
+            throw new ConsumptionError('PCR_INPUT_SIZE', `Input grew beyond ${maxBytes} bytes: ${file}`);
+    }
+    catch (error) {
+        if (error instanceof ConsumptionError)
+            throw error;
+        throw new ConsumptionError('PCR_INPUT_READ', `Cannot read local JSON file ${file}: ${message(error)}`, { file });
+    }
+    try {
+        // Fatal decoding prevents malformed bytes from silently becoming U+FFFD.
+        // Keep BOM in decoding and remove exactly one, preserving the legacy rule.
+        const text = new TextDecoder('utf-8', { fatal: true, ignoreBOM: true }).decode(bytes).replace(/^\uFEFF/u, '');
+        const value = JSON.parse(text);
+        return { file, sha256: sha256(bytes), bytes: bytes.length, value };
+    }
+    catch (error) {
+        throw new ConsumptionError('PCR_INPUT_JSON', `Malformed JSON in ${file}: ${message(error)}`, { file });
+    }
+}
+export function entriesAt(value, pointer) {
+    if (value === undefined || value === null)
+        return [];
+    const items = Array.isArray(value) ? value : null;
+    return items ? items.map((item, index) => ({ pointer: `${pointer}/${index}`, value: item })) : [{ pointer, value }];
+}
+export function paginate(items, page = 1, pageSize = 10) {
+    if (typeof page !== 'number' || typeof pageSize !== 'number' || !Number.isSafeInteger(page) || page < 1
+        || !Number.isSafeInteger(pageSize) || pageSize < 1 || pageSize > 100) {
+        throw new ConsumptionError('PCR_PAGE_INVALID', 'Use --page >= 1 and --page-size from 1 to 100.');
+    }
+    const pages = Math.max(1, Math.ceil(items.length / pageSize));
+    if (page > pages)
+        throw new ConsumptionError('PCR_PAGE_RANGE', `Page ${page} exceeds ${pages}; use --page ${pages}.`);
+    return { items: items.slice((page - 1) * pageSize, page * pageSize),
+        pagination: { page, page_size: pageSize, total: items.length, total_pages: pages, has_more: page < pages } };
+}
+/** Legacy bounded inspection utility. Semantic selected guidance must retain its
+ * complete value and source context instead of passing through this helper. */
+export function preview(value, maxChars = 2400) {
+    const json = JSON.stringify(value);
+    if (json === undefined)
+        throw new TypeError('Value has no JSON representation.');
+    return json.length <= maxChars ? { value, truncated: false }
+        : { excerpt: json.slice(0, maxChars), truncated: true, total_characters: json.length };
+}
+export function strictNumber(value, name, { positive = false } = {}) {
+    if ((typeof value !== 'number' && typeof value !== 'string')
+        || (typeof value === 'string' && !/^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][+-]?\d+)?$/u.test(value))
+        || !Number.isFinite(Number(value)) || (positive && Number(value) <= 0)) {
+        throw new ConsumptionError('PCR_NUMBER_INVALID', `${name} must be a finite${positive ? ' positive' : ''} decimal number. Missing values are not zero.`, { field: name });
+    }
+    return Number(value);
+}
+//# sourceMappingURL=consumption-data.js.map

package/packages/pcr-core/src/consumption-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumption-data.js","sourceRoot":"pcr://source/","sources":["packages/pcr-core/src/consumption-data.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash, type BinaryLike } from 'node:crypto';\nimport { readFileSync, statSync } from 'node:fs';\nimport path from 'node:path';\n\nexport class ConsumptionError extends Error {\n  readonly code: string;\n  readonly details: Readonly<Record<string, unknown>>;\n  constructor(code: string, message: string, details: Readonly<Record<string, unknown>> = {}) {\n    super(message);\n    this.name = 'ConsumptionError';\n    this.code = code;\n    this.details = details;\n  }\n}\n\nexport const sha256 = (bytes: BinaryLike): string => `sha256:${createHash('sha256').update(bytes).digest('hex')}`;\nexport const object = (value: unknown): value is Record<string, unknown> =>\n  value !== null && typeof value === 'object' && !Array.isArray(value);\nexport const pointerToken = (value: unknown): string => String(value).replaceAll('~', '~0').replaceAll('/', '~1');\n\nexport function atPointer(value: unknown, pointer: unknown): unknown {\n  if (typeof pointer !== 'string' || (pointer !== '' && !pointer.startsWith('/')) || /~(?:[^01]|$)/u.test(pointer)) {\n    throw new ConsumptionError('PCR_POINTER_INVALID', 'Use an RFC 6901 JSON Pointer, such as /processDataSet/exchanges/exchange/0.');\n  }\n  if (pointer === '') return value;\n  let current: unknown = value;\n  for (const encoded of pointer.slice(1).split('/')) {\n    const key = encoded.replaceAll('~1', '/').replaceAll('~0', '~');\n    if (current === null || typeof current !== 'object' || !Object.hasOwn(current, key)\n      || (Array.isArray(current) && !/^(0|[1-9]\\d*)$/u.test(key))) {\n      throw new ConsumptionError('PCR_POINTER_NOT_FOUND', `No value exists at ${pointer}. Inspect the summary or a paged section first.`, { pointer });\n    }\n    // Index by the exact decoded token: numeric coercion could round a large\n    // token to a different property. The own-property check excludes prototypes.\n    current = (current as Record<string, unknown>)[key];\n  }\n  return current;\n}\n\nexport interface JsonDocument {\n  readonly file: string;\n  readonly sha256: string;\n  readonly bytes: number;\n  readonly value: unknown;\n}\nfunction message(error: unknown): string { return error instanceof Error ? error.message : String(error); }\n\nexport function readJsonDocument(filename: string, maxBytes = 16 * 1024 * 1024): JsonDocument {\n  const file = path.resolve(filename);\n  let bytes: Buffer;\n  try {\n    const stat = statSync(file);\n    if (!stat.isFile() || stat.size > maxBytes) {\n      throw new ConsumptionError('PCR_INPUT_SIZE', `Expected a JSON file no larger than ${maxBytes} bytes: ${file}`);\n    }\n    bytes = readFileSync(file);\n    if (bytes.length > maxBytes) throw new ConsumptionError('PCR_INPUT_SIZE', `Input grew beyond ${maxBytes} bytes: ${file}`);\n  } catch (error: unknown) {\n    if (error instanceof ConsumptionError) throw error;\n    throw new ConsumptionError('PCR_INPUT_READ', `Cannot read local JSON file ${file}: ${message(error)}`, { file });\n  }\n  try {\n    // Fatal decoding prevents malformed bytes from silently becoming U+FFFD.\n    // Keep BOM in decoding and remove exactly one, preserving the legacy rule.\n    const text = new TextDecoder('utf-8', { fatal: true, ignoreBOM: true }).decode(bytes).replace(/^\\uFEFF/u, '');\n    const value: unknown = JSON.parse(text);\n    return { file, sha256: sha256(bytes), bytes: bytes.length, value };\n  } catch (error: unknown) {\n    throw new ConsumptionError('PCR_INPUT_JSON', `Malformed JSON in ${file}: ${message(error)}`, { file });\n  }\n}\n\nexport interface PointerEntry { readonly pointer: string; readonly value: unknown }\nexport function entriesAt(value: unknown, pointer: string): PointerEntry[] {\n  if (value === undefined || value === null) return [];\n  const items: readonly unknown[] | null = Array.isArray(value) ? value : null;\n  return items ? items.map((item, index) => ({ pointer: `${pointer}/${index}`, value: item })) : [{ pointer, value }];\n}\n\nexport interface Pagination {\n  readonly page: number;\n  readonly page_size: number;\n  readonly total: number;\n  readonly total_pages: number;\n  readonly has_more: boolean;\n}\nexport function paginate<T>(items: readonly T[], page: unknown = 1, pageSize: unknown = 10): { items: T[]; pagination: Pagination } {\n  if (typeof page !== 'number' || typeof pageSize !== 'number' || !Number.isSafeInteger(page) || page < 1\n    || !Number.isSafeInteger(pageSize) || pageSize < 1 || pageSize > 100) {\n    throw new ConsumptionError('PCR_PAGE_INVALID', 'Use --page >= 1 and --page-size from 1 to 100.');\n  }\n  const pages = Math.max(1, Math.ceil(items.length / pageSize));\n  if (page > pages) throw new ConsumptionError('PCR_PAGE_RANGE', `Page ${page} exceeds ${pages}; use --page ${pages}.`);\n  return { items: items.slice((page - 1) * pageSize, page * pageSize),\n    pagination: { page, page_size: pageSize, total: items.length, total_pages: pages, has_more: page < pages } };\n}\n\nexport type Preview<T> = { readonly value: T; readonly truncated: false }\n  | { readonly excerpt: string; readonly truncated: true; readonly total_characters: number };\n/** Legacy bounded inspection utility. Semantic selected guidance must retain its\n * complete value and source context instead of passing through this helper. */\nexport function preview<T>(value: T, maxChars = 2400): Preview<T> {\n  const json = JSON.stringify(value);\n  if (json === undefined) throw new TypeError('Value has no JSON representation.');\n  return json.length <= maxChars ? { value, truncated: false }\n    : { excerpt: json.slice(0, maxChars), truncated: true, total_characters: json.length };\n}\n\nexport function strictNumber(value: unknown, name: string, { positive = false }: { positive?: boolean } = {}): number {\n  if ((typeof value !== 'number' && typeof value !== 'string')\n    || (typeof value === 'string' && !/^[+-]?(?:\\d+(?:\\.\\d*)?|\\.\\d+)(?:[eE][+-]?\\d+)?$/u.test(value))\n    || !Number.isFinite(Number(value)) || (positive && Number(value) <= 0)) {\n    throw new ConsumptionError('PCR_NUMBER_INVALID', `${name} must be a finite${positive ? ' positive' : ''} decimal number. Missing values are not zero.`, { field: name });\n  }\n  return Number(value);\n}\n"]}

package/packages/pcr-core/src/consumption-guidance.js

@@ -0,0 +1,107 @@
+import { ConsumptionError, atPointer, entriesAt, object, paginate } from './consumption-data.js';
+import { Ajv2020 } from 'ajv/dist/2020.js';
+import structuredSchema from '../schemas/structured-projection.schema.json' with { type: 'json' };
+import vocabularySchema from '../schemas/controlled-vocabulary.schema.json' with { type: 'json' };
+import { assertGuidanceContextConsistency } from './compiler/guidance-context.js';
+import { getVerifiedPcrProjection } from "./index.js";
+const TOPICS = {
+    overview: ['product_category_identity', 'functional_unit', 'boundary_abstraction'],
+    'reference-flow': ['functional_unit', 'reference_flow_definition'],
+    boundary: ['system_boundary/rules', 'boundary_abstraction'], measurement: ['measurement_rules'],
+    inventory: ['process_map', 'process_inventory'], collection: ['dataset_production/collection_protocols'],
+    calculation: ['dataset_production/calculation_rules'], allocation: ['allocation_rules'],
+    quality: ['data_quality_rules', 'dataset_production/data_quality_requirements', 'published_dataset_profile'],
+    validation: ['validation_rules'], sources: ['data_sources'],
+};
+export const GUIDANCE_TOPICS = Object.keys(TOPICS);
+const contextValidator = new Ajv2020({ strict: true, schemas: [structuredSchema, vocabularySchema] }).compile({ $ref: `${structuredSchema.$id}#/$defs/normativeContext` });
+function provenance(value) {
+    return object(value) && (value.kind === 'stored_projection' || value.kind === 'derived_legacy_source')
+        && value.compiler_contract_version === '2' && (value.stored_projection_schema_version === 1 || value.stored_projection_schema_version === 2)
+        && ['stored_projection_sha256', 'source_sha256', 'context_sha256'].every(key => typeof value[key] === 'string' && /^sha256:[0-9a-f]{64}$/u.test(value[key]));
+}
+function verified(value) {
+    if (!object(value) || !object(value.pcr) || !object(value.readiness) || !object(value.structured)
+        || typeof value.source_structured !== 'string' || !contextValidator(value.normative_context)
+        || !provenance(value.normative_context_provenance)) {
+        throw new ConsumptionError('PCR_INTERNAL_CONTRACT_INVALID', 'Verified projection lacks complete normative source context.');
+    }
+    const snapshot = { pcr: value.pcr, readiness: value.readiness, structured: value.structured,
+        source_structured: value.source_structured, normative_context: value.normative_context,
+        normative_context_provenance: value.normative_context_provenance };
+    assertGuidanceContextConsistency(snapshot.structured, snapshot);
+    return snapshot;
+}
+export function projectionBinding(value) {
+    if (!object(value) || !object(value.pcr) || !object(value.readiness) || !object(value.structured)) {
+        throw new ConsumptionError('PCR_INTERNAL_CONTRACT_INVALID', 'Invalid verified projection binding.');
+    }
+    const metadata = value.structured.projection_metadata;
+    if (!object(metadata) || !object(metadata.canonical_markdown)
+        || typeof value.pcr.id !== 'string' || !value.pcr.id || (value.pcr.version !== null && (typeof value.pcr.version !== 'string' || !value.pcr.version))
+        || typeof value.readiness.methodology_status !== 'string' || !value.readiness.methodology_status
+        || typeof metadata.generated_content_sha256 !== 'string' || !/^sha256:[0-9a-f]{64}$/u.test(metadata.generated_content_sha256)
+        || typeof metadata.canonical_markdown.sha256 !== 'string' || !/^sha256:[0-9a-f]{64}$/u.test(metadata.canonical_markdown.sha256)) {
+        throw new ConsumptionError('PCR_INTERNAL_CONTRACT_INVALID', 'Projection identity and fingerprint fields are invalid.');
+    }
+    return { pcr_id: value.pcr.id, version: value.pcr.version,
+        projection_sha256: metadata.generated_content_sha256, markdown_sha256: metadata.canonical_markdown.sha256,
+        methodology_status: value.readiness.methodology_status };
+}
+export function pcrEvidence(snapshot, pointer) { return { ...projectionBinding(snapshot), pointer }; }
+function contextSelection(snapshot, pointers, requested = pointers) {
+    const context = snapshot.normative_context;
+    const bindings = context.bindings.filter(binding => pointers.some(pointer => pointer === '' || pointer === binding.pointer || pointer.startsWith(`${binding.pointer}/`) || binding.pointer.startsWith(`${pointer}/`)));
+    const ids = new Set(bindings.map(binding => binding.unit_id));
+    const boundUnits = new Set(context.bindings.map(binding => binding.unit_id));
+    for (const unit of context.units) {
+        const familyPointer = unit.family === 'system_boundary' ? '/system_boundary/rules' : unit.family === 'allocation' ? '/allocation_rules' : '/validation_rules';
+        if (!boundUnits.has(unit.unit_id) && requested.some(pointer => pointer === '' || familyPointer.startsWith(pointer) || pointer.startsWith(familyPointer)))
+            ids.add(unit.unit_id);
+    }
+    return {
+        normalization: context.normalization, source_sha256: context.source_sha256,
+        parent_context_sha256: snapshot.normative_context_provenance.context_sha256,
+        complete_for_selected_values: true,
+        units: context.units.filter(unit => ids.has(unit.unit_id)), bindings,
+        diagnostics: context.diagnostics.filter(diagnostic => ids.has(diagnostic.unit_id)),
+    };
+}
+/** Pure selection over a core-verified envelope. Values are complete; pagination
+ * limits item count rather than cutting an individual requirement into characters. */
+export function selectGuidanceFromSnapshot(value, { topic = 'overview', pointer, page = 1, pageSize = 10 } = {}) {
+    const snapshot = verified(value);
+    const base = {
+        schema_version: 2, guidance_kind: 'tiangong-pcr-guidance-selection',
+        pcr: projectionBinding(snapshot), readiness: snapshot.readiness, source_structured: snapshot.source_structured,
+        source_markdown: snapshot.source_structured.replace(/structured\.yaml$/u, 'pcr.en-US.md'), topics: GUIDANCE_TOPICS,
+        normative_context_provenance: snapshot.normative_context_provenance,
+        citation_note: 'Pointers and stored hashes address the verified stored projection. Complete selected values include their source units and ancestor context. Legacy enrichment has separate context provenance. Applicability remains an Agent judgment; fallback identities and pointers are snapshot-bound.',
+    };
+    if (pointer !== undefined)
+        return { ...base, source: pcrEvidence(snapshot, pointer), value: atPointer(snapshot.structured, pointer), normative_context_selection: contextSelection(snapshot, [pointer]) };
+    const names = Object.hasOwn(TOPICS, topic) ? TOPICS[topic] : undefined;
+    if (!names)
+        throw new ConsumptionError('PCR_GUIDANCE_TOPIC', `Use --topic ${GUIDANCE_TOPICS.join('|')}.`);
+    const entries = [];
+    for (const name of names) {
+        const sourcePointer = `/${name}`;
+        let selected;
+        try {
+            selected = atPointer(snapshot.structured, sourcePointer);
+        }
+        catch (error) {
+            if (!(error instanceof ConsumptionError) || error.code !== 'PCR_POINTER_NOT_FOUND')
+                throw error;
+        }
+        for (const entry of entriesAt(selected, sourcePointer)) {
+            entries.push({ source: pcrEvidence(snapshot, entry.pointer),
+                rule_id: object(entry.value) ? entry.value.rule_id ?? entry.value.protocol_id ?? entry.value.row_id ?? entry.value.id ?? null : null,
+                value: entry.value, truncated: false });
+        }
+    }
+    const selected = paginate(entries, page, pageSize);
+    return { ...base, topic, ...selected, normative_context_selection: contextSelection(snapshot, selected.items.map(item => item.source.pointer), names.map(name => `/${name}`)) };
+}
+export function selectGuidance(options) { return selectGuidanceFromSnapshot(getVerifiedPcrProjection(options), options); }
+//# sourceMappingURL=consumption-guidance.js.map

package/packages/pcr-core/src/consumption-guidance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumption-guidance.js","sourceRoot":"pcr://source/","sources":["packages/pcr-core/src/consumption-guidance.ts"],"names":[],"mappings":"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","sourcesContent":["import { ConsumptionError, atPointer, entriesAt, object, paginate } from './consumption-data.ts';\nimport { Ajv2020 } from 'ajv/dist/2020.js';\nimport structuredSchema from '../schemas/structured-projection.schema.json' with { type: 'json' };\nimport vocabularySchema from '../schemas/controlled-vocabulary.schema.json' with { type: 'json' };\nimport type { NormativeProjectionContext } from './compiler/normative-projection.ts';\nimport { assertGuidanceContextConsistency, type GuidanceContextProvenance } from './compiler/guidance-context.ts';\nimport type { GuidanceContextEnvelope } from './compiler/guidance-context.ts';\n\nimport { getVerifiedPcrProjection } from \"./index.ts\";\nconst TOPICS: Readonly<Record<string, readonly string[]>> = {\n  overview: ['product_category_identity', 'functional_unit', 'boundary_abstraction'],\n  'reference-flow': ['functional_unit', 'reference_flow_definition'],\n  boundary: ['system_boundary/rules', 'boundary_abstraction'], measurement: ['measurement_rules'],\n  inventory: ['process_map', 'process_inventory'], collection: ['dataset_production/collection_protocols'],\n  calculation: ['dataset_production/calculation_rules'], allocation: ['allocation_rules'],\n  quality: ['data_quality_rules', 'dataset_production/data_quality_requirements', 'published_dataset_profile'],\n  validation: ['validation_rules'], sources: ['data_sources'],\n};\nexport const GUIDANCE_TOPICS = Object.keys(TOPICS);\nexport interface GuidanceOptions {\n  root?: string; pcrId: string; topic?: string; pointer?: string; page?: number; pageSize?: number;\n}\ninterface VerifiedSnapshot extends GuidanceContextEnvelope {\n  pcr: Record<string, unknown>; readiness: Record<string, unknown>;\n  source_structured: string; structured: Record<string, unknown>;\n}\nconst contextValidator = new Ajv2020({ strict: true, schemas: [structuredSchema, vocabularySchema] }).compile<NormativeProjectionContext>({ $ref: `${structuredSchema.$id}#/$defs/normativeContext` });\nfunction provenance(value: unknown): value is GuidanceContextProvenance {\n  return object(value) && (value.kind === 'stored_projection' || value.kind === 'derived_legacy_source')\n    && value.compiler_contract_version === '2' && (value.stored_projection_schema_version === 1 || value.stored_projection_schema_version === 2)\n    && ['stored_projection_sha256', 'source_sha256', 'context_sha256'].every(key => typeof value[key] === 'string' && /^sha256:[0-9a-f]{64}$/u.test(value[key]));\n}\nfunction verified(value: unknown): VerifiedSnapshot {\n  if (!object(value) || !object(value.pcr) || !object(value.readiness) || !object(value.structured)\n    || typeof value.source_structured !== 'string' || !contextValidator(value.normative_context)\n    || !provenance(value.normative_context_provenance)) {\n    throw new ConsumptionError('PCR_INTERNAL_CONTRACT_INVALID', 'Verified projection lacks complete normative source context.');\n  }\n  const snapshot = { pcr: value.pcr, readiness: value.readiness, structured: value.structured,\n    source_structured: value.source_structured, normative_context: value.normative_context,\n    normative_context_provenance: value.normative_context_provenance };\n  assertGuidanceContextConsistency(snapshot.structured, snapshot);\n  return snapshot;\n}\nexport function projectionBinding(value: unknown) {\n  if (!object(value) || !object(value.pcr) || !object(value.readiness) || !object(value.structured)) {\n    throw new ConsumptionError('PCR_INTERNAL_CONTRACT_INVALID', 'Invalid verified projection binding.');\n  }\n  const metadata = value.structured.projection_metadata;\n  if (!object(metadata) || !object(metadata.canonical_markdown)\n    || typeof value.pcr.id !== 'string' || !value.pcr.id || (value.pcr.version !== null && (typeof value.pcr.version !== 'string' || !value.pcr.version))\n    || typeof value.readiness.methodology_status !== 'string' || !value.readiness.methodology_status\n    || typeof metadata.generated_content_sha256 !== 'string' || !/^sha256:[0-9a-f]{64}$/u.test(metadata.generated_content_sha256)\n    || typeof metadata.canonical_markdown.sha256 !== 'string' || !/^sha256:[0-9a-f]{64}$/u.test(metadata.canonical_markdown.sha256)) {\n    throw new ConsumptionError('PCR_INTERNAL_CONTRACT_INVALID', 'Projection identity and fingerprint fields are invalid.');\n  }\n  return { pcr_id: value.pcr.id, version: value.pcr.version,\n    projection_sha256: metadata.generated_content_sha256, markdown_sha256: metadata.canonical_markdown.sha256,\n    methodology_status: value.readiness.methodology_status };\n}\nexport function pcrEvidence(snapshot: unknown, pointer: string) { return { ...projectionBinding(snapshot), pointer }; }\nfunction contextSelection(snapshot: VerifiedSnapshot, pointers: readonly string[], requested: readonly string[] = pointers) {\n  const context = snapshot.normative_context;\n  const bindings = context.bindings.filter(binding => pointers.some(pointer =>\n    pointer === '' || pointer === binding.pointer || pointer.startsWith(`${binding.pointer}/`) || binding.pointer.startsWith(`${pointer}/`)));\n  const ids = new Set(bindings.map(binding => binding.unit_id));\n  const boundUnits = new Set(context.bindings.map(binding => binding.unit_id));\n  for (const unit of context.units) {\n    const familyPointer = unit.family === 'system_boundary' ? '/system_boundary/rules' : unit.family === 'allocation' ? '/allocation_rules' : '/validation_rules';\n    if (!boundUnits.has(unit.unit_id) && requested.some(pointer => pointer === '' || familyPointer.startsWith(pointer) || pointer.startsWith(familyPointer))) ids.add(unit.unit_id);\n  }\n  return {\n    normalization: context.normalization, source_sha256: context.source_sha256,\n    parent_context_sha256: snapshot.normative_context_provenance.context_sha256,\n    complete_for_selected_values: true,\n    units: context.units.filter(unit => ids.has(unit.unit_id)), bindings,\n    diagnostics: context.diagnostics.filter(diagnostic => ids.has(diagnostic.unit_id)),\n  };\n}\n/** Pure selection over a core-verified envelope. Values are complete; pagination\n * limits item count rather than cutting an individual requirement into characters. */\nexport function selectGuidanceFromSnapshot(value: unknown, { topic = 'overview', pointer, page = 1, pageSize = 10 }: Omit<GuidanceOptions, 'root' | 'pcrId'> = {}) {\n  const snapshot = verified(value);\n  const base = {\n    schema_version: 2, guidance_kind: 'tiangong-pcr-guidance-selection',\n    pcr: projectionBinding(snapshot), readiness: snapshot.readiness, source_structured: snapshot.source_structured,\n    source_markdown: snapshot.source_structured.replace(/structured\\.yaml$/u, 'pcr.en-US.md'), topics: GUIDANCE_TOPICS,\n    normative_context_provenance: snapshot.normative_context_provenance,\n    citation_note: 'Pointers and stored hashes address the verified stored projection. Complete selected values include their source units and ancestor context. Legacy enrichment has separate context provenance. Applicability remains an Agent judgment; fallback identities and pointers are snapshot-bound.',\n  };\n  if (pointer !== undefined) return { ...base, source: pcrEvidence(snapshot, pointer), value: atPointer(snapshot.structured, pointer), normative_context_selection: contextSelection(snapshot, [pointer]) };\n  const names = Object.hasOwn(TOPICS, topic) ? TOPICS[topic] : undefined;\n  if (!names) throw new ConsumptionError('PCR_GUIDANCE_TOPIC', `Use --topic ${GUIDANCE_TOPICS.join('|')}.`);\n  const entries = [];\n  for (const name of names) {\n    const sourcePointer = `/${name}`;\n    let selected: unknown;\n    try { selected = atPointer(snapshot.structured, sourcePointer); }\n    catch (error: unknown) { if (!(error instanceof ConsumptionError) || error.code !== 'PCR_POINTER_NOT_FOUND') throw error; }\n    for (const entry of entriesAt(selected, sourcePointer)) {\n      entries.push({ source: pcrEvidence(snapshot, entry.pointer),\n        rule_id: object(entry.value) ? entry.value.rule_id ?? entry.value.protocol_id ?? entry.value.row_id ?? entry.value.id ?? null : null,\n        value: entry.value, truncated: false });\n    }\n  }\n  const selected = paginate(entries, page, pageSize);\n  return { ...base, topic, ...selected, normative_context_selection: contextSelection(snapshot, selected.items.map(item => item.source.pointer), names.map(name => `/${name}`)) };\n}\nexport function selectGuidance(options: GuidanceOptions) { return selectGuidanceFromSnapshot(getVerifiedPcrProjection(options), options); }\n"]}

package/packages/pcr-core/src/consumption-review.js

@@ -0,0 +1,103 @@
+import { atPointer } from "./consumption-data.js";
+import { getVerifiedPcrProjection } from "./index.js";
+import { projectionBinding } from "./consumption-guidance.js";
+import { documentIdentity, extractReferences, loadTidasContext } from "./tidas-inspection.js";
+import { validateCoreContract } from "./contracts.js";
+import { isUnknownRecord, unknownField, errorMessage } from "./types.js";
+const TOPICS = ["scope_and_applicability", "reference_basis", "inventory_and_boundary", "allocation", "data_quality"];
+export function prepareReview({ root, pcrId, input, related }) {
+    const snapshot = getVerifiedPcrProjection({ root, pcrId });
+    const context = loadTidasContext({ input, related: related ?? null });
+    const unresolved = extractReferences(context).filter((reference) => reference.status !== "resolved");
+    return {
+        schema_version: 1, report_kind: "tiangong-pcr-agent-review", status: "draft",
+        pcr: projectionBinding(snapshot), inputs: context.documents.map(documentIdentity),
+        scope: {
+            description: `Review of supplied ${context.primary.kind}; the Agent must establish its declared scope and reference basis.`,
+            applicability: "Not assessed. Explain product, technology, gate and PCR applicability before drawing conclusions.",
+            limitations: [
+                "No semantic review or TIDAS schema validation has been performed by this command.",
+                `${unresolved.length} reference(s) could not be uniquely resolved in the supplied local inputs; inspect references before claiming omissions.`,
+                `${context.ignoredFiles.length} JSON file(s) with no native TIDAS dataset root were ignored by input inspection.`,
+                `PCR methodology status: ${snapshot.readiness.methodology_status}; library availability does not promote candidate methodology.`,
+            ],
+        },
+        coverage: TOPICS.map((topic) => ({ topic, status: "not_reviewed", rationale: "Awaiting Agent investigation of applicability and evidence." })),
+        findings: [],
+    };
+}
+export function checkReview({ root, pcrId, input, related, report: rawReport }) {
+    const shape = validateCoreContract("agent-review.schema.json", rawReport);
+    const issues = [];
+    const add = (code, location, message) => { issues.push({ code, location, message }); };
+    let report = null;
+    if (!shape.valid) {
+        for (const error of shape.issues ?? shape.errors)
+            add("report_shape", error.instance_path ?? "", error.message);
+    }
+    else {
+        if (!isUnknownRecord(rawReport))
+            throw new TypeError("Validated review report must be an object.");
+        // Existing strict JSON Schema validation proves the complete envelope shape.
+        // This cast occurs only after success; scientific reasoning remains unchecked.
+        report = rawReport;
+        const snapshot = getVerifiedPcrProjection({ root, pcrId });
+        const binding = projectionBinding(snapshot);
+        const context = loadTidasContext({ input, related: related ?? null });
+        const actual = context.documents.map(documentIdentity);
+        const files = new Map(context.documents.map((doc) => [doc.file, doc]));
+        const sameBinding = (candidate) => Object.entries(binding).every(([key, value]) => unknownField(candidate, key) === value);
+        if (!sameBinding(report.pcr))
+            add("pcr_changed", "/pcr", "PCR identity, content hashes or methodology status differ from the selected verified projection.");
+        if (report.inputs.length !== actual.length || report.inputs.some((item, index) => Object.entries(actual[index] ?? {}).some(([key, value]) => unknownField(item, key) !== value))) {
+            add("inputs_changed", "/inputs", "Input files, identities, order or exact-byte hashes differ. Regenerate the draft bindings and review the changed evidence.");
+        }
+        if (report.status === "reviewed" && !report.coverage.some((item) => item.status === "reviewed"))
+            add("review_empty", "/coverage", "A reviewed report must name at least one actually reviewed topic; otherwise retain draft status.");
+        const ids = new Set();
+        for (const [index, finding] of report.findings.entries()) {
+            const prefix = `/findings/${index}`;
+            if (ids.has(finding.id))
+                add("duplicate_finding", `${prefix}/id`, "Finding IDs must be unique within this report.");
+            ids.add(finding.id);
+            for (const [refIndex, reference] of finding.input_refs.entries()) {
+                const location = `${prefix}/input_refs/${refIndex}`;
+                const doc = files.get(reference.file);
+                if (!doc || reference.sha256 !== doc.sha256)
+                    add("input_reference_changed", location, "Reference must identify an explicitly supplied input and its current exact-byte hash.");
+                else {
+                    try {
+                        atPointer(doc.value, reference.pointer);
+                    }
+                    catch (error) {
+                        add("input_pointer", location, errorMessage(error));
+                    }
+                }
+            }
+            for (const [refIndex, reference] of finding.pcr_refs.entries()) {
+                const location = `${prefix}/pcr_refs/${refIndex}`;
+                if (!sameBinding(reference))
+                    add("pcr_reference_changed", location, "PCR reference does not match the selected verified projection.");
+                else {
+                    try {
+                        atPointer(snapshot.structured, reference.pointer);
+                    }
+                    catch (error) {
+                        add("pcr_pointer", location, errorMessage(error));
+                    }
+                }
+            }
+        }
+    }
+    return {
+        schema_version: 1, check_kind: "tiangong-pcr-review-envelope-check",
+        envelope_valid: issues.length === 0, methodology_approval: false,
+        report_status: report?.status ?? null,
+        checked: ["report_shape", ...(shape.valid ? ["input_and_pcr_bindings", "finding_reference_locations", "review_status_consistency"] : [])],
+        not_checked: ["PCR applicability", "truth of observations or conclusions", "sufficiency of evidence", "coverage completeness", "TIDAS schema validity"],
+        issues,
+        next_step: issues.length ? "Correct the report or re-review changed evidence, then run review check again."
+            : "Have the Agent/user assess the reasoning and remaining scope. Envelope validity does not approve the dataset.",
+    };
+}
+//# sourceMappingURL=consumption-review.js.map

package/packages/pcr-core/src/consumption-review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumption-review.js","sourceRoot":"pcr://source/","sources":["packages/pcr-core/src/consumption-review.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAsBzE,MAAM,MAAM,GAAG,CAAC,yBAAyB,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;AAEtH,MAAM,UAAU,aAAa,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAiB;IAC1E,MAAM,QAAQ,GAAG,wBAAwB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,gBAAgB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC;IACtE,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;IACrG,OAAO;QACL,cAAc,EAAE,CAAC,EAAE,WAAW,EAAE,2BAA2B,EAAE,MAAM,EAAE,OAAO;QAC5E,GAAG,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,gBAAgB,CAAC;QACjF,KAAK,EAAE;YACL,WAAW,EAAE,sBAAsB,OAAO,CAAC,OAAO,CAAC,IAAI,oEAAoE;YAC3H,aAAa,EAAE,mGAAmG;YAClH,WAAW,EAAE;gBACX,mFAAmF;gBACnF,GAAG,UAAU,CAAC,MAAM,0HAA0H;gBAC9I,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,mFAAmF;gBACjH,2BAA2B,QAAQ,CAAC,SAAS,CAAC,kBAAkB,gEAAgE;aACjI;SACF;QACD,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,6DAA6D,EAAE,CAAC,CAAC;QAC9I,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAuC;IACjH,MAAM,KAAK,GAAG,oBAAoB,CAAC,0BAA0B,EAAE,SAAS,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,QAAgB,EAAE,OAAe,EAAQ,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACrH,IAAI,MAAM,GAA6B,IAAI,CAAC;IAC5C,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACjB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM;YAAE,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,aAAa,IAAI,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAClH,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,4CAA4C,CAAC,CAAC;QACnG,6EAA6E;QAC7E,+EAA+E;QAC/E,MAAM,GAAG,SAA8B,CAAC;QACxC,MAAM,QAAQ,GAAG,wBAAwB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,gBAAgB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QACvE,MAAM,WAAW,GAAG,CAAC,SAAkB,EAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC;QAC7I,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC;YAAE,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,kGAAkG,CAAC,CAAC;QAC7J,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjL,GAAG,CAAC,gBAAgB,EAAE,SAAS,EAAE,4HAA4H,CAAC,CAAC;QACjK,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC;YAAE,GAAG,CAAC,cAAc,EAAE,WAAW,EAAE,kGAAkG,CAAC,CAAC;QACtO,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YACzD,MAAM,MAAM,GAAG,aAAa,KAAK,EAAE,CAAC;YACpC,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAAE,GAAG,CAAC,mBAAmB,EAAE,GAAG,MAAM,KAAK,EAAE,gDAAgD,CAAC,CAAC;YACpH,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACpB,KAAK,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;gBACjE,MAAM,QAAQ,GAAG,GAAG,MAAM,eAAe,QAAQ,EAAE,CAAC;gBACpD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBACtC,IAAI,CAAC,GAAG,IAAI,SAAS,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM;oBAAE,GAAG,CAAC,yBAAyB,EAAE,QAAQ,EAAE,uFAAuF,CAAC,CAAC;qBAC1K,CAAC;oBACJ,IAAI,CAAC;wBAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;oBAAC,CAAC;oBAChD,OAAO,KAAK,EAAE,CAAC;wBAAC,GAAG,CAAC,eAAe,EAAE,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;oBAAC,CAAC;gBACxE,CAAC;YACH,CAAC;YACD,KAAK,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC/D,MAAM,QAAQ,GAAG,GAAG,MAAM,aAAa,QAAQ,EAAE,CAAC;gBAClD,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;oBAAE,GAAG,CAAC,uBAAuB,EAAE,QAAQ,EAAE,gEAAgE,CAAC,CAAC;qBACjI,CAAC;oBACJ,IAAI,CAAC;wBAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;oBAAC,CAAC;oBAC1D,OAAO,KAAK,EAAE,CAAC;wBAAC,GAAG,CAAC,aAAa,EAAE,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;oBAAC,CAAC;gBACtE,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO;QACL,cAAc,EAAE,CAAC,EAAE,UAAU,EAAE,oCAAoC;QACnE,cAAc,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,oBAAoB,EAAE,KAAK;QAChE,aAAa,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI;QACrC,OAAO,EAAE,CAAC,cAAc,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,wBAAwB,EAAE,6BAA6B,EAAE,2BAA2B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzI,WAAW,EAAE,CAAC,mBAAmB,EAAE,sCAAsC,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,uBAAuB,CAAC;QACvJ,MAAM;QACN,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,gFAAgF;YACzG,CAAC,CAAC,+GAA+G;KACpH,CAAC;AACJ,CAAC","sourcesContent":["import { atPointer } from \"./consumption-data.ts\";\nimport { getVerifiedPcrProjection } from \"./index.ts\";\nimport { projectionBinding } from \"./consumption-guidance.ts\";\nimport { documentIdentity, extractReferences, loadTidasContext } from \"./tidas-inspection.ts\";\nimport { validateCoreContract } from \"./contracts.ts\";\n\nimport { isUnknownRecord, unknownField, errorMessage } from \"./types.ts\";\n\nexport interface ReviewOptions { root: string; pcrId: string; input: string; related?: string | null }\ntype PcrBinding = ReturnType<typeof projectionBinding>;\ntype InputIdentity = ReturnType<typeof documentIdentity>;\ninterface InputReference { file: string; sha256: string; pointer: string }\ninterface PcrReference extends PcrBinding { pointer: string }\nexport interface AgentReviewFinding {\n  id: string; kind: \"confirmed_issue\" | \"suspected_anomaly\" | \"evidence_gap\";\n  severity: \"error\" | \"warning\" | \"info\"; observation: string; rationale: string;\n  input_refs: InputReference[]; pcr_refs: PcrReference[]; suggested_action: string; questions: string[];\n  alternative_explanations?: string[];\n}\nexport interface AgentReviewReport extends Record<string, unknown> {\n  schema_version: 1; report_kind: \"tiangong-pcr-agent-review\"; status: \"draft\" | \"reviewed\";\n  pcr: PcrBinding; inputs: InputIdentity[];\n  scope: { description: string; applicability: string; limitations: string[] };\n  coverage: { topic: string; status: \"reviewed\" | \"not_applicable\" | \"not_reviewed\"; rationale: string }[];\n  findings: AgentReviewFinding[];\n}\nexport interface ReviewIssue { code: string; location: string; message: string }\n\nconst TOPICS = [\"scope_and_applicability\", \"reference_basis\", \"inventory_and_boundary\", \"allocation\", \"data_quality\"];\n\nexport function prepareReview({ root, pcrId, input, related }: ReviewOptions): AgentReviewReport {\n  const snapshot = getVerifiedPcrProjection({ root, pcrId });\n  const context = loadTidasContext({ input, related: related ?? null });\n  const unresolved = extractReferences(context).filter((reference) => reference.status !== \"resolved\");\n  return {\n    schema_version: 1, report_kind: \"tiangong-pcr-agent-review\", status: \"draft\",\n    pcr: projectionBinding(snapshot), inputs: context.documents.map(documentIdentity),\n    scope: {\n      description: `Review of supplied ${context.primary.kind}; the Agent must establish its declared scope and reference basis.`,\n      applicability: \"Not assessed. Explain product, technology, gate and PCR applicability before drawing conclusions.\",\n      limitations: [\n        \"No semantic review or TIDAS schema validation has been performed by this command.\",\n        `${unresolved.length} reference(s) could not be uniquely resolved in the supplied local inputs; inspect references before claiming omissions.`,\n        `${context.ignoredFiles.length} JSON file(s) with no native TIDAS dataset root were ignored by input inspection.`,\n        `PCR methodology status: ${snapshot.readiness.methodology_status}; library availability does not promote candidate methodology.`,\n      ],\n    },\n    coverage: TOPICS.map((topic) => ({ topic, status: \"not_reviewed\", rationale: \"Awaiting Agent investigation of applicability and evidence.\" })),\n    findings: [],\n  };\n}\n\nexport function checkReview({ root, pcrId, input, related, report: rawReport }: ReviewOptions & { report: unknown }) {\n  const shape = validateCoreContract(\"agent-review.schema.json\", rawReport);\n  const issues: ReviewIssue[] = [];\n  const add = (code: string, location: string, message: string): void => { issues.push({ code, location, message }); };\n  let report: AgentReviewReport | null = null;\n  if (!shape.valid) {\n    for (const error of shape.issues ?? shape.errors) add(\"report_shape\", error.instance_path ?? \"\", error.message);\n  } else {\n    if (!isUnknownRecord(rawReport)) throw new TypeError(\"Validated review report must be an object.\");\n    // Existing strict JSON Schema validation proves the complete envelope shape.\n    // This cast occurs only after success; scientific reasoning remains unchecked.\n    report = rawReport as AgentReviewReport;\n    const snapshot = getVerifiedPcrProjection({ root, pcrId });\n    const binding = projectionBinding(snapshot);\n    const context = loadTidasContext({ input, related: related ?? null });\n    const actual = context.documents.map(documentIdentity);\n    const files = new Map(context.documents.map((doc) => [doc.file, doc]));\n    const sameBinding = (candidate: unknown): boolean => Object.entries(binding).every(([key, value]) => unknownField(candidate, key) === value);\n    if (!sameBinding(report.pcr)) add(\"pcr_changed\", \"/pcr\", \"PCR identity, content hashes or methodology status differ from the selected verified projection.\");\n    if (report.inputs.length !== actual.length || report.inputs.some((item, index) => Object.entries(actual[index] ?? {}).some(([key, value]) => unknownField(item, key) !== value))) {\n      add(\"inputs_changed\", \"/inputs\", \"Input files, identities, order or exact-byte hashes differ. Regenerate the draft bindings and review the changed evidence.\");\n    }\n    if (report.status === \"reviewed\" && !report.coverage.some((item) => item.status === \"reviewed\")) add(\"review_empty\", \"/coverage\", \"A reviewed report must name at least one actually reviewed topic; otherwise retain draft status.\");\n    const ids = new Set();\n    for (const [index, finding] of report.findings.entries()) {\n      const prefix = `/findings/${index}`;\n      if (ids.has(finding.id)) add(\"duplicate_finding\", `${prefix}/id`, \"Finding IDs must be unique within this report.\");\n      ids.add(finding.id);\n      for (const [refIndex, reference] of finding.input_refs.entries()) {\n        const location = `${prefix}/input_refs/${refIndex}`;\n        const doc = files.get(reference.file);\n        if (!doc || reference.sha256 !== doc.sha256) add(\"input_reference_changed\", location, \"Reference must identify an explicitly supplied input and its current exact-byte hash.\");\n        else {\n          try { atPointer(doc.value, reference.pointer); }\n          catch (error) { add(\"input_pointer\", location, errorMessage(error)); }\n        }\n      }\n      for (const [refIndex, reference] of finding.pcr_refs.entries()) {\n        const location = `${prefix}/pcr_refs/${refIndex}`;\n        if (!sameBinding(reference)) add(\"pcr_reference_changed\", location, \"PCR reference does not match the selected verified projection.\");\n        else {\n          try { atPointer(snapshot.structured, reference.pointer); }\n          catch (error) { add(\"pcr_pointer\", location, errorMessage(error)); }\n        }\n      }\n    }\n  }\n  return {\n    schema_version: 1, check_kind: \"tiangong-pcr-review-envelope-check\",\n    envelope_valid: issues.length === 0, methodology_approval: false,\n    report_status: report?.status ?? null,\n    checked: [\"report_shape\", ...(shape.valid ? [\"input_and_pcr_bindings\", \"finding_reference_locations\", \"review_status_consistency\"] : [])],\n    not_checked: [\"PCR applicability\", \"truth of observations or conclusions\", \"sufficiency of evidence\", \"coverage completeness\", \"TIDAS schema validity\"],\n    issues,\n    next_step: issues.length ? \"Correct the report or re-review changed evidence, then run review check again.\"\n      : \"Have the Agent/user assess the reasoning and remaining scope. Envelope validity does not approve the dataset.\",\n  };\n}\n"]}