@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.
Files changed (180) hide show
  1. package/.github/ISSUE_TEMPLATE/bug_report.yml +42 -42
  2. package/.github/ISSUE_TEMPLATE/change_request.yml +50 -50
  3. package/.github/ISSUE_TEMPLATE/config.yml +5 -5
  4. package/.github/PULL_REQUEST_TEMPLATE.md +38 -38
  5. package/.github/workflows/validate-gse.yml +33 -33
  6. package/.gse/README.md +18 -18
  7. package/.gse/gse-development-protocol.md +50 -50
  8. package/.gse/project-profile.md +29 -29
  9. package/.gse/quality-gates.md +25 -25
  10. package/.gse/releases/public-registry-publication-npm.md +49 -0
  11. package/.gse/releases/public-release-owner-required.md +65 -65
  12. package/.gse/releases/public-security-contact-owner-required.md +45 -45
  13. package/.gse/state.json +3 -4
  14. package/CHANGELOG.md +24 -24
  15. package/CONTRIBUTING.md +64 -64
  16. package/LICENSE +21 -21
  17. package/README.md +1 -1
  18. package/README.zh-CN.md +1 -1
  19. package/SECURITY.md +41 -41
  20. package/SUPPORT.md +38 -38
  21. package/assets/marketplace/README.md +7 -7
  22. package/assets/marketplace/gse-listing.json +75 -75
  23. package/assets/templates/acceptance-execution-packet.md +73 -73
  24. package/assets/templates/adr.md +14 -14
  25. package/assets/templates/change-brief.md +16 -16
  26. package/assets/templates/design.md +18 -18
  27. package/assets/templates/dispatch-packet.md +104 -104
  28. package/assets/templates/evidence.md +14 -14
  29. package/assets/templates/execution-quality-pack.md +65 -65
  30. package/assets/templates/goal-map.md +21 -21
  31. package/assets/templates/host-adapter.md +48 -48
  32. package/assets/templates/host-ui-invocation-record.md +42 -42
  33. package/assets/templates/incident-review.md +60 -60
  34. package/assets/templates/public-channel-publication-record.md +49 -49
  35. package/assets/templates/public-ci-run-record.md +53 -53
  36. package/assets/templates/public-release-record.md +65 -65
  37. package/assets/templates/public-repository-settings-record.md +59 -59
  38. package/assets/templates/public-security-contact-record.md +45 -45
  39. package/assets/templates/release-trust-record.md +32 -32
  40. package/assets/templates/review.md +18 -18
  41. package/assets/templates/spec.md +16 -16
  42. package/assets/templates/target-adoption-evidence.md +29 -29
  43. package/assets/templates/tasks.md +17 -17
  44. package/assets/templates/update-release-acceptance-record.md +58 -58
  45. package/examples/README.md +22 -22
  46. package/examples/agent-runtime-host/.claude/gse-adapter.md +6 -6
  47. package/examples/agent-runtime-host/.codex/gse-adapter.md +7 -7
  48. package/examples/agent-runtime-host/.gse/goal-map.md +7 -7
  49. package/examples/agent-runtime-host/.gse/project-profile.md +27 -27
  50. package/examples/agent-runtime-host/.gse/tooling.md +5 -5
  51. package/examples/agent-runtime-host/.mcp.json +9 -9
  52. package/examples/agent-runtime-host/AGENTS.md +5 -5
  53. package/examples/agent-runtime-host/README.md +10 -10
  54. package/examples/agent-runtime-host/docs/model-routing.md +5 -5
  55. package/examples/cli-tool/.gse/project-profile.md +21 -21
  56. package/examples/cli-tool/AGENTS.md +5 -5
  57. package/examples/cli-tool/README.md +12 -12
  58. package/examples/cli-tool/package.json +21 -21
  59. package/examples/small-app/.env.example +2 -2
  60. package/examples/small-app/.github/workflows/ci.yml +8 -8
  61. package/examples/small-app/AGENTS.md +5 -5
  62. package/examples/small-app/README.md +12 -12
  63. package/examples/small-app/package.json +26 -26
  64. package/examples/small-app/playwright.config.ts +4 -4
  65. package/package.json +53 -53
  66. package/references/adoption-recipes.md +171 -171
  67. package/references/agent-roles.md +49 -49
  68. package/references/architecture-health.md +101 -101
  69. package/references/benchmark-audit.md +73 -73
  70. package/references/community-channels.md +46 -46
  71. package/references/compatibility.md +70 -70
  72. package/references/design-basis.md +38 -38
  73. package/references/domain-model.md +129 -129
  74. package/references/domain-quality-gates.md +75 -75
  75. package/references/drift-audit.md +81 -81
  76. package/references/evidence-taxonomy.md +123 -123
  77. package/references/file-ownership.md +107 -107
  78. package/references/final-readiness.md +84 -84
  79. package/references/forward-test.md +133 -133
  80. package/references/goal-map.md +36 -36
  81. package/references/host-adapters.md +119 -119
  82. package/references/learning-system.md +35 -35
  83. package/references/marketplace-discovery.md +46 -46
  84. package/references/model-routing.md +103 -103
  85. package/references/open-source-defaults.md +39 -39
  86. package/references/operating-model.md +52 -52
  87. package/references/packaging.md +277 -277
  88. package/references/project-agent-workspace.md +89 -89
  89. package/references/project-bootstrap.md +122 -122
  90. package/references/project-profile.md +57 -57
  91. package/references/public-release.md +174 -174
  92. package/references/quality-gates.md +100 -100
  93. package/references/recovery.md +176 -176
  94. package/references/release-trust.md +43 -43
  95. package/references/release.md +126 -126
  96. package/references/review.md +141 -141
  97. package/references/router.md +90 -90
  98. package/references/spec-workflow.md +66 -66
  99. package/references/task-levels.md +81 -81
  100. package/references/tool-adapters.md +73 -73
  101. package/scripts/audit-acceptance-execution-packet.mjs +133 -133
  102. package/scripts/audit-adoption-recipes.mjs +99 -99
  103. package/scripts/audit-change-lifecycle.mjs +77 -77
  104. package/scripts/audit-change-system.mjs +134 -134
  105. package/scripts/audit-ci-readiness.mjs +107 -107
  106. package/scripts/audit-close-gate.mjs +323 -323
  107. package/scripts/audit-command-adapters.mjs +91 -91
  108. package/scripts/audit-command-execution.mjs +210 -210
  109. package/scripts/audit-compatibility.mjs +149 -149
  110. package/scripts/audit-completion-readiness.mjs +292 -292
  111. package/scripts/audit-distribution.mjs +251 -251
  112. package/scripts/audit-domain-quality-gates.mjs +108 -108
  113. package/scripts/audit-evidence-placeholders.mjs +126 -126
  114. package/scripts/audit-final-readiness-promotion.mjs +255 -255
  115. package/scripts/audit-final-readiness.mjs +226 -226
  116. package/scripts/audit-fixtures.mjs +154 -154
  117. package/scripts/audit-fresh-session-readiness.mjs +177 -177
  118. package/scripts/audit-host-runtime-evidence-handoff.mjs +159 -159
  119. package/scripts/audit-host-runtime-invocation-drill.mjs +240 -240
  120. package/scripts/audit-host-runtime-invocations.mjs +254 -254
  121. package/scripts/audit-host-ui-invocation.mjs +132 -132
  122. package/scripts/audit-marketplace-discovery.mjs +122 -122
  123. package/scripts/audit-npm-package-metadata.mjs +155 -155
  124. package/scripts/audit-npm-publish-dry-run.mjs +191 -169
  125. package/scripts/audit-npm-tarball-install.mjs +191 -191
  126. package/scripts/audit-open-source-defaults.mjs +92 -92
  127. package/scripts/audit-open-source-readiness.mjs +97 -97
  128. package/scripts/audit-project.mjs +138 -138
  129. package/scripts/audit-public-acceptance-command-dry-run-drill.mjs +203 -203
  130. package/scripts/audit-public-acceptance-readiness.mjs +224 -224
  131. package/scripts/audit-public-channel-publication.mjs +248 -248
  132. package/scripts/audit-public-ci-run.mjs +184 -184
  133. package/scripts/audit-public-collaboration-templates.mjs +98 -98
  134. package/scripts/audit-public-external-gate-probe.mjs +206 -206
  135. package/scripts/audit-public-release-decision.mjs +201 -201
  136. package/scripts/audit-public-release-metadata.mjs +176 -176
  137. package/scripts/audit-public-repository-settings.mjs +237 -237
  138. package/scripts/audit-public-security-contact.mjs +171 -171
  139. package/scripts/audit-readme-docs.mjs +6 -4
  140. package/scripts/audit-recovery-readiness.mjs +98 -98
  141. package/scripts/audit-release-readiness.mjs +106 -106
  142. package/scripts/audit-release-trust.mjs +62 -62
  143. package/scripts/audit-remote-distribution.mjs +266 -266
  144. package/scripts/audit-roadmap-consistency.mjs +235 -235
  145. package/scripts/audit-signing.mjs +147 -147
  146. package/scripts/audit-state-freshness.mjs +14 -9
  147. package/scripts/audit-target-adoption-evidence.mjs +117 -117
  148. package/scripts/audit-target-project.mjs +507 -507
  149. package/scripts/audit-update-release-acceptance.mjs +136 -136
  150. package/scripts/audit-v1-target-validation.mjs +269 -269
  151. package/scripts/audit-validation-profiles.mjs +125 -125
  152. package/scripts/close-change.mjs +116 -116
  153. package/scripts/discover-project-profile.mjs +307 -307
  154. package/scripts/generate-command-adapter.mjs +231 -231
  155. package/scripts/generate-final-acceptance-packet.mjs +181 -181
  156. package/scripts/generate-final-form-progress-report.mjs +205 -205
  157. package/scripts/generate-host-runtime-evidence-handoff.mjs +206 -206
  158. package/scripts/generate-owner-external-gate-kit.mjs +295 -295
  159. package/scripts/generate-public-acceptance-handoff.mjs +168 -168
  160. package/scripts/generate-public-release-checklist.mjs +207 -207
  161. package/scripts/generate-release-bundle.mjs +505 -505
  162. package/scripts/generate-release-owner-action-plan.mjs +172 -172
  163. package/scripts/generate-release-status-manifest.mjs +200 -200
  164. package/scripts/generate-session-prompt.mjs +188 -188
  165. package/scripts/gse.mjs +67 -67
  166. package/scripts/init-change.mjs +265 -265
  167. package/scripts/init-project.mjs +785 -785
  168. package/scripts/install-gse.mjs +234 -234
  169. package/scripts/lib/evidence-placeholders.mjs +28 -28
  170. package/scripts/package-gse.mjs +174 -174
  171. package/scripts/probe-public-external-gates.mjs +167 -167
  172. package/scripts/record-host-invocation.mjs +151 -151
  173. package/scripts/record-public-channel-publication.mjs +178 -178
  174. package/scripts/record-public-ci-run.mjs +180 -180
  175. package/scripts/record-public-release.mjs +175 -175
  176. package/scripts/record-public-repository-settings.mjs +209 -209
  177. package/scripts/record-public-security-contact.mjs +157 -157
  178. package/scripts/sign-gse-package.mjs +83 -83
  179. package/scripts/update-project-state.mjs +223 -223
  180. 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)