@aopslabs/aops 0.2.0

package/dist/commands/agents-md.js

@@ -0,0 +1,125 @@
+import path from 'node:path';
+import { Command } from 'commander';
+import { logInfo, logSuccess, logWarn } from '@aopslabs/xf-cli-ui';
+import { resetAgentsMdFile, updateAgentsMdFile, } from '../utils/agents-md.js';
+function serializableUpdateResult(result) {
+    return {
+        action: result.action,
+        rootDir: result.rootDir,
+        filePath: result.filePath,
+        changed: result.changed,
+        selectedTemplates: result.selectedTemplates.map((seed) => ({
+            slug: seed.slug,
+            title: seed.title,
+            mirrorPath: seed.mirrorPath,
+            promptRef: seed.promptRef,
+        })),
+        warnings: result.warnings,
+        syncHosted: result.syncHosted,
+        content: result.content,
+    };
+}
+function serializableResetResult(result) {
+    return {
+        action: result.action,
+        rootDir: result.rootDir,
+        filePath: result.filePath,
+        changed: result.changed,
+        warnings: result.warnings,
+        content: result.content,
+    };
+}
+function printWarnings(warnings) {
+    warnings.forEach((warning) => logWarn(warning));
+}
+export async function runAgentsMdUpdate(options = {}) {
+    const result = await updateAgentsMdFile(options);
+    if (options.json) {
+        console.log(JSON.stringify({
+            command: 'agents-md.update',
+            result: serializableUpdateResult(result),
+        }, null, 2));
+        return;
+    }
+    printWarnings(result.warnings);
+    if (options.preview) {
+        logInfo(`Preview for ${path.relative(result.rootDir, result.filePath) || result.filePath}`);
+        process.stdout.write(result.content ?? '');
+        return;
+    }
+    logSuccess(`${result.changed ? 'Updated' : 'Checked'} ${result.filePath}`);
+    logInfo(`Templates: ${result.selectedTemplates.map((seed) => seed.slug).join(', ')}`);
+    if (result.syncHosted)
+        logInfo(`Refreshed hosted mirrors with: ${result.syncHosted.command}`);
+}
+export async function runAgentsMdPreview(options = {}) {
+    await runAgentsMdUpdate({ ...options, preview: true, apply: false, syncHosted: false });
+}
+export async function runAgentsMdReset(options = {}) {
+    const result = await resetAgentsMdFile(options);
+    if (options.json) {
+        console.log(JSON.stringify({
+            command: 'agents-md.reset',
+            result: serializableResetResult(result),
+        }, null, 2));
+        return;
+    }
+    printWarnings(result.warnings);
+    if (options.preview) {
+        logInfo(`Reset preview for ${path.relative(result.rootDir, result.filePath) || result.filePath}`);
+        process.stdout.write(result.content ?? '');
+        return;
+    }
+    logSuccess(`${result.changed ? 'Removed managed block from' : 'No managed block found in'} ${result.filePath}`);
+}
+function addTemplateSelectionOptions(cmd) {
+    return cmd
+        .option('--root <path>', 'Workspace root override (default: nearest package.json ancestor)')
+        .option('--discuss', 'Also include the standalone discuss / decision-ritual template (aops-cli-discuss skill)')
+        .option('--all', 'Include all bundled AOPS AGENTS.md prompt template snippets')
+        .option('--no-default-task', 'Do not include the default starter template (aops-collaborative-startup)')
+        .option('--embed-prompts', 'Embed prompt bodies from local hosted mirrors when available')
+        .option('--json', 'Output JSON only');
+}
+export function makeAgentsMdCommand() {
+    const cmd = new Command('agents-md').description('Manage AOPS prompt-template bootstrap blocks in AGENTS.md');
+    cmd.addCommand(addTemplateSelectionOptions(new Command('update')
+        .description('Insert or replace the managed AOPS AGENTS.md prompt-template block')
+        .option('--preview', 'Print the merged AGENTS.md content without writing')
+        .option('--apply', 'Write the merged AGENTS.md content')
+        .option('--sync-hosted', 'Refresh hosted prompt/skill mirrors before rendering'))
+        .action(async (options) => {
+        await runAgentsMdUpdate(options);
+    })
+        .addHelpText('after', `
+Examples:
+  aops-cli agents-md update --apply
+  aops-cli agents-md update --discuss --apply
+  aops-cli agents-md update --sync-hosted --apply
+`));
+    cmd.addCommand(addTemplateSelectionOptions(new Command('preview').description('Print merged AGENTS.md content without writing'))
+        .action(async (options) => {
+        await runAgentsMdPreview(options);
+    })
+        .addHelpText('after', `
+Examples:
+  aops-cli agents-md preview
+  aops-cli agents-md preview --discuss --json
+`));
+    cmd.addCommand(new Command('reset')
+        .description('Remove the managed AOPS AGENTS.md prompt-template block')
+        .option('--root <path>', 'Workspace root override (default: nearest package.json ancestor)')
+        .option('--preview', 'Print the resulting AGENTS.md content without writing')
+        .option('--apply', 'Write the resulting AGENTS.md content')
+        .option('--confirm', 'Confirm removal of the managed block')
+        .option('--json', 'Output JSON only')
+        .action(async (options) => {
+        await runAgentsMdReset(options);
+    })
+        .addHelpText('after', `
+Examples:
+  aops-cli agents-md reset --preview
+  aops-cli agents-md reset --apply --confirm
+`));
+    return cmd;
+}

package/dist/commands/api.js

@@ -0,0 +1,84 @@
+import { Command } from 'commander';
+import { banner, logError, logInfo, logSuccess } from '@aopslabs/xf-cli-ui';
+import { appendQueryToPath, buildDomainApiPath, parseJsonInput, } from '../utils/operator-runtime.js';
+import { applyCommonOptions, normalizeNonEmpty, } from '../utils/command.js';
+import { buildAgentContextHeaders, requireApiState } from '../utils/agent-gateway.js';
+import { promptInput } from '../utils/prompts.js';
+export async function runApiCall(options = {}) {
+    const interactive = !options.yes && !options.json;
+    const apiState = await requireApiState(options);
+    if (!apiState)
+        return;
+    let domain = normalizeNonEmpty(options.domain);
+    if (!domain && interactive) {
+        domain = normalizeNonEmpty(await promptInput({ message: 'Domain (e.g. docman):' }));
+    }
+    if (!domain) {
+        logError('Missing domain. Provide --domain <id>.');
+        process.exitCode = 1;
+        return;
+    }
+    const method = (normalizeNonEmpty(options.method) ?? 'GET').toUpperCase();
+    let body;
+    let query;
+    let headers;
+    try {
+        body = parseJsonInput(options.body, 'body');
+        query = parseJsonInput(options.query, 'query');
+        headers = await buildAgentContextHeaders(options);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logError(message);
+        process.exitCode = 1;
+        return;
+    }
+    const path = appendQueryToPath(buildDomainApiPath(domain, options.path), query);
+    if (interactive) {
+        banner('AOPS Domain API');
+        logInfo(`API: ${apiState.baseUrl}`);
+        logInfo(`${method} ${path}`);
+    }
+    try {
+        const payload = await apiState.client.fetchJson(path, {
+            method,
+            body: method === 'GET' || method === 'HEAD' ? undefined : body,
+            headers,
+            timeoutMs: options.timeoutMs,
+        });
+        if (!options.json)
+            logSuccess(`${method} ${path} -> ok`);
+        console.log(JSON.stringify(payload, null, 2));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logError(`Domain API call failed: ${message}`);
+        process.exitCode = 1;
+    }
+}
+export function makeApiCommand() {
+    const cmd = new Command('api').description('Direct domain API escape hatch (/api/{domain}/...)');
+    applyCommonOptions(cmd
+        .command('call')
+        .description('Call direct domain route via dynamic host router (escape hatch, not primary tool plane)')
+        .option('--domain <id>', 'Domain id (e.g. docman)')
+        .option('--path <route>', 'Route path under domain (e.g. documents/123)')
+        .option('--method <method>', 'HTTP method (GET|POST|PUT|PATCH|DELETE)', 'GET')
+        .option('--query <json>', 'Query params JSON or @file.json')
+        .option('--body <json>', 'Body JSON or @file.json')
+        .option('--project-id <id>', 'Project id header (x-project-id)')
+        .option('--project-name <name>', 'Project name header (x-project-name)')
+        .option('--tenant-id <id>', 'Tenant id header (x-tenant-id)')
+        .option('--locale <locale>', 'Locale header (x-locale)')
+        .option('--fallback-locale <locale>', 'Fallback locale header (x-fallback-locale)')
+        .action(async (options) => {
+        await runApiCall(options);
+    }), { withProject: false });
+    cmd.addHelpText('after', `
+Examples:
+  aops-cli api call --domain docman --path documents --method GET --project-id <project-id>
+  aops-cli api call --domain docman --path documents --method GET --scope-id <scope-id>
+  aops-cli api call --domain projectman --path kanban/boards --method POST --body @./payload.json
+`);
+    return cmd;
+}