itiger 0.1.0

package/README.md

@@ -0,0 +1,28 @@
+# itiger
+
+`itiger` is a thin command adapter for internal development tools. It delegates
+all work to the locally installed CLIs and never stores or manages credentials.
+
+```bash
+npx itiger skills add fed/skills
+npx itiger install -g @tiger/example
+```
+
+`skills add owner/repo` is translated to
+`https://git.tigerbrokers.net/owner/repo.git`; Git authentication remains under
+the user's normal SSH keys or Git credential helper. Other `skills` arguments
+and output are passed through unchanged.
+
+When installing an `@tiger/*` package, `itiger` adds
+`--@tiger:registry=http://r.npm.tigerfintech.com` unless `--registry` or an
+explicit `--@tiger:registry` option is already present. Non-Tiger packages are
+delegated without registry changes.
+
+Requirements: Node.js 18 or newer, plus the local `skills` CLI for `skills`
+commands and npm for package installation.
+
+## Development
+
+```bash
+npm test
+```

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "itiger",
+  "version": "0.1.0",
+  "description": "A thin adapter for internal skills and @tiger npm packages.",
+  "type": "commonjs",
+  "bin": {
+    "itiger": "src/cli.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "src"
+  ],
+  "scripts": {
+    "test": "node --test"
+  },
+  "license": "UNLICENSED"
+}

package/src/cli.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+
+const { runSkills } = require('./skills-adapter');
+const { runNpm } = require('./npm-adapter');
+
+async function main() {
+  const args = process.argv.slice(2);
+  if (args[0] === 'skills') {
+    return runSkills(args.slice(1));
+  }
+  if (args[0] === 'install' || args[0] === 'i') {
+    return runNpm(args);
+  }
+
+  process.stderr.write('Usage: itiger skills add <owner/repo> [skills options...]\n');
+  process.stderr.write('       itiger install [npm options...] <package...>\n');
+  return 2;
+}
+
+main()
+  .then((code) => {
+    if (code !== 0) process.exitCode = code;
+  })
+  .catch((error) => {
+    process.stderr.write(`itiger: ${error.message}\n`);
+    process.exitCode = 1;
+  });

package/src/npm-adapter.js

@@ -0,0 +1,27 @@
+const { runCommand } = require('./process');
+
+const TIGER_REGISTRY = 'http://r.npm.tigerfintech.com';
+
+function hasExplicitRegistry(args) {
+  return args.some((arg, index) => (
+    arg === '--registry' ||
+    arg.startsWith('--registry=') ||
+    arg.startsWith('--@tiger:registry=') ||
+    (arg === '--@tiger:registry' && index + 1 < args.length)
+  ));
+}
+
+function hasTigerPackage(args) {
+  return args.some((arg) => /^@tiger\/[^/]+$/.test(arg));
+}
+
+function transformArgs(args) {
+  if (!hasTigerPackage(args) || hasExplicitRegistry(args)) return [...args];
+  return [...args, `--@tiger:registry=${TIGER_REGISTRY}`];
+}
+
+function runNpm(args) {
+  return runCommand('npm', transformArgs(args));
+}
+
+module.exports = { TIGER_REGISTRY, hasExplicitRegistry, hasTigerPackage, transformArgs, runNpm };

package/src/process.js

@@ -0,0 +1,28 @@
+const { spawn } = require('node:child_process');
+
+function runCommand(command, args) {
+  return new Promise((resolve) => {
+    let child;
+    try {
+      child = spawn(command, args, { stdio: 'inherit' });
+    } catch (error) {
+      process.stderr.write(`itiger: unable to start ${command}: ${error.message}\n`);
+      resolve(1);
+      return;
+    }
+
+    child.on('error', (error) => {
+      process.stderr.write(`itiger: unable to start ${command}: ${error.message}\n`);
+      resolve(1);
+    });
+    child.on('exit', (code, signal) => {
+      resolve(code === null ? 128 + signalNumber(signal) : code);
+    });
+  });
+}
+
+function signalNumber(signal) {
+  return { SIGINT: 2, SIGTERM: 15, SIGHUP: 1 }[signal] || 1;
+}
+
+module.exports = { runCommand };

package/src/skills-adapter.js

@@ -0,0 +1,38 @@
+const { runCommand } = require('./process');
+
+const INTERNAL_GIT_HOST = 'git.tigerbrokers.net';
+
+function mapRepository(repository) {
+  const githubUrl = repository.match(/^https?:\/\/(?:www\.)?github\.com\/([^/]+)\/([^/#?]+?)(?:\.git)?\/?$/i);
+  if (githubUrl) {
+    return `https://${INTERNAL_GIT_HOST}/${githubUrl[1]}/${githubUrl[2]}.git`;
+  }
+
+  const shorthand = repository.match(/^([^/]+)\/([^/]+)$/);
+  if (shorthand) {
+    return `https://${INTERNAL_GIT_HOST}/${shorthand[1]}/${shorthand[2]}.git`;
+  }
+
+  return repository;
+}
+
+function transformArgs(args) {
+  const transformed = [...args];
+  if (transformed[0] !== 'add') return transformed;
+
+  const repositoryIndex = transformed.findIndex((arg, index) => index > 0 && !arg.startsWith('-'));
+  if (repositoryIndex !== -1) {
+    transformed[repositoryIndex] = mapRepository(transformed[repositoryIndex]);
+  }
+  return transformed;
+}
+
+function runSkills(args) {
+  if (args.length === 0 || args[0] !== 'add') {
+    process.stderr.write('itiger: only "skills add" is supported through this adapter\n');
+    return Promise.resolve(2);
+  }
+  return runCommand('skills', transformArgs(args));
+}
+
+module.exports = { INTERNAL_GIT_HOST, mapRepository, transformArgs, runSkills };