@tiangong-lca/pcr 0.3.1 → 0.4.0

package/packages/pcr-core/src/read-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-session.js","sourceRoot":"pcr://source/","sources":["packages/pcr-core/src/read-session.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from 'node:crypto';\nimport { OfflineLibrary } from './offline-library.ts';\nimport { createPcrReadContext, withPcrReadContextSession } from './read-context.ts';\nimport { withPcrSource, withRepositoryPcrSource } from './source-context.ts';\nimport { projectionFromVerifiedSnapshot, readVerifiedSnapshotForSession } from './index.ts';\nimport { buildGuidanceFromProjection } from './compiler/guidance-envelope.ts';\nimport type { CompleteGuidance, CurrentPcrSnapshot, VerifiedPcrProjection } from './types.ts';\n\nexport const MAX_READ_BATCH = 100;\nexport type PcrReadSource = { kind: 'repository'; root: string } | { kind: 'library'; filename: string; expectedSha256?: string; verify?: boolean };\nexport type PcrReadSourceIdentity = Readonly<{ kind: 'repository'; root: string } | { kind: 'library'; filename: string; content_version: string; source_commit: string; sha256: string; verified: boolean }>;\nexport interface PcrReadSessionStats { records_loaded: number; cache_hits: number; final_verifications: number; alias_validations: number }\nexport interface PcrReadSession {\n  readonly source: PcrReadSourceIdentity;\n  guidance(pcrId: string): CompleteGuidance;\n  projection(pcrId: string): VerifiedPcrProjection;\n  guidanceMany(pcrIds: readonly string[]): CompleteGuidance[];\n  projectionMany(pcrIds: readonly string[]): VerifiedPcrProjection[];\n  stats(): Readonly<PcrReadSessionStats>;\n}\nexport class PcrReadSessionError extends Error {\n  readonly code: string;\n  readonly details: Readonly<Record<string, unknown>>;\n  constructor(code: string, message: string, details: Record<string, unknown> = {}) {\n    super(message); this.name = 'PcrReadSessionError'; this.code = code; this.details = details;\n  }\n}\nfunction validateIds(ids: readonly string[]): string[] {\n  if (!Array.isArray(ids) || ids.length > MAX_READ_BATCH || ids.some(id => typeof id !== 'string' || !id.trim())) {\n    throw new PcrReadSessionError('PCR_READ_BATCH_INVALID', `Provide at most ${MAX_READ_BATCH} nonempty PCR IDs; no partial batch is returned.`);\n  }\n  return [...ids];\n}\nfunction fingerprint(snapshot: CurrentPcrSnapshot): string {\n  const digest = (bytes: Uint8Array) => createHash('sha256').update(bytes).digest('hex');\n  const entries: [string, string][] = [['manifest.yaml', digest(snapshot.manifestBytes)]];\n  for (const name of Object.keys(snapshot.artifacts).sort()) {\n    const artifact = snapshot.artifacts[name];\n    const error: unknown = artifact?.error;\n    const code: unknown = error !== null && typeof error === 'object' ? Reflect.get(error, 'code') : undefined;\n    entries.push([name, artifact?.bytes ? digest(artifact.bytes) : `unavailable:${String(code ?? 'unknown_error')}`]);\n  }\n  return digest(Buffer.from(JSON.stringify(entries)));\n}\nfunction synchronous<T>(read: () => T): T {\n  const result = read();\n  if (result !== null && (typeof result === 'object' || typeof result === 'function')) {\n    const then: unknown = Reflect.get(result, 'then');\n    if (typeof then === 'function') {\n      void Promise.resolve(result).catch(() => {});\n      throw new PcrReadSessionError('PCR_READ_SESSION_ASYNC', 'PCR read sessions require a synchronous callback.');\n    }\n  }\n  return result;\n}\n\n/** One owned, synchronous source scope. Each selected repository record is bound\n * by exact captured bytes and rechecked before return. SQLite already opens one\n * read-only transaction in OfflineLibrary; this function owns its lifetime. */\nexport function withPcrReadSession<T>(source: PcrReadSource, read: (session: PcrReadSession) => T): T {\n  if (typeof read !== 'function' || !source || (source.kind !== 'repository' && source.kind !== 'library')) {\n    throw new PcrReadSessionError('PCR_READ_SOURCE_INVALID', 'Select a repository root or a fixed SQLite library.');\n  }\n  if (source.kind === 'repository' ? typeof source.root !== 'string' || !source.root : typeof source.filename !== 'string' || !source.filename) {\n    throw new PcrReadSessionError('PCR_READ_SOURCE_INVALID', 'The selected source requires a nonempty path.');\n  }\n  if (source.kind === 'library' && ((source.verify !== undefined && typeof source.verify !== 'boolean')\n    || (source.expectedSha256 !== undefined && (typeof source.expectedSha256 !== 'string' || !/^sha256:[a-f0-9]{64}$/u.test(source.expectedSha256))))) {\n    throw new PcrReadSessionError('PCR_READ_SOURCE_INVALID', 'Library verification must be a boolean and its optional pin a sha256 digest.');\n  }\n  let library: OfflineLibrary | undefined;\n  const stats: PcrReadSessionStats = { records_loaded: 0, cache_hits: 0, final_verifications: 0, alias_validations: 0 };\n  let active = true;\n  try {\n    const context = source.kind === 'repository' ? withRepositoryPcrSource(source.root, () => createPcrReadContext({ root: source.root, onAliasValidation: () => { stats.alias_validations += 1; } })) : undefined;\n    if (source.kind === 'library') library = new OfflineLibrary(source.filename, { expectedSha256: source.expectedSha256 ?? null, verify: source.verify ?? true });\n    const selectedRoot = context?.root ?? library?.root;\n    if (!selectedRoot) throw new PcrReadSessionError('PCR_READ_SOURCE_INVALID', 'Source initialization failed.');\n    const root: string = selectedRoot;\n    const adapter = library;\n    const scope = <R>(operation: () => R): R => adapter ? withPcrSource(root, adapter, operation) : withRepositoryPcrSource(root, operation);\n    const identity: PcrReadSourceIdentity = Object.freeze(adapter ? {\n      kind: 'library' as const, filename: adapter.filename, content_version: adapter.manifest.snapshot.content_version,\n      source_commit: adapter.manifest.snapshot.source_commit, sha256: adapter.manifest.sha256,\n      verified: source.kind === 'library' && ((source.verify ?? true) || source.expectedSha256 !== undefined),\n    } : { kind: 'repository' as const, root });\n    const bindings = new Map<string, string>();\n    const cache = new Map<string, VerifiedPcrProjection>();\n    function requireActive(): void { if (!active) throw new PcrReadSessionError('PCR_READ_SESSION_CLOSED', 'PCR read session has ended.'); }\n    function capture(pcrId: string) {\n      return scope(() => readVerifiedSnapshotForSession({ root, pcrId, ...(context ? { context } : {}) }));\n    }\n    function load(pcrId: string): VerifiedPcrProjection {\n      requireActive(); validateIds([pcrId]);\n      const cached = cache.get(pcrId);\n      if (cached) { stats.cache_hits += 1; cache.delete(pcrId); cache.set(pcrId, cached); return cached; }\n      const snapshot = capture(pcrId);\n      const binding = fingerprint(snapshot);\n      const previous = bindings.get(pcrId);\n      if (previous !== undefined && previous !== binding) throw new PcrReadSessionError('PCR_READ_SESSION_STALE', 'Selected PCR source changed during the session.', { pcr_id: pcrId });\n      bindings.set(pcrId, binding);\n      const value = projectionFromVerifiedSnapshot(snapshot, root);\n      stats.records_loaded += 1; cache.set(pcrId, value);\n      if (cache.size > MAX_READ_BATCH) { const oldest = cache.keys().next().value; if (oldest !== undefined) cache.delete(oldest); }\n      return value;\n    }\n    const session: PcrReadSession = Object.freeze({\n      source: identity,\n      guidance: (pcrId: string) => structuredClone(buildGuidanceFromProjection(load(pcrId))),\n      projection: (pcrId: string) => structuredClone(load(pcrId)),\n      guidanceMany: (ids: readonly string[]) => { requireActive(); return validateIds(ids).map(id => structuredClone(buildGuidanceFromProjection(load(id)))); },\n      projectionMany: (ids: readonly string[]) => { requireActive(); return validateIds(ids).map(id => structuredClone(load(id))); },\n      stats: () => Object.freeze({ ...stats }),\n    });\n    const operation = () => {\n      try {\n        const result = synchronous(() => scope(() => read(session)));\n        if (context) {\n          for (const [pcrId, expected] of bindings) {\n            let snapshot: ReturnType<typeof capture>;\n            try { snapshot = capture(pcrId); }\n            catch (error: unknown) { throw new PcrReadSessionError('PCR_READ_SESSION_STALE', 'Selected PCR can no longer be verified.', { pcr_id: pcrId, reason: error instanceof Error ? error.message : String(error) }); }\n            stats.final_verifications += 1;\n            if (fingerprint(snapshot) !== expected) throw new PcrReadSessionError('PCR_READ_SESSION_STALE', 'Selected PCR source changed during the session.', { pcr_id: pcrId });\n          }\n        }\n        return result;\n      } finally { active = false; cache.clear(); }\n    };\n    return context ? withPcrReadContextSession({ context, root, read: operation }) : operation();\n  } finally { active = false; library?.close(); }\n}\n"]}

package/packages/pcr-core/src/schema-validation.js

@@ -0,0 +1,136 @@
+import { Ajv2020 } from "ajv/dist/2020.js";
+import { isUnknownRecord, unknownField } from './types.js';
+export class ContractSchemaError extends Error {
+    code;
+    contract;
+    entity_kind;
+    schema_id;
+    source;
+    issues;
+    errors;
+    constructor({ code = "PCR_SCHEMA_INVALID", contract, entityKind, source = null, issues }) {
+        const location = source ? ` at ${source}` : "";
+        const details = issues.map((issue) => `${issue.instance_path}: ${issue.message}`).join("; ");
+        super(`${entityKind} schema validation failed${location}: ${details}`);
+        this.name = "ContractSchemaError";
+        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 function createSchemaRegistry(schemas, entityKinds = {}) {
+    const ajv = new Ajv2020({
+        allErrors: true,
+        coerceTypes: false,
+        removeAdditional: false,
+        strict: true,
+        useDefaults: false,
+        validateSchema: true,
+    });
+    for (const schema of schemas) {
+        if (!isUnknownRecord(schema) || typeof schema.$id !== "string" || !schema.$id) {
+            throw new Error("Every registered JSON Schema requires a stable $id.");
+        }
+        ajv.addSchema(schema);
+    }
+    return {
+        assert(contract, value, options = {}) {
+            const entityKind = options.entityKind ?? entityKinds[contract] ?? contract;
+            const result = validateRegisteredSchema(ajv, contract, value, entityKind);
+            if (!result.valid) {
+                throw new ContractSchemaError({
+                    code: options.code,
+                    contract,
+                    entityKind,
+                    source: options.source,
+                    issues: result.errors,
+                });
+            }
+            return value;
+        },
+        validate(contract, value, options = {}) {
+            return validateRegisteredSchema(ajv, contract, value, options.entityKind ?? entityKinds[contract] ?? contract);
+        },
+    };
+}
+export function formatContractIssues(issues) {
+    return issues.map((issue) => `${issue.instance_path}: ${issue.message}`);
+}
+export function normalizeSchemaErrors(errors) {
+    return errors
+        .map((error) => {
+        const instancePath = issuePath(error);
+        return {
+            code: `schema.${error.keyword}`,
+            instance_path: instancePath,
+            schema_path: error.schemaPath,
+            keyword: error.keyword,
+            message: error.message ?? "is invalid",
+            params: stableParams(error.params),
+        };
+    })
+        .sort(compareSchemaErrors);
+}
+function validateRegisteredSchema(ajv, contract, value, entityKind) {
+    const validate = ajv.getSchema(contract);
+    if (!validate) {
+        throw new Error(`JSON Schema contract is not registered: ${contract}`);
+    }
+    const valid = validate(value) === true;
+    const errors = valid ? [] : normalizeSchemaErrors(validate.errors ?? []);
+    return {
+        valid,
+        code: valid ? null : "PCR_SCHEMA_INVALID",
+        entity_kind: entityKind,
+        schema_id: contract,
+        errors,
+        // Backward-compatible alias for the earlier internal registry API.
+        issues: errors,
+    };
+}
+function compareSchemaErrors(left, right) {
+    return (left.instance_path.localeCompare(right.instance_path) ||
+        left.keyword.localeCompare(right.keyword) ||
+        left.schema_path.localeCompare(right.schema_path) ||
+        left.message.localeCompare(right.message) ||
+        JSON.stringify(left.params).localeCompare(JSON.stringify(right.params)));
+}
+function issuePath(error) {
+    const missingProperty = unknownField(error.params, "missingProperty");
+    if (error.keyword === "required" && missingProperty) {
+        const escaped = String(missingProperty)
+            .replaceAll("~", "~0")
+            .replaceAll("/", "~1");
+        return `${error.instancePath}/${escaped}` || "/";
+    }
+    return error.instancePath || "/";
+}
+function stableClone(value) {
+    if (Array.isArray(value)) {
+        return value.map(stableClone);
+    }
+    if (!value || typeof value !== "object") {
+        return value;
+    }
+    return Object.fromEntries(Object.keys(value)
+        .sort()
+        .map((key) => [key, stableClone(unknownField(value, key))]));
+}
+function stableParams(value) {
+    const cloned = stableClone(value ?? {});
+    return isUnknownRecord(cloned) ? cloned : {};
+}
+//# sourceMappingURL=schema-validation.js.map

package/packages/pcr-core/src/schema-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validation.js","sourceRoot":"pcr://source/","sources":["packages/pcr-core/src/schema-validation.ts"],"names":[],"mappings":"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","sourcesContent":["import { Ajv2020, type AnySchemaObject, type ErrorObject } from \"ajv/dist/2020.js\";\nimport { isUnknownRecord, unknownField, type ContractOptions, type SchemaIssue, type SchemaRegistry, type ContractValidationResult } from './types.ts';\n\nexport class ContractSchemaError 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({ code = \"PCR_SCHEMA_INVALID\", contract, entityKind, source = null, issues }: {\n    code?: string | undefined; contract: string; entityKind: string; source?: string | null | undefined; issues: readonly SchemaIssue[];\n  }) {\n    const location = source ? ` at ${source}` : \"\";\n    const details = issues.map((issue) => `${issue.instance_path}: ${issue.message}`).join(\"; \");\n    super(`${entityKind} schema validation failed${location}: ${details}`);\n    this.name = \"ContractSchemaError\";\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 function createSchemaRegistry(schemas: readonly unknown[], entityKinds: Readonly<Record<string, string>> = {}): SchemaRegistry {\n  const ajv = new Ajv2020({\n    allErrors: true,\n    coerceTypes: false,\n    removeAdditional: false,\n    strict: true,\n    useDefaults: false,\n    validateSchema: true,\n  });\n\n  for (const schema of schemas) {\n    if (!isUnknownRecord(schema) || typeof schema.$id !== \"string\" || !schema.$id) {\n      throw new Error(\"Every registered JSON Schema requires a stable $id.\");\n    }\n    ajv.addSchema(schema as AnySchemaObject);\n  }\n\n  return {\n    assert<T>(contract: string, value: T, options: ContractOptions = {}): T {\n      const entityKind = options.entityKind ?? entityKinds[contract] ?? contract;\n      const result = validateRegisteredSchema(ajv, contract, value, entityKind);\n      if (!result.valid) {\n        throw new ContractSchemaError({\n          code: options.code,\n          contract,\n          entityKind,\n          source: options.source,\n          issues: result.errors,\n        });\n      }\n      return value;\n    },\n    validate(contract: string, value: unknown, options: ContractOptions = {}): ContractValidationResult {\n      return validateRegisteredSchema(\n        ajv,\n        contract,\n        value,\n        options.entityKind ?? entityKinds[contract] ?? contract,\n      );\n    },\n  };\n}\n\nexport function formatContractIssues(issues: readonly SchemaIssue[]): string[] {\n  return issues.map((issue) => `${issue.instance_path}: ${issue.message}`);\n}\n\nexport function normalizeSchemaErrors(errors: readonly ErrorObject[]): SchemaIssue[] {\n  return errors\n    .map((error) => {\n      const instancePath = issuePath(error);\n      return {\n        code: `schema.${error.keyword}`,\n        instance_path: instancePath,\n        schema_path: error.schemaPath,\n        keyword: error.keyword,\n        message: error.message ?? \"is invalid\",\n        params: stableParams(error.params),\n      };\n    })\n    .sort(compareSchemaErrors);\n}\n\nfunction validateRegisteredSchema(ajv: Ajv2020, contract: string, value: unknown, entityKind: string): ContractValidationResult {\n  const validate = ajv.getSchema(contract);\n  if (!validate) {\n    throw new Error(`JSON Schema contract is not registered: ${contract}`);\n  }\n  const valid = validate(value) === true;\n  const errors = valid ? [] : normalizeSchemaErrors(validate.errors ?? []);\n  return {\n    valid,\n    code: valid ? null : \"PCR_SCHEMA_INVALID\",\n    entity_kind: entityKind,\n    schema_id: contract,\n    errors,\n    // Backward-compatible alias for the earlier internal registry API.\n    issues: errors,\n  };\n}\n\nfunction compareSchemaErrors(left: SchemaIssue, right: SchemaIssue): number {\n  return (\n    left.instance_path.localeCompare(right.instance_path) ||\n    left.keyword.localeCompare(right.keyword) ||\n    left.schema_path.localeCompare(right.schema_path) ||\n    left.message.localeCompare(right.message) ||\n    JSON.stringify(left.params).localeCompare(JSON.stringify(right.params))\n  );\n}\n\nfunction issuePath(error: ErrorObject): string {\n  const missingProperty = unknownField(error.params, \"missingProperty\");\n  if (error.keyword === \"required\" && missingProperty) {\n    const escaped = String(missingProperty)\n      .replaceAll(\"~\", \"~0\")\n      .replaceAll(\"/\", \"~1\");\n    return `${error.instancePath}/${escaped}` || \"/\";\n  }\n  return error.instancePath || \"/\";\n}\n\nfunction stableClone(value: unknown): unknown {\n  if (Array.isArray(value)) {\n    return value.map(stableClone);\n  }\n  if (!value || typeof value !== \"object\") {\n    return value;\n  }\n  return Object.fromEntries(\n    Object.keys(value)\n      .sort()\n      .map((key) => [key, stableClone(unknownField(value, key))]),\n  );\n}\n\nfunction stableParams(value: unknown): Record<string, unknown> {\n  const cloned = stableClone(value ?? {});\n  return isUnknownRecord(cloned) ? cloned : {};\n}\n"]}

package/packages/pcr-core/src/source-context.js

@@ -0,0 +1,18 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import path from 'node:path';
+// Scope a storage adapter to one consumption request. Repository readers remain
+// authoritative by default; adapters do not become a process-global root cache.
+const sources = new AsyncLocalStorage();
+export function withPcrSource(root, source, callback) {
+    return sources.run({ root: path.resolve(root), source }, callback);
+}
+/** Explicit repository selection shadows an enclosing library adapter even when
+ * both resolve to the same root. Normal ALS nesting restores the prior binding. */
+export function withRepositoryPcrSource(root, callback) {
+    return sources.run({ root: path.resolve(root), source: null }, callback);
+}
+export function pcrSource(root) {
+    const current = sources.getStore();
+    return current && path.resolve(root) === current.root ? current.source : null;
+}
+//# sourceMappingURL=source-context.js.map

package/packages/pcr-core/src/source-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-context.js","sourceRoot":"pcr://source/","sources":["packages/pcr-core/src/source-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,gFAAgF;AAChF,gFAAgF;AAChF,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAgE,CAAC;AACtG,MAAM,UAAU,aAAa,CAAI,IAAY,EAAE,MAAiB,EAAE,QAAiB;IACjF,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC;AACrE,CAAC;AACD;mFACmF;AACnF,MAAM,UAAU,uBAAuB,CAAI,IAAY,EAAE,QAAiB;IACxE,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC3E,CAAC;AACD,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IACnC,OAAO,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAChF,CAAC","sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport path from 'node:path';\nimport type { PcrSource } from './types.ts';\n\n// Scope a storage adapter to one consumption request. Repository readers remain\n// authoritative by default; adapters do not become a process-global root cache.\nconst sources = new AsyncLocalStorage<{ readonly root: string; readonly source: PcrSource | null }>();\nexport function withPcrSource<T>(root: string, source: PcrSource, callback: () => T): T {\n  return sources.run({ root: path.resolve(root), source }, callback);\n}\n/** Explicit repository selection shadows an enclosing library adapter even when\n * both resolve to the same root. Normal ALS nesting restores the prior binding. */\nexport function withRepositoryPcrSource<T>(root: string, callback: () => T): T {\n  return sources.run({ root: path.resolve(root), source: null }, callback);\n}\nexport function pcrSource(root: string): PcrSource | null {\n  const current = sources.getStore();\n  return current && path.resolve(root) === current.root ? current.source : null;\n}\n"]}

package/packages/pcr-core/src/tidas-inspection.js

@@ -0,0 +1,201 @@
+import { readdirSync, realpathSync, statSync } from "node:fs";
+import path from "node:path";
+import { ConsumptionError, atPointer, entriesAt, object, paginate, pointerToken, preview, readJsonDocument } from "./consumption-data.js";
+import { unknownField, errorMessage, errorCode } from "./types.js";
+// Field paths, not a second TIDAS schema or consumer validation policy.
+// Basis: public-spec candidate 0.2.3, revision f118660dbcbfbf736be74837cce0bf26cd177245.
+const DATASETS = [
+    ["process", "processDataSet", "processInformation", "process data set"],
+    ["lifecyclemodel", "lifeCycleModelDataSet", "lifeCycleModelInformation", "life cycle model data set"],
+    ["flow", "flowDataSet", "flowInformation", "flow data set"],
+    ["flowproperty", "flowPropertyDataSet", "flowPropertiesInformation", "flow property data set"],
+    ["unitgroup", "unitGroupDataSet", "unitGroupInformation", "unit group data set"],
+    ["source", "sourceDataSet", "sourceInformation", "source data set"],
+    ["contact", "contactDataSet", "contactInformation", "contact data set"],
+    ["lciamethod", "LCIAMethodDataSet", "LCIAMethodInformation", "LCIA method data set"],
+];
+export const INSPECTION_SECTIONS = ["summary", "exchanges", "instances", "references", "documents"];
+const MAX_DOCUMENTS = 200;
+const MAX_BYTES = 64 * 1024 * 1024;
+function identify(document, required = true) {
+    const value = document.value;
+    const matches = DATASETS.filter(([, root]) => object(value) && Object.hasOwn(value, root));
+    const matched = matches[0];
+    const body = matched ? unknownField(value, matched[1]) : undefined;
+    if (matches.length !== 1 || !matched || !object(value) || !object(body)) {
+        if (!required && matches.length === 0)
+            return null;
+        throw new ConsumptionError('PCR_TIDAS_SHAPE', `Expected one native TIDAS dataset root in ${document.file}. Wrapped database rows must be exported as native dataset JSON first.`, { roots: DATASETS.map(([, root]) => root) });
+    }
+    const [kind, root, informationKey, referenceType] = matched;
+    const info = body[informationKey];
+    const uuid = unknownField(unknownField(info, 'dataSetInformation'), 'common:UUID') ?? null;
+    const version = unknownField(unknownField(body.administrativeInformation, 'publicationAndOwnership'), 'common:dataSetVersion') ?? null;
+    if ((uuid !== null && typeof uuid !== 'string') || (version !== null && typeof version !== 'string')) {
+        throw new ConsumptionError('PCR_TIDAS_IDENTITY', `Dataset UUID/version must be strings when supplied in ${document.file}. Inspect the native identity fields or run the TIDAS format validator.`, {
+            uuid_pointer: `/${root}/${informationKey}/dataSetInformation/common:UUID`,
+            version_pointer: `/${root}/administrativeInformation/publicationAndOwnership/common:dataSetVersion`,
+        });
+    }
+    return { ...document, value, kind, root, informationKey, referenceType, uuid, version };
+}
+export function documentIdentity(doc) {
+    return { file: doc.file, sha256: doc.sha256, kind: doc.kind, uuid: doc.uuid, version: doc.version };
+}
+function relatedFiles(directory) {
+    const base = path.resolve(directory);
+    const files = [];
+    try {
+        if (!statSync(base).isDirectory())
+            throw new Error("not a directory");
+        let visited = 0;
+        function visit(current, depth) {
+            if (depth > 12)
+                throw new ConsumptionError("PCR_RELATED_LIMIT", "Related directory nesting exceeds 12 levels. Select a smaller local package.");
+            for (const entry of readdirSync(current, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name, "en"))) {
+                if (++visited > 5000)
+                    throw new ConsumptionError("PCR_RELATED_LIMIT", "Related directory exceeds 5000 entries. Select a smaller local package.");
+                const file = path.join(current, entry.name);
+                if (entry.isSymbolicLink())
+                    throw new ConsumptionError("PCR_RELATED_SYMLINK", `Related packages must contain ordinary files/directories, not symlinks: ${file}`);
+                if (entry.isDirectory())
+                    visit(file, depth + 1);
+                else if (entry.isFile() && entry.name.endsWith(".json")) {
+                    files.push(file);
+                    if (files.length > MAX_DOCUMENTS)
+                        throw new ConsumptionError("PCR_RELATED_LIMIT", `More than ${MAX_DOCUMENTS} JSON files. Select a smaller related package.`);
+                }
+            }
+        }
+        visit(base, 0);
+    }
+    catch (error) {
+        if (error instanceof ConsumptionError)
+            throw error;
+        throw new ConsumptionError("PCR_RELATED_READ", `Cannot inspect --related directory ${base}: ${errorMessage(error)}`);
+    }
+    return files;
+}
+export function loadTidasContext({ input, related = null }) {
+    const primary = identify(readJsonDocument(input));
+    const documents = [primary];
+    const ignoredFiles = [];
+    let totalBytes = primary.bytes;
+    const primaryRealPath = realpathSync(primary.file);
+    for (const file of related ? relatedFiles(related) : []) {
+        if (realpathSync(file) === primaryRealPath)
+            continue;
+        const raw = readJsonDocument(file);
+        totalBytes += raw.bytes;
+        if (totalBytes > MAX_BYTES)
+            throw new ConsumptionError("PCR_RELATED_LIMIT", `Related input exceeds ${MAX_BYTES} bytes. Select a smaller local package.`);
+        const doc = identify(raw, false);
+        if (doc)
+            documents.push(doc);
+        else
+            ignoredFiles.push({ file: raw.file, sha256: raw.sha256, reason: "No recognized native TIDAS dataset root." });
+    }
+    return { primary, documents, ignoredFiles, related: related ? path.resolve(related) : null };
+}
+export function inputEvidence(doc, pointer) {
+    return { file: doc.file, sha256: doc.sha256, pointer };
+}
+export function extractReferences(context) {
+    const references = [];
+    for (const doc of context.documents) {
+        const stack = [{ value: doc.value, pointer: "" }];
+        while (stack.length) {
+            const current = stack.pop();
+            if (!current)
+                break;
+            const { value, pointer } = current;
+            if (value === null || typeof value !== "object")
+                continue;
+            if (object(value) && (Object.hasOwn(value, "@refObjectId") || (Object.hasOwn(value, "@type") && Object.hasOwn(value, "@uri")))) {
+                const uuid = value["@refObjectId"] ?? null;
+                const version = value["@version"] ?? null;
+                const type = value["@type"] ?? null;
+                const kind = DATASETS.find((entry) => entry[3] === type)?.[0];
+                const usableIdentity = typeof uuid === "string" && uuid.length > 0 && kind !== undefined
+                    && (!Object.hasOwn(value, "@version") || (typeof version === "string" && version.length > 0));
+                const sameIdentity = usableIdentity ? context.documents.filter((candidate) => candidate.kind === kind && candidate.uuid === uuid) : [];
+                const candidates = sameIdentity.filter((candidate) => version === null || candidate.version === version);
+                const status = !usableIdentity ? "unresolved_identity" : candidates.length > 1 ? "ambiguous"
+                    : candidates.length === 1 ? "resolved" : sameIdentity.length ? "version_mismatch" : "missing";
+                references.push({
+                    source: inputEvidence(doc, pointer), uuid, version, type, uri: value["@uri"] ?? null,
+                    status, version_selection: version === null ? "unspecified" : "exact",
+                    candidates: (candidates.length ? candidates : sameIdentity).map(documentIdentity),
+                });
+            }
+            const entries = Object.entries(value);
+            for (let index = entries.length - 1; index >= 0; index -= 1) {
+                const entry = entries[index];
+                if (!entry)
+                    continue;
+                const [key, child] = entry;
+                if (child !== null && typeof child === "object")
+                    stack.push({ value: child, pointer: `${pointer}/${pointerToken(key)}` });
+            }
+        }
+    }
+    return references;
+}
+export function inspectTidas({ input, related, section = "summary", pointer, page = 1, pageSize = 10 }) {
+    const context = loadTidasContext({ input, related });
+    const { primary } = context;
+    const references = extractReferences(context);
+    const report = {
+        schema_version: 1, inspection_kind: "tiangong-pcr-tidas-inspection",
+        primary: documentIdentity(primary), related_directory: context.related,
+        schema_validation: "not_performed",
+        scope: "Only explicitly supplied local JSON datasets; no URI is fetched or followed.",
+        counts: {
+            documents: context.documents.length, ignored_json_files: context.ignoredFiles.length,
+            references: references.length, resolved: references.filter((ref) => ref.status === "resolved").length,
+            unresolved: references.filter((ref) => ref.status !== "resolved").length,
+        },
+        limitations: [
+            "Inspection exposes fields and local references; it does not establish TIDAS validity or PCR compliance.",
+            "Missing local evidence is not proof that a lifecycle operation or upstream dataset does not exist.",
+            "Exchange units require flow, flow-property and unit-group evidence; names or amounts alone do not establish units.",
+        ],
+    };
+    if (pointer !== undefined) {
+        return { ...report, section: "pointer", source: inputEvidence(primary, pointer), value: atPointer(primary.value, pointer) };
+    }
+    if (!INSPECTION_SECTIONS.includes(section))
+        throw new ConsumptionError("PCR_INSPECT_SECTION", `Use --section ${INSPECTION_SECTIONS.join("|")}.`);
+    if (section === "summary") {
+        const infoPath = `/${primary.root}/${primary.informationKey}`;
+        const info = unknownField(primary.value[primary.root], primary.informationKey) ?? {};
+        const fields = ["dataSetInformation", "quantitativeReference", "time", "geography", "technology"]
+            .filter((key) => object(info) && Object.hasOwn(info, key))
+            .map((key) => ({ name: key, source: inputEvidence(primary, `${infoPath}/${key}`), ...preview(unknownField(info, key)) }));
+        return { ...report, section, fields, ignored_files: context.ignoredFiles.slice(0, 10), ignored_files_truncated: context.ignoredFiles.length > 10 };
+    }
+    if (section === 'documents')
+        return { ...report, section, ...paginate(context.documents.map(documentIdentity), page, pageSize) };
+    if (section === 'references')
+        return { ...report, section, ...paginate(references, page, pageSize) };
+    if (section !== 'exchanges' && section !== 'instances')
+        throw new ConsumptionError('PCR_INSPECT_SECTION', `Use --section ${INSPECTION_SECTIONS.join('|')}.`);
+    {
+        const expectedKind = section === "exchanges" ? "process" : "lifecyclemodel";
+        if (primary.kind !== expectedKind)
+            throw new ConsumptionError("PCR_INSPECT_SECTION", `${section} requires a ${expectedKind} input. Use --section summary or --pointer for this ${primary.kind}.`);
+        const pointer = section === "exchanges" ? "/processDataSet/exchanges/exchange"
+            : "/lifeCycleModelDataSet/lifeCycleModelInformation/technology/processes/processInstance";
+        let value;
+        try {
+            value = atPointer(primary.value, pointer);
+        }
+        catch (error) {
+            if (errorCode(error) !== "PCR_POINTER_NOT_FOUND")
+                throw error;
+        }
+        const items = entriesAt(value, pointer).map((entry) => ({ source: inputEvidence(primary, entry.pointer), ...preview(entry.value) }));
+        return { ...report, section, ...paginate(items, page, pageSize) };
+    }
+}
+//# sourceMappingURL=tidas-inspection.js.map

package/packages/pcr-core/src/tidas-inspection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tidas-inspection.js","sourceRoot":"pcr://source/","sources":["packages/pcr-core/src/tidas-inspection.ts"],"names":[],"mappings":"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","sourcesContent":["import { readdirSync, realpathSync, statSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { ConsumptionError, atPointer, entriesAt, object, paginate, pointerToken, preview, readJsonDocument } from \"./consumption-data.ts\";\nimport type { JsonDocument, Preview, Pagination } from \"./consumption-data.ts\";\nimport { unknownField, errorMessage, errorCode, type UnknownRecord } from \"./types.ts\";\n\n// Field paths, not a second TIDAS schema or consumer validation policy.\n// Basis: public-spec candidate 0.2.3, revision f118660dbcbfbf736be74837cce0bf26cd177245.\nconst DATASETS = [\n  [\"process\", \"processDataSet\", \"processInformation\", \"process data set\"],\n  [\"lifecyclemodel\", \"lifeCycleModelDataSet\", \"lifeCycleModelInformation\", \"life cycle model data set\"],\n  [\"flow\", \"flowDataSet\", \"flowInformation\", \"flow data set\"],\n  [\"flowproperty\", \"flowPropertyDataSet\", \"flowPropertiesInformation\", \"flow property data set\"],\n  [\"unitgroup\", \"unitGroupDataSet\", \"unitGroupInformation\", \"unit group data set\"],\n  [\"source\", \"sourceDataSet\", \"sourceInformation\", \"source data set\"],\n  [\"contact\", \"contactDataSet\", \"contactInformation\", \"contact data set\"],\n  [\"lciamethod\", \"LCIAMethodDataSet\", \"LCIAMethodInformation\", \"LCIA method data set\"],\n] as const;\nexport const INSPECTION_SECTIONS = [\"summary\", \"exchanges\", \"instances\", \"references\", \"documents\"];\nconst MAX_DOCUMENTS = 200;\nconst MAX_BYTES = 64 * 1024 * 1024;\n\nexport type TidasKind = typeof DATASETS[number][0];\nexport interface InspectedDocument extends JsonDocument {\n  readonly value: UnknownRecord;\n  readonly kind: TidasKind;\n  readonly root: string;\n  readonly informationKey: string;\n  readonly referenceType: string;\n  readonly uuid: string | null;\n  readonly version: string | null;\n}\nexport interface DocumentIdentity { readonly file: string; readonly sha256: string; readonly kind: TidasKind; readonly uuid: string | null; readonly version: string | null }\nexport interface InputEvidence { readonly file: string; readonly sha256: string; readonly pointer: string }\nexport interface TidasContext {\n  readonly primary: InspectedDocument;\n  readonly documents: InspectedDocument[];\n  readonly ignoredFiles: { file: string; sha256: string; reason: string }[];\n  readonly related: string | null;\n}\nexport interface TidasReference {\n  readonly source: InputEvidence;\n  readonly uuid: unknown;\n  readonly version: unknown;\n  readonly type: unknown;\n  readonly uri: unknown;\n  readonly status: 'unresolved_identity' | 'ambiguous' | 'resolved' | 'version_mismatch' | 'missing';\n  readonly version_selection: 'unspecified' | 'exact';\n  readonly candidates: DocumentIdentity[];\n}\nfunction identify(document: JsonDocument, required?: true): InspectedDocument;\nfunction identify(document: JsonDocument, required: false): InspectedDocument | null;\nfunction identify(document: JsonDocument, required = true): InspectedDocument | null {\n  const value = document.value;\n  const matches = DATASETS.filter(([, root]) => object(value) && Object.hasOwn(value, root));\n  const matched = matches[0];\n  const body = matched ? unknownField(value, matched[1]) : undefined;\n  if (matches.length !== 1 || !matched || !object(value) || !object(body)) {\n    if (!required && matches.length === 0) return null;\n    throw new ConsumptionError('PCR_TIDAS_SHAPE', `Expected one native TIDAS dataset root in ${document.file}. Wrapped database rows must be exported as native dataset JSON first.`, { roots: DATASETS.map(([, root]) => root) });\n  }\n  const [kind, root, informationKey, referenceType] = matched;\n  const info = body[informationKey];\n  const uuid = unknownField(unknownField(info, 'dataSetInformation'), 'common:UUID') ?? null;\n  const version = unknownField(unknownField(body.administrativeInformation, 'publicationAndOwnership'), 'common:dataSetVersion') ?? null;\n  if ((uuid !== null && typeof uuid !== 'string') || (version !== null && typeof version !== 'string')) {\n    throw new ConsumptionError('PCR_TIDAS_IDENTITY', `Dataset UUID/version must be strings when supplied in ${document.file}. Inspect the native identity fields or run the TIDAS format validator.`, {\n      uuid_pointer: `/${root}/${informationKey}/dataSetInformation/common:UUID`,\n      version_pointer: `/${root}/administrativeInformation/publicationAndOwnership/common:dataSetVersion`,\n    });\n  }\n  return { ...document, value, kind, root, informationKey, referenceType, uuid, version };\n}\n\nexport function documentIdentity(doc: InspectedDocument): DocumentIdentity {\n  return { file: doc.file, sha256: doc.sha256, kind: doc.kind, uuid: doc.uuid, version: doc.version };\n}\n\nfunction relatedFiles(directory: string): string[] {\n  const base = path.resolve(directory);\n  const files: string[] = [];\n  try {\n    if (!statSync(base).isDirectory()) throw new Error(\"not a directory\");\n    let visited = 0;\n    function visit(current: string, depth: number): void {\n      if (depth > 12) throw new ConsumptionError(\"PCR_RELATED_LIMIT\", \"Related directory nesting exceeds 12 levels. Select a smaller local package.\");\n      for (const entry of readdirSync(current, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name, \"en\"))) {\n        if (++visited > 5000) throw new ConsumptionError(\"PCR_RELATED_LIMIT\", \"Related directory exceeds 5000 entries. Select a smaller local package.\");\n        const file = path.join(current, entry.name);\n        if (entry.isSymbolicLink()) throw new ConsumptionError(\"PCR_RELATED_SYMLINK\", `Related packages must contain ordinary files/directories, not symlinks: ${file}`);\n        if (entry.isDirectory()) visit(file, depth + 1);\n        else if (entry.isFile() && entry.name.endsWith(\".json\")) {\n          files.push(file);\n          if (files.length > MAX_DOCUMENTS) throw new ConsumptionError(\"PCR_RELATED_LIMIT\", `More than ${MAX_DOCUMENTS} JSON files. Select a smaller related package.`);\n        }\n      }\n    }\n    visit(base, 0);\n  } catch (error: unknown) {\n    if (error instanceof ConsumptionError) throw error;\n    throw new ConsumptionError(\"PCR_RELATED_READ\", `Cannot inspect --related directory ${base}: ${errorMessage(error)}`);\n  }\n  return files;\n}\n\nexport function loadTidasContext({ input, related = null }: { input: string; related?: string | null | undefined }): TidasContext {\n  const primary = identify(readJsonDocument(input));\n  const documents = [primary];\n  const ignoredFiles: TidasContext[\"ignoredFiles\"] = [];\n  let totalBytes = primary.bytes;\n  const primaryRealPath = realpathSync(primary.file);\n  for (const file of related ? relatedFiles(related) : []) {\n    if (realpathSync(file) === primaryRealPath) continue;\n    const raw = readJsonDocument(file);\n    totalBytes += raw.bytes;\n    if (totalBytes > MAX_BYTES) throw new ConsumptionError(\"PCR_RELATED_LIMIT\", `Related input exceeds ${MAX_BYTES} bytes. Select a smaller local package.`);\n    const doc = identify(raw, false);\n    if (doc) documents.push(doc);\n    else ignoredFiles.push({ file: raw.file, sha256: raw.sha256, reason: \"No recognized native TIDAS dataset root.\" });\n  }\n  return { primary, documents, ignoredFiles, related: related ? path.resolve(related) : null };\n}\n\nexport function inputEvidence(doc: Pick<InspectedDocument, \"file\" | \"sha256\">, pointer: string): InputEvidence {\n  return { file: doc.file, sha256: doc.sha256, pointer };\n}\n\nexport function extractReferences(context: TidasContext): TidasReference[] {\n  const references: TidasReference[] = [];\n  for (const doc of context.documents) {\n    const stack: { value: unknown; pointer: string }[] = [{ value: doc.value, pointer: \"\" }];\n    while (stack.length) {\n      const current = stack.pop();\n      if (!current) break;\n      const { value, pointer } = current;\n      if (value === null || typeof value !== \"object\") continue;\n      if (object(value) && (Object.hasOwn(value, \"@refObjectId\") || (Object.hasOwn(value, \"@type\") && Object.hasOwn(value, \"@uri\")))) {\n        const uuid = value[\"@refObjectId\"] ?? null;\n        const version = value[\"@version\"] ?? null;\n        const type = value[\"@type\"] ?? null;\n        const kind = DATASETS.find((entry) => entry[3] === type)?.[0];\n        const usableIdentity = typeof uuid === \"string\" && uuid.length > 0 && kind !== undefined\n          && (!Object.hasOwn(value, \"@version\") || (typeof version === \"string\" && version.length > 0));\n        const sameIdentity = usableIdentity ? context.documents.filter((candidate) => candidate.kind === kind && candidate.uuid === uuid) : [];\n        const candidates = sameIdentity.filter((candidate) => version === null || candidate.version === version);\n        const status = !usableIdentity ? \"unresolved_identity\" : candidates.length > 1 ? \"ambiguous\"\n          : candidates.length === 1 ? \"resolved\" : sameIdentity.length ? \"version_mismatch\" : \"missing\";\n        references.push({\n          source: inputEvidence(doc, pointer), uuid, version, type, uri: value[\"@uri\"] ?? null,\n          status, version_selection: version === null ? \"unspecified\" : \"exact\",\n          candidates: (candidates.length ? candidates : sameIdentity).map(documentIdentity),\n        });\n      }\n      const entries = Object.entries(value);\n      for (let index = entries.length - 1; index >= 0; index -= 1) {\n        const entry = entries[index];\n        if (!entry) continue;\n        const [key, child]: [string, unknown] = entry;\n        if (child !== null && typeof child === \"object\") stack.push({ value: child, pointer: `${pointer}/${pointerToken(key)}` });\n      }\n    }\n  }\n  return references;\n}\n\nexport interface InspectionOptions { input: string; related?: string | null; section?: string; pointer?: string; page?: unknown; pageSize?: unknown }\nexport interface InspectionBase {\n  schema_version: 1;\n  inspection_kind: 'tiangong-pcr-tidas-inspection';\n  primary: DocumentIdentity;\n  related_directory: string | null;\n  schema_validation: 'not_performed';\n  scope: string;\n  counts: { documents: number; ignored_json_files: number; references: number; resolved: number; unresolved: number };\n  limitations: string[];\n}\nexport interface PointerInspection extends InspectionBase { section: 'pointer'; source: InputEvidence; value: unknown }\nexport interface SummaryInspection extends InspectionBase {\n  section: 'summary'; fields: ({ name: string; source: InputEvidence } & Preview<unknown>)[];\n  ignored_files: TidasContext['ignoredFiles']; ignored_files_truncated: boolean;\n}\nexport type PagedInspection<T, S extends string> = InspectionBase & { section: S; items: T[]; pagination: Pagination };\nexport type SelectedItem = { source: InputEvidence } & Preview<unknown>;\nexport type TidasInspection = PointerInspection | SummaryInspection | PagedInspection<DocumentIdentity, 'documents'>\n  | PagedInspection<TidasReference, 'references'> | PagedInspection<SelectedItem, 'exchanges' | 'instances'>;\nexport function inspectTidas(options: InspectionOptions & { pointer: string }): PointerInspection;\nexport function inspectTidas(options: InspectionOptions & { section: 'documents'; pointer?: never }): PagedInspection<DocumentIdentity, 'documents'>;\nexport function inspectTidas(options: InspectionOptions & { section: 'references'; pointer?: never }): PagedInspection<TidasReference, 'references'>;\nexport function inspectTidas(options: InspectionOptions & { section: 'exchanges' | 'instances'; pointer?: never }): PagedInspection<SelectedItem, 'exchanges' | 'instances'>;\nexport function inspectTidas(options: InspectionOptions & { section?: 'summary'; pointer?: never }): SummaryInspection;\nexport function inspectTidas(options: InspectionOptions): TidasInspection;\nexport function inspectTidas({ input, related, section = \"summary\", pointer, page = 1, pageSize = 10 }: InspectionOptions): TidasInspection {\n  const context = loadTidasContext({ input, related });\n  const { primary } = context;\n  const references = extractReferences(context);\n  const report: InspectionBase = {\n    schema_version: 1, inspection_kind: \"tiangong-pcr-tidas-inspection\",\n    primary: documentIdentity(primary), related_directory: context.related,\n    schema_validation: \"not_performed\",\n    scope: \"Only explicitly supplied local JSON datasets; no URI is fetched or followed.\",\n    counts: {\n      documents: context.documents.length, ignored_json_files: context.ignoredFiles.length,\n      references: references.length, resolved: references.filter((ref) => ref.status === \"resolved\").length,\n      unresolved: references.filter((ref) => ref.status !== \"resolved\").length,\n    },\n    limitations: [\n      \"Inspection exposes fields and local references; it does not establish TIDAS validity or PCR compliance.\",\n      \"Missing local evidence is not proof that a lifecycle operation or upstream dataset does not exist.\",\n      \"Exchange units require flow, flow-property and unit-group evidence; names or amounts alone do not establish units.\",\n    ],\n  };\n  if (pointer !== undefined) {\n    return { ...report, section: \"pointer\", source: inputEvidence(primary, pointer), value: atPointer(primary.value, pointer) };\n  }\n  if (!INSPECTION_SECTIONS.includes(section)) throw new ConsumptionError(\"PCR_INSPECT_SECTION\", `Use --section ${INSPECTION_SECTIONS.join(\"|\")}.`);\n  if (section === \"summary\") {\n    const infoPath = `/${primary.root}/${primary.informationKey}`;\n    const info = unknownField(primary.value[primary.root], primary.informationKey) ?? {};\n    const fields = [\"dataSetInformation\", \"quantitativeReference\", \"time\", \"geography\", \"technology\"]\n      .filter((key) => object(info) && Object.hasOwn(info, key))\n      .map((key) => ({ name: key, source: inputEvidence(primary, `${infoPath}/${key}`), ...preview(unknownField(info, key)) }));\n    return { ...report, section, fields, ignored_files: context.ignoredFiles.slice(0, 10), ignored_files_truncated: context.ignoredFiles.length > 10 };\n  }\n  if (section === 'documents') return { ...report, section, ...paginate(context.documents.map(documentIdentity), page, pageSize) };\n  if (section === 'references') return { ...report, section, ...paginate(references, page, pageSize) };\n  if (section !== 'exchanges' && section !== 'instances') throw new ConsumptionError('PCR_INSPECT_SECTION', `Use --section ${INSPECTION_SECTIONS.join('|')}.`);\n  {\n    const expectedKind = section === \"exchanges\" ? \"process\" : \"lifecyclemodel\";\n    if (primary.kind !== expectedKind) throw new ConsumptionError(\"PCR_INSPECT_SECTION\", `${section} requires a ${expectedKind} input. Use --section summary or --pointer for this ${primary.kind}.`);\n    const pointer = section === \"exchanges\" ? \"/processDataSet/exchanges/exchange\"\n      : \"/lifeCycleModelDataSet/lifeCycleModelInformation/technology/processes/processInstance\";\n    let value;\n    try { value = atPointer(primary.value, pointer); }\n    catch (error: unknown) { if (errorCode(error) !== \"PCR_POINTER_NOT_FOUND\") throw error; }\n    const items = entriesAt(value, pointer).map((entry) => ({ source: inputEvidence(primary, entry.pointer), ...preview(entry.value) }));\n    return { ...report, section, ...paginate(items, page, pageSize) };\n  }\n}\n"]}

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

@@ -0,0 +1,12 @@
+export function isUnknownRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+export function unknownField(value, key) {
+    return value !== null && typeof value === 'object' ? value[key] : undefined;
+}
+export function errorMessage(error) { return error instanceof Error ? error.message : String(error); }
+export function errorCode(error) {
+    const code = unknownField(error, 'code');
+    return typeof code === 'string' ? code : 'UNKNOWN';
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"pcr://source/","sources":["packages/pcr-core/src/types.ts"],"names":[],"mappings":"AAuLA,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AACD,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,GAAW;IACtD,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAE,KAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACjG,CAAC;AACD,MAAM,UAAU,YAAY,CAAC,KAAc,IAAY,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACvH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/F,CAAC","sourcesContent":["import type { ProjectionIntegrityState, ProjectionIntegrityStatus } from './projection-integrity.ts';\nimport type { NormativeProjectionContext, NormativeRule } from './compiler/normative-projection.ts';\nimport type { GuidanceContextEnvelope } from './compiler/guidance-context.ts';\nimport type { PcrIdAlias } from './pcr-id-aliases.ts';\nimport type { CoverageSnapshot } from './classification-coverage.ts';\nexport type { PcrIdAlias } from './pcr-id-aliases.ts';\nexport type { CoverageSnapshot } from './classification-coverage.ts';\n\n/** Open object fields remain unknown where the public schema promises only an\n * object. These DTOs describe validated outputs, never unchecked JSON/TIDAS data. */\nexport type UnknownRecord = Record<string, unknown>;\nexport interface ContractIssue { code: string; message: string }\nexport interface SchemaIssue extends ContractIssue {\n  instance_path: string;\n  schema_path: string;\n  keyword: string;\n  params: UnknownRecord;\n}\nexport interface ContractOptions { code?: string; entityKind?: string; source?: string | null }\nexport interface ContractValidationResult {\n  valid: boolean;\n  code: string | null;\n  entity_kind: string;\n  schema_id: string;\n  errors: SchemaIssue[];\n  issues: SchemaIssue[];\n}\nexport interface SchemaRegistry {\n  assert<T>(contract: string, value: T, options?: ContractOptions): T;\n  validate(contract: string, value: unknown, options?: ContractOptions): ContractValidationResult;\n}\nexport interface ReadinessFingerprint extends Omit<ProjectionIntegrityState, 'status'> {\n  status: ProjectionIntegrityStatus | 'source_missing';\n  schema_valid: boolean | null;\n}\nexport interface Readiness {\n  status: 'ready' | 'review_required' | 'unavailable';\n  lifecycle_status: string;\n  methodology_status: string;\n  structured_projection_available: boolean;\n  projection_fingerprint: ReadinessFingerprint;\n  usable_for_guidance: boolean;\n  usable_for_validation: boolean;\n  blockers: ContractIssue[];\n  warnings: ContractIssue[];\n}\nexport interface PcrLanguages { canonical?: string; available?: string[] }\n/** Manifest metadata is an external authoring document; callers validate/narrow\n * each required field rather than silently assigning it the consumer DTO. */\nexport type PcrManifest = UnknownRecord;\nexport type PcrCatalogScope = 'material' | 'legacy' | 'all';\nexport type PcrRecordKind = 'methodology' | 'legacy_scaffold_reference' | 'invalid_lifecycle_state';\nexport interface PcrRecord {\n  id: string;\n  path: string;\n  title: Record<string, string | null>;\n  status: string;\n  version: string | null;\n  content_maturity: string | null;\n  languages: PcrLanguages;\n  translation_status: Record<string, string>;\n  classification_refs: UnknownRecord[];\n  record_kind: PcrRecordKind;\n  readiness: Readiness;\n}\nexport interface CatalogEntry { id: string; path: string; manifestPath: string }\nexport interface CapturedArtifact { bytes: Buffer | null; error?: unknown }\nexport interface CapturedPcrSnapshot {\n  manifest: PcrManifest;\n  manifestBytes: Buffer;\n  artifacts: Record<string, CapturedArtifact>;\n}\nexport interface ProjectionMetadata {\n  contract_version: '1' | '2';\n  generator: string;\n  canonical_markdown: { path: string; normalization: string; hash_algorithm: string; sha256: string };\n  generated_content_sha256: string;\n}\nexport interface ProjectionFields {\n  generated_from: string;\n  source_markdown: string;\n  product_category_identity: UnknownRecord;\n  functional_unit: UnknownRecord;\n  system_boundary: { rules: NormativeRule[] };\n  boundary_abstraction: UnknownRecord;\n  reference_flow_definition: UnknownRecord;\n  measurement_rules: UnknownRecord[];\n  process_map: UnknownRecord[];\n  process_inventory: UnknownRecord[];\n  dataset_production: { collection_protocols: UnknownRecord[]; calculation_rules: UnknownRecord[]; data_quality_requirements: UnknownRecord[] };\n  published_dataset_profile: UnknownRecord;\n  allocation_rules: NormativeRule[];\n  validation_rules: NormativeRule[];\n  data_sources: UnknownRecord[];\n  data_quality_rules?: UnknownRecord[];\n  unit_conventions?: UnknownRecord[];\n  projection_metadata: ProjectionMetadata;\n}\nexport type StructuredProjection = ProjectionFields & (\n  | { schema_version: 1; normative_context?: never }\n  | { schema_version: 2; normative_context: NormativeProjectionContext }\n);\nexport interface CurrentPcrSnapshot extends CapturedPcrSnapshot {\n  pcr: PcrRecord;\n  fingerprint: ReadinessFingerprint;\n  structured: StructuredProjection | null;\n  structuredPath: string;\n  structuredAvailable: boolean;\n  completenessIssues: ContractIssue[];\n}\nexport interface VerifiedPcrProjection extends GuidanceContextEnvelope {\n  pcr: PcrRecord;\n  readiness: Readiness;\n  source_structured: string;\n  structured: StructuredProjection;\n}\nexport interface CompleteGuidance extends GuidanceContextEnvelope {\n  schema_version: 2;\n  guidance_kind: 'tiangong-pcr-agent-guidance';\n  pcr: PcrRecord;\n  readiness: Readiness;\n  source_structured: string;\n  system_boundary: { rules: NormativeRule[] };\n  reference_flow: UnknownRecord;\n  boundary_abstraction: UnknownRecord;\n  measurement_rules: UnknownRecord[];\n  process_map: UnknownRecord[];\n  process_inventory: UnknownRecord[];\n  production_guidance: { collection_protocols: UnknownRecord[]; calculation_rules: UnknownRecord[]; data_quality_requirements: UnknownRecord[] };\n  published_dataset_profile: UnknownRecord;\n  allocation_rules: NormativeRule[];\n  data_quality_rules: UnknownRecord[];\n  validation_rules: NormativeRule[];\n  data_sources: UnknownRecord[];\n  validation_notes: string[];\n}\nexport type FindingSeverity = 'error' | 'warning' | 'info';\nexport interface ValidationFinding extends ContractIssue { severity: FindingSeverity }\nexport interface PerformedCheck { check_id: string; requirement_family: string; requirement_count: number; evaluated_requirement_count: number }\nexport interface SkippedCheck { check_id: string; requirement_family: string; requirement_count: number; reason: string }\nexport interface ValidationReport {\n  schema_version: 1;\n  validation_kind: 'tiangong-pcr-model-validation' | 'tiangong-pcr-dataset-validation';\n  pcr: UnknownRecord | PcrRecord;\n  readiness: Readiness;\n  validation_status: 'passed' | 'failed' | 'inconclusive';\n  completeness: 'none' | 'partial' | 'complete';\n  input: { input_kind: string; representation: string; accepted: boolean; collection_record_count?: number; distinct_protocol_id_count?: number };\n  check_coverage: { total_requirement_count: number; checked_requirement_count: number; skipped_requirement_count: number; checks_performed: PerformedCheck[]; checks_skipped: SkippedCheck[] };\n  finding_count: number;\n  finding_summary: Record<FindingSeverity, number>;\n  findings: ValidationFinding[];\n}\nexport interface OfflineSnapshot {\n  available_languages: string[];\n  content_version: string;\n  source_commit: string;\n  source_sha256: string;\n  records: number;\n  material_records: number;\n  aliases: number;\n  original_bytes: number;\n}\nexport interface OfflineManifest {\n  kind: 'tiangong-pcr-library';\n  format_version: 1;\n  snapshot: OfflineSnapshot;\n  bytes: number;\n  sha256: string;\n  index_sha256: Record<'records' | 'aliases' | 'coverage' | 'files', string>;\n}\n/** Storage-only interface; repository consistency and library integrity remain\n * enforced by their owning implementations and the current snapshot reader. */\nexport interface PcrSource {\n  readonly root: string;\n  readonly languages: readonly string[];\n  listPcrs(scope: PcrCatalogScope): PcrRecord[];\n  entry(id: unknown): CatalogEntry | null;\n  findAlias(id: unknown): PcrIdAlias | null;\n  readFile(key: string): Buffer;\n  snapshotFiles(entry: CatalogEntry): CapturedPcrSnapshot;\n  coverageSnapshot(system: unknown, version: unknown): CoverageSnapshot;\n}\nexport function isUnknownRecord(value: unknown): value is UnknownRecord {\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\nexport function unknownField(value: unknown, key: string): unknown {\n  return value !== null && typeof value === 'object' ? (value as UnknownRecord)[key] : undefined;\n}\nexport function errorMessage(error: unknown): string { return error instanceof Error ? error.message : String(error); }\nexport function errorCode(error: unknown): string {\n  const code = unknownField(error, 'code'); return typeof code === 'string' ? code : 'UNKNOWN';\n}\n"]}

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

@@ -0,0 +1,47 @@
+import { readFileSync } from 'node:fs';
+import { isUnknownRecord, unknownField } from './types.js';
+// The generated schema and generated JS derive from the same authored YAML.
+// Read the typed data boundary directly; no hand-copied tokens or declaration
+// file can pretend that an unchecked generated module has a verified type.
+const schema = JSON.parse(readFileSync(new URL('../schemas/controlled-vocabulary.schema.json', import.meta.url), 'utf8'));
+const definitions = unknownField(schema, '$defs');
+if (!isUnknownRecord(definitions))
+    throw new Error('Invalid generated controlled vocabulary definitions.');
+function values(key) {
+    const entries = unknownField(unknownField(definitions, key), 'enum');
+    if (!Array.isArray(entries) || entries.length === 0 || !entries.every((entry) => typeof entry === 'string' && entry.length > 0)) {
+        throw new Error(`Invalid generated controlled vocabulary definition: ${key}.`);
+    }
+    const strings = entries;
+    if (new Set(strings).size !== strings.length)
+        throw new Error(`Duplicate generated controlled vocabulary token: ${key}.`);
+    return Object.freeze([...strings]);
+}
+export const AMOUNT_RANGE_ROLE_VALUES = values('amount_range_role');
+export const AMOUNT_SPECIFICITY_VALUES = values('amount_specificity');
+export const AMOUNT_VALUE_MODE_VALUES = values('amount_value_mode');
+export const BASIS_KIND_VALUES = values('basis_kind');
+export const CLASSIFICATION_COVERAGE_STATUS_VALUES = values('classification_coverage_status');
+export const CLASSIFICATION_MAPPING_RELATION_VALUES = values('classification_mapping_relation');
+export const CONTENT_MATURITY_VALUES = values('content_maturity');
+export const EVIDENCE_KIND_VALUES = values('evidence_kind');
+export const FEEDBACK_CONFIDENCE_VALUES = values('feedback_confidence');
+export const FEEDBACK_TYPE_VALUES = values('feedback_type');
+export const FLOW_DIRECTION_VALUES = values('flow_direction');
+export const FLOW_TYPE_VALUES = values('flow_type');
+export const PCR_STATUS_VALUES = values('pcr_status');
+export const PROCESS_INCLUSION_VALUES = values('process_inclusion');
+export const SOURCE_TYPE_VALUES = values('source_type');
+export const TARGET_ENTITY_VALUES = values('target_entity');
+export const TRANSLATION_STATUS_VALUES = values('translation_status');
+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=vocabulary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.js","sourceRoot":"pcr://source/","sources":["packages/pcr-core/src/vocabulary.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from 'node:fs';\nimport { isUnknownRecord, unknownField } from './types.ts';\n\n// The generated schema and generated JS derive from the same authored YAML.\n// Read the typed data boundary directly; no hand-copied tokens or declaration\n// file can pretend that an unchecked generated module has a verified type.\nconst schema: unknown = JSON.parse(readFileSync(new URL('../schemas/controlled-vocabulary.schema.json', import.meta.url), 'utf8'));\nconst definitions = unknownField(schema, '$defs');\nif (!isUnknownRecord(definitions)) throw new Error('Invalid generated controlled vocabulary definitions.');\nfunction values(key: string): readonly string[] {\n  const entries: unknown = unknownField(unknownField(definitions, key), 'enum');\n  if (!Array.isArray(entries) || entries.length === 0 || !entries.every((entry: unknown) => typeof entry === 'string' && entry.length > 0)) {\n    throw new Error(`Invalid generated controlled vocabulary definition: ${key}.`);\n  }\n  const strings = entries as string[];\n  if (new Set(strings).size !== strings.length) throw new Error(`Duplicate generated controlled vocabulary token: ${key}.`);\n  return Object.freeze([...strings]);\n}\nexport const AMOUNT_RANGE_ROLE_VALUES = values('amount_range_role');\nexport const AMOUNT_SPECIFICITY_VALUES = values('amount_specificity');\nexport const AMOUNT_VALUE_MODE_VALUES = values('amount_value_mode');\nexport const BASIS_KIND_VALUES = values('basis_kind');\nexport const CLASSIFICATION_COVERAGE_STATUS_VALUES = values('classification_coverage_status');\nexport const CLASSIFICATION_MAPPING_RELATION_VALUES = values('classification_mapping_relation');\nexport const CONTENT_MATURITY_VALUES = values('content_maturity');\nexport const EVIDENCE_KIND_VALUES = values('evidence_kind');\nexport const FEEDBACK_CONFIDENCE_VALUES = values('feedback_confidence');\nexport const FEEDBACK_TYPE_VALUES = values('feedback_type');\nexport const FLOW_DIRECTION_VALUES = values('flow_direction');\nexport const FLOW_TYPE_VALUES = values('flow_type');\nexport const PCR_STATUS_VALUES = values('pcr_status');\nexport const PROCESS_INCLUSION_VALUES = values('process_inclusion');\nexport const SOURCE_TYPE_VALUES = values('source_type');\nexport const TARGET_ENTITY_VALUES = values('target_entity');\nexport const TRANSLATION_STATUS_VALUES = values('translation_status');\nexport const CONTROLLED_VOCABULARY = Object.freeze({\n  amount_range_role: AMOUNT_RANGE_ROLE_VALUES, amount_specificity: AMOUNT_SPECIFICITY_VALUES,\n  amount_value_mode: AMOUNT_VALUE_MODE_VALUES, basis_kind: BASIS_KIND_VALUES,\n  classification_coverage_status: CLASSIFICATION_COVERAGE_STATUS_VALUES,\n  classification_mapping_relation: CLASSIFICATION_MAPPING_RELATION_VALUES, content_maturity: CONTENT_MATURITY_VALUES,\n  evidence_kind: EVIDENCE_KIND_VALUES, feedback_confidence: FEEDBACK_CONFIDENCE_VALUES, feedback_type: FEEDBACK_TYPE_VALUES,\n  flow_direction: FLOW_DIRECTION_VALUES, flow_type: FLOW_TYPE_VALUES, pcr_status: PCR_STATUS_VALUES,\n  process_inclusion: PROCESS_INCLUSION_VALUES, source_type: SOURCE_TYPE_VALUES, target_entity: TARGET_ENTITY_VALUES,\n  translation_status: TRANSLATION_STATUS_VALUES,\n});\n"]}