@entelligentsia/forgecli 0.7.9 → 0.7.10

package/dist/forge-payload/.base-pack/workflows/orchestrate_task.md

@@ -781,12 +781,6 @@ forbid task.status == blocked
 forbid task.status == escalated
 ```
 
-```gates phase=writeback
-after approve = approved
-forbid task.status == blocked
-forbid task.status == escalated
-```
-
 Adjusting a gate is a data change — edit the block above, regenerate workflows
 on the user side via `/forge:update`, and the new gate takes effect on the next
 orchestrator run. No code change required to relax or tighten a gate.
@@ -859,12 +853,22 @@ is a violation of the Iron Laws.
 
 The **orchestrator** is the only actor that calls `store-cli emit` for phase
 events. Phase subagents write `{PHASE}-SUMMARY.json` and return. After each
-subagent returns, the orchestrator captures runtime attribution (`model`,
-`provider`, token usage) from the runtime stream, records bracketed wall
-times, reads the SUMMARY for judgement, and calls
-`node "$FORGE_ROOT/tools/store-cli.cjs" emit {sprintId} '{event-json}'`
-with the complete record. Do not hardcode example `model` / `provider`
-strings — they are the seed of LLM hallucination.
+subagent returns, the orchestrator:
+
+1. Captures the subagent's runtime attribution (`model`, `provider`, token
+   usage) from the runtime stream.
+2. Records bracketed wall times around the spawn call (`startTimestamp`,
+   `endTimestamp`, `durationMinutes`).
+3. Reads the SUMMARY for the judgement blob (`verdict`, `notes`, `findings`).
+4. Composes the canonical event with `eventId`, `taskId`, `sprintId`, `role`,
+   `action`, `phase`, `iteration` from its own task state and `tokenSource:
+   "reported"` when the runtime surfaced usage.
+5. Calls `node "$FORGE_ROOT/tools/store-cli.cjs" emit {sprintId} '{event-json}'`
+   with the complete record.
+
+Do not include hardcoded example `model` or `provider` strings in the
+generated orchestrator prose — they are the seed of LLM hallucination.
+Refer subagents to `.forge/schemas/event.schema.json` instead.
 ## Friction Emit
 
 When the Orchestrator detects skill friction during orchestrate-task — a referenced skill is unused, fails on invocation, is missing from the registry, has gone stale relative to current architecture, or is redundant with another skill — emit a `friction` event so `/forge:enhance --phase 2` can act on the signal. This is the writer side of the channel whose reader landed in S13-T08; the reader is empty without these emits.
@@ -896,7 +900,9 @@ When the Orchestrator detects skill friction during orchestrate-task — a refer
    FSM rejection, verdict malformed). The orchestrator emits inline using
    its own model/provider attribution (`persona: "orchestrator"`,
    `workflow: "orchestrate"`, `phase: "orchestrate"`). Same `store-cli emit`
-   path; consult `.forge/schemas/event.schema.json` for the required shape.
+   path; no example record is reproduced here because the orchestrator
+   owns the field values — consult `.forge/schemas/event.schema.json` for
+   the required shape.
 
 The schema enforces `{workflow, persona, issue}` as required when
 `type === "friction"`. `subkind` is the frozen enum
@@ -904,4 +910,5 @@ The schema enforces `{workflow, persona, issue}` as required when
 experimental `^x_[a-z_]+$`. Emit one record per distinct friction signal
 — do not coalesce.
 
-The generated `orchestrate_task.md` MUST carry this section verbatim — `/forge:enhance --phase 2` greps for it.
+The generated `orchestrate_task.md` MUST carry this section verbatim —
+`/forge:enhance --phase 2` greps for it.

package/dist/forge-payload/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "forge",
-  "version": "0.43.16",
+  "version": "0.43.19",
   "description": "Self-enhancing AI software development lifecycle \u2014 generates project-specific SDLC instances from meta-definitions",
   "license": "MIT",
   "author": {

package/dist/forge-payload/.tools/banners.cjs

@@ -0,0 +1,435 @@
+'use strict';
+
+// Forge Banner Library
+// Reusable agent identity display for tools, hooks, and skills.
+//
+// Render modes:
+//   render(name)             — full ASCII art block + emoji + name + tagline
+//   badge(name)              — single line: emoji + bold name + dim tagline
+//   mark(name)               — emoji only (for use alongside 〇△× status marks)
+//   progressBar(n,total,opt) — unicode block bar with optional gradient + label
+//   subtitle(text, opts)     — dim italic line for under-banner taglines
+//   phaseHeader(...)         — convenience: badge + em-dash banner + progress bar
+//
+// Plain mode: ANSI escapes are stripped when any of these is true:
+//   - env FORGE_BANNERS_PLAIN is set to a non-empty value
+//   - env NO_COLOR is set to a non-empty value
+//   - process.stdout.isTTY === false
+//   - CLI flag --plain is passed
+//
+// Usage (module):
+//   const banners = require('./banners.cjs');
+//   console.log(banners.render('forge'));
+//   console.log(banners.progressBar(5, 12, { label: 'Templates', color: [255,208,122] }));
+//
+// Usage (CLI):
+//   node banners.cjs forge
+//   node banners.cjs --badge north
+//   node banners.cjs --mark tide
+//   node banners.cjs --gallery
+//   node banners.cjs --list
+//   node banners.cjs --plain forge
+//   node banners.cjs --subtitle "Forging your SDLC"
+//   node banners.cjs --progress 5 12 "Templates"
+//   node banners.cjs --phase 7 12 "Workflows" ember fast
+
+// ─── Plain-mode detection ─────────────────────────────────────────────────────
+// Resolved at call-time so tests can flip env vars dynamically.
+function isPlain() {
+  if (process.env.FORGE_BANNERS_PLAIN) return true;
+  if (process.env.NO_COLOR) return true;
+  if (process.stdout && process.stdout.isTTY === false) return true;
+  return false;
+}
+
+// Strip ANSI escape sequences (CSI). Conservative — matches \x1b[...m and friends.
+const ANSI_RE = /\x1b\[[0-9;]*[A-Za-z]/g;
+function stripAnsi(s) {
+  return String(s).replace(ANSI_RE, '');
+}
+
+// Soft override — set by `--plain` CLI flag to force plain mode for one run.
+let FORCE_PLAIN = false;
+
+// ─── ANSI helpers ─────────────────────────────────────────────────────────────
+const R = '\x1b[0m';
+const B = '\x1b[1m';
+const D = '\x1b[2m';
+const I = '\x1b[3m';
+const f = (r, g, b) => `\x1b[38;2;${r};${g};${b}m`;
+
+// ─── Mode tints ───────────────────────────────────────────────────────────────
+// Mode-aware accent colour for progress bars and subtitles. Used by phaseHeader.
+const MODE_TINTS = {
+  fast: [255, 208, 122],   // lantern yellow
+  full: [255, 138, 60],    // ember orange
+};
+
+// ─── Zen blue ─────────────────────────────────────────────────────────────────
+// System-wide horizontal-rule tint. Applied to em-dash separators in
+// phaseHeader, ruleLine, and ensure-ready.cjs --announce framing. Picked to
+// read calm and cool without competing with banner colours.
+const ZEN_BLUE = [100, 140, 200];
+
+// ─── Banner registry ───────────────────────────────────────────────────────────
+const BANNERS = {
+
+  ember: {
+    emoji:   '🔥',
+    tagline: 'heat · ignition · drive',
+    name:    'EMBER',
+    kanji:   '炎',
+    color:   [255, 170, 60],
+    art:     `  ${f(255,240,100)})  ${f(255,200,50)})  ${f(255,140,20)}(${f(230,80,10)}🔥${f(255,140,20)})  ${f(230,80,10)}~∿~  ${f(170,30,5)}≋≋≋`,
+  },
+
+  tide: {
+    emoji:   '🌊',
+    tagline: 'rhythm · pull · depth',
+    name:    'TIDE',
+    kanji:   '潮',
+    color:   [110, 200, 255],
+    art:     `  ${f(210,240,255)}∿  ${f(130,200,245)}≋≋≋  ${f(60,140,210)}≋≋≋  ${f(25,85,175)}▓▓▓  ${f(10,45,130)}▓▓▓`,
+  },
+
+  oracle: {
+    emoji:   '🌕',
+    tagline: 'sight · pattern · knowing',
+    name:    'ORACLE',
+    kanji:   '神託',
+    color:   [210, 160, 255],
+    art:     `  ${f(160,80,240)}· ◌  ${f(190,110,255)}◎  ${f(255,220,100)}◉  ${f(190,110,255)}◎  ${f(160,80,240)}◌ ·`,
+  },
+
+  rift: {
+    emoji:   '⚡',
+    tagline: 'edge · fracture · crossing',
+    name:    'RIFT',
+    kanji:   '裂',
+    color:   [100, 255, 240],
+    art:     `  ${f(0,240,230)}▓▒░  ${f(180,0,220)}╲ ${f(0,255,240)}⚡${f(180,0,220)} ╱  ${f(0,240,230)}░▒▓`,
+  },
+
+  bloom: {
+    emoji:   '🌸',
+    tagline: 'growth · opening · becoming',
+    name:    'BLOOM',
+    kanji:   '開花',
+    color:   [255, 160, 190],
+    art:     `  ${f(255,160,200)}✿ ✿  ${f(255,120,170)}✾  ${f(255,220,100)}✽  ${f(255,120,170)}✾  ${f(255,160,200)}✿ ✿`,
+  },
+
+  north: {
+    emoji:   '🧭',
+    tagline: 'direction · clarity · cold',
+    name:    'NORTH',
+    kanji:   '北',
+    color:   [190, 225, 255],
+    art:     `  ${f(200,230,255)}✦  ${f(150,195,240)}╱  ${f(100,160,230)}◈  ${f(150,195,240)}╲  ${f(200,230,255)}✦`,
+  },
+
+  lumen: {
+    emoji:   '✨',
+    tagline: 'light · warmth · clarity',
+    name:    'LUMEN',
+    kanji:   '光',
+    color:   [255, 245, 150],
+    art:     `  ${f(255,255,200)}✧  ${f(255,245,160)}──  ${f(255,255,255)}◉  ${f(255,245,160)}──  ${f(255,255,200)}✧`,
+  },
+
+  forge: {
+    emoji:   '🔨',
+    tagline: 'making · heat · craft',
+    name:    'FORGE',
+    kanji:   '鍛冶',
+    color:   [255, 160, 40],
+    art:     `  ${f(255,230,80)}✦  ${f(200,80,20)}▄${f(230,100,30)}▓▓▓▓▓${f(200,80,20)}▄  ${f(255,160,40)}≋ ≋ ≋`,
+  },
+
+  drift: {
+    emoji:   '🍃',
+    tagline: 'ease · letting go · flow',
+    name:    'DRIFT',
+    kanji:   '漂流',
+    color:   [150, 200, 165],
+    art:     `  ${f(160,200,170)}·  ${f(140,180,155)}·   ${f(120,165,140)}·  ${f(100,150,125)}·   ${f(80,135,110)}·`,
+  },
+
+  void: {
+    emoji:   '🌑',
+    tagline: 'depth · silence · potential',
+    name:    'VOID',
+    kanji:   '虚空',
+    color:   [130, 100, 200],
+    art:     `  ${f(30,20,60)}  ·  ${f(70,50,120)}◌  ${f(50,35,90)}·  `,
+  },
+
+  entelligentsia: {
+    emoji:   '🔗',
+    tagline: 'linked · intellect · becoming',
+    name:    'ENTELLIGENTSIA',
+    kanji:   '知性',
+    color:   [140, 200, 60],
+    art:     `  ${f(110,110,115)}╭──╯  ${f(140,200,60)}─╮ ╭─  ${f(110,110,115)}╰──╮`,
+  },
+
+};
+
+// ─── Render helpers ────────────────────────────────────────────────────────────
+
+/** Dim dot rule — use between banners in a gallery */
+function rule() {
+  return `  ${f(45,45,65)}${'·'.repeat(32)}${R}`;
+}
+
+/**
+ * Full banner: ASCII art block + emoji + name + tagline.
+ * @param {string} name  Banner key (case-insensitive).
+ * @returns {string}
+ */
+function render(name) {
+  const b = _get(name);
+  const [r, g, bl] = b.color;
+  const kanji = b.kanji ? `  ${D}${f(r,g,bl)}${b.kanji}${R}` : '';
+  const label = `  ${b.emoji}  ${B}${f(r,g,bl)}${b.name}${R}${kanji}   ${D}${f(r,g,bl)}${b.tagline}${R}`;
+  const out = '\n' + b.art + R + '\n' + label + '\n';
+  return _maybePlain(out);
+}
+
+/**
+ * Badge: single line — emoji + bold name + dim tagline.
+ * Fits inline in status output or skill headers.
+ * @param {string} name
+ * @returns {string}
+ */
+function badge(name) {
+  const b = _get(name);
+  const [r, g, bl] = b.color;
+  const kanji = b.kanji ? `  ${D}${f(r,g,bl)}${b.kanji}${R}` : '';
+  return _maybePlain(`${b.emoji}  ${B}${f(r,g,bl)}${b.name}${R}${kanji}  ${D}${f(r,g,bl)}${b.tagline}${R}`);
+}
+
+/**
+ * Mark: emoji only.
+ * Use alongside 〇△× status marks for agent attribution.
+ * @param {string} name
+ * @returns {string}
+ */
+function mark(name) {
+  return _get(name).emoji;
+}
+
+/**
+ * Progress bar: unicode block bar with optional gradient tint and label.
+ *   ▰▰▰▰▰▱▱▱▱▱▱▱  Phase 5/12 · Templates
+ *
+ * @param {number} n      Filled cells (clamped to [0, total])
+ * @param {number} total  Total cells across the bar's logical range
+ * @param {object} [opts]
+ * @param {number} [opts.width=12]   Cells in the bar (independent of n/total)
+ * @param {number[]} [opts.color]    [r,g,b] tint for filled segment
+ * @param {string} [opts.label]      Trailing label after the bar
+ * @param {string} [opts.fillGlyph='▰'] Override filled cell glyph
+ * @param {string} [opts.emptyGlyph='▱'] Override empty cell glyph
+ * @returns {string}
+ */
+function progressBar(n, total, opts) {
+  const o = opts || {};
+  const width = Math.max(1, o.width || 12);
+  const fillGlyph = o.fillGlyph || '▰';
+  const emptyGlyph = o.emptyGlyph || '▱';
+  const safeTotal = Math.max(1, total || 1);
+  const safeN = Math.max(0, Math.min(n || 0, safeTotal));
+  const filledCells = Math.round((safeN / safeTotal) * width);
+  const emptyCells = width - filledCells;
+
+  let bar = '';
+  if (filledCells > 0) {
+    const tint = Array.isArray(o.color) ? f(o.color[0], o.color[1], o.color[2]) : '';
+    const reset = tint ? R : '';
+    bar += `${tint}${fillGlyph.repeat(filledCells)}${reset}`;
+  }
+  if (emptyCells > 0) {
+    bar += `${D}${emptyGlyph.repeat(emptyCells)}${R}`;
+  }
+
+  const counter = `  ${safeN}/${safeTotal}`;
+  const label = o.label ? `  ${D}·${R}  ${o.label}` : '';
+  return _maybePlain(bar + counter + label);
+}
+
+/**
+ * Subtitle: dim italic line under a banner. Single line.
+ *
+ * @param {string} text
+ * @param {object} [opts]
+ * @param {number[]} [opts.color]   Optional tint
+ * @returns {string}
+ */
+function subtitle(text, opts) {
+  const o = opts || {};
+  const tint = Array.isArray(o.color) ? f(o.color[0], o.color[1], o.color[2]) : '';
+  return _maybePlain(`  ${D}${I}${tint}${text}${R}`);
+}
+
+/**
+ * Em-dash rule line, tinted zen blue by default.
+ *   ━━━ {text} ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ *
+ * Use as a horizontal section separator anywhere in the system. Calling
+ * with no text produces a plain rule (just em-dashes, no label).
+ *
+ * @param {string} [text]   Optional label to embed in the rule
+ * @param {object} [opts]
+ * @param {number} [opts.width=65]   Total line width
+ * @param {number[]} [opts.color]    [r,g,b] override tint; defaults to ZEN_BLUE
+ * @returns {string}
+ */
+function ruleLine(text, opts) {
+  const o = opts || {};
+  const width = o.width || 65;
+  const color = Array.isArray(o.color) ? o.color : ZEN_BLUE;
+  const tint = f(color[0], color[1], color[2]);
+
+  let line;
+  if (text && text.length > 0) {
+    const head = `━━━ ${text} `;
+    const padCount = Math.max(3, width - head.length);
+    line = head + '━'.repeat(padCount);
+  } else {
+    line = '━'.repeat(width);
+  }
+  return _maybePlain(`${tint}${line}${R}`);
+}
+
+/**
+ * Phase header: multi-line — badge, em-dash banner, progress bar.
+ * Concatenates with newlines so a single println prints all three.
+ *
+ * @param {number} n           Phase number (1-based)
+ * @param {number} total       Total phases
+ * @param {string} name        Phase display name
+ * @param {string} bannerKey   Banner registry key (e.g. 'north', 'forge')
+ * @param {object|string} [opts]
+ *        Pass a string to use as the mode tint key ('fast' | 'full'),
+ *        or an opts object with { mode, color, width }.
+ * @returns {string}
+ */
+function phaseHeader(n, total, name, bannerKey, opts) {
+  let o = {};
+  if (typeof opts === 'string') {
+    o = { mode: opts };
+  } else if (opts) {
+    o = opts;
+  }
+  const tint = o.color || (o.mode && MODE_TINTS[o.mode.toLowerCase()]) || null;
+
+  const bar = progressBar(n, total, {
+    width: o.width || 12,
+    color: tint,
+    label: name,
+  });
+
+  // Em-dash banner — match the existing format used across all forge commands,
+  // tinted zen blue for system-wide visual consistency on horizontal rules.
+  const emBanner = ruleLine(`Phase ${n}/${total} — ${name}`);
+
+  const lines = [
+    badge(bannerKey),
+    emBanner,
+    bar,
+  ];
+  return lines.join('\n');
+}
+
+/**
+ * All available banner names.
+ * @returns {string[]}
+ */
+function list() {
+  return Object.keys(BANNERS);
+}
+
+/**
+ * Full gallery of all banners separated by rules.
+ * @returns {string}
+ */
+function gallery() {
+  return list().map((name, i) => {
+    const sep = i > 0 ? '\n' + rule() + '\n' : '';
+    return sep + render(name);
+  }).join('');
+}
+
+// ─── Internal ──────────────────────────────────────────────────────────────────
+
+function _get(name) {
+  const b = BANNERS[name.toLowerCase()];
+  if (!b) {
+    throw new Error(`Unknown banner "${name}". Available: ${list().join(', ')}`);
+  }
+  return b;
+}
+
+function _maybePlain(s) {
+  return (FORCE_PLAIN || isPlain()) ? stripAnsi(s) : s;
+}
+
+// ─── CLI ───────────────────────────────────────────────────────────────────────
+// node banners.cjs [<name>] [--gallery] [--badge <name>] [--mark <name>] [--list]
+
+if (require.main === module) {
+  let args = process.argv.slice(2);
+
+  // --plain may appear anywhere; consume it first.
+  const plainIdx = args.indexOf('--plain');
+  if (plainIdx !== -1) {
+    FORCE_PLAIN = true;
+    args = args.slice(0, plainIdx).concat(args.slice(plainIdx + 1));
+  }
+
+  try {
+    if (!args.length || args[0] === '--gallery') {
+      process.stdout.write(gallery() + '\n');
+    } else if (args[0] === '--list') {
+      console.log(list().map(n => {
+        const b = BANNERS[n];
+        return `${b.emoji}  ${n.padEnd(8)} — ${b.tagline}`;
+      }).join('\n'));
+    } else if (args[0] === '--badge') {
+      console.log(badge(args[1] || ''));
+    } else if (args[0] === '--mark') {
+      console.log(mark(args[1] || ''));
+    } else if (args[0] === '--subtitle') {
+      console.log(subtitle(args.slice(1).join(' ')));
+    } else if (args[0] === '--progress') {
+      const n = Number(args[1]);
+      const total = Number(args[2]);
+      const label = args.slice(3).join(' ') || undefined;
+      console.log(progressBar(n, total, { label }));
+    } else if (args[0] === '--phase') {
+      const n = Number(args[1]);
+      const total = Number(args[2]);
+      const name = args[3] || '';
+      const bannerKey = args[4] || 'forge';
+      const mode = args[5];   // optional 'fast' | 'full'
+      console.log(phaseHeader(n, total, name, bannerKey, mode ? { mode } : undefined));
+    } else if (args[0] === '--rule') {
+      // --rule [text]   Zen-blue em-dash horizontal rule (with optional label)
+      const text = args.slice(1).join(' ') || undefined;
+      console.log(ruleLine(text));
+    } else {
+      process.stdout.write(render(args[0]) + '\n');
+    }
+  } catch (e) {
+    console.error(e.message);
+    process.exit(1);
+  }
+}
+
+// ─── Exports ───────────────────────────────────────────────────────────────────
+module.exports = {
+  render, badge, mark, list, gallery, rule, BANNERS,
+  progressBar, subtitle, phaseHeader, ruleLine,
+  isPlain, stripAnsi, MODE_TINTS, ZEN_BLUE,
+};