popilot 0.5.0 → 0.7.0

package/bin/cli.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 import { resolve, basename } from 'node:path';
+import { readFileSync, existsSync } from 'node:fs';
 import { execSync } from 'node:child_process';
 import { copyScaffold, appendToFile, detectExisting } from '../lib/scaffold.mjs';
 import { runSetupWizard } from '../lib/setup-wizard.mjs';
@@ -15,6 +16,8 @@ const USAGE = `
     init [dir]      Scaffold + interactive setup + hydration (default)
     hydrate [dir]   Sync latest scaffold templates + re-hydrate from project.yaml
     doctor [dir]    Check installation health
+    deploy [dir]    Deploy pm-api to Cloudflare Workers (Tier 2)
+    migrate [dir]   Run SQL schema migrations on pm-api database (Tier 2)
     help            Show this help
 
   Options:
@@ -28,10 +31,12 @@ const USAGE = `
     npx popilot hydrate
     npx popilot hydrate --force
     npx popilot doctor
+    npx popilot deploy
+    npx popilot migrate
     npx popilot my-project          # same as: popilot init my-project
 `;
 
-const SUBCOMMANDS = new Set(['init', 'hydrate', 'doctor', 'help']);
+const SUBCOMMANDS = new Set(['init', 'hydrate', 'doctor', 'deploy', 'migrate', 'help']);
 
 async function main() {
   const args = process.argv.slice(2);
@@ -71,6 +76,12 @@ async function main() {
     case 'doctor':
       await cmdDoctor(targetDir, { skipSpecSite, platform });
       break;
+    case 'deploy':
+      await cmdDeploy(targetDir);
+      break;
+    case 'migrate':
+      await cmdMigrate(targetDir);
+      break;
   }
 }
 
@@ -133,7 +144,34 @@ async function cmdInit(targetDir, { skipSpecSite, force, platform }) {
     console.log(`     ${f} ✅ (domain)`);
   }
 
-  // 4. Install spec-site dependencies
+  // 4a. Install pm-api dependencies (Tier 2)
+  const pmApiDir = resolve(targetDir, 'pm-api');
+  try {
+    const { access: fsAccess } = await import('node:fs/promises');
+    await fsAccess(resolve(pmApiDir, 'package.json'));
+    console.log();
+    console.log('  📦 Installing pm-api dependencies...');
+    try {
+      execSync('npm install', { cwd: pmApiDir, stdio: 'pipe' });
+      console.log('     ✅ Done');
+    } catch {
+      console.log('     ⚠️  npm install failed. Run manually: cd pm-api && npm install');
+    }
+
+    // Also install mcp-pm
+    const mcpPmDir = resolve(targetDir, 'mcp-pm');
+    console.log('  📦 Installing mcp-pm dependencies...');
+    try {
+      execSync('npm install', { cwd: mcpPmDir, stdio: 'pipe' });
+      console.log('     ✅ Done');
+    } catch {
+      console.log('     ⚠️  npm install failed. Run manually: cd mcp-pm && npm install');
+    }
+  } catch {
+    // pm-api not present (Tier 0/1) — skip
+  }
+
+  // 4b. Install spec-site dependencies
   if (!skipSpecSite) {
     const specSiteDir = resolve(targetDir, 'spec-site');
     console.log();
@@ -171,10 +209,19 @@ async function cmdInit(targetDir, { skipSpecSite, force, platform }) {
   }
   console.log('  3. Oscar can run a deep interview to enrich your project context');
   console.log();
+  // Platform-aware file paths
+  let sysPromptName = 'CLAUDE.md';
+  let cmdDirName = '.claude/commands/';
+  try {
+    const m = await loadManifest(platform);
+    sysPromptName = m.system_prompt?.target || sysPromptName;
+    cmdDirName = m.commands?.target_dir || cmdDirName;
+  } catch {}
+
   console.log('  📁 Created:');
-  console.log('     CLAUDE.md              → System instructions (hydrated)');
+  console.log(`     ${sysPromptName.padEnd(20)} → System instructions (hydrated)`);
   console.log('     .context/project.yaml  → Project configuration');
-  console.log('     .claude/commands/      → Slash commands');
+  console.log(`     ${(cmdDirName + '/').replace(/\/\/$/, '/').padEnd(20)} → Slash commands`);
   console.log('     .context/agents/       → Agent personas (hydrated)');
   if (!skipSpecSite) {
     console.log('     spec-site/            → Interactive spec viewer (Vue3 + Vite)');
@@ -232,6 +279,170 @@ async function cmdDoctor(targetDir, { skipSpecSite, platform }) {
   process.exit(failed.length > 0 ? 1 : 0);
 }
 
+// ── deploy ───────────────────────────────────────────────
+
+async function cmdDeploy(targetDir) {
+  console.log();
+  console.log('  🚀 Popilot — Deploy pm-api');
+  console.log('  ══════════════════════════════════════');
+  console.log();
+
+  const pmApiDir = resolve(targetDir, 'pm-api');
+
+  if (!existsSync(pmApiDir)) {
+    console.log('  ❌ pm-api directory not found.');
+    console.log(`     Expected at: ${pmApiDir}`);
+    console.log('     Deploy is only available for Tier 2 (interactive spec-site with backend).');
+    console.log();
+    process.exit(1);
+  }
+
+  const wranglerToml = resolve(pmApiDir, 'wrangler.toml');
+  if (!existsSync(wranglerToml)) {
+    console.log('  ❌ wrangler.toml not found in pm-api.');
+    console.log('     Found wrangler.toml.hbs — run `popilot hydrate` first to generate wrangler.toml.');
+    console.log();
+    process.exit(1);
+  }
+
+  console.log(`  📂 Deploying from: ${pmApiDir}`);
+  console.log();
+
+  try {
+    execSync('npx wrangler deploy', { cwd: pmApiDir, stdio: 'inherit' });
+    console.log();
+    console.log('  ✅ pm-api deployed successfully.');
+    console.log();
+  } catch {
+    console.log();
+    console.log('  ❌ Deploy failed. Check the wrangler output above for details.');
+    console.log();
+    process.exit(1);
+  }
+}
+
+// ── migrate ──────────────────────────────────────────────
+
+async function cmdMigrate(targetDir) {
+  console.log();
+  console.log('  🗄️  Popilot — Run SQL Migrations');
+  console.log('  ══════════════════════════════════════');
+  console.log();
+
+  const pmApiDir = resolve(targetDir, 'pm-api');
+
+  if (!existsSync(pmApiDir)) {
+    console.log('  ❌ pm-api directory not found.');
+    console.log(`     Expected at: ${pmApiDir}`);
+    console.log('     Migrate is only available for Tier 2 (interactive spec-site with backend).');
+    console.log();
+    process.exit(1);
+  }
+
+  const sqlDir = resolve(pmApiDir, 'sql');
+  if (!existsSync(sqlDir)) {
+    console.log('  ❌ pm-api/sql/ directory not found.');
+    console.log('     No migration files available.');
+    console.log();
+    process.exit(1);
+  }
+
+  // Read D1 database name from wrangler.toml
+  const wranglerToml = resolve(pmApiDir, 'wrangler.toml');
+  if (!existsSync(wranglerToml)) {
+    console.log('  ❌ wrangler.toml not found in pm-api.');
+    console.log('     Run `popilot hydrate` first to generate wrangler.toml.');
+    console.log();
+    process.exit(1);
+  }
+
+  const wranglerContent = readFileSync(wranglerToml, 'utf-8');
+  const dbNameMatch = wranglerContent.match(/database_name\s*=\s*"([^"]+)"/);
+  const dbName = dbNameMatch ? dbNameMatch[1] : null;
+
+  if (!dbName) {
+    console.log('  ❌ Could not find D1 database_name in wrangler.toml.');
+    console.log('     Ensure [[d1_databases]] is configured with a database_name.');
+    console.log();
+    process.exit(1);
+  }
+
+  console.log(`  📂 SQL directory: ${sqlDir}`);
+  console.log(`  🗃️  D1 database:  ${dbName}`);
+  console.log();
+
+  // Read project.yaml to determine enabled features
+  const projectYaml = resolve(targetDir, '.context', 'project.yaml');
+  let features = { rewards: false, meetings: true, docs: true };
+
+  if (existsSync(projectYaml)) {
+    try {
+      const yamlContent = readFileSync(projectYaml, 'utf-8');
+      // Parse feature flags from YAML (simple regex — avoids adding a YAML dep)
+      const rewardsMatch = yamlContent.match(/features:[\s\S]*?rewards:\s*(true|false)/);
+      const meetingsMatch = yamlContent.match(/features:[\s\S]*?meetings:\s*(true|false)/);
+      const docsMatch = yamlContent.match(/features:[\s\S]*?docs:\s*(true|false)/);
+
+      if (rewardsMatch) features.rewards = rewardsMatch[1] === 'true';
+      if (meetingsMatch) features.meetings = meetingsMatch[1] === 'true';
+      if (docsMatch) features.docs = docsMatch[1] === 'true';
+    } catch {
+      console.log('  ⚠️  Could not read project.yaml — using default feature flags.');
+    }
+  }
+
+  // Build list of schemas to apply
+  const schemas = [{ file: 'schema-core.sql', label: 'core (always)' }];
+
+  if (features.rewards) {
+    schemas.push({ file: 'schema-rewards.sql', label: 'rewards' });
+  }
+  if (features.meetings) {
+    schemas.push({ file: 'schema-meetings.sql', label: 'meetings' });
+  }
+  if (features.docs) {
+    schemas.push({ file: 'schema-docs.sql', label: 'docs' });
+  }
+
+  console.log('  📋 Schemas to apply:');
+  for (const s of schemas) {
+    console.log(`     - ${s.file} (${s.label})`);
+  }
+  console.log();
+
+  // Execute each schema
+  let applied = 0;
+  let failed = 0;
+
+  for (const s of schemas) {
+    const sqlFile = resolve(sqlDir, s.file);
+    if (!existsSync(sqlFile)) {
+      console.log(`  ⚠️  ${s.file} not found — skipped`);
+      continue;
+    }
+
+    try {
+      execSync(
+        `npx wrangler d1 execute ${dbName} --file=sql/${s.file} --remote`,
+        { cwd: pmApiDir, stdio: 'pipe' }
+      );
+      console.log(`  ✅ ${s.file} applied`);
+      applied++;
+    } catch (err) {
+      console.log(`  ❌ ${s.file} failed: ${err.message}`);
+      failed++;
+    }
+  }
+
+  console.log();
+  if (failed === 0) {
+    console.log(`  ✅ Migration complete — ${applied} schema(s) applied.`);
+  } else {
+    console.log(`  ⚠️  Migration finished with errors — ${applied} applied, ${failed} failed.`);
+  }
+  console.log();
+}
+
 // ── Run ─────────────────────────────────────────────────
 
 main().catch(err => {

package/lib/doctor.mjs

@@ -97,7 +97,44 @@ export async function runDoctor(targetDir, opts = {}) {
     }, passed, failed, warnings);
   }
 
-  // 7. .gitignore entries
+  // 7. Tier 2 checks (pm-api + mcp-pm)
+  const pmApiDir = join(targetDir, 'pm-api');
+  let hasPmApi = false;
+  try { await access(pmApiDir); hasPmApi = true; } catch {}
+
+  if (hasPmApi) {
+    await check('pm-api/package.json exists', async () => {
+      await access(join(pmApiDir, 'package.json'));
+    }, passed, failed);
+
+    await check('pm-api/wrangler.toml exists (hydrated)', async () => {
+      await access(join(pmApiDir, 'wrangler.toml'));
+      try {
+        await access(join(pmApiDir, 'wrangler.toml.hbs'));
+        throw new Error('wrangler.toml.hbs still exists — hydration incomplete');
+      } catch (e) {
+        if (e.message.includes('hydration')) throw e;
+      }
+    }, passed, failed);
+
+    await check('pm-api/sql/schema-core.sql exists', async () => {
+      await access(join(pmApiDir, 'sql', 'schema-core.sql'));
+    }, passed, failed);
+
+    await check('mcp-pm/package.json exists', async () => {
+      await access(join(targetDir, 'mcp-pm', 'package.json'));
+    }, passed, failed);
+
+    await check('pm-api/node_modules exists', async () => {
+      await access(join(pmApiDir, 'node_modules'));
+    }, passed, failed, warnings);
+
+    await check('mcp-pm/node_modules exists', async () => {
+      await access(join(targetDir, 'mcp-pm', 'node_modules'));
+    }, passed, failed, warnings);
+  }
+
+  // 8. .gitignore entries
   await check('.gitignore includes user-context.yaml', async () => {
     const content = await readFile(join(targetDir, '.gitignore'), 'utf-8');
     if (!content.includes('user-context.yaml')) {

package/lib/hydrate.mjs

@@ -145,6 +145,21 @@ export async function hydrate(targetDir, opts = {}) {
     if (result) hydrated.push(relative(targetDir, result));
   }
 
+  // pm-api wrangler.toml.hbs hydration (Tier 2)
+  const pmApiWranglerPath = join(targetDir, 'pm-api', 'wrangler.toml.hbs');
+  try {
+    const wranglerResult = await hydrateFile(pmApiWranglerPath, {
+      ctx,
+      registry,
+      enabledProviders,
+      targetType: 'system',
+      targetName: 'wrangler.toml',
+    });
+    if (wranglerResult) hydrated.push(relative(targetDir, wranglerResult));
+  } catch {
+    // pm-api not present (Tier 0/1) — skip
+  }
+
   // Domain command generation
   const domains = projectYaml.operations?.domains || [];
   const domainResults = [];

package/lib/industry-presets.mjs

@@ -0,0 +1,135 @@
+/**
+ * Industry presets — maps industry type to template variables
+ * used in agent .hbs persona generation.
+ *
+ * Each preset provides 21 project.* variables that agent templates
+ * reference via {{project.example_entity}}, {{project.key_metrics}}, etc.
+ */
+
+const PRESETS = {
+  saas: {
+    industry_label: 'SaaS',
+    domain_expertise: 'SaaS product management, subscription lifecycle, activation & retention optimization',
+    key_metrics: 'MRR, Churn Rate, LTV, CAC, Trial-to-Paid Conversion',
+    example_entity: 'subscription plan',
+    example_entity_plural: 'subscription plans',
+    example_status_feature: 'plan health indicator',
+    example_status_states: '🟢 active, 🟡 at-risk, 🔴 churning',
+    example_metric_name: 'Trial-to-Paid Conversion Rate',
+    example_metric_before: '12%',
+    example_metric_target: '20%',
+    example_persona_primary: 'trial users in first 14 days',
+    example_icp: 'new SMB teams (5-20 seats)',
+    example_icp_ko: '신규 SMB 팀(5-20석)',
+    example_api_endpoint: '/api/subscriptions/{id}',
+    example_event_name: 'plan_status_viewed',
+    example_chart_name: 'MRR trend chart',
+    example_data_path: 'domains/subscriptions/database.md',
+    example_empty_state_msg: '구독 플랜을 등록해보세요',
+    example_few_shot_problem: 'Users discover plan issues 72h late',
+    example_few_shot_question: 'If we provide plan health indicators, will users take preventive action?',
+    example_action: 'upgrade to premium',
+  },
+
+  ecommerce: {
+    industry_label: 'E-commerce',
+    domain_expertise: 'E-commerce operations, product catalog management, order fulfillment & conversion optimization',
+    key_metrics: 'GMV, Conversion Rate, AOV, Cart Abandonment Rate, Repeat Purchase Rate',
+    example_entity: 'product listing',
+    example_entity_plural: 'product listings',
+    example_status_feature: 'listing performance indicator',
+    example_status_states: '🟢 top-seller, 🟡 underperforming, 🔴 stale',
+    example_metric_name: 'Cart-to-Purchase Conversion Rate',
+    example_metric_before: '18%',
+    example_metric_target: '28%',
+    example_persona_primary: 'first-time buyers within 7 days of signup',
+    example_icp: 'online shoppers aged 25-40 in metro areas',
+    example_icp_ko: '수도권 25-40세 온라인 쇼핑 고객',
+    example_api_endpoint: '/api/products/{id}',
+    example_event_name: 'product_detail_viewed',
+    example_chart_name: 'GMV trend chart',
+    example_data_path: 'domains/products/database.md',
+    example_empty_state_msg: '첫 번째 상품을 등록해보세요',
+    example_few_shot_problem: 'Sellers discover underperforming listings too late',
+    example_few_shot_question: 'If we show listing performance indicators, will sellers optimize faster?',
+    example_action: 'add to cart',
+  },
+
+  b2b_platform: {
+    industry_label: 'B2B Platform',
+    domain_expertise: 'B2B platform management, client onboarding, workflow automation & enterprise sales cycle',
+    key_metrics: 'ARR, Net Revenue Retention, Onboarding Completion Rate, Feature Adoption, Expansion Revenue',
+    example_entity: 'client workspace',
+    example_entity_plural: 'client workspaces',
+    example_status_feature: 'workspace health score',
+    example_status_states: '🟢 healthy, 🟡 needs-attention, 🔴 at-risk',
+    example_metric_name: 'Onboarding Completion Rate',
+    example_metric_before: '55%',
+    example_metric_target: '80%',
+    example_persona_primary: 'new enterprise clients in first 30 days',
+    example_icp: 'mid-market companies (50-500 employees)',
+    example_icp_ko: '중견기업(50-500명 규모)',
+    example_api_endpoint: '/api/workspaces/{id}',
+    example_event_name: 'workspace_setup_completed',
+    example_chart_name: 'ARR trend chart',
+    example_data_path: 'domains/workspaces/database.md',
+    example_empty_state_msg: '워크스페이스를 설정해보세요',
+    example_few_shot_problem: 'Clients get stuck during onboarding and churn before activation',
+    example_few_shot_question: 'If we provide guided onboarding with health scores, will completion rate improve?',
+    example_action: 'complete onboarding',
+  },
+
+  generic: {
+    industry_label: 'Digital Product',
+    domain_expertise: 'Product management, user experience optimization, growth and retention strategy',
+    key_metrics: 'DAU, Retention Rate, Activation Rate, NPS, Feature Adoption Rate',
+    example_entity: 'feature module',
+    example_entity_plural: 'feature modules',
+    example_status_feature: 'usage health indicator',
+    example_status_states: '🟢 active, 🟡 declining, 🔴 inactive',
+    example_metric_name: 'Feature Activation Rate',
+    example_metric_before: '25%',
+    example_metric_target: '45%',
+    example_persona_primary: 'new users in first 7 days',
+    example_icp: 'early adopters who complete onboarding',
+    example_icp_ko: '온보딩을 완료한 얼리어답터',
+    example_api_endpoint: '/api/resources/{id}',
+    example_event_name: 'feature_activated',
+    example_chart_name: 'DAU trend chart',
+    example_data_path: 'domains/core/database.md',
+    example_empty_state_msg: '첫 번째 항목을 만들어보세요',
+    example_few_shot_problem: 'Users sign up but never reach the activation moment',
+    example_few_shot_question: 'If we redesign the first-run experience, will activation rate improve?',
+    example_action: 'complete first task',
+  },
+};
+
+/** All required keys every preset must have */
+export const REQUIRED_KEYS = Object.keys(PRESETS.saas);
+
+/** List available industry IDs */
+export function listIndustries() {
+  return Object.keys(PRESETS);
+}
+
+/**
+ * Get a preset by industry ID.
+ * @param {string} industry
+ * @returns {Record<string, string>|null}
+ */
+export function getPreset(industry) {
+  return PRESETS[industry] || null;
+}
+
+/**
+ * Get a preset and allow overrides for specific fields.
+ * @param {string} industry
+ * @param {Record<string, string>} [overrides]
+ * @returns {Record<string, string>}
+ */
+export function getPresetWithOverrides(industry, overrides = {}) {
+  const base = PRESETS[industry] || PRESETS.generic;
+  return { ...base, ...overrides };
+}
+
+export default PRESETS;

package/lib/scaffold.mjs

@@ -57,6 +57,11 @@ async function walk(srcDir, destDir, targetDir, options, copied, overwritten, sk
       continue;
     }
 
+    // Skip pm-api and mcp-pm if not Tier 2
+    if (options.skipPmApi && (relPath.startsWith('pm-api') || relPath.startsWith('mcp-pm'))) {
+      continue;
+    }
+
     // Skip manifest.yaml (adapter metadata, not a project file)
     if (entry.name === 'manifest.yaml') {
       continue;

package/lib/setup-wizard.mjs

@@ -9,6 +9,7 @@ import { readdir, readFile, writeFile, mkdir } from 'node:fs/promises';
 import { join } from 'node:path';
 import { ask, confirm, select, createPrompt } from './prompt.mjs';
 import { parse as parseYaml, stringify as stringifyYaml } from './yaml-lite.mjs';
+import { listIndustries, getPresetWithOverrides } from './industry-presets.mjs';
 
 /**
  * Run the interactive setup wizard.
@@ -58,6 +59,39 @@ export async function runSetupWizard(targetDir, opts = {}) {
 
     console.log();
 
+    // ── Phase 1.5: Industry ──────────────────────────
+    console.log('  ──────────────────────────────────────');
+    console.log('  🏭 Industry');
+    console.log('  ──────────────────────────────────────');
+    console.log();
+
+    const industryOptions = listIndustries().map(id => ({
+      label: id === 'saas' ? 'SaaS' :
+             id === 'ecommerce' ? 'E-commerce' :
+             id === 'b2b_platform' ? 'B2B Platform' :
+             'Generic (any product)',
+      value: id,
+    }));
+
+    const industry = await select(rl, 'Industry type:', industryOptions, 3);
+    const preset = getPresetWithOverrides(industry);
+
+    // Offer override for key fields
+    console.log();
+    console.log('  You can customize key fields (Enter to keep defaults):');
+    const domainExpertiseOverride = await ask(rl, `Domain expertise [${preset.domain_expertise.slice(0, 50)}...]`);
+    const keyMetricsOverride = await ask(rl, `Key metrics [${preset.key_metrics.slice(0, 50)}...]`);
+    const exampleEntityOverride = await ask(rl, `Example entity [${preset.example_entity}]`);
+
+    const industryOverrides = {};
+    if (domainExpertiseOverride) industryOverrides.domain_expertise = domainExpertiseOverride;
+    if (keyMetricsOverride) industryOverrides.key_metrics = keyMetricsOverride;
+    if (exampleEntityOverride) industryOverrides.example_entity = exampleEntityOverride;
+
+    const industryPreset = getPresetWithOverrides(industry, industryOverrides);
+
+    console.log();
+
     // ── Phase 2: Domains ─────────────────────────────
     const hasDomains = await confirm(rl, 'Do you have work domains?', false);
     let domains = [];
@@ -96,6 +130,38 @@ export async function runSetupWizard(targetDir, opts = {}) {
       specSiteConfig.mode = specSiteTier;
     }
 
+    // ── Phase 6: Backend Setup (Tier 2) ──────────────
+    let pmApiConfig = { enabled: false, url: '', features: { rewards: false, meetings: true, docs: true, initiatives: true }, blockchain: { enabled: false, provider: '', token_name: '', contract_address: '', token_decimals: 8 } };
+
+    if (specSiteTier === 'interactive') {
+      console.log();
+      console.log('  ──────────────────────────────────────');
+      console.log('  🖥️  Backend Setup (Tier 2)');
+      console.log('  ──────────────────────────────────────');
+      console.log();
+
+      pmApiConfig.enabled = true;
+      pmApiConfig.url = await ask(rl, 'PM API URL (leave empty to configure later)');
+
+      console.log();
+      console.log('  Feature modules:');
+      pmApiConfig.features.rewards = await confirm(rl, 'Enable rewards/penalties module?', false);
+      pmApiConfig.features.meetings = await confirm(rl, 'Enable meetings module?', true);
+      pmApiConfig.features.docs = await confirm(rl, 'Enable docs module?', true);
+      pmApiConfig.features.initiatives = await confirm(rl, 'Enable initiatives module?', true);
+
+      console.log();
+      const enableBlockchain = await confirm(rl, 'Enable blockchain integration?', false);
+      if (enableBlockchain) {
+        pmApiConfig.blockchain.enabled = true;
+        pmApiConfig.blockchain.provider = await select(rl, 'Blockchain provider:', [
+          { label: 'TRON', value: 'tron' },
+        ], 0);
+        pmApiConfig.blockchain.token_name = await ask(rl, 'Token name');
+        pmApiConfig.blockchain.contract_address = await ask(rl, 'Contract address');
+      }
+    }
+
     console.log();
 
     // ── Phase 5: Integrations ────────────────────────
@@ -107,8 +173,9 @@ export async function runSetupWizard(targetDir, opts = {}) {
     // project.yaml
     const projectYaml = buildProjectYaml({
       projectName, tagline, projectType,
-      domains, devScope, integrations, specSiteConfig,
+      domains, devScope, integrations, specSiteConfig, pmApiConfig,
       platform: opts.platform || null,
+      industryPreset,
     });
     const contextDir = join(targetDir, '.context');
     await mkdir(contextDir, { recursive: true });
@@ -321,7 +388,7 @@ export const ALL_INTEGRATION_PROVIDERS = [
   'sqlite_lambda',
 ];
 
-function buildProjectYaml({ projectName, tagline, projectType, domains, devScope, integrations, specSiteConfig, platform }) {
+function buildProjectYaml({ projectName, tagline, projectType, domains, devScope, integrations, specSiteConfig, pmApiConfig, platform, industryPreset }) {
   // Build the full integrations block with all known providers
   const integrationsBlock = {};
 
@@ -338,6 +405,7 @@ function buildProjectYaml({ projectName, tagline, projectType, domains, devScope
       name: projectName,
       tagline: tagline || '',
       type: projectType,
+      ...(industryPreset || {}),
     },
     problem: {
       core: '',
@@ -382,6 +450,7 @@ function buildProjectYaml({ projectName, tagline, projectType, domains, devScope
         deploy_url: '',
         backend: specSiteConfig.backend,
       },
+      pm_api: pmApiConfig || { enabled: false },
     },
     _meta: {
       created_at: new Date().toISOString(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "popilot",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Multi-agent PO/PM system scaffold for Claude Code",
   "type": "module",
   "bin": {

package/scaffold/.context/agents/TEMPLATE.md

@@ -70,6 +70,18 @@ read_only: true | false                # Whether this agent can modify files
 - Definition of evidence (file:line, data, URL, etc.)
 - BAD → GOOD transformation example
 
+### 13.5. Evidence Requirements (MANDATORY for data-consuming agents)
+- All PASS/FAIL verdicts must include: data source, measurement period, sample size
+- Structured evidence table format (Item | Verdict | Evidence)
+- Numerical recording principle: both absolute values and change rates
+- Anti-patterns: no subjective judgments, no conclusions without data sources, no one-sided measurements
+
+### 13.6. Surface → Hidden Need Pattern (MANDATORY for customer-facing agents)
+- Surface complaint is never the real problem
+- Every VOC must follow: Surface → Hidden Need → Root Cause → Hypothesis pipeline
+- Hidden Need must have 2+ supporting quotes
+- Output must end with IF/THEN/BECAUSE hypothesis proposal
+
 ### 14. Context Budget (MANDATORY)
 - Files to skip
 - Reading strategy by file size (200+ lines → partial read)
@@ -90,6 +102,8 @@ read_only: true | false                # Whether this agent can modify files
 | Few-shot Examples | 2+ Good/Bad pairs | Bad must be a realistic failure, not a strawman |
 | Final Checklist | 5-7 Yes/No items | Answerable without additional context |
 | Evidence Principle | Declaration + 1 example | Must include BAD→GOOD transformation |
+| Evidence Requirements | Structured table format | Data source + period + numbers for every verdict |
+| Hidden Need Pattern | Surface → Hidden Need → Hypothesis | 2+ quotes supporting hidden need |
 | Context Budget | 3+ rules | Must include "what to skip" guidance |
 
 ---

package/scaffold/.context/agents/analyst.md.hbs

@@ -326,7 +326,7 @@ GOOD: "M1 retention: 45% (Jul) → 35% (Oct). N=23→46 signups per month. Trend
 | Document | Path | Content |
 |----------|------|---------|
 | **Full DB Overview** | `global/database/index.md` | ERD, table categories, query guide |
-| **Domain Detail** | `domains/ads/database.md` | Domain-specific detailed schema, ETL flows |
+| **Domain Detail** | `{{project.example_data_path}}` | Domain-specific detailed schema, ETL flows |
 
 ### Pre-Query Checklist
 ```
@@ -351,12 +351,12 @@ Files Danny **must** read upon activation:
 
 ### Domain-Specific Load (During Work)
 ```
-When working on domain analysis → domains/ads/database.md (domain-specific detailed schema)
+When working on domain analysis → {{project.example_data_path}} (domain-specific detailed schema)
 ```
 
 ---
 
 *Reference Context*: `global/database/index.md`, `global/metrics.md`, `global/strategy.md`
-*Domain Context*: `domains/ads/database.md`
+*Domain Context*: `{{project.example_data_path}}`
 *Tools*: {{INTEGRATION_TOOLS_FOOTER}}
 *Connected Agents*: 🎯 Simon (insight delivery), 📊 Vicky (deep analysis request), 📋 Penny (execution rationale), 📡 Tara (tracking ready notification + data quality issues)