@fias/create-fias-plugin 1.1.3 → 1.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fias/create-fias-plugin",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "publishConfig": {
     "access": "public"
   },

package/templates/default/AGENTS.md

@@ -499,6 +499,7 @@ navigateTo('/settings');
 
 ### `useStepNavigation()` — Multi-step workflows
 
+**Permission:** None for in-memory use; `storage:sandbox` when `persistKey` is set (it reads/writes `__state/<persistKey>` via the storage bridge).
 **Returns:** `StepNavigationApi`
 
 ```tsx
@@ -780,6 +781,44 @@ If the AI review rejects your submission, the listing-fee portion is
 refunded automatically (the per-review portion is not, since review work
 happened either way).
 
+### Managing the asset library (for `useArcheAssets`)
+
+`useArcheAssets()` reads a contributor-curated set of images pinned to the arche's published version. Populate that library with the `assets` subcommands. Each command accepts `--env <staging|prod|local>` (default `staging`) and `--arche-id <id>` (auto-resolved from the manifest when omitted).
+
+```bash
+npx fias-dev assets enable                  # Turn on the asset library for this arche
+npx fias-dev assets status                  # Quota usage + billing summary
+npx fias-dev assets upload <dir>            # Bulk-upload images; subfolder name → default tag
+                                            # Flags: --concurrency <1-16>, --dry-run
+npx fias-dev assets list                    # List assets; --tag <tag>, --limit <1-100>
+npx fias-dev assets tag <assetId> --add <t> # Add or remove tags; --remove <t> also supported
+npx fias-dev assets delete <assetId>        # Soft-delete (excluded from future publishes); -y to skip confirm
+npx fias-dev assets disable                 # Turn off the asset library
+```
+
+Uploads stage into the contributor's draft set; they only become visible to plugin runtimes after the next `npm run submit` publishes a new arche version. Existing published versions keep their original frozen snapshot.
+
+### Managing collaborators
+
+Multi-developer plugins use `arche_collaborators` for operational ownership (publishing, team management) — distinct from financial ownership (`contributor_id`, which is immutable in v1). Every arche must keep ≥1 active owner; revokes that would drop to zero return `MUST_KEEP_ONE_OWNER`.
+
+```bash
+npx fias-dev collaborators list                            # List active collaborators
+npx fias-dev collaborators add <email|username|userId> \   # Default role: publisher
+    --role <owner|publisher|viewer> --expires <iso>        # Owners cannot have expiry
+npx fias-dev collaborators set <identifier> \              # Change role and/or expiry
+    --role <role> --expires <iso>                          # --no-expires clears expiry
+npx fias-dev collaborators remove <identifier>             # Revoke a collaborator
+```
+
+All commands accept `--env <staging|production|local>` (default `staging`).
+
+### Other CLI diagnostics
+
+```bash
+npx fias-dev check-auth                # Print per-environment auth status (which envs have saved keys)
+```
+
 ## Common Patterns
 
 ### Theme-Aware Card Component

package/templates/default/CLAUDE.md

@@ -499,6 +499,7 @@ navigateTo('/settings');
 
 ### `useStepNavigation()` — Multi-step workflows
 
+**Permission:** None for in-memory use; `storage:sandbox` when `persistKey` is set (it reads/writes `__state/<persistKey>` via the storage bridge).
 **Returns:** `StepNavigationApi`
 
 ```tsx
@@ -780,6 +781,44 @@ If the AI review rejects your submission, the listing-fee portion is
 refunded automatically (the per-review portion is not, since review work
 happened either way).
 
+### Managing the asset library (for `useArcheAssets`)
+
+`useArcheAssets()` reads a contributor-curated set of images pinned to the arche's published version. Populate that library with the `assets` subcommands. Each command accepts `--env <staging|prod|local>` (default `staging`) and `--arche-id <id>` (auto-resolved from the manifest when omitted).
+
+```bash
+npx fias-dev assets enable                  # Turn on the asset library for this arche
+npx fias-dev assets status                  # Quota usage + billing summary
+npx fias-dev assets upload <dir>            # Bulk-upload images; subfolder name → default tag
+                                            # Flags: --concurrency <1-16>, --dry-run
+npx fias-dev assets list                    # List assets; --tag <tag>, --limit <1-100>
+npx fias-dev assets tag <assetId> --add <t> # Add or remove tags; --remove <t> also supported
+npx fias-dev assets delete <assetId>        # Soft-delete (excluded from future publishes); -y to skip confirm
+npx fias-dev assets disable                 # Turn off the asset library
+```
+
+Uploads stage into the contributor's draft set; they only become visible to plugin runtimes after the next `npm run submit` publishes a new arche version. Existing published versions keep their original frozen snapshot.
+
+### Managing collaborators
+
+Multi-developer plugins use `arche_collaborators` for operational ownership (publishing, team management) — distinct from financial ownership (`contributor_id`, which is immutable in v1). Every arche must keep ≥1 active owner; revokes that would drop to zero return `MUST_KEEP_ONE_OWNER`.
+
+```bash
+npx fias-dev collaborators list                            # List active collaborators
+npx fias-dev collaborators add <email|username|userId> \   # Default role: publisher
+    --role <owner|publisher|viewer> --expires <iso>        # Owners cannot have expiry
+npx fias-dev collaborators set <identifier> \              # Change role and/or expiry
+    --role <role> --expires <iso>                          # --no-expires clears expiry
+npx fias-dev collaborators remove <identifier>             # Revoke a collaborator
+```
+
+All commands accept `--env <staging|production|local>` (default `staging`).
+
+### Other CLI diagnostics
+
+```bash
+npx fias-dev check-auth                # Print per-environment auth status (which envs have saved keys)
+```
+
 ## Common Patterns
 
 ### Theme-Aware Card Component