dev-cockpit 0.2.7 → 0.2.8

package/package.json

@@ -1,94 +1,100 @@
 {
-	"name": "dev-cockpit",
-	"version": "0.2.7",
-	"description": "A reusable, domain-neutral terminal UI dev cockpit — tabbed pane shell, watcher streaming, optional Docker log tail with highlights, health framework with one-keystroke remediations, transition-only OS notifications, live-markdown Help. Profiles extend it with project-specific commands, repos, and health checks.",
-	"license": "MIT",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/frankfava/package--dev-cockpit.git"
-	},
-	"homepage": "https://github.com/frankfava/package--dev-cockpit#readme",
-	"bugs": {
-		"url": "https://github.com/frankfava/package--dev-cockpit/issues"
-	},
-	"keywords": [
-		"tui",
-		"terminal",
-		"dashboard",
-		"cockpit",
-		"watcher",
-		"docker",
-		"dev",
-		"dx"
-	],
-	"type": "module",
-	"engines": {
-		"node": ">=20.12.0"
-	},
-	"main": "./dist/index.js",
-	"types": "./dist/index.d.ts",
-	"exports": {
-		".": {
-			"types": "./dist/index.d.ts",
-			"import": "./dist/index.js"
-		},
-		"./ink": {
-			"types": "./dist/ink.d.ts",
-			"import": "./dist/ink.js"
-		},
-		"./react": {
-			"types": "./dist/react.d.ts",
-			"import": "./dist/react.js"
-		}
-	},
-	"bin": {
-		"dev-cockpit": "bin/dev-cockpit.mjs"
-	},
-	"files": [
-		"dist/",
-		"bin/",
-		"docs/",
-		"examples/",
-		"README.md",
-		"CHANGELOG.md",
-		"LICENSE"
-	],
-	"scripts": {
-		"build": "rm -rf dist && node esbuild.config.mjs && tsc -p tsconfig.build.json --emitDeclarationOnly --declaration",
-		"typecheck": "tsc --noEmit",
-		"lint": "eslint 'src/**/*.{ts,tsx}' 'tests/**/*.{ts,tsx}'",
-		"test": "vitest run"
-	},
-	"peerDependencies": {
-		"@inquirer/prompts": "^8.4.2",
-		"node-notifier": "^10.0.1"
-	},
-	"devDependencies": {
-		"@inquirer/prompts": "^8.4.2",
-		"@types/node": "^22.5.0",
-		"@types/node-notifier": "^8.0.5",
-		"@types/react": "^19.2.14",
-		"@typescript-eslint/eslint-plugin": "^8.3.0",
-		"@typescript-eslint/parser": "^8.3.0",
-		"chalk": "^5.3.0",
-		"chokidar": "^5.0.0",
-		"commander": "^12.1.0",
-		"esbuild": "^0.23.1",
-		"eslint": "^9.9.1",
-		"eslint-config-prettier": "^9.1.0",
-		"execa": "^9.3.0",
-		"ink": "^7.0.2",
-		"ink-testing-library": "^4.0.0",
-		"marked": "^15.0.12",
-		"marked-terminal": "^7.3.0",
-		"node-notifier": "^10.0.1",
-		"pino": "^9.3.2",
-		"prettier": "^3.3.3",
-		"react": "^19.2.6",
-		"typescript": "^5.5.4",
-		"vitest": "^2.0.5",
-		"yaml": "^2.5.0",
-		"zod": "^3.23.8",
-		"zustand": "^5.0.13"
-	}
-}
+  "name": "dev-cockpit",
+  "version": "0.2.8",
+  "description": "A reusable, domain-neutral terminal UI dev cockpit — tabbed pane shell, watcher streaming, optional Docker log tail with highlights, health framework with one-keystroke remediations, transition-only OS notifications, live-markdown Help. Profiles extend it with project-specific commands, repos, and health checks.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/frankfava/package--dev-cockpit.git"
+  },
+  "homepage": "https://github.com/frankfava/package--dev-cockpit#readme",
+  "bugs": {
+    "url": "https://github.com/frankfava/package--dev-cockpit/issues"
+  },
+  "keywords": [
+    "tui",
+    "terminal",
+    "dashboard",
+    "cockpit",
+    "watcher",
+    "docker",
+    "dev",
+    "dx"
+  ],
+  "type": "module",
+  "engines": {
+    "node": ">=20.12.0"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./ink": {
+      "types": "./dist/ink.d.ts",
+      "import": "./dist/ink.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js"
+    },
+    "./prettier-config": "./prettier-config.json"
+  },
+  "prettier": "./prettier-config.json",
+  "bin": {
+    "dev-cockpit": "bin/dev-cockpit.mjs"
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "docs/",
+    "examples/",
+    "prettier-config.json",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && node esbuild.config.mjs && tsc -p tsconfig.build.json --emitDeclarationOnly --declaration",
+    "dev": "node esbuild.config.mjs --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint 'src/**/*.{ts,tsx}' 'tests/**/*.{ts,tsx}'",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "vitest run"
+  },
+  "peerDependencies": {
+    "@inquirer/prompts": "^8.4.2",
+    "node-notifier": "^10.0.1"
+  },
+  "devDependencies": {
+    "@inquirer/prompts": "^8.4.2",
+    "@types/node": "^22.5.0",
+    "@types/node-notifier": "^8.0.5",
+    "@types/react": "^19.2.14",
+    "@typescript-eslint/eslint-plugin": "^8.3.0",
+    "@typescript-eslint/parser": "^8.3.0",
+    "chalk": "^5.3.0",
+    "chokidar": "^5.0.0",
+    "commander": "^12.1.0",
+    "esbuild": "^0.23.1",
+    "eslint": "^9.9.1",
+    "eslint-config-prettier": "^9.1.0",
+    "execa": "^9.3.0",
+    "ink": "^7.0.2",
+    "ink-testing-library": "^4.0.0",
+    "marked": "^15.0.12",
+    "marked-terminal": "^7.3.0",
+    "node-notifier": "^10.0.1",
+    "pino": "^9.3.2",
+    "prettier": "^3.3.3",
+    "react": "^19.2.6",
+    "typescript": "^5.5.4",
+    "vitest": "^2.0.5",
+    "yaml": "^2.5.0",
+    "zod": "^3.23.8",
+    "zustand": "^5.0.13"
+  }
+}

package/prettier-config.json

@@ -0,0 +1,7 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 100,
+  "tabWidth": 2
+}

package/dist/chunk-A446TCT5.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/core/manifest.ts"],
-  "sourcesContent": ["/**\n * Read/write the global project\u2192config manifest at\n * `$XDG_DATA_HOME/dev-cockpit/manifest.json`. Keys are canonical\n * absolute paths to a workspace root; values are absolute paths to\n * the cockpit.yaml that workspace should use.\n *\n * Used by core/config-discovery.ts as the last-resort lookup when\n * the workspace doesn't carry its own cockpit.yaml at the root.\n */\n\nimport fs from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\n\nconst MANIFEST_VERSION = 1 as const;\n\nexport interface Manifest {\n  version: typeof MANIFEST_VERSION;\n  projects: Record<string, string>;\n}\n\n/** Absolute path of `$XDG_DATA_HOME/dev-cockpit/manifest.json`. */\nexport function manifestPath(): string {\n  // `||` (not `??`) so an empty-string env var falls through to the default.\n  const xdgDataHome =\n    process.env['XDG_DATA_HOME'] || path.join(os.homedir(), '.local', 'share');\n  return path.join(xdgDataHome, 'dev-cockpit', 'manifest.json');\n}\n\n/**\n * Canonicalise an absolute path \u2014 resolves symlinks if the path exists,\n * falls back to `path.resolve()` otherwise. Ensures a symlinked workspace\n * dir (`~/work`) and its real target (`/Users/me/code/work`) hash to the\n * same manifest key.\n */\nexport function canonical(p: string): string {\n  const abs = path.resolve(p);\n  try {\n    return fs.realpathSync(abs);\n  } catch {\n    return abs;\n  }\n}\n\n/**\n * Read the manifest. Returns `null` when the file is missing, unreadable,\n * malformed JSON, or doesn't match the expected shape. Callers treat null\n * as \"no mapping registered\" rather than an error \u2014 the user simply\n * hasn't run `dev-cockpit link` yet.\n */\nexport function readManifest(): Manifest | null {\n  const filePath = manifestPath();\n  if (!fs.existsSync(filePath)) return null;\n  try {\n    const raw = JSON.parse(fs.readFileSync(filePath, 'utf8')) as Partial<Manifest>;\n    if (raw.version !== MANIFEST_VERSION) return null;\n    if (!raw.projects || typeof raw.projects !== 'object') return null;\n    const projects: Record<string, string> = {};\n    for (const [k, v] of Object.entries(raw.projects)) {\n      if (typeof k === 'string' && typeof v === 'string') projects[k] = v;\n    }\n    return { version: MANIFEST_VERSION, projects };\n  } catch {\n    return null;\n  }\n}\n\n/** Look up a workspace's config path. Returns `null` when unmapped. */\nexport function lookupConfig(workspaceRoot: string): string | null {\n  const m = readManifest();\n  if (!m) return null;\n  return m.projects[canonical(workspaceRoot)] ?? null;\n}\n\n/**\n * Atomic write: serialise to `<file>.tmp` next to the manifest, then\n * rename onto the real path. Creates the parent dir if missing. Same\n * pattern used by dev-cockpit's mount-manifest writer.\n */\nfunction writeManifest(m: Manifest): void {\n  const filePath = manifestPath();\n  fs.mkdirSync(path.dirname(filePath), { recursive: true });\n  const tmp = `${filePath}.tmp`;\n  fs.writeFileSync(tmp, `${JSON.stringify(m, null, 2)}\\n`, 'utf8');\n  fs.renameSync(tmp, filePath);\n}\n\n/**\n * Register a mapping. Both inputs are canonicalised first \u2014 the\n * workspace key is resolved through symlinks so a `~/work` symlink and\n * `/Users/me/code/work` real path resolve to the same entry.\n */\nexport function setMapping(workspaceRoot: string, configPath: string): void {\n  const existing = readManifest() ?? { version: MANIFEST_VERSION, projects: {} };\n  existing.projects[canonical(workspaceRoot)] = canonical(configPath);\n  writeManifest(existing);\n}\n\n/** Remove a mapping. Returns `true` when an entry was deleted. */\nexport function removeMapping(workspaceRoot: string): boolean {\n  const existing = readManifest();\n  if (!existing) return false;\n  const key = canonical(workspaceRoot);\n  if (!(key in existing.projects)) return false;\n  delete existing.projects[key];\n  writeManifest(existing);\n  return true;\n}\n\n/** Sorted mapping list, for `dev-cockpit link list`. */\nexport function listMappings(): Array<{ workspace: string; config: string }> {\n  const m = readManifest();\n  if (!m) return [];\n  return Object.entries(m.projects)\n    .map(([workspace, config]) => ({ workspace, config }))\n    .sort((a, b) => a.workspace.localeCompare(b.workspace));\n}\n"],
-  "mappings": ";;;;;AAUA,OAAO,QAAQ;AACf,OAAO,QAAQ;AACf,OAAO,UAAU;AAEjB,IAAM,mBAAmB;AAQlB,SAAS,eAAuB;AAErC,QAAM,cACJ,QAAQ,IAAI,eAAe,KAAK,KAAK,KAAK,GAAG,QAAQ,GAAG,UAAU,OAAO;AAC3E,SAAO,KAAK,KAAK,aAAa,eAAe,eAAe;AAC9D;AAQO,SAAS,UAAU,GAAmB;AAC3C,QAAM,MAAM,KAAK,QAAQ,CAAC;AAC1B,MAAI;AACF,WAAO,GAAG,aAAa,GAAG;AAAA,EAC5B,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAQO,SAAS,eAAgC;AAC9C,QAAM,WAAW,aAAa;AAC9B,MAAI,CAAC,GAAG,WAAW,QAAQ,EAAG,QAAO;AACrC,MAAI;AACF,UAAM,MAAM,KAAK,MAAM,GAAG,aAAa,UAAU,MAAM,CAAC;AACxD,QAAI,IAAI,YAAY,iBAAkB,QAAO;AAC7C,QAAI,CAAC,IAAI,YAAY,OAAO,IAAI,aAAa,SAAU,QAAO;AAC9D,UAAM,WAAmC,CAAC;AAC1C,eAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,IAAI,QAAQ,GAAG;AACjD,UAAI,OAAO,MAAM,YAAY,OAAO,MAAM,SAAU,UAAS,CAAC,IAAI;AAAA,IACpE;AACA,WAAO,EAAE,SAAS,kBAAkB,SAAS;AAAA,EAC/C,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGO,SAAS,aAAa,eAAsC;AACjE,QAAM,IAAI,aAAa;AACvB,MAAI,CAAC,EAAG,QAAO;AACf,SAAO,EAAE,SAAS,UAAU,aAAa,CAAC,KAAK;AACjD;AAOA,SAAS,cAAc,GAAmB;AACxC,QAAM,WAAW,aAAa;AAC9B,KAAG,UAAU,KAAK,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;AACxD,QAAM,MAAM,GAAG,QAAQ;AACvB,KAAG,cAAc,KAAK,GAAG,KAAK,UAAU,GAAG,MAAM,CAAC,CAAC;AAAA,GAAM,MAAM;AAC/D,KAAG,WAAW,KAAK,QAAQ;AAC7B;AAOO,SAAS,WAAW,eAAuB,YAA0B;AAC1E,QAAM,WAAW,aAAa,KAAK,EAAE,SAAS,kBAAkB,UAAU,CAAC,EAAE;AAC7E,WAAS,SAAS,UAAU,aAAa,CAAC,IAAI,UAAU,UAAU;AAClE,gBAAc,QAAQ;AACxB;AAGO,SAAS,cAAc,eAAgC;AAC5D,QAAM,WAAW,aAAa;AAC9B,MAAI,CAAC,SAAU,QAAO;AACtB,QAAM,MAAM,UAAU,aAAa;AACnC,MAAI,EAAE,OAAO,SAAS,UAAW,QAAO;AACxC,SAAO,SAAS,SAAS,GAAG;AAC5B,gBAAc,QAAQ;AACtB,SAAO;AACT;AAGO,SAAS,eAA6D;AAC3E,QAAM,IAAI,aAAa;AACvB,MAAI,CAAC,EAAG,QAAO,CAAC;AAChB,SAAO,OAAO,QAAQ,EAAE,QAAQ,EAC7B,IAAI,CAAC,CAAC,WAAW,MAAM,OAAO,EAAE,WAAW,OAAO,EAAE,EACpD,KAAK,CAAC,GAAG,MAAM,EAAE,UAAU,cAAc,EAAE,SAAS,CAAC;AAC1D;",
-  "names": []
-}

package/dist/link-VWT2VQH6.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/commands/link.ts"],
-  "sourcesContent": ["/**\n * `dev-cockpit link` \u2014 manage the project\u2192config mapping in\n * $XDG_DATA_HOME/dev-cockpit/manifest.json.\n *\n * Sub-commands:\n *   link <config-path>     register a mapping for the current cwd\n *   link list              show all registered mappings\n *   link remove            unregister the current cwd\n *\n * Path canonicalisation (symlink-resolved) happens inside the manifest\n * module \u2014 the same cwd reached via a symlinked alias hashes to the\n * same key as its real path.\n */\n\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport {\n\tcanonical,\n\tlistMappings,\n\tmanifestPath,\n\tremoveMapping,\n\tsetMapping,\n} from '../core/manifest.js';\n\nexport interface LinkAddOptions {\n\tconfigPath: string;\n}\n\nexport function linkAddCommand(opts: LinkAddOptions): void {\n\tconst cwd = process.cwd();\n\tconst absConfig = path.resolve(cwd, opts.configPath);\n\tif (!fs.existsSync(absConfig)) {\n\t\tprocess.stderr.write(\n\t\t\t`dev-cockpit link: ${absConfig} doesn't exist. Create the config file first or pass a valid path.\\n`,\n\t\t);\n\t\tprocess.exit(1);\n\t}\n\tsetMapping(cwd, absConfig);\n\tprocess.stdout.write(\n\t\t`dev-cockpit link: ${canonical(cwd)} \u2192 ${canonical(absConfig)}\\n`,\n\t);\n}\n\nexport function linkListCommand(): void {\n\tconst entries = listMappings();\n\tif (entries.length === 0) {\n\t\tprocess.stdout.write(\n\t\t\t`dev-cockpit link: no mappings registered (manifest at ${manifestPath()}).\\n`,\n\t\t);\n\t\treturn;\n\t}\n\tconst longest = Math.max(...entries.map((e) => e.workspace.length));\n\tfor (const { workspace, config } of entries) {\n\t\tprocess.stdout.write(`${workspace.padEnd(longest)}  \u2192  ${config}\\n`);\n\t}\n}\n\nexport function linkRemoveCommand(): void {\n\tconst cwd = process.cwd();\n\tconst removed = removeMapping(cwd);\n\tif (removed) {\n\t\tprocess.stdout.write(`dev-cockpit link: removed mapping for ${canonical(cwd)}\\n`);\n\t} else {\n\t\tprocess.stdout.write(\n\t\t\t`dev-cockpit link: no mapping for ${canonical(cwd)} (nothing to remove)\\n`,\n\t\t);\n\t}\n}"],
-  "mappings": ";;;;;;;;;;;;;AAcA,OAAO,QAAQ;AACf,OAAO,UAAU;AAaV,SAAS,eAAe,MAA4B;AAC1D,QAAM,MAAM,QAAQ,IAAI;AACxB,QAAM,YAAY,KAAK,QAAQ,KAAK,KAAK,UAAU;AACnD,MAAI,CAAC,GAAG,WAAW,SAAS,GAAG;AAC9B,YAAQ,OAAO;AAAA,MACd,qBAAqB,SAAS;AAAA;AAAA,IAC/B;AACA,YAAQ,KAAK,CAAC;AAAA,EACf;AACA,aAAW,KAAK,SAAS;AACzB,UAAQ,OAAO;AAAA,IACd,qBAAqB,UAAU,GAAG,CAAC,WAAM,UAAU,SAAS,CAAC;AAAA;AAAA,EAC9D;AACD;AAEO,SAAS,kBAAwB;AACvC,QAAM,UAAU,aAAa;AAC7B,MAAI,QAAQ,WAAW,GAAG;AACzB,YAAQ,OAAO;AAAA,MACd,yDAAyD,aAAa,CAAC;AAAA;AAAA,IACxE;AACA;AAAA,EACD;AACA,QAAM,UAAU,KAAK,IAAI,GAAG,QAAQ,IAAI,CAAC,MAAM,EAAE,UAAU,MAAM,CAAC;AAClE,aAAW,EAAE,WAAW,OAAO,KAAK,SAAS;AAC5C,YAAQ,OAAO,MAAM,GAAG,UAAU,OAAO,OAAO,CAAC,aAAQ,MAAM;AAAA,CAAI;AAAA,EACpE;AACD;AAEO,SAAS,oBAA0B;AACzC,QAAM,MAAM,QAAQ,IAAI;AACxB,QAAM,UAAU,cAAc,GAAG;AACjC,MAAI,SAAS;AACZ,YAAQ,OAAO,MAAM,yCAAyC,UAAU,GAAG,CAAC;AAAA,CAAI;AAAA,EACjF,OAAO;AACN,YAAQ,OAAO;AAAA,MACd,oCAAoC,UAAU,GAAG,CAAC;AAAA;AAAA,IACnD;AAAA,EACD;AACD;",
-  "names": []
-}