ctx-sync 1.0.0

package/dist/commands/service.js

@@ -0,0 +1,259 @@
+/**
+ * `ctx-sync service` command group.
+ *
+ * Manages running service state:
+ *   - `service add <project> <name>` — add / update a service.
+ *   - `service remove <project> <name>` — remove a service.
+ *   - `service list [project]` — list tracked services.
+ *   - `service start <project>` — present auto-start commands for approval.
+ *
+ * **Security:** `service start` commands go through the command validator.
+ * All start commands require explicit user confirmation — there is no
+ * `--yes` or `--no-confirm` bypass.
+ *
+ * @module commands/service
+ */
+import { execSync } from 'node:child_process';
+import { withErrorHandler } from '../utils/errors.js';
+import { STATE_FILES } from '@ctx-sync/shared';
+import { identityToRecipient } from 'age-encryption';
+import { loadKey } from '../core/key-store.js';
+import { readState } from '../core/state-manager.js';
+import { commitState } from '../core/git-sync.js';
+import { presentCommandsForApproval, } from '../core/command-validator.js';
+import { createService, validateService, addService, removeService, loadProjectServices, loadServices, listServiceProjects, getAutoStartServices, } from '../core/services-handler.js';
+import { getConfigDir, getSyncDir } from './init.js';
+// ─── Core Logic ───────────────────────────────────────────────────────────
+/**
+ * Resolve project name from argument or current directory context.
+ */
+async function resolveProjectName(projectArg, syncDir, privateKey) {
+    // Check if the project exists in tracked state
+    const stateData = await readState(syncDir, privateKey, 'state');
+    if (stateData) {
+        const match = stateData.projects.find((p) => p.name === projectArg);
+        if (match)
+            return match.name;
+    }
+    return projectArg;
+}
+/**
+ * Execute `ctx-sync service add <project> <name>`.
+ */
+export async function executeServiceAdd(project, name, options) {
+    const configDir = getConfigDir();
+    const syncDir = getSyncDir();
+    const privateKey = loadKey(configDir);
+    const publicKey = await identityToRecipient(privateKey);
+    const projectName = await resolveProjectName(project, syncDir, privateKey);
+    const service = createService(projectName, name, options.port, options.command, options.autoStart ?? false);
+    // Validate the service entry
+    const errors = validateService(service);
+    if (errors.length > 0) {
+        throw new Error(`Invalid service:\n  ${errors.join('\n  ')}`);
+    }
+    await addService(syncDir, service, publicKey, privateKey);
+    // Commit to sync repo
+    if (!options.noSync) {
+        await commitState(syncDir, [STATE_FILES.SERVICES, STATE_FILES.MANIFEST], `service: add ${projectName}/${name}`);
+    }
+    return {
+        projectName,
+        serviceName: name,
+        port: options.port,
+        command: options.command,
+        autoStart: options.autoStart ?? false,
+    };
+}
+/**
+ * Execute `ctx-sync service remove <project> <name>`.
+ */
+export async function executeServiceRemove(project, name, noSync = false) {
+    const configDir = getConfigDir();
+    const syncDir = getSyncDir();
+    const privateKey = loadKey(configDir);
+    const publicKey = await identityToRecipient(privateKey);
+    const projectName = await resolveProjectName(project, syncDir, privateKey);
+    const removed = await removeService(syncDir, projectName, name, publicKey, privateKey);
+    if (removed && !noSync) {
+        await commitState(syncDir, [STATE_FILES.SERVICES, STATE_FILES.MANIFEST], `service: remove ${projectName}/${name}`);
+    }
+    return removed;
+}
+/**
+ * Build commands for service start (without executing).
+ */
+export function buildServiceStartCommands(services) {
+    return services.map((s) => ({
+        command: s.command,
+        label: `Service: ${s.name} (port ${String(s.port)})`,
+        cwd: undefined,
+    }));
+}
+/**
+ * Execute `ctx-sync service start <project>`.
+ *
+ * Shows auto-start services for user approval, then executes approved ones.
+ */
+export async function executeServiceStart(project, options = {}) {
+    const configDir = getConfigDir();
+    const syncDir = getSyncDir();
+    const privateKey = loadKey(configDir);
+    const projectName = await resolveProjectName(project, syncDir, privateKey);
+    const autoStart = await getAutoStartServices(syncDir, privateKey, projectName);
+    if (autoStart.length === 0) {
+        return {
+            projectName,
+            commandsPresented: [],
+            approval: { approved: [], rejected: [], skippedAll: false },
+            executedCommands: [],
+            failedCommands: [],
+        };
+    }
+    const pendingCommands = buildServiceStartCommands(autoStart);
+    // Present for approval (handles interactive/non-interactive mode)
+    const approval = await presentCommandsForApproval(pendingCommands, {
+        interactive: !options.noInteractive,
+        promptFn: options.promptFn,
+        selectFn: options.selectFn,
+    });
+    const executedCommands = [];
+    const failedCommands = [];
+    for (const cmd of approval.approved) {
+        try {
+            execSync(cmd.command, { stdio: 'inherit', timeout: 30_000 });
+            executedCommands.push(cmd.command);
+        }
+        catch (err) {
+            failedCommands.push({
+                command: cmd.command,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return {
+        projectName,
+        commandsPresented: pendingCommands,
+        approval,
+        executedCommands,
+        failedCommands,
+    };
+}
+/**
+ * Execute `ctx-sync service list [project]`.
+ */
+export async function executeServiceList(project) {
+    const configDir = getConfigDir();
+    const syncDir = getSyncDir();
+    const privateKey = loadKey(configDir);
+    if (project) {
+        const projectName = await resolveProjectName(project, syncDir, privateKey);
+        const services = await loadProjectServices(syncDir, privateKey, projectName);
+        return [{ project: projectName, services }];
+    }
+    // All projects
+    const state = await loadServices(syncDir, privateKey);
+    const projects = await listServiceProjects(syncDir, privateKey);
+    return projects.map((p) => ({
+        project: p,
+        services: state.services.filter((s) => s.project === p),
+    }));
+}
+// ─── Commander Registration ───────────────────────────────────────────────
+/**
+ * Register the `ctx-sync service` command group on the given program.
+ */
+export function registerServiceCommand(program) {
+    const serviceCmd = program
+        .command('service')
+        .description('Manage tracked development services');
+    // ── service add ───────────────────────────────────────────────────
+    serviceCmd
+        .command('add <project> <name>')
+        .description('Add or update a tracked service')
+        .requiredOption('-p, --port <port>', 'Port number', parseInt)
+        .requiredOption('-c, --command <cmd>', 'Start command')
+        .option('-a, --auto-start', 'Mark as auto-start', false)
+        .option('--no-sync', 'Skip committing to sync repo')
+        .action(withErrorHandler(async (project, name, opts) => {
+        const result = await executeServiceAdd(project, name, {
+            port: opts.port,
+            command: opts.command,
+            autoStart: opts.autoStart,
+            noSync: !opts.sync,
+        });
+        console.log(`✓ Service "${result.serviceName}" added to project "${result.projectName}"`);
+        console.log(`  Port: ${String(result.port)}`);
+        console.log(`  Command: ${result.command}`);
+        if (result.autoStart) {
+            console.log('  Auto-start: yes');
+        }
+    }));
+    // ── service remove ────────────────────────────────────────────────
+    serviceCmd
+        .command('remove <project> <name>')
+        .description('Remove a tracked service')
+        .option('--no-sync', 'Skip committing to sync repo')
+        .action(withErrorHandler(async (project, name, opts) => {
+        const removed = await executeServiceRemove(project, name, !opts.sync);
+        if (removed) {
+            console.log(`✓ Service "${name}" removed from project "${project}"`);
+        }
+        else {
+            console.log(`Service "${name}" not found in project "${project}"`);
+        }
+    }));
+    // ── service list ──────────────────────────────────────────────────
+    serviceCmd
+        .command('list [project]')
+        .description('List tracked services')
+        .action(withErrorHandler(async (project) => {
+        const results = await executeServiceList(project);
+        if (results.length === 0 || results.every((r) => r.services.length === 0)) {
+            console.log('No services tracked.');
+            return;
+        }
+        for (const group of results) {
+            if (group.services.length === 0)
+                continue;
+            console.log(`\n📦 ${group.project}:`);
+            for (const svc of group.services) {
+                const auto = svc.autoStart ? ' [auto-start]' : '';
+                console.log(`  ${svc.name} — port ${String(svc.port)}${auto}`);
+                console.log(`    command: ${svc.command}`);
+            }
+        }
+    }));
+    // ── service start ─────────────────────────────────────────────────
+    serviceCmd
+        .command('start <project>')
+        .description('Start auto-start services (requires approval)')
+        .option('-n, --no-interactive', 'Show commands without executing')
+        .action(withErrorHandler(async (project, opts) => {
+        const result = await executeServiceStart(project, {
+            noInteractive: !opts.interactive,
+        });
+        if (result.commandsPresented.length === 0) {
+            console.log(`No auto-start services found for project "${result.projectName}".`);
+            return;
+        }
+        if (result.approval.skippedAll) {
+            console.log('Service commands (non-interactive — skipped):');
+            for (const cmd of result.commandsPresented) {
+                console.log(`  ${cmd.label}: ${cmd.command}`);
+            }
+            console.log('\n⚠ Non-interactive mode — commands shown but not executed.');
+            return;
+        }
+        if (result.executedCommands.length > 0) {
+            console.log(`✓ Started ${String(result.executedCommands.length)} service(s)`);
+        }
+        if (result.failedCommands.length > 0) {
+            console.error(`✗ ${String(result.failedCommands.length)} service(s) failed to start`);
+            for (const f of result.failedCommands) {
+                console.error(`  ${f.command}: ${f.error}`);
+            }
+        }
+    }));
+}
+//# sourceMappingURL=service.js.map

package/dist/commands/service.js.map

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

package/dist/commands/show.d.ts

@@ -0,0 +1,63 @@
+/**
+ * `ctx-sync show <project>` command.
+ *
+ * Decrypts and displays the full context for a project — state,
+ * env var count, mental context, Docker services, running services —
+ * in a readable, formatted terminal output.
+ *
+ * This is the "at-a-glance" view that answers: "What was I doing on
+ * this project, and what do I need to get back to work?"
+ *
+ * @module commands/show
+ */
+import type { Command } from 'commander';
+import type { Project, ProjectMentalContext } from '@ctx-sync/shared';
+/** Result of the show command */
+export interface ShowResult {
+    /** The project entry */
+    project: Project;
+    /** Number of env vars for the project */
+    envVarCount: number;
+    /** Mental context for the project (if any) */
+    mentalContext: ProjectMentalContext | null;
+    /** Docker state for the project (if any) */
+    dockerServices: Array<{
+        name: string;
+        image: string;
+        port: number;
+        autoStart: boolean;
+    }>;
+    /** Running services for the project (if any) */
+    services: Array<{
+        name: string;
+        port: number;
+        command: string;
+        autoStart: boolean;
+    }>;
+}
+/**
+ * Execute the show command logic.
+ *
+ * Decrypts all relevant state files and assembles a complete project
+ * context snapshot.
+ *
+ * @param projectName - The name of the project to show.
+ * @returns The full project context.
+ */
+export declare function executeShow(projectName: string): Promise<ShowResult>;
+/**
+ * Format the project context for terminal display.
+ *
+ * Produces a readable, chalk-formatted output string that shows
+ * all available context at a glance.
+ *
+ * @param result - The show result to format.
+ * @param useChalk - Whether to use chalk for formatting (default: true).
+ * @returns Formatted string for terminal output.
+ */
+export declare function formatShowOutput(result: ShowResult, _useChalk?: boolean): string;
+/**
+ * Register the `show` command on the given Commander program.
+ */
+export declare function registerShowCommand(program: Command): void;
+//# sourceMappingURL=show.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../src/commands/show.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAEV,OAAO,EAKP,oBAAoB,EACrB,MAAM,kBAAkB,CAAC;AAK1B,iCAAiC;AACjC,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,aAAa,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC3C,4CAA4C;IAC5C,cAAc,EAAE,KAAK,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,gDAAgD;IAChD,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;CACJ;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAwE1E;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,UAAO,GAAG,MAAM,CAuH7E;AAiBD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgC1D"}

package/dist/commands/show.js

@@ -0,0 +1,243 @@
+/**
+ * `ctx-sync show <project>` command.
+ *
+ * Decrypts and displays the full context for a project — state,
+ * env var count, mental context, Docker services, running services —
+ * in a readable, formatted terminal output.
+ *
+ * This is the "at-a-glance" view that answers: "What was I doing on
+ * this project, and what do I need to get back to work?"
+ *
+ * @module commands/show
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { withErrorHandler } from '../utils/errors.js';
+import { loadKey } from '../core/key-store.js';
+import { readState } from '../core/state-manager.js';
+import { getConfigDir, getSyncDir } from './init.js';
+/**
+ * Execute the show command logic.
+ *
+ * Decrypts all relevant state files and assembles a complete project
+ * context snapshot.
+ *
+ * @param projectName - The name of the project to show.
+ * @returns The full project context.
+ */
+export async function executeShow(projectName) {
+    const configDir = getConfigDir();
+    const syncDir = getSyncDir();
+    // Verify sync dir exists
+    if (!fs.existsSync(syncDir) || !fs.existsSync(path.join(syncDir, '.git'))) {
+        throw new Error('No sync repository found. Run `ctx-sync init` first.');
+    }
+    // Load key
+    const privateKey = loadKey(configDir);
+    // 1. Find the project in state
+    const state = await readState(syncDir, privateKey, 'state');
+    if (!state) {
+        throw new Error('No state file found. Track a project first with `ctx-sync track`.');
+    }
+    const project = state.projects.find((p) => p.name === projectName || p.id === projectName);
+    if (!project) {
+        const availableNames = state.projects.map((p) => p.name).join(', ');
+        throw new Error(`Project "${projectName}" not found.\n` +
+            (availableNames
+                ? `Available projects: ${availableNames}`
+                : 'No projects tracked yet. Run `ctx-sync track` first.'));
+    }
+    // 2. Count env vars
+    const envVars = await readState(syncDir, privateKey, 'env-vars');
+    const projectEnvVars = envVars?.[project.name] ?? {};
+    const envVarCount = Object.keys(projectEnvVars).length;
+    // 3. Load mental context
+    const mentalContextData = await readState(syncDir, privateKey, 'mental-context');
+    const mentalContext = mentalContextData?.[project.name] ?? null;
+    // 4. Load Docker state
+    const dockerState = await readState(syncDir, privateKey, 'docker-state');
+    const projectDocker = dockerState?.[project.name];
+    const dockerServices = projectDocker?.services.map((s) => ({
+        name: s.name,
+        image: s.image,
+        port: s.port,
+        autoStart: s.autoStart,
+    })) ?? [];
+    // 5. Load service state
+    const serviceState = await readState(syncDir, privateKey, 'services');
+    const services = serviceState?.services
+        .filter((s) => s.project === project.name)
+        .map((s) => ({
+        name: s.name,
+        port: s.port,
+        command: s.command,
+        autoStart: s.autoStart,
+    })) ?? [];
+    return {
+        project,
+        envVarCount,
+        mentalContext,
+        dockerServices,
+        services,
+    };
+}
+/**
+ * Format the project context for terminal display.
+ *
+ * Produces a readable, chalk-formatted output string that shows
+ * all available context at a glance.
+ *
+ * @param result - The show result to format.
+ * @param useChalk - Whether to use chalk for formatting (default: true).
+ * @returns Formatted string for terminal output.
+ */
+export function formatShowOutput(result, _useChalk = true) {
+    const lines = [];
+    // Header
+    lines.push('');
+    lines.push(`  Project: ${result.project.name}`);
+    lines.push(`  ──────────────────────────────────`);
+    // Project info
+    lines.push('');
+    lines.push(`  📂 Directory: ${result.project.path}`);
+    lines.push(`  🌿 Branch:    ${result.project.git.branch}`);
+    lines.push(`  🔐 Env vars:  ${result.envVarCount}`);
+    if (result.project.git.hasUncommitted) {
+        lines.push(`  ⚠  Uncommitted changes`);
+    }
+    if (result.project.git.stashCount > 0) {
+        lines.push(`  📦 Stash count: ${result.project.git.stashCount}`);
+    }
+    lines.push(`  🕐 Last accessed: ${formatTimestamp(result.project.lastAccessed)}`);
+    // Mental context
+    if (result.mentalContext) {
+        lines.push('');
+        lines.push('  📝 Mental Context');
+        lines.push('  ─────────────────');
+        if (result.mentalContext.currentTask) {
+            lines.push(`  Task: "${result.mentalContext.currentTask}"`);
+        }
+        if (result.mentalContext.lastWorkingOn) {
+            const lwo = result.mentalContext.lastWorkingOn;
+            lines.push('');
+            lines.push(`  Last file: ${lwo.file}:${lwo.line}`);
+            if (lwo.description) {
+                lines.push(`  ${lwo.description}`);
+            }
+        }
+        if (result.mentalContext.blockers.length > 0) {
+            lines.push('');
+            lines.push('  ⛔ Blockers:');
+            for (const blocker of result.mentalContext.blockers) {
+                const priority = blocker.priority === 'high' ? ' [HIGH]' : '';
+                lines.push(`     • ${blocker.description}${priority}`);
+            }
+        }
+        if (result.mentalContext.nextSteps.length > 0) {
+            lines.push('');
+            lines.push('  📋 Next Steps:');
+            for (const step of result.mentalContext.nextSteps) {
+                lines.push(`     • ${step}`);
+            }
+        }
+        if (result.mentalContext.relatedLinks.length > 0) {
+            lines.push('');
+            lines.push('  🔗 Related Links:');
+            for (const link of result.mentalContext.relatedLinks) {
+                if (link.title !== link.url) {
+                    lines.push(`     • ${link.title}: ${link.url}`);
+                }
+                else {
+                    lines.push(`     • ${link.url}`);
+                }
+            }
+        }
+        if (result.mentalContext.breadcrumbs.length > 0) {
+            lines.push('');
+            lines.push('  🍞 Breadcrumbs:');
+            for (const crumb of result.mentalContext.breadcrumbs) {
+                lines.push(`     • ${crumb.note}`);
+            }
+        }
+    }
+    // Docker services
+    if (result.dockerServices.length > 0) {
+        lines.push('');
+        lines.push('  🐳 Docker Services');
+        lines.push('  ──────────────────');
+        for (const svc of result.dockerServices) {
+            const autoStart = svc.autoStart ? ' (auto-start)' : '';
+            lines.push(`     • ${svc.name} — ${svc.image} (port ${svc.port})${autoStart}`);
+        }
+    }
+    // Running services
+    if (result.services.length > 0) {
+        lines.push('');
+        lines.push('  ⚡ Services');
+        lines.push('  ──────────');
+        for (const svc of result.services) {
+            const autoStart = svc.autoStart ? ' (auto-start)' : '';
+            lines.push(`     • ${svc.name} — \`${svc.command}\` (port ${svc.port})${autoStart}`);
+        }
+    }
+    // No context sections at all
+    if (!result.mentalContext &&
+        result.dockerServices.length === 0 &&
+        result.services.length === 0 &&
+        result.envVarCount === 0) {
+        lines.push('');
+        lines.push('  No additional context recorded yet.');
+        lines.push('  Use `ctx-sync note` to add mental context.');
+        lines.push('  Use `ctx-sync env import` to track environment variables.');
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Format an ISO timestamp for human-readable display.
+ *
+ * @param isoTimestamp - ISO 8601 timestamp string.
+ * @returns Formatted date/time string.
+ */
+function formatTimestamp(isoTimestamp) {
+    try {
+        const date = new Date(isoTimestamp);
+        return date.toLocaleString();
+    }
+    catch {
+        return isoTimestamp;
+    }
+}
+/**
+ * Register the `show` command on the given Commander program.
+ */
+export function registerShowCommand(program) {
+    program
+        .command('show <project>')
+        .description('Show full context for a tracked project')
+        .action(withErrorHandler(async (projectName) => {
+        const chalk = (await import('chalk')).default;
+        const result = await executeShow(projectName);
+        const output = formatShowOutput(result);
+        console.log(output);
+        // Summary line
+        const sections = [];
+        if (result.mentalContext) {
+            sections.push('mental context');
+        }
+        if (result.envVarCount > 0) {
+            sections.push(`${result.envVarCount} env vars`);
+        }
+        if (result.dockerServices.length > 0) {
+            sections.push(`${result.dockerServices.length} Docker services`);
+        }
+        if (result.services.length > 0) {
+            sections.push(`${result.services.length} services`);
+        }
+        if (sections.length > 0) {
+            console.log(chalk.dim(`  Context includes: ${sections.join(', ')}`));
+            console.log('');
+        }
+    }));
+}
+//# sourceMappingURL=show.js.map

package/dist/commands/show.js.map

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

package/dist/commands/status.d.ts

@@ -0,0 +1,53 @@
+/**
+ * `ctx-sync status` command.
+ *
+ * Shows sync status (last sync time, pending changes, remote connectivity)
+ * and per-project status (branch, uncommitted changes).
+ *
+ * @module commands/status
+ */
+import type { Command } from 'commander';
+/** Sync status information */
+export interface SyncInfo {
+    /** Last sync timestamp from manifest */
+    lastSync: string | null;
+    /** Number of pending (uncommitted) changes in the sync repo */
+    pendingChanges: number;
+    /** Whether the sync repo has a remote configured */
+    hasRemote: boolean;
+    /** Whether the sync repo is clean */
+    isClean: boolean;
+    /** Number of commits ahead of remote */
+    ahead: number;
+    /** Number of commits behind remote */
+    behind: number;
+}
+/** Per-project status */
+export interface ProjectStatus {
+    name: string;
+    path: string;
+    branch: string;
+    hasUncommitted: boolean;
+    stashCount: number;
+    lastAccessed: string;
+}
+/** Result returned by executeStatus */
+export interface StatusResult {
+    sync: SyncInfo;
+    projects: ProjectStatus[];
+}
+/**
+ * Execute the status command logic.
+ *
+ * 1. Read manifest for last sync time.
+ * 2. Get sync repo status (pending changes, remote).
+ * 3. Read state.age for per-project info.
+ *
+ * @returns Status result with sync and project info.
+ */
+export declare function executeStatus(): Promise<StatusResult>;
+/**
+ * Register the `status` command on the given Commander program.
+ */
+export declare function registerStatusCommand(program: Command): void;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,8BAA8B;AAC9B,MAAM,WAAW,QAAQ;IACvB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,+DAA+D;IAC/D,cAAc,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,SAAS,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,yBAAyB;AACzB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC,CAwE3D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqE5D"}