refactor(packages): add workspace dependency layering

Author: beorn

CLAUDE.md

@@ -22,8 +22,9 @@ content/                        ← ALL input data
   probes-mux/                     measured: multiplexer pass-through results
 
 packages/                       ← source code (internal tools)
-  probes/                         probe test files (*.probe.ts, setup.ts, vitest.config.ts)
-  cli/
+  probe-defs/                      @terminfo/probe-defs: pure probe definitions + shared types
+  probes/                         @terminfo/probes: Vitest runner over Termless backends
+  admin/                          @terminfo/admin: dev/orchestration CLI (bun terminfo)
     src/                          unified CLI (bun terminfo) — all 4 probe mechanisms
       index.ts                    entry point: probe {termless,server,app,here}, report, status, submit, detect
       termless.ts                 headless library probes (Vitest + Termless)
@@ -68,9 +69,14 @@ docs/                           ← VitePress site (built → deployed)
   compare/[id].md                 comparison pages
 
 versions.json                   backend version catalog (which versions to probe)
-package.json                    scripts, dependencies
+package.json                    private workspace root; packages/* are Bun workspaces
 ```
 
+`packages/*/package.json` manifests are load-bearing. Cross-package imports use
+package names (`@terminfo/probe-defs`, `terminfo.dev/src/...`) rather than
+relative paths like `../../probe-defs/src`; km's root workspace also includes
+`vendor/terminfo.dev/packages/*` so local repo commands resolve the same graph.
+
 ## Data Architecture
 
 Three data layers with clean separation:

bun.lock

@@ -1,7 +1,10 @@
 {
-  "name": "terminfo.dev",
+  "name": "terminfo.dev-root",
   "private": true,
   "license": "CC-BY-4.0",
+  "workspaces": [
+    "packages/*"
+  ],
   "type": "module",
   "scripts": {
     "terminfo": "bun packages/terminfo.dev/src/index.tsx",
@@ -30,15 +33,19 @@
     "fix": "oxfmt --write ."
   },
   "dependencies": {
-    "@silvery/ansi": "^0.3.0",
-    "@silvery/commander": "^0.6.0",
+    "@silvery/ansi": "^0.19.0",
+    "@silvery/commander": "^0.19.0",
     "@termless/core": "^0.4.0",
     "commander": "^13.1.0",
     "loggily": "^0.4.0",
-    "silvery": "^0.4.1"
+    "silvery": "^0.19.0"
   },
   "devDependencies": {
+    "@terminfo/admin": "workspace:*",
+    "@terminfo/probe-defs": "workspace:*",
+    "@terminfo/probes": "workspace:*",
     "oxfmt": "^0.38.0",
+    "terminfo.dev": "workspace:*",
     "vitepress": "^1.6.4",
     "vitepress-enrich": "^0.4.0",
     "vitest": "^4.1.1"

package.json

@@ -13,8 +13,9 @@
 
 import { readFileSync, writeFileSync } from "node:fs"
 import { createHash } from "node:crypto"
-import { ALL_PROBES } from "../terminfo.dev/src/probes/unified.ts"
-import { withRawMode, drainStdin } from "../terminfo.dev/src/tty.ts"
+import { fileURLToPath } from "node:url"
+import { ALL_PROBES } from "terminfo.dev/src/probes/unified.ts"
+import { withRawMode, drainStdin } from "terminfo.dev/src/tty.ts"
 
 // ── Main ──
 
@@ -26,7 +27,7 @@ async function main(): Promise<void> {
   }
 
   // Compute probe hash from the shared probe definitions
-  const probesPath = new URL("../terminfo.dev/src/probes/unified.ts", import.meta.url).pathname
+  const probesPath = fileURLToPath(import.meta.resolve("terminfo.dev/src/probes/unified.ts"))
   const probesContent = readFileSync(probesPath)
   const probeHash = createHash("md5").update(probesContent).digest("hex").slice(0, 12)
 

packages/admin/app-harness.ts

@@ -0,0 +1,14 @@
+{
+  "name": "@terminfo/admin",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "dependencies": {
+    "@silvery/commander": "^0.19.0",
+    "@termless/core": "^0.4.0",
+    "loggily": "^0.4.0",
+    "react": "^19.1.1",
+    "silvery": "^0.19.0",
+    "terminfo.dev": "workspace:*"
+  }
+}

packages/admin/package.json

@@ -3,7 +3,7 @@
  */
 
 export async function handleDetect(opts: { json?: boolean }): Promise<void> {
-  const { detectTerminal } = await import("../../terminfo.dev/src/detect.ts")
+  const { detectTerminal } = await import("terminfo.dev/src/detect.ts")
   const terminal = detectTerminal()
 
   if (opts.json) {

packages/admin/src/detect.ts

@@ -36,9 +36,9 @@ function link(url: string, text: string): string {
 
 export async function handleHere(opts: { json?: boolean }): Promise<void> {
   // Dynamic imports — these modules need real TTY access
-  const { detectTerminal } = await import("../../terminfo.dev/src/detect.ts")
-  const { ALL_PROBES } = await import("../../terminfo.dev/src/probes/unified.ts")
-  const { withRawMode, drainStdin } = await import("../../terminfo.dev/src/tty.ts")
+  const { detectTerminal } = await import("terminfo.dev/src/detect.ts")
+  const { ALL_PROBES } = await import("terminfo.dev/src/probes/unified.ts")
+  const { withRawMode, drainStdin } = await import("terminfo.dev/src/tty.ts")
 
   const terminal = detectTerminal()
   const results: Record<string, boolean> = {}

packages/admin/src/here.ts

@@ -20,13 +20,13 @@ export async function handleServer(
 ): Promise<void> {
   if (opts.start) {
     // Start daemon in this terminal
-    const { startDaemon } = await import("../../terminfo.dev/src/serve.ts")
+    const { startDaemon } = await import("terminfo.dev/src/serve.ts")
     await startDaemon(opts.port ?? 0)
     return
   }
 
   // Import daemon listing
-  const { listDaemons } = await import("../../terminfo.dev/src/serve.ts")
+  const { listDaemons } = await import("terminfo.dev/src/serve.ts")
   const daemons = listDaemons()
 
   if (!opts.all && !daemon) {

packages/admin/src/server.ts

@@ -133,7 +133,7 @@ export async function handleStatus(): Promise<void> {
 
   // List running daemons
   try {
-    const { listDaemons } = await import("../../terminfo.dev/src/serve.ts")
+    const { listDaemons } = await import("terminfo.dev/src/serve.ts")
     const daemons = listDaemons()
     if (daemons.length > 0) {
       console.log("\n  Running daemons:")

packages/admin/src/status.ts

@@ -5,10 +5,10 @@
  */
 
 export async function handleSubmit(opts: { terminalName?: string; terminalVersion?: string }): Promise<void> {
-  const { detectTerminal } = await import("../../terminfo.dev/src/detect.ts")
-  const { ALL_PROBES } = await import("../../terminfo.dev/src/probes/unified.ts")
-  const { withRawMode, drainStdin } = await import("../../terminfo.dev/src/tty.ts")
-  const { submitResults } = await import("../../terminfo.dev/src/submit.ts")
+  const { detectTerminal } = await import("terminfo.dev/src/detect.ts")
+  const { ALL_PROBES } = await import("terminfo.dev/src/probes/unified.ts")
+  const { withRawMode, drainStdin } = await import("terminfo.dev/src/tty.ts")
+  const { submitResults } = await import("terminfo.dev/src/submit.ts")
 
   // Confirm details BEFORE probes (stdin is still clean)
   const terminal = detectTerminal()