cabloy 5.1.190 → 5.1.192
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 +1 -1
- package/.github/workflows/agent-governance.yml +39 -0
- package/.github/workflows/docs-pages.yml +1 -0
- package/.gitignore +3 -0
- package/CHANGELOG.md +17 -0
- package/README.md +2 -2
- package/package.json +11 -5
- package/repo-agent-governance/adapters/claude/contract-loop-gate.ts +199 -0
- package/{.claude → repo-agent-governance}/commands/release.md +20 -20
- package/repo-agent-governance/managed-assets.json +887 -0
- package/repo-agent-governance/manifest.json +56 -0
- package/{CLAUDE.md → repo-agent-governance/policies/repository.md} +4 -2
- package/repo-agent-governance/scripts/governance.mjs +570 -0
- package/repo-agent-governance/scripts/pack-check.mjs +43 -0
- package/{.claude → repo-agent-governance}/skills/cabloy-contract-loop/references/contract-loop-map.md +4 -4
- package/{.claude → repo-agent-governance}/skills/cabloy-master-detail/SKILL.md +1 -1
- package/{.claude → repo-agent-governance}/skills/cabloy-module-removal/SKILL.md +1 -1
- package/{.claude → repo-agent-governance}/skills/cabloy-spec-execution/SKILL.md +1 -1
- package/{.claude → repo-agent-governance}/skills/cabloy-spec-execution/references/execution-protocol.md +8 -8
- package/{.claude → repo-agent-governance}/skills/cabloy-spec-execution/references/status-and-evidence.md +9 -9
- package/{.claude → repo-agent-governance}/skills/cabloy-spec-generation/SKILL.md +2 -2
- package/{.claude → repo-agent-governance}/skills/cabloy-spec-generation/references/repo-aware-discovery.md +7 -7
- package/{.claude → repo-agent-governance}/skills/cabloy-spec-generation/references/repo-specs-document-set.md +30 -30
- package/{.claude → repo-agent-governance}/skills/cabloy-spec-generation/references/traceability-and-status-rules.md +9 -9
- package/{.claude → repo-agent-governance}/skills/cabloy-workflow/SKILL.md +7 -8
- package/{.claude → repo-agent-governance}/skills/cabloy-worktree-environment/SKILL.md +9 -9
- package/{.claude → repo-agent-governance}/skills/cabloy-zova-source-reading/SKILL.md +5 -5
- package/repo-agent-governance/tests/governance.test.mjs +295 -0
- package/repo-agent-governance/tools/contract-loop/check.mjs +71 -0
- package/repo-agent-governance/tools/contract-loop/core.mjs +189 -0
- package/repo-agent-governance/tools/spec-charts/generate-implementation-charts.mjs +858 -0
- package/{.claude/skills/cabloy-spec-generation/scripts → repo-agent-governance/tools/spec-charts}/generate-implementation-charts.test.mjs +95 -20
- package/repo-docs/.vitepress/config.mjs +2 -0
- package/repo-docs/ai/agent-governance.md +80 -0
- package/repo-docs/ai/cli-to-skill-map.md +3 -3
- package/repo-docs/ai/docs-skills-rules-mapping.md +27 -26
- package/repo-docs/ai/edition-consistency-checklist.md +8 -6
- package/repo-docs/ai/future-skill-roadmap.md +2 -2
- package/repo-docs/ai/introduction.md +7 -6
- package/repo-docs/ai/repo-guidance.md +3 -2
- package/repo-docs/ai/rules-and-config.md +23 -15
- package/repo-docs/ai/skills.md +7 -7
- package/repo-docs/ai/verification.md +2 -1
- package/repo-docs/demo.md +12 -0
- package/repo-docs/fullstack/contract-loop-playbook.md +1 -1
- package/repo-docs/fullstack/quickstart.md +1 -1
- package/repo-docs/index.md +3 -0
- package/repo-docs/reference/package-map.md +3 -2
- package/repo-docs/reference/repo-scripts.md +17 -2
- package/scripts/bootstrapAgentGovernance.mjs +81 -0
- package/scripts/init.ts +1 -0
- package/scripts/release.ts +15 -0
- package/scripts/upgrade.ts +66 -7
- package/zova/packages-zova/zova/package.json +2 -2
- package/zova/pnpm-lock.yaml +3 -3
- package/zova/src/suite/a-home/modules/home-passport/src/model/passport.ts +2 -7
- package/zova/src/suite/cabloy-basic/modules/basic-details/src/bean/tableCell.actionOperationsRow.tsx +19 -13
- package/zova/src/suite/cabloy-basic/modules/basic-details/src/component/blockDetails/controller.tsx +11 -0
- package/zova/src/suite/cabloy-basic/modules/basic-details/src/component/blockToolbarBulk/controller.tsx +7 -4
- package/zova/src/suite/cabloy-basic/modules/basic-details/src/component/formFieldDetails/controller.tsx +14 -0
- package/zova/src/suite/cabloy-basic/modules/basic-details/src/lib/detailsPermissions.ts +65 -0
- package/zova/src/suite/cabloy-basic/modules/basic-details/src/lib/index.ts +1 -0
- package/zova/src/suite/cabloy-basic/modules/basic-details/src/lib/utils.ts +3 -3
- package/zova/src/suite/cabloy-basic/modules/basic-details/src/types/details.ts +6 -1
- package/zova/src/suite/cabloy-basic/modules/basic-details/test/lib/detailsPermissions.test.ts +125 -0
- package/zova/src/suite-vendor/a-zova/modules/a-openapi/package.json +1 -1
- package/zova/src/suite-vendor/a-zova/modules/a-openapi/src/types/permissions.ts +2 -8
- package/zova/src/suite-vendor/a-zova/modules/a-table/package.json +1 -1
- package/zova/src/suite-vendor/a-zova/modules/a-table/src/component/table/controller.tsx +2 -1
- package/zova/src/suite-vendor/a-zova/package.json +3 -3
- package/.claude/hooks/contract-loop-gate.ts +0 -421
- package/.claude/scheduled_tasks.lock +0 -1
- package/.claude/skills/cabloy-spec-generation/scripts/generate-implementation-charts.mjs +0 -385
- /package/{.claude → repo-agent-governance/adapters/claude}/settings.json +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-backend-scaffold/SKILL.md +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-backend-scaffold/evals/evals.json +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-backend-scaffold/references/backend-thread-map.md +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-backend-scaffold/references/follow-up-checklist.md +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-contract-loop/SKILL.md +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-contract-loop/evals/evals.json +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-contract-loop/references/resource-custom-state-pattern.md +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-contract-loop/references/verification-checklist.md +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-domain-planning/SKILL.md +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-frontend-scaffold/SKILL.md +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-frontend-scaffold/evals/evals.json +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-frontend-scaffold/references/follow-up-checklist.md +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-frontend-scaffold/references/frontend-thread-map.md +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-resource-field-update/SKILL.md +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-resource-field-update/evals/evals.json +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-resource-field-update/references/custom-renderer-demo-checklist.md +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-resource-field-update/references/field-update-decision-tree.md +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-resource-field-update/references/follow-up-checklist.md +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-resource-field-update/references/verification-checklist.md +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-spec-execution/evals/evals.json +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-spec-generation/evals/evals.json +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-workflow/evals/evals.json +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-workflow/references/cli-strategy.md +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-workflow/references/edition-detection.md +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-worktree-environment/evals/evals.json +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-zova-source-reading/references/analysis-modes.md +0 -0
- /package/{.claude → repo-agent-governance}/skills/cabloy-zova-source-reading/references/core-reading-paths.md +0 -0
|
@@ -98,10 +98,10 @@ One persisted domain may deliberately own both conventional Admin Resource opera
|
|
|
98
98
|
|
|
99
99
|
After generation, choose the consumer shape by boundary:
|
|
100
100
|
|
|
101
|
-
| Consumer
|
|
102
|
-
|
|
|
103
|
-
| Admin custom operation with the same authority, projection, and Resource page semantics
|
|
104
|
-
| Web self-service operation with different authority, server-derived owner scope, DTO projection, or page/SSR semantics | dedicated Web model → purpose-built self-service pages
|
|
101
|
+
| Consumer | Generated-contract follow-up |
|
|
102
|
+
| ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
|
|
103
|
+
| Admin custom operation with the same authority, projection, and Resource page semantics | thin module facade → `rest-resource.model.resource` → schema-driven Resource UI |
|
|
104
|
+
| Web self-service operation with different authority, server-derived owner scope, DTO projection, or page/SSR semantics | dedicated Web model → purpose-built self-service pages |
|
|
105
105
|
|
|
106
106
|
The Web model is valid only for the separate self-service state domain. It must not become a parallel owner for Admin `select`/`view`, schemas, permissions, or generic Resource page state. See `../../../../repo-docs/fullstack/admin-resource-and-web-self-service.md` for the complete architecture.
|
|
107
107
|
|
|
@@ -207,4 +207,4 @@ When helpful, structure the response around these points:
|
|
|
207
207
|
5. nested DTO naming and placement reminders
|
|
208
208
|
6. verification steps
|
|
209
209
|
|
|
210
|
-
Keep the response practical. The value of this skill is to route master-detail requests into the correct generator-first workflow while preserving the recursive ownership rules encoded by the current source.
|
|
210
|
+
Keep the response practical. The value of this skill is to route master-detail requests into the correct generator-first workflow while preserving the recursive ownership rules encoded by the current source.
|
|
@@ -142,4 +142,4 @@ When using this skill, structure the response around these points when helpful:
|
|
|
142
142
|
5. stale-generated-runtime recovery branch if needed
|
|
143
143
|
6. verification steps
|
|
144
144
|
|
|
145
|
-
Keep the response practical. The value of this skill is to choose the right removal branch quickly and keep generated working state in the correct role.
|
|
145
|
+
Keep the response practical. The value of this skill is to choose the right removal branch quickly and keep generated working state in the correct role.
|
|
@@ -26,7 +26,7 @@ From the active repository root, inspect:
|
|
|
26
26
|
|
|
27
27
|
1. `git rev-parse --show-toplevel`, `git status --short`, current `HEAD`, and the working-tree classification;
|
|
28
28
|
2. `__CABLOY_BASIC__` or `__CABLOY_START__`;
|
|
29
|
-
3. root `package.json` and `
|
|
29
|
+
3. root `package.json` and `repo-agent-governance/` (or the active generated adapter);
|
|
30
30
|
4. the target `repo-specs/<suite>/` directory and relevant source/module topology.
|
|
31
31
|
|
|
32
32
|
Interpret the markers as follows:
|
|
@@ -13,7 +13,7 @@ git rev-parse HEAD
|
|
|
13
13
|
find . -maxdepth 1 \( -name '__CABLOY_BASIC__' -o -name '__CABLOY_START__' \) -print
|
|
14
14
|
```
|
|
15
15
|
|
|
16
|
-
Then inspect the root `package.json`, `
|
|
16
|
+
Then inspect the root `package.json`, `repo-agent-governance/` (or the active generated adapter), the suite spec directory, and actual affected source paths. Classify the worktree as clean, dirty with unrelated changes, dirty with overlapping changes, or otherwise unknown. Do not clean or reset it to make execution easier.
|
|
17
17
|
|
|
18
18
|
For Basic, resolve current scripts, sites, flavors, UI, and generated paths from the active repository. For Start, inspect the active Start repository and use its own commands and flavor/site names. The shared execution model does not make edition-specific runtime facts interchangeable.
|
|
19
19
|
|
|
@@ -111,13 +111,13 @@ Require explicit confirmation. If the user changes scope, rebuild the dossier an
|
|
|
111
111
|
|
|
112
112
|
## 6. Specialist routing
|
|
113
113
|
|
|
114
|
-
| Task shape
|
|
115
|
-
|
|
|
116
|
-
| Vona module/bean/service/model/entity/DTO/validation/migration/test
|
|
117
|
-
| Zova page/component/route/model/metadata/SSR/test
|
|
118
|
-
| OpenAPI, SDK/schema, generated consumer, reverse metadata, stale consumer | `cabloy-contract-loop`
|
|
119
|
-
| master-detail, resource-field, module removal
|
|
120
|
-
| requirement, architecture, scope, identity, or authority change
|
|
114
|
+
| Task shape | Primary route | Coordinator must preserve |
|
|
115
|
+
| ------------------------------------------------------------------------- | --------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
|
|
116
|
+
| Vona module/bean/service/model/entity/DTO/validation/migration/test | `cabloy-backend-scaffold` | CLI-first generation, tenant/security review, migration/index/version gate, tests, OpenAPI impact |
|
|
117
|
+
| Zova page/component/route/model/metadata/SSR/test | `cabloy-frontend-scaffold` | route metadata, state ownership, hydration equivalence, emitted import suffixes, flavor/site proof |
|
|
118
|
+
| OpenAPI, SDK/schema, generated consumer, reverse metadata, stale consumer | `cabloy-contract-loop` | source-first direction, paired SSR/REST reverse build, `deps:vona`, no hand edits |
|
|
119
|
+
| master-detail, resource-field, module removal | corresponding specialist skill | specialized ownership and cleanup order |
|
|
120
|
+
| requirement, architecture, scope, identity, or authority change | `cabloy-spec-generation` / `cabloy-domain-planning` | no implementation around unresolved authority |
|
|
121
121
|
|
|
122
122
|
The coordinator may pass the dossier to the specialist; it should not duplicate the specialist’s detailed command tree.
|
|
123
123
|
|
|
@@ -54,15 +54,15 @@ Do not create an empty `evidence/` directory, placeholder `EVD-*` record, or fab
|
|
|
54
54
|
|
|
55
55
|
Use the suite’s canonical status meanings:
|
|
56
56
|
|
|
57
|
-
| Status
|
|
58
|
-
|
|
|
59
|
-
| `not-started`
|
|
60
|
-
| `in-progress`
|
|
61
|
-
| `implementation-complete` | Source work is reported complete, but required ATP or release evidence is incomplete.
|
|
62
|
-
| `verified`
|
|
63
|
-
| `blocked`
|
|
64
|
-
| `waived`
|
|
65
|
-
| `deferred`
|
|
57
|
+
| Status | Meaning |
|
|
58
|
+
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
59
|
+
| `not-started` | Defined, but implementation or acceptance evidence has not started. |
|
|
60
|
+
| `in-progress` | Work or verification has started, but closure checks remain. |
|
|
61
|
+
| `implementation-complete` | Source work is reported complete, but required ATP or release evidence is incomplete. |
|
|
62
|
+
| `verified` | Applicable WBS checks and ATPs passed, with durable traceable evidence containing revision, environment, exact procedure, result, and redacted artifact location. |
|
|
63
|
+
| `blocked` | A dependency, unresolved decision, failed gate, attribution problem, or missing required proof prevents closure. |
|
|
64
|
+
| `waived` | A temporary exception has an owner, reason, affected scope, and expiry; expiry becomes a release blocker. |
|
|
65
|
+
| `deferred` | Explicitly postponed scope; it is not complete or verified. |
|
|
66
66
|
|
|
67
67
|
The normal path is:
|
|
68
68
|
|
|
@@ -28,7 +28,7 @@ From the repository root, inspect:
|
|
|
28
28
|
|
|
29
29
|
1. `git rev-parse --show-toplevel` and `git status --short`;
|
|
30
30
|
2. `__CABLOY_BASIC__` and `__CABLOY_START__`;
|
|
31
|
-
3. the root `package.json` and `
|
|
31
|
+
3. the root `package.json` and `repo-agent-governance/` (or the active generated adapter);
|
|
32
32
|
4. existing `repo-specs/` indexes and related suite/module topology;
|
|
33
33
|
5. `npm run vona` and `npm run zova` when the records will cite implementation commands.
|
|
34
34
|
|
|
@@ -173,7 +173,7 @@ Optional records remain subordinate to the PRD/SRS/WBS/test-plan authority appro
|
|
|
173
173
|
|
|
174
174
|
While drafting, preserve these principles and tailor them to confirmed scope:
|
|
175
175
|
|
|
176
|
-
- `repo-specs/` is the product/business planning home; `repo-docs/` is public and agent-facing framework guidance; `repo-docs-internal/` holds supporting cross-suite maintainer rationale;
|
|
176
|
+
- `repo-specs/` is the product/business planning home; `repo-docs/` is public and agent-facing framework guidance; `repo-docs-internal/` holds supporting cross-suite maintainer rationale; `repo-agent-governance/skills/` is authored workflow behavior; do not assume a particular internal record exists in every edition;
|
|
177
177
|
- use suite-first ownership and distinguish new domain modules from reusable framework modules; do not duplicate an existing persistence or identity owner without a stated decision;
|
|
178
178
|
- treat the active Vona instance as the tenant by default; do not introduce a store, organization, or merchant entity unless the confirmed domain contract requires it;
|
|
179
179
|
- make identity, tenant scope, authorization, and ownership server-authoritative; menus, routes, browser filters, and UI visibility are not API authorization;
|
|
@@ -78,13 +78,13 @@ Hand actual implementation-time synchronization to `cabloy-contract-loop`.
|
|
|
78
78
|
|
|
79
79
|
## Documentation boundaries
|
|
80
80
|
|
|
81
|
-
| Content
|
|
82
|
-
|
|
|
83
|
-
| Product requirements, SRS contracts, WBS, ATPs, suite ADRs, delivery status | `repo-specs/<suite>/`
|
|
84
|
-
| Reusable user-facing or agent-facing framework guidance
|
|
85
|
-
| Cross-suite maintainer architecture, rationale, and engineering ADRs
|
|
86
|
-
| Short durable AI operating rules
|
|
87
|
-
| Reusable
|
|
81
|
+
| Content | Home |
|
|
82
|
+
| --------------------------------------------------------------------------- | ------------------------------------------------------------- |
|
|
83
|
+
| Product requirements, SRS contracts, WBS, ATPs, suite ADRs, delivery status | `repo-specs/<suite>/` |
|
|
84
|
+
| Reusable user-facing or agent-facing framework guidance | `repo-docs/` |
|
|
85
|
+
| Cross-suite maintainer architecture, rationale, and engineering ADRs | `repo-docs-internal/`; individual records may vary by edition |
|
|
86
|
+
| Short durable AI operating rules | `repo-agent-governance/policies/` |
|
|
87
|
+
| Reusable procedural workflow | `repo-agent-governance/skills/` |
|
|
88
88
|
|
|
89
89
|
Do not place suite product specifications in public docs, or copy repository-wide process rationale into every suite. Link to authoritative framework records instead.
|
|
90
90
|
|
|
@@ -24,18 +24,18 @@ The directory is repository-native, suite-local, and maintainer-facing. It is no
|
|
|
24
24
|
|
|
25
25
|
## Authority map
|
|
26
26
|
|
|
27
|
-
| Document
|
|
28
|
-
|
|
|
29
|
-
| `README.md`
|
|
30
|
-
| `prd.md`
|
|
31
|
-
| `srs.md`
|
|
32
|
-
| `pdp-wbs.md`
|
|
33
|
-
| `test-plan.md`
|
|
34
|
-
| `progress.md`
|
|
35
|
-
| `implementation-gantt.svg`
|
|
36
|
-
| `implementation-burndown.svg` | Deterministic derived scope/status view. Without dated history, it is a scope-count reference, not a time-series, velocity trend, or forecast.
|
|
37
|
-
| `decisions/*.md`
|
|
38
|
-
| `runbooks/*.md`
|
|
27
|
+
| Document | Authority |
|
|
28
|
+
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
29
|
+
| `README.md` | Index, reading order, baseline summary, topology, authority map, and related-record links. It does not replace the other documents. |
|
|
30
|
+
| `prd.md` | Product outcomes, personas, scope, journeys, business rules, product requirements, and product acceptance. |
|
|
31
|
+
| `srs.md` | System contracts, capability/data ownership, APIs/DTOs, authorization, state, transactions, invariants, frontend/SSR boundaries, and technical acceptance. |
|
|
32
|
+
| `pdp-wbs.md` | Delivery sequencing, dependencies, implementation tasks, completion checks, and delivery traceability. |
|
|
33
|
+
| `test-plan.md` | Quality priorities, executable acceptance scenarios, fixtures, evidence format, verification procedures, and release proof. |
|
|
34
|
+
| `progress.md` | Derived execution status, blockers, decisions needed, next proof, and evidence pointers. It never redefines requirements or contracts. |
|
|
35
|
+
| `implementation-gantt.svg` | Deterministic derived WBS view of phases, task order, dependencies, status, and optional ATP labels. It is not schedule or planning authority. |
|
|
36
|
+
| `implementation-burndown.svg` | Deterministic derived scope/status view. Without dated history, it is a scope-count reference, not a time-series, velocity trend, or forecast. |
|
|
37
|
+
| `decisions/*.md` | Durable suite-local scope, architecture, security, ownership, migration, or integration decisions. |
|
|
38
|
+
| `runbooks/*.md` | Operational procedures subordinate to the relevant SRS, ADR, WBS, and test plan. |
|
|
39
39
|
|
|
40
40
|
When records disagree, update the authoritative record first, then update downstream summaries, mappings, and derived status. After any change to `pdp-wbs.md`, `test-plan.md`, or `progress.md`, run `npm run spec:charts -- <suite>` followed by `npm run spec:charts:check -- <suite>`.
|
|
41
41
|
|
|
@@ -186,15 +186,15 @@ Use:
|
|
|
186
186
|
|
|
187
187
|
Initialize a new suite with statuses such as `not-started`, `deferred`, or explicitly `blocked`; do not mark planning work as verified. Use this vocabulary:
|
|
188
188
|
|
|
189
|
-
| Status
|
|
190
|
-
|
|
|
191
|
-
| `not-started`
|
|
192
|
-
| `in-progress`
|
|
193
|
-
| `implementation-complete` | Source work is reported complete, but required ATP evidence or release gates are incomplete.
|
|
194
|
-
| `verified`
|
|
195
|
-
| `blocked`
|
|
196
|
-
| `waived`
|
|
197
|
-
| `deferred`
|
|
189
|
+
| Status | Meaning |
|
|
190
|
+
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
|
|
191
|
+
| `not-started` | Defined, but implementation or acceptance evidence has not started. |
|
|
192
|
+
| `in-progress` | Work started, but closure checks are incomplete. |
|
|
193
|
+
| `implementation-complete` | Source work is reported complete, but required ATP evidence or release gates are incomplete. |
|
|
194
|
+
| `verified` | Required ATP evidence is observed and retained with revision, environment, procedure, result, and redacted artifact location. |
|
|
195
|
+
| `blocked` | A dependency, unresolved decision, or failed gate prevents closure. |
|
|
196
|
+
| `waived` | A temporary exception with owner, reason, and expiry; expiry makes it a release blocker. |
|
|
197
|
+
| `deferred` | Explicitly postponed scope, not completed scope. |
|
|
198
198
|
|
|
199
199
|
Progress must remain a derived register. It may point to evidence but must not become a second requirements document. Include a decision-register entry for each material site strategy and show strategy/identifier deferral as a blocker only on affected frontend/site WBS branches; source reading, planning, or a selected strategy alone is not implementation evidence.
|
|
200
200
|
|
|
@@ -244,13 +244,13 @@ Use `Accepted` only for explicitly confirmed durable decisions; otherwise use `P
|
|
|
244
244
|
|
|
245
245
|
Generate only when the confirmed scope requires them:
|
|
246
246
|
|
|
247
|
-
| Extension
|
|
248
|
-
|
|
|
249
|
-
| `presentation-contracts.md`
|
|
250
|
-
| `semantic-presentation-rollout.md`
|
|
251
|
-
| `runbooks/<provider-or-operation>.md` | Real external provider/webhook, sandbox/live operation, reconciliation, cutover, incident, or deployment procedure is in scope. Never include secrets.
|
|
252
|
-
| Additional ADRs
|
|
253
|
-
| `evidence/`
|
|
247
|
+
| Extension | Generate when |
|
|
248
|
+
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
249
|
+
| `presentation-contracts.md` | Multiple Admin/resource scenes need stable audience, task, information-area, editability, snapshot, or renderer decisions. Keep it subordinate to PRD/SRS. |
|
|
250
|
+
| `semantic-presentation-rollout.md` | Presentation/metadata work is staged, serial, resumable, and needs handoff gates. It does not replace WBS or test plan. |
|
|
251
|
+
| `runbooks/<provider-or-operation>.md` | Real external provider/webhook, sandbox/live operation, reconciliation, cutover, incident, or deployment procedure is in scope. Never include secrets. |
|
|
252
|
+
| Additional ADRs | A separate durable boundary or trade-off exists after ADR 0001. |
|
|
253
|
+
| `evidence/` | Actual ATP execution has produced retained redacted evidence. Do not create empty evidence to simulate progress. |
|
|
254
254
|
|
|
255
255
|
For a presentation matrix, record audience, task, resource/scene, business information areas, field boundaries, renderer choice, and linked PRD/SRS/ATP records. It must not redefine API authority, persistence, validation, authorization, page/state ownership, or SSR privacy.
|
|
256
256
|
|
|
@@ -260,8 +260,8 @@ For an operational runbook, record environment boundaries, secret-management rul
|
|
|
260
260
|
|
|
261
261
|
Every core document links to the README and relevant peers. Maintain a compact matrix like:
|
|
262
262
|
|
|
263
|
-
| Product area
|
|
264
|
-
|
|
|
263
|
+
| Product area | PRD | SRS | WBS | ATP | Evidence/status |
|
|
264
|
+
| -------------- | --------- | --------- | --------- | --------- | ----------------------------- |
|
|
265
265
|
| `<capability>` | `PRD-...` | `SRS-...` | `WBS-...` | `ATP-...` | `progress.md` / evidence link |
|
|
266
266
|
|
|
267
267
|
Every material product requirement needs at least one technical contract, delivery item, and executable acceptance scenario. Before reporting generation complete, statically audit exact-ID referential integrity and README/ADR decision-status consistency across the planning authority set. Exclude `evidence/` from this static audit: evidence is added only after execution.
|
|
@@ -64,15 +64,15 @@ Downstream records summarize or operationalize authority; they do not silently o
|
|
|
64
64
|
|
|
65
65
|
## Status semantics
|
|
66
66
|
|
|
67
|
-
| Status
|
|
68
|
-
|
|
|
69
|
-
| `not-started`
|
|
70
|
-
| `in-progress`
|
|
71
|
-
| `implementation-complete` | Source work is reported complete, but required ATP or release evidence is incomplete.
|
|
72
|
-
| `verified`
|
|
73
|
-
| `blocked`
|
|
74
|
-
| `waived`
|
|
75
|
-
| `deferred`
|
|
67
|
+
| Status | Meaning |
|
|
68
|
+
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
69
|
+
| `not-started` | Defined, but implementation or acceptance evidence has not started. |
|
|
70
|
+
| `in-progress` | Work or verification has started, but closure checks are incomplete. |
|
|
71
|
+
| `implementation-complete` | Source work is reported complete, but required ATP or release evidence is incomplete. |
|
|
72
|
+
| `verified` | Applicable WBS checks and ATPs passed, and durable evidence contains revision, environment, exact procedure, result, and redacted artifact location. |
|
|
73
|
+
| `blocked` | A failed gate, dependency, or unresolved decision prevents closure. |
|
|
74
|
+
| `waived` | A temporary exception explicitly approved with owner, reason, and expiry. |
|
|
75
|
+
| `deferred` | Explicitly postponed scope; it is not complete or verified. |
|
|
76
76
|
|
|
77
77
|
For a newly created plan, initialize delivery rows as `not-started`, `deferred`, or `blocked` as appropriate. Creating Markdown files never makes implementation `implementation-complete` or `verified`.
|
|
78
78
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: cabloy-workflow
|
|
3
|
-
description: This skill should be used when the main Cabloy problem is workflow routing before implementation: deciding between Vona backend scaffolding, Zova frontend scaffolding, contract-loop work, or docs/AI-enablement homes such as repo-docs, repo-docs-internal,
|
|
3
|
+
description: This skill should be used when the main Cabloy problem is workflow routing before implementation: deciding between Vona backend scaffolding, Zova frontend scaffolding, contract-loop work, or docs/AI-enablement homes such as repo-docs, repo-docs-internal, repo-agent-governance, commands, or skills, including cases where Cabloy Basic vs Cabloy Start assumptions affect that routing. Trigger on requests to route, classify, choose a workflow, choose an edition-specific path, or decide where Cabloy guidance should live. Do not use it once the task is already clearly a backend scaffold, frontend scaffold, or contract-loop job.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Cabloy Workflow
|
|
@@ -79,9 +79,8 @@ Use the docs/AI path when the task is about:
|
|
|
79
79
|
|
|
80
80
|
- `repo-docs/`
|
|
81
81
|
- `repo-docs-internal/`
|
|
82
|
-
- `
|
|
83
|
-
- `.claude/commands/`
|
|
84
|
-
- `.claude/skills/`
|
|
82
|
+
- `repo-agent-governance/`
|
|
83
|
+
- generated platform adapters such as `CLAUDE.md`, `.claude/commands/`, and `.claude/skills/`
|
|
85
84
|
- repo guidance for AI development
|
|
86
85
|
|
|
87
86
|
## Step 3: Start from shared entrypoints
|
|
@@ -91,7 +90,7 @@ Before inventing a workflow, inspect these shared surfaces:
|
|
|
91
90
|
- the repository or workspace `package.json` that owns the active scripts
|
|
92
91
|
- `npm run vona`
|
|
93
92
|
- `npm run zova`
|
|
94
|
-
- root `
|
|
93
|
+
- root `repo-agent-governance/` if present, otherwise the active generated adapter
|
|
95
94
|
- `repo-docs/` for public guidance
|
|
96
95
|
- `repo-docs-internal/` for supporting maintainer rationale
|
|
97
96
|
|
|
@@ -179,7 +178,7 @@ Relevant internal records support routing and implementation but do not block th
|
|
|
179
178
|
|
|
180
179
|
### Root rules and commands
|
|
181
180
|
|
|
182
|
-
Use `
|
|
181
|
+
Use `repo-agent-governance/policies/` and `commands/` as the authored source for:
|
|
183
182
|
|
|
184
183
|
- concise operational guidance
|
|
185
184
|
- named recurring workflows
|
|
@@ -187,7 +186,7 @@ Use `CLAUDE.md` and `.claude/commands/` for:
|
|
|
187
186
|
|
|
188
187
|
### Skills
|
|
189
188
|
|
|
190
|
-
Use
|
|
189
|
+
Use `repo-agent-governance/skills/` for:
|
|
191
190
|
|
|
192
191
|
- procedural workflows that benefit from reusable instructions
|
|
193
192
|
- edition-aware decision trees
|
|
@@ -208,7 +207,7 @@ For these requests:
|
|
|
208
207
|
|
|
209
208
|
- put the durable operational explanation in `repo-docs/`
|
|
210
209
|
- put supporting rationale and invariants in `repo-docs-internal/`; preserve the public operational explanation when a particular internal record is unavailable or irrelevant
|
|
211
|
-
- keep
|
|
210
|
+
- keep canonical repository policy short and behavioral, then render adapters
|
|
212
211
|
- do not treat `@Service()` as a business-layer naming decision only; for B2 it is a runtime-anchor placement choice
|
|
213
212
|
|
|
214
213
|
### Service underscore files
|
|
@@ -29,10 +29,10 @@ Before proposing configuration values or writing files:
|
|
|
29
29
|
|
|
30
30
|
Interpretation:
|
|
31
31
|
|
|
32
|
-
| Marker
|
|
33
|
-
|
|
|
34
|
-
| `__CABLOY_BASIC__` only | Cabloy Basic | `npm run test:e2e`
|
|
35
|
-
| `__CABLOY_START__` only | Cabloy Start | `npm run test:e2e`
|
|
32
|
+
| Marker | Edition | Managed clean E2E command |
|
|
33
|
+
| ----------------------- | ------------ | ------------------------- |
|
|
34
|
+
| `__CABLOY_BASIC__` only | Cabloy Basic | `npm run test:e2e` |
|
|
35
|
+
| `__CABLOY_START__` only | Cabloy Start | `npm run test:e2e` |
|
|
36
36
|
|
|
37
37
|
Stop without edits when both markers are present, neither marker is present, the checkout is primary/unregistered, required environment directories are missing, or the selected edition's required scripts are unavailable.
|
|
38
38
|
|
|
@@ -66,11 +66,11 @@ offset = linkedWorktreeOrdinal + batch
|
|
|
66
66
|
|
|
67
67
|
Use these fixed baseline ports, which match the committed Cabloy defaults:
|
|
68
68
|
|
|
69
|
-
| Setting
|
|
70
|
-
|
|
|
71
|
-
| `SERVER_LISTEN_PORT`
|
|
72
|
-
| `DEV_SERVER_PORT`
|
|
73
|
-
| `DEV_SERVER_HMR_PORT` |
|
|
69
|
+
| Setting | Baseline | Recommended value |
|
|
70
|
+
| --------------------- | -------: | ----------------- |
|
|
71
|
+
| `SERVER_LISTEN_PORT` | `7102` | `7102 + offset` |
|
|
72
|
+
| `DEV_SERVER_PORT` | `9000` | `9000 + offset` |
|
|
73
|
+
| `DEV_SERVER_HMR_PORT` | `24679` | `24679 + offset` |
|
|
74
74
|
|
|
75
75
|
Set `APP_NAME` to the basename of the validated current worktree root. Do not inspect other worktrees’ configurations or append an env-derived suffix. Stop if that basename is empty or cannot be used as an application name without altering it; ask the user to rename/recreate the linked worktree instead.
|
|
76
76
|
|
|
@@ -193,11 +193,11 @@ When explaining a split page or component, establish role ownership before discu
|
|
|
193
193
|
|
|
194
194
|
The source-confirmed direct member lookup order is:
|
|
195
195
|
|
|
196
|
-
| Current bean | Direct member lookup order
|
|
197
|
-
|
|
|
198
|
-
| Controller
|
|
199
|
-
| Style
|
|
200
|
-
| Render
|
|
196
|
+
| Current bean | Direct member lookup order |
|
|
197
|
+
| ------------ | ----------------------------------- |
|
|
198
|
+
| Controller | Controller only |
|
|
199
|
+
| Style | Style, then Controller |
|
|
200
|
+
| Render | Render, then Controller, then Style |
|
|
201
201
|
|
|
202
202
|
State the shadowing caveat: an own member on the current bean takes precedence over each fallback surface. Recommend `this.member` for ordinary same-component companion access, such as Render reading Controller state or a Style-generated class.
|
|
203
203
|
|