@inf-monkeys-tech/monkeys-cli 0.11.0 → 0.11.2

package/dist/discovery/client.js

@@ -0,0 +1,117 @@
+import { resolveAuthSurface } from '../credential/runtime.js';
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+import { unwrapServerData } from '../semantic/runtime.js';
+import { collectPages } from './pagination.js';
+function objectValue(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+function itemArray(value) {
+    if (Array.isArray(value))
+        return value.filter((item) => Boolean(item) && typeof item === 'object' && !Array.isArray(item));
+    const object = objectValue(value);
+    for (const key of ['items', 'list', 'data']) {
+        if (Array.isArray(object[key]))
+            return itemArray(object[key]);
+    }
+    return [];
+}
+function numeric(value, fallback) {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) && parsed >= 0 ? parsed : fallback;
+}
+function listPage(value, fallbackPage, fallbackPageSize) {
+    const unwrapped = unwrapServerData(value);
+    const envelope = objectValue(value);
+    const object = Object.keys(objectValue(unwrapped)).length > 0 && !Array.isArray(unwrapped) ? objectValue(unwrapped) : envelope;
+    const items = itemArray(unwrapped);
+    return {
+        items,
+        page: numeric(envelope.page ?? object.page, fallbackPage),
+        pageSize: numeric(envelope.pageSize ?? envelope.limit ?? object.pageSize ?? object.limit, fallbackPageSize),
+        total: numeric(envelope.total ?? envelope.totalCount ?? object.total ?? object.totalCount, items.length),
+    };
+}
+function requireItem(value, kind, id) {
+    const item = unwrapServerData(value);
+    if (!item || typeof item !== 'object' || Array.isArray(item)) {
+        throw new CliError(`${kind} was not found.`, {
+            code: `${kind.toUpperCase()}_NOT_FOUND`,
+            exitCode: EXIT_CODES.api,
+            safeDetails: { id },
+        });
+    }
+    return item;
+}
+export async function listTeams(runtime, options) {
+    const surface = resolveAuthSurface(runtime.context);
+    if (surface === 'studio') {
+        const response = await runtime.client.request({ method: 'GET', path: '/api/teams' });
+        const allItems = itemArray(unwrapServerData(response.data));
+        const keyword = options.keyword?.trim().toLowerCase();
+        const items = keyword ? allItems.filter((item) => JSON.stringify(item).toLowerCase().includes(keyword)) : allItems;
+        return { items, page: 1, pageSize: items.length, surface, total: items.length };
+    }
+    const page = await collectPages(options, async (pageNumber) => {
+        const response = await runtime.client.request({
+            method: 'GET',
+            path: '/api/kernel/teams',
+            query: {
+                includeBuiltin: options.includeBuiltin,
+                ...(options.keyword ? { keyword: options.keyword } : {}),
+                page: pageNumber,
+                pageSize: options.pageSize,
+            },
+        });
+        return listPage(response.data, pageNumber, options.pageSize);
+    });
+    return { ...page, surface };
+}
+export async function getTeam(runtime, id) {
+    const surface = resolveAuthSurface(runtime.context);
+    if (surface === 'kernel') {
+        const response = await runtime.client.request({ method: 'GET', path: `/api/kernel/teams/${encodeURIComponent(id)}` });
+        return { item: requireItem(response.data, 'team', id), surface };
+    }
+    const teams = await listTeams(runtime, { includeBuiltin: true, page: 1, pageAll: false, pageLimit: 1, pageSize: 100 });
+    const item = teams.items.find((candidate) => String(candidate.id ?? '') === id);
+    if (!item)
+        return { item: requireItem(undefined, 'team', id), surface };
+    return { item, surface };
+}
+export async function listIdentities(runtime, options) {
+    const surface = resolveAuthSurface(runtime.context);
+    if (surface === 'studio') {
+        const response = await runtime.client.request({
+            method: 'GET',
+            path: '/api/users/share-targets',
+            query: { ...(options.keyword ? { keyword: options.keyword } : {}), limit: options.pageSize },
+        });
+        const items = itemArray(unwrapServerData(response.data));
+        return { items, page: 1, pageSize: options.pageSize, surface, total: items.length };
+    }
+    const page = await collectPages(options, async (pageNumber) => {
+        const response = await runtime.client.request({
+            method: 'GET',
+            path: '/api/kernel/users',
+            query: {
+                ...(options.keyword ? { keyword: options.keyword } : {}),
+                page: pageNumber,
+                pageSize: options.pageSize,
+                ...(options.scope ? { scope: options.scope } : {}),
+                ...(options.userType ? { userType: options.userType } : {}),
+            },
+        });
+        return listPage(response.data, pageNumber, options.pageSize);
+    });
+    return { ...page, surface };
+}
+export async function getIdentity(runtime, id) {
+    const surface = resolveAuthSurface(runtime.context);
+    const response = surface === 'kernel'
+        ? await runtime.client.request({ method: 'GET', path: `/api/kernel/users/${encodeURIComponent(id)}` })
+        : await runtime.client.request({ body: { userIds: [id] }, method: 'POST', path: '/api/users/brief' });
+    const value = unwrapServerData(response.data);
+    const items = itemArray(value);
+    return { item: requireItem(surface === 'studio' ? items[0] : value, 'identity', id), surface };
+}
+//# sourceMappingURL=client.js.map

package/dist/discovery/client.js.map

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

package/dist/discovery/pagination.d.ts

@@ -0,0 +1,20 @@
+export declare const paginationFlags: {
+    page: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    'page-all': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    'page-limit': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    'page-size': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+};
+export interface PaginationInput {
+    page: number;
+    pageAll: boolean;
+    pageLimit: number;
+    pageSize: number;
+}
+export interface Page<T> {
+    items: T[];
+    page: number;
+    pageSize: number;
+    total: number;
+}
+export declare function collectPages<T>(input: PaginationInput, fetchPage: (page: number) => Promise<Page<T>>): Promise<Page<T>>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/discovery/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/discovery/pagination.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,eAAe;IAC1B,IAAI;IACJ,UAAU;IACV,YAAY;IACZ,WAAW;CACZ,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAqB7H"}

package/dist/discovery/pagination.js

@@ -0,0 +1,32 @@
+import { Flags } from '@oclif/core';
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+export const paginationFlags = {
+    page: Flags.integer({ default: 1, min: 1, summary: 'Page number, starting at 1' }),
+    'page-all': Flags.boolean({ default: false, summary: 'Fetch all result pages' }),
+    'page-limit': Flags.integer({ default: 20, max: 100, min: 1, summary: 'Maximum pages fetched with --page-all' }),
+    'page-size': Flags.integer({ default: 20, max: 100, min: 1, summary: 'Results per page' }),
+};
+export async function collectPages(input, fetchPage) {
+    const first = await fetchPage(input.page);
+    if (!input.pageAll || first.items.length === 0)
+        return first;
+    const items = [...first.items];
+    let current = first.page;
+    while (items.length < first.total && current - first.page + 1 < input.pageLimit) {
+        current += 1;
+        const next = await fetchPage(current);
+        items.push(...next.items);
+        if (next.items.length === 0)
+            break;
+    }
+    if (items.length < first.total) {
+        throw new CliError('Pagination stopped before all results were fetched.', {
+            code: 'PAGE_LIMIT_REACHED',
+            exitCode: EXIT_CODES.partial,
+            recovery: ['Increase --page-limit or fetch the remaining pages explicitly.'],
+            safeDetails: { fetched: items.length, pageLimit: input.pageLimit, total: first.total },
+        });
+    }
+    return { items, page: first.page, pageSize: input.pageSize, total: first.total };
+}
+//# sourceMappingURL=pagination.js.map

package/dist/discovery/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/discovery/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAE9D,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC;IAClF,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC;IAChF,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;IAChH,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC3F,CAAC;AAgBF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,KAAsB,EAAE,SAA6C;IACzG,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAE7D,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC;IACzB,OAAO,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,IAAI,OAAO,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;QAChF,OAAO,IAAI,CAAC,CAAC;QACb,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM;IACrC,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,IAAI,QAAQ,CAAC,qDAAqD,EAAE;YACxE,IAAI,EAAE,oBAAoB;YAC1B,QAAQ,EAAE,UAAU,CAAC,OAAO;YAC5B,QAAQ,EAAE,CAAC,gEAAgE,CAAC;YAC5E,WAAW,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;SACvF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;AACnF,CAAC"}

package/dist/output/render.d.ts

@@ -1,4 +1,10 @@
 import type { CommandResult } from '../contracts/result.js';
-export type OutputFormat = 'json' | 'ndjson' | 'text';
+export declare const OUTPUT_FORMATS: readonly ['json', 'pretty', 'table', 'ndjson', 'csv', 'text'];
+export type OutputFormat = (typeof OUTPUT_FORMATS)[number];
+export interface RenderOptions {
+    format: OutputFormat;
+    jq?: string;
+}
 export declare function renderResult<T>(result: CommandResult<T>, format: OutputFormat): string;
+export declare function renderCommandResult<T>(result: CommandResult<T>, options: RenderOptions): Promise<string>;
 //# sourceMappingURL=render.d.ts.map

package/dist/output/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/output/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAMtD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAWtF"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/output/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAG5D,eAAO,MAAM,cAAc,YAAI,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAU,CAAC;AAC5F,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAsDD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CActF;AAED,wBAAsB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAqB9G"}

package/dist/output/render.js

@@ -1,9 +1,56 @@
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+export const OUTPUT_FORMATS = ['json', 'pretty', 'table', 'ndjson', 'csv', 'text'];
 function renderTextValue(value) {
     return typeof value === 'string' ? value : JSON.stringify(value, null, 2);
 }
+function dataRows(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => item && typeof item === 'object' && !Array.isArray(item) ? item : { value: item });
+    }
+    if (value && typeof value === 'object')
+        return [value];
+    return [{ value }];
+}
+function cellText(value) {
+    if (value === undefined || value === null)
+        return '';
+    return typeof value === 'object' ? JSON.stringify(value) : String(value);
+}
+function columnsFor(rows) {
+    return [...new Set(rows.flatMap((row) => Object.keys(row)))];
+}
+function renderTable(value) {
+    const rows = dataRows(value);
+    const columns = columnsFor(rows);
+    if (columns.length === 0)
+        return '';
+    const widths = columns.map((column) => Math.max(column.length, ...rows.map((row) => cellText(row[column]).length)));
+    const line = (cells) => cells
+        .map((cell, index) => cell.padEnd(widths[index] ?? 0))
+        .join('  ')
+        .trimEnd();
+    return [
+        line(columns),
+        line(widths.map((width) => '-'.repeat(width))),
+        ...rows.map((row) => line(columns.map((column) => cellText(row[column])))),
+    ].join('\n');
+}
+function csvCell(value) {
+    const text = cellText(value);
+    return /[",\r\n]/.test(text) ? `"${text.replaceAll('"', '""')}"` : text;
+}
+function renderCsv(value) {
+    const rows = dataRows(value);
+    const columns = columnsFor(rows);
+    if (columns.length === 0)
+        return '';
+    return [columns.map(csvCell).join(','), ...rows.map((row) => columns.map((column) => csvCell(row[column])).join(','))].join('\n');
+}
 export function renderResult(result, format) {
     if (format === 'json')
         return JSON.stringify(result);
+    if (format === 'pretty')
+        return JSON.stringify(result, null, 2);
     if (format === 'ndjson') {
         const items = result.ok && Array.isArray(result.data) ? result.data : [result];
         const lines = items.map((item) => JSON.stringify(item));
@@ -11,8 +58,34 @@ export function renderResult(result, format) {
             lines.push(JSON.stringify({ _notice: result._notice }));
         return lines.join('\n');
     }
+    if (format === 'table')
+        return result.ok ? renderTable(result.data) : `${result.error.code}: ${result.error.message}`;
+    if (format === 'csv')
+        return result.ok ? renderCsv(result.data) : `${result.error.code},${csvCell(result.error.message)}`;
     const body = result.ok ? renderTextValue(result.data) : `${result.error.code}: ${result.error.message}`;
     const update = result._notice?.update;
     return update ? `${body}\n\nUpdate available: ${update.current} → ${update.latest}. Run \`${update.command}\` to install.` : body;
 }
+export async function renderCommandResult(result, options) {
+    if (!options.jq)
+        return renderResult(result, options.format);
+    if (options.format !== 'json') {
+        throw new CliError('--jq can only be used with JSON output.', {
+            code: 'OUTPUT_OPTION_CONFLICT',
+            exitCode: EXIT_CODES.validation,
+            recovery: ['Remove --jq or use --format json.'],
+        });
+    }
+    const { raw } = await import('jq-wasm');
+    const filtered = await raw(result, options.jq, ['-r']);
+    if (filtered.exitCode !== 0) {
+        throw new CliError('The jq expression could not be evaluated.', {
+            code: 'JQ_EXPRESSION_INVALID',
+            exitCode: EXIT_CODES.validation,
+            recovery: ['Check the jq expression and try again.'],
+            safeDetails: { stderr: filtered.stderr.trim() },
+        });
+    }
+    return filtered.stdout.trimEnd();
+}
 //# sourceMappingURL=render.js.map

package/dist/output/render.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/output/render.ts"],"names":[],"mappings":"AAIA,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,YAAY,CAAI,MAAwB,EAAE,MAAoB;IAC5E,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC/E,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACxD,IAAI,MAAM,CAAC,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACvH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IACxG,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC;IACtC,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,yBAAyB,MAAM,CAAC,OAAO,MAAM,MAAM,CAAC,MAAM,WAAW,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC;AACpI,CAAC"}
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/output/render.ts"],"names":[],"mappings":"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"}

package/dist/schema/command-schema.d.ts

@@ -0,0 +1,26 @@
+import { getCommandMetadata } from '../command/metadata.js';
+export interface LoadableCommand {
+    args?: Record<string, unknown>;
+    description?: string;
+    flags?: Record<string, unknown>;
+    id: string;
+    summary?: string;
+}
+export interface CommandSchema {
+    arguments: Record<string, unknown>;
+    command: string;
+    description?: string;
+    execution: ReturnType<typeof getCommandMetadata>;
+    flags: Record<string, unknown>;
+    jqRootPath: '.';
+    result: {
+        dataPath: '.data';
+        envelopeSchemaVersion: '1';
+        errorPath: '.error';
+    };
+}
+export declare function commandIdToPath(id: string): string;
+export declare function normalizeSchemaPath(parts: string[]): string;
+export declare function describeCommand(command: LoadableCommand): CommandSchema;
+export declare function catalogEntry(command: LoadableCommand): Pick<CommandSchema, 'command' | 'description' | 'execution'>;
+//# sourceMappingURL=command-schema.d.ts.map

package/dist/schema/command-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-schema.d.ts","sourceRoot":"","sources":["../../src/schema/command-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;IACjD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,UAAU,EAAE,GAAG,CAAC;IAChB,MAAM,EAAE;QACN,QAAQ,EAAE,OAAO,CAAC;QAClB,qBAAqB,EAAE,GAAG,CAAC;QAC3B,SAAS,EAAE,QAAQ,CAAC;KACrB,CAAC;CACH;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAK3D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,CAWvE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC,CAGnH"}

package/dist/schema/command-schema.js

@@ -0,0 +1,27 @@
+import { getCommandMetadata } from '../command/metadata.js';
+export function commandIdToPath(id) {
+    return id.replaceAll(':', ' ');
+}
+export function normalizeSchemaPath(parts) {
+    return parts
+        .flatMap((part) => part.split(/[.:\s]+/))
+        .filter(Boolean)
+        .join(':');
+}
+export function describeCommand(command) {
+    const path = commandIdToPath(command.id);
+    return {
+        arguments: command.args ?? {},
+        command: path,
+        ...((command.description ?? command.summary) ? { description: command.description ?? command.summary } : {}),
+        execution: getCommandMetadata(path),
+        flags: command.flags ?? {},
+        jqRootPath: '.',
+        result: { dataPath: '.data', envelopeSchemaVersion: '1', errorPath: '.error' },
+    };
+}
+export function catalogEntry(command) {
+    const schema = describeCommand(command);
+    return { command: schema.command, ...(schema.description ? { description: schema.description } : {}), execution: schema.execution };
+}
+//# sourceMappingURL=command-schema.js.map

package/dist/schema/command-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-schema.js","sourceRoot":"","sources":["../../src/schema/command-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAwB5D,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAe;IACjD,OAAO,KAAK;SACT,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;SACxC,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAwB;IACtD,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACzC,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;QAC7B,OAAO,EAAE,IAAI;QACb,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5G,SAAS,EAAE,kBAAkB,CAAC,IAAI,CAAC;QACnC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;QAC1B,UAAU,EAAE,GAAG;QACf,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE;KAC/E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAwB;IACnD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;AACtI,CAAC"}

package/dist/skills/content.d.ts

@@ -0,0 +1,13 @@
+export interface BundledSkill {
+    checksum: string;
+    description: string;
+    name: string;
+}
+export declare function bundledSkillsRoot(): string;
+export declare function listBundledSkills(root?: string): Promise<BundledSkill[]>;
+export declare function readBundledSkill(name: string, resource?: string, root?: string): Promise<{
+    content: string;
+    name: string;
+    resource: string;
+}>;
+//# sourceMappingURL=content.d.ts.map

package/dist/skills/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/skills/content.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AA2CD,wBAAsB,iBAAiB,CAAC,IAAI,SAAsB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAQ3F;AAUD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,QAAQ,SAAa,EACrB,IAAI,SAAsB,GACzB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA+B9D"}

package/dist/skills/content.js

@@ -0,0 +1,103 @@
+import { createHash } from 'node:crypto';
+import { readdir, readFile, realpath, stat } from 'node:fs/promises';
+import { dirname, relative, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parse } from 'yaml';
+import { BUNDLED_SKILL_NAMES } from '../contracts/version.js';
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+export function bundledSkillsRoot() {
+    return resolve(dirname(fileURLToPath(import.meta.url)), '../../skills');
+}
+async function skillFiles(directory, prefix = '') {
+    const entries = await readdir(resolve(directory, prefix), { withFileTypes: true });
+    const paths = [];
+    for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
+        const path = prefix ? `${prefix}/${entry.name}` : entry.name;
+        if (entry.isDirectory())
+            paths.push(...(await skillFiles(directory, path)));
+        else if (entry.isFile())
+            paths.push(path);
+    }
+    return paths;
+}
+async function checksumDirectory(directory) {
+    const hash = createHash('sha256');
+    for (const file of await skillFiles(directory)) {
+        hash
+            .update(file)
+            .update('\0')
+            .update(await readFile(resolve(directory, file)))
+            .update('\0');
+    }
+    return hash.digest('hex');
+}
+function skillFrontmatter(content, expectedName) {
+    const match = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/.exec(content);
+    if (!match)
+        throw new CliError('Bundled Skill frontmatter is missing.', { code: 'SKILL_INVALID', exitCode: EXIT_CODES.compatibility });
+    const value = parse(match[1]);
+    if (!value || typeof value !== 'object') {
+        throw new CliError('Bundled Skill frontmatter is invalid.', { code: 'SKILL_INVALID', exitCode: EXIT_CODES.compatibility });
+    }
+    const frontmatter = value;
+    if (frontmatter.name !== expectedName || typeof frontmatter.description !== 'string' || !frontmatter.description.trim()) {
+        throw new CliError('Bundled Skill name or description is invalid.', {
+            code: 'SKILL_INVALID',
+            exitCode: EXIT_CODES.compatibility,
+            safeDetails: { expectedName },
+        });
+    }
+    return { description: frontmatter.description.trim(), name: frontmatter.name };
+}
+export async function listBundledSkills(root = bundledSkillsRoot()) {
+    const skills = [];
+    for (const name of BUNDLED_SKILL_NAMES) {
+        const directory = resolve(root, name);
+        const frontmatter = skillFrontmatter(await readFile(resolve(directory, 'SKILL.md'), 'utf8'), name);
+        skills.push({ ...frontmatter, checksum: await checksumDirectory(directory) });
+    }
+    return skills;
+}
+function validateResourcePath(value) {
+    const normalized = value.trim().replaceAll('\\', '/');
+    if (!normalized || normalized.startsWith('/') || normalized.split('/').some((part) => part === '..' || part === '.')) {
+        throw new CliError('Skill resource path is invalid.', { code: 'SKILL_PATH_INVALID', exitCode: EXIT_CODES.validation });
+    }
+    return normalized;
+}
+export async function readBundledSkill(name, resource = 'SKILL.md', root = bundledSkillsRoot()) {
+    if (!BUNDLED_SKILL_NAMES.includes(name)) {
+        throw new CliError('Bundled Skill was not found.', {
+            code: 'SKILL_NOT_FOUND',
+            exitCode: EXIT_CODES.validation,
+            recovery: ['Run `monkeys skills list` to see bundled Skills.'],
+            safeDetails: { name },
+        });
+    }
+    const normalized = validateResourcePath(resource);
+    const skillRoot = await realpath(resolve(root, name));
+    const candidate = resolve(skillRoot, normalized);
+    const candidateRelative = relative(skillRoot, candidate);
+    if (candidateRelative.startsWith(`..${sep}`) || candidateRelative === '..') {
+        throw new CliError('Skill resource path escapes the bundled Skill.', { code: 'SKILL_PATH_INVALID', exitCode: EXIT_CODES.validation });
+    }
+    try {
+        const info = await stat(candidate);
+        if (!info.isFile())
+            throw new Error('not a file');
+        const canonical = await realpath(candidate);
+        const canonicalRelative = relative(skillRoot, canonical);
+        if (canonicalRelative.startsWith(`..${sep}`) || canonicalRelative === '..')
+            throw new Error('link escapes Skill');
+        return { content: await readFile(canonical, 'utf8'), name, resource: normalized };
+    }
+    catch (cause) {
+        throw new CliError('Bundled Skill resource was not found or is not readable.', {
+            cause,
+            code: 'SKILL_RESOURCE_NOT_FOUND',
+            exitCode: EXIT_CODES.validation,
+            safeDetails: { name, resource: normalized },
+        });
+    }
+}
+//# sourceMappingURL=content.js.map

package/dist/skills/content.js.map

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

package/dist/skills/state.d.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import type { BundledSkill } from './content.js';
+declare const skillsStateSchema: z.ZodObject<{
+    cliVersion: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    skills: z.ZodArray<z.ZodObject<{
+        checksum: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    source: z.ZodEnum<{
+        install: "install";
+        sync: "sync";
+        update: "update";
+    }>;
+    syncedAt: z.ZodString;
+}, z.core.$strict>;
+export type SkillsState = z.infer<typeof skillsStateSchema>;
+export declare function defaultSkillsStatePath(): string;
+export declare function readSkillsState(path?: string): Promise<SkillsState | undefined>;
+export declare function writeSkillsState(cliVersion: string, skills: BundledSkill[], source: SkillsState['source'], path?: string): Promise<SkillsState>;
+export declare function skillsStatus(cliVersion: string, bundled: BundledSkill[], path?: string): Promise<{
+    bundled: {
+        checksum: string;
+        name: string;
+    }[];
+    cliVersion: string;
+    inSync: boolean;
+    stateRecorded: boolean;
+    state?: {
+        cliVersion: string;
+        schemaVersion: 1;
+        skills: {
+            checksum: string;
+            name: string;
+        }[];
+        source: "install" | "sync" | "update";
+        syncedAt: string;
+    };
+    skillsMatch: boolean;
+    versionMatch: boolean;
+}>;
+export {};
+//# sourceMappingURL=state.d.ts.map

package/dist/skills/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/skills/state.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;kBAQZ,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,wBAAsB,eAAe,CAAC,IAAI,SAA2B,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAOvG;AAED,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,EAAE,EACtB,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,EAC7B,IAAI,SAA2B,GAC9B,OAAO,CAAC,WAAW,CAAC,CAatB;AAED,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,IAAI,SAA2B;;;;;;;;;;;;;;;;;;;;GAc9G"}

package/dist/skills/state.js

@@ -0,0 +1,56 @@
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { z } from 'zod';
+import { configDirectory, resolveConfigPath } from '../config/paths.js';
+const skillsStateSchema = z
+    .object({
+    cliVersion: z.string().min(1),
+    schemaVersion: z.literal(1),
+    skills: z.array(z.object({ checksum: z.string().regex(/^[a-f0-9]{64}$/), name: z.string().min(1) })),
+    source: z.enum(['install', 'sync', 'update']),
+    syncedAt: z.string().datetime(),
+})
+    .strict();
+export function defaultSkillsStatePath() {
+    return join(configDirectory(resolveConfigPath()), 'skills-state.json');
+}
+export async function readSkillsState(path = defaultSkillsStatePath()) {
+    try {
+        return skillsStateSchema.parse(JSON.parse(await readFile(path, 'utf8')));
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT')
+            return undefined;
+        return undefined;
+    }
+}
+export async function writeSkillsState(cliVersion, skills, source, path = defaultSkillsStatePath()) {
+    const state = skillsStateSchema.parse({
+        cliVersion,
+        schemaVersion: 1,
+        skills: skills.map(({ checksum, name }) => ({ checksum, name })),
+        source,
+        syncedAt: new Date().toISOString(),
+    });
+    await mkdir(dirname(path), { mode: 0o700, recursive: true });
+    const temporary = `${path}.tmp-${process.pid}-${Date.now()}`;
+    await writeFile(temporary, `${JSON.stringify(state, null, 2)}\n`, { mode: 0o600 });
+    await rename(temporary, path);
+    return state;
+}
+export async function skillsStatus(cliVersion, bundled, path = defaultSkillsStatePath()) {
+    const state = await readSkillsState(path);
+    const expected = bundled.map(({ checksum, name }) => ({ checksum, name }));
+    const versionMatch = state?.cliVersion === cliVersion;
+    const skillsMatch = state ? JSON.stringify(state.skills) === JSON.stringify(expected) : false;
+    return {
+        bundled: expected,
+        cliVersion,
+        inSync: Boolean(state && versionMatch && skillsMatch),
+        stateRecorded: Boolean(state),
+        ...(state ? { state } : {}),
+        skillsMatch,
+        versionMatch,
+    };
+}
+//# sourceMappingURL=state.js.map

package/dist/skills/state.js.map

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