@skhema/cli 0.4.3 → 0.4.4

package/dist/commands/document.d.ts

@@ -0,0 +1,10 @@
+import { Command } from 'commander';
+/**
+ * Document commands — workspace-authored narrative artifacts (board updates,
+ * team briefs, decision briefs, custom docs). All are workspace-scoped via
+ * `--workspace` (falling back to the default set by `skhema workspace use`).
+ * The routes carry the workspace id in the path, so — unlike `workspace list`
+ * — no organizationId is forwarded; the gateway authorizes via workspace access.
+ */
+export declare function registerDocumentCommands(program: Command): void;
+//# sourceMappingURL=document.d.ts.map

package/dist/commands/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/commands/document.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAqBnC;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgK/D"}

package/dist/commands/document.js

@@ -0,0 +1,122 @@
+import chalk from 'chalk';
+import { resolveClient } from '../lib/api/client.js';
+import { asRecord, buildBody, coerceList, readPayloadFile, resolveWorkspaceId, } from '../lib/api/command-helpers.js';
+import { runCommand, UsageError } from '../lib/api/run-command.js';
+import { getGlobalOptions, log, logHeader, logTable } from '../lib/output.js';
+/** Print a single document as a label block (human output only). */
+function printDocument(document) {
+    const d = asRecord(document);
+    logHeader(String(d.title ?? d.id ?? 'Document'));
+    log(`  Id:       ${chalk.cyan(String(d.id ?? '—'))}`);
+    if (d.docType)
+        log(`  Type:     ${String(d.docType)}`);
+    if (d.updatedAt)
+        log(`  Updated:  ${String(d.updatedAt)}`);
+}
+/**
+ * Document commands — workspace-authored narrative artifacts (board updates,
+ * team briefs, decision briefs, custom docs). All are workspace-scoped via
+ * `--workspace` (falling back to the default set by `skhema workspace use`).
+ * The routes carry the workspace id in the path, so — unlike `workspace list`
+ * — no organizationId is forwarded; the gateway authorizes via workspace access.
+ */
+export function registerDocumentCommands(program) {
+    const document = program.command('document').description('Document commands');
+    const withWorkspace = (cmd) => cmd.option('--workspace <id>', 'Workspace id (defaults to `skhema workspace use`)');
+    withWorkspace(document.command('list').description('List documents')).action(async (options) => {
+        await runCommand('document list', async () => {
+            const workspaceId = resolveWorkspaceId(options.workspace);
+            const { client } = await resolveClient();
+            const data = await client.documents.list(workspaceId);
+            const rows = coerceList(data, 'documents');
+            if (!getGlobalOptions().json) {
+                logHeader(`Documents (${rows.length})`);
+                if (rows.length === 0)
+                    log(chalk.dim('  No documents.'));
+                else
+                    logTable(['Title', 'Type', 'Updated', 'Id'], rows.map((r) => {
+                        const d = asRecord(r);
+                        return [
+                            String(d.title ?? '—'),
+                            String(d.docType ?? '—'),
+                            String(d.updatedAt ?? '—'),
+                            String(d.id ?? '—'),
+                        ];
+                    }));
+            }
+            return data;
+        });
+    });
+    withWorkspace(document.command('get <document-id>').description('Get a document by id')).action(async (documentId, options) => {
+        await runCommand('document get', async () => {
+            const workspaceId = resolveWorkspaceId(options.workspace);
+            const { client } = await resolveClient();
+            const data = await client.documents.get(workspaceId, documentId);
+            if (!getGlobalOptions().json)
+                printDocument(asRecord(data).document ?? data);
+            return data;
+        });
+    });
+    withWorkspace(document
+        .command('create')
+        .description('Create a document')
+        .option('--title <title>', 'Document title')
+        .option('--doc-type <type>', 'Document type (board_update | team_brief | decision_brief | custom)')
+        .option('--content <content>', 'Document content')
+        .option('--file <path>', 'JSON payload file for the full body ("-" for stdin)')).action(async (options) => {
+        await runCommand('document create', async () => {
+            const workspaceId = resolveWorkspaceId(options.workspace);
+            const body = buildBody(readPayloadFile(options.file), {
+                title: options.title,
+                docType: options.docType,
+                content: options.content,
+            });
+            if (Object.keys(body).length === 0) {
+                throw new UsageError('Nothing to create. Pass document fields as flags or a --file payload.');
+            }
+            const { client } = await resolveClient();
+            const data = await client.documents.create(workspaceId, body);
+            if (!getGlobalOptions().json) {
+                log(chalk.green('Document created.'));
+                printDocument(asRecord(data).document ?? data);
+            }
+            return data;
+        });
+    });
+    withWorkspace(document
+        .command('update <document-id>')
+        .description('Update a document')
+        .option('--title <title>', 'Document title')
+        .option('--doc-type <type>', 'Document type (board_update | team_brief | decision_brief | custom)')
+        .option('--content <content>', 'Document content')
+        .option('--file <path>', 'JSON payload file for the full body ("-" for stdin)')).action(async (documentId, options) => {
+        await runCommand('document update', async () => {
+            const workspaceId = resolveWorkspaceId(options.workspace);
+            const body = buildBody(readPayloadFile(options.file), {
+                title: options.title,
+                docType: options.docType,
+                content: options.content,
+            });
+            if (Object.keys(body).length === 0) {
+                throw new UsageError('Nothing to update. Pass document fields as flags or a --file payload.');
+            }
+            const { client } = await resolveClient();
+            const data = await client.documents.update(workspaceId, documentId, body);
+            if (!getGlobalOptions().json) {
+                log(chalk.green('Document updated.'));
+                printDocument(asRecord(data).document ?? data);
+            }
+            return data;
+        });
+    });
+    withWorkspace(document.command('delete <document-id>').description('Delete a document')).action(async (documentId, options) => {
+        await runCommand('document delete', async () => {
+            const workspaceId = resolveWorkspaceId(options.workspace);
+            const { client } = await resolveClient();
+            const data = await client.documents.delete(workspaceId, documentId);
+            if (!getGlobalOptions().json)
+                log(chalk.green(`Deleted document ${documentId}.`));
+            return data;
+        });
+    });
+}

package/dist/lib/api/command-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/api/command-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAKzC;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAQxD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAsB1E;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,WAAW,CAMb;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIhE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAQlE"}
+{"version":3,"file":"command-helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/api/command-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAKzC;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAQxD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAuB1E;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,WAAW,CAMb;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIhE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAQlE"}

package/dist/lib/api/command-helpers.js

@@ -29,7 +29,8 @@ export function readPayloadFile(filePath) {
         throw new UsageError(`Could not read payload file "${filePath}": ${err instanceof Error ? err.message : String(err)}`);
     }
     try {
-        const parsed = JSON.parse(raw);
+        // Strip a leading UTF-8 BOM so a byte-identical-looking file parses.
+        const parsed = JSON.parse(raw.replace(/^\uFEFF/, ''));
         if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
             throw new Error('expected a JSON object');
         }

package/dist/lib/api/passthrough.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"passthrough.d.ts","sourceRoot":"","sources":["../../../src/lib/api/passthrough.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAW7C;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAQvD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAyBrE;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,EAAE,EAAE;IACF,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3C,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CACjC,GACA,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CA+B9C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EAAE,GAAG,SAAS,GACxB,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CASzB"}
+{"version":3,"file":"passthrough.d.ts","sourceRoot":"","sources":["../../../src/lib/api/passthrough.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAW7C;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAQvD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAyBrE;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,EAAE,EAAE;IACF,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3C,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CACjC,GACA,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CA2C9C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EAAE,GAAG,SAAS,GACxB,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CASzB"}

package/dist/lib/api/passthrough.js

@@ -79,10 +79,19 @@ export async function resolveDataBody(raw, io) {
     }
     let parsed;
     try {
-        parsed = JSON.parse(text);
+        // Strip a leading UTF-8 BOM (editors and some `echo`/redirect toolchains
+        // prepend one); JSON.parse chokes on it, which surfaced as the opaque
+        // "--data is not valid JSON" even for a well-formed @file. Mirrors curl.
+        parsed = JSON.parse(text.replace(/^\uFEFF/, ''));
     }
-    catch {
-        throw new UsageError('--data is not valid JSON.');
+    catch (err) {
+        // Name the source so a failed @file is not mistaken for the literal form.
+        const label = raw === '-'
+            ? 'from stdin'
+            : raw.startsWith('@')
+                ? `file "${raw.slice(1)}"`
+                : 'value';
+        throw new UsageError(`--data ${label} is not valid JSON: ${err instanceof Error ? err.message : String(err)}`);
     }
     if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
         throw new UsageError('--data must be a JSON object.');

package/dist/lib/api/payload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../src/lib/api/payload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAI9C,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAatD;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAczD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE;IACnC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,GAAG,WAAW,CAad"}
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../src/lib/api/payload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAI9C,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAatD;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAezD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE;IACnC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,GAAG,WAAW,CAad"}

package/dist/lib/api/payload.js

@@ -22,7 +22,8 @@ export function parseJsonFile(source) {
     const raw = readFileOrStdin(source);
     let parsed;
     try {
-        parsed = JSON.parse(raw);
+        // Strip a leading UTF-8 BOM so a byte-identical-looking file parses.
+        parsed = JSON.parse(raw.replace(/^\uFEFF/, ''));
     }
     catch {
         throw new UsageError(`Payload in ${source === '-' ? 'stdin' : source} is not valid JSON.`);

package/dist/program.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAmBnC;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CA+CrD"}
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAoBnC;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAgDrD"}

package/dist/program.js

@@ -4,6 +4,7 @@ import { registerApiCommands } from './commands/api.js';
 import { registerAuthCommands } from './commands/auth.js';
 import { registerComponentCommands } from './commands/component.js';
 import { registerContributeCommands } from './commands/contribute.js';
+import { registerDocumentCommands } from './commands/document.js';
 import { registerElementCommands } from './commands/element.js';
 import { registerWorkspaceExportCommand } from './commands/export.js';
 import { registerInitCommand } from './commands/init.js';
@@ -53,6 +54,7 @@ export function buildProgram(version) {
     registerWorkspaceExportCommand(program);
     registerComponentCommands(program);
     registerStrategyCommands(program);
+    registerDocumentCommands(program);
     registerResourceCommands(program);
     registerWebhookCommands(program);
     registerAgentCommands(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skhema/cli",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "Skhema CLI - Authentication and AI skills management for agent platforms",
   "type": "module",
   "main": "dist/index.js",
@@ -43,7 +43,7 @@
   "dependencies": {
     "@skhema/agent-sdk": "0.1.4",
     "@skhema/method": "0.3.0",
-    "@skhema/sdk": "0.2.1",
+    "@skhema/sdk": "0.2.2",
     "chalk": "^5.3.0",
     "commander": "^12.0.0",
     "ora": "^8.0.0"