@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,188 +1,188 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
import fs from 'node:fs'
|
|
3
|
-
import os from 'node:os'
|
|
4
|
-
import path from 'node:path'
|
|
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 jsonOnly = args.includes('--json')
|
|
15
|
-
const selfTest = args.includes('--self-test') || !args.includes('--target')
|
|
16
|
-
const targetArg = readArg('--target')
|
|
17
|
-
|
|
18
|
-
function readText(filePath) {
|
|
19
|
-
return fs.existsSync(filePath) ? fs.readFileSync(filePath, 'utf8').replace(/^\uFEFF/, '') : ''
|
|
20
|
-
}
|
|
21
|
-
|
|
22
|
-
function readJson(filePath) {
|
|
23
|
-
if (!fs.existsSync(filePath)) return { exists: false, ok: false, data: null, error: 'missing' }
|
|
24
|
-
try {
|
|
25
|
-
return { exists: true, ok: true, data: JSON.parse(readText(filePath)), error: '' }
|
|
26
|
-
} catch (error) {
|
|
27
|
-
return { exists: true, ok: false, data: null, error: error.message }
|
|
28
|
-
}
|
|
29
|
-
}
|
|
30
|
-
|
|
31
|
-
function exists(target, relativePath) {
|
|
32
|
-
return fs.existsSync(path.join(target, relativePath))
|
|
33
|
-
}
|
|
34
|
-
|
|
35
|
-
function firstMatch(text, regex) {
|
|
36
|
-
const match = text.match(regex)
|
|
37
|
-
return match ? match[1].trim() : ''
|
|
38
|
-
}
|
|
39
|
-
|
|
40
|
-
function cleanInlineValue(value) {
|
|
41
|
-
return String(value || '').trim().replace(/[.。::]+$/, '').trim()
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
function findCanonicalPlan(target, state) {
|
|
45
|
-
if (state?.canonicalPlan && exists(target, state.canonicalPlan)) return state.canonicalPlan
|
|
46
|
-
const texts = [
|
|
47
|
-
readText(path.join(target, '.gse', 'README.md')),
|
|
48
|
-
readText(path.join(target, '.gse', 'project-profile.md')),
|
|
49
|
-
readText(path.join(target, '.gse', 'goal-map.md')),
|
|
50
|
-
].join('\n')
|
|
51
|
-
const match = texts.match(/docs\/[A-Za-z0-9._/-]*?(?:architecture|productization)[A-Za-z0-9._/-]*?\.md/)
|
|
52
|
-
if (match && exists(target, match[0])) return match[0]
|
|
53
|
-
for (const fallback of [
|
|
54
|
-
'docs/aion-productization-architecture.md',
|
|
55
|
-
'docs/museflow-ai-film-productization-architecture.md',
|
|
56
|
-
]) {
|
|
57
|
-
if (exists(target, fallback)) return fallback
|
|
58
|
-
}
|
|
59
|
-
return state?.canonicalPlan || ''
|
|
60
|
-
}
|
|
61
|
-
|
|
62
|
-
function createFixture() {
|
|
63
|
-
const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'gse-session-prompt-'))
|
|
64
|
-
fs.mkdirSync(path.join(dir, '.gse', 'evidence'), { recursive: true })
|
|
65
|
-
fs.writeFileSync(path.join(dir, 'AGENTS.md'), '# Rules\n\nUse concise evidence.\n', 'utf8')
|
|
66
|
-
fs.writeFileSync(path.join(dir, '.gse', 'README.md'), '# GSE\n\nCanonical plan: `docs/productization-architecture.md`.\n', 'utf8')
|
|
67
|
-
fs.writeFileSync(path.join(dir, '.gse', 'project-profile.md'), '# Project Profile\n\n- Product/system name: Fixture Product\n- Focused test: npm test\n', 'utf8')
|
|
68
|
-
fs.writeFileSync(path.join(dir, '.gse', 'goal-map.md'), '# Goal Map\n\n## Current Focus\n\n- Priority: P0\n- Active slice: Make fixture continue.\n- Next action: Run focused fixture smoke.\n', 'utf8')
|
|
69
|
-
fs.writeFileSync(path.join(dir, '.gse', 'quality-gates.md'), '# Quality Gates\n\n## Universal\n\n- Evidence required.\n', 'utf8')
|
|
70
|
-
fs.mkdirSync(path.join(dir, 'docs'), { recursive: true })
|
|
71
|
-
fs.writeFileSync(path.join(dir, 'docs', 'productization-architecture.md'), '# Canonical Plan\n\n## Next action\n\nRun fixture.\n', 'utf8')
|
|
72
|
-
fs.writeFileSync(
|
|
73
|
-
path.join(dir, '.gse', 'state.json'),
|
|
74
|
-
JSON.stringify(
|
|
75
|
-
{
|
|
76
|
-
schemaVersion: 1,
|
|
77
|
-
projectName: 'fixture-product',
|
|
78
|
-
mode: 'standard',
|
|
79
|
-
canonicalPlan: 'docs/productization-architecture.md',
|
|
80
|
-
phase: 'execute',
|
|
81
|
-
currentSlice: {
|
|
82
|
-
id: 'fixture-001',
|
|
83
|
-
outcome: 'Make fixture continue.',
|
|
84
|
-
status: 'planned',
|
|
85
|
-
nextAction: 'Run focused fixture smoke.',
|
|
86
|
-
},
|
|
87
|
-
toolStatuses: {
|
|
88
|
-
browser: 'unknown',
|
|
89
|
-
lsp: 'unknown',
|
|
90
|
-
mcp: 'unknown',
|
|
91
|
-
subagents: 'unknown',
|
|
92
|
-
ci: 'unknown',
|
|
93
|
-
},
|
|
94
|
-
lastEvidence: '.gse/evidence/index.jsonl',
|
|
95
|
-
residualRisks: ['Fixture risk.'],
|
|
96
|
-
},
|
|
97
|
-
null,
|
|
98
|
-
2,
|
|
99
|
-
) + '\n',
|
|
100
|
-
'utf8',
|
|
101
|
-
)
|
|
102
|
-
fs.writeFileSync(
|
|
103
|
-
path.join(dir, '.gse', 'evidence', 'index.jsonl'),
|
|
104
|
-
JSON.stringify({
|
|
105
|
-
date: '2026-07-06',
|
|
106
|
-
recordType: 'slice',
|
|
107
|
-
status: 'result',
|
|
108
|
-
summary: 'Fixture initialized.',
|
|
109
|
-
evidenceFile: '.gse/evidence/2026-07-06.md',
|
|
110
|
-
commands: ['fixture'],
|
|
111
|
-
nextAction: 'Run focused fixture smoke.',
|
|
112
|
-
}) + '\n',
|
|
113
|
-
'utf8',
|
|
114
|
-
)
|
|
115
|
-
return dir
|
|
116
|
-
}
|
|
117
|
-
|
|
118
|
-
function generatePrompt(target) {
|
|
119
|
-
const resolvedTarget = path.resolve(target)
|
|
120
|
-
const stateResult = readJson(path.join(resolvedTarget, '.gse', 'state.json'))
|
|
121
|
-
const state = stateResult.ok ? stateResult.data : null
|
|
122
|
-
const goalMap = readText(path.join(resolvedTarget, '.gse', 'goal-map.md'))
|
|
123
|
-
const profile = readText(path.join(resolvedTarget, '.gse', 'project-profile.md'))
|
|
124
|
-
const canonicalPlan = findCanonicalPlan(resolvedTarget, state)
|
|
125
|
-
const warnings = []
|
|
126
|
-
if (!exists(resolvedTarget, '.gse')) warnings.push('missing .gse directory')
|
|
127
|
-
if (!stateResult.exists) warnings.push('missing .gse/state.json')
|
|
128
|
-
else if (!stateResult.ok) warnings.push('invalid .gse/state.json: ' + stateResult.error)
|
|
129
|
-
if (!exists(resolvedTarget, '.gse/evidence/index.jsonl')) warnings.push('missing .gse/evidence/index.jsonl')
|
|
130
|
-
if (!exists(resolvedTarget, '.gse/project-profile.md')) warnings.push('missing .gse/project-profile.md')
|
|
131
|
-
if (!exists(resolvedTarget, '.gse/goal-map.md')) warnings.push('missing .gse/goal-map.md')
|
|
132
|
-
if (canonicalPlan && !exists(resolvedTarget, canonicalPlan)) warnings.push('canonical plan missing: ' + canonicalPlan)
|
|
133
|
-
|
|
134
|
-
const projectName = cleanInlineValue(
|
|
135
|
-
state?.projectName ||
|
|
136
|
-
firstMatch(profile, /Product\/system name:\s*([^\n]+)/i) ||
|
|
137
|
-
path.basename(resolvedTarget),
|
|
138
|
-
)
|
|
139
|
-
const activeSlice =
|
|
140
|
-
state?.currentSlice?.outcome ||
|
|
141
|
-
firstMatch(goalMap, /Active slice:\s*([^\n]+)/i) ||
|
|
142
|
-
'Read the goal map and choose the next verifiable slice.'
|
|
143
|
-
const nextAction =
|
|
144
|
-
state?.currentSlice?.nextAction ||
|
|
145
|
-
firstMatch(goalMap, /Next action:\s*([^\n]+)/i) ||
|
|
146
|
-
'Continue with the smallest verifiable GSE slice.'
|
|
147
|
-
const phase = state?.phase || 'unknown'
|
|
148
|
-
const status = state?.currentSlice?.status || 'unknown'
|
|
149
|
-
const residualRisks = Array.isArray(state?.residualRisks) ? state.residualRisks.slice(0, 3) : []
|
|
150
|
-
|
|
151
|
-
const lines = [
|
|
152
|
-
`Use GSE to continue ${projectName}.`,
|
|
153
|
-
'',
|
|
154
|
-
`Project root: ${resolvedTarget}`,
|
|
155
|
-
'Read in order: project rules, .gse/README.md, .gse/state.json, .gse/project-profile.md, .gse/goal-map.md, .gse/quality-gates.md' + (canonicalPlan ? `, ${canonicalPlan}` : '') + '.',
|
|
156
|
-
`Current phase/status: ${phase} / ${status}.`,
|
|
157
|
-
`Current slice: ${activeSlice}`,
|
|
158
|
-
`Next action: ${nextAction}`,
|
|
159
|
-
]
|
|
160
|
-
if (residualRisks.length) lines.push(`Known risks: ${residualRisks.join('; ')}`)
|
|
161
|
-
if (warnings.length) lines.push(`GSE doctor warnings to handle first: ${warnings.join('; ')}`)
|
|
162
|
-
lines.push('Execute one verifiable slice, record evidence, update state/index/docs, and do not claim completion without the close gate.')
|
|
163
|
-
|
|
164
|
-
return {
|
|
165
|
-
target: resolvedTarget,
|
|
166
|
-
generatedAt: new Date().toISOString(),
|
|
167
|
-
summary: {
|
|
168
|
-
status: warnings.length ? 'warning' : 'passed',
|
|
169
|
-
warnings: warnings.length,
|
|
170
|
-
promptLines: lines.length,
|
|
171
|
-
},
|
|
172
|
-
state: {
|
|
173
|
-
exists: stateResult.exists,
|
|
174
|
-
valid: stateResult.ok,
|
|
175
|
-
phase,
|
|
176
|
-
currentSliceStatus: status,
|
|
177
|
-
},
|
|
178
|
-
canonicalPlan,
|
|
179
|
-
warnings,
|
|
180
|
-
prompt: lines.join('\n'),
|
|
181
|
-
}
|
|
182
|
-
}
|
|
183
|
-
|
|
184
|
-
const target = selfTest ? createFixture() : targetArg
|
|
185
|
-
const report = generatePrompt(target)
|
|
186
|
-
|
|
187
|
-
if (jsonOnly) console.log(JSON.stringify(report, null, 2))
|
|
188
|
-
else console.log(report.prompt + '\n')
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import fs from 'node:fs'
|
|
3
|
+
import os from 'node:os'
|
|
4
|
+
import path from 'node:path'
|
|
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 jsonOnly = args.includes('--json')
|
|
15
|
+
const selfTest = args.includes('--self-test') || !args.includes('--target')
|
|
16
|
+
const targetArg = readArg('--target')
|
|
17
|
+
|
|
18
|
+
function readText(filePath) {
|
|
19
|
+
return fs.existsSync(filePath) ? fs.readFileSync(filePath, 'utf8').replace(/^\uFEFF/, '') : ''
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
function readJson(filePath) {
|
|
23
|
+
if (!fs.existsSync(filePath)) return { exists: false, ok: false, data: null, error: 'missing' }
|
|
24
|
+
try {
|
|
25
|
+
return { exists: true, ok: true, data: JSON.parse(readText(filePath)), error: '' }
|
|
26
|
+
} catch (error) {
|
|
27
|
+
return { exists: true, ok: false, data: null, error: error.message }
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
function exists(target, relativePath) {
|
|
32
|
+
return fs.existsSync(path.join(target, relativePath))
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
function firstMatch(text, regex) {
|
|
36
|
+
const match = text.match(regex)
|
|
37
|
+
return match ? match[1].trim() : ''
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
function cleanInlineValue(value) {
|
|
41
|
+
return String(value || '').trim().replace(/[.。::]+$/, '').trim()
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
function findCanonicalPlan(target, state) {
|
|
45
|
+
if (state?.canonicalPlan && exists(target, state.canonicalPlan)) return state.canonicalPlan
|
|
46
|
+
const texts = [
|
|
47
|
+
readText(path.join(target, '.gse', 'README.md')),
|
|
48
|
+
readText(path.join(target, '.gse', 'project-profile.md')),
|
|
49
|
+
readText(path.join(target, '.gse', 'goal-map.md')),
|
|
50
|
+
].join('\n')
|
|
51
|
+
const match = texts.match(/docs\/[A-Za-z0-9._/-]*?(?:architecture|productization)[A-Za-z0-9._/-]*?\.md/)
|
|
52
|
+
if (match && exists(target, match[0])) return match[0]
|
|
53
|
+
for (const fallback of [
|
|
54
|
+
'docs/aion-productization-architecture.md',
|
|
55
|
+
'docs/museflow-ai-film-productization-architecture.md',
|
|
56
|
+
]) {
|
|
57
|
+
if (exists(target, fallback)) return fallback
|
|
58
|
+
}
|
|
59
|
+
return state?.canonicalPlan || ''
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
function createFixture() {
|
|
63
|
+
const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'gse-session-prompt-'))
|
|
64
|
+
fs.mkdirSync(path.join(dir, '.gse', 'evidence'), { recursive: true })
|
|
65
|
+
fs.writeFileSync(path.join(dir, 'AGENTS.md'), '# Rules\n\nUse concise evidence.\n', 'utf8')
|
|
66
|
+
fs.writeFileSync(path.join(dir, '.gse', 'README.md'), '# GSE\n\nCanonical plan: `docs/productization-architecture.md`.\n', 'utf8')
|
|
67
|
+
fs.writeFileSync(path.join(dir, '.gse', 'project-profile.md'), '# Project Profile\n\n- Product/system name: Fixture Product\n- Focused test: npm test\n', 'utf8')
|
|
68
|
+
fs.writeFileSync(path.join(dir, '.gse', 'goal-map.md'), '# Goal Map\n\n## Current Focus\n\n- Priority: P0\n- Active slice: Make fixture continue.\n- Next action: Run focused fixture smoke.\n', 'utf8')
|
|
69
|
+
fs.writeFileSync(path.join(dir, '.gse', 'quality-gates.md'), '# Quality Gates\n\n## Universal\n\n- Evidence required.\n', 'utf8')
|
|
70
|
+
fs.mkdirSync(path.join(dir, 'docs'), { recursive: true })
|
|
71
|
+
fs.writeFileSync(path.join(dir, 'docs', 'productization-architecture.md'), '# Canonical Plan\n\n## Next action\n\nRun fixture.\n', 'utf8')
|
|
72
|
+
fs.writeFileSync(
|
|
73
|
+
path.join(dir, '.gse', 'state.json'),
|
|
74
|
+
JSON.stringify(
|
|
75
|
+
{
|
|
76
|
+
schemaVersion: 1,
|
|
77
|
+
projectName: 'fixture-product',
|
|
78
|
+
mode: 'standard',
|
|
79
|
+
canonicalPlan: 'docs/productization-architecture.md',
|
|
80
|
+
phase: 'execute',
|
|
81
|
+
currentSlice: {
|
|
82
|
+
id: 'fixture-001',
|
|
83
|
+
outcome: 'Make fixture continue.',
|
|
84
|
+
status: 'planned',
|
|
85
|
+
nextAction: 'Run focused fixture smoke.',
|
|
86
|
+
},
|
|
87
|
+
toolStatuses: {
|
|
88
|
+
browser: 'unknown',
|
|
89
|
+
lsp: 'unknown',
|
|
90
|
+
mcp: 'unknown',
|
|
91
|
+
subagents: 'unknown',
|
|
92
|
+
ci: 'unknown',
|
|
93
|
+
},
|
|
94
|
+
lastEvidence: '.gse/evidence/index.jsonl',
|
|
95
|
+
residualRisks: ['Fixture risk.'],
|
|
96
|
+
},
|
|
97
|
+
null,
|
|
98
|
+
2,
|
|
99
|
+
) + '\n',
|
|
100
|
+
'utf8',
|
|
101
|
+
)
|
|
102
|
+
fs.writeFileSync(
|
|
103
|
+
path.join(dir, '.gse', 'evidence', 'index.jsonl'),
|
|
104
|
+
JSON.stringify({
|
|
105
|
+
date: '2026-07-06',
|
|
106
|
+
recordType: 'slice',
|
|
107
|
+
status: 'result',
|
|
108
|
+
summary: 'Fixture initialized.',
|
|
109
|
+
evidenceFile: '.gse/evidence/2026-07-06.md',
|
|
110
|
+
commands: ['fixture'],
|
|
111
|
+
nextAction: 'Run focused fixture smoke.',
|
|
112
|
+
}) + '\n',
|
|
113
|
+
'utf8',
|
|
114
|
+
)
|
|
115
|
+
return dir
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
function generatePrompt(target) {
|
|
119
|
+
const resolvedTarget = path.resolve(target)
|
|
120
|
+
const stateResult = readJson(path.join(resolvedTarget, '.gse', 'state.json'))
|
|
121
|
+
const state = stateResult.ok ? stateResult.data : null
|
|
122
|
+
const goalMap = readText(path.join(resolvedTarget, '.gse', 'goal-map.md'))
|
|
123
|
+
const profile = readText(path.join(resolvedTarget, '.gse', 'project-profile.md'))
|
|
124
|
+
const canonicalPlan = findCanonicalPlan(resolvedTarget, state)
|
|
125
|
+
const warnings = []
|
|
126
|
+
if (!exists(resolvedTarget, '.gse')) warnings.push('missing .gse directory')
|
|
127
|
+
if (!stateResult.exists) warnings.push('missing .gse/state.json')
|
|
128
|
+
else if (!stateResult.ok) warnings.push('invalid .gse/state.json: ' + stateResult.error)
|
|
129
|
+
if (!exists(resolvedTarget, '.gse/evidence/index.jsonl')) warnings.push('missing .gse/evidence/index.jsonl')
|
|
130
|
+
if (!exists(resolvedTarget, '.gse/project-profile.md')) warnings.push('missing .gse/project-profile.md')
|
|
131
|
+
if (!exists(resolvedTarget, '.gse/goal-map.md')) warnings.push('missing .gse/goal-map.md')
|
|
132
|
+
if (canonicalPlan && !exists(resolvedTarget, canonicalPlan)) warnings.push('canonical plan missing: ' + canonicalPlan)
|
|
133
|
+
|
|
134
|
+
const projectName = cleanInlineValue(
|
|
135
|
+
state?.projectName ||
|
|
136
|
+
firstMatch(profile, /Product\/system name:\s*([^\n]+)/i) ||
|
|
137
|
+
path.basename(resolvedTarget),
|
|
138
|
+
)
|
|
139
|
+
const activeSlice =
|
|
140
|
+
state?.currentSlice?.outcome ||
|
|
141
|
+
firstMatch(goalMap, /Active slice:\s*([^\n]+)/i) ||
|
|
142
|
+
'Read the goal map and choose the next verifiable slice.'
|
|
143
|
+
const nextAction =
|
|
144
|
+
state?.currentSlice?.nextAction ||
|
|
145
|
+
firstMatch(goalMap, /Next action:\s*([^\n]+)/i) ||
|
|
146
|
+
'Continue with the smallest verifiable GSE slice.'
|
|
147
|
+
const phase = state?.phase || 'unknown'
|
|
148
|
+
const status = state?.currentSlice?.status || 'unknown'
|
|
149
|
+
const residualRisks = Array.isArray(state?.residualRisks) ? state.residualRisks.slice(0, 3) : []
|
|
150
|
+
|
|
151
|
+
const lines = [
|
|
152
|
+
`Use GSE to continue ${projectName}.`,
|
|
153
|
+
'',
|
|
154
|
+
`Project root: ${resolvedTarget}`,
|
|
155
|
+
'Read in order: project rules, .gse/README.md, .gse/state.json, .gse/project-profile.md, .gse/goal-map.md, .gse/quality-gates.md' + (canonicalPlan ? `, ${canonicalPlan}` : '') + '.',
|
|
156
|
+
`Current phase/status: ${phase} / ${status}.`,
|
|
157
|
+
`Current slice: ${activeSlice}`,
|
|
158
|
+
`Next action: ${nextAction}`,
|
|
159
|
+
]
|
|
160
|
+
if (residualRisks.length) lines.push(`Known risks: ${residualRisks.join('; ')}`)
|
|
161
|
+
if (warnings.length) lines.push(`GSE doctor warnings to handle first: ${warnings.join('; ')}`)
|
|
162
|
+
lines.push('Execute one verifiable slice, record evidence, update state/index/docs, and do not claim completion without the close gate.')
|
|
163
|
+
|
|
164
|
+
return {
|
|
165
|
+
target: resolvedTarget,
|
|
166
|
+
generatedAt: new Date().toISOString(),
|
|
167
|
+
summary: {
|
|
168
|
+
status: warnings.length ? 'warning' : 'passed',
|
|
169
|
+
warnings: warnings.length,
|
|
170
|
+
promptLines: lines.length,
|
|
171
|
+
},
|
|
172
|
+
state: {
|
|
173
|
+
exists: stateResult.exists,
|
|
174
|
+
valid: stateResult.ok,
|
|
175
|
+
phase,
|
|
176
|
+
currentSliceStatus: status,
|
|
177
|
+
},
|
|
178
|
+
canonicalPlan,
|
|
179
|
+
warnings,
|
|
180
|
+
prompt: lines.join('\n'),
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
const target = selfTest ? createFixture() : targetArg
|
|
185
|
+
const report = generatePrompt(target)
|
|
186
|
+
|
|
187
|
+
if (jsonOnly) console.log(JSON.stringify(report, null, 2))
|
|
188
|
+
else console.log(report.prompt + '\n')
|
package/scripts/gse.mjs
CHANGED
|
@@ -1,67 +1,67 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
import path from 'node:path'
|
|
3
|
-
import { spawnSync } from 'node:child_process'
|
|
4
|
-
|
|
5
|
-
const args = process.argv.slice(2)
|
|
6
|
-
const root = path.resolve(path.join(import.meta.dirname, '..'))
|
|
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
|
-
function hasValueArg(name) {
|
|
15
|
-
const index = args.indexOf(name)
|
|
16
|
-
return index !== -1 && args[index + 1] && !args[index + 1].startsWith('--')
|
|
17
|
-
}
|
|
18
|
-
|
|
19
|
-
function stripRunnerArgs(values) {
|
|
20
|
-
const stripped = []
|
|
21
|
-
for (let index = 0; index < values.length; index += 1) {
|
|
22
|
-
const item = values[index]
|
|
23
|
-
if (item === '--root' || item === '--target' || item === '--command') {
|
|
24
|
-
index += 1
|
|
25
|
-
continue
|
|
26
|
-
}
|
|
27
|
-
stripped.push(item)
|
|
28
|
-
}
|
|
29
|
-
return stripped
|
|
30
|
-
}
|
|
31
|
-
|
|
32
|
-
function commandFromArgs(values) {
|
|
33
|
-
const explicit = readArg('--command')
|
|
34
|
-
if (explicit) return explicit
|
|
35
|
-
|
|
36
|
-
const commandParts = stripRunnerArgs(values)
|
|
37
|
-
.filter((item) => item !== '--json' && item !== '--execute')
|
|
38
|
-
|
|
39
|
-
if (commandParts.length === 0 || commandParts[0] === 'help' || commandParts[0] === '--help' || commandParts[0] === '-h') {
|
|
40
|
-
return '/gse help'
|
|
41
|
-
}
|
|
42
|
-
|
|
43
|
-
const first = commandParts[0]
|
|
44
|
-
if (first === '/gse') return commandParts.join(' ')
|
|
45
|
-
if (first.startsWith('/gse ')) return first
|
|
46
|
-
if (first.toLowerCase() === 'gse') return '/' + commandParts.join(' ')
|
|
47
|
-
return '/gse ' + commandParts.join(' ')
|
|
48
|
-
}
|
|
49
|
-
|
|
50
|
-
const target = path.resolve(readArg('--target', process.cwd()))
|
|
51
|
-
const runnerArgs = [
|
|
52
|
-
path.join(root, 'scripts', 'run-gse-command.mjs'),
|
|
53
|
-
'--root', hasValueArg('--root') ? path.resolve(readArg('--root')) : root,
|
|
54
|
-
'--target', target,
|
|
55
|
-
'--command', commandFromArgs(args),
|
|
56
|
-
]
|
|
57
|
-
|
|
58
|
-
if (args.includes('--json')) runnerArgs.push('--json')
|
|
59
|
-
if (args.includes('--execute')) runnerArgs.push('--execute')
|
|
60
|
-
|
|
61
|
-
const result = spawnSync(process.execPath, runnerArgs, {
|
|
62
|
-
cwd: root,
|
|
63
|
-
stdio: 'inherit',
|
|
64
|
-
windowsHide: true,
|
|
65
|
-
})
|
|
66
|
-
|
|
67
|
-
process.exit(result.status ?? 1)
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import path from 'node:path'
|
|
3
|
+
import { spawnSync } from 'node:child_process'
|
|
4
|
+
|
|
5
|
+
const args = process.argv.slice(2)
|
|
6
|
+
const root = path.resolve(path.join(import.meta.dirname, '..'))
|
|
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
|
+
function hasValueArg(name) {
|
|
15
|
+
const index = args.indexOf(name)
|
|
16
|
+
return index !== -1 && args[index + 1] && !args[index + 1].startsWith('--')
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
function stripRunnerArgs(values) {
|
|
20
|
+
const stripped = []
|
|
21
|
+
for (let index = 0; index < values.length; index += 1) {
|
|
22
|
+
const item = values[index]
|
|
23
|
+
if (item === '--root' || item === '--target' || item === '--command') {
|
|
24
|
+
index += 1
|
|
25
|
+
continue
|
|
26
|
+
}
|
|
27
|
+
stripped.push(item)
|
|
28
|
+
}
|
|
29
|
+
return stripped
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
function commandFromArgs(values) {
|
|
33
|
+
const explicit = readArg('--command')
|
|
34
|
+
if (explicit) return explicit
|
|
35
|
+
|
|
36
|
+
const commandParts = stripRunnerArgs(values)
|
|
37
|
+
.filter((item) => item !== '--json' && item !== '--execute')
|
|
38
|
+
|
|
39
|
+
if (commandParts.length === 0 || commandParts[0] === 'help' || commandParts[0] === '--help' || commandParts[0] === '-h') {
|
|
40
|
+
return '/gse help'
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
const first = commandParts[0]
|
|
44
|
+
if (first === '/gse') return commandParts.join(' ')
|
|
45
|
+
if (first.startsWith('/gse ')) return first
|
|
46
|
+
if (first.toLowerCase() === 'gse') return '/' + commandParts.join(' ')
|
|
47
|
+
return '/gse ' + commandParts.join(' ')
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
const target = path.resolve(readArg('--target', process.cwd()))
|
|
51
|
+
const runnerArgs = [
|
|
52
|
+
path.join(root, 'scripts', 'run-gse-command.mjs'),
|
|
53
|
+
'--root', hasValueArg('--root') ? path.resolve(readArg('--root')) : root,
|
|
54
|
+
'--target', target,
|
|
55
|
+
'--command', commandFromArgs(args),
|
|
56
|
+
]
|
|
57
|
+
|
|
58
|
+
if (args.includes('--json')) runnerArgs.push('--json')
|
|
59
|
+
if (args.includes('--execute')) runnerArgs.push('--execute')
|
|
60
|
+
|
|
61
|
+
const result = spawnSync(process.execPath, runnerArgs, {
|
|
62
|
+
cwd: root,
|
|
63
|
+
stdio: 'inherit',
|
|
64
|
+
windowsHide: true,
|
|
65
|
+
})
|
|
66
|
+
|
|
67
|
+
process.exit(result.status ?? 1)
|