StoneCypher / jssm / 7a78a33d9aca1f17fdf7dbab672b8e31623bbd8e

100%

master: 100%

Pull #973

github

docs(specs): checkpoint the org work-visibility corpus design

Design checkpoint for generalizing the timeline_analysis prototype into a
multi-repo corpus and timeline, driven by a real goal: a senior leader who
feels he does not know what engineering is doing.

Ten decisions recorded with rationale. The load-bearing ones:

- Two allowlists, repos and people, because "may proprietary diffs go to an
  LLM" is a policy question the tool cannot answer for itself. Nothing enters
  the pipeline implicitly.
- A GitHub App rather than an Action, since a per-repo Action structurally
  cannot answer "what did this person do across the org". The App's
  repo-selection screen then IS the repo allowlist, natively and with an audit
  trail, which removes a mechanism we would otherwise have built. Kept
  auth-only so it does not become a hosted service.
- Allowlist by stable numeric ID, never by login or owner/name; both are
  renameable and can come to point at someone or something else.
- Work-centric primary view with person as a drill-down, and no aggregate
  per-person number anywhere. An executive without context reads any
  per-person view as productivity regardless of its label.
- The corpus must display what it cannot see. Diff-derived attribution is
  biased directionally, not randomly: it under-credits reviewers, designers
  and mentors and over-credits volume. Demonstrated live while writing this --
  a jssm-only search found one fork PR by a contributor whose actual
  participation was nine design issues in the fsl tracker plus offline
  conversation no query can reach.

Explicitly a checkpoint, not a finished spec. The brainstorm stopped before
proposing approaches; the OPEN section says where to resume and names the two
hazards worth deciding first -- the multi-repo schema shape, and identity
mapping, which could hole three decisions at once if the workplace is not on
GitHub.

3869 of 3869 branches covered (100.0%)

Branch coverage included in aggregate %.

6361 of 6361 relevant lines covered (100.0%)

33378.91 hits per line