@oxygen-agent/cli 1.888.6 → 1.894.0

package/node_modules/@oxygen/shared/dist/knowledge-seed-content.js

@@ -1,8 +1,8 @@
 // Knowledge Graph starter pack (the Karpathy LLM-wiki scaffold). A fresh workspace
-// self-seeds this page set on first onboarding / `oxygen knowledge seed` so the wiki
-// arrives alive: two active nav pages ([[start-here]] + the [[conventions]] schema page)
-// and seven draft stub hubs that show the shape of a healthy second brain without
-// grounding any AI copy until a human fills them.
+// self-seeds this page set at tenant provisioning / first onboarding / `oxygen knowledge
+// seed`, so the wiki arrives alive: two active nav pages ([[start-here]] + the
+// [[conventions]] schema page) and nineteen draft stub hubs that show the shape of a
+// healthy second brain without grounding any AI copy until a human fills them.
 //
 // The seeder (tenant-db `ensureKnowledgeScaffold`) is purely additive and version-gated:
 // it creates a page only when its slug is free (never overwriting a user's edits) and
@@ -10,9 +10,33 @@
 // and add pages with a higher `minScaffoldVersion` to ship a new wave; existing pages are
 // never rewritten by the scaffold. Bodies are the single source of truth for the starter
 // content — keep them dense and wikilinked.
+//
+// BINDING RULE — a scaffold wave adds ZERO active pages. Every content page ships
+// `status: "draft"` with `seed` in its tags; only the two nav pages are active, and they
+// are written full rather than as stubs. `retrieveWorkspaceKnowledge` selects on
+// `status = 'active'` with MIN_BODY_CHARS = 80, so an ACTIVE stub is grounding material:
+// "Stub — fill me. ## Firmographics —" would be injected verbatim into a customer's cold
+// email as company knowledge. Promoting a stub to active is the user's act, never the
+// scaffold's.
+//
+// NEVER SEED `outreach-learnings`, `won-lost-learnings`, or `meeting-learnings`. tenant-db
+// `ensureLearningsPage` get-or-creates them as `active` on the first reply, deal, or
+// meeting and returns an existing row UNTOUCHED — seeding them as draft stubs would pin
+// them draft forever and silently break the learning loop's read half. They stay dashed
+// unresolved links in [[campaign-learnings]] until the loop creates them for real.
 /** Monotonic scaffold cursor stored in knowledge_state.scaffold_version. Bump to ship a
- *  new wave of starter pages (tag them with a higher minScaffoldVersion). */
-export const KNOWLEDGE_SCAFFOLD_VERSION = 1;
+ *  new wave of starter pages (tag them with a higher minScaffoldVersion).
+ *  v1: the 9-page core. v2: twelve GTM stubs (voice/brand/messaging/objections, three
+ *  motion playbooks + qualification, and the personas/customers/research/metrics hubs). */
+// KNOWN LIMITATION of a create-only seeder, accepted deliberately: on a workspace
+// UPGRADED from an earlier wave, the new pages get no inbound links, because the hub that
+// would link them (start-here) already exists and the scaffold never rewrites an existing
+// page. Those pages are reachable through `knowledge index`, search and the graph, and
+// `knowledge lint` excludes unfilled stubs from `orphans` so they are not reported as
+// unfixable noise. Do NOT "fix" this by having the seeder patch existing bodies —
+// never-overwrite is the entire safety property of this mechanism, and trading it for a
+// tidier link graph on upgraded workspaces is a bad trade.
+export const KNOWLEDGE_SCAFFOLD_VERSION = 2;
 const START_HERE_BODY = `# Start here
 
 This is the workspace's knowledge wiki — one shared, compounding second brain for every human and every AI agent here. It replaces scattered Notion docs, chat history, and one-off prompts.
@@ -24,13 +48,11 @@ This is the workspace's knowledge wiki — one shared, compounding second brain
 - **Trust travels.** Every claim cites its source. Canonical live copy (voice / brand / [[positioning]]) is human-approved; everything else auto-writes as revertible revisions. See [[conventions]].
 
 ## Hubs
-- [[icp]] — who we sell to
-- [[positioning]] — how we describe ourselves vs. alternatives
-- [[offers]] — what we sell and for how much
-- [[competitors]] — competitor teardowns (map of content)
-- [[playbooks]] — how we run each GTM motion (map of content)
-- [[campaign-learnings]] — what outreach and meetings taught us
-- [[decisions]] — standing GTM decisions and what would reverse them
+- **Who we sell to** — [[icp]] accounts · [[personas]] buyers · [[customers]] who bought and why
+- **What we say** — [[positioning]] vs. alternatives · [[voice]] how we sound · [[brand]] the promise and the provable claims · [[messaging]] hooks by persona · [[objections]] pushback and our answers
+- **What we sell** — [[offers]] packages and prices · [[competitors]] teardowns
+- **How we run it** — [[playbooks]] one page per motion · [[qualification]] the fit gate
+- **What we learned** — [[campaign-learnings]] outcomes · [[metrics]] the numbers and their definitions · [[research]] dated investigations · [[decisions]] standing calls and what reverses them
 
 ## Seeing the shape
 \`oxygen knowledge graph\` (or the web graph) shows hubs, orphans, and dashed unresolved links — the gaps worth filling next. \`oxygen knowledge lint\` is the health report.
@@ -62,10 +84,10 @@ Index-first → open only relevant pages → answer citing slugs → file durabl
 | \`schema\` | describes the wiki itself (this page) |
 
 ## Slugs
-Flat kebab: lowercase alphanumerics + dashes, no slashes, ≤120 chars. **Immutable once created** — choose the durable name (\`competitor-clay\`, not \`clay-notes-july\`). No folders; types, tags, and [[wikilinks]] organize. Reserved (never create): \`index\`, \`log\`, \`schema\`, \`company-profile\`, \`readme\`.
+Flat kebab: lowercase alphanumerics + dashes, no slashes, ≤120 chars. **Immutable once created** — choose the durable name (\`competitor-clay\`, not \`clay-notes-july\`). No folders; types, tags, and wikilinks organize. Reserved (never create): \`index\`, \`log\`, \`schema\`, \`company-profile\`, \`readme\`.
 
 ## Wikilinks
-\`[[slug]]\`, \`[[slug|alias]]\`, \`[[slug#heading]]\` all key to the slug. **Linking to a page that doesn't exist yet is good** — the dashed node is a visible to-do. Every page should link out (avoid dead-ends) and be linked to (avoid orphans).
+Wrap a slug in double square brackets to link it. Three forms all resolve to the same page — bare (\`slug\`), aliased (\`slug|display text\`), and heading-anchored (\`slug#heading\`) — because the alias and the heading are stripped before lookup. **Linking to a page that doesn't exist yet is good** — the dashed node is a visible to-do. Every page should link out (avoid dead-ends) and be linked to (avoid orphans).
 
 ## New page vs. edit
 New page when it's a distinct entity/concept you'd link to from elsewhere. Edit in place when it's an attribute or update of an existing page. Search first (\`oxygen knowledge search\`) — near-duplicate slugs rot the graph.
@@ -87,14 +109,14 @@ Prune agent-derived claims once a human verifies the same fact. A contested clai
 Record standing calls in [[decisions]] using the template there. Every decision needs a rationale AND a \`## Reversal condition\` — the observable evidence that would flip it — so agents can flag when new data contradicts a standing decision.
 
 ## Stub-fill contract
-Seeded stubs (tag \`seed\`, still at revision 1, \`status: draft\`) are scaffolding. Replace the body with real cited content, keep the [[wikilinks]], set \`status: active\`. **No approval needed.** Until filled they stay draft and never ground AI copy. \`oxygen knowledge lint\` lists unfilled stubs.
+Seeded stubs (tag \`seed\`, still at revision 1, \`status: draft\`) are scaffolding. Replace the body with real cited content, keep the wikilinks, set \`status: active\`. **No approval needed.** Until filled they stay draft and never ground AI copy. \`oxygen knowledge lint\` lists unfilled stubs.
 
 ## Lint discipline
-Run \`oxygen knowledge lint\` regularly. It reports orphans, dead-ends, unresolved links (ranked by demand), untagged pages, duplicate titles, oversized hubs, missing summaries/canonicals, stale/oversized pages, unfilled stubs, and decisions missing a reversal condition. \`oxygen knowledge lint relink\` rebuilds edges after bulk edits.
+Run \`oxygen knowledge lint\` regularly — it is the health report, and it names its own categories, so read its output rather than a list here. Three worth knowing by name: **contradictions** (a page tagged \`disputed\` is silently excluded from every AI answer; \`disputed\` + \`verified\` together is a trust conflict; two active pages of the same live-copy type compete inside one prompt), **unfilled stubs** (ranked by how many pages already link to them — fill those first), and **stale** (untouched for 90 days, or *superseded*: sources filed onto the page after its last edit, which on a learnings page means \`oxygen knowledge synthesize\` is overdue, not that anything broke). \`oxygen knowledge lint relink\` rebuilds edges after bulk edits.
 `;
 const ICP_BODY = `# ICP — ideal customer profile
 
-> **Stub — fill me.** Seeded scaffolding. Replace with real, cited content, keep the [[wikilinks]], then set \`status: active\`. No approval needed. Draft stubs do not ground AI copy. How-to: [[conventions]].
+> **Stub — fill me.** Seeded scaffolding. Replace with real, cited content, keep the wikilinks, then set \`status: active\`. No approval needed. Draft stubs do not ground AI copy. How-to: [[conventions]].
 
 ## Firmographics
 - Company type / size / stage:
@@ -108,7 +130,7 @@ const ICP_BODY = `# ICP — ideal customer profile
 - Who we should NOT pursue and why:
 
 ## Buyer personas
-- Link one [[persona]] page per buyer (economic buyer, champion, user).
+- The buyers inside a fit account live in [[personas]] — one \`persona\` page each (economic buyer, champion, user).
 
 ## Basis
 - Cite the deals, calls, or market data this is drawn from. Contradicting evidence should route through [[campaign-learnings]] and update [[positioning]].
@@ -134,7 +156,7 @@ const POSITIONING_BODY = `# Positioning
 `;
 const OFFERS_BODY = `# Offers
 
-> **Stub — fill me.** Seeded scaffolding — fill, keep [[wikilinks]], set \`status: active\`. See [[conventions]].
+> **Stub — fill me.** Seeded scaffolding — fill, keep the wikilinks, set \`status: active\`. See [[conventions]].
 
 ## Offers
 For each: name, who it's for ([[icp]]), price/packaging, the outcome it delivers, and qualifying criteria.
@@ -147,11 +169,10 @@ Tie each offer to the value in [[positioning]] and the motions in [[playbooks]].
 `;
 const COMPETITORS_BODY = `# Competitors (map of content)
 
-> **Stub — fill me.** This is a hub. Create one \`competitor\` page per rival (e.g. \`[[competitor-clay]]\`) and link it here; then fill this overview. See [[conventions]].
+> **Stub — fill me.** This is a hub. Create one \`competitor\` page per rival — durable slugs like \`competitor-clay\`, \`competitor-apollo\` — wikilink each one here, then fill this overview. See [[conventions]].
 
 ## Landscape
-- One line per competitor + link to its teardown page.
-- [[competitor-example]] — replace with real teardowns.
+- One line per competitor, wikilinked to its own teardown page. Replace this line with the real ones.
 
 ## Our stance
 - Where we consistently win / lose (draw from [[positioning]] and [[campaign-learnings]]).
@@ -162,6 +183,7 @@ const PLAYBOOKS_BODY = `# Playbooks (map of content)
 
 ## Motions
 - [[playbook-outbound]] — cold outbound
+- [[playbook-inbound]] — inbound, referrals, and self-serve signups
 - [[playbook-nurture]] — nurture / re-engagement
 - (add: demo, onboarding, expansion)
 
@@ -178,6 +200,8 @@ Learning-worthy outcomes auto-file as **immutable sources** (facts, no approval)
 - completed meetings + notes → [[meeting-learnings]]
 - A/B auto-winners and human edits to AI drafts → the relevant learnings page
 
+Those three pages do not exist yet — the first reply, closed deal, or completed meeting creates each one automatically, which is why they show as dashed unresolved links until then.
+
 ## Distill
 \`oxygen knowledge synthesize\` (and the opt-in scheduled agent) turns accumulated sources into learnings-page revisions — with citations and a "what would change our mind" line per recommendation. Retrieval then grounds the NEXT campaign's drafts on them.
 
@@ -201,11 +225,258 @@ The observable evidence that would flip this decision.
 
 Every decision MUST have a \`## Reversal condition\` — \`oxygen knowledge lint\` flags decision pages that lack one. Record the call in the log too: \`oxygen knowledge log append --event decision --slug <page> --summary "<what/why>"\`.
 `;
+// ---------------------------------------------------------------------------
+// Scaffold v2 — twelve GTM stubs. All draft + `seed`-tagged (see the binding rule
+// at the top of this file). Every body opens with the same stub contract line and
+// links out to at least one other page, so the wave adds no dead-ends.
+// ---------------------------------------------------------------------------
+const VOICE_BODY = `# Voice
+
+> **Stub — fill me.** Seeded scaffolding. Replace with real, cited content, keep the wikilinks, then set \`status: active\`. No approval needed. Draft stubs do not ground AI copy. How-to: [[conventions]].
+
+## Register
+- Speaker (founder / team / product) and audience:
+- Contractions, humour, emoji — allowed or never:
+- One idea per sentence. Hard word cap:
+
+## Words
+| Use | Avoid |
+|---|---|
+| (our word for the problem) | (the jargon it replaces) |
+
+Banned hedges: just, hope this finds you well, wanted to reach out, circling back, solution, leverage.
+
+## Worked examples
+- **We would send:** one real sentence of ours
+- **We would not send:** the same idea, wrong — and why it fails
+
+## Canonical
+Not pinned. Pinning it (\`oxygen knowledge page pin voice --approved\`) is a human-approved act — canonical voice grounds live copy. Claims are [[brand]]; what we do is [[positioning]].
+`;
+const BRAND_BODY = `# Brand
+
+> **Stub — fill me.** Seeded scaffolding. Replace with real, cited content, keep the wikilinks, then set \`status: active\`. No approval needed. Draft stubs do not ground AI copy. How-to: [[conventions]].
+
+## The promise (one line)
+What a buyer gets from us and cannot get from the alternative named in [[positioning]]:
+
+## Claims
+| We can substantiate | Proof (number, customer, doc) |
+|---|---|
+| 1 | |
+| 2 | |
+| 3 | |
+
+Cannot substantiate yet — never write these until the proof is real: 1. 2. 3.
+
+## The ask (CTA ladder)
+Smallest commitment first: reply → short call → pilot → paid. Never skip a rung on a first touch. Per-persona wording is [[messaging]]; what is actually sold is [[offers]].
+
+## Naming
+Exact spelling and capitalisation of the company, the product, and each feature; one word or two; what we never call ourselves or the category. How it all sounds is [[voice]].
+`;
+const MESSAGING_BODY = `# Messaging playbook
+
+> **Stub — fill me.** Seeded scaffolding. Replace with real, cited content, keep the wikilinks, then set \`status: active\`. No approval needed. Draft stubs do not ground AI copy. How-to: [[conventions]].
+
+Once active this page grounds outbound and reply drafts — every line here becomes copy a prospect reads.
+
+## Hooks by persona
+| Persona | Trigger (why now) | Opening line, in their words |
+|---|---|---|
+| (one row per page in [[personas]]) | | |
+
+## Proof points — numbers only
+| Claim | Number | Source |
+|---|---|---|
+
+No number, no claim. Pull them from closed deals and [[campaign-learnings]].
+
+## CTA ladder (soft to hard)
+One-word reply → send the teardown → fifteen minutes → pilot.
+
+## What we never say
+The banned hedges in [[voice]]; anything absent from the proof table in [[brand]]; a competitor smear — counter with [[positioning]].
+`;
+const OBJECTIONS_BODY = `# Objections
+
+> **Stub — fill me.** Seeded scaffolding. Replace with real, cited content, keep the wikilinks, then set \`status: active\`. No approval needed. Draft stubs do not ground AI copy. How-to: [[conventions]].
+
+## Handling
+| Objection | Really asking | Our answer | Proof | Walk when |
+|---|---|---|---|---|
+| Too expensive | Is the outcome worth it? | | | |
+| We use (rival) | What breaks if we switch? | see [[competitors]] | | |
+| Not now | Is there a trigger? | | | no trigger named twice |
+| Must ask someone | Who decides? | | | buyer absent twice |
+
+## Rules
+One rebuttal, then a question — never two. Answer price with the outcome in [[offers]], not a discount. Never claim more about a rival than [[competitors]] proves.
+
+## When to walk
+The hard-no list is [[icp]], the fit gate [[qualification]] — a stall matching one is a no, not a nurture. Feed the pattern to [[positioning]].
+`;
+const PLAYBOOK_OUTBOUND_BODY = `# Outbound playbook
+
+> **Stub — fill me.** Seeded scaffolding. Replace with real, cited content, keep the wikilinks, then set \`status: active\`. No approval needed. Draft stubs do not ground AI copy. How-to: [[conventions]].
+
+## Target and list
+- Slice of [[icp]] this motion works (narrower than all of it):
+- List source, and the filter that decides who is in:
+- Offer we lead with, from [[offers]]:
+
+## Cadence
+| Step | Day | Channel | Angle from [[messaging]] |
+|---|---|---|---|
+| 1 | 0 | | |
+| 2 | | | |
+
+Daily volume per sender:
+
+## Never enroll
+Customers, open opportunities, anyone touched in the last N days, opt-outs, competitors.
+
+## Is it working
+Reply rate, positive-reply rate, meetings per 1,000 sent — set a target for each. Outcomes land in [[campaign-learnings]].
+
+## Exits
+Positive reply → [[qualification]]. Silent at the last step → [[playbook-nurture]]. Hard no → suppress.
+`;
+const PLAYBOOK_NURTURE_BODY = `# Nurture playbook
+
+> **Stub — fill me.** Seeded scaffolding. Replace with real, cited content, keep the wikilinks, then set \`status: active\`. No approval needed. Draft stubs do not ground AI copy. How-to: [[conventions]].
+
+## Who enters the not-now pile
+- Not-now replies, stalled deals, no-shows, churned accounts, and still-fit [[icp]] leads who finished [[playbook-outbound]] silent.
+- Who never enters: a hard no, an opt-out, anyone out of ICP.
+
+## Cadence
+| Touch | Timing | What we send |
+|---|---|---|
+| 1 | | |
+| 2 | | |
+
+One touch per N weeks, no sequence pressure. Angles come from [[messaging]]; anything quoting an [[offers]] price must still be true when it lands.
+
+## Exit
+A reply or a live trigger → [[qualification]]. Two full cycles with zero engagement → drop them, and log why in [[campaign-learnings]].
+`;
+const PLAYBOOK_INBOUND_BODY = `# Inbound playbook
+
+> **Stub — fill me.** Seeded scaffolding. Replace with real, cited content, keep the wikilinks, then set \`status: active\`. No approval needed. Draft stubs do not ground AI copy. How-to: [[conventions]].
+
+## Sources
+| Source | Where it lands | Owner |
+|---|---|---|
+| Content / SEO | | |
+| LinkedIn engagement | | |
+| Product signups | | |
+| Referrals | | |
+
+## Response SLA
+Business hours, and off hours. Speed is the whole edge here — name the slowest reply we accept, then hold it.
+
+## First touch
+- Match the person to a page in [[personas]] and answer in their language ([[messaging]]). Never a generic template.
+- The one question worth asking first:
+
+## Routing
+Run [[qualification]] before booking anything. Self-serve signups go to their own path. Anyone outside [[icp]] gets the honest no, fast.
+`;
+const QUALIFICATION_BODY = `# Qualification
+
+> **Stub — fill me.** Seeded scaffolding. Replace with real, cited content, keep the wikilinks, then set \`status: active\`. No approval needed. Draft stubs do not ground AI copy. How-to: [[conventions]].
+
+## Five discovery questions
+Each one surfaces a pain, its cost, or the buying process — never a feature preference.
+1.
+2.
+3.
+4.
+5.
+
+## Must be true to advance
+- A named pain one of our [[offers]] actually removes:
+- Someone in the room who can spend:
+- A date they want it working by:
+
+## Disqualifiers
+The hard-no list is [[icp]] — do not copy it here. Add only what shows up on a call and ICP cannot see: no budget owner, no timeline, or a blocker we cannot move (see [[objections]]).
+
+## What counts as a next step
+A booked meeting with a named person and a date on it. Not "send me info", not "circle back in Q3".
+`;
+const PERSONAS_BODY = `# Personas (map of content)
+
+> **Stub — fill me.** Seeded scaffolding. Replace with real, cited content, keep the wikilinks, then set \`status: active\`. No approval needed. Draft stubs do not ground AI copy. How-to: [[conventions]].
+
+## Roster
+| Persona | Job to be done | Pain that costs them money | Trigger to buy now | Where they spend time |
+|---|---|---|---|---|
+| | | | | |
+
+Create one page per buyer as type \`persona\` — slugs like \`persona-vp-sales\`, \`persona-founder\` — and link it in the first column. Cover the economic buyer, the champion, and whoever blocks the deal.
+
+## Rules
+- Split a persona only when the pain or the trigger differs. Same pain, different title is one persona.
+- Quote their words verbatim; those quotes become the hooks in [[messaging]].
+- What they push back on belongs in [[objections]], not here.
+
+Personas sit inside the account-level fit defined in [[icp]].
+`;
+const CUSTOMERS_BODY = `# Customers (map of content)
+
+> **Stub — fill me.** Seeded scaffolding. Replace with real, cited content, keep the wikilinks, then set \`status: active\`. No approval needed. Draft stubs do not ground AI copy. How-to: [[conventions]].
+
+## Roster
+| Customer | Offer bought | Why they bought | Outcome number | Referenceable? |
+|---|---|---|---|---|
+| | | | | |
+
+Create one page per customer as type \`entity\`, slugged with the company name, and wikilink it in the first column. Keep it to the deal story: what broke before, what they compared us to, what changed after.
+
+## Scope
+Live account state — plan, seats, renewal, open tickets — is cheaper to re-fetch than to mirror, so it stays out (the density bar in [[conventions]]). This page holds only the durable narrative no query can rebuild.
+
+Patterns here sharpen [[icp]], prove [[offers]], and supply the proof lines in [[messaging]].
+`;
+const RESEARCH_BODY = `# Research (map of content)
+
+> **Stub — fill me.** Seeded scaffolding. Replace with real, cited content, keep the wikilinks, then set \`status: active\`. No approval needed. Draft stubs do not ground AI copy. How-to: [[conventions]].
+
+## What lands here
+Dated investigations as type \`research_note\`, slugged \`research-2026-03-pricing\`. Link each below, newest first. Agent-derived notes land here too, tagged \`agent-derived\` until verified.
+
+Hub vs. note: a hub like [[icp]] or [[competitors]] holds the standing answer and is rewritten. A note is dated evidence, never rewritten — when it moves that answer, edit the hub and cite the note.
+
+## Note template
+- **Question** — the one thing this note answers
+- **Method** — what was searched, asked, or measured, over how many
+- **Findings** — each with the URL or call it came from
+- **What would change our mind** — evidence that would invalidate it
+`;
+const METRICS_BODY = `# Metrics
+
+> **Stub — fill me.** Seeded scaffolding. Replace with real, cited content, keep the wikilinks, then set \`status: active\`. No approval needed. Draft stubs do not ground AI copy. How-to: [[conventions]].
+
+## The five numbers we steer by
+| Metric | How we define it exactly | Current target | Where the live number lives |
+|---|---|---|---|
+| | | | |
+
+Five, not fifteen. A number that would not change a decision this quarter is not one of them.
+
+## Do not paste live values here
+This page holds definitions and targets — argued over once, then reused. The values live in Dashboards, which are always current; a pasted number is stale the next day, and the density bar in [[conventions]] rules out mirroring anything cheaper to re-fetch.
+
+Moving a target is a call: record it in [[decisions]] with its reversal condition. Why it moved is evidence: that goes to [[campaign-learnings]].
+`;
 /**
- * The 9-page starter pack. Two active nav pages first (start-here + the conventions schema
- * page), then the seven draft stub hubs (tag `seed`). `positioning` seeds as a NON-canonical
- * draft so it writes freely — pinning canonical positioning stays a separate human-approved
- * act. All at minScaffoldVersion 1 (the first wave).
+ * The 21-page starter pack. Two active nav pages first (start-here + the conventions
+ * schema page), then nineteen draft stub hubs (tag `seed`) — seven from wave 1 and
+ * twelve from wave 2. `positioning` seeds as a NON-canonical draft so it writes freely;
+ * pinning canonical positioning stays a separate human-approved act. Wave 2 adds ZERO
+ * active pages, per the binding rule at the top of this file.
  */
 export const KNOWLEDGE_SEED_PAGES = [
     {
@@ -237,6 +508,7 @@ export const KNOWLEDGE_SEED_PAGES = [
         summary: "Stub: the ideal customer profile — firmographics, triggers, and disqualifiers that define who we sell to. Fill with cited content and set active.",
         body: ICP_BODY,
         minScaffoldVersion: 1,
+        researchable: true,
     },
     {
         slug: "positioning",
@@ -247,6 +519,7 @@ export const KNOWLEDGE_SEED_PAGES = [
         summary: "Stub (non-canonical): how we describe ourselves against alternatives — for whom, the core value, and proof. Pinning the canonical positioning is a separate human-approved act.",
         body: POSITIONING_BODY,
         minScaffoldVersion: 1,
+        researchable: true,
     },
     {
         slug: "offers",
@@ -257,6 +530,7 @@ export const KNOWLEDGE_SEED_PAGES = [
         summary: "Stub: what we sell — packages, pricing, and the qualifying criteria per offer. Fill with cited content and set active.",
         body: OFFERS_BODY,
         minScaffoldVersion: 1,
+        researchable: true,
     },
     {
         slug: "competitors",
@@ -264,9 +538,10 @@ export const KNOWLEDGE_SEED_PAGES = [
         title: "Competitors (map of content)",
         status: "draft",
         tags: ["seed", "moc", "competitors"],
-        summary: "Stub map-of-content: index of competitor teardown pages. Create one [[competitor-<name>]] page each; this hub links them and summarizes our overall competitive stance.",
+        summary: "Stub map-of-content: index of competitor teardown pages. Create one competitor-<name> page each; this hub links them and summarizes our overall competitive stance.",
         body: COMPETITORS_BODY,
         minScaffoldVersion: 1,
+        researchable: true,
     },
     {
         slug: "playbooks",
@@ -274,7 +549,7 @@ export const KNOWLEDGE_SEED_PAGES = [
         title: "Playbooks (map of content)",
         status: "draft",
         tags: ["seed", "moc", "playbooks"],
-        summary: "Stub map-of-content: index of how-we-run-it playbooks (outbound, nurture, demo, expansion). Create one playbook page per motion and link it here.",
+        summary: "Stub map-of-content: index of how-we-run-it playbooks (outbound, inbound, nurture, demo, expansion). Create one playbook page per motion and link it here.",
         body: PLAYBOOKS_BODY,
         minScaffoldVersion: 1,
     },
@@ -298,4 +573,138 @@ export const KNOWLEDGE_SEED_PAGES = [
         body: DECISIONS_BODY,
         minScaffoldVersion: 1,
     },
+    {
+        slug: "voice",
+        type: "voice",
+        title: "Voice",
+        status: "draft",
+        tags: ["seed", "voice", "copy"],
+        summary: "Stub (non-canonical): how the workspace sounds — register and audience, the one-idea-per-sentence rule, words to use and avoid, banned hedges, and a would-send / would-not-send example pair. Fill it and set active; pinning the canonical voice is a separate human-approved act.",
+        body: VOICE_BODY,
+        minScaffoldVersion: 2,
+        researchable: true,
+    },
+    {
+        slug: "brand",
+        type: "brand",
+        title: "Brand",
+        status: "draft",
+        tags: ["seed", "brand", "copy"],
+        summary: "Stub (non-canonical): the promise in one line, the three claims we can substantiate with proof and the ones we cannot, the CTA ladder from reply to paid, and naming rules. Fill it and set active; pinning canonical brand copy stays human-approved.",
+        body: BRAND_BODY,
+        minScaffoldVersion: 2,
+        researchable: true,
+    },
+    {
+        slug: "messaging",
+        type: "message_playbook",
+        title: "Messaging playbook",
+        status: "draft",
+        tags: ["seed", "messaging", "copy"],
+        summary: "Stub: the message playbook — hooks and triggers per persona, proof points that must carry a number, the soft-to-hard CTA ladder, and what we never say. Once filled and set active it grounds outbound and reply drafts, so every claim needs its number and source.",
+        body: MESSAGING_BODY,
+        minScaffoldVersion: 2,
+        researchable: true,
+    },
+    {
+        slug: "objections",
+        type: "message_playbook",
+        title: "Objections",
+        status: "draft",
+        tags: ["seed", "objections", "sales"],
+        summary: "Stub: objection handling — a table of the objection, what the buyer is really asking, our answer, the proof behind it, and the point where we walk. Fill it and set active; it then grounds call prep and reply drafts.",
+        body: OBJECTIONS_BODY,
+        minScaffoldVersion: 2,
+    },
+    {
+        slug: "playbook-outbound",
+        type: "playbook",
+        title: "Outbound playbook",
+        status: "draft",
+        tags: ["seed", "playbook", "outbound"],
+        summary: "Stub: the cold outbound motion — which slice of the ICP it works, where the list comes from, channel/cadence and daily volume per sender, the never-enroll suppression list, the three numbers that say it is working, and where a reply exits to. Fill with real cadence and targets, then set active.",
+        body: PLAYBOOK_OUTBOUND_BODY,
+        minScaffoldVersion: 2,
+    },
+    {
+        slug: "playbook-inbound",
+        type: "playbook",
+        title: "Inbound playbook",
+        status: "draft",
+        tags: ["seed", "playbook", "inbound"],
+        summary: "Stub: the inbound motion — the sources (content/SEO, LinkedIn engagement, product signups, referrals) and where each lands, the response SLA in and out of business hours, a persona-matched first touch, and how a lead is routed, self-served, or refused. Fill and set active.",
+        body: PLAYBOOK_INBOUND_BODY,
+        minScaffoldVersion: 2,
+    },
+    {
+        slug: "playbook-nurture",
+        type: "playbook",
+        title: "Nurture playbook",
+        status: "draft",
+        tags: ["seed", "playbook", "nurture"],
+        summary: "Stub: the not-now motion — who enters the pile (not-now replies, stalled deals, no-shows, churned accounts, silent outbound finishers), who never does, the low-pressure touch cadence and what each touch sends, and the exit back to qualification or out. Fill and set active.",
+        body: PLAYBOOK_NURTURE_BODY,
+        minScaffoldVersion: 2,
+    },
+    {
+        slug: "qualification",
+        type: "playbook",
+        title: "Qualification",
+        status: "draft",
+        tags: ["seed", "sales", "qualification"],
+        summary: "Stub: the discovery and fit gate — five discovery questions, the must-be-true criteria to advance, sales-stage disqualifiers only (the hard-no list stays in the ICP page and is never copied here), and what actually counts as a next step. Fill and set active.",
+        body: QUALIFICATION_BODY,
+        minScaffoldVersion: 2,
+    },
+    {
+        slug: "personas",
+        type: "topic",
+        title: "Personas (map of content)",
+        status: "draft",
+        tags: ["seed", "moc", "personas"],
+        summary: "Stub map-of-content: the buyer roster — one row per persona covering job to be done, the pain that costs them money, the buy-now trigger, and where they spend time. Create one persona-typed page per buyer (persona-vp-sales, persona-founder) and link it here. This is the hub the ICP and start-here pages point at.",
+        body: PERSONAS_BODY,
+        minScaffoldVersion: 2,
+    },
+    {
+        slug: "customers",
+        type: "topic",
+        title: "Customers (map of content)",
+        status: "draft",
+        tags: ["seed", "moc", "customers"],
+        summary: "Stub map-of-content: the customer roster — offer bought, why they bought in their own words, the outcome number, and whether they are referenceable. Create one entity-typed page per customer and link it here; live account state (plan, seats, renewal, tickets) stays out, per the density bar.",
+        body: CUSTOMERS_BODY,
+        minScaffoldVersion: 2,
+        researchable: true,
+    },
+    {
+        slug: "research",
+        type: "topic",
+        title: "Research (map of content)",
+        status: "draft",
+        tags: ["seed", "moc", "research"],
+        summary: "Stub map-of-content for dated research_note pages: what belongs in a note versus a standing-answer hub, the note template (question, method, findings with URLs, what would change our mind), and the rule that agent-derived notes land here tagged agent-derived until a human verifies them.",
+        body: RESEARCH_BODY,
+        minScaffoldVersion: 2,
+    },
+    {
+        slug: "metrics",
+        type: "topic",
+        title: "Metrics",
+        status: "draft",
+        tags: ["seed", "moc", "metrics"],
+        summary: "Stub: the five numbers we steer by — metric, exact definition, current target, and where the live number actually lives. Definitions and targets only; live values belong in Dashboards, per the density bar in conventions. Moving a target is a decision; why it moved is a campaign learning.",
+        body: METRICS_BODY,
+        minScaffoldVersion: 2,
+    },
 ];
+/**
+ * Seed slugs a domain-grounded research pass could genuinely draft from the company's
+ * PUBLIC web presence — what they sell, who they say they sell to, how they sound, who
+ * bought. Derived from the manifest's `researchable` flag (never a second hand-kept list),
+ * and consumed by `oxygen knowledge lint`'s researchable check, which reports the ones
+ * still sitting unfilled at revision 1 on a workspace that has a company domain.
+ */
+export const KNOWLEDGE_RESEARCHABLE_SEED_SLUGS = KNOWLEDGE_SEED_PAGES
+    .filter((page) => page.researchable === true)
+    .map((page) => page.slug);

package/node_modules/@oxygen/shared/dist/sending-seats.d.ts

@@ -96,12 +96,35 @@ export declare const SENDING_SEAT_GATE_ENABLED_ENV_VAR = "OXYGEN_SENDING_SEAT_GA
 /**
  * Which seat kind a connect request consumes, by CLI path prefix.
  *
- * MAILBOXES ARE DELIBERATELY ABSENT. Email mailboxes live in the TENANT
- * database, so the control-plane grandfathering backfill cannot see them and did
- * not cover them. Enforcing a seat on mailbox connect today would refuse
- * customers who already have mailboxes attached — the precise failure this whole
- * grandfathering design exists to prevent. Add mailboxes here only once a
- * tenant-aware backfill has granted their legacy entitlements.
+ * ALL FOUR CHANNELS are mapped. Mailboxes were held back while grandfathering
+ * was backfill-only, because the backfill runs in the control plane and mailboxes
+ * live in each tenant's own database — gating them then would have refused
+ * customers who already had mailboxes attached. They are safe to include now
+ * that the gate grandfathers an organization's existing senders on FIRST CONTACT
+ * (see ensureLegacyEntitlementOnFirstContact), which needs no cross-tenant sweep
+ * and cannot miss a tenant.
  */
-export declare const SEAT_KIND_BY_CONNECT_PREFIX: ReadonlyArray<readonly [prefix: string, seatKey: SendingSeatKey]>;
-export declare function seatKindForConnectPath(pathname: string): SendingSeatKey | null;
+export type SeatConnectRoute = {
+    readonly path: string;
+    readonly seatKey: SendingSeatKey;
+    /**
+     * `prefix` also matches sub-paths, for flows that continue under the same
+     * route (an OAuth callback). `exact` matches only the route itself.
+     *
+     * The distinction is load-bearing. `/api/cli/voice/numbers` buys a number, but
+     * `/api/cli/voice/numbers/<id>` and `/<id>/tags` manage an EXISTING one — and
+     * gating those would refuse a customer at capacity from RELEASING a number,
+     * which is the one action that frees capacity. Prefix-matching everything was
+     * the first version of this and it had exactly that bug.
+     */
+    readonly match: "exact" | "prefix";
+};
+export declare const SEAT_CONNECT_ROUTES: readonly SeatConnectRoute[];
+/**
+ * Which seat a request consumes, or null.
+ *
+ * METHOD MATTERS: only a request that CREATES a sender consumes capacity.
+ * `GET /api/cli/voice/numbers` lists what you already own and must never be
+ * refused for want of a seat.
+ */
+export declare function seatKindForConnect(pathname: string, method: string): SendingSeatKey | null;