@spekn/cli 1.0.0

package/dist/tui/keymap/use-global-keymap.d.ts

@@ -0,0 +1,19 @@
+import type { NavItemPolicy, TuiScreenId } from '../types';
+interface KeymapOptions {
+    screen: TuiScreenId;
+    navPolicy: NavItemPolicy[];
+    commandMode: boolean;
+    showHelp: boolean;
+    onNavigate: (screen: TuiScreenId) => void;
+    onHelpToggle: () => void;
+    onSearchToggle: () => void;
+    onSearchClear: () => void;
+    onCommandModeToggle: (value: boolean) => void;
+    onRefresh: () => void;
+    onExportPreview: () => void;
+    onExportGenerate: () => void;
+    onBridgeStart: () => void;
+    onBridgeStop: () => void;
+}
+export declare function useGlobalKeymap(options: KeymapOptions): void;
+export {};

package/dist/tui/keymap/use-global-keymap.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useGlobalKeymap = useGlobalKeymap;
+const ink_1 = require("ink");
+const nav_items_1 = require("../navigation/nav-items");
+function useGlobalKeymap(options) {
+    (0, ink_1.useInput)((input, key) => {
+        // In command mode, TextInput handles all keystrokes — only handle escape
+        if (options.commandMode) {
+            if (key.escape) {
+                options.onCommandModeToggle(false);
+            }
+            return;
+        }
+        if (key.ctrl && input === 'c') {
+            process.exit(0);
+            return;
+        }
+        if (input === '?') {
+            options.onHelpToggle();
+            return;
+        }
+        if (input === ':') {
+            options.onCommandModeToggle(true);
+            return;
+        }
+        if (input === '/') {
+            options.onSearchToggle();
+            return;
+        }
+        if (key.escape) {
+            options.onSearchClear();
+            return;
+        }
+        if (input === 'j' || key.downArrow) {
+            options.onNavigate((0, nav_items_1.nextScreen)(options.screen, options.navPolicy));
+            return;
+        }
+        if (input === 'k' || key.upArrow) {
+            options.onNavigate((0, nav_items_1.previousScreen)(options.screen, options.navPolicy));
+            return;
+        }
+        if (input === 'h' || key.leftArrow) {
+            options.onNavigate((0, nav_items_1.previousScreen)(options.screen, options.navPolicy));
+            return;
+        }
+        if (input === 'l' || key.rightArrow) {
+            options.onNavigate((0, nav_items_1.nextScreen)(options.screen, options.navPolicy));
+            return;
+        }
+        if (input === 'r') {
+            options.onRefresh();
+            return;
+        }
+        if (options.screen === 'export' && input === 'p') {
+            options.onExportPreview();
+            return;
+        }
+        if (options.screen === 'export' && input === 'g') {
+            options.onExportGenerate();
+            return;
+        }
+        if (options.screen === 'bridge' && input === 's') {
+            options.onBridgeStart();
+            return;
+        }
+        if (options.screen === 'bridge' && input === 'x') {
+            options.onBridgeStop();
+            return;
+        }
+        if (input === '1')
+            options.onNavigate('home');
+        if (input === '2')
+            options.onNavigate('specs');
+        if (input === '3')
+            options.onNavigate('export');
+        if (input === '4')
+            options.onNavigate('decisions');
+        if (input === '5')
+            options.onNavigate('bridge');
+    });
+}

package/dist/tui/navigation/nav-items.d.ts

@@ -0,0 +1,3 @@
+import type { NavItemPolicy, TuiScreenId } from '../types';
+export declare function nextScreen(current: TuiScreenId, items: NavItemPolicy[]): TuiScreenId;
+export declare function previousScreen(current: TuiScreenId, items: NavItemPolicy[]): TuiScreenId;

package/dist/tui/navigation/nav-items.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nextScreen = nextScreen;
+exports.previousScreen = previousScreen;
+function nextScreen(current, items) {
+    const index = items.findIndex((item) => item.id === current);
+    if (index === -1 || items.length === 0)
+        return 'home';
+    const target = items[(index + 1) % items.length];
+    return target?.id ?? 'home';
+}
+function previousScreen(current, items) {
+    const index = items.findIndex((item) => item.id === current);
+    if (index === -1 || items.length === 0)
+        return 'home';
+    const target = items[(index - 1 + items.length) % items.length];
+    return target?.id ?? 'home';
+}

package/dist/tui/screens/bridge.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { TuiState } from '../state/use-app-state';
+interface BridgeScreenProps {
+    state: TuiState;
+    onBridgeStop?: () => void;
+}
+export declare function BridgeScreen({ state, onBridgeStop }: BridgeScreenProps): React.JSX.Element;
+export {};

package/dist/tui/screens/bridge.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BridgeScreen = BridgeScreen;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const ink_1 = require("ink");
+const ui_1 = require("@inkjs/ui");
+function BridgeScreen({ state, onBridgeStop }) {
+    const [confirmingStop, setConfirmingStop] = (0, react_1.useState)(false);
+    if (state.loading) {
+        return (0, jsx_runtime_1.jsx)(ui_1.Spinner, { label: "Checking bridge health..." });
+    }
+    return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { bold: true, children: "Local Bridge" }), (0, jsx_runtime_1.jsxs)(ink_1.Text, { children: ["Feature flag: ", state.bridge?.featureEnabled ? 'enabled' : 'disabled'] }), (0, jsx_runtime_1.jsxs)(ink_1.Text, { children: ["Cloud connected devices: ", state.bridge?.connectedDevices ?? 0] }), (0, jsx_runtime_1.jsxs)(ink_1.Text, { children: ["Cloud auth failures: ", state.bridge?.authFailures ?? 0] }), (0, jsx_runtime_1.jsxs)(ink_1.Box, { marginTop: 1, flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { bold: true, children: "Local Runtime" }), state.localBridge?.running ? ((0, jsx_runtime_1.jsxs)(ui_1.StatusMessage, { variant: "success", children: ["Running on port ", state.localBridge.port] })) : ((0, jsx_runtime_1.jsx)(ui_1.StatusMessage, { variant: "error", children: "Stopped" })), (0, jsx_runtime_1.jsxs)(ink_1.Text, { children: ["Paired: ", state.localBridge?.paired ? 'yes' : 'no'] }), (0, jsx_runtime_1.jsxs)(ink_1.Text, { children: ["Uptime: ", state.localBridge?.uptimeSec ?? 0, "s"] })] }), (0, jsx_runtime_1.jsxs)(ink_1.Box, { marginTop: 1, flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { bold: true, children: "Actions" }), confirmingStop ? ((0, jsx_runtime_1.jsxs)(ink_1.Box, { gap: 1, children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { children: "Stop the bridge?" }), (0, jsx_runtime_1.jsx)(ui_1.ConfirmInput, { onConfirm: () => {
+                                    setConfirmingStop(false);
+                                    onBridgeStop?.();
+                                }, onCancel: () => {
+                                    setConfirmingStop(false);
+                                } })] })) : ((0, jsx_runtime_1.jsx)(ink_1.Text, { color: "gray", children: "s=start (detached), x=stop signal, r=refresh" }))] }), (0, jsx_runtime_1.jsxs)(ink_1.Box, { marginTop: 1, flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { bold: true, children: "Registered Devices" }), (state.bridge?.devices ?? []).slice(0, 7).map((device) => ((0, jsx_runtime_1.jsxs)(ink_1.Text, { children: ["- ", device.name, " ", (0, jsx_runtime_1.jsx)(ui_1.Badge, { color: device.status === 'online' ? 'green' : device.status === 'error' ? 'red' : 'yellow', children: device.status }), " ", device.isDefault ? '(default)' : ''] }, device.id)))] })] }));
+}

package/dist/tui/screens/decisions.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { TuiState } from '../state/use-app-state';
+export declare function DecisionsScreen({ state }: {
+    state: TuiState;
+}): React.JSX.Element;

package/dist/tui/screens/decisions.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DecisionsScreen = DecisionsScreen;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const ink_1 = require("ink");
+const ui_1 = require("@inkjs/ui");
+function statusBadgeColor(status) {
+    if (status === 'approved')
+        return 'green';
+    if (status === 'pending')
+        return 'yellow';
+    if (status === 'rejected')
+        return 'red';
+    return 'blue';
+}
+function filterItems(items, query) {
+    if (!query.trim())
+        return items;
+    const normalized = query.trim().toLowerCase();
+    return items.filter((item) => item.title.toLowerCase().includes(normalized));
+}
+function DecisionsScreen({ state }) {
+    if (state.loading) {
+        return (0, jsx_runtime_1.jsx)(ui_1.Spinner, { label: "Loading decisions..." });
+    }
+    const decisions = filterItems(state.decisions, state.searchQuery).slice(0, 7);
+    return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { bold: true, children: "Decision Log" }), decisions.length === 0 ? ((0, jsx_runtime_1.jsx)(ink_1.Text, { color: "gray", children: "No decisions in current view." })) : ((0, jsx_runtime_1.jsx)(ui_1.UnorderedList, { children: decisions.map((decision, index) => ((0, jsx_runtime_1.jsx)(ui_1.UnorderedList.Item, { children: (0, jsx_runtime_1.jsxs)(ink_1.Text, { color: index === 0 ? 'green' : undefined, children: [decision.title, " ", (0, jsx_runtime_1.jsx)(ui_1.Badge, { color: statusBadgeColor(decision.status), children: decision.status }), " (", decision.decisionType, ") ", decision.specAnchor ? `@${decision.specAnchor}` : ''] }) }, decision.id))) })), (0, jsx_runtime_1.jsxs)(ink_1.Box, { marginTop: 1, flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { bold: true, children: "Role-aware Actions" }), state.boot?.role === 'viewer' ? ((0, jsx_runtime_1.jsx)(ink_1.Text, { color: "yellow", children: "Viewer role: read-only. Approvals disabled." })) : ((0, jsx_runtime_1.jsx)(ink_1.Text, { color: "gray", children: "Use command palette: :approve DECISION_ID or :reject DECISION_ID" }))] })] }));
+}

package/dist/tui/screens/export.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { TuiState } from '../state/use-app-state';
+export declare function ExportScreen({ state }: {
+    state: TuiState;
+}): React.JSX.Element;

package/dist/tui/screens/export.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExportScreen = ExportScreen;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const ink_1 = require("ink");
+const ui_1 = require("@inkjs/ui");
+function ExportScreen({ state }) {
+    if (state.loading) {
+        return (0, jsx_runtime_1.jsx)(ui_1.Spinner, { label: "Loading export..." });
+    }
+    const preview = state.exportPreview;
+    return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { bold: true, children: "Context Export" }), (0, jsx_runtime_1.jsxs)(ink_1.Text, { children: ["Format: ", state.exportFormat] }), (0, jsx_runtime_1.jsx)(ink_1.Text, { color: "gray", children: "Commands: p=preview, g=generate, :=run command palette" }), (0, jsx_runtime_1.jsxs)(ink_1.Box, { marginTop: 1, flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { bold: true, children: "Summary" }), (0, jsx_runtime_1.jsxs)(ink_1.Text, { children: ["Anchors: ", preview?.anchorCount ?? 0] }), (0, jsx_runtime_1.jsxs)(ink_1.Text, { children: ["Spec version: ", preview?.specVersion ?? 'n/a'] }), preview?.warnings?.length ? ((0, jsx_runtime_1.jsxs)(ui_1.StatusMessage, { variant: "warning", children: ["Warnings: ", preview.warnings.join('; ')] })) : ((0, jsx_runtime_1.jsx)(ink_1.Text, { children: "Warnings: none" }))] }), state.statusLine.includes('generated') || state.statusLine.includes('Export generated') ? ((0, jsx_runtime_1.jsx)(ink_1.Box, { marginTop: 1, children: (0, jsx_runtime_1.jsx)(ui_1.StatusMessage, { variant: "success", children: "Export generated successfully" }) })) : state.statusLine.includes('failed') ? ((0, jsx_runtime_1.jsx)(ink_1.Box, { marginTop: 1, children: (0, jsx_runtime_1.jsx)(ui_1.StatusMessage, { variant: "error", children: "Export generation failed" }) })) : null, (0, jsx_runtime_1.jsxs)(ink_1.Box, { marginTop: 1, flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { bold: true, children: "Preview (first 12 lines)" }), preview ? (preview.content
+                        .split('\n')
+                        .slice(0, 12)
+                        .map((line, index) => ((0, jsx_runtime_1.jsx)(ink_1.Text, { children: line }, `preview-${index}`)))) : ((0, jsx_runtime_1.jsx)(ink_1.Text, { color: "gray", children: "No preview yet." }))] })] }));
+}

package/dist/tui/screens/home.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { TuiState } from '../state/use-app-state';
+export declare function HomeScreen({ state }: {
+    state: TuiState;
+}): React.JSX.Element;

package/dist/tui/screens/home.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HomeScreen = HomeScreen;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const ink_1 = require("ink");
+const ui_1 = require("@inkjs/ui");
+function nextBestAction(state) {
+    if (state.error)
+        return 'Fix authentication/context errors first';
+    if (!state.exportPreview)
+        return 'Generate context export (press 3, then g)';
+    if (state.workflow.blockedCount > 0)
+        return 'Review blocked workflow states';
+    if (!state.workflow.hasPlanningArtifacts)
+        return 'Create planning artifacts in PLAN phase';
+    if (!state.workflow.hasVerificationEvidence)
+        return 'Capture verification evidence';
+    return 'Review Decision Log and continue implementation';
+}
+function phaseVariant(state) {
+    if (state.workflow.blockedCount > 0)
+        return 'warning';
+    if (state.workflow.currentPhase)
+        return 'info';
+    return 'success';
+}
+function HomeScreen({ state }) {
+    if (state.loading) {
+        return (0, jsx_runtime_1.jsx)(ui_1.Spinner, { label: "Loading dashboard..." });
+    }
+    const action = nextBestAction(state);
+    return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { bold: true, color: "green", children: "Next Best Action" }), (0, jsx_runtime_1.jsx)(ink_1.Text, { children: action }), (0, jsx_runtime_1.jsxs)(ink_1.Box, { marginTop: 1, flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { bold: true, children: "Workflow" }), (0, jsx_runtime_1.jsxs)(ui_1.StatusMessage, { variant: phaseVariant(state), children: ["Phase: ", state.workflow.currentPhase ?? 'n/a', " | Blocked: ", state.workflow.blockedCount] })] }), (0, jsx_runtime_1.jsxs)(ink_1.Box, { marginTop: 1, flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { bold: true, children: "Unfinished Work" }), (0, jsx_runtime_1.jsxs)(ui_1.UnorderedList, { children: [(0, jsx_runtime_1.jsx)(ui_1.UnorderedList.Item, { children: (0, jsx_runtime_1.jsxs)(ink_1.Text, { children: ["Specs: ", state.specs.length] }) }), (0, jsx_runtime_1.jsx)(ui_1.UnorderedList.Item, { children: (0, jsx_runtime_1.jsxs)(ink_1.Text, { children: ["Decisions: ", state.decisions.length] }) }), (0, jsx_runtime_1.jsx)(ui_1.UnorderedList.Item, { children: (0, jsx_runtime_1.jsxs)(ink_1.Text, { children: ["Export ready: ", state.exportPreview ? 'yes' : 'no'] }) })] })] }), (0, jsx_runtime_1.jsx)(ink_1.Box, { marginTop: 1, children: (0, jsx_runtime_1.jsx)(ink_1.Text, { color: "gray", children: "Quick actions: [2] Specs  [3] Export  [4] Decisions  [5] Bridge" }) })] }));
+}

package/dist/tui/screens/locked.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { NavItemPolicy } from '../types';
+export declare function LockedScreen({ item }: {
+    item?: NavItemPolicy;
+}): React.JSX.Element;

package/dist/tui/screens/locked.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LockedScreen = LockedScreen;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const ink_1 = require("ink");
+const ui_1 = require("@inkjs/ui");
+function LockedScreen({ item }) {
+    return ((0, jsx_runtime_1.jsx)(ink_1.Box, { flexDirection: "column", children: (0, jsx_runtime_1.jsxs)(ui_1.Alert, { variant: "warning", children: [item?.label ?? 'Feature', " is locked \u2014 ", item?.reason ?? 'Upgrade required', ". ", item?.description ?? 'Higher-tier feature preview', ". This feature is visible for discoverability but unavailable on your current plan."] }) }));
+}

package/dist/tui/screens/specs.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { TuiState } from '../state/use-app-state';
+export declare function SpecsScreen({ state }: {
+    state: TuiState;
+}): React.JSX.Element;

package/dist/tui/screens/specs.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpecsScreen = SpecsScreen;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const ink_1 = require("ink");
+const ui_1 = require("@inkjs/ui");
+function statusBadgeColor(status) {
+    if (status === 'locked')
+        return 'green';
+    if (status === 'draft')
+        return 'yellow';
+    if (status === 'review')
+        return 'blue';
+    if (status === 'archived')
+        return 'red';
+    return 'yellow';
+}
+function filterItems(items, query) {
+    if (!query.trim())
+        return items;
+    const normalized = query.trim().toLowerCase();
+    return items.filter((item) => item.title.toLowerCase().includes(normalized));
+}
+function SpecsScreen({ state }) {
+    if (state.loading) {
+        return (0, jsx_runtime_1.jsx)(ui_1.Spinner, { label: "Loading specifications..." });
+    }
+    const specs = filterItems(state.specs, state.searchQuery).slice(0, 7);
+    const selected = specs[0];
+    return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", children: [(0, jsx_runtime_1.jsxs)(ink_1.Text, { bold: true, children: ["Specifications ", state.searchQuery ? `(filter: ${state.searchQuery})` : ''] }), specs.length === 0 ? ((0, jsx_runtime_1.jsx)(ink_1.Text, { color: "gray", children: "No specs in current view." })) : ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(ui_1.UnorderedList, { children: specs.map((spec, index) => ((0, jsx_runtime_1.jsx)(ui_1.UnorderedList.Item, { children: (0, jsx_runtime_1.jsxs)(ink_1.Text, { color: index === 0 ? 'green' : undefined, children: [spec.title, " ", (0, jsx_runtime_1.jsx)(ui_1.Badge, { color: statusBadgeColor(spec.status), children: spec.status }), " v", spec.version] }) }, spec.id))) }), state.specs.length > 7 ? (0, jsx_runtime_1.jsx)(ink_1.Text, { color: "gray", children: "...showing first 7 specs (Miller's law limit)" }) : null] })), (0, jsx_runtime_1.jsxs)(ink_1.Box, { marginTop: 1, flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { bold: true, children: "Anchor Detail" }), selected ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)(ink_1.Text, { children: ["ID: ", selected.id] }), (0, jsx_runtime_1.jsxs)(ink_1.Text, { children: ["Status: ", selected.status] }), (0, jsx_runtime_1.jsxs)(ink_1.Text, { children: ["Type: ", selected.type ?? 'n/a'] }), (0, jsx_runtime_1.jsxs)(ink_1.Text, { children: ["Updated: ", selected.updatedAt ?? 'n/a'] })] })) : ((0, jsx_runtime_1.jsx)(ink_1.Text, { color: "gray", children: "Select a specification to view details." }))] })] }));
+}

package/dist/tui/services/client.d.ts

@@ -0,0 +1 @@
+export declare function createApiClient(apiUrl: string, token: string, organizationId: string): any;

package/dist/tui/services/client.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createApiClient = createApiClient;
+const client_1 = require("@trpc/client");
+const trpc_url_1 = require("../../utils/trpc-url");
+function createApiClient(apiUrl, token, organizationId) {
+    return (0, client_1.createTRPCProxyClient)({
+        links: [
+            (0, client_1.httpBatchLink)({
+                url: (0, trpc_url_1.normalizeTrpcUrl)(apiUrl),
+                headers: {
+                    authorization: token ? `Bearer ${token}` : '',
+                    'x-organization-id': organizationId,
+                },
+            }),
+        ],
+    });
+}

package/dist/tui/services/context-service.d.ts

@@ -0,0 +1,19 @@
+import type { BridgeSummary, DecisionListItem, ExportFormat, ExportPreview, LocalBridgeSummary, SpecListItem, TuiBootContext, WorkflowSummary } from '../types';
+export declare class TuiContextService {
+    private readonly apiUrl;
+    private readonly credentialsStore;
+    constructor(apiUrl: string);
+    bootstrap(projectIdArg?: string): Promise<{
+        boot: TuiBootContext;
+        client: any;
+    }>;
+    loadSpecs(client: any, projectId: string): Promise<SpecListItem[]>;
+    loadDecisions(client: any, projectId: string): Promise<DecisionListItem[]>;
+    loadWorkflowSummary(client: any, projectId: string): Promise<WorkflowSummary>;
+    previewExport(client: any, projectId: string, format: ExportFormat): Promise<ExportPreview>;
+    generateExport(client: any, projectId: string, format: ExportFormat): Promise<ExportPreview>;
+    loadBridgeSummary(client: any): Promise<BridgeSummary>;
+    loadLocalBridgeSummary(): Promise<LocalBridgeSummary>;
+    startLocalBridgeDetached(): void;
+    stopLocalBridge(configPort?: number): Promise<void>;
+}

package/dist/tui/services/context-service.js

@@ -0,0 +1,246 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TuiContextService = void 0;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const shared_enums_1 = require("../shared-enums");
+const credentials_store_1 = require("../../auth/credentials-store");
+const client_1 = require("./client");
+const DEFAULT_BRIDGE_CONFIG = {
+    port: 19550,
+    pairing: null,
+};
+function loadLocalBridgeConfig() {
+    const configPath = node_path_1.default.join(node_os_1.default.homedir(), '.spekn', 'bridge', 'config.json');
+    try {
+        const raw = node_fs_1.default.readFileSync(configPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return {
+            port: typeof parsed.port === 'number' ? parsed.port : DEFAULT_BRIDGE_CONFIG.port,
+            pairing: parsed.pairing ?? DEFAULT_BRIDGE_CONFIG.pairing,
+        };
+    }
+    catch {
+        return DEFAULT_BRIDGE_CONFIG;
+    }
+}
+function decodeJwtPayload(token) {
+    try {
+        const parts = token.split('.');
+        if (parts.length !== 3)
+            return null;
+        const base64 = parts[1].replace(/-/g, '+').replace(/_/g, '/');
+        const padded = base64.padEnd(base64.length + ((4 - (base64.length % 4)) % 4), '=');
+        const json = Buffer.from(padded, 'base64').toString('utf-8');
+        return JSON.parse(json);
+    }
+    catch {
+        return null;
+    }
+}
+function normalizePlan(raw) {
+    if (raw === shared_enums_1.OrganizationPlan.PRO)
+        return shared_enums_1.OrganizationPlan.PRO;
+    if (raw === shared_enums_1.OrganizationPlan.TEAM)
+        return shared_enums_1.OrganizationPlan.TEAM;
+    if (raw === shared_enums_1.OrganizationPlan.ENTERPRISE)
+        return shared_enums_1.OrganizationPlan.ENTERPRISE;
+    return shared_enums_1.OrganizationPlan.FREE;
+}
+function normalizeRole(raw) {
+    if (raw === 'owner' || raw === 'admin' || raw === 'member' || raw === 'viewer') {
+        return raw;
+    }
+    return 'member';
+}
+class TuiContextService {
+    apiUrl;
+    credentialsStore = new credentials_store_1.CredentialsStore();
+    constructor(apiUrl) {
+        this.apiUrl = apiUrl;
+    }
+    async bootstrap(projectIdArg) {
+        const token = await this.credentialsStore.getValidToken();
+        if (!token) {
+            throw new Error('No valid credentials. Run `spekn auth login` first.');
+        }
+        const claims = decodeJwtPayload(token);
+        const permissions = Array.isArray(claims?.permissions)
+            ? claims?.permissions.filter((item) => typeof item === 'string')
+            : [];
+        const stored = this.credentialsStore.load();
+        const fallbackOrg = stored?.organizationId ?? process.env.SPEKN_ORGANIZATION_ID ?? '';
+        const bootstrapClient = (0, client_1.createApiClient)(this.apiUrl, token, fallbackOrg);
+        const orgs = await bootstrapClient.organization.list.query();
+        if (orgs.length === 0) {
+            throw new Error('No organization membership found for this account.');
+        }
+        const org = orgs.find((candidate) => candidate.id === fallbackOrg) ?? orgs[0];
+        const organizationId = org.id;
+        const client = (0, client_1.createApiClient)(this.apiUrl, token, organizationId);
+        const projects = await client.project.list.query({
+            limit: 20,
+            offset: 0,
+        });
+        if (projects.length === 0) {
+            throw new Error('No projects found for this organization. Create one in Spekn first.');
+        }
+        const project = projects.find((candidate) => candidate.id === projectIdArg) ?? projects[0];
+        return {
+            boot: {
+                apiUrl: this.apiUrl,
+                organizationId,
+                organizationName: org.name,
+                role: normalizeRole(org.role),
+                plan: normalizePlan(org.plan),
+                projectId: project.id,
+                projectName: project.name,
+                permissions,
+            },
+            client,
+        };
+    }
+    async loadSpecs(client, projectId) {
+        const specs = await client.specification.list.query({
+            projectId,
+            limit: 50,
+            offset: 0,
+        });
+        return (Array.isArray(specs) ? specs : []).map((spec) => ({
+            id: spec.id,
+            title: spec.title,
+            status: spec.status,
+            version: spec.version,
+            updatedAt: spec.updatedAt,
+            type: spec.frontmatter?.type,
+        }));
+    }
+    async loadDecisions(client, projectId) {
+        const result = await client.decision.getAll.query({
+            projectId,
+            limit: 50,
+            offset: 0,
+        });
+        const decisions = Array.isArray(result?.decisions) ? result.decisions : [];
+        return decisions.map((decision) => ({
+            id: decision.id,
+            title: decision.title,
+            status: decision.status,
+            decisionType: decision.decisionType,
+            specAnchor: decision.specAnchor,
+            createdAt: decision.createdAt,
+        }));
+    }
+    async loadWorkflowSummary(client, projectId) {
+        const states = await client.workflowState.listByProject.query({ projectId });
+        const first = Array.isArray(states) && states.length > 0 ? states[0] : null;
+        const currentPhase = first?.currentPhase ?? null;
+        const blockedCount = Array.isArray(states)
+            ? states.filter((state) => state.specificationLockStatus === 'locked').length
+            : 0;
+        return {
+            currentPhase,
+            blockedCount,
+            hasVerificationEvidence: Boolean(first?.hasVerificationEvidence),
+            hasPlanningArtifacts: Boolean(first?.hasPlanningArtifacts),
+        };
+    }
+    async previewExport(client, projectId, format) {
+        const result = await client.export.preview.query({
+            projectId,
+            formatId: format,
+        });
+        return {
+            content: String(result.content ?? ''),
+            anchorCount: Number(result.anchorCount ?? 0),
+            specVersion: typeof result.specVersion === 'string' ? result.specVersion : undefined,
+            warnings: Array.isArray(result.warnings)
+                ? result.warnings.filter((warning) => typeof warning === 'string')
+                : undefined,
+        };
+    }
+    async generateExport(client, projectId, format) {
+        const result = await client.export.generate.mutate({
+            projectId,
+            formatId: format,
+        });
+        return {
+            content: String(result.content ?? ''),
+            anchorCount: Number(result.anchorCount ?? 0),
+            specVersion: typeof result.specVersion === 'string' ? result.specVersion : undefined,
+            warnings: Array.isArray(result.warnings)
+                ? result.warnings.filter((warning) => typeof warning === 'string')
+                : undefined,
+        };
+    }
+    async loadBridgeSummary(client) {
+        const [flag, devices, metrics] = await Promise.all([
+            client.bridge.getFeatureFlag.query().catch(() => ({ enabled: false })),
+            client.bridge.listDevices.query().catch(() => []),
+            client.bridge.getMetrics.query().catch(() => ({ connectedDevices: 0, authFailures: 0 })),
+        ]);
+        return {
+            featureEnabled: Boolean(flag.enabled),
+            devices: Array.isArray(devices)
+                ? devices.map((device) => ({
+                    id: device.id,
+                    name: device.name,
+                    status: device.status,
+                    isDefault: Boolean(device.isDefault),
+                    lastSeenAt: device.lastSeenAt,
+                }))
+                : [],
+            connectedDevices: Number(metrics.connectedDevices ?? 0),
+            authFailures: Number(metrics.authFailures ?? 0),
+        };
+    }
+    async loadLocalBridgeSummary() {
+        const config = loadLocalBridgeConfig();
+        let running = false;
+        let uptimeSec;
+        try {
+            const response = await fetch(`http://127.0.0.1:${config.port}/health`);
+            if (response.ok) {
+                const payload = (await response.json());
+                running = true;
+                uptimeSec = Number(payload.uptime ?? 0);
+            }
+        }
+        catch {
+            running = false;
+        }
+        return {
+            paired: config.pairing !== null,
+            deviceId: config.pairing?.deviceId,
+            deviceName: config.pairing?.deviceName,
+            port: config.port,
+            running,
+            uptimeSec,
+        };
+    }
+    startLocalBridgeDetached() {
+        const args = [process.argv[1] ?? '', 'bridge', 'start'];
+        const child = (0, node_child_process_1.spawn)(process.execPath, args, {
+            detached: true,
+            stdio: 'ignore',
+        });
+        child.unref();
+    }
+    async stopLocalBridge(configPort) {
+        const port = configPort ?? this.bridgeConfigStore.get().port;
+        try {
+            await fetch(`http://127.0.0.1:${port}/shutdown`, {
+                method: 'POST',
+            });
+        }
+        catch {
+            // best effort; bridge may already be down
+        }
+    }
+}
+exports.TuiContextService = TuiContextService;

package/dist/tui/shared-enums.d.ts

@@ -0,0 +1,16 @@
+export declare const OrganizationPlan: {
+    readonly FREE: "free";
+    readonly PRO: "pro";
+    readonly TEAM: "team";
+    readonly ENTERPRISE: "enterprise";
+};
+export type OrganizationPlan = (typeof OrganizationPlan)[keyof typeof OrganizationPlan];
+export declare const WorkflowPhase: {
+    readonly SPECIFY: "specify";
+    readonly CLARIFY: "clarify";
+    readonly PLAN: "plan";
+    readonly IMPLEMENT: "implement";
+    readonly VERIFY: "verify";
+    readonly COMPLETE: "complete";
+};
+export type WorkflowPhase = (typeof WorkflowPhase)[keyof typeof WorkflowPhase];

package/dist/tui/shared-enums.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowPhase = exports.OrganizationPlan = void 0;
+// Keep lightweight enum values local to the TUI bundle so we don't pull
+// @spekn/shared's TypeORM-backed index into ESM runtime code.
+exports.OrganizationPlan = {
+    FREE: 'free',
+    PRO: 'pro',
+    TEAM: 'team',
+    ENTERPRISE: 'enterprise',
+};
+exports.WorkflowPhase = {
+    SPECIFY: 'specify',
+    CLARIFY: 'clarify',
+    PLAN: 'plan',
+    IMPLEMENT: 'implement',
+    VERIFY: 'verify',
+    COMPLETE: 'complete',
+};