@wildorder/nightshift 0.4.0 → 0.6.0

package/dist/run-publish.d.ts

@@ -0,0 +1,41 @@
+import { type RunProgramOptions, type RunProgramResult } from "./run-program.js";
+import { type PublishResult } from "./publish.js";
+/** What happened to the optional publish step, for the CLI to print. */
+export type PublishOutcome = {
+    status: "skipped";
+} | {
+    status: "published";
+    result: PublishResult;
+} | {
+    status: "failed";
+    error: Error;
+};
+export interface RunAndPublishOptions extends RunProgramOptions {
+    /** Whether `--publish` was passed. */
+    publish: boolean;
+    /** Injected for tests; default is the real WS-03 publish. */
+    publishProgram?: (options: {
+        cwd: string;
+        programId: string;
+    }) => Promise<PublishResult>;
+    /** Injected for tests; default is the real runner. */
+    runProgram?: (options: RunProgramOptions) => Promise<RunProgramResult>;
+}
+export interface RunAndPublishOutcome {
+    result: RunProgramResult;
+    publish: PublishOutcome;
+    /** The process exit code the CLI should set. Never applied here. */
+    exitCode: number;
+}
+/**
+ * Runs a program, then — only when `--publish` was passed — awaits the same
+ * `publish` path the standalone command calls, before returning. A
+ * could-not-start throw from `runProgram` propagates untouched: publish is
+ * never reached, so a run that never began publishes nothing. A publish
+ * failure is caught and reported, never allowed to overwrite the run's own
+ * exit code (a partial build stays 2, a complete run stays 0). Sets neither
+ * `process.exitCode` nor calls `process.exit` — the caller applies the
+ * returned code.
+ */
+export declare function runAndPublish(options: RunAndPublishOptions): Promise<RunAndPublishOutcome>;
+//# sourceMappingURL=run-publish.d.ts.map

package/dist/run-publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-publish.d.ts","sourceRoot":"","sources":["../src/run-publish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC7F,OAAO,EAA6B,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7E,wEAAwE;AACxE,MAAM,MAAM,cAAc,GACtB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GAC9C;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEvC,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACzF,sDAAsD;IACtD,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACxE;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,cAAc,CAAC;IACxB,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,oBAAoB,CAAC,CAoB/B"}

package/dist/run-publish.js

@@ -0,0 +1,33 @@
+import { runProgram } from "./run-program.js";
+import { publish as publishProgram } from "./publish.js";
+import { exitCodeForResult } from "./exit-codes.js";
+/**
+ * Runs a program, then — only when `--publish` was passed — awaits the same
+ * `publish` path the standalone command calls, before returning. A
+ * could-not-start throw from `runProgram` propagates untouched: publish is
+ * never reached, so a run that never began publishes nothing. A publish
+ * failure is caught and reported, never allowed to overwrite the run's own
+ * exit code (a partial build stays 2, a complete run stays 0). Sets neither
+ * `process.exitCode` nor calls `process.exit` — the caller applies the
+ * returned code.
+ */
+export async function runAndPublish(options) {
+    const run = options.runProgram ?? runProgram;
+    const doPublish = options.publishProgram ?? publishProgram;
+    const result = await run(options);
+    const exitCode = exitCodeForResult(result);
+    if (!options.publish) {
+        return { result, publish: { status: "skipped" }, exitCode };
+    }
+    try {
+        const published = await doPublish({
+            cwd: options.cwd,
+            programId: options.programId,
+        });
+        return { result, publish: { status: "published", result: published }, exitCode };
+    }
+    catch (error) {
+        return { result, publish: { status: "failed", error: error }, exitCode };
+    }
+}
+//# sourceMappingURL=run-publish.js.map

package/dist/run-publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-publish.js","sourceRoot":"","sources":["../src/run-publish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiD,MAAM,kBAAkB,CAAC;AAC7F,OAAO,EAAE,OAAO,IAAI,cAAc,EAAsB,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAwBpD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAA6B;IAE7B,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,IAAI,UAAU,CAAC;IAC7C,MAAM,SAAS,GAAG,OAAO,CAAC,cAAc,IAAI,cAAc,CAAC;IAE3D,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE3C,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC;IAC9D,CAAC;IAED,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC;YAChC,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC;IACnF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAc,EAAE,EAAE,QAAQ,EAAE,CAAC;IACpF,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wildorder/nightshift",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "The crew that builds while you're gone: walk-away, CI-dispatched engineering programs with a decision ledger instead of gates",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -57,10 +57,11 @@
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@types/node": "^26.1.2",
-    "@wildorder/nightshift": "^0.3.1",
+    "@wildorder/nightshift": "^0.5.0",
     "eslint": "^10.8.0",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.66.0",
-    "vitest": "^4.1.10"
+    "vitest": "^4.1.10",
+    "yaml": "^2.9.0"
   }
 }

package/skills/plan-program/SKILL.md

@@ -74,6 +74,20 @@ workstream covering the entire program, with no dependencies and task file
 `tasks/{program-id}/implementation.md`. In orchestrated mode use the
 decomposition and checkpoint rules below.
 
+## 2.5. Create the program's branch
+
+A program is planned on its own branch, created now — before either
+artifact is written — so the program document and manifest are authored on
+it directly and never have to be moved. Run exactly this command and nothing
+else:
+
+```sh
+npx --yes @wildorder/nightshift branch "{program-id}"
+```
+
+This skill composes no git of its own — the command above owns branch
+selection, and the packaged runner owns every commit that follows.
+
 ## 3. Draft the program document
 
 Inspect `docs/programs/` for an existing `*-program.md`. Match its structure