@project-ava-supernova/core 0.2.71

package/dist/docs/data/tools.js

@@ -0,0 +1,100 @@
+// Canonical tool fact table — single source of truth for the user-facing
+// built-in tools documented here. (The full registry also includes IDE-only
+// desktop-automation, browser-automation, and internal infrastructure tools
+// that aren't part of this user-facing catalogue.)
+// Rendered by the website, extension DocsPanel, and IDE DocumentationPage.
+// Update here when tools are added/renamed/recategorised, not in any surface renderer.
+export const TOOLS = [
+    { name: 'analyze_architecture', category: 'file_ops', description: 'Analyse project architecture — dependency graph, circular imports, coupling hotspots, file metrics.', risk: 'safe' },
+    { name: 'apply_plan', category: 'documents', description: 'Apply a batch of file edits atomically with a git checkpoint for safe rollback.', risk: 'write' },
+    { name: 'ask_user', category: 'system', description: 'Ask the user a question and wait for their response.', risk: 'safe' },
+    { name: 'audit_dependencies', category: 'system', description: 'Run a security audit on project dependencies and report vulnerabilities.', risk: 'safe' },
+    { name: 'bash', category: 'shell', description: 'Execute shell commands with output capture, error handling, and safety sandboxing.', risk: 'dangerous' },
+    { name: 'benchmark', category: 'shell', description: 'Run a command and measure execution time, optionally comparing against a stored baseline.', risk: 'safe' },
+    { name: 'browse_library', category: 'file_ops', description: 'Browse the project creative asset library — images, videos, audio, documents.', risk: 'safe' },
+    { name: 'browser', category: 'web', description: 'Automate browser interactions — navigate, click, fill, screenshot, extract text, run JS.', risk: 'dangerous' },
+    { name: 'conversation_recall', category: 'memory', description: 'Search earlier in the current conversation, including turns compressed out of working context, to recall what was said or decided.', risk: 'safe' },
+    { name: 'curator', category: 'system', description: 'Consult the Curator specialist for a design or taste decision.', risk: 'safe' },
+    { name: 'database_query', category: 'database', description: 'Execute read-only database queries and visualise results in tables.', risk: 'dangerous' },
+    { name: 'debug_logs', category: 'shell', description: 'Read and filter log files or command output for debugging.', risk: 'safe' },
+    { name: 'design_brand_kit', category: 'media', description: 'Read or update the user\'s brand kit (palette and style words) so generated icons stay on-brand.', risk: 'write' },
+    { name: 'design_find_shape', category: 'media', description: 'Find a known-good Lucide shape to use as an icon\'s armature, so the result reads as the intended subject.', risk: 'safe' },
+    { name: 'design_generate_icon', category: 'media', description: 'Generate one on-brand icon from a shape armature (Lucide → image model → transparent matte), with material and colour.', risk: 'write' },
+    { name: 'design_generate_image', category: 'media', description: 'Generate a free-form full-frame image on the Design Studio canvas from a prompt — no armature, no matte.', risk: 'write' },
+    { name: 'design_generate_set', category: 'media', description: 'Generate a matched set of 2–12 icons with material, colour, and lighting held constant so they read as a family.', risk: 'write' },
+    { name: 'design_generate_video', category: 'media', description: 'Generate a short 5s or 10s video on the Design Studio canvas from a prompt, via Wan.', risk: 'write' },
+    { name: 'design_generate_voice', category: 'media', description: 'Generate a spoken voiceover on the Design Studio canvas via Qwen3-TTS, from a script and a chosen voice.', risk: 'write' },
+    { name: 'design_save', category: 'media', description: 'Save the icon currently on the canvas to the local creative library as a transparent PNG.', risk: 'write' },
+    { name: 'detect_language', category: 'system', description: 'Detect the human language of a text snippet from 20+ supported languages.', risk: 'safe' },
+    { name: 'doc_generate', category: 'documents', description: 'Generate project documentation (README, API docs, architecture overview) from source code.', risk: 'write' },
+    { name: 'docs_lookup', category: 'file_ops', description: 'Search Ava documentation to help users with features, setup, and troubleshooting.', risk: 'safe' },
+    { name: 'document_author', category: 'documents', description: 'Author and edit prose documents (Markdown source → branded Word/PDF), non-destructive and section-surgical. Powers Write mode.', risk: 'write' },
+    { name: 'document_manage', category: 'documents', description: 'Create, read, edit, and export documents (Word, Excel, PDF, CSV, Markdown).', risk: 'write' },
+    { name: 'email_draft', category: 'documents', description: 'Draft an email with structured content, tone control, and .docx file output.', risk: 'safe' },
+    { name: 'env_write', category: 'system', description: 'Write a granted secret to the project env file. Hard-fails if the env file is not in .gitignore.', risk: 'write' },
+    { name: 'file_edit', category: 'file_ops', description: 'Replace an exact string in a file with new content.', risk: 'write' },
+    { name: 'file_read', category: 'file_ops', description: 'Read the contents of a file with line numbers.', risk: 'safe' },
+    { name: 'file_write', category: 'file_ops', description: 'Create or overwrite a file with the given content.', risk: 'write' },
+    { name: 'find_symbol', category: 'file_ops', description: 'Find where functions, classes, types, and other symbols are defined or referenced.', risk: 'safe' },
+    { name: 'get_datetime', category: 'system', description: 'Get the current date, time, and timezone from the host system.', risk: 'safe' },
+    { name: 'git_commit', category: 'git', description: 'Stage and commit changes with an auto-generated or custom commit message.', risk: 'write' },
+    { name: 'git_create_pr', category: 'git', description: 'Create a GitHub pull request from the current branch with an auto-generated title and description.', risk: 'write' },
+    { name: 'git_diff', category: 'git', description: 'Show formatted git diffs with structured modes (staged, unstaged, all, branch).', risk: 'safe' },
+    { name: 'git_status', category: 'git', description: 'Run read-only git commands (status, diff, log, branch, show).', risk: 'safe' },
+    { name: 'glob', category: 'file_ops', description: 'Find files matching a glob pattern.', risk: 'safe' },
+    { name: 'grep', category: 'file_ops', description: 'Search file contents using regex patterns.', risk: 'safe' },
+    { name: 'health_catalogue_search', category: 'documents', description: 'Search the exercise and recipe catalogue for the slugs used to build health plan days.', risk: 'safe' },
+    { name: 'health_plan_create', category: 'documents', description: 'Create a health plan — meal, fitness, or combined — of 1, 3 or 7 days, saved to the local plan library.', risk: 'write' },
+    { name: 'health_plan_delete', category: 'documents', description: 'Permanently delete a health plan the user has asked to be rid of. Refuses once any meal or session has been logged against it — those are archived, never destroyed.', risk: 'dangerous' },
+    { name: 'health_plan_list', category: 'documents', description: 'List existing health plans with their dates, so a new plan never displaces one already running without saying so.', risk: 'safe' },
+    { name: 'health_plan_update', category: 'documents', description: 'Change an existing plan\'s title, goal, status or start date — including activating or archiving it.', risk: 'write' },
+    { name: 'health_plan_update_day', category: 'documents', description: 'Change a single day of an existing health plan.', risk: 'write' },
+    { name: 'health_profile_ask', category: 'documents', description: 'Ask the user to fill one health-profile field via a structured control (goal cards, equipment chips, a number box) and save it.', risk: 'safe' },
+    { name: 'http_request', category: 'web', description: 'Make HTTP requests (GET, POST, etc.) with automatic retries and response parsing.', risk: 'dangerous' },
+    { name: 'journal_write', category: 'documents', description: 'Write to the dual journal — Ava session observations and the user reflection log.', risk: 'safe' },
+    { name: 'learning_create', category: 'learning', description: 'Create a structured learning curriculum with modules and lessons for the user.', risk: 'write' },
+    { name: 'learning_progress', category: 'learning', description: 'View learning progress, list curriculums, find next lesson, check review schedule, or search learning content.', risk: 'safe' },
+    { name: 'learning_teach', category: 'learning', description: 'Deliver a lesson, write teaching content, give feedback, run a quiz, or trigger a review.', risk: 'write' },
+    { name: 'list_directory', category: 'file_ops', description: 'List the contents of a directory with file types and sizes.', risk: 'safe' },
+    { name: 'memory_delete', category: 'memory', description: 'Delete a specific memory entry by ID.', risk: 'safe' },
+    { name: 'memory_recall', category: 'memory', description: 'Search persistent memory for information from past conversations using semantic queries.', risk: 'safe' },
+    { name: 'memory_save', category: 'memory', description: 'Save information to persistent memory that survives across conversations.', risk: 'safe' },
+    { name: 'memory_update', category: 'memory', description: 'Update an existing memory entry by ID.', risk: 'safe' },
+    { name: 'news', category: 'web', description: 'Fetch curated tech and AI news, filterable by category or keyword.', risk: 'safe' },
+    { name: 'open_design_studio', category: 'media', description: 'Open the focused Design Studio for the user to make an icon or on-brand asset — shows a one-tap button rather than generating in chat.', risk: 'safe' },
+    { name: 'open_health_room', category: 'documents', description: 'Open the focused Health room for the user to build a fitness, meal, or combined plan — shows a button rather than building in chat.', risk: 'safe' },
+    { name: 'open_learning_room', category: 'learning', description: 'Open the focused Learning room for the user to build a study plan and start a guided course — shows a button rather than teaching in chat.', risk: 'safe' },
+    { name: 'paper_fetch_full_text', category: 'web', description: 'Fetch a scientific paper (title, authors, abstract, and section-extracted body when available) from arXiv, OpenAlex, or Crossref. Powers the Library.', risk: 'safe' },
+    { name: 'present_plan', category: 'documents', description: 'Present a structured plan for the user to review and approve before execution.', risk: 'write' },
+    { name: 'project_index', category: 'file_ops', description: 'Scan, refresh, or display the project structure index.', risk: 'safe' },
+    { name: 'propose_tool', category: 'system', description: 'Propose a new tool to the development team when a capability gap is hit.', risk: 'write' },
+    { name: 'release_notes', category: 'web', description: 'Fetch published release notes for Ava Supernova.', risk: 'safe' },
+    { name: 'remove_background', category: 'media', description: 'Remove the background from an image, making it transparent.', risk: 'write' },
+    { name: 'report_generate', category: 'documents', description: 'Generate a structured .docx report from tasks, journal, memory, and project data.', risk: 'write' },
+    { name: 'rollback', category: 'git', description: 'Restore, discard, or check the status of a git checkpoint.', risk: 'dangerous' },
+    { name: 'secret_request', category: 'system', description: 'Request access to a secret from the user vault. Returns an opaque handle the host substitutes at execution time.', risk: 'safe' },
+    { name: 'self_inspect', category: 'file_ops', description: 'Read Ava own source code when the actual implementation needs to be quoted or examined.', risk: 'safe' },
+    { name: 'support_request', category: 'system', description: 'Submit a support ticket to the Ava development team.', risk: 'write' },
+    { name: 'switch_mode', category: 'documents', description: 'Offer to transition to a different mode when the current mode work is complete.', risk: 'safe' },
+    { name: 'task_manage', category: 'documents', description: 'Manage the personal task list — list, create, complete, update, delete.', risk: 'safe' },
+    { name: 'task_suggest', category: 'documents', description: 'Offer the user a task you noticed as a card they can add, edit, or dismiss — never writes to their list without a tap.', risk: 'safe' },
+    { name: 'test_generate', category: 'shell', description: 'Generate test scaffolding for a source file using the detected test framework.', risk: 'write' },
+    { name: 'test_run', category: 'shell', description: 'Detect the project test framework and run tests (full suite or specific file).', risk: 'safe' },
+    { name: 'todo_write', category: 'documents', description: 'Create or update a visual task list for tracking progress in the current session.', risk: 'safe' },
+    { name: 'weather', category: 'web', description: 'Get current weather and 3-day forecast. Auto-detects location if none specified.', risk: 'safe' },
+    { name: 'web_search', category: 'web', description: 'Search the web for current information.', risk: 'safe' },
+];
+export const CATEGORY_LABELS = {
+    file_ops: 'File operations',
+    shell: 'Shell',
+    git: 'Git',
+    web: 'Web',
+    media: 'Media',
+    database: 'Database',
+    system: 'System',
+    documents: 'Documents',
+    memory: 'Memory',
+    learning: 'Learning',
+};
+export const TOTAL_TOOL_COUNT = TOOLS.length;
+//# sourceMappingURL=tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/docs/data/tools.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,4EAA4E;AAC5E,4EAA4E;AAC5E,mDAAmD;AACnD,2EAA2E;AAC3E,uFAAuF;AAevF,MAAM,CAAC,MAAM,KAAK,GAAe;IAC/B,EAAE,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,qGAAqG,EAAE,IAAI,EAAE,MAAM,EAAE;IACxL,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,iFAAiF,EAAE,IAAI,EAAE,OAAO,EAAE;IAC5J,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,sDAAsD,EAAE,IAAI,EAAE,MAAM,EAAE;IAC3H,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,0EAA0E,EAAE,IAAI,EAAE,MAAM,EAAE;IACzJ,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,oFAAoF,EAAE,IAAI,EAAE,WAAW,EAAE;IACzJ,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,2FAA2F,EAAE,IAAI,EAAE,MAAM,EAAE;IAChK,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,+EAA+E,EAAE,IAAI,EAAE,MAAM,EAAE;IAC5J,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,0FAA0F,EAAE,IAAI,EAAE,WAAW,EAAE;IAChK,EAAE,IAAI,EAAE,qBAAqB,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,oIAAoI,EAAE,IAAI,EAAE,MAAM,EAAE;IACpN,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,gEAAgE,EAAE,IAAI,EAAE,MAAM,EAAE;IACpI,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,qEAAqE,EAAE,IAAI,EAAE,WAAW,EAAE;IACvJ,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,4DAA4D,EAAE,IAAI,EAAE,MAAM,EAAE;IAClI,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,kGAAkG,EAAE,IAAI,EAAE,OAAO,EAAE;IAC/K,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,4GAA4G,EAAE,IAAI,EAAE,MAAM,EAAE;IACzL,EAAE,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,wHAAwH,EAAE,IAAI,EAAE,OAAO,EAAE;IACzM,EAAE,IAAI,EAAE,uBAAuB,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,0GAA0G,EAAE,IAAI,EAAE,OAAO,EAAE;IAC5L,EAAE,IAAI,EAAE,qBAAqB,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,kHAAkH,EAAE,IAAI,EAAE,OAAO,EAAE;IAClM,EAAE,IAAI,EAAE,uBAAuB,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,sFAAsF,EAAE,IAAI,EAAE,OAAO,EAAE;IACxK,EAAE,IAAI,EAAE,uBAAuB,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,0GAA0G,EAAE,IAAI,EAAE,OAAO,EAAE;IAC5L,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,2FAA2F,EAAE,IAAI,EAAE,OAAO,EAAE;IACnK,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,2EAA2E,EAAE,IAAI,EAAE,MAAM,EAAE;IACvJ,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,4FAA4F,EAAE,IAAI,EAAE,OAAO,EAAE;IACzK,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,mFAAmF,EAAE,IAAI,EAAE,MAAM,EAAE;IAC7J,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,gIAAgI,EAAE,IAAI,EAAE,OAAO,EAAE;IAChN,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,6EAA6E,EAAE,IAAI,EAAE,OAAO,EAAE;IAC7J,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,8EAA8E,EAAE,IAAI,EAAE,MAAM,EAAE;IACzJ,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,kGAAkG,EAAE,IAAI,EAAE,OAAO,EAAE;IACzK,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,qDAAqD,EAAE,IAAI,EAAE,OAAO,EAAE;IAC9H,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,gDAAgD,EAAE,IAAI,EAAE,MAAM,EAAE;IACxH,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,oDAAoD,EAAE,IAAI,EAAE,OAAO,EAAE;IAC9H,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,oFAAoF,EAAE,IAAI,EAAE,MAAM,EAAE;IAC9J,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,gEAAgE,EAAE,IAAI,EAAE,MAAM,EAAE;IACzI,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,2EAA2E,EAAE,IAAI,EAAE,OAAO,EAAE;IAChJ,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,oGAAoG,EAAE,IAAI,EAAE,OAAO,EAAE;IAC5K,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,iFAAiF,EAAE,IAAI,EAAE,MAAM,EAAE;IACnJ,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,+DAA+D,EAAE,IAAI,EAAE,MAAM,EAAE;IACnI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,qCAAqC,EAAE,IAAI,EAAE,MAAM,EAAE;IACxG,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,4CAA4C,EAAE,IAAI,EAAE,MAAM,EAAE;IAC/G,EAAE,IAAI,EAAE,yBAAyB,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,wFAAwF,EAAE,IAAI,EAAE,MAAM,EAAE;IAC/K,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,yGAAyG,EAAE,IAAI,EAAE,OAAO,EAAE;IAC5L,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,sKAAsK,EAAE,IAAI,EAAE,WAAW,EAAE;IAC7P,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,mHAAmH,EAAE,IAAI,EAAE,MAAM,EAAE;IACnM,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,sGAAsG,EAAE,IAAI,EAAE,OAAO,EAAE;IACzL,EAAE,IAAI,EAAE,wBAAwB,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,iDAAiD,EAAE,IAAI,EAAE,OAAO,EAAE;IACxI,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,iIAAiI,EAAE,IAAI,EAAE,MAAM,EAAE;IACnN,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,mFAAmF,EAAE,IAAI,EAAE,WAAW,EAAE;IAC9J,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,mFAAmF,EAAE,IAAI,EAAE,MAAM,EAAE;IAChK,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,gFAAgF,EAAE,IAAI,EAAE,OAAO,EAAE;IAC/J,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,gHAAgH,EAAE,IAAI,EAAE,MAAM,EAAE;IAChM,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,2FAA2F,EAAE,IAAI,EAAE,OAAO,EAAE;IACzK,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,6DAA6D,EAAE,IAAI,EAAE,MAAM,EAAE;IAC1I,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE,IAAI,EAAE,MAAM,EAAE;IACjH,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,0FAA0F,EAAE,IAAI,EAAE,MAAM,EAAE;IACpK,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,2EAA2E,EAAE,IAAI,EAAE,MAAM,EAAE;IACnJ,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,wCAAwC,EAAE,IAAI,EAAE,MAAM,EAAE;IAClH,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,oEAAoE,EAAE,IAAI,EAAE,MAAM,EAAE;IAClI,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,wIAAwI,EAAE,IAAI,EAAE,MAAM,EAAE;IACtN,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,qIAAqI,EAAE,IAAI,EAAE,MAAM,EAAE;IACrN,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,4IAA4I,EAAE,IAAI,EAAE,MAAM,EAAE;IAC7N,EAAE,IAAI,EAAE,uBAAuB,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,uJAAuJ,EAAE,IAAI,EAAE,MAAM,EAAE;IACtO,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,gFAAgF,EAAE,IAAI,EAAE,OAAO,EAAE;IAC7J,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,wDAAwD,EAAE,IAAI,EAAE,MAAM,EAAE;IACpI,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,0EAA0E,EAAE,IAAI,EAAE,OAAO,EAAE;IACpJ,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,kDAAkD,EAAE,IAAI,EAAE,MAAM,EAAE;IACzH,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,6DAA6D,EAAE,IAAI,EAAE,OAAO,EAAE;IAC3I,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,mFAAmF,EAAE,IAAI,EAAE,OAAO,EAAE;IACnK,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,4DAA4D,EAAE,IAAI,EAAE,WAAW,EAAE;IACnI,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,kHAAkH,EAAE,IAAI,EAAE,MAAM,EAAE;IAC7L,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,yFAAyF,EAAE,IAAI,EAAE,MAAM,EAAE;IACpK,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,sDAAsD,EAAE,IAAI,EAAE,OAAO,EAAE;IACnI,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,iFAAiF,EAAE,IAAI,EAAE,MAAM,EAAE;IAC5J,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,yEAAyE,EAAE,IAAI,EAAE,MAAM,EAAE;IACpJ,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,wHAAwH,EAAE,IAAI,EAAE,MAAM,EAAE;IACpM,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,gFAAgF,EAAE,IAAI,EAAE,OAAO,EAAE;IAC1J,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,gFAAgF,EAAE,IAAI,EAAE,MAAM,EAAE;IACpJ,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,mFAAmF,EAAE,IAAI,EAAE,MAAM,EAAE;IAC7J,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,kFAAkF,EAAE,IAAI,EAAE,MAAM,EAAE;IACnJ,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,yCAAyC,EAAE,IAAI,EAAE,MAAM,EAAE;CAC9G,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAiC;IAC3D,QAAQ,EAAE,iBAAiB;IAC3B,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;CACrB,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,CAAC"}

package/dist/docs/filter.d.ts

@@ -0,0 +1,35 @@
+import type { DocPage, Surface, SidebarNode } from './types.js';
+/**
+ * Keep only pages that should render on this surface.
+ * A page with surfaces: ['web', 'ide'] is hidden from the extension.
+ */
+export declare function filterBySurface(pages: DocPage[], surface: Surface): DocPage[];
+/**
+ * Drop pages whose required capabilities the surface doesn't have. So a page
+ * tagged `requires: ['screenshot']` is hidden on the extension (no screen
+ * capture) but shown on the IDE — derived from the capability matrix, never
+ * written by hand. The public website ('web') is the superset: it always keeps
+ * every page (the surface badges say where each one applies).
+ */
+export declare function filterByCapability(pages: DocPage[], surface: Surface): DocPage[];
+/**
+ * The full surface gate every renderer should apply: a page must render on the
+ * surface AND have its required capabilities there.
+ */
+export declare function filterForSurface(pages: DocPage[], surface: Surface): DocPage[];
+/**
+ * Keep only pages matching the current audience mode.
+ *   'everything' → show all pages
+ *   'newcomer'   → hide pages tagged power-only (but keep 'both' and 'newcomer')
+ *
+ * Power-only pages are the Reference section by default. A page tagged
+ * ['newcomer', 'power'] or ['both'] shows in both modes.
+ */
+export declare function filterByAudience(pages: DocPage[], mode: 'newcomer' | 'everything'): DocPage[];
+/**
+ * Build the sidebar tree: sections in the canonical order, pages within each section sorted by `order`.
+ */
+export declare function buildSidebar(pages: DocPage[]): SidebarNode[];
+/** Convert a page id into a URL anchor fragment. */
+export declare function anchorFor(pageId: string): string;
+//# sourceMappingURL=filter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/docs/filter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAY,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI1E;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,CAE7E;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,CAKhF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,CAE9E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EAAE,EAChB,IAAI,EAAE,UAAU,GAAG,YAAY,GAC9B,OAAO,EAAE,CAGX;AAOD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE,CAY5D;AAED,oDAAoD;AACpD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/docs/filter.js

@@ -0,0 +1,68 @@
+// Audience + surface filtering. Used by every surface renderer before displaying pages.
+import { SECTION_LABELS, SECTION_ORDER } from './types.js';
+import { surfaceSupports } from './data/capabilities.js';
+/**
+ * Keep only pages that should render on this surface.
+ * A page with surfaces: ['web', 'ide'] is hidden from the extension.
+ */
+export function filterBySurface(pages, surface) {
+    return pages.filter(p => p.surfaces.includes(surface));
+}
+/**
+ * Drop pages whose required capabilities the surface doesn't have. So a page
+ * tagged `requires: ['screenshot']` is hidden on the extension (no screen
+ * capture) but shown on the IDE — derived from the capability matrix, never
+ * written by hand. The public website ('web') is the superset: it always keeps
+ * every page (the surface badges say where each one applies).
+ */
+export function filterByCapability(pages, surface) {
+    if (surface === 'web')
+        return pages;
+    return pages.filter(p => !p.requires || p.requires.every(cap => surfaceSupports(surface, cap)));
+}
+/**
+ * The full surface gate every renderer should apply: a page must render on the
+ * surface AND have its required capabilities there.
+ */
+export function filterForSurface(pages, surface) {
+    return filterByCapability(filterBySurface(pages, surface), surface);
+}
+/**
+ * Keep only pages matching the current audience mode.
+ *   'everything' → show all pages
+ *   'newcomer'   → hide pages tagged power-only (but keep 'both' and 'newcomer')
+ *
+ * Power-only pages are the Reference section by default. A page tagged
+ * ['newcomer', 'power'] or ['both'] shows in both modes.
+ */
+export function filterByAudience(pages, mode) {
+    if (mode === 'everything')
+        return pages;
+    return pages.filter(p => !isPowerOnly(p.audience));
+}
+function isPowerOnly(audience) {
+    if (audience.length === 0)
+        return false;
+    return audience.every(a => a === 'power');
+}
+/**
+ * Build the sidebar tree: sections in the canonical order, pages within each section sorted by `order`.
+ */
+export function buildSidebar(pages) {
+    return SECTION_ORDER
+        .map(section => ({
+        id: section,
+        title: SECTION_LABELS[section],
+        section,
+        pages: pages
+            .filter(p => p.section === section)
+            .sort((a, b) => a.order - b.order)
+            .map(p => ({ id: p.id, title: p.title, audience: p.audience, anchor: anchorFor(p.id) })),
+    }))
+        .filter(node => node.pages.length > 0);
+}
+/** Convert a page id into a URL anchor fragment. */
+export function anchorFor(pageId) {
+    return pageId.replace(/\./g, '-');
+}
+//# sourceMappingURL=filter.js.map

package/dist/docs/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../src/docs/filter.ts"],"names":[],"mappings":"AAAA,wFAAwF;AAGxF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAgB,EAAE,OAAgB;IAChE,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAgB,EAAE,OAAgB;IACnE,IAAI,OAAO,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IACpC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACtB,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CACtE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAgB,EAAE,OAAgB;IACjE,OAAO,kBAAkB,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAgB,EAChB,IAA+B;IAE/B,IAAI,IAAI,KAAK,YAAY;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,WAAW,CAAC,QAAoB;IACvC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAgB;IAC3C,OAAO,aAAa;SACjB,GAAG,CAAc,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5B,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC;QAC9B,OAAO;QACP,KAAK,EAAE,KAAK;aACT,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC;aAClC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;aACjC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;KAC3F,CAAC,CAAC;SACF,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACpC,CAAC"}

package/dist/docs/i18n/translations.d.ts

@@ -0,0 +1,2 @@
+export declare const DOC_TRANSLATIONS: Record<string, Record<string, string>>;
+//# sourceMappingURL=translations.d.ts.map

package/dist/docs/i18n/translations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../src/docs/i18n/translations.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAki6hD,CAAC"}