@autobe/agent 0.28.0 → 0.29.0

package/lib/orchestrate/analyze/orchestrateAnalyzeReview.js.map

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

package/lib/orchestrate/analyze/orchestrateAnalyzeScenario.js

@@ -47,7 +47,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.orchestrateAnalyzeScenario = void 0;
 const __typia_transform__validateReport = __importStar(require("typia/lib/internal/_validateReport.js"));
-const utils_1 = require("@autobe/utils");
 const typia_1 = __importDefault(require("typia"));
 const uuid_1 = require("uuid");
 const assertSchemaModel_1 = require("../../context/assertSchemaModel");
@@ -58,21 +57,10 @@ const orchestrateAnalyzeScenario = (ctx) => __awaiter(void 0, void 0, void 0, fu
     const pointer = {
         value: null,
     };
-    const { histories, tokenUsage, metric } = yield ctx.conversate({
-        source: "analyzeScenario",
-        controller: createController({
+    const { histories, tokenUsage, metric } = yield ctx.conversate(Object.assign({ source: "analyzeScenario", controller: createController({
             model: ctx.model,
             build: (value) => (pointer.value = value),
-        }),
-        histories: (0, transformAnalyzeScenarioHistories_1.transformAnalyzeSceHistories)(ctx),
-        enforceFunctionCall: false,
-        message: utils_1.StringUtil.trim `
-      Design a complete list of documents and user actors for this project.
-      Define user actors that can authenticate via API and create appropriate documentation files.
-      You must respect the number of documents specified by the user.
-      Note that the user's locale is in ${ctx.locale}.
-    `,
-    });
+        }), enforceFunctionCall: false }, (0, transformAnalyzeScenarioHistories_1.transformAnalyzeSceHistories)(ctx)));
     if (((_a = histories.at(-1)) === null || _a === void 0 ? void 0 : _a.type) === "assistantMessage")
         return Object.assign(Object.assign({}, histories.at(-1)), { created_at: start.toISOString(), completed_at: new Date().toISOString(), id: (0, uuid_1.v7)() });
     else if (pointer.value === null) {
@@ -773,8 +761,9 @@ const collection = {
                             type: "string"
                         },
                         prefix: {
-                            description: "Prefix for file names and variable names. This will be used for\norganizing documentation files.\n\nDO: Use camelCase naming convention.\n\n\n@pattern ^[a-z][a-zA-Z0-9]*$",
-                            type: "string"
+                            description: "Prefix for file names and variable names. This will be used for\norganizing documentation files.\n\nDO: Use camelCase naming convention.",
+                            type: "string",
+                            pattern: "^[a-z][a-zA-Z0-9]*$"
                         },
                         actors: {
                             description: "Actors to be assigned for the project.\n\nEach actor has:\n\n- `name`: Actor identifier (camelCase)\n- `kind`: \"guest\" | \"member\" | \"admin\"\n- `description`: Actor's permissions and capabilities",
@@ -792,11 +781,12 @@ const collection = {
                             type: "number"
                         },
                         files: {
-                            description: "Array of document metadata objects defining files to be generated.\n\nEach array element is an AutoBeAnalyzeFile.Scenario object containing:\n- filename: The output file name (e.g., \"01-service-overview.md\")\n- reason: Why this document is being created\n- documentType, outline, constraints, etc.: Metadata guiding content generation\n\nThese documents represent business-focused planning documentation:\n- Business requirements and functional specifications in natural language\n- User journey mapping and use case scenarios\n- Business rules and workflow definitions\n- Service overview and business model description\n- User actors and permission requirements (described in natural language)\n- Business logic and validation rules\n- DO NOT: Include database schemas, ERD, or API specifications\n- DO: Write all requirements in natural language for clarity\n\nGenerate metadata objects based on actual requirements gathered from conversation.\nDo not create unnecessary documentation - only generate what is needed to\nproperly define the business requirements and system specifications.\n\n# Array Length Rules\n\nThe array length must match the user's requested page count plus one for ToC.\nFor example: user requests 3 pages \u2192 generate 4 objects (1 ToC + 3 content).\nIf user does not specify a number, generate sufficient objects to adequately\ndocument the service (typically 11+ objects including ToC).\n\n\n@minItems 1",
+                            description: "Array of document metadata objects defining files to be generated.\n\nEach array element is an AutoBeAnalyzeFile.Scenario object containing:\n- filename: The output file name (e.g., \"01-service-overview.md\")\n- reason: Why this document is being created\n- documentType, outline, constraints, etc.: Metadata guiding content generation\n\nThese documents represent business-focused planning documentation:\n- Business requirements and functional specifications in natural language\n- User journey mapping and use case scenarios\n- Business rules and workflow definitions\n- Service overview and business model description\n- User actors and permission requirements (described in natural language)\n- Business logic and validation rules\n- DO NOT: Include database schemas, ERD, or API specifications\n- DO: Write all requirements in natural language for clarity\n\nGenerate metadata objects based on actual requirements gathered from conversation.\nDo not create unnecessary documentation - only generate what is needed to\nproperly define the business requirements and system specifications.\n\n# Array Length Rules\n\nThe array length must match the user's requested page count plus one for ToC.\nFor example: user requests 3 pages \u2192 generate 4 objects (1 ToC + 3 content).\nIf user does not specify a number, generate sufficient objects to adequately\ndocument the service (typically 11+ objects including ToC).",
                             type: "array",
                             items: {
                                 $ref: "#/$defs/AutoBeAnalyzeFile.Scenario"
-                            }
+                            },
+                            minItems: 1
                         }
                     },
                     required: [
@@ -813,8 +803,10 @@ const collection = {
                             type: "object",
                             properties: {
                                 name: {
-                                    description: "Unique identifier for the user actor.\n\nThis name will be used as a reference throughout the generated codebase,\nincluding Prisma schema model names, authorization decorator parameters,\nand API documentation.\n\nMUST use camelCase naming convention.\n\n\n@minLength 1\n@pattern ^[a-z][a-zA-Z0-9]*$",
-                                    type: "string"
+                                    description: "Unique identifier for the user actor.\n\nThis name will be used as a reference throughout the generated codebase,\nincluding Prisma schema model names, authorization decorator parameters,\nand API documentation.\n\nMUST use camelCase naming convention.",
+                                    type: "string",
+                                    pattern: "^[a-z][a-zA-Z0-9]*$",
+                                    minLength: 1
                                 },
                                 kind: {
                                     description: "Actor category classification for system-wide permission hierarchy.\n\nThis property categorizes actors into three fundamental permission levels,\nestablishing a clear hierarchy for authorization decisions throughout the\napplication. The kind determines baseline access patterns and security\nboundaries:\n\n- \"guest\": Unauthenticated users or those with minimal permissions. Typically\n  limited to public resources and registration/login endpoints.\n- \"member\": Authenticated users with standard access permissions. Can access\n  personal resources and participate in core application features.\n- \"admin\": System administrators with elevated permissions. Can manage other\n  users, access administrative functions, and modify system-wide settings.",
@@ -844,8 +836,9 @@ const collection = {
                                     type: "string"
                                 },
                                 filename: {
-                                    description: "Filename to generate or overwrite. Should be descriptive and follow a\nconsistent naming convention. Examples: \"01-service-overview.md\",\n\"02-user-requirements.md\", \"03-business-model.md\"\n\n\n@pattern ((.*)\\.md)$",
-                                    type: "string"
+                                    description: "Filename to generate or overwrite. Should be descriptive and follow a\nconsistent naming convention. Examples: \"01-service-overview.md\",\n\"02-user-requirements.md\", \"03-business-model.md\"",
+                                    type: "string",
+                                    pattern: "((.*)\\.md)$"
                                 },
                                 documentType: {
                                     description: "Document type that determines the structure and content guidelines. This\nhelps the AI understand what kind of document to create and what sections\nor information should be included. Examples:\n\n- \"requirement\": Functional/non-functional requirements, acceptance\n  criteria\n- \"user-story\": User personas, scenarios, and journey descriptions\n- \"user-flow\": Step-by-step user interactions and decision points\n- \"business-model\": Revenue streams, cost structure, value propositions\n- \"service-overview\": High-level service description, goals, and scope",

package/lib/orchestrate/analyze/orchestrateAnalyzeScenario.js.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrateAnalyzeScenario.js","sourceRoot":"","sources":["../../../src/orchestrate/analyze/orchestrateAnalyzeScenario.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,yCAA2C;AAG3C,kDAA0B;AAC1B,+BAA0B;AAG1B,uEAAoE;AACpE,qGAA6F;AAGtF,MAAM,0BAA0B,GAAG,CAGxC,GAAyB,EAC4C,EAAE;;IACvE,MAAM,KAAK,GAAS,IAAI,IAAI,EAAE,CAAC;IAC/B,MAAM,OAAO,GAA8D;QACzE,KAAK,EAAE,IAAI;KACZ,CAAC;IACF,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC;QAC7D,MAAM,EAAE,iBAAiB;QACzB,UAAU,EAAE,gBAAgB,CAAQ;YAClC,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;SAC1C,CAAC;QACF,SAAS,EAAE,IAAA,gEAA4B,EAAC,GAAG,CAAC;QAC5C,mBAAmB,EAAE,KAAK;QAC1B,OAAO,EAAE,kBAAU,CAAC,IAAI,CAAA;;;;0CAIc,GAAG,CAAC,MAAM;KAC/C;KACF,CAAC,CAAC;IACH,IAAI,CAAA,MAAA,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,0CAAE,IAAI,MAAK,kBAAkB;QAC/C,OAAO,gCACD,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAsC,KACzD,UAAU,EAAE,KAAK,CAAC,WAAW,EAAE,EAC/B,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EACtC,EAAE,EAAE,IAAA,SAAE,GAAE,GAC+B,CAAC;SACvC,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAChC,cAAc;QACd,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,EAAE,EAAE,IAAA,SAAE,GAAE;QACR,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM;QAC5B,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ;QAChC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM;QAC5B,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK;QAC1B,MAAM;QACN,UAAU;QACV,IAAI,EAAE,CAAC,MAAA,MAAA,GAAG,CAAC,KAAK,EAAE,CAAC,OAAO,0CAAE,IAAI,mCAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QAC3C,UAAU,EAAE,KAAK,CAAC,WAAW,EAAE;KAChC,CAAC;AACJ,CAAC,CAAA,CAAC;AA/CW,QAAA,0BAA0B,8BA+CrC;AAEF,SAAS,gBAAgB,CAAiC,KAGzD;IACC,IAAA,qCAAiB,EAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,WAAW,GAA2B,UAAU,CACpD,KAAK,CAAC,KAAK,KAAK,SAAS;QACvB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ;YACxB,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,QAAQ,CACqD,CAAC;IACtE,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,SAAS;QACf,WAAW;QACX,OAAO,EAAE;YACP,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBACjB,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;SAC0C;KAC9C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,GAAG;IACjB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAGJ;IACH,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAGH;IACH,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAGH;CACJ,CAAC"}
+{"version":3,"file":"orchestrateAnalyzeScenario.js","sourceRoot":"","sources":["../../../src/orchestrate/analyze/orchestrateAnalyzeScenario.ts"],"names":[],"mappings":"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"}

package/lib/orchestrate/analyze/orchestrateAnalyzeWrite.js

@@ -57,17 +57,10 @@ const orchestrateAnalyzeWrite = (ctx, props) => __awaiter(void 0, void 0, void 0
     const pointer = {
         value: null,
     };
-    const { metric, tokenUsage } = yield ctx.conversate({
-        source: "analyzeWrite",
-        controller: createController({
+    const { metric, tokenUsage } = yield ctx.conversate(Object.assign({ source: "analyzeWrite", controller: createController({
             model: ctx.model,
             pointer,
-        }),
-        histories: (0, transformAnalyzeWriteHistories_1.transformAnalyzeWriteHistories)(ctx, props),
-        enforceFunctionCall: true,
-        promptCacheKey,
-        message: "Write requirement analysis report.",
-    });
+        }), enforceFunctionCall: true, promptCacheKey }, (0, transformAnalyzeWriteHistories_1.transformAnalyzeWriteHistories)(ctx, props)));
     if (pointer.value === null)
         throw new Error("The Analyze Agent failed to create the document.");
     const event = {

package/lib/orchestrate/analyze/orchestrateAnalyzeWrite.js.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrateAnalyzeWrite.js","sourceRoot":"","sources":["../../../src/orchestrate/analyze/orchestrateAnalyzeWrite.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,kDAA0B;AAC1B,+BAA0B;AAG1B,uEAAoE;AACpE,+FAA4F;AAGrF,MAAM,uBAAuB,GAAG,CACrC,GAAyB,EACzB,KAKC,EACiC,EAAE;;IACpC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;IACjD,MAAM,OAAO,GAA2D;QACtE,KAAK,EAAE,IAAI;KACZ,CAAC;IACF,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC;QAClD,MAAM,EAAE,cAAc;QACtB,UAAU,EAAE,gBAAgB,CAAQ;YAClC,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,OAAO;SACR,CAAC;QACF,SAAS,EAAE,IAAA,+DAA8B,EAAC,GAAG,EAAE,KAAK,CAAC;QACrD,mBAAmB,EAAE,IAAI;QACzB,cAAc;QACd,OAAO,EAAE,oCAAoC;KAC9C,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI;QACxB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAEtE,MAAM,KAAK,GAA4B;QACrC,IAAI,EAAE,cAAc;QACpB,EAAE,EAAE,IAAA,SAAE,GAAE;QACR,IAAI,kCACC,IAAI,KACP,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,GAC/B;QACD,UAAU;QACV,MAAM;QACN,IAAI,EAAE,CAAC,MAAA,MAAA,GAAG,CAAC,KAAK,EAAE,CAAC,OAAO,0CAAE,IAAI,mCAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QAC3C,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,SAAS,EAAE,EAAE,QAAQ,CAAC,SAAS;QAC/B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,CAAC;IACF,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpB,OAAO,KAAK,CAAC;AACf,CAAC,CAAA,CAAC;AA3CW,QAAA,uBAAuB,2BA2ClC;AAEF,SAAS,gBAAgB,CAAiC,KAGzD;IACC,IAAA,qCAAiB,EAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,WAAW,GAA2B,UAAU,CACpD,KAAK,CAAC,KAAK,KAAK,SAAS;QACvB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ;YACxB,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,QAAQ,CACqD,CAAC;IACtE,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,UAAU;QAChB,WAAW;QACX,OAAO,EAAE;YACP,KAAK,EAAE,CAAO,KAAK,EAAE,EAAE;gBACrB,KAAK,CAAC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;YAC9B,CAAC,CAAA;SACuC;KAC3C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,GAAG;IACjB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAAoE;IAC3E,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAAmE;IACzE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAAmE;CAC1E,CAAC"}
+{"version":3,"file":"orchestrateAnalyzeWrite.js","sourceRoot":"","sources":["../../../src/orchestrate/analyze/orchestrateAnalyzeWrite.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,kDAA0B;AAC1B,+BAA0B;AAG1B,uEAAoE;AACpE,+FAA4F;AAGrF,MAAM,uBAAuB,GAAG,CACrC,GAAyB,EACzB,KAKC,EACiC,EAAE;;IACpC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;IACjD,MAAM,OAAO,GAA2D;QACtE,KAAK,EAAE,IAAI;KACZ,CAAC;IACF,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,GAAG,CAAC,UAAU,iBACjD,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,gBAAgB,CAAQ;YAClC,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,OAAO;SACR,CAAC,EACF,mBAAmB,EAAE,IAAI,EACzB,cAAc,IACX,IAAA,+DAA8B,EAAC,GAAG,EAAE,KAAK,CAAC,EAC7C,CAAC;IACH,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI;QACxB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAEtE,MAAM,KAAK,GAA4B;QACrC,IAAI,EAAE,cAAc;QACpB,EAAE,EAAE,IAAA,SAAE,GAAE;QACR,IAAI,kCACC,IAAI,KACP,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,GAC/B;QACD,UAAU;QACV,MAAM;QACN,IAAI,EAAE,CAAC,MAAA,MAAA,GAAG,CAAC,KAAK,EAAE,CAAC,OAAO,0CAAE,IAAI,mCAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QAC3C,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,SAAS,EAAE,EAAE,QAAQ,CAAC,SAAS;QAC/B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,CAAC;IACF,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpB,OAAO,KAAK,CAAC;AACf,CAAC,CAAA,CAAC;AA1CW,QAAA,uBAAuB,2BA0ClC;AAEF,SAAS,gBAAgB,CAAiC,KAGzD;IACC,IAAA,qCAAiB,EAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,WAAW,GAA2B,UAAU,CACpD,KAAK,CAAC,KAAK,KAAK,SAAS;QACvB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ;YACxB,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,QAAQ,CACqD,CAAC;IACtE,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,UAAU;QAChB,WAAW;QACX,OAAO,EAAE;YACP,KAAK,EAAE,CAAO,KAAK,EAAE,EAAE;gBACrB,KAAK,CAAC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;YAC9B,CAAC,CAAA;SACuC;KAC3C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,GAAG;IACjB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAAoE;IAC3E,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAAmE;IACzE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAAmE;CAC1E,CAAC"}

package/lib/orchestrate/analyze/structures/IAutoBeAnalyzeReviewApplication.d.ts

@@ -1,75 +1,149 @@
+import { IAutoBePreliminaryGetAnalysisFiles } from "../../common/structures/IAutoBePreliminaryGetAnalysisFiles";
 export interface IAutoBeAnalyzeReviewApplication {
     /**
-     * Enhances and finalizes planning documentation.
+     * Process document enhancement task or preliminary data requests.
      *
-     * Receives a draft document and outputs the improved version. The output is
-     * the enhanced document itself, not review comments.
+     * Enhances and finalizes planning documentation by retrieving necessary
+     * analysis files via RAG (Retrieval-Augmented Generation) and producing
+     * improved, complete markdown documents ready for production use.
      *
-     * @param props - Document content, plan, and review criteria
+     * @param props Request containing either preliminary data request or complete
+     *   task
      */
-    review(props: IAutoBeAnalyzeReviewApplication.IProps): void;
+    process(props: IAutoBeAnalyzeReviewApplication.IProps): void;
 }
 export declare namespace IAutoBeAnalyzeReviewApplication {
     interface IProps {
         /**
-         * Step 1 (CoT: Review Phase) - Enhancement Criteria
+         * Think before you act.
          *
-         * The enhancement criteria and guidelines that the agent must follow.
+         * Before requesting preliminary data or completing your task, reflect on your
+         * current state and explain your reasoning:
          *
-         * This includes:
+         * For preliminary requests (getAnalysisFiles, getPrismaSchemas, etc.):
+         * - What critical information is missing that you don't already have?
+         * - Why do you need it specifically right now?
+         * - Be brief - state the gap, don't list everything you have.
          *
-         * - Minimum document length requirements
-         * - Section completeness checks
-         * - Link validation rules
-         * - Mermaid syntax validation (especially parentheses in labels)
-         * - Content specificity requirements
-         * - EARS format compliance
+         * For completion (complete):
+         * - What key assets did you acquire?
+         * - What did you accomplish?
+         * - Why is it sufficient to complete?
+         * - Summarize - don't enumerate every single item.
+         *
+         * This reflection helps you avoid duplicate requests and premature completion.
+         */
+        thinking: string;
+        /**
+         * Type discriminator for the request.
+         *
+         * Determines which action to perform: preliminary data retrieval
+         * (getAnalysisFiles) or final document enhancement (complete). When
+         * preliminary returns empty array, that type is removed from the union,
+         * physically preventing repeated calls.
+         */
+        request: IComplete | IAutoBePreliminaryGetAnalysisFiles;
+    }
+    /**
+     * Request to enhance and finalize planning documentation.
+     *
+     * Executes document enhancement to produce improved, complete markdown
+     * documentation following quality standards and best practices. The output
+     * is the enhanced document itself, not review comments.
+     */
+    interface IComplete {
+        /**
+         * Type discriminator for the request.
+         *
+         * Determines which action to perform: preliminary data retrieval or actual
+         * task execution. Value "complete" indicates this is the final task
+         * execution request.
+         */
+        type: "complete";
+        /**
+         * Enhancement criteria and quality standards.
+         *
+         * Comprehensive guidelines that define document quality requirements and
+         * enhancement strategies. These criteria ensure the final documentation is
+         * implementation-ready and removes all ambiguity for backend developers.
          *
-         * The review criteria ensure that documentation is implementation-ready and
-         * removes all ambiguity for backend developers.
+         * Key enhancement criteria include:
          *
-         * Critical review points:
+         * - Minimum document length requirements for thoroughness
+         * - Section completeness checks ensuring all required topics are covered
+         * - Link validation rules for internal and external references
+         * - Mermaid syntax validation (especially parentheses in labels)
+         * - Content specificity requirements to avoid vague statements
+         * - EARS format compliance for requirements specification
+         * - Natural language business requirement descriptions
+         *
+         * Critical quality standards:
          *
          * - DO: Use double quotes for ALL labels in Mermaid diagrams
-         * - DO NOT: Use spaces between brackets and quotes in Mermaid
+         * - DO NOT: Use spaces between brackets and quotes in Mermaid syntax
          * - DO: Make requirements specific and measurable in natural language
          * - DO: Focus on business requirements and user scenarios
          * - DO NOT: Accept documents containing database schemas or API
          *   specifications
          * - DO: Describe business model and authentication requirements in natural
          *   language
+         * - DO: Expand brief sections with comprehensive business context
+         * - DO: Convert vague statements to EARS format with clear conditions
+         *
+         * The review criteria guide the enhancement process to ensure production-ready
+         * documentation that serves as a solid foundation for subsequent pipeline
+         * phases.
          */
         review: string;
         /**
-         * Step 2 (CoT: Plan Phase) - Original Document Plan
+         * Original document structure plan.
          *
-         * The document plan that was used to create the content.
+         * The document plan that was used to create the initial content draft. This
+         * planning blueprint helps the enhancement agent understand the intended
+         * structure, organization, and coverage expectations.
          *
-         * This helps the reviewer understand:
+         * Understanding from the plan:
          *
-         * - What sections should be present
-         * - The intended structure and organization
-         * - The target audience and purpose
-         * - Expected level of detail
+         * - Required sections and their purposes
+         * - Intended document structure and organization hierarchy
+         * - Target audience and documentation purpose
+         * - Expected level of detail and technical depth
+         * - Content coverage scope and boundaries
          *
-         * The enhancer uses this to ensure the improved content aligns with the
-         * original plan and covers all required topics comprehensively.
+         * The enhancer uses this plan to ensure the improved content aligns with the
+         * original architectural vision while meeting all quality standards and
+         * completeness requirements.
          */
         plan: string;
         /**
-         * Step 3 (CoT: Content Phase) - Document Content (INPUT → OUTPUT)
+         * Enhanced, production-ready markdown document.
+         *
+         * INPUT: The document written by Write Agent (may have quality issues)
+         * OUTPUT: The enhanced, complete markdown document ready for production use
+         *
+         * Enhancement transformation requirements:
          *
-         * INPUT: The document written by Write Agent (may have issues) OUTPUT: The
-         * enhanced, complete markdown document to be saved
+         * - Fix all Mermaid syntax errors (add quotes, fix arrows, proper formatting)
+         * - Convert vague statements to EARS format with specific conditions
+         * - Expand sections that are too brief with comprehensive business context
+         * - Add missing business processes and workflow descriptions
+         * - Ensure all sections meet minimum length requirements
+         * - Validate and correct all internal and external links
+         * - Remove any database schema or API specification details
+         * - Enhance business model descriptions with natural language clarity
+         * - Improve requirements specificity and measurability
          *
-         * Enhancement requirements:
+         * Output characteristics:
          *
-         * - Fix Mermaid syntax errors (add quotes, fix arrows)
-         * - Convert vague statements to EARS format
-         * - Expand sections that are too brief
-         * - Add missing business processes
+         * - Must be the actual enhanced document content (not review comments)
+         * - Must be valid markdown with proper formatting
+         * - Must meet all quality criteria specified in review field
+         * - Must align with the original plan structure
+         * - Must be implementation-ready for subsequent pipeline phases
          *
-         * Output must be the actual document content (not review comments).
+         * The enhanced document serves as the authoritative requirements specification
+         * that will guide all downstream generation phases (Prisma, Interface, Test,
+         * Realize).
          */
         content: string;
     }

package/lib/orchestrate/common/AutoBePreliminaryController.d.ts

@@ -0,0 +1,40 @@
+import { IMicroAgenticaHistoryJson } from "@agentica/core";
+import { AutoBeEventSource, AutoBePreliminaryKind } from "@autobe/interface";
+import { ILlmSchema, IValidation } from "@samchon/openapi";
+import { IJsonSchemaApplication } from "typia";
+import { AutoBeContext } from "../../context/AutoBeContext";
+import { AutoBeState } from "../../context/AutoBeState";
+import { IAutoBePreliminaryRequest } from "./structures/AutoBePreliminaryRequest";
+import { IAutoBeOrchestrateResult } from "./structures/IAutoBeOrchestrateResult";
+import { IAutoBePreliminaryCollection } from "./structures/IAutoBePreliminaryCollection";
+export declare class AutoBePreliminaryController<Kind extends AutoBePreliminaryKind> {
+    private readonly source;
+    private readonly source_id;
+    private readonly kinds;
+    private readonly argumentTypeNames;
+    private readonly all;
+    private readonly local;
+    constructor(props: AutoBePreliminaryController.IProps<Kind>);
+    validate(input: IAutoBePreliminaryRequest<Kind>): IValidation<IAutoBePreliminaryRequest<Kind>>;
+    getHistories(): IMicroAgenticaHistoryJson[];
+    getSource(): Exclude<AutoBeEventSource, "facade" | "preliminary">;
+    getKinds(): Kind[];
+    getArgumentTypeNames(): string[];
+    getAll(): Pick<IAutoBePreliminaryCollection, Kind>;
+    getLocal(): Pick<IAutoBePreliminaryCollection, Kind>;
+    orchestrate<Model extends ILlmSchema.Model, T>(ctx: AutoBeContext<Model>, process: (out: (result: AutoBeContext.IResult<Model>) => (value: T | null) => IAutoBeOrchestrateResult<Model, T>) => Promise<IAutoBeOrchestrateResult<Model, T>>): Promise<T | never>;
+}
+export declare namespace AutoBePreliminaryController {
+    interface IProps<Kind extends AutoBePreliminaryKind> {
+        source: Exclude<AutoBeEventSource, "facade" | "preliminary">;
+        application: IJsonSchemaApplication;
+        kinds: Kind[];
+        state: AutoBeState;
+        all?: Partial<Pick<IAutoBePreliminaryCollection, Kind>>;
+        local?: Partial<Pick<IAutoBePreliminaryCollection, Kind>>;
+    }
+    interface IProcessResult<T> {
+        value: T | undefined;
+        histories: IMicroAgenticaHistoryJson[];
+    }
+}

package/lib/orchestrate/common/AutoBePreliminaryController.js

@@ -0,0 +1,97 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutoBePreliminaryController = void 0;
+const openapi_1 = require("@samchon/openapi");
+const uuid_1 = require("uuid");
+const transformPreliminaryHistory_1 = require("./histories/transformPreliminaryHistory");
+const complementPreliminaryCollection_1 = require("./internal/complementPreliminaryCollection");
+const createPreliminaryCollection_1 = require("./internal/createPreliminaryCollection");
+const validatePreliminary_1 = require("./internal/validatePreliminary");
+const orchestratePreliminary_1 = require("./orchestratePreliminary");
+class AutoBePreliminaryController {
+    constructor(props) {
+        this.source = props.source;
+        this.source_id = (0, uuid_1.v7)();
+        this.kinds = props.kinds;
+        this.argumentTypeNames = (() => {
+            var _a, _b, _c;
+            const func = props.application.functions.find((f) => f.name === "process");
+            if (func === undefined)
+                throw new Error("Unable to find 'process' function in application.");
+            const param = (_a = func.parameters[0]) === null || _a === void 0 ? void 0 : _a.schema;
+            if (param === undefined ||
+                openapi_1.OpenApiTypeChecker.isReference(param) === false)
+                throw new Error("'process' function parameter is not a reference type.");
+            const schema = (_b = props.application.components.schemas) === null || _b === void 0 ? void 0 : _b[param.$ref.split("/").pop()];
+            if (schema === undefined || openapi_1.OpenApiTypeChecker.isObject(schema) === false)
+                throw new Error("'process' function parameter reference is not an object type.");
+            const request = (_c = schema.properties) === null || _c === void 0 ? void 0 : _c.request;
+            if (request === undefined ||
+                openapi_1.OpenApiTypeChecker.isOneOf(request) === false)
+                throw new Error("'process' function parameter.request is not a oneOf type.");
+            else if (request.oneOf.length === 0 ||
+                request.oneOf.every((sch) => openapi_1.OpenApiTypeChecker.isReference(sch) === false))
+                throw new Error("'process' function parameter.request oneOf does not contain any reference type.");
+            return request.oneOf.map((sch) => {
+                const ref = sch.$ref;
+                return ref.split("/").pop();
+            });
+        })();
+        this.all = (0, createPreliminaryCollection_1.createPreliminaryCollection)(props.state, props.all);
+        this.local = (0, createPreliminaryCollection_1.createPreliminaryCollection)(null, props.local);
+        (0, complementPreliminaryCollection_1.complementPreliminaryCollection)({
+            kinds: props.kinds,
+            all: this.all,
+            local: this.local,
+        });
+    }
+    validate(input) {
+        return (0, validatePreliminary_1.validatePreliminary)(this, input);
+    }
+    getHistories() {
+        return (0, transformPreliminaryHistory_1.transformPreliminaryHistory)(this);
+    }
+    getSource() {
+        return this.source;
+    }
+    getKinds() {
+        return this.kinds;
+    }
+    getArgumentTypeNames() {
+        return this.argumentTypeNames;
+    }
+    getAll() {
+        return this.all;
+    }
+    getLocal() {
+        return this.local;
+    }
+    orchestrate(ctx, process) {
+        return __awaiter(this, void 0, void 0, function* () {
+            for (let i = 0; i < 10 /* AutoBeConfigConstant.RAG_LIMIT */; ++i) {
+                const result = yield process((x) => (value) => (Object.assign(Object.assign({}, x), { value })));
+                if (result.value !== null)
+                    return result.value;
+                yield (0, orchestratePreliminary_1.orchestratePreliminary)(ctx, {
+                    source_id: this.source_id,
+                    source: this.source,
+                    preliminary: this,
+                    trial: i + 1,
+                    histories: result.histories,
+                });
+            }
+            throw new Error("Preliminary process exceeded the maximum number of retries.");
+        });
+    }
+}
+exports.AutoBePreliminaryController = AutoBePreliminaryController;
+//# sourceMappingURL=AutoBePreliminaryController.js.map

package/lib/orchestrate/common/AutoBePreliminaryController.js.map

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

package/lib/orchestrate/common/histories/transformCommonCorrectCastingHistory.d.ts

@@ -0,0 +1,8 @@
+import { IAutoBeTypeScriptCompileResult } from "@autobe/interface";
+import { IAutoBeOrchestrateHistory } from "../../../structures/IAutoBeOrchestrateHistory";
+export declare const transformCommonCorrectCastingHistory: (failures: IFailure[]) => IAutoBeOrchestrateHistory;
+interface IFailure {
+    diagnostics: IAutoBeTypeScriptCompileResult.IDiagnostic[];
+    script: string;
+}
+export {};