feat(cp): add Go Bubble Tea control panel with Node bridge

Replace the legacy Node CP entry with a Go TUI that builds on demand.
Add bridge.js and config helpers so the TUI can read/write desktop.config
and package dependencies. Ignore the local desktop-go binary artifact.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: dxlliv

.gitignore

@@ -6,4 +6,7 @@
 node_modules
 
 # Other
-package-lock.json
+package-lock.json
+
+# Go control panel binary (built by `go build -o desktop-go .`)
+go/desktop-go

bin/bridge.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+
+import { writeFileSync, readFileSync } from 'node:fs'
+import {
+  findWorkspaceRoot,
+  loadSettings,
+  desktopPaths,
+  saveSettings
+} from './lib/workspace.js'
+import {
+  readDesktopConfig,
+  writeDesktopConfig,
+  readDesktopDependencies,
+  writeDesktopDependencies
+} from './lib/config.js'
+import { loadCatalog, mergeInstalled } from './lib/catalog.js'
+
+function getWorkspaceContext() {
+  const workspaceRoot = findWorkspaceRoot()
+  if (!workspaceRoot) {
+    throw new Error('Not inside an OWD workspace')
+  }
+  const settings = loadSettings(workspaceRoot)
+  const paths = desktopPaths(workspaceRoot)
+  let config = { theme: null, apps: [], modules: [] }
+  try {
+    config = readDesktopConfig(paths.config, workspaceRoot)
+  } catch (err) {
+    console.error('Config load error:', err)
+  }
+  const deps = readDesktopDependencies(paths.packageJson)
+  return { workspaceRoot, settings, paths, config, deps }
+}
+
+async function main() {
+  const args = process.argv.slice(2)
+  const cmd = args[0]
+
+  try {
+    if (cmd === '--read') {
+      const ctx = getWorkspaceContext()
+      console.log(JSON.stringify({
+        workspaceRoot: ctx.workspaceRoot,
+        settings: ctx.settings,
+        config: ctx.config,
+        deps: ctx.deps,
+      }, null, 2))
+    } else if (cmd === '--catalog') {
+      const ctx = getWorkspaceContext()
+      const force = args.includes('--force')
+      const catalog = await loadCatalog(ctx.workspaceRoot, ctx.settings, { force })
+      catalog.entries = mergeInstalled(catalog.entries, ctx.config, ctx.deps, ctx.workspaceRoot)
+      console.log(JSON.stringify(catalog, null, 2))
+    } else if (cmd === '--write') {
+      const ctx = getWorkspaceContext()
+      
+      // Read JSON payload from stdin
+      let input = ''
+      for await (const chunk of process.stdin) {
+        input += chunk
+      }
+      
+      const payload = JSON.parse(input)
+      // payload = { config: { theme, apps, modules }, depsToAdd: { name: version }, depsToRemove: [name], settings?: { ... } }
+      
+      if (payload.config) {
+        writeDesktopConfig(ctx.paths.config, ctx.workspaceRoot, payload.config)
+      }
+      
+      if (payload.depsToAdd || payload.depsToRemove) {
+        writeDesktopDependencies(
+          ctx.paths.packageJson,
+          payload.depsToAdd || {},
+          payload.depsToRemove || []
+        )
+      }
+
+      if (payload.settings) {
+        saveSettings(ctx.workspaceRoot, payload.settings)
+      }
+      
+      console.log(JSON.stringify({ success: true }))
+    } else {
+      console.error('Usage: node bridge.js [--read|--catalog [--force]|--write]')
+      process.exit(1)
+    }
+  } catch (err) {
+    console.error(JSON.stringify({ error: err.message }))
+    process.exit(1)
+  }
+}
+
+main()

bin/cli.js

@@ -1,4 +1,5 @@
-import { spawn } from 'node:child_process'
+import { spawn, execSync } from 'node:child_process'
+import { fileURLToPath } from 'node:url'
 import { runDevForeground } from './lib/status.js'
 import { existsSync } from 'node:fs'
 import { join } from 'node:path'
@@ -132,8 +133,29 @@ LEGACY (still supported)
 }
 
 async function openControlPanel(name) {
-  const { runCp } = await import('./cp.js')
-  await runCp(name)
+  const cliDir = join(fileURLToPath(import.meta.url), '..')
+  const goDir = join(cliDir, '../go')
+  const binaryPath = join(goDir, 'desktop-go')
+
+  // Compile the Go Control Panel if binary doesn't exist
+  if (!existsSync(binaryPath)) {
+    console.log('Go Control Panel binary not found. Compiling...')
+    try {
+      execSync('go build -o desktop-go .', { cwd: goDir, stdio: 'inherit' })
+      console.log('Go Control Panel compiled successfully!')
+    } catch (err) {
+      console.warn('Failed to compile Go Control Panel, falling back to legacy CP:', err.message)
+      const { runCp } = await import('./cp.js')
+      await runCp(name)
+      return
+    }
+  }
+
+  // Execute Go TUI
+  const child = spawn(binaryPath, [], { stdio: 'inherit' })
+  child.on('exit', (code) => {
+    process.exit(code ?? 0)
+  })
 }
 
 function fail(message, hint) {

bin/lib/catalog.js

@@ -254,9 +254,9 @@ export async function loadCatalog(workspaceRoot, settings, options = {}) {
   const previousNames = readPreviousCatalogNames(workspaceRoot)
   const newDays = settings.catalogNewDays ?? 14
 
-  const cached = options.force ? null : readCache(workspaceRoot)
+  const cached = options.force ? null : readCacheFile(workspaceRoot)
   let remote = cached?.entries ?? null
-  let cacheAge = cached?.cacheAge ?? null
+  let cacheAge = cached?.fetchedAt ? formatCacheAge(cached.fetchedAt) : null
 
   if (!remote) {
     remote = []

bin/lib/config.js

@@ -107,3 +107,24 @@ export function readDesktopDependencies(packageJsonPath) {
   const deps = { ...pkg.dependencies, ...pkg.devDependencies }
   return Object.keys(deps).filter((name) => name.startsWith(SCOPE))
 }
+
+export function writeDesktopDependencies(packageJsonPath, toAdd, toRemove) {
+  if (!existsSync(packageJsonPath)) return
+  const pkg = JSON.parse(readFileSync(packageJsonPath, 'utf8'))
+  if (!pkg.dependencies) pkg.dependencies = {}
+  
+  // Add dependencies
+  for (const [name, version] of Object.entries(toAdd)) {
+    pkg.dependencies[name] = version
+  }
+  
+  // Remove dependencies
+  for (const name of toRemove) {
+    delete pkg.dependencies[name]
+    if (pkg.devDependencies) {
+      delete pkg.devDependencies[name]
+    }
+  }
+  
+  writeFileSync(packageJsonPath, JSON.stringify(pkg, null, 2) + '\n')
+}

bin/lib/migrateModulePlayground.config.mjs

@@ -104,8 +104,8 @@ export const configs = [
     fsMounts: { '/mnt/test': '/test.zip' },
     copyTestZip: true,
     playgroundExtraDevDeps: {
-      '@owdproject/module-fs': '^0.0.4',
-      '@owdproject/module-persistence': '^0.0.2',
+      '@owdproject/module-fs': 'workspace:*',
+      '@owdproject/module-persistence': 'workspace:*',
     },
     launch: {
       file: 'launch-audioplayer.client.ts',
@@ -143,8 +143,8 @@ export const configs = [
     fsMounts: { '/mnt/test': '/test.zip' },
     copyTestZip: true,
     playgroundExtraDevDeps: {
-      '@owdproject/module-fs': '^0.0.4',
-      '@owdproject/module-persistence': '^0.0.2',
+      '@owdproject/module-fs': 'workspace:*',
+      '@owdproject/module-persistence': 'workspace:*',
     },
     dependencies: {
     },
@@ -157,4 +157,31 @@ export const configs = [
     },
     pagesYml: true,
   },
+  {
+    path: 'apps/app-atproto',
+    slug: 'app-atproto',
+    name: '@owdproject/app-atproto',
+    moduleName: 'desktop-app-atproto',
+    version: '0.0.3',
+    playgroundTheme: '@owdproject/theme-win95',
+    playgroundModules: ['@owdproject/module-atproto'],
+    playgroundApps: ['@owdproject/app-terminal', '@owdproject/app-atproto'],
+    dependencies: {
+      '@owdproject/kit-tailwind': 'workspace:*',
+      '@owdproject/module-atproto': 'workspace:*',
+    },
+    playgroundExtraDevDeps: {
+      '@owdproject/module-atproto': 'workspace:*',
+      '@owdproject/theme-win95': 'workspace:*',
+      '@owdproject/app-terminal': 'workspace:*',
+    },
+    launch: {
+      file: 'launch-atproto.client.ts',
+      pluginName: 'app-atproto-playground-launch',
+      dependsOn: 'desktop-app-atproto-register',
+      appId: 'org.owdproject.atproto',
+      command: 'atproto',
+    },
+    pagesYml: true,
+  },
 ]

bin/lib/migrateModulePlayground.mjs

@@ -126,7 +126,7 @@ function buildPackageJson(cfg, old) {
     '@nuxt/module-builder': '^1.0.2',
     '@nuxt/schema': '^4.3.0',
     '@owdproject/core': 'workspace:*',
-    '@owdproject/theme-nova': '0.0.1',
+    '@owdproject/theme-nova': 'workspace:*',
     nuxt: '^4.3.0',
     typescript: '~5.9.3',
     ...(cfg.devDependencies || {}),
@@ -172,7 +172,7 @@ function buildPlaygroundPkg(cfg) {
     nuxt: '^4.4.4',
     ...(cfg.playgroundExtraDevDeps || {}),
   }
-  if (!cfg.playgroundTheme) deps['@owdproject/theme-nova'] = '0.0.1'
+  if (!cfg.playgroundTheme) deps['@owdproject/theme-nova'] = 'workspace:*'
   if (cfg.playgroundTheme) deps[cfg.playgroundTheme] = 'workspace:*'
   return {
     name: `${cfg.name}-playground`,
@@ -253,10 +253,15 @@ jobs:
 
 function migrate(cfg) {
   const dir = join(ROOT, cfg.path)
+  const pkgPath = join(dir, 'package.json')
+  if (!existsSync(pkgPath)) {
+    console.warn('Skipping path without package.json:', cfg.path)
+    return
+  }
   const src = join(dir, 'src')
   mkdirSync(src, { recursive: true })
-  if (existsSync(join(dir, 'module.ts'))) renameSync(join(dir, 'module.ts'), join(src, 'module.ts'))
-  if (existsSync(join(dir, 'runtime'))) renameSync(join(dir, 'runtime'), join(src, 'runtime'))
+  if (existsSync(join(dir, 'module.ts')) && !existsSync(join(src, 'module.ts'))) renameSync(join(dir, 'module.ts'), join(src, 'module.ts'))
+  if (existsSync(join(dir, 'runtime')) && !existsSync(join(src, 'runtime'))) renameSync(join(dir, 'runtime'), join(src, 'runtime'))
 
   const registerName = `${cfg.moduleName}-register`
   const pluginPath = join(src, 'runtime/plugin.ts')

bin/lib/packageSources.js

@@ -9,18 +9,22 @@ import { desktopMetaDir, fullName, SCOPE, KINDS, inferKind } from './workspace.j
  * @param {string} pkgShortName
  */
 export async function resolveForkUser(githubUser, pkgShortName) {
-  if (!githubUser || githubUser === 'owdproject') return 'owdproject'
+  if (!githubUser || githubUser === 'owdproject') return { exists: false, isFork: false }
 
   try {
     const res = await fetch(`https://api.github.com/repos/${githubUser}/${pkgShortName}`, {
       headers: { Accept: 'application/vnd.github+json', 'User-Agent': 'owd-desktop-cli' },
     })
-    if (res.ok) return githubUser
+    if (res.ok) {
+      const data = await res.json()
+      // data.fork === true only if this repo was forked FROM another repo
+      return { exists: true, isFork: data.fork === true }
+    }
   } catch {
     /* ignore */
   }
 
-  return 'owdproject'
+  return { exists: false, isFork: false }
 }
 
 /**
@@ -205,9 +209,11 @@ export async function resolvePackageSources(shortName, settings, workspaceRoot,
 
   let forkOwner = settings.githubUser && settings.githubUser !== 'owdproject' ? settings.githubUser : null
   let forkExists = false
+  let forkIsActualFork = false
   if (forkOwner) {
-    const resolved = await resolveForkUser(forkOwner, shortName)
-    forkExists = resolved === forkOwner
+    const result = await resolveForkUser(forkOwner, shortName)
+    forkExists = result.exists
+    forkIsActualFork = result.isFork
   }
 
   const local = workspaceRoot && hasLocalWorkspaceSource(workspaceRoot, pkgName)
@@ -222,8 +228,8 @@ export async function resolvePackageSources(shortName, settings, workspaceRoot,
         htmlUrl: officialHtml,
         exists: Boolean(catalogEntry.htmlUrl || officialOwner),
       },
-      fork: forkOwner
-        ? { owner: forkOwner, exists: forkExists, htmlUrl: githubHtmlUrl(forkOwner, shortName) }
+      fork: forkOwner && forkExists
+        ? { owner: forkOwner, exists: forkExists, isFork: forkIsActualFork, htmlUrl: githubHtmlUrl(forkOwner, shortName) }
         : null,
     },
     local: local ? true : false,
@@ -325,29 +331,10 @@ export function buildSourceOptions(metadata, settings, sshAuth = {}) {
  */
 export async function enrichCatalogEntries(entries, workspaceRoot, settings) {
   const cache = readCacheFile(workspaceRoot)
-  const sshAuth = await detectGithubSshAuth(workspaceRoot)
-  const shortNames = entries.map((e) => e.shortName)
-  const missingNpm = shortNames.filter((s) => !cache?.packages?.[s]?.npm)
-
-  if (missingNpm.length > 0) {
-    const packages = { ...(cache?.packages ?? {}) }
-    for (const shortName of missingNpm.slice(0, 40)) {
-      const version = fetchLatestVersion(fullName(shortName), { optional: true })
-      packages[shortName] = {
-        ...(packages[shortName] ?? {}),
-        npm: version ? { version } : null,
-      }
-    }
-    writeCacheFile(workspaceRoot, {
-      fetchedAt: Date.now(),
-      sshAuth: cache?.sshAuth ?? sshAuth,
-      packages,
-    })
-  }
+  const sshAuth = getCachedSshAuth(workspaceRoot) ?? { available: false }
 
-  const freshCache = readCacheFile(workspaceRoot)
   return entries.map((entry) => {
-    const pkgMeta = freshCache?.packages?.[entry.shortName]
+    const pkgMeta = cache?.packages?.[entry.shortName]
     return {
       ...entry,
       trusted: isTrustedPublisher(entry, settings),
@@ -358,6 +345,7 @@ export async function enrichCatalogEntries(entries, workspaceRoot, settings) {
             owner: entry.org && entry.org !== 'workspace' ? entry.org : 'owdproject',
             htmlUrl: entry.htmlUrl ?? githubHtmlUrl(entry.org ?? 'owdproject', entry.shortName),
           },
+          fork: pkgMeta?.github?.fork ?? null,
         },
       },
     }