mythik-cli 0.1.0

package/dist/commands/contract.js

@@ -0,0 +1,133 @@
+import { runContract } from 'mythik';
+import { formatSuccess, formatError, formatJson } from '../output.js';
+export async function runContractCommand(options) {
+    try {
+        // 1. Load AppSpec
+        let app;
+        const appDoc = await options.store.load(options.appId);
+        if (appDoc && typeof appDoc === 'object') {
+            app = appDoc;
+        }
+        // 2. Discover screens from AppSpec
+        const screenIds = [];
+        if (app?.screens && typeof app.screens === 'object') {
+            screenIds.push(...Object.keys(app.screens));
+        }
+        // Also include loginScreen
+        const nav = app?.navigation;
+        const authConfig = nav?.auth;
+        if (authConfig?.loginScreen) {
+            const loginId = authConfig.loginScreen;
+            if (!screenIds.includes(loginId))
+                screenIds.push(loginId);
+        }
+        // 3. Load all screen specs
+        const screens = {};
+        for (const id of screenIds) {
+            try {
+                const doc = await options.store.load(id);
+                if (doc && typeof doc === 'object') {
+                    screens[id] = doc;
+                }
+            }
+            catch {
+                // Screen might not exist in store — skip
+            }
+        }
+        // 4. Load all api-specs (from apiStore if provided, otherwise same store)
+        const apiLoader = options.apiStore ?? options.store;
+        const apis = [];
+        for (const apiId of options.apiIds) {
+            try {
+                const doc = await apiLoader.load(apiId);
+                if (doc && typeof doc === 'object') {
+                    apis.push({ id: apiId, spec: doc });
+                }
+            }
+            catch {
+                // api-spec not found
+            }
+        }
+        if (apis.length === 0) {
+            return {
+                output: formatError({ what: 'No api-specs found', why: `Could not load: ${options.apiIds.join(', ')}`, fix: 'Check api-spec IDs and store configuration' }),
+                exitCode: 1,
+            };
+        }
+        // 5. Base URL — explicit only (no auto-detect)
+        const baseUrl = options.baseUrl;
+        // 6. Run contract
+        const result = runContract({ app, screens, apis, baseUrl });
+        // 7. Format output
+        if (options.json) {
+            return { output: formatJson(result), exitCode: result.valid ? 0 : 1 };
+        }
+        const apiNames = options.apiIds.join(', ');
+        const lines = [];
+        if (result.findings.length === 0) {
+            lines.push(formatSuccess(`Contract valid — ${options.appId} ↔ ${apiNames}`));
+            lines.push('');
+            lines.push(`  \u2713 ${result.summary.rulesRun} rules passed`);
+            lines.push(`  \u2713 ${result.summary.fetchReferences} fetch references verified across ${result.summary.screens} screens`);
+            lines.push(`  \u2713 ${result.summary.endpointsCovered} endpoints covered`);
+            lines.push(`  \u2713 0 errors, 0 warnings`);
+        }
+        else {
+            lines.push(`Mythik Contract \u2014 ${options.appId} \u2194 ${apiNames}`);
+            lines.push('');
+            const errors = result.findings.filter(f => f.level === 'error');
+            const warnings = result.findings.filter(f => f.level === 'warning');
+            if (errors.length > 0) {
+                lines.push(`  \u2717 ERRORS (${errors.length})`);
+                lines.push('');
+                for (const [screen, screenFindings] of groupByScreen(errors)) {
+                    lines.push(`  Screen: ${screen}`);
+                    for (const f of screenFindings) {
+                        const countTag = f.count && f.count > 1 ? ` (\u00d7${f.count})` : '';
+                        lines.push(`    \u2717 [${f.rule}] ${f.message}${countTag}`);
+                        if (f.suggestion)
+                            lines.push(`      \u2192 ${f.suggestion}`);
+                    }
+                    lines.push('');
+                }
+            }
+            if (warnings.length > 0) {
+                lines.push(`  \u26A0 WARNINGS (${warnings.length})`);
+                lines.push('');
+                for (const [screen, screenFindings] of groupByScreen(warnings)) {
+                    lines.push(`  Screen: ${screen}`);
+                    for (const f of screenFindings) {
+                        const countTag = f.count && f.count > 1 ? ` (\u00d7${f.count})` : '';
+                        lines.push(`    \u26A0 [${f.rule}] ${f.message}${countTag}`);
+                        if (f.suggestion)
+                            lines.push(`      \u2192 ${f.suggestion}`);
+                    }
+                    lines.push('');
+                }
+            }
+            lines.push(`  Summary: ${result.summary.errors} errors, ${result.summary.warnings} warnings`);
+        }
+        return { output: lines.join('\n'), exitCode: result.valid ? 0 : 1 };
+    }
+    catch (err) {
+        const message = err.message;
+        if (options.json) {
+            return { output: formatJson({ error: message }), exitCode: 1 };
+        }
+        return {
+            output: formatError({ what: 'Contract check failed', why: message }),
+            exitCode: 1,
+        };
+    }
+}
+function groupByScreen(findings) {
+    const map = new Map();
+    for (const f of findings) {
+        const screen = f.screen ?? '(unknown)';
+        if (!map.has(screen))
+            map.set(screen, []);
+        map.get(screen).push(f);
+    }
+    return map;
+}
+//# sourceMappingURL=contract.js.map

package/dist/commands/contract.js.map

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

package/dist/commands/delete.d.ts

@@ -0,0 +1,9 @@
+import type { SpecStore } from 'mythik';
+import type { CommandResult } from './manifest.js';
+export interface DeleteOptions {
+    store: SpecStore;
+    json: boolean;
+    confirm: boolean;
+}
+export declare function runDelete(screenId: string, options: DeleteOptions): Promise<CommandResult>;
+//# sourceMappingURL=delete.d.ts.map

package/dist/commands/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../src/commands/delete.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAIxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CA8ChG"}

package/dist/commands/delete.js

@@ -0,0 +1,46 @@
+import { createSpecEngine, getDocumentHandler } from 'mythik';
+import { formatError, formatJson, formatJsonPretty, formatWarning } from '../output.js';
+import { suggest } from '../levenshtein.js';
+export async function runDelete(screenId, options) {
+    const engine = createSpecEngine({ store: options.store });
+    try {
+        if (!options.confirm) {
+            const doc = await options.store.load(screenId);
+            const handler = getDocumentHandler(doc);
+            const elementCount = handler.countElements(doc);
+            if (options.json) {
+                return { output: formatJson({ preview: true, screenId, elementCount }), exitCode: 0 };
+            }
+            return {
+                output: formatWarning(`Screen "${screenId}" (${elementCount} elements). Use --confirm to delete.`),
+                exitCode: 0,
+            };
+        }
+        const { spec } = await engine.delete(screenId);
+        if (options.json) {
+            return { output: formatJson({ success: true, screenId, deletedSpec: spec }), exitCode: 0 };
+        }
+        return { output: formatJsonPretty(spec), exitCode: 0 };
+    }
+    catch (err) {
+        const message = err.message;
+        let availableScreens = [];
+        try {
+            availableScreens = await options.store.list();
+        }
+        catch { /* ignore */ }
+        const suggestion = suggest(screenId, availableScreens);
+        if (options.json) {
+            return { output: formatJson({ error: message, suggestion }), exitCode: 1 };
+        }
+        return {
+            output: formatError({
+                what: `Screen "${screenId}" not found`,
+                why: availableScreens.length > 0 ? `Available screens: ${availableScreens.join(', ')}` : message,
+                fix: suggestion ? `Did you mean: ${suggestion}?` : 'Check the screen ID and try again',
+            }),
+            exitCode: 1,
+        };
+    }
+}
+//# sourceMappingURL=delete.js.map

package/dist/commands/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../src/commands/delete.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAS5C,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,OAAsB;IACtE,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAE1D,IAAI,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC/C,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACxC,MAAM,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;YAEhD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACjB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YACxF,CAAC;YAED,OAAO;gBACL,MAAM,EAAE,aAAa,CAAC,WAAW,QAAQ,MAAM,YAAY,sCAAsC,CAAC;gBAClG,QAAQ,EAAE,CAAC;aACZ,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAE/C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAC7F,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACzD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAI,GAAa,CAAC,OAAO,CAAC;QAEvC,IAAI,gBAAgB,GAAa,EAAE,CAAC;QACpC,IAAI,CAAC;YAAC,gBAAgB,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAC7E,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QAEvD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAC7E,CAAC;QAED,OAAO;YACL,MAAM,EAAE,WAAW,CAAC;gBAClB,IAAI,EAAE,WAAW,QAAQ,aAAa;gBACtC,GAAG,EAAE,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,sBAAsB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO;gBAChG,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,iBAAiB,UAAU,GAAG,CAAC,CAAC,CAAC,mCAAmC;aACvF,CAAC;YACF,QAAQ,EAAE,CAAC;SACZ,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/commands/diff.d.ts

@@ -0,0 +1,11 @@
+import type { VersionedSpecStore, EnvironmentStore } from 'mythik';
+import type { CommandResult } from './manifest.js';
+export interface DiffOptions {
+    store: VersionedSpecStore;
+    envStore: EnvironmentStore;
+    from: string;
+    to?: string;
+    json: boolean;
+}
+export declare function runDiff(specId: string, options: DiffOptions): Promise<CommandResult>;
+//# sourceMappingURL=diff.d.ts.map

package/dist/commands/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAGnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAuC1F"}

package/dist/commands/diff.js

@@ -0,0 +1,49 @@
+import { computeStructuralDiff } from 'mythik';
+import { formatSuccess, formatError, formatJson } from '../output.js';
+export async function runDiff(specId, options) {
+    try {
+        const fromVersion = await resolveRef(specId, options.from, options.store, options.envStore);
+        const toVersion = options.to
+            ? await resolveRef(specId, options.to, options.store, options.envStore)
+            : await options.store.currentVersion(specId);
+        const fromSpec = await options.store.loadVersion(specId, fromVersion);
+        const toSpec = await options.store.loadVersion(specId, toVersion);
+        const diff = computeStructuralDiff(fromSpec, toSpec, fromVersion, toVersion);
+        if (options.json) {
+            return { output: formatJson(diff), exitCode: 0 };
+        }
+        const lines = [];
+        lines.push(formatSuccess(`Diff: ${specId} v${fromVersion} → v${toVersion}`));
+        lines.push('');
+        if (diff.changes.length === 0) {
+            lines.push('  No changes');
+        }
+        else {
+            for (const change of diff.changes) {
+                const icon = change.kind.includes('added') ? '+' : change.kind.includes('removed') ? '-' : '~';
+                lines.push(`  ${icon} ${change.detail}`);
+            }
+            lines.push('');
+            lines.push(`  Summary: ${diff.summary}`);
+        }
+        return { output: lines.join('\n'), exitCode: 0 };
+    }
+    catch (err) {
+        const message = err.message;
+        return {
+            output: options.json ? formatJson({ error: message }) : formatError({ what: 'Diff failed', why: message }),
+            exitCode: 1,
+        };
+    }
+}
+/** Resolve a ref to a version number: numeric string, or environment name */
+async function resolveRef(specId, ref, store, envStore) {
+    const num = parseInt(ref, 10);
+    if (!isNaN(num) && String(num) === ref)
+        return num;
+    const env = await envStore.getEnvironment(specId, ref);
+    if (env)
+        return env.version;
+    throw new Error(`Cannot resolve ref "${ref}" — not a version number or environment name`);
+}
+//# sourceMappingURL=diff.js.map

package/dist/commands/diff.js.map

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

package/dist/commands/docs.d.ts

@@ -0,0 +1,15 @@
+export interface DocsCommandOptions {
+    action: string;
+    target?: string;
+    json?: boolean;
+    force?: boolean;
+    cwd?: string;
+    docsRoot?: string;
+}
+export interface DocsCommandResult {
+    output: string;
+    exitCode: number;
+}
+export declare function resolveBundledDocsRoot(packageJsonPath?: string): string;
+export declare function runDocsCommand(options: DocsCommandOptions): Promise<DocsCommandResult>;
+//# sourceMappingURL=docs.d.ts.map

package/dist/commands/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,wBAAgB,sBAAsB,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAGvE;AAkED,wBAAsB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAyD5F"}

package/dist/commands/docs.js

@@ -0,0 +1,117 @@
+import { cp, mkdir, readdir, rm, stat } from 'node:fs/promises';
+import { dirname, resolve, join, isAbsolute, parse, relative } from 'node:path';
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+export function resolveBundledDocsRoot(packageJsonPath) {
+    const resolvedPackageJson = packageJsonPath ?? require.resolve('mythik/package.json');
+    return join(dirname(resolvedPackageJson), 'docs');
+}
+async function hasRequiredDocs(root) {
+    try {
+        await stat(join(root, 'consumer', 'ai-context.md'));
+        await stat(join(root, 'wiki', 'compiled', 'README.md'));
+        await stat(join(root, 'llms.txt'));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function isNonEmptyDirectory(path) {
+    try {
+        const info = await stat(path);
+        if (!info.isDirectory())
+            return true;
+        const entries = await readdir(path);
+        return entries.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+function isSameOrAncestor(candidateAncestor, path) {
+    const relativePath = relative(candidateAncestor, path);
+    return relativePath === '' || (!relativePath.startsWith('..') && !isAbsolute(relativePath));
+}
+function validateCopyTarget(target, docsRoot, cwd) {
+    if (target === parse(target).root) {
+        return `Refusing to copy Mythik docs over a filesystem root: ${target}`;
+    }
+    if (isSameOrAncestor(docsRoot, target) || isSameOrAncestor(target, docsRoot)) {
+        return `Refusing to copy Mythik docs into or over the bundled docs directory: ${target}`;
+    }
+    if (isSameOrAncestor(target, cwd)) {
+        return `Refusing to copy Mythik docs over the current working directory or one of its ancestors: ${target}`;
+    }
+    return null;
+}
+function docsPayload(docsRoot) {
+    return {
+        docsPath: docsRoot,
+        llmsTxt: join(docsRoot, 'llms.txt'),
+        aiContext: join(docsRoot, 'consumer', 'ai-context.md'),
+        wikiReadme: join(docsRoot, 'wiki', 'compiled', 'README.md'),
+    };
+}
+function renderDocsPath(docsRoot) {
+    return [
+        'Mythik AI documentation:',
+        docsRoot,
+        '',
+        'Start here:',
+        '- llms.txt',
+        '- consumer/ai-context.md',
+        '- wiki/compiled/README.md',
+    ].join('\n');
+}
+export async function runDocsCommand(options) {
+    const action = options.action.trim().toLowerCase();
+    const docsRoot = resolve(options.docsRoot ?? resolveBundledDocsRoot());
+    if (!(await hasRequiredDocs(docsRoot))) {
+        return {
+            exitCode: 1,
+            output: `Bundled Mythik documentation was not found at ${docsRoot}. Reinstall mythik or run this command from a packaged release.`,
+        };
+    }
+    if (action === 'path') {
+        return {
+            exitCode: 0,
+            output: options.json === true
+                ? JSON.stringify(docsPayload(docsRoot), null, 2)
+                : renderDocsPath(docsRoot),
+        };
+    }
+    if (action === 'copy') {
+        if (!options.target) {
+            return { exitCode: 1, output: 'Missing target directory. Usage: mythik docs copy <dir>' };
+        }
+        const cwd = resolve(options.cwd ?? process.cwd());
+        const target = resolve(cwd, options.target);
+        const unsafeTargetReason = validateCopyTarget(target, docsRoot, cwd);
+        if (unsafeTargetReason) {
+            return { exitCode: 1, output: unsafeTargetReason };
+        }
+        if ((await isNonEmptyDirectory(target)) && options.force !== true) {
+            return {
+                exitCode: 1,
+                output: `Target directory already exists and is not empty: ${target}. Re-run with --force to replace it.`,
+            };
+        }
+        if (options.force === true) {
+            await rm(target, { recursive: true, force: true });
+        }
+        await mkdir(dirname(target), { recursive: true });
+        await cp(docsRoot, target, { recursive: true, force: true });
+        return {
+            exitCode: 0,
+            output: options.json === true
+                ? JSON.stringify({ copiedTo: target, ...docsPayload(target) }, null, 2)
+                : `Copied Mythik AI documentation to ${target}`,
+        };
+    }
+    return {
+        exitCode: 1,
+        output: `Unknown docs action "${options.action}". Use "path" or "copy".`,
+    };
+}
+//# sourceMappingURL=docs.js.map

package/dist/commands/docs.js.map

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

package/dist/commands/elements.d.ts

@@ -0,0 +1,9 @@
+import type { SpecStore } from 'mythik';
+import type { CommandResult } from './manifest.js';
+export interface ElementsOptions {
+    store: SpecStore;
+    json: boolean;
+    toon?: boolean;
+}
+export declare function runElements(screenId: string, elementIds: string[], options: ElementsOptions): Promise<CommandResult>;
+//# sourceMappingURL=elements.d.ts.map

package/dist/commands/elements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elements.d.ts","sourceRoot":"","sources":["../../src/commands/elements.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAKxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,CAiD1H"}

package/dist/commands/elements.js

@@ -0,0 +1,48 @@
+import { createSpecEngine } from 'mythik';
+import { formatError, formatJson, formatJsonPretty, formatElementHeader, formatWarning } from '../output.js';
+import { suggest } from '../levenshtein.js';
+import { toToon } from '../toon.js';
+export async function runElements(screenId, elementIds, options) {
+    const engine = createSpecEngine({ store: options.store });
+    try {
+        const result = await engine.getElements(screenId, elementIds);
+        if (options.toon) {
+            return { output: toToon(result), exitCode: 0 };
+        }
+        if (options.json) {
+            return { output: formatJson(result), exitCode: 0 };
+        }
+        const lines = [];
+        for (const [id, el] of Object.entries(result.found)) {
+            const elType = (el && typeof el === 'object' && 'type' in el) ? String(el.type) : 'section';
+            lines.push(formatElementHeader(id, elType));
+            lines.push(formatJsonPretty(el));
+            lines.push('');
+        }
+        if (result.notFound.length > 0) {
+            lines.push(formatWarning(`Not found: ${result.notFound.join(', ')}`));
+        }
+        return { output: lines.join('\n'), exitCode: 0 };
+    }
+    catch (err) {
+        const message = err.message;
+        let availableScreens = [];
+        try {
+            availableScreens = await options.store.list();
+        }
+        catch { /* ignore */ }
+        const suggestion = suggest(screenId, availableScreens);
+        const why = availableScreens.length > 0
+            ? `Available screens: ${availableScreens.join(', ')}`
+            : message;
+        const fix = suggestion ? `Did you mean: ${suggestion}?` : 'Check the screen ID and try again';
+        if (options.json) {
+            return { output: formatJson({ error: message, availableScreens, suggestion }), exitCode: 1 };
+        }
+        return {
+            output: formatError({ what: `Screen "${screenId}" not found`, why, fix }),
+            exitCode: 1,
+        };
+    }
+}
+//# sourceMappingURL=elements.js.map

package/dist/commands/elements.js.map

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

package/dist/commands/envs.d.ts

@@ -0,0 +1,11 @@
+import type { VersionedSpecStore, EnvironmentStore } from 'mythik';
+import type { CommandResult } from './manifest.js';
+export interface EnvsOptions {
+    store: VersionedSpecStore;
+    envStore: EnvironmentStore;
+    json: boolean;
+    set?: string;
+    author?: string;
+}
+export declare function runEnvs(specId: string, options: EnvsOptions): Promise<CommandResult>;
+//# sourceMappingURL=envs.d.ts.map

package/dist/commands/envs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envs.d.ts","sourceRoot":"","sources":["../../src/commands/envs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAyD1F"}

package/dist/commands/envs.js

@@ -0,0 +1,54 @@
+import { formatSuccess, formatError, formatJson } from '../output.js';
+export async function runEnvs(specId, options) {
+    try {
+        // Set mode: --set dev=12
+        if (options.set) {
+            const [env, versionStr] = options.set.split('=');
+            if (!env || !versionStr) {
+                return {
+                    output: formatError({ what: 'Invalid --set format', why: 'Use: --set env=version (e.g., --set dev=12)' }),
+                    exitCode: 1,
+                };
+            }
+            const version = parseInt(versionStr, 10);
+            if (isNaN(version)) {
+                return {
+                    output: formatError({ what: 'Invalid version', why: `"${versionStr}" is not a number` }),
+                    exitCode: 1,
+                };
+            }
+            await options.envStore.setEnvironment(specId, env, version, options.author ?? 'system');
+            return {
+                output: options.json
+                    ? formatJson({ specId, environment: env, version })
+                    : formatSuccess(`${specId} — ${env} → v${version}`),
+                exitCode: 0,
+            };
+        }
+        // List mode
+        const envs = await options.envStore.getEnvironments(specId);
+        if (options.json) {
+            return { output: formatJson(envs), exitCode: 0 };
+        }
+        if (envs.length === 0) {
+            return { output: `  No environments set for "${specId}"`, exitCode: 0 };
+        }
+        const currentVersion = await options.store.currentVersion(specId);
+        const lines = [];
+        lines.push(formatSuccess(`Environments for "${specId}"`));
+        lines.push('');
+        for (const env of envs) {
+            const latest = env.version === currentVersion ? '  (latest)' : '';
+            lines.push(`  ${env.name.padEnd(10)} v${env.version}  ${env.promotedAt.slice(0, 10)}  ${env.promotedBy}${latest}`);
+        }
+        return { output: lines.join('\n'), exitCode: 0 };
+    }
+    catch (err) {
+        const message = err.message;
+        return {
+            output: options.json ? formatJson({ error: message }) : formatError({ what: 'Envs failed', why: message }),
+            exitCode: 1,
+        };
+    }
+}
+//# sourceMappingURL=envs.js.map

package/dist/commands/envs.js.map

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

package/dist/commands/history.d.ts

@@ -0,0 +1,10 @@
+import type { VersionedSpecStore, EnvironmentStore } from 'mythik';
+import type { CommandResult } from './manifest.js';
+export interface HistoryOptions {
+    store: VersionedSpecStore;
+    envStore: EnvironmentStore;
+    json: boolean;
+    limit?: number;
+}
+export declare function runHistory(specId: string, options: HistoryOptions): Promise<CommandResult>;
+//# sourceMappingURL=history.d.ts.map

package/dist/commands/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/commands/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAGnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAkEhG"}