dev-cockpit 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -2,6 +2,64 @@
 
 All notable changes to `dev-cockpit` are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.2] — 2026-05-12
+
+External `cockpit.yaml` — the config can now live anywhere, with a per-machine registry mapping workspaces to their YAML file.
+
+### Added
+
+- **`cockpit.yaml` discovery chain.** Resolves in this order: `--config <path>` CLI flag → `DEV_COCKPIT_CONFIG` env var → `<cwd>/cockpit.yaml` → `$XDG_DATA_HOME/dev-cockpit/manifest.json` lookup keyed by canonical `cwd` → friendly error pointing at `dev-cockpit link`. Lets the config live outside the workspace without losing the "just run from the workspace root" UX.
+- **`dev-cockpit link` subcommand tree.** `link <config-path>` registers the current directory in the manifest; `link list` prints all mappings sorted by workspace; `link remove` unregisters the current directory. Atomic write (`.tmp` + rename), symlink-canonical keys (so `~/work` and `/Volumes/.../work` hash to the same entry).
+- **`init-config -o, --output <path>`.** Write the starter config anywhere, not just `<cwd>/cockpit.yaml`. Honours the existing `cwd` parameter as the anchor when `--output` is relative.
+- **`DEV_COCKPIT_CONFIG` env var** picked up by all commands as the second-precedence fallback.
+- **`src/core/manifest.ts`** — read / lookup / atomic write of the project→config map. Defensive: returns `null` for missing / malformed / wrong-version files (treated as "not registered yet" rather than an error).
+- **`src/core/config-discovery.ts`** — pure resolver returning `{ configPath, workspaceRoot, source }`. Profile `discoverer` hook still overrides `workspaceRoot` (e.g. awc-cockpit walks up to find the wrapper); generic users get `canonical(cwd)`.
+
+### Changed
+
+- **`dev` / `doctor` / `mount` (+ `status`, `clear`) now derive workspace from `canonical(cwd)`**, not `path.dirname(configPath)`. So `--config /tmp/x.yaml` from inside a wrapper keeps the workspace as the wrapper — the whole point of external configs.
+- **`-c, --config` no longer defaults to `'cockpit.yaml'`** at the Commander level. Default is `undefined` so the discovery chain sees the "no explicit flag" signal and walks the precedence list. Help text describes the fallback chain.
+
+### Fixed
+
+- **CI publish workflow.** `npm install -g npm@latest` on Node 22's bundled npm could leave global state where `Cannot find module 'promise-retry'` fires from the half-installed npm. Switched the publish workflow to Node 24, which ships npm 11.x natively (satisfies the npm Trusted Publishing >= 11.5.1 requirement without a self-upgrade).
+
+## [0.2.1] — 2026-05-11
+
+Post-1.0 roadmap landing: action registry, processes (renamed from watchers), repos pane redesign, profile wizardSteps, accessibility (severity glyph + NO_COLOR), narrow-terminal responsiveness, lift-mount + bundled dist, plus a wave of fit-and-finish.
+
+### Added
+
+- **Action registry** with `:` command palette. `ActionConfig` has `id`, `label`, `scope` (`global` | `repos` | `repos:<id>`), `key` (single char), and a programmatic `invoke` callback. Replaces the legacy Repos `r/w/l` hardcoding — the Footer derives its legend from the registry, so profile-defined actions show up automatically.
+- **`Profile.wizardSteps` extension point.** Profiles inject custom steps into `init-config -i` (e.g. awc-cockpit asks for `gitlab.host` + `gitlab.topic` during the wizard).
+- **`defaultPane` config field** (`repos | output | health | help`). Profile-overridable.
+- **Processes (renamed from watchers).** `config.processes[]` is the new spelling; old `config.watchers[]` is auto-migrated via the new schema migration tooling on load. `CONFIG_VERSION` bumped 1 → 2.
+- **`dev-cockpit migrate-config`** persists the in-memory v1 → v2 migration to disk.
+- **Repos pane redesign.** Split layout: row list on the left, per-row action panel on the right. Process-kind rows with built-in `r → restart` actions wired through the action registry. Grouped list (Repos / Docker / Processes subheadings) for navigability.
+- **`dev-cockpit doctor --paths`** prints state-dir paths in `KEY=PATH` form (eval-friendly).
+- **`subprocess` tag lookup.** `spawnStream({ tag })` registers the handle in a `BY_TAG` map; `findSpawnedByTag(tag)` / `killSpawnedByTag(tag)` look it up. Used by per-process restart actions.
+- **`spawnStream` stdin option.** Opt-in `stdin?: 'pipe' | 'ignore' | 'inherit'` on `SpawnOptions` — pass `'ignore'` for non-interactive subprocesses so any `read`/prompt in the child gets EOF instead of blocking forever on an unwritten pipe.
+- **Severity glyph** at the start of every Output line — accessibility for users who run with `NO_COLOR=1`.
+- **`NO_COLOR` full-strip** — every ANSI escape is filtered when the env var is set.
+- **Narrow-terminal responsiveness.** `useTerminalWidth` hook; TabBar / Help / Repos collapse cleanly under ~200 cols (legend says `j/k` instead of arrows when collapsed).
+- **Wizard auto-seeds `actions[]`** from `package.json` scripts during `init-config -i`.
+- **Smart defaults** for health-check `id` + `label` in the wizard (derived from check type + target).
+- **Container-running health predicate uses `docker ps --filter name=<value> --format {{.State}}`** — compose-aware naming, so `name: laravel.test` matches `crossroads-laravel.test-1`.
+- **Engine guard.** Friendly error message when Node < 20.12.
+
+### Changed
+
+- **`Repos` pane label → `Targets`** (display only; internal enum stays `repos`).
+- **Mount machinery lifted into dev-cockpit core.** `mountCandidatesProvider` + `mountSymlinks` + `onMountApply` / `onMountClear` hooks on `Profile`; awc-cockpit kept its own `mount` command for its richer interactive UX (composer-aware clear semantics).
+- **Bundled dist.** esbuild produces a single self-contained `dist/index.js` + helpers; consumer installs no longer need to resolve dev-cockpit's full source tree.
+- **OIDC trusted publishing** on the publish workflow. No more `NODE_AUTH_TOKEN` — npm verifies the GitHub OIDC token issued by the workflow's `id-token: write` permission.
+
+### Fixed
+
+- **`killSpawnedByTag` race.** Promise.race against the exitCode + a SIGKILL guard could return before the `BY_TAG` finalizer ran on slower CI runners. Now awaits `exitCode` unconditionally after the race so the finalizer completes before return.
+- **Repos pane title duplication** — dropped the redundant pane title; TabBar already labels the tab.
+- **Wizard Repos step copy** — reflects the post-redesign reality (action panel + grouped list).
+
 ## [0.1.0] — 2026-05-10
 
 First pre-1.0 release. The public surface (`Profile` interface with `boot` lifecycle hook, `buildCli`, the four core commands `dev / doctor / init-config / mount`, the `cockpit.yaml` schema with `version: 1`) is stable enough for first consumers to depend on. Expect minor churn until the post-1.0 roadmap items land.

package/README.md

@@ -93,6 +93,28 @@ notifications:
 
 Wrappers upgrading from v1 (pre-rename) configs run `dev-cockpit migrate-config` to persist the v1 → v2 migration (auto-applied in memory on load with a stderr warning).
 
+## Config discovery
+
+dev-cockpit resolves cockpit.yaml in this order:
+
+1. `--config <path>` CLI flag
+2. `DEV_COCKPIT_CONFIG` env var
+3. `<cwd>/cockpit.yaml`
+4. `$XDG_DATA_HOME/dev-cockpit/manifest.json` lookup keyed by canonical `cwd`
+
+All paths inside cockpit.yaml resolve against the **workspace** (your cwd, or whatever a profile's `discoverer`
+returns) — never against the config file's directory. Lets one config serve multiple wrappers without rewriting
+paths.
+
+To use a config that lives outside your project:
+
+	cd ~/code/my-wrapper
+	dev-cockpit link ~/configs/my-wrapper.cockpit.yaml
+	dev-cockpit dev            # picks up the mapping
+
+	dev-cockpit link list      # show all mappings
+	dev-cockpit link remove    # unregister the current cwd
+
 ## Profiles
 
 A profile is a domain-specific bundle that plugs into dev-cockpit's lifecycle. It contributes any combination of:

package/dist/buildCli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildCli.d.ts","sourceRoot":"","sources":["../src/buildCli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAW/C,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAkBD,wBAAgB,QAAQ,CAAC,IAAI,GAAE,eAAoB,GAAG,OAAO,CAgH5D"}
+{"version":3,"file":"buildCli.d.ts","sourceRoot":"","sources":["../src/buildCli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAW/C,MAAM,WAAW,eAAe;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAkBD,wBAAgB,QAAQ,CAAC,IAAI,GAAE,eAAoB,GAAG,OAAO,CA6I5D"}

package/dist/chunk-C4GFJDMG.js

@@ -0,0 +1,79 @@
+import { createRequire as __createRequireDC } from 'node:module';
+const require = __createRequireDC(import.meta.url);
+
+
+// src/core/manifest.ts
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+var MANIFEST_VERSION = 1;
+function manifestPath() {
+  const xdgDataHome = process.env["XDG_DATA_HOME"] || path.join(os.homedir(), ".local", "share");
+  return path.join(xdgDataHome, "dev-cockpit", "manifest.json");
+}
+function canonical(p) {
+  const abs = path.resolve(p);
+  try {
+    return fs.realpathSync(abs);
+  } catch {
+    return abs;
+  }
+}
+function readManifest() {
+  const filePath = manifestPath();
+  if (!fs.existsSync(filePath)) return null;
+  try {
+    const raw = JSON.parse(fs.readFileSync(filePath, "utf8"));
+    if (raw.version !== MANIFEST_VERSION) return null;
+    if (!raw.projects || typeof raw.projects !== "object") return null;
+    const projects = {};
+    for (const [k, v] of Object.entries(raw.projects)) {
+      if (typeof k === "string" && typeof v === "string") projects[k] = v;
+    }
+    return { version: MANIFEST_VERSION, projects };
+  } catch {
+    return null;
+  }
+}
+function lookupConfig(workspaceRoot) {
+  const m = readManifest();
+  if (!m) return null;
+  return m.projects[canonical(workspaceRoot)] ?? null;
+}
+function writeManifest(m) {
+  const filePath = manifestPath();
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  const tmp = `${filePath}.tmp`;
+  fs.writeFileSync(tmp, `${JSON.stringify(m, null, 2)}
+`, "utf8");
+  fs.renameSync(tmp, filePath);
+}
+function setMapping(workspaceRoot, configPath) {
+  const existing = readManifest() ?? { version: MANIFEST_VERSION, projects: {} };
+  existing.projects[canonical(workspaceRoot)] = canonical(configPath);
+  writeManifest(existing);
+}
+function removeMapping(workspaceRoot) {
+  const existing = readManifest();
+  if (!existing) return false;
+  const key = canonical(workspaceRoot);
+  if (!(key in existing.projects)) return false;
+  delete existing.projects[key];
+  writeManifest(existing);
+  return true;
+}
+function listMappings() {
+  const m = readManifest();
+  if (!m) return [];
+  return Object.entries(m.projects).map(([workspace, config]) => ({ workspace, config })).sort((a, b) => a.workspace.localeCompare(b.workspace));
+}
+
+export {
+  manifestPath,
+  canonical,
+  lookupConfig,
+  setMapping,
+  removeMapping,
+  listMappings
+};
+//# sourceMappingURL=chunk-C4GFJDMG.js.map

package/dist/chunk-C4GFJDMG.js.map

@@ -0,0 +1,7 @@
+{
+  "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/commands/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EACV,OAAO,EAGR,MAAM,kBAAkB,CAAC;AAmB1B,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,UAAU,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkS5E"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EACX,OAAO,EAGP,MAAM,kBAAkB,CAAC;AAoB1B,MAAM,WAAW,iBAAiB;IACjC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,UAAU,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+S5E"}

package/dist/commands/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAKhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAQD,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG;IACvE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;CACjB,CAoBA;AAED,wBAAsB,aAAa,CAAC,IAAI,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BlF"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAKhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,MAAM,WAAW,oBAAoB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAQD,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG;IACxE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;CAChB,CAoBA;AAED,wBAAsB,aAAa,CAAC,IAAI,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2ClF"}

package/dist/commands/init-config.d.ts

@@ -20,6 +20,8 @@ export interface InitConfigOptions {
     interactive?: boolean;
     /** Active profile (passed by buildCli) — forwarded to the post-wizard doctor pass. */
     profile?: Profile;
+    /** Override default output path (`<cwd>/cockpit.yaml`). */
+    output?: string;
 }
 export declare function buildTemplate(opts: {
     withDocker: boolean;

package/dist/commands/init-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-config.d.ts","sourceRoot":"","sources":["../../src/commands/init-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAIhD,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mDAAmD;IACnD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAoEpF;AAED,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,iBAAiB,CACrC,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA6DlC"}
+{"version":3,"file":"init-config.d.ts","sourceRoot":"","sources":["../../src/commands/init-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAIhD,MAAM,WAAW,iBAAiB;IACjC,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mDAAmD;IACnD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAoEpF;AAED,MAAM,WAAW,gBAAgB;IAChC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,iBAAiB,CACtC,IAAI,GAAE,iBAAsB,GAC1B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA+DlC"}

package/dist/commands/link.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `dev-cockpit link` — manage the project→config mapping in
+ * $XDG_DATA_HOME/dev-cockpit/manifest.json.
+ *
+ * Sub-commands:
+ *   link <config-path>     register a mapping for the current cwd
+ *   link list              show all registered mappings
+ *   link remove            unregister the current cwd
+ *
+ * Path canonicalisation (symlink-resolved) happens inside the manifest
+ * module — the same cwd reached via a symlinked alias hashes to the
+ * same key as its real path.
+ */
+export interface LinkAddOptions {
+    configPath: string;
+}
+export declare function linkAddCommand(opts: LinkAddOptions): void;
+export declare function linkListCommand(): void;
+export declare function linkRemoveCommand(): void;
+//# sourceMappingURL=link.d.ts.map

package/dist/commands/link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/commands/link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAYH,MAAM,WAAW,cAAc;IAC9B,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAazD;AAED,wBAAgB,eAAe,IAAI,IAAI,CAYtC;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAUxC"}

package/dist/commands/mount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../src/commands/mount.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAsBvD,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,WAAW,CACzB,YAAY,EAAE,SAAS,KAAK,EAAE,EAC9B,cAAc,EAAE,SAAS,KAAK,EAAE,GAC/B,KAAK,EAAE,CAKT;AAsFD,wBAAsB,YAAY,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqEhF;AAED,wBAAsB,kBAAkB,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkEtF;AAED,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCrF"}
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../src/commands/mount.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAuBvD,MAAM,WAAW,mBAAmB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,WAAW,CAC1B,YAAY,EAAE,SAAS,KAAK,EAAE,EAC9B,cAAc,EAAE,SAAS,KAAK,EAAE,GAC9B,KAAK,EAAE,CAKT;AAsGD,wBAAsB,YAAY,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqEhF;AAED,wBAAsB,kBAAkB,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkEtF;AAED,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCrF"}

package/dist/core/config-discovery.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Resolve the cockpit.yaml path + workspace root for a command invocation.
+ *
+ * Precedence (high → low):
+ *   1. --config CLI flag (explicit)
+ *   2. DEV_COCKPIT_CONFIG env var
+ *   3. <workspace>/cockpit.yaml
+ *   4. $XDG_DATA_HOME/dev-cockpit/manifest.json[workspace]
+ *   5. throw DiscoveryError
+ *
+ * `workspace` is canonical(cwd) unless a profile supplies its own
+ * discoverer (awc-cockpit's walks up looking for bedrock/ +
+ * docker/compose/). Paths inside the YAML are always workspace-relative,
+ * regardless of where the YAML file itself lives.
+ */
+export type DiscoverySource = 'cli' | 'env' | 'workspace' | 'manifest';
+export interface DiscoveryResult {
+    configPath: string;
+    workspaceRoot: string;
+    source: DiscoverySource;
+}
+export interface DiscoverConfigOptions {
+    /** Working directory; defaults to process.cwd(). */
+    cwd?: string;
+    /** Value of the --config CLI flag, if passed. */
+    cliConfig?: string | undefined;
+    /** Optional profile.discoverer hook that yields { root } when it matches. */
+    workspaceDiscoverer?: (() => {
+        root: string;
+    } | null | undefined) | undefined;
+    /** Override of DEV_COCKPIT_CONFIG; injectable for tests. */
+    envConfig?: string | undefined;
+}
+export declare class DiscoveryError extends Error {
+    readonly workspaceRoot: string;
+    constructor(workspaceRoot: string);
+}
+export declare function discoverConfig(opts?: DiscoverConfigOptions): DiscoveryResult;
+//# sourceMappingURL=config-discovery.d.ts.map

package/dist/core/config-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-discovery.d.ts","sourceRoot":"","sources":["../../src/core/config-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,KAAK,GAAG,WAAW,GAAG,UAAU,CAAC;AAEvE,MAAM,WAAW,eAAe;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACrC,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,6EAA6E;IAC7E,mBAAmB,CAAC,EAAE,CAAC,MAAM;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAC9E,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,qBAAa,cAAe,SAAQ,KAAK;aACZ,aAAa,EAAE,MAAM;gBAArB,aAAa,EAAE,MAAM;CASjD;AAED,wBAAgB,cAAc,CAAC,IAAI,GAAE,qBAA0B,GAAG,eAAe,CAuChF"}

package/dist/core/manifest.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Read/write the global project→config manifest at
+ * `$XDG_DATA_HOME/dev-cockpit/manifest.json`. Keys are canonical
+ * absolute paths to a workspace root; values are absolute paths to
+ * the cockpit.yaml that workspace should use.
+ *
+ * Used by core/config-discovery.ts as the last-resort lookup when
+ * the workspace doesn't carry its own cockpit.yaml at the root.
+ */
+declare const MANIFEST_VERSION: 1;
+export interface Manifest {
+    version: typeof MANIFEST_VERSION;
+    projects: Record<string, string>;
+}
+/** Absolute path of `$XDG_DATA_HOME/dev-cockpit/manifest.json`. */
+export declare function manifestPath(): string;
+/**
+ * Canonicalise an absolute path — resolves symlinks if the path exists,
+ * falls back to `path.resolve()` otherwise. Ensures a symlinked workspace
+ * dir (`~/work`) and its real target (`/Users/me/code/work`) hash to the
+ * same manifest key.
+ */
+export declare function canonical(p: string): string;
+/**
+ * Read the manifest. Returns `null` when the file is missing, unreadable,
+ * malformed JSON, or doesn't match the expected shape. Callers treat null
+ * as "no mapping registered" rather than an error — the user simply
+ * hasn't run `dev-cockpit link` yet.
+ */
+export declare function readManifest(): Manifest | null;
+/** Look up a workspace's config path. Returns `null` when unmapped. */
+export declare function lookupConfig(workspaceRoot: string): string | null;
+/**
+ * Register a mapping. Both inputs are canonicalised first — the
+ * workspace key is resolved through symlinks so a `~/work` symlink and
+ * `/Users/me/code/work` real path resolve to the same entry.
+ */
+export declare function setMapping(workspaceRoot: string, configPath: string): void;
+/** Remove a mapping. Returns `true` when an entry was deleted. */
+export declare function removeMapping(workspaceRoot: string): boolean;
+/** Sorted mapping list, for `dev-cockpit link list`. */
+export declare function listMappings(): Array<{
+    workspace: string;
+    config: string;
+}>;
+export {};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/core/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/core/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,QAAA,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAEpC,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,OAAO,gBAAgB,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,mEAAmE;AACnE,wBAAgB,YAAY,IAAI,MAAM,CAKrC;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAO3C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,QAAQ,GAAG,IAAI,CAe9C;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIjE;AAeD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAI1E;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAQ5D;AAED,wDAAwD;AACxD,wBAAgB,YAAY,IAAI,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAM3E"}