akanjs 2.0.7 → 2.1.0-rc.0

package/cli/guideline/guideline.prompt.ts

@@ -1,212 +0,0 @@
-import { randomPicks } from "akanjs/common";
-import { type FileContent, FileSys, type GuideScan, getDirname, Prompter, type Workspace } from "akanjs/devkit";
-
-export class GuidelinePrompt extends Prompter {
-  constructor(
-    readonly workspace: Workspace,
-    readonly name: string,
-  ) {
-    super();
-  }
-  async #getScanFilePaths(
-    matchPattern: string,
-    { avoidDirs = ["node_modules", ".next"], filterText }: { avoidDirs?: string[]; filterText?: string } = {},
-  ): Promise<string[]> {
-    const glob = new Bun.Glob(matchPattern);
-    const paths: string[] = [];
-    for await (const path of glob.scan({ cwd: this.workspace.workspaceRoot, absolute: true })) {
-      if (avoidDirs.some((dir) => path.includes(dir))) continue;
-      const fileContent = await FileSys.readText(path);
-      const textFilter = filterText ? new RegExp(filterText) : null;
-      if (filterText && !textFilter?.test(fileContent)) continue;
-      paths.push(path);
-    }
-    return paths;
-  }
-  async requestCreateInstruction() {
-    const guideJson = await Prompter.getGuideJson(this.name);
-    const scanFiles: (GuideScan & FileContent)[] = [];
-    for (const scan of guideJson.scans) {
-      const scanFilePaths = await this.#getScanFilePaths(scan.path, { filterText: scan.filterText });
-      const targetFilePaths = scan.sample ? randomPicks(scanFilePaths, scan.sample) : scanFilePaths;
-      const scanResult = await Promise.all(
-        targetFilePaths.map(async (filePath) => ({ ...scan, ...(await this.workspace.getLocalFile(filePath)) })),
-      );
-      scanFiles.push(...scanResult);
-    }
-    const resultPath = `${getDirname(import.meta.url)}/../guidelines/${this.name}/${guideJson.update.filePath}`;
-    const writePath = `${this.workspace.workspaceRoot}/pkgs/akanjs/cli/guidelines/${this.name}/${guideJson.update.filePath}`;
-    const isResultExists = await this.workspace.exists(writePath);
-    const existingResult = isResultExists ? await this.workspace.readFile(resultPath) : null;
-    const request = `
-I am a developer of akanjs framework, a full-stack framework for building web applications.
-I want to generate a ${guideJson.update.filePath} file for ${guideJson.description}.
-This file is a programming guideline for Akan.js framwork users.
-
-# ${guideJson.title} Workflow
-- 1. Explore target files in ${guideJson.scans.map((scan) => scan.path).join(", ")}.
-- 2. Read already-written ${guideJson.update.filePath} file if exists. There can be some outdated information, so you need to update the file and add new information, make it more accurate and more detailed.
-- 3. Write the updated file content of the ${guideJson.update.filePath}. It should include the contents of ${guideJson.update.contents.join(",")}, and any other helpful information and contents for guiding.  Also, you can rearrange the contents if you think it's more helpful.
-
-## 1. Explore target files in ${guideJson.scans.map((scan) => scan.path).join(", ")}.
-${scanFiles
-  .map(
-    ({ type, description, filePath, content, sample }) => `
-\`\`\`${filePath.endsWith(".tsx") ? "tsx" : "typescript"}
-${content}
-\`\`\`
-`,
-  )
-  .join("\n")}
-
-## 2. Read already-written ${guideJson.update.filePath} file if exists. There can be some outdated information, so you need to update the file and add new information, make it more accurate and more detailed.
-${
-  existingResult
-    ? `\`\`\`markdown
-${existingResult}
-\`\`\``
-    : "- No existing guideline file."
-}
-
-## 3. Write the updated file content of the ${guideJson.update.filePath}. It should include the contents of ${guideJson.update.contents.join(",")}, and any other helpful information and contents for guiding. Also, you can rearrange the contents if you think it's more helpful.
-
-Here's the last rules for writing the file content:
-${guideJson.update.rules.map((rule) => `- ${rule}`).join("\n")}
-
-=> Now, you need to write the file content here. Let's go.
-`;
-    return { guideJson, request, writePath };
-  }
-  async requestUpdateInstruction(updateRequest: string) {
-    const guideJson = await Prompter.getGuideJson(this.name);
-    const resultPath = `${getDirname(import.meta.url)}/../guidelines/${this.name}/${guideJson.update.filePath}`;
-    const writePath = `${this.workspace.workspaceRoot}/pkgs/akanjs/cli/guidelines/${this.name}/${guideJson.update.filePath}`;
-    const isResultExists = await this.workspace.exists(writePath);
-    if (!isResultExists) throw new Error(`${guideJson.update.filePath} file does not exist. Please create it first.`);
-    const existingResult = await 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: string) {
-    const writePath = `apps/angelo/app${page}`;
-    if (!(await this.workspace.exists(writePath)))
-      await this.workspace.writeFile(
-        writePath,
-        `export default function Page() {
-  return <div>No Content</div>;
-}
-`,
-      );
-    const instruction = await Prompter.getInstruction(this.name);
-    const pageContent = await this.workspace.getLocalFile(writePath);
-    const request = `
-I'm creating a documentation website for the Akan.js framework.
-
-1. Overview of the Akan.js framework
-${await this.getDocumentation("framework")}
-
-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
-${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
-...pageContent
-\`\`\`
-`;
-    return { request, writePath };
-  }
-  async requestUpdateDocumentPage(page: string, updateRequest: string) {
-    const writePath = `apps/angelo/app${page}`;
-    if (!(await this.workspace.exists(writePath)))
-      await this.workspace.writeFile(
-        writePath,
-        `export default function Page() {
-  return <div>No Content</div>;
-}
-`,
-      );
-    const instruction = await Prompter.getInstruction(this.name);
-    const pageContent = await 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
-${pageContent.content}
-\`\`\`
-
-The existing instruction is below.
-\`\`\`markdown
-${instruction}
-\`\`\`
-
-Please update this page with the request below.
-${updateRequest}
-
-Please return only the file result in the following format for easy parsing.
-\`\`\`tsx
-...pageContent
-\`\`\`
-`;
-    return { request, writePath };
-  }
-  async requestReapplyInstruction(filePath: string) {
-    const guideJson = await Prompter.getGuideJson(this.name);
-    const writePath = `${this.workspace.workspaceRoot}/pkgs/akanjs/cli/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 = await 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
-${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 };
-  }
-}

package/cli/guideline/guideline.runner.ts

@@ -1,53 +0,0 @@
-import { AiSession, Prompter, runner, type Workspace } from "akanjs/devkit";
-
-import { GuidelinePrompt } from "./guideline.prompt";
-
-export class GuidelineRunner extends runner("guideline") {
-  async generateInstruction(workspace: Workspace, guideName: string) {
-    const session = new AiSession("generateInstruction", { workspace, cacheKey: guideName });
-    const prompt = new GuidelinePrompt(workspace, guideName);
-    const { guideJson, request, writePath } = await prompt.requestCreateInstruction();
-    const guidelineContent = await session.editMarkdown(request);
-    await workspace.writeFile(writePath, guidelineContent);
-    return { guideJson, session };
-  }
-  async updateInstruction(workspace: Workspace, guideName: string, { updateRequest }: { updateRequest: string }) {
-    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);
-    await workspace.writeFile(writePath, guidelineContent);
-    return { guideJson, session };
-  }
-
-  async generateDocument(workspace: Workspace, guideName: string) {
-    const session = new AiSession("deployDocPages", { workspace, cacheKey: guideName });
-    const guideJson = await Prompter.getGuideJson(guideName);
-    const prompt = new GuidelinePrompt(workspace, guideName);
-    if (!guideJson.page) return Promise.resolve({});
-    const { request } = await prompt.requestCreateDocumentPage(guideJson.page);
-    await session.writeTypescripts(request, workspace);
-  }
-
-  async updateDocument(
-    workspace: Workspace,
-    guideName: string,
-    { updateRequest, session }: { updateRequest: string; session: AiSession },
-  ) {
-    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);
-    await workspace.writeFile(writePath, guidelineContent);
-  }
-
-  async reapplyInstruction(workspace: Workspace, guideName: string) {
-    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);
-    await workspace.writeFile(writePath, guidelineContent);
-  }
-}

package/cli/guideline/guideline.script.ts

@@ -1,33 +0,0 @@
-import { type AiSession, Prompter, script, type Workspace } from "akanjs/devkit";
-
-import { GuidelineRunner } from "./guideline.runner";
-
-export class GuidelineScript extends script("guideline", [GuidelineRunner]) {
-  async generateInstruction(workspace: Workspace, name: string | null = null) {
-    const guideName = name ?? (await Prompter.selectGuideline());
-    await this.guidelineRunner.generateInstruction(workspace, guideName);
-  }
-  async updateInstruction(workspace: Workspace, name: string | null = null, updateRequest: string) {
-    const guideName = name ?? (await Prompter.selectGuideline());
-    const { guideJson, session } = await this.guidelineRunner.updateInstruction(workspace, guideName, {
-      updateRequest,
-    });
-    if (guideJson.page) await this.updateDocument(workspace, guideName, { updateRequest, session });
-  }
-  async generateDocument(workspace: Workspace, name: string | null = null) {
-    const guideName = name ?? (await Prompter.selectGuideline());
-    await this.guidelineRunner.generateDocument(workspace, guideName);
-  }
-  async updateDocument(
-    workspace: Workspace,
-    name: string | null = null,
-    { updateRequest, session }: { updateRequest: string; session: AiSession },
-  ) {
-    const guideName = name ?? (await Prompter.selectGuideline());
-    await this.guidelineRunner.updateDocument(workspace, guideName, { updateRequest, session });
-  }
-  async reapplyInstruction(workspace: Workspace, name: string | null = null) {
-    const guideName = name ?? (await Prompter.selectGuideline());
-    await this.guidelineRunner.reapplyInstruction(workspace, guideName);
-  }
-}