@kici-dev/compiler 0.1.14 → 0.1.16

package/dist/types.d.ts

@@ -9,10 +9,20 @@
  * v7 adds hook flags, step rules, gracePeriod, and workflow concurrency config.
  * v8 adds runsOn polymorphic type (string | string[] | selector) and excludeLabels.
  * v11 adds LockInlineValue type for pure function inline evaluation.
+ * v15 adds per-job init config(s).
  */
-import type { ResourceRequest } from '@kici-dev/engine';
+import type { ResourceRequest, ApproverClause } from '@kici-dev/engine';
+/**
+ * Normalized approval config carried in the lock file. Mirrors the engine
+ * `LockApproval` type. Produced by the compiler from an SDK `requireApproval`.
+ */
+export interface LockApproval {
+    readonly clauses: ApproverClause[];
+    readonly reason?: string;
+    readonly timeoutSeconds?: number;
+}
 /** Schema version - re-exported from engine as single source of truth */
-export declare const SCHEMA_VERSION: 12;
+export declare const SCHEMA_VERSION: 16;
 /**
  * Source file reference with meaningful path.
  * Format: file is relative path from git root, export uses hash syntax.
@@ -307,6 +317,8 @@ export interface LockStep {
     readonly continueOnError?: boolean;
     /** Step-level timeout in milliseconds. */
     readonly timeout?: number;
+    /** Declarative cache specs (normalized to an array). Restored before / saved after the step. */
+    readonly cache?: readonly import('@kici-dev/sdk').CacheSpec[];
     /** Source location of the step() call in the original TypeScript file (for annotations). */
     readonly sourceLocation?: {
         readonly file: string;
@@ -321,6 +333,8 @@ export interface LockStep {
     readonly hasOnCancel?: boolean;
     /** Whether this step has a cleanup hook. */
     readonly hasCleanup?: boolean;
+    /** Normalized approval gate; when set the step pauses for a human approval. */
+    readonly approval?: LockApproval;
 }
 /**
  * Inline expression value for pure dynamic functions.
@@ -369,6 +383,8 @@ export interface LockJob {
     readonly description?: string;
     /** When false, agent skips git clone (default: true). */
     readonly checkout?: boolean;
+    /** Declarative cache specs (normalized to an array). Restored before steps / saved after the job. */
+    readonly cache?: readonly import('@kici-dev/sdk').CacheSpec[];
     /** Docker image for job execution. All steps run inside the container. */
     readonly container?: string | {
         image: string;
@@ -400,12 +416,22 @@ export interface LockJob {
     readonly hasAfterStep?: boolean;
     /** Seconds before SIGKILL after SIGTERM during cancellation. */
     readonly gracePeriod?: number;
+    /** Total job wall-clock timeout in milliseconds (init + all steps + hooks). Agent reads this from jobConfig to arm a job-level deadline. */
+    readonly timeout?: number;
     /**
      * Resource request and limit for this job.
      * Threaded from SDK `Job.resources` to the orchestrator scaler for cap accounting
      * (`requests`) and kernel-side enforcement (`limits`) on the spawned agent.
      */
     readonly resources?: ResourceRequest;
+    /**
+     * Per-job init config(s) run after clone, before steps. `false` is an explicit
+     * opt-out. Threaded verbatim from the SDK `Job.init` -- the agent reads it from
+     * the loaded module, the lock copy is for orchestrator/dashboard visibility.
+     */
+    readonly init?: import('@kici-dev/sdk').GenericInitConfig | readonly import('@kici-dev/sdk').GenericInitConfig[] | false;
+    /** Normalized approval gate; when set the job is held before dispatch. */
+    readonly approval?: LockApproval;
 }
 /**
  * Dynamic job generator reference.
@@ -480,6 +506,10 @@ export interface LockWorkflow {
         readonly cancelInProgress?: boolean;
         readonly max?: number;
     };
+    /** Whole-run wall-clock timeout in milliseconds. Orchestrator reads this at run creation to set the run deadline. */
+    readonly timeout?: number;
+    /** Normalized approval gate; when set the whole run is held before any job dispatches. */
+    readonly approval?: LockApproval;
 }
 /**
  * Complete lock file structure.
@@ -492,6 +522,7 @@ export interface LockWorkflow {
  * v7 adds hook flags, step rules, gracePeriod, and workflow concurrency config.
  * v8 adds runsOn polymorphic type (string | string[] | selector) and excludeLabels.
  * v11 adds LockInlineValue type for pure function inline evaluation.
+ * v13 adds job-level and workflow-level timeout.
  */
 export interface LockFile {
     readonly schemaVersion: typeof SCHEMA_VERSION;

package/dist/types.js

@@ -12,6 +12,7 @@ import { SCHEMA_VERSION as SCHEMA_VERSION$1 } from "@kici-dev/engine";
 * v7 adds hook flags, step rules, gracePeriod, and workflow concurrency config.
 * v8 adds runsOn polymorphic type (string | string[] | selector) and excludeLabels.
 * v11 adds LockInlineValue type for pure function inline evaluation.
+* v15 adds per-job init config(s).
 */
 /** Schema version - re-exported from engine as single source of truth */
 const SCHEMA_VERSION = SCHEMA_VERSION$1;

package/dist/workflows/pr-checks.ts

@@ -2,7 +2,7 @@
 // Docs: https://kici.dev/docs/sdk-reference
 // Patterns: https://kici.dev/docs/workflow-patterns
 
-import { workflow, job, step, pr, rule, skip } from '@kici-dev/sdk';
+import { workflow, job, step, pr, rule, skip, isEventType } from '@kici-dev/sdk';
 
 export const prChecksWorkflow = workflow('pr-checks', {
   // Trigger: pr() matches pull request events
@@ -13,7 +13,9 @@ export const prChecksWorkflow = workflow('pr-checks', {
   // skip() = skip if true, rule() = run only if true
   rules: [
     skip('skip-draft-prs', async (ctx) => {
-      return (ctx.event as any).pull_request?.draft === true;
+      // Raw provider fields live under `ctx.event.payload`; narrow first for typing.
+      if (!isEventType(ctx.event, 'pull_request')) return false;
+      return ctx.event.payload.pull_request.draft === true;
     }),
 
     rule('require-src-changes', async (ctx) => {

package/package.json

@@ -1,18 +1,22 @@
 {
   "name": "@kici-dev/compiler",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Compiler and CLI for KiCI workflows. Compiles `.kici/workflows/*.ts` to a `kici.lock.json` file consumed by the orchestrator and agents, and runs workflows locally or against a remote orchestrator.",
   "keywords": [
-    "kici",
     "ci",
-    "cd",
-    "ci-cd",
+    "cicd",
+    "continuous-integration",
     "typescript",
-    "workflows",
-    "devops",
+    "workflow",
     "cli",
     "compiler"
   ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kici-dev/kici-public.git",
+    "directory": "packages/compiler"
+  },
+  "bugs": "https://github.com/kici-dev/kici-public/issues",
   "homepage": "https://kici.dev",
   "author": {
     "name": "KiCI",
@@ -58,11 +62,11 @@
     "ws": "^8.20.0",
     "yaml": "^2.8.3",
     "zx": "^8.8.5",
-    "@kici-dev/core": "0.1.14",
-    "@kici-dev/engine": "0.1.14"
+    "@kici-dev/core": "0.1.16",
+    "@kici-dev/engine": "0.1.16"
   },
   "peerDependencies": {
-    "@kici-dev/sdk": "0.1.14"
+    "@kici-dev/sdk": "0.1.16"
   },
   "devDependencies": {
     "@types/proper-lockfile": "^4.1.4"

package/sbom.spdx.json

@@ -2,10 +2,10 @@
   "spdxVersion": "SPDX-2.3",
   "dataLicense": "CC0-1.0",
   "SPDXID": "SPDXRef-DOCUMENT",
-  "name": "@kici-dev/compiler@0.1.14",
-  "documentNamespace": "https://kici.dev/sbom/%40kici-dev%2Fcompiler/0.1.14/5f13381c-c615-4ef1-85eb-a5d8a5a37493",
+  "name": "@kici-dev/compiler@0.1.16",
+  "documentNamespace": "https://kici.dev/sbom/%40kici-dev%2Fcompiler/0.1.16/2641506d-0356-4c02-b23d-2b96de4d4cc1",
   "creationInfo": {
-    "created": "2026-05-30T03:06:13Z",
+    "created": "2026-06-12T09:41:47Z",
     "creators": [
       "Tool: kici-sbom-generator"
     ]
@@ -484,7 +484,7 @@
     {
       "SPDXID": "SPDXRef-RootPackage",
       "name": "@kici-dev/compiler",
-      "versionInfo": "0.1.14",
+      "versionInfo": "0.1.16",
       "downloadLocation": "NOASSERTION",
       "filesAnalyzed": false,
       "licenseConcluded": "NOASSERTION",
@@ -495,16 +495,16 @@
         {
           "referenceCategory": "PACKAGE-MANAGER",
           "referenceType": "purl",
-          "referenceLocator": "pkg:npm/%40kici-dev/compiler@0.1.14"
+          "referenceLocator": "pkg:npm/%40kici-dev/compiler@0.1.16"
         }
       ],
       "description": "Compiler and CLI for KiCI workflows. Compiles `.kici/workflows/*.ts` to a `kici.lock.json` file consumed by the orchestrator and agents, and runs workflows locally or against a remote orchestrator.",
       "homepage": "https://kici.dev"
     },
     {
-      "SPDXID": "SPDXRef-Package--kici-dev-core-0.1.14",
+      "SPDXID": "SPDXRef-Package--kici-dev-core-0.1.16",
       "name": "@kici-dev/core",
-      "versionInfo": "0.1.14",
+      "versionInfo": "0.1.16",
       "downloadLocation": "NOASSERTION",
       "filesAnalyzed": false,
       "licenseConcluded": "NOASSERTION",
@@ -515,16 +515,16 @@
         {
           "referenceCategory": "PACKAGE-MANAGER",
           "referenceType": "purl",
-          "referenceLocator": "pkg:npm/%40kici-dev/core@0.1.14"
+          "referenceLocator": "pkg:npm/%40kici-dev/core@0.1.16"
         }
       ],
       "description": "Light shared utilities for the KiCI stack (logging, errors, formatting, crypto, zx init, the TypeScript ESM loader hook). No server-side dependencies.",
       "homepage": "https://kici.dev"
     },
     {
-      "SPDXID": "SPDXRef-Package--kici-dev-engine-0.1.14",
+      "SPDXID": "SPDXRef-Package--kici-dev-engine-0.1.16",
       "name": "@kici-dev/engine",
-      "versionInfo": "0.1.14",
+      "versionInfo": "0.1.16",
       "downloadLocation": "NOASSERTION",
       "filesAnalyzed": false,
       "licenseConcluded": "NOASSERTION",
@@ -535,16 +535,16 @@
         {
           "referenceCategory": "PACKAGE-MANAGER",
           "referenceType": "purl",
-          "referenceLocator": "pkg:npm/%40kici-dev/engine@0.1.14"
+          "referenceLocator": "pkg:npm/%40kici-dev/engine@0.1.16"
         }
       ],
       "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.",
       "homepage": "https://kici.dev"
     },
     {
-      "SPDXID": "SPDXRef-Package--kici-dev-sdk-0.1.14",
+      "SPDXID": "SPDXRef-Package--kici-dev-sdk-0.1.16",
       "name": "@kici-dev/sdk",
-      "versionInfo": "0.1.14",
+      "versionInfo": "0.1.16",
       "downloadLocation": "NOASSERTION",
       "filesAnalyzed": false,
       "licenseConcluded": "NOASSERTION",
@@ -555,7 +555,7 @@
         {
           "referenceCategory": "PACKAGE-MANAGER",
           "referenceType": "purl",
-          "referenceLocator": "pkg:npm/%40kici-dev/sdk@0.1.14"
+          "referenceLocator": "pkg:npm/%40kici-dev/sdk@0.1.16"
         }
       ],
       "description": "TypeScript SDK for defining KiCI workflows. Import into `.kici/workflows/*.ts` to declare workflows, jobs, steps, triggers, rules, and matrix configurations.",
@@ -3182,17 +3182,17 @@
     },
     {
       "spdxElementId": "SPDXRef-RootPackage",
-      "relatedSpdxElement": "SPDXRef-Package--kici-dev-core-0.1.14",
+      "relatedSpdxElement": "SPDXRef-Package--kici-dev-core-0.1.16",
       "relationshipType": "DEPENDS_ON"
     },
     {
       "spdxElementId": "SPDXRef-RootPackage",
-      "relatedSpdxElement": "SPDXRef-Package--kici-dev-engine-0.1.14",
+      "relatedSpdxElement": "SPDXRef-Package--kici-dev-engine-0.1.16",
       "relationshipType": "DEPENDS_ON"
     },
     {
       "spdxElementId": "SPDXRef-RootPackage",
-      "relatedSpdxElement": "SPDXRef-Package--kici-dev-sdk-0.1.14",
+      "relatedSpdxElement": "SPDXRef-Package--kici-dev-sdk-0.1.16",
       "relationshipType": "DEPENDS_ON"
     },
     {
@@ -3256,77 +3256,77 @@
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.16",
       "relatedSpdxElement": "SPDXRef-Package-oxc-transform-0.128.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.16",
       "relatedSpdxElement": "SPDXRef-Package-picocolors-1.1.1",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.16",
       "relatedSpdxElement": "SPDXRef-Package-winston-daily-rotate-file-5.0.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.16",
       "relatedSpdxElement": "SPDXRef-Package-winston-3.19.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.16",
       "relatedSpdxElement": "SPDXRef-Package-zod-4.3.6",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.16",
       "relatedSpdxElement": "SPDXRef-Package-zx-8.8.5",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-engine-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-engine-0.1.16",
       "relatedSpdxElement": "SPDXRef-Package-jsonpath-plus-10.4.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-engine-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-engine-0.1.16",
       "relatedSpdxElement": "SPDXRef-Package-picomatch-4.0.4",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-engine-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-engine-0.1.16",
       "relatedSpdxElement": "SPDXRef-Package-zod-4.3.6",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.14",
-      "relatedSpdxElement": "SPDXRef-Package--kici-dev-core-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.16",
+      "relatedSpdxElement": "SPDXRef-Package--kici-dev-core-0.1.16",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.14",
-      "relatedSpdxElement": "SPDXRef-Package--kici-dev-engine-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.16",
+      "relatedSpdxElement": "SPDXRef-Package--kici-dev-engine-0.1.16",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.16",
       "relatedSpdxElement": "SPDXRef-Package-fast-cartesian-9.0.1",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.16",
       "relatedSpdxElement": "SPDXRef-Package-micromatch-4.0.8",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.16",
       "relatedSpdxElement": "SPDXRef-Package-zod-4.3.6",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.16",
       "relatedSpdxElement": "SPDXRef-Package-zx-8.8.5",
       "relationshipType": "DEPENDS_ON"
     },