@kitsi/cli 0.0.1

package/dist/dsl/utils.d.ts

@@ -0,0 +1,2 @@
+export declare const resolveWorkspace: (workspace?: string) => string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/dsl/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/dsl/utils.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,GAAI,YAAY,MAAM,KAAG,MAGrD,CAAC"}

package/dist/dsl/utils.js

@@ -0,0 +1,7 @@
+import { resolve as resolvePath } from 'node:path';
+export const resolveWorkspace = (workspace) => {
+    if (!workspace)
+        return process.cwd();
+    return workspace.startsWith('.') ? resolvePath(process.cwd(), workspace) : workspace;
+};
+//# sourceMappingURL=utils.js.map

package/dist/dsl/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/dsl/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AAEnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,SAAkB,EAAU,EAAE;IAC7D,IAAI,CAAC,SAAS;QAAE,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;IACrC,OAAO,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACvF,CAAC,CAAC"}

package/dist/engine/cache/analyze.d.ts

@@ -0,0 +1,12 @@
+import type { TaskBuilder } from '../../dsl/task.js';
+export interface TaskAnalysis {
+    ops: unknown[];
+    inputs: Set<string>;
+    commandSignatures: string[];
+    dependencies: Set<string>;
+    secrets: Set<string>;
+    params: Set<string>;
+    dynamic: boolean;
+}
+export declare const analyzeTaskSteps: (task: TaskBuilder, workspace: string) => TaskAnalysis;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/engine/cache/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../src/engine/cache/analyze.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAiBrD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,OAAO,EAAE,CAAC;IACf,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAmPD,eAAO,MAAM,gBAAgB,GAAI,MAAM,WAAW,EAAE,WAAW,MAAM,KAAG,YAWvE,CAAC"}

package/dist/engine/cache/analyze.js

@@ -0,0 +1,225 @@
+import { isParamRef, isSecretRef, isValueRef } from '../../ops/types.js';
+import { stableStringify } from './serialize.js';
+const createPlaceholderTracker = () => {
+    let touched = false;
+    const placeholder = new Proxy(() => undefined, {
+        get: () => mark(),
+        apply: () => mark(),
+        construct: () => mark(),
+    });
+    Object.defineProperty(placeholder, Symbol.toPrimitive, {
+        value: () => {
+            touched = true;
+            return '';
+        },
+    });
+    const mark = () => {
+        touched = true;
+        return placeholder;
+    };
+    return {
+        value: placeholder,
+        used: () => touched,
+    };
+};
+const toOp = (value) => {
+    if (value instanceof Object && 'op' in value) {
+        const maybeOp = value.op;
+        if (maybeOp && typeof maybeOp === 'object' && 'kind' in maybeOp) {
+            return maybeOp;
+        }
+    }
+    return value;
+};
+const normalizeTemplatePart = (part) => {
+    if (part.type === 'text' || part.type === 'interpolated') {
+        return { type: part.type, value: part.value };
+    }
+    if (part.type === 'secret') {
+        return { type: part.type, name: part.name };
+    }
+    return { type: part.type, name: part.ref.name };
+};
+const commandSignature = (template) => {
+    const raw = template
+        .map((part) => {
+        if (part.type === 'text')
+            return part.value;
+        if (part.type === 'interpolated')
+            return String(part.value);
+        if (part.type === 'secret')
+            return `<secret:${part.name}>`;
+        if (part.type === 'param')
+            return `<param:${part.ref.name}>`;
+        return `<value:${part.ref.name}>`;
+    })
+        .join('');
+    return raw.replace(/\s+/g, ' ').trim();
+};
+const collectFromTemplate = (template, secrets, params) => {
+    for (const part of template) {
+        if (part.type === 'secret')
+            secrets.add(part.name);
+        if (part.type === 'param')
+            params.add(part.ref.name);
+    }
+};
+const collectEnvValue = (value, secrets, params) => {
+    if (typeof value === 'string' || typeof value === 'number')
+        return;
+    if (isSecretRef(value))
+        secrets.add(value.name);
+    if (isParamRef(value))
+        params.add(value.name);
+};
+const normalizeEnvValue = (value) => {
+    if (typeof value === 'string' || typeof value === 'number')
+        return value;
+    if (isSecretRef(value))
+        return { kind: 'secret', name: value.name };
+    if (isParamRef(value))
+        return { kind: 'param', name: value.name };
+    if (isValueRef(value))
+        return { kind: 'value', name: value.name };
+    return String(value);
+};
+const normalizeOp = (op, ctx, analysis, tracker, resultValue) => {
+    switch (op.kind) {
+        case 'command': {
+            const commandOp = op;
+            analysis.commandSignatures.push(commandSignature(commandOp.template));
+            collectFromTemplate(commandOp.template, analysis.secrets, analysis.params);
+            return {
+                kind: op.kind,
+                capture: commandOp.capture,
+                cache: commandOp.cache ?? null,
+                template: commandOp.template.map(normalizeTemplatePart),
+            };
+        }
+        case 'emit': {
+            const emitOp = op;
+            return { kind: op.kind, ref: emitOp.ref.name, value: emitOp.value };
+        }
+        case 'use': {
+            const useOp = op;
+            analysis.dependencies.add(useOp.from.config.name);
+            return { kind: op.kind, from: useOp.from.config.name, ref: useOp.ref.name };
+        }
+        case 'pack': {
+            const packOp = op;
+            return { kind: op.kind, name: packOp.ref.name, patterns: packOp.ref.patterns };
+        }
+        case 'unpack': {
+            const unpackOp = op;
+            analysis.dependencies.add(unpackOp.from.config.name);
+            return {
+                kind: op.kind,
+                from: unpackOp.from.config.name,
+                name: unpackOp.ref.name,
+                patterns: unpackOp.ref.patterns,
+            };
+        }
+        case 'env': {
+            const envOp = op;
+            collectEnvValue(envOp.value, analysis.secrets, analysis.params);
+            return { kind: op.kind, name: envOp.name, value: normalizeEnvValue(envOp.value) };
+        }
+        case 'summary': {
+            const summaryOp = op;
+            return { kind: op.kind, format: summaryOp.format, content: summaryOp.content };
+        }
+        case 'artifact-upload': {
+            const uploadOp = op;
+            return {
+                kind: op.kind,
+                name: uploadOp.name,
+                patterns: uploadOp.patterns,
+                when: uploadOp.when,
+            };
+        }
+        case 'artifact-download': {
+            const downloadOp = op;
+            return { kind: op.kind, name: downloadOp.name, destination: downloadOp.destination };
+        }
+        case 'annotate': {
+            const annotateOp = op;
+            return { kind: op.kind, level: annotateOp.level, message: annotateOp.message };
+        }
+        case 'report': {
+            const reportOp = op;
+            return { kind: op.kind, reportType: reportOp.reportType, path: reportOp.path };
+        }
+        case 'bind-service': {
+            const bindOp = op;
+            return { kind: op.kind, service: bindOp.service, alias: bindOp.alias ?? null };
+        }
+        case 'cache': {
+            const cacheOp = op;
+            return { kind: op.kind, name: cacheOp.name, paths: cacheOp.paths, key: cacheOp.key ?? null };
+        }
+        case 'cache-or': {
+            const cacheOrOp = op;
+            const computeOps = analyzeGenerator(cacheOrOp.compute(ctx), ctx, analysis, tracker, resultValue);
+            return {
+                kind: op.kind,
+                name: cacheOrOp.name,
+                paths: cacheOrOp.paths,
+                key: cacheOrOp.key ?? null,
+                compute: computeOps,
+            };
+        }
+        default:
+            return { kind: op.kind };
+    }
+};
+const analyzeGenerator = (iterator, ctx, analysis, tracker, resultValue) => {
+    const ops = [];
+    let cursor = iterator.next();
+    while (!cursor.done) {
+        const op = toOp(cursor.value);
+        ops.push(normalizeOp(op, ctx, analysis, tracker, resultValue));
+        cursor = iterator.next(resultValue);
+    }
+    return ops;
+};
+const runAnalysis = (task, workspace, tracker) => {
+    const analysis = {
+        ops: [],
+        inputs: new Set(),
+        commandSignatures: [],
+        dependencies: new Set(),
+        secrets: new Set(),
+        params: new Set(),
+        dynamic: false,
+    };
+    const ctx = { task, workspace };
+    const steps = [...task.config.setupSteps, ...task.config.steps];
+    for (const step of steps) {
+        for (const pattern of step.inputPatterns) {
+            analysis.inputs.add(pattern);
+        }
+        try {
+            const iterator = step.run(ctx);
+            analysis.ops.push(...analyzeGenerator(iterator, ctx, analysis, tracker, tracker.value));
+        }
+        catch {
+            analysis.dynamic = true;
+            return { analysis, failed: true };
+        }
+    }
+    analysis.dynamic = tracker.used();
+    return { analysis, failed: false };
+};
+export const analyzeTaskSteps = (task, workspace) => {
+    const primaryTracker = createPlaceholderTracker();
+    const primary = runAnalysis(task, workspace, primaryTracker);
+    if (primary.failed)
+        return primary.analysis;
+    const secondaryTracker = { value: undefined, used: () => false };
+    const secondary = runAnalysis(task, workspace, secondaryTracker);
+    const opsDiffer = secondary.failed ||
+        stableStringify(primary.analysis.ops) !== stableStringify(secondary.analysis.ops);
+    primary.analysis.dynamic = primary.analysis.dynamic || opsDiffer;
+    return primary.analysis;
+};
+//# sourceMappingURL=analyze.js.map

package/dist/engine/cache/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../../src/engine/cache/analyze.ts"],"names":[],"mappings":"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"}

package/dist/engine/cache/coordinator.d.ts

@@ -0,0 +1,99 @@
+import { StepBuilder } from '../../dsl/step.js';
+import type { TaskBuilder } from '../../dsl/task.js';
+import type { Op } from '../../ops/base.js';
+import type { CacheSettings, Logger, Reporter, TaskResult, TaskState } from '../executor/types.js';
+import type { ValueResolver } from '../executor/value-resolver.js';
+import type { ExecutionContext } from '../handlers/handler.js';
+interface TaskCacheDecision {
+    key: string;
+    cacheable: boolean;
+    hit?: boolean;
+    reason?: string;
+    components: Record<string, string>;
+    inputs: {
+        patterns: string[];
+        files: Record<string, string>;
+    };
+    outputPatterns: string[];
+    ttlMs?: number | null;
+}
+interface CacheExecutionResult {
+    handled: true;
+    value: unknown;
+}
+type ExecuteOpFn = (op: Op, task: TaskBuilder, step: StepBuilder, env: Record<string, string>, state: TaskState) => Promise<unknown>;
+export interface CacheCoordinatorOptions {
+    workspace: string;
+    settings?: CacheSettings;
+    logger: Logger;
+    reporter?: Reporter;
+    resolver: ValueResolver;
+    params: Record<string, unknown>;
+    getTaskState: (name: string) => TaskState | undefined;
+    findTask: (name: string) => TaskBuilder | undefined;
+    executeTask: (task: TaskBuilder) => Promise<TaskResult>;
+}
+export declare class CacheCoordinator {
+    private readonly workspace;
+    private readonly settings;
+    private readonly logger;
+    private readonly reporter;
+    private readonly resolver;
+    private readonly params;
+    private readonly getTaskState;
+    private readonly findTask;
+    private readonly executeTask;
+    private readonly cacheStore;
+    private readonly pendingOpSaves;
+    private readonly taskCacheState;
+    constructor(opts: CacheCoordinatorOptions);
+    beforeTask(task: TaskBuilder, env: Record<string, string>, state: TaskState): Promise<TaskCacheDecision | null>;
+    afterStep(task: TaskBuilder): Promise<void>;
+    afterTask(task: TaskBuilder, state: TaskState, decision: TaskCacheDecision | null): Promise<void>;
+    tryExecuteOp(op: Op, task: TaskBuilder, context: ExecutionContext, state: TaskState, executeBaseOp: (op: Op) => Promise<unknown>, executeOp: ExecuteOpFn): Promise<CacheExecutionResult | null>;
+    wasTaskCached(taskName: string): boolean;
+    private shouldAttemptTaskCache;
+    private cacheAllowedForTask;
+    private cacheExcludes;
+    private ensureCacheStore;
+    private handleCacheDisabled;
+    private handleUncacheableDecision;
+    private tryRestoreTaskCache;
+    private restoreTaskCacheEntry;
+    private flushPendingOpSaves;
+    private recordTaskCacheState;
+    private computeTaskCacheDecision;
+    private collectTaskInputPatterns;
+    private resolveTaskInputs;
+    private hashCacheEnv;
+    private buildCacheBust;
+    private collectTaskRefs;
+    private collectSecretEnvNames;
+    private hashParams;
+    private hashEnvConfig;
+    private hashDependencies;
+    private collectDependencyNames;
+    private resolveDependencyFingerprint;
+    private computeStateFingerprint;
+    private cacheVersion;
+    private resolveTtl;
+    private parseDuration;
+    private executeCacheOp;
+    private executeCacheOrOp;
+    private executeCachedCommand;
+    private executeInline;
+    private toOp;
+    private computeCacheOpDecision;
+    private saveCacheOpSnapshot;
+    private computeCommandCacheDecision;
+    private normalizeCommandTemplate;
+    private resolveCommandOutputs;
+    private resolveCommandInputs;
+    private hashCommandEnv;
+    private shouldCacheCommandResult;
+    private emitCacheDebug;
+    private diffInputFiles;
+    private enqueuePendingSave;
+}
+export {};
+//# sourceMappingURL=coordinator.d.ts.map

package/dist/engine/cache/coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../../src/engine/cache/coordinator.ts"],"names":[],"mappings":"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"}