Diagnostics and remediation

Pulse 1.0.0-beta.10 treats the 184 codes on this page as the stable public CLI diagnostic catalog. Code, category, summary, remediation intent, exit class, and anchor are generated from the same source used by the CLI. Human wording may improve compatibly.

Every catalogued failure links to a versioned installed artifact under:

https://pulsecompute.io/v1.0.0-beta.10/reference/diagnostics/

Uncatalogued/internal or forward-compatible codes link to that reference root instead of inventing a nonexistent anchor. Internal PULSEWASM_* proof/compiler tokens are not part of this public catalog.

Source-form eligibility, trusted awaits, ctx.parallel static shape, Router terminal transfer, and body ownership are centralized in Managed handler TypeScript and JavaScript. Four-mode target claims are centralized in Provider and target compatibility. A Native eligibility diagnostic never authorizes automatic JavaScript fallback.

Find a diagnostic

Start with the exact error.code from CLI JSON or the terminal message. Follow its link for remediation and limits; a code identifies the failure, while its category groups related problems. CLI exit classes and HTTP response statuses are separate contracts.

1. Find the code below or choose a category in the index.
2. Apply its full remediation steps, retaining the selected provider/target.
3. Use CLI JSON output for automation and Router recovery for application error handling. A diagnostic HTTP mapping alone does not promise application recovery, retry or rollback.

Category	Codes	Related guidance
Compile diagnostics	35	Troubleshooting
Runtime diagnostics	30	Troubleshooting
Report diagnostics	7	Retained build reports
Usage diagnostics	5	CLI reference
Project diagnostics	18	Project configuration
Test diagnostics	4	CLI test behavior
Capability diagnostics	17	Provider restrictions
Internal diagnostics	4	Troubleshooting
Safety diagnostics	3	CLI build behavior
Provider diagnostics	13	Fastly provider configuration
Toolchain diagnostics	12	CLI doctor behavior
Schema diagnostics	19	Project schema configuration
Request diagnostics	14	Body and schema troubleshooting
Configuration diagnostics	1	Troubleshooting
Config diagnostics	2	Troubleshooting

JSON failure envelope

{
  "status": "error",
  "version": "1.0.0-beta.10",
  "error": {
    "name": "PulseProjectError",
    "code": "PULSE_BUILD_OUT_UNSAFE",
    "title": "Build Out Unsafe",
    "summary": "The resolved build output can escape or alias outside the project root.",
    "category": "safety",
    "message": "Pulse build output must be a child directory of the project root.",
    "remediation": [
      "Choose an output directory that is a real child of the project root."
    ],
    "stability": "preview-stable",
    "scope": "public",
    "docs": "https://pulsecompute.io/v1.0.0-beta.10/reference/diagnostics/#pulse-build-out-unsafe"
  }
}

Configured secret values are redacted before diagnostics are serialized.

Fastly local execution boundary

Pulse executes generated bin/main.wasm through an inspected local Compute launcher. PULSE_FASTLY_BIN selects CLI-owned fastly compute serve --file; PULSE_VICEROY_BIN selects direct viceroy serve when no explicit Fastly CLI launcher is selected. External Fastly execution remains an explicit environment-dependent gate.

Exit codes

Exit	Meaning
0	Command completed successfully.
1	Completed doctor/test failure where documented, or uncatalogued internal failure.
2	Usage, project configuration, provider selection, or output-safety error.
3	Canonical/schema/package-lowering/provider-binding failure.
4	Request, test, runtime, fetch, or continuation failure.
5	External toolchain or Fastly local-execution failure.

Development HTTP responses

When a diagnostic is converted into a response by pulse dev, an explicitly catalogued HTTP status takes precedence. Catalogued codes without an explicit HTTP mapping use 500 as a fail-closed development-server fallback. CLI exit codes remain independent from HTTP status.

HTTP status	Explicitly mapped public diagnostics
400	PULSE_SCHEMA_JSON_MALFORMED, PULSE_PACKAGE_SNAPSHOT_INVALID, PULSE_BODY_DECODE, PULSE_REQUEST_BODY_INVALID_UTF8, PULSE_SCHEMA_DECODE, PULSE_TRANSFORM_HEADERS_INVALID, PULSE_TRANSFORM_UTF8_INVALID, PULSE_OPAQUE_BODY_INSPECTION, PULSE_FETCH_URL_INVALID
413	PULSE_BODY_TOO_LARGE, PULSE_TRANSFORM_INPUT_LIMIT, PULSE_REQUEST_BODY_TOO_LARGE
415	PULSE_SCHEMA_CONTENT_TYPE
500	PULSE_CALL_BOUNDARY_INVALID, PULSE_NUMERIC_WORKSPACE_INVALID, PULSE_BINARY_RESOURCE_INVALID, PULSE_EFFECT_COLLECTION_CAPACITY, PULSE_EFFECT_COLLECTION_OVERFLOW, PULSE_EFFECT_COLLECTION_MEMBER, PULSE_EFFECT_COLLECTION_OWNER, PULSE_EFFECT_COLLECTION_CLAIMED, PULSE_EFFECT_COLLECTION_SEALED, PULSE_EFFECT_COLLECTION_UNFLUSHED, PULSE_SCHEMA_ID_INVALID, PULSE_SCHEMA_REQUIRED, PULSE_SCHEMA_REFERENCE, PULSE_SCHEMA_CODECS_UNAVAILABLE, PULSE_RESPONSE_CASE_REFERENCE, PULSE_RESPONSE_DESCRIPTOR_INVALID, PULSE_FETCH_SCHEMA_WITHOUT_JSON, PULSE_PACKAGE_BINDING_INVALID, PULSE_PACKAGE_SNAPSHOT_UNAVAILABLE, PULSE_PACKAGE_OPERATION_FAILED, PULSE_TRANSFORM_CONFIG_INVALID, PULSE_TRANSFORM_CHUNK_INVALID, PULSE_TRANSFORM_OUTPUT_LIMIT, PULSE_TRANSFORM_READ_LIMIT, PULSE_TRANSFORM_CLOSED, PULSE_TRANSFORM_EOF_REQUIRED, PULSE_BODY_UNAVAILABLE, PULSE_RESPONSE_ENCODE, PULSE_SCHEMA_ENCODE, PULSE_CONTINUATION_DOUBLE_RESUME
501	PULSE_PROVIDER_CAPABILITY_MISSING, PULSE_PACKAGE_CAPABILITY_UNAVAILABLE, PULSE_PROVIDER_CAPABILITY_UNSUPPORTED, PULSE_EVENT_TARGET_UNSUPPORTED, PULSE_FASTLY_EVENT_INGRESS_UNSUPPORTED, PULSE_FASTLY_EVENT_EMIT_UNSUPPORTED, PULSE_TRANSFORM_UNAVAILABLE
502	PULSE_FETCH_NETWORK
504	PULSE_REQUEST_DEADLINE_EXCEEDED, PULSE_REQUEST_CLOCK_INVALID, PULSE_FETCH_TIMEOUT, PULSE_CONTINUATION_EXPIRED, PULSE_FASTLY_REQUEST_TIMEOUT

Executable schema failure example

The documented schema project includes an intentionally invalid case:

pulse test examples/02-request-schema --case invalid-user --json

{
  "status": "passed",
  "cases": [
    {
      "name": "invalid-user",
      "status": "passed",
      "expectedError": {
        "code": "PULSE_SCHEMA_DECODE",
        "category": "request",
        "docs": "https://pulsecompute.io/v1.0.0-beta.10/reference/diagnostics/#pulse-schema-decode"
      }
    }
  ]
}

Complete public catalog

The compact rows identify codes and CLI exit classes. Each linked entry below retains every remediation step, HTTP mapping, stability and scope qualification.

Compile diagnostics

Code	Meaning	CLI exit
PULSE_CALL_SOURCE_ENTRY	Computation calls need a selected project HTTP caller.	3
PULSE_CALL_SOURCE_CONTEXT	The computation caller context parameter is unsupported.	3
PULSE_CALL_SOURCE_FORM	Computation call syntax is not a direct static call.	3
PULSE_CALL_SOURCE_PLACEMENT	The computation call is awaited, nested or inside a loop/function.	3
PULSE_CALL_SOURCE_BINDING	The computation context or target binding escapes or changes.	3
PULSE_CALL_SOURCE_TARGET	The computation target is not an imported synchronous project function.	3
PULSE_CALL_SOURCE_SCHEMAS	Computation calls require two literal schema IDs.	3
PULSE_CALL_SOURCE_SCHEMA_UNKNOWN	A computation schema ID is absent from the project registry.	3
PULSE_CALL_SOURCE_SCHEMA_CONFLICT	The same computation target uses conflicting schema pairs.	3
PULSE_CALL_SOURCE_LIMIT	The application exceeds sixteen reachable computation call occurrences.	3
PULSE_CALL_SOURCE_TARGET_LIMIT	The application exceeds sixteen computation targets.	3
PULSE_CALL_SOURCE_CALLEE	The computation body failed canonical admission.	3
PULSE_CALL_SOURCE_PROVIDER	Computation calls are unavailable on this JavaScript provider.	3
PULSE_MCP_STATIC_BINDING_REQUIRED	The MCP binding is dynamic, invalid or outside the supported static protocol and Entities composition contract.	3
PULSE_JAVASCRIPT_APPLICATION_GRAPH_FAILED	The sealed reachable graph could not be built for JavaScript application loading.	3
PULSE_JAVASCRIPT_IMPORT_NOT_IN_GRAPH	Runtime evaluation requested an import absent from the sealed reachable graph.	3
PULSE_JAVASCRIPT_MODULE_COMPILE_FAILED	A graph-owned TypeScript or JavaScript module could not be transpiled for the Node loader.	3
PULSE_NATIVE_EXPANSION_REPEATED	A repeated HTTP owner has multiple Native plan body instances and at least 1,024 additional lowered-source bytes across registrations.	1
PULSE_HANDLER_ASYNC_REQUIRED	A managed handler in a conventional Pulse project is missing its required async wrapper.	3
PULSE_PROJECT_COMPILE_FAILED	Whole-project compilation failed and contains one or more nested diagnostics.	3
PULSE_CANONICAL_COMPILE_FAILED	The handler uses a source form outside the canonical Beta authoring subset.	3
PULSE_CANONICAL_PURE_LOOP_UNSUPPORTED	The loop does not satisfy the bounded pure-value control-flow contract.	3
PULSE_CANONICAL_EFFECT_COLLECTION_UNSUPPORTED	The source does not satisfy the bounded collection build/flush contract.	3
PULSE_CANONICAL_READ_LOOP_UNSUPPORTED	The loop does not satisfy the bounded sequential read control-flow contract.	3
PULSE_CANONICAL_NATIVE_PLAN_FAILED	The canonical handler could not be represented by the provider-neutral native execution-plan contract.	3
PULSE_CANONICAL_NATIVE_AS_GENERATION_FAILED	The validated native plan could not be rendered into the bounded AssemblyScript state-machine source.	3
PULSE_PACKAGE_LOWERING_FAILED	A package-owned API call could not be lowered into its canonical effect contract.	3
PULSE_NATIVE_IMPORT_UNSUPPORTED	A reachable runtime import has neither supported static source nor a trusted Pulse native contract.	3
PULSE_PACKAGE_SUBPATH_UNSUPPORTED	A Pulse-aware package was imported through a subpath that is not native-lowerable.	3
PULSE_PACKAGE_REEXPORT_LOWERING_DEFERRED	A package-owned helper is graph-owned but reaches application code through a project re-export whose lowering remains deferred.	3
PULSE_APPLICATION_ENTRY_LIFECYCLE_SIDE_EFFECT	The configured application entry graph starts a known provider lifecycle during module evaluation.	3
PULSE_PACKAGE_BINDING_OWNERSHIP_AMBIGUOUS	A project binding or re-export resolves to more than one package-owned symbol.	3
PULSE_PACKAGE_CONTRACT_NOT_RECOGNIZED	The graph selected a trusted package contract that the package recognizer did not recover from its owning source module.	3
PULSE_REQUEST_FORWARDING_UNAVAILABLE	Incoming forwarding is not enabled on this target.	3
PULSE_REQUEST_FORWARDING_FORM_UNSUPPORTED	The incoming body marker appears outside its supported inline POST position.	3

PULSE_CALL_SOURCE_ENTRY — Call Source Entry

Computation calls need a selected project HTTP caller.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Place the call in a named plain handler, a reachable Router handler, or a selected managed operation.

PULSE_CALL_SOURCE_CONTEXT — Call Source Context

The computation caller context parameter is unsupported.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Use a simple named context parameter at the selected caller position.

PULSE_CALL_SOURCE_FORM — Call Source Form

Computation call syntax is not a direct static call.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Use ctx.call(importedFunction, input, { inputSchema: 'app.Input', outputSchema: 'app.Output' }) without aliases, computed access, type arguments or spreads.

PULSE_CALL_SOURCE_PLACEMENT — Call Source Placement

The computation call is awaited, nested or inside a loop/function.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Call synchronously in the selected caller body, outside loops, nested calls and nested functions.

PULSE_CALL_SOURCE_BINDING — Call Source Binding

The computation context or target binding escapes or changes.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Keep direct context and imported target references unshadowed and unwritten; do not alias or pass the context.

PULSE_CALL_SOURCE_TARGET — Call Source Target

The computation target is not an imported synchronous project function.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Import a named synchronous function from a contained project module. Factories, dynamic targets and arbitrary package functions are unsupported.

PULSE_CALL_SOURCE_SCHEMAS — Call Source Schemas

Computation calls require two literal schema IDs.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Supply exactly inputSchema and outputSchema as literal string properties in an inline object.

PULSE_CALL_SOURCE_SCHEMA_UNKNOWN — Call Source Schema Unknown

A computation schema ID is absent from the project registry.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Register both object schemas in the project schema registry and use their exact literal IDs.

PULSE_CALL_SOURCE_SCHEMA_CONFLICT — Call Source Schema Conflict

The same computation target uses conflicting schema pairs.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Use one consistent input/output schema pair for every reachable occurrence of a target.

PULSE_CALL_SOURCE_LIMIT — Call Source Limit

The application exceeds sixteen reachable computation call occurrences.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Reduce reachable call occurrences to at most sixteen; reused Router handlers count per reachable occurrence.

PULSE_CALL_SOURCE_TARGET_LIMIT — Call Source Target Limit

The application exceeds sixteen computation targets.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Reduce the number of reachable imported computation targets to at most sixteen.

PULSE_CALL_SOURCE_CALLEE — Call Source Callee

The computation body failed canonical admission.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Inspect the nested compiler error. Use bounded synchronous computation, admitted pure helpers, resource reads and workspaces; remove effects, HTTP/state, mutation of borrowed input, escaping views and nested calls.

PULSE_CALL_SOURCE_PROVIDER — Call Source Provider

Computation calls are unavailable on this JavaScript provider.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Select explicit Node JavaScript, or a supported Native provider; there is no automatic target fallback.

PULSE_MCP_STATIC_BINDING_REQUIRED — Mcp Static Binding Required

The MCP binding is dynamic, invalid or outside the supported static protocol and Entities composition contract.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Declare one module-level MCP binding with literal protocol options, one local EntityRouter and a direct terminal handle(ctx) return.

PULSE_JAVASCRIPT_APPLICATION_GRAPH_FAILED — Javascript Application Graph Failed

The sealed reachable graph could not be built for JavaScript application loading.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Fix the first reachable-graph diagnostic before loading the JavaScript application.

PULSE_JAVASCRIPT_IMPORT_NOT_IN_GRAPH — Javascript Import Not In Graph

Runtime evaluation requested an import absent from the sealed reachable graph.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Keep runtime imports within the sealed reachable graph and avoid evaluation-time dynamic loading.

PULSE_JAVASCRIPT_MODULE_COMPILE_FAILED — Javascript Module Compile Failed

A graph-owned TypeScript or JavaScript module could not be transpiled for the Node loader.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Fix the TypeScript or JavaScript syntax in the graph-owned project module.

PULSE_NATIVE_EXPANSION_REPEATED — Native Expansion Repeated

A repeated HTTP owner has multiple Native plan body instances and at least 1,024 additional lowered-source bytes across registrations.

• Category: compile
• CLI exit class: 1
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Inspect the named owners and registration counts in pulse doctor --json.
2. Compare their observed shapes with the current retained HTTP-stage contract before changing generated wiring.
3. Measure a full target build before claiming Wasm savings; preserve explicit inputs, outputs and continuation ownership.

PULSE_HANDLER_ASYNC_REQUIRED — Handler Async Required

A managed handler in a conventional Pulse project is missing its required async wrapper.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Declare every managed handler, middleware function, and error handler with async.
2. Native lowering erases the wrapper; no Promise runtime or Asyncify support is added.

PULSE_PROJECT_COMPILE_FAILED — Project Compile Failed

Whole-project compilation failed and contains one or more nested diagnostics.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Read the nested diagnostics and fix the first reported source or schema error.
2. Run pulse inspect --json or pulse doctor --json for structured diagnostics.

PULSE_CANONICAL_COMPILE_FAILED — Canonical Compile Failed

The handler uses a source form outside the canonical Beta authoring subset.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Rewrite the handler using the documented canonical API subset.
2. Run pulse inspect --json to see unsupported source forms.

PULSE_CANONICAL_PURE_LOOP_UNSUPPORTED — Canonical Pure Loop Unsupported

The loop does not satisfy the bounded pure-value control-flow contract.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Use a let counter starting at zero, a literal cap first, and an increment of one.
2. Keep the body within bounded pure value operations and move context operations outside the loop.
3. Respect the documented per-loop and nested iteration limits.

PULSE_CANONICAL_EFFECT_COLLECTION_UNSUPPORTED — Canonical Effect Collection Unsupported

The source does not satisfy the bounded collection build/flush contract.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Use one local const collection with literal max 1–32, one direct for-of/add, then one awaited flush.
2. Keep helper calls, mutation, filtering, nesting and escaping handles outside the collection build region.

PULSE_CANONICAL_READ_LOOP_UNSUPPORTED — Canonical Read Loop Unsupported

The loop does not satisfy the bounded sequential read control-flow contract.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Use a let counter starting at zero, a literal cap from 0 through 64 first, and an increment of one.
2. Use sequential s3.getText, kv.getVersioned or crypto.digestText calls directly bound to one local or discarded.
3. Keep nested loops pure; avoid parallel effects, writes, callbacks, counter mutation and labelled transfers.

PULSE_CANONICAL_NATIVE_PLAN_FAILED — Canonical Native Plan Failed

The canonical handler could not be represented by the provider-neutral native execution-plan contract.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Inspect the native-plan diagnostics and rewrite unsupported canonical control flow.
2. Run pulse inspect --json to view the provider-neutral plan boundary.

PULSE_CANONICAL_NATIVE_AS_GENERATION_FAILED — Canonical Native As Generation Failed

The validated native plan could not be rendered into the bounded AssemblyScript state-machine source.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Inspect the generated-native diagnostic and rewrite unsupported canonical expressions.
2. Retain the plan hash and diagnostic detail when reporting a compiler defect.

PULSE_PACKAGE_LOWERING_FAILED — Package Lowering Failed

A package-owned API call could not be lowered into its canonical effect contract.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Fix the package-owned API call shape reported in the nested diagnostic.
2. Keep package effects in the documented static positions.

PULSE_NATIVE_IMPORT_UNSUPPORTED — Native Import Unsupported

A reachable runtime import has neither supported static source nor a trusted Pulse native contract.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Use an exact declared ESM source export in the bounded handler/helper subset, a trusted Pulse capability, or an explicit JavaScript target.
2. Pulse will not change targets automatically.

PULSE_PACKAGE_SUBPATH_UNSUPPORTED — Package Subpath Unsupported

A Pulse-aware package was imported through a subpath that is not native-lowerable.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Import the package through its documented Pulse lowerable facade, or keep the package behind a JavaScript-only boundary.
2. Run pulse inspect --json to review package ownership and native eligibility.

PULSE_PACKAGE_REEXPORT_LOWERING_DEFERRED — Package Reexport Lowering Deferred

A package-owned helper is graph-owned but reaches application code through a project re-export whose lowering remains deferred.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Import the package-owned facade directly until helper/re-export lowering is enabled by the package contract.
2. The graph records the owning package; no fallback occurs.

PULSE_APPLICATION_ENTRY_LIFECYCLE_SIDE_EFFECT — Application Entry Lifecycle Side Effect

The configured application entry graph starts a known provider lifecycle during module evaluation.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Keep the configured application entry import-safe and move provider lifecycle startup to a separate runner.
2. Use the provider lifecycle through CLI delegation rather than starting infrastructure during application import.

PULSE_PACKAGE_BINDING_OWNERSHIP_AMBIGUOUS — Package Binding Ownership Ambiguous

A project binding or re-export resolves to more than one package-owned symbol.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Remove the ambiguous re-export or give each package-owned helper one unambiguous source owner.

PULSE_PACKAGE_CONTRACT_NOT_RECOGNIZED — Package Contract Not Recognized

The graph selected a trusted package contract that the package recognizer did not recover from its owning source module.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Verify the trusted package manifest and direct facade import, then retain the graph and package diagnostics when reporting the issue.

PULSE_REQUEST_FORWARDING_UNAVAILABLE — Request Forwarding Unavailable

Incoming forwarding is not enabled on this target.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Select Node with node.bodyForwarding and node.maxDurationMs.

PULSE_REQUEST_FORWARDING_FORM_UNSUPPORTED — Request Forwarding Form Unsupported

The incoming body marker appears outside its supported inline POST position.

• Category: compile
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Use body: ctx.req.body() directly in a literal outbound POST fetch.

Runtime diagnostics

Code	Meaning	CLI exit
PULSE_CALL_BOUNDARY_INVALID	A computation call violated its target, schema, count or lifetime boundary.	4
PULSE_NUMERIC_WORKSPACE_INVALID	Numeric workspace construction, ownership, index, or value is invalid.	4
PULSE_BINARY_RESOURCE_INVALID	Binary resource declaration, view, or scalar read is invalid.	4
PULSE_EFFECT_COLLECTION_CAPACITY	Collection capacity must be an integer from 1 to 32.	4
PULSE_EFFECT_COLLECTION_OVERFLOW	Collection capacity was exceeded before dispatch.	4
PULSE_EFFECT_COLLECTION_MEMBER	A collection member is not a fresh parallel-eligible Pulse effect.	4
PULSE_EFFECT_COLLECTION_OWNER	A collection or member belongs to another execution or overlaps an open collection.	4
PULSE_EFFECT_COLLECTION_CLAIMED	An effect root was already started or claimed.	4
PULSE_EFFECT_COLLECTION_SEALED	Collection membership is already sealed.	4
PULSE_EFFECT_COLLECTION_UNFLUSHED	A nonempty collection reached handler completion without an explicit flush.	4
PULSE_FETCH_SCHEMA_WITHOUT_JSON	An outbound fetch schema was supplied without a semantic JSON payload.	4
PULSE_PACKAGE_SNAPSHOT_INVALID	The host cannot capture the supplied HTTP inputs within the supported representation and bounds.	4
PULSE_PACKAGE_SNAPSHOT_UNAVAILABLE	A live authoritative HTTP capture for this package binding is unavailable.	4
PULSE_PACKAGE_OPERATION_FAILED	The bounded package operation failed; private provider and protocol data are withheld.	4
PULSE_TRANSFORM_CHUNK_INVALID	A provider transform chunk or backing allocation exceeded its bound.	4
PULSE_TRANSFORM_OUTPUT_LIMIT	Transform output exceeded its total-byte or expansion limit.	4
PULSE_TRANSFORM_READ_LIMIT	The transform exceeded its admitted read count.	4
PULSE_TRANSFORM_CLOSED	Transform input was read after EOF, cancellation or request completion.	4
PULSE_TRANSFORM_EOF_REQUIRED	Transform output was closed before input EOF was observed.	4
PULSE_REQUEST_FORWARDING_CHUNK_INVALID	A provider body chunk exceeds the admitted host chunk bound.	4
PULSE_REQUEST_FORWARDING_REDIRECT	A single-use body cannot be replayed on redirect.	4
PULSE_BODY_UNAVAILABLE	A structured body was requested when the provider had not supplied one.	4
PULSE_OPAQUE_BODY_INSPECTION	Application code attempted to inspect or transform an opaque host-owned body.	4
PULSE_RESPONSE_ENCODE	The selected response encoder cannot represent the returned value.	4
PULSE_SCHEMA_ENCODE	The returned value does not satisfy its declared response schema.	4
PULSE_FETCH_TIMEOUT	An outbound fetch did not complete before its timeout.	4
PULSE_FETCH_NETWORK	An outbound fetch failed because the origin or network was unavailable.	4
PULSE_FETCH_URL_INVALID	An outbound fetch uses an invalid or unsupported URL.	4
PULSE_CONTINUATION_EXPIRED	A pending continuation exceeded its configured lifetime before resumption.	4
PULSE_CONTINUATION_DOUBLE_RESUME	A provider attempted to resume the same continuation more than once.	4

PULSE_CALL_BOUNDARY_INVALID — Call Boundary Invalid

A computation call violated its target, schema, count or lifetime boundary.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Rebuild the application from admitted source; use each computation only within its request, static call count and invocation-owned view lifetime.

PULSE_NUMERIC_WORKSPACE_INVALID — Numeric Workspace Invalid

Numeric workspace construction, ownership, index, or value is invalid.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Create const numeric workspaces with literal capacity 1..1024 outside loops; use direct in-bounds indexed reads and finite numeric writes within the owning execution.

PULSE_BINARY_RESOURCE_INVALID — Binary Resource Invalid

Binary resource declaration, view, or scalar read is invalid.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Declare finite resource admission budgets; use literal const views and in-bounds scalar reads within the owning execution.

PULSE_EFFECT_COLLECTION_CAPACITY — Effect Collection Capacity

Collection capacity must be an integer from 1 to 32.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Use fresh execution-owned effects within capacity and flush the collection exactly once.

PULSE_EFFECT_COLLECTION_OVERFLOW — Effect Collection Overflow

Collection capacity was exceeded before dispatch.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Use fresh execution-owned effects within capacity and flush the collection exactly once.

PULSE_EFFECT_COLLECTION_MEMBER — Effect Collection Member

A collection member is not a fresh parallel-eligible Pulse effect.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Use fresh execution-owned effects within capacity and flush the collection exactly once.

PULSE_EFFECT_COLLECTION_OWNER — Effect Collection Owner

A collection or member belongs to another execution or overlaps an open collection.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Use fresh execution-owned effects within capacity and flush the collection exactly once.

PULSE_EFFECT_COLLECTION_CLAIMED — Effect Collection Claimed

An effect root was already started or claimed.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Use fresh execution-owned effects within capacity and flush the collection exactly once.

PULSE_EFFECT_COLLECTION_SEALED — Effect Collection Sealed

Collection membership is already sealed.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Use fresh execution-owned effects within capacity and flush the collection exactly once.

PULSE_EFFECT_COLLECTION_UNFLUSHED — Effect Collection Unflushed

A nonempty collection reached handler completion without an explicit flush.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Use fresh execution-owned effects within capacity and flush the collection exactly once.

PULSE_FETCH_SCHEMA_WITHOUT_JSON — Fetch Schema Without JSON

An outbound fetch schema was supplied without a semantic JSON payload.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Use schema only together with the outbound fetch json field.

PULSE_PACKAGE_SNAPSHOT_INVALID — Package Snapshot Invalid

The host cannot capture the supplied HTTP inputs within the supported representation and bounds.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 400
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Capture an original origin-form HTTP target, ordered ASCII fields and at most 65536 exact body bytes at the trusted host boundary.

PULSE_PACKAGE_SNAPSHOT_UNAVAILABLE — Package Snapshot Unavailable

A live authoritative HTTP capture for this package binding is unavailable.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Supply a live provider-owned HTTP capture for the configured trusted origin.
2. Do not reconstruct captures from normalized URLs or application records.

PULSE_PACKAGE_OPERATION_FAILED — Package Operation Failed

The bounded package operation failed; private provider and protocol data are withheld.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Check the versioned package Wasm ABI, resource limits and named host key binding.
2. Keep keys, message bytes and backend failure details out of diagnostics.

PULSE_TRANSFORM_CHUNK_INVALID — Transform Chunk Invalid

A provider transform chunk or backing allocation exceeded its bound.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Use a provider source whose chunks and backing allocations are each at most 65536 bytes.

PULSE_TRANSFORM_OUTPUT_LIMIT — Transform Output Limit

Transform output exceeded its total-byte or expansion limit.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Keep output within 262144 bytes and four times the input bytes delivered so far.

PULSE_TRANSFORM_READ_LIMIT — Transform Read Limit

The transform exceeded its admitted read count.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Stop after the EOF result; at most 18 reads are admitted.

PULSE_TRANSFORM_CLOSED — Transform Closed

Transform input was read after EOF, cancellation or request completion.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Do not read after EOF, cancellation or request completion.

PULSE_TRANSFORM_EOF_REQUIRED — Transform Eof Required

Transform output was closed before input EOF was observed.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Read transform input through its EOF result before returning output.close().

PULSE_REQUEST_FORWARDING_CHUNK_INVALID — Request Forwarding Chunk Invalid

A provider body chunk exceeds the admitted host chunk bound.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Supply host chunks and backing allocations at most 65536 bytes; do not fall back to buffering.

PULSE_REQUEST_FORWARDING_REDIRECT — Request Forwarding Redirect

A single-use body cannot be replayed on redirect.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Use the final authorized origin URL directly; automatic redirect replay is disabled.

PULSE_BODY_UNAVAILABLE — Body Unavailable

A structured body was requested when the provider had not supplied one.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Ensure the provider supplied a structured body snapshot before decoding it.

PULSE_OPAQUE_BODY_INSPECTION — Opaque Body Inspection

Application code attempted to inspect or transform an opaque host-owned body.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 400
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Return or proxy the opaque response directly; do not call JSON, text, bytes, or transform helpers.

PULSE_RESPONSE_ENCODE — Response Encode

The selected response encoder cannot represent the returned value.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Return a value supported by the selected response or schema encoder.

PULSE_SCHEMA_ENCODE — Schema Encode

The returned value does not satisfy its declared response schema.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Return a value that satisfies the declared response schema.

PULSE_FETCH_TIMEOUT — Fetch Timeout

An outbound fetch did not complete before its timeout.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 504
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Check the origin and timeout policy, then retry.
2. Use a configured fetch fixture in tests for deterministic reproduction.

PULSE_FETCH_NETWORK — Fetch Network

An outbound fetch failed because the origin or network was unavailable.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 502
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Check the origin URL, backend binding, and local network access.

PULSE_FETCH_URL_INVALID — Fetch URL Invalid

An outbound fetch uses an invalid or unsupported URL.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 400
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Use an absolute supported URL or a correctly configured provider backend.

PULSE_CONTINUATION_EXPIRED — Continuation Expired

A pending continuation exceeded its configured lifetime before resumption.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 504
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Increase the continuation TTL only if the provider operation is expected to take longer.

PULSE_CONTINUATION_DOUBLE_RESUME — Continuation Double Resume

A provider attempted to resume the same continuation more than once.

• Category: runtime
• CLI exit class: 4
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Report this as a Pulse runtime/provider bug with the continuation trace.

Report diagnostics

Code	Meaning	CLI exit
PULSE_REPORT_INPUT_INVALID	Report evidence is malformed, unsafe, or fails integrity validation.	3
PULSE_REPORT_EVIDENCE_MISSING	A matching completed Wasm build and its required retained evidence are missing.	3
PULSE_REPORT_STALE	Retained Report evidence does not match the selected inputs or changed during collection.	3
PULSE_REPORT_INCOMPATIBLE	The Report input version or output representation is unsupported.	3
PULSE_REPORT_OUTPUT_UNSAFE	The HTML output path is not a contained regular .html file.	2
PULSE_REPORT_OUTPUT_FAILED	The HTML report could not be written atomically.	3
PULSE_REPORT_HTML_UNAVAILABLE	The offline Report HTML renderer is not available in this build.	3

PULSE_REPORT_INPUT_INVALID — Report Input Invalid

Report evidence is malformed, unsafe, or fails integrity validation.

• Category: report
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Retained build reports

Remediation

1. Use an unmodified supported Report capsule or a completed-Wasm manifest with its matching local files.

PULSE_REPORT_EVIDENCE_MISSING — Report Evidence Missing

A matching completed Wasm build and its required retained evidence are missing.

• Category: report
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Retained build reports

Remediation

1. Run pulse compile or pulse build with the selected Native profile, then retry report; report never builds automatically.

PULSE_REPORT_STALE — Report Stale

Retained Report evidence does not match the selected inputs or changed during collection.

• Category: report
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Retained build reports

Remediation

1. Rebuild the selected Native profile after inputs settle, or replay a saved capsule explicitly as historical evidence.

PULSE_REPORT_INCOMPATIBLE — Report Incompatible

The Report input version or output representation is unsupported.

• Category: report
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Retained build reports

Remediation

1. Use a supported Report v1 capsule or completed Native Wasm manifest; bare Wasm and JavaScript builds are not Report inputs.

PULSE_REPORT_OUTPUT_UNSAFE — Report Output Unsafe

The HTML output path is not a contained regular .html file.

• Category: report
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Retained build reports

Remediation

1. Choose a .html file within the selected project root or artifact JSON parent, without symbolic links or parent traversal.

PULSE_REPORT_OUTPUT_FAILED — Report Output Failed

The HTML report could not be written atomically.

• Category: report
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Retained build reports

Remediation

1. Check destination permissions and available disk space, then retry with a safe .html path.

PULSE_REPORT_HTML_UNAVAILABLE — Report Html Unavailable

The offline Report HTML renderer is not available in this build.

• Category: report
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Retained build reports

Remediation

1. Use the terminal overview or --json; HTML output requires a build with the offline viewer.

Usage diagnostics

Code	Meaning	CLI exit
PULSE_COMMAND_UNKNOWN	The requested pulse command is not part of the supported CLI.	2
PULSE_ARGUMENT_MISSING	A command-line option that requires a value was supplied without one.	2
PULSE_ARGUMENT_UNEXPECTED	The command received an option or positional argument it does not accept.	2
PULSE_PROVIDER_FLAG_REMOVED	Provider selection is project configuration, not a command-line override.	2
PULSE_SOURCE_ONLY_REMOVED	The former source-only JavaScript packaging mode is no longer part of native builds.	2

PULSE_COMMAND_UNKNOWN — Command Unknown

The requested pulse command is not part of the supported CLI.

• Category: usage
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI reference

Remediation

1. Run pulse --help and choose one of the documented commands.

PULSE_ARGUMENT_MISSING — Argument Missing

A command-line option that requires a value was supplied without one.

• Category: usage
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI reference

Remediation

1. Provide the missing flag value and rerun the command.
2. Run pulse --help for the command signature.

PULSE_ARGUMENT_UNEXPECTED — Argument Unexpected

The command received an option or positional argument it does not accept.

• Category: usage
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI reference

Remediation

1. Remove the unsupported argument or use the documented flag.
2. Run pulse --help for the command signature.

PULSE_PROVIDER_FLAG_REMOVED — Provider Flag Removed

Provider selection is project configuration, not a command-line override.

• Category: usage
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI reference

Remediation

1. Select host and target in a .pulse/config.ts profile.
2. Use pulse compile for provider-neutral Wasm or pulse build for the configured deployment target.

PULSE_SOURCE_ONLY_REMOVED — Source Only Removed

The former source-only JavaScript packaging mode is no longer part of native builds.

• Category: usage
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI reference

Remediation

1. Run pulse build; native builds emit generated source and provider Wasm together.

Project diagnostics

Code	Meaning	CLI exit
PULSE_CONFIG_NOT_FOUND	Project discovery did not find an explicit Pulse configuration file.	2
PULSE_PROFILE_SELECTION_REQUIRED	No project profile was selected by CLI, environment, or default configuration.	2
PULSE_PROFILE_UNKNOWN	The selected profile is absent from the project declaration.	2
PULSE_CONFIG_PLAN_PARITY_FAILED	Static and runtime configuration normalization produced different canonical plans.	3
PULSE_JAVASCRIPT_APPLICATION_PLAN_INVALID	The JavaScript loader received a value outside the normalized application-plan contract.	3
PULSE_JAVASCRIPT_APPLICATION_ENTRY_INVALID	The JavaScript plan entry is not a project-owned application module.	3
PULSE_JAVASCRIPT_APPLICATION_EXPORT_INVALID	The JavaScript entry does not export a managed Pulse application.	3
PULSE_JAVASCRIPT_MODULE_NOT_FOUND	A graph-owned project module is absent at JavaScript load time.	3
PULSE_RUNTIME_APPLICATION_EXPORT_INVALID	The application value is not a Router, Pulse application, or managed handler.	3
PULSE_CONFIG_LOAD_FAILED	The selected project configuration threw or failed while being loaded.	2
PULSE_ENTRY_NOT_FOUND	The configured canonical handler entry file does not exist.	2
PULSE_PROJECT_ROOT_MISSING	The selected project directory does not exist.	2
PULSE_INIT_NOT_EMPTY	Project initialization would write into a non-empty directory without explicit force.	2
PULSE_INIT_FILE_EXISTS	Project initialization would replace an existing file that is not safe to overwrite.	2
PULSE_CONFIG_IMPLICIT	A command is relying on an implicit project shape instead of an explicit configuration.	2
PULSE_REQUEST_DURATION_INVALID	The configured request duration is outside its supported range.	2
PULSE_REQUEST_DURATION_UNSUPPORTED	The selected target cannot enforce the configured request deadline.	2
PULSE_REQUEST_DURATION_ARTIFACT_MISMATCH	The Fastly artifact deadline differs from the selected profile.	2

PULSE_CONFIG_NOT_FOUND — Config Not Found

Project discovery did not find an explicit Pulse configuration file.

• Category: project
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project configuration

Remediation

1. Run pulse init to create .pulse/config.ts.
2. Ensure the command runs inside the intended project directory.

PULSE_PROFILE_SELECTION_REQUIRED — Profile Selection Required

No project profile was selected by CLI, environment, or default configuration.

• Category: project
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project configuration

Remediation

1. Pass --profile, set PULSE_PROFILE, or configure pulse.defaultProfile.

PULSE_PROFILE_UNKNOWN — Profile Unknown

The selected profile is absent from the project declaration.

• Category: project
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project configuration

Remediation

1. Select one of the profiles declared next to the reserved pulse object.

PULSE_CONFIG_PLAN_PARITY_FAILED — Config Plan Parity Failed

Static and runtime configuration normalization produced different canonical plans.

• Category: project
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project configuration

Remediation

1. Keep the config factory within the sealed static grammar and report the divergent plan hashes.

PULSE_JAVASCRIPT_APPLICATION_PLAN_INVALID — Javascript Application Plan Invalid

The JavaScript loader received a value outside the normalized application-plan contract.

• Category: project
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project configuration

Remediation

1. Rebuild the JavaScript application plan from the configured entry and sealed reachable graph.

PULSE_JAVASCRIPT_APPLICATION_ENTRY_INVALID — Javascript Application Entry Invalid

The JavaScript plan entry is not a project-owned application module.

• Category: project
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project configuration

Remediation

1. Default-export a Router, Pulse application, or managed handler from a project-owned entry module.

PULSE_JAVASCRIPT_APPLICATION_EXPORT_INVALID — Javascript Application Export Invalid

The JavaScript entry does not export a managed Pulse application.

• Category: project
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project configuration

Remediation

1. Default-export a Router, Pulse application, or managed handler.

PULSE_JAVASCRIPT_MODULE_NOT_FOUND — Javascript Module Not Found

A graph-owned project module is absent at JavaScript load time.

• Category: project
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project configuration

Remediation

1. Restore the graph-owned project module or rebuild the plan after the source change.

PULSE_RUNTIME_APPLICATION_EXPORT_INVALID — Runtime Application Export Invalid

The application value is not a Router, Pulse application, or managed handler.

• Category: project
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project configuration

Remediation

1. Default-export a Router, Pulse application, or managed handler.

PULSE_CONFIG_LOAD_FAILED — Config Load Failed

The selected project configuration threw or failed while being loaded.

• Category: project
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project configuration

Remediation

1. Fix the config import or runtime error.
2. Use pulse doctor --json to inspect the underlying cause.

PULSE_ENTRY_NOT_FOUND — Entry Not Found

The configured canonical handler entry file does not exist.

• Category: project
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project configuration

Remediation

1. Create the configured entry file or correct pulse.entry in .pulse/config.ts.

PULSE_PROJECT_ROOT_MISSING — Project Root Missing

The selected project directory does not exist.

• Category: project
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project configuration

Remediation

1. Create or correct the positional project directory.

PULSE_INIT_NOT_EMPTY — Init Not Empty

Project initialization would write into a non-empty directory without explicit force.

• Category: project
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project configuration

Remediation

1. Choose an empty directory or pass --force only when overwriting is intentional.

PULSE_INIT_FILE_EXISTS — Init File Exists

Project initialization would replace an existing file that is not safe to overwrite.

• Category: project
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project configuration

Remediation

1. Remove the conflicting file or choose another target directory.

PULSE_CONFIG_IMPLICIT — Config Implicit

A command is relying on an implicit project shape instead of an explicit configuration.

• Category: project
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project configuration

Remediation

1. Run pulse init or create .pulse/config.ts to make workspace ownership explicit.

PULSE_REQUEST_DURATION_INVALID — Request Duration Invalid

The configured request duration is outside its supported range.

• Category: project
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project configuration

Remediation

1. Set provider maxDurationMs to an integer from 1 through 30000, or omit it.

PULSE_REQUEST_DURATION_UNSUPPORTED — Request Duration Unsupported

The selected target cannot enforce the configured request deadline.

• Category: project
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project configuration

Remediation

1. Select Fastly Native for a provider-owned request deadline.

PULSE_REQUEST_DURATION_ARTIFACT_MISMATCH — Request Duration Artifact Mismatch

The Fastly artifact deadline differs from the selected profile.

• Category: project
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project configuration

Remediation

1. Rebuild the Fastly Native artifact using the selected profile.

Test diagnostics

Code	Meaning	CLI exit
PULSE_TEST_HARNESS_NOT_FOUND	The configured workspace-relative test harness does not exist.	2
PULSE_TEST_HARNESS_EXPORT_INVALID	The configured harness does not export the required ordered case collection.	2
PULSE_TEST_EXPECT_INVALID	A project test case uses an invalid expectation shape for its HTTP or event discriminant.	2
PULSE_TEST_EVENT_INVALID	A discriminated event test case is missing or violates the canonical bounded event-frame shape.	2

PULSE_TEST_HARNESS_NOT_FOUND — Test Harness Not Found

The configured workspace-relative test harness does not exist.

• Category: test
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI test behavior

Remediation

1. Create the workspace-relative file configured by pulse.tests.

PULSE_TEST_HARNESS_EXPORT_INVALID — Test Harness Export Invalid

The configured harness does not export the required ordered case collection.

• Category: test
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI test behavior

Remediation

1. Export an ordered case array or an object containing a cases array.

PULSE_TEST_EXPECT_INVALID — Test Expect Invalid

A project test case uses an invalid expectation shape for its HTTP or event discriminant.

• Category: test
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI test behavior

Remediation

1. Use the documented expectation shape for the selected HTTP or event case.
2. Event emitted-frame expectations must be ordered arrays of canonical frames.

PULSE_TEST_EVENT_INVALID — Test Event Invalid

A discriminated event test case is missing or violates the canonical bounded event-frame shape.

• Category: test
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI test behavior

Remediation

1. Use a discriminated kind: "event" case with one bounded type, schema or schemaId, and schema-dependent payload.
2. Inspect the event catalog with pulse inspect --json.

Capability diagnostics

Code	Meaning	CLI exit
PULSE_TARGET_IMPLEMENTATION_PENDING	The selected execution target is explicit but not implemented for this command.	3
PULSE_JAVASCRIPT_APPLICATION_UNAVAILABLE	The selected JavaScript application has one or more explicit target blockers.	3
PULSE_JAVASCRIPT_PACKAGE_REALIZATION_UNAVAILABLE	A reachable Pulse-aware package has no JavaScript realization for the selected target.	3
PULSE_PACKAGE_JAVASCRIPT_REALIZATION_NOT_IMPLEMENTED	A reachable Pulse-aware package explicitly declares that its JavaScript realization is not implemented.	3
PULSE_JAVASCRIPT_PACKAGE_ESM_UNSUPPORTED	The current graph-backed Node loader cannot require the selected ESM-only package entry.	3
PULSE_JAVASCRIPT_PACKAGE_MODULE_UNAVAILABLE	The graph-selected JavaScript package module cannot be loaded from the application workspace.	3
PULSE_JAVASCRIPT_EXTERNAL_MODULE_UNAVAILABLE	A declared external module is unavailable to the JavaScript application loader.	3
PULSE_NATIVE_TEXT_UNSUPPORTED	Diagnostic WebAssembly text is available only for Native compilation.	2
PULSE_EXPERIMENTAL_NATIVE_SIZE_UNSUPPORTED	Native optimization selections cannot be used for a JavaScript build target.	2
PULSE_PROVIDER_COMPILE_ONLY	The none provider cannot execute development-server or project-test behavior.	2
PULSE_TEST_PROVIDER_REQUIRED	Project tests require an executable provider.	2
PULSE_DEV_PROVIDER_UNSUPPORTED	The development server requires an executable provider.	2
PULSE_PROVIDER_CAPABILITY_MISSING	The selected provider lacks a binding required by the compiled application.	3
PULSE_PACKAGE_CAPABILITY_UNAVAILABLE	The package invocation lacks its exact artifact, operation grant or selected host capability.	3
PULSE_PROVIDER_CAPABILITY_UNSUPPORTED	The selected provider cannot realize a capability required by the application.	3
PULSE_EVENT_TARGET_UNSUPPORTED	The selected provider target cannot realize or test the reachable event plane.	3
PULSE_TRANSFORM_UNAVAILABLE	The selected target cannot realize the configured UTF-8 transform.	3

PULSE_TARGET_IMPLEMENTATION_PENDING — Target Implementation Pending

The selected execution target is explicit but not implemented for this command.

• Category: capability
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Provider restrictions

Remediation

1. Inspect the selected provider and target; use supportedCommands from the diagnostic detail when present.
2. Choose an explicitly implemented command/profile combination; inspect or doctor may retain the selected target for analysis. No target fallback is automatic.

PULSE_JAVASCRIPT_APPLICATION_UNAVAILABLE — Javascript Application Unavailable

The selected JavaScript application has one or more explicit target blockers.

• Category: capability
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Provider restrictions

Remediation

1. Inspect the application-plan blockers and select only explicitly realized package and provider capabilities.
2. Pulse will not fall back to native or another target automatically.

PULSE_JAVASCRIPT_PACKAGE_REALIZATION_UNAVAILABLE — Javascript Package Realization Unavailable

A reachable Pulse-aware package has no JavaScript realization for the selected target.

• Category: capability
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Provider restrictions

Remediation

1. Use a package with an explicit JavaScript realization or select a native target.
2. Inspect package target support with pulse inspect --json.

PULSE_PACKAGE_JAVASCRIPT_REALIZATION_NOT_IMPLEMENTED — Package Javascript Realization Not Implemented

A reachable Pulse-aware package explicitly declares that its JavaScript realization is not implemented.

• Category: capability
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Provider restrictions

Remediation

1. Select the native target for this package or wait for its declared JavaScript realization.
2. No automatic fallback occurs.

PULSE_JAVASCRIPT_PACKAGE_ESM_UNSUPPORTED — Javascript Package Esm Unsupported

The current graph-backed Node loader cannot require the selected ESM-only package entry.

• Category: capability
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Provider restrictions

Remediation

1. Use a CommonJS-compatible package entry for the current Node loader or defer the package to a later JavaScript bundling contract.

PULSE_JAVASCRIPT_PACKAGE_MODULE_UNAVAILABLE — Javascript Package Module Unavailable

The graph-selected JavaScript package module cannot be loaded from the application workspace.

• Category: capability
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Provider restrictions

Remediation

1. Install the exact package selected by the reachable graph in the application workspace.

PULSE_JAVASCRIPT_EXTERNAL_MODULE_UNAVAILABLE — Javascript External Module Unavailable

A declared external module is unavailable to the JavaScript application loader.

• Category: capability
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Provider restrictions

Remediation

1. Install or explicitly declare the external module required by the JavaScript target.

PULSE_NATIVE_TEXT_UNSUPPORTED — Native Text Unsupported

Diagnostic WebAssembly text is available only for Native compilation.

• Category: capability
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Provider restrictions

Remediation

1. Select a Native build profile or use pulse compile --emit-wat.
2. Remove --emit-wat for JavaScript builds.

PULSE_EXPERIMENTAL_NATIVE_SIZE_UNSUPPORTED — Experimental Native Size Unsupported

Native optimization selections cannot be used for a JavaScript build target.

• Category: capability
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Provider restrictions

Remediation

1. Select a profile with target: "native" or use pulse compile.
2. Remove Native recipe flags (--native-shrink0, --experimental-native-size, --experimental-native-bounded-size) for JavaScript build output.

PULSE_PROVIDER_COMPILE_ONLY — Provider Compile Only

The none provider cannot execute development-server or project-test behavior.

• Category: capability
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Provider restrictions

Remediation

1. Select an executable provider before running pulse dev or pulse test.

PULSE_TEST_PROVIDER_REQUIRED — Test Provider Required

Project tests require an executable provider.

• Category: capability
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Provider restrictions

Remediation

1. Select an executable provider for pulse test.

PULSE_DEV_PROVIDER_UNSUPPORTED — Dev Provider Unsupported

The development server requires an executable provider.

• Category: capability
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Provider restrictions

Remediation

1. Select an executable provider for pulse dev.

PULSE_PROVIDER_CAPABILITY_MISSING — Provider Capability Missing

The selected provider lacks a binding required by the compiled application.

• Category: capability
• CLI exit class: 3
• Development HTTP status: 501
• Stability/scope: preview-stable / public
• Related reference: Provider restrictions

Remediation

1. Configure the required provider binding or select a provider that implements the capability.
2. Run pulse inspect --json to view required capabilities and bindings.

PULSE_PACKAGE_CAPABILITY_UNAVAILABLE — Package Capability Unavailable

The package invocation lacks its exact artifact, operation grant or selected host capability.

• Category: capability
• CLI exit class: 3
• Development HTTP status: 501
• Stability/scope: preview-stable / public
• Related reference: Provider restrictions

Remediation

1. Supply the exact compiled package artifact and matching host operation grant, including the selected crypto realization.
2. Package declarations and wire metadata cannot grant host authority.

PULSE_PROVIDER_CAPABILITY_UNSUPPORTED — Provider Capability Unsupported

The selected provider cannot realize a capability required by the application.

• Category: capability
• CLI exit class: 3
• Development HTTP status: 501
• Stability/scope: preview-stable / public
• Related reference: Provider restrictions

Remediation

1. Remove the unsupported capability or select a compatible provider.

PULSE_EVENT_TARGET_UNSUPPORTED — Event Target Unsupported

The selected provider target cannot realize or test the reachable event plane.

• Category: capability
• CLI exit class: 3
• Development HTTP status: 501
• Stability/scope: preview-stable / public
• Related reference: Provider restrictions

Remediation

1. Select a target whose descriptor and provider event driver satisfy every reachable event requirement.
2. Use pulse inspect --json to review event target support; Pulse will not select another target automatically.

PULSE_TRANSFORM_UNAVAILABLE — Transform Unavailable

The selected target cannot realize the configured UTF-8 transform.

• Category: capability
• CLI exit class: 3
• Development HTTP status: 501
• Stability/scope: preview-stable / public
• Related reference: Provider restrictions

Remediation

1. Select Node and configure node.bodyTransform, node.generatedOutput and node.maxDurationMs.

Internal diagnostics

Code	Meaning	CLI exit
PULSE_JAVASCRIPT_PACKAGE_PLAN_MISSING	The graph selected a package module that is absent from the JavaScript application plan.	3
PULSE_JAVASCRIPT_GRAPH_EDGE_AMBIGUOUS	The sealed JavaScript graph contains more than one runtime edge for the same import.	3
PULSE_JAVASCRIPT_GRAPH_MODULE_MISSING	A JavaScript graph edge or entry references a missing graph module.	3
PULSE_JAVASCRIPT_MODULE_KIND_UNSUPPORTED	The JavaScript loader encountered a module kind outside its sealed contract.	3

PULSE_JAVASCRIPT_PACKAGE_PLAN_MISSING — Javascript Package Plan Missing

The graph selected a package module that is absent from the JavaScript application plan.

• Category: internal
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Rebuild the JavaScript plan and retain the graph and plan hashes when reporting the inconsistency.

PULSE_JAVASCRIPT_GRAPH_EDGE_AMBIGUOUS — Javascript Graph Edge Ambiguous

The sealed JavaScript graph contains more than one runtime edge for the same import.

• Category: internal
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Retain the graph manifest and report the duplicate runtime edge.

PULSE_JAVASCRIPT_GRAPH_MODULE_MISSING — Javascript Graph Module Missing

A JavaScript graph edge or entry references a missing graph module.

• Category: internal
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Rebuild the JavaScript plan from the exact source tree and retain the graph manifest.

PULSE_JAVASCRIPT_MODULE_KIND_UNSUPPORTED — Javascript Module Kind Unsupported

The JavaScript loader encountered a module kind outside its sealed contract.

• Category: internal
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Retain the application plan and report the unsupported module kind.

Safety diagnostics

Code	Meaning	CLI exit
PULSE_JAVASCRIPT_MODULE_OUTSIDE_WORKSPACE	A graph-owned project module escapes the authoritative workspace.	3
PULSE_JAVASCRIPT_MODULE_SOURCE_CHANGED	A graph-owned project module changed after the JavaScript plan was created.	3
PULSE_BUILD_OUT_UNSAFE	The resolved build output can escape or alias outside the project root.	2

PULSE_JAVASCRIPT_MODULE_OUTSIDE_WORKSPACE — Javascript Module Outside Workspace

A graph-owned project module escapes the authoritative workspace.

• Category: safety
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI build behavior

Remediation

1. Keep every graph-owned project module inside the authoritative Pulse workspace.

PULSE_JAVASCRIPT_MODULE_SOURCE_CHANGED — Javascript Module Source Changed

A graph-owned project module changed after the JavaScript plan was created.

• Category: safety
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI build behavior

Remediation

1. Rebuild the JavaScript application plan after changing a project module.

PULSE_BUILD_OUT_UNSAFE — Build Out Unsafe

The resolved build output can escape or alias outside the project root.

• Category: safety
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI build behavior

Remediation

1. Choose an output directory that is a real child of the project root.
2. Do not use .., external absolute paths, or symbolic-link traversal.

Provider diagnostics

Code	Meaning	CLI exit
PULSE_PROVIDER_UNSUPPORTED	The selected provider value is not a supported shorthand or package selection.	2
PULSE_PROVIDER_PACKAGE_NOT_FOUND	The exact configured provider package does not expose a resolvable toolchain entry.	2
PULSE_PROVIDER_TOOLCHAIN_LOAD_FAILED	The selected provider package toolchain failed while loading.	3
PULSE_PROVIDER_TOOLCHAIN_INVALID	The selected provider package does not satisfy the versioned toolchain contract.	3
PULSE_BUILD_PROVIDER_REQUIRED	pulse build requires a configured deployment provider; provider-neutral output belongs to pulse compile.	2
PULSE_FASTLY_EVENT_INGRESS_UNSUPPORTED	Fastly does not expose the host-neutral event ingress required by the application.	3
PULSE_FASTLY_EVENT_EMIT_UNSUPPORTED	Fastly does not expose the host-neutral event acceptance operation required by the application.	3
PULSE_FASTLY_LOG_ENDPOINT_INVALID	The configured Fastly named logging endpoint is invalid or reserved.	2
PULSE_FASTLY_BACKEND_REQUIRED	A static Fastly outbound origin has no configured backend and dynamic backends are disabled.	3
PULSE_FASTLY_BACKEND_BINDINGS_INVALID	The Fastly backend binding map is not a valid string-to-string mapping.	2
PULSE_FASTLY_KV_BINDINGS_INVALID	The Fastly KV binding map is not a valid string-to-string mapping.	2
PULSE_FASTLY_GRIP_FANOUT_BACKEND_REQUIRED	A GRIP hold operation requires a configured Fastly Fanout backend.	3
PULSE_FASTLY_GRIP_PUBLISH_BINDING_REQUIRED	A GRIP publish operation requires configured Fastly publish URL and backend bindings.	3

PULSE_PROVIDER_UNSUPPORTED — Provider Unsupported

The selected provider value is not a supported shorthand or package selection.

• Category: provider
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Fastly provider configuration

Remediation

1. Select a bare provider id or an exact installed scoped provider package name.

PULSE_PROVIDER_PACKAGE_NOT_FOUND — Provider Package Not Found

The exact configured provider package does not expose a resolvable toolchain entry.

• Category: provider
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Fastly provider configuration

Remediation

1. Install the exact configured provider package in the project.
2. Confirm that its package manifest exports ./toolchain.

PULSE_PROVIDER_TOOLCHAIN_LOAD_FAILED — Provider Toolchain Load Failed

The selected provider package toolchain failed while loading.

• Category: provider
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Fastly provider configuration

Remediation

1. Inspect the selected provider package and its dependency installation.
2. Treat provider toolchains as trusted project build code.

PULSE_PROVIDER_TOOLCHAIN_INVALID — Provider Toolchain Invalid

The selected provider package does not satisfy the versioned toolchain contract.

• Category: provider
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Fastly provider configuration

Remediation

1. Use a provider package implementing pulse.provider-toolchain.v1 at ./toolchain.
2. Confirm the declared package name, provider id, and driver shape.

PULSE_BUILD_PROVIDER_REQUIRED — Build Provider Required

pulse build requires a configured deployment provider; provider-neutral output belongs to pulse compile.

• Category: provider
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Fastly provider configuration

Remediation

1. Select an executable host in the active .pulse/config.ts profile.
2. Use pulse compile when only provider-neutral Wasm is required.

PULSE_FASTLY_EVENT_INGRESS_UNSUPPORTED — Fastly Event Ingress Unsupported

Fastly does not expose the host-neutral event ingress required by the application.

• Category: provider
• CLI exit class: 3
• Development HTTP status: 501
• Stability/scope: preview-stable / public
• Related reference: Fastly provider configuration

Remediation

1. Select Node JavaScript or Node Native for event execution, or use none for compile-only inspection.
2. Do not map event ingress through HTTP or GRIP.

PULSE_FASTLY_EVENT_EMIT_UNSUPPORTED — Fastly Event Emit Unsupported

Fastly does not expose the host-neutral event acceptance operation required by the application.

• Category: provider
• CLI exit class: 3
• Development HTTP status: 501
• Stability/scope: preview-stable / public
• Related reference: Fastly provider configuration

Remediation

1. Remove the reachable event.emit requirement or select Node JavaScript or Node Native.
2. Pulse will not substitute logging, HTTP, GRIP, or another target.

PULSE_FASTLY_LOG_ENDPOINT_INVALID — Fastly Log Endpoint Invalid

The configured Fastly named logging endpoint is invalid or reserved.

• Category: provider
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Fastly provider configuration

Remediation

1. Configure fastly.bindings.logEndpoint (or fastly({logEndpoint})) with a non-reserved endpoint name of 1–255 UTF-8 bytes.
2. Omit logEndpoint to retain stdout; create the named stream separately on the selected Fastly service.

PULSE_FASTLY_BACKEND_REQUIRED — Fastly Backend Required

A static Fastly outbound origin has no configured backend and dynamic backends are disabled.

• Category: provider
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Fastly provider configuration

Remediation

1. Declare a static Fastly backend binding for the requested origin, or explicitly enable dynamic backends.

PULSE_FASTLY_BACKEND_BINDINGS_INVALID — Fastly Backend Bindings Invalid

The Fastly backend binding map is not a valid string-to-string mapping.

• Category: provider
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Fastly provider configuration

Remediation

1. Correct the Fastly backends map in the active .pulse/config.ts profile.

PULSE_FASTLY_KV_BINDINGS_INVALID — Fastly KV Bindings Invalid

The Fastly KV binding map is not a valid string-to-string mapping.

• Category: provider
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Fastly provider configuration

Remediation

1. Correct the Fastly kv binding map in the active .pulse/config.ts profile.

PULSE_FASTLY_GRIP_FANOUT_BACKEND_REQUIRED — Fastly GRIP Fanout Backend Required

A GRIP hold operation requires a configured Fastly Fanout backend.

• Category: provider
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Fastly provider configuration

Remediation

1. Configure the Fastly Fanout backend required by grip.hold.

PULSE_FASTLY_GRIP_PUBLISH_BINDING_REQUIRED — Fastly GRIP Publish Binding Required

A GRIP publish operation requires configured Fastly publish URL and backend bindings.

• Category: provider
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Fastly provider configuration

Remediation

1. Configure the Fastly GRIP publish backend and URL binding.

Toolchain diagnostics

Code	Meaning	CLI exit
PULSE_DOCS_UNAVAILABLE	The executing CLI package documentation index is missing or unreadable.	5
PULSE_DOCS_INVALID	The executing CLI package documentation index has an invalid type, location or text format.	5
PULSE_NODE_VERSION_UNSUPPORTED	The active Node.js version is outside the supported release range.	5
PULSE_FETCH_IMPLEMENTATION_UNAVAILABLE	No supported local fetch implementation is available for the requested operation.	5
PULSE_CANONICAL_NATIVE_COMPILE_FAILED	The provider-neutral native plan could not be compiled into Pulse-owned WebAssembly.	5
PULSE_FASTLY_CLI_UNAVAILABLE	The Fastly executable required for local target execution is unavailable.	5
PULSE_FASTLY_CLI_INSPECTION_FAILED	Pulse could not inspect the installed Fastly CLI version.	5
PULSE_VICEROY_UNAVAILABLE	The explicitly selected Viceroy override is unavailable.	5
PULSE_VICEROY_INSPECTION_FAILED	Pulse could not inspect the explicitly selected Viceroy override.	5
PULSE_FASTLY_SERVE_START_FAILED	The Fastly local Compute service failed before becoming ready.	5
PULSE_FASTLY_SERVE_START_TIMEOUT	The Fastly local Compute service did not become ready before its startup timeout.	5
PULSE_FASTLY_REQUEST_TIMEOUT	A request to the local Fastly Compute service exceeded its timeout.	5

PULSE_DOCS_UNAVAILABLE — Docs Unavailable

The executing CLI package documentation index is missing or unreadable.

• Category: toolchain
• CLI exit class: 5
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI doctor behavior

Remediation

1. Restore the documentation shipped with the executing @pulse-compute/cli package.
2. Reinstall that CLI version using your package manager; pulse docs does not install or download files.

PULSE_DOCS_INVALID — Docs Invalid

The executing CLI package documentation index has an invalid type, location or text format.

• Category: toolchain
• CLI exit class: 5
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI doctor behavior

Remediation

1. Restore the unmodified documentation index shipped with the executing @pulse-compute/cli package.
2. The index must be a readable, nonempty UTF-8 file contained in the package documentation directory.

PULSE_NODE_VERSION_UNSUPPORTED — Node Version Unsupported

The active Node.js version is outside the supported release range.

• Category: toolchain
• CLI exit class: 5
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI doctor behavior

Remediation

1. Use a Node.js version matching ^22.14.0 || ^24.0.0 and rerun pulse doctor.

PULSE_FETCH_IMPLEMENTATION_UNAVAILABLE — Fetch Implementation Unavailable

No supported local fetch implementation is available for the requested operation.

• Category: toolchain
• CLI exit class: 5
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI doctor behavior

Remediation

1. Use a Node.js version matching ^22.14.0 || ^24.0.0, or disable live network fetch and configure deterministic fetch fixtures.

PULSE_CANONICAL_NATIVE_COMPILE_FAILED — Canonical Native Compile Failed

The provider-neutral native plan could not be compiled into Pulse-owned WebAssembly.

• Category: toolchain
• CLI exit class: 5
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI doctor behavior

Remediation

1. Restore the lockfile-pinned AssemblyScript dependency and rerun pulse doctor.
2. Retain the generated diagnostic detail if AssemblyScript rejects valid Pulse output.

PULSE_FASTLY_CLI_UNAVAILABLE — Fastly CLI Unavailable

The Fastly executable required for local target execution is unavailable.

• Category: toolchain
• CLI exit class: 5
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI doctor behavior

Remediation

1. Install the Fastly CLI with Homebrew, a supported package manager, or an official release.
2. Ensure fastly is on PATH, or set PULSE_FASTLY_BIN in CI.

PULSE_FASTLY_CLI_INSPECTION_FAILED — Fastly CLI Inspection Failed

Pulse could not inspect the installed Fastly CLI version.

• Category: toolchain
• CLI exit class: 5
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI doctor behavior

Remediation

1. Run fastly version directly and fix the Fastly CLI installation.

PULSE_VICEROY_UNAVAILABLE — Viceroy Unavailable

The explicitly selected Viceroy override is unavailable.

• Category: toolchain
• CLI exit class: 5
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI doctor behavior

Remediation

1. Unset PULSE_VICEROY_BIN to let the Fastly CLI manage its local Compute engine.
2. If an override is required, point PULSE_VICEROY_BIN at an executable Viceroy binary.

PULSE_VICEROY_INSPECTION_FAILED — Viceroy Inspection Failed

Pulse could not inspect the explicitly selected Viceroy override.

• Category: toolchain
• CLI exit class: 5
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI doctor behavior

Remediation

1. Inspect or replace the explicitly selected Viceroy override, or unset it to restore Fastly CLI ownership.

PULSE_FASTLY_SERVE_START_FAILED — Fastly Serve Start Failed

The Fastly local Compute service failed before becoming ready.

• Category: toolchain
• CLI exit class: 5
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI doctor behavior

Remediation

1. Run fastly compute serve directly in the generated package and inspect its output.

PULSE_FASTLY_SERVE_START_TIMEOUT — Fastly Serve Start Timeout

The Fastly local Compute service did not become ready before its startup timeout.

• Category: toolchain
• CLI exit class: 5
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: CLI doctor behavior

Remediation

1. Inspect Fastly CLI output and local port availability, then retry.

PULSE_FASTLY_REQUEST_TIMEOUT — Fastly Request Timeout

A request to the local Fastly Compute service exceeded its timeout.

• Category: toolchain
• CLI exit class: 5
• Development HTTP status: 504
• Stability/scope: preview-stable / public
• Related reference: CLI doctor behavior

Remediation

1. Inspect the local Fastly Compute service and backend fixture before retrying.

Schema diagnostics

Code	Meaning	CLI exit
PULSE_SCHEMA_COMPILE_FAILED	An explicitly declared JSON schema could not be compiled.	3
PULSE_SCHEMA_JSON_LIMITS_INVALID	A schema JSON admission policy contains an unknown limit or an invalid bounded integer.	3
PULSE_SCHEMA_JSON_LIMIT_LITERAL_REQUIRED	A schema JSON limit cannot be resolved from a static numeric literal.	3
PULSE_SCHEMA_JSON_DEPTH_UNSUPPORTED	A schema depth limit exceeds the Native parser capacity of 128 container levels.	3
PULSE_CANONICAL_SCHEMA_MISSING	The handler references a schema ID that is absent from project configuration.	3
PULSE_SCHEMA_JSON_DECLARATIONS_RETIRED	Legacy jsonSchemas declarations are no longer accepted as schema authority.	2
PULSE_SCHEMA_CODEC_REALIZATION_PENDING	The selected schema shape cannot be realized by every configured execution target.	3
PULSE_CANONICAL_SCHEMA_ID_LITERAL_REQUIRED	A schema operation uses a value that is not a static string literal ID.	3
PULSE_SCHEMA_ID_INVALID	A schema-bound operation received an invalid schema ID.	3
PULSE_SCHEMA_REQUIRED	Strict JSON operation omitted its required registered schema ID.	3
PULSE_SCHEMA_REFERENCE	A JSON operation references a schema absent from the compiled codec table.	3
PULSE_SCHEMA_CODECS_UNAVAILABLE	A schema-bound JSON operation has no compiled codec table.	3
PULSE_RESPONSE_CASE_MISSING	The handler references a response case absent from pulse.schema.	3
PULSE_RESPONSE_CASE_REFERENCE	A runtime JSON response references an unknown compiled response case.	3
PULSE_RESPONSE_DESCRIPTOR_INVALID	A runtime JSON response received an invalid descriptor.	3
PULSE_RESPONSE_DESCRIPTOR_LITERAL_REQUIRED	A JSON response descriptor cannot be resolved statically.	3
PULSE_SCHEMA_ID_DUPLICATE	Two or more configured schema declarations use the same stable ID.	3
PULSE_SCHEMA_SOURCE_REQUIRED	A schema declaration is missing its project-relative TypeScript source file.	3
PULSE_SCHEMA_TYPE_REQUIRED	A schema declaration is missing its exported TypeScript type name.	3

PULSE_SCHEMA_COMPILE_FAILED — Schema Compile Failed

An explicitly declared JSON schema could not be compiled.

• Category: schema
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project schema configuration

Remediation

1. Fix the declared schema source, exported type, or supported field shape.
2. Run pulse doctor --json to inspect schema diagnostics.

PULSE_SCHEMA_JSON_LIMITS_INVALID — Schema JSON Limits Invalid

A schema JSON admission policy contains an unknown limit or an invalid bounded integer.

• Category: schema
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project schema configuration

Remediation

1. Use only documented JSON limit names with positive safe-integer values.
2. Set maxDepth to at most 128 for a Native target.

PULSE_SCHEMA_JSON_LIMIT_LITERAL_REQUIRED — Schema JSON Limit Literal Required

A schema JSON limit cannot be resolved from a static numeric literal.

• Category: schema
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project schema configuration

Remediation

1. Write JSON limits as numeric literals inside schema({ json: { ... } }).
2. Remove computed values, spreads, and accessors from schema options.

PULSE_SCHEMA_JSON_DEPTH_UNSUPPORTED — Schema JSON Depth Unsupported

A schema depth limit exceeds the Native parser capacity of 128 container levels.

• Category: schema
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project schema configuration

Remediation

1. Set the schema maxDepth limit to at most 128 for Native compilation.
2. Pulse does not clamp limits or select another target automatically.

PULSE_CANONICAL_SCHEMA_MISSING — Canonical Schema Missing

The handler references a schema ID that is absent from project configuration.

• Category: schema
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project schema configuration

Remediation

1. Declare the referenced schema ID in the default-exported registry selected by pulse.schema.

PULSE_SCHEMA_JSON_DECLARATIONS_RETIRED — Schema JSON Declarations Retired

Legacy jsonSchemas declarations are no longer accepted as schema authority.

• Category: schema
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project schema configuration

Remediation

1. Move schema declarations into a default-exported defineSchemaRegistry(...) module.
2. Point pulse.schema at that workspace-relative module.

PULSE_SCHEMA_CODEC_REALIZATION_PENDING — Schema Codec Realization Pending

The selected schema shape cannot be realized by every configured execution target.

• Category: schema
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project schema configuration

Remediation

1. Rebuild from the authoritative pulse.schema registry with a compiler that realizes the declared shape on both targets.
2. Pulse will not fall back to generic JSON automatically.

PULSE_CANONICAL_SCHEMA_ID_LITERAL_REQUIRED — Canonical Schema Id Literal Required

A schema operation uses a value that is not a static string literal ID.

• Category: schema
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project schema configuration

Remediation

1. Use a static string literal for the schema ID.

PULSE_SCHEMA_ID_INVALID — Schema Id Invalid

A schema-bound operation received an invalid schema ID.

• Category: schema
• CLI exit class: 3
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Project schema configuration

Remediation

1. Use a non-empty schema ID declared by the authoritative pulse.schema registry.

PULSE_SCHEMA_REQUIRED — Schema Required

Strict JSON operation omitted its required registered schema ID.

• Category: schema
• CLI exit class: 3
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Project schema configuration

Remediation

1. Supply a statically declared schema ID at every strict JSON boundary.

PULSE_SCHEMA_REFERENCE — Schema Reference

A JSON operation references a schema absent from the compiled codec table.

• Category: schema
• CLI exit class: 3
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Project schema configuration

Remediation

1. Reference an ID declared by the authoritative pulse.schema registry.

PULSE_SCHEMA_CODECS_UNAVAILABLE — Schema Codecs Unavailable

A schema-bound JSON operation has no compiled codec table.

• Category: schema
• CLI exit class: 3
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Project schema configuration

Remediation

1. Rebuild or redeploy the application with its generated schema codec table.

PULSE_RESPONSE_CASE_MISSING — Response Case Missing

The handler references a response case absent from pulse.schema.

• Category: schema
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project schema configuration

Remediation

1. Declare the referenced response case in pulse.schema.

PULSE_RESPONSE_CASE_REFERENCE — Response Case Reference

A runtime JSON response references an unknown compiled response case.

• Category: schema
• CLI exit class: 3
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Project schema configuration

Remediation

1. Use a response-case ID declared by pulse.schema.

PULSE_RESPONSE_DESCRIPTOR_INVALID — Response Descriptor Invalid

A runtime JSON response received an invalid descriptor.

• Category: schema
• CLI exit class: 3
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Project schema configuration

Remediation

1. Pass an object descriptor or a registered response-case string to ctx.json.

PULSE_RESPONSE_DESCRIPTOR_LITERAL_REQUIRED — Response Descriptor Literal Required

A JSON response descriptor cannot be resolved statically.

• Category: schema
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project schema configuration

Remediation

1. Use an object literal or a registered response-case string literal as the ctx.json response descriptor.

PULSE_SCHEMA_ID_DUPLICATE — Schema Id Duplicate

Two or more configured schema declarations use the same stable ID.

• Category: schema
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project schema configuration

Remediation

1. Give every declared schema a unique stable ID.

PULSE_SCHEMA_SOURCE_REQUIRED — Schema Source Required

A schema declaration is missing its project-relative TypeScript source file.

• Category: schema
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project schema configuration

Remediation

1. Set the schema declaration source to a project-relative TypeScript file.

PULSE_SCHEMA_TYPE_REQUIRED — Schema Type Required

A schema declaration is missing its exported TypeScript type name.

• Category: schema
• CLI exit class: 3
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Project schema configuration

Remediation

1. Set the schema declaration type to an exported TypeScript type name.

Request diagnostics

Code	Meaning	CLI exit
PULSE_SCHEMA_CONTENT_TYPE	A schema-bound JSON input uses a content type rejected by policy.	4
PULSE_SCHEMA_JSON_MALFORMED	A schema-bound JSON input is not syntactically valid JSON.	4
PULSE_BODY_DECODE	A structured request body could not be decoded in the requested representation.	4
PULSE_REQUEST_BODY_INVALID_UTF8	Request bytes are not well-formed UTF-8; no repaired text is exposed to the application.	4
PULSE_SCHEMA_DECODE	JSON input did not satisfy the explicitly declared schema and content-type policy.	4
PULSE_BODY_TOO_LARGE	A structured body exceeded the configured bounded-body limit.	4
PULSE_REQUEST_DEADLINE_EXCEEDED	The provider-owned total request budget expired.	4
PULSE_REQUEST_CLOCK_INVALID	The provider monotonic request clock failed or regressed.	4
PULSE_REQUEST_BODY_OWNERSHIP	The incoming request body already belongs to another consumer.	4
PULSE_TRANSFORM_HEADERS_INVALID	The transform request has invalid Content-Length metadata.	4
PULSE_TRANSFORM_INPUT_LIMIT	Transform input exceeded its bounded byte limit.	4
PULSE_TRANSFORM_UTF8_INVALID	Transform input is not complete, well-formed UTF-8.	4
PULSE_REQUEST_FORWARDING_HEADERS_INVALID	Forwarding headers contain invalid length or transport-owned framing.	4
PULSE_REQUEST_BODY_TOO_LARGE	A request or forwarded body exceeded its configured byte limit.	4

PULSE_SCHEMA_CONTENT_TYPE — Schema Content Type

A schema-bound JSON input uses a content type rejected by policy.

• Category: request
• CLI exit class: 4
• Development HTTP status: 415
• Stability/scope: preview-stable / public
• Related reference: Body and schema troubleshooting

Remediation

1. Send a JSON content type accepted by the configured schema policy.

PULSE_SCHEMA_JSON_MALFORMED — Schema JSON Malformed

A schema-bound JSON input is not syntactically valid JSON.

• Category: request
• CLI exit class: 4
• Development HTTP status: 400
• Stability/scope: preview-stable / public
• Related reference: Body and schema troubleshooting

Remediation

1. Send syntactically valid JSON before schema validation.

PULSE_BODY_DECODE — Body Decode

A structured request body could not be decoded in the requested representation.

• Category: request
• CLI exit class: 4
• Development HTTP status: 400
• Stability/scope: preview-stable / public
• Related reference: Body and schema troubleshooting

Remediation

1. Send valid JSON or text matching the documented request shape.

PULSE_REQUEST_BODY_INVALID_UTF8 — Request Body Invalid Utf8

Request bytes are not well-formed UTF-8; no repaired text is exposed to the application.

• Category: request
• CLI exit class: 4
• Development HTTP status: 400
• Stability/scope: preview-stable / public
• Related reference: Body and schema troubleshooting

Remediation

1. Send well-formed UTF-8 request bytes; Pulse does not repair malformed input.

PULSE_SCHEMA_DECODE — Schema Decode

JSON input did not satisfy the explicitly declared schema and content-type policy.

• Category: request
• CLI exit class: 4
• Development HTTP status: 400
• Stability/scope: preview-stable / public
• Related reference: Body and schema troubleshooting

Remediation

1. Send JSON with the required content type and schema fields.
2. Use pulse test with a failing case to reproduce the validation error locally.

PULSE_BODY_TOO_LARGE — Body Too Large

A structured body exceeded the configured bounded-body limit.

• Category: request
• CLI exit class: 4
• Development HTTP status: 413
• Stability/scope: preview-stable / public
• Related reference: Body and schema troubleshooting

Remediation

1. Reduce the request payload or increase the configured structured-body limit deliberately.

PULSE_REQUEST_DEADLINE_EXCEEDED — Request Deadline Exceeded

The provider-owned total request budget expired.

• Category: request
• CLI exit class: 4
• Development HTTP status: 504
• Stability/scope: preview-stable / public
• Related reference: Body and schema troubleshooting

Remediation

1. Split the work into bounded invocations or deliberately adjust the provider maxDurationMs profile. A timeout does not prove rollback of dispatched writes.

PULSE_REQUEST_CLOCK_INVALID — Request Clock Invalid

The provider monotonic request clock failed or regressed.

• Category: request
• CLI exit class: 4
• Development HTTP status: 504
• Stability/scope: preview-stable / public
• Related reference: Body and schema troubleshooting

Remediation

1. Restore the provider monotonic clock before retrying. Reconcile any dispatched writes.

PULSE_REQUEST_BODY_OWNERSHIP — Request Body Ownership

The incoming request body already belongs to another consumer.

• Category: request
• CLI exit class: 4
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Body and schema troubleshooting

Remediation

1. Read or forward the incoming body once; never combine the two.

PULSE_TRANSFORM_HEADERS_INVALID — Transform Headers Invalid

The transform request has invalid Content-Length metadata.

• Category: request
• CLI exit class: 4
• Development HTTP status: 400
• Stability/scope: preview-stable / public
• Related reference: Body and schema troubleshooting

Remediation

1. Send a valid non-negative Content-Length or omit it for chunked input.

PULSE_TRANSFORM_INPUT_LIMIT — Transform Input Limit

Transform input exceeded its bounded byte limit.

• Category: request
• CLI exit class: 4
• Development HTTP status: 413
• Stability/scope: preview-stable / public
• Related reference: Body and schema troubleshooting

Remediation

1. Reduce transform input to at most 65536 UTF-8 bytes.

PULSE_TRANSFORM_UTF8_INVALID — Transform Utf8 Invalid

Transform input is not complete, well-formed UTF-8.

• Category: request
• CLI exit class: 4
• Development HTTP status: 400
• Stability/scope: preview-stable / public
• Related reference: Body and schema troubleshooting

Remediation

1. Send valid, complete UTF-8 text; use opaque forwarding for binary bodies.

PULSE_REQUEST_FORWARDING_HEADERS_INVALID — Request Forwarding Headers Invalid

Forwarding headers contain invalid length or transport-owned framing.

• Category: request
• CLI exit class: 4
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Body and schema troubleshooting

Remediation

1. Leave framing and hop-by-hop headers to the provider.

PULSE_REQUEST_BODY_TOO_LARGE — Request Body Too Large

A request or forwarded body exceeded its configured byte limit.

• Category: request
• CLI exit class: 4
• Development HTTP status: 413
• Stability/scope: preview-stable / public
• Related reference: Body and schema troubleshooting

Remediation

1. Reduce the payload or deliberately adjust dev.maxBodyBytes for buffered input, or node.bodyForwarding.maxBytes for forwarding.

Configuration diagnostics

Code	Meaning	CLI exit
PULSE_PACKAGE_BINDING_INVALID	A package runtime host binding is not a valid explicit grant.	2

PULSE_PACKAGE_BINDING_INVALID — Package Binding Invalid

A package runtime host binding is not a valid explicit grant.

• Category: configuration
• CLI exit class: 2
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Correct the explicit package runtime host grant: package, contract, artifact, operations, named secret, key identity, trust domain and HTTPS origin.

Config diagnostics

Code	Meaning	CLI exit
PULSE_TRANSFORM_CONFIG_INVALID	The Node UTF-8 transform configuration is invalid.	2
PULSE_REQUEST_FORWARDING_CONFIG_INVALID	Incoming forwarding configuration is invalid.	2

PULSE_TRANSFORM_CONFIG_INVALID — Transform Config Invalid

The Node UTF-8 transform configuration is invalid.

• Category: config
• CLI exit class: 2
• Development HTTP status: 500
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Enable bodyTransform together with generatedOutput and maxDurationMs (1–30000); remove bodyForwarding.

PULSE_REQUEST_FORWARDING_CONFIG_INVALID — Request Forwarding Config Invalid

Incoming forwarding configuration is invalid.

• Category: config
• CLI exit class: 2
• Development HTTP status: 500 fallback when surfaced by the development server
• Stability/scope: preview-stable / public
• Related reference: Troubleshooting

Remediation

1. Set node.bodyForwarding.maxBytes to a positive safe integer and node.maxDurationMs to 1–30000.