@ritualai/cli 0.7.3 → 0.7.6

package/dist/lib/welcome-banner.js

@@ -0,0 +1,290 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printWelcomeBanner = printWelcomeBanner;
+exports.readBoundWorkspace = readBoundWorkspace;
+const node_os_1 = require("node:os");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const colors_1 = require("./colors");
+/**
+ * Welcome banner for `ritual init` and `ritual login`.
+ *
+ * Inspired by Claude Code's startup screen: a two-column boxed
+ * panel that surfaces "who you are, where you are, what's about to
+ * happen, what you can do next" in one glance. Replaces the previous
+ * single-line `Ritual — scaffolding skills…` opener.
+ *
+ * Layout:
+ *
+ *   ╭─── Ritual CLI v0.7.5 ──────────────────────────────────────╮
+ *   │                                       │ <right column>     │
+ *   │       Welcome (back)!                  │                    │
+ *   │                                       │  • tip 1           │
+ *   │       <chain link glyph>              │  • tip 2           │
+ *   │                                       │  • tip 3           │
+ *   │       <tagline / identity>            │                    │
+ *   │                                       │  Quick commands /  │
+ *   │       ~/Development/project-name      │  recent activity   │
+ *   ╰────────────────────────────────────────┴────────────────────╯
+ *
+ * Renders only on TTY (`process.stdout.isTTY`). Skips entirely
+ * outside a TTY so piped output / CI / `--json` consumers aren't
+ * polluted. Width-aware: collapses to single-column when terminal
+ * width < 100.
+ *
+ * The chain-link glyph is the Ritual CLI's terminal-only visual
+ * anchor. The canonical Ritual brand mark (teal R-in-circle, see
+ * `apps/web/static/icon.svg`) is too detailed for terminal block-
+ * character rendering at the welcome-box scale. Both coexist: chain
+ * link in CLI, R-in-circle everywhere else. The brand TEAL color
+ * `#1FAF9F` is shared across both for unmistakable Ritual identity.
+ */
+/** The chain-link glyph. 7×5 cells of Unicode box characters. */
+const CHAIN_GLYPH = [
+    '╭─────╮      ',
+    '│  ╭──┼──╮   ',
+    '│  │  │  │   ',
+    '╰──┼──╯  │   ',
+    '   ╰─────╯   ',
+];
+/** Minimum terminal width for the two-column layout. Below this we fall back. */
+const MIN_TWO_COL_WIDTH = 100;
+/** Target total width of the welcome box (top + bottom border). */
+const TARGET_WIDTH = 110;
+/** Left column width (identity / context / glyph). */
+const LEFT_COL_WIDTH = 48;
+/**
+ * Render the welcome banner. Writes to stderr — same routing
+ * principle as `identity-banner.ts`: human chrome on stderr, leaving
+ * stdout clean for JSON / pipes / agent-readable status output.
+ *
+ * Returns nothing. Idempotent — callers can call multiple times if
+ * they want (e.g. before sign-in and after), but the standard call
+ * site is once at the top of the command.
+ */
+function printWelcomeBanner(input) {
+    // Non-TTY: skip entirely. Same gate as identity-banner.
+    if (!process.stderr.isTTY)
+        return;
+    const width = Math.min(process.stdout.columns ?? TARGET_WIDTH, TARGET_WIDTH);
+    const twoCol = width >= MIN_TWO_COL_WIDTH;
+    const colorMode = (0, colors_1.detectColorMode)();
+    const lines = twoCol
+        ? renderTwoColumn(input, width)
+        : renderSingleColumn(input, width);
+    // Wrap in top/bottom border. Top border carries the CLI version
+    // in the chrome — `╭─── Ritual CLI v0.7.5 ──────╮` — same shape
+    // as Claude Code's `Claude Code v2.1.112` header.
+    const header = renderTopBorder(input.cliVersion, width);
+    const footer = renderBottomBorder(width, twoCol);
+    const out = [header, ...lines, footer].join('\n') + '\n';
+    // Apply teal to the entire frame at the end so partial-write
+    // glitches don't leave color escapes hanging.
+    void colorMode; // colorize() is per-line inside the renderers
+    process.stderr.write(out);
+}
+// ─── top + bottom border ──────────────────────────────────────────
+function renderTopBorder(cliVersion, width) {
+    const label = ` Ritual CLI v${cliVersion} `;
+    // Pad to: ╭───label───────────────╮
+    const dashesBefore = 3;
+    const innerWidth = width - 2; // minus the corner chars
+    const remaining = innerWidth - dashesBefore - label.length;
+    const body = '─'.repeat(dashesBefore) + label + '─'.repeat(Math.max(0, remaining));
+    return (0, colors_1.color)(colors_1.RITUAL_TEAL, `╭${body}╮`);
+}
+function renderBottomBorder(width, twoCol) {
+    const innerWidth = width - 2;
+    if (twoCol) {
+        // Bottom has a ┴ where the column divider was.
+        const left = '─'.repeat(LEFT_COL_WIDTH);
+        const right = '─'.repeat(Math.max(0, innerWidth - LEFT_COL_WIDTH - 1));
+        return (0, colors_1.color)(colors_1.RITUAL_TEAL, `╰${left}┴${right}╯`);
+    }
+    return (0, colors_1.color)(colors_1.RITUAL_TEAL, `╰${'─'.repeat(innerWidth)}╯`);
+}
+// ─── two-column layout ────────────────────────────────────────────
+function renderTwoColumn(input, width) {
+    const left = leftColumnLines(input, LEFT_COL_WIDTH);
+    const right = rightColumnLines(input);
+    const rightWidth = width - LEFT_COL_WIDTH - 3; // minus separators
+    // Pad to the same length so the divider doesn't drift.
+    const rowCount = Math.max(left.length, right.length);
+    while (left.length < rowCount)
+        left.push('');
+    while (right.length < rowCount)
+        right.push('');
+    const result = [];
+    for (let i = 0; i < rowCount; i++) {
+        const l = padDisplay(left[i], LEFT_COL_WIDTH);
+        const r = padDisplay(right[i], rightWidth);
+        const bar = (0, colors_1.color)(colors_1.RITUAL_TEAL, '│');
+        result.push(`${bar}${l}${bar}${r}${bar}`);
+    }
+    return result;
+}
+function renderSingleColumn(input, width) {
+    // Narrow terminal — stack everything in one column. Drop the
+    // chain glyph margin to give text more room.
+    const innerWidth = width - 2;
+    const lines = [];
+    for (const l of leftColumnLines(input, innerWidth)) {
+        lines.push((0, colors_1.color)(colors_1.RITUAL_TEAL, '│') + padDisplay(l, innerWidth) + (0, colors_1.color)(colors_1.RITUAL_TEAL, '│'));
+    }
+    // Visual separator between left + right content blocks.
+    lines.push((0, colors_1.color)(colors_1.RITUAL_TEAL, '├' + '─'.repeat(innerWidth) + '┤'));
+    for (const r of rightColumnLines(input)) {
+        lines.push((0, colors_1.color)(colors_1.RITUAL_TEAL, '│') + padDisplay(r, innerWidth) + (0, colors_1.color)(colors_1.RITUAL_TEAL, '│'));
+    }
+    return lines;
+}
+// ─── content: left column (identity + glyph) ─────────────────────
+function leftColumnLines(input, colWidth) {
+    const greeting = input.currentUser ? `Welcome back, ${input.currentUser}` : 'Welcome to Ritual!';
+    const projectLabel = `~/${relativeToHome(input.projectDir)}`;
+    const wsLine = input.workspaceBound && input.workspaceName
+        ? `Workspace: ${input.workspaceName}`
+        : input.workspaceBound
+            ? 'Workspace: (bound)'
+            : undefined;
+    const lines = [];
+    lines.push('');
+    lines.push(centerInColumn((0, colors_1.boldColor)(colors_1.RITUAL_TEAL, greeting), colWidth, greeting.length));
+    lines.push('');
+    // Chain glyph — center the WHOLE glyph as a block, not each
+    // row independently. Each row is trimmed of trailing whitespace
+    // (to avoid odd terminal selection rectangles) but the relative
+    // alignment between rows is preserved by computing the centering
+    // offset once from the widest row.
+    const glyphWidth = Math.max(...CHAIN_GLYPH.map((r) => r.trimEnd().length));
+    const glyphLeftPad = Math.max(0, Math.floor((colWidth - glyphWidth) / 2));
+    for (const row of CHAIN_GLYPH) {
+        const trimmed = row.trimEnd();
+        lines.push(' '.repeat(glyphLeftPad) + (0, colors_1.color)(colors_1.RITUAL_TEAL, trimmed));
+    }
+    lines.push('');
+    if (wsLine) {
+        lines.push(centerInColumn((0, colors_1.dim)(wsLine), colWidth, wsLine.length));
+    }
+    else if (!input.currentUser) {
+        // Fresh user tagline.
+        const tagline = 'Plan and ship without surprise context';
+        lines.push(centerInColumn((0, colors_1.dim)(tagline), colWidth, tagline.length));
+    }
+    lines.push(centerInColumn((0, colors_1.dim)(projectLabel), colWidth, projectLabel.length));
+    lines.push('');
+    return lines;
+}
+// ─── content: right column (tips / activity / commands) ──────────
+function rightColumnLines(input) {
+    const lines = [];
+    const heading = (text) => (0, colors_1.boldColor)(colors_1.RITUAL_TEAL, text);
+    const tips = input.tips ?? defaultTipsFor(input);
+    const recent = input.recentActivity;
+    const quick = input.quickCommands ?? defaultQuickCommandsFor(input);
+    if (recent !== undefined && recent.length > 0) {
+        lines.push('');
+        lines.push(`  ${heading('Recent activity')}`);
+        for (const r of recent) {
+            lines.push(`    ${r}`);
+        }
+        lines.push('');
+        lines.push(`  ${heading('Quick commands')}`);
+        for (const q of quick) {
+            lines.push(`    ${(0, colors_1.dim)(q)}`);
+        }
+    }
+    else {
+        lines.push('');
+        lines.push(`  ${heading('What this command will do')}`);
+        for (const t of tips) {
+            lines.push(`    ${t}`);
+        }
+        lines.push('');
+        lines.push(`  ${heading('Quick commands')}`);
+        for (const q of quick) {
+            lines.push(`    ${(0, colors_1.dim)(q)}`);
+        }
+    }
+    lines.push('');
+    return lines;
+}
+function defaultTipsFor(_input) {
+    return [
+        '1. Sign you in (browser-based OAuth)',
+        '2. Bind a workspace for this repo',
+        '3. Mint a long-lived MCP token',
+        '4. Register the MCP server with your',
+        '   AI coding agent(s)',
+    ];
+}
+function defaultQuickCommandsFor(_input) {
+    return [
+        '/ritual build <feature>   ← inside agent',
+        'ritual graph status',
+        'ritual doctor',
+        'ritual init --switch-account',
+    ];
+}
+// ─── helpers ──────────────────────────────────────────────────────
+/**
+ * Display the project path relative to ~ when possible, else
+ * absolute. Cosmetic only — keeps the welcome box from showing the
+ * user's full home prefix.
+ */
+function relativeToHome(absPath) {
+    const home = (0, node_os_1.homedir)();
+    if (absPath === home)
+        return '';
+    if (absPath.startsWith(home + '/'))
+        return absPath.slice(home.length + 1);
+    return (0, node_path_1.basename)(absPath);
+}
+/**
+ * Pad text to a fixed visible width — taking into account ANSI
+ * escape sequences which take screen-space of 0 chars. Bare-bones
+ * implementation: strip ANSI, measure, pad.
+ */
+function padDisplay(text, width) {
+    const visible = stripAnsi(text).length;
+    if (visible >= width)
+        return text;
+    return text + ' '.repeat(width - visible);
+}
+/**
+ * Center `text` in a column of `colWidth`, treating ANSI-sequence
+ * bytes as zero-width. Caller must pass the visible length of the
+ * uncolored text as `visibleLen` since we can't reliably recompute
+ * after color() wraps the content.
+ */
+function centerInColumn(coloredText, colWidth, visibleLen) {
+    const pad = Math.max(0, Math.floor((colWidth - visibleLen) / 2));
+    return ' '.repeat(pad) + coloredText;
+}
+/** Strip ANSI escape sequences. Minimal — covers SGR codes only. */
+function stripAnsi(s) {
+    // eslint-disable-next-line no-control-regex
+    return s.replace(/\x1b\[[0-9;]*m/g, '');
+}
+// ─── workspace-name resolver ─────────────────────────────────────
+/**
+ * Read `.ritual/config.json` from the project dir (if present) and
+ * resolve the workspace name. Returns `{ bound: false }` if no
+ * config file. Returns `{ bound: true, name }` with a best-effort
+ * label — config schema stores `workspaceId` only, so the name
+ * itself comes from a separate cached field if the binding flow
+ * persisted it (it does, as of PR #200).
+ */
+function readBoundWorkspace(projectDir) {
+    const cfgPath = (0, node_path_1.join)(projectDir, '.ritual', 'config.json');
+    if (!(0, node_fs_1.existsSync)(cfgPath))
+        return { bound: false };
+    try {
+        const parsed = JSON.parse((0, node_fs_1.readFileSync)(cfgPath, 'utf-8'));
+        return { bound: true, name: parsed.workspaceName };
+    }
+    catch {
+        return { bound: true };
+    }
+}
+//# sourceMappingURL=welcome-banner.js.map

package/dist/lib/welcome-banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome-banner.js","sourceRoot":"","sources":["../../src/lib/welcome-banner.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ritualai/cli",
-  "version": "0.7.3",
+  "version": "0.7.6",
   "description": "Ritual CLI — scaffold AI coding agent skills + register MCP servers. Connects Claude Code, Cursor, Windsurf, Kiro, Gemini CLI, VS Code/Copilot, and Codex to Ritual Cloud.",
   "private": false,
   "license": "Apache-2.0",

package/skills/claude-code/ritual/agents/openai.yaml

@@ -1,5 +1,5 @@
 interface:
   display_name: Ritual
   short_description: Plan and build implementation-heavy changes with Ritual context, discovery, build briefs, lineage, and context-pulse scoring.
-  icon: 🪷
-  color: "#7C3AED"
+  icon: 🔗
+  color: "#1FAF9F"

package/skills/claude-code/ritual/manifest.json

@@ -0,0 +1,57 @@
+[
+  {
+    "path": "DESIGN.md",
+    "lines": 36,
+    "bytes": 2226
+  },
+  {
+    "path": "SKILL.md",
+    "lines": 72,
+    "bytes": 5915
+  },
+  {
+    "path": "agents/openai.yaml",
+    "lines": 6,
+    "bytes": 213
+  },
+  {
+    "path": "references/async-polling.md",
+    "lines": 27,
+    "bytes": 1197
+  },
+  {
+    "path": "references/build-flow.md",
+    "lines": 1519,
+    "bytes": 88142
+  },
+  {
+    "path": "references/cli-output-contract.md",
+    "lines": 225,
+    "bytes": 11559
+  },
+  {
+    "path": "references/context-pulse-flow.md",
+    "lines": 357,
+    "bytes": 25358
+  },
+  {
+    "path": "references/discovery-classification.md",
+    "lines": 176,
+    "bytes": 10275
+  },
+  {
+    "path": "references/lineage-flow.md",
+    "lines": 154,
+    "bytes": 8774
+  },
+  {
+    "path": "references/resume-flow.md",
+    "lines": 157,
+    "bytes": 9950
+  },
+  {
+    "path": "references/scoring-fallback.md",
+    "lines": 126,
+    "bytes": 6494
+  }
+]