@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.
- package/.github/ISSUE_TEMPLATE/bug_report.yml +42 -42
- package/.github/ISSUE_TEMPLATE/change_request.yml +50 -50
- package/.github/ISSUE_TEMPLATE/config.yml +5 -5
- package/.github/PULL_REQUEST_TEMPLATE.md +38 -38
- package/.github/workflows/validate-gse.yml +33 -33
- package/.gse/README.md +18 -18
- package/.gse/gse-development-protocol.md +50 -50
- package/.gse/project-profile.md +29 -29
- package/.gse/quality-gates.md +25 -25
- package/.gse/releases/public-registry-publication-npm.md +49 -0
- package/.gse/releases/public-release-owner-required.md +65 -65
- package/.gse/releases/public-security-contact-owner-required.md +45 -45
- package/.gse/state.json +147 -27
- package/CHANGELOG.md +31 -15
- package/CONTRIBUTING.md +64 -64
- package/LICENSE +21 -21
- package/README.md +14 -7
- package/README.zh-CN.md +14 -7
- package/SECURITY.md +41 -41
- package/SKILL.md +32 -12
- package/SUPPORT.md +38 -38
- package/assets/marketplace/README.md +7 -7
- package/assets/marketplace/gse-listing.json +75 -75
- package/assets/templates/acceptance-execution-packet.md +73 -73
- package/assets/templates/adr.md +14 -14
- package/assets/templates/change-brief.md +16 -16
- package/assets/templates/design.md +18 -18
- package/assets/templates/dispatch-packet.md +100 -92
- package/assets/templates/evidence.md +15 -9
- package/assets/templates/execution-quality-pack.md +65 -65
- package/assets/templates/goal-map.md +21 -21
- package/assets/templates/host-adapter.md +48 -48
- package/assets/templates/host-ui-invocation-record.md +42 -42
- package/assets/templates/incident-review.md +60 -60
- package/assets/templates/public-channel-publication-record.md +49 -49
- package/assets/templates/public-ci-run-record.md +53 -53
- package/assets/templates/public-release-record.md +65 -65
- package/assets/templates/public-repository-settings-record.md +59 -59
- package/assets/templates/public-security-contact-record.md +45 -45
- package/assets/templates/release-trust-record.md +32 -32
- package/assets/templates/review.md +18 -18
- package/assets/templates/role-fallback-packet.md +49 -0
- package/assets/templates/spec.md +16 -16
- package/assets/templates/target-adoption-evidence.md +29 -29
- package/assets/templates/tasks.md +17 -17
- package/assets/templates/update-release-acceptance-record.md +58 -58
- package/examples/README.md +22 -22
- package/examples/agent-runtime-host/.claude/gse-adapter.md +6 -6
- package/examples/agent-runtime-host/.codex/gse-adapter.md +7 -7
- package/examples/agent-runtime-host/.gse/goal-map.md +7 -7
- package/examples/agent-runtime-host/.gse/project-profile.md +27 -27
- package/examples/agent-runtime-host/.gse/tooling.md +5 -5
- package/examples/agent-runtime-host/.mcp.json +9 -9
- package/examples/agent-runtime-host/AGENTS.md +5 -5
- package/examples/agent-runtime-host/README.md +10 -10
- package/examples/agent-runtime-host/docs/model-routing.md +5 -5
- package/examples/cli-tool/.gse/project-profile.md +21 -21
- package/examples/cli-tool/AGENTS.md +5 -5
- package/examples/cli-tool/README.md +12 -12
- package/examples/cli-tool/package.json +21 -21
- package/examples/small-app/.env.example +2 -2
- package/examples/small-app/.github/workflows/ci.yml +8 -8
- package/examples/small-app/AGENTS.md +5 -5
- package/examples/small-app/README.md +12 -12
- package/examples/small-app/package.json +26 -26
- package/examples/small-app/playwright.config.ts +4 -4
- package/package.json +52 -44
- package/references/adoption-recipes.md +171 -171
- package/references/agent-roles.md +42 -21
- package/references/architecture-health.md +101 -101
- package/references/benchmark-audit.md +73 -73
- package/references/commands.md +74 -45
- package/references/community-channels.md +46 -46
- package/references/compatibility.md +70 -70
- package/references/design-basis.md +38 -38
- package/references/domain-model.md +129 -129
- package/references/domain-quality-gates.md +75 -75
- package/references/drift-audit.md +81 -80
- package/references/evidence-taxonomy.md +145 -108
- package/references/file-ownership.md +97 -93
- package/references/final-form-roadmap.md +201 -0
- package/references/final-readiness.md +84 -84
- package/references/forward-test.md +133 -133
- package/references/goal-map.md +36 -36
- package/references/host-adapters.md +129 -101
- package/references/learning-system.md +42 -26
- package/references/maintenance-cadence.md +51 -0
- package/references/marketplace-discovery.md +46 -46
- package/references/model-routing.md +103 -103
- package/references/open-source-defaults.md +39 -39
- package/references/operating-model.md +52 -52
- package/references/packaging.md +277 -277
- package/references/project-agent-workspace.md +89 -89
- package/references/project-bootstrap.md +122 -122
- package/references/project-guards.md +52 -0
- package/references/project-profile.md +57 -57
- package/references/public-release.md +174 -174
- package/references/quality-gates.md +96 -89
- package/references/recovery.md +176 -176
- package/references/release-trust.md +43 -43
- package/references/release.md +126 -126
- package/references/review.md +141 -141
- package/references/role-dispatch-fallback.md +54 -0
- package/references/router.md +90 -90
- package/references/spec-workflow.md +66 -66
- package/references/task-levels.md +81 -81
- package/references/tool-adapters.md +80 -70
- package/scripts/audit-acceptance-execution-packet.mjs +133 -133
- package/scripts/audit-adoption-recipes.mjs +99 -99
- package/scripts/audit-change-lifecycle.mjs +77 -77
- package/scripts/audit-change-system.mjs +134 -134
- package/scripts/audit-ci-readiness.mjs +107 -107
- package/scripts/audit-close-gate-hardening.mjs +188 -0
- package/scripts/audit-close-gate.mjs +448 -262
- package/scripts/audit-command-adapters.mjs +91 -91
- package/scripts/audit-command-execution.mjs +212 -199
- package/scripts/audit-commands.mjs +7 -5
- package/scripts/audit-compatibility.mjs +149 -149
- package/scripts/audit-completion-plan-drill.mjs +230 -0
- package/scripts/audit-completion-readiness.mjs +290 -287
- package/scripts/audit-continue-preflight.mjs +234 -0
- package/scripts/audit-distribution.mjs +251 -251
- package/scripts/audit-domain-quality-gates.mjs +108 -108
- package/scripts/audit-evidence-levels.mjs +217 -0
- package/scripts/audit-evidence-placeholders.mjs +126 -126
- package/scripts/audit-evidence-review-queue.mjs +206 -0
- package/scripts/audit-final-acceptance-packet.mjs +9 -9
- package/scripts/audit-final-form-progress-report.mjs +19 -18
- package/scripts/audit-final-form-roadmap.mjs +157 -0
- package/scripts/audit-final-form-stale-copy.mjs +2 -2
- package/scripts/audit-final-readiness-promotion.mjs +255 -255
- package/scripts/audit-final-readiness.mjs +226 -226
- package/scripts/audit-fixtures.mjs +154 -154
- package/scripts/audit-fresh-session-readiness.mjs +177 -177
- package/scripts/audit-host-capabilities.mjs +237 -0
- package/scripts/audit-host-runtime-evidence-handoff.mjs +159 -159
- package/scripts/audit-host-runtime-invocation-drill.mjs +240 -240
- package/scripts/audit-host-runtime-invocations.mjs +254 -254
- package/scripts/audit-host-ui-invocation.mjs +132 -132
- package/scripts/audit-installed-sync.mjs +203 -0
- package/scripts/audit-learning-drift.mjs +292 -0
- package/scripts/audit-learning-promotion.mjs +351 -0
- package/scripts/audit-learning-system.mjs +24 -14
- package/scripts/audit-local-final-form-completion.mjs +11 -10
- package/scripts/audit-maintenance-cadence.mjs +139 -0
- package/scripts/audit-maintenance-snapshot.mjs +181 -0
- package/scripts/audit-marketplace-discovery.mjs +122 -122
- package/scripts/audit-npm-package-metadata.mjs +160 -154
- package/scripts/audit-npm-publish-dry-run.mjs +194 -166
- package/scripts/audit-npm-tarball-install.mjs +195 -189
- package/scripts/audit-open-source-defaults.mjs +92 -92
- package/scripts/audit-open-source-readiness.mjs +97 -97
- package/scripts/audit-owner-external-gate-kit.mjs +12 -11
- package/scripts/audit-project-guards.mjs +189 -0
- package/scripts/audit-project.mjs +144 -141
- package/scripts/audit-public-acceptance-command-dry-run-drill.mjs +203 -203
- package/scripts/audit-public-acceptance-handoff.mjs +10 -10
- package/scripts/audit-public-acceptance-readiness.mjs +222 -222
- package/scripts/audit-public-channel-publication.mjs +248 -248
- package/scripts/audit-public-ci-run.mjs +184 -184
- package/scripts/audit-public-collaboration-templates.mjs +98 -98
- package/scripts/audit-public-external-gate-probe.mjs +206 -206
- package/scripts/audit-public-release-checklist.mjs +17 -15
- package/scripts/audit-public-release-decision.mjs +201 -201
- package/scripts/audit-public-release-metadata.mjs +176 -176
- package/scripts/audit-public-repository-settings.mjs +237 -237
- package/scripts/audit-public-security-contact.mjs +171 -171
- package/scripts/audit-readme-docs.mjs +6 -4
- package/scripts/audit-recovery-readiness.mjs +98 -98
- package/scripts/audit-release-bundle.mjs +13 -11
- package/scripts/audit-release-owner-action-plan-drill.mjs +5 -4
- package/scripts/audit-release-owner-action-plan.mjs +10 -10
- package/scripts/audit-release-readiness.mjs +106 -106
- package/scripts/audit-release-status-manifest.mjs +4 -4
- package/scripts/audit-release-trust.mjs +62 -62
- package/scripts/audit-remote-distribution.mjs +266 -266
- package/scripts/audit-roadmap-consistency.mjs +234 -230
- package/scripts/audit-role-dispatch-fallback.mjs +212 -0
- package/scripts/audit-session-sync.mjs +127 -0
- package/scripts/audit-signing.mjs +147 -147
- package/scripts/audit-state-freshness.mjs +20 -14
- package/scripts/audit-state-repair.mjs +360 -0
- package/scripts/audit-target-adoption-evidence.mjs +117 -117
- package/scripts/audit-target-hardening-drills.mjs +267 -0
- package/scripts/audit-target-project.mjs +507 -507
- package/scripts/audit-tool-fallback-policy.mjs +180 -0
- package/scripts/audit-ui-browser-evidence-policy.mjs +191 -0
- package/scripts/audit-update-release-acceptance.mjs +136 -136
- package/scripts/audit-v1-target-validation.mjs +269 -269
- package/scripts/audit-validation-profiles.mjs +125 -123
- package/scripts/backfill-evidence-levels.mjs +98 -0
- package/scripts/check-encoding.mjs +72 -0
- package/scripts/close-change.mjs +116 -116
- package/scripts/discover-project-profile.mjs +307 -307
- package/scripts/generate-command-adapter.mjs +231 -231
- package/scripts/generate-continue-packet.mjs +1214 -0
- package/scripts/generate-final-acceptance-packet.mjs +188 -173
- package/scripts/generate-final-form-progress-report.mjs +191 -189
- package/scripts/generate-host-runtime-evidence-handoff.mjs +198 -191
- package/scripts/generate-maintenance-snapshot.mjs +216 -0
- package/scripts/generate-owner-external-gate-kit.mjs +295 -295
- package/scripts/generate-public-acceptance-handoff.mjs +168 -156
- package/scripts/generate-public-release-checklist.mjs +207 -207
- package/scripts/generate-release-bundle.mjs +505 -505
- package/scripts/generate-release-owner-action-plan.mjs +172 -171
- package/scripts/generate-release-status-manifest.mjs +199 -198
- package/scripts/generate-session-prompt.mjs +188 -188
- package/scripts/gse.mjs +67 -67
- package/scripts/init-change.mjs +265 -265
- package/scripts/init-project.mjs +793 -712
- package/scripts/install-gse.mjs +234 -234
- package/scripts/lib/evidence-placeholders.mjs +28 -28
- package/scripts/package-gse.mjs +174 -174
- package/scripts/probe-public-external-gates.mjs +167 -167
- package/scripts/record-host-invocation.mjs +151 -151
- package/scripts/record-learning.mjs +37 -8
- package/scripts/record-public-channel-publication.mjs +178 -178
- package/scripts/record-public-ci-run.mjs +180 -180
- package/scripts/record-public-release.mjs +175 -175
- package/scripts/record-public-repository-settings.mjs +209 -209
- package/scripts/record-public-security-contact.mjs +157 -157
- package/scripts/record-session-sync.mjs +87 -0
- package/scripts/run-gse-command.mjs +79 -47
- package/scripts/run-validation-profile.mjs +24 -5
- package/scripts/sign-gse-package.mjs +83 -83
- package/scripts/update-project-state.mjs +223 -223
- package/scripts/validate-gse.mjs +216 -0
- 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
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
const
|
|
93
|
-
?
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
const
|
|
98
|
-
|
|
99
|
-
'
|
|
100
|
-
'README
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
'
|
|
105
|
-
'
|
|
106
|
-
'
|
|
107
|
-
'
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
check('
|
|
118
|
-
check('
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
lines
|
|
167
|
-
lines.push('
|
|
168
|
-
lines.push('')
|
|
169
|
-
lines.push('
|
|
170
|
-
lines.push('
|
|
171
|
-
lines.push('
|
|
172
|
-
lines.push('
|
|
173
|
-
lines.push('
|
|
174
|
-
lines.push('')
|
|
175
|
-
lines.push('
|
|
176
|
-
lines.push('')
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
lines.push('')
|
|
182
|
-
lines.push('
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
}
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
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)
|