v0.3.0

Full coverage of every B-UML DSL and generator, deeper class-diagram /
state-machine / agent references, a complete editorial-review pass, a
marketing/positioning rework of the README, and field fixes surfaced by real
agent runs.

Added

• Coverage of all remaining B-UML DSLs in besser-user — seven new
  source-verified references:
  • references/object-models.md — object/instance models (objects,
    attribute values, links), incl. the fluent builder and OCL test data.
  • references/feature-models.md — software product lines (features,
    groups, configurations).
  • references/ocl.md — writing and attaching OCL Constraints; bocl
    evaluation; which generators consume OCL.
  • references/deployment.md — deployment models for the
    TerraformGenerator.
  • references/neural-networks.md — NN models for the PyTorch/TF
    generators.
  • references/quantum.md — quantum circuits for the QiskitGenerator.
  • references/project.md — bundling models + metadata.
• Two previously undocumented generators in besser-generators:
  • SupabaseGenerator (Postgres DDL + RLS) in references/persistence.md.
  • JSONObjectGenerator (JSON data from an ObjectModel) in
    references/python-and-data.md.
• Much deeper class-diagram, state-machine, and agent references
  (community contribution): metamodel.md renamed to class-diagram.md and
  expanded (AssociationClass, GeneralizationSet,
  is_abstract/is_optional/is_read_only, navigability, composition
  direction, void methods, end-name uniqueness); state machines gain final
  states, conditions, fallback bodies, config properties, and the
  STATE_MACHINE method-implementation pattern; agents gain LLM integration,
  entities/slot-filling, intent-classifier config, RAG, DBReply,
  ReasoningState, tools/skills/workspaces, and rich platform replies.
• The skills now cover all 19 BESSER generators and every B-UML
  metamodel/DSL; reference-layout tables, trigger descriptions, and the
  README were updated to surface them.
• README "What your agent can build" capability block — surfaces the full
  BESSER surface an agent can drive: every B-UML model type, all 19 generators,
  the deterministic-codegen-then-build-on-top workflow, troubleshooting, and
  extending BESSER itself. Cross-links the standalone
  uml-drawing skill and adds an
  Agent Skills directory link.
• One-call B-UML → SVG rendering in besser-user and the README — POST a
  model to BESSER v7.9.0's headless /besser_api/get-svg endpoint and embed the
  result, no browser required.
• "Generate the baseline, then build on top" guidance in besser-generators:
  regenerate the deterministic baseline freely (cheap and identical each run) and
  put customizations in separate files so a re-run never clobbers them.

Changed

• besser-dev restructured from a 487-line monolith into a lean overview
  • routing table plus five references/ (adding-a-generator,
    adding-a-metamodel, testing, docs-and-build, contributing-workflow),
    matching the progressive-disclosure pattern of the other skills.
• De-duplicated drift-prone content across skills: the web-editor
  registry snippet is now single-sourced in besser-dev; the
  composite-generator tree lives only in debugging.md; the
  besser-troubleshooting generator-failure table is scoped to error-message
  lookups with a clear hand-off to besser-generators.
• besser-generators editorial fixes: merged the redundant
  reference-layout/generator-picker tables; replaced the partial
  output-directory table with an exhaustive-by-rule "Output locations"
  call-out; normalized the Supabase/JSON-object entries to the house table
  style; clarified that BAL/CODE method bodies are inserted verbatim.
• Consistency pass: standardized reference "Gotchas" headings, added
  tables of contents to the longer references, and moved per-file version
  stamps to a single note; relaxed the attribute-naming guidance to match
  what BESSER actually enforces (no spaces/hyphens; snake_case or camelCase).
• README refreshed for v7.9.0: BESSER badge bumped to v7.9.0, the drawing
  section now leads with the one-call headless SVG endpoint, and the codegen
  bullet is reframed around deterministic baselines you extend on top — spend
  tokens only on what is genuinely custom. The intro now links directly to the
  uml-drawing repo instead of an in-page anchor.

Fixed

• Corrected a broken copy-paste example (an always-false chained-comparison
  assertion) in object-models.md, and the chat_history type in
  agents.md. Reconciled CONTRIBUTING.md's description-voice rule with the
  trigger style all four skills actually use.
• Stopped recommending default_value on enum-typed attributes across
  besser-user, besser-troubleshooting, and besser-generators'
  debugging.md. It passes validate(), but the Pydantic/SQLAlchemy generators
  serialize the literal's raw repr() → invalid Python (e.g. SyntaxError: leading zeros…), and the headless SVG endpoint rejects it. Set the initial
  value in the app/auth layer or as a DB column default instead. (Primitive
  defaults like True or 0 round-trip fine.)
• Class diagrams are delivered as B-UML, never Mermaid (besser-user). The
  authoritative artifact is the validate()-checked B-UML model; a rendered
  SVG/PNG is the picture and a quick ASCII sketch is fine as a preview, but
  Mermaid (un-validated, can't be generated from) is no longer produced.

Notes

• All new content was written against BESSER v7.8.3 source with verified API
  citations; several upstream documentation bugs were deliberately not
  reproduced (e.g. the wrong besser.BUML.notations.od.* import path and the
  ObjectModel(instances=…) kwarg). Known-broken paths are flagged in-place
  (e.g. the objectPlantUML parser is non-functional in v7.8.3).
• The headless B-UML → SVG flow and the v7.9.0 badge track BESSER v7.9.0
  (PR #554, ELK auto-layout); all other API citations remain verified against
  v7.8.3 source.