Skip to content

fix: cross-platform parity (ADX-005), bump v0.5.0#2

Merged
SmartBrandStrategies merged 6 commits intomainfrom
docs/adx-005-cli-ux-feedback
Mar 2, 2026
Merged

fix: cross-platform parity (ADX-005), bump v0.5.0#2
SmartBrandStrategies merged 6 commits intomainfrom
docs/adx-005-cli-ux-feedback

Conversation

@SmartBrandStrategies
Copy link
Copy Markdown
Contributor

Summary

  • Adds papers/AGENT_DX_FEEDBACK_005.md documenting 8 findings from an end-to-end charter CLI UX walkthrough
  • Covers bootstrap, migrate, doctor, audit, and output ergonomics
  • 2 medium-severity issues (hook install git-detection bug, migrate patch error on prose sections), 5 low-severity issues, 1 positive signal

Findings

ID Finding Severity
F1 Bootstrap value is high (positive)
F2 Hook install "not inside git repo" despite valid repo Medium
F3 adf migrate ADD_BULLET fails on prose sections Medium
F4 Doctor warns on .cursorrules thin pointer Low
F5 Install EPERM missing retry hint Low
F6 audit hard error on repos with no HEAD Low
F7 Migrate JSON too large for agent context Low
F8 Emoji/mojibake in minimal terminals Low

Test plan

  • Review feedback document for accuracy and completeness
  • Verify finding IDs don't conflict with existing ADX series
  • Confirm frontmatter cross-references are correct

🤖 Generated with Claude Code

stackbilt-admin and others added 2 commits February 28, 2026 16:37
Documents 8 findings from end-to-end charter CLI UX testing:
hook install git-detection bug, migrate patch error on prose sections,
doctor false positive on thin pointers, install EPERM hint, audit
no-HEAD handling, migrate JSON compactness, and emoji encoding.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Unify git invocation into shared git-helpers module with shell: true
for WSL/CMD/PowerShell PATH resolution (F2). Deduplicate ~6 copies of
runGit, parseCommitMetadata, parseChangedFilesByCommit across commands.

Fix patcher ADD_BULLET on text sections by converting to list (F3).
Fix migrate to detect text sections and use REPLACE_SECTION instead.

Fix doctor false positive on .cursorrules thin pointers by adding the
missing pointer marker to detection (F4). Extract shared POINTER_MARKERS
constant to prevent future drift.

Add EPERM/EACCES retry hint in bootstrap install step (F5).

Add hasCommits() guard to audit command for no-HEAD repos (F6).

Bump all packages 0.4.2 -> 0.5.0.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@SmartBrandStrategies SmartBrandStrategies changed the title docs(feedback): ADX-005 charter CLI UX findings fix: cross-platform parity (ADX-005), bump v0.5.0 Feb 28, 2026
stackbilt-admin and others added 4 commits February 28, 2026 17:52
…d, fresh evidence

Refresh the dogfood evidence snapshot to current v0.5.0 measurements.
Add bootstrap command to Getting Started and Command Reference.
Add Cross-Platform Support section noting WSL/PowerShell/CMD/Linux parity.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@SmartBrandStrategies SmartBrandStrategies merged commit 3521ab6 into main Mar 2, 2026
4 checks passed
@SmartBrandStrategies SmartBrandStrategies deleted the docs/adx-005-cli-ux-feedback branch March 2, 2026 12:49
SmartBrandStrategies pushed a commit that referenced this pull request Mar 2, 2026
Move [Unreleased] to [0.5.0] with cross-platform fixes, git-helpers
consolidation, ADX-005 findings, papers restructure, and metrics
recalibration from PR #1 and PR #2.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.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.

2 participants