Skip to content

TR mirror drift in docs/guides/human_approval_gate.md: jq select(.age | test("^[0-9]+d")) on forgelm approvals --pending JSON (DOC-TR08-005) #319

Open

Description

@cemililik

Wave 1 · theme D1-10: Documentation-only fixes · highest severity High · 1 finding(s) · effort docs fix

Summary

Neither: JSON items carry age_seconds (number), no .age; jq errors / filter never matches so stale-approval alert silently never fires.

Primary finding

DOC-TR08-005 — TR mirror drift in docs/guides/human_approval_gate.md: jq select(.age | test("^[0-9]+d")) on forgelm approvals --pending JSON

severity High

Where. EN docs/guides/human_approval_gate.md:99,181 · TR docs/guides/human_approval_gate-tr.md:99,181

English text. jq select(.age | test("^[0-9]+d")) on forgelm approvals --pending JSON

Turkish text. aynı

Which is correct. Neither: JSON items carry age_seconds (number), no .age; jq errors / filter never matches so stale-approval alert silently never fires.

Proposed correction (Turkish text for the -tr page). jq filtresini sayısal alanla yazın: jq -r '.pending[] | select(.age_seconds > 86400) | .run_id' ve gecikme sayımı için jq '[.pending[] | select(.age_seconds > 86400)] | length'.

Acceptance criteria

  • Each statement is re-checked against the code at fix time.
  • Documentation listed above is corrected in English and in its Turkish mirror in the same PR.
  • Every finding in this issue is resolved or explicitly closed with a reason.

Found by the October 2026 ForgeLM code and documentation review against commit cab2947. Code links point at that commit; line numbers may have moved since. Finding IDs (CR-…, DOC-…, TECH-…) are stable references for this backlog.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationi18nEnglish/Turkish documentation mirrorseverity: highWrong behaviour or a false claim users rely onsource: review-2026-10Found by the October 2026 code and documentation reviewwave: 1Roadmap wave 1: high severity, small effort

    Type

    No type

    Projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions