@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,191 +1,197 @@
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' }
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
81
  const installedRoot = path.join(consumerRoot, 'node_modules', '@t275005746', 'gse')
82
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)
83
+ const repositoryUrl = typeof installedPkg?.repository === 'string' ? installedPkg.repository : installedPkg?.repository?.url
84
+ const expectedRepositoryUrls = new Set([
85
+ 'git+https://github.com/275005746/gse.git',
86
+ 'https://github.com/275005746/gse.git',
87
+ 'https://github.com/275005746/gse',
88
+ ])
89
+ const binPath = process.platform === 'win32'
90
+ ? path.join(consumerRoot, 'node_modules', '.bin', 'gse.cmd')
91
+ : path.join(consumerRoot, 'node_modules', '.bin', 'gse')
92
+ const binRun = exists(binPath)
93
+ ? process.platform === 'win32'
94
+ ? run('cmd', ['/c', binPath, 'status', '--target', installedRoot, '--json'], consumerRoot)
95
+ : run(binPath, ['status', '--target', installedRoot, '--json'], consumerRoot)
96
+ : { command: binPath + ' status --target ' + installedRoot + ' --json', cwd: consumerRoot, status: 1, stdout: '', stderr: 'bin missing' }
97
+ const binData = parseJson(binRun.stdout)
98
+ const readmeAudit = exists(path.join(installedRoot, 'scripts', 'audit-readme-docs.mjs'))
99
+ ? run(process.execPath, [path.join(installedRoot, 'scripts', 'audit-readme-docs.mjs'), '--root', installedRoot, '--json'], consumerRoot)
100
+ : { command: 'installed README audit skipped; script missing', cwd: consumerRoot, status: 1, stdout: '', stderr: 'script missing' }
101
+ const readmeData = parseJson(readmeAudit.stdout)
102
+ const tarballFiles = new Set((packItem?.files ?? []).map((item) => item.path))
103
+ const requiredTarballFiles = [
104
+ 'package.json',
105
+ 'SKILL.md',
106
+ 'README.md',
107
+ 'README.zh-CN.md',
108
+ 'LICENSE',
109
+ 'scripts/gse.mjs',
110
+ 'scripts/audit-readme-docs.mjs',
111
+ 'scripts/validate-gse.mjs',
112
+ 'references/commands.md',
113
+ 'references/packaging.md',
114
+ ]
115
+
116
+ const checks = [
117
+ check('NTI01', 'npm pack creates one tarball', packRun.status === 0 && Boolean(tarballPath) && exists(tarballPath), packRun.command, packRun.stderr),
118
+ 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'),
119
+ check('NTI03', 'tarball installs into a clean consumer project', installRun.status === 0 && exists(installedRoot), installRun.command, installRun.stderr),
120
+ check('NTI04', 'installed package metadata is intact', installedPkg?.name === '@t275005746/gse' && installedPkg?.bin?.gse === 'scripts/gse.mjs', 'installed package.json'),
121
+ check('NTI05', 'installed package exposes gse bin shim', exists(binPath), binPath),
122
+ check('NTI06', 'installed gse bin runs status command', binRun.status === 0 && binData?.command === '/gse status' && binData?.project?.stateValid === true, binRun.command, binRun.stderr),
123
+ check('NTI07', 'installed README audit passes', readmeAudit.status === 0 && readmeData?.summary?.failed === 0, readmeAudit.command, readmeAudit.stderr),
124
+ check('NTI08', 'installed package metadata points at the public GSE repository without publishConfig overrides', !installedPkg?.publishConfig && expectedRepositoryUrls.has(repositoryUrl), 'repository=' + (repositoryUrl ?? 'missing') + ', publishConfig=' + (installedPkg?.publishConfig ? 'present' : 'absent')),
125
+ ]
126
+
127
+ const passed = checks.filter((item) => item.status === 'passed').length
128
+ const failed = checks.length - passed
129
+ const report = {
130
+ root,
131
+ generatedAt: new Date().toISOString(),
132
+ tempRoot,
133
+ consumerRoot,
134
+ tarballPath,
135
+ summary: { status: failed === 0 ? 'passed' : 'failed', passed, failed, total: checks.length },
136
+ workflows: {
137
+ npmTarballPack: packRun.status === 0 ? 'verified' : 'failed',
138
+ npmTarballInstall: installRun.status === 0 ? 'verified' : 'failed',
139
+ installedBin: binRun.status === 0 ? 'verified' : 'failed',
140
+ },
141
+ package: installedPkg
142
+ ? {
143
+ name: installedPkg.name,
144
+ version: installedPkg.version,
145
+ bin: installedPkg.bin,
146
+ license: installedPkg.license,
147
+ }
148
+ : null,
149
+ commands: [packRun.command, installRun.command, binRun.command, readmeAudit.command],
150
+ limits: [
151
+ 'This audit verifies local npm tarball creation and installation into a clean consumer project.',
152
+ 'It does not publish GSE to npm, reserve a package name, prove public repository settings, or prove marketplace approval.',
153
+ ],
154
+ checks,
155
+ }
156
+
157
+ if (!keepTemp) {
158
+ try {
159
+ fs.rmSync(tempRoot, { recursive: true, force: true })
160
+ } catch {
161
+ report.cleanupWarning = 'failed to remove temp root: ' + tempRoot
162
+ }
163
+ }
164
+
165
+ function renderMarkdown(data) {
166
+ const lines = []
167
+ lines.push('# GSE npm Tarball Install Audit')
168
+ lines.push('')
169
+ lines.push('Generated: ' + data.generatedAt)
170
+ lines.push('Root: ' + data.root)
171
+ lines.push('Temp root: ' + data.tempRoot)
172
+ lines.push('')
173
+ lines.push('## Summary')
174
+ lines.push('')
175
+ lines.push('- Status: ' + data.summary.status)
176
+ lines.push('- Checks: ' + data.summary.passed + '/' + data.summary.total)
177
+ lines.push('- npm tarball pack: ' + data.workflows.npmTarballPack)
178
+ lines.push('- npm tarball install: ' + data.workflows.npmTarballInstall)
179
+ lines.push('- installed bin: ' + data.workflows.installedBin)
180
+ lines.push('')
181
+ lines.push('## Checks')
182
+ lines.push('')
183
+ for (const item of data.checks) {
184
+ const marker = item.status === 'passed' ? '[x]' : '[ ]'
185
+ lines.push('- ' + marker + ' ' + item.id + ' ' + item.label + ': ' + item.evidence)
186
+ }
187
+ lines.push('')
188
+ lines.push('## Limits')
189
+ lines.push('')
190
+ for (const item of data.limits) lines.push('- ' + item)
191
+ return lines.join('\n') + '\n'
192
+ }
193
+
194
+ if (jsonOnly) console.log(JSON.stringify(report, null, 2))
195
+ else console.log(renderMarkdown(report))
196
+
197
+ 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)