Diagnostics and remediation

Pulse 1.0.0-beta.9 treats the 156 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.9/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.

JSON failure envelope

{
  "status": "error",
  "version": "1.0.0-beta.9",
  "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.9/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_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.9/reference/diagnostics/#pulse-schema-decode"
      }
    }
  ]
}

Complete public catalog

Report diagnostics

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: Troubleshooting

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: Troubleshooting

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: Troubleshooting

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: Troubleshooting

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: Troubleshooting

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: Troubleshooting

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: Troubleshooting

Remediation

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

Usage diagnostics

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

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

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

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. Select a native profile for build, test, or dev.
2. Use inspect or doctor to retain the JavaScript selection without fallback.

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

The experimental Native size optimizer 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 --experimental-native-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

[object Object]

• 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.

Compile diagnostics

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_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.

Internal diagnostics

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

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

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_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

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

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

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

[object Object]

• 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

[object Object]

• 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

[object Object]

• 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.

Runtime diagnostics

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

[object Object]

• 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

[object Object]

• 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

[object Object]

• 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

[object Object]

• 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

[object Object]

• 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.

Configuration diagnostics

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

PULSE_TRANSFORM_CONFIG_INVALID — Transform Config Invalid

[object Object]

• 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.