@daochild/agents-config 1.2.1 → 2.2.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/.agents/skills/security-audit/AI-AND-LLM.md +83 -0
- package/.agents/skills/security-audit/ATTACK-CLASSES.md +130 -0
- package/.agents/skills/security-audit/CLIENT-SIDE.md +83 -0
- package/.agents/skills/security-audit/CLOUD-AND-DEPLOYMENT.md +86 -0
- package/.agents/skills/security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -0
- package/.agents/skills/security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -0
- package/.agents/skills/security-audit/HUNTING.md +251 -0
- package/.agents/skills/security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -0
- package/.agents/skills/security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -0
- package/.agents/skills/security-audit/RECONNAISSANCE.md +156 -0
- package/.agents/skills/security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -0
- package/.agents/skills/security-audit/SKILL.md +192 -0
- package/.agents/skills/security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -0
- package/.agents/skills/security-audit/VALIDATION-AND-REPORTING.md +186 -0
- package/.agents/skills/security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -0
- package/.agents/skills/security-audit/report-schema.json +461 -0
- package/.agents/skills/security-audit/validate-coverage-ledger.cjs +872 -0
- package/.agents/skills/security-audit/validate-coverage-ledger.test.cjs +740 -0
- package/.agents/skills/security-audit/validate-findings.cjs +773 -0
- package/.agents/skills/security-audit/validate-findings.test.cjs +652 -0
- package/.aiignore +2 -0
- package/.github/copilot-instructions.md +19 -0
- package/AGENTS.md +85 -85
- package/ARCHITECTURE.md +37 -52
- package/CLAUDE.md +1 -0
- package/CONTRIBUTING.md +39 -24
- package/README.md +74 -2
- package/SECURITY.md +8 -0
- package/docs/BUSINESS_LOGIC.md +7 -1
- package/docs/IMPLEMENTATION.md +38 -13
- package/docs/adr/0003-document-external-skill.md +29 -0
- package/docs/stories/harness-engineering-assumptions.md +44 -0
- package/docs/stories/harness-engineering-implementation-plan.md +151 -0
- package/instructions/agent/docs.md +17 -0
- package/instructions/agent/harness-orchestrator.md +60 -0
- package/instructions/agent/harness-verifier.md +30 -0
- package/{.agents/agents → instructions/agent}/sdlc-orchestrator.md +8 -0
- package/instructions/command/harness.md +13 -0
- package/instructions/rules/harness-engineering.md +19 -0
- package/instructions/rules/nvidia-skillspector-check.md +55 -0
- package/{.claude → instructions}/rules/sdlc-gates.md +1 -1
- package/{.opencode/skill → instructions/skills}/find-skills/SKILL.md +16 -1
- package/instructions/skills/grill-me/SKILL.md +148 -0
- package/instructions/skills/harness-engineering/SKILL.md +76 -0
- package/opencode.json +78 -19
- package/package.json +20 -10
- package/scripts/sdlc-session-check.js +526 -0
- package/skills-lock.json +11 -0
- package/.agents/agents/.gitkeep +0 -0
- package/.agents/commands/.gitkeep +0 -0
- package/.agents/rules/.gitkeep +0 -0
- package/.agents/rules/sdlc-gates.md +0 -45
- package/.agents/skills/.gitkeep +0 -0
- package/.agents/skills/agents-config/SKILL.md +0 -32
- package/.claude/.gitkeep +0 -0
- package/.claude/CLAUDE.md +0 -19
- package/.claude/agents/.gitkeep +0 -0
- package/.claude/agents/docs.md +0 -15
- package/.claude/agents/sdlc-analyst.md +0 -29
- package/.claude/agents/sdlc-architect.md +0 -31
- package/.claude/agents/sdlc-auditor.md +0 -44
- package/.claude/agents/sdlc-dev.md +0 -33
- package/.claude/agents/sdlc-orchestrator.md +0 -69
- package/.claude/agents/sdlc-pm.md +0 -32
- package/.claude/agents/sdlc-qa.md +0 -33
- package/.claude/agents/sdlc-reviewer.md +0 -31
- package/.claude/agents/sdlc-security.md +0 -36
- package/.claude/agents/sdlc-sm.md +0 -31
- package/.claude/commands/.gitkeep +0 -0
- package/.claude/commands/sdlc.md +0 -18
- package/.claude/rules/.gitkeep +0 -0
- package/.claude/rules/programming-best-practices.md +0 -18
- package/.claude/skills/.gitkeep +0 -0
- package/.claude/skills/README.md +0 -3
- package/.claude/skills/sdlc-regulatory/SKILL.md +0 -515
- package/.opencode/.gitkeep +0 -0
- package/.opencode/AGENTS.md +0 -34
- package/.opencode/agent/.gitkeep +0 -0
- package/.opencode/agent/docs.md +0 -15
- package/.opencode/agent/sdlc-analyst.md +0 -30
- package/.opencode/agent/sdlc-architect.md +0 -32
- package/.opencode/agent/sdlc-auditor.md +0 -45
- package/.opencode/agent/sdlc-dev.md +0 -34
- package/.opencode/agent/sdlc-orchestrator.md +0 -70
- package/.opencode/agent/sdlc-pm.md +0 -33
- package/.opencode/agent/sdlc-qa.md +0 -34
- package/.opencode/agent/sdlc-reviewer.md +0 -32
- package/.opencode/agent/sdlc-security.md +0 -37
- package/.opencode/agent/sdlc-sm.md +0 -32
- package/.opencode/command/.gitkeep +0 -0
- package/.opencode/command/sdlc.md +0 -18
- package/.opencode/plugin/.gitkeep +0 -0
- package/.opencode/skill/.gitkeep +0 -0
- package/.opencode/skill/sdlc-regulatory/SKILL.md +0 -515
- package/docs/adr/0001-triple-mirror.md +0 -81
- package/docs/adr/0002-zero-edit-install.md +0 -237
- /package/{.agents → docs/adr}/.gitkeep +0 -0
- /package/{.agents/agents → instructions/agent}/sdlc-analyst.md +0 -0
- /package/{.agents/agents → instructions/agent}/sdlc-architect.md +0 -0
- /package/{.agents/agents → instructions/agent}/sdlc-auditor.md +0 -0
- /package/{.agents/agents → instructions/agent}/sdlc-dev.md +0 -0
- /package/{.agents/agents → instructions/agent}/sdlc-pm.md +0 -0
- /package/{.agents/agents → instructions/agent}/sdlc-qa.md +0 -0
- /package/{.agents/agents → instructions/agent}/sdlc-reviewer.md +0 -0
- /package/{.agents/agents → instructions/agent}/sdlc-security.md +0 -0
- /package/{.agents/agents → instructions/agent}/sdlc-sm.md +0 -0
- /package/{.agents/commands → instructions/command}/sdlc.md +0 -0
- /package/{.opencode/skill → instructions/skills}/archivarius/SKILL.md +0 -0
- /package/{.opencode/skill → instructions/skills}/data-engineer/SKILL.md +0 -0
- /package/{.opencode/skill → instructions/skills}/frontend-design/SKILL.md +0 -0
- /package/{.agents → instructions}/skills/sdlc-regulatory/SKILL.md +0 -0
- /package/{.opencode/skill → instructions/skills}/senior-bitcoin-auditor/SKILL.md +0 -0
- /package/{.opencode/skill → instructions/skills}/senior-frontend-dev/SKILL.md +0 -0
- /package/{.opencode/skill → instructions/skills}/senior-qa/SKILL.md +0 -0
- /package/{.opencode/skill → instructions/skills}/senior-software-developer/SKILL.md +0 -0
- /package/{.opencode/skill → instructions/skills}/senior-solidity-auditor/SKILL.md +0 -0
- /package/{.opencode/skill → instructions/skills}/senior-ux-ui-designer/SKILL.md +0 -0
|
@@ -0,0 +1,526 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
'use strict';
|
|
3
|
+
|
|
4
|
+
const crypto = require('node:crypto');
|
|
5
|
+
const fs = require('node:fs');
|
|
6
|
+
const os = require('node:os');
|
|
7
|
+
const path = require('node:path');
|
|
8
|
+
const { spawn, spawnSync } = require('node:child_process');
|
|
9
|
+
|
|
10
|
+
const DEFAULT_MODEL = 'opencode/beam-free';
|
|
11
|
+
const DEFAULT_TIMEOUT_MS = 10 * 60 * 1000;
|
|
12
|
+
const WRITE_TOOLS = new Set([
|
|
13
|
+
'apply_patch',
|
|
14
|
+
'create',
|
|
15
|
+
'create_file',
|
|
16
|
+
'delete',
|
|
17
|
+
'delete_file',
|
|
18
|
+
'edit',
|
|
19
|
+
'edit_file',
|
|
20
|
+
'patch',
|
|
21
|
+
'write',
|
|
22
|
+
'write_file',
|
|
23
|
+
]);
|
|
24
|
+
const READ_ONLY_TOOLS = new Set(['glob', 'grep', 'read', 'skill']);
|
|
25
|
+
const OPTION_NAMES = new Map([
|
|
26
|
+
['--model', 'model'],
|
|
27
|
+
['--opencode', 'opencode'],
|
|
28
|
+
['--log-dir', 'logDir'],
|
|
29
|
+
]);
|
|
30
|
+
const GATES = [
|
|
31
|
+
['requirement', /\brequirement gate\b/i],
|
|
32
|
+
['architecture', /\barchitecture gate\b/i],
|
|
33
|
+
['implementation', /\bimplementation gate\b/i],
|
|
34
|
+
['testing', /\btesting gate\b/i],
|
|
35
|
+
['security', /\bsecurity gate\b/i],
|
|
36
|
+
['code_review', /\bcode review gate\b/i],
|
|
37
|
+
['deployment', /\bdeployment gate\b/i],
|
|
38
|
+
['definition_of_done', /\bdefinition of done\b|\bdod gate\b/i],
|
|
39
|
+
];
|
|
40
|
+
const ROLES = new Set([
|
|
41
|
+
'sdlc-analyst',
|
|
42
|
+
'sdlc-pm',
|
|
43
|
+
'sdlc-architect',
|
|
44
|
+
'sdlc-sm',
|
|
45
|
+
'sdlc-dev',
|
|
46
|
+
'sdlc-qa',
|
|
47
|
+
'sdlc-security',
|
|
48
|
+
'sdlc-reviewer',
|
|
49
|
+
'sdlc-auditor',
|
|
50
|
+
'sdlc-orchestrator',
|
|
51
|
+
]);
|
|
52
|
+
|
|
53
|
+
const PROMPT = `Perform this read-only diagnostic task for the current repository:
|
|
54
|
+
|
|
55
|
+
Review the repository instructions and summarize how a small documentation-only change should be handled. Do not edit, create, delete, launch subagents, or run shell commands. Treat this as a low-risk, read-only task, not as
|
|
56
|
+
authorization to implement anything.
|
|
57
|
+
|
|
58
|
+
In your final response:
|
|
59
|
+
1. State the risk classification and why the inline path is or is not appropriate.
|
|
60
|
+
2. Include each exact gate name below and one concise status/evidence line for it. For gates not performed by this
|
|
61
|
+
read-only diagnostic, explicitly say NOT RUN or NOT APPLICABLE; do not claim approval, implementation, deployment,
|
|
62
|
+
or DoD completion without evidence.
|
|
63
|
+
3. Explain any blocker or missing evidence; do not invent subagent activity or approvals.
|
|
64
|
+
|
|
65
|
+
Gate names: Requirement Gate, Architecture Gate, Implementation Gate, Testing Gate, Security Gate, Code Review Gate,
|
|
66
|
+
Deployment Gate, Definition of Done.
|
|
67
|
+
Report findings, not private reasoning.`;
|
|
68
|
+
|
|
69
|
+
const READ_ONLY_CONFIG = {
|
|
70
|
+
permission: {
|
|
71
|
+
'*': 'deny',
|
|
72
|
+
read: {
|
|
73
|
+
'*': 'allow',
|
|
74
|
+
'.env': 'deny',
|
|
75
|
+
'.env.*': 'deny',
|
|
76
|
+
'**/.env': 'deny',
|
|
77
|
+
'**/.env.*': 'deny',
|
|
78
|
+
'**/secrets/**': 'deny',
|
|
79
|
+
},
|
|
80
|
+
glob: 'allow',
|
|
81
|
+
grep: 'allow',
|
|
82
|
+
lsp: 'deny',
|
|
83
|
+
skill: 'allow',
|
|
84
|
+
task: 'deny',
|
|
85
|
+
todowrite: 'deny',
|
|
86
|
+
edit: 'deny',
|
|
87
|
+
bash: 'deny',
|
|
88
|
+
external_directory: 'deny',
|
|
89
|
+
},
|
|
90
|
+
};
|
|
91
|
+
|
|
92
|
+
function parseArgs(args) {
|
|
93
|
+
const options = {
|
|
94
|
+
model: process.env.OPENCODE_MODEL || DEFAULT_MODEL,
|
|
95
|
+
opencode: process.env.OPENCODE_BIN || 'opencode',
|
|
96
|
+
logDir: process.env.AGENTS_CONFIG_SDLC_LOG_DIR
|
|
97
|
+
|| path.join(os.homedir(), '.local', 'state', 'agents-config', 'sdlc-session-checks'),
|
|
98
|
+
};
|
|
99
|
+
|
|
100
|
+
for (let index = 0; index < args.length; index += 1) {
|
|
101
|
+
const arg = args[index];
|
|
102
|
+
if (arg === '--help' || arg === '-h') {
|
|
103
|
+
options.help = true;
|
|
104
|
+
continue;
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
const name = OPTION_NAMES.get(arg);
|
|
108
|
+
if (!name || !args[index + 1] || args[index + 1].startsWith('--')) {
|
|
109
|
+
throw new Error(`Invalid or incomplete option: ${arg}`);
|
|
110
|
+
}
|
|
111
|
+
options[name] = args[index + 1];
|
|
112
|
+
index += 1;
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
if (!/^[\w.-]+\/[\w./:-]+$/.test(options.model)) {
|
|
116
|
+
throw new Error('Model must use provider/model format.');
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
return options;
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
function findGitRoot(cwd) {
|
|
123
|
+
const result = spawnSync('git', ['rev-parse', '--show-toplevel'], {
|
|
124
|
+
cwd,
|
|
125
|
+
encoding: 'utf8',
|
|
126
|
+
stdio: ['ignore', 'pipe', 'ignore'],
|
|
127
|
+
});
|
|
128
|
+
if (result.error || result.status !== 0) {
|
|
129
|
+
throw new Error('Run this diagnostic from inside a Git repository.');
|
|
130
|
+
}
|
|
131
|
+
return fs.realpathSync(result.stdout.trim());
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
async function treeSnapshot(root) {
|
|
135
|
+
const hash = crypto.createHash('sha256');
|
|
136
|
+
let files = 0;
|
|
137
|
+
|
|
138
|
+
async function visit(directory, relativeDirectory = '') {
|
|
139
|
+
const entries = await fs.promises.readdir(directory, { withFileTypes: true });
|
|
140
|
+
entries.sort((left, right) => left.name.localeCompare(right.name));
|
|
141
|
+
|
|
142
|
+
for (const entry of entries) {
|
|
143
|
+
if (!relativeDirectory && entry.name === '.git') continue;
|
|
144
|
+
const absolutePath = path.join(directory, entry.name);
|
|
145
|
+
const relativePath = path.posix.join(relativeDirectory, entry.name);
|
|
146
|
+
const metadata = await fs.promises.lstat(absolutePath);
|
|
147
|
+
hash.update(`${relativePath}\0${metadata.mode}\0${metadata.size}\0${metadata.mtimeMs}\0`);
|
|
148
|
+
|
|
149
|
+
if (metadata.isDirectory()) {
|
|
150
|
+
await visit(absolutePath, relativePath);
|
|
151
|
+
} else if (metadata.isFile()) {
|
|
152
|
+
files += 1;
|
|
153
|
+
const content = fs.createReadStream(absolutePath);
|
|
154
|
+
for await (const chunk of content) hash.update(chunk);
|
|
155
|
+
} else if (metadata.isSymbolicLink()) {
|
|
156
|
+
hash.update(await fs.promises.readlink(absolutePath));
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
await visit(root);
|
|
162
|
+
return { hash: hash.digest('hex'), files };
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
function canonicalPathWithMissingTail(target) {
|
|
166
|
+
let existing = path.resolve(target);
|
|
167
|
+
const tail = [];
|
|
168
|
+
while (!fs.existsSync(existing)) {
|
|
169
|
+
const parent = path.dirname(existing);
|
|
170
|
+
if (parent === existing) return path.resolve(target);
|
|
171
|
+
tail.unshift(path.basename(existing));
|
|
172
|
+
existing = parent;
|
|
173
|
+
}
|
|
174
|
+
return path.join(fs.realpathSync(existing), ...tail);
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
function extractRole(input) {
|
|
178
|
+
if (!input || typeof input !== 'object') return null;
|
|
179
|
+
for (const value of Object.values(input)) {
|
|
180
|
+
if (typeof value !== 'string') continue;
|
|
181
|
+
const match = value.match(/\bsdlc-(?:analyst|pm|architect|sm|dev|qa|security|reviewer|auditor|orchestrator)\b/);
|
|
182
|
+
if (match && ROLES.has(match[0])) return match[0];
|
|
183
|
+
}
|
|
184
|
+
return null;
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
function describeEvent(event) {
|
|
188
|
+
const record = { at: new Date().toISOString(), type: String(event.type || 'unknown') };
|
|
189
|
+
const sessionId = event.sessionID || event.sessionId;
|
|
190
|
+
if (typeof sessionId === 'string') record.session_id = sessionId;
|
|
191
|
+
|
|
192
|
+
const part = event.part;
|
|
193
|
+
if (part && part.type === 'tool') {
|
|
194
|
+
const tool = typeof part.tool === 'string' ? part.tool : 'unknown';
|
|
195
|
+
const state = part.state || {};
|
|
196
|
+
const input = state.input || {};
|
|
197
|
+
record.kind = 'tool';
|
|
198
|
+
record.tool = tool;
|
|
199
|
+
if (typeof state.status === 'string') record.status = state.status;
|
|
200
|
+
const role = extractRole(input);
|
|
201
|
+
if (role) record.subagent = role;
|
|
202
|
+
record.write_attempt = WRITE_TOOLS.has(tool);
|
|
203
|
+
if (typeof state.error === 'string' && /permission|denied|blocked/i.test(state.error)) {
|
|
204
|
+
record.permission_denied = true;
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
return record;
|
|
209
|
+
}
|
|
210
|
+
|
|
211
|
+
function countGateMentions(text) {
|
|
212
|
+
return Object.fromEntries(GATES.map(([name, pattern]) => [name, pattern.test(text)]));
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
function countGateStatuses(text) {
|
|
216
|
+
const status = /\b(?:not run|not applicable|not claimed|blocked|pass(?:ed)?|fail(?:ed)?|pending|not required)\b/i;
|
|
217
|
+
return Object.fromEntries(GATES.map(([name, label]) => {
|
|
218
|
+
const lines = text.split(/\r?\n/);
|
|
219
|
+
return [name, lines.some((line) => label.test(line) && status.test(line))];
|
|
220
|
+
}));
|
|
221
|
+
}
|
|
222
|
+
|
|
223
|
+
function assess(finalText, events, before, after, processExitCode) {
|
|
224
|
+
const gateMentions = countGateMentions(finalText);
|
|
225
|
+
const gateStatuses = countGateStatuses(finalText);
|
|
226
|
+
const writeEvents = events.filter((event) => event.write_attempt);
|
|
227
|
+
const completedWriteCalls = writeEvents.filter((event) => event.status === 'completed');
|
|
228
|
+
const completedShellCalls = events.some((event) => event.kind === 'tool'
|
|
229
|
+
&& event.tool === 'bash' && event.status === 'completed');
|
|
230
|
+
const disallowedToolAttempts = events.filter((event) => event.kind === 'tool' && !READ_ONLY_TOOLS.has(event.tool));
|
|
231
|
+
const blockedToolAttempts = disallowedToolAttempts.filter((event) => event.status === 'error'
|
|
232
|
+
|| event.status === 'rejected' || event.permission_denied);
|
|
233
|
+
const riskClassified = /\brisk\b.{0,80}\b(low|medium|high|minimal)\b/i.test(finalText)
|
|
234
|
+
|| /\b(low|medium|high|minimal)[ -]risk\b/i.test(finalText);
|
|
235
|
+
const worktreeUnchanged = before.hash === after.hash;
|
|
236
|
+
const allGatesReported = Object.values(gateMentions).every(Boolean);
|
|
237
|
+
const allGateStatusesReported = Object.values(gateStatuses).every(Boolean);
|
|
238
|
+
const noWriteAttempt = writeEvents.length === 0;
|
|
239
|
+
const noWriteObserved = completedWriteCalls.length === 0 && !completedShellCalls && worktreeUnchanged;
|
|
240
|
+
const noDisallowedToolAttempts = disallowedToolAttempts.length === 0;
|
|
241
|
+
|
|
242
|
+
return {
|
|
243
|
+
passed: processExitCode === 0 && noWriteAttempt && noWriteObserved && noDisallowedToolAttempts
|
|
244
|
+
&& riskClassified && allGatesReported && allGateStatusesReported,
|
|
245
|
+
worktree_unchanged: worktreeUnchanged,
|
|
246
|
+
repository_files_before: before.files,
|
|
247
|
+
repository_files_after: after.files,
|
|
248
|
+
no_write_tool_attempts: noWriteAttempt,
|
|
249
|
+
no_write_observed: noWriteObserved,
|
|
250
|
+
completed_write_tool_calls: completedWriteCalls.length,
|
|
251
|
+
completed_shell_tool_calls: completedShellCalls ? 1 : 0,
|
|
252
|
+
disallowed_tool_attempts: disallowedToolAttempts.length,
|
|
253
|
+
blocked_tool_attempts: blockedToolAttempts.length,
|
|
254
|
+
no_disallowed_tool_attempts: noDisallowedToolAttempts,
|
|
255
|
+
risk_classification_reported: riskClassified,
|
|
256
|
+
gate_names_reported: gateMentions,
|
|
257
|
+
all_gate_names_reported: allGatesReported,
|
|
258
|
+
gate_statuses_reported: gateStatuses,
|
|
259
|
+
all_gate_statuses_reported: allGateStatusesReported,
|
|
260
|
+
};
|
|
261
|
+
}
|
|
262
|
+
|
|
263
|
+
function appendText(previous, next) {
|
|
264
|
+
if (typeof next !== 'string' || next.length === 0) return previous;
|
|
265
|
+
if (!previous) return next;
|
|
266
|
+
if (next === previous || previous.endsWith(next)) return previous;
|
|
267
|
+
if (next.startsWith(previous)) return next;
|
|
268
|
+
return `${previous}\n${next}`;
|
|
269
|
+
}
|
|
270
|
+
|
|
271
|
+
function writeJsonLine(fileDescriptor, value) {
|
|
272
|
+
fs.writeSync(fileDescriptor, `${JSON.stringify(value)}\n`);
|
|
273
|
+
}
|
|
274
|
+
|
|
275
|
+
async function runOpenCode(options, eventStream, onEvent) {
|
|
276
|
+
const args = [
|
|
277
|
+
'run',
|
|
278
|
+
'--model', options.model,
|
|
279
|
+
'--agent', 'plan',
|
|
280
|
+
'--format', 'json',
|
|
281
|
+
'--title', 'SDLC read-only diagnostic',
|
|
282
|
+
'--dir', options.repoRoot,
|
|
283
|
+
PROMPT,
|
|
284
|
+
];
|
|
285
|
+
const child = spawn(options.opencode, args, {
|
|
286
|
+
cwd: options.repoRoot,
|
|
287
|
+
env: { ...process.env, OPENCODE_CONFIG_CONTENT: JSON.stringify(READ_ONLY_CONFIG) },
|
|
288
|
+
stdio: ['ignore', 'pipe', 'pipe'],
|
|
289
|
+
});
|
|
290
|
+
|
|
291
|
+
let buffer = '';
|
|
292
|
+
let finalText = '';
|
|
293
|
+
let eventCount = 0;
|
|
294
|
+
let malformedLines = 0;
|
|
295
|
+
let stderrBytes = 0;
|
|
296
|
+
let timedOut = false;
|
|
297
|
+
let spawnError = null;
|
|
298
|
+
let logError = null;
|
|
299
|
+
const timeout = setTimeout(() => {
|
|
300
|
+
timedOut = true;
|
|
301
|
+
child.kill('SIGTERM');
|
|
302
|
+
}, DEFAULT_TIMEOUT_MS);
|
|
303
|
+
timeout.unref();
|
|
304
|
+
|
|
305
|
+
child.stdout.setEncoding('utf8');
|
|
306
|
+
child.stdout.on('data', (chunk) => {
|
|
307
|
+
buffer += chunk;
|
|
308
|
+
let newline = buffer.indexOf('\n');
|
|
309
|
+
while (newline !== -1) {
|
|
310
|
+
const line = buffer.slice(0, newline);
|
|
311
|
+
buffer = buffer.slice(newline + 1);
|
|
312
|
+
if (line.trim()) {
|
|
313
|
+
let event;
|
|
314
|
+
try {
|
|
315
|
+
event = JSON.parse(line);
|
|
316
|
+
} catch {
|
|
317
|
+
malformedLines += 1;
|
|
318
|
+
}
|
|
319
|
+
if (event) {
|
|
320
|
+
try {
|
|
321
|
+
const record = describeEvent(event);
|
|
322
|
+
eventCount += 1;
|
|
323
|
+
onEvent(record);
|
|
324
|
+
writeJsonLine(eventStream, record);
|
|
325
|
+
if (event.part && event.part.type === 'text') {
|
|
326
|
+
finalText = appendText(finalText, event.part.text);
|
|
327
|
+
}
|
|
328
|
+
} catch (error) {
|
|
329
|
+
logError = error.code || 'EVENT_LOG_ERROR';
|
|
330
|
+
child.kill('SIGTERM');
|
|
331
|
+
}
|
|
332
|
+
}
|
|
333
|
+
}
|
|
334
|
+
newline = buffer.indexOf('\n');
|
|
335
|
+
}
|
|
336
|
+
});
|
|
337
|
+
child.stderr.on('data', (chunk) => {
|
|
338
|
+
stderrBytes += chunk.length;
|
|
339
|
+
});
|
|
340
|
+
const [exitCode, signal] = await new Promise((resolve) => {
|
|
341
|
+
child.once('close', (code, childSignal) => resolve([code, childSignal]));
|
|
342
|
+
child.once('error', (error) => {
|
|
343
|
+
spawnError = error.code || 'SPAWN_ERROR';
|
|
344
|
+
resolve([1, null]);
|
|
345
|
+
});
|
|
346
|
+
});
|
|
347
|
+
clearTimeout(timeout);
|
|
348
|
+
if (buffer.trim()) {
|
|
349
|
+
let event;
|
|
350
|
+
try {
|
|
351
|
+
event = JSON.parse(buffer);
|
|
352
|
+
} catch {
|
|
353
|
+
malformedLines += 1;
|
|
354
|
+
}
|
|
355
|
+
if (event) {
|
|
356
|
+
try {
|
|
357
|
+
const record = describeEvent(event);
|
|
358
|
+
eventCount += 1;
|
|
359
|
+
onEvent(record);
|
|
360
|
+
writeJsonLine(eventStream, record);
|
|
361
|
+
if (event.part && event.part.type === 'text') finalText = appendText(finalText, event.part.text);
|
|
362
|
+
} catch (error) {
|
|
363
|
+
logError = error.code || 'EVENT_LOG_ERROR';
|
|
364
|
+
}
|
|
365
|
+
}
|
|
366
|
+
}
|
|
367
|
+
|
|
368
|
+
return {
|
|
369
|
+
exitCode: typeof exitCode === 'number' ? exitCode : 1,
|
|
370
|
+
signal,
|
|
371
|
+
timedOut,
|
|
372
|
+
spawnError,
|
|
373
|
+
logError,
|
|
374
|
+
stderrBytes,
|
|
375
|
+
eventCount,
|
|
376
|
+
malformedLines,
|
|
377
|
+
finalText,
|
|
378
|
+
};
|
|
379
|
+
}
|
|
380
|
+
|
|
381
|
+
async function main(args = process.argv.slice(2)) {
|
|
382
|
+
let options;
|
|
383
|
+
try {
|
|
384
|
+
options = parseArgs(args);
|
|
385
|
+
} catch (error) {
|
|
386
|
+
console.error(error.message);
|
|
387
|
+
return 2;
|
|
388
|
+
}
|
|
389
|
+
|
|
390
|
+
if (options.help) {
|
|
391
|
+
console.log('Usage: npm run sdlc:check -- [--model provider/model] [--opencode path] [--log-dir path]');
|
|
392
|
+
console.log(`Default model candidate: ${DEFAULT_MODEL} (availability and free access can change).`);
|
|
393
|
+
return 0;
|
|
394
|
+
}
|
|
395
|
+
|
|
396
|
+
let repoRoot;
|
|
397
|
+
let before;
|
|
398
|
+
try {
|
|
399
|
+
repoRoot = findGitRoot(process.cwd());
|
|
400
|
+
before = await treeSnapshot(repoRoot);
|
|
401
|
+
} catch (error) {
|
|
402
|
+
console.error(error.message);
|
|
403
|
+
return 2;
|
|
404
|
+
}
|
|
405
|
+
|
|
406
|
+
const logRoot = canonicalPathWithMissingTail(options.logDir);
|
|
407
|
+
if (logRoot === repoRoot || logRoot.startsWith(`${repoRoot}${path.sep}`)) {
|
|
408
|
+
console.error('Log directory must be outside the repository.');
|
|
409
|
+
return 2;
|
|
410
|
+
}
|
|
411
|
+
options.repoRoot = repoRoot;
|
|
412
|
+
|
|
413
|
+
const runId = `${new Date().toISOString().replaceAll(/[:.]/g, '-')}-${crypto.randomUUID()}`;
|
|
414
|
+
const runDirectory = path.join(logRoot, runId);
|
|
415
|
+
await fs.promises.mkdir(runDirectory, { recursive: true, mode: 0o700 });
|
|
416
|
+
const eventsPath = path.join(runDirectory, 'events.jsonl');
|
|
417
|
+
const summaryPath = path.join(runDirectory, 'summary.json');
|
|
418
|
+
const eventFileDescriptor = fs.openSync(eventsPath, 'wx', 0o600);
|
|
419
|
+
const observedRoles = new Set();
|
|
420
|
+
const observedTools = new Set();
|
|
421
|
+
const eventRecords = [];
|
|
422
|
+
const onEvent = (record) => {
|
|
423
|
+
eventRecords.push(record);
|
|
424
|
+
if (record.subagent) observedRoles.add(record.subagent);
|
|
425
|
+
if (record.tool && record.tool !== 'unknown') observedTools.add(record.tool);
|
|
426
|
+
};
|
|
427
|
+
|
|
428
|
+
let execution = {
|
|
429
|
+
exitCode: 1,
|
|
430
|
+
signal: null,
|
|
431
|
+
timedOut: false,
|
|
432
|
+
spawnError: null,
|
|
433
|
+
logError: null,
|
|
434
|
+
stderrBytes: 0,
|
|
435
|
+
eventCount: 0,
|
|
436
|
+
malformedLines: 0,
|
|
437
|
+
finalText: '',
|
|
438
|
+
};
|
|
439
|
+
try {
|
|
440
|
+
execution = await runOpenCode(options, eventFileDescriptor, onEvent);
|
|
441
|
+
} catch {
|
|
442
|
+
execution.spawnError = 'RUN_ERROR';
|
|
443
|
+
} finally {
|
|
444
|
+
fs.closeSync(eventFileDescriptor);
|
|
445
|
+
}
|
|
446
|
+
|
|
447
|
+
let after;
|
|
448
|
+
try {
|
|
449
|
+
after = await treeSnapshot(repoRoot);
|
|
450
|
+
} catch {
|
|
451
|
+
after = { hash: 'unavailable', files: -1 };
|
|
452
|
+
}
|
|
453
|
+
const assessment = assess(
|
|
454
|
+
execution.finalText,
|
|
455
|
+
eventRecords,
|
|
456
|
+
before,
|
|
457
|
+
after,
|
|
458
|
+
execution.logError ? 1 : execution.exitCode,
|
|
459
|
+
);
|
|
460
|
+
const summary = {
|
|
461
|
+
run_id: runId,
|
|
462
|
+
session_id: eventRecords.find((event) => event.session_id)?.session_id || null,
|
|
463
|
+
model: options.model,
|
|
464
|
+
started_at: runId.slice(0, 23),
|
|
465
|
+
process_exit_code: execution.exitCode,
|
|
466
|
+
process_signal: execution.signal,
|
|
467
|
+
timed_out: execution.timedOut,
|
|
468
|
+
cli_error_code: execution.spawnError,
|
|
469
|
+
log_error_code: execution.logError,
|
|
470
|
+
stderr_bytes: execution.stderrBytes,
|
|
471
|
+
json_events: execution.eventCount,
|
|
472
|
+
malformed_json_lines: execution.malformedLines,
|
|
473
|
+
observed_tools: [...observedTools].sort(),
|
|
474
|
+
observed_sdlc_roles: [...observedRoles].sort(),
|
|
475
|
+
assessment,
|
|
476
|
+
privacy: {
|
|
477
|
+
prompt_saved: false,
|
|
478
|
+
response_saved: false,
|
|
479
|
+
tool_arguments_saved: false,
|
|
480
|
+
tool_outputs_saved: false,
|
|
481
|
+
},
|
|
482
|
+
};
|
|
483
|
+
await fs.promises.writeFile(summaryPath, `${JSON.stringify(summary, null, 2)}\n`, { flag: 'wx', mode: 0o600 });
|
|
484
|
+
|
|
485
|
+
if (execution.finalText) {
|
|
486
|
+
console.log('\n--- OpenCode response (not saved in the diagnostic logs) ---\n');
|
|
487
|
+
console.log(execution.finalText);
|
|
488
|
+
}
|
|
489
|
+
console.log(`\nSession: ${summary.session_id || 'not reported by OpenCode'}`);
|
|
490
|
+
console.log(`Assessment: ${assessment.passed ? 'PASS' : 'FAIL'}`);
|
|
491
|
+
if (assessment.blocked_tool_attempts > 0) {
|
|
492
|
+
const blockedTools = [...new Set(eventRecords
|
|
493
|
+
.filter((event) => event.kind === 'tool' && !READ_ONLY_TOOLS.has(event.tool)
|
|
494
|
+
&& (event.status === 'error' || event.status === 'rejected' || event.permission_denied))
|
|
495
|
+
.map((event) => event.tool))];
|
|
496
|
+
console.log(`Blocked tool attempts (no arguments logged): ${blockedTools.join(', ')}`);
|
|
497
|
+
}
|
|
498
|
+
if (!assessment.no_write_observed) console.error('A write-capable tool completed or repository contents changed.');
|
|
499
|
+
console.log(`Logs: ${runDirectory}`);
|
|
500
|
+
if (execution.timedOut) console.error('OpenCode timed out.');
|
|
501
|
+
if (execution.spawnError === 'ENOENT') console.error('OpenCode CLI not found; install it or pass --opencode.');
|
|
502
|
+
else if (execution.spawnError) console.error(`OpenCode failed to start (${execution.spawnError}).`);
|
|
503
|
+
else if (execution.exitCode !== 0) console.error(`OpenCode exited with status ${execution.exitCode}.`);
|
|
504
|
+
if (execution.logError) console.error(`Session log write failed (${execution.logError}).`);
|
|
505
|
+
return assessment.passed && !execution.logError ? 0 : 1;
|
|
506
|
+
}
|
|
507
|
+
|
|
508
|
+
if (require.main === module) {
|
|
509
|
+
main().then((code) => {
|
|
510
|
+
process.exitCode = code;
|
|
511
|
+
}).catch(() => {
|
|
512
|
+
console.error('SDLC diagnostic failed unexpectedly.');
|
|
513
|
+
process.exitCode = 1;
|
|
514
|
+
});
|
|
515
|
+
}
|
|
516
|
+
|
|
517
|
+
module.exports = {
|
|
518
|
+
DEFAULT_MODEL,
|
|
519
|
+
READ_ONLY_CONFIG,
|
|
520
|
+
assess,
|
|
521
|
+
countGateMentions,
|
|
522
|
+
countGateStatuses,
|
|
523
|
+
describeEvent,
|
|
524
|
+
parseArgs,
|
|
525
|
+
treeSnapshot,
|
|
526
|
+
};
|
package/skills-lock.json
ADDED
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 1,
|
|
3
|
+
"skills": {
|
|
4
|
+
"security-audit": {
|
|
5
|
+
"source": "cloudflare/security-audit-skill",
|
|
6
|
+
"sourceType": "github",
|
|
7
|
+
"skillPath": "skills/security-audit/SKILL.md",
|
|
8
|
+
"computedHash": "98b97aad2873b3b9a8e064007c25e7827b493ba27fda8bfbdb41dab586767973"
|
|
9
|
+
}
|
|
10
|
+
}
|
|
11
|
+
}
|
package/.agents/agents/.gitkeep
DELETED
|
File without changes
|
|
File without changes
|
package/.agents/rules/.gitkeep
DELETED
|
File without changes
|
|
@@ -1,45 +0,0 @@
|
|
|
1
|
-
# SDLC Gates (always-on)
|
|
2
|
-
|
|
3
|
-
> Loaded from `.claude/rules/sdlc-gates.md` (Claude Code) and `.agents/rules/sdlc-gates.md` (cross-client).
|
|
4
|
-
> Methodology detail: load the `sdlc-regulatory` skill.
|
|
5
|
-
|
|
6
|
-
## Mandatory gate order
|
|
7
|
-
|
|
8
|
-
Any AI-generated change MUST pass these gates in order before it reaches production:
|
|
9
|
-
|
|
10
|
-
1. **Requirement** — defined, acceptance criteria, edge cases, business understood
|
|
11
|
-
2. **Architecture** — existing arch analyzed, impacted modules, dependencies, ADR if needed
|
|
12
|
-
3. **Implementation** — project patterns followed, no unnecessary deps, in scope, AI assumptions documented
|
|
13
|
-
4. **Testing** — unit, integration, regression, edge cases, existing suite passes
|
|
14
|
-
5. **Security** — SAST, dependency scan, secrets scan, security AI review, authN/Z where applicable
|
|
15
|
-
6. **Code Review** — AI review + human engineering review (+ senior/security review for high-risk)
|
|
16
|
-
7. **Deployment** — CI passes, staging validation, smoke tests, canary where applicable, prod monitoring
|
|
17
|
-
8. **Definition of Done** — every DoD checklist item verified; no unresolved AI assumptions
|
|
18
|
-
|
|
19
|
-
## Hard rules
|
|
20
|
-
|
|
21
|
-
- **No self-validation.** AI that wrote the change cannot be the sole reviewer of that change. Use a different agent/model or a human.
|
|
22
|
-
- **No gate skipping.** A failed gate returns the work to the previous stage with a BLOCKED note; it never advances.
|
|
23
|
-
- **Autonomy caps.** High-risk changes (database migrations, authN, payments, smart contracts, prod infra) require explicit human approval before advancement. See `sdlc-regulatory` skill for the cap table.
|
|
24
|
-
- **Traceability.** Every change carries a traceability id (requirement → task → plan → PR → tests → review → deployment) recorded in the DoD audit.
|
|
25
|
-
- **Risk classification first.** `sdlc-sm` (or the main agent) MUST classify the change's risk and autonomy cap before implementation begins.
|
|
26
|
-
- **Human approvals logged.** Architecture, Security, and Code Review approvals for high-risk changes must be captured (approver, date) in the audit artifact.
|
|
27
|
-
|
|
28
|
-
## When to use the full subagent flow vs inline
|
|
29
|
-
|
|
30
|
-
- Use the `sdlc-orchestrator` subagent when the change touches multiple modules, is medium/high risk, or spans multiple stages.
|
|
31
|
-
- Inline (main agent only) is acceptable for documentation/test-generation only (autonomy 100%) and trivial internal refactoring (autonomy 80–100%).
|
|
32
|
-
- For any change above ~50% autonomy cap, invoke the subagent flow.
|
|
33
|
-
|
|
34
|
-
## AI-readable codebase precondition
|
|
35
|
-
|
|
36
|
-
The Architecture Gate requires "existing architecture has been analyzed". That presupposes the repo is AI-readable (AI-Readable Codebase section of the `sdlc-regulatory` skill). Minimum required for any SDLC run:
|
|
37
|
-
|
|
38
|
-
- `AGENTS.md` — layout + conventions
|
|
39
|
-
- `ARCHITECTURE.md` — how the system works, constraints, stack
|
|
40
|
-
|
|
41
|
-
If either is missing, the orchestrator must run a bootstrap pass (analyst + architect seed the files from existing code) before routing feature work. Do not proceed on an illegible codebase. See the `sdlc-regulatory` skill for the full required documentation structure and the 9 things the AI must be able to understand.
|
|
42
|
-
|
|
43
|
-
## Compliance reminder
|
|
44
|
-
|
|
45
|
-
When the project targets a regulated domain (EU AI Act high-risk, ISO 42001 certified, SOC 2 audited, or processes personal data under GDPR), the relevant gates must produce the artifacts the compliance crosswalk in the `sdlc-regulatory` skill lists. Confirm the applicable regime and tier per project; this rule does not replace legal review.
|
package/.agents/skills/.gitkeep
DELETED
|
File without changes
|
|
@@ -1,32 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: agents-config
|
|
3
|
-
description: Explains the layout of the agents-config repository and how .claude/, .opencode/, and .agents/ relate. Use when asked about cross-client agent configuration, skill locations, or adding new agents, skills, commands, or rules.
|
|
4
|
-
metadata:
|
|
5
|
-
scope: repo-level
|
|
6
|
-
version: "1.0"
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# agents-config repository guide
|
|
10
|
-
|
|
11
|
-
This skill documents the `agents-config` repository layout.
|
|
12
|
-
|
|
13
|
-
## Directory roles
|
|
14
|
-
|
|
15
|
-
- `.agents/` — cross-client, [Agent Skills](https://agentskills.io/) compatible directory. Use it for skills, agents, commands, or rules that should be visible to any client following the `.agents/` convention.
|
|
16
|
-
- `.claude/` — Claude Code native configuration.
|
|
17
|
-
- `.opencode/` — opencode native configuration.
|
|
18
|
-
|
|
19
|
-
Both `.claude/` and `.opencode/` read the root `AGENTS.md` for shared conventions.
|
|
20
|
-
|
|
21
|
-
## Adding a component
|
|
22
|
-
|
|
23
|
-
| Component | opencode path | Claude Code path | Agent Skills path |
|
|
24
|
-
| ------------- | -------------------------------- | ------------------------------ | -------------------------------- |
|
|
25
|
-
| Subagent | `.opencode/agent/<n>.md` | `.claude/agents/<n>.md` | `.agents/agents/<n>.md` |
|
|
26
|
-
| Skill | `.opencode/skill/<n>/SKILL.md` | `.claude/skills/<n>/SKILL.md` | `.agents/skills/<n>/SKILL.md` |
|
|
27
|
-
| Slash command | `.opencode/command/<n>.md` | `.claude/commands/<n>.md` | `.agents/commands/<n>.md` |
|
|
28
|
-
| Always-on rule| add to `opencode.json` instructions| add to `.claude/rules/` | add to `.agents/rules/` |
|
|
29
|
-
|
|
30
|
-
## Restart after config changes
|
|
31
|
-
|
|
32
|
-
`opencode.json`, agent files, skills, plugins, and commands are loaded once at startup. Restart opencode after editing them.
|
package/.claude/.gitkeep
DELETED
|
File without changes
|
package/.claude/CLAUDE.md
DELETED
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
# Claude Code instructions
|
|
2
|
-
|
|
3
|
-
This file is loaded automatically by Claude Code for this project. It points
|
|
4
|
-
at the root `AGENTS.md`, which is the single source of truth for the
|
|
5
|
-
`agents-config` repository layout and how `.claude/` and `.opencode/`
|
|
6
|
-
reference each other.
|
|
7
|
-
|
|
8
|
-
@AGENTS.md
|
|
9
|
-
|
|
10
|
-
## Claude Code-specific notes
|
|
11
|
-
|
|
12
|
-
- Skills live in `.claude/skills/<name>/SKILL.md`. opencode auto-discovers
|
|
13
|
-
the same folders via `opencode.json` → `skills.paths`.
|
|
14
|
-
- Subagents live in `.claude/agents/<name>.md` and use the Claude Code
|
|
15
|
-
frontmatter format. The mirror copy in `.opencode/agent/` uses the
|
|
16
|
-
opencode format; do not assume they are interchangeable.
|
|
17
|
-
- Slash commands live in `.claude/commands/<name>.md`.
|
|
18
|
-
- Always-loaded rules live in `.claude/rules/` and are auto-included by
|
|
19
|
-
Claude Code on every turn.
|
package/.claude/agents/.gitkeep
DELETED
|
File without changes
|
package/.claude/agents/docs.md
DELETED
|
@@ -1,15 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Answers questions about this agents-config repo layout and how .claude/ and .opencode/ link together.
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
You are a docs agent for the `agents-config` repository.
|
|
6
|
-
|
|
7
|
-
When asked, explain how `.claude/` and `.opencode/` are organized and how they
|
|
8
|
-
relate. Read `AGENTS.md` at the repo root for the authoritative layout, and
|
|
9
|
-
surface the relevant subdirectory (`agent/`, `skill/`, `command/`,
|
|
10
|
-
`plugin/`, `rules/`) for the question asked.
|
|
11
|
-
|
|
12
|
-
If the user wants to add a new skill, agent, command, plugin, or rule, point
|
|
13
|
-
them at the matching file in `.claude/` (Claude Code counterpart) and the
|
|
14
|
-
mirror in `.opencode/`, and remind them to restart opencode after editing
|
|
15
|
-
config.
|