@intentic/gate 1.224.0 → 1.225.0

package/README.md

@@ -1,12 +1,12 @@
 # @intentic/gate
 
-The one-line CI step for a release gate — POSTs what the pipeline knows to a gated workflow's webhook, waits for the run, and exits on the verdict.
+The one-line CI step for a release gate: POSTs what the pipeline knows to a gated workflow's webhook, waits for the run, and exits on the verdict.
 
 ## Responsibilities
 
 A gated workflow (see `_sandbox/sandbox`, gate.routes.ts) already answers a bare `curl`: POST the request, hold
 the connection, read `{outcome, reason, runId}` back. What every team then writes around that curl is the same
-six lines of shell — map `pass`/`fail`/`blocked` to exit codes, print the reason where the log will show it,
+six lines of shell: map `pass`/`fail`/`blocked` to exit codes, print the reason where the log will show it,
 keep the client's timeout longer than the server's hold. This package is those six lines, written once:
 
 ```sh
@@ -14,19 +14,19 @@ npx @intentic/gate "commit $SHA on $BRANCH — preview at $URL"
 ```
 
 - `pass` exits 0, `fail` exits 1.
-- `blocked` — the gate could not judge — exits 0 by default, because "the check broke" must not read as "the
+- `blocked` (the gate could not judge) exits 0 by default, because "the check broke" must not read as "the
   product broke". `--blocked <code>` points it at a real neutral where the CI system has one.
 - Exit 2 is never a verdict: it means the exchange itself failed (wrong token, no such gate, the daily run
   ceiling, network), which needs the pipeline's owner rather than the product's.
 
-The URL (token and all) comes from `--url` or the `INTENTIC_GATE_URL` environment variable — the shape every
+The URL (token and all) comes from `--url` or the `INTENTIC_GATE_URL` environment variable: the shape every
 CI secret store hands things over in. The request is the arguments joined, or stdin when none are given. The
 `--wait` deadline (default 1800 s) rides to the server, and the HTTP client waits a minute longer, so the
-deadline that fires is the server's — which stops the run instead of abandoning it mid-spend.
+deadline that fires is the server's: which stops the run instead of abandoning it mid-spend.
 
 ## Pipeline templates
 
-GitHub Actions has a step of its own — the Marketplace action (`_sandbox/gate-action`), which wraps this
+GitHub Actions has a step of its own: the Marketplace action (`_sandbox/gate-action`), which wraps this
 package's exchange and composes the request from the workflow's context:
 
 ```yaml
@@ -36,7 +36,7 @@ package's exchange and composes the request from the workflow's context:
     url: ${{ secrets.INTENTIC_GATE_URL }}
 ```
 
-GitLab CI — `allow_failure: exit_codes` is a real neutral, so `blocked` can have its own colour:
+GitLab CI, `allow_failure: exit_codes` is a real neutral, so `blocked` can have its own colour:
 
 ```yaml
 release-gate:
@@ -52,13 +52,13 @@ release-gate:
 The gate route is the daemon's door for a caller with no identity; the designer's gate panel (the workflows
 extension) is where a gate is declared and its URL copied. This package is the third leg: the caller's side of
 the exchange, distributed on npm so a pipeline runs it cold with `npx`. On GitHub specifically the same
-exchange wears Marketplace clothes — `@intentic/gate-action` bundles this package's pure functions into the
-`intentic/gate-action` action — and every other CI system runs this CLI. It deliberately depends on nothing —
-every dependency would be install time on every pipeline of every team — and its hand-rolled verdict reader is
+exchange wears Marketplace clothes: `@intentic/gate-action` bundles this package's pure functions into the
+`intentic/gate-action` action: and every other CI system runs this CLI. It deliberately depends on nothing:
+every dependency would be install time on every pipeline of every team: and its hand-rolled verdict reader is
 held against `@intentic/sandbox-contract`'s schema by a test instead of by an import.
 
 ## Key files
 
-- [src/gate.ts](src/gate.ts) — everything the CLI decides, as pure functions: argument parsing, the dialled URL, the verdict reader, the exit mapping.
-- [src/cli.ts](src/cli.ts) — the process around them: stdin, one fetch, stdout, an exit code.
-- [src/gate.test.ts](src/gate.test.ts) — the behaviour a pipeline relies on, including the reader-versus-contract agreement test.
+- [src/gate.ts](src/gate.ts), everything the CLI decides, as pure functions: argument parsing, the dialled URL, the verdict reader, the exit mapping.
+- [src/cli.ts](src/cli.ts), the process around them: stdin, one fetch, stdout, an exit code.
+- [src/gate.test.ts](src/gate.test.ts): the behaviour a pipeline relies on, including the reader-versus-contract agreement test.

package/dist/gate.d.ts

@@ -20,7 +20,7 @@ export type Parsed = {
     message: string;
 };
 export declare const WAIT_DEFAULT_S = 1800;
-export declare const USAGE = "intentic-gate \u2014 run an intentic release gate and exit on its verdict\n\nusage: intentic-gate [options] [request...]\n\nThe request \u2014 what this pipeline knows: commit, branch, preview URL \u2014 is the arguments joined,\nor stdin when none are given (so `git log -1 | intentic-gate` works).\n\noptions:\n  --url <url>       the gate's webhook URL, token and all (or env INTENTIC_GATE_URL)\n  --wait <seconds>  how long the gate holds the connection (default 1800; the server caps at 3h)\n  --blocked <code>  exit code for a blocked verdict (default 0 \u2014 \"could not judge\" is not a failed build)\n  -h, --help        this text\n\nexit codes:  0 pass (and blocked, unless --blocked says otherwise) \u00B7 1 fail \u00B7 2 the exchange itself\nfailed \u2014 wrong token, no such gate, daily ceiling reached, network. 2 is never a verdict: it means\nthe pipeline's wiring needs a person, not that the product does.";
+export declare const USAGE = "intentic-gate: run an intentic release gate and exit on its verdict\n\nusage: intentic-gate [options] [request...]\n\nThe request, what this pipeline knows: commit, branch, preview URL, is the arguments joined,\nor stdin when none are given (so `git log -1 | intentic-gate` works).\n\noptions:\n  --url <url>       the gate's webhook URL, token and all (or env INTENTIC_GATE_URL)\n  --wait <seconds>  how long the gate holds the connection (default 1800; the server caps at 3h)\n  --blocked <code>  exit code for a blocked verdict (default 0: \"could not judge\" is not a failed build)\n  -h, --help        this text\n\nexit codes:  0 pass (and blocked, unless --blocked says otherwise) \u00B7 1 fail \u00B7 2 the exchange itself\nfailed, wrong token, no such gate, daily ceiling reached, network. 2 is never a verdict: it means\nthe pipeline's wiring needs a person, not that the product does.";
 export declare const parseArgs: (argv: readonly string[], envUrl: string | undefined) => Parsed;
 export declare const targetOf: (url: string, waitS: number) => string;
 export declare const clientTimeoutMs: (waitS: number) => number;

package/dist/gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../src/gate.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAIvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAG7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9G,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,eAAO,MAAM,KAAK,i6BAe+C,CAAC;AAElE,eAAO,MAAM,SAAS,SAAU,SAAS,MAAM,EAAE,UAAU,MAAM,GAAG,SAAS,KAAG,MAwC/E,CAAC;AAIF,eAAO,MAAM,QAAQ,QAAS,MAAM,SAAS,MAAM,KAAG,MAIrD,CAAC;AAIF,eAAO,MAAM,eAAe,UAAW,MAAM,KAAG,MAA8B,CAAC;AAM/E,eAAO,MAAM,WAAW,SAAU,OAAO,KAAG,WAAW,GAAG,SAczD,CAAC;AAEF,eAAO,MAAM,MAAM,YAAa,WAAW,eAAe,MAAM,KAAG,MAKlE,CAAC"}
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../src/gate.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAIvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAG7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9G,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,eAAO,MAAM,KAAK,m4BAe+C,CAAC;AAElE,eAAO,MAAM,SAAS,SAAU,SAAS,MAAM,EAAE,UAAU,MAAM,GAAG,SAAS,KAAG,MAwC/E,CAAC;AAIF,eAAO,MAAM,QAAQ,QAAS,MAAM,SAAS,MAAM,KAAG,MAIrD,CAAC;AAIF,eAAO,MAAM,eAAe,UAAW,MAAM,KAAG,MAA8B,CAAC;AAM/E,eAAO,MAAM,WAAW,SAAU,OAAO,KAAG,WAAW,GAAG,SAczD,CAAC;AAEF,eAAO,MAAM,MAAM,YAAa,WAAW,eAAe,MAAM,KAAG,MAKlE,CAAC"}

package/dist/gate.js

@@ -1,19 +1,19 @@
 export const WAIT_DEFAULT_S = 1800;
-export const USAGE = `intentic-gate — run an intentic release gate and exit on its verdict
+export const USAGE = `intentic-gate: run an intentic release gate and exit on its verdict
 
 usage: intentic-gate [options] [request...]
 
-The request — what this pipeline knows: commit, branch, preview URL — is the arguments joined,
+The request, what this pipeline knows: commit, branch, preview URL, is the arguments joined,
 or stdin when none are given (so \`git log -1 | intentic-gate\` works).
 
 options:
   --url <url>       the gate's webhook URL, token and all (or env INTENTIC_GATE_URL)
   --wait <seconds>  how long the gate holds the connection (default ${WAIT_DEFAULT_S}; the server caps at 3h)
-  --blocked <code>  exit code for a blocked verdict (default 0 — "could not judge" is not a failed build)
+  --blocked <code>  exit code for a blocked verdict (default 0: "could not judge" is not a failed build)
   -h, --help        this text
 
 exit codes:  0 pass (and blocked, unless --blocked says otherwise) · 1 fail · 2 the exchange itself
-failed — wrong token, no such gate, daily ceiling reached, network. 2 is never a verdict: it means
+failed, wrong token, no such gate, daily ceiling reached, network. 2 is never a verdict: it means
 the pipeline's wiring needs a person, not that the product does.`;
 export const parseArgs = (argv, envUrl) => {
     let url = envUrl;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@intentic/gate",
-  "version": "1.224.0",
-  "description": "Run an intentic release gate from a CI pipeline — POST what the pipeline knows, wait for the run, exit on the verdict",
+  "version": "1.225.0",
+  "description": "Run an intentic release gate from a CI pipeline, POST what the pipeline knows, wait for the run, exit on the verdict",
   "license": "MIT",
   "type": "module",
   "repository": {
@@ -37,7 +37,7 @@
     "@typescript/native-preview": "7.0.0-dev.20260707.2",
     "vitest": "4.1.10",
     "@intentic/testing": "0.0.0",
-    "@intentic/sandbox-contract": "1.224.0",
+    "@intentic/sandbox-contract": "1.225.0",
     "@intentic/tsconfig": "0.0.0"
   },
   "scripts": {