business-as-code 2.0.2 → 2.1.3

package/dist/canvas/value.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Value Propositions
+ *
+ * Functions for creating and working with value propositions.
+ */
+import type { ValueProposition, ValueType } from './types.js';
+export interface CreateValuePropositionInput {
+    name: string;
+    description?: string;
+    valueType?: ValueType;
+    benefits?: string[];
+    targetSegments?: string[];
+    quantifiedValue?: string;
+    segmentFit?: Record<string, number>;
+}
+/**
+ * Create a value proposition
+ */
+export declare function createValueProposition(input: CreateValuePropositionInput): ValueProposition;
+//# sourceMappingURL=value.d.ts.map

package/dist/canvas/value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value.d.ts","sourceRoot":"","sources":["../../src/canvas/value.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE7D,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACpC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,2BAA2B,GAAG,gBAAgB,CAY3F"}

package/dist/canvas/value.js

@@ -0,0 +1,21 @@
+/**
+ * Value Propositions
+ *
+ * Functions for creating and working with value propositions.
+ */
+/**
+ * Create a value proposition
+ */
+export function createValueProposition(input) {
+    const { name, description, valueType, benefits = [], targetSegments, quantifiedValue, segmentFit } = input;
+    return {
+        name,
+        description,
+        valueType,
+        benefits,
+        targetSegments,
+        quantifiedValue,
+        segmentFit,
+    };
+}
+//# sourceMappingURL=value.js.map

package/dist/canvas/value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value.js","sourceRoot":"","sources":["../../src/canvas/value.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAkC;IACvE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,GAAG,EAAE,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,KAAK,CAAA;IAE1G,OAAO;QACL,IAAI;QACJ,WAAW;QACX,SAAS;QACT,QAAQ;QACR,cAAc;QACd,eAAe;QACf,UAAU;KACX,CAAA;AACH,CAAC"}

package/dist/entities/planning.d.ts

@@ -1,87 +0,0 @@
-import type { Noun } from 'ai-database';
-/**
- * Planning Entities
- * Issue, Plan - Planning-focused abstractions for tracking work
- *
- * These complement the execution-focused Task in digital-tasks
- * and the project management entities in projects.ts
- *
- * Key distinction:
- * - Task (digital-tasks): Function execution with workers, queues, runtime
- * - Task (projects.ts): Project management work item
- * - Issue (planning.ts): Planning-focused with design, acceptance criteria, notes
- */
-/**
- * WorkItem - A planning-focused work item (ticket/issue)
- *
- * Models the full lifecycle of work from ideation through completion:
- * - What: title, description
- * - Why: context, business value
- * - How: design (implementation approach)
- * - Done: acceptance criteria
- * - Context: notes (session handoff, progress tracking)
- *
- * This abstraction is backend-agnostic and can be implemented by:
- * - beads (SQLite) - maps to beads Issue
- * - Linear - maps to Linear Issue
- * - GitHub Issues
- * - Jira - maps to Jira Issue/Ticket
- * - etc.
- *
- * Note: Distinct from entities/risk.ts Issue which represents
- * operational/business issues (problems requiring resolution).
- * WorkItem represents planned development work.
- */
-export declare const WorkItem: Noun;
-/**
- * Comment - A comment on an issue
- */
-export declare const Comment: Noun;
-/**
- * Event - An audit trail event on an issue
- */
-export declare const Event: Noun;
-/**
- * WorkItemComment - Alias for Comment (for clarity)
- */
-export declare const WorkItemComment: Noun;
-/**
- * WorkItemEvent - Alias for Event (for clarity)
- */
-export declare const WorkItemEvent: Noun;
-/**
- * Plan - A high-level planning document that generates issues
- *
- * Bridges Strategy → Plan → Issues → Tasks
- *
- * A Plan captures:
- * - Goals and objectives
- * - Constraints and assumptions
- * - Design decisions
- * - Issue breakdown
- */
-export declare const Plan: Noun;
-/**
- * Dependency types for issue relationships
- */
-export declare const DependencyTypes: {
-    /** Hard blocker - issue A blocks issue B from starting */
-    readonly blocks: "blocks";
-    /** Soft link - issues are related but not blocking */
-    readonly related: "related";
-    /** Hierarchical - epic/subtask relationship */
-    readonly parentChild: "parent-child";
-    /** Provenance - issue B discovered while working on A */
-    readonly discoveredFrom: "discovered-from";
-};
-export type DependencyType = (typeof DependencyTypes)[keyof typeof DependencyTypes];
-export declare const PlanningEntities: {
-    WorkItem: Noun;
-    WorkItemComment: Noun;
-    WorkItemEvent: Noun;
-    Comment: Noun;
-    Event: Noun;
-    Plan: Noun;
-};
-export default PlanningEntities;
-//# sourceMappingURL=planning.d.ts.map

package/examples/basic-usage.js

@@ -0,0 +1,282 @@
+/**
+ * Basic usage example for business-as-code
+ *
+ * This example demonstrates how to define business entities, goals, products,
+ * KPIs, OKRs, and calculate financial metrics.
+ */
+import { Business, Vision, Goals, Product, Service, Process, Workflow, kpis, okrs, financials, $, } from '../src/index.js';
+// Define your business
+const company = Business({
+    name: 'Acme Corp',
+    description: 'Building the future of widgets',
+    industry: 'Technology',
+    mission: 'To make widgets accessible to everyone',
+    values: ['Innovation', 'Customer Focus', 'Integrity'],
+    targetMarket: 'SMB and Enterprise',
+    foundedAt: new Date('2020-01-01'),
+    teamSize: 50,
+    structure: {
+        departments: [
+            {
+                name: 'Engineering',
+                head: 'Jane Smith',
+                members: ['Alice', 'Bob', 'Charlie'],
+                budget: 2000000,
+            },
+            {
+                name: 'Sales',
+                head: 'John Doe',
+                members: ['David', 'Eve'],
+                budget: 1000000,
+            },
+        ],
+    },
+});
+// Define vision
+const vision = Vision({
+    statement: 'To become the world\'s most trusted widget platform',
+    timeframe: '5 years',
+    successIndicators: [
+        '10M+ active users',
+        'Present in 50+ countries',
+        'Industry-leading NPS score',
+        '$1B+ annual revenue',
+    ],
+});
+// Define goals
+const goals = Goals([
+    {
+        name: 'Launch MVP',
+        description: 'Ship minimum viable product to early customers',
+        category: 'strategic',
+        targetDate: new Date('2024-06-30'),
+        owner: 'Product Team',
+        metrics: ['User signups', 'Feature completion rate'],
+        status: 'in-progress',
+        progress: 65,
+    },
+    {
+        name: 'Achieve Product-Market Fit',
+        description: 'Validate product value with target customers',
+        category: 'strategic',
+        targetDate: new Date('2024-12-31'),
+        owner: 'CEO',
+        metrics: ['NPS > 50', 'Churn < 5%', '100+ paying customers'],
+        status: 'in-progress',
+        progress: 30,
+        dependencies: ['Launch MVP'],
+    },
+]);
+// Define products
+const product = Product({
+    name: 'Widget Pro',
+    description: 'Enterprise-grade widget management platform',
+    category: 'SaaS',
+    targetSegment: 'Enterprise',
+    valueProposition: 'Reduce widget management costs by 50%',
+    pricingModel: 'subscription',
+    price: 99,
+    currency: 'USD',
+    cogs: 20,
+    features: [
+        'Unlimited widgets',
+        'Advanced analytics',
+        'API access',
+        '24/7 support',
+    ],
+    roadmap: [
+        {
+            name: 'Mobile app',
+            description: 'Native iOS and Android apps',
+            targetDate: new Date('2024-09-01'),
+            priority: 'high',
+            status: 'in-progress',
+        },
+    ],
+});
+// Define services
+const service = Service({
+    name: 'Widget Consulting',
+    description: 'Expert widget implementation and optimization',
+    category: 'Consulting',
+    targetSegment: 'Enterprise',
+    valueProposition: 'Get expert help implementing widgets in 2 weeks',
+    pricingModel: 'fixed',
+    price: 5000,
+    currency: 'USD',
+    deliveryTime: '2 weeks',
+    sla: {
+        uptime: 99.9,
+        responseTime: '< 24 hours',
+        supportHours: 'Business hours (9-5 EST)',
+        penalties: '10% refund per day of delay',
+    },
+});
+// Define a business process
+const process = Process({
+    name: 'Customer Onboarding',
+    description: 'Process for onboarding new customers',
+    category: 'core',
+    owner: 'Customer Success Team',
+    steps: [
+        {
+            order: 1,
+            name: 'Welcome Email',
+            description: 'Send personalized welcome email',
+            responsible: 'CS Manager',
+            duration: '5 minutes',
+            automationLevel: 'automated',
+        },
+        {
+            order: 2,
+            name: 'Initial Setup Call',
+            description: 'Schedule and conduct setup call',
+            responsible: 'CS Rep',
+            duration: '30 minutes',
+            automationLevel: 'manual',
+        },
+    ],
+    inputs: ['Customer Information', 'Subscription Plan'],
+    outputs: ['Configured Account', 'Training Materials'],
+});
+// Define a workflow
+const workflow = Workflow({
+    name: 'New Customer Welcome',
+    description: 'Automated welcome sequence for new customers',
+    trigger: {
+        type: 'event',
+        event: 'Customer.created',
+    },
+    actions: [
+        {
+            order: 1,
+            type: 'send',
+            description: 'Send welcome email',
+            params: {
+                template: 'welcome_email',
+                to: '{{customer.email}}',
+            },
+        },
+        {
+            order: 2,
+            type: 'create',
+            description: 'Create onboarding task',
+            params: {
+                type: 'Task',
+                title: 'Onboard {{customer.name}}',
+                assignee: 'customer_success_team',
+            },
+        },
+    ],
+});
+// Track KPIs
+const kpiList = kpis([
+    {
+        name: 'Monthly Recurring Revenue',
+        description: 'Total predictable revenue per month',
+        category: 'financial',
+        unit: 'USD',
+        target: 100000,
+        current: 85000,
+        frequency: 'monthly',
+        dataSource: 'Billing System',
+        formula: 'SUM(active_subscriptions.price)',
+    },
+    {
+        name: 'Customer Churn Rate',
+        description: 'Percentage of customers lost per month',
+        category: 'customer',
+        unit: 'percent',
+        target: 5,
+        current: 3.2,
+        frequency: 'monthly',
+        dataSource: 'CRM',
+        formula: '(churned_customers / total_customers) * 100',
+    },
+    {
+        name: 'Net Promoter Score',
+        description: 'Customer satisfaction and loyalty metric',
+        category: 'customer',
+        unit: 'score',
+        target: 50,
+        current: 48,
+        frequency: 'quarterly',
+        dataSource: 'Survey Platform',
+    },
+]);
+// Define OKRs
+const okrList = okrs([
+    {
+        objective: 'Achieve Product-Market Fit',
+        description: 'Validate that our product solves a real problem for customers',
+        period: 'Q2 2024',
+        owner: 'CEO',
+        keyResults: [
+            {
+                description: 'Increase Net Promoter Score',
+                metric: 'NPS',
+                startValue: 40,
+                targetValue: 60,
+                currentValue: 52,
+                unit: 'score',
+            },
+            {
+                description: 'Reduce monthly churn rate',
+                metric: 'Churn Rate',
+                startValue: 8,
+                targetValue: 4,
+                currentValue: 5.5,
+                unit: 'percent',
+            },
+            {
+                description: 'Achieve customer retention',
+                metric: 'Customers with 3+ months',
+                startValue: 50,
+                targetValue: 200,
+                currentValue: 125,
+                unit: 'customers',
+            },
+        ],
+        status: 'on-track',
+        confidence: 75,
+    },
+]);
+// Calculate financials
+const metrics = financials({
+    revenue: 1000000,
+    cogs: 300000,
+    operatingExpenses: 500000,
+    currency: 'USD',
+    period: 'monthly',
+});
+// Use $ helper for calculations
+console.log('\n=== Business Operations with $ ===');
+console.log('Format currency:', $.format(1234.56));
+console.log('Calculate percentage:', $.percent(25, 100));
+console.log('Calculate growth:', $.growth(120, 100));
+console.log('Calculate margin:', $.margin(100, 60));
+console.log('Calculate ROI:', $.roi(150, 100));
+console.log('Calculate LTV:', $.ltv(100, 12, 24));
+console.log('Calculate CAC:', $.cac(10000, 100));
+console.log('Calculate burn rate:', $.burnRate(100000, 70000, 3));
+console.log('Calculate runway:', $.runway(100000, 10000));
+// Display results
+console.log('\n=== Business Summary ===');
+console.log(`Company: ${company.name}`);
+console.log(`Mission: ${company.mission}`);
+console.log(`Team Size: ${company.teamSize}`);
+console.log(`\nVision: ${vision.statement}`);
+console.log(`Timeframe: ${vision.timeframe}`);
+console.log(`\nGoals: ${goals.length}`);
+console.log(`Products: ${product.name} - ${$.format(product.price)} ${product.pricingModel}`);
+console.log(`Services: ${service.name} - ${$.format(service.price)} ${service.pricingModel}`);
+console.log(`\nKPIs: ${kpiList.length}`);
+console.log(`OKRs: ${okrList.length}`);
+console.log(`\n=== Financial Metrics ===`);
+console.log(`Revenue: ${$.format(metrics.revenue)}`);
+console.log(`Gross Profit: ${$.format(metrics.grossProfit)}`);
+console.log(`Gross Margin: ${metrics.grossMargin.toFixed(1)}%`);
+console.log(`Operating Income: ${$.format(metrics.operatingIncome)}`);
+console.log(`Operating Margin: ${metrics.operatingMargin.toFixed(1)}%`);
+console.log(`Net Income: ${$.format(metrics.netIncome)}`);
+console.log(`Net Margin: ${metrics.netMargin.toFixed(1)}%`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "business-as-code",
-  "version": "2.0.2",
+  "version": "2.1.3",
   "description": "Primitives for expressing business logic and processes as code",
   "type": "module",
   "main": "dist/index.js",
@@ -11,18 +11,9 @@
       "types": "./dist/index.d.ts"
     }
   },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "vitest",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint .",
-    "clean": "rm -rf dist"
-  },
   "dependencies": {
-    "ai-database": "2.0.2",
-    "ai-functions": "2.0.2",
-    "rpc.do": "^0.1.0"
+    "ai-database": "2.1.3",
+    "ai-functions": "2.1.3"
   },
   "keywords": [
     "business",
@@ -30,5 +21,13 @@
     "code",
     "primitives"
   ],
-  "license": "MIT"
-}
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "clean": "rm -rf dist"
+  }
+}

package/src/business.js

@@ -0,0 +1,108 @@
+/**
+ * Business entity definition
+ */
+/**
+ * Define a business entity with organizational structure, mission, and values
+ *
+ * @example
+ * ```ts
+ * const acme = Business({
+ *   name: 'Acme Corp',
+ *   description: 'Building the future of widgets',
+ *   industry: 'Technology',
+ *   mission: 'To make widgets accessible to everyone',
+ *   values: ['Innovation', 'Customer Focus', 'Integrity'],
+ *   targetMarket: 'SMB and Enterprise',
+ *   foundedAt: new Date('2020-01-01'),
+ *   teamSize: 50,
+ *   structure: {
+ *     departments: [
+ *       {
+ *         name: 'Engineering',
+ *         head: 'Jane Smith',
+ *         members: ['Alice', 'Bob', 'Charlie'],
+ *         budget: 2000000,
+ *       },
+ *       {
+ *         name: 'Sales',
+ *         head: 'John Doe',
+ *         members: ['David', 'Eve'],
+ *         budget: 1000000,
+ *       },
+ *     ],
+ *   },
+ * })
+ * ```
+ */
+export function Business(definition) {
+    // Validate required fields
+    if (!definition.name) {
+        throw new Error('Business name is required');
+    }
+    // Return validated business definition
+    return {
+        ...definition,
+        foundedAt: definition.foundedAt || new Date(),
+        teamSize: definition.teamSize || 0,
+        values: definition.values || [],
+        metadata: definition.metadata || {},
+    };
+}
+/**
+ * Get total budget across all departments
+ */
+export function getTotalBudget(business) {
+    if (!business.structure?.departments)
+        return 0;
+    return business.structure.departments.reduce((total, dept) => {
+        return total + (dept.budget || 0);
+    }, 0);
+}
+/**
+ * Get total team size across all departments
+ */
+export function getTotalTeamSize(business) {
+    if (!business.structure?.departments)
+        return business.teamSize || 0;
+    return business.structure.departments.reduce((total, dept) => {
+        return total + (dept.members?.length || 0);
+    }, 0);
+}
+/**
+ * Get department by name
+ */
+export function getDepartment(business, name) {
+    return business.structure?.departments?.find(d => d.name === name);
+}
+/**
+ * Get team by name
+ */
+export function getTeam(business, name) {
+    return business.structure?.teams?.find(t => t.name === name);
+}
+/**
+ * Validate business definition
+ */
+export function validateBusiness(business) {
+    const errors = [];
+    if (!business.name) {
+        errors.push('Business name is required');
+    }
+    if (business.teamSize && business.teamSize < 0) {
+        errors.push('Team size cannot be negative');
+    }
+    if (business.structure?.departments) {
+        for (const dept of business.structure.departments) {
+            if (!dept.name) {
+                errors.push('Department name is required');
+            }
+            if (dept.budget && dept.budget < 0) {
+                errors.push(`Department ${dept.name} budget cannot be negative`);
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}

package/src/canvas/activities.ts

@@ -0,0 +1,32 @@
+/**
+ * Key Activities
+ *
+ * Functions for creating and working with key activities.
+ */
+
+import type { KeyActivity, ActivityCategory } from './types.js'
+
+export interface CreateKeyActivityInput {
+  name: string
+  category: ActivityCategory
+  description?: string
+  resources?: string[]
+  metrics?: string[]
+  uptime?: number
+}
+
+/**
+ * Create a key activity
+ */
+export function createKeyActivity(input: CreateKeyActivityInput): KeyActivity {
+  const { name, category, description, resources, metrics, uptime } = input
+
+  return {
+    name,
+    category,
+    description,
+    resources,
+    metrics,
+    uptime,
+  }
+}