@owdproject/cli 0.0.3 → 0.2.0

package/bin/lib/cpAscii.js

@@ -0,0 +1,39 @@
+import spinners from 'cli-spinners'
+import logSymbols from 'log-symbols'
+
+/** Same spinner family as ora (dots). */
+const DOTS = spinners.dots.frames
+
+export const spinnerFrameCount = DOTS.length
+
+/**
+ * @param {'info' | 'ok' | 'error'} [tone]
+ */
+export function statusPrefix(tone = 'info') {
+  if (tone === 'ok') return `${logSymbols.success} `
+  if (tone === 'error') return `${logSymbols.error} `
+  return ''
+}
+
+/**
+ * @param {number} frame
+ */
+export function radarSpinner(frame) {
+  return DOTS[frame % DOTS.length]
+}
+
+/**
+ * @param {number} step
+ * @param {number} total
+ * @param {number} _frame
+ * @param {number} [width]
+ */
+export function progressTrack(step, total, _frame, width = 16) {
+  if (total <= 0) return '░'.repeat(width)
+  const ratio = Math.min(1, step / total)
+  const filled = Math.round(ratio * width)
+  if (filled >= width) return '█'.repeat(width)
+  const before = '█'.repeat(filled)
+  const after = '░'.repeat(width - filled)
+  return `${before}${after}`
+}

package/bin/lib/cpFormat.js

@@ -0,0 +1,343 @@
+import { formatCatalogAge } from './catalog.js'
+import { githubHtmlUrl } from './packageSources.js'
+
+const ansiRegex = /[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g;
+function stripTags(str) {
+  const cleanAnsi = String(str).replace(ansiRegex, '')
+  return cleanAnsi.replace(/\{[^{}]+\}/g, '')
+}
+
+/** @typedef {{ pending?: boolean | undefined, colors?: Record<string, string>, columns?: Record<string, number> }} RowContext */
+
+const COL = {
+  sel: 3,
+  name: 28,
+  sources: 7,
+  dir: 4,
+  publisher: 20,
+  meta: 14,
+}
+
+export function getColumnWidths(targetWidth) {
+  const showChanges = targetWidth >= 110
+  const changesWidth = showChanges ? 10 : 0
+  const spaces = showChanges ? 6 : 5
+  const fixed = 3 + 7 + 4 + 14 + spaces + changesWidth
+  const remaining = targetWidth - fixed
+
+  let nameWidth = 28
+  let pubWidth = 20
+
+  if (remaining < 48) {
+    const minName = 15
+    const minPub = 10
+    const minTotal = minName + minPub // 25
+    if (remaining <= minTotal) {
+      nameWidth = minName
+      pubWidth = minPub
+    } else {
+      const ratio = (remaining - minTotal) / (48 - minTotal)
+      nameWidth = Math.floor(minName + ratio * (28 - minName))
+      pubWidth = remaining - nameWidth
+    }
+  } else {
+    const extra = remaining - 48
+    const extraName = Math.floor(extra * 0.6)
+    const extraPub = extra - extraName
+    nameWidth = 28 + extraName
+    pubWidth = 20 + extraPub
+  }
+
+  return {
+    sel: 3,
+    name: nameWidth,
+    sources: 7,
+    dir: 4,
+    changes: changesWidth,
+    publisher: pubWidth,
+    meta: 14,
+  }
+}
+
+
+const DEFAULT_COLORS = {
+  npm: '#7ee787',
+  git: 'cyan',
+  local: '#ff79c6',
+  warn: 'yellow',
+  add: '#7ee787',
+  remove: 'red',
+  accent: '#7ee787',
+  muted: '#6c7086',
+}
+
+/**
+ * @param {string} text
+ * @param {number} width
+ */
+export function padCell(text, width) {
+  const raw = String(text)
+  if (raw.length >= width) return raw.slice(0, width)
+  return raw + ' '.repeat(width - raw.length)
+}
+
+/**
+ * @param {object} item
+ */
+export function selectionMarker(item) {
+  const pending = item.pending
+  const installed = item.installed
+  if (pending === true) return '[+]'
+  if (pending === false) return '[-]'
+  if (installed) return '[*]'
+  return '[ ]'
+}
+
+/**
+ * @param {object} item
+ */
+export function sourceSlots(item) {
+  const hasNpm = Boolean(item.sourcesMeta?.npm?.version)
+  const hasGit = Boolean(item.htmlUrl || item.sourcesMeta?.github)
+  const hasLoc = Boolean(item.localSource)
+  return {
+    npm: hasNpm ? 'NPM' : '---',
+    git: hasGit ? 'GIT' : '---',
+    loc: hasLoc ? 'LOC' : '---',
+  }
+}
+
+/**
+ * @param {object} item
+ * @param {RowContext} [ctx]
+ */
+export function formatSelectionMarker(item, colors = DEFAULT_COLORS) {
+  const pending = item.pending
+  const installed = item.installed
+  if (pending === true) return `{${colors.muted}-fg}[{/}{${colors.add}-fg}+{/}{${colors.muted}-fg}]{/}`
+  if (pending === false) return `{${colors.muted}-fg}[{/}{${colors.remove}-fg}-{/}{${colors.muted}-fg}]{/}`
+  if (installed) return `{${colors.muted}-fg}[{/}{${colors.accent}-fg}*{/}{${colors.muted}-fg}]{/}`
+  return `{${colors.muted}-fg}[ ]{/}`
+}
+
+/**
+ * @param {object} item
+ * @param {RowContext} [ctx]
+ */
+export function formatCatalogRowPlain(item, ctx = {}) {
+  const colors = { ...DEFAULT_COLORS, ...ctx.colors }
+  const columns = { ...COL, ...ctx.columns }
+  const slots = sourceSlots(item)
+  const publisher = item.org && item.org !== 'workspace' ? item.org : 'owdproject'
+  const stars = item.stars > 0 ? `*${item.stars}` : ''
+  const age = formatCatalogAge(item.updatedAt ?? item.pushedAt)
+
+  // 1. Status / Selection Marker (3 chars)
+  const selTag = formatSelectionMarker(item, colors)
+
+  // 2. Name Column (columns.name chars)
+  let badgeText = (item.isNew || item.isRecent) ? ' new' : ''
+  const maxNameLen = columns.name - badgeText.length
+  let namePart = item.shortName
+  if (namePart.length > maxNameLen) {
+    namePart = namePart.slice(0, maxNameLen)
+  }
+  let nameTag = `{bold}{${colors.accent}-fg}${namePart}{/}{/}`
+  if (badgeText) {
+    nameTag += `{${colors.warn}-fg}${badgeText}{/}`
+  }
+  const namePadLen = columns.name - namePart.length - badgeText.length
+  if (namePadLen > 0) {
+    nameTag += ' '.repeat(namePadLen)
+  }
+
+  // 3. Sources Column (7 chars)
+  const srcNpm =
+    slots.npm === 'NPM' ? `{${colors.npm}-fg}${slots.npm}{/}` : `{${colors.muted}-fg}${slots.npm}{/}`
+  const srcGit =
+    slots.git === 'GIT' ? `{${colors.git}-fg}${slots.git}{/}` : `{${colors.muted}-fg}${slots.git}{/}`
+  const sources = `${srcNpm} ${srcGit}`
+
+  // 3.5 DIR Column (4 chars)
+  let dirTag = ''
+  const isMissing = item.installed && !item.localSource && !item.inPackageJson
+  if (isMissing) {
+    dirTag = `{red-fg}MISS{/}`
+  } else if (item.localSource) {
+    dirTag = `{${colors.npm}-fg}OK{/}  `
+  } else {
+    dirTag = `{${colors.muted}-fg}---{/} `
+  }
+
+  // 4. Publisher Column (columns.publisher chars)
+  let pubPart = publisher
+  if (pubPart.length > columns.publisher) {
+    pubPart = pubPart.slice(0, columns.publisher)
+  }
+  const pubColor = item.trusted === false ? colors.warn : colors.muted
+  let pubTag = `{${pubColor}-fg}${pubPart}{/}`
+  const pubPadLen = columns.publisher - pubPart.length
+  if (pubPadLen > 0) {
+    pubTag += ' '.repeat(pubPadLen)
+  }
+
+  // 5. Meta Column (columns.meta chars)
+  let finalStars = stars
+  let finalAge = age
+  const metaText = [stars, age].filter(Boolean).join(' ')
+  if (metaText.length > columns.meta) {
+    if (stars && age) {
+      const allowedAgeLen = columns.meta - stars.length - 1
+      if (allowedAgeLen > 0) {
+        finalAge = age.slice(0, allowedAgeLen)
+      } else {
+        finalAge = ''
+        finalStars = stars.slice(0, columns.meta)
+      }
+    } else if (stars) {
+      finalStars = stars.slice(0, columns.meta)
+    } else if (age) {
+      finalAge = age.slice(0, columns.meta)
+    }
+  }
+  const finalMetaText = [finalStars, finalAge].filter(Boolean).join(' ')
+  const metaPadLen = Math.max(0, columns.meta - finalMetaText.length)
+  let metaTag = ' '.repeat(metaPadLen)
+  if (finalStars && finalAge) {
+    metaTag += `{yellow-fg}${finalStars}{/} {${colors.muted}-fg}${finalAge}{/}`
+  } else if (finalStars) {
+    metaTag += `{yellow-fg}${finalStars}{/}`
+  } else if (finalAge) {
+    metaTag += `{${colors.muted}-fg}${finalAge}{/}`
+  }
+
+  let changesTag = ''
+  if (columns.changes > 0) {
+    const parts = []
+
+    // Local Git changes
+    if (item.localSource && ctx.localGitChanges && ctx.localGitChanges.has(item.shortName)) {
+      const ch = ctx.localGitChanges.get(item.shortName)
+      if (ch.added > 0) parts.push(`{${colors.add}-fg}+${ch.added}{/}`)
+      if (ch.modified > 0) parts.push(`{${colors.warn}-fg}~${ch.modified}{/}`)
+      if (ch.deleted > 0) parts.push(`{${colors.remove}-fg}-${ch.deleted}{/}`)
+    }
+
+    // Upstream Updates
+    if (ctx.packageUpdates && ctx.packageUpdates.has(item.shortName)) {
+      const updateInfo = ctx.packageUpdates.get(item.shortName)
+      if (updateInfo && updateInfo.hasUpdate) {
+        if (updateInfo.localGit) {
+          const count = updateInfo.behindCount ? `${updateInfo.behindCount}` : ''
+          parts.push(`{cyan-fg}↓${count}{/}`)
+        } else if (updateInfo.npm) {
+          parts.push(`{${colors.npm}-fg}↑{/}`)
+        }
+      }
+    }
+
+    const txt = parts.join(' ')
+    const rawLen = stripTags(txt).length
+    changesTag = txt + ' '.repeat(Math.max(0, columns.changes - rawLen))
+  }
+
+  // Join columns with exactly one space (matching header format)
+  const cols = [selTag, nameTag, sources, dirTag]
+  if (columns.changes > 0) {
+    cols.push(changesTag)
+  }
+  cols.push(pubTag, metaTag)
+  return cols.join(' ')
+}
+
+/**
+ * @param {Record<string, string>} [colors]
+ */
+export function formatLegendLine(colors = DEFAULT_COLORS) {
+  const c = { ...DEFAULT_COLORS, ...colors }
+  return [
+    `{${c.add}-fg}[+]{/} add`,
+    `{${c.remove}-fg}[-]{/} remove`,
+    `{${c.accent}-fg}[*]{/} on desktop`,
+    '|',
+    `{${c.npm}-fg}NPM{/} registry`,
+    `{${c.git}-fg}GIT{/} repo`,
+    `{${c.local}-fg}LOC{/} workspace`,
+    '|',
+    `{${c.npm}-fg}OK{/} folder exists`,
+    `{red-fg}MISS{/} folder missing`,
+    '|',
+    `{cyan-fg}↓{/} git pull`,
+    `{${c.npm}-fg}↑{/} npm update`,
+  ].join('  ')
+}
+
+/**
+ * @param {object} item
+ * @param {string} targetDir
+ * @param {Record<string, string>} [colors]
+ * @param {number} [width]
+ */
+export function formatDetailPanel(item, targetDir, colors = DEFAULT_COLORS, width = 76) {
+  const c = { ...DEFAULT_COLORS, ...colors }
+  const owner = item.org && item.org !== 'workspace' ? item.org : 'owdproject'
+  const lines = [`{bold}{${c.accent}-fg}${item.shortName}{/}{/}`]
+
+  const sourceParts = []
+  if (item.sourcesMeta?.npm?.version) {
+    sourceParts.push(`{${c.npm}-fg}NPM{/} ${item.sourcesMeta.npm.version}`)
+  }
+  const gitUrl = item.htmlUrl ?? githubHtmlUrl(owner, item.shortName)
+  sourceParts.push(`{${c.git}-fg}GIT{/} ${gitUrl}`)
+  if (item.localSource) {
+    sourceParts.push(`{${c.local}-fg}LOC{/} ${targetDir}/`)
+  }
+  lines.push(`  Sources ..... ${sourceParts.join('   ')}`)
+
+  const pub =
+    item.trusted === false
+      ? `{${c.warn}-fg}${owner} (untrusted){/}`
+      : owner
+  lines.push(`  Publisher ... ${pub}`)
+
+  const starsStr = item.stars > 0 ? `{yellow-fg}★${item.stars}{/}` : '0'
+  const dateStr = item.updatedAt ? new Date(item.updatedAt).toLocaleDateString() : '—'
+  const kindStr = item.kind ? item.kind.toUpperCase() : '—'
+  lines.push(`  Stats ....... Stars: ${starsStr}   ·   Updated: ${dateStr}   ·   Type: ${kindStr}`)
+
+  if (item.localSource) {
+    // Show update/change status in details if available
+  }
+
+  if (!item.localSource) {
+    const cloneText = `  Clone ....... ${targetDir}/`
+    const maxCloneLen = Math.max(15, width - 2)
+    const truncatedCloneText = cloneText.length > maxCloneLen ? cloneText.slice(0, maxCloneLen - 3) + '...' : cloneText
+    lines.push(`  {${c.muted}-fg}${truncatedCloneText}{/}`)
+  }
+
+  if (item.description) {
+    const maxDescLen = Math.max(15, width - 4)
+    lines.push(`  {${c.muted}-fg}${item.description.slice(0, maxDescLen)}{/}`)
+  }
+
+  const isMissing = item.installed && !item.localSource && !item.inPackageJson
+  if (isMissing) {
+    lines.push(`  {red-fg}{bold}⚠ WARNING: Local workspace folder is missing!{/}{/}`)
+  }
+
+  return lines.join('\n')
+}
+
+export function formatHeaderLine(colors = DEFAULT_COLORS, columns = COL) {
+  const status = ' '.repeat(columns.sel || 3) + ' '
+  const name = 'NAME'.padEnd(columns.name || 28, ' ') + ' '
+  const sources = 'SOURCES'.padEnd(columns.sources || 7, ' ') + ' '
+  const dir = 'DIR'.padEnd(columns.dir || 4, ' ') + ' '
+  const changes = columns.changes > 0 ? 'SYNC'.padEnd(columns.changes, ' ') + ' ' : ''
+  const publisher = 'PUBLISHER'.padEnd(columns.publisher || 20, ' ') + ' '
+  const meta = 'STARS/AGE'.padStart(columns.meta || 14, ' ')
+  return `{bold}${status}${name}${sources}${dir}${changes}${publisher}${meta}{/}`
+}
+
+export { COL as TUI_COLUMN_WIDTHS }

package/bin/lib/create.js

@@ -0,0 +1,246 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync, statSync, mkdtempSync, rmSync } from 'node:fs'
+import { join, dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import readline from 'node:readline/promises'
+import { stdin as input, stdout as output } from 'node:process'
+import { KINDS } from './workspace.js'
+import {
+  resolveDesktopConfigPath,
+  desktopConfigWritePath,
+} from './desktopConfig.js'
+import { addToDesktopConfig } from './config.js'
+import {
+  linkWorkspacePackage,
+  spawnAsync,
+} from './install.js'
+import { createRequire } from 'node:module'
+
+const require = createRequire(import.meta.url)
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const CLI_ROOT = resolve(__dirname, '../..')
+
+function pascalCase(str) {
+  return str
+    .replace(/(?:^|-|_)(\w)/g, (_, c) => c.toUpperCase())
+    .replace(/[-_]/g, '')
+}
+
+function camelCase(str) {
+  const p = pascalCase(str)
+  return p.charAt(0).toLowerCase() + p.slice(1)
+}
+
+async function cloneTemplate(gitUrl, destDir) {
+  try {
+    await spawnAsync('git', ['clone', '--depth', '1', gitUrl, destDir])
+  } catch (err) {
+    if (gitUrl.startsWith('git@')) {
+      const httpsUrl = gitUrl
+        .replace('git@github.com:', 'https://github.com/')
+        .replace(/\.git$/, '') + '.git'
+      console.log(`SSH clone failed, trying HTTPS fallback: ${httpsUrl}`)
+      await spawnAsync('git', ['clone', '--depth', '1', httpsUrl, destDir])
+    } else {
+      throw err
+    }
+  }
+}
+
+function copyAndScaffold(srcDir, destDir, replacements) {
+  if (!existsSync(destDir)) {
+    mkdirSync(destDir, { recursive: true })
+  }
+
+  const entries = readdirSync(srcDir)
+  for (const entry of entries) {
+    if (
+      entry === 'node_modules' ||
+      entry === '.nuxt' ||
+      entry === 'dist' ||
+      entry === '.output' ||
+      entry === '.git'
+    ) {
+      continue
+    }
+
+    const srcPath = join(srcDir, entry)
+    let destEntry = entry
+    for (const [placeholder, val] of Object.entries(replacements)) {
+      destEntry = destEntry.replaceAll(placeholder, val)
+    }
+    const destPath = join(destDir, destEntry)
+
+    const stat = statSync(srcPath)
+    if (stat.isDirectory()) {
+      copyAndScaffold(srcPath, destPath, replacements)
+    } else {
+      const fileContent = readFileSync(srcPath)
+      const isText = !fileContent.slice(0, 512).includes(0)
+      if (isText) {
+        let textContent = fileContent.toString('utf8')
+        for (const [placeholder, val] of Object.entries(replacements)) {
+          textContent = textContent.replaceAll(placeholder, val)
+        }
+        writeFileSync(destPath, textContent, 'utf8')
+      } else {
+        writeFileSync(destPath, fileContent)
+      }
+    }
+  }
+}
+
+export async function runCreateCli(options = {}) {
+  const workspaceRoot = options.workspaceRoot
+  if (!workspaceRoot) {
+    throw new Error('Not inside an OWD workspace.')
+  }
+
+  let { kind, name } = options
+
+  const rl = readline.createInterface({ input, output })
+
+  try {
+    // 1. Prompt for Kind if missing or invalid
+    while (!kind || (kind !== 'app' && kind !== 'module')) {
+      const answer = await rl.question('Select package kind (app / module) [app]: ')
+      const cleaned = answer.trim().toLowerCase()
+      if (cleaned === '') {
+        kind = 'app'
+      } else if (cleaned === 'app' || cleaned === 'module') {
+        kind = cleaned
+      } else {
+        console.log('Invalid kind. Please select "app" or "module".')
+      }
+    }
+
+    // 2. Prompt for Name if missing
+    while (!name || name.trim() === '') {
+      const answer = await rl.question(`Enter ${kind} name: `)
+      name = answer.trim().toLowerCase().replace(/[^a-z0-9-_]/g, '')
+      if (name === '') {
+        console.log('Name is required and should contain only alphanumeric characters, dashes, or underscores.')
+      }
+    }
+  } finally {
+    rl.close()
+  }
+
+  // Normalize prefix from name (e.g. if user entered "app-todo" instead of "todo")
+  if (kind === 'app' && name.startsWith('app-')) {
+    name = name.slice(4)
+  } else if (kind === 'module' && name.startsWith('module-')) {
+    name = name.slice(7)
+  }
+
+  const pkgShortName = `${kind}-${name}`
+  const pkgFullName = `@owdproject/${pkgShortName}`
+  const workspaceDir = KINDS[kind].workspaceDir
+  const targetDir = join(workspaceRoot, workspaceDir, pkgShortName)
+
+  if (existsSync(targetDir)) {
+    throw new Error(`Directory already exists: ${targetDir}`)
+  }
+
+  console.log(`\nCreating new ${kind} in ${targetDir}...\n`)
+
+  let templateSrc = null
+  let tempCloneDir = null
+
+  if (kind === 'app') {
+    const monorepoPath = join(workspaceRoot, 'apps/app-template')
+    if (existsSync(join(monorepoPath, 'package.json'))) {
+      templateSrc = monorepoPath
+    }
+  } else if (kind === 'module') {
+    const monorepoPath = join(workspaceRoot, 'packages/module-template')
+    if (existsSync(join(monorepoPath, 'package.json'))) {
+      templateSrc = monorepoPath
+    }
+  }
+
+  if (!templateSrc) {
+    const gitUrl = kind === 'app'
+      ? 'git@github.com:owdproject/app-template.git'
+      : 'git@github.com:owdproject/module-template.git'
+
+    console.log(`Cloning template from ${gitUrl}...`)
+    try {
+      const tmpPrefix = join(workspaceRoot, '.owd-template-')
+      tempCloneDir = mkdtempSync(tmpPrefix)
+      await cloneTemplate(gitUrl, tempCloneDir)
+      templateSrc = tempCloneDir
+    } catch (err) {
+      if (tempCloneDir && existsSync(tempCloneDir)) {
+        try {
+          rmSync(tempCloneDir, { recursive: true, force: true })
+        } catch {}
+      }
+      throw new Error(`Failed to clone template from GitHub: ${err.message}`)
+    }
+  }
+
+  // Prepare replacements
+  const replacements = {}
+  if (kind === 'app') {
+    replacements['@owdproject/app-template'] = pkgFullName
+    replacements['app-template'] = pkgShortName
+    replacements['desktop-app-template'] = `desktop-app-${name}`
+    replacements['desktop-app-template-register'] = `desktop-app-${name}-register`
+    replacements['appTemplate'] = `app${pascalCase(name)}`
+    replacements['AppTemplate'] = `App${pascalCase(name)}`
+    replacements['WindowTemplate'] = `Window${pascalCase(name)}`
+    replacements['myApp'] = `app${pascalCase(name)}`
+    replacements['my-app'] = `app-${name}`
+    replacements['ext.domain.app'] = `ext.domain.${name}`
+    replacements['Template'] = pascalCase(name)
+  } else {
+    replacements['@owdproject/module-template'] = pkgFullName
+    replacements['module-template'] = pkgShortName
+    replacements['desktop-module-template'] = `desktop-module-${name}`
+    replacements['desktop-module-template-register'] = `desktop-module-${name}-register`
+    replacements['moduleTemplate'] = `module${pascalCase(name)}`
+    replacements['ModuleTemplate'] = `Module${pascalCase(name)}`
+    replacements['ext.domain.module'] = `ext.domain.${name}`
+    replacements['owd-module-template'] = `owd-module-${name}`
+    replacements['owd-plugin-template'] = `owd-plugin-${name}`
+    replacements['Template'] = pascalCase(name)
+  }
+
+  // Copy and replace placeholders
+  try {
+    copyAndScaffold(templateSrc, targetDir, replacements)
+    console.log(`✓ Files scaffolded from template.`)
+  } finally {
+    if (tempCloneDir && existsSync(tempCloneDir)) {
+      try {
+        rmSync(tempCloneDir, { recursive: true, force: true })
+      } catch {}
+    }
+  }
+
+  // Run pnpm install in root
+  console.log('Running pnpm install in workspace root...')
+  await spawnAsync('pnpm', ['install'], { cwd: workspaceRoot })
+
+  // Link package in desktop
+  console.log(`Linking ${pkgFullName} in desktop project...`)
+  const desktopPath = join(workspaceRoot, 'desktop')
+  await linkWorkspacePackage(desktopPath, pkgFullName)
+
+  // Update desktop/desktop.config.ts
+  console.log('Registering package in desktop.config.ts...')
+  const resolved = resolveDesktopConfigPath(desktopPath)
+  const configPath = resolved?.path ?? desktopConfigWritePath(desktopPath)
+
+  addToDesktopConfig(configPath, workspaceRoot, KINDS[kind].configKey, pkgFullName)
+
+  // Run dev:prepare
+  console.log(`Running dev:prepare on ${pkgFullName}...`)
+  try {
+    await spawnAsync('pnpm', ['--filter', pkgFullName, 'run', 'dev:prepare'], { cwd: workspaceRoot })
+  } catch (err) {
+    console.warn(`(warning: dev:prepare failed — it's normal if package does not have the script)`)
+  }
+
+  console.log(`\n✓ Scaffolded and registered new ${kind}: ${pkgFullName}\n`)
+}

package/bin/lib/desktopConfig.js

@@ -0,0 +1,48 @@
+import { existsSync } from 'node:fs'
+import { join } from 'node:path'
+
+export const DESKTOP_CONFIG_FILENAME = 'desktop.config.ts'
+export const LEGACY_DESKTOP_CONFIG_FILENAME = 'owd.config.ts'
+
+export const LEGACY_CONFIG_DEPRECATION =
+  '[@owdproject/core] owd.config.ts is deprecated and kept only for backward compatibility; rename to desktop.config.ts (required from @owdproject/core 3.2).'
+
+export function resolveDesktopConfigPath(rootDir) {
+  const desktopPath = join(rootDir, DESKTOP_CONFIG_FILENAME)
+  const legacyPath = join(rootDir, LEGACY_DESKTOP_CONFIG_FILENAME)
+  const hasDesktop = existsSync(desktopPath)
+  const hasLegacy = existsSync(legacyPath)
+
+  if (hasDesktop && hasLegacy) {
+    console.warn(
+      '[@owdproject/core] Both desktop.config.ts and owd.config.ts exist; using desktop.config.ts. Remove owd.config.ts.',
+    )
+    return { path: desktopPath, file: DESKTOP_CONFIG_FILENAME, legacy: false }
+  }
+
+  if (hasDesktop) {
+    return { path: desktopPath, file: DESKTOP_CONFIG_FILENAME, legacy: false }
+  }
+
+  if (hasLegacy) {
+    return {
+      path: legacyPath,
+      file: LEGACY_DESKTOP_CONFIG_FILENAME,
+      legacy: true,
+    }
+  }
+
+  return null
+}
+
+export function warnLegacyDesktopConfig(resolved) {
+  if (resolved?.legacy) {
+    console.warn(LEGACY_CONFIG_DEPRECATION)
+  }
+}
+
+/** Path used when creating or updating config from the CLI (always the new filename). */
+export function desktopConfigWritePath(desktopDir) {
+  return join(desktopDir, DESKTOP_CONFIG_FILENAME)
+}
+