superlab 0.1.4 → 0.1.5

package/README.md

@@ -68,6 +68,28 @@ superlab init --all
 
 `--all` is an alias for `--platform both`. Use `--force` if you need to overwrite existing files.
 
+## Update
+
+Refresh the current project:
+
+```bash
+superlab update
+```
+
+Refresh a specific project:
+
+```bash
+superlab update --target /path/to/project
+```
+
+Refresh every registered project initialized from this user account:
+
+```bash
+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.
+
 ## 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

@@ -66,6 +66,28 @@ superlab init --all
 
 `--all` 是 `--platform both` 的别名。如果目标目录已有同名文件，可以加 `--force` 覆盖。
 
+## 更新
+
+刷新当前项目：
+
+```bash
+superlab update
+```
+
+刷新指定项目：
+
+```bash
+superlab update --target /path/to/project
+```
+
+刷新当前用户登记过的所有项目：
+
+```bash
+superlab update --all-projects
+```
+
+`superlab init` 会在项目内写入 `.superlab/install.json`，并在用户级 registry 里登记项目路径，所以 `update --all-projects` 才知道要刷新哪些项目。
+
 ## 语言
 
 安装器会根据系统 locale 自动猜测展示语言。检测到中文 locale 时会安装中文命令和技能文案；否则默认安装英文文案。

package/bin/superlab.cjs

@@ -1,7 +1,12 @@
 #!/usr/bin/env node
 
 const path = require("node:path");
-const { detectLanguage, installSuperlab } = require("../lib/install.cjs");
+const {
+  detectLanguage,
+  installSuperlab,
+  updateAllProjects,
+  updateSuperlabProject,
+} = require("../lib/install.cjs");
 const { promptSelect } = require("../lib/init_tui.cjs");
 
 function printHelp() {
@@ -10,10 +15,13 @@ function printHelp() {
 Usage:
   superlab init [--target <dir>] [--platform codex|claude|both|all] [--lang en|zh] [--force]
   superlab install [--target <dir>] [--platform codex|claude|both|all] [--lang en|zh] [--force]
+  superlab update [--target <dir>]
+  superlab update --all-projects
 
 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
   help      Show this help message
 `);
 }
@@ -56,6 +64,31 @@ function parseInstallArgs(argv) {
   return options;
 }
 
+function parseUpdateArgs(argv) {
+  const options = {
+    targetDir: process.cwd(),
+    allProjects: 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 === "--all-projects") {
+      options.allProjects = true;
+    } else {
+      throw new Error(`Unknown option: ${value}`);
+    }
+  }
+
+  if (options.allProjects && argv.includes("--target")) {
+    throw new Error("Use either --target or --all-projects, not both.");
+  }
+
+  return options;
+}
+
 function shouldUseInteractiveInit(options) {
   if (options.lang && options.platform) {
     return false;
@@ -107,10 +140,31 @@ async function main() {
     return;
   }
 
-  if (!["init", "install"].includes(command)) {
+  if (!["init", "install", "update"].includes(command)) {
     throw new Error(`Unknown command: ${command}`);
   }
 
+  if (command === "update") {
+    const options = parseUpdateArgs(rest);
+    if (options.allProjects) {
+      const result = updateAllProjects();
+      console.log(`updated projects: ${result.updated.length}`);
+      for (const project of result.updated) {
+        console.log(`updated: ${project}`);
+      }
+      for (const project of result.skipped) {
+        console.log(`skipped: ${project.path} (${project.reason})`);
+      }
+      return;
+    }
+
+    const metadata = updateSuperlabProject({ targetDir: options.targetDir });
+    console.log(`superlab updated in ${options.targetDir}`);
+    console.log(`platform: ${metadata.platform}`);
+    console.log(`language: ${metadata.lang}`);
+    return;
+  }
+
   const parsedOptions = parseInstallArgs(rest);
   const options = await resolveInitOptions(parsedOptions);
   if (options.platform === "all") {

package/lib/install.cjs

@@ -1,8 +1,10 @@
 const fs = require("node:fs");
+const os = require("node:os");
 const path = require("node:path");
 const { getLocalizedContent } = require("./i18n.cjs");
 
 const REPO_ROOT = path.resolve(__dirname, "..");
+const PACKAGE_VERSION = require(path.join(REPO_ROOT, "package.json")).version;
 
 const ASSET_GROUPS = {
   codex: [
@@ -102,6 +104,72 @@ function chmodScripts(targetDir) {
   }
 }
 
+function superlabHomeDir({ env = process.env } = {}) {
+  if (env.SUPERLAB_HOME) {
+    return env.SUPERLAB_HOME;
+  }
+  return path.join(env.HOME || os.homedir(), ".superlab");
+}
+
+function registryFilePath({ env = process.env } = {}) {
+  return path.join(superlabHomeDir({ env }), "registry.json");
+}
+
+function installMetadataPath(targetDir) {
+  return path.join(targetDir, ".superlab", "install.json");
+}
+
+function ensureParentDir(filePath) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+}
+
+function writeProjectInstallMetadata(targetDir, metadata) {
+  const filePath = installMetadataPath(targetDir);
+  ensureParentDir(filePath);
+  fs.writeFileSync(filePath, JSON.stringify(metadata, null, 2) + "\n");
+}
+
+function readProjectInstallMetadata(targetDir) {
+  const filePath = installMetadataPath(targetDir);
+  if (!fs.existsSync(filePath)) {
+    throw new Error(`No superlab installation metadata found in ${targetDir}. Run 'superlab init' first.`);
+  }
+  return JSON.parse(fs.readFileSync(filePath, "utf8"));
+}
+
+function readRegistry({ env = process.env } = {}) {
+  const filePath = registryFilePath({ env });
+  if (!fs.existsSync(filePath)) {
+    return { projects: [] };
+  }
+  return JSON.parse(fs.readFileSync(filePath, "utf8"));
+}
+
+function writeRegistry(registry, { env = process.env } = {}) {
+  const filePath = registryFilePath({ env });
+  ensureParentDir(filePath);
+  fs.writeFileSync(filePath, JSON.stringify(registry, null, 2) + "\n");
+}
+
+function registerProjectInstall(targetDir, metadata, { env = process.env } = {}) {
+  const registry = readRegistry({ env });
+  const normalizedTarget = path.resolve(targetDir);
+  const entry = {
+    path: normalizedTarget,
+    platform: metadata.platform,
+    lang: metadata.lang,
+    package_version: metadata.package_version,
+    updated_at: metadata.updated_at,
+  };
+  const existingIndex = registry.projects.findIndex((project) => project.path === normalizedTarget);
+  if (existingIndex >= 0) {
+    registry.projects[existingIndex] = entry;
+  } else {
+    registry.projects.push(entry);
+  }
+  writeRegistry(registry, { env });
+}
+
 function detectLanguage({ explicitLang, env = process.env } = {}) {
   if (explicitLang) {
     if (!["en", "zh"].includes(explicitLang)) {
@@ -175,7 +243,7 @@ function localizeInstalledAssets(targetDir, lang) {
   }
 }
 
-function installSuperlab({ targetDir, platform = "both", force = false, lang } = {}) {
+function installSuperlab({ targetDir, platform = "both", force = false, lang, env = process.env } = {}) {
   const groups = [];
   if (platform === "codex" || platform === "both") {
     groups.push(...ASSET_GROUPS.codex);
@@ -188,11 +256,60 @@ function installSuperlab({ targetDir, platform = "both", force = false, lang } =
   for (const asset of groups) {
     copyDirectory(asset.from, path.join(targetDir, asset.to), force);
   }
-  localizeInstalledAssets(targetDir, detectLanguage({ explicitLang: lang }));
+  const resolvedLang = detectLanguage({ explicitLang: lang, env });
+  localizeInstalledAssets(targetDir, resolvedLang);
   chmodScripts(targetDir);
+  const metadata = {
+    target_dir: path.resolve(targetDir),
+    platform,
+    lang: resolvedLang,
+    package_version: PACKAGE_VERSION,
+    updated_at: new Date().toISOString(),
+  };
+  writeProjectInstallMetadata(targetDir, metadata);
+  registerProjectInstall(targetDir, metadata, { env });
+}
+
+function updateSuperlabProject({ targetDir, env = process.env } = {}) {
+  const metadata = readProjectInstallMetadata(targetDir);
+  installSuperlab({
+    targetDir,
+    platform: metadata.platform,
+    lang: metadata.lang,
+    force: true,
+    env,
+  });
+  return metadata;
+}
+
+function updateAllProjects({ env = process.env } = {}) {
+  const registry = readRegistry({ env });
+  const updated = [];
+  const skipped = [];
+
+  for (const project of registry.projects) {
+    try {
+      if (!fs.existsSync(project.path)) {
+        skipped.push({ path: project.path, reason: "missing project path" });
+        continue;
+      }
+      updateSuperlabProject({ targetDir: project.path, env });
+      updated.push(project.path);
+    } catch (error) {
+      skipped.push({ path: project.path, reason: error.message });
+    }
+  }
+
+  return { updated, skipped };
 }
 
 module.exports = {
   detectLanguage,
   installSuperlab,
+  installMetadataPath,
+  readProjectInstallMetadata,
+  registryFilePath,
+  readRegistry,
+  updateAllProjects,
+  updateSuperlabProject,
 };

package/package.json

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