@t275005746/gse 0.1.0 → 0.1.2

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.
Files changed (228) hide show
  1. package/.github/ISSUE_TEMPLATE/bug_report.yml +42 -42
  2. package/.github/ISSUE_TEMPLATE/change_request.yml +50 -50
  3. package/.github/ISSUE_TEMPLATE/config.yml +5 -5
  4. package/.github/PULL_REQUEST_TEMPLATE.md +38 -38
  5. package/.github/workflows/validate-gse.yml +33 -33
  6. package/.gse/README.md +18 -18
  7. package/.gse/gse-development-protocol.md +50 -50
  8. package/.gse/project-profile.md +29 -29
  9. package/.gse/quality-gates.md +25 -25
  10. package/.gse/releases/public-registry-publication-npm.md +49 -0
  11. package/.gse/releases/public-release-owner-required.md +65 -65
  12. package/.gse/releases/public-security-contact-owner-required.md +45 -45
  13. package/.gse/state.json +147 -27
  14. package/CHANGELOG.md +31 -15
  15. package/CONTRIBUTING.md +64 -64
  16. package/LICENSE +21 -21
  17. package/README.md +14 -7
  18. package/README.zh-CN.md +14 -7
  19. package/SECURITY.md +41 -41
  20. package/SKILL.md +32 -12
  21. package/SUPPORT.md +38 -38
  22. package/assets/marketplace/README.md +7 -7
  23. package/assets/marketplace/gse-listing.json +75 -75
  24. package/assets/templates/acceptance-execution-packet.md +73 -73
  25. package/assets/templates/adr.md +14 -14
  26. package/assets/templates/change-brief.md +16 -16
  27. package/assets/templates/design.md +18 -18
  28. package/assets/templates/dispatch-packet.md +100 -92
  29. package/assets/templates/evidence.md +15 -9
  30. package/assets/templates/execution-quality-pack.md +65 -65
  31. package/assets/templates/goal-map.md +21 -21
  32. package/assets/templates/host-adapter.md +48 -48
  33. package/assets/templates/host-ui-invocation-record.md +42 -42
  34. package/assets/templates/incident-review.md +60 -60
  35. package/assets/templates/public-channel-publication-record.md +49 -49
  36. package/assets/templates/public-ci-run-record.md +53 -53
  37. package/assets/templates/public-release-record.md +65 -65
  38. package/assets/templates/public-repository-settings-record.md +59 -59
  39. package/assets/templates/public-security-contact-record.md +45 -45
  40. package/assets/templates/release-trust-record.md +32 -32
  41. package/assets/templates/review.md +18 -18
  42. package/assets/templates/role-fallback-packet.md +49 -0
  43. package/assets/templates/spec.md +16 -16
  44. package/assets/templates/target-adoption-evidence.md +29 -29
  45. package/assets/templates/tasks.md +17 -17
  46. package/assets/templates/update-release-acceptance-record.md +58 -58
  47. package/examples/README.md +22 -22
  48. package/examples/agent-runtime-host/.claude/gse-adapter.md +6 -6
  49. package/examples/agent-runtime-host/.codex/gse-adapter.md +7 -7
  50. package/examples/agent-runtime-host/.gse/goal-map.md +7 -7
  51. package/examples/agent-runtime-host/.gse/project-profile.md +27 -27
  52. package/examples/agent-runtime-host/.gse/tooling.md +5 -5
  53. package/examples/agent-runtime-host/.mcp.json +9 -9
  54. package/examples/agent-runtime-host/AGENTS.md +5 -5
  55. package/examples/agent-runtime-host/README.md +10 -10
  56. package/examples/agent-runtime-host/docs/model-routing.md +5 -5
  57. package/examples/cli-tool/.gse/project-profile.md +21 -21
  58. package/examples/cli-tool/AGENTS.md +5 -5
  59. package/examples/cli-tool/README.md +12 -12
  60. package/examples/cli-tool/package.json +21 -21
  61. package/examples/small-app/.env.example +2 -2
  62. package/examples/small-app/.github/workflows/ci.yml +8 -8
  63. package/examples/small-app/AGENTS.md +5 -5
  64. package/examples/small-app/README.md +12 -12
  65. package/examples/small-app/package.json +26 -26
  66. package/examples/small-app/playwright.config.ts +4 -4
  67. package/package.json +52 -44
  68. package/references/adoption-recipes.md +171 -171
  69. package/references/agent-roles.md +42 -21
  70. package/references/architecture-health.md +101 -101
  71. package/references/benchmark-audit.md +73 -73
  72. package/references/commands.md +74 -45
  73. package/references/community-channels.md +46 -46
  74. package/references/compatibility.md +70 -70
  75. package/references/design-basis.md +38 -38
  76. package/references/domain-model.md +129 -129
  77. package/references/domain-quality-gates.md +75 -75
  78. package/references/drift-audit.md +81 -80
  79. package/references/evidence-taxonomy.md +145 -108
  80. package/references/file-ownership.md +97 -93
  81. package/references/final-form-roadmap.md +201 -0
  82. package/references/final-readiness.md +84 -84
  83. package/references/forward-test.md +133 -133
  84. package/references/goal-map.md +36 -36
  85. package/references/host-adapters.md +129 -101
  86. package/references/learning-system.md +42 -26
  87. package/references/maintenance-cadence.md +51 -0
  88. package/references/marketplace-discovery.md +46 -46
  89. package/references/model-routing.md +103 -103
  90. package/references/open-source-defaults.md +39 -39
  91. package/references/operating-model.md +52 -52
  92. package/references/packaging.md +277 -277
  93. package/references/project-agent-workspace.md +89 -89
  94. package/references/project-bootstrap.md +122 -122
  95. package/references/project-guards.md +52 -0
  96. package/references/project-profile.md +57 -57
  97. package/references/public-release.md +174 -174
  98. package/references/quality-gates.md +96 -89
  99. package/references/recovery.md +176 -176
  100. package/references/release-trust.md +43 -43
  101. package/references/release.md +126 -126
  102. package/references/review.md +141 -141
  103. package/references/role-dispatch-fallback.md +54 -0
  104. package/references/router.md +90 -90
  105. package/references/spec-workflow.md +66 -66
  106. package/references/task-levels.md +81 -81
  107. package/references/tool-adapters.md +80 -70
  108. package/scripts/audit-acceptance-execution-packet.mjs +133 -133
  109. package/scripts/audit-adoption-recipes.mjs +99 -99
  110. package/scripts/audit-change-lifecycle.mjs +77 -77
  111. package/scripts/audit-change-system.mjs +134 -134
  112. package/scripts/audit-ci-readiness.mjs +107 -107
  113. package/scripts/audit-close-gate-hardening.mjs +188 -0
  114. package/scripts/audit-close-gate.mjs +448 -262
  115. package/scripts/audit-command-adapters.mjs +91 -91
  116. package/scripts/audit-command-execution.mjs +212 -199
  117. package/scripts/audit-commands.mjs +7 -5
  118. package/scripts/audit-compatibility.mjs +149 -149
  119. package/scripts/audit-completion-plan-drill.mjs +230 -0
  120. package/scripts/audit-completion-readiness.mjs +290 -287
  121. package/scripts/audit-continue-preflight.mjs +234 -0
  122. package/scripts/audit-distribution.mjs +251 -251
  123. package/scripts/audit-domain-quality-gates.mjs +108 -108
  124. package/scripts/audit-evidence-levels.mjs +217 -0
  125. package/scripts/audit-evidence-placeholders.mjs +126 -126
  126. package/scripts/audit-evidence-review-queue.mjs +206 -0
  127. package/scripts/audit-final-acceptance-packet.mjs +9 -9
  128. package/scripts/audit-final-form-progress-report.mjs +19 -18
  129. package/scripts/audit-final-form-roadmap.mjs +157 -0
  130. package/scripts/audit-final-form-stale-copy.mjs +2 -2
  131. package/scripts/audit-final-readiness-promotion.mjs +255 -255
  132. package/scripts/audit-final-readiness.mjs +226 -226
  133. package/scripts/audit-fixtures.mjs +154 -154
  134. package/scripts/audit-fresh-session-readiness.mjs +177 -177
  135. package/scripts/audit-host-capabilities.mjs +237 -0
  136. package/scripts/audit-host-runtime-evidence-handoff.mjs +159 -159
  137. package/scripts/audit-host-runtime-invocation-drill.mjs +240 -240
  138. package/scripts/audit-host-runtime-invocations.mjs +254 -254
  139. package/scripts/audit-host-ui-invocation.mjs +132 -132
  140. package/scripts/audit-installed-sync.mjs +203 -0
  141. package/scripts/audit-learning-drift.mjs +292 -0
  142. package/scripts/audit-learning-promotion.mjs +351 -0
  143. package/scripts/audit-learning-system.mjs +24 -14
  144. package/scripts/audit-local-final-form-completion.mjs +11 -10
  145. package/scripts/audit-maintenance-cadence.mjs +139 -0
  146. package/scripts/audit-maintenance-snapshot.mjs +181 -0
  147. package/scripts/audit-marketplace-discovery.mjs +122 -122
  148. package/scripts/audit-npm-package-metadata.mjs +160 -154
  149. package/scripts/audit-npm-publish-dry-run.mjs +194 -166
  150. package/scripts/audit-npm-tarball-install.mjs +195 -189
  151. package/scripts/audit-open-source-defaults.mjs +92 -92
  152. package/scripts/audit-open-source-readiness.mjs +97 -97
  153. package/scripts/audit-owner-external-gate-kit.mjs +12 -11
  154. package/scripts/audit-project-guards.mjs +189 -0
  155. package/scripts/audit-project.mjs +144 -141
  156. package/scripts/audit-public-acceptance-command-dry-run-drill.mjs +203 -203
  157. package/scripts/audit-public-acceptance-handoff.mjs +10 -10
  158. package/scripts/audit-public-acceptance-readiness.mjs +222 -222
  159. package/scripts/audit-public-channel-publication.mjs +248 -248
  160. package/scripts/audit-public-ci-run.mjs +184 -184
  161. package/scripts/audit-public-collaboration-templates.mjs +98 -98
  162. package/scripts/audit-public-external-gate-probe.mjs +206 -206
  163. package/scripts/audit-public-release-checklist.mjs +17 -15
  164. package/scripts/audit-public-release-decision.mjs +201 -201
  165. package/scripts/audit-public-release-metadata.mjs +176 -176
  166. package/scripts/audit-public-repository-settings.mjs +237 -237
  167. package/scripts/audit-public-security-contact.mjs +171 -171
  168. package/scripts/audit-readme-docs.mjs +6 -4
  169. package/scripts/audit-recovery-readiness.mjs +98 -98
  170. package/scripts/audit-release-bundle.mjs +13 -11
  171. package/scripts/audit-release-owner-action-plan-drill.mjs +5 -4
  172. package/scripts/audit-release-owner-action-plan.mjs +10 -10
  173. package/scripts/audit-release-readiness.mjs +106 -106
  174. package/scripts/audit-release-status-manifest.mjs +4 -4
  175. package/scripts/audit-release-trust.mjs +62 -62
  176. package/scripts/audit-remote-distribution.mjs +266 -266
  177. package/scripts/audit-roadmap-consistency.mjs +234 -230
  178. package/scripts/audit-role-dispatch-fallback.mjs +212 -0
  179. package/scripts/audit-session-sync.mjs +127 -0
  180. package/scripts/audit-signing.mjs +147 -147
  181. package/scripts/audit-state-freshness.mjs +20 -14
  182. package/scripts/audit-state-repair.mjs +360 -0
  183. package/scripts/audit-target-adoption-evidence.mjs +117 -117
  184. package/scripts/audit-target-hardening-drills.mjs +267 -0
  185. package/scripts/audit-target-project.mjs +507 -507
  186. package/scripts/audit-tool-fallback-policy.mjs +180 -0
  187. package/scripts/audit-ui-browser-evidence-policy.mjs +191 -0
  188. package/scripts/audit-update-release-acceptance.mjs +136 -136
  189. package/scripts/audit-v1-target-validation.mjs +269 -269
  190. package/scripts/audit-validation-profiles.mjs +125 -123
  191. package/scripts/backfill-evidence-levels.mjs +98 -0
  192. package/scripts/check-encoding.mjs +72 -0
  193. package/scripts/close-change.mjs +116 -116
  194. package/scripts/discover-project-profile.mjs +307 -307
  195. package/scripts/generate-command-adapter.mjs +231 -231
  196. package/scripts/generate-continue-packet.mjs +1214 -0
  197. package/scripts/generate-final-acceptance-packet.mjs +188 -173
  198. package/scripts/generate-final-form-progress-report.mjs +191 -189
  199. package/scripts/generate-host-runtime-evidence-handoff.mjs +198 -191
  200. package/scripts/generate-maintenance-snapshot.mjs +216 -0
  201. package/scripts/generate-owner-external-gate-kit.mjs +295 -295
  202. package/scripts/generate-public-acceptance-handoff.mjs +168 -156
  203. package/scripts/generate-public-release-checklist.mjs +207 -207
  204. package/scripts/generate-release-bundle.mjs +505 -505
  205. package/scripts/generate-release-owner-action-plan.mjs +172 -171
  206. package/scripts/generate-release-status-manifest.mjs +199 -198
  207. package/scripts/generate-session-prompt.mjs +188 -188
  208. package/scripts/gse.mjs +67 -67
  209. package/scripts/init-change.mjs +265 -265
  210. package/scripts/init-project.mjs +793 -712
  211. package/scripts/install-gse.mjs +234 -234
  212. package/scripts/lib/evidence-placeholders.mjs +28 -28
  213. package/scripts/package-gse.mjs +174 -174
  214. package/scripts/probe-public-external-gates.mjs +167 -167
  215. package/scripts/record-host-invocation.mjs +151 -151
  216. package/scripts/record-learning.mjs +37 -8
  217. package/scripts/record-public-channel-publication.mjs +178 -178
  218. package/scripts/record-public-ci-run.mjs +180 -180
  219. package/scripts/record-public-release.mjs +175 -175
  220. package/scripts/record-public-repository-settings.mjs +209 -209
  221. package/scripts/record-public-security-contact.mjs +157 -157
  222. package/scripts/record-session-sync.mjs +87 -0
  223. package/scripts/run-gse-command.mjs +79 -47
  224. package/scripts/run-validation-profile.mjs +24 -5
  225. package/scripts/sign-gse-package.mjs +83 -83
  226. package/scripts/update-project-state.mjs +223 -223
  227. package/scripts/validate-gse.mjs +216 -0
  228. package/scripts/verify-gse-package.mjs +85 -85
@@ -1,206 +1,206 @@
1
- #!/usr/bin/env node
2
- import fs from 'node:fs'
3
- import http from 'node:http'
4
- import os from 'node:os'
5
- import path from 'node:path'
6
- import { spawn, spawnSync } from 'node:child_process'
7
-
8
- const args = process.argv.slice(2)
9
-
10
- function readArg(name, fallback = null) {
11
- const index = args.indexOf(name)
12
- if (index === -1) return fallback
13
- return args[index + 1] ?? fallback
14
- }
15
-
16
- const root = path.resolve(readArg('--root', path.join(import.meta.dirname, '..')))
17
- const jsonOnly = args.includes('--json')
18
-
19
- function read(relativePath) {
20
- const fullPath = path.join(root, relativePath)
21
- return fs.existsSync(fullPath) ? fs.readFileSync(fullPath, 'utf8') : ''
22
- }
23
-
24
- function exists(relativePath) {
25
- return fs.existsSync(path.join(root, relativePath))
26
- }
27
-
28
- function run(command, commandArgs) {
29
- const result = spawnSync(command, commandArgs, {
30
- cwd: root,
31
- encoding: 'utf8',
32
- windowsHide: true,
33
- })
34
- return {
35
- status: result.status ?? 1,
36
- stdout: (result.stdout ?? '').trim(),
37
- stderr: (result.stderr ?? '').trim(),
38
- command: [command, ...commandArgs].join(' '),
39
- }
40
- }
41
-
42
- function runAsync(command, commandArgs) {
43
- return new Promise((resolve) => {
44
- const child = spawn(command, commandArgs, {
45
- cwd: root,
46
- windowsHide: true,
47
- stdio: ['ignore', 'pipe', 'pipe'],
48
- })
49
- let stdout = ''
50
- let stderr = ''
51
- child.stdout.setEncoding('utf8')
52
- child.stderr.setEncoding('utf8')
53
- child.stdout.on('data', (chunk) => {
54
- stdout += chunk
55
- })
56
- child.stderr.on('data', (chunk) => {
57
- stderr += chunk
58
- })
59
- child.on('close', (status) => {
60
- resolve({
61
- status: status ?? 1,
62
- stdout: stdout.trim(),
63
- stderr: stderr.trim(),
64
- command: [command, ...commandArgs].join(' '),
65
- })
66
- })
67
- })
68
- }
69
-
70
- function parseJson(stdout) {
71
- try {
72
- return JSON.parse(stdout)
73
- } catch {
74
- return null
75
- }
76
- }
77
-
78
- function check(id, label, ok, evidence, risk = '') {
79
- return { id, label, status: ok ? 'passed' : 'failed', evidence, risk }
80
- }
81
-
82
- function startServer() {
83
- const server = http.createServer((request, response) => {
84
- response.writeHead(200, { 'content-type': 'text/plain; charset=utf-8' })
85
- response.end('gse fixture evidence\n')
86
- })
87
- return new Promise((resolve, reject) => {
88
- server.once('error', reject)
89
- server.listen(0, '127.0.0.1', () => {
90
- const address = server.address()
91
- resolve({ server, url: `http://127.0.0.1:${address.port}` })
92
- })
93
- })
94
- }
95
-
96
- const probeScript = path.join(root, 'scripts', 'probe-public-external-gates.mjs')
97
- const fixture = fs.mkdtempSync(path.join(os.tmpdir(), 'gse-public-external-probe-'))
98
- const hostEvidence = path.join(fixture, 'host-evidence.txt')
99
- fs.writeFileSync(hostEvidence, 'fixture host transcript\n', 'utf8')
100
- const { server, url } = await startServer()
101
-
102
- let positive
103
- let negativePlaceholder
104
- let negativeMissingFile
105
- let waiting
106
- try {
107
- positive = await runAsync(process.execPath, [
108
- probeScript,
109
- '--root', root,
110
- '--allow-local-fixture',
111
- '--timeout-ms', '3000',
112
- '--public-repo-url', `${url}/repo`,
113
- '--security-contact-url', `${url}/security`,
114
- '--public-ci-run-url', `${url}/ci`,
115
- '--registry-package-url', `${url}/package`,
116
- '--marketplace-url', `${url}/marketplace`,
117
- '--native-host-evidence', hostEvidence,
118
- '--other-host-evidence', `${url}/host`,
119
- '--json',
120
- ])
121
- negativePlaceholder = run(process.execPath, [
122
- probeScript,
123
- '--root', root,
124
- '--public-repo-url', 'https://github.com/example/gse',
125
- '--registry-package-url', 'https://example.com/gse',
126
- '--json',
127
- ])
128
- negativeMissingFile = run(process.execPath, [
129
- probeScript,
130
- '--root', root,
131
- '--native-host-evidence', path.join(fixture, 'missing.txt'),
132
- '--json',
133
- ])
134
- waiting = run(process.execPath, [probeScript, '--root', root, '--json'])
135
- } finally {
136
- await new Promise((resolve) => server.close(resolve))
137
- fs.rmSync(fixture, { recursive: true, force: true })
138
- }
139
-
140
- const positiveData = parseJson(positive.stdout)
141
- const negativePlaceholderData = parseJson(negativePlaceholder.stdout)
142
- const negativeMissingFileData = parseJson(negativeMissingFile.stdout)
143
- const waitingData = parseJson(waiting.stdout)
144
- const skill = read('SKILL.md')
145
- const validate = read('scripts/validate-gse.mjs')
146
- const completion = read('scripts/audit-completion-readiness.mjs')
147
- const ownerKitGenerator = read('scripts/generate-owner-external-gate-kit.mjs')
148
- const verificationCommands = read('.gse/acceptance/owner-external-gate-kit/verification-commands.md')
149
-
150
- const checks = [
151
- check('PEG01', 'public external gate probe exists', exists('scripts/probe-public-external-gates.mjs'), 'scripts/probe-public-external-gates.mjs'),
152
- check('PEG02', 'probe accepts reachable evidence locations in fixture mode', positive.status === 0 && positiveData?.status === 'ready' && positiveData?.summary?.checked === 7 && positiveData?.summary?.failed === 0, positive.command),
153
- check('PEG03', 'probe rejects placeholder and example public evidence', negativePlaceholder.status !== 0 && negativePlaceholderData?.status === 'failed' && negativePlaceholderData?.probes?.some((item) => item.errors?.some((error) => error.includes('not a placeholder'))), negativePlaceholder.command),
154
- check('PEG04', 'probe rejects missing host evidence files', negativeMissingFile.status !== 0 && negativeMissingFileData?.status === 'failed' && negativeMissingFileData?.probes?.some((item) => item.errors?.some((error) => error.includes('existing evidence file'))), negativeMissingFile.command),
155
- check('PEG05', 'probe can run without evidence inputs as a waiting diagnostic', waiting.status === 0 && waitingData?.status === 'waiting-for-input' && waitingData?.summary?.checked === 0, waiting.command),
156
- check('PEG06', 'probe keeps acceptance boundary explicit', positiveData?.limits?.some((item) => item.includes('does not publish GSE')) && positiveData?.limits?.some((item) => item.includes('record script')), 'probe report limits'),
157
- check('PEG07', 'GSE routing and owner kit mention the portable probe command', skill.includes('probe-public-external-gates.mjs') && ownerKitGenerator.includes('run-gse-command.mjs') && ownerKitGenerator.includes('/gse probe') && verificationCommands.includes('run-gse-command.mjs') && verificationCommands.includes('/gse probe') && !verificationCommands.includes('node scripts/probe-public-external-gates.mjs'), 'SKILL.md, generate-owner-external-gate-kit.mjs, owner kit verification commands'),
158
- check('PEG08', 'validator and completion readiness include the probe audit', validate.includes('audit-public-external-gate-probe.mjs') && completion.includes('audit-public-external-gate-probe.mjs'), 'scripts/validate-gse.mjs, scripts/audit-completion-readiness.mjs'),
159
- ]
160
-
161
- const passed = checks.filter((item) => item.status === 'passed').length
162
- const failed = checks.length - passed
163
- const report = {
164
- root,
165
- generatedAt: new Date().toISOString(),
166
- summary: { status: failed === 0 ? 'passed' : 'failed', passed, failed, total: checks.length },
167
- workflows: {
168
- publicExternalGateProbe: failed === 0 ? 'verified' : 'failed',
169
- },
170
- limits: [
171
- 'This audit verifies the probe mechanics with fixture evidence.',
172
- 'It does not create real public owner/external evidence or mark final readiness accepted.',
173
- ],
174
- checks,
175
- }
176
-
177
- function renderMarkdown(data) {
178
- const lines = []
179
- lines.push('# GSE Public External Gate Probe Audit')
180
- lines.push('')
181
- lines.push('Generated: ' + data.generatedAt)
182
- lines.push('Root: ' + data.root)
183
- lines.push('')
184
- lines.push('## Summary')
185
- lines.push('')
186
- lines.push('- Status: ' + data.summary.status)
187
- lines.push('- Checks: ' + data.summary.passed + '/' + data.summary.total)
188
- lines.push('- Public external gate probe: ' + data.workflows.publicExternalGateProbe)
189
- lines.push('')
190
- lines.push('## Checks')
191
- lines.push('')
192
- for (const item of data.checks) {
193
- const marker = item.status === 'passed' ? '[x]' : '[ ]'
194
- lines.push('- ' + marker + ' ' + item.id + ' ' + item.label + ': ' + item.evidence)
195
- }
196
- lines.push('')
197
- lines.push('## Limits')
198
- lines.push('')
199
- for (const item of data.limits) lines.push('- ' + item)
200
- return lines.join('\n') + '\n'
201
- }
202
-
203
- if (jsonOnly) console.log(JSON.stringify(report, null, 2))
204
- else console.log(renderMarkdown(report))
205
-
206
- if (failed > 0) process.exit(1)
1
+ #!/usr/bin/env node
2
+ import fs from 'node:fs'
3
+ import http from 'node:http'
4
+ import os from 'node:os'
5
+ import path from 'node:path'
6
+ import { spawn, spawnSync } from 'node:child_process'
7
+
8
+ const args = process.argv.slice(2)
9
+
10
+ function readArg(name, fallback = null) {
11
+ const index = args.indexOf(name)
12
+ if (index === -1) return fallback
13
+ return args[index + 1] ?? fallback
14
+ }
15
+
16
+ const root = path.resolve(readArg('--root', path.join(import.meta.dirname, '..')))
17
+ const jsonOnly = args.includes('--json')
18
+
19
+ function read(relativePath) {
20
+ const fullPath = path.join(root, relativePath)
21
+ return fs.existsSync(fullPath) ? fs.readFileSync(fullPath, 'utf8') : ''
22
+ }
23
+
24
+ function exists(relativePath) {
25
+ return fs.existsSync(path.join(root, relativePath))
26
+ }
27
+
28
+ function run(command, commandArgs) {
29
+ const result = spawnSync(command, commandArgs, {
30
+ cwd: root,
31
+ encoding: 'utf8',
32
+ windowsHide: true,
33
+ })
34
+ return {
35
+ status: result.status ?? 1,
36
+ stdout: (result.stdout ?? '').trim(),
37
+ stderr: (result.stderr ?? '').trim(),
38
+ command: [command, ...commandArgs].join(' '),
39
+ }
40
+ }
41
+
42
+ function runAsync(command, commandArgs) {
43
+ return new Promise((resolve) => {
44
+ const child = spawn(command, commandArgs, {
45
+ cwd: root,
46
+ windowsHide: true,
47
+ stdio: ['ignore', 'pipe', 'pipe'],
48
+ })
49
+ let stdout = ''
50
+ let stderr = ''
51
+ child.stdout.setEncoding('utf8')
52
+ child.stderr.setEncoding('utf8')
53
+ child.stdout.on('data', (chunk) => {
54
+ stdout += chunk
55
+ })
56
+ child.stderr.on('data', (chunk) => {
57
+ stderr += chunk
58
+ })
59
+ child.on('close', (status) => {
60
+ resolve({
61
+ status: status ?? 1,
62
+ stdout: stdout.trim(),
63
+ stderr: stderr.trim(),
64
+ command: [command, ...commandArgs].join(' '),
65
+ })
66
+ })
67
+ })
68
+ }
69
+
70
+ function parseJson(stdout) {
71
+ try {
72
+ return JSON.parse(stdout)
73
+ } catch {
74
+ return null
75
+ }
76
+ }
77
+
78
+ function check(id, label, ok, evidence, risk = '') {
79
+ return { id, label, status: ok ? 'passed' : 'failed', evidence, risk }
80
+ }
81
+
82
+ function startServer() {
83
+ const server = http.createServer((request, response) => {
84
+ response.writeHead(200, { 'content-type': 'text/plain; charset=utf-8' })
85
+ response.end('gse fixture evidence\n')
86
+ })
87
+ return new Promise((resolve, reject) => {
88
+ server.once('error', reject)
89
+ server.listen(0, '127.0.0.1', () => {
90
+ const address = server.address()
91
+ resolve({ server, url: `http://127.0.0.1:${address.port}` })
92
+ })
93
+ })
94
+ }
95
+
96
+ const probeScript = path.join(root, 'scripts', 'probe-public-external-gates.mjs')
97
+ const fixture = fs.mkdtempSync(path.join(os.tmpdir(), 'gse-public-external-probe-'))
98
+ const hostEvidence = path.join(fixture, 'host-evidence.txt')
99
+ fs.writeFileSync(hostEvidence, 'fixture host transcript\n', 'utf8')
100
+ const { server, url } = await startServer()
101
+
102
+ let positive
103
+ let negativePlaceholder
104
+ let negativeMissingFile
105
+ let waiting
106
+ try {
107
+ positive = await runAsync(process.execPath, [
108
+ probeScript,
109
+ '--root', root,
110
+ '--allow-local-fixture',
111
+ '--timeout-ms', '3000',
112
+ '--public-repo-url', `${url}/repo`,
113
+ '--security-contact-url', `${url}/security`,
114
+ '--public-ci-run-url', `${url}/ci`,
115
+ '--registry-package-url', `${url}/package`,
116
+ '--marketplace-url', `${url}/marketplace`,
117
+ '--native-host-evidence', hostEvidence,
118
+ '--other-host-evidence', `${url}/host`,
119
+ '--json',
120
+ ])
121
+ negativePlaceholder = run(process.execPath, [
122
+ probeScript,
123
+ '--root', root,
124
+ '--public-repo-url', 'https://github.com/example/gse',
125
+ '--registry-package-url', 'https://example.com/gse',
126
+ '--json',
127
+ ])
128
+ negativeMissingFile = run(process.execPath, [
129
+ probeScript,
130
+ '--root', root,
131
+ '--native-host-evidence', path.join(fixture, 'missing.txt'),
132
+ '--json',
133
+ ])
134
+ waiting = run(process.execPath, [probeScript, '--root', root, '--json'])
135
+ } finally {
136
+ await new Promise((resolve) => server.close(resolve))
137
+ fs.rmSync(fixture, { recursive: true, force: true })
138
+ }
139
+
140
+ const positiveData = parseJson(positive.stdout)
141
+ const negativePlaceholderData = parseJson(negativePlaceholder.stdout)
142
+ const negativeMissingFileData = parseJson(negativeMissingFile.stdout)
143
+ const waitingData = parseJson(waiting.stdout)
144
+ const skill = read('SKILL.md')
145
+ const validate = read('scripts/validate-gse.mjs')
146
+ const completion = read('scripts/audit-completion-readiness.mjs')
147
+ const ownerKitGenerator = read('scripts/generate-owner-external-gate-kit.mjs')
148
+ const verificationCommands = read('.gse/acceptance/owner-external-gate-kit/verification-commands.md')
149
+
150
+ const checks = [
151
+ check('PEG01', 'public external gate probe exists', exists('scripts/probe-public-external-gates.mjs'), 'scripts/probe-public-external-gates.mjs'),
152
+ check('PEG02', 'probe accepts reachable evidence locations in fixture mode', positive.status === 0 && positiveData?.status === 'ready' && positiveData?.summary?.checked === 7 && positiveData?.summary?.failed === 0, positive.command),
153
+ check('PEG03', 'probe rejects placeholder and example public evidence', negativePlaceholder.status !== 0 && negativePlaceholderData?.status === 'failed' && negativePlaceholderData?.probes?.some((item) => item.errors?.some((error) => error.includes('not a placeholder'))), negativePlaceholder.command),
154
+ check('PEG04', 'probe rejects missing host evidence files', negativeMissingFile.status !== 0 && negativeMissingFileData?.status === 'failed' && negativeMissingFileData?.probes?.some((item) => item.errors?.some((error) => error.includes('existing evidence file'))), negativeMissingFile.command),
155
+ check('PEG05', 'probe can run without evidence inputs as a waiting diagnostic', waiting.status === 0 && waitingData?.status === 'waiting-for-input' && waitingData?.summary?.checked === 0, waiting.command),
156
+ check('PEG06', 'probe keeps acceptance boundary explicit', positiveData?.limits?.some((item) => item.includes('does not publish GSE')) && positiveData?.limits?.some((item) => item.includes('record script')), 'probe report limits'),
157
+ check('PEG07', 'GSE routing and owner kit mention the portable probe command', skill.includes('probe-public-external-gates.mjs') && ownerKitGenerator.includes('run-gse-command.mjs') && ownerKitGenerator.includes('/gse probe') && verificationCommands.includes('run-gse-command.mjs') && verificationCommands.includes('/gse probe') && !verificationCommands.includes('node scripts/probe-public-external-gates.mjs'), 'SKILL.md, generate-owner-external-gate-kit.mjs, owner kit verification commands'),
158
+ check('PEG08', 'validator and completion readiness include the probe audit', validate.includes('audit-public-external-gate-probe.mjs') && completion.includes('audit-public-external-gate-probe.mjs'), 'scripts/validate-gse.mjs, scripts/audit-completion-readiness.mjs'),
159
+ ]
160
+
161
+ const passed = checks.filter((item) => item.status === 'passed').length
162
+ const failed = checks.length - passed
163
+ const report = {
164
+ root,
165
+ generatedAt: new Date().toISOString(),
166
+ summary: { status: failed === 0 ? 'passed' : 'failed', passed, failed, total: checks.length },
167
+ workflows: {
168
+ publicExternalGateProbe: failed === 0 ? 'verified' : 'failed',
169
+ },
170
+ limits: [
171
+ 'This audit verifies the probe mechanics with fixture evidence.',
172
+ 'It does not create real public owner/external evidence or mark final readiness accepted.',
173
+ ],
174
+ checks,
175
+ }
176
+
177
+ function renderMarkdown(data) {
178
+ const lines = []
179
+ lines.push('# GSE Public External Gate Probe Audit')
180
+ lines.push('')
181
+ lines.push('Generated: ' + data.generatedAt)
182
+ lines.push('Root: ' + data.root)
183
+ lines.push('')
184
+ lines.push('## Summary')
185
+ lines.push('')
186
+ lines.push('- Status: ' + data.summary.status)
187
+ lines.push('- Checks: ' + data.summary.passed + '/' + data.summary.total)
188
+ lines.push('- Public external gate probe: ' + data.workflows.publicExternalGateProbe)
189
+ lines.push('')
190
+ lines.push('## Checks')
191
+ lines.push('')
192
+ for (const item of data.checks) {
193
+ const marker = item.status === 'passed' ? '[x]' : '[ ]'
194
+ lines.push('- ' + marker + ' ' + item.id + ' ' + item.label + ': ' + item.evidence)
195
+ }
196
+ lines.push('')
197
+ lines.push('## Limits')
198
+ lines.push('')
199
+ for (const item of data.limits) lines.push('- ' + item)
200
+ return lines.join('\n') + '\n'
201
+ }
202
+
203
+ if (jsonOnly) console.log(JSON.stringify(report, null, 2))
204
+ else console.log(renderMarkdown(report))
205
+
206
+ if (failed > 0) process.exit(1)
@@ -66,8 +66,9 @@ const checklistData = checklistRun ? parseJson(checklistRun.stdout) : null
66
66
  const canonicalChecklist = read('.gse/acceptance/public-release-checklist.md')
67
67
  rmSync(tmp, { recursive: true, force: true })
68
68
 
69
- const pendingGates = manifest?.publicAcceptance?.pendingGates ?? []
70
- const expectedAreas = pendingGates.map((gate) => gate.area)
69
+ const pendingGates = manifest?.publicAcceptance?.pendingGates ?? []
70
+ const hasPendingGates = pendingGates.length > 0
71
+ const expectedAreas = pendingGates.map((gate) => gate.area)
71
72
  const requiredPhases = [
72
73
  '01. Prepare the release bundle',
73
74
  '02. Publish and configure the public repository',
@@ -82,24 +83,25 @@ const expectedScripts = [...new Set(pendingGates
82
83
  .map((gate) => String(gate.recordCommand ?? '').match(/scripts\/([\w-]+\.mjs)/)?.[1])
83
84
  .filter(Boolean))]
84
85
  const noLocalPaths = !/[A-Z]:\\|C:\\Users\\|D:\\codex\\/i.test(checklist) && !/[A-Z]:\\|C:\\Users\\|D:\\codex\\/i.test(canonicalChecklist)
85
- const noFalseAcceptance = checklist.includes('Public accepted: not-accepted') &&
86
- checklist.includes('does not publish, approve, or accept') &&
87
- checklist.includes('A gate is complete only after real accepted evidence')
88
- const commandCoverage = expectedScripts.every((script) => checklist.includes(script)) &&
89
- checklist.includes('/gse release') &&
90
- checklist.includes('/gse release --execute --out <bundle>') &&
91
- checklist.includes('/gse probe')
92
- const canonicalFresh = canonicalChecklist.includes('GSE Public Release Checklist') &&
93
- requiredPhases.every((phase) => canonicalChecklist.includes(phase)) &&
94
- expectedAreas.every((area) => canonicalChecklist.includes(`Gate: ${area}`)) &&
95
- canonicalChecklist.includes(`Pending owner/external gates: ${pendingGates.length}`)
86
+ const publicAcceptedStatus = manifest?.publicAcceptance?.publicAccepted ?? 'unknown'
87
+ const noFalseAcceptance = checklist.includes('Public accepted: ' + publicAcceptedStatus) &&
88
+ checklist.includes('does not publish, approve, or accept') &&
89
+ checklist.includes('A gate is complete only after real accepted evidence')
90
+ const commandCoverage = (hasPendingGates ? expectedScripts.every((script) => checklist.includes(script)) : true) &&
91
+ checklist.includes('/gse release') &&
92
+ checklist.includes('/gse release --execute --out <bundle>') &&
93
+ checklist.includes('/gse probe')
94
+ const canonicalFresh = canonicalChecklist.includes('GSE Public Release Checklist') &&
95
+ requiredPhases.every((phase) => canonicalChecklist.includes(phase)) &&
96
+ (hasPendingGates ? expectedAreas.every((area) => canonicalChecklist.includes(`Gate: ${area}`)) : canonicalChecklist.includes('Public accepted: verified')) &&
97
+ canonicalChecklist.includes(`Pending owner/external gates: ${pendingGates.length}`)
96
98
 
97
99
  const checks = [
98
100
  check('PRC01', 'public release checklist generator exists', exists('scripts/generate-public-release-checklist.mjs'), 'scripts/generate-public-release-checklist.mjs'),
99
101
  check('PRC02', 'generator writes checklist from release status manifest', checklistRun?.status === 0 && checklistData?.status === 'written' && checklist.includes('GSE Public Release Checklist'), 'generate-public-release-checklist.mjs'),
100
102
  check('PRC03', 'checklist uses ordered public release runway phases', requiredPhases.every((phase) => checklist.includes(phase)), 'public-release-checklist.md'),
101
- check('PRC04', 'checklist covers every pending owner/external gate', expectedAreas.length > 0 && expectedAreas.every((area) => checklist.includes(`Gate: ${area}`)), 'release-status-manifest pending gates'),
102
- check('PRC05', 'checklist includes executable preflight and record command families', commandCoverage && checklist.includes('Preflight:') && checklist.includes('Record accepted evidence:'), 'public-release-checklist.md'),
103
+ check('PRC04', 'checklist covers every pending owner/external gate', hasPendingGates ? expectedAreas.every((area) => checklist.includes(`Gate: ${area}`)) : checklist.includes('Pending owner/external gates: 0'), 'release-status-manifest pending gates'),
104
+ check('PRC05', 'checklist includes executable preflight and record command families', commandCoverage && (hasPendingGates ? (checklist.includes('Preflight:') && checklist.includes('Record accepted evidence:')) : checklist.includes('Final Verification')), 'public-release-checklist.md'),
103
105
  check('PRC06', 'checklist preserves public acceptance boundary', noFalseAcceptance, 'public-release-checklist.md'),
104
106
  check('PRC07', 'checklist avoids local machine paths', noLocalPaths, 'public-release-checklist.md'),
105
107
  check('PRC08', 'canonical checklist is fresh against current manifest', canonicalFresh, '.gse/acceptance/public-release-checklist.md'),