cernion-forecast-cli 0.2.0__tar.gz

cernion_forecast_cli-0.2.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,97 @@
+name: Bug report
+description: Report a reproducible CLI bug
+title: "bug: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a bug. Do not include API tokens, real customer data, non-public MSCONS files or private market communication payloads. Use synthetic or redacted examples.
+  - type: input
+    id: version
+    attributes:
+      label: CLI version or commit
+      description: Output from `cernion-forecast describe` or the git commit SHA.
+      placeholder: "0.2.0 / d615298"
+    validations:
+      required: true
+  - type: input
+    id: python
+    attributes:
+      label: Python version
+      placeholder: "Python 3.12.3"
+    validations:
+      required: true
+  - type: dropdown
+    id: command
+    attributes:
+      label: Command
+      options:
+        - day-ahead
+        - history
+        - enroll
+        - train
+        - predict
+        - resume
+        - score
+        - acceptance-test
+        - e2e
+        - batch-history
+        - doctor
+        - describe
+        - other
+    validations:
+      required: true
+  - type: dropdown
+    id: input_format
+    attributes:
+      label: Input format
+      options:
+        - JSON
+        - CSV
+        - MSCONS/EDIFACT
+        - no input file
+        - mixed/other
+    validations:
+      required: true
+  - type: textarea
+    id: command_line
+    attributes:
+      label: Command line
+      description: Redact tokens and private paths if needed.
+      render: shell
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior and sanitized output
+      description: Paste the error text after removing secrets and private data.
+      render: text
+    validations:
+      required: true
+  - type: textarea
+    id: minimal_data
+    attributes:
+      label: Minimal sanitized reproduction data
+      description: Prefer synthetic data. Do not attach real customer data or private MSCONS messages.
+      render: json
+    validations:
+      required: false
+  - type: checkboxes
+    id: safety
+    attributes:
+      label: Safety checklist
+      options:
+        - label: I removed API tokens and authorization headers.
+          required: true
+        - label: I removed or masked customer, meter and market-party identifiers unless they are synthetic.
+          required: true
+        - label: I am not attaching non-public MSCONS/EDIFACT payloads.
+          required: true

cernion_forecast_cli-0.2.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,59 @@
+name: Feature request
+description: Suggest a CLI improvement or integration workflow
+title: "feature: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please describe the operational problem, not only the desired flag. Do not include private customer data or API tokens.
+  - type: textarea
+    id: workflow
+    attributes:
+      label: Operational workflow
+      description: What user/system would use this and in which step of the forecast process?
+      placeholder: "Daily EDM export -> history dry-run -> import -> train/predict -> score -> report"
+    validations:
+      required: true
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - input validation
+        - JSON/CSV import
+        - MSCONS/EDIFACT import
+        - weather/site context
+        - training/prediction orchestration
+        - scoring/acceptance
+        - batch/idempotency/logging
+        - documentation/examples
+        - packaging/CI
+        - other
+    validations:
+      required: true
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem to solve
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed behavior
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+    validations:
+      required: false
+  - type: checkboxes
+    id: safety
+    attributes:
+      label: Safety checklist
+      options:
+        - label: This request can be discussed without real customer data, non-public MSCONS payloads or tokens.
+          required: true

cernion_forecast_cli-0.2.0/.github/pull_request_template.md

@@ -0,0 +1,35 @@
+## Summary
+
+- 
+
+## Type of change
+
+- [ ] Bug fix
+- [ ] Feature
+- [ ] Documentation/examples
+- [ ] Tests/CI/packaging
+- [ ] Refactor without behavior change
+
+## Verification
+
+Please paste the commands you ran:
+
+```bash
+python -m unittest discover -s tests -v
+python -m compileall src tests
+cernion-forecast --help
+```
+
+If you changed examples, also run the relevant example commands from `examples/README.md`.
+
+## Data and security checklist
+
+- [ ] No API tokens, authorization headers or secret files are committed.
+- [ ] No real customer data is committed.
+- [ ] No non-public MSCONS/EDIFACT payloads are committed.
+- [ ] Meter, market-party and account identifiers are synthetic or intentionally masked.
+- [ ] Generated artifacts (`runs/`, `out/`, `build/`, `dist/`, `*.egg-info`, `.venv/`, `__pycache__/`, `*.pyc`) are not committed.
+
+## Notes for reviewers
+
+Mention any live API test separately, including only sanitized job IDs/diagnostic IDs and never token values.

cernion_forecast_cli-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,48 @@
+name: ci
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ['3.10', '3.11', '3.12']
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install package
+        run: python -m pip install -e .
+      - name: Unit tests
+        run: python -m unittest discover -s tests -v
+      - name: Compile check
+        run: python -m compileall src tests
+      - name: CLI smoke
+        run: |
+          cernion-forecast --help
+          cernion-forecast describe
+      - name: Validate examples without API writes
+        run: |
+          cernion-forecast history --dry-run \
+            --series-id synthetic-meter-42 \
+            --input examples/data/synthetic_history_35d.json \
+            --quality-policy strict \
+            --expected-intervals auto \
+            --location Berlin \
+            --weather-region DE-BE-Berlin \
+            --country DE \
+            --out runs/ci/synthetic-history-dry-run
+          cernion-forecast score \
+            --series-id synthetic-meter-42 \
+            --predictions examples/predictions/synthetic_previous_week_prediction_2026-09-29.json \
+            --actuals examples/data/synthetic_actuals_2026-09-29.json \
+            --out runs/ci/synthetic-score
+      - name: Build package
+        run: |
+          python -m pip install build
+          python -m build

cernion_forecast_cli-0.2.0/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The project follows semantic-versioning intent. Before `1.0.0`, command names and core artifact names are intended to be stable, but JSON artifact details may still evolve when necessary.
+
+## [0.2.0] - 2026-10-09
+
+### Added
+
+- Production-oriented CLI flows for `history`, `enroll`, `train`, `predict`, `resume`, `score`, `acceptance-test`, `e2e`, `batch-history`, `batch`, `doctor` and `describe`.
+- JSON, CSV and MSCONS/EDIFACT input support.
+- MSCONS envelope provenance preservation in local artifacts and forecast result envelopes.
+- Weather/site/context metadata flags and validation for city-level location semantics.
+- Data-quality reports, idempotency keys, processed-ledger support and structured run artifacts.
+- Forecast scoring with residual exports and threshold exit code `50`.
+- Operational acceptance testing against naive baselines.
+- Live E2E workflow with history-depth preflight requiring at least 28 observed days before D-2 by default.
+- Synthetic example data under `examples/`.
+- Community documentation, security policy and contribution guidance.
+
+### Security
+
+- Token values are read from environment or token files and are not written to artifacts.
+- HTTP redirects are refused to avoid forwarding credentials to unexpected origins.
+
+## [0.1.0] - Initial local version
+
+- Initial command-line client skeleton for CET forecast workflows.

cernion_forecast_cli-0.2.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,24 @@
+# Code of Conduct
+
+This project follows a simple contributor covenant: be respectful, constructive and safety-minded.
+
+## Expected behavior
+
+- Use welcoming and professional language.
+- Focus criticism on code, documentation and reproducible behavior.
+- Respect different levels of energy-market, Python and CLI experience.
+- Redact sensitive operational data before sharing examples.
+- Help maintain a safe environment for contributors and users.
+
+## Unacceptable behavior
+
+- Harassment, threats or personal attacks.
+- Publishing private information, credentials, customer data or non-public market communication payloads.
+- Repeatedly ignoring maintainer requests about safety, scope or data redaction.
+- Disruptive comments that do not help resolve the technical issue.
+
+## Enforcement
+
+Maintainers may edit or remove comments, close issues, block users or take other reasonable steps to protect the project and its users.
+
+Security-sensitive data disclosures may be removed without prior discussion.

cernion_forecast_cli-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,62 @@
+# Contributing
+
+Thank you for considering a contribution to Cernion Forecast CLI.
+
+This project is a command-line integration layer for Cernion Energy Tools (CET) forecast capabilities. Contributions should keep the boundary clear: the CLI normalizes inputs, preserves context/provenance, calls CET REST APIs and writes operational artifacts; it does not implement a replacement forecasting backend.
+
+## Ways to contribute
+
+- Improve documentation, examples or troubleshooting notes.
+- Add support for well-defined input/export formats.
+- Improve validation, diagnostics, exit codes or artifact contracts.
+- Add tests for bugs, edge cases or operational workflows.
+- Report safe, minimal reproductions for failures.
+
+## Safe issue data
+
+Do not upload real customer data, real MSCONS messages, API tokens, credentials, private market-party identifiers or confidential utility documents to GitHub issues or pull requests.
+
+Prefer:
+
+- synthetic examples from `examples/`,
+- minimized JSON/CSV snippets with fake IDs,
+- redacted `run.json` / `quality_report.json` / `doctor.json`,
+- command lines with token values removed.
+
+## Development setup
+
+```bash
+git clone git@github.com:energychain/CernionForecastCLI.git
+cd CernionForecastCLI
+python3 -m venv .venv
+. .venv/bin/activate
+python -m pip install -e .
+```
+
+## Test commands
+
+Run these before opening a pull request:
+
+```bash
+python -m unittest discover -s tests -v
+python -m compileall -q -f src tests
+cernion-forecast describe
+```
+
+The default test suite must not require a CET API token and must not call live tenant-bound APIs. Live API checks belong in manual maintainer workflows or documented local smoke tests.
+
+## Code expectations
+
+- Add or update tests for behavior changes.
+- Keep token values and secrets out of artifacts and logs.
+- Preserve machine-readable artifact compatibility where possible.
+- Use explicit exit codes for job runners instead of relying on console text.
+- Keep examples synthetic unless a public-data source and license are clearly documented.
+
+## Pull request checklist
+
+- [ ] Tests pass locally.
+- [ ] Documentation updated for new flags, input formats or artifacts.
+- [ ] No token, customer data or confidential utility data included.
+- [ ] New behavior has tests or a clear reason why not.
+- [ ] Live API behavior, if relevant, is described separately from local tests.

cernion_forecast_cli-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 STROMDAO GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cernion_forecast_cli-0.2.0/MANIFEST.in

@@ -0,0 +1,11 @@
+include LICENSE
+include README.md
+include CHANGELOG.md
+include CODE_OF_CONDUCT.md
+include CONTRIBUTING.md
+include SECURITY.md
+include SUPPORT.md
+recursive-include docs *.md
+recursive-include examples *.md *.json *.csv
+recursive-include .github *.md *.yml
+recursive-include tests *.py