@alessandroraffa/tangyr 7.0.0 → 7.0.1
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 -14
- package/dist/index.js +9 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -65,6 +65,7 @@ Options declared on individual commands in addition to the [global flags](#globa
|
|
|
65
65
|
| `install`, `sync` | `--kit <name>` | Kit to install/synchronize: `<name>` for a local source, `<name>@<version>` for a remote one |
|
|
66
66
|
| `install`, `uninstall`, `assess` | `--tools <list>` | Comma-separated list of target tools |
|
|
67
67
|
| `sync`, `status`, `verify`, `doctor`, `cleanup`, `probe` | `--target <tool>` | Limit the command to a single target |
|
|
68
|
+
| `probe` | `--scope <scope>` | Which scope's slots to probe. Declared on every scope-aware command; `probe` read one without offering the flag until 7.0.0 |
|
|
68
69
|
| `sync` | `--component <name>` | Limit sync to one component type: `instructions`, `agents`, `skills`, `commands`, `rules`, `hooks`, `mcp`, `settings`, `output-styles`, `lsp` |
|
|
69
70
|
| `sync` | `--force` | Rewrite managed artifacts even when provenance matches |
|
|
70
71
|
| `doctor` | `--fix` | Apply safe automated fixes |
|
|
@@ -402,20 +403,20 @@ predates the remote-source work and is shared by every command; codes
|
|
|
402
403
|
[Remote kit source](#remote-kit-source) above for the pipeline that
|
|
403
404
|
reaches them).
|
|
404
405
|
|
|
405
|
-
| Exit code | Meaning | Reached when
|
|
406
|
-
| --------- | ---------------------------------- |
|
|
407
|
-
| `0` | Success | The command completed with no fatal error. A `sync`/`install` whose loss report contains only `info`/`warning`-severity entries also exits `0`.
|
|
408
|
-
| `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; 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. |
|
|
409
|
-
| `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.
|
|
410
|
-
| `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.
|
|
411
|
-
| `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.
|
|
412
|
-
| `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.
|
|
413
|
-
| `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.
|
|
414
|
-
| `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.
|
|
415
|
-
| `8` | Offline cache miss | `--offline` with no complete, valid cache entry for the requested reference.
|
|
416
|
-
| `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.
|
|
417
|
-
| `10` | Configuration missing | No `tangyr.config.yaml` is found (`ConfigNotFoundError`, `src/core/config.ts`) for a command that requires one.
|
|
418
|
-
| `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`); 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. |
|
|
419
420
|
|
|
420
421
|
## Global flags
|
|
421
422
|
|
package/dist/index.js
CHANGED
|
@@ -36873,7 +36873,10 @@ function buildProgram() {
|
|
|
36873
36873
|
).option(
|
|
36874
36874
|
"--json",
|
|
36875
36875
|
`Emit {"degraded": true} on stderr only when this resolution fell back to a warm cache after a network failure; otherwise this flag has no effect and output is unchanged \u2014 unlike --json on other commands, which always replaces the command's entire output.`
|
|
36876
|
-
).option("--tools <list>", "Comma-separated list of target tools").option(
|
|
36876
|
+
).option("--tools <list>", "Comma-separated list of target tools").option(
|
|
36877
|
+
"--loss-report <path>",
|
|
36878
|
+
"Write an extra copy of this run's semantic loss report to <path>. The report itself is written to <scope>/loss.json by every install and sync regardless"
|
|
36879
|
+
).option(
|
|
36877
36880
|
"--replace",
|
|
36878
36881
|
"Install this kit over a different one already in this scope, uninstalling that one first"
|
|
36879
36882
|
).option("--scope <scope>", "Installation scope: global or project").option(
|
|
@@ -36932,7 +36935,10 @@ function buildProgram() {
|
|
|
36932
36935
|
).option(
|
|
36933
36936
|
"--json",
|
|
36934
36937
|
`Emit {"degraded": true} on stderr only when this resolution fell back to a warm cache after a network failure; otherwise this flag has no effect and output is unchanged \u2014 unlike --json on other commands, which always replaces the command's entire output.`
|
|
36935
|
-
).option("--target <tool>", "Limit sync to a single target").option("--component <name>", "Limit sync to a single component type").option("--force", "Rewrite managed artifacts even when provenance matches").option(
|
|
36938
|
+
).option("--target <tool>", "Limit sync to a single target").option("--component <name>", "Limit sync to a single component type").option("--force", "Rewrite managed artifacts even when provenance matches").option(
|
|
36939
|
+
"--loss-report <path>",
|
|
36940
|
+
"Write an extra copy of this run's semantic loss report to <path>. The report itself is written to <scope>/loss.json by every install and sync regardless"
|
|
36941
|
+
).option("--scope <scope>", "Installation scope: global or project").option(
|
|
36936
36942
|
"--ignore-errors",
|
|
36937
36943
|
"Suppress exit code 3 when error-severity loss entries are present"
|
|
36938
36944
|
).action(
|
|
@@ -37021,7 +37027,7 @@ function buildProgram() {
|
|
|
37021
37027
|
context.logger
|
|
37022
37028
|
);
|
|
37023
37029
|
});
|
|
37024
|
-
program2.command("probe").description("Probe configured platform paths").option("--target <tool>", "Limit probing to a single target").option("--json", "Emit JSON output").action((options) => {
|
|
37030
|
+
program2.command("probe").description("Probe configured platform paths").option("--target <tool>", "Limit probing to a single target").option("--scope <scope>", "Installation scope: global or project").option("--json", "Emit JSON output").action((options) => {
|
|
37025
37031
|
const context = commandContext(program2);
|
|
37026
37032
|
runProbeCommand({ ...context.options, ...options }, context.logger);
|
|
37027
37033
|
});
|