Observation-class finding, recorded while fixing #9673 (which corrected packages/spec/src/contracts/job-service.ts's JSDoc that called sys_job_run "the execution audit trail"). #9673's scope was that one spec file; this is the same conflation, one layer down, in the object definition itself:
packages/platform-objects/src/audit/sys-job-run.object.ts:32
description: 'Background job execution audit trail',
The binding #9633 ruling: sys_job_run is job run history, not the audit trail; sys_audit_log is the audit surface, with its own opt-in, writer and retention. The file's own header comment (line 6) already gets this right — sys_job_run — Background Job Execution History — but the description field two lines below (the one Studio/Setup surfaces to end users, and the one that propagates into the generated translation bundle, packages/platform-objects/src/apps/translations/en.objects.generated.ts:2375) still says "audit trail". This is more consequential than JSDoc: it's user-facing product copy, not just a .d.ts tooltip.
Suggested fix: change description to something like 'Background job execution history', then regenerate en.objects.generated.ts (products-follow-source — never hand-edit the generated file).
Refs: #9673 · #9633
Generated by Claude Code
Observation-class finding, recorded while fixing #9673 (which corrected
packages/spec/src/contracts/job-service.ts's JSDoc that calledsys_job_run"the execution audit trail"). #9673's scope was that one spec file; this is the same conflation, one layer down, in the object definition itself:The binding #9633 ruling:
sys_job_runis job run history, not the audit trail;sys_audit_logis the audit surface, with its own opt-in, writer and retention. The file's own header comment (line 6) already gets this right —sys_job_run — Background Job Execution History— but thedescriptionfield two lines below (the one Studio/Setup surfaces to end users, and the one that propagates into the generated translation bundle,packages/platform-objects/src/apps/translations/en.objects.generated.ts:2375) still says "audit trail". This is more consequential than JSDoc: it's user-facing product copy, not just a.d.tstooltip.Suggested fix: change
descriptionto something like'Background job execution history', then regenerateen.objects.generated.ts(products-follow-source — never hand-edit the generated file).Refs: #9673 · #9633
Generated by Claude Code