@tjdals12/agent-bolt 1.3.0 → 1.4.0-next.2

package/dist/catalog/skill/install.js

@@ -0,0 +1,39 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { createRequire } from 'node:module';
+import { getAdapters } from '#catalog/install/adapters/registry.js';
+const SKILL_ENTRY_FILENAME = 'SKILL.md';
+export function resolveBundledSkillDir(name) {
+    const require = createRequire(import.meta.url);
+    const packageJsonPath = require.resolve('../../../package.json');
+    const skillDir = path.join(path.dirname(packageJsonPath), 'skills', name);
+    if (!fs.existsSync(path.join(skillDir, SKILL_ENTRY_FILENAME))) {
+        throw new Error(`Bundled skill '${name}' not found at ${skillDir}. Reinstall @tjdals12/agent-bolt.`);
+    }
+    return skillDir;
+}
+export function installBundledSkill(args) {
+    const { projectPath, toolIds, name, version } = args;
+    const skillDir = resolveBundledSkillDir(name);
+    const adapters = getAdapters(toolIds);
+    const installs = [];
+    for (const adapter of adapters) {
+        const { id, skillsDir } = adapter;
+        const installPath = path.join(skillsDir, name);
+        const targetDir = path.join(projectPath, installPath);
+        const status = fs.existsSync(targetDir) ? 'updated' : 'installed';
+        fs.rmSync(targetDir, { recursive: true, force: true });
+        fs.cpSync(skillDir, targetDir, { recursive: true });
+        stampVersion(path.join(targetDir, SKILL_ENTRY_FILENAME), version);
+        installs.push({ tool: id, path: installPath, status });
+    }
+    return installs;
+}
+function stampVersion(skillFilePath, version) {
+    const content = fs.readFileSync(skillFilePath, 'utf-8');
+    if (!content.startsWith('---\n')) {
+        return;
+    }
+    fs.writeFileSync(skillFilePath, content.replace('---\n', `---\nversion: ${version}\n`), 'utf-8');
+}
+//# sourceMappingURL=install.js.map

package/dist/catalog/skill/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/catalog/skill/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAEpE,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAQxC,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IAE1E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CACb,kBAAkB,IAAI,kBAAkB,QAAQ,mCAAmC,CACpF,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAKnC;IACC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAErD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAuB,EAAE,CAAC;IAExC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;QAElC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;QAElE,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,EAAE,OAAO,CAAC,CAAC;QAElE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,YAAY,CAAC,aAAqB,EAAE,OAAe;IAC1D,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACxD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,OAAO;IACT,CAAC;IACD,EAAE,CAAC,aAAa,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,iBAAiB,OAAO,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AACnG,CAAC"}

package/dist/cli/index.js

@@ -16,12 +16,14 @@ import { renderCheckResult } from './views/check.js';
 import { renderAddItemResult } from './views/add-item.js';
 import { renderRemoveItemResult } from './views/remove-item.js';
 import { renderShowItemResult } from './views/show-item.js';
+import { renderSkillInstallResult } from './views/skill-install.js';
 import { renderValidateCatalogResult } from './views/catalog/validate-catalog.js';
 import { renderInitCatalogResult } from './views/catalog/init-catalog.js';
 import { renderNewPackResult } from './views/catalog/new-pack.js';
 import { renderNewSkillResult } from './views/catalog/new/new-skill.js';
 import { renderNewAgentResult } from './views/catalog/new/new-agent.js';
 import { renderNewGuidelineResult } from './views/catalog/new/new-guideline.js';
+import { printJson, printJsonError } from './json.js';
 const program = new Command();
 const require = createRequire(import.meta.url);
 const { version } = require('../../package.json');
@@ -32,6 +34,7 @@ program
     .option('--tools <list>', 'codex,claude,cursor,copilot,opencode (omit to pick interactively)')
     .option('--source <spec>', 'Catalog source as <alias>=<type>:<location> (repeatable). e.g. team=git:https://github.com/acme/catalog.git', collect, [])
     .option('--force', 'Overwrite an existing config.yml', false)
+    .option('--json', 'Print the result as JSON', false)
     .addHelpText('after', dedent `
     Examples:
       $ agent-bolt init
@@ -42,16 +45,14 @@ program
   `)
     .action(async (options) => {
     const projectPath = process.cwd();
-    try {
-        const { InitCommand } = await import('#catalog/commands/init.js');
-        const command = new InitCommand(options);
-        const result = await command.execute(projectPath);
-        renderInitResult(result, projectPath);
+    const { InitCommand } = await import('#catalog/commands/init.js');
+    const command = new InitCommand(options);
+    const result = await command.execute(projectPath);
+    if (options.json) {
+        printJson(command.toJson(result));
     }
-    catch (e) {
-        const message = e instanceof Error ? e.message : String(e);
-        ConsoleOutput.error(message);
-        process.exit(1);
+    else {
+        renderInitResult(result, projectPath);
     }
 });
 program
@@ -59,6 +60,7 @@ program
     .description('List the packs provided by the configured sources')
     .option('--source <alias>', 'Filter to a specific source (default: all sources)')
     .option('--no-pager', 'Print directly without the pager')
+    .option('--json', 'Print the result as JSON', false)
     .addHelpText('after', dedent `
     Examples:
       $ agent-bolt list-packs
@@ -66,18 +68,16 @@ program
     `)
     .action(async (options) => {
     const projectPath = process.cwd();
-    try {
-        const { ListPacksCommand } = await import('#catalog/commands/list-packs.js');
-        const reporter = ProgressReporter.create();
-        const command = new ListPacksCommand(options);
-        const result = command.execute(projectPath, reporter);
+    const { ListPacksCommand } = await import('#catalog/commands/list-packs.js');
+    const reporter = ProgressReporter.create({ silent: options.json });
+    const command = new ListPacksCommand(options);
+    const result = command.execute(projectPath, reporter);
+    if (options.json) {
+        printJson(command.toJson(result));
+    }
+    else {
         withPager(() => renderListPacksResult(result), options.pager);
     }
-    catch (e) {
-        const message = e instanceof Error ? e.message : String(e);
-        ConsoleOutput.error(message);
-        process.exit(1);
-    }
 });
 program
     .command('list-items')
@@ -85,6 +85,7 @@ program
     .option('--source <alias>', 'Filter to a specific source (default: all sources)')
     .option('--packs <list>', 'Filter to specific packs by name (comma separated)')
     .option('--no-pager', 'Print directly without the pager')
+    .option('--json', 'Print the result as JSON', false)
     .addHelpText('after', dedent `
     Examples:
       $ agent-bolt list-items
@@ -94,16 +95,14 @@ program
     `)
     .action(async (options) => {
     const projectPath = process.cwd();
-    try {
-        const { ListItemsCommand } = await import('#catalog/commands/list-items.js');
-        const command = new ListItemsCommand(options);
-        const result = command.execute(projectPath);
-        withPager(() => renderListItemsResult(result), options.pager);
+    const { ListItemsCommand } = await import('#catalog/commands/list-items.js');
+    const command = new ListItemsCommand(options);
+    const result = command.execute(projectPath);
+    if (options.json) {
+        printJson(command.toJson(result));
     }
-    catch (e) {
-        const message = e instanceof Error ? e.message : String(e);
-        ConsoleOutput.error(message);
-        process.exit(1);
+    else {
+        withPager(() => renderListItemsResult(result), options.pager);
     }
 });
 program
@@ -113,22 +112,21 @@ program
     .requiredOption('--pack <name>', 'Pack name the item belongs to (required)')
     .requiredOption('--item <name>', 'Item name to show (required)')
     .option('--no-pager', 'Print directly without the pager')
+    .option('--json', 'Print the result as JSON', false)
     .addHelpText('after', dedent `
     Examples:
       $ agent-bolt show-item --source=common --pack=git-workflow --item=create-commit
     `)
     .action(async (options) => {
     const projectPath = process.cwd();
-    try {
-        const { ShowItemCommand } = await import('#catalog/commands/show-item.js');
-        const command = new ShowItemCommand(options);
-        const result = command.execute(projectPath);
-        withPager(() => renderShowItemResult(result), options.pager);
+    const { ShowItemCommand } = await import('#catalog/commands/show-item.js');
+    const command = new ShowItemCommand(options);
+    const result = command.execute(projectPath);
+    if (options.json) {
+        printJson(command.toJson(result));
     }
-    catch (e) {
-        const message = e instanceof Error ? e.message : String(e);
-        ConsoleOutput.error(message);
-        process.exit(1);
+    else {
+        withPager(() => renderShowItemResult(result), options.pager);
     }
 });
 program
@@ -136,6 +134,7 @@ program
     .description('Add whole packs from a source to the config (all items included)')
     .option('--source <alias>', 'Target source to add the packs to. Omit to pick interactively')
     .option('--packs <list>', 'Pack names to add (comma separated). Omit to pick interactively')
+    .option('--json', 'Print the result as JSON', false)
     .addHelpText('after', dedent `
     Examples:
       $ agent-bolt add-pack  # pick a source, then packs, interactively
@@ -145,24 +144,23 @@ program
     `)
     .action(async (options) => {
     const projectPath = process.cwd();
-    try {
-        const { AddPackCommand } = await import('#catalog/commands/add-pack.js');
-        const reporter = ProgressReporter.create();
-        const command = new AddPackCommand(options);
-        const result = await command.execute(projectPath, reporter);
+    const { AddPackCommand } = await import('#catalog/commands/add-pack.js');
+    const reporter = ProgressReporter.create({ silent: options.json });
+    const command = new AddPackCommand(options);
+    const result = await command.execute(projectPath, reporter);
+    if (options.json) {
+        printJson(command.toJson(result));
+    }
+    else {
         renderAddPackResult(result);
     }
-    catch (e) {
-        const message = e instanceof Error ? e.message : String(e);
-        ConsoleOutput.error(message);
-        process.exit(1);
-    }
 });
 program
     .command('remove-pack')
     .description('Remove whole packs from a source in the config')
     .option('--source <alias>', 'Target source to remove the packs from. Omit to pick interactively')
     .option('--packs <list>', 'Pack names to remove (comma separated). Omit to pick interactively')
+    .option('--json', 'Print the result as JSON', false)
     .addHelpText('after', dedent `
     Examples:
       $ agent-bolt remove-pack  # pick a source, then packs, interactively
@@ -172,16 +170,14 @@ program
     `)
     .action(async (options) => {
     const projectPath = process.cwd();
-    try {
-        const { RemovePackCommand } = await import('#catalog/commands/remove-pack.js');
-        const command = new RemovePackCommand(options);
-        const result = await command.execute(projectPath);
-        renderRemovePackResult(result);
+    const { RemovePackCommand } = await import('#catalog/commands/remove-pack.js');
+    const command = new RemovePackCommand(options);
+    const result = await command.execute(projectPath);
+    if (options.json) {
+        printJson(command.toJson(result));
     }
-    catch (e) {
-        const message = e instanceof Error ? e.message : String(e);
-        ConsoleOutput.error(message);
-        process.exit(1);
+    else {
+        renderRemovePackResult(result);
     }
 });
 program
@@ -192,6 +188,7 @@ program
     .option('--skills <list>', 'Skill names to add (comma separated)')
     .option('--agents <list>', 'Agent names to add (comma separated)')
     .option('--guidelines <list>', 'Guideline names to add (comma separated)')
+    .option('--json', 'Print the result as JSON', false)
     .addHelpText('after', dedent `
     Examples:
       $ agent-bolt add-item  # pick a source, then packs and items, interactively
@@ -202,18 +199,16 @@ program
     `)
     .action(async (options) => {
     const projectPath = process.cwd();
-    try {
-        const { AddItemCommand } = await import('#catalog/commands/add-item.js');
-        const reporter = ProgressReporter.create();
-        const command = new AddItemCommand(options);
-        const result = await command.execute(projectPath, reporter);
+    const { AddItemCommand } = await import('#catalog/commands/add-item.js');
+    const reporter = ProgressReporter.create({ silent: options.json });
+    const command = new AddItemCommand(options);
+    const result = await command.execute(projectPath, reporter);
+    if (options.json) {
+        printJson(command.toJson(result));
+    }
+    else {
         renderAddItemResult(result);
     }
-    catch (e) {
-        const message = e instanceof Error ? e.message : String(e);
-        ConsoleOutput.error(message);
-        process.exit(1);
-    }
 });
 program
     .command('remove-item')
@@ -223,6 +218,7 @@ program
     .option('--skills <list>', 'Skill names to remove (comma separated)')
     .option('--agents <list>', 'Agent names to remove (comma separated)')
     .option('--guidelines <list>', 'Guideline names to remove (comma separated)')
+    .option('--json', 'Print the result as JSON', false)
     .addHelpText('after', dedent `
     Examples:
       $ agent-bolt remove-item  # pick a source, then packs and items, interactively
@@ -233,61 +229,78 @@ program
     `)
     .action(async (options) => {
     const projectPath = process.cwd();
-    try {
-        const { RemoveItemCommand } = await import('#catalog/commands/remove-item.js');
-        const command = new RemoveItemCommand(options);
-        const result = await command.execute(projectPath);
-        renderRemoveItemResult(result);
+    const { RemoveItemCommand } = await import('#catalog/commands/remove-item.js');
+    const command = new RemoveItemCommand(options);
+    const result = await command.execute(projectPath);
+    if (options.json) {
+        printJson(command.toJson(result));
     }
-    catch (e) {
-        const message = e instanceof Error ? e.message : String(e);
-        ConsoleOutput.error(message);
-        process.exit(1);
+    else {
+        renderRemoveItemResult(result);
     }
 });
 program
     .command('sync')
     .description('Install configured tools into each selected tool')
+    .option('--json', 'Print the result as JSON', false)
     .addHelpText('after', dedent `
     Examples:
       $ agent-bolt sync
     `)
-    .action(async () => {
+    .action(async (option) => {
     const projectPath = process.cwd();
-    try {
-        const { SyncCommand } = await import('#catalog/commands/sync.js');
-        const command = new SyncCommand();
-        const result = command.execute(projectPath);
-        renderSyncResult(result);
+    const { SyncCommand } = await import('#catalog/commands/sync.js');
+    const command = new SyncCommand();
+    const result = command.execute(projectPath);
+    if (option.json) {
+        printJson(command.toJson(result));
     }
-    catch (e) {
-        const message = e instanceof Error ? e.message : String(e);
-        ConsoleOutput.error(message);
-        process.exit(1);
+    else {
+        renderSyncResult(result);
     }
 });
 program
     .command('check')
     .description('Check whether installed tools have drifted from the config')
+    .option('--json', 'Print the result as JSON', false)
     .addHelpText('after', dedent `
     Examples:
       $ agent-bolt check
     `)
-    .action(async () => {
+    .action(async (options) => {
     const projectPath = process.cwd();
-    try {
-        const { CheckCommand } = await import('#catalog/commands/check.js');
-        const command = new CheckCommand();
-        const { checkResult, drifted } = command.execute(projectPath);
+    const { CheckCommand } = await import('#catalog/commands/check.js');
+    const command = new CheckCommand();
+    const { checkResult, drifted } = command.execute(projectPath);
+    if (options.json) {
+        printJson(command.toJson({ checkResult, drifted }));
+    }
+    else {
         renderCheckResult(checkResult);
-        if (drifted) {
-            process.exitCode = 1;
-        }
     }
-    catch (e) {
-        const message = e instanceof Error ? e.message : String(e);
-        ConsoleOutput.error(message);
-        process.exit(1);
+    if (drifted) {
+        process.exitCode = 1;
+    }
+});
+const skill = program.command('skill').description('Manage the agent-bolt skill (install)');
+skill
+    .command('install')
+    .description('Install the agent-bolt skill into each selected tool')
+    .option('--json', 'Print the result as JSON', false)
+    .addHelpText('after', dedent `
+    Examples:
+      $ agent-bolt skill install
+    `)
+    .action(async (options) => {
+    const projectPath = process.cwd();
+    const { SkillInstallCommand } = await import('#catalog/commands/skill-install.js');
+    const command = new SkillInstallCommand();
+    const result = command.execute(projectPath, version);
+    if (options.json) {
+        printJson(command.toJson(result));
+    }
+    else {
+        renderSkillInstallResult(result);
     }
 });
 const catalog = program
@@ -297,6 +310,7 @@ catalog
     .command('validate')
     .description('Validate a catalog directory (structure, manifests, integrity)')
     .option('--dir <dir>', 'Catalog directory (default: current directory)')
+    .option('--json', 'Print the result as JSON', false)
     .addHelpText('after', dedent `
     Examples:
       $ agent-bolt catalog validate
@@ -306,19 +320,17 @@ catalog
     const { dir } = options;
     const projectPath = process.cwd();
     const catalogDirPath = dir ? path.resolve(projectPath, dir) : projectPath;
-    try {
-        const { ValidateCatalogCommand } = await import('#catalog/commands/catalog/validate-catalog.js');
-        const command = new ValidateCatalogCommand();
-        const { validateCatalogResult, invalid } = command.execute(catalogDirPath);
+    const { ValidateCatalogCommand } = await import('#catalog/commands/catalog/validate-catalog.js');
+    const command = new ValidateCatalogCommand();
+    const { validateCatalogResult, invalid } = command.execute(catalogDirPath);
+    if (options.json) {
+        printJson(command.toJson({ validateCatalogResult, invalid }));
+    }
+    else {
         renderValidateCatalogResult(validateCatalogResult);
-        if (invalid) {
-            process.exitCode = 1;
-        }
     }
-    catch (e) {
-        const message = e instanceof Error ? e.message : String(e);
-        ConsoleOutput.error(message);
-        process.exit(1);
+    if (invalid) {
+        process.exitCode = 1;
     }
 });
 catalog
@@ -327,6 +339,7 @@ catalog
     .option('--dir <dir>', 'Catalog directory (default: current directory)')
     .option('--name <name>', 'Catalog name (default: target directory name)')
     .option('--description <text>', 'Catalog description (default: a TODO placeholder)')
+    .option('--json', 'Print the result as JSON', false)
     .addHelpText('after', dedent `
     Examples:
       $ agent-bolt catalog init
@@ -336,16 +349,14 @@ catalog
     const { dir, name, description } = options;
     const projectPath = process.cwd();
     const catalogDir = dir ? path.resolve(projectPath, dir) : projectPath;
-    try {
-        const { InitCatalogCommand } = await import('#catalog/commands/catalog/init-catalog.js');
-        const command = new InitCatalogCommand({ name, description });
-        const result = command.execute(catalogDir);
-        renderInitCatalogResult(result, projectPath);
+    const { InitCatalogCommand } = await import('#catalog/commands/catalog/init-catalog.js');
+    const command = new InitCatalogCommand({ name, description });
+    const result = command.execute(catalogDir);
+    if (options.json) {
+        printJson(command.toJson(result));
     }
-    catch (e) {
-        const message = e instanceof Error ? e.message : String(e);
-        ConsoleOutput.error(message);
-        process.exit(1);
+    else {
+        renderInitCatalogResult(result, projectPath);
     }
 });
 catalog
@@ -353,6 +364,7 @@ catalog
     .description('Create a new pack skeleton (packs/<name>/pack.json)')
     .option('--dir <dir>', 'Catalog directory (default: current directory)')
     .option('--description <text>', 'Pack description (default: a TODO placeholder)')
+    .option('--json', 'Print the result as JSON', false)
     .addHelpText('after', dedent `
     Examples:
       $ agent-bolt catalog new-pack git-workflow
@@ -363,20 +375,18 @@ catalog
     const { dir, description } = options;
     const projectPath = process.cwd();
     const catalogDir = dir ? path.resolve(projectPath, dir) : projectPath;
-    try {
-        const { NewPackCommand } = await import('#catalog/commands/catalog/new-pack.js');
-        const command = new NewPackCommand({
-            name,
-            description,
-        });
-        const result = command.execute(catalogDir);
+    const { NewPackCommand } = await import('#catalog/commands/catalog/new-pack.js');
+    const command = new NewPackCommand({
+        name,
+        description,
+    });
+    const result = command.execute(catalogDir);
+    if (options.json) {
+        printJson(command.toJson(result));
+    }
+    else {
         renderNewPackResult(result, projectPath);
     }
-    catch (e) {
-        const message = e instanceof Error ? e.message : String(e);
-        ConsoleOutput.error(message);
-        process.exit(1);
-    }
 });
 catalog
     .command('new-skill <name>')
@@ -384,6 +394,7 @@ catalog
     .requiredOption('--pack <name>', 'Parent pack the skill belongs to (required)')
     .option('--dir <dir>', 'Catalog directory (default: current directory)')
     .option('--description <text>', 'Skill description (default: a TODO placeholder)')
+    .option('--json', 'Print the result as JSON', false)
     .addHelpText('after', dedent `
     Name:
       Lowercase letters, digits, and hyphens (kebab-case), e.g. create-commit.
@@ -397,21 +408,19 @@ catalog
     const { pack, dir, description } = options;
     const projectPath = process.cwd();
     const catalogDir = dir ? path.resolve(projectPath, dir) : projectPath;
-    try {
-        const { NewSkillCommand } = await import('#catalog/commands/catalog/new/new-skill.js');
-        const command = new NewSkillCommand({
-            pack,
-            name,
-            description,
-        });
-        const result = command.execute(catalogDir);
+    const { NewSkillCommand } = await import('#catalog/commands/catalog/new/new-skill.js');
+    const command = new NewSkillCommand({
+        pack,
+        name,
+        description,
+    });
+    const result = command.execute(catalogDir);
+    if (options.json) {
+        printJson(command.toJson(result));
+    }
+    else {
         renderNewSkillResult(result, projectPath);
     }
-    catch (e) {
-        const message = e instanceof Error ? e.message : String(e);
-        ConsoleOutput.error(message);
-        process.exit(1);
-    }
 });
 catalog
     .command('new-agent <name>')
@@ -419,6 +428,7 @@ catalog
     .requiredOption('--pack <name>', 'Parent pack the agent belongs to (required)')
     .option('--dir <dir>', 'Catalog directory (default: current directory)')
     .option('--description <text>', 'Agent description (default: a TODO placeholder)')
+    .option('--json', 'Print the result as JSON', false)
     .addHelpText('after', dedent `
     Name:
       Lowercase letters, digits, and hyphens (kebab-case), e.g. code-reviewer.
@@ -431,16 +441,14 @@ catalog
     const { pack, dir, description } = options;
     const projectPath = process.cwd();
     const catalogDir = dir ? path.resolve(projectPath, dir) : projectPath;
-    try {
-        const { NewAgentCommand } = await import('#catalog/commands/catalog/new/new-agent.js');
-        const command = new NewAgentCommand({ pack, name, description });
-        const result = command.execute(catalogDir);
-        renderNewAgentResult(result, projectPath);
+    const { NewAgentCommand } = await import('#catalog/commands/catalog/new/new-agent.js');
+    const command = new NewAgentCommand({ pack, name, description });
+    const result = command.execute(catalogDir);
+    if (options.json) {
+        printJson(command.toJson(result));
     }
-    catch (e) {
-        const message = e instanceof Error ? e.message : String(e);
-        ConsoleOutput.error(message);
-        process.exit(1);
+    else {
+        renderNewAgentResult(result, projectPath);
     }
 });
 catalog
@@ -449,6 +457,7 @@ catalog
     .requiredOption('--pack <name>', 'Parent pack the guideline belongs to (required)')
     .option('--dir <dir>', 'Catalog directory (default: current directory)')
     .option('--description <text>', 'Guideline description (default: a TODO placeholder)')
+    .option('--json', 'Print the result as JSON', false)
     .addHelpText('after', dedent `
     Name:
       Lowercase letters, digits, and hyphens (kebab-case), e.g. commit-rules.
@@ -461,17 +470,31 @@ catalog
     const { pack, dir, description } = options;
     const projectPath = process.cwd();
     const catalogDir = dir ? path.resolve(projectPath, dir) : projectPath;
-    try {
-        const { NewGuidelineCommand } = await import('#catalog/commands/catalog/new/new-guideline.js');
-        const command = new NewGuidelineCommand({ pack, name, description });
-        const result = command.execute(catalogDir);
+    const { NewGuidelineCommand } = await import('#catalog/commands/catalog/new/new-guideline.js');
+    const command = new NewGuidelineCommand({ pack, name, description });
+    const result = command.execute(catalogDir);
+    if (options.json) {
+        printJson(command.toJson(result));
+    }
+    else {
         renderNewGuidelineResult(result, projectPath);
     }
-    catch (e) {
+});
+let jsonMode = false;
+program.hook('preAction', (_thisCommand, actionCommand) => {
+    jsonMode = actionCommand.opts().json ?? false;
+});
+try {
+    await program.parseAsync();
+}
+catch (e) {
+    if (jsonMode) {
+        printJsonError(e);
+    }
+    else {
         const message = e instanceof Error ? e.message : String(e);
         ConsoleOutput.error(message);
-        process.exit(1);
     }
-});
-program.parse();
+    process.exitCode = 1;
+}
 //# sourceMappingURL=index.js.map