@appweaver/cli 1.0.3 → 1.0.4

package/README.md

@@ -1,6 +1,30 @@
 # Appweaver - CLI
 
-> Simple, fast, and reliable web application builder tool.
+![npm](https://img.shields.io/npm/v/@appweaver/cli)
+![NPM License](https://img.shields.io/npm/l/@appweaver/cli)
+![npm](https://img.shields.io/npm/dw/@appweaver/cli)
+![npm](https://img.shields.io/badge/build-passing-brightgreen)
+
+> The backend framework for AI-assisted development. Scaffold, extend, and ship APIs with any agent.
+
+Appweaver is a batteries-included framework built on top of **Fastify** and **Prisma**, designed from the ground up to
+be developed with AI agents. Instead of writing backend boilerplate from scratch, you describe resources using concise
+factory functions and let the framework handle routing, validation, database, auth, migrations, so you can focus
+on business logic instead of boilerplate.
+
+### Why Appweaver for agentic development?
+
+- **80% fewer tokens** → Appweaver's conventions and factory API eliminate the boilerplate that dominates most backend
+  codebases. Your agent reads and writes only the code that matters, not hundreds of lines of scaffolding.
+- **Zero-code configuration** → every framework behavior like server, database, auth, queues, mailer, storage is
+  controlled through `appweaver.json` config files or environment variables. No code changes are needed to reconfigure
+  the app for a different environment.
+- **Agent-first conventions** → a consistent, predictable project structure means agents always know where to find and
+  place code: models, services, routes, and policies each live in their own file under `src/resources/<name>/`.
+- **Built-in skill files** → every scaffolded project ships with agent-readable skill files that give your agent harness
+  a complete map of the framework's API, conventions, and CLI, which means no hallucination, and no trial-and-error.
+- **Works with any agent harness** → Claude Code, Cursor, Codex, Copilot Workspace, or any coding assistant that can
+  read project files. Point your agent at the skill files, and it has everything it needs.
 
 ## License
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@appweaver/cli",
-  "version": "1.0.3",
-  "description": "Appweaver - simple, fast, and reliable web application builder tool (@cli)",
+  "version": "1.0.4",
+  "description": "Appweaver - the backend framework for AI-assisted development (@cli)",
   "author": "Luka Matosevic",
   "license": "MIT",
   "main": "./weaver.js",

package/skill/GUIDELINES.md

@@ -124,8 +124,8 @@ import { createPolicy } from '@appweaver/core';
 
 export default createPolicy({
   modelName: 'Product',
-  checkAccess: (action, resource) => resource.status === 'Draft',
-  readRestrictions: (action, resource) => {
+  checkAccess: (user, resource, action) => resource.status === 'Draft',
+  readRestrictions: (user, resource, action) => {
     enabled: true;
   },
   files: {

package/skill/SKILL.md

@@ -294,8 +294,8 @@ import { createPolicy } from '@appweaver/core';
 
 export default createPolicy({
   modelName: 'Product',
-  checkAccess: (action, resource) => resource.status === 'Draft',
-  readRestrictions: (action, resource) => {
+  checkAccess: (user, resource, action) => resource.status === 'Draft',
+  readRestrictions: (user, resource, action) => {
     enabled: true;
   },
   files: {

package/skill/references/resources.md

@@ -820,8 +820,8 @@ import { createPolicy } from '@appweaver/core';
 
 export default createPolicy({
   modelName: 'Product',
-  checkAccess: (action, resource) => resource.status === 'Draft',
-  readRestrictions: (action, resource) => ({
+  checkAccess: (user, resource, action) => resource.status === 'Draft',
+  readRestrictions: (user, resource, action) => ({
     enabled: true
   }),
   files: {
@@ -837,13 +837,13 @@ function createPolicy(config: ResourcePolicyConfig, override ?: Partial<Resource
 }
 ```
 
-| Property            | Type                            | Description                                                                                                               |
-|---------------------|---------------------------------|---------------------------------------------------------------------------------------------------------------------------|
-| `modelName`         | string                          | Model name to bind this policy to (required).                                                                             |
-| `checkAccess`       | `(action, resource) => boolean` | Dynamic access check against a resource instance. Return `true` to allow, `false` to deny.                                |
-| `readRestrictions`  | `(action, resource) => filter`  | Returns a Prisma filter object applied to all read queries (find, query, aggregate). Restricts which records are visible. |
-| `writeRestrictions` | `(action, resource) => data`    | Returns data to merge or validate on create/update operations.                                                            |
-| `files`             | Record\<string, FilePolicy>     | Per-file field access policy.                                                                                             |
+| Property            | Type                                  | Description                                                                                                               |
+|---------------------|---------------------------------------|---------------------------------------------------------------------------------------------------------------------------|
+| `modelName`         | string                                | Model name to bind this policy to (required).                                                                             |
+| `checkAccess`       | `(user, resource, action) => boolean` | Dynamic access check against a resource instance. Return `true` to allow, `false` to deny.                                |
+| `readRestrictions`  | `(user, resource, action) => filter`  | Returns a Prisma filter object applied to all read queries (find, query, aggregate). Restricts which records are visible. |
+| `writeRestrictions` | `(user, resource, action) => data`    | Returns data to merge or validate on create/update operations.                                                            |
+| `files`             | Record\<string, FilePolicy>           | Per-file field access policy.                                                                                             |
 
 **Action types**: `'find'`, `'query'`, `'aggregate'`, `'create'`, `'update'`, `'delete'`