@floh-solutions/pharos-cli 0.25.0 → 0.26.0

package/dist/adopt-type.d.ts

@@ -0,0 +1,58 @@
+import type { GitHubIssue } from "@floh-solutions/gh-core";
+import { type CategorySource } from "./bridge.js";
+import type { Session } from "./session.js";
+/**
+ * Which work item type an adopted issue becomes — **resolved, never named**
+ * (#872).
+ *
+ * ## The bug this replaces
+ *
+ * `issue.ts` carried `const DEFAULT_WORK_ITEM_TYPE = "Issue"` and used it in two
+ * places. That is correct on *this* project by accident: Basic's requirement
+ * type happens to be called `Issue`. On **Agile** the word means an
+ * *impediment* — a blocker, tracked off the backlog — and the requirement type
+ * is `User Story`. So every GitHub issue adopted onto an Agile board was filed
+ * as a blocker, silently, and the CLI shipped that way in 0.25.0.
+ *
+ * A type name is a property of the project's **process template**. It can never
+ * be written down here.
+ *
+ * ## How it is decided
+ *
+ * 1. `--type` wins outright. Somebody naming a type has looked at their own
+ *    board, and this must not argue with them.
+ * 2. Otherwise the issue's **labels** choose a category — a saved mapping by
+ *    label id first, then the name defaults for a repository nobody has
+ *    configured. See `bridge.ts`.
+ * 3. The category is resolved against **this project's** own answer, from
+ *    `wit/workitemtypecategories`. The lookups are ordered because they
+ *    degrade: a feature request asks for `FeatureCategory` and settles for
+ *    `RequirementCategory`, which is all Basic has.
+ * 4. If none of that resolves — an unreachable board, a project with no
+ *    requirement category at all — it falls back to the old constant **and says
+ *    so**, because refusing to adopt over a naming question would be worse than
+ *    adopting into a type somebody can change.
+ *
+ * Every step is reported, because "this became a Bug because you mapped it" and
+ * "this became a Bug because nothing matched" are different facts and only one
+ * of them is a decision.
+ */
+export interface ResolvedType {
+    /** What to create. */
+    type: string;
+    /** How it was arrived at, for the report. */
+    source: CategorySource | "flag" | "fallback";
+    /** The category that was asked for, when one was. */
+    category?: string;
+    /** The label that decided it, when one did. */
+    label?: string;
+    /** Set when the project could not answer and the constant was used. */
+    note?: string;
+}
+/** The last-resort name. Basic's requirement type, and the historical default. */
+export declare const FALLBACK_WORK_ITEM_TYPE = "Issue";
+export declare function resolveWorkItemType(session: Session, issue: Pick<GitHubIssue, "repo" | "labels">, options?: {
+    type?: string | undefined;
+    env?: NodeJS.ProcessEnv;
+}): Promise<ResolvedType>;
+//# sourceMappingURL=adopt-type.d.ts.map

package/dist/adopt-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adopt-type.d.ts","sourceRoot":"","sources":["../src/adopt-type.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,UAAU,CAAC;IAC7C,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,kFAAkF;AAClF,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAE/C,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,EAC3C,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,GACnE,OAAO,CAAC,YAAY,CAAC,CAkDvB"}

package/dist/adopt-type.js

@@ -0,0 +1,61 @@
+import { WorkItemTypesApi, typeForCategory } from "@floh-solutions/ado-core";
+import { categoryFor, defaultBridgePath, parseBridgeConfig, repoConfig, } from "./bridge.js";
+/** The last-resort name. Basic's requirement type, and the historical default. */
+export const FALLBACK_WORK_ITEM_TYPE = "Issue";
+export async function resolveWorkItemType(session, issue, options = {}) {
+    if (options.type !== undefined && options.type !== "") {
+        return { type: options.type, source: "flag" };
+    }
+    const env = options.env ?? process.env;
+    const organization = session.client.organization;
+    const project = session.client.project ?? "";
+    const config = await readBridge(env);
+    const repo = repoConfig(config, organization, project, issue.repo);
+    const choice = categoryFor(issue.labels.map((label) => ({ id: label.id ?? -1, name: label.name })), repo);
+    let catalog;
+    try {
+        catalog = await new WorkItemTypesApi(session.client.http).categories();
+    }
+    catch (error) {
+        // The board could not be asked. Adopting into the historical default is
+        // better than refusing, and naming the reason is what stops it reading as a
+        // deliberate choice.
+        return {
+            type: FALLBACK_WORK_ITEM_TYPE,
+            source: "fallback",
+            note: `the project's work item types could not be read (${error.message}), so the `
+                + `default "${FALLBACK_WORK_ITEM_TYPE}" was used — pass --type to be explicit`,
+        };
+    }
+    const resolved = typeForCategory(catalog, ...choice.categories);
+    if (resolved === undefined) {
+        return {
+            type: FALLBACK_WORK_ITEM_TYPE,
+            source: "fallback",
+            ...(choice.label === undefined ? {} : { label: choice.label }),
+            note: `this project has none of ${choice.categories.join(", ")}, so the default `
+                + `"${FALLBACK_WORK_ITEM_TYPE}" was used — pass --type to be explicit`,
+        };
+    }
+    return {
+        type: resolved,
+        source: choice.source,
+        ...(choice.categories[0] === undefined ? {} : { category: choice.categories[0] }),
+        ...(choice.label === undefined ? {} : { label: choice.label }),
+    };
+}
+/** The mapping, or an empty one. A missing or malformed file is not an error. */
+async function readBridge(env) {
+    const path = defaultBridgePath(env);
+    try {
+        const { readFile } = await import("node:fs/promises");
+        return parseBridgeConfig(await readFile(path, "utf8"), path);
+    }
+    catch {
+        // No file yet is the ordinary state, and a malformed one must not take down
+        // `adopt` — it degrades to the name defaults, which is what an
+        // unconfigured repository gets anyway.
+        return { version: 1, scopes: {} };
+    }
+}
+//# sourceMappingURL=adopt-type.js.map

package/dist/adopt-type.js.map

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

package/dist/bridge.d.ts

@@ -0,0 +1,156 @@
+/**
+ * `~/.config/pharos/bridge.json` — **what an issue becomes when somebody adopts
+ * it**, and the one file the CLI and the app both read (#861).
+ *
+ * ## Why it is a file rather than app state
+ *
+ * The same rule `pharos-convert` and `doctor` follow, and the one AGENTS.md
+ * keeps restating: if the app owns the mapping and the CLI guesses, then
+ * `pharos issue adopt` in a headless session files to a different work item type
+ * than the app does — and **the one that drifts is the one nobody is watching**.
+ * So the CLI owns the file, the CLI has verbs over it, and the app's settings
+ * page is a GUI over those verbs rather than a second implementation.
+ *
+ * ## Why it is keyed by scope on day one
+ *
+ * The UI only ever shows one organisation and project today. The key is there
+ * anyway because this is the single artefact multi-scope would otherwise force a
+ * rewrite of — see `docs/pharos-multi-scope-plan.md`. It costs one nesting level
+ * now and saves throwing the file away later.
+ *
+ * ## Why labels are keyed by ID
+ *
+ * **Probed on a live repository:** creating a label, renaming it and reading it
+ * back leaves `id` and `node_id` unchanged. So an id-keyed mapping survives a
+ * rename, which is the thing people actually do to labels.
+ *
+ * Two consequences worth stating rather than discovering:
+ *
+ * - **Ids are per repository.** `bug` is `11710323621` on one repo and
+ *   `1593484620` on another. A mapping is therefore per repo by construction,
+ *   not a global preference.
+ * - **Delete-and-recreate yields a NEW id**, so a mapping whose id no longer
+ *   resolves goes visibly *broken* rather than silently re-binding to a
+ *   different label that happens to share a name. That is the correct
+ *   behaviour: the old label is gone, and what replaced it is somebody else's
+ *   decision to confirm.
+ *
+ * `name` is stored beside the id for display and for diagnosis. It is never what
+ * a lookup matches on.
+ */
+export interface BridgeConfig {
+    version: 1;
+    scopes: Record<string, ScopeConfig>;
+}
+export interface ScopeConfig {
+    repos: Record<string, RepoBridgeConfig>;
+    digest: DigestPolicy;
+}
+export interface RepoBridgeConfig {
+    /** Label **id** (as a string key) → what adopting an issue with it produces. */
+    labels: Record<string, LabelMapping>;
+    /** Where an issue with no mapped label goes. */
+    defaultCategory: string;
+}
+export interface LabelMapping {
+    /** Display only, and deliberately not what anything matches on. */
+    name: string;
+    /** An Azure DevOps work item type CATEGORY, never a type name. */
+    category: string;
+}
+/**
+ * When a digest is written back to the work item.
+ *
+ * **Two events, not every comment.** Adopt and close are decisions; a comment is
+ * chatter. Mirroring chatter puts noise on a client's board and re-opens the
+ * echo problem the hub already paid for — while never writing turns the work
+ * item into a dead link, which is worse. See the wave spec.
+ */
+export interface DigestPolicy {
+    onAdopt: boolean;
+    onClose: boolean;
+}
+export declare const DEFAULT_DIGEST: DigestPolicy;
+/** Azure DevOps' category reference names, as used here. */
+export declare const CATEGORY: {
+    readonly bug: "Microsoft.BugCategory";
+    readonly requirement: "Microsoft.RequirementCategory";
+    readonly feature: "Microsoft.FeatureCategory";
+    readonly epic: "Microsoft.EpicCategory";
+    readonly task: "Microsoft.TaskCategory";
+};
+/**
+ * What a repository nobody has configured does.
+ *
+ * **Matched by NAME, and that is the one place a name is allowed to matter.** A
+ * repo you have never opened the settings for should still adopt sensibly, and
+ * the only thing available before somebody maps anything is what the labels are
+ * called. The moment a mapping is saved it pins to the id and renames stop
+ * mattering — *id for bindings you made, name for defaults you did not*.
+ *
+ * Ordered, because the lookups degrade: a feature request wants
+ * `FeatureCategory` and settles for `RequirementCategory`, which is all Basic
+ * has.
+ */
+export declare const NAME_DEFAULTS: readonly {
+    readonly match: readonly string[];
+    readonly categories: readonly string[];
+}[];
+/** Where the file lives. `PHAROS_BRIDGE_FILE` overrides it, for tests. */
+export declare function defaultBridgePath(env?: NodeJS.ProcessEnv): string;
+/** `org/project`, lowercased — the scope key. */
+export declare function scopeKey(org: string, project: string): string;
+export declare function emptyBridgeConfig(): BridgeConfig;
+/**
+ * Read a config, or refuse with a message naming the file.
+ *
+ * **A file it cannot parse is an answer, not a crash** — the same rule
+ * `doctor`'s repos.json handling follows. A malformed mapping means adoption
+ * falls back to the name defaults and says so, rather than taking the CLI down
+ * on an unrelated verb.
+ */
+export declare function parseBridgeConfig(text: string, source?: string): BridgeConfig;
+export declare function formatBridgeConfig(config: BridgeConfig): string;
+/** This repository's mapping in this scope, or the empty one. */
+export declare function repoConfig(config: BridgeConfig, org: string, project: string, repo: string): RepoBridgeConfig;
+export declare function digestPolicy(config: BridgeConfig, org: string, project: string): DigestPolicy;
+/** One label as GitHub reports it. */
+export interface IssueLabel {
+    id: number;
+    name: string;
+}
+/** How a category was arrived at — reported, because a silent default misleads. */
+export type CategorySource = "mapping" | "name-default" | "repo-default";
+export interface CategoryChoice {
+    /** Ordered: try each in turn, because a project may not have the first. */
+    categories: readonly string[];
+    source: CategorySource;
+    /** Which label decided it, when one did. */
+    label?: string;
+}
+/**
+ * Which category an issue's labels ask for.
+ *
+ * **Saved mappings win, by id.** Then the name defaults, for a repository nobody
+ * has configured. Then the repository's own default.
+ *
+ * The `source` comes back with it on purpose: "this went to a requirement
+ * because you mapped `bug`" and "this went to a requirement because nothing
+ * matched" are different facts, and a picker that showed the same preselection
+ * for both would be hiding the second one.
+ */
+export declare function categoryFor(labels: readonly IssueLabel[], repo: RepoBridgeConfig): CategoryChoice;
+/**
+ * A saved mapping whose label no longer exists in the repository.
+ *
+ * Reported rather than pruned. The mapping is a decision somebody made, and a
+ * label that has gone is usually a rename they did not realise breaks it — or a
+ * delete-and-recreate, which is a genuinely different label. Either way the
+ * answer is to show it, not to guess.
+ */
+export declare function brokenMappings(repo: RepoBridgeConfig, live: readonly IssueLabel[]): {
+    id: string;
+    name: string;
+    category: string;
+}[];
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACxC,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,gDAAgD;IAChD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,cAAc,EAAE,YAA+C,CAAC;AAE7E,4DAA4D;AAC5D,eAAO,MAAM,QAAQ;;;;;;CAMX,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EAMjH,CAAC;AAEF,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAK9E;AAED,iDAAiD;AACjD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,iBAAiB,IAAI,YAAY,CAEhD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAgB,GAAG,YAAY,CA+CpF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAE/D;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CACxB,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,gBAAgB,CAQlB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAE7F;AAED,sCAAsC;AACtC,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mFAAmF;AACnF,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,cAAc,GAAG,cAAc,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,IAAI,EAAE,gBAAgB,GACrB,cAAc,CAiBhB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,SAAS,UAAU,EAAE,GAC1B;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAAE,CAKlD"}

package/dist/bridge.js

@@ -0,0 +1,157 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+export const DEFAULT_DIGEST = { onAdopt: true, onClose: true };
+/** Azure DevOps' category reference names, as used here. */
+export const CATEGORY = {
+    bug: "Microsoft.BugCategory",
+    requirement: "Microsoft.RequirementCategory",
+    feature: "Microsoft.FeatureCategory",
+    epic: "Microsoft.EpicCategory",
+    task: "Microsoft.TaskCategory",
+};
+/**
+ * What a repository nobody has configured does.
+ *
+ * **Matched by NAME, and that is the one place a name is allowed to matter.** A
+ * repo you have never opened the settings for should still adopt sensibly, and
+ * the only thing available before somebody maps anything is what the labels are
+ * called. The moment a mapping is saved it pins to the id and renames stop
+ * mattering — *id for bindings you made, name for defaults you did not*.
+ *
+ * Ordered, because the lookups degrade: a feature request wants
+ * `FeatureCategory` and settles for `RequirementCategory`, which is all Basic
+ * has.
+ */
+export const NAME_DEFAULTS = [
+    { match: ["bug", "defect", "regression"], categories: [CATEGORY.bug] },
+    {
+        match: ["enhancement", "feature", "feature request"],
+        categories: [CATEGORY.feature, CATEGORY.requirement],
+    },
+];
+/** Where the file lives. `PHAROS_BRIDGE_FILE` overrides it, for tests. */
+export function defaultBridgePath(env = process.env) {
+    const override = env.PHAROS_BRIDGE_FILE;
+    if (override !== undefined && override !== "")
+        return override;
+    const base = env.XDG_CONFIG_HOME ?? join(homedir(), ".config");
+    return join(base, "pharos", "bridge.json");
+}
+/** `org/project`, lowercased — the scope key. */
+export function scopeKey(org, project) {
+    return `${org.trim().toLowerCase()}/${project.trim().toLowerCase()}`;
+}
+export function emptyBridgeConfig() {
+    return { version: 1, scopes: {} };
+}
+/**
+ * Read a config, or refuse with a message naming the file.
+ *
+ * **A file it cannot parse is an answer, not a crash** — the same rule
+ * `doctor`'s repos.json handling follows. A malformed mapping means adoption
+ * falls back to the name defaults and says so, rather than taking the CLI down
+ * on an unrelated verb.
+ */
+export function parseBridgeConfig(text, source = "bridge.json") {
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch (error) {
+        throw new Error(`${source} is not valid JSON: ${error.message}`);
+    }
+    if (typeof raw !== "object" || raw === null)
+        throw new Error(`${source} is not an object.`);
+    const record = raw;
+    if (record.version !== 1) {
+        throw new Error(`${source} has version ${String(record.version)}; this build understands 1.`);
+    }
+    const scopes = {};
+    const rawScopes = (record.scopes ?? {});
+    for (const [key, value] of Object.entries(rawScopes)) {
+        const scope = (value ?? {});
+        const repos = {};
+        for (const [repo, rawRepo] of Object.entries((scope.repos ?? {}))) {
+            const entry = (rawRepo ?? {});
+            const labels = {};
+            for (const [id, rawLabel] of Object.entries((entry.labels ?? {}))) {
+                const label = (rawLabel ?? {});
+                if (typeof label.category !== "string")
+                    continue;
+                labels[id] = {
+                    name: typeof label.name === "string" ? label.name : "",
+                    category: label.category,
+                };
+            }
+            repos[repo.toLowerCase()] = {
+                labels,
+                defaultCategory: typeof entry.defaultCategory === "string" ? entry.defaultCategory : CATEGORY.requirement,
+            };
+        }
+        const digest = (scope.digest ?? {});
+        scopes[key.toLowerCase()] = {
+            repos,
+            digest: {
+                onAdopt: digest.onAdopt !== false,
+                onClose: digest.onClose !== false,
+            },
+        };
+    }
+    return { version: 1, scopes };
+}
+export function formatBridgeConfig(config) {
+    return `${JSON.stringify(config, null, 2)}\n`;
+}
+/** This repository's mapping in this scope, or the empty one. */
+export function repoConfig(config, org, project, repo) {
+    const scope = config.scopes[scopeKey(org, project)];
+    return (scope?.repos[repo.trim().toLowerCase()] ?? {
+        labels: {},
+        defaultCategory: CATEGORY.requirement,
+    });
+}
+export function digestPolicy(config, org, project) {
+    return config.scopes[scopeKey(org, project)]?.digest ?? DEFAULT_DIGEST;
+}
+/**
+ * Which category an issue's labels ask for.
+ *
+ * **Saved mappings win, by id.** Then the name defaults, for a repository nobody
+ * has configured. Then the repository's own default.
+ *
+ * The `source` comes back with it on purpose: "this went to a requirement
+ * because you mapped `bug`" and "this went to a requirement because nothing
+ * matched" are different facts, and a picker that showed the same preselection
+ * for both would be hiding the second one.
+ */
+export function categoryFor(labels, repo) {
+    for (const label of labels) {
+        const mapped = repo.labels[String(label.id)];
+        if (mapped !== undefined) {
+            return { categories: [mapped.category], source: "mapping", label: label.name };
+        }
+    }
+    for (const label of labels) {
+        const lowered = label.name.trim().toLowerCase();
+        const rule = NAME_DEFAULTS.find((candidate) => candidate.match.includes(lowered));
+        if (rule !== undefined) {
+            return { categories: rule.categories, source: "name-default", label: label.name };
+        }
+    }
+    return { categories: [repo.defaultCategory], source: "repo-default" };
+}
+/**
+ * A saved mapping whose label no longer exists in the repository.
+ *
+ * Reported rather than pruned. The mapping is a decision somebody made, and a
+ * label that has gone is usually a rename they did not realise breaks it — or a
+ * delete-and-recreate, which is a genuinely different label. Either way the
+ * answer is to show it, not to guess.
+ */
+export function brokenMappings(repo, live) {
+    const known = new Set(live.map((label) => String(label.id)));
+    return Object.entries(repo.labels)
+        .filter(([id]) => !known.has(id))
+        .map(([id, mapping]) => ({ id, name: mapping.name, category: mapping.category }));
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

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

package/dist/cli.d.ts

@@ -12,7 +12,7 @@ import { type ExitCode } from "./output.js";
  * expensive kind of wrong. Anything added to the switch belongs here, and the
  * test below fails if it does not.
  */
-export declare const COMMANDS: readonly ["setup", "whoami", "query", "task", "types", "history", "iterations", "areas", "links", "fields", "create", "update", "link", "unlink", "delete", "restore", "deleted", "attach", "detach", "download", "image", "people", "wiki", "comment", "hooks", "plan", "doctor", "issue"];
+export declare const COMMANDS: readonly ["setup", "whoami", "query", "task", "types", "history", "iterations", "areas", "links", "fields", "create", "update", "link", "unlink", "delete", "restore", "deleted", "attach", "detach", "download", "image", "people", "wiki", "comment", "hooks", "plan", "doctor", "issue", "bridge"];
 export interface RunOptions {
     argv: string[];
     cwd: string;

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AA8B5D,OAAO,EAKL,KAAK,QAAQ,EAEd,MAAM,aAAa,CAAC;AAyBrB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,6RAMX,CAAC;AA8gBX,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,gDAAgD;IAChD,SAAS,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAChD,+EAA+E;IAC/E,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,uDAAuD;IACvD,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CACnC;AAED,wBAAsB,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAOhE"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AA+B5D,OAAO,EAKL,KAAK,QAAQ,EAEd,MAAM,aAAa,CAAC;AAyBrB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,uSAMX,CAAC;AA8gBX,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,gDAAgD;IAChD,SAAS,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAChD,+EAA+E;IAC/E,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,uDAAuD;IACvD,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CACnC;AAED,wBAAsB,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAOhE"}

package/dist/cli.js

@@ -9,6 +9,7 @@ import { runClassification, runFields, runHistory, runLinkTypes, } from "./comma
 import { runComment } from "./commands/comment.js";
 import { runCreate } from "./commands/create.js";
 import { runDetach } from "./commands/detach.js";
+import { runBridge } from "./commands/bridge.js";
 import { runDoctor } from "./commands/doctor.js";
 import { runDownload, runTypes, runWhoami } from "./commands/discover.js";
 import { runImage, runWikiImage } from "./commands/image.js";
@@ -61,7 +62,7 @@ export const COMMANDS = [
     "history", "iterations", "areas", "links", "fields",
     "create", "update", "link", "unlink", "delete", "restore", "deleted",
     "attach", "detach", "download", "image", "people",
-    "wiki", "comment", "hooks", "plan", "doctor", "issue",
+    "wiki", "comment", "hooks", "plan", "doctor", "issue", "bridge",
 ];
 /** Where long text comes from, for the verbs that take some. */
 const CONTENT_OPTIONS = {
@@ -735,31 +736,44 @@ async function dispatch(io, options) {
                                                             "if-body": { type: "string" },
                                                             "if-body-file": { type: "string" },
                                                         }
-                                                        : command === "deleted"
-                                                            ? { top: { type: "string" } }
-                                                            : command === "history"
-                                                                ? { top: { type: "string" }, all: { type: "boolean" } }
-                                                                : command === "iterations" || command === "areas"
-                                                                    ? { depth: { type: "string" } }
-                                                                    : command === "fields"
-                                                                        ? { type: { type: "string" }, constrained: { type: "boolean" } }
-                                                                        : command === "hooks"
-                                                                            ? {
-                                                                                hub: { type: "string" },
-                                                                                user: { type: "string" },
-                                                                                password: { type: "string" },
-                                                                            }
-                                                                            : command === "setup"
+                                                        : command === "bridge"
+                                                            ? {
+                                                                repo: { type: "string" },
+                                                                // Singular and NOT repeatable, unlike `issue`'s `--label`: this one
+                                                                // names exactly one mapping to write or remove.
+                                                                label: { type: "string" },
+                                                                category: { type: "string" },
+                                                                "on-adopt": { type: "boolean" },
+                                                                "on-close": { type: "boolean" },
+                                                                // The only way to say "no". A boolean flag cannot express false, so
+                                                                // without this the digest policy was write-only.
+                                                                manual: { type: "boolean" },
+                                                            }
+                                                            : command === "deleted"
+                                                                ? { top: { type: "string" } }
+                                                                : command === "history"
+                                                                    ? { top: { type: "string" }, all: { type: "boolean" } }
+                                                                    : command === "iterations" || command === "areas"
+                                                                        ? { depth: { type: "string" } }
+                                                                        : command === "fields"
+                                                                            ? { type: { type: "string" }, constrained: { type: "boolean" } }
+                                                                            : command === "hooks"
                                                                                 ? {
-                                                                                    print: { type: "boolean" },
-                                                                                    stdin: { type: "boolean" },
-                                                                                    skill: { type: "boolean" },
-                                                                                    convert: { type: "boolean" },
-                                                                                    install: { type: "string" },
-                                                                                    repo: { type: "string" },
-                                                                                    "gh-account": { type: "string" },
+                                                                                    hub: { type: "string" },
+                                                                                    user: { type: "string" },
+                                                                                    password: { type: "string" },
                                                                                 }
-                                                                                : CONTENT_OPTIONS;
+                                                                                : command === "setup"
+                                                                                    ? {
+                                                                                        print: { type: "boolean" },
+                                                                                        stdin: { type: "boolean" },
+                                                                                        skill: { type: "boolean" },
+                                                                                        convert: { type: "boolean" },
+                                                                                        install: { type: "string" },
+                                                                                        repo: { type: "string" },
+                                                                                        "gh-account": { type: "string" },
+                                                                                    }
+                                                                                    : CONTENT_OPTIONS;
     const { values, positionals } = parse(options.argv, { ...GLOBAL_OPTIONS, ...extras });
     if (values["version"] === true)
         return emitText(io, await version(options.cwd));
@@ -956,6 +970,15 @@ async function dispatch(io, options) {
             return runComment(io, session, rest, {
                 text: await content(options, values),
             });
+        case "bridge":
+            return runBridge(io, session, rest, {
+                repo: asString(values["repo"]),
+                label: asString(values["label"]),
+                category: asString(values["category"]),
+                onAdopt: values["on-adopt"] === undefined ? undefined : values["on-adopt"] === true,
+                onClose: values["on-close"] === undefined ? undefined : values["on-close"] === true,
+                manual: values["manual"] === true ? true : undefined,
+            });
         case "issue":
             return runIssue(io, session, rest, {
                 type: asString(values["type"]),