@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.
Files changed (180) 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 +3 -4
  14. package/CHANGELOG.md +24 -24
  15. package/CONTRIBUTING.md +64 -64
  16. package/LICENSE +21 -21
  17. package/README.md +1 -1
  18. package/README.zh-CN.md +1 -1
  19. package/SECURITY.md +41 -41
  20. package/SUPPORT.md +38 -38
  21. package/assets/marketplace/README.md +7 -7
  22. package/assets/marketplace/gse-listing.json +75 -75
  23. package/assets/templates/acceptance-execution-packet.md +73 -73
  24. package/assets/templates/adr.md +14 -14
  25. package/assets/templates/change-brief.md +16 -16
  26. package/assets/templates/design.md +18 -18
  27. package/assets/templates/dispatch-packet.md +104 -104
  28. package/assets/templates/evidence.md +14 -14
  29. package/assets/templates/execution-quality-pack.md +65 -65
  30. package/assets/templates/goal-map.md +21 -21
  31. package/assets/templates/host-adapter.md +48 -48
  32. package/assets/templates/host-ui-invocation-record.md +42 -42
  33. package/assets/templates/incident-review.md +60 -60
  34. package/assets/templates/public-channel-publication-record.md +49 -49
  35. package/assets/templates/public-ci-run-record.md +53 -53
  36. package/assets/templates/public-release-record.md +65 -65
  37. package/assets/templates/public-repository-settings-record.md +59 -59
  38. package/assets/templates/public-security-contact-record.md +45 -45
  39. package/assets/templates/release-trust-record.md +32 -32
  40. package/assets/templates/review.md +18 -18
  41. package/assets/templates/spec.md +16 -16
  42. package/assets/templates/target-adoption-evidence.md +29 -29
  43. package/assets/templates/tasks.md +17 -17
  44. package/assets/templates/update-release-acceptance-record.md +58 -58
  45. package/examples/README.md +22 -22
  46. package/examples/agent-runtime-host/.claude/gse-adapter.md +6 -6
  47. package/examples/agent-runtime-host/.codex/gse-adapter.md +7 -7
  48. package/examples/agent-runtime-host/.gse/goal-map.md +7 -7
  49. package/examples/agent-runtime-host/.gse/project-profile.md +27 -27
  50. package/examples/agent-runtime-host/.gse/tooling.md +5 -5
  51. package/examples/agent-runtime-host/.mcp.json +9 -9
  52. package/examples/agent-runtime-host/AGENTS.md +5 -5
  53. package/examples/agent-runtime-host/README.md +10 -10
  54. package/examples/agent-runtime-host/docs/model-routing.md +5 -5
  55. package/examples/cli-tool/.gse/project-profile.md +21 -21
  56. package/examples/cli-tool/AGENTS.md +5 -5
  57. package/examples/cli-tool/README.md +12 -12
  58. package/examples/cli-tool/package.json +21 -21
  59. package/examples/small-app/.env.example +2 -2
  60. package/examples/small-app/.github/workflows/ci.yml +8 -8
  61. package/examples/small-app/AGENTS.md +5 -5
  62. package/examples/small-app/README.md +12 -12
  63. package/examples/small-app/package.json +26 -26
  64. package/examples/small-app/playwright.config.ts +4 -4
  65. package/package.json +53 -53
  66. package/references/adoption-recipes.md +171 -171
  67. package/references/agent-roles.md +49 -49
  68. package/references/architecture-health.md +101 -101
  69. package/references/benchmark-audit.md +73 -73
  70. package/references/community-channels.md +46 -46
  71. package/references/compatibility.md +70 -70
  72. package/references/design-basis.md +38 -38
  73. package/references/domain-model.md +129 -129
  74. package/references/domain-quality-gates.md +75 -75
  75. package/references/drift-audit.md +81 -81
  76. package/references/evidence-taxonomy.md +123 -123
  77. package/references/file-ownership.md +107 -107
  78. package/references/final-readiness.md +84 -84
  79. package/references/forward-test.md +133 -133
  80. package/references/goal-map.md +36 -36
  81. package/references/host-adapters.md +119 -119
  82. package/references/learning-system.md +35 -35
  83. package/references/marketplace-discovery.md +46 -46
  84. package/references/model-routing.md +103 -103
  85. package/references/open-source-defaults.md +39 -39
  86. package/references/operating-model.md +52 -52
  87. package/references/packaging.md +277 -277
  88. package/references/project-agent-workspace.md +89 -89
  89. package/references/project-bootstrap.md +122 -122
  90. package/references/project-profile.md +57 -57
  91. package/references/public-release.md +174 -174
  92. package/references/quality-gates.md +100 -100
  93. package/references/recovery.md +176 -176
  94. package/references/release-trust.md +43 -43
  95. package/references/release.md +126 -126
  96. package/references/review.md +141 -141
  97. package/references/router.md +90 -90
  98. package/references/spec-workflow.md +66 -66
  99. package/references/task-levels.md +81 -81
  100. package/references/tool-adapters.md +73 -73
  101. package/scripts/audit-acceptance-execution-packet.mjs +133 -133
  102. package/scripts/audit-adoption-recipes.mjs +99 -99
  103. package/scripts/audit-change-lifecycle.mjs +77 -77
  104. package/scripts/audit-change-system.mjs +134 -134
  105. package/scripts/audit-ci-readiness.mjs +107 -107
  106. package/scripts/audit-close-gate.mjs +323 -323
  107. package/scripts/audit-command-adapters.mjs +91 -91
  108. package/scripts/audit-command-execution.mjs +210 -210
  109. package/scripts/audit-compatibility.mjs +149 -149
  110. package/scripts/audit-completion-readiness.mjs +292 -292
  111. package/scripts/audit-distribution.mjs +251 -251
  112. package/scripts/audit-domain-quality-gates.mjs +108 -108
  113. package/scripts/audit-evidence-placeholders.mjs +126 -126
  114. package/scripts/audit-final-readiness-promotion.mjs +255 -255
  115. package/scripts/audit-final-readiness.mjs +226 -226
  116. package/scripts/audit-fixtures.mjs +154 -154
  117. package/scripts/audit-fresh-session-readiness.mjs +177 -177
  118. package/scripts/audit-host-runtime-evidence-handoff.mjs +159 -159
  119. package/scripts/audit-host-runtime-invocation-drill.mjs +240 -240
  120. package/scripts/audit-host-runtime-invocations.mjs +254 -254
  121. package/scripts/audit-host-ui-invocation.mjs +132 -132
  122. package/scripts/audit-marketplace-discovery.mjs +122 -122
  123. package/scripts/audit-npm-package-metadata.mjs +155 -155
  124. package/scripts/audit-npm-publish-dry-run.mjs +191 -169
  125. package/scripts/audit-npm-tarball-install.mjs +191 -191
  126. package/scripts/audit-open-source-defaults.mjs +92 -92
  127. package/scripts/audit-open-source-readiness.mjs +97 -97
  128. package/scripts/audit-project.mjs +138 -138
  129. package/scripts/audit-public-acceptance-command-dry-run-drill.mjs +203 -203
  130. package/scripts/audit-public-acceptance-readiness.mjs +224 -224
  131. package/scripts/audit-public-channel-publication.mjs +248 -248
  132. package/scripts/audit-public-ci-run.mjs +184 -184
  133. package/scripts/audit-public-collaboration-templates.mjs +98 -98
  134. package/scripts/audit-public-external-gate-probe.mjs +206 -206
  135. package/scripts/audit-public-release-decision.mjs +201 -201
  136. package/scripts/audit-public-release-metadata.mjs +176 -176
  137. package/scripts/audit-public-repository-settings.mjs +237 -237
  138. package/scripts/audit-public-security-contact.mjs +171 -171
  139. package/scripts/audit-readme-docs.mjs +6 -4
  140. package/scripts/audit-recovery-readiness.mjs +98 -98
  141. package/scripts/audit-release-readiness.mjs +106 -106
  142. package/scripts/audit-release-trust.mjs +62 -62
  143. package/scripts/audit-remote-distribution.mjs +266 -266
  144. package/scripts/audit-roadmap-consistency.mjs +235 -235
  145. package/scripts/audit-signing.mjs +147 -147
  146. package/scripts/audit-state-freshness.mjs +14 -9
  147. package/scripts/audit-target-adoption-evidence.mjs +117 -117
  148. package/scripts/audit-target-project.mjs +507 -507
  149. package/scripts/audit-update-release-acceptance.mjs +136 -136
  150. package/scripts/audit-v1-target-validation.mjs +269 -269
  151. package/scripts/audit-validation-profiles.mjs +125 -125
  152. package/scripts/close-change.mjs +116 -116
  153. package/scripts/discover-project-profile.mjs +307 -307
  154. package/scripts/generate-command-adapter.mjs +231 -231
  155. package/scripts/generate-final-acceptance-packet.mjs +181 -181
  156. package/scripts/generate-final-form-progress-report.mjs +205 -205
  157. package/scripts/generate-host-runtime-evidence-handoff.mjs +206 -206
  158. package/scripts/generate-owner-external-gate-kit.mjs +295 -295
  159. package/scripts/generate-public-acceptance-handoff.mjs +168 -168
  160. package/scripts/generate-public-release-checklist.mjs +207 -207
  161. package/scripts/generate-release-bundle.mjs +505 -505
  162. package/scripts/generate-release-owner-action-plan.mjs +172 -172
  163. package/scripts/generate-release-status-manifest.mjs +200 -200
  164. package/scripts/generate-session-prompt.mjs +188 -188
  165. package/scripts/gse.mjs +67 -67
  166. package/scripts/init-change.mjs +265 -265
  167. package/scripts/init-project.mjs +785 -785
  168. package/scripts/install-gse.mjs +234 -234
  169. package/scripts/lib/evidence-placeholders.mjs +28 -28
  170. package/scripts/package-gse.mjs +174 -174
  171. package/scripts/probe-public-external-gates.mjs +167 -167
  172. package/scripts/record-host-invocation.mjs +151 -151
  173. package/scripts/record-public-channel-publication.mjs +178 -178
  174. package/scripts/record-public-ci-run.mjs +180 -180
  175. package/scripts/record-public-release.mjs +175 -175
  176. package/scripts/record-public-repository-settings.mjs +209 -209
  177. package/scripts/record-public-security-contact.mjs +157 -157
  178. package/scripts/sign-gse-package.mjs +83 -83
  179. package/scripts/update-project-state.mjs +223 -223
  180. package/scripts/verify-gse-package.mjs +85 -85
@@ -1,191 +1,191 @@
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
- const keepTemp = args.includes('--keep-temp')
18
-
19
- function run(command, commandArgs, cwd = root) {
20
- const result = spawnSync(command, commandArgs, {
21
- cwd,
22
- encoding: 'utf8',
23
- windowsHide: true,
24
- })
25
- return {
26
- command: [command, ...commandArgs].join(' '),
27
- cwd,
28
- status: result.status ?? 1,
29
- stdout: (result.stdout ?? '').trim(),
30
- stderr: (result.stderr ?? '').trim(),
31
- }
32
- }
33
-
34
- function npm(commandArgs, cwd = root) {
35
- return process.platform === 'win32'
36
- ? run('cmd', ['/c', 'npm', ...commandArgs], cwd)
37
- : run('npm', commandArgs, cwd)
38
- }
39
-
40
- function parseJson(text) {
41
- try {
42
- return JSON.parse(text)
43
- } catch {
44
- return null
45
- }
46
- }
47
-
48
- function check(id, label, ok, evidence, risk = '') {
49
- return { id, label, status: ok ? 'passed' : 'failed', evidence, risk }
50
- }
51
-
52
- function exists(filePath) {
53
- return fs.existsSync(filePath)
54
- }
55
-
56
- function safeReadJson(filePath) {
57
- if (!exists(filePath)) return null
58
- try {
59
- return JSON.parse(fs.readFileSync(filePath, 'utf8').replace(/^\uFEFF/, ''))
60
- } catch {
61
- return null
62
- }
63
- }
64
-
65
- const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'gse-npm-tarball-'))
66
- const consumerRoot = path.join(tempRoot, 'consumer')
67
- fs.mkdirSync(consumerRoot, { recursive: true })
68
- fs.writeFileSync(
69
- path.join(consumerRoot, 'package.json'),
70
- JSON.stringify({ name: 'gse-npm-tarball-consumer', version: '0.0.0', private: true }, null, 2) + '\n',
71
- 'utf8',
72
- )
73
-
74
- const packRun = npm(['pack', '--json', '--pack-destination', tempRoot])
75
- const packData = parseJson(packRun.stdout)
76
- const packItem = Array.isArray(packData) ? packData[0] : null
77
- const tarballPath = packItem?.filename ? path.join(tempRoot, packItem.filename) : null
78
- const installRun = tarballPath
79
- ? npm(['install', tarballPath, '--ignore-scripts', '--no-audit', '--no-fund'], consumerRoot)
80
- : { command: 'npm install skipped; tarball not created', cwd: consumerRoot, status: 1, stdout: '', stderr: 'tarball not created' }
81
- const installedRoot = path.join(consumerRoot, 'node_modules', '@t275005746', 'gse')
82
- const installedPkg = safeReadJson(path.join(installedRoot, 'package.json'))
83
- const binPath = process.platform === 'win32'
84
- ? path.join(consumerRoot, 'node_modules', '.bin', 'gse.cmd')
85
- : path.join(consumerRoot, 'node_modules', '.bin', 'gse')
86
- const binRun = exists(binPath)
87
- ? process.platform === 'win32'
88
- ? run('cmd', ['/c', binPath, 'status', '--target', installedRoot, '--json'], consumerRoot)
89
- : run(binPath, ['status', '--target', installedRoot, '--json'], consumerRoot)
90
- : { command: binPath + ' status --target ' + installedRoot + ' --json', cwd: consumerRoot, status: 1, stdout: '', stderr: 'bin missing' }
91
- const binData = parseJson(binRun.stdout)
92
- const readmeAudit = exists(path.join(installedRoot, 'scripts', 'audit-readme-docs.mjs'))
93
- ? run(process.execPath, [path.join(installedRoot, 'scripts', 'audit-readme-docs.mjs'), '--root', installedRoot, '--json'], consumerRoot)
94
- : { command: 'installed README audit skipped; script missing', cwd: consumerRoot, status: 1, stdout: '', stderr: 'script missing' }
95
- const readmeData = parseJson(readmeAudit.stdout)
96
- const tarballFiles = new Set((packItem?.files ?? []).map((item) => item.path))
97
- const requiredTarballFiles = [
98
- 'package.json',
99
- 'SKILL.md',
100
- 'README.md',
101
- 'README.zh-CN.md',
102
- 'LICENSE',
103
- 'scripts/gse.mjs',
104
- 'scripts/audit-readme-docs.mjs',
105
- 'scripts/validate-gse.mjs',
106
- 'references/commands.md',
107
- 'references/packaging.md',
108
- ]
109
-
110
- const checks = [
111
- check('NTI01', 'npm pack creates one tarball', packRun.status === 0 && Boolean(tarballPath) && exists(tarballPath), packRun.command, packRun.stderr),
112
- check('NTI02', 'tarball file list includes required runtime files', requiredTarballFiles.every((item) => tarballFiles.has(item)), requiredTarballFiles.filter((item) => !tarballFiles.has(item)).join(', ') || 'all required files present'),
113
- check('NTI03', 'tarball installs into a clean consumer project', installRun.status === 0 && exists(installedRoot), installRun.command, installRun.stderr),
114
- check('NTI04', 'installed package metadata is intact', installedPkg?.name === '@t275005746/gse' && installedPkg?.bin?.gse === 'scripts/gse.mjs', 'installed package.json'),
115
- check('NTI05', 'installed package exposes gse bin shim', exists(binPath), binPath),
116
- check('NTI06', 'installed gse bin runs status command', binRun.status === 0 && binData?.command === '/gse status' && binData?.project?.stateValid === true, binRun.command, binRun.stderr),
117
- check('NTI07', 'installed README audit passes', readmeAudit.status === 0 && readmeData?.summary?.failed === 0, readmeAudit.command, readmeAudit.stderr),
118
- check('NTI08', 'package metadata does not claim public registry publication', !installedPkg?.publishConfig && !installedPkg?.repository, 'no publishConfig or repository claim'),
119
- ]
120
-
121
- const passed = checks.filter((item) => item.status === 'passed').length
122
- const failed = checks.length - passed
123
- const report = {
124
- root,
125
- generatedAt: new Date().toISOString(),
126
- tempRoot,
127
- consumerRoot,
128
- tarballPath,
129
- summary: { status: failed === 0 ? 'passed' : 'failed', passed, failed, total: checks.length },
130
- workflows: {
131
- npmTarballPack: packRun.status === 0 ? 'verified' : 'failed',
132
- npmTarballInstall: installRun.status === 0 ? 'verified' : 'failed',
133
- installedBin: binRun.status === 0 ? 'verified' : 'failed',
134
- },
135
- package: installedPkg
136
- ? {
137
- name: installedPkg.name,
138
- version: installedPkg.version,
139
- bin: installedPkg.bin,
140
- license: installedPkg.license,
141
- }
142
- : null,
143
- commands: [packRun.command, installRun.command, binRun.command, readmeAudit.command],
144
- limits: [
145
- 'This audit verifies local npm tarball creation and installation into a clean consumer project.',
146
- 'It does not publish GSE to npm, reserve a package name, prove public repository settings, or prove marketplace approval.',
147
- ],
148
- checks,
149
- }
150
-
151
- if (!keepTemp) {
152
- try {
153
- fs.rmSync(tempRoot, { recursive: true, force: true })
154
- } catch {
155
- report.cleanupWarning = 'failed to remove temp root: ' + tempRoot
156
- }
157
- }
158
-
159
- function renderMarkdown(data) {
160
- const lines = []
161
- lines.push('# GSE npm Tarball Install Audit')
162
- lines.push('')
163
- lines.push('Generated: ' + data.generatedAt)
164
- lines.push('Root: ' + data.root)
165
- lines.push('Temp root: ' + data.tempRoot)
166
- lines.push('')
167
- lines.push('## Summary')
168
- lines.push('')
169
- lines.push('- Status: ' + data.summary.status)
170
- lines.push('- Checks: ' + data.summary.passed + '/' + data.summary.total)
171
- lines.push('- npm tarball pack: ' + data.workflows.npmTarballPack)
172
- lines.push('- npm tarball install: ' + data.workflows.npmTarballInstall)
173
- lines.push('- installed bin: ' + data.workflows.installedBin)
174
- lines.push('')
175
- lines.push('## Checks')
176
- lines.push('')
177
- for (const item of data.checks) {
178
- const marker = item.status === 'passed' ? '[x]' : '[ ]'
179
- lines.push('- ' + marker + ' ' + item.id + ' ' + item.label + ': ' + item.evidence)
180
- }
181
- lines.push('')
182
- lines.push('## Limits')
183
- lines.push('')
184
- for (const item of data.limits) lines.push('- ' + item)
185
- return lines.join('\n') + '\n'
186
- }
187
-
188
- if (jsonOnly) console.log(JSON.stringify(report, null, 2))
189
- else console.log(renderMarkdown(report))
190
-
191
- 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
+ const keepTemp = args.includes('--keep-temp')
18
+
19
+ function run(command, commandArgs, cwd = root) {
20
+ const result = spawnSync(command, commandArgs, {
21
+ cwd,
22
+ encoding: 'utf8',
23
+ windowsHide: true,
24
+ })
25
+ return {
26
+ command: [command, ...commandArgs].join(' '),
27
+ cwd,
28
+ status: result.status ?? 1,
29
+ stdout: (result.stdout ?? '').trim(),
30
+ stderr: (result.stderr ?? '').trim(),
31
+ }
32
+ }
33
+
34
+ function npm(commandArgs, cwd = root) {
35
+ return process.platform === 'win32'
36
+ ? run('cmd', ['/c', 'npm', ...commandArgs], cwd)
37
+ : run('npm', commandArgs, cwd)
38
+ }
39
+
40
+ function parseJson(text) {
41
+ try {
42
+ return JSON.parse(text)
43
+ } catch {
44
+ return null
45
+ }
46
+ }
47
+
48
+ function check(id, label, ok, evidence, risk = '') {
49
+ return { id, label, status: ok ? 'passed' : 'failed', evidence, risk }
50
+ }
51
+
52
+ function exists(filePath) {
53
+ return fs.existsSync(filePath)
54
+ }
55
+
56
+ function safeReadJson(filePath) {
57
+ if (!exists(filePath)) return null
58
+ try {
59
+ return JSON.parse(fs.readFileSync(filePath, 'utf8').replace(/^\uFEFF/, ''))
60
+ } catch {
61
+ return null
62
+ }
63
+ }
64
+
65
+ const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'gse-npm-tarball-'))
66
+ const consumerRoot = path.join(tempRoot, 'consumer')
67
+ fs.mkdirSync(consumerRoot, { recursive: true })
68
+ fs.writeFileSync(
69
+ path.join(consumerRoot, 'package.json'),
70
+ JSON.stringify({ name: 'gse-npm-tarball-consumer', version: '0.0.0', private: true }, null, 2) + '\n',
71
+ 'utf8',
72
+ )
73
+
74
+ const packRun = npm(['pack', '--json', '--pack-destination', tempRoot])
75
+ const packData = parseJson(packRun.stdout)
76
+ const packItem = Array.isArray(packData) ? packData[0] : null
77
+ const tarballPath = packItem?.filename ? path.join(tempRoot, packItem.filename) : null
78
+ const installRun = tarballPath
79
+ ? npm(['install', tarballPath, '--ignore-scripts', '--no-audit', '--no-fund'], consumerRoot)
80
+ : { command: 'npm install skipped; tarball not created', cwd: consumerRoot, status: 1, stdout: '', stderr: 'tarball not created' }
81
+ const installedRoot = path.join(consumerRoot, 'node_modules', '@t275005746', 'gse')
82
+ const installedPkg = safeReadJson(path.join(installedRoot, 'package.json'))
83
+ const binPath = process.platform === 'win32'
84
+ ? path.join(consumerRoot, 'node_modules', '.bin', 'gse.cmd')
85
+ : path.join(consumerRoot, 'node_modules', '.bin', 'gse')
86
+ const binRun = exists(binPath)
87
+ ? process.platform === 'win32'
88
+ ? run('cmd', ['/c', binPath, 'status', '--target', installedRoot, '--json'], consumerRoot)
89
+ : run(binPath, ['status', '--target', installedRoot, '--json'], consumerRoot)
90
+ : { command: binPath + ' status --target ' + installedRoot + ' --json', cwd: consumerRoot, status: 1, stdout: '', stderr: 'bin missing' }
91
+ const binData = parseJson(binRun.stdout)
92
+ const readmeAudit = exists(path.join(installedRoot, 'scripts', 'audit-readme-docs.mjs'))
93
+ ? run(process.execPath, [path.join(installedRoot, 'scripts', 'audit-readme-docs.mjs'), '--root', installedRoot, '--json'], consumerRoot)
94
+ : { command: 'installed README audit skipped; script missing', cwd: consumerRoot, status: 1, stdout: '', stderr: 'script missing' }
95
+ const readmeData = parseJson(readmeAudit.stdout)
96
+ const tarballFiles = new Set((packItem?.files ?? []).map((item) => item.path))
97
+ const requiredTarballFiles = [
98
+ 'package.json',
99
+ 'SKILL.md',
100
+ 'README.md',
101
+ 'README.zh-CN.md',
102
+ 'LICENSE',
103
+ 'scripts/gse.mjs',
104
+ 'scripts/audit-readme-docs.mjs',
105
+ 'scripts/validate-gse.mjs',
106
+ 'references/commands.md',
107
+ 'references/packaging.md',
108
+ ]
109
+
110
+ const checks = [
111
+ check('NTI01', 'npm pack creates one tarball', packRun.status === 0 && Boolean(tarballPath) && exists(tarballPath), packRun.command, packRun.stderr),
112
+ check('NTI02', 'tarball file list includes required runtime files', requiredTarballFiles.every((item) => tarballFiles.has(item)), requiredTarballFiles.filter((item) => !tarballFiles.has(item)).join(', ') || 'all required files present'),
113
+ check('NTI03', 'tarball installs into a clean consumer project', installRun.status === 0 && exists(installedRoot), installRun.command, installRun.stderr),
114
+ check('NTI04', 'installed package metadata is intact', installedPkg?.name === '@t275005746/gse' && installedPkg?.bin?.gse === 'scripts/gse.mjs', 'installed package.json'),
115
+ check('NTI05', 'installed package exposes gse bin shim', exists(binPath), binPath),
116
+ check('NTI06', 'installed gse bin runs status command', binRun.status === 0 && binData?.command === '/gse status' && binData?.project?.stateValid === true, binRun.command, binRun.stderr),
117
+ check('NTI07', 'installed README audit passes', readmeAudit.status === 0 && readmeData?.summary?.failed === 0, readmeAudit.command, readmeAudit.stderr),
118
+ check('NTI08', 'package metadata does not claim public registry publication', !installedPkg?.publishConfig && !installedPkg?.repository, 'no publishConfig or repository claim'),
119
+ ]
120
+
121
+ const passed = checks.filter((item) => item.status === 'passed').length
122
+ const failed = checks.length - passed
123
+ const report = {
124
+ root,
125
+ generatedAt: new Date().toISOString(),
126
+ tempRoot,
127
+ consumerRoot,
128
+ tarballPath,
129
+ summary: { status: failed === 0 ? 'passed' : 'failed', passed, failed, total: checks.length },
130
+ workflows: {
131
+ npmTarballPack: packRun.status === 0 ? 'verified' : 'failed',
132
+ npmTarballInstall: installRun.status === 0 ? 'verified' : 'failed',
133
+ installedBin: binRun.status === 0 ? 'verified' : 'failed',
134
+ },
135
+ package: installedPkg
136
+ ? {
137
+ name: installedPkg.name,
138
+ version: installedPkg.version,
139
+ bin: installedPkg.bin,
140
+ license: installedPkg.license,
141
+ }
142
+ : null,
143
+ commands: [packRun.command, installRun.command, binRun.command, readmeAudit.command],
144
+ limits: [
145
+ 'This audit verifies local npm tarball creation and installation into a clean consumer project.',
146
+ 'It does not publish GSE to npm, reserve a package name, prove public repository settings, or prove marketplace approval.',
147
+ ],
148
+ checks,
149
+ }
150
+
151
+ if (!keepTemp) {
152
+ try {
153
+ fs.rmSync(tempRoot, { recursive: true, force: true })
154
+ } catch {
155
+ report.cleanupWarning = 'failed to remove temp root: ' + tempRoot
156
+ }
157
+ }
158
+
159
+ function renderMarkdown(data) {
160
+ const lines = []
161
+ lines.push('# GSE npm Tarball Install Audit')
162
+ lines.push('')
163
+ lines.push('Generated: ' + data.generatedAt)
164
+ lines.push('Root: ' + data.root)
165
+ lines.push('Temp root: ' + data.tempRoot)
166
+ lines.push('')
167
+ lines.push('## Summary')
168
+ lines.push('')
169
+ lines.push('- Status: ' + data.summary.status)
170
+ lines.push('- Checks: ' + data.summary.passed + '/' + data.summary.total)
171
+ lines.push('- npm tarball pack: ' + data.workflows.npmTarballPack)
172
+ lines.push('- npm tarball install: ' + data.workflows.npmTarballInstall)
173
+ lines.push('- installed bin: ' + data.workflows.installedBin)
174
+ lines.push('')
175
+ lines.push('## Checks')
176
+ lines.push('')
177
+ for (const item of data.checks) {
178
+ const marker = item.status === 'passed' ? '[x]' : '[ ]'
179
+ lines.push('- ' + marker + ' ' + item.id + ' ' + item.label + ': ' + item.evidence)
180
+ }
181
+ lines.push('')
182
+ lines.push('## Limits')
183
+ lines.push('')
184
+ for (const item of data.limits) lines.push('- ' + item)
185
+ return lines.join('\n') + '\n'
186
+ }
187
+
188
+ if (jsonOnly) console.log(JSON.stringify(report, null, 2))
189
+ else console.log(renderMarkdown(report))
190
+
191
+ if (failed > 0) process.exit(1)
@@ -1,92 +1,92 @@
1
- #!/usr/bin/env node
2
- import fs from 'node:fs'
3
- import path from 'node:path'
4
-
5
- const args = process.argv.slice(2)
6
-
7
- function readArg(name, fallback = null) {
8
- const index = args.indexOf(name)
9
- if (index === -1) return fallback
10
- return args[index + 1] ?? fallback
11
- }
12
-
13
- const root = path.resolve(readArg('--root', path.join(import.meta.dirname, '..')))
14
- const jsonOnly = args.includes('--json')
15
-
16
- function read(relativePath) {
17
- const fullPath = path.join(root, relativePath)
18
- return fs.existsSync(fullPath) ? fs.readFileSync(fullPath, 'utf8').replace(/^\uFEFF/, '') : ''
19
- }
20
-
21
- function exists(relativePath) {
22
- return fs.existsSync(path.join(root, relativePath))
23
- }
24
-
25
- function check(id, label, ok, evidence, risk = '') {
26
- return { id, label, status: ok ? 'passed' : 'failed', evidence, risk }
27
- }
28
-
29
- const license = read('LICENSE')
30
- const defaults = read('references/open-source-defaults.md')
31
- const publicRelease = read('references/public-release.md')
32
- const skill = read('SKILL.md')
33
- const releaseRecord = read('.gse/releases/public-release-owner-required.md')
34
-
35
- const checks = [
36
- check('OSD01', 'MIT license file exists', exists('LICENSE') && license.includes('MIT License') && license.includes('GSE contributors'), 'LICENSE'),
37
- check('OSD02', 'open-source defaults reference exists', exists('references/open-source-defaults.md'), 'references/open-source-defaults.md'),
38
- check('OSD03', 'defaults align with mainstream public release path', ['License: MIT', 'public GitHub repository', 'GitHub Actions', 'SECURITY.md', 'GitHub Release', 'portable `/gse ...` commands'].every((term) => defaults.includes(term)), 'references/open-source-defaults.md'),
39
- check('OSD04', 'defaults preserve external evidence boundaries', ['public CI', 'public security contact', 'public publication', 'native slash commands'].every((term) => defaults.includes(term)), 'references/open-source-defaults.md'),
40
- check('OSD05', 'public release docs route to defaults', publicRelease.includes('references/open-source-defaults.md') && publicRelease.includes('owner-approved mainstream open-source default is MIT'), 'references/public-release.md'),
41
- check('OSD06', 'skill routes open-source defaults reference', skill.includes('references/open-source-defaults.md'), 'SKILL.md'),
42
- check('OSD07', 'owner license decision is accepted as MIT', releaseRecord.includes('License status: selected') && releaseRecord.includes('SPDX identifier: MIT') && releaseRecord.includes('License file: LICENSE') && releaseRecord.includes('Evidence status: accepted'), '.gse/releases/public-release-owner-required.md'),
43
- ]
44
-
45
- const passed = checks.filter((item) => item.status === 'passed').length
46
- const failed = checks.length - passed
47
- const report = {
48
- root,
49
- generatedAt: new Date().toISOString(),
50
- summary: { status: failed === 0 ? 'passed' : 'failed', passed, failed, total: checks.length },
51
- workflows: {
52
- openSourceDefaults: failed === 0 ? 'verified' : 'failed',
53
- licenseDecision: failed === 0 ? 'accepted' : 'unknown',
54
- },
55
- limits: [
56
- 'This audit verifies the owner-approved default route and MIT license record.',
57
- 'It does not prove public repository settings, public CI, registry publication, marketplace approval, or native host runtime invocation.',
58
- ],
59
- checks,
60
- }
61
-
62
- function renderMarkdown(data) {
63
- const lines = []
64
- lines.push('# GSE Open-Source Defaults Audit')
65
- lines.push('')
66
- lines.push('Generated: ' + data.generatedAt)
67
- lines.push('Root: ' + data.root)
68
- lines.push('')
69
- lines.push('## Summary')
70
- lines.push('')
71
- lines.push('- Status: ' + data.summary.status)
72
- lines.push('- Checks: ' + data.summary.passed + '/' + data.summary.total)
73
- lines.push('- Open-source defaults: ' + data.workflows.openSourceDefaults)
74
- lines.push('- License decision: ' + data.workflows.licenseDecision)
75
- lines.push('')
76
- lines.push('## Checks')
77
- lines.push('')
78
- for (const item of data.checks) {
79
- const marker = item.status === 'passed' ? '[x]' : '[ ]'
80
- lines.push('- ' + marker + ' ' + item.id + ' ' + item.label + ': ' + item.evidence)
81
- }
82
- lines.push('')
83
- lines.push('## Limits')
84
- lines.push('')
85
- for (const item of data.limits) lines.push('- ' + item)
86
- return lines.join('\n') + '\n'
87
- }
88
-
89
- if (jsonOnly) console.log(JSON.stringify(report, null, 2))
90
- else console.log(renderMarkdown(report))
91
-
92
- if (failed > 0) process.exit(1)
1
+ #!/usr/bin/env node
2
+ import fs from 'node:fs'
3
+ import path from 'node:path'
4
+
5
+ const args = process.argv.slice(2)
6
+
7
+ function readArg(name, fallback = null) {
8
+ const index = args.indexOf(name)
9
+ if (index === -1) return fallback
10
+ return args[index + 1] ?? fallback
11
+ }
12
+
13
+ const root = path.resolve(readArg('--root', path.join(import.meta.dirname, '..')))
14
+ const jsonOnly = args.includes('--json')
15
+
16
+ function read(relativePath) {
17
+ const fullPath = path.join(root, relativePath)
18
+ return fs.existsSync(fullPath) ? fs.readFileSync(fullPath, 'utf8').replace(/^\uFEFF/, '') : ''
19
+ }
20
+
21
+ function exists(relativePath) {
22
+ return fs.existsSync(path.join(root, relativePath))
23
+ }
24
+
25
+ function check(id, label, ok, evidence, risk = '') {
26
+ return { id, label, status: ok ? 'passed' : 'failed', evidence, risk }
27
+ }
28
+
29
+ const license = read('LICENSE')
30
+ const defaults = read('references/open-source-defaults.md')
31
+ const publicRelease = read('references/public-release.md')
32
+ const skill = read('SKILL.md')
33
+ const releaseRecord = read('.gse/releases/public-release-owner-required.md')
34
+
35
+ const checks = [
36
+ check('OSD01', 'MIT license file exists', exists('LICENSE') && license.includes('MIT License') && license.includes('GSE contributors'), 'LICENSE'),
37
+ check('OSD02', 'open-source defaults reference exists', exists('references/open-source-defaults.md'), 'references/open-source-defaults.md'),
38
+ check('OSD03', 'defaults align with mainstream public release path', ['License: MIT', 'public GitHub repository', 'GitHub Actions', 'SECURITY.md', 'GitHub Release', 'portable `/gse ...` commands'].every((term) => defaults.includes(term)), 'references/open-source-defaults.md'),
39
+ check('OSD04', 'defaults preserve external evidence boundaries', ['public CI', 'public security contact', 'public publication', 'native slash commands'].every((term) => defaults.includes(term)), 'references/open-source-defaults.md'),
40
+ check('OSD05', 'public release docs route to defaults', publicRelease.includes('references/open-source-defaults.md') && publicRelease.includes('owner-approved mainstream open-source default is MIT'), 'references/public-release.md'),
41
+ check('OSD06', 'skill routes open-source defaults reference', skill.includes('references/open-source-defaults.md'), 'SKILL.md'),
42
+ check('OSD07', 'owner license decision is accepted as MIT', releaseRecord.includes('License status: selected') && releaseRecord.includes('SPDX identifier: MIT') && releaseRecord.includes('License file: LICENSE') && releaseRecord.includes('Evidence status: accepted'), '.gse/releases/public-release-owner-required.md'),
43
+ ]
44
+
45
+ const passed = checks.filter((item) => item.status === 'passed').length
46
+ const failed = checks.length - passed
47
+ const report = {
48
+ root,
49
+ generatedAt: new Date().toISOString(),
50
+ summary: { status: failed === 0 ? 'passed' : 'failed', passed, failed, total: checks.length },
51
+ workflows: {
52
+ openSourceDefaults: failed === 0 ? 'verified' : 'failed',
53
+ licenseDecision: failed === 0 ? 'accepted' : 'unknown',
54
+ },
55
+ limits: [
56
+ 'This audit verifies the owner-approved default route and MIT license record.',
57
+ 'It does not prove public repository settings, public CI, registry publication, marketplace approval, or native host runtime invocation.',
58
+ ],
59
+ checks,
60
+ }
61
+
62
+ function renderMarkdown(data) {
63
+ const lines = []
64
+ lines.push('# GSE Open-Source Defaults Audit')
65
+ lines.push('')
66
+ lines.push('Generated: ' + data.generatedAt)
67
+ lines.push('Root: ' + data.root)
68
+ lines.push('')
69
+ lines.push('## Summary')
70
+ lines.push('')
71
+ lines.push('- Status: ' + data.summary.status)
72
+ lines.push('- Checks: ' + data.summary.passed + '/' + data.summary.total)
73
+ lines.push('- Open-source defaults: ' + data.workflows.openSourceDefaults)
74
+ lines.push('- License decision: ' + data.workflows.licenseDecision)
75
+ lines.push('')
76
+ lines.push('## Checks')
77
+ lines.push('')
78
+ for (const item of data.checks) {
79
+ const marker = item.status === 'passed' ? '[x]' : '[ ]'
80
+ lines.push('- ' + marker + ' ' + item.id + ' ' + item.label + ': ' + item.evidence)
81
+ }
82
+ lines.push('')
83
+ lines.push('## Limits')
84
+ lines.push('')
85
+ for (const item of data.limits) lines.push('- ' + item)
86
+ return lines.join('\n') + '\n'
87
+ }
88
+
89
+ if (jsonOnly) console.log(JSON.stringify(report, null, 2))
90
+ else console.log(renderMarkdown(report))
91
+
92
+ if (failed > 0) process.exit(1)