@girardmedia/bootspring 2.5.1 → 2.5.3

package/dist/cli/index.js

@@ -3378,7 +3378,7 @@ var init_release = __esm({
   "../../packages/shared/src/release.ts"() {
     "use strict";
     init_cjs_shims();
-    BOOTSPRING_VERSION = "2.5.0";
+    BOOTSPRING_VERSION = "2.5.3";
     BOOTSPRING_PACKAGE_NAME = "@girardmedia/bootspring";
   }
 });
@@ -5195,8 +5195,12 @@ var init_setup_commands = __esm({
 var tier_enforcement_exports = {};
 __export(tier_enforcement_exports, {
   AGENT_TIERS: () => AGENT_TIERS,
+  CUSTOM_PROMPTS_TIERS: () => CUSTOM_PROMPTS_TIERS,
   DEFAULT_LIMITS: () => DEFAULT_LIMITS,
+  DUAL_LLM_TIERS: () => DUAL_LLM_TIERS,
   FEATURE_GATES: () => FEATURE_GATES,
+  FREE_AGENTS: () => FREE_AGENTS,
+  GENERATION_LIMITS: () => GENERATION_LIMITS,
   PREMIUM_SKILL_CATEGORIES: () => PREMIUM_SKILL_CATEGORIES,
   PREMIUM_SKILL_PATTERNS: () => PREMIUM_SKILL_PATTERNS,
   PRESEED_PAID_COMMANDS: () => PRESEED_PAID_COMMANDS,
@@ -5204,6 +5208,9 @@ __export(tier_enforcement_exports, {
   TIER_HIERARCHY: () => TIER_HIERARCHY,
   cacheEntitlements: () => cacheEntitlements,
   checkAgentAccess: () => checkAgentAccess,
+  checkCustomPromptsAccess: () => checkCustomPromptsAccess,
+  checkDualLlmAccess: () => checkDualLlmAccess,
+  checkGenerationAccess: () => checkGenerationAccess,
   checkLimit: () => checkLimit,
   checkPreseedAccess: () => checkPreseedAccess,
   checkSeedAccess: () => checkSeedAccess,
@@ -5323,8 +5330,14 @@ function meetsTierRequirement(requiredTier, userTier = null) {
   return getTierLevel(user) >= getTierLevel(requiredTier);
 }
 function checkAgentAccess(agentId) {
-  const requiredTier = AGENT_TIERS[agentId];
   const userTier = getTier2();
+  if (getTierLevel(userTier) === 0) {
+    if (!FREE_AGENTS.has(agentId)) {
+      return { allowed: false, requiredTier: "pro", userTier };
+    }
+    return { allowed: true, userTier };
+  }
+  const requiredTier = AGENT_TIERS[agentId];
   if (!requiredTier) {
     return { allowed: true, userTier };
   }
@@ -5595,7 +5608,18 @@ function requireSeedAccess(command) {
     throw error50;
   }
 }
-var fs8, os5, path8, BOOTSPRING_DIR2, ENTITLEMENTS_CACHE_FILE, CACHE_TTL_MS, TIER_HIERARCHY, DEFAULT_LIMITS, FEATURE_GATES, PRESEED_PAID_COMMANDS, SEED_PAID_COMMANDS, AGENT_TIERS, PREMIUM_SKILL_CATEGORIES, PREMIUM_SKILL_PATTERNS, FREE_SKILL_OVERRIDES, UPGRADE_URL, FEATURE_COPY;
+function checkGenerationAccess() {
+  const tier = getTier2();
+  const limit = GENERATION_LIMITS[tier] ?? 0;
+  return { allowed: limit > 0, limit, tier };
+}
+function checkCustomPromptsAccess() {
+  return CUSTOM_PROMPTS_TIERS.has(getTier2());
+}
+function checkDualLlmAccess() {
+  return DUAL_LLM_TIERS.has(getTier2());
+}
+var fs8, os5, path8, BOOTSPRING_DIR2, ENTITLEMENTS_CACHE_FILE, CACHE_TTL_MS, TIER_HIERARCHY, DEFAULT_LIMITS, FEATURE_GATES, PRESEED_PAID_COMMANDS, SEED_PAID_COMMANDS, AGENT_TIERS, FREE_AGENTS, PREMIUM_SKILL_CATEGORIES, PREMIUM_SKILL_PATTERNS, GENERATION_LIMITS, CUSTOM_PROMPTS_TIERS, DUAL_LLM_TIERS, FREE_SKILL_OVERRIDES, UPGRADE_URL, FEATURE_COPY;
 var init_tier_enforcement = __esm({
   "../../packages/core/src/tier-enforcement.ts"() {
     "use strict";
@@ -5617,11 +5641,12 @@ var init_tier_enforcement = __esm({
       custom: 3
     };
     DEFAULT_LIMITS = {
-      free: { projects: 1, apiCallsPerMonth: 500, devices: 1, teamSeats: 1, storage: "100MB" },
-      founder: { projects: 5, apiCallsPerMonth: 1e4, devices: 3, teamSeats: 1, storage: "5GB" },
-      pro: { projects: 5, apiCallsPerMonth: 1e4, devices: 3, teamSeats: 1, storage: "5GB" },
-      team: { projects: 20, apiCallsPerMonth: 5e4, devices: 10, teamSeats: 5, storage: "50GB" },
-      enterprise: { projects: 100, apiCallsPerMonth: 5e5, devices: 50, teamSeats: 20, storage: "500GB" },
+      free: { projects: 1, apiCallsPerMonth: 100, devices: 1, teamSeats: 1, storage: "50MB" },
+      // one-time trial credits, not recurring
+      founder: { projects: 5, apiCallsPerMonth: 5e3, devices: 1, teamSeats: 1, storage: "2GB" },
+      pro: { projects: 5, apiCallsPerMonth: 5e3, devices: 1, teamSeats: 1, storage: "2GB" },
+      team: { projects: 15, apiCallsPerMonth: 25e3, devices: 2, teamSeats: 3, storage: "25GB" },
+      enterprise: { projects: 50, apiCallsPerMonth: 1e5, devices: 5, teamSeats: 10, storage: "250GB" },
       custom: { projects: 999, apiCallsPerMonth: 999999, devices: 999, teamSeats: 999, storage: "1TB" }
     };
     FEATURE_GATES = {
@@ -5680,6 +5705,7 @@ var init_tier_enforcement = __esm({
         "priority_support",
         "team_features",
         "presence",
+        "custom_policies",
         "preseed.*",
         "seed.*"
       ],
@@ -5715,18 +5741,28 @@ var init_tier_enforcement = __esm({
     PRESEED_PAID_COMMANDS = ["pull", "push", "workflow", "merge", "start"];
     SEED_PAID_COMMANDS = ["scaffold", "synthesize", "generate"];
     AGENT_TIERS = {
+      // Business agents — Pro tier
       "business-strategy-expert": "pro",
       "competitive-analysis-expert": "pro",
       "financial-expert": "pro",
+      "fundraising-expert": "pro",
       "growth-expert": "pro",
+      "investor-relations-expert": "pro",
       "legal-expert": "pro",
       "operations-expert": "pro",
+      "partnerships-expert": "pro",
+      "private-equity-expert": "pro",
       "sales-expert": "pro",
-      "fundraising-expert": "team",
-      "investor-relations-expert": "team",
-      "partnerships-expert": "team",
-      "private-equity-expert": "team"
-    };
+      // Design agent — Pro tier
+      "ui-ux-expert": "pro",
+      "content-expert": "pro",
+      "marketing-expert": "pro",
+      "product-expert": "pro"
+    };
+    FREE_AGENTS = /* @__PURE__ */ new Set([
+      "database-expert",
+      "frontend-expert"
+    ]);
     PREMIUM_SKILL_CATEGORIES = [
       "ai",
       "payments",
@@ -5752,6 +5788,16 @@ var init_tier_enforcement = __esm({
       "ui/command-palette",
       "ui/data-tables"
     ];
+    GENERATION_LIMITS = {
+      free: 0,
+      founder: 25,
+      pro: 25,
+      team: 100,
+      enterprise: 500,
+      custom: 999999
+    };
+    CUSTOM_PROMPTS_TIERS = /* @__PURE__ */ new Set(["enterprise", "custom"]);
+    DUAL_LLM_TIERS = /* @__PURE__ */ new Set(["enterprise", "custom"]);
     FREE_SKILL_OVERRIDES = ["security/validation", "deployment/docker"];
     UPGRADE_URL = "https://bootspring.com/pricing";
     FEATURE_COPY = {
@@ -48405,22 +48451,97 @@ init_cjs_shims();
 var fs25 = __toESM(require("fs"));
 var path27 = __toESM(require("path"));
 init_src();
+var DOCUMENT_TYPES = {
+  vision: {
+    name: "VISION.md",
+    title: "Vision Document",
+    description: "Problem statement, solution overview, and core values",
+    priority: 1,
+    required: true
+  },
+  audience: {
+    name: "AUDIENCE.md",
+    title: "Target Audience",
+    description: "Target audience, personas, and ideal customer profile",
+    priority: 2,
+    required: true
+  },
+  market: {
+    name: "MARKET.md",
+    title: "Market Analysis",
+    description: "TAM/SAM/SOM analysis and market opportunity",
+    priority: 3,
+    required: false
+  },
+  competitors: {
+    name: "COMPETITORS.md",
+    title: "Competitive Analysis",
+    description: "Competitive landscape, positioning, and differentiation",
+    priority: 4,
+    required: false
+  },
+  "business-model": {
+    name: "BUSINESS_MODEL.md",
+    title: "Business Model",
+    description: "Value proposition, revenue model, and pricing strategy",
+    priority: 5,
+    required: true
+  },
+  prd: {
+    name: "PRD.md",
+    title: "Product Requirements",
+    description: "Product vision, user stories, and MVP scope",
+    priority: 6,
+    required: true
+  },
+  "technical-spec": {
+    name: "TECHNICAL_SPEC.md",
+    title: "Technical Specification",
+    description: "Architecture, tech stack, and data model",
+    priority: 7,
+    required: false
+  },
+  roadmap: {
+    name: "ROADMAP.md",
+    title: "Product Roadmap",
+    description: "Phased development plan and milestones",
+    priority: 8,
+    required: false
+  }
+};
 var PRESETS = {
-  startup: ["vision", "market", "competitors", "personas", "roadmap"],
-  enterprise: ["vision", "market", "competitors", "personas", "roadmap", "compliance", "security"],
-  minimal: ["vision", "roadmap"],
-  full: ["vision", "market", "competitors", "personas", "roadmap", "compliance", "security", "architecture"]
+  essential: ["vision", "audience", "business-model", "prd"],
+  startup: ["vision", "audience", "market", "competitors", "business-model", "prd", "roadmap"],
+  full: Object.keys(DOCUMENT_TYPES),
+  technical: ["vision", "prd", "technical-spec", "roadmap"],
+  investor: ["vision", "audience", "market", "competitors", "business-model", "roadmap"]
 };
+var CONTEXT_FOLDERS = {
+  drop: { name: "drop", description: "Drop anything here - AI will sort it out", isUniversal: true },
+  ideas: { name: "ideas", description: "Rough ideas, brainstorms, notes" },
+  research: { name: "research", description: "Market research, industry reports" },
+  vision: { name: "vision", description: "Vision statements, problem/solution notes", mapsTo: "vision" },
+  audience: { name: "audience", description: "User interviews, surveys, personas", mapsTo: "audience" },
+  market: { name: "market", description: "Market size, TAM/SAM/SOM analysis, trends", mapsTo: "market" },
+  competitors: { name: "competitors", description: "Competitor analysis, screenshots, comparisons", mapsTo: "competitors" },
+  business: { name: "business", description: "Business model ideas, pricing notes, revenue", mapsTo: "business-model" },
+  prd: { name: "prd", description: "Product requirements, user stories, features", mapsTo: "prd" },
+  technical: { name: "technical", description: "Technical requirements, architecture notes", mapsTo: "technical-spec" },
+  roadmap: { name: "roadmap", description: "Timeline notes, milestones, phasing plans", mapsTo: "roadmap" }
+};
+var DEFAULT_OUTPUT_DIR = ".bootspring/preseed";
+var CONTEXT_INPUT_DIR = ".bootspring/preseed/context";
+var CONFIG_FILE2 = "PRESEED_CONFIG.json";
 function ensurePreseedDir() {
-  const dir = path27.join(process.cwd(), ".bootspring", "preseed");
+  const dir = path27.join(process.cwd(), DEFAULT_OUTPUT_DIR);
   if (!fs25.existsSync(dir)) {
     fs25.mkdirSync(dir, { recursive: true });
   }
   return dir;
 }
 function getPreseedStatus() {
-  const dir = path27.join(process.cwd(), ".bootspring", "preseed");
-  const configFile = path27.join(process.cwd(), ".bootspring", "preseed-config.json");
+  const dir = path27.join(process.cwd(), DEFAULT_OUTPUT_DIR);
+  const configFile = path27.join(dir, CONFIG_FILE2);
   const hasConfig = fs25.existsSync(configFile);
   if (!fs25.existsSync(dir)) {
     return { generated: [], total: 0, hasConfig };
@@ -48428,130 +48549,832 @@ function getPreseedStatus() {
   const files = fs25.readdirSync(dir).filter((f) => f.endsWith(".md"));
   return { generated: files, total: files.length, hasConfig };
 }
+function generateContextReadme() {
+  return `# Preseed Context Documents
+
+## Complete Workflow (10 Steps)
+
+### Quick Start (one command does it all)
+\`\`\`bash
+bootspring preseed go
+\`\`\`
+This runs the full workflow automatically: setup \u2192 detect codebase \u2192 generate docs \u2192 show status.
+
+### Step-by-Step (advanced / granular control)
+
+| Step | Command | What It Does |
+|------|---------|--------------|
+| 1 | \`bootspring preseed start\` | Detect your environment and see recommended next steps |
+| 2 | \`bootspring preseed init\` | Create folder structure + empty PRESEED_CONFIG.json |
+| 3 | *(optional)* Drop files in \`context/\` subfolders | Add pitch decks, notes, research \u2014 AI uses them to enrich docs |
+| 4 | \`bootspring preseed from-codebase\` | Auto-detect tech stack from package.json and generate config |
+| 5 | \`bootspring preseed generate\` | Generate all preseed markdown documents from config |
+| 6 | Edit the generated \`.md\` files in \`.bootspring/preseed/\` | Fill in your vision, audience, market, etc. |
+| 7 | \`bootspring preseed status\` | Check which documents exist and their completeness |
+| 8 | \`bootspring preseed merge\` | Combine all docs into a single SEED.md |
+| 9 | \`bootspring preseed workflow start\` | Begin document review/approval workflow |
+| 10 | \`bootspring build start\` | Transition from preseed into the build phase |
+
+### For New Projects (no existing code)
+\`\`\`bash
+bootspring preseed init              # Step 2: Create folder structure
+# Drop any notes/research into .bootspring/preseed/context/drop/
+bootspring preseed generate          # Step 5: Generate document templates
+# Edit the generated .md files with your project details
+bootspring preseed merge             # Step 8: Create unified SEED.md
+bootspring build start               # Step 10: Begin building
+\`\`\`
+
+### For Existing Codebases
+\`\`\`bash
+bootspring preseed go                # Does steps 2-5 automatically
+# Edit the generated .md files to refine
+bootspring preseed merge             # Step 8: Create unified SEED.md
+bootspring build start               # Step 10: Begin building
+\`\`\`
+
+---
+
+## Context Folder Reference
+
+**Don't know where to put something?** Just drop it in the \`drop/\` folder.
+AI will analyze your files and extract relevant information for each preseed document.
+
+### Universal
+| Folder | What to put here |
+|--------|------------------|
+| \`drop/\` | **Anything!** Pitch decks, notes, docs \u2014 AI sorts it out |
+
+### General
+| Folder | What to put here |
+|--------|------------------|
+| \`ideas/\` | Rough ideas, brainstorms, notes |
+| \`research/\` | Market research, industry reports |
+
+### Document-specific (maps 1:1 to output)
+| Folder | Output Document |
+|--------|-----------------|
+| \`vision/\` | \u2192 VISION.md |
+| \`audience/\` | \u2192 AUDIENCE.md |
+| \`market/\` | \u2192 MARKET.md |
+| \`competitors/\` | \u2192 COMPETITORS.md |
+| \`business/\` | \u2192 BUSINESS_MODEL.md |
+| \`prd/\` | \u2192 PRD.md |
+| \`technical/\` | \u2192 TECHNICAL_SPEC.md |
+| \`roadmap/\` | \u2192 ROADMAP.md |
+
+### Supported Formats
+Markdown (.md), Text (.txt), PDF (.pdf), Word (.docx), CSV (.csv), Images (.png, .jpg)
+
+## Tips
+
+- More context = better generated documents
+- Each folder maps 1:1 to an output document for easy organization
+- Even rough notes are valuable \u2014 **not sure where something goes? Use \`drop/\`!**
+- Include any competitor URLs or screenshots
+- Add user interview transcripts if available
+`;
+}
+function generateDocumentContent(docType, projectName, preset) {
+  const date7 = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const meta3 = DOCUMENT_TYPES[docType];
+  const title = meta3?.title ?? docType.charAt(0).toUpperCase() + docType.slice(1);
+  const fileName = meta3?.name ?? `${docType.toUpperCase()}.md`;
+  const templates = {
+    vision: `# ${projectName}
+
+> *Your tagline here*
+
+**Category:** SaaS
+**Generated:** ${date7}
+**Status:** Draft
+
+## The Problem
+
+*Describe the core problem your product solves. What pain points do users experience today?*
+
+### Key Challenges
+
+- *Challenge 1: Describe a specific pain point*
+- *Challenge 2: Describe another pain point*
+- *Challenge 3: Describe another pain point*
+
+### Current Solutions (and their limitations)
+
+- **Existing Solution A**: *What limitation does it have?*
+- **Existing Solution B**: *What limitation does it have?*
+
+### Why Now?
+
+*What has changed in the market, technology, or user behavior that makes this the right time?*
+
+## Our Solution
+
+*Describe your solution at a high level. What does it do and why is it better?*
+
+### Key Capabilities
+
+- **Feature 1**: *Brief description*
+- **Feature 2**: *Brief description*
+- **Feature 3**: *Brief description*
+
+### Unique Value Proposition
+
+*What makes your product uniquely better? Why would someone switch from their current solution?*
+
+---
+
+*This is a living document generated by Bootspring. Run \`bootspring preseed sync\` to update.*
+`,
+    audience: `# ${projectName} - Target Audience
+
+**Generated:** ${date7}
+**Status:** Draft
+
+## Primary Audience
+
+*Who is the main user of your product? Be specific about role, industry, and company size.*
+
+## Market Segments
+
+### Segment 1
+- **Description**: *Who are they?*
+- **Size**: *How many potential users?*
+- **Characteristics**: *What defines this segment?*
+
+### Segment 2
+- **Description**: *Who are they?*
+- **Size**: *How many potential users?*
+- **Characteristics**: *What defines this segment?*
+
+## User Personas
+
+### Persona 1
+- **Role**: *Job title / role*
+- **Demographics**: *Age, experience level, tech savviness*
+- **Goals**: *What are they trying to achieve?*
+- **Pain Points**: *What frustrates them about current solutions?*
+- **Quote**: *"A representative quote from this persona"*
+
+### Persona 2
+- **Role**: *Job title / role*
+- **Demographics**: *Age, experience level, tech savviness*
+- **Goals**: *What are they trying to achieve?*
+- **Pain Points**: *What frustrates them?*
+- **Quote**: *"A representative quote"*
+
+## Ideal Customer Profile (ICP)
+
+| Attribute | Value |
+|-----------|-------|
+| Company Size | *e.g., 10-500 employees* |
+| Industry | *e.g., Technology, SaaS* |
+| Budget | *e.g., $50-500/mo* |
+| Decision Maker | *e.g., Engineering Manager* |
+| Buying Process | *e.g., Self-serve, sales-assisted* |
+
+---
+
+*Generated by Bootspring Preseed*
+`,
+    market: `# ${projectName} - Market Analysis
+
+**Generated:** ${date7}
+**Status:** Draft
+
+## Market Size
+
+| Metric | Value | Rationale |
+|--------|-------|-----------|
+| **TAM** (Total Addressable Market) | *$X billion* | *How did you calculate this?* |
+| **SAM** (Serviceable Addressable Market) | *$X million* | *Your accessible subset* |
+| **SOM** (Serviceable Obtainable Market) | *$X million* | *Realistic 3-year target* |
+
+## Market Trends
+
+- **Trend 1**: *Description and impact on your product*
+- **Trend 2**: *Description and impact on your product*
+- **Trend 3**: *Description and impact on your product*
+
+## Growth Drivers
+
+*What factors are driving market growth? Why is demand increasing?*
+
+## Market Challenges
+
+*What headwinds exist? Regulatory, economic, or competitive pressures?*
+
+---
+
+*Generated by Bootspring Preseed*
+`,
+    competitors: `# ${projectName} - Competitive Analysis
+
+**Generated:** ${date7}
+**Status:** Draft
+
+## Direct Competitors
+
+### Competitor 1
+- **Strengths**: *What they do well*
+- **Weaknesses**: *Where they fall short*
+- **Pricing**: *Their pricing model*
+- **Why users choose them**: *Key value proposition*
+- **Limitations**: *Key limitations*
+
+### Competitor 2
+- **Strengths**: *What they do well*
+- **Weaknesses**: *Where they fall short*
+- **Pricing**: *Their pricing model*
+- **Why users choose them**: *Key value proposition*
+- **Limitations**: *Key limitations*
+
+## Indirect Competitors / Alternatives
+
+- **Alternative 1**: *How users currently solve this problem without a dedicated tool*
+- **Alternative 2**: *Another workaround users employ*
+
+## Competitive Positioning
+
+*Where does your product sit relative to competitors? What axis do you win on?*
+
+## Key Differentiators
+
+- *Differentiator 1*
+- *Differentiator 2*
+- *Differentiator 3*
+
+---
+
+*Generated by Bootspring Preseed*
+`,
+    "business-model": `# ${projectName} - Business Model
+
+**Generated:** ${date7}
+**Status:** Draft
+
+## Business Model
+
+*Describe your primary business model (subscription, freemium, usage-based, marketplace, etc.)*
+
+## Revenue Streams
+
+| Stream | Description | % of Revenue |
+|--------|-------------|-------------|
+| *Primary* | *e.g., Monthly subscription* | *80%* |
+| *Secondary* | *e.g., Professional services* | *20%* |
+
+## Pricing Strategy
+
+### Tier 1: Free
+- *Feature 1*
+- *Feature 2*
+
+### Tier 2: Pro ($X/mo)
+- *Everything in Free*
+- *Feature 3*
+- *Feature 4*
+
+### Tier 3: Enterprise (Custom)
+- *Everything in Pro*
+- *Feature 5*
+- *Feature 6*
+
+## Unit Economics
+
+| Metric | Value |
+|--------|-------|
+| **CAC** (Customer Acquisition Cost) | *$X* |
+| **LTV** (Lifetime Value) | *$X* |
+| **LTV:CAC Ratio** | *X:1* |
+| **Payback Period** | *X months* |
+| **Gross Margin** | *X%* |
+
+---
+
+*Generated by Bootspring Preseed*
+`,
+    prd: `# ${projectName} - Product Requirements Document
+
+**Generated:** ${date7}
+**Status:** Draft
+
+## Product Vision
+
+*One paragraph describing what the product will become and the impact it will have.*
+
+## MVP Features
+
+| Feature | Description | Priority |
+|---------|-------------|----------|
+| *Feature 1* | *What it does* | Must-have |
+| *Feature 2* | *What it does* | Must-have |
+| *Feature 3* | *What it does* | Should-have |
+| *Feature 4* | *What it does* | Nice-to-have |
+
+## User Stories
+
+### Core Workflows
+
+- **As a** *[user type]*, **I want to** *[action]*, **so that** *[benefit]*
+- **As a** *[user type]*, **I want to** *[action]*, **so that** *[benefit]*
+- **As a** *[user type]*, **I want to** *[action]*, **so that** *[benefit]*
+
+## Future Features (Post-MVP)
+
+- *Feature 5*
+- *Feature 6*
+- *Feature 7*
+
+## Success Metrics
+
+| Metric | Target | Timeframe |
+|--------|--------|-----------|
+| *Active Users* | *X* | *3 months* |
+| *Retention Rate* | *X%* | *Monthly* |
+| *NPS Score* | *X* | *Quarterly* |
+
+---
+
+*Generated by Bootspring Preseed*
+`,
+    "technical-spec": `# ${projectName} - Technical Specification
+
+**Generated:** ${date7}
+**Status:** Draft
+
+## Tech Stack
+
+| Component | Technology | Rationale |
+|-----------|------------|-----------|
+| Frontend | *e.g., Next.js / React* | *Why this choice?* |
+| Backend | *e.g., Node.js / Express* | *Why this choice?* |
+| Database | *e.g., PostgreSQL* | *Why this choice?* |
+| Auth | *e.g., NextAuth / Clerk* | *Why this choice?* |
+| Hosting | *e.g., Vercel / AWS* | *Why this choice?* |
+
+## Architecture
+
+*Describe the high-level architecture: monolith vs microservices, API design, data flow.*
+
+## Data Model
+
+*List the core entities and their relationships.*
+
+## Integrations
+
+| Integration | Purpose |
+|-------------|---------|
+| *e.g., Stripe* | *Payment processing* |
+| *e.g., SendGrid* | *Transactional email* |
+
+## Technical Constraints
+
+- *Constraint 1*
+- *Constraint 2*
+
+---
+
+*Generated by Bootspring Preseed*
+`,
+    roadmap: `# ${projectName} - Product Roadmap
+
+**Generated:** ${date7}
+**Status:** Draft
+
+## Timeline Overview
+
+*High-level timeline from MVP to mature product.*
+
+## Phase 1: Foundation (Weeks 1-4)
+- **Goal**: *MVP with core functionality*
+- **Deliverables**:
+  - *Deliverable 1*
+  - *Deliverable 2*
+  - *Deliverable 3*
+
+## Phase 2: Growth (Months 2-3)
+- **Goal**: *Scale user base, add key features*
+- **Deliverables**:
+  - *Deliverable 1*
+  - *Deliverable 2*
+
+## Phase 3: Scale (Months 3-6)
+- **Goal**: *Enterprise features, market expansion*
+- **Deliverables**:
+  - *Deliverable 1*
+  - *Deliverable 2*
+
+## Key Milestones
+
+| Milestone | Target Date | Status |
+|-----------|------------|--------|
+| *MVP Launch* | *TBD* | Planned |
+| *First 100 Users* | *TBD* | Planned |
+| *Revenue Target* | *TBD* | Planned |
+
+---
+
+*Generated by Bootspring Preseed*
+`
+  };
+  return templates[docType] ?? `# ${projectName} - ${title}
+
+**Generated:** ${date7}
+**Status:** Draft
+**Source:** Preseed (${preset})
+
+## Overview
+
+*Add ${title.toLowerCase()} details for ${projectName}.*
+
+---
+
+*Generated by Bootspring Preseed*
+`;
+}
 function registerPreseedCommand(program3) {
   const preseed = program3.command("preseed").description("Generate foundational documents from minimal input");
   preseed.command("start").description("Smart entry point - detects context and guides you").option("--preset <preset>", "Preset to use (startup, enterprise, minimal, full)", "startup").action(async (opts) => {
     print.header("Preseed Start");
     const cwd = process.cwd();
     const status = getPreseedStatus();
+    const hasPkg = fs25.existsSync(path27.join(cwd, "package.json"));
+    const hasGit = fs25.existsSync(path27.join(cwd, ".git"));
     if (status.total > 0) {
-      print.info(`Found ${status.total} existing preseed documents`);
-      print.info("Run `bootspring preseed generate` to regenerate");
-      print.info("Run `bootspring preseed sync` to sync with codebase changes");
-      return;
+      print.success(`Found ${status.total} existing preseed documents`);
     }
-    const preset = opts.preset;
-    const docs = PRESETS[preset] || PRESETS.startup;
-    print.info(`Preset: ${preset} (${docs.length} documents)`);
+    if (hasPkg) print.success("Detected package.json");
+    if (hasGit) print.success("Detected git repository");
+    const contextDir = path27.join(cwd, CONTEXT_INPUT_DIR);
+    let contextFileCount = 0;
+    if (fs25.existsSync(contextDir)) {
+      for (const folder of Object.values(CONTEXT_FOLDERS)) {
+        const folderPath = path27.join(contextDir, folder.name);
+        if (fs25.existsSync(folderPath)) {
+          contextFileCount += fs25.readdirSync(folderPath).filter((f) => !f.startsWith(".") && !f.startsWith("README")).length;
+        }
+      }
+      if (contextFileCount > 0) {
+        print.success(`Found ${contextFileCount} context files in drop zone`);
+      }
+    }
+    console.log("");
+    console.log(`${COLORS.bold}Complete Workflow (one command):${COLORS.reset}`);
+    console.log(`  ${COLORS.cyan}bootspring preseed go${COLORS.reset}  \u2014 runs setup \u2192 detect \u2192 generate \u2192 status`);
     console.log("");
-    console.log("This wizard will collect information about your project");
-    console.log("and generate foundational documents.\n");
-    console.log("Documents to generate:");
-    for (const doc of docs) {
-      console.log(`  - ${doc}`);
+    console.log(`${COLORS.bold}Step-by-Step Workflow (10 steps):${COLORS.reset}`);
+    console.log("");
+    console.log("  Step  Command                              What it does");
+    console.log("  \u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+    console.log("   1    bootspring preseed start              Detect environment, see this guide");
+    console.log("   2    bootspring preseed init               Create folders + PRESEED_CONFIG.json");
+    console.log("   3    (drop files in context/ subfolders)   Add pitch decks, notes, research");
+    console.log("   4    bootspring preseed from-codebase      Auto-detect tech stack from code");
+    console.log("   5    bootspring preseed generate           Generate all preseed documents");
+    console.log("   6    (edit .md files in .bootspring/preseed/)  Fill in vision, audience, etc.");
+    console.log("   7    bootspring preseed status             Check document completeness");
+    console.log("   8    bootspring preseed merge              Combine all docs into SEED.md");
+    console.log("   9    bootspring preseed workflow start     Begin review/approval workflow");
+    console.log("  10    bootspring build start                Transition to build phase");
+    console.log("");
+    if (status.total > 0) {
+      print.info("You have existing documents. Next: edit them, then run `bootspring preseed merge`");
+    } else if (hasPkg) {
+      print.info("Existing codebase detected. Run `bootspring preseed go` to do it all at once");
+    } else {
+      print.info("New project? Run `bootspring preseed go` or `bootspring preseed init` to begin");
     }
+  });
+  preseed.command("go").alias("full").description("Complete preseed workflow \u2014 setup, detect, generate, status (all in one)").option("--preset <preset>", "Preset to use (essential, startup, full, technical)", "startup").option("--force", "Overwrite existing documents").action(async (opts) => {
+    print.header("Preseed \u2014 Complete Workflow");
     console.log("");
+    const cwd = process.cwd();
+    const preseedDir = path27.join(cwd, DEFAULT_OUTPUT_DIR);
+    const contextDir = path27.join(cwd, CONTEXT_INPUT_DIR);
+    const configPath = path27.join(preseedDir, CONFIG_FILE2);
     const hasPkg = fs25.existsSync(path27.join(cwd, "package.json"));
     const hasGit = fs25.existsSync(path27.join(cwd, ".git"));
+    const hasReadme = fs25.existsSync(path27.join(cwd, "README.md"));
+    console.log(`${COLORS.bold}Step 1/5: Setup${COLORS.reset}`);
+    let createdCount = 0;
+    if (!fs25.existsSync(preseedDir)) {
+      fs25.mkdirSync(preseedDir, { recursive: true });
+      createdCount++;
+    }
+    if (!fs25.existsSync(contextDir)) {
+      fs25.mkdirSync(contextDir, { recursive: true });
+      createdCount++;
+    }
+    for (const folder of Object.values(CONTEXT_FOLDERS)) {
+      const fullPath = path27.join(contextDir, folder.name);
+      if (!fs25.existsSync(fullPath)) {
+        fs25.mkdirSync(fullPath, { recursive: true });
+        createdCount++;
+      }
+    }
+    const readmePath = path27.join(contextDir, "README.md");
+    if (!fs25.existsSync(readmePath)) {
+      fs25.writeFileSync(readmePath, generateContextReadme());
+    }
+    if (!fs25.existsSync(configPath)) {
+      const config3 = {
+        _meta: {
+          version: "1.0.0",
+          created: (/* @__PURE__ */ new Date()).toISOString(),
+          updated: (/* @__PURE__ */ new Date()).toISOString(),
+          preset: opts.preset,
+          bootspringVersion: "2.5.1",
+          source: "go"
+        },
+        identity: { name: "", tagline: "", description: "", category: "saas" },
+        problem: { statement: "", painPoints: [], currentSolutions: [], whyNow: "" },
+        solution: { overview: "", keyFeatures: [], uniqueValue: "", coreCapabilities: [] },
+        audience: { primary: "", segments: [], personas: [], icp: {} },
+        market: { tam: null, sam: null, som: null, trends: [], growth: "" },
+        competitors: { direct: [], indirect: [], positioning: "", differentiation: [] },
+        business: { model: "subscription", revenueStreams: [], pricing: {}, unitEconomics: {} },
+        product: { vision: "", mvpFeatures: [], futureFeatures: [], userStories: [] },
+        technical: { stack: {}, architecture: "", integrations: [], constraints: [] },
+        roadmap: { phases: [], milestones: [], timeline: "" },
+        _sync: { lastSync: null, codebaseHash: null, linkedFiles: [], changeLog: [] }
+      };
+      fs25.writeFileSync(configPath, JSON.stringify(config3, null, 2));
+    }
+    print.success(`  Folders created: ${createdCount} | Config: ${CONFIG_FILE2}`);
+    console.log("");
+    console.log(`${COLORS.bold}Step 2/5: Detect codebase${COLORS.reset}`);
+    let projectName = path27.basename(cwd);
     if (hasPkg) {
-      print.success("Detected package.json - will use project metadata");
+      try {
+        const pkg = JSON.parse(fs25.readFileSync(path27.join(cwd, "package.json"), "utf-8"));
+        projectName = pkg.name || projectName;
+        print.success(`  Project: ${projectName}`);
+        const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+        const detected = [];
+        if (deps["next"]) detected.push("Next.js");
+        else if (deps["react"]) detected.push("React");
+        if (deps["vue"]) detected.push("Vue");
+        if (deps["typescript"] || deps["ts-node"]) detected.push("TypeScript");
+        if (deps["prisma"] || deps["@prisma/client"]) detected.push("Prisma");
+        if (deps["tailwindcss"]) detected.push("Tailwind");
+        if (deps["express"]) detected.push("Express");
+        if (deps["stripe"]) detected.push("Stripe");
+        if (detected.length > 0) {
+          print.success(`  Stack: ${detected.join(", ")}`);
+        }
+      } catch {
+      }
+    }
+    if (hasGit) print.success("  Git repository detected");
+    if (!hasPkg && !hasGit) print.dim("  No codebase detected (new project)");
+    console.log("");
+    console.log(`${COLORS.bold}Step 3/5: Update config${COLORS.reset}`);
+    try {
+      const config3 = JSON.parse(fs25.readFileSync(configPath, "utf-8"));
+      if (!config3.identity.name) {
+        config3.identity.name = projectName;
+      }
+      config3._meta.updated = (/* @__PURE__ */ new Date()).toISOString();
+      config3._meta.preset = opts.preset;
+      fs25.writeFileSync(configPath, JSON.stringify(config3, null, 2));
+      print.success(`  Config updated: identity.name = "${projectName}"`);
+    } catch {
+      print.dim("  Config unchanged");
+    }
+    console.log("");
+    console.log(`${COLORS.bold}Step 4/5: Generate documents${COLORS.reset}`);
+    const preset = opts.preset;
+    const docs = PRESETS[preset] || PRESETS.startup;
+    let generated = 0;
+    let skipped = 0;
+    for (const docType of docs) {
+      const docMeta = DOCUMENT_TYPES[docType];
+      const fileName = docMeta?.name ?? `${docType}.md`;
+      const filePath = path27.join(preseedDir, fileName);
+      if (fs25.existsSync(filePath) && !opts.force) {
+        skipped++;
+        continue;
+      }
+      const content = generateDocumentContent(docType, projectName, preset);
+      fs25.writeFileSync(filePath, content);
+      generated++;
+    }
+    if (generated > 0) print.success(`  Generated: ${generated} document(s)`);
+    if (skipped > 0) print.dim(`  Skipped: ${skipped} (already exist, use --force to overwrite)`);
+    console.log("");
+    console.log(`${COLORS.bold}Step 5/5: Status${COLORS.reset}`);
+    const finalStatus = getPreseedStatus();
+    console.log(`  Documents: ${finalStatus.total}`);
+    for (const file2 of finalStatus.generated) {
+      console.log(`    \u2713 ${file2}`);
+    }
+    let contextCount = 0;
+    if (fs25.existsSync(contextDir)) {
+      for (const folder of Object.values(CONTEXT_FOLDERS)) {
+        const folderPath = path27.join(contextDir, folder.name);
+        if (fs25.existsSync(folderPath)) {
+          contextCount += fs25.readdirSync(folderPath).filter((f) => !f.startsWith(".") && f !== "README.md").length;
+        }
+      }
     }
-    if (hasGit) {
-      print.success("Detected git repository - will use commit history");
+    if (contextCount > 0) {
+      console.log(`  Context files: ${contextCount}`);
     }
-    print.info("Run `bootspring preseed setup` to create project structure");
-    print.info("Run `bootspring preseed generate` to generate all documents");
+    console.log("");
+    console.log(`${COLORS.bold}What's next:${COLORS.reset}`);
+    console.log(`  1. Edit the generated .md files in ${DEFAULT_OUTPUT_DIR}/`);
+    console.log("  2. Fill in your vision, audience, market details, etc.");
+    console.log("  3. Run: bootspring preseed merge     \u2192 create unified SEED.md");
+    console.log("  4. Run: bootspring build start        \u2192 transition to build phase");
+    console.log("");
+    console.log(`${COLORS.dim}Tip: Drop pitch decks, notes, or research into ${CONTEXT_INPUT_DIR}/drop/${COLORS.reset}`);
+    console.log(`${COLORS.dim}     then re-run: bootspring preseed go --force${COLORS.reset}`);
   });
   preseed.command("setup").description("Create context input folders for early docs").option("--preset <preset>", "Preset to use", "startup").action(async (opts) => {
     print.header("Preseed Setup");
     const cwd = process.cwd();
-    const dirs = [
-      ".bootspring/preseed",
-      ".bootspring/inputs/prd",
-      ".bootspring/inputs/context",
-      ".bootspring/inputs/research"
-    ];
-    for (const dir of dirs) {
-      const fullPath = path27.join(cwd, dir);
+    const contextDir = path27.join(cwd, CONTEXT_INPUT_DIR);
+    const preseedDir = path27.join(cwd, DEFAULT_OUTPUT_DIR);
+    let createdCount = 0;
+    if (!fs25.existsSync(preseedDir)) {
+      fs25.mkdirSync(preseedDir, { recursive: true });
+      print.success(`Created ${DEFAULT_OUTPUT_DIR}/`);
+      createdCount++;
+    }
+    if (!fs25.existsSync(contextDir)) {
+      fs25.mkdirSync(contextDir, { recursive: true });
+      createdCount++;
+    }
+    for (const folder of Object.values(CONTEXT_FOLDERS)) {
+      const fullPath = path27.join(contextDir, folder.name);
       if (!fs25.existsSync(fullPath)) {
         fs25.mkdirSync(fullPath, { recursive: true });
-        print.success(`Created ${dir}/`);
-      } else {
-        print.dim(`  Exists: ${dir}/`);
+        createdCount++;
       }
     }
-    const configPath = path27.join(cwd, ".bootspring", "preseed-config.json");
+    const readmePath = path27.join(contextDir, "README.md");
+    if (!fs25.existsSync(readmePath)) {
+      fs25.writeFileSync(readmePath, generateContextReadme());
+    }
+    const configPath = path27.join(preseedDir, CONFIG_FILE2);
     if (!fs25.existsSync(configPath)) {
       const config3 = {
-        preset: opts.preset,
-        project: {
+        _meta: {
+          version: "1.0.0",
+          created: (/* @__PURE__ */ new Date()).toISOString(),
+          updated: (/* @__PURE__ */ new Date()).toISOString(),
+          preset: opts.preset,
+          bootspringVersion: "2.5.1"
+        },
+        identity: {
           name: "",
           tagline: "",
           description: "",
           category: "saas"
         },
+        problem: {
+          statement: "",
+          painPoints: [],
+          currentSolutions: [],
+          whyNow: ""
+        },
+        solution: {
+          overview: "",
+          keyFeatures: [],
+          uniqueValue: "",
+          coreCapabilities: []
+        },
         audience: {
           primary: "",
-          segments: []
+          segments: [],
+          personas: [],
+          icp: {}
+        },
+        market: {
+          tam: null,
+          sam: null,
+          som: null,
+          trends: [],
+          growth: ""
+        },
+        competitors: {
+          direct: [],
+          indirect: [],
+          positioning: "",
+          differentiation: []
         },
         business: {
           model: "subscription",
-          revenueStreams: []
+          revenueStreams: [],
+          pricing: {},
+          unitEconomics: {}
+        },
+        product: {
+          vision: "",
+          mvpFeatures: [],
+          futureFeatures: [],
+          userStories: []
+        },
+        technical: {
+          stack: {},
+          architecture: "",
+          integrations: [],
+          constraints: []
+        },
+        roadmap: {
+          phases: [],
+          milestones: [],
+          timeline: ""
+        },
+        _sync: {
+          lastSync: null,
+          codebaseHash: null,
+          linkedFiles: [],
+          changeLog: []
         }
       };
       fs25.writeFileSync(configPath, JSON.stringify(config3, null, 2));
-      print.success("Created .bootspring/preseed-config.json");
+      print.success(`Created ${DEFAULT_OUTPUT_DIR}/${CONFIG_FILE2}`);
     }
     console.log("");
+    print.success(`Created ${createdCount} folders`);
+    console.log("");
+    console.log("Context folder structure:");
+    console.log(`  ${CONTEXT_INPUT_DIR}/`);
+    console.log("  \u2502");
+    console.log("  \u2502 Universal");
+    console.log("  \u251C\u2500\u2500 drop/         # Drop anything here - AI sorts it out");
+    console.log("  \u2502");
+    console.log("  \u2502 General");
+    console.log("  \u251C\u2500\u2500 ideas/        # Rough ideas, brainstorms, notes");
+    console.log("  \u251C\u2500\u2500 research/     # Market research, industry reports");
+    console.log("  \u2502");
+    console.log("  \u2502 Document-specific (maps to output)");
+    console.log("  \u251C\u2500\u2500 vision/       # \u2192 VISION.md");
+    console.log("  \u251C\u2500\u2500 audience/     # \u2192 AUDIENCE.md");
+    console.log("  \u251C\u2500\u2500 market/       # \u2192 MARKET.md");
+    console.log("  \u251C\u2500\u2500 competitors/  # \u2192 COMPETITORS.md");
+    console.log("  \u251C\u2500\u2500 business/     # \u2192 BUSINESS_MODEL.md");
+    console.log("  \u251C\u2500\u2500 prd/          # \u2192 PRD.md");
+    console.log("  \u251C\u2500\u2500 technical/    # \u2192 TECHNICAL_SPEC.md");
+    console.log("  \u2514\u2500\u2500 roadmap/      # \u2192 ROADMAP.md");
+    console.log("");
     print.info("Next steps:");
-    console.log("  1. Edit .bootspring/preseed-config.json with your project details");
-    console.log("  2. Add any reference docs to .bootspring/inputs/");
-    console.log("  3. Run `bootspring preseed generate`");
+    console.log("  1. (Optional) Drop files in context folders (e.g., vision/ for VISION.md sources)");
+    console.log("  2. Run `bootspring preseed generate` to create all documents");
+    console.log("  3. Edit the generated .md files, then run `bootspring preseed merge`");
+    console.log("");
+    console.log("  Or run `bootspring preseed go` to do it all in one command.");
   });
   preseed.command("generate").description("Generate or regenerate all preseed documents").option("--preset <preset>", "Preset to use", "startup").option("--force", "Overwrite existing documents").action(async (opts) => {
     print.header("Preseed Generate");
     const cwd = process.cwd();
     const preseedDir = ensurePreseedDir();
-    const configPath = path27.join(cwd, ".bootspring", "preseed-config.json");
+    const configPath = path27.join(preseedDir, CONFIG_FILE2);
     let config3 = {};
+    let projectName = path27.basename(cwd);
     if (fs25.existsSync(configPath)) {
       try {
         config3 = JSON.parse(fs25.readFileSync(configPath, "utf-8"));
         print.success("Loaded preseed config");
+        const identity = config3.identity;
+        if (identity?.name) {
+          projectName = identity.name;
+        }
       } catch {
-        print.warning("Could not parse preseed-config.json, using defaults");
+        print.warning("Could not parse PRESEED_CONFIG.json, using defaults");
       }
     }
-    const preset = config3.preset || opts.preset;
+    if (projectName === path27.basename(cwd)) {
+      const pkgPath = path27.join(cwd, "package.json");
+      if (fs25.existsSync(pkgPath)) {
+        try {
+          const pkg = JSON.parse(fs25.readFileSync(pkgPath, "utf-8"));
+          projectName = pkg.name || projectName;
+        } catch {
+        }
+      }
+    }
+    const meta3 = config3._meta;
+    const preset = meta3?.preset || opts.preset;
     const docs = PRESETS[preset] || PRESETS.startup;
-    const projectName = config3.project?.name || path27.basename(cwd);
-    const date7 = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
     print.info(`Generating ${docs.length} documents for preset: ${preset}`);
     console.log("");
     for (const docType of docs) {
-      const filePath = path27.join(preseedDir, `${docType}.md`);
+      const docMeta = DOCUMENT_TYPES[docType];
+      const fileName = docMeta?.name ?? `${docType}.md`;
+      const filePath = path27.join(preseedDir, fileName);
       if (fs25.existsSync(filePath) && !opts.force) {
-        print.dim(`  Skipped: ${docType}.md (exists, use --force to overwrite)`);
+        print.dim(`  Skipped: ${fileName} (exists, use --force to overwrite)`);
         continue;
       }
-      const content = `# ${projectName} - ${docType.charAt(0).toUpperCase() + docType.slice(1)}
-
-**Generated:** ${date7}
-**Status:** Draft
-**Source:** Preseed (${preset})
-
-## Overview
-
-TODO: Add ${docType} details for ${projectName}.
-
----
-*Generated by Bootspring Preseed*
-`;
+      const content = generateDocumentContent(docType, projectName, preset);
       fs25.writeFileSync(filePath, content);
-      print.success(`Generated: ${docType}.md`);
+      print.success(`Generated: ${fileName}`);
     }
     console.log("");
-    print.info("Documents generated in .bootspring/preseed/");
+    print.info(`Documents generated in ${DEFAULT_OUTPUT_DIR}/`);
     print.info("Run `bootspring preseed sync` to push to cloud");
   });
   preseed.command("sync").description("Sync preseed documents with cloud dashboard").option("--push", "Push local documents to cloud").option("--pull", "Pull documents from cloud").action(async (opts) => {
@@ -48620,6 +49443,19 @@ TODO: Add ${docType} details for ${projectName}.
     const status = getPreseedStatus();
     console.log(`  Documents: ${status.total}`);
     console.log(`  Config:    ${status.hasConfig ? "found" : "not found"}`);
+    const contextDir = path27.join(process.cwd(), CONTEXT_INPUT_DIR);
+    if (fs25.existsSync(contextDir)) {
+      let contextCount = 0;
+      for (const folder of Object.values(CONTEXT_FOLDERS)) {
+        const folderPath = path27.join(contextDir, folder.name);
+        if (fs25.existsSync(folderPath)) {
+          contextCount += fs25.readdirSync(folderPath).filter((f) => !f.startsWith(".") && f !== "README.md").length;
+        }
+      }
+      console.log(`  Context:   ${contextCount} file(s) in context folders`);
+    } else {
+      console.log("  Context:   not set up (run `bootspring preseed setup`)");
+    }
     if (status.total > 0) {
       console.log("\n  Generated files:");
       for (const file2 of status.generated) {
@@ -48658,34 +49494,23 @@ TODO: Add ${docType} details for ${projectName}.
       } catch {
       }
     }
-    const date7 = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-    const docs = ["vision", "roadmap"];
+    const docs = ["vision", "prd", "roadmap"];
     if (hasReadme) docs.push("market");
     print.info(`Generating ${docs.length} documents from codebase context`);
     for (const docType of docs) {
-      const filePath = path27.join(preseedDir, `${docType}.md`);
+      const docMeta = DOCUMENT_TYPES[docType];
+      const fileName = docMeta?.name ?? `${docType}.md`;
+      const filePath = path27.join(preseedDir, fileName);
       if (fs25.existsSync(filePath) && !opts.force) {
-        print.dim(`  Skipped: ${docType}.md (exists)`);
+        print.dim(`  Skipped: ${fileName} (exists)`);
         continue;
       }
-      const content = `# ${projectName} - ${docType.charAt(0).toUpperCase() + docType.slice(1)}
-
-**Generated:** ${date7}
-**Status:** Draft
-**Source:** from-codebase
-
-## Overview
-
-TODO: Add ${docType} details derived from ${projectName} codebase.
-
----
-*Generated by Bootspring Preseed (from-codebase)*
-`;
+      const content = generateDocumentContent(docType, projectName, "from-codebase");
       fs25.writeFileSync(filePath, content);
-      print.success(`Generated: ${docType}.md`);
+      print.success(`Generated: ${fileName}`);
     }
     console.log("");
-    print.info("Review and edit generated documents in .bootspring/preseed/");
+    print.info(`Review and edit generated documents in ${DEFAULT_OUTPUT_DIR}/`);
   });
   preseed.command("export").description("Export preseed documents as JSON").option("--format <format>", "Output format (json, yaml)", "json").action(() => {
     const status = getPreseedStatus();
@@ -48693,7 +49518,7 @@ TODO: Add ${docType} details derived from ${projectName} codebase.
       print.warning("No preseed documents to export");
       return;
     }
-    const preseedDir = path27.join(process.cwd(), ".bootspring", "preseed");
+    const preseedDir = path27.join(process.cwd(), DEFAULT_OUTPUT_DIR);
     const docs = {};
     for (const file2 of status.generated) {
       const content = fs25.readFileSync(path27.join(preseedDir, file2), "utf-8");
@@ -48701,8 +49526,8 @@ TODO: Add ${docType} details derived from ${projectName} codebase.
     }
     console.log(JSON.stringify({ preseed: docs, exportedAt: (/* @__PURE__ */ new Date()).toISOString() }, null, 2));
   });
-  preseed.command("update").description("Update preseed config values").argument("<key>", "Config key (e.g., project.name)").argument("<value>", "New value").action((key, value) => {
-    const configPath = path27.join(process.cwd(), ".bootspring", "preseed-config.json");
+  preseed.command("update").description("Update preseed config values").argument("<key>", "Config key (e.g., identity.name)").argument("<value>", "New value").action((key, value) => {
+    const configPath = path27.join(process.cwd(), DEFAULT_OUTPUT_DIR, CONFIG_FILE2);
     if (!fs25.existsSync(configPath)) {
       print.error("No preseed config found. Run `bootspring preseed setup` first.");
       return;
@@ -48716,6 +49541,7 @@ TODO: Add ${docType} details derived from ${projectName} codebase.
         obj = obj[keys[i]];
       }
       obj[keys[keys.length - 1]] = value;
+      config3._meta.updated = (/* @__PURE__ */ new Date()).toISOString();
       fs25.writeFileSync(configPath, JSON.stringify(config3, null, 2));
       print.success(`Updated ${key} = ${value}`);
     } catch {
@@ -48742,7 +49568,7 @@ TODO: Add ${docType} details derived from ${projectName} codebase.
   });
   preseed.command("merge").description("Merge preseed documents into a single SEED.md").option("--output <path>", "Output path", "SEED.md").action((opts) => {
     print.header("Preseed Merge");
-    const preseedDir = path27.join(process.cwd(), ".bootspring", "preseed");
+    const preseedDir = path27.join(process.cwd(), DEFAULT_OUTPUT_DIR);
     const status = getPreseedStatus();
     if (status.total === 0) {
       print.warning("No preseed documents to merge");
@@ -48759,10 +49585,16 @@ TODO: Add ${docType} details derived from ${projectName} codebase.
     print.success(`Merged ${status.total} documents into ${opts.output}`);
   });
   preseed.command("doc").description("View or manage a specific preseed document").argument("<name>", "Document name (e.g., vision, market, roadmap)").action((name) => {
-    const preseedDir = path27.join(process.cwd(), ".bootspring", "preseed");
-    const filePath = path27.join(preseedDir, `${name}.md`);
+    const preseedDir = path27.join(process.cwd(), DEFAULT_OUTPUT_DIR);
+    let filePath = path27.join(preseedDir, `${name}.md`);
+    if (!fs25.existsSync(filePath)) {
+      const docType = DOCUMENT_TYPES[name];
+      if (docType) {
+        filePath = path27.join(preseedDir, docType.name);
+      }
+    }
     if (!fs25.existsSync(filePath)) {
-      print.error(`Document not found: ${name}.md`);
+      print.error(`Document not found: ${name}`);
       const status = getPreseedStatus();
       if (status.total > 0) {
         print.info("Available: " + status.generated.map((f) => f.replace(".md", "")).join(", "));
@@ -50706,29 +51538,6 @@ var SEED_FOLDERS = [
   ".bootspring/config"
 ];
 var VALID_PRESETS = ["minimal", "standard", "full", "startup", "api"];
-function isExistingCodebase(projectRoot) {
-  const indicators = [
-    "package.json",
-    "Cargo.toml",
-    "go.mod",
-    "requirements.txt",
-    "pyproject.toml",
-    "Gemfile",
-    "pom.xml",
-    "build.gradle",
-    "composer.json",
-    ".git"
-  ];
-  const srcDirs = ["src", "lib", "app", "pages", "components"];
-  for (const indicator of indicators) {
-    if (fs33.existsSync(path35.join(projectRoot, indicator))) return true;
-  }
-  for (const dir of srcDirs) {
-    const dirPath = path35.join(projectRoot, dir);
-    if (fs33.existsSync(dirPath) && fs33.statSync(dirPath).isDirectory()) return true;
-  }
-  return false;
-}
 function createSeedFolders(projectRoot) {
   let dirsCreated = 0;
   for (const folder of SEED_FOLDERS) {
@@ -50823,8 +51632,16 @@ function registerSeedCommand(program3) {
       return;
     }
     print.info(`Preset: ${opts.preset}`);
-    print.info("Run the full CLI for interactive questionnaire");
-    print.dim("This monorepo command provides the seed subcommand structure");
+    console.log("");
+    print.info("To generate preseed documents and then create SEED.md, run:");
+    console.log("");
+    console.log("  bootspring preseed go          # Complete workflow (setup + detect + generate)");
+    console.log("  bootspring preseed merge       # Combine preseed docs into SEED.md");
+    console.log("");
+    print.dim("Or run each step individually:");
+    console.log("  bootspring preseed init        # Create preseed folder structure");
+    console.log("  bootspring preseed generate    # Generate preseed document templates");
+    console.log("  bootspring preseed merge       # Merge into SEED.md");
   });
   seed.command("generate").description("Ingest input files and generate documents").action(() => {
     print.header("Seed Generate");
@@ -50857,7 +51674,18 @@ function registerSeedCommand(program3) {
       console.log(`  ${cat}: ${count > 0 ? `${count} files` : "none"}`);
     }
     console.log("");
-    print.info("Process files through the full CLI for document generation");
+    const totalFiles = Object.values(counts).reduce((a, b) => a + b, 0);
+    if (totalFiles === 0) {
+      print.info("No input files found. You can:");
+      console.log("  1. Drop files into .bootspring/inputs/ subfolders");
+      console.log("  2. Or use the preseed workflow instead:");
+      console.log("");
+      console.log("     bootspring preseed go       # Complete preseed workflow");
+    } else {
+      print.success(`Found ${totalFiles} input file(s)`);
+      print.info("Next: bootspring preseed generate   # Generate preseed documents");
+      print.info("Then: bootspring seed synthesize    # Merge into SEED.md");
+    }
   });
   seed.command("scaffold").description("Generate project structure from SEED.md").option("--preset <preset>", "Use preset instead of SEED.md").option("--from-config", "Use bootspring.config.js instead of SEED.md").option("--dry-run", "Show plan without creating files").option("--yes", "Skip confirmation prompt").action((opts) => {
     print.header("Seed Scaffold");
@@ -50898,9 +51726,11 @@ function registerSeedCommand(program3) {
     } else {
       print.dim("bootspring.config.js not found");
     }
-    console.log("\nCommands:");
-    console.log("  bootspring seed init       # Create SEED.md");
-    console.log("  bootspring seed scaffold   # Generate project structure");
+    console.log("\nComplete Workflow:");
+    console.log("  bootspring preseed go         # Step 1: Generate preseed documents");
+    console.log("  (edit .md files)              # Step 2: Fill in your project details");
+    console.log("  bootspring seed synthesize    # Step 3: Merge into SEED.md");
+    console.log("  bootspring build start        # Step 4: Start building");
   });
   seed.command("export").description("Export seed config as JSON/YAML").option("--format <format>", "Output format: json, yaml", "json").option("--output <file>", "Write to file instead of stdout").action((opts) => {
     print.header("Seed Export");
@@ -50932,8 +51762,13 @@ function registerSeedCommand(program3) {
     const seedPath = path35.join(projectRoot, "SEED.md");
     if (!fs33.existsSync(preseedDir)) {
       print.error("No preseed documents found");
-      const suggestion = isExistingCodebase(projectRoot) ? "bootspring preseed codebase" : "bootspring preseed start";
-      print.info(`Run ${suggestion} first`);
+      console.log("");
+      print.info("Run the complete preseed workflow first:");
+      console.log("");
+      console.log("  bootspring preseed go          # Complete workflow (setup + detect + generate)");
+      console.log("  bootspring seed synthesize     # Then re-run this command");
+      console.log("");
+      print.dim("Or for existing codebases: bootspring preseed from-codebase");
       return;
     }
     const validDocs = [
@@ -50948,20 +51783,28 @@ function registerSeedCommand(program3) {
     ];
     const preseedFiles = fs33.readdirSync(preseedDir).filter((f) => validDocs.includes(f));
     if (preseedFiles.length === 0) {
-      print.error("No preseed documents found");
-      print.info('Run "bootspring preseed init" first');
+      print.error("No preseed documents found in .bootspring/preseed/");
+      print.info('Run "bootspring preseed go" to generate them');
       return;
     }
-    console.log(`Found ${preseedFiles.length} preseed documents:`);
-    for (const file2 of preseedFiles) {
-      print.success(file2);
-    }
     if (fs33.existsSync(seedPath) && !opts.force) {
       print.warning("SEED.md already exists");
       print.info("Use --force to overwrite");
       return;
     }
-    print.info("Synthesis runs through the full CLI for complete SEED.md generation");
+    console.log(`Found ${preseedFiles.length} preseed documents:`);
+    const sections = [];
+    for (const file2 of preseedFiles) {
+      const content = fs33.readFileSync(path35.join(preseedDir, file2), "utf-8");
+      sections.push(content);
+      print.success(`  ${file2}`);
+    }
+    const merged = sections.join("\n\n---\n\n");
+    fs33.writeFileSync(seedPath, merged);
+    console.log("");
+    print.success(`Created SEED.md (${preseedFiles.length} documents merged)`);
+    console.log("");
+    print.info("Next: bootspring build start    # Transition to build phase");
   });
   seed.command("update").description("Re-run questionnaire, update SEED.md").option("--preset <preset>", "Questionnaire preset").action((opts) => {
     print.header("Seed Update");
@@ -50974,12 +51817,38 @@ function registerSeedCommand(program3) {
     }
     print.info("Update runs through the full CLI for interactive questionnaire");
   });
-  seed.command("build").description("Build from seed docs").option("--loop", "Start continuous build loop").option("--iterations <n>", "Max iterations for loop", "50").action((opts) => {
+  seed.command("build").description("Build from seed docs").option("--loop", "Start continuous build loop").option("--iterations <n>", "Max iterations for loop", "50").action(() => {
     print.header("Seed Build");
-    if (opts.loop) {
-      print.info(`Starting build loop (max ${opts.iterations} iterations)`);
+    const projectRoot = process.cwd();
+    const seedPath = path35.join(projectRoot, "SEED.md");
+    const preseedDir = path35.join(projectRoot, ".bootspring", "preseed");
+    const hasPreseedDocs = fs33.existsSync(preseedDir) && fs33.readdirSync(preseedDir).filter((f) => f.endsWith(".md")).length > 0;
+    if (!fs33.existsSync(seedPath) && !hasPreseedDocs) {
+      print.error("No SEED.md or preseed documents found");
+      console.log("");
+      print.info("Complete workflow to get here:");
+      console.log("");
+      console.log("  Step 1: bootspring preseed go       # Generate preseed documents");
+      console.log("  Step 2: (edit the generated .md files in .bootspring/preseed/)");
+      console.log("  Step 3: bootspring seed synthesize   # Merge into SEED.md");
+      console.log("  Step 4: bootspring build start       # Start building");
+      return;
     }
-    print.info("Build runs through the build command pipeline");
+    if (hasPreseedDocs && !fs33.existsSync(seedPath)) {
+      print.info(`Found ${fs33.readdirSync(preseedDir).filter((f) => f.endsWith(".md")).length} preseed documents but no SEED.md`);
+      console.log("");
+      print.info("Next steps:");
+      console.log("  1. bootspring seed synthesize   # Merge preseed docs into SEED.md");
+      console.log("  2. bootspring build start       # Start building");
+      return;
+    }
+    print.success("SEED.md found");
+    console.log("");
+    print.info("To start building, run:");
+    console.log("");
+    console.log("  bootspring build start          # Initialize build from seed documents");
+    console.log("  bootspring build next            # Get the next task");
+    console.log("  bootspring build status          # Check progress");
   });
   seed.action(() => {
     seed.outputHelp();