opencastle 0.26.1 → 0.27.1

package/dist/cli/convoy/formula.js

@@ -0,0 +1,142 @@
+import { readFileSync } from 'node:fs';
+import { parse as yamlParse, stringify as yamlStringify } from 'yaml';
+import { parseTaskSpecText } from '../run/schema.js';
+export class FormulaValidationError extends Error {
+    missingVariables;
+    constructor(missingVariables) {
+        super(`Missing required formula variables: ${missingVariables.join(', ')}`);
+        this.name = 'FormulaValidationError';
+        this.missingVariables = missingVariables;
+    }
+}
+// Matches {{varname}} and {{varname | filter}} with optional whitespace
+const PLACEHOLDER_RE = /\{\{(\s*\w+\s*(?:\|\s*\w+\s*)?)\}\}/g;
+function toKebab(value) {
+    return value
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .replace(/[\s_]+/g, '-')
+        .toLowerCase();
+}
+function toSnake(value) {
+    return value
+        .replace(/([a-z])([A-Z])/g, '$1_$2')
+        .replace(/[\s-]+/g, '_')
+        .toLowerCase();
+}
+function toUpper(value) {
+    return value
+        .replace(/[\s-]+/g, '_')
+        .toUpperCase();
+}
+export function parseFormula(templatePath) {
+    let raw;
+    try {
+        raw = readFileSync(templatePath, 'utf8');
+    }
+    catch (err) {
+        throw new Error(`Cannot read formula file: ${err.message}`);
+    }
+    let parsed;
+    try {
+        parsed = yamlParse(raw);
+    }
+    catch (err) {
+        throw new Error(`Formula YAML parse error: ${err.message}`);
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error('Formula file must be a YAML mapping');
+    }
+    const obj = parsed;
+    if (!obj.name || typeof obj.name !== 'string') {
+        throw new Error('Formula template must have a "name" field');
+    }
+    if (obj.spec === undefined || obj.spec === null) {
+        throw new Error('Formula template must have a "spec" field');
+    }
+    const variables = {};
+    if (obj.variables && typeof obj.variables === 'object' && !Array.isArray(obj.variables)) {
+        for (const [key, val] of Object.entries(obj.variables)) {
+            if (!val || typeof val !== 'object' || Array.isArray(val))
+                continue;
+            const v = val;
+            variables[key] = {
+                description: typeof v.description === 'string' ? v.description : undefined,
+                required: v.required === true,
+                default: typeof v.default === 'string' ? v.default : undefined,
+            };
+        }
+    }
+    return {
+        name: obj.name,
+        description: typeof obj.description === 'string' ? obj.description : undefined,
+        variables,
+        spec: obj.spec,
+    };
+}
+export function substituteVariables(template, vars) {
+    const specYaml = yamlStringify(template.spec);
+    const missing = [];
+    const result = specYaml.replace(PLACEHOLDER_RE, (match, inner) => {
+        const parts = inner.split('|').map((p) => p.trim());
+        const varName = parts[0];
+        const filter = parts[1] ?? null;
+        let value;
+        if (varName in vars) {
+            value = vars[varName];
+        }
+        else if (varName in template.variables) {
+            const def = template.variables[varName];
+            if (def.required) {
+                missing.push(varName);
+                return match; // keep placeholder; collect all missing vars
+            }
+            value = def.default ?? '';
+        }
+        else {
+            value = '';
+        }
+        if (filter === 'kebab')
+            return toKebab(value);
+        if (filter === 'snake')
+            return toSnake(value);
+        if (filter === 'upper')
+            return toUpper(value);
+        return value;
+    });
+    if (missing.length > 0) {
+        throw new FormulaValidationError(missing);
+    }
+    return parseTaskSpecText(result);
+}
+export function validateTemplate(template) {
+    const errors = [];
+    const VALID_IDENTIFIER = /^[a-zA-Z0-9_]+$/;
+    if (!template.name || typeof template.name !== 'string') {
+        errors.push('"name" field is required');
+    }
+    if (template.spec === undefined || template.spec === null) {
+        errors.push('"spec" field is required');
+    }
+    for (const key of Object.keys(template.variables)) {
+        if (!VALID_IDENTIFIER.test(key)) {
+            errors.push(`Variable name "${key}" is not a valid identifier (alphanumeric + underscore only)`);
+        }
+    }
+    // Warn on undeclared {{variable}} placeholders in spec
+    if (template.spec !== undefined && template.spec !== null) {
+        try {
+            const specYaml = yamlStringify(template.spec);
+            for (const match of specYaml.matchAll(PLACEHOLDER_RE)) {
+                const varName = match[1].split('|')[0].trim();
+                if (!(varName in template.variables)) {
+                    process.stderr.write(`Warning: template contains undeclared placeholder "{{${varName}}}"\n`);
+                }
+            }
+        }
+        catch {
+            // If stringify fails, skip placeholder checking
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=formula.js.map

package/dist/cli/convoy/formula.js.map

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

package/dist/cli/convoy/formula.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=formula.test.d.ts.map

package/dist/cli/convoy/formula.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formula.test.d.ts","sourceRoot":"","sources":["../../../src/cli/convoy/formula.test.ts"],"names":[],"mappings":""}

package/dist/cli/convoy/formula.test.js

@@ -0,0 +1,342 @@
+import { mkdtempSync, rmSync, realpathSync, writeFileSync, } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { parseFormula, substituteVariables, validateTemplate, FormulaValidationError, } from './formula.js';
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function makeBase() {
+    return realpathSync(mkdtempSync(join(tmpdir(), 'formula-test-')));
+}
+/**
+ * Minimal valid TaskSpec content for use in formula `spec:` sections.
+ * After substitution, this must pass parseTaskSpecText validation.
+ */
+const MINIMAL_SPEC = {
+    name: 'Test convoy',
+    version: 1,
+    tasks: [{ id: 'task-1', prompt: 'Do the thing' }],
+};
+function writeFormula(dir, content) {
+    const path = join(dir, 'formula.convoy.yml');
+    writeFileSync(path, content);
+    return path;
+}
+let tmpDir;
+beforeEach(() => {
+    tmpDir = makeBase();
+});
+afterEach(() => {
+    rmSync(tmpDir, { recursive: true, force: true });
+});
+// ── parseFormula ──────────────────────────────────────────────────────────────
+describe('parseFormula', () => {
+    it('reads a formula file and returns a FormulaTemplate', () => {
+        const path = writeFormula(tmpDir, [
+            'name: My Formula',
+            'description: A test formula',
+            'variables:',
+            '  app_name:',
+            '    description: App name',
+            '    required: true',
+            'spec:',
+            '  name: Test convoy',
+            '  version: 1',
+            '  tasks:',
+            '    - id: task-1',
+            '      prompt: Do the thing',
+        ].join('\n'));
+        const template = parseFormula(path);
+        expect(template.name).toBe('My Formula');
+        expect(template.description).toBe('A test formula');
+        expect(template.variables['app_name']).toMatchObject({ required: true });
+        expect(template.spec).toBeTruthy();
+    });
+    it('throws when file does not exist', () => {
+        expect(() => parseFormula(join(tmpDir, 'missing.yml'))).toThrow(/Cannot read formula file/);
+    });
+    it('throws on invalid YAML', () => {
+        const path = writeFormula(tmpDir, ': {{{');
+        expect(() => parseFormula(path)).toThrow(/Formula YAML parse error/);
+    });
+    it('throws when name field is missing', () => {
+        const path = writeFormula(tmpDir, 'spec:\n  name: Test convoy\n  version: 1\n  tasks:\n    - id: t1\n      prompt: p\n');
+        expect(() => parseFormula(path)).toThrow(/must have a "name" field/);
+    });
+    it('throws when spec field is missing', () => {
+        const path = writeFormula(tmpDir, 'name: My Formula\n');
+        expect(() => parseFormula(path)).toThrow(/must have a "spec" field/);
+    });
+    it('returns empty variables when no variables section', () => {
+        const path = writeFormula(tmpDir, 'name: Simple\nspec:\n  name: Test\n  version: 1\n  tasks:\n    - id: t1\n      prompt: p\n');
+        const template = parseFormula(path);
+        expect(template.variables).toEqual({});
+    });
+    it('parses optional flag and default value', () => {
+        const path = writeFormula(tmpDir, [
+            'name: With defaults',
+            'variables:',
+            '  env:',
+            '    required: false',
+            '    default: staging',
+            'spec:',
+            '  name: Test',
+            '  version: 1',
+            '  tasks:',
+            '    - id: t1',
+            '      prompt: p',
+        ].join('\n'));
+        const template = parseFormula(path);
+        expect(template.variables['env']).toMatchObject({ required: false, default: 'staging' });
+    });
+});
+// ── substituteVariables ───────────────────────────────────────────────────────
+describe('substituteVariables', () => {
+    function makeTemplate(overrides = {}) {
+        return {
+            name: 'Test Formula',
+            variables: {},
+            spec: MINIMAL_SPEC,
+            ...overrides,
+        };
+    }
+    it('substitutes a plain variable', () => {
+        const template = makeTemplate({
+            variables: { feature: { required: true } },
+            spec: {
+                name: '{{feature}}',
+                version: 1,
+                tasks: [{ id: 'task-1', prompt: 'Build {{feature}}' }],
+            },
+        });
+        const result = substituteVariables(template, { feature: 'auth' });
+        expect(result.name).toBe('auth');
+    });
+    it('applies kebab filter', () => {
+        const template = makeTemplate({
+            variables: { feature: { required: true } },
+            spec: {
+                name: 'test',
+                version: 1,
+                tasks: [{ id: 'task-1', prompt: '{{feature | kebab}}' }],
+            },
+        });
+        const result = substituteVariables(template, { feature: 'MyFeature Name' });
+        expect(result.tasks[0].prompt).toContain('my-feature-name');
+    });
+    it('applies snake filter', () => {
+        const template = makeTemplate({
+            variables: { feature: { required: true } },
+            spec: {
+                name: 'test',
+                version: 1,
+                tasks: [{ id: 'task-1', prompt: '{{feature | snake}}' }],
+            },
+        });
+        const result = substituteVariables(template, { feature: 'MyFeature Name' });
+        expect(result.tasks[0].prompt).toContain('my_feature_name');
+    });
+    it('applies upper filter', () => {
+        const template = makeTemplate({
+            variables: { feature: { required: true } },
+            spec: {
+                name: 'test',
+                version: 1,
+                tasks: [{ id: 'task-1', prompt: '{{feature | upper}}' }],
+            },
+        });
+        const result = substituteVariables(template, { feature: 'my feature' });
+        expect(result.tasks[0].prompt).toContain('MY_FEATURE');
+    });
+    it('throws FormulaValidationError for missing required variable', () => {
+        const template = makeTemplate({
+            variables: { required_var: { required: true } },
+            spec: {
+                name: 'test',
+                version: 1,
+                tasks: [{ id: 'task-1', prompt: '{{required_var}}' }],
+            },
+        });
+        expect(() => substituteVariables(template, {})).toThrow(FormulaValidationError);
+    });
+    it('includes missing variable name in FormulaValidationError', () => {
+        const template = makeTemplate({
+            variables: { missing_var: { required: true } },
+            spec: {
+                name: 'test',
+                version: 1,
+                tasks: [{ id: 'task-1', prompt: '{{missing_var}}' }],
+            },
+        });
+        let err;
+        try {
+            substituteVariables(template, {});
+        }
+        catch (e) {
+            if (e instanceof FormulaValidationError)
+                err = e;
+        }
+        expect(err).toBeDefined();
+        expect(err.missingVariables).toContain('missing_var');
+    });
+    it('collects all missing required variables', () => {
+        const template = makeTemplate({
+            variables: {
+                var_a: { required: true },
+                var_b: { required: true },
+            },
+            spec: {
+                name: 'test',
+                version: 1,
+                tasks: [{ id: 'task-1', prompt: '{{var_a}} and {{var_b}}' }],
+            },
+        });
+        let err;
+        try {
+            substituteVariables(template, {});
+        }
+        catch (e) {
+            if (e instanceof FormulaValidationError)
+                err = e;
+        }
+        expect(err.missingVariables).toEqual(expect.arrayContaining(['var_a', 'var_b']));
+    });
+    it('uses default value for optional variable without provided value', () => {
+        const template = makeTemplate({
+            variables: { env: { required: false, default: 'production' } },
+            spec: {
+                name: 'test',
+                version: 1,
+                tasks: [{ id: 'task-1', prompt: 'Deploy to {{env}}' }],
+            },
+        });
+        const result = substituteVariables(template, {});
+        expect(result.tasks[0].prompt).toContain('production');
+    });
+    it('uses empty string for optional variable with no default', () => {
+        const template = makeTemplate({
+            variables: { opt: { required: false } },
+            spec: {
+                name: 'test-task',
+                version: 1,
+                tasks: [{ id: 'task-1', prompt: 'prefix-{{opt}}-suffix' }],
+            },
+        });
+        const result = substituteVariables(template, {});
+        expect(result.tasks[0].prompt).toContain('prefix--suffix');
+    });
+    it('returns a valid TaskSpec', () => {
+        const template = makeTemplate({
+            variables: { app: { required: true } },
+            spec: {
+                name: 'Deploy {{app}}',
+                version: 1,
+                tasks: [{ id: 'task-1', prompt: 'Deploy {{app}}' }],
+            },
+        });
+        const result = substituteVariables(template, { app: 'myapp' });
+        expect(result).toMatchObject({ name: expect.any(String) });
+        expect(Array.isArray(result.tasks)).toBe(true);
+    });
+});
+// ── validateTemplate ──────────────────────────────────────────────────────────
+describe('validateTemplate', () => {
+    function makeTemplate(overrides = {}) {
+        return {
+            name: 'Valid Template',
+            variables: {},
+            spec: MINIMAL_SPEC,
+            ...overrides,
+        };
+    }
+    it('returns valid for a correct template', () => {
+        const result = validateTemplate(makeTemplate());
+        expect(result.valid).toBe(true);
+        expect(result.errors).toHaveLength(0);
+    });
+    it('returns error when name is missing', () => {
+        const template = makeTemplate({ name: '' });
+        const result = validateTemplate(template);
+        expect(result.valid).toBe(false);
+        expect(result.errors.some(e => e.includes('"name"'))).toBe(true);
+    });
+    it('returns error when spec is null', () => {
+        const template = makeTemplate({ spec: null });
+        const result = validateTemplate(template);
+        expect(result.valid).toBe(false);
+        expect(result.errors.some(e => e.includes('"spec"'))).toBe(true);
+    });
+    it('returns error for invalid variable identifier', () => {
+        const template = makeTemplate({
+            variables: { 'invalid-name': { required: false } },
+        });
+        const result = validateTemplate(template);
+        expect(result.valid).toBe(false);
+        expect(result.errors.some(e => e.includes('invalid-name'))).toBe(true);
+    });
+    it('allows valid variable identifiers', () => {
+        const template = makeTemplate({
+            variables: {
+                app_name: { required: true },
+                env2: { required: false },
+                MY_VAR: { required: false },
+            },
+        });
+        const result = validateTemplate(template);
+        expect(result.valid).toBe(true);
+    });
+    it('writes a warning for undeclared placeholder', () => {
+        const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        const template = makeTemplate({
+            variables: {},
+            spec: {
+                name: 'test',
+                version: 1,
+                tasks: [{ id: 'task-1', prompt: 'Do {{undeclared_var}}' }],
+            },
+        });
+        validateTemplate(template);
+        expect(stderrSpy).toHaveBeenCalledWith(expect.stringContaining('undeclared_var'));
+        stderrSpy.mockRestore();
+    });
+    it('does not warn for declared placeholders', () => {
+        const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        const template = makeTemplate({
+            variables: { declared_var: { required: true } },
+            spec: {
+                name: 'test',
+                version: 1,
+                tasks: [{ id: 'task-1', prompt: 'Do {{declared_var}}' }],
+            },
+        });
+        validateTemplate(template);
+        expect(stderrSpy).not.toHaveBeenCalled();
+        stderrSpy.mockRestore();
+    });
+});
+// ── Filter helpers ────────────────────────────────────────────────────────────
+describe('filter conversions via substituteVariables', () => {
+    function makeFilterTemplate(filter) {
+        return {
+            name: 'Filter Test',
+            variables: { val: { required: true } },
+            spec: {
+                name: `{{val | ${filter}}}`,
+                version: 1,
+                tasks: [{ id: 'task-1', prompt: 'x' }],
+            },
+        };
+    }
+    it('kebab: converts spaces and underscores to hyphens, lowercases', () => {
+        const result = substituteVariables(makeFilterTemplate('kebab'), { val: 'Hello World_Test' });
+        expect(result.name).toBe('hello-world-test');
+    });
+    it('snake: converts spaces and hyphens to underscores, lowercases', () => {
+        const result = substituteVariables(makeFilterTemplate('snake'), { val: 'Hello World-Test' });
+        expect(result.name).toBe('hello_world_test');
+    });
+    it('upper: converts to uppercase with underscores', () => {
+        const result = substituteVariables(makeFilterTemplate('upper'), { val: 'hello world' });
+        expect(result.name).toBe('HELLO_WORLD');
+    });
+});
+//# sourceMappingURL=formula.test.js.map

package/dist/cli/convoy/formula.test.js.map

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

package/dist/cli/convoy/gates.d.ts

@@ -0,0 +1,128 @@
+import type { BrowserTestConfig, MCPServerConfig } from './types.js';
+export interface SecretScanResult {
+    clean: boolean;
+    findings: Array<{
+        pattern: string;
+        file: string;
+        line: number;
+        snippet: string;
+    }>;
+}
+/** The config path used for the allowlist. Override for testing. */
+export declare let _allowlistConfigPath: string;
+/** Reset the allowlist cache (for testing). */
+export declare function _resetAllowlistCache(): void;
+/** Override the allowlist config path and reset cache (for testing). */
+export declare function _setAllowlistConfigPath(path: string): void;
+/**
+ * Scan text content line-by-line for secrets using the default pattern set.
+ * Allowlist entries in `.opencastle/secret-scan-config.yml` suppress false positives.
+ */
+export declare function scanForSecrets(content: string, filePath?: string): SecretScanResult;
+/**
+ * Guard a write action with a secret scan.
+ * Calls `writeAction` if content is clean; calls `onBlock` with findings otherwise.
+ */
+export declare function withSecretScan(content: string, writeAction: () => void, onBlock: (findings: SecretScanResult['findings']) => void): void;
+export interface GateCommandResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    timedOut: boolean;
+}
+/**
+ * Run a shell command with SIGTERM → SIGKILL timeout escalation.
+ * On timeout: sends SIGTERM immediately, then SIGKILL after 5 s if still running.
+ */
+export declare function runGateCommand(command: string, args: string[], cwd: string, timeoutMs?: number): Promise<GateCommandResult>;
+/** Scan a list of changed files in the worktree for secrets. */
+export declare function runSecretScanGate(changedFiles: string[], worktreePath: string): Promise<{
+    passed: boolean;
+    output: string;
+}>;
+/**
+ * Analyze a git diff for blast radius.
+ * WARN at 200+ lines OR 5+ files; BLOCK at 500+ lines OR 10+ files.
+ */
+export declare function runBlastRadiusGate(diff: string): {
+    passed: boolean;
+    output: string;
+    level: 'ok' | 'warn' | 'block';
+};
+/** Run npm audit in the worktree to detect high/critical vulnerabilities. */
+export declare function runDependencyAuditGate(worktreePath: string): Promise<{
+    passed: boolean;
+    output: string;
+}>;
+/** Run the test suite in the worktree directory. */
+export declare function runRegressionTestGate(worktreePath: string, testCommand?: string): Promise<{
+    passed: boolean;
+    output: string;
+}>;
+/**
+ * Compare two PNG buffers pixel-by-pixel and return the fraction (0–1) of differing pixels.
+ * Returns 1.0 if dimensions differ, buffers are invalid, or an error occurs.
+ */
+export declare function pixelDiffPercentage(baselineBuffer: Buffer, currentBuffer: Buffer): number;
+export interface VisualDiffContext {
+    screenshotBuffer: Buffer;
+    baselinePath: string;
+    threshold: number;
+}
+export interface VisualDiffResult {
+    passed: boolean;
+    diffPercent: number;
+    output: string;
+}
+/** Compare a screenshot buffer against a saved baseline PNG. */
+export declare function computeVisualDiff(context: VisualDiffContext): Promise<VisualDiffResult>;
+/**
+ * Persist a screenshot buffer as a PNG baseline file.
+ * Secret-scans the buffer (as base64) before writing.
+ */
+export declare function captureAndPersistBaseline(screenshotBuffer: Buffer, slug: string, basePath?: string): {
+    persisted: boolean;
+    reason?: string;
+};
+export type A11ySeverity = 'critical' | 'serious' | 'moderate' | 'minor';
+export interface A11yFinding {
+    id: string;
+    impact: A11ySeverity;
+    description: string;
+    nodes: number;
+}
+/**
+ * Map a list of a11y findings against a severity threshold.
+ * Returns passed:false if any finding meets or exceeds the threshold.
+ */
+export declare function mapA11ySeverity(findings: A11yFinding[], threshold: A11ySeverity): {
+    passed: boolean;
+    output: string;
+    findings: A11yFinding[];
+};
+export interface A11yAuditContext {
+    mcpServers: MCPServerConfig[];
+    url: string;
+    severityThreshold: A11ySeverity;
+}
+/** Run an a11y audit via a browser-capable MCP server. */
+export declare function runA11yAudit(context: A11yAuditContext): Promise<{
+    passed: boolean;
+    output: string;
+    findings: A11yFinding[];
+}>;
+export interface BrowserTestContext {
+    mcpServers: MCPServerConfig[];
+    taskConfig: BrowserTestConfig;
+    worktreePath: string;
+    approvalTimeout?: number;
+}
+/**
+ * Run browser-based tests against localhost URLs using an MCP browser server.
+ * All URLs are validated to be local addresses (SSRF prevention).
+ */
+export declare function browserTestGate(context: BrowserTestContext): Promise<{
+    passed: boolean;
+    output: string;
+}>;
+//# sourceMappingURL=gates.d.ts.map

package/dist/cli/convoy/gates.d.ts.map

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