@appweaver/create-weaver-app 1.0.23 → 1.0.25

package/create-weaver-app.js

@@ -158,24 +158,34 @@ program
             agentsDir = '.agents';
         }
         const guidelinesFileName = agent === 'claude' ? 'CLAUDE.md' : 'AGENTS.md';
-        // Copy skill and referenced files
+        // Copy skill and referenced files. The framework guidelines
+        // (GUIDELINES.md) are preserved inside the skills directory so that
+        // `weaver update` can keep them in sync without touching the project's
+        // own root guidelines file.
         const skillDir = node_path_1.default.join(__dirname, 'skill');
         const projectSkillPath = node_path_1.default.join(agentsDir, 'skills', 'appweaver');
         const projectSkillDir = node_path_1.default.join(destDir, projectSkillPath);
         await promises_1.default.cp(skillDir, projectSkillDir, {
             recursive: true
         });
-        // Move the project guidelines file to the project root
-        const guidelinesSkillPath = node_path_1.default.join(projectSkillDir, 'GUIDELINES.md');
-        const guidelinesFilePath = node_path_1.default.join(destDir, guidelinesFileName);
-        await promises_1.default.rename(guidelinesSkillPath, guidelinesFilePath);
-        // Update project guidelines reference paths to point in skills directory
-        const guidelinesContents = await promises_1.default.readFile(guidelinesFilePath, 'utf8');
-        const referencesPath = node_path_1.default
-            .join(projectSkillPath, 'references')
+        // Create a thin root guidelines file that references the framework
+        // guidelines from the skills directory. This file is never overwritten
+        // by `weaver update`, so it can be freely extended in the project.
+        const guidelinesPath = node_path_1.default
+            .join(projectSkillPath, 'GUIDELINES.md')
             .replace(/\\/g, '/');
-        const updatedGuidelinesContent = guidelinesContents.replace(/(\[.+]\()references\/(.+\))/g, `$1${referencesPath}/$2`);
-        await promises_1.default.writeFile(guidelinesFilePath, updatedGuidelinesContent, {
+        const guidelinesFilePath = node_path_1.default.join(destDir, guidelinesFileName);
+        const guidelinesReference = agent === 'claude'
+            ? `@${guidelinesPath}`
+            : `[Appweaver framework guidelines](${guidelinesPath})`;
+        const guidelinesContent = `# ${variables.NAME}\n\n` +
+            `${description}\n\n` +
+            `This is an [Appweaver](https://github.com/lmatosevic/appweaver) project. ` +
+            `Follow the framework conventions, architecture, and usage documented in the guidelines:\n\n` +
+            `${guidelinesReference}\n\n` +
+            `<!-- Add your own project-specific instructions below this line. ` +
+            `This file is not modified by \`weaver update\`. -->\n`;
+        await promises_1.default.writeFile(guidelinesFilePath, guidelinesContent, {
             encoding: 'utf8'
         });
     }
@@ -285,11 +295,11 @@ function getDatabaseDockerConfig(command, name) {
         },
         mysql: {
             service: `  mysql:
-    image: mysql:8.4
+    image: mariadb:11.4
     container_name: ${name}-mysql
     restart: unless-stopped
     healthcheck:
-      test: [ "CMD", "mysqladmin", "ping", "-h", "127.0.0.1", "-u", "root", "-p$$MYSQL_ROOT_PASSWORD" ]
+      test: [ "CMD", "healthcheck.sh", "--connect", "--innodb_initialized" ]
       interval: 30s
       timeout: 10s
       retries: 10
@@ -298,10 +308,10 @@ function getDatabaseDockerConfig(command, name) {
     ports:
       - "127.0.0.1:3307:3306"
     environment:
-      MYSQL_DATABASE: "\${DB_NAME}"
-      MYSQL_USER: "\${DB_USER}"
-      MYSQL_PASSWORD: "\${DB_PASSWORD}"
-      MYSQL_ROOT_PASSWORD: "\${DB_PASSWORD}"
+      MARIADB_DATABASE: "\${DB_NAME}"
+      MARIADB_USER: "\${DB_USER}"
+      MARIADB_PASSWORD: "\${DB_PASSWORD}"
+      MARIADB_ROOT_PASSWORD: "\${DB_PASSWORD}"
     volumes:
       - mysql-data:/var/lib/mysql
     networks:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appweaver/create-weaver-app",
-  "version": "1.0.23",
+  "version": "1.0.25",
   "description": "Appweaver - the backend framework for AI-first development (@create-weaver-app)",
   "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', {