git:20260331.5459f9b to git:20260406.6bac6eb

6 added, 5 removed. Audit A to A.

@AGENTS.md

+ Root **`mise.toml`** configures a mise monorepo (`config_roots`: **`cdk`**, **`agent`**, **`cli`**, **`docs`**). Use **`MISE_EXPERIMENTAL=1`** for **`mise //pkg:task`**; run **`mise trust`** at the repo root after clone. **`scripts/`** is for cross-package helpers (often thin wrappers around **`mise run`**); **`scripts/ci-build.sh`** is the CI-equivalent full build.

## Repository layout (quick reference)

- - **`src/`** — CDK application: `main.ts`, `stacks/`, `constructs/`, `handlers/`.

- - **`cli/`** — `@backgroundagent/cli` Projen subproject (`bgagent`). Build from repo root: `cd cli && npx projen build` (also runs as part of root `npx projen build`).

+ - **`cdk/`** — CDK application package: `cdk/src/main.ts`, `stacks/`, `constructs/`, `handlers/`.

+ - **`cli/`** — `@backgroundagent/cli` package (`bgagent`). Build from repo root: `mise //cli:build` (or `cd cli && mise run build`).

- **`agent/`** — Python agent code, Dockerfile, and runtime for the compute environment.

- - **`test/`** — Jest tests for the CDK app (layout mirrors `src/`).

- - **`docs/`** — Authoritative Markdown under `docs/guides/` (developer, user, roadmap, prompt guides) and `docs/design/`; assets in `docs/imgs/` and `docs/diagrams/`. The **docs website** (Astro + Starlight) is a Projen subproject in `docs/` (`astro.config.mjs`, `package.json`); `docs/src/content/docs/` is regenerated from `.projenrc.ts` when you run `npx projen` — edit the source files under `docs/guides/` / `docs/design/` (or `.projenrc.ts`), not the mirrored copies.

+ - **`cdk/test/`** — Jest tests for the CDK app (layout mirrors `cdk/src/`).

+ - **`docs/`** — Authoritative Markdown under `docs/guides/` (developer, user, roadmap, prompt guides) and `docs/design/`; assets in `docs/imgs/` and `docs/diagrams/`. The docs website (Astro + Starlight) lives in `docs/`; `docs/src/content/docs/` is synced via `docs/scripts/sync-starlight.mjs` (run through `mise //docs:sync` or `mise //docs:build`).

- **`CONTRIBUTING.md`** — Contribution guidelines at the **repository root**.

- - **`.projenrc.ts`** — Defines the root CDK project, `cli/`, and `docs/` site; run **`npx projen`** after changing dependencies or subproject config.

The CLI is at **`cli/`** (not `packages/cli`).