@project-ava-supernova/core 0.2.71

package/dist/docs/content/start.js

@@ -0,0 +1,203 @@
+// Section 1 — Start here. Newcomer-focused. Read in order.
+export const START_PAGES = [
+    {
+        id: 'start.what',
+        title: 'What is Ava?',
+        audience: ['newcomer', 'both'],
+        surfaces: ['web', 'ext', 'ide', 'companion'],
+        order: 10,
+        section: 'start',
+        body: [
+            { type: 'paragraph', text: 'Ava is an AI that actually does things — not just talks. She\'ll build you an app, write you a document, teach you something from scratch, design you a logo, or take care of the admin you keep putting off. And she remembers you: what you\'re working on, how you like things, what you asked for last week.' },
+            { type: 'paragraph', text: 'There\'s one Ava, and she works wherever you do — in your code editor, as a desktop app, on your phone, or in a terminal. Same memory, same personality, everywhere.' },
+            { type: 'heading', level: 3, text: 'What makes her different' },
+            { type: 'list', ordered: false, items: [
+                    'Yours by default. Your work stays on your own machine. No tracking, no telemetry — ever.',
+                    'Open for anyone to see. Every line of Ava is public. Nothing to take on trust.',
+                    'Free to start. 300 credits every month, no card, no catch — or plug in your own AI keys and pay us nothing at all.',
+                    'Teaching built in. Ask Ava to teach you any subject and she builds you a real course — lessons, examples, and quizzes.',
+                ] },
+            { type: 'paragraph', text: 'Never written code? The next page is written just for you. Already technical? Skip ahead — she\'ll keep up.' },
+        ],
+        deeper: [
+            { type: 'heading', level: 3, text: 'Where Ava lives' },
+            { type: 'list', ordered: false, items: [
+                    'VS Code extension — Ava next to your editor: a chat panel, a dashboard, and changes shown inline before they happen.',
+                    'Desktop IDE — a standalone app with the whole thing in one window. Adds desktop control (opening apps, clicking, typing for you).',
+                    'Companion — Ava in your browser at avasupernova.com/companion, for when you\'re away from your desk: tasks, journal, memory, quick chats. Nothing to install, and it works on a phone.',
+                    'CLI — Ava in your terminal, for people who live there.',
+                ] },
+            { type: 'heading', level: 3, text: 'How she works, in brief' },
+            { type: 'paragraph', text: 'Ava switches mindsets (called modes) to match the job, quietly runs a small team of specialist helpers on harder work, and picks the best AI model for each step automatically. You never manage any of it. The Core concepts section has the full tour whenever you\'re curious.' },
+        ],
+    },
+    {
+        id: 'start.for-non-coders',
+        title: "Never written code? Start here",
+        audience: ['newcomer'],
+        surfaces: ['web', 'ext', 'ide', 'companion'],
+        order: 15,
+        section: 'start',
+        body: [
+            { type: 'paragraph', text: "If you have never written a line of code, you are exactly who Ava is for. You do not need to learn any jargon to start — you talk to her in plain English, the way you would ask a knowledgeable friend. This page is your whole on-ramp." },
+            { type: 'heading', level: 3, text: 'What you can do today, with no experience' },
+            { type: 'list', ordered: false, items: [
+                    'Ask her anything, in normal words — "what does this file do?", "why is my page blank?", "what even is a database?" She answers in plain language and remembers the conversation.',
+                    'Learn something from scratch — say "teach me Python from zero" and she builds you a proper course with lessons and quizzes.',
+                    'Get something built — describe what you want ("a button that downloads my notes") and she writes it, showing you every change before it happens.',
+                ] },
+            { type: 'heading', level: 3, text: "You don't need to understand everything" },
+            { type: 'paragraph', text: "Ava has a lot of machinery under the hood — modes, models, specialists, routing. You will see those words around the app and in these docs. Here is the secret: you can ignore almost all of it. Ava picks the right tools and the right helpers for you automatically. The technical pages are there for when you get curious, not because you need them to start." },
+            { type: 'heading', level: 3, text: 'A gentle first path' },
+            { type: 'list', ordered: true, items: [
+                    'Install Ava (next page) and open the chat.',
+                    'Type a real question you have. Anything. See how she answers.',
+                    'Try learning mode: type "teach me" and a topic. Follow along.',
+                    'When you want her to actually make or change something, just ask — she will always show you what she is about to do and wait for your "yes".',
+                ] },
+            { type: 'callout', variant: 'tip', text: 'Hit a word you do not recognise? The Plain-English glossary (further down this section) explains every term with no assumed knowledge.' },
+        ],
+    },
+    {
+        id: 'start.install',
+        title: 'Install',
+        audience: ['newcomer'],
+        surfaces: ['web', 'ext', 'ide', 'companion'],
+        order: 20,
+        section: 'start',
+        body: [
+            { type: 'paragraph', text: 'Pick the surface that matches how you work. You can use more than one — Ava syncs her memory across them when you sign in.' },
+            { type: 'heading', level: 3, text: 'VS Code extension' },
+            { type: 'list', ordered: true, items: [
+                    'Open the Extensions panel in VS Code (Ctrl+Shift+X / Cmd+Shift+X).',
+                    'Search for "Ava Supernova" and click Install.',
+                    'Press Ctrl+Shift+A (Cmd+Shift+A on macOS) to open the chat panel.',
+                    'Follow the setup wizard — pick a model, set your permission mode, done.',
+                ] },
+            { type: 'heading', level: 3, text: 'Desktop IDE' },
+            { type: 'list', ordered: true, items: [
+                    'Download the installer for your platform from the releases page.',
+                    'Run it. The IDE launches with a welcome flow the first time.',
+                    'Sign in for the free platform tokens, or paste your own API key to run fully local.',
+                ] },
+            { type: 'heading', level: 3, text: 'CLI' },
+            { type: 'list', ordered: true, items: [
+                    'npm install -g @ava/cli  (or pnpm / yarn — your choice).',
+                    'Run  ava  in any project directory.',
+                    'First run prompts you for a provider and a model. Pick and go.',
+                ] },
+            { type: 'callout', variant: 'tip', text: 'No account, no problem. With your own API key (BYOK) you never need to sign in. The free tier is for the platform-managed models.' },
+        ],
+    },
+    {
+        id: 'start.first-five',
+        title: 'Your first thing with Ava',
+        audience: ['newcomer', 'both'],
+        surfaces: ['web', 'ext', 'ide', 'companion'],
+        order: 30,
+        section: 'start',
+        task: 'build',
+        body: [
+            { type: 'paragraph', text: 'The fastest way to get Ava is to ask her for something real and watch her do it. No setup to read, nothing to learn first — just tell her what you want, in plain words.' },
+            { type: 'heading', level: 3, text: 'Try this now' },
+            { type: 'list', ordered: true, items: [
+                    'Open the chat.',
+                    'Type something you actually want. Try "explain what this project does", or "add a button that clears the form".',
+                    'Ava shows you what she\'s about to do — and waits.',
+                    'Happy with it? Say yes. Watch her do it.',
+                ] },
+            { type: 'paragraph', text: 'That\'s the whole rhythm: you ask, she shows you the plan, you approve, she does it. She never changes anything without showing you first — so you can\'t break anything by trying.' },
+            { type: 'heading', level: 3, text: 'A few things worth asking for' },
+            { type: 'list', ordered: false, items: [
+                    'A question — "why is my page blank?", "what does this file do?"',
+                    'Something built — "make me a simple to-do list page".',
+                    'To learn something — "teach me Python from scratch". She builds you a real course, step by step.',
+                    'A document — "write me a one-page project proposal". She\'ll hand you a Word file or PDF.',
+                ] },
+            { type: 'callout', variant: 'tip', text: 'Not sure what to type? Talk to her like a knowledgeable friend. Plain words are exactly right — you never need the technical terms to get going.' },
+        ],
+        deeper: [
+            { type: 'paragraph', text: 'That simple loop is doing a fair amount behind the scenes. You don\'t need any of this to use Ava — but here\'s what\'s actually happening if you\'re curious.' },
+            { type: 'heading', level: 3, text: 'Tools and approval' },
+            { type: 'paragraph', text: 'When Ava reads a file, runs a command, or edits code, each of those is a "tool call". She asks before anything that touches your files or system — how often she asks is set by your permission mode (ask every time, ask only for risky things, or just go).' },
+            { type: 'heading', level: 3, text: 'Modes — her states of mind' },
+            { type: 'paragraph', text: 'Ava works in modes: a mindset plus the right toolkit for the job. Switch any time from the picker, or type a prefix at the start of your message. There are seven.' },
+            { type: 'facts', kind: 'modes' },
+            { type: 'heading', level: 3, text: 'Specialists and routing' },
+            { type: 'paragraph', text: 'On harder jobs Ava runs a small team of specialist helpers behind the scenes (a planner, a checker, a builder) and routes each step to the model that\'s best at it. You never manage any of this — she coordinates it for you.' },
+        ],
+    },
+    {
+        id: 'start.local-vs-cloud',
+        title: 'Local vs cloud, in one paragraph',
+        audience: ['newcomer', 'both'],
+        surfaces: ['web', 'ext', 'ide', 'companion'],
+        order: 40,
+        section: 'start',
+        body: [
+            { type: 'paragraph', text: 'Everything Ava does is local unless you explicitly opt in. Memory, tasks, journal, personality, settings — all stored on your machine in ~/.ava/ and .ava/ (per project). She talks to model providers over HTTPS to run your request, then returns home. She does not phone home. She does not collect telemetry. She does not train on your code.' },
+            { type: 'paragraph', text: 'If you sign in, you get 300 free credits a month on platform-managed models (Qwen, DeepSeek, Mistral) and optional cloud sync for memory and settings across machines. Sync is per-feature, revocable anytime. Bring your own API key and Ava works fully without an account.' },
+            { type: 'callout', variant: 'tip', text: 'The rule: local is sacred. Cloud is additive.' },
+        ],
+    },
+    {
+        id: 'start.first-model',
+        title: 'Do I need to choose an AI?',
+        audience: ['newcomer', 'both'],
+        surfaces: ['web', 'ext', 'ide', 'companion'],
+        order: 50,
+        section: 'start',
+        body: [
+            { type: 'paragraph', text: 'Here\'s a relief: you don\'t pick the AI. Ava chooses the right one for each step automatically, so you get good results without having to think about it.' },
+            { type: 'paragraph', text: 'The one thing you can choose is a routing style — and the default suits almost everyone. You only need the others for a specific reason.' },
+            { type: 'heading', level: 3, text: 'The three styles' },
+            { type: 'list', ordered: false, items: [
+                    'Maestro — the default. Steady, reliable, predictable. Not sure? This is the one.',
+                    'Supernova — for heavy, multi-step work, where it pays to put a different specialist on each part of the job.',
+                    'Aurora — for when your data must stay in the EU (public sector, healthcare, strict privacy). Runs entirely on European, open-weight AI.',
+                ] },
+            { type: 'paragraph', text: 'Switch any time from the model picker at the top of the chat. Nothing\'s locked in.' },
+            { type: 'callout', variant: 'tip', text: 'Want to drive one specific model yourself? You can — open "Show me the details".' },
+        ],
+        deeper: [
+            { type: 'heading', level: 3, text: 'What\'s actually in each style' },
+            { type: 'paragraph', text: 'Maestro — one conductor (Qwen 3.7 Plus) handles every step. Production-tuned, proven, predictable cost.' },
+            { type: 'paragraph', text: 'Supernova — a frontier coordinator (DeepSeek V4 Pro, 1.6T parameters / 49B active, 1M context) hands each subtask to a specialist: V4 Flash for high-volume review, Qwen 3.7 Plus for building and for vision (it sees images and video natively).' },
+            { type: 'paragraph', text: 'Aurora — Mistral only, in three tiers led by the frontier model. Mistral Medium 3.5 (128B dense, 256K context, native vision; 77.6% on SWE-Bench Verified, per Mistral) is the coordinator + heavy specialists + Builder + vision. Mistral Small 4 is the high-volume workhorse (chat, intent gate, light specialists), cheaper than Large 3. Mistral Large 3 (675B/41B MoE, Apache-2.0) is the broad-knowledge heavy reserve. Open weights end to end, never leaves EU infrastructure.' },
+            { type: 'heading', level: 3, text: 'Bring your own model (BYOK)' },
+            { type: 'paragraph', text: 'Prefer to use your own AI account? Paste your provider key in settings and you get both — the three routing styles, plus the option to pick a single model and skip routing entirely. Useful for a strong preference, a strict budget, or testing a specific model. The full provider list is in the Reference section.' },
+            { type: 'facts', kind: 'providers', filter: { kind: 'managed' } },
+        ],
+    },
+    {
+        id: 'start.glossary',
+        title: 'Plain-English glossary',
+        audience: ['newcomer', 'both'],
+        surfaces: ['web', 'ext', 'ide', 'companion'],
+        order: 60,
+        section: 'start',
+        body: [
+            { type: 'paragraph', text: 'Every word you might bump into around Ava, explained with no assumed knowledge. You do not need to memorise any of this — flip back whenever a term trips you up.' },
+            { type: 'table', headers: ['Word', 'What it actually means'], rows: [
+                    ['Agent', 'An AI that can take actions for you — read a file, run a command, search the web — not just chat. Ava is an agent: she does things, with your say-so.'],
+                    ['Model', 'The actual AI brain doing the thinking (Qwen, DeepSeek, Mistral, and others). Different models have different strengths. You normally never pick one — Ava does.'],
+                    ['Mode', 'The mindset Ava is in. Like a colleague switching hats: builder, writer, teacher, planner, friend. You pick the mode; it changes how she behaves. There are seven.'],
+                    ['Persona / specialist', 'Helper roles Ava runs behind the scenes for harder jobs — an explorer, a planner, a fact-checker. Think of a small expert team. You never talk to them directly; Ava coordinates them.'],
+                    ['Routing', "Ava deciding which model to use for each step so you get good answers without overpaying. It happens automatically — \"routing mode\" just picks the overall strategy."],
+                    ['Tool', 'A specific action Ava can take — read a file, run a search, send an email. A "tool call" is her using one. She asks permission before anything risky.'],
+                    ['Token', 'How AI measures text — roughly ¾ of a word. Models are priced per million tokens. Mostly something you can ignore.'],
+                    ['Credit', "Ava's simpler unit for what an action costs, so you are not doing token maths. Plans come with a monthly bundle."],
+                    ['API key', 'A private password that lets software use a paid service (like an AI model) on your account. You only need one if you want to bring your own.'],
+                    ['BYOK', "\"Bring Your Own Key.\" Using your own API key instead of Ava's managed access. Optional — for people who already pay a provider directly."],
+                    ['Local-first', "Your data lives on your own computer by default. Nothing is uploaded unless you switch on sync. \"Local is sacred.\""],
+                    ['Permission mode', 'How cautious Ava is before doing things — ask every time, ask for risky things only, or just go. You set the level.'],
+                    ['Context window', "How much text a model can hold in mind at once — its short-term memory. \"1M context\" means about a million words. Bigger = it can read more before forgetting."],
+                    ['Diff', 'A side-by-side view of exactly what will change in a file — old on one side, new on the other — shown before Ava changes anything so you can approve it.'],
+                    ['Repository (repo)', 'A project folder tracked for changes, usually with Git. If that means nothing to you yet, it is just "the folder my project lives in."'],
+                    ['Prompt', 'What you type to the AI — your question or instruction.'],
+                ] },
+            { type: 'callout', variant: 'note', text: 'Still stuck on a word? Ask Ava in Chat mode — "what does X mean?" — and she will explain it for your level.' },
+        ],
+    },
+];
+//# sourceMappingURL=start.js.map

package/dist/docs/content/start.js.map

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

package/dist/docs/content/troubleshooting.d.ts

@@ -0,0 +1,3 @@
+import type { DocPage } from '../types.js';
+export declare const TROUBLESHOOTING_PAGES: DocPage[];
+//# sourceMappingURL=troubleshooting.d.ts.map

package/dist/docs/content/troubleshooting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"troubleshooting.d.ts","sourceRoot":"","sources":["../../../src/docs/content/troubleshooting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C,eAAO,MAAM,qBAAqB,EAAE,OAAO,EAoG1C,CAAC"}

package/dist/docs/content/troubleshooting.js

@@ -0,0 +1,98 @@
+// Section 5 — Troubleshooting & support. New content — no surface has this today.
+export const TROUBLESHOOTING_PAGES = [
+    {
+        id: 'troubleshooting.common-errors',
+        title: 'Common errors',
+        audience: ['both'],
+        surfaces: ['web', 'ext', 'ide'],
+        order: 10,
+        section: 'troubleshooting',
+        body: [
+            { type: 'paragraph', text: 'Most errors have a short, specific cause. Here are the common ones and how to fix them. Do not worry if the wording sounds technical — each one below tells you what you are actually seeing and exactly what to do.' },
+            { type: 'heading', level: 3, text: 'Model not responding' },
+            { type: 'paragraph', text: 'What you see: Ava goes quiet and does not reply.' },
+            { type: 'paragraph', text: 'Check the status indicator in the chat header. If it says "connecting", your provider (the AI service Ava is talking to) is reachable but slow — give it thirty seconds. If it says "unavailable", Ava auto-fell-back to the next model in the chain (she automatically switched to a backup model). If nothing at all, verify your API key in Settings and test the connection. (An API key is the private password that lets Ava use a paid AI service.)' },
+            { type: 'heading', level: 3, text: 'Tool call failed' },
+            { type: 'paragraph', text: 'What you see: one of Ava\'s steps (a "tool call" — her reading a file, running a command, and so on) shows a red error instead of finishing.' },
+            { type: 'paragraph', text: 'Click the failed tool call to see the error. Common causes: she tried to touch a file outside your project folder, which is blocked on purpose for your safety (this guard is called "path traversal" protection — it stops her wandering outside the folder you are working in); a command that needs to run in a different folder; or a file that got moved since Ava last looked at it. Tell her what went wrong — she will retry with corrections.' },
+            { type: 'heading', level: 3, text: 'Memory not recalling' },
+            { type: 'paragraph', text: 'What you see: Ava cannot find something you are sure she should remember.' },
+            { type: 'paragraph', text: 'Memory works by meaning, not exact words (this is what "semantic" means). So "What did I decide about auth?" works better than "find my auth decision". If the memory is definitely there but not surfacing, open the memory browser and search — if it is not there, it was never saved in the first place.' },
+            { type: 'heading', level: 3, text: 'Sign-in loops' },
+            { type: 'paragraph', text: 'What you see: you sign in, but Ava keeps asking you to sign in again — a loop that never lets you through.' },
+            { type: 'paragraph', text: 'The fix is to clear the saved sign-in details and start fresh: in the extension run "Ava: Sign Out" from the command palette, in the IDE use Settings → Account → Sign Out, in the CLI delete the file at ~/.ava/auth.json (a small sign-in file in a folder named .ava in your home directory). Then sign in again.' },
+            { type: 'heading', level: 3, text: 'Token exhausted' },
+            { type: 'paragraph', text: 'What you see: a message that you are out of free usage for the month. ("Tokens" are how AI usage is measured — "exhausted" just means you have used up this month\'s free allowance.)' },
+            { type: 'paragraph', text: 'Free-tier monthly budget resets on the 1st of each month. Until then, switch to a BYOK provider (use your own API key) to keep working. Your account remains active — only the free platform-managed requests are paused.' },
+        ],
+    },
+    {
+        id: 'troubleshooting.logs',
+        title: 'Where logs live',
+        audience: ['power'],
+        surfaces: ['web', 'ext', 'ide'],
+        order: 20,
+        section: 'troubleshooting',
+        body: [
+            { type: 'paragraph', text: 'A "log" is just a diary your computer keeps of what happened — useful when something breaks and you (or support) need to see the details.' },
+            { type: 'paragraph', text: 'When you need the raw picture — what tool was called, what information it got, what the AI service returned — the logs are plain text files in a folder on your computer at ~/.ava/logs/ (a folder named .ava in your home directory, with a logs folder inside it).' },
+            { type: 'list', ordered: false, items: [
+                    '~/.ava/logs/session-<date>.log — per-session transcripts including tool calls, streamed responses, and errors.',
+                    '~/.ava/logs/extension.log — VS Code extension host log. Activation failures, panel errors.',
+                    '~/.ava/logs/ide.log — desktop IDE log. Sidecar process messages, Rust panics.',
+                    '~/.ava/logs/cli.log — CLI REPL log.',
+                ] },
+            { type: 'paragraph', text: 'In the extension, "Ava: Show Logs" in the command palette opens the relevant log in an editor tab. In the IDE, Settings → Diagnostics has a "Open Logs" button. The CLI can tail its own log with  ava logs --follow.' },
+            { type: 'callout', variant: 'warning', text: 'Logs may contain snippets of the project files Ava read during a session. Review before sharing.' },
+        ],
+    },
+    {
+        id: 'troubleshooting.support-request',
+        title: 'Filing a support request',
+        audience: ['both'],
+        surfaces: ['web', 'ext', 'ide'],
+        order: 30,
+        section: 'troubleshooting',
+        body: [
+            { type: 'paragraph', text: 'In plain terms: if something is wrong and the fixes above did not help, send us a message about it. The easiest way is to just ask Ava to do it for you.' },
+            { type: 'paragraph', text: 'If a problem is not covered by common errors, file a support ticket (send the support team a request for help). You can do it inside Ava (no form to fill out) or on the web.' },
+            { type: 'heading', level: 3, text: 'From inside Ava' },
+            { type: 'paragraph', text: 'Ask her to file it. "Ava, can you file a support ticket about this?" She calls support_request, attaches the relevant session context (with credentials redacted), and sends it. Fastest path.' },
+            { type: 'heading', level: 3, text: 'From the web' },
+            { type: 'paragraph', text: 'Visit avasupernova.com/support. Pick a category (bug, feature, account, security, general) and describe what happened. Response within one working day.' },
+            { type: 'heading', level: 3, text: 'What to include' },
+            { type: 'list', ordered: false, items: [
+                    'What you were trying to do.',
+                    'What actually happened.',
+                    'Which surface (extension, IDE, CLI, companion) and which version.',
+                    'Any error message or log excerpt. Redact credentials first.',
+                ] },
+        ],
+    },
+    {
+        id: 'troubleshooting.security-disclosure',
+        title: 'Reporting security issues',
+        audience: ['both'],
+        surfaces: ['web', 'ext', 'ide'],
+        order: 40,
+        section: 'troubleshooting',
+        body: [
+            { type: 'paragraph', text: 'In plain terms: if you have spotted a way Ava could be broken into or misused (a "vulnerability" — a security weakness), please tell us privately first so we can fix it before anyone can take advantage. This page is how.' },
+            { type: 'paragraph', text: 'Found a vulnerability? Thank you. We take every report seriously and work with you on the fix before any public disclosure (before the problem is announced publicly).' },
+            { type: 'heading', level: 3, text: 'How to report' },
+            { type: 'list', ordered: true, items: [
+                    'Email security@ava-supernova.com with a description, reproduction steps, and your preferred disclosure window.',
+                    'Or file a support ticket with category "security" — same triage queue.',
+                    'We acknowledge within 24 hours.',
+                ] },
+            { type: 'heading', level: 3, text: 'Our commitments' },
+            { type: 'list', ordered: false, items: [
+                    'Coordinated disclosure — we agree a timeline with you before anything is public. Default is 90 days.',
+                    'Credit — you are credited in the fix notes unless you prefer anonymity.',
+                    'No legal retaliation — good-faith research is welcome. We will not send lawyers after you.',
+                ] },
+            { type: 'callout', variant: 'note', text: 'The security page at avasupernova.com/security has the full posture — architecture guarantees, redactor, permission gates.' },
+        ],
+    },
+];
+//# sourceMappingURL=troubleshooting.js.map

package/dist/docs/content/troubleshooting.js.map

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

package/dist/docs/corpus.d.ts

@@ -0,0 +1,7 @@
+import type { DocPage } from './types.js';
+/** The full corpus, optionally translated. `locale` 'en' (or omitted, or an
+ *  unknown locale) returns English; any other locale returns the corpus with
+ *  translated text and per-block English fallback. */
+export declare function getPages(locale?: string): DocPage[];
+export declare function getPage(id: string, locale?: string): DocPage | undefined;
+//# sourceMappingURL=corpus.d.ts.map

package/dist/docs/corpus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"corpus.d.ts","sourceRoot":"","sources":["../../src/docs/corpus.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAI1C;;sDAEsD;AACtD,wBAAgB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAEnD;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAIxE"}

package/dist/docs/corpus.js

@@ -0,0 +1,18 @@
+// Corpus loader. Pages are authored directly as TypeScript DocPage objects under `content/`
+// so there is no runtime parser to build or maintain and every block is type-checked at write time.
+// Each surface imports `getPages()` and runs it through the filters before rendering.
+import { ALL_PAGES } from './content/index.js';
+import { localizePages } from './i18n.js';
+/** The full corpus, optionally translated. `locale` 'en' (or omitted, or an
+ *  unknown locale) returns English; any other locale returns the corpus with
+ *  translated text and per-block English fallback. */
+export function getPages(locale) {
+    return localizePages(ALL_PAGES, locale);
+}
+export function getPage(id, locale) {
+    const page = ALL_PAGES.find(p => p.id === id);
+    if (!page)
+        return undefined;
+    return localizePages([page], locale)[0];
+}
+//# sourceMappingURL=corpus.js.map

package/dist/docs/corpus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"corpus.js","sourceRoot":"","sources":["../../src/docs/corpus.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,oGAAoG;AACpG,sFAAsF;AAGtF,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C;;sDAEsD;AACtD,MAAM,UAAU,QAAQ,CAAC,MAAe;IACtC,OAAO,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,EAAU,EAAE,MAAe;IACjD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9C,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,OAAO,aAAa,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/dist/docs/data/capabilities.d.ts

@@ -0,0 +1,24 @@
+import type { Capability, Surface } from '../types.js';
+/** Products that can actually run a capability (web excluded — it's the superset site). */
+export type ProductSurface = Exclude<Surface, 'web'>;
+export interface CapabilityFact {
+    id: Capability;
+    /** Plain-language label for badges and the capability reference. */
+    label: string;
+    /** One-line, newcomer-friendly description of what it lets you do. */
+    summary: string;
+    /** Product surfaces where this capability is available. */
+    surfaces: ProductSurface[];
+}
+export declare const CAPABILITIES: CapabilityFact[];
+/** Does a product surface have a given capability? Web always returns true (superset). */
+export declare function surfaceSupports(surface: Surface, capability: Capability): boolean;
+/** The product surfaces where a capability is available (for badges). */
+export declare function surfacesFor(capability: Capability): ProductSurface[];
+/**
+ * The product surfaces where *every* given capability is available — i.e. where
+ * a page requiring all of them actually works. Used to derive "works here"
+ * badges. An empty `caps` list means "everywhere" → all products.
+ */
+export declare function commonSurfaces(caps: Capability[]): ProductSurface[];
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/docs/data/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../src/docs/data/capabilities.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEvD,2FAA2F;AAC3F,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,UAAU,CAAC;IACf,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,eAAO,MAAM,YAAY,EAAE,cAAc,EA+BxC,CAAC;AAMF,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAGjF;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,cAAc,EAAE,CAEpE;AAID;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,cAAc,EAAE,CAGnE"}

package/dist/docs/data/capabilities.js

@@ -0,0 +1,63 @@
+// Canonical capability × surface matrix — the single declared truth for
+// "what works where". A doc page that `requires` a capability auto-hides on any
+// surface that lacks it, and surface badges are derived from this table. So
+// "the extension has no screenshot" is never written by hand — it's derived.
+//
+// Surfaces here are the *products* ('ext' | 'ide' | 'companion' | 'cli'). The
+// public website ('web') is a superset: it shows every page regardless, with
+// per-surface badges, so it is intentionally never listed as a gate below.
+export const CAPABILITIES = [
+    {
+        id: 'desktop_automation',
+        label: 'Desktop automation',
+        summary: 'Ava can open apps, click buttons, and type for you across your whole computer.',
+        surfaces: ['ide'],
+    },
+    {
+        id: 'screenshot',
+        label: 'Screen capture',
+        summary: 'Ava can take and read screenshots of your screen.',
+        surfaces: ['ide'],
+    },
+    {
+        id: 'browser',
+        label: 'Browser automation',
+        summary: 'Ava can drive a real web browser — navigate pages, fill forms, gather information.',
+        surfaces: ['ext', 'ide'],
+    },
+    {
+        id: 'document_authoring',
+        label: 'Document authoring',
+        summary: 'Write mode — Ava drafts real documents and exports branded Word & PDF.',
+        surfaces: ['ext', 'ide'],
+    },
+    {
+        id: 'live_doc_preview',
+        label: 'Live document preview',
+        summary: 'Watch a document render live in the editor as Ava writes it.',
+        surfaces: ['ext', 'ide'],
+    },
+];
+const BY_ID = Object.fromEntries(CAPABILITIES.map(c => [c.id, c]));
+/** Does a product surface have a given capability? Web always returns true (superset). */
+export function surfaceSupports(surface, capability) {
+    if (surface === 'web')
+        return true;
+    return BY_ID[capability]?.surfaces.includes(surface) ?? false;
+}
+/** The product surfaces where a capability is available (for badges). */
+export function surfacesFor(capability) {
+    return BY_ID[capability]?.surfaces ?? [];
+}
+const ALL_PRODUCTS = ['ext', 'ide', 'companion', 'cli'];
+/**
+ * The product surfaces where *every* given capability is available — i.e. where
+ * a page requiring all of them actually works. Used to derive "works here"
+ * badges. An empty `caps` list means "everywhere" → all products.
+ */
+export function commonSurfaces(caps) {
+    if (caps.length === 0)
+        return [...ALL_PRODUCTS];
+    return ALL_PRODUCTS.filter(s => caps.every(c => surfaceSupports(s, c)));
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/docs/data/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../../src/docs/data/capabilities.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,gFAAgF;AAChF,4EAA4E;AAC5E,6EAA6E;AAC7E,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,2EAA2E;AAiB3E,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C;QACE,EAAE,EAAE,oBAAoB;QACxB,KAAK,EAAE,oBAAoB;QAC3B,OAAO,EAAE,gFAAgF;QACzF,QAAQ,EAAE,CAAC,KAAK,CAAC;KAClB;IACD;QACE,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,gBAAgB;QACvB,OAAO,EAAE,mDAAmD;QAC5D,QAAQ,EAAE,CAAC,KAAK,CAAC;KAClB;IACD;QACE,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,oBAAoB;QAC3B,OAAO,EAAE,oFAAoF;QAC7F,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;KACzB;IACD;QACE,EAAE,EAAE,oBAAoB;QACxB,KAAK,EAAE,oBAAoB;QAC3B,OAAO,EAAE,wEAAwE;QACjF,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;KACzB;IACD;QACE,EAAE,EAAE,kBAAkB;QACtB,KAAK,EAAE,uBAAuB;QAC9B,OAAO,EAAE,8DAA8D;QACvE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;KACzB;CACF,CAAC;AAEF,MAAM,KAAK,GAAuC,MAAM,CAAC,WAAW,CAClE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CACK,CAAC;AAExC,0FAA0F;AAC1F,MAAM,UAAU,eAAe,CAAC,OAAgB,EAAE,UAAsB;IACtE,IAAI,OAAO,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,KAAK,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC;AAChE,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,WAAW,CAAC,UAAsB;IAChD,OAAO,KAAK,CAAC,UAAU,CAAC,EAAE,QAAQ,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,YAAY,GAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAkB;IAC/C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,YAAY,CAAC,CAAC;IAChD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1E,CAAC"}

package/dist/docs/data/modes.d.ts

@@ -0,0 +1,11 @@
+export type ModeId = 'work' | 'plan' | 'chat' | 'teach' | 'security' | 'brainstorm' | 'write';
+export interface ModeFact {
+    id: ModeId;
+    prefix: string;
+    displayName: string;
+    mindset: string;
+    usesConductor: boolean | 'conditional';
+    summary: string;
+}
+export declare const MODES: ModeFact[];
+//# sourceMappingURL=modes.d.ts.map

package/dist/docs/data/modes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modes.d.ts","sourceRoot":"","sources":["../../../src/docs/data/modes.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC;AAE9F,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,GAAG,aAAa,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,KAAK,EAAE,QAAQ,EAyD3B,CAAC"}

package/dist/docs/data/modes.js

@@ -0,0 +1,60 @@
+// Canonical fact table for the 7 modes — states of thought.
+export const MODES = [
+    {
+        id: 'work',
+        prefix: '>>',
+        displayName: 'Code',
+        mindset: 'Builder — full tool access, executes plans with precision.',
+        usesConductor: 'conditional',
+        summary: 'Write code, run tests, ship changes. Simple tasks run directly; complex multi-file or architecture work triggers the persona conductor.',
+    },
+    {
+        id: 'plan',
+        prefix: '::',
+        displayName: 'Plan',
+        mindset: 'Architect — evidence-based proposals, no code changes.',
+        usesConductor: true,
+        summary: 'Read-only. Researches, designs approaches, challenges assumptions, and presents a plan for your approval before any execution.',
+    },
+    {
+        id: 'chat',
+        prefix: '..',
+        displayName: 'Chat',
+        mindset: 'Friend — personal conversation, off the clock.',
+        usesConductor: false,
+        summary: 'Open conversation with memory, search, journal, weather, and news. No personas, no orchestration — just Ava.',
+    },
+    {
+        id: 'teach',
+        prefix: '??',
+        displayName: 'Teach',
+        mindset: 'Tutor — Socratic guidance, adaptive to pace.',
+        usesConductor: true,
+        summary: 'Build curriculums, deliver lessons, run quizzes, track progress. Five specialists run the teaching loop.',
+    },
+    {
+        id: 'security',
+        prefix: '!!',
+        displayName: 'Security',
+        mindset: 'Auditor — systematic vulnerability scanning, paranoia as a virtue.',
+        usesConductor: true,
+        summary: 'Five-persona security team: recon, scan, CVE research, verify, report. OWASP and dependency CVE coverage end-to-end.',
+    },
+    {
+        id: 'brainstorm',
+        prefix: '**',
+        displayName: 'Brainstorm',
+        mindset: 'Ideator — grounded ideas, actionable paths.',
+        usesConductor: true,
+        summary: 'Mines your context, researches the market, generates specific ideas, challenges them, and refines the survivors into next steps.',
+    },
+    {
+        id: 'write',
+        prefix: '<<',
+        displayName: 'Write',
+        mindset: 'Author — compose, edit, and design real documents.',
+        usesConductor: false,
+        summary: 'Author reports, proposals, articles and more in Markdown, then export branded Word/PDF. Start from a template, refine section by section, see it live. No code — just writing.',
+    },
+];
+//# sourceMappingURL=modes.js.map

package/dist/docs/data/modes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modes.js","sourceRoot":"","sources":["../../../src/docs/data/modes.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAa5D,MAAM,CAAC,MAAM,KAAK,GAAe;IAC/B;QACE,EAAE,EAAE,MAAM;QACV,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,4DAA4D;QACrE,aAAa,EAAE,aAAa;QAC5B,OAAO,EAAE,yIAAyI;KACnJ;IACD;QACE,EAAE,EAAE,MAAM;QACV,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,wDAAwD;QACjE,aAAa,EAAE,IAAI;QACnB,OAAO,EAAE,gIAAgI;KAC1I;IACD;QACE,EAAE,EAAE,MAAM;QACV,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,gDAAgD;QACzD,aAAa,EAAE,KAAK;QACpB,OAAO,EAAE,8GAA8G;KACxH;IACD;QACE,EAAE,EAAE,OAAO;QACX,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,OAAO;QACpB,OAAO,EAAE,8CAA8C;QACvD,aAAa,EAAE,IAAI;QACnB,OAAO,EAAE,0GAA0G;KACpH;IACD;QACE,EAAE,EAAE,UAAU;QACd,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,UAAU;QACvB,OAAO,EAAE,oEAAoE;QAC7E,aAAa,EAAE,IAAI;QACnB,OAAO,EAAE,sHAAsH;KAChI;IACD;QACE,EAAE,EAAE,YAAY;QAChB,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,YAAY;QACzB,OAAO,EAAE,6CAA6C;QACtD,aAAa,EAAE,IAAI;QACnB,OAAO,EAAE,kIAAkI;KAC5I;IACD;QACE,EAAE,EAAE,OAAO;QACX,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,OAAO;QACpB,OAAO,EAAE,oDAAoD;QAC7D,aAAa,EAAE,KAAK;QACpB,OAAO,EAAE,gLAAgL;KAC1L;CACF,CAAC"}

package/dist/docs/data/permissions.d.ts

@@ -0,0 +1,12 @@
+import type { ToolCategory } from './tools.js';
+export type PermissionMode = 'strict' | 'balanced' | 'autonomous' | 'custom';
+export type CategoryPermission = 'always_ask' | 'first_time' | 'auto';
+export interface PermissionModeFact {
+    id: Exclude<PermissionMode, 'custom'>;
+    displayName: string;
+    summary: string;
+    categories: Record<ToolCategory, CategoryPermission>;
+}
+export declare const PERMISSION_MODES: PermissionModeFact[];
+export declare const PERMISSION_LABELS: Record<CategoryPermission, string>;
+//# sourceMappingURL=permissions.d.ts.map

package/dist/docs/data/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/docs/data/permissions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,QAAQ,CAAC;AAC7E,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,YAAY,GAAG,MAAM,CAAC;AAEtE,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;CACtD;AAED,eAAO,MAAM,gBAAgB,EAAE,kBAAkB,EAoDhD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAIhE,CAAC"}