@gyomu/ai-compiler 0.2.4-beta.5

package/dist/pipelines/jsdoc-update/context/TsDocFileContext.d.ts

@@ -0,0 +1,16 @@
+import type { SymbolIdentity } from '@gyomu/schema/schemas/typescript/SymbolIdentity';
+import type { TsDocSymbolContext } from './TsDocSymbolContext.js';
+export interface TsDocFileContext {
+    project: {
+        name: string;
+    };
+    source: {
+        relativePath: string;
+    };
+    symbols: Array<TsDocSymbolContext>;
+    retry?: {
+        attempt: number;
+        missingSymboldentity: Array<SymbolIdentity>;
+    };
+}
+//# sourceMappingURL=TsDocFileContext.d.ts.map

package/dist/pipelines/jsdoc-update/context/TsDocFileContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TsDocFileContext.d.ts","sourceRoot":"","sources":["../../../../src/pipelines/jsdoc-update/context/TsDocFileContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAA;AACrF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;IAED,MAAM,EAAE;QACN,YAAY,EAAE,MAAM,CAAA;KACrB,CAAA;IAED,OAAO,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAA;IAElC,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAA;QACf,oBAAoB,EAAE,KAAK,CAAC,cAAc,CAAC,CAAA;KAC5C,CAAA;CACF"}

package/dist/pipelines/jsdoc-update/context/TsDocFileContext.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TsDocFileContext.js.map

package/dist/pipelines/jsdoc-update/context/TsDocFileContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TsDocFileContext.js","sourceRoot":"","sources":["../../../../src/pipelines/jsdoc-update/context/TsDocFileContext.ts"],"names":[],"mappings":""}

package/dist/pipelines/jsdoc-update/context/TsDocSymbolContext.d.ts

@@ -0,0 +1,164 @@
+import type { SymbolIdentity } from '@gyomu/schema/schemas/typescript/index';
+import type { EffectSignals } from '@gyomu/schema/typescript';
+/**
+ * Defines the base interface for a JSDoc update context containing project metadata and target identification.
+ */
+export interface TsDocSymbolContext {
+    /**
+     * The specific symbol identity targeted for the JSDoc update.
+     */
+    target: SymbolIdentity;
+    /**
+     * The metadata of the targeted symbol.
+     */
+    symbol: {
+        name: string;
+        kind: string;
+    };
+    /**
+     * Container for the code snippet information.
+     */
+    code: {
+        snippet?: string;
+    };
+    /**
+     * Optional existing JSDoc documentation for the target symbol.
+     */
+    existingJsDoc?: ExistingJsDoc;
+    /**
+     * The optional effect type declaration
+     */
+    effectSignals: Pick<EffectSignals, 'success' | 'error' | 'requirements'> | undefined;
+    /**
+     * List of related symbols to be documented.
+     */
+    relatedSymbols: Array<RelatedSymbol>;
+    /**
+     * List of documentable child members.
+     */
+    children?: Array<ContextEntry>;
+    /**
+     * Deep analysis metadata for code refinement.
+     */
+    analysis?: {
+        paramSemantics: Array<{
+            name: string;
+            meaning: string;
+            role: string;
+        }>;
+        protectedRegions: Array<ProtectedSection>;
+        returnSemantics?: string;
+        sideEffects: Array<string>;
+        schemaStructure?: SchemaStructureNode;
+    };
+    /**
+     * Configuration and metrics regarding how the symbol is used.
+     */
+    usageContext?: {
+        publicApi: boolean;
+        usedAcrossModules: boolean;
+        callSites?: number;
+    };
+}
+export type NonDocumentableReason = 'inline-object-member' | 'generated' | 'external' | 'non-documentable-member';
+export type DocumentableInfo = {
+    documentable?: true;
+    reason?: never;
+} | {
+    documentable: false;
+    reason: NonDocumentableReason;
+};
+/**
+ * Represents an entry in the JSDoc update context, defining a target symbol and its associated metadata.
+ */
+export type ContextEntry = {
+    /**
+     * The target symbol identity to be documented.
+     */
+    target: SymbolIdentity;
+    /**
+     * The name of the symbol.
+     */
+    name: string;
+    /**
+     * The category of the symbol.
+     */
+    kind: 'property' | 'method' | 'parameter' | 'type';
+    /**
+     * The optional type definition of the symbol.
+     */
+    type?: string;
+    /**
+     * Existing JSDoc content associated with the symbol, if any.
+     */
+    existingJsDoc?: ExistingJsDoc;
+    /**
+     * The optional effect type declaration
+     */
+    effectSignals: Pick<EffectSignals, 'success' | 'error' | 'requirements'> | undefined;
+    /**
+     * Child entries nested under this symbol.
+     */
+    children?: Array<ContextEntry>;
+} & DocumentableInfo;
+/**
+ * Represents the existing JSDoc documentation structure for a symbol.
+ */
+export interface ExistingJsDoc {
+    /**
+     * The JSDoc summary text, if present.
+     */
+    summary?: string;
+    /**
+     * An array of parameter documentation entries.
+     */
+    params: Array<{
+        name: string;
+        sortOrder: number;
+        type?: string;
+        description?: string;
+    }>;
+    /**
+     * The return value documentation, if present.
+     */
+    returns?: string;
+    /**
+     * An array of additional JSDoc tags.
+     */
+    tags: Array<{
+        tag: string;
+        content: string;
+        sortOrder: number;
+    }>;
+}
+interface RelatedSymbol {
+    name: string;
+    kind: string;
+    signature: string;
+}
+export interface SchemaStructureNode {
+    name: string;
+    kind: 'property' | 'object' | 'array' | 'union' | 'primitive' | 'reference' | 'literal';
+    type?: string;
+    semanticHint?: string;
+    children?: Array<SchemaStructureNode>;
+}
+/**
+ * Represents a section of code or documentation that should be protected from automatic modification.
+ */
+export interface ProtectedSection {
+    /**
+     * The type of section being protected.
+     */
+    kind: 'summary' | 'param' | 'returns' | 'tag';
+    /**
+     * Optional identifier for the section.
+     */
+    key?: string;
+    /**
+     * The reason why the section is protected.
+     */
+    reason: 'preserve-marker' | 'human-edited' | 'custom-content';
+}
+export {};
+//# sourceMappingURL=TsDocSymbolContext.d.ts.map

package/dist/pipelines/jsdoc-update/context/TsDocSymbolContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TsDocSymbolContext.d.ts","sourceRoot":"","sources":["../../../../src/pipelines/jsdoc-update/context/TsDocSymbolContext.ts"],"names":[],"mappings":"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"}

package/dist/pipelines/jsdoc-update/context/TsDocSymbolContext.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TsDocSymbolContext.js.map

package/dist/pipelines/jsdoc-update/context/TsDocSymbolContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TsDocSymbolContext.js","sourceRoot":"","sources":["../../../../src/pipelines/jsdoc-update/context/TsDocSymbolContext.ts"],"names":[],"mappings":""}

package/dist/pipelines/jsdoc-update/executor/__tests__/executeJsDocUpdatePlan.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=executeJsDocUpdatePlan.test.d.ts.map

package/dist/pipelines/jsdoc-update/executor/__tests__/executeJsDocUpdatePlan.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeJsDocUpdatePlan.test.d.ts","sourceRoot":"","sources":["../../../../../src/pipelines/jsdoc-update/executor/__tests__/executeJsDocUpdatePlan.test.ts"],"names":[],"mappings":""}

package/dist/pipelines/jsdoc-update/executor/__tests__/executeJsDocUpdatePlan.test.js

@@ -0,0 +1,47 @@
+import { describe, expect, test } from 'vitest';
+import { Effect, Layer } from 'effect';
+import { NodeFileSystem } from '@effect/platform-node';
+import { AiModelService } from '@gyomu/ai';
+import { executeJsDocUpdatePlan } from '../executeJsDocUpdatePlan.js';
+describe('executeJsDocUpdatePlan', () => {
+    test('returns object from AiModelService', async () => {
+        const expected = [
+            {
+                identity: {
+                    signatureId: '(filePath: string) => string',
+                    symbolId: 'readFile',
+                },
+                summary: {
+                    action: { type: 'replace', value: 'Reads file content' },
+                    confidence: 0.95,
+                },
+                params: [],
+                returns: {
+                    action: { type: 'preserve' },
+                    confidence: 1,
+                },
+                tags: [],
+                reasoning: {
+                    summary: 'Test',
+                    paramMapping: 'Test',
+                    returnMapping: 'Test',
+                },
+                risk: {
+                    hasHumanConflict: false,
+                    riskLevel: 'low',
+                },
+            },
+        ];
+        const mockAiModelService = Layer.succeed(AiModelService, {
+            generateObject: () => Effect.succeed({
+                object: expected,
+            }),
+        });
+        const context = {
+            mode: 'light',
+        };
+        const result = await Effect.runPromise(executeJsDocUpdatePlan(context).pipe(Effect.provide(mockAiModelService), Effect.provide(NodeFileSystem.layer)));
+        expect(result).toEqual(expected);
+    });
+});
+//# sourceMappingURL=executeJsDocUpdatePlan.test.js.map

package/dist/pipelines/jsdoc-update/executor/__tests__/executeJsDocUpdatePlan.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeJsDocUpdatePlan.test.js","sourceRoot":"","sources":["../../../../../src/pipelines/jsdoc-update/executor/__tests__/executeJsDocUpdatePlan.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC/C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AAGrE,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,IAAI,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,QAAQ,GAAoB;YAChC;gBACE,QAAQ,EAAE;oBACR,WAAW,EAAE,8BAA8B;oBAC3C,QAAQ,EAAE,UAAU;iBACrB;gBACD,OAAO,EAAE;oBACP,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,oBAAoB,EAAE;oBACxD,UAAU,EAAE,IAAI;iBACjB;gBACD,MAAM,EAAE,EAAE;gBACV,OAAO,EAAE;oBACP,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;oBAC5B,UAAU,EAAE,CAAC;iBACd;gBACD,IAAI,EAAE,EAAE;gBACR,SAAS,EAAE;oBACT,OAAO,EAAE,MAAM;oBACf,YAAY,EAAE,MAAM;oBACpB,aAAa,EAAE,MAAM;iBACtB;gBACD,IAAI,EAAE;oBACJ,gBAAgB,EAAE,KAAK;oBACvB,SAAS,EAAE,KAAK;iBACjB;aACF;SACF,CAAA;QAED,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE;YACvD,cAAc,EAAE,GAAG,EAAE,CACnB,MAAM,CAAC,OAAO,CAAC;gBACb,MAAM,EAAE,QAAQ;aACjB,CAAC;SACE,CAAC,CAAA;QAET,MAAM,OAAO,GAAG;YACd,IAAI,EAAE,OAAO;SACP,CAAA;QAER,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CACpC,sBAAsB,CAAC,OAAO,CAAC,CAAC,IAAI,CAClC,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAClC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CACrC,CACF,CAAA;QAED,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/pipelines/jsdoc-update/executor/executeJsDocUpdatePlan.d.ts

@@ -0,0 +1,9 @@
+import { Effect } from 'effect';
+import { AiModelService } from '@gyomu/ai';
+import type { AiError, IOError } from '@gyomu/schema';
+import type { RetryOption } from '@gyomu/ai';
+import type { JsDocUpdatePlan } from '../schema/JsDocUpdatePlan.js';
+import type { FileSystem } from 'effect';
+import type { TsDocFileContext } from '../context/TsDocFileContext.js';
+export declare const executeJsDocUpdatePlan: (context: TsDocFileContext, retryOption?: RetryOption) => Effect.Effect<JsDocUpdatePlan, IOError | AiError, AiModelService | FileSystem.FileSystem>;
+//# sourceMappingURL=executeJsDocUpdatePlan.d.ts.map

package/dist/pipelines/jsdoc-update/executor/executeJsDocUpdatePlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeJsDocUpdatePlan.d.ts","sourceRoot":"","sources":["../../../../src/pipelines/jsdoc-update/executor/executeJsDocUpdatePlan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAa,cAAc,EAAE,MAAM,WAAW,CAAA;AAKrD,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEtE,eAAO,MAAM,sBAAsB,GACjC,SAAS,gBAAgB,EACzB,cAAc,WAAW,KACxB,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,OAAO,GAAG,OAAO,EAAE,cAAc,GAAG,UAAU,CAAC,UAAU,CAyB1F,CAAA"}

package/dist/pipelines/jsdoc-update/executor/executeJsDocUpdatePlan.js

@@ -0,0 +1,30 @@
+import { Effect } from 'effect';
+import { AI_MODELS, AiModelService } from '@gyomu/ai';
+import { MessageRole } from '@gyomu/schema/conversation';
+import { withOptional } from '@gyomu/schema';
+import { loadPrompt } from '../prompt/loadPrompt.js';
+import { JsDocUpdatePlanSchema } from '../schema/JsDocUpdatePlan.js';
+export const executeJsDocUpdatePlan = (context, retryOption) => {
+    const promptFilename = `tsdoc-update-base.md`;
+    // const deepPromptFilename = `tsdoc-update-deep.md`
+    return Effect.gen(function* () {
+        const service = yield* AiModelService;
+        const basePrompt = yield* loadPrompt(promptFilename);
+        // const deepPrompt = yield* loadPrompt(deepPromptFilename)
+        const prompt = basePrompt;
+        // if (context.mode === 'deep') {
+        //   prompt += '\n\n' + deepPrompt
+        // }
+        const result = yield* service.generateObject(withOptional({
+            model: AI_MODELS.fast,
+            messages: [
+                { id: '1', role: MessageRole.system, content: prompt },
+                { id: '2', role: MessageRole.user, content: JSON.stringify(context, null, 2) },
+            ],
+            schema: JsDocUpdatePlanSchema,
+            retryOption,
+        }));
+        return result.object;
+    });
+};
+//# sourceMappingURL=executeJsDocUpdatePlan.js.map

package/dist/pipelines/jsdoc-update/executor/executeJsDocUpdatePlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeJsDocUpdatePlan.js","sourceRoot":"","sources":["../../../../src/pipelines/jsdoc-update/executor/executeJsDocUpdatePlan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AAOpE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,OAAyB,EACzB,WAAyB,EACkE,EAAE;IAC7F,MAAM,cAAc,GAAG,sBAAsB,CAAA;IAC7C,oDAAoD;IAEpD,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,cAAc,CAAA;QACrC,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAA;QACpD,2DAA2D;QAC3D,MAAM,MAAM,GAAG,UAAU,CAAA;QACzB,iCAAiC;QACjC,kCAAkC;QAClC,IAAI;QACJ,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,cAAc,CAC1C,YAAY,CAAC;YACX,KAAK,EAAE,SAAS,CAAC,IAAI;YACrB,QAAQ,EAAE;gBACR,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;gBACtD,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;aAC/E;YACD,MAAM,EAAE,qBAAqB;YAC7B,WAAW;SACZ,CAAC,CACH,CAAA;QACD,OAAO,MAAM,CAAC,MAAM,CAAA;IACtB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/dist/pipelines/jsdoc-update/index.d.ts

@@ -0,0 +1,6 @@
+export { TsDocFileContext } from './context/TsDocFileContext.js';
+export { TsDocSymbolContext, ProtectedSection, ExistingJsDoc, ContextEntry, SchemaStructureNode, NonDocumentableReason, DocumentableInfo, } from './context/TsDocSymbolContext.js';
+export * from './mode/index.js';
+export { executeJsDocUpdatePlan } from './executor/executeJsDocUpdatePlan.js';
+export { JsDocUpdatePlan, JsDocUpdateEntryPlan, MergeAction, JsDocTarget, ParamActionValue, ParamMergeAction, } from './schema/JsDocUpdatePlan.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/pipelines/jsdoc-update/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pipelines/jsdoc-update/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAChE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,iCAAiC,CAAA;AACxC,cAAc,iBAAiB,CAAA;AAC/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAA;AAC7E,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,6BAA6B,CAAA"}

package/dist/pipelines/jsdoc-update/index.js

@@ -0,0 +1,3 @@
+export * from './mode/index.js';
+export { executeJsDocUpdatePlan } from './executor/executeJsDocUpdatePlan.js';
+//# sourceMappingURL=index.js.map

package/dist/pipelines/jsdoc-update/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/pipelines/jsdoc-update/index.ts"],"names":[],"mappings":"AAUA,cAAc,iBAAiB,CAAA;AAC/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAA"}

package/dist/pipelines/jsdoc-update/mode/ComplexityStrategy.d.ts

@@ -0,0 +1,6 @@
+import type { ModeContext } from './ModeContext.js';
+export interface ComplexityStrategy {
+    isComplex: (context: ModeContext) => boolean;
+}
+export declare const defaultComplexityStrategy: ComplexityStrategy;
+//# sourceMappingURL=ComplexityStrategy.d.ts.map

package/dist/pipelines/jsdoc-update/mode/ComplexityStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComplexityStrategy.d.ts","sourceRoot":"","sources":["../../../../src/pipelines/jsdoc-update/mode/ComplexityStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAA;CAC7C;AACD,eAAO,MAAM,yBAAyB,EAAE,kBAEvC,CAAA"}

package/dist/pipelines/jsdoc-update/mode/ComplexityStrategy.js

@@ -0,0 +1,4 @@
+export const defaultComplexityStrategy = {
+    isComplex: (context) => context.symbol.complexityScore >= 5,
+};
+//# sourceMappingURL=ComplexityStrategy.js.map

package/dist/pipelines/jsdoc-update/mode/ComplexityStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComplexityStrategy.js","sourceRoot":"","sources":["../../../../src/pipelines/jsdoc-update/mode/ComplexityStrategy.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,yBAAyB,GAAuB;IAC3D,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,IAAI,CAAC;CAC5D,CAAA"}

package/dist/pipelines/jsdoc-update/mode/ModeContext.d.ts

@@ -0,0 +1,15 @@
+export interface ModeContext {
+    file: {
+        defaultMode: 'light' | 'deep';
+        hasGeneratedJsDoc: boolean;
+        stabilityScore: number;
+    };
+    symbol: {
+        exported: boolean;
+        publicApi: boolean;
+        hasJsDoc: boolean;
+        humanEdited: boolean;
+        complexityScore: number;
+    };
+}
+//# sourceMappingURL=ModeContext.d.ts.map

package/dist/pipelines/jsdoc-update/mode/ModeContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModeContext.d.ts","sourceRoot":"","sources":["../../../../src/pipelines/jsdoc-update/mode/ModeContext.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE;QACJ,WAAW,EAAE,OAAO,GAAG,MAAM,CAAA;QAC7B,iBAAiB,EAAE,OAAO,CAAA;QAC1B,cAAc,EAAE,MAAM,CAAA;KACvB,CAAA;IAED,MAAM,EAAE;QACN,QAAQ,EAAE,OAAO,CAAA;QACjB,SAAS,EAAE,OAAO,CAAA;QAClB,QAAQ,EAAE,OAAO,CAAA;QACjB,WAAW,EAAE,OAAO,CAAA;QACpB,eAAe,EAAE,MAAM,CAAA;KACxB,CAAA;CACF"}

package/dist/pipelines/jsdoc-update/mode/ModeContext.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ModeContext.js.map

package/dist/pipelines/jsdoc-update/mode/ModeContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModeContext.js","sourceRoot":"","sources":["../../../../src/pipelines/jsdoc-update/mode/ModeContext.ts"],"names":[],"mappings":""}

package/dist/pipelines/jsdoc-update/mode/index.d.ts

@@ -0,0 +1,4 @@
+export * from './ComplexityStrategy.js';
+export * from './ModeContext.js';
+export * from './modeResolver.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/pipelines/jsdoc-update/mode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/pipelines/jsdoc-update/mode/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAA;AACvC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA"}

package/dist/pipelines/jsdoc-update/mode/index.js

@@ -0,0 +1,4 @@
+export * from './ComplexityStrategy.js';
+export * from './ModeContext.js';
+export * from './modeResolver.js';
+//# sourceMappingURL=index.js.map

package/dist/pipelines/jsdoc-update/mode/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/pipelines/jsdoc-update/mode/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAA;AACvC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA"}

package/dist/pipelines/jsdoc-update/mode/modeResolver.d.ts

@@ -0,0 +1,4 @@
+import type { ComplexityStrategy } from './ComplexityStrategy.js';
+import type { ModeContext } from './ModeContext.js';
+export declare const modeResolver: (context: ModeContext, strategy: ComplexityStrategy) => "light" | "deep";
+//# sourceMappingURL=modeResolver.d.ts.map

package/dist/pipelines/jsdoc-update/mode/modeResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modeResolver.d.ts","sourceRoot":"","sources":["../../../../src/pipelines/jsdoc-update/mode/modeResolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,eAAO,MAAM,YAAY,GACvB,SAAS,WAAW,EACpB,UAAU,kBAAkB,KAC3B,OAAO,GAAG,MAUZ,CAAA"}

package/dist/pipelines/jsdoc-update/mode/modeResolver.js

@@ -0,0 +1,12 @@
+export const modeResolver = (context, strategy) => {
+    if (context.symbol.publicApi)
+        return 'deep';
+    if (context.symbol.humanEdited)
+        return 'deep';
+    if (context.file.defaultMode === 'deep')
+        return 'deep';
+    if (strategy.isComplex(context))
+        return 'deep';
+    return 'light';
+};
+//# sourceMappingURL=modeResolver.js.map

package/dist/pipelines/jsdoc-update/mode/modeResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modeResolver.js","sourceRoot":"","sources":["../../../../src/pipelines/jsdoc-update/mode/modeResolver.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,OAAoB,EACpB,QAA4B,EACV,EAAE;IACpB,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS;QAAE,OAAO,MAAM,CAAA;IAE3C,IAAI,OAAO,CAAC,MAAM,CAAC,WAAW;QAAE,OAAO,MAAM,CAAA;IAE7C,IAAI,OAAO,CAAC,IAAI,CAAC,WAAW,KAAK,MAAM;QAAE,OAAO,MAAM,CAAA;IAEtD,IAAI,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAA;IAE9C,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}

package/dist/pipelines/jsdoc-update/prompt/loadPrompt.d.ts

@@ -0,0 +1,4 @@
+import type { Effect, FileSystem } from 'effect';
+import type { IOError } from '@gyomu/schema';
+export declare const loadPrompt: (name: string) => Effect.Effect<string, IOError, FileSystem.FileSystem>;
+//# sourceMappingURL=loadPrompt.d.ts.map

package/dist/pipelines/jsdoc-update/prompt/loadPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadPrompt.d.ts","sourceRoot":"","sources":["../../../../src/pipelines/jsdoc-update/prompt/loadPrompt.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAI5C,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,UAAU,CAClD,CAAA"}

package/dist/pipelines/jsdoc-update/prompt/loadPrompt.js

@@ -0,0 +1,7 @@
+// prompt/loadPrompt.ts
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { readStringFromFile } from '@gyomu/infra/fs';
+const currentDir = dirname(fileURLToPath(import.meta.url));
+export const loadPrompt = (name) => readStringFromFile(join(currentDir, name));
+//# sourceMappingURL=loadPrompt.js.map

package/dist/pipelines/jsdoc-update/prompt/loadPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadPrompt.js","sourceRoot":"","sources":["../../../../src/pipelines/jsdoc-update/prompt/loadPrompt.ts"],"names":[],"mappings":"AAAA,uBAAuB;AAEvB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAIpD,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AAE1D,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAyD,EAAE,CAChG,kBAAkB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAA"}

package/dist/pipelines/jsdoc-update/prompt/tsdoc-update-base.md

@@ -0,0 +1,174 @@
+---
+name: tsdoc-update-light
+version: 1.0.0
+mode: light
+type: llm-prompt
+target: JsDocUpdatePlan
+---
+
+# System
+
+You are a JSDoc update planner.
+
+Your role is to make minimal and safe updates to existing JSDoc.
+
+You must NOT reinterpret code intent deeply.
+
+You must prefer preserving existing documentation.
+
+You must output an array of JsDocUpdateEntryPlan entries only.
+
+Do not generate full rewritten documentation unless necessary.
+
+---
+
+# Input Schema
+
+- JsDocUpdateContext
+
+---
+
+# Core Principle
+
+Focus on:
+
+- fixing inconsistencies
+- aligning parameter names
+- correcting obvious mismatches
+- preserving human-written content
+
+Do NOT perform semantic redesign.
+
+A single context may produce multiple JsDocUpdatePlan entries.
+
+The target symbol should normally produce one plan entry.
+
+Additional plan entries may be generated for documentable child members.
+
+Each generated plan must be independent and reference its own identity.
+
+Never invent behavior.
+Never infer implementation intent.
+Only describe information explicitly present in the declaration and type structure.
+
+Every exported symbol must have a summary.
+
+If the symbol name is self-explanatory,
+generate a concise summary instead of omitting it.
+
+Do not preserve an empty summary solely because
+the symbol name is descriptive.
+
+---
+
+# Schema Structure
+
+Some symbols may include schemaStructure information.
+
+This information is provided only as semantic context to help understand the shape of the data represented by the symbol.
+
+Use schemaStructure to infer:
+
+- the purpose of the schema
+- the meaning of the represented data
+- relationships between fields
+
+Do NOT generate documentation for schemaStructure entries themselves.
+Do NOT treat schemaStructure nodes as documentation targets.
+Only generate documentation for the current target symbol.
+Do not assume runtime validation behavior unless it is evident
+from the implementation or provided analysis.
+
+When documenting an Effect Schema definition, use the schemaStructure
+to explain the important information represented by the schema.
+
+A high-quality summary should not only identify the schema's purpose,
+but also briefly describe the key categories of data contained within it.
+
+Prefer:
+
+- "Defines a public error response containing an error code, message, and retryability indicator."
+
+Over:
+
+- "Defines a public error schema."
+
+---
+
+# Rules
+
+- summary:
+  - preserve if adequate
+  - create if missing
+  - update only when clearly incorrect
+- params:
+  - preserve existing descriptions
+  - create entries for missing parameters
+  - update only when mismatched
+  - delete parameter documentation only when the parameter no longer exists
+  - Parameter order must match the function signature.
+  - When creating new items, assign order values that produce a stable and deterministic final layout.
+- returns:
+  - preserve existing return descriptions
+  - create a return description if missing and return value is meaningful
+  - update only when clearly incorrect
+  - delete only when the function no longer returns a meaningful value
+  - When creating new items, assign order values that produce a stable and deterministic final layout.
+- tags:
+  - preserve unless invalid
+  - Tag order should preserve the existing documentation order whenever possible.
+- confidence should be high when changes are minimal
+- Reasoning and risk must be evaluated independently for each generated plan entry.
+- delete:
+  - delete only when documentation is clearly invalid or refers to removed code elements
+  - do not delete content solely because it is incomplete or low quality
+  - when uncertain, preserve
+- documentable child members:
+  - Generate an additional JsDocUpdatePlan entry for each documentable child member.
+  - Do not generate entries for non-documentable members.
+  - Each plan must reference its own identity.
+  - Child plans should be generated independently from the parent plan.
+- EffectSignals interpretation:
+  - When requirements are present, describe what external services or context are required.
+  - When error types are present, mention possible failure conditions in documentation when appropriate.
+  - When the symbol returns an Effect, focus on the operation performed rather than describing the implementation as "returns an Effect".
+
+---
+
+# Confidence Guidelines
+
+1.0 = trivial and obvious
+0.8 = highly likely
+0.6 = inferred from context
+0.4 = uncertain
+0.2 = speculative
+
+---
+
+# Output Schema
+
+Must strictly match JsDocUpdateEntryPlan[].
+
+- Never output raw JSDoc text
+- Never expand descriptions aggressively
+- Prefer "preserve" actions
+- If a documented section is missing, prefer action="replace" with generated content instead of "preserve".
+- One plan entry may be generated for the target symbol.
+- Additional plan entries may be generated for documentable child members.
+- Every generated plan must contain a valid identity.
+
+---
+
+# Risk Policy
+
+- Treat human-edited content as authoritative
+- Avoid rewriting stable sections
+- If uncertain → preserve
+
+## Retry
+
+If retry.missingSymboldentity is present:
+
+- Existing documentation may already be generated.
+- Prioritize generating documentation for the listed SymbolIdentity.
+- Ensure all listed symbol identities appear in the output.