docs: sync ensure_deps/Laminar/Harbor gaps and #112 complexity + tracing CI - #114
Draft
cursor[bot] wants to merge 5 commits into
Draft
docs: sync ensure_deps/Laminar/Harbor gaps and #112 complexity + tracing CI#114cursor[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 13, 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
1 participant
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 for code that landed on
mainafter the last merged docs tip (#98). Cherry-picks the verified tip from open #113 onto this designated branch (post-#112main) so one fresher PR supersedes the stack of stale docs drafts.Docs added/updated
AGENTS.md,README.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/provision_worktree— packaged-manifest default + SHA-pinnedgit show/git archive(fix(complex): pin ensure_deps to manifest SHA, not corpus HEAD #99); residual existence-based cache skip (wipe workaround; fix(complex): invalidate dep cache when manifest SHA changes #102 stamp not yet merged)cli.py+observability/+tracing.py—tracingextra +TOOLBENCH_TRACING=1opt-in (Make CLI tracing explicitly opt in #104);devno longer listslogfirebenchmarks/harbor/toolbench-complex/(feat: add WIDS D2 Harbor task #105; build canary only)passivenamed phases +transcript.JsonLines+tests/test_shell_safety.py(refactor: close the Medium tech-debt findings from 20260803 #107)complexity_gate.DEFAULT_THRESHOLDas sole C901 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)gate+tracingjobs in.github/workflows/ci.yml(Fix two checks that appeared to run and didn't: inert complexity budget, CI-skipped real-SDK tracing test #112)Knowledge gaps addressed
devstill includeslogfire, or that a Laminar key alone enables CLI tracingDEFAULT_THRESHOLD, and that an mccabe key inpyproject.tomldoes nothinggatecan green while lmnr-guarded tests skip — fixed by the dedicatedtracingjobvendor-cache-<uid>/<repo>/; do not document unmerged fix(complex): invalidate dep cache when manifest SHA changes #102 stamp behavior as shipped)--extra tracing), verified locally on this tipSupersedes
Open docs drafts #100, #101, #103, #108, #109, #110, #111, #113 (same verified content; this branch is the designated tip for this run).
Test plan
src/toolbench/*,pyproject.toml,.github/workflows/ci.ymluv run pytest -q→ 747 passed, 4 skippeduv run --extra tracing pytest -q→ 748 passed, 3 skipped