Skip to content

Bug: Review bootstrap must preserve user-scoped modules #452

Description

@djm81

Problem

Repository bootstrap guidance currently tells agents to uninstall a shadowed user-scoped module when a project-local bundle is present. During specfact code review work this repeatedly removes user-scoped specfact-codebase and specfact-code-review, even though project-over-user shadowing is normal and the user copy is still needed in other repositories.

Expected behavior

  • Project-local module sources remain authoritative inside this repository.
  • User-scoped modules remain installed and usable outside this repository.
  • Bootstrap and repository guidance never prescribe user-scope uninstall as routine shadow cleanup.
  • The paired core diagnostics explain shadowing without destructive recovery advice.

Scope

Correct the development bootstrap and repository guidance, and add regression coverage that prevents the destructive instruction from returning. Paired core bug: nold-ai/specfact-cli#699.

Governance

Acceptance criteria

  • Tests prove bootstrap/repository guidance does not recommend module uninstall --scope user.
  • Guidance states that project scope shadows, but does not delete, the user installation.
  • Existing local-bundle import isolation remains unchanged.
  • Focused and repository quality gates pass.

Activity

  1. self-assigned this
    on Aug 29, 2026
  2. added
    bugSomething isn't working
    moduleSpecfact Module related topic
    codebaseSpecfact codebase related topic
    on Aug 29, 2026
  3. added theissue type on Aug 29, 2026
  4. moved this from Todo to In Progress in SpecFact CLIon Aug 29, 2026
  5. djm81 commented on Aug 29, 2026

    @djm81
    ContributorAuthor

    Implementation PR: #454. Paired core PR: nold-ai/specfact-cli#700

  6. added 2 commits that reference this issue on Aug 29, 2026
    1ef2473
    542b461
  7. djm81 commented on Aug 30, 2026

    @djm81
    ContributorAuthor

    Completed by PR #454, merged to dev as 1ef2473 on 2026-08-29.

  8. moved this from In Progress to Done in SpecFact CLIon Aug 30, 2026
  9. moved this from Done to In Progress in SpecFact CLIon Aug 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

bugSomething isn't workingcodebaseSpecfact codebase related topicmoduleSpecfact Module related topicopenspecopenspec change

Type

Projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions