@t3x-dev/local 0.3.0 → 0.4.0

package/README.md

@@ -2,7 +2,28 @@
 
 Minimal local entry package for T3X.
 
-Current PR2 scope:
+## What
+
+`@t3x-dev/local` is the alpha entry package for running T3X locally from npm.
+It exposes `t3x-local`, plus convenience forwards for `t3x` and `t3x-mcp`.
+
+## Why
+
+The package gives alpha users one install path for the self-hostable product
+without making every workspace package part of the public release surface.
+
+## Release status
+
+`@t3x-dev/local@0.3.1` is part of the restricted T3X alpha release surface.
+Package visibility may be limited to accounts with alpha access.
+
+## Install
+
+```bash
+npx -p @t3x-dev/local t3x-local start
+```
+
+## Scope
 
 - `t3x-local start` launches the locally built API + Web
 - `t3x` forwards to `@t3x-dev/cli`
@@ -13,3 +34,9 @@ On package install, `postinstall` downloads the platform runtime asset from
 
 For private GitHub releases, set `T3X_LOCAL_GITHUB_TOKEN`, `GH_TOKEN`, or
 `GITHUB_TOKEN` to a token with access to the runtime release.
+
+## Sample
+
+```bash
+npx -p @t3x-dev/local t3x-local start
+```

package/dist/bin/t3x-local.js

@@ -6,7 +6,7 @@ import {
   getVersionSnapshot,
   resolveStartOptions,
   runStartCommand
-} from "../chunk-KNAXB6AU.js";
+} from "../chunk-ESYPP6N2.js";
 import {
   clearRuntimeState,
   getLocalPaths,
@@ -15,9 +15,10 @@ import {
   getRuntimeProcessStatus,
   readRuntimeState,
   terminatePid
-} from "../chunk-E4LL4ESG.js";
+} from "../chunk-TJSQMFJE.js";
 
 // src/bin/t3x-local.ts
+import { createRequire } from "module";
 import { Command } from "commander";
 
 // src/commands/doctor.ts
@@ -189,8 +190,10 @@ async function runResetCommand(input = {}) {
 }
 
 // src/bin/t3x-local.ts
+var require2 = createRequire(import.meta.url);
+var packageJson = require2("../../package.json");
 var program = new Command();
-program.name("t3x-local").description("T3X local runtime entrypoint").version("0.1.1");
+program.name("t3x-local").description("T3X local runtime entrypoint").version(packageJson.version ?? "0.0.0");
 program.command("start").description("Start the local API and Web runtimes in the background").option("--data-dir <path>", "Embedded PostgreSQL data directory").option("--api-port <port>", "API port (default: 8000)", parseInteger).option("--web-port <port>", "Web port (default: 3000)", parseInteger).action(async (options) => {
   await runStartCommand(options);
 });

package/dist/bin/t3x-mcp.js

@@ -3,7 +3,7 @@ import {
   getLocalPaths,
   readRuntimeState,
   runNodeScript
-} from "../chunk-E4LL4ESG.js";
+} from "../chunk-TJSQMFJE.js";
 
 // src/bin/t3x-mcp.ts
 var paths = getLocalPaths();

package/dist/bin/t3x.js

@@ -3,7 +3,7 @@ import {
   getLocalPaths,
   readRuntimeState,
   runNodeScript
-} from "../chunk-E4LL4ESG.js";
+} from "../chunk-TJSQMFJE.js";
 
 // src/bin/t3x.ts
 var paths = getLocalPaths();

package/dist/{chunk-KNAXB6AU.js → chunk-ESYPP6N2.js}

@@ -9,7 +9,7 @@ import {
   spawnNodeScript,
   terminateProcess,
   writeRuntimeState
-} from "./chunk-E4LL4ESG.js";
+} from "./chunk-TJSQMFJE.js";
 
 // src/commands/start.ts
 import fs2 from "fs/promises";
@@ -186,12 +186,6 @@ var FIXED_PACKAGE_WORKSPACE_PATHS = {
   "@t3x-dev/mcp": path2.join("apps", "mcp", "package.json"),
   "@t3x-dev/local": path2.join("apps", "local", "package.json")
 };
-var LOCAL_DIRECT_FIXED_DEPENDENCIES = [
-  "@t3x-dev/api",
-  "@t3x-dev/cli",
-  "@t3x-dev/mcp",
-  "@t3x-dev/storage"
-];
 function getVersionSnapshot(paths) {
   const report = getVersionLockReport(paths);
   const manifestVersions = readManifestDependencyVersions(paths);
@@ -213,20 +207,17 @@ function getVersionLockReport(paths) {
   const expectedVersion = localPackageJson.version ?? "unknown";
   const problems = [];
   const resolvedVersions = {};
-  for (const dependencyName of LOCAL_DIRECT_FIXED_DEPENDENCIES) {
-    const actual = localPackageJson.dependencies?.[dependencyName];
-    if (actual !== expectedVersion && actual !== `workspace:${expectedVersion}`) {
-      problems.push(
-        `Local package dependency ${dependencyName} must pin ${expectedVersion}, found ${actual ?? "missing"}`
-      );
-    }
-  }
   if (manifest) {
     if (manifest.packageVersion !== expectedVersion) {
       problems.push(
         `runtime-manifest.json packageVersion must be ${expectedVersion}, found ${manifest.packageVersion ?? "missing"}`
       );
     }
+    if (manifest.fixedVersion !== expectedVersion) {
+      problems.push(
+        `runtime-manifest.json fixedVersion must be ${expectedVersion}, found ${manifest.fixedVersion ?? "missing"}`
+      );
+    }
     for (const packageName of FIXED_VERSION_PACKAGES) {
       const manifestVersion = manifest.dependencies?.[packageName];
       if (manifestVersion !== expectedVersion) {
@@ -235,6 +226,24 @@ function getVersionLockReport(paths) {
         );
       }
     }
+    const platformEntries = Object.entries(manifest.platforms ?? {});
+    if (platformEntries.length === 0) {
+      problems.push("runtime-manifest.json must declare at least one runtime platform artifact");
+    }
+    for (const [platformKey, platform] of platformEntries) {
+      const expectedFileNamePrefix = `t3x-local-runtime-${expectedVersion}-`;
+      if (!platform.fileName?.startsWith(expectedFileNamePrefix)) {
+        problems.push(
+          `runtime-manifest.json platform ${platformKey} fileName must include ${expectedVersion}, found ${platform.fileName ?? "missing"}`
+        );
+      }
+      const expectedReleaseTag = `t3x-local-v${expectedVersion}`;
+      if (!platform.url?.includes(expectedReleaseTag)) {
+        problems.push(
+          `runtime-manifest.json platform ${platformKey} url must reference ${expectedReleaseTag}, found ${platform.url ?? "missing"}`
+        );
+      }
+    }
   }
   for (const packageName of FIXED_VERSION_PACKAGES) {
     const actualVersion = packageName === "@t3x-dev/local" ? expectedVersion : resolveFixedPackageVersion(packageName, paths, manifest);

package/dist/{chunk-E4LL4ESG.js → chunk-TJSQMFJE.js}

@@ -35,13 +35,13 @@ function getLocalPaths() {
     ),
     webStaticDir: runtimeSource === "installed" ? path.join(installedRuntimeDir, "web", "static") : path.join(assertRepoRoot(repoRoot), "apps", "web", ".next", "static"),
     webPublicDir: runtimeSource === "installed" ? path.join(installedRuntimeDir, "web", "public") : path.join(assertRepoRoot(repoRoot), "apps", "web", "public"),
-    cliEntryPath: resolvePackageBinEntry({
+    cliEntryPath: runtimeSource === "installed" ? path.join(installedRuntimeDir, "cli", "dist", "index.js") : resolvePackageBinEntry({
       packageName: "@t3x-dev/cli",
       binName: "t3x",
       repoRoot,
       workspaceRelativeDir: path.join("apps", "cli")
     }),
-    mcpEntryPath: resolvePackageBinEntry({
+    mcpEntryPath: runtimeSource === "installed" ? path.join(installedRuntimeDir, "mcp", "dist", "index.js") : resolvePackageBinEntry({
       packageName: "@t3x-dev/mcp",
       binName: "t3x-mcp",
       repoRoot,

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   runStartCommand
-} from "./chunk-KNAXB6AU.js";
-import "./chunk-E4LL4ESG.js";
+} from "./chunk-ESYPP6N2.js";
+import "./chunk-TJSQMFJE.js";
 export {
   runStartCommand
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t3x-dev/local",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "T3X local entry package",
   "license": "Apache-2.0",
   "type": "module",
@@ -37,12 +37,38 @@
     "postinstall": "node ./scripts/postinstall-download.mjs"
   },
   "dependencies": {
+    "@anthropic-ai/sdk": "^0.71.2",
     "@hono/node-server": "^1.15.2",
-    "@t3x-dev/api": "0.3.0",
-    "@t3x-dev/cli": "0.3.0",
-    "@t3x-dev/mcp": "0.3.0",
-    "@t3x-dev/storage": "0.3.0",
-    "commander": "^13.1.0"
+    "@hono/node-ws": "^1.3.0",
+    "@hono/zod-openapi": "^1.2.0",
+    "@hono/zod-validator": "^0.7.6",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@mozilla/readability": "^0.6.0",
+    "@scalar/hono-api-reference": "^0.9.30",
+    "bcryptjs": "^3.0.3",
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "drizzle-orm": "^0.38.3",
+    "embedded-postgres": "^18.3.0-beta.16",
+    "fflate": "^0.8.2",
+    "hono": "^4.7.10",
+    "js-yaml": "^4.1.1",
+    "jsdom": "^28.0.0",
+    "json-canonicalize": "^2.0.0",
+    "mammoth": "^1.8.0",
+    "nanoid": "^5.1.6",
+    "ora": "^8.1.1",
+    "pdf-parse": "^1.1.1",
+    "pg": "^8.21.0",
+    "pino": "^9.14.0",
+    "pino-pretty": "^11.3.0",
+    "postgres": "^3.4.5",
+    "table": "^6.9.0",
+    "turndown": "^7.2.2",
+    "turndown-plugin-gfm": "^1.0.2",
+    "undici": "^7.16.0",
+    "yaml": "^2.8.3",
+    "zod": "^4.2.1"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",

package/runtime-manifest.json

@@ -1,26 +1,26 @@
 {
   "manifestVersion": 1,
-  "packageVersion": "0.3.0",
-  "fixedVersion": "0.3.0",
-  "generatedAt": "2026-05-03T07:35:37.449Z",
+  "packageVersion": "0.4.0",
+  "fixedVersion": "0.4.0",
+  "generatedAt": "2026-06-05T09:38:37.053Z",
   "dependencies": {
-    "@t3x-dev/yops": "0.3.0",
-    "@t3x-dev/yschema": "0.3.0",
-    "@t3x-dev/core": "0.3.0",
-    "@t3x-dev/storage": "0.3.0",
-    "@t3x-dev/api": "0.3.0",
-    "@t3x-dev/api-client": "0.3.0",
-    "@t3x-dev/cli": "0.3.0",
-    "@t3x-dev/mcp": "0.3.0",
-    "@t3x-dev/local": "0.3.0",
+    "@t3x-dev/yops": "0.4.0",
+    "@t3x-dev/yschema": "0.4.0",
+    "@t3x-dev/core": "0.4.0",
+    "@t3x-dev/storage": "0.4.0",
+    "@t3x-dev/api": "0.4.0",
+    "@t3x-dev/api-client": "0.4.0",
+    "@t3x-dev/cli": "0.4.0",
+    "@t3x-dev/mcp": "0.4.0",
+    "@t3x-dev/local": "0.4.0",
     "web": "0.1.0"
   },
   "platforms": {
     "darwin-arm64": {
-      "fileName": "t3x-local-runtime-0.3.0-darwin-arm64.tar.gz",
-      "url": "https://github.com/t3x-dev/t3x-core/releases/download/t3x-local-v0.3.0/t3x-local-runtime-0.3.0-darwin-arm64.tar.gz",
-      "sha256": "7f9c52d3ce51585aa7232bd2d16078f8e6e080264224862462423429227d4cbb",
-      "size": 20420629
+      "fileName": "t3x-local-runtime-0.4.0-darwin-arm64.tar.gz",
+      "url": "https://github.com/t3x-dev/t3x-core/releases/download/t3x-local-v0.4.0/t3x-local-runtime-0.4.0-darwin-arm64.tar.gz",
+      "sha256": "61e094d3d49cb9992cad993920caba9e3e79e8d97dda93af4118c9245961204d",
+      "size": 21882464
     }
   }
 }

package/scripts/postinstall-download.mjs

@@ -33,12 +33,6 @@ const FIXED_VERSION_PACKAGES = [
   '@t3x-dev/mcp',
   '@t3x-dev/local',
 ];
-const LOCAL_DIRECT_FIXED_DEPENDENCIES = [
-  '@t3x-dev/api',
-  '@t3x-dev/cli',
-  '@t3x-dev/mcp',
-  '@t3x-dev/storage',
-];
 const GITHUB_TOKEN_ENV_NAMES = ['T3X_LOCAL_GITHUB_TOKEN', 'GH_TOKEN', 'GITHUB_TOKEN'];
 const DOWNLOAD_MAX_ATTEMPTS = parsePositiveInt(process.env.T3X_LOCAL_DOWNLOAD_ATTEMPTS, 3);
 const DOWNLOAD_RETRY_DELAY_MS = parsePositiveInt(
@@ -391,22 +385,18 @@ async function verifyInstalledVersionLock(packageDir, manifest) {
   const expectedVersion = packageJson.version;
   const problems = [];
 
-  for (const dependencyName of LOCAL_DIRECT_FIXED_DEPENDENCIES) {
-    const actual = packageJson.dependencies?.[dependencyName];
-
-    if (actual !== expectedVersion && actual !== `workspace:${expectedVersion}`) {
-      problems.push(
-        `package.json dependency ${dependencyName} must pin ${expectedVersion}, found ${actual ?? 'missing'}`
-      );
-    }
-  }
-
   if (manifest.packageVersion !== expectedVersion) {
     problems.push(
       `runtime-manifest.json packageVersion must be ${expectedVersion}, found ${manifest.packageVersion ?? 'missing'}`
     );
   }
 
+  if (manifest.fixedVersion !== expectedVersion) {
+    problems.push(
+      `runtime-manifest.json fixedVersion must be ${expectedVersion}, found ${manifest.fixedVersion ?? 'missing'}`
+    );
+  }
+
   for (const packageName of FIXED_VERSION_PACKAGES) {
     const manifestVersion = manifest.dependencies?.[packageName];
     if (manifestVersion !== expectedVersion) {
@@ -416,6 +406,27 @@ async function verifyInstalledVersionLock(packageDir, manifest) {
     }
   }
 
+  const platformEntries = Object.entries(manifest.platforms ?? {});
+  if (platformEntries.length === 0) {
+    problems.push('runtime-manifest.json must declare at least one runtime platform artifact');
+  }
+
+  for (const [platformKey, platform] of platformEntries) {
+    const expectedFileNamePrefix = `t3x-local-runtime-${expectedVersion}-`;
+    if (!platform?.fileName?.startsWith(expectedFileNamePrefix)) {
+      problems.push(
+        `runtime-manifest.json platform ${platformKey} fileName must include ${expectedVersion}, found ${platform?.fileName ?? 'missing'}`
+      );
+    }
+
+    const expectedReleaseTag = `t3x-local-v${expectedVersion}`;
+    if (!platform?.url?.includes(expectedReleaseTag)) {
+      problems.push(
+        `runtime-manifest.json platform ${platformKey} url must reference ${expectedReleaseTag}, found ${platform?.url ?? 'missing'}`
+      );
+    }
+  }
+
   if (problems.length > 0) {
     throw new Error(
       '[t3x-local:postinstall] Fixed version verification failed.\n' +

package/scripts/prepare-runtime.mjs

@@ -29,6 +29,8 @@ const stagingDir = await fs.mkdtemp(path.join(os.tmpdir(), 't3x-local-runtime-')
 
 const sources = {
   apiDist: path.join(repoRoot, 'apps', 'api', 'dist'),
+  cliDist: path.join(repoRoot, 'apps', 'cli', 'dist'),
+  mcpDist: path.join(repoRoot, 'apps', 'mcp', 'dist'),
   webStandalone: path.join(repoRoot, 'apps', 'web', '.next', 'standalone'),
   webStatic: path.join(repoRoot, 'apps', 'web', '.next', 'static'),
   webPublic: path.join(repoRoot, 'apps', 'web', 'public'),
@@ -50,10 +52,14 @@ if (missingSources.length > 0) {
 
 try {
   await ensureDir(path.join(stagingDir, 'api'));
+  await ensureDir(path.join(stagingDir, 'cli'));
+  await ensureDir(path.join(stagingDir, 'mcp'));
   await ensureDir(path.join(stagingDir, 'web'));
   await ensureDir(artifactDir);
 
   await fs.cp(sources.apiDist, path.join(stagingDir, 'api', 'dist'), { recursive: true });
+  await fs.cp(sources.cliDist, path.join(stagingDir, 'cli', 'dist'), { recursive: true });
+  await fs.cp(sources.mcpDist, path.join(stagingDir, 'mcp', 'dist'), { recursive: true });
   await fs.cp(sources.webStandalone, path.join(stagingDir, 'web', 'standalone'), {
     recursive: true,
     verbatimSymlinks: true,

package/scripts/runtime-helpers.mjs

@@ -5,6 +5,8 @@ import { fileURLToPath } from 'node:url';
 
 export const SUPPORTED_RUNTIME_PATHS = [
   path.join('api', 'dist', 'index.js'),
+  path.join('cli', 'dist', 'index.js'),
+  path.join('mcp', 'dist', 'index.js'),
   path.join('web', 'standalone', 'apps', 'web', 'server.js'),
   path.join('web', 'static'),
   path.join('web', 'public'),