@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,237 +1,237 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
import fs from 'node:fs'
|
|
3
|
-
import os from 'node:os'
|
|
4
|
-
import path from 'node:path'
|
|
5
|
-
import { spawnSync } from 'node:child_process'
|
|
6
|
-
|
|
7
|
-
const args = process.argv.slice(2)
|
|
8
|
-
|
|
9
|
-
function readArg(name, fallback = null) {
|
|
10
|
-
const index = args.indexOf(name)
|
|
11
|
-
if (index === -1) return fallback
|
|
12
|
-
return args[index + 1] ?? fallback
|
|
13
|
-
}
|
|
14
|
-
|
|
15
|
-
const root = path.resolve(readArg('--root', path.join(import.meta.dirname, '..')))
|
|
16
|
-
const jsonOnly = args.includes('--json')
|
|
17
|
-
|
|
18
|
-
function read(relativePath) {
|
|
19
|
-
const fullPath = path.join(root, relativePath)
|
|
20
|
-
return fs.existsSync(fullPath) ? fs.readFileSync(fullPath, 'utf8') : ''
|
|
21
|
-
}
|
|
22
|
-
|
|
23
|
-
function exists(relativePath) {
|
|
24
|
-
return fs.existsSync(path.join(root, relativePath))
|
|
25
|
-
}
|
|
26
|
-
|
|
27
|
-
function run(command, commandArgs, cwd = root) {
|
|
28
|
-
const result = spawnSync(command, commandArgs, {
|
|
29
|
-
cwd,
|
|
30
|
-
encoding: 'utf8',
|
|
31
|
-
windowsHide: true,
|
|
32
|
-
})
|
|
33
|
-
return {
|
|
34
|
-
status: result.status ?? 1,
|
|
35
|
-
stdout: (result.stdout ?? '').trim(),
|
|
36
|
-
stderr: (result.stderr ?? '').trim(),
|
|
37
|
-
command: [command, ...commandArgs].join(' '),
|
|
38
|
-
}
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
function parseJson(stdout) {
|
|
42
|
-
try {
|
|
43
|
-
return JSON.parse(stdout)
|
|
44
|
-
} catch {
|
|
45
|
-
return null
|
|
46
|
-
}
|
|
47
|
-
}
|
|
48
|
-
|
|
49
|
-
function check(id, label, ok, evidence, risk = '') {
|
|
50
|
-
return { id, label, status: ok ? 'passed' : 'failed', evidence, risk }
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
function createFixture() {
|
|
54
|
-
const fixture = fs.mkdtempSync(path.join(os.tmpdir(), 'gse-public-repo-settings-'))
|
|
55
|
-
fs.mkdirSync(path.join(fixture, '.gse', 'releases'), { recursive: true })
|
|
56
|
-
fs.mkdirSync(path.join(fixture, '.github', 'workflows'), { recursive: true })
|
|
57
|
-
fs.mkdirSync(path.join(fixture, '.github', 'ISSUE_TEMPLATE'), { recursive: true })
|
|
58
|
-
fs.writeFileSync(path.join(fixture, '.github', 'workflows', 'validate-gse.yml'), 'name: Validate GSE\n', 'utf8')
|
|
59
|
-
fs.writeFileSync(path.join(fixture, '.github', 'PULL_REQUEST_TEMPLATE.md'), '## Evidence\n', 'utf8')
|
|
60
|
-
fs.writeFileSync(path.join(fixture, '.github', 'ISSUE_TEMPLATE', 'bug_report.yml'), 'name: Bug report\n', 'utf8')
|
|
61
|
-
return fixture
|
|
62
|
-
}
|
|
63
|
-
|
|
64
|
-
const recordScript = path.join(root, 'scripts', 'record-public-repository-settings.mjs')
|
|
65
|
-
const template = read('assets/templates/public-repository-settings-record.md')
|
|
66
|
-
const publicRelease = read('references/public-release.md')
|
|
67
|
-
const finalReadiness = read('references/final-readiness.md')
|
|
68
|
-
const validate = read('scripts/validate-gse.mjs')
|
|
69
|
-
|
|
70
|
-
const fixture = exists('scripts/record-public-repository-settings.mjs') ? createFixture() : null
|
|
71
|
-
const pending = fixture ? run(process.execPath, [recordScript, '--root', fixture, '--settings-status', 'pending', '--dry-run', '--json']) : null
|
|
72
|
-
const verifiedOk = fixture ? run(process.execPath, [
|
|
73
|
-
recordScript,
|
|
74
|
-
'--root', fixture,
|
|
75
|
-
'--repository-url', 'https://github.com/example/gse',
|
|
76
|
-
'--visibility', 'public',
|
|
77
|
-
'--settings-status', 'verified',
|
|
78
|
-
'--evidence-owner', 'fixture-owner',
|
|
79
|
-
'--evidence-date', '2026-07-06',
|
|
80
|
-
'--evidence-url', 'https://github.com/example/gse/settings/branches',
|
|
81
|
-
'--issues-enabled', 'true',
|
|
82
|
-
'--pull-requests-enabled', 'true',
|
|
83
|
-
'--security-policy-visible', 'true',
|
|
84
|
-
'--branch-protection-enabled', 'true',
|
|
85
|
-
'--required-status-checks-enabled', 'true',
|
|
86
|
-
'--required-checks', 'Validate GSE',
|
|
87
|
-
'--require-review-before-merge', 'true',
|
|
88
|
-
'--require-conversation-resolution', 'true',
|
|
89
|
-
'--restrict-force-pushes', 'true',
|
|
90
|
-
'--restrict-deletions', 'true',
|
|
91
|
-
'--evidence-status', 'verified',
|
|
92
|
-
'--dry-run',
|
|
93
|
-
'--json',
|
|
94
|
-
]) : null
|
|
95
|
-
const verifiedMissing = fixture ? run(process.execPath, [recordScript, '--root', fixture, '--settings-status', 'verified', '--dry-run', '--json']) : null
|
|
96
|
-
const acceptedMissing = fixture ? run(process.execPath, [
|
|
97
|
-
recordScript,
|
|
98
|
-
'--root', fixture,
|
|
99
|
-
'--repository-url', 'https://github.com/example/gse',
|
|
100
|
-
'--visibility', 'public',
|
|
101
|
-
'--settings-status', 'accepted',
|
|
102
|
-
'--evidence-owner', 'fixture-owner',
|
|
103
|
-
'--evidence-date', '2026-07-06',
|
|
104
|
-
'--evidence-url', 'https://github.com/example/gse/settings/branches',
|
|
105
|
-
'--issues-enabled', 'true',
|
|
106
|
-
'--pull-requests-enabled', 'true',
|
|
107
|
-
'--security-policy-visible', 'true',
|
|
108
|
-
'--branch-protection-enabled', 'true',
|
|
109
|
-
'--required-status-checks-enabled', 'true',
|
|
110
|
-
'--required-checks', 'Validate GSE',
|
|
111
|
-
'--require-review-before-merge', 'true',
|
|
112
|
-
'--require-conversation-resolution', 'true',
|
|
113
|
-
'--restrict-force-pushes', 'true',
|
|
114
|
-
'--restrict-deletions', 'true',
|
|
115
|
-
'--evidence-status', 'verified',
|
|
116
|
-
'--dry-run',
|
|
117
|
-
'--json',
|
|
118
|
-
]) : null
|
|
119
|
-
const acceptedOk = fixture ? run(process.execPath, [
|
|
120
|
-
recordScript,
|
|
121
|
-
'--root', fixture,
|
|
122
|
-
'--repository-url', 'https://github.com/example/gse',
|
|
123
|
-
'--visibility', 'public',
|
|
124
|
-
'--settings-status', 'accepted',
|
|
125
|
-
'--evidence-owner', 'fixture-owner',
|
|
126
|
-
'--evidence-date', '2026-07-06',
|
|
127
|
-
'--evidence-url', 'https://github.com/example/gse/settings/branches',
|
|
128
|
-
'--issues-enabled', 'true',
|
|
129
|
-
'--pull-requests-enabled', 'true',
|
|
130
|
-
'--security-policy-visible', 'true',
|
|
131
|
-
'--branch-protection-enabled', 'true',
|
|
132
|
-
'--required-status-checks-enabled', 'true',
|
|
133
|
-
'--required-checks', 'Validate GSE',
|
|
134
|
-
'--require-review-before-merge', 'true',
|
|
135
|
-
'--require-conversation-resolution', 'true',
|
|
136
|
-
'--restrict-force-pushes', 'true',
|
|
137
|
-
'--restrict-deletions', 'true',
|
|
138
|
-
'--evidence-status', 'accepted',
|
|
139
|
-
'--accepted-by', 'fixture-owner',
|
|
140
|
-
'--accepted-at', '2026-07-06',
|
|
141
|
-
'--dry-run',
|
|
142
|
-
'--json',
|
|
143
|
-
]) : null
|
|
144
|
-
const verifiedPlaceholderWrite = fixture ? run(process.execPath, [
|
|
145
|
-
recordScript,
|
|
146
|
-
'--root', fixture,
|
|
147
|
-
'--repository-url', 'https://github.com/example/gse',
|
|
148
|
-
'--visibility', 'public',
|
|
149
|
-
'--settings-status', 'verified',
|
|
150
|
-
'--evidence-owner', 'fixture-owner',
|
|
151
|
-
'--evidence-date', '2026-07-06',
|
|
152
|
-
'--evidence-url', 'https://github.com/example/gse/settings/branches',
|
|
153
|
-
'--issues-enabled', 'true',
|
|
154
|
-
'--pull-requests-enabled', 'true',
|
|
155
|
-
'--security-policy-visible', 'true',
|
|
156
|
-
'--branch-protection-enabled', 'true',
|
|
157
|
-
'--required-status-checks-enabled', 'true',
|
|
158
|
-
'--required-checks', 'Validate GSE',
|
|
159
|
-
'--require-review-before-merge', 'true',
|
|
160
|
-
'--require-conversation-resolution', 'true',
|
|
161
|
-
'--restrict-force-pushes', 'true',
|
|
162
|
-
'--restrict-deletions', 'true',
|
|
163
|
-
'--evidence-status', 'verified',
|
|
164
|
-
'--json',
|
|
165
|
-
]) : null
|
|
166
|
-
|
|
167
|
-
const pendingData = pending ? parseJson(pending.stdout) : null
|
|
168
|
-
const verifiedOkData = verifiedOk ? parseJson(verifiedOk.stdout) : null
|
|
169
|
-
const verifiedMissingData = verifiedMissing ? parseJson(verifiedMissing.stdout) : null
|
|
170
|
-
const acceptedMissingData = acceptedMissing ? parseJson(acceptedMissing.stdout) : null
|
|
171
|
-
const acceptedOkData = acceptedOk ? parseJson(acceptedOk.stdout) : null
|
|
172
|
-
const verifiedPlaceholderWriteData = verifiedPlaceholderWrite ? parseJson(verifiedPlaceholderWrite.stdout) : null
|
|
173
|
-
|
|
174
|
-
const checks = [
|
|
175
|
-
check('PRS01', 'public repository settings record command exists', exists('scripts/record-public-repository-settings.mjs'), 'scripts/record-public-repository-settings.mjs'),
|
|
176
|
-
check('PRS02', 'public repository settings template exists', exists('assets/templates/public-repository-settings-record.md') && template.includes('Branch protection enabled') && template.includes('Required status checks enabled'), 'assets/templates/public-repository-settings-record.md'),
|
|
177
|
-
check('PRS03', 'pending settings path remains writable without external proof', pending?.status === 0 && pendingData?.status === 'ready' && pendingData?.settingsStatus === 'pending' && pendingData?.evidenceStatus === 'pending', 'record-public-repository-settings pending dry-run'),
|
|
178
|
-
check('PRS04', 'verified settings path accepts complete external evidence', verifiedOk?.status === 0 && verifiedOkData?.status === 'ready' && verifiedOkData?.settingsStatus === 'verified' && verifiedOkData?.evidenceStatus === 'verified', 'record-public-repository-settings verified dry-run'),
|
|
179
|
-
check('PRS05', 'verified settings path rejects missing evidence', verifiedMissing?.status !== 0 && verifiedMissingData?.status === 'failed' && verifiedMissingData?.errors?.some((item) => item.includes('--evidence-owner')) && verifiedMissingData?.errors?.some((item) => item.includes('--evidence-date')) && verifiedMissingData?.errors?.some((item) => item.includes('--required-checks')), 'record-public-repository-settings verified missing-fields dry-run'),
|
|
180
|
-
check('PRS06', 'accepted settings path rejects missing owner acceptance', acceptedMissing?.status !== 0 && acceptedMissingData?.status === 'failed' && acceptedMissingData?.errors?.some((item) => item.includes('--accepted-by')) && acceptedMissingData?.errors?.some((item) => item.includes('--evidence-status accepted')), 'record-public-repository-settings accepted missing acceptance dry-run'),
|
|
181
|
-
check('PRS07', 'accepted settings path accepts complete owner acceptance', acceptedOk?.status === 0 && acceptedOkData?.status === 'ready' && acceptedOkData?.settingsStatus === 'accepted' && acceptedOkData?.evidenceStatus === 'accepted', 'record-public-repository-settings accepted dry-run'),
|
|
182
|
-
check('PRS08', 'verified settings real write rejects placeholder or example evidence', verifiedPlaceholderWrite?.status !== 0 && verifiedPlaceholderWriteData?.status === 'failed' && verifiedPlaceholderWriteData?.errors?.some((item) => item.includes('not a placeholder')), 'record-public-repository-settings verified placeholder write'),
|
|
183
|
-
check('PRS09', 'public release docs reference repository settings evidence', publicRelease.includes('Public repository settings') || publicRelease.includes('repository settings'), 'references/public-release.md'),
|
|
184
|
-
check('PRS10', 'final readiness matrix includes public repository settings', finalReadiness.includes('Public repository settings'), 'references/final-readiness.md'),
|
|
185
|
-
check('PRS11', 'consolidated validator includes repository settings audit', validate.includes('audit-public-repository-settings.mjs'), 'scripts/validate-gse.mjs'),
|
|
186
|
-
]
|
|
187
|
-
|
|
188
|
-
const passed = checks.filter((item) => item.status === 'passed').length
|
|
189
|
-
const failed = checks.length - passed
|
|
190
|
-
const report = {
|
|
191
|
-
root,
|
|
192
|
-
generatedAt: new Date().toISOString(),
|
|
193
|
-
fixtureRoot: fixture,
|
|
194
|
-
summary: { status: failed === 0 ? 'passed' : 'failed', passed, failed, total: checks.length },
|
|
195
|
-
workflows: {
|
|
196
|
-
publicRepositorySettings: failed === 0 ? 'verified' : 'failed',
|
|
197
|
-
acceptedRepositorySettings: acceptedOkData?.status === 'ready' ? 'fixture-verified' : 'not-verified',
|
|
198
|
-
},
|
|
199
|
-
limits: [
|
|
200
|
-
'This audit verifies record mechanics and guardrails for public repository settings.',
|
|
201
|
-
'It does not configure a real GitHub repository, branch protection, issue settings, required checks, or maintainer policies.',
|
|
202
|
-
'Accepted public repository settings still require owner/external evidence from the real repository.',
|
|
203
|
-
],
|
|
204
|
-
checks,
|
|
205
|
-
}
|
|
206
|
-
|
|
207
|
-
function renderMarkdown(data) {
|
|
208
|
-
const lines = []
|
|
209
|
-
lines.push('# GSE Public Repository Settings Audit')
|
|
210
|
-
lines.push('')
|
|
211
|
-
lines.push('Generated: ' + data.generatedAt)
|
|
212
|
-
lines.push('Root: ' + data.root)
|
|
213
|
-
lines.push('')
|
|
214
|
-
lines.push('## Summary')
|
|
215
|
-
lines.push('')
|
|
216
|
-
lines.push('- Status: ' + data.summary.status)
|
|
217
|
-
lines.push('- Checks: ' + data.summary.passed + '/' + data.summary.total)
|
|
218
|
-
lines.push('- Public repository settings: ' + data.workflows.publicRepositorySettings)
|
|
219
|
-
lines.push('- Accepted repository settings path: ' + data.workflows.acceptedRepositorySettings)
|
|
220
|
-
lines.push('')
|
|
221
|
-
lines.push('## Checks')
|
|
222
|
-
lines.push('')
|
|
223
|
-
for (const item of data.checks) {
|
|
224
|
-
const marker = item.status === 'passed' ? '[x]' : '[ ]'
|
|
225
|
-
lines.push('- ' + marker + ' ' + item.id + ' ' + item.label + ': ' + item.evidence)
|
|
226
|
-
}
|
|
227
|
-
lines.push('')
|
|
228
|
-
lines.push('## Limits')
|
|
229
|
-
lines.push('')
|
|
230
|
-
for (const item of data.limits) lines.push('- ' + item)
|
|
231
|
-
return lines.join('\n') + '\n'
|
|
232
|
-
}
|
|
233
|
-
|
|
234
|
-
if (jsonOnly) console.log(JSON.stringify(report, null, 2))
|
|
235
|
-
else console.log(renderMarkdown(report))
|
|
236
|
-
|
|
237
|
-
if (failed > 0) process.exit(1)
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import fs from 'node:fs'
|
|
3
|
+
import os from 'node:os'
|
|
4
|
+
import path from 'node:path'
|
|
5
|
+
import { spawnSync } from 'node:child_process'
|
|
6
|
+
|
|
7
|
+
const args = process.argv.slice(2)
|
|
8
|
+
|
|
9
|
+
function readArg(name, fallback = null) {
|
|
10
|
+
const index = args.indexOf(name)
|
|
11
|
+
if (index === -1) return fallback
|
|
12
|
+
return args[index + 1] ?? fallback
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
const root = path.resolve(readArg('--root', path.join(import.meta.dirname, '..')))
|
|
16
|
+
const jsonOnly = args.includes('--json')
|
|
17
|
+
|
|
18
|
+
function read(relativePath) {
|
|
19
|
+
const fullPath = path.join(root, relativePath)
|
|
20
|
+
return fs.existsSync(fullPath) ? fs.readFileSync(fullPath, 'utf8') : ''
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
function exists(relativePath) {
|
|
24
|
+
return fs.existsSync(path.join(root, relativePath))
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
function run(command, commandArgs, cwd = root) {
|
|
28
|
+
const result = spawnSync(command, commandArgs, {
|
|
29
|
+
cwd,
|
|
30
|
+
encoding: 'utf8',
|
|
31
|
+
windowsHide: true,
|
|
32
|
+
})
|
|
33
|
+
return {
|
|
34
|
+
status: result.status ?? 1,
|
|
35
|
+
stdout: (result.stdout ?? '').trim(),
|
|
36
|
+
stderr: (result.stderr ?? '').trim(),
|
|
37
|
+
command: [command, ...commandArgs].join(' '),
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
function parseJson(stdout) {
|
|
42
|
+
try {
|
|
43
|
+
return JSON.parse(stdout)
|
|
44
|
+
} catch {
|
|
45
|
+
return null
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
function check(id, label, ok, evidence, risk = '') {
|
|
50
|
+
return { id, label, status: ok ? 'passed' : 'failed', evidence, risk }
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
function createFixture() {
|
|
54
|
+
const fixture = fs.mkdtempSync(path.join(os.tmpdir(), 'gse-public-repo-settings-'))
|
|
55
|
+
fs.mkdirSync(path.join(fixture, '.gse', 'releases'), { recursive: true })
|
|
56
|
+
fs.mkdirSync(path.join(fixture, '.github', 'workflows'), { recursive: true })
|
|
57
|
+
fs.mkdirSync(path.join(fixture, '.github', 'ISSUE_TEMPLATE'), { recursive: true })
|
|
58
|
+
fs.writeFileSync(path.join(fixture, '.github', 'workflows', 'validate-gse.yml'), 'name: Validate GSE\n', 'utf8')
|
|
59
|
+
fs.writeFileSync(path.join(fixture, '.github', 'PULL_REQUEST_TEMPLATE.md'), '## Evidence\n', 'utf8')
|
|
60
|
+
fs.writeFileSync(path.join(fixture, '.github', 'ISSUE_TEMPLATE', 'bug_report.yml'), 'name: Bug report\n', 'utf8')
|
|
61
|
+
return fixture
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
const recordScript = path.join(root, 'scripts', 'record-public-repository-settings.mjs')
|
|
65
|
+
const template = read('assets/templates/public-repository-settings-record.md')
|
|
66
|
+
const publicRelease = read('references/public-release.md')
|
|
67
|
+
const finalReadiness = read('references/final-readiness.md')
|
|
68
|
+
const validate = read('scripts/validate-gse.mjs')
|
|
69
|
+
|
|
70
|
+
const fixture = exists('scripts/record-public-repository-settings.mjs') ? createFixture() : null
|
|
71
|
+
const pending = fixture ? run(process.execPath, [recordScript, '--root', fixture, '--settings-status', 'pending', '--dry-run', '--json']) : null
|
|
72
|
+
const verifiedOk = fixture ? run(process.execPath, [
|
|
73
|
+
recordScript,
|
|
74
|
+
'--root', fixture,
|
|
75
|
+
'--repository-url', 'https://github.com/example/gse',
|
|
76
|
+
'--visibility', 'public',
|
|
77
|
+
'--settings-status', 'verified',
|
|
78
|
+
'--evidence-owner', 'fixture-owner',
|
|
79
|
+
'--evidence-date', '2026-07-06',
|
|
80
|
+
'--evidence-url', 'https://github.com/example/gse/settings/branches',
|
|
81
|
+
'--issues-enabled', 'true',
|
|
82
|
+
'--pull-requests-enabled', 'true',
|
|
83
|
+
'--security-policy-visible', 'true',
|
|
84
|
+
'--branch-protection-enabled', 'true',
|
|
85
|
+
'--required-status-checks-enabled', 'true',
|
|
86
|
+
'--required-checks', 'Validate GSE',
|
|
87
|
+
'--require-review-before-merge', 'true',
|
|
88
|
+
'--require-conversation-resolution', 'true',
|
|
89
|
+
'--restrict-force-pushes', 'true',
|
|
90
|
+
'--restrict-deletions', 'true',
|
|
91
|
+
'--evidence-status', 'verified',
|
|
92
|
+
'--dry-run',
|
|
93
|
+
'--json',
|
|
94
|
+
]) : null
|
|
95
|
+
const verifiedMissing = fixture ? run(process.execPath, [recordScript, '--root', fixture, '--settings-status', 'verified', '--dry-run', '--json']) : null
|
|
96
|
+
const acceptedMissing = fixture ? run(process.execPath, [
|
|
97
|
+
recordScript,
|
|
98
|
+
'--root', fixture,
|
|
99
|
+
'--repository-url', 'https://github.com/example/gse',
|
|
100
|
+
'--visibility', 'public',
|
|
101
|
+
'--settings-status', 'accepted',
|
|
102
|
+
'--evidence-owner', 'fixture-owner',
|
|
103
|
+
'--evidence-date', '2026-07-06',
|
|
104
|
+
'--evidence-url', 'https://github.com/example/gse/settings/branches',
|
|
105
|
+
'--issues-enabled', 'true',
|
|
106
|
+
'--pull-requests-enabled', 'true',
|
|
107
|
+
'--security-policy-visible', 'true',
|
|
108
|
+
'--branch-protection-enabled', 'true',
|
|
109
|
+
'--required-status-checks-enabled', 'true',
|
|
110
|
+
'--required-checks', 'Validate GSE',
|
|
111
|
+
'--require-review-before-merge', 'true',
|
|
112
|
+
'--require-conversation-resolution', 'true',
|
|
113
|
+
'--restrict-force-pushes', 'true',
|
|
114
|
+
'--restrict-deletions', 'true',
|
|
115
|
+
'--evidence-status', 'verified',
|
|
116
|
+
'--dry-run',
|
|
117
|
+
'--json',
|
|
118
|
+
]) : null
|
|
119
|
+
const acceptedOk = fixture ? run(process.execPath, [
|
|
120
|
+
recordScript,
|
|
121
|
+
'--root', fixture,
|
|
122
|
+
'--repository-url', 'https://github.com/example/gse',
|
|
123
|
+
'--visibility', 'public',
|
|
124
|
+
'--settings-status', 'accepted',
|
|
125
|
+
'--evidence-owner', 'fixture-owner',
|
|
126
|
+
'--evidence-date', '2026-07-06',
|
|
127
|
+
'--evidence-url', 'https://github.com/example/gse/settings/branches',
|
|
128
|
+
'--issues-enabled', 'true',
|
|
129
|
+
'--pull-requests-enabled', 'true',
|
|
130
|
+
'--security-policy-visible', 'true',
|
|
131
|
+
'--branch-protection-enabled', 'true',
|
|
132
|
+
'--required-status-checks-enabled', 'true',
|
|
133
|
+
'--required-checks', 'Validate GSE',
|
|
134
|
+
'--require-review-before-merge', 'true',
|
|
135
|
+
'--require-conversation-resolution', 'true',
|
|
136
|
+
'--restrict-force-pushes', 'true',
|
|
137
|
+
'--restrict-deletions', 'true',
|
|
138
|
+
'--evidence-status', 'accepted',
|
|
139
|
+
'--accepted-by', 'fixture-owner',
|
|
140
|
+
'--accepted-at', '2026-07-06',
|
|
141
|
+
'--dry-run',
|
|
142
|
+
'--json',
|
|
143
|
+
]) : null
|
|
144
|
+
const verifiedPlaceholderWrite = fixture ? run(process.execPath, [
|
|
145
|
+
recordScript,
|
|
146
|
+
'--root', fixture,
|
|
147
|
+
'--repository-url', 'https://github.com/example/gse',
|
|
148
|
+
'--visibility', 'public',
|
|
149
|
+
'--settings-status', 'verified',
|
|
150
|
+
'--evidence-owner', 'fixture-owner',
|
|
151
|
+
'--evidence-date', '2026-07-06',
|
|
152
|
+
'--evidence-url', 'https://github.com/example/gse/settings/branches',
|
|
153
|
+
'--issues-enabled', 'true',
|
|
154
|
+
'--pull-requests-enabled', 'true',
|
|
155
|
+
'--security-policy-visible', 'true',
|
|
156
|
+
'--branch-protection-enabled', 'true',
|
|
157
|
+
'--required-status-checks-enabled', 'true',
|
|
158
|
+
'--required-checks', 'Validate GSE',
|
|
159
|
+
'--require-review-before-merge', 'true',
|
|
160
|
+
'--require-conversation-resolution', 'true',
|
|
161
|
+
'--restrict-force-pushes', 'true',
|
|
162
|
+
'--restrict-deletions', 'true',
|
|
163
|
+
'--evidence-status', 'verified',
|
|
164
|
+
'--json',
|
|
165
|
+
]) : null
|
|
166
|
+
|
|
167
|
+
const pendingData = pending ? parseJson(pending.stdout) : null
|
|
168
|
+
const verifiedOkData = verifiedOk ? parseJson(verifiedOk.stdout) : null
|
|
169
|
+
const verifiedMissingData = verifiedMissing ? parseJson(verifiedMissing.stdout) : null
|
|
170
|
+
const acceptedMissingData = acceptedMissing ? parseJson(acceptedMissing.stdout) : null
|
|
171
|
+
const acceptedOkData = acceptedOk ? parseJson(acceptedOk.stdout) : null
|
|
172
|
+
const verifiedPlaceholderWriteData = verifiedPlaceholderWrite ? parseJson(verifiedPlaceholderWrite.stdout) : null
|
|
173
|
+
|
|
174
|
+
const checks = [
|
|
175
|
+
check('PRS01', 'public repository settings record command exists', exists('scripts/record-public-repository-settings.mjs'), 'scripts/record-public-repository-settings.mjs'),
|
|
176
|
+
check('PRS02', 'public repository settings template exists', exists('assets/templates/public-repository-settings-record.md') && template.includes('Branch protection enabled') && template.includes('Required status checks enabled'), 'assets/templates/public-repository-settings-record.md'),
|
|
177
|
+
check('PRS03', 'pending settings path remains writable without external proof', pending?.status === 0 && pendingData?.status === 'ready' && pendingData?.settingsStatus === 'pending' && pendingData?.evidenceStatus === 'pending', 'record-public-repository-settings pending dry-run'),
|
|
178
|
+
check('PRS04', 'verified settings path accepts complete external evidence', verifiedOk?.status === 0 && verifiedOkData?.status === 'ready' && verifiedOkData?.settingsStatus === 'verified' && verifiedOkData?.evidenceStatus === 'verified', 'record-public-repository-settings verified dry-run'),
|
|
179
|
+
check('PRS05', 'verified settings path rejects missing evidence', verifiedMissing?.status !== 0 && verifiedMissingData?.status === 'failed' && verifiedMissingData?.errors?.some((item) => item.includes('--evidence-owner')) && verifiedMissingData?.errors?.some((item) => item.includes('--evidence-date')) && verifiedMissingData?.errors?.some((item) => item.includes('--required-checks')), 'record-public-repository-settings verified missing-fields dry-run'),
|
|
180
|
+
check('PRS06', 'accepted settings path rejects missing owner acceptance', acceptedMissing?.status !== 0 && acceptedMissingData?.status === 'failed' && acceptedMissingData?.errors?.some((item) => item.includes('--accepted-by')) && acceptedMissingData?.errors?.some((item) => item.includes('--evidence-status accepted')), 'record-public-repository-settings accepted missing acceptance dry-run'),
|
|
181
|
+
check('PRS07', 'accepted settings path accepts complete owner acceptance', acceptedOk?.status === 0 && acceptedOkData?.status === 'ready' && acceptedOkData?.settingsStatus === 'accepted' && acceptedOkData?.evidenceStatus === 'accepted', 'record-public-repository-settings accepted dry-run'),
|
|
182
|
+
check('PRS08', 'verified settings real write rejects placeholder or example evidence', verifiedPlaceholderWrite?.status !== 0 && verifiedPlaceholderWriteData?.status === 'failed' && verifiedPlaceholderWriteData?.errors?.some((item) => item.includes('not a placeholder')), 'record-public-repository-settings verified placeholder write'),
|
|
183
|
+
check('PRS09', 'public release docs reference repository settings evidence', publicRelease.includes('Public repository settings') || publicRelease.includes('repository settings'), 'references/public-release.md'),
|
|
184
|
+
check('PRS10', 'final readiness matrix includes public repository settings', finalReadiness.includes('Public repository settings'), 'references/final-readiness.md'),
|
|
185
|
+
check('PRS11', 'consolidated validator includes repository settings audit', validate.includes('audit-public-repository-settings.mjs'), 'scripts/validate-gse.mjs'),
|
|
186
|
+
]
|
|
187
|
+
|
|
188
|
+
const passed = checks.filter((item) => item.status === 'passed').length
|
|
189
|
+
const failed = checks.length - passed
|
|
190
|
+
const report = {
|
|
191
|
+
root,
|
|
192
|
+
generatedAt: new Date().toISOString(),
|
|
193
|
+
fixtureRoot: fixture,
|
|
194
|
+
summary: { status: failed === 0 ? 'passed' : 'failed', passed, failed, total: checks.length },
|
|
195
|
+
workflows: {
|
|
196
|
+
publicRepositorySettings: failed === 0 ? 'verified' : 'failed',
|
|
197
|
+
acceptedRepositorySettings: acceptedOkData?.status === 'ready' ? 'fixture-verified' : 'not-verified',
|
|
198
|
+
},
|
|
199
|
+
limits: [
|
|
200
|
+
'This audit verifies record mechanics and guardrails for public repository settings.',
|
|
201
|
+
'It does not configure a real GitHub repository, branch protection, issue settings, required checks, or maintainer policies.',
|
|
202
|
+
'Accepted public repository settings still require owner/external evidence from the real repository.',
|
|
203
|
+
],
|
|
204
|
+
checks,
|
|
205
|
+
}
|
|
206
|
+
|
|
207
|
+
function renderMarkdown(data) {
|
|
208
|
+
const lines = []
|
|
209
|
+
lines.push('# GSE Public Repository Settings Audit')
|
|
210
|
+
lines.push('')
|
|
211
|
+
lines.push('Generated: ' + data.generatedAt)
|
|
212
|
+
lines.push('Root: ' + data.root)
|
|
213
|
+
lines.push('')
|
|
214
|
+
lines.push('## Summary')
|
|
215
|
+
lines.push('')
|
|
216
|
+
lines.push('- Status: ' + data.summary.status)
|
|
217
|
+
lines.push('- Checks: ' + data.summary.passed + '/' + data.summary.total)
|
|
218
|
+
lines.push('- Public repository settings: ' + data.workflows.publicRepositorySettings)
|
|
219
|
+
lines.push('- Accepted repository settings path: ' + data.workflows.acceptedRepositorySettings)
|
|
220
|
+
lines.push('')
|
|
221
|
+
lines.push('## Checks')
|
|
222
|
+
lines.push('')
|
|
223
|
+
for (const item of data.checks) {
|
|
224
|
+
const marker = item.status === 'passed' ? '[x]' : '[ ]'
|
|
225
|
+
lines.push('- ' + marker + ' ' + item.id + ' ' + item.label + ': ' + item.evidence)
|
|
226
|
+
}
|
|
227
|
+
lines.push('')
|
|
228
|
+
lines.push('## Limits')
|
|
229
|
+
lines.push('')
|
|
230
|
+
for (const item of data.limits) lines.push('- ' + item)
|
|
231
|
+
return lines.join('\n') + '\n'
|
|
232
|
+
}
|
|
233
|
+
|
|
234
|
+
if (jsonOnly) console.log(JSON.stringify(report, null, 2))
|
|
235
|
+
else console.log(renderMarkdown(report))
|
|
236
|
+
|
|
237
|
+
if (failed > 0) process.exit(1)
|