@bussolabs/closeyourit-cli 0.0.12 → 0.0.14

package/dist/commands/kb/list.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 knowledge_1 = require("../../lib/knowledge");
+class KbList extends base_1.BaseCommand {
+    static description = 'List knowledge pages across the projects you can see';
+    static examples = [
+        '<%= config.bin %> kb list',
+        '<%= config.bin %> kb list --project acme-api --kind decision',
+        '<%= config.bin %> kb list --kind note,guide --per 50 --json',
+    ];
+    static flags = {
+        // Optional (the endpoint is cross-project): omit it to span every visible project.
+        project: core_1.Flags.string({ char: 'p', description: 'Filter by project (key or UUID)' }),
+        kind: core_1.Flags.string({ description: 'Filter by kind: note|decision|guide (repeatable or comma-separated)', multiple: true }),
+        per: core_1.Flags.integer({ description: 'Page size' }),
+        ...base_1.pageFlag,
+    };
+    async run() {
+        const { flags } = await this.parse(KbList);
+        const query = (0, knowledge_1.buildPagesQuery)({
+            kinds: (0, knowledge_1.normalizeKinds)(flags.kind),
+            page: flags.page,
+            per: flags.per,
+            project: flags.project,
+        });
+        const res = await this.api.get(`/cli/v1/knowledge/pages?${query}`);
+        if (!this.jsonEnabled()) {
+            this.log((0, knowledge_1.renderPagesTable)(res.data ?? []));
+        }
+        return res;
+    }
+}
+exports.default = KbList;

package/dist/commands/kb/search.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../base';
+export default class KbSearch extends BaseCommand {
+    static strict: boolean;
+    static description: string;
+    static examples: string[];
+    static args: {
+        query: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    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>;
+        kind: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        per: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/kb/search.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../base");
+const knowledge_1 = require("../../lib/knowledge");
+class KbSearch extends base_1.BaseCommand {
+    // Variadic query: every positional word is joined into a single search string.
+    static strict = false;
+    static description = 'Search knowledge pages (semantic when available, ILIKE fallback on the title otherwise)';
+    static examples = [
+        '<%= config.bin %> kb search kamal deploy rollback',
+        '<%= config.bin %> kb search "connection pool timeout" --project acme-api',
+        '<%= config.bin %> kb search retry backoff --kind decision --json',
+    ];
+    // Non-required: with strict = false the arg validation is off, so we guard the empty case ourselves.
+    static args = {
+        query: core_1.Args.string({ description: 'Search query (all positional words are joined)' }),
+    };
+    static flags = {
+        project: core_1.Flags.string({ char: 'p', description: 'Filter by project (key or UUID)' }),
+        kind: core_1.Flags.string({ description: 'Filter by kind: note|decision|guide (repeatable or comma-separated)', multiple: true }),
+        per: core_1.Flags.integer({ description: 'Page size' }),
+        ...base_1.pageFlag,
+    };
+    async run() {
+        const { argv, flags } = await this.parse(KbSearch);
+        const q = argv.join(' ').trim();
+        if (q === '')
+            this.error('Provide a search query (e.g. "kb search kamal rollback").', { exit: 2 });
+        const query = (0, knowledge_1.buildPagesQuery)({
+            kinds: (0, knowledge_1.normalizeKinds)(flags.kind),
+            page: flags.page,
+            per: flags.per,
+            project: flags.project,
+            q,
+        });
+        const res = await this.api.get(`/cli/v1/knowledge/pages?${query}`);
+        if (!this.jsonEnabled()) {
+            // meta.search tells us whether the server ran a semantic query or fell back to a title ILIKE.
+            if (res.meta?.search === 'like') {
+                this.log('(semantic search unavailable — showing title matches)');
+            }
+            this.log((0, knowledge_1.renderPagesTable)(res.data ?? []));
+        }
+        return res;
+    }
+}
+exports.default = KbSearch;

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

@@ -0,0 +1,9 @@
+import { BaseCommand } from '../../base';
+export default class KbShow 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/kb/show.js

@@ -0,0 +1,40 @@
+"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 KbShow extends base_1.BaseCommand {
+    static description = 'Show a single knowledge page: metadata header then the raw markdown body';
+    static examples = [
+        '<%= config.bin %> kb show <page-id>',
+        '<%= config.bin %> kb show <page-id> --json',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Knowledge page id', required: true }),
+    };
+    async run() {
+        const { args } = await this.parse(KbShow);
+        const res = await this.api.get(`/cli/v1/knowledge/pages/${encodeURIComponent(args.id)}`);
+        const page = res.data ?? {};
+        if (!this.jsonEnabled()) {
+            // Header first (scalar fields only), then the body on its own so the markdown stays intact.
+            this.log((0, output_1.renderRecord)({
+                id: page.id,
+                title: page.title,
+                kind: page.kind,
+                project: page.project,
+                project_name: page.project_name,
+                author: page.author,
+                created_at: page.created_at,
+                updated_at: page.updated_at,
+            }));
+            const body = page.body;
+            if (body !== null && body !== undefined && String(body).trim() !== '') {
+                this.log('');
+                this.log((0, output_1.sanitizeMultiline)(body));
+            }
+        }
+        return res;
+    }
+}
+exports.default = KbShow;

package/dist/commands/kb/update.d.ts

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

package/dist/commands/kb/update.js

@@ -0,0 +1,53 @@
+"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 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)';
+    static examples = [
+        '<%= config.bin %> kb update <page-id> --title "New title"',
+        '<%= config.bin %> kb update <page-id> --kind decision --body-file ./adr.md',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Knowledge page id', required: true }),
+    };
+    static flags = {
+        title: core_1.Flags.string({ description: 'New title' }),
+        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' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(KbUpdate);
+        let body = flags.body;
+        if (body === undefined && flags['body-file'] !== undefined) {
+            try {
+                body = await (0, promises_1.readFile)(flags['body-file'], 'utf8');
+            }
+            catch {
+                this.error(`File not found or unreadable: ${flags['body-file']}`, { exit: 2 });
+            }
+        }
+        if (flags.title === undefined && flags.kind === undefined && body === undefined) {
+            this.error('Provide at least one of --title, --kind, --body or --body-file.', { exit: 2 });
+        }
+        // The backend expects the full title/body/kind on update → read the current page and merge,
+        // so a partial edit (e.g. only --title) doesn't blank out the other fields.
+        const base = `/cli/v1/knowledge/pages/${encodeURIComponent(args.id)}`;
+        const current = await this.api.get(base);
+        const page = current.data ?? {};
+        const res = await this.api.put(base, {
+            title: flags.title ?? page.title,
+            kind: flags.kind ?? page.kind,
+            body: body ?? page.body,
+        });
+        if (!this.jsonEnabled()) {
+            this.log('Knowledge page updated:');
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = KbUpdate;

package/dist/lib/knowledge.d.ts

@@ -0,0 +1,22 @@
+/** Knowledge page kinds accepted by the backend (Knowledge::Page). */
+export declare const KNOWLEDGE_KINDS: readonly ["note", "decision", "guide"];
+/**
+ * Flatten a repeatable + comma-separated `--kind` flag into a clean list.
+ * `--kind note --kind decision,guide` → ['note', 'decision', 'guide'].
+ */
+export declare function normalizeKinds(values?: string[]): string[];
+/** Collapse whitespace and truncate a cell so the list table stays single-line. */
+export declare function truncate(value: string, max?: number): string;
+/**
+ * Build the shared query string for `kb list` / `kb search`. Kinds go out as the
+ * `kind[]` array param; `page` is always sent, `per`/`project`/`q` only when set.
+ */
+export declare function buildPagesQuery(opts: {
+    kinds: string[];
+    page: number;
+    per?: number;
+    project?: string;
+    q?: string;
+}): string;
+/** Render the shared list/search table: TITLE, KIND, PROJECT, AUTHOR, UPDATED. */
+export declare function renderPagesTable(pages: Array<Record<string, unknown>>): string;

package/dist/lib/knowledge.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KNOWLEDGE_KINDS = void 0;
+exports.normalizeKinds = normalizeKinds;
+exports.truncate = truncate;
+exports.buildPagesQuery = buildPagesQuery;
+exports.renderPagesTable = renderPagesTable;
+const output_1 = require("./output");
+/** Knowledge page kinds accepted by the backend (Knowledge::Page). */
+exports.KNOWLEDGE_KINDS = ['note', 'decision', 'guide'];
+/**
+ * Flatten a repeatable + comma-separated `--kind` flag into a clean list.
+ * `--kind note --kind decision,guide` → ['note', 'decision', 'guide'].
+ */
+function normalizeKinds(values) {
+    if (!values)
+        return [];
+    return values
+        .flatMap((value) => value.split(','))
+        .map((value) => value.trim())
+        .filter((value) => value.length > 0);
+}
+/** Collapse whitespace and truncate a cell so the list table stays single-line. */
+function truncate(value, max = 60) {
+    const flat = value.replace(/\s+/g, ' ').trim();
+    return flat.length > max ? `${flat.slice(0, max - 1)}…` : flat;
+}
+/**
+ * Build the shared query string for `kb list` / `kb search`. Kinds go out as the
+ * `kind[]` array param; `page` is always sent, `per`/`project`/`q` only when set.
+ */
+function buildPagesQuery(opts) {
+    const query = new URLSearchParams();
+    query.set('page', String(opts.page));
+    if (opts.per !== undefined)
+        query.set('per', String(opts.per));
+    if (opts.project)
+        query.set('project', opts.project);
+    for (const kind of opts.kinds)
+        query.append('kind[]', kind);
+    if (opts.q)
+        query.set('q', opts.q);
+    return query.toString();
+}
+/** Render the shared list/search table: TITLE, KIND, PROJECT, AUTHOR, UPDATED. */
+function renderPagesTable(pages) {
+    return (0, output_1.renderTable)(['TITLE', 'KIND', 'PROJECT', 'AUTHOR', 'UPDATED'], pages.map((page) => [
+        truncate(String(page.title ?? '')),
+        String(page.kind ?? ''),
+        String(page.project ?? ''),
+        String(page.author ?? ''),
+        String(page.updated_at ?? ''),
+    ]));
+}