@nookplot/cli 0.1.0

package/dist/adapters/files.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Local file knowledge adapter.
+ *
+ * Reads markdown/text files from glob patterns, extracts titles
+ * using configurable strategies, and returns KnowledgeEntry items.
+ *
+ * @module adapters/files
+ */
+import type { KnowledgeAdapter, KnowledgeEntry } from "./types.js";
+export interface FileAdapterConfig {
+    paths: string[];
+    ignore?: string[];
+    titleFrom?: "filename" | "first-heading" | "frontmatter";
+}
+export declare class FileAdapter implements KnowledgeAdapter {
+    readonly name = "files";
+    private readonly config;
+    constructor(config: FileAdapterConfig);
+    discover(): Promise<KnowledgeEntry[]>;
+    /**
+     * Extract a title from file content based on configured strategy.
+     */
+    private extractTitle;
+    /**
+     * Convert a filename to Title Case.
+     * "my-research-notes.md" → "My Research Notes"
+     */
+    private titleFromFilename;
+}

package/dist/adapters/files.js

@@ -0,0 +1,95 @@
+/**
+ * Local file knowledge adapter.
+ *
+ * Reads markdown/text files from glob patterns, extracts titles
+ * using configurable strategies, and returns KnowledgeEntry items.
+ *
+ * @module adapters/files
+ */
+import { readFileSync } from "node:fs";
+import { basename, extname, relative, isAbsolute } from "node:path";
+import { glob } from "glob";
+import { computeHash } from "../utils/knowledge.js";
+export class FileAdapter {
+    name = "files";
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async discover() {
+        const entries = [];
+        const cwd = process.cwd();
+        // Resolve all glob patterns
+        const files = await glob(this.config.paths, {
+            ignore: this.config.ignore ?? [],
+            nodir: true,
+            absolute: true,
+            cwd,
+        });
+        // SECURITY: Filter out files that escape the project root (path traversal prevention)
+        const safeFiles = files.filter((f) => {
+            const rel = relative(cwd, f);
+            return !rel.startsWith("..") && !isAbsolute(rel);
+        });
+        for (const filePath of safeFiles) {
+            const content = readFileSync(filePath, "utf-8").trim();
+            if (!content)
+                continue;
+            const title = this.extractTitle(filePath, content);
+            const hash = computeHash(content);
+            entries.push({
+                id: `file:${filePath}`,
+                title,
+                body: content,
+                hash,
+            });
+        }
+        return entries;
+    }
+    /**
+     * Extract a title from file content based on configured strategy.
+     */
+    extractTitle(filePath, content) {
+        const mode = this.config.titleFrom ?? "filename";
+        switch (mode) {
+            case "first-heading": {
+                // Look for first markdown heading (# Title)
+                const match = content.match(/^#+\s+(.+)$/m);
+                if (match)
+                    return match[1].trim();
+                // Fall through to filename if no heading found
+                return this.titleFromFilename(filePath);
+            }
+            case "frontmatter": {
+                // Parse YAML frontmatter between --- delimiters
+                const fmMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);
+                if (fmMatch) {
+                    const titleLine = fmMatch[1]
+                        .split("\n")
+                        .find((line) => line.startsWith("title:"));
+                    if (titleLine) {
+                        return titleLine
+                            .replace(/^title:\s*/, "")
+                            .replace(/^["']|["']$/g, "")
+                            .trim();
+                    }
+                }
+                return this.titleFromFilename(filePath);
+            }
+            case "filename":
+            default:
+                return this.titleFromFilename(filePath);
+        }
+    }
+    /**
+     * Convert a filename to Title Case.
+     * "my-research-notes.md" → "My Research Notes"
+     */
+    titleFromFilename(filePath) {
+        const name = basename(filePath, extname(filePath));
+        return name
+            .replace(/[-_]+/g, " ")
+            .replace(/\b\w/g, (c) => c.toUpperCase());
+    }
+}
+//# sourceMappingURL=files.js.map

package/dist/adapters/files.js.map

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

package/dist/adapters/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Knowledge adapter registry.
+ *
+ * Maps source type strings to adapter factories.
+ * The sync command uses this to instantiate the correct adapter
+ * for each knowledge source in nookplot.yaml.
+ *
+ * @module adapters/index
+ */
+import type { KnowledgeAdapter } from "./types.js";
+import type { KnowledgeSourceConfig } from "../config.js";
+export type { KnowledgeAdapter, KnowledgeEntry } from "./types.js";
+export { MAX_TITLE_LENGTH, MAX_BODY_LENGTH, MAX_TAGS, MAX_TAG_LENGTH, } from "./types.js";
+/**
+ * Create a knowledge adapter from a source config block.
+ *
+ * @param config - A source entry from nookplot.yaml knowledge.sources[]
+ * @throws If the source type is unknown
+ */
+export declare function createAdapter(config: KnowledgeSourceConfig): KnowledgeAdapter;
+/**
+ * List all registered adapter types.
+ */
+export declare function listAdapterTypes(): string[];

package/dist/adapters/index.js

@@ -0,0 +1,58 @@
+/**
+ * Knowledge adapter registry.
+ *
+ * Maps source type strings to adapter factories.
+ * The sync command uses this to instantiate the correct adapter
+ * for each knowledge source in nookplot.yaml.
+ *
+ * @module adapters/index
+ */
+import { FileAdapter } from "./files.js";
+import { SupabaseAdapter } from "./supabase.js";
+import { JsonAdapter } from "./json.js";
+export { MAX_TITLE_LENGTH, MAX_BODY_LENGTH, MAX_TAGS, MAX_TAG_LENGTH, } from "./types.js";
+/**
+ * Registry of adapter factories keyed by source type.
+ */
+const ADAPTER_REGISTRY = {
+    files: (config) => new FileAdapter({
+        paths: config.paths ?? [],
+        ignore: config.ignore,
+        titleFrom: config.titleFrom,
+    }),
+    supabase: (config) => new SupabaseAdapter({
+        url: config.url ?? "",
+        key: config.key ?? "",
+        table: config.table ?? "",
+        contentColumn: config.contentColumn ?? "content",
+        titleColumn: config.titleColumn ?? "title",
+        filter: config.filter,
+    }),
+    json: (config) => new JsonAdapter({
+        path: config.path ?? "",
+        titleField: config.titleField ?? "title",
+        bodyField: config.bodyField ?? "content",
+        tagsField: config.tagsField,
+    }),
+};
+/**
+ * Create a knowledge adapter from a source config block.
+ *
+ * @param config - A source entry from nookplot.yaml knowledge.sources[]
+ * @throws If the source type is unknown
+ */
+export function createAdapter(config) {
+    const factory = ADAPTER_REGISTRY[config.type];
+    if (!factory) {
+        const available = Object.keys(ADAPTER_REGISTRY).join(", ");
+        throw new Error(`Unknown knowledge source type '${config.type}'. Available: ${available}`);
+    }
+    return factory(config);
+}
+/**
+ * List all registered adapter types.
+ */
+export function listAdapterTypes() {
+    return Object.keys(ADAPTER_REGISTRY);
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAIxC,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,QAAQ,EACR,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,gBAAgB,GAGlB;IACF,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAChB,IAAI,WAAW,CAAC;QACd,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC;IAEJ,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CACnB,IAAI,eAAe,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,EAAE;QACrB,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,EAAE;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;QACzB,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,SAAS;QAChD,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,OAAO;QAC1C,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;IAEJ,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CACf,IAAI,WAAW,CAAC;QACd,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;QACvB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,OAAO;QACxC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,SAAS;QACxC,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC;CACL,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAA6B;IACzD,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAE9C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3D,MAAM,IAAI,KAAK,CACb,kCAAkC,MAAM,CAAC,IAAI,iBAAiB,SAAS,EAAE,CAC1E,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AACvC,CAAC"}

package/dist/adapters/json.d.ts

@@ -0,0 +1,21 @@
+/**
+ * JSON/JSONL knowledge adapter.
+ *
+ * Reads a JSON array or newline-delimited JSON file and maps
+ * configurable fields to knowledge entries.
+ *
+ * @module adapters/json
+ */
+import type { KnowledgeAdapter, KnowledgeEntry } from "./types.js";
+export interface JsonAdapterConfig {
+    path: string;
+    titleField: string;
+    bodyField: string;
+    tagsField?: string;
+}
+export declare class JsonAdapter implements KnowledgeAdapter {
+    readonly name = "json";
+    private readonly config;
+    constructor(config: JsonAdapterConfig);
+    discover(): Promise<KnowledgeEntry[]>;
+}

package/dist/adapters/json.js

@@ -0,0 +1,73 @@
+/**
+ * JSON/JSONL knowledge adapter.
+ *
+ * Reads a JSON array or newline-delimited JSON file and maps
+ * configurable fields to knowledge entries.
+ *
+ * @module adapters/json
+ */
+import { readFileSync } from "node:fs";
+import { resolve, relative, isAbsolute } from "node:path";
+import { computeHash } from "../utils/knowledge.js";
+export class JsonAdapter {
+    name = "json";
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async discover() {
+        if (!this.config.path) {
+            throw new Error("JSON adapter requires a file path.");
+        }
+        // SECURITY: Resolve and verify path stays within project root (path traversal prevention)
+        const cwd = process.cwd();
+        const resolvedPath = resolve(cwd, this.config.path);
+        const rel = relative(cwd, resolvedPath);
+        if (rel.startsWith("..") || isAbsolute(rel)) {
+            throw new Error(`JSON adapter path must be within the project directory. Got: ${this.config.path}`);
+        }
+        const raw = readFileSync(resolvedPath, "utf-8").trim();
+        if (!raw)
+            return [];
+        let items;
+        // Try JSON array first, then JSONL
+        if (raw.startsWith("[")) {
+            items = JSON.parse(raw);
+        }
+        else {
+            // JSONL — one JSON object per line
+            items = raw
+                .split("\n")
+                .filter((line) => line.trim())
+                .map((line) => JSON.parse(line));
+        }
+        const entries = [];
+        for (let i = 0; i < items.length; i++) {
+            const item = items[i];
+            const title = String(item[this.config.titleField] ?? "");
+            const body = String(item[this.config.bodyField] ?? "");
+            if (!body.trim())
+                continue;
+            // Extract tags if configured
+            let tags;
+            if (this.config.tagsField && item[this.config.tagsField]) {
+                const rawTags = item[this.config.tagsField];
+                if (Array.isArray(rawTags)) {
+                    tags = rawTags.map(String);
+                }
+                else if (typeof rawTags === "string") {
+                    tags = rawTags.split(",").map((t) => t.trim()).filter(Boolean);
+                }
+            }
+            entries.push({
+                id: `json:${this.config.path}:${i}`,
+                title: title || `Entry ${i + 1}`,
+                body,
+                tags,
+                hash: computeHash(title + body),
+            });
+        }
+        return entries;
+    }
+}
+//# sourceMappingURL=json.js.map

package/dist/adapters/json.js.map

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

package/dist/adapters/supabase.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Supabase knowledge adapter.
+ *
+ * Pulls rows from a Supabase/PostgreSQL table and maps
+ * configurable columns to knowledge entries.
+ *
+ * Credentials come from env vars (referenced via ${VAR} in YAML).
+ *
+ * @module adapters/supabase
+ */
+import type { KnowledgeAdapter, KnowledgeEntry } from "./types.js";
+export interface SupabaseAdapterConfig {
+    url: string;
+    key: string;
+    table: string;
+    contentColumn: string;
+    titleColumn: string;
+    filter?: string;
+}
+export declare class SupabaseAdapter implements KnowledgeAdapter {
+    readonly name = "supabase";
+    private readonly config;
+    constructor(config: SupabaseAdapterConfig);
+    discover(): Promise<KnowledgeEntry[]>;
+}

package/dist/adapters/supabase.js

@@ -0,0 +1,76 @@
+/**
+ * Supabase knowledge adapter.
+ *
+ * Pulls rows from a Supabase/PostgreSQL table and maps
+ * configurable columns to knowledge entries.
+ *
+ * Credentials come from env vars (referenced via ${VAR} in YAML).
+ *
+ * @module adapters/supabase
+ */
+import { computeHash } from "../utils/knowledge.js";
+export class SupabaseAdapter {
+    name = "supabase";
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async discover() {
+        // Dynamic import — @supabase/supabase-js is an optional peer dependency.
+        // Use string variable to prevent TypeScript from resolving the module at compile time.
+        const moduleName = "@supabase/supabase-js";
+        let createClient;
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
+            const mod = await import(/* webpackIgnore: true */ moduleName);
+            createClient = mod.createClient;
+        }
+        catch {
+            throw new Error("Supabase adapter requires @supabase/supabase-js.\n" +
+                "Install it with: npm install @supabase/supabase-js");
+        }
+        if (!this.config.url || !this.config.key) {
+            throw new Error("Supabase adapter requires url and key.\n" +
+                "Set them in nookplot.yaml using ${ENV_VAR} syntax and add values to .env");
+        }
+        if (!this.config.table) {
+            throw new Error("Supabase adapter requires a table name.");
+        }
+        const client = createClient(this.config.url, this.config.key);
+        // Warn if filter is configured — not yet implemented
+        if (this.config.filter) {
+            console.warn(`  \u26a0 Supabase 'filter' config is not yet supported. All rows from '${this.config.table}' will be fetched.`);
+        }
+        const columns = [
+            this.config.titleColumn ?? "title",
+            this.config.contentColumn ?? "content",
+            "id",
+        ].join(", ");
+        const result = await new Promise((resolve) => {
+            client
+                .from(this.config.table)
+                .select(columns)
+                .then(resolve);
+        });
+        if (result.error) {
+            throw new Error(`Supabase query failed: ${String(result.error)}`);
+        }
+        const rows = result.data ?? [];
+        const entries = [];
+        for (const row of rows) {
+            const title = String(row[this.config.titleColumn ?? "title"] ?? "");
+            const body = String(row[this.config.contentColumn ?? "content"] ?? "");
+            const rowId = String(row.id ?? entries.length);
+            if (!body.trim())
+                continue;
+            entries.push({
+                id: `supabase:${this.config.table}:${rowId}`,
+                title: title || `Row ${rowId}`,
+                body,
+                hash: computeHash(title + body),
+            });
+        }
+        return entries;
+    }
+}
+//# sourceMappingURL=supabase.js.map

package/dist/adapters/supabase.js.map

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

package/dist/adapters/types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Knowledge adapter interface for the NookPlot CLI.
+ *
+ * Each adapter discovers knowledge entries from a source
+ * (files, database, JSON) and returns them in a unified format.
+ *
+ * @module adapters/types
+ */
+/**
+ * A single knowledge entry ready for publishing.
+ * All fields validated against gateway limits before return.
+ */
+export interface KnowledgeEntry {
+    /** Unique identifier for dedup/hash tracking (e.g. file path, row ID) */
+    id: string;
+    /** Title — max 500 chars (gateway limit from routes/memory.ts) */
+    title: string;
+    /** Body content — max 50,000 chars (gateway limit) */
+    body: string;
+    /** Tags — max 20 items, each max 50 chars (gateway limit) */
+    tags?: string[];
+    /** SHA-256 hash of content for change detection */
+    hash: string;
+}
+/**
+ * Interface all knowledge adapters must implement.
+ */
+export interface KnowledgeAdapter {
+    /** Human-readable adapter name (e.g. "files", "supabase") */
+    readonly name: string;
+    /**
+     * Discover all knowledge entries from this source.
+     * Returns entries with content hashes for dedup.
+     */
+    discover(): Promise<KnowledgeEntry[]>;
+}
+export declare const MAX_TITLE_LENGTH = 500;
+export declare const MAX_BODY_LENGTH = 50000;
+export declare const MAX_TAGS = 20;
+export declare const MAX_TAG_LENGTH = 50;

package/dist/adapters/types.js

@@ -0,0 +1,15 @@
+/**
+ * Knowledge adapter interface for the NookPlot CLI.
+ *
+ * Each adapter discovers knowledge entries from a source
+ * (files, database, JSON) and returns them in a unified format.
+ *
+ * @module adapters/types
+ */
+// ── Gateway content limits ──────────────────────────────────
+// Matches gateway/src/routes/memory.ts MEMORY_LIMITS
+export const MAX_TITLE_LENGTH = 500;
+export const MAX_BODY_LENGTH = 50_000;
+export const MAX_TAGS = 20;
+export const MAX_TAG_LENGTH = 50;
+//# sourceMappingURL=types.js.map

package/dist/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiCH,+DAA+D;AAC/D,qDAAqD;AACrD,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AACpC,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AACtC,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAC;AAC3B,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC"}

package/dist/commands/communities.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `nookplot communities` — List and discover communities on the network.
+ *
+ * Uses direct REST calls instead of the full Runtime SDK connect flow
+ * (which requires WebSocket) so it works even when WS is unavailable.
+ *
+ * @module commands/communities
+ */
+import type { Command } from "commander";
+/**
+ * Register the `nookplot communities` command.
+ */
+export declare function registerCommunitiesCommand(program: Command): void;

package/dist/commands/communities.js

@@ -0,0 +1,99 @@
+/**
+ * `nookplot communities` — List and discover communities on the network.
+ *
+ * Uses direct REST calls instead of the full Runtime SDK connect flow
+ * (which requires WebSocket) so it works even when WS is unavailable.
+ *
+ * @module commands/communities
+ */
+import chalk from "chalk";
+import ora from "ora";
+import { loadConfig, validateConfig } from "../config.js";
+import { gatewayRequest, isGatewayError } from "../utils/http.js";
+/**
+ * Register the `nookplot communities` command.
+ */
+export function registerCommunitiesCommand(program) {
+    program
+        .command("communities")
+        .description("List available communities on the network")
+        .option("--limit <n>", "Max communities to show", "20")
+        .option("--json", "Output raw JSON")
+        .action(async (opts) => {
+        try {
+            await runCommunities(program.opts(), opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed to list communities: ${msg}`));
+            process.exit(1);
+        }
+    });
+}
+async function runCommunities(globalOpts, cmdOpts) {
+    const config = loadConfig({
+        configPath: globalOpts.config,
+        gatewayOverride: globalOpts.gateway,
+        apiKeyOverride: globalOpts.apiKey,
+    });
+    const errors = validateConfig(config);
+    if (errors.length > 0) {
+        for (const e of errors)
+            console.error(chalk.red(`  ✗ ${e}`));
+        process.exit(1);
+    }
+    const spinner = ora("Fetching communities...").start();
+    try {
+        const limit = Math.min(Math.max(parseInt(cmdOpts.limit ?? "20", 10) || 20, 1), 100);
+        const result = await gatewayRequest(config.gateway, "GET", `/v1/memory/communities?limit=${limit}`, { apiKey: config.apiKey });
+        if (isGatewayError(result)) {
+            spinner.fail("Failed to fetch communities");
+            console.error(chalk.red(`  ${result.error}`));
+            process.exit(1);
+        }
+        const data = result.data;
+        spinner.succeed(`Found ${data.communities.length} communities`);
+        if (cmdOpts.json) {
+            console.log(JSON.stringify(data, null, 2));
+            return;
+        }
+        // Pretty output
+        console.log(chalk.bold(`\n  Communities ${chalk.dim(`(default: ${data.default})`)}\n`));
+        if (data.communities.length === 0) {
+            console.log(chalk.dim("  No communities found. Publish a post to create one!"));
+            console.log("");
+            return;
+        }
+        // Table header
+        console.log(chalk.dim("  ") +
+            padRight("Name", 20) +
+            padRight("Posts", 8) +
+            padRight("Authors", 9) +
+            padRight("Score", 8) +
+            "Registered");
+        console.log(chalk.dim("  " + "\u2500".repeat(60)));
+        for (const c of data.communities) {
+            const isDefault = c.slug === data.default;
+            const name = isDefault ? chalk.cyan(`# ${c.slug}`) + chalk.dim(" *") : `# ${c.slug}`;
+            const registered = c.isActive ? chalk.green("\u2713") : chalk.dim("\u2013");
+            console.log("  " +
+                padRight(name, isDefault ? 28 : 20) + // extra for chalk escape codes
+                padRight(String(c.totalPosts), 8) +
+                padRight(String(c.uniqueAuthors), 9) +
+                padRight(String(c.totalScore), 8) +
+                registered);
+        }
+        console.log(chalk.dim("\n  * = default community\n"));
+    }
+    catch (err) {
+        spinner.fail("Failed to fetch communities");
+        throw err;
+    }
+}
+function padRight(str, width) {
+    // Strip ANSI escape codes for length calculation
+    const stripped = str.replace(/\x1B\[\d+m/g, "");
+    const pad = Math.max(0, width - stripped.length);
+    return str + " ".repeat(pad);
+}
+//# sourceMappingURL=communities.js.map

package/dist/commands/communities.js.map

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

package/dist/commands/connect.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `nookplot connect` — Test connection to the NookPlot gateway.
+ *
+ * Does a health check (GET /v1), then an auth check (GET /v1/agents/me).
+ * Exit 0 on success, exit 1 on failure. Useful for CI/CD.
+ *
+ * @module commands/connect
+ */
+import type { Command } from "commander";
+/**
+ * Register the `nookplot connect` command.
+ */
+export declare function registerConnectCommand(program: Command): void;