startup-builder 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -1,122 +1,448 @@
-import * as landing_page from 'landing-page';
-export { landing } from 'landing-page';
-import * as startup_names from 'startup-names';
-export { startup as names } from 'startup-names';
-import * as storybrand from 'storybrand';
-export { story } from 'storybrand';
-import * as jobs_to_be_done from 'jobs-to-be-done';
-export { jtbd } from 'jobs-to-be-done';
-import * as ideal_customer_profile from 'ideal-customer-profile';
-export { icp } from 'ideal-customer-profile';
-import * as lean_canvas from 'lean-canvas';
-export { canvas } from 'lean-canvas';
-import * as foundation_sprint from 'foundation-sprint';
-export { sprint } from 'foundation-sprint';
+import * as xstate from 'xstate';
+import { AnyActorRef } from 'xstate';
 
-/**
- * Complete startup package returned by builder.create()
- */
-interface StartupPackage {
-    foundation: any;
-    canvas: any;
-    icp: any;
-    jtbd: any;
-    story: any;
-    name: any;
-    landing: any;
+interface StartupBuilderContext {
+    startupId: string;
+    ideaId: string;
+    sprintId: string;
+    icpCount: number;
+    competitorCount: number;
+    leanCanvasCount: number;
+    hypothesisCount: number;
+    positioningSet: boolean;
+    differentiatorCount: number;
+    storyBrandCount: number;
+    serviceCount: number;
+    agentCount: number;
+    domainCount: number;
+    pageCount: number;
+    servicesBuilderRef?: AnyActorRef;
+    siteBuilderRef?: AnyActorRef;
+    salesBuilderRef?: AnyActorRef;
+    result?: 'validated' | 'invalidated' | 'inconclusive';
+    skipReason?: string;
 }
-/**
- * Founder information used to personalize the startup
- */
-interface FounderInfo {
-    capabilities?: string[];
-    insight?: string;
-    motivation?: string;
-    founderNames?: string[];
+type StartupBuilderEvent = {
+    type: 'ARTIFACT_CREATED';
+    collection: string;
+    count: number;
+} | {
+    type: 'ADVANCE';
+} | {
+    type: 'SKIP';
+    reason: string;
+} | {
+    type: 'SERVICES_COMPLETE';
+} | {
+    type: 'SITE_COMPLETE';
+} | {
+    type: 'SALES_COMPLETE';
+    result: 'validated' | 'invalidated' | 'inconclusive';
+} | {
+    type: 'PIVOT';
+    reason: string;
+} | {
+    type: 'ARCHIVE';
+    reason: string;
+};
+declare const startupBuilderMachine: xstate.StateMachine<StartupBuilderContext, {
+    type: "ARTIFACT_CREATED";
+    collection: string;
+    count: number;
+} | {
+    type: "ADVANCE";
+} | {
+    type: "SKIP";
+    reason: string;
+} | {
+    type: "SERVICES_COMPLETE";
+} | {
+    type: "SITE_COMPLETE";
+} | {
+    type: "SALES_COMPLETE";
+    result: "validated" | "invalidated" | "inconclusive";
+} | {
+    type: "PIVOT";
+    reason: string;
+} | {
+    type: "ARCHIVE";
+    reason: string;
+}, {}, never, {
+    type: "recordSkip";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "updateArtifactCount";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "setPositioning";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "setResult";
+    params: xstate.NonReducibleUnknown;
+}, {
+    type: "hasResearchArtifacts";
+    params: unknown;
+} | {
+    type: "hasCanvasArtifacts";
+    params: unknown;
+} | {
+    type: "hasPositioningArtifacts";
+    params: unknown;
+} | {
+    type: "hasMessagingArtifacts";
+    params: unknown;
+} | {
+    type: "hasServicesComplete";
+    params: unknown;
+} | {
+    type: "hasTeamArtifacts";
+    params: unknown;
+} | {
+    type: "hasSiteComplete";
+    params: unknown;
+} | {
+    type: "isSkipping";
+    params: unknown;
+}, never, "complete" | "research" | "canvas" | "positioning" | "messaging" | "services" | "team" | "site" | "sales", string, {
+    startupId: string;
+    ideaId: string;
+    sprintId: string;
+}, xstate.NonReducibleUnknown, xstate.EventObject, xstate.MetaObject, {
+    id: "startup-builder";
+    states: {
+        readonly research: {};
+        readonly canvas: {};
+        readonly positioning: {};
+        readonly messaging: {};
+        readonly services: {};
+        readonly team: {};
+        readonly site: {};
+        readonly sales: {};
+        readonly complete: {};
+    };
+}>;
+
+interface ServicesBuilderContext {
+    startupId: string;
+    hasStoryBrand: boolean;
+    deliveryModel?: 'saas' | 'iaas' | 'paas' | 'services-as-software';
+    serviceCount: number;
+    pricingSet: boolean;
+    productCount: number;
+    activationComplete: boolean;
 }
-/**
- * Options for creating a startup
- */
-interface CreateOptions {
-    idea: string;
-    founder?: FounderInfo;
-    industry?: string;
-    tone?: 'professional' | 'playful' | 'modern' | 'traditional';
+type ServicesBuilderEvent = {
+    type: 'ARTIFACT_CREATED';
+    collection: string;
+    count: number;
+} | {
+    type: 'MODEL_SELECTED';
+    model: ServicesBuilderContext['deliveryModel'];
+} | {
+    type: 'PRICING_SET';
+} | {
+    type: 'ACTIVATION_COMPLETE';
+} | {
+    type: 'ADVANCE';
+} | {
+    type: 'SKIP';
+    reason: string;
+};
+declare const servicesBuilderMachine: xstate.StateMachine<ServicesBuilderContext, {
+    type: "ARTIFACT_CREATED";
+    collection: string;
+    count: number;
+} | {
+    type: "MODEL_SELECTED";
+    model: ServicesBuilderContext["deliveryModel"];
+} | {
+    type: "PRICING_SET";
+} | {
+    type: "ACTIVATION_COMPLETE";
+} | {
+    type: "ADVANCE";
+} | {
+    type: "SKIP";
+    reason: string;
+}, {}, never, {
+    type: "updateArtifactCount";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "setModel";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "setPricing";
+    params: xstate.NonReducibleUnknown;
+}, {
+    type: "needsMessaging";
+    params: unknown;
+} | {
+    type: "hasMessaging";
+    params: unknown;
+} | {
+    type: "hasModel";
+    params: unknown;
+} | {
+    type: "hasServices";
+    params: unknown;
+} | {
+    type: "hasPricing";
+    params: unknown;
+} | {
+    type: "hasProducts";
+    params: unknown;
+}, never, "complete" | "messaging" | "model" | "checkPrerequisites" | "definition" | "pricing" | "packaging" | "activation", string, {
+    startupId: string;
+    hasStoryBrand: boolean;
+}, xstate.NonReducibleUnknown, xstate.EventObject, xstate.MetaObject, {
+    id: "services-builder";
+    states: {
+        readonly checkPrerequisites: {};
+        readonly messaging: {};
+        readonly model: {};
+        readonly definition: {};
+        readonly pricing: {};
+        readonly packaging: {};
+        readonly activation: {};
+        readonly complete: {};
+    };
+}>;
+
+interface SiteBuilderContext {
+    startupId: string;
+    hasStoryBrand: boolean;
+    hasServices: boolean;
+    pageCount: number;
+    pagesWithContent: number;
+    domainCount: number;
+    designApproved: boolean;
+    published: boolean;
+}
+type SiteBuilderEvent = {
+    type: 'ARTIFACT_CREATED';
+    collection: string;
+    count: number;
+} | {
+    type: 'CONTENT_COMPLETE';
+    pagesWithContent: number;
+} | {
+    type: 'DESIGN_APPROVED';
+} | {
+    type: 'PUBLISHED';
+} | {
+    type: 'ADVANCE';
+} | {
+    type: 'SKIP';
+    reason: string;
+};
+declare const siteBuilderMachine: xstate.StateMachine<SiteBuilderContext, {
+    type: "ARTIFACT_CREATED";
+    collection: string;
+    count: number;
+} | {
+    type: "CONTENT_COMPLETE";
+    pagesWithContent: number;
+} | {
+    type: "DESIGN_APPROVED";
+} | {
+    type: "PUBLISHED";
+} | {
+    type: "ADVANCE";
+} | {
+    type: "SKIP";
+    reason: string;
+}, {}, never, {
+    type: "updateArtifactCount";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "setContentComplete";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "setDesignApproved";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "setPublished";
+    params: xstate.NonReducibleUnknown;
+}, {
+    type: "needsMessaging";
+    params: unknown;
+} | {
+    type: "needsServices";
+    params: unknown;
+} | {
+    type: "hasPrerequisites";
+    params: unknown;
+} | {
+    type: "hasPages";
+    params: unknown;
+} | {
+    type: "hasContent";
+    params: unknown;
+} | {
+    type: "hasDesign";
+    params: unknown;
+} | {
+    type: "hasDomain";
+    params: unknown;
+}, never, "complete" | "messaging" | "checkPrerequisites" | "servicesPrereq" | "structure" | "content" | "design" | "publish", string, {
+    startupId: string;
+    hasStoryBrand: boolean;
+    hasServices: boolean;
+}, xstate.NonReducibleUnknown, xstate.EventObject, xstate.MetaObject, {
+    id: "site-builder";
+    states: {
+        readonly checkPrerequisites: {};
+        readonly messaging: {};
+        readonly servicesPrereq: {};
+        readonly structure: {};
+        readonly content: {};
+        readonly design: {};
+        readonly publish: {};
+        readonly complete: {};
+    };
+}>;
+
+interface SalesBuilderContext {
+    startupId: string;
+    experimentId?: string;
+    hasSite: boolean;
+    hasDomain: boolean;
+    channels: {
+        paidAds: {
+            ready: boolean;
+            reason?: string;
+        };
+        coldOutbound: {
+            ready: boolean;
+            reason?: string;
+        };
+        contentSocial: {
+            ready: boolean;
+            reason?: string;
+        };
+        blog: {
+            ready: boolean;
+        };
+    };
+    campaignCount: number;
+    sequenceCount: number;
+    postCount: number;
+    hasExperiment: boolean;
+    hasMetrics: boolean;
+}
+type SalesBuilderEvent = {
+    type: 'ARTIFACT_CREATED';
+    collection: string;
+    count: number;
+} | {
+    type: 'EXPERIMENT_CREATED';
+    experimentId: string;
+} | {
+    type: 'METRICS_COLLECTED';
+} | {
+    type: 'ADVANCE';
+} | {
+    type: 'SKIP';
+    reason: string;
+};
+declare const salesBuilderMachine: xstate.StateMachine<SalesBuilderContext, {
+    type: "ARTIFACT_CREATED";
+    collection: string;
+    count: number;
+} | {
+    type: "EXPERIMENT_CREATED";
+    experimentId: string;
+} | {
+    type: "METRICS_COLLECTED";
+} | {
+    type: "ADVANCE";
+} | {
+    type: "SKIP";
+    reason: string;
+}, {}, never, {
+    type: "updateArtifactCount";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "setExperiment";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "setMetrics";
+    params: xstate.NonReducibleUnknown;
+}, {
+    type: "needsSite";
+    params: unknown;
+} | {
+    type: "hasSite";
+    params: unknown;
+} | {
+    type: "hasActiveChannel";
+    params: unknown;
+} | {
+    type: "hasMetrics";
+    params: unknown;
+}, never, "complete" | "checkPrerequisites" | "sitePrereq" | "launch" | "measure", string, {
+    startupId: string;
+    hasSite: boolean;
+    hasDomain: boolean;
+}, xstate.NonReducibleUnknown, xstate.EventObject, xstate.MetaObject, {
+    id: "sales-builder";
+    states: {
+        readonly checkPrerequisites: {};
+        readonly sitePrereq: {};
+        readonly launch: {};
+        readonly measure: {};
+        readonly complete: {};
+    };
+}>;
+
+interface ArtifactCounts {
+    icpCount: number;
+    competitorCount: number;
+    leanCanvasCount: number;
+    hypothesisCount: number;
+    positioningSet: boolean;
+    differentiatorCount: number;
+    storyBrandCount: number;
+    serviceCount: number;
+    agentCount: number;
+    domainCount: number;
+    pageCount: number;
 }
 /**
- * Options for deploying a startup
+ * Fetch artifact counts for a given startup from the API.
+ * Uses `limit=0` to get only `totalDocs` without transferring documents.
  */
-interface DeployOptions {
-    domain?: string;
+declare function fetchArtifactCounts(startupId: string, apiBaseUrl: string, apiKey?: string): Promise<ArtifactCounts>;
+
+interface ProgressEntry {
+    state: string;
+    label: string;
+    status: 'complete' | 'current' | 'pending';
+}
+interface NextCommand {
+    name: string;
+    collection: string;
+    operation: string;
+    command: string;
+    schema: Record<string, unknown>;
+    description: string;
 }
 /**
- * Deploy result
+ * Query the API for artifact counts, determine current state,
+ * and return the reconciled state name plus the artifact counts.
  */
-interface DeployResult {
-    landing: string;
-    dashboard?: string;
-}
+declare function reconcileState(startupId: string, apiBaseUrl: string, apiKey?: string): Promise<{
+    currentState: string;
+    counts: ArtifactCounts;
+}>;
 /**
- * Main builder API
+ * Return progress entries for every state in the machine.
  */
-declare const builder: {
-    /**
-     * Create complete startup foundation from idea
-     *
-     * @example
-     * ```typescript
-     * const startup = await builder.create({
-     *   idea: 'AI code review for engineering teams',
-     *   founder: {
-     *     capabilities: ['ML expertise', 'DevTools experience'],
-     *     insight: 'Code review is the biggest bottleneck',
-     *     motivation: 'Hated waiting for reviews'
-     *   }
-     * })
-     * ```
-     */
-    create(options: CreateOptions): Promise<StartupPackage>;
-    /**
-     * Run foundation sprint
-     */
-    foundation(idea: string, founder?: FounderInfo): Promise<foundation_sprint.Foundation>;
-    /**
-     * Generate lean canvas
-     */
-    canvas(input: string | any): Promise<lean_canvas.LeanCanvas>;
-    /**
-     * Generate ideal customer profile
-     */
-    icp(input: string | any): Promise<ideal_customer_profile.GenerateResult>;
-    /**
-     * Generate jobs to be done
-     */
-    jtbd(input: string | any): Promise<jobs_to_be_done.DiscoverResult>;
-    /**
-     * Generate story brand messaging
-     */
-    story(input: string | any, customerProfile?: any): Promise<storybrand.StoryBrandScript>;
-    /**
-     * Generate startup name
-     */
-    name(input: string | any, options?: any): Promise<startup_names.GenerateResult>;
-    /**
-     * Generate landing page
-     */
-    landing(name: any, brandStory?: any): Promise<landing_page.LandingPageOutput>;
-    /**
-     * Deploy startup to web
-     */
-    deploy(startup: StartupPackage, options?: DeployOptions): Promise<DeployResult>;
-};
+declare function getProgress(currentState: string): ProgressEntry[];
 /**
- * Build complete startup from idea (convenience function)
- *
- * @example
- * ```typescript
- * const startup = await buildStartup('AI code review for teams')
- * ```
+ * Extract the `meta.commands` from the machine definition for the given state
+ * and fill in the startup ID to produce ready-to-run CLI commands.
  */
-declare function buildStartup(idea: string, founder?: FounderInfo): Promise<StartupPackage>;
+declare function getNextCommands(currentState: string, startupId: string): NextCommand[];
 
-export { type CreateOptions, type DeployOptions, type DeployResult, type FounderInfo, type StartupPackage, buildStartup, builder };
+export { type ArtifactCounts, type SalesBuilderContext, type SalesBuilderEvent, type ServicesBuilderContext, type ServicesBuilderEvent, type SiteBuilderContext, type SiteBuilderEvent, type StartupBuilderContext, type StartupBuilderEvent, fetchArtifactCounts, getNextCommands, getProgress, reconcileState, salesBuilderMachine, servicesBuilderMachine, siteBuilderMachine, startupBuilderMachine };

package/dist/index.js

@@ -1,22 +1,20 @@
 import {
-  buildStartup,
-  builder,
-  canvas,
-  icp,
-  jtbd,
-  landing,
-  sprint,
-  startup,
-  story
-} from "./chunk-DTWFVPYU.js";
+  fetchArtifactCounts,
+  getNextCommands,
+  getProgress,
+  reconcileState,
+  salesBuilderMachine,
+  servicesBuilderMachine,
+  siteBuilderMachine,
+  startupBuilderMachine
+} from "./chunk-NWM7TYW6.js";
 export {
-  buildStartup,
-  builder,
-  canvas,
-  icp,
-  jtbd,
-  landing,
-  startup as names,
-  sprint,
-  story
+  fetchArtifactCounts,
+  getNextCommands,
+  getProgress,
+  reconcileState,
+  salesBuilderMachine,
+  servicesBuilderMachine,
+  siteBuilderMachine,
+  startupBuilderMachine
 };

package/package.json

@@ -1,55 +1,43 @@
 {
   "name": "startup-builder",
-  "version": "0.1.0",
-  "description": "Business-as-Code. Define your startup in minutes.",
+  "version": "0.2.0",
+  "description": "State-machine-driven startup builder — orchestrates the full Foundation Sprint sequence",
+  "license": "MIT",
   "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "bin": {
-    "startup-builder": "./dist/cli.js"
-  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "exports": {
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
     }
   },
+  "bin": {
+    "startup-builder": "dist/cli.js"
+  },
   "files": [
     "dist"
   ],
   "scripts": {
-    "build": "tsup src/index.ts src/cli.ts --format esm --dts --clean",
-    "dev": "tsup src/index.ts src/cli.ts --format esm --dts --watch",
-    "typecheck": "tsc --noEmit"
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist .turbo"
   },
-  "keywords": [
-    "startup",
-    "builder",
-    "business",
-    "lean-canvas",
-    "mvp"
-  ],
-  "author": "Startups.Studio",
-  "license": "MIT",
   "dependencies": {
-    "api.sb": "workspace:*",
-    "db.sb": "workspace:*",
-    "foundation-sprint": "workspace:*",
-    "lean-canvas": "workspace:*",
-    "ideal-customer-profile": "workspace:*",
-    "jobs-to-be-done": "workspace:*",
-    "storybrand": "workspace:*",
-    "startup-names": "workspace:*",
-    "landing-page": "workspace:*",
-    "commander": "^12.0.0",
-    "picocolors": "^1.1.0",
-    "prompts": "^2.4.2"
+    "xstate": "^5",
+    "startups.studio": "0.6.0",
+    "commander": "^12.1.0",
+    "picocolors": "^1.1.0"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
-    "@types/prompts": "^2.4.9",
-    "tsup": "^8.0.0",
-    "typescript": "^5.5.0"
+    "@startups-studio/typescript-config": "0.0.0",
+    "tsup": "^8",
+    "typescript": "^5",
+    "@types/node": "^22"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }