@alevental/cccp 0.1.0

package/dist/config.js

@@ -0,0 +1,76 @@
+import { readFile } from "node:fs/promises";
+import { resolve, dirname } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { z } from "zod";
+// ---------------------------------------------------------------------------
+// Zod schema for cccp.yaml
+// ---------------------------------------------------------------------------
+const McpServerSchema = z.object({
+    command: z.string(),
+    args: z.array(z.string()).optional(),
+    env: z.record(z.string()).optional(),
+});
+const McpProfileSchema = z.object({
+    extends: z.string().optional(),
+    servers: z.record(McpServerSchema).optional(),
+});
+const ProjectConfigSchema = z.object({
+    /** Ordered list of directories to search for agent definitions. */
+    agent_paths: z.array(z.string()).optional(),
+    /** Named MCP server profiles. */
+    mcp_profiles: z.record(McpProfileSchema).optional(),
+    /** Artifact output directory pattern (supports {project}, {pipeline_name}). */
+    artifact_dir: z.string().optional(),
+    /** Default MCP profile applied when a stage doesn't specify one. */
+    default_mcp_profile: z.string().optional(),
+    /** Claude config directory (default: inherits CLAUDE_CONFIG_DIR or ~/.claude). */
+    claude_config_dir: z.string().optional(),
+    /** Permission mode for agent subprocesses (default: bypassPermissions). */
+    permission_mode: z.enum(["default", "acceptEdits", "bypassPermissions", "auto"]).optional(),
+});
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Load a cccp.yaml project config from the given directory.
+ * Returns an empty config (all defaults) if the file doesn't exist.
+ *
+ * Paths in `agent_paths` are resolved relative to the config file's directory.
+ */
+export async function loadProjectConfig(projectDir) {
+    const configPath = resolve(projectDir, "cccp.yaml");
+    let raw;
+    try {
+        raw = await readFile(configPath, "utf-8");
+    }
+    catch {
+        // No config file — return empty defaults.
+        return {};
+    }
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch (err) {
+        throw new Error(`Invalid YAML in config file: ${configPath}`, {
+            cause: err,
+        });
+    }
+    if (parsed == null) {
+        return {};
+    }
+    const result = ProjectConfigSchema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `  - ${i.path.join(".")}: ${i.message}`)
+            .join("\n");
+        throw new Error(`Config validation failed for ${configPath}:\n${issues}`);
+    }
+    const config = result.data;
+    // Resolve agent_paths relative to config file location.
+    if (config.agent_paths) {
+        config.agent_paths = config.agent_paths.map((p) => resolve(dirname(configPath), p));
+    }
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,24 @@
+import type { ProjectConfig } from "./config.js";
+import type { Pipeline, RunContext } from "./types.js";
+export declare function buildAgentSearchPaths(pipelineFile: string, projectDir: string, projectConfig: ProjectConfig): string[];
+export declare function resolveArtifactDir(opts: {
+    artifactDir?: string;
+    projectDir: string;
+    projectConfig: ProjectConfig;
+    project: string;
+    pipelineName: string;
+}): string;
+export declare function parseCLIVars(vars?: string[]): Record<string, string>;
+export interface BuildRunContextOptions {
+    project: string;
+    projectDir: string;
+    pipelineFile: string;
+    pipeline: Pipeline;
+    artifactDir: string;
+    projectConfig: ProjectConfig;
+    dryRun?: boolean;
+    headless?: boolean;
+    showTui?: boolean;
+    cliVars?: Record<string, string>;
+}
+export declare function buildRunContext(opts: BuildRunContextOptions): RunContext;

package/dist/context.js

@@ -0,0 +1,82 @@
+import { resolve, dirname } from "node:path";
+import { interpolate } from "./prompt.js";
+import { AutoApproveStrategy } from "./gate/auto-approve.js";
+import { ConsoleLogger, QuietLogger } from "./logger.js";
+import { TempFileTracker } from "./temp-tracker.js";
+// ---------------------------------------------------------------------------
+// Agent search paths — 4-source priority order
+// ---------------------------------------------------------------------------
+export function buildAgentSearchPaths(pipelineFile, projectDir, projectConfig) {
+    const paths = [];
+    paths.push(resolve(dirname(pipelineFile), "agents"));
+    paths.push(resolve(projectDir, ".claude", "agents"));
+    paths.push(resolve(projectDir, "agents"));
+    if (projectConfig.agent_paths) {
+        paths.push(...projectConfig.agent_paths);
+    }
+    return paths;
+}
+// ---------------------------------------------------------------------------
+// Artifact directory resolution — CLI flag > cccp.yaml > default pattern
+// ---------------------------------------------------------------------------
+export function resolveArtifactDir(opts) {
+    if (opts.artifactDir)
+        return resolve(opts.artifactDir);
+    if (opts.projectConfig.artifact_dir) {
+        return resolve(opts.projectDir, interpolate(opts.projectConfig.artifact_dir, {
+            project: opts.project,
+            pipeline_name: opts.pipelineName,
+        }));
+    }
+    return resolve(opts.projectDir, `docs/projects/${opts.project}/${opts.pipelineName}`);
+}
+// ---------------------------------------------------------------------------
+// CLI variable parsing
+// ---------------------------------------------------------------------------
+export function parseCLIVars(vars) {
+    const result = {};
+    if (!vars)
+        return result;
+    for (const v of vars) {
+        const eq = v.indexOf("=");
+        if (eq === -1) {
+            throw new Error(`Invalid variable format: ${v} (expected key=value)`);
+        }
+        result[v.slice(0, eq)] = v.slice(eq + 1);
+    }
+    return result;
+}
+export function buildRunContext(opts) {
+    const agentSearchPaths = buildAgentSearchPaths(opts.pipelineFile, opts.projectDir, opts.projectConfig);
+    const variables = {
+        project: opts.project,
+        project_dir: opts.projectDir,
+        artifact_dir: opts.artifactDir,
+        pipeline_name: opts.pipeline.name,
+        ...(opts.pipeline.variables ?? {}),
+        ...(opts.cliVars ?? {}),
+    };
+    // Gate strategy: headless → auto-approve immediately.
+    // Interactive → FilesystemGateStrategy, but it needs a runId which doesn't
+    // exist yet. The runner creates it after state initialization.
+    const gateStrategy = opts.headless
+        ? new AutoApproveStrategy()
+        : undefined;
+    return {
+        project: opts.project,
+        projectDir: opts.projectDir,
+        artifactDir: opts.artifactDir,
+        pipelineFile: opts.pipelineFile,
+        pipeline: opts.pipeline,
+        dryRun: opts.dryRun ?? false,
+        variables,
+        agentSearchPaths,
+        projectConfig: opts.projectConfig,
+        gateStrategy,
+        headless: opts.headless,
+        quiet: opts.showTui,
+        logger: opts.showTui ? new QuietLogger() : new ConsoleLogger(),
+        tempTracker: new TempFileTracker(),
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/contract.d.ts

@@ -0,0 +1,26 @@
+import type { ContractCriterion } from "./types.js";
+export interface ContractOptions {
+    /** Sub-stage / stage name. */
+    stageName: string;
+    /** Path where the deliverable will be written. */
+    deliverable: string;
+    /** Success criteria from the pipeline YAML. */
+    criteria: ContractCriterion[];
+    /** Maximum PGE iterations. */
+    maxIterations: number;
+    /** Optional path to a custom contract template. */
+    templatePath?: string;
+}
+/**
+ * Generate a contract markdown file from criteria.
+ *
+ * If `templatePath` is provided, reads and uses that template (must contain
+ * `{stage_name}`, `{deliverable}`, `{criteria_table}`, `{max_iterations}`
+ * placeholders). Otherwise uses the built-in default.
+ */
+export declare function generateContract(opts: ContractOptions): Promise<string>;
+/**
+ * Generate and write a contract file to disk.
+ * Creates parent directories as needed.
+ */
+export declare function writeContract(contractPath: string, opts: ContractOptions): Promise<void>;

package/dist/contract.js

@@ -0,0 +1,65 @@
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+/**
+ * Generate a contract markdown file from criteria.
+ *
+ * If `templatePath` is provided, reads and uses that template (must contain
+ * `{stage_name}`, `{deliverable}`, `{criteria_table}`, `{max_iterations}`
+ * placeholders). Otherwise uses the built-in default.
+ */
+export async function generateContract(opts) {
+    if (opts.templatePath) {
+        const template = await readFile(opts.templatePath, "utf-8");
+        return applyTemplate(template, opts);
+    }
+    return buildDefaultContract(opts);
+}
+/**
+ * Generate and write a contract file to disk.
+ * Creates parent directories as needed.
+ */
+export async function writeContract(contractPath, opts) {
+    const content = await generateContract(opts);
+    await mkdir(dirname(contractPath), { recursive: true });
+    await writeFile(contractPath, content, "utf-8");
+}
+// ---------------------------------------------------------------------------
+// Default contract format (matches squatlypowers contract template)
+// ---------------------------------------------------------------------------
+function buildDefaultContract(opts) {
+    const criteriaRows = opts.criteria
+        .map((c, i) => `| ${i + 1} | ${c.name} | ${c.description} |`)
+        .join("\n");
+    return `## Contract: ${opts.stageName}
+
+### Deliverable
+
+${opts.deliverable}
+
+### Success Criteria
+
+| # | Criterion | Description |
+|---|-----------|-------------|
+${criteriaRows}
+
+### Pass Rule
+
+ALL criteria must pass. Any single failure = overall FAIL.
+
+### Max Iterations: ${opts.maxIterations}
+`;
+}
+// ---------------------------------------------------------------------------
+// Custom template support
+// ---------------------------------------------------------------------------
+function applyTemplate(template, opts) {
+    const criteriaRows = opts.criteria
+        .map((c, i) => `| ${i + 1} | ${c.name} | ${c.description} |`)
+        .join("\n");
+    return template
+        .replace(/\{stage_name\}/g, opts.stageName)
+        .replace(/\{deliverable\}/g, opts.deliverable)
+        .replace(/\{criteria_table\}/g, criteriaRows)
+        .replace(/\{max_iterations\}/g, String(opts.maxIterations));
+}
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAqB;IAErB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC5D,OAAO,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,YAAoB,EACpB,IAAqB;IAErB,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,MAAM,SAAS,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED,8EAA8E;AAC9E,oEAAoE;AACpE,8EAA8E;AAE9E,SAAS,oBAAoB,CAAC,IAAqB;IACjD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ;SAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,WAAW,IAAI,CAAC;SAC5D,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,gBAAgB,IAAI,CAAC,SAAS;;;;EAIrC,IAAI,CAAC,WAAW;;;;;;EAMhB,YAAY;;;;;;sBAMQ,IAAI,CAAC,aAAa;CACvC,CAAC;AACF,CAAC;AAED,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,SAAS,aAAa,CAAC,QAAgB,EAAE,IAAqB;IAC5D,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ;SAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,WAAW,IAAI,CAAC;SAC5D,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,QAAQ;SACZ,OAAO,CAAC,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC;SAC1C,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,WAAW,CAAC;SAC7C,OAAO,CAAC,qBAAqB,EAAE,YAAY,CAAC;SAC5C,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/db.d.ts

@@ -0,0 +1,70 @@
+import type { PipelineState, StateEvent, DiscoveredRun } from "./types.js";
+/** Filter criteria for querying pipeline runs. */
+export interface RunFilter {
+    project?: string;
+    pipeline?: string;
+    status?: string;
+    artifactDir?: string;
+}
+export declare function dbPath(projectDir: string): string;
+export declare class CccpDatabase {
+    private db;
+    private filePath;
+    private constructor();
+    /**
+     * Open or create a database. If the file exists, load it. Otherwise create
+     * a new empty DB with the schema.
+     */
+    static open(projectDir: string): Promise<CccpDatabase>;
+    /**
+     * Open a read-only copy of the database (for standalone dashboard / MCP server).
+     * Re-reads the file from disk each time — safe for cross-process access.
+     */
+    static openReadOnly(projectDir: string): Promise<CccpDatabase>;
+    private migrate;
+    private pragma;
+    insertRun(state: PipelineState, artifactDir: string): void;
+    updateRun(state: PipelineState, artifactDir: string): void;
+    /**
+     * Insert or update — tries update first, inserts if no row exists.
+     */
+    upsertRun(state: PipelineState, artifactDir: string): void;
+    getRun(runId: string): PipelineState | null;
+    /**
+     * @deprecated Use getRun(runId) instead.
+     */
+    getRunByArtifactDir(artifactDir: string): PipelineState | null;
+    /**
+     * Find a run by ID prefix. Returns null if zero or multiple matches.
+     */
+    getRunByIdPrefix(prefix: string): PipelineState | null;
+    listRuns(): DiscoveredRun[];
+    /**
+     * Find runs matching optional filters. All filters are AND-combined.
+     * Results sorted running-first, then by start time descending.
+     */
+    findRuns(filter?: RunFilter): DiscoveredRun[];
+    private rowToState;
+    appendEvent(runId: string, eventType: string, stageName?: string, data?: unknown): void;
+    getEvents(runId: string, sinceId?: number): StateEvent[];
+    setCheckpoint(runId: string, stageName: string, key: string, value: string): void;
+    getCheckpoint(runId: string, stageName: string, key: string): string | null;
+    /**
+     * Atomically write the database to disk (write to .tmp then rename).
+     */
+    flush(): void;
+    /**
+     * Reload the database from disk (for read-only consumers in separate processes).
+     */
+    reload(): void;
+    close(): void;
+}
+/**
+ * Get or create a CccpDatabase for the given project directory.
+ * Caches the instance for reuse within the same process.
+ */
+export declare function openDatabase(projectDir: string): Promise<CccpDatabase>;
+/**
+ * Close and remove a cached database instance.
+ */
+export declare function closeDatabase(projectDir: string): void;