@pelotto-tech/bellwether 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,230 @@
-# Temporary Holding Version
+# Bellwether
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A Stream-Avatars-style pixel overlay for [Herdr](https://herdr.dev). Each Herdr
+worktree workspace becomes a party of pixel characters that walk along the bottom of
+your screen. One of them carries a light that shows the party's status (working,
+done, blocked). A map mode shows every party as a glow on a pixel map; zoom into one to
+see its members and what they are doing.
+
+Reads the Herdr TUI socket API. Display only in v1, with interactive hooks stubbed.
+Theme packs are swappable; the core knows roles (architect, implementer, reviewer,
+...), not characters.
+
+**Status:** v0.1 MVP. Strip and map modes run on mock agents or live Herdr (`--live`); the installer lives in `packages/cli`; the Electron shell is in `packages/shell`. The plan is in [docs/PLAN.md](docs/PLAN.md).
+
+## Run it
+
+Needs Node 20+ and pnpm (`corepack enable` gives you the pinned version).
+
+```sh
+pnpm install
+pnpm mock        # build, then serve mock agents + the overlay on one port
+```
+
+Open <http://127.0.0.1:7341/>. Parties of pixel agents walk along the bottom of the
+window; the party label and the beacon's light show the rolled-up status (green
+working, yellow done, red pulsing blocked, white idle, grey unknown). Blocked members
+stop and hop, and speech bubbles show `say` lines.
+
+For development with hot reload:
+
+```sh
+pnpm dev         # adapter mock server on :7341 and Vite on :5173
+```
+
+Open <http://127.0.0.1:5173/>. If the adapter is not reachable the page falls back to an
+in-browser mock and says so in the corner chip.
+
+Page options (query string):
+
+| Option | Effect |
+|---|---|
+| `?transparent` | No backdrop or chip. Use this for an OBS browser source. |
+| `?pack=aesir` | Skin pack: `neutral` (Workshop Crew, default), `aesir`, `wayfarers`, or a private folder under `themes/`. Overrides `pack` in `bellwether.toml`. |
+| `?scale=4` | Pixel scale, 1 to 6 (default 3). |
+| `?source=mock` | Skip the adapter and run the mock in the browser. |
+| `?ws=ws://host:port/deltas` | Connect to a specific adapter. |
+
+Characters come from the skin pack's 24x32 sprite sheets: each role has its own sheet,
+members walk while working, raise a hand when blocked, wave when done, talk while a
+speech bubble is up, and blink when idle. The beacon's status light and each cloak are
+tinted through the sheet's masks, and bubbles and party nameplates use the pack's UI
+pieces. A pack without `art.json` falls back to procedural figures from `theme.json`.
+
+Pick a pack with `pack = "aesir"` in `bellwether.toml`, `--pack aesir` or
+`BELLWETHER_PACK=aesir` on the adapter (it serves the choice as `/config.json`), or
+`?pack=` in the URL. Unknown names fall back to `neutral`.
+
+### Map mode
+
+`?mode=map` (or press `m` to toggle with strip mode) shows a pixel world. Each repo is a
+settlement placed by hashing its path into a grid, so it stays put between runs. Each
+party camps beside its repo's settlement, with a glow in its rolled-up status colour
+(green working, yellow done, red pulsing blocked). Members wander around the camp;
+blocked ones stand still. When a member speaks (a `say` token, or an inferred hand-off
+from a teammate who just finished) it walks over to a teammate, or to a party camped at
+the same settlement, and the speech bubble shows.
+
+- Click a glow, or a dot on the minimap in the corner, to zoom into that party. A panel
+  lists its members with role, agent, status and their latest line. Esc, the panel's
+  close button, or clicking empty ground zooms back out.
+- The pack's map tileset and props (settlements, camps, campfires, glow) are used; pick
+  the pack as above.
+
+Layout, terrain, camera, chatter and wandering are pure modules under
+`packages/renderer/src/map/` with tests; `src/pixi/map.ts` is the thin Pixi scene.
+
+To watch your real Herdr agents instead, run the adapter against the live socket:
+
+```sh
+pnpm build
+node packages/adapter/dist/bin.js --live --all --serve packages/renderer/dist
+```
+
+Adapter flags (`--help` for all): `--live` / `--mock` / `--replay <file.jsonl>`,
+`--session <name>` or `--all`, `--socket <path>`, `--record <file.jsonl>` (add `--scrub`, or `scrub = true` in `bellwether.toml`, to hash repo, branch and workspace labels and strip `say` text and pane titles), `--scrub-file <in.jsonl> <out.jsonl>`, `--actions` (or `actions = true`: let the overlay prompt and send keys to agents; focus is always allowed), `--print`,
+`--port`, `--serve <dir>`, `--pack <name>`. `source = "live"` in `bellwether.toml` or
+`BELLWETHER_SOURCE=live` sets the default.
+
+## Overlay on your desktop
+
+`packages/shell` wraps the strip in a transparent, frameless, always-on-top,
+click-through Electron window the width of one monitor, pinned to its bottom edge.
+
+```sh
+pnpm install     # downloads the Electron binary (CI skips it with ELECTRON_SKIP_BINARY_DOWNLOAD=1)
+pnpm shell       # builds adapter and renderer, then launches the overlay
+```
+
+The shell attaches to an adapter already serving `http://127.0.0.1:7341/` or, if none
+answers, spawns `packages/adapter/dist/bin.js --live --all --serve packages/renderer/dist`.
+The tray icon menu has: switch strip/map (reloads with `?mode=map`), pick skin (reloads
+with `?pack=`), pick monitor, pick
+Herdr session (restarts a spawned adapter with `--session`), and quit. Choices persist in
+`shell.json` in Electron's userData folder. Set `BELLWETHER_ADAPTER_BIN` or
+`BELLWETHER_RENDERER_DIR` to point at other builds.
+
+Guides: [using the page in OBS](docs/obs.md), [writing a skin pack](docs/themes.md).
+
+Checks, the same ones CI runs:
+
+```sh
+pnpm typecheck && pnpm test && pnpm build
+```
+
+Double-click a member in strip mode (browser or OBS interact window) to jump the Herdr TUI to that pane. The overlay window is click-through, so this is for the browser view; `--actions` also enables `prompt` and `sendKeys` messages from clients.
+
+## CLI and replay
+
+Once published, install the CLI with `npm install -g @pelotto-tech/bellwether` and use `bellwether <cmd>` directly. It bundles the adapter and overlay page; the Electron tray shell (`pnpm shell`) runs from a checkout.
+
+From a source checkout the `bellwether` binary is not on your PATH. Run it through pnpm
+(it builds on first use; `BELLWETHER_REBUILD=1` forces a rebuild):
+
+```sh
+pnpm bellwether run
+pnpm bellwether install
+```
+
+Everywhere below, `bellwether <cmd>` means `pnpm bellwether <cmd>` unless you have linked it
+globally with `pnpm build && cd packages/cli && pnpm link --global`.
+
+```sh
+bellwether run                       # live Herdr, overlay at http://127.0.0.1:7341/
+bellwether record session.jsonl --scrub
+bellwether replay session.jsonl --speed 4
+bellwether scrub in.jsonl out.jsonl  # hash repo/branch/labels, drop speech text
+```
+
+`pnpm blog` builds a static, adapter-free bundle in `blog/`: the renderer plus the
+scrubbed demo recording in `docs/demo/`. Host it anywhere and embed
+`embed.html?pack=aesir&scale=3`, or point `?replay=<url>&speed=2` at your own scrubbed
+recording. Never publish an unscrubbed recording.
+
+## Layout
+
+```
+packages/adapter    world model, mock source, WebSocket server, recorder/replayer; Herdr client next
+packages/renderer   PixiJS strip and map modes and the theme loader (web page)
+packages/shell      Electron overlay window + tray
+packages/cli        bellwether install | uninstall | run | record | replay | scrub
+themes/neutral      ships with the repo
+themes/<private>    your own skins, gitignored
+docs/               plan and research artifacts
+```
+
+## Data sources
+
+The adapter reads from a mock source (default) or live Herdr. Pick one in
+`bellwether.toml` (gitignored) or with `BELLWETHER_SOURCE=mock|live`:
+
+```toml
+source = "live"
+[herdr]
+sessions = "all"        # every running session; or ["default", "overlay-dev"]
+# socket = "..."        # explicit socket or pipe path
+```
+
+`pnpm --filter @bellwether/adapter build && node packages/adapter/dist/bin.js --live --session overlay-dev`
+prints deltas as JSON lines.
+
+## Research artifacts
+
+`docs/research/` holds the verified protocol details this project rests on: the Herdr
+TUI API schema (protocol 22), herdr-core's OpenRPC schema, the raw named-pipe probe
+scripts, and a captured `working` → `idle` event log from a real agent pane.
+
+## Supported agents
+
+Claude Code and GitHub Copilot CLI are first-class targets for the installer. The
+adapter itself is agent-agnostic: it reads Herdr's `agent` field (`claude`, `copilot`,
+`codex`, ...) and draws every agent the same way, so anything Herdr recognizes shows up.
+Only the installer (`packages/cli`) knows agents apart.
+
+### Setup
+
+1. Let Herdr detect each agent and resume its sessions:
+
+   ```sh
+   herdr integration install claude
+   herdr integration install copilot
+   ```
+
+2. Install Bellwether's role tagging for every agent it finds:
+
+   ```sh
+   bellwether agents       # what is on PATH and which config dirs exist
+   bellwether install      # all present agents
+   bellwether install --agent copilot   # or just one
+   ```
+
+   For each agent whose config dir exists, this writes:
+
+   | | Claude Code | GitHub Copilot CLI |
+   |---|---|---|
+   | Config dir | `~/.claude` or `$CLAUDE_CONFIG_DIR` | `~/.copilot` or `$COPILOT_HOME` |
+   | Skill pack | `skills/bellwether/SKILL.md` | `skills/bellwether/SKILL.md` |
+   | Role hook | `hooks/bellwether-role.sh` (+ `.ps1`) | `hooks/bellwether-role.sh` (+ `.ps1`) |
+   | `settings.json` | `SessionStart` group with a `command` hook | flat `SessionStart` entry with `bash` and `powershell` |
+
+   Herdr's own entries and anything you added stay untouched. Running it twice changes
+   nothing. A missing config dir is skipped, not created: start the agent once first.
+
+3. Give panes a role. Either split a pane with `HERDR_ROLE=<role>` in its environment
+   (the hook tags it on session start), or let the agent follow the skill pack and tag
+   itself. Roles: `orchestrator`, `coordinator`, `architect`, `implementer`, `reviewer`,
+   `researcher`, `writer`, `ops`, `generic`.
+
+`bellwether uninstall` removes only what `install` wrote.
+
+Older Copilot CLI builds without skills support ignore the skill pack; the hook still
+works. Paste the contents of `SKILL.md` into `AGENTS.md` or
+`.github/copilot-instructions.md` if you want the instructions there.
+
+## License
+
+Apache License 2.0, the same as Herdr. Copyright 2026 Pelotto Technologies. See
+[LICENSE](LICENSE). The public skin packs (`neutral`, `aesir`, `wayfarers`) are original
+art under the same license.
+
+Contributions: see [CONTRIBUTING.md](CONTRIBUTING.md).

package/dist/agents/claude.d.ts

@@ -0,0 +1,8 @@
+import { type Json, type JsonObject } from '../json-file.js';
+import type { AgentTarget } from './types.js';
+/**
+ * Claude Code: `~/.claude/settings.json` (or `$CLAUDE_CONFIG_DIR`), nested hook shape:
+ * `hooks.SessionStart[] = { matcher, hooks: [{ type: "command", command }] }`.
+ */
+export declare const claude: AgentTarget;
+export declare function pruneEvent(settings: JsonObject, hooks: JsonObject, entries: Json[]): JsonObject;

package/dist/agents/claude.js

@@ -0,0 +1,63 @@
+import { join } from 'node:path';
+import { asArray, asObject, mentions } from '../json-file.js';
+import { HOOK_BASENAME } from '../skill.js';
+import { posixPath } from './paths.js';
+/**
+ * Claude Code: `~/.claude/settings.json` (or `$CLAUDE_CONFIG_DIR`), nested hook shape:
+ * `hooks.SessionStart[] = { matcher, hooks: [{ type: "command", command }] }`.
+ */
+export const claude = {
+    id: 'claude',
+    displayName: 'Claude Code',
+    binary: 'claude',
+    configDir(ctx) {
+        return ctx.env.CLAUDE_CONFIG_DIR || join(ctx.home, '.claude');
+    },
+    addSessionStartHook(settings, hook) {
+        const hooks = asObject(settings.hooks);
+        const groups = asArray(hooks.SessionStart);
+        const entry = {
+            matcher: 'startup|resume|clear|compact',
+            hooks: [{ type: 'command', command: `sh "${posixPath(hook.sh)}"` }],
+        };
+        return { ...settings, hooks: { ...hooks, SessionStart: [...groups, entry] } };
+    },
+    removeSessionStartHook(settings) {
+        const hooks = asObject(settings.hooks);
+        if (!Array.isArray(hooks.SessionStart))
+            return settings;
+        const groups = [];
+        let changed = false;
+        for (const group of hooks.SessionStart) {
+            const g = asObject(group);
+            if (!Array.isArray(g.hooks)) {
+                if (mentions(group, HOOK_BASENAME))
+                    changed = true;
+                else
+                    groups.push(group);
+                continue;
+            }
+            const inner = g.hooks.filter((h) => !mentions(h, HOOK_BASENAME));
+            if (inner.length === g.hooks.length)
+                groups.push(group);
+            else {
+                changed = true;
+                if (inner.length > 0)
+                    groups.push({ ...g, hooks: inner });
+            }
+        }
+        if (!changed)
+            return settings;
+        return pruneEvent(settings, hooks, groups);
+    },
+};
+export function pruneEvent(settings, hooks, entries) {
+    const nextHooks = { ...hooks, SessionStart: entries };
+    if (entries.length === 0)
+        delete nextHooks.SessionStart;
+    const next = { ...settings, hooks: nextHooks };
+    if (Object.keys(nextHooks).length === 0)
+        delete next.hooks;
+    return next;
+}
+//# sourceMappingURL=claude.js.map

package/dist/agents/claude.js.map

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

package/dist/agents/copilot.d.ts

@@ -0,0 +1,7 @@
+import type { AgentTarget } from './types.js';
+/**
+ * GitHub Copilot CLI: `~/.copilot/settings.json` (or `$COPILOT_HOME`), flat hook shape:
+ * `hooks.SessionStart[] = { type: "command", bash, powershell, timeoutSec }`.
+ * Same file and event Herdr's own `herdr integration install copilot` edits.
+ */
+export declare const copilot: AgentTarget;

package/dist/agents/copilot.js

@@ -0,0 +1,39 @@
+import { join } from 'node:path';
+import { asArray, asObject, mentions } from '../json-file.js';
+import { HOOK_BASENAME } from '../skill.js';
+import { pruneEvent } from './claude.js';
+import { posixPath } from './paths.js';
+/**
+ * GitHub Copilot CLI: `~/.copilot/settings.json` (or `$COPILOT_HOME`), flat hook shape:
+ * `hooks.SessionStart[] = { type: "command", bash, powershell, timeoutSec }`.
+ * Same file and event Herdr's own `herdr integration install copilot` edits.
+ */
+export const copilot = {
+    id: 'copilot',
+    displayName: 'GitHub Copilot CLI',
+    binary: 'copilot',
+    configDir(ctx) {
+        return ctx.env.COPILOT_HOME || join(ctx.home, '.copilot');
+    },
+    addSessionStartHook(settings, hook) {
+        const hooks = asObject(settings.hooks);
+        const entries = asArray(hooks.SessionStart);
+        const entry = {
+            type: 'command',
+            bash: `sh "${posixPath(hook.sh)}"`,
+            powershell: `& "${hook.ps1}"`,
+            timeoutSec: 10,
+        };
+        return { ...settings, hooks: { ...hooks, SessionStart: [...entries, entry] } };
+    },
+    removeSessionStartHook(settings) {
+        const hooks = asObject(settings.hooks);
+        if (!Array.isArray(hooks.SessionStart))
+            return settings;
+        const kept = hooks.SessionStart.filter((e) => !mentions(e, HOOK_BASENAME));
+        if (kept.length === hooks.SessionStart.length)
+            return settings;
+        return pruneEvent(settings, hooks, kept);
+    },
+};
+//# sourceMappingURL=copilot.js.map

package/dist/agents/copilot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot.js","sourceRoot":"","sources":["../../src/agents/copilot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAmB,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAgB;IAClC,EAAE,EAAE,SAAS;IACb,WAAW,EAAE,oBAAoB;IACjC,MAAM,EAAE,SAAS;IAEjB,SAAS,CAAC,GAAG;QACX,OAAO,GAAG,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5D,CAAC;IAED,mBAAmB,CAAC,QAAQ,EAAE,IAAI;QAChC,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAe;YACxB,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG;YAClC,UAAU,EAAE,MAAM,IAAI,CAAC,GAAG,GAAG;YAC7B,UAAU,EAAE,EAAE;SACf,CAAC;QACF,OAAO,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;IACjF,CAAC;IAED,sBAAsB,CAAC,QAAQ;QAC7B,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;YAAE,OAAO,QAAQ,CAAC;QACxD,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;QAC3E,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,YAAY,CAAC,MAAM;YAAE,OAAO,QAAQ,CAAC;QAC/D,OAAO,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;CACF,CAAC"}

package/dist/agents/index.d.ts

@@ -0,0 +1,5 @@
+import type { AgentTarget } from './types.js';
+export type { AgentContext, AgentTarget, HookPaths } from './types.js';
+/** Installer targets, both first-class. Add a new agent by adding a target here. */
+export declare const AGENT_TARGETS: readonly AgentTarget[];
+export declare function findTarget(id: string): AgentTarget | undefined;

package/dist/agents/index.js

@@ -0,0 +1,8 @@
+import { claude } from './claude.js';
+import { copilot } from './copilot.js';
+/** Installer targets, both first-class. Add a new agent by adding a target here. */
+export const AGENT_TARGETS = [claude, copilot];
+export function findTarget(id) {
+    return AGENT_TARGETS.find((t) => t.id === id);
+}
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAKvC,oFAAoF;AACpF,MAAM,CAAC,MAAM,aAAa,GAA2B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvE,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAChD,CAAC"}

package/dist/agents/paths.d.ts

@@ -0,0 +1,2 @@
+/** Forward slashes, so `sh` accepts the path on Windows (Git Bash) as well as Unix. */
+export declare function posixPath(p: string): string;

package/dist/agents/paths.js

@@ -0,0 +1,5 @@
+/** Forward slashes, so `sh` accepts the path on Windows (Git Bash) as well as Unix. */
+export function posixPath(p) {
+    return p.replace(/\\/g, '/');
+}
+//# sourceMappingURL=paths.js.map

package/dist/agents/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/agents/paths.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC/B,CAAC"}

package/dist/agents/types.d.ts

@@ -0,0 +1,29 @@
+import type { JsonObject } from '../json-file.js';
+/** Where an agent target looks things up. Injected so tests never touch the real home dir. */
+export interface AgentContext {
+    env: Record<string, string | undefined>;
+    home: string;
+    platform: NodeJS.Platform;
+    /** Whether an executable with this name is on PATH. */
+    onPath(binary: string): boolean;
+}
+export interface HookPaths {
+    sh: string;
+    ps1: string;
+}
+/**
+ * One coding agent the installer can integrate with. `id` is the value Herdr puts in
+ * the `agent` field for this agent. This is the only place in Bellwether that knows
+ * agents apart; the adapter and renderer stay agent-agnostic.
+ */
+export interface AgentTarget {
+    id: string;
+    displayName: string;
+    binary: string;
+    /** Config home, honouring the agent's own override variable. */
+    configDir(ctx: AgentContext): string;
+    /** Return settings with Bellwether's SessionStart entry added. Assumes none is present. */
+    addSessionStartHook(settings: JsonObject, hook: HookPaths): JsonObject;
+    /** Return settings with every Bellwether entry removed and all other entries untouched. */
+    removeSessionStartHook(settings: JsonObject): JsonObject;
+}

package/dist/agents/types.js

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

package/dist/agents/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { AGENT_TARGETS, findTarget } from './agents/index.js';
+export type { AgentContext, AgentTarget, HookPaths } from './agents/index.js';
+export { detect, install, uninstall, pathsFor, systemContext } from './install.js';
+export type { DetectResult, Outcome, TargetPaths } from './install.js';
+export { ROLES, type Role } from './roles.js';

package/dist/index.js

@@ -0,0 +1,4 @@
+export { AGENT_TARGETS, findTarget } from './agents/index.js';
+export { detect, install, uninstall, pathsFor, systemContext } from './install.js';
+export { ROLES } from './roles.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":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEnF,OAAO,EAAE,KAAK,EAAa,MAAM,YAAY,CAAC"}