fix(cli): doctor warns that claude no longer declares aidd-framework right after a clean setup

Open Beginner friendly
  • Is something wrong?
#1,118 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
74/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
typescript
Domain
cli, developer-experience

Research direction

Open cli/src/contexts/framework/application/doctor/doctor-registration-use-case.ts and read checkDeclaredMarketplaces to see that it only reads the project's .claude/settings.local.json. Compare it with the machine-scope handling introduced by framework-source-is-machine-scope and with how setup now registers the marketplace in Claude Code's user settings, so the check can skip or look at the right scope. Done means aidd doctor prints no warning after a clean aidd setup --source remote --ai claude, and the existing doctor tests are updated to cover the machine-scope case.

Written by the indexing model from the issue text.

Description

Description

After a clean aidd setup for Claude Code, aidd doctor reports a warning that no command can clear:

Warning:   claude no longer declares marketplace 'aidd-framework'
    Fix: Run `aidd marketplace refresh` to write it back to .claude/settings.local.json.

Since the framework source became machine-scope, the marketplace is registered once, in Claude Code's user settings. doctor still looks for it in the project's .claude/settings.local.json (checkDeclaredMarketplaces in doctor-registration-use-case.ts), where setup no longer writes it. The check fails on the happy path, and the fix it names does nothing.

Affected file(s)

cli/src/contexts/framework/application/doctor/doctor-registration-use-case.ts

Expected behaviour

aidd doctor reports no warning right after a successful aidd setup. If a project-level declaration is not expected for the machine-scope framework marketplace, the check skips it.

Observed behaviour

In an empty git project, with HOME, XDG_CONFIG_HOME and AIDD_USER_CONFIG_DIR pointing at empty temporary directories:

  1. aidd setup --source remote --ai claude --plugins recommended --yes exits 0 and writes enabledPlugins for six plugins to .claude/settings.local.json.
  2. aidd doctor prints the warning above.
  3. aidd marketplace refresh prints aidd-framework: ok. aidd doctor prints the same warning.
  4. aidd sync prints Nothing to restore. aidd doctor prints the same warning.

.claude/settings.local.json still holds only enabledPlugins. The marketplace is present in Claude Code's own registry (known_marketplaces.json).

AI tool

Claude Code

aidd-cli version

5.6.0, from the published package and from a build of the current source.

OS

macOS

Additional context
  • The check was written before the framework source moved to machine scope (framework-source-is-machine-scope).
  • Found while recording the install demo for the README.
Code of Conduct
  • I agree to follow this project's Code of Conduct.
Dominant language
TypeScript
Stars
481
Forks
45
Avg merge
23h 18m
Merged PRs (30d)
106

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from ai-driven-dev/framework

All issues in ai-driven-dev/framework

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.