@neetru/cli 2.0.0 → 2.1.1

package/dist/commands/agent-release.d.ts

@@ -0,0 +1,13 @@
+export interface AgentReleaseOptions {
+    version: string;
+    channel?: string;
+    changelog?: string;
+    minCore?: string;
+    /** lista de "arch=path/to/binary" que será sha256-eado e tamanho-medido localmente */
+    binary?: string[];
+    /** lista de "arch=URL@sha256@sizeBytes" pra usar valores explícitos sem tocar no FS */
+    artifact?: string[];
+    /** se setado, só monta o payload e imprime, não chama API */
+    dryRun?: boolean;
+}
+export declare function runAgentRelease(opts: AgentReleaseOptions): Promise<void>;

package/dist/commands/agent-release.js

@@ -0,0 +1,204 @@
+/**
+ * `neetru agent release` — publica nova release do agente Neetru.
+ *
+ * Fluxo completo (manual hoje, CI futuro):
+ *   1. Build local: `cd agent/ && npm run release:linux-x64`
+ *   2. Upload manual: `gsutil cp agent/neetru-agent-linux-x64 gs://neetru-agent-releases/releases/{version}/`
+ *      + `gsutil cp agent/neetru-agent-linux-x64.sha256 gs://...`
+ *   3. **Este comando** — registra `agent_releases/{version}` no Firestore via
+ *      Bearer token + Server Action. Idempotente.
+ *
+ * Backend: `POST api.neetru.com/cli/v1/agent/release` (Bearer token nrt_*),
+ * exige role `admin` em `cli_api_keys/{keyId}`.
+ *
+ * Roadmap:
+ *   - Sprint futura: comando `--upload` que faz GCS upload + sha256 + register
+ *     numa só chamada (precisa de credenciais GCP locais ou signed URL via Core).
+ */
+import * as fs from 'node:fs/promises';
+import * as fsSync from 'node:fs';
+import * as path from 'node:path';
+import { createHash } from 'node:crypto';
+import chalk from 'chalk';
+import { log } from '../utils/logger.js';
+import { apiRequest, CliApiError, CliNetworkError } from '../lib/api-client.js';
+const VALID_CHANNELS = ['stable', 'beta', 'canary'];
+const VALID_ARCHS = ['linux-x64', 'linux-arm64', 'darwin-x64', 'darwin-arm64'];
+const SEMVER_RE = /^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/;
+const SHA256_RE = /^[a-f0-9]{64}$/;
+const GCS_BASE = 'https://storage.googleapis.com/neetru-agent-releases/releases';
+function isArch(s) {
+    return VALID_ARCHS.includes(s);
+}
+function isChannel(s) {
+    return VALID_CHANNELS.includes(s);
+}
+async function sha256File(filePath) {
+    const buf = await fs.readFile(filePath);
+    const sha256 = createHash('sha256').update(buf).digest('hex');
+    return { sha256, sizeBytes: buf.length };
+}
+async function loadChangelogFromFile(filePath) {
+    const abs = path.resolve(process.cwd(), filePath);
+    return fs.readFile(abs, 'utf8');
+}
+function parseBinaryArg(arg) {
+    const idx = arg.indexOf('=');
+    if (idx < 0)
+        throw new Error(`--binary inválido "${arg}". Esperado "arch=path".`);
+    const arch = arg.slice(0, idx);
+    const filePath = arg.slice(idx + 1);
+    if (!isArch(arch)) {
+        throw new Error(`--binary com arch inválido "${arch}". Válidos: ${VALID_ARCHS.join(', ')}`);
+    }
+    if (!filePath || !fsSync.existsSync(filePath)) {
+        throw new Error(`--binary path não encontrado: ${filePath}`);
+    }
+    return { arch, filePath };
+}
+function parseArtifactArg(arg) {
+    // Format: arch=URL@sha256@sizeBytes
+    const parts = arg.split('=');
+    if (parts.length !== 2)
+        throw new Error(`--artifact inválido "${arg}". Esperado "arch=URL@sha256@sizeBytes".`);
+    const arch = parts[0];
+    if (!isArch(arch)) {
+        throw new Error(`--artifact com arch inválido "${arch}". Válidos: ${VALID_ARCHS.join(', ')}`);
+    }
+    const rest = parts[1].split('@');
+    if (rest.length !== 3)
+        throw new Error(`--artifact inválido "${arg}". Esperado "arch=URL@sha256@sizeBytes".`);
+    const [url, sha256, sizeStr] = rest;
+    if (!SHA256_RE.test(sha256.toLowerCase())) {
+        throw new Error(`--artifact ${arch}: sha256 inválido (esperado hex64).`);
+    }
+    const sizeBytes = Number(sizeStr);
+    if (!Number.isFinite(sizeBytes) || sizeBytes <= 0) {
+        throw new Error(`--artifact ${arch}: sizeBytes inválido.`);
+    }
+    return { arch, payload: { url, sha256: sha256.toLowerCase(), sizeBytes } };
+}
+export async function runAgentRelease(opts) {
+    log.banner();
+    log.heading('neetru agent release');
+    // ── validação básica ───────────────────────────────────────────────
+    if (!opts.version) {
+        log.error('--version é obrigatório (ex: 1.2.0).');
+        process.exit(2);
+        return;
+    }
+    if (!SEMVER_RE.test(opts.version)) {
+        log.error(`--version inválido "${opts.version}". Use semver (1.2.3 ou 1.2.3-beta.1).`);
+        process.exit(2);
+        return;
+    }
+    const channel = (opts.channel ?? 'beta').toLowerCase();
+    if (!isChannel(channel)) {
+        log.error(`--channel inválido "${channel}". Válidos: ${VALID_CHANNELS.join(' | ')}`);
+        process.exit(2);
+        return;
+    }
+    // ── changelog ───────────────────────────────────────────────────────
+    let changelog = opts.changelog ?? '';
+    if (changelog.startsWith('@')) {
+        try {
+            changelog = await loadChangelogFromFile(changelog.slice(1));
+        }
+        catch (err) {
+            log.error(`Falha ao ler changelog "${changelog}": ${err.message}`);
+            process.exit(3);
+            return;
+        }
+    }
+    if (!changelog || changelog.trim().length < 10) {
+        log.error('--changelog obrigatório (mín 10 chars). Use "@path/to/CHANGELOG.md" pra ler de arquivo.');
+        process.exit(2);
+        return;
+    }
+    // ── monta artifacts ────────────────────────────────────────────────
+    const artifacts = {};
+    // Via --binary: lê arquivo local, computa sha256 + size, URL canônica GCS
+    for (const a of opts.binary ?? []) {
+        try {
+            const { arch, filePath } = parseBinaryArg(a);
+            log.info(`Computando sha256 de ${chalk.dim(filePath)}...`);
+            const { sha256, sizeBytes } = await sha256File(filePath);
+            const url = `${GCS_BASE}/${encodeURIComponent(opts.version)}/neetru-agent-${arch}`;
+            artifacts[arch] = { url, sha256, sizeBytes };
+            log.success(`  ${arch}: sha256=${sha256.slice(0, 12)}... (${(sizeBytes / 1_000_000).toFixed(1)} MB)`);
+            log.dim(`  URL: ${url}`);
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(2);
+            return;
+        }
+    }
+    // Via --artifact: tudo explícito, no FS read
+    for (const a of opts.artifact ?? []) {
+        try {
+            const { arch, payload } = parseArtifactArg(a);
+            artifacts[arch] = payload;
+            log.success(`  ${arch}: sha256=${payload.sha256.slice(0, 12)}... (${(payload.sizeBytes / 1_000_000).toFixed(1)} MB)`);
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(2);
+            return;
+        }
+    }
+    if (Object.keys(artifacts).length === 0) {
+        log.error('Nenhum artifact informado. Use --binary arch=path ou --artifact arch=URL@sha256@sizeBytes.');
+        process.exit(2);
+        return;
+    }
+    // ── payload ─────────────────────────────────────────────────────────
+    const payload = {
+        version: opts.version,
+        channel,
+        changelog,
+        artifacts,
+        ...(opts.minCore ? { minSupportedCoreVersion: opts.minCore } : {}),
+    };
+    if (opts.dryRun) {
+        log.heading('Dry run — payload que seria enviado:');
+        console.log(JSON.stringify(payload, null, 2));
+        log.warn('Nada foi enviado. Remova --dry-run para publicar.');
+        return;
+    }
+    log.info(`Registrando release ${chalk.bold(opts.version)} (channel=${chalk.bold(channel)}, ${Object.keys(artifacts).length} arch(s))...`);
+    try {
+        const r = await apiRequest('/cli/v1/agent/release', {
+            method: 'POST',
+            body: payload,
+        });
+        if (r.alreadyExists) {
+            log.warn(`Release ${chalk.bold(r.version)} já existia. Idempotente — nenhuma mudança.`);
+        }
+        else {
+            log.success(`Release ${chalk.bold(r.version)} publicada.`);
+        }
+        log.dim(`  Painel: https://core.neetru.com/agent/releases`);
+    }
+    catch (err) {
+        if (err instanceof CliApiError) {
+            if (err.status === 401 || err.status === 403) {
+                log.error('Não autorizado. CLI precisa estar logado com chave admin.');
+                log.dim('  neetru login');
+                process.exit(4);
+                return;
+            }
+            log.error(`API ${err.status}: ${err.message}`);
+            process.exit(5);
+            return;
+        }
+        if (err instanceof CliNetworkError) {
+            log.error(`Conexão falhou: ${err.message}`);
+            process.exit(6);
+            return;
+        }
+        log.error(err instanceof Error ? err.message : String(err));
+        process.exit(7);
+    }
+}
+//# sourceMappingURL=agent-release.js.map

package/dist/commands/agent-release.js.map

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

package/dist/commands/agent-write.d.ts

@@ -0,0 +1,12 @@
+import { type StepUpOptions } from '../lib/cli-write.js';
+export interface AgentYankOptions extends StepUpOptions {
+    reason: string;
+}
+export declare function runAgentYank(version: string, opts: AgentYankOptions): Promise<void>;
+export declare function runAgentCanaryStart(version: string, opts: {
+    json?: boolean;
+}): Promise<void>;
+export interface AgentCanaryRollbackOptions extends StepUpOptions {
+    reason: string;
+}
+export declare function runAgentCanaryRollback(version: string, opts: AgentCanaryRollbackOptions): Promise<void>;

package/dist/commands/agent-write.js

@@ -0,0 +1,94 @@
+/**
+ * `neetru agent yank` + `neetru agent canary start|rollback` — write commands
+ * sobre releases do agente Neetru.
+ *
+ * Endpoints:
+ *   POST /api/cli/v1/agent/yank                       (yank — destrutivo)
+ *   POST /api/cli/v1/agent/canary?action=start        (start canary)
+ *   POST /api/cli/v1/agent/canary?action=rollback     (rollback — destrutivo)
+ *
+ * `neetru agent release` (publicar release) já existe em `agent-release.ts`.
+ */
+import ora from 'ora';
+import { apiRequest } from '../lib/api-client.js';
+import { requireToken, handleApiError, confirmDestructive, printWriteResult, resolveStepUp, } from '../lib/cli-write.js';
+import { log } from '../utils/logger.js';
+export async function runAgentYank(version, opts) {
+    if (!version) {
+        log.error('Uso: neetru agent yank <version> --reason "<motivo ≥5 chars>"');
+        process.exit(1);
+    }
+    const token = await requireToken(opts.json);
+    await confirmDestructive(`Yankar a release ${version} do agente? Installers/auto-upgrade vão ignorá-la.`, opts);
+    const { headers } = await resolveStepUp(opts);
+    const spinner = opts.json
+        ? null
+        : ora({ text: `Yankando release ${version}…`, color: 'blue' }).start();
+    let res;
+    try {
+        res = await apiRequest(`/api/cli/v1/agent/yank${opts.dryRun ? '?dryRun=true' : ''}`, {
+            method: 'POST',
+            token,
+            headers,
+            body: { version, reason: opts.reason },
+        });
+        spinner?.stop();
+    }
+    catch (error) {
+        spinner?.fail('Falha ao yankar release.');
+        handleApiError(error, opts.json);
+    }
+    printWriteResult(res.dryRun ? res : { version: res.version, yanked: res.yanked }, `Release ${res.version} yankada.`, opts.json);
+}
+export async function runAgentCanaryStart(version, opts) {
+    if (!version) {
+        log.error('Uso: neetru agent canary start <version>');
+        process.exit(1);
+    }
+    const token = await requireToken(opts.json);
+    const spinner = opts.json
+        ? null
+        : ora({ text: `Iniciando canary de ${version}…`, color: 'blue' }).start();
+    let res;
+    try {
+        res = await apiRequest('/api/cli/v1/agent/canary?action=start', {
+            method: 'POST',
+            token,
+            body: { version },
+        });
+        spinner?.stop();
+    }
+    catch (error) {
+        spinner?.fail('Falha ao iniciar canary.');
+        handleApiError(error, opts.json);
+    }
+    printWriteResult({ version: res.version, phase: res.phase }, `Canary de ${res.version} iniciado — phase: ${res.phase}`, opts.json);
+}
+export async function runAgentCanaryRollback(version, opts) {
+    if (!version) {
+        log.error('Uso: neetru agent canary rollback <version> --reason "<motivo ≥5 chars>"');
+        process.exit(1);
+    }
+    const token = await requireToken(opts.json);
+    await confirmDestructive(`Rollback do canary de ${version}? A release não retorna ao rollout — só com nova versão.`, opts);
+    const { headers } = await resolveStepUp(opts);
+    const spinner = opts.json
+        ? null
+        : ora({ text: `Rollback do canary de ${version}…`, color: 'blue' }).start();
+    let res;
+    try {
+        res = await apiRequest(`/api/cli/v1/agent/canary?action=rollback${opts.dryRun ? '&dryRun=true' : ''}`, {
+            method: 'POST',
+            token,
+            headers,
+            body: { version, reason: opts.reason },
+        });
+        spinner?.stop();
+    }
+    catch (error) {
+        spinner?.fail('Falha ao fazer rollback do canary.');
+        handleApiError(error, opts.json);
+    }
+    printWriteResult(res.dryRun ? res : { version: res.version, phase: res.phase }, `Canary de ${res.version} → ${res.phase}`, opts.json);
+}
+//# sourceMappingURL=agent-write.js.map

package/dist/commands/agent-write.js.map

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

package/dist/commands/api-catalog.d.ts

@@ -0,0 +1,20 @@
+import { type ConfirmOptions, type StepUpOptions } from '../lib/cli-write.js';
+export interface ApiCatalogWriteOptions {
+    name?: string;
+    description?: string;
+    baseUrl?: string;
+    version?: string;
+    authMethod?: string;
+    docsUrl?: string;
+    ownerTeam?: string;
+    contactEmail?: string;
+    scopes?: string;
+    status?: string;
+    json?: boolean;
+}
+export declare function runApiCatalogCreate(slug: string, opts: ApiCatalogWriteOptions): Promise<void>;
+export declare function runApiCatalogUpdate(slug: string, opts: ApiCatalogWriteOptions): Promise<void>;
+export declare function runApiCatalogArchive(slug: string, opts: ConfirmOptions & {
+    unarchive?: boolean;
+}): Promise<void>;
+export declare function runApiCatalogDelete(slug: string, opts: StepUpOptions): Promise<void>;

package/dist/commands/api-catalog.js

@@ -0,0 +1,126 @@
+/**
+ * `neetru api-catalog create|update|archive|delete` — control plane do registry
+ * de APIs versionadas (`apis/{slug}`).
+ *
+ * Endpoints:
+ *   POST   /api/cli/v1/api-catalog                       (create)
+ *   PUT    /api/cli/v1/api-catalog/{slug}                (update)
+ *   POST   /api/cli/v1/api-catalog/{slug}?action=archive (soft-delete)
+ *   DELETE /api/cli/v1/api-catalog/{slug}                (delete físico — destrutivo)
+ */
+import ora from 'ora';
+import { apiRequest } from '../lib/api-client.js';
+import { requireToken, handleApiError, confirmDestructive, printWriteResult, resolveStepUp, } from '../lib/cli-write.js';
+import { log } from '../utils/logger.js';
+function buildPayload(slug, opts) {
+    return {
+        slug,
+        name: opts.name,
+        description: opts.description,
+        baseUrl: opts.baseUrl,
+        version: opts.version,
+        authMethod: opts.authMethod,
+        docsUrl: opts.docsUrl,
+        ownerTeam: opts.ownerTeam,
+        contactEmail: opts.contactEmail,
+        requiredScopes: opts.scopes
+            ? opts.scopes.split(',').map((s) => s.trim()).filter(Boolean)
+            : undefined,
+        status: opts.status,
+    };
+}
+export async function runApiCatalogCreate(slug, opts) {
+    if (!slug) {
+        log.error('Uso: neetru api-catalog create <slug> --name … --base-url … --version … --auth-method … --status …');
+        process.exit(1);
+    }
+    const token = await requireToken(opts.json);
+    const spinner = opts.json
+        ? null
+        : ora({ text: `Registrando API "${slug}"…`, color: 'blue' }).start();
+    let res;
+    try {
+        res = await apiRequest('/api/cli/v1/api-catalog', {
+            method: 'POST',
+            token,
+            body: buildPayload(slug, opts),
+        });
+        spinner?.stop();
+    }
+    catch (error) {
+        spinner?.fail('Falha ao registrar API.');
+        handleApiError(error, opts.json);
+    }
+    printWriteResult({ id: res.id }, `API registrada: ${res.id}`, opts.json);
+}
+export async function runApiCatalogUpdate(slug, opts) {
+    if (!slug) {
+        log.error('Uso: neetru api-catalog update <slug> --name … --base-url … --version … --auth-method … --status …');
+        process.exit(1);
+    }
+    const token = await requireToken(opts.json);
+    const spinner = opts.json
+        ? null
+        : ora({ text: `Atualizando API "${slug}"…`, color: 'blue' }).start();
+    let res;
+    try {
+        res = await apiRequest(`/api/cli/v1/api-catalog/${encodeURIComponent(slug)}`, {
+            method: 'PUT',
+            token,
+            body: buildPayload(slug, opts),
+        });
+        spinner?.stop();
+    }
+    catch (error) {
+        spinner?.fail('Falha ao atualizar API.');
+        handleApiError(error, opts.json);
+    }
+    printWriteResult({ id: res.id }, `API ${res.id} atualizada.`, opts.json);
+}
+export async function runApiCatalogArchive(slug, opts) {
+    if (!slug) {
+        log.error('Uso: neetru api-catalog archive <slug> [--unarchive]');
+        process.exit(1);
+    }
+    const token = await requireToken(opts.json);
+    const action = opts.unarchive ? 'unarchive' : 'archive';
+    if (action === 'archive') {
+        await confirmDestructive(`Arquivar a API "${slug}"? Some da listagem default (reversível com --unarchive).`, opts);
+    }
+    const spinner = opts.json
+        ? null
+        : ora({ text: `${action === 'archive' ? 'Arquivando' : 'Reativando'} API "${slug}"…`, color: 'blue' }).start();
+    let res;
+    try {
+        res = await apiRequest(`/api/cli/v1/api-catalog/${encodeURIComponent(slug)}?action=${action}`, { method: 'POST', token });
+        spinner?.stop();
+    }
+    catch (error) {
+        spinner?.fail(`Falha ao ${action === 'archive' ? 'arquivar' : 'reativar'} API.`);
+        handleApiError(error, opts.json);
+    }
+    printWriteResult({ id: res.id, archived: res.archived }, `API ${res.id} → ${res.archived ? 'arquivada' : 'ativa'}`, opts.json);
+}
+export async function runApiCatalogDelete(slug, opts) {
+    if (!slug) {
+        log.error('Uso: neetru api-catalog delete <slug>');
+        process.exit(1);
+    }
+    const token = await requireToken(opts.json);
+    await confirmDestructive(`Deletar fisicamente a API "${slug}"? Esta ação é IRREVERSÍVEL (use archive para soft-delete).`, opts);
+    const { headers } = await resolveStepUp(opts);
+    const spinner = opts.json
+        ? null
+        : ora({ text: `Deletando API "${slug}"…`, color: 'blue' }).start();
+    let res;
+    try {
+        res = await apiRequest(`/api/cli/v1/api-catalog/${encodeURIComponent(slug)}${opts.dryRun ? '?dryRun=true' : ''}`, { method: 'DELETE', token, headers });
+        spinner?.stop();
+    }
+    catch (error) {
+        spinner?.fail('Falha ao deletar API.');
+        handleApiError(error, opts.json);
+    }
+    printWriteResult(res.dryRun ? res : { id: res.id, deleted: res.deleted }, `API ${res.id} deletada.`, opts.json);
+}
+//# sourceMappingURL=api-catalog.js.map

package/dist/commands/api-catalog.js.map

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

package/dist/commands/audit.d.ts

@@ -0,0 +1,8 @@
+export interface AuditTailOptions {
+    limit?: string;
+    action?: string;
+    severity?: string;
+    actor?: string;
+    json?: boolean;
+}
+export declare function runAuditTail(opts: AuditTailOptions): Promise<void>;

package/dist/commands/audit.js

@@ -0,0 +1,69 @@
+/**
+ * `neetru audit tail` — últimos N eventos da trilha de auditoria do Core.
+ *
+ * Endpoint: GET /api/cli/v1/audit/tail
+ *   filtros: --limit, --action, --severity, --actor
+ *
+ * Saída: tabela (default, mais recente primeiro) ou `--json`.
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import { apiRequest } from '../lib/api-client.js';
+import { requireToken, handleApiError } from '../lib/cli-read.js';
+import { renderTable, fmtTimestamp } from '../lib/render.js';
+import { log } from '../utils/logger.js';
+function colorSeverity(s) {
+    if (!s || s === 'info')
+        return chalk.dim(s ?? 'info');
+    if (s === 'warning')
+        return chalk.yellow(s);
+    if (s === 'critical')
+        return chalk.red(s);
+    return chalk.cyan(s);
+}
+function colorResult(r) {
+    if (r === 'success')
+        return chalk.green(r);
+    if (r === 'failure')
+        return chalk.red(r);
+    return chalk.dim(r);
+}
+export async function runAuditTail(opts) {
+    const token = await requireToken(opts.json);
+    const params = new URLSearchParams();
+    if (opts.limit)
+        params.set('limit', opts.limit);
+    if (opts.action)
+        params.set('action', opts.action);
+    if (opts.severity)
+        params.set('severity', opts.severity);
+    if (opts.actor)
+        params.set('actor', opts.actor);
+    const qs = params.toString();
+    const spinner = opts.json ? null : ora({ text: 'Buscando audit logs…', color: 'blue' }).start();
+    let res;
+    try {
+        res = await apiRequest(`/api/cli/v1/audit/tail${qs ? `?${qs}` : ''}`, { token });
+        spinner?.stop();
+    }
+    catch (error) {
+        spinner?.fail('Falha ao buscar audit logs.');
+        handleApiError(error, opts.json);
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(res));
+        return;
+    }
+    log.heading(`Audit tail (${res.count} eventos)`);
+    renderTable([
+        { header: 'TIMESTAMP', value: (e) => fmtTimestamp(e.ts) },
+        { header: 'AÇÃO', value: (e) => e.action, maxWidth: 32 },
+        { header: 'ATOR', value: (e) => e.actor.email, maxWidth: 28 },
+        { header: 'SRC', value: (e) => e.actor.source ?? '—' },
+        { header: 'ALVO', value: (e) => `${e.target.kind}/${e.target.id}`, maxWidth: 30 },
+        { header: 'RESULTADO', value: (e) => colorResult(e.result) },
+        { header: 'SEV', value: (e) => colorSeverity(e.severity) },
+    ], res.events);
+    console.log();
+}
+//# sourceMappingURL=audit.js.map

package/dist/commands/audit.js.map

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

package/dist/commands/billing.d.ts

@@ -0,0 +1,6 @@
+export interface BillingSummaryOptions {
+    year?: string;
+    month?: string;
+    json?: boolean;
+}
+export declare function runBillingSummary(opts: BillingSummaryOptions): Promise<void>;