@tacuchi/agent-workflow-cli 25.7.0 → 25.9.0

package/skills/w/roles/sql/ROLE.md

@@ -5,7 +5,7 @@ description: >-
   changes as versioned scripts (never executing them): writes statements to the
   session `SCRIPTS.sql` with `@category` + `@stmt` markers, applies project SQL
   style (canonical header, BEGIN/COMMIT, idempotency, explicit schema, CTEs over
-  DO/LOOP), classifies into the 4 categories, and knows how rollbacks are derived
+   DO/LOOP), classifies into the 5 categories, and knows how rollbacks are derived
   on export. DB access is read-only via MCP — DML/DDL is NEVER executed (invariant 4).
   Use when a loop writes migrations / queries, when research reads schema, or when
   export-scripts consolidates the bundle.
@@ -41,11 +41,12 @@ The AI **never executes DML/DDL** against any DB, through any channel (MCP, `psq
 - Choose only a registered connection; the registry, not environment-name conventions, supplies its exact DSN variable.
 - A remote snapshot is recorded before plan approval and is never refreshed from `plan-exec`.
 
-### Staging — a single `SCRIPTS.sql` per session
+### Staging — separate forward and rollback artifacts per session
 
 ```
 .workflow/sessions/<folder>/
-└── SCRIPTS.sql      (consolidated: ALL of the session's statements)
+├── SCRIPTS.sql           (forward migrations and type-A reads)
+└── SCRIPTS.rollback.sql  (reverse migrations, never applied with the forward)
 ```
 
 Every statement is **appended** with a pair of comment markers:
@@ -58,13 +59,13 @@ CREATE TABLE IF NOT EXISTS <schema>.<table> (
 );
 ```
 
-- `@category` classifies (4 canonical values, below).
+- `@category` classifies (5 canonical values, below).
 - `@stmt` gives the deterministic slug `NN-verb-target`; `export-scripts` derives the filename when splitting.
-- Order inside the file = chronological append order. The final per-category execution order (01→02→03→04) is resolved by `export-scripts`, not here.
+- Order inside the file = chronological append order. The final category order (01→02→03→04→05) is resolved by `export-scripts`.
 - A global `BEGIN;` at the top of the file, `COMMIT;` at the end. Individual statements carry **no** BEGIN/COMMIT of their own.
-- **No** per-file `.rollback.sql` during exec — the rollback is generated on export.
+- Put session reverses in `SCRIPTS.rollback.sql`, never after the forwards. Export pairs each forward with its own `.rollback.sql` under `rollback/`.
 
-### The 4 categories (`@category`)
+### The 5 categories (`@category`)
 
 | Marker | Detection patterns |
 |---|---|
@@ -72,8 +73,9 @@ CREATE TABLE IF NOT EXISTS <schema>.<table> (
 | `02-ddl-funciones` | `CREATE [OR REPLACE] FUNCTION/PROCEDURE`, `DROP FUNCTION/PROCEDURE` |
 | `03-migracion` | `UPDATE`, `INSERT ... SELECT`, `DELETE` over existing data, column transformations |
 | `04-inserts` | `INSERT INTO ... VALUES`, catalog seeds, initial configuration data |
+| `05-grants` | `GRANT`/`REVOKE`, `ALTER … OWNER TO`, `ALTER DEFAULT PRIVILEGES` |
 
-**Mandatory execution order**: 01 → 02 → 03 → 04. `SCRIPTS.sql` may mix categories chronologically; `export-scripts` orders the final bundle.
+**Mandatory execution order**: 01 → 02 → 03 → 04 → 05. `SCRIPTS.sql` may mix categories chronologically; `export-scripts` orders the final bundle.
 
 ### SQL style
 
@@ -110,12 +112,12 @@ CREATE TABLE IF NOT EXISTS <schema>.<table> (
 2. **Verify idempotency** of the statement.
 3. **Append** with the marker pair (`@category` + `@stmt`).
 4. **Style check** — canonical header, CTEs over DO/LOOP, explicit schema.
-5. **Never** renumber or move (there is a single `SCRIPTS.sql`).
-6. **Never** generate `.rollback.sql` during exec.
+5. **Never** renumber or move `SCRIPTS.sql` during exec.
+6. Keep the inverse in the separate `SCRIPTS.rollback.sql`.
 
-### Rollback (generated by `export-scripts`, not here)
+### Rollback (session draft and export)
 
-`export-scripts` reads the consolidated forwards and generates **a single** `00-ROLLBACK.sql` at the bundle root, in reverse order. Know the strategies to write reversible forwards:
+Write session reverses in `SCRIPTS.rollback.sql`. `export-scripts` pairs each final forward with `rollback/<categoría>/NN-<nombre>.rollback.sql` and derives `rollback/00-global/00-ROLLBACK.sql` in safe reverse order. Know the strategies to write reversible forwards:
 
 | Forward | Rollback |
 |---|---|
@@ -131,8 +133,8 @@ CREATE TABLE IF NOT EXISTS <schema>.<table> (
 
 ## Output
 
-- During loops: statements appended to `.workflow/sessions/<folder>/SCRIPTS.sql` (session artifact, never `docs/`).
-- Via `export-scripts`: the `docs/scripts/NNN-export-scripts-YYYY-MM-DD/` bundle — `00-ROLLBACK.sql` + `01-<CATEGORY>.sql` … (continuous numbering, no gaps for empty categories) + `README.md`. Canonical category order: `DDL-TABLES → DDL-FUNCTIONS → DML → INSERTS`.
+- During loops: forwards in `SCRIPTS.sql`, reverses in `SCRIPTS.rollback.sql` (session artifacts, never `docs/`).
+- Via `export-scripts`: five category folders (`01-ddl-tablas` … `05-grants`) with numbered forwards, matching reverses in `rollback/<categoría>/` and the global reverse in `rollback/00-global/00-ROLLBACK.sql`; empty categories have no folder.
 
 It never writes `docs/` from a loop (invariant 1: only `export-*` exports). It never executes anything against a DB (invariant 4).
 

package/skills/w/schemas/design/ui-screen.v1.schema.json

@@ -88,6 +88,15 @@
       },
       "uniqueItems": true
     },
+    "screen_refs": {
+      "description": "Optional screen revisions cited by this screen's body; a state anchor cites the declared revision.",
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^DES-(?:[0-9]{3}|[1-9][0-9]{3,})/SCR-(?:[0-9]{3}|[1-9][0-9]{3,})@r[1-9][0-9]{0,5}$"
+      },
+      "uniqueItems": true
+    },
     "dependencies": {
       "type": "object",
       "additionalProperties": false,