@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,125 +1,125 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
import fs from 'node:fs'
|
|
3
|
-
import path from 'node:path'
|
|
4
|
-
import { spawnSync } from 'node:child_process'
|
|
5
|
-
|
|
6
|
-
const args = process.argv.slice(2)
|
|
7
|
-
|
|
8
|
-
function readArg(name, fallback = null) {
|
|
9
|
-
const index = args.indexOf(name)
|
|
10
|
-
if (index === -1) return fallback
|
|
11
|
-
return args[index + 1] ?? fallback
|
|
12
|
-
}
|
|
13
|
-
|
|
14
|
-
const root = path.resolve(readArg('--root', path.join(import.meta.dirname, '..')))
|
|
15
|
-
const jsonOnly = args.includes('--json')
|
|
16
|
-
|
|
17
|
-
function read(relativePath) {
|
|
18
|
-
const fullPath = path.join(root, relativePath)
|
|
19
|
-
return fs.existsSync(fullPath) ? fs.readFileSync(fullPath, 'utf8').replace(/^\uFEFF/, '') : ''
|
|
20
|
-
}
|
|
21
|
-
|
|
22
|
-
function run(commandArgs) {
|
|
23
|
-
const result = spawnSync(process.execPath, [path.join(root, 'scripts', 'run-validation-profile.mjs'), ...commandArgs], {
|
|
24
|
-
cwd: root,
|
|
25
|
-
encoding: 'utf8',
|
|
26
|
-
windowsHide: true,
|
|
27
|
-
})
|
|
28
|
-
let parsed = null
|
|
29
|
-
try {
|
|
30
|
-
parsed = JSON.parse((result.stdout ?? '').trim())
|
|
31
|
-
} catch {
|
|
32
|
-
parsed = null
|
|
33
|
-
}
|
|
34
|
-
return {
|
|
35
|
-
command: [process.execPath, path.join(root, 'scripts', 'run-validation-profile.mjs'), ...commandArgs].join(' '),
|
|
36
|
-
status: result.status ?? 1,
|
|
37
|
-
parsed,
|
|
38
|
-
stdout: (result.stdout ?? '').trim(),
|
|
39
|
-
stderr: (result.stderr ?? '').trim(),
|
|
40
|
-
}
|
|
41
|
-
}
|
|
42
|
-
|
|
43
|
-
function check(id, label, ok, evidence, risk = '') {
|
|
44
|
-
return { id, label, status: ok ? 'passed' : 'failed', evidence, risk }
|
|
45
|
-
}
|
|
46
|
-
|
|
47
|
-
const runnerSource = read('scripts/run-validation-profile.mjs')
|
|
48
|
-
const skill = read('SKILL.md')
|
|
49
|
-
const commands = read('references/commands.md')
|
|
50
|
-
const qualityGates = read('references/quality-gates.md')
|
|
51
|
-
const lite = run(['--root', root, '--target', root, '--profile', 'lite', '--json'])
|
|
52
|
-
const standard = run(['--root', root, '--target', root, '--profile', 'standard', '--json'])
|
|
53
|
-
const releaseProfileScripts = [
|
|
54
|
-
'audit-command-execution.mjs',
|
|
55
|
-
'audit-npm-package-metadata.mjs',
|
|
56
|
-
'audit-npm-tarball-install.mjs',
|
|
57
|
-
'audit-signing.mjs',
|
|
58
|
-
'audit-release-bundle.mjs',
|
|
59
|
-
'audit-distribution.mjs',
|
|
60
|
-
'audit-remote-distribution.mjs',
|
|
61
|
-
'audit-public-acceptance-readiness.mjs',
|
|
62
|
-
'audit-final-readiness.mjs',
|
|
63
|
-
'audit-final-acceptance-packet.mjs',
|
|
64
|
-
'audit-owner-external-gate-kit.mjs',
|
|
65
|
-
]
|
|
66
|
-
|
|
67
|
-
const checks = [
|
|
68
|
-
check('VP01', 'validation profile runner exists', fs.existsSync(path.join(root, 'scripts', 'run-validation-profile.mjs')), 'scripts/run-validation-profile.mjs'),
|
|
69
|
-
check('VP02', 'runner defines lite, standard, enterprise, and release profiles', ['lite', 'standard', 'enterprise', 'release'].every((item) => runnerSource.includes(`'${item}'`)), 'profile names'),
|
|
70
|
-
check('VP03', 'lite profile avoids release/distribution heavy gates', lite.status === 0 && lite.parsed?.summary?.status === 'passed' && !lite.stdout.includes('audit-distribution.mjs') && !lite.stdout.includes('audit-release-bundle.mjs'), 'lite profile output'),
|
|
71
|
-
check('VP04', 'standard profile passes without forcing close gate during in-progress work', standard.status === 0 && standard.parsed?.summary?.status === 'passed' && !standard.stdout.includes('audit-close-gate.mjs') && !standard.stdout.includes('audit-distribution.mjs'), 'standard profile output'),
|
|
72
|
-
check('VP05', 'quality gates document full validation as enterprise/release-grade work', qualityGates.includes('Full validation belongs here, not on every small product slice') && qualityGates.includes('Use the lightest gate profile'), 'references/quality-gates.md'),
|
|
73
|
-
check('VP06', 'skill exposes validation profile runner', skill.includes('run-validation-profile.mjs'), 'SKILL.md'),
|
|
74
|
-
check('VP07', 'command docs expose profile-based verify', commands.includes('/gse verify --profile lite') && commands.includes('run-validation-profile.mjs'), 'references/commands.md'),
|
|
75
|
-
check('VP08', 'release profile includes install, signing, bundle, final readiness, and owner handoff gates', releaseProfileScripts.every((item) => runnerSource.includes(item)) && runnerSource.includes("--profile', 'full'"), releaseProfileScripts.join(', ')),
|
|
76
|
-
]
|
|
77
|
-
|
|
78
|
-
const passed = checks.filter((item) => item.status === 'passed').length
|
|
79
|
-
const failed = checks.length - passed
|
|
80
|
-
const report = {
|
|
81
|
-
root,
|
|
82
|
-
generatedAt: new Date().toISOString(),
|
|
83
|
-
summary: { status: failed === 0 ? 'passed' : 'failed', passed, failed, total: checks.length },
|
|
84
|
-
workflows: {
|
|
85
|
-
validationProfiles: failed === 0 ? 'verified' : 'failed',
|
|
86
|
-
liteChecks: lite.parsed?.summary ?? null,
|
|
87
|
-
standardChecks: standard.parsed?.summary ?? null,
|
|
88
|
-
},
|
|
89
|
-
limits: [
|
|
90
|
-
'This audit verifies validation profile routing and fast profile behavior.',
|
|
91
|
-
'It does not run the release profile because that profile is intentionally heavy and should be selected only for release/install claims.',
|
|
92
|
-
],
|
|
93
|
-
checks,
|
|
94
|
-
}
|
|
95
|
-
|
|
96
|
-
function renderMarkdown(data) {
|
|
97
|
-
const lines = []
|
|
98
|
-
lines.push('# GSE Validation Profiles Audit')
|
|
99
|
-
lines.push('')
|
|
100
|
-
lines.push('Generated: ' + data.generatedAt)
|
|
101
|
-
lines.push('Root: ' + data.root)
|
|
102
|
-
lines.push('')
|
|
103
|
-
lines.push('## Summary')
|
|
104
|
-
lines.push('')
|
|
105
|
-
lines.push('- Status: ' + data.summary.status)
|
|
106
|
-
lines.push('- Checks: ' + data.summary.passed + '/' + data.summary.total)
|
|
107
|
-
lines.push('- Validation profiles: ' + data.workflows.validationProfiles)
|
|
108
|
-
lines.push('')
|
|
109
|
-
lines.push('## Checks')
|
|
110
|
-
lines.push('')
|
|
111
|
-
for (const item of data.checks) {
|
|
112
|
-
const marker = item.status === 'passed' ? '[x]' : '[ ]'
|
|
113
|
-
lines.push('- ' + marker + ' ' + item.id + ' ' + item.label + ': ' + item.evidence)
|
|
114
|
-
}
|
|
115
|
-
lines.push('')
|
|
116
|
-
lines.push('## Limits')
|
|
117
|
-
lines.push('')
|
|
118
|
-
for (const item of data.limits) lines.push('- ' + item)
|
|
119
|
-
return lines.join('\n') + '\n'
|
|
120
|
-
}
|
|
121
|
-
|
|
122
|
-
if (jsonOnly) console.log(JSON.stringify(report, null, 2))
|
|
123
|
-
else console.log(renderMarkdown(report))
|
|
124
|
-
|
|
125
|
-
if (failed > 0) process.exit(1)
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import fs from 'node:fs'
|
|
3
|
+
import path from 'node:path'
|
|
4
|
+
import { spawnSync } from 'node:child_process'
|
|
5
|
+
|
|
6
|
+
const args = process.argv.slice(2)
|
|
7
|
+
|
|
8
|
+
function readArg(name, fallback = null) {
|
|
9
|
+
const index = args.indexOf(name)
|
|
10
|
+
if (index === -1) return fallback
|
|
11
|
+
return args[index + 1] ?? fallback
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
const root = path.resolve(readArg('--root', path.join(import.meta.dirname, '..')))
|
|
15
|
+
const jsonOnly = args.includes('--json')
|
|
16
|
+
|
|
17
|
+
function read(relativePath) {
|
|
18
|
+
const fullPath = path.join(root, relativePath)
|
|
19
|
+
return fs.existsSync(fullPath) ? fs.readFileSync(fullPath, 'utf8').replace(/^\uFEFF/, '') : ''
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
function run(commandArgs) {
|
|
23
|
+
const result = spawnSync(process.execPath, [path.join(root, 'scripts', 'run-validation-profile.mjs'), ...commandArgs], {
|
|
24
|
+
cwd: root,
|
|
25
|
+
encoding: 'utf8',
|
|
26
|
+
windowsHide: true,
|
|
27
|
+
})
|
|
28
|
+
let parsed = null
|
|
29
|
+
try {
|
|
30
|
+
parsed = JSON.parse((result.stdout ?? '').trim())
|
|
31
|
+
} catch {
|
|
32
|
+
parsed = null
|
|
33
|
+
}
|
|
34
|
+
return {
|
|
35
|
+
command: [process.execPath, path.join(root, 'scripts', 'run-validation-profile.mjs'), ...commandArgs].join(' '),
|
|
36
|
+
status: result.status ?? 1,
|
|
37
|
+
parsed,
|
|
38
|
+
stdout: (result.stdout ?? '').trim(),
|
|
39
|
+
stderr: (result.stderr ?? '').trim(),
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
function check(id, label, ok, evidence, risk = '') {
|
|
44
|
+
return { id, label, status: ok ? 'passed' : 'failed', evidence, risk }
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
const runnerSource = read('scripts/run-validation-profile.mjs')
|
|
48
|
+
const skill = read('SKILL.md')
|
|
49
|
+
const commands = read('references/commands.md')
|
|
50
|
+
const qualityGates = read('references/quality-gates.md')
|
|
51
|
+
const lite = run(['--root', root, '--target', root, '--profile', 'lite', '--json'])
|
|
52
|
+
const standard = run(['--root', root, '--target', root, '--profile', 'standard', '--json'])
|
|
53
|
+
const releaseProfileScripts = [
|
|
54
|
+
'audit-command-execution.mjs',
|
|
55
|
+
'audit-npm-package-metadata.mjs',
|
|
56
|
+
'audit-npm-tarball-install.mjs',
|
|
57
|
+
'audit-signing.mjs',
|
|
58
|
+
'audit-release-bundle.mjs',
|
|
59
|
+
'audit-distribution.mjs',
|
|
60
|
+
'audit-remote-distribution.mjs',
|
|
61
|
+
'audit-public-acceptance-readiness.mjs',
|
|
62
|
+
'audit-final-readiness.mjs',
|
|
63
|
+
'audit-final-acceptance-packet.mjs',
|
|
64
|
+
'audit-owner-external-gate-kit.mjs',
|
|
65
|
+
]
|
|
66
|
+
|
|
67
|
+
const checks = [
|
|
68
|
+
check('VP01', 'validation profile runner exists', fs.existsSync(path.join(root, 'scripts', 'run-validation-profile.mjs')), 'scripts/run-validation-profile.mjs'),
|
|
69
|
+
check('VP02', 'runner defines lite, standard, enterprise, and release profiles', ['lite', 'standard', 'enterprise', 'release'].every((item) => runnerSource.includes(`'${item}'`)), 'profile names'),
|
|
70
|
+
check('VP03', 'lite profile avoids release/distribution heavy gates', lite.status === 0 && lite.parsed?.summary?.status === 'passed' && !lite.stdout.includes('audit-distribution.mjs') && !lite.stdout.includes('audit-release-bundle.mjs'), 'lite profile output'),
|
|
71
|
+
check('VP04', 'standard profile passes without forcing close gate during in-progress work', standard.status === 0 && standard.parsed?.summary?.status === 'passed' && !standard.stdout.includes('audit-close-gate.mjs') && !standard.stdout.includes('audit-distribution.mjs'), 'standard profile output'),
|
|
72
|
+
check('VP05', 'quality gates document full validation as enterprise/release-grade work', qualityGates.includes('Full validation belongs here, not on every small product slice') && qualityGates.includes('Use the lightest gate profile'), 'references/quality-gates.md'),
|
|
73
|
+
check('VP06', 'skill exposes validation profile runner', skill.includes('run-validation-profile.mjs'), 'SKILL.md'),
|
|
74
|
+
check('VP07', 'command docs expose profile-based verify', commands.includes('/gse verify --profile lite') && commands.includes('run-validation-profile.mjs'), 'references/commands.md'),
|
|
75
|
+
check('VP08', 'release profile includes install, signing, bundle, final readiness, and owner handoff gates', releaseProfileScripts.every((item) => runnerSource.includes(item)) && runnerSource.includes("--profile', 'full'"), releaseProfileScripts.join(', ')),
|
|
76
|
+
]
|
|
77
|
+
|
|
78
|
+
const passed = checks.filter((item) => item.status === 'passed').length
|
|
79
|
+
const failed = checks.length - passed
|
|
80
|
+
const report = {
|
|
81
|
+
root,
|
|
82
|
+
generatedAt: new Date().toISOString(),
|
|
83
|
+
summary: { status: failed === 0 ? 'passed' : 'failed', passed, failed, total: checks.length },
|
|
84
|
+
workflows: {
|
|
85
|
+
validationProfiles: failed === 0 ? 'verified' : 'failed',
|
|
86
|
+
liteChecks: lite.parsed?.summary ?? null,
|
|
87
|
+
standardChecks: standard.parsed?.summary ?? null,
|
|
88
|
+
},
|
|
89
|
+
limits: [
|
|
90
|
+
'This audit verifies validation profile routing and fast profile behavior.',
|
|
91
|
+
'It does not run the release profile because that profile is intentionally heavy and should be selected only for release/install claims.',
|
|
92
|
+
],
|
|
93
|
+
checks,
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
function renderMarkdown(data) {
|
|
97
|
+
const lines = []
|
|
98
|
+
lines.push('# GSE Validation Profiles Audit')
|
|
99
|
+
lines.push('')
|
|
100
|
+
lines.push('Generated: ' + data.generatedAt)
|
|
101
|
+
lines.push('Root: ' + data.root)
|
|
102
|
+
lines.push('')
|
|
103
|
+
lines.push('## Summary')
|
|
104
|
+
lines.push('')
|
|
105
|
+
lines.push('- Status: ' + data.summary.status)
|
|
106
|
+
lines.push('- Checks: ' + data.summary.passed + '/' + data.summary.total)
|
|
107
|
+
lines.push('- Validation profiles: ' + data.workflows.validationProfiles)
|
|
108
|
+
lines.push('')
|
|
109
|
+
lines.push('## Checks')
|
|
110
|
+
lines.push('')
|
|
111
|
+
for (const item of data.checks) {
|
|
112
|
+
const marker = item.status === 'passed' ? '[x]' : '[ ]'
|
|
113
|
+
lines.push('- ' + marker + ' ' + item.id + ' ' + item.label + ': ' + item.evidence)
|
|
114
|
+
}
|
|
115
|
+
lines.push('')
|
|
116
|
+
lines.push('## Limits')
|
|
117
|
+
lines.push('')
|
|
118
|
+
for (const item of data.limits) lines.push('- ' + item)
|
|
119
|
+
return lines.join('\n') + '\n'
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
if (jsonOnly) console.log(JSON.stringify(report, null, 2))
|
|
123
|
+
else console.log(renderMarkdown(report))
|
|
124
|
+
|
|
125
|
+
if (failed > 0) process.exit(1)
|
package/scripts/close-change.mjs
CHANGED
|
@@ -1,116 +1,116 @@
|
|
|
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 target = path.resolve(readArg('--target', process.cwd()))
|
|
14
|
-
const changeId = String(readArg('--change-id', '')).trim().toLowerCase()
|
|
15
|
-
const status = readArg('--status', 'verified')
|
|
16
|
-
const date = readArg('--date', new Date().toISOString().slice(0, 10))
|
|
17
|
-
const dryRun = args.includes('--dry-run')
|
|
18
|
-
const force = args.includes('--force')
|
|
19
|
-
const jsonOnly = args.includes('--json')
|
|
20
|
-
|
|
21
|
-
const validStatus = new Set(['result', 'verified', 'accepted'])
|
|
22
|
-
if (!changeId) {
|
|
23
|
-
console.error('Missing --change-id.')
|
|
24
|
-
process.exit(1)
|
|
25
|
-
}
|
|
26
|
-
if (!validStatus.has(status)) {
|
|
27
|
-
console.error('Invalid --status value. Expected result, verified, or accepted.')
|
|
28
|
-
process.exit(1)
|
|
29
|
-
}
|
|
30
|
-
|
|
31
|
-
const changeDir = path.join(target, '.gse', 'changes', changeId)
|
|
32
|
-
const archiveDir = path.join(target, '.gse', 'archive', `${date}-${changeId}`)
|
|
33
|
-
const evidenceIndex = path.join(target, '.gse', 'evidence', 'index.jsonl')
|
|
34
|
-
const requiredFiles = [
|
|
35
|
-
'brief.md',
|
|
36
|
-
'spec.md',
|
|
37
|
-
'tasks.md',
|
|
38
|
-
'evidence.md',
|
|
39
|
-
'review.md',
|
|
40
|
-
]
|
|
41
|
-
|
|
42
|
-
function read(relativePath) {
|
|
43
|
-
const fullPath = path.join(changeDir, relativePath)
|
|
44
|
-
return fs.existsSync(fullPath) ? fs.readFileSync(fullPath, 'utf8') : ''
|
|
45
|
-
}
|
|
46
|
-
|
|
47
|
-
function fail(message, extra = {}) {
|
|
48
|
-
const report = { target, changeId, status: 'failed', message, ...extra }
|
|
49
|
-
console.error(JSON.stringify(report, null, 2))
|
|
50
|
-
process.exit(1)
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
if (!fs.existsSync(changeDir)) fail('Change directory does not exist.', { changeDir })
|
|
54
|
-
if (fs.existsSync(archiveDir) && !force) fail('Archive directory already exists. Use --force to overwrite.', { archiveDir })
|
|
55
|
-
|
|
56
|
-
const missing = requiredFiles.filter((file) => !fs.existsSync(path.join(changeDir, file)))
|
|
57
|
-
if (missing.length) fail('Required change files are missing.', { missing })
|
|
58
|
-
|
|
59
|
-
const evidence = read('evidence.md')
|
|
60
|
-
const review = read('review.md')
|
|
61
|
-
const hasEvidenceStatus = ['result', 'verified', 'accepted'].some((term) => evidence.toLowerCase().includes(term))
|
|
62
|
-
const hasReviewClosure = review.includes('## Closure')
|
|
63
|
-
if (!hasEvidenceStatus) fail('Evidence file does not include result/verified/accepted status vocabulary.', { file: 'evidence.md' })
|
|
64
|
-
if (!hasReviewClosure) fail('Review file does not include closure section.', { file: 'review.md' })
|
|
65
|
-
|
|
66
|
-
const archiveRecord = `# Change Archive Record
|
|
67
|
-
|
|
68
|
-
Change ID: ${changeId}
|
|
69
|
-
Closed At: ${new Date().toISOString()}
|
|
70
|
-
Status: ${status}
|
|
71
|
-
Source: .gse/changes/${changeId}
|
|
72
|
-
Archive: .gse/archive/${date}-${changeId}
|
|
73
|
-
|
|
74
|
-
## Closure Rules
|
|
75
|
-
|
|
76
|
-
- Required change files were present.
|
|
77
|
-
- Evidence status vocabulary was present.
|
|
78
|
-
- Review closure section was present.
|
|
79
|
-
- Source change folder was moved to archive.
|
|
80
|
-
`
|
|
81
|
-
|
|
82
|
-
const indexRecord = {
|
|
83
|
-
date,
|
|
84
|
-
recordType: 'change-archive',
|
|
85
|
-
changeId,
|
|
86
|
-
status,
|
|
87
|
-
summary: `Archived GSE change ${changeId}.`,
|
|
88
|
-
evidenceFile: `.gse/archive/${date}-${changeId}/evidence.md`,
|
|
89
|
-
archivePath: `.gse/archive/${date}-${changeId}`,
|
|
90
|
-
commands: [
|
|
91
|
-
`node scripts/close-change.mjs --target ${target} --change-id ${changeId} --status ${status} --date ${date} --json`,
|
|
92
|
-
],
|
|
93
|
-
nextAction: 'Continue from .gse/state.json and the current goal map.',
|
|
94
|
-
}
|
|
95
|
-
|
|
96
|
-
if (!dryRun) {
|
|
97
|
-
fs.mkdirSync(path.dirname(archiveDir), { recursive: true })
|
|
98
|
-
fs.rmSync(archiveDir, { recursive: true, force: true })
|
|
99
|
-
fs.renameSync(changeDir, archiveDir)
|
|
100
|
-
fs.writeFileSync(path.join(archiveDir, 'archive-record.md'), archiveRecord.replace(/\n/g, '\r\n'), 'utf8')
|
|
101
|
-
fs.mkdirSync(path.dirname(evidenceIndex), { recursive: true })
|
|
102
|
-
fs.appendFileSync(evidenceIndex, JSON.stringify(indexRecord) + '\n', 'utf8')
|
|
103
|
-
}
|
|
104
|
-
|
|
105
|
-
const report = {
|
|
106
|
-
target,
|
|
107
|
-
changeId,
|
|
108
|
-
status: 'passed',
|
|
109
|
-
evidenceStatus: status,
|
|
110
|
-
dryRun,
|
|
111
|
-
source: changeDir,
|
|
112
|
-
archive: archiveDir,
|
|
113
|
-
indexRecord,
|
|
114
|
-
}
|
|
115
|
-
|
|
116
|
-
console.log(JSON.stringify(report, null, 2))
|
|
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 target = path.resolve(readArg('--target', process.cwd()))
|
|
14
|
+
const changeId = String(readArg('--change-id', '')).trim().toLowerCase()
|
|
15
|
+
const status = readArg('--status', 'verified')
|
|
16
|
+
const date = readArg('--date', new Date().toISOString().slice(0, 10))
|
|
17
|
+
const dryRun = args.includes('--dry-run')
|
|
18
|
+
const force = args.includes('--force')
|
|
19
|
+
const jsonOnly = args.includes('--json')
|
|
20
|
+
|
|
21
|
+
const validStatus = new Set(['result', 'verified', 'accepted'])
|
|
22
|
+
if (!changeId) {
|
|
23
|
+
console.error('Missing --change-id.')
|
|
24
|
+
process.exit(1)
|
|
25
|
+
}
|
|
26
|
+
if (!validStatus.has(status)) {
|
|
27
|
+
console.error('Invalid --status value. Expected result, verified, or accepted.')
|
|
28
|
+
process.exit(1)
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
const changeDir = path.join(target, '.gse', 'changes', changeId)
|
|
32
|
+
const archiveDir = path.join(target, '.gse', 'archive', `${date}-${changeId}`)
|
|
33
|
+
const evidenceIndex = path.join(target, '.gse', 'evidence', 'index.jsonl')
|
|
34
|
+
const requiredFiles = [
|
|
35
|
+
'brief.md',
|
|
36
|
+
'spec.md',
|
|
37
|
+
'tasks.md',
|
|
38
|
+
'evidence.md',
|
|
39
|
+
'review.md',
|
|
40
|
+
]
|
|
41
|
+
|
|
42
|
+
function read(relativePath) {
|
|
43
|
+
const fullPath = path.join(changeDir, relativePath)
|
|
44
|
+
return fs.existsSync(fullPath) ? fs.readFileSync(fullPath, 'utf8') : ''
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
function fail(message, extra = {}) {
|
|
48
|
+
const report = { target, changeId, status: 'failed', message, ...extra }
|
|
49
|
+
console.error(JSON.stringify(report, null, 2))
|
|
50
|
+
process.exit(1)
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
if (!fs.existsSync(changeDir)) fail('Change directory does not exist.', { changeDir })
|
|
54
|
+
if (fs.existsSync(archiveDir) && !force) fail('Archive directory already exists. Use --force to overwrite.', { archiveDir })
|
|
55
|
+
|
|
56
|
+
const missing = requiredFiles.filter((file) => !fs.existsSync(path.join(changeDir, file)))
|
|
57
|
+
if (missing.length) fail('Required change files are missing.', { missing })
|
|
58
|
+
|
|
59
|
+
const evidence = read('evidence.md')
|
|
60
|
+
const review = read('review.md')
|
|
61
|
+
const hasEvidenceStatus = ['result', 'verified', 'accepted'].some((term) => evidence.toLowerCase().includes(term))
|
|
62
|
+
const hasReviewClosure = review.includes('## Closure')
|
|
63
|
+
if (!hasEvidenceStatus) fail('Evidence file does not include result/verified/accepted status vocabulary.', { file: 'evidence.md' })
|
|
64
|
+
if (!hasReviewClosure) fail('Review file does not include closure section.', { file: 'review.md' })
|
|
65
|
+
|
|
66
|
+
const archiveRecord = `# Change Archive Record
|
|
67
|
+
|
|
68
|
+
Change ID: ${changeId}
|
|
69
|
+
Closed At: ${new Date().toISOString()}
|
|
70
|
+
Status: ${status}
|
|
71
|
+
Source: .gse/changes/${changeId}
|
|
72
|
+
Archive: .gse/archive/${date}-${changeId}
|
|
73
|
+
|
|
74
|
+
## Closure Rules
|
|
75
|
+
|
|
76
|
+
- Required change files were present.
|
|
77
|
+
- Evidence status vocabulary was present.
|
|
78
|
+
- Review closure section was present.
|
|
79
|
+
- Source change folder was moved to archive.
|
|
80
|
+
`
|
|
81
|
+
|
|
82
|
+
const indexRecord = {
|
|
83
|
+
date,
|
|
84
|
+
recordType: 'change-archive',
|
|
85
|
+
changeId,
|
|
86
|
+
status,
|
|
87
|
+
summary: `Archived GSE change ${changeId}.`,
|
|
88
|
+
evidenceFile: `.gse/archive/${date}-${changeId}/evidence.md`,
|
|
89
|
+
archivePath: `.gse/archive/${date}-${changeId}`,
|
|
90
|
+
commands: [
|
|
91
|
+
`node scripts/close-change.mjs --target ${target} --change-id ${changeId} --status ${status} --date ${date} --json`,
|
|
92
|
+
],
|
|
93
|
+
nextAction: 'Continue from .gse/state.json and the current goal map.',
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
if (!dryRun) {
|
|
97
|
+
fs.mkdirSync(path.dirname(archiveDir), { recursive: true })
|
|
98
|
+
fs.rmSync(archiveDir, { recursive: true, force: true })
|
|
99
|
+
fs.renameSync(changeDir, archiveDir)
|
|
100
|
+
fs.writeFileSync(path.join(archiveDir, 'archive-record.md'), archiveRecord.replace(/\n/g, '\r\n'), 'utf8')
|
|
101
|
+
fs.mkdirSync(path.dirname(evidenceIndex), { recursive: true })
|
|
102
|
+
fs.appendFileSync(evidenceIndex, JSON.stringify(indexRecord) + '\n', 'utf8')
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
const report = {
|
|
106
|
+
target,
|
|
107
|
+
changeId,
|
|
108
|
+
status: 'passed',
|
|
109
|
+
evidenceStatus: status,
|
|
110
|
+
dryRun,
|
|
111
|
+
source: changeDir,
|
|
112
|
+
archive: archiveDir,
|
|
113
|
+
indexRecord,
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
console.log(JSON.stringify(report, null, 2))
|