@shazhou/proman-core 0.9.0

package/tests/bump.test.ts

@@ -0,0 +1,261 @@
+import { mkdir, mkdtemp, readdir, readFile, rm, writeFile } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { afterEach, beforeEach, describe, expect, test } from 'vitest'
+import { bump } from '../src/commands/bump.ts'
+
+type FixtureOptions = {
+  version?: string
+  versions?: Record<string, string>
+  withChangeset?: boolean
+  changesetBody?: string
+  multiPkg?: boolean
+}
+
+async function setupFixture(tmp: string, opts: FixtureOptions = {}) {
+  const version = opts.version ?? '0.2.0'
+  const packages = opts.multiPkg
+    ? [
+        { name: '@test/core', path: 'packages/core', type: 'lib' },
+        { name: '@test/cli', path: 'packages/cli', type: 'cli' },
+      ]
+    : [{ name: '@test/core', path: 'packages/core', type: 'lib' }]
+
+  const { stringify } = await import('yaml')
+  await writeFile(join(tmp, 'proman.yaml'), stringify({ packages }))
+
+  for (const pkg of packages) {
+    const dir = join(tmp, pkg.path)
+    await mkdir(dir, { recursive: true })
+    const pkgVersion = opts.versions?.[pkg.name] ?? version
+    await writeFile(
+      join(dir, 'package.json'),
+      `${JSON.stringify({ name: pkg.name, version: pkgVersion }, null, 2)}\n`,
+    )
+  }
+
+  if (opts.withChangeset) {
+    const csDir = join(tmp, '.changeset')
+    await mkdir(csDir, { recursive: true })
+    const body = opts.changesetBody ?? '---\n"@test/core": minor\n---\nAdd feature X\n'
+    await writeFile(join(csDir, 'add-feature.md'), body)
+  }
+}
+
+let tmp: string
+
+beforeEach(async () => {
+  tmp = await mkdtemp(join(tmpdir(), 'proman-bump-'))
+})
+
+afterEach(async () => {
+  await rm(tmp, { recursive: true })
+})
+
+// ── bump command ──
+
+describe('bump', () => {
+  test('explicit --type patch bumps all packages', async () => {
+    await setupFixture(tmp, { version: '1.2.3' })
+    const bumped = await bump({ type: 'patch', cwd: tmp })
+    expect(bumped).toEqual({ '@test/core': '1.2.4' })
+
+    const pkg = JSON.parse(await readFile(join(tmp, 'packages/core/package.json'), 'utf8'))
+    expect(pkg.version).toBe('1.2.4')
+  })
+
+  test('explicit --type minor', async () => {
+    await setupFixture(tmp, { version: '1.2.3' })
+    const bumped = await bump({ type: 'minor', cwd: tmp })
+    expect(bumped).toEqual({ '@test/core': '1.3.0' })
+  })
+
+  test('explicit --type major', async () => {
+    await setupFixture(tmp, { version: '1.2.3' })
+    const bumped = await bump({ type: 'major', cwd: tmp })
+    expect(bumped).toEqual({ '@test/core': '2.0.0' })
+  })
+
+  test('auto-infer from changesets (only bumps mentioned package)', async () => {
+    await setupFixture(tmp, { withChangeset: true, version: '0.2.0' })
+    const bumped = await bump({ cwd: tmp })
+    expect(bumped).toEqual({ '@test/core': '0.3.0' }) // minor from changeset
+  })
+
+  test('rejects when no type and no changesets', async () => {
+    await setupFixture(tmp)
+    await expect(bump({ cwd: tmp })).rejects.toThrow('no --type specified')
+  })
+
+  test('explicit --type bumps all packages in monorepo', async () => {
+    await setupFixture(tmp, { multiPkg: true, version: '1.0.0' })
+    const bumped = await bump({ type: 'patch', cwd: tmp })
+    expect(bumped).toEqual({ '@test/core': '1.0.1', '@test/cli': '1.0.1' })
+
+    const core = JSON.parse(await readFile(join(tmp, 'packages/core/package.json'), 'utf8'))
+    const cli = JSON.parse(await readFile(join(tmp, 'packages/cli/package.json'), 'utf8'))
+    expect(core.version).toBe('1.0.1')
+    expect(cli.version).toBe('1.0.1')
+  })
+
+  test('changeset only bumps mentioned packages, leaves others unchanged', async () => {
+    await setupFixture(tmp, {
+      multiPkg: true,
+      version: '1.0.0',
+      withChangeset: true,
+      changesetBody: '---\n"@test/core": patch\n---\nFix bug\n',
+    })
+    const bumped = await bump({ cwd: tmp })
+    // Only core is bumped
+    expect(bumped).toEqual({ '@test/core': '1.0.1' })
+
+    const core = JSON.parse(await readFile(join(tmp, 'packages/core/package.json'), 'utf8'))
+    const cli = JSON.parse(await readFile(join(tmp, 'packages/cli/package.json'), 'utf8'))
+    expect(core.version).toBe('1.0.1')
+    expect(cli.version).toBe('1.0.0') // unchanged
+  })
+
+  test('changeset bumps multiple packages independently', async () => {
+    await setupFixture(tmp, {
+      multiPkg: true,
+      versions: { '@test/core': '1.0.0', '@test/cli': '2.0.0' },
+      withChangeset: true,
+      changesetBody: '---\n"@test/core": minor\n"@test/cli": patch\n---\nMixed changes\n',
+    })
+    const bumped = await bump({ cwd: tmp })
+    expect(bumped).toEqual({ '@test/core': '1.1.0', '@test/cli': '2.0.1' })
+
+    const core = JSON.parse(await readFile(join(tmp, 'packages/core/package.json'), 'utf8'))
+    const cli = JSON.parse(await readFile(join(tmp, 'packages/cli/package.json'), 'utf8'))
+    expect(core.version).toBe('1.1.0')
+    expect(cli.version).toBe('2.0.1')
+  })
+
+  test('does not touch workspace:* deps', async () => {
+    await setupFixture(tmp, { multiPkg: true })
+    // Add workspace dep
+    const cliPkg = join(tmp, 'packages/cli/package.json')
+    const json = JSON.parse(await readFile(cliPkg, 'utf8'))
+    json.dependencies = { '@test/core': 'workspace:*' }
+    await writeFile(cliPkg, `${JSON.stringify(json, null, 2)}\n`)
+
+    await bump({ type: 'patch', cwd: tmp })
+
+    const updated = JSON.parse(await readFile(cliPkg, 'utf8'))
+    expect(updated.dependencies['@test/core']).toBe('workspace:*')
+  })
+})
+
+// ── changelog generation (issue #74) ──
+
+describe('bump changelog', () => {
+  test('changeset-infer bump generates CHANGELOG.md', async () => {
+    await setupFixture(tmp, { withChangeset: true, version: '0.2.0' })
+    const bumped = await bump({ cwd: tmp, now: () => new Date('2026-06-08T00:00:00Z') })
+
+    expect(bumped).toEqual({ '@test/core': '0.3.0' })
+
+    const changelog = await readFile(join(tmp, 'packages/core/CHANGELOG.md'), 'utf8')
+    expect(changelog).toContain('0.3.0')
+    expect(changelog).toContain('2026-06-08')
+    expect(changelog).toContain('Add feature X')
+  })
+
+  test('changeset-infer bump deletes consumed changeset files', async () => {
+    await setupFixture(tmp, { withChangeset: true, version: '0.2.0' })
+    await bump({ cwd: tmp })
+
+    const csDir = join(tmp, '.changeset')
+    const files = await readdir(csDir)
+    expect(files.filter((f) => f.endsWith('.md') && f.toLowerCase() !== 'readme.md')).toHaveLength(
+      0,
+    )
+  })
+
+  test('explicit --type does not generate changelog or delete changesets', async () => {
+    await setupFixture(tmp, { withChangeset: true, version: '1.0.0' })
+    await bump({ type: 'patch', cwd: tmp })
+
+    // Changeset file should still exist
+    const csDir = join(tmp, '.changeset')
+    const files = await readdir(csDir)
+    expect(files).toContain('add-feature.md')
+
+    // No CHANGELOG.md generated
+    const changelogExists = await readFile(join(tmp, 'packages/core/CHANGELOG.md'), 'utf8').catch(
+      () => null,
+    )
+    expect(changelogExists).toBeNull()
+  })
+
+  test('changeset-infer bump merges multiple changesets into changelog', async () => {
+    await setupFixture(tmp, { version: '1.0.0' })
+
+    // Create two changeset files
+    const csDir = join(tmp, '.changeset')
+    await mkdir(csDir, { recursive: true })
+    await writeFile(join(csDir, 'first.md'), '---\n"@test/core": minor\n---\nAdd feature A\n')
+    await writeFile(join(csDir, 'second.md'), '---\n"@test/core": patch\n---\nFix bug B\n')
+
+    const bumped = await bump({ cwd: tmp, now: () => new Date('2026-06-08T00:00:00Z') })
+    // minor wins over patch
+    expect(bumped).toEqual({ '@test/core': '1.1.0' })
+
+    const changelog = await readFile(join(tmp, 'packages/core/CHANGELOG.md'), 'utf8')
+    expect(changelog).toContain('1.1.0')
+    expect(changelog).toContain('Add feature A')
+    expect(changelog).toContain('Fix bug B')
+
+    // Both changeset files deleted
+    const files = await readdir(csDir)
+    expect(files.filter((f) => f.endsWith('.md'))).toHaveLength(0)
+  })
+
+  test('changeset-infer bump prepends to existing CHANGELOG.md', async () => {
+    await setupFixture(tmp, { withChangeset: true, version: '0.2.0' })
+
+    // Pre-existing changelog
+    const changelogPath = join(tmp, 'packages/core/CHANGELOG.md')
+    await writeFile(changelogPath, '# Changelog\n\n## 0.1.0 — 2026-01-01\n\n- Initial release\n')
+
+    await bump({ cwd: tmp, now: () => new Date('2026-06-08T00:00:00Z') })
+
+    const changelog = await readFile(changelogPath, 'utf8')
+    // New entry should come before old entry
+    const newIdx = changelog.indexOf('0.3.0')
+    const oldIdx = changelog.indexOf('0.1.0')
+    expect(newIdx).toBeLessThan(oldIdx)
+    expect(changelog).toContain('Add feature X')
+    expect(changelog).toContain('Initial release')
+  })
+
+  test('multi-package: only generates changelog for changeset-mentioned packages', async () => {
+    await setupFixture(tmp, {
+      multiPkg: true,
+      version: '1.0.0',
+      withChangeset: true,
+      changesetBody: '---\n"@test/core": patch\n---\nFix core bug\n',
+    })
+
+    await bump({ cwd: tmp, now: () => new Date('2026-06-08T00:00:00Z') })
+
+    // core gets changelog
+    const coreChangelog = await readFile(join(tmp, 'packages/core/CHANGELOG.md'), 'utf8')
+    expect(coreChangelog).toContain('1.0.1')
+    expect(coreChangelog).toContain('Fix core bug')
+
+    // cli does NOT get changelog
+    const cliChangelog = await readFile(join(tmp, 'packages/cli/CHANGELOG.md'), 'utf8').catch(
+      () => null,
+    )
+    expect(cliChangelog).toBeNull()
+  })
+
+  test('changeset-infer bump uses injected now() for changelog date', async () => {
+    await setupFixture(tmp, { withChangeset: true, version: '0.2.0' })
+    await bump({ cwd: tmp, now: () => new Date('2025-12-25T00:00:00Z') })
+
+    const changelog = await readFile(join(tmp, 'packages/core/CHANGELOG.md'), 'utf8')
+    expect(changelog).toContain('2025-12-25')
+  })
+})

package/tests/changeset.test.ts

@@ -0,0 +1,147 @@
+import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { afterEach, beforeEach, describe, expect, test } from 'vitest'
+import {
+  buildChangelogEntry,
+  parseChangeset,
+  prependChangelog,
+  readChangesets,
+} from '../src/utils/changeset.ts'
+
+describe('parseChangeset', () => {
+  test('parses single-package frontmatter', () => {
+    const raw = `---\n'pkg-a': minor\n---\n\nAdd new API.\n`
+    const cs = parseChangeset(raw, '/tmp/x.md')
+    expect(cs.packages).toEqual({ 'pkg-a': 'minor' })
+    expect(cs.body).toBe('Add new API.')
+  })
+
+  test('parses multi-package frontmatter (quoted and unquoted)', () => {
+    const raw = `---\npkg-a: patch\n"pkg-b": minor\n---\nBody line.\n`
+    const cs = parseChangeset(raw, '/tmp/x.md')
+    expect(cs.packages).toEqual({ 'pkg-a': 'patch', 'pkg-b': 'minor' })
+  })
+
+  test('trims body of leading/trailing blank lines', () => {
+    const raw = '---\npkg-a: patch\n---\n\n\nThe body.\n\n\n'
+    const cs = parseChangeset(raw, '/tmp/x.md')
+    expect(cs.body).toBe('The body.')
+  })
+
+  test('rejects unknown bump type', () => {
+    const raw = '---\npkg-a: weird\n---\nbody\n'
+    expect(() => parseChangeset(raw, '/tmp/x.md')).toThrow(/invalid bump/)
+  })
+
+  test('rejects missing frontmatter', () => {
+    expect(() => parseChangeset('no frontmatter here', '/tmp/x.md')).toThrow(/frontmatter/)
+  })
+
+  test('stores file exactly as passed', () => {
+    const raw = '---\npkg-a: patch\n---\nbody\n'
+    const cs = parseChangeset(raw, '/abs/path/cs.md')
+    expect(cs.file).toBe('/abs/path/cs.md')
+  })
+})
+
+describe('readChangesets', () => {
+  let tmp: string
+  beforeEach(async () => {
+    tmp = await mkdtemp(join(tmpdir(), 'proman-cs-'))
+  })
+  afterEach(async () => {
+    await rm(tmp, { recursive: true, force: true })
+  })
+
+  test('returns empty array when .changeset/ does not exist', async () => {
+    expect(await readChangesets(tmp)).toEqual([])
+  })
+
+  test('returns empty array when only config.json exists', async () => {
+    await mkdir(join(tmp, '.changeset'))
+    await writeFile(join(tmp, '.changeset/config.json'), '{}')
+    expect(await readChangesets(tmp)).toEqual([])
+  })
+
+  test('lists only *.md (excludes config.json, README.md, non-md)', async () => {
+    await mkdir(join(tmp, '.changeset'))
+    await writeFile(join(tmp, '.changeset/funny-fox.md'), '---\npkg-a: minor\n---\nA\n')
+    await writeFile(join(tmp, '.changeset/brave-bear.md'), '---\npkg-b: patch\n---\nB\n')
+    await writeFile(join(tmp, '.changeset/config.json'), '{}')
+    await writeFile(join(tmp, '.changeset/README.md'), 'readme')
+    await writeFile(join(tmp, '.changeset/notes.txt'), 'x')
+    const cs = await readChangesets(tmp)
+    expect(cs.length).toBe(2)
+    expect(cs.map((c) => c.file.split('/').pop())).toEqual(['brave-bear.md', 'funny-fox.md'])
+  })
+
+  test('sorts results by filename', async () => {
+    await mkdir(join(tmp, '.changeset'))
+    await writeFile(join(tmp, '.changeset/zebra.md'), '---\npkg-a: minor\n---\nZ\n')
+    await writeFile(join(tmp, '.changeset/alpha.md'), '---\npkg-a: minor\n---\nA\n')
+    const cs = await readChangesets(tmp)
+    expect(cs.map((c) => c.file.split('/').pop())).toEqual(['alpha.md', 'zebra.md'])
+  })
+
+  test('throws on .md without frontmatter', async () => {
+    await mkdir(join(tmp, '.changeset'))
+    await writeFile(join(tmp, '.changeset/bad.md'), 'no frontmatter here\n')
+    await expect(readChangesets(tmp)).rejects.toThrow(/frontmatter/)
+  })
+})
+
+describe('buildChangelogEntry', () => {
+  test('single body', () => {
+    const out = buildChangelogEntry({ version: '0.3.0', date: '2026-06-02', bodies: ['Add API.'] })
+    expect(out).toBe('## 0.3.0 — 2026-06-02\n\n- Add API.\n\n')
+  })
+
+  test('multi-line body uses two-space continuation indent', () => {
+    const out = buildChangelogEntry({
+      version: '0.3.0',
+      date: '2026-06-02',
+      bodies: ['L1\nL2'],
+    })
+    expect(out).toContain('- L1\n  L2')
+  })
+
+  test('multiple bodies become multiple bullets in order', () => {
+    const out = buildChangelogEntry({
+      version: '0.3.0',
+      date: '2026-06-02',
+      bodies: ['First', 'Second'],
+    })
+    const firstIdx = out.indexOf('- First')
+    const secondIdx = out.indexOf('- Second')
+    expect(firstIdx).toBeGreaterThan(0)
+    expect(secondIdx).toBeGreaterThan(firstIdx)
+  })
+})
+
+describe('prependChangelog', () => {
+  test('null existing yields # Changelog header + entry', () => {
+    const out = prependChangelog(null, '## 0.3.0 — 2026-06-02\n\n- A\n\n')
+    expect(out).toBe('# Changelog\n\n## 0.3.0 — 2026-06-02\n\n- A\n\n')
+  })
+
+  test('inserts entry after existing # Changelog heading', () => {
+    const existing = '# Changelog\n\n## 0.2.0 — 2025-01-01\n\n- old\n'
+    const out = prependChangelog(existing, '## 0.3.0 — 2026-06-02\n\n- new\n\n')
+    expect(out.startsWith('# Changelog\n\n## 0.3.0 — 2026-06-02')).toBe(true)
+    expect(out).toContain('## 0.2.0')
+    expect(out).toContain('- old')
+  })
+
+  test('no heading: prepends entry above existing content', () => {
+    const existing = 'just some text\n'
+    const out = prependChangelog(existing, '## 0.3.0 — 2026-06-02\n\n- n\n\n')
+    expect(out.startsWith('## 0.3.0')).toBe(true)
+    expect(out).toContain('just some text')
+  })
+
+  test('empty existing treated like null', () => {
+    const out = prependChangelog('', '## 0.3.0\n\n- n\n\n')
+    expect(out.startsWith('# Changelog')).toBe(true)
+  })
+})

package/tests/deploy.test.ts

@@ -0,0 +1,98 @@
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+import { describe, expect, test } from 'vitest'
+import { deploy } from '../src/commands/deploy.ts'
+import type { SpawnFn } from '../src/utils/npm.ts'
+
+const FIX = (name: string) => resolve(__dirname, 'fixtures', name)
+
+type Call = { argv: string[]; cwd: string }
+
+function makeSpawn(code = 0, stdout = '', stderr = '') {
+  const calls: Call[] = []
+  const fn: SpawnFn = async (argv, cwd) => {
+    calls.push({ argv, cwd })
+    return { code, stdout, stderr }
+  }
+  return { spawn: fn, calls }
+}
+
+describe('deploy command', () => {
+  test('DEP1: typed fixture, no flags, deploys webui then api', async () => {
+    const { spawn, calls } = makeSpawn()
+    await deploy({ cwd: FIX('typed'), spawn })
+    expect(calls).toHaveLength(2)
+    // webui
+    expect(calls[0]?.argv).toEqual(['pnpm', 'exec', 'wrangler', 'pages', 'deploy', 'dist'])
+    expect(calls[0]?.cwd).toBe(resolve(FIX('typed'), 'packages/dashboard'))
+    // api
+    expect(calls[1]?.argv).toEqual(['pnpm', 'exec', 'wrangler', 'deploy'])
+    expect(calls[1]?.cwd).toBe(resolve(FIX('typed'), 'packages/api'))
+  })
+
+  test('DEP2: --env staging appends to both', async () => {
+    const { spawn, calls } = makeSpawn()
+    await deploy({ cwd: FIX('typed'), spawn, env: 'staging' })
+    expect(calls).toHaveLength(2)
+    expect(calls[0]?.argv).toEqual([
+      'pnpm',
+      'exec',
+      'wrangler',
+      'pages',
+      'deploy',
+      'dist',
+      '--env',
+      'staging',
+    ])
+    expect(calls[1]?.argv).toEqual(['pnpm', 'exec', 'wrangler', 'deploy', '--env', 'staging'])
+  })
+
+  test('DEP3: --package selects only one webui', async () => {
+    const { spawn, calls } = makeSpawn()
+    await deploy({ cwd: FIX('typed'), spawn, pkg: '@myapp/dashboard' })
+    expect(calls).toHaveLength(1)
+    expect(calls[0]?.argv).toEqual(['pnpm', 'exec', 'wrangler', 'pages', 'deploy', 'dist'])
+    expect(calls[0]?.cwd).toBe(resolve(FIX('typed'), 'packages/dashboard'))
+  })
+
+  test('DEP4: --package on a lib throws not-deployable', async () => {
+    const { spawn } = makeSpawn()
+    await expect(deploy({ cwd: FIX('typed'), spawn, pkg: '@ocas/core' })).rejects.toThrow(
+      /not deployable|cannot deploy/i,
+    )
+  })
+
+  test('DEP5: --package not found throws', async () => {
+    const { spawn } = makeSpawn()
+    await expect(deploy({ cwd: FIX('typed'), spawn, pkg: 'does-not-exist' })).rejects.toThrow(
+      /not found|unknown package/i,
+    )
+  })
+
+  test('DEP6: no-deployable fixture, no flags → no spawn, no throw', async () => {
+    const { spawn, calls } = makeSpawn()
+    await deploy({ cwd: FIX('no-deployable'), spawn })
+    expect(calls).toHaveLength(0)
+  })
+
+  test('DEP7: non-zero spawn exit throws', async () => {
+    const { spawn } = makeSpawn(1, '', 'fail')
+    await expect(deploy({ cwd: FIX('typed'), spawn })).rejects.toThrow()
+  })
+
+  test('DEP8: --env production --package @myapp/api', async () => {
+    const { spawn, calls } = makeSpawn()
+    await deploy({
+      cwd: FIX('typed'),
+      spawn,
+      pkg: '@myapp/api',
+      env: 'production',
+    })
+    expect(calls).toHaveLength(1)
+    expect(calls[0]?.argv).toEqual(['pnpm', 'exec', 'wrangler', 'deploy', '--env', 'production'])
+    expect(calls[0]?.cwd).toBe(resolve(FIX('typed'), 'packages/api'))
+  })
+})