@bussolabs/closeyourit-cli 0.19.0 → 0.21.0

package/dist/commands/kb/publish.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const promises_1 = require("node:fs/promises");
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+const error_codes_1 = require("../../errors/error-codes");
+const api_1 = require("../../lib/api");
+const limits_1 = require("../../lib/limits");
+const output_1 = require("../../lib/output");
+// Copia dichiarata di `Knowledge::Page::PUBLICATION_KEY_FORMAT`: una chiave malformata è l'unico
+// errore che si può riconoscere senza chiamare il server, e riconoscerlo qui evita di scoprire a
+// metà di un ciclo di retry che tutte le chiamate erano destinate a un 422.
+const PUBLICATION_KEY_RE = /^[A-Za-z0-9][A-Za-z0-9._~:-]{0,254}$/;
+// Un errore che il backend ha davvero formulato: `error-codes.ts` riserva le iniziali R/G ai codici
+// applicativi e li propaga intatti, mentre tutto ciò che inizia per C lo ha coniato la CLI davanti a
+// una risposta che non parlava — corpo non JSON (`C000-NET-001`) o envelope senza codice
+// (`C404-API-000`), che è la forma in cui si presenta una route inesistente.
+const BACKEND_CODE_RE = /^[RG]/;
+class KbPublish extends base_1.BaseCommand {
+    static description = `Idempotently create or update a Knowledge page by publication key.
+
+Exactly one of --body or --body-file is required.`;
+    static usage = '-p <project> --publication-key <key> --title <title> [--kind <kind>] (--body <markdown> | --body-file <path>)';
+    static examples = [
+        '<%= config.bin %> kb publish --project CYCL --publication-key docs:release --title "Release guide" --body "Steps…"',
+        '<%= config.bin %> kb publish -p CYCL --publication-key docs:release --title "Release guide" --kind guide --body-file ./release.md',
+    ];
+    static flags = {
+        ...base_1.projectFlag,
+        'publication-key': core_1.Flags.string({
+            description: 'Stable publication key (1-255 URL-safe characters)',
+            required: true,
+        }),
+        title: core_1.Flags.string({ description: `Page title (max ${limits_1.LENGTH_LIMITS.title} characters)`, required: true }),
+        // Nessun default qui: il server mette `note` solo quando la pagina nasce e altrimenti tiene il
+        // kind che ha già. Spedire `note` a ogni chiamata declasserebbe una guida a nota al primo
+        // publish ripetuto senza `--kind`, che è esattamente ciò che una fonte idempotente non deve fare.
+        kind: core_1.Flags.string({ description: 'Page kind: note|decision|guide (new page: note; existing: unchanged)' }),
+        body: core_1.Flags.string({
+            description: `Page body (markdown, max ${limits_1.LENGTH_LIMITS.pageBody} characters); exactly one of --body or --body-file is required`,
+            exactlyOne: ['body', 'body-file'],
+        }),
+        'body-file': core_1.Flags.string({
+            description: `Read the page body (markdown, max ${limits_1.LENGTH_LIMITS.pageBody} characters) from a local file; exactly one of --body or --body-file is required`,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(KbPublish);
+        const publicationKey = flags['publication-key'];
+        if (!PUBLICATION_KEY_RE.test(publicationKey)) {
+            this.error('Invalid --publication-key: use 1-255 characters, start with a letter or number, then only letters, numbers, . _ ~ : -.', { exit: 2 });
+        }
+        let body;
+        let bodyFlag = '--body';
+        if (flags.body === undefined) {
+            bodyFlag = '--body-file';
+            try {
+                body = await (0, promises_1.readFile)(flags['body-file'], 'utf8');
+            }
+            catch {
+                this.error(`File not found or unreadable: ${flags['body-file']}`, { exit: 2 });
+            }
+        }
+        else {
+            body = flags.body;
+        }
+        // Il publish è un upsert atomico e non rilegge la pagina prima di scrivere: senza un valore
+        // attuale da usare come salvaguardia il tetto vale pieno, come su `kb create` (CYCL-32).
+        const tooLong = (0, limits_1.tooLongMessage)([
+            { flag: '--title', value: flags.title, max: limits_1.LENGTH_LIMITS.title },
+            { flag: bodyFlag, value: body, max: limits_1.LENGTH_LIMITS.pageBody },
+        ]);
+        if (tooLong)
+            this.error(tooLong, { exit: 2 });
+        const projectId = await this.resolveProjectId(flags.project);
+        const path = `/cli/v1/projects/${projectId}/knowledge/publications/${encodeURIComponent(publicationKey)}`;
+        // `kind` esce dal payload quando non è stato passato: il server distingue "non me l'hai detto"
+        // (tiene quello che ha) da un valore esplicito, e una chiave presente ma vuota non è la stessa cosa.
+        const payload = { title: flags.title, ...(flags.kind === undefined ? {} : { kind: flags.kind }), body };
+        let res;
+        try {
+            res = await this.api.put(path, payload);
+        }
+        catch (error) {
+            // Un 404 che il backend non ha formulato è la route che non c'è: su un server più vecchio
+            // della pubblicazione atomica il messaggio dice cosa aggiornare, invece di far sembrare
+            // sparito il progetto. Ogni 404 applicativo passa intatto — R404-KNOWLEDGE-001 per il progetto
+            // invisibile e chiunque altro il backend aggiunga dopo, che qui non va mascherato.
+            if (error instanceof api_1.ApiRequestError && error.status === 404 && !BACKEND_CODE_RE.test(error.code)) {
+                throw new api_1.ApiRequestError(404, error_codes_1.ErrorCodes.Knowledge.publishUnavailable, 'Knowledge publish is not supported by this backend. Upgrade CloseYourIt and retry.');
+            }
+            throw error;
+        }
+        if (!this.jsonEnabled()) {
+            const meta = (res.meta ?? {});
+            const operation = meta.operation === 'created' ? 'created' : 'updated';
+            // Il corpo è appena stato scritto da chi ha lanciato il comando: ristamparlo per intero
+            // seppellirebbe l'unica cosa nuova, cioè se la pagina è nata ora o è stata aggiornata.
+            const { body: _body, ...page } = res.data ?? {};
+            this.log(`Knowledge publication ${operation}:`);
+            this.log((0, output_1.renderRecord)({ ...page, operation: meta.operation, adopted_legacy: meta.adopted_legacy }));
+        }
+        return res;
+    }
+}
+exports.default = KbPublish;

package/dist/commands/kb/update.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const promises_1 = require("node:fs/promises");
 const core_1 = require("@oclif/core");
 const base_1 = require("../../base");
+const limits_1 = require("../../lib/limits");
 const output_1 = require("../../lib/output");
 class KbUpdate extends base_1.BaseCommand {
     static description = 'Update a knowledge page (only the fields you pass; the others keep their current value)';
@@ -15,17 +16,25 @@ class KbUpdate extends base_1.BaseCommand {
         id: core_1.Args.string({ description: 'Knowledge page id', required: true }),
     };
     static flags = {
-        title: core_1.Flags.string({ description: 'New title' }),
+        title: core_1.Flags.string({ description: `New title (max ${limits_1.LENGTH_LIMITS.title} characters)` }),
         kind: core_1.Flags.string({ description: 'New kind: note|decision|guide' }),
-        body: core_1.Flags.string({ description: 'New body (markdown)' }),
-        'body-file': core_1.Flags.string({ description: 'Read the new body (markdown) from a local file' }),
-        'tech-spec': core_1.Flags.string({ description: 'New technical section, kept separate from the simple body' }),
-        'tech-spec-file': core_1.Flags.string({ description: 'Read the new technical section from a local file' }),
+        body: core_1.Flags.string({ description: `New body (markdown, max ${limits_1.LENGTH_LIMITS.pageBody} characters)` }),
+        'body-file': core_1.Flags.string({
+            description: `Read the new body (markdown, max ${limits_1.LENGTH_LIMITS.pageBody} characters) from a local file`,
+        }),
+        'tech-spec': core_1.Flags.string({
+            description: `New technical section, kept separate from the simple body (max ${limits_1.LENGTH_LIMITS.techSpec} characters)`,
+        }),
+        'tech-spec-file': core_1.Flags.string({
+            description: `Read the new technical section (max ${limits_1.LENGTH_LIMITS.techSpec} characters) from a local file`,
+        }),
     };
     async run() {
         const { args, flags } = await this.parse(KbUpdate);
         let body = flags.body;
+        let bodyFlag = '--body';
         if (body === undefined && flags['body-file'] !== undefined) {
+            bodyFlag = '--body-file';
             try {
                 body = await (0, promises_1.readFile)(flags['body-file'], 'utf8');
             }
@@ -34,7 +43,9 @@ class KbUpdate extends base_1.BaseCommand {
             }
         }
         let techSpec = flags['tech-spec'];
+        let techSpecFlag = '--tech-spec';
         if (techSpec === undefined && flags['tech-spec-file'] !== undefined) {
+            techSpecFlag = '--tech-spec-file';
             try {
                 techSpec = await (0, promises_1.readFile)(flags['tech-spec-file'], 'utf8');
             }
@@ -53,6 +64,16 @@ class KbUpdate extends base_1.BaseCommand {
         const base = `/cli/v1/knowledge/pages/${encodeURIComponent(args.id)}`;
         const current = await this.api.get(base);
         const page = current.data ?? {};
+        // I campi troppo lunghi si scoprono qui, tutti insieme, invece che uno per rifiuto (CYCL-32). Il
+        // valore attuale fa da salvaguardia: una pagina scritta prima che il tetto esistesse si può
+        // ancora correggere e accorciare per gradi, com'è dal server.
+        const tooLong = (0, limits_1.tooLongMessage)([
+            { flag: '--title', value: flags.title, max: limits_1.LENGTH_LIMITS.title, previous: page.title },
+            { flag: bodyFlag, value: body, max: limits_1.LENGTH_LIMITS.pageBody, previous: page.body },
+            { flag: techSpecFlag, value: techSpec, max: limits_1.LENGTH_LIMITS.techSpec, previous: page.tech_spec },
+        ]);
+        if (tooLong)
+            this.error(tooLong, { exit: 2 });
         const res = await this.api.put(base, {
             title: flags.title ?? page.title,
             kind: flags.kind ?? page.kind,

package/dist/commands/logout.js

@@ -6,6 +6,9 @@ class Logout extends base_1.BaseCommand {
     static description = 'Clear the locally stored token and identity';
     static examples = ['<%= config.bin %> logout'];
     async run() {
+        // Validate the command line before touching the stored credentials: a mistyped flag must stop
+        // the command, not be ignored while it logs you out anyway (CYCL-33).
+        await this.parse(Logout);
         (0, config_1.clearToken)();
         if (!this.jsonEnabled()) {
             this.log('Logged out. Local credentials cleared.');

package/dist/commands/org/show.js

@@ -6,6 +6,8 @@ class OrgShow extends base_1.BaseCommand {
     static description = 'Show your organization settings';
     static examples = ['<%= config.bin %> org show', '<%= config.bin %> org show --json'];
     async run() {
+        // No flags of its own, but the parser is what rejects a mistyped one (CYCL-33).
+        await this.parse(OrgShow);
         const res = await this.api.get('/cli/v1/organization');
         if (!this.jsonEnabled()) {
             this.log((0, output_1.renderRecord)(res.data ?? {}));

package/dist/commands/personal/import.js

@@ -11,7 +11,7 @@ class PersonalImport extends base_1.BaseCommand {
     static examples = [
         '<%= config.bin %> personal import --from-file .env',
         '<%= config.bin %> personal import --format json --from-file secrets.json',
-        'doppler secrets download --no-file --format json | <%= config.bin %> personal import --format json',
+        'printf \'{"API_KEY":"value"}\' | <%= config.bin %> personal import --format json',
     ];
     static flags = {
         'from-file': core_1.Flags.string({ description: 'Path to a .env or JSON file (default: read from stdin)' }),
@@ -25,7 +25,7 @@ class PersonalImport extends base_1.BaseCommand {
         }
         else {
             if (process.stdin.isTTY) {
-                this.error('Provide --from-file or pipe the input via stdin (e.g. `doppler secrets download --format json | cyi personal import --format json`)', { exit: 1 });
+                this.error('Provide --from-file or pipe JSON/ENV input via stdin (e.g. `printf \'{"API_KEY":"value"}\' | cyi personal import --format json`)', { exit: 1 });
             }
             text = await (0, stdin_1.readStream)();
         }

package/dist/commands/personal/run.js

@@ -7,7 +7,7 @@ class PersonalRun extends base_1.BaseCommand {
     static strict = false;
     // The output belongs to the child process, not to us.
     static enableJsonFlag = false;
-    static description = 'Run a command with your personal secrets injected as env vars (like `doppler run`). Secrets never touch disk.';
+    static description = 'Run a command with your personal secrets injected as env vars. Secrets never touch disk.';
     static examples = [
         '<%= config.bin %> personal run -- bundle exec rails server',
         '<%= config.bin %> personal run -- printenv OPENAI_API_KEY',

package/dist/commands/run.js

@@ -7,7 +7,7 @@ class Run extends base_1.BaseCommand {
     static strict = false;
     // The output belongs to the child process, not to us.
     static enableJsonFlag = false;
-    static description = 'Run a command with the project/environment secrets injected as env vars (like `doppler run`). Secrets never touch disk.';
+    static description = 'Run a command with project/environment secrets injected as env vars. Secrets never touch disk.';
     static examples = [
         '<%= config.bin %> run -p acme-api -e production -- bundle exec rails server',
         '<%= config.bin %> run -p acme-api -e production -- printenv DATABASE_URL',

package/dist/commands/secrets/import.js

@@ -36,7 +36,7 @@ class SecretsImport extends base_1.BaseCommand {
     static examples = [
         '<%= config.bin %> secrets import -p acme-api -e production --from-file .env',
         '<%= config.bin %> secrets import -p acme-api -e production --format json --from-file secrets.json',
-        'doppler secrets download --config production --no-file --format json | <%= config.bin %> secrets import -p acme-api -e production --format json',
+        'printf \'{"API_KEY":"value"}\' | <%= config.bin %> secrets import -p acme-api -e development --format json',
     ];
     static flags = {
         ...base_1.projectFlag,
@@ -53,7 +53,7 @@ class SecretsImport extends base_1.BaseCommand {
         }
         else {
             if (process.stdin.isTTY) {
-                this.error('Provide --from-file or pipe the input via stdin (e.g. `doppler secrets download --format json | cyi secrets import --format json`)', { exit: 1 });
+                this.error('Provide --from-file or pipe JSON/ENV input via stdin (e.g. `printf \'{"API_KEY":"value"}\' | cyi secrets import -p acme-api -e development --format json`)', { exit: 1 });
             }
             text = await (0, stdin_1.readStream)();
         }

package/dist/commands/seo/ignore.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base';
+export default class SeoIgnore extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        note: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/seo/ignore.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+class SeoIgnore extends base_1.BaseCommand {
+    static description = 'Ignore an SEO finding: you accept living with it';
+    static examples = [
+        '<%= config.bin %> seo ignore <issue-id>',
+        '<%= config.bin %> seo ignore <issue-id> --note "Service page, not meant to be found."',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'SEO finding id', required: true }),
+    };
+    static flags = {
+        note: core_1.Flags.string({ description: 'Why you are keeping it (shown alongside the ignored row)' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(SeoIgnore);
+        const res = await this.api.put(`/cli/v1/seo/${args.id}/ignore`, { triage_note: flags.note });
+        if (!this.jsonEnabled()) {
+            // An ignored finding never reopens on its own: the next check won't undo a decision taken.
+            this.log(`SEO finding ${args.id} ignored.`);
+        }
+        return res;
+    }
+}
+exports.default = SeoIgnore;

package/dist/commands/seo/list.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../base';
+export default class SeoList extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        page: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        severity: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        status: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        area: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/seo/list.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+class SeoList extends base_1.BaseCommand {
+    static description = 'List the SEO findings of your sites (cross-project)';
+    static examples = [
+        '<%= config.bin %> seo list',
+        '<%= config.bin %> seo list --severity critical',
+        '<%= config.bin %> seo list --project acme-site --status open',
+        '<%= config.bin %> seo list --area indexability --json',
+    ];
+    static flags = {
+        // Optional here (the endpoint is cross-project): without it, the list spans every visible project.
+        project: core_1.Flags.string({ char: 'p', description: 'Filter by project id (UUID) or key' }),
+        severity: core_1.Flags.string({ description: 'Filter by severity (critical, high, medium, low)' }),
+        status: core_1.Flags.string({ description: 'Filter by status (open, resolved, ignored)' }),
+        area: core_1.Flags.string({ description: 'Filter by area (indexability, structure, content, i18n, performance)' }),
+        ...base_1.pageFlag,
+    };
+    async run() {
+        const { flags } = await this.parse(SeoList);
+        const query = new URLSearchParams({ page: String(flags.page) });
+        if (flags.project)
+            query.set('project_id', await this.resolveProjectId(flags.project));
+        if (flags.severity)
+            query.set('severity', flags.severity);
+        if (flags.status)
+            query.set('status', flags.status);
+        if (flags.area)
+            query.set('area', flags.area);
+        const res = await this.api.get(`/cli/v1/seo?${query.toString()}`);
+        const issues = res.data ?? [];
+        if (!this.jsonEnabled()) {
+            this.log((0, output_1.renderTable)(
+            // ID first, like `vulnerabilities list`: every other subcommand takes it as its argument,
+            // so a table without it forces `--json` just to triage what you are already looking at.
+            ['ID', 'PROJECT', 'CHECK', 'URL', 'SEVERITY', 'STATUS'], issues.map((issue) => [
+                String(issue.id ?? ''),
+                String(issue.project?.key ?? ''),
+                String(issue.check_key ?? ''),
+                // A site-wide finding (duplicate titles, unreachable sitemap) has no single URL.
+                String(issue.url ?? '— whole site'),
+                (0, output_1.statusCell)(issue.severity),
+                (0, output_1.statusCell)(issue.status),
+            ])));
+        }
+        return res;
+    }
+}
+exports.default = SeoList;

package/dist/commands/seo/pages.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from '../../base';
+export default class SeoPages extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        page: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        url: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/seo/pages.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+class SeoPages extends base_1.BaseCommand {
+    static description = 'List the pages the SEO check has visited, with their state';
+    static examples = [
+        '<%= config.bin %> seo pages',
+        '<%= config.bin %> seo pages --project acme-site',
+        '<%= config.bin %> seo pages --url /prezzi --json',
+    ];
+    static flags = {
+        project: core_1.Flags.string({ char: 'p', description: 'Filter by project id (UUID) or key' }),
+        url: core_1.Flags.string({ description: 'Filter by URL (partial match)' }),
+        ...base_1.pageFlag,
+    };
+    async run() {
+        const { flags } = await this.parse(SeoPages);
+        const query = new URLSearchParams({ page: String(flags.page) });
+        if (flags.project)
+            query.set('project_id', await this.resolveProjectId(flags.project));
+        if (flags.url)
+            query.set('url', flags.url);
+        const res = await this.api.get(`/cli/v1/seo/pages?${query.toString()}`);
+        const pages = res.data ?? [];
+        if (!this.jsonEnabled()) {
+            this.log((0, output_1.renderTable)(['PROJECT', 'PATH', 'STATUS', 'TITLE', 'H1', 'WORDS'], pages.map((page) => {
+                const headings = Array.isArray(page.h1s) ? page.h1s : [];
+                return [
+                    String(page.project?.key ?? ''),
+                    String(page.path ?? page.url ?? ''),
+                    (0, output_1.statusCell)(page.status_code),
+                    String(page.title ?? '—'),
+                    // No h1 is the finding a green score never reports: it belongs in the column, not hidden.
+                    headings.length === 0 ? 'missing' : String(headings.length),
+                    String(page.word_count ?? 0),
+                ];
+            })));
+        }
+        return res;
+    }
+}
+exports.default = SeoPages;

package/dist/commands/seo/promote.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from '../../base';
+export default class SeoPromote extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/seo/promote.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+class SeoPromote extends base_1.BaseCommand {
+    static description = 'Open a ticket from an SEO finding, evidence included';
+    static examples = ['<%= config.bin %> seo promote <issue-id>'];
+    static args = {
+        id: core_1.Args.string({ description: 'SEO finding id', required: true }),
+    };
+    async run() {
+        const { args } = await this.parse(SeoPromote);
+        // Idempotent server-side: promoting twice returns R422-SEO-001, never a second ticket.
+        const res = await this.api.put(`/cli/v1/seo/${args.id}/promotion`);
+        if (!this.jsonEnabled()) {
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = SeoPromote;

package/dist/commands/seo/reopen.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from '../../base';
+export default class SeoReopen extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/seo/reopen.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+class SeoReopen extends base_1.BaseCommand {
+    static description = 'Reopen an ignored SEO finding: you changed your mind';
+    static examples = ['<%= config.bin %> seo reopen <issue-id>'];
+    static args = {
+        id: core_1.Args.string({ description: 'SEO finding id', required: true }),
+    };
+    async run() {
+        const { args } = await this.parse(SeoReopen);
+        // Reopening is deleting the ignore, not a verb of its own — hence DELETE on the same resource.
+        const res = await this.api.delete(`/cli/v1/seo/${args.id}/ignore`);
+        if (!this.jsonEnabled()) {
+            this.log(`SEO finding ${args.id} reopened.`);
+        }
+        return res;
+    }
+}
+exports.default = SeoReopen;

package/dist/commands/seo/rescan.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from '../../base';
+export default class SeoRescan extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        site: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/seo/rescan.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+class SeoRescan extends base_1.BaseCommand {
+    static description = 'Check a site now, without waiting for the next scheduled run';
+    static examples = ['<%= config.bin %> seo rescan --site <site-id>'];
+    // Required: a check always targets one site (a project can declare one per environment).
+    static flags = {
+        site: core_1.Flags.string({ description: 'Site id (from `seo-sites list`)', required: true }),
+    };
+    async run() {
+        const { flags } = await this.parse(SeoRescan);
+        const res = await this.api.post('/cli/v1/seo/rescan', { site_id: flags.site });
+        if (!this.jsonEnabled()) {
+            this.log(`Check queued for site ${flags.site}.`);
+        }
+        return res;
+    }
+}
+exports.default = SeoRescan;

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

@@ -0,0 +1,9 @@
+import { BaseCommand } from '../../base';
+export default class SeoShow extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/seo/show.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+/** A nested object of the payload, or `{}` when the field is absent. */
+function nested(data, key) {
+    const value = data[key];
+    return value && typeof value === 'object' ? value : {};
+}
+class SeoShow extends base_1.BaseCommand {
+    static description = 'Show a single SEO finding, with the evidence behind it';
+    static examples = ['<%= config.bin %> seo show <issue-id>'];
+    static args = {
+        id: core_1.Args.string({ description: 'SEO finding id', required: true }),
+    };
+    async run() {
+        const { args } = await this.parse(SeoShow);
+        const res = await this.api.get(`/cli/v1/seo/${args.id}`);
+        if (!this.jsonEnabled()) {
+            const data = res.data ?? {};
+            // Evidence in a block of its own: it is the reason the finding exists, and burying it among
+            // the metadata means reopening the browser to see what was actually found.
+            this.log((0, output_1.renderRecord)({ ...data, evidence: undefined }));
+            this.log((0, output_1.section)('Evidence', '🔎'));
+            this.log((0, output_1.renderRecord)(nested(data, 'evidence')));
+            this.log((0, output_1.section)('Site', '🌐'));
+            this.log((0, output_1.renderRecord)(nested(data, 'site')));
+            this.log((0, output_1.section)('Project', '📦'));
+            this.log((0, output_1.renderRecord)(nested(data, 'project')));
+        }
+        return res;
+    }
+}
+exports.default = SeoShow;

package/dist/commands/seo-sites/create.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../base';
+export default class SeoSitesCreate extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        url: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        environment: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        frequency: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'max-pages': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'no-sitemap': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/seo-sites/create.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
+class SeoSitesCreate extends base_1.BaseCommand {
+    static description = 'Declare a site to keep an eye on (one per project and environment)';
+    static examples = [
+        '<%= config.bin %> seo-sites create --project acme-site --url https://www.acme.example --environment <env-id>',
+        '<%= config.bin %> seo-sites create -p acme-site --url https://www.acme.example --environment <env-id> --frequency weekly --max-pages 50',
+    ];
+    static flags = {
+        ...base_1.projectFlag,
+        url: core_1.Flags.string({ description: 'Public address the visit starts from', required: true }),
+        environment: core_1.Flags.string({ description: 'Environment id (must be declared by the project)', required: true }),
+        frequency: core_1.Flags.string({ description: 'How often to check it: daily (default) or weekly', options: ['daily', 'weekly'] }),
+        'max-pages': core_1.Flags.integer({ description: 'How many pages to visit at most each run' }),
+        'no-sitemap': core_1.Flags.boolean({ description: "Don't read the sitemap: start from the home page and follow links only" }),
+    };
+    async run() {
+        const { flags } = await this.parse(SeoSitesCreate);
+        const projectId = await this.resolveProjectId(flags.project);
+        const body = {
+            project_id: projectId,
+            environment_id: flags.environment,
+            base_url: flags.url,
+        };
+        if (flags.frequency !== undefined)
+            body.frequency = flags.frequency;
+        if (flags['max-pages'] !== undefined)
+            body.max_pages = flags['max-pages'];
+        if (flags['no-sitemap'])
+            body.follow_sitemap = false;
+        const res = await this.api.post('/cli/v1/seo_sites', body);
+        if (!this.jsonEnabled()) {
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+            // The first run starts on creation: without saying so, an empty list looks like a failure.
+            this.log('First check queued.');
+        }
+        return res;
+    }
+}
+exports.default = SeoSitesCreate;

package/dist/commands/seo-sites/delete.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from '../../base';
+export default class SeoSitesDelete extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<unknown>;
+}