@sunerpy/kiro-provider 0.7.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +15 -0
  2. package/dist/cli.js +91 -90
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -23,6 +23,7 @@
23
23
  - [Use with Zuno](#use-with-zuno)
24
24
  - [Use with Codex CLI](#use-with-codex-cli)
25
25
  - [Use with Claude Code](#use-with-claude-code)
26
+ - [Troubleshooting](#troubleshooting)
26
27
  - [Development](#development)
27
28
  - [License](#license)
28
29
 
@@ -734,6 +735,20 @@ The preceding protocol/client matrix is retained in
734
735
  The older [`docs/E2E_VALIDATION_2026-08-22.md`](docs/E2E_VALIDATION_2026-08-22.md)
735
736
  is retained as historical v0.4 evidence only.
736
737
 
738
+ ## Troubleshooting
739
+
740
+ [`docs/TROUBLESHOOTING.md`](docs/TROUBLESHOOTING.md) is the symptom-first
741
+ runbook: for each symptom it names the audit event, the
742
+ `accounts list --details` availability value, or the HTTP status and
743
+ `error.code` to look at, then the cause and the remedy. It covers
744
+ `needs-relogin` and token-refresh failures, `quota-exhausted` versus
745
+ `overage-blocked` (`stop_on_overage`), `503 no_healthy_accounts`, the
746
+ `502 upstream_stream_*` codes with the pre-publication retry events, how to
747
+ read `sdk_stream_terminal` when "the assistant announced a next step and
748
+ stopped", reasoning-replay `400`s, the single-instance lock, configuration
749
+ warnings, `413` variants, and proxy failures. It also lists `journalctl` grep
750
+ recipes for the systemd service and the opt-in `request_shape` debug event.
751
+
737
752
  ## Development
738
753
 
739
754
  ```bash