forgecraft 1.3.3 → 2.0.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-type StoryStatus = "planned" | "designing" | "design-approved" | "building" | "reviewing" | "done" | "blocked";
+type StoryStatus = "planned" | "designing" | "design-approved" | "building" | "testing" | "reviewing" | "done" | "blocked";
 type StoryType = "ui" | "backend" | "fullstack";
 interface Story {
     id: string;
@@ -25,8 +25,8 @@ interface Plan {
     created: string;
     epics: Epic[];
 }
-type Phase = "init" | "plan" | "design" | "build" | "review" | "done";
-type WorkerMode = "design" | "build" | "review" | "fix";
+type Phase = "init" | "plan" | "design" | "build" | "test" | "review" | "done";
+type WorkerMode = "design" | "build" | "test" | "review" | "fix";
 interface QueuedChange {
     type: "visual-tweak" | "redesign" | "bug-fix" | "new-feature" | "content-change";
     message: string;
@@ -206,6 +206,7 @@ interface AutoPipelineOptions {
     mute?: boolean;
     deploy?: boolean;
     skipDesign?: boolean;
+    skipTests?: boolean;
     attachments?: Attachment[];
 }
 declare class AutoPipeline {
@@ -244,6 +245,8 @@ declare class AutoPipeline {
     private designSingleStory;
     private runBuildPhase;
     private buildSingleStory;
+    private runTestPhase;
+    private craftTestPrompt;
     private generateReadme;
     private reviewGate;
     private runReviewPhase;
@@ -334,6 +337,7 @@ declare class StateManager {
         snapshotId?: string;
     }): Promise<void>;
     getConfig(): Promise<ForgeConfig | null>;
+    saveConfig(config: ForgeConfig): Promise<void>;
     isInitialized(): Promise<boolean>;
     saveSnapshot(data: {
         action: string;
@@ -357,7 +361,7 @@ interface FrameworkAdapter {
     /** Human-readable name */
     name: string;
     /** Language used */
-    language: "typescript" | "python";
+    language: "typescript" | "python" | "dart" | "javascript";
     /** Commands to scaffold a new project (run in order) */
     scaffoldCommands: string[];
     /** Command to build the project */
@@ -379,16 +383,134 @@ interface FrameworkAdapter {
     /** Description of the expected project file structure */
     fileStructure: string;
     /** Package manager to use */
-    packageManager: "npm" | "pip" | "poetry";
+    packageManager: "npm" | "pip" | "poetry" | "pub" | "pnpm" | "yarn";
+    /** Test command */
+    testCommand?: string;
+    /** Test framework name */
+    testFramework?: string;
     /** Files that should always exist after scaffold */
     requiredFiles: string[];
 }
 
+/** Load custom adapters from .forge/adapters/ and merge into registry */
+declare function refreshAdapters(workingDir?: string): Promise<void>;
 /** Get the adapter for a framework. Throws if unknown. */
 declare function getAdapter(framework: string): FrameworkAdapter;
 /** List all supported frameworks */
 declare function listAdapters(): FrameworkAdapter[];
 
+interface AppTemplate {
+    id: string;
+    name: string;
+    description: string;
+    category: "saas" | "ecommerce" | "dashboard" | "portfolio" | "social" | "utility";
+    suggestedFrameworks: string[];
+    planDescription: string;
+}
+declare function getTemplate(id: string): AppTemplate | undefined;
+declare function listTemplates(): AppTemplate[];
+
+interface CostEstimate {
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    estimatedCostUsd: number;
+    perStory: {
+        storyId: string;
+        title: string;
+        inputTokens: number;
+        outputTokens: number;
+        costUsd: number;
+    }[];
+    model: string;
+}
+declare function estimateCost(plan: Plan, model?: string): CostEstimate;
+declare function formatCostEstimate(est: CostEstimate): string;
+
+declare function generateGitHubActions(adapter: FrameworkAdapter): string;
+declare function generateGitLabCI(adapter: FrameworkAdapter): string;
+
+interface ProjectFile {
+    /** Relative path from project root */
+    path: string;
+    /** File extension without dot */
+    ext: string;
+    /** File size in bytes */
+    size: number;
+    /** Auto-detected role */
+    role: FileRole;
+    /** Short description of what this file does */
+    description: string;
+    /** Imports this file makes (relative paths resolved) */
+    imports: string[];
+    /** Named exports from this file */
+    exports: string[];
+    /** API routes defined in this file */
+    routes: RouteInfo[];
+    /** Component names defined (React, Vue, Svelte) */
+    components: string[];
+    /** Category for grouping in the UI */
+    category: FileCategory;
+    /** Lines of code */
+    lines: number;
+    /** First 25 lines of file content */
+    preview: string;
+    /** Whether this file has a matching test file */
+    hasTests: boolean;
+}
+type FileRole = "page" | "component" | "layout" | "api-route" | "middleware" | "hook" | "utility" | "model" | "service" | "config" | "style" | "test" | "asset" | "entry" | "store" | "type" | "unknown";
+type FileCategory = "pages" | "components" | "api" | "data" | "config" | "styles" | "tests" | "assets" | "utilities" | "types";
+interface RouteInfo {
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "ALL";
+    path: string;
+    handler: string;
+}
+interface DependencyEdge {
+    from: string;
+    to: string;
+    type: "import" | "dynamic-import" | "route";
+}
+interface ProjectGraph {
+    files: ProjectFile[];
+    edges: DependencyEdge[];
+    framework: string;
+    totalFiles: number;
+    totalLines: number;
+    languages: Record<string, number>;
+    entryPoints: string[];
+    apiRoutes: RouteInfo[];
+    circularDeps: string[][];
+    orphanFiles: string[];
+    healthScore: {
+        grade: string;
+        score: number;
+        details: {
+            avgFileSize: number;
+            testRatio: number;
+            circularCount: number;
+            orphanCount: number;
+            maxComplexity: number;
+        };
+    };
+    apiDocs: {
+        method: string;
+        path: string;
+        handler: string;
+        params: string[];
+        description: string;
+    }[];
+    scanTimestamp: number;
+}
+
+interface VisualizerOptions {
+    workingDir?: string;
+    outputPath?: string;
+    open?: boolean;
+}
+declare function generateVisualization(options?: VisualizerOptions): Promise<{
+    outputPath: string;
+    graph: ProjectGraph;
+}>;
+
 interface ConfigValidation {
     valid: boolean;
     errors: string[];
@@ -400,8 +522,8 @@ declare function loadAndValidateConfig(raw: any): ForgeConfig | null;
 
 /**
  * Play a system notification sound (fire-and-forget).
- * Skips silently if not a TTY.
+ * Skips silently if not a TTY or if the sound command fails.
  */
 declare function playSound(): void;
 
-export { AutoPipeline, type ConfigValidation, type DesignMeta, type Epic, type ForgeConfig, type FrameworkAdapter, GitManager, type HistoryEntry, Orchestrator, type OrchestratorDecision, type Phase, Pipeline, type Plan, type QueuedChange, type Snapshot, type SprintState, type Story, type StoryStatus, type StoryType, Worker, type WorkerMode, type WorkerProgressCallback, type WorkerResult, type WorkerUsage, getAdapter, listAdapters, loadAndValidateConfig, playSound, stateManager, validateConfig };
+export { AutoPipeline, type ConfigValidation, type DesignMeta, type Epic, type ForgeConfig, type FrameworkAdapter, GitManager, type HistoryEntry, Orchestrator, type OrchestratorDecision, type Phase, Pipeline, type Plan, type QueuedChange, type Snapshot, type SprintState, type Story, type StoryStatus, type StoryType, Worker, type WorkerMode, type WorkerProgressCallback, type WorkerResult, type WorkerUsage, estimateCost, formatCostEstimate, generateGitHubActions, generateGitLabCI, generateVisualization, getAdapter, getTemplate, listAdapters, listTemplates, loadAndValidateConfig, playSound, refreshAdapters, stateManager, validateConfig };

package/dist/index.js

@@ -4,23 +4,39 @@ import {
   Orchestrator,
   Pipeline,
   Worker,
+  estimateCost,
+  formatCostEstimate,
+  generateGitHubActions,
+  generateGitLabCI,
+  generateVisualization,
   getAdapter,
+  getTemplate,
   listAdapters,
+  listTemplates,
   loadAndValidateConfig,
   playSound,
+  refreshAdapters,
   stateManager,
   validateConfig
-} from "./chunk-CKB64IR3.js";
+} from "./chunk-U6CZUA5R.js";
 export {
   AutoPipeline,
   GitManager,
   Orchestrator,
   Pipeline,
   Worker,
+  estimateCost,
+  formatCostEstimate,
+  generateGitHubActions,
+  generateGitLabCI,
+  generateVisualization,
   getAdapter,
+  getTemplate,
   listAdapters,
+  listTemplates,
   loadAndValidateConfig,
   playSound,
+  refreshAdapters,
   stateManager,
   validateConfig
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "forgecraft",
-  "version": "1.3.3",
-  "description": "AI Development Orchestration Framework — structured multi-agent pipeline for building software with human oversight",
+  "version": "2.0.0",
+  "description": "One command. No prompts. Come back to a full app pushed to GitHub. Autonomous AI that plans, builds, reviews, and deploys — zero human intervention.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -54,7 +54,13 @@
     "nextjs",
     "react",
     "django",
-    "pipeline"
+    "vue",
+    "nuxt",
+    "svelte",
+    "sveltekit",
+    "flutter",
+    "pipeline",
+    "testing"
   ],
   "license": "MIT",
   "repository": {