popeye-cli 2.0.0 → 2.2.0

package/dist/pipeline/skills/generator.js

@@ -0,0 +1,221 @@
+/**
+ * Project-specific skill generation.
+ * Uses a single AI call to generate tailored system prompts for active roles,
+ * then writes them as .md files with YAML frontmatter to the project's skills/ dir.
+ * Falls back to defaults with project-specific constraints on AI failure.
+ */
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { DEFAULT_SKILLS } from './defaults.js';
+import { inferTechStack, getTemplateConstraints } from './role-map.js';
+// ─── Constants ──────────────────────────────────────────
+const PIPELINE_VERSION = '1.0';
+const MARKER_FILENAME = '.popeye-skills-generated.json';
+/** Zod schema for validating AI-generated skill prompts */
+const SkillPromptsResponseSchema = z.record(z.string(), z.string());
+// ─── Public API ─────────────────────────────────────────
+/**
+ * Generate project-specific skill .md files for all active roles.
+ * Skips roles that already have a .md file in the skills directory.
+ * Stores the raw AI response as a skill_generation_log artifact.
+ *
+ * @param context - Skill generation context with project details
+ * @param artifactManager - Optional artifact manager for logging
+ */
+export async function generateProjectSkills(context, artifactManager) {
+    const { activeRoles, skillsDir } = context;
+    // Ensure skills directory exists
+    if (!existsSync(skillsDir)) {
+        mkdirSync(skillsDir, { recursive: true });
+    }
+    // Determine which roles need generation
+    const rolesToGenerate = activeRoles.filter((role) => shouldGenerateSkill(skillsDir, role));
+    if (rolesToGenerate.length === 0) {
+        return;
+    }
+    // Infer tech stack
+    const techStack = inferTechStack(context.language, context.snapshot, context.expandedSpec);
+    // Attempt AI generation
+    let aiPrompts = {};
+    let aiGenerated = false;
+    try {
+        const prompt = buildSkillGenPrompt(context, rolesToGenerate, techStack);
+        const { createClient } = await import('../../adapters/openai.js');
+        const client = await createClient();
+        const completion = await client.chat.completions.create({
+            model: 'gpt-4.1',
+            messages: [{ role: 'user', content: prompt }],
+            temperature: 0.4,
+            max_tokens: 4096,
+        });
+        const rawResponse = completion.choices[0]?.message?.content ?? '';
+        // Store raw AI response as artifact
+        if (artifactManager) {
+            artifactManager.createAndStoreText('skill_generation_log', rawResponse, 'INTAKE');
+        }
+        aiPrompts = parseSkillPrompts(rawResponse, rolesToGenerate);
+        aiGenerated = Object.keys(aiPrompts).length > 0;
+    }
+    catch {
+        // AI failure is non-fatal — fall through to defaults with project constraints
+        aiGenerated = false;
+    }
+    // Write skill files
+    for (const role of rolesToGenerate) {
+        const defaultSkill = DEFAULT_SKILLS[role];
+        const systemPrompt = aiPrompts[role] ?? defaultSkill?.systemPrompt ?? '';
+        const constraints = getTemplateConstraints(role, techStack);
+        const allConstraints = [
+            ...(defaultSkill?.constraints ?? []),
+            ...constraints,
+        ];
+        // Deduplicate constraints
+        const uniqueConstraints = [...new Set(allConstraints)];
+        const dependsOn = defaultSkill?.depends_on ?? [];
+        const requiredOutputs = defaultSkill?.required_outputs ?? [];
+        const markdown = renderSkillMarkdown(role, systemPrompt, uniqueConstraints, requiredOutputs, dependsOn);
+        const filePath = join(skillsDir, `${role}.md`);
+        writeFileSync(filePath, markdown, 'utf-8');
+    }
+    // Write generation marker
+    const marker = {
+        timestamp: new Date().toISOString(),
+        pipelineVersion: PIPELINE_VERSION,
+        activeRoles: activeRoles.map(String),
+        techStack,
+        aiGenerated,
+    };
+    writeGenerationMarker(skillsDir, marker);
+}
+// ─── Skip Logic ─────────────────────────────────────────
+/**
+ * Check if a skill file should be generated for a role.
+ * Returns false if the role already has a .md file (hand-written or prior run).
+ *
+ * @param skillsDir - Path to the skills directory
+ * @param role - Pipeline role to check
+ * @returns true if the role needs a generated skill file
+ */
+export function shouldGenerateSkill(skillsDir, role) {
+    const mdPath = join(skillsDir, `${role}.md`);
+    return !existsSync(mdPath);
+}
+// ─── Prompt Building ────────────────────────────────────
+/**
+ * Build the AI prompt that requests system prompts for all roles at once.
+ *
+ * @param context - Generation context
+ * @param roles - Roles needing prompts
+ * @param techStack - Inferred tech stack
+ * @returns Formatted prompt string
+ */
+export function buildSkillGenPrompt(context, roles, techStack) {
+    const techDesc = Object.entries(techStack)
+        .filter(([, v]) => v)
+        .map(([k, v]) => `- ${k}: ${v}`)
+        .join('\n');
+    const roleDescriptions = roles.map((role) => {
+        const defaultSkill = DEFAULT_SKILLS[role];
+        return `- ${role}: ${defaultSkill?.systemPrompt.slice(0, 100) ?? 'Pipeline role'}...`;
+    }).join('\n');
+    return `You are generating project-specific skill definitions for an AI pipeline.
+
+## Project: ${context.projectName}
+## Tech Stack:
+${techDesc}
+
+## Expanded Specification (summary):
+${context.expandedSpec.slice(0, 3000)}
+
+${context.sessionGuidance ? `## Session Guidance:\n${context.sessionGuidance.slice(0, 1000)}\n` : ''}
+## Roles needing prompts:
+${roleDescriptions}
+
+## Instructions:
+Generate a tailored system prompt for each role listed above. Each prompt should:
+1. Reference the specific tech stack (e.g., "FastAPI async endpoints" not "API endpoints")
+2. Reference the project name
+3. Be 3-6 sentences
+4. Focus on the role's responsibilities in this specific project context
+
+Respond with ONLY a JSON object mapping role names to their system prompts. Example:
+{"BACKEND_PROGRAMMER": "You are the Backend Programmer for ProjectName. You implement..."}
+
+JSON response:`;
+}
+// ─── Response Parsing ───────────────────────────────────
+/**
+ * Parse and validate the AI response as a JSON record of role prompts.
+ * Falls back per-role: missing or invalid entries are excluded.
+ *
+ * @param response - Raw AI response text
+ * @param expectedRoles - Roles we requested prompts for
+ * @returns Validated record of role -> system prompt
+ */
+export function parseSkillPrompts(response, expectedRoles) {
+    try {
+        // Extract JSON from response (may be wrapped in markdown code fences)
+        const jsonMatch = response.match(/\{[\s\S]*\}/);
+        if (!jsonMatch)
+            return {};
+        const parsed = JSON.parse(jsonMatch[0]);
+        const validated = SkillPromptsResponseSchema.parse(parsed);
+        // Filter to only expected roles with non-empty prompts
+        const result = {};
+        for (const role of expectedRoles) {
+            if (validated[role] && validated[role].trim().length > 10) {
+                result[role] = validated[role].trim();
+            }
+        }
+        return result;
+    }
+    catch {
+        return {};
+    }
+}
+// ─── Markdown Rendering ─────────────────────────────────
+/**
+ * Render a skill definition as a Markdown file with YAML frontmatter.
+ * Format matches what the SkillLoader's parseSkillMarkdown() expects.
+ *
+ * @param role - Pipeline role
+ * @param systemPrompt - The system prompt body
+ * @param constraints - Combined constraint identifiers
+ * @param requiredOutputs - Required output types
+ * @param dependsOn - Upstream role dependencies
+ * @returns Complete markdown string
+ */
+export function renderSkillMarkdown(role, systemPrompt, constraints, requiredOutputs, dependsOn) {
+    const lines = [
+        '---',
+        `role: ${role}`,
+        'version: 1.0-project',
+        'required_outputs:',
+        ...requiredOutputs.map((o) => `  - ${o}`),
+        'constraints:',
+        ...constraints.map((c) => `  - ${c}`),
+    ];
+    if (dependsOn.length > 0) {
+        lines.push('depends_on:');
+        for (const dep of dependsOn) {
+            lines.push(`  - ${dep}`);
+        }
+    }
+    lines.push('---');
+    lines.push(systemPrompt);
+    lines.push('');
+    return lines.join('\n');
+}
+// ─── Marker File ────────────────────────────────────────
+/**
+ * Write the generation marker file to track what was generated.
+ *
+ * @param skillsDir - Path to the skills directory
+ * @param marker - Marker data to persist
+ */
+export function writeGenerationMarker(skillsDir, marker) {
+    const markerPath = join(skillsDir, MARKER_FILENAME);
+    writeFileSync(markerPath, JSON.stringify(marker, null, 2), 'utf-8');
+}
+//# sourceMappingURL=generator.js.map

package/dist/pipeline/skills/generator.js.map

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

package/dist/pipeline/skills/role-map.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Shared role mapping and tech stack inference.
+ * Extracted from migration.ts to be the single source of truth for
+ * language-to-role mapping and tech stack detection.
+ */
+import type { OutputLanguage } from '../../types/project.js';
+import type { PipelineRole, RepoSnapshot } from '../types.js';
+import type { TechStack } from './types.js';
+/** Roles that always participate regardless of language */
+export declare const SUPPORT_ROLES: PipelineRole[];
+/** All possible implementation roles across all languages */
+export declare const IMPLEMENTATION_ROLES: PipelineRole[];
+/**
+ * Determine the active roles for a given language.
+ *
+ * @param language - The project's output language
+ * @returns All roles (support + implementation) active for this language
+ */
+export declare function getActiveRoles(language: OutputLanguage): PipelineRole[];
+/**
+ * Infer the project's tech stack from available signals.
+ * Priority: snapshot deps > spec mentions > language defaults.
+ *
+ * @param language - The project's output language
+ * @param snapshot - Optional repo snapshot with config file data
+ * @param expandedSpec - Optional expanded specification text
+ * @returns Inferred tech stack
+ */
+export declare function inferTechStack(language: OutputLanguage, snapshot?: RepoSnapshot, expandedSpec?: string): TechStack;
+/**
+ * Get deterministic template constraints for a role based on tech stack.
+ *
+ * @param role - Pipeline role
+ * @param techStack - Inferred tech stack
+ * @returns Array of constraint identifiers
+ */
+export declare function getTemplateConstraints(role: PipelineRole, techStack: TechStack): string[];
+//# sourceMappingURL=role-map.d.ts.map

package/dist/pipeline/skills/role-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-map.d.ts","sourceRoot":"","sources":["../../../src/pipeline/skills/role-map.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C,2DAA2D;AAC3D,eAAO,MAAM,aAAa,EAAE,YAAY,EAUvC,CAAC;AAcF,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB,EAAE,YAAY,EAG9C,CAAC;AAIF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,YAAY,EAAE,CAGvE;AAuED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,cAAc,EACxB,QAAQ,CAAC,EAAE,YAAY,EACvB,YAAY,CAAC,EAAE,MAAM,GACpB,SAAS,CAsDX;AA4CD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE,CAIzF"}

package/dist/pipeline/skills/role-map.js

@@ -0,0 +1,234 @@
+/**
+ * Shared role mapping and tech stack inference.
+ * Extracted from migration.ts to be the single source of truth for
+ * language-to-role mapping and tech stack detection.
+ */
+// ─── Role Categories ────────────────────────────────────
+/** Roles that always participate regardless of language */
+export const SUPPORT_ROLES = [
+    'DISPATCHER',
+    'ARCHITECT',
+    'QA_TESTER',
+    'REVIEWER',
+    'ARBITRATOR',
+    'DEBUGGER',
+    'AUDITOR',
+    'JOURNALIST',
+    'RELEASE_MANAGER',
+];
+/** Language-specific implementation role sets */
+const IMPLEMENTATION_ROLE_MAP = {
+    python: ['DB_EXPERT', 'BACKEND_PROGRAMMER'],
+    typescript: ['FRONTEND_PROGRAMMER', 'UI_UX_SPECIALIST'],
+    fullstack: ['DB_EXPERT', 'BACKEND_PROGRAMMER', 'FRONTEND_PROGRAMMER', 'UI_UX_SPECIALIST'],
+    website: ['WEBSITE_PROGRAMMER', 'UI_UX_SPECIALIST', 'MARKETING_EXPERT', 'SOCIAL_EXPERT'],
+    all: [
+        'DB_EXPERT', 'BACKEND_PROGRAMMER', 'FRONTEND_PROGRAMMER',
+        'WEBSITE_PROGRAMMER', 'UI_UX_SPECIALIST', 'MARKETING_EXPERT', 'SOCIAL_EXPERT',
+    ],
+};
+/** All possible implementation roles across all languages */
+export const IMPLEMENTATION_ROLES = [
+    'DB_EXPERT', 'BACKEND_PROGRAMMER', 'FRONTEND_PROGRAMMER',
+    'WEBSITE_PROGRAMMER', 'UI_UX_SPECIALIST', 'MARKETING_EXPERT', 'SOCIAL_EXPERT',
+];
+// ─── Active Role Selection ──────────────────────────────
+/**
+ * Determine the active roles for a given language.
+ *
+ * @param language - The project's output language
+ * @returns All roles (support + implementation) active for this language
+ */
+export function getActiveRoles(language) {
+    const implRoles = IMPLEMENTATION_ROLE_MAP[language] ?? ['BACKEND_PROGRAMMER'];
+    return [...SUPPORT_ROLES, ...implRoles];
+}
+// ─── Tech Stack Inference ───────────────────────────────
+/** Framework detection patterns for snapshot config key_fields */
+const FRAMEWORK_PATTERNS = {
+    fastapi: { backend: 'FastAPI' },
+    django: { backend: 'Django' },
+    flask: { backend: 'Flask' },
+    express: { backend: 'Express' },
+    nestjs: { backend: 'NestJS' },
+    'next': { frontend: 'Next.js' },
+    nuxt: { frontend: 'Nuxt' },
+    react: { frontend: 'React' },
+    vue: { frontend: 'Vue' },
+    svelte: { frontend: 'SvelteKit' },
+    angular: { frontend: 'Angular' },
+    sqlalchemy: { orm: 'SQLAlchemy' },
+    prisma: { orm: 'Prisma' },
+    drizzle: { orm: 'Drizzle' },
+    typeorm: { orm: 'TypeORM' },
+    sequelize: { orm: 'Sequelize' },
+    postgresql: { database: 'PostgreSQL' },
+    postgres: { database: 'PostgreSQL' },
+    mysql: { database: 'MySQL' },
+    sqlite: { database: 'SQLite' },
+    mongodb: { database: 'MongoDB' },
+    mongoose: { database: 'MongoDB' },
+    pytest: { testing: 'Pytest' },
+    vitest: { testing: 'Vitest' },
+    jest: { testing: 'Jest' },
+    mocha: { testing: 'Mocha' },
+};
+/** Language-based defaults when no signals are available */
+const LANGUAGE_DEFAULTS = {
+    python: {
+        language: 'Python 3.11+',
+        backend: 'FastAPI',
+        database: 'PostgreSQL',
+        orm: 'SQLAlchemy',
+        testing: 'Pytest',
+    },
+    typescript: {
+        language: 'TypeScript 5.x',
+        frontend: 'React + Vite',
+        testing: 'Vitest',
+    },
+    fullstack: {
+        language: 'TypeScript 5.x / Python 3.11+',
+        backend: 'FastAPI',
+        frontend: 'React + Vite',
+        database: 'PostgreSQL',
+        orm: 'SQLAlchemy',
+        testing: 'Vitest + Pytest',
+    },
+    website: {
+        language: 'TypeScript 5.x',
+        frontend: 'Next.js',
+        testing: 'Vitest',
+    },
+    all: {
+        language: 'TypeScript 5.x / Python 3.11+',
+        backend: 'FastAPI',
+        frontend: 'React + Vite',
+        database: 'PostgreSQL',
+        orm: 'SQLAlchemy',
+        testing: 'Vitest + Pytest',
+    },
+};
+/**
+ * Infer the project's tech stack from available signals.
+ * Priority: snapshot deps > spec mentions > language defaults.
+ *
+ * @param language - The project's output language
+ * @param snapshot - Optional repo snapshot with config file data
+ * @param expandedSpec - Optional expanded specification text
+ * @returns Inferred tech stack
+ */
+export function inferTechStack(language, snapshot, expandedSpec) {
+    const defaults = LANGUAGE_DEFAULTS[language] ?? LANGUAGE_DEFAULTS.python;
+    const detected = { language: defaults.language };
+    // 1. Scan snapshot config_files key_fields for dependency signals
+    //    Only set each field once — first match wins per field.
+    if (snapshot?.config_files) {
+        for (const configFile of snapshot.config_files) {
+            const keyFieldsStr = JSON.stringify(configFile.key_fields).toLowerCase();
+            for (const [pattern, stack] of Object.entries(FRAMEWORK_PATTERNS)) {
+                if (keyFieldsStr.includes(pattern)) {
+                    for (const [key, value] of Object.entries(stack)) {
+                        if (!detected[key]) {
+                            detected[key] = value;
+                        }
+                    }
+                }
+            }
+        }
+    }
+    // 2. Use snapshot test_framework / build_tool if available
+    if (snapshot?.test_framework) {
+        const tfLower = snapshot.test_framework.toLowerCase();
+        for (const [pattern, stack] of Object.entries(FRAMEWORK_PATTERNS)) {
+            if (tfLower.includes(pattern) && stack.testing) {
+                detected.testing = stack.testing;
+            }
+        }
+    }
+    // 3. Scan expandedSpec for framework mentions
+    if (expandedSpec) {
+        const specLower = expandedSpec.toLowerCase();
+        for (const [pattern, stack] of Object.entries(FRAMEWORK_PATTERNS)) {
+            if (specLower.includes(pattern)) {
+                // Only fill in gaps — snapshot deps take priority
+                for (const [key, value] of Object.entries(stack)) {
+                    if (!detected[key]) {
+                        detected[key] = value;
+                    }
+                }
+            }
+        }
+    }
+    // 4. Fill remaining gaps with language defaults
+    for (const [key, value] of Object.entries(defaults)) {
+        if (!detected[key] && value) {
+            detected[key] = value;
+        }
+    }
+    return detected;
+}
+// ─── Template Constraints ───────────────────────────────
+/** Governance constraints added to every generated skill */
+const GOVERNANCE_CONSTRAINTS = [
+    'must_follow_master_plan',
+    'must_follow_architecture',
+    'conflicts_require_change_request',
+];
+/** Tech-stack-specific constraints per role */
+const TECH_CONSTRAINTS = {
+    BACKEND_PROGRAMMER: (ts) => {
+        const c = [];
+        if (ts.backend?.includes('FastAPI'))
+            c.push('fastapi_async_required', 'pydantic_validation');
+        if (ts.backend?.includes('Django'))
+            c.push('django_orm_required');
+        if (ts.backend?.includes('Express'))
+            c.push('express_middleware_pattern');
+        if (ts.testing?.includes('Pytest'))
+            c.push('pytest_testing');
+        if (ts.testing?.includes('Vitest') || ts.testing?.includes('Jest'))
+            c.push('unit_test_required');
+        return c;
+    },
+    FRONTEND_PROGRAMMER: (ts) => {
+        const c = [];
+        if (ts.frontend?.includes('React'))
+            c.push('react_component_pattern');
+        if (ts.frontend?.includes('Next'))
+            c.push('nextjs_app_router');
+        if (ts.testing?.includes('Vitest') || ts.testing?.includes('Jest'))
+            c.push('component_testing');
+        return c;
+    },
+    DB_EXPERT: (ts) => {
+        const c = [];
+        if (ts.database?.includes('PostgreSQL'))
+            c.push('postgresql_best_practices');
+        if (ts.orm?.includes('SQLAlchemy'))
+            c.push('sqlalchemy_migrations');
+        if (ts.orm?.includes('Prisma'))
+            c.push('prisma_schema');
+        return c;
+    },
+    WEBSITE_PROGRAMMER: (ts) => {
+        const c = [];
+        if (ts.frontend?.includes('Next'))
+            c.push('nextjs_ssg_ssr');
+        c.push('seo_required', 'responsive_design');
+        return c;
+    },
+};
+/**
+ * Get deterministic template constraints for a role based on tech stack.
+ *
+ * @param role - Pipeline role
+ * @param techStack - Inferred tech stack
+ * @returns Array of constraint identifiers
+ */
+export function getTemplateConstraints(role, techStack) {
+    const techFn = TECH_CONSTRAINTS[role];
+    const techConstraints = techFn ? techFn(techStack) : [];
+    return [...GOVERNANCE_CONSTRAINTS, ...techConstraints];
+}
+//# sourceMappingURL=role-map.js.map

package/dist/pipeline/skills/role-map.js.map

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

package/dist/pipeline/skills/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Type definitions for project-specific skill and constitution generation.
+ */
+import type { OutputLanguage } from '../../types/project.js';
+import type { PipelineRole, RepoSnapshot } from '../types.js';
+export interface TechStack {
+    backend?: string;
+    frontend?: string;
+    database?: string;
+    orm?: string;
+    testing?: string;
+    language?: string;
+}
+export interface SkillGenerationContext {
+    language: OutputLanguage;
+    expandedSpec: string;
+    snapshot: RepoSnapshot;
+    userDocs?: string;
+    sessionGuidance?: string;
+    brandContext?: {
+        logoPath?: string;
+        primaryColor?: string;
+    };
+    activeRoles: PipelineRole[];
+    skillsDir: string;
+    projectName: string;
+}
+export interface ConstitutionContext {
+    language: OutputLanguage;
+    projectName: string;
+    techStack: TechStack;
+    expandedSpec: string;
+    sessionGuidance?: string;
+    brandContext?: {
+        logoPath?: string;
+        primaryColor?: string;
+    };
+    skillsDir: string;
+}
+export interface SkillsGenerationMarker {
+    timestamp: string;
+    pipelineVersion: string;
+    activeRoles: string[];
+    techStack: TechStack;
+    aiGenerated: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/pipeline/skills/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/pipeline/skills/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI9D,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,cAAc,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,WAAW,EAAE,YAAY,EAAE,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB"}

package/dist/pipeline/skills/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for project-specific skill and constitution generation.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pipeline/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/pipeline/skills/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/pipeline/type-defs/artifacts.d.ts

@@ -27,6 +27,8 @@ export declare const ArtifactTypeSchema: z.ZodEnum<{
     resolved_commands: "resolved_commands";
     constitution: "constitution";
     change_request: "change_request";
+    additional_context: "additional_context";
+    skill_generation_log: "skill_generation_log";
 }>;
 export type ArtifactType = z.infer<typeof ArtifactTypeSchema>;
 export declare const ContentTypeSchema: z.ZodEnum<{
@@ -65,6 +67,8 @@ export declare const ArtifactRefSchema: z.ZodObject<{
         resolved_commands: "resolved_commands";
         constitution: "constitution";
         change_request: "change_request";
+        additional_context: "additional_context";
+        skill_generation_log: "skill_generation_log";
     }>;
 }, z.core.$strip>;
 export type ArtifactRef = z.infer<typeof ArtifactRefSchema>;
@@ -96,6 +100,8 @@ export declare const ArtifactEntrySchema: z.ZodObject<{
         resolved_commands: "resolved_commands";
         constitution: "constitution";
         change_request: "change_request";
+        additional_context: "additional_context";
+        skill_generation_log: "skill_generation_log";
     }>;
     phase: z.ZodEnum<{
         INTAKE: "INTAKE";
@@ -158,6 +164,8 @@ export declare const DependencyEdgeSchema: z.ZodObject<{
             resolved_commands: "resolved_commands";
             constitution: "constitution";
             change_request: "change_request";
+            additional_context: "additional_context";
+            skill_generation_log: "skill_generation_log";
         }>;
     }, z.core.$strip>;
     to: z.ZodObject<{
@@ -190,6 +198,8 @@ export declare const DependencyEdgeSchema: z.ZodObject<{
             resolved_commands: "resolved_commands";
             constitution: "constitution";
             change_request: "change_request";
+            additional_context: "additional_context";
+            skill_generation_log: "skill_generation_log";
         }>;
     }, z.core.$strip>;
     relationship: z.ZodEnum<{

package/dist/pipeline/type-defs/artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../../src/pipeline/type-defs/artifacts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;EAyB7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,eAAO,MAAM,iBAAiB;;;EAA+B,CAAC;AAC9D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAI5D,sDAAsD;AACtD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAM5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAI5D,wDAAwD;AACxD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAY9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE,wCAAwC;AACxC,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAI/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../../src/pipeline/type-defs/artifacts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2B7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,eAAO,MAAM,iBAAiB;;;EAA+B,CAAC;AAC9D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAI5D,sDAAsD;AACtD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAM5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAI5D,wDAAwD;AACxD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAY9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE,wCAAwC;AACxC,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAI/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/pipeline/type-defs/artifacts.js

@@ -29,6 +29,8 @@ export const ArtifactTypeSchema = z.enum([
     'resolved_commands',
     'constitution',
     'change_request',
+    'additional_context',
+    'skill_generation_log',
 ]);
 // ─── Content Type ────────────────────────────────────────
 export const ContentTypeSchema = z.enum(['markdown', 'json']);

package/dist/pipeline/type-defs/artifacts.js.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../../src/pipeline/type-defs/artifacts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,4DAA4D;AAE5D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC;IACvC,aAAa;IACb,cAAc;IACd,WAAW;IACX,WAAW;IACX,aAAa;IACb,cAAc;IACd,YAAY;IACZ,sBAAsB;IACtB,eAAe;IACf,YAAY;IACZ,UAAU;IACV,eAAe;IACf,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,iBAAiB;IACjB,kBAAkB;IAClB,eAAe;IACf,iBAAiB;IACjB,cAAc;IACd,kBAAkB;IAClB,mBAAmB;IACnB,cAAc;IACd,gBAAgB;CACjB,CAAC,CAAC;AAGH,4DAA4D;AAE5D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAG9D,4DAA4D;AAE5D,sDAAsD;AACtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACpC,IAAI,EAAE,kBAAkB;CACzB,CAAC,CAAC;AAGH,4DAA4D;AAE5D,wDAAwD;AACxD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,kBAAkB;IACxB,KAAK,EAAE,mBAAmB;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IAC1B,YAAY,EAAE,iBAAiB;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAGH,4DAA4D;AAE5D,wCAAwC;AACxC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,iBAAiB;IACvB,EAAE,EAAE,iBAAiB;IACrB,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;CACjE,CAAC,CAAC"}
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../../src/pipeline/type-defs/artifacts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,4DAA4D;AAE5D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC;IACvC,aAAa;IACb,cAAc;IACd,WAAW;IACX,WAAW;IACX,aAAa;IACb,cAAc;IACd,YAAY;IACZ,sBAAsB;IACtB,eAAe;IACf,YAAY;IACZ,UAAU;IACV,eAAe;IACf,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,iBAAiB;IACjB,kBAAkB;IAClB,eAAe;IACf,iBAAiB;IACjB,cAAc;IACd,kBAAkB;IAClB,mBAAmB;IACnB,cAAc;IACd,gBAAgB;IAChB,oBAAoB;IACpB,sBAAsB;CACvB,CAAC,CAAC;AAGH,4DAA4D;AAE5D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAG9D,4DAA4D;AAE5D,sDAAsD;AACtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACpC,IAAI,EAAE,kBAAkB;CACzB,CAAC,CAAC;AAGH,4DAA4D;AAE5D,wDAAwD;AACxD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,kBAAkB;IACxB,KAAK,EAAE,mBAAmB;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IAC1B,YAAY,EAAE,iBAAiB;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAGH,4DAA4D;AAE5D,wCAAwC;AACxC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,iBAAiB;IACvB,EAAE,EAAE,iBAAiB;IACrB,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;CACjE,CAAC,CAAC"}