Skip to content

docs: sync ensure_deps/Laminar/Harbor gaps and #112 complexity + tracing CI - #115

Draft
cursor[bot] wants to merge 5 commits into
mainfrom
cursor/engineering-documentation-updates-97ce
Draft

docs: sync ensure_deps/Laminar/Harbor gaps and #112 complexity + tracing CI#115
cursor[bot] wants to merge 5 commits into
mainfrom
cursor/engineering-documentation-updates-97ce

Conversation

@cursor

@cursor cursor Bot commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

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.md
  • docs/superpowers/specs/2026-07-12-complex-debug-probe-design.md
  • docs/superpowers/specs/2026-07-15-tech-debt-cicd-routine-design.md
  • sequence/run-state.md, sequence/research/dossier.md (SPEC count S1–S42)

Codepaths covered

Knowledge gaps addressed

  • Stale logfire in dev / S20 wording (removed in Make CLI tracing explicitly opt in #104)
  • Stale suite counts → 747/4 default, 748/3 with --extra tracing
  • Tone/CLAUDE still saying S1–S41 → S1–S42
  • Complexity budget appearing to live in pyproject.toml mccabe (it does not)
  • Missing Harbor / observability / dep-cache wipe guidance for operators

Verification

  • Re-read complex_runner.py, cli.py, complexity_gate.py, ci.yml, pyproject.toml
  • uv run pytest -q → 747 passed / 4 skipped
  • uv sync --extra tracing && uv run pytest -q → 748 passed / 3 skipped

No runtime code changes.

Open in Web View Automation 

cursoragent and others added 5 commits August 13, 2026 11:02
Record stdlib-by-default + TOOLBENCH_TRACING=1 (#104), suite ~746,
ensure_deps git-show/archive pin (#99) with existence-based wipe pitfall,
and BUILDPLAN T22/T23. Prefer updating AGENTS/SPEC over new pages.

Co-authored-by: Michelle Rojas <mrojas54@users.noreply.github.com>
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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant