@latysh-development/monolith 0.0.0-stage → 0.1.0-alpha.0

package/dist/brief/story.js

@@ -0,0 +1,59 @@
+/**
+ * Extracts the "## Current Story" section from
+ * `.monolith/memory/working/active.md` — confirmed structure only, no
+ * heuristic Markdown interpretation (section 5 of the brief contract).
+ *
+ * Only two things are recognized: a line that is exactly a level-1..6
+ * heading, and a line that is exactly `---` (used in active.md as a visual
+ * section separator). The "Current Story" section's content is everything
+ * between its own heading line and the next such boundary.
+ */
+const CURRENT_STORY_HEADING_RE = /^##\s+Current Story\s*$/i;
+const HEADING_RE = /^#{1,6}\s+/;
+const RULE_RE = /^-{3,}\s*$/;
+export function extractCurrentStory(content) {
+    const lines = content.split('\n');
+    let headingLineIdx = -1;
+    for (let i = 0; i < lines.length; i++) {
+        if (CURRENT_STORY_HEADING_RE.test(lines[i].trim())) {
+            headingLineIdx = i;
+            break;
+        }
+    }
+    if (headingLineIdx === -1) {
+        return { hasCurrentStorySection: false, excerpt: null, lineRange: null };
+    }
+    let endIdx = lines.length;
+    for (let i = headingLineIdx + 1; i < lines.length; i++) {
+        const trimmed = lines[i].trim();
+        if (HEADING_RE.test(trimmed) || RULE_RE.test(trimmed)) {
+            endIdx = i;
+            break;
+        }
+    }
+    const bodyLines = lines.slice(headingLineIdx + 1, endIdx);
+    // Trim leading/trailing blank lines, keep interior ones.
+    let start = 0;
+    let end = bodyLines.length;
+    while (start < end && bodyLines[start].trim() === '')
+        start++;
+    while (end > start && bodyLines[end - 1].trim() === '')
+        end--;
+    const trimmedLines = bodyLines.slice(start, end);
+    const excerpt = trimmedLines.join('\n');
+    if (trimmedLines.length === 0) {
+        // Heading exists but has no body — still a confirmed (empty) section.
+        return {
+            hasCurrentStorySection: true,
+            excerpt: '',
+            lineRange: `${headingLineIdx + 1}-${headingLineIdx + 1}`,
+        };
+    }
+    const firstLine1Indexed = headingLineIdx + 1 + 1 + start;
+    const lastLine1Indexed = firstLine1Indexed + trimmedLines.length - 1;
+    return {
+        hasCurrentStorySection: true,
+        excerpt,
+        lineRange: `${firstLine1Indexed}-${lastLine1Indexed}`,
+    };
+}

package/dist/brief/types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * MONOLITH Context Gateway — `monolith brief` (CONTEXT-001A).
+ *
+ * BriefModel is the thin, read-only data layer produced by `collect()`.
+ * It is deliberately NOT a new source of truth: every field is either a
+ * direct, narrow projection of an existing artifact (state.json, active.md,
+ * a protocol's/ADR's frontmatter) or a diagnostic about that artifact's
+ * readability. `render()` turns a BriefModel into bounded, deterministic
+ * text — it never re-derives data collect() didn't already produce.
+ */
+import type { Mission, Checkpoint } from '../coordinatorium/types.js';
+import type { ProjectFileErrorCode } from '../root/index.js';
+import type { FreshnessResult, FreshnessEvidence } from './freshness.js';
+export type DiagnosticSeverity = 'info' | 'warn' | 'error';
+/**
+ * Collect-time diagnostic codes. These are known before any rendering /
+ * budget decision is made, which is what lets render() reserve space for
+ * them deterministically (see render.ts's two-phase budget accounting).
+ */
+export type BriefDiagnosticCode = 'MONOLITH_NOT_INITIALIZED' | 'STATE_NOT_INITIALIZED' | 'STATE_EMPTY' | 'STATE_UNREADABLE' | 'STATE_LEGACY_SCHEMA_MIGRATED' | 'MULTIPLE_ACTIVE_MISSIONS' | 'CHECKPOINT_ORDER_MISMATCH' | 'ACTIVE_MD_MISSING' | 'ACTIVE_MD_REJECTED' | 'ACTIVE_MD_UNREADABLE' | 'ACTIVE_MD_NO_CURRENT_STORY' | 'CONFIG_UNREADABLE' | 'CONFIG_ADR_DIRS_INVALID' | 'DOC_DIR_UNREADABLE' | 'DOC_FILE_UNREADABLE' | 'DOC_DIR_OUTSIDE_PROJECT' | 'PATH_OUTSIDE_PROJECT' | 'WRITE_ARTIFACTS_PRESENT';
+export interface BriefDiagnostic {
+    code: BriefDiagnosticCode;
+    severity: DiagnosticSeverity;
+    message: string;
+    /**
+     * SEC-001B.1-R: the typed reason of the safe reader, when the diagnostic is about
+     * reading a managed file. Callers must branch on this, never on `message`.
+     */
+    readCode?: ProjectFileErrorCode;
+}
+/** A pointer to the on-disk artifact a section's content was read from. */
+export interface Provenance {
+    /** Relative to the project's targetDir. Never absolute. */
+    source: string;
+}
+export type StateKeeperStatus = 'absent' | 'empty' | 'unreadable' | 'ok';
+export interface StateKeeperSummary {
+    status: StateKeeperStatus;
+    /** Only set when status === 'ok' or 'unreadable' was resolved after a parse. */
+    schemaVersionOnDisk?: number;
+    provenance: Provenance;
+}
+export interface MissionsSummary {
+    /** All in_progress missions, sorted by (startedAt, id). */
+    active: Mission[];
+    /** Finished missions (completed/failed/cancelled), most recently updated first. */
+    recentFinished: Mission[];
+    provenance: Provenance;
+}
+export interface CheckpointSummary {
+    missionId: string;
+    /** The checkpoint with the highest numeric ordinal for this mission, or null if none exist. */
+    latest: Checkpoint | null;
+    provenance: Provenance;
+}
+export interface StorySummary {
+    /** Whether active.md exists at all. */
+    fileExists: boolean;
+    /** Whether a "## Current Story" section was found inside an existing file. */
+    hasCurrentStorySection: boolean;
+    /** Raw section text (trimmed), only set when hasCurrentStorySection is true. */
+    excerpt: string | null;
+    /** 1-indexed inclusive line range of the excerpt within active.md, e.g. "24-29". */
+    lineRange: string | null;
+    provenance: Provenance | null;
+}
+export interface DocRef {
+    id: string;
+    title: string;
+    /** Relative to targetDir. */
+    path: string;
+}
+export interface AdrIndex {
+    items: AdrRef[];
+    provenance: Provenance;
+}
+export type AdrRef = DocRef;
+export interface ProtocolIndex {
+    items: DocRef[];
+    provenance: Provenance;
+}
+export interface ProjectIdentity {
+    name: string;
+    monolithRoot: string;
+    provenance: Provenance;
+}
+export interface BriefModel {
+    identity: ProjectIdentity;
+    monolithInitialized: boolean;
+    stateKeeper: StateKeeperSummary;
+    missions: MissionsSummary;
+    checkpoints: CheckpointSummary[];
+    story: StorySummary;
+    mandatoryProtocols: ProtocolIndex;
+    adrs: AdrIndex;
+    /** Collect-time diagnostics, in deterministic (collection-order) sequence. */
+    diagnostics: BriefDiagnostic[];
+    /**
+     * SELF-AWARENESS-001: whether the recorded state can be trusted. Independent of
+     * Completeness. Optional so a hand-built model without it renders as before.
+     */
+    freshness?: FreshnessResult;
+    /**
+     * SELF-AWARENESS-002: the evidence `freshness` was computed from, kept so
+     * `brief --reconcile` can explain the verdict without a second git read.
+     * Never rendered by the plain brief.
+     */
+    freshnessEvidence?: FreshnessEvidence;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/brief/types.d.ts.map

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

package/dist/brief/types.js

@@ -0,0 +1,11 @@
+/**
+ * MONOLITH Context Gateway — `monolith brief` (CONTEXT-001A).
+ *
+ * BriefModel is the thin, read-only data layer produced by `collect()`.
+ * It is deliberately NOT a new source of truth: every field is either a
+ * direct, narrow projection of an existing artifact (state.json, active.md,
+ * a protocol's/ADR's frontmatter) or a diagnostic about that artifact's
+ * readability. `render()` turns a BriefModel into bounded, deterministic
+ * text — it never re-derives data collect() didn't already produce.
+ */
+export {};

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+/**
+ * MONOLITH CLI entrypoint
+ *
+ * Commands:
+ *   monolith init       — scaffold a new MONOLITH instance from templates/
+ *   monolith validate   — static instance checks (never executes project code)
+ *   monolith status     — not implemented
+ *   monolith dry-run    — not implemented
+ *   monolith mission    — manage Tactical Coordinatorium mission lifecycle
+ *   monolith brief       — deterministic, bounded project context summary
+ *   monolith durable     — inspect/verify/maintain Durable State task logs
+ *   monolith ui          — launch Mission Control (read-only dashboard)
+ */
+import { MONOLITH_VERSION } from '../version.js';
+import { parseInitArgs } from './init-args.js';
+const USAGE = `
+monolith v${MONOLITH_VERSION}
+
+Usage:
+  monolith <command> [options]
+
+Commands:
+  init        Scaffold a new MONOLITH instance in the current directory.
+              No positional target-directory argument; refuses to run if it
+              would overwrite any existing tracked file (--yes only skips
+              interactive prompts, it does not force an overwrite).
+  validate    Static checks of the instance files (config, definition file,
+              AGENTS.md, templates). Read-only: writes, creates and deletes
+              nothing. Never executes project code. Not a security
+              enforcement gate.
+  status      Not implemented (exits 1).
+  dry-run     Not implemented (exits 1).
+  mission     Manage Tactical Coordinatorium missions (start/list/show/finish/checkpoint/checkpoints)
+  brief       Print a deterministic, bounded summary of project state (Story,
+              active Missions, latest Checkpoints, mandatory Protocols,
+              accepted ADRs) — read-only, no LLM/network/ERG involved.
+  durable     Inspect and maintain Durable State (long-running task logs):
+              list | show | assess | packet | verify | retention.
+  ui          Launch Mission Control, the read-only web dashboard, on
+              127.0.0.1 (default port 4173). 'ui dev' adds Vite hot reload
+              (source checkout only). See 'monolith ui --help'.
+
+Mission usage:
+  monolith mission start --title "..." --system "..."
+  monolith mission list
+  monolith mission show <id>
+  monolith mission finish <id> --result completed|failed|cancelled [--summary "..."]
+  monolith mission checkpoint <missionId> --summary "..." [--remaining "..." ...] [--context "..."]
+  monolith mission checkpoints <missionId>
+
+Brief usage:
+  monolith brief [--max-chars N] [--strict]
+  monolith brief --reconcile [--max-chars N]   (read-only report: what the Freshness verdict rests on)
+
+Durable usage:
+  monolith durable list [--status active|completed|failed|cancelled]
+  monolith durable show|assess|packet <taskId>
+  monolith durable verify [taskId]            (exit 2 if a log fails verification)
+  monolith durable retention --retain-days N [--compact-after N] [--apply]
+
+UI usage:
+  monolith ui [--port N]
+  monolith ui dev [--port N]
+
+Options:
+  --help, -h      Show this help
+  --version, -v   Print version
+`.trim();
+async function main() {
+    const args = process.argv.slice(2);
+    // `ui` owns its own --help / --version-like flags (`monolith ui dev --help`).
+    const ownsHelp = args[0] === 'ui';
+    if (args.length === 0 || (!ownsHelp && (args.includes('--help') || args.includes('-h')))) {
+        console.log(USAGE);
+        process.exit(0);
+        return;
+    }
+    if (!ownsHelp && (args.includes('--version') || args.includes('-v'))) {
+        console.log(MONOLITH_VERSION);
+        process.exit(0);
+        return;
+    }
+    const command = args[0];
+    switch (command) {
+        case 'init': {
+            const parsed = parseInitArgs(args.slice(1));
+            if (!parsed.ok) {
+                console.error(parsed.message + '\n');
+                process.exit(1);
+                return;
+            }
+            const { runInit } = await import('../init/index.js');
+            await runInit({ targetDir: process.cwd(), yes: parsed.yes });
+            break;
+        }
+        case 'validate': {
+            const { runValidate } = await import('../validate/index.js');
+            const quiet = args.includes('--quiet') || args.includes('-q');
+            await runValidate({ targetDir: process.cwd(), quiet });
+            break;
+        }
+        case 'mission': {
+            const sub = args[1];
+            const rest = args.slice(2);
+            const { runMissionStart, runMissionList, runMissionShow, runMissionFinish, runMissionCheckpoint, runMissionCheckpoints, } = await import('../coordinatorium/cli.js');
+            switch (sub) {
+                case 'start':
+                    await runMissionStart(rest);
+                    break;
+                case 'list':
+                    await runMissionList(rest);
+                    break;
+                case 'show':
+                    await runMissionShow(rest);
+                    break;
+                case 'finish':
+                    await runMissionFinish(rest);
+                    break;
+                case 'checkpoint':
+                    await runMissionCheckpoint(rest);
+                    break;
+                case 'checkpoints':
+                    await runMissionCheckpoints(rest);
+                    break;
+                default:
+                    console.error(`Unknown mission subcommand: ${sub ?? '(none)'}\n`);
+                    console.log(USAGE);
+                    process.exit(1);
+            }
+            break;
+        }
+        case 'brief': {
+            const { runBrief } = await import('../brief/cli.js');
+            await runBrief(args.slice(1));
+            break;
+        }
+        case 'durable': {
+            const { runDurableCommand } = await import('../durable/cli.js');
+            await runDurableCommand(args.slice(1));
+            break;
+        }
+        case 'ui': {
+            const { runUi } = await import('./ui.js');
+            process.exit(await runUi(args.slice(1)));
+            break;
+        }
+        case 'status':
+            console.error('monolith status — not yet implemented (Phase 6)');
+            process.exit(1);
+            break;
+        case 'dry-run':
+            console.error('monolith dry-run — not yet implemented (Phase 6)');
+            process.exit(1);
+            break;
+        default:
+            console.error(`Unknown command: ${command}\n`);
+            console.log(USAGE);
+            process.exit(1);
+    }
+}
+main().catch((err) => {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});

package/dist/cli/init-args.d.ts

@@ -0,0 +1,16 @@
+export type InitArgsResult = {
+    ok: true;
+    yes: boolean;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * Parses args after `monolith init`. There is no positional target-directory
+ * argument — init always scaffolds process.cwd() — so any arg that isn't a
+ * known flag is an explicit error, not a silently ignored no-op (see
+ * LESSON-2026-0006 / TD-007: a stray positional arg was previously dropped
+ * on the floor and the CLI scaffolded the current directory instead).
+ */
+export declare function parseInitArgs(args: string[]): InitArgsResult;
+//# sourceMappingURL=init-args.d.ts.map

package/dist/cli/init-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-args.d.ts","sourceRoot":"","sources":["../../src/cli/init-args.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,cAAc,CAgB5D"}

package/dist/cli/init-args.js

@@ -0,0 +1,24 @@
+const KNOWN_INIT_FLAGS = new Set(['--yes', '-y']);
+/**
+ * Parses args after `monolith init`. There is no positional target-directory
+ * argument — init always scaffolds process.cwd() — so any arg that isn't a
+ * known flag is an explicit error, not a silently ignored no-op (see
+ * LESSON-2026-0006 / TD-007: a stray positional arg was previously dropped
+ * on the floor and the CLI scaffolded the current directory instead).
+ */
+export function parseInitArgs(args) {
+    const unknown = args.filter((arg) => !KNOWN_INIT_FLAGS.has(arg));
+    if (unknown.length > 0) {
+        return {
+            ok: false,
+            message: `Unknown argument(s) for 'monolith init': ${unknown.join(' ')}\n` +
+                '\n' +
+                "  monolith init takes no positional arguments — it always scaffolds\n" +
+                '  the current working directory. There is no way to target another\n' +
+                '  directory; `cd` there first.\n' +
+                '\n' +
+                '  Usage: monolith init [--yes|-y]',
+        };
+    }
+    return { ok: true, yes: args.includes('--yes') || args.includes('-y') };
+}

package/dist/cli/ui-args.d.ts

@@ -0,0 +1,23 @@
+export declare const DEFAULT_UI_PORT = 4173;
+export declare const DEFAULT_DEV_UI_PORT = 5173;
+export declare const UI_USAGE: string;
+export declare const UI_DEV_USAGE: string;
+export type UiArgsResult = {
+    ok: true;
+    help: false;
+    dev: boolean;
+    port: number | null;
+} | {
+    ok: true;
+    help: true;
+    dev: boolean;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * Parses args after `monolith ui`. Anything that is not a known flag, the
+ * `dev` subcommand or a valid value is an explicit error (never ignored).
+ */
+export declare function parseUiArgs(args: string[]): UiArgsResult;
+//# sourceMappingURL=ui-args.d.ts.map

package/dist/cli/ui-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-args.d.ts","sourceRoot":"","sources":["../../src/cli/ui-args.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,eAAO,MAAM,QAAQ,QAUb,CAAC;AAET,eAAO,MAAM,YAAY,QAgBjB,CAAC;AAET,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC5D;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GACtC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,CA6BxD"}

package/dist/cli/ui-args.js

@@ -0,0 +1,66 @@
+export const DEFAULT_UI_PORT = 4173;
+export const DEFAULT_DEV_UI_PORT = 5173;
+export const UI_USAGE = `
+Usage:
+  monolith ui [--port N]       Serve Mission Control (read-only) for the project in the current directory
+  monolith ui dev [--port N]   Mission Control with Vite hot reload (source checkout only)
+
+Options:
+  --port N     Port to listen on (1-65535). Default: ${DEFAULT_UI_PORT} (ui), ${DEFAULT_DEV_UI_PORT} (ui dev)
+  --help, -h   Show this help
+
+The server listens on 127.0.0.1 only; there is no option to change that.
+`.trim();
+export const UI_DEV_USAGE = `
+Usage:
+  monolith ui dev [--port N]
+
+Development mode for Mission Control. Starts the read-only dashboard API on a
+free loopback port for the project in the current directory, and a Vite dev
+server with hot module reload that proxies /api/dashboard to it.
+
+Requires a source checkout of MONOLITH with its devDependencies installed
+(ui/ and vite are not part of the published package).
+
+Options:
+  --port N     Port of the Vite dev server (1-65535). Default: ${DEFAULT_DEV_UI_PORT}
+  --help, -h   Show this help
+
+Both servers listen on 127.0.0.1 only.
+`.trim();
+/**
+ * Parses args after `monolith ui`. Anything that is not a known flag, the
+ * `dev` subcommand or a valid value is an explicit error (never ignored).
+ */
+export function parseUiArgs(args) {
+    let dev = false;
+    let help = false;
+    let port = null;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--help' || arg === '-h') {
+            help = true;
+        }
+        else if (arg === 'dev' && i === 0) {
+            dev = true;
+        }
+        else if (arg === '--host' || arg.startsWith('--host=')) {
+            return {
+                ok: false,
+                message: "'--host' is not supported: Mission Control listens on 127.0.0.1 only (ADR-010 G2) and has no authentication, so it must not be exposed to a network.",
+            };
+        }
+        else if (arg === '--port' || arg.startsWith('--port=')) {
+            const inline = arg.startsWith('--port=');
+            const value = inline ? arg.slice('--port='.length) : args[++i];
+            if (value === undefined || !/^\d{1,5}$/.test(value) || Number(value) < 1 || Number(value) > 65535) {
+                return { ok: false, message: `Invalid --port value '${value ?? ''}': expected an integer from 1 to 65535.` };
+            }
+            port = Number(value);
+        }
+        else {
+            return { ok: false, message: `Unknown argument for 'monolith ui${dev ? ' dev' : ''}': ${arg}` };
+        }
+    }
+    return help ? { ok: true, help: true, dev } : { ok: true, help: false, dev, port };
+}

package/dist/cli/ui.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `monolith ui` — launches Mission Control (ADR-010) for the project in the
+ * current directory.
+ *
+ *   monolith ui       production: the built UI (dist/ui) and the read-only API on
+ *                     one loopback port. No Vite, no devDependencies.
+ *   monolith ui dev   development: the same API on a free loopback port plus a
+ *                     Vite dev server (HMR) that proxies /api/dashboard to it.
+ *
+ * Nothing here writes to the project, runs project code or opens a browser.
+ * Expected user errors are one line on stderr and exit code 1, never a stack.
+ */
+/** Thrown for expected, user-fixable failures. */
+export declare class UiLaunchError extends Error {
+}
+export interface UiLaunchOptions {
+    /** Project root (default: cwd). */
+    projectRoot?: string;
+    /** Directory of the built UI (default: `dist/ui` next to this module). */
+    uiDir?: string;
+    /** Source checkout root holding `ui/` and `node_modules/vite` (default: package root). */
+    packageRoot?: string;
+    /** Listen port; 0 = any free port (tests). */
+    port: number;
+    log?: (line: string) => void;
+}
+export interface UiHandle {
+    readonly url: string;
+    /** Stops everything this launch started and resolves when it is gone. */
+    stop(): Promise<void>;
+    /** Resolves with the exit code when the launch ends by itself (dev: Vite exited). */
+    readonly ended: Promise<number>;
+}
+/** The project must be a MONOLITH instance: contained `monolithRoot` that exists as a real directory. */
+export declare function assertMonolithProject(projectRoot: string): void;
+export declare function launchUi(opts: UiLaunchOptions): Promise<UiHandle>;
+export declare function launchUiDev(opts: UiLaunchOptions): Promise<UiHandle>;
+/** CLI entry for `monolith ui ...`. Resolves with the process exit code once the launch has ended. */
+export declare function runUi(args: string[]): Promise<number>;
+//# sourceMappingURL=ui.d.ts.map

package/dist/cli/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/cli/ui.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;GAWG;AAWH,kDAAkD;AAClD,qBAAa,aAAc,SAAQ,KAAK;CAAG;AAE3C,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,qFAAqF;IACrF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CACjC;AAMD,yGAAyG;AACzG,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAqB/D;AAiBD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAuBvE;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAoD1E;AAED,sGAAsG;AACtG,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA8C3D"}