mirror of
https://github.com/rudrankriyam/App-Store-Connect-CLI.git
synced 2026-04-25 15:45:48 +03:00
[GH-ISSUE #483] Auth Doctor: detect Appfile/Fastfile and suggest equivalent asc workflows #134
Labels
No labels
bug
bug
documentation
enhancement
pull-request
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
starred/App-Store-Connect-CLI#134
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Originally created by @rudrankriyam on GitHub (Feb 10, 2026).
Original GitHub issue: https://github.com/rudrankriyam/App-Store-Connect-CLI/issues/483
Summary
Extend
asc auth doctorwith migration-oriented detection and actionable command mapping for teams moving existing lane-based automation intoasc.Why this matters
auth doctorcurrently validates ASC credentials and local security posture well, but it stops at ASC-specific state.Teams often already have repository signals (
Appfile,Fastfile,Deliverfile, Bundler setup) that can be translated into immediateascnext steps.Without this, users hit a dead end between "auth is healthy" and "what command should I run first?"
Current state (verified)
asc auth doctorchecks storage, profiles, private keys, environment, and temp files.internal/auth/doctor.goand is surfaced byinternal/cli/auth/auth.go.Appfile/Fastfile/Deliverfileor suggest equivalentasccommands.Proposed UX
New report section:
Migration HintsAdd a doctor section that:
Appfilepresence and common keys (app_identifier,apple_id,team_id,itc_team_id,apple_dev_portal_id,itunes_connect_id)Fastfilepresence and common actions (app_store_connect_api_key,deliver,upload_to_testflight,pilot,upload_to_app_store,precheck,app_store_build_number,latest_testflight_build_number)Gemfile,Gemfile.lock)ascequivalents, for example:asc auth login ...asc migrate validate,asc migrate importasc publish testflight ...asc publish appstore .../asc submit create ...asc builds latest ...(and--nextwhen available)--output json(detectedFiles,detectedActions,suggestedCommands)Behavior constraints
INFO, notWARN/FAIL.Detailed implementation plan
inspectMigrationHints()ininternal/auth/doctor.go.internal/auth/doctor_migration.go:Appfilekey extractionFastfileaction extractionDoctorReportpayload with optional migration metadata for JSON output.action -> []asc command suggestions) with stable ordering.internal/cli/auth/auth.goso recommendations appear under "Migration Hints".internal/auth/doctor_test.go:README.mdforasc auth doctor.Acceptance criteria
asc auth doctorincludes a migration section when repository signals are present.errorsstill drive non-zero status).make testpasses with added coverage for migration hints.@rudrankriyam commented on GitHub (Feb 11, 2026):
@cursor Please implement this issue end-to-end.
What to build
Extend
asc auth doctorwith repository migration hints based onAppfile/Fastfile/Deliverfiledetection, and output equivalentasccommand suggestions.Implementation plan
internal/auth/doctor.goMigration Hints) intoDoctor().internal/auth/doctor_migration.go(or equivalent):Appfile,Fastfile,Deliverfile,Gemfile.asccommands, including:internal/cli/auth/auth.goprintDoctorReportrenders migration hints clearly in text mode.New tests to write
A) Auth doctor unit tests (
internal/auth/doctor_test.go)AppfileandFastfileand emits migration hintsB) CLI output tests (
internal/cli/cmdtest)asc auth doctor --output jsonincludes migration section keysC) Regression checks
--fixbehavior unaffectedHow to test locally
Run exactly:
make formatmake lintmake testTargeted tests:
go test ./internal/auth -run 'Doctor.*Migration|Doctor.*Hints'go test ./internal/cli/cmdtest -run 'auth doctor'Done criteria
asc auth doctorreports migration hints when relevant files are present.format,lint,test).@cursor[bot] commented on GitHub (Feb 11, 2026):
I added a “Migration Hints” section to
asc auth doctorthat scans Appfile/Fastfile/Deliverfile/Gemfile, extracts safe keys/actions, and maps them to deterministic asc command suggestions, with a JSON payload wired into the report output. I also added unit + cmdtest coverage for detection/suggestions and updated the README auth doctor example to mention migration hints.Tests run:
go test ./internal/auth -run 'Doctor.*Migration|Doctor.*Hints'go test ./internal/cli/cmdtest -run 'auth doctor'(Go reported:[no tests to run])make format(aftermake tools, rerun withPATH=/home/ubuntu/go/bin:$PATH)make lint(after reinstalling golangci-lint withGOTOOLCHAIN=go1.26.0, rerun withPATH=/home/ubuntu/go/bin:$PATH)make testWalkthrough video (shows
asc auth doctoroutput with Migration Hints and suggested commands):/opt/cursor/artifacts/auth_doctor_migration_hints_demo_clear/recording_demo.mp4@rudrankriyam commented on GitHub (Feb 11, 2026):
Implemented and merged in PR #488: https://github.com/rudrankriyam/App-Store-Connect-CLI/pull/488\n\nThis delivered auth doctor migration hints (Fastlane/Appfile/Fastfile detection, suggested asc workflows, JSON/text migration output, and supporting tests/docs), so this issue is now complete.