Skip to content

docs(spec): describe srcful-data-models v2 in the migration note - #166

Open
davmoz wants to merge 3 commits into
mainfrom
docs/data-models-v3-merged
Open

davmoz wants to merge 3 commits into
mainfrom
docs/data-models-v3-merged

Conversation

@davmoz

@davmoz davmoz commented Oct 6, 2026 •

Copy link
Copy Markdown
Member

Follow-up to #153. srcful-data-models is published as v2 (package 2.3.0) on main (8432bf0), not as v3. NovaCore's v2 path (srcfl/srcful-novacore#174) is merged and runs on devnet.

What

spec/host-api.md:

  • host.set_make: pass the brand, not the model ("Eastron", not "SDM630"); v2 hosts write it lowercase with words joined by _.
  • "Proposed data-models v3.0.0 migration" becomes "Data-models v2 migration": links the data-models README and docs/REFERENCE.md, and summarises v2 (versioned json.v2 subjects, default DER segment and NovaCore's temporary pv fallback, the inverter DER type, _ac/_dc postfixes, null for unread values, the battery SoC window).
  • The inverter row of the der_type table: added in data-models v2.
  • Unchanged: host.emit keys. Hosts must accept or map the v2 wire names before a driver uses them.

🤖 Generated with Claude Code

davmoz and others added 2 commits October 6, 2026 10:40
srcful-data-models#10 merged v3.0.0 on main, so the host.emit migration
note no longer describes it as open or says main is v2.0.0. NovaCore's
change (srcful-novacore#174) is still open, and host emit keys stay
separate from the wire model as before.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: David Mozart <dmozartandraws@gmail.com>
The data model is published as v2 (package 2.0.0) on main, not v3.
Update the migration note: json.v2 subjects next to the legacy json.v1
with no translation between them, the DER type as the default topic
segment (solar, was pv) with NovaCore's temporary pv fallback, the
inverter DER as the AC output stage only, an _ac/_dc postfix on every
W/V/A/VA/Wh field with only Hz bare, and null for unread values. The
split between host emit keys and the wire model is unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: David Mozart <dmozartandraws@gmail.com>
@davmoz
davmoz force-pushed the docs/data-models-v3-merged branch from f5e2a7a to 37584a4 Compare October 6, 2026 12:42
@davmoz davmoz changed the title docs(spec): note data-models v3.0.0 is merged docs(spec): describe srcful-data-models v2 in the migration note Oct 6, 2026
set_make takes the brand, which v2 hosts write lowercase with `_`;
the SoC window rule; NovaCore's v2 path (#174) is merged and on devnet.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: David Mozart <dmozartandraws@gmail.com>
@davmoz
davmoz force-pushed the docs/data-models-v3-merged branch from d083ed6 to 8bb28a5 Compare October 7, 2026 05:52

@miravoss26 miravoss26 left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Docs-only spec update: finalizes the data-models v2 migration note (host.set_make brand-casing rule, der_name defaults, v2 payload topic, inverter DER type as AC-only). Replaces the "proposed v3.0.0" language with "v2 (2.3.0) is on main" now that srcful-novacore#174 merged.

  • Content checks out against what I can see elsewhere today (srcful-data-models 2.3.0, the matching doc-pointer PRs in srcful-documentation/srcful-ems-x/srcful-device-support).
  • No code changed, no host.emit behavior changed — correctly flagged as still pending.

Safe to merge from my read.

This branch has not been deployed

No deployments
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.

2 participants