@bluewombat/manager-kit 0.1.0

package/README.md

@@ -0,0 +1,120 @@
+# Manager kit
+
+The FeatureManager plugin contract. Types only — no runtime, no dependency, no
+Transformer. A package that wants mason to drive its tracker imports this and
+nothing else. Contract: [SPECS.md](./SPECS.md).
+
+## Stack
+
+Repository stack — TypeScript, Node 24.20, Biome, `node:test`. See [docs/DEVELOPMENT.md](../../../docs/DEVELOPMENT.md).
+
+## Setup
+
+From the repository root:
+
+```bash
+nvm use
+npm install
+```
+
+## Commands
+
+| Task      | Command          |
+| --------- | ---------------- |
+| Lint      | `npm run lint`   |
+| Format    | `npm run format` |
+| Typecheck | `npm run tsc`    |
+| Test      | `npm test`       |
+| Build     | `npm run build`  |
+
+## Write a manager
+
+One export is required: `createManager`. Host calls it once at boot and drives
+the `ManagerPort` it returns.
+
+```ts
+import {
+  type CreateManagerResult,
+  type ManagerContext,
+  rejectUnknownOptions,
+  stringOption,
+} from "@bluewombat/manager-kit";
+
+const KNOWN_OPTIONS = ["board", "tokenEnv"] as const;
+
+export function createManager(context: ManagerContext): CreateManagerResult {
+  const known = rejectUnknownOptions(context.options, KNOWN_OPTIONS);
+  if (!known.ok) {
+    return known;
+  }
+  const board = stringOption(context.options, "board");
+  if (!board.ok) {
+    return board;
+  }
+  if (board.value === undefined) {
+    return { ok: false, reason: 'managerOptions "board" is required.' };
+  }
+  return { ok: true, manager: openMyTracker(board.value, context) };
+}
+```
+
+Then point a config at it:
+
+```json
+{ "manager": "@acme/manager-jira", "managerOptions": { "board": "APP" } }
+```
+
+`checkManager` is optional. Export it and `mason doctor` prints your findings
+under the shared ones. It must not use the network.
+
+`setupManager` is optional too, and is the one hook that may call the tracker
+and write to it — `mason setup` plans, `mason setup --apply` performs. Keep it
+idempotent.
+
+`questionsManager` is optional as well. Return the questions `mason init`
+should ask, and Host fills `managerOptions` from the answers:
+
+```ts
+export function questionsManager(): ManagerQuestion[] {
+  return [
+    {
+      key: "board",
+      prompt: "Board key",
+      required: true,
+      parse: (answer) =>
+        /^[A-Z]+$/.test(answer)
+          ? { ok: true, value: answer }
+          : { ok: false, reason: `"${answer}" is not a board key.` },
+    },
+  ];
+}
+```
+
+Your package is offered by `mason init` when its `package.json` keywords
+contain `mason-manager`.
+
+`probe` is optional. Export it when the tracker can answer whether an intention
+Host already holds is still there — a poll cannot see a deletion. `gone` is
+abandon; `unavailable` is not.
+
+`scaffoldManager` is optional. Export it and `mason init --manager this-package`
+fills `managerOptions` from it. A tracker field (`repo`, a board id) belongs
+there, not as a Host flag.
+
+`referenceManager` is optional, and only for a manager whose Authority holds
+the reference work line. It returns where that reference is, as a record Host
+copies through unread; the Isolation strategy the Project names is what reads
+it, strictly, so agree on the words with that package (`remote` and `branch`
+for `@bluewombat/isolation-git`). With it, `mason init` asks nothing about the
+work line and Host keeps its own copy at `<home>/work-line` (`.mason` by default).
+
+## Layout
+
+```
+SPECS.md   the contract a manager package implements
+README.md  how to build it, and how to write a manager
+src/
+  port.ts     ManagerPort and the values it exchanges
+  module.ts   ManagerContext, ManagerModule, Finding
+  options.ts  readers for one managerOptions object
+```

package/SPECS.md

@@ -0,0 +1,130 @@
+# Manager kit
+
+A contract, not a Transformer. It holds no behaviour: it is the type boundary
+between Host and one FeatureManager, so a third party can write a tracker
+integration without depending on Host and without Host depending on them.
+
+## 1. Job
+
+```
+  Host                          manager-kit                        a manager package
+  ----                          --------                        -----------------
+  reads a specifier             ManagerPort                     implements createManager
+  hands over managerOptions     ManagerContext                  reads its own options
+  asks doctor for findings      Finding                         may implement checkManager
+  asks init for a scaffold      ManagerScaffold                 may implement scaffoldManager
+  asks init its questions       ManagerQuestion                 may implement questionsManager
+  asks setup for a plan         SetupStep                       may implement setupManager
+  asks where the reference is   Record<string, unknown>         may implement referenceManager
+                            ←   nothing at runtime
+```
+
+**In:** nothing. **Out:** types, and five pure option readers.
+
+## 2. The Port
+
+| Member         | Required | Job                                                                                                                                          |
+| -------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| `listen`       | yes      | Drain the tracker since a Cursor. Returns an outcome and ordered Deliveries                                                                  |
+| `adapt`        | yes      | One raw payload → a FeatureStandard, or `invalid` / `unavailable` / `interrupted`                                                            |
+| `report`       | yes      | One semantic Event onto the tracker. `false` when it could not be written                                                                    |
+| `signalsReady` | no       | Whether this payload says a human unblocked an escalated Feature (a label, a status)                                                         |
+| `clearReady`   | no       | Take that signal back once it has been acted on. Left in place it resumes the Feature again on every pass, and an escalation freezes nothing |
+| `submit`       | no       | Offer an assembled feature to the Authority. Returns an opaque reference                                                                     |
+| `fold`         | no       | Have the Authority take an accepted Submission into the work line                                                                            |
+| `probe`        | no       | Whether the intention this key named is still on the tracker (`present` / `gone` / `unavailable` / `interrupted`)                            |
+
+The two Authority methods, `submit` and `fold`, come as a set. A manager that declares none has no
+Authority, and an assembled feature is folded into WorkLineStable directly — the
+way it was before any of this existed. `report` may carry an `eventId`: an Event
+that states a fact rather than a change is written once, however many passes see
+it.
+
+`probe` exists because a poll cannot see an absence: a deleted item is missing
+from every later page and never becomes a Delivery. Host already holds the keys.
+`gone` is abandon, the same intent as a `cancel` delivery. `unavailable` is not
+abandon — a missed read must not cancel work. Host only calls `probe` after a
+listen that reached the source, so a token that can no longer list the tracker
+is not read as every Feature disappearing. A manager that cannot answer omits
+the method; Host does not invent an absence.
+
+Host never reads a payload itself. A tracker's issue number, label, or status
+is recoverable from the `key` the manager minted, so nothing tracker-shaped
+crosses the Port.
+
+## 3. The module
+
+`createManager(context)` returns `{ ok: true, manager }` or `{ ok: false, reason }`.
+It must not throw for a bad option: the reason is what the user reads.
+
+| Context field   | Content                                                |
+| --------------- | ------------------------------------------------------ |
+| `options`       | The config's `managerOptions`, unread by Host          |
+| `durationMs`    | Wall clock every call of this manager must stay inside |
+| `interruptFlag` | Flips on SIGINT / SIGTERM; long calls must stop        |
+| `configDir`     | Directory a relative option path resolves against      |
+| `env`           | Where a secret named by an option is read from         |
+
+A secret is read by the manager, from `context.env`, never by Host and never
+from the config file.
+
+`checkManager(context)` is optional and returns `Finding[]`. `ok`, `warn`,
+`fail`; only `fail` makes `mason doctor` exit non-zero. It must answer the
+same offline as online.
+
+`questionsManager(context)` is optional and returns `ManagerQuestion[]`: the
+wording, the fallback, and the validation of each `managerOptions` key a human
+should be asked for. It declares them — Host reads the terminal, so no manager
+ever touches stdin. A question whose key already has a value is skipped.
+
+`referenceManager(context)` is optional and returns where the Authority keeps
+the reference work line, or `undefined`. Host does not read it: the Isolation
+strategy named by `workLine.isolation` does, strictly, and refuses a key it does
+not know before a run writes anything. Only a manager that also declares
+`submit` and `fold` has a reference to name — with no Authority the work line is
+the operator's directory, whatever this returns. Offline.
+
+`setupManager(context, { apply })` is optional and is the **only hook allowed
+to reach the tracker over the network and to write to it**. The hooks form one
+progression:
+
+| Hook               | Command                       | Network | Writes                                           |
+| ------------------ | ----------------------------- | ------- | ------------------------------------------------ |
+| `questionsManager` | `mason init`                  | no      | nothing — it only declares                       |
+| `scaffoldManager`  | `mason init`                  | no      | the local config file                            |
+| `referenceManager` | `mason init`, `doctor`, `run` | no      | nothing — the strategy fetches the copy on `run` |
+| `checkManager`     | `mason doctor`                | no      | nothing                                          |
+| `setupManager`     | `mason setup`                 | yes     | the tracker, on `--apply`                        |
+| `createManager`    | `mason run`                   | yes     | the tracker                                      |
+
+With `apply` false it reports a plan and changes nothing: a step is `satisfied`
+or `missing`. With `apply` true a step it fixed is `applied`. A step nothing
+here can fix is `blocked`, and `ok` is false. It must be idempotent — a second
+call with `apply` true reports everything `satisfied` and writes nothing.
+
+`scaffoldManager(context)` is optional and returns `{ options, nextSteps, prepare? }`.
+`mason init` copies `options` into `managerOptions` (flag `--manager-option`
+wins per key), prints `nextSteps`, and calls `prepare(cwd)` so a directory
+Source can exist before the first run. Host does not grow a flag for a
+tracker's fields.
+
+## 4. Option readers
+
+`stringOption`, `stringArrayOption`, `intOption`, `booleanOption`,
+`rejectUnknownOptions`. Values arrive either from JSON (already typed) or from
+repeated `--manager-option key=value` flags (always strings), so every reader
+accepts the string spelling of its type, and a repeated flag key arrives as an
+array.
+
+`rejectUnknownOptions` exists because a silently ignored typo leaves a manager
+running with a default the user thought they had changed.
+
+## 5. Acceptance
+
+1. A module exporting only `createManager` loads and drives a full run.
+2. A reader given the string spelling of a number or a boolean returns the value.
+3. A misspelled option key is refused, and the message lists the known keys.
+4. `EVENT_NAMES` is the same list as the `EventName` union, at runtime.
+5. `probe` is optional. `gone` is abandon; `unavailable` is not.
+
+How to build and write a manager: [README.md](./README.md).

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { CreateManagerResult, Finding, FindingLevel, ManagerContext, ManagerModule, ManagerQuestion, ManagerScaffold, SetupResult, SetupStep, } from "./module.js";
+export type { OptionResult, Options, } from "./options.js";
+export { booleanOption, intOption, rejectUnknownOptions, stringArrayOption, stringOption, } from "./options.js";
+export type { AdaptResult, Delivery, EventFields, EventName, FeatureStandard, FoldResult, ListenResult, ManagerPort, ProbeResult, ReportInput, SubmissionRequest, SubmissionResult, } from "./port.js";
+export { EVENT_NAMES } from "./port.js";
+export { PRODUCT } from "./product.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,OAAO,EACP,YAAY,EACZ,cAAc,EACd,aAAa,EACb,eAAe,EACf,eAAe,EACf,WAAW,EACX,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,YAAY,EACZ,OAAO,GACR,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,aAAa,EACb,SAAS,EACT,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,WAAW,EACX,QAAQ,EACR,WAAW,EACX,SAAS,EACT,eAAe,EACf,UAAU,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { booleanOption, intOption, rejectUnknownOptions, stringArrayOption, stringOption, } from "./options.js";
+export { EVENT_NAMES } from "./port.js";
+export { PRODUCT } from "./product.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,aAAa,EACb,SAAS,EACT,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,GACb,MAAM,cAAc,CAAC;AAetB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/module.d.ts

@@ -0,0 +1,126 @@
+import type { ManagerPort } from "./port.js";
+/**
+ * What Host hands a manager package at boot. `options` is the config file's
+ * `managerOptions` object, unread: Host never validates a tracker's fields.
+ */
+export type ManagerContext = {
+    options: Record<string, unknown>;
+    /** Wall clock every call of this manager must stay inside. */
+    durationMs: number;
+    /** Flips on SIGINT / SIGTERM. Long calls must stop when it is true. */
+    interruptFlag: {
+        interrupted: boolean;
+    };
+    /** Directory a relative option path resolves against (the config file's). */
+    configDir: string;
+    /** Where a secret named by an option is read from. Never logged by Host. */
+    env: Record<string, string | undefined>;
+};
+export type CreateManagerResult = {
+    ok: true;
+    manager: ManagerPort;
+} | {
+    ok: false;
+    reason: string;
+};
+export type FindingLevel = "ok" | "warn" | "fail";
+/** One line of `mason doctor`. `fail` is what makes the command exit non-zero. */
+export type Finding = {
+    level: FindingLevel;
+    label: string;
+    detail?: string;
+};
+/**
+ * What `mason init` asks a manager for. Host writes the config and the slot
+ * stubs; the manager fills `managerOptions` and any directories it needs.
+ * Nothing here is tracker-shaped: a GitHub repo or a Linear team lives in
+ * `options`, in words the manager chose.
+ */
+export type ManagerScaffold = {
+    options: Record<string, unknown>;
+    nextSteps: string[];
+    prepare?(cwd: string): void;
+};
+/**
+ * One thing `mason init` asks a human, to fill one `managerOptions` key.
+ *
+ * The manager owns the wording and the validation — "owner/name" is GitHub's
+ * vocabulary, not Host's. Host owns the terminal: it reads the line, and hands
+ * it back here to be turned into a value.
+ */
+export type ManagerQuestion = {
+    /** The `managerOptions` key the answer fills. */
+    key: string;
+    /** One line, no trailing colon: `GitHub repository (owner/name)`. */
+    prompt: string;
+    /** Offered on the line, and used when the answer is empty. */
+    fallback?: string;
+    /** An empty answer with no fallback is refused, and the question repeats. */
+    required?: boolean;
+    /** Turns the typed line into the option value, or says what is wrong with it. */
+    parse?(answer: string): {
+        ok: true;
+        value: unknown;
+    } | {
+        ok: false;
+        reason: string;
+    };
+};
+/**
+ * One thing the tracker needs before a run — a label that must exist, a
+ * permission the token must hold.
+ *
+ * `satisfied` it already was; `missing` it is not there yet and `apply` was
+ * false; `applied` this call created it; `blocked` nothing here can fix it.
+ */
+export type SetupStep = {
+    /** Stable across runs, so two reports can be compared: `label:mason`. */
+    id: string;
+    summary: string;
+    state: "satisfied" | "missing" | "applied" | "blocked";
+    detail?: string;
+};
+export type SetupResult = {
+    /** False when a step is `blocked`. A `missing` step in a plan is not a failure. */
+    ok: boolean;
+    steps: SetupStep[];
+};
+/**
+ * The module shape `manager` in the config resolves to. A package that exports
+ * `createManager` is a manager; nothing else is required of it.
+ */
+export type ManagerModule = {
+    createManager(context: ManagerContext): CreateManagerResult | Promise<CreateManagerResult>;
+    /** Optional. What `mason doctor` reports for this manager. Must not use the network. */
+    checkManager?(context: ManagerContext): Finding[] | Promise<Finding[]>;
+    /** Optional. What `mason init` writes into `managerOptions`. */
+    scaffoldManager?(context: ManagerContext): ManagerScaffold | Promise<ManagerScaffold>;
+    /**
+     * Optional. What `mason init` asks when it runs interactively, in order.
+     * Declaring the questions rather than asking them keeps every read of the
+     * terminal in Host, and every word about the tracker here.
+     */
+    questionsManager?(context: ManagerContext): ManagerQuestion[] | Promise<ManagerQuestion[]>;
+    /**
+     * Optional. What `mason setup` does. The only hook allowed to reach the
+     * tracker over the network and to write to it.
+     *
+     * With `apply` false it reports a plan and changes nothing — that is the
+     * default, because creating labels on somebody's repository is not a side
+     * effect to have by accident. It must be idempotent: a second call with
+     * `apply` true reports every step `satisfied` and writes nothing.
+     */
+    setupManager?(context: ManagerContext, input: {
+        apply: boolean;
+    }): SetupResult | Promise<SetupResult>;
+    /**
+     * Optional. Where the Authority keeps the reference work line.
+     *
+     * Opaque here, like `options`: the words are the Isolation strategy's, and
+     * Host copies them through unread. Declaring it lets Host keep its own copy
+     * of the work line under the ledger's roof instead of asking the operator to
+     * maintain one. A manager with no Authority has no reference to name.
+     */
+    referenceManager?(context: ManagerContext): Record<string, unknown> | undefined;
+};
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

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

package/dist/module.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":""}

package/dist/options.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Readers for one `managerOptions` object.
+ *
+ * Values reach a manager either from JSON (already typed) or from repeated
+ * `--manager-option key=value` flags (always strings), so a reader that wants a
+ * number or a boolean accepts the string spelling of one.
+ */
+export type OptionResult<T> = {
+    ok: true;
+    value: T | undefined;
+} | {
+    ok: false;
+    reason: string;
+};
+export type Options = Record<string, unknown>;
+export declare function stringOption(options: Options, key: string): OptionResult<string>;
+/** A JSON array of strings, or one string from a single `--manager-option`. */
+export declare function stringArrayOption(options: Options, key: string): OptionResult<string[]>;
+export declare function intOption(options: Options, key: string, min: number, max: number): OptionResult<number>;
+export declare function booleanOption(options: Options, key: string): OptionResult<boolean>;
+/**
+ * A misspelled option is silently ignored otherwise, and the manager then runs
+ * with a default the user thought they had changed.
+ */
+export declare function rejectUnknownOptions(options: Options, known: readonly string[]): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,GAAG,SAAS,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjG,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9C,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAShF;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,CAcvF;AAED,wBAAgB,SAAS,CACvB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,YAAY,CAAC,MAAM,CAAC,CAatB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAYlF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAW9C"}

package/dist/options.js

@@ -0,0 +1,77 @@
+/**
+ * Readers for one `managerOptions` object.
+ *
+ * Values reach a manager either from JSON (already typed) or from repeated
+ * `--manager-option key=value` flags (always strings), so a reader that wants a
+ * number or a boolean accepts the string spelling of one.
+ */
+export function stringOption(options, key) {
+    const value = options[key];
+    if (value === undefined) {
+        return { ok: true, value: undefined };
+    }
+    if (typeof value !== "string" || value.trim().length === 0) {
+        return { ok: false, reason: `managerOptions "${key}" must be a non-empty string.` };
+    }
+    return { ok: true, value };
+}
+/** A JSON array of strings, or one string from a single `--manager-option`. */
+export function stringArrayOption(options, key) {
+    const value = options[key];
+    if (value === undefined) {
+        return { ok: true, value: undefined };
+    }
+    if (typeof value === "string") {
+        return value.trim().length === 0
+            ? { ok: false, reason: `managerOptions "${key}" must not be empty.` }
+            : { ok: true, value: [value] };
+    }
+    if (!Array.isArray(value) || value.some((entry) => typeof entry !== "string")) {
+        return { ok: false, reason: `managerOptions "${key}" must be an array of strings.` };
+    }
+    return { ok: true, value: value };
+}
+export function intOption(options, key, min, max) {
+    const value = options[key];
+    if (value === undefined) {
+        return { ok: true, value: undefined };
+    }
+    const parsed = typeof value === "string" && /^-?\d+$/.test(value.trim()) ? Number(value) : value;
+    if (typeof parsed !== "number" || !Number.isSafeInteger(parsed) || parsed < min || parsed > max) {
+        return {
+            ok: false,
+            reason: `managerOptions "${key}" must be an integer between ${min} and ${max}.`,
+        };
+    }
+    return { ok: true, value: parsed };
+}
+export function booleanOption(options, key) {
+    const value = options[key];
+    if (value === undefined) {
+        return { ok: true, value: undefined };
+    }
+    if (typeof value === "boolean") {
+        return { ok: true, value };
+    }
+    if (value === "true" || value === "false") {
+        return { ok: true, value: value === "true" };
+    }
+    return { ok: false, reason: `managerOptions "${key}" must be true or false.` };
+}
+/**
+ * A misspelled option is silently ignored otherwise, and the manager then runs
+ * with a default the user thought they had changed.
+ */
+export function rejectUnknownOptions(options, known) {
+    const allowed = new Set(known);
+    for (const key of Object.keys(options)) {
+        if (!allowed.has(key)) {
+            return {
+                ok: false,
+                reason: `managerOptions has unknown key "${key}". Known: ${[...allowed].sort().join(", ")}.`,
+            };
+        }
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

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

package/dist/port.d.ts

@@ -0,0 +1,191 @@
+/**
+ * What Host asks of one FeatureManager, whatever the tracker behind it.
+ *
+ * Nothing here names GitHub, an issue, or a label: a manager package owns its
+ * tracker's vocabulary and hands Host these shapes only.
+ */
+/**
+ * Every semantic Event, as values. A manager that mirrors states onto the
+ * tracker needs the list at runtime, not only as a type.
+ */
+export declare const EVENT_NAMES: readonly ["invalid", "accepted", "planned", "progress", "escalated", "escalation_reminder", "resumed", "submitted", "done", "cancelled", "reject_late"];
+export type EventName = (typeof EVENT_NAMES)[number];
+export type EventFields = {
+    /** One sentence a reader gets first, under the heading and before any field. */
+    summary?: string;
+    reason?: string;
+    stage?: "plan" | "unit" | "integrating" | "submitting" | "merging";
+    trace?: string;
+    counters?: Record<string, string>;
+    plan?: string;
+    priority?: number;
+    unit?: string;
+    remaining?: number;
+    state?: string;
+    resume_point?: "planning" | "running" | "integrating";
+    reference?: string;
+    /** On `done`: the work line's own name for the fold, when the Authority gave one. Opaque. */
+    integration_reference?: string;
+    workspace_ref?: string;
+};
+export type FeatureStandard = {
+    key: string;
+    manager: string;
+    external_id: string;
+    intent: "upsert" | "ready" | "cancel";
+    project: string;
+    title?: string;
+    intention?: string;
+    priority: number;
+    source?: {
+        ref?: string;
+        revision?: string;
+    };
+    fingerprint: string;
+    normalized_at: string;
+};
+/** One raw intention, plus the Cursor Host saves once it is handled. */
+export type Delivery = {
+    cursor: string;
+    payload: Record<string, unknown>;
+};
+export type AdaptResult = {
+    outcome: "converted";
+    feature: FeatureStandard;
+} | {
+    outcome: "invalid";
+    invalid: {
+        code: string;
+        reason: string;
+    };
+    key: string;
+    project: string;
+    /**
+     * Hash of what a human wrote — not of what the tracker does to the
+     * intention afterwards. Reporting an intention invalid writes to the
+     * tracker, and that write delivers it again; the same fingerprint says
+     * nothing changed, so nothing is said again.
+     */
+    fingerprint: string;
+} | {
+    outcome: "unavailable";
+} | {
+    outcome: "interrupted";
+};
+export type ReportInput = {
+    event: EventName;
+    key: string;
+    project: string;
+    fields: EventFields;
+    /**
+     * Names this Event so it is reported once.
+     *
+     * A feature is driven again on every pass while it waits, and an Event that
+     * only says what already happened must not be said twice. A manager that
+     * keeps a thread skips an id it has already written.
+     */
+    eventId?: string;
+};
+export type ListenResult = {
+    outcome: string;
+    deliveries: Delivery[];
+};
+/**
+ * A Submission: an assembled feature placed where an Authority can judge it.
+ *
+ * `ref` is what the system published and `target` the work line it is offered
+ * to — both opaque here. The Authority reads them; this contract does not.
+ */
+export type SubmissionRequest = {
+    key: string;
+    project: string;
+    ref: string;
+    target: string;
+    title?: string;
+    intention?: string;
+    /** The Plan's Subtasks, in order — what the Submission is made of. */
+    steps?: string[];
+    /**
+     * How the delivered work describes itself, when the Project has a say — a
+     * subject line and a body. What the Authority makes of them is its own: a
+     * fold's message, a pull request's text, a comment. Absent: the title and
+     * the intention, as the human wrote them.
+     */
+    description?: {
+        subject: string;
+        body?: string;
+    };
+};
+export type SubmissionResult = {
+    outcome: "submitted";
+    reference: string;
+} | {
+    outcome: "refused";
+    reason: string;
+} | {
+    outcome: "unavailable";
+};
+export type FoldResult = 
+/** `reference`: the work line's own name for the fold, when the Authority can give one. Opaque. */
+{
+    outcome: "folded";
+    reference?: string;
+} | {
+    outcome: "conflict";
+    reason: string;
+} | {
+    outcome: "unavailable";
+};
+/**
+ * Whether the intention this key named is still on the tracker.
+ *
+ * A poll cannot see an absence: a deleted item simply never appears again.
+ * Host asks this of keys it already holds. `gone` is abandon — the same
+ * intent as a `cancel` delivery. `unavailable` is not: a missed read must
+ * not abandon work.
+ */
+export type ProbeResult = "present" | "gone" | "unavailable" | "interrupted";
+export type ManagerPort = {
+    listen(input: {
+        since?: string;
+    }): Promise<ListenResult>;
+    adapt(payload: Record<string, unknown>): Promise<AdaptResult>;
+    report(input: ReportInput): Promise<boolean>;
+    /**
+     * Whether this raw payload says a human unblocked an escalated Feature.
+     * A poll snapshot carries no `ready` edge, so the manager reads its own
+     * signal (a label, a status, a field) and Host stays tracker-agnostic.
+     */
+    signalsReady?(payload: Record<string, unknown>): boolean;
+    /**
+     * Take the resume signal back once it has been acted on.
+     *
+     * The signal is an instruction, not a state. Left where a human put it, it
+     * resumes the Feature again on every pass, and an escalation that is supposed
+     * to freeze the work freezes nothing.
+     */
+    clearReady?(key: string): Promise<void>;
+    /**
+     * Offer an assembled feature to the Authority.
+     *
+     * Both Submission methods come as a pair: a manager that declares neither has
+     * no Authority, and the work is folded into WorkLineStable directly, as it was
+     * before any of this existed. Whether the Submission is good is not asked
+     * here — that is a Gate's answer.
+     */
+    submit?(input: SubmissionRequest): Promise<SubmissionResult>;
+    /** Have the Authority fold a Submission the Gates accepted into the work line. */
+    fold?(input: {
+        reference: string;
+    }): Promise<FoldResult>;
+    /**
+     * Whether the intention this key named is still on the tracker.
+     *
+     * Optional: a manager that cannot answer (a directory of files, a tracker
+     * without a fetch-by-id) omits it, and Host does not invent an absence.
+     * Host only asks after a listen that reached the source, so a dead token
+     * is not read as a mass abandon.
+     */
+    probe?(key: string): Promise<ProbeResult>;
+};
+//# sourceMappingURL=port.d.ts.map

package/dist/port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../src/port.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,eAAO,MAAM,WAAW,yJAYd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,MAAM,MAAM,WAAW,GAAG;IACxB,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,aAAa,CAAC;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6FAA6F;IAC7F,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,wEAAwE;AACxE,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,WAAW,GACnB;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GAClD;IACE,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IAAE,OAAO,EAAE,aAAa,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,aAAa,CAAA;CAAE,CAAC;AAE/B,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,SAAS,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,QAAQ,EAAE,CAAC;CACxB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;;;OAKG;IACH,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GACxB;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,OAAO,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,OAAO,EAAE,aAAa,CAAA;CAAE,CAAC;AAE/B,MAAM,MAAM,UAAU;AACpB,mGAAmG;AACjG;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,OAAO,EAAE,aAAa,CAAA;CAAE,CAAC;AAE/B;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,aAAa,GAAG,aAAa,CAAC;AAE7E,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,CAAC,KAAK,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACzD,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9D,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C;;;;OAIG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;IACzD;;;;;;OAMG;IACH,UAAU,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC;;;;;;;OAOG;IACH,MAAM,CAAC,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC7D,kFAAkF;IAClF,IAAI,CAAC,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACzD;;;;;;;OAOG;IACH,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC3C,CAAC"}

package/dist/port.js

@@ -0,0 +1,24 @@
+/**
+ * What Host asks of one FeatureManager, whatever the tracker behind it.
+ *
+ * Nothing here names GitHub, an issue, or a label: a manager package owns its
+ * tracker's vocabulary and hands Host these shapes only.
+ */
+/**
+ * Every semantic Event, as values. A manager that mirrors states onto the
+ * tracker needs the list at runtime, not only as a type.
+ */
+export const EVENT_NAMES = [
+    "invalid",
+    "accepted",
+    "planned",
+    "progress",
+    "escalated",
+    "escalation_reminder",
+    "resumed",
+    "submitted",
+    "done",
+    "cancelled",
+    "reject_late",
+];
+//# sourceMappingURL=port.js.map

package/dist/port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../src/port.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,SAAS;IACT,UAAU;IACV,SAAS;IACT,UAAU;IACV,WAAW;IACX,qBAAqB;IACrB,SAAS;IACT,WAAW;IACX,MAAM;IACN,WAAW;IACX,aAAa;CACL,CAAC"}

package/dist/product.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The name the product goes by — the binary, the config file, the home
+ * directory, the labels a manager writes, the words in a message. It is
+ * written here once. Host and every manager read it from the kit; the only
+ * other file that spells it is `isolation-git`'s branch prefix, which has no
+ * kit to import. `scripts/check-name.mjs` refuses it anywhere else in source.
+ */
+export declare const PRODUCT = "mason";
+//# sourceMappingURL=product.d.ts.map

package/dist/product.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product.d.ts","sourceRoot":"","sources":["../src/product.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/product.js

@@ -0,0 +1,9 @@
+/**
+ * The name the product goes by — the binary, the config file, the home
+ * directory, the labels a manager writes, the words in a message. It is
+ * written here once. Host and every manager read it from the kit; the only
+ * other file that spells it is `isolation-git`'s branch prefix, which has no
+ * kit to import. `scripts/check-name.mjs` refuses it anywhere else in source.
+ */
+export const PRODUCT = "mason";
+//# sourceMappingURL=product.js.map

package/dist/product.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product.js","sourceRoot":"","sources":["../src/product.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@bluewombat/manager-kit",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Contract a FeatureManager package implements for Host.",
+  "keywords": [
+    "mason",
+    "bluewombat",
+    "plugin",
+    "types"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/tilap/bluewombat/tree/main/packages/host/manager-kit#readme",
+  "bugs": "https://github.com/tilap/bluewombat/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tilap/bluewombat.git",
+    "directory": "packages/host/manager-kit"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "SPECS.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=24.20.0"
+  },
+  "scripts": {
+    "lint": "biome check .",
+    "format": "biome check --write .",
+    "tsc": "tsc --noEmit",
+    "test": "tsx --test $(find src -name '*.test.ts')",
+    "build": "tsc -p tsconfig.build.json"
+  }
+}