Port os-backlog hooks/session_start.py to Ruby so the journey tracer records it #1522

New issue

Closed

opened 2026-11-03 13:50:42 +00:00 by jared · 2 comments

jared commented

2026-11-03 13:50:42 +00:00

Owner

Problem

The journey tracer (#1514) records in-process Ruby messages. The os-backlog SessionStart hook is Python (plugins/os-backlog/hooks/session_start.py, 109 lines), so no journey can reach it. Ruling 2026-11-02 (session c39c41b9): the unit of a trace is an entry point's use case, and hooks are entry points like CLI commands and bin/ executables. One entry point of os-backlog stays untraceable while it is Python.

Reproduce

n/a: feature ticket; the gap is structural.

Approach

Port the hook to Ruby, following the Ruby hooks that os-aidd-lint and os-me ship. Then tag one journey test for it under #1514's tagging convention. Takedown decides the owner and seam.

Required work: none beyond the acceptance criteria.

Non-goals

Other Python hooks (os-adr pre_tool_use.py and session_start.py, os checks.py). Whether they need the same port is a separate question.

Origin

Trigger: tracing round-table after #1514 widened; handoff 2026-11-03-0000-tracing-round-table-remainder.md; ruled by Jared 2026-11-03
Improvised this session: none
Chain: hook untraceable ← hook is Python ← DESIGN (plugins/os-backlog/hooks/session_start.py predates the Ruby hook convention in os-aidd-lint and os-me)
Root candidate: none found; searched session_start, session_start.py, hooks/, Ruby hook, Python hook, entry point, journey, tracer, os-backlog hook
Where: plugins/os-backlog/hooks/session_start.py
Session: 32008a4e-5b0f-4863-94d9-7afb84ba65b6
Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os/32008a4e-5b0f-4863-94d9-7afb84ba65b6.jsonl

VERDICT: CREATE

## Problem The journey tracer (#1514) records in-process Ruby messages. The os-backlog SessionStart hook is Python (`plugins/os-backlog/hooks/session_start.py`, 109 lines), so no journey can reach it. Ruling 2026-11-02 (session c39c41b9): the unit of a trace is an entry point's use case, and hooks are entry points like CLI commands and `bin/` executables. One entry point of os-backlog stays untraceable while it is Python. ## Reproduce n/a: feature ticket; the gap is structural. ## Approach Port the hook to Ruby, following the Ruby hooks that os-aidd-lint and os-me ship. Then tag one journey test for it under #1514's tagging convention. Takedown decides the owner and seam. Required work: none beyond the acceptance criteria. ## Non-goals Other Python hooks (os-adr `pre_tool_use.py` and `session_start.py`, os `checks.py`). Whether they need the same port is a separate question. ## Origin - Trigger: tracing round-table after #1514 widened; handoff 2026-11-03-0000-tracing-round-table-remainder.md; ruled by Jared 2026-11-03 - Improvised this session: none - Chain: hook untraceable ← hook is Python ← DESIGN (`plugins/os-backlog/hooks/session_start.py` predates the Ruby hook convention in os-aidd-lint and os-me) - Root candidate: none found; searched session_start, session_start.py, hooks/, Ruby hook, Python hook, entry point, journey, tracer, os-backlog hook - Where: plugins/os-backlog/hooks/session_start.py - Session: 32008a4e-5b0f-4863-94d9-7afb84ba65b6 - Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os/32008a4e-5b0f-4863-94d9-7afb84ba65b6.jsonl VERDICT: CREATE

jared added the

plugin/os-backlog

filed-by/user

category/code-change

labels

2026-11-03 13:50:42 +00:00

jared referenced this issue

2026-11-03 13:50:47 +00:00

Tag one use_case test per os-backlog command for journeys #1514

jared commented

2026-11-03 14:03:50 +00:00

Author

Owner

Work started by hand in worktree ticket-1522 (takedown run docs/takedown/1522-20261103-085052; green-suite failed only on the design's own environment-asserting test test_wrapper_does_not_depend_on_bundler, which Jared ruled dropped).

jared commented

2026-11-03 14:06:22 +00:00

Author

Owner

Resolution

Done: Ported the os-backlog SessionStart hook to Ruby: hooks/session_start.rb wraps Backlog::SessionStart and Backlog::SessionNote; the Python file is deleted; output is byte-identical to the Python hook for the same stdin.

Evidence: main b8a64991 (500fe331 code, b8a64991 History row). Suite: 350 runs, 838 assertions, 0 failures. Rubocop: placed files clean; plugin-wide count 36, unchanged from main. Takedown run docs/takedown/1522-20261103-085052; its environment-asserting test test_wrapper_does_not_depend_on_bundler dropped by Jared's ruling (it asserted the host environment, not behavior).

Follow-ups: none; the other Python hooks (os-adr, os) are outside #1514's scope and not a ticket until the map asks for them. Rubocop root Gemfile gap: dropped, documented workaround BUNDLE_GEMFILE=plugins/os-sdlc/Gemfile.

## Resolution **Done:** Ported the os-backlog SessionStart hook to Ruby: hooks/session_start.rb wraps Backlog::SessionStart and Backlog::SessionNote; the Python file is deleted; output is byte-identical to the Python hook for the same stdin. **Evidence:** main b8a64991 (500fe331 code, b8a64991 History row). Suite: 350 runs, 838 assertions, 0 failures. Rubocop: placed files clean; plugin-wide count 36, unchanged from main. Takedown run docs/takedown/1522-20261103-085052; its environment-asserting test test_wrapper_does_not_depend_on_bundler dropped by Jared's ruling (it asserted the host environment, not behavior). **Follow-ups:** none; the other Python hooks (os-adr, os) are outside #1514's scope and not a ticket until the map asks for them. Rubocop root Gemfile gap: dropped, documented workaround BUNDLE_GEMFILE=plugins/os-sdlc/Gemfile.

jared closed this issue

2026-11-03 14:06:22 +00:00

jared referenced this issue from a commit

2026-11-03 14:06:25 +00:00

feat(os-backlog): port SessionStart hook to Ruby (#1522)

jared referenced this issue from a commit

2026-11-03 14:06:25 +00:00

docs(os-backlog): History row for the Ruby SessionStart hook (#1522)

jared referenced this issue from a commit

2026-11-03 14:06:32 +00:00

docs(takedown): record #1522 run 1522-20261103-085052

jared referenced this issue