@jskit-ai/agent-docs 0.1.50 → 0.1.51
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/patterns/INDEX.md +1 -1
- package/patterns/crud-scaffolding.md +12 -0
package/package.json
CHANGED
package/patterns/INDEX.md
CHANGED
|
@@ -18,7 +18,7 @@ How to use it:
|
|
|
18
18
|
- `page-scaffolding.md`
|
|
19
19
|
- child crud, nested crud, embedded list, subroute, separate page, parent/child layout
|
|
20
20
|
- `child-cruds.md`
|
|
21
|
-
- crud scaffold, crud server, crud ui, table creation, migrations, `crud-server-generator`, `crud-ui-generator`
|
|
21
|
+
- crud scaffold, crud server, crud ui, table creation, migrations, direct knex, weird-custom persistence, `crud-server-generator`, `crud-ui-generator`
|
|
22
22
|
- `crud-scaffolding.md`
|
|
23
23
|
- CRUD links, record placeholders, `paths.page()`, `resolveViewUrl`, `resolveEditUrl`, `resolveParams`
|
|
24
24
|
- `crud-links.md`
|
|
@@ -40,6 +40,18 @@ Meaning of `--internal`:
|
|
|
40
40
|
- it only suppresses public HTTP CRUD route registration
|
|
41
41
|
- it is not a substitute for ownership columns or action/route permissions
|
|
42
42
|
|
|
43
|
+
When a weird-custom persistence lane is proposed:
|
|
44
|
+
|
|
45
|
+
- Treat hand-written repositories for persisted app-owned entity tables as an exception path, not a normal choice.
|
|
46
|
+
- That includes things like:
|
|
47
|
+
- direct knex instead of generated CRUD ownership
|
|
48
|
+
- a custom repository/service/provider stack for a normal persisted entity table
|
|
49
|
+
- inherited-ownership or mixed-visibility workarounds that dodge the standard CRUD ownership model
|
|
50
|
+
- Before taking that path, stop and ask the developer for explicit approval.
|
|
51
|
+
- Record the exact approval and the approved exception in `.jskit/WORKBOARD.md` before coding.
|
|
52
|
+
- If that exception changes the durable architecture rather than only the current chunk, record it in `.jskit/APP_BLUEPRINT.md` too.
|
|
53
|
+
- Without that explicit approval record, do not take the weird-custom persistence path.
|
|
54
|
+
|
|
43
55
|
Avoid:
|
|
44
56
|
|
|
45
57
|
- writing a hand migration for a CRUD table that JSKIT CRUD scaffolding is supposed to own
|