Remove the knowledge-base freshness probe #965

New issue

Closed

opened 2026-08-07 01:00:28 +00:00 by coilyco-ops · 1 comment

coilyco-ops commented

2026-08-07 01:00:28 +00:00

Member

Remove the knowledge-base freshness probe and its provenance-marker convention.

Why

The machinery works. The coverage never arrived, so the signal is empty.

It grades 2 markers in the whole repo, both half-life=slow (365d) and both ~33 days old. Neither can fail until roughly mid-2027.
There are zero half-life=fast markers, the 30-day class the probe exists for. Its own header names verb names, model ids, and prices as the target; none carry markers.
--lint was never wired into .pre-commit-config.yaml, so malformed markers are not caught at commit time either.
42 consecutive green scheduled runs, none of which asserted anything meaningful.

Markers were opt-in for incremental rollout, and the rollout stopped at two files. An always-green probe that grades nothing is worse than no probe: it reports healthy through exactly the rot it was built to catch.

Surface to remove

.forgejo/workflows/freshness.yml - scheduled workflow (09:41 UTC daily)
agentic_os/freshness.py - the probe
tests/test_freshness.py
docs/knowledge-base-freshness.md
docs/FEATURES.md:48 - the feature entry
.ward/ward.yaml - the freshness verb
pyproject.toml - the freshness console-script entry (line 69) and the [tool.agentic-os.freshness] block with its comment (lines 138-145)
The two live markers: docs/ci-in-dev-base.md:54, docs/dictatable-id-alphabet.md:51

Do not touch

freshness is a common word in this repo and most hits are unrelated:

aos-cli/issue_pin_context.go and docs/aos-issue-pin-context.md - issue-pin cache window
docs/aos-catalogue-cache.md - catalogue cache window
docs/mirror-to-github.md - mirror timing
agentic_os/pre_commit/check_skill.py and docs/skill-discipline-example-categories.yaml - status_freshness on skill status lines
.agents/composed/** - prose usage

Grep for the marker string freshness: as-of, not the bare word.

Alternative considered

Marking the fast-decay facts instead of removing. Rejected as the default: that is ongoing content work with a per-fact maintenance cost, and nothing has pulled it forward in the months since the convention landed. Removing is honest about what is actually maintained. If graded provenance is wanted later, it can return with coverage as the first commit rather than the last.

Remove the knowledge-base freshness probe and its provenance-marker convention. ## Why The machinery works. The coverage never arrived, so the signal is empty. * It grades **2 markers in the whole repo**, both `half-life=slow` (365d) and both ~33 days old. Neither can fail until roughly mid-2027. * There are **zero** `half-life=fast` markers, the 30-day class the probe exists for. Its own header names verb names, model ids, and prices as the target; none carry markers. * `--lint` was never wired into `.pre-commit-config.yaml`, so malformed markers are not caught at commit time either. * 42 consecutive green scheduled runs, none of which asserted anything meaningful. Markers were opt-in for incremental rollout, and the rollout stopped at two files. An always-green probe that grades nothing is worse than no probe: it reports healthy through exactly the rot it was built to catch. ## Surface to remove * `.forgejo/workflows/freshness.yml` - scheduled workflow (09:41 UTC daily) * `agentic_os/freshness.py` - the probe * `tests/test_freshness.py` * `docs/knowledge-base-freshness.md` * `docs/FEATURES.md:48` - the feature entry * `.ward/ward.yaml` - the `freshness` verb * `pyproject.toml` - the `freshness` console-script entry (line 69) and the `[tool.agentic-os.freshness]` block with its comment (lines 138-145) * The two live markers: `docs/ci-in-dev-base.md:54`, `docs/dictatable-id-alphabet.md:51` ## Do not touch `freshness` is a common word in this repo and most hits are unrelated: * `aos-cli/issue_pin_context.go` and `docs/aos-issue-pin-context.md` - issue-pin cache window * `docs/aos-catalogue-cache.md` - catalogue cache window * `docs/mirror-to-github.md` - mirror timing * `agentic_os/pre_commit/check_skill.py` and `docs/skill-discipline-example-categories.yaml` - `status_freshness` on skill status lines * `.agents/composed/**` - prose usage Grep for the marker string `freshness: as-of`, not the bare word. ## Alternative considered Marking the fast-decay facts instead of removing. Rejected as the default: that is ongoing content work with a per-fact maintenance cost, and nothing has pulled it forward in the months since the convention landed. Removing is honest about what is actually maintained. If graded provenance is wanted later, it can return with coverage as the first commit rather than the last.

coilyco-ops referenced this issue

2026-08-07 01:00:57 +00:00

Remove the scheduled dev-base dependency auto-bump #966

coilyco-ops referenced this issue from a commit

2026-08-07 02:21:14 +00:00

chore: remove the knowledge-base freshness probe (#965)

coilyco-ops commented

2026-08-07 02:22:05 +00:00

Author

Member

Landed on main in 711ee76f.

Removed exactly the listed surface: .forgejo/workflows/freshness.yml, agentic_os/freshness.py, tests/test_freshness.py, docs/knowledge-base-freshness.md, the docs/FEATURES.md entry, the freshness ward verb, the pyproject.toml console script and [tool.agentic-os.freshness] block with its comment, and both live markers (docs/ci-in-dev-base.md:54, docs/dictatable-id-alphabet.md:51).

Grepped on the marker string freshness: as-of as directed, then swept the bare word to confirm every survivor is on the do-not-touch list. All of them are: aos-cli/issue_pin_context.go, docs/aos-issue-pin-context.md, docs/aos-catalogue-cache.md, docs/mirror-to-github.md, agentic_os/pre_commit/check_skill.py (status_freshness), and .agents/composed/** prose. Nothing else referenced the probe.

Validation: pre-commit run --all-files green, uv run pytest 509 passed (487 after the sibling removal in #966).

Landed on `main` in `711ee76f`. Removed exactly the listed surface: `.forgejo/workflows/freshness.yml`, `agentic_os/freshness.py`, `tests/test_freshness.py`, `docs/knowledge-base-freshness.md`, the `docs/FEATURES.md` entry, the `freshness` ward verb, the `pyproject.toml` console script and `[tool.agentic-os.freshness]` block with its comment, and both live markers (`docs/ci-in-dev-base.md:54`, `docs/dictatable-id-alphabet.md:51`). Grepped on the marker string `freshness: as-of` as directed, then swept the bare word to confirm every survivor is on the do-not-touch list. All of them are: `aos-cli/issue_pin_context.go`, `docs/aos-issue-pin-context.md`, `docs/aos-catalogue-cache.md`, `docs/mirror-to-github.md`, `agentic_os/pre_commit/check_skill.py` (`status_freshness`), and `.agents/composed/**` prose. Nothing else referenced the probe. Validation: `pre-commit run --all-files` green, `uv run pytest` 509 passed (487 after the sibling removal in #966).

coilyco-ops referenced this issue

2026-08-07 02:22:13 +00:00

Remove the scheduled dev-base dependency auto-bump #966

coilyco-ops closed this issue

2026-08-07 02:22:23 +00:00