@kindgi/cli 0.1.4-rc.0 → 0.1.4-rc.2

package/dist/sdk-skills/kindgi-python-authoring-flows/SKILL.md

@@ -17,7 +17,7 @@ description: >
 type: core
 library: "kindgi (Python)"
 version: "0.1.1"
-sdk_version: "0.1.4-rc.0"
+sdk_version: "0.1.4-rc.2"
 pack_languages: [python]
 sources:
   - sdks/python/src/kindgi/pack/define.py

package/dist/sdk-skills/kindgi-python-authoring-guardrails/SKILL.md

@@ -15,7 +15,7 @@ description: >
 type: core
 library: "kindgi (Python)"
 version: "0.1.1"
-sdk_version: "0.1.4-rc.0"
+sdk_version: "0.1.4-rc.2"
 pack_languages: [python]
 sources:
   - sdks/python/src/kindgi/pack/define.py

package/dist/sdk-skills/kindgi-python-authoring-tools/SKILL.md

@@ -15,7 +15,7 @@ description: >
 type: core
 library: "kindgi (Python)"
 version: "0.1.1"
-sdk_version: "0.1.4-rc.0"
+sdk_version: "0.1.4-rc.2"
 pack_languages: [python]
 sources:
   - sdks/python/src/kindgi/pack/define.py

package/dist/sdk-skills/kindgi-python-getting-started/SKILL.md

@@ -15,7 +15,7 @@ description: >
 type: core
 library: "kindgi (Python)"
 version: "0.1.5"
-sdk_version: "0.1.4-rc.0"
+sdk_version: "0.1.4-rc.2"
 pack_languages: [python]
 sources:
   - sdks/python/README.md

package/dist/stop-signal.d.ts

@@ -1,15 +1,49 @@
 /**
- * SIGINT / SIGTERM → an AbortSignal long-lived commands (`kindgi dev`)
- * watch to shut down cleanly: close watchers, stop the api-server, tear
- * down the bundled containers.
+ * SIGINT / SIGTERM / SIGHUP → an AbortSignal long-lived commands
+ * (`kindgi dev`) watch to shut down cleanly: close watchers, stop the
+ * api-server, tear down the bundled containers. SIGHUP is the terminal
+ * closing: without a listener it ended `kindgi dev` at once, leaving its
+ * runtime container running.
  *
  * The listener stays registered (`on`, never `once`), so a dependency
  * that re-raises a signal when it finds itself the only listener left
- * (`signal-exit` v3 does) can't cut the graceful shutdown short. A second
- * signal forces the exit, the usual Ctrl+C-twice contract.
+ * (`signal-exit` v3 does) can't cut the graceful shutdown short.
+ *
+ * A second Ctrl+C forces the exit, the usual Ctrl+C-twice contract, but
+ * not one that comes with the first. One Ctrl+C can arrive more than once:
+ * the terminal signals the whole foreground process group, and a wrapper
+ * in it signals its child too (`npx` and `pnpm run` forward SIGINT;
+ * `pnpm exec` sends SIGTERM and exits at once). A signal is the same
+ * Ctrl+C when it's handled within `REPEAT_SIGNAL_WINDOW_MS` of the first,
+ * or before the event loop has turned twice since: a stop step can hold
+ * the loop (closing a recursive file watcher takes over a second on
+ * macOS), so a signal that came at once can be handled late. A SIGTERM
+ * or SIGHUP never forces the exit; it asks for the stop already under
+ * way. Forcing it left the runtime container running.
  */
+type StopSignalName = 'SIGINT' | 'SIGTERM' | 'SIGHUP';
 export interface SignalSource {
-    on(event: 'SIGINT' | 'SIGTERM', listener: () => void): unknown;
+    on(event: StopSignalName, listener: () => void): unknown;
+}
+/** Where the stop signal reads the time and the event loop's turns (tests fake it). */
+export interface StopSignalClock {
+    now(): number;
+    /** Run `fn` on the event loop's next turn. */
+    nextTurn(fn: () => void): void;
+}
+/** How long after the first signal another is still the same Ctrl+C. */
+export declare const REPEAT_SIGNAL_WINDOW_MS = 500;
+export declare function createStopSignal(source: SignalSource, forceExit: (code: number) => void, clock?: StopSignalClock): AbortSignal;
+/** Where the command's output goes (`process.stdout`, `process.stderr`). */
+export interface OutputStream {
+    on(event: 'error', listener: (error: Error) => void): unknown;
 }
-export declare function createStopSignal(source: SignalSource, forceExit: (code: number) => void): AbortSignal;
+/**
+ * After a hangup (SIGHUP: the terminal closed), writing to the terminal
+ * fails (EIO). Unheard, that error would end the process mid-stop, the
+ * runtime container left behind, so from then on the outputs' errors are
+ * ignored: nobody is left to read them.
+ */
+export declare function ignoreOutputAfterHangup(source: SignalSource, outputs: readonly OutputStream[]): void;
+export {};
 //# sourceMappingURL=stop-signal.d.ts.map

package/dist/stop-signal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stop-signal.d.ts","sourceRoot":"","sources":["../src/stop-signal.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AAEH,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;CAChE;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAChC,WAAW,CAYb"}
+{"version":3,"file":"stop-signal.d.ts","sourceRoot":"","sources":["../src/stop-signal.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,KAAK,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;CAC1D;AAED,uFAAuF;AACvF,MAAM,WAAW,eAAe;IAC9B,GAAG,IAAI,MAAM,CAAC;IACd,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAChC;AAED,wEAAwE;AACxE,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAS3C,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EACjC,KAAK,GAAE,eAA6B,GACnC,WAAW,CAuBb;AAED,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC;CAC/D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,SAAS,YAAY,EAAE,GAC/B,IAAI,CAON"}

package/dist/stop-signal.js

@@ -1,16 +1,51 @@
 // SPDX-License-Identifier: Apache-2.0
 // Copyright (C) 2026 Kindgi Inc.
-export function createStopSignal(source, forceExit) {
+/** How long after the first signal another is still the same Ctrl+C. */
+export const REPEAT_SIGNAL_WINDOW_MS = 500;
+const systemClock = {
+    now: () => Date.now(),
+    nextTurn: (fn) => {
+        setImmediate(fn);
+    },
+};
+export function createStopSignal(source, forceExit, clock = systemClock) {
     const controller = new AbortController();
-    const onSignal = () => {
+    let firstAt = 0;
+    let settled = false;
+    const onSignal = (signal) => {
         if (!controller.signal.aborted) {
+            firstAt = clock.now();
+            clock.nextTurn(() => clock.nextTurn(() => {
+                settled = true;
+            }));
             controller.abort();
             return;
         }
+        if (signal !== 'SIGINT')
+            return;
+        if (!settled || clock.now() - firstAt < REPEAT_SIGNAL_WINDOW_MS)
+            return;
         forceExit(130);
     };
-    source.on('SIGINT', onSignal);
-    source.on('SIGTERM', onSignal);
+    source.on('SIGINT', () => onSignal('SIGINT'));
+    source.on('SIGTERM', () => onSignal('SIGTERM'));
+    source.on('SIGHUP', () => onSignal('SIGHUP'));
     return controller.signal;
 }
+/**
+ * After a hangup (SIGHUP: the terminal closed), writing to the terminal
+ * fails (EIO). Unheard, that error would end the process mid-stop, the
+ * runtime container left behind, so from then on the outputs' errors are
+ * ignored: nobody is left to read them.
+ */
+export function ignoreOutputAfterHangup(source, outputs) {
+    let hungUp = false;
+    source.on('SIGHUP', () => {
+        if (hungUp)
+            return;
+        hungUp = true;
+        for (const output of outputs)
+            output.on('error', () => undefined);
+    });
+}
 //# sourceMappingURL=stop-signal.js.map

package/dist/stop-signal.js.map

@@ -1 +1 @@
-{"version":3,"file":"stop-signal.js","sourceRoot":"","sources":["../src/stop-signal.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAiBjC,MAAM,UAAU,gBAAgB,CAC9B,MAAoB,EACpB,SAAiC;IAEjC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/B,UAAU,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC,CAAC;IACF,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,UAAU,CAAC,MAAM,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"stop-signal.js","sourceRoot":"","sources":["../src/stop-signal.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAuCjC,wEAAwE;AACxE,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,MAAM,WAAW,GAAoB;IACnC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;IACrB,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE;QACf,YAAY,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;CACF,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAC9B,MAAoB,EACpB,SAAiC,EACjC,QAAyB,WAAW;IAEpC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,QAAQ,GAAG,CAAC,MAAsB,EAAQ,EAAE;QAChD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/B,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;YACtB,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,CAClB,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE;gBAClB,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC,CAAC,CACH,CAAC;YACF,UAAU,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QACD,IAAI,MAAM,KAAK,QAAQ;YAAE,OAAO;QAChC,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,uBAAuB;YAAE,OAAO;QACxE,SAAS,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC,CAAC;IACF,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9C,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IAChD,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9C,OAAO,UAAU,CAAC,MAAM,CAAC;AAC3B,CAAC;AAOD;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAoB,EACpB,OAAgC;IAEhC,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACvB,IAAI,MAAM;YAAE,OAAO;QACnB,MAAM,GAAG,IAAI,CAAC;QACd,KAAK,MAAM,MAAM,IAAI,OAAO;YAAE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kindgi/cli",
-  "version": "0.1.4-rc.0",
+  "version": "0.1.4-rc.2",
   "description": "Command-line interface for Kindgi™ — the sovereign AI OS. Create a pack, run it on your machine (`kindgi dev`), build, sign and deploy it, and work with a running Kindgi API from the terminal.",
   "license": "Apache-2.0",
   "repository": {
@@ -37,15 +37,16 @@
     "provenance": true
   },
   "dependencies": {
-    "@kindgi/client": "0.1.4-rc.0",
-    "@kindgi/dotenv-file": "0.1.4-rc.0",
-    "@kindgi/crypto": "0.1.4-rc.0",
-    "@kindgi/env-schema": "0.1.4-rc.0",
-    "@kindgi/handler-runtime": "0.1.4-rc.0",
-    "@kindgi/secrets-dotenv": "0.1.4-rc.0",
-    "@kindgi/platform": "0.1.4-rc.0",
-    "@kindgi/sdk": "0.1.4-rc.0",
-    "@kindgi/types": "0.1.4-rc.0",
+    "@kindgi/client": "0.1.4-rc.2",
+    "@kindgi/dotenv-file": "0.1.4-rc.2",
+    "@kindgi/crypto": "0.1.4-rc.2",
+    "@kindgi/env-schema": "0.1.4-rc.2",
+    "@kindgi/flow": "0.1.4-rc.2",
+    "@kindgi/handler-runtime": "0.1.4-rc.2",
+    "@kindgi/secrets-dotenv": "0.1.4-rc.2",
+    "@kindgi/platform": "0.1.4-rc.2",
+    "@kindgi/sdk": "0.1.4-rc.2",
+    "@kindgi/types": "0.1.4-rc.2",
     "esbuild": "^0.24.0",
     "semver": "^7.8.5",
     "smol-toml": "^1.9.0",