@appweaver/cli 1.0.23 → 1.0.25

package/package.json

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

package/skill/GUIDELINES.md

@@ -241,7 +241,7 @@ export async function createAdminUser(): Promise<void> {
     data: {
       firstName: 'Admin',
       lastName: 'Admin',
-      email: 'admin@appweaver.com',
+      email: 'admin@appweaver.co',
       roles: {
         connectOrCreate: [
           {

package/skill/SKILL.md

@@ -472,7 +472,7 @@ export async function createAdminUser(): Promise<void> {
     data: {
       firstName: 'Admin',
       lastName: 'Admin',
-      email: 'admin@appweaver.com',
+      email: 'admin@appweaver.co',
       phone: '01234435',
       roles: {
         connectOrCreate: [
@@ -553,7 +553,7 @@ 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 --force                         # force update despite peerDependency mismatches
 ```
 

package/skill/references/cli.md

@@ -205,9 +205,9 @@ 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`    |
+| `-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
 
 ```
@@ -52,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
@@ -161,8 +178,8 @@ 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
+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
@@ -172,7 +189,8 @@ 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) => {});
+client.user.query({ filter: { enabled: true } }).subscribe((users) => {
+});
 ```
 
 **Important:** `AngularClient` is only available from the `@appweaver/client/angular` subpath — it is not exported from
@@ -460,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,7 +13,7 @@ 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('-f, --force', 'Force update despite peerDependency version mismatches.')
         .option('--verbose', 'Print verbose output.')
         .action(async (packages, _, command) => {

package/update/update-skill.d.ts

@@ -1,8 +1,13 @@
 /**
- * Updates skill files and AI guidelines in the project by copying the skill directory
- * to specified agent directories and updating references in guideline files.
+ * Updates the Appweaver skill files in the project by copying the skill
+ * directory (including the framework GUIDELINES.md) into every discovered agent
+ * directory (e.g. `.claude`, `.agents`).
  *
- * @param {boolean} quiet - If true, suppresses logging output; otherwise, logs actions performed.
+ * The project's own root guidelines file (`AGENTS.md` / `CLAUDE.md`) is never
+ * touched here — it only references the framework guidelines from the skills
+ * directory, so it can be freely extended in the project.
+ *
+ * @param {boolean} quiet - If true, suppresses logging output; otherwise, logs actions are performed.
  * @return {Promise<void>} A promise that resolves when the update process is complete.
  */
 export declare function updateSkillFiles(quiet: boolean): Promise<void>;

package/update/update-skill.js

@@ -8,10 +8,15 @@ const node_fs_1 = __importDefault(require("node:fs"));
 const promises_1 = __importDefault(require("node:fs/promises"));
 const node_path_1 = __importDefault(require("node:path"));
 /**
- * Updates skill files and AI guidelines in the project by copying the skill directory
- * to specified agent directories and updating references in guideline files.
+ * Updates the Appweaver skill files in the project by copying the skill
+ * directory (including the framework GUIDELINES.md) into every discovered agent
+ * directory (e.g. `.claude`, `.agents`).
  *
- * @param {boolean} quiet - If true, suppresses logging output; otherwise, logs actions performed.
+ * The project's own root guidelines file (`AGENTS.md` / `CLAUDE.md`) is never
+ * touched here — it only references the framework guidelines from the skills
+ * directory, so it can be freely extended in the project.
+ *
+ * @param {boolean} quiet - If true, suppresses logging output; otherwise, logs actions are performed.
  * @return {Promise<void>} A promise that resolves when the update process is complete.
  */
 async function updateSkillFiles(quiet) {
@@ -23,9 +28,6 @@ async function updateSkillFiles(quiet) {
         }
         return;
     }
-    const guidelinesFilePath = node_path_1.default.join(skillDir, 'GUIDELINES.md');
-    const guidelinesContents = await promises_1.default.readFile(guidelinesFilePath, 'utf8');
-    const foundAgentDirs = [];
     for (const agentDir of [
         '.claude',
         '.junie',
@@ -39,48 +41,13 @@ async function updateSkillFiles(quiet) {
         if (!(await exists(agentDirPath))) {
             continue;
         }
-        foundAgentDirs.push(agentDir);
         // Copy skill directory to {agentDir}/skills/appweaver/
         const skillDestPath = node_path_1.default.join(agentDirPath, 'skills', 'appweaver');
-        await promises_1.default.cp(skillDir, skillDestPath, {
-            recursive: true,
-            filter: (src) => !src.endsWith('GUIDELINES.md')
-        });
+        await promises_1.default.cp(skillDir, skillDestPath, { recursive: true });
         if (!quiet) {
             console.log(`Updated skill files in ${node_path_1.default.join(agentDir, 'skills', 'appweaver')}\n`);
         }
     }
-    let firstAgentDir = foundAgentDirs[0];
-    for (const guidelinesFile of ['AGENTS.md', 'CLAUDE.md']) {
-        const guidelinesFilePath = node_path_1.default.join(projectDir, guidelinesFile);
-        // Update only agent guidelines files that already exist
-        if (!(await exists(guidelinesFilePath))) {
-            continue;
-        }
-        // If no agent-specific dir was discovered, create new generic .agents dir
-        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')
-            });
-        }
-        // Replace guideline file path references with path references in first
-        // discovered agents dir
-        const referencesPath = node_path_1.default
-            .join(firstAgentDir, 'skills', 'appweaver', 'references')
-            .replace(/\\/g, '/');
-        const guidelinesContent = guidelinesContents.replace(/(\[.+]\()references\/(.+\))/g, `$1${referencesPath}/$2`);
-        await promises_1.default.writeFile(guidelinesFilePath, guidelinesContent, {
-            encoding: 'utf8'
-        });
-        if (!quiet) {
-            console.log(`Updated AI guidelines file ${guidelinesFile}\n`);
-        }
-        // Update only the first found guidelines file
-        break;
-    }
 }
 async function exists(filePath) {
     try {