orbitmap 0.3.0 → 0.4.1

package/dist/workspace-resolve.js

@@ -0,0 +1,284 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { loadConfig } from './config.js';
+import { OrbitMapAPIError } from './errors.js';
+import { CONFIG_FILENAME, globalConfigReadPath, ORBITMAP_DIR } from './paths.js';
+import { resolveProjectConfigField } from './project-config.js';
+/** Name of the per-project OrbitMap directory (`<project>/.orbitmap`). Defined in
+ *  `paths.ts` (which owns the project-config walk-up) and re-exported here, where most
+ *  callers already look for it. */
+export { ORBITMAP_DIR };
+/** Project-local pointer at a workspace living elsewhere on disk. */
+export const LINK_FILE = 'link.json';
+/** Marker file that identifies a directory as a local workspace. */
+export const WORKSPACE_FILE = 'workspace.yml';
+/**
+ * Value of the global `--workspace <path>` flag.
+ *
+ * Commands receive their options from Commander and cannot be changed here, so the
+ * program-level flag is captured once in `src/index.ts` (preAction hook) and read back
+ * by the resolver. `undefined` means "flag not given".
+ */
+let workspaceFlag;
+export function setWorkspaceFlag(value) {
+    workspaceFlag = value && value.length > 0 ? value : undefined;
+}
+export function getWorkspaceFlag() {
+    return workspaceFlag;
+}
+/**
+ * Walk up from `startDir` to the filesystem root looking for `.orbitmap/link.json`
+ * (same discovery behaviour as git). Returns the nearest one, or `undefined`.
+ */
+export function findLinkFile(startDir = process.cwd()) {
+    let dir = resolve(startDir);
+    for (;;) {
+        const candidate = join(dir, ORBITMAP_DIR, LINK_FILE);
+        if (existsSync(candidate)) {
+            const link = readLinkFile(candidate);
+            if (link)
+                return { file: candidate, link };
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+/**
+ * Walk up from `startDir` to the filesystem root looking for a directory whose
+ * `.orbitmap/` holds a `workspace.yml` — i.e. a local workspace living inside the
+ * project. Returns the absolute path of that `.orbitmap` directory, or `undefined`.
+ *
+ * Same walk-up as {@link findLinkFile} so that a workspace discovered from a nested
+ * subdirectory is both what makes the mode local and what the path ladder returns.
+ */
+export function findWorkspaceDir(startDir = process.cwd()) {
+    let dir = resolve(startDir);
+    for (;;) {
+        const candidate = join(dir, ORBITMAP_DIR);
+        if (existsSync(join(candidate, WORKSPACE_FILE)))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+function readLinkFile(file) {
+    try {
+        const parsed = JSON.parse(readFileSync(file, 'utf-8'));
+        if (typeof parsed !== 'object' || parsed === null)
+            return undefined;
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Mode resolution (ADR 0002, extending spec §3.3) — **per project first, global config
+ * only as a fallback**, first match wins:
+ *
+ * 1. `--workspace <path>` flag → local (explicit override, no further checks)
+ * 2. `ORBITMAP_MODE=local|cloud` → that mode, for this invocation
+ * 3. nearest `.orbitmap/config.json` **that sets `mode`** → that value **[ADR 0002]**
+ * 4. local auto-detect: nearest `.orbitmap/link.json` or `.orbitmap/workspace.yml`,
+ *    walking up from cwd to the filesystem root (as git looks for `.git`) → local
+ * 5. global config `mode` (absent or unknown ⇒ `'cloud'`)
+ *
+ * Rung 3 is resolved **per field** (`resolveProjectConfigField`), not "nearest file wins":
+ * a `packages/api/.orbitmap/config.json` that only pins an `agent` does not shadow the
+ * repository root's `mode`. See ADR 0002 §2.
+ *
+ * Rung 3 exists because the whole per-project scoping mechanism (link.json,
+ * workspace.yml-based auto-detect) was originally built only for *local* mode — a cloud
+ * project had no file of its own to declare itself cloud in, so it depended entirely on
+ * rung 5 never being flipped by another project. `.orbitmap/config.json` gives cloud
+ * projects that same voice, and it outranks rung 4 on purpose: a project that explicitly
+ * declares `mode: "cloud"` must not be dragged back into local mode by a leftover
+ * `link.json`/`workspace.yml` in the same directory.
+ *
+ * Rung 4 is what keeps *un-declared* projects independent: a directory that ran
+ * `orbitmap init` → local is local from then on via its own marker file, and a directory
+ * that never did keeps resolving through its own config — one project's choice can never
+ * flip another's.
+ */
+export function resolveMode(options = {}) {
+    if (options.workspace ?? workspaceFlag)
+        return 'local';
+    const env = (process.env['ORBITMAP_MODE'] ?? '').trim().toLowerCase();
+    if (env === 'local' || env === 'cloud')
+        return env;
+    const cwd = resolve(options.cwd ?? process.cwd());
+    const projectMode = resolveProjectConfigField('mode', cwd)?.value;
+    if (projectMode)
+        return projectMode;
+    const link = options.link !== undefined ? options.link : findLinkFile(cwd);
+    if (link)
+        return 'local';
+    if (findWorkspaceDir(cwd))
+        return 'local';
+    return options.config?.mode === 'local' ? 'local' : 'cloud';
+}
+/**
+ * Workspace directory resolution (§3.3), first match wins:
+ * 1. `--workspace <path>` flag
+ * 2. `ORBITMAP_WORKSPACE` env var
+ * 3. nearest `.orbitmap/link.json` (walking up from cwd) → its `workspace` field
+ * 4. nearest `.orbitmap/workspace.yml` (walking up from cwd) → that `.orbitmap`
+ * 5. the `.orbitmap/` directory of the nearest project config that sets `mode: "local"`,
+ *    when that directory is itself a workspace **[ADR 0002]**
+ * 6. global config `workspace_path` — **must be absolute** (a relative value is ignored
+ *    with a warning; see {@link OrbitMapConfig.workspace_path})
+ * 7. otherwise: `OrbitMapAPIError` with code `WORKSPACE_NOT_FOUND`
+ *
+ * Rung 5 is what makes a committed `{"mode": "local"}` usable on its own: without it, a
+ * project config that declares local mode has nowhere to point and every command fails with
+ * `WORKSPACE_NOT_FOUND`. It usually resolves to the same directory as rung 4 — the point is
+ * that it does not *depend* on the auto-detect walk finding the marker first, and that it
+ * anchors on the config file that made this project local rather than on the current
+ * directory.
+ *
+ * The returned path is absolute; its existence is not verified (except for rungs 4 and 5,
+ * which are defined by the marker file).
+ */
+export function resolveWorkspacePath(options = {}) {
+    const cwd = resolve(options.cwd ?? process.cwd());
+    const flag = options.workspace ?? workspaceFlag;
+    if (flag)
+        return resolve(cwd, flag);
+    const env = process.env['ORBITMAP_WORKSPACE'];
+    if (env)
+        return resolve(cwd, env);
+    const found = options.link !== undefined ? options.link : findLinkFile(cwd);
+    if (found && found.link.workspace) {
+        const linked = found.link.workspace;
+        return isAbsolute(linked) ? resolve(linked) : resolve(dirname(found.file), linked);
+    }
+    const local = findWorkspaceDir(cwd);
+    if (local)
+        return local;
+    const declaredLocal = resolveProjectConfigField('mode', cwd);
+    if (declaredLocal?.value === 'local') {
+        const configDir = dirname(declaredLocal.file);
+        if (existsSync(join(configDir, WORKSPACE_FILE)))
+            return configDir;
+    }
+    const configured = options.config?.workspace_path;
+    if (configured) {
+        if (isAbsolute(configured))
+            return resolve(configured);
+        warnRelativeWorkspacePath(configured);
+    }
+    throw OrbitMapAPIError.workspaceNotFound();
+}
+let warnedRelativeWorkspacePath = false;
+/**
+ * A relative global `workspace_path` is ignored, not resolved against `process.cwd()`.
+ *
+ * Resolving it against the current directory would make one machine-wide setting mean a
+ * different workspace in every project — the same cross-project leak ADR 0002 removes from
+ * `area`, and worse here because it silently points at a directory that does not exist
+ * rather than at someone else's data.
+ */
+function warnRelativeWorkspacePath(configured) {
+    if (warnedRelativeWorkspacePath)
+        return;
+    warnedRelativeWorkspacePath = true;
+    console.warn(`[orbitmap] Ignoring "workspace_path": "${configured}" in the global config — it must ` +
+        'be an absolute path. A relative one would mean a different directory in every ' +
+        'project. Use --workspace or ORBITMAP_WORKSPACE for a per-invocation override.');
+}
+/**
+ * Area resolution (ADR 0002, extending spec §3.3), explicit sources only:
+ * `--area` → `ORBITMAP_AREA` → `link.json.area` → nearest `.orbitmap/config.json`
+ * **that sets `area`** **[ADR 0002]** → global config `area` (deprecated).
+ *
+ * The project-config rung is per-field (`resolveProjectConfigField`): a nested config that
+ * sets only `agent` does not hide an `area` pinned by the repository root.
+ *
+ * The two remaining rungs — the workspace's own `workspace.yml` `default_area` (which
+ * sits *between* the project config and the global config) and "workspace has exactly one
+ * area → auto-select it" — require reading the workspace tree and therefore live in the
+ * local adapter (`createLocalContext`); this function stays synchronous and file-store-free
+ * so that cloud mode never touches a workspace file. The `source` lets the adapter tell an
+ * explicit request apart from the machine-wide default.
+ */
+export function resolveArea(options = {}) {
+    if (options.area)
+        return { area: options.area, source: 'flag' };
+    const env = process.env['ORBITMAP_AREA'];
+    if (env)
+        return { area: env, source: 'env' };
+    const cwd = resolve(options.cwd ?? process.cwd());
+    const found = options.link !== undefined ? options.link : findLinkFile(cwd);
+    if (found?.link.area)
+        return { area: found.link.area, source: 'link' };
+    const projectArea = resolveProjectConfigField('area', cwd)?.value;
+    if (projectArea)
+        return { area: projectArea, source: 'project-config' };
+    const configured = options.config?.area;
+    if (configured) {
+        warnDeprecatedGlobalArea();
+        return { area: configured, source: 'config' };
+    }
+    return {};
+}
+let warnedDeprecatedGlobalArea = false;
+/**
+ * Warn — once per process — that the deprecated machine-wide `area` rung was used.
+ *
+ * Deliberately raised from the rung itself rather than from `loadConfig()`: warning on
+ * every load nagged users whose global `area` is already shadowed by `ORBITMAP_AREA`, a
+ * project config or a `link.json` — i.e. people who have already done what the warning
+ * asks — and fired in local mode, where the rung is usually irrelevant.
+ */
+function warnDeprecatedGlobalArea() {
+    if (warnedDeprecatedGlobalArea)
+        return;
+    warnedDeprecatedGlobalArea = true;
+    console.warn(`[orbitmap] The "area" in ${globalConfigReadPath()} is deprecated — move it to ` +
+        `${ORBITMAP_DIR}/${CONFIG_FILENAME} in the project it belongs to. Still honoured ` +
+        'this version; see docs/adr/0002-project-scoped-config.md.');
+}
+/** {@link resolveArea} without the rung — the historical signature. */
+export function resolveAreaSlug(options = {}) {
+    return resolveArea(options).area;
+}
+/**
+ * Assert that an area was resolved. Adapters call this after their own last-resort
+ * auto-selection; `availableAreas` (when known) is surfaced in the error details.
+ */
+export function requireArea(area, availableAreas) {
+    if (area)
+        return area;
+    throw OrbitMapAPIError.areaContextRequired(undefined, availableAreas && availableAreas.length > 0
+        ? { available_areas: availableAreas }
+        : undefined);
+}
+/**
+ * Full context resolution. Loads the global config when one is not injected.
+ * In cloud mode the workspace directory is not resolved (and never throws
+ * `WORKSPACE_NOT_FOUND`).
+ */
+export async function resolveWorkspaceContext(options = {}) {
+    const config = options.config ?? (await loadConfig());
+    const cwd = resolve(options.cwd ?? process.cwd());
+    const link = options.link !== undefined ? options.link : findLinkFile(cwd);
+    const opts = { ...options, cwd, config, link };
+    const mode = resolveMode(opts);
+    const { area, source: areaSource } = resolveArea(opts);
+    if (mode !== 'local') {
+        return { mode, area, areaSource, link, config };
+    }
+    return {
+        mode,
+        workspacePath: resolveWorkspacePath(opts),
+        area,
+        areaSource,
+        link,
+        config,
+    };
+}
+//# sourceMappingURL=workspace-resolve.js.map

package/dist/workspace-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-resolve.js","sourceRoot":"","sources":["../src/workspace-resolve.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,50 +1,53 @@
-{
-  "name": "orbitmap",
-  "version": "0.3.0",
-  "description": "Project management CLI for AI coding agents — works with Gemini CLI, GPT Codex, Claude Code, and any agent with shell access.",
-  "type": "module",
-  "bin": {
-    "orbitmap": "./dist/index.js"
-  },
-  "files": [
-    "dist/",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "vitest run",
-    "prepare": "tsc",
-    "context": "node dist/index.js context"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/BTA-Systems/orbitmap-cli.git"
-  },
-  "keywords": [
-    "orbitmap",
-    "cli",
-    "agent",
-    "ai",
-    "project-management",
-    "task-management",
-    "gemini",
-    "codex",
-    "claude"
-  ],
-  "author": "BTA Systems",
-  "license": "MIT",
-  "homepage": "https://orbitmap.ai",
-  "dependencies": {
-    "commander": "^14.0.3"
-  },
-  "devDependencies": {
-    "@types/node": "^25.3.0",
-    "typescript": "^5.9.3",
-    "vitest": "^3.2.4"
-  }
-}
+{
+  "name": "orbitmap",
+  "version": "0.4.1",
+  "description": "Project management CLI for AI coding agents — works with Gemini CLI, GPT Codex, Claude Code, and any agent with shell access.",
+  "type": "module",
+  "bin": {
+    "orbitmap": "./dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:contract": "vitest run tests/contract",
+    "verify": "npm run build && vitest run",
+    "prepare": "tsc",
+    "context": "node dist/index.js context"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BTA-Systems/orbitmap-cli.git"
+  },
+  "keywords": [
+    "orbitmap",
+    "cli",
+    "agent",
+    "ai",
+    "project-management",
+    "task-management",
+    "gemini",
+    "codex",
+    "claude"
+  ],
+  "author": "BTA Systems",
+  "license": "MIT",
+  "homepage": "https://orbitmap.ai",
+  "dependencies": {
+    "commander": "^14.0.3",
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  }
+}