feat(docker-git): improve runtime state and terminal sessions

Author: skulidropek

README.md

@@ -64,6 +64,11 @@ docker-git apply-all --active
 bun run docker-git -- browser
 ```
 
+По умолчанию web-версия слушает все интерфейсы хоста (`0.0.0.0`), поэтому её можно открыть с другого устройства в LAN, например `http://192.168.0.206:4174/`. Чтобы ограничить доступ только этой машиной:
+```bash
+DOCKER_GIT_WEB_HOST=127.0.0.1 bun run docker-git -- browser
+```
+
 ## Подробности
 
 ```bash

package.json

@@ -22,15 +22,15 @@
     "changeset": "changeset",
     "changeset-publish": "bun -e \"if (!process.env.NPM_TOKEN) { console.log('Skipping publish: NPM_TOKEN is not set'); process.exit(0); }\" && changeset publish",
     "changeset-version": "changeset version",
-    "clone": "bash -lc 'bun run --cwd packages/app build:docker-git >/dev/null && bun ./packages/app/dist/src/docker-git/main.js clone \"$@\"' --",
-    "open": "bash -lc 'bun run --cwd packages/app build:docker-git >/dev/null && bun ./packages/app/dist/src/docker-git/main.js open \"$@\"' --",
-    "docker-git": "bash -lc 'bun run --cwd packages/app build:docker-git >/dev/null && bun ./packages/app/dist/src/docker-git/main.js \"$@\"' --",
+    "clone": "bash -lc 'bun run --cwd packages/app build:docker-git && bun ./packages/app/dist/src/docker-git/main.js clone \"$@\"' --",
+    "open": "bash -lc 'bun run --cwd packages/app build:docker-git && bun ./packages/app/dist/src/docker-git/main.js open \"$@\"' --",
+    "docker-git": "bash -lc 'bun run --cwd packages/app build:docker-git && bun ./packages/app/dist/src/docker-git/main.js \"$@\"' --",
     "e2e": "bash scripts/e2e/run-all.sh",
     "e2e:clone-cache": "bash scripts/e2e/clone-cache.sh",
     "e2e:login-context": "bash scripts/e2e/login-context.sh",
     "e2e:runtime-volumes-ssh": "bash scripts/e2e/runtime-volumes-ssh.sh",
     "e2e:opencode-autoconnect": "bash scripts/e2e/opencode-autoconnect.sh",
-    "list": "bash -lc 'bun run --cwd packages/app build:docker-git >/dev/null && bun ./packages/app/dist/src/docker-git/main.js ps \"$@\"' --",
+    "list": "bash -lc 'bun run --cwd packages/app build:docker-git && bun ./packages/app/dist/src/docker-git/main.js ps \"$@\"' --",
     "dev": "bun run --cwd packages/app dev",
     "web:dev": "bun run --cwd packages/app dev:web",
     "web:build": "bun run --cwd packages/app build:web",
@@ -41,7 +41,7 @@
     "lint:effect": "bun run --filter @prover-coder-ai/docker-git lint:effect && bun run --filter @effect-template/lib lint:effect",
     "test": "bun run --filter @prover-coder-ai/docker-git test && bun run --filter @effect-template/lib test",
     "typecheck": "bun run --filter @prover-coder-ai/docker-git typecheck && bun run --filter @effect-template/lib typecheck",
-    "start": "bash -lc 'bun run --cwd packages/app build:docker-git >/dev/null && bun ./packages/app/dist/src/docker-git/main.js \"$@\"' --"
+    "start": "bash -lc 'bun run --cwd packages/app build:docker-git && bun ./packages/app/dist/src/docker-git/main.js \"$@\"' --"
   },
   "devDependencies": {
     "@changesets/changelog-github": "^0.6.0",

packages/api/src/services/projects.ts

@@ -8,6 +8,8 @@ import {
   downAllDockerGitProjects,
   listProjectItems,
   readProjectConfig,
+  recordProjectRuntimeStarted,
+  recordProjectRuntimeStopped,
   renderError,
   runDockerComposeUpWithPortCheck
 } from "@effect-template/lib"
@@ -36,6 +38,8 @@ import { resolveCreateAuthorizedKeysContents, resolveManagedAuthorizedKeysConten
 import { projectShortKey } from "./project-port-proxy-core.js"
 import { loadProjectRuntimeByProject, runtimeForProject } from "./project-runtime.js"
 
+type RuntimeStartAction = "create" | "up" | "recreate"
+
 const readComposePsFormatted = (cwd: string) =>
   runCommandCapture(
     {
@@ -155,20 +159,32 @@ const withProjectRuntime = (
     }))
   )
 
-const summarizeProjectRuntime = (
-  project: ProjectItem,
-  runtime: ReturnType<typeof runtimeForProject>
+const cachedStatusLabel = (status: ProjectStatus): string =>
+  status === "unknown" ? "unknown" : `last known: ${status}`
+
+// CHANGE: derive project list/detail API payloads from `.docker-git` only
+// WHY: project inventory is database state, while Docker runtime is queried only by explicit runtime actions
+// QUOTE(ТЗ): ".docker-git это наша база данных можно скзаать"
+// REF: user-message-2026-04-21-db-only-project-list
+// SOURCE: n/a
+// FORMAT THEOREM: forall p in DB: listProjects(p) does not require docker(p)
+// PURITY: SHELL
+// EFFECT: n/a
+// INVARIANT: runtime fields are conservative defaults when not stored in `.docker-git`
+// COMPLEXITY: O(1)
+const dbProjectSummary = (
+  project: ProjectItem
 ): ProjectSummary => ({
   id: project.projectDir,
   projectKey: projectShortKey(project.projectDir),
   displayName: project.displayName,
   repoUrl: project.repoUrl,
   repoRef: project.repoRef,
-  status: runtime.running ? "running" : "stopped",
-  statusLabel: runtime.running ? "running" : "stopped",
-  sshSessions: runtime.sshSessions,
-  startedAtIso: runtime.startedAtIso,
-  startedAtEpochMs: runtime.startedAtEpochMs,
+  status: project.lastKnownStatus,
+  statusLabel: cachedStatusLabel(project.lastKnownStatus),
+  sshSessions: 0,
+  startedAtIso: project.lastStartedAtIso,
+  startedAtEpochMs: project.lastStartedAtEpochMs,
   clonedOnHostname: project.clonedOnHostname
 })
 
@@ -192,6 +208,26 @@ const toProjectDetails = (
   codexHome: project.codexHome
 })
 
+const dbProjectDetails = (project: ProjectItem): ProjectDetails => toProjectDetails(project, dbProjectSummary(project))
+
+const runtimeProjectDetails = (project: ProjectItem) =>
+  Effect.gen(function*(_) {
+    const runtimeByProject = yield* _(loadProjectRuntimeByProject([project]))
+    const summary = yield* _(withProjectRuntime(project, runtimeForProject(runtimeByProject, project)))
+    return toProjectDetails(project, summary)
+  })
+
+const recordProjectStartedFromDetails = (
+  project: ProjectItem,
+  details: ProjectDetails,
+  action: RuntimeStartAction
+) =>
+  recordProjectRuntimeStarted(project.projectDir, {
+    action,
+    startedAtIso: details.startedAtIso,
+    startedAtEpochMs: details.startedAtEpochMs
+  }).pipe(Effect.asVoid)
+
 const projectIdAliases = (
   path: Path.Path,
   projectId: string
@@ -486,9 +522,10 @@ const runPreparedCreateProject = (
         command.config.repoRef
       )
     )
-    const runtimeByProject = yield* _(loadProjectRuntimeByProject([project]))
-    const summary = yield* _(withProjectRuntime(project, runtimeForProject(runtimeByProject, project)))
-    const details = toProjectDetails(project, summary)
+    const details = command.runUp ? yield* _(runtimeProjectDetails(project)) : dbProjectDetails(project)
+    if (command.runUp) {
+      yield* _(recordProjectStartedFromDetails(project, details, "create"))
+    }
 
     yield* _(emitProjectCreatedEvents(projectId, project, details))
 
@@ -521,21 +558,8 @@ const startCreateProjectJob = (
 
 export const listProjects = () =>
   listProjectItems.pipe(
-    Effect.flatMap((projects) =>
-      loadProjectRuntimeByProject(projects, {
-        includeSshSessions: false,
-        includeStartedAt: false
-      }).pipe(
-        Effect.flatMap((runtimeByProject) =>
-          Effect.forEach(
-            projects,
-            (project) => Effect.succeed(summarizeProjectRuntime(project, runtimeForProject(runtimeByProject, project))),
-            { concurrency: "unbounded" }
-          )
-        )
-      )
-    ),
-    Effect.catchAll(() => Effect.succeed([] as ReadonlyArray<ProjectSummary>))
+    Effect.map((projects) => projects.map((project) => dbProjectDetails(project))),
+    Effect.catchAll(() => Effect.succeed([] as ReadonlyArray<ProjectDetails>))
   )
 
 export const applyAllProjects = (activeOnly: boolean) =>
@@ -551,9 +575,7 @@ export const getProject = (
 ) =>
   Effect.gen(function*(_) {
     const project = yield* _(findProjectById(projectId))
-    const runtimeByProject = yield* _(loadProjectRuntimeByProject([project]))
-    const summary = yield* _(withProjectRuntime(project, runtimeForProject(runtimeByProject, project)))
-    return toProjectDetails(project, summary)
+    return dbProjectDetails(project)
   })
 
 // CHANGE: create a docker-git project exclusively through typed API input.
@@ -686,9 +708,9 @@ export const upProject = (
       yield* _(syncContainerAuthorizedKeys(project))
     }
     yield* _(markDeployment(projectId, "running", "Container running"))
-    const runtimeByProject = yield* _(loadProjectRuntimeByProject([project]))
-    const summary = yield* _(withProjectRuntime(project, runtimeForProject(runtimeByProject, project)))
-    return toProjectDetails(project, summary)
+    const details = yield* _(runtimeProjectDetails(project))
+    yield* _(recordProjectStartedFromDetails(project, details, "up"))
+    return details
   }).pipe(Effect.mapError(toProjectApiError))
 
 export const downProject = (
@@ -699,6 +721,7 @@ export const downProject = (
     yield* _(markDeployment(projectId, "down", "docker compose down"))
     yield* _(runComposeCapture(projectId, project.projectDir, ["down"], [0, 1]))
     yield* _(markDeployment(projectId, "idle", "Container stopped"))
+    yield* _(recordProjectRuntimeStopped(project.projectDir))
   }).pipe(Effect.mapError(toProjectApiError))
 
 export const recreateProject = (
@@ -725,6 +748,8 @@ export const recreateProject = (
 
     yield* _(runComposeCapture(projectId, project.projectDir, ["down"], [0, 1]))
     yield* _(runDockerComposeUpWithPortCheck(project.projectDir))
+    const details = yield* _(runtimeProjectDetails(project))
+    yield* _(recordProjectStartedFromDetails(project, details, "recreate"))
     yield* _(markDeployment(projectId, "running", "Recreate completed"))
   }).pipe(Effect.mapError(toProjectApiError))
 

packages/api/tests/projects.test.ts

@@ -10,7 +10,7 @@ import type { ApiEvent } from "../src/api/contracts.js"
 import { ApiConflictError, ApiInternalError } from "../src/api/errors.js"
 import { resolveManagedAuthorizedKeysContents } from "../src/services/project-authorized-keys.js"
 import { listProjectEventsSince } from "../src/services/events.js"
-import { createProjectFromRequest, seedAuthorizedKeysForCreate } from "../src/services/projects.js"
+import { createProjectFromRequest, getProject, listProjects, seedAuthorizedKeysForCreate } from "../src/services/projects.js"
 
 const withTempDir = <A, E, R>(
   use: (tempDir: string) => Effect.Effect<A, E, R>
@@ -258,6 +258,126 @@ describe("projects service", () => {
       })
     ).pipe(Effect.provide(NodeContext.layer)))
 
+  it.effect("lists project inventory from .docker-git with conservative runtime defaults", () =>
+    withTempDir((root) =>
+      Effect.gen(function*(_) {
+        const path = yield* _(Path.Path)
+        const projectsRoot = path.join(root, ".docker-git")
+        const projectId = path.join(projectsRoot, "test-owner", "db-only")
+
+        yield* _(
+          withProjectsRoot(
+            projectsRoot,
+            withWorkingDirectory(
+              root,
+              createProjectFromRequest({
+                repoUrl: "https://git.example.test/test-owner/db-only.git",
+                repoRef: "main",
+                outDir: projectId,
+                skipGithubAuth: true,
+                up: false
+              })
+            )
+          )
+        )
+
+        const projects = yield* _(
+          withEnvVar(
+            "DOCKER_HOST",
+            "unix:///definitely-missing-docker.sock",
+            withProjectsRoot(projectsRoot, withWorkingDirectory(root, listProjects()))
+          )
+        )
+        const details = yield* _(
+          withEnvVar(
+            "DOCKER_HOST",
+            "unix:///definitely-missing-docker.sock",
+            withProjectsRoot(projectsRoot, withWorkingDirectory(root, getProject(projectId)))
+          )
+        )
+
+        expect(projects).toHaveLength(1)
+        expect(projects[0]).toMatchObject({
+          id: projectId,
+          projectDir: projectId,
+          status: "unknown",
+          statusLabel: "unknown",
+          sshSessions: 0,
+          startedAtIso: null,
+          startedAtEpochMs: null
+        })
+        expect(details).toMatchObject({
+          id: projectId,
+          projectDir: projectId,
+          status: "unknown",
+          statusLabel: "unknown"
+        })
+      })
+    ).pipe(Effect.provide(NodeContext.layer)))
+
+  it.effect("lists persisted launch metadata from .docker-git without Docker access", () =>
+    withTempDir((root) =>
+      Effect.gen(function*(_) {
+        const fs = yield* _(FileSystem.FileSystem)
+        const path = yield* _(Path.Path)
+        const projectsRoot = path.join(root, ".docker-git")
+        const projectId = path.join(projectsRoot, "test-owner", "launched")
+        const startedAtIso = "2026-04-21T10:00:00.000Z"
+        const startedAtEpochMs = Date.parse(startedAtIso)
+        const statePath = path.join(projectId, ".orch", "state", "runtime.json")
+
+        yield* _(
+          withProjectsRoot(
+            projectsRoot,
+            withWorkingDirectory(
+              root,
+              createProjectFromRequest({
+                repoUrl: "https://git.example.test/test-owner/launched.git",
+                repoRef: "main",
+                outDir: projectId,
+                skipGithubAuth: true,
+                up: false
+              })
+            )
+          )
+        )
+
+        yield* _(fs.makeDirectory(path.dirname(statePath), { recursive: true }))
+        yield* _(
+          fs.writeFileString(
+            statePath,
+            `${JSON.stringify({
+              schemaVersion: 1,
+              lastStartedAtIso: startedAtIso,
+              lastStartedAtEpochMs: startedAtEpochMs,
+              lastStartAction: "up",
+              lastKnownStatus: "running",
+              updatedAtIso: "2026-04-21T10:00:01.000Z"
+            }, null, 2)}\n`
+          )
+        )
+
+        const projects = yield* _(
+          withEnvVar(
+            "DOCKER_HOST",
+            "unix:///definitely-missing-docker.sock",
+            withProjectsRoot(projectsRoot, withWorkingDirectory(root, listProjects()))
+          )
+        )
+
+        expect(projects).toHaveLength(1)
+        expect(projects[0]).toMatchObject({
+          id: projectId,
+          projectDir: projectId,
+          status: "running",
+          statusLabel: "last known: running",
+          sshSessions: 0,
+          startedAtIso,
+          startedAtEpochMs
+        })
+      })
+    ).pipe(Effect.provide(NodeContext.layer)))
+
   it.effect("maps duplicate docker identities to API conflict for create", () =>
     withTempDir((root) =>
       Effect.gen(function*(_) {

packages/app/package.json

@@ -25,15 +25,15 @@
     "lint": "NODE_OPTIONS=--max-old-space-size=4096 PATH=../../scripts:$PATH vibecode-linter src/",
     "lint:tests": "NODE_OPTIONS=--max-old-space-size=4096 PATH=../../scripts:$PATH vibecode-linter tests/",
     "lint:effect": "NODE_OPTIONS=--max-old-space-size=4096 PATH=../../scripts:$PATH eslint --config eslint.effect-ts-check.config.mjs .",
-    "prebuild:docker-git": "bun install --cwd ../.. --silent && bun run --cwd ../lib build",
+    "prebuild:docker-git": "bun install --cwd ../.. && bun run --cwd ../lib build",
     "build:docker-git": "vite build --config vite.docker-git.config.ts",
     "check": "bun run typecheck",
-    "clone": "bash -lc 'bun run build:docker-git >/dev/null && bun dist/src/docker-git/main.js clone \"$@\"' --",
-    "open": "bash -lc 'bun run build:docker-git >/dev/null && bun dist/src/docker-git/main.js open \"$@\"' --",
-    "docker-git": "bash -lc 'bun run build:docker-git >/dev/null && bun dist/src/docker-git/main.js \"$@\"' --",
-    "list": "bash -lc 'bun run build:docker-git >/dev/null && bun dist/src/docker-git/main.js ps \"$@\"' --",
+    "clone": "bash -lc 'bun run build:docker-git && bun dist/src/docker-git/main.js clone \"$@\"' --",
+    "open": "bash -lc 'bun run build:docker-git && bun dist/src/docker-git/main.js open \"$@\"' --",
+    "docker-git": "bash -lc 'bun run build:docker-git && bun dist/src/docker-git/main.js \"$@\"' --",
+    "list": "bash -lc 'bun run build:docker-git && bun dist/src/docker-git/main.js ps \"$@\"' --",
     "preview:web": "vite preview --config vite.web.config.ts",
-    "start": "bash -lc 'bun run build:docker-git >/dev/null && bun dist/src/docker-git/main.js \"$@\"' --",
+    "start": "bash -lc 'bun run build:docker-git && bun dist/src/docker-git/main.js \"$@\"' --",
     "pretest": "bun run --cwd ../lib build",
     "test": "bun run lint:tests && vitest run",
     "pretypecheck": "bun run --cwd ../lib build",