sofia-cli 0.1.1 → 0.1.4

package/dist/src/develop/pocUtils.js

@@ -0,0 +1,228 @@
+/**
+ * PoC Utilities.
+ *
+ * Standalone helper functions and types extracted from the former
+ * PocScaffolder class: git init, TODO scanning, output validation,
+ * and shared type definitions used by the scaffold / Ralph loop pipeline.
+ */
+import { writeFile, access, readFile, readdir, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+// ── Helpers ──────────────────────────────────────────────────────────────────
+/**
+ * Convert an idea title to a kebab-case project name.
+ */
+export function toKebabCase(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .substring(0, 64);
+}
+async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ── Build Context ────────────────────────────────────────────────────────────
+/**
+ * Build a ScaffoldContext from a workshop session.
+ */
+export function buildScaffoldContext(session, outputDir, templateEntry) {
+    const idea = session.ideas?.find((i) => i.id === session.selection?.ideaId);
+    const ideaTitle = idea?.title ?? 'AI PoC';
+    const ideaDescription = idea?.description ?? 'A proof-of-concept AI application.';
+    const planSummary = session.plan?.architectureNotes
+        ? session.plan.architectureNotes
+        : (session.plan?.milestones?.map((m) => m.title).join(', ') ?? 'See plan for details');
+    const techStack = templateEntry?.techStack
+        ? { ...templateEntry.techStack }
+        : {
+            language: 'TypeScript',
+            runtime: 'Node.js 20',
+            testRunner: 'npm test',
+            buildCommand: 'npm run build',
+            framework: undefined,
+        };
+    // Infer framework from plan if present
+    if (session.plan?.architectureNotes) {
+        const notes = session.plan.architectureNotes.toLowerCase();
+        if (notes.includes('express'))
+            techStack.framework = 'Express';
+        else if (notes.includes('fastapi'))
+            techStack.framework = 'FastAPI';
+        else if (notes.includes('next'))
+            techStack.framework = 'Next.js';
+    }
+    return {
+        projectName: toKebabCase(ideaTitle),
+        ideaTitle,
+        ideaDescription,
+        techStack,
+        planSummary,
+        sessionId: session.sessionId,
+        outputDir,
+    };
+}
+// ── Git Initialization ───────────────────────────────────────────────────────
+/**
+ * Initialize a local git repository in the output directory.
+ * Creates an initial commit with all scaffold files.
+ *
+ * @param outputDir The directory to initialize git in
+ * @returns true if successful, false otherwise
+ */
+export async function initializeGitRepo(outputDir) {
+    try {
+        const gitDir = join(outputDir, '.git');
+        const exists = await fileExists(gitDir);
+        if (exists) {
+            return true; // Already initialized
+        }
+        execSync('git init', { cwd: outputDir, stdio: 'ignore' });
+        execSync('git add .', { cwd: outputDir, stdio: 'ignore' });
+        execSync('git commit -m "chore: initial scaffold from sofIA"', {
+            cwd: outputDir,
+            stdio: 'ignore',
+            env: {
+                ...process.env,
+                GIT_AUTHOR_NAME: 'sofIA',
+                GIT_AUTHOR_EMAIL: 'sofia@workshop.local',
+                GIT_COMMITTER_NAME: 'sofIA',
+                GIT_COMMITTER_EMAIL: 'sofia@workshop.local',
+            },
+        });
+        return true;
+    }
+    catch (_err) {
+        return false;
+    }
+}
+// ── TODO Scanning ────────────────────────────────────────────────────────────
+/**
+ * Scan scaffold files for TODO markers and update .sofia-metadata.json.
+ */
+export async function scanAndRecordTodos(outputDir) {
+    const markers = [];
+    async function scanDir(dir, base) {
+        let entries;
+        try {
+            entries = await readdir(dir);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry === 'node_modules' || entry === '.git' || entry === 'dist')
+                continue;
+            const full = join(dir, entry);
+            const rel = base ? `${base}/${entry}` : entry;
+            let s;
+            try {
+                s = await stat(full);
+            }
+            catch {
+                continue;
+            }
+            if (s.isDirectory()) {
+                await scanDir(full, rel);
+            }
+            else if (s.isFile()) {
+                try {
+                    const content = await readFile(full, 'utf-8');
+                    const lines = content.split('\n');
+                    for (let i = 0; i < lines.length; i++) {
+                        if (lines[i].includes('TODO:')) {
+                            markers.push(`${rel}:${i + 1}: ${lines[i].trim()}`);
+                        }
+                    }
+                }
+                catch {
+                    // skip binary or unreadable files
+                }
+            }
+        }
+    }
+    await scanDir(outputDir, '');
+    const todos = {
+        totalInitial: markers.length,
+        remaining: markers.length,
+        markers,
+    };
+    // Update .sofia-metadata.json with TODO info
+    const metadataPath = join(outputDir, '.sofia-metadata.json');
+    try {
+        const raw = await readFile(metadataPath, 'utf-8');
+        const metadata = JSON.parse(raw);
+        metadata.todos = todos;
+        await writeFile(metadataPath, JSON.stringify(metadata, null, 2) + '\n', 'utf-8');
+    }
+    catch {
+        // Metadata file may not exist yet
+    }
+    return todos;
+}
+// ── Output Validator ─────────────────────────────────────────────────────────
+/**
+ * Validate that a scaffold directory meets the poc-output contract requirements.
+ */
+export async function validatePocOutput(outputDir) {
+    const requiredFiles = [
+        'package.json',
+        'README.md',
+        'tsconfig.json',
+        '.gitignore',
+        '.sofia-metadata.json',
+    ];
+    const missingFiles = [];
+    const errors = [];
+    for (const file of requiredFiles) {
+        const exists = await fileExists(join(outputDir, file));
+        if (!exists) {
+            missingFiles.push(file);
+        }
+    }
+    if (!missingFiles.includes('package.json')) {
+        try {
+            const pkgContent = await readFile(join(outputDir, 'package.json'), 'utf-8');
+            const pkg = JSON.parse(pkgContent);
+            if (!pkg.scripts?.test) {
+                errors.push('package.json is missing "test" script');
+            }
+        }
+        catch {
+            errors.push('package.json is not valid JSON');
+        }
+    }
+    let hasSrcTs = false;
+    try {
+        const srcFiles = await readdir(join(outputDir, 'src'));
+        hasSrcTs = srcFiles.some((f) => f.endsWith('.ts'));
+    }
+    catch {
+        // src/ doesn't exist
+    }
+    if (!hasSrcTs) {
+        errors.push('No TypeScript files found in src/');
+    }
+    let hasTestFile = false;
+    try {
+        const testFiles = await readdir(join(outputDir, 'tests'));
+        hasTestFile = testFiles.some((f) => f.endsWith('.test.ts'));
+    }
+    catch {
+        // tests/ doesn't exist
+    }
+    if (!hasTestFile) {
+        errors.push('No test files found in tests/');
+    }
+    return {
+        valid: missingFiles.length === 0 && errors.length === 0,
+        missingFiles,
+        errors,
+    };
+}

package/dist/src/develop/ralphLoop.js

@@ -12,7 +12,7 @@ import { join } from 'node:path';
 import { createActivityEvent } from '../shared/events.js';
 // McpManager import removed - accessed via McpContextEnricher.mcpManager public property
 import { exportWorkshopDocs } from '../sessions/exportWriter.js';
-import { PocScaffolder, validatePocOutput } from './pocScaffolder.js';
+import { initializeGitRepo, scanAndRecordTodos, validatePocOutput } from './pocUtils.js';
 import { generateDynamicScaffold } from './dynamicScaffolder.js';
 import { TestRunner } from './testRunner.js';
 import { CodeGenerator } from './codeGenerator.js';
@@ -174,7 +174,7 @@ export class RalphLoop {
                 io.writeActivity('⚠️  Could not export workshop documentation');
             }
             // Initialize local git repository
-            const gitInitialized = await PocScaffolder.initializeGitRepo(outputDir);
+            const gitInitialized = await initializeGitRepo(outputDir);
             if (gitInitialized) {
                 io.writeActivity('✓ Initialized git repository with initial commit');
                 io.writeActivity('');
@@ -385,7 +385,7 @@ export class RalphLoop {
             }
             // FR-022: Rescan TODO markers after applying changes
             try {
-                await PocScaffolder.scanAndRecordTodos(outputDir);
+                await scanAndRecordTodos(outputDir);
             }
             catch {
                 // Non-critical — ignore scanning errors