@jinn-network/client 0.1.2 → 0.1.3-canary.2d6b2676

package/dist/cli/commands/solver-nets.js

@@ -0,0 +1,207 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { parseArgs } from 'node:util';
+import { loadConfig } from '../../config.js';
+import { buildHarnesses } from '../../harnesses/impls/index.js';
+import { loadSolverNets } from '../../solver-nets/registry.js';
+const DEFAULT_CONFIG_PATH = join(homedir(), '.jinn-client', 'config.json');
+function configPathFrom(argv) {
+    const idx = argv.indexOf('--config');
+    return idx >= 0 && argv[idx + 1] ? argv[idx + 1] : DEFAULT_CONFIG_PATH;
+}
+function readConfig(path) {
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+function writeConfig(path, cfg) {
+    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+    writeFileSync(path, JSON.stringify(cfg, null, 2) + '\n', 'utf-8');
+}
+function ensureSolverNets(cfg) {
+    cfg.solverNets ??= {};
+    return cfg.solverNets;
+}
+function predictionDefault() {
+    return {
+        enabled: true,
+        solverType: 'prediction.v0',
+        canonicalPlugin: 'bundled:jinn-prediction-plugin',
+        harness: 'claude-code-learner',
+        plugins: [],
+        taskGenerator: { enabled: true },
+    };
+}
+function sourceOf(entry) {
+    return typeof entry === 'string' ? entry : entry.source;
+}
+function writeJson(ctx, value) {
+    ctx.writer.write(JSON.stringify(value, null, 2) + '\n');
+}
+function fail(ctx, message) {
+    writeJson(ctx, { error: { code: 'invalid_invocation', message } });
+    ctx.exit(1);
+}
+function enableArgs(rest) {
+    const out = {};
+    for (let i = 0; i < rest.length; i += 1) {
+        const arg = rest[i];
+        if (!arg.startsWith('--'))
+            continue;
+        const stripped = arg.slice(2);
+        const eq = stripped.indexOf('=');
+        const key = eq >= 0 ? stripped.slice(0, eq) : stripped;
+        if (key === 'config' || key === 'harness' || key === 'json' || key === 'human') {
+            if (eq < 0 && (key === 'config' || key === 'harness'))
+                i += 1;
+            continue;
+        }
+        out[key] = eq >= 0
+            ? stripped.slice(eq + 1)
+            : rest[i + 1] && !rest[i + 1].startsWith('--')
+                ? rest[++i]
+                : '';
+    }
+    return out;
+}
+const command = {
+    name: 'solver-nets',
+    summary: 'Manage SolverNet activation, Harness selection, and SolverNet-scoped plugins',
+    helpText: `Usage:
+  jinn solver-nets list [--config <path>]
+  jinn solver-nets show <name> [--config <path>]
+  jinn solver-nets enable <name> [--harness <name>] [--config <path>]
+  jinn solver-nets disable <name> [--config <path>]
+  jinn solver-nets set-harness <name> <harness> [--config <path>]
+  jinn solver-nets add-plugin <name> <source> [--config <path>]
+  jinn solver-nets remove-plugin <name> <source-or-name> [--config <path>]
+  jinn solver-nets doctor <name> [--config <path>]`,
+    async run(ctx) {
+        const [subverb, ...rest] = ctx.argv;
+        const configPath = configPathFrom(ctx.argv);
+        const cfg = readConfig(configPath);
+        const parsed = parseArgs({
+            args: rest,
+            allowPositionals: true,
+            strict: false,
+            options: {
+                config: { type: 'string' },
+                harness: { type: 'string' },
+            },
+        });
+        const [name, arg2] = parsed.positionals;
+        if (!subverb || subverb === 'list') {
+            const loaded = loadConfig(configPath);
+            writeJson(ctx, {
+                verb: 'solver-nets list',
+                configPath,
+                solverNets: Object.entries(loaded.solverNets).map(([netName, net]) => ({
+                    name: netName,
+                    enabled: net.enabled,
+                    solverType: net.solverType,
+                    harness: net.harness,
+                    canonicalPlugin: net.canonicalPlugin,
+                    pluginCount: net.plugins.length,
+                    taskGeneratorEnabled: net.taskGenerator.enabled,
+                })),
+            });
+            return;
+        }
+        if (!name) {
+            fail(ctx, `solver-nets ${subverb} requires <name>`);
+            return;
+        }
+        const solverNets = ensureSolverNets(cfg);
+        if (name === 'prediction' && !solverNets[name]) {
+            solverNets[name] = predictionDefault();
+        }
+        const net = solverNets[name];
+        if (!net) {
+            fail(ctx, `Unknown SolverNet: ${name}`);
+            return;
+        }
+        if (subverb === 'show' || subverb === 'doctor') {
+            writeJson(ctx, { verb: `solver-nets ${subverb}`, configPath, name, solverNet: net });
+            return;
+        }
+        if (subverb === 'enable') {
+            net.enabled = true;
+            if (typeof parsed.values.harness === 'string')
+                net.harness = parsed.values.harness;
+            writeConfig(configPath, cfg);
+            const loaded = loadConfig(configPath);
+            const registry = await loadSolverNets(loaded);
+            const loadedNet = registry.get(name);
+            const selectedHarness = loadedNet?.harness ?? net.harness;
+            let enableResult = null;
+            if (loadedNet && selectedHarness) {
+                const harness = buildHarnesses({
+                    stub: true,
+                    rpcUrl: loaded.rpcUrl,
+                    archiveRpcUrl: loaded.archiveRpcUrl,
+                    claudePath: loaded.claudePath,
+                    claudeModel: loaded.claudeModel,
+                    implStateDirRoot: loaded.engine.implStateDirRoot,
+                }).find((candidate) => candidate.name === selectedHarness);
+                if (harness?.onEnable) {
+                    enableResult = await harness.onEnable({
+                        solverNet: { name: loadedNet.name, solverType: loadedNet.solverType },
+                        runtimePlugins: [loadedNet.canonicalPlugin, ...loadedNet.plugins],
+                        args: enableArgs(rest),
+                    });
+                }
+            }
+            writeJson(ctx, { verb: 'solver-nets enable', configPath, name, solverNet: net, enableResult });
+            return;
+        }
+        if (subverb === 'disable') {
+            net.enabled = false;
+            writeConfig(configPath, cfg);
+            writeJson(ctx, { verb: 'solver-nets disable', configPath, name, solverNet: net });
+            return;
+        }
+        if (subverb === 'set-harness') {
+            if (!arg2) {
+                fail(ctx, 'solver-nets set-harness requires <harness>');
+                return;
+            }
+            net.harness = arg2;
+            writeConfig(configPath, cfg);
+            writeJson(ctx, { verb: 'solver-nets set-harness', configPath, name, harness: arg2 });
+            return;
+        }
+        if (subverb === 'add-plugin') {
+            if (!arg2) {
+                fail(ctx, 'solver-nets add-plugin requires <source>');
+                return;
+            }
+            const current = net.plugins ?? [];
+            if (!current.some((entry) => sourceOf(entry) === arg2)) {
+                net.plugins = [...current, arg2];
+            }
+            writeConfig(configPath, cfg);
+            writeJson(ctx, { verb: 'solver-nets add-plugin', configPath, name, source: arg2 });
+            return;
+        }
+        if (subverb === 'remove-plugin') {
+            if (!arg2) {
+                fail(ctx, 'solver-nets remove-plugin requires <source-or-name>');
+                return;
+            }
+            const current = net.plugins ?? [];
+            net.plugins = current.filter((entry) => typeof entry === 'string' ? entry !== arg2 : entry.source !== arg2 && entry.name !== arg2);
+            writeConfig(configPath, cfg);
+            writeJson(ctx, { verb: 'solver-nets remove-plugin', configPath, name, removed: arg2 });
+            return;
+        }
+        fail(ctx, `Unknown solver-nets subverb: ${subverb}`);
+    },
+};
+export default command;
+//# sourceMappingURL=solver-nets.js.map

package/dist/cli/commands/solver-nets.js.map

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

package/dist/cli/commands/solver-plugins.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `jinn solver-plugins show|validate|pack` — author/curator tooling.
+ *
+ * These commands inspect SolverPlugin packages. They do not activate plugins;
+ * operators attach plugins to SolverNets with `jinn solver-nets add-plugin`.
+ */
+import type { CommandModule } from '../command.js';
+declare const command: CommandModule;
+export default command;

package/dist/cli/commands/solver-plugins.js

@@ -0,0 +1,184 @@
+/**
+ * `jinn solver-plugins show|validate|pack` — author/curator tooling.
+ *
+ * These commands inspect SolverPlugin packages. They do not activate plugins;
+ * operators attach plugins to SolverNets with `jinn solver-nets add-plugin`.
+ */
+import { spawnSync } from 'node:child_process';
+import { existsSync, mkdirSync } from 'node:fs';
+import { basename, dirname, isAbsolute, resolve } from 'node:path';
+import { parseArgs } from 'node:util';
+import { digestDirectory, loadSolverPluginManifest, resolveSolverPlugin } from '../../plugins/index.js';
+function writeJson(ctx, value) {
+    ctx.writer.write(JSON.stringify(value) + '\n');
+}
+function localRoot(target) {
+    const stripped = target.startsWith('file:') || target.startsWith('path:')
+        ? target.slice(target.indexOf(':') + 1)
+        : target;
+    return isAbsolute(stripped) ? stripped : resolve(process.cwd(), stripped);
+}
+async function show(ctx, rest) {
+    const target = rest.find((arg) => !arg.startsWith('--'));
+    if (!target) {
+        writeJson(ctx, { error: { code: 'invalid_invocation', message: 'solver-plugins show requires <source-or-path>' } });
+        ctx.exit(1);
+        return;
+    }
+    try {
+        const plugin = await resolveSolverPlugin(target);
+        writeJson(ctx, {
+            verb: 'solver-plugins show',
+            plugin: {
+                name: plugin.name,
+                version: plugin.version,
+                solverType: plugin.solverType,
+                source: plugin.source,
+                sourceKind: plugin.sourceKind,
+                root: plugin.root,
+                manifestPath: plugin.manifestPath,
+                sha256: plugin.sha256,
+                jinn: plugin.manifest.jinn,
+            },
+        });
+    }
+    catch (err) {
+        writeJson(ctx, {
+            error: {
+                code: 'invalid_solver_plugin',
+                message: err instanceof Error ? err.message : String(err),
+            },
+        });
+        ctx.exit(1);
+    }
+}
+async function validate(ctx, rest) {
+    const target = rest.find((arg) => !arg.startsWith('--'));
+    if (!target) {
+        writeJson(ctx, { error: { code: 'invalid_invocation', message: 'solver-plugins validate requires <source-or-path>' } });
+        ctx.exit(1);
+        return;
+    }
+    try {
+        const plugin = await resolveSolverPlugin(target);
+        writeJson(ctx, {
+            verb: 'solver-plugins validate',
+            ok: true,
+            plugin: {
+                name: plugin.name,
+                version: plugin.version,
+                solverType: plugin.solverType,
+                sha256: plugin.sha256,
+                manifestPath: plugin.manifestPath,
+            },
+        });
+    }
+    catch (err) {
+        writeJson(ctx, {
+            verb: 'solver-plugins validate',
+            ok: false,
+            error: {
+                code: 'invalid_solver_plugin',
+                message: err instanceof Error ? err.message : String(err),
+            },
+        });
+        ctx.exit(1);
+    }
+}
+async function pack(ctx, rest) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: rest,
+            allowPositionals: true,
+            options: {
+                out: { type: 'string' },
+            },
+        });
+    }
+    catch (err) {
+        writeJson(ctx, { error: { code: 'invalid_invocation', message: err instanceof Error ? err.message : String(err) } });
+        ctx.exit(1);
+        return;
+    }
+    const target = parsed.positionals[0];
+    if (!target) {
+        writeJson(ctx, { error: { code: 'invalid_invocation', message: 'solver-plugins pack requires <path>' } });
+        ctx.exit(1);
+        return;
+    }
+    const root = localRoot(target);
+    if (!existsSync(root)) {
+        writeJson(ctx, { error: { code: 'not_found', message: `SolverPlugin path not found: ${root}` } });
+        ctx.exit(1);
+        return;
+    }
+    try {
+        const { path: manifestPath, manifest } = loadSolverPluginManifest(root);
+        const sha256 = digestDirectory(root);
+        const out = parsed.values.out
+            ? resolve(process.cwd(), String(parsed.values.out))
+            : resolve(process.cwd(), `${manifest.name}-${manifest.version}.tgz`);
+        mkdirSync(dirname(out), { recursive: true });
+        const tar = spawnSync('tar', ['-czf', out, '-C', dirname(root), basename(root)], { encoding: 'utf8' });
+        if (tar.status !== 0) {
+            throw new Error(tar.stderr || `tar exited ${tar.status}`);
+        }
+        writeJson(ctx, {
+            verb: 'solver-plugins pack',
+            packagePath: out,
+            plugin: {
+                name: manifest.name,
+                version: manifest.version,
+                solverType: manifest.jinn.solverType,
+                manifestPath,
+                sha256,
+            },
+        });
+    }
+    catch (err) {
+        writeJson(ctx, {
+            error: {
+                code: 'invalid_solver_plugin',
+                message: err instanceof Error ? err.message : String(err),
+            },
+        });
+        ctx.exit(1);
+    }
+}
+const command = {
+    name: 'solver-plugins',
+    summary: 'Inspect, validate, and pack SolverPlugin packages',
+    helpText: `Usage:
+  jinn solver-plugins show <source-or-path>
+  jinn solver-plugins validate <source-or-path>
+  jinn solver-plugins pack <path> [--out <file.tgz>]
+
+SolverPlugin commands are author and curator tooling. They do not activate a
+plugin for runtime use. Attach runtime plugins with:
+  jinn solver-nets add-plugin <solver-net> <source>
+`,
+    async run(ctx) {
+        const [subverb, ...rest] = ctx.argv;
+        if (!subverb || subverb === '--help' || subverb === '-h') {
+            ctx.writer.write(command.helpText + '\n');
+            return;
+        }
+        if (subverb === 'show')
+            return show(ctx, rest);
+        if (subverb === 'validate')
+            return validate(ctx, rest);
+        if (subverb === 'pack')
+            return pack(ctx, rest);
+        writeJson(ctx, {
+            error: {
+                code: 'invalid_invocation',
+                message: `Unknown solver-plugins subverb: ${subverb}`,
+                expected: 'show|validate|pack',
+            },
+        });
+        ctx.exit(1);
+    },
+};
+export default command;
+//# sourceMappingURL=solver-plugins.js.map

package/dist/cli/commands/solver-plugins.js.map

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

package/dist/cli/commands/status.d.ts

@@ -1,3 +1,13 @@
 import type { CommandModule } from '../command.js';
+import { gatherIntrospectionRaw as defaultGatherIntrospectionRaw } from '../introspection-context.js';
+import { assembleStatusRollupV1 as defaultAssembleStatusRollupV1 } from '../../api/status-rollup-build.js';
+import { loadConfig, getConfigPathFromArgs } from '../../config.js';
+export interface StatusDeps {
+    gatherIntrospectionRaw: typeof defaultGatherIntrospectionRaw;
+    assembleStatusRollupV1: typeof defaultAssembleStatusRollupV1;
+    loadConfig?: typeof loadConfig;
+    getConfigPathFromArgs?: typeof getConfigPathFromArgs;
+}
+export declare function createStatusCommand(deps?: StatusDeps): CommandModule;
 declare const command: CommandModule;
 export default command;

package/dist/cli/commands/status.js

@@ -1,46 +1,61 @@
 import { COMMON_FLAGS, parseCommandArgs } from '../command.js';
 import { emitResult } from '../output.js';
 import { emitEnvelope } from '../../errors/envelope.js';
-import { gatherIntrospectionRaw } from '../introspection-context.js';
-import { assembleStatusRollupV1 } from '../../api/status-rollup-build.js';
+import { gatherIntrospectionRaw as defaultGatherIntrospectionRaw } from '../introspection-context.js';
+import { assembleStatusRollupV1 as defaultAssembleStatusRollupV1 } from '../../api/status-rollup-build.js';
+import { loadConfig, getConfigPathFromArgs, buildConfigProvenance } from '../../config.js';
+const PRODUCTION_DEPS = {
+    gatherIntrospectionRaw: defaultGatherIntrospectionRaw,
+    assembleStatusRollupV1: defaultAssembleStatusRollupV1,
+};
+function humanDetail(d) {
+    const lines = ['', '--- detail ---'];
+    lines.push(`bootstrap: ${d.lastBootstrapStep ?? 'no fleet yet'}${d.fleetUpdatedAt ? ` (updated ${d.fleetUpdatedAt})` : ''}`);
+    if (d.lastDaemonEvent) {
+        const e = d.lastDaemonEvent;
+        lines.push(`last event: ${e.ts ?? 'unknown time'} ${e.kind}${e.outcome ? ` outcome=${e.outcome}` : ''}${e.txHash ? ` tx=${e.txHash.slice(0, 10)}…` : ''}`);
+    }
+    else {
+        lines.push('last event: none yet');
+    }
+    if (d.lastClaudeSession) {
+        const s = d.lastClaudeSession;
+        const dur = Math.round(s.durationMs / 1000);
+        lines.push(`last claude session: req=${s.requestId.slice(0, 10)}… sess=${s.sessionId.slice(0, 8)}… dur=${dur}s${s.aborted ? ' ABORTED' : ''}`);
+    }
+    else {
+        lines.push('last claude session: none yet');
+    }
+    lines.push(`last chain tx: ${d.lastChainTx ?? 'none yet'}`);
+    if (d.latestSetupArchive) {
+        lines.push(`previous setup archive: ${d.latestSetupArchive.backupStatePath} ` +
+            `(services ${d.latestSetupArchive.serviceIndexes.join(', ') || '-'})`);
+    }
+    lines.push('next actions:');
+    for (const action of d.nextActions) {
+        lines.push(`  • ${action}`);
+    }
+    return lines.join('\n');
+}
 function humanStatus(v) {
     const health = v.exit.blocking ? `degraded: ${v.exit.hint ?? 'attention needed'}` : 'healthy';
-    return [
+    const parts = [
         `daemon=${v.daemon.state} network=${v.daemon.network} chain=${v.rpc.chainId} block=${v.rpc.blockNumber}`,
         `health=${health}`,
         `fleet: ${v.fleet.size} services, ${v.fleet.complete} complete, ${v.fleet.needsAttention} need attention`,
         `pending: ${v.earnings.pendingTotal} reward-wei`,
         v.exit.blocking && v.exit.hint ? `hint: ${v.exit.hint}` : '',
-    ].filter(Boolean).join('\n');
-}
-async function run(ctx) {
-    let parsed;
-    try {
-        parsed = parseCommandArgs(ctx.argv, { ...COMMON_FLAGS });
-    }
-    catch (err) {
-        emitEnvelope({
-            code: 'invalid_invocation',
-            message: err instanceof Error ? err.message : String(err),
-            exampleCli: 'jinn status',
-            details: { field: 'flags' },
-        }, { writer: ctx.writer, exit: ctx.exit });
-        return;
+    ].filter(Boolean);
+    if (v.detail) {
+        parts.push(humanDetail(v.detail));
     }
-    const raw = await gatherIntrospectionRaw({ argv: ctx.argv });
-    const payload = assembleStatusRollupV1(raw);
-    emitResult(payload, (v) => humanStatus(v), {
-        json: Boolean(parsed.values.json),
-        human: Boolean(parsed.values.human),
-        writer: ctx.writer,
-        stdoutIsTty: ctx.stdoutIsTty,
-        noColor: Boolean(ctx.env['NO_COLOR']),
-    });
+    return parts.join('\n');
 }
-const command = {
-    name: 'status',
-    summary: 'Daemon liveness + roll-up (poll this for monitoring; pull detail separately)',
-    helpText: `Usage: jinn status [--human]
+export function createStatusCommand(deps = PRODUCTION_DEPS) {
+    return {
+        name: 'status',
+        summary: 'Daemon liveness + roll-up (poll this for monitoring; pull detail separately)',
+        helpText: `Usage: jinn status [--detail] [--human]
 
 Emits the §4.1 roll-up: daemon state, RPC reachability, fleet size /
 complete / needsAttention counts, pending earnings total, and a
@@ -54,11 +69,59 @@ A monitoring loop needs only these fields:
 All of (rpc.ok === true && fleet.needsAttention === 0 && exit.blocking === false)
 means healthy. Pull \`jinn fleet\` or \`jinn history\` for detail.
 
+--detail  Include diagnostic detail: last bootstrap step, last daemon event,
+          last Claude session, last chain tx, and next operator actions.
+          Addresses audit finding U4 — single "what's happening?" command.
+
 Examples:
   jinn status
-  jinn status --human
+  jinn status --detail
+  jinn status --detail --human
 `,
-    run,
-};
+        async run(ctx) {
+            let parsed;
+            try {
+                parsed = parseCommandArgs(ctx.argv, {
+                    ...COMMON_FLAGS,
+                    detail: { type: 'boolean', default: false },
+                });
+            }
+            catch (err) {
+                emitEnvelope({
+                    code: 'invalid_invocation',
+                    message: err instanceof Error ? err.message : String(err),
+                    exampleCli: 'jinn status',
+                    details: { field: 'flags' },
+                }, { writer: ctx.writer, exit: ctx.exit });
+                return;
+            }
+            const configPath = (deps.getConfigPathFromArgs ?? getConfigPathFromArgs)(ctx.argv ?? []) ??
+                getConfigPathFromArgs(process.argv.slice(2));
+            let configProvenance;
+            try {
+                const cfg = (deps.loadConfig ?? loadConfig)(configPath);
+                configProvenance = buildConfigProvenance(configPath, cfg, ctx.env);
+            }
+            catch {
+                /* non-fatal — status works even without a valid config file */
+            }
+            const raw = await deps.gatherIntrospectionRaw({ argv: ctx.argv });
+            const rollup = deps.assembleStatusRollupV1(raw, {
+                includeDetail: Boolean(parsed.values.detail),
+            });
+            const payload = configProvenance !== undefined
+                ? { ...rollup, config: configProvenance }
+                : rollup;
+            emitResult(payload, (v) => humanStatus(v), {
+                json: Boolean(parsed.values.json),
+                human: Boolean(parsed.values.human),
+                writer: ctx.writer,
+                stdoutIsTty: ctx.stdoutIsTty,
+                noColor: Boolean(ctx.env['NO_COLOR']),
+            });
+        },
+    };
+}
+const command = createStatusCommand();
 export default command;
 //# sourceMappingURL=status.js.map

package/dist/cli/commands/status.js.map

@@ -1 +1 @@
-{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/cli/commands/status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAG1E,SAAS,WAAW,CAAC,CAAyB;IAC5C,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,kBAAkB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9F,OAAO;QACL,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,YAAY,CAAC,CAAC,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE;QACxG,UAAU,MAAM,EAAE;QAClB,UAAU,CAAC,CAAC,KAAK,CAAC,IAAI,cAAc,CAAC,CAAC,KAAK,CAAC,QAAQ,cAAc,CAAC,CAAC,KAAK,CAAC,cAAc,iBAAiB;QACzG,YAAY,CAAC,CAAC,QAAQ,CAAC,YAAY,aAAa;QAChD,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;KAC7D,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,KAAK,UAAU,GAAG,CAAC,GAAmB;IACpC,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,YAAY,EAAE,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,YAAY,CACV;YACE,IAAI,EAAE,oBAAoB;YAC1B,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YACzD,UAAU,EAAE,aAAa;YACzB,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;SAC5B,EACD,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CACvC,CAAC;QACF,OAAO;IACT,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,sBAAsB,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC5C,UAAU,CACR,OAAO,EACP,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAA2B,CAAC,EAC/C;QACE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QACjC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QACnC,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;KACtC,CACF,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,GAAkB;IAC7B,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,8EAA8E;IACvF,QAAQ,EAAE;;;;;;;;;;;;;;;;;CAiBX;IACC,GAAG;CACJ,CAAC;AAEF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/cli/commands/status.ts"],"names":[],"mappings":"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"}