@spekn/cli 1.0.0

package/dist/stubs/typeorm.d.ts

@@ -0,0 +1,22 @@
+export declare const Entity: (..._args: any[]) => (target: any) => any;
+export declare const Column: (..._args: any[]) => (_target: any, ..._rest: any[]) => void;
+export declare const PrimaryGeneratedColumn: (..._args: any[]) => (_target: any, ..._rest: any[]) => void;
+export declare const CreateDateColumn: (..._args: any[]) => (_target: any, ..._rest: any[]) => void;
+export declare const UpdateDateColumn: (..._args: any[]) => (_target: any, ..._rest: any[]) => void;
+export declare const ManyToOne: (..._args: any[]) => (_target: any, ..._rest: any[]) => void;
+export declare const OneToMany: (..._args: any[]) => (_target: any, ..._rest: any[]) => void;
+export declare const JoinColumn: (..._args: any[]) => (_target: any, ..._rest: any[]) => void;
+export declare const Index: (..._args: any[]) => (_target: any, ..._rest: any[]) => void;
+export declare const Unique: (..._args: any[]) => (target: any) => any;
+export declare class DataSource {
+    constructor(_opts: any);
+    initialize(): Promise<Awaited<this>>;
+}
+export declare const IsNull: () => {
+    _type: string;
+};
+export type MigrationInterface = {
+    up(qr: any): Promise<void>;
+    down(qr: any): Promise<void>;
+};
+export type QueryRunner = any;

package/dist/stubs/typeorm.js

@@ -0,0 +1,28 @@
+"use strict";
+// No-op stub for typeorm — the CLI never touches the database but @spekn/shared
+// entity files import decorators at the top level. This prevents the
+// "Dynamic require of 'typeorm' is not supported" error in the ESM TUI bundle.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsNull = exports.DataSource = exports.Unique = exports.Index = exports.JoinColumn = exports.OneToMany = exports.ManyToOne = exports.UpdateDateColumn = exports.CreateDateColumn = exports.PrimaryGeneratedColumn = exports.Column = exports.Entity = void 0;
+/* eslint-disable @typescript-eslint/no-unused-vars */
+const noop = (..._args) => (_target, ..._rest) => { };
+const noopClass = (..._args) => (target) => target;
+// Decorators
+exports.Entity = noopClass;
+exports.Column = noop;
+exports.PrimaryGeneratedColumn = noop;
+exports.CreateDateColumn = noop;
+exports.UpdateDateColumn = noop;
+exports.ManyToOne = noop;
+exports.OneToMany = noop;
+exports.JoinColumn = noop;
+exports.Index = noop;
+exports.Unique = noopClass;
+// Classes / functions used at runtime in shared
+class DataSource {
+    constructor(_opts) { }
+    initialize() { return Promise.resolve(this); }
+}
+exports.DataSource = DataSource;
+const IsNull = () => ({ _type: "isNull" });
+exports.IsNull = IsNull;

package/dist/tui/app.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { TuiScreenId } from './types';
+export declare function TuiApp({ apiUrl, initialScreen, projectId }: {
+    apiUrl: string;
+    initialScreen: TuiScreenId;
+    projectId?: string;
+}): React.JSX.Element;

package/dist/tui/app.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TuiApp = TuiApp;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const ink_1 = require("ink");
+const ui_1 = require("@inkjs/ui");
+const use_app_state_1 = require("./state/use-app-state");
+const use_global_keymap_1 = require("./keymap/use-global-keymap");
+const frame_1 = require("./components/frame");
+const status_bar_1 = require("./components/status-bar");
+const home_1 = require("./screens/home");
+const specs_1 = require("./screens/specs");
+const export_1 = require("./screens/export");
+const decisions_1 = require("./screens/decisions");
+const bridge_1 = require("./screens/bridge");
+const locked_1 = require("./screens/locked");
+/** Brand-aligned theme: Electric Indigo spinner, semantic colors via component defaults */
+const speknTheme = (0, ui_1.extendTheme)(ui_1.defaultTheme, {
+    components: {
+        Spinner: {
+            styles: {
+                frame: () => ({ color: '#6366F1' }),
+            },
+        },
+    },
+});
+function renderMainScreen(screen, state) {
+    if (screen === 'home')
+        return (0, jsx_runtime_1.jsx)(home_1.HomeScreen, { state: state });
+    if (screen === 'specs')
+        return (0, jsx_runtime_1.jsx)(specs_1.SpecsScreen, { state: state });
+    if (screen === 'export')
+        return (0, jsx_runtime_1.jsx)(export_1.ExportScreen, { state: state });
+    if (screen === 'decisions')
+        return (0, jsx_runtime_1.jsx)(decisions_1.DecisionsScreen, { state: state });
+    if (screen === 'bridge')
+        return (0, jsx_runtime_1.jsx)(bridge_1.BridgeScreen, { state: state });
+    const nav = state.navPolicy.find((item) => item.id === screen);
+    return (0, jsx_runtime_1.jsx)(locked_1.LockedScreen, { item: nav });
+}
+function TuiApp({ apiUrl, initialScreen, projectId }) {
+    const { state, refresh, setScreen, toggleHelp, setSearchQuery, setCommandMode, setExportFormat, previewExport, generateExport, bridgeStart, bridgeStop, appendLog, } = (0, use_app_state_1.useAppState)(apiUrl, initialScreen, projectId);
+    (0, use_global_keymap_1.useGlobalKeymap)({
+        screen: state.screen,
+        navPolicy: state.navPolicy,
+        commandMode: state.commandMode,
+        showHelp: state.showHelp,
+        onNavigate: setScreen,
+        onHelpToggle: toggleHelp,
+        onSearchToggle: () => setSearchQuery(state.searchQuery ? '' : '*'),
+        onSearchClear: () => setSearchQuery(''),
+        onCommandModeToggle: setCommandMode,
+        onRefresh: () => {
+            void refresh();
+        },
+        onExportPreview: () => {
+            void previewExport();
+        },
+        onExportGenerate: () => {
+            void generateExport();
+        },
+        onBridgeStart: bridgeStart,
+        onBridgeStop: () => {
+            void bridgeStop();
+        },
+    });
+    const handleCommandSubmit = (command) => {
+        const normalized = command.trim().toLowerCase();
+        setCommandMode(false);
+        if (!normalized)
+            return;
+        if (normalized === 'help') {
+            toggleHelp();
+            return;
+        }
+        if (normalized === 'refresh' || normalized === 'r') {
+            void refresh();
+            return;
+        }
+        if (normalized.startsWith('goto ')) {
+            const target = normalized.replace('goto ', '').trim();
+            setScreen(target);
+            appendLog(`[nav] goto ${target}`);
+            return;
+        }
+        if (normalized === 'show specs') {
+            setScreen('specs');
+            return;
+        }
+        if (normalized === 'show export') {
+            setScreen('export');
+            return;
+        }
+        if (normalized === 'run export') {
+            void generateExport();
+            return;
+        }
+        if (normalized === 'format claude') {
+            setExportFormat('claude-md');
+            appendLog('[export] Format switched to claude-md');
+            return;
+        }
+        if (normalized === 'format cursor') {
+            setExportFormat('cursorrules');
+            appendLog('[export] Format switched to cursorrules');
+            return;
+        }
+        if (normalized === 'bridge start') {
+            bridgeStart();
+            return;
+        }
+        if (normalized === 'bridge stop') {
+            void bridgeStop();
+            return;
+        }
+        appendLog(`[command] Unknown: ${command}`);
+    };
+    const left = `${state.boot?.organizationName ?? '...'} / ${state.boot?.projectName ?? '...'}`;
+    const center = state.loading ? 'Loading...' : state.statusLine;
+    const right = `${state.screen} | phase:${state.workflow.currentPhase ?? 'n/a'} | role:${state.boot?.role ?? 'n/a'} | tier:${state.boot?.plan ?? 'n/a'}`;
+    return ((0, jsx_runtime_1.jsx)(ui_1.ThemeProvider, { theme: speknTheme, children: (0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { bold: true, color: "cyan", children: "Spekn TUI - Technical Cockpit" }), (0, jsx_runtime_1.jsx)(ink_1.Text, { color: "gray", children: "Shortcuts: j/k/h/l nav, : commands, ? help, r refresh, Ctrl+C quit" }), state.error ? ((0, jsx_runtime_1.jsx)(ink_1.Box, { marginTop: 1, children: (0, jsx_runtime_1.jsx)(ui_1.Alert, { variant: "error", children: state.error }) })) : null, (0, jsx_runtime_1.jsxs)(ink_1.Box, { marginTop: 1, children: [(0, jsx_runtime_1.jsx)(ink_1.Box, { width: "28%", flexDirection: "column", children: (0, jsx_runtime_1.jsx)(frame_1.Frame, { title: "Navigation", children: state.navPolicy.map((item, index) => ((0, jsx_runtime_1.jsxs)(ink_1.Text, { color: state.screen === item.id ? 'green' : item.state === 'locked' ? 'yellow' : item.state === 'disabled' ? 'gray' : undefined, children: [state.screen === item.id ? '>' : ' ', " ", index + 1, ". ", item.label, item.state === 'locked' ? ' (locked)' : item.state === 'disabled' ? ' (disabled)' : ''] }, item.id))) }) }), (0, jsx_runtime_1.jsx)(ink_1.Box, { width: "52%", flexDirection: "column", children: (0, jsx_runtime_1.jsx)(frame_1.Frame, { title: "Context", children: renderMainScreen(state.screen, state) }) }), (0, jsx_runtime_1.jsx)(ink_1.Box, { width: "20%", flexDirection: "column", children: (0, jsx_runtime_1.jsx)(frame_1.Frame, { title: "Event Log", dim: true, children: (state.logs.length === 0 ? ['[system] ready'] : state.logs.slice(0, 7)).map((line, index) => ((0, jsx_runtime_1.jsx)(ink_1.Text, { color: "gray", children: line }, `log-${index}`))) }) })] }), state.showHelp ? ((0, jsx_runtime_1.jsx)(ink_1.Box, { marginTop: 1, children: (0, jsx_runtime_1.jsx)(ui_1.Alert, { variant: "info", children: "Help: j/k/h/l navigate | :help | :goto specs | :run export | format claude/cursor | bridge start/stop" }) })) : null, state.commandMode ? ((0, jsx_runtime_1.jsxs)(ink_1.Box, { marginTop: 1, children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { color: "green", children: ":" }), (0, jsx_runtime_1.jsx)(ui_1.TextInput, { placeholder: "command...", onSubmit: handleCommandSubmit })] })) : null, (0, jsx_runtime_1.jsx)(status_bar_1.StatusBar, { left: left, center: center, right: right })] }) }));
+}

package/dist/tui/args.d.ts

@@ -0,0 +1,8 @@
+import type { TuiScreenId } from './types';
+export interface TuiCliOptions {
+    projectId?: string;
+    apiUrl: string;
+    initialView: TuiScreenId;
+    noColor: boolean;
+}
+export declare function parseTuiArgs(args: string[]): TuiCliOptions;

package/dist/tui/args.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTuiArgs = parseTuiArgs;
+const VIEW_ALIASES = {
+    home: 'home',
+    specs: 'specs',
+    export: 'export',
+    decisions: 'decisions',
+    bridge: 'bridge',
+};
+function parseTuiArgs(args) {
+    let projectId;
+    let apiUrl = process.env.SPEKN_API_URL ?? 'http://localhost:3000';
+    let initialView = 'home';
+    let noColor = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if ((arg === '--project-id' || arg === '--project') && args[i + 1]) {
+            projectId = args[++i];
+            continue;
+        }
+        if (arg.startsWith('--project-id=')) {
+            projectId = arg.slice('--project-id='.length);
+            continue;
+        }
+        if (arg === '--api-url' && args[i + 1]) {
+            apiUrl = args[++i];
+            continue;
+        }
+        if (arg.startsWith('--api-url=')) {
+            apiUrl = arg.slice('--api-url='.length);
+            continue;
+        }
+        if (arg === '--view' && args[i + 1]) {
+            const candidate = VIEW_ALIASES[String(args[++i]).toLowerCase()];
+            if (candidate)
+                initialView = candidate;
+            continue;
+        }
+        if (arg.startsWith('--view=')) {
+            const candidate = VIEW_ALIASES[arg.slice('--view='.length).toLowerCase()];
+            if (candidate)
+                initialView = candidate;
+            continue;
+        }
+        if (arg === '--no-color') {
+            noColor = true;
+            continue;
+        }
+    }
+    return {
+        projectId,
+        apiUrl,
+        initialView,
+        noColor,
+    };
+}

package/dist/tui/capabilities/policy.d.ts

@@ -0,0 +1,7 @@
+import { OrganizationPlan } from '../shared-enums';
+import type { CapabilityContext, NavItemPolicy } from '../types';
+type OrganizationPlanType = (typeof OrganizationPlan)[keyof typeof OrganizationPlan];
+export declare function meetsMinimumTier(current: OrganizationPlanType, required: OrganizationPlanType): boolean;
+export declare function resolveNavPolicy(ctx: CapabilityContext): NavItemPolicy[];
+export declare function isActionAllowed(policy: NavItemPolicy): boolean;
+export {};

package/dist/tui/capabilities/policy.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.meetsMinimumTier = meetsMinimumTier;
+exports.resolveNavPolicy = resolveNavPolicy;
+exports.isActionAllowed = isActionAllowed;
+const shared_enums_1 = require("../shared-enums");
+const TIER_ORDER = {
+    [shared_enums_1.OrganizationPlan.FREE]: 0,
+    [shared_enums_1.OrganizationPlan.PRO]: 1,
+    [shared_enums_1.OrganizationPlan.TEAM]: 2,
+    [shared_enums_1.OrganizationPlan.ENTERPRISE]: 3,
+};
+const NAV_DEFINITIONS = [
+    { id: 'home', label: 'Home', description: 'Next actions and workflow pulse', requiredPlan: shared_enums_1.OrganizationPlan.FREE },
+    { id: 'specs', label: 'Specs', description: 'Manage governed specifications', requiredPlan: shared_enums_1.OrganizationPlan.FREE },
+    { id: 'export', label: 'Export', description: 'Generate CLAUDE.md / .cursorrules', requiredPlan: shared_enums_1.OrganizationPlan.FREE },
+    { id: 'decisions', label: 'Decision Log', description: 'Review decisions and rationale', requiredPlan: shared_enums_1.OrganizationPlan.FREE },
+    { id: 'bridge', label: 'Local Bridge', description: 'Bridge status and controls', requiredPlan: shared_enums_1.OrganizationPlan.PRO },
+    { id: 'active-runs', label: 'Active Runs', description: 'Realtime orchestration dashboard', requiredPlan: shared_enums_1.OrganizationPlan.TEAM },
+    { id: 'phase-gates', label: 'Phase Gates', description: 'Approve and unblock workflow phases', requiredPlan: shared_enums_1.OrganizationPlan.TEAM },
+    { id: 'skills-marketplace', label: 'Skills Marketplace', description: 'Manage shared managed skills', requiredPlan: shared_enums_1.OrganizationPlan.TEAM },
+    { id: 'org-governance', label: 'Org Governance', description: 'Compliance, policy, deployment gates', requiredPlan: shared_enums_1.OrganizationPlan.ENTERPRISE },
+];
+const GATE_DISABLED_PHASES = [
+    shared_enums_1.WorkflowPhase.SPECIFY,
+    shared_enums_1.WorkflowPhase.CLARIFY,
+];
+function meetsMinimumTier(current, required) {
+    return TIER_ORDER[current] >= TIER_ORDER[required];
+}
+function resolveNavPolicy(ctx) {
+    return NAV_DEFINITIONS.map((item) => {
+        if (!meetsMinimumTier(ctx.plan, item.requiredPlan)) {
+            return {
+                ...item,
+                state: 'locked',
+                reason: `Requires ${item.requiredPlan.toUpperCase()} tier`,
+            };
+        }
+        if (item.id === 'phase-gates' && ctx.role === 'viewer') {
+            return {
+                ...item,
+                state: 'disabled',
+                reason: 'Viewer role cannot approve gates',
+            };
+        }
+        if (item.id === 'phase-gates' &&
+            ctx.workflowPhase &&
+            GATE_DISABLED_PHASES.includes(ctx.workflowPhase)) {
+            return {
+                ...item,
+                state: 'disabled',
+                reason: `Gate approvals are unavailable in ${ctx.workflowPhase} phase`,
+            };
+        }
+        return {
+            ...item,
+            state: 'enabled',
+        };
+    });
+}
+function isActionAllowed(policy) {
+    return policy.state === 'enabled';
+}

package/dist/tui/components/frame.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+interface FrameProps {
+    title: string;
+    children: React.ReactNode;
+    dim?: boolean;
+}
+export declare function Frame({ title, children, dim }: FrameProps): React.JSX.Element;
+export {};

package/dist/tui/components/frame.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Frame = Frame;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const ink_1 = require("ink");
+function Frame({ title, children, dim = false }) {
+    return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { flexDirection: "column", borderStyle: "round", borderColor: dim ? 'gray' : 'cyan', paddingX: 1, paddingY: 0, marginRight: 1, minHeight: 7, children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { bold: true, color: dim ? 'gray' : 'cyan', children: title }), (0, jsx_runtime_1.jsx)(ink_1.Box, { flexDirection: "column", marginTop: 0, children: children })] }));
+}

package/dist/tui/components/status-bar.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+interface StatusBarProps {
+    left: string;
+    center: string;
+    right: string;
+}
+export declare function StatusBar({ left, center, right }: StatusBarProps): React.JSX.Element;
+export {};

package/dist/tui/components/status-bar.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatusBar = StatusBar;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const ink_1 = require("ink");
+function StatusBar({ left, center, right }) {
+    return ((0, jsx_runtime_1.jsxs)(ink_1.Box, { borderStyle: "single", borderColor: "gray", paddingX: 1, justifyContent: "space-between", children: [(0, jsx_runtime_1.jsx)(ink_1.Text, { color: "gray", children: left }), (0, jsx_runtime_1.jsx)(ink_1.Text, { children: center }), (0, jsx_runtime_1.jsx)(ink_1.Text, { color: "gray", children: right })] }));
+}

package/dist/tui/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export declare function runTuiCli(args: string[]): Promise<number>;

package/dist/tui/index.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runTuiCli = runTuiCli;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const ink_1 = require("ink");
+const args_1 = require("./args");
+const app_1 = require("./app");
+async function runTuiCli(args) {
+    try {
+        const options = (0, args_1.parseTuiArgs)(args);
+        if (options.noColor) {
+            process.env.FORCE_COLOR = '0';
+        }
+        (0, ink_1.render)((0, jsx_runtime_1.jsx)(app_1.TuiApp, { apiUrl: options.apiUrl, initialScreen: options.initialView, projectId: options.projectId }));
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`Error: ${message}\n`);
+        return 1;
+    }
+}