superlab 0.1.5 → 0.1.7

package/README.md

@@ -22,6 +22,8 @@ cd your-project
 superlab init
 ```
 
+After `init` or `update`, start a new Codex or Claude session. If the new `/lab:*` commands still do not show up, restart the app.
+
 If the package has not been published yet, install from GitHub instead:
 
 ```bash
@@ -90,6 +92,30 @@ superlab update --all-projects
 
 `superlab init` writes `.superlab/install.json` inside each project and registers the project in the user-level registry so `update --all-projects` knows what to refresh.
 
+Legacy projects from older `superlab` versions may already contain `.codex/`, `.claude/`, or `.superlab/` assets without `.superlab/install.json`. `superlab update` now reconstructs that metadata and upgrades the project in place.
+
+## Version
+
+Show the CLI version and the current project asset version:
+
+```bash
+superlab version
+```
+
+Show only the current project asset version:
+
+```bash
+superlab version --project
+```
+
+Show a specific project:
+
+```bash
+superlab version --target /path/to/project
+```
+
+If a project still uses an older pre-metadata installation, `superlab version` reports `project: legacy` until you run `superlab update`.
+
 ## Language
 
 The installer chooses the display language from your system locale. If it detects Chinese locale values, it installs Chinese-facing command and skill text; otherwise it falls back to English.

package/README.zh-CN.md

@@ -20,6 +20,8 @@ cd your-project
 superlab init
 ```
 
+执行完 `init` 或 `update` 后，请新开一个 Codex 或 Claude 会话；如果新的 `/lab:*` 命令仍未生效，再重启应用。
+
 如果 npm 还没发布，也可以直接从 GitHub 安装：
 
 ```bash
@@ -88,6 +90,30 @@ superlab update --all-projects
 
 `superlab init` 会在项目内写入 `.superlab/install.json`，并在用户级 registry 里登记项目路径，所以 `update --all-projects` 才知道要刷新哪些项目。
 
+较老版本的 `superlab` 项目可能已经有 `.codex/`、`.claude/` 或 `.superlab/` 资产，但还没有 `.superlab/install.json`。现在 `superlab update` 会自动重建这份 metadata，然后原地升级该项目。
+
+## 版本查询
+
+查看当前 CLI 版本和当前目录项目的资产版本：
+
+```bash
+superlab version
+```
+
+只看当前项目资产版本：
+
+```bash
+superlab version --project
+```
+
+查看指定项目：
+
+```bash
+superlab version --target /path/to/project
+```
+
+如果项目还是旧的 pre-metadata 安装，`superlab version` 会显示 `project: legacy`；执行一次 `superlab update` 后就会切换到正式版本号。
+
 ## 语言
 
 安装器会根据系统 locale 自动猜测展示语言。检测到中文 locale 时会安装中文命令和技能文案；否则默认安装英文文案。

package/bin/superlab.cjs

@@ -2,13 +2,22 @@
 
 const path = require("node:path");
 const {
+  PACKAGE_VERSION,
   detectLanguage,
+  getProjectVersionInfo,
   installSuperlab,
   updateAllProjects,
   updateSuperlabProject,
 } = require("../lib/install.cjs");
 const { promptSelect } = require("../lib/init_tui.cjs");
 
+function restartReminder(lang) {
+  if (lang === "zh") {
+    return "项目资产已更新。请新开一个 Codex/Claude 会话；如果仍未生效，再重启应用。";
+  }
+  return "Project assets updated. Start a new Codex/Claude session; if changes still do not appear, restart the app.";
+}
+
 function printHelp() {
   console.log(`superlab
 
@@ -17,11 +26,13 @@ Usage:
   superlab install [--target <dir>] [--platform codex|claude|both|all] [--lang en|zh] [--force]
   superlab update [--target <dir>]
   superlab update --all-projects
+  superlab version [--target <dir>] [--global|--project]
 
 Commands:
   init      Initialize /lab commands, skills, templates, and scripts in a target
   install   Backward-compatible alias for init
   update    Refresh an initialized project or all registered projects
+  version   Show installed CLI version and project asset version
   help      Show this help message
 `);
 }
@@ -89,6 +100,56 @@ function parseUpdateArgs(argv) {
   return options;
 }
 
+function parseVersionArgs(argv) {
+  const options = {
+    targetDir: process.cwd(),
+    globalOnly: false,
+    projectOnly: false,
+  };
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const value = argv[index];
+    if (value === "--target") {
+      options.targetDir = path.resolve(argv[index + 1]);
+      index += 1;
+    } else if (value === "--global") {
+      options.globalOnly = true;
+    } else if (value === "--project") {
+      options.projectOnly = true;
+    } else {
+      throw new Error(`Unknown option: ${value}`);
+    }
+  }
+
+  if (options.globalOnly && options.projectOnly) {
+    throw new Error("Use either --global or --project, not both.");
+  }
+
+  return options;
+}
+
+function printVersion(options) {
+  const lines = [];
+  if (!options.projectOnly) {
+    lines.push(`cli: ${PACKAGE_VERSION}`);
+  }
+  if (!options.globalOnly) {
+    const projectInfo = getProjectVersionInfo({ targetDir: options.targetDir });
+    if (projectInfo.status === "managed") {
+      lines.push(`project: ${projectInfo.package_version}`);
+      lines.push(`platform: ${projectInfo.platform}`);
+      lines.push(`language: ${projectInfo.lang}`);
+    } else if (projectInfo.status === "legacy") {
+      lines.push("project: legacy");
+      lines.push(`platform: ${projectInfo.platform}`);
+      lines.push(`language: ${projectInfo.lang}`);
+    } else {
+      lines.push("project: not initialized");
+    }
+  }
+  console.log(lines.join("\n"));
+}
+
 function shouldUseInteractiveInit(options) {
   if (options.lang && options.platform) {
     return false;
@@ -140,10 +201,15 @@ async function main() {
     return;
   }
 
-  if (!["init", "install", "update"].includes(command)) {
+  if (!["init", "install", "update", "version"].includes(command)) {
     throw new Error(`Unknown command: ${command}`);
   }
 
+  if (command === "version") {
+    printVersion(parseVersionArgs(rest));
+    return;
+  }
+
   if (command === "update") {
     const options = parseUpdateArgs(rest);
     if (options.allProjects) {
@@ -155,6 +221,7 @@ async function main() {
       for (const project of result.skipped) {
         console.log(`skipped: ${project.path} (${project.reason})`);
       }
+      console.log(restartReminder(detectLanguage()));
       return;
     }
 
@@ -162,6 +229,10 @@ async function main() {
     console.log(`superlab updated in ${options.targetDir}`);
     console.log(`platform: ${metadata.platform}`);
     console.log(`language: ${metadata.lang}`);
+    if (metadata.migration) {
+      console.log(`migration: ${metadata.migration}`);
+    }
+    console.log(restartReminder(metadata.lang));
     return;
   }
 
@@ -170,10 +241,11 @@ async function main() {
   if (options.platform === "all") {
     options.platform = "both";
   }
-  installSuperlab(options);
+  installSuperlab({ ...options, registerProject: true });
   console.log(`superlab installed into ${options.targetDir}`);
   console.log(`platform: ${options.platform}`);
   console.log(`language: ${options.lang}`);
+  console.log(restartReminder(options.lang));
 }
 
 main().catch((error) => {

package/lib/install.cjs

@@ -137,6 +137,76 @@ function readProjectInstallMetadata(targetDir) {
   return JSON.parse(fs.readFileSync(filePath, "utf8"));
 }
 
+function detectLegacyPlatform(targetDir) {
+  const hasCodex =
+    fs.existsSync(path.join(targetDir, ".codex", "prompts")) ||
+    fs.existsSync(path.join(targetDir, ".codex", "skills", "lab"));
+  const hasClaude =
+    fs.existsSync(path.join(targetDir, ".claude", "commands", "lab")) ||
+    fs.existsSync(path.join(targetDir, ".claude", "skills", "lab"));
+
+  if (hasCodex && hasClaude) {
+    return "both";
+  }
+  if (hasCodex) {
+    return "codex";
+  }
+  if (hasClaude) {
+    return "claude";
+  }
+  return null;
+}
+
+function looksChinese(text) {
+  return /[\u3400-\u9fff]/.test(text);
+}
+
+function detectLegacyLanguage(targetDir) {
+  const workflowConfigPath = path.join(targetDir, ".superlab", "config", "workflow.json");
+  if (fs.existsSync(workflowConfigPath)) {
+    try {
+      const config = JSON.parse(fs.readFileSync(workflowConfigPath, "utf8"));
+      if (config.workflow_language === "zh" || config.workflow_language === "en") {
+        return config.workflow_language;
+      }
+    } catch {
+      // Fall through to file-content heuristics.
+    }
+  }
+
+  const probeFiles = [
+    path.join(targetDir, ".codex", "prompts", "lab-idea.md"),
+    path.join(targetDir, ".claude", "commands", "lab", "idea.md"),
+    path.join(targetDir, ".superlab", "templates", "idea.md"),
+  ];
+
+  for (const probeFile of probeFiles) {
+    if (!fs.existsSync(probeFile)) {
+      continue;
+    }
+    const content = fs.readFileSync(probeFile, "utf8");
+    return looksChinese(content) ? "zh" : "en";
+  }
+
+  return "en";
+}
+
+function detectLegacyInstallMetadata(targetDir) {
+  const platform = detectLegacyPlatform(targetDir);
+  if (!platform) {
+    return null;
+  }
+
+  return {
+    target_dir: path.resolve(targetDir),
+    platform,
+    lang: detectLegacyLanguage(targetDir),
+    package_version: "legacy",
+    updated_at: null,
+    legacy: true,
+  };
+}
+
 function readRegistry({ env = process.env } = {}) {
   const filePath = registryFilePath({ env });
   if (!fs.existsSync(filePath)) {
@@ -170,6 +240,16 @@ function registerProjectInstall(targetDir, metadata, { env = process.env } = {})
   writeRegistry(registry, { env });
 }
 
+function isTemporaryTestPath(targetDir) {
+  const resolvedTarget = path.resolve(targetDir);
+  const tmpRoot = path.resolve(os.tmpdir());
+  const relativeToTmp = path.relative(tmpRoot, resolvedTarget);
+  if (relativeToTmp.startsWith("..") || path.isAbsolute(relativeToTmp)) {
+    return false;
+  }
+  return path.basename(resolvedTarget).startsWith("superlab-");
+}
+
 function detectLanguage({ explicitLang, env = process.env } = {}) {
   if (explicitLang) {
     if (!["en", "zh"].includes(explicitLang)) {
@@ -243,7 +323,14 @@ function localizeInstalledAssets(targetDir, lang) {
   }
 }
 
-function installSuperlab({ targetDir, platform = "both", force = false, lang, env = process.env } = {}) {
+function installSuperlab({
+  targetDir,
+  platform = "both",
+  force = false,
+  lang,
+  env = process.env,
+  registerProject = false,
+} = {}) {
   const groups = [];
   if (platform === "codex" || platform === "both") {
     groups.push(...ASSET_GROUPS.codex);
@@ -267,46 +354,112 @@ function installSuperlab({ targetDir, platform = "both", force = false, lang, en
     updated_at: new Date().toISOString(),
   };
   writeProjectInstallMetadata(targetDir, metadata);
-  registerProjectInstall(targetDir, metadata, { env });
+  if (registerProject) {
+    registerProjectInstall(targetDir, metadata, { env });
+  }
+  return metadata;
 }
 
 function updateSuperlabProject({ targetDir, env = process.env } = {}) {
-  const metadata = readProjectInstallMetadata(targetDir);
-  installSuperlab({
+  let metadata;
+  let migratedLegacy = false;
+  try {
+    metadata = readProjectInstallMetadata(targetDir);
+  } catch (error) {
+    metadata = detectLegacyInstallMetadata(targetDir);
+    if (!metadata) {
+      throw error;
+    }
+    migratedLegacy = true;
+  }
+
+  const installedMetadata = installSuperlab({
     targetDir,
     platform: metadata.platform,
     lang: metadata.lang,
     force: true,
     env,
+    registerProject: true,
   });
-  return metadata;
+  if (migratedLegacy) {
+    installedMetadata.migration = "legacy project metadata reconstructed";
+  }
+  return installedMetadata;
 }
 
 function updateAllProjects({ env = process.env } = {}) {
   const registry = readRegistry({ env });
   const updated = [];
   const skipped = [];
+  const retained = [];
 
   for (const project of registry.projects) {
     try {
+      if (isTemporaryTestPath(project.path)) {
+        skipped.push({ path: project.path, reason: "temporary path pruned from registry" });
+        continue;
+      }
       if (!fs.existsSync(project.path)) {
         skipped.push({ path: project.path, reason: "missing project path" });
         continue;
       }
-      updateSuperlabProject({ targetDir: project.path, env });
+      const metadata = updateSuperlabProject({ targetDir: project.path, env });
       updated.push(project.path);
+      retained.push({
+        path: path.resolve(project.path),
+        platform: metadata.platform,
+        lang: metadata.lang,
+        package_version: metadata.package_version,
+        updated_at: metadata.updated_at,
+      });
     } catch (error) {
       skipped.push({ path: project.path, reason: error.message });
+      if (fs.existsSync(project.path)) {
+        retained.push(project);
+      }
     }
   }
 
+  writeRegistry({ projects: retained }, { env });
   return { updated, skipped };
 }
 
+function getProjectVersionInfo({ targetDir } = {}) {
+  try {
+    const metadata = readProjectInstallMetadata(targetDir);
+    return {
+      status: "managed",
+      package_version: metadata.package_version,
+      platform: metadata.platform,
+      lang: metadata.lang,
+    };
+  } catch {
+    const legacyMetadata = detectLegacyInstallMetadata(targetDir);
+    if (!legacyMetadata) {
+      return {
+        status: "missing",
+        package_version: null,
+        platform: null,
+        lang: null,
+      };
+    }
+    return {
+      status: "legacy",
+      package_version: "legacy",
+      platform: legacyMetadata.platform,
+      lang: legacyMetadata.lang,
+    };
+  }
+}
+
 module.exports = {
+  PACKAGE_VERSION,
   detectLanguage,
+  detectLegacyInstallMetadata,
   installSuperlab,
   installMetadataPath,
+  isTemporaryTestPath,
+  getProjectVersionInfo,
   readProjectInstallMetadata,
   registryFilePath,
   readRegistry,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superlab",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Strict /lab research workflow installer for Codex and Claude",
   "keywords": [
     "codex",