@zucker-framework/cli 1.0.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,22 @@
+Zucker Framework
+Copyright 2026 Lind and Zucker Framework contributors
+
+Licensed under the Apache License, Version 2.0. See LICENSE.
+
+The framework includes TypeScript adaptations and enhancements of concepts and
+implementations from hsweb-framework and jetlinks-community, both distributed
+under the Apache License, Version 2.0. Individual packages use different subsets
+of the framework. The TypeScript adaptations and Node.js integrations were
+modified for Zucker Framework; they are not the original upstream distribution.
+
+hsweb-framework
+https://github.com/hs-web/hsweb-framework
+Copyright 2020 http://hsweb.me
+
+jetlinks-community
+https://github.com/jetlinks/jetlinks-community
+
+See THIRD_PARTY_NOTICES for license texts and attribution for bundled dependencies
+and reference implementations relevant to this package. External dependencies
+remain subject to their own licenses. This NOTICE is informational and does not
+modify any license or grant rights to upstream trademarks.

package/THIRD_PARTY_NOTICES

@@ -0,0 +1,4 @@
+@zucker-framework/cli
+
+No separately recorded third-party implementation is bundled in this package.
+External dependencies retain their own licenses; see NOTICE for framework attribution.

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,828 @@
+#!/usr/bin/env node
+"use strict";
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/index.ts
+var import_config = require("dotenv/config");
+var import_commander6 = require("commander");
+var import_node_fs = require("fs");
+var import_node_path = require("path");
+
+// src/commands/doctor.ts
+var import_commander = require("commander");
+var import_fs = require("fs");
+var import_path = require("path");
+async function runDiagnostics() {
+  const results = [];
+  const cwd = process.cwd();
+  const pkgPath = (0, import_path.resolve)(cwd, "package.json");
+  if (!(0, import_fs.existsSync)(pkgPath)) {
+    results.push({
+      name: "package.json",
+      status: "error",
+      message: "package.json not found. Are you in a Zucker project directory?"
+    });
+    return results;
+  }
+  results.push({
+    name: "package.json",
+    status: "ok",
+    message: "Found"
+  });
+  const nodeVersion = process.versions.node;
+  const major = parseInt(nodeVersion.split(".")[0], 10);
+  if (major < 20) {
+    results.push({
+      name: "Node.js",
+      status: "error",
+      message: `v${nodeVersion} detected. Zucker requires Node.js >= 20.`
+    });
+  } else {
+    results.push({
+      name: "Node.js",
+      status: "ok",
+      message: `v${nodeVersion}`
+    });
+  }
+  let pkg = {};
+  try {
+    pkg = JSON.parse((0, import_fs.readFileSync)(pkgPath, "utf-8"));
+  } catch {
+    results.push({
+      name: "package.json",
+      status: "error",
+      message: "Failed to parse package.json"
+    });
+    return results;
+  }
+  const deps = {
+    ...pkg.dependencies,
+    ...pkg.devDependencies
+  };
+  const requiredPkgs = [
+    "@zucker-framework/core",
+    "@zucker-framework/crud",
+    "@zucker-framework/common"
+  ];
+  for (const name of requiredPkgs) {
+    if (deps[name]) {
+      results.push({
+        name,
+        status: "ok",
+        message: deps[name]
+      });
+    } else {
+      results.push({
+        name,
+        status: "warn",
+        message: "Not installed"
+      });
+    }
+  }
+  const envChecks = [
+    {
+      name: "JWT_SECRET",
+      envVar: "JWT_SECRET",
+      required: true
+    },
+    {
+      name: "DATABASE_URL",
+      envVar: "DATABASE_URL",
+      required: false
+    }
+  ];
+  for (const check of envChecks) {
+    const value = process.env[check.envVar];
+    if (value) {
+      results.push({
+        name: check.name,
+        status: "ok",
+        message: `Set (${value.substring(0, 8)}...)`
+      });
+    } else if (check.required) {
+      results.push({
+        name: check.name,
+        status: "warn",
+        message: "Not set. Required for production."
+      });
+    } else {
+      results.push({
+        name: check.name,
+        status: "ok",
+        message: "Not set (optional \u2014 will use InMemoryAdapter)"
+      });
+    }
+  }
+  const envLocalPath = (0, import_path.resolve)(cwd, ".env.local");
+  if ((0, import_fs.existsSync)(envLocalPath)) {
+    results.push({
+      name: ".env.local",
+      status: "ok",
+      message: "Found"
+    });
+  } else {
+    results.push({
+      name: ".env.local",
+      status: "warn",
+      message: "Not found. Consider creating one for local development."
+    });
+  }
+  const tsconfigPath = (0, import_path.resolve)(cwd, "tsconfig.json");
+  if ((0, import_fs.existsSync)(tsconfigPath)) {
+    results.push({
+      name: "tsconfig.json",
+      status: "ok",
+      message: "Found"
+    });
+  } else {
+    results.push({
+      name: "tsconfig.json",
+      status: "error",
+      message: "Not found"
+    });
+  }
+  return results;
+}
+__name(runDiagnostics, "runDiagnostics");
+function formatStatus(status) {
+  switch (status) {
+    case "ok":
+      return "\x1B[32m[OK]\x1B[0m";
+    case "warn":
+      return "\x1B[33m[WARN]\x1B[0m";
+    case "error":
+      return "\x1B[31m[ERROR]\x1B[0m";
+  }
+}
+__name(formatStatus, "formatStatus");
+var doctorCommand = new import_commander.Command("doctor").description("Check project health and configuration").action(async () => {
+  console.log("\n  Zucker Doctor\n");
+  console.log("  Running diagnostics...\n");
+  const results = await runDiagnostics();
+  const maxNameLen = Math.max(...results.map((r) => r.name.length));
+  for (const result of results) {
+    const padding = " ".repeat(maxNameLen - result.name.length);
+    console.log(`  ${formatStatus(result.status)}  ${result.name}${padding}  ${result.message}`);
+  }
+  const errors = results.filter((r) => r.status === "error");
+  const warnings = results.filter((r) => r.status === "warn");
+  console.log("");
+  if (errors.length > 0) {
+    console.log(`  \x1B[31m${errors.length} error(s)\x1B[0m found. Please fix them before proceeding.`);
+  } else if (warnings.length > 0) {
+    console.log(`  \x1B[33m${warnings.length} warning(s)\x1B[0m found. Review them for production readiness.`);
+  } else {
+    console.log("  \x1B[32mAll checks passed!\x1B[0m");
+  }
+  console.log("");
+});
+
+// src/commands/init.ts
+var import_commander2 = require("commander");
+var import_fs2 = require("fs");
+var import_path2 = require("path");
+var import_node_crypto = require("crypto");
+function readReleaseCatalog() {
+  const path = (0, import_path2.resolve)(__dirname, "release-catalog.json");
+  if (!(0, import_fs2.existsSync)(path)) throw new Error("CLI release catalog is missing; build or reinstall the CLI package.");
+  return JSON.parse((0, import_fs2.readFileSync)(path, "utf8"));
+}
+__name(readReleaseCatalog, "readReleaseCatalog");
+var initCommand = new import_commander2.Command("init").description("Initialize a new Zucker project").argument("[name]", "Project name", "zucker-app").option("--template <template>", "Template to use (server, admin, web)", "server").action(async (name, options) => {
+  if (![
+    "server",
+    "admin",
+    "web"
+  ].includes(options.template)) {
+    throw new Error(`Unsupported template: ${options.template}`);
+  }
+  if (!/^[a-z0-9][a-z0-9._-]*$/.test(name)) throw new Error("Project name must use lowercase letters, digits, dots, underscores or hyphens.");
+  const catalog = readReleaseCatalog();
+  const targetDir = (0, import_path2.resolve)(process.cwd(), name);
+  console.log(`
+  Initializing Zucker project: ${name}`);
+  console.log(`  Template: ${options.template}`);
+  console.log(`  Directory: ${targetDir}
+`);
+  if ((0, import_fs2.existsSync)(targetDir)) {
+    console.log(`  \x1B[31mError:\x1B[0m Directory "${name}" already exists.`);
+    process.exit(1);
+  }
+  const monorepoTemplate = (0, import_path2.resolve)(__dirname, "..", "..", "..", "templates", options.template);
+  const templateDir2 = (0, import_fs2.existsSync)(monorepoTemplate) ? monorepoTemplate : null;
+  if (!templateDir2) {
+    if (options.template !== "server") {
+      throw new Error(`The ${options.template} template requires a framework checkout. The installed CLI includes the standalone server scaffold.`);
+    }
+    console.log(`  \x1B[33mNote:\x1B[0m Template "${options.template}" not found locally.`);
+    console.log("  Generating minimal project scaffold instead.\n");
+    (0, import_fs2.mkdirSync)((0, import_path2.resolve)(targetDir, "src"), {
+      recursive: true
+    });
+    const pkg = {
+      name,
+      version: "0.1.0",
+      private: true,
+      type: "commonjs",
+      engines: {
+        node: ">=22.12.0"
+      },
+      scripts: {
+        dev: "nest start --watch",
+        build: "nest build",
+        start: "node dist/main.js"
+      },
+      dependencies: catalog.server.dependencies,
+      devDependencies: catalog.server.devDependencies
+    };
+    (0, import_fs2.writeFileSync)((0, import_path2.resolve)(targetDir, "package.json"), JSON.stringify(pkg, null, 2) + "\n");
+    const tsconfig = {
+      compilerOptions: {
+        module: "NodeNext",
+        moduleResolution: "NodeNext",
+        target: "ES2022",
+        strict: true,
+        esModuleInterop: true,
+        skipLibCheck: true,
+        experimentalDecorators: true,
+        emitDecoratorMetadata: true,
+        sourceMap: false,
+        declarationMap: false,
+        outDir: "dist",
+        rootDir: "src"
+      },
+      include: [
+        "src"
+      ]
+    };
+    (0, import_fs2.writeFileSync)((0, import_path2.resolve)(targetDir, "tsconfig.json"), JSON.stringify(tsconfig, null, 2) + "\n");
+    (0, import_fs2.writeFileSync)((0, import_path2.resolve)(targetDir, "nest-cli.json"), JSON.stringify({
+      sourceRoot: "src",
+      compilerOptions: {
+        deleteOutDir: true
+      }
+    }, null, 2) + "\n");
+    (0, import_fs2.writeFileSync)((0, import_path2.resolve)(targetDir, ".gitignore"), "node_modules/\ndist/\n.env\n.env.local\n");
+    (0, import_fs2.writeFileSync)((0, import_path2.resolve)(targetDir, ".env"), `JWT_SECRET=${(0, import_node_crypto.randomBytes)(32).toString("hex")}
+`, {
+      mode: 384
+    });
+    (0, import_fs2.writeFileSync)((0, import_path2.resolve)(targetDir, ".env.example"), [
+      "# JWT secret \u2014 required for production",
+      "# JWT_SECRET=your-secure-secret-here",
+      "",
+      "# Database URL \u2014 leave unset to use InMemoryAdapter",
+      "# DATABASE_URL=postgresql://user:pass@localhost:5432/zucker",
+      ""
+    ].join("\n"));
+    (0, import_fs2.writeFileSync)((0, import_path2.resolve)(targetDir, "src", "main.ts"), [
+      "import 'dotenv/config';",
+      "import { NestFactory } from '@nestjs/core';",
+      "import { ValidationPipe, Logger } from '@nestjs/common';",
+      "import { HttpExceptionFilter } from '@zucker-framework/common';",
+      "import { AppModule } from './app.module';",
+      "",
+      "async function bootstrap() {",
+      "  const startTime = performance.now();",
+      "  const app = await NestFactory.create(AppModule);",
+      "",
+      "  app.setGlobalPrefix('api');",
+      "  app.useGlobalFilters(new HttpExceptionFilter());",
+      "  app.useGlobalPipes(new ValidationPipe({ transform: true }));",
+      "",
+      "  const port = process.env.PORT || 4200;",
+      "  await app.listen(port);",
+      "",
+      "  const elapsed = (performance.now() - startTime).toFixed(0);",
+      "  Logger.log(`Server ready on http://localhost:${port} (${elapsed}ms)`, 'Bootstrap');",
+      "}",
+      "",
+      "bootstrap();",
+      ""
+    ].join("\n"));
+    (0, import_fs2.writeFileSync)((0, import_path2.resolve)(targetDir, "src", "app.module.ts"), [
+      "import { Module } from '@nestjs/common';",
+      "import { EventEmitterModule } from '@nestjs/event-emitter';",
+      "import { ZuckerEventModule } from '@zucker-framework/event';",
+      "import { ZuckerCommonModule } from '@zucker-framework/common';",
+      "import { ZuckerCrudModule, InMemoryAdapter } from '@zucker-framework/crud';",
+      "import { ZuckerAuthModule } from '@zucker-framework/auth';",
+      "",
+      "@Module({",
+      "  imports: [",
+      "    EventEmitterModule.forRoot(),",
+      "    ZuckerEventModule.forRoot(),",
+      "    ZuckerCommonModule,",
+      "    ZuckerCrudModule.forRoot({ adapterClass: InMemoryAdapter }),",
+      "    ZuckerAuthModule.forRoot({ jwtSecret: process.env.JWT_SECRET }),",
+      "  ],",
+      "})",
+      "export class AppModule {}",
+      ""
+    ].join("\n"));
+    console.log("  \x1B[32mProject scaffolded successfully!\x1B[0m\n");
+    console.log("  Next steps:");
+    console.log(`    cd ${name}`);
+    console.log("    pnpm install");
+    console.log("    pnpm dev\n");
+    return;
+  }
+  console.log(`  Copying template from ${templateDir2}...
+`);
+  (0, import_fs2.cpSync)(templateDir2, targetDir, {
+    recursive: true,
+    filter: /* @__PURE__ */ __name((src) => !src.split(/[\\/]/).some((part) => [
+      "node_modules",
+      "dist",
+      ".turbo",
+      ".next",
+      ".cache",
+      "generated"
+    ].includes(part) || part.startsWith(".env") && part !== ".env.example" || part.endsWith(".tsbuildinfo")), "filter")
+  });
+  const copiedManifestPath = (0, import_path2.resolve)(targetDir, "package.json");
+  const copiedManifest = JSON.parse((0, import_fs2.readFileSync)(copiedManifestPath, "utf8"));
+  copiedManifest.name = name;
+  for (const field of [
+    "dependencies",
+    "devDependencies",
+    "peerDependencies",
+    "optionalDependencies"
+  ]) {
+    const entries = copiedManifest[field];
+    for (const [dependency, version] of Object.entries(entries ?? {})) {
+      if (!version.startsWith("workspace:")) continue;
+      const releasedVersion = catalog.versions[dependency];
+      if (!releasedVersion) throw new Error(`No release version found for ${dependency}`);
+      entries[dependency] = releasedVersion;
+    }
+  }
+  (0, import_fs2.writeFileSync)(copiedManifestPath, JSON.stringify(copiedManifest, null, 2) + "\n");
+  console.log("  \x1B[32mProject created successfully!\x1B[0m\n");
+  console.log("  Next steps:");
+  console.log(`    cd ${name}`);
+  console.log("    pnpm install");
+  console.log("    pnpm dev\n");
+});
+
+// src/commands/add.ts
+var import_commander3 = require("commander");
+var import_fs3 = require("fs");
+var import_path3 = require("path");
+var import_child_process = require("child_process");
+var MODULE_REGISTRY = {
+  auth: {
+    pkg: "@zucker-framework/auth",
+    peerDeps: [
+      "@nestjs/passport",
+      "@nestjs/jwt"
+    ],
+    moduleImport: "import { ZuckerAuthModule } from '@zucker-framework/auth';",
+    moduleSetup: "ZuckerAuthModule.forRoot({ jwtSecret: process.env.JWT_SECRET })"
+  },
+  logging: {
+    pkg: "@zucker-framework/logging",
+    moduleImport: "import { ZuckerLoggingModule } from '@zucker-framework/logging';",
+    moduleSetup: "ZuckerLoggingModule.forRoot()"
+  },
+  config: {
+    pkg: "@zucker-framework/config",
+    moduleImport: "import { ZuckerConfigModule } from '@zucker-framework/config';",
+    moduleSetup: "ZuckerConfigModule.forRoot()"
+  },
+  dictionary: {
+    pkg: "@zucker-framework/dictionary",
+    moduleImport: "import { ZuckerDictionaryModule } from '@zucker-framework/dictionary';",
+    moduleSetup: "ZuckerDictionaryModule.forRoot()"
+  },
+  cache: {
+    pkg: "@zucker-framework/cache",
+    moduleImport: "import { ZuckerCacheModule } from '@zucker-framework/cache';",
+    moduleSetup: "ZuckerCacheModule.forRoot({ provider: 'memory' })"
+  },
+  storage: {
+    pkg: "@zucker-framework/storage",
+    moduleImport: "import { ZuckerStorageModule } from '@zucker-framework/storage';",
+    moduleSetup: "ZuckerStorageModule.forRoot({ provider: 'local', basePath: './uploads' })"
+  },
+  notification: {
+    pkg: "@zucker-framework/notification",
+    moduleImport: "import { ZuckerNotificationModule } from '@zucker-framework/notification';",
+    moduleSetup: "ZuckerNotificationModule.forRoot({ providers: [] })"
+  },
+  credit: {
+    pkg: "@zucker-framework/credit",
+    moduleImport: "import { ZuckerCreditModule } from '@zucker-framework/credit';",
+    moduleSetup: "ZuckerCreditModule.forRoot()"
+  },
+  ai: {
+    pkg: "@zucker-framework/ai",
+    moduleImport: "import { ZuckerAIModule } from '@zucker-framework/ai';",
+    moduleSetup: "ZuckerAIModule.forRoot()"
+  },
+  tenant: {
+    pkg: "@zucker-framework/tenant",
+    moduleImport: "import { ZuckerTenantModule } from '@zucker-framework/tenant';",
+    moduleSetup: "ZuckerTenantModule.forRoot()"
+  },
+  form: {
+    pkg: "@zucker-framework/form",
+    moduleImport: "import { ZuckerFormModule } from '@zucker-framework/form';",
+    moduleSetup: "ZuckerFormModule.forRoot()"
+  },
+  monitoring: {
+    pkg: "@zucker-framework/monitoring",
+    moduleImport: "import { ZuckerMonitoringModule } from '@zucker-framework/monitoring';",
+    moduleSetup: "ZuckerMonitoringModule"
+  },
+  "rate-limiter": {
+    pkg: "@zucker-framework/rate-limiter",
+    moduleImport: "import { ZuckerRateLimiterModule } from '@zucker-framework/rate-limiter';",
+    moduleSetup: `ZuckerRateLimiterModule.forRoot({
+      limiters: {
+        login: { points: 5, duration: 900 },
+        'api-default': { points: 100, duration: 60 },
+      },
+    })`
+  }
+};
+function detectPackageManager() {
+  const cwd = process.cwd();
+  if ((0, import_fs3.existsSync)((0, import_path3.resolve)(cwd, "pnpm-lock.yaml")) || (0, import_fs3.existsSync)((0, import_path3.resolve)(cwd, "pnpm-workspace.yaml"))) {
+    return "pnpm";
+  }
+  if ((0, import_fs3.existsSync)((0, import_path3.resolve)(cwd, "yarn.lock"))) return "yarn";
+  return "npm";
+}
+__name(detectPackageManager, "detectPackageManager");
+var addCommand = new import_commander3.Command("add").description("Add a Zucker module to the current project").argument("<module>", `Module name (${Object.keys(MODULE_REGISTRY).join(", ")})`).option("--dry-run", "Show what would be done without making changes", false).action(async (moduleName, options) => {
+  const entry = MODULE_REGISTRY[moduleName];
+  if (!entry) {
+    console.log(`
+  \x1B[31mError:\x1B[0m Unknown module "${moduleName}".`);
+    console.log(`  Available modules: ${Object.keys(MODULE_REGISTRY).join(", ")}
+`);
+    process.exit(1);
+  }
+  console.log(`
+  Adding @zucker-framework/${moduleName} to your project...
+`);
+  const pm = detectPackageManager();
+  const pkgs = [
+    entry.pkg,
+    ...entry.peerDeps ?? []
+  ];
+  const installCmd = pm === "pnpm" ? `pnpm add ${pkgs.join(" ")}` : pm === "yarn" ? `yarn add ${pkgs.join(" ")}` : `npm install ${pkgs.join(" ")}`;
+  if (options.dryRun) {
+    console.log(`  [dry-run] Would run: ${installCmd}`);
+  } else {
+    console.log(`  Running: ${installCmd}`);
+    try {
+      (0, import_child_process.execSync)(installCmd, {
+        stdio: "inherit",
+        cwd: process.cwd()
+      });
+    } catch {
+      console.log(`
+  \x1B[33mWarning:\x1B[0m Package install failed. You may need to install manually.
+`);
+    }
+  }
+  console.log("\n  Add the following to your AppModule:\n");
+  console.log(`  \x1B[36m// Import:\x1B[0m`);
+  console.log(`  ${entry.moduleImport}
+`);
+  console.log(`  \x1B[36m// In @Module imports array:\x1B[0m`);
+  console.log(`  ${entry.moduleSetup},
+`);
+  console.log("  \x1B[32mDone!\x1B[0m\n");
+});
+
+// src/commands/ext.ts
+var import_commander4 = require("commander");
+var import_fs4 = require("fs");
+var import_path4 = require("path");
+var monorepoRoot = (0, import_path4.resolve)(__dirname, "..", "..", "..");
+var kitDir = (0, import_path4.join)(monorepoRoot, "packages", "ext-kit");
+var templateDir = (0, import_path4.join)(monorepoRoot, "templates", "extension");
+var VENDORED = [
+  {
+    from: (0, import_path4.join)(kitDir, "dist", "ext-kit.js"),
+    to: "lib/ext-kit.js"
+  },
+  {
+    from: (0, import_path4.join)(kitDir, "dist", "ext-kit-popup.js"),
+    to: "lib/ext-kit-popup.js"
+  },
+  {
+    from: (0, import_path4.join)(kitDir, "assets", "offscreen.html"),
+    to: "offscreen.html"
+  },
+  {
+    from: (0, import_path4.join)(kitDir, "assets", "offscreen.js"),
+    to: "offscreen.js"
+  },
+  {
+    from: (0, import_path4.join)(kitDir, "assets", "package.mjs"),
+    to: "scripts/package.mjs"
+  }
+];
+function syncVendored(extDir) {
+  const updated = [];
+  for (const file of VENDORED) {
+    if (!(0, import_fs4.existsSync)(file.from)) {
+      throw new Error(`Kit artifact missing: ${file.from} \u2014 run \`pnpm --filter @zucker-framework/ext-kit build\` first.`);
+    }
+    const dest = (0, import_path4.join)(extDir, file.to);
+    (0, import_fs4.mkdirSync)((0, import_path4.join)(dest, ".."), {
+      recursive: true
+    });
+    const next = (0, import_fs4.readFileSync)(file.from);
+    const prev = (0, import_fs4.existsSync)(dest) ? (0, import_fs4.readFileSync)(dest) : null;
+    if (!prev || !prev.equals(next)) {
+      (0, import_fs4.writeFileSync)(dest, next);
+      updated.push(file.to);
+    }
+  }
+  return updated;
+}
+__name(syncVendored, "syncVendored");
+function isExtensionDir(dir) {
+  return (0, import_fs4.existsSync)((0, import_path4.join)(dir, "manifest.json")) && (0, import_fs4.existsSync)((0, import_path4.join)(dir, "lib", "ext-kit.js"));
+}
+__name(isExtensionDir, "isExtensionDir");
+var createCommand = new import_commander4.Command("create").description("Scaffold a new browser extension on top of @zucker-framework/ext-kit").argument("<slug>", 'Product slug, lowercase (e.g. "sampleext") \u2014 storage keys & server product id').option("--name <name>", 'Store display name (e.g. "Sample Extension")').option("--brand <brand>", 'Brand word (e.g. "Sample") \u2014 folder prefix, wordmark').option("--desc <desc>", "Store description").option("--accent <color>", "Accent color", "#7c8cff").option("--accent-deep <color>", "Deep accent color", "#5a6cf0").option("--badge <color>", "Badge background color", "#4353d9").option("--dir <dir>", "Target directory (default: <slug>-extension)").action((slug, options) => {
+  if (!/^[a-z][a-z0-9]*$/.test(slug)) {
+    console.log('  \x1B[31mError:\x1B[0m slug must be lowercase alphanumeric, e.g. "sampleext".');
+    process.exit(1);
+  }
+  const brand = options.brand || slug.charAt(0).toUpperCase() + slug.slice(1);
+  const name = options.name || `${brand} Extension`;
+  const desc = options.desc || `${brand} browser extension.`;
+  const targetDir = (0, import_path4.resolve)(process.cwd(), options.dir || `${slug}-extension`);
+  if ((0, import_fs4.existsSync)(targetDir)) {
+    console.log(`  \x1B[31mError:\x1B[0m Directory already exists: ${targetDir}`);
+    process.exit(1);
+  }
+  if (!(0, import_fs4.existsSync)(templateDir)) {
+    console.log(`  \x1B[31mError:\x1B[0m Template not found: ${templateDir}`);
+    process.exit(1);
+  }
+  (0, import_fs4.cpSync)(templateDir, targetDir, {
+    recursive: true
+  });
+  const repls = [
+    [
+      "__EXT_NAME__",
+      name
+    ],
+    [
+      "__EXT_DESC__",
+      desc
+    ],
+    [
+      "__EXT_BRAND__",
+      brand
+    ],
+    [
+      "__EXT_PREFIX__",
+      slug.toUpperCase()
+    ],
+    [
+      "__EXT_SLUG__",
+      slug
+    ],
+    [
+      "__EXT_ACCENT_DEEP__",
+      options.accentDeep
+    ],
+    [
+      "__EXT_ACCENT__",
+      options.accent
+    ],
+    [
+      "__EXT_BADGE_COLOR__",
+      options.badge
+    ]
+  ];
+  const walk = /* @__PURE__ */ __name((dir) => {
+    for (const entry of (0, import_fs4.readdirSync)(dir)) {
+      const p = (0, import_path4.join)(dir, entry);
+      if ((0, import_fs4.statSync)(p).isDirectory()) {
+        walk(p);
+      } else {
+        let content = (0, import_fs4.readFileSync)(p, "utf8");
+        for (const [a, b] of repls) {
+          content = content.split(a).join(b);
+        }
+        (0, import_fs4.writeFileSync)(p, content);
+      }
+    }
+  }, "walk");
+  walk(targetDir);
+  const updated = syncVendored(targetDir);
+  console.log(`
+  Created ${targetDir}`);
+  console.log(`  Vendored: ${updated.join(", ")}`);
+  console.log("\n  Next steps:");
+  console.log("  1. Implement capture() in background.js (default: full-page screenshot).");
+  console.log("  2. Adjust popup settings fields in popup/popup.html + popup.js.");
+  console.log("  3. Add icons/ and the manifest icons field.");
+  console.log(`  4. Register product "${slug}" on the licensing server + create a Stripe Payment Link.
+`);
+});
+var syncCommand = new import_commander4.Command("sync").description("Refresh vendored ext-kit artifacts (lib/ext-kit*.js, offscreen, package script) in extensions").argument("[dirs...]", "Extension directories (default: scan cwd + direct children)").action((dirs) => {
+  let targets = (dirs || []).map((d) => (0, import_path4.resolve)(process.cwd(), d));
+  if (!targets.length) {
+    const cwd = process.cwd();
+    targets = isExtensionDir(cwd) ? [
+      cwd
+    ] : (0, import_fs4.readdirSync)(cwd).map((entry) => (0, import_path4.join)(cwd, entry)).filter((p) => (0, import_fs4.statSync)(p).isDirectory() && isExtensionDir(p));
+  }
+  if (!targets.length) {
+    console.log("  No extension directories found (need manifest.json + lib/ext-kit.js).");
+    process.exit(1);
+  }
+  for (const dir of targets) {
+    if (!isExtensionDir(dir)) {
+      console.log(`  Skipped (not an ext-kit extension): ${dir}`);
+      continue;
+    }
+    const updated = syncVendored(dir);
+    console.log(`  ${dir}: ${updated.length ? `updated ${updated.join(", ")}` : "already up to date"}`);
+  }
+});
+var SERVER_FILES = [
+  "core.ts",
+  "stripe.ts",
+  "types.ts"
+];
+var SERVER_BANNER = "// AUTO-GENERATED from zucker-framework packages/ext-server \u2014 DO NOT EDIT.\n// \u4FEE\u6539\u8BF7\u6539\u6846\u67B6\u6E90\u7801\u540E\u8FD0\u884C `zucker ext sync-server <dir>` \u91CD\u65B0\u5206\u53D1\u3002\n";
+var syncServerCommand = new import_commander4.Command("sync-server").description("Vendor @zucker-framework/ext-server sources (core/stripe/types) into a NestJS app directory").argument("<dir>", "Target directory (e.g. apps/server/src/extension/core)").action((dir) => {
+  const target = (0, import_path4.resolve)(process.cwd(), dir);
+  (0, import_fs4.mkdirSync)(target, {
+    recursive: true
+  });
+  const updated = [];
+  for (const name of SERVER_FILES) {
+    const src = (0, import_path4.join)(monorepoRoot, "packages", "ext-server", "src", name);
+    if (!(0, import_fs4.existsSync)(src)) {
+      console.log(`  \x1B[31mError:\x1B[0m Missing ${src}`);
+      process.exit(1);
+    }
+    const content = SERVER_BANNER + (0, import_fs4.readFileSync)(src, "utf8");
+    const dest = (0, import_path4.join)(target, name);
+    if (!(0, import_fs4.existsSync)(dest) || (0, import_fs4.readFileSync)(dest, "utf8") !== content) {
+      (0, import_fs4.writeFileSync)(dest, content);
+      updated.push(name);
+    }
+  }
+  console.log(`  ${target}: ${updated.length ? `updated ${updated.join(", ")}` : "already up to date"}`);
+  console.log("  Reminder: prisma \u7247\u6BB5\u89C1 packages/ext-server/assets/extension-product.prisma\uFF08\u624B\u52A8\u5E76\u5165\u6D88\u8D39\u65B9 schema\uFF09");
+});
+var extCommand = new import_commander4.Command("ext").description("Browser extension scaffolding & vendored kit management").addCommand(createCommand).addCommand(syncCommand).addCommand(syncServerCommand);
+
+// src/commands/ai.ts
+var import_commander5 = require("commander");
+var import_pg = require("pg");
+var import_ai_access = require("@zucker-framework/ai-access");
+var import_openai_codex = require("@zucker-framework/ai-access/openai-codex");
+function createAICommand(dependencies = {}) {
+  const registry = dependencies.registry ?? createDefaultRegistry();
+  const createStore = dependencies.createStore ?? createPostgresStore;
+  const env = dependencies.env ?? process.env;
+  const write = dependencies.write ?? ((message) => process.stdout.write(`${message}
+`));
+  const line = /* @__PURE__ */ __name((message = "") => write(message), "line");
+  const withStore = /* @__PURE__ */ __name(async (operation) => {
+    const resource = await createStore(requiredDatabaseUrl(env));
+    try {
+      await resource.store.ensureSchema?.();
+      return await operation(resource.store);
+    } finally {
+      await resource.close();
+    }
+  }, "withStore");
+  const providersCommand = new import_commander5.Command("providers").description("\u5217\u51FA\u5DF2\u5B89\u88C5\u7684 AI Provider").action(() => {
+    for (const provider of registry.list()) {
+      const auth = provider.authMethods.map((method) => method.id).join(", ") || "\u65E0";
+      const sources = provider.credentialSources.map((source) => source.id).join(", ") || "\u65E0";
+      line(`${provider.id}  ${provider.name}`);
+      line(`  \u8BA4\u8BC1\u65B9\u5F0F\uFF1A${auth}`);
+      line(`  \u51ED\u636E\u6765\u6E90\uFF1A${sources}`);
+    }
+  });
+  const storeCommand = new import_commander5.Command("store").description("\u7BA1\u7406 AI Profile \u5B58\u50A8").addCommand(new import_commander5.Command("init").description("\u521D\u59CB\u5316 PostgreSQL Profile \u8868").action(async () => {
+    await withStore(async () => void 0);
+    line("AI Profile \u5B58\u50A8\u5DF2\u521D\u59CB\u5316\u3002");
+  }));
+  const loginCommand = new import_commander5.Command("login").description("\u767B\u5F55 AI Provider \u5E76\u4FDD\u5B58 Profile").argument("<provider>", "Provider ID").option("--profile <name>", "Profile \u540D\u79F0", "default").option("--method <method>", "\u8BA4\u8BC1\u65B9\u5F0F ID").action(async (providerId, options) => {
+    const provider = registry.get(providerId);
+    const method = options.method ? provider.authMethods.find((candidate) => candidate.id === options.method) : provider.authMethods[0];
+    if (!method) throw new Error(`Provider ${providerId} \u4E0D\u652F\u6301\u6307\u5B9A\u7684\u8BA4\u8BC1\u65B9\u5F0F\u3002`);
+    await withStore(async (store) => {
+      await method.login({
+        store,
+        profileName: options.profile,
+        onVerification: /* @__PURE__ */ __name((verification) => {
+          line(`\u8BF7\u6253\u5F00\uFF1A${verification.verificationUrl}`);
+          line(`\u5E76\u8F93\u5165\u8BBE\u5907\u7801\uFF1A${verification.userCode}`);
+        }, "onVerification")
+      });
+    });
+    line(`Provider ${providerId} \u7684 Profile ${options.profile} \u5DF2\u767B\u5F55\u3002`);
+  });
+  const statusCommand = new import_commander5.Command("status").description("\u67E5\u770B\u5DF2\u4FDD\u5B58\u7684 AI Profile\uFF0C\u4E0D\u663E\u793A\u51ED\u636E\u5185\u5BB9").argument("[provider]", "Provider ID").action(async (providerId) => {
+    if (providerId) registry.get(providerId);
+    const profiles = await withStore((store) => store.list(providerId));
+    if (profiles.length === 0) {
+      line("\u6CA1\u6709\u5DF2\u4FDD\u5B58\u7684 AI Profile\u3002");
+      return;
+    }
+    for (const profile of profiles) line(formatProfileStatus(profile));
+  });
+  const importCommand = new import_commander5.Command("import").description("\u4ECE\u6587\u4EF6\u5BFC\u5165 Provider Profile").argument("<provider>", "Provider ID").requiredOption("--from-file <path>", "\u51ED\u636E\u6587\u4EF6\u8DEF\u5F84").option("--profile <name>", "Profile \u540D\u79F0", "default").action(async (providerId, options) => {
+    const provider = registry.get(providerId);
+    const source = provider.credentialSources.find((candidate) => candidate.kind === "file");
+    if (!source) throw new Error(`Provider ${providerId} \u4E0D\u652F\u6301\u4ECE\u6587\u4EF6\u5BFC\u5165 Profile\u3002`);
+    const profiles = await source.discover({
+      profileName: options.profile,
+      location: options.fromFile
+    });
+    await withStore(async (store) => {
+      for (const profile of profiles) {
+        if (profile.providerId !== providerId) {
+          throw new Error(`\u51ED\u636E\u6E90\u8FD4\u56DE\u4E86\u9519\u8BEF\u7684 Provider\uFF1A${profile.providerId}`);
+        }
+        await store.save(profile);
+      }
+    });
+    line(`\u5DF2\u5BFC\u5165 ${profiles.length} \u4E2A ${providerId} Profile\u3002`);
+  });
+  const profileCommand = new import_commander5.Command("profile").description("\u7BA1\u7406 AI Profile").addCommand(importCommand);
+  const smokeCommand = new import_commander5.Command("smoke").description("\u4F7F\u7528\u6307\u5B9A Profile \u53D1\u8D77\u4E00\u6B21\u6700\u5C0F\u771F\u5B9E\u8BF7\u6C42").argument("<provider>", "Provider ID").requiredOption("--model <model>", "\u6A21\u578B\u540D\u79F0").option("--profile <name>", "Profile \u540D\u79F0", "default").option("--input <text>", "\u6D4B\u8BD5\u8F93\u5165", "\u8BF7\u53EA\u56DE\u590D\uFF1A\u8FDE\u63A5\u6210\u529F").action(async (providerId, options) => {
+    const provider = registry.get(providerId);
+    const result = await withStore((store) => provider.runtime.complete({
+      model: options.model,
+      input: options.input,
+      reasoningEffort: "low",
+      textVerbosity: "low"
+    }, {
+      store,
+      profileName: options.profile
+    }));
+    line(result.content.trim());
+    line(`Token\uFF1A\u8F93\u5165 ${result.tokenUsage.input}\uFF0C\u8F93\u51FA ${result.tokenUsage.output}\uFF0C\u5408\u8BA1 ${result.tokenUsage.total}`);
+  });
+  return new import_commander5.Command("ai").description("\u7BA1\u7406 AI Provider\u3001\u8BA4\u8BC1 Profile \u4E0E\u8C03\u7528\u9A8C\u8BC1").addCommand(providersCommand).addCommand(storeCommand).addCommand(loginCommand).addCommand(statusCommand).addCommand(profileCommand).addCommand(smokeCommand);
+}
+__name(createAICommand, "createAICommand");
+function createDefaultRegistry() {
+  const registry = new import_ai_access.AIAccessProviderRegistry();
+  registry.register((0, import_openai_codex.createOpenAICodexAccessProvider)());
+  return registry;
+}
+__name(createDefaultRegistry, "createDefaultRegistry");
+async function createPostgresStore(databaseUrl) {
+  const pool = new import_pg.Pool({
+    connectionString: databaseUrl
+  });
+  return {
+    store: new import_ai_access.PostgresCredentialProfileStore({
+      pool
+    }),
+    close: /* @__PURE__ */ __name(() => pool.end(), "close")
+  };
+}
+__name(createPostgresStore, "createPostgresStore");
+function requiredDatabaseUrl(env) {
+  const databaseUrl = env.AI_ACCESS_DATABASE_URL?.trim() || env.DATABASE_URL?.trim();
+  if (!databaseUrl) {
+    throw new Error("\u8BF7\u8BBE\u7F6E AI_ACCESS_DATABASE_URL \u6216 DATABASE_URL \u540E\u518D\u4F7F\u7528 AI Profile\u3002");
+  }
+  return databaseUrl;
+}
+__name(requiredDatabaseUrl, "requiredDatabaseUrl");
+function formatProfileStatus(profile) {
+  const expiresAt = profile.expiresAt;
+  const status = expiresAt && expiresAt <= Date.now() ? "\u5DF2\u8FC7\u671F\uFF0C\u53EF\u5C1D\u8BD5\u81EA\u52A8\u5237\u65B0" : "\u53EF\u7528";
+  const expiry = expiresAt ? new Date(expiresAt).toISOString() : "\u957F\u671F\u6709\u6548";
+  return `${profile.providerId}/${profile.profileName}  ${status}  \u8BA4\u8BC1=${profile.authMethod}  \u5230\u671F=${expiry}`;
+}
+__name(formatProfileStatus, "formatProfileStatus");
+
+// src/index.ts
+var program = new import_commander6.Command();
+program.name("zucker").description("CLI tool for Zucker Framework").version(JSON.parse((0, import_node_fs.readFileSync)((0, import_node_path.resolve)(__dirname, "../package.json"), "utf8")).version);
+program.addCommand(initCommand);
+program.addCommand(doctorCommand);
+program.addCommand(addCommand);
+program.addCommand(extCommand);
+program.addCommand(createAICommand());
+program.parseAsync().catch((error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  process.stderr.write(`\u9519\u8BEF\uFF1A${message}
+`);
+  process.exitCode = 1;
+});

package/dist/release-catalog.json

@@ -0,0 +1,82 @@
+{
+  "versions": {
+    "@zucker-framework/admin": "1.0.0",
+    "@zucker-framework/ai": "1.0.0",
+    "@zucker-framework/ai-access": "1.0.0",
+    "@zucker-framework/auth": "1.0.0",
+    "@zucker-framework/buffer": "1.0.0",
+    "@zucker-framework/cache": "1.0.0",
+    "@zucker-framework/cli": "1.0.0",
+    "@zucker-framework/cluster": "1.0.0",
+    "@zucker-framework/common": "1.0.0",
+    "@zucker-framework/config": "1.0.0",
+    "@zucker-framework/core": "1.0.0",
+    "@zucker-framework/credit": "1.0.0",
+    "@zucker-framework/crud": "1.0.0",
+    "@zucker-framework/dashboard": "1.0.0",
+    "@zucker-framework/datasource": "1.0.0",
+    "@zucker-framework/dictionary": "1.0.0",
+    "@zucker-framework/event": "1.0.0",
+    "@zucker-framework/ext-kit": "1.0.0",
+    "@zucker-framework/ext-server": "1.0.0",
+    "@zucker-framework/fe-analytics": "1.0.0",
+    "@zucker-framework/fe-auth": "1.0.0",
+    "@zucker-framework/fe-form": "1.0.0",
+    "@zucker-framework/fe-http-client": "1.0.0",
+    "@zucker-framework/fe-permission": "1.0.0",
+    "@zucker-framework/fe-storage": "1.0.0",
+    "@zucker-framework/fe-types": "1.0.0",
+    "@zucker-framework/feature-flags": "1.0.0",
+    "@zucker-framework/form": "1.0.0",
+    "@zucker-framework/gateway": "1.0.0",
+    "@zucker-framework/i18n": "1.0.0",
+    "@zucker-framework/io": "1.0.0",
+    "@zucker-framework/logging": "1.0.0",
+    "@zucker-framework/media": "1.0.0",
+    "@zucker-framework/monitoring": "1.0.0",
+    "@zucker-framework/network": "1.0.0",
+    "@zucker-framework/notification": "1.0.0",
+    "@zucker-framework/payment": "1.0.0",
+    "@zucker-framework/provider": "1.0.0",
+    "@zucker-framework/queue": "1.0.0",
+    "@zucker-framework/rate-limiter": "1.0.0",
+    "@zucker-framework/reference": "1.0.0",
+    "@zucker-framework/relation": "1.0.0",
+    "@zucker-framework/rule-engine": "1.0.0",
+    "@zucker-framework/script": "1.0.0",
+    "@zucker-framework/search": "1.0.0",
+    "@zucker-framework/storage": "1.0.0",
+    "@zucker-framework/task": "1.0.0",
+    "@zucker-framework/tenant": "1.0.0",
+    "@zucker-framework/things": "1.0.0",
+    "@zucker-framework/timeseries": "1.0.0",
+    "@zucker-framework/tracing": "1.0.0"
+  },
+  "server": {
+    "dependencies": {
+      "@zucker-framework/core": "1.0.0",
+      "@zucker-framework/common": "1.0.0",
+      "@zucker-framework/crud": "1.0.0",
+      "@zucker-framework/event": "1.0.0",
+      "@zucker-framework/auth": "1.0.0",
+      "@nestjs/common": "^12.0.1",
+      "@nestjs/core": "^12.0.1",
+      "express": "^4.0.0 || ^5.0.0",
+      "rxjs": "^7.8.2",
+      "@nestjs/swagger": "^12.0.0",
+      "@nestjs/event-emitter": "^12.0.0",
+      "class-transformer": "^0.5.0",
+      "class-validator": "^0.14.0 || ^0.15.0",
+      "@nestjs/passport": "^12.0.0",
+      "@nestjs/jwt": "^12.0.1",
+      "@nestjs/platform-express": "^12.0.1",
+      "reflect-metadata": "^0.2.2",
+      "dotenv": "^17.4.2"
+    },
+    "devDependencies": {
+      "@nestjs/cli": "^12.0.0",
+      "@types/node": "^20.19.43",
+      "typescript": "^6.0.3"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@zucker-framework/cli",
+  "version": "1.0.0",
+  "description": "CLI tool for Zucker Framework — scaffolding, diagnostics, and module management",
+  "bin": {
+    "zucker": "./dist/index.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE",
+    "NOTICE",
+    "THIRD_PARTY_NOTICES"
+  ],
+  "dependencies": {
+    "@zucker-framework/ai-access": "1.0.0",
+    "chalk": "^6.0.0",
+    "commander": "^15.0.0",
+    "dotenv": "^17.4.2",
+    "openai": "7.8.0",
+    "pg": "8.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.43",
+    "tsx": "^4.23.13"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "license": "Apache-2.0",
+  "author": "Lind",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Lind-pro/zucker-framework.git",
+    "directory": "packages/cli"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs --dts && node ../../scripts/prepare-cli-catalog.mjs",
+    "clean": "rm -rf dist",
+    "lint": "eslint src/"
+  }
+}