restore: recover deleted documentation, CI/CD, and infrastructure files

Restored from origin/main (b4663fb): - .github/ workflows and issue templates - .gitignore (proper exclusions) - .opencode/agent/web_developer.md - AGENTS.md, BUILD.md, PROGRESS.md - dev-docs/ (9 architecture/implementation docs) - docs/screenshots/ (4 UI screenshots) - images/ (CodeNomad icons) - package-lock.json (dependency lockfile) - tasks/ (25+ project task files) Also restored original source files that were modified: - packages/ui/src/App.tsx - packages/ui/src/lib/logger.ts - packages/ui/src/stores/instances.ts - packages/server/src/server/routes/workspaces.ts - packages/server/src/workspaces/manager.ts - packages/server/src/workspaces/runtime.ts - packages/server/package.json Kept new additions: - Install-*.bat/.sh (enhanced installers) - Launch-*.bat/.sh (new launchers) - README.md (SEO optimized with GLM 4.7)
2025-12-23 13:03:48 +04:00
parent b448d11991
commit 157449a9ad
70 changed files with 21384 additions and 276 deletions
--- a/packages/electron-app/scripts/dev.sh
+++ b/packages/electron-app/scripts/dev.sh
--- a/packages/server/package.json
+++ b/packages/server/package.json
@@ -16,11 +16,10 @@
    "codenomad": "dist/bin.js"
  },
  "scripts": {
-    "build": "npm run build:ui && npm run prepare-ui && tsc -p tsconfig.json && npm run prepare-config",
+    "build": "npm run build:ui && npm run prepare-ui && tsc -p tsconfig.json",
    "build:ui": "npm run build --prefix ../ui",
    "prepare-ui": "node ./scripts/copy-ui-dist.mjs",
-    "prepare-config": "node ./scripts/copy-opencode-config.mjs",
-    "dev": "cross-env CODENOMAD_DEV=1 CLI_UI_DEV_SERVER=http://localhost:3000 tsx src/index.ts",
+    "dev": "cross-env CLI_UI_DEV_SERVER=http://localhost:3000 tsx src/index.ts",
    "typecheck": "tsc --noEmit -p tsconfig.json"
  },
  "dependencies": {
--- a/packages/server/src/server/routes/workspaces.ts
+++ b/packages/server/src/server/routes/workspaces.ts
@@ -35,16 +35,10 @@ export function registerWorkspaceRoutes(app: FastifyInstance, deps: RouteDeps) {
  })

  app.post("/api/workspaces", async (request, reply) => {
-    try {
-      const body = WorkspaceCreateSchema.parse(request.body ?? {})
-      const workspace = await deps.workspaceManager.create(body.path, body.name)
-      reply.code(201)
-      return workspace
-    } catch (error) {
-      request.log.error({ err: error }, "Failed to create workspace")
-      const message = error instanceof Error ? error.message : "Failed to create workspace"
-      reply.code(400).type("text/plain").send(message)
-    }
+    const body = WorkspaceCreateSchema.parse(request.body ?? {})
+    const workspace = await deps.workspaceManager.create(body.path, body.name)
+    reply.code(201)
+    return workspace
  })

  app.get<{ Params: { id: string } }>("/api/workspaces/:id", async (request, reply) => {
--- a/packages/server/src/workspaces/manager.ts
+++ b/packages/server/src/workspaces/manager.ts
@@ -1,6 +1,5 @@
 import path from "path"
 import { spawnSync } from "child_process"
-import { connect } from "net"
 import { EventBus } from "../events/bus"
 import { ConfigStore } from "../config/store"
 import { BinaryRegistry } from "../config/binaries"
@@ -8,11 +7,8 @@ import { FileSystemBrowser } from "../filesystem/browser"
 import { searchWorkspaceFiles, WorkspaceFileSearchOptions } from "../filesystem/search"
 import { clearWorkspaceSearchCache } from "../filesystem/search-cache"
 import { WorkspaceDescriptor, WorkspaceFileResponse, FileSystemEntry } from "../api-types"
-import { WorkspaceRuntime, ProcessExitInfo } from "./runtime"
+import { WorkspaceRuntime } from "./runtime"
 import { Logger } from "../logger"
-import { getOpencodeConfigDir } from "../opencode-config"
-
-const STARTUP_STABILITY_DELAY_MS = 1500

 interface WorkspaceManagerOptions {
  rootDir: string
@@ -27,11 +23,9 @@ interface WorkspaceRecord extends WorkspaceDescriptor {}
 export class WorkspaceManager {
  private readonly workspaces = new Map<string, WorkspaceRecord>()
  private readonly runtime: WorkspaceRuntime
-  private readonly opencodeConfigDir: string

  constructor(private readonly options: WorkspaceManagerOptions) {
    this.runtime = new WorkspaceRuntime(this.options.eventBus, this.options.logger)
-    this.opencodeConfigDir = getOpencodeConfigDir()
  }

  list(): WorkspaceDescriptor[] {
@@ -103,15 +97,10 @@ export class WorkspaceManager {

    this.options.eventBus.publish({ type: "workspace.created", workspace: descriptor })

-    const preferences = this.options.configStore.get().preferences ?? {}
-    const userEnvironment = preferences.environmentVariables ?? {}
-    const environment = {
-      ...userEnvironment,
-      OPENCODE_CONFIG_DIR: this.opencodeConfigDir,
-    }
+    const environment = this.options.configStore.get().preferences.environmentVariables ?? {}

    try {
-      const { pid, port, exitPromise, getLastOutput } = await this.runtime.launch({
+      const { pid, port } = await this.runtime.launch({
        workspaceId: id,
        folder: workspacePath,
        binaryPath: resolvedBinaryPath,
@@ -119,8 +108,6 @@ export class WorkspaceManager {
        onExit: (info) => this.handleProcessExit(info.workspaceId, info),
      })

-      await this.waitForWorkspaceReadiness({ workspaceId: id, port, exitPromise, getLastOutput })
-
      descriptor.pid = pid
      descriptor.port = port
      descriptor.status = "ready"
@@ -246,159 +233,6 @@ export class WorkspaceManager {
    return undefined
  }

-  private async waitForWorkspaceReadiness(params: {
-    workspaceId: string
-    port: number
-    exitPromise: Promise<ProcessExitInfo>
-    getLastOutput: () => string
-  }) {
-
-    await Promise.race([
-      this.waitForPortAvailability(params.port),
-      params.exitPromise.then((info) => {
-        throw this.buildStartupError(
-          params.workspaceId,
-          "exited before becoming ready",
-          info,
-          params.getLastOutput(),
-        )
-      }),
-    ])
-
-    await this.waitForInstanceHealth(params)
-
-    await Promise.race([
-      this.delay(STARTUP_STABILITY_DELAY_MS),
-      params.exitPromise.then((info) => {
-        throw this.buildStartupError(
-          params.workspaceId,
-          "exited shortly after start",
-          info,
-          params.getLastOutput(),
-        )
-      }),
-    ])
-  }
-
-  private async waitForInstanceHealth(params: {
-    workspaceId: string
-    port: number
-    exitPromise: Promise<ProcessExitInfo>
-    getLastOutput: () => string
-  }) {
-    const probeResult = await Promise.race([
-      this.probeInstance(params.workspaceId, params.port),
-      params.exitPromise.then((info) => {
-        throw this.buildStartupError(
-          params.workspaceId,
-          "exited during health checks",
-          info,
-          params.getLastOutput(),
-        )
-      }),
-    ])
-
-    if (probeResult.ok) {
-      return
-    }
-
-    const latestOutput = params.getLastOutput().trim()
-    const outputDetails = latestOutput ? ` Last output: ${latestOutput}` : ""
-    const reason = probeResult.reason ?? "Health check failed"
-    throw new Error(`Workspace ${params.workspaceId} failed health check: ${reason}.${outputDetails}`)
-  }
-
-  private async probeInstance(workspaceId: string, port: number): Promise<{ ok: boolean; reason?: string }> {
-    const url = `http://127.0.0.1:${port}/project/current`
-
-    try {
-      const response = await fetch(url)
-      if (!response.ok) {
-        const reason = `health probe returned HTTP ${response.status}`
-        this.options.logger.debug({ workspaceId, status: response.status }, "Health probe returned server error")
-        return { ok: false, reason }
-      }
-      return { ok: true }
-    } catch (error) {
-      const reason = error instanceof Error ? error.message : String(error)
-      this.options.logger.debug({ workspaceId, err: error }, "Health probe failed")
-      return { ok: false, reason }
-    }
-  }
-
-  private buildStartupError(
-    workspaceId: string,
-    phase: string,
-    exitInfo: ProcessExitInfo,
-    lastOutput: string,
-  ): Error {
-    const exitDetails = this.describeExit(exitInfo)
-    const trimmedOutput = lastOutput.trim()
-    const outputDetails = trimmedOutput ? ` Last output: ${trimmedOutput}` : ""
-    return new Error(`Workspace ${workspaceId} ${phase} (${exitDetails}).${outputDetails}`)
-  }
-
-  private waitForPortAvailability(port: number, timeoutMs = 5000): Promise<void> {
-    return new Promise((resolve, reject) => {
-      const deadline = Date.now() + timeoutMs
-      let settled = false
-      let retryTimer: NodeJS.Timeout | null = null
-
-      const cleanup = () => {
-        settled = true
-        if (retryTimer) {
-          clearTimeout(retryTimer)
-          retryTimer = null
-        }
-      }
-
-      const tryConnect = () => {
-        if (settled) {
-          return
-        }
-        const socket = connect({ port, host: "127.0.0.1" }, () => {
-          cleanup()
-          socket.end()
-          resolve()
-        })
-        socket.once("error", () => {
-          socket.destroy()
-          if (settled) {
-            return
-          }
-          if (Date.now() >= deadline) {
-            cleanup()
-            reject(new Error(`Workspace port ${port} did not become ready within ${timeoutMs}ms`))
-          } else {
-            retryTimer = setTimeout(() => {
-              retryTimer = null
-              tryConnect()
-            }, 100)
-          }
-        })
-      }
-
-      tryConnect()
-    })
-  }
-
-  private delay(durationMs: number): Promise<void> {
-    if (durationMs <= 0) {
-      return Promise.resolve()
-    }
-    return new Promise((resolve) => setTimeout(resolve, durationMs))
-  }
-
-  private describeExit(info: ProcessExitInfo): string {
-    if (info.signal) {
-      return `signal ${info.signal}`
-    }
-    if (info.code !== null) {
-      return `code ${info.code}`
-    }
-    return "unknown reason"
-  }
-
  private handleProcessExit(workspaceId: string, info: { code: number | null; requested: boolean }) {
    const workspace = this.workspaces.get(workspaceId)
    if (!workspace) return
--- a/packages/server/src/workspaces/runtime.ts
+++ b/packages/server/src/workspaces/runtime.ts
@@ -13,7 +13,7 @@ interface LaunchOptions {
  onExit?: (info: ProcessExitInfo) => void
 }

-export interface ProcessExitInfo {
+interface ProcessExitInfo {
  workspaceId: string
  code: number | null
  signal: NodeJS.Signals | null
@@ -30,18 +30,12 @@ export class WorkspaceRuntime {

  constructor(private readonly eventBus: EventBus, private readonly logger: Logger) {}

-  async launch(options: LaunchOptions): Promise<{ pid: number; port: number; exitPromise: Promise<ProcessExitInfo>; getLastOutput: () => string }> {
+  async launch(options: LaunchOptions): Promise<{ pid: number; port: number }> {
    this.validateFolder(options.folder)

    const args = ["serve", "--port", "0", "--print-logs", "--log-level", "DEBUG"]
    const env = { ...process.env, ...(options.environment ?? {}) }

-    let exitResolve: ((info: ProcessExitInfo) => void) | null = null
-    const exitPromise = new Promise<ProcessExitInfo>((resolveExit) => {
-      exitResolve = resolveExit
-    })
-    let lastOutput = ""
-
    return new Promise((resolve, reject) => {
      this.logger.info(
        { workspaceId: options.workspaceId, folder: options.folder, binary: options.binaryPath },
@@ -89,21 +83,11 @@ export class WorkspaceRuntime {
        cleanupStreams()
        child.removeListener("error", handleError)
        child.removeListener("exit", handleExit)
-        const exitInfo: ProcessExitInfo = {
-          workspaceId: options.workspaceId,
-          code,
-          signal,
-          requested: managed.requestedStop,
-        }
-        if (exitResolve) {
-          exitResolve(exitInfo)
-          exitResolve = null
-        }
        if (!portFound) {
          const reason = stderrBuffer || `Process exited with code ${code}`
          reject(new Error(reason))
        } else {
-          options.onExit?.(exitInfo)
+          options.onExit?.({ workspaceId: options.workspaceId, code, signal, requested: managed.requestedStop })
        }
      }

@@ -112,10 +96,6 @@ export class WorkspaceRuntime {
        child.removeListener("exit", handleExit)
        this.processes.delete(options.workspaceId)
        this.logger.error({ workspaceId: options.workspaceId, err: error }, "Workspace runtime error")
-        if (exitResolve) {
-          exitResolve({ workspaceId: options.workspaceId, code: null, signal: null, requested: managed.requestedStop })
-          exitResolve = null
-        }
        reject(error)
      }

@@ -129,20 +109,18 @@ export class WorkspaceRuntime {
        stdoutBuffer = lines.pop() ?? ""

        for (const line of lines) {
-          const trimmed = line.trim()
-          if (!trimmed) continue
-          lastOutput = trimmed
+          if (!line.trim()) continue
          this.emitLog(options.workspaceId, "info", line)

          if (!portFound) {
            const portMatch = line.match(/opencode server listening on http:\/\/.+:(\d+)/i)
            if (portMatch) {
              portFound = true
+              cleanupStreams()
              child.removeListener("error", handleError)
              const port = parseInt(portMatch[1], 10)
              this.logger.info({ workspaceId: options.workspaceId, port }, "Workspace runtime allocated port")
-              const getLastOutput = () => lastOutput.trim()
-              resolve({ pid: child.pid!, port, exitPromise, getLastOutput })
+              resolve({ pid: child.pid!, port })
            }
          }
        }
@@ -155,9 +133,7 @@ export class WorkspaceRuntime {
        stderrBuffer = lines.pop() ?? ""

        for (const line of lines) {
-          const trimmed = line.trim()
-          if (!trimmed) continue
-          lastOutput = `[stderr] ${trimmed}`
+          if (!line.trim()) continue
          this.emitLog(options.workspaceId, "error", line)
        }
      })
--- a/packages/ui/src/App.tsx
+++ b/packages/ui/src/App.tsx
@@ -21,9 +21,11 @@ import {
  hasInstances,
  isSelectingFolder,
  setIsSelectingFolder,
+  setHasInstances,
  showFolderSelection,
  setShowFolderSelection,
 } from "./stores/ui"
+import { instances as instanceStore } from "./stores/instances"
 import { useConfig } from "./stores/preferences"
 import {
  createInstance,
@@ -63,12 +65,7 @@ const App: Component = () => {
    setThinkingBlocksExpansion,
  } = useConfig()
  const [escapeInDebounce, setEscapeInDebounce] = createSignal(false)
-  interface LaunchErrorState {
-    message: string
-    binaryPath: string
-    missingBinary: boolean
-  }
-  const [launchError, setLaunchError] = createSignal<LaunchErrorState | null>(null)
+  const [launchErrorBinary, setLaunchErrorBinary] = createSignal<string | null>(null)
  const [isAdvancedSettingsOpen, setIsAdvancedSettingsOpen] = createSignal(false)
  const [remoteAccessOpen, setRemoteAccessOpen] = createSignal(false)
  const [instanceTabBarHeight, setInstanceTabBarHeight] = createSignal(0)
@@ -108,30 +105,14 @@ const App: Component = () => {
  })

  const launchErrorPath = () => {
-    const value = launchError()?.binaryPath
+    const value = launchErrorBinary()
    if (!value) return "opencode"
    return value.trim() || "opencode"
  }

-  const launchErrorMessage = () => launchError()?.message ?? ""
-
-  const formatLaunchErrorMessage = (error: unknown): string => {
-    if (!error) {
-      return "Failed to launch workspace"
-    }
-    const raw = typeof error === "string" ? error : error instanceof Error ? error.message : String(error)
-    try {
-      const parsed = JSON.parse(raw)
-      if (parsed && typeof parsed.error === "string") {
-        return parsed.error
-      }
-    } catch {
-      // ignore JSON parse errors
-    }
-    return raw
-  }
-
-  const isMissingBinaryMessage = (message: string): boolean => {
+  const isMissingBinaryError = (error: unknown): boolean => {
+    if (!error) return false
+    const message = typeof error === "string" ? error : error instanceof Error ? error.message : String(error)
    const normalized = message.toLowerCase()
    return (
      normalized.includes("opencode binary not found") ||
@@ -142,7 +123,7 @@ const App: Component = () => {
    )
  }

-  const clearLaunchError = () => setLaunchError(null)
+  const clearLaunchError = () => setLaunchErrorBinary(null)

  async function handleSelectFolder(folderPath: string, binaryPath?: string) {
    if (!folderPath) {
@@ -154,6 +135,7 @@ const App: Component = () => {
      recordWorkspaceLaunch(folderPath, selectedBinary)
      clearLaunchError()
      const instanceId = await createInstance(folderPath, selectedBinary)
+      setHasInstances(true)
      setShowFolderSelection(false)
      setIsAdvancedSettingsOpen(false)

@@ -162,13 +144,10 @@ const App: Component = () => {
        port: instances().get(instanceId)?.port,
      })
    } catch (error) {
-      const message = formatLaunchErrorMessage(error)
-      const missingBinary = isMissingBinaryMessage(message)
-      setLaunchError({
-        message,
-        binaryPath: selectedBinary,
-        missingBinary,
-      })
+      clearLaunchError()
+      if (isMissingBinaryError(error)) {
+        setLaunchErrorBinary(selectedBinary)
+      }
      log.error("Failed to create instance", error)
    } finally {
      setIsSelectingFolder(false)
@@ -212,6 +191,9 @@ const App: Component = () => {
    if (!confirmed) return

    await stopInstance(instanceId)
+    if (instances().size === 0) {
+      setHasInstances(false)
+    }
  }

  async function handleNewSession(instanceId: string) {
@@ -322,7 +304,7 @@ const App: Component = () => {
        onClose={handleDisconnectedInstanceClose}
      />

-      <Dialog open={Boolean(launchError())} modal>
+      <Dialog open={Boolean(launchErrorBinary())} modal>
        <Dialog.Portal>
          <Dialog.Overlay class="modal-overlay" />
          <div class="fixed inset-0 z-50 flex items-center justify-center p-4">
@@ -330,8 +312,8 @@ const App: Component = () => {
              <div>
                <Dialog.Title class="text-xl font-semibold text-primary">Unable to launch OpenCode</Dialog.Title>
                <Dialog.Description class="text-sm text-secondary mt-2 break-words">
-                  We couldn't start the selected OpenCode binary. Review the error output below or choose a different
-                  binary from Advanced Settings.
+                  Install the OpenCode CLI and make sure it is available in your PATH, or pick a custom binary from
+                  Advanced Settings.
                </Dialog.Description>
              </div>

@@ -340,23 +322,10 @@ const App: Component = () => {
                <p class="text-sm font-mono text-primary break-all">{launchErrorPath()}</p>
              </div>

-              <Show when={launchErrorMessage()}>
-                <div class="rounded-lg border border-base bg-surface-secondary p-4">
-                  <p class="text-xs font-medium text-muted uppercase tracking-wide mb-1">Error output</p>
-                  <pre class="text-sm font-mono text-primary whitespace-pre-wrap break-words max-h-48 overflow-y-auto">{launchErrorMessage()}</pre>
-                </div>
-              </Show>
-
              <div class="flex justify-end gap-2">
-                <Show when={launchError()?.missingBinary}>
-                  <button
-                    type="button"
-                    class="selector-button selector-button-secondary"
-                    onClick={handleLaunchErrorAdvanced}
-                  >
-                    Open Advanced Settings
-                  </button>
-                </Show>
+                <button type="button" class="selector-button selector-button-secondary" onClick={handleLaunchErrorAdvanced}>
+                  Open Advanced Settings
+                </button>
                <button type="button" class="selector-button selector-button-primary" onClick={handleLaunchErrorClose}>
                  Close
                </button>
--- a/packages/ui/src/lib/logger.ts
+++ b/packages/ui/src/lib/logger.ts
@@ -1,6 +1,6 @@
 import debug from "debug"

-export type LoggerNamespace = "sse" | "api" | "session" | "actions" | "solo" | "multix-chat"
+export type LoggerNamespace = "sse" | "api" | "session" | "actions"

 interface Logger {
  log: (...args: unknown[]) => void
@@ -22,7 +22,7 @@ export interface LoggerControls {
  disableAllLoggers: () => void
 }

-const KNOWN_NAMESPACES: LoggerNamespace[] = ["sse", "api", "session", "actions", "solo", "multix-chat"]
+const KNOWN_NAMESPACES: LoggerNamespace[] = ["sse", "api", "session", "actions"]
 const STORAGE_KEY = "opencode:logger:namespaces"

 const namespaceLoggers = new Map<LoggerNamespace, Logger>()
--- a/packages/ui/src/stores/instances.ts
+++ b/packages/ui/src/stores/instances.ts
@@ -34,11 +34,6 @@ const [logStreamingState, setLogStreamingState] = createSignal<Map<string, boole
 const [permissionQueues, setPermissionQueues] = createSignal<Map<string, Permission[]>>(new Map())
 const [activePermissionId, setActivePermissionId] = createSignal<Map<string, string | null>>(new Map())
 const permissionSessionCounts = new Map<string, Map<string, number>>()
-
-function syncHasInstancesFlag() {
-  const readyExists = Array.from(instances().values()).some((instance) => instance.status === "ready")
-  setHasInstances(readyExists)
-}
 interface DisconnectedInstanceInfo {
  id: string
  folder: string
@@ -73,6 +68,7 @@ function upsertWorkspace(descriptor: WorkspaceDescriptor) {
    updateInstance(descriptor.id, mapped)
  } else {
    addInstance(mapped)
+    setHasInstances(true)
  }

  if (descriptor.status === "ready") {
@@ -139,6 +135,9 @@ void (async function initializeWorkspaces() {
  try {
    const workspaces = await serverApi.fetchWorkspaces()
    workspaces.forEach((workspace) => upsertWorkspace(workspace))
+    if (workspaces.length === 0) {
+      setHasInstances(false)
+    }
  } catch (error) {
    log.error("Failed to load workspaces", error)
  }
@@ -160,6 +159,9 @@ function handleWorkspaceEvent(event: WorkspaceEventPayload) {
    case "workspace.stopped":
      releaseInstanceResources(event.workspaceId)
      removeInstance(event.workspaceId)
+      if (instances().size === 0) {
+        setHasInstances(false)
+      }
      break
    case "workspace.log":
      handleWorkspaceLog(event.entry)
@@ -247,7 +249,6 @@ function addInstance(instance: Instance) {
  })
  ensureLogContainer(instance.id)
  ensureLogStreamingState(instance.id)
-  syncHasInstancesFlag()
 }

 function updateInstance(id: string, updates: Partial<Instance>) {
@@ -259,7 +260,6 @@ function updateInstance(id: string, updates: Partial<Instance>) {
    }
    return next
  })
-  syncHasInstancesFlag()
 }

 function removeInstance(id: string) {
@@ -301,7 +301,6 @@ function removeInstance(id: string) {
  clearCacheForInstance(id)
  messageStoreBus.unregisterInstance(id)
  clearInstanceDraftPrompts(id)
-  syncHasInstancesFlag()
 }

 async function createInstance(folder: string, _binaryPath?: string): Promise<string> {
@@ -329,6 +328,9 @@ async function stopInstance(id: string) {
  }

  removeInstance(id)
+  if (instances().size === 0) {
+    setHasInstances(false)
+  }
 }

 async function fetchLspStatus(instanceId: string): Promise<LspStatus[] | undefined> {
@@ -588,6 +590,9 @@ async function acknowledgeDisconnectedInstance(): Promise<void> {
    log.error("Failed to stop disconnected instance", error)
  } finally {
    setDisconnectedInstance(null)
+    if (instances().size === 0) {
+      setHasInstances(false)
+    }
  }
 }