@project-ava-supernova/core 0.2.71

package/dist/tools/authoring/templates/builtins.js

@@ -0,0 +1,478 @@
+/**
+ * Built-in worked-exemplar templates.
+ *
+ * Each `body` is a complete, well-written document of its kind — real prose at
+ * the right length and tone, with `{{tokens}}` only where something must change.
+ * They double as a quality bar for Ava and as a teaching example for the writer.
+ * Stored as TS constants so they ship on every surface with no asset-copy step.
+ */
+const proposal = {
+    id: 'business/proposal',
+    domain: 'business',
+    title: 'Project proposal',
+    description: 'A persuasive proposal that opens with the outcome, then earns the budget.',
+    styleProfile: 'proposal',
+    toneGuide: 'Confident and concrete. Lead with the client\'s outcome, not your process. Second person ("you get…"). No filler.',
+    lengthHint: '1–2 pages',
+    variables: [
+        { key: 'title', label: 'Proposal title', default: 'Project Proposal' },
+        { key: 'client', label: 'Client name' },
+        { key: 'author', label: 'Your name' },
+        { key: 'company', label: 'Your company' },
+    ],
+    source: 'builtin',
+    body: `---
+title: {{title}}
+author: {{author}}
+date: {{date}}
+style: proposal
+toc: true
+---
+
+## Executive summary
+
+{{client}} needs [the outcome they're buying] without [the cost or risk they're avoiding].
+This proposal lays out a focused engagement that delivers it in [timeframe], for [budget].
+In one line: you get [the result], and we own the hard parts.
+
+## The opportunity
+
+Right now, [describe the situation in the client's words — what's slow, costly, or missing].
+Left as-is, it means [the concrete cost: lost time, lost revenue, risk]. The moment to fix it
+is now, because [the reason it's urgent].
+
+## Proposed approach
+
+We'll get there in three moves:
+
+1. **[Phase one]** — [what we do and what you have at the end of it].
+2. **[Phase two]** — [the build, and the first thing you can use].
+3. **[Phase three]** — [launch, handover, and how you keep running without us].
+
+:::tip{title="What makes this different"}
+[The one thing about your approach that a competitor can't claim — be specific.]
+:::
+
+## Timeline
+
+| Phase | Duration | You receive |
+| :--- | :--- | :--- |
+| Discovery | [2 weeks] | [A clear plan and scope] |
+| Build | [6 weeks] | [A working version] |
+| Launch | [2 weeks] | [Live, with handover] |
+
+## Investment
+
+| Item | Cost |
+| :--- | ---: |
+| [Phase one] | [£0] |
+| [Phase two] | [£0] |
+| [Phase three] | [£0] |
+| **Total** | **[£0]** |
+
+## Why {{company}}
+
+[Two or three sentences of proof — a comparable result, relevant experience, the named people
+who'll do the work. Specific beats grand.]
+
+## Next steps
+
+1. You approve this proposal.
+2. We book a kickoff for [date].
+3. Discovery starts the following Monday.
+`,
+};
+const report = {
+    id: 'business/report',
+    domain: 'business',
+    title: 'Status report',
+    description: 'A crisp progress report that a busy reader can act on in a minute.',
+    styleProfile: 'report',
+    toneGuide: 'Plain, factual, decision-oriented. Lead with the headline. No hedging — say what is true.',
+    lengthHint: '1 page',
+    variables: [
+        { key: 'title', label: 'Report title', default: 'Status Report' },
+        { key: 'author', label: 'Your name' },
+        { key: 'period', label: 'Reporting period' },
+    ],
+    source: 'builtin',
+    body: `---
+title: {{title}}
+author: {{author}}
+date: {{date}}
+style: report
+---
+
+## Summary
+
+[One paragraph: where things stand, the single most important thing the reader needs to know,
+and whether we're on track. Say it straight.]
+
+## Progress this period ({{period}})
+
+- [Shipped / completed — a real thing, not "worked on"]
+- [Shipped / completed]
+- [In progress, with a clear % or expected finish]
+
+## Key numbers
+
+| Metric | Last | Now | Target |
+| :--- | ---: | ---: | ---: |
+| [Metric] | [0] | [0] | [0] |
+| [Metric] | [0] | [0] | [0] |
+
+## Risks & blockers
+
+:::warning
+[The one thing most likely to derail this, and what you're doing about it. If there's nothing
+real, say "No critical risks this period" — don't invent one.]
+:::
+
+## Next period
+
+- [The next concrete deliverable, with a date]
+- [The decision you need from the reader, if any]
+`,
+};
+const meetingNotes = {
+    id: 'business/meeting_notes',
+    domain: 'business',
+    title: 'Meeting notes',
+    description: 'Decisions and actions first — the kind of notes people actually re-read.',
+    styleProfile: 'meeting_notes',
+    toneGuide: 'Terse and factual. Capture decisions and owners, not a transcript.',
+    lengthHint: 'Half a page',
+    variables: [
+        { key: 'title', label: 'Meeting title', default: 'Meeting Notes' },
+        { key: 'attendees', label: 'Attendees' },
+    ],
+    source: 'builtin',
+    body: `---
+title: {{title}}
+date: {{date}}
+style: meeting_notes
+---
+
+**Attendees:** {{attendees}}
+
+## Decisions
+
+- [The decision that was made — stated as a fact, not a discussion.]
+- [Another decision.]
+
+## Discussion
+
+- [The point that mattered and the reasoning behind a decision.]
+- [Open question that's still unresolved.]
+
+## Action items
+
+| Action | Owner | Due |
+| :--- | :--- | :--- |
+| [What needs doing] | [Name] | [Date] |
+| [What needs doing] | [Name] | [Date] |
+
+## Next meeting
+
+[Date and the one thing it needs to resolve.]
+`,
+};
+const invoice = {
+    id: 'business/invoice',
+    domain: 'business',
+    title: 'Invoice',
+    description: 'A clean, professional invoice with clear line items and terms.',
+    styleProfile: 'invoice',
+    toneGuide: 'Neutral and precise. No prose — just the facts of the transaction.',
+    variables: [
+        { key: 'number', label: 'Invoice number', default: 'INV-001' },
+        { key: 'from', label: 'Your details' },
+        { key: 'to', label: 'Client details' },
+    ],
+    source: 'builtin',
+    body: `---
+title: Invoice {{number}}
+date: {{date}}
+style: invoice
+---
+
+**Invoice number:** {{number}}
+**Date:** {{date}}
+**Due:** [30 days from date]
+
+## From
+
+{{from}}
+
+## To
+
+{{to}}
+
+## Items
+
+| Description | Qty | Unit price | Total |
+| :--- | ---: | ---: | ---: |
+| [Service or item] | [1] | [£0.00] | [£0.00] |
+| [Service or item] | [1] | [£0.00] | [£0.00] |
+| **Total** | | | **[£0.00]** |
+
+## Payment
+
+Payment due within 30 days. Bank transfer to [account details]. Reference {{number}}.
+`,
+};
+const brief = {
+    id: 'business/brief',
+    domain: 'business',
+    title: 'Decision brief',
+    description: 'A one-page brief that leads with the decision and the recommendation.',
+    styleProfile: 'brief',
+    toneGuide: 'Executive. The recommendation goes first. Everything after it is justification.',
+    lengthHint: '1 page',
+    variables: [{ key: 'title', label: 'Brief title', default: 'Decision Brief' }],
+    source: 'builtin',
+    body: `---
+title: {{title}}
+date: {{date}}
+style: brief
+---
+
+## Recommendation
+
+[State the decision you're recommending in one sentence. No preamble.]
+
+## Why
+
+- [The strongest reason.]
+- [The second reason.]
+- [The reason that pre-empts the obvious objection.]
+
+## What it costs
+
+[Money, time, and trade-offs — honestly. The reader trusts a brief that names the downside.]
+
+## The alternative
+
+[What happens if we don't, or the next-best option and why it loses.]
+
+## Decision needed by
+
+[Date, and from whom.]
+`,
+};
+const article = {
+    id: 'editorial/article',
+    domain: 'editorial',
+    title: 'Article',
+    description: 'A long-form article with a strong hook and a clear through-line.',
+    styleProfile: 'article',
+    toneGuide: 'Engaging and human. Open with a hook, not a definition. Vary sentence length. Earn each section.',
+    lengthHint: '800–1500 words',
+    variables: [
+        { key: 'title', label: 'Article title' },
+        { key: 'author', label: 'Author' },
+    ],
+    source: 'builtin',
+    body: `---
+title: {{title}}
+author: {{author}}
+date: {{date}}
+style: article
+---
+
+[Open with a hook — a scene, a surprising fact, a sharp question. Make the reader want the next
+sentence. Do not open with "In today's world" or a dictionary definition.]
+
+[One or two paragraphs that turn the hook into a promise: here's what this piece will show you,
+and why it matters to you specifically.]
+
+## [The first idea]
+
+[Make one point per section and make it well. Use a concrete example — a story beats an assertion.
+Show, then tell.]
+
+## [The second idea]
+
+[Build on the first. If there's a counter-argument, meet it head-on; it makes you more credible,
+not less.]
+
+## [Where it leaves us]
+
+[Land the plane. Return to the hook from the opening, now that the reader sees it differently.
+End on a line they'll remember.]
+`,
+};
+const pressRelease = {
+    id: 'editorial/press_release',
+    domain: 'editorial',
+    title: 'Press release',
+    description: 'A standard-format press release with a quotable lead.',
+    styleProfile: 'press_release',
+    toneGuide: 'Third person, news style. The first sentence carries the whole story. Quotes sound like a person, not a brochure.',
+    variables: [
+        { key: 'headline', label: 'Headline' },
+        { key: 'company', label: 'Company' },
+    ],
+    source: 'builtin',
+    body: `---
+title: {{headline}}
+date: {{date}}
+style: press_release
+---
+
+**FOR IMMEDIATE RELEASE**
+
+## {{headline}}
+
+**[City, Date]** — [The lead: who did what, and why it matters, in one sentence a journalist
+could publish verbatim. Front-load the news.]
+
+[Second paragraph: the detail that supports the lead — the what and the how, concretely.]
+
+"[A quote that sounds like a real person saying something they believe — not marketing copy,]"
+said [Name, Title] at {{company}}. "[A second line that adds meaning, not just enthusiasm.]"
+
+[Third paragraph: context — why now, what it changes, who it's for.]
+
+### About {{company}}
+
+[Two sentences on who the company is and what it does. Plain and factual.]
+
+**Contact:** [Name] · [email] · [phone]
+`,
+};
+const essay = {
+    id: 'academic/essay',
+    domain: 'academic',
+    title: 'Academic essay',
+    description: 'A structured essay with a clear thesis and an argument that builds.',
+    styleProfile: 'essay',
+    toneGuide: 'Formal but readable. One arguable thesis, defended in stages. Signpost the structure. Cite where you claim.',
+    lengthHint: '1000–2500 words',
+    variables: [
+        { key: 'title', label: 'Essay title' },
+        { key: 'author', label: 'Author' },
+    ],
+    source: 'builtin',
+    body: `---
+title: {{title}}
+author: {{author}}
+date: {{date}}
+style: essay
+---
+
+## Introduction
+
+[Set up the question and why it's worth asking. End the introduction with a clear, arguable
+thesis — a claim someone could reasonably disagree with, which this essay will defend.]
+
+## [First supporting argument]
+
+[Make the strongest case for the thesis first. Evidence, then interpretation. Tie the paragraph
+back to the thesis explicitly.[^1]]
+
+## [Second supporting argument]
+
+[Develop a distinct line of support. Each section should advance the argument, not restate it.]
+
+## [Counter-argument and response]
+
+[State the best objection fairly, then answer it. This is where the essay earns its conclusion.]
+
+## Conclusion
+
+[Restate the thesis in light of what's been shown — not word for word. End with the wider
+significance: so what?]
+
+[^1]: [Citation — author, title, year, page.]
+`,
+};
+const resume = {
+    id: 'career/resume',
+    domain: 'career',
+    title: 'Résumé / CV',
+    description: 'A results-first résumé that leads with impact, not job duties.',
+    styleProfile: 'resume',
+    toneGuide: 'Tight and active. Every bullet starts with a verb and ends with a result or number. No "responsible for".',
+    variables: [
+        { key: 'name', label: 'Full name' },
+        { key: 'contact', label: 'Contact line' },
+    ],
+    source: 'builtin',
+    body: `---
+title: {{name}}
+style: resume
+---
+
+{{contact}}
+
+## Summary
+
+[Two lines: who you are professionally and the value you bring, stated as outcomes you've
+delivered — not adjectives about yourself.]
+
+## Experience
+
+### [Job title] — [Company] ([Year]–[Year])
+
+- [Action verb] [what you did] that [measurable result, e.g. "cut load time 40%"].
+- [Action verb] [what you did] for [scope, e.g. "a team of 6 / 10k users"].
+- [Action verb] [the achievement you're proudest of here].
+
+### [Job title] — [Company] ([Year]–[Year])
+
+- [Result-first bullet.]
+- [Result-first bullet.]
+
+## Education
+
+- [Degree] — [Institution] ([Year])
+
+## Skills
+
+[A focused list of the skills that match the role you want — not everything you've ever touched.]
+`,
+};
+const coverLetter = {
+    id: 'career/cover_letter',
+    domain: 'career',
+    title: 'Cover letter',
+    description: 'A specific, confident cover letter that connects you to this role.',
+    styleProfile: 'cover_letter',
+    toneGuide: 'Warm, specific, and brief. Show you understand this role at this company. No generic flattery.',
+    lengthHint: 'Under one page',
+    variables: [
+        { key: 'role', label: 'Role' },
+        { key: 'company', label: 'Company' },
+        { key: 'name', label: 'Your name' },
+    ],
+    source: 'builtin',
+    body: `---
+subtitle: Application for {{role}}
+date: {{date}}
+style: cover_letter
+---
+
+Dear [Hiring Manager's name],
+
+[Open with why this role, at this company, specifically — something concrete you admire or that
+fits you. Skip "I am writing to apply".]
+
+[Second paragraph: the most relevant thing you've done, told as a short proof. Connect it
+directly to what {{company}} needs in this role.]
+
+[Third paragraph: what you'd bring and why you're excited — genuine, not gushing. One line.]
+
+I'd welcome the chance to talk. Thank you for considering my application.
+
+Kind regards,
+{{name}}
+`,
+};
+export const BUILTIN_TEMPLATES = [
+    proposal, report, meetingNotes, invoice, brief,
+    article, pressRelease,
+    essay,
+    resume, coverLetter,
+];
+//# sourceMappingURL=builtins.js.map

package/dist/tools/authoring/templates/builtins.js.map

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

package/dist/tools/authoring/templates/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Template registry — built-in worked exemplars plus the writer's saved
+ * templates, resolved by id with friendly fallbacks.
+ */
+import type { DocTemplate } from './template-model.js';
+/** All templates (builtins + user), optionally filtered to one domain. */
+export declare function listTemplates(domain?: string): Promise<DocTemplate[]>;
+/** Resolve a template by full id ('business/proposal'), short id ('proposal'),
+ *  or title — user templates shadow builtins on an exact id match. */
+export declare function getTemplate(id: string): Promise<DocTemplate | undefined>;
+export { BUILTIN_TEMPLATES } from './builtins.js';
+export { loadHouseStyle, saveHouseStyle, saveUserTemplate, loadUserTemplates } from './store.js';
+export { fillTemplate, templateSummary } from './template-model.js';
+export type { DocTemplate, TemplateDomain, TemplateVar } from './template-model.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/authoring/templates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/authoring/templates/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,0EAA0E;AAC1E,wBAAsB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAI3E;AAED;sEACsE;AACtE,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAQ9E;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACpE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/tools/authoring/templates/index.js

@@ -0,0 +1,25 @@
+/**
+ * Template registry — built-in worked exemplars plus the writer's saved
+ * templates, resolved by id with friendly fallbacks.
+ */
+import { BUILTIN_TEMPLATES } from './builtins.js';
+import { loadUserTemplates } from './store.js';
+/** All templates (builtins + user), optionally filtered to one domain. */
+export async function listTemplates(domain) {
+    const user = await loadUserTemplates();
+    const all = [...BUILTIN_TEMPLATES, ...user];
+    return domain ? all.filter(t => t.domain === domain) : all;
+}
+/** Resolve a template by full id ('business/proposal'), short id ('proposal'),
+ *  or title — user templates shadow builtins on an exact id match. */
+export async function getTemplate(id) {
+    const norm = id.trim().toLowerCase();
+    const all = await listTemplates();
+    return ([...all].reverse().find(t => t.id.toLowerCase() === norm) ??
+        all.find(t => t.id.toLowerCase().endsWith('/' + norm)) ??
+        all.find(t => t.title.toLowerCase() === norm));
+}
+export { BUILTIN_TEMPLATES } from './builtins.js';
+export { loadHouseStyle, saveHouseStyle, saveUserTemplate, loadUserTemplates } from './store.js';
+export { fillTemplate, templateSummary } from './template-model.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/authoring/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/authoring/templates/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG/C,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAe;IACjD,MAAM,IAAI,GAAG,MAAM,iBAAiB,EAAE,CAAC;IACvC,MAAM,GAAG,GAAG,CAAC,GAAG,iBAAiB,EAAE,GAAG,IAAI,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AAC7D,CAAC;AAED;sEACsE;AACtE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAU;IAC1C,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,GAAG,GAAG,MAAM,aAAa,EAAE,CAAC;IAClC,OAAO,CACL,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC;QACzD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;QACtD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,CAC9C,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/tools/authoring/templates/store.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Local-first persistence for user templates and "house style".
+ *
+ * A writer can save Ava's best output as a reusable template, and pin a brand
+ * (fonts/colours) that every new document inherits. Both live as plain files
+ * under the Ava home (AVA_HOME or ~/.ava) — exact, offline, and yours. No cloud,
+ * no account.
+ */
+import type { DocTemplate } from './template-model.js';
+import type { BrandTokens } from '../doc-model.js';
+export declare function loadHouseStyle(): Promise<BrandTokens | undefined>;
+export declare function saveHouseStyle(brand: BrandTokens): Promise<string>;
+export declare function saveUserTemplate(tpl: DocTemplate): Promise<string>;
+export declare function loadUserTemplates(): Promise<DocTemplate[]>;
+//# sourceMappingURL=store.d.ts.map

package/dist/tools/authoring/templates/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../src/tools/authoring/templates/store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAWnD,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAOvE;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAKxE;AAID,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAMxE;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAYhE"}

package/dist/tools/authoring/templates/store.js

@@ -0,0 +1,63 @@
+/**
+ * Local-first persistence for user templates and "house style".
+ *
+ * A writer can save Ava's best output as a reusable template, and pin a brand
+ * (fonts/colours) that every new document inherits. Both live as plain files
+ * under the Ava home (AVA_HOME or ~/.ava) — exact, offline, and yours. No cloud,
+ * no account.
+ */
+import { readFile, writeFile, mkdir, readdir } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+function avaHome() {
+    return process.env.AVA_HOME || join(homedir(), '.ava');
+}
+function authoringDir() { return join(avaHome(), 'authoring'); }
+function templatesDir() { return join(authoringDir(), 'templates'); }
+function houseStylePath() { return join(authoringDir(), 'house-style.json'); }
+// ── House style ──────────────────────────────────────────────────────────────
+export async function loadHouseStyle() {
+    try {
+        const parsed = JSON.parse(await readFile(houseStylePath(), 'utf-8'));
+        return parsed && typeof parsed === 'object' ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function saveHouseStyle(brand) {
+    await mkdir(authoringDir(), { recursive: true });
+    const path = houseStylePath();
+    await writeFile(path, JSON.stringify(brand, null, 2), 'utf-8');
+    return path;
+}
+// ── User templates ───────────────────────────────────────────────────────────
+export async function saveUserTemplate(tpl) {
+    await mkdir(templatesDir(), { recursive: true });
+    const safe = tpl.id.replace(/[^\w.-]+/g, '_');
+    const path = join(templatesDir(), `${safe}.json`);
+    await writeFile(path, JSON.stringify({ ...tpl, source: 'user' }, null, 2), 'utf-8');
+    return path;
+}
+export async function loadUserTemplates() {
+    let files;
+    try {
+        files = await readdir(templatesDir());
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const f of files) {
+        if (!f.endsWith('.json'))
+            continue;
+        try {
+            const tpl = JSON.parse(await readFile(join(templatesDir(), f), 'utf-8'));
+            if (tpl?.id && tpl?.body)
+                out.push({ ...tpl, source: 'user' });
+        }
+        catch { /* skip malformed */ }
+    }
+    return out;
+}
+//# sourceMappingURL=store.js.map

package/dist/tools/authoring/templates/store.js.map

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

package/dist/tools/authoring/templates/template-model.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Template model for the authoring engine.
+ *
+ * A template is a *worked exemplar* — a complete, well-written document of its
+ * kind (front-matter + real prose at the right length and tone), not a blank
+ * skeleton full of "TBD". `{{token}}` markers stand in only for the handful of
+ * things that genuinely change (a name, a date, a subject). This gives Ava a
+ * quality bar to match and shows a beginner what "great" looks like.
+ *
+ * Built-in templates are TS constants (so they ship on every surface without an
+ * asset-copy build step); user templates are loaded from disk (templates/store).
+ */
+export type TemplateDomain = 'business' | 'editorial' | 'academic' | 'career' | 'custom';
+export interface TemplateVar {
+    key: string;
+    label: string;
+    default?: string;
+}
+export interface DocTemplate {
+    /** Stable id, namespaced by domain — e.g. 'business/proposal'. */
+    id: string;
+    domain: TemplateDomain;
+    title: string;
+    description: string;
+    /** Maps to a DocumentStyleProfile (margins, cover page, footer). */
+    styleProfile: string;
+    /** How this kind of document should read — guides Ava when she expands it. */
+    toneGuide: string;
+    /** Rough length expectation, surfaced to keep Ava in register. */
+    lengthHint?: string;
+    variables?: TemplateVar[];
+    /** The worked-exemplar markdown (with front-matter and {{tokens}}). */
+    body: string;
+    source: 'builtin' | 'user';
+}
+/**
+ * Fill `{{token}}` markers from supplied data. Unknown tokens become a clear,
+ * bracketed prompt (e.g. `[Client Name]`) — never a blank or a "TBD" — so the
+ * draft reads as a finished document with obvious spots to personalise.
+ */
+export declare function fillTemplate(tpl: DocTemplate, data?: Record<string, string>, today?: string): string;
+/** A short, scannable catalogue line for list_templates. */
+export declare function templateSummary(t: DocTemplate): string;
+//# sourceMappingURL=template-model.d.ts.map

package/dist/tools/authoring/templates/template-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-model.d.ts","sourceRoot":"","sources":["../../../../src/tools/authoring/templates/template-model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzF,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;CAC5B;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAUxG;AAED,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAEtD"}