@warnyin/sdlc 0.1.2 → 0.2.1

package/bin/multiselect.mjs

@@ -0,0 +1,147 @@
+// A searchable multi-select checkbox prompt in ~120 lines of node:readline.
+// The state machine is a pure reducer so the whole interaction is testable
+// without a TTY; only `multiSelect()` touches the terminal.
+// CLI-only: this must NOT move into lib/, which is copied verbatim into every
+// installed project as sdlc/.hooks/lib/.
+
+import readline from 'node:readline';
+import { ESC, SYMBOLS } from './ui.mjs';
+
+const MIN_ERROR = 'Select at least one tool — space toggles, enter confirms';
+
+const freeze = (state) => Object.freeze(state);
+
+export function initState(choices) {
+  return freeze({
+    choices,
+    selected: choices.filter((c) => c.preSelected).map((c) => c.value),
+    cursor: 0,
+    filter: '',
+    error: null,
+    status: 'idle',
+  });
+}
+
+export function visibleChoices(state) {
+  const query = state.filter.trim().toLowerCase();
+  if (!query) return state.choices;
+  return state.choices.filter(
+    (c) => c.name.toLowerCase().includes(query) || c.value.toLowerCase().includes(query),
+  );
+}
+
+// Every transition returns a new object — the caller compares by identity to
+// decide whether a repaint is needed.
+const next = (state, patch) => freeze({ ...state, ...patch, error: null });
+
+function toggle(selected, value) {
+  return selected.includes(value) ? selected.filter((v) => v !== value) : [...selected, value];
+}
+
+function isPrintable(key) {
+  return !key.ctrl && !key.meta && typeof key.sequence === 'string'
+    && key.sequence.length === 1 && key.sequence >= ' ' && key.sequence.charCodeAt(0) !== 127;
+}
+
+export function reduceKey(state, key = {}) {
+  if (state.status !== 'idle') return state;
+  const visible = visibleChoices(state);
+  const count = visible.length;
+
+  if (key.ctrl && key.name === 'c') return freeze({ ...state, status: 'cancelled' });
+
+  // ctrl+a acts on what is on screen, so it composes with the filter rather
+  // than silently selecting hidden rows.
+  if (key.ctrl && key.name === 'a') {
+    if (!count) return state;
+    const values = visible.map((c) => c.value);
+    const allOn = values.every((v) => state.selected.includes(v));
+    const selected = allOn
+      ? state.selected.filter((v) => !values.includes(v))
+      : [...state.selected, ...values.filter((v) => !state.selected.includes(v))];
+    return next(state, { selected });
+  }
+
+  switch (key.name) {
+    case 'up':
+      return count ? next(state, { cursor: (state.cursor - 1 + count) % count }) : state;
+    case 'down':
+      return count ? next(state, { cursor: (state.cursor + 1) % count }) : state;
+    case 'space':
+      return count ? next(state, { selected: toggle(state.selected, visible[state.cursor].value) }) : state;
+    case 'return':
+      if (!state.selected.length) return freeze({ ...state, error: MIN_ERROR });
+      return freeze({ ...state, status: 'done', error: null });
+    case 'backspace':
+      return state.filter ? next(state, { filter: state.filter.slice(0, -1), cursor: 0 }) : state;
+    case 'escape':
+      return state.filter ? next(state, { filter: '', cursor: 0 }) : state;
+    default:
+      break;
+  }
+
+  if (isPrintable(key)) return next(state, { filter: state.filter + key.sequence, cursor: 0 });
+  return state;
+}
+
+export function renderLines(state, style, symbols = SYMBOLS.unicode) {
+  const visible = visibleChoices(state);
+  const head = state.filter
+    ? `${style.cyan('?')} ${style.bold('Select tools to set up')} ${style.dim(`filter: ${state.filter}`)}`
+    : `${style.cyan('?')} ${style.bold('Select tools to set up')}`;
+
+  // Notes line up in their own column; a row without one keeps no trailing space.
+  const width = visible.reduce((w, c) => Math.max(w, c.name.length), 0);
+  const rows = visible.map((choice, i) => {
+    const focused = i === state.cursor;
+    const box = state.selected.includes(choice.value) ? style.green(symbols.on) : symbols.off;
+    const note = choice.note ? `${' '.repeat(width - choice.name.length + 2)}${style.dim(choice.note)}` : '';
+    const label = focused ? style.cyan(choice.name) : choice.name;
+    return `${focused ? style.cyan(symbols.pointer) : ' '} ${box} ${label}${note}`;
+  });
+  if (!rows.length) rows.push(`  ${style.dim('no tool matches this filter')}`);
+
+  const lines = [head, ...rows, style.dim('  space toggle · ctrl+a all · type to filter · enter confirm')];
+  if (state.error) lines.push(style.yellow(`  ${state.error}`));
+  return lines;
+}
+
+// Resolves to the selected values, or null when the user cancels.
+export function multiSelect({ choices, style, symbols, input = process.stdin, output = process.stdout }) {
+  return new Promise((resolve) => {
+    let state = initState(choices);
+    let height = 0;
+
+    const erase = () => { if (height) output.write(`${ESC}[${height}A${ESC}[0J`); };
+    const draw = () => {
+      const lines = renderLines(state, style, symbols);
+      erase();
+      output.write(`${lines.join('\n')}\n`);
+      height = lines.length;
+    };
+
+    const finish = (result) => {
+      input.off('keypress', onKey);
+      if (input.isTTY) input.setRawMode(false);
+      input.pause();
+      erase();
+      output.write(`${ESC}[?25h`);
+      resolve(result);
+    };
+
+    const onKey = (_str, key) => {
+      const updated = reduceKey(state, key ?? {});
+      if (updated === state) return;
+      state = updated;
+      if (state.status === 'idle') { draw(); return; }
+      finish(state.status === 'done' ? state.selected : null);
+    };
+
+    readline.emitKeypressEvents(input);
+    if (input.isTTY) input.setRawMode(true);
+    input.resume();
+    input.on('keypress', onKey);
+    output.write(`${ESC}[?25l`);
+    draw();
+  });
+}

package/bin/ui.mjs

@@ -0,0 +1,78 @@
+// Terminal presentation for the installer: colour gating, glyphs, and the
+// post-install summary. Zero dependencies — the ANSI we need is a dozen codes.
+// CLI-only: this must NOT move into lib/, which is copied verbatim into every
+// installed project as sdlc/.hooks/lib/.
+
+import { ADAPTER_PATHS, toolName } from './detect.mjs';
+
+export const ESC = String.fromCharCode(27);
+
+const CODES = Object.freeze({
+  bold: '1', dim: '2', red: '31', green: '32', yellow: '33', cyan: '36',
+});
+
+// NO_COLOR wins over FORCE_COLOR: opting out of colour is never overridden by
+// something else in the environment (no-color.org).
+export function colorEnabled(env = process.env, isTty = Boolean(process.stdout.isTTY)) {
+  if (env.NO_COLOR) return false;
+  if (env.FORCE_COLOR) return true;
+  return Boolean(isTty);
+}
+
+export function createStyle(enabled) {
+  const wrap = (code) => (text) => (enabled ? `${ESC}[${code}m${text}${ESC}[0m` : String(text));
+  return Object.freeze(Object.fromEntries(Object.entries(CODES).map(([name, code]) => [name, wrap(code)])));
+}
+
+export const SYMBOLS = Object.freeze({
+  unicode: Object.freeze({ on: '◉', off: '◯', pointer: '❯', tick: '✔', warn: '!' }),
+  ascii: Object.freeze({ on: '[x]', off: '[ ]', pointer: '>', tick: 'v', warn: '!' }),
+});
+
+// Legacy Windows consoles render box-drawing glyphs as mojibake; Windows
+// Terminal and every unix terminal set one of these.
+export function symbolsFor(env = process.env, platform = process.platform) {
+  if (platform !== 'win32') return SYMBOLS.unicode;
+  return env.WT_SESSION || env.TERM_PROGRAM || env.ConEmuANSI ? SYMBOLS.unicode : SYMBOLS.ascii;
+}
+
+// ---------- post-install summary ----------
+
+const under = (keys, prefix) => keys.filter((k) => k.startsWith(prefix));
+
+export function summarizeInstall(manifestKeys, tools) {
+  const keys = [...manifestKeys];
+  const hookFiles = under(keys, 'sdlc/.hooks/').filter((k) => !k.startsWith('sdlc/.hooks/lib/'));
+  const templates = under(keys, 'sdlc/.playbook/templates/');
+  const playbook = under(keys, 'sdlc/.playbook/').filter((k) => !k.startsWith('sdlc/.playbook/templates/'));
+  const skillDirs = new Set(under(keys, '.claude/skills/').map((k) => k.split('/')[2]));
+
+  return Object.freeze({
+    commands: under(keys, '.claude/commands/').length,
+    skills: skillDirs.size,
+    agents: under(keys, '.claude/agents/').length,
+    hooks: hookFiles.length,
+    playbook: playbook.length,
+    templates: templates.length,
+    adapters: tools.map((tool) => ({ tool, path: ADAPTER_PATHS[tool] })),
+  });
+}
+
+// What to actually type next, per tool. Tools without a slash-command surface
+// get a prose instruction instead of a command that would not resolve.
+export function startHints(tools) {
+  const hints = [];
+  if (tools.includes('claude')) {
+    hints.push('Run /sdlc:init in Claude Code — it writes your constitution and harness');
+    hints.push('Then start your first change: /sdlc:new "your idea"');
+  }
+  const rest = tools.filter((t) => t !== 'claude');
+  for (const tool of rest) {
+    hints.push(`Open ${toolName(tool)} and ask it to follow sdlc/.playbook/init.md, then sdlc/.playbook/new.md`);
+  }
+  if (!hints.length) {
+    hints.push('Read sdlc/.playbook/README.md — the stage doctrine is tool-independent');
+    hints.push('Add an agent tool any time: npx @warnyin/sdlc update --tool claude');
+  }
+  return hints;
+}

package/lib/caps.mjs

@@ -1,45 +1,45 @@
-// Canonical line-cap table — the single source of truth for artifact
-// residency budgets. Templates quote these numbers in HTML comments and
-// tests/caps-sync.test.mjs asserts both stay identical.
-//
-// Rationale (Day-1 economics): every resident line is paid for in every
-// turn. Caps make "learning = distilling" structural, not disciplinary.
-
-import { parseFrontmatter } from './frontmatter.mjs';
-
-export const CAPS = Object.freeze({
-  constitution: 30,     // sdlc/context/constitution.md — always loaded
-  steeringFile: 40,     // each sdlc/context/steering/*.md
-  alwaysBudget: 60,     // constitution + all `inclusion: always` steering, combined
-  harness: 60,          // sdlc/harness.md
-  spec: 150,            // sdlc/specs/<capability>/spec.md (soft — split capability beyond)
-  change: Object.freeze({ vibe: 40, standard: 100, deep: 150 }),
-  contractTests: 60,    // changes/<id>/contract/tests.md
-  contractEvals: 40,    // changes/<id>/contract/evals.md
-});
-
-export const TIERS = Object.freeze(['vibe', 'standard', 'deep']);
-
-export const STATUSES = Object.freeze([
-  'new', 'contracted', 'building', 'verified', 'shipped',
-]);
-
-// Effective lines = body lines after frontmatter, excluding blanks and
-// single-line HTML comments. Caps meter prose the model must carry, not
-// machine metadata or annotation comments.
-export function countEffectiveLines(text) {
-  const { body } = parseFrontmatter(text ?? '');
-  return body
-    .split(/\r?\n/)
-    .filter((line) => {
-      const t = line.trim();
-      if (t === '') return false;
-      if (t.startsWith('<!--') && t.endsWith('-->')) return false;
-      return true;
-    })
-    .length;
-}
-
-export function capForChange(tier) {
-  return CAPS.change[tier] ?? CAPS.change.standard;
-}
+// Canonical line-cap table — the single source of truth for artifact
+// residency budgets. Templates quote these numbers in HTML comments and
+// tests/caps-sync.test.mjs asserts both stay identical.
+//
+// Rationale (Day-1 economics): every resident line is paid for in every
+// turn. Caps make "learning = distilling" structural, not disciplinary.
+
+import { parseFrontmatter } from './frontmatter.mjs';
+
+export const CAPS = Object.freeze({
+  constitution: 30,     // sdlc/context/constitution.md — always loaded
+  steeringFile: 40,     // each sdlc/context/steering/*.md
+  alwaysBudget: 60,     // constitution + all `inclusion: always` steering, combined
+  harness: 60,          // sdlc/harness.md
+  spec: 150,            // sdlc/specs/<capability>/spec.md (soft — split capability beyond)
+  change: Object.freeze({ vibe: 40, standard: 100, deep: 150 }),
+  contractTests: 60,    // changes/<id>/contract/tests.md
+  contractEvals: 40,    // changes/<id>/contract/evals.md
+});
+
+export const TIERS = Object.freeze(['vibe', 'standard', 'deep']);
+
+export const STATUSES = Object.freeze([
+  'new', 'contracted', 'building', 'verified', 'shipped',
+]);
+
+// Effective lines = body lines after frontmatter, excluding blanks and
+// single-line HTML comments. Caps meter prose the model must carry, not
+// machine metadata or annotation comments.
+export function countEffectiveLines(text) {
+  const { body } = parseFrontmatter(text ?? '');
+  return body
+    .split(/\r?\n/)
+    .filter((line) => {
+      const t = line.trim();
+      if (t === '') return false;
+      if (t.startsWith('<!--') && t.endsWith('-->')) return false;
+      return true;
+    })
+    .length;
+}
+
+export function capForChange(tier) {
+  return CAPS.change[tier] ?? CAPS.change.standard;
+}

package/lib/config.mjs

@@ -1,41 +1,41 @@
-// Minimal reader for sdlc/config.yaml — supports exactly what the template
-// documents: scalar keys, inline arrays, and a `prices:` block of inline
-// objects. Anything else is ignored (never crash a hook on config).
-
-export function parseConfig(text) {
-  const config = { language: 'en', tools: [], prices: null };
-  const lines = (text ?? '').split(/\r?\n/);
-  let inPrices = false;
-  for (const raw of lines) {
-    if (!raw.trim() || raw.trim().startsWith('#')) continue;
-    const isIndented = /^\s/.test(raw);
-    if (!isIndented) inPrices = false;
-
-    if (inPrices) {
-      const m = raw.match(/^\s+([^:#]+):\s*\{(.*)\}\s*$/);
-      if (!m) continue;
-      const model = m[1].trim();
-      const obj = {};
-      for (const part of m[2].split(',')) {
-        const kv = part.split(':');
-        if (kv.length !== 2) continue;
-        const num = Number(kv[1].trim());
-        if (!Number.isNaN(num)) obj[kv[0].trim()] = num;
-      }
-      config.prices = { ...(config.prices ?? {}), [model]: obj };
-      continue;
-    }
-
-    const kv = raw.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
-    if (!kv) continue;
-    const [, key, valueRaw] = kv;
-    const value = valueRaw.replace(/\s+#.*$/, '').trim();
-    if (key === 'prices' && value === '') { inPrices = true; continue; }
-    if (value.startsWith('[') && value.endsWith(']')) {
-      config[key] = value.slice(1, -1).split(',').map((s) => s.trim()).filter(Boolean);
-    } else if (value !== '') {
-      config[key] = value;
-    }
-  }
-  return config;
-}
+// Minimal reader for sdlc/config.yaml — supports exactly what the template
+// documents: scalar keys, inline arrays, and a `prices:` block of inline
+// objects. Anything else is ignored (never crash a hook on config).
+
+export function parseConfig(text) {
+  const config = { language: 'en', tools: [], prices: null };
+  const lines = (text ?? '').split(/\r?\n/);
+  let inPrices = false;
+  for (const raw of lines) {
+    if (!raw.trim() || raw.trim().startsWith('#')) continue;
+    const isIndented = /^\s/.test(raw);
+    if (!isIndented) inPrices = false;
+
+    if (inPrices) {
+      const m = raw.match(/^\s+([^:#]+):\s*\{(.*)\}\s*$/);
+      if (!m) continue;
+      const model = m[1].trim();
+      const obj = {};
+      for (const part of m[2].split(',')) {
+        const kv = part.split(':');
+        if (kv.length !== 2) continue;
+        const num = Number(kv[1].trim());
+        if (!Number.isNaN(num)) obj[kv[0].trim()] = num;
+      }
+      config.prices = { ...(config.prices ?? {}), [model]: obj };
+      continue;
+    }
+
+    const kv = raw.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+    if (!kv) continue;
+    const [, key, valueRaw] = kv;
+    const value = valueRaw.replace(/\s+#.*$/, '').trim();
+    if (key === 'prices' && value === '') { inPrices = true; continue; }
+    if (value.startsWith('[') && value.endsWith(']')) {
+      config[key] = value.slice(1, -1).split(',').map((s) => s.trim()).filter(Boolean);
+    } else if (value !== '') {
+      config[key] = value;
+    }
+  }
+  return config;
+}