@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,203 +1,203 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
import path from 'node:path'
|
|
3
|
-
import { spawnSync } from 'node:child_process'
|
|
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 run(command, commandArgs, options = {}) {
|
|
17
|
-
const result = spawnSync(command, commandArgs, {
|
|
18
|
-
cwd: options.cwd ?? root,
|
|
19
|
-
encoding: 'utf8',
|
|
20
|
-
windowsHide: true,
|
|
21
|
-
shell: Boolean(options.shell),
|
|
22
|
-
})
|
|
23
|
-
return {
|
|
24
|
-
status: result.status ?? 1,
|
|
25
|
-
stdout: (result.stdout ?? '').trim(),
|
|
26
|
-
stderr: (result.stderr ?? '').trim(),
|
|
27
|
-
command: options.shell ? command : [command, ...commandArgs].join(' '),
|
|
28
|
-
}
|
|
29
|
-
}
|
|
30
|
-
|
|
31
|
-
function parseJson(stdout) {
|
|
32
|
-
try {
|
|
33
|
-
return JSON.parse(stdout)
|
|
34
|
-
} catch {
|
|
35
|
-
return null
|
|
36
|
-
}
|
|
37
|
-
}
|
|
38
|
-
|
|
39
|
-
function check(id, label, ok, evidence, risk = '') {
|
|
40
|
-
return { id, label, status: ok ? 'passed' : 'failed', evidence, risk }
|
|
41
|
-
}
|
|
42
|
-
|
|
43
|
-
function shellQuote(value) {
|
|
44
|
-
return JSON.stringify(String(value))
|
|
45
|
-
}
|
|
46
|
-
|
|
47
|
-
const fixtureValues = {
|
|
48
|
-
__GSE__: root,
|
|
49
|
-
__PUBLIC_REPO_URL__: 'https://github.com/example/gse',
|
|
50
|
-
__PUBLIC_CI_RUN_URL__: 'https://github.com/example/gse/actions/runs/123456789',
|
|
51
|
-
__COMMIT_SHA__: '0123456789abcdef0123456789abcdef01234567',
|
|
52
|
-
__BRANCH__: 'main',
|
|
53
|
-
__REQUIRED_CHECKS__: shellQuote('Validate GSE'),
|
|
54
|
-
__OWNER__: 'fixture-owner',
|
|
55
|
-
__YYYY_MM_DD__: '2026-07-07',
|
|
56
|
-
__SETTINGS_EVIDENCE_URL__: 'https://github.com/example/gse/settings/branches',
|
|
57
|
-
__URL_OR_RECORD__: 'https://example.com/security',
|
|
58
|
-
__EMAIL_URL_GITHUB_SECURITY_ADVISORY_OTHER__: 'url',
|
|
59
|
-
__PUBLIC_CONTACT__: 'https://example.com/security',
|
|
60
|
-
__REGISTRY_NAME__: 'npm',
|
|
61
|
-
__REGISTRY_PACKAGE_URL__: 'https://registry.example/gse',
|
|
62
|
-
__MARKETPLACE_NAME__: 'ExampleMarketplace',
|
|
63
|
-
__MARKETPLACE_LISTING_URL__: 'https://marketplace.example/gse',
|
|
64
|
-
__VERSION__: '1.0.0',
|
|
65
|
-
__DIGEST__: 'sha256:fixture',
|
|
66
|
-
__HOST__: 'FixtureHost',
|
|
67
|
-
__VERSION_OR_UNKNOWN__: 'fixture-host-1.0.0',
|
|
68
|
-
__HOST_ADAPTER_OR_COMMAND_PATH__: 'adapters/fixture-native-command.md',
|
|
69
|
-
__HOST_ADAPTER_OR_POINTER__: 'adapters/fixture-pointer.md',
|
|
70
|
-
__HOST_ADAPTER_OR_RUNTIME_ENTRYPOINT__: 'adapters/fixture-runtime-entrypoint.md',
|
|
71
|
-
__THREAD_TRANSCRIPT_SCREENSHOT_OR_HOST_LOG__: 'fixture-native-host-log',
|
|
72
|
-
__THREAD_TRANSCRIPT_SCREENSHOT_TERMINAL_OUTPUT_OR_HOST_LOG__: 'fixture-other-host-log',
|
|
73
|
-
__PORTABLE_TEXT_COMMAND_HOST_UI_COMMAND_RUNTIME_BRIDGE__: 'runtime-bridge',
|
|
74
|
-
__HOST_UI_COMMAND_RUNTIME_BRIDGE_PLUGIN_COMMAND_AGENT_COMMAND__: 'runtime-bridge',
|
|
75
|
-
}
|
|
76
|
-
|
|
77
|
-
function substituteCommand(command) {
|
|
78
|
-
let substituted = command
|
|
79
|
-
for (const [placeholder, value] of Object.entries(fixtureValues)) {
|
|
80
|
-
substituted = substituted.split(placeholder).join(value)
|
|
81
|
-
}
|
|
82
|
-
return substituted
|
|
83
|
-
}
|
|
84
|
-
|
|
85
|
-
function unresolvedPlaceholders(command) {
|
|
86
|
-
return [...command.matchAll(/__[A-Z0-9_]+__/g)].map((match) => match[0])
|
|
87
|
-
}
|
|
88
|
-
|
|
89
|
-
const readiness = run(process.execPath, [path.join(root, 'scripts', 'audit-public-acceptance-readiness.mjs'), '--root', root, '--json'])
|
|
90
|
-
const readinessData = parseJson(readiness.stdout)
|
|
91
|
-
const pendingGates = readinessData?.pendingGates ?? []
|
|
92
|
-
const commandRuns = pendingGates.map((gate) => {
|
|
93
|
-
const template = String(gate.preflightCommand ?? '')
|
|
94
|
-
const command = substituteCommand(template)
|
|
95
|
-
const unresolved = unresolvedPlaceholders(command)
|
|
96
|
-
const hasAnglePlaceholder = /<[^>]+>/.test(command)
|
|
97
|
-
const hasDryRunJson = command.includes('--dry-run') && command.includes('--json')
|
|
98
|
-
const result = unresolved.length || hasAnglePlaceholder || !hasDryRunJson
|
|
99
|
-
? { status: 1, stdout: '', stderr: 'command template failed pre-execution checks', command }
|
|
100
|
-
: run(command, [], { cwd: root, shell: true })
|
|
101
|
-
const output = parseJson(result.stdout)
|
|
102
|
-
|
|
103
|
-
return {
|
|
104
|
-
area: gate.area,
|
|
105
|
-
template,
|
|
106
|
-
command,
|
|
107
|
-
unresolved,
|
|
108
|
-
hasAnglePlaceholder,
|
|
109
|
-
hasDryRunJson,
|
|
110
|
-
exitStatus: result.status,
|
|
111
|
-
stdoutStatus: output?.status ?? 'unparsed',
|
|
112
|
-
errors: Array.isArray(output?.errors) ? output.errors : [],
|
|
113
|
-
stderr: result.stderr,
|
|
114
|
-
}
|
|
115
|
-
})
|
|
116
|
-
|
|
117
|
-
const commandCount = commandRuns.length
|
|
118
|
-
const executedCount = commandRuns.filter((item) => item.exitStatus === 0).length
|
|
119
|
-
const templatesAreResolved = commandRuns.every((item) => item.unresolved.length === 0 && !item.hasAnglePlaceholder)
|
|
120
|
-
const templatesArePreflight = commandRuns.every((item) => item.hasDryRunJson)
|
|
121
|
-
const commandsExitCleanly = commandRuns.every((item) => item.exitStatus === 0)
|
|
122
|
-
const commandsReturnReady = commandRuns.every((item) => item.stdoutStatus === 'ready' && item.errors.length === 0)
|
|
123
|
-
const expectedPendingBoundary = readinessData?.summary?.publicAccepted === 'verified' ? commandCount === 0 : commandCount > 0
|
|
124
|
-
|
|
125
|
-
const checks = [
|
|
126
|
-
check('PACD01', 'public acceptance readiness doctor runs before command drill', readiness.status === 0 && readinessData?.summary?.status === 'passed', readiness.command, readiness.stderr),
|
|
127
|
-
check('PACD02', 'drill consumes generated pending gate preflight commands', expectedPendingBoundary && pendingGates.every((gate) => String(gate.preflightCommand ?? '').includes('--dry-run --json')), `${commandCount} command(s)`),
|
|
128
|
-
check('PACD03', 'fixture substitution resolves shell-safe placeholders', templatesAreResolved, commandRuns.map((item) => `${item.area}:${item.unresolved.join(',') || 'resolved'}`).join('; ')),
|
|
129
|
-
check('PACD04', 'all generated commands remain dry-run JSON preflights', templatesArePreflight, commandRuns.map((item) => `${item.area}:${item.hasDryRunJson}`).join('; ')),
|
|
130
|
-
check('PACD05', 'substituted preflight commands execute with exit code 0', commandsExitCleanly, commandRuns.map((item) => `${item.area}:${item.exitStatus}`).join('; ')),
|
|
131
|
-
check('PACD06', 'substituted preflight commands return ready without validation errors', commandsReturnReady, commandRuns.map((item) => `${item.area}:${item.stdoutStatus}${item.errors.length ? ':' + item.errors.join('|') : ''}`).join('; ')),
|
|
132
|
-
check('PACD07', 'drill keeps public acceptance boundary honest', readinessData?.summary?.publicAccepted !== 'verified' || commandCount === 0, `publicAccepted=${readinessData?.summary?.publicAccepted ?? 'unknown'}; commands=${commandCount}`),
|
|
133
|
-
]
|
|
134
|
-
|
|
135
|
-
const passed = checks.filter((item) => item.status === 'passed').length
|
|
136
|
-
const failed = checks.length - passed
|
|
137
|
-
const report = {
|
|
138
|
-
root,
|
|
139
|
-
generatedAt: new Date().toISOString(),
|
|
140
|
-
summary: {
|
|
141
|
-
status: failed === 0 ? 'passed' : 'failed',
|
|
142
|
-
passed,
|
|
143
|
-
failed,
|
|
144
|
-
total: checks.length,
|
|
145
|
-
commandsChecked: commandCount,
|
|
146
|
-
commandsExecuted: executedCount,
|
|
147
|
-
publicAccepted: readinessData?.summary?.publicAccepted ?? 'unknown',
|
|
148
|
-
pendingGates: readinessData?.summary?.pendingGates ?? 'unknown',
|
|
149
|
-
},
|
|
150
|
-
workflows: {
|
|
151
|
-
publicAcceptanceCommandDryRunDrill: failed === 0 ? 'verified' : 'failed',
|
|
152
|
-
publicAccepted: readinessData?.summary?.publicAccepted ?? 'unknown',
|
|
153
|
-
},
|
|
154
|
-
commandRuns,
|
|
155
|
-
limits: [
|
|
156
|
-
'This drill executes generated owner/external preflight command templates after fixture substitution.',
|
|
157
|
-
'It proves command-template mechanics only; it does not create real public release, repository, CI, registry, marketplace, security, or host-runtime evidence.',
|
|
158
|
-
],
|
|
159
|
-
checks,
|
|
160
|
-
}
|
|
161
|
-
|
|
162
|
-
function renderMarkdown(data) {
|
|
163
|
-
const lines = []
|
|
164
|
-
lines.push('# GSE Public Acceptance Command Dry-Run Drill')
|
|
165
|
-
lines.push('')
|
|
166
|
-
lines.push('Generated: ' + data.generatedAt)
|
|
167
|
-
lines.push('Root: ' + data.root)
|
|
168
|
-
lines.push('')
|
|
169
|
-
lines.push('## Summary')
|
|
170
|
-
lines.push('')
|
|
171
|
-
lines.push('- Status: ' + data.summary.status)
|
|
172
|
-
lines.push('- Checks: ' + data.summary.passed + '/' + data.summary.total)
|
|
173
|
-
lines.push('- Commands checked: ' + data.summary.commandsChecked)
|
|
174
|
-
lines.push('- Commands executed: ' + data.summary.commandsExecuted)
|
|
175
|
-
lines.push('- Public accepted: ' + data.summary.publicAccepted)
|
|
176
|
-
lines.push('')
|
|
177
|
-
lines.push('## Commands')
|
|
178
|
-
lines.push('')
|
|
179
|
-
if (data.commandRuns.length === 0) {
|
|
180
|
-
lines.push('- None.')
|
|
181
|
-
} else {
|
|
182
|
-
for (const item of data.commandRuns) {
|
|
183
|
-
lines.push('- ' + item.area + ': exit=' + item.exitStatus + ', status=' + item.stdoutStatus)
|
|
184
|
-
}
|
|
185
|
-
}
|
|
186
|
-
lines.push('')
|
|
187
|
-
lines.push('## Checks')
|
|
188
|
-
lines.push('')
|
|
189
|
-
for (const item of data.checks) {
|
|
190
|
-
const marker = item.status === 'passed' ? '[x]' : '[ ]'
|
|
191
|
-
lines.push('- ' + marker + ' ' + item.id + ' ' + item.label + ': ' + item.evidence)
|
|
192
|
-
}
|
|
193
|
-
lines.push('')
|
|
194
|
-
lines.push('## Limits')
|
|
195
|
-
lines.push('')
|
|
196
|
-
for (const item of data.limits) lines.push('- ' + item)
|
|
197
|
-
return lines.join('\n') + '\n'
|
|
198
|
-
}
|
|
199
|
-
|
|
200
|
-
if (jsonOnly) console.log(JSON.stringify(report, null, 2))
|
|
201
|
-
else console.log(renderMarkdown(report))
|
|
202
|
-
|
|
203
|
-
if (failed > 0) process.exit(1)
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import path from 'node:path'
|
|
3
|
+
import { spawnSync } from 'node:child_process'
|
|
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 run(command, commandArgs, options = {}) {
|
|
17
|
+
const result = spawnSync(command, commandArgs, {
|
|
18
|
+
cwd: options.cwd ?? root,
|
|
19
|
+
encoding: 'utf8',
|
|
20
|
+
windowsHide: true,
|
|
21
|
+
shell: Boolean(options.shell),
|
|
22
|
+
})
|
|
23
|
+
return {
|
|
24
|
+
status: result.status ?? 1,
|
|
25
|
+
stdout: (result.stdout ?? '').trim(),
|
|
26
|
+
stderr: (result.stderr ?? '').trim(),
|
|
27
|
+
command: options.shell ? command : [command, ...commandArgs].join(' '),
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
function parseJson(stdout) {
|
|
32
|
+
try {
|
|
33
|
+
return JSON.parse(stdout)
|
|
34
|
+
} catch {
|
|
35
|
+
return null
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
function check(id, label, ok, evidence, risk = '') {
|
|
40
|
+
return { id, label, status: ok ? 'passed' : 'failed', evidence, risk }
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
function shellQuote(value) {
|
|
44
|
+
return JSON.stringify(String(value))
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
const fixtureValues = {
|
|
48
|
+
__GSE__: root,
|
|
49
|
+
__PUBLIC_REPO_URL__: 'https://github.com/example/gse',
|
|
50
|
+
__PUBLIC_CI_RUN_URL__: 'https://github.com/example/gse/actions/runs/123456789',
|
|
51
|
+
__COMMIT_SHA__: '0123456789abcdef0123456789abcdef01234567',
|
|
52
|
+
__BRANCH__: 'main',
|
|
53
|
+
__REQUIRED_CHECKS__: shellQuote('Validate GSE'),
|
|
54
|
+
__OWNER__: 'fixture-owner',
|
|
55
|
+
__YYYY_MM_DD__: '2026-07-07',
|
|
56
|
+
__SETTINGS_EVIDENCE_URL__: 'https://github.com/example/gse/settings/branches',
|
|
57
|
+
__URL_OR_RECORD__: 'https://example.com/security',
|
|
58
|
+
__EMAIL_URL_GITHUB_SECURITY_ADVISORY_OTHER__: 'url',
|
|
59
|
+
__PUBLIC_CONTACT__: 'https://example.com/security',
|
|
60
|
+
__REGISTRY_NAME__: 'npm',
|
|
61
|
+
__REGISTRY_PACKAGE_URL__: 'https://registry.example/gse',
|
|
62
|
+
__MARKETPLACE_NAME__: 'ExampleMarketplace',
|
|
63
|
+
__MARKETPLACE_LISTING_URL__: 'https://marketplace.example/gse',
|
|
64
|
+
__VERSION__: '1.0.0',
|
|
65
|
+
__DIGEST__: 'sha256:fixture',
|
|
66
|
+
__HOST__: 'FixtureHost',
|
|
67
|
+
__VERSION_OR_UNKNOWN__: 'fixture-host-1.0.0',
|
|
68
|
+
__HOST_ADAPTER_OR_COMMAND_PATH__: 'adapters/fixture-native-command.md',
|
|
69
|
+
__HOST_ADAPTER_OR_POINTER__: 'adapters/fixture-pointer.md',
|
|
70
|
+
__HOST_ADAPTER_OR_RUNTIME_ENTRYPOINT__: 'adapters/fixture-runtime-entrypoint.md',
|
|
71
|
+
__THREAD_TRANSCRIPT_SCREENSHOT_OR_HOST_LOG__: 'fixture-native-host-log',
|
|
72
|
+
__THREAD_TRANSCRIPT_SCREENSHOT_TERMINAL_OUTPUT_OR_HOST_LOG__: 'fixture-other-host-log',
|
|
73
|
+
__PORTABLE_TEXT_COMMAND_HOST_UI_COMMAND_RUNTIME_BRIDGE__: 'runtime-bridge',
|
|
74
|
+
__HOST_UI_COMMAND_RUNTIME_BRIDGE_PLUGIN_COMMAND_AGENT_COMMAND__: 'runtime-bridge',
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
function substituteCommand(command) {
|
|
78
|
+
let substituted = command
|
|
79
|
+
for (const [placeholder, value] of Object.entries(fixtureValues)) {
|
|
80
|
+
substituted = substituted.split(placeholder).join(value)
|
|
81
|
+
}
|
|
82
|
+
return substituted
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
function unresolvedPlaceholders(command) {
|
|
86
|
+
return [...command.matchAll(/__[A-Z0-9_]+__/g)].map((match) => match[0])
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
const readiness = run(process.execPath, [path.join(root, 'scripts', 'audit-public-acceptance-readiness.mjs'), '--root', root, '--json'])
|
|
90
|
+
const readinessData = parseJson(readiness.stdout)
|
|
91
|
+
const pendingGates = readinessData?.pendingGates ?? []
|
|
92
|
+
const commandRuns = pendingGates.map((gate) => {
|
|
93
|
+
const template = String(gate.preflightCommand ?? '')
|
|
94
|
+
const command = substituteCommand(template)
|
|
95
|
+
const unresolved = unresolvedPlaceholders(command)
|
|
96
|
+
const hasAnglePlaceholder = /<[^>]+>/.test(command)
|
|
97
|
+
const hasDryRunJson = command.includes('--dry-run') && command.includes('--json')
|
|
98
|
+
const result = unresolved.length || hasAnglePlaceholder || !hasDryRunJson
|
|
99
|
+
? { status: 1, stdout: '', stderr: 'command template failed pre-execution checks', command }
|
|
100
|
+
: run(command, [], { cwd: root, shell: true })
|
|
101
|
+
const output = parseJson(result.stdout)
|
|
102
|
+
|
|
103
|
+
return {
|
|
104
|
+
area: gate.area,
|
|
105
|
+
template,
|
|
106
|
+
command,
|
|
107
|
+
unresolved,
|
|
108
|
+
hasAnglePlaceholder,
|
|
109
|
+
hasDryRunJson,
|
|
110
|
+
exitStatus: result.status,
|
|
111
|
+
stdoutStatus: output?.status ?? 'unparsed',
|
|
112
|
+
errors: Array.isArray(output?.errors) ? output.errors : [],
|
|
113
|
+
stderr: result.stderr,
|
|
114
|
+
}
|
|
115
|
+
})
|
|
116
|
+
|
|
117
|
+
const commandCount = commandRuns.length
|
|
118
|
+
const executedCount = commandRuns.filter((item) => item.exitStatus === 0).length
|
|
119
|
+
const templatesAreResolved = commandRuns.every((item) => item.unresolved.length === 0 && !item.hasAnglePlaceholder)
|
|
120
|
+
const templatesArePreflight = commandRuns.every((item) => item.hasDryRunJson)
|
|
121
|
+
const commandsExitCleanly = commandRuns.every((item) => item.exitStatus === 0)
|
|
122
|
+
const commandsReturnReady = commandRuns.every((item) => item.stdoutStatus === 'ready' && item.errors.length === 0)
|
|
123
|
+
const expectedPendingBoundary = readinessData?.summary?.publicAccepted === 'verified' ? commandCount === 0 : commandCount > 0
|
|
124
|
+
|
|
125
|
+
const checks = [
|
|
126
|
+
check('PACD01', 'public acceptance readiness doctor runs before command drill', readiness.status === 0 && readinessData?.summary?.status === 'passed', readiness.command, readiness.stderr),
|
|
127
|
+
check('PACD02', 'drill consumes generated pending gate preflight commands', expectedPendingBoundary && pendingGates.every((gate) => String(gate.preflightCommand ?? '').includes('--dry-run --json')), `${commandCount} command(s)`),
|
|
128
|
+
check('PACD03', 'fixture substitution resolves shell-safe placeholders', templatesAreResolved, commandRuns.map((item) => `${item.area}:${item.unresolved.join(',') || 'resolved'}`).join('; ')),
|
|
129
|
+
check('PACD04', 'all generated commands remain dry-run JSON preflights', templatesArePreflight, commandRuns.map((item) => `${item.area}:${item.hasDryRunJson}`).join('; ')),
|
|
130
|
+
check('PACD05', 'substituted preflight commands execute with exit code 0', commandsExitCleanly, commandRuns.map((item) => `${item.area}:${item.exitStatus}`).join('; ')),
|
|
131
|
+
check('PACD06', 'substituted preflight commands return ready without validation errors', commandsReturnReady, commandRuns.map((item) => `${item.area}:${item.stdoutStatus}${item.errors.length ? ':' + item.errors.join('|') : ''}`).join('; ')),
|
|
132
|
+
check('PACD07', 'drill keeps public acceptance boundary honest', readinessData?.summary?.publicAccepted !== 'verified' || commandCount === 0, `publicAccepted=${readinessData?.summary?.publicAccepted ?? 'unknown'}; commands=${commandCount}`),
|
|
133
|
+
]
|
|
134
|
+
|
|
135
|
+
const passed = checks.filter((item) => item.status === 'passed').length
|
|
136
|
+
const failed = checks.length - passed
|
|
137
|
+
const report = {
|
|
138
|
+
root,
|
|
139
|
+
generatedAt: new Date().toISOString(),
|
|
140
|
+
summary: {
|
|
141
|
+
status: failed === 0 ? 'passed' : 'failed',
|
|
142
|
+
passed,
|
|
143
|
+
failed,
|
|
144
|
+
total: checks.length,
|
|
145
|
+
commandsChecked: commandCount,
|
|
146
|
+
commandsExecuted: executedCount,
|
|
147
|
+
publicAccepted: readinessData?.summary?.publicAccepted ?? 'unknown',
|
|
148
|
+
pendingGates: readinessData?.summary?.pendingGates ?? 'unknown',
|
|
149
|
+
},
|
|
150
|
+
workflows: {
|
|
151
|
+
publicAcceptanceCommandDryRunDrill: failed === 0 ? 'verified' : 'failed',
|
|
152
|
+
publicAccepted: readinessData?.summary?.publicAccepted ?? 'unknown',
|
|
153
|
+
},
|
|
154
|
+
commandRuns,
|
|
155
|
+
limits: [
|
|
156
|
+
'This drill executes generated owner/external preflight command templates after fixture substitution.',
|
|
157
|
+
'It proves command-template mechanics only; it does not create real public release, repository, CI, registry, marketplace, security, or host-runtime evidence.',
|
|
158
|
+
],
|
|
159
|
+
checks,
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
function renderMarkdown(data) {
|
|
163
|
+
const lines = []
|
|
164
|
+
lines.push('# GSE Public Acceptance Command Dry-Run Drill')
|
|
165
|
+
lines.push('')
|
|
166
|
+
lines.push('Generated: ' + data.generatedAt)
|
|
167
|
+
lines.push('Root: ' + data.root)
|
|
168
|
+
lines.push('')
|
|
169
|
+
lines.push('## Summary')
|
|
170
|
+
lines.push('')
|
|
171
|
+
lines.push('- Status: ' + data.summary.status)
|
|
172
|
+
lines.push('- Checks: ' + data.summary.passed + '/' + data.summary.total)
|
|
173
|
+
lines.push('- Commands checked: ' + data.summary.commandsChecked)
|
|
174
|
+
lines.push('- Commands executed: ' + data.summary.commandsExecuted)
|
|
175
|
+
lines.push('- Public accepted: ' + data.summary.publicAccepted)
|
|
176
|
+
lines.push('')
|
|
177
|
+
lines.push('## Commands')
|
|
178
|
+
lines.push('')
|
|
179
|
+
if (data.commandRuns.length === 0) {
|
|
180
|
+
lines.push('- None.')
|
|
181
|
+
} else {
|
|
182
|
+
for (const item of data.commandRuns) {
|
|
183
|
+
lines.push('- ' + item.area + ': exit=' + item.exitStatus + ', status=' + item.stdoutStatus)
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
lines.push('')
|
|
187
|
+
lines.push('## Checks')
|
|
188
|
+
lines.push('')
|
|
189
|
+
for (const item of data.checks) {
|
|
190
|
+
const marker = item.status === 'passed' ? '[x]' : '[ ]'
|
|
191
|
+
lines.push('- ' + marker + ' ' + item.id + ' ' + item.label + ': ' + item.evidence)
|
|
192
|
+
}
|
|
193
|
+
lines.push('')
|
|
194
|
+
lines.push('## Limits')
|
|
195
|
+
lines.push('')
|
|
196
|
+
for (const item of data.limits) lines.push('- ' + item)
|
|
197
|
+
return lines.join('\n') + '\n'
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
if (jsonOnly) console.log(JSON.stringify(report, null, 2))
|
|
201
|
+
else console.log(renderMarkdown(report))
|
|
202
|
+
|
|
203
|
+
if (failed > 0) process.exit(1)
|