Skip to content

docs + fix: improve llms.txt and fix canonical formula#81

Merged
rororowyourboat merged 8 commits intomainfrom
dev
Mar 4, 2026
Merged

docs + fix: improve llms.txt and fix canonical formula#81
rororowyourboat merged 8 commits intomainfrom
dev

Conversation

@rororowyourboat
Copy link
Collaborator

@rororowyourboat rororowyourboat commented Mar 3, 2026

Summary

  • llms.txt improvements: Added package names to section headers and descriptions to key entry points. Removed outdated design docs (gds-deepdive, v0.2-design, entity-redesign) from nav and llmstxt config.
  • Canonical formula fix: CanonicalGDS.formula() now correctly returns h = g (policy-only), h = f (mechanism-only), or h = id (empty) instead of always returning h = f ∘ g. Fixes the Rosetta Stone notebook's canonical spectrum tables.

Test plan

  • All 377 gds-framework tests pass
  • All 76 rosetta guide tests pass
  • Formula variants verified: empty (id), full (f∘g), policy-only (g), mechanism-only (f), parameterized variants
  • mkdocs build --strict passes

Merge pull request #79 from BlockScience/dev
Remove gds-deepdive, v0.2-design, and entity-redesign proposal from
mkdocs nav — these pre-implementation design docs diverge from the
actual codebase and would confuse LLMs reading llms-full.txt.

Add package names to llmstxt section headers and descriptions to key
entry points (overviews, getting-started, guides) for better LLM
navigation.
Plotly rejects 8-character hex colors (#RRGGBBAA). Convert to
rgba() format which is universally supported.
CanonicalGDS.formula() previously always returned h = f ∘ g regardless
of whether mechanism or policy blocks were present. Now correctly returns
h = g (policy-only), h = f (mechanism-only), or h = id (empty). This
fixes the canonical spectrum tables in the Rosetta Stone notebook where
Game Theory incorrectly showed h = f ∘ g instead of h = g.
@rororowyourboat rororowyourboat changed the title docs: improve llms.txt with descriptions and remove outdated design docs docs + fix: improve llms.txt and fix canonical formula Mar 3, 2026
Standalone workspace package (pydantic>=2.10 only, no gds-framework dep)
providing a cadCAD-compatible execution engine with native and compat
function signatures, param sweeps, and optional parallel execution.
Update stockflow canonical test to expect degenerate formula (h = f)
for orphan stocks, matching the recent canonical formula fix. Wrap long
rgba() f-strings in evolution_of_trust notebook to satisfy E501.
…book

New example with game-theoretic model for prisoner's dilemma and
interactive marimo notebook for Nash equilibrium analysis.
Add mkdocs-marimo plugin and replace plain notebook links with
interactive marimo-embed-file directives across all guide pages.
@rororowyourboat rororowyourboat merged commit f23870e into main Mar 4, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant