@akanjs/cli 2.4.0 → 2.4.1-rc.0

package/library.command-r15zdqvp.js

@@ -0,0 +1,33 @@
+// @bun
+import {
+  LibraryScript
+} from "./index-pmm9e2jf.js";
+import {
+  Lib,
+  Workspace,
+  command
+} from "./index-hdqztm58.js";
+import"./index-a6sbyy0b.js";
+import"./index-61keag0s.js";
+import"./index-6pz1j0zj.js";
+import"./index-r24hmh0q.js";
+
+// pkgs/@akanjs/cli/library/library.command.ts
+class LibraryCommand extends command("library", [LibraryScript], ({ public: target }) => ({
+  createLibrary: target({ desc: "Create a new shared library in the workspace" }).arg("libName", String, { desc: "name of library" }).with(Workspace).exec(async function(libName, workspace) {
+    await this.libraryScript.createLibrary(libName.toLowerCase().replace(/ /g, "-"), workspace);
+  }),
+  removeLibrary: target({ desc: "Remove a library from the workspace" }).with(Lib).exec(async function(lib) {
+    await this.libraryScript.removeLibrary(lib);
+  }),
+  syncLibrary: target({ desc: "Sync dependencies and configuration for a library" }).with(Lib).exec(async function(lib) {
+    await this.libraryScript.syncLibrary(lib);
+  }),
+  installLibrary: target({ desc: "Install pre-built library templates (shared, util, etc.)" }).arg("libName", String, { desc: "name of library", nullable: true }).with(Workspace).exec(async function(libName, workspace) {
+    await this.libraryScript.installLibrary(workspace, libName);
+  })
+})) {
+}
+export {
+  LibraryCommand
+};

package/localRegistry.command-5tcahs3f.js

@@ -0,0 +1,178 @@
+// @bun
+import {
+  CloudRunner,
+  getNpmRegistryUrl
+} from "./index-w7fyqjrw.js";
+import {
+  ApplicationScript
+} from "./index-9sp6fsc5.js";
+import"./index-76rn3g2c.js";
+import"./index-pmm9e2jf.js";
+import {
+  PackageScript
+} from "./index-wq8jwx8z.js";
+import"./index-5vvwc0cz.js";
+import {
+  Workspace,
+  command,
+  runner,
+  script
+} from "./index-hdqztm58.js";
+import"./index-fgc8r6dj.js";
+import {
+  PkgExecutor
+} from "./index-a6sbyy0b.js";
+import"./index-x53a5nya.js";
+import"./index-61keag0s.js";
+import"./index-6pz1j0zj.js";
+import"./index-r24hmh0q.js";
+
+// pkgs/@akanjs/cli/localRegistry/localRegistry.runner.ts
+import { mkdir, rm } from "fs/promises";
+import path from "path";
+import { Logger } from "akanjs/common";
+var defaultLocalRegistryUrl = "http://127.0.0.1:4873";
+var containerName = "akan-verdaccio";
+var smokeRepoName = "akan-local-smoke";
+var smokeAppName = "demo";
+
+class LocalRegistryRunner extends runner("localRegistry") {
+  getRegistryUrl(registryUrl = process.env.AKAN_NPM_REGISTRY ?? defaultLocalRegistryUrl) {
+    return getNpmRegistryUrl(registryUrl);
+  }
+  async start(workspace, { registryUrl } = {}) {
+    const registry = this.getRegistryUrl(registryUrl);
+    try {
+      await workspace.spawn("docker", ["inspect", containerName]);
+      Logger.info(`Local registry is already running at ${registry}`);
+      return registry;
+    } catch {}
+    const configPath = path.join(workspace.workspaceRoot, "pkgs/@akanjs/cli/localRegistry/verdaccio.yaml");
+    const storagePath = path.join(workspace.workspaceRoot, ".akan/verdaccio/storage");
+    await mkdir(storagePath, { recursive: true });
+    await workspace.spawn("docker", [
+      "run",
+      "--rm",
+      "-d",
+      "--name",
+      containerName,
+      "-p",
+      "4873:4873",
+      "-v",
+      `${configPath}:/verdaccio/conf/config.yaml:ro`,
+      "-v",
+      `${storagePath}:/verdaccio/storage`,
+      "verdaccio/verdaccio:6"
+    ], { stdio: "inherit" });
+    Logger.info(`Local registry is running at ${registry}`);
+    return registry;
+  }
+  async reset(workspace) {
+    try {
+      await workspace.spawn("docker", ["rm", "-f", containerName], { stdio: "inherit" });
+    } catch {}
+    await rm(path.join(workspace.workspaceRoot, ".akan/verdaccio"), { recursive: true, force: true });
+    Logger.info("Local registry storage has been reset");
+  }
+  async smoke(workspace, { registryUrl } = {}) {
+    const registry = this.getRegistryUrl(registryUrl);
+    const smokeRoot = path.join(workspace.workspaceRoot, ".akan/e2e");
+    await rm(path.join(smokeRoot, smokeRepoName), { recursive: true, force: true });
+    await workspace.spawn(process.execPath, [
+      "dist/pkgs/create-akan-workspace/index.js",
+      smokeRepoName,
+      "--app",
+      smokeAppName,
+      "--dir",
+      ".akan/e2e",
+      "--init",
+      "true",
+      "--registry",
+      registry
+    ], {
+      env: { ...process.env, AKAN_NPM_REGISTRY: registry, NPM_CONFIG_REGISTRY: registry },
+      stdio: "inherit"
+    });
+    await workspace.spawn("akan", ["typecheck", smokeAppName], {
+      cwd: path.join(smokeRoot, smokeRepoName),
+      env: { ...process.env, AKAN_NPM_REGISTRY: registry, NPM_CONFIG_REGISTRY: registry },
+      stdio: "inherit"
+    });
+    await workspace.spawn("akan", ["build", smokeAppName], {
+      cwd: path.join(smokeRoot, smokeRepoName),
+      env: { ...process.env, AKAN_NPM_REGISTRY: registry, NPM_CONFIG_REGISTRY: registry },
+      stdio: "inherit"
+    });
+    Logger.info(`Local registry smoke test completed for ${smokeRepoName}/${smokeAppName}`);
+  }
+}
+
+// pkgs/@akanjs/cli/localRegistry/localRegistry.script.ts
+class LocalRegistryScript extends script("localRegistry", [
+  LocalRegistryRunner,
+  CloudRunner,
+  ApplicationScript,
+  PackageScript
+]) {
+  async start(workspace, { registryUrl } = {}) {
+    const spinner = workspace.spinning("Starting local npm registry...");
+    const registry = await this.localRegistryRunner.start(workspace, { registryUrl });
+    spinner.succeed(`Local npm registry is ready at ${registry}`);
+  }
+  async reset(workspace) {
+    const spinner = workspace.spinning("Resetting local npm registry...");
+    await this.localRegistryRunner.reset(workspace);
+    spinner.succeed("Local npm registry reset");
+  }
+  async smoke(workspace, { tag = "rc", test = true, registryUrl } = {}) {
+    const registry = await this.localRegistryRunner.start(workspace, { registryUrl });
+    const akanPkgs = await this.cloudRunner.getAkanPkgs(workspace);
+    await this.#preparePackages(workspace, akanPkgs, { test });
+    await this.cloudRunner.deployAkan(workspace, akanPkgs, {
+      registryUrl: registry,
+      confirmPublish: false,
+      tag
+    });
+    await this.localRegistryRunner.smoke(workspace, { registryUrl: registry });
+  }
+  async#preparePackages(workspace, akanPkgs, { test = true } = {}) {
+    await this.packageScript.updateWorskpaceRootPackageJson(workspace);
+    const pkgs = akanPkgs.map((pkgName) => PkgExecutor.from(workspace, pkgName));
+    if (test)
+      for (const pkg of pkgs)
+        await this.applicationScript.test(pkg);
+    for (const pkg of pkgs)
+      await this.packageScript.buildPackage(pkg, { showSpinner: false });
+    await this.packageScript.verifyAkanPublishPackages(workspace);
+  }
+}
+
+// pkgs/@akanjs/cli/localRegistry/localRegistry.command.ts
+class LocalRegistryCommand extends command("local-registry", [LocalRegistryScript], ({ public: target }) => ({
+  startRegistry: target({ devOnly: true, desc: "Start the local Verdaccio npm registry" }).with(Workspace).option("registry", String, {
+    desc: "local npm registry URL",
+    default: process.env.AKAN_NPM_REGISTRY ?? "http://127.0.0.1:4873"
+  }).exec(async function(workspace, registry) {
+    await this.localRegistryScript.start(workspace, { registryUrl: registry });
+  }),
+  resetRegistry: target({ devOnly: true, desc: "Stop and clear the local Verdaccio npm registry" }).with(Workspace).exec(async function(workspace) {
+    await this.localRegistryScript.reset(workspace);
+  }),
+  smokeRegistry: target({ devOnly: true, desc: "Publish to local registry and build a generated workspace" }).with(Workspace).option("tag", String, {
+    flag: "g",
+    desc: "dist-tag for local registry publish",
+    default: "rc"
+  }).option("test", Boolean, {
+    desc: "run package tests before publishing",
+    default: true
+  }).option("registry", String, {
+    desc: "local npm registry URL",
+    default: process.env.AKAN_NPM_REGISTRY
+  }).exec(async function(workspace, tag, test, registry) {
+    await this.localRegistryScript.smoke(workspace, { tag, test, registryUrl: registry });
+  })
+})) {
+}
+export {
+  LocalRegistryCommand
+};

package/module.command-qrj3kmyz.js

@@ -0,0 +1,54 @@
+// @bun
+import {
+  ModuleScript
+} from "./index-8pkbzj26.js";
+import"./index-swf4bmbg.js";
+import"./index-ss469dec.js";
+import"./index-qaq13qk3.js";
+import {
+  renderPrimitiveReport
+} from "./index-h6ca6qg0.js";
+import"./index-5vvwc0cz.js";
+import {
+  Module,
+  Sys,
+  command
+} from "./index-hdqztm58.js";
+import"./index-a6sbyy0b.js";
+import"./index-61keag0s.js";
+import"./index-6pz1j0zj.js";
+import"./index-r24hmh0q.js";
+
+// pkgs/@akanjs/cli/module/module.command.ts
+import { Logger, lowerlize } from "akanjs/common";
+class ModuleCommand extends command("module", [ModuleScript], ({ public: target }) => ({
+  createModule: target({ desc: "Create a new domain module (constant, service, signal, store, UI)" }).arg("moduleName", String, { desc: "name of module" }).with(Sys).option("page", Boolean, { desc: "create page", default: false }).option("ai", Boolean, { desc: "use ai to create module constant and dictionary", default: false }).option("format", String, { flag: "o", desc: "output format", default: "markdown", enum: ["markdown", "json"] }).exec(async function(moduleName, sys, page, ai, format) {
+    const name = lowerlize(moduleName.replace(/ /g, ""));
+    const report = ai ? await this.moduleScript.createModule(sys, name, { page }) : await this.moduleScript.createModuleTemplate(sys, name, { page });
+    Logger.rawLog(renderPrimitiveReport(report, format));
+  }),
+  removeModule: target({ desc: "Remove a module from an app or library" }).with(Module).exec(async function(module) {
+    await this.moduleScript.removeModule(module);
+  }),
+  createService: target({ desc: "Create a service module without database files" }).arg("serviceName", String, { desc: "name of service module" }).with(Sys).option("format", String, { flag: "o", desc: "output format", default: "markdown", enum: ["markdown", "json"] }).exec(async function(serviceName, sys, format) {
+    const name = lowerlize(serviceName.replace(/ /g, "").replace(/^_+/, ""));
+    const report = await this.moduleScript.createService(sys, name);
+    Logger.rawLog(renderPrimitiveReport(report, format));
+  }),
+  createView: target({ desc: "Create a View component for a module (full page view)" }).with(Module).option("format", String, { flag: "o", desc: "output format", default: "markdown", enum: ["markdown", "json"] }).exec(async function(module, format) {
+    const report = await this.moduleScript.createView(module);
+    Logger.rawLog(renderPrimitiveReport(report, format));
+  }),
+  createUnit: target({ desc: "Create a Unit component for a module (list/card item)" }).with(Module).option("format", String, { flag: "o", desc: "output format", default: "markdown", enum: ["markdown", "json"] }).exec(async function(module, format) {
+    const report = await this.moduleScript.createUnit(module);
+    Logger.rawLog(renderPrimitiveReport(report, format));
+  }),
+  createTemplate: target({ desc: "Create a Template component for a module (form)" }).with(Module).option("format", String, { flag: "o", desc: "output format", default: "markdown", enum: ["markdown", "json"] }).exec(async function(module, format) {
+    const report = await this.moduleScript.createTemplate(module);
+    Logger.rawLog(renderPrimitiveReport(report, format));
+  })
+})) {
+}
+export {
+  ModuleCommand
+};

package/package.command-r8sq5kzp.js

@@ -0,0 +1,43 @@
+// @bun
+import {
+  PackageScript
+} from "./index-wq8jwx8z.js";
+import {
+  Pkg,
+  Workspace,
+  command
+} from "./index-hdqztm58.js";
+import"./index-a6sbyy0b.js";
+import"./index-x53a5nya.js";
+import"./index-61keag0s.js";
+import"./index-6pz1j0zj.js";
+import"./index-r24hmh0q.js";
+
+// pkgs/@akanjs/cli/package/package.command.ts
+class PackageCommand extends command("package", [PackageScript], ({ public: target }) => ({
+  version: target({ desc: "Show version information for all packages" }).with(Workspace).exec(async function(workspace) {
+    await this.packageScript.version(workspace);
+  }),
+  createPackage: target({ desc: "Create a new package in pkgs/akanjs/" }).option("name", String, { desc: "name of package" }).with(Workspace).exec(async function(name, workspace) {
+    await this.packageScript.createPackage(workspace, name.toLowerCase().replace(/ /g, "-"));
+  }),
+  removePackage: target({ desc: "Remove a package from the workspace" }).with(Pkg).exec(async function(pkg) {
+    await this.packageScript.removePackage(pkg);
+  }),
+  syncPackage: target({ desc: "Sync dependencies and configuration for a package" }).with(Pkg).exec(async function(pkg) {
+    await this.packageScript.syncPackage(pkg);
+  }),
+  buildPackage: target({ desc: "Build a package for distribution" }).with(Pkg).exec(async function(pkg) {
+    await this.packageScript.buildPackage(pkg);
+  }),
+  verifyDistPackage: target({ desc: "Verify a built dist package with npm pack dry-run" }).with(Pkg).exec(async function(pkg) {
+    await this.packageScript.verifyDistPackage(pkg);
+  }),
+  verifyAkanPublishPackages: target({ devOnly: true, desc: "Verify all Akan publish dist packages" }).with(Workspace).exec(async function(workspace) {
+    await this.packageScript.verifyAkanPublishPackages(workspace);
+  })
+})) {
+}
+export {
+  PackageCommand
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/cli",
-  "version": "2.4.0",
+  "version": "2.4.1-rc.0",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -34,7 +34,7 @@
     "@langchain/openai": "^1.4.6",
     "@tailwindcss/node": "^4.3.0",
     "@trapezedev/project": "^7.1.4",
-    "akanjs": "2.4.0",
+    "akanjs": "2.4.1-rc.0",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "daisyui": "5.5.23",

package/page.command-c6xdx0xm.js

@@ -0,0 +1,24 @@
+// @bun
+import {
+  PageScript
+} from "./index-swf4bmbg.js";
+import {
+  App,
+  Module,
+  command
+} from "./index-hdqztm58.js";
+import"./index-a6sbyy0b.js";
+import"./index-61keag0s.js";
+import"./index-6pz1j0zj.js";
+import"./index-r24hmh0q.js";
+
+// pkgs/@akanjs/cli/page/page.command.ts
+class PageCommand extends command("page", [PageScript], ({ public: target }) => ({
+  createCrudPage: target({ desc: "Create CRUD pages for a module (list, detail, create, edit)" }).with(App).with(Module).option("basePath", String, { desc: "base path", nullable: true }).option("single", Boolean, { desc: "single page", default: false }).exec(async function(app, module, basePath, single) {
+    await this.pageScript.createCrudPage(module, { app, basePath, single });
+  })
+})) {
+}
+export {
+  PageCommand
+};

package/primitive.command-pv9ssmtf.js

@@ -0,0 +1,62 @@
+// @bun
+import {
+  PrimitiveScript
+} from "./index-73pr2cmy.js";
+import"./index-8pkbzj26.js";
+import"./index-swf4bmbg.js";
+import"./index-ss469dec.js";
+import"./index-qaq13qk3.js";
+import {
+  renderPrimitiveReport
+} from "./index-h6ca6qg0.js";
+import"./index-5vvwc0cz.js";
+import {
+  Workspace,
+  command
+} from "./index-hdqztm58.js";
+import"./index-a6sbyy0b.js";
+import"./index-61keag0s.js";
+import"./index-6pz1j0zj.js";
+import"./index-r24hmh0q.js";
+
+// pkgs/@akanjs/cli/primitive/primitive.command.ts
+import { Logger } from "akanjs/common";
+class PrimitiveCommand extends command("primitive", [PrimitiveScript], ({ public: target }) => ({
+  createUi: target({ desc: "Create a UI surface for a module" }).with(Workspace).option("app", String, { desc: "target app or library name", nullable: true }).option("module", String, { desc: "target module name", nullable: true }).option("surface", String, {
+    flag: "u",
+    desc: "view, unit, or template",
+    default: "template",
+    enum: ["view", "unit", "template"]
+  }).option("format", String, { flag: "o", desc: "output format", default: "markdown", enum: ["markdown", "json"] }).exec(async function(workspace, app, module, surface, format) {
+    const report = await this.primitiveScript.createUi(workspace, {
+      app,
+      module,
+      surface
+    });
+    Logger.rawLog(renderPrimitiveReport(report, format));
+  }),
+  addField: target({ desc: "Add a source-limited field to a module constant and dictionary" }).with(Workspace).option("app", String, { desc: "target app or library name", nullable: true }).option("module", String, { desc: "target module name", nullable: true }).option("field", String, { desc: "field name", nullable: true }).option("type", String, { desc: "field type or scalar name", nullable: true }).option("default", String, { desc: "default value", nullable: true }).option("format", String, { flag: "o", desc: "output format", default: "markdown", enum: ["markdown", "json"] }).exec(async function(workspace, app, module, field, typeName, defaultValue, format) {
+    const report = await this.primitiveScript.addField(workspace, {
+      app,
+      module,
+      field,
+      type: typeName,
+      defaultValue
+    });
+    Logger.rawLog(renderPrimitiveReport(report, format));
+  }),
+  addEnumField: target({ desc: "Add a source-limited enum field to a module constant and dictionary" }).with(Workspace).option("app", String, { desc: "target app or library name", nullable: true }).option("module", String, { desc: "target module name", nullable: true }).option("field", String, { desc: "field name", nullable: true }).option("values", String, { flag: "l", desc: "comma-separated enum values", nullable: true }).option("default", String, { desc: "default value", nullable: true }).option("format", String, { flag: "o", desc: "output format", default: "markdown", enum: ["markdown", "json"] }).exec(async function(workspace, app, module, field, values, defaultValue, format) {
+    const report = await this.primitiveScript.addEnumField(workspace, {
+      app,
+      module,
+      field,
+      values,
+      defaultValue
+    });
+    Logger.rawLog(renderPrimitiveReport(report, format));
+  })
+})) {
+}
+export {
+  PrimitiveCommand
+};