@autobe/filesystem 0.14.0-dev.20250727

package/README.md

@@ -0,0 +1,212 @@
+# 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.

package/lib/FileSystemIterator.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/FileSystemIterator.js

@@ -0,0 +1,60 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemIterator = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const tstl_1 = require("tstl");
+/** @internal */
+var FileSystemIterator;
+(function (FileSystemIterator) {
+    FileSystemIterator.read = (props) => __awaiter(this, void 0, void 0, function* () {
+        const output = {};
+        const iterate = (location) => __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const directory = yield fs_1.default.promises.readdir(location);
+            for (const file of directory) {
+                const next = `${location}/${file}`;
+                const stat = yield fs_1.default.promises.stat(next);
+                if (stat.isDirectory())
+                    yield iterate(next);
+                else if (!((_a = props.extension) === null || _a === void 0 ? void 0 : _a.length) ||
+                    file.endsWith(`.${props.extension}`))
+                    output[`${(_b = props.prefix) !== null && _b !== void 0 ? _b : ""}${next.substring(props.root.length + 1)}`] = yield fs_1.default.promises.readFile(next, "utf-8");
+            }
+        });
+        yield iterate(props.root);
+        return output;
+    });
+    FileSystemIterator.save = (props) => __awaiter(this, void 0, void 0, function* () {
+        if (fs_1.default.existsSync(props.root))
+            yield fs_1.default.promises.rm(props.root, {
+                recursive: true,
+            });
+        const directory = new tstl_1.VariadicSingleton((location) => __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield fs_1.default.promises.mkdir(location, {
+                    recursive: true,
+                });
+            }
+            catch (_a) { }
+        }));
+        for (const [key, value] of Object.entries(props.files)) {
+            const file = path_1.default.resolve(`${props.root}/${key}`);
+            yield directory.get(path_1.default.dirname(file));
+            yield fs_1.default.promises.writeFile(file, value !== null && value !== void 0 ? value : "", "utf8");
+        }
+    });
+})(FileSystemIterator || (exports.FileSystemIterator = FileSystemIterator = {}));
+//# sourceMappingURL=FileSystemIterator.js.map

package/lib/FileSystemIterator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystemIterator.js","sourceRoot":"","sources":["../src/FileSystemIterator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,4CAAoB;AACpB,gDAAwB;AACxB,+BAAyC;AAEzC,gBAAgB;AAChB,IAAiB,kBAAkB,CA+ClC;AA/CD,WAAiB,kBAAkB;IACpB,uBAAI,GAAG,CAAO,KAI1B,EAAmC,EAAE;QACpC,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,CAAO,QAAgB,EAAE,EAAE;;YACzC,MAAM,SAAS,GAAa,MAAM,YAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAChE,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,GAAW,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC;gBAC3C,MAAM,IAAI,GAAa,MAAM,YAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpD,IAAI,IAAI,CAAC,WAAW,EAAE;oBAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;qBACvC,IACH,CAAC,CAAA,MAAA,KAAK,CAAC,SAAS,0CAAE,MAAM,CAAA;oBACxB,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;oBAEpC,MAAM,CACJ,GAAG,MAAA,KAAK,CAAC,MAAM,mCAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAChE,GAAG,MAAM,YAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAClD,CAAC;QACH,CAAC,CAAA,CAAC;QACF,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC,CAAA,CAAC;IAEW,uBAAI,GAAG,CAAO,KAG1B,EAAiB,EAAE;QAClB,IAAI,YAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;YAC3B,MAAM,YAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE;gBAC/B,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;QACL,MAAM,SAAS,GAAG,IAAI,wBAAiB,CAAC,CAAO,QAAgB,EAAE,EAAE;YACjE,IAAI,CAAC;gBACH,MAAM,YAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE;oBAChC,SAAS,EAAE,IAAI;iBAChB,CAAC,CAAC;YACL,CAAC;YAAC,WAAM,CAAC,CAAA,CAAC;QACZ,CAAC,CAAA,CAAC,CAAC;QACH,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACvD,MAAM,IAAI,GAAW,cAAI,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC;YAC1D,MAAM,SAAS,CAAC,GAAG,CAAC,cAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YACxC,MAAM,YAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAA,CAAC;AACJ,CAAC,EA/CgB,kBAAkB,kCAAlB,kBAAkB,QA+ClC"}

package/lib/RepositoryFileSystem.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/RepositoryFileSystem.js

@@ -0,0 +1,78 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RepositoryFileSystem = void 0;
+const openapi_1 = require("@samchon/openapi");
+const child_process_1 = __importDefault(require("child_process"));
+const fs_1 = __importDefault(require("fs"));
+const tstl_1 = require("tstl");
+const FileSystemIterator_1 = require("./FileSystemIterator");
+/** @internal */
+var RepositoryFileSystem;
+(function (RepositoryFileSystem) {
+    RepositoryFileSystem.analyze = (account, project) => __awaiter(this, void 0, void 0, function* () {
+        yield vs.get(account, project);
+        return FileSystemIterator_1.FileSystemIterator.read({
+            root: `${ROOT}/internals/repositories/${account}/${project}/docs/requirements`,
+            extension: "md",
+        });
+    });
+    RepositoryFileSystem.prisma = (account, project) => __awaiter(this, void 0, void 0, function* () {
+        yield vs.get(account, project);
+        const result = yield FileSystemIterator_1.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;
+    });
+    RepositoryFileSystem.src = (account, project) => __awaiter(this, void 0, void 0, function* () {
+        yield vs.get(account, project);
+        return FileSystemIterator_1.FileSystemIterator.read({
+            root: `${ROOT}/internals/repositories/${account}/${project}/src`,
+            prefix: "src/",
+            extension: "ts",
+        });
+    });
+    RepositoryFileSystem.swagger = (account, project) => __awaiter(this, void 0, void 0, function* () {
+        yield vs.get(account, project);
+        return openapi_1.OpenApi.convert(JSON.parse(yield fs_1.default.promises.readFile(`${ROOT}/internals/repositories/${account}/${project}/packages/api/swagger.json`, "utf8")));
+    });
+    RepositoryFileSystem.clone = (account, project) => __awaiter(this, void 0, void 0, function* () {
+        yield vs.get(account, project);
+    });
+    const vs = new tstl_1.VariadicSingleton((account, project) => __awaiter(this, void 0, void 0, function* () {
+        const location = `${ROOT}/internals/repositories/${account}/${project}`;
+        if (fs_1.default.existsSync(location))
+            child_process_1.default.execSync("git pull", {
+                cwd: location,
+                stdio: "ignore",
+            });
+        else {
+            try {
+                yield fs_1.default.promises.mkdir(`${ROOT}/internals/repositories/${account}`, {
+                    recursive: true,
+                });
+            }
+            catch (_a) { }
+            child_process_1.default.execSync(`git clone https://github.com/${account}/${project}`, {
+                cwd: `${ROOT}/internals/repositories/${account}`,
+                stdio: "ignore",
+            });
+        }
+    }));
+    const ROOT = `${__dirname}/../../..`;
+})(RepositoryFileSystem || (exports.RepositoryFileSystem = RepositoryFileSystem = {}));
+//# sourceMappingURL=RepositoryFileSystem.js.map

package/lib/RepositoryFileSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RepositoryFileSystem.js","sourceRoot":"","sources":["../src/RepositoryFileSystem.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

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

package/lib/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./FileSystemIterator"), exports);
+__exportStar(require("./RepositoryFileSystem"), exports);
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,yDAAuC"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "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"
+  }
+}

package/src/FileSystemIterator.ts

@@ -0,0 +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");
+    }
+  };
+}

package/src/RepositoryFileSystem.ts

@@ -0,0 +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}/../../..`;
+}

package/src/index.ts

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