@akanjs/cli 0.0.145 → 0.0.147

package/README.md

@@ -1,6 +1,6 @@
-# ⚡ AkanJS CLI
+# ⚡ Akan.js CLI
 
-The official command-line interface for the AkanJS ecosystem, providing powerful development tools for creating, managing, and deploying modern web applications with ease.
+The official command-line interface for the Akan.js ecosystem, providing powerful development tools for creating, managing, and deploying modern web applications with ease.
 
 ## 🚀 Get Started
 
@@ -42,7 +42,7 @@ akan set-llm
 # create module
 akan create-module
 
-# create scalar with ai (experimental)
+# create scalar
 akan create-scalar
 ```
 
@@ -55,7 +55,7 @@ The `@akanjs/cli` is a comprehensive development toolkit that streamlines the en
 Complete workspace and project management:
 
 - **🚀 Project Initialization**
-  - `create-workspace` - Create new AkanJS workspace with organization setup
+  - `create-workspace` - Create new Akan.js workspace with organization setup
   - `generate-mongo` - Generate MongoDB configuration and setup
   - `lint` / `lint-all` - Code linting with auto-fix capabilities
 
@@ -151,7 +151,7 @@ Seamless cloud services and AI integration:
   - `ask` - Interactive AI development assistance
 
 - **🚀 Deployment**
-  - `deploy-akan` - Deploy to AkanJS cloud infrastructure
+  - `deploy-akan` - Deploy to Akan.js cloud infrastructure
   - `update` - Update CLI and cloud integrations
 
 ### 📦 **Package Operations** (`package`)
@@ -265,25 +265,6 @@ akan pull-database web-app --env debug --dump
 akan dbup
 ```
 
-## 🏗️ Architecture
-
-The CLI follows a modular command structure:
-
-```
-pkgs/@akanjs/cli/
-├── src/
-│   ├── workspace/       # Workspace management commands
-│   ├── application/     # Application lifecycle commands
-│   ├── library/         # Library management commands
-│   ├── module/          # AI-powered module generation
-│   ├── page/           # Page scaffolding commands
-│   ├── package/        # NPM package operations
-│   ├── cloud/          # Cloud services integration
-│   └── templates/      # Code generation templates
-├── index.ts            # CLI entry point
-└── package.json        # Dependencies and configuration
-```
-
 ## 🤖 AI-Powered Development
 
 The CLI integrates advanced AI capabilities:
@@ -314,7 +295,7 @@ The CLI integrates advanced AI capabilities:
 
 ## 📄 License
 
-This project is part of the AkanJS ecosystem. See the main repository for license information.
+This project is part of the Akan.js ecosystem. See the main repository for license information.
 
 ## 🔗 Related Packages
 
@@ -327,5 +308,5 @@ This project is part of the AkanJS ecosystem. See the main repository for licens
 ---
 
 <p align="center">
-  <strong>Built with ❤️ by the AkanJS team</strong>
+  <strong>Built with ❤️ by the Akan.js team</strong>
 </p>

package/cjs/index.js

@@ -1251,7 +1251,10 @@ ${errorMessages}`);
     ];
     const errors = diagnostics.filter((diagnostic) => diagnostic.category === ts3.DiagnosticCategory.Error);
     const warnings = diagnostics.filter((diagnostic) => diagnostic.category === ts3.DiagnosticCategory.Warning);
-    return { diagnostics, errors, warnings };
+    const fileDiagnostics = diagnostics.filter((diagnostic) => diagnostic.file?.fileName === filePath);
+    const fileErrors = fileDiagnostics.filter((diagnostic) => diagnostic.category === ts3.DiagnosticCategory.Error);
+    const fileWarnings = fileDiagnostics.filter((diagnostic) => diagnostic.category === ts3.DiagnosticCategory.Warning);
+    return { diagnostics, errors, warnings, fileDiagnostics, fileErrors, fileWarnings };
   }
   /**
    * Format diagnostics for console output
@@ -1678,9 +1681,9 @@ var Executor = class _Executor {
   typeCheck(filePath) {
     const path9 = this.getPath(filePath);
     const typeChecker = this.getTypeChecker();
-    const { diagnostics, errors, warnings } = typeChecker.check(path9);
-    const message = typeChecker.formatDiagnostics(diagnostics);
-    return { diagnostics, errors, warnings, message };
+    const { fileDiagnostics, fileErrors, fileWarnings } = typeChecker.check(path9);
+    const message = typeChecker.formatDiagnostics(fileDiagnostics);
+    return { fileDiagnostics, fileErrors, fileWarnings, message };
   }
   getLinter() {
     this.linter ??= new Linter(this.cwdPath);
@@ -3105,7 +3108,7 @@ ${validate.map((v) => `- ${v}`).join("\n")}`;
         writes.map(async ({ filePath }) => {
           const typeCheckResult = executor.typeCheck(filePath);
           const lintResult = await executor.lint(filePath);
-          const needFix2 = !!typeCheckResult.errors.length || !!lintResult.errors.length;
+          const needFix2 = !!typeCheckResult.fileErrors.length || !!lintResult.errors.length;
           return { filePath, typeCheckResult, lintResult, needFix: needFix2 };
         })
       );
@@ -3139,7 +3142,7 @@ ${fileCheck.lintResult.message}`
     throw new Error("Failed to create scalar");
   }
   #getTypescriptCodes(text) {
-    const codes = text.match(/```typescript([\s\S]*?)```/g);
+    const codes = text.match(/```(typescript|tsx)([\s\S]*?)```/g);
     if (!codes)
       return [];
     const result = codes.map((code) => {
@@ -3264,6 +3267,9 @@ var Prompter = class {
     const content = await import_promises2.default.readFile(filePath, "utf-8");
     return content;
   }
+  static async getUpdateRequest(guideName) {
+    return await (0, import_prompts5.input)({ message: `What do you want to update in ${guideName}?` });
+  }
   async makeTsFileUpdatePrompt({ context: context2, request }) {
     return `You are a senior developer writing TypeScript-based programs using Akan.js, an in-house framework. Here's an overview of the Akan.js framework:
 ${await this.getDocumentation("framework")}
@@ -5494,7 +5500,9 @@ var GuidelinePrompt = class extends Prompter {
     });
     const paths = [];
     for await (const path9 of matchingPaths) {
-      if (filterText && !import_fs12.default.readFileSync(path9, "utf-8").includes(filterText))
+      const fileContent = import_fs12.default.readFileSync(path9, "utf-8");
+      const textFilter = filterText ? new RegExp(filterText) : null;
+      if (filterText && !textFilter?.test(fileContent))
         continue;
       paths.push(path9);
     }
@@ -5547,10 +5555,39 @@ ${guideJson.update.rules.map((rule) => `- ${rule}`).join("\n")}
 
 => Now, you need to write the file content here. Let's go.
 `;
-    return { request, writePath };
+    return { guideJson, request, writePath };
   }
-  async requestUpdateDocumentPage(page) {
-    const writePath = `apps/angelo/app/${page}`;
+  async requestUpdateInstruction(updateRequest) {
+    const guideJson = await Prompter.getGuideJson(this.name);
+    const resultPath = `${__dirname}/src/guidelines/${this.name}/${guideJson.update.filePath}`;
+    const writePath = `${this.workspace.workspaceRoot}/pkgs/@akanjs/cli/src/guidelines/${this.name}/${guideJson.update.filePath}`;
+    const isResultExists = this.workspace.exists(writePath);
+    if (!isResultExists)
+      throw new Error(`${guideJson.update.filePath} file does not exist. Please create it first.`);
+    const existingResult = this.workspace.readFile(resultPath);
+    const request = `
+I am a developer of akanjs framework, a full-stack framework for building web applications.
+I want to update a ${guideJson.update.filePath} file for ${guideJson.description}.
+This file is a programming guideline for Akan.js framwork users.
+
+# ${guideJson.title} Workflow
+- 1. Read already-written ${guideJson.update.filePath} file.
+- 2. Write the updated file content of the ${guideJson.update.filePath} with the update request.
+
+## 1. Read already-written ${guideJson.update.filePath} file.
+\`\`\`markdown
+${existingResult}
+\`\`\`
+
+## 2. Write the updated file content of the ${guideJson.update.filePath} with the update request.
+Request: ${updateRequest}
+
+=> Now, you need to write the file content here. Let's go.
+`;
+    return { guideJson, request, writePath };
+  }
+  async requestCreateDocumentPage(page) {
+    const writePath = `apps/angelo/app${page}`;
     if (!this.workspace.exists(writePath))
       this.workspace.writeFile(
         writePath,
@@ -5562,30 +5599,99 @@ ${guideJson.update.rules.map((rule) => `- ${rule}`).join("\n")}
     const instruction = await Prompter.getInstruction(this.name);
     const pageContent = this.workspace.getLocalFile(writePath);
     const request = `
-\uB098\uB294 Akan.js \uD504\uB808\uC784\uC6CC\uD06C\uC5D0 \uB300\uD55C documentation \uC6F9\uC0AC\uC774\uD2B8\uB97C \uB9CC\uB4E4\uACE0 \uC788\uC5B4.
+I'm creating a documentation website for the Akan.js framework.
 
-1. Akan.js \uD504\uB808\uC784\uC6CC\uD06C\uC5D0 \uB300\uD55C \uAC1C\uC694
+1. Overview of the Akan.js framework
 ${await this.getDocumentation("framework")}
 
-\uB098\uB294 ${writePath}\uC5D0 \uC788\uB294 Next.js \uC11C\uBC84\uC0AC\uC774\uB4DC \uD398\uC774\uC9C0\uB97C \uC5C5\uB370\uC774\uD2B8\uD558\uB824\uACE0 \uD574.
-\uC544\uB798\uB294 \uD604\uC7AC \uC791\uC131\uB41C \uD398\uC774\uC9C0\uC758 \uB0B4\uC6A9\uC774\uC57C.
+2. Documentation page writing method
+${await this.getDocumentation("docPageRule")}
+
+3. CSS rule with TailwindCSS and DaisyUI
+${await this.getDocumentation("cssRule")}
+
+I want to update the Next.js server-side page located at ${writePath}.
+Below is the content of the currently written page.
+\`\`\`tsx
+// File: ${writePath}
+${pageContent.content}
+\`\`\`
+
+Please update this page with the latest content below. A great design application is needed.
+${instruction}
+
+Please follow these CSS rules when writing:
+- Use tailwindcss
+- Use className from the daisyui library
+
+Please return only the file result in the following format for easy parsing.
+\`\`\`tsx
+// File: ${writePath}
+...pageContent
+\`\`\`
+`;
+    return { request, writePath };
+  }
+  async requestUpdateDocumentPage(page, updateRequest) {
+    const writePath = `apps/angelo/app${page}`;
+    if (!this.workspace.exists(writePath))
+      this.workspace.writeFile(
+        writePath,
+        `export default function Page() {
+  return <div>No Content</div>;
+}
+`
+      );
+    const instruction = await Prompter.getInstruction(this.name);
+    const pageContent = this.workspace.getLocalFile(writePath);
+    const request = `
+I'm updating a documentation website for the Akan.js framework.
+
+I want to update the Next.js server-side page located at ${writePath}.
+Below is the content of the currently written page. You should update stale infos and preserve the existing content.
 \`\`\`tsx
 // File: ${writePath}
 ${pageContent.content}
 \`\`\`
 
-\uD574\uB2F9 \uD398\uC774\uC9C0\uC5D0 \uC544\uB798 \uB0B4\uC6A9\uC744 \uCD5C\uC2E0\uD654 \uD574\uC11C \uC5C5\uB370\uC774\uD2B8\uD574\uC918. \uADFC\uC0AC\uD55C \uB514\uC790\uC778\uC73C\uB85C \uC801\uC6A9\uC774 \uD544\uC694\uD574.
+The existing instruction is below.
+\`\`\`markdown
 ${instruction}
+\`\`\`
 
-CSS\uADDC\uCE59\uC740 \uB2E4\uC74C\uC744 \uB530\uB77C\uC11C \uC791\uC131\uD574\uC918.
-- tailwindcss\uB97C \uC0AC\uC6A9\uD560 \uAC83
-- daisyui \uB77C\uC774\uBE0C\uB7EC\uB9AC\uC758 className\uC744 \uC0AC\uC6A9\uD560 \uAC83
+Please update this page with the request below.
+${updateRequest}
 
-\uD30C\uC2F1\uD558\uAE30 \uC27D\uAC8C \uD30C\uC77C \uACB0\uACFC\uB9CC \uB2E4\uC74C\uACFC \uAC19\uC740 \uD615\uC2DD\uC73C\uB85C \uBC18\uD658\uD574\uC918.
+Please return only the file result in the following format for easy parsing.
 \`\`\`tsx
 // File: ${writePath}
 ...pageContent
 \`\`\`
+`;
+    return { request, writePath };
+  }
+  async requestReapplyInstruction(filePath) {
+    const guideJson = await Prompter.getGuideJson(this.name);
+    const writePath = `${this.workspace.workspaceRoot}/pkgs/@akanjs/cli/src/guidelines/${this.name}/${guideJson.update.filePath}`;
+    if (!guideJson.page)
+      throw new Error(`${this.name} does not have a page.`);
+    const pagePath = `apps/angelo/app${guideJson.page}`;
+    const pageFile = this.workspace.getLocalFile(pagePath);
+    const request = `
+I want to apply information in the Next.js page to markdown instruction file.
+
+Here's the newest information in the Next.js page.
+\`\`\`tsx
+// File: ${pagePath}
+${pageFile.content}
+\`\`\`
+
+Here's the existing instruction file.
+\`\`\`markdown
+${await Prompter.getInstruction(this.name)}
+\`\`\`
+
+Please update the instruction file with the information in the Next.js page.
 `;
     return { request, writePath };
   }
@@ -5596,18 +5702,44 @@ var GuidelineRunner = class {
   async generateInstruction(workspace, guideName) {
     const session = new AiSession("generateInstruction", { workspace, cacheKey: guideName });
     const prompt = new GuidelinePrompt(workspace, guideName);
-    const { request, writePath } = await prompt.requestCreateInstruction();
+    const { guideJson, request, writePath } = await prompt.requestCreateInstruction();
     const guidelineContent = await session.editMarkdown(request);
     workspace.writeFile(writePath, guidelineContent);
+    return { guideJson, session };
   }
-  async deployDocPages(workspace, guideName) {
+  async updateInstruction(workspace, guideName, { updateRequest }) {
+    const session = new AiSession("updateInstruction", { workspace, cacheKey: guideName });
+    const prompt = new GuidelinePrompt(workspace, guideName);
+    const { guideJson, request, writePath } = await prompt.requestUpdateInstruction(updateRequest);
+    const guidelineContent = await session.editMarkdown(request);
+    workspace.writeFile(writePath, guidelineContent);
+    return { guideJson, session };
+  }
+  async generateDocument(workspace, guideName) {
     const session = new AiSession("deployDocPages", { workspace, cacheKey: guideName });
     const guideJson = await Prompter.getGuideJson(guideName);
     const prompt = new GuidelinePrompt(workspace, guideName);
-    const { request, writePath } = await prompt.requestUpdateDocumentPage(guideJson.page);
+    if (!guideJson.page)
+      return Promise.resolve({});
+    const { request } = await prompt.requestCreateDocumentPage(guideJson.page);
+    await session.writeTypescripts(request, workspace);
+  }
+  async updateDocument(workspace, guideName, { updateRequest, session }) {
+    const guideJson = await Prompter.getGuideJson(guideName);
+    if (!guideJson.page)
+      throw new Error(`${guideName} does not have a page.`);
+    const prompt = new GuidelinePrompt(workspace, guideName);
+    const { request, writePath } = await prompt.requestUpdateDocumentPage(guideJson.page, updateRequest);
+    const guidelineContent = await session.editMarkdown(request);
+    workspace.writeFile(writePath, guidelineContent);
+  }
+  async reapplyInstruction(workspace, guideName) {
+    const session = new AiSession("reapplyInstruction", { workspace, cacheKey: guideName });
+    const guideJson = await Prompter.getGuideJson(guideName);
+    const prompt = new GuidelinePrompt(workspace, guideName);
+    const { request, writePath } = await prompt.requestReapplyInstruction(guideJson.update.filePath);
     const guidelineContent = await session.editMarkdown(request);
     workspace.writeFile(writePath, guidelineContent);
-    return Promise.resolve({});
   }
 };
 
@@ -5618,9 +5750,23 @@ var GuidelineScript = class {
     const guideName = name ?? await Prompter.selectGuideline();
     await this.#runner.generateInstruction(workspace, guideName);
   }
-  async deployDocPages(workspace, name = null) {
+  async updateInstruction(workspace, name = null, updateRequest) {
+    const guideName = name ?? await Prompter.selectGuideline();
+    const { guideJson, session } = await this.#runner.updateInstruction(workspace, guideName, { updateRequest });
+    if (guideJson.page)
+      await this.updateDocument(workspace, guideName, { updateRequest, session });
+  }
+  async generateDocument(workspace, name = null) {
     const guideName = name ?? await Prompter.selectGuideline();
-    await this.#runner.deployDocPages(workspace, guideName);
+    await this.#runner.generateDocument(workspace, guideName);
+  }
+  async updateDocument(workspace, name = null, { updateRequest, session }) {
+    const guideName = name ?? await Prompter.selectGuideline();
+    await this.#runner.updateDocument(workspace, guideName, { updateRequest, session });
+  }
+  async reapplyInstruction(workspace, name = null) {
+    const guideName = name ?? await Prompter.selectGuideline();
+    await this.#runner.reapplyInstruction(workspace, guideName);
   }
 };
 
@@ -5630,8 +5776,14 @@ var GuidelineCommand = class {
   async generateInstruction(name, workspace) {
     await this.guidelineScript.generateInstruction(workspace, name);
   }
-  async deployDocs(name, workspace) {
-    await this.guidelineScript.deployDocPages(workspace, name);
+  async updateInstruction(name, request, workspace) {
+    await this.guidelineScript.updateInstruction(workspace, name, request);
+  }
+  async generateDocument(name, workspace) {
+    await this.guidelineScript.generateDocument(workspace, name);
+  }
+  async reapplyInstruction(name, workspace) {
+    await this.guidelineScript.reapplyInstruction(workspace, name);
   }
 };
 __decorateClass([
@@ -5639,11 +5791,22 @@ __decorateClass([
   __decorateParam(0, Argument("name", { ask: "name of the instruction", nullable: true })),
   __decorateParam(1, Workspace())
 ], GuidelineCommand.prototype, "generateInstruction", 1);
+__decorateClass([
+  Target.Public(),
+  __decorateParam(0, Argument("name", { ask: "name of the instruction", nullable: true })),
+  __decorateParam(1, Option("request", { ask: "What do you want to update?" })),
+  __decorateParam(2, Workspace())
+], GuidelineCommand.prototype, "updateInstruction", 1);
+__decorateClass([
+  Target.Public(),
+  __decorateParam(0, Argument("name", { ask: "name of the instruction", nullable: true })),
+  __decorateParam(1, Workspace())
+], GuidelineCommand.prototype, "generateDocument", 1);
 __decorateClass([
   Target.Public(),
   __decorateParam(0, Argument("name", { ask: "name of the instruction", nullable: true })),
   __decorateParam(1, Workspace())
-], GuidelineCommand.prototype, "deployDocs", 1);
+], GuidelineCommand.prototype, "reapplyInstruction", 1);
 GuidelineCommand = __decorateClass([
   Commands()
 ], GuidelineCommand);

package/cjs/src/guidelines/componentRule/componentRule.instruction.md

@@ -5,10 +5,9 @@
 1. [Component Architecture](#component-architecture)
 2. [Component Types](#component-types)
 3. [File Naming Conventions](#file-naming-conventions)
-4. [CSS Rule with TailwindCSS and DaisyUI](#css-rule-with-tailwindcss-and-daisyui)
-5. [Utility Functions](#utility-functions)
-6. [Best Practices](#best-practices)
-7. [Complete Examples](#complete-examples)
+4. [Utility Functions](#utility-functions)
+5. [Best Practices](#best-practices)
+6. [Complete Examples](#complete-examples)
 
 ---
 
@@ -248,83 +247,6 @@ Akan.js uses a strict naming convention to maintain consistency:
 
 ---
 
-## CSS Rule with TailwindCSS and DaisyUI
-
-Akan.js uses TailwindCSS with DaisyUI for styling. Follow these guidelines:
-
-### 1. Class Management
-
-Always use `clsx` for conditional and composite classes:
-
-```tsx
-import { clsx } from "@akanjs/client";
-
-className={clsx(
-  "base-classes",
-  condition && "conditional-class",
-  variant === "primary" ? "primary-class" : "secondary-class",
-  className // Always include passed className for composition
-)}
-```
-
-### 2. Color System
-
-Use DaisyUI's theme colors instead of hardcoded values. This ensures theme consistency and dark/light mode compatibility:
-
-```tsx
-// Good - uses theme colors
-className = "bg-primary text-base-100";
-
-// Bad - uses hardcoded colors
-className = "bg-[#C33C32] text-[#FFFFFF]";
-```
-
-DaisyUI provides semantic colors:
-
-- `primary`, `secondary`, `accent` - Brand colors
-- `base-100` through `base-900` - Background/text variants
-- `info`, `success`, `warning`, `error` - Status colors
-
-### 3. Responsive Design
-
-Use Tailwind's responsive prefixes:
-
-```tsx
-<div className="flex-col md:flex-row">
-  <div className="w-full md:w-1/2 lg:w-1/3">Responsive width</div>
-  <div className="hidden lg:block">Only visible on large screens</div>
-</div>
-```
-
-### 4. Animation
-
-Use Tailwind animation classes with transitions:
-
-```tsx
-<div className="transition-all duration-300 hover:scale-105">
-  Hover effect
-</div>
-
-<div className="animate-pulse">Loading indicator</div>
-```
-
-### 5. Component Styling
-
-Use DaisyUI components for consistent UIs:
-
-```tsx
-<button className="btn btn-primary btn-sm">Primary Button</button>
-
-<div className="card bg-base-200 shadow-md">
-  <div className="card-body">
-    <h2 className="card-title">Card Title</h2>
-    <p>Card content</p>
-  </div>
-</div>
-```
-
----
-
 ## Utility Functions
 
 Akan.js provides several utility modules for common frontend tasks: