Jakob Wennberg
a894af11d0
* feat(mcp): tool titles + Connect-with-Claude docs for Connectors Directory readiness Add a top-level Tool.title (MCP spec 2025-06-18) to all 92 MCP tools and flow it through the tools/list serializer for the Claude Connectors Directory. Trim the ~10 longest tool descriptions toward 180-200 chars (semantics + agent hints preserved) to partly offset the added bytes, and raise the payload-size bench ceiling 32K → 36K with headroom reserved for upcoming Skatteverket tools. Ship a "Connect with Claude" docs page (OAuth 2.1 connector + npx gnubok-mcp stdio bridge, sample sandbox prompts, 10-minute reviewer test, support pointer), wire it into the docs nav, and add a README to the packages/gnubok-mcp npm bridge. Bump one categorized sandbox business expense above 4 000 kr so the VAT close-check demo surfaces a high-value receipt-less expense. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(mcp): restore six spaces lost in the description-trimming pass Review finding (Greptile P2): the trim deleted single spaces in six tool descriptions ("Stages foruser", "länkatill", "kundfordran(1510)", …), producing malformed text in tools/list. All six were pure space deletions with no token gain — restored verbatim. Swept all 92 descriptions for residual merge artifacts; the two remaining matches are pre-existing function-call notation from main. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * docs(compliance): correct BFL citation in seed + mark 4000 kr as app heuristic Swedish compliance review findings: - The seed comment cited BFL 5 kap 6§ as requiring verifikat on high-value affärshändelser; 6§ governs verifikationens innehåll. Rephrased: BFL 5 kap 6-7§ require every affärshändelse to be documented — the 4 000 kr cut-off is the tool's own heuristic, not a statutory threshold. - The connect-claude docs read as though 4 000 kr were a legal floor (conflatable with the förenklad faktura ceiling, ML 17 kap 26-28§). Clarified that BFL requires underlag regardless of amount. Dismissed as by-design: the gnubok_sk_test_... README placeholders (standard practice; the prefix schema is already public in llms.txt). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
89 lines
4.9 KiB
TypeScript
89 lines
4.9 KiB
TypeScript
/**
|
||
* Single source of truth for the /docs/api sidebar navigation.
|
||
*
|
||
* Stripe-pattern grouping: top-level sections (Getting started, Cookbooks,
|
||
* API reference, Concepts, Errors, Changelog) with nested links. Used by
|
||
* the DocsLayout sidebar AND by the landing page resource grid AND by the
|
||
* /llms-full.txt aggregator so additions land in every surface from one
|
||
* edit.
|
||
*/
|
||
|
||
export interface DocsNavLink {
|
||
label: string
|
||
href: string
|
||
/** Optional one-line summary shown on landing-page cards. */
|
||
summary?: string
|
||
}
|
||
|
||
export interface DocsNavSection {
|
||
label: string
|
||
links: DocsNavLink[]
|
||
}
|
||
|
||
export const DOCS_NAV: DocsNavSection[] = [
|
||
{
|
||
label: 'Getting started',
|
||
links: [
|
||
{ label: 'Introduction', href: '/docs/api', summary: 'What the Accounted REST API is and how to authenticate.' },
|
||
{ label: 'Quickstart', href: '/docs/api/cookbook/quickstart', summary: 'Send your first invoice in five minutes.' },
|
||
{ label: 'Authentication', href: '/docs/api#authentication', summary: 'API keys, scopes, test mode.' },
|
||
{ label: 'Connect with Claude', href: '/docs/api/connect-claude', summary: 'Connect Claude via the MCP server — OAuth connector or npx gnubok-mcp bridge.' },
|
||
],
|
||
},
|
||
{
|
||
label: 'Cookbooks',
|
||
links: [
|
||
{ label: 'Send your first invoice', href: '/docs/api/cookbook/send-first-invoice', summary: 'Create a customer, draft an invoice, send it, mark it paid.' },
|
||
{ label: 'Ingest and categorise bank transactions', href: '/docs/api/cookbook/ingest-bank-transactions', summary: 'Push CSV/CAMT into the engine, get AI suggestions, commit.' },
|
||
{ label: 'Compute and review a VAT declaration', href: '/docs/api/cookbook/file-vat-declaration', summary: 'Compute momsdeklaration rutor 05–62 and reconcile before manual Skatteverket submission.' },
|
||
{ label: 'Run payroll and generate AGI', href: '/docs/api/cookbook/run-payroll-and-agi', summary: 'Calculate, approve, mark paid, book, generate AGI XML for manual Skatteverket upload.' },
|
||
{ label: 'Set up webhooks and verify signatures', href: '/docs/api/cookbook/webhooks', summary: 'Subscribe to events, verify HMAC, handle retries idempotently.' },
|
||
{ label: 'Year-end closing', href: '/docs/api/cookbook/year-end-closing', summary: 'Lock periods, run year-end, set opening balances.' },
|
||
],
|
||
},
|
||
{
|
||
label: 'Concepts',
|
||
links: [
|
||
{ label: 'Webhooks', href: '/docs/api/webhooks', summary: 'Event types, delivery model, retries, signature verification.' },
|
||
{ label: 'Versioning', href: '/docs/api/versioning', summary: 'How API versions are pinned, upgraded, and deprecated.' },
|
||
{ label: 'Idempotency', href: '/docs/api/versioning#idempotency', summary: 'Safe retries on every write via Idempotency-Key.' },
|
||
{ label: 'Dry-run', href: '/docs/api/versioning#dry-run', summary: 'Preview every write before committing.' },
|
||
],
|
||
},
|
||
{
|
||
label: 'API reference',
|
||
links: [
|
||
{ label: 'Overview', href: '/docs/api/reference', summary: 'All resources, grouped by domain.' },
|
||
{ label: 'Companies', href: '/docs/api/reference/companies' },
|
||
{ label: 'Customers', href: '/docs/api/reference/customers' },
|
||
{ label: 'Invoices', href: '/docs/api/reference/invoices' },
|
||
{ label: 'Suppliers', href: '/docs/api/reference/suppliers' },
|
||
{ label: 'Supplier invoices', href: '/docs/api/reference/supplier-invoices' },
|
||
{ label: 'Transactions', href: '/docs/api/reference/transactions' },
|
||
{ label: 'Journal entries', href: '/docs/api/reference/journal-entries' },
|
||
{ label: 'Fiscal periods', href: '/docs/api/reference/fiscal-periods' },
|
||
{ label: 'Accounts', href: '/docs/api/reference/accounts' },
|
||
{ label: 'Documents', href: '/docs/api/reference/documents' },
|
||
{ label: 'Employees', href: '/docs/api/reference/employees' },
|
||
{ label: 'Salary runs', href: '/docs/api/reference/salary-runs' },
|
||
{ label: 'Reports', href: '/docs/api/reference/reports' },
|
||
{ label: 'Imports', href: '/docs/api/reference/imports' },
|
||
{ label: 'Compliance check', href: '/docs/api/reference/compliance' },
|
||
{ label: 'Reconciliation', href: '/docs/api/reference/reconciliation' },
|
||
{ label: 'Webhooks', href: '/docs/api/reference/webhooks' },
|
||
{ label: 'Operations', href: '/docs/api/reference/operations' },
|
||
{ label: 'Voucher gap explanations', href: '/docs/api/reference/voucher-gap-explanations' },
|
||
],
|
||
},
|
||
{
|
||
label: 'Reference',
|
||
links: [
|
||
{ label: 'Errors', href: '/docs/api/errors', summary: 'Every stable error code, status, and remediation.' },
|
||
{ label: 'Changelog', href: '/docs/api/changelog', summary: 'Per-version release notes.' },
|
||
{ label: 'OpenAPI 3.1 spec', href: '/api/v1/openapi.json', summary: 'Machine-readable spec for client generation.' },
|
||
{ label: 'llms.txt', href: '/llms.txt', summary: 'Agent-discoverable index.' },
|
||
{ label: 'llms-full.txt', href: '/llms-full.txt', summary: 'Full docs concatenated for LLM ingestion.' },
|
||
],
|
||
},
|
||
]
|