@cleocode/mcp-server 0.86.0
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/LICENSE +21 -0
- package/README.md +306 -0
- package/dist/domains/index.d.ts +16 -0
- package/dist/domains/index.d.ts.map +1 -0
- package/dist/domains/index.js +16 -0
- package/dist/domains/index.js.map +1 -0
- package/dist/domains/lifecycle.d.ts +147 -0
- package/dist/domains/lifecycle.d.ts.map +1 -0
- package/dist/domains/lifecycle.js +452 -0
- package/dist/domains/lifecycle.js.map +1 -0
- package/dist/domains/orchestrate.d.ts +133 -0
- package/dist/domains/orchestrate.d.ts.map +1 -0
- package/dist/domains/orchestrate.js +465 -0
- package/dist/domains/orchestrate.js.map +1 -0
- package/dist/domains/release.d.ts +109 -0
- package/dist/domains/release.d.ts.map +1 -0
- package/dist/domains/release.js +400 -0
- package/dist/domains/release.js.map +1 -0
- package/dist/domains/research.d.ts +139 -0
- package/dist/domains/research.d.ts.map +1 -0
- package/dist/domains/research.js +606 -0
- package/dist/domains/research.js.map +1 -0
- package/dist/domains/session.d.ts +129 -0
- package/dist/domains/session.d.ts.map +1 -0
- package/dist/domains/session.js +433 -0
- package/dist/domains/session.js.map +1 -0
- package/dist/domains/system.d.ts +92 -0
- package/dist/domains/system.d.ts.map +1 -0
- package/dist/domains/system.js +473 -0
- package/dist/domains/system.js.map +1 -0
- package/dist/domains/tasks.d.ts +180 -0
- package/dist/domains/tasks.d.ts.map +1 -0
- package/dist/domains/tasks.js +704 -0
- package/dist/domains/tasks.js.map +1 -0
- package/dist/domains/validate.d.ts +150 -0
- package/dist/domains/validate.d.ts.map +1 -0
- package/dist/domains/validate.js +568 -0
- package/dist/domains/validate.js.map +1 -0
- package/dist/gateways/mutate.d.ts +100 -0
- package/dist/gateways/mutate.d.ts.map +1 -0
- package/dist/gateways/mutate.js +937 -0
- package/dist/gateways/mutate.js.map +1 -0
- package/dist/gateways/query.d.ts +91 -0
- package/dist/gateways/query.d.ts.map +1 -0
- package/dist/gateways/query.js +245 -0
- package/dist/gateways/query.js.map +1 -0
- package/dist/index.d.ts +21 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +299 -0
- package/dist/index.js.map +1 -0
- package/dist/lib/audit.d.ts +118 -0
- package/dist/lib/audit.d.ts.map +1 -0
- package/dist/lib/audit.js +311 -0
- package/dist/lib/audit.js.map +1 -0
- package/dist/lib/background-jobs.d.ts +86 -0
- package/dist/lib/background-jobs.d.ts.map +1 -0
- package/dist/lib/background-jobs.js +183 -0
- package/dist/lib/background-jobs.js.map +1 -0
- package/dist/lib/cache.d.ts +78 -0
- package/dist/lib/cache.d.ts.map +1 -0
- package/dist/lib/cache.js +204 -0
- package/dist/lib/cache.js.map +1 -0
- package/dist/lib/command-builder.d.ts +52 -0
- package/dist/lib/command-builder.d.ts.map +1 -0
- package/dist/lib/command-builder.js +280 -0
- package/dist/lib/command-builder.js.map +1 -0
- package/dist/lib/config.d.ts +42 -0
- package/dist/lib/config.d.ts.map +1 -0
- package/dist/lib/config.js +248 -0
- package/dist/lib/config.js.map +1 -0
- package/dist/lib/defaults.d.ts +115 -0
- package/dist/lib/defaults.d.ts.map +1 -0
- package/dist/lib/defaults.js +61 -0
- package/dist/lib/defaults.js.map +1 -0
- package/dist/lib/error-handler.d.ts +101 -0
- package/dist/lib/error-handler.d.ts.map +1 -0
- package/dist/lib/error-handler.js +277 -0
- package/dist/lib/error-handler.js.map +1 -0
- package/dist/lib/executor.d.ts +110 -0
- package/dist/lib/executor.d.ts.map +1 -0
- package/dist/lib/executor.js +362 -0
- package/dist/lib/executor.js.map +1 -0
- package/dist/lib/exit-codes.d.ts +190 -0
- package/dist/lib/exit-codes.d.ts.map +1 -0
- package/dist/lib/exit-codes.js +1027 -0
- package/dist/lib/exit-codes.js.map +1 -0
- package/dist/lib/formatter.d.ts +196 -0
- package/dist/lib/formatter.d.ts.map +1 -0
- package/dist/lib/formatter.js +260 -0
- package/dist/lib/formatter.js.map +1 -0
- package/dist/lib/gate-validators.d.ts +103 -0
- package/dist/lib/gate-validators.d.ts.map +1 -0
- package/dist/lib/gate-validators.js +689 -0
- package/dist/lib/gate-validators.js.map +1 -0
- package/dist/lib/manifest-parser.d.ts +61 -0
- package/dist/lib/manifest-parser.d.ts.map +1 -0
- package/dist/lib/manifest-parser.js +338 -0
- package/dist/lib/manifest-parser.js.map +1 -0
- package/dist/lib/manifest.d.ts +177 -0
- package/dist/lib/manifest.d.ts.map +1 -0
- package/dist/lib/manifest.js +301 -0
- package/dist/lib/manifest.js.map +1 -0
- package/dist/lib/protocol-enforcement.d.ts +105 -0
- package/dist/lib/protocol-enforcement.d.ts.map +1 -0
- package/dist/lib/protocol-enforcement.js +331 -0
- package/dist/lib/protocol-enforcement.js.map +1 -0
- package/dist/lib/protocol-rules.d.ts +55 -0
- package/dist/lib/protocol-rules.d.ts.map +1 -0
- package/dist/lib/protocol-rules.js +760 -0
- package/dist/lib/protocol-rules.js.map +1 -0
- package/dist/lib/rate-limiter.d.ts +110 -0
- package/dist/lib/rate-limiter.d.ts.map +1 -0
- package/dist/lib/rate-limiter.js +208 -0
- package/dist/lib/rate-limiter.js.map +1 -0
- package/dist/lib/router.d.ts +126 -0
- package/dist/lib/router.d.ts.map +1 -0
- package/dist/lib/router.js +276 -0
- package/dist/lib/router.js.map +1 -0
- package/dist/lib/schema.d.ts +55 -0
- package/dist/lib/schema.d.ts.map +1 -0
- package/dist/lib/schema.js +70 -0
- package/dist/lib/schema.js.map +1 -0
- package/dist/lib/security.d.ts +156 -0
- package/dist/lib/security.d.ts.map +1 -0
- package/dist/lib/security.js +347 -0
- package/dist/lib/security.js.map +1 -0
- package/dist/lib/verification-gates.d.ts +287 -0
- package/dist/lib/verification-gates.d.ts.map +1 -0
- package/dist/lib/verification-gates.js +548 -0
- package/dist/lib/verification-gates.js.map +1 -0
- package/dist/types/domain.d.ts +29 -0
- package/dist/types/domain.d.ts.map +1 -0
- package/dist/types/domain.js +7 -0
- package/dist/types/domain.js.map +1 -0
- package/dist/types/error.d.ts +101 -0
- package/dist/types/error.d.ts.map +1 -0
- package/dist/types/error.js +61 -0
- package/dist/types/error.js.map +1 -0
- package/dist/types/gateway.d.ts +78 -0
- package/dist/types/gateway.d.ts.map +1 -0
- package/dist/types/gateway.js +7 -0
- package/dist/types/gateway.js.map +1 -0
- package/dist/types/index.d.ts +21 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/index.js +11 -0
- package/dist/types/index.js.map +1 -0
- package/dist/types/operations/lifecycle.d.ts +140 -0
- package/dist/types/operations/lifecycle.d.ts.map +1 -0
- package/dist/types/operations/lifecycle.js +8 -0
- package/dist/types/operations/lifecycle.js.map +1 -0
- package/dist/types/operations/orchestrate.d.ts +140 -0
- package/dist/types/operations/orchestrate.d.ts.map +1 -0
- package/dist/types/operations/orchestrate.js +8 -0
- package/dist/types/operations/orchestrate.js.map +1 -0
- package/dist/types/operations/release.d.ts +97 -0
- package/dist/types/operations/release.d.ts.map +1 -0
- package/dist/types/operations/release.js +7 -0
- package/dist/types/operations/release.js.map +1 -0
- package/dist/types/operations/research.d.ts +122 -0
- package/dist/types/operations/research.d.ts.map +1 -0
- package/dist/types/operations/research.js +8 -0
- package/dist/types/operations/research.js.map +1 -0
- package/dist/types/operations/session.d.ts +108 -0
- package/dist/types/operations/session.d.ts.map +1 -0
- package/dist/types/operations/session.js +8 -0
- package/dist/types/operations/session.js.map +1 -0
- package/dist/types/operations/system.d.ts +147 -0
- package/dist/types/operations/system.d.ts.map +1 -0
- package/dist/types/operations/system.js +8 -0
- package/dist/types/operations/system.js.map +1 -0
- package/dist/types/operations/tasks.d.ts +186 -0
- package/dist/types/operations/tasks.d.ts.map +1 -0
- package/dist/types/operations/tasks.js +8 -0
- package/dist/types/operations/tasks.js.map +1 -0
- package/dist/types/operations/validate.d.ts +170 -0
- package/dist/types/operations/validate.d.ts.map +1 -0
- package/dist/types/operations/validate.js +8 -0
- package/dist/types/operations/validate.js.map +1 -0
- package/package.json +67 -0
- package/schemas/IMPLEMENTATION-SUMMARY.md +250 -0
- package/schemas/README.md +284 -0
- package/schemas/common/error.schema.json +54 -0
- package/schemas/common/meta.schema.json +39 -0
- package/schemas/common/pagination.schema.json +32 -0
- package/schemas/index.json +159 -0
- package/schemas/requests/lifecycle/check.schema.json +20 -0
- package/schemas/requests/lifecycle/gate.fail.schema.json +25 -0
- package/schemas/requests/lifecycle/gate.pass.schema.json +28 -0
- package/schemas/requests/lifecycle/gates.schema.json +15 -0
- package/schemas/requests/lifecycle/history.schema.json +15 -0
- package/schemas/requests/lifecycle/prerequisites.schema.json +15 -0
- package/schemas/requests/lifecycle/progress.schema.json +29 -0
- package/schemas/requests/lifecycle/reset.schema.json +25 -0
- package/schemas/requests/lifecycle/skip.schema.json +25 -0
- package/schemas/requests/lifecycle/status.schema.json +23 -0
- package/schemas/requests/orchestrate/analyze.schema.json +15 -0
- package/schemas/requests/orchestrate/context.schema.json +13 -0
- package/schemas/requests/orchestrate/next.schema.json +15 -0
- package/schemas/requests/orchestrate/parallel.end.schema.json +20 -0
- package/schemas/requests/orchestrate/parallel.start.schema.json +20 -0
- package/schemas/requests/orchestrate/ready.schema.json +15 -0
- package/schemas/requests/orchestrate/skill.list.schema.json +13 -0
- package/schemas/requests/orchestrate/spawn.schema.json +25 -0
- package/schemas/requests/orchestrate/startup.schema.json +15 -0
- package/schemas/requests/orchestrate/status.schema.json +15 -0
- package/schemas/requests/orchestrate/validate.schema.json +15 -0
- package/schemas/requests/orchestrate/waves.schema.json +15 -0
- package/schemas/requests/release/changelog.schema.json +23 -0
- package/schemas/requests/release/commit.schema.json +22 -0
- package/schemas/requests/release/gates.run.schema.json +17 -0
- package/schemas/requests/release/prepare.schema.json +20 -0
- package/schemas/requests/release/push.schema.json +20 -0
- package/schemas/requests/release/rollback.schema.json +20 -0
- package/schemas/requests/release/tag.schema.json +19 -0
- package/schemas/requests/research/inject.schema.json +24 -0
- package/schemas/requests/research/link.schema.json +25 -0
- package/schemas/requests/research/list.schema.json +19 -0
- package/schemas/requests/research/manifest.append.schema.json +20 -0
- package/schemas/requests/research/manifest.archive.schema.json +19 -0
- package/schemas/requests/research/manifest.read.schema.json +21 -0
- package/schemas/requests/research/pending.schema.json +14 -0
- package/schemas/requests/research/query.schema.json +21 -0
- package/schemas/requests/research/show.schema.json +14 -0
- package/schemas/requests/research/stats.schema.json +14 -0
- package/schemas/requests/session/end.schema.json +13 -0
- package/schemas/requests/session/focus.clear.schema.json +7 -0
- package/schemas/requests/session/focus.get.schema.json +7 -0
- package/schemas/requests/session/focus.set.schema.json +15 -0
- package/schemas/requests/session/gc.schema.json +14 -0
- package/schemas/requests/session/history.schema.json +16 -0
- package/schemas/requests/session/list.schema.json +13 -0
- package/schemas/requests/session/resume.schema.json +14 -0
- package/schemas/requests/session/show.schema.json +14 -0
- package/schemas/requests/session/start.schema.json +23 -0
- package/schemas/requests/session/status.schema.json +7 -0
- package/schemas/requests/session/suspend.schema.json +13 -0
- package/schemas/requests/system/backup.schema.json +19 -0
- package/schemas/requests/system/cleanup.schema.json +20 -0
- package/schemas/requests/system/config.get.schema.json +14 -0
- package/schemas/requests/system/config.set.schema.json +24 -0
- package/schemas/requests/system/context.schema.json +7 -0
- package/schemas/requests/system/doctor.schema.json +7 -0
- package/schemas/requests/system/init.schema.json +18 -0
- package/schemas/requests/system/migrate.schema.json +19 -0
- package/schemas/requests/system/restore.schema.json +14 -0
- package/schemas/requests/system/stats.schema.json +7 -0
- package/schemas/requests/system/sync.schema.json +15 -0
- package/schemas/requests/system/version.schema.json +7 -0
- package/schemas/requests/tasks/analyze.schema.json +14 -0
- package/schemas/requests/tasks/archive.schema.json +19 -0
- package/schemas/requests/tasks/blockers.schema.json +15 -0
- package/schemas/requests/tasks/complete.schema.json +24 -0
- package/schemas/requests/tasks/create.schema.json +48 -0
- package/schemas/requests/tasks/delete.schema.json +20 -0
- package/schemas/requests/tasks/deps.schema.json +21 -0
- package/schemas/requests/tasks/exists.schema.json +15 -0
- package/schemas/requests/tasks/find.schema.json +22 -0
- package/schemas/requests/tasks/get.schema.json +15 -0
- package/schemas/requests/tasks/list.schema.json +26 -0
- package/schemas/requests/tasks/next.schema.json +21 -0
- package/schemas/requests/tasks/promote.schema.json +15 -0
- package/schemas/requests/tasks/reopen.schema.json +15 -0
- package/schemas/requests/tasks/reorder.schema.json +20 -0
- package/schemas/requests/tasks/reparent.schema.json +20 -0
- package/schemas/requests/tasks/tree.schema.json +21 -0
- package/schemas/requests/tasks/unarchive.schema.json +15 -0
- package/schemas/requests/tasks/update.schema.json +41 -0
- package/schemas/requests/validate/compliance.record.schema.json +20 -0
- package/schemas/requests/validate/compliance.summary.schema.json +18 -0
- package/schemas/requests/validate/compliance.violations.schema.json +19 -0
- package/schemas/requests/validate/manifest.schema.json +23 -0
- package/schemas/requests/validate/output.schema.json +19 -0
- package/schemas/requests/validate/protocol.schema.json +20 -0
- package/schemas/requests/validate/schema.schema.json +19 -0
- package/schemas/requests/validate/task.schema.json +21 -0
- package/schemas/requests/validate/test.coverage.schema.json +14 -0
- package/schemas/requests/validate/test.run.schema.json +22 -0
- package/schemas/requests/validate/test.status.schema.json +14 -0
- package/schemas/responses/common-error.schema.json +20 -0
- package/schemas/responses/common-success.schema.json +21 -0
- package/schemas/responses/lifecycle/check.schema.json +18 -0
- package/schemas/responses/lifecycle/gate.fail.schema.json +18 -0
- package/schemas/responses/lifecycle/gate.pass.schema.json +18 -0
- package/schemas/responses/lifecycle/gates.schema.json +18 -0
- package/schemas/responses/lifecycle/history.schema.json +18 -0
- package/schemas/responses/lifecycle/prerequisites.schema.json +18 -0
- package/schemas/responses/lifecycle/progress.schema.json +18 -0
- package/schemas/responses/lifecycle/reset.schema.json +18 -0
- package/schemas/responses/lifecycle/skip.schema.json +18 -0
- package/schemas/responses/lifecycle/status.schema.json +18 -0
- package/schemas/responses/orchestrate/analyze.schema.json +18 -0
- package/schemas/responses/orchestrate/context.schema.json +18 -0
- package/schemas/responses/orchestrate/next.schema.json +18 -0
- package/schemas/responses/orchestrate/parallel.end.schema.json +18 -0
- package/schemas/responses/orchestrate/parallel.start.schema.json +18 -0
- package/schemas/responses/orchestrate/ready.schema.json +18 -0
- package/schemas/responses/orchestrate/skill.list.schema.json +18 -0
- package/schemas/responses/orchestrate/spawn.schema.json +18 -0
- package/schemas/responses/orchestrate/startup.schema.json +18 -0
- package/schemas/responses/orchestrate/status.schema.json +18 -0
- package/schemas/responses/orchestrate/validate.schema.json +18 -0
- package/schemas/responses/orchestrate/waves.schema.json +18 -0
- package/schemas/responses/release/changelog.schema.json +18 -0
- package/schemas/responses/release/commit.schema.json +18 -0
- package/schemas/responses/release/gates.run.schema.json +18 -0
- package/schemas/responses/release/prepare.schema.json +18 -0
- package/schemas/responses/release/push.schema.json +18 -0
- package/schemas/responses/release/rollback.schema.json +18 -0
- package/schemas/responses/release/tag.schema.json +18 -0
- package/schemas/responses/research/inject.schema.json +18 -0
- package/schemas/responses/research/link.schema.json +18 -0
- package/schemas/responses/research/list.schema.json +18 -0
- package/schemas/responses/research/manifest.append.schema.json +18 -0
- package/schemas/responses/research/manifest.archive.schema.json +18 -0
- package/schemas/responses/research/manifest.read.schema.json +18 -0
- package/schemas/responses/research/pending.schema.json +18 -0
- package/schemas/responses/research/query.schema.json +18 -0
- package/schemas/responses/research/show.schema.json +18 -0
- package/schemas/responses/research/stats.schema.json +18 -0
- package/schemas/responses/session/end.schema.json +18 -0
- package/schemas/responses/session/focus.clear.schema.json +18 -0
- package/schemas/responses/session/focus.get.schema.json +18 -0
- package/schemas/responses/session/focus.set.schema.json +18 -0
- package/schemas/responses/session/gc.schema.json +18 -0
- package/schemas/responses/session/history.schema.json +18 -0
- package/schemas/responses/session/list.schema.json +18 -0
- package/schemas/responses/session/resume.schema.json +18 -0
- package/schemas/responses/session/show.schema.json +18 -0
- package/schemas/responses/session/start.schema.json +18 -0
- package/schemas/responses/session/status.schema.json +18 -0
- package/schemas/responses/session/suspend.schema.json +18 -0
- package/schemas/responses/system/backup.schema.json +18 -0
- package/schemas/responses/system/cleanup.schema.json +18 -0
- package/schemas/responses/system/config.get.schema.json +18 -0
- package/schemas/responses/system/config.set.schema.json +18 -0
- package/schemas/responses/system/context.schema.json +18 -0
- package/schemas/responses/system/doctor.schema.json +18 -0
- package/schemas/responses/system/init.schema.json +18 -0
- package/schemas/responses/system/migrate.schema.json +18 -0
- package/schemas/responses/system/restore.schema.json +18 -0
- package/schemas/responses/system/stats.schema.json +18 -0
- package/schemas/responses/system/sync.schema.json +18 -0
- package/schemas/responses/system/version.schema.json +18 -0
- package/schemas/responses/tasks/analyze.schema.json +18 -0
- package/schemas/responses/tasks/archive.schema.json +18 -0
- package/schemas/responses/tasks/blockers.schema.json +18 -0
- package/schemas/responses/tasks/complete.schema.json +18 -0
- package/schemas/responses/tasks/create.schema.json +18 -0
- package/schemas/responses/tasks/delete.schema.json +18 -0
- package/schemas/responses/tasks/deps.schema.json +18 -0
- package/schemas/responses/tasks/exists.schema.json +18 -0
- package/schemas/responses/tasks/find.schema.json +18 -0
- package/schemas/responses/tasks/get.schema.json +87 -0
- package/schemas/responses/tasks/list.schema.json +18 -0
- package/schemas/responses/tasks/next.schema.json +18 -0
- package/schemas/responses/tasks/promote.schema.json +18 -0
- package/schemas/responses/tasks/reopen.schema.json +18 -0
- package/schemas/responses/tasks/reorder.schema.json +18 -0
- package/schemas/responses/tasks/reparent.schema.json +18 -0
- package/schemas/responses/tasks/tree.schema.json +18 -0
- package/schemas/responses/tasks/unarchive.schema.json +18 -0
- package/schemas/responses/tasks/update.schema.json +18 -0
- package/schemas/responses/validate/compliance.record.schema.json +18 -0
- package/schemas/responses/validate/compliance.summary.schema.json +18 -0
- package/schemas/responses/validate/compliance.violations.schema.json +18 -0
- package/schemas/responses/validate/manifest.schema.json +18 -0
- package/schemas/responses/validate/output.schema.json +18 -0
- package/schemas/responses/validate/protocol.schema.json +18 -0
- package/schemas/responses/validate/schema.schema.json +18 -0
- package/schemas/responses/validate/task.schema.json +18 -0
- package/schemas/responses/validate/test.coverage.schema.json +18 -0
- package/schemas/responses/validate/test.run.schema.json +18 -0
- package/schemas/responses/validate/test.status.schema.json +18 -0
- package/server.json +53 -0
|
@@ -0,0 +1,760 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Protocol Rule Definitions for CLEO MCP Server
|
|
3
|
+
*
|
|
4
|
+
* @task T2918
|
|
5
|
+
* @epic T2908
|
|
6
|
+
*
|
|
7
|
+
* Defines validation rules for all 7 RCSD-IVTR protocols.
|
|
8
|
+
*
|
|
9
|
+
* Reference: lib/protocol-validation.sh, protocols/*.md
|
|
10
|
+
*/
|
|
11
|
+
/**
|
|
12
|
+
* Helper: Check if field exists and is non-empty
|
|
13
|
+
*/
|
|
14
|
+
function hasField(obj, field) {
|
|
15
|
+
const value = obj[field];
|
|
16
|
+
return value !== null && value !== undefined && value !== '';
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* Helper: Check array field length
|
|
20
|
+
*/
|
|
21
|
+
function arrayLengthInRange(obj, field, min, max) {
|
|
22
|
+
const value = obj[field];
|
|
23
|
+
if (!Array.isArray(value)) {
|
|
24
|
+
return false;
|
|
25
|
+
}
|
|
26
|
+
return value.length >= min && value.length <= max;
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* Helper: Check enum value
|
|
30
|
+
*/
|
|
31
|
+
function hasEnumValue(obj, field, values) {
|
|
32
|
+
const value = obj[field];
|
|
33
|
+
return typeof value === 'string' && values.includes(value);
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* Research Protocol Rules (RSCH-*)
|
|
37
|
+
*/
|
|
38
|
+
const RESEARCH_RULES = [
|
|
39
|
+
{
|
|
40
|
+
id: 'RSCH-001',
|
|
41
|
+
level: 'MUST',
|
|
42
|
+
message: 'Research task must not modify code',
|
|
43
|
+
fix: 'Revert code changes, research is read-only',
|
|
44
|
+
validate: (entry, data) => {
|
|
45
|
+
return !data?.hasCodeChanges;
|
|
46
|
+
},
|
|
47
|
+
},
|
|
48
|
+
{
|
|
49
|
+
id: 'RSCH-002',
|
|
50
|
+
level: 'SHOULD',
|
|
51
|
+
message: 'Should document sources',
|
|
52
|
+
fix: 'Add sources array to manifest',
|
|
53
|
+
validate: (entry) => {
|
|
54
|
+
return hasField(entry, 'sources');
|
|
55
|
+
},
|
|
56
|
+
},
|
|
57
|
+
{
|
|
58
|
+
id: 'RSCH-003',
|
|
59
|
+
level: 'MUST',
|
|
60
|
+
message: 'Must link research to task via linked_tasks',
|
|
61
|
+
fix: 'Add linked_tasks array referencing the task and epic IDs',
|
|
62
|
+
validate: (entry) => {
|
|
63
|
+
const linkedTasks = entry.linked_tasks;
|
|
64
|
+
return Array.isArray(linkedTasks) && linkedTasks.length > 0;
|
|
65
|
+
},
|
|
66
|
+
},
|
|
67
|
+
{
|
|
68
|
+
id: 'RSCH-004',
|
|
69
|
+
level: 'MUST',
|
|
70
|
+
message: 'Must append entry to MANIFEST.jsonl',
|
|
71
|
+
fix: 'Append manifest entry with correct format',
|
|
72
|
+
validate: (entry) => {
|
|
73
|
+
return hasField(entry, 'id') && hasField(entry, 'file') && hasField(entry, 'date');
|
|
74
|
+
},
|
|
75
|
+
},
|
|
76
|
+
{
|
|
77
|
+
id: 'RSCH-005',
|
|
78
|
+
level: 'MUST',
|
|
79
|
+
message: 'Must write output file with required structure (title, summary, content)',
|
|
80
|
+
fix: 'Ensure output file contains title, summary, and content sections',
|
|
81
|
+
validate: (entry) => {
|
|
82
|
+
return hasField(entry, 'file') && hasField(entry, 'title') && hasField(entry, 'status');
|
|
83
|
+
},
|
|
84
|
+
},
|
|
85
|
+
{
|
|
86
|
+
id: 'RSCH-006',
|
|
87
|
+
level: 'MUST',
|
|
88
|
+
message: 'Must include 3-7 key findings',
|
|
89
|
+
fix: 'Add/remove findings in manifest entry',
|
|
90
|
+
validate: (entry) => {
|
|
91
|
+
return arrayLengthInRange(entry, 'key_findings', 3, 7);
|
|
92
|
+
},
|
|
93
|
+
},
|
|
94
|
+
{
|
|
95
|
+
id: 'RSCH-007',
|
|
96
|
+
level: 'MUST',
|
|
97
|
+
message: 'Must set agent_type: research',
|
|
98
|
+
fix: 'Update manifest entry agent_type field',
|
|
99
|
+
validate: (entry) => {
|
|
100
|
+
return hasEnumValue(entry, 'agent_type', ['research']);
|
|
101
|
+
},
|
|
102
|
+
},
|
|
103
|
+
];
|
|
104
|
+
/**
|
|
105
|
+
* Consensus Protocol Rules (CONS-*)
|
|
106
|
+
*/
|
|
107
|
+
const CONSENSUS_RULES = [
|
|
108
|
+
{
|
|
109
|
+
id: 'CONS-001',
|
|
110
|
+
level: 'MUST',
|
|
111
|
+
message: 'Must have voting matrix with ≥2 options',
|
|
112
|
+
fix: 'Add more options to voting matrix',
|
|
113
|
+
validate: (entry, data) => {
|
|
114
|
+
const votingMatrix = data?.votingMatrix;
|
|
115
|
+
if (!votingMatrix)
|
|
116
|
+
return false;
|
|
117
|
+
const options = votingMatrix.options;
|
|
118
|
+
return Array.isArray(options) && options.length >= 2;
|
|
119
|
+
},
|
|
120
|
+
},
|
|
121
|
+
{
|
|
122
|
+
id: 'CONS-002',
|
|
123
|
+
level: 'MUST',
|
|
124
|
+
message: 'Must include rationale for each voting option',
|
|
125
|
+
fix: 'Add rationale string to each option in voting matrix',
|
|
126
|
+
validate: (entry, data) => {
|
|
127
|
+
const votingMatrix = data?.votingMatrix;
|
|
128
|
+
if (!votingMatrix)
|
|
129
|
+
return false;
|
|
130
|
+
const options = votingMatrix.options;
|
|
131
|
+
if (!Array.isArray(options))
|
|
132
|
+
return false;
|
|
133
|
+
return options.every((opt) => typeof opt.rationale === 'string' && opt.rationale.length > 0);
|
|
134
|
+
},
|
|
135
|
+
},
|
|
136
|
+
{
|
|
137
|
+
id: 'CONS-003',
|
|
138
|
+
level: 'MUST',
|
|
139
|
+
message: 'Must include confidence scores (0.0-1.0)',
|
|
140
|
+
fix: 'Fix confidence values in voting matrix',
|
|
141
|
+
validate: (entry, data) => {
|
|
142
|
+
const votingMatrix = data?.votingMatrix;
|
|
143
|
+
if (!votingMatrix)
|
|
144
|
+
return false;
|
|
145
|
+
const options = votingMatrix.options;
|
|
146
|
+
if (!Array.isArray(options))
|
|
147
|
+
return false;
|
|
148
|
+
return options.every((opt) => {
|
|
149
|
+
const conf = opt.confidence;
|
|
150
|
+
return typeof conf === 'number' && conf >= 0.0 && conf <= 1.0;
|
|
151
|
+
});
|
|
152
|
+
},
|
|
153
|
+
},
|
|
154
|
+
{
|
|
155
|
+
id: 'CONS-004',
|
|
156
|
+
level: 'MUST',
|
|
157
|
+
message: 'Must meet threshold (50% required)',
|
|
158
|
+
fix: 'Increase confidence or add more supporting rationale',
|
|
159
|
+
validate: (entry, data) => {
|
|
160
|
+
const votingMatrix = data?.votingMatrix;
|
|
161
|
+
if (!votingMatrix)
|
|
162
|
+
return false;
|
|
163
|
+
const options = votingMatrix.options;
|
|
164
|
+
if (!Array.isArray(options))
|
|
165
|
+
return false;
|
|
166
|
+
const maxConfidence = Math.max(...options.map((o) => o.confidence || 0));
|
|
167
|
+
return maxConfidence >= 0.5;
|
|
168
|
+
},
|
|
169
|
+
},
|
|
170
|
+
{
|
|
171
|
+
id: 'CONS-005',
|
|
172
|
+
level: 'SHOULD',
|
|
173
|
+
message: 'Should record dissenting opinions',
|
|
174
|
+
fix: 'Add dissent field to voting matrix for minority options',
|
|
175
|
+
validate: (entry, data) => {
|
|
176
|
+
const votingMatrix = data?.votingMatrix;
|
|
177
|
+
if (!votingMatrix)
|
|
178
|
+
return true; // Optional: SHOULD level
|
|
179
|
+
return hasField(votingMatrix, 'dissent') ||
|
|
180
|
+
hasField(votingMatrix, 'notes');
|
|
181
|
+
},
|
|
182
|
+
},
|
|
183
|
+
{
|
|
184
|
+
id: 'CONS-006',
|
|
185
|
+
level: 'MUST',
|
|
186
|
+
message: 'Must escalate to HITL when threshold not reached',
|
|
187
|
+
fix: 'Set needs_followup with HITL escalation when no option meets threshold',
|
|
188
|
+
validate: (entry, data) => {
|
|
189
|
+
const votingMatrix = data?.votingMatrix;
|
|
190
|
+
if (!votingMatrix)
|
|
191
|
+
return false;
|
|
192
|
+
const options = votingMatrix.options;
|
|
193
|
+
if (!Array.isArray(options))
|
|
194
|
+
return false;
|
|
195
|
+
const maxConfidence = Math.max(...options.map((o) => o.confidence || 0));
|
|
196
|
+
// If threshold met, rule passes (no escalation needed)
|
|
197
|
+
if (maxConfidence >= 0.5)
|
|
198
|
+
return true;
|
|
199
|
+
// If threshold not met, must have escalation flag
|
|
200
|
+
const needsFollowup = entry.needs_followup;
|
|
201
|
+
return Array.isArray(needsFollowup) && needsFollowup.length > 0;
|
|
202
|
+
},
|
|
203
|
+
},
|
|
204
|
+
{
|
|
205
|
+
id: 'CONS-007',
|
|
206
|
+
level: 'MUST',
|
|
207
|
+
message: 'Must set agent_type: analysis',
|
|
208
|
+
fix: 'Update manifest entry agent_type field',
|
|
209
|
+
validate: (entry) => {
|
|
210
|
+
return hasEnumValue(entry, 'agent_type', ['analysis']);
|
|
211
|
+
},
|
|
212
|
+
},
|
|
213
|
+
];
|
|
214
|
+
/**
|
|
215
|
+
* Specification Protocol Rules (SPEC-*)
|
|
216
|
+
*/
|
|
217
|
+
const SPECIFICATION_RULES = [
|
|
218
|
+
{
|
|
219
|
+
id: 'SPEC-001',
|
|
220
|
+
level: 'MUST',
|
|
221
|
+
message: 'Must include RFC 2119 keywords',
|
|
222
|
+
fix: 'Add MUST/SHOULD/MAY requirements to specification',
|
|
223
|
+
validate: (entry, data) => {
|
|
224
|
+
const fileContent = data?.fileContent;
|
|
225
|
+
if (!fileContent)
|
|
226
|
+
return false;
|
|
227
|
+
return /\b(MUST|SHOULD|MAY|MUST NOT|SHOULD NOT|MAY NOT)\b/.test(fileContent);
|
|
228
|
+
},
|
|
229
|
+
},
|
|
230
|
+
{
|
|
231
|
+
id: 'SPEC-002',
|
|
232
|
+
level: 'MUST',
|
|
233
|
+
message: 'Must have version field',
|
|
234
|
+
fix: 'Add version field to manifest entry',
|
|
235
|
+
validate: (entry) => {
|
|
236
|
+
return hasField(entry, 'version');
|
|
237
|
+
},
|
|
238
|
+
},
|
|
239
|
+
{
|
|
240
|
+
id: 'SPEC-003',
|
|
241
|
+
level: 'SHOULD',
|
|
242
|
+
message: 'Should include authority/scope section',
|
|
243
|
+
fix: 'Add authority section defining specification scope',
|
|
244
|
+
validate: (entry, data) => {
|
|
245
|
+
const fileContent = data?.fileContent;
|
|
246
|
+
if (!fileContent)
|
|
247
|
+
return true; // Optional
|
|
248
|
+
return /\b(authority|scope)\b/i.test(fileContent);
|
|
249
|
+
},
|
|
250
|
+
},
|
|
251
|
+
{
|
|
252
|
+
id: 'SPEC-004',
|
|
253
|
+
level: 'SHOULD',
|
|
254
|
+
message: 'Should include conformance criteria',
|
|
255
|
+
fix: 'Add conformance section defining how to verify compliance',
|
|
256
|
+
validate: (entry, data) => {
|
|
257
|
+
const fileContent = data?.fileContent;
|
|
258
|
+
if (!fileContent)
|
|
259
|
+
return true; // SHOULD level, pass when no content
|
|
260
|
+
return /\b(conformance|compliance|verification)\b/i.test(fileContent);
|
|
261
|
+
},
|
|
262
|
+
},
|
|
263
|
+
{
|
|
264
|
+
id: 'SPEC-005',
|
|
265
|
+
level: 'SHOULD',
|
|
266
|
+
message: 'Should include change log section',
|
|
267
|
+
fix: 'Add change log tracking version history',
|
|
268
|
+
validate: (entry, data) => {
|
|
269
|
+
const fileContent = data?.fileContent;
|
|
270
|
+
if (!fileContent)
|
|
271
|
+
return true; // SHOULD level
|
|
272
|
+
return /\b(change\s*log|revision\s*history|version\s*history)\b/i.test(fileContent);
|
|
273
|
+
},
|
|
274
|
+
},
|
|
275
|
+
{
|
|
276
|
+
id: 'SPEC-006',
|
|
277
|
+
level: 'SHOULD',
|
|
278
|
+
message: 'Should include references section',
|
|
279
|
+
fix: 'Add references to related specifications and documents',
|
|
280
|
+
validate: (entry, data) => {
|
|
281
|
+
const fileContent = data?.fileContent;
|
|
282
|
+
if (!fileContent)
|
|
283
|
+
return true; // SHOULD level
|
|
284
|
+
return /\b(references|see also|related)\b/i.test(fileContent);
|
|
285
|
+
},
|
|
286
|
+
},
|
|
287
|
+
{
|
|
288
|
+
id: 'SPEC-007',
|
|
289
|
+
level: 'MUST',
|
|
290
|
+
message: 'Must set agent_type: specification',
|
|
291
|
+
fix: 'Update manifest entry agent_type field',
|
|
292
|
+
validate: (entry) => {
|
|
293
|
+
return hasEnumValue(entry, 'agent_type', ['specification']);
|
|
294
|
+
},
|
|
295
|
+
},
|
|
296
|
+
];
|
|
297
|
+
/**
|
|
298
|
+
* Decomposition Protocol Rules (DCMP-*)
|
|
299
|
+
*/
|
|
300
|
+
const DECOMPOSITION_RULES = [
|
|
301
|
+
{
|
|
302
|
+
id: 'DCMP-001',
|
|
303
|
+
level: 'MUST',
|
|
304
|
+
message: 'Must follow MECE principle (mutually exclusive, collectively exhaustive)',
|
|
305
|
+
fix: 'Ensure tasks do not overlap and cover all requirements',
|
|
306
|
+
validate: (entry, data) => {
|
|
307
|
+
// Check for duplicate task titles in sibling list (overlap detection)
|
|
308
|
+
const siblingTitles = data?.siblingTitles;
|
|
309
|
+
if (!siblingTitles)
|
|
310
|
+
return true; // No sibling data available, pass
|
|
311
|
+
const uniqueTitles = new Set(siblingTitles.map((t) => t.toLowerCase().trim()));
|
|
312
|
+
return uniqueTitles.size === siblingTitles.length;
|
|
313
|
+
},
|
|
314
|
+
},
|
|
315
|
+
{
|
|
316
|
+
id: 'DCMP-002',
|
|
317
|
+
level: 'MUST',
|
|
318
|
+
message: 'Must map dependencies (no cycles allowed)',
|
|
319
|
+
fix: 'Add depends field to tasks and verify no circular references',
|
|
320
|
+
validate: (entry, data) => {
|
|
321
|
+
const hasCycles = data?.hasCycles;
|
|
322
|
+
return hasCycles !== true; // Pass if no cycle data or no cycles
|
|
323
|
+
},
|
|
324
|
+
},
|
|
325
|
+
{
|
|
326
|
+
id: 'DCMP-003',
|
|
327
|
+
level: 'MUST',
|
|
328
|
+
message: 'Must respect max depth 3 (epic→task→subtask)',
|
|
329
|
+
fix: 'Flatten hierarchy to max 3 levels',
|
|
330
|
+
validate: (entry, data) => {
|
|
331
|
+
const depth = data?.hierarchyDepth;
|
|
332
|
+
return depth === undefined || depth <= 3;
|
|
333
|
+
},
|
|
334
|
+
},
|
|
335
|
+
{
|
|
336
|
+
id: 'DCMP-004',
|
|
337
|
+
level: 'MUST',
|
|
338
|
+
message: 'Must verify atomicity for leaf tasks',
|
|
339
|
+
fix: 'Ensure leaf tasks are atomic and independently completable',
|
|
340
|
+
validate: (entry, data) => {
|
|
341
|
+
const isLeaf = data?.isLeafTask;
|
|
342
|
+
if (!isLeaf)
|
|
343
|
+
return true; // Not a leaf task, pass
|
|
344
|
+
// Leaf tasks must have a clear description
|
|
345
|
+
return hasField(entry, 'description') &&
|
|
346
|
+
typeof entry.description === 'string' &&
|
|
347
|
+
entry.description.length >= 10;
|
|
348
|
+
},
|
|
349
|
+
},
|
|
350
|
+
{
|
|
351
|
+
id: 'DCMP-005',
|
|
352
|
+
level: 'MUST',
|
|
353
|
+
message: 'Must not include time estimates',
|
|
354
|
+
fix: 'Remove time estimates, use relative sizing',
|
|
355
|
+
validate: (entry) => {
|
|
356
|
+
const title = entry.title;
|
|
357
|
+
const description = entry.description;
|
|
358
|
+
const text = `${title} ${description}`;
|
|
359
|
+
return !/\b\d+\s*(hour|day|week|minute|hr|min)s?\b/i.test(text);
|
|
360
|
+
},
|
|
361
|
+
},
|
|
362
|
+
{
|
|
363
|
+
id: 'DCMP-006',
|
|
364
|
+
level: 'MUST',
|
|
365
|
+
message: 'Must enforce max 7 siblings per parent',
|
|
366
|
+
fix: 'Break epic into smaller sub-epics or reduce task count',
|
|
367
|
+
validate: (entry, data) => {
|
|
368
|
+
const siblingCount = data?.siblingCount;
|
|
369
|
+
return siblingCount === undefined || siblingCount <= 7;
|
|
370
|
+
},
|
|
371
|
+
},
|
|
372
|
+
{
|
|
373
|
+
id: 'DCMP-007',
|
|
374
|
+
level: 'MUST',
|
|
375
|
+
message: 'Must set agent_type: specification',
|
|
376
|
+
fix: 'Update manifest entry agent_type field',
|
|
377
|
+
validate: (entry) => {
|
|
378
|
+
return hasEnumValue(entry, 'agent_type', ['specification']);
|
|
379
|
+
},
|
|
380
|
+
},
|
|
381
|
+
];
|
|
382
|
+
/**
|
|
383
|
+
* Implementation Protocol Rules (IMPL-*)
|
|
384
|
+
*/
|
|
385
|
+
const IMPLEMENTATION_RULES = [
|
|
386
|
+
{
|
|
387
|
+
id: 'IMPL-003',
|
|
388
|
+
level: 'MUST',
|
|
389
|
+
message: 'Must include @task provenance tags',
|
|
390
|
+
fix: 'Add @task T#### comment above new functions',
|
|
391
|
+
validate: (entry, data) => {
|
|
392
|
+
const hasNewFunctions = data?.hasNewFunctions;
|
|
393
|
+
const hasProvenanceTags = data?.hasProvenanceTags;
|
|
394
|
+
// If no new functions, rule passes
|
|
395
|
+
if (!hasNewFunctions)
|
|
396
|
+
return true;
|
|
397
|
+
// If new functions exist, must have provenance tags
|
|
398
|
+
return hasProvenanceTags === true;
|
|
399
|
+
},
|
|
400
|
+
},
|
|
401
|
+
{
|
|
402
|
+
id: 'IMPL-004',
|
|
403
|
+
level: 'SHOULD',
|
|
404
|
+
message: 'Should pass all tests after implementation',
|
|
405
|
+
fix: 'Run test suite and fix failing tests before completion',
|
|
406
|
+
validate: (entry, data) => {
|
|
407
|
+
const testsPassed = data?.testsPassed;
|
|
408
|
+
if (testsPassed === undefined)
|
|
409
|
+
return true; // SHOULD level, pass when no data
|
|
410
|
+
return testsPassed === true;
|
|
411
|
+
},
|
|
412
|
+
},
|
|
413
|
+
{
|
|
414
|
+
id: 'IMPL-005',
|
|
415
|
+
level: 'MUST',
|
|
416
|
+
message: 'Must use atomic file operations for all writes',
|
|
417
|
+
fix: 'Use temp file → validate → backup → rename pattern for writes',
|
|
418
|
+
validate: (entry, data) => {
|
|
419
|
+
const usesAtomicOps = data?.usesAtomicOperations;
|
|
420
|
+
if (usesAtomicOps === undefined)
|
|
421
|
+
return true; // No data available, pass
|
|
422
|
+
return usesAtomicOps === true;
|
|
423
|
+
},
|
|
424
|
+
},
|
|
425
|
+
{
|
|
426
|
+
id: 'IMPL-006',
|
|
427
|
+
level: 'SHOULD',
|
|
428
|
+
message: 'Should follow project code style',
|
|
429
|
+
fix: 'Run linter and fix style violations',
|
|
430
|
+
validate: (entry, data) => {
|
|
431
|
+
const lintPassed = data?.lintPassed;
|
|
432
|
+
if (lintPassed === undefined)
|
|
433
|
+
return true; // SHOULD level, pass when no data
|
|
434
|
+
return lintPassed === true;
|
|
435
|
+
},
|
|
436
|
+
},
|
|
437
|
+
{
|
|
438
|
+
id: 'IMPL-007',
|
|
439
|
+
level: 'MUST',
|
|
440
|
+
message: 'Must set agent_type: implementation',
|
|
441
|
+
fix: 'Update manifest entry agent_type field',
|
|
442
|
+
validate: (entry) => {
|
|
443
|
+
return hasEnumValue(entry, 'agent_type', ['implementation']);
|
|
444
|
+
},
|
|
445
|
+
},
|
|
446
|
+
];
|
|
447
|
+
/**
|
|
448
|
+
* Contribution Protocol Rules (CONT-*)
|
|
449
|
+
*/
|
|
450
|
+
const CONTRIBUTION_RULES = [
|
|
451
|
+
{
|
|
452
|
+
id: 'CONT-001',
|
|
453
|
+
level: 'MUST',
|
|
454
|
+
message: 'Must follow commit message conventions (<type>: <summary>)',
|
|
455
|
+
fix: 'Use commit format: feat|fix|docs|test|refactor|chore: summary',
|
|
456
|
+
validate: (entry, data) => {
|
|
457
|
+
const commitMessage = data?.commitMessage;
|
|
458
|
+
if (!commitMessage)
|
|
459
|
+
return true; // No commit data available, pass
|
|
460
|
+
return /^(feat|fix|docs|test|refactor|chore)(\(.+\))?:\s/.test(commitMessage);
|
|
461
|
+
},
|
|
462
|
+
},
|
|
463
|
+
{
|
|
464
|
+
id: 'CONT-002',
|
|
465
|
+
level: 'MUST',
|
|
466
|
+
message: 'Must include provenance tags (@task/@session)',
|
|
467
|
+
fix: 'Add @task and @session tags to code',
|
|
468
|
+
validate: (entry, data) => {
|
|
469
|
+
const hasNewFunctions = data?.hasNewFunctions;
|
|
470
|
+
const hasProvenanceTags = data?.hasProvenanceTags;
|
|
471
|
+
if (!hasNewFunctions)
|
|
472
|
+
return true;
|
|
473
|
+
return hasProvenanceTags === true;
|
|
474
|
+
},
|
|
475
|
+
},
|
|
476
|
+
{
|
|
477
|
+
id: 'CONT-003',
|
|
478
|
+
level: 'MUST',
|
|
479
|
+
message: 'Must pass validation gates before merge',
|
|
480
|
+
fix: 'Run cleo --validate and fix all violations before merging',
|
|
481
|
+
validate: (entry, data) => {
|
|
482
|
+
const validationPassed = data?.validationPassed;
|
|
483
|
+
if (validationPassed === undefined)
|
|
484
|
+
return true; // No data, pass
|
|
485
|
+
return validationPassed === true;
|
|
486
|
+
},
|
|
487
|
+
},
|
|
488
|
+
{
|
|
489
|
+
id: 'CONT-005',
|
|
490
|
+
level: 'SHOULD',
|
|
491
|
+
message: 'Should flag conflicts with other sessions',
|
|
492
|
+
fix: 'Check for conflicting sessions: cleo session list --active',
|
|
493
|
+
validate: (entry, data) => {
|
|
494
|
+
const hasConflicts = data?.hasConflicts;
|
|
495
|
+
if (hasConflicts === undefined)
|
|
496
|
+
return true; // SHOULD level, pass when no data
|
|
497
|
+
return hasConflicts === false;
|
|
498
|
+
},
|
|
499
|
+
},
|
|
500
|
+
{
|
|
501
|
+
id: 'CONT-007',
|
|
502
|
+
level: 'MUST',
|
|
503
|
+
message: 'Must set agent_type: implementation',
|
|
504
|
+
fix: 'Update manifest entry agent_type field',
|
|
505
|
+
validate: (entry) => {
|
|
506
|
+
return hasEnumValue(entry, 'agent_type', ['implementation']);
|
|
507
|
+
},
|
|
508
|
+
},
|
|
509
|
+
];
|
|
510
|
+
/**
|
|
511
|
+
* Release Protocol Rules (RLSE-*)
|
|
512
|
+
*/
|
|
513
|
+
const RELEASE_RULES = [
|
|
514
|
+
{
|
|
515
|
+
id: 'RLSE-001',
|
|
516
|
+
level: 'MUST',
|
|
517
|
+
message: 'Must follow semver (major.minor.patch)',
|
|
518
|
+
fix: 'Use format X.Y.Z (e.g., 0.74.5)',
|
|
519
|
+
validate: (entry, data) => {
|
|
520
|
+
const version = data?.version;
|
|
521
|
+
if (!version)
|
|
522
|
+
return false;
|
|
523
|
+
return /^\d+\.\d+\.\d+$/.test(version);
|
|
524
|
+
},
|
|
525
|
+
},
|
|
526
|
+
{
|
|
527
|
+
id: 'RLSE-002',
|
|
528
|
+
level: 'MUST',
|
|
529
|
+
message: 'Must have changelog entry',
|
|
530
|
+
fix: 'Add entry to CHANGELOG.md',
|
|
531
|
+
validate: (entry, data) => {
|
|
532
|
+
const changelogEntry = data?.changelogEntry;
|
|
533
|
+
return !!changelogEntry;
|
|
534
|
+
},
|
|
535
|
+
},
|
|
536
|
+
{
|
|
537
|
+
id: 'RLSE-003',
|
|
538
|
+
level: 'SHOULD',
|
|
539
|
+
message: 'Should pass all tests before release',
|
|
540
|
+
fix: 'Run test suite: ./tests/run-all-tests.sh',
|
|
541
|
+
validate: (entry, data) => {
|
|
542
|
+
const testsPassed = data?.testsPassed;
|
|
543
|
+
if (testsPassed === undefined)
|
|
544
|
+
return true; // SHOULD level, pass when no data
|
|
545
|
+
return testsPassed === true;
|
|
546
|
+
},
|
|
547
|
+
},
|
|
548
|
+
{
|
|
549
|
+
id: 'RLSE-004',
|
|
550
|
+
level: 'MUST',
|
|
551
|
+
message: 'Must have git tag matching version',
|
|
552
|
+
fix: 'Create git tag: git tag v{version}',
|
|
553
|
+
validate: (entry, data) => {
|
|
554
|
+
const gitTag = data?.gitTag;
|
|
555
|
+
const version = data?.version;
|
|
556
|
+
if (!gitTag || !version)
|
|
557
|
+
return true; // No git data available, pass
|
|
558
|
+
// Tag should match version (with or without 'v' prefix)
|
|
559
|
+
return gitTag === version || gitTag === `v${version}`;
|
|
560
|
+
},
|
|
561
|
+
},
|
|
562
|
+
{
|
|
563
|
+
id: 'RLSE-005',
|
|
564
|
+
level: 'MUST',
|
|
565
|
+
message: 'Must have consistent version across VERSION file, README, and package.json',
|
|
566
|
+
fix: 'Run dev/validate-version.sh to check version consistency',
|
|
567
|
+
validate: (entry, data) => {
|
|
568
|
+
const versionConsistent = data?.versionConsistent;
|
|
569
|
+
if (versionConsistent === undefined)
|
|
570
|
+
return true; // No data available, pass
|
|
571
|
+
return versionConsistent === true;
|
|
572
|
+
},
|
|
573
|
+
},
|
|
574
|
+
{
|
|
575
|
+
id: 'RLSE-006',
|
|
576
|
+
level: 'SHOULD',
|
|
577
|
+
message: 'Should include rollback plan',
|
|
578
|
+
fix: 'Document rollback procedure in release notes',
|
|
579
|
+
validate: (entry, data) => {
|
|
580
|
+
const hasRollbackPlan = data?.hasRollbackPlan;
|
|
581
|
+
if (hasRollbackPlan === undefined)
|
|
582
|
+
return true; // SHOULD level, pass when no data
|
|
583
|
+
return hasRollbackPlan === true;
|
|
584
|
+
},
|
|
585
|
+
},
|
|
586
|
+
{
|
|
587
|
+
id: 'RLSE-007',
|
|
588
|
+
level: 'MUST',
|
|
589
|
+
message: 'Must set agent_type: documentation or release',
|
|
590
|
+
fix: 'Set agent_type appropriately',
|
|
591
|
+
validate: (entry) => {
|
|
592
|
+
return hasEnumValue(entry, 'agent_type', ['documentation', 'release']);
|
|
593
|
+
},
|
|
594
|
+
},
|
|
595
|
+
];
|
|
596
|
+
/**
|
|
597
|
+
* Validation Protocol Rules (VALID-*)
|
|
598
|
+
*/
|
|
599
|
+
const VALIDATION_RULES = [
|
|
600
|
+
{
|
|
601
|
+
id: 'VALID-001',
|
|
602
|
+
level: 'MUST',
|
|
603
|
+
message: 'Must verify output matches spec',
|
|
604
|
+
fix: 'Add validation_result field with pass/fail',
|
|
605
|
+
validate: (entry) => {
|
|
606
|
+
return hasField(entry, 'validation_result');
|
|
607
|
+
},
|
|
608
|
+
},
|
|
609
|
+
{
|
|
610
|
+
id: 'VALID-002',
|
|
611
|
+
level: 'MUST',
|
|
612
|
+
message: 'Must execute test suite during validation',
|
|
613
|
+
fix: 'Run test suite and record results in manifest',
|
|
614
|
+
validate: (entry, data) => {
|
|
615
|
+
const testResults = data?.testResults;
|
|
616
|
+
if (!testResults)
|
|
617
|
+
return true; // No test data, pass (tests may not apply)
|
|
618
|
+
return hasField(testResults, 'pass_rate');
|
|
619
|
+
},
|
|
620
|
+
},
|
|
621
|
+
{
|
|
622
|
+
id: 'VALID-003',
|
|
623
|
+
level: 'MUST',
|
|
624
|
+
message: 'Must check protocol compliance',
|
|
625
|
+
fix: 'Set status to complete/partial/blocked',
|
|
626
|
+
validate: (entry) => {
|
|
627
|
+
return hasEnumValue(entry, 'status', ['complete', 'partial', 'blocked']);
|
|
628
|
+
},
|
|
629
|
+
},
|
|
630
|
+
{
|
|
631
|
+
id: 'VALID-004',
|
|
632
|
+
level: 'SHOULD',
|
|
633
|
+
message: 'Should generate validation report',
|
|
634
|
+
fix: 'Add key_findings array with validation details',
|
|
635
|
+
validate: (entry) => {
|
|
636
|
+
return hasField(entry, 'key_findings');
|
|
637
|
+
},
|
|
638
|
+
},
|
|
639
|
+
{
|
|
640
|
+
id: 'VALID-005',
|
|
641
|
+
level: 'SHOULD',
|
|
642
|
+
message: 'Should classify violation severity (error/warning)',
|
|
643
|
+
fix: 'Include severity classification in validation results',
|
|
644
|
+
validate: (entry, data) => {
|
|
645
|
+
const violations = data?.violations;
|
|
646
|
+
if (!violations || violations.length === 0)
|
|
647
|
+
return true; // No violations, pass
|
|
648
|
+
return violations.every((v) => v.severity === 'error' || v.severity === 'warning');
|
|
649
|
+
},
|
|
650
|
+
},
|
|
651
|
+
{
|
|
652
|
+
id: 'VALID-006',
|
|
653
|
+
level: 'MUST',
|
|
654
|
+
message: 'Must set agent_type: validation',
|
|
655
|
+
fix: 'Set agent_type to validation',
|
|
656
|
+
validate: (entry) => {
|
|
657
|
+
return hasEnumValue(entry, 'agent_type', ['validation']);
|
|
658
|
+
},
|
|
659
|
+
},
|
|
660
|
+
];
|
|
661
|
+
/**
|
|
662
|
+
* Testing Protocol Rules (TEST-*)
|
|
663
|
+
*/
|
|
664
|
+
const TESTING_RULES = [
|
|
665
|
+
{
|
|
666
|
+
id: 'TEST-001',
|
|
667
|
+
level: 'MUST',
|
|
668
|
+
message: 'Must use configured test framework',
|
|
669
|
+
fix: 'Use project test framework (BATS for shell, Jest for TS)',
|
|
670
|
+
validate: (entry, data) => {
|
|
671
|
+
const testFramework = data?.testFramework;
|
|
672
|
+
if (!testFramework)
|
|
673
|
+
return true; // No framework specified, pass
|
|
674
|
+
const validFrameworks = ['bats', 'jest', 'vitest', 'mocha', 'pytest'];
|
|
675
|
+
return validFrameworks.includes(testFramework.toLowerCase());
|
|
676
|
+
},
|
|
677
|
+
},
|
|
678
|
+
{
|
|
679
|
+
id: 'TEST-002',
|
|
680
|
+
level: 'SHOULD',
|
|
681
|
+
message: 'Should follow test file naming conventions',
|
|
682
|
+
fix: 'Name test files: feature-name.bats or feature-name.test.ts',
|
|
683
|
+
validate: (entry, data) => {
|
|
684
|
+
const testFiles = data?.testFiles;
|
|
685
|
+
if (!testFiles || testFiles.length === 0)
|
|
686
|
+
return true; // SHOULD level, pass
|
|
687
|
+
return testFiles.every((f) => /\.(test|spec)\.(ts|js|tsx|jsx)$/.test(f) || /\.bats$/.test(f));
|
|
688
|
+
},
|
|
689
|
+
},
|
|
690
|
+
{
|
|
691
|
+
id: 'TEST-003',
|
|
692
|
+
level: 'SHOULD',
|
|
693
|
+
message: 'Should meet coverage thresholds',
|
|
694
|
+
fix: 'Increase test coverage to meet project thresholds',
|
|
695
|
+
validate: (entry, data) => {
|
|
696
|
+
const coveragePercent = data?.coveragePercent;
|
|
697
|
+
if (coveragePercent === undefined)
|
|
698
|
+
return true; // SHOULD level, pass when no data
|
|
699
|
+
return coveragePercent >= 80; // Default threshold
|
|
700
|
+
},
|
|
701
|
+
},
|
|
702
|
+
{
|
|
703
|
+
id: 'TEST-004',
|
|
704
|
+
level: 'MUST',
|
|
705
|
+
message: 'Must achieve 100% pass rate',
|
|
706
|
+
fix: 'Fix failing tests before completion',
|
|
707
|
+
validate: (entry, data) => {
|
|
708
|
+
const testResults = data?.testResults;
|
|
709
|
+
if (!testResults)
|
|
710
|
+
return false;
|
|
711
|
+
const passRate = testResults.pass_rate;
|
|
712
|
+
return passRate === 1.0 || passRate === 1;
|
|
713
|
+
},
|
|
714
|
+
},
|
|
715
|
+
{
|
|
716
|
+
id: 'TEST-005',
|
|
717
|
+
level: 'MUST',
|
|
718
|
+
message: 'Must cover all MUST requirements from specification',
|
|
719
|
+
fix: 'Add tests for each MUST requirement in the spec',
|
|
720
|
+
validate: (entry, data) => {
|
|
721
|
+
const mustRequirementsCovered = data?.mustRequirementsCovered;
|
|
722
|
+
if (mustRequirementsCovered === undefined)
|
|
723
|
+
return true; // No data, pass
|
|
724
|
+
return mustRequirementsCovered === true;
|
|
725
|
+
},
|
|
726
|
+
},
|
|
727
|
+
{
|
|
728
|
+
id: 'TEST-006',
|
|
729
|
+
level: 'MUST',
|
|
730
|
+
message: 'Must include test summary in manifest',
|
|
731
|
+
fix: 'Add key_findings array with test results',
|
|
732
|
+
validate: (entry) => {
|
|
733
|
+
return hasField(entry, 'key_findings');
|
|
734
|
+
},
|
|
735
|
+
},
|
|
736
|
+
{
|
|
737
|
+
id: 'TEST-007',
|
|
738
|
+
level: 'MUST',
|
|
739
|
+
message: 'Must set agent_type: testing',
|
|
740
|
+
fix: 'Set agent_type to testing',
|
|
741
|
+
validate: (entry) => {
|
|
742
|
+
return hasEnumValue(entry, 'agent_type', ['testing']);
|
|
743
|
+
},
|
|
744
|
+
},
|
|
745
|
+
];
|
|
746
|
+
/**
|
|
747
|
+
* Protocol rule registry
|
|
748
|
+
*/
|
|
749
|
+
export const PROTOCOL_RULES = {
|
|
750
|
+
research: RESEARCH_RULES,
|
|
751
|
+
consensus: CONSENSUS_RULES,
|
|
752
|
+
specification: SPECIFICATION_RULES,
|
|
753
|
+
decomposition: DECOMPOSITION_RULES,
|
|
754
|
+
implementation: IMPLEMENTATION_RULES,
|
|
755
|
+
contribution: CONTRIBUTION_RULES,
|
|
756
|
+
release: RELEASE_RULES,
|
|
757
|
+
validation: VALIDATION_RULES,
|
|
758
|
+
testing: TESTING_RULES,
|
|
759
|
+
};
|
|
760
|
+
//# sourceMappingURL=protocol-rules.js.map
|