Class Terminal

CLI command execution runtime using Wings routing system.

Architecture: Transform CLI args → Context → Router → terminal output. Same routes handle HTTP requests and CLI commands through unified abstractions.

Context Mapping:

• CLI args → URL via ArgsToUrl transformation
• stdin data → requestBody (Unix pipe support)
• responseBody → stdout content
• responseStatusCode → exit code (200-299=0, else=1)
• COMMAND method enables route reuse

Performance: Zero overhead abstraction—direct Node.js I/O primitives. Async stdin reading supports interactive patterns without blocking.

import { Router } from '@raven-js/wings/core';
import { Terminal } from '@raven-js/wings/terminal';

const router = new Router();
router.cmd('/git/status', (ctx) => ctx.text('Clean working tree'));
router.cmd('/git/commit', async (ctx) => {
  const msg = ctx.queryParams.get('message');
  if (!msg) return ctx.status(400).text('Missing message');
  await performCommit(msg);
  ctx.text('✅ Committed');
});

await new Terminal(router).run(process.argv.slice(2));
Copy