@aligndottech/cli 0.25.0 → 0.26.0

package/dist/lib/brand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../../src/lib/brand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,KAAK;;;CAGR,CAAC;AAWX,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,SAAS,IAAI,CAAC;AAE3B;;;GAGG;AACH,eAAO,MAAM,aAAa,4EAGhB,CAAC;AAmBX;0EAC0E;AAC1E,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAanD,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iFAAiF;IACjF,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAuCD,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,IAAI,GAAE,aAAkB,GAAG,MAAM,EAAE,CAwC5D;AAED,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAkBlD;AAED,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAK5E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAIxD"}

package/dist/lib/brand.js

@@ -0,0 +1,197 @@
+/**
+ * Align brand rendering for the terminal.
+ *
+ * The mark is AUTHORED at terminal resolution, not downsampled from the vector logo.
+ * Resampling the detailed mark to this size was tried first and read as mud: the thin
+ * strokes and the inner triangle turn to noise below about 40 rows. So this is pixel
+ * art of the mark - chevron, inner triangle, the teal bar and the two feet - drawn to
+ * survive at 16x5 cells, packed two pixel rows per terminal row with half blocks.
+ *
+ * On a dark terminal the navy strokes are rendered WHITE, following the brand pack's
+ * own knockout variant (F 4 R): navy on a dark background is invisible, which is why
+ * that variant exists. The teal stays teal in both, as it does in the artwork.
+ */
+export const BRAND = {
+    teal: '#43b6ac',
+    navy: '#022863',
+};
+const TEAL_RGB = [67, 182, 172];
+const NAVY_RGB = [2, 40, 99];
+const WHITE_RGB = [255, 255, 255];
+// 256-colour approximations, for terminals that report colour but not truecolor.
+const TEAL_256 = 79;
+const NAVY_256 = 24;
+const WHITE_256 = 231;
+export const LOGO_WIDTH = 20;
+export const LOGO_ROWS = 8;
+/**
+ * The live positioning line, taken from align-frontend's hero (src/lib/seo.ts).
+ * 'Collaboration with clarity built in' is RETIRED - do not reintroduce it.
+ */
+export const TAGLINE_LINES = [
+    'Your AI agents know the code.',
+    "They don't know the company.",
+];
+/**
+ * One character per terminal cell, encoding the two pixel rows it covers:
+ *   ' ' both empty   'N' both mark    'T' both teal
+ *   'n' mark on top  'u' mark below   't' teal on top   'v' teal below
+ *   'x' mark over teal              'y' teal over mark
+ */
+const SPRITE = [
+    '        unnu        ',
+    '       NnuunN       ',
+    '      NnunnunN      ',
+    '    uNNuNuuNuNNuuuuu',
+    'vvvvvvvvvvvvvvvvvv  ',
+    '   vvvvv    vvvvv   ',
+    '  uu  uu    uu  uu  ',
+    '  NNuNN      NNuNN  ',
+];
+const SPRITE_SOLID = [
+    '        uNNu        ',
+    '       NNnnNN       ',
+    '      NNnuunNN      ',
+    '    uNNNuNNuNNNuuuuu',
+    'vvvvvvvvvvvvvvvvvv  ',
+    '   vvvvv    vvvvv   ',
+    '  uuu uuu   uuu uuu ',
+    '  NNNuNNN   NNNuNNN ',
+];
+function resolveColor(o) {
+    if (typeof o.color === 'boolean')
+        return o.color;
+    // NO_COLOR is honoured whatever its value, per the no-color.org convention: the
+    // variable's PRESENCE is the signal, so `NO_COLOR=0` still disables colour.
+    if (process.env['NO_COLOR'] !== undefined)
+        return false;
+    return Boolean(process.stdout.isTTY);
+}
+function resolveTruecolor(o) {
+    if (typeof o.truecolor === 'boolean')
+        return o.truecolor;
+    const ct = process.env['COLORTERM'] ?? '';
+    return ct === 'truecolor' || ct === '24bit';
+}
+function resolveDark(o) {
+    if (typeof o.dark === 'boolean')
+        return o.dark;
+    // COLORFGBG is "fg;bg"; a bg of 0-6 or 8 means a dark background. Absent on most
+    // terminals, and dark is the safer default: a white mark on an unexpectedly light
+    // background is faint, whereas navy on an unexpectedly dark one is unreadable.
+    const fgbg = process.env['COLORFGBG'];
+    if (fgbg) {
+        const bg = Number(fgbg.split(';').pop());
+        if (Number.isFinite(bg))
+            return bg <= 6 || bg === 8;
+    }
+    return true;
+}
+function fg(rgb, c256, truecolor) {
+    return truecolor ? `\x1b[38;2;${rgb[0]};${rgb[1]};${rgb[2]}m` : `\x1b[38;5;${c256}m`;
+}
+function bg(rgb, c256, truecolor) {
+    return truecolor ? `\x1b[48;2;${rgb[0]};${rgb[1]};${rgb[2]}m` : `\x1b[48;5;${c256}m`;
+}
+const RESET = '\x1b[0m';
+/** The mark, one string per terminal row, all exactly LOGO_WIDTH cells wide. */
+export function logoLines(opts = {}) {
+    const color = resolveColor(opts);
+    const truecolor = resolveTruecolor(opts);
+    const markRgb = resolveDark(opts) ? WHITE_RGB : NAVY_RGB;
+    const mark256 = resolveDark(opts) ? WHITE_256 : NAVY_256;
+    const style = opts.style ?? 'white';
+    // 'teal' paints the strokes teal instead of the knockout white; 'solid' also swaps in
+    // the filled sprite, which reads bolder because the mass carries the colour rather
+    // than a one-cell outline.
+    const strokeRgb = style === 'white' ? markRgb : TEAL_RGB;
+    const stroke256 = style === 'white' ? mark256 : TEAL_256;
+    return (style === 'solid' ? SPRITE_SOLID : SPRITE).map((row) => {
+        let out = '';
+        for (const cell of row) {
+            // Plain mode still uses the blocks: the shape is the point, and stripping
+            // colour must not change the width or the silhouette.
+            if (!color) {
+                out += cell === ' ' ? ' '
+                    : cell === 'N' || cell === 'T' ? '█'
+                        : cell === 'n' || cell === 't' ? '▀'
+                            : cell === 'u' || cell === 'v' ? '▄'
+                                : '█';
+                continue;
+            }
+            switch (cell) {
+                case ' ':
+                    out += ' ';
+                    break;
+                case 'N':
+                    out += `${fg(strokeRgb, stroke256, truecolor)}█${RESET}`;
+                    break;
+                case 'T':
+                    out += `${fg(TEAL_RGB, TEAL_256, truecolor)}█${RESET}`;
+                    break;
+                case 'n':
+                    out += `${fg(strokeRgb, stroke256, truecolor)}▀${RESET}`;
+                    break;
+                case 'u':
+                    out += `${fg(strokeRgb, stroke256, truecolor)}▄${RESET}`;
+                    break;
+                case 't':
+                    out += `${fg(TEAL_RGB, TEAL_256, truecolor)}▀${RESET}`;
+                    break;
+                case 'v':
+                    out += `${fg(TEAL_RGB, TEAL_256, truecolor)}▄${RESET}`;
+                    break;
+                case 'x':
+                    out += `${fg(strokeRgb, stroke256, truecolor) + bg(TEAL_RGB, TEAL_256, truecolor)}▀${RESET}`;
+                    break;
+                case 'y':
+                    out += `${fg(TEAL_RGB, TEAL_256, truecolor) + bg(strokeRgb, stroke256, truecolor)}▀${RESET}`;
+                    break;
+                default: out += ' ';
+            }
+        }
+        return out;
+    });
+}
+/**
+ * The full lockup: the mark on the left, wordmark and tagline to its right, so the
+ * whole thing is only as tall as the mark (LOGO_ROWS) rather than stacking.
+ */
+export function banner(opts) {
+    const color = resolveColor(opts);
+    const truecolor = resolveTruecolor(opts);
+    const dim = color ? '\x1b[2m' : '';
+    const bold = color ? '\x1b[1m' : '';
+    const tealFg = color ? fg(TEAL_RGB, TEAL_256, truecolor) : '';
+    const reset = color ? RESET : '';
+    const right = new Array(LOGO_ROWS).fill('');
+    // Registered, not TM: Align is a registered trademark.
+    right[1] = `${bold}ALIGN®${reset}`;
+    right[2] = `${tealFg}${TAGLINE_LINES[0]}${reset}`;
+    right[3] = `${tealFg}${TAGLINE_LINES[1]}${reset}`;
+    const meta = opts.context ? `v${opts.version}  ${'\u00b7'}  ${opts.context}` : `v${opts.version}`;
+    right[5] = `${dim}${meta}${reset}`;
+    const mark = logoLines(opts);
+    return mark.map((m, i) => (right[i] ? `${m}   ${right[i]}` : m)).join('\n');
+}
+/** One consistent intro chip for every command, in brand teal. */
+export function commandIntro(label, opts = {}) {
+    const color = resolveColor(opts);
+    if (!color)
+        return ` ${label} `;
+    const truecolor = resolveTruecolor(opts);
+    return `${bg(TEAL_RGB, TEAL_256, truecolor)}${fg(NAVY_RGB, NAVY_256, truecolor)} ${label} ${RESET}`;
+}
+/**
+ * Print the banner, but only when someone is actually looking at a terminal.
+ *
+ * Piped output (`align ask ... | jq`) and CI logs must stay clean, so this is a
+ * no-op off a TTY rather than a plain-text banner.
+ */
+export function printBanner(opts) {
+    if (!process.stdout.isTTY)
+        return false;
+    process.stdout.write(`${banner(opts)}\n`);
+    return true;
+}
+//# sourceMappingURL=brand.js.map

package/dist/lib/brand.js.map

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

package/dist/lib/setup-ux.d.ts

@@ -0,0 +1,38 @@
+/**
+ * How many options `@clack/prompts` may render at once.
+ *
+ * Without this, clack draws every option and its in-place redraw miscounts once
+ * the list is taller than the viewport, duplicating rows on screen. An outside
+ * tester hit exactly that on 2026-08-30: seven connectors, a screenful of git
+ * import output above them, and "Notion" painted three times.
+ */
+export declare function pickerMaxItems(rows: number | undefined, optionCount: number): number;
+/**
+ * Read an already-authenticated token out of a local CLI, so a user who has
+ * `gh` set up is not sent to a browser to mint a PAT by hand.
+ *
+ * Returns null for every failure - not installed, not logged in, or authenticated
+ * but printing nothing. Null means "ask the user normally", so a broken or absent
+ * CLI degrades to the flow that existed before rather than to an error.
+ */
+export declare function detectCliToken(bin: string, args: string[]): Promise<string | null>;
+/** Connectors whose token can be read from an already-authenticated local CLI. */
+export declare const CLI_TOKEN_SOURCES: Record<string, {
+    bin: string;
+    args: string[];
+    label: string;
+}>;
+/**
+ * Whether to use a token found in a local CLI, ask first, or ignore it.
+ *
+ * Separate from the prompt chain on purpose. `--approve` is documented as "Skip
+ * confirmation prompts (for scripted use)", and this repo has already shipped one
+ * prompt that ignored it - setup.ts still carries the comment about `align setup
+ * --approve` hanging when two agents were installed. A rule buried in an async
+ * prompt chain is not testable; this is.
+ */
+export declare function cliTokenDecision(o: {
+    token: string | null;
+    approve: boolean;
+}): 'use' | 'ask' | 'skip';
+//# sourceMappingURL=setup-ux.d.ts.map

package/dist/lib/setup-ux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-ux.d.ts","sourceRoot":"","sources":["../../src/lib/setup-ux.ts"],"names":[],"mappings":"AAsBA;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAIpF;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWxF;AAED,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAE5F,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAKtG"}

package/dist/lib/setup-ux.js

@@ -0,0 +1,73 @@
+import { execa } from 'execa';
+/**
+ * Sizing and credential-discovery helpers for `align setup`.
+ *
+ * Lives outside setup.ts deliberately: that file is 833 lines and the 900-line
+ * ratchet is real, but more importantly these two are pure enough to test
+ * directly, which the flow around them is not.
+ */
+// Lines the prompt needs beyond the option rows themselves: the message, clack's
+// top and bottom rules, the submit hint, and enough slack that the previous
+// command's last line is not overwritten.
+const RESERVED_ROWS = 8;
+// Below this a paginated list is unusable, so we overflow slightly rather than
+// render one option at a time. clack scrolls within maxItems, so a floor is safe.
+const MIN_VISIBLE = 3;
+// Used when stdout is not a TTY and reports no size. 24 is the classic default.
+const ASSUMED_ROWS = 24;
+/**
+ * How many options `@clack/prompts` may render at once.
+ *
+ * Without this, clack draws every option and its in-place redraw miscounts once
+ * the list is taller than the viewport, duplicating rows on screen. An outside
+ * tester hit exactly that on 2026-08-30: seven connectors, a screenful of git
+ * import output above them, and "Notion" painted three times.
+ */
+export function pickerMaxItems(rows, optionCount) {
+    const height = typeof rows === 'number' && Number.isFinite(rows) && rows > 0 ? rows : ASSUMED_ROWS;
+    const usable = Math.max(MIN_VISIBLE, height - RESERVED_ROWS);
+    return Math.min(optionCount, usable);
+}
+/**
+ * Read an already-authenticated token out of a local CLI, so a user who has
+ * `gh` set up is not sent to a browser to mint a PAT by hand.
+ *
+ * Returns null for every failure - not installed, not logged in, or authenticated
+ * but printing nothing. Null means "ask the user normally", so a broken or absent
+ * CLI degrades to the flow that existed before rather than to an error.
+ */
+export async function detectCliToken(bin, args) {
+    try {
+        // execa rejects on a non-zero exit, so the catch covers "not logged in"; the
+        // explicit check covers a runner configured with reject:false upstream.
+        const result = await execa(bin, args, { timeout: 5_000 });
+        if (typeof result?.exitCode === 'number' && result.exitCode !== 0)
+            return null;
+        const token = String(result?.stdout ?? '').trim();
+        return token.length > 0 ? token : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Connectors whose token can be read from an already-authenticated local CLI. */
+export const CLI_TOKEN_SOURCES = {
+    github: { bin: 'gh', args: ['auth', 'token'], label: 'GitHub CLI (gh)' },
+};
+/**
+ * Whether to use a token found in a local CLI, ask first, or ignore it.
+ *
+ * Separate from the prompt chain on purpose. `--approve` is documented as "Skip
+ * confirmation prompts (for scripted use)", and this repo has already shipped one
+ * prompt that ignored it - setup.ts still carries the comment about `align setup
+ * --approve` hanging when two agents were installed. A rule buried in an async
+ * prompt chain is not testable; this is.
+ */
+export function cliTokenDecision(o) {
+    if (!o.token)
+        return 'skip';
+    // --approve means the affirmative, not the absence of the step: skipping the
+    // connector would silently drop a source the user could have had.
+    return o.approve ? 'use' : 'ask';
+}
+//# sourceMappingURL=setup-ux.js.map

package/dist/lib/setup-ux.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-ux.js","sourceRoot":"","sources":["../../src/lib/setup-ux.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B;;;;;;GAMG;AAEH,iFAAiF;AACjF,4EAA4E;AAC5E,0CAA0C;AAC1C,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB,+EAA+E;AAC/E,kFAAkF;AAClF,MAAM,WAAW,GAAG,CAAC,CAAC;AAEtB,gFAAgF;AAChF,MAAM,YAAY,GAAG,EAAE,CAAC;AAExB;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,IAAwB,EAAE,WAAmB;IAC1E,MAAM,MAAM,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC;IACnG,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,IAAc;IAC9D,IAAI,CAAC;QACH,6EAA6E;QAC7E,wEAAwE;QACxE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1D,IAAI,OAAO,MAAM,EAAE,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/E,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,MAAM,iBAAiB,GAAmE;IAC/F,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE;CACzE,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAA6C;IAC5E,IAAI,CAAC,CAAC,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC;IAC5B,6EAA6E;IAC7E,kEAAkE;IAClE,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AACnC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aligndottech/cli",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "mcpName": "io.github.aligndottech/cli",
   "type": "module",
   "description": "Align CLI - capture decisions, check alignment, and manage connectors",