claudekit-cli 3.41.4-dev.4 → 3.41.4-dev.6

package/README.md

@@ -148,6 +148,10 @@ ck new --prefix
 # Offline installation (from local archive or directory)
 ck new --archive ~/downloads/engineer-v1.16.0.zip
 ck new --kit-path ~/extracted-kit/
+
+# Direct repo downloads are also supported
+ck new --archive ~/downloads/claudekit-engineer-main.zip
+ck new --kit-path ~/downloads/claudekit-engineer-main/
 ```
 
 **Flags:**
@@ -158,6 +162,8 @@ ck new --kit-path ~/extracted-kit/
 - `--archive <path>`: Use local archive (zip/tar.gz) instead of downloading
 - `--kit-path <path>`: Use local kit directory instead of downloading
 
+`--archive` and `--kit-path` both accept direct repo downloads with a single wrapper directory, including GitHub "Download ZIP" archives and extracted repo folders that still contain `claudekit-engineer-main/` or similar at the top level.
+
 ### Initialize or Update Project
 
 **Note:** Run from project root.
@@ -188,6 +194,10 @@ ck init --exclude "*.local" --prefix
 # Offline installation (from local archive or directory)
 ck init --archive ~/downloads/engineer-v1.16.0.zip
 ck init --kit-path ~/extracted-kit/
+
+# Direct repo downloads are also supported
+ck init --archive ~/downloads/claudekit-engineer-main.zip
+ck init --kit-path ~/downloads/claudekit-engineer-main/
 ```
 
 **Flags:**
@@ -199,6 +209,8 @@ ck init --kit-path ~/extracted-kit/
 - `--archive <path>`: Use local archive (zip/tar.gz) instead of downloading
 - `--kit-path <path>`: Use local kit directory instead of downloading
 
+`--archive` and `--kit-path` both accept direct repo downloads with a single wrapper directory, including GitHub "Download ZIP" archives and extracted repo folders that still contain `claudekit-engineer-main/` or similar at the top level.
+
 **Default Behavior with `-y` Flag:**
 
 | Prompt | Default |

package/dist/index.js

@@ -56454,7 +56454,7 @@ function extractResultContent(block) {
   return;
 }
 async function parseSessionDetail(filePath, limit, offset) {
-  const MAX_SESSION_FILE_BYTES = 10 * 1024 * 1024;
+  const MAX_SESSION_FILE_BYTES = 50 * 1024 * 1024;
   const fileStats = await stat8(filePath);
   if (fileStats.size > MAX_SESSION_FILE_BYTES) {
     return {
@@ -58323,7 +58323,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "claudekit-cli",
-    version: "3.41.4-dev.4",
+    version: "3.41.4-dev.6",
     description: "CLI tool for bootstrapping and updating ClaudeKit projects",
     type: "module",
     repository: {
@@ -93126,7 +93126,6 @@ Solutions:
 init_kit_layout();
 init_logger();
 init_output_manager();
-init_types3();
 var RELEASE_ROOT_ALLOWLIST = [
   "plans",
   "CLAUDE.md",
@@ -93137,6 +93136,8 @@ var RELEASE_ROOT_ALLOWLIST = [
   ".opencode",
   "release-manifest.json"
 ];
+var NESTED_KIT_ROOT_MAX_LEVELS = 5;
+var IGNORED_WRAPPER_ENTRY_NAMES = new Set([".DS_Store", "__MACOSX"]);
 function buildReleaseAllowlist(layout) {
   return [...new Set([layout.sourceDir, ...RELEASE_ROOT_ALLOWLIST])];
 }
@@ -93171,6 +93172,33 @@ async function materializeRuntimeLayoutInPlace(projectRoot, layout) {
   await fs19.promises.rm(runtimeDir, { recursive: true, force: true });
   await fs19.promises.rename(sourceDir, runtimeDir);
 }
+function isIgnoredWrapperEntry(entryName) {
+  const normalizedName = entryName.toLowerCase();
+  return IGNORED_WRAPPER_ENTRY_NAMES.has(entryName) || normalizedName === "thumbs.db" || normalizedName === "desktop.ini" || entryName.startsWith("._");
+}
+async function listVisibleEntries(projectRoot) {
+  return (await fs19.promises.readdir(projectRoot, { withFileTypes: true })).filter((entry) => !isIgnoredWrapperEntry(entry.name));
+}
+function isLikelyKitRoot(projectRoot, entries) {
+  const entrySet = new Set(entries.map((entry) => entry.name));
+  const layout = resolveKitLayout(projectRoot);
+  return entrySet.has("CLAUDE.md") || entrySet.has(layout.runtimeDir) || entrySet.has(layout.sourceDir) || entrySet.has("claude");
+}
+async function resolveOfflineKitRoot(rootDir) {
+  let currentDir = rootDir;
+  for (let level = 0;level < NESTED_KIT_ROOT_MAX_LEVELS; level++) {
+    const entries = await listVisibleEntries(currentDir);
+    if (isLikelyKitRoot(currentDir, entries)) {
+      return currentDir;
+    }
+    const childDirectories = entries.filter((entry) => entry.isDirectory());
+    if (entries.length !== 1 || childDirectories.length !== 1) {
+      break;
+    }
+    currentDir = path14.join(currentDir, childDirectories[0].name);
+  }
+  return rootDir;
+}
 async function stageLocalKitPathForRuntimeLayout(kitRoot, layout) {
   const sourceDir = await ensureLayoutSourceDir(kitRoot, layout, false);
   if (!sourceDir) {
@@ -93326,11 +93354,15 @@ Please verify the path exists and is accessible.`);
     }
     throw error;
   }
-  const layout = resolveKitLayout(absolutePath);
+  const kitRoot = await resolveOfflineKitRoot(absolutePath);
+  if (kitRoot !== absolutePath) {
+    logger.info(`Detected nested kit root: ${kitRoot}`);
+  }
+  const layout = resolveKitLayout(kitRoot);
   if (layout.sourceDir !== layout.runtimeDir) {
-    const stagedKit = await stageLocalKitPathForRuntimeLayout(absolutePath, layout);
+    const stagedKit = await stageLocalKitPathForRuntimeLayout(kitRoot, layout);
     if (stagedKit) {
-      logger.info(`Using kit from: ${absolutePath}`);
+      logger.info(`Using kit from: ${kitRoot}`);
       return {
         tempDir: stagedKit.tempDir,
         archivePath: "",
@@ -93338,7 +93370,7 @@ Please verify the path exists and is accessible.`);
       };
     }
   }
-  const claudeDir3 = path14.join(absolutePath, DEFAULT_KIT_LAYOUT.runtimeDir);
+  const claudeDir3 = path14.join(kitRoot, layout.runtimeDir);
   try {
     const stat15 = await fs19.promises.stat(claudeDir3);
     if (!stat15.isDirectory()) {
@@ -93347,15 +93379,15 @@ This may not be a valid ClaudeKit installation.`);
     }
   } catch (error) {
     if (error.code === "ENOENT") {
-      logger.warning(`Warning: No .claude directory found in ${absolutePath}
+      logger.warning(`Warning: No ${layout.runtimeDir} directory found in ${kitRoot}
 This may not be a valid ClaudeKit installation. Proceeding anyway...`);
     }
   }
-  logger.info(`Using kit from: ${absolutePath}`);
+  logger.info(`Using kit from: ${kitRoot}`);
   return {
     tempDir: absolutePath,
     archivePath: "",
-    extractDir: absolutePath
+    extractDir: kitRoot
   };
 }
 var VALID_ARCHIVE_FORMATS = [".zip", ".tar.gz", ".tgz", ".tar"];
@@ -93404,12 +93436,20 @@ Please verify the file exists and is accessible.`);
   const extractDir = `${tempDir}/extracted`;
   logger.verbose("Extraction", { archivePath: absolutePath, extractDir });
   await downloadManager.extractArchive(absolutePath, extractDir);
-  await downloadManager.validateExtraction(extractDir);
+  const kitRoot = await resolveOfflineKitRoot(extractDir);
+  if (kitRoot !== extractDir) {
+    logger.info(`Detected nested kit root in archive: ${kitRoot}`);
+  }
+  const layout = resolveKitLayout(kitRoot);
+  if (layout.sourceDir !== layout.runtimeDir && await ensureLayoutSourceDir(kitRoot, layout, false)) {
+    await materializeRuntimeLayoutInPlace(kitRoot, layout);
+  }
+  await downloadManager.validateExtraction(kitRoot);
   logger.info(`Extracted from: ${absolutePath}`);
   return {
     tempDir,
     archivePath: absolutePath,
-    extractDir
+    extractDir: kitRoot
   };
 }
 async function downloadViaGitClone(release, kit) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "claudekit-cli",
-	"version": "3.41.4-dev.4",
+	"version": "3.41.4-dev.6",
 	"description": "CLI tool for bootstrapping and updating ClaudeKit projects",
 	"type": "module",
 	"repository": {