@adhisang/minecraft-modding-mcp 3.2.0 → 4.1.0

package/dist/storage/files-repo.js

@@ -125,8 +125,6 @@ export class FilesRepo {
     db;
     deleteStmt;
     insertFilesStmt;
-    insertFtsStmt;
-    deleteFtsStmt;
     getContentStmt;
     listStmt;
     listRowsStmt;
@@ -138,17 +136,10 @@ export class FilesRepo {
         this.db = db;
         this.deleteStmt = this.db.prepare(`
       DELETE FROM files WHERE artifact_id = ?
-    `);
-        this.deleteFtsStmt = this.db.prepare(`
-      DELETE FROM files_fts WHERE artifact_id = ?
     `);
         this.insertFilesStmt = this.db.prepare(`
       INSERT INTO files (artifact_id, file_path, content, content_bytes, content_hash)
       VALUES (?, ?, ?, ?, ?)
-    `);
-        this.insertFtsStmt = this.db.prepare(`
-      INSERT INTO files_fts (artifact_id, file_path, content)
-      VALUES (?, ?, ?)
     `);
         this.getContentStmt = this.db.prepare(`
       SELECT artifact_id, file_path, content, content_bytes, content_hash
@@ -187,7 +178,6 @@ export class FilesRepo {
     }
     clearFilesForArtifact(artifactId) {
         this.deleteStmt.run([artifactId]);
-        this.deleteFtsStmt.run([artifactId]);
     }
     insertFilesForArtifact(artifactId, files) {
         for (const file of files) {
@@ -199,7 +189,6 @@ export class FilesRepo {
                 file.contentBytes,
                 contentHash
             ]);
-            this.insertFtsStmt.run([artifactId, file.filePath, file.content]);
         }
     }
     replaceFilesForArtifact(artifactId, files) {

package/dist/storage/migrations.d.ts

@@ -6,6 +6,6 @@ type MigrationRunner = {
     };
     transaction<T>(fn: () => T): () => T;
 };
-export declare const LATEST_SCHEMA_VERSION = 2;
+export declare const LATEST_SCHEMA_VERSION = 4;
 export declare function runMigrations(db: MigrationRunner): number;
 export {};

package/dist/storage/migrations.js

@@ -1,6 +1,6 @@
 import { createError, ERROR_CODES } from "../errors.js";
-import { SCHEMA_V1_STATEMENTS, SCHEMA_V2_STATEMENTS } from "./schema.js";
-export const LATEST_SCHEMA_VERSION = 2;
+import { SCHEMA_V1_STATEMENTS, SCHEMA_V2_STATEMENTS, SCHEMA_V3_STATEMENTS, SCHEMA_V4_STATEMENTS } from "./schema.js";
+export const LATEST_SCHEMA_VERSION = 4;
 const migrations = [
     {
         version: 1,
@@ -9,6 +9,14 @@ const migrations = [
     {
         version: 2,
         statements: SCHEMA_V2_STATEMENTS
+    },
+    {
+        version: 3,
+        statements: SCHEMA_V3_STATEMENTS
+    },
+    {
+        version: 4,
+        statements: SCHEMA_V4_STATEMENTS
     }
 ];
 function selectSchemaVersion(tx) {

package/dist/storage/schema.d.ts

@@ -1,2 +1,4 @@
 export declare const SCHEMA_V1_STATEMENTS: string[];
 export declare const SCHEMA_V2_STATEMENTS: string[];
+export declare const SCHEMA_V4_STATEMENTS: string[];
+export declare const SCHEMA_V3_STATEMENTS: string[];

package/dist/storage/schema.js

@@ -164,4 +164,29 @@ export const SCHEMA_V2_STATEMENTS = [
     `DELETE FROM artifact_index_meta`,
     `DELETE FROM artifacts`
 ];
+export const SCHEMA_V4_STATEMENTS = [
+    `ALTER TABLE artifacts ADD COLUMN alias TEXT`,
+    `CREATE UNIQUE INDEX IF NOT EXISTS idx_artifacts_alias ON artifacts(alias) WHERE alias IS NOT NULL`
+];
+export const SCHEMA_V3_STATEMENTS = [
+    `DROP TABLE IF EXISTS files_fts`,
+    `CREATE VIRTUAL TABLE files_fts USING fts5(
+    artifact_id UNINDEXED,
+    file_path,
+    content,
+    content='files',
+    content_rowid='rowid',
+    tokenize = 'unicode61 separators ''._$'''
+  )`,
+    `CREATE TRIGGER IF NOT EXISTS trg_fts_insert AFTER INSERT ON files BEGIN
+    INSERT INTO files_fts(rowid, artifact_id, file_path, content)
+    VALUES (NEW.rowid, NEW.artifact_id, NEW.file_path, NEW.content);
+  END`,
+    // No UPDATE trigger: FilesRepo uses delete+insert, never updates rows in place.
+    `CREATE TRIGGER IF NOT EXISTS trg_fts_delete BEFORE DELETE ON files BEGIN
+    INSERT INTO files_fts(files_fts, rowid, artifact_id, file_path, content)
+    VALUES ('delete', OLD.rowid, OLD.artifact_id, OLD.file_path, OLD.content);
+  END`,
+    `INSERT INTO files_fts(files_fts) VALUES('rebuild')`
+];
 //# sourceMappingURL=schema.js.map

package/dist/tool-contract-manifest.d.ts

@@ -1,4 +1,4 @@
-export declare const TOOL_SURFACE_SECTION_IDS: readonly ["v3-entry-tools", "source-exploration", "version-comparison-symbol-tracking", "mapping-symbols", "nbt-utilities", "mod-analysis", "validation", "registry-diagnostics"];
+export declare const TOOL_SURFACE_SECTION_IDS: readonly ["v3-entry-tools", "source-exploration", "version-comparison-symbol-tracking", "mapping-symbols", "nbt-utilities", "mod-analysis", "validation", "registry-diagnostics", "batch-lookup"];
 export type ToolSurfaceSectionId = (typeof TOOL_SURFACE_SECTION_IDS)[number];
 export type ToolSurfaceLocale = "en" | "ja";
 export declare function renderToolSurfaceSection(locale: ToolSurfaceLocale, sectionId: ToolSurfaceSectionId): string;

package/dist/tool-contract-manifest.js

@@ -6,7 +6,8 @@ export const TOOL_SURFACE_SECTION_IDS = [
     "nbt-utilities",
     "mod-analysis",
     "validation",
-    "registry-diagnostics"
+    "registry-diagnostics",
+    "batch-lookup"
 ];
 const SECTION_ROWS = {
     "v3-entry-tools": {
@@ -109,14 +110,16 @@ const SECTION_ROWS = {
     },
     "validation": {
         en: [
-            "| `validate-mixin` | Validate Mixin source against a target Minecraft version |",
+            "| `validate-mixin` | Validate Mixin source against a target Minecraft version (returns `validationStatus: \"partial\"` with `targetOutcomes` when a stage budget defers work) |",
             "| `validate-access-widener` | Validate Access Widener content against a target Minecraft version, optionally using runtime-aware Loom artifacts |",
-            "| `validate-access-transformer` | Validate Access Transformer content against a target Minecraft version, optionally using Forge/NeoForge runtime artifacts |"
+            "| `validate-access-transformer` | Validate Access Transformer content against a target Minecraft version, optionally using Forge/NeoForge runtime artifacts |",
+            "| `verify-mixin-target` | Single-call probe for owner / member existence with `@Shadow` / `@Accessor` / `@Invoker` advice |"
         ],
         ja: [
-            "| `validate-mixin` | 対象 Minecraft バージョンに対して Mixin ソースを検証する |",
-            "| `validate-access-widener` | 対象 Minecraft バージョンに対して Access Widener の内容を検証し、必要に応じて Loom runtime artifact も使う |",
-            "| `validate-access-transformer` | 対象 Minecraft バージョンに対して Access Transformer の内容を検証し、必要に応じて Forge / NeoForge runtime artifact も使う |"
+            "| `validate-mixin` | 対象 Minecraft バージョンに対して Mixin ソースを検証する (段階別予算で一部作業を後回しにした場合は `validationStatus: \"partial\"` と `targetOutcomes` を含む) |",
+            "| `validate-access-widener` | 対象 Minecraft バージョンに対して Access Widener の内容を検証し、必要に応じて Loom ランタイムアーティファクトも使う |",
+            "| `validate-access-transformer` | 対象 Minecraft バージョンに対して Access Transformer の内容を検証し、必要に応じて Forge / NeoForge ランタイムアーティファクトも使う |",
+            "| `verify-mixin-target` | owner / member の存在確認と `@Shadow` / `@Accessor` / `@Invoker` 助言を 1 回の確認で返す |"
         ]
     },
     "registry-diagnostics": {
@@ -128,6 +131,20 @@ const SECTION_ROWS = {
             "| `get-registry-data` | 生成済みレジストリスナップショットを読み取り、必要に応じてエントリデータも含める |",
             "| `get-runtime-metrics` | ランタイムメトリクスとレイテンシスナップショットを確認する |"
         ]
+    },
+    "batch-lookup": {
+        en: [
+            "| `batch-class-source` | Read source for many classes against one shared resolved artifact (1..50 entries per call) |",
+            "| `batch-class-members` | List members for many classes against one shared resolved artifact (1..50 entries per call) |",
+            "| `batch-symbol-exists` | Probe symbol existence for many entries against one shared Minecraft-version artifact (workspace / version targets only) |",
+            "| `batch-mappings` | Translate many symbols across mapping namespaces with one shared Minecraft version (no shared artifact) |"
+        ],
+        ja: [
+            "| `batch-class-source` | 共有解決した 1 つのアーティファクトに対して最大 50 件のクラスソースを読み取る |",
+            "| `batch-class-members` | 共有解決した 1 つのアーティファクトに対して最大 50 件のクラスメンバーを列挙する |",
+            "| `batch-symbol-exists` | 共有解決した 1 つの Minecraft バージョンアーティファクトに対して最大 50 件のシンボル存在確認を行う (ワークスペースまたはバージョン対象のみ) |",
+            "| `batch-mappings` | 1 つの Minecraft バージョンで最大 50 件のシンボルを名前空間横断で変換する (共有アーティファクトなし) |"
+        ]
     }
 };
 export function renderToolSurfaceSection(locale, sectionId) {

package/dist/tool-guidance.d.ts

@@ -0,0 +1,82 @@
+import { ZodError } from "zod";
+import { type ExampleCall, type ProblemDetails, type ProblemFieldError, type SuggestedCall } from "./error-mapping.js";
+import type { SourceTargetInput } from "./types.js";
+export type ToolMeta = {
+    requestId: string;
+    tool: string;
+    durationMs: number;
+    warnings: string[];
+    detailApplied?: "summary" | "standard" | "full";
+    includeApplied?: string[];
+    truncated?: Record<string, unknown>;
+    pagination?: Record<string, unknown>;
+    /** Set to `true` on ERR_STAGE_BUDGET_PRE_PARSE error envelopes to signal a budget-driven failure. */
+    stageBudgetExhausted?: boolean;
+    /** Stage budget (ms) that was exceeded; populated alongside `stageBudgetExhausted`. */
+    budgetMs?: number;
+    /** Actual stage elapsed time (ms); populated alongside `stageBudgetExhausted`. */
+    elapsedMs?: number;
+};
+export declare const SUGGESTED_CALL_DEFAULTS: {
+    readonly allowDecompile: true;
+    readonly preferProjectVersion: false;
+    readonly strictVersion: false;
+    readonly mode: "metadata";
+    readonly access: "public";
+    readonly includeSynthetic: false;
+    readonly includeInherited: false;
+    readonly hideUncertain: false;
+    readonly explain: false;
+    readonly preferProjectMapping: false;
+    readonly minSeverity: "all";
+    readonly reportMode: "full";
+    readonly treatInfoAsWarning: true;
+    readonly includeIssues: true;
+};
+export declare function isSuggestedCallDefault(field: keyof typeof SUGGESTED_CALL_DEFAULTS, value: unknown): boolean;
+export declare const ANALYZE_MOD_INCLUDE_GROUPS: readonly ["warnings", "files", "source", "samples", "timings"];
+export declare const ANALYZE_MOD_LEGACY_METADATA_INCLUDES: readonly ["metadata", "entrypoints", "mixins", "dependencies"];
+export declare const VALIDATE_PROJECT_INCLUDE_GROUPS: readonly ["warnings", "issues", "workspace", "recovery"];
+export declare const VALIDATE_PROJECT_LEGACY_WORKSPACE_INCLUDES: readonly ["detectedConfig", "mixins", "accessWideners"];
+export declare const VALIDATION_FALLBACK_HINT = "suggested call payload failed schema validation; using fallback examples";
+export declare function toFieldErrorsFromZod(error: ZodError): ProblemFieldError[];
+export declare function toHints(details: unknown): string[] | undefined;
+export declare function extractValidatedSuggestionAndExamples(details: unknown): {
+    suggestedCall?: SuggestedCall;
+    exampleCalls?: ExampleCall[];
+    primaryDropped: boolean;
+};
+export declare function extractFailedStageFromDetails(details: unknown): string | undefined;
+export declare function extractFieldErrorsFromDetails(details: unknown): ProblemFieldError[] | undefined;
+export declare function asObjectRecord(value: unknown): Record<string, unknown> | undefined;
+export declare function asNonEmptyString(value: unknown): string | undefined;
+export declare function asStringArray(value: unknown): string[] | undefined;
+export declare function truncateSuggestionText(value: string, maxLength?: number): string;
+export declare function parseJsonObjectString(value: string): Record<string, unknown> | undefined;
+export declare function inferTargetKindFromString(value: string): SourceTargetInput["kind"];
+export declare function copySourceLookupSuggestionFields(tool: "get-class-source" | "get-class-members", source: Record<string, unknown>): Record<string, unknown>;
+export declare function copyValidateMixinSharedParams(source: Record<string, unknown>): Record<string, unknown>;
+export declare function buildValidateMixinSuggestedParams(normalizedInput: unknown): Record<string, unknown>;
+export declare function buildResolveArtifactSuggestedParams(normalizedInput: unknown): Record<string, unknown>;
+export declare function buildSourceLookupSuggestedParams(tool: "get-class-source" | "get-class-members", normalizedInput: unknown): Record<string, unknown>;
+export declare function filterAllowedIncludeValues(values: string[] | undefined, allowed: readonly string[]): string[];
+export declare function buildAnalyzeModSuggestedParams(normalizedInput: unknown): Record<string, unknown>;
+export declare function buildValidateProjectSuggestedParams(normalizedInput: unknown): Record<string, unknown>;
+type InvalidInputGuidance = {
+    hints?: string[];
+    suggestedCall?: SuggestedCall;
+    exampleCalls?: ExampleCall[];
+    primaryDropped?: boolean;
+};
+export declare function buildInvalidInputGuidance(tool: string, normalizedInput: unknown): InvalidInputGuidance | undefined;
+export declare function mapErrorToProblem(caughtError: unknown, requestId: string, context?: {
+    tool?: string;
+    normalizedInput?: unknown;
+}): ProblemDetails;
+/**
+ * Copy documented error-only meta fields from AppError.details into the
+ * public envelope. Scoped to `ERR_STAGE_BUDGET_PRE_PARSE` per
+ * docs/tool-reference.md §Meta fields.
+ */
+export declare function applyErrorMetaExtensions(meta: ToolMeta, error: unknown): void;
+export {};