@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,108 +1,108 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
import fs from 'node:fs'
|
|
3
|
-
import path from 'node:path'
|
|
4
|
-
|
|
5
|
-
const args = process.argv.slice(2)
|
|
6
|
-
|
|
7
|
-
function readArg(name, fallback = null) {
|
|
8
|
-
const index = args.indexOf(name)
|
|
9
|
-
if (index === -1) return fallback
|
|
10
|
-
return args[index + 1] ?? fallback
|
|
11
|
-
}
|
|
12
|
-
|
|
13
|
-
const root = path.resolve(readArg('--root', path.join(import.meta.dirname, '..')))
|
|
14
|
-
const jsonOnly = args.includes('--json')
|
|
15
|
-
|
|
16
|
-
function read(relativePath) {
|
|
17
|
-
const fullPath = path.join(root, relativePath)
|
|
18
|
-
return fs.existsSync(fullPath) ? fs.readFileSync(fullPath, 'utf8') : ''
|
|
19
|
-
}
|
|
20
|
-
|
|
21
|
-
function exists(relativePath) {
|
|
22
|
-
return fs.existsSync(path.join(root, relativePath))
|
|
23
|
-
}
|
|
24
|
-
|
|
25
|
-
function check(id, label, ok, evidence, risk = '') {
|
|
26
|
-
return { id, label, status: ok ? 'passed' : 'failed', evidence, risk }
|
|
27
|
-
}
|
|
28
|
-
|
|
29
|
-
const domain = read('references/domain-quality-gates.md')
|
|
30
|
-
const quality = read('references/quality-gates.md')
|
|
31
|
-
const review = read('references/review.md')
|
|
32
|
-
const architecture = read('references/architecture-health.md')
|
|
33
|
-
const skill = read('SKILL.md')
|
|
34
|
-
|
|
35
|
-
const domains = [
|
|
36
|
-
'Security/privacy',
|
|
37
|
-
'Performance/cost',
|
|
38
|
-
'Accessibility',
|
|
39
|
-
'Resilience/recovery',
|
|
40
|
-
'UI/browser',
|
|
41
|
-
'API/state',
|
|
42
|
-
'Data/migration',
|
|
43
|
-
'Model/tool routing',
|
|
44
|
-
'Release/operations',
|
|
45
|
-
]
|
|
46
|
-
const evidenceTerms = ['File inspection', 'Focused tests', 'API smokes', 'Browser smokes', 'Architecture/review scans']
|
|
47
|
-
const outputFields = ['Domain gates selected:', 'Why selected:', 'Evidence run:', 'Evidence status:', 'Unverified tools:', 'Residual risk:', 'Next action:']
|
|
48
|
-
const scaleTerms = ['Lite', 'Standard', 'Enterprise']
|
|
49
|
-
|
|
50
|
-
const checks = [
|
|
51
|
-
check('DQ01', 'domain quality gates reference exists', exists('references/domain-quality-gates.md'), 'references/domain-quality-gates.md'),
|
|
52
|
-
check('DQ02', 'SKILL routes domain quality gates', skill.includes('references/domain-quality-gates.md'), 'SKILL.md Reference Routing'),
|
|
53
|
-
check('DQ03', 'quality-gates routes to domain gates', quality.includes('references/domain-quality-gates.md') && quality.includes('## Domain Gates'), 'references/quality-gates.md'),
|
|
54
|
-
check('DQ04', 'review protocol routes to domain gates', review.includes('references/domain-quality-gates.md'), 'references/review.md'),
|
|
55
|
-
check('DQ05', 'all required domains are represented', domains.every((item) => domain.includes(item)), domains.join(', ')),
|
|
56
|
-
check('DQ06', 'scale adaptation is explicit', scaleTerms.every((item) => domain.includes(item)) && domain.includes('Lite work should not inherit every gate by default'), 'Lite, Standard, Enterprise'),
|
|
57
|
-
check('DQ07', 'evidence taxonomy routing is explicit', domain.includes('references/evidence-taxonomy.md') && domain.includes('result') && domain.includes('verified') && domain.includes('accepted'), 'evidence taxonomy labels'),
|
|
58
|
-
check('DQ08', 'tool execution is not faked', domain.includes('Do not claim scan, benchmark, browser, accessibility, security, or resilience results unless') && domain.includes('actually executed'), 'tool execution claim rule'),
|
|
59
|
-
check('DQ09', 'minimum evidence mapping covers major evidence modes', evidenceTerms.every((item) => domain.includes(item)), evidenceTerms.join(', ')),
|
|
60
|
-
check('DQ10', 'output format includes selected gates and residual risk', outputFields.every((item) => domain.includes(item)), outputFields.join(', ')),
|
|
61
|
-
check('DQ11', 'architecture health covers performance and resilience risk', architecture.includes('Performance And Resilience') && architecture.includes('migration') && architecture.includes('release'), 'references/architecture-health.md'),
|
|
62
|
-
check('DQ12', 'quality gates remain risk-based instead of mandatory for every task', domain.includes('Pick only the gates that match the changed behavior and project risk') && quality.includes('Do not force all gates onto Lite tasks'), 'risk-based gate language'),
|
|
63
|
-
]
|
|
64
|
-
|
|
65
|
-
const passed = checks.filter((item) => item.status === 'passed').length
|
|
66
|
-
const failed = checks.length - passed
|
|
67
|
-
const report = {
|
|
68
|
-
root,
|
|
69
|
-
generatedAt: new Date().toISOString(),
|
|
70
|
-
summary: { status: failed === 0 ? 'passed' : 'failed', passed, failed, total: checks.length },
|
|
71
|
-
workflows: { domainQualityGates: failed === 0 ? 'verified' : 'failed' },
|
|
72
|
-
limits: [
|
|
73
|
-
'Domain quality gate audit verifies reusable guidance and routing; it does not run project-specific security scans, benchmarks, accessibility tools, browser tests, or API smokes.',
|
|
74
|
-
'Projects must still execute the selected gates with their own commands, tools, owners, and evidence.',
|
|
75
|
-
],
|
|
76
|
-
checks,
|
|
77
|
-
}
|
|
78
|
-
|
|
79
|
-
function renderMarkdown(data) {
|
|
80
|
-
const lines = []
|
|
81
|
-
lines.push('# GSE Domain Quality Gate Audit')
|
|
82
|
-
lines.push('')
|
|
83
|
-
lines.push('Generated: ' + data.generatedAt)
|
|
84
|
-
lines.push('Root: ' + data.root)
|
|
85
|
-
lines.push('')
|
|
86
|
-
lines.push('## Summary')
|
|
87
|
-
lines.push('')
|
|
88
|
-
lines.push('- Status: ' + data.summary.status)
|
|
89
|
-
lines.push('- Checks: ' + data.summary.passed + '/' + data.summary.total)
|
|
90
|
-
lines.push('- Domain quality gates: ' + data.workflows.domainQualityGates)
|
|
91
|
-
lines.push('')
|
|
92
|
-
lines.push('## Checks')
|
|
93
|
-
lines.push('')
|
|
94
|
-
for (const item of data.checks) {
|
|
95
|
-
const marker = item.status === 'passed' ? '[x]' : '[ ]'
|
|
96
|
-
lines.push('- ' + marker + ' ' + item.id + ' ' + item.label + ': ' + item.evidence)
|
|
97
|
-
}
|
|
98
|
-
lines.push('')
|
|
99
|
-
lines.push('## Limits')
|
|
100
|
-
lines.push('')
|
|
101
|
-
for (const item of data.limits) lines.push('- ' + item)
|
|
102
|
-
return lines.join('\n') + '\n'
|
|
103
|
-
}
|
|
104
|
-
|
|
105
|
-
if (jsonOnly) console.log(JSON.stringify(report, null, 2))
|
|
106
|
-
else console.log(renderMarkdown(report))
|
|
107
|
-
|
|
108
|
-
if (failed > 0) process.exit(1)
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import fs from 'node:fs'
|
|
3
|
+
import path from 'node:path'
|
|
4
|
+
|
|
5
|
+
const args = process.argv.slice(2)
|
|
6
|
+
|
|
7
|
+
function readArg(name, fallback = null) {
|
|
8
|
+
const index = args.indexOf(name)
|
|
9
|
+
if (index === -1) return fallback
|
|
10
|
+
return args[index + 1] ?? fallback
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
const root = path.resolve(readArg('--root', path.join(import.meta.dirname, '..')))
|
|
14
|
+
const jsonOnly = args.includes('--json')
|
|
15
|
+
|
|
16
|
+
function read(relativePath) {
|
|
17
|
+
const fullPath = path.join(root, relativePath)
|
|
18
|
+
return fs.existsSync(fullPath) ? fs.readFileSync(fullPath, 'utf8') : ''
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
function exists(relativePath) {
|
|
22
|
+
return fs.existsSync(path.join(root, relativePath))
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
function check(id, label, ok, evidence, risk = '') {
|
|
26
|
+
return { id, label, status: ok ? 'passed' : 'failed', evidence, risk }
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
const domain = read('references/domain-quality-gates.md')
|
|
30
|
+
const quality = read('references/quality-gates.md')
|
|
31
|
+
const review = read('references/review.md')
|
|
32
|
+
const architecture = read('references/architecture-health.md')
|
|
33
|
+
const skill = read('SKILL.md')
|
|
34
|
+
|
|
35
|
+
const domains = [
|
|
36
|
+
'Security/privacy',
|
|
37
|
+
'Performance/cost',
|
|
38
|
+
'Accessibility',
|
|
39
|
+
'Resilience/recovery',
|
|
40
|
+
'UI/browser',
|
|
41
|
+
'API/state',
|
|
42
|
+
'Data/migration',
|
|
43
|
+
'Model/tool routing',
|
|
44
|
+
'Release/operations',
|
|
45
|
+
]
|
|
46
|
+
const evidenceTerms = ['File inspection', 'Focused tests', 'API smokes', 'Browser smokes', 'Architecture/review scans']
|
|
47
|
+
const outputFields = ['Domain gates selected:', 'Why selected:', 'Evidence run:', 'Evidence status:', 'Unverified tools:', 'Residual risk:', 'Next action:']
|
|
48
|
+
const scaleTerms = ['Lite', 'Standard', 'Enterprise']
|
|
49
|
+
|
|
50
|
+
const checks = [
|
|
51
|
+
check('DQ01', 'domain quality gates reference exists', exists('references/domain-quality-gates.md'), 'references/domain-quality-gates.md'),
|
|
52
|
+
check('DQ02', 'SKILL routes domain quality gates', skill.includes('references/domain-quality-gates.md'), 'SKILL.md Reference Routing'),
|
|
53
|
+
check('DQ03', 'quality-gates routes to domain gates', quality.includes('references/domain-quality-gates.md') && quality.includes('## Domain Gates'), 'references/quality-gates.md'),
|
|
54
|
+
check('DQ04', 'review protocol routes to domain gates', review.includes('references/domain-quality-gates.md'), 'references/review.md'),
|
|
55
|
+
check('DQ05', 'all required domains are represented', domains.every((item) => domain.includes(item)), domains.join(', ')),
|
|
56
|
+
check('DQ06', 'scale adaptation is explicit', scaleTerms.every((item) => domain.includes(item)) && domain.includes('Lite work should not inherit every gate by default'), 'Lite, Standard, Enterprise'),
|
|
57
|
+
check('DQ07', 'evidence taxonomy routing is explicit', domain.includes('references/evidence-taxonomy.md') && domain.includes('result') && domain.includes('verified') && domain.includes('accepted'), 'evidence taxonomy labels'),
|
|
58
|
+
check('DQ08', 'tool execution is not faked', domain.includes('Do not claim scan, benchmark, browser, accessibility, security, or resilience results unless') && domain.includes('actually executed'), 'tool execution claim rule'),
|
|
59
|
+
check('DQ09', 'minimum evidence mapping covers major evidence modes', evidenceTerms.every((item) => domain.includes(item)), evidenceTerms.join(', ')),
|
|
60
|
+
check('DQ10', 'output format includes selected gates and residual risk', outputFields.every((item) => domain.includes(item)), outputFields.join(', ')),
|
|
61
|
+
check('DQ11', 'architecture health covers performance and resilience risk', architecture.includes('Performance And Resilience') && architecture.includes('migration') && architecture.includes('release'), 'references/architecture-health.md'),
|
|
62
|
+
check('DQ12', 'quality gates remain risk-based instead of mandatory for every task', domain.includes('Pick only the gates that match the changed behavior and project risk') && quality.includes('Do not force all gates onto Lite tasks'), 'risk-based gate language'),
|
|
63
|
+
]
|
|
64
|
+
|
|
65
|
+
const passed = checks.filter((item) => item.status === 'passed').length
|
|
66
|
+
const failed = checks.length - passed
|
|
67
|
+
const report = {
|
|
68
|
+
root,
|
|
69
|
+
generatedAt: new Date().toISOString(),
|
|
70
|
+
summary: { status: failed === 0 ? 'passed' : 'failed', passed, failed, total: checks.length },
|
|
71
|
+
workflows: { domainQualityGates: failed === 0 ? 'verified' : 'failed' },
|
|
72
|
+
limits: [
|
|
73
|
+
'Domain quality gate audit verifies reusable guidance and routing; it does not run project-specific security scans, benchmarks, accessibility tools, browser tests, or API smokes.',
|
|
74
|
+
'Projects must still execute the selected gates with their own commands, tools, owners, and evidence.',
|
|
75
|
+
],
|
|
76
|
+
checks,
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
function renderMarkdown(data) {
|
|
80
|
+
const lines = []
|
|
81
|
+
lines.push('# GSE Domain Quality Gate Audit')
|
|
82
|
+
lines.push('')
|
|
83
|
+
lines.push('Generated: ' + data.generatedAt)
|
|
84
|
+
lines.push('Root: ' + data.root)
|
|
85
|
+
lines.push('')
|
|
86
|
+
lines.push('## Summary')
|
|
87
|
+
lines.push('')
|
|
88
|
+
lines.push('- Status: ' + data.summary.status)
|
|
89
|
+
lines.push('- Checks: ' + data.summary.passed + '/' + data.summary.total)
|
|
90
|
+
lines.push('- Domain quality gates: ' + data.workflows.domainQualityGates)
|
|
91
|
+
lines.push('')
|
|
92
|
+
lines.push('## Checks')
|
|
93
|
+
lines.push('')
|
|
94
|
+
for (const item of data.checks) {
|
|
95
|
+
const marker = item.status === 'passed' ? '[x]' : '[ ]'
|
|
96
|
+
lines.push('- ' + marker + ' ' + item.id + ' ' + item.label + ': ' + item.evidence)
|
|
97
|
+
}
|
|
98
|
+
lines.push('')
|
|
99
|
+
lines.push('## Limits')
|
|
100
|
+
lines.push('')
|
|
101
|
+
for (const item of data.limits) lines.push('- ' + item)
|
|
102
|
+
return lines.join('\n') + '\n'
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
if (jsonOnly) console.log(JSON.stringify(report, null, 2))
|
|
106
|
+
else console.log(renderMarkdown(report))
|
|
107
|
+
|
|
108
|
+
if (failed > 0) process.exit(1)
|
|
@@ -1,126 +1,126 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
import fs from 'node:fs'
|
|
3
|
-
import path from 'node:path'
|
|
4
|
-
import { isPlaceholderEvidence, placeholderEvidenceError } from './lib/evidence-placeholders.mjs'
|
|
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') : ''
|
|
20
|
-
}
|
|
21
|
-
|
|
22
|
-
function exists(relativePath) {
|
|
23
|
-
return fs.existsSync(path.join(root, relativePath))
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
function check(id, label, ok, evidence, risk = '') {
|
|
27
|
-
return { id, label, status: ok ? 'passed' : 'failed', evidence, risk }
|
|
28
|
-
}
|
|
29
|
-
|
|
30
|
-
const placeholderCases = [
|
|
31
|
-
'__PLACEHOLDER__',
|
|
32
|
-
'<placeholder>',
|
|
33
|
-
'fixture-owner',
|
|
34
|
-
'todo',
|
|
35
|
-
'https://example.com/security',
|
|
36
|
-
'https://github.com/example/gse/actions/runs/123',
|
|
37
|
-
'https://registry.example/gse',
|
|
38
|
-
'http://localhost:3000/result',
|
|
39
|
-
'http://127.0.0.1/result',
|
|
40
|
-
'security@example.com',
|
|
41
|
-
'https://release.local/gse',
|
|
42
|
-
]
|
|
43
|
-
|
|
44
|
-
const realCases = [
|
|
45
|
-
'gse-maintainer',
|
|
46
|
-
'security@gse.dev',
|
|
47
|
-
'https://github.com/gse-org/gse/actions/runs/123',
|
|
48
|
-
'https://registry.npmjs.org/@t275005746/gse',
|
|
49
|
-
'https://marketplace.openai.com/gse',
|
|
50
|
-
'sha256:0123456789abcdef',
|
|
51
|
-
]
|
|
52
|
-
|
|
53
|
-
const recordScripts = [
|
|
54
|
-
'scripts/record-public-ci-run.mjs',
|
|
55
|
-
'scripts/record-public-repository-settings.mjs',
|
|
56
|
-
'scripts/record-public-security-contact.mjs',
|
|
57
|
-
'scripts/record-public-channel-publication.mjs',
|
|
58
|
-
]
|
|
59
|
-
|
|
60
|
-
const localFunctionRegex = /function\s+(isPlaceholderEvidence|rejectPlaceholderEvidence)\s*\(/
|
|
61
|
-
const importNeedle = "from './lib/evidence-placeholders.mjs'"
|
|
62
|
-
|
|
63
|
-
const helperSource = read('scripts/lib/evidence-placeholders.mjs')
|
|
64
|
-
const scriptSources = recordScripts.map((relativePath) => ({ relativePath, source: read(relativePath) }))
|
|
65
|
-
const duplicateDefinitions = scriptSources
|
|
66
|
-
.filter((item) => localFunctionRegex.test(item.source))
|
|
67
|
-
.map((item) => item.relativePath)
|
|
68
|
-
const missingImports = scriptSources
|
|
69
|
-
.filter((item) => !item.source.includes(importNeedle))
|
|
70
|
-
.map((item) => item.relativePath)
|
|
71
|
-
|
|
72
|
-
const checks = [
|
|
73
|
-
check('EPH01', 'shared placeholder helper exists', exists('scripts/lib/evidence-placeholders.mjs') && helperSource.includes('export function isPlaceholderEvidence'), 'scripts/lib/evidence-placeholders.mjs'),
|
|
74
|
-
check('EPH02', 'placeholder cases are rejected', placeholderCases.every((value) => isPlaceholderEvidence(value)), placeholderCases.map((value) => `${value}:${isPlaceholderEvidence(value)}`).join(', ')),
|
|
75
|
-
check('EPH03', 'real-looking public evidence cases are allowed', realCases.every((value) => !isPlaceholderEvidence(value)), realCases.map((value) => `${value}:${isPlaceholderEvidence(value)}`).join(', ')),
|
|
76
|
-
check('EPH04', 'placeholder error message stays operator-readable', placeholderEvidenceError('--evidence-url').includes('real public evidence') && placeholderEvidenceError('--evidence-url').includes('--evidence-url'), placeholderEvidenceError('--evidence-url')),
|
|
77
|
-
check('EPH05', 'public record scripts import shared helper', missingImports.length === 0, missingImports.length ? missingImports.join(', ') : recordScripts.join(', ')),
|
|
78
|
-
check('EPH06', 'public record scripts do not carry duplicate placeholder functions', duplicateDefinitions.length === 0, duplicateDefinitions.length ? duplicateDefinitions.join(', ') : 'no duplicate definitions'),
|
|
79
|
-
]
|
|
80
|
-
|
|
81
|
-
const passed = checks.filter((item) => item.status === 'passed').length
|
|
82
|
-
const failed = checks.length - passed
|
|
83
|
-
const report = {
|
|
84
|
-
root,
|
|
85
|
-
generatedAt: new Date().toISOString(),
|
|
86
|
-
summary: { status: failed === 0 ? 'passed' : 'failed', passed, failed, total: checks.length },
|
|
87
|
-
workflows: {
|
|
88
|
-
evidencePlaceholderHelper: failed === 0 ? 'verified' : 'failed',
|
|
89
|
-
},
|
|
90
|
-
limits: [
|
|
91
|
-
'This audit verifies local placeholder detection and script wiring.',
|
|
92
|
-
'It does not decide whether a real owner/external URL is valid or published.',
|
|
93
|
-
],
|
|
94
|
-
checks,
|
|
95
|
-
}
|
|
96
|
-
|
|
97
|
-
function renderMarkdown(data) {
|
|
98
|
-
const lines = []
|
|
99
|
-
lines.push('# GSE Evidence Placeholder Audit')
|
|
100
|
-
lines.push('')
|
|
101
|
-
lines.push('Generated: ' + data.generatedAt)
|
|
102
|
-
lines.push('Root: ' + data.root)
|
|
103
|
-
lines.push('')
|
|
104
|
-
lines.push('## Summary')
|
|
105
|
-
lines.push('')
|
|
106
|
-
lines.push('- Status: ' + data.summary.status)
|
|
107
|
-
lines.push('- Checks: ' + data.summary.passed + '/' + data.summary.total)
|
|
108
|
-
lines.push('- Evidence placeholder helper: ' + data.workflows.evidencePlaceholderHelper)
|
|
109
|
-
lines.push('')
|
|
110
|
-
lines.push('## Checks')
|
|
111
|
-
lines.push('')
|
|
112
|
-
for (const item of data.checks) {
|
|
113
|
-
const marker = item.status === 'passed' ? '[x]' : '[ ]'
|
|
114
|
-
lines.push('- ' + marker + ' ' + item.id + ' ' + item.label + ': ' + item.evidence)
|
|
115
|
-
}
|
|
116
|
-
lines.push('')
|
|
117
|
-
lines.push('## Limits')
|
|
118
|
-
lines.push('')
|
|
119
|
-
for (const item of data.limits) lines.push('- ' + item)
|
|
120
|
-
return lines.join('\n') + '\n'
|
|
121
|
-
}
|
|
122
|
-
|
|
123
|
-
if (jsonOnly) console.log(JSON.stringify(report, null, 2))
|
|
124
|
-
else console.log(renderMarkdown(report))
|
|
125
|
-
|
|
126
|
-
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 { isPlaceholderEvidence, placeholderEvidenceError } from './lib/evidence-placeholders.mjs'
|
|
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') : ''
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
function exists(relativePath) {
|
|
23
|
+
return fs.existsSync(path.join(root, relativePath))
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
function check(id, label, ok, evidence, risk = '') {
|
|
27
|
+
return { id, label, status: ok ? 'passed' : 'failed', evidence, risk }
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
const placeholderCases = [
|
|
31
|
+
'__PLACEHOLDER__',
|
|
32
|
+
'<placeholder>',
|
|
33
|
+
'fixture-owner',
|
|
34
|
+
'todo',
|
|
35
|
+
'https://example.com/security',
|
|
36
|
+
'https://github.com/example/gse/actions/runs/123',
|
|
37
|
+
'https://registry.example/gse',
|
|
38
|
+
'http://localhost:3000/result',
|
|
39
|
+
'http://127.0.0.1/result',
|
|
40
|
+
'security@example.com',
|
|
41
|
+
'https://release.local/gse',
|
|
42
|
+
]
|
|
43
|
+
|
|
44
|
+
const realCases = [
|
|
45
|
+
'gse-maintainer',
|
|
46
|
+
'security@gse.dev',
|
|
47
|
+
'https://github.com/gse-org/gse/actions/runs/123',
|
|
48
|
+
'https://registry.npmjs.org/@t275005746/gse',
|
|
49
|
+
'https://marketplace.openai.com/gse',
|
|
50
|
+
'sha256:0123456789abcdef',
|
|
51
|
+
]
|
|
52
|
+
|
|
53
|
+
const recordScripts = [
|
|
54
|
+
'scripts/record-public-ci-run.mjs',
|
|
55
|
+
'scripts/record-public-repository-settings.mjs',
|
|
56
|
+
'scripts/record-public-security-contact.mjs',
|
|
57
|
+
'scripts/record-public-channel-publication.mjs',
|
|
58
|
+
]
|
|
59
|
+
|
|
60
|
+
const localFunctionRegex = /function\s+(isPlaceholderEvidence|rejectPlaceholderEvidence)\s*\(/
|
|
61
|
+
const importNeedle = "from './lib/evidence-placeholders.mjs'"
|
|
62
|
+
|
|
63
|
+
const helperSource = read('scripts/lib/evidence-placeholders.mjs')
|
|
64
|
+
const scriptSources = recordScripts.map((relativePath) => ({ relativePath, source: read(relativePath) }))
|
|
65
|
+
const duplicateDefinitions = scriptSources
|
|
66
|
+
.filter((item) => localFunctionRegex.test(item.source))
|
|
67
|
+
.map((item) => item.relativePath)
|
|
68
|
+
const missingImports = scriptSources
|
|
69
|
+
.filter((item) => !item.source.includes(importNeedle))
|
|
70
|
+
.map((item) => item.relativePath)
|
|
71
|
+
|
|
72
|
+
const checks = [
|
|
73
|
+
check('EPH01', 'shared placeholder helper exists', exists('scripts/lib/evidence-placeholders.mjs') && helperSource.includes('export function isPlaceholderEvidence'), 'scripts/lib/evidence-placeholders.mjs'),
|
|
74
|
+
check('EPH02', 'placeholder cases are rejected', placeholderCases.every((value) => isPlaceholderEvidence(value)), placeholderCases.map((value) => `${value}:${isPlaceholderEvidence(value)}`).join(', ')),
|
|
75
|
+
check('EPH03', 'real-looking public evidence cases are allowed', realCases.every((value) => !isPlaceholderEvidence(value)), realCases.map((value) => `${value}:${isPlaceholderEvidence(value)}`).join(', ')),
|
|
76
|
+
check('EPH04', 'placeholder error message stays operator-readable', placeholderEvidenceError('--evidence-url').includes('real public evidence') && placeholderEvidenceError('--evidence-url').includes('--evidence-url'), placeholderEvidenceError('--evidence-url')),
|
|
77
|
+
check('EPH05', 'public record scripts import shared helper', missingImports.length === 0, missingImports.length ? missingImports.join(', ') : recordScripts.join(', ')),
|
|
78
|
+
check('EPH06', 'public record scripts do not carry duplicate placeholder functions', duplicateDefinitions.length === 0, duplicateDefinitions.length ? duplicateDefinitions.join(', ') : 'no duplicate definitions'),
|
|
79
|
+
]
|
|
80
|
+
|
|
81
|
+
const passed = checks.filter((item) => item.status === 'passed').length
|
|
82
|
+
const failed = checks.length - passed
|
|
83
|
+
const report = {
|
|
84
|
+
root,
|
|
85
|
+
generatedAt: new Date().toISOString(),
|
|
86
|
+
summary: { status: failed === 0 ? 'passed' : 'failed', passed, failed, total: checks.length },
|
|
87
|
+
workflows: {
|
|
88
|
+
evidencePlaceholderHelper: failed === 0 ? 'verified' : 'failed',
|
|
89
|
+
},
|
|
90
|
+
limits: [
|
|
91
|
+
'This audit verifies local placeholder detection and script wiring.',
|
|
92
|
+
'It does not decide whether a real owner/external URL is valid or published.',
|
|
93
|
+
],
|
|
94
|
+
checks,
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
function renderMarkdown(data) {
|
|
98
|
+
const lines = []
|
|
99
|
+
lines.push('# GSE Evidence Placeholder Audit')
|
|
100
|
+
lines.push('')
|
|
101
|
+
lines.push('Generated: ' + data.generatedAt)
|
|
102
|
+
lines.push('Root: ' + data.root)
|
|
103
|
+
lines.push('')
|
|
104
|
+
lines.push('## Summary')
|
|
105
|
+
lines.push('')
|
|
106
|
+
lines.push('- Status: ' + data.summary.status)
|
|
107
|
+
lines.push('- Checks: ' + data.summary.passed + '/' + data.summary.total)
|
|
108
|
+
lines.push('- Evidence placeholder helper: ' + data.workflows.evidencePlaceholderHelper)
|
|
109
|
+
lines.push('')
|
|
110
|
+
lines.push('## Checks')
|
|
111
|
+
lines.push('')
|
|
112
|
+
for (const item of data.checks) {
|
|
113
|
+
const marker = item.status === 'passed' ? '[x]' : '[ ]'
|
|
114
|
+
lines.push('- ' + marker + ' ' + item.id + ' ' + item.label + ': ' + item.evidence)
|
|
115
|
+
}
|
|
116
|
+
lines.push('')
|
|
117
|
+
lines.push('## Limits')
|
|
118
|
+
lines.push('')
|
|
119
|
+
for (const item of data.limits) lines.push('- ' + item)
|
|
120
|
+
return lines.join('\n') + '\n'
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
if (jsonOnly) console.log(JSON.stringify(report, null, 2))
|
|
124
|
+
else console.log(renderMarkdown(report))
|
|
125
|
+
|
|
126
|
+
if (failed > 0) process.exit(1)
|