@t275005746/gse 0.1.0

package/scripts/init-change.mjs

@@ -0,0 +1,265 @@
+#!/usr/bin/env node
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+
+const args = process.argv.slice(2)
+
+function readArg(name, fallback = null) {
+  const index = args.indexOf(name)
+  if (index === -1) return fallback
+  return args[index + 1] ?? fallback
+}
+
+const jsonOnly = args.includes('--json')
+const selfTest = args.includes('--self-test') || !args.includes('--target')
+const targetArg = readArg('--target')
+const force = args.includes('--force')
+const changeIdArg = readArg('--change-id', 'sample-change')
+const level = readArg('--level', 'standard')
+const validLevels = new Set(['lite', 'standard', 'enterprise'])
+
+if (!validLevels.has(level)) {
+  console.error(`Invalid --level "${level}". Expected lite, standard, or enterprise.`)
+  process.exit(1)
+}
+
+function slug(value) {
+  return String(value || '')
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9._-]+/g, '-')
+    .replace(/^-+|-+$/g, '') || 'change'
+}
+
+function writeIfMissing(filePath, content) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true })
+  if (!force && fs.existsSync(filePath)) return 'skipped'
+  fs.writeFileSync(filePath, content.trimStart().replace(/\n/g, '\r\n'), 'utf8')
+  return fs.existsSync(filePath) ? (force ? 'written-or-overwritten' : 'written') : 'failed'
+}
+
+function createFixture() {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'gse-init-change-'))
+  fs.mkdirSync(path.join(dir, '.gse'), { recursive: true })
+  fs.writeFileSync(path.join(dir, '.gse', 'goal-map.md'), '# Goal Map\n', 'utf8')
+  fs.writeFileSync(path.join(dir, '.gse', 'quality-gates.md'), '# Quality Gates\n', 'utf8')
+  return dir
+}
+
+function renderBrief(changeId) {
+  return `# Change Brief
+
+Change ID: ${changeId}
+
+## Outcome
+
+## Scope
+
+## Non-goals
+
+## Acceptance
+
+## Evidence Plan
+
+## Risks
+
+## Next Action
+`
+}
+
+function renderSpec(changeId) {
+  return `# Spec
+
+Change ID: ${changeId}
+
+## User Outcome
+
+## Behavior
+
+## State / Data Flow
+
+## Error and Recovery
+
+## Permissions and Privacy
+
+## Acceptance Criteria
+
+## Non-goals
+`
+}
+
+function renderDesign(changeId) {
+  return `# Design
+
+Change ID: ${changeId}
+
+## Approach
+
+## State / Data Flow
+
+## Interfaces And Contracts
+
+## Permissions And Privacy
+
+## Error And Recovery
+
+## Alternatives Considered
+
+## Rollback
+
+## Open Questions
+`
+}
+
+function renderTasks(changeId) {
+  return `# Tasks
+
+Change ID: ${changeId}
+
+## Slice Plan
+
+- [ ] Define outcome, scope, acceptance, evidence, risk, and next action.
+- [ ] Locate existing patterns and ownership boundaries.
+- [ ] Implement the smallest verifiable change.
+- [ ] Run focused verification.
+- [ ] Record evidence and residual risk.
+- [ ] Update state, goal map, and handoff notes when relevant.
+
+## Non-Goals
+
+## Dependencies
+
+## Stop Conditions
+`
+}
+
+function renderEvidence(changeId) {
+  return `# Evidence
+
+Change ID: ${changeId}
+
+## Commands
+
+## Results
+
+## Files Changed
+
+## Evidence Status
+
+result | verified | accepted | not ready
+
+## Residual Risk
+
+## Follow-up
+`
+}
+
+function renderReview(changeId) {
+  return `# Review
+
+Change ID: ${changeId}
+
+## Spec Compliance
+
+## Code Quality
+
+## Architecture / Ownership
+
+## Security / Privacy
+
+## Regression Risk
+
+## Evidence Review
+
+## Findings
+
+## Closure
+`
+}
+
+function renderExecutionPack(changeId) {
+  return `# Execution Quality Pack
+
+Change ID: ${changeId}
+
+## Task Profile
+
+- Level: ${level}
+- Change type:
+- User-visible impact:
+- Data/security/release impact:
+
+## Required Skills Or Roles
+
+| Role / Skill | Purpose | Required | Evidence |
+|---|---|---|---|
+| Coordinator | Scope, final judgment, integration | yes | plan/state/evidence |
+| Code Locator | Files, symbols, existing tests | when code changes | search/LSP notes |
+| Builder | Bounded implementation | when files change | diff + focused check |
+| QA / Verification | Focused proof | yes | command/browser/API smoke |
+| Reviewer | Spec, quality, architecture, security | risk-based | review notes |
+
+## Tool Routing
+
+| Tool | Use When | Status | Fallback |
+|---|---|---|---|
+| rg / rg --files | Code and doc location | recommended | shell listing |
+| LSP / index | Large or typed codebase | unknown | rg + existing tests |
+| Browser / Playwright | UI or user-visible flow | unknown | component/API smoke plus notes |
+| OpenSpec | Capability/API/state contract change | optional | .gse/changes/ markdown |
+| Comet | Full lifecycle change | optional | GSE phase/status files |
+| Superpowers | Complex staged execution/review | optional | GSE roles + quality gates |
+| Subagents | Parallel bounded work | unknown | sequential role execution |
+
+## Quality Gates Selected
+
+## Evidence Plan
+
+## Review And Closure
+`
+}
+
+function initChange(target) {
+  const resolvedTarget = path.resolve(target)
+  const changeId = slug(changeIdArg)
+  const changeDir = path.join(resolvedTarget, '.gse', 'changes', changeId)
+  const files = [
+    ['brief.md', renderBrief(changeId)],
+    ['spec.md', renderSpec(changeId)],
+    ['design.md', renderDesign(changeId)],
+    ['tasks.md', renderTasks(changeId)],
+    ['evidence.md', renderEvidence(changeId)],
+    ['review.md', renderReview(changeId)],
+    ['execution-quality-pack.md', renderExecutionPack(changeId)],
+  ]
+  const results = files.map(([name, content]) => ({
+    relativePath: path.join('.gse', 'changes', changeId, name).replace(/\\/g, '/'),
+    status: writeIfMissing(path.join(changeDir, name), content),
+  }))
+  const written = results.filter((item) => item.status !== 'skipped').length
+  const skipped = results.filter((item) => item.status === 'skipped').length
+  return {
+    target: resolvedTarget,
+    generatedAt: new Date().toISOString(),
+    changeId,
+    level,
+    force,
+    summary: {
+      status: 'passed',
+      written,
+      skipped,
+      total: results.length,
+    },
+    results,
+  }
+}
+
+const target = selfTest ? createFixture() : targetArg
+const report = initChange(target)
+
+if (jsonOnly) console.log(JSON.stringify(report, null, 2))
+else {
+  console.log(`# GSE Change Init\n\nTarget: ${report.target}\nChange: ${report.changeId}\nLevel: ${report.level}`)
+  for (const item of report.results) console.log(`- ${item.relativePath}: ${item.status}`)
+}