cabloy 5.1.229 → 5.1.230

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/.cabloy-version CHANGED
@@ -1 +1 @@
1
- 5.1.229
1
+ 5.1.230
package/CHANGELOG.md CHANGED
@@ -1,5 +1,11 @@
1
1
  # Changelog
2
2
 
3
+ ## 5.1.230
4
+
5
+ ### Features
6
+
7
+ - Apply feature updates (details not specified in commit messages).
8
+
3
9
  ## 5.1.229
4
10
 
5
11
  ### Features
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cabloy",
3
- "version": "5.1.229",
3
+ "version": "5.1.230",
4
4
  "gitHead": "2c5c19284bab738e492856189acb6fad74b8a7b7",
5
5
  "description": "A Node.js fullstack framework",
6
6
  "keywords": [
@@ -95,7 +95,7 @@
95
95
  {
96
96
  "adapter": "codex",
97
97
  "category": "skill",
98
- "sha256": "b883f2b01ab79d51b23e899be43a1c90a821db916490f50c4b28958eedf36b6e",
98
+ "sha256": "c3233550631e7782834811d3bd73b9b823b0bd429a681cedff85e24128b9ed35",
99
99
  "source": "skills/cabloy-frontend-scaffold/SKILL.md",
100
100
  "target": ".agents/skills/cabloy-frontend-scaffold/SKILL.md"
101
101
  },
@@ -179,14 +179,14 @@
179
179
  {
180
180
  "adapter": "codex",
181
181
  "category": "skill",
182
- "sha256": "4f1b4b87b2c0d2ff485c58c8f891189fd3dc7914d66af806c1a808d22cd94124",
182
+ "sha256": "64615460c3bec383bb0010ddc1412e7fa8f122bbb3f87cfe5c824891fe247e6c",
183
183
  "source": "skills/cabloy-spec-execution/references/execution-protocol.md",
184
184
  "target": ".agents/skills/cabloy-spec-execution/references/execution-protocol.md"
185
185
  },
186
186
  {
187
187
  "adapter": "codex",
188
188
  "category": "skill",
189
- "sha256": "17fd93c93c94e5a5b36bcea2c70e779d031b8158b99d03556e8d358e80ad7893",
189
+ "sha256": "9ec7a5dd8b7c1a5d561a96562ee754c148e1d14db953d3629075af89e38613d3",
190
190
  "source": "skills/cabloy-spec-execution/references/status-and-evidence.md",
191
191
  "target": ".agents/skills/cabloy-spec-execution/references/status-and-evidence.md"
192
192
  },
@@ -431,7 +431,7 @@
431
431
  {
432
432
  "adapter": "claude",
433
433
  "category": "skill",
434
- "sha256": "b883f2b01ab79d51b23e899be43a1c90a821db916490f50c4b28958eedf36b6e",
434
+ "sha256": "c3233550631e7782834811d3bd73b9b823b0bd429a681cedff85e24128b9ed35",
435
435
  "source": "skills/cabloy-frontend-scaffold/SKILL.md",
436
436
  "target": ".claude/skills/cabloy-frontend-scaffold/SKILL.md"
437
437
  },
@@ -515,14 +515,14 @@
515
515
  {
516
516
  "adapter": "claude",
517
517
  "category": "skill",
518
- "sha256": "4f1b4b87b2c0d2ff485c58c8f891189fd3dc7914d66af806c1a808d22cd94124",
518
+ "sha256": "64615460c3bec383bb0010ddc1412e7fa8f122bbb3f87cfe5c824891fe247e6c",
519
519
  "source": "skills/cabloy-spec-execution/references/execution-protocol.md",
520
520
  "target": ".claude/skills/cabloy-spec-execution/references/execution-protocol.md"
521
521
  },
522
522
  {
523
523
  "adapter": "claude",
524
524
  "category": "skill",
525
- "sha256": "17fd93c93c94e5a5b36bcea2c70e779d031b8158b99d03556e8d358e80ad7893",
525
+ "sha256": "9ec7a5dd8b7c1a5d561a96562ee754c148e1d14db953d3629075af89e38613d3",
526
526
  "source": "skills/cabloy-spec-execution/references/status-and-evidence.md",
527
527
  "target": ".claude/skills/cabloy-spec-execution/references/status-and-evidence.md"
528
528
  },
@@ -781,7 +781,7 @@
781
781
  {
782
782
  "adapter": "cursor",
783
783
  "category": "skill",
784
- "sha256": "b883f2b01ab79d51b23e899be43a1c90a821db916490f50c4b28958eedf36b6e",
784
+ "sha256": "c3233550631e7782834811d3bd73b9b823b0bd429a681cedff85e24128b9ed35",
785
785
  "source": "skills/cabloy-frontend-scaffold/SKILL.md",
786
786
  "target": ".cursor/skills/cabloy-frontend-scaffold/SKILL.md"
787
787
  },
@@ -865,14 +865,14 @@
865
865
  {
866
866
  "adapter": "cursor",
867
867
  "category": "skill",
868
- "sha256": "4f1b4b87b2c0d2ff485c58c8f891189fd3dc7914d66af806c1a808d22cd94124",
868
+ "sha256": "64615460c3bec383bb0010ddc1412e7fa8f122bbb3f87cfe5c824891fe247e6c",
869
869
  "source": "skills/cabloy-spec-execution/references/execution-protocol.md",
870
870
  "target": ".cursor/skills/cabloy-spec-execution/references/execution-protocol.md"
871
871
  },
872
872
  {
873
873
  "adapter": "cursor",
874
874
  "category": "skill",
875
- "sha256": "17fd93c93c94e5a5b36bcea2c70e779d031b8158b99d03556e8d358e80ad7893",
875
+ "sha256": "9ec7a5dd8b7c1a5d561a96562ee754c148e1d14db953d3629075af89e38613d3",
876
876
  "source": "skills/cabloy-spec-execution/references/status-and-evidence.md",
877
877
  "target": ".cursor/skills/cabloy-spec-execution/references/status-and-evidence.md"
878
878
  },
@@ -281,6 +281,8 @@ Always end with a verification path that matches the scope of the frontend chang
281
281
 
282
282
  For ordinary frontend changes, prefer a few critical user flows through the existing E2E infrastructure, selected by affected behavior with spec names, tags, or `--grep`. Reuse existing scenarios or extend them narrowly; do not require exhaustive isolated-test matrices, extensive fake dependencies, or custom source-evaluation loaders before delivery. When an actual problem is fixed, add focused regression coverage. Targeted unit or framework tests remain useful when they efficiently prove the behavior being changed; this is not a ban on existing tests or managed test-resource isolation.
283
283
 
284
+ Business E2E should primarily assert user actions, visible business outcomes, and persistence after save/reload. Do not turn architecture guidance into default browser assertions about Controller/IoC object identity, model instances, or Query/cache internals. Assert those internals only for an explicit architecture/framework acceptance contract or a focused regression, preferably at the smallest suitable unit, framework, or integration layer. This does not remove architecture requirements or server-side safety checks.
285
+
284
286
  Keep relevant format, lint, and type checks lightweight and scope-dependent. Prepare only the affected flavor's required artifacts for runtime verification. Preserve applicable route, SSR/hydration, authentication, authorization, contract, and acceptance checks; frontend E2E does not replace server-side enforcement. If runtime verification is unavailable or not authorized, report the gap rather than building a substitute harness. See [Frontend Scripts](../../../repo-docs/frontend/scripts.md) for edition-aware preparation and filtered E2E commands.
285
287
 
286
288
  Shared checks, when applicable, include:
@@ -115,6 +115,7 @@ Source ownership: <observed paths and proposed paths>
115
115
  Specialist route: <backend/frontend/contract-loop/specialist>
116
116
  Safety/contract constraints: <tenant, auth, lifecycle, transaction, SSR, migration, privacy>
117
117
  Verification: <exact approved ATP procedures and commands>
118
+ Failure handling: <bounded in-scope diagnosis/repair/reruns, limits, and explicit stop conditions; or stop/report only>
118
119
  Evidence: <required revision/environment/procedure/result/redacted artifact>
119
120
  Target classes: <observed existing / proposed new / explicitly approved new; design checks, ADR and planned additions>
120
121
  Quality gates: <authority audit; chart input eligibility/model/freshness; human approval/evidence>
@@ -147,10 +148,12 @@ Verify the approved connected outcome, not merely supporting helper behavior. On
147
148
 
148
149
  After user correction, redirect the affected approach rather than rename, relocate, or repackage rejected work. Reassess only the affected scope and preserve valid unchanged approvals; the correction does not itself authorize destructive cleanup or a different feature.
149
150
 
151
+ The approved dossier may cover bounded in-scope diagnosis, implementation/test repair, and reruns, including locator corrections. Record the first failure and subsequent attempts, then complete that connected work within the stated limits without another approval for each substep. Do not weaken expected business/security outcomes, skip required checks, or expand scope to obtain a pass. If repair/reruns are not authorized, the limit is reached, or the user explicitly required first-failure stopping, stop and report. This permission is prospective and never overrides an existing narrower approval.
152
+
150
153
  Stop and report rather than guessing when:
151
154
 
152
155
  - a command to run is not yet observed, or a creation path lacks the explicit approved-new design/ADR/execution boundary; future source absence alone is not a blocker for an approved creation task;
153
- - a test fails or a required artifact is missing;
156
+ - a failed test or missing required artifact cannot be resolved within the approved repair/rerun boundary, or an explicit stop condition applies;
154
157
  - the working tree becomes attribution-ambiguous;
155
158
  - a specialist discovers a requirement or contract change;
156
159
  - a planned external/destructive operation is needed;
@@ -24,6 +24,8 @@ Do not use `progress.md` to add requirements, technical contracts, acceptance pr
24
24
 
25
25
  ## Evidence layout
26
26
 
27
+ Retain the minimum sufficient evidence required by the test plan and attribution rules below. Prefer existing test-runner reports, redacted logs, and concise ATP/progress pointers rather than duplicating their contents across receipt layers. Do not create full input snapshots, exhaustive hash manifests, custom evidence verifiers, or multilayer receipts by default; new evidence machinery needs an explicit test-plan requirement or a concrete attribution/integrity risk that existing artifacts cannot address. Preserving source hashes during sanitization does not require inventing a new all-input hashing system. Keep mandatory revision/worktree attribution, actual failures, privacy review, and historical evidence intact unless a separate approved consolidation follows the lifecycle rules below.
28
+
27
29
  Prefer the scalable phase/ATP layout for newly observed proof when the suite permits extensions:
28
30
 
29
31
  ```text
@@ -104,6 +106,14 @@ A genuinely documentary/design-only task can instead follow `not-started -> in-p
104
106
 
105
107
  A task may be `implementation-complete` when source work is complete but an ATP, browser check, paired build, release gate, redaction decision, or durable artifact remains. A phase can be verified without implying that a separately defined integration or release phase is verified.
106
108
 
109
+ ## Evidence lifecycle and consolidation
110
+
111
+ Retain artifacts for a named ongoing development need, an applicable acceptance/retention requirement, or unique information still needed to explain a result. Creation alone and hypothetical future usefulness are not reasons for permanent retention. Maintained source-controlled business tests provide ongoing regression protection; historical run artifacts record only what happened for their attributed revision and do not prove changed code remains correct.
112
+
113
+ Keep current delivery state, coverage gaps, and blockers concise in the existing progress/phase records. Retain key acceptance results and only the supporting primary evidence and revision/dirty-worktree attribution they still require. Move durable discoveries needed for further development into the owning source tests, design record, or issue/handoff instead of depending on an artifact chain. Retired one-shot runners, resolved diagnostic detail, repeated inventories/snapshots, and documentary receipts need not remain permanently when they have no such purpose or unique information.
114
+
115
+ Inspect before deleting or overwriting historical material and obtain explicit approval for the consolidation/deletion scope, including replacement of any earlier unchanged-retention commitment. Preserve meaningful successes, failures, waivers, and gaps truthfully; retain primary proof required by continuing acceptance claims. Update incoming links and state when old hash-based verifiers are retired or no longer applicable rather than recreating their dependency chains. Do not delete by extension or Git status, replace the clutter with a giant archive or a new manifest/checker system, or promote acceptance status. Reorganizing existing evidence alone does not require rerunning business tests; verify affected references and records with existing tools. This guidance does not itself authorize cleanup or override a controlling retention requirement.
116
+
107
117
  ## Historical evidence and supersession
108
118
 
109
119
  Evidence is revision- and authority-scoped. When source paths, generated artifacts, contracts, scope, or security assumptions change:
@@ -2,6 +2,28 @@
2
2
 
3
3
  AI-assisted work should finish with checks that match the scope of the change.
4
4
 
5
+ ## Proportional verification
6
+
7
+ Prefer a few critical business flows through existing test infrastructure over exhaustive upfront matrices or bespoke verification harnesses. Preserve applicable security, authorization, tenant isolation, SSR/hydration, data consistency, migration, cleanup, and formal acceptance requirements.
8
+
9
+ ### Assert business outcomes at the business layer
10
+
11
+ Business E2E should focus on user actions, visible results, and persistence after save/reload, plus essential rejection paths. Architecture guidance is not automatically a requirement to inspect Controller/IoC object identity, model instances, or Query/cache internals in the browser. Test internal invariants when an explicit architecture/framework contract or an actual regression requires them, preferably at the smallest suitable unit, framework, or integration layer. Architecture requirements and server-side enforcement still apply.
12
+
13
+ ### Keep evidence sufficient, not elaborate
14
+
15
+ Prefer native test reports, redacted logs, and concise ATP/progress links. Retain required revision/worktree attribution, changed-file scope, exact procedures, relevant environment/fixture identities, and observed outcomes, including failures. Do not introduce full input snapshots, exhaustive hash manifests, custom evidence verifiers, or multiple receipt layers unless the test plan requires them or a concrete attribution/integrity risk cannot be addressed with existing artifacts. Preserve privacy review and historical evidence; simpler future evidence is not permission to delete old records.
16
+
17
+ Retain artifacts only for a named ongoing development need, an applicable acceptance/retention requirement, or unique information still needed to explain a result—not merely because they were generated or might someday be useful. Maintained source-controlled business tests provide ongoing regression protection; historical logs describe a particular run and cannot prove changed code remains correct. Keep current status and blockers in existing progress/phase records, and move durable discoveries into the owning tests, design record, or issue/handoff. A concise delivery summary plus the few primary artifacts needed to support continuing acceptance claims is preferable to permanent process-file chains.
18
+
19
+ Historical consolidation requires inspection and explicit approval of the deletion scope, including any change to prior retention commitments. Preserve meaningful outcomes, failures, waivers, gaps, and necessary revision attribution; update links and retire obsolete verifier expectations. Remove redundant snapshots/receipts and one-shot helpers only when their required or unique information is retained elsewhere or no longer needed. Do not substitute a giant archive or another checker system. Evidence reorganization alone needs reference/record checks, not business-test reruns, and never advances acceptance or overrides controlling retention requirements.
20
+
21
+ ### Handle failures within the approved boundary
22
+
23
+ For specification execution, the approved dossier may include bounded in-scope diagnosis, repair, and reruns, with limits and stop conditions. When covered, record the failure and perform the connected correction without requesting approval for every locator or test-fix substep. Do not weaken business/security expectations to obtain a pass. Stop when the approved repair/rerun boundary is absent or exhausted, an explicit first-failure stop applies, or new scope, authority, dependency, safety, external, or destructive-operation questions require renewed approval. This guidance does not broaden or retrospectively replace an existing approval.
24
+
25
+ See the canonical `cabloy-frontend-scaffold` verification guidance and the `cabloy-spec-execution` execution-protocol and status-and-evidence references for operational details.
26
+
5
27
  ## Documentation verification
6
28
 
7
29
  For public docs changes, verify at minimum: