vgxness 1.20.4 → 1.20.6

package/dist/interfaces/cli/tui/focus-types.js

@@ -0,0 +1,10 @@
+export function initialTuiFocusState(screenId = 'home', itemCount = 0) {
+    return {
+        screenId,
+        focusedIndex: 0,
+        itemCount: Math.max(0, itemCount),
+        helpOpen: false,
+        history: [],
+        status: 'active',
+    };
+}

package/dist/interfaces/cli/tui/ink/app-shell.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box } from 'ink';
+import { getTuiScreenDefinition } from '../screen-registry.js';
+import { TuiFooter, TuiHeader, TuiSummaryBar } from './components.js';
+import { TuiHelpOverlay } from './help-overlay.js';
+import { normalizeInkTuiWidth } from './theme.js';
+export function AppShell({ project, width, focus, subtitle, summaryItems = [], children }) {
+    const screen = getTuiScreenDefinition(focus.screenId);
+    const cardWidth = normalizeInkTuiWidth(width);
+    return (_jsxs(Box, { flexDirection: "column", width: cardWidth, paddingX: 1, paddingY: 1, children: [_jsx(TuiHeader, { title: screen.title, subtitle: subtitle ?? subtitleForScreen(screen), project: project }), summaryItems.length === 0 ? null : _jsx(TuiSummaryBar, { items: summaryItems }), _jsx(Box, { marginTop: 1, children: focus.helpOpen ? _jsx(TuiHelpOverlay, { screen: screen }) : children }), _jsx(TuiFooter, { text: screen.footer })] }));
+}
+function subtitleForScreen(screen) {
+    if (screen.id === 'unavailable')
+        return `Requested screen '${screen.requestedId}' is unavailable · safe read-only state`;
+    return `${screen.title} cockpit · read-only`;
+}

package/dist/interfaces/cli/tui/ink/components.js

@@ -0,0 +1,38 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { colorForTone, inkTuiTheme } from './theme.js';
+export function TuiHeader({ title, subtitle, project }) {
+    return (_jsxs(Box, { borderStyle: "round", borderColor: colorForTone('info'), paddingX: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsxs(Text, { bold: true, color: colorForTone('info'), children: [inkTuiTheme.symbols.brand, " ", title] }), _jsx(Text, { children: " " }), _jsx(TuiBadge, { label: inkTuiTheme.copy.readOnlyBadge, tone: "warning" }), _jsx(Text, { children: " " }), _jsx(TuiBadge, { label: inkTuiTheme.copy.previewOnlyBadge, tone: "warning" })] }), _jsxs(Text, { color: colorForTone('neutral'), children: [subtitle, " \u00B7 ", project] })] }));
+}
+export function TuiTabs({ items, selectedKey }) {
+    return (_jsx(Box, { marginTop: 1, gap: 2, children: items.map((item) => {
+            const selected = item.key === selectedKey;
+            return (_jsxs(Text, { color: selected ? colorForTone('info') : colorForTone('neutral'), bold: selected, children: [selected ? inkTuiTheme.symbols.selected : inkTuiTheme.symbols.unselected, " ", item.label] }, item.key));
+        }) }));
+}
+export function TuiSummaryBar({ items }) {
+    return (_jsx(Box, { marginTop: 1, gap: 1, children: items.map((item) => {
+            const tone = item.tone ?? 'neutral';
+            const color = colorForTone(tone);
+            return (_jsxs(Box, { borderStyle: "single", borderColor: color, paddingX: 1, flexDirection: "column", children: [_jsx(Text, { color: color, bold: true, children: item.value }), _jsx(Text, { color: colorForTone('neutral'), children: item.label })] }, `${item.label}:${item.value}`));
+        }) }));
+}
+export function TuiCard({ title, badge, tone = 'info', lines, children }) {
+    const color = colorForTone(tone);
+    return (_jsxs(Box, { borderStyle: "round", borderColor: color, paddingX: 1, flexDirection: "column", width: "100%", children: [_jsxs(Text, { bold: true, color: color, children: [title, badge === undefined ? '' : ` [${badge}]`] }), (lines ?? []).map((line, index) => (line.length === 0 ? _jsx(Text, { children: " " }, lineKey(line, index)) : _jsx(Text, { children: line }, lineKey(line, index)))), children] }));
+}
+export function TuiFooter({ text }) {
+    return (_jsx(Box, { marginTop: 1, borderStyle: "single", borderColor: colorForTone('neutral'), paddingX: 1, children: _jsx(Text, { color: colorForTone('neutral'), children: text }) }));
+}
+export function TuiBadge({ label, tone }) {
+    return _jsxs(Text, { color: colorForTone(tone), children: ["[", label, "]"] });
+}
+export function TuiFocusedLine({ label, focused }) {
+    if (focused) {
+        return (_jsxs(Text, { color: colorForTone('info'), bold: true, children: [inkTuiTheme.symbols.selected, " ", label] }));
+    }
+    return _jsxs(Text, { children: [" ", label] });
+}
+function lineKey(line, index) {
+    return `${index}:${line}`;
+}

package/dist/interfaces/cli/tui/ink/help-overlay.js

@@ -0,0 +1,6 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { colorForTone } from './theme.js';
+export function TuiHelpOverlay({ screen }) {
+    return (_jsxs(Box, { borderStyle: "round", borderColor: colorForTone('info'), paddingX: 1, flexDirection: "column", children: [_jsxs(Text, { bold: true, color: colorForTone('info'), children: ["Help \u00B7 ", screen.title] }), _jsx(Text, { children: "Read-only milestone: keys inspect local views only; no mutating setup, SDD, run, approval, git, package, or provider operations are exposed." }), screen.help.map((binding) => (_jsxs(Text, { children: [binding.key, " \u2014 ", binding.label] }, `${binding.scope}:${binding.key}:${binding.intent}`))), _jsxs(Text, { color: colorForTone('neutral'), children: ["Safety: ", screen.safety] })] }));
+}

package/dist/interfaces/cli/tui/ink/state-components.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { TuiCard } from './components.js';
+import { colorForTone } from './theme.js';
+export function TuiEmptyState(props) {
+    return _jsx(TuiSafeStateCard, { ...props, badge: "empty", tone: "neutral" });
+}
+export function TuiLoadingState(props) {
+    return _jsx(TuiSafeStateCard, { ...props, badge: "loading", tone: "info" });
+}
+export function TuiErrorState(props) {
+    return _jsx(TuiSafeStateCard, { ...props, badge: "unavailable", tone: "warning" });
+}
+export function TuiReadOnlyState(props) {
+    return _jsx(TuiSafeStateCard, { ...props, badge: "read-only", tone: "info" });
+}
+export function TuiGatedState(props) {
+    return _jsx(TuiSafeStateCard, { ...props, badge: "gated", tone: "warning" });
+}
+function TuiSafeStateCard({ title, message, details = [], badge, tone }) {
+    return (_jsxs(TuiCard, { title: title, badge: badge, tone: tone, children: [_jsx(Text, { children: message }), _jsx(Text, { color: colorForTone('neutral'), children: "No active mutation action is available from this TUI state." }), details.length === 0 ? null : (_jsx(Box, { flexDirection: "column", marginTop: 1, children: details.map((detail) => (_jsxs(Text, { children: ["- ", detail] }, detail))) }))] }));
+}

package/dist/interfaces/cli/tui/ink/theme.js

@@ -0,0 +1,36 @@
+export const inkTuiTheme = {
+    app: {
+        minWidth: 60,
+        maxWidth: 88,
+    },
+    colors: {
+        neutral: 'gray',
+        info: 'cyan',
+        success: 'green',
+        warning: 'yellow',
+        danger: 'red',
+    },
+    symbols: {
+        brand: '◆',
+        selected: '›',
+        unselected: ' ',
+    },
+    copy: {
+        homeTitle: 'VGXNESS Home',
+        homeSubtitle: 'Local-first control plane · read-only cockpit',
+        setupTitle: 'VGXNESS Setup',
+        setupSubtitle: 'Modern setup cockpit · provider-safe preview',
+        readOnlyBadge: 'read-only',
+        previewOnlyBadge: 'preview-only',
+        keyboardHelp: 'Keys: ↑/↓ or j/k move · Enter continue/select · Tab/Shift+Tab next/back · Esc/q cancel · ? help',
+        actionHelp: 'Action help: Enter/Space preview confirmation · ↑/↓ choose action · Tab changes tab · q exits',
+        readOnlyConfirmation: 'This TUI is read-only and did not apply the action.',
+        manualApplyCommand: 'Run manually after review: vgxness setup apply --yes',
+    },
+};
+export function colorForTone(tone) {
+    return inkTuiTheme.colors[tone];
+}
+export function normalizeInkTuiWidth(width) {
+    return Math.max(inkTuiTheme.app.minWidth, Math.min(width, inkTuiTheme.app.maxWidth));
+}

package/dist/interfaces/cli/tui/key-intents.js

@@ -0,0 +1,33 @@
+export const globalReadOnlyKeyBindings = [
+    { key: '↑/k', intent: 'move-up', label: 'Move focus up', scope: 'global' },
+    { key: '↓/j', intent: 'move-down', label: 'Move focus down', scope: 'global' },
+    { key: 'Tab', intent: 'next', label: 'Next focus item', scope: 'global' },
+    { key: 'Shift+Tab', intent: 'previous', label: 'Previous focus item', scope: 'global' },
+    { key: 'Enter', intent: 'activate', label: 'Open read-only detail', scope: 'global' },
+    { key: 'Esc', intent: 'back', label: 'Close help or go back', scope: 'global' },
+    { key: '?', intent: 'toggle-help', label: 'Toggle help', scope: 'global' },
+    { key: 'q', intent: 'quit', label: 'Request exit', scope: 'global' },
+];
+export function keyIntentFromInput(input) {
+    if (input === '\u001B[A' || input === 'k')
+        return 'move-up';
+    if (input === '\u001B[B' || input === 'j')
+        return 'move-down';
+    if (input === '\t')
+        return 'next';
+    if (input === '\u001B[Z')
+        return 'previous';
+    if (input === '\r' || input === '\n')
+        return 'activate';
+    if (input === '\u001B')
+        return 'back';
+    if (input === '?')
+        return 'toggle-help';
+    if (input === 'q')
+        return 'quit';
+    return 'unknown';
+}
+export function footerTextForBindings(bindings = globalReadOnlyKeyBindings) {
+    const labels = bindings.map((binding) => `${binding.key} ${binding.label.toLowerCase()}`);
+    return `Keys: ${labels.join(' · ')} · read-only`;
+}

package/dist/interfaces/cli/tui/keymap.js

@@ -0,0 +1,20 @@
+export const setupTuiKeyboardHelp = 'Keys: ↑/↓ or j/k move · Enter continue/select · Tab/Shift+Tab next/back · Esc/q cancel · ? help';
+export function navigationIntentFromInput(input) {
+    if (input === '\u001B[A' || input === 'k')
+        return 'up';
+    if (input === '\u001B[B' || input === 'j')
+        return 'down';
+    if (input === '\r' || input === '\n')
+        return 'next';
+    if (input === '\t')
+        return 'next';
+    if (input === '\u001B[Z')
+        return 'back';
+    if (input === '\u001B' || input === 'q')
+        return 'cancel';
+    if (input === '?' || input === 'h')
+        return 'help';
+    if (input === ' ')
+        return 'select';
+    return undefined;
+}

package/dist/interfaces/cli/tui/navigation.js

@@ -0,0 +1,10 @@
+export function moveIndex(current, delta, length) {
+    if (length <= 0)
+        return 0;
+    return Math.max(0, Math.min(current + delta, length - 1));
+}
+export function nextItem(items, current, delta) {
+    const index = items.indexOf(current);
+    const nextIndex = moveIndex(index < 0 ? 0 : index, delta, items.length);
+    return items[nextIndex] ?? current;
+}

package/dist/interfaces/cli/tui/screen-registry.js

@@ -0,0 +1,43 @@
+import { footerTextForBindings, globalReadOnlyKeyBindings } from './key-intents.js';
+const screenDefinitions = [
+    screen('home', 'Home', 'setup-plan', ['Setup readiness', 'Runs summary', 'SDD summary', 'Provider status']),
+    screen('runs', 'Runs', 'runs-read-model', ['Recent runs', 'Interrupted runs', 'Selected run detail']),
+    screen('sdd', 'SDD', 'sdd-read-model', ['Phase status', 'Human acceptance', 'Next guidance']),
+    screen('setup', 'Setup', 'setup-plan', ['Preview status', 'Conflicts', 'Future confirmation requirements']),
+    screen('doctor', 'Doctor', 'doctor-plan', ['Provider health', 'Config diagnostics', 'Safe recovery guidance']),
+    screen('provider', 'Provider', 'provider-plan', ['Provider adapter', 'Expected config', 'Preview-only plan']),
+];
+export const registeredTuiScreens = screenDefinitions;
+export function getTuiScreenDefinition(id) {
+    const definition = screenDefinitions.find((screenDefinition) => screenDefinition.id === id);
+    if (definition !== undefined)
+        return definition;
+    return {
+        id: 'unavailable',
+        requestedId: id,
+        title: 'Unavailable screen',
+        help: globalReadOnlyKeyBindings,
+        footer: footerTextForBindings(),
+        sections: [{ id: 'safe-state', title: 'Safe unavailable state' }],
+        readModelRequirement: 'none',
+        safety: 'read-only',
+        state: 'unavailable',
+    };
+}
+function screen(id, title, readModelRequirement, sectionTitles) {
+    return {
+        id,
+        title,
+        help: globalReadOnlyKeyBindings,
+        footer: footerTextForBindings(),
+        sections: sectionTitles.map((sectionTitle) => ({
+            id: sectionTitle
+                .toLowerCase()
+                .replaceAll(/[^a-z0-9]+/g, '-')
+                .replace(/^-|-$/g, ''),
+            title: sectionTitle,
+        })),
+        readModelRequirement,
+        safety: 'read-only',
+    };
+}

package/dist/interfaces/cli/tui/terminal-capabilities.js

@@ -0,0 +1,12 @@
+export function detectTerminalCapabilities(input, output) {
+    return {
+        interactive: input?.isTTY === true && output?.isTTY === true,
+        supportsRawMode: input?.setRawMode !== undefined,
+        columns: output?.columns ?? 80,
+        rows: output?.rows ?? 24,
+    };
+}
+export function canRunInteractiveTui(input, output) {
+    const capabilities = detectTerminalCapabilities(input, output);
+    return capabilities.interactive && capabilities.supportsRawMode;
+}

package/dist/interfaces/cli/tui/tui-types.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/cli/tui/visual/badges.js

@@ -0,0 +1,19 @@
+export const tuiBadges = {
+    ready: '[Ready]',
+    blocked: '[Blocked]',
+    focused: '[Focused]',
+    selected: '[Selected]',
+    previewOnly: '[Preview-only]',
+    readOnly: '[Read-only]',
+    requiresConfirmation: '[Requires confirmation]',
+    noProviderWrites: '[No provider writes]',
+    manual: '[Manual]',
+    exit: '[Exit]',
+};
+export function badgeText(badge) {
+    return typeof badge === 'string' ? badge : badge.label;
+}
+export function formatBadges(badges) {
+    const labels = (badges ?? []).map(badgeText).filter((label) => label.length > 0);
+    return labels.length === 0 ? '' : labels.join(' ');
+}

package/dist/interfaces/cli/tui/visual/footer.js

@@ -0,0 +1,27 @@
+export function formatTuiFooter(hints, width, mode) {
+    const visibleHints = mode === 'narrow' ? prioritizeCritical(hints) : hints;
+    const footer = visibleHints.map(formatHint).join(' · ');
+    if (footer.length <= width)
+        return footer;
+    const critical = prioritizeCritical(hints);
+    const fallback = critical.map(formatHint).join(' · ');
+    if (fallback.length <= width)
+        return fallback;
+    return preserveCriticalText(fallback, width);
+}
+function prioritizeCritical(hints) {
+    const critical = hints.filter((hint) => hint.priority === 'critical' || /confirm|cancel|quit|close|exit/i.test(hint.label));
+    return critical.length === 0 ? hints.slice(0, 3) : critical;
+}
+function formatHint(hint) {
+    return `${hint.key} ${hint.label}`;
+}
+function preserveCriticalText(value, width) {
+    if (width <= 0 || value.length <= width)
+        return value;
+    const protectedPhrases = ['final confirmation', 'confirm and apply', 'requires confirmation', 'cancel', 'quit', 'exit', 'read-only'];
+    const phrase = protectedPhrases.find((candidate) => value.toLowerCase().includes(candidate));
+    if (phrase === undefined)
+        return `${value.slice(0, Math.max(0, width - 1)).trim()}…`;
+    return `${value.slice(0, Math.max(0, width - phrase.length - 5)).trim()} ... ${phrase}`.trim();
+}

package/dist/interfaces/cli/tui/visual/index.js

@@ -0,0 +1,3 @@
+export * from './badges.js';
+export * from './footer.js';
+export * from './viewport.js';

package/dist/interfaces/cli/tui/visual/viewport.js

@@ -0,0 +1,11 @@
+export function viewportModeForWidth(width) {
+    if (width < 72)
+        return 'narrow';
+    if (width >= 120)
+        return 'wide';
+    return 'standard';
+}
+export function createTuiViewport(width, fallback = 80) {
+    const normalized = width === undefined || !Number.isFinite(width) ? fallback : Math.max(40, Math.floor(width));
+    return { width: normalized, mode: viewportModeForWidth(normalized) };
+}

package/dist/interfaces/cli/tui-render-helpers.js

@@ -0,0 +1,200 @@
+export const DEFAULT_TUI_WIDTH = 100;
+export const MIN_TUI_WIDTH = 40;
+const knownBadges = new Set([
+    'ready',
+    'deferred',
+    'blocked',
+    'loading',
+    'error',
+    'empty',
+    'external',
+    'mutating',
+    'no tui writes',
+    'no provider writes',
+    'writes provider config',
+    'requires confirmation',
+    'available',
+    'preview-only',
+    'manual',
+    'coming-soon',
+    'unsupported',
+    'ready-without-project',
+    'project-required',
+]);
+export function normalizeRenderWidth(width) {
+    if (width === undefined || !Number.isFinite(width))
+        return DEFAULT_TUI_WIDTH;
+    return Math.max(MIN_TUI_WIDTH, Math.floor(width));
+}
+export function stripAnsi(value) {
+    return value.replace(/\u001B\[[0-?]*[ -/]*[@-~]/g, '');
+}
+export function visibleLength(value) {
+    return stripAnsi(value).length;
+}
+export function badge(value, options = {}) {
+    const normalized = value
+        .trim()
+        .replace(/[_\s]+/g, ' ')
+        .toLowerCase();
+    if (normalized.length === 0)
+        return styleBadge('[unknown]', 'unknown', options);
+    if (knownBadges.has(normalized)) {
+        const label = normalized === 'no tui writes' ? 'no TUI writes' : normalized;
+        return styleBadge(`[${label}]`, normalized, options);
+    }
+    return styleBadge(`[unknown: ${normalized}]`, 'unknown', options);
+}
+export function wrapText(text, options = {}) {
+    const width = normalizeRenderWidth(options.width);
+    const indent = options.indent ?? '';
+    const hangingIndent = options.hangingIndent ?? indent;
+    const firstAvailable = Math.max(1, width - visibleLength(indent));
+    const hangingAvailable = Math.max(1, width - visibleLength(hangingIndent));
+    const words = text.trim().length === 0 ? [''] : text.trim().split(/\s+/);
+    const lines = [];
+    let currentIndent = indent;
+    let available = firstAvailable;
+    let current = '';
+    for (const word of words) {
+        if (current.length === 0) {
+            current = word;
+            continue;
+        }
+        if (visibleLength(`${current} ${word}`) <= available) {
+            current = `${current} ${word}`;
+            continue;
+        }
+        lines.push(`${currentIndent}${current}`);
+        currentIndent = hangingIndent;
+        available = hangingAvailable;
+        current = word;
+    }
+    lines.push(`${currentIndent}${current}`);
+    return lines;
+}
+export function renderPanel(title, bodyLines, options = {}) {
+    const width = normalizeRenderWidth(options.width);
+    const contentWidth = Math.max(1, width - 4);
+    const status = options.status === undefined ? '' : ` ${badge(options.status, options)}`;
+    const titleText = ansi(options, 'title', `${title}${status}`);
+    const top = borderedTop(titleText, width, options);
+    const body = bodyLines.flatMap((line) => line.split('\n')).flatMap((line) => wrapPanelLine(styleKnownBadges(line, options), contentWidth, options));
+    const footer = (options.footerLines ?? []).flatMap((line) => wrapPanelLine(styleKnownBadges(line, options), contentWidth, options));
+    return [top, ...[...body, ...footer].map((line) => borderedBody(line, width, options)), borderedBottom(width, options)];
+}
+export function styleFocusedRow(value, options = {}) {
+    return ansi(options, 'highlight', value);
+}
+export function renderTabRow(items, options = {}) {
+    const width = normalizeRenderWidth(options.width);
+    const tokens = items.map((item) => renderTabToken(item, options));
+    return wrapTokens('Tabs:', tokens, width);
+}
+function renderTabToken(item, options) {
+    if (item.selected && item.focused === true)
+        return ansi(options, 'highlight', `› [${item.key}] ${item.label} [selected] [focused]`);
+    if (item.selected)
+        return ansi(options, 'highlight', `› [${item.key}] ${item.label} [selected]`);
+    if (item.focused === true)
+        return ansi(options, 'focus', `» [${item.key}] ${item.label} [focused]`);
+    return ansi(options, 'dim', `[${item.key}] ${item.label}`);
+}
+export function renderFooterGroups(groups, options = {}) {
+    const width = normalizeRenderWidth(options.width);
+    const lines = [];
+    for (const group of groups) {
+        lines.push(...wrapTokens(`${group.label}:`, group.items, width));
+    }
+    return lines;
+}
+export function renderActionLine(label, options = {}) {
+    const labels = (options.labels ?? []).map((value) => badge(value)).join(' ');
+    const primary = `- ${label}${labels.length === 0 ? '' : ` ${labels}`}`;
+    return [
+        ...wrapText(primary, options),
+        ...(options.description === undefined ? [] : wrapText(options.description, { ...options, indent: '  ', hangingIndent: '  ' })),
+        ...(options.command === undefined || options.command.length === 0
+            ? []
+            : wrapText(`Command: ${options.command.join(' ')}`, { ...options, indent: '  ', hangingIndent: '  ' })),
+    ];
+}
+export function joinSections(sections) {
+    return sections
+        .map((section) => (typeof section === 'string' || section === undefined ? section?.trim() : section.join('\n').trim()))
+        .filter((section) => section !== undefined && section.length > 0)
+        .join('\n\n');
+}
+function wrapTokens(prefix, tokens, width) {
+    const lines = [];
+    let current = prefix;
+    for (const token of tokens) {
+        const separator = current === prefix ? ' ' : ' · ';
+        const candidate = `${current}${separator}${token}`;
+        if (visibleLength(candidate) <= width || current === prefix) {
+            current = candidate;
+            continue;
+        }
+        lines.push(current);
+        current = `${' '.repeat(prefix.length)} ${token}`;
+    }
+    lines.push(current);
+    return lines;
+}
+function wrapPanelLine(line, contentWidth, options) {
+    if (visibleLength(line) <= contentWidth)
+        return [line];
+    return wrapText(line, { ...options, width: contentWidth });
+}
+function borderedTop(title, width, options) {
+    const prefix = `┌─ ${title} `;
+    return `${ansi(options, 'border', prefix)}${ansi(options, 'border', '─'.repeat(Math.max(0, width - visibleLength(prefix) - 1)))}${ansi(options, 'border', '┐')}`;
+}
+function borderedBody(line, width, options) {
+    const padded = `${line}${' '.repeat(Math.max(0, width - visibleLength(line) - 4))}`;
+    return `${ansi(options, 'border', '│')} ${padded} ${ansi(options, 'border', '│')}`;
+}
+function borderedBottom(width, options) {
+    return ansi(options, 'border', `└${'─'.repeat(Math.max(0, width - 2))}┘`);
+}
+function styleKnownBadges(line, options) {
+    if (options.style !== 'ansi')
+        return line;
+    return line.replace(/\[([^\]]+)\]/g, (match, raw) => {
+        const normalized = raw
+            .trim()
+            .replace(/[_\s]+/g, ' ')
+            .toLowerCase();
+        return knownBadges.has(normalized) ? styleBadge(match, normalized, options) : match;
+    });
+}
+function styleBadge(value, status, options) {
+    if (options.style !== 'ansi')
+        return value;
+    if (['ready', 'available', 'ready-without-project'].includes(status))
+        return ansi(options, 'green', value);
+    if (['blocked', 'error', 'mutating', 'writes provider config'].includes(status))
+        return ansi(options, 'red', value);
+    if (['deferred', 'loading', 'manual', 'requires confirmation', 'preview-only', 'coming-soon', 'project-required'].includes(status))
+        return ansi(options, 'yellow', value);
+    if (['external', 'no tui writes', 'no provider writes'].includes(status))
+        return ansi(options, 'cyan', value);
+    return ansi(options, 'dim', value);
+}
+function ansi(options, role, value) {
+    if (options.style !== 'ansi')
+        return value;
+    const codes = {
+        bold: '1',
+        title: '1;96',
+        dim: '2',
+        highlight: '1;7;36',
+        focus: '1;36',
+        border: '36',
+        green: '32',
+        red: '31',
+        yellow: '33',
+        cyan: '36',
+    };
+    return `\u001B[${codes[role]}m${value}\u001B[0m`;
+}

package/dist/interfaces/cli/verification-plan-renderer.js

@@ -0,0 +1,25 @@
+export function renderVerificationPlan(plan) {
+    const lines = [
+        'Verification plan',
+        `Type: ${plan.selectedChangeType}`,
+        '',
+        'Recommendations:',
+        ...plan.recommendations.map((recommendation) => {
+            const safety = recommendation.classification === 'allowlisted-command' ? `allowlisted: ${recommendation.commandId}` : 'manual/copy-only';
+            const script = recommendation.packageScript === undefined ? '' : ` (${recommendation.packageScript})`;
+            return `${recommendation.order}. ${recommendation.title} — ${safety}${script}. ${recommendation.description}`;
+        }),
+        '',
+        'Manual checks:',
+        ...plan.manualChecks.map((check) => `${check.order}. ${check.title} — ${check.description}`),
+        '',
+        'Rationale:',
+        ...plan.rationale.map((reason) => `- ${reason}`),
+        '',
+        'Safety:',
+        '- Read-only plan; commands are not executed.',
+        '- Provider config is not written; verification results are not persisted.',
+        '- SDD artifacts and human acceptance are not mutated or inferred.',
+    ];
+    return `${lines.join('\n')}\n`;
+}

package/dist/interfaces/cli/verification-report-renderer.js

@@ -0,0 +1,19 @@
+import { normalizeSddArtifact } from '../../sdd/schema.js';
+export function renderVerificationReportArtifact(input) {
+    const normalized = normalizeSddArtifact(input.artifact);
+    const lines = [
+        'Verification report artifact',
+        `Project: ${input.project}`,
+        `Change: ${input.change}`,
+        `Topic key: ${input.artifact.topicKey}`,
+        `Artifact ID: ${input.artifact.id}`,
+        `State: ${normalized.metadata.status}`,
+        `Accepted: ${normalized.metadata.status === 'accepted' ? 'yes' : 'no'}`,
+        '',
+        'Safety: manual file-only report; no commands were executed and acceptance is not inferred.',
+        '',
+        '--- Content ---',
+        input.artifact.content,
+    ];
+    return `${lines.join('\n')}\n`;
+}

package/dist/interfaces/mcp/contracts/agents.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/mcp/contracts/context.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/mcp/contracts/governance.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/mcp/contracts/index.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/mcp/contracts/memory.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/mcp/contracts/providers.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/mcp/contracts/runs.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/mcp/contracts/sdd.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/mcp/contracts/sessions.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/mcp/contracts/skills.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/mcp/contracts/verification.js

@@ -0,0 +1 @@
+export {};