@appweaver/cli 1.0.22 → 1.0.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appweaver/cli",
-  "version": "1.0.22",
+  "version": "1.0.24",
   "description": "Appweaver - the backend framework for AI-first development (@cli)",
   "author": "Luka Matosevic",
   "license": "MIT",

package/skill/GUIDELINES.md

@@ -18,7 +18,7 @@ provides factory methods for creating resource models, services, policies, and r
 - `appweaver.json` / `appweaver.{env}.json` - central configuration
 - `Dockerfile` - Docker image definition
 
-**IMPORTANT:** `{env}` is controlled by `NODE_ENV` evironment variable.
+**IMPORTANT:** `{env}` is controlled by `NODE_ENV` environment variable.
 
 ## Application entrypoint
 

package/skill/SKILL.md

@@ -553,7 +553,8 @@ weaver openapi --format yaml                          # generate schema in yaml
 weaver update                                 # update all @appweaver/* packages to latest
 weaver update @appweaver/core @appweaver/cli  # update specific packages
 weaver update --targetVersion 1.2.3           # update to a specific version
-weaver update --noSkill                       # skip updating AI agent skill files
+weaver update --noSkill                       # skip updating AI agent skill files (.claude, .agents, …)
+weaver update --noGuidelines                  # skip updating AI agent guideline files (AGENTS.md, CLAUDE.md)
 weaver update --force                         # force update despite peerDependency mismatches
 ```
 

package/skill/references/cli.md

@@ -205,9 +205,10 @@ Update the Appweaver packages.
 
 **Options:**
 
-| Option                            | Description                                                | Default    |
-|-----------------------------------|------------------------------------------------------------|------------|
-| `--targetVersion [targetVersion]` | The version to update the packages to                      | `"latest"` |
-| `--noSkill`                       | Skip updating AI agents skill files in the current project | `false`    |
-| `-f, --force`                     | Force update despite peerDependency version mismatches     | `false`    |
-| `--verbose`                       | Print verbose output                                       | `false`    |
+| Option                            | Description                                                              | Default    |
+|-----------------------------------|-------------------------------------------------------------------------|------------|
+| `--targetVersion [targetVersion]` | The version to update the packages to                                   | `"latest"` |
+| `--noSkill`                       | Skip updating AI agents skill files in agent dirs (`.claude`, `.agents`, …) | `false`    |
+| `--noGuidelines`                  | Skip updating AI agents guideline files (`AGENTS.md`, `CLAUDE.md`)       | `false`    |
+| `-f, --force`                     | Force update despite peerDependency version mismatches                  | `false`    |
+| `--verbose`                       | Print verbose output                                                    | `false`    |

package/skill/references/client.md

@@ -8,6 +8,23 @@ distinct parts:
 
 ---
 
+## Module formats (ESM & CommonJS)
+
+The package ships **both** an ESM and a CommonJS build, selected automatically via the `exports` map — no configuration
+needed. Both import styles work for the main entry and the `/angular` subpath:
+
+```ts
+// ESM (tree-shakable — preferred for bundlers like Angular/Vite/webpack prod builds)
+import { FetchClient, ClientError } from '@appweaver/client';
+import { AngularClient } from '@appweaver/client/angular';
+
+// CommonJS (e.g. plain Node scripts without a build step)
+const { FetchClient, ClientError } = require('@appweaver/client');
+const { AngularClient } = require('@appweaver/client/angular');
+```
+
+---
+
 ## `weaver-client` CLI
 
 ```
@@ -44,6 +61,7 @@ Reads an OpenAPI v3 schema and generates TypeScript types and a typed client cla
 | `--typesPath [path]`  | Output path for generated TypeScript types only                                            | same as `outputPath`      |
 | `--clientPath [path]` | Output path for generated client class only                                                | same as `outputPath`      |
 | `--clientName [name]` | Custom name for the generated client class                                                 | derived from schema title |
+| `--framework [name]`  | Framework for the generated client class (`fetch` or `angular`)                            | `fetch`                   |
 | `--typesOnly`         | Generate TypeScript types only, skip client class generation                               | `false`                   |
 | `--clientOnly`        | Generate client class only, skip TypeScript types generation                               | `false`                   |
 | `--noTypes`           | Generate client class without TypeScript type support                                      | `false`                   |
@@ -51,8 +69,8 @@ Reads an OpenAPI v3 schema and generates TypeScript types and a typed client cla
 **Generation process:**
 
 1. Reads and parses the schema (JSON or YAML, local or remote).
-2. Generates TypeScript interfaces via `openapi-typescript`, enriching them with JSDoc validation tags
-   (`@minLength`, `@maxLength`, `@minimum`, `@maximum`, `@pattern`, `@format`).
+2. Generates TypeScript interfaces via `openapi-typescript`, enriching them with JSDoc validation tags (`@minLength`,
+   `@maxLength`, `@minimum`, `@maximum`, `@pattern`, `@format`).
 3. Deduplicates union types and extracts inline schemas to named exported types.
 4. Classifies all API paths into route groups: resources, auth, account, health, files, and custom.
 5. Emits a typed client class extending `FetchClient<Paths>` with a getter for each route group. Resources with
@@ -158,6 +176,28 @@ The generated second type argument to `resourceClient` (e.g., `['aggregate', 'ex
 removes those methods from the returned `ResourceClient` at the TypeScript level, preventing accidental calls to
 operations not exposed by the API.
 
+### Angular client (`--framework angular`)
+
+Passing `--framework angular` generates a client class extending `AngularClient` instead of `FetchClient`. The generated
+class is constructed with Angular's `HttpClient` and all its methods return RxJS `Observable`s instead of
+`Promise`s:
+
+```ts
+import { ClientConfig, ClientError } from '@appweaver/client';
+import { AngularClient } from '@appweaver/client/angular';
+import { HttpClient } from '@angular/common/http';
+
+// In an Angular service or provider:
+const client = new CMSAPIClient(httpClient, { baseUrl: 'http://localhost:3000' });
+client.user.query({ filter: { enabled: true } }).subscribe((users) => {
+});
+```
+
+**Important:** `AngularClient` is only available from the `@appweaver/client/angular` subpath — it is not exported from
+the main `@appweaver/client` entry point. This keeps `rxjs` completely out of the module graph (runtime and types) for
+`FetchClient` users. `rxjs` is an **optional peer dependency**: Angular projects already have it installed, while
+fetch-only projects do not need it at all.
+
 ---
 
 ## Runtime library
@@ -438,8 +478,8 @@ const data = await client.sendRequest('get', '/api/custom-endpoint');
 
 ### `sendRequestRaw`
 
-Returns the raw `{ data, error, response }` tuple from `openapi-fetch` without throwing. Useful when the caller
-needs to inspect error details or branch on status codes.
+Returns the raw `{ data, error, response }` tuple from `openapi-fetch` without throwing. Useful when the caller needs to
+inspect error details or branch on status codes.
 
 ```ts
 const { data, error, response } = await client.sendRequestRaw('post', '/api/custom-endpoint', {

package/update/update-command.js

@@ -13,13 +13,15 @@ function updateCommand(program) {
         .argument('[packages...]', 'A list of packages to update (e.g. @appweaver/core @appweaver/cli).' +
         'Defaults to all currently installed @appweaver/* packages.')
         .option('--targetVersion [targetVersion]', 'The version to update the packages.', 'latest')
-        .option('--noSkill', 'Skip updating AI agents skill files in the current project.')
+        .option('--noSkill', 'Skip updating AI agents skill files in the agent directories (e.g. .claude, .agents) of the current project.')
+        .option('--noGuidelines', 'Skip updating AI agents guideline files (e.g. AGENTS.md, CLAUDE.md) in the current project.')
         .option('-f, --force', 'Force update despite peerDependency version mismatches.')
         .option('--verbose', 'Print verbose output.')
         .action(async (packages, _, command) => {
         const quiet = !command.getOptionValue('verbose');
         const force = command.getOptionValue('force');
         const updateSkill = !command.getOptionValue('noSkill');
+        const updateGuidelines = !command.getOptionValue('noGuidelines');
         const targetVersion = command.getOptionValue('targetVersion');
         // Load all currently installed packages
         const installedPackages = {};
@@ -71,8 +73,8 @@ function updateCommand(program) {
         }
         const status = await (0, update_packages_1.updatePackages)(appweaverPackages, targetVersion, force, quiet);
         if (status === 0) {
-            if (updateSkill) {
-                await (0, update_skill_1.updateSkillFiles)(quiet);
+            if (updateSkill || updateGuidelines) {
+                await (0, update_skill_1.updateSkillFiles)(quiet, updateSkill, updateGuidelines);
             }
             console.log(`Successfully updated packages to ${targetVersion} version.`);
         }

package/update/update-skill.d.ts

@@ -3,6 +3,8 @@
  * to specified agent directories and updating references in guideline files.
  *
  * @param {boolean} quiet - If true, suppresses logging output; otherwise, logs actions performed.
+ * @param {boolean} updateSkill - If true, copies skill files into agent directories (e.g. .claude, .agents).
+ * @param {boolean} updateGuidelines - If true, updates AI guideline files (e.g. AGENTS.md, CLAUDE.md).
  * @return {Promise<void>} A promise that resolves when the update process is complete.
  */
-export declare function updateSkillFiles(quiet: boolean): Promise<void>;
+export declare function updateSkillFiles(quiet: boolean, updateSkill?: boolean, updateGuidelines?: boolean): Promise<void>;

package/update/update-skill.js

@@ -12,9 +12,14 @@ const node_path_1 = __importDefault(require("node:path"));
  * to specified agent directories and updating references in guideline files.
  *
  * @param {boolean} quiet - If true, suppresses logging output; otherwise, logs actions performed.
+ * @param {boolean} updateSkill - If true, copies skill files into agent directories (e.g. .claude, .agents).
+ * @param {boolean} updateGuidelines - If true, updates AI guideline files (e.g. AGENTS.md, CLAUDE.md).
  * @return {Promise<void>} A promise that resolves when the update process is complete.
  */
-async function updateSkillFiles(quiet) {
+async function updateSkillFiles(quiet, updateSkill = true, updateGuidelines = true) {
+    if (!updateSkill && !updateGuidelines) {
+        return;
+    }
     const projectDir = process.cwd();
     const skillDir = node_path_1.default.join(__dirname, '..', 'skill');
     if (!(await exists(skillDir))) {
@@ -40,6 +45,11 @@ async function updateSkillFiles(quiet) {
             continue;
         }
         foundAgentDirs.push(agentDir);
+        // Skip copying skill files when disabled, but keep the discovered agent
+        // dir so guideline references can still point to it.
+        if (!updateSkill) {
+            continue;
+        }
         // Copy skill directory to {agentDir}/skills/appweaver/
         const skillDestPath = node_path_1.default.join(agentDirPath, 'skills', 'appweaver');
         await promises_1.default.cp(skillDir, skillDestPath, {
@@ -50,6 +60,10 @@ async function updateSkillFiles(quiet) {
             console.log(`Updated skill files in ${node_path_1.default.join(agentDir, 'skills', 'appweaver')}\n`);
         }
     }
+    // Nothing more to do when guideline files should not be updated
+    if (!updateGuidelines) {
+        return;
+    }
     let firstAgentDir = foundAgentDirs[0];
     for (const guidelinesFile of ['AGENTS.md', 'CLAUDE.md']) {
         const guidelinesFilePath = node_path_1.default.join(projectDir, guidelinesFile);
@@ -57,14 +71,17 @@ async function updateSkillFiles(quiet) {
         if (!(await exists(guidelinesFilePath))) {
             continue;
         }
-        // If no agent-specific dir was discovered, create new generic .agents dir
+        // If no agent-specific dir was discovered, fall back to a generic .agents
+        // dir and, unless skill updates are disabled, populate it with skill files.
         if (!firstAgentDir) {
             firstAgentDir = '.agents';
-            const skillDestPath = node_path_1.default.join(node_path_1.default.join(projectDir, firstAgentDir), 'skills', 'appweaver');
-            await promises_1.default.cp(skillDir, skillDestPath, {
-                recursive: true,
-                filter: (src) => !src.endsWith('GUIDELINES.md')
-            });
+            if (updateSkill) {
+                const skillDestPath = node_path_1.default.join(node_path_1.default.join(projectDir, firstAgentDir), 'skills', 'appweaver');
+                await promises_1.default.cp(skillDir, skillDestPath, {
+                    recursive: true,
+                    filter: (src) => !src.endsWith('GUIDELINES.md')
+                });
+            }
         }
         // Replace guideline file path references with path references in first
         // discovered agents dir