Skip to content

Docs advertise kollect.dev/collectedGeneration and kollect.dev/requestedAt annotations the code never reads #423

Closed

Description

@konih

Severity: Low–Medium (GitOps users coding against the docs get nothing)

Evidence

  • docs/ANNOTATIONS-LABELS.md:100-101 lists both annotations as current behaviour (staleness detection; manual reconcile trigger).
  • grep -rln "collectedGeneration\|requestedAt" api internal cmd → no hits.
  • ADR-0202 treats them as a proposal.

Recommended fix

Product decision: either mark them as proposed or not implemented in ANNOTATIONS-LABELS.md, or implement them. Un-documenting is the cheap, honest default.


Source: consolidated multi-model review (2026-10-04, verified at 34cfeaa4); re-verified against main @ e794bb67 (after #413).

Activity

  1. added
    documentationImprovements or additions to documentation
    questionFurther information is requested
    on Oct 5, 2026
  2. konih commented on Oct 25, 2026

    @konih
    CollaboratorAuthor

    Resolved by #455 (OpenSpec change 2026-10-06-product-decision-convergence), archived in #498 (merge 0233135); the requirements now live under openspec/specs/.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationquestionFurther information is requested

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions