popeye-cli 1.10.0 → 2.1.0

package/dist/pipeline/repo-snapshot.js

@@ -0,0 +1,343 @@
+/**
+ * Repo Snapshot Generator — deterministic project state capture.
+ * Generated before every consensus gate for anti-hallucination.
+ * Supports caching via mtime for performance (P2-H).
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { join, extname } from 'node:path';
+// ─── Constants ───────────────────────────────────────────
+const EXCLUDE_DIRS = new Set([
+    'node_modules', '.git', 'dist', '__pycache__', '.next',
+    '.nuxt', 'build', 'coverage', '.turbo', '.cache',
+    '.venv', 'venv', 'env',
+]);
+const CONFIG_FILES = new Set([
+    'package.json', 'pyproject.toml', 'docker-compose.yml',
+    'docker-compose.yaml', 'Dockerfile', 'tsconfig.json',
+    'vite.config.ts', 'vite.config.js', 'next.config.js',
+    'next.config.mjs', 'next.config.ts', 'webpack.config.js',
+    'tailwind.config.ts', 'tailwind.config.js',
+    'jest.config.ts', 'jest.config.js', 'vitest.config.ts',
+    'vitest.config.js', '.eslintrc.js', '.eslintrc.json',
+    'eslint.config.js', 'eslint.config.mjs',
+    'prisma/schema.prisma', 'alembic.ini',
+    'requirements.txt', 'setup.py', 'setup.cfg',
+    'Makefile', 'Procfile',
+]);
+const CODE_EXTENSIONS = new Set([
+    '.ts', '.tsx', '.js', '.jsx', '.py', '.go', '.rs',
+    '.java', '.rb', '.php', '.vue', '.svelte', '.astro',
+    '.css', '.scss', '.html', '.sql', '.prisma',
+]);
+const lineCache = new Map();
+function countLinesWithCache(filePath) {
+    try {
+        const stat = statSync(filePath);
+        const cached = lineCache.get(filePath);
+        if (cached && cached.mtime === stat.mtimeMs) {
+            return cached.lines;
+        }
+        const content = readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n').length;
+        lineCache.set(filePath, { mtime: stat.mtimeMs, lines });
+        return lines;
+    }
+    catch {
+        return 0;
+    }
+}
+// ─── Snapshot Generation ─────────────────────────────────
+/** Generate a deterministic snapshot of the project */
+export async function generateRepoSnapshot(projectDir) {
+    const snapshotId = createHash('sha256')
+        .update(`${projectDir}-${Date.now()}`)
+        .digest('hex')
+        .slice(0, 16);
+    const treeSummary = buildTreeSummary(projectDir, '', 3);
+    const configFiles = scanConfigFiles(projectDir);
+    const languagesDetected = detectLanguages(projectDir);
+    const envFiles = findEnvFiles(projectDir);
+    const migrationsPresent = detectMigrations(projectDir);
+    const portsEntrypoints = detectPorts(configFiles);
+    const { totalFiles, totalLines } = countFilesAndLines(projectDir);
+    // Extract key info from config files
+    const packageManager = detectPackageManager(projectDir, configFiles);
+    const scripts = extractScripts(configFiles);
+    const testFramework = detectTestFramework(configFiles, scripts);
+    const buildTool = detectBuildTool(configFiles, scripts);
+    return {
+        snapshot_id: snapshotId,
+        timestamp: new Date().toISOString(),
+        tree_summary: treeSummary,
+        config_files: configFiles,
+        languages_detected: languagesDetected,
+        package_manager: packageManager,
+        scripts,
+        test_framework: testFramework,
+        build_tool: buildTool,
+        env_files: envFiles,
+        migrations_present: migrationsPresent,
+        ports_entrypoints: portsEntrypoints,
+        total_files: totalFiles,
+        total_lines: totalLines,
+    };
+}
+/** Store snapshot as an artifact */
+export function createSnapshotArtifact(snapshot, artifactManager, phase) {
+    return artifactManager.createAndStoreJson('repo_snapshot', snapshot, phase);
+}
+/** Compare two snapshots to detect drift */
+export function diffSnapshots(before, after) {
+    const addedConfigs = after.config_files
+        .filter((c) => !before.config_files.some((b) => b.path === c.path));
+    const removedConfigs = before.config_files
+        .filter((c) => !after.config_files.some((a) => a.path === c.path));
+    const changedConfigs = after.config_files.filter((ac) => {
+        const bc = before.config_files.find((b) => b.path === ac.path);
+        return bc && bc.content_hash !== ac.content_hash;
+    });
+    const filesChanged = after.total_files !== before.total_files;
+    const linesChanged = after.total_lines !== before.total_lines;
+    return {
+        added_configs: addedConfigs.map((c) => c.path),
+        removed_configs: removedConfigs.map((c) => c.path),
+        changed_configs: changedConfigs.map((c) => c.path),
+        files_delta: after.total_files - before.total_files,
+        lines_delta: after.total_lines - before.total_lines,
+        has_changes: filesChanged || linesChanged || changedConfigs.length > 0
+            || addedConfigs.length > 0 || removedConfigs.length > 0,
+    };
+}
+// ─── Internal Helpers ────────────────────────────────────
+function buildTreeSummary(dir, prefix, maxDepth) {
+    if (maxDepth <= 0)
+        return '';
+    const lines = [];
+    try {
+        const entries = readdirSync(dir, { withFileTypes: true })
+            .filter((e) => !EXCLUDE_DIRS.has(e.name) && !e.name.startsWith('.'));
+        for (const entry of entries.slice(0, 50)) {
+            const marker = entry.isDirectory() ? '/' : '';
+            lines.push(`${prefix}${entry.name}${marker}`);
+            if (entry.isDirectory() && maxDepth > 1) {
+                const sub = buildTreeSummary(join(dir, entry.name), prefix + '  ', maxDepth - 1);
+                if (sub)
+                    lines.push(sub);
+            }
+        }
+        if (entries.length > 50) {
+            lines.push(`${prefix}... (+${entries.length - 50} more)`);
+        }
+    }
+    catch {
+        // Directory unreadable
+    }
+    return lines.join('\n');
+}
+function scanConfigFiles(projectDir) {
+    const configs = [];
+    for (const configName of CONFIG_FILES) {
+        const fullPath = join(projectDir, configName);
+        if (!existsSync(fullPath))
+            continue;
+        try {
+            const content = readFileSync(fullPath, 'utf-8');
+            const contentHash = createHash('sha256').update(content).digest('hex').slice(0, 16);
+            const keyFields = extractKeyFields(configName, content);
+            configs.push({
+                path: configName,
+                type: configName,
+                content_hash: contentHash,
+                key_fields: keyFields,
+            });
+        }
+        catch {
+            // Skip unreadable config files
+        }
+    }
+    return configs;
+}
+function extractKeyFields(configName, content) {
+    try {
+        if (configName === 'package.json') {
+            const pkg = JSON.parse(content);
+            return {
+                name: pkg.name,
+                version: pkg.version,
+                scripts: pkg.scripts,
+                dependencies: pkg.dependencies ? Object.keys(pkg.dependencies) : [],
+                devDependencies: pkg.devDependencies ? Object.keys(pkg.devDependencies) : [],
+            };
+        }
+        if (configName === 'tsconfig.json') {
+            const ts = JSON.parse(content);
+            return {
+                target: ts.compilerOptions?.target,
+                module: ts.compilerOptions?.module,
+                outDir: ts.compilerOptions?.outDir,
+            };
+        }
+    }
+    catch {
+        // Not JSON parseable, return empty
+    }
+    return {};
+}
+function detectLanguages(projectDir) {
+    const languages = new Set();
+    const extensionMap = {
+        '.ts': 'typescript', '.tsx': 'typescript',
+        '.js': 'javascript', '.jsx': 'javascript',
+        '.py': 'python', '.go': 'go', '.rs': 'rust',
+        '.java': 'java', '.rb': 'ruby', '.php': 'php',
+    };
+    function scan(dir, depth) {
+        if (depth > 3)
+            return;
+        try {
+            const entries = readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (EXCLUDE_DIRS.has(entry.name))
+                    continue;
+                if (entry.isDirectory()) {
+                    scan(join(dir, entry.name), depth + 1);
+                }
+                else {
+                    const ext = extname(entry.name);
+                    if (extensionMap[ext])
+                        languages.add(extensionMap[ext]);
+                }
+            }
+        }
+        catch {
+            // Skip unreadable
+        }
+    }
+    scan(projectDir, 0);
+    return Array.from(languages).sort();
+}
+function findEnvFiles(projectDir) {
+    try {
+        return readdirSync(projectDir)
+            .filter((f) => f.startsWith('.env'))
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+function detectMigrations(projectDir) {
+    const migrationDirs = ['migrations', 'prisma/migrations', 'alembic/versions', 'db/migrate'];
+    return migrationDirs.some((d) => existsSync(join(projectDir, d)));
+}
+function detectPorts(configFiles) {
+    const ports = [];
+    for (const config of configFiles) {
+        if (config.type === 'docker-compose.yml' || config.type === 'docker-compose.yaml') {
+            // Basic port detection from docker-compose key_fields
+            // Full parsing would need YAML, keeping it simple
+            ports.push({ port: 3000, service: 'app', source: config.path });
+        }
+    }
+    // Check package.json scripts for port hints
+    const pkg = configFiles.find((c) => c.type === 'package.json');
+    if (pkg) {
+        const scripts = pkg.key_fields.scripts;
+        if (scripts && typeof scripts === 'object') {
+            const startScript = scripts.start ?? '';
+            const portMatch = startScript.match(/(?:PORT|port)[=: ]?(\d+)/);
+            if (portMatch) {
+                ports.push({ port: parseInt(portMatch[1], 10), service: 'start', source: 'package.json' });
+            }
+        }
+    }
+    return ports;
+}
+function detectPackageManager(projectDir, _configFiles) {
+    if (existsSync(join(projectDir, 'pnpm-lock.yaml')))
+        return 'pnpm';
+    if (existsSync(join(projectDir, 'yarn.lock')))
+        return 'yarn';
+    if (existsSync(join(projectDir, 'bun.lockb')))
+        return 'bun';
+    if (existsSync(join(projectDir, 'package-lock.json')))
+        return 'npm';
+    if (existsSync(join(projectDir, 'requirements.txt')))
+        return 'pip';
+    if (existsSync(join(projectDir, 'pyproject.toml')))
+        return 'poetry';
+    return undefined;
+}
+function extractScripts(configFiles) {
+    const pkg = configFiles.find((c) => c.type === 'package.json');
+    if (!pkg)
+        return {};
+    const scripts = pkg.key_fields.scripts;
+    if (!scripts || typeof scripts !== 'object')
+        return {};
+    return scripts;
+}
+function detectTestFramework(configFiles, scripts) {
+    const testScript = scripts.test ?? '';
+    if (testScript.includes('vitest'))
+        return 'vitest';
+    if (testScript.includes('jest'))
+        return 'jest';
+    if (testScript.includes('pytest'))
+        return 'pytest';
+    if (testScript.includes('mocha'))
+        return 'mocha';
+    if (configFiles.some((c) => c.type.startsWith('vitest.config')))
+        return 'vitest';
+    if (configFiles.some((c) => c.type.startsWith('jest.config')))
+        return 'jest';
+    return undefined;
+}
+function detectBuildTool(configFiles, scripts) {
+    const buildScript = scripts.build ?? '';
+    if (buildScript.includes('tsc'))
+        return 'tsc';
+    if (buildScript.includes('vite'))
+        return 'vite';
+    if (buildScript.includes('webpack'))
+        return 'webpack';
+    if (buildScript.includes('next'))
+        return 'next';
+    if (buildScript.includes('turbo'))
+        return 'turbo';
+    if (configFiles.some((c) => c.type.startsWith('vite.config')))
+        return 'vite';
+    if (configFiles.some((c) => c.type.startsWith('next.config')))
+        return 'next';
+    return undefined;
+}
+function countFilesAndLines(projectDir) {
+    let totalFiles = 0;
+    let totalLines = 0;
+    function walk(dir, depth) {
+        if (depth > 8)
+            return;
+        try {
+            const entries = readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (EXCLUDE_DIRS.has(entry.name))
+                    continue;
+                const fullPath = join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    walk(fullPath, depth + 1);
+                }
+                else if (CODE_EXTENSIONS.has(extname(entry.name))) {
+                    totalFiles++;
+                    totalLines += countLinesWithCache(fullPath);
+                }
+            }
+        }
+        catch {
+            // Skip unreadable
+        }
+    }
+    walk(projectDir, 0);
+    return { totalFiles, totalLines };
+}
+//# sourceMappingURL=repo-snapshot.js.map

package/dist/pipeline/repo-snapshot.js.map

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

package/dist/pipeline/role-execution-adapter.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Role Execution Adapter — bridges pipeline role planning
+ * with the existing runExecutionMode().
+ *
+ * Builds role-specific execution contexts by combining skill prompts
+ * with role plan constraints, then injects them as systemPrompt
+ * into ClaudeExecuteOptions for prompt-based enforcement.
+ */
+import type { PipelineRole, PipelineState, ArtifactEntry } from './types.js';
+import type { SkillLoader, SkillDefinition } from './skill-loader.js';
+export interface RoleExecutionContext {
+    role: PipelineRole;
+    systemPrompt: string;
+    allowedPaths: string[];
+    forbiddenPatterns: string[];
+    taskScope: string;
+}
+export interface ClaudeExecuteOptions {
+    projectDir: string;
+    systemPrompt?: string;
+    [key: string]: unknown;
+}
+/**
+ * Build a role-specific execution context from a skill definition and role plan artifact.
+ *
+ * Args:
+ *   role: The pipeline role to build context for.
+ *   skill: The skill definition loaded by SkillLoader.
+ *   rolePlan: The approved role plan artifact entry.
+ *   projectDir: Root project directory.
+ *
+ * Returns:
+ *   RoleExecutionContext with system prompt, allowed paths, and task scope.
+ */
+export declare function buildRoleExecutionContext(role: PipelineRole, skill: SkillDefinition, rolePlan: ArtifactEntry, projectDir: string): RoleExecutionContext;
+/**
+ * Inject role context into ClaudeExecuteOptions by setting the systemPrompt field.
+ *
+ * Args:
+ *   context: The role execution context.
+ *   options: The execution options to augment.
+ *
+ * Returns:
+ *   Modified options with systemPrompt injected.
+ */
+export declare function executeWithRoleContext(context: RoleExecutionContext, options: ClaudeExecuteOptions): ClaudeExecuteOptions;
+/**
+ * Find role plan artifacts for each active role in the pipeline.
+ *
+ * Args:
+ *   pipeline: Current pipeline state.
+ *   skillLoader: Skill loader instance.
+ *   projectDir: Root project directory.
+ *
+ * Returns:
+ *   Map of role to RoleExecutionContext.
+ */
+export declare function buildAllRoleContexts(pipeline: PipelineState, skillLoader: SkillLoader, projectDir: string): Map<PipelineRole, RoleExecutionContext>;
+//# sourceMappingURL=role-execution-adapter.d.ts.map

package/dist/pipeline/role-execution-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-execution-adapter.d.ts","sourceRoot":"","sources":["../../src/pipeline/role-execution-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAItE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,YAAY,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,MAAM,GACjB,oBAAoB,CAuBtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,oBAAoB,GAC5B,oBAAoB,CAKtB;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,aAAa,EACvB,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,GACjB,GAAG,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAoBzC"}

package/dist/pipeline/role-execution-adapter.js

@@ -0,0 +1,159 @@
+/**
+ * Role Execution Adapter — bridges pipeline role planning
+ * with the existing runExecutionMode().
+ *
+ * Builds role-specific execution contexts by combining skill prompts
+ * with role plan constraints, then injects them as systemPrompt
+ * into ClaudeExecuteOptions for prompt-based enforcement.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+// ─── Context Builder ─────────────────────────────────────
+/**
+ * Build a role-specific execution context from a skill definition and role plan artifact.
+ *
+ * Args:
+ *   role: The pipeline role to build context for.
+ *   skill: The skill definition loaded by SkillLoader.
+ *   rolePlan: The approved role plan artifact entry.
+ *   projectDir: Root project directory.
+ *
+ * Returns:
+ *   RoleExecutionContext with system prompt, allowed paths, and task scope.
+ */
+export function buildRoleExecutionContext(role, skill, rolePlan, projectDir) {
+    // Read role plan content
+    const planPath = join(projectDir, rolePlan.path);
+    let planContent = '';
+    if (existsSync(planPath)) {
+        planContent = readFileSync(planPath, 'utf-8');
+    }
+    // Extract task scope from role plan
+    const taskScope = extractTaskScope(planContent);
+    const allowedPaths = extractAllowedPaths(planContent, role);
+    const forbiddenPatterns = extractForbiddenPatterns(role);
+    // Build system prompt combining skill + role constraints
+    const systemPrompt = buildRoleSystemPrompt(role, skill, planContent, forbiddenPatterns);
+    return {
+        role,
+        systemPrompt,
+        allowedPaths,
+        forbiddenPatterns,
+        taskScope,
+    };
+}
+/**
+ * Inject role context into ClaudeExecuteOptions by setting the systemPrompt field.
+ *
+ * Args:
+ *   context: The role execution context.
+ *   options: The execution options to augment.
+ *
+ * Returns:
+ *   Modified options with systemPrompt injected.
+ */
+export function executeWithRoleContext(context, options) {
+    return {
+        ...options,
+        systemPrompt: context.systemPrompt,
+    };
+}
+// ─── Role-to-Plan Mapping ────────────────────────────────
+/**
+ * Find role plan artifacts for each active role in the pipeline.
+ *
+ * Args:
+ *   pipeline: Current pipeline state.
+ *   skillLoader: Skill loader instance.
+ *   projectDir: Root project directory.
+ *
+ * Returns:
+ *   Map of role to RoleExecutionContext.
+ */
+export function buildAllRoleContexts(pipeline, skillLoader, projectDir) {
+    const contexts = new Map();
+    // Find all role_plan artifacts
+    const rolePlanArtifacts = pipeline.artifacts.filter((a) => a.type === 'role_plan');
+    for (const rolePlan of rolePlanArtifacts) {
+        // Determine which role this plan belongs to by checking plan content
+        const planPath = join(projectDir, rolePlan.path);
+        if (!existsSync(planPath))
+            continue;
+        const content = readFileSync(planPath, 'utf-8');
+        const role = detectRoleFromPlan(content, pipeline.activeRoles);
+        if (!role)
+            continue;
+        const skill = skillLoader.loadSkill(role);
+        contexts.set(role, buildRoleExecutionContext(role, skill, rolePlan, projectDir));
+    }
+    return contexts;
+}
+// ─── Internal Helpers ────────────────────────────────────
+/** Extract task scope description from role plan content */
+function extractTaskScope(planContent) {
+    // Look for "## Tasks" or "## Responsibilities" section
+    const taskMatch = planContent.match(/#+\s*(?:Tasks?|Responsibilities?|Work\s+Items?)\s*\n([\s\S]*?)(?=\n#+\s|\n---|\s*$)/i);
+    if (taskMatch) {
+        return taskMatch[1].trim().slice(0, 2000);
+    }
+    // Fallback: first 500 chars
+    return planContent.slice(0, 500).trim();
+}
+/** Extract allowed file paths from role plan */
+function extractAllowedPaths(planContent, role) {
+    // Default paths based on role
+    const roleDefaults = {
+        FRONTEND_PROGRAMMER: ['src/', 'app/', 'pages/', 'components/', 'styles/', 'public/'],
+        BACKEND_PROGRAMMER: ['src/', 'server/', 'api/', 'lib/', 'db/', 'prisma/'],
+        WEBSITE_PROGRAMMER: ['apps/website/', 'src/', 'app/', 'pages/', 'public/'],
+        DB_EXPERT: ['prisma/', 'migrations/', 'db/', 'alembic/', 'models/'],
+        QA_TESTER: ['tests/', '__tests__/', 'test/', 'spec/'],
+        UI_UX_SPECIALIST: ['src/', 'app/', 'styles/', 'components/'],
+    };
+    // Extract explicit file references from plan
+    const fileRefs = planContent.match(/(?:src|app|pages|lib|server|api|tests?)\/[\w\-./]+/g) ?? [];
+    const defaults = roleDefaults[role] ?? [];
+    return [...new Set([...defaults, ...fileRefs])];
+}
+/** Get forbidden patterns based on role boundaries */
+function extractForbiddenPatterns(role) {
+    const roleForbidden = {
+        FRONTEND_PROGRAMMER: ['server/', 'api/', 'prisma/', 'migrations/', 'alembic/'],
+        BACKEND_PROGRAMMER: ['components/', 'styles/', 'public/assets/'],
+        WEBSITE_PROGRAMMER: ['server/', 'api/', 'prisma/', 'migrations/'],
+        DB_EXPERT: ['components/', 'styles/', 'public/', 'pages/'],
+        QA_TESTER: [], // QA can touch anything
+    };
+    return roleForbidden[role] ?? [];
+}
+/** Build the full system prompt for a role */
+function buildRoleSystemPrompt(role, skill, planContent, forbiddenPatterns) {
+    const lines = [
+        `# Role: ${role}`,
+        '',
+        '## Skill System Prompt',
+        skill.systemPrompt,
+        '',
+        '## Your Approved Role Plan',
+        planContent.slice(0, 4000),
+        '',
+        '## Constraints',
+        ...skill.constraints.map((c) => `- ${c}`),
+    ];
+    if (forbiddenPatterns.length > 0) {
+        lines.push('', '## Forbidden Paths (Do NOT modify these)', ...forbiddenPatterns.map((p) => `- ${p}`));
+    }
+    lines.push('', '## Rules', '- Stay within your role boundaries', '- Only modify files in your allowed paths', '- If you need changes outside your scope, flag them as dependencies', '- Follow the approved plan — do not add unplanned features');
+    return lines.join('\n');
+}
+/** Detect which role a plan belongs to by matching role names in content */
+function detectRoleFromPlan(content, activeRoles) {
+    const uppercaseContent = content.toUpperCase();
+    for (const role of activeRoles) {
+        if (uppercaseContent.includes(role)) {
+            return role;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=role-execution-adapter.js.map

package/dist/pipeline/role-execution-adapter.js.map

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

package/dist/pipeline/skill-loader.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Skill Loader — hybrid system loading from TS defaults + .md overrides.
+ * .md files use YAML frontmatter for structured fields (P1-1).
+ * If no frontmatter, entire file treated as raw systemPrompt override.
+ */
+import type { PipelineRole } from './types.js';
+export interface SkillDefinition {
+    role: PipelineRole;
+    version: string;
+    systemPrompt: string;
+    required_outputs: string[];
+    constraints: string[];
+    depends_on?: PipelineRole[];
+}
+export declare class SkillLoader {
+    private readonly skillsDir;
+    private readonly cache;
+    constructor(skillsDir?: string);
+    /** Load skill definition for a role. Merges TS default + .md override. */
+    loadSkill(role: PipelineRole): SkillDefinition;
+    /** Load all skills for the given roles */
+    loadAllSkills(roles: PipelineRole[]): Map<PipelineRole, SkillDefinition>;
+    /** Clear cache (useful after reloading .md files) */
+    clearCache(): void;
+    /** List available .md skill files */
+    listAvailableOverrides(): string[];
+    private loadMarkdownOverride;
+}
+export declare function getDefaultSkill(role: PipelineRole): SkillDefinition;
+/** Parse skill markdown with optional YAML frontmatter */
+export declare function parseSkillMarkdown(content: string): Partial<SkillDefinition>;
+export declare function resolveSkillsDir(projectDir: string): string;
+export declare function createSkillLoader(projectDir?: string): SkillLoader;
+//# sourceMappingURL=skill-loader.d.ts.map

package/dist/pipeline/skill-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../../src/pipeline/skill-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;CAC7B;AAID,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4C;gBAEtD,SAAS,CAAC,EAAE,MAAM;IAI9B,0EAA0E;IAC1E,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,eAAe;IAsB9C,0CAA0C;IAC1C,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC,YAAY,EAAE,eAAe,CAAC;IAQxE,qDAAqD;IACrD,UAAU,IAAI,IAAI;IAIlB,qCAAqC;IACrC,sBAAsB,IAAI,MAAM,EAAE;IASlC,OAAO,CAAC,oBAAoB;CAa7B;AAID,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,eAAe,CAQnE;AAID,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAqD5E;AAqBD,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,CAGlE"}