@pulse-compute/cli 0.0.0 → 1.0.0-beta.1

package/completions/_pulse

@@ -0,0 +1,106 @@
+#compdef pulse
+# Generated from @pulse-compute/cli/src/command-spec.js.
+local -a commands
+commands=(
+    'init:Create a conventional .pulse workspace with an async Pulse application and dedicated test harness.'
+    'doctor:Audit project shape, compilation, schemas, provider bindings, output safety, and required tools.'
+    'inspect:Report canonical compiler, schema, effect, continuation, capability, provider, and build-mode details.'
+    'test:Run configured cases through the selected provider local-conformance runtime.'
+    'dev:Start the foreground local server with the selected provider conformance runtime.'
+    'compile:Compile the canonical project into provider-neutral Pulse-owned WebAssembly.'
+    'build:Compile the canonical project and realize the deployment provider selected by the active project profile.'
+    'completion:Print a generated shell completion script'
+    'help:Print public help'
+    'version:Print the installed CLI version'
+    '--help:Print public help'
+    '-h:Print public help'
+    '--version:Print the installed CLI version'
+    '-v:Print the installed CLI version'
+)
+
+if (( CURRENT == 2 )); then
+  _describe 'pulse command' commands
+  return
+fi
+
+case $words[2] in
+  completion)
+    _values 'shell' bash zsh fish
+    ;;
+    init)
+      _arguments -s       '--help[Print public CLI help and exit.]' \
+      '-h[Print public CLI help and exit.]' \
+      '--json[Emit machine-readable JSON. pulse dev emits one JSON event per line.]' \
+      '--dry-run[Resolve and report the command plan without executing it.]' \
+      '--plan[Resolve and report the command plan without executing it.]' \
+      '--force[Allow generated files to replace entries in a non-empty target directory.]' \
+      '--name[Set the generated npm package name.]:value:'
+      ;;
+    doctor)
+      _arguments -s       '--help[Print public CLI help and exit.]' \
+      '-h[Print public CLI help and exit.]' \
+      '--json[Emit machine-readable JSON. pulse dev emits one JSON event per line.]' \
+      '--dry-run[Resolve and report the command plan without executing it.]' \
+      '--plan[Resolve and report the command plan without executing it.]' \
+      '--strict[Treat doctor warnings as failed checks.]' \
+      '--profile[Select a project profile. Precedence: --profile, PULSE_PROFILE, pulse.defaultProfile.]:value:'
+      ;;
+    inspect)
+      _arguments -s       '--help[Print public CLI help and exit.]' \
+      '-h[Print public CLI help and exit.]' \
+      '--json[Emit machine-readable JSON. pulse dev emits one JSON event per line.]' \
+      '--dry-run[Resolve and report the command plan without executing it.]' \
+      '--plan[Resolve and report the command plan without executing it.]' \
+      '--profile[Select a project profile. Precedence: --profile, PULSE_PROFILE, pulse.defaultProfile.]:value:' \
+      '--artifact[Inspect an existing JSON build or compiler artifact instead of a project.]:file:_files'
+      ;;
+    test)
+      _arguments -s       '--help[Print public CLI help and exit.]' \
+      '-h[Print public CLI help and exit.]' \
+      '--json[Emit machine-readable JSON. pulse dev emits one JSON event per line.]' \
+      '--dry-run[Resolve and report the command plan without executing it.]' \
+      '--plan[Resolve and report the command plan without executing it.]' \
+      '--profile[Select a project profile. Precedence: --profile, PULSE_PROFILE, pulse.defaultProfile.]:value:' \
+      '--case[Run one named project test case.]:value:'
+      ;;
+    dev)
+      _arguments -s       '--help[Print public CLI help and exit.]' \
+      '-h[Print public CLI help and exit.]' \
+      '--json[Emit machine-readable JSON. pulse dev emits one JSON event per line.]' \
+      '--dry-run[Resolve and report the command plan without executing it.]' \
+      '--plan[Resolve and report the command plan without executing it.]' \
+      '--once[Close the development server after the first completed request.]' \
+      '--watch[Enable or disable entry and schema dependency watching. Watching is enabled by default.]' \
+      '--no-watch[Enable or disable entry and schema dependency watching. Watching is enabled by default.]' \
+      '--profile[Select a project profile. Precedence: --profile, PULSE_PROFILE, pulse.defaultProfile.]:value:' \
+      '--host[Override the development listen host.]:value:' \
+      '--port[Override the development listen port. Use 0 to request an ephemeral port.]:value:'
+      ;;
+    compile)
+      _arguments -s       '--help[Print public CLI help and exit.]' \
+      '-h[Print public CLI help and exit.]' \
+      '--json[Emit machine-readable JSON. pulse dev emits one JSON event per line.]' \
+      '--dry-run[Resolve and report the command plan without executing it.]' \
+      '--plan[Resolve and report the command plan without executing it.]' \
+      '--clean[Remove or preserve the selected output directory before writing artifacts. Cleaning is enabled by default.]' \
+      '--no-clean[Remove or preserve the selected output directory before writing artifacts. Cleaning is enabled by default.]' \
+      '--experimental-native-size[Experimentally optimize Native Wasm for size. JavaScript build targets reject this flag.]' \
+      '--profile[Select a project profile. Precedence: --profile, PULSE_PROFILE, pulse.defaultProfile.]:value:' \
+      '--out[Override the project-relative artifact output directory.]:directory:_directories'
+      ;;
+    build)
+      _arguments -s       '--help[Print public CLI help and exit.]' \
+      '-h[Print public CLI help and exit.]' \
+      '--json[Emit machine-readable JSON. pulse dev emits one JSON event per line.]' \
+      '--dry-run[Resolve and report the command plan without executing it.]' \
+      '--plan[Resolve and report the command plan without executing it.]' \
+      '--clean[Remove or preserve the selected output directory before writing artifacts. Cleaning is enabled by default.]' \
+      '--no-clean[Remove or preserve the selected output directory before writing artifacts. Cleaning is enabled by default.]' \
+      '--experimental-native-size[Experimentally optimize Native Wasm for size. JavaScript build targets reject this flag.]' \
+      '--profile[Select a project profile. Precedence: --profile, PULSE_PROFILE, pulse.defaultProfile.]:value:' \
+      '--out[Override the project-relative artifact output directory.]:directory:_directories'
+      ;;
+  *)
+    _describe 'pulse command' commands
+    ;;
+esac

package/completions/pulse.bash

@@ -0,0 +1,31 @@
+# Generated from @pulse-compute/cli/src/command-spec.js.
+# Install for the current shell with: source <(pulse completion bash)
+_pulse_completion() {
+  local cur command words
+  COMPREPLY=()
+  cur="${COMP_WORDS[COMP_CWORD]}"
+  command="${COMP_WORDS[1]}"
+
+  if (( COMP_CWORD == 1 )); then
+    COMPREPLY=( $(compgen -W "init doctor inspect test dev compile build completion help version --help -h --version -v" -- "$cur") )
+    return 0
+  fi
+
+  if [[ "$command" == "completion" ]]; then
+    COMPREPLY=( $(compgen -W "bash zsh fish" -- "$cur") )
+    return 0
+  fi
+
+  case "$command" in
+    init) words="--help -h --json --dry-run --plan --force --name" ;;
+    doctor) words="--help -h --json --dry-run --plan --strict --profile" ;;
+    inspect) words="--help -h --json --dry-run --plan --profile --artifact" ;;
+    test) words="--help -h --json --dry-run --plan --profile --case" ;;
+    dev) words="--help -h --json --dry-run --plan --once --watch --no-watch --profile --host --port" ;;
+    compile) words="--help -h --json --dry-run --plan --clean --no-clean --experimental-native-size --profile --out" ;;
+    build) words="--help -h --json --dry-run --plan --clean --no-clean --experimental-native-size --profile --out" ;;
+    *) words="init doctor inspect test dev compile build completion help version --help -h --version -v" ;;
+  esac
+  COMPREPLY=( $(compgen -W "$words" -- "$cur") )
+}
+complete -F _pulse_completion pulse

package/completions/pulse.fish

@@ -0,0 +1,76 @@
+# Generated from @pulse-compute/cli/src/command-spec.js.
+# Install for the current shell with: pulse completion fish | source
+complete -c pulse -f
+complete -c pulse -n '__fish_use_subcommand' -a 'init' -d 'Create a conventional .pulse workspace with an async Pulse application and dedicated test harness.'
+complete -c pulse -n '__fish_use_subcommand' -a 'doctor' -d 'Audit project shape, compilation, schemas, provider bindings, output safety, and required tools.'
+complete -c pulse -n '__fish_use_subcommand' -a 'inspect' -d 'Report canonical compiler, schema, effect, continuation, capability, provider, and build-mode details.'
+complete -c pulse -n '__fish_use_subcommand' -a 'test' -d 'Run configured cases through the selected provider local-conformance runtime.'
+complete -c pulse -n '__fish_use_subcommand' -a 'dev' -d 'Start the foreground local server with the selected provider conformance runtime.'
+complete -c pulse -n '__fish_use_subcommand' -a 'compile' -d 'Compile the canonical project into provider-neutral Pulse-owned WebAssembly.'
+complete -c pulse -n '__fish_use_subcommand' -a 'build' -d 'Compile the canonical project and realize the deployment provider selected by the active project profile.'
+complete -c pulse -n '__fish_use_subcommand' -a 'completion' -d 'Print a generated shell completion script'
+complete -c pulse -n '__fish_seen_subcommand_from completion' -a 'bash zsh fish'
+complete -c pulse -n '__fish_use_subcommand' -a 'help version'
+complete -c pulse -n '__fish_use_subcommand' -l help -d 'Print public help'
+complete -c pulse -n '__fish_use_subcommand' -s h -d 'Print public help'
+complete -c pulse -n '__fish_use_subcommand' -l version -d 'Print the installed CLI version'
+complete -c pulse -n '__fish_use_subcommand' -s v -d 'Print the installed CLI version'
+complete -c pulse -n '__fish_seen_subcommand_from init' -l help -d 'Print public CLI help and exit.'
+complete -c pulse -n '__fish_seen_subcommand_from init' -s h -d 'Print public CLI help and exit.'
+complete -c pulse -n '__fish_seen_subcommand_from init' -l json -d 'Emit machine-readable JSON. pulse dev emits one JSON event per line.'
+complete -c pulse -n '__fish_seen_subcommand_from init' -l dry-run -d 'Resolve and report the command plan without executing it.'
+complete -c pulse -n '__fish_seen_subcommand_from init' -l plan -d 'Resolve and report the command plan without executing it.'
+complete -c pulse -n '__fish_seen_subcommand_from init' -l force -d 'Allow generated files to replace entries in a non-empty target directory.'
+complete -c pulse -n '__fish_seen_subcommand_from init' -l name -r -d 'Set the generated npm package name.'
+complete -c pulse -n '__fish_seen_subcommand_from doctor' -l help -d 'Print public CLI help and exit.'
+complete -c pulse -n '__fish_seen_subcommand_from doctor' -s h -d 'Print public CLI help and exit.'
+complete -c pulse -n '__fish_seen_subcommand_from doctor' -l json -d 'Emit machine-readable JSON. pulse dev emits one JSON event per line.'
+complete -c pulse -n '__fish_seen_subcommand_from doctor' -l dry-run -d 'Resolve and report the command plan without executing it.'
+complete -c pulse -n '__fish_seen_subcommand_from doctor' -l plan -d 'Resolve and report the command plan without executing it.'
+complete -c pulse -n '__fish_seen_subcommand_from doctor' -l strict -d 'Treat doctor warnings as failed checks.'
+complete -c pulse -n '__fish_seen_subcommand_from doctor' -l profile -r -d 'Select a project profile. Precedence: --profile, PULSE_PROFILE, pulse.defaultProfile.'
+complete -c pulse -n '__fish_seen_subcommand_from inspect' -l help -d 'Print public CLI help and exit.'
+complete -c pulse -n '__fish_seen_subcommand_from inspect' -s h -d 'Print public CLI help and exit.'
+complete -c pulse -n '__fish_seen_subcommand_from inspect' -l json -d 'Emit machine-readable JSON. pulse dev emits one JSON event per line.'
+complete -c pulse -n '__fish_seen_subcommand_from inspect' -l dry-run -d 'Resolve and report the command plan without executing it.'
+complete -c pulse -n '__fish_seen_subcommand_from inspect' -l plan -d 'Resolve and report the command plan without executing it.'
+complete -c pulse -n '__fish_seen_subcommand_from inspect' -l profile -r -d 'Select a project profile. Precedence: --profile, PULSE_PROFILE, pulse.defaultProfile.'
+complete -c pulse -n '__fish_seen_subcommand_from inspect' -l artifact -r -d 'Inspect an existing JSON build or compiler artifact instead of a project.'
+complete -c pulse -n '__fish_seen_subcommand_from test' -l help -d 'Print public CLI help and exit.'
+complete -c pulse -n '__fish_seen_subcommand_from test' -s h -d 'Print public CLI help and exit.'
+complete -c pulse -n '__fish_seen_subcommand_from test' -l json -d 'Emit machine-readable JSON. pulse dev emits one JSON event per line.'
+complete -c pulse -n '__fish_seen_subcommand_from test' -l dry-run -d 'Resolve and report the command plan without executing it.'
+complete -c pulse -n '__fish_seen_subcommand_from test' -l plan -d 'Resolve and report the command plan without executing it.'
+complete -c pulse -n '__fish_seen_subcommand_from test' -l profile -r -d 'Select a project profile. Precedence: --profile, PULSE_PROFILE, pulse.defaultProfile.'
+complete -c pulse -n '__fish_seen_subcommand_from test' -l case -r -d 'Run one named project test case.'
+complete -c pulse -n '__fish_seen_subcommand_from dev' -l help -d 'Print public CLI help and exit.'
+complete -c pulse -n '__fish_seen_subcommand_from dev' -s h -d 'Print public CLI help and exit.'
+complete -c pulse -n '__fish_seen_subcommand_from dev' -l json -d 'Emit machine-readable JSON. pulse dev emits one JSON event per line.'
+complete -c pulse -n '__fish_seen_subcommand_from dev' -l dry-run -d 'Resolve and report the command plan without executing it.'
+complete -c pulse -n '__fish_seen_subcommand_from dev' -l plan -d 'Resolve and report the command plan without executing it.'
+complete -c pulse -n '__fish_seen_subcommand_from dev' -l once -d 'Close the development server after the first completed request.'
+complete -c pulse -n '__fish_seen_subcommand_from dev' -l watch -d 'Enable or disable entry and schema dependency watching. Watching is enabled by default.'
+complete -c pulse -n '__fish_seen_subcommand_from dev' -l no-watch -d 'Enable or disable entry and schema dependency watching. Watching is enabled by default.'
+complete -c pulse -n '__fish_seen_subcommand_from dev' -l profile -r -d 'Select a project profile. Precedence: --profile, PULSE_PROFILE, pulse.defaultProfile.'
+complete -c pulse -n '__fish_seen_subcommand_from dev' -l host -r -d 'Override the development listen host.'
+complete -c pulse -n '__fish_seen_subcommand_from dev' -l port -r -d 'Override the development listen port. Use 0 to request an ephemeral port.'
+complete -c pulse -n '__fish_seen_subcommand_from compile' -l help -d 'Print public CLI help and exit.'
+complete -c pulse -n '__fish_seen_subcommand_from compile' -s h -d 'Print public CLI help and exit.'
+complete -c pulse -n '__fish_seen_subcommand_from compile' -l json -d 'Emit machine-readable JSON. pulse dev emits one JSON event per line.'
+complete -c pulse -n '__fish_seen_subcommand_from compile' -l dry-run -d 'Resolve and report the command plan without executing it.'
+complete -c pulse -n '__fish_seen_subcommand_from compile' -l plan -d 'Resolve and report the command plan without executing it.'
+complete -c pulse -n '__fish_seen_subcommand_from compile' -l clean -d 'Remove or preserve the selected output directory before writing artifacts. Cleaning is enabled by default.'
+complete -c pulse -n '__fish_seen_subcommand_from compile' -l no-clean -d 'Remove or preserve the selected output directory before writing artifacts. Cleaning is enabled by default.'
+complete -c pulse -n '__fish_seen_subcommand_from compile' -l experimental-native-size -d 'Experimentally optimize Native Wasm for size. JavaScript build targets reject this flag.'
+complete -c pulse -n '__fish_seen_subcommand_from compile' -l profile -r -d 'Select a project profile. Precedence: --profile, PULSE_PROFILE, pulse.defaultProfile.'
+complete -c pulse -n '__fish_seen_subcommand_from compile' -l out -r -d 'Override the project-relative artifact output directory.'
+complete -c pulse -n '__fish_seen_subcommand_from build' -l help -d 'Print public CLI help and exit.'
+complete -c pulse -n '__fish_seen_subcommand_from build' -s h -d 'Print public CLI help and exit.'
+complete -c pulse -n '__fish_seen_subcommand_from build' -l json -d 'Emit machine-readable JSON. pulse dev emits one JSON event per line.'
+complete -c pulse -n '__fish_seen_subcommand_from build' -l dry-run -d 'Resolve and report the command plan without executing it.'
+complete -c pulse -n '__fish_seen_subcommand_from build' -l plan -d 'Resolve and report the command plan without executing it.'
+complete -c pulse -n '__fish_seen_subcommand_from build' -l clean -d 'Remove or preserve the selected output directory before writing artifacts. Cleaning is enabled by default.'
+complete -c pulse -n '__fish_seen_subcommand_from build' -l no-clean -d 'Remove or preserve the selected output directory before writing artifacts. Cleaning is enabled by default.'
+complete -c pulse -n '__fish_seen_subcommand_from build' -l experimental-native-size -d 'Experimentally optimize Native Wasm for size. JavaScript build targets reject this flag.'
+complete -c pulse -n '__fish_seen_subcommand_from build' -l profile -r -d 'Select a project profile. Precedence: --profile, PULSE_PROFILE, pulse.defaultProfile.'
+complete -c pulse -n '__fish_seen_subcommand_from build' -l out -r -d 'Override the project-relative artifact output directory.'

package/docs/README.md

@@ -0,0 +1,77 @@
+# Pulse documentation
+
+Pulse documentation is organized in layers so you can stop when you have enough detail. The `1.0.0-beta.1` candidate uses async-shaped managed handlers, trusted Pulse effects, a conventional `.pulse/config.ts` workspace, and the `pulse` CLI. The synchronized 18-package release catalog remains the authority for npm availability and support tiers.
+
+## 1. Start and ship a first project
+
+1. [Getting started](./getting-started.md) — install and create a first project.
+2. [Project lifecycle](./guides/project-lifecycle.md) — the normal `init → doctor → test → dev → build` journey and the advanced `inspect`/`compile` branches.
+3. [Beta scope](./preview-scope.md) — what the release guarantees and deliberately excludes.
+4. [Canonical examples](./examples.md) — nine source-bound projects,
+   including focused Entities, events, and MCP proxy shapes.
+
+## 2. Follow a task-oriented guide
+
+- [Migrate an Express service](./guides/migrating-from-express.md)
+- [Fetching and composing data](./guides/fetching-and-composition.md)
+- [Explicit JSON schemas](./guides/json-schemas.md)
+- [Static events and outbound emission](./guides/events.md)
+- [Fastly config, secrets, and KV](./guides/fastly-capabilities.md)
+- [GRIP and Fanout](./guides/grip.md)
+- [Compatibility imports and migration](./guides/compatibility-imports.md)
+- [Static Router authoring](./guides/routing.md)
+- [Node build and execution](./guides/deploying-node.md)
+- [Fastly deployment candidates](./guides/deploying-fastly.md)
+- [Troubleshooting](./guides/troubleshooting.md)
+
+## 3. Understand the model
+
+- [Compilation and lowering](./concepts/compilation-and-lowering.md)
+- [Effects and continuations](./concepts/effects-and-continuations.md)
+- [Structured and opaque bodies](./concepts/bodies.md)
+- [Contracts and providers](./concepts/contracts-and-providers.md)
+- [Targets and host work](./concepts/targets-and-hosts.md)
+- [Package-owned lowering](./concepts/package-owned-lowering.md)
+- [Entity engine, adapters, and facades](./concepts/entities-and-adapters.md)
+- [Architecture overview](./architecture/overview.md)
+- [Current architecture contracts](./architecture/current-contracts.md)
+- [Architecture vision](./architecture/vision.md)
+
+## 4. Use a package directly
+
+- [`@pulse-compute/pulse`](./packages/pulse.md)
+- [`@pulse-compute/runtime`](./packages/runtime.md)
+- [`@pulse-compute/cli`](./packages/cli.md)
+- [`@pulse-compute/provider-fastly`](./packages/provider-fastly.md)
+- [`@pulse-compute/grip`](./packages/grip.md)
+- [`@pulse-compute/assets`](./packages/assets.md)
+- [`@pulse-compute/crypto`](./packages/crypto.md)
+- [`@pulse-compute/jwt`](./packages/jwt.md)
+- [`@pulse-compute/entities`](./packages/entities.md)
+- [All package support tiers](./packages/README.md)
+- [Implementation packages](./packages/implementation-packages.md)
+
+## 5. Look up exact behavior
+
+- [Reference overview](./reference/README.md)
+- [Canonical API](../API.md)
+- [Provider and target compatibility](./reference/compatibility-matrix.md)
+- [Managed handler TypeScript and JavaScript](./reference/handler-authoring.md)
+- [CLI](./reference/cli.md)
+- [Project configuration](./reference/project-config.md)
+- [Diagnostics and remediation](./reference/diagnostics.md)
+- [Environment variables](./reference/environment.md)
+- [Shell completion](./reference/shell-completion.md)
+- [CLI machine specification](./reference/cli-spec.json)
+- [Project configuration JSON Schema bundle](./reference/project-config.schema.json)
+
+## 6. Authors and contributors
+
+- [Pulse-aware package authoring](./contributing/pulse-aware-packages.md)
+- [Contributor guide index](./contributing/README.md)
+- [Package-owned lowerer contract](./contributing/package-lowerer-contract.md)
+- [Add a first-party package-owned lowerer](./contributing/adding-first-party-lowerer.md)
+- [Entities lowering maintainer reference](./contributing/entities-lowering.md)
+- [Add a core provider](./contributing/adding-core-provider.md)
+- [Changelog](../CHANGELOG.md)
+- [Package support and extension boundaries](./packages/README.md)