@train860/harness 0.1.0

package/bin/harness

@@ -0,0 +1,185 @@
+#!/usr/bin/env node
+
+import childProcess from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import process from 'node:process';
+
+const DEFAULT_SOURCE_REPO = 'train860/harness';
+const DEFAULT_DISTRIBUTION = 'npm-public-github-private';
+
+function readArgs(argv) {
+  const positional = [];
+  const options = {};
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const key = argv[index];
+    if (!key.startsWith('--')) {
+      positional.push(key);
+      continue;
+    }
+
+    options[key.slice(2)] = argv[index + 1];
+    index += 1;
+  }
+
+  return { positional, options };
+}
+
+function run(command, args, options = {}) {
+  const result = childProcess.spawnSync(command, args, {
+    encoding: 'utf8',
+    ...options,
+  });
+
+  if (result.stdout) {
+    process.stdout.write(result.stdout);
+  }
+
+  if (result.stderr) {
+    process.stderr.write(result.stderr);
+  }
+
+  if (result.status !== 0) {
+    process.exit(result.status ?? 1);
+  }
+}
+
+function requireValue(value, message) {
+  if (value) {
+    return value;
+  }
+  console.error(message);
+  process.exit(1);
+}
+
+function ensureSourceRepo(options, cwd) {
+  if (options['source-repo']) {
+    return path.resolve(options['source-repo']);
+  }
+
+  const repo = options.repo ?? DEFAULT_SOURCE_REPO;
+  const ref = options.ref ?? 'main';
+  const cacheDir = options['cache-dir']
+    ? path.resolve(options['cache-dir'])
+    : path.join(os.tmpdir(), 'harness-cache', repo.replace(/[\\/]/g, '-'));
+
+  if (fs.existsSync(path.join(cacheDir, '.git'))) {
+    run('git', ['-C', cacheDir, 'fetch', '--tags', 'origin'], { cwd });
+  } else {
+    fs.mkdirSync(path.dirname(cacheDir), { recursive: true });
+    run('gh', ['repo', 'clone', repo, cacheDir], { cwd });
+  }
+
+  run('git', ['-C', cacheDir, 'checkout', ref], { cwd });
+  return cacheDir;
+}
+
+function readSourceVersion(sourceRepo) {
+  const packageJson = JSON.parse(fs.readFileSync(path.join(sourceRepo, 'package.json'), 'utf8'));
+  return packageJson.version ?? '0.1.0-dev';
+}
+
+function readSourceCommit(sourceRepo) {
+  const result = childProcess.spawnSync('git', ['-C', sourceRepo, 'rev-parse', 'HEAD'], {
+    encoding: 'utf8',
+  });
+  return result.status === 0 ? result.stdout.trim() : 'unknown';
+}
+
+function usage() {
+  console.error([
+    'Usage:',
+    '  harness init [target-dir] --package-scope <scope> --go-module-prefix <prefix> [--project-name <name>] [--repo <org/repo> | --source-repo <path>] [--ref <git-ref>] [--cache-dir <dir>] [--app-names-file <json-file>]',
+    '  harness upgrade [--project-root <dir>] [--repo <org/repo> | --source-repo <path>] [--ref <git-ref>] [--cache-dir <dir>]',
+    '',
+    `Default GitHub source repo: ${DEFAULT_SOURCE_REPO}`,
+  ].join('\n'));
+  process.exit(1);
+}
+
+function commandInit(argv) {
+  const cwd = process.cwd();
+  const { positional, options } = readArgs(argv);
+  const targetDir = options['target-dir'] ?? positional[0];
+  const resolvedTargetDir = requireValue(
+    targetDir ? path.resolve(targetDir) : null,
+    'Usage error: missing target directory for `harness init`.',
+  );
+  requireValue(options['package-scope'], 'Usage error: missing --package-scope for `harness init`.');
+  requireValue(options['go-module-prefix'], 'Usage error: missing --go-module-prefix for `harness init`.');
+
+  const sourceRepo = ensureSourceRepo(options, cwd);
+  const projectName = options['project-name'] ?? path.basename(resolvedTargetDir);
+  const createArgs = [
+    path.join(sourceRepo, 'packages/create-ai-native-scaffold/bin/create-ai-native-scaffold.mjs'),
+    '--project-name',
+    projectName,
+    '--package-scope',
+    options['package-scope'],
+    '--go-module-prefix',
+    options['go-module-prefix'],
+    '--target-dir',
+    resolvedTargetDir,
+    '--scaffold-repo',
+    options.repo ?? DEFAULT_SOURCE_REPO,
+    '--scaffold-version',
+    readSourceVersion(sourceRepo),
+    '--scaffold-commit',
+    readSourceCommit(sourceRepo),
+    '--scaffold-distribution',
+    DEFAULT_DISTRIBUTION,
+  ];
+
+  if (options['app-names-file']) {
+    createArgs.push('--app-names-file', path.resolve(options['app-names-file']));
+  }
+
+  run(process.execPath, createArgs, { cwd: sourceRepo });
+}
+
+function commandUpgrade(argv) {
+  const cwd = process.cwd();
+  const { options } = readArgs(argv);
+  const projectRoot = path.resolve(options['project-root'] ?? cwd);
+  const upgradeScript = path.join(projectRoot, 'scripts/scaffold/upgrade.mjs');
+
+  requireValue(fs.existsSync(upgradeScript) ? upgradeScript : null, [
+    'Usage error: missing generated scaffold upgrade script.',
+    'Run `harness upgrade --project-root <generated-project>` from a scaffolded repo or pass --project-root.',
+  ].join('\n'));
+
+  const forwardedArgs = [];
+
+  if (options['source-repo']) {
+    forwardedArgs.push('--source-repo', path.resolve(options['source-repo']));
+  } else {
+    forwardedArgs.push('--repo', options.repo ?? DEFAULT_SOURCE_REPO);
+  }
+
+  if (options.ref) {
+    forwardedArgs.push('--ref', options.ref);
+  }
+
+  if (options['cache-dir']) {
+    forwardedArgs.push('--cache-dir', path.resolve(options['cache-dir']));
+  }
+
+  run(process.execPath, [upgradeScript, ...forwardedArgs], { cwd: projectRoot });
+}
+
+const [command, ...rest] = process.argv.slice(2);
+
+if (!command || command === '--help' || command === '-h') {
+  usage();
+}
+
+if (command === 'init') {
+  commandInit(rest);
+} else if (command === 'upgrade') {
+  commandUpgrade(rest);
+} else {
+  console.error(`Unknown command: ${command}`);
+  usage();
+}

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@train860/harness",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Public bootstrap CLI for the private AI-native scaffold source repo.",
+  "directories": {
+    "bin": "./bin"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "bin"
+  ]
+}