@shardworks/nexus 0.1.270 → 0.1.271

package/dist/started-guild.js

@@ -0,0 +1,47 @@
+/**
+ * CLI-internal carrier for the `StartedGuild` returned by
+ * `createGuild()`.
+ *
+ * The `Guild` accessor in `@shardworks/nexus-core` deliberately
+ * narrows away `shutdown()` because plugin code has no legitimate
+ * reason to tear down the guild it is running inside (commission
+ * decision D1). The bootstrap caller — `program.ts` — does have a
+ * reason: when a long-lived foreground command (the `nsg start`
+ * daemon, the Clockworks foreground daemon entry) finishes, the
+ * SIGTERM/SIGINT handler must invoke `shutdown()` on the way out so
+ * every apparatus's optional `stop()` runs and handles get released.
+ *
+ * The threading channel used to be implicit (handlers called
+ * `guild()` and trusted the singleton). With the lifecycle contract
+ * in place, the daemon handlers need the richer `StartedGuild` value;
+ * this module is where `program.ts` deposits it for those handlers to
+ * read without changing the `tool({ … })` factory's signature.
+ *
+ * Per D8 the threading is explicit: `program.ts` sets, the start
+ * tool's handler gets. There is no transparent fallback to the
+ * `guild()` singleton — if no one called `setStartedGuild()` the
+ * accessor returns `undefined` and the daemon decides what to do.
+ */
+let _started;
+/** Record the `StartedGuild` returned by Arbor's `createGuild()`. */
+export function setStartedGuild(g) {
+    _started = g;
+}
+/**
+ * Read the `StartedGuild` deposited by `program.ts`. Returns
+ * `undefined` when no guild has been started in this process —
+ * callers in daemon paths should treat that as a fail-loud
+ * misconfiguration.
+ */
+export function getStartedGuild() {
+    return _started;
+}
+/**
+ * Clear the stored reference. Provided for test isolation; production
+ * code never calls this directly — `StartedGuild.shutdown()` is what
+ * tears the guild down, and the process exits shortly after.
+ */
+export function clearStartedGuild() {
+    _started = undefined;
+}
+//# sourceMappingURL=started-guild.js.map

package/dist/started-guild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"started-guild.js","sourceRoot":"","sources":["../src/started-guild.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,IAAI,QAAkC,CAAC;AAEvC,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAAC,CAAe;IAC7C,QAAQ,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,QAAQ,GAAG,SAAS,CAAC;AACvB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shardworks/nexus",
-  "version": "0.1.270",
+  "version": "0.1.271",
   "license": "ISC",
   "repository": {
     "type": "git",
@@ -21,9 +21,10 @@
   "dependencies": {
     "commander": "14.0.3",
     "zod": "4.3.6",
-    "@shardworks/nexus-core": "0.1.270",
-    "@shardworks/nexus-arbor": "0.1.270",
-    "@shardworks/tools-apparatus": "0.1.270"
+    "@shardworks/nexus-core": "0.1.271",
+    "@shardworks/tools-apparatus": "0.1.271",
+    "@shardworks/clockworks-apparatus": "0.1.271",
+    "@shardworks/nexus-arbor": "0.1.271"
   },
   "devDependencies": {
     "@types/node": "25.5.0"