{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.wm-flw-014","code":"wm-flw-014-network-flow-telemetry-stream","url":"https://ver.cy/models/wm-flw-014-network-flow-telemetry-stream/","name":"Network Flow / Telemetry Stream","alternateNames":[],"kind":"world-model","status":"published","version":"0.1.0","language":"en","classifiers":{"family":"World Models","category":"Physical world and living systems","entryKind":"entity","plane":"","domain":["PHY.FLW.NET"],"industry":["Cross-industry"],"navPath":"NAV.PHY.FLW.NET","tags":["network","flow","telemetry","stream","phy.flw.net"],"facets":{}},"whatItIs":"A network flow telemetry stream is the time-varying record of what flows through a physical or logical network, such as water, gas, power, traffic or data, measured at points or links and delivered as a continuous series. The network topology, the individual meter and the single operational log entry are separate subjects.","purpose":"Describe a governed, time-varying telemetry stream about flow through a physical or logical network, preserving measurement meaning, provenance and use limits.","scope":{"in":["Stream identity, accountable custodian, profile and continuity across collection sessions","Network observation scope, quantity and units, measurement method, selection, event time and delivery evidence","Observation record identity, counter semantics, quality, derived-view lineage, controlled retention and projection"],"out":["Network topology and asset lifecycle masters, sensor design and calibration execution","Physical conservation or hydraulic/electrical simulation, resource accounting, billing adjudication and logistics custody","Packet payload inspection, collection deployment, routing changes, valve or setpoint control, and automated incident enforcement","General application traces, arbitrary business event streams and protocol implementation certification"],"boundaries":[{"neighbor":"WM-BLT-003 Infrastructure Network","distinction":"The registry parent is contextual organization, not inheritance of network structure. Reference a versioned node, link, interface or observation region; topology stays in the network master."},{"neighbor":"Sensor, observation and collector masters","distinction":"The stream has persistent identity and membership rules. Sensors, individual measurements and collection sessions retain their own identities and lifecycle; this model stores references and stream-specific qualifications."},{"neighbor":"WM-FLW-008 Mass-balance / Material Flow and WM-FLW-015 Resource Consumption","distinction":"Telemetry can supply observations to balances or consumption assessment; it does not assert conservation, loss, billable consumption or causal diagnosis. Quantity, sign, interval and uncertainty must be compatible before comparison."},{"neighbor":"Actuation, incident and general event records","distinction":"Telemetry observations and local quality assessments do not authorize intervention. Irregular and event-triggered observations are allowed; a generic operational event log is a different subject."}]},"distinguishingFeatures":["A time series of flow values, not the network topology or the meter that produces it.","Continuous and interval-based, unlike a discrete event or log entry.","Covers both physical flows such as water and power and logical flows such as data traffic.","Quality flags and estimations are part of the stream, so measured and estimated values must stay distinguishable."],"structure":{"bundles":[{"id":"FLW014-B1","name":"Stream definition","description":"What is measured, where and how often.","layers":[{"id":"FLW014-B1-L1","name":"Measurement point and quantity","description":"The location in the network and the quantity measured.","findings":[{"id":"FLW014-F01","name":"Measurement point","description":"The node, link or interface where the flow is measured.","questions":[{"text":"At which node, link or interface of the network is the flow measured?","id":"FLW014-Q01"},{"text":"Which meter or probe produces the values, and when was it calibrated?","id":"FLW014-Q02"}]},{"id":"FLW014-F02","name":"Quantity and sampling","description":"The measured quantity, unit and sampling interval.","questions":[{"text":"Which quantity is measured, in which unit?","id":"FLW014-Q03"},{"text":"What is the sampling or aggregation interval, and is it fixed?","id":"FLW014-Q04"}]}]}]},{"id":"FLW014-B2","name":"Data quality","description":"How complete and trustworthy the series is.","layers":[{"id":"FLW014-B2-L1","name":"Completeness and validity","description":"Gaps, outliers and quality flags in the series.","findings":[{"id":"FLW014-F03","name":"Gaps and substitutions","description":"Missing intervals and values filled by estimation.","questions":[{"text":"Which intervals are missing, and were any values estimated or substituted?","id":"FLW014-Q05"},{"text":"Are estimated values flagged separately from measured ones?","id":"FLW014-Q06"}]},{"id":"FLW014-F04","name":"Time alignment","description":"Time stamps and clock source of the series.","questions":[{"text":"Which clock and time zone stamp the values?","id":"FLW014-Q07"},{"text":"Are values from different points aligned to the same intervals?","id":"FLW014-Q08"}]}]}]},{"id":"FLW014-B3","name":"Access and use","description":"Who receives the stream and for what.","layers":[{"id":"FLW014-B3-L1","name":"Consumers and retention","description":"Subscribers, purposes and retention of the stream.","findings":[{"id":"FLW014-F05","name":"Subscribers and purpose","description":"Parties receiving the stream and their declared purposes.","questions":[{"text":"Which parties receive the stream, and for which purpose?","id":"FLW014-Q09"},{"text":"Does the stream allow inference about individual households or users?","id":"FLW014-Q10"}]},{"id":"FLW014-F06","name":"Retention","description":"How long raw and aggregated values are kept.","questions":[{"text":"How long are raw values kept before aggregation or deletion?","id":"FLW014-Q11"}]}]}]}]},"agentConduct":{"may":["Read streams within the access granted and compute aggregates and trends.","Detect and flag gaps, outliers and anomalies such as leaks or congestion.","Correlate flows across points to locate likely faults.","Report data quality alongside derived figures."],"mustNot":["Change setpoints, valves, routing or load based on the stream without operator authority.","Present estimated or substituted values as measured.","Infer and disclose behaviour of individual households or users from fine-grained streams.","Inspect payload content of data traffic when only flow metadata is in scope."],"requiresHuman":["Acting on an anomaly by isolating, curtailing or rerouting part of the network.","Sharing fine-grained streams with third parties.","Using stream data for billing disputes or enforcement."]},"ethics":{"considerations":["Fine-grained consumption and traffic data can reveal private behaviour of households and users.","Wrong or delayed telemetry can hide leaks, overloads or attacks with safety consequences.","Data traffic monitoring can slide into surveillance of communications."],"affectedParties":["Customers and users of the network","Network operators and control room staff","Communities exposed to network failures"]},"owners":{"steward":"The network operator that runs the measurement points and answers for the stream's accuracy and use.","roles":[{"name":"Stream custodian","responsibilities":["Approve identity and membership continuity within delegated authority"]},{"name":"Measurement steward","responsibilities":["Assess procedure, conditions, calibration evidence and uncertainty"]},{"name":"Collection operator","responsibilities":["Supply authenticated export and delivery evidence without changing source meaning"]},{"name":"Data quality reviewer","responsibilities":["Review gaps, estimates, derivations and unresolved defects"]},{"name":"Access and records officer","responsibilities":["Approve disclosure, retention, holds and disposal"]},{"name":"Authorized consumer","responsibilities":["Use only permitted views with their stated limitations"]}],"masterSystems":["Supervisory control and data acquisition system","Meter data management system","Network monitoring and flow collector","Time series historian"]},"relations":[{"target":"WM-BLT-003","type":"references","note":"Candidate registry parent reconciled as network-context reference, not inheritance. Pin topology version and observation scope; network lifecycle stays external."},{"target":"WM-FLW-008","type":"references","note":"Optional downstream balance context. Referenced model owns conservation and material-balance reasoning, not this telemetry stream."},{"target":"WM-FLW-015","type":"references","note":"Optional downstream consumption context. Telemetry does not itself establish consumed or billable quantity."},{"target":"IPFIX RFC 7011 and RFC 7012","type":"aligned","note":"Packet-flow profile only; exact templates and field registry versions require tested bindings."},{"target":"OGC SensorThings API Sensing 1.1","type":"aligned","note":"Observation profile only. Sensor changes may require separate target Datastreams even when local logical continuity is retained."},{"target":"SOSA/SSN 2017","type":"aligned","note":"Reference sensor, procedure, observed property and feature concepts without taking ownership of actuation."},{"target":"PROV-O 2013","type":"aligned","note":"Lineage and attribution alignment, not certification of measurement truth."},{"target":"SenML RFC 8428","type":"aligned","note":"Measurement serialization alignment; preserve base fields and distinguish integrated sums from event counters."},{"target":"WM-BLT-003 Infrastructure Network","type":"neighbor","note":"The registry parent is contextual organization, not inheritance of network structure. Reference a versioned node, link, interface or observation region; topology stays in the network master."},{"target":"Sensor, observation and collector masters","type":"neighbor","note":"The stream has persistent identity and membership rules. Sensors, individual measurements and collection sessions retain their own identities and lifecycle; this model stores references and stream-specific qualifications."},{"target":"WM-FLW-008 Mass-balance / Material Flow and WM-FLW-015 Resource Consumption","type":"neighbor","note":"Telemetry can supply observations to balances or consumption assessment; it does not assert conservation, loss, billable consumption or causal diagnosis. Quantity, sign, interval and uncertainty must be compatible before comparison."},{"target":"Actuation, incident and general event records","type":"neighbor","note":"Telemetry observations and local quality assessments do not authorize intervention. Irregular and event-triggered observations are allowed; a generic operational event log is a different subject."},{"target":"WM-BLT-003","type":"parent"}],"interaction":{"identity":{"applicability":"required","items":["Identified by the measurement point identifier in the operator's network register plus the measured quantity.","Individual values are addressed by stream identifier and interval time stamp."]},"properties":{"applicability":"required","items":["Flow rate in the unit of the medium, such as cubic metres per hour, kilowatts or bits per second.","Pressure in bar, voltage in volts or packet rate in packets per second where measured.","Sampling interval in seconds or minutes and time stamp precision.","Measurement uncertainty from meter class and calibration date."]},"recognition":{"applicability":"required","items":["Recognized as a series of time-stamped values tied to one measurement point and quantity.","Often confused with the meter, with event logs or with the network topology."]},"capabilities":{"applicability":"required","items":["Supports near-real-time monitoring, alarms and control decisions.","Supports balancing and loss detection by comparing inflows and outflows.","Can be aggregated into billing, planning and capacity figures."]},"hazards":{"applicability":"required","items":["Undetected leaks, overloads or intrusions when streams fail or are tampered with.","Privacy exposure from fine-grained consumption or traffic records.","Wrong operational decisions from unflagged estimated values."]},"interfaces":{"applicability":"required","items":["IETF IPFIX and NetFlow for data network flow records.","IEC 61968 and IEC 61970 Common Information Model for power network data.","OPC UA for industrial telemetry.","OGC SensorThings API for sensor observations."]},"context":{"applicability":"required","items":["Produced by utilities, transport operators and data network operators.","Smart meter and communications data fall under data protection and, for traffic data, electronic communications privacy law."]}},"sources":[{"title":"Specification of the IP Flow Information Export (IPFIX) Protocol for the Exchange of Flow Information","url":"https://www.rfc-editor.org/rfc/rfc7011","note":"Internet Engineering Task Force"},{"title":"Information Model for IP Flow Information Export (IPFIX)","url":"https://www.rfc-editor.org/rfc/rfc7012.html","note":"Internet Engineering Task Force"},{"title":"Sampling and Filtering Techniques for IP Packet Selection","url":"https://www.rfc-editor.org/rfc/rfc5475","note":"Internet Engineering Task Force"},{"title":"OGC SensorThings API Part 1: Sensing Version 1.1","url":"https://docs.ogc.org/is/18-088/18-088.html","note":"Open Geospatial Consortium"},{"title":"Semantic Sensor Network Ontology","url":"https://www.w3.org/TR/2017/REC-vocab-ssn-20171019/","note":"World Wide Web Consortium"},{"title":"PROV-O: The PROV Ontology","url":"https://www.w3.org/TR/2013/REC-prov-o-20130430/","note":"World Wide Web Consortium"},{"title":"Sensor Measurement Lists (SenML)","url":"https://www.rfc-editor.org/rfc/rfc8428","note":"Internet Engineering Task Force"},{"title":"Date and Time on the Internet: Timestamps","url":"https://www.rfc-editor.org/rfc/rfc3339","note":"Internet Engineering Task Force"},{"title":"RFC 7011 IP Flow Information Export (IPFIX) protocol, IETF"},{"title":"IEC 61970 Energy management system application program interface, Common Information Model, IEC"},{"title":"OGC SensorThings API, Open Geospatial Consortium"}],"openQuestions":["Run the prepared source checker outside the sandbox and review document errata, exact versions, field registries and source applicability; restore independent external review before canonical promotion.","Develop physical-domain and packet-flow adoption profiles with competent metrology, access, records, security and operational authorities.","Implement and test nested schemas and mappings using repeated timestamps, sensor replacement, clock uncertainty, missing templates, reset versus wrap, replay, overlapping scopes and late corrections.","Independent external review is absent; the separate local no-tools audit is a self-audit.","Direct HTTP checks are unattempted under the owner-reported sandbox restriction; source status, errata and latest applicable versions remain to be verified outside the sandbox.","Physical domain profiles for water, gas, power and transport require specialist metrology, sign, reference-condition and regulatory review; no conservation or billing engine is supplied.","Nested instance schemas, IPFIX template/field registry pins, SensorThings and SenML mappings, throughput behavior and adversarial fixtures remain unimplemented.","Current cryptographic transport recommendations, jurisdictional privacy rules and retention periods require adoption review; no legal or security certification is claimed."],"resources":{"spec":"/models/wm-flw-014-network-flow-telemetry-stream/spec.yaml","agents":"/models/wm-flw-014-network-flow-telemetry-stream/AGENTS.md","source":"https://github.com/ver-cy/world-models/tree/feat/mega-model-registry/research/runs/wm-flw-014"},"provenance":{"origin":"world-models research","builtFrom":["models/wm-flw-014-network-flow-telemetry-stream/spec.yaml","ver-cy/world-models/card-supplements/wm-flw-014-network-flow-telemetry-stream.json"],"providers":["Codex"],"researchStatus":"reviewable-draft","generatedAt":"2026-10-06T20:57:02Z","builder":"tools/build_cards.py@1.0.0"},"completeness":{"sections":{"classifiers":"filled","whatItIs":"filled","purpose":"filled","distinguishingFeatures":"filled","structure":"filled","agentConduct":"filled","ethics":"filled","owners":"filled","relations":"filled","interaction.identity":"filled","interaction.properties":"filled","interaction.recognition":"filled","interaction.capabilities":"filled","interaction.hazards":"filled","interaction.interfaces":"filled","interaction.context":"filled","sources":"filled"},"notes":{"_supplement":"Sections authored in card supplement 1.0.0 by Claude (Opus 5.5) (2026-10-06, unreviewed). Written from the card's existing content and established practice in the field; no new sources were read. Unreviewed."},"score":1.0}}