orbitmap 0.4.2 → 0.4.4

package/dist/agent-instructions.js.map

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

package/dist/area-directories.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Which directory holds which area's code — the guessing half of the workspace-first
+ * `orbitmap init` (schema v2).
+ *
+ * A workspace groups several areas, and on this machine each of them is (usually) a
+ * directory: either a subdirectory of an umbrella checkout, or the repository the user is
+ * standing in. Nothing on the server records that mapping — it is per machine — so `init`
+ * has to infer it and then write it down (`config.json` `areas` for in-tree directories,
+ * `link.json` `areas` for the rest).
+ *
+ * Three signals, in decreasing order of confidence, all of them cheap and offline:
+ *
+ * 1. **`name`** — the directory is literally named after the area slug. Unambiguous.
+ * 2. **`git-remote`** — the directory's `origin` remote is the area's `git_url`. The
+ *    strongest signal there is (an area *is* a repository in the data model), and the only
+ *    one that survives a renamed checkout.
+ * 3. **`slugified-name`** — slugifying the directory name yields the slug (`My App` →
+ *    `my-app`), i.e. the same rule the server used to make the slug in the first place.
+ *
+ * The git remote is read from `.git/config` rather than by spawning `git`: the CLI's tests
+ * are offline and process-free by policy, a subprocess per candidate directory is the
+ * slowest thing `init` could possibly do, and the file format has been stable for two
+ * decades. Anything not matched by these three is asked about (or skipped) — never guessed.
+ */
+/** As much of an area as the mapping needs; satisfied by `GET /areas` entries. */
+export interface AreaLike {
+    slug: string;
+    name?: string;
+    /** Repository URL recorded on the area, when the provider returns one. */
+    git_url?: string | null;
+}
+/** Which signal produced a directory ↔ area pairing. */
+export type AreaMatchKind = 'name' | 'git-remote' | 'slugified-name';
+/** One inferred pairing. */
+export interface AreaDirectoryMatch<T extends AreaLike = AreaLike> {
+    area: T;
+    /** Absolute directory. */
+    dir: string;
+    how: AreaMatchKind;
+}
+/**
+ * Immediate subdirectories of `root` that could plausibly be an area checkout — absolute
+ * paths, sorted, dot-directories and the usual build/dependency noise removed.
+ *
+ * Deliberately one level deep: deeper nesting is a real layout but scanning for it turns a
+ * setup command into a filesystem crawl, and the manual answer covers it in one line.
+ */
+export declare function listCandidateDirectories(root: string): string[];
+/**
+ * Comparable form of a git URL: scheme, credentials, the `.git` suffix and the
+ * `git@host:path` / `https://host/path` spelling difference all removed, so the two ways of
+ * writing the same repository compare equal.
+ */
+export declare function normalizeGitUrl(url: string): string;
+/**
+ * The `origin` remote URL recorded in `dir`'s git config, or `undefined` when `dir` is not a
+ * checkout (or has no origin). Handles the `.git`-as-a-file form that worktrees and
+ * submodules use.
+ */
+export declare function readGitRemoteUrl(dir: string): string | undefined;
+/** True when `dir` is the checkout of `area`, by any of the three signals. */
+export declare function matchDirectoryToArea(dir: string, area: AreaLike): AreaMatchKind | undefined;
+/**
+ * Guess a directory under `root` for each area, and report which areas got none.
+ *
+ * One directory is never handed to two areas: the candidates are consumed as they match, in
+ * area order, so a `name` hit for one area cannot be stolen by a `slugified-name` hit for
+ * another.
+ */
+export declare function detectAreaDirectories<T extends AreaLike>(root: string, areas: T[], candidates?: string[]): {
+    matched: Array<AreaDirectoryMatch<T>>;
+    unmatched: T[];
+};
+/** The inverse question: standing in `dir`, which of these areas is it? */
+export declare function detectAreaForDirectory<T extends AreaLike>(dir: string, areas: T[]): AreaDirectoryMatch<T> | undefined;

package/dist/area-directories.js

@@ -0,0 +1,162 @@
+/**
+ * Which directory holds which area's code — the guessing half of the workspace-first
+ * `orbitmap init` (schema v2).
+ *
+ * A workspace groups several areas, and on this machine each of them is (usually) a
+ * directory: either a subdirectory of an umbrella checkout, or the repository the user is
+ * standing in. Nothing on the server records that mapping — it is per machine — so `init`
+ * has to infer it and then write it down (`config.json` `areas` for in-tree directories,
+ * `link.json` `areas` for the rest).
+ *
+ * Three signals, in decreasing order of confidence, all of them cheap and offline:
+ *
+ * 1. **`name`** — the directory is literally named after the area slug. Unambiguous.
+ * 2. **`git-remote`** — the directory's `origin` remote is the area's `git_url`. The
+ *    strongest signal there is (an area *is* a repository in the data model), and the only
+ *    one that survives a renamed checkout.
+ * 3. **`slugified-name`** — slugifying the directory name yields the slug (`My App` →
+ *    `my-app`), i.e. the same rule the server used to make the slug in the first place.
+ *
+ * The git remote is read from `.git/config` rather than by spawning `git`: the CLI's tests
+ * are offline and process-free by policy, a subprocess per candidate directory is the
+ * slowest thing `init` could possibly do, and the file format has been stable for two
+ * decades. Anything not matched by these three is asked about (or skipped) — never guessed.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { basename, isAbsolute, join, resolve } from 'node:path';
+import { slugify } from './adapters/local/store.js';
+/** Directory names never worth scanning as an area checkout. */
+const SKIP_DIRS = new Set([
+    'node_modules',
+    'vendor',
+    'dist',
+    'build',
+    'out',
+    'target',
+    'coverage',
+    'tmp',
+    '__pycache__',
+]);
+/**
+ * Immediate subdirectories of `root` that could plausibly be an area checkout — absolute
+ * paths, sorted, dot-directories and the usual build/dependency noise removed.
+ *
+ * Deliberately one level deep: deeper nesting is a real layout but scanning for it turns a
+ * setup command into a filesystem crawl, and the manual answer covers it in one line.
+ */
+export function listCandidateDirectories(root) {
+    let entries;
+    try {
+        entries = readdirSync(resolve(root), { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    return entries
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name)
+        .filter((name) => !name.startsWith('.') && !SKIP_DIRS.has(name.toLowerCase()))
+        .sort()
+        .map((name) => join(resolve(root), name));
+}
+/**
+ * Comparable form of a git URL: scheme, credentials, the `.git` suffix and the
+ * `git@host:path` / `https://host/path` spelling difference all removed, so the two ways of
+ * writing the same repository compare equal.
+ */
+export function normalizeGitUrl(url) {
+    let out = url.trim().toLowerCase();
+    if (!out)
+        return '';
+    out = out.replace(/^git\+/, '');
+    out = out.replace(/^[a-z][a-z0-9+.-]*:\/\//, '');
+    out = out.replace(/^[^/@]+@/, '');
+    // scp-style `host:org/repo` → `host/org/repo`; a `:port` (digits) is left alone.
+    out = out.replace(/^([^/:]+):(?!\d)/, '$1/');
+    out = out.replace(/\.git$/, '');
+    return out.replace(/\/+$/, '');
+}
+/**
+ * The `origin` remote URL recorded in `dir`'s git config, or `undefined` when `dir` is not a
+ * checkout (or has no origin). Handles the `.git`-as-a-file form that worktrees and
+ * submodules use.
+ */
+export function readGitRemoteUrl(dir) {
+    const gitPath = join(resolve(dir), '.git');
+    if (!existsSync(gitPath))
+        return undefined;
+    let configFile = join(gitPath, 'config');
+    try {
+        if (statSync(gitPath).isFile()) {
+            const pointer = readFileSync(gitPath, 'utf-8').match(/^gitdir:\s*(.+)$/m)?.[1]?.trim();
+            if (!pointer)
+                return undefined;
+            configFile = join(isAbsolute(pointer) ? pointer : resolve(dir, pointer), 'config');
+        }
+        if (!existsSync(configFile))
+            return undefined;
+        const contents = readFileSync(configFile, 'utf-8');
+        // Only the `[remote "origin"]` section: any other remote (a fork, a mirror) is a
+        // different repository as far as identifying an area goes.
+        const section = contents.split(/^\[/m).find((part) => /^remote\s+"origin"\]/.test(part));
+        return section?.match(/^\s*url\s*=\s*(.+)$/m)?.[1]?.trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** True when `dir` is the checkout of `area`, by any of the three signals. */
+export function matchDirectoryToArea(dir, area) {
+    const name = basename(resolve(dir));
+    if (name === area.slug)
+        return 'name';
+    if (area.git_url) {
+        const remote = readGitRemoteUrl(dir);
+        if (remote && normalizeGitUrl(remote) === normalizeGitUrl(area.git_url))
+            return 'git-remote';
+    }
+    if (slugify(name) === area.slug)
+        return 'slugified-name';
+    return undefined;
+}
+/**
+ * Guess a directory under `root` for each area, and report which areas got none.
+ *
+ * One directory is never handed to two areas: the candidates are consumed as they match, in
+ * area order, so a `name` hit for one area cannot be stolen by a `slugified-name` hit for
+ * another.
+ */
+export function detectAreaDirectories(root, areas, candidates = listCandidateDirectories(root)) {
+    const remaining = [...candidates];
+    const matched = [];
+    const unmatched = [];
+    for (const area of areas) {
+        // The signals are tried in confidence order across *all* remaining candidates, so a
+        // weak match on an early directory never beats a strong one further down the list.
+        let hit;
+        for (const how of ['name', 'git-remote', 'slugified-name']) {
+            const dir = remaining.find((candidate) => matchDirectoryToArea(candidate, area) === how);
+            if (dir) {
+                hit = { dir, how };
+                break;
+            }
+        }
+        if (!hit) {
+            unmatched.push(area);
+            continue;
+        }
+        remaining.splice(remaining.indexOf(hit.dir), 1);
+        matched.push({ area, dir: hit.dir, how: hit.how });
+    }
+    return { matched, unmatched };
+}
+/** The inverse question: standing in `dir`, which of these areas is it? */
+export function detectAreaForDirectory(dir, areas) {
+    for (const how of ['name', 'git-remote', 'slugified-name']) {
+        const area = areas.find((candidate) => matchDirectoryToArea(dir, candidate) === how);
+        if (area)
+            return { area, dir: resolve(dir), how };
+    }
+    return undefined;
+}
+//# sourceMappingURL=area-directories.js.map

package/dist/area-directories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"area-directories.js","sourceRoot":"","sources":["../src/area-directories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEhE,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAqBpD,gEAAgE;AAChE,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACxB,cAAc;IACd,QAAQ;IACR,MAAM;IACN,OAAO;IACP,KAAK;IACL,QAAQ;IACR,UAAU;IACV,KAAK;IACL,aAAa;CACd,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;SACtC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;SAC7E,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAChC,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;IACjD,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAClC,iFAAiF;IACjF,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;IAC7C,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAChC,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAE3C,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC;QACH,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;YACvF,IAAI,CAAC,OAAO;gBAAE,OAAO,SAAS,CAAC;YAC/B,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,SAAS,CAAC;QAE9C,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACnD,iFAAiF;QACjF,2DAA2D;QAC3D,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACzF,OAAO,OAAO,EAAE,KAAK,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,oBAAoB,CAAC,GAAW,EAAE,IAAc;IAC9D,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IAEtC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,KAAK,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,YAAY,CAAC;IAC/F,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI;QAAE,OAAO,gBAAgB,CAAC;IACzD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAY,EACZ,KAAU,EACV,aAAuB,wBAAwB,CAAC,IAAI,CAAC;IAErD,MAAM,SAAS,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;IAClC,MAAM,OAAO,GAAiC,EAAE,CAAC;IACjD,MAAM,SAAS,GAAQ,EAAE,CAAC;IAE1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,oFAAoF;QACpF,mFAAmF;QACnF,IAAI,GAAoD,CAAC;QACzD,KAAK,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,gBAAgB,CAAU,EAAE,CAAC;YACpE,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,oBAAoB,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;YACzF,IAAI,GAAG,EAAE,CAAC;gBACR,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;gBACnB,MAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QACD,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAChC,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,sBAAsB,CACpC,GAAW,EACX,KAAU;IAEV,KAAK,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,gBAAgB,CAAU,EAAE,CAAC;QACpE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,oBAAoB,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC;QACrF,IAAI,IAAI;YAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC;IACpD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/area-grouping.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Grouping list rows by area, for the workspace-scoped listings (TS-adanc8).
+ *
+ * `orbitmap tasks` solved this first: in workspace scope a flat table of rows from several
+ * areas is unreadable and, worse, unactionable — nothing tells you which `--area` a row
+ * needs. It grouped them under an `── Name (slug) ──` heading. Issues, ideas, vibes and
+ * documents have the same problem and now share this implementation instead of growing four
+ * more copies of the fold.
+ *
+ * **Degrades on purpose.** The `area` block only reaches the issue/idea payloads with
+ * TS-95h9rj (web-app); until then those rows carry no area at all. Rather than print an
+ * empty column or a UUID heading nobody can use, {@link groupByArea} reports
+ * `grouped: false` when NO row names an area, and callers render exactly the flat table they
+ * rendered before. The moment the field appears the grouping lights up with no CLI change.
+ *
+ * A row with an `area` and a row without it can coexist (an area-less issue is legal — the
+ * column is nullable since s2e5t1), so "some rows have it" still groups, with the area-less
+ * rows collected under one `(no area)` heading.
+ */
+/** The `area` block a workspace-scoped row carries: the same three fields everywhere. */
+export interface RowArea {
+    id?: string | null;
+    slug?: string | null;
+    name?: string | null;
+}
+/** The only thing {@link groupByArea} needs of a row. */
+export interface AreaScopedRow {
+    area?: RowArea | null;
+}
+export interface AreaGroup<T> {
+    /** Heading text: `Name (slug)`, or `(no area)` for the area-less bucket. */
+    label: string;
+    slug: string | null;
+    rows: T[];
+}
+export interface AreaGrouping<T> {
+    /**
+     * `false` when not one row named an area — the payload predates TS-95h9rj, or the listing
+     * is area-scoped and every row trivially belongs to the requested area. Callers must fall
+     * back to a flat table; `groups` then holds a single unlabelled group with every row.
+     */
+    grouped: boolean;
+    groups: Array<AreaGroup<T>>;
+}
+/**
+ * Fold rows into one group per area, in ARRIVAL order — the server already orders by area,
+ * so this preserves whatever ordering it applied inside an area rather than imposing one.
+ */
+export declare function groupByArea<T extends AreaScopedRow>(rows: T[]): AreaGrouping<T>;
+/**
+ * Render a grouped listing: one table per area under a heading, or the plain table when the
+ * rows carry no area. `renderTable` stays the caller's business — every list has its own
+ * columns — so this owns only the headings and the spacing between them.
+ */
+export declare function printAreaGroups<T extends AreaScopedRow>(rows: T[], renderTable: (rows: T[]) => string, log?: (line: string) => void): boolean;

package/dist/area-grouping.js

@@ -0,0 +1,72 @@
+/**
+ * Grouping list rows by area, for the workspace-scoped listings (TS-adanc8).
+ *
+ * `orbitmap tasks` solved this first: in workspace scope a flat table of rows from several
+ * areas is unreadable and, worse, unactionable — nothing tells you which `--area` a row
+ * needs. It grouped them under an `── Name (slug) ──` heading. Issues, ideas, vibes and
+ * documents have the same problem and now share this implementation instead of growing four
+ * more copies of the fold.
+ *
+ * **Degrades on purpose.** The `area` block only reaches the issue/idea payloads with
+ * TS-95h9rj (web-app); until then those rows carry no area at all. Rather than print an
+ * empty column or a UUID heading nobody can use, {@link groupByArea} reports
+ * `grouped: false` when NO row names an area, and callers render exactly the flat table they
+ * rendered before. The moment the field appears the grouping lights up with no CLI change.
+ *
+ * A row with an `area` and a row without it can coexist (an area-less issue is legal — the
+ * column is nullable since s2e5t1), so "some rows have it" still groups, with the area-less
+ * rows collected under one `(no area)` heading.
+ */
+/** True when the block carries something a human can read, not just an id. */
+function isNamed(area) {
+    return Boolean(area && (area.slug || area.name));
+}
+/**
+ * Fold rows into one group per area, in ARRIVAL order — the server already orders by area,
+ * so this preserves whatever ordering it applied inside an area rather than imposing one.
+ */
+export function groupByArea(rows) {
+    // An id-only `area` block is not enough: a heading reading `── 019fba02-… ──` is noise,
+    // and it is exactly what an unfinished provider-side rollout would produce.
+    if (!rows.some((row) => isNamed(row.area))) {
+        return { grouped: false, groups: [{ label: '', slug: null, rows: [...rows] }] };
+    }
+    const groups = [];
+    const byKey = new Map();
+    for (const row of rows) {
+        const area = isNamed(row.area) ? row.area : null;
+        const key = area?.slug ?? area?.id ?? '';
+        let group = byKey.get(key);
+        if (!group) {
+            group = {
+                label: area ? (area.slug ? `${area.name ?? area.slug} (${area.slug})` : `${area.name}`) : '(no area)',
+                slug: area?.slug ?? null,
+                rows: [],
+            };
+            byKey.set(key, group);
+            groups.push(group);
+        }
+        group.rows.push(row);
+    }
+    return { grouped: true, groups };
+}
+/**
+ * Render a grouped listing: one table per area under a heading, or the plain table when the
+ * rows carry no area. `renderTable` stays the caller's business — every list has its own
+ * columns — so this owns only the headings and the spacing between them.
+ */
+export function printAreaGroups(rows, renderTable, log = console.log) {
+    const { grouped, groups } = groupByArea(rows);
+    if (!grouped) {
+        log(renderTable(rows));
+        return false;
+    }
+    groups.forEach((group, index) => {
+        if (index > 0)
+            log('');
+        log(`── ${group.label} (${group.rows.length}) ──`);
+        log(renderTable(group.rows));
+    });
+    return true;
+}
+//# sourceMappingURL=area-grouping.js.map

package/dist/area-grouping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"area-grouping.js","sourceRoot":"","sources":["../src/area-grouping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AA+BH,8EAA8E;AAC9E,SAAS,OAAO,CAAC,IAAgC;IAC/C,OAAO,OAAO,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAA0B,IAAS;IAC5D,wFAAwF;IACxF,4EAA4E;IAC5E,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC3C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IAClF,CAAC;IAED,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;IAE9C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC;QACzC,IAAI,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG;gBACN,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW;gBACrG,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI;gBACxB,IAAI,EAAE,EAAE;aACT,CAAC;YACF,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAS,EACT,WAAkC,EAClC,MAA8B,OAAO,CAAC,GAAG;IAEzC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAE9C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC9B,IAAI,KAAK,GAAG,CAAC;YAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACvB,GAAG,CAAC,MAAM,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,CAAC;QACnD,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/commands/areas.js

@@ -1,5 +1,18 @@
+/**
+ * `orbitmap areas` — the areas this agent can reach.
+ *
+ * The last column used to be headed "Current" with a bare `*`, which reads as user state
+ * ("this is where I am working"). It is not: it is whichever area the resolution ladder
+ * happens to produce from the current directory, i.e. a technical default for fetching
+ * context (issue IS-vse335). It is now headed **"Resolves to"** and annotated with the
+ * rung that produced it, so the difference between "my project's config says so" and
+ * "a machine-wide leftover says so" is visible at a glance.
+ */
 import { createAdapter } from '../adapters/factory.js';
 import { formatOutput, printError, formatTable } from '../output.js';
+import { loadConfig } from '../config.js';
+import { resolveArea } from '../workspace-resolve.js';
+import { isStrongAreaSource } from '../write-target.js';
 export async function areasCommand(options) {
     try {
         const client = await createAdapter();
@@ -13,17 +26,32 @@ export async function areasCommand(options) {
             console.log('No areas found.');
             return;
         }
-        console.log(formatTable(['Name', 'Slug', 'Workspace', 'Role', 'Current'], areas.map((a) => [
+        // `_current` is the server's answer to "which area did this request carry"; the rung
+        // is purely local, so it is resolved here rather than read off the response. The global
+        // config must be passed in explicitly — it is the (weak) rung this column exists to expose.
+        const source = resolveArea({ config: await loadConfig() }).source;
+        console.log(formatTable(['Name', 'Slug', 'Workspace', 'Role', 'Resolves to'], areas.map((a) => [
             a.name,
             a.slug,
             a.workspace?.name ?? '',
             a.role,
-            a._current ? '*' : '',
+            a._current ? `* ${sourceNote(source)}` : '',
         ])));
+        console.log('\n"Resolves to *" is where commands run from this directory land by default — a ' +
+            'resolution default, not a choice you made. Pass --area <slug> to target another ' +
+            'area; `orbitmap context` shows the directory → area map.');
     }
     catch (error) {
         printError(error, options.json);
         process.exitCode = 1;
     }
 }
+/** Short parenthetical naming the rung, flagged when it is the weak machine-wide one. */
+function sourceNote(source) {
+    if (!source)
+        return '';
+    return isStrongAreaSource(source)
+        ? `(from ${source})`
+        : `(from ${source} — machine-wide default, not this project)`;
+}
 //# sourceMappingURL=areas.js.map

package/dist/commands/areas.js.map

@@ -1 +1 @@
-{"version":3,"file":"areas.js","sourceRoot":"","sources":["../../src/commands/areas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAmBrE,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAElC;IACC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAkB,CAAC;QAE5D,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC;QAE5B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;YAC/B,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CACT,WAAW,CACT,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAChD,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACf,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,SAAS,EAAE,IAAI,IAAI,EAAE;YACvB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;SACtB,CAAC,CACH,CACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}
+{"version":3,"file":"areas.js","sourceRoot":"","sources":["../../src/commands/areas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAmB,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAmBxD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAElC;IACC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAkB,CAAC;QAE5D,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC;QAE5B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;YAC/B,OAAO;QACT,CAAC;QAED,qFAAqF;QACrF,wFAAwF;QACxF,4FAA4F;QAC5F,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,UAAU,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC;QAElE,OAAO,CAAC,GAAG,CACT,WAAW,CACT,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,EACpD,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACf,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,SAAS,EAAE,IAAI,IAAI,EAAE;YACvB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;SAC5C,CAAC,CACH,CACF,CAAC;QACF,OAAO,CAAC,GAAG,CACT,kFAAkF;YAChF,kFAAkF;YAClF,0DAA0D,CAC7D,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,SAAS,UAAU,CAAC,MAA8B;IAChD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,OAAO,kBAAkB,CAAC,MAAM,CAAC;QAC/B,CAAC,CAAC,SAAS,MAAM,GAAG;QACpB,CAAC,CAAC,SAAS,MAAM,4CAA4C,CAAC;AAClE,CAAC"}

package/dist/commands/assign.d.ts

@@ -1,6 +1,7 @@
 export declare function assignCommand(objectId: string, agentId: string | undefined, options: {
     json: boolean;
     area?: string;
+    yes?: boolean;
     userId?: string;
     type?: string;
 }): Promise<void>;

package/dist/commands/assign.js

@@ -1,4 +1,5 @@
 import { createAdapter } from '../adapters/factory.js';
+import { confirmWriteTarget } from '../write-target.js';
 import { objectPrefix } from '../id-resolve.js';
 import { formatOutput, printError, printSuccess } from '../output.js';
 const VALID_OBJECT_TYPES = ['task', 'issue', 'idea', 'intent'];
@@ -43,6 +44,7 @@ export async function assignCommand(objectId, agentId, options) {
             process.exitCode = 1;
             return;
         }
+        await confirmWriteTarget('assign', options);
         const client = await createAdapter(options.area);
         let assignment;
         if (options.userId) {

package/dist/commands/assign.js.map

@@ -1 +1 @@
-{"version":3,"file":"assign.js","sourceRoot":"","sources":["../../src/commands/assign.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEtE,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AAGxE,4FAA4F;AAC5F,6FAA6F;AAC7F,6EAA6E;AAC7E,MAAM,eAAe,GAAqC;IACxD,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,OAAO;IACX,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,QAAQ;CACb,CAAC;AAsBF,SAAS,UAAU,CAAC,QAAgB,EAAE,QAAiB;IACrD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,kBAAkB,CAAC,QAAQ,CAAC,QAA4B,CAAC;YAC9D,CAAC,CAAE,QAA6B;YAChC,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IACD,2FAA2F;IAC3F,6EAA6E;IAC7E,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,eAAe,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;IACzC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAgB,EAChB,OAA2B,EAC3B,OAAyE;IAEzE,IAAI,CAAC;QACH,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAC9B,UAAU,CAAC,qEAAqE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YAChG,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAChC,UAAU,CAAC,8CAA8C,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YACzE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,UAAU,CACR,+BAA+B,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAC9D,OAAO,CAAC,IAAI,CACb,CAAC;YACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAEjD,IAAI,UAAsD,CAAC;QAC3D,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;gBAC7C,UAAU,CAAC,uCAAuC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBAClE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,UAAU,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,UAAU,GAAG,EAAE,QAAQ,EAAE,OAAQ,EAAE,CAAC;QACtC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QAE3E,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAI,QAA+B,CAAC,IAAI,CAAC;YAChD,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC;YACzE,YAAY,CAAC,oBAAoB,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAI,QAA+B,CAAC,IAAI,CAAC;YAChD,MAAM,GAAG,GAAG,CAAC,CAAC,gBAAgB,IAAI,CAAC,CAAC,iBAAiB,IAAI,EAAE,CAAC;YAC5D,YAAY,CACV,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,QAAQ,gBAAgB,GAAG,GAAG,EACvF,KAAK,CACN,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}
+{"version":3,"file":"assign.js","sourceRoot":"","sources":["../../src/commands/assign.ts"],"names":[],"mappings":"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"}

package/dist/commands/context.d.ts

@@ -1,4 +1,99 @@
+import { type AreaDirectoryMapping, type AreaSource, type OrbitMapMode, type WorkspaceSource } from '../workspace-resolve.js';
+interface ContextResponse {
+    data: {
+        agent: {
+            id: string;
+            name: string;
+            slug: string;
+        };
+        area: {
+            id: string;
+            name: string;
+            slug: string;
+            description: string | null;
+            git_url: string | null;
+            default_branch: string;
+        } | null;
+        /**
+         * The areas of the resolved workspace this agent can work in. Present only on the
+         * workspace branch of the response — the whole point of it is that one `context` call
+         * tells the agent where it may work, so it never has to list areas to find out.
+         */
+        areas?: Array<{
+            id: string;
+            slug: string;
+            name: string;
+            role: string;
+        }>;
+        active_mission?: {
+            id: string;
+            display_number?: string;
+            name: string;
+            status: string;
+        } | null;
+        /** Open intents of the workspace — the work that outranks any single task. */
+        open_intents?: Array<{
+            number: string;
+            name: string;
+            status: string;
+        }>;
+        tasks: Array<{
+            id: string;
+            title: string;
+            status: string;
+            priority: string;
+            task_number: string;
+            display_number: string;
+        }>;
+        documents: Array<{
+            id: string;
+            title: string;
+            slug: string;
+            type: string;
+            _shared: boolean;
+        }>;
+    };
+}
+/**
+ * The workspace this invocation is scoped to.
+ *
+ * Always emitted as an object, with nullable members rather than a null block: a consumer
+ * can read `workspace.slug` unconditionally.
+ */
+export interface ContextWorkspace {
+    /** Slug or uuid, whichever identified the workspace; never a path. */
+    slug: string | null;
+    /** Display name — only known when it can be read from a local `workspace.yml`. */
+    name: string | null;
+    /** Which rung of the workspace-identity ladder produced {@link ContextWorkspace.slug}. */
+    source: WorkspaceSource | null;
+    /** Absolute workspace directory; local mode only. */
+    path: string | null;
+}
+/** The `--json` payload: the adapter envelope plus the resolved local context. */
+export interface ContextOutput extends ContextResponse {
+    workspace: ContextWorkspace;
+    /** Every directory → area mapping visible from `cwd`, deepest first. */
+    areas_map: AreaDirectoryMapping[];
+    /**
+     * The area commands actually target from this directory, or `null` (workspace scope).
+     *
+     * This is the *effective* area, not the raw ladder result: in local mode the workspace's
+     * own `default_area` (and the single-area fallback) outrank a leftover machine-wide
+     * `area`, so the ladder alone would name an area no command would use.
+     */
+    resolved_area: string | null;
+    /**
+     * Rung of the area ladder that produced {@link ContextOutput.resolved_area}, or
+     * `'workspace-default'` when the local workspace overrode the ladder.
+     */
+    area_source: AreaSource | 'workspace-default' | null;
+    mode: OrbitMapMode;
+    /** Directory the resolution ran from — what `resolved_area` is relative to. */
+    cwd: string;
+}
 export declare function contextCommand(options: {
     json: boolean;
     area?: string;
 }): Promise<void>;
+export {};