refactor: rework configuration

[goosewobbler]

No description provided.

[github-actions]

Release Preview — no release

No release label detected.
Note: Add release:patch, release:minor, or release:major to trigger a release.

---

Updated automatically by ReleaseKit

[greptile-apps]

Greptile Summary

This PR is a broad configuration rework that replaces the old notes.output array + top-level notes.llm/notes.templates keys with two first-class concepts: notes.changelog (always-on by default, mode: root) and notes.releaseNotes (off by default, opt-in). It also renames githubRelease.releaseNotes to githubRelease.body and tightens the schema with additionalProperties: false throughout. The notes init config shape and the single-package default mode (both flagged in prior review rounds) are now correctly addressed.

Key changes:

• notes.changelog and notes.releaseNotes replace notes.output[] — each supports mode (root/packages/both), file, and templates; LLM config moves exclusively under notes.releaseNotes.llm
• githubRelease.body is now a strict enum (auto | releaseNotes | changelog | generated | none) replacing the old releaseNotes string field that also accepted arbitrary file paths
• notes init auto-detects monorepo and writes the correct mode value
• versionStrategies.ts separates mainPkg (changelog source) from versionSourcePkg (version number source) in sync mode
• Migration concern: Zod silently strips notes.output, notes.llm, notes.templates, notes.monorepo, and notes.input from existing configs. Users with LLM configured under notes.llm or custom paths under notes.monorepo.rootPath/packagesPath will silently lose that configuration after upgrading — no warning is emitted. This should be called out as a breaking change or guarded with an unknown-key warning.

Confidence Score: 4/5

• Safe to merge for net-new installations; existing users with notes.output, notes.llm, or notes.monorepo configs will silently lose settings after upgrading.
• All three issues flagged in prior review rounds (invalid notes init config shape, wrong default mode for single-package repos, and the maxTokens/model concern) are addressed. One P1 remains: Zod silently strips the now-removed notes.output/notes.llm/notes.monorepo keys, so upgrading users lose their LLM and custom path configuration with no warning or error. This is an intentional breaking change in the refactor, but without a migration notice or runtime warning it could be invisible to existing users.
• packages/notes/src/core/pipeline.ts — silent config migration and double detectMonorepo call; packages/publish/src/stages/github-release.ts — misleading warning message

Important Files Changed

Filename	Overview
packages/config/src/schema.ts	Replaces OutputConfigSchema with ChangelogConfigSchema + ReleaseNotesConfigSchema; renames releaseNotes to body in GitHubReleaseConfigSchema; removes notes.monorepo, notes.templates, notes.llm, notes.input fields from NotesConfigSchema. Schema logic looks correct.
packages/notes/src/core/pipeline.ts	Central pipeline refactored: LLM is now gated under releaseNotes.llm; changelog and release-notes each have independent mode/file logic; writeMonorepoFiles helper added. Old notes.output/notes.llm config keys are silently dropped, and detectMonorepo is called twice when both sections use packages mode.
packages/notes/src/cli.ts	CLI rewritten with new flags (--changelog-mode, --release-notes-mode, --no-changelog, --no-release-notes); notes init now detects monorepo and writes valid ChangelogConfig shape; previous issue with invalid ChangelogConfig in init is resolved.
packages/publish/src/stages/github-release.ts	Replaces old releaseNotes string (including file-path fallback) with typed BodySource enum; removes readFileIfExists; resolveNotes now correctly gates auto-notes behind releaseNotesEnabled. Warning message when LLM-generated notes are absent can be misleading.
packages/publish/src/types.ts	Renames releaseNotes: string to body: BodySource enum in GitHubReleaseConfig; updates getDefaultConfig and toPublishConfig. Clean change with no issues.
packages/notes/src/core/types.ts	Restructures Config interface: removes output array and top-level llm/templates; adds `changelog?: false
packages/version/src/core/versionStrategies.ts	Separates versionSourcePath/versionSourceName from mainPkgPath/mainPkgName; adds first-workspace-package fallback when no mainPackage is configured; fixes spurious ${packageName} in tag templates for multi-package sync mode.
packages/release/src/release.ts	Removes getDefaultConfig dependency; passes releaseNotes ?? packageNotes to publish step so LLM-generated notes take precedence over standard changelog entries. Change is intentional and correct.
releasekit.config.json	Config updated to new schema: notes.output/llm replaced by notes.changelog + notes.releaseNotes; publish.githubRelease.body: 'auto' added; $schema changed to remote GitHub Pages URL.
releasekit.schema.json	JSON schema updated to match new config structure; additionalProperties: false added to many sub-objects; notes.output array replaced with notes.changelog/notes.releaseNotes oneOf schemas; body enum replaces releaseNotes string in githubRelease.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[runPipeline] --> B{config.changelog}
    B -- false --> C[Skip changelog]
    B -- undefined --> D["changelogConfig = { mode: 'root' }"]
    B -- object --> E["changelogConfig = { mode: 'root', ...config.changelog }"]
    D --> F{changelogConfig.mode?}
    E --> F
    F -- root/both --> G[writeMarkdown to root file]
    F -- packages/both --> H[writeMonorepoFiles]
    H --> I[detectMonorepo]
    I -- not monorepo --> J[return empty]
    I -- is monorepo --> K[writeMonorepoChangelogs mode:packages]

    A --> L{config.releaseNotes}
    L -- undefined/false --> M[Skip release notes]
    L -- object --> N{has mode or file?}
    N -- yes --> O["releaseNotesConfig = { mode: 'root', ...config.releaseNotes }"]
    N -- no --> P[releaseNotesConfig = config.releaseNotes]
    O --> Q{releaseNotesConfig.llm?}
    P --> Q
    Q -- yes --> R[processWithLLM contexts]
    Q -- no --> S[Skip LLM]
    R --> T{releaseNotesConfig.mode?}
    S --> T
    T -- root/both --> U[writeMarkdown to release notes file]
    T -- packages/both --> V[writeMonorepoFiles]
    T -- undefined --> W[No file written, LLM result in memory only]

Loading

_{Reviews (18): Last reviewed commit: "fix(release): update publish step to use..." | Re-trigger Greptile}