@tangle-network/starter-foundry 0.5.3 → 0.7.0

package/dist/lib/agent-context.js

@@ -53,6 +53,28 @@ export const PERSONALIZATION_INSTRUCTION = `${PERSONALIZATION_JSON_INSTRUCTION}
  *      regardless of whether the dev server is technically running.
  */
 export const ENSURE_DEV_SERVER_INSTRUCTION = 'STEP 0 (do this BEFORE anything else, BEFORE reading other files, BEFORE editing): start the dev server. Run this exact command in `bash` immediately: `curl -fsS -X POST "http://localhost:${SIDECAR_PORT:-9000}/process/ensure-dev-server" -H "Content-Type: application/json" -H "Authorization: Bearer ${SIDECAR_AUTH_TOKEN}" -d \'{}\'`. It is idempotent (safe to call multiple times — returns the same pid), auto-installs dependencies on first call, and surfaces typed error codes (`WORKSPACE_NOT_FOUND`, `NO_RUNNABLE_PROJECT`, `INSTALL_FAILED`, `DEV_COMMAND_NOT_FOUND`, `DEV_PROCESS_EXITED`, `PORT_BIND_FAILED`) you can react to. The `SIDECAR_PORT` and `SIDECAR_AUTH_TOKEN` environment variables are pre-set in your bash environment — you do NOT need to look them up or set them. CRITICAL: Do NOT run `pnpm install`, `pnpm dev`, `npm install`, `npm run dev`, `next dev`, `vite`, `cargo run`, or any other dev/install command via `bash` directly — those bypass the runtime tracking and the user\'s preview pane will not wire up. After Step 0 returns success, then you can read files and start editing. Subsequent edits hot-reload via HMR; do NOT call this again to restart unless the response says you should.';
+// ── Structured context builders ──────────────────────────────────────────
+//
+// These replace the old .join(' ') wall-of-text format with numbered steps.
+// LLMs follow numbered instructions more reliably than prose paragraphs,
+// and the structured format cuts ~40% of tokens by removing redundancy
+// between the context message and AGENTS.md.
+const DEV_SERVER_STEP = '1. **Start the dev server** (do this FIRST, before reading files or editing):\n' +
+    '   ```bash\n' +
+    '   curl -fsS -X POST "http://localhost:${SIDECAR_PORT:-9000}/process/ensure-dev-server" \\\n' +
+    '     -H "Content-Type: application/json" \\\n' +
+    '     -H "Authorization: Bearer ${SIDECAR_AUTH_TOKEN}" -d \'{}\'\n' +
+    '   ```\n' +
+    '   Env vars are pre-set. Do NOT run pnpm/npm install or dev commands directly — they bypass runtime tracking.';
+const PERSONALIZE_STEP = '2. **Personalize for the user\'s product:**\n' +
+    '   - Rewrite `personalize.json` (workspace root or `src/`) — brand name, tagline, hero copy, features. This is the single highest-leverage edit.\n' +
+    '   - Rewrite `personalize.css` (`src/` or `app/`) — HSL color palette on `:root` and `.dark` that fits the product.';
+const BUILD_STEP_COMPOSED = (family) => `3. **Read AGENTS.md**, then implement the user's request.\n` +
+    `   The scaffold is a ${family} project. Edit existing files — don't recreate them.\n` +
+    '   Use shadcn/ui components from `src/components/ui/` instead of raw HTML.';
+const BUILD_STEP_CURATED = '3. **Read AGENTS.md** if present, then implement the user\'s request.\n' +
+    '   Edit existing files — don\'t recreate them. Use shadcn/ui components if available.';
+const VERIFY_STEP = '4. **Screenshot the preview.** Fix anything broken or unstyled before responding.';
 /**
  * Returns a canonical agent-context message for a freshly composed scaffold.
  * Consumers (blueprint-agent etc.) inject this into the agent's first system
@@ -63,17 +85,12 @@ export const ENSURE_DEV_SERVER_INSTRUCTION = 'STEP 0 (do this BEFORE anything el
 export function getComposedScaffoldContext(result) {
     const family = result.components.family;
     return [
-        `A working project scaffold has been composed in /home/agent by starter-foundry (family: ${family}).`,
-        // Step 0: dev server. Front-loaded BEFORE any other instruction so the
-        // agent's first action is "make the user see a preview ASAP", not
-        // "polish files for 5 minutes then forget to start the server".
-        ENSURE_DEV_SERVER_INSTRUCTION,
-        'After Step 0, read /home/agent/AGENTS.md — it contains the architecture notes, suggested pages and components, design rules, and personalization instructions.',
-        PERSONALIZATION_INSTRUCTION,
-        'If shadcn/ui components are present in src/components/ui/, use them instead of raw HTML.',
-        'Make targeted edits to extend the scaffold for the user request — do NOT recreate files that already exist.',
-        'After writing UI code, screenshot the preview to verify it renders correctly.',
-    ].join(' ');
+        `A working ${family} scaffold has been composed in /home/agent.\n`,
+        DEV_SERVER_STEP,
+        PERSONALIZE_STEP,
+        BUILD_STEP_COMPOSED(family),
+        VERIFY_STEP,
+    ].join('\n\n');
 }
 /**
  * Returns a canonical agent-context message for a curated tarball scaffold
@@ -83,16 +100,11 @@ export function getComposedScaffoldContext(result) {
  */
 export function getCuratedScaffoldContext() {
     return [
-        'A working project scaffold is set up in /home/agent.',
-        // Step 0: dev server. Front-loaded BEFORE any other instruction so the
-        // agent's first action is "make the user see a preview ASAP".
-        ENSURE_DEV_SERVER_INSTRUCTION,
-        'After Step 0, read /home/agent/AGENTS.md if present — it contains the build plan and personalization instructions.',
-        PERSONALIZATION_INSTRUCTION,
-        'Make the minimum set of file edits needed to satisfy the user request.',
-        'Do not spend time on broad repo exploration.',
-        'If shadcn/ui components are available (src/components/ui/), use them instead of raw HTML.',
-        'After writing UI code, screenshot the preview to verify it renders correctly. Fix any unstyled elements before responding.',
-    ].join(' ');
+        'A working project scaffold is set up in /home/agent.\n',
+        DEV_SERVER_STEP,
+        PERSONALIZE_STEP,
+        BUILD_STEP_CURATED,
+        VERIFY_STEP,
+    ].join('\n\n');
 }
 //# sourceMappingURL=agent-context.js.map

package/dist/lib/agent-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-context.js","sourceRoot":"","sources":["../../src/lib/agent-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAC1C,qSAAqS,CAAA;AAEvS;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAC3C,gyBAAgyB,CAAA;AAElyB;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GACtC,GAAG,gCAAgC,IAAI,+BAA+B,EAAE,CAAA;AAE1E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,6BAA6B,GACxC,wrCAAwrC,CAAA;AAE1rC;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAqB;IAC9D,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAA;IACvC,OAAO;QACL,2FAA2F,MAAM,IAAI;QACrG,uEAAuE;QACvE,kEAAkE;QAClE,gEAAgE;QAChE,6BAA6B;QAC7B,gKAAgK;QAChK,2BAA2B;QAC3B,0FAA0F;QAC1F,6GAA6G;QAC7G,+EAA+E;KAChF,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,sDAAsD;QACtD,uEAAuE;QACvE,8DAA8D;QAC9D,6BAA6B;QAC7B,oHAAoH;QACpH,2BAA2B;QAC3B,wEAAwE;QACxE,8CAA8C;QAC9C,2FAA2F;QAC3F,4HAA4H;KAC7H,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACb,CAAC"}
+{"version":3,"file":"agent-context.js","sourceRoot":"","sources":["../../src/lib/agent-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAC1C,qSAAqS,CAAA;AAEvS;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAC3C,gyBAAgyB,CAAA;AAElyB;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GACtC,GAAG,gCAAgC,IAAI,+BAA+B,EAAE,CAAA;AAE1E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,6BAA6B,GACxC,wrCAAwrC,CAAA;AAE1rC,4EAA4E;AAC5E,EAAE;AACF,4EAA4E;AAC5E,yEAAyE;AACzE,uEAAuE;AACvE,6CAA6C;AAE7C,MAAM,eAAe,GACnB,iFAAiF;IACjF,cAAc;IACd,8FAA8F;IAC9F,+CAA+C;IAC/C,mEAAmE;IACnE,UAAU;IACV,+GAA+G,CAAA;AAEjH,MAAM,gBAAgB,GACpB,+CAA+C;IAC/C,oJAAoJ;IACpJ,qHAAqH,CAAA;AAEvH,MAAM,mBAAmB,GAAG,CAAC,MAAc,EAAE,EAAE,CAC7C,6DAA6D;IAC7D,wBAAwB,MAAM,wDAAwD;IACtF,4EAA4E,CAAA;AAE9E,MAAM,kBAAkB,GACtB,yEAAyE;IACzE,uFAAuF,CAAA;AAEzF,MAAM,WAAW,GACf,mFAAmF,CAAA;AAErF;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAqB;IAC9D,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAA;IACvC,OAAO;QACL,aAAa,MAAM,+CAA+C;QAClE,eAAe;QACf,gBAAgB;QAChB,mBAAmB,CAAC,MAAM,CAAC;QAC3B,WAAW;KACZ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,wDAAwD;QACxD,eAAe;QACf,gBAAgB;QAChB,kBAAkB;QAClB,WAAW;KACZ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;AAChB,CAAC"}

package/dist/lib/batch-export.js

@@ -1,20 +1,10 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
-import { spawn } from 'node:child_process';
 import { composeStarter } from './compose.js';
 import { fattenStarter } from './fatten.js';
 import { validateStarter } from './validate.js';
-import { ensureDir, readJson, writeJson } from './fs.js';
+import { ensureDir, readJson, runTar, writeJson } from './fs.js';
 import { listRegistry } from './registry.js';
-function runTar(sourceDir, archivePath) {
-    return new Promise((resolve) => {
-        const child = spawn('tar', ['-czf', archivePath, '-C', sourceDir, '.'], {
-            stdio: ['ignore', 'ignore', 'ignore'],
-        });
-        child.on('close', (code) => resolve(code === 0));
-        child.on('error', () => resolve(false));
-    });
-}
 export async function batchExport({ mappingPath, outDir, filter = null, fatten: shouldFatten = false, validate: shouldValidate = true, concurrency = 4, }) {
     const start = performance.now();
     const mapping = await readJson(mappingPath);

package/dist/lib/batch-export.js.map

@@ -1 +1 @@
-{"version":3,"file":"batch-export.js","sourceRoot":"","sources":["../../src/lib/batch-export.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"batch-export.js","sourceRoot":"","sources":["../../src/lib/batch-export.ts"],"names":[],"mappings":"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"}

package/dist/lib/brand/first-turn-flows.d.ts

@@ -0,0 +1,10 @@
+export interface FirstTurnFlow {
+    industry: string;
+    steps: string[];
+    /** Families the flow applies to. */
+    appliesTo: string[];
+}
+export declare function firstTurnFlowForIndustry(industry: string | undefined): string[];
+export declare function firstTurnFlowForFamily(family: string, industry?: string): string[];
+export declare function listKnownIndustries(): string[];
+export declare function firstTurnFlowAsMarkdown(family: string, industry?: string): string;

package/dist/lib/brand/first-turn-flows.js

@@ -0,0 +1,114 @@
+// Industry-specific first-turn flows. When a composed scaffold targets an
+// industry vertical, the agent's first turn should hit domain-specific steps
+// — not "install deps and poke around." Emit as an "# First Turn Flow"
+// section in AGENTS.md.
+const FLOWS = [
+    {
+        industry: 'healthcare',
+        appliesTo: ['healthcare-hipaa-backend', 'fullstack-ts', 'api-service', 'python-api'],
+        steps: [
+            'Define patients, encounters, providers schema (Drizzle or SQLAlchemy) — include audit_logs as an append-only table.',
+            'Wire PHI-access middleware: every read/write of a PHI-bearing column MUST emit an audit row before returning.',
+            'Configure field-level AES-256-GCM encryption for SSN, DOB, medical record numbers.',
+            'Add a BAA acknowledgment page + gate API keys behind signed BAA upload.',
+            'Set retention policy for audit_logs (≥6 years per HIPAA §164.316(b)(2)(i)).',
+            'Never log PHI to stdout, structured logs, or error traces — add a sanitizer to the logger layer.',
+        ],
+    },
+    {
+        industry: 'fintech',
+        appliesTo: ['fintech-ledger-backend', 'api-service', 'python-api', 'fullstack-ts'],
+        steps: [
+            'Define accounts, transactions, entries schema — NUMERIC(20,4) for amounts, NEVER float.',
+            'Enforce double-entry invariant in DB: CHECK(SUM(debit) = SUM(credit) per transaction_id).',
+            'Wire idempotency on every write endpoint — unique (source, client_reference).',
+            'Point-in-time balance query: SELECT SUM(debit - credit) WHERE account_id = ? AND posted_at <= ?.',
+            'Add reconciliation job that flags orphaned entries (no matching counterparty).',
+            'Use decimal.js (JS) or decimal.Decimal (Python) for all arithmetic; ban direct * / operators on monetary values.',
+        ],
+    },
+    {
+        industry: 'legal',
+        appliesTo: ['legal-case-mgmt', 'fullstack-ts', 'api-service'],
+        steps: [
+            'Define matters, parties, documents, time_entries, invoices, billing_rates schema.',
+            'Make documents content-addressed (sha256 over blob) + immutable — no UPDATE on documents table.',
+            'Time entries: integer minutes + ISO-8601 workedAt timestamp; ban float hours.',
+            'Billing-rate resolver: time-bounded rate_history lookup at each entry\'s workedAt.',
+            'Invoice draft generator: aggregates unbilled time_entries, resolves rate, emits per-matter PDF.',
+            'Attorney-client privilege: gate document access by matter_id ∈ user.accessible_matters.',
+        ],
+    },
+    {
+        industry: 'k12',
+        appliesTo: ['k12-edtech', 'fullstack-ts', 'api-service'],
+        steps: [
+            'Define students, teachers, classes, enrollments, assignments, submissions, grades, parents, parent_students schema.',
+            'FERPA: every grade READ (not just write) emits a row to grade_access_logs BEFORE returning.',
+            'Parent access gate: parent → student via parent_students.custodial_rights = true (not just same email).',
+            'Grade amendments are NEW rows with amends_grade_id FK — never UPDATE an existing grade.',
+            'Export endpoint: one-click PDF per student per term (transcript) — required by 34 CFR §99.31.',
+            'Minimum-necessary filter: teachers see only students in their classes; parents see only their children.',
+        ],
+    },
+    {
+        industry: 'ecommerce',
+        appliesTo: ['ecommerce-headless', 'fullstack-ts', 'nextjs-ts', 'api-service'],
+        steps: [
+            'Define products, variants, carts, line_items, orders, payments, webhook_events schema.',
+            'Snapshot unit_price + sku at add-to-cart time — line items MUST NOT read from current product price.',
+            'Inventory decrement in SAME transaction as order placement; ban the two-step "order then decrement" pattern.',
+            'Stripe PaymentIntent: client_reference_id = cart_id, idempotency_key = cart_id + attempt.',
+            'Webhook handler: verify signature on raw body BEFORE JSON.parse; dedupe by webhook_events.event_id UNIQUE.',
+            'Refund flow: creates a new credit line; ban UPDATE on completed orders.',
+        ],
+    },
+    {
+        industry: 'crm',
+        appliesTo: ['crm-backend', 'fullstack-ts', 'api-service'],
+        steps: [
+            'Define contacts, companies, deals, activities, stages, pipelines, deal_stage_history schema.',
+            'Deal amounts in integer cents + per-row currency code (no locale ambiguity).',
+            'Stage transitions log to deal_stage_history — never mutate deal.stage without the audit row.',
+            'Activity-timestamp is source of truth for lastTouched; don\'t denormalize onto the contact.',
+            'Pipeline-value report: SUM(amount * stage.probability) GROUP BY stage.',
+            'Deduplication: contact email + company domain as natural keys; offer a merge UI instead of blocking.',
+        ],
+    },
+    {
+        industry: 'trading',
+        appliesTo: ['evm-infra-ts', 'agent-service-ts', 'worker-job', 'fullstack-ts'],
+        steps: [
+            'Wire market-data WebSocket (not REST polling) for live book.',
+            'Define PnL computation: realized (closed positions) + unrealized (mark-to-market on open).',
+            'Risk limits middleware: check position size + margin BEFORE order submission, not after.',
+            'Stream order-book viz — subscribe at the component level, unsubscribe on unmount.',
+            'Never store private keys in the frontend — sign in a worker or via a wallet adapter.',
+        ],
+    },
+];
+export function firstTurnFlowForIndustry(industry) {
+    if (!industry)
+        return [];
+    const match = FLOWS.find((f) => f.industry === industry.toLowerCase());
+    return match?.steps ?? [];
+}
+export function firstTurnFlowForFamily(family, industry) {
+    // Prefer industry-specific when the family matches; otherwise fall back.
+    const byIndustry = industry ? FLOWS.find((f) => f.industry === industry.toLowerCase() && f.appliesTo.includes(family)) : null;
+    if (byIndustry)
+        return byIndustry.steps;
+    const byFamily = FLOWS.find((f) => f.appliesTo.includes(family));
+    return byFamily?.steps ?? [];
+}
+export function listKnownIndustries() {
+    return FLOWS.map((f) => f.industry);
+}
+export function firstTurnFlowAsMarkdown(family, industry) {
+    const steps = firstTurnFlowForFamily(family, industry);
+    if (steps.length === 0)
+        return '';
+    const heading = industry ? `## First turn flow — ${industry}` : '## First turn flow';
+    return [heading, '', ...steps.map((s, i) => `${i + 1}. ${s}`), ''].join('\n');
+}
+//# sourceMappingURL=first-turn-flows.js.map

package/dist/lib/brand/first-turn-flows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-turn-flows.js","sourceRoot":"","sources":["../../../src/lib/brand/first-turn-flows.ts"],"names":[],"mappings":"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"}

package/dist/lib/brand/i18n.d.ts

@@ -0,0 +1,15 @@
+import type { BrandKit } from './index.js';
+export declare const RTL_LOCALES: Set<string>;
+export type LocalePack = Record<string, string>;
+export declare function isRtl(locale: string): boolean;
+export declare function generateLocalePack(kit: BrandKit, locale: string): LocalePack;
+export interface I18nEmitResult {
+    locales: string[];
+    files: Array<{
+        path: string;
+        body: string;
+    }>;
+    rtlEnabled: boolean;
+}
+export declare function buildI18nFiles(kit: BrandKit, locales: string[]): I18nEmitResult;
+export declare function emitI18n(kit: BrandKit, outDir: string, locales: string[]): Promise<I18nEmitResult>;

package/dist/lib/brand/i18n.js

@@ -0,0 +1,100 @@
+// i18n / locale-pack emission. Emits public/locales/<locale>/common.json for
+// each requested locale, plus a minimal src/i18n.ts i18next bootstrap. RTL
+// locales (ar, he, fa, ur) trigger a global CSS rule targeting html[dir="rtl"].
+import fs from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { ensureDir } from '../fs.js';
+export const RTL_LOCALES = new Set(['ar', 'he', 'fa', 'ur']);
+export function isRtl(locale) {
+    return RTL_LOCALES.has(locale.split('-')[0].toLowerCase());
+}
+// Minimal translation table per locale — the hero strings are brand-specific
+// (substituted from the kit); common UI strings are hand-translated for the
+// small baseline set. Real products extend via their own translation flow.
+const COMMON_STRINGS = {
+    en: { get_started: 'Get started', learn_more: 'Learn more', sign_in: 'Sign in', sign_out: 'Sign out' },
+    es: { get_started: 'Comenzar', learn_more: 'Saber más', sign_in: 'Iniciar sesión', sign_out: 'Cerrar sesión' },
+    fr: { get_started: 'Commencer', learn_more: 'En savoir plus', sign_in: 'Se connecter', sign_out: 'Se déconnecter' },
+    de: { get_started: 'Loslegen', learn_more: 'Mehr erfahren', sign_in: 'Anmelden', sign_out: 'Abmelden' },
+    ja: { get_started: 'はじめる', learn_more: '詳細を見る', sign_in: 'サインイン', sign_out: 'サインアウト' },
+    ar: { get_started: 'ابدأ', learn_more: 'اعرف المزيد', sign_in: 'تسجيل الدخول', sign_out: 'تسجيل الخروج' },
+    he: { get_started: 'התחל', learn_more: 'למידע נוסף', sign_in: 'כניסה', sign_out: 'יציאה' },
+    pt: { get_started: 'Começar', learn_more: 'Saiba mais', sign_in: 'Entrar', sign_out: 'Sair' },
+    zh: { get_started: '开始', learn_more: '了解更多', sign_in: '登录', sign_out: '登出' },
+};
+export function generateLocalePack(kit, locale) {
+    const base = COMMON_STRINGS[locale] ?? COMMON_STRINGS['en'];
+    return {
+        ...base,
+        brand_name: kit.brandName,
+        brand_tagline: kit.tagline,
+        hero_headline: kit.heroHeadline,
+        hero_subheadline: kit.heroSubheadline,
+    };
+}
+export function buildI18nFiles(kit, locales) {
+    const files = [];
+    const rtlEnabled = locales.some((l) => isRtl(l));
+    for (const locale of locales) {
+        const pack = generateLocalePack(kit, locale);
+        files.push({
+            path: `public/locales/${locale}/common.json`,
+            body: JSON.stringify(pack, null, 2) + '\n',
+        });
+    }
+    // Minimal i18next bootstrap for consumers that want it. Keeps the runtime
+    // optional — the composed scaffold can import it or skip it.
+    const bootstrap = `// Auto-generated by starter-foundry. Minimal i18next setup.
+// Extend or replace freely — the locale packs in public/locales/ are the source of truth.
+import i18next from 'i18next'
+
+const locales = ${JSON.stringify(locales)}
+const defaultLocale = ${JSON.stringify(locales[0] ?? 'en')}
+
+export async function initI18n(): Promise<typeof i18next> {
+  const resources: Record<string, { translation: Record<string, string> }> = {}
+  for (const locale of locales) {
+    const pack = await fetch(\`/locales/\${locale}/common.json\`).then((r) => r.json())
+    resources[locale] = { translation: pack }
+  }
+  await i18next.init({
+    lng: defaultLocale,
+    fallbackLng: 'en',
+    interpolation: { escapeValue: false },
+    resources,
+  })
+  return i18next
+}
+
+export function setLocale(locale: string): void {
+  void i18next.changeLanguage(locale)
+  if (typeof document !== 'undefined') {
+    const rtl = ${JSON.stringify([...RTL_LOCALES])}
+    document.documentElement.dir = rtl.includes(locale.split('-')[0]) ? 'rtl' : 'ltr'
+    document.documentElement.lang = locale
+  }
+}
+`;
+    files.push({ path: 'src/i18n.ts', body: bootstrap });
+    if (rtlEnabled) {
+        const rtlCss = `/* RTL direction flip — applied when the active locale is in ${[...RTL_LOCALES].join(', ')}. */
+html[dir="rtl"] {
+  direction: rtl;
+  text-align: right;
+}
+html[dir="rtl"] .reverse-on-rtl { flex-direction: row-reverse; }
+`;
+        files.push({ path: 'public/rtl.css', body: rtlCss });
+    }
+    return { locales, files, rtlEnabled };
+}
+export async function emitI18n(kit, outDir, locales) {
+    const result = buildI18nFiles(kit, locales);
+    for (const f of result.files) {
+        const abs = join(outDir, f.path);
+        await ensureDir(dirname(abs));
+        await fs.writeFile(abs, f.body, 'utf8');
+    }
+    return result;
+}
+//# sourceMappingURL=i18n.js.map

package/dist/lib/brand/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../../src/lib/brand/i18n.ts"],"names":[],"mappings":"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"}

package/dist/lib/brand/index.d.ts

@@ -0,0 +1,27 @@
+export interface BrandKit {
+    brandName: string;
+    tagline: string;
+    heroHeadline: string;
+    heroSubheadline: string;
+    voice: 'formal' | 'casual' | 'technical' | 'playful' | 'neutral';
+    palette: {
+        primary: string;
+        secondary: string;
+        accent: string;
+        background: string;
+        foreground: string;
+    };
+    typography: {
+        sans: string;
+        mono: string;
+    };
+    source: 'llm' | 'deterministic';
+}
+export declare function generateBrand(args: {
+    prompt: string;
+    industry?: string;
+}): Promise<BrandKit>;
+/** Merge a BrandKit into the personalize.json that composes into the scaffold. */
+export declare function brandToPersonalizeJson(kit: BrandKit): Record<string, unknown>;
+/** Render a BrandKit's palette into the HSL-custom-property block used by personalize.css. */
+export declare function brandToPersonalizeCss(kit: BrandKit): string;

package/dist/lib/brand/index.js

@@ -0,0 +1,100 @@
+// Brand generation library. Given a user prompt + industry, produce a
+// concrete brand kit: name, tagline, color palette (HSL), typography stack,
+// voice/tone guidance. Consumers splice this into personalize.json +
+// personalize.css at compose time.
+//
+// LLM path (when router key present) → full generative brand kit.
+// Deterministic fallback → industry-preset palette from registry/layers/
+// industry/*/files/personalize.css, voice = "neutral", typography = Inter.
+import { createLLM, isLLMAvailable } from '../llm.js';
+import { ax } from '@ax-llm/ax';
+const brandAgent = ax('prompt:string, industry:string -> brandName:string, tagline:string, heroHeadline:string, heroSubheadline:string, voice:string, paletteHslTriplets:string[], typographyStack:string');
+function deterministicBrand(prompt, industry) {
+    // Extract a noun-phrase-ish name from the prompt. Cheap, defensible, and
+    // overridable by the agent in the first turn.
+    const words = prompt
+        .split(/[^a-zA-Z0-9]+/)
+        .filter((w) => w.length >= 4 && w.length <= 16 && !/^(build|create|scaffold|make)$/i.test(w))
+        .slice(0, 2);
+    const brandName = words.length > 0
+        ? words.map((w) => w[0].toUpperCase() + w.slice(1).toLowerCase()).join('') || 'Starter'
+        : 'Starter';
+    // Industry-driven palette presets.
+    const palettes = {
+        fitness: { primary: '142 71% 45%', secondary: '142 40% 94%', accent: '30 90% 55%', background: '0 0% 100%', foreground: '142 80% 10%' },
+        fintech: { primary: '220 90% 56%', secondary: '220 14% 96%', accent: '160 60% 45%', background: '0 0% 100%', foreground: '224 71% 4%' },
+        healthcare: { primary: '196 80% 45%', secondary: '196 30% 96%', accent: '340 75% 55%', background: '0 0% 100%', foreground: '196 60% 10%' },
+        crypto: { primary: '263 70% 50%', secondary: '263 30% 96%', accent: '30 90% 55%', background: '263 15% 8%', foreground: '263 20% 94%' },
+        default: { primary: '220 90% 56%', secondary: '220 14% 96%', accent: '160 60% 45%', background: '0 0% 100%', foreground: '224 71% 4%' },
+    };
+    const palette = palettes[industry ?? 'default'] ?? palettes.default;
+    return {
+        brandName,
+        tagline: 'Ship the thing. Iterate in public.',
+        heroHeadline: brandName,
+        heroSubheadline: `A ${industry ?? 'production-ready'} starter the agent will make yours on turn 1.`,
+        voice: 'neutral',
+        palette,
+        typography: { sans: 'Inter, ui-sans-serif, system-ui, sans-serif', mono: 'JetBrains Mono, ui-monospace, monospace' },
+        source: 'deterministic',
+    };
+}
+export async function generateBrand(args) {
+    if (!isLLMAvailable())
+        return deterministicBrand(args.prompt, args.industry);
+    try {
+        const llm = createLLM();
+        const raw = (await brandAgent.forward(llm, {
+            prompt: args.prompt,
+            industry: args.industry ?? 'general',
+        }));
+        const triplets = Array.isArray(raw.paletteHslTriplets) ? raw.paletteHslTriplets : [];
+        const fallback = deterministicBrand(args.prompt, args.industry);
+        return {
+            brandName: raw.brandName || fallback.brandName,
+            tagline: raw.tagline || fallback.tagline,
+            heroHeadline: raw.heroHeadline || fallback.heroHeadline,
+            heroSubheadline: raw.heroSubheadline || fallback.heroSubheadline,
+            voice: (['formal', 'casual', 'technical', 'playful', 'neutral'].includes(raw.voice ?? '') ? raw.voice : 'neutral'),
+            palette: {
+                primary: triplets[0] ?? fallback.palette.primary,
+                secondary: triplets[1] ?? fallback.palette.secondary,
+                accent: triplets[2] ?? fallback.palette.accent,
+                background: triplets[3] ?? fallback.palette.background,
+                foreground: triplets[4] ?? fallback.palette.foreground,
+            },
+            typography: raw.typographyStack
+                ? { sans: raw.typographyStack, mono: fallback.typography.mono }
+                : fallback.typography,
+            source: 'llm',
+        };
+    }
+    catch {
+        return deterministicBrand(args.prompt, args.industry);
+    }
+}
+/** Merge a BrandKit into the personalize.json that composes into the scaffold. */
+export function brandToPersonalizeJson(kit) {
+    return {
+        brand: { name: kit.brandName, tagline: kit.tagline },
+        hero: { headline: kit.heroHeadline, subheadline: kit.heroSubheadline },
+        voice: kit.voice,
+        _source: kit.source,
+    };
+}
+/** Render a BrandKit's palette into the HSL-custom-property block used by personalize.css. */
+export function brandToPersonalizeCss(kit) {
+    return [
+        ':root {',
+        `  --color-primary: hsl(${kit.palette.primary});`,
+        `  --color-secondary: hsl(${kit.palette.secondary});`,
+        `  --color-accent: hsl(${kit.palette.accent});`,
+        `  --color-background: hsl(${kit.palette.background});`,
+        `  --color-foreground: hsl(${kit.palette.foreground});`,
+        `  --font-sans: ${kit.typography.sans};`,
+        `  --font-mono: ${kit.typography.mono};`,
+        '}',
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/brand/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/brand/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/brand/media-manifest.d.ts

@@ -0,0 +1,26 @@
+import type { BrandKit } from './index.js';
+export interface MediaAsset {
+    path: string;
+    purpose: 'logo' | 'logo-png' | 'hero-bg' | 'og' | 'favicon' | 'app-icon';
+    spec: {
+        width: number;
+        height: number;
+        format: 'svg' | 'png' | 'ico';
+    };
+}
+export interface MediaManifest {
+    schemaVersion: 1;
+    generatedAt: string;
+    assets: MediaAsset[];
+    /** Fingerprint of the source BrandKit so callers can detect drift. */
+    brandFingerprint: string;
+}
+export interface GenerateMediaResult {
+    manifest: MediaManifest;
+    files: Array<{
+        path: string;
+        body: string;
+    }>;
+}
+export declare function buildMediaManifest(kit: BrandKit): GenerateMediaResult;
+export declare function generateMediaManifest(kit: BrandKit, outDir: string): Promise<GenerateMediaResult>;