@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 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`. A lint
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`,
@@ -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.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",