@t275005746/gse 0.1.0 → 0.1.1
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/.github/ISSUE_TEMPLATE/bug_report.yml +42 -42
- package/.github/ISSUE_TEMPLATE/change_request.yml +50 -50
- package/.github/ISSUE_TEMPLATE/config.yml +5 -5
- package/.github/PULL_REQUEST_TEMPLATE.md +38 -38
- package/.github/workflows/validate-gse.yml +33 -33
- package/.gse/README.md +18 -18
- package/.gse/gse-development-protocol.md +50 -50
- package/.gse/project-profile.md +29 -29
- package/.gse/quality-gates.md +25 -25
- package/.gse/releases/public-registry-publication-npm.md +49 -0
- package/.gse/releases/public-release-owner-required.md +65 -65
- package/.gse/releases/public-security-contact-owner-required.md +45 -45
- package/.gse/state.json +3 -4
- package/CHANGELOG.md +24 -24
- package/CONTRIBUTING.md +64 -64
- package/LICENSE +21 -21
- package/README.md +1 -1
- package/README.zh-CN.md +1 -1
- package/SECURITY.md +41 -41
- package/SUPPORT.md +38 -38
- package/assets/marketplace/README.md +7 -7
- package/assets/marketplace/gse-listing.json +75 -75
- package/assets/templates/acceptance-execution-packet.md +73 -73
- package/assets/templates/adr.md +14 -14
- package/assets/templates/change-brief.md +16 -16
- package/assets/templates/design.md +18 -18
- package/assets/templates/dispatch-packet.md +104 -104
- package/assets/templates/evidence.md +14 -14
- package/assets/templates/execution-quality-pack.md +65 -65
- package/assets/templates/goal-map.md +21 -21
- package/assets/templates/host-adapter.md +48 -48
- package/assets/templates/host-ui-invocation-record.md +42 -42
- package/assets/templates/incident-review.md +60 -60
- package/assets/templates/public-channel-publication-record.md +49 -49
- package/assets/templates/public-ci-run-record.md +53 -53
- package/assets/templates/public-release-record.md +65 -65
- package/assets/templates/public-repository-settings-record.md +59 -59
- package/assets/templates/public-security-contact-record.md +45 -45
- package/assets/templates/release-trust-record.md +32 -32
- package/assets/templates/review.md +18 -18
- package/assets/templates/spec.md +16 -16
- package/assets/templates/target-adoption-evidence.md +29 -29
- package/assets/templates/tasks.md +17 -17
- package/assets/templates/update-release-acceptance-record.md +58 -58
- package/examples/README.md +22 -22
- package/examples/agent-runtime-host/.claude/gse-adapter.md +6 -6
- package/examples/agent-runtime-host/.codex/gse-adapter.md +7 -7
- package/examples/agent-runtime-host/.gse/goal-map.md +7 -7
- package/examples/agent-runtime-host/.gse/project-profile.md +27 -27
- package/examples/agent-runtime-host/.gse/tooling.md +5 -5
- package/examples/agent-runtime-host/.mcp.json +9 -9
- package/examples/agent-runtime-host/AGENTS.md +5 -5
- package/examples/agent-runtime-host/README.md +10 -10
- package/examples/agent-runtime-host/docs/model-routing.md +5 -5
- package/examples/cli-tool/.gse/project-profile.md +21 -21
- package/examples/cli-tool/AGENTS.md +5 -5
- package/examples/cli-tool/README.md +12 -12
- package/examples/cli-tool/package.json +21 -21
- package/examples/small-app/.env.example +2 -2
- package/examples/small-app/.github/workflows/ci.yml +8 -8
- package/examples/small-app/AGENTS.md +5 -5
- package/examples/small-app/README.md +12 -12
- package/examples/small-app/package.json +26 -26
- package/examples/small-app/playwright.config.ts +4 -4
- package/package.json +53 -53
- package/references/adoption-recipes.md +171 -171
- package/references/agent-roles.md +49 -49
- package/references/architecture-health.md +101 -101
- package/references/benchmark-audit.md +73 -73
- package/references/community-channels.md +46 -46
- package/references/compatibility.md +70 -70
- package/references/design-basis.md +38 -38
- package/references/domain-model.md +129 -129
- package/references/domain-quality-gates.md +75 -75
- package/references/drift-audit.md +81 -81
- package/references/evidence-taxonomy.md +123 -123
- package/references/file-ownership.md +107 -107
- package/references/final-readiness.md +84 -84
- package/references/forward-test.md +133 -133
- package/references/goal-map.md +36 -36
- package/references/host-adapters.md +119 -119
- package/references/learning-system.md +35 -35
- package/references/marketplace-discovery.md +46 -46
- package/references/model-routing.md +103 -103
- package/references/open-source-defaults.md +39 -39
- package/references/operating-model.md +52 -52
- package/references/packaging.md +277 -277
- package/references/project-agent-workspace.md +89 -89
- package/references/project-bootstrap.md +122 -122
- package/references/project-profile.md +57 -57
- package/references/public-release.md +174 -174
- package/references/quality-gates.md +100 -100
- package/references/recovery.md +176 -176
- package/references/release-trust.md +43 -43
- package/references/release.md +126 -126
- package/references/review.md +141 -141
- package/references/router.md +90 -90
- package/references/spec-workflow.md +66 -66
- package/references/task-levels.md +81 -81
- package/references/tool-adapters.md +73 -73
- package/scripts/audit-acceptance-execution-packet.mjs +133 -133
- package/scripts/audit-adoption-recipes.mjs +99 -99
- package/scripts/audit-change-lifecycle.mjs +77 -77
- package/scripts/audit-change-system.mjs +134 -134
- package/scripts/audit-ci-readiness.mjs +107 -107
- package/scripts/audit-close-gate.mjs +323 -323
- package/scripts/audit-command-adapters.mjs +91 -91
- package/scripts/audit-command-execution.mjs +210 -210
- package/scripts/audit-compatibility.mjs +149 -149
- package/scripts/audit-completion-readiness.mjs +292 -292
- package/scripts/audit-distribution.mjs +251 -251
- package/scripts/audit-domain-quality-gates.mjs +108 -108
- package/scripts/audit-evidence-placeholders.mjs +126 -126
- package/scripts/audit-final-readiness-promotion.mjs +255 -255
- package/scripts/audit-final-readiness.mjs +226 -226
- package/scripts/audit-fixtures.mjs +154 -154
- package/scripts/audit-fresh-session-readiness.mjs +177 -177
- package/scripts/audit-host-runtime-evidence-handoff.mjs +159 -159
- package/scripts/audit-host-runtime-invocation-drill.mjs +240 -240
- package/scripts/audit-host-runtime-invocations.mjs +254 -254
- package/scripts/audit-host-ui-invocation.mjs +132 -132
- package/scripts/audit-marketplace-discovery.mjs +122 -122
- package/scripts/audit-npm-package-metadata.mjs +155 -155
- package/scripts/audit-npm-publish-dry-run.mjs +191 -169
- package/scripts/audit-npm-tarball-install.mjs +191 -191
- package/scripts/audit-open-source-defaults.mjs +92 -92
- package/scripts/audit-open-source-readiness.mjs +97 -97
- package/scripts/audit-project.mjs +138 -138
- package/scripts/audit-public-acceptance-command-dry-run-drill.mjs +203 -203
- package/scripts/audit-public-acceptance-readiness.mjs +224 -224
- package/scripts/audit-public-channel-publication.mjs +248 -248
- package/scripts/audit-public-ci-run.mjs +184 -184
- package/scripts/audit-public-collaboration-templates.mjs +98 -98
- package/scripts/audit-public-external-gate-probe.mjs +206 -206
- package/scripts/audit-public-release-decision.mjs +201 -201
- package/scripts/audit-public-release-metadata.mjs +176 -176
- package/scripts/audit-public-repository-settings.mjs +237 -237
- package/scripts/audit-public-security-contact.mjs +171 -171
- package/scripts/audit-readme-docs.mjs +6 -4
- package/scripts/audit-recovery-readiness.mjs +98 -98
- package/scripts/audit-release-readiness.mjs +106 -106
- package/scripts/audit-release-trust.mjs +62 -62
- package/scripts/audit-remote-distribution.mjs +266 -266
- package/scripts/audit-roadmap-consistency.mjs +235 -235
- package/scripts/audit-signing.mjs +147 -147
- package/scripts/audit-state-freshness.mjs +14 -9
- package/scripts/audit-target-adoption-evidence.mjs +117 -117
- package/scripts/audit-target-project.mjs +507 -507
- package/scripts/audit-update-release-acceptance.mjs +136 -136
- package/scripts/audit-v1-target-validation.mjs +269 -269
- package/scripts/audit-validation-profiles.mjs +125 -125
- package/scripts/close-change.mjs +116 -116
- package/scripts/discover-project-profile.mjs +307 -307
- package/scripts/generate-command-adapter.mjs +231 -231
- package/scripts/generate-final-acceptance-packet.mjs +181 -181
- package/scripts/generate-final-form-progress-report.mjs +205 -205
- package/scripts/generate-host-runtime-evidence-handoff.mjs +206 -206
- package/scripts/generate-owner-external-gate-kit.mjs +295 -295
- package/scripts/generate-public-acceptance-handoff.mjs +168 -168
- package/scripts/generate-public-release-checklist.mjs +207 -207
- package/scripts/generate-release-bundle.mjs +505 -505
- package/scripts/generate-release-owner-action-plan.mjs +172 -172
- package/scripts/generate-release-status-manifest.mjs +200 -200
- package/scripts/generate-session-prompt.mjs +188 -188
- package/scripts/gse.mjs +67 -67
- package/scripts/init-change.mjs +265 -265
- package/scripts/init-project.mjs +785 -785
- package/scripts/install-gse.mjs +234 -234
- package/scripts/lib/evidence-placeholders.mjs +28 -28
- package/scripts/package-gse.mjs +174 -174
- package/scripts/probe-public-external-gates.mjs +167 -167
- package/scripts/record-host-invocation.mjs +151 -151
- package/scripts/record-public-channel-publication.mjs +178 -178
- package/scripts/record-public-ci-run.mjs +180 -180
- package/scripts/record-public-release.mjs +175 -175
- package/scripts/record-public-repository-settings.mjs +209 -209
- package/scripts/record-public-security-contact.mjs +157 -157
- package/scripts/sign-gse-package.mjs +83 -83
- package/scripts/update-project-state.mjs +223 -223
- package/scripts/verify-gse-package.mjs +85 -85
|
@@ -1,157 +1,157 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
import fs from 'node:fs'
|
|
3
|
-
import path from 'node:path'
|
|
4
|
-
import { rejectPlaceholderEvidence } from './lib/evidence-placeholders.mjs'
|
|
5
|
-
|
|
6
|
-
const args = process.argv.slice(2)
|
|
7
|
-
|
|
8
|
-
function readArg(name, fallback = '') {
|
|
9
|
-
const index = args.indexOf(name)
|
|
10
|
-
if (index === -1) return fallback
|
|
11
|
-
return args[index + 1] ?? fallback
|
|
12
|
-
}
|
|
13
|
-
|
|
14
|
-
function hasArg(name) {
|
|
15
|
-
return args.includes(name)
|
|
16
|
-
}
|
|
17
|
-
|
|
18
|
-
const root = path.resolve(readArg('--root', path.join(import.meta.dirname, '..')))
|
|
19
|
-
const contactStatus = readArg('--contact-status', 'pending')
|
|
20
|
-
const contactType = readArg('--contact-type', 'unknown')
|
|
21
|
-
const contactValue = readArg('--contact-value', '')
|
|
22
|
-
const policyPath = readArg('--policy-path', 'SECURITY.md')
|
|
23
|
-
const evidenceOwner = readArg('--evidence-owner', '')
|
|
24
|
-
const evidenceDate = readArg('--evidence-date', '')
|
|
25
|
-
const evidenceUrl = readArg('--evidence-url', '')
|
|
26
|
-
const isPublic = readArg('--is-public', 'unknown')
|
|
27
|
-
const policyUpdated = readArg('--security-policy-updated', 'unknown')
|
|
28
|
-
const privateFallback = readArg('--private-fallback-channel', 'owner private coordination channel')
|
|
29
|
-
const responseExpectation = readArg('--response-expectation', 'pending owner policy')
|
|
30
|
-
const disclosureNotes = readArg('--disclosure-notes', 'Do not publish exploit details until the public contact is owner-accepted.')
|
|
31
|
-
const verificationCommand = readArg('--verification-command', 'node scripts/audit-open-source-readiness.mjs --root . --json')
|
|
32
|
-
const verificationResult = readArg('--verification-result', 'pending')
|
|
33
|
-
const evidenceStatus = readArg('--evidence-status', contactStatus === 'accepted' ? 'accepted' : 'pending')
|
|
34
|
-
const acceptedBy = readArg('--accepted-by', '')
|
|
35
|
-
const acceptedAt = readArg('--accepted-at', '')
|
|
36
|
-
const residualRisk = readArg('--residual-risk', 'Public security contact is not accepted until owner evidence is attached.')
|
|
37
|
-
const nextAction = readArg('--next-action', 'Attach owner-approved public security contact evidence and re-run final readiness.')
|
|
38
|
-
const out = path.resolve(readArg('--out', path.join(root, '.gse', 'releases', 'public-security-contact-owner-required.md')))
|
|
39
|
-
const dryRun = hasArg('--dry-run')
|
|
40
|
-
const force = hasArg('--force')
|
|
41
|
-
const jsonOnly = hasArg('--json')
|
|
42
|
-
|
|
43
|
-
const validStatuses = new Set(['pending', 'accepted'])
|
|
44
|
-
const validContactTypes = new Set(['email', 'url', 'github-security-advisory', 'other', 'unknown'])
|
|
45
|
-
const validTriState = new Set(['true', 'false', 'unknown'])
|
|
46
|
-
const validEvidenceStatuses = new Set(['pending', 'accepted'])
|
|
47
|
-
const errors = []
|
|
48
|
-
|
|
49
|
-
function requireField(value, message) {
|
|
50
|
-
if (!String(value).trim()) errors.push(message)
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
if (!validStatuses.has(contactStatus)) errors.push('--contact-status must be pending or accepted')
|
|
54
|
-
if (!validContactTypes.has(contactType)) errors.push('--contact-type must be email, url, github-security-advisory, other, or unknown')
|
|
55
|
-
if (!validTriState.has(isPublic)) errors.push('--is-public must be true, false, or unknown')
|
|
56
|
-
if (!validTriState.has(policyUpdated)) errors.push('--security-policy-updated must be true, false, or unknown')
|
|
57
|
-
if (!validEvidenceStatuses.has(evidenceStatus)) errors.push('--evidence-status must be pending or accepted')
|
|
58
|
-
|
|
59
|
-
if (contactStatus === 'accepted') {
|
|
60
|
-
if (contactType === 'unknown') errors.push('accepted security contact requires --contact-type')
|
|
61
|
-
requireField(contactValue, 'accepted security contact requires --contact-value')
|
|
62
|
-
requireField(evidenceOwner, 'accepted security contact requires --evidence-owner')
|
|
63
|
-
requireField(evidenceDate, 'accepted security contact requires --evidence-date')
|
|
64
|
-
requireField(evidenceUrl, 'accepted security contact requires --evidence-url')
|
|
65
|
-
requireField(acceptedBy, 'accepted security contact requires --accepted-by')
|
|
66
|
-
requireField(acceptedAt, 'accepted security contact requires --accepted-at')
|
|
67
|
-
if (isPublic !== 'true') errors.push('accepted security contact requires --is-public true')
|
|
68
|
-
if (policyUpdated !== 'true') errors.push('accepted security contact requires --security-policy-updated true')
|
|
69
|
-
if (evidenceStatus !== 'accepted') errors.push('accepted security contact requires --evidence-status accepted')
|
|
70
|
-
if (!dryRun) {
|
|
71
|
-
rejectPlaceholderEvidence(errors, contactValue, '--contact-value')
|
|
72
|
-
rejectPlaceholderEvidence(errors, evidenceOwner, '--evidence-owner')
|
|
73
|
-
rejectPlaceholderEvidence(errors, evidenceUrl, '--evidence-url')
|
|
74
|
-
rejectPlaceholderEvidence(errors, acceptedBy, '--accepted-by')
|
|
75
|
-
}
|
|
76
|
-
}
|
|
77
|
-
|
|
78
|
-
const lines = [
|
|
79
|
-
'# Public Security Contact Record',
|
|
80
|
-
'',
|
|
81
|
-
'Contact status: ' + contactStatus,
|
|
82
|
-
'',
|
|
83
|
-
'Contact type: ' + contactType,
|
|
84
|
-
'',
|
|
85
|
-
'Contact value: ' + contactValue,
|
|
86
|
-
'',
|
|
87
|
-
'Policy path: `' + policyPath + '`',
|
|
88
|
-
'',
|
|
89
|
-
'Evidence owner: ' + evidenceOwner,
|
|
90
|
-
'',
|
|
91
|
-
'Evidence date: ' + evidenceDate,
|
|
92
|
-
'',
|
|
93
|
-
'Evidence URL or run id: ' + evidenceUrl,
|
|
94
|
-
'',
|
|
95
|
-
'## Public Disclosure Policy',
|
|
96
|
-
'',
|
|
97
|
-
'- Is this contact public? ' + isPublic,
|
|
98
|
-
'- Security policy updated? ' + policyUpdated,
|
|
99
|
-
'- Private fallback channel: ' + privateFallback,
|
|
100
|
-
'- Response expectation: ' + responseExpectation,
|
|
101
|
-
'- Embargo or disclosure notes: ' + disclosureNotes,
|
|
102
|
-
'',
|
|
103
|
-
'## Verification',
|
|
104
|
-
'',
|
|
105
|
-
'Verification command: ' + verificationCommand,
|
|
106
|
-
'',
|
|
107
|
-
'Verification result: ' + verificationResult,
|
|
108
|
-
'',
|
|
109
|
-
'## Acceptance',
|
|
110
|
-
'',
|
|
111
|
-
'Evidence status: ' + evidenceStatus,
|
|
112
|
-
'',
|
|
113
|
-
'Accepted by: ' + acceptedBy,
|
|
114
|
-
'',
|
|
115
|
-
'Accepted at: ' + acceptedAt,
|
|
116
|
-
'',
|
|
117
|
-
'## Residual Risk',
|
|
118
|
-
'',
|
|
119
|
-
'- ' + residualRisk,
|
|
120
|
-
'',
|
|
121
|
-
'## Next Action',
|
|
122
|
-
'',
|
|
123
|
-
'- ' + nextAction,
|
|
124
|
-
'',
|
|
125
|
-
]
|
|
126
|
-
|
|
127
|
-
const report = {
|
|
128
|
-
root,
|
|
129
|
-
out,
|
|
130
|
-
dryRun,
|
|
131
|
-
contactStatus,
|
|
132
|
-
evidenceStatus,
|
|
133
|
-
status: errors.length ? 'failed' : dryRun ? 'ready' : 'written',
|
|
134
|
-
errors,
|
|
135
|
-
}
|
|
136
|
-
|
|
137
|
-
if (!errors.length && !dryRun) {
|
|
138
|
-
if (fs.existsSync(out) && !force) {
|
|
139
|
-
report.status = 'exists'
|
|
140
|
-
report.errors.push('output exists; use --force or choose another --out path')
|
|
141
|
-
} else {
|
|
142
|
-
fs.mkdirSync(path.dirname(out), { recursive: true })
|
|
143
|
-
fs.writeFileSync(out, lines.join('\n'), 'utf8')
|
|
144
|
-
}
|
|
145
|
-
}
|
|
146
|
-
|
|
147
|
-
if (jsonOnly) console.log(JSON.stringify(report, null, 2))
|
|
148
|
-
else {
|
|
149
|
-
console.log('Public security contact record status: ' + report.status)
|
|
150
|
-
console.log('Output: ' + report.out)
|
|
151
|
-
if (report.errors.length) {
|
|
152
|
-
console.log('Errors:')
|
|
153
|
-
for (const error of report.errors) console.log('- ' + error)
|
|
154
|
-
}
|
|
155
|
-
}
|
|
156
|
-
|
|
157
|
-
if (report.status === 'failed' || report.status === 'exists') process.exit(1)
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import fs from 'node:fs'
|
|
3
|
+
import path from 'node:path'
|
|
4
|
+
import { rejectPlaceholderEvidence } from './lib/evidence-placeholders.mjs'
|
|
5
|
+
|
|
6
|
+
const args = process.argv.slice(2)
|
|
7
|
+
|
|
8
|
+
function readArg(name, fallback = '') {
|
|
9
|
+
const index = args.indexOf(name)
|
|
10
|
+
if (index === -1) return fallback
|
|
11
|
+
return args[index + 1] ?? fallback
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
function hasArg(name) {
|
|
15
|
+
return args.includes(name)
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
const root = path.resolve(readArg('--root', path.join(import.meta.dirname, '..')))
|
|
19
|
+
const contactStatus = readArg('--contact-status', 'pending')
|
|
20
|
+
const contactType = readArg('--contact-type', 'unknown')
|
|
21
|
+
const contactValue = readArg('--contact-value', '')
|
|
22
|
+
const policyPath = readArg('--policy-path', 'SECURITY.md')
|
|
23
|
+
const evidenceOwner = readArg('--evidence-owner', '')
|
|
24
|
+
const evidenceDate = readArg('--evidence-date', '')
|
|
25
|
+
const evidenceUrl = readArg('--evidence-url', '')
|
|
26
|
+
const isPublic = readArg('--is-public', 'unknown')
|
|
27
|
+
const policyUpdated = readArg('--security-policy-updated', 'unknown')
|
|
28
|
+
const privateFallback = readArg('--private-fallback-channel', 'owner private coordination channel')
|
|
29
|
+
const responseExpectation = readArg('--response-expectation', 'pending owner policy')
|
|
30
|
+
const disclosureNotes = readArg('--disclosure-notes', 'Do not publish exploit details until the public contact is owner-accepted.')
|
|
31
|
+
const verificationCommand = readArg('--verification-command', 'node scripts/audit-open-source-readiness.mjs --root . --json')
|
|
32
|
+
const verificationResult = readArg('--verification-result', 'pending')
|
|
33
|
+
const evidenceStatus = readArg('--evidence-status', contactStatus === 'accepted' ? 'accepted' : 'pending')
|
|
34
|
+
const acceptedBy = readArg('--accepted-by', '')
|
|
35
|
+
const acceptedAt = readArg('--accepted-at', '')
|
|
36
|
+
const residualRisk = readArg('--residual-risk', 'Public security contact is not accepted until owner evidence is attached.')
|
|
37
|
+
const nextAction = readArg('--next-action', 'Attach owner-approved public security contact evidence and re-run final readiness.')
|
|
38
|
+
const out = path.resolve(readArg('--out', path.join(root, '.gse', 'releases', 'public-security-contact-owner-required.md')))
|
|
39
|
+
const dryRun = hasArg('--dry-run')
|
|
40
|
+
const force = hasArg('--force')
|
|
41
|
+
const jsonOnly = hasArg('--json')
|
|
42
|
+
|
|
43
|
+
const validStatuses = new Set(['pending', 'accepted'])
|
|
44
|
+
const validContactTypes = new Set(['email', 'url', 'github-security-advisory', 'other', 'unknown'])
|
|
45
|
+
const validTriState = new Set(['true', 'false', 'unknown'])
|
|
46
|
+
const validEvidenceStatuses = new Set(['pending', 'accepted'])
|
|
47
|
+
const errors = []
|
|
48
|
+
|
|
49
|
+
function requireField(value, message) {
|
|
50
|
+
if (!String(value).trim()) errors.push(message)
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
if (!validStatuses.has(contactStatus)) errors.push('--contact-status must be pending or accepted')
|
|
54
|
+
if (!validContactTypes.has(contactType)) errors.push('--contact-type must be email, url, github-security-advisory, other, or unknown')
|
|
55
|
+
if (!validTriState.has(isPublic)) errors.push('--is-public must be true, false, or unknown')
|
|
56
|
+
if (!validTriState.has(policyUpdated)) errors.push('--security-policy-updated must be true, false, or unknown')
|
|
57
|
+
if (!validEvidenceStatuses.has(evidenceStatus)) errors.push('--evidence-status must be pending or accepted')
|
|
58
|
+
|
|
59
|
+
if (contactStatus === 'accepted') {
|
|
60
|
+
if (contactType === 'unknown') errors.push('accepted security contact requires --contact-type')
|
|
61
|
+
requireField(contactValue, 'accepted security contact requires --contact-value')
|
|
62
|
+
requireField(evidenceOwner, 'accepted security contact requires --evidence-owner')
|
|
63
|
+
requireField(evidenceDate, 'accepted security contact requires --evidence-date')
|
|
64
|
+
requireField(evidenceUrl, 'accepted security contact requires --evidence-url')
|
|
65
|
+
requireField(acceptedBy, 'accepted security contact requires --accepted-by')
|
|
66
|
+
requireField(acceptedAt, 'accepted security contact requires --accepted-at')
|
|
67
|
+
if (isPublic !== 'true') errors.push('accepted security contact requires --is-public true')
|
|
68
|
+
if (policyUpdated !== 'true') errors.push('accepted security contact requires --security-policy-updated true')
|
|
69
|
+
if (evidenceStatus !== 'accepted') errors.push('accepted security contact requires --evidence-status accepted')
|
|
70
|
+
if (!dryRun) {
|
|
71
|
+
rejectPlaceholderEvidence(errors, contactValue, '--contact-value')
|
|
72
|
+
rejectPlaceholderEvidence(errors, evidenceOwner, '--evidence-owner')
|
|
73
|
+
rejectPlaceholderEvidence(errors, evidenceUrl, '--evidence-url')
|
|
74
|
+
rejectPlaceholderEvidence(errors, acceptedBy, '--accepted-by')
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
const lines = [
|
|
79
|
+
'# Public Security Contact Record',
|
|
80
|
+
'',
|
|
81
|
+
'Contact status: ' + contactStatus,
|
|
82
|
+
'',
|
|
83
|
+
'Contact type: ' + contactType,
|
|
84
|
+
'',
|
|
85
|
+
'Contact value: ' + contactValue,
|
|
86
|
+
'',
|
|
87
|
+
'Policy path: `' + policyPath + '`',
|
|
88
|
+
'',
|
|
89
|
+
'Evidence owner: ' + evidenceOwner,
|
|
90
|
+
'',
|
|
91
|
+
'Evidence date: ' + evidenceDate,
|
|
92
|
+
'',
|
|
93
|
+
'Evidence URL or run id: ' + evidenceUrl,
|
|
94
|
+
'',
|
|
95
|
+
'## Public Disclosure Policy',
|
|
96
|
+
'',
|
|
97
|
+
'- Is this contact public? ' + isPublic,
|
|
98
|
+
'- Security policy updated? ' + policyUpdated,
|
|
99
|
+
'- Private fallback channel: ' + privateFallback,
|
|
100
|
+
'- Response expectation: ' + responseExpectation,
|
|
101
|
+
'- Embargo or disclosure notes: ' + disclosureNotes,
|
|
102
|
+
'',
|
|
103
|
+
'## Verification',
|
|
104
|
+
'',
|
|
105
|
+
'Verification command: ' + verificationCommand,
|
|
106
|
+
'',
|
|
107
|
+
'Verification result: ' + verificationResult,
|
|
108
|
+
'',
|
|
109
|
+
'## Acceptance',
|
|
110
|
+
'',
|
|
111
|
+
'Evidence status: ' + evidenceStatus,
|
|
112
|
+
'',
|
|
113
|
+
'Accepted by: ' + acceptedBy,
|
|
114
|
+
'',
|
|
115
|
+
'Accepted at: ' + acceptedAt,
|
|
116
|
+
'',
|
|
117
|
+
'## Residual Risk',
|
|
118
|
+
'',
|
|
119
|
+
'- ' + residualRisk,
|
|
120
|
+
'',
|
|
121
|
+
'## Next Action',
|
|
122
|
+
'',
|
|
123
|
+
'- ' + nextAction,
|
|
124
|
+
'',
|
|
125
|
+
]
|
|
126
|
+
|
|
127
|
+
const report = {
|
|
128
|
+
root,
|
|
129
|
+
out,
|
|
130
|
+
dryRun,
|
|
131
|
+
contactStatus,
|
|
132
|
+
evidenceStatus,
|
|
133
|
+
status: errors.length ? 'failed' : dryRun ? 'ready' : 'written',
|
|
134
|
+
errors,
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
if (!errors.length && !dryRun) {
|
|
138
|
+
if (fs.existsSync(out) && !force) {
|
|
139
|
+
report.status = 'exists'
|
|
140
|
+
report.errors.push('output exists; use --force or choose another --out path')
|
|
141
|
+
} else {
|
|
142
|
+
fs.mkdirSync(path.dirname(out), { recursive: true })
|
|
143
|
+
fs.writeFileSync(out, lines.join('\n'), 'utf8')
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
if (jsonOnly) console.log(JSON.stringify(report, null, 2))
|
|
148
|
+
else {
|
|
149
|
+
console.log('Public security contact record status: ' + report.status)
|
|
150
|
+
console.log('Output: ' + report.out)
|
|
151
|
+
if (report.errors.length) {
|
|
152
|
+
console.log('Errors:')
|
|
153
|
+
for (const error of report.errors) console.log('- ' + error)
|
|
154
|
+
}
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
if (report.status === 'failed' || report.status === 'exists') process.exit(1)
|
|
@@ -1,83 +1,83 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
import fs from 'node:fs'
|
|
3
|
-
import path from 'node:path'
|
|
4
|
-
import crypto from 'node:crypto'
|
|
5
|
-
|
|
6
|
-
const args = process.argv.slice(2)
|
|
7
|
-
|
|
8
|
-
function readArg(name, fallback = null) {
|
|
9
|
-
const index = args.indexOf(name)
|
|
10
|
-
if (index === -1) return fallback
|
|
11
|
-
return args[index + 1] ?? fallback
|
|
12
|
-
}
|
|
13
|
-
|
|
14
|
-
const packageDir = path.resolve(readArg('--package', process.cwd()))
|
|
15
|
-
const privateKeyPath = path.resolve(readArg('--private-key', path.join(packageDir, 'gse-signing-private.pem')))
|
|
16
|
-
const publicKeyPath = path.resolve(readArg('--public-key', path.join(packageDir, 'gse-signing-public.pem')))
|
|
17
|
-
const out = path.resolve(readArg('--out', path.join(packageDir, 'gse-package-signature.json')))
|
|
18
|
-
const generateKey = args.includes('--generate-key')
|
|
19
|
-
const jsonOnly = args.includes('--json')
|
|
20
|
-
|
|
21
|
-
function fail(message) {
|
|
22
|
-
console.error(JSON.stringify({ packageDir, status: 'failed', error: message }, null, 2))
|
|
23
|
-
process.exit(1)
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
function readManifest() {
|
|
27
|
-
const manifestPath = path.join(packageDir, 'gse-package-manifest.json')
|
|
28
|
-
if (!fs.existsSync(manifestPath)) fail('Missing gse-package-manifest.json.')
|
|
29
|
-
return JSON.parse(fs.readFileSync(manifestPath, 'utf8').replace(/^\uFEFF/, ''))
|
|
30
|
-
}
|
|
31
|
-
|
|
32
|
-
function fingerprint(pem) {
|
|
33
|
-
return crypto.createHash('sha256').update(pem).digest('hex')
|
|
34
|
-
}
|
|
35
|
-
|
|
36
|
-
if (generateKey && (!fs.existsSync(privateKeyPath) || !fs.existsSync(publicKeyPath))) {
|
|
37
|
-
const { privateKey, publicKey } = crypto.generateKeyPairSync('ed25519')
|
|
38
|
-
fs.mkdirSync(path.dirname(privateKeyPath), { recursive: true })
|
|
39
|
-
fs.writeFileSync(privateKeyPath, privateKey.export({ type: 'pkcs8', format: 'pem' }), 'utf8')
|
|
40
|
-
fs.writeFileSync(publicKeyPath, publicKey.export({ type: 'spki', format: 'pem' }), 'utf8')
|
|
41
|
-
}
|
|
42
|
-
|
|
43
|
-
if (!fs.existsSync(privateKeyPath)) fail('Missing --private-key. Use --generate-key for local audit keys.')
|
|
44
|
-
if (!fs.existsSync(publicKeyPath)) fail('Missing --public-key. Use --generate-key for local audit keys.')
|
|
45
|
-
|
|
46
|
-
const manifest = readManifest()
|
|
47
|
-
if (!manifest?.integrity?.packageDigest) fail('Manifest is missing integrity.packageDigest.')
|
|
48
|
-
|
|
49
|
-
const privateKeyPem = fs.readFileSync(privateKeyPath, 'utf8')
|
|
50
|
-
const publicKeyPem = fs.readFileSync(publicKeyPath, 'utf8')
|
|
51
|
-
const payload = {
|
|
52
|
-
schemaVersion: 1,
|
|
53
|
-
packageName: manifest.packageName,
|
|
54
|
-
label: manifest.label,
|
|
55
|
-
fileCount: manifest.fileCount,
|
|
56
|
-
packageDigest: manifest.integrity.packageDigest,
|
|
57
|
-
}
|
|
58
|
-
const payloadText = JSON.stringify(payload)
|
|
59
|
-
const signature = crypto.sign(null, Buffer.from(payloadText), privateKeyPem).toString('base64')
|
|
60
|
-
const signatureRecord = {
|
|
61
|
-
schemaVersion: 1,
|
|
62
|
-
algorithm: 'ed25519',
|
|
63
|
-
signedAt: new Date().toISOString(),
|
|
64
|
-
publicKeyFingerprint: fingerprint(publicKeyPem),
|
|
65
|
-
payload,
|
|
66
|
-
signature,
|
|
67
|
-
}
|
|
68
|
-
|
|
69
|
-
fs.writeFileSync(out, JSON.stringify(signatureRecord, null, 2) + '\n', 'utf8')
|
|
70
|
-
|
|
71
|
-
const report = {
|
|
72
|
-
packageDir,
|
|
73
|
-
privateKey: privateKeyPath,
|
|
74
|
-
publicKey: publicKeyPath,
|
|
75
|
-
signature: out,
|
|
76
|
-
status: 'signed',
|
|
77
|
-
algorithm: 'ed25519',
|
|
78
|
-
publicKeyFingerprint: signatureRecord.publicKeyFingerprint,
|
|
79
|
-
}
|
|
80
|
-
|
|
81
|
-
if (jsonOnly) console.log(JSON.stringify(report, null, 2))
|
|
82
|
-
else console.log(JSON.stringify(report, null, 2))
|
|
83
|
-
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import fs from 'node:fs'
|
|
3
|
+
import path from 'node:path'
|
|
4
|
+
import crypto from 'node:crypto'
|
|
5
|
+
|
|
6
|
+
const args = process.argv.slice(2)
|
|
7
|
+
|
|
8
|
+
function readArg(name, fallback = null) {
|
|
9
|
+
const index = args.indexOf(name)
|
|
10
|
+
if (index === -1) return fallback
|
|
11
|
+
return args[index + 1] ?? fallback
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
const packageDir = path.resolve(readArg('--package', process.cwd()))
|
|
15
|
+
const privateKeyPath = path.resolve(readArg('--private-key', path.join(packageDir, 'gse-signing-private.pem')))
|
|
16
|
+
const publicKeyPath = path.resolve(readArg('--public-key', path.join(packageDir, 'gse-signing-public.pem')))
|
|
17
|
+
const out = path.resolve(readArg('--out', path.join(packageDir, 'gse-package-signature.json')))
|
|
18
|
+
const generateKey = args.includes('--generate-key')
|
|
19
|
+
const jsonOnly = args.includes('--json')
|
|
20
|
+
|
|
21
|
+
function fail(message) {
|
|
22
|
+
console.error(JSON.stringify({ packageDir, status: 'failed', error: message }, null, 2))
|
|
23
|
+
process.exit(1)
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
function readManifest() {
|
|
27
|
+
const manifestPath = path.join(packageDir, 'gse-package-manifest.json')
|
|
28
|
+
if (!fs.existsSync(manifestPath)) fail('Missing gse-package-manifest.json.')
|
|
29
|
+
return JSON.parse(fs.readFileSync(manifestPath, 'utf8').replace(/^\uFEFF/, ''))
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
function fingerprint(pem) {
|
|
33
|
+
return crypto.createHash('sha256').update(pem).digest('hex')
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
if (generateKey && (!fs.existsSync(privateKeyPath) || !fs.existsSync(publicKeyPath))) {
|
|
37
|
+
const { privateKey, publicKey } = crypto.generateKeyPairSync('ed25519')
|
|
38
|
+
fs.mkdirSync(path.dirname(privateKeyPath), { recursive: true })
|
|
39
|
+
fs.writeFileSync(privateKeyPath, privateKey.export({ type: 'pkcs8', format: 'pem' }), 'utf8')
|
|
40
|
+
fs.writeFileSync(publicKeyPath, publicKey.export({ type: 'spki', format: 'pem' }), 'utf8')
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
if (!fs.existsSync(privateKeyPath)) fail('Missing --private-key. Use --generate-key for local audit keys.')
|
|
44
|
+
if (!fs.existsSync(publicKeyPath)) fail('Missing --public-key. Use --generate-key for local audit keys.')
|
|
45
|
+
|
|
46
|
+
const manifest = readManifest()
|
|
47
|
+
if (!manifest?.integrity?.packageDigest) fail('Manifest is missing integrity.packageDigest.')
|
|
48
|
+
|
|
49
|
+
const privateKeyPem = fs.readFileSync(privateKeyPath, 'utf8')
|
|
50
|
+
const publicKeyPem = fs.readFileSync(publicKeyPath, 'utf8')
|
|
51
|
+
const payload = {
|
|
52
|
+
schemaVersion: 1,
|
|
53
|
+
packageName: manifest.packageName,
|
|
54
|
+
label: manifest.label,
|
|
55
|
+
fileCount: manifest.fileCount,
|
|
56
|
+
packageDigest: manifest.integrity.packageDigest,
|
|
57
|
+
}
|
|
58
|
+
const payloadText = JSON.stringify(payload)
|
|
59
|
+
const signature = crypto.sign(null, Buffer.from(payloadText), privateKeyPem).toString('base64')
|
|
60
|
+
const signatureRecord = {
|
|
61
|
+
schemaVersion: 1,
|
|
62
|
+
algorithm: 'ed25519',
|
|
63
|
+
signedAt: new Date().toISOString(),
|
|
64
|
+
publicKeyFingerprint: fingerprint(publicKeyPem),
|
|
65
|
+
payload,
|
|
66
|
+
signature,
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
fs.writeFileSync(out, JSON.stringify(signatureRecord, null, 2) + '\n', 'utf8')
|
|
70
|
+
|
|
71
|
+
const report = {
|
|
72
|
+
packageDir,
|
|
73
|
+
privateKey: privateKeyPath,
|
|
74
|
+
publicKey: publicKeyPath,
|
|
75
|
+
signature: out,
|
|
76
|
+
status: 'signed',
|
|
77
|
+
algorithm: 'ed25519',
|
|
78
|
+
publicKeyFingerprint: signatureRecord.publicKeyFingerprint,
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
if (jsonOnly) console.log(JSON.stringify(report, null, 2))
|
|
82
|
+
else console.log(JSON.stringify(report, null, 2))
|
|
83
|
+
|