[mirror] Fix @fedify/nuxt runtime packaging and fedify init scaffolding edge cases

[yashwant86]

Mirror of upstream fedify-dev#717 for benchmark. Do not merge.

---

Summary by MergeMonkey

• Knowledge Base:
  • Added `--allow-non-empty` CLI option documentation for `fedify init` command.
• Enhancements:
  • Added `--allow-non-empty` flag to initialize projects in non-empty directories when framework scaffolder supports it.
  • Enhanced directory emptiness check to recognize unborn Git repositories as safe initialization targets.
  • Added runtime file path resolution for Nuxt module to use compiled JavaScript instead of TypeScript sources.
• Squashed Bugs:
  • Fixed @fedify/nuxt runtime packaging to include compiled dist files instead of source TypeScript.
  • Fixed Redis message queue graceful shutdown to handle already-closed connections without throwing.
  • Fixed PostgreSQL message queue listen cleanup to properly unlisten and clear timeouts on abort.
  • Fixed Nuxt module to resolve runtime server files to compiled output paths.
• Maintenance:
  • Updated Nuxt package.json to use catalog versions and add pretest build step.
  • Updated tsdown config to build runtime server files.
  • Removed @nuxt/schema from devDependencies (moved to peerDependencies).
  • Updated deno.lock to remove incorrect packageJson dependencies.

[bot-mergemonkey]

⚡ Risk Assessment — NEEDS-TESTING · ~45 min review

Focus areas: Directory emptiness check with Git repository detection · Generated file conflict detection for --allow-non-empty · Nuxt runtime file path resolution and build output · Redis and PostgreSQL message queue cleanup logic

Assessment: Adds new CLI flag, changes directory validation logic, and fixes runtime file resolution.

Walkthrough

User runs fedify init --allow-non-empty in a directory with an unborn Git repository. The system checks if the directory is safe (empty or only .git), verifies no generated files already exist, then scaffolds the project. For Nuxt, the module now resolves runtime files to compiled dist output instead of source TypeScript, ensuring proper packaging.

Changes

Files	Summary
Redis Message Queue Graceful Shutdown packages/redis/src/mq.ts, mq.test.ts, mq.race.test.ts	Implements graceful Redis connection shutdown with asyncDispose support. Adds error handling for already-closed connections and unified test cleanup helper to properly await async disposal.
PostgreSQL Message Queue Listen Cleanup packages/postgres/src/mq.ts	Fixes listen cleanup logic to properly unlisten and clear timeouts on abort signal. Adds connection destroyed error detection and ensures cleanup runs in finally block.
Fedify Init Allow Non-Empty Directory packages/init/src/action/mod.ts packages/init/src/action/patch.ts packages/init/src/action/patch.test.ts packages/init/src/ask/dir.ts packages/init/src/command.ts packages/init/src/lib.ts packages/init/src/lib.test.ts	Adds `--allow-non-empty` flag to allow initialization in non-empty directories. Implements conflict detection for generated files and enhanced directory emptiness check that recognizes unborn Git repositories as safe targets.
Init Config and Package Tests packages/init/src/action/configs.test.ts packages/init/src/package.test.ts	Adds comprehensive tests for Biome config schema matching and npm initialization flow. Updates test data to include allowNonEmpty field.
Nuxt Runtime File Resolution packages/nuxt/src/module.ts packages/nuxt/src/module.test.ts packages/nuxt/src/package.test.ts packages/nuxt/package.json packages/nuxt/tsdown.config.ts	Fixes Nuxt module to resolve runtime server files to compiled dist output instead of source TypeScript. Adds resolveRuntimeServerPath function and updates build config to compile runtime files. Removes src/runtime from package files list.
Fedify Test Message Queue Disposal packages/fedify/src/federation/mq.test.ts	Adds unified disposeMessageQueue helper function to properly handle both sync and async disposal in tests, replacing inline disposal logic.
Documentation and Configuration CHANGES.md docs/cli.md deno.lock	Documents new `--allow-non-empty` option and updates lock file dependencies.

Sequence Diagram

sequenceDiagram
  participant User
  participant CLI as fedify init
  participant DirCheck as isDirectoryEmpty
  participant GitCheck as isUnbornGitRepository
  participant ConflictCheck as assertNoGeneratedFileConflicts
  participant Scaffold as patchFiles
  User->>CLI: run with --allow-non-empty
  CLI->>DirCheck: check if dir is safe
  DirCheck->>GitCheck: verify .git is unborn
  GitCheck-->>DirCheck: true/false
  DirCheck-->>CLI: safe to proceed
  CLI->>ConflictCheck: verify no conflicts
  ConflictCheck-->>CLI: conflicts found or clear
  alt conflicts exist
    CLI-->>User: error: remove files or choose directory
  else no conflicts
    CLI->>Scaffold: create project files
    Scaffold-->>CLI: done
    CLI-->>User: success
  end

Loading

Dig Deeper With Commands

• /review <file-path> <function-optional>
• /chat <file-path> "<question>"
• /roast <file-path>

Runs only when explicitly triggered.