@tamfitronics/tamcoder 0.0.0-stage → 0.1.89

package/README.md

@@ -1,3 +1,30 @@
-# Temporary Holding Version
+# @tamfitronics/tamcoder
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Tamcoder – TypeScript AI coding-agent runtime, packaged for npm.
+
+## Install
+
+```bash
+npm install -g @tamfitronics/tamcoder
+```
+
+## Usage
+
+```bash
+tamcoder --version
+tamcoder --help
+```
+
+## How it works
+
+This npm package contains a small installer. On `npm install` it downloads the
+official TypeScript release from `https://gpt.tamfitronics.com/tamcoder`,
+verifies its SHA-256 checksum, and extracts it into
+`~/.local/share/tamcoder/releases/<version>`. The `tamcoder` and `tamcoder-bin`
+binaries are symlinked into `~/.local/bin`.
+
+## Environment variables
+
+- `TAMCODER_RELEASE_BASE` – override the download URL base
+- `TAMCODER_INSTALL_PREFIX` – default `~/.local`
+- `TAMCODER_LOCAL_RELEASE_ROOT` – install from a local directory instead of the network

package/bin/tamcoder.mjs

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { existsSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import { spawnSync } from 'child_process';
+import { fileURLToPath } from 'url';
+
+const version = '0.1.10-ts';
+const prefix = process.env.TAMCODER_INSTALL_PREFIX || join(homedir(), '.local');
+const releaseDir = join(prefix, 'share', 'tamcoder', 'releases', version);
+const binary = join(releaseDir, 'app', 'bin', 'tamcoder');
+
+if (!existsSync(binary)) {
+  console.error('tamcoder: engine not installed. Run "npm install" in the package directory, or reinstall @tamfitronics/tamcoder.');
+  process.exit(1);
+}
+
+const result = spawnSync(binary, process.argv.slice(2), {
+  stdio: 'inherit',
+  shell: false,
+  env: process.env
+});
+process.exit(result.status ?? 1);

package/index.mjs

@@ -0,0 +1 @@
+export { install as default, verify } from './install.mjs';

package/install.mjs

@@ -0,0 +1,150 @@
+#!/usr/bin/env node
+import { createWriteStream, existsSync, mkdirSync, readFileSync, symlinkSync, unlinkSync, chmodSync, writeFileSync } from 'fs';
+import { createHash } from 'crypto';
+import { homedir } from 'os';
+import { dirname, join, resolve } from 'path';
+import { Readable } from 'stream';
+import { finished } from 'stream/promises';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, 'package.json'), 'utf8'));
+const version = pkg.version; // npm package version (metadata only)
+const platform = 'linux-x64';
+let resolvedAsset = null;
+const base = process.env.TAMCODER_RELEASE_BASE || 'https://gpt.tamfitronics.com/tamcoder';
+const prefix = process.env.TAMCODER_INSTALL_PREFIX || join(homedir(), '.local');
+const releaseDir = join(prefix, 'share', 'tamcoder', 'releases', version);
+const binDir = join(prefix, 'bin');
+const localReleaseRoot = process.env.TAMCODER_LOCAL_RELEASE_ROOT;
+
+async function resolveAsset() {
+  if (resolvedAsset) return resolvedAsset;
+  if (localReleaseRoot) {
+    const latest = JSON.parse(await fetchText(`${base}/latest.json`));
+    resolvedAsset = latest.asset || `tamcoder-${latest.version}-${platform}.tar.gz`;
+    return resolvedAsset;
+  }
+  const latest = JSON.parse(await fetchText(`${base}/latest.json`));
+  resolvedAsset = latest.asset || `tamcoder-${latest.version}-${platform}.tar.gz`;
+  return resolvedAsset;
+}
+
+function sha256(path) {
+  return createHash('sha256').update(readFileSync(path)).digest('hex');
+}
+
+async function fetchText(url) {
+  const res = await fetch(url, { headers: { 'Cache-Control': 'no-cache' } });
+  if (!res.ok) throw new Error(`fetch ${url}: ${res.status} ${res.statusText}`);
+  return res.text();
+}
+
+async function fetchBinary(url, dest) {
+  const res = await fetch(url);
+  if (!res.ok) throw new Error(`fetch ${url}: ${res.status} ${res.statusText}`);
+  const out = createWriteStream(dest);
+  await finished(Readable.fromWeb(res.body).pipe(out));
+}
+
+function ensureDir(dir) {
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+}
+
+function linkBin(name) {
+  const src = join(releaseDir, 'app', 'bin', 'tamcoder');
+  const dst = join(binDir, name);
+  ensureDir(binDir);
+  if (existsSync(dst)) unlinkSync(dst);
+  symlinkSync(src, dst);
+  chmodSync(src, 0o755);
+}
+
+async function installFromLocal() {
+  const dir = localReleaseRoot;
+  if (!existsSync(dir)) throw new Error(`TAMCODER_LOCAL_RELEASE_ROOT not found: ${dir}`);
+  const asset = await resolveAsset();
+  const tarball = join(dir, asset);
+  const checksum = join(dir, `${asset}.sha256`);
+  if (!existsSync(tarball)) throw new Error(`local asset missing: ${tarball}`);
+  ensureDir(releaseDir);
+  await import('child_process').then(({ execFileSync }) => {
+    execFileSync('tar', ['-xzf', tarball, '-C', releaseDir], { stdio: 'inherit' });
+  });
+  return true;
+}
+
+async function installFromNetwork() {
+  const tmp = join(homedir(), '.cache', 'tamcoder', 'downloads', version);
+  ensureDir(tmp);
+  const asset = await resolveAsset();
+  const tarball = join(tmp, asset);
+
+  const shaUrl = `${base}/releases/${asset}.sha256`;
+  const binUrl = `${base}/releases/${asset}`;
+
+  const expected = (await fetchText(shaUrl)).trim().split(/\s+/)[0];
+  if (!/^[a-f0-9]{64}$/i.test(expected)) throw new Error('invalid sha256 from server');
+
+  await fetchBinary(binUrl, tarball);
+  const actual = sha256(tarball);
+  if (actual !== expected) throw new Error(`checksum mismatch: expected ${expected}, got ${actual}`);
+
+  ensureDir(releaseDir);
+  await import('child_process').then(({ execFileSync }) => {
+    execFileSync('tar', ['-xzf', tarball, '-C', releaseDir], { stdio: 'inherit' });
+  });
+  return true;
+}
+
+async function ensureArtifacts() {
+  // Matches install.sh behavior for shared user artifact directory.
+  const artifactRoot = '/mnt/tamcoder/users';
+  const artifactBase = dirname(artifactRoot);
+  const { execFileSync } = await import('child_process');
+  for (const [dir, mode] of [[artifactBase, '0755'], [artifactRoot, '1777']]) {
+    if (!existsSync(dir)) {
+      try { execFileSync('install', ['-d', '-m', mode, dir], { stdio: 'ignore' }); }
+      catch { /* user may manage this separately */ }
+    }
+  }
+}
+
+async function install() {
+  if (existsSync(join(releaseDir, 'app', 'bin', 'tamcoder'))) {
+    console.log(`Tamcoder ${version} already installed at ${releaseDir}`);
+    linkBin('tamcoder');
+    linkBin('tamcoder-bin');
+    return;
+  }
+
+  if (localReleaseRoot) {
+    await installFromLocal();
+  } else {
+    await installFromNetwork();
+  }
+
+  if (!existsSync(join(releaseDir, 'app', 'bin', 'tamcoder'))) {
+    throw new Error('extracted asset is missing app/bin/tamcoder');
+  }
+
+  linkBin('tamcoder');
+  linkBin('tamcoder-bin');
+  await ensureArtifacts();
+  console.log(`Installed Tamcoder ${version} to ${binDir}/tamcoder`);
+}
+
+export async function verify() {
+  // No strict version check: npm package version is metadata only.
+  // Ensure the remote asset can be fetched.
+  const latest = JSON.parse(await fetchText(`${base}/latest.json`));
+  const remoteAsset = latest.asset || `tamcoder-${latest.version}-${platform}.tar.gz`;
+  const shaUrl = `${base}/releases/${remoteAsset}.sha256`;
+  // Verify checksum endpoint exists (404 will throw)
+  await fetchText(shaUrl);
+  console.log(`Verified remote asset ${remoteAsset}`);
+}
+install().catch(err => {
+  console.error(err.message);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@tamfitronics/tamcoder",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.89",
+  "description": "Tamcoder – TypeScript AI coding-agent runtime",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "main": "index.mjs",
+  "bin": {
+    "tamcoder": "bin/tamcoder.mjs",
+    "tamcoder-bin": "bin/tamcoder.mjs"
+  },
+  "files": [
+    "index.mjs",
+    "bin/",
+    "install.mjs",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "postinstall": "node install.mjs",
+    "prepublishOnly": "node -e \"import('./install.mjs').then(m=>m.verify())\""
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tamfitronics/tamcoder.git"
+  },
+  "homepage": "https://tamfitronics.com/tamcoder",
+  "bugs": {
+    "url": "https://github.com/tamfitronics/tamcoder/issues"
+  }
+}