@akanjs/cli 3.0.0-beta.2 → 3.0.0-beta.20

package/index-rwg2aa4f.js

@@ -1,229 +0,0 @@
-// @bun
-import {
-  runner,
-  script
-} from "./index-mak3cd28.js";
-import {
-  generatedFilesForSync,
-  createPassedPrimitiveReport,
-  scalarChangedFiles
-} from "./index-gyd220p2.js";
-import {
-  AiSession
-} from "./index-kn1h7p1x.js";
-import {
-  Prompter
-} from "./index-h7yw2z9n.js";
-import {
-  pluralizeName
-} from "./index-nz8prx9g.js";
-
-// pkgs/@akanjs/cli/scalar/scalar.prompt.ts
-import { input } from "@inquirer/prompts";
-class ScalarPrompt extends Prompter {
-  sys;
-  name;
-  constructor(sys, name) {
-    super();
-    this.sys = sys;
-    this.name = name;
-  }
-  async requestUpdateConstant() {
-    const request = await input({ message: `What do you want to change?` });
-    return { request, validate: undefined };
-  }
-  async requestCreateConstant() {
-    const constantFiles = await this.sys.getConstantFilesWithLibs();
-    const description = await input({ message: "description of scalar" });
-    const schemaDescription = await input({ message: "schema description of scalar" });
-    await this.sys.applyTemplate({
-      basePath: "./lib/__scalar",
-      template: "__scalar",
-      dict: { model: this.name, models: pluralizeName(this.name), sysName: this.sys.name }
-    });
-    const boilerplate = await this.sys.readFile(`lib/__scalar/${this.name}/${this.name}.constant.ts`);
-    return await this.#requestConstant({
-      modelDesc: description,
-      modelSchemaDesign: schemaDescription,
-      boilerplate,
-      constantFiles
-    });
-  }
-  async#requestConstant({
-    modelDesc,
-    modelSchemaDesign,
-    boilerplate,
-    constantFiles
-  }) {
-    const scanInfo = await this.sys.scan();
-    const guideJson = await Prompter.getGuideJson("scalarConstant");
-    const request = await this.makeTsFileUpdatePrompt({
-      context: `
-1. Overview of __scalar/<model>/<model>.constant.ts file
-${await this.getDocumentation("scalarConstant")}
-
-2. How to write Enums in __scalar/<model>/<model>.constant.ts file
-${await this.getDocumentation("enumConstant")}
-
-3. How to write Fields in __scalar/<model>/<model>.constant.ts file
-${await this.getDocumentation("fieldRule")}
-
-4. List of constant.ts files in other libraries connected to current ${this.sys.name} ${this.sys.type === "app" ? "Application" : "Library"} ${scanInfo.getLibs().map((lib) => lib).join(", ")}
-Please understand the content and file patterns below, and feel free to reuse any constants or enums if available.
-${constantFiles.map((constant) => `
-\`\`\`typescript
-// File: ${constant.filePath}
-${constant.content}
-\`\`\`
-`).join(`
-`)}
-		`,
-      request: `
-Based on the above content, please organize it according to the boilerplate below for easy parsing
-
-Application name: ${this.sys.name} (${this.sys.type === "app" ? "Application" : "Library"})
-Model name: ${this.name}
-Model description: ${modelDesc}
-Model schema design: ${modelSchemaDesign}
-Model filename(You can create another connected scalar model file if needed): ${this.name}.constant.ts
-\`\`\`typescript
-// File: lib/__scalar/${this.name}/${this.name}.constant.ts
-${boilerplate}
-\`\`\`
-
-If additional connected scalar models need to be written besides ${this.name}.constant.ts file, please write them in the following format
-\`\`\`typescript
-// File: lib/__scalar/otherModel/otherModel.constant.ts
-...file content
-\`\`\`
-
-Please provide only the file results without any other content.`
-    });
-    return { request, validate: guideJson.update.rules };
-  }
-  async requestUpdateDictonaryWithInstruction() {
-    const constant = await this.sys.readFile(`lib/__scalar/${this.name}/${this.name}.constant.ts`);
-    const boilerplate = await this.sys.readFile(`lib/__scalar/${this.name}/${this.name}.dictionary.ts`);
-    const guideJson = await Prompter.getGuideJson("scalarDictionary");
-    const request = `\uB2E4\uC74C ${this.name}.dictionary.ts \uD30C\uC77C\uB3C4 \uC644\uC131\uB41C ${this.name}.constant.ts \uD30C\uC77C\uC744 \uAE30\uBC18\uC73C\uB85C \uC791\uC131\uD574\uC918.
-1. Dictionary \uC791\uC131\uBC95
-${await this.getDocumentation("scalarDictionary")}
-
-Model constant file
-\`\`\`typescript
-// File: lib/__scalar/${this.name}/${this.name}.constant.ts
-${constant}
-\`\`\`
-
-Model filename: ${this.name}.dictionary.ts
-\`\`\`typescript
-// File: lib/__scalar/${this.name}/${this.name}.dictionary.ts
-${boilerplate}
-\`\`\`
-  `;
-    return { request, validate: guideJson.update.rules };
-  }
-  async requestUpdateDictonaryWithFollowing() {
-    const [constant, boilerplate] = await Promise.all([
-      this.sys.readFile(`lib/__scalar/${this.name}/${this.name}.constant.ts`),
-      this.sys.readFile(`lib/__scalar/${this.name}/${this.name}.dictionary.ts`)
-    ]);
-    const request = `\uB2E4\uC74C ${this.name}.dictionary.ts \uD30C\uC77C\uB3C4 \uC644\uC131\uB41C ${this.name}.constant.ts \uD30C\uC77C\uC744 \uAE30\uBC18\uC73C\uB85C \uC791\uC131\uD574\uC918.
-Model constant file
-\`\`\`typescript
-// File: lib/__scalar/${this.name}/${this.name}.constant.ts
-${constant}
-\`\`\`
-
-Model filename: ${this.name}.dictionary.ts
-\`\`\`typescript
-// File: lib/__scalar/${this.name}/${this.name}.dictionary.ts
-${boilerplate}
-\`\`\`
-  `;
-    return { request, validate: [] };
-  }
-}
-
-// pkgs/@akanjs/cli/scalar/scalar.runner.ts
-class ScalarRunner extends runner("scalar") {
-  async applyScalarTemplate(sys, scalarName) {
-    await sys.applyTemplate({
-      basePath: "./lib/__scalar",
-      template: "__scalar",
-      dict: { model: scalarName, models: pluralizeName(scalarName), sysName: sys.name },
-      overwrite: false
-    });
-    return {
-      abstract: {
-        filename: `${scalarName}.abstract.md`,
-        content: await sys.readFile(`lib/__scalar/${scalarName}/${scalarName}.abstract.md`)
-      },
-      constant: {
-        filename: `${scalarName}.constant.ts`,
-        content: await sys.readFile(`lib/__scalar/${scalarName}/${scalarName}.constant.ts`)
-      },
-      dictionary: {
-        filename: `${scalarName}.dictionary.ts`,
-        content: await sys.readFile(`lib/__scalar/${scalarName}/${scalarName}.dictionary.ts`)
-      },
-      document: {
-        filename: `${scalarName}.document.ts`,
-        content: await sys.readFile(`lib/__scalar/${scalarName}/${scalarName}.document.ts`)
-      }
-    };
-  }
-  async createScalarConstant(sys, scalarName) {
-    const isContinued = await sys.exists(`lib/__scalar/${scalarName}/${scalarName}.constant.ts`);
-    const prompt = new ScalarPrompt(sys, scalarName);
-    const session = new AiSession("createScalar", { workspace: sys.workspace, cacheKey: scalarName, isContinued });
-    const { request, validate } = session.isCacheLoaded ? await prompt.requestUpdateConstant() : await prompt.requestCreateConstant();
-    const writes = await session.writeTypescripts(request, sys, { validate });
-    const scalarNames = writes.map(({ filePath }) => filePath.split("/").at(-2)).filter((name) => !!name);
-    if (!scalarNames.includes(scalarName))
-      scalarNames.unshift(scalarName);
-    for (const name of scalarNames)
-      await this.applyScalarTemplate(sys, name);
-    return { session, scalarNames, writes, prompt };
-  }
-  async updateScalarDictionaries(sys, scalarNames, { session }) {
-    const [firstScalarName, ...followingScalarNames] = scalarNames;
-    const prompt = new ScalarPrompt(sys, firstScalarName);
-    const { request, validate } = await prompt.requestUpdateDictonaryWithInstruction();
-    await session.writeTypescripts(request, sys, { validate });
-    for (const scalarName of followingScalarNames) {
-      const prompt = new ScalarPrompt(sys, scalarName);
-      const { request, validate } = await prompt.requestUpdateDictonaryWithFollowing();
-      await session.writeTypescripts(request, sys, { validate });
-    }
-  }
-}
-
-// pkgs/@akanjs/cli/scalar/scalar.script.ts
-class ScalarScript extends script("scalar", [ScalarRunner]) {
-  async createScalar(sys, scalarName) {
-    const files = await this.scalarRunner.applyScalarTemplate(sys, scalarName);
-    return createPassedPrimitiveReport({
-      command: "create-scalar",
-      changedFiles: scalarChangedFiles(sys, scalarName, files),
-      generatedFiles: generatedFilesForSync(sys),
-      target: sys.name
-    });
-  }
-  async createScalarWithAi(sys, scalarName) {
-    const { session, scalarNames } = await this.scalarRunner.createScalarConstant(sys, scalarName);
-    await this.scalarRunner.updateScalarDictionaries(sys, scalarNames, { session });
-    const fileMaps = await Promise.all(scalarNames.map(async (name) => ({ name, files: await this.scalarRunner.applyScalarTemplate(sys, name) })));
-    return createPassedPrimitiveReport({
-      command: "create-scalar",
-      changedFiles: fileMaps.flatMap(({ name, files }) => scalarChangedFiles(sys, name, files)),
-      generatedFiles: generatedFilesForSync(sys),
-      target: sys.name
-    });
-  }
-  async removeScalar(sys, scalarName) {
-    await sys.removeDir(`lib/__scalar/${scalarName}`);
-  }
-}
-
-export { ScalarScript };

package/templates/__scalar/__model__/__model__.abstract.md

@@ -1,28 +0,0 @@
-# Scalar Abstract
-
-## Purpose
-
-Describe the embedded value object or reusable data concept this scalar owns.
-
-## Domain Rules
-
-- Keep durable validation and meaning rules here.
-- Avoid repeating field types that are already clear in the constant file.
-
-## Data Meaning
-
-Explain the meaning of the scalar fields and when this scalar should be used.
-
-## Workflows
-
-Describe lifecycle or normalization behavior when relevant.
-
-## Agent Notes
-
-- Read this abstract before changing the scalar.
-- Update this file when validation meaning, public behavior, or reuse rules change.
-- Do not update this file for formatting-only, import-only, or style-only changes.
-
-## Related Modules
-
-- None yet.

package/templates/module/__model__.abstract.md

@@ -1,28 +0,0 @@
-# Module Abstract
-
-## Purpose
-
-Describe the business concept this module owns.
-
-## Domain Rules
-
-- Keep durable business invariants here.
-- Avoid repeating field types that are already clear in the constant file.
-
-## Data Meaning
-
-Explain the meaning of important data only when the code does not make the intent obvious.
-
-## Workflows
-
-Describe create, update, approval, deletion, state transition, or other business flows.
-
-## Agent Notes
-
-- Read this abstract before changing the module.
-- Update this file when business invariants, workflows, or public behavior change.
-- Do not update this file for formatting-only, import-only, or style-only changes.
-
-## Related Modules
-
-- None yet.

package/templates/service/__model__.abstract.md

@@ -1,28 +0,0 @@
-# Service Abstract
-
-## Purpose
-
-Describe the business workflow or integration this service owns.
-
-## Domain Rules
-
-- Keep durable business invariants here.
-- Avoid repeating implementation details already clear in the service or signal files.
-
-## Data Meaning
-
-Explain important input, output, and state meanings only when the code does not make the intent obvious.
-
-## Workflows
-
-Describe the service workflows, background jobs, external calls, or state transitions.
-
-## Agent Notes
-
-- Read this abstract before changing the service module.
-- Keep business behavior in service code and expose callable actions through signals.
-- Update this file when business invariants, workflows, or public behavior change.
-
-## Related Modules
-
-- None yet.

package/workflow.command-nwpcdc8p.js

@@ -1,107 +0,0 @@
-// @bun
-import {
-  Workspace,
-  script,
-  command
-} from "./index-mak3cd28.js";
-import"./index-q0y2jq9j.js";
-import"./index-2tv3fdx4.js";
-import"./index-6wwzs1bc.js";
-import {
-  createWorkflowStepRegistry
-} from "./index-gyd220p2.js";
-import"./index-kn1h7p1x.js";
-import {
-  ModuleScript
-} from "./index-8pm30m73.js";
-import"./index-pnqbkf5p.js";
-import"./index-h7yw2z9n.js";
-import {
-  PrimitiveScript
-} from "./index-4edzf1gr.js";
-import {
-  ScalarScript
-} from "./index-rwg2aa4f.js";
-import"./index-by5gpp8x.js";
-import"./index-ktb5njgy.js";
-import {
-  WorkflowRunner
-} from "./index-7737gxcp.js";
-
-// pkgs/@akanjs/cli/workflow/workflow.script.ts
-import { Logger } from "akanjs/common";
-class WorkflowScript extends script("workflow", [WorkflowRunner, ModuleScript, ScalarScript, PrimitiveScript]) {
-  async workflow(action, workflow, inputs, {
-    format = "markdown",
-    out = null,
-    dryRun = false,
-    workspace
-  } = {}) {
-    if (action === "list") {
-      Logger.rawLog(this.workflowRunner.list({ format }));
-      return;
-    }
-    if (!workflow)
-      throw new Error(`Workflow name is required for "${action}".`);
-    if (action === "explain") {
-      Logger.rawLog(this.workflowRunner.explain(workflow, { format }));
-      return;
-    }
-    if (action === "plan") {
-      Logger.rawLog(await this.workflowRunner.plan(workflow, inputs, { format, out }));
-      return;
-    }
-    if (action === "apply") {
-      if (!workspace)
-        throw new Error("Workspace is required for workflow apply.");
-      Logger.rawLog(await this.workflowRunner.apply(workflow, {
-        dryRun,
-        format,
-        workspace,
-        registry: createWorkflowStepRegistry({
-          workspace,
-          createModule: (sys, module) => this.moduleScript.createModuleTemplate(sys, module),
-          createScalar: (sys, scalar) => this.scalarScript.createScalar(sys, scalar),
-          createUi: (input) => this.primitiveScript.createUi(workspace, input),
-          addField: (input) => this.primitiveScript.addField(workspace, input),
-          addEnumField: (input) => this.primitiveScript.addEnumField(workspace, input),
-          addMutation: (input) => this.primitiveScript.addMutation(workspace, input),
-          addSlice: (input) => this.primitiveScript.addSlice(workspace, input)
-        })
-      }));
-      return;
-    }
-    if (action === "validate") {
-      if (!workspace)
-        throw new Error("Workspace is required for workflow validate.");
-      Logger.rawLog(await this.workflowRunner.validate(workflow, { format, workspace }));
-      return;
-    }
-    if (action === "report") {
-      if (!workspace)
-        throw new Error("Workspace is required for workflow report.");
-      Logger.rawLog(await this.workflowRunner.report(workflow, { format, workspace }));
-      return;
-    }
-    throw new Error(`Unknown workflow action: ${action}. Use list, explain, plan, apply, validate, or report.`);
-  }
-}
-
-// pkgs/@akanjs/cli/workflow/workflow.command.ts
-class WorkflowCommand extends command("workflow", [WorkflowScript], ({ public: target }) => ({
-  workflow: target({ desc: "List, explain, plan, apply, validate, or report Akan workflows" }).arg("action", String, {
-    desc: "list, explain, plan, apply, validate, or report",
-    enum: ["list", "explain", "plan", "apply", "validate", "report"]
-  }).arg("workflow", String, { desc: "workflow name, plan path, or run id", nullable: true }).with(Workspace).option("format", String, {
-    desc: "output format",
-    flag: "o",
-    default: "markdown",
-    enum: ["markdown", "json"]
-  }).option("out", String, { flag: "w", desc: "write workflow plan JSON to this path", nullable: true }).option("dryRun", Boolean, { flag: "r", desc: "show predicted apply report without writing files", default: false }).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("values", String, { flag: "l", desc: "comma-separated values", nullable: true }).option("default", String, { desc: "default value", nullable: true }).option("scalar", String, { flag: "c", desc: "scalar name", nullable: true }).option("surface", String, { flag: "u", desc: "UI surface name", nullable: true }).option("mutation", String, { flag: "n", desc: "mutation name", nullable: true }).option("slice", String, { flag: "i", desc: "slice name", nullable: true }).exec(async function(action, workflow, workspace, format, out, dryRun, app, module, field, typeName, values, defaultValue, scalar, surface, mutation, slice) {
-    await this.workflowScript.workflow(action, workflow, { app, module, field, type: typeName, values, default: defaultValue, scalar, surface, mutation, slice }, { format, out, dryRun, workspace });
-  })
-})) {
-}
-export {
-  WorkflowCommand
-};