Factory docs, home
Page navigation

In progress: optional pure source candidate; independent source and installed-package review pending. Adoption contract.

Intelligence: none — Optional retained-fact attribution is deterministic; a model cannot infer a provider cause, change an outcome or authorise a retry.

Sources: provider-diagnostics.ts and provider-diagnostics-contract.ts. One public entry, software-factory/provider-diagnostics; the neutral contract is its private declaration closure. diagnoseProviderObservation(unknown): Reading returns immutable secondary attribution or a fixed bounded refusal. No public Provider or Journal import exists in its runtime closure: only canonical JSON, errors, native Promise inspection and hashing.

The caller selects existing public receipt/result facts and pins the exact receipt, request and original commission digests. Outcomes and consumption remain authoritative and unchanged. HTTP status groups are observations, not causes; credential echo suppresses attribution. Authentication is reported only from the native result; cancellation/deadline retain precedence. Claude subtype/status details are not retained and are never inferred from text. Missing historical result stays null. Policy resolution belongs to an exact original-commission lookup outside this module.

Bounds: 4 KiB canonical input and complete output, depth eight and 128 descriptor slots. Exact schema/native grammar and explicit contradictions refuse; recognised future protocols remain unavailable. Native own, fulfilled and thrown descriptor data share observation bounds. Symbols are observed but refused as JSON. Accessors/generic thenables are not evaluated, and no Promise grants permission. Fixed refusal never prints an exception. No arbitrary hostile-code sandbox is claimed.

Proof: native offline extraction, pure and strict-process controls, closed import graph. Installed public consumer/type/guide checks are prepared but not yet run. No provider, receipt, prompt, consumption or policy source changes; no live contact, new Evidence or retry authority.

Source: docs/agents/provider-diagnostics.md