From c6b8940b23507adadb3a6ef0cc61e3dddf044625 Mon Sep 17 00:00:00 2001 From: agessaman Date: Fri, 7 Aug 2026 13:45:20 -0700 Subject: [PATCH] docs: surface solar provenance in the nav, drop internal integration log MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit solar-conditions-provenance.md was in the tree but absent from the mkdocs nav and unlinked from anywhere, so it never appeared on the docs site. Added under a Project section and linked from the solar command entry, where a reader would look for it. Removes the kg7qin PR integration log — an internal development record that was excluded from the docs build but still shipped in the repo — along with the now-dead exclude glob. --- docs/command-reference.md | 4 + docs/integration/kg7qin-pr-integration-log.md | 95 ------------------- mkdocs.yml | 6 +- 3 files changed, 7 insertions(+), 98 deletions(-) delete mode 100644 docs/integration/kg7qin-pr-integration-log.md diff --git a/docs/command-reference.md b/docs/command-reference.md index 0d32ed4..bd82cfd 100644 --- a/docs/command-reference.md +++ b/docs/command-reference.md @@ -411,6 +411,10 @@ solar - HF band conditions (Open/Closed/Marginal) - Solar activity summary +Data comes from HamQSL and NOAA SWPC. For the provenance of the underlying +`modules/solar_conditions.py` implementation, see +[Solar conditions rewrite provenance](solar-conditions-provenance.md). + --- ### `solarforecast` or `sf` diff --git a/docs/integration/kg7qin-pr-integration-log.md b/docs/integration/kg7qin-pr-integration-log.md deleted file mode 100644 index 2d0161a..0000000 --- a/docs/integration/kg7qin-pr-integration-log.md +++ /dev/null @@ -1,95 +0,0 @@ -# KG7QIN PR Integration Log - -Branch: `integration/kg7qin` -Base: `origin/dev` - -## Policy Constraints -- Exclude `!plugins` command from all integrations. -- Treat command behaviors that create multi-message output as regressions. -- Keep `config.ini.example` and related config templates brief; move long-form docs to `docs/`. - -## Inventory and Initial Classification - -### Stage 1 -- PR #138 - - `accept`: `aa94d23`, `69675ac`, `0be6004`, `6a627c2`, `975d744`, `0cbd764` - - `accept-with-edit`: none - - `drop`: lint-only/shared-sync commits already covered elsewhere -- PR #140 - - `accept`: `38d040a`, `04eba0a` - - `accept-with-edit`: none - - `drop`: broad lint/mypy sweep commit (`7af161e`) unless needed by gate -- PR #147 - - `accept`: `df66761` - - `accept-with-edit`: `ca67ec4` (only if required to restore expected flood-scope/public-channel behavior) - - `drop`: test/lint hygiene commits unless required by gate -- PR #145 - - `accept`: `2272b86` - - `accept-with-edit`: none - - `drop`: broad ruff/sync commits unless required by gate -- PR #155 - - `accept`: `2b896c6` (delta-only post-rebase compatibility) - - `drop`: duplicated #138 history -- PR #156 - - `accept`: `5ac7ae0` (delta-only post-rebase compatibility) - - `drop`: duplicated #147 history - -### Stage 2 -- PR #139 - - `accept`: `7450ac3` - - `accept-with-edit`: `86264d6` docs portions only if concise for config templates - - `drop`: duplicated lint/sync commits -- PR #149 - - `accept`: `88e8fa4`, `f6e1924` - - `accept-with-edit`: none - - `drop`: duplicated lint/sync commits unless required by gate -- PR #148 - - `accept`: `4a96f7f` (partial: `--show-config`, `--show-config-json`, `/admin/config`) - - `accept-with-edit`: `655da24` (keep `!status`, drop `!plugins`, reject any multi-message command behavior) - - `drop`: `9310a38`, `4dd9834` if they are mostly plugins-focused -- PR #154 - - `accept`: `a02c15f` - - `accept-with-edit`: none - - `drop`: none initially -- PR #141 - - `accept-with-edit`: `a8edb80` (preserve single-message behavior) - - `drop`: duplicated lint/sync commits unless required -- PR #157 - - `accept`: `6eb8001` if needed after #148 partial integration - - `drop`: duplicated #148 history -- PR #158 - - `accept`: `b2dddc5` if needed after #149 integration - - `drop`: duplicated #149 history - -### Stage 3 -- PR #142 - - `accept-with-edit`: `a85e6ac`, `f4df680`, `9683abb`, `86b2f53`, `21eed98` (only tests/coverage updates that still reflect current code and policy) - - `drop`: duplicated lint/sync commits -- PR #159 - - `accept`: `6302b07` (targeted ruff/mypy compliance) - -## Execution Records -- Integrated (committed): - - PR #138 full chain (`aa94d23` through `f05d1d0`). - - PR #140 full chain (`38d040a`, `04eba0a`, `7af161e`) with manual conflict resolution. - - PR #145 targeted bugfix (`2272b86`). - - PR #155 delta compatibility (`2b896c6`). - - PR #156 delta compatibility (`5ac7ae0`). - - PR #139 admin server core feature (`7450ac3`). - - PR #154 fortune feature (`a02c15f`). - - PR #141 airplanes feature (`a8edb80`) plus local anti-flood guard patch to force single-message output. - - PR #159 follow-up lint/type fixes (`6302b07`) with conflict-resolution retention of local behavior. -- Skipped / not integrated due high conflict or policy-risk: - - PR #147 main commits (`df66761`, `ca67ec4`) — high conflict against already integrated security/stability stack. - - PR #148 (`655da24`, `4a96f7f`) — high conflict; also coupled with explicitly excluded `!plugins`. - - PR #149 (`88e8fa4`, `f6e1924`) — high conflict in core/web viewer surfaces. - - PR #157 (`6eb8001`) and PR #158 (`b2dddc5`) — dependent follow-ups to skipped/high-conflict UX stack. - - PR #142 coverage expansion commits — conflicted with current branch state and deferred. - -### Validation Snapshot -- `make lint`: passes (`ruff` + `mypy`). -- `make test-no-cov`: failing (22 tests), concentrated in: - - `tests/test_fortune_command.py` (fortune parsing/selection behavior), - - `tests/test_randomline.py` (randomline matching behavior), - - `tests/test_scheduler_logic.py` (`TestZombieAlertEmailSsrfGuard` expectations), - - `tests/test_web_viewer.py` (`TestRestoreEndpointSecurity` expected status codes). diff --git a/mkdocs.yml b/mkdocs.yml index b8285f8..a21d984 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -36,8 +36,6 @@ plugins: - exclude: glob: - local/** - # Internal development log, not user-facing documentation. - - integration/** markdown_extensions: - pymdownx.superfences @@ -80,4 +78,6 @@ nav: - World Cup: worldcup.md - Feed Management: FEEDS.md - FAQ: faq.md - - Upgrade: upgrade.md \ No newline at end of file + - Upgrade: upgrade.md + - Project: + - Solar conditions provenance: solar-conditions-provenance.md \ No newline at end of file