Docs: refresh GoalOS / Proof Gradient documentation, figures, tables, and repository map

QA_VERIFICATION.md

@@ -52,3 +52,33 @@ projected annual savings under demo assumptions vs human baseline at 10,000 jobs
 ```
 
 The GitHub Pages deploy refuses to publish if the reference workflow proof fails.
+
+## GoalOS documentation validation
+
+This documentation-only refresh adds two local validators that do not edit files and do not inspect or modify website implementation files.
+
+Recommended documentation commands:
+
+```bash
+python scripts/validate_docs_tables_figures.py
+python scripts/validate_goalos_catalog.py
+```
+
+What is checked:
+
+- required GoalOS docs exist;
+- required CSV tables are parseable;
+- required Mermaid figure sources exist;
+- `docs/data/goalos_catalog.yml` is parseable;
+- README and documentation-index local links resolve;
+- product ladder prices and versions match the catalog;
+- safe-boundary language appears in key docs;
+- prohibited claims are controlled as claim-boundary language, not live promises;
+- direct paid ZIP public links are flagged;
+- documentation-only scope is respected by changed-file checks.
+
+Skipped by design:
+
+- Mermaid SVG export unless Mermaid CLI (`mmdc`) is installed;
+- website-file edits or generated GitHub Pages changes;
+- application-code fixes for failures outside documentation scope.

README.md

@@ -1,107 +1,120 @@
-# Proof Gradient / GoalOS
+# Proof Gradient / GoalOS / QUEBEC.AI ⚜️✨
 
 **A model can answer. An agent can act. An institution must prove.**
 
-Proof Gradient is the public proof and standards layer for GoalOS. GoalOS is the recursive workflow operating layer for the RSI era: it turns repeated AI work into owned, scored, versioned, approved, monitored, and recursively improving workflows.
+Proof Gradient is the public proof and standards layer. GoalOS is the recursive workflow operating layer for the RSI era. QUEBEC.AI ⚜️✨ is the sovereign Québec AI identity layer that routes public buy/apply actions to the official shop.
 
-**Commercial line:** ChatGPT gives you answers. GoalOS gives you workflows that get better every time they run.
+- **Category:** Recursive Self-Improving Workflows.
+- **Platform:** GoalOS Recursive Workflow OS.
+- **Commercial line:** ChatGPT gives you answers. GoalOS gives you workflows that get better every time they run.
+- **Enterprise line:** Enterprise RSI without model self-modification.
 
-**Enterprise line:** Enterprise RSI without model self-modification.
+GoalOS turns repeated AI work into owned, scored, versioned, approved, monitored, and recursively improving workflows.
 
-## Safe boundary
+## Core loop and GoalOS law
 
-GoalOS does **not** modify AI models. Recursive improvement happens at the workflow layer: workflow definitions, instructions, prompts, memory, scorecards, proof records, evaluations, evidence standards, operating procedures, approvals, versions, monitoring, and rollback.
+**Core loop:** Run → Score → Prove → Diagnose → Improve → Approve → Version → Monitor → Re-run.
 
-Core loop:
+**GoalOS law:**
 
-> Run → Score → Prove → Diagnose → Improve → Approve → Version → Monitor → Re-run
+- No proof, no evolution.
+- No eval, no propagation.
+- No rollback, no release.
 
-## Public software proof
+**Français :**
 
-GoalOS Cloud MVP 0.2 is a public static software proof in `site/app/goalos-cloud-mvp/`.
+- Pas de preuve, pas d’évolution.
+- Pas d’évaluation, pas de propagation.
+- Pas de rollback, pas de publication.
 
-It runs in the browser, uses `localStorage`, requires no secrets, and demonstrates:
+## Safe AI boundary
 
-- organization / workspace / user roles;
-- policy engine and controlled memory;
-- model-provider restrictions;
-- Workflow Studio and workflow versioning;
-- Execution Engine and Evaluation Engine demos;
-- Proof Room records;
-- Recursive Improvement Engine;
-- improvement proposal and human approval gate;
-- version comparison, rollback target, Proof Graph export;
-- public-safe proof card and executive proof report exports;
-- audit log, OpenAPI blueprint, JSON schemas, and Node unit tests.
+GoalOS does not modify base AI models. GoalOS improves workflows around AI through instructions, prompts, memory, scorecards, proof records, evaluations, approvals, versions, monitoring, and rollback.
 
-Demo story: the **Customer Support Reply Workflow** v1.0 intentionally misses refund/access policy classification. The MVP runs support cases, evaluates outputs, creates proof records, detects the refund-policy failure, proposes v1.1, benchmarks v1.0 vs v1.1, requires human approval, deploys approved v1.1, preserves rollback target v1.0, and exports a public-safe proof card plus Proof Graph.
+GoalOS ne modifie pas les modèles IA de base. GoalOS améliore les flux autour de l’IA grâce aux instructions, prompts, mémoire, grilles de score, dossiers de preuve, évaluations, approbations, versions, surveillance et rollback.
 
-Run the MVP test:
+## Commercial ladder
 
-```bash
-node site/app/goalos-cloud-mvp/tests/enterprise-core.test.mjs
-```
+All buy/apply links in public documentation should point to <https://www.quebecartificialintelligence.com/shop>. Paid buyer ZIPs and delivery kits are not public repository downloads.
 
-## Public website
+| Price | Offer | Version | Public outcome |
+|---:|---|---:|---|
+| $49 | GoalOS AI Efficiency Sprint Kit | v1.4 | Build one reusable AI workflow. |
+| $199 | GoalOS RSI Lite | v1.6 | Build one self-improving AI workflow. |
+| $997 | GoalOS Proof Room Lite / Department Pack | v2.0 | Set up a lightweight department Proof Room. |
+| $2,500+ | GoalOS RSI Sprint Workshop | v6.0 | Build the first self-improving workflow live. |
+| $9,500+ | GoalOS Proof Room Implementation Sprint | v2.0 | Department RSI in 30 days. |
+| $49,000+ | GoalOS Enterprise RSI Pilot | v2.0 | Pilot the Recursive Workflow OS. |
 
-The GitHub Pages site root is `site/`. The public site uses one canonical shell:
+The documentation source of truth is [`docs/data/goalos_catalog.yml`](docs/data/goalos_catalog.yml).
 
-- `site/assets/goalos-site-v2.css`
-- `site/assets/goalos-site-v2.js`
+## Public standards / AEP map
 
-The site is designed as a clean, dark, institutional GoalOS / Proof Gradient foundation with one navigation bar, one footer, public product pages, standards, examples, and the Cloud MVP.
+Proof Gradient preserves the public AEP standards layer:
 
-## Product / offer ladder
+| Standard | Purpose |
+|---|---|
+| [AEP-001](docs/standards/AEP-001/README.md) | GoalOS Proof-of-Evolution Constitution |
+| [AEP-002](docs/standards/AEP-002/README.md) | Evidence Docket Standard |
+| [AEP-003](docs/standards/AEP-003/README.md) | ProofPacket Schema |
+| [AEP-004](docs/standards/AEP-004/README.md) | Selection Gate Standard |
+| [AEP-005](docs/standards/AEP-005/README.md) | Tool Permission Standard |
+| [AEP-006](docs/standards/AEP-006/README.md) | Rollback Receipt Standard |
+| [AEP-007](docs/standards/AEP-007/README.md) | Public-Safe Proof Report Standard |
+| [AEP-008](docs/standards/AEP-008/README.md) | Proof Room Standard |
 
-Paid products are sold on QUEBEC.AI and are **not** stored in this repository. All checkout / apply buttons point to:
+## GoalOS Cloud MVP 0.2
 
-<https://www.quebecartificialintelligence.com/shop>
+GoalOS Cloud MVP 0.2 is documented as a public static proof, not production SaaS. Its architecture includes Workflow Studio, Execution Engine, Evaluation Engine, Proof Room, Improvement Engine, Approval, Versioning, and Rollback. See [`docs/GOALOS_CLOUD_MVP_0_2.md`](docs/GOALOS_CLOUD_MVP_0_2.md).
 
-Current ladder:
+## Current repository map
 
-| Price | Offer | Public outcome |
-|---:|---|---|
-| $49 | GoalOS AI Efficiency Sprint Kit | Build one reusable AI workflow. |
-| $199 | GoalOS RSI Lite | Build one self-improving AI workflow. |
-| $997 | GoalOS Proof Room Lite / Department Pack | Set up a lightweight department Proof Room. |
-| $2,500+ | GoalOS RSI Sprint Workshop | Build the first self-improving workflow live. |
-| $9,500+ | GoalOS Proof Room Implementation Sprint | Department RSI in 30 days. |
-| $49,000+ | GoalOS Enterprise RSI Pilot | Pilot the Recursive Workflow OS for one enterprise workflow family. |
+- `README.md` — public entry point and repository orientation.
+- `docs/` — strategy, product, standards, architecture, trust, roadmap, tables, and figures.
+- `docs/data/goalos_catalog.yml` — source of truth for current GoalOS names, versions, prices, claims, URLs, AEP standards, and policy boundaries.
+- `docs/figures/` — Mermaid source figures for the recursive loop, product ladder, site separation, Cloud MVP, Proof Graph, safety boundary, firm stack, and commercialization sequence.
+- `docs/tables/` — CSV source tables for product ladder, claims, public site inventory, paid-file policy, AEP standards, assets, firm stack, revenue scenarios, and ROI assumptions.
+- `examples/` and `schemas/` — public examples and schema references.
+- `scripts/` — documentation and repository validation utilities.
+- `site/`, `public/`, root website HTML/CSS/JS — public website files; not modified by this documentation-only refresh.
 
-Future platform: **GoalOS Recursive Workflow OS**. Future moat: **Proof Graph**.
+## Documentation map
 
-## Public standards and proof layer
+Start with [`docs/GOALOS_DOCUMENTATION_INDEX.md`](docs/GOALOS_DOCUMENTATION_INDEX.md). Key pages:
 
-The AEP standards are the public trust layer. They provide the vocabulary for proof, permission, rollback, public-safe reports, and Proof Rooms.
+- [`docs/GOALOS_RECURSIVE_WORKFLOW_OS.md`](docs/GOALOS_RECURSIVE_WORKFLOW_OS.md)
+- [`docs/GOALOS_COMMERCIALIZATION_STATUS.md`](docs/GOALOS_COMMERCIALIZATION_STATUS.md)
+- [`docs/GOALOS_CLAIMS_AND_SAFE_BOUNDARY.md`](docs/GOALOS_CLAIMS_AND_SAFE_BOUNDARY.md)
+- [`docs/GOALOS_PAID_ARTIFACT_POLICY.md`](docs/GOALOS_PAID_ARTIFACT_POLICY.md)
+- [`docs/GOALOS_ENGINEERING_ROADMAP.md`](docs/GOALOS_ENGINEERING_ROADMAP.md)
+- [`docs/GOALOS_WORLD_CLASS_FIRM_STACK.md`](docs/GOALOS_WORLD_CLASS_FIRM_STACK.md)
 
-- AEP-001 — GoalOS Proof-of-Evolution Constitution
-- AEP-002 — Evidence Docket Standard
-- AEP-003 — ProofPacket Schema
-- AEP-004 — Selection Gate Standard
-- AEP-005 — Tool Permission Standard
-- AEP-006 — Rollback Receipt Standard
-- AEP-007 — Public-Safe Proof Report Standard
-- AEP-008 — Proof Room Standard
+## Paid/private file policy
 
-Existing standards content, schemas, examples, conformance materials, and documentation are preserved.
+Public documentation may reference README, docs, examples, schemas, public AEP standard packages, public website pages, public brand assets, and the public Cloud MVP demo. Public AEP packages may use the `standards/AEP-###/complete-package.zip` convention.
 
-## Claim boundary
-
-This repository and public site do not claim guaranteed ROI, income, productivity, compliance certification, safety guarantees, legal advice, financial advice, investment advice, autonomous deployment, uncontrolled autonomous AGI, AI model self-modification, real revenue, real profit, or real-world energy capture.
+Private / not public: buyer ZIPs, paid workshop bundles, buyer/facilitator delivery kits, implementation delivery kits, enterprise pilot delivery kits, seller asset bundles, commercialization master packs, private client data, proof cards without approval, exact buyer outputs without approval, sensitive prompts, and private policies.
 
 ## Validation
 
-Recommended public-site checks:
+Documentation checks:
+
+```bash
+python scripts/validate_docs_tables_figures.py
+python scripts/validate_goalos_catalog.py
+```
+
+Existing software tests, when the environment supports them and without changing source or website files:
 
 ```bash
-node site/app/goalos-cloud-mvp/tests/enterprise-core.test.mjs
-python scripts/validate_goalos_site_v2.py
-python scripts/check_no_paid_artifacts.py
 pytest
+make test
 ```
 
-The paid-artifact guard blocks paid buyer ZIPs, paid workshop files, implementation bundles, enterprise delivery kits, and seller assets from the GitHub Pages public site, except explicitly whitelisted public standards/action documentation.
+## Current status
 
-## Repository foundation
+This repository is the public proof, standards, and documentation foundation for GoalOS / Proof Gradient / QUEBEC.AI ⚜️✨. Current public status: documentation source of truth refreshed; product ladder current; Cloud MVP 0.2 documented as public proof; full production SaaS, production backend, multi-tenant persistence, auth/SSO, production model gateway, SOC 2 readiness, enterprise integrations, billing automation, and production Proof Graph are not yet complete.
+
+## Claim boundary
 
-The repository also preserves the broader Proof Gradient foundation: GitHub Actions, static site assets, docs, schemas, examples, tests, Python package area, Docker files, data files, and GitHub Pages content.
+This repository does not claim guaranteed ROI, guaranteed revenue, guaranteed productivity, compliance certification, AI safety certification, legal / financial / tax / HR / security / medical / regulatory advice, uncontrolled autonomous deployment, true AGI RSI, or base-model self-modification.