pam-python 0.2.11__tar.gz → 0.2.13__tar.gz

{pam_python-0.2.11/pam_python.egg-info → pam_python-0.2.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pam-python
-Version: 0.2.11
+Version: 0.2.13
 Summary: Pam Python Library
 Author-email: Narongrit Kanhanoi <narongrit@pams.ai>
 Project-URL: Homepage, https://github.com/heart/pam-python

{pam_python-0.2.11 → pam_python-0.2.13}/pam/__init__.py

@@ -1,3 +1,3 @@
 """PAM Data Plugin framework."""
 
-__version__ = "0.2.11"
+__version__ = "0.2.13"

{pam_python-0.2.11 → pam_python-0.2.13}/pam/cli.py

@@ -21,6 +21,7 @@ COMMON_PROJECT_TEMPLATES = {
     "buildcmd/pamb-base.sh": "pamb-base.sh",
     "init/pylintrc.tmpl": ".pylintrc",
     "init/REPORTS.md": "REPORTS.md",
+    "init/REPORTS-th.md": "REPORTS-th.md",
     "init/AGENT.md": "AGENT.md",
     "init/gitignore.tmpl": ".gitignore",
     "init/dockerignore.tmpl": ".dockerignore",

{pam_python-0.2.11 → pam_python-0.2.13}/pam/reports/__init__.py

@@ -31,6 +31,7 @@ from pam.reports.range_bar import RangeBarChartReport
 from pam.reports.scatter import ScatterChartReport
 from pam.reports.store import ReportStore
 from pam.reports.table import TableReport
+from pam.reports.temporal import TemporalMode
 from pam.reports.treemap import TreemapReport
 
 __all__ = [
@@ -68,6 +69,7 @@ __all__ = [
     "ScatterChartReport",
     "Sum",
     "TableReport",
+    "TemporalMode",
     "TimeRangeTransform",
     "TreemapReport",
 ]

{pam_python-0.2.11 → pam_python-0.2.13}/pam/reports/area.py

@@ -8,6 +8,7 @@ from pam.reports.definition import ReportDefinition
 from pam.reports.errors import ReportStoreValidationError
 from pam.reports.fields import Dimension, Measure
 from pam.reports.range_transform import TimeRangeTransform, normalize_range_transform
+from pam.reports.temporal import TemporalMode, normalize_temporal_mode
 
 
 AREA_RENDERER = "area"
@@ -50,6 +51,7 @@ class AreaChartReport(TypedCollectionReport):
         series: Optional[Dimension] = None,
         stacked: bool = False,
         range_transform: Optional[TimeRangeTransform] = None,
+        temporal_mode: Optional[TemporalMode] = None,
     ):
         if not isinstance(stacked, bool):
             raise ReportStoreValidationError("Area stacked must be boolean")
@@ -61,6 +63,13 @@ class AreaChartReport(TypedCollectionReport):
         normalized_range_transform = normalize_range_transform(
             range_transform, granularity, normalized_values, "Area Chart"
         )
+        normalized_temporal_mode = normalize_temporal_mode(
+            temporal_mode,
+            granularity,
+            normalized_values,
+            "Area Chart",
+            range_transform,
+        )
         definition = ReportDefinition.create(
             report_type="area",
             contract_version=AREA_CONTRACT_VERSION,
@@ -72,6 +81,7 @@ class AreaChartReport(TypedCollectionReport):
             },
             options={"stacked": stacked},
             range_transform=normalized_range_transform,
+            temporal_mode=normalized_temporal_mode,
         )
         report = store._declare_typed_report(
             key=key,

{pam_python-0.2.11 → pam_python-0.2.13}/pam/reports/bar.py

@@ -8,6 +8,7 @@ from pam.reports.definition import ReportDefinition
 from pam.reports.errors import ReportStoreValidationError
 from pam.reports.fields import Dimension, Measure
 from pam.reports.range_transform import TimeRangeTransform, normalize_range_transform
+from pam.reports.temporal import TemporalMode, normalize_temporal_mode
 
 
 BAR_RENDERER = "bar"
@@ -56,6 +57,7 @@ class BarChartReport(TypedCollectionReport):
         orientation: str = "vertical",
         stacked: bool = False,
         range_transform: Optional[TimeRangeTransform] = None,
+        temporal_mode: Optional[TemporalMode] = None,
     ):
         if not isinstance(category, Dimension):
             raise ReportStoreValidationError(
@@ -110,6 +112,13 @@ class BarChartReport(TypedCollectionReport):
         normalized_range_transform = normalize_range_transform(
             range_transform, granularity, normalized_values, "Bar Chart"
         )
+        normalized_temporal_mode = normalize_temporal_mode(
+            temporal_mode,
+            granularity,
+            normalized_values,
+            "Bar Chart",
+            range_transform,
+        )
         definition = ReportDefinition.create(
             report_type="bar",
             contract_version=BAR_CONTRACT_VERSION,
@@ -121,6 +130,7 @@ class BarChartReport(TypedCollectionReport):
             },
             options={"orientation": orientation, "stacked": stacked},
             range_transform=normalized_range_transform,
+            temporal_mode=normalized_temporal_mode,
         )
         report = store._declare_typed_report(
             key=key,

{pam_python-0.2.11 → pam_python-0.2.13}/pam/reports/definition.py

@@ -18,6 +18,7 @@ class ReportDefinition:
     binding: Dict[str, Any]
     options: Dict[str, Any] = field(default_factory=dict)
     range_transform: Optional[Dict[str, Any]] = None
+    temporal_mode: Optional[str] = None
 
     def __post_init__(self) -> None:
         if not isinstance(self.report_type, str) or not self.report_type:
@@ -41,6 +42,17 @@ class ReportDefinition:
             raise ReportStoreValidationError(
                 "range_transform must be a dictionary or None"
             )
+        if self.temporal_mode is not None and self.temporal_mode not in {
+            "AGGREGATE",
+            "SNAPSHOT",
+        }:
+            raise ReportStoreValidationError(
+                "temporal_mode must be AGGREGATE, SNAPSHOT, or None"
+            )
+        if self.temporal_mode is not None and self.range_transform is not None:
+            raise ReportStoreValidationError(
+                "temporal_mode and range_transform cannot be declared together"
+            )
 
         # Validate serializability while the declaration is still close to its caller.
         canonical_json(self.to_dict())
@@ -54,6 +66,7 @@ class ReportDefinition:
         binding: Dict[str, Any],
         options: Dict[str, Any] = None,
         range_transform: Dict[str, Any] = None,
+        temporal_mode: str = None,
     ):
         return cls(
             report_type=report_type,
@@ -64,6 +77,7 @@ class ReportDefinition:
             range_transform=(
                 dict(range_transform) if range_transform is not None else None
             ),
+            temporal_mode=temporal_mode,
         )
 
     def to_dict(self) -> Dict[str, Any]:
@@ -76,6 +90,8 @@ class ReportDefinition:
         }
         if self.range_transform is not None:
             definition["range_transform"] = self.range_transform
+        if self.temporal_mode is not None:
+            definition["temporal_mode"] = self.temporal_mode
         return definition
 
     def to_json(self) -> str:

{pam_python-0.2.11 → pam_python-0.2.13}/pam/reports/donut.py

@@ -8,6 +8,7 @@ from pam.reports.definition import ReportDefinition
 from pam.reports.errors import ReportStoreValidationError
 from pam.reports.fields import Dimension, Measure
 from pam.reports.range_transform import TimeRangeTransform, normalize_range_transform
+from pam.reports.temporal import TemporalMode, normalize_temporal_mode
 
 
 DONUT_RENDERER = "donut"
@@ -51,6 +52,7 @@ class DonutChartReport(TypedCollectionReport):
         category: Dimension,
         value: Measure,
         range_transform: Optional[TimeRangeTransform] = None,
+        temporal_mode: Optional[TemporalMode] = None,
     ):
         if not isinstance(category, Dimension):
             raise ReportStoreValidationError(
@@ -80,12 +82,16 @@ class DonutChartReport(TypedCollectionReport):
         normalized_range_transform = normalize_range_transform(
             range_transform, granularity, (value,), "Donut"
         )
+        normalized_temporal_mode = normalize_temporal_mode(
+            temporal_mode, granularity, (value,), "Donut", range_transform
+        )
         definition = ReportDefinition.create(
             report_type="donut",
             contract_version=DONUT_CONTRACT_VERSION,
             fields=(category, value),
             binding={"category": category.name, "value": value.name},
             range_transform=normalized_range_transform,
+            temporal_mode=normalized_temporal_mode,
         )
         report = store._declare_typed_report(
             key=key,

{pam_python-0.2.11 → pam_python-0.2.13}/pam/reports/line.py

@@ -8,6 +8,7 @@ from pam.reports.definition import ReportDefinition
 from pam.reports.errors import ReportStoreValidationError
 from pam.reports.fields import Dimension, Measure
 from pam.reports.range_transform import TimeRangeTransform, normalize_range_transform
+from pam.reports.temporal import TemporalMode, normalize_temporal_mode
 
 
 LINE_RENDERER = "line"
@@ -46,6 +47,7 @@ class LineChartReport(TypedCollectionReport):
         values: Iterable[Measure],
         series: Optional[Dimension] = None,
         range_transform: Optional[TimeRangeTransform] = None,
+        temporal_mode: Optional[TemporalMode] = None,
     ):
         if granularity == "NONE":
             raise ReportStoreValidationError("Line granularity must be DAY or MONTH")
@@ -55,6 +57,13 @@ class LineChartReport(TypedCollectionReport):
         normalized_range_transform = normalize_range_transform(
             range_transform, granularity, normalized_values, "Line"
         )
+        normalized_temporal_mode = normalize_temporal_mode(
+            temporal_mode,
+            granularity,
+            normalized_values,
+            "Line",
+            range_transform,
+        )
         definition = ReportDefinition.create(
             report_type="line",
             contract_version=LINE_CONTRACT_VERSION,
@@ -65,6 +74,7 @@ class LineChartReport(TypedCollectionReport):
                 "values": [value.name for value in normalized_values],
             },
             range_transform=normalized_range_transform,
+            temporal_mode=normalized_temporal_mode,
         )
         report = store._declare_typed_report(
             key=key,

{pam_python-0.2.11 → pam_python-0.2.13}/pam/reports/metric.py

@@ -7,6 +7,7 @@ from pam.reports.errors import ReportStoreValidationError
 from pam.reports.fields import Measure
 from pam.reports.record import ReportRecord, build_record_key, validate_partition_key
 from pam.reports.range_transform import TimeRangeTransform, normalize_range_transform
+from pam.reports.temporal import TemporalMode, normalize_temporal_mode
 
 
 METRIC_RENDERER = "metric"
@@ -31,6 +32,7 @@ class MetricReport:
         granularity: str,
         metrics: Iterable[Measure],
         range_transform: Optional[TimeRangeTransform] = None,
+        temporal_mode: Optional[TemporalMode] = None,
     ):
         if isinstance(metrics, (str, bytes)):
             raise ReportStoreValidationError("metrics must contain Measure declarations")
@@ -50,6 +52,13 @@ class MetricReport:
         normalized_range_transform = normalize_range_transform(
             range_transform, granularity, normalized_metrics, "Metric"
         )
+        normalized_temporal_mode = normalize_temporal_mode(
+            temporal_mode,
+            granularity,
+            normalized_metrics,
+            "Metric",
+            range_transform,
+        )
 
         definition = ReportDefinition.create(
             report_type="metric",
@@ -57,6 +66,7 @@ class MetricReport:
             fields=normalized_metrics,
             binding={"metrics": [metric.name for metric in normalized_metrics]},
             range_transform=normalized_range_transform,
+            temporal_mode=normalized_temporal_mode,
         )
         report = store._declare_typed_report(
             key=key,

{pam_python-0.2.11 → pam_python-0.2.13}/pam/reports/pie.py

@@ -8,6 +8,7 @@ from pam.reports.definition import ReportDefinition
 from pam.reports.errors import ReportStoreValidationError
 from pam.reports.fields import Dimension, Measure
 from pam.reports.range_transform import TimeRangeTransform, normalize_range_transform
+from pam.reports.temporal import TemporalMode, normalize_temporal_mode
 
 
 PIE_RENDERER = "pie"
@@ -51,6 +52,7 @@ class PieChartReport(TypedCollectionReport):
         category: Dimension,
         value: Measure,
         range_transform: Optional[TimeRangeTransform] = None,
+        temporal_mode: Optional[TemporalMode] = None,
     ):
         if not isinstance(category, Dimension):
             raise ReportStoreValidationError(
@@ -80,12 +82,16 @@ class PieChartReport(TypedCollectionReport):
         normalized_range_transform = normalize_range_transform(
             range_transform, granularity, (value,), "Pie"
         )
+        normalized_temporal_mode = normalize_temporal_mode(
+            temporal_mode, granularity, (value,), "Pie", range_transform
+        )
         definition = ReportDefinition.create(
             report_type="pie",
             contract_version=PIE_CONTRACT_VERSION,
             fields=(category, value),
             binding={"category": category.name, "value": value.name},
             range_transform=normalized_range_transform,
+            temporal_mode=normalized_temporal_mode,
         )
         report = store._declare_typed_report(
             key=key,

{pam_python-0.2.11 → pam_python-0.2.13}/pam/reports/polar_area.py

@@ -8,6 +8,7 @@ from pam.reports.definition import ReportDefinition
 from pam.reports.errors import ReportStoreValidationError
 from pam.reports.fields import Dimension, Measure
 from pam.reports.range_transform import TimeRangeTransform, normalize_range_transform
+from pam.reports.temporal import TemporalMode, normalize_temporal_mode
 
 
 POLAR_AREA_RENDERER = "polar_area"
@@ -52,6 +53,7 @@ class PolarAreaChartReport(TypedCollectionReport):
         category: Dimension,
         value: Measure,
         range_transform: Optional[TimeRangeTransform] = None,
+        temporal_mode: Optional[TemporalMode] = None,
     ):
         if not isinstance(category, Dimension):
             raise ReportStoreValidationError(
@@ -81,12 +83,16 @@ class PolarAreaChartReport(TypedCollectionReport):
         normalized_range_transform = normalize_range_transform(
             range_transform, granularity, (value,), "Polar Area"
         )
+        normalized_temporal_mode = normalize_temporal_mode(
+            temporal_mode, granularity, (value,), "Polar Area", range_transform
+        )
         definition = ReportDefinition.create(
             report_type="polar_area",
             contract_version=POLAR_AREA_CONTRACT_VERSION,
             fields=(category, value),
             binding={"category": category.name, "value": value.name},
             range_transform=normalized_range_transform,
+            temporal_mode=normalized_temporal_mode,
         )
         report = store._declare_typed_report(
             key=key,

{pam_python-0.2.11 → pam_python-0.2.13}/pam/reports/radial_bar.py

@@ -9,6 +9,7 @@ from pam.reports.errors import ReportStoreValidationError
 from pam.reports.fields import Measure
 from pam.reports.record import ReportRecord, build_record_key, validate_partition_key
 from pam.reports.range_transform import TimeRangeTransform, normalize_range_transform
+from pam.reports.temporal import TemporalMode, normalize_temporal_mode
 
 
 RADIAL_BAR_RENDERER = "radial_bar"
@@ -32,6 +33,7 @@ class RadialBarChartReport:
         cls, store, key: str, granularity: str, metrics: Iterable[Measure],
         min_value: float, max_value: float,
         range_transform: Optional[TimeRangeTransform] = None,
+        temporal_mode: Optional[TemporalMode] = None,
     ):
         try:
             normalized_metrics = tuple(metrics)
@@ -66,6 +68,13 @@ class RadialBarChartReport:
         normalized_transform = normalize_range_transform(
             range_transform, granularity, normalized_metrics, "Radial Bar"
         )
+        normalized_temporal_mode = normalize_temporal_mode(
+            temporal_mode,
+            granularity,
+            normalized_metrics,
+            "Radial Bar",
+            range_transform,
+        )
         definition = ReportDefinition.create(
             report_type="radial_bar",
             contract_version=RADIAL_BAR_CONTRACT_VERSION,
@@ -73,6 +82,7 @@ class RadialBarChartReport:
             binding={"metrics": [metric.name for metric in normalized_metrics]},
             options={"min_value": min_value, "max_value": max_value},
             range_transform=normalized_transform,
+            temporal_mode=normalized_temporal_mode,
         )
         report = store._declare_typed_report(
             key, RADIAL_BAR_RENDERER, RADIAL_BAR_SCHEMA, granularity,

{pam_python-0.2.11 → pam_python-0.2.13}/pam/reports/store.py

@@ -45,6 +45,7 @@ from pam.reports.schema import (
     STORE_VERSION,
 )
 from pam.reports.table import TableReport
+from pam.reports.temporal import TemporalMode
 from pam.reports.treemap import TreemapReport
 
 
@@ -155,9 +156,10 @@ class ReportStore:
         key: str,
         granularity: str,
         columns: Iterable[Field],
+        temporal_mode: Optional[TemporalMode] = None,
     ) -> TableReport:
         """Declare a typed Table report."""
-        return TableReport.declare(self, key, granularity, columns)
+        return TableReport.declare(self, key, granularity, columns, temporal_mode)
 
     def metric(
         self,
@@ -165,10 +167,11 @@ class ReportStore:
         granularity: str,
         metrics: Iterable[Measure],
         range_transform: Optional[TimeRangeTransform] = None,
+        temporal_mode: Optional[TemporalMode] = None,
     ) -> MetricReport:
         """Declare a typed Metric report."""
         return MetricReport.declare(
-            self, key, granularity, metrics, range_transform
+            self, key, granularity, metrics, range_transform, temporal_mode
         )
 
     def line_chart(
@@ -178,10 +181,11 @@ class ReportStore:
         values: Iterable[Measure],
         series: Optional[Dimension] = None,
         range_transform: Optional[TimeRangeTransform] = None,
+        temporal_mode: Optional[TemporalMode] = None,
     ) -> LineChartReport:
         """Declare a typed Line Chart report."""
         return LineChartReport.declare(
-            self, key, granularity, values, series, range_transform
+            self, key, granularity, values, series, range_transform, temporal_mode
         )
 
     def area_chart(
@@ -192,10 +196,18 @@ class ReportStore:
         series: Optional[Dimension] = None,
         stacked: bool = False,
         range_transform: Optional[TimeRangeTransform] = None,
+        temporal_mode: Optional[TemporalMode] = None,
     ) -> AreaChartReport:
         """Declare a typed Area Chart report."""
         return AreaChartReport.declare(
-            self, key, granularity, values, series, stacked, range_transform
+            self,
+            key,
+            granularity,
+            values,
+            series,
+            stacked,
+            range_transform,
+            temporal_mode,
         )
 
     def bar_chart(
@@ -208,6 +220,7 @@ class ReportStore:
         orientation: str = "vertical",
         stacked: bool = False,
         range_transform: Optional[TimeRangeTransform] = None,
+        temporal_mode: Optional[TemporalMode] = None,
     ) -> BarChartReport:
         """Declare a typed Bar/Column Chart report."""
         return BarChartReport.declare(
@@ -220,6 +233,7 @@ class ReportStore:
             orientation,
             stacked,
             range_transform,
+            temporal_mode,
         )
 
     def pie_chart(
@@ -229,10 +243,11 @@ class ReportStore:
         category: Dimension,
         value: Measure,
         range_transform: Optional[TimeRangeTransform] = None,
+        temporal_mode: Optional[TemporalMode] = None,
     ) -> PieChartReport:
         """Declare a typed Pie Chart report."""
         return PieChartReport.declare(
-            self, key, granularity, category, value, range_transform
+            self, key, granularity, category, value, range_transform, temporal_mode
         )
 
     def donut_chart(
@@ -242,10 +257,11 @@ class ReportStore:
         category: Dimension,
         value: Measure,
         range_transform: Optional[TimeRangeTransform] = None,
+        temporal_mode: Optional[TemporalMode] = None,
     ) -> DonutChartReport:
         """Declare a typed Donut Chart report."""
         return DonutChartReport.declare(
-            self, key, granularity, category, value, range_transform
+            self, key, granularity, category, value, range_transform, temporal_mode
         )
 
     def radial_bar_chart(
@@ -256,10 +272,18 @@ class ReportStore:
         min_value: float,
         max_value: float,
         range_transform: Optional[TimeRangeTransform] = None,
+        temporal_mode: Optional[TemporalMode] = None,
     ) -> RadialBarChartReport:
         """Declare a typed Radial Bar Chart report."""
         return RadialBarChartReport.declare(
-            self, key, granularity, metrics, min_value, max_value, range_transform
+            self,
+            key,
+            granularity,
+            metrics,
+            min_value,
+            max_value,
+            range_transform,
+            temporal_mode,
         )
 
     def polar_area_chart(
@@ -269,10 +293,11 @@ class ReportStore:
         category: Dimension,
         value: Measure,
         range_transform: Optional[TimeRangeTransform] = None,
+        temporal_mode: Optional[TemporalMode] = None,
     ) -> PolarAreaChartReport:
         """Declare a typed Polar Area Chart report."""
         return PolarAreaChartReport.declare(
-            self, key, granularity, category, value, range_transform
+            self, key, granularity, category, value, range_transform, temporal_mode
         )
 
     def scatter_chart(

{pam_python-0.2.11 → pam_python-0.2.13}/pam/reports/table.py

@@ -6,6 +6,7 @@ from pam.reports.definition import ReportDefinition
 from pam.reports.errors import ReportStoreValidationError
 from pam.reports.fields import Dimension, Field, Measure
 from pam.reports.record import ReportRecord, build_record_key, validate_partition_key
+from pam.reports.temporal import TemporalMode, normalize_temporal_mode
 
 
 TABLE_RENDERER = "table"
@@ -40,6 +41,7 @@ class TableReport:
         key: str,
         granularity: str,
         columns: Iterable[Field],
+        temporal_mode: Optional[TemporalMode] = None,
     ):
         if isinstance(columns, (str, bytes)):
             raise ReportStoreValidationError("columns must contain field declarations")
@@ -63,11 +65,19 @@ class TableReport:
                 "A Table report requires at least one Dimension column"
             )
 
+        measures = tuple(
+            column for column in normalized_columns if isinstance(column, Measure)
+        )
+        normalized_temporal_mode = normalize_temporal_mode(
+            temporal_mode, granularity, measures, "Table"
+        )
+
         definition = ReportDefinition.create(
             report_type="table",
             contract_version=TABLE_CONTRACT_VERSION,
             fields=normalized_columns,
             binding={"columns": [column.name for column in normalized_columns]},
+            temporal_mode=normalized_temporal_mode,
         )
         report = store._declare_typed_report(
             key=key,

pam_python-0.2.13/pam/reports/temporal.py

@@ -0,0 +1,55 @@
+"""Business meaning for records stored across report partitions."""
+
+from enum import Enum
+from typing import Optional, Sequence
+
+from pam.reports.axis import NUMERIC_TYPES
+from pam.reports.errors import ReportStoreValidationError
+from pam.reports.fields import Measure
+
+
+class TemporalMode(str, Enum):
+    """How CMS must interpret a report's values across partitions."""
+
+    AGGREGATE = "AGGREGATE"
+    SNAPSHOT = "SNAPSHOT"
+
+
+def normalize_temporal_mode(
+    temporal_mode,
+    granularity: str,
+    measures: Sequence[Measure],
+    report_name: str,
+    range_transform=None,
+) -> Optional[str]:
+    """Validate one optional temporal declaration and serialize its value."""
+    if temporal_mode is None:
+        return None
+    if not isinstance(temporal_mode, TemporalMode):
+        raise ReportStoreValidationError(
+            f"{report_name} temporal_mode must be TemporalMode.AGGREGATE or "
+            "TemporalMode.SNAPSHOT"
+        )
+    if range_transform is not None:
+        raise ReportStoreValidationError(
+            f"{report_name} cannot declare both temporal_mode and range_transform"
+        )
+    if granularity not in {"DAY", "MONTH"}:
+        raise ReportStoreValidationError(
+            f"{report_name} temporal_mode requires DAY or MONTH granularity"
+        )
+    if not measures:
+        raise ReportStoreValidationError(
+            f"{report_name} temporal_mode requires at least one numeric measure"
+        )
+    non_numeric = sorted(
+        measure.name
+        for measure in measures
+        if measure.value_type not in NUMERIC_TYPES
+    )
+    if non_numeric:
+        raise ReportStoreValidationError(
+            f"{report_name} temporal_mode requires numeric measures; "
+            f"non-numeric measures: {non_numeric}"
+        )
+    return temporal_mode.value

{pam_python-0.2.11 → pam_python-0.2.13}/pam/templates/init/AGENT.md

@@ -503,10 +503,15 @@ name per report merely to separate reports. Never write `_tracker_name` yourself
 the framework propagates the store's tracker name to every V2 pointer. Reopening the
 same file in one service run with a different tracker name is an error.
 
-The framework also publishes the service adapter ID as the Analytics Tracker owner.
-PAM and PAM CMS use that metadata for Hard Refresh routing. Plugin code must not ask
-a user to select an owner, encode the owner in `tracker_name` or `report key`, or add
-an ad-hoc owner field to the pointer.
+The Dynamic Report is a reader of the latest successfully published store. Opening
+or reloading a report must never force-start its Data Plugin: plugin execution is an
+expensive dataflow operation owned by its scheduler or an explicit Data Adapter
+operation. A V2 Dynamic Report may keep `adapter_id` as Data Plugin ownership and
+tracker lookup metadata, together with the selected `adapter_data_attr`, matching
+the original Data Plugin report flow. It must never use `adapter_id` for
+report-triggered execution. Do not require a V2 pointer to move to the
+`analytics-reports` database or to be selected through an Analytic Report Group.
+A report reload only reads the latest published SQLite.
 
 ## Required lifecycle