@aspects-ai/workspace-cli 0.1.0 → 0.1.2

package/README.md

@@ -83,6 +83,21 @@ The command will:
 3. Update `workspace.config.json`
 4. Add dependencies to `package.json`
 
+### `update <library>`
+
+Update an installed library to the latest version from the repository.
+
+```bash
+WORKSPACE_CLI_TOKEN=ghp_xxx workspace-cli update animate-core
+```
+
+This command will:
+1. Check the currently installed version
+2. Fetch the latest version from the git repository
+3. Overwrite the existing files
+4. Update `workspace.config.json` with the new version and commit hash
+5. Update dependencies in `package.json` if they changed
+
 ## Usage Examples
 
 ### Basic Workflow
@@ -176,28 +191,27 @@ Libraries are defined in `src/registry/libraries.json`:
     "animate-core": {
       "name": "@aspects-ai/noodle-animate-core",
       "description": "Core animation components for Noodle videos",
-      "version": "0.1.3",
       "repository": {
         "url": "https://github.com/aspects-ai/noodle-templates.git",
         "directory": "noodle-animate-core/src",
-        "branch": "main"
+        "branch": "main",
+        "packageJsonPath": "noodle-animate-core/package.json"
       },
-      "installPath": "animate-core",
-      "dependencies": {
-        "react": "19.1.0",
-        "remotion": "4.0.356"
-      }
+      "installPath": "animate-core"
     }
   }
 }
 ```
 
+**Automatic Detection**: The CLI automatically reads both the `version` and `dependencies` from the library's `package.json` in the git repository. You don't need to hardcode these values in the registry - they're always fetched from the source of truth.
+
 ## How It Works
 
 1. **Git Sparse Checkout**: The CLI uses git sparse checkout to efficiently fetch only the required directory from the repository
-2. **Local Installation**: Files are copied to `./core/<library-name>/` in your workspace
-3. **Dependency Management**: Required dependencies are automatically added to your `package.json`
-4. **Version Tracking**: The exact git commit hash is stored for reproducibility
+2. **Automatic Metadata Detection**: Both version and dependencies are read from the library's `package.json` in the repository, so they're always up-to-date
+3. **Local Installation**: Files are copied to `./core/<library-name>/` in your workspace
+4. **Dependency Management**: Required dependencies are automatically added to your `package.json`
+5. **Version Tracking**: The exact git commit hash and detected version are stored for reproducibility
 
 ## Error Handling
 
@@ -249,20 +263,19 @@ Example:
   "my-library": {
     "name": "@aspects-ai/my-library",
     "description": "Description of the library",
-    "version": "1.0.0",
     "repository": {
       "url": "https://github.com/org/repo.git",
       "directory": "path/to/library/src",
-      "branch": "main"
+      "branch": "main",
+      "packageJsonPath": "path/to/library/package.json"
     },
-    "installPath": "my-library",
-    "dependencies": {
-      "react": "^18.0.0"
-    }
+    "installPath": "my-library"
   }
 }
 ```
 
+**Note**: Both `version` and `dependencies` fields are optional. If you provide `packageJsonPath`, the CLI will automatically read these from the library's `package.json` in the repository. This keeps the registry minimal and ensures values are always current.
+
 ## License
 
 ISC

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command4 } from "commander";
+import { Command as Command5 } from "commander";
 
 // src/commands/init.ts
 import { Command } from "commander";
@@ -165,15 +165,19 @@ import { z as z2 } from "zod";
 var RepositorySchema = z2.object({
   url: z2.string(),
   directory: z2.string(),
-  branch: z2.string()
+  branch: z2.string(),
+  packageJsonPath: z2.string().optional()
+  // Path to package.json in repo (e.g., "noodle-animate-core/package.json")
 });
 var LibrarySchema = z2.object({
   name: z2.string(),
   description: z2.string(),
-  version: z2.string(),
+  version: z2.string().optional(),
+  // Optional - if not provided, will be read from package.json in repo
   repository: RepositorySchema,
   installPath: z2.string(),
-  dependencies: z2.record(z2.string())
+  dependencies: z2.record(z2.string()).optional()
+  // Optional - if not provided, will be read from package.json in repo
 });
 var RegistrySchema = z2.object({
   libraries: z2.record(LibrarySchema)
@@ -215,7 +219,8 @@ function createListCommand() {
       const libraries = await listLibraries();
       logger.log(chalk2.bold("\nAvailable libraries:\n"));
       for (const { name, library } of libraries) {
-        logger.log(chalk2.cyan(`  ${name}`) + chalk2.gray(` @${library.version}`));
+        const versionStr = library.version ? ` @${library.version}` : " @latest";
+        logger.log(chalk2.cyan(`  ${name}`) + chalk2.gray(versionStr));
         logger.log(`    ${library.description}`);
         logger.log("");
       }
@@ -251,8 +256,13 @@ async function fetchDirectory(options) {
     await execa("git", ["remote", "add", "origin", repoUrl], { cwd: tempDir });
     await execa("git", ["config", "core.sparseCheckout", "true"], { cwd: tempDir });
     const sparseFile = path3.join(tempDir, ".git", "info", "sparse-checkout");
-    await fs3.writeFile(sparseFile, `${options.directory}/*
-`);
+    let sparsePaths = `${options.directory}/*
+`;
+    if (options.packageJsonPath) {
+      sparsePaths += `${options.packageJsonPath}
+`;
+    }
+    await fs3.writeFile(sparseFile, sparsePaths);
     await execa("git", ["pull", "origin", options.branch, "--depth=1"], {
       cwd: tempDir,
       stderr: "pipe"
@@ -267,7 +277,26 @@ async function fetchDirectory(options) {
       overwrite: true,
       errorOnExist: false
     });
-    return commit.trim();
+    let version = null;
+    let dependencies = {};
+    if (options.packageJsonPath) {
+      const packageJsonFullPath = path3.join(tempDir, options.packageJsonPath);
+      if (await fs3.pathExists(packageJsonFullPath)) {
+        try {
+          const packageJson = await fs3.readJson(packageJsonFullPath);
+          version = packageJson.version || null;
+          dependencies = packageJson.dependencies || {};
+        } catch (error) {
+          version = null;
+          dependencies = {};
+        }
+      }
+    }
+    return {
+      commit: commit.trim(),
+      version,
+      dependencies
+    };
   } catch (error) {
     if (error.stderr && error.stderr.includes("Authentication failed")) {
       throw new Error(
@@ -305,20 +334,24 @@ Use --force to reinstall.`
   const config = await loadWorkspaceConfig(workspaceRoot);
   const coreDir = config?.coreDir || "./core";
   const targetPath = path4.join(workspaceRoot, coreDir, library.installPath);
-  logger.info(`Fetching ${libraryName}@${library.version} from git...`);
-  const commit = await fetchDirectory({
+  const versionDisplay = library.version || "latest";
+  logger.info(`Fetching ${libraryName}@${versionDisplay} from git...`);
+  const result = await fetchDirectory({
     repository: library.repository.url,
     directory: library.repository.directory,
     branch: library.repository.branch,
     token,
-    targetPath
+    targetPath,
+    packageJsonPath: library.repository.packageJsonPath
   });
+  const actualVersion = result.version || library.version || "unknown";
+  const actualDependencies = Object.keys(result.dependencies).length > 0 ? result.dependencies : library.dependencies || {};
   logger.info(`Installed to ${path4.relative(workspaceRoot, targetPath)}`);
   logger.info(`Updating workspace.config.json...`);
-  await addLibraryToConfig(workspaceRoot, libraryName, library.version, commit);
-  await updatePackageDependencies(workspaceRoot, library.dependencies);
+  await addLibraryToConfig(workspaceRoot, libraryName, actualVersion, result.commit);
+  await updatePackageDependencies(workspaceRoot, actualDependencies);
   logger.success(
-    `Installed ${libraryName}@${library.version} (commit: ${commit.substring(0, 7)})`
+    `Installed ${libraryName}@${actualVersion} (commit: ${result.commit.substring(0, 7)})`
   );
 }
 async function updatePackageDependencies(workspaceRoot, dependencies) {
@@ -364,10 +397,42 @@ function createAddCommand() {
   });
 }
 
+// src/commands/update.ts
+import { Command as Command4 } from "commander";
+import chalk4 from "chalk";
+function createUpdateCommand() {
+  return new Command4("update").description("Update an installed library to the latest version").argument("<library>", "Name of the library to update").action(async (libraryName) => {
+    try {
+      const workspaceRoot = await ensureWorkspaceRoot();
+      await getOrCreateConfig(workspaceRoot);
+      if (!await isLibraryInstalled(workspaceRoot, libraryName)) {
+        throw new Error(
+          `Library '${libraryName}' is not installed.
+Use 'workspace-cli add ${libraryName}' to install it first.`
+        );
+      }
+      const config = await loadWorkspaceConfig(workspaceRoot);
+      const currentVersion = config?.libraries[libraryName]?.version || "unknown";
+      const currentCommit = config?.libraries[libraryName]?.commit || "unknown";
+      logger.info(`Current version: ${currentVersion} (commit: ${currentCommit.substring(0, 7)})`);
+      logger.info(`Updating ${libraryName}...`);
+      await installLibrary(workspaceRoot, libraryName, { force: true });
+      logger.log("\n" + chalk4.bold("Next steps:"));
+      logger.log(`  ${chalk4.gray("Review changes:")} git diff ./core/${libraryName.replace("animate-", "")}`);
+      logger.log(`  ${chalk4.gray("Install updated dependencies:")} npm install`);
+      logger.log("");
+    } catch (error) {
+      logger.error(error.message);
+      process.exit(1);
+    }
+  });
+}
+
 // src/index.ts
-var program = new Command4();
+var program = new Command5();
 program.name("workspace-cli").description("Lightweight CLI for installing libraries into workspaces").version("0.1.0");
 program.addCommand(createInitCommand());
 program.addCommand(createListCommand());
 program.addCommand(createAddCommand());
+program.addCommand(createUpdateCommand());
 program.parse(process.argv);

package/dist/registry/libraries.json

@@ -3,29 +3,13 @@
     "animate-core": {
       "name": "@aspects-ai/noodle-animate-core",
       "description": "Core animation components for Noodle videos",
-      "version": "0.1.3",
       "repository": {
         "url": "https://github.com/aspects-ai/noodle-templates.git",
         "directory": "noodle-animate-core/src",
-        "branch": "main"
+        "branch": "main",
+        "packageJsonPath": "noodle-animate-core/package.json"
       },
-      "installPath": "animate-core",
-      "dependencies": {
-        "react": "19.1.0",
-        "react-dom": "19.1.0",
-        "remotion": "4.0.356",
-        "react-rnd": "^10.5.2",
-        "class-variance-authority": "^0.7.1",
-        "clsx": "^2.1.1",
-        "cmdk": "^1.1.1",
-        "date-fns": "^4.1.0",
-        "embla-carousel-react": "^8.6.0",
-        "input-otp": "^1.4.2",
-        "lucide-react": "^0.542.0",
-        "tailwind-merge": "^3.3.1",
-        "tailwindcss-animate": "^1.0.7",
-        "vaul": "^1.1.2"
-      }
+      "installPath": "animate-core"
     }
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aspects-ai/workspace-cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "private": false,
   "description": "Lightweight CLI for installing libraries into workspaces",
   "type": "module",
@@ -33,4 +33,4 @@
   "engines": {
     "node": ">=18.0.0"
   }
-}
+}

package/src/registry/libraries.json

@@ -3,29 +3,13 @@
     "animate-core": {
       "name": "@aspects-ai/noodle-animate-core",
       "description": "Core animation components for Noodle videos",
-      "version": "0.1.3",
       "repository": {
         "url": "https://github.com/aspects-ai/noodle-templates.git",
         "directory": "noodle-animate-core/src",
-        "branch": "main"
+        "branch": "main",
+        "packageJsonPath": "noodle-animate-core/package.json"
       },
-      "installPath": "animate-core",
-      "dependencies": {
-        "react": "19.1.0",
-        "react-dom": "19.1.0",
-        "remotion": "4.0.356",
-        "react-rnd": "^10.5.2",
-        "class-variance-authority": "^0.7.1",
-        "clsx": "^2.1.1",
-        "cmdk": "^1.1.1",
-        "date-fns": "^4.1.0",
-        "embla-carousel-react": "^8.6.0",
-        "input-otp": "^1.4.2",
-        "lucide-react": "^0.542.0",
-        "tailwind-merge": "^3.3.1",
-        "tailwindcss-animate": "^1.0.7",
-        "vaul": "^1.1.2"
-      }
+      "installPath": "animate-core"
     }
   }
-}
+}