docs: ensure_deps SHA pin, Laminar opt-in, Harbor WIDS D2, suite 746 - #110
Draft
cursor[bot] wants to merge 4 commits into
Draft
docs: ensure_deps SHA pin, Laminar opt-in, Harbor WIDS D2, suite 746#110cursor[bot] wants to merge 4 commits into
cursor[bot] wants to merge 4 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>
This was referenced Aug 10, 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 after #99 / #97 / #104 / #105 / #107 landed on
main. Supersedes the stale open docs PRs #100 / #101 / #103 / #108 / #109 (those branches either predate later merges, duplicate this tip, or lack the #107 navigability note).Docs added/updated
AGENTS.md,SPEC.md(S20),EVALUATION.md(S20),BUILDPLAN.md(T22/T23)README.md(architecture, complex constraints, troubleshooting, source-of-truth links, passive phase helpers)docs/superpowers/specs/2026-07-12-complex-debug-probe-design.mdCLAUDE.md(S1–S42 count + Harbor / Laminar pointers)sequence/run-state.md+sequence/research/dossier.md(SPEC count S1–S42)Codepaths covered
complex_runner.ensure_deps/_git_show_text/_extract_pinned_tree(fix(complex): pin ensure_deps to manifest SHA, not corpus HEAD #99)cli.py+observability/+tracing.py(TOOLBENCH_TRACING=1, Make CLI tracing explicitly opt in #104)transcript.JsonLinesshared reader +passivenamed phases (refactor: close the Medium tech-debt findings from 20260803 #107)benchmarks/harbor/toolbench-complex/(feat: add WIDS D2 Harbor task #105)shell_safety.pyhermetic tests (tests/test_shell_safety.py)Knowledge gaps addressed
logfirein thedevgroup after Make CLI tracing explicitly opt in #104 removed itensure_depsSHA pin + existence-based cache wipe pitfall undocumented onmain(stamp invalidation in fix(complex): invalidate dep cache when manifest SHA changes #102 is not claimed as shipped)observability//tracing.pyand Harbor entry pointpassive.main/_resolve_corpusphase helpers andJsonLineswere easy to miss when navigating the modulesNotes for reviewers