@t275005746/gse 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/ISSUE_TEMPLATE/bug_report.yml +42 -42
- package/.github/ISSUE_TEMPLATE/change_request.yml +50 -50
- package/.github/ISSUE_TEMPLATE/config.yml +5 -5
- package/.github/PULL_REQUEST_TEMPLATE.md +38 -38
- package/.github/workflows/validate-gse.yml +33 -33
- package/.gse/README.md +18 -18
- package/.gse/gse-development-protocol.md +50 -50
- package/.gse/project-profile.md +29 -29
- package/.gse/quality-gates.md +25 -25
- package/.gse/releases/public-registry-publication-npm.md +49 -0
- package/.gse/releases/public-release-owner-required.md +65 -65
- package/.gse/releases/public-security-contact-owner-required.md +45 -45
- package/.gse/state.json +3 -4
- package/CHANGELOG.md +24 -24
- package/CONTRIBUTING.md +64 -64
- package/LICENSE +21 -21
- package/README.md +1 -1
- package/README.zh-CN.md +1 -1
- package/SECURITY.md +41 -41
- package/SUPPORT.md +38 -38
- package/assets/marketplace/README.md +7 -7
- package/assets/marketplace/gse-listing.json +75 -75
- package/assets/templates/acceptance-execution-packet.md +73 -73
- package/assets/templates/adr.md +14 -14
- package/assets/templates/change-brief.md +16 -16
- package/assets/templates/design.md +18 -18
- package/assets/templates/dispatch-packet.md +104 -104
- package/assets/templates/evidence.md +14 -14
- package/assets/templates/execution-quality-pack.md +65 -65
- package/assets/templates/goal-map.md +21 -21
- package/assets/templates/host-adapter.md +48 -48
- package/assets/templates/host-ui-invocation-record.md +42 -42
- package/assets/templates/incident-review.md +60 -60
- package/assets/templates/public-channel-publication-record.md +49 -49
- package/assets/templates/public-ci-run-record.md +53 -53
- package/assets/templates/public-release-record.md +65 -65
- package/assets/templates/public-repository-settings-record.md +59 -59
- package/assets/templates/public-security-contact-record.md +45 -45
- package/assets/templates/release-trust-record.md +32 -32
- package/assets/templates/review.md +18 -18
- package/assets/templates/spec.md +16 -16
- package/assets/templates/target-adoption-evidence.md +29 -29
- package/assets/templates/tasks.md +17 -17
- package/assets/templates/update-release-acceptance-record.md +58 -58
- package/examples/README.md +22 -22
- package/examples/agent-runtime-host/.claude/gse-adapter.md +6 -6
- package/examples/agent-runtime-host/.codex/gse-adapter.md +7 -7
- package/examples/agent-runtime-host/.gse/goal-map.md +7 -7
- package/examples/agent-runtime-host/.gse/project-profile.md +27 -27
- package/examples/agent-runtime-host/.gse/tooling.md +5 -5
- package/examples/agent-runtime-host/.mcp.json +9 -9
- package/examples/agent-runtime-host/AGENTS.md +5 -5
- package/examples/agent-runtime-host/README.md +10 -10
- package/examples/agent-runtime-host/docs/model-routing.md +5 -5
- package/examples/cli-tool/.gse/project-profile.md +21 -21
- package/examples/cli-tool/AGENTS.md +5 -5
- package/examples/cli-tool/README.md +12 -12
- package/examples/cli-tool/package.json +21 -21
- package/examples/small-app/.env.example +2 -2
- package/examples/small-app/.github/workflows/ci.yml +8 -8
- package/examples/small-app/AGENTS.md +5 -5
- package/examples/small-app/README.md +12 -12
- package/examples/small-app/package.json +26 -26
- package/examples/small-app/playwright.config.ts +4 -4
- package/package.json +53 -53
- package/references/adoption-recipes.md +171 -171
- package/references/agent-roles.md +49 -49
- package/references/architecture-health.md +101 -101
- package/references/benchmark-audit.md +73 -73
- package/references/community-channels.md +46 -46
- package/references/compatibility.md +70 -70
- package/references/design-basis.md +38 -38
- package/references/domain-model.md +129 -129
- package/references/domain-quality-gates.md +75 -75
- package/references/drift-audit.md +81 -81
- package/references/evidence-taxonomy.md +123 -123
- package/references/file-ownership.md +107 -107
- package/references/final-readiness.md +84 -84
- package/references/forward-test.md +133 -133
- package/references/goal-map.md +36 -36
- package/references/host-adapters.md +119 -119
- package/references/learning-system.md +35 -35
- package/references/marketplace-discovery.md +46 -46
- package/references/model-routing.md +103 -103
- package/references/open-source-defaults.md +39 -39
- package/references/operating-model.md +52 -52
- package/references/packaging.md +277 -277
- package/references/project-agent-workspace.md +89 -89
- package/references/project-bootstrap.md +122 -122
- package/references/project-profile.md +57 -57
- package/references/public-release.md +174 -174
- package/references/quality-gates.md +100 -100
- package/references/recovery.md +176 -176
- package/references/release-trust.md +43 -43
- package/references/release.md +126 -126
- package/references/review.md +141 -141
- package/references/router.md +90 -90
- package/references/spec-workflow.md +66 -66
- package/references/task-levels.md +81 -81
- package/references/tool-adapters.md +73 -73
- package/scripts/audit-acceptance-execution-packet.mjs +133 -133
- package/scripts/audit-adoption-recipes.mjs +99 -99
- package/scripts/audit-change-lifecycle.mjs +77 -77
- package/scripts/audit-change-system.mjs +134 -134
- package/scripts/audit-ci-readiness.mjs +107 -107
- package/scripts/audit-close-gate.mjs +323 -323
- package/scripts/audit-command-adapters.mjs +91 -91
- package/scripts/audit-command-execution.mjs +210 -210
- package/scripts/audit-compatibility.mjs +149 -149
- package/scripts/audit-completion-readiness.mjs +292 -292
- package/scripts/audit-distribution.mjs +251 -251
- package/scripts/audit-domain-quality-gates.mjs +108 -108
- package/scripts/audit-evidence-placeholders.mjs +126 -126
- package/scripts/audit-final-readiness-promotion.mjs +255 -255
- package/scripts/audit-final-readiness.mjs +226 -226
- package/scripts/audit-fixtures.mjs +154 -154
- package/scripts/audit-fresh-session-readiness.mjs +177 -177
- package/scripts/audit-host-runtime-evidence-handoff.mjs +159 -159
- package/scripts/audit-host-runtime-invocation-drill.mjs +240 -240
- package/scripts/audit-host-runtime-invocations.mjs +254 -254
- package/scripts/audit-host-ui-invocation.mjs +132 -132
- package/scripts/audit-marketplace-discovery.mjs +122 -122
- package/scripts/audit-npm-package-metadata.mjs +155 -155
- package/scripts/audit-npm-publish-dry-run.mjs +191 -169
- package/scripts/audit-npm-tarball-install.mjs +191 -191
- package/scripts/audit-open-source-defaults.mjs +92 -92
- package/scripts/audit-open-source-readiness.mjs +97 -97
- package/scripts/audit-project.mjs +138 -138
- package/scripts/audit-public-acceptance-command-dry-run-drill.mjs +203 -203
- package/scripts/audit-public-acceptance-readiness.mjs +224 -224
- package/scripts/audit-public-channel-publication.mjs +248 -248
- package/scripts/audit-public-ci-run.mjs +184 -184
- package/scripts/audit-public-collaboration-templates.mjs +98 -98
- package/scripts/audit-public-external-gate-probe.mjs +206 -206
- package/scripts/audit-public-release-decision.mjs +201 -201
- package/scripts/audit-public-release-metadata.mjs +176 -176
- package/scripts/audit-public-repository-settings.mjs +237 -237
- package/scripts/audit-public-security-contact.mjs +171 -171
- package/scripts/audit-readme-docs.mjs +6 -4
- package/scripts/audit-recovery-readiness.mjs +98 -98
- package/scripts/audit-release-readiness.mjs +106 -106
- package/scripts/audit-release-trust.mjs +62 -62
- package/scripts/audit-remote-distribution.mjs +266 -266
- package/scripts/audit-roadmap-consistency.mjs +235 -235
- package/scripts/audit-signing.mjs +147 -147
- package/scripts/audit-state-freshness.mjs +14 -9
- package/scripts/audit-target-adoption-evidence.mjs +117 -117
- package/scripts/audit-target-project.mjs +507 -507
- package/scripts/audit-update-release-acceptance.mjs +136 -136
- package/scripts/audit-v1-target-validation.mjs +269 -269
- package/scripts/audit-validation-profiles.mjs +125 -125
- package/scripts/close-change.mjs +116 -116
- package/scripts/discover-project-profile.mjs +307 -307
- package/scripts/generate-command-adapter.mjs +231 -231
- package/scripts/generate-final-acceptance-packet.mjs +181 -181
- package/scripts/generate-final-form-progress-report.mjs +205 -205
- package/scripts/generate-host-runtime-evidence-handoff.mjs +206 -206
- package/scripts/generate-owner-external-gate-kit.mjs +295 -295
- package/scripts/generate-public-acceptance-handoff.mjs +168 -168
- package/scripts/generate-public-release-checklist.mjs +207 -207
- package/scripts/generate-release-bundle.mjs +505 -505
- package/scripts/generate-release-owner-action-plan.mjs +172 -172
- package/scripts/generate-release-status-manifest.mjs +200 -200
- package/scripts/generate-session-prompt.mjs +188 -188
- package/scripts/gse.mjs +67 -67
- package/scripts/init-change.mjs +265 -265
- package/scripts/init-project.mjs +785 -785
- package/scripts/install-gse.mjs +234 -234
- package/scripts/lib/evidence-placeholders.mjs +28 -28
- package/scripts/package-gse.mjs +174 -174
- package/scripts/probe-public-external-gates.mjs +167 -167
- package/scripts/record-host-invocation.mjs +151 -151
- package/scripts/record-public-channel-publication.mjs +178 -178
- package/scripts/record-public-ci-run.mjs +180 -180
- package/scripts/record-public-release.mjs +175 -175
- package/scripts/record-public-repository-settings.mjs +209 -209
- package/scripts/record-public-security-contact.mjs +157 -157
- package/scripts/sign-gse-package.mjs +83 -83
- package/scripts/update-project-state.mjs +223 -223
- package/scripts/verify-gse-package.mjs +85 -85
|
@@ -1,255 +1,255 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
import fs from 'node:fs'
|
|
3
|
-
import os from 'node:os'
|
|
4
|
-
import path from 'node:path'
|
|
5
|
-
import { spawnSync } from 'node:child_process'
|
|
6
|
-
|
|
7
|
-
const args = process.argv.slice(2)
|
|
8
|
-
|
|
9
|
-
function readArg(name, fallback = null) {
|
|
10
|
-
const index = args.indexOf(name)
|
|
11
|
-
if (index === -1) return fallback
|
|
12
|
-
return args[index + 1] ?? fallback
|
|
13
|
-
}
|
|
14
|
-
|
|
15
|
-
const root = path.resolve(readArg('--root', path.join(import.meta.dirname, '..')))
|
|
16
|
-
const jsonOnly = args.includes('--json')
|
|
17
|
-
|
|
18
|
-
function run(command, commandArgs, cwd = root) {
|
|
19
|
-
const result = spawnSync(command, commandArgs, {
|
|
20
|
-
cwd,
|
|
21
|
-
encoding: 'utf8',
|
|
22
|
-
windowsHide: true,
|
|
23
|
-
})
|
|
24
|
-
return {
|
|
25
|
-
status: result.status ?? 1,
|
|
26
|
-
stdout: (result.stdout ?? '').trim(),
|
|
27
|
-
stderr: (result.stderr ?? '').trim(),
|
|
28
|
-
command: [command, ...commandArgs].join(' '),
|
|
29
|
-
}
|
|
30
|
-
}
|
|
31
|
-
|
|
32
|
-
function parseJson(stdout) {
|
|
33
|
-
try {
|
|
34
|
-
return JSON.parse(stdout)
|
|
35
|
-
} catch {
|
|
36
|
-
return null
|
|
37
|
-
}
|
|
38
|
-
}
|
|
39
|
-
|
|
40
|
-
function check(id, label, ok, evidence, risk = '') {
|
|
41
|
-
return { id, label, status: ok ? 'passed' : 'failed', evidence, risk }
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
function copySkillFixture() {
|
|
45
|
-
const fixture = fs.mkdtempSync(path.join(os.tmpdir(), 'gse-final-readiness-promotion-'))
|
|
46
|
-
fs.cpSync(root, fixture, {
|
|
47
|
-
recursive: true,
|
|
48
|
-
filter(source) {
|
|
49
|
-
const normalized = source.replace(/\\/g, '/')
|
|
50
|
-
return !normalized.includes('/.git/') && !normalized.includes('/node_modules/')
|
|
51
|
-
},
|
|
52
|
-
})
|
|
53
|
-
fs.writeFileSync(path.join(fixture, 'LICENSE'), 'MIT License\n\nFixture only.\n', 'utf8')
|
|
54
|
-
return fixture
|
|
55
|
-
}
|
|
56
|
-
|
|
57
|
-
function runInFixture(fixture, relativeScript, commandArgs) {
|
|
58
|
-
return run(process.execPath, [path.join(fixture, relativeScript), '--root', fixture, ...commandArgs, '--force', '--json'], fixture)
|
|
59
|
-
}
|
|
60
|
-
|
|
61
|
-
const fixture = copySkillFixture()
|
|
62
|
-
|
|
63
|
-
const records = [
|
|
64
|
-
runInFixture(fixture, 'scripts/record-public-release.mjs', [
|
|
65
|
-
'--license-status', 'selected',
|
|
66
|
-
'--spdx', 'MIT',
|
|
67
|
-
'--license-file', 'LICENSE',
|
|
68
|
-
'--approved-by', 'gse-maintainer',
|
|
69
|
-
'--decision-date', '2026-07-06',
|
|
70
|
-
'--evidence-status', 'accepted',
|
|
71
|
-
'--out', path.join(fixture, '.gse', 'releases', 'fixture-public-release-selected.md'),
|
|
72
|
-
]),
|
|
73
|
-
runInFixture(fixture, 'scripts/record-public-security-contact.mjs', [
|
|
74
|
-
'--contact-status', 'accepted',
|
|
75
|
-
'--contact-type', 'url',
|
|
76
|
-
'--contact-value', 'https://gse.dev/security',
|
|
77
|
-
'--evidence-owner', 'gse-maintainer',
|
|
78
|
-
'--evidence-date', '2026-07-06',
|
|
79
|
-
'--evidence-url', 'https://gse.dev/security-policy',
|
|
80
|
-
'--is-public', 'true',
|
|
81
|
-
'--security-policy-updated', 'true',
|
|
82
|
-
'--evidence-status', 'accepted',
|
|
83
|
-
'--accepted-by', 'gse-maintainer',
|
|
84
|
-
'--accepted-at', '2026-07-06',
|
|
85
|
-
'--out', path.join(fixture, '.gse', 'releases', 'fixture-public-security-contact.md'),
|
|
86
|
-
]),
|
|
87
|
-
runInFixture(fixture, 'scripts/record-public-repository-settings.mjs', [
|
|
88
|
-
'--repository-url', 'https://github.com/gse-org/gse',
|
|
89
|
-
'--visibility', 'public',
|
|
90
|
-
'--settings-status', 'accepted',
|
|
91
|
-
'--evidence-owner', 'gse-maintainer',
|
|
92
|
-
'--evidence-date', '2026-07-06',
|
|
93
|
-
'--evidence-url', 'https://github.com/gse-org/gse/settings/branches',
|
|
94
|
-
'--issues-enabled', 'true',
|
|
95
|
-
'--pull-requests-enabled', 'true',
|
|
96
|
-
'--security-policy-visible', 'true',
|
|
97
|
-
'--branch-protection-enabled', 'true',
|
|
98
|
-
'--required-status-checks-enabled', 'true',
|
|
99
|
-
'--required-checks', 'Validate GSE',
|
|
100
|
-
'--require-review-before-merge', 'true',
|
|
101
|
-
'--require-conversation-resolution', 'true',
|
|
102
|
-
'--restrict-force-pushes', 'true',
|
|
103
|
-
'--restrict-deletions', 'true',
|
|
104
|
-
'--evidence-status', 'accepted',
|
|
105
|
-
'--accepted-by', 'gse-maintainer',
|
|
106
|
-
'--accepted-at', '2026-07-06',
|
|
107
|
-
'--out', path.join(fixture, '.gse', 'releases', 'fixture-public-repository-settings.md'),
|
|
108
|
-
]),
|
|
109
|
-
runInFixture(fixture, 'scripts/record-public-ci-run.mjs', [
|
|
110
|
-
'--run-status', 'accepted',
|
|
111
|
-
'--run-conclusion', 'success',
|
|
112
|
-
'--repository-url', 'https://github.com/gse-org/gse',
|
|
113
|
-
'--workflow-name', 'Validate GSE',
|
|
114
|
-
'--workflow-file', '.github/workflows/validate-gse.yml',
|
|
115
|
-
'--run-url', 'https://github.com/gse-org/gse/actions/runs/123',
|
|
116
|
-
'--commit-sha', '0123456789abcdef0123456789abcdef01234567',
|
|
117
|
-
'--branch', 'main',
|
|
118
|
-
'--required-checks', 'Validate GSE',
|
|
119
|
-
'--evidence-owner', 'gse-maintainer',
|
|
120
|
-
'--evidence-date', '2026-07-06',
|
|
121
|
-
'--evidence-url', 'https://github.com/gse-org/gse/actions/runs/123',
|
|
122
|
-
'--evidence-status', 'accepted',
|
|
123
|
-
'--accepted-by', 'gse-maintainer',
|
|
124
|
-
'--accepted-at', '2026-07-06',
|
|
125
|
-
'--proves-public-ci-run', 'true',
|
|
126
|
-
'--proves-required-checks', 'true',
|
|
127
|
-
'--proves-release-commit', 'true',
|
|
128
|
-
'--out', path.join(fixture, '.gse', 'releases', 'fixture-public-ci-run.md'),
|
|
129
|
-
]),
|
|
130
|
-
runInFixture(fixture, 'scripts/record-public-channel-publication.mjs', [
|
|
131
|
-
'--publication-status', 'accepted',
|
|
132
|
-
'--channel-type', 'package-registry',
|
|
133
|
-
'--channel-name', 'npm',
|
|
134
|
-
'--channel-url', 'https://registry.npmjs.org/gse',
|
|
135
|
-
'--version', '1.0.0',
|
|
136
|
-
'--artifact-digest', 'sha256:fixture',
|
|
137
|
-
'--review-status', 'published',
|
|
138
|
-
'--evidence-owner', 'gse-maintainer',
|
|
139
|
-
'--evidence-date', '2026-07-06',
|
|
140
|
-
'--evidence-url', 'https://registry.npmjs.org/gse/1.0.0',
|
|
141
|
-
'--evidence-status', 'accepted',
|
|
142
|
-
'--accepted-by', 'gse-maintainer',
|
|
143
|
-
'--accepted-at', '2026-07-06',
|
|
144
|
-
'--proves-registry-publication', 'true',
|
|
145
|
-
'--proves-channel-installability', 'true',
|
|
146
|
-
'--out', path.join(fixture, '.gse', 'releases', 'fixture-public-registry-publication.md'),
|
|
147
|
-
]),
|
|
148
|
-
runInFixture(fixture, 'scripts/record-public-channel-publication.mjs', [
|
|
149
|
-
'--publication-status', 'accepted',
|
|
150
|
-
'--channel-type', 'marketplace',
|
|
151
|
-
'--channel-name', 'Codex Marketplace',
|
|
152
|
-
'--channel-url', 'https://marketplace.openai.com/gse',
|
|
153
|
-
'--version', '1.0.0',
|
|
154
|
-
'--review-status', 'approved',
|
|
155
|
-
'--evidence-owner', 'gse-maintainer',
|
|
156
|
-
'--evidence-date', '2026-07-06',
|
|
157
|
-
'--evidence-url', 'https://marketplace.openai.com/gse/review',
|
|
158
|
-
'--evidence-status', 'accepted',
|
|
159
|
-
'--accepted-by', 'gse-maintainer',
|
|
160
|
-
'--accepted-at', '2026-07-06',
|
|
161
|
-
'--proves-marketplace-approval', 'true',
|
|
162
|
-
'--proves-channel-installability', 'true',
|
|
163
|
-
'--out', path.join(fixture, '.gse', 'releases', 'fixture-marketplace-approval.md'),
|
|
164
|
-
]),
|
|
165
|
-
runInFixture(fixture, 'scripts/record-host-invocation.mjs', [
|
|
166
|
-
'--host', 'Fixture Native Host',
|
|
167
|
-
'--invocation-method', 'native-slash-command',
|
|
168
|
-
'--command', '/gse help',
|
|
169
|
-
'--status', 'accepted',
|
|
170
|
-
'--evidence-owner', 'gse-maintainer',
|
|
171
|
-
'--evidence', 'fixture native slash-command transcript',
|
|
172
|
-
'--verification-command', 'node scripts/audit-final-readiness.mjs --root __GSE__ --json',
|
|
173
|
-
'--native-slash-command', 'true',
|
|
174
|
-
'--portable-text-command', 'false',
|
|
175
|
-
'--generated-pointer', 'false',
|
|
176
|
-
'--owner-acceptance-required', 'false',
|
|
177
|
-
'--out', path.join(fixture, '.gse', 'evidence', 'host-invocations', 'fixture-native-host.md'),
|
|
178
|
-
]),
|
|
179
|
-
]
|
|
180
|
-
|
|
181
|
-
const finalReadiness = run(process.execPath, [path.join(fixture, 'scripts', 'audit-final-readiness.mjs'), '--root', fixture, '--json'], fixture)
|
|
182
|
-
const finalReadinessData = parseJson(finalReadiness.stdout)
|
|
183
|
-
const matrix = finalReadinessData?.matrix ?? []
|
|
184
|
-
const promotedAreas = [
|
|
185
|
-
'License decision',
|
|
186
|
-
'Public security contact',
|
|
187
|
-
'Public repository settings',
|
|
188
|
-
'Public CI run',
|
|
189
|
-
'Public registry publication',
|
|
190
|
-
'Marketplace approval',
|
|
191
|
-
'Native slash command',
|
|
192
|
-
'Other host runtime invocation',
|
|
193
|
-
]
|
|
194
|
-
const areaStatus = new Map(matrix.map((row) => [row.area, row.status]))
|
|
195
|
-
const areaEvidence = new Map(matrix.map((row) => [row.area, row.evidence]))
|
|
196
|
-
const recordFailures = records.filter((item) => item.status !== 0)
|
|
197
|
-
|
|
198
|
-
const checks = [
|
|
199
|
-
check('FRP01', 'accepted fixture records are generated', recordFailures.length === 0, recordFailures.map((item) => item.stderr || item.stdout || item.command).join('; ') || 'all accepted records written'),
|
|
200
|
-
check('FRP02', 'final readiness audit runs on accepted-record fixture', finalReadiness.status === 0 && finalReadinessData?.summary?.status === 'passed', finalReadiness.stderr || 'audit-final-readiness fixture run'),
|
|
201
|
-
check('FRP03', 'owner/external rows promote to verified from accepted records', promotedAreas.every((area) => areaStatus.get(area) === 'verified'), promotedAreas.map((area) => `${area}:${areaStatus.get(area) ?? 'missing'}`).join(', ')),
|
|
202
|
-
check('FRP04', 'promoted rows cite concrete record evidence', promotedAreas.every((area) => String(areaEvidence.get(area) ?? '').includes('.gse/')), promotedAreas.map((area) => `${area}:${areaEvidence.get(area) ?? 'missing'}`).join(', ')),
|
|
203
|
-
check('FRP05', 'public accepted becomes verified when every final row has accepted evidence', finalReadinessData?.workflows?.publicAccepted === 'verified', finalReadinessData?.workflows?.publicAccepted ?? 'unknown'),
|
|
204
|
-
]
|
|
205
|
-
|
|
206
|
-
const passed = checks.filter((item) => item.status === 'passed').length
|
|
207
|
-
const failed = checks.length - passed
|
|
208
|
-
const report = {
|
|
209
|
-
root,
|
|
210
|
-
fixtureRoot: fixture,
|
|
211
|
-
generatedAt: new Date().toISOString(),
|
|
212
|
-
summary: { status: failed === 0 ? 'passed' : 'failed', passed, failed, total: checks.length },
|
|
213
|
-
workflows: {
|
|
214
|
-
finalReadinessPromotion: failed === 0 ? 'verified' : 'failed',
|
|
215
|
-
publicAcceptedFixture: finalReadinessData?.workflows?.publicAccepted ?? 'unknown',
|
|
216
|
-
},
|
|
217
|
-
limits: [
|
|
218
|
-
'This audit verifies promotion mechanics with fixture accepted records.',
|
|
219
|
-
'It does not create real owner decisions, public CI runs, public repository settings, registry publications, marketplace approvals, or native host invocations.',
|
|
220
|
-
],
|
|
221
|
-
checks,
|
|
222
|
-
}
|
|
223
|
-
|
|
224
|
-
function renderMarkdown(data) {
|
|
225
|
-
const lines = []
|
|
226
|
-
lines.push('# GSE Final Readiness Promotion Audit')
|
|
227
|
-
lines.push('')
|
|
228
|
-
lines.push('Generated: ' + data.generatedAt)
|
|
229
|
-
lines.push('Root: ' + data.root)
|
|
230
|
-
lines.push('Fixture root: ' + data.fixtureRoot)
|
|
231
|
-
lines.push('')
|
|
232
|
-
lines.push('## Summary')
|
|
233
|
-
lines.push('')
|
|
234
|
-
lines.push('- Status: ' + data.summary.status)
|
|
235
|
-
lines.push('- Checks: ' + data.summary.passed + '/' + data.summary.total)
|
|
236
|
-
lines.push('- Final readiness promotion: ' + data.workflows.finalReadinessPromotion)
|
|
237
|
-
lines.push('- Public accepted fixture: ' + data.workflows.publicAcceptedFixture)
|
|
238
|
-
lines.push('')
|
|
239
|
-
lines.push('## Checks')
|
|
240
|
-
lines.push('')
|
|
241
|
-
for (const item of data.checks) {
|
|
242
|
-
const marker = item.status === 'passed' ? '[x]' : '[ ]'
|
|
243
|
-
lines.push('- ' + marker + ' ' + item.id + ' ' + item.label + ': ' + item.evidence)
|
|
244
|
-
}
|
|
245
|
-
lines.push('')
|
|
246
|
-
lines.push('## Limits')
|
|
247
|
-
lines.push('')
|
|
248
|
-
for (const item of data.limits) lines.push('- ' + item)
|
|
249
|
-
return lines.join('\n') + '\n'
|
|
250
|
-
}
|
|
251
|
-
|
|
252
|
-
if (jsonOnly) console.log(JSON.stringify(report, null, 2))
|
|
253
|
-
else console.log(renderMarkdown(report))
|
|
254
|
-
|
|
255
|
-
if (failed > 0) process.exit(1)
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import fs from 'node:fs'
|
|
3
|
+
import os from 'node:os'
|
|
4
|
+
import path from 'node:path'
|
|
5
|
+
import { spawnSync } from 'node:child_process'
|
|
6
|
+
|
|
7
|
+
const args = process.argv.slice(2)
|
|
8
|
+
|
|
9
|
+
function readArg(name, fallback = null) {
|
|
10
|
+
const index = args.indexOf(name)
|
|
11
|
+
if (index === -1) return fallback
|
|
12
|
+
return args[index + 1] ?? fallback
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
const root = path.resolve(readArg('--root', path.join(import.meta.dirname, '..')))
|
|
16
|
+
const jsonOnly = args.includes('--json')
|
|
17
|
+
|
|
18
|
+
function run(command, commandArgs, cwd = root) {
|
|
19
|
+
const result = spawnSync(command, commandArgs, {
|
|
20
|
+
cwd,
|
|
21
|
+
encoding: 'utf8',
|
|
22
|
+
windowsHide: true,
|
|
23
|
+
})
|
|
24
|
+
return {
|
|
25
|
+
status: result.status ?? 1,
|
|
26
|
+
stdout: (result.stdout ?? '').trim(),
|
|
27
|
+
stderr: (result.stderr ?? '').trim(),
|
|
28
|
+
command: [command, ...commandArgs].join(' '),
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
function parseJson(stdout) {
|
|
33
|
+
try {
|
|
34
|
+
return JSON.parse(stdout)
|
|
35
|
+
} catch {
|
|
36
|
+
return null
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
function check(id, label, ok, evidence, risk = '') {
|
|
41
|
+
return { id, label, status: ok ? 'passed' : 'failed', evidence, risk }
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
function copySkillFixture() {
|
|
45
|
+
const fixture = fs.mkdtempSync(path.join(os.tmpdir(), 'gse-final-readiness-promotion-'))
|
|
46
|
+
fs.cpSync(root, fixture, {
|
|
47
|
+
recursive: true,
|
|
48
|
+
filter(source) {
|
|
49
|
+
const normalized = source.replace(/\\/g, '/')
|
|
50
|
+
return !normalized.includes('/.git/') && !normalized.includes('/node_modules/')
|
|
51
|
+
},
|
|
52
|
+
})
|
|
53
|
+
fs.writeFileSync(path.join(fixture, 'LICENSE'), 'MIT License\n\nFixture only.\n', 'utf8')
|
|
54
|
+
return fixture
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
function runInFixture(fixture, relativeScript, commandArgs) {
|
|
58
|
+
return run(process.execPath, [path.join(fixture, relativeScript), '--root', fixture, ...commandArgs, '--force', '--json'], fixture)
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
const fixture = copySkillFixture()
|
|
62
|
+
|
|
63
|
+
const records = [
|
|
64
|
+
runInFixture(fixture, 'scripts/record-public-release.mjs', [
|
|
65
|
+
'--license-status', 'selected',
|
|
66
|
+
'--spdx', 'MIT',
|
|
67
|
+
'--license-file', 'LICENSE',
|
|
68
|
+
'--approved-by', 'gse-maintainer',
|
|
69
|
+
'--decision-date', '2026-07-06',
|
|
70
|
+
'--evidence-status', 'accepted',
|
|
71
|
+
'--out', path.join(fixture, '.gse', 'releases', 'fixture-public-release-selected.md'),
|
|
72
|
+
]),
|
|
73
|
+
runInFixture(fixture, 'scripts/record-public-security-contact.mjs', [
|
|
74
|
+
'--contact-status', 'accepted',
|
|
75
|
+
'--contact-type', 'url',
|
|
76
|
+
'--contact-value', 'https://gse.dev/security',
|
|
77
|
+
'--evidence-owner', 'gse-maintainer',
|
|
78
|
+
'--evidence-date', '2026-07-06',
|
|
79
|
+
'--evidence-url', 'https://gse.dev/security-policy',
|
|
80
|
+
'--is-public', 'true',
|
|
81
|
+
'--security-policy-updated', 'true',
|
|
82
|
+
'--evidence-status', 'accepted',
|
|
83
|
+
'--accepted-by', 'gse-maintainer',
|
|
84
|
+
'--accepted-at', '2026-07-06',
|
|
85
|
+
'--out', path.join(fixture, '.gse', 'releases', 'fixture-public-security-contact.md'),
|
|
86
|
+
]),
|
|
87
|
+
runInFixture(fixture, 'scripts/record-public-repository-settings.mjs', [
|
|
88
|
+
'--repository-url', 'https://github.com/gse-org/gse',
|
|
89
|
+
'--visibility', 'public',
|
|
90
|
+
'--settings-status', 'accepted',
|
|
91
|
+
'--evidence-owner', 'gse-maintainer',
|
|
92
|
+
'--evidence-date', '2026-07-06',
|
|
93
|
+
'--evidence-url', 'https://github.com/gse-org/gse/settings/branches',
|
|
94
|
+
'--issues-enabled', 'true',
|
|
95
|
+
'--pull-requests-enabled', 'true',
|
|
96
|
+
'--security-policy-visible', 'true',
|
|
97
|
+
'--branch-protection-enabled', 'true',
|
|
98
|
+
'--required-status-checks-enabled', 'true',
|
|
99
|
+
'--required-checks', 'Validate GSE',
|
|
100
|
+
'--require-review-before-merge', 'true',
|
|
101
|
+
'--require-conversation-resolution', 'true',
|
|
102
|
+
'--restrict-force-pushes', 'true',
|
|
103
|
+
'--restrict-deletions', 'true',
|
|
104
|
+
'--evidence-status', 'accepted',
|
|
105
|
+
'--accepted-by', 'gse-maintainer',
|
|
106
|
+
'--accepted-at', '2026-07-06',
|
|
107
|
+
'--out', path.join(fixture, '.gse', 'releases', 'fixture-public-repository-settings.md'),
|
|
108
|
+
]),
|
|
109
|
+
runInFixture(fixture, 'scripts/record-public-ci-run.mjs', [
|
|
110
|
+
'--run-status', 'accepted',
|
|
111
|
+
'--run-conclusion', 'success',
|
|
112
|
+
'--repository-url', 'https://github.com/gse-org/gse',
|
|
113
|
+
'--workflow-name', 'Validate GSE',
|
|
114
|
+
'--workflow-file', '.github/workflows/validate-gse.yml',
|
|
115
|
+
'--run-url', 'https://github.com/gse-org/gse/actions/runs/123',
|
|
116
|
+
'--commit-sha', '0123456789abcdef0123456789abcdef01234567',
|
|
117
|
+
'--branch', 'main',
|
|
118
|
+
'--required-checks', 'Validate GSE',
|
|
119
|
+
'--evidence-owner', 'gse-maintainer',
|
|
120
|
+
'--evidence-date', '2026-07-06',
|
|
121
|
+
'--evidence-url', 'https://github.com/gse-org/gse/actions/runs/123',
|
|
122
|
+
'--evidence-status', 'accepted',
|
|
123
|
+
'--accepted-by', 'gse-maintainer',
|
|
124
|
+
'--accepted-at', '2026-07-06',
|
|
125
|
+
'--proves-public-ci-run', 'true',
|
|
126
|
+
'--proves-required-checks', 'true',
|
|
127
|
+
'--proves-release-commit', 'true',
|
|
128
|
+
'--out', path.join(fixture, '.gse', 'releases', 'fixture-public-ci-run.md'),
|
|
129
|
+
]),
|
|
130
|
+
runInFixture(fixture, 'scripts/record-public-channel-publication.mjs', [
|
|
131
|
+
'--publication-status', 'accepted',
|
|
132
|
+
'--channel-type', 'package-registry',
|
|
133
|
+
'--channel-name', 'npm',
|
|
134
|
+
'--channel-url', 'https://registry.npmjs.org/gse',
|
|
135
|
+
'--version', '1.0.0',
|
|
136
|
+
'--artifact-digest', 'sha256:fixture',
|
|
137
|
+
'--review-status', 'published',
|
|
138
|
+
'--evidence-owner', 'gse-maintainer',
|
|
139
|
+
'--evidence-date', '2026-07-06',
|
|
140
|
+
'--evidence-url', 'https://registry.npmjs.org/gse/1.0.0',
|
|
141
|
+
'--evidence-status', 'accepted',
|
|
142
|
+
'--accepted-by', 'gse-maintainer',
|
|
143
|
+
'--accepted-at', '2026-07-06',
|
|
144
|
+
'--proves-registry-publication', 'true',
|
|
145
|
+
'--proves-channel-installability', 'true',
|
|
146
|
+
'--out', path.join(fixture, '.gse', 'releases', 'fixture-public-registry-publication.md'),
|
|
147
|
+
]),
|
|
148
|
+
runInFixture(fixture, 'scripts/record-public-channel-publication.mjs', [
|
|
149
|
+
'--publication-status', 'accepted',
|
|
150
|
+
'--channel-type', 'marketplace',
|
|
151
|
+
'--channel-name', 'Codex Marketplace',
|
|
152
|
+
'--channel-url', 'https://marketplace.openai.com/gse',
|
|
153
|
+
'--version', '1.0.0',
|
|
154
|
+
'--review-status', 'approved',
|
|
155
|
+
'--evidence-owner', 'gse-maintainer',
|
|
156
|
+
'--evidence-date', '2026-07-06',
|
|
157
|
+
'--evidence-url', 'https://marketplace.openai.com/gse/review',
|
|
158
|
+
'--evidence-status', 'accepted',
|
|
159
|
+
'--accepted-by', 'gse-maintainer',
|
|
160
|
+
'--accepted-at', '2026-07-06',
|
|
161
|
+
'--proves-marketplace-approval', 'true',
|
|
162
|
+
'--proves-channel-installability', 'true',
|
|
163
|
+
'--out', path.join(fixture, '.gse', 'releases', 'fixture-marketplace-approval.md'),
|
|
164
|
+
]),
|
|
165
|
+
runInFixture(fixture, 'scripts/record-host-invocation.mjs', [
|
|
166
|
+
'--host', 'Fixture Native Host',
|
|
167
|
+
'--invocation-method', 'native-slash-command',
|
|
168
|
+
'--command', '/gse help',
|
|
169
|
+
'--status', 'accepted',
|
|
170
|
+
'--evidence-owner', 'gse-maintainer',
|
|
171
|
+
'--evidence', 'fixture native slash-command transcript',
|
|
172
|
+
'--verification-command', 'node scripts/audit-final-readiness.mjs --root __GSE__ --json',
|
|
173
|
+
'--native-slash-command', 'true',
|
|
174
|
+
'--portable-text-command', 'false',
|
|
175
|
+
'--generated-pointer', 'false',
|
|
176
|
+
'--owner-acceptance-required', 'false',
|
|
177
|
+
'--out', path.join(fixture, '.gse', 'evidence', 'host-invocations', 'fixture-native-host.md'),
|
|
178
|
+
]),
|
|
179
|
+
]
|
|
180
|
+
|
|
181
|
+
const finalReadiness = run(process.execPath, [path.join(fixture, 'scripts', 'audit-final-readiness.mjs'), '--root', fixture, '--json'], fixture)
|
|
182
|
+
const finalReadinessData = parseJson(finalReadiness.stdout)
|
|
183
|
+
const matrix = finalReadinessData?.matrix ?? []
|
|
184
|
+
const promotedAreas = [
|
|
185
|
+
'License decision',
|
|
186
|
+
'Public security contact',
|
|
187
|
+
'Public repository settings',
|
|
188
|
+
'Public CI run',
|
|
189
|
+
'Public registry publication',
|
|
190
|
+
'Marketplace approval',
|
|
191
|
+
'Native slash command',
|
|
192
|
+
'Other host runtime invocation',
|
|
193
|
+
]
|
|
194
|
+
const areaStatus = new Map(matrix.map((row) => [row.area, row.status]))
|
|
195
|
+
const areaEvidence = new Map(matrix.map((row) => [row.area, row.evidence]))
|
|
196
|
+
const recordFailures = records.filter((item) => item.status !== 0)
|
|
197
|
+
|
|
198
|
+
const checks = [
|
|
199
|
+
check('FRP01', 'accepted fixture records are generated', recordFailures.length === 0, recordFailures.map((item) => item.stderr || item.stdout || item.command).join('; ') || 'all accepted records written'),
|
|
200
|
+
check('FRP02', 'final readiness audit runs on accepted-record fixture', finalReadiness.status === 0 && finalReadinessData?.summary?.status === 'passed', finalReadiness.stderr || 'audit-final-readiness fixture run'),
|
|
201
|
+
check('FRP03', 'owner/external rows promote to verified from accepted records', promotedAreas.every((area) => areaStatus.get(area) === 'verified'), promotedAreas.map((area) => `${area}:${areaStatus.get(area) ?? 'missing'}`).join(', ')),
|
|
202
|
+
check('FRP04', 'promoted rows cite concrete record evidence', promotedAreas.every((area) => String(areaEvidence.get(area) ?? '').includes('.gse/')), promotedAreas.map((area) => `${area}:${areaEvidence.get(area) ?? 'missing'}`).join(', ')),
|
|
203
|
+
check('FRP05', 'public accepted becomes verified when every final row has accepted evidence', finalReadinessData?.workflows?.publicAccepted === 'verified', finalReadinessData?.workflows?.publicAccepted ?? 'unknown'),
|
|
204
|
+
]
|
|
205
|
+
|
|
206
|
+
const passed = checks.filter((item) => item.status === 'passed').length
|
|
207
|
+
const failed = checks.length - passed
|
|
208
|
+
const report = {
|
|
209
|
+
root,
|
|
210
|
+
fixtureRoot: fixture,
|
|
211
|
+
generatedAt: new Date().toISOString(),
|
|
212
|
+
summary: { status: failed === 0 ? 'passed' : 'failed', passed, failed, total: checks.length },
|
|
213
|
+
workflows: {
|
|
214
|
+
finalReadinessPromotion: failed === 0 ? 'verified' : 'failed',
|
|
215
|
+
publicAcceptedFixture: finalReadinessData?.workflows?.publicAccepted ?? 'unknown',
|
|
216
|
+
},
|
|
217
|
+
limits: [
|
|
218
|
+
'This audit verifies promotion mechanics with fixture accepted records.',
|
|
219
|
+
'It does not create real owner decisions, public CI runs, public repository settings, registry publications, marketplace approvals, or native host invocations.',
|
|
220
|
+
],
|
|
221
|
+
checks,
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
function renderMarkdown(data) {
|
|
225
|
+
const lines = []
|
|
226
|
+
lines.push('# GSE Final Readiness Promotion Audit')
|
|
227
|
+
lines.push('')
|
|
228
|
+
lines.push('Generated: ' + data.generatedAt)
|
|
229
|
+
lines.push('Root: ' + data.root)
|
|
230
|
+
lines.push('Fixture root: ' + data.fixtureRoot)
|
|
231
|
+
lines.push('')
|
|
232
|
+
lines.push('## Summary')
|
|
233
|
+
lines.push('')
|
|
234
|
+
lines.push('- Status: ' + data.summary.status)
|
|
235
|
+
lines.push('- Checks: ' + data.summary.passed + '/' + data.summary.total)
|
|
236
|
+
lines.push('- Final readiness promotion: ' + data.workflows.finalReadinessPromotion)
|
|
237
|
+
lines.push('- Public accepted fixture: ' + data.workflows.publicAcceptedFixture)
|
|
238
|
+
lines.push('')
|
|
239
|
+
lines.push('## Checks')
|
|
240
|
+
lines.push('')
|
|
241
|
+
for (const item of data.checks) {
|
|
242
|
+
const marker = item.status === 'passed' ? '[x]' : '[ ]'
|
|
243
|
+
lines.push('- ' + marker + ' ' + item.id + ' ' + item.label + ': ' + item.evidence)
|
|
244
|
+
}
|
|
245
|
+
lines.push('')
|
|
246
|
+
lines.push('## Limits')
|
|
247
|
+
lines.push('')
|
|
248
|
+
for (const item of data.limits) lines.push('- ' + item)
|
|
249
|
+
return lines.join('\n') + '\n'
|
|
250
|
+
}
|
|
251
|
+
|
|
252
|
+
if (jsonOnly) console.log(JSON.stringify(report, null, 2))
|
|
253
|
+
else console.log(renderMarkdown(report))
|
|
254
|
+
|
|
255
|
+
if (failed > 0) process.exit(1)
|