@compilr-dev/factory 0.1.21 → 0.1.22

package/dist/all-tools.js

@@ -13,6 +13,7 @@ import { createModelTools } from './model/tools.js';
 import { createResearchModelTools } from './research-model/tools.js';
 import { createResearchScaffoldTool } from './research-model/scaffold-tool.js';
 import { createBusinessModelTools } from './business-model/tools.js';
+import { createBusinessScaffoldTool } from './business-model/scaffold-tool.js';
 import { createFactoryTools } from './factory/tools.js';
 import { writeFileSync, mkdirSync } from 'fs';
 import { dirname } from 'path';
@@ -21,20 +22,27 @@ import { dirname } from 'path';
  * Includes app model, research model, research scaffold, and software factory tools.
  */
 export function createAllFactoryTools(config) {
-    const scaffoldTool = createResearchScaffoldTool({
+    const writeFile = (path, content) => {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, content, 'utf-8');
+        return Promise.resolve();
+    };
+    const researchScaffold = createResearchScaffoldTool({
         context: config.context,
         cwd: config.cwd,
-        writeFile: (path, content) => {
-            mkdirSync(dirname(path), { recursive: true });
-            writeFileSync(path, content, 'utf-8');
-            return Promise.resolve();
-        },
+        writeFile,
+    });
+    const businessScaffold = createBusinessScaffoldTool({
+        context: config.context,
+        cwd: config.cwd,
+        writeFile,
     });
     return [
         ...createModelTools({ context: config.context, cwd: config.cwd }),
         ...createResearchModelTools({ context: config.context }),
         ...createBusinessModelTools({ context: config.context }),
-        scaffoldTool,
+        researchScaffold,
+        businessScaffold,
         ...createFactoryTools({ context: config.context, cwd: config.cwd }),
     ];
 }

package/dist/business-model/index.d.ts

@@ -8,3 +8,7 @@ export { validateBusinessModel } from './schema.js';
 export type { BusinessValidationError, BusinessValidationResult } from './schema.js';
 export { createBusinessModelTools } from './tools.js';
 export type { BusinessModelToolsConfig } from './tools.js';
+export type { BusinessTemplate, BusinessTemplateFile } from './templates/types.js';
+export { startupPitchTemplate, fullPlanTemplate, marketEntryTemplate, productLaunchTemplate, BUSINESS_TEMPLATES, getBusinessTemplate, } from './templates/index.js';
+export { createBusinessScaffoldTool } from './scaffold-tool.js';
+export type { BusinessScaffoldConfig } from './scaffold-tool.js';

package/dist/business-model/index.js

@@ -5,3 +5,6 @@ export { createDefaultBusinessModel, generateBusinessId, resetBusinessIdCounter,
 export { BusinessModelStore } from './persistence.js';
 export { validateBusinessModel } from './schema.js';
 export { createBusinessModelTools } from './tools.js';
+export { startupPitchTemplate, fullPlanTemplate, marketEntryTemplate, productLaunchTemplate, BUSINESS_TEMPLATES, getBusinessTemplate, } from './templates/index.js';
+// Scaffold tool
+export { createBusinessScaffoldTool } from './scaffold-tool.js';

package/dist/business-model/scaffold-tool.d.ts

@@ -0,0 +1,25 @@
+/**
+ * business_scaffold Tool
+ *
+ * Scaffolds a business plan project from a template:
+ * 1. Creates a pre-populated Business Model
+ * 2. Generates folder structure and section files
+ * 3. Creates work items for each section
+ */
+import type { Tool } from '@compilr-dev/agents';
+import type { PlatformContext } from '@compilr-dev/sdk';
+export interface BusinessScaffoldConfig {
+    readonly context: PlatformContext;
+    readonly cwd?: string;
+    readonly writeFile?: (path: string, content: string) => Promise<void>;
+}
+interface BusinessScaffoldInput {
+    template: string;
+    name?: string;
+    stage?: string;
+    dry_run?: boolean;
+    output_dir?: string;
+    project_id?: number;
+}
+export declare function createBusinessScaffoldTool(config: BusinessScaffoldConfig): Tool<BusinessScaffoldInput>;
+export {};

package/dist/business-model/scaffold-tool.js

@@ -0,0 +1,122 @@
+/**
+ * business_scaffold Tool
+ *
+ * Scaffolds a business plan project from a template:
+ * 1. Creates a pre-populated Business Model
+ * 2. Generates folder structure and section files
+ * 3. Creates work items for each section
+ */
+import { defineTool, createSuccessResult, createErrorResult } from '@compilr-dev/agents';
+import { BusinessModelStore } from './persistence.js';
+import { BUSINESS_TEMPLATES, getBusinessTemplate } from './templates/index.js';
+export function createBusinessScaffoldTool(config) {
+    return defineTool({
+        name: 'business_scaffold',
+        description: 'Scaffold a business plan project from a template. Creates a Business Model, generates folder structure and section files, and creates work items.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                template: {
+                    type: 'string',
+                    enum: BUSINESS_TEMPLATES.map((t) => t.id),
+                    description: `Template. Options: ${BUSINESS_TEMPLATES.map((t) => `"${t.id}" (${t.name})`).join(', ')}`,
+                },
+                name: {
+                    type: 'string',
+                    description: 'Business name. Defaults to "My Business".',
+                },
+                stage: {
+                    type: 'string',
+                    enum: ['idea', 'pre-seed', 'seed', 'series-a', 'growth', 'established'],
+                    description: "Business stage. Defaults to the template's default.",
+                },
+                dry_run: {
+                    type: 'boolean',
+                    description: 'Preview without writing files or creating model.',
+                },
+                output_dir: {
+                    type: 'string',
+                    description: 'Output directory. Defaults to project path or cwd.',
+                },
+                project_id: {
+                    type: 'number',
+                    description: 'Project ID. Uses active project if omitted.',
+                },
+            },
+            required: ['template'],
+        },
+        execute: async (input) => {
+            try {
+                const template = getBusinessTemplate(input.template);
+                if (!template) {
+                    return createErrorResult(`Unknown template "${input.template}". Available: ${BUSINESS_TEMPLATES.map((t) => t.id).join(', ')}`);
+                }
+                const name = input.name ?? 'My Business';
+                const stage = input.stage ? input.stage : template.stage;
+                const model = template.createModel(name, stage);
+                const files = template.generateFiles(model);
+                if (input.dry_run) {
+                    return createSuccessResult({
+                        template: template.id,
+                        name,
+                        stage,
+                        phases: model.goToMarket.phases.length,
+                        files: files.map((f) => f.path),
+                        message: 'Dry run — no files written.',
+                    });
+                }
+                // Save model to DB
+                const projectId = input.project_id ?? config.context.currentProjectId;
+                if (projectId) {
+                    const store = new BusinessModelStore({
+                        documents: config.context.documents,
+                        projectId,
+                    });
+                    await store.save(model);
+                }
+                // Write files
+                if (config.writeFile) {
+                    const baseDir = input.output_dir ?? config.cwd ?? '.';
+                    for (const file of files) {
+                        await config.writeFile(`${baseDir}/${file.path}`, file.content);
+                    }
+                }
+                // Create work items for each section
+                const sectionTitles = [
+                    'Executive Summary',
+                    'Problem & Solution',
+                    'Market Analysis',
+                    'Competitive Landscape',
+                    'Business Model',
+                    'Go-to-Market Strategy',
+                    'Financial Projections',
+                    'Team',
+                    'The Ask',
+                ];
+                if (projectId) {
+                    for (const title of sectionTitles) {
+                        await config.context.workItems.create({
+                            project_id: projectId,
+                            type: 'feature',
+                            title: `Draft: ${title}`,
+                            description: `Write the ${title} section of the business plan.`,
+                            priority: title === 'Executive Summary' ? 'low' : 'medium',
+                        });
+                    }
+                }
+                return createSuccessResult({
+                    template: template.id,
+                    name,
+                    stage,
+                    phases: model.goToMarket.phases.length,
+                    files: files.map((f) => f.path),
+                    workItems: sectionTitles.length,
+                    message: `Business plan scaffolded with ${String(files.length)} files and ${String(sectionTitles.length)} work items.`,
+                });
+            }
+            catch (error) {
+                return createErrorResult(error instanceof Error ? error.message : String(error));
+            }
+        },
+    });
+}

package/dist/business-model/templates/full-plan.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Full Business Plan Template
+ *
+ * Comprehensive plan: executive summary, market, competition,
+ * operations, financials, team, funding.
+ */
+import type { BusinessTemplate } from './types.js';
+export declare const fullPlanTemplate: BusinessTemplate;

package/dist/business-model/templates/full-plan.js

@@ -0,0 +1,26 @@
+/**
+ * Full Business Plan Template
+ *
+ * Comprehensive plan: executive summary, market, competition,
+ * operations, financials, team, funding.
+ */
+import { phase, generateCommonFiles, baseModel } from './helpers.js';
+export const fullPlanTemplate = {
+    id: 'full-plan',
+    name: 'Full Business Plan',
+    description: 'Comprehensive business plan — executive summary, market, competition, operations, financials',
+    stage: 'seed',
+    createModel(name, stage) {
+        return baseModel(name, stage ?? 'seed', [
+            phase('Research', 'Market research, competitive analysis, customer interviews'),
+            phase('Strategy', 'Define business model, pricing, go-to-market strategy'),
+            phase('Financials', 'Build financial projections, cost model, break-even analysis'),
+            phase('Document', 'Write all sections of the business plan'),
+            phase('Review', 'Internal review, advisor feedback, investor testing'),
+            phase('Present', 'Finalize pitch materials and present to stakeholders'),
+        ]);
+    },
+    generateFiles(model) {
+        return generateCommonFiles(model, 'full-plan');
+    },
+};

package/dist/business-model/templates/helpers.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared helpers for business plan templates.
+ */
+import type { BusinessModel, BusinessStage, GTMPhase } from '../types.js';
+import type { BusinessTemplateFile } from './types.js';
+/** Create a GTM phase with auto-generated ID */
+export declare function phase(name: string, description: string): GTMPhase;
+/** Generate the standard scaffold files */
+export declare function generateCommonFiles(model: BusinessModel, templateId: string): BusinessTemplateFile[];
+/** Create base model with common fields */
+export declare function baseModel(name: string, stage: BusinessStage, phases: GTMPhase[]): BusinessModel;

package/dist/business-model/templates/helpers.js

@@ -0,0 +1,77 @@
+/**
+ * Shared helpers for business plan templates.
+ */
+import { generateBusinessId } from '../defaults.js';
+/** Create a GTM phase with auto-generated ID */
+export function phase(name, description) {
+    return { id: generateBusinessId('ph'), name, description };
+}
+/** Generate the standard scaffold files */
+export function generateCommonFiles(model, templateId) {
+    const files = [];
+    files.push({
+        path: 'COMPILR.md',
+        content: `# ${model.identity.name}
+
+## Project Type: Business Plan
+**Template:** ${templateId}
+**Stage:** ${model.identity.stage}
+
+## Project Context
+This is a business plan project. The agent team assists with
+market analysis, financial modeling, competitive positioning,
+and pitch preparation.
+
+## Folder Structure
+- \`sections/\` — Business plan sections (one file per section)
+- \`research/\` — Market data, competitor profiles, industry reports
+- \`financials/\` — Spreadsheets, projections, models
+- \`knowledge/\` — Reference material and supporting documents
+
+## Workflow
+1. Run \`/business-vision\` to define the business identity and value proposition
+2. Run \`/market-analysis\` to size the market and define customer segments
+3. Run \`/competitor-analysis\` to map the competitive landscape
+4. Run \`/financial-model\` to build revenue and cost projections
+5. Run \`/pitch-outline\` to structure the investor pitch
+6. Run \`/business-review\` to validate the complete plan
+`,
+    });
+    // Section stub files
+    const sections = [
+        { num: '01', slug: 'executive-summary', title: 'Executive Summary' },
+        { num: '02', slug: 'problem-solution', title: 'Problem & Solution' },
+        { num: '03', slug: 'market-analysis', title: 'Market Analysis' },
+        { num: '04', slug: 'competitive-landscape', title: 'Competitive Landscape' },
+        { num: '05', slug: 'business-model', title: 'Business Model' },
+        { num: '06', slug: 'go-to-market', title: 'Go-to-Market Strategy' },
+        { num: '07', slug: 'financial-projections', title: 'Financial Projections' },
+        { num: '08', slug: 'team', title: 'Team' },
+        { num: '09', slug: 'the-ask', title: 'The Ask' },
+    ];
+    for (const sec of sections) {
+        files.push({
+            path: `sections/${sec.num}-${sec.slug}.md`,
+            content: `# ${sec.title}\n\n<!-- TODO: Draft this section -->\n\n`,
+        });
+    }
+    // Empty directories
+    files.push({ path: 'research/.gitkeep', content: '' });
+    files.push({ path: 'financials/.gitkeep', content: '' });
+    files.push({ path: 'knowledge/.gitkeep', content: '' });
+    return files;
+}
+/** Create base model with common fields */
+export function baseModel(name, stage, phases) {
+    const now = new Date().toISOString();
+    return {
+        identity: { name, stage },
+        valueProposition: { problem: '', solution: '', uniqueValue: '' },
+        market: { segments: [] },
+        competitors: [],
+        canvas: { revenueStreams: [], costStructure: [] },
+        financials: { revenueForecasts: [], expenseForecasts: [] },
+        goToMarket: { phases },
+        meta: { revision: 1, createdAt: now, updatedAt: now },
+    };
+}

package/dist/business-model/templates/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Business Plan Templates — barrel export
+ */
+export type { BusinessTemplate, BusinessTemplateFile } from './types.js';
+import type { BusinessTemplate } from './types.js';
+import { startupPitchTemplate } from './startup-pitch.js';
+import { fullPlanTemplate } from './full-plan.js';
+import { marketEntryTemplate } from './market-entry.js';
+import { productLaunchTemplate } from './product-launch.js';
+export { startupPitchTemplate, fullPlanTemplate, marketEntryTemplate, productLaunchTemplate };
+export declare const BUSINESS_TEMPLATES: readonly BusinessTemplate[];
+export declare function getBusinessTemplate(id: string): BusinessTemplate | undefined;

package/dist/business-model/templates/index.js

@@ -0,0 +1,17 @@
+/**
+ * Business Plan Templates — barrel export
+ */
+import { startupPitchTemplate } from './startup-pitch.js';
+import { fullPlanTemplate } from './full-plan.js';
+import { marketEntryTemplate } from './market-entry.js';
+import { productLaunchTemplate } from './product-launch.js';
+export { startupPitchTemplate, fullPlanTemplate, marketEntryTemplate, productLaunchTemplate };
+export const BUSINESS_TEMPLATES = [
+    startupPitchTemplate,
+    fullPlanTemplate,
+    marketEntryTemplate,
+    productLaunchTemplate,
+];
+export function getBusinessTemplate(id) {
+    return BUSINESS_TEMPLATES.find((t) => t.id === id);
+}

package/dist/business-model/templates/market-entry.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Market Entry Template
+ *
+ * Focused plan for entering a new market or launching in a new geography.
+ */
+import type { BusinessTemplate } from './types.js';
+export declare const marketEntryTemplate: BusinessTemplate;

package/dist/business-model/templates/market-entry.js

@@ -0,0 +1,24 @@
+/**
+ * Market Entry Template
+ *
+ * Focused plan for entering a new market or launching in a new geography.
+ */
+import { phase, generateCommonFiles, baseModel } from './helpers.js';
+export const marketEntryTemplate = {
+    id: 'market-entry',
+    name: 'Market Entry',
+    description: 'Enter a new market — market analysis, competitive landscape, go-to-market plan',
+    stage: 'growth',
+    createModel(name, stage) {
+        return baseModel(name, stage ?? 'growth', [
+            phase('Market Research', 'Analyze target market size, trends, regulations, and barriers'),
+            phase('Competitive Mapping', 'Identify local competitors and differentiation opportunities'),
+            phase('Localization', 'Adapt product, pricing, and messaging for the new market'),
+            phase('Launch', 'Execute market entry with initial partners and channels'),
+            phase('Scale', 'Expand distribution and optimize based on market feedback'),
+        ]);
+    },
+    generateFiles(model) {
+        return generateCommonFiles(model, 'market-entry');
+    },
+};

package/dist/business-model/templates/product-launch.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Product Launch Template
+ *
+ * GTM-focused plan for launching a new product or feature line.
+ */
+import type { BusinessTemplate } from './types.js';
+export declare const productLaunchTemplate: BusinessTemplate;

package/dist/business-model/templates/product-launch.js

@@ -0,0 +1,24 @@
+/**
+ * Product Launch Template
+ *
+ * GTM-focused plan for launching a new product or feature line.
+ */
+import { phase, generateCommonFiles, baseModel } from './helpers.js';
+export const productLaunchTemplate = {
+    id: 'product-launch',
+    name: 'Product Launch',
+    description: 'Launch a new product — positioning, channels, timeline, budget, metrics',
+    stage: 'growth',
+    createModel(name, stage) {
+        return baseModel(name, stage ?? 'growth', [
+            phase('Positioning', 'Define target audience, messaging, and competitive positioning'),
+            phase('Pre-Launch', 'Build landing page, waitlist, early access program'),
+            phase('Beta', 'Limited release to beta users, collect feedback, iterate'),
+            phase('Launch', 'Public launch across all channels'),
+            phase('Post-Launch', 'Monitor metrics, optimize conversion, expand reach'),
+        ]);
+    },
+    generateFiles(model) {
+        return generateCommonFiles(model, 'product-launch');
+    },
+};

package/dist/business-model/templates/startup-pitch.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Startup Pitch Template
+ *
+ * Lean pitch structure for early-stage startups:
+ * Problem → Solution → Market → Traction → Team → Ask
+ */
+import type { BusinessTemplate } from './types.js';
+export declare const startupPitchTemplate: BusinessTemplate;

package/dist/business-model/templates/startup-pitch.js

@@ -0,0 +1,24 @@
+/**
+ * Startup Pitch Template
+ *
+ * Lean pitch structure for early-stage startups:
+ * Problem → Solution → Market → Traction → Team → Ask
+ */
+import { phase, generateCommonFiles, baseModel } from './helpers.js';
+export const startupPitchTemplate = {
+    id: 'startup-pitch',
+    name: 'Startup Pitch',
+    description: 'Lean pitch for early-stage startups — problem, solution, market, traction, team, ask',
+    stage: 'pre-seed',
+    createModel(name, stage) {
+        return baseModel(name, stage ?? 'pre-seed', [
+            phase('Validate', 'Validate problem-solution fit with target customers'),
+            phase('MVP', 'Build minimum viable product and get first users'),
+            phase('Launch', 'Public launch and initial customer acquisition'),
+            phase('Fundraise', 'Prepare pitch deck and close funding round'),
+        ]);
+    },
+    generateFiles(model) {
+        return generateCommonFiles(model, 'startup-pitch');
+    },
+};

package/dist/business-model/templates/types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Business Plan Template Types
+ */
+import type { BusinessModel, BusinessStage } from '../types.js';
+export interface BusinessTemplate {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly stage: BusinessStage;
+    /** Generate the Business Model with pre-populated structure */
+    createModel(name: string, stage?: BusinessStage): BusinessModel;
+    /** Generate scaffold files */
+    generateFiles(model: BusinessModel): BusinessTemplateFile[];
+}
+export interface BusinessTemplateFile {
+    readonly path: string;
+    readonly content: string;
+}

package/dist/business-model/templates/types.js

@@ -0,0 +1,4 @@
+/**
+ * Business Plan Template Types
+ */
+export {};

package/dist/index.d.ts

@@ -29,4 +29,5 @@ export { factoryScaffoldSkill, factorySkills } from './factory/skill.js';
 export type { ResearchModel, Section, SectionStatus, Claim, ClaimType, EvidenceStrength, SourceRef, Source, SourceRelevance, CitationInfo, CitationType, CitationStyle, ResearchQuestion, QuestionStatus, ResearchMeta, ResearchValidationError, ResearchValidationResult, ResearchModelOperation, ResearchModelToolsConfig, BibliographyOptions, BibTeXEntry, ResearchTemplate, ResearchTemplateFile, ResearchScaffoldConfig, } from './research-model/index.js';
 export { createDefaultResearchModel, createDefaultSection, createDefaultClaim, createDefaultSource, createDefaultQuestion, ResearchModelStore, applyResearchOperation, validateResearchModel, createResearchModelTools, generateBibliography, parseBibTeX, RESEARCH_TEMPLATES, getResearchTemplate, apaPaperTemplate, ieeePaperTemplate, thesisTemplate, literatureReviewTemplate, labReportTemplate, createResearchScaffoldTool, } from './research-model/index.js';
 export type { BusinessModel, BusinessIdentity, BusinessStage, ValueProposition, Market, MarketSize, CustomerSegment, Competitor, MarketPosition, BusinessCanvas, RevenueStream, RevenueType, CostItem, Financials, ForecastEntry, GoToMarket, GTMPhase, TeamMember, BusinessMeta, BusinessValidationError, BusinessValidationResult, BusinessModelToolsConfig, } from './business-model/index.js';
-export { createDefaultBusinessModel, BusinessModelStore, validateBusinessModel, createBusinessModelTools, } from './business-model/index.js';
+export { createDefaultBusinessModel, BusinessModelStore, validateBusinessModel, createBusinessModelTools, startupPitchTemplate, fullPlanTemplate, marketEntryTemplate, productLaunchTemplate, BUSINESS_TEMPLATES, getBusinessTemplate, createBusinessScaffoldTool, } from './business-model/index.js';
+export type { BusinessTemplate, BusinessTemplateFile, BusinessScaffoldConfig, } from './business-model/index.js';

package/dist/index.js

@@ -34,4 +34,4 @@ export { reactGoToolkit } from './toolkits/react-go/index.js';
 // Factory skill (Phase 5)
 export { factoryScaffoldSkill, factorySkills } from './factory/skill.js';
 export { createDefaultResearchModel, createDefaultSection, createDefaultClaim, createDefaultSource, createDefaultQuestion, ResearchModelStore, applyResearchOperation, validateResearchModel, createResearchModelTools, generateBibliography, parseBibTeX, RESEARCH_TEMPLATES, getResearchTemplate, apaPaperTemplate, ieeePaperTemplate, thesisTemplate, literatureReviewTemplate, labReportTemplate, createResearchScaffoldTool, } from './research-model/index.js';
-export { createDefaultBusinessModel, BusinessModelStore, validateBusinessModel, createBusinessModelTools, } from './business-model/index.js';
+export { createDefaultBusinessModel, BusinessModelStore, validateBusinessModel, createBusinessModelTools, startupPitchTemplate, fullPlanTemplate, marketEntryTemplate, productLaunchTemplate, BUSINESS_TEMPLATES, getBusinessTemplate, createBusinessScaffoldTool, } from './business-model/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/factory",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "description": "AI-driven application scaffolder for the compilr-dev ecosystem",
   "type": "module",
   "main": "dist/index.js",