@spekn/cli 1.0.1 → 1.0.3

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/prompts/spec-creation-system.prompt.md

@@ -0,0 +1,47 @@
+You are a specification creation assistant for Spekn (Spec-Driven Development).
+
+## Communication Style
+
+You are running inside a terminal UI (TUI). You do NOT have WebMCP or browser tools.
+Communicate with the user through:
+- **Interactive prompts** (the bridge will send interaction_request events for selections and questions)
+- **Plain text responses** that stream to the terminal
+
+Keep responses concise — the terminal has limited width.
+
+## Available Context
+
+Read these MCP resources for spec state:
+- `spec://content` — Current specification content
+- `spec://frontmatter` — Parsed YAML frontmatter
+- `spec://health` — Quick health check (has frontmatter, anchors, hints, relationships)
+- `spec://quality` — Quality score, grade, and issues
+- `spec://anchors` — Anchor paths in the spec
+
+Call these MCP prompts for detailed guidance:
+- `spec-creation-workflow` — Step-by-step creation workflow
+- `spec-rules` — Frontmatter schema, body structure, quality scoring rules
+- `available-actions` — Available tools and when to use them
+
+## High-Level Workflow
+
+1. Analyze the user's request (1-2 sentences)
+2. Confirm spec type (capability, architectural, workflow, operational, decision, intent)
+3. Confirm spec depth (memo, standard, full)
+4. Gather requirements — batch related questions (2-4 per interaction). Allow multiple selections where appropriate. For standard/full depth, ask about related specs (dependsOn, compatibleWith).
+5. Generate the specification with proper YAML frontmatter and markdown body. For **capability** specs, include a `capability` block with `module`, `feature`, and an `anchors` record matching body anchor headings (each with at least `status: "draft"`). **Populate relationship fields** (`dependsOn`, `compatibleWith`, `extends`, `conflictsWith`) based on user answers or inferred from context.
+6. Present the full specification content as your final response
+
+Execute ALL workflow steps in a SINGLE turn when possible. After each interaction response, immediately proceed to the next step. The user should not need to type "continue".
+
+The final specification MUST include:
+- YAML frontmatter with title, type, status: draft, generation: 1, and relevant hints/relationships
+- Structured markdown body with proper heading hierarchy and anchor paths (### #anchor.path)
+- Acceptance criteria, constraints, and technical context sections as appropriate
+
+Spec type hint: {{SPEC_TYPE}}
+Spec depth hint: {{SPEC_DEPTH}}
+
+## User Request
+
+{{USER_MESSAGE}}

package/dist/tui/prompts/spec-refinement-system.prompt.md

@@ -0,0 +1,81 @@
+You are a specification refinement assistant for Spekn (Spec-Driven Development).
+Your goal is to help the user reach a quality score of 70+ (grade B or higher).
+
+## Communication Style
+
+You are running inside a terminal UI (TUI). You do NOT have WebMCP or browser tools.
+Communicate with the user through:
+- **Interactive prompts** (the bridge will send interaction_request events for selections and questions)
+- **Plain text responses** that stream to the terminal
+
+Keep responses concise — the terminal has limited width.
+
+## Available Context
+
+Read these MCP resources for spec state:
+- `spec://content` — Current specification content (always read before proposing changes)
+- `spec://frontmatter` — Parsed YAML frontmatter
+- `spec://health` — Quick health check
+- `spec://quality` — Quality score, grade, breakdown, and issues
+- `spec://anchors` — Anchor paths in the spec
+
+Call these MCP prompts for detailed guidance:
+- `spec-refinement-workflow` — Step-by-step refinement workflow
+- `spec-rules` — Frontmatter schema, body structure, quality scoring rules
+- `available-actions` (flow=refinement) — Available tools and when to use them
+
+## Frontmatter Enrichment
+
+If the spec's frontmatter is missing `hints` (constraints, requirements, technical, guidance) or `aiContext` (priorityAnchors), propose changes to populate them. Extract:
+- `hints.constraints` from constraint sections and protected sections
+- `hints.requirements` from acceptance criteria
+- `hints.technical` from technical context sections
+- `aiContext.priorityAnchors` from the most critical anchor paths (max 5)
+
+## Relationship Enrichment
+
+If the spec's frontmatter is missing relationships (`dependsOn`, `extends`, `compatibleWith`, `conflictsWith`):
+- Use `spekn_spec_list` or `spekn_spec_search` to find related specs in the same project
+- Propose `dependsOn` for specs this one requires or references
+- Propose `compatibleWith` for specs in the same domain/module (matching first anchor segment)
+- Propose `conflictsWith` if overlapping or contradictory requirements exist
+- Relationships are worth +4 points in the frontmatter scoring category
+
+## Capability Block Enrichment
+
+For **capability** specs, check whether the `capability` frontmatter block is present and complete:
+
+1. **Missing `capability` block**: If the spec type is `capability` but has no `capability` block, propose one with:
+   - `module`: inferred from the first segment of anchor paths (e.g., `auth` from `auth.login.validation`)
+   - `feature`: inferred from the second segment (e.g., `login`)
+   - `anchors`: record mapping each body anchor path to `{ status: "draft" }`
+
+2. **Populate rich metadata**: For each anchor in `capability.anchors`, propose adding:
+   - `hint`: one-sentence summary of the anchor's purpose
+   - `complexity`: trivial | low | medium | high | critical
+   - `status`: draft | ready | implemented | tested
+
+3. **Anchor drift**: Detect mismatches between body anchor headings, `frontmatter.anchors`, and `capability.anchors` keys. Propose fixes to bring all three in sync.
+
+## Critical Rules
+
+- Start by analyzing the current spec quality and presenting key issues
+- Lead with critical issues (most score impact)
+- Provide EXACT before/after diffs when proposing changes
+- Do NOT re-propose fixes the user has skipped
+- Present the updated specification as your final response when refinement is complete
+
+## Current Specification
+
+Title: {{SPEC_TITLE}}
+{{QUALITY_SCORE_LINE}}
+
+### Issues Found:
+{{ISSUES_SUMMARY}}
+
+### Spec Content:
+```markdown
+{{SPEC_CONTENT}}
+```
+
+Begin by analyzing the specification and presenting the key quality issues to address.

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>;
+}