@kici-dev/compiler 0.0.0 → 0.1.2

package/dist/commands/fixture.js

@@ -0,0 +1,104 @@
+import "../chunk-gOLHoazu.js";
+import { getDefaultFixture } from "../fixtures/defaults/index.js";
+import { detectRepoFromGit } from "../test-runner/git-detector.js";
+import { parseEventArg } from "../test-runner/event-types.js";
+import pc from "picocolors";
+import { writeFile } from "node:fs/promises";
+import { logger } from "@kici-dev/shared";
+//#region src/commands/fixture.ts
+/**
+* Fixture generation command
+*
+* Generates JSON fixture templates for all supported event types,
+* including internal events (schedule, lifecycle, generic_webhook, kici_event).
+*/
+/** Internal event types that don't have GitHub webhook fixture files */
+const INTERNAL_EVENT_TYPES = new Set([
+	"kici_event",
+	"workflow_complete",
+	"job_complete",
+	"generic_webhook",
+	"schedule",
+	"lifecycle"
+]);
+/**
+* Generate a fixture template for an internal event type.
+*/
+function generateInternalFixture(eventType) {
+	switch (eventType.type) {
+		case "schedule": return {
+			cronExpression: "cronExpression" in eventType && eventType.cronExpression ? eventType.cronExpression : "0 0 * * *",
+			timezone: "timezone" in eventType && eventType.timezone ? eventType.timezone : "UTC"
+		};
+		case "lifecycle": return {
+			lifecycleEvent: "lifecycleEvent" in eventType ? eventType.lifecycleEvent : "workflow_complete",
+			workflowName: "ci",
+			status: "success",
+			sourceRepo: "owner/repo"
+		};
+		case "kici_event": return {
+			eventName: "eventName" in eventType ? eventType.eventName : "test-event",
+			payload: { message: "Example payload" }
+		};
+		case "workflow_complete": return {
+			workflowName: "workflowName" in eventType ? eventType.workflowName : "ci",
+			status: "status" in eventType ? eventType.status : "success",
+			sourceRepo: "owner/repo"
+		};
+		case "job_complete": return {
+			workflowName: "workflowName" in eventType ? eventType.workflowName : "ci",
+			jobName: "jobName" in eventType ? eventType.jobName : "build",
+			status: "status" in eventType ? eventType.status : "success",
+			sourceRepo: "owner/repo"
+		};
+		case "generic_webhook": return {
+			source: "source" in eventType && eventType.source ? eventType.source : "external-service",
+			event: "invoice.paid",
+			payload: {
+				id: "evt_123",
+				type: "invoice.paid",
+				data: { object: {
+					id: "in_123",
+					amount_paid: 2e3,
+					currency: "usd"
+				} }
+			}
+		};
+		default: return {};
+	}
+}
+/**
+* Generate fixture template for event type
+*/
+async function fixtureCommand(event, options) {
+	try {
+		const eventType = parseEventArg(event);
+		let result;
+		if (INTERNAL_EVENT_TYPES.has(eventType.type)) result = generateInternalFixture(eventType);
+		else {
+			const fixture = getDefaultFixture(event);
+			const repoInfo = await detectRepoFromGit();
+			result = repoInfo && typeof fixture === "object" && fixture !== null ? {
+				...fixture,
+				repository: {
+					...fixture.repository,
+					owner: { login: repoInfo.owner },
+					name: repoInfo.name,
+					full_name: `${repoInfo.owner}/${repoInfo.name}`
+				}
+			} : fixture;
+		}
+		const json = JSON.stringify(result, null, 2);
+		if (options.output) {
+			await writeFile(options.output, json, "utf-8");
+			logger.info(pc.green(`Fixture written to ${options.output}`));
+		} else logger.info(json);
+	} catch (error) {
+		if (error instanceof Error) logger.error(pc.red(`Error: ${error.message}`));
+		throw error;
+	}
+}
+//#endregion
+export { fixtureCommand };
+
+//# sourceMappingURL=fixture.js.map

package/dist/commands/hook.d.ts

@@ -0,0 +1,20 @@
+/**
+ * kici hook command
+ *
+ * Install and manage pre-commit hooks for kici compile.
+ */
+/**
+ * Options for hook install command
+ */
+export interface HookInstallOptions {
+    /** Force raw git hook (ignore detected tools) */
+    git?: boolean;
+}
+/**
+ * Install pre-commit hook for kici compile.
+ *
+ * @param options - Command options
+ * @returns true on success, false on error
+ */
+export declare function hookInstallCommand(options?: HookInstallOptions): Promise<boolean>;
+//# sourceMappingURL=hook.d.ts.map

package/dist/commands/hook.js

@@ -0,0 +1,97 @@
+import "../chunk-gOLHoazu.js";
+import { detectHookTools, findGitDir } from "../hooks/detector.js";
+import { installHook } from "../hooks/installer.js";
+import "../hooks/index.js";
+import pc from "picocolors";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { logger, toErrorMessage } from "@kici-dev/shared";
+import { select } from "@inquirer/prompts";
+//#region src/commands/hook.ts
+/**
+* kici hook command
+*
+* Install and manage pre-commit hooks for kici compile.
+*/
+/**
+* Install pre-commit hook for kici compile.
+*
+* @param options - Command options
+* @returns true on success, false on error
+*/
+async function hookInstallCommand(options = {}) {
+	if (!await findGitDir()) {
+		logger.error(pc.red("Error: Not in a git repository."));
+		logger.error(pc.gray("Run this command from within a git repository."));
+		return false;
+	}
+	try {
+		let selectedTool;
+		if (options.git) selectedTool = "git";
+		else {
+			const tools = await detectHookTools();
+			if (tools.length === 0) if (process.stdout.isTTY && process.env.CI !== "true") {
+				const choice = await select({
+					message: "No pre-commit tool detected. How would you like to install the hook?",
+					choices: [{
+						name: "Raw git hook (.git/hooks/pre-commit)",
+						value: "git"
+					}, {
+						name: "Skip installation",
+						value: "skip"
+					}]
+				});
+				if (choice === "skip") {
+					logger.info(pc.yellow("Hook installation skipped."));
+					return true;
+				}
+				selectedTool = choice;
+			} else {
+				logger.info(pc.yellow("No pre-commit tool detected. Use --git to install raw git hook."));
+				return true;
+			}
+			else if (tools.length === 1) {
+				selectedTool = tools[0].name;
+				logger.info(pc.gray(`Detected ${selectedTool}, installing hook...`));
+			} else if (process.stdout.isTTY && process.env.CI !== "true") selectedTool = await select({
+				message: "Multiple pre-commit tools detected. Which would you like to use?",
+				choices: tools.map((t) => ({
+					name: t.name,
+					value: t.name
+				}))
+			});
+			else {
+				selectedTool = tools[0].name;
+				logger.info(pc.gray(`Using ${selectedTool} (highest priority)`));
+			}
+		}
+		const useVerdaccio = await detectVerdaccioNpmrc();
+		const result = await installHook(selectedTool, { useVerdaccio });
+		if (result.success) {
+			if (result.action === "skipped") logger.info(pc.yellow(`Already installed: ${result.message}`));
+			else logger.info(pc.green(`Hook installed: ${result.message}`));
+			return true;
+		} else {
+			logger.error(pc.red(`Error: ${result.message}`));
+			return false;
+		}
+	} catch (error) {
+		const message = toErrorMessage(error);
+		logger.error(pc.red(`Error: ${message}`));
+		return false;
+	}
+}
+/**
+* Detect if local Verdaccio is configured by checking for .kici/.npmrc
+*/
+async function detectVerdaccioNpmrc() {
+	try {
+		return (await readFile(path.resolve(".kici", ".npmrc"), "utf-8")).includes("verdaccio");
+	} catch {
+		return false;
+	}
+}
+//#endregion
+export { hookInstallCommand };
+
+//# sourceMappingURL=hook.js.map

package/dist/commands/index.d.ts

@@ -0,0 +1,33 @@
+export { compileCommand } from './compile.js';
+export type { CompileOptions } from './compile.js';
+export { watchCommand } from './watch.js';
+export { fixtureCommand } from './fixture.js';
+export type { FixtureOptions } from './fixture.js';
+export { testCommand, testDryRun } from './test.js';
+export type { TestOptions, RemoteRunOptions, RemoteRunResult } from './test.js';
+export { runLocalCommand, runRemoteCommand } from './run.js';
+export { initCommand } from './init.js';
+export type { InitOptions } from './init.js';
+export { hookInstallCommand } from './hook.js';
+export type { HookInstallOptions } from './hook.js';
+export { loginCommand } from './login.js';
+export type { LoginOptions } from './login.js';
+export { secretsListCommand } from './secrets-list.js';
+export type { SecretsListOptions } from './secrets-list.js';
+export { statusCommand } from './status.js';
+export type { StatusOptions } from './status.js';
+export { typesCommand } from './types.js';
+export type { TypesOptions } from './types.js';
+export { endpointsCommand } from './endpoints.js';
+export type { EndpointsOptions } from './endpoints.js';
+export { orgListCommand, orgUseCommand, orgCurrentCommand } from './org.js';
+export { logoutCommand } from './logout.js';
+export { cancelCommand } from './cancel.js';
+export type { CancelOptions } from './cancel.js';
+export { workflowsListCommand } from './workflows.js';
+export type { WorkflowsListOptions } from './workflows.js';
+export { drainWorkerCommand } from './drain-worker.js';
+export type { DrainWorkerOptions } from './drain-worker.js';
+export { docsCommand, docsLlmCommand } from './docs.js';
+export type { DocsOptions, DocsLlmOptions } from './docs.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.js

@@ -0,0 +1,20 @@
+import "../chunk-gOLHoazu.js";
+import { compileCommand } from "./compile.js";
+import { watchCommand } from "./watch.js";
+import { fixtureCommand } from "./fixture.js";
+import { testCommand, testDryRun } from "./test.js";
+import { runLocalCommand, runRemoteCommand } from "./run.js";
+import { initCommand } from "./init.js";
+import { hookInstallCommand } from "./hook.js";
+import { loginCommand } from "./login.js";
+import { secretsListCommand } from "./secrets-list.js";
+import { statusCommand } from "./status.js";
+import { typesCommand } from "./types.js";
+import { endpointsCommand } from "./endpoints.js";
+import { orgCurrentCommand, orgListCommand, orgUseCommand } from "./org.js";
+import { logoutCommand } from "./logout.js";
+import { cancelCommand } from "./cancel.js";
+import { workflowsListCommand } from "./workflows.js";
+import { drainWorkerCommand } from "./drain-worker.js";
+import { docsCommand, docsLlmCommand } from "./docs.js";
+export { cancelCommand, compileCommand, docsCommand, docsLlmCommand, drainWorkerCommand, endpointsCommand, fixtureCommand, hookInstallCommand, initCommand, loginCommand, logoutCommand, orgCurrentCommand, orgListCommand, orgUseCommand, runLocalCommand, runRemoteCommand, secretsListCommand, statusCommand, testCommand, testDryRun, typesCommand, watchCommand, workflowsListCommand };

package/dist/commands/init.d.ts

@@ -0,0 +1,35 @@
+/**
+ * kici init command
+ *
+ * Creates .kici/ directory structure with workflow templates.
+ * Supports TypeScript mode (with package.json/node_modules) and MJS mode (pure JS).
+ */
+/**
+ * Options for init command
+ */
+export interface InitOptions {
+    /** Overwrite existing .kici/ directory */
+    force?: boolean;
+    /** Skip npm install step */
+    skipInstall?: boolean;
+    /** JavaScript-only mode (no TypeScript, no dependencies) */
+    mjs?: boolean;
+    /** Write .npmrc pointing @kici-dev scope to local Verdaccio */
+    useVerdaccioLocal?: boolean;
+    /** Private registry URL to scaffold a `registries:` entry for. */
+    privateRegistry?: string;
+    /** Optional npm scope (e.g. `@my-org`) the private registry serves. */
+    privateRegistryScope?: string;
+    /** Qualified secret reference (`env:NAME`) the private registry token comes from. */
+    privateRegistrySecret?: string;
+    /** Skip writing the .kici/AGENTS.md LLM-authoring context file. Default: write it. */
+    noAgentsMd?: boolean;
+}
+/**
+ * Initialize .kici/ directory with workflow templates
+ *
+ * @param options - Configuration options for initialization
+ * @returns true on success, false on error
+ */
+export declare function initCommand(options?: InitOptions): Promise<boolean>;
+//# sourceMappingURL=init.d.ts.map