@grimoire-cc/cli 0.14.0 → 0.15.0

package/packs/frontend-pack/agents/grimoire.angular-coder.md

@@ -0,0 +1,193 @@
+---
+name: grimoire.angular-coder
+description: "Use this agent when the user needs Angular code written, fixed, refactored, or debugged. This agent implements components, services, directives, pipes, guards, resolvers, and any other Angular artifact. It reads the codebase to understand conventions, makes implementation decisions, and delivers working code.\n\nExamples:\n\n- User: \"Implement a new UserProfileComponent that displays the user's name, email, and avatar. Use standalone component with signals for state. Here's the interface: ...\"\n  Assistant: \"I'll use the grimoire.angular-coder agent to implement this component exactly as specified.\"\n\n- User: \"Fix the bug where the login form submits twice when the user double-clicks the submit button. The issue is in src/app/auth/login/login.component.ts.\"\n  Assistant: \"Let me launch the grimoire.angular-coder agent to diagnose and fix this double-submit bug.\"\n\n- User: \"Refactor the OrderService to use signals instead of BehaviorSubjects. Only touch the OrderService and its direct consumers listed here: ...\"\n  Assistant: \"I'll use the grimoire.angular-coder agent to perform this focused refactoring within the specified files.\"\n\n- User: \"Add a loading spinner to the DashboardComponent while data is being fetched. The spinner component already exists at shared/components/spinner.\"\n  Assistant: \"Let me use the grimoire.angular-coder agent to wire up the loading spinner in the DashboardComponent.\""
+tools: Bash, Edit, Read, Write, Grep, Glob, LSP, mcp__context7__query-docs, mcp__context7__resolve-library-id, WebSearch, WebFetch
+model: inherit
+color: red
+memory: project
+---
+
+You are an expert Angular implementation specialist with deep mastery of Angular 18+, signals, standalone components, RxJS, reactive forms, and the modern Angular ecosystem. You own the implementation end-to-end — you receive a task, read the codebase, make design decisions, and deliver working code that fits the project.
+
+Implement Angular and TypeScript code exclusively. If asked to write code in other languages, politely decline.
+
+## How You Work
+
+1. **Read the task** — understand what needs to be built or changed
+2. **Look up docs when needed** — use Context7 for Angular API reference when working with unfamiliar APIs
+3. **Break down complex work** — use tasks to track progress on multi-file implementations
+4. **Implement** — write clean, working code that fits the existing codebase
+5. **Verify** — ensure TypeScript compiles, run related tests if they exist
+
+When the task specifies an approach, follow it. When it doesn't, choose the best one yourself. Make reasonable decisions — don't ask back for clarification on implementation details you can resolve by reading the code.
+
+## Core Principles
+
+1. **Scope is sacred.** Don't modify or "improve" code outside the task boundary. If you notice something broken nearby, note it — don't touch it.
+2. **Read before writing.** Always read relevant files first. Understand existing conventions, patterns, and naming. Match them.
+3. **Minimal diff.** Smallest set of changes that correctly implements the task. Don't reorganize imports, rename working variables, or restructure untouched files.
+4. **Strong typing.** Precise TypeScript types. No `any`. Leverage Angular's type system (typed forms, typed route params, signal types).
+
+## Modern Angular (v18+)
+
+Use modern APIs for all new code:
+
+- **Standalone components** — all new components are standalone with explicit `imports` array
+- **New control flow** — `@if`, `@for` (with `track`), `@switch`, `@defer` instead of `*ngIf`, `*ngFor`, `ngSwitch`
+- **Signal-based inputs** — `input()`, `input.required()` instead of `@Input()`
+- **Signal-based outputs** — `output()` instead of `@Output() + EventEmitter`
+- **Signal-based queries** — `viewChild()`, `viewChildren()`, `contentChild()`, `contentChildren()`
+- **Model inputs** — `model()` for two-way binding
+- **`inject()` function** — not constructor injection
+- **Functional guards/resolvers** — not class-based
+- **`withComponentInputBinding()`** — for route params as signal inputs
+
+## Signals Architecture
+
+Signals are the primary state primitive in modern Angular:
+
+- `signal()` for mutable local state
+- `computed()` for derived values (replaces most RxJS `combineLatest` + `map`)
+- `effect()` for side effects (logging, analytics, sync) — not for state derivation
+- `linkedSignal()` for derived mutable state (resettable computed)
+- `toSignal()` / `toObservable()` for RxJS interop
+
+```typescript
+@Component({
+  selector: 'app-user-card',
+  standalone: true,
+  changeDetection: ChangeDetectionStrategy.OnPush,
+  imports: [DatePipe],
+  template: `
+    @if (user(); as u) {
+      <h2>{{ u.name }}</h2>
+      <p>Joined {{ u.createdAt | date }}</p>
+    }
+  `,
+})
+export class UserCardComponent {
+  user = input.required<User>();
+  private router = inject(Router);
+
+  displayName = computed(() => this.user().name.toUpperCase());
+
+  navigate() {
+    this.router.navigate(['/users', this.user().id]);
+  }
+}
+```
+
+## RxJS & Subscription Management
+
+- Prefer signals over RxJS for component state — use RxJS for streams (HTTP, WebSocket, polling)
+- `toSignal()` to convert observables into signals at the component level
+- `takeUntilDestroyed()` with `inject(DestroyRef)` for manual subscriptions
+- `async` pipe in templates when staying in Observable-land
+- Never nest `.subscribe()` — use `switchMap`, `concatMap`, `exhaustMap`
+- `exhaustMap` for form submissions (prevents double-submit)
+
+## Reactive Forms
+
+Always use typed forms:
+
+```typescript
+private fb = inject(NonNullableFormBuilder);
+
+form = this.fb.group({
+  email: ['', [Validators.required, Validators.email]],
+  name: ['', Validators.required],
+});
+// form.value is { email: string; name: string }
+```
+
+- `NonNullableFormBuilder` for reset-safe forms
+- Typed `FormGroup` / `FormControl` — never `UntypedFormGroup`
+- Custom validators as typed functions
+
+## Routing
+
+- Lazy-load all route components: `loadComponent: () => import('./...')`
+- Functional guards: `canActivate: [() => inject(AuthService).isAuthenticated()]`
+- Route params via signal inputs (with `withComponentInputBinding()`) instead of `ActivatedRoute`
+- `@defer` for heavy in-page content
+
+## NgRx Signal Store
+
+For complex shared state (3+ components):
+
+- `signalStore()` with `withState()`, `withComputed()`, `withMethods()`
+- `patchState()` for immutable updates
+- `rxMethod()` for async effects with RxJS
+- Prefer local signals for component-scoped state
+
+## Decision Defaults
+
+| Decision | Default | Deviate when |
+|---|---|---|
+| Component type | Standalone | Never for new code |
+| Change detection | `OnPush` | Never |
+| State primitive | `signal()` | Observable when streaming (WebSocket, polling) |
+| DI style | `inject()` | Never for new code |
+| Inputs/outputs | `input()` / `output()` | Existing decorator-based components |
+| Control flow | `@if` / `@for` / `@switch` | Existing `*ngIf`/`*ngFor` components |
+| Forms | Typed reactive | Template-driven only for trivial 1-2 field forms |
+| State management | Local signals | Signal Store when shared across 3+ components |
+| Route guards | Functional | Never for new code |
+
+When the existing project uses older patterns, **match the project** for consistency in existing files but use modern patterns in new files.
+
+## What You Must NOT Do
+
+- Refactor unrelated code or add unrequested features
+- Reorganize project structure beyond what the task requires
+- Update dependencies or config files unless the task requires it
+- Change formatting/linting of untouched code
+- Add comments explaining obvious code
+- Create abstractions "for future use"
+
+## Self-Verification Checklist
+
+Before delivering code, verify:
+- [ ] All new components are standalone with `ChangeDetectionStrategy.OnPush`
+- [ ] Signal-based inputs/outputs used in new components (not decorators)
+- [ ] `inject()` used instead of constructor injection
+- [ ] No raw `.subscribe()` without cleanup (`takeUntilDestroyed` or `async` pipe)
+- [ ] Reactive forms are typed (no `UntypedFormGroup`)
+- [ ] No nested subscribes — proper RxJS operator chains
+- [ ] Route components lazy-loaded
+- [ ] No `any` types — everything properly typed
+- [ ] New control flow syntax used (`@if`, `@for` with `track`)
+- [ ] Template logic extracted to component class or computed signals
+
+# Persistent Agent Memory
+
+Your `memory: project` setting gives you a persistent memory directory (under `.claude/agent-memory/grimoire.angular-coder/`). Contents persist across conversations.
+
+Consult your memory files to build on previous experience. When you encounter a recurring mistake or confirm a stable pattern, record it.
+
+Guidelines:
+- `MEMORY.md` is always loaded into your system prompt — keep it under 200 lines
+- Create separate topic files (e.g., `debugging.md`, `patterns.md`) for details and link from MEMORY.md
+- Update or remove memories that turn out to be wrong or outdated
+- Organize by topic, not chronologically
+
+What to save:
+- Stable patterns and conventions confirmed across multiple interactions
+- Key architectural decisions, important file paths, and project structure
+- User preferences for workflow, tools, and communication style
+- Solutions to recurring problems and debugging insights
+
+What NOT to save:
+- Session-specific context (current task details, in-progress work)
+- Information that might be incomplete — verify before writing
+- Anything that duplicates existing CLAUDE.md instructions
+- Speculative conclusions from reading a single file
+
+**Update your agent memory** as you discover patterns in the user's codebase — component conventions, service patterns, store structure, routing configuration, and recurring style choices. This builds institutional knowledge across conversations.
+
+Examples of what to record:
+- Existing services and what they do (e.g., `AuthService` handles JWT refresh)
+- Custom base components and their APIs (e.g., `BaseDialogComponent` expects a signal input)
+- Store structure decisions (e.g., all stores use NgRx Signal Store with entity management)
+- Routing patterns (e.g., all protected routes under `/app` with a functional guard)
+- Styling conventions (e.g., project uses Tailwind with design token CSS variables)

package/packs/frontend-pack/grimoire.json

@@ -2,6 +2,13 @@
   "name": "frontend-pack",
   "version": "1.0.0",
   "agents": [
+    {
+      "name": "grimoire.angular-coder",
+      "path": "agents/grimoire.angular-coder.md",
+      "description": "Use this agent when the user needs Angular code written, fixed, refactored, or debugged. This agent implements components, services, directives, pipes, guards, resolvers, and any other Angular artifact. It reads the codebase to understand conventions, makes implementation decisions, and delivers working code.",
+      "version": "1.0.0",
+      "file_patterns": ["*.component.ts", "*.service.ts", "*.directive.ts", "*.pipe.ts", "*.guard.ts", "*.resolver.ts", "*.module.ts"]
+    },
     {
       "name": "grimoire.vue3-coder",
       "path": "agents/grimoire.vue3-coder.md",

package/dist/commands/enforce-agent.d.ts

@@ -1,5 +0,0 @@
-/**
- * `grimoire enforce-agent` — interactive toggle for per-agent enforcement.
- */
-export declare function runEnforceAgent(projectDir: string): Promise<void>;
-//# sourceMappingURL=enforce-agent.d.ts.map

package/dist/commands/enforce-agent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"enforce-agent.d.ts","sourceRoot":"","sources":["../../src/commands/enforce-agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkHvE"}

package/dist/commands/enforce-agent.js

@@ -1,94 +0,0 @@
-/**
- * `grimoire enforce-agent` — interactive toggle for per-agent enforcement.
- */
-import { existsSync, readdirSync } from 'fs';
-import { join, basename } from 'path';
-import * as clack from '@clack/prompts';
-import { readManifest, writeManifest, setEnforce, readAgentMeta, ensureEnforceHooks, removeEnforceHooks, } from '../enforce.js';
-export async function runEnforceAgent(projectDir) {
-    // Load manifest
-    let manifest;
-    try {
-        manifest = readManifest(projectDir);
-    }
-    catch {
-        clack.log.error('No skills-manifest.json found. Run `grimoire add` first.');
-        process.exit(1);
-    }
-    // Scan installed agents
-    const agentsDir = join(projectDir, '.claude', 'agents');
-    if (!existsSync(agentsDir)) {
-        clack.log.error('No agents installed. Run `grimoire add` first.');
-        process.exit(1);
-    }
-    // Build list of agents that have file_patterns in the manifest
-    const agentFiles = readdirSync(agentsDir).filter((f) => f.endsWith('.md'));
-    const enforceable = [];
-    for (const file of agentFiles) {
-        const agentPath = join(agentsDir, file);
-        const fsName = basename(file, '.md');
-        // Look up manifest entry by filesystem name or manifest name
-        const manifestEntry = manifest.agents[fsName] ??
-            Object.entries(manifest.agents).find(([key]) => key.endsWith(`.${fsName}`) || key === fsName)?.[1];
-        const manifestName = Object.keys(manifest.agents).find((key) => key === fsName || key.endsWith(`.${fsName}`)) ?? fsName;
-        if (!manifestEntry?.file_patterns?.length)
-            continue;
-        const meta = readAgentMeta(agentPath);
-        enforceable.push({
-            name: fsName,
-            manifestName,
-            description: meta.description || manifestName,
-            currentlyEnforced: manifestEntry.enforce === true,
-        });
-    }
-    if (enforceable.length === 0) {
-        console.log('No enforceable agents found. Install a pack with file_patterns to enable enforcement.');
-        return;
-    }
-    clack.intro('Agent Enforcement');
-    const options = enforceable.map((a) => ({
-        value: a.manifestName,
-        label: a.manifestName,
-        hint: a.description.length > 80 ? a.description.slice(0, 80) + '…' : a.description,
-    }));
-    const initialValues = enforceable
-        .filter((a) => a.currentlyEnforced)
-        .map((a) => a.manifestName);
-    const selected = await clack.multiselect({
-        message: 'Select agents Claude must delegate to:',
-        options,
-        initialValues,
-        required: false,
-    });
-    if (clack.isCancel(selected)) {
-        clack.cancel('Cancelled.');
-        return;
-    }
-    const enabledNames = selected;
-    const enabledSet = new Set(enabledNames);
-    // Apply enforce flags
-    for (const agent of enforceable) {
-        try {
-            setEnforce(manifest, agent.manifestName, enabledSet.has(agent.manifestName));
-        }
-        catch (err) {
-            clack.log.warn(`Could not set enforcement for ${agent.manifestName}: ${err instanceof Error ? err.message : String(err)}`);
-        }
-    }
-    writeManifest(projectDir, manifest);
-    // Update hooks
-    if (enabledNames.length > 0) {
-        ensureEnforceHooks(projectDir, enabledNames);
-    }
-    else {
-        removeEnforceHooks(projectDir);
-    }
-    const count = enabledNames.length;
-    if (count > 0) {
-        clack.outro(`Agent enforcement updated. ${count} agent(s) enforced.`);
-    }
-    else {
-        clack.outro('Agent enforcement disabled.');
-    }
-}
-//# sourceMappingURL=enforce-agent.js.map

package/dist/commands/enforce-agent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"enforce-agent.js","sourceRoot":"","sources":["../../src/commands/enforce-agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,EACL,YAAY,EACZ,aAAa,EACb,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAkB;IACtD,gBAAgB;IAChB,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACH,QAAQ,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC5E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,wBAAwB;IACxB,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACxD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,+DAA+D;IAC/D,MAAM,UAAU,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAE3E,MAAM,WAAW,GAKZ,EAAE,CAAC;IAER,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAErC,6DAA6D;QAC7D,MAAM,aAAa,GACjB,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;YACvB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAC7C,GAAG,CAAC,QAAQ,CAAC,IAAI,MAAM,EAAE,CAAC,IAAI,GAAG,KAAK,MAAM,CAC7C,EAAE,CAAC,CAAC,CAAC,CAAC;QAET,MAAM,YAAY,GAChB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAC/B,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,MAAM,EAAE,CAAC,CACtD,IAAI,MAAM,CAAC;QAEd,IAAI,CAAC,aAAa,EAAE,aAAa,EAAE,MAAM;YAAE,SAAS;QAEpD,MAAM,IAAI,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;QACtC,WAAW,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,MAAM;YACZ,YAAY;YACZ,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,YAAY;YAC7C,iBAAiB,EAAE,aAAa,CAAC,OAAO,KAAK,IAAI;SAClD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CACT,uFAAuF,CACxF,CAAC;QACF,OAAO;IACT,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAEjC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,KAAK,EAAE,CAAC,CAAC,YAAY;QACrB,KAAK,EAAE,CAAC,CAAC,YAAY;QACrB,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW;KACnF,CAAC,CAAC,CAAC;IAEJ,MAAM,aAAa,GAAG,WAAW;SAC9B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC;SAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IAE9B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,WAAW,CAAS;QAC/C,OAAO,EAAE,wCAAwC;QACjD,OAAO;QACP,aAAa;QACb,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,QAAoB,CAAC;IAC1C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;IAEzC,sBAAsB;IACtB,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,YAAY,EAAE,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;QAC/E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,GAAG,CAAC,IAAI,CACZ,iCAAiC,KAAK,CAAC,YAAY,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC3G,CAAC;QACJ,CAAC;IACH,CAAC;IAED,aAAa,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAEpC,eAAe;IACf,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,kBAAkB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAC/C,CAAC;SAAM,CAAC;QACN,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC;IAClC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,KAAK,CAAC,KAAK,CAAC,8BAA8B,KAAK,qBAAqB,CAAC,CAAC;IACxE,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC"}