api-to-cli 0.1.1

package/examples/trello/trelloapi-agent/cli/lib/client.js

@@ -0,0 +1,90 @@
+async function request(command, options) {
+  const auth = {
+  "credentials": [
+    {
+      "envVar": "TRELLO_KEY",
+      "in": "query",
+      "name": "key"
+    },
+    {
+      "envVar": "TRELLO_TOKEN",
+      "in": "query",
+      "name": "token"
+    }
+  ]
+};
+  const params = new URLSearchParams();
+  const commandParams = command.params || {};
+  let resolvedPath = command.path;
+  const headers = {
+    accept: 'application/json'
+  };
+
+  (auth.credentials || []).forEach((credential) => {
+    const envValue = process.env[credential.envVar];
+
+    if (!envValue) {
+      throw new Error(`Missing required auth environment variable: ${credential.envVar}`);
+    }
+
+    const authValue = credential.prefix ? `${credential.prefix}${envValue}` : envValue;
+
+    if (credential.in === 'header') {
+      headers[credential.name] = authValue;
+      return;
+    }
+
+    params.append(credential.name, authValue);
+  });
+
+  Object.entries(commandParams).forEach(([name, schema]) => {
+    const value = options[name];
+
+    if ((value === undefined || value === null || value === '') && schema.required) {
+      throw new Error(`Missing required parameter: --${name}`);
+    }
+
+    if (value === undefined || value === null || value === '') {
+      return;
+    }
+
+    const token = `{${name}}`;
+
+    if (resolvedPath.includes(token)) {
+      resolvedPath = resolvedPath.replaceAll(token, encodeURIComponent(String(value)));
+      return;
+    }
+
+    params.append(name, String(value));
+  });
+
+  const query = params.toString();
+  const url = 'https://api.trello.com/1' + resolvedPath + (query ? '?' + query : '');
+
+  const response = await fetch(url, {
+    method: command.method,
+    headers
+  });
+
+  const text = await response.text();
+  let body = text;
+
+  try {
+    body = text ? JSON.parse(text) : null;
+  } catch (_err) {
+    body = text;
+  }
+
+  if (!response.ok) {
+    const error = new Error(`HTTP ${response.status}`);
+    error.statusCode = response.status;
+    error.responseBody = body;
+    throw error;
+  }
+
+  return body;
+}
+
+module.exports = {
+  request
+};

package/examples/trello/trelloapi-agent/cli/lib/output.js

@@ -0,0 +1,21 @@
+function json(data, pretty) {
+  const text = pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data);
+  process.stdout.write(text + '\n');
+}
+
+function error(payload, pretty) {
+  const envelope = {
+    error: true,
+    code: payload.code || 'REQUEST_FAILED',
+    message: payload.message || 'Request failed',
+    details: payload.details || {}
+  };
+
+  const text = pretty ? JSON.stringify(envelope, null, 2) : JSON.stringify(envelope);
+  process.stderr.write(text + '\n');
+}
+
+module.exports = {
+  json,
+  error
+};

package/examples/trello/trelloapi-agent/cli/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "trelloapi-cli",
+  "version": "1.0.0",
+  "description": "trelloapi CLI generated by AgentBridge",
+  "license": "MIT",
+  "type": "commonjs",
+  "bin": {
+    "trelloapi": "./bin/trelloapi.js"
+  },
+  "scripts": {
+    "start": "node ./bin/trelloapi.js"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  }
+}

package/examples/trello/trelloapi-agent/skill/SKILL.md

@@ -0,0 +1,34 @@
+# trelloapi CLI Skill
+
+## Purpose
+Use the generated trelloapi CLI from AgentBridge. Always prefer JSON output for machine parsing.
+
+## Location
+- CLI project: ./cli
+- Binary name: trelloapi
+
+## Setup
+1. cd ./cli
+2. npm install
+3. npm link
+
+## Auth
+- export TRELLO_KEY="<value>"
+- export TRELLO_TOKEN="<value>"
+
+## Commands
+- get-board: Get a board by ID
+  - --board-id <value> (required)
+  - example: trelloapi get-board --board-id <value>
+- list-board-lists: List lists on a board
+  - --board-id <value> (required)
+  - example: trelloapi list-board-lists --board-id <value>
+- list-list-cards: List cards in a list
+  - --list-id <value> (required)
+  - example: trelloapi list-list-cards --list-id <value>
+
+## Rules
+- Do not echo or log auth secrets.
+- Do not pass credentials as command flags.
+- Parse command stdout as JSON.
+- Treat non-zero exits as failure and read stderr JSON envelope.

package/examples/trello/trelloapi-cli/README.md

@@ -0,0 +1,25 @@
+# trelloapi CLI
+
+Generated by AgentBridge (api-to-cli).
+
+## Install
+
+```bash
+npm install
+npm link
+```
+
+## Auth
+
+Set required environment variables before running commands:
+
+- `TRELLO_KEY`
+- `TRELLO_TOKEN`
+
+Do not pass secrets as command flags.
+
+## Commands
+
+- `trelloapi get-board` - Get a board by ID
+- `trelloapi list-board-lists` - List lists on a board
+- `trelloapi list-list-cards` - List cards in a list

package/examples/trello/trelloapi-cli/bin/trelloapi.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+
+const { Command } = require('commander');
+
+const cmd0 = require('../commands/get-board');
+const cmd1 = require('../commands/list-board-lists');
+const cmd2 = require('../commands/list-list-cards');
+
+const program = new Command();
+
+program
+  .name('trelloapi')
+  .description('trelloapi CLI generated by AgentBridge')
+  .version('1.0.0');
+
+program
+  .command('get-board')
+  .description('Get a board by ID')
+  .option('--board-id <value>', 'Trello board ID')
+  .option('--pretty', 'Pretty-print JSON')
+  .action((options) => cmd0.run(options));
+
+program
+  .command('list-board-lists')
+  .description('List lists on a board')
+  .option('--board-id <value>', 'Trello board ID')
+  .option('--pretty', 'Pretty-print JSON')
+  .action((options) => cmd1.run(options));
+
+program
+  .command('list-list-cards')
+  .description('List cards in a list')
+  .option('--list-id <value>', 'Trello list ID')
+  .option('--pretty', 'Pretty-print JSON')
+  .action((options) => cmd2.run(options));
+
+program.parse(process.argv);

package/examples/trello/trelloapi-cli/commands/get-board.js

@@ -0,0 +1,41 @@
+const { request } = require('../lib/client');
+const output = require('../lib/output');
+
+const command = {
+  "name": "get-board",
+  "description": "Get a board by ID",
+  "method": "GET",
+  "path": "/boards/{boardId}",
+  "params": {
+    "boardId": {
+      "type": "string",
+      "required": true,
+      "description": "Trello board ID"
+    }
+  }
+};
+
+async function getBoard(options) {
+  try {
+    const data = await request(command, options);
+    output.json(data, Boolean(options.pretty));
+  } catch (error) {
+    output.error(
+      {
+        code: error.statusCode ? 'HTTP_ERROR' : 'REQUEST_FAILED',
+        message: error.message,
+        details: {
+          statusCode: error.statusCode || null,
+          command: command.name
+        }
+      },
+      Boolean(options.pretty)
+    );
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  run: getBoard,
+  command
+};

package/examples/trello/trelloapi-cli/commands/list-board-lists.js

@@ -0,0 +1,41 @@
+const { request } = require('../lib/client');
+const output = require('../lib/output');
+
+const command = {
+  "name": "list-board-lists",
+  "description": "List lists on a board",
+  "method": "GET",
+  "path": "/boards/{boardId}/lists",
+  "params": {
+    "boardId": {
+      "type": "string",
+      "required": true,
+      "description": "Trello board ID"
+    }
+  }
+};
+
+async function listBoardLists(options) {
+  try {
+    const data = await request(command, options);
+    output.json(data, Boolean(options.pretty));
+  } catch (error) {
+    output.error(
+      {
+        code: error.statusCode ? 'HTTP_ERROR' : 'REQUEST_FAILED',
+        message: error.message,
+        details: {
+          statusCode: error.statusCode || null,
+          command: command.name
+        }
+      },
+      Boolean(options.pretty)
+    );
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  run: listBoardLists,
+  command
+};

package/examples/trello/trelloapi-cli/commands/list-list-cards.js

@@ -0,0 +1,41 @@
+const { request } = require('../lib/client');
+const output = require('../lib/output');
+
+const command = {
+  "name": "list-list-cards",
+  "description": "List cards in a list",
+  "method": "GET",
+  "path": "/lists/{listId}/cards",
+  "params": {
+    "listId": {
+      "type": "string",
+      "required": true,
+      "description": "Trello list ID"
+    }
+  }
+};
+
+async function listListCards(options) {
+  try {
+    const data = await request(command, options);
+    output.json(data, Boolean(options.pretty));
+  } catch (error) {
+    output.error(
+      {
+        code: error.statusCode ? 'HTTP_ERROR' : 'REQUEST_FAILED',
+        message: error.message,
+        details: {
+          statusCode: error.statusCode || null,
+          command: command.name
+        }
+      },
+      Boolean(options.pretty)
+    );
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  run: listListCards,
+  command
+};

package/examples/trello/trelloapi-cli/lib/client.js

@@ -0,0 +1,90 @@
+async function request(command, options) {
+  const auth = {
+  "credentials": [
+    {
+      "envVar": "TRELLO_KEY",
+      "in": "query",
+      "name": "key"
+    },
+    {
+      "envVar": "TRELLO_TOKEN",
+      "in": "query",
+      "name": "token"
+    }
+  ]
+};
+  const params = new URLSearchParams();
+  const commandParams = command.params || {};
+  let resolvedPath = command.path;
+  const headers = {
+    accept: 'application/json'
+  };
+
+  (auth.credentials || []).forEach((credential) => {
+    const envValue = process.env[credential.envVar];
+
+    if (!envValue) {
+      throw new Error(`Missing required auth environment variable: ${credential.envVar}`);
+    }
+
+    const authValue = credential.prefix ? `${credential.prefix}${envValue}` : envValue;
+
+    if (credential.in === 'header') {
+      headers[credential.name] = authValue;
+      return;
+    }
+
+    params.append(credential.name, authValue);
+  });
+
+  Object.entries(commandParams).forEach(([name, schema]) => {
+    const value = options[name];
+
+    if ((value === undefined || value === null || value === '') && schema.required) {
+      throw new Error(`Missing required parameter: --${name}`);
+    }
+
+    if (value === undefined || value === null || value === '') {
+      return;
+    }
+
+    const token = `{${name}}`;
+
+    if (resolvedPath.includes(token)) {
+      resolvedPath = resolvedPath.replaceAll(token, encodeURIComponent(String(value)));
+      return;
+    }
+
+    params.append(name, String(value));
+  });
+
+  const query = params.toString();
+  const url = 'https://api.trello.com/1' + resolvedPath + (query ? '?' + query : '');
+
+  const response = await fetch(url, {
+    method: command.method,
+    headers
+  });
+
+  const text = await response.text();
+  let body = text;
+
+  try {
+    body = text ? JSON.parse(text) : null;
+  } catch (_err) {
+    body = text;
+  }
+
+  if (!response.ok) {
+    const error = new Error(`HTTP ${response.status}`);
+    error.statusCode = response.status;
+    error.responseBody = body;
+    throw error;
+  }
+
+  return body;
+}
+
+module.exports = {
+  request
+};

package/examples/trello/trelloapi-cli/lib/output.js

@@ -0,0 +1,21 @@
+function json(data, pretty) {
+  const text = pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data);
+  process.stdout.write(text + '\n');
+}
+
+function error(payload, pretty) {
+  const envelope = {
+    error: true,
+    code: payload.code || 'REQUEST_FAILED',
+    message: payload.message || 'Request failed',
+    details: payload.details || {}
+  };
+
+  const text = pretty ? JSON.stringify(envelope, null, 2) : JSON.stringify(envelope);
+  process.stderr.write(text + '\n');
+}
+
+module.exports = {
+  json,
+  error
+};

package/examples/trello/trelloapi-cli/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "trelloapi-cli",
+  "version": "1.0.0",
+  "description": "trelloapi CLI generated by AgentBridge",
+  "license": "MIT",
+  "type": "commonjs",
+  "bin": {
+    "trelloapi": "./bin/trelloapi.js"
+  },
+  "scripts": {
+    "start": "node ./bin/trelloapi.js"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  }
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "api-to-cli",
+  "version": "0.1.1",
+  "description": "Generate AI-agent-friendly CLIs, skills, and manifests from API configs",
+  "license": "MIT",
+  "type": "commonjs",
+  "bin": {
+    "api-to-cli": "./bin/api-to-cli.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "examples",
+    "README.md",
+    "LICENSE",
+    "PROJECT_BRIEF.md",
+    "SPEC.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RandyVentures/AgentBridge.git"
+  },
+  "bugs": {
+    "url": "https://github.com/RandyVentures/AgentBridge/issues"
+  },
+  "homepage": "https://github.com/RandyVentures/AgentBridge#readme",
+  "keywords": [
+    "cli",
+    "api",
+    "ai-agent",
+    "generator",
+    "mcp",
+    "developer-tools"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "validate:trello": "node ./bin/api-to-cli.js validate --config ./examples/trello/api-to-cli.config.js",
+    "generate:trello": "node ./bin/api-to-cli.js generate --config ./examples/trello/api-to-cli.config.js --output ./examples/trello/trelloapi-cli",
+    "scaffold:trello": "node ./bin/api-to-cli.js scaffold --config ./examples/trello/api-to-cli.config.js --output ./examples/trello/trelloapi-agent",
+    "test:smoke": "npm run validate:trello && npm run generate:trello && npm run scaffold:trello",
+    "pack:check": "npm pack --dry-run"
+  }
+}

package/src/commands/generate.js

@@ -0,0 +1,36 @@
+const path = require('path');
+const { loadConfig } = require('../lib/load-config');
+const { generateCliProject } = require('../lib/generate-cli');
+
+async function generate(flags) {
+  if (!flags.config) {
+    throw new Error('Missing required flag: --config <path>');
+  }
+
+  if (!flags.output) {
+    throw new Error('Missing required flag: --output <dir>');
+  }
+
+  const configPath = path.resolve(process.cwd(), String(flags.config));
+  const outputPath = path.resolve(process.cwd(), String(flags.output));
+
+  const config = loadConfig(configPath);
+
+  generateCliProject({
+    config,
+    outputPath
+  });
+
+  console.log(
+    JSON.stringify({
+      ok: true,
+      command: 'generate',
+      outputPath,
+      generatedCommands: config.commands.map((command) => command.name)
+    })
+  );
+}
+
+module.exports = {
+  generate
+};

package/src/commands/scaffold.js

@@ -0,0 +1,110 @@
+const fs = require('fs');
+const path = require('path');
+const { loadConfig } = require('../lib/load-config');
+const { generateCliProject } = require('../lib/generate-cli');
+const { writeSkillPackage } = require('../lib/generate-skill');
+const { buildManifest, writeManifest } = require('../lib/generate-manifest');
+
+function hasOwn(obj, key) {
+  return Object.prototype.hasOwnProperty.call(obj, key);
+}
+
+function resolveArtifactFlags(flags) {
+  const hasSkill = hasOwn(flags, 'with-skill');
+  const hasManifest = hasOwn(flags, 'with-manifest');
+
+  if (!hasSkill && !hasManifest) {
+    return {
+      withSkill: true,
+      withManifest: true
+    };
+  }
+
+  return {
+    withSkill: Boolean(flags['with-skill']),
+    withManifest: Boolean(flags['with-manifest'])
+  };
+}
+
+function writeScaffoldReadme(outputPath, data) {
+  const lines = [
+    '# AgentBridge Scaffold Output',
+    '',
+    '## Contents',
+    `- CLI project: ${data.cliProjectPath}`
+  ];
+
+  if (data.skillPath) {
+    lines.push(`- Skill file: ${data.skillPath}`);
+  }
+
+  if (data.manifestPath) {
+    lines.push(`- Manifest: ${data.manifestPath}`);
+  }
+
+  lines.push('', '## Next Steps', '1. cd ./cli', '2. npm install', '3. npm link');
+
+  fs.writeFileSync(path.join(outputPath, 'README.md'), `${lines.join('\n')}\n`, 'utf8');
+}
+
+async function scaffold(flags) {
+  if (!flags.config) {
+    throw new Error('Missing required flag: --config <path>');
+  }
+
+  if (!flags.output) {
+    throw new Error('Missing required flag: --output <dir>');
+  }
+
+  const { withSkill, withManifest } = resolveArtifactFlags(flags);
+  const cliRelativePath = './cli';
+  const skillRelativePath = './skill/SKILL.md';
+  const manifestRelativePath = './agentbridge.manifest.json';
+
+  const configPath = path.resolve(process.cwd(), String(flags.config));
+  const outputPath = path.resolve(process.cwd(), String(flags.output));
+  const cliProjectPath = path.join(outputPath, 'cli');
+
+  const config = loadConfig(configPath);
+  fs.mkdirSync(outputPath, { recursive: true });
+
+  generateCliProject({
+    config,
+    outputPath: cliProjectPath
+  });
+
+  let skillPath = null;
+  if (withSkill) {
+    writeSkillPackage(outputPath, config, cliRelativePath);
+    skillPath = skillRelativePath;
+  }
+
+  let manifestPath = null;
+  if (withManifest) {
+    const manifest = buildManifest(config, cliRelativePath, skillPath);
+    writeManifest(outputPath, manifest);
+    manifestPath = manifestRelativePath;
+  }
+
+  writeScaffoldReadme(outputPath, {
+    cliProjectPath: cliRelativePath,
+    skillPath,
+    manifestPath
+  });
+
+  console.log(
+    JSON.stringify({
+      ok: true,
+      command: 'scaffold',
+      outputPath,
+      cliProjectPath: cliRelativePath,
+      skillPath,
+      manifestPath,
+      generatedCommands: config.commands.map((command) => command.name)
+    })
+  );
+}
+
+module.exports = {
+  scaffold
+};