Skip to content

History / Document Management

Revisions

  • docs: point the API reference links at the published pages api.robosystems.ai/docs served ReDoc, and it is being retired to a 301 (robosystems#1427). The reference now lives at robosystems.ai/docs/api — a page per operation, server-rendered from the live /openapi.json, which is what a crawler and an answer engine can actually read. Twenty-two pages carried that link, and several called it "the live OpenAPI spec" while pointing at a rendered page. The spec is /openapi.json; this is the reference, and the two now read differently. Local development changes shape too. `localhost:8000/docs` is a redirect now, so the pages that offered it as the interactive docs point at `localhost:8000/` instead — the Swagger console, which is kept precisely so a call can still be run from a browser. Local-Development's table gains a row separating the two. Claude-Session: https://claude.ai/code/session_011KBrhQHzwrB39C4c4Vw9Pq

    @jfrench9 jfrench9 committed Sep 18, 2026
  • Reorient the wiki to the hosted platform and add a Local Development page Examples on the API pages now call https://api.robosystems.ai with $ROBOSYSTEMS_API_KEY, and their prerequisites are an account, a key from Settings → API keys, and a graph. Each page carries one pointer for self-hosters, and local-only material moves to a Self-hosted deployments section at the end of the page. Local Development is the single home for running the platform: the local walkthrough that used to be Quick Start, a local-vs-hosted table, local-only tools, SEC filings, the web apps, and troubleshooting. Quick Start is now the hosted walkthrough. The sidebar gains a Self-Hosting & Development section. Also: the Querying guide's MCP examples use the JSON-RPC transport (the REST tool endpoints were removed in v1.10.2), Bootstrap Guide tunnel addresses use the offset ports, and a broken anchor on the SEC XBRL Pipeline page is fixed. Claude-Session: https://claude.ai/code/session_011KBrhQHzwrB39C4c4Vw9Pq

    @jfrench9 jfrench9 committed Sep 17, 2026
  • Realign the wiki with the shipped platform Audited all 34 pages against the live OpenAPI spec, the running stack, and the source tree. Fourteen pages had not been touched since 11 June, while ~1,140 commits landed behind them. Endpoint and contract corrections: - The query surface split: /query -> /query/cypher, /tables/query -> /query/sql, plus the CypherStatementRequest / CypherStatementResponse / SqlStatementResponse renames and the SDK module rename. - Content writes moved to CQRS operations: create-file-upload, ingest-file, delete-file, index-document, delete-document. Response samples rewrapped in OperationEnvelope. - build-fact-grid no longer pivots server-side; documented the flat ViewResponse and the filtering-only ViewConfig. - Report bundle downloads move to the GraphQL reportDownloadUrl field. - Singular /subscription -> /subscriptions; /v1/health -> /v1/status. Removed machinery that does not exist: restore-backup and the backup encryption model, the "38 validator checks" rule engine, the dormant LanceDB element-index lifecycle, two invented Reporting Styles, the Neo4j backend, Google/GitHub SSO, a phantom backup-encryption secret, three non-existent feature flags, and a QuickBooks auto-sync scheduler that was never wired. Documented shipped surfaces that were missing entirely: FP&A forecasting and metrics, semantic memory, multi-user organizations and graph membership, the password and registration lifecycle, the write-policy model and QB outbox, reconciling items, and nightly automated backups. Corrected the frameworks count to three (fac, cm, rs-gaap), the tier rate multipliers to 2x/4x, and the claim that multi-user organizations were unavailable. Added a vulnerability-disclosure path to Security & Compliance. Replaced restated volatile config with pointers to /v1/offering, /v1/graphs/tiers, and /v1/graphs/{id}/limits.

    @jfrench9 jfrench9 committed Aug 10, 2026
  • Correct claims that the codebase contradicts Verified each against source before editing. - Architecture-Overview: drop "Row-level security in PostgreSQL" (none exists in either migration tree) and describe the control that is actually there — schema-per-graph with search_path re-stamped per session. Drop "Distributed request tracing" (OTEL_TRACES_ENABLED is never defined, so no span exporter is built and the collector has no traces pipeline). Fix the stale "multi-tenant and dedicated tiers" — every customer tier is dedicated. - Tier tables across four pages: Standard is m7g.medium (4 GB) and Large is m7g.large (8 GB) since the 2026-07-27 resize; prices are $99/$249/$599. - Graphs-and-Multi-Tenancy: rate multipliers were wrong in shape as well as number. There is no uniform multiplier — shared categories (auth, status, billing, SSE) are identical on every tier, and only dedicated-resource categories scale with vCPU: Large 2.0x, XLarge 4.0x. - Document-Management: document creation is MCP-only. The documented POST /v1/graphs/{graph_id}/documents upload endpoint does not exist; the REST surface is read-only. (POST /search, also documented, is real.) - Credits-and-Billing: usage endpoint is /usage, metrics is /metrics — /analytics/usage and /analytics were both renamed.

    @jfrench9 jfrench9 committed Aug 9, 2026
  • Add operations, extensions, and content-layer documentation; align existing pages Restructure the wiki into five categories with a sidebar and a rebuilt Home hub. New pages (20): - Getting Started: Quick Start, Core Concepts - Operations: Authentication & API Keys, Graphs & Multi-Tenancy, Graph Operations, Querying the Analytical Graph, Credits & Billing, AI Operators & MCP - Extensions: Extensions Surface Overview, GraphQL Reads, RoboLedger Operations, RoboInvestor Operations - Content & Contribution Fabric: Information Blocks, Taxonomy & Frameworks, Event-Driven Ledger, Reporting & Rendering, Serialization & Export - Documents & Search: Search & AI Retrieval, Document Management, File Uploads Align existing pages with the current codebase: - Architecture Overview: models/core + models/extensions paths, the two-database split, change-tier op name, shipped document-search source types - Pipeline Guide: remove nonexistent Plaid adapter, fix the SEC pipeline asset list - Bootstrap Guide: drop dead Plaid secrets, add the extensions feature flags - SEC XBRL Pipeline / Custom Graph Schema: replace fabricated MCP tool names with the real registry (financial-statement-analysis, get-graph-info, ...) - RoboLedger Demos: broaden the page to cover the Seattle Method XBRL demos (lemonade stand + The World Online) alongside the synthetic demo

    @jfrench9 jfrench9 committed Jun 11, 2026