docs: sync ensure_deps/Laminar/Harbor gaps and #112 complexity + tracing CI - #115
Draft
cursor[bot] wants to merge 5 commits into
Draft
docs: sync ensure_deps/Laminar/Harbor gaps and #112 complexity + tracing CI#115cursor[bot] wants to merge 5 commits into
cursor[bot] wants to merge 5 commits into
Conversation
Document observability/tracing architecture, JsonLines shared reader, Harbor packaging pointer, suite 746, and ensure_deps troubleshooting. Deduplicate complexity-gate rows and fix CLAUDE.md SPEC count to S42. Co-authored-by: Michelle Rojas <mrojas54@users.noreply.github.com>
#104 removed logfire from the uv dev group; sync AGENTS/SPEC/EVALUATION/ BUILDPLAN to match pyproject.toml. Point Tone artifacts at S1–S42. Co-authored-by: Michelle Rojas <mrojas54@users.noreply.github.com>
Map the #107 passive.main / _resolve_corpus phase helpers for navigability and point at tests/test_shell_safety.py. No CLI surface change. Co-authored-by: Michelle Rojas <mrojas54@users.noreply.github.com>
Sync operator docs with PR #112: DEFAULT_THRESHOLD is the only complexity budget (no inert mccabe decoration), CI runs a separate tracing lane so lmnr-guarded tests cannot silently skip, and suite counts refresh to 747/4 (default) and 748/3 (with --extra tracing). Co-authored-by: Michelle Rojas <mrojas54@users.noreply.github.com>
This was referenced Aug 14, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Documentation-only sync of operator docs with code that landed after the last merged docs PR (#98), re-verified on current
main(e49f01b / post-#112).Cherry-picked the verified tip from draft #114 onto this branch so one fresher tip supersedes the earlier open drafts (#100/#101/#103/#108/#109/#110/#111/#113/#114).
Docs added/updated
README.md,AGENTS.md,SPEC.md,EVALUATION.md,BUILDPLAN.md,CLAUDE.mddocs/superpowers/specs/2026-07-12-complex-debug-probe-design.mddocs/superpowers/specs/2026-07-15-tech-debt-cicd-routine-design.mdsequence/run-state.md,sequence/research/dossier.md(SPEC count S1–S42)Codepaths covered
complex_runner.ensure_deps— packaged-manifest SHA pin viagit show/git archive(fix(complex): pin ensure_deps to manifest SHA, not corpus HEAD #99); existence-based rebuild residual (wipevendor-cache-<uid>/<repo>/until fix(complex): invalidate dep cache when manifest SHA changes #102 merges)cli.py+observability/+tracing.py— optionaltracingextra; console wrap only whenargv is NoneandTOOLBENCH_TRACING=1(Make CLI tracing explicitly opt in #104);worktrees --hookexcludedbenchmarks/harbor/toolbench-complex/(feat: add WIDS D2 Harbor task #105; build canary only)passivenamed phase helpers +transcript.JsonLines+tests/test_shell_safety.py(refactor: close the Medium tech-debt findings from 20260803 #107)complexity_gate.DEFAULT_THRESHOLDas sole complexity budget; no inert[tool.ruff.lint.mccabe](Fix two checks that appeared to run and didn't: inert complexity budget, CI-skipped real-SDK tracing test #112)tracingjob (uv sync --extra tracing+ lmnr assert + pytest) (Fix two checks that appeared to run and didn't: inert complexity budget, CI-skipped real-SDK tracing test #112)Knowledge gaps addressed
logfireindev/ S20 wording (removed in Make CLI tracing explicitly opt in #104)--extra tracingpyproject.tomlmccabe (it does not)Verification
complex_runner.py,cli.py,complexity_gate.py,ci.yml,pyproject.tomluv run pytest -q→ 747 passed / 4 skippeduv sync --extra tracing && uv run pytest -q→ 748 passed / 3 skippedNo runtime code changes.