@alessandroraffa/tangyr 7.0.1 → 8.0.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.
- package/README.md +15 -15
- package/dist/index.js +1313 -1006
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -33,7 +33,7 @@ tangyr <command>
|
|
|
33
33
|
| `tangyr sync` | Synchronize installed kit to the latest version |
|
|
34
34
|
| `tangyr verify` | Check installation integrity against the manifest |
|
|
35
35
|
| `tangyr cleanup` | Remove managed artifacts; delegates to uninstall if manifest exists |
|
|
36
|
-
| `tangyr assess` | Pre-installation conflict analysis
|
|
36
|
+
| `tangyr assess` | Pre-installation conflict analysis: what is already there, and what `onConflict` will do to it |
|
|
37
37
|
| `tangyr list` | Display kits discovered in configured search paths and any installed manifests |
|
|
38
38
|
|
|
39
39
|
### Environment
|
|
@@ -403,20 +403,20 @@ predates the remote-source work and is shared by every command; codes
|
|
|
403
403
|
[Remote kit source](#remote-kit-source) above for the pipeline that
|
|
404
404
|
reaches them).
|
|
405
405
|
|
|
406
|
-
| Exit code | Meaning | Reached when
|
|
407
|
-
| --------- | ---------------------------------- |
|
|
408
|
-
| `0` | Success | The command completed with no fatal error. A `sync`/`install` whose loss report contains only `info`/`warning`-severity entries also exits `0`.
|
|
409
|
-
| `1` | General failure | The generic, catch-all failure code for any error not mapped to a more specific code below — including a CLI usage error such as an unrecognized command, a malformed `--kit <name>@<version>` reference, or `--offline` and `--refresh` passed together; an `install` or `sync` that would put a different kit over the one this scope holds also exits here rather than installing both (see `--replace`); a corrupt or legacy-format installation manifest (`ManifestCorruptError`, `ManifestLegacyError`, `src/core/manifest.ts`) also falls through to this code, since `handleFatalError` carries no dedicated branch for either. |
|
|
410
|
-
| `2` | Conflict | Reserved for a conflict-resolution failure (`ConflictError`, `src/core/exit.ts`); declared and routed by `handleFatalError`, but not thrown by any current production code path.
|
|
411
|
-
| `3` | Completed with error-severity loss | An `install`/`sync` run completes but its loss report contains at least one `error`-severity entry, distinct from the generic failure code `1`. `--ignore-errors` on `install`/`sync` forces a zero exit for authors who accept the loss.
|
|
412
|
-
| `4` | Target not detected | Reserved for a configured target tool whose runtime cannot be detected (`TargetNotDetectedError`, `src/core/exit.ts`); declared and routed the same way as exit `2`, and likewise not thrown by any current production code path.
|
|
413
|
-
| `5` | Authentication required | The resolved credential is missing, partially configured (see the credential-precedence trap above), or rejected by the origin (`401`/`403`) — at login, at a cold fetch, or at the post-freshness-window re-check.
|
|
414
|
-
| `6` | Remote unavailable | A transient fetch failure exhausts the bounded retry (3 attempts, 250 ms then 1000 ms backoff) with no warm cache to fall back to, or a warm-cache freshness re-check fails the same way with no usable fallback path.
|
|
415
|
-
| `7` | Integrity failure | The signed bundle fails signature verification (including an unknown or out-of-window signing-key identifier), identity binding, a per-file content-hash check, a size ceiling, or path sanitization; or the channel pointer for a versionless `--kit <name>` cannot be resolved, is not signed by a pinned key, or names a version older than the one already seen.
|
|
416
|
-
| `8` | Offline cache miss | `--offline` with no complete, valid cache entry for the requested reference.
|
|
417
|
-
| `9` | Incompatible version | The running CLI is older than the bundle's declared minimum-compatible version, or the origin rejects this CLI's contract version.
|
|
418
|
-
| `10` | Configuration missing | No `tangyr.config.yaml` is found (`ConfigNotFoundError`, `src/core/config.ts`) for a command that requires one.
|
|
419
|
-
| `130` | User interrupt | The process received `SIGINT` (Ctrl-C) during a command.
|
|
406
|
+
| Exit code | Meaning | Reached when |
|
|
407
|
+
| --------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
408
|
+
| `0` | Success | The command completed with no fatal error. A `sync`/`install` whose loss report contains only `info`/`warning`-severity entries also exits `0`. |
|
|
409
|
+
| `1` | General failure | The generic, catch-all failure code for any error not mapped to a more specific code below — including a CLI usage error such as an unrecognized command, a malformed `--kit <name>@<version>` reference, or `--offline` and `--refresh` passed together; an `install` or `sync` that would put a different kit over the one this scope holds also exits here rather than installing both (see `--replace`); an `install` that finds an instructions entrypoint Tangyr did not write — `AGENTS.md`, `CLAUDE.md`, `.opencode/AGENTS.md` or whichever file an enabled target reads — under `onConflict: ask` or `skip` refuses and writes nothing (`INSTALL_FOREIGN_INSTRUCTIONS` on stderr; `backup` and `overwrite` install as before, because under those the file arrives); a corrupt or legacy-format installation manifest (`ManifestCorruptError`, `ManifestLegacyError`, `src/core/manifest.ts`) also falls through to this code, since `handleFatalError` carries no dedicated branch for either. |
|
|
410
|
+
| `2` | Conflict | Reserved for a conflict-resolution failure (`ConflictError`, `src/core/exit.ts`); declared and routed by `handleFatalError`, but not thrown by any current production code path. |
|
|
411
|
+
| `3` | Completed with error-severity loss | An `install`/`sync` run completes but its loss report contains at least one `error`-severity entry, distinct from the generic failure code `1`. `--ignore-errors` on `install`/`sync` forces a zero exit for authors who accept the loss. |
|
|
412
|
+
| `4` | Target not detected | Reserved for a configured target tool whose runtime cannot be detected (`TargetNotDetectedError`, `src/core/exit.ts`); declared and routed the same way as exit `2`, and likewise not thrown by any current production code path. |
|
|
413
|
+
| `5` | Authentication required | The resolved credential is missing, partially configured (see the credential-precedence trap above), or rejected by the origin (`401`/`403`) — at login, at a cold fetch, or at the post-freshness-window re-check. |
|
|
414
|
+
| `6` | Remote unavailable | A transient fetch failure exhausts the bounded retry (3 attempts, 250 ms then 1000 ms backoff) with no warm cache to fall back to, or a warm-cache freshness re-check fails the same way with no usable fallback path. |
|
|
415
|
+
| `7` | Integrity failure | The signed bundle fails signature verification (including an unknown or out-of-window signing-key identifier), identity binding, a per-file content-hash check, a size ceiling, or path sanitization; or the channel pointer for a versionless `--kit <name>` cannot be resolved, is not signed by a pinned key, or names a version older than the one already seen. |
|
|
416
|
+
| `8` | Offline cache miss | `--offline` with no complete, valid cache entry for the requested reference. |
|
|
417
|
+
| `9` | Incompatible version | The running CLI is older than the bundle's declared minimum-compatible version, or the origin rejects this CLI's contract version. |
|
|
418
|
+
| `10` | Configuration missing | No `tangyr.config.yaml` is found (`ConfigNotFoundError`, `src/core/config.ts`) for a command that requires one. |
|
|
419
|
+
| `130` | User interrupt | The process received `SIGINT` (Ctrl-C) during a command. |
|
|
420
420
|
|
|
421
421
|
## Global flags
|
|
422
422
|
|