orbitmap 0.1.0

package/dist/commands/task-edit-content.js

@@ -0,0 +1,45 @@
+import { createClient } from '../api-client.js';
+import { formatOutput, printError, printSuccess } from '../output.js';
+export async function taskEditContentCommand(taskId, options) {
+    if (!options.title && !options.description && !options.agentInstructions) {
+        const msg = 'At least one of --title, --description, or --agent-instructions must be provided.';
+        if (options.json) {
+            console.error(JSON.stringify({ error: { message: msg } }));
+        }
+        else {
+            console.error(`Error: ${msg}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    try {
+        const client = await createClient(options.project);
+        const body = {};
+        if (options.title)
+            body.title = options.title;
+        if (options.description)
+            body.description = options.description;
+        if (options.agentInstructions)
+            body.agent_instructions = options.agentInstructions;
+        const response = (await client.editTaskContent(taskId, body));
+        if (options.json) {
+            console.log(formatOutput(response, true));
+            return;
+        }
+        const fields = response.data.updated_fields?.join(', ') ?? Object.keys(body).join(', ');
+        printSuccess(`Task content updated (${fields}).`, false);
+        const task = response.data.task;
+        if (task) {
+            console.log(`\nTitle: ${task.title}`);
+            if (task.description)
+                console.log(`Description: ${task.description}`);
+            if (task.agent_instructions)
+                console.log(`Agent Instructions: ${task.agent_instructions}`);
+        }
+    }
+    catch (error) {
+        printError(error, options.json);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=task-edit-content.js.map

package/dist/commands/task-edit-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-edit-content.js","sourceRoot":"","sources":["../../src/commands/task-edit-content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAetE,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAc,EACd,OAMC;IAED,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;QACzE,MAAM,GAAG,GAAG,mFAAmF,CAAC;QAChG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAEnD,MAAM,IAAI,GAA0E,EAAE,CAAC;QACvF,IAAI,OAAO,CAAC,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC9C,IAAI,OAAO,CAAC,WAAW;YAAE,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QAChE,IAAI,OAAO,CAAC,iBAAiB;YAAE,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;QAEnF,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAwB,CAAC;QAErF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxF,YAAY,CAAC,yBAAyB,MAAM,IAAI,EAAE,KAAK,CAAC,CAAC;QAEzD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAChC,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACtC,IAAI,IAAI,CAAC,WAAW;gBAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YACtE,IAAI,IAAI,CAAC,kBAAkB;gBAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/commands/task.d.ts

@@ -0,0 +1,66 @@
+interface DocEntry {
+    id: string;
+    title: string;
+    slug: string;
+    type: string;
+    _shared: boolean;
+    _workspace?: boolean;
+    context?: string | null;
+    sections_count?: number;
+}
+interface TaskDetailResponse {
+    data: {
+        task: {
+            id: string;
+            project_id: string;
+            parent_task_id: string | null;
+            agent_id: string | null;
+            title: string;
+            description: string | null;
+            status: string;
+            priority: string;
+            delivery_status: string | null;
+            agent_instructions: string | null;
+            branch_name: string | null;
+            sort_order: number;
+            estimated_effort: string | null;
+            created_at: string;
+            updated_at: string;
+            task_number: string;
+            display_number: string;
+        };
+        logs: Array<{
+            id: string;
+            type: string;
+            content: string;
+            metadata: Record<string, unknown>;
+            created_at: string;
+        }>;
+        subtasks: Array<{
+            id: string;
+            title: string;
+            status: string;
+            priority: string;
+            sort_order: number;
+        }>;
+        project: {
+            name: string;
+            git_url: string | null;
+            default_branch: string;
+            agent_instructions_template: string | null;
+            workspace?: {
+                id: string;
+                name: string;
+                slug: string;
+            } | null;
+        };
+        available_docs: DocEntry[];
+        workspace_knowledge?: DocEntry[];
+    };
+}
+export declare function printTaskDetail(response: TaskDetailResponse): void;
+export declare function taskCommand(idOrNumber: string, options: {
+    json: boolean;
+    project?: string;
+}): Promise<void>;
+export {};

package/dist/commands/task.js

@@ -0,0 +1,92 @@
+import { createClient } from '../api-client.js';
+import { formatOutput, printError, formatTable } from '../output.js';
+function isObjectNumber(id) {
+    return /^([A-Z]{2}-)?[a-z0-9]{6}$/.test(id);
+}
+function stripPrefix(id) {
+    return id.replace(/^[A-Z]{2}-/, '');
+}
+function formatDocLine(d) {
+    let line = `${d.title} (${d.type}`;
+    if (d.sections_count !== undefined)
+        line += `, ${d.sections_count} sections`;
+    line += ')';
+    if (d.context)
+        line += ` — ${d.context}`;
+    return line;
+}
+export function printTaskDetail(response) {
+    const { task, logs, subtasks, project, available_docs, workspace_knowledge } = response.data;
+    const displayNum = task.display_number ?? task.task_number;
+    console.log(`Task: ${task.title} [${displayNum}]`);
+    console.log(`Status: ${task.status}  Priority: ${task.priority}`);
+    if (task.delivery_status)
+        console.log(`Delivery: ${task.delivery_status}`);
+    if (task.branch_name)
+        console.log(`Branch: ${task.branch_name}`);
+    if (task.estimated_effort)
+        console.log(`Effort: ${task.estimated_effort}`);
+    // Show project with optional workspace info
+    if (project.workspace) {
+        console.log(`Project: ${project.name} (workspace: ${project.workspace.name})`);
+    }
+    else {
+        console.log(`Project: ${project.name}`);
+    }
+    if (task.description) {
+        console.log(`\nDescription:\n${task.description}`);
+    }
+    if (task.agent_instructions) {
+        console.log(`\nAgent Instructions:\n${task.agent_instructions}`);
+    }
+    if (subtasks.length > 0) {
+        console.log(`\nSubtasks (${subtasks.length}):`);
+        console.log(formatTable(['#', 'Title', 'Status', 'Priority'], subtasks.map((s, i) => [
+            String(i + 1),
+            s.title,
+            s.status,
+            s.priority,
+        ])));
+    }
+    if (logs.length > 0) {
+        console.log(`\nLogs (${logs.length}):`);
+        for (const log of logs) {
+            const ts = log.created_at.replace('T', ' ').replace(/\+.*$/, '');
+            console.log(`  [${log.type}] ${ts} — ${log.content}`);
+        }
+    }
+    if (available_docs.length > 0) {
+        console.log(`\nProject Knowledge (${available_docs.length}):`);
+        for (const d of available_docs) {
+            console.log(`  - ${formatDocLine(d)}`);
+        }
+    }
+    if (workspace_knowledge && workspace_knowledge.length > 0) {
+        console.log(`\nWorkspace Knowledge (${workspace_knowledge.length}):`);
+        for (const d of workspace_knowledge) {
+            console.log(`  - ${formatDocLine(d)}`);
+        }
+    }
+}
+export async function taskCommand(idOrNumber, options) {
+    try {
+        const client = await createClient(options.project);
+        let response;
+        if (isObjectNumber(idOrNumber)) {
+            response = (await client.getTaskByNumber(stripPrefix(idOrNumber)));
+        }
+        else {
+            response = (await client.getTask(idOrNumber));
+        }
+        if (options.json) {
+            console.log(formatOutput(response, true));
+            return;
+        }
+        printTaskDetail(response);
+    }
+    catch (error) {
+        printError(error, options.json);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=task.js.map

package/dist/commands/task.js.map

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

package/dist/commands/tasks.d.ts

@@ -0,0 +1,7 @@
+export declare function tasksCommand(options: {
+    json: boolean;
+    project?: string;
+    status?: string;
+    priority?: string;
+    orbit?: string;
+}): Promise<void>;

package/dist/commands/tasks.js

@@ -0,0 +1,35 @@
+import { createClient } from '../api-client.js';
+import { formatOutput, printError, formatTable } from '../output.js';
+export async function tasksCommand(options) {
+    try {
+        const client = await createClient(options.project);
+        const response = (await client.getTasks({
+            status: options.status,
+            priority: options.priority,
+            orbit: options.orbit,
+        }));
+        if (options.json) {
+            console.log(formatOutput(response, true));
+            return;
+        }
+        const tasks = response.data;
+        if (tasks.length === 0) {
+            console.log('No tasks found.');
+            return;
+        }
+        console.log(`Tasks (${response.meta.count}):\n`);
+        const hasDelivery = tasks.some((t) => t.delivery_status);
+        const headers = hasDelivery
+            ? ['#', 'Title', 'Status', 'Delivery', 'Priority', 'Effort']
+            : ['#', 'Title', 'Status', 'Priority', 'Effort'];
+        const rows = tasks.map((t) => hasDelivery
+            ? [t.display_number ?? t.task_number, t.title, t.status, t.delivery_status ?? '', t.priority, t.estimated_effort ?? '']
+            : [t.display_number ?? t.task_number, t.title, t.status, t.priority, t.estimated_effort ?? '']);
+        console.log(formatTable(headers, rows));
+    }
+    catch (error) {
+        printError(error, options.json);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=tasks.js.map

package/dist/commands/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/commands/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAsBrE,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAMlC;IACC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC;YACtC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAkB,CAAC;QAErB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC;QAE5B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;YAC/B,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,UAAU,QAAQ,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC;QACjD,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,WAAW;YACzB,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC;YAC5D,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3B,WAAW;YACT,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,eAAe,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,gBAAgB,IAAI,EAAE,CAAC;YACvH,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,gBAAgB,IAAI,EAAE,CAAC,CACjG,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/commands/vibes.d.ts

@@ -0,0 +1,27 @@
+export declare function vibeLogCommand(options: {
+    json: boolean;
+    project?: string;
+    content: string;
+    type: string;
+    title?: string;
+    task?: string;
+}): Promise<void>;
+export declare function vibeListCommand(options: {
+    json: boolean;
+    project?: string;
+    type?: string;
+    since?: string;
+    limit?: string;
+}): Promise<void>;
+export declare function vibeShowCommand(id: string, options: {
+    json: boolean;
+    project?: string;
+}): Promise<void>;
+export declare function vibeUpdateCommand(id: string, options: {
+    json: boolean;
+    project?: string;
+    type?: string;
+    title?: string;
+    content?: string;
+    metadata?: string;
+}): Promise<void>;

package/dist/commands/vibes.js

@@ -0,0 +1,142 @@
+import { createClient } from '../api-client.js';
+import { formatOutput, printError, printSuccess, formatTable } from '../output.js';
+const VALID_VIBE_TYPES = ['note', 'code_change', 'decision', 'discovery', 'idea', 'exploration', 'fix'];
+// ── Commands ──
+export async function vibeLogCommand(options) {
+    if (!VALID_VIBE_TYPES.includes(options.type)) {
+        const msg = `Invalid vibe type "${options.type}". Valid: ${VALID_VIBE_TYPES.join(', ')}`;
+        if (options.json) {
+            console.error(JSON.stringify({ error: { message: msg } }));
+        }
+        else {
+            console.error(`Error: ${msg}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    try {
+        const client = await createClient(options.project);
+        const response = (await client.logVibe({
+            content: options.content,
+            type: options.type,
+            title: options.title,
+            task_id: options.task,
+        }));
+        if (options.json) {
+            console.log(formatOutput(response, true));
+            return;
+        }
+        printSuccess(`Logged vibe (${response.data.type}) with ID ${response.data.id}.`, false);
+    }
+    catch (error) {
+        printError(error, options.json);
+        process.exitCode = 1;
+    }
+}
+export async function vibeListCommand(options) {
+    try {
+        const client = await createClient(options.project);
+        const response = (await client.listVibes({
+            type: options.type,
+            since: options.since,
+            limit: options.limit,
+        }));
+        if (options.json) {
+            console.log(formatOutput(response, true));
+            return;
+        }
+        const vibes = response.data;
+        if (vibes.length === 0) {
+            console.log('No vibes found.');
+            return;
+        }
+        console.log(`Vibes (${response.meta.count}):\n`);
+        console.log(formatTable(['Type', 'Title / Content', 'Author', 'Created'], vibes.map((v) => [
+            v.type,
+            v.title ?? v.content.slice(0, 60) + (v.content.length > 60 ? '...' : ''),
+            v.author ? (typeof v.author === 'object' ? v.author.name : v.author) : '',
+            v.created_at.replace('T', ' ').replace(/\+.*$/, ''),
+        ])));
+    }
+    catch (error) {
+        printError(error, options.json);
+        process.exitCode = 1;
+    }
+}
+export async function vibeShowCommand(id, options) {
+    try {
+        const client = await createClient(options.project);
+        const response = (await client.getVibe(id));
+        if (options.json) {
+            console.log(formatOutput(response, true));
+            return;
+        }
+        const vibe = response.data;
+        console.log(`Vibe: ${vibe.title ?? '(untitled)'} [${vibe.type}]`);
+        if (vibe.author) {
+            const authorName = typeof vibe.author === 'object' ? vibe.author.name : vibe.author;
+            console.log(`Author: ${authorName}`);
+        }
+        if (vibe.task_id)
+            console.log(`Task: ${vibe.task_id}`);
+        console.log(`\nContent:\n${vibe.content}`);
+        if (vibe.metadata && Object.keys(vibe.metadata).length > 0) {
+            console.log(`\nMetadata:\n${JSON.stringify(vibe.metadata, null, 2)}`);
+        }
+        console.log(`\nCreated: ${vibe.created_at.replace('T', ' ').replace(/\+.*$/, '')}`);
+        console.log(`Updated: ${vibe.updated_at.replace('T', ' ').replace(/\+.*$/, '')}`);
+    }
+    catch (error) {
+        printError(error, options.json);
+        process.exitCode = 1;
+    }
+}
+export async function vibeUpdateCommand(id, options) {
+    let metadata;
+    if (options.metadata) {
+        try {
+            metadata = JSON.parse(options.metadata);
+        }
+        catch {
+            const msg = 'Invalid JSON in --metadata option';
+            if (options.json) {
+                console.error(JSON.stringify({ error: { message: msg } }));
+            }
+            else {
+                console.error(`Error: ${msg}`);
+            }
+            process.exitCode = 1;
+            return;
+        }
+    }
+    if (options.type && !VALID_VIBE_TYPES.includes(options.type)) {
+        const msg = `Invalid vibe type "${options.type}". Valid: ${VALID_VIBE_TYPES.join(', ')}`;
+        if (options.json) {
+            console.error(JSON.stringify({ error: { message: msg } }));
+        }
+        else {
+            console.error(`Error: ${msg}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    try {
+        const client = await createClient(options.project);
+        const response = (await client.updateVibe(id, {
+            type: options.type,
+            title: options.title,
+            content: options.content,
+            metadata,
+        }));
+        if (options.json) {
+            console.log(formatOutput(response, true));
+            return;
+        }
+        printSuccess(`Vibe ${response.data.id} updated.`, false);
+    }
+    catch (error) {
+        printError(error, options.json);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=vibes.js.map

package/dist/commands/vibes.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,14 @@
+export interface OrbitMapConfig {
+    api_url?: string;
+    api_key?: string;
+    project_id?: string;
+}
+export declare function loadConfig(): Promise<OrbitMapConfig>;
+export declare function saveConfig(config: OrbitMapConfig): Promise<void>;
+export interface ResolvedAuth {
+    apiKey: string;
+    apiUrl: string;
+    projectId?: string;
+}
+export declare function resolveAuth(): Promise<ResolvedAuth>;
+export declare function resolveProjectId(explicit?: string, envOrConfig?: string): string | undefined;

package/dist/config.js

@@ -0,0 +1,34 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const CONFIG_DIR = join(homedir(), '.orbitmap');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+export async function loadConfig() {
+    try {
+        const raw = await readFile(CONFIG_FILE, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+export async function saveConfig(config) {
+    await mkdir(CONFIG_DIR, { recursive: true });
+    await writeFile(CONFIG_FILE, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+export async function resolveAuth() {
+    const config = await loadConfig();
+    const apiKey = process.env['ORBITMAP_API_KEY'] || config.api_key;
+    const apiUrl = process.env['ORBITMAP_API_URL'] ||
+        config.api_url ||
+        'https://orbitmap-main-x5n6qz.laravel.cloud/api/agent';
+    if (!apiKey) {
+        throw new Error('Missing API key. Set ORBITMAP_API_KEY env var or run `orbitmap init`.');
+    }
+    const projectId = process.env['ORBITMAP_PROJECT_ID'] || config.project_id;
+    return { apiKey, apiUrl, projectId };
+}
+export function resolveProjectId(explicit, envOrConfig) {
+    return explicit || process.env['ORBITMAP_PROJECT_ID'] || envOrConfig;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;AAChD,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAsB;IACrD,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AAChF,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAElC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC;IACjE,MAAM,MAAM,GACV,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAC/B,MAAM,CAAC,OAAO;QACd,sDAAsD,CAAC;IAEzD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,uEAAuE,CACxE,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC;IAE1E,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,QAAiB,EACjB,WAAoB;IAEpB,OAAO,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,WAAW,CAAC;AACvE,CAAC"}

package/dist/doc-cache.d.ts

@@ -0,0 +1,24 @@
+import type { OrbitMapClient } from './api-client.js';
+export interface ManifestEntry {
+    doc_id: string;
+    version: number;
+    downloaded_at: string;
+    last_accessed: string;
+    size_bytes: number;
+    file: string;
+}
+export type Manifest = Record<string, ManifestEntry>;
+export interface DownloadResult {
+    filePath: string;
+    version: number;
+    cached: boolean;
+    slug: string;
+}
+export declare function getCacheDir(): string;
+export declare function readManifest(): Manifest;
+export declare function writeManifest(manifest: Manifest): void;
+export declare function ensureGitignore(): void;
+export declare function downloadDocument(client: OrbitMapClient, idOrSlug: string): Promise<DownloadResult>;
+export declare function cleanupCache(availableDocSlugs: string[]): {
+    removed: string[];
+};

package/dist/doc-cache.js

@@ -0,0 +1,116 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync, statSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+const CACHE_DIR = join('.orbitmap', 'docs');
+const MANIFEST_FILE = '.manifest.json';
+const STALE_DAYS = 7;
+export function getCacheDir() {
+    return CACHE_DIR;
+}
+export function readManifest() {
+    const manifestPath = join(CACHE_DIR, MANIFEST_FILE);
+    if (!existsSync(manifestPath))
+        return {};
+    try {
+        return JSON.parse(readFileSync(manifestPath, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+export function writeManifest(manifest) {
+    const manifestPath = join(CACHE_DIR, MANIFEST_FILE);
+    mkdirSync(dirname(manifestPath), { recursive: true });
+    writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), 'utf-8');
+}
+export function ensureGitignore() {
+    const gitignorePath = '.gitignore';
+    const entry = '.orbitmap/';
+    if (existsSync(gitignorePath)) {
+        const content = readFileSync(gitignorePath, 'utf-8');
+        if (content.includes(entry))
+            return;
+        const separator = content.endsWith('\n') ? '' : '\n';
+        writeFileSync(gitignorePath, `${content}${separator}${entry}\n`, 'utf-8');
+    }
+    else {
+        writeFileSync(gitignorePath, `${entry}\n`, 'utf-8');
+    }
+}
+export async function downloadDocument(client, idOrSlug) {
+    const response = (await client.getDocument(idOrSlug, 'file'));
+    const doc = response.data;
+    const slug = doc.slug;
+    const manifest = readManifest();
+    const existing = manifest[slug];
+    // Version match — skip download
+    if (existing && existing.version === doc.version) {
+        const filePath = join(CACHE_DIR, existing.file);
+        if (existsSync(filePath)) {
+            existing.last_accessed = new Date().toISOString();
+            writeManifest(manifest);
+            return { filePath, version: doc.version, cached: true, slug };
+        }
+    }
+    // Need to download
+    mkdirSync(CACHE_DIR, { recursive: true });
+    ensureGitignore();
+    const fileName = `${slug}.md`;
+    const filePath = join(CACHE_DIR, fileName);
+    if (doc.download_url) {
+        const res = await fetch(doc.download_url);
+        if (!res.ok) {
+            throw new Error(`Download failed: HTTP ${res.status}`);
+        }
+        const content = await res.text();
+        writeFileSync(filePath, content, 'utf-8');
+    }
+    else if (doc.content !== undefined) {
+        // Fallback to inline content
+        writeFileSync(filePath, doc.content, 'utf-8');
+    }
+    else {
+        throw new Error(`API returned neither download_url nor content for ${idOrSlug}`);
+    }
+    const size = statSync(filePath).size;
+    const now = new Date().toISOString();
+    manifest[slug] = {
+        doc_id: doc.id,
+        version: doc.version,
+        downloaded_at: now,
+        last_accessed: now,
+        size_bytes: size,
+        file: fileName,
+    };
+    writeManifest(manifest);
+    return { filePath, version: doc.version, cached: false, slug };
+}
+export function cleanupCache(availableDocSlugs) {
+    const manifest = readManifest();
+    const slugSet = new Set(availableDocSlugs);
+    const now = Date.now();
+    const staleMs = STALE_DAYS * 24 * 60 * 60 * 1000;
+    const removed = [];
+    for (const [slug, entry] of Object.entries(manifest)) {
+        if (slugSet.has(slug))
+            continue;
+        const lastAccessed = new Date(entry.last_accessed).getTime();
+        if (now - lastAccessed <= staleMs)
+            continue;
+        // Stale and not in available docs — remove
+        const filePath = join(CACHE_DIR, entry.file);
+        try {
+            if (existsSync(filePath))
+                unlinkSync(filePath);
+        }
+        catch {
+            // ignore file deletion errors
+        }
+        delete manifest[slug];
+        removed.push(slug);
+    }
+    if (removed.length > 0) {
+        writeManifest(manifest);
+    }
+    return { removed };
+}
+//# sourceMappingURL=doc-cache.js.map

package/dist/doc-cache.js.map

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