docs(superpowers): consolidate completed artifacts

[therealhieu]

Summary

• Consolidate all completed Superpowers artifacts under docs/superpowers/done/.
• Remove the active/ and archive/ directory split while preserving existing ignored evidence.
• Update documentation and package metadata tests to use canonical done/ paths.

Verification

• node --test test/cli/package-meta.test.ts — 26 passed, 0 failed.
• corepack npm ci — 152 packages installed, 0 vulnerabilities.
• corepack npm run check — 864 passed, 0 failed.
• git diff --check — passed.
• Verified all 90 tracked Superpowers files remain under six done/ projects.
• Verified docs/superpowers/ contains only done/.

Decisions

• Existing ignored evidence in completed project folders remains unchanged.

Risks and Follow-ups

• Documentation-only path consolidation plus its repository path assertion; no runtime behavior changes.

[coderabbitai]

Warning

Review limit reached

@therealhieu, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 47 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 76a37f63-f6e2-4e1d-be42-b4cd4e9d2ec0

📥 Commits

Reviewing files that changed from the base of the PR and between a395c75 and 3398844.

📒 Files selected for processing (1)

• test/cli/package-meta.test.ts

📝 Walkthrough

Walkthrough

This PR adds documentation for Markdown-to-video E2E validation, CLI workflow stabilization, PR completion, visual-integrity remediation, the md2vid upgrade command, guarded dependency automation, and archived planning references.

Changes

Markdown-to-video E2E validation

Layer / File(s)	Summary
E2E records and gate procedures docs/superpowers/done/2026-07-24-md-to-video-e2e/*	Adds E2E checklists, checkpoints, failure remediation, evidence requirements, and explicit release decisions.

CLI workflow stabilization

Layer / File(s)	Summary
CLI contracts and workflow behavior docs/superpowers/done/2026-07-24-stabilize-cli-workflows/*design.md, *goal.md, *plan.md, *plan-1.md	Defines shared CLI parsing, layout resolution, voice identity, verification, and compatibility rules.
Failure-atomic caption regrouping docs/superpowers/done/2026-07-24-stabilize-cli-workflows/*plan-2.md	Defines managed-file staging, verification, promotion, rollback, adapter contracts, and regrouping tests.
Scaffolds, packed workflows, and documentation docs/superpowers/done/2026-07-24-stabilize-cli-workflows/*plan-3.md, *plan-4.md, *check.md	Defines narration onboarding, neutral Remotion scaffolds, packed smoke tests, documentation synchronization, and completion checks.

PR completion and visual integrity

Layer / File(s)	Summary
Completion plan and validation gates docs/superpowers/done/2026-07-26-md2vid-pr-completion/*	Documents controlled validation from candidate tree and package isolation through DNS execution, rendering, evidence handling, cleanup, and authorization.
Visual-integrity diagnosis and remediation docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-27-*	Documents HyperFrames text occlusion reproduction, hit-testing behavior, caption mitigation, and visual-integrity remediation tasks.

md2vid upgrade

Layer / File(s)	Summary
Upgrade command contract and execution docs/superpowers/done/2026-07-27-md2vid-upgrade/*design.md, *goal.md, *plan-1.md	Defines global-installation validation, package upgrade sequencing, fresh CLI invocation, failure handling, recovery, and injected tests.
Upgrade routing, packaging, and documentation docs/superpowers/done/2026-07-27-md2vid-upgrade/*plan-2.md, *plan.md	Defines CLI routing, packed manifest checks, README and skill updates, snapshots, and integration validation.
Upgrade review findings and verification docs/superpowers/done/2026-07-27-md2vid-upgrade/reviews/*	Records review outcomes, symlink and subprocess coverage findings, snapshot synchronization, and verification status.

Guarded dependency automation

Layer / File(s)	Summary
Dependency automation architecture docs/superpowers/done/2026-07-28-auto-dependency-updates/*design.md, *research.md, *plan*.md, *goal.md	Defines grouped patch updates, trusted workflow_run validation, package-version synchronization, and immutable action checks.
Dependency automation reviews docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/*	Adds code-quality, specification, and tester review records with findings, verification results, and residual gaps.

Archived reference

Layer / File(s)	Summary
Archived dependency-design reference docs/superpowers/done/2026-08-01-resolve-open-prs/2026-08-01-resolve-open-prs-plan.md	Updates the dependency automation design reference to its archived location.

Estimated code review effort: 3 (Moderate) | ~30 minutes

Possibly related PRs

• therealhieu/md2vid#22: Relates to the documented md2vid upgrade implementation and validation workflow.
• therealhieu/md2vid#44: Relates to the archived resolve-open-prs dependency-automation reference.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly describes the consolidation of completed Superpowers artifacts under the canonical done directory.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/consolidate-superpowers-artifacts

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 14

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In
`@docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-checklist.md`:
- Around line 72-96: Update the outer Markdown fence surrounding the nested
example in the checklist fixture to use four backticks, while keeping the inner
text fence at three backticks so the entire sample renders as one copyable
Markdown document.

In
`@docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-checkpoint.md`:
- Line 28: Update the evidence Location entry in the checkpoint to use the
canonical docs/superpowers/done path, and replace or remove every remaining
stale docs/superpowers/active or docs/superpowers/archive reference in the same
checkpoint.

In
`@docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-remediation-checklist.md`:
- Around line 433-444: Align the PASS release procedure with the
explicit-authorization rule: in
docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-remediation-checklist.md
lines 433-444, require an explicit user request before commit, push, merge,
version bump, or publish; update lines 16-21 to remove or condition automatic
merge/release wording. Preserve the existing separation of PASS from commit/push
and merge/bump/publish permission in
docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-checkpoint.md
lines 19 and 110-118. Ensure
docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-final-gate-checklist.md
lines 625-636 remains the canonical explicit-authorization release procedure.
- Around line 87-95: Choose one deterministic policy for words starting after
duration_s in “Decide normalization behavior”: either clamp/move them into the
final valid interval or fail with a path-aware error, but remove the
alternative. Update the focused timing-normalization tests and final gate
checklist to enforce the selected behavior while preserving the other stated
validation rules.

In
`@docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-check.md`:
- Around line 5-8: Rewrite all migrated Superpowers references from canonical
active/ paths to done/ paths: update source-document links in
docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-check.md
(lines 5-8), design and plan index paths in
docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-goal.md
(lines 11-15), and both completion-record creation/final paths in
docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-4.md
(lines 210 and 377).

In
`@docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-1.md`:
- Around line 133-143: Update parseCommand so it validates argv with strict
parseArgs before returning the help result, allowing unknown options to be
rejected even when --help or -h is present. Preserve help precedence for
incomplete required option values, and add a regression test covering an unknown
option combined with --help.

In
`@docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-2.md`:
- Around line 172-184: Update Step 4’s backup-path handling to reserve each
deterministic sibling backup path before any promotion, rejecting occupied paths
or allocating a free invocation-owned alternative without overwriting unrelated
files. Preserve the required operation sequence and add a test covering an
existing backup-path collision.

In
`@docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-checkpoint.md`:
- Around line 3-4: Rewrite all relocated Superpowers references from active/ to
canonical done/ paths. In
docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-checkpoint.md:3-4
update goal and evidence paths; design.md:16-20 update source-artifact and
evidence paths; goal.md:9-16 update governing-document paths; plan-1.md:679-683
update Task 5 paths and verification commands; plan-2.md:12-14 update evidence,
design, and completion-artifact paths; plan-3.md:12-15 update reviewed-source,
evidence, checkpoint, and completion-check paths; plan.md:15-20 update
source-artifact, checkpoint, and evidence paths; and
2026-07-27-visual-integrity-fix.md:83-103 update reviewed-input,
historical-evidence, and checkpoint paths.

In
`@docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-plan-3.md`:
- Around line 778-794: Update Step 14’s post-artifact delta check to combine the
tracked changes from git diff --name-only "$VALIDATION_COMMIT" with untracked
files from git ls-files --others --exclude-standard before evaluating
unexpected. Continue allowing only docs/superpowers/ paths, while preserving the
existing evidence output and git diff --check validation.
- Around line 334-346: Update the contamination-scan commands in the build-check
plan to fail closed: capture each rg exit status, treat 0 (forbidden match) and
statuses above 1 (scan error) as gate failures, and allow only status 1 (no
match) to pass. Remove the unconditional || true behavior while preserving the
generated evidence files.

In
`@docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-27-visual-integrity-fix.md`:
- Around line 178-188: Resolve the unchecked completion steps for Task 2 Step 5
and Task 7 Step 6 by verifying that their referenced visual-check evidence
exists; mark each complete only when supported by that evidence, otherwise leave
its state failed or incomplete. Keep the completion records and acceptance
criteria consistent with the resulting status.

In
`@docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-check.md`:
- Around line 21-24: Align the canonical upgrade artifacts with the delivered
implementation: in
docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-check.md:21-24,
qualify the design/plan parity statement with the recorded deviations; in
docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-design.md:86-100,
document linked-entry rejection before npm mutation; in the same design
file:114-138, document re-resolving the lexical global package entry after npm
succeeds; and in
docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-plan-1.md:17-53,
add the delivered isSymbolicLink and packageEntry fields or explicitly record
them as post-plan changes.

In
`@docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-plan-2.md`:
- Around line 322-330: Update Step 6’s snapshot verification commands to invoke
the supported temporary-output form of public:snapshot, including the required
--output argument and --ref HEAD, while preserving the subsequent
public:snapshot:check and git diff --check commands.

In
`@docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.6-code-quality-review.md`:
- Line 16: Add the missing level-2 section heading in the review document
hierarchy: insert “## Findings” before the existing “### CQ-1” heading,
preserving CQ-1 as a level-3 subsection so the document satisfies MD001.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 178bd4ec-4bf2-4310-bc0f-0bdf4c780558

📥 Commits

Reviewing files that changed from the base of the PR and between eb8fdbf and a395c75.

📒 Files selected for processing (72)

• docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-check.md
• docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-checklist.md
• docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-checkpoint.md
• docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-final-gate-checklist.md
• docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-remediation-checklist.md
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-check.md
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-design.md
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-goal.md
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-1.md
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-2.md
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-3.md
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-4.md
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan.md
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-check.md
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-checkpoint.md
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-design.md
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-goal.md
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-plan-1.md
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-plan-2.md
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-plan-3.md
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-plan.md
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-27-hyperframes-text-occlusion-reproduction.md
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-27-visual-integrity-fix.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-check.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-design.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-goal.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-plan-1.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-plan-2.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-plan.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/reviews/part-1-tasks-1-through-5-code-quality-review.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/reviews/part-1-tasks-1-through-5-spec-review.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/reviews/part-1-tasks-1-through-5-test-review.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/reviews/part-2-tasks-6-through-8-code-quality-review.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/reviews/part-2-tasks-6-through-8-spec-review.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/reviews/part-2-tasks-6-through-8-test-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/2026-07-28-auto-dependency-updates-design.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/2026-07-28-auto-dependency-updates-goal.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/2026-07-28-auto-dependency-updates-plan-1.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/2026-07-28-auto-dependency-updates-plan-2.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/2026-07-28-auto-dependency-updates-plan.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/2026-07-28-auto-dependency-updates-research.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-1-tasks-1-through-3-code-quality-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-1-tasks-1-through-3-spec-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-1-tasks-1-through-3-test-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.1-code-quality-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.1-spec-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.1-test-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.2-code-quality-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.2-spec-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.2-test-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.3-code-quality-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.3-spec-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.3-test-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.4-code-quality-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.4-spec-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.4-test-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.5-code-quality-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.5-spec-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.5-test-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.6-code-quality-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.6-spec-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.6-test-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.7-code-quality-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.7-spec-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.7-test-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.8-code-quality-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.8-spec-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.8-test-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-tasks-4-through-5-code-quality-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-tasks-4-through-5-spec-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-tasks-4-through-5-test-review.md
• docs/superpowers/done/2026-08-01-resolve-open-prs/2026-08-01-resolve-open-prs-plan.md

[coderabbitai]

Caution

Inline review comments failed to post. This is likely due to GitHub's internal server error or limits when posting large numbers of comments. If you are seeing this consistently it is likely a permissions issue. Please check "Moderation" -> "Code review limits" under your organization settings.

Actionable comments posted: 14

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In
`@docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-checklist.md`:
- Around line 72-96: Update the outer Markdown fence surrounding the nested
example in the checklist fixture to use four backticks, while keeping the inner
text fence at three backticks so the entire sample renders as one copyable
Markdown document.

In
`@docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-checkpoint.md`:
- Line 28: Update the evidence Location entry in the checkpoint to use the
canonical docs/superpowers/done path, and replace or remove every remaining
stale docs/superpowers/active or docs/superpowers/archive reference in the same
checkpoint.

In
`@docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-remediation-checklist.md`:
- Around line 433-444: Align the PASS release procedure with the
explicit-authorization rule: in
docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-remediation-checklist.md
lines 433-444, require an explicit user request before commit, push, merge,
version bump, or publish; update lines 16-21 to remove or condition automatic
merge/release wording. Preserve the existing separation of PASS from commit/push
and merge/bump/publish permission in
docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-checkpoint.md
lines 19 and 110-118. Ensure
docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-final-gate-checklist.md
lines 625-636 remains the canonical explicit-authorization release procedure.
- Around line 87-95: Choose one deterministic policy for words starting after
duration_s in “Decide normalization behavior”: either clamp/move them into the
final valid interval or fail with a path-aware error, but remove the
alternative. Update the focused timing-normalization tests and final gate
checklist to enforce the selected behavior while preserving the other stated
validation rules.

In
`@docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-check.md`:
- Around line 5-8: Rewrite all migrated Superpowers references from canonical
active/ paths to done/ paths: update source-document links in
docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-check.md
(lines 5-8), design and plan index paths in
docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-goal.md
(lines 11-15), and both completion-record creation/final paths in
docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-4.md
(lines 210 and 377).

In
`@docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-1.md`:
- Around line 133-143: Update parseCommand so it validates argv with strict
parseArgs before returning the help result, allowing unknown options to be
rejected even when --help or -h is present. Preserve help precedence for
incomplete required option values, and add a regression test covering an unknown
option combined with --help.

In
`@docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-2.md`:
- Around line 172-184: Update Step 4’s backup-path handling to reserve each
deterministic sibling backup path before any promotion, rejecting occupied paths
or allocating a free invocation-owned alternative without overwriting unrelated
files. Preserve the required operation sequence and add a test covering an
existing backup-path collision.

In
`@docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-checkpoint.md`:
- Around line 3-4: Rewrite all relocated Superpowers references from active/ to
canonical done/ paths. In
docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-checkpoint.md:3-4
update goal and evidence paths; design.md:16-20 update source-artifact and
evidence paths; goal.md:9-16 update governing-document paths; plan-1.md:679-683
update Task 5 paths and verification commands; plan-2.md:12-14 update evidence,
design, and completion-artifact paths; plan-3.md:12-15 update reviewed-source,
evidence, checkpoint, and completion-check paths; plan.md:15-20 update
source-artifact, checkpoint, and evidence paths; and
2026-07-27-visual-integrity-fix.md:83-103 update reviewed-input,
historical-evidence, and checkpoint paths.

In
`@docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-plan-3.md`:
- Around line 778-794: Update Step 14’s post-artifact delta check to combine the
tracked changes from git diff --name-only "$VALIDATION_COMMIT" with untracked
files from git ls-files --others --exclude-standard before evaluating
unexpected. Continue allowing only docs/superpowers/ paths, while preserving the
existing evidence output and git diff --check validation.
- Around line 334-346: Update the contamination-scan commands in the build-check
plan to fail closed: capture each rg exit status, treat 0 (forbidden match) and
statuses above 1 (scan error) as gate failures, and allow only status 1 (no
match) to pass. Remove the unconditional || true behavior while preserving the
generated evidence files.

In
`@docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-27-visual-integrity-fix.md`:
- Around line 178-188: Resolve the unchecked completion steps for Task 2 Step 5
and Task 7 Step 6 by verifying that their referenced visual-check evidence
exists; mark each complete only when supported by that evidence, otherwise leave
its state failed or incomplete. Keep the completion records and acceptance
criteria consistent with the resulting status.

In
`@docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-check.md`:
- Around line 21-24: Align the canonical upgrade artifacts with the delivered
implementation: in
docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-check.md:21-24,
qualify the design/plan parity statement with the recorded deviations; in
docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-design.md:86-100,
document linked-entry rejection before npm mutation; in the same design
file:114-138, document re-resolving the lexical global package entry after npm
succeeds; and in
docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-plan-1.md:17-53,
add the delivered isSymbolicLink and packageEntry fields or explicitly record
them as post-plan changes.

In
`@docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-plan-2.md`:
- Around line 322-330: Update Step 6’s snapshot verification commands to invoke
the supported temporary-output form of public:snapshot, including the required
--output argument and --ref HEAD, while preserving the subsequent
public:snapshot:check and git diff --check commands.

In
`@docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.6-code-quality-review.md`:
- Line 16: Add the missing level-2 section heading in the review document
hierarchy: insert “## Findings” before the existing “### CQ-1” heading,
preserving CQ-1 as a level-3 subsection so the document satisfies MD001.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 178bd4ec-4bf2-4310-bc0f-0bdf4c780558

📥 Commits

Reviewing files that changed from the base of the PR and between eb8fdbf and a395c75.

📒 Files selected for processing (72)

• docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-check.md
• docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-checklist.md
• docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-checkpoint.md
• docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-final-gate-checklist.md
• docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-remediation-checklist.md
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-check.md
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-design.md
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-goal.md
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-1.md
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-2.md
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-3.md
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-4.md
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan.md
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-check.md
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-checkpoint.md
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-design.md
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-goal.md
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-plan-1.md
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-plan-2.md
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-plan-3.md
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-plan.md
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-27-hyperframes-text-occlusion-reproduction.md
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-27-visual-integrity-fix.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-check.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-design.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-goal.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-plan-1.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-plan-2.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-plan.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/reviews/part-1-tasks-1-through-5-code-quality-review.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/reviews/part-1-tasks-1-through-5-spec-review.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/reviews/part-1-tasks-1-through-5-test-review.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/reviews/part-2-tasks-6-through-8-code-quality-review.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/reviews/part-2-tasks-6-through-8-spec-review.md
• docs/superpowers/done/2026-07-27-md2vid-upgrade/reviews/part-2-tasks-6-through-8-test-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/2026-07-28-auto-dependency-updates-design.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/2026-07-28-auto-dependency-updates-goal.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/2026-07-28-auto-dependency-updates-plan-1.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/2026-07-28-auto-dependency-updates-plan-2.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/2026-07-28-auto-dependency-updates-plan.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/2026-07-28-auto-dependency-updates-research.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-1-tasks-1-through-3-code-quality-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-1-tasks-1-through-3-spec-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-1-tasks-1-through-3-test-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.1-code-quality-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.1-spec-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.1-test-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.2-code-quality-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.2-spec-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.2-test-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.3-code-quality-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.3-spec-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.3-test-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.4-code-quality-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.4-spec-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.4-test-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.5-code-quality-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.5-spec-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.5-test-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.6-code-quality-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.6-spec-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.6-test-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.7-code-quality-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.7-spec-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.7-test-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.8-code-quality-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.8-spec-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.8-test-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-tasks-4-through-5-code-quality-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-tasks-4-through-5-spec-review.md
• docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-tasks-4-through-5-test-review.md
• docs/superpowers/done/2026-08-01-resolve-open-prs/2026-08-01-resolve-open-prs-plan.md

🛑 Comments failed to post (14)

docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-checklist.md (1)

72-96: 🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Use a longer outer fence for the nested Markdown example.

The outer fence at Line [72] closes at the inner fence at Line [93]. The suggested fixture does not render as one copyable Markdown document. Use four backticks for the outer fence.

Proposed fix

-```markdown
+````markdown
...
-```
+````

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

🧰 Tools

🪛 markdownlint-cli2 (0.23.1)

[warning] 96-96: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In
`@docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-checklist.md`
around lines 72 - 96, Update the outer Markdown fence surrounding the nested
example in the checklist fixture to use four backticks, while keeping the inner
text fence at three backticks so the entire sample renders as one copyable
Markdown document.

Source: Linters/SAST tools

docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-checkpoint.md (1)

28-28: 🗄️ Data Integrity & Integration | 🟡 Minor | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

if rg -n 'docs/superpowers/(active|archive)' docs --glob '*.md'; then
  echo "stale Superpowers path found" >&2
  exit 1
fi

Repository: therealhieu/md2vid

Length of output: 19728

---

🏁 Script executed:

#!/bin/bash
set -euo pipefail

printf 'Target line:\n'
sed -n '24,32p' docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-checkpoint.md | cat -n

printf '\nEvidence paths in docs/superpowers/done for this feature:\n'
git ls-files 'docs/superpowers/done/2026-07-24-md-to-video-e2e/*' 'docs/superpowers/done/2026-07-24-md-to-video-e2e/**' | sort

printf '\nStale docs/superpowers/(active|archive) references in markdown files:\n'
rg -n 'docs/superpowers/(active|archive)' docs --glob '*.md'

Repository: therealhieu/md2vid

Length of output: 20842

---

Use the canonical done/ evidence path.

Line 28 still points to docs/superpowers/active/..., while the feature folder is under docs/superpowers/done/.... Update this location and remove any other stale docs/superpowers/active or docs/superpowers/archive references in this checkpoint.

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In
`@docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-checkpoint.md`
at line 28, Update the evidence Location entry in the checkpoint to use the
canonical docs/superpowers/done path, and replace or remove every remaining
stale docs/superpowers/active or docs/superpowers/archive reference in the same
checkpoint.

docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-remediation-checklist.md (2)

87-95: 🗄️ Data Integrity & Integration | 🟡 Minor | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

file="docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-remediation-checklist.md"

echo "file exists: $(test -f "$file" && echo yes || echo no)"
wc -l "$file"
sed -n '80,100p' "$file"
sed -n '1,30p' "$file"
sed -n '16,24p' "$file"

Repository: therealhieu/md2vid

Length of output: 2012

---

🏁 Script executed:

#!/bin/bash
set -euo pipefail

file="docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-remediation-checklist.md"

python3 - <<'PY'
from pathlib import Path
import re

path = Path("docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-remediation-checklist.md")
text = path.read_text()
lines = text.splitlines()

print("line_count", len(lines))
print("decision_section", lines[86:95])

checks = []
for i, line in enumerate(lines, start=1):
    if line.strip().startswith("- [ ]"):
        checks.append((i, line.strip()))
print("checks_found", len(checks))
for i, line in checks:
    print(f"{i}: {line}")

# Deterministic shape probe: if the section requires exactly one policy, there must be
# no single checklist item expressing two mutually exclusive outcomes for the same input.
policy_line_num = 91
policy_line = lines[policy_line_num - 1]
has_or = bool(re.search(r"\bor\b", policy_line, re.I))
excludes_failure = bool(re.search(r"\b(or causes .*failure\b)", policy_line))
print("policy_line_or", has_or)
print("policy_line_failure_alternative", excludes_failure)
print("policy_choices", [m.group(0) for m in re.finditer(r"(?:\bmove|cause|fail|clamped|failure)\b", policy_line, flags=re.I)])
PY

Repository: therealhieu/md2vid

Length of output: 9779

---

Record one deterministic timing policy.

The checklist requires one consistent policy, but line 92 allows both moving an out-of-range word and failing. One behavior changes caption timing and the release result. Select one behavior, then make the focused tests and final gate require that behavior.

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In
`@docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-remediation-checklist.md`
around lines 87 - 95, Choose one deterministic policy for words starting after
duration_s in “Decide normalization behavior”: either clamp/move them into the
final valid interval or fail with a path-aware error, but remove the
alternative. Update the focused timing-normalization tests and final gate
checklist to enforce the selected behavior while preserving the other stated
validation rules.

---

433-444: 🗄️ Data Integrity & Integration | 🟠 Major | ⚡ Quick win

Align the PASS release procedure with the explicit-authorization rule.

The documents define two different post-PASS contracts. One flow authorizes commit, push, merge, version bump, and publish immediately. The checkpoint and final gate require an explicit user request.

• docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-remediation-checklist.md#L433-L444: Add the explicit-authorization condition before commit, push, merge, bump, or publish.
• docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-remediation-checklist.md#L16-L21: Remove the automatic “merge and release” wording or add the same condition.
• docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-checkpoint.md#L19-L19: Keep the rule that PASS does not authorize commit or push.
• docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-checkpoint.md#L110-L118: Keep PASS separate from permission to merge, bump, or publish.
• docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-final-gate-checklist.md#L625-L636: Use this explicit-authorization behavior as the canonical release procedure.

📍 Affects 3 files

• docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-remediation-checklist.md#L433-L444 (this comment)
• docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-remediation-checklist.md#L16-L21
• docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-checkpoint.md#L19-L19
• docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-checkpoint.md#L110-L118
• docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-final-gate-checklist.md#L625-L636

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In
`@docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-remediation-checklist.md`
around lines 433 - 444, Align the PASS release procedure with the
explicit-authorization rule: in
docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-remediation-checklist.md
lines 433-444, require an explicit user request before commit, push, merge,
version bump, or publish; update lines 16-21 to remove or condition automatic
merge/release wording. Preserve the existing separation of PASS from commit/push
and merge/bump/publish permission in
docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-checkpoint.md
lines 19 and 110-118. Ensure
docs/superpowers/done/2026-07-24-md-to-video-e2e/2026-07-24-md-to-video-e2e-final-gate-checklist.md
lines 625-636 remains the canonical explicit-authorization release procedure.

docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-check.md (1)

5-8: 🗄️ Data Integrity & Integration | 🟡 Minor | ⚡ Quick win

Rewrite all migrated Superpowers references to the canonical done/ paths.

The PR removes active/, but these records still reference it.

• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-check.md#L5-L8: update all source-document links from active/ to done/.
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-goal.md#L11-L15: update the design and plan index paths.
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-4.md#L210-L210: update the completion-record creation path.
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-4.md#L377-L377: update the final completion-record path.

📍 Affects 3 files

• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-check.md#L5-L8 (this comment)
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-goal.md#L11-L15
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-4.md#L210-L210
• docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-4.md#L377-L377

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In
`@docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-check.md`
around lines 5 - 8, Rewrite all migrated Superpowers references from canonical
active/ paths to done/ paths: update source-document links in
docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-check.md
(lines 5-8), design and plan index paths in
docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-goal.md
(lines 11-15), and both completion-record creation/final paths in
docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-4.md
(lines 210 and 377).

docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-1.md (1)

133-143: 🎯 Functional Correctness | 🟠 Major | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "== locate file =="
fd -a '2026-07-24-stabilize-cli-workflows-plan-1\.md' . || true

echo "== relevant file sections =="
file="$(fd '2026-07-24-stabilize-cli-workflows-plan-1\.md' . | head -n 1)"
if [ -n "${file:-}" ]; then
  wc -l "$file"
  sed -n '1,240p' "$file" | cat -n
fi

echo "== related terms =="
if [ -n "${file:-}" ]; then
  rg -n "unknown|--help|-h|parseCommand|parseArgs|SPEC|require" "$file" || true
fi

Repository: therealhieu/md2vid

Length of output: 11882

---

🌐 Web query:

Node.js util.parseArgs strict unknown short option help token unknown option ERR_PARSE_ARGS_UNKNOWN_SHORT_OPTION

💡 Result:

The error ERR_PARSE_ARGS_UNKNOWN_SHORT_OPTION occurs in Node.js when using the util.parseArgs function in strict mode (which is enabled by default) and encountering a short-form command-line option that has not been defined in the options configuration object [1][2][3]. In Node.js, util.parseArgs operates in strict mode by default [1][4]. When strict mode is enabled, the parser enforces that all provided arguments—including short options (e.g., -a)—must be explicitly defined in the options configuration provided to the function [1][2]. If an undefined short option is encountered, the parser throws an error to prevent unexpected behavior [5][2]. To resolve this error, you must ensure that every short option used in your command-line arguments is declared in the options object [1][3]. For example: const { parseArgs } = require('node:util'); const options = { verbose: { type: 'boolean', short: 'v' // Defining the short option here prevents the error } }; // This will now parse correctly const args = parseArgs({ options, args: ['-v'] }); If you wish to allow undefined options, you can disable strict mode by setting strict: false in your configuration object [1][6]. However, doing so may make your application less predictable as it will ignore or handle undefined flags differently depending on the parser's implementation [1][2][6]. For debugging purposes, if you need to inspect exactly how arguments are being tokenized, you can set tokens: true in the configuration [1][7][4]. This returns a list of tokens, allowing you to see how the parser interpreted each argument [1][7].

Citations:

• 1: https://nodejs.org/api/util.html
• 2: https://2ality.com/2022/08/node-util-parseargs.html
• 3: https://older-posts.simonplend.com/command-line-argument-parsing-with-node-js-core/
• 4: https://github.com/nodejs/node/blob/main/doc/api/util.md
• 5: nodejs/node#42675
• 6: https://registry.npmjs.org/%40pkgjs%2Fparseargs
• 7: http://nodejs.org/docs/latest/api/util.html

---

🌐 Web query:

https://nodejs.org/api/util.html parseArgs strict tokens help short option unknown option token

💡 Result:

In Node.js, util.parseArgs is a built-in utility for parsing command-line arguments [1][2]. Its behavior regarding strict mode, tokens, and option handling is configured via the config object [1][3]. Strict Mode (strict) The strict option is a boolean that determines how the parser handles unknown arguments or type mismatches [1][3]. It defaults to true [1][3]. - When strict is true, parseArgs throws an error if an unknown option is encountered, if an option is used with the wrong type (e.g., a string option missing an argument), or if unexpected positional arguments are provided [4][3]. - Setting strict to false disables this validation, allowing unknown options and positional arguments without throwing exceptions [5][3]. Tokens (tokens) The tokens option is a boolean that, when set to true, causes parseArgs to return detailed parsing metadata alongside the parsed values and positionals [1][2]. - Returned tokens provide information such as the kind of token ('option', 'positional', or 'option-terminator'), the raw string used (e.g., -f or --foo), its index in the input array, and its associated value (if any) [1][2]. - This functionality is intended for extending built-in behavior, such as implementing custom validation, handling negatable options (like --no-foo), or enforcing specific argument order [1][6]. Short Options Short options are defined within the options configuration object [1][3]. Each option definition can include a short property, which must be a single character used as an alias for the long option name [1][4]. For example, if an option is defined as { foo: { short: 'f' } }, then -f is accepted as an alias for --foo [1]. Unknown Options - In strict mode (default), the parser throws an error if it encounters an option that is not defined in the options configuration object [4][3]. - When strict is false, unknown options are generally accepted and included in the parsed results [5]. Use the tokens: true configuration to inspect or identify unknown options if needed for custom logic [1][6].

Citations:

• 1: https://nodejs.org/api/util.html
• 2: http://nodejs.org/docs/latest/api/util.html
• 3: https://github.com/nodejs/node/blob/main/doc/api/util.md
• 4: https://2ality.com/2022/08/node-util-parseargs.html
• 5: nodejs/node#42675
• 6: nodejs/node#43459

---

Validate argument tokens before returning help.

parseCommand() returns { kind: "help" } before parseArgs() rejects unknown options. Preserve help precedence only for incomplete required values, then let strict parseArgs() handle unknown option tokens. Add a regression for an unknown option combined with --help.

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In
`@docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-1.md`
around lines 133 - 143, Update parseCommand so it validates argv with strict
parseArgs before returning the help result, allowing unknown options to be
rejected even when --help or -h is present. Preserve help precedence for
incomplete required option values, and add a regression test covering an unknown
option combined with --help.

docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-2.md (1)

172-184: 🗄️ Data Integrity & Integration | 🟠 Major | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
set -euo pipefail

printf 'Repository files around target:\n'
git ls-files | rg '2026-07-24-stabilize-cli-workflows-plan-2|stabilize-cli-workflows' || true

printf '\nTarget excerpt:\n'
sed -n '90,190p' 'docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-2.md'

printf '\nSearch for backup collision/pre-check language:\n'
rg -n "backup path|collision|occupied|rename\(operation\.target|rename\(.*backup|preserve|unrelated|backup names|sibling backup" docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-2.md || true

Repository: therealhieu/md2vid

Length of output: 4839

---

🏁 Script executed:

#!/bin/bash
set -euo pipefail

printf 'File stats:\n'
wc -l 'docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-2.md'

printf '\nStep 4 implementation section:\n'
sed -n '170,240p' 'docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-2.md'

printf '\nRelated design/check excerpts mentioning backups/collision/unrelated:\n'
rg -n "backup|collision|occupied|reserved|reserved paths|preserve|unrelated|sentinel|existing|rename" docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-design.md docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-check.md || true

Repository: therealhieu/md2vid

Length of output: 5545

---

🏁 Script executed:

#!/bin/bash
set -euo pipefail

printf 'Node/POSIX rename overwrite behavior probe:\n'
node - <<'JS'
const fs = require('node:fs');
const path = require('node:path');
const os = require('node:os');

const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'rename-probe-'));
fs.writeFileSync(path.join(dir, 'occupied'), 'occupied');
fs.writeFileSync(path.join(dir, 'existing'), 'existing');
fs.writeFileSync(path.join(dir, 'backup'), 'old backup');

try {
  fs.renameSync(path.join(dir, 'existing'), path.join(dir, 'backup'));
  console.log('success');
  console.log('backup contents:', fs.readFileSync(path.join(dir, 'backup'), 'utf8'));
} catch (error) {
  console.log('error:', error.code || error.name + ': ' + error.message);
} finally {
  if (fs.existsSync(dir)) fs.rmSync(dir, { recursive: true, force: true });
}
JS

Repository: therealhieu/md2vid

Length of output: 234

---

Reserve backup paths before promotion.

Step 4 uses deterministic sibling backup names, but it does not check whether those paths already exist. If operation.backup is occupied, rename(operation.target, operation.backup) overwrites the unrelated path and breaks unrelated-file preservation. Reject occupied backup paths or allocate a free invocation-owned path, and add a collision test.

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In
`@docs/superpowers/done/2026-07-24-stabilize-cli-workflows/2026-07-24-stabilize-cli-workflows-plan-2.md`
around lines 172 - 184, Update Step 4’s backup-path handling to reserve each
deterministic sibling backup path before any promotion, rejecting occupied paths
or allocating a free invocation-owned alternative without overwriting unrelated
files. Preserve the required operation sequence and add a test covering an
existing backup-path collision.

docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-checkpoint.md (1)

3-4: 🗄️ Data Integrity & Integration | 🟠 Major | ⚡ Quick win

Rewrite the relocated Superpowers paths consistently.

The PR makes docs/superpowers/done/ canonical, but these documents still point to docs/superpowers/active/ for source artifacts, evidence, checkpoints, plans, and verification commands. Following those instructions will read or write outside the canonical completed projects.

• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-checkpoint.md#L3-L4: update the goal and all evidence paths from active/ to done/.
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-design.md#L16-L20: update source-artifact and evidence paths from active/ to done/.
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-goal.md#L9-L16: update all governing-document paths from active/ to done/.
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-plan-1.md#L679-L683: update Task 5 file paths and related verification commands.
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-plan-2.md#L12-L14: update evidence, design, and completion-artifact paths.
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-plan-3.md#L12-L15: update reviewed-source, evidence, checkpoint, and completion-check paths.
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-plan.md#L15-L20: update source-artifact, checkpoint, and evidence paths.
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-27-visual-integrity-fix.md#L83-L103: update reviewed-input, historical-evidence, and checkpoint paths.

📍 Affects 8 files

• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-checkpoint.md#L3-L4 (this comment)
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-design.md#L16-L20
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-goal.md#L9-L16
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-plan-1.md#L679-L683
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-plan-2.md#L12-L14
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-plan-3.md#L12-L15
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-plan.md#L15-L20
• docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-27-visual-integrity-fix.md#L83-L103

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In
`@docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-checkpoint.md`
around lines 3 - 4, Rewrite all relocated Superpowers references from active/ to
canonical done/ paths. In
docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-checkpoint.md:3-4
update goal and evidence paths; design.md:16-20 update source-artifact and
evidence paths; goal.md:9-16 update governing-document paths; plan-1.md:679-683
update Task 5 paths and verification commands; plan-2.md:12-14 update evidence,
design, and completion-artifact paths; plan-3.md:12-15 update reviewed-source,
evidence, checkpoint, and completion-check paths; plan.md:15-20 update
source-artifact, checkpoint, and evidence paths; and
2026-07-27-visual-integrity-fix.md:83-103 update reviewed-input,
historical-evidence, and checkpoint paths.

docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-plan-3.md (2)

334-346: 🎯 Functional Correctness | 🟠 Major | ⚡ Quick win

Make the contamination scans fail closed.

Both rg commands end with || true. A forbidden remote GSAP reference, parent traversal, or repository-source path therefore produces evidence but does not stop the gate. The plan can report PASS after detecting the exact conditions it must reject. Treat exit 0 as failure, exit 1 as “no match,” and fail on other errors.

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In
`@docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-plan-3.md`
around lines 334 - 346, Update the contamination-scan commands in the
build-check plan to fail closed: capture each rg exit status, treat 0 (forbidden
match) and statuses above 1 (scan error) as gate failures, and allow only status
1 (no match) to pass. Remove the unconditional || true behavior while preserving
the generated evidence files.

---

778-794: 🗄️ Data Integrity & Integration | 🟠 Major | ⚡ Quick win

Include untracked files in the post-artifact delta check.

git diff --name-only "$VALIDATION_COMMIT" ignores untracked files. git status --short is only recorded and is not validated. An unexpected untracked source file can therefore bypass the unexpected check. Combine the tracked diff with git ls-files --others --exclude-standard, then allow only the intended docs/superpowers/ paths.

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In
`@docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-26-md2vid-pr-completion-plan-3.md`
around lines 778 - 794, Update Step 14’s post-artifact delta check to combine
the tracked changes from git diff --name-only "$VALIDATION_COMMIT" with
untracked files from git ls-files --others --exclude-standard before evaluating
unexpected. Continue allowing only docs/superpowers/ paths, while preserving the
existing evidence output and git diff --check validation.

docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-27-visual-integrity-fix.md (1)

178-188: 🗄️ Data Integrity & Integration | 🟡 Minor | ⚡ Quick win

Resolve the unchecked completion steps.

Task 2 Step 5 and Task 7 Step 6 remain unchecked, but Task 9 and the acceptance criteria are marked complete, and the completion records report PASS. Mark these steps complete only when the referenced evidence exists. Otherwise, keep the completion state failed or incomplete.

Also applies to: 521-523

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In
`@docs/superpowers/done/2026-07-26-md2vid-pr-completion/2026-07-27-visual-integrity-fix.md`
around lines 178 - 188, Resolve the unchecked completion steps for Task 2 Step 5
and Task 7 Step 6 by verifying that their referenced visual-check evidence
exists; mark each complete only when supported by that evidence, otherwise leave
its state failed or incomplete. Keep the completion records and acceptance
criteria consistent with the resulting status.

docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-check.md (1)

21-24: 🗄️ Data Integrity & Integration | 🟡 Minor | ⚡ Quick win

Align the canonical upgrade artifacts with the delivered implementation.

The implementation adds linked-entry rejection, post-install package re-resolution, and injected isSymbolicLink/packageEntry state. The design and shared API blocks do not describe these changes, so the completion record cannot state unqualified design/plan parity.

• docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-check.md#L21-L24: qualify the parity statement with the recorded deviations.
• docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-design.md#L86-L100: document symlink rejection before npm mutation.
• docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-design.md#L114-L138: state that the lexical global package entry is re-resolved after npm succeeds.
• docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-plan-1.md#L17-L53: add the delivered isSymbolicLink and packageEntry fields, or record them as explicit post-plan changes.

📍 Affects 3 files

• docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-check.md#L21-L24 (this comment)
• docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-design.md#L86-L100
• docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-design.md#L114-L138
• docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-plan-1.md#L17-L53

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In
`@docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-check.md`
around lines 21 - 24, Align the canonical upgrade artifacts with the delivered
implementation: in
docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-check.md:21-24,
qualify the design/plan parity statement with the recorded deviations; in
docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-design.md:86-100,
document linked-entry rejection before npm mutation; in the same design
file:114-138, document re-resolving the lexical global package entry after npm
succeeds; and in
docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-plan-1.md:17-53,
add the delivered isSymbolicLink and packageEntry fields or explicitly record
them as post-plan changes.

docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-plan-2.md (1)

322-330: 🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Make the snapshot verification command executable.

The plan runs corepack npm run public:snapshot without --output, but the completed check records that the command fails closed because --output is mandatory. Use the supported temporary-output invocation and --ref HEAD, or document the deviation beside this command.

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In
`@docs/superpowers/done/2026-07-27-md2vid-upgrade/2026-07-27-md2vid-upgrade-plan-2.md`
around lines 322 - 330, Update Step 6’s snapshot verification commands to invoke
the supported temporary-output form of public:snapshot, including the required
--output argument and --ref HEAD, while preserving the subsequent
public:snapshot:check and git diff --check commands.

docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.6-code-quality-review.md (1)

16-16: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Add the missing level-2 section heading.

### CQ-1 follows # Canonical Review Artifact without an intervening ## heading. Add ## Findings before this heading, or change it to ## CQ-1, so the document passes MD001.

🧰 Tools

🪛 markdownlint-cli2 (0.23.1)

[warning] 16-16: Heading levels should only increment by one level at a time
Expected: h2; Actual: h3

(MD001, heading-increment)

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In
`@docs/superpowers/done/2026-07-28-auto-dependency-updates/reviews/part-2-task-5.6-code-quality-review.md`
at line 16, Add the missing level-2 section heading in the review document
hierarchy: insert “## Findings” before the existing “### CQ-1” heading,
preserving CQ-1 as a level-3 subsection so the document satisfies MD001.

Source: Linters/SAST tools