bopodev-api 0.1.16 → 0.1.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bopodev-api",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "license": "MIT",
   "type": "module",
   "files": [
@@ -17,9 +17,9 @@
     "nanoid": "^5.1.5",
     "ws": "^8.19.0",
     "zod": "^4.1.5",
-    "bopodev-agent-sdk": "0.1.16",
-    "bopodev-contracts": "0.1.16",
-    "bopodev-db": "0.1.16"
+    "bopodev-agent-sdk": "0.1.18",
+    "bopodev-db": "0.1.18",
+    "bopodev-contracts": "0.1.18"
   },
   "devDependencies": {
     "@types/cors": "^2.8.19",

package/src/scripts/onboard-seed.ts

@@ -1,6 +1,6 @@
 import { pathToFileURL } from "node:url";
 import { mkdir } from "node:fs/promises";
-import { TemplateManifestDefault, TemplateManifestSchema } from "bopodev-contracts";
+import { TemplateManifestSchema } from "bopodev-contracts";
 import { getAdapterModels } from "bopodev-agent-sdk";
 import {
   bootstrapDatabase,
@@ -71,6 +71,8 @@ export async function ensureOnboardingSeed(input: {
   }
   const agentProvider = parseAgentProvider(input.agentProvider) ?? "shell";
   const requestedAgentModel = input.agentModel?.trim() || undefined;
+  const requestedTemplateId = input.templateId?.trim() || null;
+  const useTemplateOnlySeed = requestedTemplateId !== null;
 
   const { db, client } = await bootstrapDatabase(input.dbPath);
 
@@ -97,106 +99,111 @@ export async function ensureOnboardingSeed(input: {
     const companyId = companyRow.id;
     const resolvedCompanyName = companyRow.name;
     await ensureCompanyBuiltinTemplateDefaults(db, companyId);
-    const defaultRuntimeCwd = await resolveDefaultRuntimeCwdForCompany(db, companyId);
-    await mkdir(normalizeCompanyWorkspacePath(companyId, defaultRuntimeCwd), { recursive: true });
-    const seedRuntimeEnv = resolveSeedRuntimeEnv(agentProvider);
-    const defaultRuntimeConfig = normalizeRuntimeConfig({
-      defaultRuntimeCwd,
-      runtimeConfig: {
-        runtimeEnv: seedRuntimeEnv,
-        runtimeModel: await resolveSeedRuntimeModel(agentProvider, {
-          requestedModel: requestedAgentModel,
-          defaultRuntimeCwd,
-          runtimeEnv: seedRuntimeEnv
-        })
-      }
-    });
     const agents = await listAgents(db, companyId);
     const existingCeo = agents.find((agent) => agent.role === "CEO" || agent.name === "CEO");
     let ceoCreated = false;
     let ceoMigrated = false;
     let ceoProviderType: AgentProvider = parseAgentProvider(existingCeo?.providerType) ?? agentProvider;
     let ceoRuntimeModel = existingCeo?.runtimeModel ?? null;
-
-    let ceoId = existingCeo?.id ?? null;
-
-    if (!existingCeo) {
-      const ceo = await createAgent(db, {
-        companyId,
-        role: "CEO",
-        name: "CEO",
-        providerType: agentProvider,
-        heartbeatCron: "*/5 * * * *",
-        monthlyBudgetUsd: "100.0000",
-        canHireAgents: true,
-        ...runtimeConfigToDb(defaultRuntimeConfig),
-        initialState: runtimeConfigToStateBlobPatch(defaultRuntimeConfig)
-      });
-      ceoId = ceo.id;
-      ceoCreated = true;
-      ceoProviderType = agentProvider;
-      ceoRuntimeModel = ceo.runtimeModel ?? defaultRuntimeConfig.runtimeModel ?? null;
-    } else if (isBootstrapCeoRuntime(existingCeo.providerType, existingCeo.stateBlob)) {
-      const nextState = {
-        ...stripRuntimeFromState(existingCeo.stateBlob),
-        ...runtimeConfigToStateBlobPatch(defaultRuntimeConfig)
-      };
-      await updateAgent(db, {
-        companyId,
-        id: existingCeo.id,
-        providerType: agentProvider,
-        ...runtimeConfigToDb(defaultRuntimeConfig),
-        stateBlob: nextState
-      });
-      ceoMigrated = true;
-      ceoProviderType = agentProvider;
-      ceoId = existingCeo.id;
-      ceoRuntimeModel = defaultRuntimeConfig.runtimeModel ?? null;
-    } else {
-      ceoId = existingCeo.id;
-      ceoRuntimeModel = existingCeo.runtimeModel ?? null;
-    }
-
-    if (ceoId) {
-      const startupProjectId = await ensureStartupProject(db, companyId);
-      await ensureCeoStartupTask(db, {
-        companyId,
-        projectId: startupProjectId,
-        ceoId
+    if (!useTemplateOnlySeed) {
+      const defaultRuntimeCwd = await resolveDefaultRuntimeCwdForCompany(db, companyId);
+      await mkdir(normalizeCompanyWorkspacePath(companyId, defaultRuntimeCwd), { recursive: true });
+      const seedRuntimeEnv = resolveSeedRuntimeEnv(agentProvider);
+      const defaultRuntimeConfig = normalizeRuntimeConfig({
+        defaultRuntimeCwd,
+        runtimeConfig: {
+          runtimeEnv: seedRuntimeEnv,
+          runtimeModel: await resolveSeedRuntimeModel(agentProvider, {
+            requestedModel: requestedAgentModel,
+            defaultRuntimeCwd,
+            runtimeEnv: seedRuntimeEnv
+          })
+        }
       });
+      let ceoId = existingCeo?.id ?? null;
+      if (!existingCeo) {
+        const ceo = await createAgent(db, {
+          companyId,
+          role: "CEO",
+          name: "CEO",
+          providerType: agentProvider,
+          heartbeatCron: "*/5 * * * *",
+          monthlyBudgetUsd: "100.0000",
+          canHireAgents: true,
+          ...runtimeConfigToDb(defaultRuntimeConfig),
+          initialState: runtimeConfigToStateBlobPatch(defaultRuntimeConfig)
+        });
+        ceoId = ceo.id;
+        ceoCreated = true;
+        ceoProviderType = agentProvider;
+        ceoRuntimeModel = ceo.runtimeModel ?? defaultRuntimeConfig.runtimeModel ?? null;
+      } else if (isBootstrapCeoRuntime(existingCeo.providerType, existingCeo.stateBlob)) {
+        const nextState = {
+          ...stripRuntimeFromState(existingCeo.stateBlob),
+          ...runtimeConfigToStateBlobPatch(defaultRuntimeConfig)
+        };
+        await updateAgent(db, {
+          companyId,
+          id: existingCeo.id,
+          providerType: agentProvider,
+          ...runtimeConfigToDb(defaultRuntimeConfig),
+          stateBlob: nextState
+        });
+        ceoMigrated = true;
+        ceoProviderType = agentProvider;
+        ceoId = existingCeo.id;
+        ceoRuntimeModel = defaultRuntimeConfig.runtimeModel ?? null;
+      } else {
+        ceoId = existingCeo.id;
+        ceoRuntimeModel = existingCeo.runtimeModel ?? null;
+      }
+      if (ceoId) {
+        const startupProjectId = await ensureStartupProject(db, companyId);
+        await ensureCeoStartupTask(db, {
+          companyId,
+          projectId: startupProjectId,
+          ceoId
+        });
+      }
     }
     let templateApplied = false;
     let appliedTemplateId: string | null = null;
-    if (input.templateId?.trim()) {
-      const requestedTemplateId = input.templateId.trim();
+    if (requestedTemplateId) {
       const template =
         (await getTemplate(db, companyId, requestedTemplateId)) ??
         (await getTemplateBySlug(db, companyId, requestedTemplateId));
-      if (template) {
-        const templateVersion = await getCurrentTemplateVersion(db, companyId, template.id);
-        if (templateVersion) {
-          let manifest: Record<string, unknown> = {};
-          try {
-            manifest = JSON.parse(templateVersion.manifestJson) as Record<string, unknown>;
-          } catch {
-            manifest = {};
-          }
-          const parsedManifest = TemplateManifestSchema.safeParse(manifest);
-          const normalizedManifest = parsedManifest.success
-            ? parsedManifest.data
-            : TemplateManifestSchema.parse(TemplateManifestDefault);
-          const applied = await applyTemplateManifest(db, {
-            companyId,
-            templateId: template.id,
-            templateVersion: templateVersion.version,
-            templateVersionId: templateVersion.id,
-            manifest: normalizedManifest,
-            variables: {}
-          });
-          templateApplied = applied.applied;
-          appliedTemplateId = template.id;
-        }
+      if (!template) {
+        throw new Error(`Requested onboarding template '${requestedTemplateId}' was not found for company '${companyId}'.`);
+      }
+      const templateVersion = await getCurrentTemplateVersion(db, companyId, template.id);
+      if (!templateVersion) {
+        throw new Error(`Template '${requestedTemplateId}' has no current version and cannot be applied during onboarding.`);
+      }
+      let manifest: Record<string, unknown>;
+      try {
+        manifest = JSON.parse(templateVersion.manifestJson) as Record<string, unknown>;
+      } catch {
+        throw new Error(`Template '${requestedTemplateId}' has invalid manifest JSON in current version '${templateVersion.version}'.`);
+      }
+      const parsedManifest = TemplateManifestSchema.safeParse(manifest);
+      if (!parsedManifest.success) {
+        throw new Error(
+          `Template '${requestedTemplateId}' has invalid manifest schema in current version '${templateVersion.version}': ${parsedManifest.error.message}`
+        );
+      }
+      const applied = await applyTemplateManifest(db, {
+        companyId,
+        templateId: template.id,
+        templateVersion: templateVersion.version,
+        templateVersionId: templateVersion.id,
+        manifest: parsedManifest.data,
+        variables: {}
+      });
+      if (!applied.applied) {
+        throw new Error(`Template '${requestedTemplateId}' did not apply successfully during onboarding.`);
       }
+      templateApplied = true;
+      appliedTemplateId = template.id;
     }
     await ensureCompanyModelPricingDefaults(db, companyId);
 

package/src/services/template-catalog.ts

@@ -82,7 +82,39 @@ const builtinTemplateDefinitions: BuiltinTemplateDefinition[] = [
           providerType: "codex",
           heartbeatCron: "*/15 * * * *",
           monthlyBudgetUsd: 150,
-          canHireAgents: true
+          canHireAgents: true,
+          runtimeConfig: {
+            bootstrapPrompt: [
+              "You are Founder CEO for {{brandName}}.",
+              "Mission: build and grow {{productName}} for {{targetAudience}} with consistent weekly execution.",
+              "",
+              "Operating standards:",
+              "- Keep a single weekly priority stack and limit work in progress.",
+              "- Tie every initiative to customer value, speed, and learning.",
+              "- Reject low-leverage tasks and clarify scope before delegating.",
+              "",
+              "Cadence:",
+              "- Start of week: set top 3 company outcomes and assign owners.",
+              "- Midweek: unblock teams, remove ambiguity, and rebalance capacity.",
+              "- End of week: publish outcomes, misses, learnings, and next-week bets.",
+              "",
+              "Decision policy:",
+              "- Prefer reversible decisions quickly; escalate only irreversible risks.",
+              "- Use lightweight assumptions and explicit success/failure criteria.",
+              "- When uncertain, run the smallest experiment that reduces risk.",
+              "",
+              "Output format for each meaningful update:",
+              "1) objective, 2) decision, 3) expected impact, 4) owner, 5) due date, 6) risks.",
+              "",
+              "Escalation rules:",
+              "- Escalate legal/compliance, security/privacy, or spending decisions above planned budget.",
+              "- If blocked >24h, create/assign a concrete unblock issue with next step.",
+              "",
+              "Quality bar:",
+              "- Be concise, specific, and execution-ready.",
+              "- Do not produce generic plans without owners, dates, and measurable outcomes."
+            ].join("\n")
+          }
         },
         {
           key: "founding-engineer",
@@ -92,7 +124,30 @@ const builtinTemplateDefinitions: BuiltinTemplateDefinition[] = [
           providerType: "codex",
           heartbeatCron: "*/15 * * * *",
           monthlyBudgetUsd: 300,
-          canHireAgents: false
+          canHireAgents: false,
+          runtimeConfig: {
+            bootstrapPrompt: [
+              "You are Founding Engineer for {{productName}}.",
+              "Mission: ship high-impact product improvements quickly while preserving reliability.",
+              "",
+              "Execution rules:",
+              "- Prefer small, reviewable changes with clear rollback paths.",
+              "- Validate assumptions with tests, logs, and observable outcomes.",
+              "- Keep issue states accurate and communicate blockers early.",
+              "",
+              "Delivery quality bar:",
+              "- Every change should include problem statement, approach, and verification.",
+              "- Protect user trust: avoid risky shortcuts in auth, billing, or data integrity paths.",
+              "- If a task is ambiguous, propose 1-2 options with trade-offs before implementing.",
+              "",
+              "Handoff format:",
+              "1) what changed, 2) why, 3) test evidence, 4) follow-ups, 5) risks.",
+              "",
+              "Collaboration policy:",
+              "- Coordinate with Growth Operator when changes affect funnel events, landing flows, or analytics.",
+              "- Escalate to Founder CEO when scope, timeline, or risk materially changes."
+            ].join("\n")
+          }
         },
         {
           key: "growth-operator",
@@ -102,7 +157,30 @@ const builtinTemplateDefinitions: BuiltinTemplateDefinition[] = [
           providerType: "codex",
           heartbeatCron: "*/30 * * * *",
           monthlyBudgetUsd: 200,
-          canHireAgents: false
+          canHireAgents: false,
+          runtimeConfig: {
+            bootstrapPrompt: [
+              "You are Growth Operator for {{brandName}}.",
+              "Mission: create repeatable demand from {{targetAudience}} with measurable experiments.",
+              "",
+              "Operating model:",
+              "- Maintain an active experiment backlog by funnel stage: acquisition, activation, retention.",
+              "- Prioritize experiments by expected impact, confidence, and effort.",
+              "- Close the loop weekly: run, measure, learn, and decide next action.",
+              "",
+              "Experiment quality bar:",
+              "- Each experiment must define hypothesis, audience, channel, KPI, success threshold, and deadline.",
+              "- Record outcomes and recommended next step (scale, iterate, stop).",
+              "- Avoid vanity metrics; optimize for meaningful business movement.",
+              "",
+              "Reporting format:",
+              "1) hypothesis, 2) result vs target, 3) key learning, 4) decision, 5) owner and due date.",
+              "",
+              "Escalation:",
+              "- Escalate if tracking data is unreliable, attribution is unclear, or channel spend exceeds plan.",
+              "- Coordinate with Founder CEO before changing positioning or major pricing narratives."
+            ].join("\n")
+          }
         }
       ],
       issues: [
@@ -202,7 +280,30 @@ const builtinTemplateDefinitions: BuiltinTemplateDefinition[] = [
           providerType: "codex",
           heartbeatCron: "*/20 * * * *",
           monthlyBudgetUsd: 250,
-          canHireAgents: true
+          canHireAgents: true,
+          runtimeConfig: {
+            bootstrapPrompt: [
+              "You are Head of Marketing for {{brandName}}.",
+              "Mission: build a predictable content-led pipeline among {{targetAudience}}.",
+              "",
+              "Leadership responsibilities:",
+              "- Set weekly narrative priorities and campaign themes.",
+              "- Ensure strategy, production, and distribution operate as one system.",
+              "- Convert performance data into clear decisions and resource allocation.",
+              "",
+              "Decision framework:",
+              "- Prioritize efforts that improve qualified reach, engagement depth, and conversion intent.",
+              "- Stop channels that underperform for 2 consecutive cycles without new evidence.",
+              "- Protect message consistency across all assets.",
+              "",
+              "Weekly output requirements:",
+              "1) strategy focus, 2) content plan, 3) distribution plan, 4) KPI targets, 5) review notes.",
+              "",
+              "Escalation:",
+              "- Escalate major brand/positioning shifts, compliance-sensitive claims, or budget overrun risks.",
+              "- If dependencies block publication, create unblock issues within 24h."
+            ].join("\n")
+          }
         },
         {
           key: "content-strategist",
@@ -212,7 +313,26 @@ const builtinTemplateDefinitions: BuiltinTemplateDefinition[] = [
           providerType: "codex",
           heartbeatCron: "*/30 * * * *",
           monthlyBudgetUsd: 180,
-          canHireAgents: false
+          canHireAgents: false,
+          runtimeConfig: {
+            bootstrapPrompt: [
+              "You are Content Strategist for {{brandName}}.",
+              "Mission: turn business priorities into a high-quality editorial system for {{targetAudience}}.",
+              "",
+              "Strategy rules:",
+              "- Build topic clusters tied to audience pains, jobs-to-be-done, and buying intent.",
+              "- Maintain a 4-week calendar with clear primary asset and supporting assets.",
+              "- Define angle, thesis, evidence, CTA, and distribution intent per piece.",
+              "",
+              "Quality bar:",
+              "- Avoid generic topics; each piece must have a distinctive point of view.",
+              "- Ensure briefs are actionable for writers with clear structure and acceptance criteria.",
+              "- Reprioritize quickly based on performance and market signal.",
+              "",
+              "Brief output format:",
+              "title, audience segment, core claim, outline, proof points, CTA, KPI."
+            ].join("\n")
+          }
         },
         {
           key: "content-writer",
@@ -222,7 +342,27 @@ const builtinTemplateDefinitions: BuiltinTemplateDefinition[] = [
           providerType: "codex",
           heartbeatCron: "*/30 * * * *",
           monthlyBudgetUsd: 220,
-          canHireAgents: false
+          canHireAgents: false,
+          runtimeConfig: {
+            bootstrapPrompt: [
+              "You are Content Writer for {{brandName}}.",
+              "Mission: produce clear, persuasive, high-signal content for {{targetAudience}}.",
+              "",
+              "Writing standards:",
+              "- Lead with a strong hook and a concrete thesis.",
+              "- Use specific examples, data, and practical next actions.",
+              "- Match tone to channel, especially {{primaryChannel}}.",
+              "",
+              "Quality checklist before delivery:",
+              "- Clarity: one idea per section and readable structure.",
+              "- Credibility: supported claims, no fabricated facts.",
+              "- Conversion: explicit CTA aligned to campaign intent.",
+              "- Reusability: identify snippets for derivative assets.",
+              "",
+              "Delivery format:",
+              "1) draft, 2) headline options, 3) CTA options, 4) repurpose notes."
+            ].join("\n")
+          }
         },
         {
           key: "distribution-manager",
@@ -232,7 +372,29 @@ const builtinTemplateDefinitions: BuiltinTemplateDefinition[] = [
           providerType: "codex",
           heartbeatCron: "*/30 * * * *",
           monthlyBudgetUsd: 180,
-          canHireAgents: false
+          canHireAgents: false,
+          runtimeConfig: {
+            bootstrapPrompt: [
+              "You are Distribution Manager for {{brandName}}.",
+              "Mission: maximize reach and qualified engagement for every published asset.",
+              "",
+              "Distribution playbook:",
+              "- Repurpose each flagship piece into channel-native derivatives.",
+              "- Schedule posts for timing, audience fit, and frequency balance.",
+              "- Track performance and feed insights back into next planning cycle.",
+              "",
+              "Execution rules:",
+              "- Tailor message framing by channel while preserving core narrative.",
+              "- Keep UTM/tracking discipline so results are attributable.",
+              "- Prioritize channels with best qualified engagement-to-effort ratio.",
+              "",
+              "Weekly report format:",
+              "1) assets distributed, 2) channel metrics, 3) winners/losers, 4) next-week actions.",
+              "",
+              "Escalation:",
+              "- Escalate platform policy/compliance issues and repeated low performance after two optimization attempts."
+            ].join("\n")
+          }
         }
       ],
       issues: [