@kici-dev/compiler 0.0.0 → 0.1.1

package/dist/validation/validator.js

@@ -0,0 +1,164 @@
+import "../chunk-gOLHoazu.js";
+import { compilerError } from "../errors/formatter.js";
+import "../errors/index.js";
+import { getDynamicJobGroup, isDynamicGroupRef, isDynamicJobFn, isStaticArray, isStaticObject, validateDag } from "@kici-dev/sdk";
+//#region src/validation/validator.ts
+/** Maximum jobs from static matrix expansion (GitHub Actions limit) */
+const MAX_STATIC_MATRIX_JOBS = 256;
+/**
+* Validate workflows at compile-time.
+*
+* Checks performed:
+* 1. No duplicate workflow names
+* 2. No duplicate job names within each workflow
+* 3. Job dependencies are valid (exist, no cycles, no self-refs)
+* 4. Static matrix expansions stay under 256 job limit
+*
+* @param workflows - Array of workflows from config
+* @param configPath - Path for error location reporting
+* @returns Validation result with errors if any
+*/
+function validateConfig(workflows, configPath) {
+	const errors = [];
+	const workflowNames = /* @__PURE__ */ new Set();
+	for (const workflow of workflows) {
+		if (workflowNames.has(workflow.name)) errors.push(compilerError("E107", `Duplicate workflow name: "${workflow.name}"`, {
+			location: {
+				file: configPath,
+				line: 1,
+				column: 1
+			},
+			suggestion: "Each workflow must have a unique name"
+		}));
+		workflowNames.add(workflow.name);
+	}
+	for (const workflow of workflows) {
+		const workflowErrors = validateWorkflow(workflow, configPath);
+		errors.push(...workflowErrors);
+	}
+	if (errors.length > 0) return {
+		valid: false,
+		errors
+	};
+	return { valid: true };
+}
+/**
+* Validate a single workflow.
+*/
+function validateWorkflow(workflow, configPath) {
+	const errors = [];
+	const staticJobs = [];
+	for (const jobOrFactory of workflow.jobs) if (!isDynamicJobFn(jobOrFactory)) staticJobs.push(jobOrFactory);
+	const jobNames = /* @__PURE__ */ new Set();
+	for (const job of staticJobs) {
+		if (jobNames.has(job.name)) errors.push(compilerError("E106", `Duplicate job name "${job.name}" in workflow "${workflow.name}"`, {
+			location: {
+				file: configPath,
+				line: 1,
+				column: 1
+			},
+			suggestion: "Each job in a workflow must have a unique name"
+		}));
+		jobNames.add(job.name);
+	}
+	const dynamicGroupNames = /* @__PURE__ */ new Set();
+	for (const jobOrFactory of workflow.jobs) if (isDynamicJobFn(jobOrFactory)) {
+		const groupName = getDynamicJobGroup(jobOrFactory);
+		if (groupName) dynamicGroupNames.add(groupName);
+	}
+	const dagErrors = validateJobDag(staticJobs, workflow.name, configPath, dynamicGroupNames);
+	errors.push(...dagErrors);
+	for (const job of staticJobs) {
+		const matrixErrors = validateStaticMatrix(job, workflow.name, configPath);
+		errors.push(...matrixErrors);
+	}
+	return errors;
+}
+/**
+* Validate job dependency DAG.
+* Includes synthetic __group: nodes for tagged dynamic job functions ( Layer 1).
+*/
+function validateJobDag(jobs, workflowName, configPath, dynamicGroupNames) {
+	const errors = [];
+	const dagNodes = jobs.map((job) => ({
+		id: job.name,
+		needs: resolveNeeds(job.needs)
+	}));
+	if (dynamicGroupNames) for (const groupName of dynamicGroupNames) dagNodes.push({
+		id: `__group:${groupName}`,
+		needs: []
+	});
+	const result = validateDag(dagNodes);
+	if (!result.valid) switch (result.error) {
+		case "cycle":
+			errors.push(compilerError("E102", `Circular dependency in workflow "${workflowName}": ${result.nodesInCycle.join(" -> ")}`, {
+				location: {
+					file: configPath,
+					line: 1,
+					column: 1
+				},
+				suggestion: "Break the cycle by removing one of the dependencies"
+			}));
+			break;
+		case "self-reference":
+			errors.push(compilerError("E103", `Job "${result.nodeId}" in workflow "${workflowName}" depends on itself`, {
+				location: {
+					file: configPath,
+					line: 1,
+					column: 1
+				},
+				suggestion: "Remove the self-dependency"
+			}));
+			break;
+		case "missing-dependency":
+			errors.push(compilerError("E101", `Job "${result.nodeId}" in workflow "${workflowName}" depends on non-existent job "${result.missingDep}"`, {
+				location: {
+					file: configPath,
+					line: 1,
+					column: 1
+				},
+				suggestion: `Create a job named "${result.missingDep}" or fix the dependency name`
+			}));
+			break;
+	}
+	return errors;
+}
+/**
+* Resolve needs array to job names (handling Job objects, strings, DynamicGroupRef, and object forms).
+* DynamicGroupRef and { group } forms resolve to synthetic __group: node names.
+*/
+function resolveNeeds(needs) {
+	if (!needs) return [];
+	return needs.map((need) => {
+		if (typeof need === "string") return need;
+		if (isDynamicGroupRef(need)) return `__group:${need.group}`;
+		if ("group" in need && typeof need.group === "string") return `__group:${need.group}`;
+		if ("name" in need) return need.name;
+		return String(need);
+	});
+}
+/**
+* Validate static matrix doesn't exceed job limit.
+*/
+function validateStaticMatrix(job, workflowName, configPath) {
+	const errors = [];
+	if (!job.matrix) return errors;
+	if (typeof job.matrix === "function") return errors;
+	let expansionCount = 1;
+	if (isStaticArray(job.matrix)) expansionCount = job.matrix.length;
+	else if (isStaticObject(job.matrix)) expansionCount = Object.values(job.matrix).reduce((acc, dimension) => acc * dimension.length, 1);
+	if (job.include) expansionCount += job.include.length;
+	if (expansionCount > MAX_STATIC_MATRIX_JOBS) errors.push(compilerError("E104", `Static matrix for job "${job.name}" in workflow "${workflowName}" would generate ${expansionCount} jobs (max: ${MAX_STATIC_MATRIX_JOBS})`, {
+		location: {
+			file: configPath,
+			line: 1,
+			column: 1
+		},
+		suggestion: "Reduce matrix dimensions or use exclude patterns to limit combinations"
+	}));
+	return errors;
+}
+//#endregion
+export { validateConfig };
+
+//# sourceMappingURL=validator.js.map

package/dist/watch-started.json

@@ -0,0 +1,15 @@
+{
+  "action": "started",
+  "repository": {
+    "name": "test-repo",
+    "full_name": "test-org/test-repo",
+    "owner": {
+      "login": "test-org"
+    },
+    "default_branch": "main",
+    "watchers_count": 50
+  },
+  "sender": {
+    "login": "test-user"
+  }
+}

package/dist/workflow-run-completed.json

@@ -0,0 +1,23 @@
+{
+  "action": "completed",
+  "workflow_run": {
+    "id": 1,
+    "name": "CI",
+    "head_branch": "main",
+    "head_sha": "abc123def456",
+    "status": "completed",
+    "conclusion": "success",
+    "event": "push"
+  },
+  "repository": {
+    "name": "test-repo",
+    "full_name": "test-org/test-repo",
+    "owner": {
+      "login": "test-org"
+    },
+    "default_branch": "main"
+  },
+  "sender": {
+    "login": "test-user"
+  }
+}

package/dist/workflows/hello-world.ts

@@ -0,0 +1,21 @@
+// Hello World -- minimal push workflow
+// Docs: https://kici.dev/docs/sdk-reference
+
+import { workflow, job, step, push } from '@kici-dev/sdk';
+
+export const helloWorldWorkflow = workflow('hello-world', {
+  // Trigger: push() matches any push event
+  // Options: branches, tags, paths, description (config-style; use !-prefix for exclusions)
+  on: push(),
+
+  jobs: [
+    job('greet', {
+      runsOn: 'ubuntu-latest',
+      steps: [
+        step('say-hello', async ({ $ }) => {
+          await $`echo "Hello, World!"`;
+        }),
+      ],
+    }),
+  ],
+});

package/dist/workflows/pr-checks.ts

@@ -0,0 +1,57 @@
+// PR Checks -- workflow with rules, dependencies, and multiple jobs
+// 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';
+
+export const prChecksWorkflow = workflow('pr-checks', {
+  // Trigger: pr() matches pull request events
+  // Options: target, paths, events (config-style)
+  on: pr({ target: 'main', paths: ['src/**'] }),
+
+  // Rules: evaluated before workflow runs
+  // 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;
+    }),
+
+    rule('require-src-changes', async (ctx) => {
+      return ctx.changedFiles.some((file) => file.startsWith('src/'));
+    }),
+  ],
+
+  // Jobs: run in parallel unless connected via `needs`
+  jobs: [
+    job('lint', {
+      runsOn: 'ubuntu-latest',
+      steps: [
+        step('checkout', async ({ $ }) => {
+          await $`echo "Checking out code..."`;
+        }),
+        step('run-linter', async ({ $ }) => {
+          // Replace with your linter: eslint, biome, cargo clippy, etc.
+          await $`echo "Running linter..."`;
+        }),
+      ],
+    }),
+
+    job('test', {
+      runsOn: 'ubuntu-latest',
+      needs: ['lint'], // Waits for lint to pass
+      steps: [
+        step('checkout', async ({ $ }) => {
+          await $`echo "Checking out code..."`;
+        }),
+        step('install-deps', async ({ $ }) => {
+          // Replace with: npm ci, etc.
+          await $`echo "Installing dependencies..."`;
+        }),
+        step('run-tests', async ({ $ }) => {
+          // Replace with: npm test, vitest run, cargo test, etc.
+          await $`echo "Running tests..."`;
+        }),
+      ],
+    }),
+  ],
+});

package/hack/postinstall.mjs

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+/**
+ * Postinstall wrapper script for @kici-dev/compiler
+ *
+ * This wrapper:
+ * 1. Detects development mode (KICI_DEV env or kici.development in root package.json)
+ * 2. Skips postinstall in dev mode (prevents "Cannot find dist/postinstall.mjs" errors)
+ * 3. Delegates to dist/postinstall.mjs in production mode
+ *
+ * Purpose: Allow `pnpm install` to succeed even when dist/ hasn't been built yet
+ */
+
+import { spawn } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+/**
+ * Detect if running in development mode
+ *
+ * Development mode is used when developing KiCI itself.
+ * Checks:
+ * 1. KICI_DEV environment variable
+ * 2. Root package.json kici.development flag
+ *
+ * @returns {Promise<boolean>} true if in development mode
+ */
+async function detectDevelopmentMode() {
+  // Method 1: Environment variable
+  if (process.env.KICI_DEV === 'true') {
+    if (process.env.KICI_DEBUG === 'true') {
+      console.log('[postinstall] Skipping: KICI_DEV=true');
+    }
+    return true;
+  }
+
+  // Method 2: Check root package.json for kici.development flag
+  // During npm/pnpm install, INIT_CWD contains the original working directory (project root)
+  try {
+    const rootDir = process.env.INIT_CWD || process.cwd();
+    const rootPkgPath = path.join(rootDir, 'package.json');
+    const content = await readFile(rootPkgPath, 'utf-8');
+    const pkg = JSON.parse(content);
+
+    if (pkg.kici?.development === true) {
+      if (process.env.KICI_DEBUG === 'true') {
+        console.log('[postinstall] Skipping: kici.development=true in root package.json');
+      }
+      return true;
+    }
+  } catch {
+    // Root package.json doesn't exist or can't be read
+  }
+
+  return false;
+}
+
+/**
+ * Run the actual postinstall script
+ *
+ * @returns {Promise<void>}
+ */
+function runPostinstall() {
+  return new Promise((resolve, reject) => {
+    const postinstallPath = path.join(__dirname, '..', 'dist', 'postinstall.js');
+
+    const child = spawn('node', [postinstallPath], {
+      stdio: 'inherit',
+    });
+
+    child.on('close', (code) => {
+      if (code === 0) {
+        resolve();
+      } else {
+        reject(new Error(`postinstall.mjs exited with code ${code}`));
+      }
+    });
+
+    child.on('error', (err) => {
+      reject(err);
+    });
+  });
+}
+
+async function main() {
+  try {
+    // Skip in development mode
+    if (await detectDevelopmentMode()) {
+      return;
+    }
+
+    // Run the actual postinstall
+    await runPostinstall();
+  } catch (err) {
+    // Silently fail - postinstall should not break npm install
+    if (process.env.KICI_DEBUG === 'true') {
+      console.error('[postinstall] Error:', err.message);
+    }
+  }
+}
+
+main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kici-dev/compiler",
-  "version": "0.0.0",
+  "version": "0.1.1",
   "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",
@@ -9,7 +9,9 @@
     "ci-cd",
     "typescript",
     "workflows",
-    "devops"
+    "devops",
+    "cli",
+    "compiler"
   ],
   "homepage": "https://kici.dev",
   "author": {
@@ -17,9 +19,63 @@
     "email": "hello@kici.dev"
   },
   "license": "Apache-2.0",
-  "main": "index.js",
+  "engines": {
+    "node": ">=24"
+  },
   "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "kici": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map",
+    "hack/postinstall.mjs",
+    "sbom.spdx.json"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./cli": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-ts.mjs && tsc --emitDeclarationOnly",
+    "postbuild": "zx hack/postbuild.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "postinstall": "node hack/postinstall.mjs",
+    "postpublish": "node ../../packages/kici/hack/publish-wrapper.mjs",
+    "prepublishOnly": "npx tsx ../../hack/generate-sbom.ts --package packages/compiler --name @kici-dev/compiler"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.4.2",
+    "@kici-dev/engine": "workspace:*",
+    "@kici-dev/shared": "workspace:*",
+    "chokidar": "^5.0.0",
+    "commander": "^14.0.3",
+    "fast-glob": "^3.3.3",
+    "open": "^11.0.0",
+    "picocolors": "^1.1.1",
+    "picomatch": "^4.0.4",
+    "proper-lockfile": "^4.1.2",
+    "tar": "^7.5.13",
+    "typescript": "^6.0.3",
+    "ws": "^8.20.0",
+    "yaml": "^2.8.3",
+    "zx": "^8.8.5"
+  },
+  "peerDependencies": {
+    "@kici-dev/sdk": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/proper-lockfile": "^4.1.4"
   }
 }