docs(calm-suite): instruct npm usage instead of pnpm in calm-guard docs

Address review feedback on #2407: update calm-guard README, AGENTS.md, and the
Docusaurus docs site (getting-started, contributing, getting-started, security,
api/reference, architecture/system-overview, uploading-architectures, docs/README)
to instruct contributors to use npm from the monorepo root instead of pnpm.

- README badge pnpm 9+ → npm 10+
- All install/dev/build/test commands rewritten as npm with --workspace=calmguard
  (or --workspace=calmguard-docs for the docs site)
- Clone instructions point at finos/architecture-as-code (the monorepo) instead
  of the standalone hackathon repo
- Both root- and calm-guard-relative invocations documented where useful

Refs #2328.

Signed-off-by: Gourav Shah <gjs@opsflow.sh>

Author: gjs-opsflo

calm-suite/calm-guard/AGENTS.md

@@ -11,7 +11,7 @@ Built for the DTCC/FINOS Innovate.DTCC AI Hackathon (Feb 23-27, 2026).
 | Layer | Choice | Notes |
 |-------|--------|-------|
 | Framework | Next.js 14+ (App Router) | `src/app/` routing, API routes for SSE |
-| Package Manager | pnpm | Use `pnpm` for all package operations |
+| Package Manager | npm (workspaces) | CalmGuard is a workspace of the monorepo root. Run `npm` commands from the repo root or use `--workspace=calmguard`. The docs sub-package is `calmguard-docs`. |
 | Language | TypeScript (strict mode) | No `any` types. Use Zod for runtime validation |
 | LLM SDK | Vercel AI SDK (`ai`) | `generateObject` with Zod schemas for all agent outputs |
 | Default LLM | Google Gemini | `@ai-sdk/google`. Multi-provider: also supports Anthropic, OpenAI, Ollama, Grok |
@@ -136,11 +136,19 @@ examples/                       # Demo CALM architecture JSON files
 
 ## Key Commands
 
+Run from monorepo root (preferred) or from `calm-suite/calm-guard/` (drop the `--workspace=calmguard` flag).
+
 ```bash
-pnpm dev          # Start dev server
-pnpm build        # Production build
-pnpm lint         # ESLint
-pnpm typecheck    # TypeScript strict check
+# From monorepo root
+npm ci                                       # Install all workspaces (one-time / on lockfile change)
+npm run dev --workspace=calmguard            # Start dev server
+npm run build --workspace=calmguard          # Production build
+npm run lint --workspace=calmguard           # ESLint
+npm run typecheck --workspace=calmguard      # TypeScript strict check
+npm run test:run --workspace=calmguard       # Vitest single run
+
+# Docs site (Docusaurus)
+npm run docs:dev                             # From calm-suite/calm-guard/
 ```
 
 ## Environment Variables

calm-suite/calm-guard/README.md

@@ -17,7 +17,7 @@
   <img src="https://img.shields.io/badge/TypeScript-strict-blue?logo=typescript&logoColor=white" alt="TypeScript" />
   <img src="https://img.shields.io/badge/FINOS-CALM_1.0--1.2-00A3E0?logo=linux-foundation&logoColor=white" alt="FINOS CALM" />
   <img src="https://img.shields.io/badge/Node-22+-339933?logo=node.js&logoColor=white" alt="Node 22+" />
-  <img src="https://img.shields.io/badge/pnpm-9+-F69220?logo=pnpm&logoColor=white" alt="pnpm" />
+  <img src="https://img.shields.io/badge/npm-10+-CB3837?logo=npm&logoColor=white" alt="npm" />
 </p>
 
 ---
@@ -70,15 +70,17 @@ You could [Access the Presentation ->](https://github.com/finos-labs/dtcch-2026-
 
 ### Prerequisites
 
-- **Node.js 22+** and **pnpm 9+**
+- **Node.js 22+** and **npm 10+**
 - At least one LLM provider API key (Gemini is the default)
 
 ### Setup
 
+CalmGuard is a workspace of the [`finos/architecture-as-code`](https://github.com/finos/architecture-as-code) monorepo. Clone the monorepo and install all workspaces from the root:
+
 ```bash
-git clone https://github.com/finos-labs/dtcch-2026-opsflow-llc.git
-cd dtcch-2026-opsflow-llc
-pnpm install
+git clone https://github.com/finos/architecture-as-code.git
+cd architecture-as-code
+npm ci
 ```
 
 Create a `.env.local` file:
@@ -98,8 +100,16 @@ GITHUB_TOKEN=your-github-token
 
 ### Run
 
+From the monorepo root:
+
+```bash
+npm run dev --workspace=calmguard          # Start dev server at http://localhost:3000
+```
+
+Or from `calm-suite/calm-guard/`:
+
 ```bash
-pnpm dev          # Start dev server at http://localhost:3000
+npm run dev
 ```
 
 Visit the dashboard — click **"Demo Mode"** to see CALMGuard analyze a sample architecture without any API keys.
@@ -377,7 +387,7 @@ Unknown node types (e.g., `lambda`) are mapped to `service` — maximizing compa
 
 ## Documentation
 
-Full documentation is available in [`docs/`](docs/). Run locally with `pnpm docs:dev`, or browse directly on GitHub:
+Full documentation is available in [`docs/`](docs/). Run locally with `npm run docs:dev`, or browse directly on GitHub:
 
 ### Getting Started
 

calm-suite/calm-guard/docs/README.md

@@ -2,24 +2,44 @@
 
 This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
 
+It is published as the `calmguard-docs` workspace of the [`finos/architecture-as-code`](https://github.com/finos/architecture-as-code) monorepo.
+
 ## Installation
 
+From the monorepo root:
+
 ```bash
-pnpm install
+npm ci
 ```
 
 ## Local Development
 
+From the monorepo root:
+
+```bash
+npm run start --workspace=calmguard-docs
+```
+
+Or from `calm-suite/calm-guard/`:
+
 ```bash
-pnpm start
+npm run docs:dev
 ```
 
 This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
 
 ## Build
 
+From the monorepo root:
+
+```bash
+npm run build --workspace=calmguard-docs
+```
+
+Or from `calm-suite/calm-guard/`:
+
 ```bash
-pnpm build
+npm run docs:build
 ```
 
 This command generates static content into the `build` directory and can be served using any static contents hosting service.

calm-suite/calm-guard/docs/docs/api/reference.md

@@ -6,7 +6,7 @@ title: API Reference
 # API Reference
 
 > This page is auto-generated from Zod schema source files by `scripts/generate-api-docs.ts`.
-> Run `pnpm docs:api` to regenerate.
+> Run `npm run docs:api --workspace=calmguard` to regenerate.
 
 *Generated: 2026-02-24T08:36:31.355Z*
 

calm-suite/calm-guard/docs/docs/architecture/system-overview.md

@@ -20,7 +20,7 @@ CALMGuard is built on Next.js 15 with a multi-agent AI architecture. This page c
 | Charts | Recharts | Compliance gauges, heat maps |
 | State | Zustand | Flat state, SSE event updates |
 | Validation | Zod | CALM parsing + agent output validation |
-| Package Manager | pnpm | Workspace tooling |
+| Package Manager | npm (workspaces) | Root of `finos/architecture-as-code` monorepo |
 
 ## Architecture Diagram
 

calm-suite/calm-guard/docs/docs/contributing.md

@@ -12,18 +12,20 @@ CALMGuard is an open-source project built for the DTCC/FINOS Innovate Hackathon
 ### Prerequisites
 
 - Node.js 22+
-- pnpm 9+
+- npm 10+
 - A Gemini API key (free tier works for development)
 
 ### Installation
 
+CalmGuard lives in the [`finos/architecture-as-code`](https://github.com/finos/architecture-as-code) monorepo as the `calmguard` npm workspace.
+
 ```bash
-git clone https://github.com/finos/dtcch-2026-opsflow-llc.git
-cd dtcch-2026-opsflow-llc
-pnpm install
-cp .env.example .env.local
+git clone https://github.com/finos/architecture-as-code.git
+cd architecture-as-code
+npm ci
+cp calm-suite/calm-guard/.env.example calm-suite/calm-guard/.env.local
 # Edit .env.local and add your GOOGLE_GENERATIVE_AI_API_KEY
-pnpm dev
+npm run dev --workspace=calmguard
 ```
 
 ## Project Structure
@@ -68,11 +70,11 @@ See the [System Overview](/architecture/system-overview) for a full directory br
 
 ## Testing
 
-Run the test suite:
+Run the test suite (from monorepo root):
 
 ```bash
-pnpm test        # Watch mode
-pnpm test:run    # Single run
+npm run test --workspace=calmguard        # Watch mode
+npm run test:run --workspace=calmguard    # Single run
 ```
 
 Tests use Vitest with jsdom for component testing.
@@ -88,12 +90,12 @@ Tests use Vitest with jsdom for component testing.
 1. Fork the repository
 2. Create a feature branch: `git checkout -b feat/my-feature`
 3. Make your changes with tests
-4. Run the full check suite:
+4. Run the full check suite (from monorepo root):
    ```bash
-   pnpm typecheck
-   pnpm lint
-   pnpm test:run
-   pnpm build
+   npm run typecheck --workspace=calmguard
+   npm run lint --workspace=calmguard
+   npm run test:run --workspace=calmguard
+   npm run build --workspace=calmguard
    ```
 5. Commit with DCO sign-off: `git commit -s -m "feat: add my feature"`
 6. Push and open a Pull Request

calm-suite/calm-guard/docs/docs/getting-started.md

@@ -12,28 +12,32 @@ Get CALMGuard running locally in under 5 minutes.
 | Requirement | Minimum Version | Notes |
 |------------|-----------------|-------|
 | Node.js | 22+ | LTS recommended |
-| pnpm | 9+ | `npm install -g pnpm` |
+| npm | 10+ | Ships with Node 22 |
 | Git | Any | For cloning |
 | Google Gemini API key | — | Free tier sufficient for demo |
 
+CalmGuard is the `calmguard` workspace inside the [`finos/architecture-as-code`](https://github.com/finos/architecture-as-code) monorepo. All commands run from the monorepo root.
+
 ## Installation
 
-### 1. Clone the repository
+### 1. Clone the monorepo
 
 ```bash
-git clone https://github.com/finos/dtcch-2026-opsflow-llc.git
-cd dtcch-2026-opsflow-llc
+git clone https://github.com/finos/architecture-as-code.git
+cd architecture-as-code
 ```
 
 ### 2. Install dependencies
 
 ```bash
-pnpm install
+npm ci
 ```
 
+This installs all workspaces (calm-guard, calm-studio, cli, server, etc.) from the root `package-lock.json`.
+
 ### 3. Configure environment variables
 
-Create a `.env.local` file in the project root:
+Create a `.env.local` file in `calm-suite/calm-guard/`:
 
 ```bash
 # Required — Gemini is the default LLM provider
@@ -51,8 +55,10 @@ OPENAI_API_KEY=your-openai-key
 
 ### 4. Start the development server
 
+From the monorepo root:
+
 ```bash
-pnpm dev
+npm run dev --workspace=calmguard
 ```
 
 The app will be available at [http://localhost:3000](http://localhost:3000).

calm-suite/calm-guard/docs/docs/security.md

@@ -140,18 +140,18 @@ We follow responsible disclosure and will credit reporters in our changelog.
 
 ## Dependencies
 
-Security-relevant dependencies are audited with `pnpm audit`. Run:
+Security-relevant dependencies are audited with `npm audit`. Run from the monorepo root:
 
 ```bash
-pnpm audit
+npm audit
 ```
 
 Known issues will be tracked in GitHub Issues with the `security` label.
 
 License compliance is checked with:
 
 ```bash
-pnpm license-check
+npm run license-check --workspace=calmguard
 ```
 
 This fails on GPL/AGPL dependencies to ensure no copyleft code enters the project.

calm-suite/calm-guard/docs/docs/uploading-architectures.md

@@ -79,7 +79,7 @@ Relationships connect nodes and describe how they interact:
 
 CALMGuard ships with two demo architectures in the `examples/` directory. To use them:
 
-1. Launch CALMGuard (`pnpm dev`)
+1. Launch CALMGuard (`npm run dev --workspace=calmguard` from the monorepo root)
 2. On the main page, select an architecture from the dropdown:
    - **Trading Platform** — equities trading with market data, order management, risk checks
    - **Payment Gateway** — payment processing with fraud detection and settlement