@t275005746/gse 0.1.0 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/ISSUE_TEMPLATE/bug_report.yml +42 -42
- package/.github/ISSUE_TEMPLATE/change_request.yml +50 -50
- package/.github/ISSUE_TEMPLATE/config.yml +5 -5
- package/.github/PULL_REQUEST_TEMPLATE.md +38 -38
- package/.github/workflows/validate-gse.yml +33 -33
- package/.gse/README.md +18 -18
- package/.gse/gse-development-protocol.md +50 -50
- package/.gse/project-profile.md +29 -29
- package/.gse/quality-gates.md +25 -25
- package/.gse/releases/public-registry-publication-npm.md +49 -0
- package/.gse/releases/public-release-owner-required.md +65 -65
- package/.gse/releases/public-security-contact-owner-required.md +45 -45
- package/.gse/state.json +147 -27
- package/CHANGELOG.md +31 -15
- package/CONTRIBUTING.md +64 -64
- package/LICENSE +21 -21
- package/README.md +14 -7
- package/README.zh-CN.md +14 -7
- package/SECURITY.md +41 -41
- package/SKILL.md +32 -12
- package/SUPPORT.md +38 -38
- package/assets/marketplace/README.md +7 -7
- package/assets/marketplace/gse-listing.json +75 -75
- package/assets/templates/acceptance-execution-packet.md +73 -73
- package/assets/templates/adr.md +14 -14
- package/assets/templates/change-brief.md +16 -16
- package/assets/templates/design.md +18 -18
- package/assets/templates/dispatch-packet.md +100 -92
- package/assets/templates/evidence.md +15 -9
- package/assets/templates/execution-quality-pack.md +65 -65
- package/assets/templates/goal-map.md +21 -21
- package/assets/templates/host-adapter.md +48 -48
- package/assets/templates/host-ui-invocation-record.md +42 -42
- package/assets/templates/incident-review.md +60 -60
- package/assets/templates/public-channel-publication-record.md +49 -49
- package/assets/templates/public-ci-run-record.md +53 -53
- package/assets/templates/public-release-record.md +65 -65
- package/assets/templates/public-repository-settings-record.md +59 -59
- package/assets/templates/public-security-contact-record.md +45 -45
- package/assets/templates/release-trust-record.md +32 -32
- package/assets/templates/review.md +18 -18
- package/assets/templates/role-fallback-packet.md +49 -0
- package/assets/templates/spec.md +16 -16
- package/assets/templates/target-adoption-evidence.md +29 -29
- package/assets/templates/tasks.md +17 -17
- package/assets/templates/update-release-acceptance-record.md +58 -58
- package/examples/README.md +22 -22
- package/examples/agent-runtime-host/.claude/gse-adapter.md +6 -6
- package/examples/agent-runtime-host/.codex/gse-adapter.md +7 -7
- package/examples/agent-runtime-host/.gse/goal-map.md +7 -7
- package/examples/agent-runtime-host/.gse/project-profile.md +27 -27
- package/examples/agent-runtime-host/.gse/tooling.md +5 -5
- package/examples/agent-runtime-host/.mcp.json +9 -9
- package/examples/agent-runtime-host/AGENTS.md +5 -5
- package/examples/agent-runtime-host/README.md +10 -10
- package/examples/agent-runtime-host/docs/model-routing.md +5 -5
- package/examples/cli-tool/.gse/project-profile.md +21 -21
- package/examples/cli-tool/AGENTS.md +5 -5
- package/examples/cli-tool/README.md +12 -12
- package/examples/cli-tool/package.json +21 -21
- package/examples/small-app/.env.example +2 -2
- package/examples/small-app/.github/workflows/ci.yml +8 -8
- package/examples/small-app/AGENTS.md +5 -5
- package/examples/small-app/README.md +12 -12
- package/examples/small-app/package.json +26 -26
- package/examples/small-app/playwright.config.ts +4 -4
- package/package.json +52 -44
- package/references/adoption-recipes.md +171 -171
- package/references/agent-roles.md +42 -21
- package/references/architecture-health.md +101 -101
- package/references/benchmark-audit.md +73 -73
- package/references/commands.md +74 -45
- package/references/community-channels.md +46 -46
- package/references/compatibility.md +70 -70
- package/references/design-basis.md +38 -38
- package/references/domain-model.md +129 -129
- package/references/domain-quality-gates.md +75 -75
- package/references/drift-audit.md +81 -80
- package/references/evidence-taxonomy.md +145 -108
- package/references/file-ownership.md +97 -93
- package/references/final-form-roadmap.md +201 -0
- package/references/final-readiness.md +84 -84
- package/references/forward-test.md +133 -133
- package/references/goal-map.md +36 -36
- package/references/host-adapters.md +129 -101
- package/references/learning-system.md +42 -26
- package/references/maintenance-cadence.md +51 -0
- package/references/marketplace-discovery.md +46 -46
- package/references/model-routing.md +103 -103
- package/references/open-source-defaults.md +39 -39
- package/references/operating-model.md +52 -52
- package/references/packaging.md +277 -277
- package/references/project-agent-workspace.md +89 -89
- package/references/project-bootstrap.md +122 -122
- package/references/project-guards.md +52 -0
- package/references/project-profile.md +57 -57
- package/references/public-release.md +174 -174
- package/references/quality-gates.md +96 -89
- package/references/recovery.md +176 -176
- package/references/release-trust.md +43 -43
- package/references/release.md +126 -126
- package/references/review.md +141 -141
- package/references/role-dispatch-fallback.md +54 -0
- package/references/router.md +90 -90
- package/references/spec-workflow.md +66 -66
- package/references/task-levels.md +81 -81
- package/references/tool-adapters.md +80 -70
- package/scripts/audit-acceptance-execution-packet.mjs +133 -133
- package/scripts/audit-adoption-recipes.mjs +99 -99
- package/scripts/audit-change-lifecycle.mjs +77 -77
- package/scripts/audit-change-system.mjs +134 -134
- package/scripts/audit-ci-readiness.mjs +107 -107
- package/scripts/audit-close-gate-hardening.mjs +188 -0
- package/scripts/audit-close-gate.mjs +448 -262
- package/scripts/audit-command-adapters.mjs +91 -91
- package/scripts/audit-command-execution.mjs +212 -199
- package/scripts/audit-commands.mjs +7 -5
- package/scripts/audit-compatibility.mjs +149 -149
- package/scripts/audit-completion-plan-drill.mjs +230 -0
- package/scripts/audit-completion-readiness.mjs +290 -287
- package/scripts/audit-continue-preflight.mjs +234 -0
- package/scripts/audit-distribution.mjs +251 -251
- package/scripts/audit-domain-quality-gates.mjs +108 -108
- package/scripts/audit-evidence-levels.mjs +217 -0
- package/scripts/audit-evidence-placeholders.mjs +126 -126
- package/scripts/audit-evidence-review-queue.mjs +206 -0
- package/scripts/audit-final-acceptance-packet.mjs +9 -9
- package/scripts/audit-final-form-progress-report.mjs +19 -18
- package/scripts/audit-final-form-roadmap.mjs +157 -0
- package/scripts/audit-final-form-stale-copy.mjs +2 -2
- package/scripts/audit-final-readiness-promotion.mjs +255 -255
- package/scripts/audit-final-readiness.mjs +226 -226
- package/scripts/audit-fixtures.mjs +154 -154
- package/scripts/audit-fresh-session-readiness.mjs +177 -177
- package/scripts/audit-host-capabilities.mjs +237 -0
- package/scripts/audit-host-runtime-evidence-handoff.mjs +159 -159
- package/scripts/audit-host-runtime-invocation-drill.mjs +240 -240
- package/scripts/audit-host-runtime-invocations.mjs +254 -254
- package/scripts/audit-host-ui-invocation.mjs +132 -132
- package/scripts/audit-installed-sync.mjs +203 -0
- package/scripts/audit-learning-drift.mjs +292 -0
- package/scripts/audit-learning-promotion.mjs +351 -0
- package/scripts/audit-learning-system.mjs +24 -14
- package/scripts/audit-local-final-form-completion.mjs +11 -10
- package/scripts/audit-maintenance-cadence.mjs +139 -0
- package/scripts/audit-maintenance-snapshot.mjs +181 -0
- package/scripts/audit-marketplace-discovery.mjs +122 -122
- package/scripts/audit-npm-package-metadata.mjs +160 -154
- package/scripts/audit-npm-publish-dry-run.mjs +194 -166
- package/scripts/audit-npm-tarball-install.mjs +195 -189
- package/scripts/audit-open-source-defaults.mjs +92 -92
- package/scripts/audit-open-source-readiness.mjs +97 -97
- package/scripts/audit-owner-external-gate-kit.mjs +12 -11
- package/scripts/audit-project-guards.mjs +189 -0
- package/scripts/audit-project.mjs +144 -141
- package/scripts/audit-public-acceptance-command-dry-run-drill.mjs +203 -203
- package/scripts/audit-public-acceptance-handoff.mjs +10 -10
- package/scripts/audit-public-acceptance-readiness.mjs +222 -222
- package/scripts/audit-public-channel-publication.mjs +248 -248
- package/scripts/audit-public-ci-run.mjs +184 -184
- package/scripts/audit-public-collaboration-templates.mjs +98 -98
- package/scripts/audit-public-external-gate-probe.mjs +206 -206
- package/scripts/audit-public-release-checklist.mjs +17 -15
- package/scripts/audit-public-release-decision.mjs +201 -201
- package/scripts/audit-public-release-metadata.mjs +176 -176
- package/scripts/audit-public-repository-settings.mjs +237 -237
- package/scripts/audit-public-security-contact.mjs +171 -171
- package/scripts/audit-readme-docs.mjs +6 -4
- package/scripts/audit-recovery-readiness.mjs +98 -98
- package/scripts/audit-release-bundle.mjs +13 -11
- package/scripts/audit-release-owner-action-plan-drill.mjs +5 -4
- package/scripts/audit-release-owner-action-plan.mjs +10 -10
- package/scripts/audit-release-readiness.mjs +106 -106
- package/scripts/audit-release-status-manifest.mjs +4 -4
- package/scripts/audit-release-trust.mjs +62 -62
- package/scripts/audit-remote-distribution.mjs +266 -266
- package/scripts/audit-roadmap-consistency.mjs +234 -230
- package/scripts/audit-role-dispatch-fallback.mjs +212 -0
- package/scripts/audit-session-sync.mjs +127 -0
- package/scripts/audit-signing.mjs +147 -147
- package/scripts/audit-state-freshness.mjs +20 -14
- package/scripts/audit-state-repair.mjs +360 -0
- package/scripts/audit-target-adoption-evidence.mjs +117 -117
- package/scripts/audit-target-hardening-drills.mjs +267 -0
- package/scripts/audit-target-project.mjs +507 -507
- package/scripts/audit-tool-fallback-policy.mjs +180 -0
- package/scripts/audit-ui-browser-evidence-policy.mjs +191 -0
- package/scripts/audit-update-release-acceptance.mjs +136 -136
- package/scripts/audit-v1-target-validation.mjs +269 -269
- package/scripts/audit-validation-profiles.mjs +125 -123
- package/scripts/backfill-evidence-levels.mjs +98 -0
- package/scripts/check-encoding.mjs +72 -0
- package/scripts/close-change.mjs +116 -116
- package/scripts/discover-project-profile.mjs +307 -307
- package/scripts/generate-command-adapter.mjs +231 -231
- package/scripts/generate-continue-packet.mjs +1214 -0
- package/scripts/generate-final-acceptance-packet.mjs +188 -173
- package/scripts/generate-final-form-progress-report.mjs +191 -189
- package/scripts/generate-host-runtime-evidence-handoff.mjs +198 -191
- package/scripts/generate-maintenance-snapshot.mjs +216 -0
- package/scripts/generate-owner-external-gate-kit.mjs +295 -295
- package/scripts/generate-public-acceptance-handoff.mjs +168 -156
- package/scripts/generate-public-release-checklist.mjs +207 -207
- package/scripts/generate-release-bundle.mjs +505 -505
- package/scripts/generate-release-owner-action-plan.mjs +172 -171
- package/scripts/generate-release-status-manifest.mjs +199 -198
- package/scripts/generate-session-prompt.mjs +188 -188
- package/scripts/gse.mjs +67 -67
- package/scripts/init-change.mjs +265 -265
- package/scripts/init-project.mjs +793 -712
- package/scripts/install-gse.mjs +234 -234
- package/scripts/lib/evidence-placeholders.mjs +28 -28
- package/scripts/package-gse.mjs +174 -174
- package/scripts/probe-public-external-gates.mjs +167 -167
- package/scripts/record-host-invocation.mjs +151 -151
- package/scripts/record-learning.mjs +37 -8
- package/scripts/record-public-channel-publication.mjs +178 -178
- package/scripts/record-public-ci-run.mjs +180 -180
- package/scripts/record-public-release.mjs +175 -175
- package/scripts/record-public-repository-settings.mjs +209 -209
- package/scripts/record-public-security-contact.mjs +157 -157
- package/scripts/record-session-sync.mjs +87 -0
- package/scripts/run-gse-command.mjs +79 -47
- package/scripts/run-validation-profile.mjs +24 -5
- package/scripts/sign-gse-package.mjs +83 -83
- package/scripts/update-project-state.mjs +223 -223
- package/scripts/validate-gse.mjs +216 -0
- package/scripts/verify-gse-package.mjs +85 -85
|
@@ -1,175 +1,175 @@
|
|
|
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
|
-
function hasArg(name) {
|
|
14
|
-
return args.includes(name)
|
|
15
|
-
}
|
|
16
|
-
|
|
17
|
-
const root = path.resolve(readArg('--root', path.join(import.meta.dirname, '..')))
|
|
18
|
-
const releaseName = readArg('--release-name', 'GSE')
|
|
19
|
-
const releaseLabel = readArg('--release-label', 'unreleased')
|
|
20
|
-
const releaseDate = readArg('--release-date', new Date().toISOString().slice(0, 10))
|
|
21
|
-
const channel = readArg('--channel', 'owner-required')
|
|
22
|
-
const licenseStatus = readArg('--license-status', 'owner-required')
|
|
23
|
-
const spdx = readArg('--spdx', '')
|
|
24
|
-
const licenseFile = readArg('--license-file', '')
|
|
25
|
-
const approvedBy = readArg('--approved-by', '')
|
|
26
|
-
const decisionDate = readArg('--decision-date', '')
|
|
27
|
-
const changelogPath = readArg('--changelog-path', 'CHANGELOG.md')
|
|
28
|
-
const packagePath = readArg('--package-path', '<install-skill-dir>')
|
|
29
|
-
const validationCommand = readArg('--validation-command', 'node scripts/validate-gse.mjs --root <skill> --json')
|
|
30
|
-
const evidenceStatus = readArg('--evidence-status', licenseStatus === 'selected' ? 'accepted' : 'result')
|
|
31
|
-
const out = path.resolve(readArg('--out', path.join(root, '.gse', 'releases', 'public-release-owner-required.md')))
|
|
32
|
-
const dryRun = hasArg('--dry-run')
|
|
33
|
-
const force = hasArg('--force')
|
|
34
|
-
const jsonOnly = hasArg('--json')
|
|
35
|
-
|
|
36
|
-
function exists(relativePath) {
|
|
37
|
-
return fs.existsSync(path.join(root, relativePath))
|
|
38
|
-
}
|
|
39
|
-
|
|
40
|
-
function pushError(errors, condition, message) {
|
|
41
|
-
if (!condition) errors.push(message)
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
const validLicenseStatuses = new Set(['owner-required', 'selected', 'not-public'])
|
|
45
|
-
const errors = []
|
|
46
|
-
|
|
47
|
-
pushError(errors, validLicenseStatuses.has(licenseStatus), 'license-status must be owner-required, selected, or not-public')
|
|
48
|
-
pushError(errors, releaseName.trim().length > 0, 'release-name is required')
|
|
49
|
-
pushError(errors, releaseLabel.trim().length > 0, 'release-label is required')
|
|
50
|
-
pushError(errors, channel.trim().length > 0, 'channel is required')
|
|
51
|
-
pushError(errors, exists(changelogPath), 'changelog-path must exist: ' + changelogPath)
|
|
52
|
-
|
|
53
|
-
if (licenseStatus === 'selected') {
|
|
54
|
-
pushError(errors, spdx.trim().length > 0, 'selected license requires --spdx')
|
|
55
|
-
pushError(errors, licenseFile.trim().length > 0, 'selected license requires --license-file')
|
|
56
|
-
pushError(errors, licenseFile.trim().length > 0 && exists(licenseFile), 'selected license file must exist: ' + licenseFile)
|
|
57
|
-
pushError(errors, approvedBy.trim().length > 0, 'selected license requires --approved-by')
|
|
58
|
-
pushError(errors, decisionDate.trim().length > 0, 'selected license requires --decision-date')
|
|
59
|
-
pushError(errors, evidenceStatus === 'accepted', 'selected license record must use --evidence-status accepted')
|
|
60
|
-
}
|
|
61
|
-
|
|
62
|
-
if (licenseStatus === 'not-public') {
|
|
63
|
-
pushError(errors, approvedBy.trim().length > 0, 'not-public decision requires --approved-by')
|
|
64
|
-
pushError(errors, decisionDate.trim().length > 0, 'not-public decision requires --decision-date')
|
|
65
|
-
}
|
|
66
|
-
|
|
67
|
-
const lines = [
|
|
68
|
-
'# Public Release Record',
|
|
69
|
-
'',
|
|
70
|
-
'Release name: ' + releaseName,
|
|
71
|
-
'',
|
|
72
|
-
'Release version or label: ' + releaseLabel,
|
|
73
|
-
'',
|
|
74
|
-
'Release date: ' + releaseDate,
|
|
75
|
-
'',
|
|
76
|
-
'Distribution channel: ' + channel,
|
|
77
|
-
'',
|
|
78
|
-
'Release scope: GSE public release metadata and distribution readiness',
|
|
79
|
-
'',
|
|
80
|
-
'## License',
|
|
81
|
-
'',
|
|
82
|
-
'License status: ' + licenseStatus,
|
|
83
|
-
'',
|
|
84
|
-
'SPDX identifier: ' + spdx,
|
|
85
|
-
'',
|
|
86
|
-
'License file: ' + licenseFile,
|
|
87
|
-
'',
|
|
88
|
-
'Approved by: ' + approvedBy,
|
|
89
|
-
'',
|
|
90
|
-
'Decision date: ' + decisionDate,
|
|
91
|
-
'',
|
|
92
|
-
'Notes: ' + (licenseStatus === 'owner-required'
|
|
93
|
-
? 'Owner license decision is required before accepted public release.'
|
|
94
|
-
: licenseStatus === 'not-public'
|
|
95
|
-
? 'Package is not approved for public open-source release.'
|
|
96
|
-
: 'Owner-selected license decision recorded.'),
|
|
97
|
-
'',
|
|
98
|
-
'## Artifacts',
|
|
99
|
-
'',
|
|
100
|
-
'Package or source path: ' + packagePath,
|
|
101
|
-
'',
|
|
102
|
-
'Changelog path: ' + changelogPath,
|
|
103
|
-
'',
|
|
104
|
-
'Install/update instructions: references/packaging.md',
|
|
105
|
-
'',
|
|
106
|
-
'Integrity or signing record: references/release-trust.md',
|
|
107
|
-
'',
|
|
108
|
-
'Marketplace/catalog record: references/marketplace-discovery.md',
|
|
109
|
-
'',
|
|
110
|
-
'## Verification',
|
|
111
|
-
'',
|
|
112
|
-
'Validation command: ' + validationCommand,
|
|
113
|
-
'',
|
|
114
|
-
'Validation result: pending current run',
|
|
115
|
-
'',
|
|
116
|
-
'Focused smoke: scripts/audit-public-release-metadata.mjs',
|
|
117
|
-
'',
|
|
118
|
-
'Acceptance evidence: ' + (licenseStatus === 'selected' ? 'Owner license decision accepted; public release still requires remaining public and host evidence.' : 'Owner decision pending.'),
|
|
119
|
-
'',
|
|
120
|
-
'## Risks',
|
|
121
|
-
'',
|
|
122
|
-
'Known unsupported claims: public marketplace approval, public registry publication, legal suitability, and host-native slash-command runtime support are not implied by this record.',
|
|
123
|
-
'',
|
|
124
|
-
'Known compatibility limits: host behavior must be verified per host runtime.',
|
|
125
|
-
'',
|
|
126
|
-
'Rollback or unpublish path: remove public listing/package and publish corrected release record.',
|
|
127
|
-
'',
|
|
128
|
-
'## Acceptance',
|
|
129
|
-
'',
|
|
130
|
-
'Evidence status: ' + evidenceStatus,
|
|
131
|
-
'',
|
|
132
|
-
'Accepted by: ' + approvedBy,
|
|
133
|
-
'',
|
|
134
|
-
'Accepted at: ' + (evidenceStatus === 'accepted' ? decisionDate : ''),
|
|
135
|
-
'',
|
|
136
|
-
'Next action: ' + (licenseStatus === 'owner-required'
|
|
137
|
-
? 'Owner selects license or records not-public decision.'
|
|
138
|
-
: 'Run release validation and preserve acceptance evidence.'),
|
|
139
|
-
'',
|
|
140
|
-
]
|
|
141
|
-
|
|
142
|
-
const report = {
|
|
143
|
-
root,
|
|
144
|
-
out,
|
|
145
|
-
dryRun,
|
|
146
|
-
releaseName,
|
|
147
|
-
releaseLabel,
|
|
148
|
-
channel,
|
|
149
|
-
licenseStatus,
|
|
150
|
-
evidenceStatus,
|
|
151
|
-
status: errors.length > 0 ? 'failed' : dryRun ? 'ready' : 'written',
|
|
152
|
-
errors,
|
|
153
|
-
}
|
|
154
|
-
|
|
155
|
-
if (errors.length === 0 && !dryRun) {
|
|
156
|
-
if (fs.existsSync(out) && !force) {
|
|
157
|
-
report.status = 'exists'
|
|
158
|
-
report.errors.push('output exists; use --force or choose another --out path')
|
|
159
|
-
} else {
|
|
160
|
-
fs.mkdirSync(path.dirname(out), { recursive: true })
|
|
161
|
-
fs.writeFileSync(out, lines.join('\n'), 'utf8')
|
|
162
|
-
}
|
|
163
|
-
}
|
|
164
|
-
|
|
165
|
-
if (jsonOnly) console.log(JSON.stringify(report, null, 2))
|
|
166
|
-
else {
|
|
167
|
-
console.log('Public release record status: ' + report.status)
|
|
168
|
-
console.log('Output: ' + report.out)
|
|
169
|
-
if (report.errors.length) {
|
|
170
|
-
console.log('Errors:')
|
|
171
|
-
for (const error of report.errors) console.log('- ' + error)
|
|
172
|
-
}
|
|
173
|
-
}
|
|
174
|
-
|
|
175
|
-
if (report.status === 'failed' || report.status === 'exists') process.exit(1)
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import fs from 'node:fs'
|
|
3
|
+
import path from 'node:path'
|
|
4
|
+
|
|
5
|
+
const args = process.argv.slice(2)
|
|
6
|
+
|
|
7
|
+
function readArg(name, fallback = null) {
|
|
8
|
+
const index = args.indexOf(name)
|
|
9
|
+
if (index === -1) return fallback
|
|
10
|
+
return args[index + 1] ?? fallback
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
function hasArg(name) {
|
|
14
|
+
return args.includes(name)
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
const root = path.resolve(readArg('--root', path.join(import.meta.dirname, '..')))
|
|
18
|
+
const releaseName = readArg('--release-name', 'GSE')
|
|
19
|
+
const releaseLabel = readArg('--release-label', 'unreleased')
|
|
20
|
+
const releaseDate = readArg('--release-date', new Date().toISOString().slice(0, 10))
|
|
21
|
+
const channel = readArg('--channel', 'owner-required')
|
|
22
|
+
const licenseStatus = readArg('--license-status', 'owner-required')
|
|
23
|
+
const spdx = readArg('--spdx', '')
|
|
24
|
+
const licenseFile = readArg('--license-file', '')
|
|
25
|
+
const approvedBy = readArg('--approved-by', '')
|
|
26
|
+
const decisionDate = readArg('--decision-date', '')
|
|
27
|
+
const changelogPath = readArg('--changelog-path', 'CHANGELOG.md')
|
|
28
|
+
const packagePath = readArg('--package-path', '<install-skill-dir>')
|
|
29
|
+
const validationCommand = readArg('--validation-command', 'node scripts/validate-gse.mjs --root <skill> --json')
|
|
30
|
+
const evidenceStatus = readArg('--evidence-status', licenseStatus === 'selected' ? 'accepted' : 'result')
|
|
31
|
+
const out = path.resolve(readArg('--out', path.join(root, '.gse', 'releases', 'public-release-owner-required.md')))
|
|
32
|
+
const dryRun = hasArg('--dry-run')
|
|
33
|
+
const force = hasArg('--force')
|
|
34
|
+
const jsonOnly = hasArg('--json')
|
|
35
|
+
|
|
36
|
+
function exists(relativePath) {
|
|
37
|
+
return fs.existsSync(path.join(root, relativePath))
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
function pushError(errors, condition, message) {
|
|
41
|
+
if (!condition) errors.push(message)
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
const validLicenseStatuses = new Set(['owner-required', 'selected', 'not-public'])
|
|
45
|
+
const errors = []
|
|
46
|
+
|
|
47
|
+
pushError(errors, validLicenseStatuses.has(licenseStatus), 'license-status must be owner-required, selected, or not-public')
|
|
48
|
+
pushError(errors, releaseName.trim().length > 0, 'release-name is required')
|
|
49
|
+
pushError(errors, releaseLabel.trim().length > 0, 'release-label is required')
|
|
50
|
+
pushError(errors, channel.trim().length > 0, 'channel is required')
|
|
51
|
+
pushError(errors, exists(changelogPath), 'changelog-path must exist: ' + changelogPath)
|
|
52
|
+
|
|
53
|
+
if (licenseStatus === 'selected') {
|
|
54
|
+
pushError(errors, spdx.trim().length > 0, 'selected license requires --spdx')
|
|
55
|
+
pushError(errors, licenseFile.trim().length > 0, 'selected license requires --license-file')
|
|
56
|
+
pushError(errors, licenseFile.trim().length > 0 && exists(licenseFile), 'selected license file must exist: ' + licenseFile)
|
|
57
|
+
pushError(errors, approvedBy.trim().length > 0, 'selected license requires --approved-by')
|
|
58
|
+
pushError(errors, decisionDate.trim().length > 0, 'selected license requires --decision-date')
|
|
59
|
+
pushError(errors, evidenceStatus === 'accepted', 'selected license record must use --evidence-status accepted')
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
if (licenseStatus === 'not-public') {
|
|
63
|
+
pushError(errors, approvedBy.trim().length > 0, 'not-public decision requires --approved-by')
|
|
64
|
+
pushError(errors, decisionDate.trim().length > 0, 'not-public decision requires --decision-date')
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
const lines = [
|
|
68
|
+
'# Public Release Record',
|
|
69
|
+
'',
|
|
70
|
+
'Release name: ' + releaseName,
|
|
71
|
+
'',
|
|
72
|
+
'Release version or label: ' + releaseLabel,
|
|
73
|
+
'',
|
|
74
|
+
'Release date: ' + releaseDate,
|
|
75
|
+
'',
|
|
76
|
+
'Distribution channel: ' + channel,
|
|
77
|
+
'',
|
|
78
|
+
'Release scope: GSE public release metadata and distribution readiness',
|
|
79
|
+
'',
|
|
80
|
+
'## License',
|
|
81
|
+
'',
|
|
82
|
+
'License status: ' + licenseStatus,
|
|
83
|
+
'',
|
|
84
|
+
'SPDX identifier: ' + spdx,
|
|
85
|
+
'',
|
|
86
|
+
'License file: ' + licenseFile,
|
|
87
|
+
'',
|
|
88
|
+
'Approved by: ' + approvedBy,
|
|
89
|
+
'',
|
|
90
|
+
'Decision date: ' + decisionDate,
|
|
91
|
+
'',
|
|
92
|
+
'Notes: ' + (licenseStatus === 'owner-required'
|
|
93
|
+
? 'Owner license decision is required before accepted public release.'
|
|
94
|
+
: licenseStatus === 'not-public'
|
|
95
|
+
? 'Package is not approved for public open-source release.'
|
|
96
|
+
: 'Owner-selected license decision recorded.'),
|
|
97
|
+
'',
|
|
98
|
+
'## Artifacts',
|
|
99
|
+
'',
|
|
100
|
+
'Package or source path: ' + packagePath,
|
|
101
|
+
'',
|
|
102
|
+
'Changelog path: ' + changelogPath,
|
|
103
|
+
'',
|
|
104
|
+
'Install/update instructions: references/packaging.md',
|
|
105
|
+
'',
|
|
106
|
+
'Integrity or signing record: references/release-trust.md',
|
|
107
|
+
'',
|
|
108
|
+
'Marketplace/catalog record: references/marketplace-discovery.md',
|
|
109
|
+
'',
|
|
110
|
+
'## Verification',
|
|
111
|
+
'',
|
|
112
|
+
'Validation command: ' + validationCommand,
|
|
113
|
+
'',
|
|
114
|
+
'Validation result: pending current run',
|
|
115
|
+
'',
|
|
116
|
+
'Focused smoke: scripts/audit-public-release-metadata.mjs',
|
|
117
|
+
'',
|
|
118
|
+
'Acceptance evidence: ' + (licenseStatus === 'selected' ? 'Owner license decision accepted; public release still requires remaining public and host evidence.' : 'Owner decision pending.'),
|
|
119
|
+
'',
|
|
120
|
+
'## Risks',
|
|
121
|
+
'',
|
|
122
|
+
'Known unsupported claims: public marketplace approval, public registry publication, legal suitability, and host-native slash-command runtime support are not implied by this record.',
|
|
123
|
+
'',
|
|
124
|
+
'Known compatibility limits: host behavior must be verified per host runtime.',
|
|
125
|
+
'',
|
|
126
|
+
'Rollback or unpublish path: remove public listing/package and publish corrected release record.',
|
|
127
|
+
'',
|
|
128
|
+
'## Acceptance',
|
|
129
|
+
'',
|
|
130
|
+
'Evidence status: ' + evidenceStatus,
|
|
131
|
+
'',
|
|
132
|
+
'Accepted by: ' + approvedBy,
|
|
133
|
+
'',
|
|
134
|
+
'Accepted at: ' + (evidenceStatus === 'accepted' ? decisionDate : ''),
|
|
135
|
+
'',
|
|
136
|
+
'Next action: ' + (licenseStatus === 'owner-required'
|
|
137
|
+
? 'Owner selects license or records not-public decision.'
|
|
138
|
+
: 'Run release validation and preserve acceptance evidence.'),
|
|
139
|
+
'',
|
|
140
|
+
]
|
|
141
|
+
|
|
142
|
+
const report = {
|
|
143
|
+
root,
|
|
144
|
+
out,
|
|
145
|
+
dryRun,
|
|
146
|
+
releaseName,
|
|
147
|
+
releaseLabel,
|
|
148
|
+
channel,
|
|
149
|
+
licenseStatus,
|
|
150
|
+
evidenceStatus,
|
|
151
|
+
status: errors.length > 0 ? 'failed' : dryRun ? 'ready' : 'written',
|
|
152
|
+
errors,
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
if (errors.length === 0 && !dryRun) {
|
|
156
|
+
if (fs.existsSync(out) && !force) {
|
|
157
|
+
report.status = 'exists'
|
|
158
|
+
report.errors.push('output exists; use --force or choose another --out path')
|
|
159
|
+
} else {
|
|
160
|
+
fs.mkdirSync(path.dirname(out), { recursive: true })
|
|
161
|
+
fs.writeFileSync(out, lines.join('\n'), 'utf8')
|
|
162
|
+
}
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
if (jsonOnly) console.log(JSON.stringify(report, null, 2))
|
|
166
|
+
else {
|
|
167
|
+
console.log('Public release record status: ' + report.status)
|
|
168
|
+
console.log('Output: ' + report.out)
|
|
169
|
+
if (report.errors.length) {
|
|
170
|
+
console.log('Errors:')
|
|
171
|
+
for (const error of report.errors) console.log('- ' + error)
|
|
172
|
+
}
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
if (report.status === 'failed' || report.status === 'exists') process.exit(1)
|