@astram/guide 0.2.2 → 0.2.3
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/CAPABILITIES.md +2 -1
- package/FRAMEWORK_RULES.md +8 -0
- package/package.json +1 -1
package/CAPABILITIES.md
CHANGED
|
@@ -140,7 +140,8 @@ imports: [
|
|
|
140
140
|
`readScope` declares the subtree wall; `create: 'unscoped'` opts a type out of the create wall.
|
|
141
141
|
- **Physical wall** — the raw DB pool is sealed in the engine. The scaffold's
|
|
142
142
|
`server/eslint.config.mjs` fails lint on driver imports, raw pools, `.query()` and the
|
|
143
|
-
framework's internal DB exports anywhere in `src/**` except `app.module.ts` and `main.ts
|
|
143
|
+
framework's internal DB exports anywhere in `src/**` except `app.module.ts` and `main.ts`, and on
|
|
144
|
+
uuid-named route/body inputs read without `UuidPipe` / `uuidField` (`@astram/guard`). A lint
|
|
144
145
|
rule is a backstop, not a sandbox: do not go around it.
|
|
145
146
|
- **Gap signal** — an unsupported field type or operation throws `CapabilityNotSupportedError`
|
|
146
147
|
(a Rule-4 STOP). Field types this version: `string`, `number`, `boolean`, `uuid`, `timestamp`,
|
package/FRAMEWORK_RULES.md
CHANGED
|
@@ -71,6 +71,14 @@ app refuses to boot with one — a forgotten declaration locks the door instead
|
|
|
71
71
|
silently exposing it. Never make a route public to "make it work"; classify it
|
|
72
72
|
correctly.
|
|
73
73
|
|
|
74
|
+
**Validate uuid inputs at the edge.** Every uuid route param uses `UuidPipe`
|
|
75
|
+
(`@Param('uuid', UuidPipe)`) and every uuid body or query field goes through
|
|
76
|
+
`uuidField` / `optionalUuidField` / `uuidArrayField` (all from `@astram/guard`). They
|
|
77
|
+
answer 400 for anything that is not a strict uuid and hand you the canonical lower-case
|
|
78
|
+
form. The database matches uuids ignoring case, trailing spaces and character width, so
|
|
79
|
+
a raw `"<id> "` reaches the row while your exact checks in code miss it. The lint wall
|
|
80
|
+
flags uuid-named inputs (`id`, `uuid`, `…Id(s)`, `…Uuid(s)`) read without them.
|
|
81
|
+
|
|
74
82
|
## 4. When the framework can't do it: STOP and FLAG the gap — do NOT work around it
|
|
75
83
|
|
|
76
84
|
This is the most important rule. When a feature needs a capability the framework does
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@astram/guide",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.3",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"description": "Astram framework — the AI/dev GUIDE layer (ADR-0025). Ships the framework's hard rules + capabilities manifest as installed, upgrade-refreshed docs. A consumer app's CLAUDE.md references FRAMEWORK_RULES.md from this package; `npm update` replaces it wholesale so new rules arrive cleanly, while the app's own .astram/guide/ layer is never touched. This is the framework-owned FLOOR: an app rule may tighten it, never weaken it.",
|
|
6
6
|
"type": "commonjs",
|