@floh-solutions/pharos-cli 0.4.0 → 0.12.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAOA,OAAO,EAA8B,KAAK,QAAQ,EAAE,KAAK,EAAE,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,kEAAkE;IAClE,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,wBAAsB,SAAS,CAC7B,EAAE,EAAE,EAAE,EACN,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,QAAQ,CAAC,CA+EnB"}

package/dist/commands/create.js

@@ -0,0 +1,82 @@
+import { addParent, setField, setMarkdown, } from "@floh-solutions/ado-core";
+import { emit, emitText, usageError } from "../output.js";
+import { SHORTHAND } from "./update.js";
+export async function runCreate(io, session, positionals, options) {
+    const type = positionals[0];
+    if (type === undefined) {
+        throw usageError('Which type? `pharos create Task --title "…"`. Run `pharos types` for what this project has.');
+    }
+    if (options.title === undefined || options.title.trim() === "") {
+        throw usageError("A work item needs a --title.");
+    }
+    const ops = [setField("System.Title", options.title)];
+    for (const [flag, field] of Object.entries(SHORTHAND)) {
+        if (field === "System.Title")
+            continue;
+        const value = options[flag];
+        if (typeof value === "string" && value !== "")
+            ops.push(setField(field, value));
+    }
+    for (const pair of options.fields) {
+        const at = pair.indexOf("=");
+        if (at <= 0) {
+            throw usageError(`--field wants Name=value, not "${pair}".`);
+        }
+        ops.push(setField(pair.slice(0, at).trim(), pair.slice(at + 1)));
+    }
+    // Semicolon-joined, which is how Azure DevOps stores them. Passing an array
+    // silently stores the string "a,b" as one tag.
+    if (options.tags.length > 0)
+        ops.push(setField("System.Tags", options.tags.join("; ")));
+    if (options.description !== undefined && options.description !== "") {
+        ops.push(...setMarkdown("System.Description", options.description));
+    }
+    // Resolved rather than composed from the id, and it earns the extra GET
+    // twice over: `addParent` wants the parent's canonical url, and a parent that
+    // does not exist fails HERE with "no work item 9999" instead of arriving as
+    // an opaque 400 about a relation.
+    let parentTitle;
+    if (options.parent !== undefined) {
+        const parent = await session.client.workItems.get(options.parent);
+        const url = parent.url;
+        if (typeof url !== "string" || url === "") {
+            throw usageError(`Work item #${options.parent} did not report a url, so it cannot be linked as a parent.`);
+        }
+        ops.push(addParent(url));
+        const title = parent.fields?.["System.Title"];
+        if (typeof title === "string")
+            parentTitle = title;
+    }
+    if (session.previewOnly) {
+        return report(io, session, {
+            applied: false,
+            dryRun: true,
+            type,
+            title: options.title,
+            ...(options.parent === undefined ? {} : { parent: options.parent }),
+            operations: ops,
+        });
+    }
+    const created = await session.client.workItems.create(type, ops, {
+        suppressNotifications: true,
+    });
+    return report(io, session, {
+        applied: true,
+        id: created.id,
+        type,
+        title: options.title,
+        rev: created.rev,
+        url: created.url,
+        ...(options.parent === undefined
+            ? {}
+            : { parent: options.parent, parentTitle: parentTitle ?? null }),
+    });
+}
+function report(io, session, result) {
+    if (!session.pretty)
+        return emit(io, result);
+    const id = typeof result["id"] === "number" ? `#${result["id"]}` : "(not created)";
+    const parent = result["parent"] === undefined ? "" : ` under #${String(result["parent"])}`;
+    return emitText(io, `${id} · ${result.type}${parent} — ${result.title ?? ""}`);
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/create.js.map

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

package/dist/commands/detach.d.ts

@@ -0,0 +1,34 @@
+import { type ExitCode, type Io } from "../output.js";
+import { type Session } from "../session.js";
+/**
+ * `pharos detach <id> <url-or-guid>` — take a file off a work item.
+ *
+ * ## The gap this closes
+ *
+ * The CLI could attach a file from the beginning and could never un-attach one,
+ * so a mistake was permanent from a shell. The macOS app gained the verb in
+ * #642; this is the same operation.
+ *
+ * ## The trap, which `unlink` already solves
+ *
+ * **An attachment IS a relation**, so removing one is `op remove` on
+ * `/relations/{index}` — and Azure DevOps removes BY POSITION. An index worked
+ * out from a stale read cuts whatever has since moved into that slot, which
+ * could be a parent link or an artifact link, and the request still succeeds.
+ *
+ * So this reuses exactly what `unlink` uses: read the item, find the relation by
+ * identity, and send the removal under a `test` op on the revision it was found
+ * in. If the attachment is not there it REFUSES (exit 3) rather than guessing.
+ *
+ * An `AttachedFile` is a **resource** link — it has no target work item id — so
+ * it is matched on its URL. That is why the argument is the url `pharos task`
+ * prints, or the bare GUID it ends with.
+ *
+ * **The bytes are not deleted.** This removes the file FROM THE ITEM; the
+ * attachment itself stays where it was uploaded. That is Azure DevOps'
+ * behaviour, not a choice made here — and it is why this is recoverable by
+ * re-attaching the same url, which is also why it needs `--yes` and not a
+ * paragraph of warning.
+ */
+export declare function runDetach(io: Io, session: Session, positionals: readonly string[]): Promise<ExitCode>;
+//# sourceMappingURL=detach.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detach.d.ts","sourceRoot":"","sources":["../../src/commands/detach.ts"],"names":[],"mappings":"AAOA,OAAO,EAAuC,KAAK,QAAQ,EAAE,KAAK,EAAE,EAAE,MAAM,cAAc,CAAC;AAC3F,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAGtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,SAAS,CAC7B,EAAE,EAAE,EAAE,EACN,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,OAAO,CAAC,QAAQ,CAAC,CAwDnB"}

package/dist/commands/detach.js

@@ -0,0 +1,117 @@
+import { RelationNotFoundError, removeRelationPatch, } from "@floh-solutions/ado-core";
+import { emit, emitText, refusal, usageError } from "../output.js";
+import { approve } from "../session.js";
+import { workItemId } from "./update.js";
+/**
+ * `pharos detach <id> <url-or-guid>` — take a file off a work item.
+ *
+ * ## The gap this closes
+ *
+ * The CLI could attach a file from the beginning and could never un-attach one,
+ * so a mistake was permanent from a shell. The macOS app gained the verb in
+ * #642; this is the same operation.
+ *
+ * ## The trap, which `unlink` already solves
+ *
+ * **An attachment IS a relation**, so removing one is `op remove` on
+ * `/relations/{index}` — and Azure DevOps removes BY POSITION. An index worked
+ * out from a stale read cuts whatever has since moved into that slot, which
+ * could be a parent link or an artifact link, and the request still succeeds.
+ *
+ * So this reuses exactly what `unlink` uses: read the item, find the relation by
+ * identity, and send the removal under a `test` op on the revision it was found
+ * in. If the attachment is not there it REFUSES (exit 3) rather than guessing.
+ *
+ * An `AttachedFile` is a **resource** link — it has no target work item id — so
+ * it is matched on its URL. That is why the argument is the url `pharos task`
+ * prints, or the bare GUID it ends with.
+ *
+ * **The bytes are not deleted.** This removes the file FROM THE ITEM; the
+ * attachment itself stays where it was uploaded. That is Azure DevOps'
+ * behaviour, not a choice made here — and it is why this is recoverable by
+ * re-attaching the same url, which is also why it needs `--yes` and not a
+ * paragraph of warning.
+ */
+export async function runDetach(io, session, positionals) {
+    const id = workItemId(positionals[0], "Which work item? `pharos detach <id> <attachment>`.");
+    const given = positionals[1];
+    if (given === undefined) {
+        throw usageError(`Which attachment? \`pharos detach ${id} <url-or-guid>\` — `
+            + "`pharos task <id>` prints the url of every one.");
+    }
+    const item = await session.client.workItems.get(id, { expand: "relations" });
+    const relations = relationsOf(item);
+    const found = matchAttachment(relations, given);
+    if (found === undefined) {
+        throw refusal(`Work item ${id} has no attachment matching "${given}". `
+            + "Nothing was removed — removing by position instead of by identity would have cut a "
+            + "different link and reported success.", { id, given, attachments: attachmentSummary(relations) });
+    }
+    const decision = approve(io, session, {
+        what: `detach "${found.name}" from work item ${id}`,
+        would: {
+            id,
+            name: found.name,
+            url: found.url,
+            // Said in the preview because it is the thing somebody is deciding about:
+            // this takes the file OFF the item and does not delete it.
+            note: "The attachment itself stays in Azure DevOps — re-attaching the same url puts it back.",
+        },
+    });
+    if (decision !== undefined)
+        return decision;
+    let ops;
+    try {
+        ops = removeRelationPatch(relations, item.rev, { kind: "resource", url: found.url });
+    }
+    catch (error) {
+        if (error instanceof RelationNotFoundError) {
+            throw refusal(error.message, { id, given });
+        }
+        throw error;
+    }
+    await session.client.workItems.update(id, ops, { suppressNotifications: true });
+    if (session.pretty) {
+        emitText(io, `Removed ${found.name} from work item ${id}.`);
+        return 0;
+    }
+    emit(io, { applied: true, removed: true, id, name: found.name, url: found.url });
+    return 0;
+}
+/**
+ * Which attachment the argument names.
+ *
+ * The whole url or the bare GUID, because `pharos task` prints the url and a
+ * person reading it copies the last segment as often as the whole thing. Matched
+ * case-insensitively on the GUID: it is a GUID, and Azure DevOps is not
+ * consistent about its case between endpoints.
+ */
+function matchAttachment(relations, given) {
+    const wanted = given.trim().toLowerCase();
+    const guid = wanted.split("?")[0].split("/").pop() ?? wanted;
+    for (const relation of relations) {
+        if (relation.rel !== "AttachedFile")
+            continue;
+        const url = relation.url ?? "";
+        const theirGuid = url.split("?")[0].split("/").pop()?.toLowerCase() ?? "";
+        if (url.toLowerCase() === wanted || (guid !== "" && theirGuid === guid)) {
+            const name = relation.attributes?.["name"] ?? theirGuid;
+            return { url, name };
+        }
+    }
+    return undefined;
+}
+/** What IS attached, so a refusal can be acted on rather than only read. */
+function attachmentSummary(relations) {
+    return relations
+        .filter((relation) => relation.rel === "AttachedFile")
+        .map((relation) => ({
+        name: relation.attributes?.["name"] ?? "",
+        url: relation.url ?? "",
+    }));
+}
+function relationsOf(item) {
+    const relations = item.relations;
+    return relations ?? [];
+}
+//# sourceMappingURL=detach.js.map

package/dist/commands/detach.js.map

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

package/dist/commands/discover.d.ts

@@ -0,0 +1,66 @@
+import { type ExitCode, type Io } from "../output.js";
+import type { Session } from "../session.js";
+/**
+ * The three verbs that stop a session guessing: `download`, `types`, `whoami`.
+ *
+ * Grouped because they share a reason rather than an endpoint. Each one exists
+ * because its absence made a session **retry** — ask, be refused, re-read the
+ * error, ask again — and a retry loop is the most expensive thing a CLI can do
+ * to an agent, because it looks like progress.
+ *
+ * They also pass the scope test this repo now applies to every new verb (#590):
+ * a verb earns its place by adding a guard, a composition, or the agent
+ * contract, never by existing. `az devops` has no attachment command at all, no
+ * work-item-type discovery command, and no who-am-I. None of these is a
+ * re-implementation of something that already ships.
+ */
+export interface DownloadCommandOptions {
+    out: string | undefined;
+    name: string | undefined;
+}
+/**
+ * `pharos download <id-or-url>` — read an attachment back.
+ *
+ * **This closes a hole we opened ourselves.** `pharos attach` could put a file
+ * on a work item and nothing could take one off: the Azure DevOps MCP server's
+ * attachment tool was download-only, and removing that server in #585 removed
+ * the one thing it uniquely did. `ado-core` had `attachments.download` the whole
+ * time.
+ *
+ * It takes the **url or the GUID** on purpose. `pharos task` prints
+ * `attachments[].url`, so a session that has just read an item is holding a url
+ * — making it extract a GUID from that is asking it to parse, and parsing is
+ * where a session invents a wrong answer.
+ */
+export declare function runDownload(io: Io, session: Session, cwd: string, positionals: readonly string[], options: DownloadCommandOptions): Promise<ExitCode>;
+export interface TypesCommandOptions {
+    type: string | undefined;
+}
+/**
+ * `pharos types` — what `--state` and `--type` will actually accept.
+ *
+ * **The single biggest retry cause in this CLI.** `pharos update 225 --state
+ * Doing` fails if that work item type has no `Doing`, and a session with no way
+ * to ask simply guesses again. The data was already being fetched — the state
+ * catalogue was built for `query`'s openness in #582 and is memoised on the
+ * client — and nothing exposed it.
+ *
+ * The categories are shown, not just the names, because *"which of these means
+ * finished"* is a different question from *"which of these exist"*, and the
+ * second one alone is what makes somebody hard-code `Done`.
+ */
+export declare function runTypes(io: Io, session: Session, options: TypesCommandOptions): Promise<ExitCode>;
+/**
+ * `pharos whoami` — who `ADO_PAT` actually belongs to.
+ *
+ * Worth a verb because the answer is not always the person reading it. `@Me` in
+ * a WIQL query resolves server-side against the token owner, so a **shared or
+ * service token quietly makes "assigned to me" mean somebody else** — and
+ * nothing else in the CLI will ever mention it.
+ *
+ * It is also the cheapest possible "is this token alive": one GET, org-scoped,
+ * so it answers even when `ADO_PROJECT` is wrong — which is exactly the
+ * situation where somebody is trying to work out what is misconfigured.
+ */
+export declare function runWhoami(io: Io, session: Session): Promise<ExitCode>;
+//# sourceMappingURL=discover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/commands/discover.ts"],"names":[],"mappings":"AAKA,OAAO,EAA8B,KAAK,QAAQ,EAAE,KAAK,EAAE,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C;;;;;;;;;;;;;GAaG;AAIH,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAKD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,WAAW,CAC/B,EAAE,EAAE,EAAE,EACN,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,QAAQ,CAAC,CAuCnB;AAID,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,QAAQ,CAC5B,EAAE,EAAE,EAAE,EACN,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAuCnB;AAID;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAiB3E"}

package/dist/commands/discover.js

@@ -0,0 +1,128 @@
+import { writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { authenticatedIdentity } from "@floh-solutions/ado-core";
+import { emit, emitText, usageError } from "../output.js";
+/** `wit/attachments/{guid}` — the tail of what `pharos task` prints. */
+const ATTACHMENT_GUID = /attachments\/([0-9a-f-]{36})/i;
+/**
+ * `pharos download <id-or-url>` — read an attachment back.
+ *
+ * **This closes a hole we opened ourselves.** `pharos attach` could put a file
+ * on a work item and nothing could take one off: the Azure DevOps MCP server's
+ * attachment tool was download-only, and removing that server in #585 removed
+ * the one thing it uniquely did. `ado-core` had `attachments.download` the whole
+ * time.
+ *
+ * It takes the **url or the GUID** on purpose. `pharos task` prints
+ * `attachments[].url`, so a session that has just read an item is holding a url
+ * — making it extract a GUID from that is asking it to parse, and parsing is
+ * where a session invents a wrong answer.
+ */
+export async function runDownload(io, session, cwd, positionals, options) {
+    const given = positionals[0];
+    if (given === undefined) {
+        throw usageError("Which attachment? `pharos download <id-or-url>` — the url is what `pharos task` prints "
+            + "under attachments.");
+    }
+    const id = ATTACHMENT_GUID.exec(given)?.[1] ?? given;
+    if (!/^[0-9a-f-]{36}$/i.test(id)) {
+        throw usageError(`"${given}" is neither an attachment GUID nor a url containing one.`, { given, expected: "a GUID, or .../_apis/wit/attachments/<guid>" });
+    }
+    const bytes = await session.client.attachments.download(id, {
+        ...(options.name === undefined ? {} : { fileName: options.name }),
+    });
+    // No `--out` writes nothing and says how big it is. Printing binary to stdout
+    // would corrupt the JSON contract every other verb keeps, and an agent that
+    // piped it somewhere would get a mangled file rather than an error.
+    if (options.out === undefined) {
+        return emit(io, {
+            attachmentId: id,
+            bytes: bytes.length,
+            saved: null,
+            hint: "Pass --out <path> to write it. Nothing is printed to stdout: these are raw bytes.",
+        });
+    }
+    const path = resolve(cwd, options.out);
+    await writeFile(path, bytes);
+    return session.pretty
+        ? emitText(io, `${bytes.length} bytes → ${path}`)
+        : emit(io, { attachmentId: id, bytes: bytes.length, saved: path });
+}
+/**
+ * `pharos types` — what `--state` and `--type` will actually accept.
+ *
+ * **The single biggest retry cause in this CLI.** `pharos update 225 --state
+ * Doing` fails if that work item type has no `Doing`, and a session with no way
+ * to ask simply guesses again. The data was already being fetched — the state
+ * catalogue was built for `query`'s openness in #582 and is memoised on the
+ * client — and nothing exposed it.
+ *
+ * The categories are shown, not just the names, because *"which of these means
+ * finished"* is a different question from *"which of these exist"*, and the
+ * second one alone is what makes somebody hard-code `Done`.
+ */
+export async function runTypes(io, session, options) {
+    const catalog = await session.client.workItemTypes.states();
+    const wanted = options.type;
+    const entries = [...catalog.byType]
+        .filter(([name]) => wanted === undefined || name.toLowerCase() === wanted.toLowerCase())
+        .map(([name, states]) => ({ type: name, open: states.open, terminal: states.terminal }));
+    if (wanted !== undefined && entries.length === 0) {
+        throw usageError(`No work item type called "${wanted}" in this project.`, {
+            types: [...catalog.byType.keys()],
+        });
+    }
+    const result = {
+        types: entries,
+        // The flat view, which is what a --state value is checked against.
+        open: catalog.open,
+        terminal: catalog.terminal,
+        ambiguous: catalog.ambiguous,
+        ...(catalog.ambiguous.length === 0
+            ? {}
+            : {
+                note: `${catalog.ambiguous.join(", ")} mean different things on different types, so a state `
+                    + "name alone does not say whether an item is finished.",
+            }),
+    };
+    if (!session.pretty)
+        return emit(io, result);
+    const lines = [];
+    for (const entry of entries) {
+        lines.push(entry.type);
+        lines.push(`  open:     ${entry.open.join(", ") || "—"}`);
+        lines.push(`  finished: ${entry.terminal.join(", ") || "—"}`);
+    }
+    if (catalog.ambiguous.length > 0)
+        lines.push("", `ambiguous: ${catalog.ambiguous.join(", ")}`);
+    return emitText(io, lines.join("\n"));
+}
+// MARK: - whoami
+/**
+ * `pharos whoami` — who `ADO_PAT` actually belongs to.
+ *
+ * Worth a verb because the answer is not always the person reading it. `@Me` in
+ * a WIQL query resolves server-side against the token owner, so a **shared or
+ * service token quietly makes "assigned to me" mean somebody else** — and
+ * nothing else in the CLI will ever mention it.
+ *
+ * It is also the cheapest possible "is this token alive": one GET, org-scoped,
+ * so it answers even when `ADO_PROJECT` is wrong — which is exactly the
+ * situation where somebody is trying to work out what is misconfigured.
+ */
+export async function runWhoami(io, session) {
+    const me = await authenticatedIdentity(session.client.http);
+    const result = {
+        id: me.id,
+        displayName: me.displayName,
+        uniqueName: me.uniqueName ?? null,
+        organization: session.client.organization,
+        project: session.client.project ?? null,
+        note: "This is who ADO_PAT belongs to. @Me in a query resolves to this identity, and every write "
+            + "is attributed to it.",
+    };
+    return session.pretty
+        ? emitText(io, `${me.displayName}${me.uniqueName === undefined ? "" : ` <${me.uniqueName}>`}`)
+        : emit(io, result);
+}
+//# sourceMappingURL=discover.js.map

package/dist/commands/discover.js.map

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

package/dist/commands/hooks.d.ts

@@ -0,0 +1,24 @@
+import { type ExitCode, type Io } from "../output.js";
+import { type Session } from "../session.js";
+/**
+ * `pharos hooks …` — the service hook subscriptions that make realtime work.
+ *
+ * These are the one piece of setup nobody is told about. Without them realtime
+ * silently does not happen and the app reports "synced 4s ago", which is true,
+ * because polling carries on. You have to already know the feature exists to
+ * notice it is missing — so the first job of this command is simply to make the
+ * state visible.
+ *
+ * There is no MCP tool for any of this, and the wiki subscription **cannot be
+ * created in the Azure DevOps web UI at all**: the repository picker hides wiki
+ * repositories, so the only options a browser offers are `[Any]` or the code
+ * repo. This is the only correct route.
+ */
+interface HooksInput {
+    hub?: string | undefined;
+    user?: string | undefined;
+    password?: string | undefined;
+}
+export declare function runHooks(io: Io, session: Session, positionals: readonly string[], input: HooksInput): Promise<ExitCode>;
+export {};
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/commands/hooks.ts"],"names":[],"mappings":"AAOA,OAAO,EAAoB,KAAK,QAAQ,EAAE,KAAK,EAAE,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAEtD;;;;;;;;;;;;;GAaG;AAEH,UAAU,UAAU;IAClB,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,wBAAsB,QAAQ,CAC5B,EAAE,EAAE,EAAE,EACN,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,QAAQ,CAAC,CAmBnB"}