orbitmap 0.1.0

package/dist/commands/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAsBtE,SAAS,cAAc,CAAC,EAAU;IAChC,OAAO,2BAA2B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,WAAW,CAAC,EAAU;IAC7B,OAAO,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAa,EACb,OAWC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAEnD,IAAI,aAAiC,CAAC;QACtC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,IAAI,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBACtC,MAAM,SAAS,GAAG,CAAC,MAAM,MAAM,CAAC,gBAAgB,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAwB,CAAC;gBACzG,aAAa,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC;YACpC,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC;YACxC,KAAK;YACL,WAAW,EAAE,OAAO,CAAC,IAAI;YACzB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,gBAAgB,EAAE,OAAO,CAAC,MAAM;YAChC,QAAQ,EAAE,OAAO,CAAC,OAAO;YACzB,WAAW,EAAE,OAAO,CAAC,MAAM;YAC3B,kBAAkB,EAAE,OAAO,CAAC,YAAY;YACxC,eAAe,EAAE,aAAa;SAC/B,CAAC,CAAmB,CAAC;QAEtB,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,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC;QACxB,IAAI,GAAG,GAAG,iBAAiB,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,WAAW,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC;QACzG,IAAI,aAAa,EAAE,CAAC;YAClB,GAAG,IAAI,qBAAqB,OAAO,CAAC,SAAS,sBAAsB,CAAC;QACtE,CAAC;QACD,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;YACxB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;gBAC5B,GAAG,IAAI,cAAc,CAAC,EAAE,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC3B,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/dep.d.ts

@@ -0,0 +1,11 @@
+export declare function depAddCommand(taskId: string, targetTaskId: string, options: {
+    json: boolean;
+    project?: string;
+    type?: string;
+    note?: string;
+}): Promise<void>;
+export declare function depRemoveCommand(taskId: string, targetTaskId: string, options: {
+    json: boolean;
+    project?: string;
+    type?: string;
+}): Promise<void>;

package/dist/commands/dep.js

@@ -0,0 +1,56 @@
+import { createClient } from '../api-client.js';
+import { formatOutput, printError, printSuccess } from '../output.js';
+const VALID_DEP_TYPES = ['depends_on', 'related'];
+// ── Commands ──
+export async function depAddCommand(taskId, targetTaskId, options) {
+    const depType = options.type ?? 'depends_on';
+    if (!VALID_DEP_TYPES.includes(depType)) {
+        const msg = `Invalid dependency type "${depType}". Valid: ${VALID_DEP_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.addTaskDependency(taskId, {
+            target_task_id: targetTaskId,
+            type: depType,
+            note: options.note,
+        }));
+        if (options.json) {
+            console.log(formatOutput(response, true));
+            return;
+        }
+        printSuccess(`Added ${response.data.type} dependency: ${response.data.task_id ?? taskId} → ${response.data.target_task_id ?? targetTaskId}.`, false);
+    }
+    catch (error) {
+        printError(error, options.json);
+        process.exitCode = 1;
+    }
+}
+export async function depRemoveCommand(taskId, targetTaskId, options) {
+    try {
+        const client = await createClient(options.project);
+        const response = await client.removeTaskDependency(taskId, targetTaskId, options.type);
+        if (options.json) {
+            console.log(formatOutput(response ?? { data: { removed: true } }, true));
+            return;
+        }
+        if (response?.data) {
+            printSuccess(`Removed dependency: ${response.data.task_id} → ${response.data.target_task_id}.`, false);
+        }
+        else {
+            printSuccess(`Removed dependency: ${taskId} → ${targetTaskId}.`, false);
+        }
+    }
+    catch (error) {
+        printError(error, options.json);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=dep.js.map

package/dist/commands/dep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dep.js","sourceRoot":"","sources":["../../src/commands/dep.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAuBtE,MAAM,eAAe,GAAG,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;AAElD,iBAAiB;AAEjB,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,EACd,YAAoB,EACpB,OAKC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,YAAY,CAAC;IAE7C,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,4BAA4B,OAAO,aAAa,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACzF,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;QACnD,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE;YACvD,cAAc,EAAE,YAAY;YAC5B,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC,CAAmB,CAAC;QAEtB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,YAAY,CACV,SAAS,QAAQ,CAAC,IAAI,CAAC,IAAI,gBAAgB,QAAQ,CAAC,IAAI,CAAC,OAAO,IAAI,MAAM,MAAM,QAAQ,CAAC,IAAI,CAAC,cAAc,IAAI,YAAY,GAAG,EAC/H,KAAK,CACN,CAAC;IACJ,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;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAc,EACd,YAAoB,EACpB,OAIC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAChD,MAAM,EACN,YAAY,EACZ,OAAO,CAAC,IAAI,CACoB,CAAC;QAEnC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;YACzE,OAAO;QACT,CAAC;QAED,IAAI,QAAQ,EAAE,IAAI,EAAE,CAAC;YACnB,YAAY,CACV,uBAAuB,QAAQ,CAAC,IAAI,CAAC,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,cAAc,GAAG,EACjF,KAAK,CACN,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,uBAAuB,MAAM,MAAM,YAAY,GAAG,EAAE,KAAK,CAAC,CAAC;QAC1E,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/doc-import.d.ts

@@ -0,0 +1,9 @@
+export declare function docImportCommand(title: string, options: {
+    json: boolean;
+    project?: string;
+    type: string;
+    file: string;
+    sourcePath?: string;
+    context?: string;
+    workspaceId?: string;
+}): Promise<void>;

package/dist/commands/doc-import.js

@@ -0,0 +1,97 @@
+import { readFileSync, statSync } from 'node:fs';
+import { createClient } from '../api-client.js';
+import { formatOutput, printError, printSuccess } from '../output.js';
+const VALID_DOC_TYPES = [
+    'spec',
+    'architecture',
+    'api',
+    'guide',
+    'decision',
+    'changelog',
+    'other',
+];
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+export async function docImportCommand(title, options) {
+    if (!VALID_DOC_TYPES.includes(options.type)) {
+        const msg = `Invalid document type "${options.type}". Valid: ${VALID_DOC_TYPES.join(', ')}`;
+        if (options.json) {
+            console.error(JSON.stringify({ error: { message: msg } }));
+        }
+        else {
+            console.error(`Error: ${msg}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    // Verify file is readable before doing anything
+    try {
+        statSync(options.file);
+    }
+    catch (err) {
+        const msg = `Cannot read file "${options.file}": ${err instanceof Error ? err.message : String(err)}`;
+        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);
+        // Try presigned URL upload first
+        const presignedResult = await client.presignedImport(options.file, {
+            title,
+            type: options.type,
+            source_path: options.sourcePath,
+            context: options.context,
+            workspace_id: options.workspaceId,
+        }, options.json
+            ? undefined
+            : (uploaded, total) => {
+                process.stderr.write(`\rUploading: ${formatBytes(uploaded)} / ${formatBytes(total)}`);
+            });
+        if (presignedResult) {
+            if (!options.json) {
+                process.stderr.write('\n');
+            }
+            if (options.json) {
+                console.log(formatOutput({ ...presignedResult, upload_method: 'presigned' }, true));
+                return;
+            }
+            printSuccess(`Document imported: "${title}" (slug: ${presignedResult.data.slug}) [presigned upload]`, false);
+            return;
+        }
+        // Fallback: read file into memory and send as JSON body
+        const content = readFileSync(options.file, 'utf-8');
+        const response = (await client.importDocument({
+            title,
+            type: options.type,
+            content,
+            source_path: options.sourcePath,
+            context: options.context,
+            workspace_id: options.workspaceId,
+        }));
+        if (options.json) {
+            console.log(formatOutput({ ...response, upload_method: 'direct' }, true));
+            return;
+        }
+        printSuccess(`Document imported: "${title}" (slug: ${response.data.slug})`, false);
+    }
+    catch (error) {
+        if (!options.json) {
+            // Clear progress line if present
+            process.stderr.write('\n');
+        }
+        printError(error, options.json);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=doc-import.js.map

package/dist/commands/doc-import.js.map

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

package/dist/commands/doc-patch.d.ts

@@ -0,0 +1,16 @@
+export declare function docPatchCommand(idOrSlug: string, options: {
+    json: boolean;
+    project?: string;
+    operations?: string;
+    baseVersion: string;
+    changelog?: string;
+    replaceSection?: string;
+    insertSection?: boolean;
+    deleteSection?: string;
+    append?: boolean;
+    after?: string;
+    content?: string;
+    replaceLines?: string;
+    insertAfterLine?: string;
+    deleteLines?: string;
+}): Promise<void>;

package/dist/commands/doc-patch.js

@@ -0,0 +1,142 @@
+import { createClient } from '../api-client.js';
+import { formatOutput, printError, printSuccess } from '../output.js';
+import { OrbitMapAPIError } from '../errors.js';
+const FRIENDLY_ERRORS = {
+    CONTENT_UNAVAILABLE: 'Storage unavailable — patch aborted to prevent data loss. Try again later.',
+    PATCH_RESULT_EMPTY: 'Patch would result in an empty document — aborted.',
+};
+const DEPRECATED_FLAGS = ['replaceLines', 'insertAfterLine', 'deleteLines'];
+export async function docPatchCommand(idOrSlug, options) {
+    // Check for deprecated line-based flags
+    for (const flag of DEPRECATED_FLAGS) {
+        if (options[flag] !== undefined) {
+            const kebab = flag.replace(/([A-Z])/g, '-$1').toLowerCase();
+            console.error(`Warning: --${kebab} is deprecated. Use section-based operations instead (--replace-section, --insert-section, --delete-section).`);
+        }
+    }
+    let operations;
+    if (options.operations) {
+        // Raw JSON operations mode
+        try {
+            operations = JSON.parse(options.operations);
+            if (!Array.isArray(operations)) {
+                throw new Error('Operations must be a JSON array');
+            }
+        }
+        catch (err) {
+            const msg = `Invalid --operations JSON: ${err instanceof Error ? err.message : String(err)}`;
+            if (options.json) {
+                console.error(JSON.stringify({ error: { message: msg } }));
+            }
+            else {
+                console.error(`Error: ${msg}`);
+            }
+            process.exitCode = 1;
+            return;
+        }
+    }
+    else if (options.replaceSection) {
+        if (!options.content) {
+            const msg = '--replace-section requires --content with the new section body';
+            if (options.json) {
+                console.error(JSON.stringify({ error: { message: msg } }));
+            }
+            else {
+                console.error(`Error: ${msg}`);
+            }
+            process.exitCode = 1;
+            return;
+        }
+        operations = [{ op: 'replace_section', heading: options.replaceSection, content: options.content }];
+    }
+    else if (options.insertSection) {
+        if (!options.content) {
+            const msg = '--insert-section requires --content with the section to insert';
+            if (options.json) {
+                console.error(JSON.stringify({ error: { message: msg } }));
+            }
+            else {
+                console.error(`Error: ${msg}`);
+            }
+            process.exitCode = 1;
+            return;
+        }
+        operations = [{ op: 'insert_section', after_heading: options.after, content: options.content }];
+    }
+    else if (options.deleteSection) {
+        operations = [{ op: 'delete_section', heading: options.deleteSection }];
+    }
+    else if (options.append) {
+        if (!options.content) {
+            const msg = '--append requires --content with the text to append';
+            if (options.json) {
+                console.error(JSON.stringify({ error: { message: msg } }));
+            }
+            else {
+                console.error(`Error: ${msg}`);
+            }
+            process.exitCode = 1;
+            return;
+        }
+        operations = [{ op: 'append', content: options.content }];
+    }
+    else {
+        const msg = 'Provide --operations JSON, or use --replace-section, --insert-section, --delete-section, or --append';
+        if (options.json) {
+            console.error(JSON.stringify({ error: { message: msg } }));
+        }
+        else {
+            console.error(`Error: ${msg}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    const baseVersion = parseInt(options.baseVersion, 10);
+    if (isNaN(baseVersion) || baseVersion < 1) {
+        const msg = '--base-version must be a positive integer';
+        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.patchDocument(idOrSlug, operations, baseVersion, options.changelog));
+        if (options.json) {
+            console.log(formatOutput(response, true));
+            return;
+        }
+        const d = response.data;
+        let msg = `Document "${idOrSlug}" patched to version ${d.version}.`;
+        if (d.lines_before !== undefined && d.lines_after !== undefined) {
+            msg += ` ${d.lines_before} → ${d.lines_after} lines.`;
+        }
+        printSuccess(msg, false);
+        if (d.warnings && d.warnings.length > 0) {
+            for (const warning of d.warnings) {
+                console.log(`  Warning: ${warning}`);
+            }
+        }
+    }
+    catch (error) {
+        if (error instanceof OrbitMapAPIError && FRIENDLY_ERRORS[error.code]) {
+            if (options.json) {
+                console.error(JSON.stringify({
+                    error: { code: error.code, message: FRIENDLY_ERRORS[error.code], status: error.status },
+                }, null, 2));
+            }
+            else {
+                console.error(`Error: ${FRIENDLY_ERRORS[error.code]}`);
+            }
+            process.exitCode = 1;
+            return;
+        }
+        printError(error, options.json);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=doc-patch.js.map

package/dist/commands/doc-patch.js.map

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

package/dist/commands/doc-share.d.ts

@@ -0,0 +1,14 @@
+export declare function docShareCommand(documentId: string, projectId: string, options: {
+    json: boolean;
+    project?: string;
+    agents?: string;
+}): Promise<void>;
+export declare function docUnshareCommand(documentId: string, projectId: string, options: {
+    json: boolean;
+    project?: string;
+}): Promise<void>;
+export declare function docVisibilityCommand(documentId: string, projectId: string, options: {
+    json: boolean;
+    project?: string;
+    agents?: string;
+}): Promise<void>;

package/dist/commands/doc-share.js

@@ -0,0 +1,60 @@
+import { createClient } from '../api-client.js';
+import { formatOutput, printError, printSuccess } from '../output.js';
+export async function docShareCommand(documentId, projectId, options) {
+    const agentIds = options.agents
+        ? options.agents.split(',').map((s) => s.trim())
+        : undefined;
+    try {
+        const client = await createClient(options.project);
+        const response = (await client.shareDocument(documentId, projectId, agentIds));
+        if (options.json) {
+            console.log(formatOutput(response, true));
+            return;
+        }
+        const restriction = response.data.restricted_to_agents.length > 0
+            ? ` (restricted to ${response.data.restricted_to_agents.length} agent(s))`
+            : '';
+        printSuccess(`Document ${documentId} shared with project ${projectId}${restriction}.`, false);
+    }
+    catch (error) {
+        printError(error, options.json);
+        process.exitCode = 1;
+    }
+}
+export async function docUnshareCommand(documentId, projectId, options) {
+    try {
+        const client = await createClient(options.project);
+        const response = (await client.unshareDocument(documentId, projectId));
+        if (options.json) {
+            console.log(formatOutput(response, true));
+            return;
+        }
+        printSuccess(`Document ${documentId} unshared from project ${projectId}.`, false);
+    }
+    catch (error) {
+        printError(error, options.json);
+        process.exitCode = 1;
+    }
+}
+export async function docVisibilityCommand(documentId, projectId, options) {
+    const agentIds = options.agents
+        ? options.agents.split(',').map((s) => s.trim())
+        : [];
+    try {
+        const client = await createClient(options.project);
+        const response = (await client.setDocumentVisibility(documentId, projectId, agentIds));
+        if (options.json) {
+            console.log(formatOutput(response, true));
+            return;
+        }
+        const restriction = response.data.restricted_to_agents.length > 0
+            ? `Restricted to ${response.data.restricted_to_agents.length} agent(s).`
+            : 'All agents can access.';
+        printSuccess(`Visibility updated for document ${documentId} in project ${projectId}. ${restriction}`, false);
+    }
+    catch (error) {
+        printError(error, options.json);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=doc-share.js.map

package/dist/commands/doc-share.js.map

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

package/dist/commands/doc-update.d.ts

@@ -0,0 +1,6 @@
+export declare function docUpdateCommand(idOrSlug: string, options: {
+    json: boolean;
+    project?: string;
+    file: string;
+    changelog?: string;
+}): Promise<void>;

package/dist/commands/doc-update.js

@@ -0,0 +1,64 @@
+import { readFileSync, statSync } from 'node:fs';
+import { createClient } from '../api-client.js';
+import { formatOutput, printError, printSuccess } from '../output.js';
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+export async function docUpdateCommand(idOrSlug, options) {
+    // Verify file is readable before doing anything
+    try {
+        statSync(options.file);
+    }
+    catch (err) {
+        const msg = `Cannot read file "${options.file}": ${err instanceof Error ? err.message : String(err)}`;
+        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);
+        // Try presigned URL upload first
+        const presignedResult = await client.presignedUpdate(idOrSlug, options.file, options.changelog, options.json
+            ? undefined
+            : (uploaded, total) => {
+                process.stderr.write(`\rUploading: ${formatBytes(uploaded)} / ${formatBytes(total)}`);
+            });
+        if (presignedResult) {
+            if (!options.json) {
+                process.stderr.write('\n');
+            }
+            if (options.json) {
+                console.log(formatOutput({ ...presignedResult, upload_method: 'presigned' }, true));
+                return;
+            }
+            printSuccess(`Document "${idOrSlug}" updated to version ${presignedResult.data.version}. [presigned upload]`, false);
+            return;
+        }
+        // Fallback: read file into memory and send as JSON body
+        const content = readFileSync(options.file, 'utf-8');
+        const response = (await client.updateDocument(idOrSlug, content, options.changelog));
+        if (options.json) {
+            console.log(formatOutput({ ...response, upload_method: 'direct' }, true));
+            return;
+        }
+        printSuccess(`Document "${idOrSlug}" updated to version ${response.data.version}.`, false);
+    }
+    catch (error) {
+        if (!options.json) {
+            // Clear progress line if present
+            process.stderr.write('\n');
+        }
+        printError(error, options.json);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=doc-update.js.map

package/dist/commands/doc-update.js.map

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

package/dist/commands/doc.d.ts

@@ -0,0 +1,6 @@
+export declare function docCommand(idOrSlug: string, options: {
+    json: boolean;
+    project?: string;
+    full?: boolean;
+    section?: string;
+}): Promise<void>;

package/dist/commands/doc.js

@@ -0,0 +1,108 @@
+import { readFileSync } from 'node:fs';
+import { createClient } from '../api-client.js';
+import { formatOutput, printError } from '../output.js';
+import { downloadDocument, readManifest, writeManifest } from '../doc-cache.js';
+export async function docCommand(idOrSlug, options) {
+    try {
+        const client = await createClient(options.project);
+        // Determine fetch mode based on flags
+        const wantsFull = options.full === true;
+        const wantsSection = options.section !== undefined;
+        if (wantsFull && wantsSection) {
+            const msg = 'Cannot use --full and --section together. Use one or the other.';
+            if (options.json) {
+                console.error(JSON.stringify({ error: { message: msg } }));
+            }
+            else {
+                console.error(`Error: ${msg}`);
+            }
+            process.exitCode = 1;
+            return;
+        }
+        if (wantsFull) {
+            // Full content mode — same as legacy behavior
+            const response = (await client.getDocument(idOrSlug, 'file', { full: true }));
+            const doc = response.data;
+            let content;
+            let fromCache = false;
+            if (doc.download_url) {
+                const result = await downloadDocument(client, idOrSlug);
+                content = readFileSync(result.filePath, 'utf-8');
+                fromCache = result.cached;
+            }
+            else if (doc.content !== undefined) {
+                content = doc.content;
+            }
+            else {
+                throw new Error(`API returned neither download_url nor content for ${idOrSlug}`);
+            }
+            // Update last_accessed in manifest
+            const manifest = readManifest();
+            if (manifest[doc.slug]) {
+                manifest[doc.slug].last_accessed = new Date().toISOString();
+                writeManifest(manifest);
+            }
+            if (options.json) {
+                console.log(formatOutput({ data: { ...doc, content } }, true));
+                return;
+            }
+            console.log(`Title: ${doc.title}`);
+            console.log(`Type: ${doc.type}  Version: ${doc.version}  Slug: ${doc.slug}`);
+            if (doc.context)
+                console.log(`Context: ${doc.context}`);
+            if (doc.source_path)
+                console.log(`Source: ${doc.source_path}`);
+            if (doc._shared)
+                console.log(`Shared: yes`);
+            if (fromCache)
+                console.log(`Cache: hit`);
+            console.log(`Updated: ${doc.updated_at}`);
+            console.log(`\n${content}`);
+        }
+        else if (wantsSection) {
+            // Section mode — fetch specific section content
+            const response = (await client.getDocument(idOrSlug, undefined, { section: options.section }));
+            const doc = response.data;
+            if (options.json) {
+                console.log(formatOutput(response, true));
+                return;
+            }
+            console.log(`Title: ${doc.title}`);
+            console.log(`Type: ${doc.type}  Version: ${doc.version}  Slug: ${doc.slug}`);
+            console.log(`Section: ${options.section}`);
+            if (doc.content !== undefined) {
+                console.log(`\n${doc.content}`);
+            }
+        }
+        else {
+            // Default mode — TOC view (context + table of contents)
+            const response = (await client.getDocument(idOrSlug));
+            const doc = response.data;
+            if (options.json) {
+                console.log(formatOutput(response, true));
+                return;
+            }
+            console.log(`${doc.title} (${doc.slug}) v${doc.version}`);
+            if (doc.context)
+                console.log(`Context: ${doc.context}`);
+            if (doc._shared)
+                console.log(`Shared: yes`);
+            if (doc.toc && doc.toc.length > 0) {
+                console.log(`\nTable of Contents:`);
+                for (const entry of doc.toc) {
+                    const indent = '  '.repeat(entry.level - 1);
+                    console.log(`  ${indent}${entry.heading}`);
+                }
+            }
+            else if (doc.sections_count !== undefined) {
+                console.log(`\nSections: ${doc.sections_count}`);
+            }
+            console.log(`\nUse --full to see full content, or --section "## Heading" for a specific section.`);
+        }
+    }
+    catch (error) {
+        printError(error, options.json);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=doc.js.map