@autobe/filesystem 0.14.0-dev.20250727 → 0.14.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Wrtn Technologies
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -1,34 +1,67 @@
-{
-  "name": "@autobe/filesystem",
-  "version": "0.14.0-dev.20250727",
-  "description": "Internal FileSystem for AutoBE Project, not distributed to public",
-  "main": "src/index.ts",
-  "scripts": {
-    "build": "rimraf lib && tsc",
-    "prepack": "pnpm run build"
-  },
-  "author": "Wrtn Technologies",
-  "license": "MIT",
-  "packageManager": "pnpm@10.6.4",
-  "dependencies": {
-    "@samchon/openapi": "catalog:samchon",
-    "tstl": "catalog:samchon"
-  },
-  "devDependencies": {
-    "@types/node": "^22.15.19",
-    "rimraf": "^6.0.1",
-    "typescript": "catalog:typescript"
-  },
-  "files": [
-    "lib",
-    "src",
-    "package.json",
-    "LICENSE",
-    "README.md"
-  ],
-  "publishConfig": {
-    "access": "public",
-    "main": "lib/index.js",
-    "typings": "lib/index.d.ts"
-  }
-}
+{
+  "name": "@autobe/filesystem",
+  "version": "0.14.3",
+  "description": "AI backend server code generator",
+  "main": "lib/index.js",
+  "author": "Wrtn Technologies",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wrtnlabs/autobe"
+  },
+  "bugs": {
+    "url": "https://github.com/wrtnlabs/autobe/issues"
+  },
+  "dependencies": {
+    "@samchon/openapi": "^4.6.0",
+    "tstl": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.19",
+    "rimraf": "^6.0.1",
+    "typescript": "~5.8.3"
+  },
+  "files": [
+    "lib",
+    "src",
+    "package.json",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "ai",
+    "api",
+    "api-design",
+    "auto-generation",
+    "autobe",
+    "automation",
+    "backend",
+    "backend-development",
+    "code-generation",
+    "documentation",
+    "e2e-testing",
+    "erd",
+    "nestjs",
+    "openapi",
+    "orm",
+    "postgres",
+    "postgresql",
+    "prisma",
+    "requirements-analysis",
+    "rest",
+    "server",
+    "spiral-model",
+    "swagger",
+    "testing",
+    "typescript",
+    "vibe-coding",
+    "waterfall"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rimraf lib && tsc"
+  },
+  "typings": "lib/index.d.ts"
+}

package/src/FileSystemIterator.ts

@@ -1,53 +1,53 @@
-import fs from "fs";
-import path from "path";
-import { VariadicSingleton } from "tstl";
-
-/** @internal */
-export namespace FileSystemIterator {
-  export const read = async (props: {
-    root: string;
-    extension?: string;
-    prefix?: string;
-  }): Promise<Record<string, string>> => {
-    const output: Record<string, string> = {};
-    const iterate = async (location: string) => {
-      const directory: string[] = await fs.promises.readdir(location);
-      for (const file of directory) {
-        const next: string = `${location}/${file}`;
-        const stat: fs.Stats = await fs.promises.stat(next);
-        if (stat.isDirectory()) await iterate(next);
-        else if (
-          !props.extension?.length ||
-          file.endsWith(`.${props.extension}`)
-        )
-          output[
-            `${props.prefix ?? ""}${next.substring(props.root.length + 1)}`
-          ] = await fs.promises.readFile(next, "utf-8");
-      }
-    };
-    await iterate(props.root);
-    return output;
-  };
-
-  export const save = async (props: {
-    root: string;
-    files: Record<string, string>;
-  }): Promise<void> => {
-    if (fs.existsSync(props.root))
-      await fs.promises.rm(props.root, {
-        recursive: true,
-      });
-    const directory = new VariadicSingleton(async (location: string) => {
-      try {
-        await fs.promises.mkdir(location, {
-          recursive: true,
-        });
-      } catch {}
-    });
-    for (const [key, value] of Object.entries(props.files)) {
-      const file: string = path.resolve(`${props.root}/${key}`);
-      await directory.get(path.dirname(file));
-      await fs.promises.writeFile(file, value ?? "", "utf8");
-    }
-  };
-}
+import fs from "fs";
+import path from "path";
+import { VariadicSingleton } from "tstl";
+
+/** @internal */
+export namespace FileSystemIterator {
+  export const read = async (props: {
+    root: string;
+    extension?: string;
+    prefix?: string;
+  }): Promise<Record<string, string>> => {
+    const output: Record<string, string> = {};
+    const iterate = async (location: string) => {
+      const directory: string[] = await fs.promises.readdir(location);
+      for (const file of directory) {
+        const next: string = `${location}/${file}`;
+        const stat: fs.Stats = await fs.promises.stat(next);
+        if (stat.isDirectory()) await iterate(next);
+        else if (
+          !props.extension?.length ||
+          file.endsWith(`.${props.extension}`)
+        )
+          output[
+            `${props.prefix ?? ""}${next.substring(props.root.length + 1)}`
+          ] = await fs.promises.readFile(next, "utf-8");
+      }
+    };
+    await iterate(props.root);
+    return output;
+  };
+
+  export const save = async (props: {
+    root: string;
+    files: Record<string, string>;
+  }): Promise<void> => {
+    if (fs.existsSync(props.root))
+      await fs.promises.rm(props.root, {
+        recursive: true,
+      });
+    const directory = new VariadicSingleton(async (location: string) => {
+      try {
+        await fs.promises.mkdir(location, {
+          recursive: true,
+        });
+      } catch {}
+    });
+    for (const [key, value] of Object.entries(props.files)) {
+      const file: string = path.resolve(`${props.root}/${key}`);
+      await directory.get(path.dirname(file));
+      await fs.promises.writeFile(file, value ?? "", "utf8");
+    }
+  };
+}

package/src/RepositoryFileSystem.ts

@@ -1,92 +1,92 @@
-import { OpenApi } from "@samchon/openapi";
-import cp from "child_process";
-import fs from "fs";
-import { VariadicSingleton } from "tstl";
-
-import { FileSystemIterator } from "./FileSystemIterator";
-
-/** @internal */
-export namespace RepositoryFileSystem {
-  export const analyze = async (
-    account: string,
-    project: string,
-  ): Promise<Record<string, string>> => {
-    await vs.get(account, project);
-    return FileSystemIterator.read({
-      root: `${ROOT}/internals/repositories/${account}/${project}/docs/requirements`,
-      extension: "md",
-    });
-  };
-
-  export const prisma = async (
-    account: string,
-    project: string,
-  ): Promise<Record<string, string>> => {
-    await vs.get(account, project);
-    const result: Record<string, string> = await FileSystemIterator.read({
-      root: `${ROOT}/internals/repositories/${account}/${project}/prisma/schema`,
-      extension: "prisma",
-    });
-    for (const [key, value] of Object.entries(result))
-      result[key] = value.split("@author Samchon").join("@author AutoBE");
-    return result;
-  };
-
-  export const src = async (
-    account: string,
-    project: string,
-  ): Promise<Record<string, string>> => {
-    await vs.get(account, project);
-    return FileSystemIterator.read({
-      root: `${ROOT}/internals/repositories/${account}/${project}/src`,
-      prefix: "src/",
-      extension: "ts",
-    });
-  };
-
-  export const swagger = async (
-    account: string,
-    project: string,
-  ): Promise<OpenApi.IDocument> => {
-    await vs.get(account, project);
-    return OpenApi.convert(
-      JSON.parse(
-        await fs.promises.readFile(
-          `${ROOT}/internals/repositories/${account}/${project}/packages/api/swagger.json`,
-          "utf8",
-        ),
-      ),
-    );
-  };
-
-  export const clone = async (
-    account: string,
-    project: string,
-  ): Promise<void> => {
-    await vs.get(account, project);
-  };
-
-  const vs = new VariadicSingleton(
-    async (account: string, project: string): Promise<void> => {
-      const location: string = `${ROOT}/internals/repositories/${account}/${project}`;
-      if (fs.existsSync(location))
-        cp.execSync("git pull", {
-          cwd: location,
-          stdio: "ignore",
-        });
-      else {
-        try {
-          await fs.promises.mkdir(`${ROOT}/internals/repositories/${account}`, {
-            recursive: true,
-          });
-        } catch {}
-        cp.execSync(`git clone https://github.com/${account}/${project}`, {
-          cwd: `${ROOT}/internals/repositories/${account}`,
-          stdio: "ignore",
-        });
-      }
-    },
-  );
-
-  const ROOT = `${__dirname}/../../..`;
-}
+import { OpenApi } from "@samchon/openapi";
+import cp from "child_process";
+import fs from "fs";
+import { VariadicSingleton } from "tstl";
+
+import { FileSystemIterator } from "./FileSystemIterator";
+
+/** @internal */
+export namespace RepositoryFileSystem {
+  export const analyze = async (
+    account: string,
+    project: string,
+  ): Promise<Record<string, string>> => {
+    await vs.get(account, project);
+    return FileSystemIterator.read({
+      root: `${ROOT}/internals/repositories/${account}/${project}/docs/requirements`,
+      extension: "md",
+    });
+  };
+
+  export const prisma = async (
+    account: string,
+    project: string,
+  ): Promise<Record<string, string>> => {
+    await vs.get(account, project);
+    const result: Record<string, string> = await FileSystemIterator.read({
+      root: `${ROOT}/internals/repositories/${account}/${project}/prisma/schema`,
+      extension: "prisma",
+    });
+    for (const [key, value] of Object.entries(result))
+      result[key] = value.split("@author Samchon").join("@author AutoBE");
+    return result;
+  };
+
+  export const src = async (
+    account: string,
+    project: string,
+  ): Promise<Record<string, string>> => {
+    await vs.get(account, project);
+    return FileSystemIterator.read({
+      root: `${ROOT}/internals/repositories/${account}/${project}/src`,
+      prefix: "src/",
+      extension: "ts",
+    });
+  };
+
+  export const swagger = async (
+    account: string,
+    project: string,
+  ): Promise<OpenApi.IDocument> => {
+    await vs.get(account, project);
+    return OpenApi.convert(
+      JSON.parse(
+        await fs.promises.readFile(
+          `${ROOT}/internals/repositories/${account}/${project}/packages/api/swagger.json`,
+          "utf8",
+        ),
+      ),
+    );
+  };
+
+  export const clone = async (
+    account: string,
+    project: string,
+  ): Promise<void> => {
+    await vs.get(account, project);
+  };
+
+  const vs = new VariadicSingleton(
+    async (account: string, project: string): Promise<void> => {
+      const location: string = `${ROOT}/internals/repositories/${account}/${project}`;
+      if (fs.existsSync(location))
+        cp.execSync("git pull", {
+          cwd: location,
+          stdio: "ignore",
+        });
+      else {
+        try {
+          await fs.promises.mkdir(`${ROOT}/internals/repositories/${account}`, {
+            recursive: true,
+          });
+        } catch {}
+        cp.execSync(`git clone https://github.com/${account}/${project}`, {
+          cwd: `${ROOT}/internals/repositories/${account}`,
+          stdio: "ignore",
+        });
+      }
+    },
+  );
+
+  const ROOT = `${__dirname}/../../..`;
+}

package/src/index.ts

@@ -1,2 +1,2 @@
-export * from "./FileSystemIterator";
-export * from "./RepositoryFileSystem";
+export * from "./FileSystemIterator";
+export * from "./RepositoryFileSystem";

package/README.md

@@ -1,212 +0,0 @@
-# AutoBE - No-Code Agent for Backend Applications
-
-<div align="center"> 
-
-```mermaid
-flowchart
-subgraph "Backend Coding Agent"
-  coder("Facade Controller")
-end
-subgraph "Functional Agents"
-  coder --"Requirements Analysis"--> analyze("Analyze")
-  coder --"ERD"--> prisma("Prisma")
-  coder --"API Design"--> interface("Interface")
-  coder --"Test Codes" --> test("Test")
-  coder --"Main Program" --> realize("Realize")
-end
-subgraph "Compiler Feedback"
-  prisma --"validates" --> prismaCompiler("Prisma Compiler")
-  interface --"validates" --> openapiValidator("OpenAPI Validator")
-  interface --"generates" --> tsCompiler("TypeScript Compiler")
-  test --"validates" --> tsCompiler("TypeScript Compiler")
-  realize --"validates" --> tsCompiler("TypeScript Compiler")
-end
-```
-
-[![GitHub License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/wrtnlabs/autobe/blob/master/LICENSE)
-[![NPM Version](https://img.shields.io/npm/v/@autobe/agent.svg)](https://www.npmjs.com/package/@autobe/agent)
-[![NPM Downloads](https://img.shields.io/npm/dm/@autobe/agent.svg)](https://www.npmjs.com/package/@autobe/agent)
-[![Build Status](https://github.com/wrtnlabs/autobe/workflows/build/badge.svg)](https://github.com/wrtnlabs/autobe/actions?query=workflow%3Abuild)
-[![Guide Documents](https://img.shields.io/badge/Guide-Documents-forestgreen)](https://wrtnlabs.io/autobe/docs/)
-[![Discord Badge](https://dcbadge.limes.pink/api/server/https://discord.gg/aMhRmzkqCx?style=flat)](https://discord.gg/aMhRmzkqCx)
-
-[![Fund Raising News](https://wrtnlabs.io/agentica/images/badges/fund-raising-news-202503.svg)](https://www.bloomberg.com/news/videos/2025-03-31/wtrn-on-series-b-funding-growth-strategy-video)
-[![One Mission](https://wrtnlabs.io/agentica/images/badges/open-source-mission.svg)](https://github.com/wrtnlabs)
-
-</div>
-
-An AI-powered no-code agent that builds backend applications, enhanced by compiler feedback.
-
-`@autobe` is a no-code AI agent that analyzes user requirements and automatically generates backend applications using the stack below, following a waterfall development model. Since `@autobe`-generated code is validated by review agents and OpenAPI/TypeScript/Prisma compilers, it delivers 100% working code.
-
-- TypeScript
-- NestJS
-- Prisma (Postgres / SQLite)
-
-## Playground
-
-https://github.com/user-attachments/assets/b995dd2a-23bd-43c9-96cb-96d5c805f19f
-
-[https://stackblitz.com/github/wrtnlabs/autobe-playground-stackblitz](https://stackblitz.com/github/wrtnlabs/autobe-playground-stackblitz?file=md!README.md)
-
-Experience the `@autobe` agent through our interactive playground above.
-
-To see examples of backend applications generated by `@autobe`, explore these interactive demos. These showcase `@autobe`'s ability to generate production-ready backend code with proper structure, API documentation, and TypeScript interfaces. If you're unsure what to try, start with the BBS example script below.
-
-- [BBS (Bulletin Board System)](https://github.com/wrtnlabs/autobe-example-bbs)
-  1. I want to create a political/economic discussion board. Since I'm not familiar with programming, please write a requirements analysis report as you see fit.
-  2. Design the database schema.
-  3. Create the API interface specification.
-  4. Make the e2e test functions.
-- [E-Commerce](https://github.com/wrtnlabs/autobe-example-shopping)
-
-## Documentation Resources
-
-Find comprehensive resources at our [official website](https://wrtnlabs.io/autobe).
-
-### 🏠 Home
-
-- 🙋🏻‍♂️ [Introduction](https://wrtnlabs.io/autobe/docs)
-- 📦 [Setup](https://wrtnlabs.io/autobe/docs/setup)
-- 🔍 Concepts
-  - [Waterfall Model](https://wrtnlabs.io/autobe/docs/concepts/waterfall)
-  - [Compiler Strategy](https://wrtnlabs.io/autobe/docs/concepts/compiler)
-  - [AI Function Calling](https://wrtnlabs.io/autobe/docs/concepts/function-calling)
-
-### 📖 Features
-
-- 🤖 Agent Library
-  - [Facade Controller](https://wrtnlabs.io/autobe/docs/agent/facade)
-  - [Configuration](https://wrtnlabs.io/autobe/docs/agent/config)
-  - [Event Handling](https://wrtnlabs.io/autobe/docs/agent/event)
-  - [Prompt Histories](https://wrtnlabs.io/autobe/docs/agent/history)
-- 📡 WebSocket Protocol
-  - [Remote Procedure Call](https://wrtnlabs.io/autobe/docs/websocket/rpc)
-  - [NestJS Server](https://wrtnlabs.io/autobe/docs/websocket/nestjs)
-  - [NodeJS Server](https://wrtnlabs.io/autobe/docs/websocket/nodejs)
-  - [Client Application](https://wrtnlabs.io/autobe/docs/websocket/client)
-- 🛠️ Backend Stack
-  - [TypeScript](https://wrtnlabs.io/autobe/docs/stack/typescript)
-  - [Prisma ORM](https://wrtnlabs.io/autobe/docs/stack/prisma)
-  - [NestJS Framework](https://wrtnlabs.io/autobe/docs/stack/nestjs)
-
-### 🔗 Appendix
-
-- 🌐 [No-Code Ecosystem](https://wrtnlabs.io/autobe/docs/ecosystem)
-- 📅 Roadmap
-  - [Alpha Release (completed)](https://wrtnlabs.io/autobe/docs/roadmap/alpha)
-  - [Beta Release (in progress)](https://wrtnlabs.io/autobe/docs/roadmap/beta)
-  - [v1.0 Official Release (planned)](https://wrtnlabs.io/autobe/docs/roadmap/v1.0)
-- 🔧 [API Documentation](https://wrtnlabs.io/autobe/api)
-
-## No-Code Ecosystem
-
-![Auto BE - OG Diagram](https://github.com/user-attachments/assets/d7bd7403-dedb-4194-9a21-4c2fb3af18e8)
-
-> A 70-year-old grandmother who grows tomatoes in the countryside created an online debate website in just 10 minutes. Despite being unfamiliar with coding or computers, she built this current affairs and [economics discussion community](https://github.dev/wrtnlabs/autobe-example-bbs) simply by talking with Wrtn's AI. What's remarkable is that users can write posts and comments entirely through voice commands and even engage in current affairs debates with AI.
->
-> The next day, the grandmother spent another 20 minutes launching an [agricultural products shopping mall](https://github.dev/wrtnlabs/autobe-example-shopping). Customers can simply say "I'd like to order 2kg of tomatoes" to complete their purchase, while the grandmother manages everything from orders and shipping to inventory through simple chat conversations.
-
-This is the vision that we, the [WrtnLabs](https://github.com/wrtnlabs) team, are pursuing. We aim to create a world where anyone can build backend servers, AI chatbots, and frontend applications without any coding knowledge—simply by conversing with AI.
-
-To realize this vision, the [WrtnLabs](https://github.com/wrtnlabs) team is developing two additional projects: [`@agentica`](https://github.com/wrtnlabs/agentica) and [`@autoview`](https://github.com/wrtnlabs/autoview).
-
-- **`@agentica`**: Automatically creates AI chatbots when you provide a `swagger.json` file
-- **`@autoview`**: Automatically generates frontend applications when you provide a `swagger.json` file
-
-You're not limited to just creating backends with `@autobe`. Once you've built a no-code backend application through `@autobe`, you can immediately create an AI chatbot and frontend applications alongside it.
-
-Can you converse? Then you're a full-stack developer.
-
-```typescript
-import { Agentica, assertHttpController } from "@agentica/core";
-import OpenAI from "openai";
-import typia from "typia";
-
-import { MobileFileSystem } from "./services/MobileFileSystem";
-
-const agent = new Agentica({
-  vendor: {
-    api: new OpenAI({ apiKey: "********" }),
-    model: "gpt-4o-mini",
-  },
-  controllers: [
-    // functions from TypeScript class
-    typia.llm.controller<MobileFileSystem, "chatgpt">(
-      "filesystem",
-      MobileFileSystem(),
-    ),
-    // functions from Swagger/OpenAPI
-    assertHttpController({
-      name: "shopping",
-      model: "chatgpt",
-      document: await fetch(
-        "https://shopping-be.wrtn.ai/editor/swagger.json",
-      ).then(r => r.json()),
-      connection: {
-        host: "https://shopping-be.wrtn.ai",
-        headers: { Authorization: "Bearer ********" },
-      },
-    }),
-  ],
-});
-await agent.conversate("I wanna buy MacBook Pro");
-```
-
-## Roadmap Schedule
-
-```mermaid
-gantt
-  dateFormat YYYY-MM-DD
-  title AutoBE Roadmap for Beta Release
-
-  section Analyze Agent
-  Debate Enhancement: done,    2025-06-01,  7d
-  Prefix Rule:        done,    2025-06-12,  7d
-  Multimodal:         planned, 2025-07-02, 31d
-
-  section Prisma Agent
-  Compiler Development: done, 2025-06-01, 14d
-  Prohibition Rule:     done, 2025-06-08,  7d
-  SQLite Support:       done, 2025-06-16,  7d
-
-  section Interface Agent
-  Keyworded SDK:  done,    2025-06-01, 10d
-  Authorization:  done,    2025-06-19, 18d
-  Snapshot Logic: planned, 2025-06-23, 14d
-
-  section Test Agent
-  Scenario Agent:       done, 2025-06-01, 10d        
-  Coding Agent:         done, 2025-06-12, 14d
-  Compiler Feedback:    done, 2025-06-12, 14d
-  Function Calling:     done, 2025-06-18, 14d
-  Compiler Development: done, 2025-07-02, 60d
-
-  section Realize Agent
-  Planner Agent:      done,   2025-07-02, 30d
-  Coding Agent:       done,   2025-07-02, 30d
-  Compiler Feedback:  done,   2025-07-17, 15d
-  Function Calling:   done,   2025-07-17, 31d
-  Runtime Validation: active, 2025-08-01, 30d
-
-  section Complementation
-  Benchmark:     done,   2025-06-12, 50d
-  Demonstration: done,   2025-06-16, 14d
-  Documentation: done,   2025-06-16, 45d
-  Articles:      active, 2025-07-02, 61d
-  Review Agent:  active, 2025-07-02, 45d
-  Maintenance:   active, 2025-08-01, 30d
-
-  section Ecosystem
-  Agentica Prerequisite:  active,  2025-06-18, 13d
-  WebSocket Streaming:    planned, 2025-07-02, 14d
-  History Manipulation:   planned, 2025-07-16, 30d
-  AI Chatbot Development: planned, 2025-07-16, 30d
-  Data Seeder Agent:      planned, 2025-08-01, 30d
-```
-
-`@autobe`'s comprehensive three-month beta development roadmap spans from 2025-06-01 through 2025-08-31, marking a critical phase in our journey toward production readiness.
-
-Following the successful completion of our alpha release on 2025-05-31, we have established a robust foundation with fully developed Analysis, Prisma, and Interface Agents. These core components have successfully automated the most complex challenges in backend development: comprehensive requirements analysis, intelligent database architecture, and seamless API design. This achievement represents a significant milestone in our mission to completely automate backend application design.
-
-The upcoming beta phase strategically focuses on delivering and refining the Test Agent and Realization Agent while ensuring system-wide stability and performance optimization across the entire `@autobe` ecosystem. Our ambitious target for 2025-08-31 is to achieve a breakthrough: a 100% reliable No-Code Agent platform that can autonomously handle any backend application development challenge without human intervention.