docs: document CLI workflow and move seeding to consumer apps

Author: somethim

README.md

@@ -45,19 +45,9 @@ Abac::addPermission('read', App\Models\Post::class, [
 
 3. Request is allowed when actor/resource attributes satisfy the grant constraints.
 
----
-
-## Documentation
-
-Full docs: [https://zennit-dev.github.io/abac/](https://zennit-dev.github.io/abac/)
-
-Local docs index: `docs/index.md`
-
----
-
 ## Artisan Commands
 
-The package ships with helper commands for publishing ABAC assets and scaffolding policy payloads.
+The package registers utility commands for consumer setup:
 
 ```bash
 php artisan abac:publish
@@ -66,10 +56,48 @@ php artisan abac:publish-env
 php artisan abac:scaffold --from-routes
 ```
 
-- `abac:publish` publishes ABAC config and environment variables in one step.
-- `abac:publish-config` publishes the `config/abac.php` file (supports `--force`).
-- `abac:publish-env` writes missing ABAC environment variables to a target env-style file.
-- `abac:scaffold --from-routes` generates policy stubs from `abac.middleware.resource_patterns`.
+- `abac:publish` runs config + env publishing in one command.
+- `abac:publish-config` publishes `config/abac.php`.
+- `abac:publish-env` appends missing ABAC environment variables to a chosen env file.
+- `abac:scaffold --from-routes` generates a starter policy JSON scaffold from `abac.middleware.resource_patterns`.
+
+## Seeding Permissions in Your App
+
+Seed permissions from your consuming application's seeders instead of package-provided seeders:
+
+```php
+<?php
+
+namespace Database\Seeders;
+
+use Illuminate\Database\Seeder;
+use zennit\ABAC\Facades\Abac;
+
+class AbacPermissionSeeder extends Seeder
+{
+    public function run(): void
+    {
+        Abac::addPermission('read', App\Models\Post::class, [
+            'role' => 'editor',
+            'resource.owner_id' => '123',
+        ]);
+
+        Abac::addPermission('update', App\Models\Post::class, [
+            'actor.role' => 'admin',
+        ]);
+    }
+}
+```
+
+Then call your seeder from `DatabaseSeeder` as part of your normal app bootstrap.
+
+---
+
+## Documentation
+
+Full docs: [https://zennit-dev.github.io/abac/](https://zennit-dev.github.io/abac/)
+
+Local docs index: `docs/index.md`
 
 ---
 

composer.json

@@ -1,7 +1,7 @@
 {
     "name": "zennit/abac",
     "description": "Attribute-Based Access Control (ABAC) for Laravel",
-    "version": "1.0.2",
+    "version": "1.0.3",
     "type": "library",
     "license": "MIT",
     "keywords": [
@@ -48,8 +48,7 @@
     "autoload": {
         "psr-4": {
             "zennit\\ABAC\\": "src/",
-            "zennit\\ABAC\\Database\\Factories\\": "database/factories/",
-            "zennit\\ABAC\\Database\\Seeders\\": "database/seeders/"
+            "zennit\\ABAC\\Database\\Factories\\": "database/factories/"
         },
         "files": [
             "src/helpers.php"

config/abac.php

@@ -66,20 +66,6 @@
         'default_policy_behavior' => env('ABAC_DEFAULT_POLICY_BEHAVIOR', AbacDefaults::DEFAULT_POLICY_BEHAVIOR),
     ],
 
-    /*
-    |--------------------------------------------------------------------------
-    | ABAC Seeders Configuration
-    |--------------------------------------------------------------------------
-    |
-    | This section defines the paths to the JSON files used by the ABAC seeders.
-    | These paths are relative to the resources' directory.
-    */
-    'seeders' => [
-        'actor_attribute_path' => 'stubs/abac/actor_attribute_path.json',
-        'resource_attribute_path' => 'stubs/abac/resource_attribute_path.json',
-        'policy_file_path' => 'stubs/abac/abac_policy_file_path.json',
-    ],
-
     'permissions' => [
         'resources' => [], // alias => model class
     ],