@compilr-dev/sdk 0.7.1 → 0.7.3

package/dist/index.d.ts

@@ -61,7 +61,7 @@ export type { AskUserQuestion, AskUserInput, AskUserResult, AskUserHandler, AskU
 export { createPlatformTools, createProjectTools, createWorkItemTools, createDocumentTools, createPlanTools, createBacklogTools, createAnchorTools, createArtifactTools, createEpisodeTools, ProjectAnchorStore, } from './platform/index.js';
 export type { ProjectAnchorStoreConfig } from './platform/index.js';
 export { STEP_ORDER, GUIDED_STEP_CRITERIA, getNextStep, isValidTransition, getStepCriteria, formatStepDisplay, getStepNumber, } from './platform/index.js';
-export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, } from './skills/index.js';
+export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, } from './skills/index.js';
 export { ACTION_REGISTRY, getActionsForContext, getActionById, resolveActionPrompt, buildContextSummary, getSuggestedRole, } from './actions/index.js';
 export type { ActionContext, ActionDefinition } from './actions/index.js';
 export { PROJECT_TYPES, getProjectTypeConfig, getEnrichedProjectTypeConfig, getProjectTypesByCategory, generalConfig, softwareConfig, researchConfig, businessPlanConfig, contentConfig, techDocsConfig, courseConfig, ACTION_META_REGISTRY, SKILL_META_REGISTRY, resolveActionMeta, getSkillMeta, getAllSkillMeta, } from './project-types/index.js';

package/dist/index.js

@@ -139,7 +139,7 @@ export { STEP_ORDER, GUIDED_STEP_CRITERIA, getNextStep, isValidTransition, getSt
 // =============================================================================
 // Platform Skills (platform-specific prompt expansions)
 // =============================================================================
-export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, } from './skills/index.js';
+export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, } from './skills/index.js';
 // =============================================================================
 // Contextual Actions (skill invocations with context)
 // =============================================================================

package/dist/platform/sqlite/document-repository.js

@@ -118,6 +118,7 @@ export class SQLiteDocumentRepository {
             plan: 0,
             'app-model': 0,
             'research-model': 0,
+            'business-model': 0,
         };
         for (const row of results) {
             counts[row.doc_type] = row.count;

package/dist/platform/tools/document-tools.js

@@ -16,6 +16,7 @@ const DOC_TYPE_ENUM = [
     'plan',
     'app-model',
     'research-model',
+    'business-model',
 ];
 // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export function createDocumentTools(config) {

package/dist/platform/types.d.ts

@@ -19,7 +19,7 @@ export type WorkItemType = 'feature' | 'bug' | 'tech-debt' | 'chore';
 export type WorkItemStatus = 'backlog' | 'in_progress' | 'completed' | 'skipped';
 export type WorkItemPriority = 'critical' | 'high' | 'medium' | 'low';
 export type GuidedStep = 'plan' | 'implement' | 'test' | 'commit' | 'review';
-export type DocumentType = 'prd' | 'architecture' | 'design' | 'notes' | 'plan' | 'app-model' | 'research-model';
+export type DocumentType = 'prd' | 'architecture' | 'design' | 'notes' | 'plan' | 'app-model' | 'research-model' | 'business-model';
 export type PlanStatus = 'draft' | 'approved' | 'in_progress' | 'completed' | 'abandoned';
 export interface Project {
     id: number;

package/dist/project-types/action-meta.js

@@ -54,6 +54,10 @@ export const ACTION_META_REGISTRY = {
         icon: 'ShieldCheck',
         description: 'Review the paper',
     },
+    // ── Business Plan project actions ──────────────────────────────────────────
+    'business-vision': { id: 'business-vision', label: 'Vision', icon: 'Target', description: 'Define your business' },
+    'market-analysis': { id: 'market-analysis', label: 'Market', icon: 'TrendingUp', description: 'Analyze the market' },
+    'competitor-analysis': { id: 'competitor-analysis', label: 'Competitors', icon: 'Swords', description: 'Map competition' },
     // ── Work item actions ────────────────────────────────────────────────────
     build: {
         id: 'build',

package/dist/project-types/configs.js

@@ -340,19 +340,19 @@ export const businessPlanConfig = {
         { role: 'writer', label: 'Writer', description: 'Clear, persuasive business writing' },
     ],
     documentTemplates: [
+        { type: 'business-model', label: 'Business Model', description: 'Structured business model (identity, market, competitors, financials)' },
         { type: 'executive-summary', label: 'Executive Summary', description: 'Business overview' },
         {
             type: 'market-analysis',
             label: 'Market Analysis',
             description: 'Market size, trends, competition',
         },
-        { type: 'business-model', label: 'Business Model', description: 'Revenue, costs, operations' },
         { type: 'financial-model', label: 'Financial Model', description: 'Projections and forecasts' },
         { type: 'pitch', label: 'Pitch Narrative', description: 'Investor pitch content' },
         { type: 'session-notes', label: 'Session Notes', description: 'Summary of work done' },
     ],
-    projectActions: ['session-notes'],
-    workItemActions: ['explain'],
+    projectActions: ['business-vision', 'market-analysis', 'competitor-analysis', 'session-notes'],
+    workItemActions: ['refine-item', 'explain'],
     workItemLabels: {
         feature: { short: 'ML', full: 'Milestone' },
         bug: { short: 'IS', full: 'Issue' },

package/dist/project-types/skill-meta.js

@@ -106,6 +106,10 @@ export const SKILL_META_REGISTRY = {
         icon: 'Layers',
         category: 'research',
     },
+    // ── Business Plan Skills ──────────────────────────────────────────────────
+    'business-vision': { id: 'business-vision', label: 'Business Vision', description: 'Define business identity and value proposition', icon: 'Target', category: 'planning' },
+    'market-analysis': { id: 'market-analysis', label: 'Market Analysis', description: 'Analyze market size, trends, and segments', icon: 'TrendingUp', category: 'analysis' },
+    'competitor-analysis': { id: 'competitor-analysis', label: 'Competitor Analysis', description: 'Map competitive landscape', icon: 'Swords', category: 'analysis' },
     // ── Builtin Skills (agents library) ──────────────────────────────────────
     'code-review': {
         id: 'code-review',

package/dist/skills/index.d.ts

@@ -1,4 +1,4 @@
 /**
  * Platform Skills — barrel export
  */
-export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, } from './platform-skills.js';
+export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, } from './platform-skills.js';

package/dist/skills/index.js

@@ -1,4 +1,4 @@
 /**
  * Platform Skills — barrel export
  */
-export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, } from './platform-skills.js';
+export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, } from './platform-skills.js';

package/dist/skills/platform-skills.d.ts

@@ -22,8 +22,11 @@ export declare const literatureReviewSkill: Skill;
 export declare const draftSectionSkill: Skill;
 export declare const peerReviewSkill: Skill;
 export declare const researchScaffoldSkill: Skill;
+export declare const businessVisionSkill: Skill;
+export declare const marketAnalysisSkill: Skill;
+export declare const competitorAnalysisSkill: Skill;
 /**
- * All platform-specific skills (14 total).
+ * All platform-specific skills (17 total).
  * These skills reference platform tools (backlog, workitems, documents, projects)
  * and belong in the SDK rather than in generic agent/coding libraries.
  */

package/dist/skills/platform-skills.js

@@ -1410,10 +1410,151 @@ After scaffolding, tell the user:
     tags: ['research', 'scaffold', 'setup'],
 });
 // =============================================================================
+// Business Plan Skills
+// =============================================================================
+export const businessVisionSkill = defineSkill({
+    name: 'business-vision',
+    description: 'Define the business identity, problem, solution, and value proposition',
+    prompt: `You are in BUSINESS VISION MODE. Help the user define and articulate their business idea.
+
+## Step 1: Assess Current State
+1. Use \`business_model_get\` with scope: "identity" to check if a model exists
+2. Report what's already defined
+
+## Step 2: Gather Core Information
+Ask in batches (only what's not already defined):
+- **Business name** and tagline
+- **Problem**: What specific pain point do your target customers experience?
+- **Solution**: How does your product/service solve this?
+- **Unique value**: Why you instead of alternatives? What's the unfair advantage?
+- **Target customer**: Who specifically are you building for?
+- **Stage**: idea, pre-seed, seed, series-a, growth, or established?
+- **Industry/sector**
+
+## Step 3: Craft the Value Proposition
+Help refine the problem-solution-uniqueValue into a compelling narrative:
+- Problem should be specific and relatable
+- Solution should directly address the problem
+- Unique value should differentiate from ALL alternatives (including doing nothing)
+
+## Step 4: Save to Model
+- \`business_model_update\` with op: "set_identity" for name, tagline, mission, stage, industry, sector
+- \`business_model_update\` with op: "set_value_proposition" for problem, solution, uniqueValue, targetCustomer
+
+## Step 5: Suggest Next Steps
+After saving, suggest:
+- "Run /market-analysis to size your market and define customer segments"
+- "Run /competitor-analysis to map the competitive landscape"
+
+## Rules
+- Interactive — ask questions, don't assume
+- Push back on vague answers ("everyone" is not a target customer)
+- A good value proposition is specific, measurable, and defensible`,
+    tags: ['business', 'planning', 'vision'],
+});
+export const marketAnalysisSkill = defineSkill({
+    name: 'market-analysis',
+    description: 'Analyze market size, trends, and customer segments',
+    prompt: `You are in MARKET ANALYSIS MODE. Help the user understand their market.
+
+## Step 1: Assess Current State
+1. Use \`business_model_get\` with scope: "overview" for context
+2. Use \`business_model_get\` with scope: "market" for existing market data
+3. Check Knowledge Base for market research sources
+
+## Step 2: Define Customer Segments
+For each segment:
+- Name and description
+- Estimated size (number of potential customers or revenue opportunity)
+- Key pain points (what problems they face)
+- Willingness to pay
+
+Save each: \`business_model_update\` with op: "segment_add", segment: { name, description, size, painPoints, willingness }
+
+## Step 3: Market Sizing
+Guide through TAM/SAM/SOM:
+- **TAM** (Total Addressable Market): If everyone who could use your product did, how big is the market?
+- **SAM** (Serviceable Addressable Market): Realistically, which portion can you reach?
+- **SOM** (Serviceable Obtainable Market): In the first 1-3 years, what share can you capture?
+
+Each should have a value (e.g., "$4.2B"), description, and source.
+Save: \`business_model_update\` with op: "set_market_size", market_size: { tam: {...}, sam: {...}, som: {...} }
+
+## Step 4: Trends and Growth
+- Identify 3-5 market trends relevant to the business
+- Estimate market growth rate
+Save: \`business_model_update\` with op: "set_market_size", market_size: { trends: [...], growthRate: "..." }
+
+## Step 5: Generate Work Items
+Create Milestone work items for:
+- "Validate segment: [name]" for each segment (priority: high)
+- "Source market data" if TAM/SAM/SOM need better sources (priority: medium)
+
+## Rules
+- Always ask for sources — investors will ask "where did you get that number?"
+- Challenge unrealistic sizing (a $100B TAM for a niche SaaS is suspicious)
+- Bottom-up sizing is more credible than top-down
+- Distinguish between potential customers and paying customers`,
+    tags: ['business', 'analysis', 'market'],
+});
+export const competitorAnalysisSkill = defineSkill({
+    name: 'competitor-analysis',
+    description: 'Map the competitive landscape — identify competitors, strengths, weaknesses, positioning',
+    prompt: `You are in COMPETITOR ANALYSIS MODE. Help the user understand their competition.
+
+## Step 1: Assess Current State
+1. Use \`business_model_get\` with scope: "competitors" for existing data
+2. Read Knowledge Base for competitor research, reports, articles
+3. Use \`business_model_get\` with scope: "identity" for context on the business
+
+## Step 2: Identify Competitors
+For each competitor (guide user to list 3-8):
+- Direct competitors (same product, same market)
+- Indirect competitors (different product, same problem)
+- Potential competitors (could enter the market)
+
+## Step 3: Analyze Each Competitor
+For each, gather:
+- **Name** and brief description
+- **Strengths** (2-4): what they do well
+- **Weaknesses** (2-4): where they fall short
+- **Market position**: leader, challenger, niche, or emerging
+- **Pricing** model/range
+- **URL** (if applicable)
+
+Save each: \`business_model_update\` with op: "competitor_add", competitor: { name, description, strengths, weaknesses, marketPosition, pricing, url }
+
+## Step 4: Define Competitive Advantages
+Based on the competitor analysis, what are YOUR advantages?
+- What do you do that no competitor does?
+- Where are the gaps in the market?
+- What would be hard for competitors to replicate?
+
+Save: \`business_model_update\` with op: "set_competitive_advantages", advantages: [...]
+
+## Step 5: Positioning
+Help the user think about positioning:
+- On what axes do competitors differentiate? (price vs. features, simplicity vs. power, etc.)
+- Where does your business sit on those axes?
+- Is there an unoccupied position?
+
+## Step 6: Generate Work Items
+Create work items for:
+- "Deep-dive: [competitor name]" for competitors needing more research (type: Research)
+- "Validate advantage: [advantage]" for unproven competitive claims (type: Research)
+
+## Rules
+- "We have no competitors" is always wrong — there's always an alternative (even doing nothing)
+- Be honest about competitor strengths — investors will know
+- Focus on defensible advantages, not features that can be copied
+- Include both current competitors and potential future entrants`,
+    tags: ['business', 'analysis', 'competition'],
+});
+// =============================================================================
 // Aggregate export
 // =============================================================================
 /**
- * All platform-specific skills (14 total).
+ * All platform-specific skills (17 total).
  * These skills reference platform tools (backlog, workitems, documents, projects)
  * and belong in the SDK rather than in generic agent/coding libraries.
  */
@@ -1432,4 +1573,7 @@ export const platformSkills = [
     draftSectionSkill,
     peerReviewSkill,
     researchScaffoldSkill,
+    businessVisionSkill,
+    marketAnalysisSkill,
+    competitorAnalysisSkill,
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",