weftens 0.1.1 → 0.1.3

package/src/registry.js

@@ -1,160 +1,163 @@
-// The Weftens agent registry — the single source of truth for which agents exist and
-// how a request finds one.
-//
-// Routing is deterministic and explainable (see agent-router.js): a request matches an
-// agent by its declared routeHints, and you can always see which hints matched. No
-// model call is needed to route — the model only runs when an agent is invoked to
-// produce, so the routing layer is verifiable with no API key.
-//
-// Fields:
-//   tier      1 = lead that owns sub-agents (richy, pio, content); 2 = leaf. invoke()
-//             branches on this.
-//   core      path to a deterministic agent-cores package, or absent.
-//   coreBin,  how to shell that core's CLI (it does parse+analyze+format). Present only
-//   coreInputFlag  where wired; absent -> invoke reports the core isn't wired yet.
-//   leads     tier-1 content only: the pipeline it delegates to.
-//   wire      tier-1 richy/pio only: they answer through the existing orchestrator, not here.
-//   ownedBy   content-team seats owned by the Content lead — not dispatched by the door.
-//   seatFile  the .md seat used as the system prompt when a seat produces via the model.
-//   routeHints keyword/phrase signals for the router.
-//
-// Note: seo-technical+seo-content and amazon-ppc+paid-search map to single real job
-// postings, so they are merge candidates — but the merge is deferred until the roster
-// actually needs consolidating. Merging early only adds structure nothing reads yet.
-
-// One home: the agent seats live in this repo (weftens/agents). Override with
-// WEFTENS_AGENTS_DIR. No external directory and no fallback — one canonical location.
-import { join, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const AGENTS_DIR = process.env.WEFTENS_AGENTS_DIR || join(dirname(fileURLToPath(import.meta.url)), "..", "agents");
-const seat = (name) => join(AGENTS_DIR, `${name}.md`);
-
-export const REGISTRY = [
-  // ---- Tier 1: lead agents (own sub-agents / their own engines) ----
-  {
-    name: "richy", tier: 1, team: "weftens", wire: "representationCheck", seatFile: seat("richy"),
-    routeHints: ["represent", "representation", "reputation", "online", "website", "site",
-      "review", "listing", "search", "seo", "visibility", "audit", "appear",
-      "how do we look", "what do people see", "brand", "knowledge panel", "ai answer"],
-  },
-  {
-    name: "pio", tier: 1, team: "weftens", wire: "operationsSummary", seatFile: seat("pio"),
-    routeHints: ["event", "attendee", "participant", "check-in", "checkin", "roster",
-      "grant", "funding", "funder", "program", "people", "follow-up", "followup", "donor",
-      "prospect", "attendance", "registration", "operation", "who should i meet", "dossier",
-      // Bare "people" is too generic to dispatch on (it's a weak hint), but these PHRASES are
-      // unambiguous asks that a customer actually types. Without them, "we need people ops"
-      // matched only the weak "people" and fell through to no-route.
-      "people ops", "people operations", "ops help", "back office", "development ops",
-      "who funds", "funding pipeline", "grant research", "prospect research"],
-  },
-  {
-    name: "content", tier: 1, team: "content", leads: "content-org", seatFile: null,
-    routeHints: ["make content", "content", "script", "reel", "video", "caption", "post",
-      "series", "episode", "produce", "storyboard", "shot list"],
-  },
-
-  // ---- Tier 2: marketing/SEO leaves with deterministic agent-cores ----
-  {
-    name: "seo-technical", tier: 2, team: "seo", core: "agent-cores/seo-technical", seatFile: seat("seo-technical"),
-    routeHints: ["crawl", "index", "indexing", "render", "schema", "structured data",
-      "robots", "sitemap", "canonical", "core web vitals", "technical seo", "rich result"],
-  },
-  {
-    name: "seo-content", tier: 2, team: "seo", core: "agent-cores/seo-content", seatFile: seat("seo-content"),
-    routeHints: ["keyword", "topic", "entity", "content strategy", "brief",
-      "serp", "rankings", "answer surface", "citation", "gsc", "search console"],
-  },
-  {
-    // paid-search is the one core whose CLI takes a flag (--search-terms <csv>) rather
-    // than a positional file, so it overrides the positional default in invoke.
-    name: "paid-search", tier: 2, team: "marketing", core: "agent-cores/paid-search",
-    coreInputFlag: "--search-terms", seatFile: seat("paid-search"),
-    routeHints: ["google ads", "paid search", "ppc", "search terms", "negatives",
-      "bid", "budget", "impression share", "quality score", "change sheet"],
-  },
-  {
-    name: "amazon-ppc", tier: 2, team: "marketing", core: "agent-cores/amazon-ppc", seatFile: seat("amazon-ppc"),
-    routeHints: ["amazon", "amazon ads", "sponsored products", "acos", "tacos",
-      "harvest", "negate", "amazon search term", "sponsored brand"],
-  },
-  {
-    name: "meta-ads", tier: 2, team: "marketing", core: "agent-cores/meta-ads", seatFile: seat("meta-ads"),
-    routeHints: ["meta", "facebook", "instagram", "meta ads", "facebook ads", "instagram ads",
-      "ad set", "adset", "creative fatigue", "frequency", "roas", "ads manager"],
-  },
-  {
-    name: "supply-verify", tier: 2, team: "marketing", core: "agent-cores/supply-verify", seatFile: seat("supply-verify"),
-    routeHints: ["placement", "mfa", "made for advertising", "ivt", "invalid traffic",
-      "supply path", "log-level", "programmatic", "ad spend waste", "exclusion"],
-  },
-  {
-    name: "content-ops", tier: 2, team: "content", core: "agent-cores/content-ops", seatFile: seat("content-ops"),
-    routeHints: ["content inventory", "cms export", "keep update retire", "migration",
-      "content audit", "tagging", "metadata cleanup", "template conform"],
-  },
-
-  // ---- Tier 2: marketing/PR leaves (no deterministic core — model-only) ----
-  {
-    name: "social-voice", tier: 2, team: "marketing", seatFile: seat("social-voice"),
-    routeHints: ["social", "instagram", "tiktok", "linkedin", "reply", "engagement",
-      "calendar", "per-platform", "voice-locked", "community management"],
-  },
-  {
-    name: "claims-content", tier: 2, team: "content", seatFile: seat("claims-content"),
-    routeHints: ["health", "pharma", "finance", "supplement", "regulated", "claim",
-      "medical review", "legal review", "compliance", "substantiation"],
-  },
-  {
-    name: "growth-marketing", tier: 2, team: "marketing", seatFile: seat("growth-marketing"),
-    // "cro"/"funnel"/"activation" are the words a practitioner uses; the words a CUSTOMER
-    // uses for the same problem are "converts badly", "signups", "checkout". Without those
-    // the seat was unreachable by anyone describing their own problem in their own words.
-    routeHints: ["growth", "acquisition", "channel", "funnel", "cro", "lifecycle",
-      "campaign design", "experiment", "retention", "activation",
-      "convert", "converts", "conversion", "converting", "signup", "sign-up",
-      "checkout", "landing page", "drop off", "drop-off", "abandon", "onboarding"],
-  },
-  {
-    name: "security-writer", tier: 2, team: "security", seatFile: seat("security-writer"),
-    routeHints: ["security content", "technical writing", "security explainer",
-      "threat", "vulnerability writeup", "security training", "devsecops doc"],
-  },
-
-  // ---- Tier 2: evaluation leaves (agents whose job is judgment — normal pool) ----
-  {
-    name: "hilbert", tier: 2, team: "eval", seatFile: seat("hilbert"),
-    routeHints: ["headline", "tagline", "name", "slogan", "will this survive",
-      "memetic", "does this stop someone", "positioning line", "pitch line", "repeated"],
-  },
-  {
-    name: "lippmann", tier: 2, team: "eval", seatFile: seat("lippmann"),
-    routeHints: ["perception", "what do people believe", "public sources", "reputation read",
-      "how is x seen", "sentiment", "frame provenance", "before committing"],
-  },
-  {
-    name: "agent2060", tier: 2, team: "eval", seatFile: seat("agent2060"),
-    routeHints: ["foresight", "future", "durable", "will this last", "trend", "horizon",
-      "bet", "does this survive", "strategic call", "category"],
-  },
-
-  // ---- Tier 2: content-team seats, owned by the Content lead (not dispatched by the door) ----
-  ...["content-strategy", "ideator", "researcher", "writer", "script-editor",
-    "showrunner", "video-editor", "feed-optimizer", "disclosure-qc", "growth-analyst"]
-    .map((name) => ({
-      name, tier: 2, team: "content", seatFile: seat(name), ownedBy: "content",
-      routeHints: [name.replace(/-/g, " ")],
-    })),
-];
-
-export function agentByName(name) {
-  const key = String(name).toLowerCase().trim();
-  return REGISTRY.find((a) => a.name === key) ?? null;
-}
-
-// Agents the front door auto-dispatches over — everything except the content-team
-// seats the Content lead owns (the door routes to `content`, which owns those).
-export function dispatchableAgents() {
-  return REGISTRY.filter((a) => !a.ownedBy);
-}
+// The Weftens agent registry — the single source of truth for which agents exist and
+// how a request finds one.
+//
+// Routing is deterministic and explainable (see agent-router.js): a request matches an
+// agent by its declared routeHints, and you can always see which hints matched. No
+// model call is needed to route — the model only runs when an agent is invoked to
+// produce, so the routing layer is verifiable with no API key.
+//
+// Fields:
+//   tier      1 = lead that owns sub-agents (richy, pio, content); 2 = leaf. invoke()
+//             branches on this.
+//   core      path to a deterministic agent-cores package, or absent.
+//   coreBin,  how to shell that core's CLI (it does parse+analyze+format). Present only
+//   coreInputFlag  where wired; absent -> invoke reports the core isn't wired yet.
+//   leads     tier-1 content only: the pipeline it delegates to.
+//   wire      tier-1 richy/pio only: they answer through the existing orchestrator, not here.
+//   ownedBy   content-team seats owned by the Content lead — not dispatched by the door.
+//   seatFile  the .md seat used as the system prompt when a seat produces via the model.
+//   routeHints keyword/phrase signals for the router.
+//
+// Note: seo-technical+seo-content and amazon-ppc+paid-search map to single real job
+// postings, so they are merge candidates — but the merge is deferred until the roster
+// actually needs consolidating. Merging early only adds structure nothing reads yet.
+
+// One home: the agent seats live in this repo (weftens/agents). Override with
+// WEFTENS_AGENTS_DIR. No external directory and no fallback — one canonical location.
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const AGENTS_DIR = process.env.WEFTENS_AGENTS_DIR || join(dirname(fileURLToPath(import.meta.url)), "..", "agents");
+const seat = (name) => join(AGENTS_DIR, `${name}.md`);
+
+export const REGISTRY = [
+  // ---- Tier 1: lead agents (own sub-agents / their own engines) ----
+  {
+    name: "richy", tier: 1, team: "weftens", wire: "representationCheck", seatFile: seat("richy"),
+    routeHints: ["represent", "representation", "reputation", "online", "website", "site",
+      "review", "listing", "search", "seo", "visibility", "audit", "appear",
+      "how do we look", "what do people see", "brand", "knowledge panel", "ai answer"],
+  },
+  {
+    name: "pio", tier: 1, team: "weftens", wire: "operationsSummary", seatFile: seat("pio"),
+    routeHints: ["event", "attendee", "participant", "check-in", "checkin", "roster",
+      "grant", "funding", "funder", "program", "people", "follow-up", "followup", "donor",
+      "prospect", "attendance", "registration", "operation", "who should i meet", "dossier",
+      // Bare "people" is too generic to dispatch on (it's a weak hint), but these PHRASES are
+      // unambiguous asks that a customer actually types. Without them, "we need people ops"
+      // matched only the weak "people" and fell through to no-route.
+      "people ops", "people operations", "ops help", "back office", "development ops",
+      "who funds", "funding pipeline", "grant research", "prospect research"],
+  },
+  {
+    name: "content", tier: 1, team: "content", leads: "content-org", seatFile: null,
+    routeHints: ["make content", "content", "script", "reel", "video", "caption", "post",
+      "series", "episode", "produce", "storyboard", "shot list"],
+  },
+
+  // ---- Tier 2: marketing/SEO leaves with deterministic agent-cores ----
+  {
+    name: "seo-technical", tier: 2, team: "seo", core: "agent-cores/seo-technical", seatFile: seat("seo-technical"),
+    routeHints: ["crawl", "index", "indexing", "render", "schema", "structured data",
+      "robots", "sitemap", "canonical", "core web vitals", "technical seo", "rich result"],
+  },
+  {
+    name: "seo-content", tier: 2, team: "seo", core: "agent-cores/seo-content", seatFile: seat("seo-content"),
+    routeHints: ["keyword", "topic", "entity", "content strategy", "brief",
+      "serp", "rankings", "answer surface", "citation", "gsc", "search console"],
+  },
+  {
+    // paid-search is the one core whose CLI takes a flag (--search-terms <csv>) rather
+    // than a positional file, so it overrides the positional default in invoke.
+    name: "paid-search", tier: 2, team: "marketing", core: "agent-cores/paid-search",
+    coreInputFlag: "--search-terms", seatFile: seat("paid-search"),
+    routeHints: ["google ads", "paid search", "ppc", "search terms", "negatives",
+      "bid", "budget", "impression share", "quality score", "change sheet"],
+  },
+  {
+    name: "amazon-ppc", tier: 2, team: "marketing", core: "agent-cores/amazon-ppc", seatFile: seat("amazon-ppc"),
+    routeHints: ["amazon", "amazon ads", "sponsored products", "acos", "tacos",
+      "harvest", "negate", "amazon search term", "sponsored brand"],
+  },
+  {
+    name: "meta-ads", tier: 2, team: "marketing", core: "agent-cores/meta-ads", seatFile: seat("meta-ads"),
+    // No bare "instagram": the platform name is not an intent, and social-voice (organic)
+    // wants the same word. A permanent tie routes by scoring accident, so both sides carry
+    // the phrase that says which job is being asked for.
+    routeHints: ["meta", "facebook", "meta ads", "facebook ads", "instagram ads",
+      "ad set", "adset", "creative fatigue", "frequency", "roas", "ads manager"],
+  },
+  {
+    name: "supply-verify", tier: 2, team: "marketing", core: "agent-cores/supply-verify", seatFile: seat("supply-verify"),
+    routeHints: ["placement", "mfa", "made for advertising", "ivt", "invalid traffic",
+      "supply path", "log-level", "programmatic", "ad spend waste", "exclusion"],
+  },
+  {
+    name: "content-ops", tier: 2, team: "content", core: "agent-cores/content-ops", seatFile: seat("content-ops"),
+    routeHints: ["content inventory", "cms export", "keep update retire", "migration",
+      "content audit", "tagging", "metadata cleanup", "template conform"],
+  },
+
+  // ---- Tier 2: marketing/PR leaves (no deterministic core — model-only) ----
+  {
+    name: "social-voice", tier: 2, team: "marketing", seatFile: seat("social-voice"),
+    routeHints: ["social", "instagram post", "post on instagram", "tiktok", "linkedin", "reply", "engagement",
+      "calendar", "per-platform", "voice-locked", "community management"],
+  },
+  {
+    name: "claims-content", tier: 2, team: "content", seatFile: seat("claims-content"),
+    routeHints: ["health", "pharma", "finance", "supplement", "regulated", "claim",
+      "medical review", "legal review", "compliance", "substantiation"],
+  },
+  {
+    name: "growth-marketing", tier: 2, team: "marketing", seatFile: seat("growth-marketing"),
+    // "cro"/"funnel"/"activation" are the words a practitioner uses; the words a CUSTOMER
+    // uses for the same problem are "converts badly", "signups", "checkout". Without those
+    // the seat was unreachable by anyone describing their own problem in their own words.
+    routeHints: ["growth", "acquisition", "channel", "funnel", "cro", "lifecycle",
+      "campaign design", "experiment", "retention", "activation",
+      "convert", "converts", "conversion", "converting", "signup", "sign-up",
+      "checkout", "landing page", "drop off", "drop-off", "abandon", "onboarding"],
+  },
+  {
+    name: "security-writer", tier: 2, team: "security", seatFile: seat("security-writer"),
+    routeHints: ["security content", "technical writing", "security explainer",
+      "threat", "vulnerability writeup", "security training", "devsecops doc"],
+  },
+
+  // ---- Tier 2: evaluation leaves (agents whose job is judgment — normal pool) ----
+  {
+    name: "hilbert", tier: 2, team: "eval", seatFile: seat("hilbert"),
+    routeHints: ["headline", "tagline", "name", "slogan", "will this survive",
+      "memetic", "does this stop someone", "positioning line", "pitch line", "repeated"],
+  },
+  {
+    name: "lippmann", tier: 2, team: "eval", seatFile: seat("lippmann"),
+    routeHints: ["perception", "what do people believe", "public sources", "reputation read",
+      "how is x seen", "sentiment", "frame provenance", "before committing"],
+  },
+  {
+    name: "agent2060", tier: 2, team: "eval", seatFile: seat("agent2060"),
+    routeHints: ["foresight", "future", "durable", "will this last", "trend", "horizon",
+      "bet", "does this survive", "strategic call", "category"],
+  },
+
+  // ---- Tier 2: content-team seats, owned by the Content lead (not dispatched by the door) ----
+  ...["content-strategy", "ideator", "researcher", "writer", "script-editor",
+    "showrunner", "video-editor", "feed-optimizer", "disclosure-qc", "growth-analyst"]
+    .map((name) => ({
+      name, tier: 2, team: "content", seatFile: seat(name), ownedBy: "content",
+      routeHints: [name.replace(/-/g, " ")],
+    })),
+];
+
+export function agentByName(name) {
+  const key = String(name).toLowerCase().trim();
+  return REGISTRY.find((a) => a.name === key) ?? null;
+}
+
+// Agents the front door auto-dispatches over — everything except the content-team
+// seats the Content lead owns (the door routes to `content`, which owns those).
+export function dispatchableAgents() {
+  return REGISTRY.filter((a) => !a.ownedBy);
+}

package/src/specialists.js

@@ -0,0 +1,50 @@
+// Building the specialist clients (Richy, PIO) from the environment.
+//
+// This lived in bin/weftens.js, which meant the CLI could reach live specialist services
+// and the SDK could not — the same call did different things depending on which door you
+// came through. It belongs in src/ so both surfaces share one implementation.
+//
+// A specialist is live only when its FULL env group is set. A partial group is a hard
+// error, not a silent fixture fallback: an operator who typo'd one variable would
+// otherwise get sample data while believing they were looking at their own organization.
+
+import { RichyClient, FixtureRichyClient } from "./richy-client.js";
+import { PioClient, FixturePioClient } from "./pio-client.js";
+
+function envGroup(label, names, env) {
+  const set = names.filter((n) => env[n]);
+  if (set.length === 0) return null;
+  if (set.length < names.length) {
+    const missing = names.filter((n) => !env[n]).join(", ");
+    throw new Error(
+      `${label} is partially configured — set ${missing} (or unset ${set.join(", ")} to run with sample data)`
+    );
+  }
+  return Object.fromEntries(names.map((n) => [n, env[n]]));
+}
+
+/**
+ * @param opts { env?, onFixture? } — onFixture is called with the names of the specialists
+ *             falling back to sample data, so a CLI can warn on stderr and a library can stay quiet.
+ * @returns { richy, pio } clients — real when configured, clearly-flagged fixtures otherwise.
+ */
+export function buildSpecialistClients({ env = process.env, onFixture } = {}) {
+  const richyEnv = envGroup("Richy", ["WEFTENS_RICHY_URL", "WEFTENS_RICHY_KEY"], env);
+  const pioEnv = envGroup("PIO", ["WEFTENS_PIO_URL", "WEFTENS_PIO_MEMBER", "WEFTENS_PIO_PASSWORD"], env);
+
+  const richy = richyEnv
+    ? new RichyClient({ baseUrl: richyEnv.WEFTENS_RICHY_URL, key: richyEnv.WEFTENS_RICHY_KEY })
+    : new FixtureRichyClient();
+  const pio = pioEnv
+    ? new PioClient({
+        baseUrl: pioEnv.WEFTENS_PIO_URL,
+        member: pioEnv.WEFTENS_PIO_MEMBER,
+        password: pioEnv.WEFTENS_PIO_PASSWORD,
+        tenant: env.WEFTENS_PIO_TENANT ?? null,
+      })
+    : new FixturePioClient();
+
+  const fixtures = [!richyEnv && "Richy", !pioEnv && "PIO"].filter(Boolean);
+  if (fixtures.length > 0 && typeof onFixture === "function") onFixture(fixtures);
+  return { richy, pio };
+}

package/content-org/.preflight/telemetry.jsonl

@@ -1,6 +0,0 @@
-{"ts":"2026-07-19T17:03:20.481Z","tool":"edit_file","source":"raw","status":"pass","counts":{"total":8,"pass":8,"warn":0,"fail":0},"topRules":[],"findings":[],"pathPreview":"C:\\Users\\teche\\weftens\\src\\registry.js","durationMs":3}
-{"ts":"2026-07-19T17:03:27.408Z","tool":"edit_file","source":"raw","status":"pass","counts":{"total":8,"pass":8,"warn":0,"fail":0},"topRules":[],"findings":[],"pathPreview":"C:\\Users\\teche\\weftens\\src\\invoke.js","durationMs":2}
-{"ts":"2026-07-19T17:03:35.845Z","tool":"edit_file","source":"raw","status":"pass","counts":{"total":8,"pass":8,"warn":0,"fail":0},"topRules":[],"findings":[],"pathPreview":"C:\\Users\\teche\\weftens\\src\\invoke.js","durationMs":2}
-{"ts":"2026-07-19T17:03:39.916Z","tool":"edit_file","source":"raw","status":"pass","counts":{"total":8,"pass":8,"warn":0,"fail":0},"topRules":[],"findings":[],"pathPreview":"C:\\Users\\teche\\weftens\\src\\invoke.js","durationMs":2}
-{"ts":"2026-07-19T17:03:56.374Z","tool":"write_file","source":"raw","status":"pass","counts":{"total":7,"pass":7,"warn":0,"fail":0},"topRules":[],"findings":[],"pathPreview":"C:\\Users\\teche\\weftens\\index.js","durationMs":2}
-{"ts":"2026-07-19T17:04:01.490Z","tool":"edit_file","source":"raw","status":"pass","counts":{"total":8,"pass":8,"warn":0,"fail":0},"topRules":[],"findings":[],"pathPreview":"C:\\Users\\teche\\weftens\\package.json","durationMs":2}

package/content-org/briefs/BRIEFS.md

@@ -1,47 +0,0 @@
-# Format briefs
-
-The five formats the org produces. Each is a **brief the seats consume** — angle patterns, structure,
-and the disclosure stance. `RISK` in `config.mjs` sets which auto-post vs hold. Audience across all:
-**older Facebook users**; brand voice: *declare what's real*; disclosure is a **per-piece call, never an
-always-rule**; the scam guardrail is **theatre** (instant reveal, captures nothing, no real person harmed).
-
----
-
-## traveler  · auto
-The recurring time-traveler character dropped into a different time+place each episode. **The moat** —
-people subscribe to a *who*, not a vibe. Needs character-consistent clips (Veo/Seedance hero lane).
-- **Hook (3s):** the character mid-scene in a vivid era ("It's Tokyo, 1985, and…").
-- **Structure:** cold open in-scene → one wistful observation that ties past to now → button line.
-- **Disclosure:** "Imagined with AI" when it fits; sometimes the era-craft *is* the point. Kayla's call.
-- **Continuity:** same face, voice, and one signature line across episodes.
-
-## scam-reveal  · hold
-Nostalgia/relatable hook → theatrical "attempted hack" → **"YOU COULD HAVE BEEN HACKED"** → one defensive tell.
-- **Hook (3s):** a familiar scenario (a text from "your bank," a too-good deal).
-- **Structure:** set the trap → the reveal beat → one concrete thing the viewer can do tomorrow.
-- **HARD LINE:** theatre only. Instant reveal, page/piece captures NOTHING, no real non-consenting person
-  is hacked or harmed. QC blocks anything that crosses this.
-- **Disclosure:** the reveal is the disclosure; label as AI where useful.
-
-## is-this-real  · hold
-Teach older viewers to spot AI fakes / deepfakes / cloned voices. **Most on-brand** — the content *is* the
-"declare what's real" demo.
-- **Hook (3s):** "Is this real? Watch closely." (a clip with one tell).
-- **Structure:** show the fake → reveal the tell(s) → "here's how to check next time."
-- **Disclosure:** always clarify what was AI vs real in-piece — here it's the whole point.
-- **QC:** claim accuracy is critical; never mislabel a real thing as fake or vice-versa.
-
-## nostalgia  · auto
-Straight "remember when" archival-feeling reach. Pure audience fuel; highest raw engagement with older FB.
-- **Hook (3s):** a specific sensory memory ("If you remember the sound of a rotary phone…").
-- **Structure:** montage of era details → one warm line of meaning → gentle prompt to comment.
-- **Disclosure:** label as AI-imagined where the footage is fabricated (Meta throttles undisclosed
-  fake-real-events — proactive labeling protects reach).
-- **Bulk lane** (Wan) is fine; no recurring face needed.
-
-## ai-for-seniors  · hold
-Calm, plain-language explainers ("what's an agent?", "is the AI listening to me?"). Empowerment, no fear.
-- **Hook (3s):** a real question they've wondered ("Is your phone spying on you? Sort of — here's the truth").
-- **Structure:** the worry → the plain answer → one practical takeaway.
-- **Disclosure:** AI-made, said plainly; builds the brand credibility the flywheel cashes in.
-- **QC:** no false/overblown claims about AI; accuracy is the whole value.

package/content-org/config.mjs

@@ -1,78 +0,0 @@
-// content-org — central config. Change tiers/models here; nothing else needs editing.
-
-export const MODELS = {
-  haiku: "claude-haiku-4-5",   // $1/$5 per 1M — routine seats
-  sonnet: "claude-sonnet-5",   // $3/$15 — writing-quality seats
-  opus: "claude-opus-4-8",     // $5/$25 — only if a real test shows a lift
-};
-
-// Value tier (locked 2026-07-08): pay for quality only where it moves reach/moat.
-// Sonnet on the seats whose prose the viewer feels (Strategy board, Script, Editor);
-// Haiku on the structured hand-offs the viewer never sees.
-export const SEAT_MODEL = {
-  showrunner: "haiku",
-  strategy: "sonnet",
-  ideator: "haiku",
-  research: "haiku",
-  script: "sonnet",
-  editor: "sonnet",
-  cut: "sonnet", // Video Editor — the cut decides completion rate; worth Sonnet
-  feed: "haiku",
-  qc: "haiku",
-  growth: "haiku", // Growth/Analyst — reads the deterministic metrics.mjs summary; structured hand-off, viewer never sees it
-};
-
-// Clip lanes — pick per piece. Prices are RANGES (sources disagree; price the exact
-// tier on fal.ai at commit). No flat-unlimited *automated* lane exists (verified 2026-07-08).
-export const CLIP_LANES = {
-  manual: { label: "manual flat sub", usdPerSec: 0, note: "hand-generate; ~$0 marginal; cheapest" },
-  bulk: { label: "Wan 2.6 (bulk B-roll)", usdPerSec: 0.06, audio: true },
-  hero: { label: "Veo 3.1 (hero / recurring face)", usdPerSec: 0.05, audio: true, note: "value king: audio + consistency" },
-  // Kling deliberately omitted from defaults — priciest, no consistency edge over Veo/Seedance.
-};
-
-// Approx token cost per finished piece by model mix (for cost.mjs). ~per-piece USD of the
-// 8 text-seat calls; Batch API halves it. Rough, tune against real usage.
-export const TEXT_COST_PER_PIECE = {
-  valueTier: 0.20, // Sonnet(strategy/script/editor) + Haiku(rest)
-  valueTierBatch: 0.10, // with Batch API (50% off)
-  allHaiku: 0.05,
-  allOpus: 0.55,
-};
-
-export const VOICE = {
-  elevenlabs: { label: "ElevenLabs Starter", usdPerMonth: 5, perPieceUsd: 0.03 },
-  kokoro: { label: "Kokoro (OSS, local)", usdPerMonth: 0, perPieceUsd: 0 },
-  veoNative: { label: "Veo native audio (no separate voice)", usdPerMonth: 0, perPieceUsd: 0 },
-};
-
-// Client-facing price tiers (DRAFT — Kayla to confirm numbers). reels = pieces/month.
-export const CLIENT_TIERS = {
-  starter: {
-    name: "Starter", priceUsd: 399, reels: 8,
-    clip: "bulk", script: "sonnet", voice: "elevenlabs",
-    recurringCharacter: 0, managedPosting: false, complianceQC: "basic", revisions: 1,
-  },
-  growth: {
-    name: "Growth", priceUsd: 899, reels: 20,
-    clip: "hero+bulk", script: "sonnet", voice: "elevenlabs",
-    recurringCharacter: 1, managedPosting: true, complianceQC: "disclosed+claim-clean",
-    analytics: "monthly", revisions: 2,
-  },
-  signature: {
-    name: "Signature", priceUsd: 1999, reels: 40,
-    clip: "hero", script: "sonnet+opus-hero", voice: "elevenlabs",
-    recurringCharacter: 2, managedPosting: true, complianceQC: "senior/finance/health compliance pass",
-    analytics: "full+strategy", revisions: "generous",
-  },
-  alacarte: { name: "À la carte", priceUsd: 100, reels: 1, note: "$75–150/Reel for one-offs & tests" },
-};
-
-// Format → risk tier (tiered approval). Sensitive formats HOLD for Kayla.
-export const RISK = {
-  "traveler": "auto",
-  "nostalgia": "auto",
-  "scam-reveal": "hold",
-  "is-this-real": "hold",
-  "ai-for-seniors": "hold",
-};

package/content-org/cost.mjs

@@ -1,36 +0,0 @@
-// content-org — COGS + margin calculator. `node cost.mjs [piecesPerMonth]`
-// No dependencies. Prices are estimates from config.mjs — tune against real usage.
-import { CLIENT_TIERS, TEXT_COST_PER_PIECE, CLIP_LANES, VOICE } from "./config.mjs";
-
-const usd = (n) => "$" + n.toFixed(2);
-const REEL_SECONDS = 30; // ~30s Reel
-
-// per-finished-Reel COGS given a clip lane + text tier + voice
-function cogsPerReel({ clip = "hero", textTier = "valueTierBatch", voice = "elevenlabs" } = {}) {
-  const text = TEXT_COST_PER_PIECE[textTier] ?? TEXT_COST_PER_PIECE.valueTierBatch;
-  const clipUsd = (CLIP_LANES[clip]?.usdPerSec ?? 0) * REEL_SECONDS;
-  const voiceUsd = VOICE[voice]?.perPieceUsd ?? 0;
-  return text + clipUsd + voiceUsd;
-}
-
-console.log("=== per-Reel COGS by clip lane (value text tier + Batch, ElevenLabs voice) ===");
-for (const lane of Object.keys(CLIP_LANES)) {
-  console.log(`  ${lane.padEnd(7)} ${usd(cogsPerReel({ clip: lane }))}   (${CLIP_LANES[lane].label})`);
-}
-
-console.log("\n=== client tiers (DRAFT prices) ===");
-for (const key of ["starter", "growth", "signature"]) {
-  const t = CLIENT_TIERS[key];
-  const lane = key === "starter" ? "bulk" : "hero";
-  const cogs = cogsPerReel({ clip: lane }) * t.reels;
-  const voiceSub = VOICE.elevenlabs.usdPerMonth; // one sub covers all clients
-  const margin = t.priceUsd - cogs;
-  const marginPct = ((margin / t.priceUsd) * 100).toFixed(0);
-  console.log(`  ${t.name.padEnd(10)} ${usd(t.priceUsd)}/mo  ${String(t.reels).padStart(2)} Reels  COGS ${usd(cogs)}  →  margin ${usd(margin)} (${marginPct}%)`);
-}
-console.log(`  (+ shared fixed: ElevenLabs sub ${usd(VOICE.elevenlabs.usdPerMonth)}/mo across all clients; tooling floor ~$130/mo automated)`);
-
-console.log("\n=== YOUR OWN pages ===");
-const own = Number(process.argv[2] || "90");
-const ownCogs = cogsPerReel({ clip: "hero" }) * own;
-console.log(`  ${own} Reels/mo automated (Veo hero): clips+text+voice ≈ ${usd(ownCogs)}  |  manual clips ≈ ${usd(cogsPerReel({ clip: "manual" }) * own)}`);

package/content-org/lead.js

@@ -1,64 +0,0 @@
-// Content lead — the single callable entry the Weftens front door hands to when a
-// request is about making content. The door calls this; this runs the 10-seat
-// pipeline and returns one result. The door never addresses the individual seats
-// (ideator, writer, qc, …) — the Content lead owns them.
-//
-// It shells the existing orchestrator rather than importing a run() function: the
-// orchestrator's full-run body is argv/global-driven, and wrapping it by shell keeps
-// its 27 passing tests untouched (no refactor risk). The orchestrator writes packet
-// JSON into content-org/inbox/<date>/; we run it, read those packets back, and return
-// them as the result.
-//
-// Defaults to dry-run. A real content run depends on Phase-0 decisions that are
-// Kayla's and still open (local vs cloud, cadence, keys) — so this wiring proves the
-// pipeline is callable as one node WITHOUT producing real published content. Pass
-// { dry: false } only once those decisions are made and a key is configured.
-
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
-import { readFile, readdir, rm } from "node:fs/promises";
-import { fileURLToPath } from "node:url";
-import { dirname, join } from "node:path";
-
-const execFileP = promisify(execFile);
-const HERE = dirname(fileURLToPath(import.meta.url));
-
-/**
- * Run the content pipeline as one node.
- * @param opts { format?, count?, client?, tier?, dry? }  // dry defaults true (safe)
- * @returns { dry, format, count, artifacts, result, log }
- *   artifacts  packet file paths produced
- *   result     the parsed packets (dry-run packets are stub-shaped, clearly slugged dryrun-N)
- */
-export async function runContent(opts = {}) {
-  const { format = "scam-reveal", count = 1, client = null, tier = null, dry = true } = opts;
-
-  const args = ["orchestrator.mjs", format, String(count)];
-  if (client) args.push(`--client=${client}`);
-  if (tier) args.push(`--tier=${tier}`);
-  if (dry) args.push("--dry-run");
-
-  const { stdout } = await execFileP("node", args, { cwd: HERE, maxBuffer: 8_000_000 });
-
-  // The orchestrator writes to inbox/<date>/; recover <date> from its own output line
-  // ("Packets in inbox/2026-07-19/.") rather than recomputing a clock here.
-  const m = stdout.match(/Packets in (inbox[\\/][^\s/]+)/);
-  const outRel = m ? m[1].replace(/[\\/]$/, "") : null;
-  const artifacts = [];
-  const result = [];
-  if (outRel) {
-    const outDir = join(HERE, outRel);
-    for (const name of (await readdir(outDir)).filter((n) => n.endsWith(".json"))) {
-      const file = join(outDir, name);
-      artifacts.push(file);
-      result.push(JSON.parse(await readFile(file, "utf8")));
-    }
-    // A dry run's stub packets are throwaway — remove them so a verification run does
-    // not litter content-org/inbox. Real runs keep their packets.
-    if (dry) {
-      await Promise.all(artifacts.map((f) => rm(f, { force: true })));
-    }
-  }
-
-  return { dry, format, count, artifacts, result, log: stdout.trim() };
-}