@t275005746/gse 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (228) 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 +147 -27
  14. package/CHANGELOG.md +31 -15
  15. package/CONTRIBUTING.md +64 -64
  16. package/LICENSE +21 -21
  17. package/README.md +14 -7
  18. package/README.zh-CN.md +14 -7
  19. package/SECURITY.md +41 -41
  20. package/SKILL.md +32 -12
  21. package/SUPPORT.md +38 -38
  22. package/assets/marketplace/README.md +7 -7
  23. package/assets/marketplace/gse-listing.json +75 -75
  24. package/assets/templates/acceptance-execution-packet.md +73 -73
  25. package/assets/templates/adr.md +14 -14
  26. package/assets/templates/change-brief.md +16 -16
  27. package/assets/templates/design.md +18 -18
  28. package/assets/templates/dispatch-packet.md +100 -92
  29. package/assets/templates/evidence.md +15 -9
  30. package/assets/templates/execution-quality-pack.md +65 -65
  31. package/assets/templates/goal-map.md +21 -21
  32. package/assets/templates/host-adapter.md +48 -48
  33. package/assets/templates/host-ui-invocation-record.md +42 -42
  34. package/assets/templates/incident-review.md +60 -60
  35. package/assets/templates/public-channel-publication-record.md +49 -49
  36. package/assets/templates/public-ci-run-record.md +53 -53
  37. package/assets/templates/public-release-record.md +65 -65
  38. package/assets/templates/public-repository-settings-record.md +59 -59
  39. package/assets/templates/public-security-contact-record.md +45 -45
  40. package/assets/templates/release-trust-record.md +32 -32
  41. package/assets/templates/review.md +18 -18
  42. package/assets/templates/role-fallback-packet.md +49 -0
  43. package/assets/templates/spec.md +16 -16
  44. package/assets/templates/target-adoption-evidence.md +29 -29
  45. package/assets/templates/tasks.md +17 -17
  46. package/assets/templates/update-release-acceptance-record.md +58 -58
  47. package/examples/README.md +22 -22
  48. package/examples/agent-runtime-host/.claude/gse-adapter.md +6 -6
  49. package/examples/agent-runtime-host/.codex/gse-adapter.md +7 -7
  50. package/examples/agent-runtime-host/.gse/goal-map.md +7 -7
  51. package/examples/agent-runtime-host/.gse/project-profile.md +27 -27
  52. package/examples/agent-runtime-host/.gse/tooling.md +5 -5
  53. package/examples/agent-runtime-host/.mcp.json +9 -9
  54. package/examples/agent-runtime-host/AGENTS.md +5 -5
  55. package/examples/agent-runtime-host/README.md +10 -10
  56. package/examples/agent-runtime-host/docs/model-routing.md +5 -5
  57. package/examples/cli-tool/.gse/project-profile.md +21 -21
  58. package/examples/cli-tool/AGENTS.md +5 -5
  59. package/examples/cli-tool/README.md +12 -12
  60. package/examples/cli-tool/package.json +21 -21
  61. package/examples/small-app/.env.example +2 -2
  62. package/examples/small-app/.github/workflows/ci.yml +8 -8
  63. package/examples/small-app/AGENTS.md +5 -5
  64. package/examples/small-app/README.md +12 -12
  65. package/examples/small-app/package.json +26 -26
  66. package/examples/small-app/playwright.config.ts +4 -4
  67. package/package.json +52 -44
  68. package/references/adoption-recipes.md +171 -171
  69. package/references/agent-roles.md +42 -21
  70. package/references/architecture-health.md +101 -101
  71. package/references/benchmark-audit.md +73 -73
  72. package/references/commands.md +74 -45
  73. package/references/community-channels.md +46 -46
  74. package/references/compatibility.md +70 -70
  75. package/references/design-basis.md +38 -38
  76. package/references/domain-model.md +129 -129
  77. package/references/domain-quality-gates.md +75 -75
  78. package/references/drift-audit.md +81 -80
  79. package/references/evidence-taxonomy.md +145 -108
  80. package/references/file-ownership.md +97 -93
  81. package/references/final-form-roadmap.md +201 -0
  82. package/references/final-readiness.md +84 -84
  83. package/references/forward-test.md +133 -133
  84. package/references/goal-map.md +36 -36
  85. package/references/host-adapters.md +129 -101
  86. package/references/learning-system.md +42 -26
  87. package/references/maintenance-cadence.md +51 -0
  88. package/references/marketplace-discovery.md +46 -46
  89. package/references/model-routing.md +103 -103
  90. package/references/open-source-defaults.md +39 -39
  91. package/references/operating-model.md +52 -52
  92. package/references/packaging.md +277 -277
  93. package/references/project-agent-workspace.md +89 -89
  94. package/references/project-bootstrap.md +122 -122
  95. package/references/project-guards.md +52 -0
  96. package/references/project-profile.md +57 -57
  97. package/references/public-release.md +174 -174
  98. package/references/quality-gates.md +96 -89
  99. package/references/recovery.md +176 -176
  100. package/references/release-trust.md +43 -43
  101. package/references/release.md +126 -126
  102. package/references/review.md +141 -141
  103. package/references/role-dispatch-fallback.md +54 -0
  104. package/references/router.md +90 -90
  105. package/references/spec-workflow.md +66 -66
  106. package/references/task-levels.md +81 -81
  107. package/references/tool-adapters.md +80 -70
  108. package/scripts/audit-acceptance-execution-packet.mjs +133 -133
  109. package/scripts/audit-adoption-recipes.mjs +99 -99
  110. package/scripts/audit-change-lifecycle.mjs +77 -77
  111. package/scripts/audit-change-system.mjs +134 -134
  112. package/scripts/audit-ci-readiness.mjs +107 -107
  113. package/scripts/audit-close-gate-hardening.mjs +188 -0
  114. package/scripts/audit-close-gate.mjs +448 -262
  115. package/scripts/audit-command-adapters.mjs +91 -91
  116. package/scripts/audit-command-execution.mjs +212 -199
  117. package/scripts/audit-commands.mjs +7 -5
  118. package/scripts/audit-compatibility.mjs +149 -149
  119. package/scripts/audit-completion-plan-drill.mjs +230 -0
  120. package/scripts/audit-completion-readiness.mjs +290 -287
  121. package/scripts/audit-continue-preflight.mjs +234 -0
  122. package/scripts/audit-distribution.mjs +251 -251
  123. package/scripts/audit-domain-quality-gates.mjs +108 -108
  124. package/scripts/audit-evidence-levels.mjs +217 -0
  125. package/scripts/audit-evidence-placeholders.mjs +126 -126
  126. package/scripts/audit-evidence-review-queue.mjs +206 -0
  127. package/scripts/audit-final-acceptance-packet.mjs +9 -9
  128. package/scripts/audit-final-form-progress-report.mjs +19 -18
  129. package/scripts/audit-final-form-roadmap.mjs +157 -0
  130. package/scripts/audit-final-form-stale-copy.mjs +2 -2
  131. package/scripts/audit-final-readiness-promotion.mjs +255 -255
  132. package/scripts/audit-final-readiness.mjs +226 -226
  133. package/scripts/audit-fixtures.mjs +154 -154
  134. package/scripts/audit-fresh-session-readiness.mjs +177 -177
  135. package/scripts/audit-host-capabilities.mjs +237 -0
  136. package/scripts/audit-host-runtime-evidence-handoff.mjs +159 -159
  137. package/scripts/audit-host-runtime-invocation-drill.mjs +240 -240
  138. package/scripts/audit-host-runtime-invocations.mjs +254 -254
  139. package/scripts/audit-host-ui-invocation.mjs +132 -132
  140. package/scripts/audit-installed-sync.mjs +203 -0
  141. package/scripts/audit-learning-drift.mjs +292 -0
  142. package/scripts/audit-learning-promotion.mjs +351 -0
  143. package/scripts/audit-learning-system.mjs +24 -14
  144. package/scripts/audit-local-final-form-completion.mjs +11 -10
  145. package/scripts/audit-maintenance-cadence.mjs +139 -0
  146. package/scripts/audit-maintenance-snapshot.mjs +181 -0
  147. package/scripts/audit-marketplace-discovery.mjs +122 -122
  148. package/scripts/audit-npm-package-metadata.mjs +160 -154
  149. package/scripts/audit-npm-publish-dry-run.mjs +194 -166
  150. package/scripts/audit-npm-tarball-install.mjs +195 -189
  151. package/scripts/audit-open-source-defaults.mjs +92 -92
  152. package/scripts/audit-open-source-readiness.mjs +97 -97
  153. package/scripts/audit-owner-external-gate-kit.mjs +12 -11
  154. package/scripts/audit-project-guards.mjs +189 -0
  155. package/scripts/audit-project.mjs +144 -141
  156. package/scripts/audit-public-acceptance-command-dry-run-drill.mjs +203 -203
  157. package/scripts/audit-public-acceptance-handoff.mjs +10 -10
  158. package/scripts/audit-public-acceptance-readiness.mjs +222 -222
  159. package/scripts/audit-public-channel-publication.mjs +248 -248
  160. package/scripts/audit-public-ci-run.mjs +184 -184
  161. package/scripts/audit-public-collaboration-templates.mjs +98 -98
  162. package/scripts/audit-public-external-gate-probe.mjs +206 -206
  163. package/scripts/audit-public-release-checklist.mjs +17 -15
  164. package/scripts/audit-public-release-decision.mjs +201 -201
  165. package/scripts/audit-public-release-metadata.mjs +176 -176
  166. package/scripts/audit-public-repository-settings.mjs +237 -237
  167. package/scripts/audit-public-security-contact.mjs +171 -171
  168. package/scripts/audit-readme-docs.mjs +6 -4
  169. package/scripts/audit-recovery-readiness.mjs +98 -98
  170. package/scripts/audit-release-bundle.mjs +13 -11
  171. package/scripts/audit-release-owner-action-plan-drill.mjs +5 -4
  172. package/scripts/audit-release-owner-action-plan.mjs +10 -10
  173. package/scripts/audit-release-readiness.mjs +106 -106
  174. package/scripts/audit-release-status-manifest.mjs +4 -4
  175. package/scripts/audit-release-trust.mjs +62 -62
  176. package/scripts/audit-remote-distribution.mjs +266 -266
  177. package/scripts/audit-roadmap-consistency.mjs +234 -230
  178. package/scripts/audit-role-dispatch-fallback.mjs +212 -0
  179. package/scripts/audit-session-sync.mjs +127 -0
  180. package/scripts/audit-signing.mjs +147 -147
  181. package/scripts/audit-state-freshness.mjs +20 -14
  182. package/scripts/audit-state-repair.mjs +360 -0
  183. package/scripts/audit-target-adoption-evidence.mjs +117 -117
  184. package/scripts/audit-target-hardening-drills.mjs +267 -0
  185. package/scripts/audit-target-project.mjs +507 -507
  186. package/scripts/audit-tool-fallback-policy.mjs +180 -0
  187. package/scripts/audit-ui-browser-evidence-policy.mjs +191 -0
  188. package/scripts/audit-update-release-acceptance.mjs +136 -136
  189. package/scripts/audit-v1-target-validation.mjs +269 -269
  190. package/scripts/audit-validation-profiles.mjs +125 -123
  191. package/scripts/backfill-evidence-levels.mjs +98 -0
  192. package/scripts/check-encoding.mjs +72 -0
  193. package/scripts/close-change.mjs +116 -116
  194. package/scripts/discover-project-profile.mjs +307 -307
  195. package/scripts/generate-command-adapter.mjs +231 -231
  196. package/scripts/generate-continue-packet.mjs +1214 -0
  197. package/scripts/generate-final-acceptance-packet.mjs +188 -173
  198. package/scripts/generate-final-form-progress-report.mjs +191 -189
  199. package/scripts/generate-host-runtime-evidence-handoff.mjs +198 -191
  200. package/scripts/generate-maintenance-snapshot.mjs +216 -0
  201. package/scripts/generate-owner-external-gate-kit.mjs +295 -295
  202. package/scripts/generate-public-acceptance-handoff.mjs +168 -156
  203. package/scripts/generate-public-release-checklist.mjs +207 -207
  204. package/scripts/generate-release-bundle.mjs +505 -505
  205. package/scripts/generate-release-owner-action-plan.mjs +172 -171
  206. package/scripts/generate-release-status-manifest.mjs +199 -198
  207. package/scripts/generate-session-prompt.mjs +188 -188
  208. package/scripts/gse.mjs +67 -67
  209. package/scripts/init-change.mjs +265 -265
  210. package/scripts/init-project.mjs +793 -712
  211. package/scripts/install-gse.mjs +234 -234
  212. package/scripts/lib/evidence-placeholders.mjs +28 -28
  213. package/scripts/package-gse.mjs +174 -174
  214. package/scripts/probe-public-external-gates.mjs +167 -167
  215. package/scripts/record-host-invocation.mjs +151 -151
  216. package/scripts/record-learning.mjs +37 -8
  217. package/scripts/record-public-channel-publication.mjs +178 -178
  218. package/scripts/record-public-ci-run.mjs +180 -180
  219. package/scripts/record-public-release.mjs +175 -175
  220. package/scripts/record-public-repository-settings.mjs +209 -209
  221. package/scripts/record-public-security-contact.mjs +157 -157
  222. package/scripts/record-session-sync.mjs +87 -0
  223. package/scripts/run-gse-command.mjs +79 -47
  224. package/scripts/run-validation-profile.mjs +24 -5
  225. package/scripts/sign-gse-package.mjs +83 -83
  226. package/scripts/update-project-state.mjs +223 -223
  227. package/scripts/validate-gse.mjs +216 -0
  228. 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)