sofia-cli 0.1.2 → 0.1.4

package/docs/architecture.md

@@ -16,7 +16,8 @@ src/
 ├── develop/                 # PoC generation & Ralph loop
 │   ├── index.ts             # Barrel export
 │   ├── ralphLoop.ts         # Autonomous iteration orchestrator
-│   ├── pocScaffolder.ts     # PoC project scaffolding + output validation
+│   ├── pocUtils.ts          # PoC output validation & scaffold utilities
+│   ├── dynamicScaffolder.ts # LLM-driven dynamic PoC scaffolding
 │   ├── codeGenerator.ts     # LLM-driven code generation & prompt building
 │   ├── testRunner.ts        # Test execution and result parsing
 │   ├── mcpContextEnricher.ts# MCP-driven context enrichment (Context7, Azure, web search)

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "sofia-cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "private": false,
   "type": "module",
   "main": "dist/src/cli/index.js",
+  "license": "MIT",
   "bin": {
     "sofia": "dist/src/cli/index.js"
   },
@@ -12,7 +13,7 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json && npm run build:assets",
-    "build:assets": "cp -r src/prompts/ dist/src/ && cp src/shared/data/cards.json dist/src/shared/data/",
+    "build:assets": "cp -r src/prompts/ dist/src/ && cp src/shared/data/cards.json dist/src/shared/data/ && cp -r infra/ dist/infra/ ",
     "dev": "tsx watch src/cli/index.ts",
     "start": "tsx src/cli/index.ts",
     "clean": "rimraf dist coverage .nyc_output",
@@ -27,7 +28,8 @@
     "test:e2e": "vitest run tests/e2e",
     "test:live": "vitest run --config vitest.live.config.ts",
     "sofiacli": "node --enable-source-maps dist/cli/index.js",
-    "sofia": "npm run sofiacli"
+    "sofia": "npm run sofiacli",
+    "prepublishOnly": "npm run build && npm link"
   },
   "dependencies": {
     "@azure/ai-projects": "^2.0.0-beta.5",

package/src/cli/developCommand.ts

@@ -20,7 +20,6 @@ import { RalphLoop } from '../develop/ralphLoop.js';
 import { McpContextEnricher } from '../develop/mcpContextEnricher.js';
 import { deriveCheckpointState } from '../develop/checkpointState.js';
 import { createDefaultRegistry, selectTemplate } from '../develop/templateRegistry.js';
-import { PocScaffolder } from '../develop/pocScaffolder.js';
 
 // ── Types ────────────────────────────────────────────────────────────────────
 
@@ -221,7 +220,6 @@ export async function developCommand(
     outputDir,
     enricher,
     checkpoint,
-    scaffolder: new PocScaffolder(template),
     templateEntry: template,
     onSessionUpdate: async (updated) => {
       await store.save(updated);
@@ -293,7 +291,7 @@ export async function developCommand(
           'Recovery options:',
           `  • Resume: sofia dev --session ${sessionId}`,
           `  • More iterations: sofia dev --session ${sessionId} --max-iterations 20`,
-                    `  • More iterations: sofia dev --session ${sessionId} --max-iterations 30`,
+          `  • More iterations: sofia dev --session ${sessionId} --max-iterations 30`,
           `  • Start fresh: sofia dev --session ${sessionId} --force`,
           '',
         ].join('\n'),

package/src/cli/index.ts

@@ -8,6 +8,7 @@
  * - status: display session status
  * - export: export session artifacts
  */
+import { existsSync, readFileSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { Command } from 'commander';
@@ -19,6 +20,15 @@ import type { PhaseValue } from '../shared/schemas/session.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 loadEnvFile(path.resolve(__dirname, '../../.env'));
 
+// ── Read version from package.json (works from both src/ and dist/) ────────
+let _pkgRoot = __dirname;
+while (_pkgRoot !== path.dirname(_pkgRoot) && !existsSync(path.join(_pkgRoot, 'package.json'))) {
+  _pkgRoot = path.dirname(_pkgRoot);
+}
+const { version } = JSON.parse(readFileSync(path.join(_pkgRoot, 'package.json'), 'utf-8')) as {
+  version: string;
+};
+
 // ── Handler types ──────────────────────────────────────────────────────────
 
 export interface CliHandlers {
@@ -36,7 +46,7 @@ export interface CliHandlers {
 export function buildCli(handlers?: Partial<CliHandlers>): Command {
   const program = new Command();
 
-  program.name('sofia').description('sofIA — AI Discovery Workshop CLI').version('0.1.0');
+  program.name('sofia').description('sofIA — AI Discovery Workshop CLI').version(version);
 
   // ── Global options ──────────────────────────────────────────────────────
 

package/src/cli/workshopCommand.ts

@@ -19,7 +19,11 @@ import { createPhaseHandler, getPhaseOrder, getNextPhase } from '../phases/phase
 import type { PhaseHandlerConfig } from '../phases/phaseHandlers.js';
 import type { SofiaEvent } from '../shared/events.js';
 import { renderMarkdown } from '../shared/markdownRenderer.js';
-import { destroyWebSearchSession, isWebSearchConfigured, createWebSearchTool } from '../mcp/webSearch.js';
+import {
+  destroyWebSearchSession,
+  isWebSearchConfigured,
+  createWebSearchTool,
+} from '../mcp/webSearch.js';
 import type { WebSearchConfig } from '../mcp/webSearch.js';
 import { loadEnvFile } from './envLoader.js';
 import { loadMcpConfig, McpManager } from '../mcp/mcpManager.js';
@@ -211,7 +215,7 @@ async function runWorkshop(
                 session.plan?.architectureNotes,
                 session.plan?.dependencies,
               );
-              
+
               const ralphLoop = new RalphLoop({
                 client,
                 io,
@@ -232,18 +236,18 @@ async function runWorkshop(
                 checkpoint,
                 templateEntry,
               });
-              
+
               const result = await ralphLoop.run();
               session = result.session;
-              
+
               if (result.finalStatus === 'success') {
                 io.write(
                   renderMarkdown(
                     `\n✅ PoC generated successfully in ${result.outputDir}\n\n` +
-                    `Next steps:\n` +
-                    `- Review the generated code\n` +
-                    `- Run tests: \`cd ${result.outputDir} && npm test\`\n` +
-                    `- Continue developing: \`sofia dev --session ${session.sessionId}\`\n`,
+                      `Next steps:\n` +
+                      `- Review the generated code\n` +
+                      `- Run tests: \`cd ${result.outputDir} && npm test\`\n` +
+                      `- Continue developing: \`sofia dev --session ${session.sessionId}\`\n`,
                     { isTTY: io.isTTY },
                   ),
                 );
@@ -251,10 +255,10 @@ async function runWorkshop(
                 io.write(
                   renderMarkdown(
                     `\n⚠️  PoC generation incomplete (${result.terminationReason})\n\n` +
-                    `The workshop can continue. To retry or resume PoC development:\n` +
-                    `\`\`\`\n` +
-                    `sofia dev --session ${session.sessionId}\n` +
-                    `\`\`\`\n`,
+                      `The workshop can continue. To retry or resume PoC development:\n` +
+                      `\`\`\`\n` +
+                      `sofia dev --session ${session.sessionId}\n` +
+                      `\`\`\`\n`,
                     { isTTY: io.isTTY },
                   ),
                 );
@@ -264,15 +268,15 @@ async function runWorkshop(
               io.write(
                 renderMarkdown(
                   `\n⚠️  PoC generation failed: ${msg}\n\n` +
-                  `The workshop can continue. To retry:\n` +
-                  `\`\`\`\n` +
-                  `sofia dev --session ${session.sessionId}\n` +
-                  `\`\`\`\n`,
+                    `The workshop can continue. To retry:\n` +
+                    `\`\`\`\n` +
+                    `sofia dev --session ${session.sessionId}\n` +
+                    `\`\`\`\n`,
                   { isTTY: io.isTTY },
                 ),
               );
             }
-            
+
             // Continue to next phase regardless of PoC outcome
           }
           currentPhaseIdx = phaseOrder.indexOf(next);

package/src/develop/dynamicScaffolder.ts

@@ -47,7 +47,7 @@ function buildScaffoldPrompt(session: WorkshopSession): string {
   const idea = session.ideas?.find((i) => i.id === session.selection?.ideaId);
   const ideaTitle = idea?.title ?? session.selection?.ideaId ?? 'AI Solution';
   const ideaDescription = idea?.description ?? 'AI-powered solution from workshop';
-  
+
   const businessContext = session.businessContext
     ? `## Business Context\n\n` +
       `Company: ${session.businessContext.businessDescription}\n\n` +
@@ -124,40 +124,44 @@ Focus on **quality over quantity** - generate files that matter for demonstratin
  */
 function parseCodeBlocks(response: string): Array<{ file: string; content: string }> {
   const blocks: Array<{ file: string; content: string }> = [];
-  
+
   // Match fenced code blocks with file= attribute
   const regex = /```(?:\w+)?\s+file=([^\s]+)\n([\s\S]*?)```/g;
   let match;
-  
+
   while ((match = regex.exec(response)) !== null) {
     const file = match[1].trim();
     const content = match[2];
     blocks.push({ file, content });
   }
-  
+
   return blocks;
 }
 
 /**
  * Infer tech stack from generated files.
  */
-function inferTechStack(files: Array<{ file: string; content: string }>): DynamicScaffoldResult['techStack'] {
+function inferTechStack(
+  files: Array<{ file: string; content: string }>,
+): DynamicScaffoldResult['techStack'] {
   const hasPackageJson = files.some((f) => f.file === 'package.json');
   const hasTypeScript = files.some((f) => f.file.endsWith('.ts') || f.file === 'tsconfig.json');
-  const hasPython = files.some((f) => f.file.endsWith('.py') || f.file === 'requirements.txt' || f.file === 'pyproject.toml');
-  
+  const hasPython = files.some(
+    (f) => f.file.endsWith('.py') || f.file === 'requirements.txt' || f.file === 'pyproject.toml',
+  );
+
   // Try to parse package.json for more details
   let testRunner = 'npm test';
   let framework: string | undefined;
   let buildCommand: string | undefined;
-  
+
   const packageJson = files.find((f) => f.file === 'package.json');
   if (packageJson) {
     try {
       const pkg = JSON.parse(packageJson.content);
       testRunner = pkg.scripts?.test ?? 'npm test';
       buildCommand = pkg.scripts?.build;
-      
+
       // Detect framework from dependencies
       if (pkg.dependencies?.['express'] || pkg.devDependencies?.['express']) framework = 'Express';
       if (pkg.dependencies?.['react'] || pkg.devDependencies?.['react']) framework = 'React';
@@ -166,7 +170,7 @@ function inferTechStack(files: Array<{ file: string; content: string }>): Dynami
       // Ignore parse errors
     }
   }
-  
+
   if (hasTypeScript) {
     return {
       language: 'TypeScript',
@@ -176,7 +180,7 @@ function inferTechStack(files: Array<{ file: string; content: string }>): Dynami
       buildCommand,
     };
   }
-  
+
   if (hasPython) {
     return {
       language: 'Python',
@@ -185,7 +189,7 @@ function inferTechStack(files: Array<{ file: string; content: string }>): Dynami
       buildCommand: undefined,
     };
   }
-  
+
   // Default to Node.js
   return {
     language: hasPackageJson ? 'JavaScript' : 'TypeScript',
@@ -199,7 +203,7 @@ function inferTechStack(files: Array<{ file: string; content: string }>): Dynami
 
 /**
  * Generate initial PoC scaffold using LLM.
- * 
+ *
  * Replaces the template-based PocScaffolder with dynamic generation
  * that's grounded in the workshop session context.
  */
@@ -207,49 +211,50 @@ export async function generateDynamicScaffold(
   context: DynamicScaffoldContext,
 ): Promise<DynamicScaffoldResult> {
   const { session, outputDir, client } = context;
-  
+
   // Build comprehensive prompt from session
   const prompt = buildScaffoldPrompt(session);
-  
+
   // Create conversation session with system prompt
   const conversationSession = await client.createSession({
-    systemPrompt: 'You are a senior software architect generating proof-of-concept project structures for AI solutions.',
+    systemPrompt:
+      'You are a senior software architect generating proof-of-concept project structures for AI solutions.',
   });
-  
+
   // Send user prompt and collect response
   let fullResponse = '';
   const stream = conversationSession.send({
     role: 'user',
     content: prompt,
   });
-  
+
   for await (const event of stream) {
     if (event.type === 'TextDelta') {
       fullResponse += event.text;
     }
   }
-  
+
   // Parse file blocks from response
   const files = parseCodeBlocks(fullResponse);
-  
+
   if (files.length === 0) {
     throw new Error('LLM did not generate any files. Response: ' + fullResponse.substring(0, 500));
   }
-  
+
   // Write files to disk
   const createdFiles: string[] = [];
-  
+
   for (const { file, content } of files) {
     const fullPath = join(outputDir, file);
-    
+
     // Ensure directory exists
     await mkdir(dirname(fullPath), { recursive: true });
-    
+
     // Write file
     await writeFile(fullPath, content, 'utf-8');
     createdFiles.push(file);
   }
-  
+
   // Export workshop documentation
   try {
     const workshopResult = await exportWorkshopDocs(session, outputDir);
@@ -257,26 +262,27 @@ export async function generateDynamicScaffold(
   } catch {
     // Non-fatal - PoC is still usable without workshop docs
   }
-  
+
   // Create .sofia-metadata.json
   const metadata = {
     sessionId: session.sessionId,
     featureSpec: '002-poc-generation',
     generatedAt: new Date().toISOString(),
-    ideaTitle: session.ideas?.find((i) => i.id === session.selection?.ideaId)?.title ?? 'AI Solution',
+    ideaTitle:
+      session.ideas?.find((i) => i.id === session.selection?.ideaId)?.title ?? 'AI Solution',
     totalIterations: 0,
     finalStatus: null,
     terminationReason: null,
     generatedBy: 'dynamic-scaffold',
   };
-  
+
   const metadataPath = join(outputDir, '.sofia-metadata.json');
   await writeFile(metadataPath, JSON.stringify(metadata, null, 2) + '\n', 'utf-8');
   createdFiles.push('.sofia-metadata.json');
-  
+
   // Infer tech stack from generated files
   const techStack = inferTechStack(files);
-  
+
   return {
     createdFiles,
     techStack,

package/src/develop/index.ts

@@ -5,8 +5,19 @@
  * Orchestrates: scaffold → install → iterate (test → fix → repeat) → complete.
  */
 
-export { PocScaffolder } from './pocScaffolder.js';
-export type { ScaffoldContext, ScaffoldResult } from './pocScaffolder.js';
+export {
+  validatePocOutput,
+  initializeGitRepo,
+  scanAndRecordTodos,
+  toKebabCase,
+  buildScaffoldContext,
+} from './pocUtils.js';
+export type {
+  ScaffoldContext,
+  ScaffoldResult,
+  TemplateFile,
+  ValidationResult,
+} from './pocUtils.js';
 
 export { generateDynamicScaffold } from './dynamicScaffolder.js';
 export type { DynamicScaffoldContext, DynamicScaffoldResult } from './dynamicScaffolder.js';