create-threadlens-app 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.2.2 - 2026-05-21
+
+Tag: `create-threadlens-app@0.2.2`
+
+### Fixes
+
+- fix(create-threadlens-app): surface GHCR pull denial and align default version (`31a125a`)
+
 ## 0.2.1 - 2026-05-21
 
 Tag: `create-threadlens-app@0.2.1`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-threadlens-app",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "One-command local-first ThreadLens self-host installer",
   "license": "BUSL-1.1",
   "type": "module",

package/src/install.js

@@ -55,7 +55,11 @@ export async function install(options, deps = {}) {
   logger.success('Generated .env, compose.yml, README.md, .gitignore, and .threadlens metadata');
 
   logger.step('Starting Docker Compose');
-  await startCompose(manifest, { run, stream: options.verbose });
+  try {
+    await startCompose(manifest, { run, stream: options.verbose });
+  } catch (error) {
+    throw classifyComposeStartError(error, manifest);
+  }
   await updateState(appDir, { status: 'starting', lastStartedAt: new Date().toISOString() });
   logger.success('Docker stack started');
 
@@ -94,3 +98,16 @@ async function ensureInstallDirectory(appDir) {
     throw error;
   }
 }
+
+function classifyComposeStartError(error, manifest) {
+  const detail = `${error?.message ?? ''}\n${error?.stderr ?? ''}`.toLowerCase();
+  if (detail.includes('ghcr.io') && detail.includes('denied')) {
+    return new CliError(
+      'image_pull_denied',
+      `Docker could not pull ghcr.io/threadlenshq images for ThreadLens ${manifest.threadlensVersion} (registry denied access). This is usually a missing/publication issue for the image tag or GHCR package visibility.`,
+      11
+    );
+  }
+  if (error instanceof CliError) return error;
+  return error;
+}

package/src/manifest.js

@@ -4,7 +4,7 @@ import { CliError } from './output.js';
 import { composeProjectName, safeSlug } from './slug.js';
 
 export const MANIFEST_VERSION = 1;
-export const DEFAULT_THREADLENS_VERSION = '0.1.0';
+export const DEFAULT_THREADLENS_VERSION = '0.2.1';
 
 export function createManifest({ appDir, instanceName, profile, appPort, webPort, apiPort, version = DEFAULT_THREADLENS_VERSION }) {
   const slug = safeSlug(instanceName);