@kici-dev/engine 0.1.20 → 0.1.22

package/dist/trigger/types.js

@@ -1,4 +1,5 @@
 import "../chunk-BTugEXQM.js";
+import { ExecutionJobStatus, TERMINAL_JOB_STATES } from "../protocol/messages/execution-status.js";
 import { z } from "zod";
 //#region src/trigger/types.ts
 /**
@@ -20,33 +21,61 @@ import { z } from "zod";
 * Schema version 20: runsOn/runsOnAll/excludeLabels carry LabelMatcher (exact|regex) for glob+regex selectors.
 */
 /** Schema version - increment on breaking changes */
-const SCHEMA_VERSION = 20;
+const SCHEMA_VERSION = 22;
 /** Type guard for inline expression values */
 function isLockInlineValue(value) {
 	return typeof value === "object" && value !== null && value._type === "inline";
 }
 /**
-* Per-edge failure policy for a `needs` dependency: `skip` propagates an
-* upstream failure to the downstream job (default), `run` runs the downstream
-* job regardless of the upstream outcome. Single source of truth for this
-* value across lock-file schemas and protocol messages.
+* Author-facing keyword sugar for a `needs` edge's run condition. Each keyword
+* resolves (at compile time) to a set of upstream terminal statuses; the
+* downstream edge is dispatch-satisfied when the upstream's terminal status is
+* a member of that set.
 */
-const IfFailedPolicy = z.enum(["skip", "run"]);
+const NeedsWhen = z.enum([
+	"on-success",
+	"always",
+	"on-skip",
+	"on-failure"
+]);
+/**
+* Normalized, DB-evaluable run condition for a `needs` edge: the non-empty set
+* of upstream terminal statuses that satisfy the edge. The lock file and the
+* orchestrator scheduler only ever see this resolved set (never a keyword), so
+* gating stays a pure status-set membership test.
+*/
+const NeedsRunOn = z.array(ExecutionJobStatus).nonempty();
+const WHEN_TO_RUN_ON = {
+	"on-success": [ExecutionJobStatus.enum.success],
+	always: [...TERMINAL_JOB_STATES],
+	"on-skip": [ExecutionJobStatus.enum.success, ExecutionJobStatus.enum.skipped],
+	"on-failure": [ExecutionJobStatus.enum.failed, ExecutionJobStatus.enum.timed_out_stale]
+};
+/**
+* Resolve the author-facing `when` (keyword sugar | raw status-set | unset) to
+* the normalized status-set. An unset `when` defaults to success-only — the
+* downstream runs only when the upstream succeeded.
+*/
+function resolveWhenToRunOn(when) {
+	if (when === void 0) return [ExecutionJobStatus.enum.success];
+	if (Array.isArray(when)) return when;
+	return WHEN_TO_RUN_ON[when];
+}
 /**
-* Needs entry with per-edge failure policy.
-* Used in lock file needs arrays for explicit ifFailed override.
+* Needs entry carrying the normalized run-on status-set.
+* Used in lock file needs arrays for an explicit per-edge run condition.
 */
 const NeedsEntrySchema = z.object({
 	name: z.string(),
-	ifFailed: IfFailedPolicy.default(IfFailedPolicy.enum.skip)
+	runOn: NeedsRunOn.default([ExecutionJobStatus.enum.success])
 });
 /**
-* Needs group entry with per-edge failure policy.
+* Needs group entry carrying the normalized run-on status-set.
 * Used in lock file needs arrays for dynamic group dependencies.
 */
 const NeedsGroupEntrySchema = z.object({
 	group: z.string(),
-	ifFailed: IfFailedPolicy.default(IfFailedPolicy.enum.skip)
+	runOn: NeedsRunOn.default([ExecutionJobStatus.enum.success])
 });
 /**
 * Failure policy for a host fan-out (`runsOnAll`) when an expected durable host
@@ -74,6 +103,6 @@ function isLockDynamicJobFn(job) {
 	return job._type === "dynamic";
 }
 //#endregion
-export { IfFailedPolicy, NeedsEntrySchema, NeedsGroupEntrySchema, OnUnreachableMode, SCHEMA_VERSION, isLockDynamicJobFn, isLockInlineValue, isLockStaticJob };
+export { NeedsEntrySchema, NeedsGroupEntrySchema, NeedsRunOn, NeedsWhen, OnUnreachableMode, SCHEMA_VERSION, isLockDynamicJobFn, isLockInlineValue, isLockStaticJob, resolveWhenToRunOn };
 
 //# sourceMappingURL=types.js.map

package/dist/webhook/webhook-url-format.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Route shape for a GitHub App webhook. Org-scoped, NOT app-scoped — the app
+ * id does not appear, so the URL is resolvable before the App exists (the
+ * manifest setup flow needs it up front to bake into the App manifest). Shared
+ * by the Platform's webhook-URL builder and the orchestrator's manifest
+ * pre-flight so the two never drift.
+ */
+export declare function githubWebhookPath(orgId: string): string;
+//# sourceMappingURL=webhook-url-format.d.ts.map

package/dist/webhook/webhook-url-format.js

@@ -0,0 +1,16 @@
+import "../chunk-BTugEXQM.js";
+//#region src/webhook/webhook-url-format.ts
+/**
+* Route shape for a GitHub App webhook. Org-scoped, NOT app-scoped — the app
+* id does not appear, so the URL is resolvable before the App exists (the
+* manifest setup flow needs it up front to bake into the App manifest). Shared
+* by the Platform's webhook-URL builder and the orchestrator's manifest
+* pre-flight so the two never drift.
+*/
+function githubWebhookPath(orgId) {
+	return `/webhook/${orgId}/github`;
+}
+//#endregion
+export { githubWebhookPath };
+
+//# sourceMappingURL=webhook-url-format.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kici-dev/engine",
-  "version": "0.1.20",
+  "version": "0.1.22",
   "description": "Shared business logic for the KiCI CI/CD stack: protocol, triggers, state machine, and provider interfaces used by the Platform relay, orchestrator, and compiler.",
   "keywords": [
     "ci",

package/sbom.spdx.json

@@ -2,10 +2,10 @@
   "spdxVersion": "SPDX-2.3",
   "dataLicense": "CC0-1.0",
   "SPDXID": "SPDXRef-DOCUMENT",
-  "name": "@kici-dev/engine@0.1.20",
-  "documentNamespace": "https://kici.dev/sbom/%40kici-dev%2Fengine/0.1.20/00caaa58-0c0e-4385-ac94-cdebc74f5d65",
+  "name": "@kici-dev/engine@0.1.22",
+  "documentNamespace": "https://kici.dev/sbom/%40kici-dev%2Fengine/0.1.22/5dc6919d-c8a2-40b2-aba3-44650ecac92f",
   "creationInfo": {
-    "created": "2026-06-19T09:07:10Z",
+    "created": "2026-06-24T06:02:58Z",
     "creators": [
       "Tool: kici-sbom-generator"
     ]
@@ -54,7 +54,7 @@
     {
       "SPDXID": "SPDXRef-RootPackage",
       "name": "@kici-dev/engine",
-      "versionInfo": "0.1.20",
+      "versionInfo": "0.1.22",
       "downloadLocation": "NOASSERTION",
       "filesAnalyzed": false,
       "licenseConcluded": "NOASSERTION",
@@ -65,7 +65,7 @@
         {
           "referenceCategory": "PACKAGE-MANAGER",
           "referenceType": "purl",
-          "referenceLocator": "pkg:npm/%40kici-dev/engine@0.1.20"
+          "referenceLocator": "pkg:npm/%40kici-dev/engine@0.1.22"
         }
       ],
       "description": "Shared business logic for the KiCI CI/CD stack: protocol, triggers, state machine, and provider interfaces used by the Platform relay, orchestrator, and compiler.",