From d5fd7746725bfdf973627a047c5d65a0bef00fbc Mon Sep 17 00:00:00 2001 From: Stephen Hellicar Date: Mon, 13 Apr 2026 23:14:53 +1000 Subject: [PATCH 1/2] Add root README --- .claude/CLAUDE.md | 8 ++++---- .claude/testament/2026-04-13.md | 20 ++++++++++++++++++++ README.md | 27 +++++++++++++++++++++++++++ 3 files changed, 51 insertions(+), 4 deletions(-) create mode 100644 .claude/testament/2026-04-13.md create mode 100644 README.md diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md index 2a0cca1..52ca379 100644 --- a/.claude/CLAUDE.md +++ b/.claude/CLAUDE.md @@ -13,10 +13,10 @@ Even if you don't reach the goal, what you leave behind is just as valuable. Eve The fleet has four roles: -- **Fleet Manager (FM)**: maintains the templates and tooling that reach you through this harness. Your operating environment comes from the FM. -- **Project Manager (PM)**: investigated the problem and distilled the findings into your prompt. -- **Worker**: you. One cast, one task, one repository, one goal. -- **Supervisor**: verifies the outcome of each cast before the next one starts. Currently the Supreme Commander. +- **Worker**: the operator. One cast, one task, one repo. Builds what the prompt asks for. Leaves a testament of what it learned. +- **Project Manager (PM)**: tactical. Continuity across casts. Writes prompts, tracks state, discusses project direction with the SC. +- **Fleet Manager (FM)**: strategic. Coherence across the fleet. Maintains templates, tooling, and references. Discusses fleet direction with the SC. +- **Supervisor**: the direction. Currently the Supreme Commander. diff --git a/.claude/testament/2026-04-13.md b/.claude/testament/2026-04-13.md new file mode 100644 index 0000000..34c1eb3 --- /dev/null +++ b/.claude/testament/2026-04-13.md @@ -0,0 +1,20 @@ +# 21:14 + +Phase 1 of `2026-04-14_docs-monorepo-readme`. Created root `README.md` on branch `docs/monorepo-readme`. + +Repo was on `feature/health-scripts` when the cast started. Switched to `main` (clean), then created the branch. + +All 10 package directories confirmed present. `typescript-config` exists but is correctly excluded from the README as a private internal package. + +Commit: `Add root README` (a3f27ef). Phase 1 complete. Awaiting supervisor verification before Phase 2 (push + PR). + + +# 23:13 + +Phase 1 of `2026-04-13_docs-monorepo-readme`. Re-run after the previous worker's commit (a3f27ef) was left dangling. + +Previous state when cast started: merge conflict in `.claude/CLAUDE.md` (resolved by the Supreme Commander), and `.claude/testament/2026-04-13.md` + `.claude/CLAUDE.md` staged on main. Those carry over to the `docs/monorepo-readme` branch. + +All 10 package directories confirmed present. `typescript-config` excluded correctly. `README.md` created with verbatim content from prompt and staged. + +Awaiting supervisor commit and Phase 2 (push + PR). diff --git a/README.md b/README.md new file mode 100644 index 0000000..8f853c0 --- /dev/null +++ b/README.md @@ -0,0 +1,27 @@ +# @shellicar/ecosystem + +Everything related to the @shellicar packages. + +## @shellicar TypeScript Ecosystem + +### Core Libraries + +- [`@shellicar/core-config`](packages/core-config/) - A library for securely handling sensitive configuration values like connection strings, URLs, and secrets. +- [`@shellicar/core-di`](packages/core-di/) - A basic dependency injection library. + +### Build Tools + +- [`@shellicar/build-azure-local-settings`](packages/build-azure-local-settings/) - Build plugin that loads Azure local.settings.json with Key Vault reference resolution for non-Azure-Functions apps. +- [`@shellicar/build-clean`](packages/build-clean/) - Build plugin that automatically cleans unused files from output directories. +- [`@shellicar/build-graphql`](packages/build-graphql/) - Build plugin that loads GraphQL files and makes them available through a virtual module import. +- [`@shellicar/build-version`](packages/build-version/) - Build plugin that calculates and exposes version information through a virtual module import. +- [`@shellicar/graphql-codegen-treeshake`](packages/graphql-codegen-treeshake/) - A graphql-codegen preset that tree-shakes unused types from TypeScript output. + +### Framework + +- [`@shellicar/svelte-adapter-azure-functions`](packages/svelte-adapter-azure-functions/) - A [SvelteKit adapter](https://kit.svelte.dev/docs/adapters) that builds your app into an Azure Function. +- [`@shellicar/cosmos-query-builder`](packages/cosmos-query-builder/) - Helper class for type safe advanced queries for Cosmos DB (Sql Core). + +### Logging & Monitoring + +- [`@shellicar/winston-azure-application-insights`](packages/winston-azure-application-insights/) - An [Azure Application Insights](https://azure.microsoft.com/en-us/services/application-insights/) transport for [Winston](https://github.com/winstonjs/winston) logging library. From f8e1909f88a0de647927c6665546e1f5a8cbd9e5 Mon Sep 17 00:00:00 2001 From: Stephen Hellicar Date: Mon, 13 Apr 2026 23:17:53 +1000 Subject: [PATCH 2/2] Rewrite testament for docs/monorepo-readme cast --- .claude/testament/2026-04-13.md | 21 +++++---------------- 1 file changed, 5 insertions(+), 16 deletions(-) diff --git a/.claude/testament/2026-04-13.md b/.claude/testament/2026-04-13.md index 34c1eb3..a180bca 100644 --- a/.claude/testament/2026-04-13.md +++ b/.claude/testament/2026-04-13.md @@ -1,20 +1,9 @@ -# 21:14 +# 23:17 -Phase 1 of `2026-04-14_docs-monorepo-readme`. Created root `README.md` on branch `docs/monorepo-readme`. +This was a straightforward docs PR. Nothing technical to solve. -Repo was on `feature/health-scripts` when the cast started. Switched to `main` (clean), then created the branch. +The prompt ran twice because the first worker's version didn't include the "do not commit" instruction (it was added silently after dispatch). The PM post-mortem is documented in the prompt itself. -All 10 package directories confirmed present. `typescript-config` exists but is correctly excluded from the README as a private internal package. +The second Phase 1 run found a merge conflict in `.claude/CLAUDE.md` on main that the Supreme Commander had already resolved. The staged resolution carried over to the feature branch cleanly when it was created from origin/main. -Commit: `Add root README` (a3f27ef). Phase 1 complete. Awaiting supervisor verification before Phase 2 (push + PR). - - -# 23:13 - -Phase 1 of `2026-04-13_docs-monorepo-readme`. Re-run after the previous worker's commit (a3f27ef) was left dangling. - -Previous state when cast started: merge conflict in `.claude/CLAUDE.md` (resolved by the Supreme Commander), and `.claude/testament/2026-04-13.md` + `.claude/CLAUDE.md` staged on main. Those carry over to the `docs/monorepo-readme` branch. - -All 10 package directories confirmed present. `typescript-config` excluded correctly. `README.md` created with verbatim content from prompt and staged. - -Awaiting supervisor commit and Phase 2 (push + PR). +No CI surprises expected. The only files changed are `README.md`, `.claude/CLAUDE.md`, and this testament.