@t275005746/gse 0.1.0 → 0.1.2

package/scripts/init-change.mjs

@@ -1,265 +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}`)
-}
+#!/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}`)
+}