@autobe/agent 0.30.4-dev.20260324 → 0.30.5

package/lib/orchestrate/common/histories/transformPreviousAndLatestCorrectHistory.js

@@ -6,9 +6,12 @@ const uuid_1 = require("uuid");
 const generateTS2339Hints_1 = require("../../realize/utils/generateTS2339Hints");
 const printErrorHints_1 = require("../../realize/utils/printErrorHints");
 const transformPreviousAndLatestCorrectHistory = (array) => {
-    // console.log(printErrorHints(array.at(-1)!.script, array.at(-1)!.diagnostics));
-    return array.map((failure, i) => {
-        const isLatest = i === array.length - 1;
+    // P2-3: Summarize older failures when there are 3+ attempts
+    // Keep last 2 in full, summarize the rest
+    const summarized = summarizeOlderFailures(array);
+    return summarized.map((failure, i) => {
+        var _a, _b;
+        const isLatest = i === summarized.length - 1;
         const ts2339Hints = isLatest
             ? (0, generateTS2339Hints_1.generateTS2339Hints)(failure.diagnostics)
             : "";
@@ -18,53 +21,95 @@ const transformPreviousAndLatestCorrectHistory = (array) => {
             text: utils_1.StringUtil.trim `
         ${isLatest
                 ? "# Latest Failure"
-                : utils_1.StringUtil.trim `
-              # Previous Failure
+                : failure.script === ""
+                    ? utils_1.StringUtil.trim `
+                # Summary of Earlier Failures
 
-              This is the previous failure for your reference.
+                ${(_b = (_a = failure.diagnostics[0]) === null || _a === void 0 ? void 0 : _a.messageText) !== null && _b !== void 0 ? _b : "Multiple earlier correction attempts failed."}
 
-              Never try to fix this previous failure code, but only
-              focus on the latest failure below. This is provided just
-              to give you context about your past mistakes.
+                Focus on the latest failure below and try a DIFFERENT approach.
+              `
+                    : utils_1.StringUtil.trim `
+                # Previous Failure
 
-              If same mistake happens again, you must try to not
-              repeat the same mistake. Change your approach to fix
-              the issue.
-            `}
+                This is the previous failure for your reference.
 
-        ## Original Code
+                Never try to fix this previous failure code, but only
+                focus on the latest failure below. This is provided just
+                to give you context about your past mistakes.
 
-        Here is the previous code you have to review and fix.
+                If same mistake happens again, you must try to not
+                repeat the same mistake. Change your approach to fix
+                the issue.
+              `}
 
-        \`\`\`typescript
-        ${failure.script}
-        \`\`\`
+        ${failure.script !== ""
+                ? utils_1.StringUtil.trim `
+              ## Original Code
 
-        ## Compilation Errors
+              Here is the previous code you have to review and fix.
 
-        Here are the compilation errors found in the code above.
+              \`\`\`typescript
+              ${failure.script}
+              \`\`\`
 
-        \`\`\`json
-        ${JSON.stringify(failure.diagnostics)}
-        \`\`\`
+              ## Compilation Errors
 
-        ## Error Annotated Code
+              Here are the compilation errors found in the code above.
 
-        Here is the error annotated code.
+              \`\`\`json
+              ${JSON.stringify(failure.diagnostics)}
+              \`\`\`
 
-        Please refer to the annotation for the location of the error.
+              ## Error Annotated Code
 
-        By the way, note that, this code is only for reference purpose.
-        Never fix code from this error annotated code. You must fix
-        the original code above.
+              Here is the error annotated code.
 
-        ${(0, printErrorHints_1.printErrorHints)(failure.script, failure.diagnostics)}
+              Please refer to the annotation for the location of the error.
 
-        ${ts2339Hints}
+              By the way, note that, this code is only for reference purpose.
+              Never fix code from this error annotated code. You must fix
+              the original code above.
+
+              ${(0, printErrorHints_1.printErrorHints)(failure.script, failure.diagnostics)}
+
+              ${ts2339Hints}
+            `
+                : ""}
       `,
             created_at: new Date().toISOString(),
         };
     });
 };
 exports.transformPreviousAndLatestCorrectHistory = transformPreviousAndLatestCorrectHistory;
+/**
+ * P2-3: When there are 3+ failure attempts, summarize the older ones to prevent
+ * context bloat. Keep the last 2 in full, collapse the rest into a single
+ * summary entry.
+ */
+const summarizeOlderFailures = (array) => {
+    var _a, _b;
+    if (array.length <= 2)
+        return array;
+    const olderCount = array.length - 2;
+    const olderDiagCount = array
+        .slice(0, -2)
+        .reduce((sum, f) => sum + f.diagnostics.length, 0);
+    const summary = {
+        script: "",
+        diagnostics: [
+            {
+                file: (_b = (_a = array[0].diagnostics[0]) === null || _a === void 0 ? void 0 : _a.file) !== null && _b !== void 0 ? _b : null,
+                start: null,
+                length: null,
+                code: 0,
+                messageText: `[Summary of ${olderCount} previous correction attempts with ` +
+                    `${olderDiagCount} total errors. The same fixes were attempted but ` +
+                    `failed. Focus on the latest diagnostics below and try a DIFFERENT approach.]`,
+                category: "error",
+            },
+        ],
+    };
+    return [summary, ...array.slice(-2)];
+};
 //# sourceMappingURL=transformPreviousAndLatestCorrectHistory.js.map

package/lib/orchestrate/common/histories/transformPreviousAndLatestCorrectHistory.js.map

@@ -1 +1 @@
-{"version":3,"file":"transformPreviousAndLatestCorrectHistory.js","sourceRoot":"","sources":["../../../../src/orchestrate/common/histories/transformPreviousAndLatestCorrectHistory.ts"],"names":[],"mappings":";;;AAEA,yCAA2C;AAC3C,+BAA0B;AAE1B,iFAA8E;AAC9E,yEAAsE;AAE/D,MAAM,wCAAwC,GAAG,CACtD,KAGE,EACwC,EAAE;IAC5C,iFAAiF;IACjF,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE;QAC9B,MAAM,QAAQ,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACxC,MAAM,WAAW,GAAG,QAAQ;YAC1B,CAAC,CAAC,IAAA,yCAAmB,EAAC,OAAO,CAAC,WAAW,CAAC;YAC1C,CAAC,CAAC,EAAE,CAAC;QAEP,OAAO;YACL,EAAE,EAAE,IAAA,SAAE,GAAE;YACR,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,kBAAU,CAAC,IAAI,CAAA;UAEjB,QAAQ;gBACN,CAAC,CAAC,kBAAkB;gBACpB,CAAC,CAAC,kBAAU,CAAC,IAAI,CAAA;;;;;;;;;;;;aAarB;;;;;;;UAOE,OAAO,CAAC,MAAM;;;;;;;;UAQd,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC;;;;;;;;;;;;;UAanC,IAAA,iCAAe,EAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC;;UAEpD,WAAW;OACd;YACD,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AApEW,QAAA,wCAAwC,4CAoEnD"}
+{"version":3,"file":"transformPreviousAndLatestCorrectHistory.js","sourceRoot":"","sources":["../../../../src/orchestrate/common/histories/transformPreviousAndLatestCorrectHistory.ts"],"names":[],"mappings":";;;AAEA,yCAA2C;AAC3C,+BAA0B;AAE1B,iFAA8E;AAC9E,yEAAsE;AAE/D,MAAM,wCAAwC,GAAG,CACtD,KAGE,EACwC,EAAE;IAC5C,4DAA4D;IAC5D,0CAA0C;IAC1C,MAAM,UAAU,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAEjD,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE;;QACnC,MAAM,QAAQ,GAAG,CAAC,KAAK,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QAC7C,MAAM,WAAW,GAAG,QAAQ;YAC1B,CAAC,CAAC,IAAA,yCAAmB,EAAC,OAAO,CAAC,WAAW,CAAC;YAC1C,CAAC,CAAC,EAAE,CAAC;QAEP,OAAO;YACL,EAAE,EAAE,IAAA,SAAE,GAAE;YACR,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,kBAAU,CAAC,IAAI,CAAA;UAEjB,QAAQ;gBACN,CAAC,CAAC,kBAAkB;gBACpB,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,EAAE;oBACrB,CAAC,CAAC,kBAAU,CAAC,IAAI,CAAA;;;kBAGb,MAAA,MAAA,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,0CAAE,WAAW,mCAAI,8CAA8C;;;eAGxF;oBACD,CAAC,CAAC,kBAAU,CAAC,IAAI,CAAA;;;;;;;;;;;;eAavB;;UAGE,OAAO,CAAC,MAAM,KAAK,EAAE;gBACnB,CAAC,CAAC,kBAAU,CAAC,IAAI,CAAA;;;;;;gBAMb,OAAO,CAAC,MAAM;;;;;;;;gBAQd,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC;;;;;;;;;;;;;gBAanC,IAAA,iCAAe,EAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC;;gBAEpD,WAAW;aACd;gBACD,CAAC,CAAC,EACN;OACD;YACD,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AArFW,QAAA,wCAAwC,4CAqFnD;AAEF;;;;GAIG;AACH,MAAM,sBAAsB,GAAG,CAC7B,KAGE,EAID,EAAE;;IACH,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAEpC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACpC,MAAM,cAAc,GAAG,KAAK;SACzB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;SACZ,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAErD,MAAM,OAAO,GAGT;QACF,MAAM,EAAE,EAAE;QACV,WAAW,EAAE;YACX;gBACE,IAAI,EAAE,MAAA,MAAA,KAAK,CAAC,CAAC,CAAE,CAAC,WAAW,CAAC,CAAC,CAAC,0CAAE,IAAI,mCAAI,IAAI;gBAC5C,KAAK,EAAE,IAAI;gBACX,MAAM,EAAE,IAAI;gBACZ,IAAI,EAAE,CAAC;gBACP,WAAW,EACT,eAAe,UAAU,qCAAqC;oBAC9D,GAAG,cAAc,mDAAmD;oBACpE,8EAA8E;gBAChF,QAAQ,EAAE,OAAO;aAClB;SACF;KACF,CAAC;IAEF,OAAO,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC,CAAC"}

package/lib/orchestrate/common/orchestrateCommonCorrectCasting.js

@@ -200,15 +200,15 @@ const createController = (props) => {
                     type: "object",
                     properties: {
                         think: {
-                            description: "Analysis of syntax structure or type system error.\n\nIdentifies error pattern and chosen fix strategy:\n\n- Syntax: Nested declarations, malformed structures\n- Type: Tag incompatibility, nullable narrowing, Date conversions",
+                            description: "Analysis of the error pattern and chosen fix strategy.",
                             type: "string"
                         },
                         draft: {
-                            description: "Draft code with initial syntax/type fixes applied.\n\nAfter first correction round:\n\n- Syntax: Flattened declarations, restructured code\n- Type: Satisfies patterns, Date conversions, nullable checks",
+                            description: "Draft code with initial syntax/type fixes applied.",
                             type: "string"
                         },
                         revise: {
-                            description: "Review and final code with all errors resolved.\n\nReview of applied fixes and final code ready for compilation.",
+                            description: "Self-review pass that checks corrections and produces final code.",
                             $ref: "#/$defs/IAutoBeCommonCorrectCastingApplication.IReviseProps"
                         }
                     },
@@ -223,11 +223,11 @@ const createController = (props) => {
                             type: "object",
                             properties: {
                                 review: {
-                                    description: "Review of syntax/type correction patterns applied.\n\nExplains strategies used and confirms all errors resolved.",
+                                    description: "Review of correction patterns applied and confirmation all errors\nresolved.",
                                     type: "string"
                                 },
                                 final: {
-                                    description: "Final corrected code ready for compilation.\n\nCode with all syntax/type errors fixed. Set to `null` when draft already\nresolves all issues with no further refinements needed.",
+                                    description: "Final corrected code, or `null` when draft already resolves all issues.",
                                     anyOf: [
                                         {
                                             type: "null"
@@ -245,7 +245,7 @@ const createController = (props) => {
                         }
                     }
                 },
-                description: "Rewrite function to fix severe syntax structure errors and type system\nerrors.\n\nCalled when detecting:\n\n- **Severe syntax errors**: Nested declarations in object literals, malformed\n  structures\n- **Type system errors**: Typia tags, Date conversions, nullable narrowing,\n  literal types\n- **Escape sequence errors**: Double backslashes in JSON context",
+                description: "Rewrite code to fix severe syntax structure or type system errors.",
                 validate: (() => { const _io0 = input => "string" === typeof input.think && "string" === typeof input.draft && ("object" === typeof input.revise && null !== input.revise && _io1(input.revise)); const _io1 = input => "string" === typeof input.review && (null === input.final || "string" === typeof input.final); const _vo0 = (input, _path, _exceptionable = true) => ["string" === typeof input.think || _report(_exceptionable, {
                         path: _path + ".think",
                         expected: "string",
@@ -308,7 +308,7 @@ const createController = (props) => {
                     required: [],
                     $defs: {}
                 },
-                description: "Reject function when error is outside scope.\n\nCalled when error is unrelated (imports, undefined variables, business\nlogic). These errors are handled by subsequent agents.",
+                description: "Reject when error is outside scope (handled by subsequent agents).",
                 validate: (() => { const __is = input => true; let errors; let _report; return input => {
                     if (false === __is(input)) {
                         errors = [];

package/lib/orchestrate/common/structures/IAnalysisSectionEntry.d.ts

@@ -1,12 +1,6 @@
 /**
- * A single ### section extracted from an analysis file, enriched with parent
- * hierarchy context and numeric ID for LLM-friendly retrieval.
- *
- * Instead of loading entire analysis files (~110-120KB each), the preliminary
- * system can load individual sections (~200-600 words) identified by sequential
- * integer IDs.
- *
- * @author Juntak
+ * A single ### section extracted from an analysis file, with parent hierarchy
+ * context and numeric ID.
  */
 export interface IAnalysisSectionEntry {
     /**

package/lib/orchestrate/common/structures/IAutoBeCommonCorrectCastingApplication.d.ts

@@ -1,67 +1,25 @@
 export interface IAutoBeCommonCorrectCastingApplication {
-    /**
-     * Rewrite function to fix severe syntax structure errors and type system
-     * errors.
-     *
-     * Called when detecting:
-     *
-     * - **Severe syntax errors**: Nested declarations in object literals, malformed
-     *   structures
-     * - **Type system errors**: Typia tags, Date conversions, nullable narrowing,
-     *   literal types
-     * - **Escape sequence errors**: Double backslashes in JSON context
-     *
-     * @param props The analysis and correction properties
-     */
+    /** Rewrite code to fix severe syntax structure or type system errors. */
     rewrite(props: IAutoBeCommonCorrectCastingApplication.IProps): void;
-    /**
-     * Reject function when error is outside scope.
-     *
-     * Called when error is unrelated (imports, undefined variables, business
-     * logic). These errors are handled by subsequent agents.
-     */
+    /** Reject when error is outside scope (handled by subsequent agents). */
     reject(): void;
 }
 export declare namespace IAutoBeCommonCorrectCastingApplication {
     interface IProps {
-        /**
-         * Analysis of syntax structure or type system error.
-         *
-         * Identifies error pattern and chosen fix strategy:
-         *
-         * - Syntax: Nested declarations, malformed structures
-         * - Type: Tag incompatibility, nullable narrowing, Date conversions
-         */
+        /** Analysis of the error pattern and chosen fix strategy. */
         think: string;
-        /**
-         * Draft code with initial syntax/type fixes applied.
-         *
-         * After first correction round:
-         *
-         * - Syntax: Flattened declarations, restructured code
-         * - Type: Satisfies patterns, Date conversions, nullable checks
-         */
+        /** Draft code with initial syntax/type fixes applied. */
         draft: string;
-        /**
-         * Review and final code with all errors resolved.
-         *
-         * Review of applied fixes and final code ready for compilation.
-         */
+        /** Self-review pass that checks corrections and produces final code. */
         revise: IReviseProps;
     }
     interface IReviseProps {
         /**
-         * Review of syntax/type correction patterns applied.
-         *
-         * Explains strategies used and confirms all errors resolved.
+         * Review of correction patterns applied and confirmation all errors
+         * resolved.
          */
         review: string;
-        /**
-         * Final corrected code ready for compilation.
-         *
-         * Code with all syntax/type errors fixed. Set to `null` when draft already
-         * resolves all issues with no further refinements needed.
-         */
+        /** Final corrected code, or `null` when draft already resolves all issues. */
         final: string | null;
     }
 }

package/lib/orchestrate/common/structures/IAutoBePreliminaryCollection.d.ts

@@ -1,14 +1,6 @@
 import { AutoBeDatabase, AutoBeOpenApi, AutoBeRealizeCollectorFunction, AutoBeRealizeTransformerFunction } from "@autobe/interface";
 import { IAnalysisSectionEntry } from "./IAnalysisSectionEntry";
-/**
- * Complete data collection for preliminary RAG system.
- *
- * Used in both `all` (globally available) and `local` (currently loaded)
- * contexts of `AutoBePreliminaryController`. Contains current iteration data
- * and optional previous iteration data for complement cycles.
- *
- * @author Samchon
- */
+/** Complete data collection for the preliminary RAG system. */
 export interface IAutoBePreliminaryCollection {
     /** Individual ### sections from analysis files for fine-grained retrieval. */
     analysisSections: IAnalysisSectionEntry[];

package/lib/orchestrate/common/structures/IAutoBePreliminaryGetAnalysisSections.d.ts

@@ -1,30 +1,11 @@
 import { tags } from "typia";
-/**
- * Request to retrieve individual analysis sections by numeric ID.
- *
- * Instead of loading entire analysis files (~110-120KB each), this loads
- * specific ### sections (~200-600 words each) identified by integer IDs from
- * the section catalog.
- *
- * @author Juntak
- */
+/** Request to retrieve individual analysis sections by numeric ID. */
 export interface IAutoBePreliminaryGetAnalysisSections {
-    /**
-     * Type discriminator for the request.
-     *
-     * Determines which action to perform: preliminary data retrieval or actual
-     * task execution. Value "getAnalysisSections" indicates this is a preliminary
-     * data request for individual analysis sections.
-     */
+    /** Type discriminator. */
     type: "getAnalysisSections";
     /**
-     * List of section IDs to retrieve.
-     *
-     * These are sequential integer IDs from the analysis sections catalog. Each
-     * ID maps to a specific ### section in the requirements documents.
-     *
-     * CRITICAL: DO NOT request the same section IDs that you have already
-     * requested in previous calls.
+     * Section IDs to retrieve. DO NOT request same IDs already requested in
+     * previous calls.
      */
     sectionIds: (number & tags.Type<"uint32">)[] & tags.MinItems<1> & tags.MaxItems<100>;
 }

package/lib/orchestrate/common/structures/IAutoBePreliminaryGetDatabaseSchemas.d.ts

@@ -1,28 +1,10 @@
 import { tags } from "typia";
-/**
- * Request to retrieve database schema definitions for context.
- *
- * This type is used in the preliminary phase to request specific database table
- * schemas needed for generating type-safe API operations.
- *
- * @author Samchon
- */
+/** Request to retrieve database schema definitions for context. */
 export interface IAutoBePreliminaryGetDatabaseSchemas {
-    /**
-     * Type discriminator for the request.
-     *
-     * Determines which action to perform: preliminary data retrieval or actual
-     * task execution. Value "getDatabaseSchemas" indicates this is a preliminary
-     * data request for database schemas.
-     */
+    /** Type discriminator. */
     type: "getDatabaseSchemas";
     /**
-     * List of database table names to retrieve.
-     *
-     * Table names from the database schema representing database entities (e.g.,
-     * "user", "post", "comment").
-     *
-     * CRITICAL: DO NOT request the same schema names that you have already
+     * Database table names to retrieve. DO NOT request same names already
      * requested in previous calls.
      */
     schemaNames: string[] & tags.MinItems<1>;

package/lib/orchestrate/common/structures/IAutoBePreliminaryGetInterfaceOperations.d.ts

@@ -1,30 +1,12 @@
 import { AutoBeOpenApi } from "@autobe/interface";
 import { tags } from "typia";
-/**
- * Request to retrieve existing interface operations for context.
- *
- * This type is used in the preliminary phase to request already-generated API
- * operations for review, validation, or complementary generation tasks.
- *
- * @author Samchon
- */
+/** Request to retrieve existing interface operations for context. */
 export interface IAutoBePreliminaryGetInterfaceOperations {
-    /**
-     * Type discriminator for the request.
-     *
-     * Determines which action to perform: preliminary data retrieval or actual
-     * task execution. Value "getInterfaceOperations" indicates this is a
-     * preliminary data request for interface operations.
-     */
+    /** Type discriminator. */
     type: "getInterfaceOperations";
     /**
-     * List of existing API operation endpoints to retrieve.
-     *
-     * Operations that have been generated in previous phases, containing paths,
-     * methods, parameters, and request/response bodies.
-     *
-     * CRITICAL: DO NOT request the same endpoints that you have already requested
-     * in previous calls.
+     * API operation endpoints to retrieve. DO NOT request same endpoints already
+     * requested in previous calls.
      */
     endpoints: AutoBeOpenApi.IEndpoint[] & tags.MinItems<1>;
 }

package/lib/orchestrate/common/structures/IAutoBePreliminaryGetInterfaceSchemas.d.ts

@@ -1,29 +1,11 @@
 import { tags } from "typia";
-/**
- * Request to retrieve OpenAPI schema type definitions for context.
- *
- * This type is used in the preliminary phase to request specific schema
- * definitions from components.schemas for review or complementary generation.
- *
- * @author Samchon
- */
+/** Request to retrieve OpenAPI schema type definitions for context. */
 export interface IAutoBePreliminaryGetInterfaceSchemas {
-    /**
-     * Type discriminator for the request.
-     *
-     * Determines which action to perform: preliminary data retrieval or actual
-     * task execution. Value "getInterfaceSchemas" indicates this is a preliminary
-     * data request for interface schemas.
-     */
+    /** Type discriminator. */
     type: "getInterfaceSchemas";
     /**
-     * List of schema type names to retrieve.
-     *
-     * Schema names from the OpenAPI components.schemas section (e.g., "IUser",
-     * "IUser.ICreate", "IPost.IUpdate").
-     *
-     * CRITICAL: DO NOT request the same type names that you have already
-     * requested in previous calls.
+     * Schema type names to retrieve. DO NOT request same names already requested
+     * in previous calls.
      */
     typeNames: string[] & tags.MinItems<1>;
 }

package/lib/orchestrate/common/structures/IAutoBePreliminaryGetPreviousAnalysisSections.d.ts

@@ -1,26 +1,14 @@
 import { tags } from "typia";
 /**
- * Request to retrieve individual analysis sections from previous iteration by
- * numeric ID.
- *
- * Same as {@link IAutoBePreliminaryGetAnalysisSections} but for sections from
- * the previous generation cycle, enabling comparison and consistency checks.
- *
- * @author Juntak
+ * Request to retrieve analysis sections from the previous iteration by numeric
+ * ID.
  */
 export interface IAutoBePreliminaryGetPreviousAnalysisSections {
-    /**
-     * Type discriminator for the request.
-     *
-     * Value "getPreviousAnalysisSections" indicates this is a preliminary data
-     * request for analysis sections from the previous iteration.
-     */
+    /** Type discriminator. */
     type: "getPreviousAnalysisSections";
     /**
-     * List of section IDs to retrieve from the previous iteration.
-     *
-     * CRITICAL: DO NOT request the same section IDs that you have already
-     * requested in previous calls.
+     * Section IDs to retrieve from previous iteration. DO NOT request same IDs
+     * already requested in previous calls.
      */
     sectionIds: (number & tags.Type<"uint32">)[] & tags.MinItems<1>;
 }

package/lib/orchestrate/common/structures/IAutoBePreliminaryGetPreviousDatabaseSchemas.d.ts

@@ -1,86 +1,17 @@
 import { tags } from "typia";
 /**
- * Request to retrieve database schemas from a previous version.
+ * Request to retrieve database schemas from the previous iteration.
  *
- * This type is used to load database schema definitions that were generated in
- * a **previous version** of the AutoBE generation pipeline. This is NOT about
- * re-requesting schemas within the same execution, but rather accessing
- * artifacts from an earlier version.
- *
- * **Use Case:** When regenerating or modifying the database schema based on
- * user change requests, agents need to reference the previously generated
- * database schemas to understand the existing database structure and what needs
- * to be modified.
- *
- * **Key Difference from `getDatabaseSchemas`:**
- *
- * - `getDatabaseSchemas`: Fetches schemas from the **current version** (the
- *   version being generated right now)
- * - `getPreviousDatabaseSchemas`: Fetches schemas from the **previous version**
- *   (the last successfully generated version)
- *
- * **Example Scenario:**
- *
- *     Initial generation:
- *     - DATABASE phase creates: users, posts, comments tables
- *     - Generation completes successfully
- *
- *     User: "Add email verification status to users"
- *
- *     Regeneration:
- *     - DATABASE phase starts regeneration
- *     - Calls getPreviousDatabaseSchemas(["users"])
- *       → Loads the previous version of users table schema
- *     - Creates new version with emailVerified field added
- *
- * **Waterfall + Spiral Pattern:**
- *
- * This aligns with AutoBE's regeneration cycles where:
- *
- * - Compilation failures trigger regeneration with corrections
- * - User modifications trigger new versions
- * - Previous schemas serve as reference for incremental changes
- *
- * @author Samchon
+ * Loads database table definitions from the last successfully generated
+ * version, used as reference context during regeneration or modification
+ * cycles.
  */
 export interface IAutoBePreliminaryGetPreviousDatabaseSchemas {
-    /**
-     * Type discriminator for the request.
-     *
-     * Determines which action to perform: preliminary data retrieval or actual
-     * task execution. Value "getPreviousDatabaseSchemas" indicates this is a
-     * preliminary data request for database schemas from a previous version.
-     */
+    /** Type discriminator. */
     type: "getPreviousDatabaseSchemas";
     /**
-     * List of database table names to retrieve from the previous version.
-     *
-     * These are table schema names that were generated in a previous version and
-     * are needed as reference context for the current regeneration.
-     *
-     * **Important Notes:**
-     *
-     * - These schemas MUST exist in the previous version
-     * - This function is only available when a previous version exists
-     * - Used for reference/comparison, not for re-requesting within same execution
-     * - Table names are in snake_case (e.g., "shopping_sale", "bbs_article")
-     *
-     * **When This Function is Available:**
-     *
-     * - When a previous version exists
-     * - When user requests modifications to existing database schema
-     * - During correction/regeneration cycles that need previous schema context
-     *
-     * **When This Function is NOT Available:**
-     *
-     * - During initial generation (no previous version exists)
-     * - No previous database schemas available for this orchestration task
-     *
-     * **Example Table Names:**
-     *
-     * - "users", "posts", "comments"
-     * - "shopping_sales", "shopping_orders", "shopping_products"
-     * - "bbs_articles", "bbs_article_files"
+     * Table names to retrieve from previous iteration. DO NOT request same names
+     * already requested in previous calls.
      */
     schemaNames: string[] & tags.MinItems<1>;
 }