@lifeaitools/rdc-skills 0.24.41 → 0.25.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/.claude/settings.json +15 -15
- package/.claude-plugin/marketplace.json +21 -21
- package/.claude-plugin/plugin.json +1518 -1371
- package/.github/workflows/publish.yml +34 -34
- package/.github/workflows/self-test.yml +58 -58
- package/CHANGELOG.md +310 -310
- package/LICENSE +21 -21
- package/MANIFEST.md +221 -221
- package/README.md +375 -376
- package/README.sandbox.md +3 -3
- package/assets/watcher/viewer.html +164 -164
- package/bin/rdc-skills-mcp.mjs +316 -316
- package/commands/build.md +183 -183
- package/commands/collab.md +180 -180
- package/commands/deploy.md +152 -152
- package/commands/design.md +31 -31
- package/commands/edit.md +28 -28
- package/commands/fixit.md +150 -124
- package/commands/handoff.md +173 -173
- package/commands/help.md +95 -95
- package/commands/overnight.md +220 -220
- package/commands/plan.md +158 -158
- package/commands/preplan.md +131 -131
- package/commands/prototype.md +145 -145
- package/commands/release.md +49 -49
- package/commands/report.md +99 -99
- package/commands/review.md +120 -120
- package/commands/self-test.md +113 -113
- package/commands/status.md +86 -86
- package/commands/watch.md +98 -98
- package/commands/workitems.md +137 -137
- package/git-sha.json +1 -1
- package/guides/agent-bootstrap.md +295 -295
- package/guides/agents/backend.md +104 -104
- package/guides/agents/content.md +94 -94
- package/guides/agents/cs2.md +56 -56
- package/guides/agents/data.md +87 -87
- package/guides/agents/design.md +77 -77
- package/guides/agents/frontend.md +92 -92
- package/guides/agents/infrastructure.md +81 -81
- package/guides/agents/setup.md +281 -281
- package/guides/agents/verify.md +151 -151
- package/guides/agents/viz.md +106 -106
- package/guides/backend.md +146 -146
- package/guides/content.md +147 -147
- package/guides/cs2.md +190 -190
- package/guides/data.md +123 -123
- package/guides/design.md +116 -116
- package/guides/engineering-behavior.md +43 -43
- package/guides/escalation-protocol.md +125 -125
- package/guides/frontend.md +151 -151
- package/guides/history-md-spec.md +297 -297
- package/guides/infrastructure.md +179 -179
- package/guides/lessons-learned-spec.md +145 -151
- package/guides/output-contract.md +108 -108
- package/guides/publish-md-spec.md +289 -289
- package/guides/rdc-skills-startup.md +30 -30
- package/guides/verify.md +11 -11
- package/hooks/check-cwd.js +31 -31
- package/hooks/check-rdc-environment.js +164 -164
- package/hooks/check-services.js +6 -6
- package/hooks/check-stale-work-items.js +19 -19
- package/hooks/foreground-process-gate.js +128 -128
- package/hooks/gate-watchdog-selfcheck.js +257 -257
- package/hooks/hook-logger.js +25 -25
- package/hooks/lib/run-evidence-gate.mjs +241 -241
- package/hooks/no-stop-open-epics.js +127 -127
- package/hooks/post-tool-batch-gate.js +203 -203
- package/hooks/post-work-check.js +21 -21
- package/hooks/postcompact-log.js +13 -13
- package/hooks/precompact-log.js +13 -13
- package/hooks/rate-limit-retry.js +46 -46
- package/hooks/rdc-invocation-marker.js +157 -157
- package/hooks/rdc-output-contract-gate.js +94 -94
- package/hooks/require-work-item-on-commit.js +294 -294
- package/hooks/restart-brief.js +19 -19
- package/hooks/run-hidden-hook.ps1 +47 -47
- package/hooks/task-completed-gate.js +274 -274
- package/hooks/work-item-exit-gate.js +944 -944
- package/lib/catalog.mjs +236 -236
- package/lib/cloud-rewrite.mjs +155 -155
- package/package.json +57 -57
- package/rules/work-items-rpc.md +520 -520
- package/scaffold/templates/HISTORY.md.template +39 -39
- package/scaffold/templates/PUBLISH.md.template +21 -21
- package/scaffold/templates/brochure-studio-default.html +70 -70
- package/scripts/acceptance.mjs +502 -502
- package/scripts/fixtures/guides/bad-guide.md +15 -15
- package/scripts/fixtures/guides-clean/good-guide.md +16 -16
- package/scripts/install-rdc-skills.js +1289 -1289
- package/scripts/install.ps1 +202 -202
- package/scripts/install.sh +132 -132
- package/scripts/lib/assertions.mjs +287 -287
- package/scripts/lib/manifest-schema.mjs +754 -754
- package/scripts/lib/runner.mjs +465 -465
- package/scripts/lib/sandbox.mjs +435 -435
- package/scripts/prepack.mjs +32 -32
- package/scripts/rdc-brochure.mjs +482 -482
- package/scripts/rdc-design-cli.mjs +134 -134
- package/scripts/rebuild-mcp.mjs +107 -107
- package/scripts/self-test.mjs +1460 -1460
- package/scripts/stamp-git-sha.mjs +29 -29
- package/scripts/test-guide-validator.mjs +196 -196
- package/scripts/test-rdc-hooks.mjs +145 -145
- package/scripts/uninstall.ps1 +77 -77
- package/scripts/uninstall.sh +69 -69
- package/scripts/update.ps1 +43 -43
- package/scripts/update.sh +43 -43
- package/scripts/validate-place-histories.js +461 -461
- package/scripts/validate-publish-manifests.js +502 -424
- package/scripts/watch-init.mjs +100 -100
- package/skills/brochure/SKILL.md +107 -107
- package/skills/build/SKILL.md +563 -563
- package/skills/channel-formatter/SKILL.md +538 -533
- package/skills/co-develop/SKILL.md +196 -196
- package/skills/collab/SKILL.md +239 -239
- package/skills/convert/SKILL.md +167 -140
- package/skills/deploy/SKILL.md +541 -541
- package/skills/design/SKILL.md +211 -211
- package/skills/design/reference/ownership.md +16 -16
- package/skills/design/reference/rampa.md +92 -92
- package/skills/design/reference/studio-model.md +153 -153
- package/skills/edit/SKILL.md +98 -98
- package/skills/fixit/SKILL.md +203 -165
- package/skills/fs-mcp/SKILL.md +148 -148
- package/skills/handoff/SKILL.md +236 -236
- package/skills/help/SKILL.md +143 -143
- package/skills/housekeeping/SKILL.md +160 -219
- package/skills/lifeai-brochure-author/SKILL.md +340 -340
- package/skills/onramp/SKILL.md +248 -0
- package/skills/overnight/SKILL.md +251 -251
- package/skills/plan/SKILL.md +345 -345
- package/skills/preplan/SKILL.md +90 -90
- package/skills/prototype/SKILL.md +150 -150
- package/skills/rdc-brochurify/SKILL.md +245 -245
- package/skills/rdc-extract-verifier-rules/SKILL.md +191 -191
- package/skills/release/SKILL.md +140 -140
- package/skills/report/SKILL.md +100 -100
- package/skills/review/SKILL.md +152 -152
- package/skills/rpms-filemap/SKILL.cloud.md +111 -111
- package/skills/rpms-filemap/SKILL.md +111 -111
- package/skills/self-test/SKILL.md +132 -132
- package/skills/status/SKILL.md +99 -99
- package/skills/terminal-config/SKILL.md +62 -62
- package/skills/tests/MATRIX.md +54 -54
- package/skills/tests/README.md +47 -47
- package/skills/tests/onramp.test.json +87 -0
- package/skills/tests/rdc-brochure.test.json +34 -34
- package/skills/tests/rdc-build.test.json +36 -36
- package/skills/tests/rdc-channel-formatter.test.json +45 -45
- package/skills/tests/rdc-co-develop.test.json +29 -29
- package/skills/tests/rdc-collab.test.json +29 -29
- package/skills/tests/rdc-convert.test.json +35 -35
- package/skills/tests/rdc-deploy.test.json +30 -30
- package/skills/tests/rdc-design.test.json +27 -27
- package/skills/tests/rdc-edit.test.json +29 -29
- package/skills/tests/rdc-fixit.test.json +36 -36
- package/skills/tests/rdc-fs-mcp.test.json +36 -36
- package/skills/tests/rdc-handoff.test.json +28 -28
- package/skills/tests/rdc-help.test.json +29 -29
- package/skills/tests/rdc-housekeeping.test.json +28 -32
- package/skills/tests/rdc-lifeai-brochure-author.test.json +35 -35
- package/skills/tests/rdc-overnight.test.json +37 -37
- package/skills/tests/rdc-plan.test.json +27 -27
- package/skills/tests/rdc-preplan.test.json +31 -31
- package/skills/tests/rdc-prototype.test.json +28 -28
- package/skills/tests/rdc-rdc-brochurify.test.json +23 -23
- package/skills/tests/rdc-rdc-extract-verifier-rules.test.json +34 -34
- package/skills/tests/rdc-release.test.json +29 -29
- package/skills/tests/rdc-report.test.json +28 -28
- package/skills/tests/rdc-review.test.json +29 -29
- package/skills/tests/rdc-rpms-filemap.test.json +28 -28
- package/skills/tests/rdc-self-test.test.json +24 -24
- package/skills/tests/rdc-status.test.json +29 -29
- package/skills/tests/rdc-terminal-config.test.json +29 -29
- package/skills/tests/rdc-watch.test.json +24 -24
- package/skills/tests/rdc-workitems.test.json +27 -27
- package/skills/watch/SKILL.md +97 -97
- package/skills/workitems/SKILL.md +151 -151
- package/tests/acceptance.test.mjs +59 -59
- package/tests/channel-formatter.contract.test.mjs +251 -251
- package/tests/curl-surface.test.mjs +289 -289
- package/tests/harness-gates.test.mjs +325 -325
- package/tests/help-surface.test.mjs +61 -61
- package/tests/install-rdc-skills.test.mjs +49 -49
- package/tests/manifest-contract-fields.test.mjs +78 -78
- package/tests/mcp.test.mjs +271 -271
- package/tests/rdc-brochure.test.mjs +125 -125
- package/tests/require-work-item-on-commit.test.mjs +162 -162
- package/tests/run-evidence-gate.test.mjs +82 -82
- package/tests/skill-test-matrix.test.mjs +66 -66
- package/tests/validate-skills.js +27 -27
- package/tests/work-item-exit-gate-l2.test.mjs +368 -368
- package/tests/work-item-exit-gate-l3.test.mjs +197 -197
- package/RELEASE.md +0 -42
- package/tests/housekeeping-lessons-triage.test.mjs +0 -49
- package/tests/lessons-pipeline-contract.test.mjs +0 -26
- package/tests/release-contract.test.mjs +0 -16
|
@@ -1,197 +1,197 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
/**
|
|
3
|
-
* Truth Gate 3.0 — Layer 3 (validator re-run receipt) tests for the closure gate.
|
|
4
|
-
*
|
|
5
|
-
* Exercises the FLAG-GATED Layer-3 check wired into work-item-exit-gate.js. The
|
|
6
|
-
* receipt store, running-sha probe, and secret are injected via verifyLayer3's
|
|
7
|
-
* `deps`, so the test runs fully offline (no DB, no brain, no clauth). The HMAC
|
|
8
|
-
* is computed with a fixed secret using the SAME canonical field order the gate
|
|
9
|
-
* mirrors from receipt.mjs.
|
|
10
|
-
*
|
|
11
|
-
* Branches proven:
|
|
12
|
-
* A. flag OFF → ALLOW as today (no-op, no receipt needed)
|
|
13
|
-
* B. flag ON + valid receipt (fresh nonce, pinned sha, unreplayed) → ALLOW
|
|
14
|
-
* C. flag ON + NO receipt → DENY
|
|
15
|
-
* D. flag ON + forged/tampered HMAC → DENY
|
|
16
|
-
* E. flag ON + stale-by-age receipt → DENY
|
|
17
|
-
* F. flag ON + replayed nonce (in durable seen-set) → DENY
|
|
18
|
-
* G. flag ON + wrong git_sha (not the running brain) → DENY
|
|
19
|
-
* H. flag ON + nonce_in_output:false (cached artifact) → DENY
|
|
20
|
-
* I. flag ON + witness:"agent" (self-witness) → DENY
|
|
21
|
-
* J. flag ON + INFRA: no secret → DENY ; no running sha → DENY
|
|
22
|
-
* K. truthGateFlagEnabled reads the env switch
|
|
23
|
-
*
|
|
24
|
-
* Run: node tests/work-item-exit-gate-l3.test.mjs
|
|
25
|
-
*/
|
|
26
|
-
import { resolve, dirname, join } from 'node:path';
|
|
27
|
-
import { fileURLToPath } from 'node:url';
|
|
28
|
-
import { createRequire } from 'node:module';
|
|
29
|
-
import crypto from 'node:crypto';
|
|
30
|
-
|
|
31
|
-
const __dirname = dirname(fileURLToPath(import.meta.url));
|
|
32
|
-
const REPO_ROOT = resolve(__dirname, '..');
|
|
33
|
-
const HOOK = join(REPO_ROOT, 'hooks', 'work-item-exit-gate.js');
|
|
34
|
-
|
|
35
|
-
const require = createRequire(import.meta.url);
|
|
36
|
-
const gate = require(HOOK);
|
|
37
|
-
|
|
38
|
-
const failures = [];
|
|
39
|
-
function assert(name, condition, detail = '') {
|
|
40
|
-
if (!condition) failures.push(`${name}${detail ? `: ${detail}` : ''}`);
|
|
41
|
-
else process.stdout.write(` ok ${name}\n`);
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
const SECRET = 'test-secret-not-real';
|
|
45
|
-
const SHA = 'c3189c9d58a37d648e9de4a6bcd7d46772053eea';
|
|
46
|
-
const NOW = Date.parse('2026-06-25T12:00:00Z');
|
|
47
|
-
const SIGNED_FIELDS = gate.VALIDATOR_SIGNED_FIELDS;
|
|
48
|
-
|
|
49
|
-
function signValidator(receipt, secret = SECRET) {
|
|
50
|
-
const picked = {};
|
|
51
|
-
for (const k of SIGNED_FIELDS) picked[k] = receipt[k] ?? null;
|
|
52
|
-
return crypto.createHmac('sha256', secret).update(JSON.stringify(picked)).digest('hex');
|
|
53
|
-
}
|
|
54
|
-
|
|
55
|
-
/** A signed, otherwise-valid validator receipt; override fields to break it. */
|
|
56
|
-
function freshReceipt(over = {}) {
|
|
57
|
-
const r = {
|
|
58
|
-
claim: 'WP-4 validator re-run passes',
|
|
59
|
-
witness: 'validator-rerun',
|
|
60
|
-
git_sha: SHA,
|
|
61
|
-
nonce: 'vrr-fresh-abc123',
|
|
62
|
-
command: 'node scripts/needle-verify.mjs',
|
|
63
|
-
result: { exit_code: 0 },
|
|
64
|
-
nonce_in_output: true,
|
|
65
|
-
ts: new Date(NOW - 60_000).toISOString(), // 1 min old
|
|
66
|
-
...over,
|
|
67
|
-
};
|
|
68
|
-
r.hmac = signValidator(r);
|
|
69
|
-
return r;
|
|
70
|
-
}
|
|
71
|
-
|
|
72
|
-
const statusCall = { id: '11111111-2222-3333-4444-555555555555', actorSessionId: 'validator-x', actorRole: 'validator' };
|
|
73
|
-
const item = { id: statusCall.id, item_type: 'task', status: 'review', session_id: 'sess-origin' };
|
|
74
|
-
|
|
75
|
-
/** Build a deps object that drives verifyLayer3 fully offline. */
|
|
76
|
-
function deps({ flag = true, secret = SECRET, runningSha = SHA, receipts = [], seenNonces = [] } = {}) {
|
|
77
|
-
return {
|
|
78
|
-
flagEnabled: async () => flag,
|
|
79
|
-
getSecret: async () => secret,
|
|
80
|
-
getRunningSha: async () => runningSha,
|
|
81
|
-
loadReceiptRows: async () => receipts.map((p) => ({ payload: p })),
|
|
82
|
-
loadSeenNonces: async () => seenNonces,
|
|
83
|
-
};
|
|
84
|
-
}
|
|
85
|
-
|
|
86
|
-
/** Run verifyLayer3 and return the GateDenied reason, or null if it allowed. */
|
|
87
|
-
async function runL3(d) {
|
|
88
|
-
try {
|
|
89
|
-
await gate.verifyLayer3(statusCall, item, d, NOW);
|
|
90
|
-
return null; // ALLOW
|
|
91
|
-
} catch (e) {
|
|
92
|
-
if (e instanceof gate.GateDenied) return e.reason;
|
|
93
|
-
throw e;
|
|
94
|
-
}
|
|
95
|
-
}
|
|
96
|
-
|
|
97
|
-
await (async () => {
|
|
98
|
-
// A. flag OFF → ALLOW as today (no receipt needed at all)
|
|
99
|
-
{
|
|
100
|
-
const r = await runL3(deps({ flag: false, receipts: [] }));
|
|
101
|
-
assert('A. flag OFF → ALLOW (no-op, no receipt)', r === null, r || '');
|
|
102
|
-
}
|
|
103
|
-
|
|
104
|
-
// B. flag ON + valid receipt → ALLOW
|
|
105
|
-
{
|
|
106
|
-
const r = await runL3(deps({ receipts: [freshReceipt()] }));
|
|
107
|
-
assert('B. flag ON + valid receipt → ALLOW', r === null, r || '');
|
|
108
|
-
}
|
|
109
|
-
|
|
110
|
-
// C. flag ON + NO receipt → DENY
|
|
111
|
-
{
|
|
112
|
-
const r = await runL3(deps({ receipts: [] }));
|
|
113
|
-
assert('C. flag ON + no receipt → DENY', r && /no validator re-run receipt found/.test(r), r || 'no denial');
|
|
114
|
-
}
|
|
115
|
-
|
|
116
|
-
// D. flag ON + forged/tampered HMAC → DENY
|
|
117
|
-
{
|
|
118
|
-
const bad = freshReceipt();
|
|
119
|
-
bad.claim = 'TAMPERED after signing'; // signature no longer matches
|
|
120
|
-
const r = await runL3(deps({ receipts: [bad] }));
|
|
121
|
-
assert('D. flag ON + forged HMAC → DENY', r && /HMAC invalid\/absent/.test(r), r || 'no denial');
|
|
122
|
-
}
|
|
123
|
-
|
|
124
|
-
// E. flag ON + stale-by-age receipt → DENY
|
|
125
|
-
{
|
|
126
|
-
const stale = freshReceipt({ ts: new Date(NOW - 60 * 60_000).toISOString() });
|
|
127
|
-
const r = await runL3(deps({ receipts: [stale] }));
|
|
128
|
-
assert('E. flag ON + stale receipt → DENY', r && /stale/.test(r), r || 'no denial');
|
|
129
|
-
}
|
|
130
|
-
|
|
131
|
-
// F. flag ON + replayed nonce (in durable seen-set) → DENY
|
|
132
|
-
{
|
|
133
|
-
const rec = freshReceipt();
|
|
134
|
-
const r = await runL3(deps({ receipts: [rec], seenNonces: [rec.nonce] }));
|
|
135
|
-
assert('F. flag ON + replayed nonce → DENY', r && /replayed|already consumed/.test(r), r || 'no denial');
|
|
136
|
-
}
|
|
137
|
-
|
|
138
|
-
// G. flag ON + wrong git_sha (not the running brain) → DENY
|
|
139
|
-
{
|
|
140
|
-
const r = await runL3(deps({ receipts: [freshReceipt()], runningSha: 'deadbeefdeadbeefdeadbeefdeadbeefdeadbeef' }));
|
|
141
|
-
assert('G. flag ON + wrong git_sha → DENY', r && /git_sha/.test(r), r || 'no denial');
|
|
142
|
-
}
|
|
143
|
-
|
|
144
|
-
// H. flag ON + nonce_in_output:false (cached artifact) → DENY
|
|
145
|
-
{
|
|
146
|
-
const r = await runL3(deps({ receipts: [freshReceipt({ nonce_in_output: false })] }));
|
|
147
|
-
assert('H. flag ON + nonce_in_output:false → DENY', r && /nonce_in_output|cached|replay/.test(r), r || 'no denial');
|
|
148
|
-
}
|
|
149
|
-
|
|
150
|
-
// I. flag ON + witness:"agent" (self-witness) → DENY
|
|
151
|
-
{
|
|
152
|
-
const r = await runL3(deps({ receipts: [freshReceipt({ witness: 'agent' })] }));
|
|
153
|
-
assert('I. flag ON + witness:agent → DENY', r && /witness/.test(r), r || 'no denial');
|
|
154
|
-
}
|
|
155
|
-
|
|
156
|
-
// I2. flag ON + result not a pass (exit_code:1) → DENY
|
|
157
|
-
{
|
|
158
|
-
const r = await runL3(deps({ receipts: [freshReceipt({ result: { exit_code: 1 } })] }));
|
|
159
|
-
assert('I2. flag ON + failing result → DENY', r && /pass/.test(r), r || 'no denial');
|
|
160
|
-
}
|
|
161
|
-
|
|
162
|
-
// J. INFRA fail-closed: no secret → DENY ; no running sha → DENY
|
|
163
|
-
{
|
|
164
|
-
const r1 = await runL3(deps({ secret: null, receipts: [freshReceipt()] }));
|
|
165
|
-
assert('J. flag ON + no secret → DENY (INFRA is a BLOCK)', r1 && /INFRA: no truth-gate HMAC secret/.test(r1), r1 || 'no denial');
|
|
166
|
-
const r2 = await runL3(deps({ runningSha: null, receipts: [freshReceipt()] }));
|
|
167
|
-
assert('J. flag ON + no running sha → DENY (INFRA is a BLOCK)', r2 && /INFRA: could not read the running brain git_sha/.test(r2), r2 || 'no denial');
|
|
168
|
-
}
|
|
169
|
-
|
|
170
|
-
// K. truthGateFlagEnabled reads the env switch (default OFF)
|
|
171
|
-
{
|
|
172
|
-
const prev = process.env.RDC_TRUTHGATE_REQUIRE_VALIDATOR_RECEIPT;
|
|
173
|
-
delete process.env.RDC_TRUTHGATE_REQUIRE_VALIDATOR_RECEIPT;
|
|
174
|
-
assert('K. flag default OFF', gate.truthGateFlagEnabled('require_validator_receipt') === false);
|
|
175
|
-
process.env.RDC_TRUTHGATE_REQUIRE_VALIDATOR_RECEIPT = 'true';
|
|
176
|
-
assert('K. flag ON via env', gate.truthGateFlagEnabled('require_validator_receipt') === true);
|
|
177
|
-
process.env.RDC_TRUTHGATE_REQUIRE_VALIDATOR_RECEIPT = '0';
|
|
178
|
-
assert('K. flag "0" is OFF', gate.truthGateFlagEnabled('require_validator_receipt') === false);
|
|
179
|
-
if (prev === undefined) delete process.env.RDC_TRUTHGATE_REQUIRE_VALIDATOR_RECEIPT;
|
|
180
|
-
else process.env.RDC_TRUTHGATE_REQUIRE_VALIDATOR_RECEIPT = prev;
|
|
181
|
-
}
|
|
182
|
-
|
|
183
|
-
// L. pickNewestValidatorReceipt picks the latest by ts
|
|
184
|
-
{
|
|
185
|
-
const older = freshReceipt({ nonce: 'older', ts: new Date(NOW - 10 * 60_000).toISOString() });
|
|
186
|
-
const newer = freshReceipt({ nonce: 'newer', ts: new Date(NOW - 60_000).toISOString() });
|
|
187
|
-
const picked = gate.pickNewestValidatorReceipt([{ payload: older }, { payload: newer }]);
|
|
188
|
-
assert('L. picks newest receipt by ts', picked && picked.nonce === 'newer', picked ? picked.nonce : 'null');
|
|
189
|
-
}
|
|
190
|
-
})();
|
|
191
|
-
|
|
192
|
-
if (failures.length > 0) {
|
|
193
|
-
console.error('\nwork-item-exit-gate L3 tests — FAIL\n');
|
|
194
|
-
for (const f of failures) console.error(` - ${f}`);
|
|
195
|
-
process.exit(1);
|
|
196
|
-
}
|
|
197
|
-
console.log('\nwork-item-exit-gate L3 tests — PASS');
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* Truth Gate 3.0 — Layer 3 (validator re-run receipt) tests for the closure gate.
|
|
4
|
+
*
|
|
5
|
+
* Exercises the FLAG-GATED Layer-3 check wired into work-item-exit-gate.js. The
|
|
6
|
+
* receipt store, running-sha probe, and secret are injected via verifyLayer3's
|
|
7
|
+
* `deps`, so the test runs fully offline (no DB, no brain, no clauth). The HMAC
|
|
8
|
+
* is computed with a fixed secret using the SAME canonical field order the gate
|
|
9
|
+
* mirrors from receipt.mjs.
|
|
10
|
+
*
|
|
11
|
+
* Branches proven:
|
|
12
|
+
* A. flag OFF → ALLOW as today (no-op, no receipt needed)
|
|
13
|
+
* B. flag ON + valid receipt (fresh nonce, pinned sha, unreplayed) → ALLOW
|
|
14
|
+
* C. flag ON + NO receipt → DENY
|
|
15
|
+
* D. flag ON + forged/tampered HMAC → DENY
|
|
16
|
+
* E. flag ON + stale-by-age receipt → DENY
|
|
17
|
+
* F. flag ON + replayed nonce (in durable seen-set) → DENY
|
|
18
|
+
* G. flag ON + wrong git_sha (not the running brain) → DENY
|
|
19
|
+
* H. flag ON + nonce_in_output:false (cached artifact) → DENY
|
|
20
|
+
* I. flag ON + witness:"agent" (self-witness) → DENY
|
|
21
|
+
* J. flag ON + INFRA: no secret → DENY ; no running sha → DENY
|
|
22
|
+
* K. truthGateFlagEnabled reads the env switch
|
|
23
|
+
*
|
|
24
|
+
* Run: node tests/work-item-exit-gate-l3.test.mjs
|
|
25
|
+
*/
|
|
26
|
+
import { resolve, dirname, join } from 'node:path';
|
|
27
|
+
import { fileURLToPath } from 'node:url';
|
|
28
|
+
import { createRequire } from 'node:module';
|
|
29
|
+
import crypto from 'node:crypto';
|
|
30
|
+
|
|
31
|
+
const __dirname = dirname(fileURLToPath(import.meta.url));
|
|
32
|
+
const REPO_ROOT = resolve(__dirname, '..');
|
|
33
|
+
const HOOK = join(REPO_ROOT, 'hooks', 'work-item-exit-gate.js');
|
|
34
|
+
|
|
35
|
+
const require = createRequire(import.meta.url);
|
|
36
|
+
const gate = require(HOOK);
|
|
37
|
+
|
|
38
|
+
const failures = [];
|
|
39
|
+
function assert(name, condition, detail = '') {
|
|
40
|
+
if (!condition) failures.push(`${name}${detail ? `: ${detail}` : ''}`);
|
|
41
|
+
else process.stdout.write(` ok ${name}\n`);
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
const SECRET = 'test-secret-not-real';
|
|
45
|
+
const SHA = 'c3189c9d58a37d648e9de4a6bcd7d46772053eea';
|
|
46
|
+
const NOW = Date.parse('2026-06-25T12:00:00Z');
|
|
47
|
+
const SIGNED_FIELDS = gate.VALIDATOR_SIGNED_FIELDS;
|
|
48
|
+
|
|
49
|
+
function signValidator(receipt, secret = SECRET) {
|
|
50
|
+
const picked = {};
|
|
51
|
+
for (const k of SIGNED_FIELDS) picked[k] = receipt[k] ?? null;
|
|
52
|
+
return crypto.createHmac('sha256', secret).update(JSON.stringify(picked)).digest('hex');
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/** A signed, otherwise-valid validator receipt; override fields to break it. */
|
|
56
|
+
function freshReceipt(over = {}) {
|
|
57
|
+
const r = {
|
|
58
|
+
claim: 'WP-4 validator re-run passes',
|
|
59
|
+
witness: 'validator-rerun',
|
|
60
|
+
git_sha: SHA,
|
|
61
|
+
nonce: 'vrr-fresh-abc123',
|
|
62
|
+
command: 'node scripts/needle-verify.mjs',
|
|
63
|
+
result: { exit_code: 0 },
|
|
64
|
+
nonce_in_output: true,
|
|
65
|
+
ts: new Date(NOW - 60_000).toISOString(), // 1 min old
|
|
66
|
+
...over,
|
|
67
|
+
};
|
|
68
|
+
r.hmac = signValidator(r);
|
|
69
|
+
return r;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
const statusCall = { id: '11111111-2222-3333-4444-555555555555', actorSessionId: 'validator-x', actorRole: 'validator' };
|
|
73
|
+
const item = { id: statusCall.id, item_type: 'task', status: 'review', session_id: 'sess-origin' };
|
|
74
|
+
|
|
75
|
+
/** Build a deps object that drives verifyLayer3 fully offline. */
|
|
76
|
+
function deps({ flag = true, secret = SECRET, runningSha = SHA, receipts = [], seenNonces = [] } = {}) {
|
|
77
|
+
return {
|
|
78
|
+
flagEnabled: async () => flag,
|
|
79
|
+
getSecret: async () => secret,
|
|
80
|
+
getRunningSha: async () => runningSha,
|
|
81
|
+
loadReceiptRows: async () => receipts.map((p) => ({ payload: p })),
|
|
82
|
+
loadSeenNonces: async () => seenNonces,
|
|
83
|
+
};
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
/** Run verifyLayer3 and return the GateDenied reason, or null if it allowed. */
|
|
87
|
+
async function runL3(d) {
|
|
88
|
+
try {
|
|
89
|
+
await gate.verifyLayer3(statusCall, item, d, NOW);
|
|
90
|
+
return null; // ALLOW
|
|
91
|
+
} catch (e) {
|
|
92
|
+
if (e instanceof gate.GateDenied) return e.reason;
|
|
93
|
+
throw e;
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
await (async () => {
|
|
98
|
+
// A. flag OFF → ALLOW as today (no receipt needed at all)
|
|
99
|
+
{
|
|
100
|
+
const r = await runL3(deps({ flag: false, receipts: [] }));
|
|
101
|
+
assert('A. flag OFF → ALLOW (no-op, no receipt)', r === null, r || '');
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
// B. flag ON + valid receipt → ALLOW
|
|
105
|
+
{
|
|
106
|
+
const r = await runL3(deps({ receipts: [freshReceipt()] }));
|
|
107
|
+
assert('B. flag ON + valid receipt → ALLOW', r === null, r || '');
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
// C. flag ON + NO receipt → DENY
|
|
111
|
+
{
|
|
112
|
+
const r = await runL3(deps({ receipts: [] }));
|
|
113
|
+
assert('C. flag ON + no receipt → DENY', r && /no validator re-run receipt found/.test(r), r || 'no denial');
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
// D. flag ON + forged/tampered HMAC → DENY
|
|
117
|
+
{
|
|
118
|
+
const bad = freshReceipt();
|
|
119
|
+
bad.claim = 'TAMPERED after signing'; // signature no longer matches
|
|
120
|
+
const r = await runL3(deps({ receipts: [bad] }));
|
|
121
|
+
assert('D. flag ON + forged HMAC → DENY', r && /HMAC invalid\/absent/.test(r), r || 'no denial');
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
// E. flag ON + stale-by-age receipt → DENY
|
|
125
|
+
{
|
|
126
|
+
const stale = freshReceipt({ ts: new Date(NOW - 60 * 60_000).toISOString() });
|
|
127
|
+
const r = await runL3(deps({ receipts: [stale] }));
|
|
128
|
+
assert('E. flag ON + stale receipt → DENY', r && /stale/.test(r), r || 'no denial');
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
// F. flag ON + replayed nonce (in durable seen-set) → DENY
|
|
132
|
+
{
|
|
133
|
+
const rec = freshReceipt();
|
|
134
|
+
const r = await runL3(deps({ receipts: [rec], seenNonces: [rec.nonce] }));
|
|
135
|
+
assert('F. flag ON + replayed nonce → DENY', r && /replayed|already consumed/.test(r), r || 'no denial');
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
// G. flag ON + wrong git_sha (not the running brain) → DENY
|
|
139
|
+
{
|
|
140
|
+
const r = await runL3(deps({ receipts: [freshReceipt()], runningSha: 'deadbeefdeadbeefdeadbeefdeadbeefdeadbeef' }));
|
|
141
|
+
assert('G. flag ON + wrong git_sha → DENY', r && /git_sha/.test(r), r || 'no denial');
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
// H. flag ON + nonce_in_output:false (cached artifact) → DENY
|
|
145
|
+
{
|
|
146
|
+
const r = await runL3(deps({ receipts: [freshReceipt({ nonce_in_output: false })] }));
|
|
147
|
+
assert('H. flag ON + nonce_in_output:false → DENY', r && /nonce_in_output|cached|replay/.test(r), r || 'no denial');
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
// I. flag ON + witness:"agent" (self-witness) → DENY
|
|
151
|
+
{
|
|
152
|
+
const r = await runL3(deps({ receipts: [freshReceipt({ witness: 'agent' })] }));
|
|
153
|
+
assert('I. flag ON + witness:agent → DENY', r && /witness/.test(r), r || 'no denial');
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
// I2. flag ON + result not a pass (exit_code:1) → DENY
|
|
157
|
+
{
|
|
158
|
+
const r = await runL3(deps({ receipts: [freshReceipt({ result: { exit_code: 1 } })] }));
|
|
159
|
+
assert('I2. flag ON + failing result → DENY', r && /pass/.test(r), r || 'no denial');
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
// J. INFRA fail-closed: no secret → DENY ; no running sha → DENY
|
|
163
|
+
{
|
|
164
|
+
const r1 = await runL3(deps({ secret: null, receipts: [freshReceipt()] }));
|
|
165
|
+
assert('J. flag ON + no secret → DENY (INFRA is a BLOCK)', r1 && /INFRA: no truth-gate HMAC secret/.test(r1), r1 || 'no denial');
|
|
166
|
+
const r2 = await runL3(deps({ runningSha: null, receipts: [freshReceipt()] }));
|
|
167
|
+
assert('J. flag ON + no running sha → DENY (INFRA is a BLOCK)', r2 && /INFRA: could not read the running brain git_sha/.test(r2), r2 || 'no denial');
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
// K. truthGateFlagEnabled reads the env switch (default OFF)
|
|
171
|
+
{
|
|
172
|
+
const prev = process.env.RDC_TRUTHGATE_REQUIRE_VALIDATOR_RECEIPT;
|
|
173
|
+
delete process.env.RDC_TRUTHGATE_REQUIRE_VALIDATOR_RECEIPT;
|
|
174
|
+
assert('K. flag default OFF', gate.truthGateFlagEnabled('require_validator_receipt') === false);
|
|
175
|
+
process.env.RDC_TRUTHGATE_REQUIRE_VALIDATOR_RECEIPT = 'true';
|
|
176
|
+
assert('K. flag ON via env', gate.truthGateFlagEnabled('require_validator_receipt') === true);
|
|
177
|
+
process.env.RDC_TRUTHGATE_REQUIRE_VALIDATOR_RECEIPT = '0';
|
|
178
|
+
assert('K. flag "0" is OFF', gate.truthGateFlagEnabled('require_validator_receipt') === false);
|
|
179
|
+
if (prev === undefined) delete process.env.RDC_TRUTHGATE_REQUIRE_VALIDATOR_RECEIPT;
|
|
180
|
+
else process.env.RDC_TRUTHGATE_REQUIRE_VALIDATOR_RECEIPT = prev;
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
// L. pickNewestValidatorReceipt picks the latest by ts
|
|
184
|
+
{
|
|
185
|
+
const older = freshReceipt({ nonce: 'older', ts: new Date(NOW - 10 * 60_000).toISOString() });
|
|
186
|
+
const newer = freshReceipt({ nonce: 'newer', ts: new Date(NOW - 60_000).toISOString() });
|
|
187
|
+
const picked = gate.pickNewestValidatorReceipt([{ payload: older }, { payload: newer }]);
|
|
188
|
+
assert('L. picks newest receipt by ts', picked && picked.nonce === 'newer', picked ? picked.nonce : 'null');
|
|
189
|
+
}
|
|
190
|
+
})();
|
|
191
|
+
|
|
192
|
+
if (failures.length > 0) {
|
|
193
|
+
console.error('\nwork-item-exit-gate L3 tests — FAIL\n');
|
|
194
|
+
for (const f of failures) console.error(` - ${f}`);
|
|
195
|
+
process.exit(1);
|
|
196
|
+
}
|
|
197
|
+
console.log('\nwork-item-exit-gate L3 tests — PASS');
|
package/RELEASE.md
DELETED
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
doc_type: release-runbook
|
|
3
|
-
status: active
|
|
4
|
-
package: "@lifeaitools/rdc-skills"
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Release rdc-skills
|
|
8
|
-
|
|
9
|
-
`@lifeaitools/rdc-skills` is released to npm and then installed into the active
|
|
10
|
-
LifeAI skill profile. This runbook is the required release contract for every
|
|
11
|
-
version.
|
|
12
|
-
|
|
13
|
-
## Release checklist
|
|
14
|
-
|
|
15
|
-
1. Reconcile the release branch with its remote and confirm the intended diff.
|
|
16
|
-
2. Run `npm run validate`, focused deterministic tests, and an independent RDC
|
|
17
|
-
review for the candidate changes.
|
|
18
|
-
3. Bump the package with `npm version patch --no-git-tag-version` (or the
|
|
19
|
-
approved minor or major equivalent).
|
|
20
|
-
4. Commit the version files with the associated RDC work-item trailer and push
|
|
21
|
-
the release branch.
|
|
22
|
-
5. Create and push `v<version>`; the publish workflow publishes the tagged
|
|
23
|
-
package to npm.
|
|
24
|
-
6. Wait for the publish workflow to complete, then verify it with
|
|
25
|
-
`npm view @lifeaitools/rdc-skills version` and
|
|
26
|
-
`npm view @lifeaitools/rdc-skills@<version> version`.
|
|
27
|
-
7. Inspect the registry artifact with
|
|
28
|
-
`npm pack @lifeaitools/rdc-skills@<version>` and verify the changed skill
|
|
29
|
-
files are present in the tarball.
|
|
30
|
-
8. Install the published package with
|
|
31
|
-
`npm install -g @lifeaitools/rdc-skills@<version>`.
|
|
32
|
-
9. Reinstall the active profile with `rdc-skills-install --profile core`; on a
|
|
33
|
-
workstation intentionally configured for the LIFEAI project layout and
|
|
34
|
-
services, use `rdc-skills-install --profile lifeai`.
|
|
35
|
-
10. Verify the global package version, the active profile copy, and the skill
|
|
36
|
-
smoke check before closing the release work item.
|
|
37
|
-
|
|
38
|
-
## Deployment boundary
|
|
39
|
-
|
|
40
|
-
The LifeAI profile installation is the development delivery for this library.
|
|
41
|
-
Application production promotion remains separately approval-gated through
|
|
42
|
-
`rdc:deploy promote`; this package runbook never promotes an application.
|
|
@@ -1,49 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
import assert from 'node:assert/strict';
|
|
3
|
-
import { readFileSync } from 'node:fs';
|
|
4
|
-
import { dirname, join, resolve } from 'node:path';
|
|
5
|
-
import { fileURLToPath } from 'node:url';
|
|
6
|
-
|
|
7
|
-
const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
|
|
8
|
-
const skill = readFileSync(join(root, 'skills', 'housekeeping', 'SKILL.md'), 'utf8');
|
|
9
|
-
const guide = readFileSync(join(root, 'guides', 'lessons-learned-spec.md'), 'utf8');
|
|
10
|
-
|
|
11
|
-
function mustAppearInOrder(text, fragments, name) {
|
|
12
|
-
let previous = -1;
|
|
13
|
-
for (const fragment of fragments) {
|
|
14
|
-
const index = text.indexOf(fragment);
|
|
15
|
-
assert.notEqual(index, -1, `${name} is missing: ${fragment}`);
|
|
16
|
-
assert.ok(index > previous, `${name} orders ${fragment} before its required predecessor`);
|
|
17
|
-
previous = index;
|
|
18
|
-
}
|
|
19
|
-
}
|
|
20
|
-
|
|
21
|
-
assert.match(skill, /lesson_status: open/, 'housekeeping must read the current lesson status field');
|
|
22
|
-
assert.doesNotMatch(skill, /(?:set|mark) `status: (?:open|triaged|applied|wont-fix)/, 'housekeeping must use lesson_status for triage outcomes');
|
|
23
|
-
assert.match(skill, /do not create new work/i, 'the audit must prevent duplicate work');
|
|
24
|
-
assert.doesNotMatch(skill, /scope: simple.*apply the fix directly/s, 'simple lessons cannot bypass RDC routing');
|
|
25
|
-
mustAppearInOrder(skill, [
|
|
26
|
-
'### 1. Cluster',
|
|
27
|
-
'### 2. Resolution audit',
|
|
28
|
-
'### 3. Architectural report and interview gate',
|
|
29
|
-
'### 4. Route only still-open, approved work through RDC',
|
|
30
|
-
'### 5. Complete weekly lessons report',
|
|
31
|
-
], 'housekeeping workflow');
|
|
32
|
-
assert.match(skill, /complete work item/, 'routed work must have a complete work item');
|
|
33
|
-
assert.match(skill, /rdc:fixit/, 'housekeeping must route small work through fixit');
|
|
34
|
-
assert.match(skill, /rdc:fixit` creates and completes the sole work item/, 'fixit must own its single work item');
|
|
35
|
-
assert.match(skill, /rdc:plan` followed by `rdc:build/, 'housekeeping must route larger work through build');
|
|
36
|
-
assert.match(skill, /rdc:review/, 'each lesson action batch must be reviewed');
|
|
37
|
-
assert.match(skill, /dev deployment/, 'deployable work must record dev deployment evidence');
|
|
38
|
-
assert.match(skill, /question-and-answer list/, 'the weekly report must preserve architectural interview answers');
|
|
39
|
-
|
|
40
|
-
assert.match(guide, /lesson_status: open \| triaged \| applied \| wont-fix/, 'guide schema must match housekeeping');
|
|
41
|
-
mustAppearInOrder(guide, [
|
|
42
|
-
'Resolution audit before routing',
|
|
43
|
-
'Architectural report and interview',
|
|
44
|
-
'RDC routing',
|
|
45
|
-
'Run `rdc:review`',
|
|
46
|
-
], 'shared lessons guide');
|
|
47
|
-
assert.match(guide, /Do not create an `rdc:fixit`, `rdc:plan`, or `rdc:build` item before this audit/, 'guide must block premature routing');
|
|
48
|
-
|
|
49
|
-
console.log('housekeeping weekly lessons triage contract - PASS');
|
|
@@ -1,26 +0,0 @@
|
|
|
1
|
-
import assert from 'node:assert/strict';
|
|
2
|
-
import { readFileSync } from 'node:fs';
|
|
3
|
-
import { join } from 'node:path';
|
|
4
|
-
import { fileURLToPath } from 'node:url';
|
|
5
|
-
|
|
6
|
-
const root = join(fileURLToPath(new URL('..', import.meta.url)));
|
|
7
|
-
const captureSkills = ['build', 'deploy', 'overnight', 'fixit', 'plan', 'preplan', 'review', 'release', 'collab'];
|
|
8
|
-
|
|
9
|
-
for (const skill of captureSkills) {
|
|
10
|
-
const text = readFileSync(join(root, 'skills', skill, 'SKILL.md'), 'utf8');
|
|
11
|
-
assert.match(text, /lesson_status: open/, `${skill} must capture the canonical status key`);
|
|
12
|
-
assert.doesNotMatch(text, /and `status` \(`open`/, `${skill} must not emit the legacy status key`);
|
|
13
|
-
}
|
|
14
|
-
|
|
15
|
-
const guide = readFileSync(join(root, 'guides', 'lessons-learned-spec.md'), 'utf8');
|
|
16
|
-
assert.match(guide, /Legacy status migration/);
|
|
17
|
-
assert.match(guide, /`status` and no `lesson_status`/);
|
|
18
|
-
|
|
19
|
-
const housekeeping = readFileSync(join(root, 'skills', 'housekeeping', 'SKILL.md'), 'utf8');
|
|
20
|
-
assert.match(housekeeping, /When invoked with `--lessons`, skip every non-lessons maintenance section/);
|
|
21
|
-
assert.match(housekeeping, /including Directory Structure Verification/);
|
|
22
|
-
const legacyNormalization = housekeeping.indexOf('normalize every legacy lesson that has `status` but no `lesson_status`');
|
|
23
|
-
const openFilter = housekeeping.indexOf('Then read all `.rdc/lessons/*.md` with `lesson_status: open`');
|
|
24
|
-
assert.ok(legacyNormalization >= 0 && openFilter > legacyNormalization, 'legacy lessons must be normalized before the open-status filter');
|
|
25
|
-
|
|
26
|
-
console.log('lessons pipeline contract test passed');
|
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
import assert from 'node:assert/strict';
|
|
2
|
-
import { readFileSync } from 'node:fs';
|
|
3
|
-
import { join } from 'node:path';
|
|
4
|
-
import { fileURLToPath } from 'node:url';
|
|
5
|
-
|
|
6
|
-
const root = join(fileURLToPath(new URL('..', import.meta.url)));
|
|
7
|
-
const release = readFileSync(join(root, 'RELEASE.md'), 'utf8');
|
|
8
|
-
|
|
9
|
-
assert.match(release, /npm version patch --no-git-tag-version/);
|
|
10
|
-
assert.match(release, /npm view @lifeaitools\/rdc-skills@<version> version/);
|
|
11
|
-
assert.match(release, /npm pack @lifeaitools\/rdc-skills@<version>/);
|
|
12
|
-
assert.match(release, /npm install -g @lifeaitools\/rdc-skills@<version>/);
|
|
13
|
-
assert.match(release, /rdc-skills-install --profile core/);
|
|
14
|
-
assert.match(release, /rdc-skills-install --profile lifeai/);
|
|
15
|
-
|
|
16
|
-
console.log('release contract test passed');
|