@skastr0/quartz-opencode-plugin 0.1.0 → 0.2.1

package/README.md

@@ -26,7 +26,7 @@ The bundle is written to `dist/server.js` and exported as `@skastr0/quartz-openc
 
 ## Runtime Behavior
 
-The plugin roots Quartz at the OpenCode workspace directory. It creates one Effect runtime, reuses the analyzer across tool calls, and marks the analyzer cache dirty after file-modifying tools such as `edit`, `write`, or `morph-mcp_edit_file`.
+The plugin roots one persistent native Quartz analyzer at the OpenCode workspace directory and reuses it across tool calls. It marks the analyzer cache dirty from OpenCode's `file.edited` and `file.watcher.updated` events, with tool-hook fallbacks for `apply_patch`, `edit`, `write`, and `morph-mcp_edit_file`. The analyzer is disposed when OpenCode emits `server.instance.disposed` for that workspace directory; deleting a session does not close it.
 
 Use the optional `package` argument when the workspace has multiple discovered TypeScript packages.
 
@@ -58,6 +58,7 @@ Relationships and refactors:
 - `type_why_error`
 - `type_explain`
 - `type_transform_search`
+- `type_verify_contract`
 
 ## Examples
 

package/dist/server.js

@@ -1,13 +1,11 @@
 // @bun
 // src/server.ts
 import { tool } from "@opencode-ai/plugin";
-import { Effect, ManagedRuntime } from "effect";
-import { CoreLayer, TypeAnalyzerService } from "@skastr0/quartz-core";
-var run = (effect) => Effect.runPromise(effect.pipe(Effect.mapError((error) => error instanceof Error ? error : new Error(String(error)))));
+import { createTypeAnalyzer } from "@skastr0/quartz-engine";
 var optionalPackageArg = tool.schema.string().optional().describe("Package/directory to analyze. Omit for root or single-package projects.");
 var limitArg = tool.schema.number().optional().describe("Maximum number of results");
 var json = (value) => JSON.stringify(value, null, 2);
-var FILE_MODIFYING_TOOLS = new Set(["edit", "morph-mcp_edit_file", "write"]);
+var FILE_MODIFYING_TOOLS = new Set(["apply_patch", "edit", "morph-mcp_edit_file", "write"]);
 var packageOption = (packageName) => packageName === undefined ? {} : { packageName };
 var optionalOption = (key, value) => value === undefined ? {} : { [key]: value };
 var createDiscoveryTools = (analyzer) => ({
@@ -15,7 +13,7 @@ var createDiscoveryTools = (analyzer) => ({
     description: "List TypeScript packages discovered from tsconfig.json files.",
     args: {},
     async execute() {
-      return json(await run(analyzer.getPackages()));
+      return json(await analyzer.getPackages());
     }
   }),
   type_symbols: tool({
@@ -27,12 +25,12 @@ var createDiscoveryTools = (analyzer) => ({
       limit: limitArg
     },
     async execute(args) {
-      return json(await run(analyzer.listSymbols({
+      return json(await analyzer.listSymbols({
         ...packageOption(args.package),
         ...optionalOption("pattern", args.pattern),
         ...optionalOption("kind", args.kind),
         ...optionalOption("limit", args.limit)
-      })));
+      }));
     }
   }),
   type_info: tool({
@@ -42,7 +40,7 @@ var createDiscoveryTools = (analyzer) => ({
       package: optionalPackageArg
     },
     async execute(args) {
-      return json(await run(analyzer.getTypeInfo(args.symbol, args.package)));
+      return json(await analyzer.getTypeInfo(args.symbol, args.package));
     }
   }),
   type_expand: tool({
@@ -52,7 +50,7 @@ var createDiscoveryTools = (analyzer) => ({
       package: optionalPackageArg
     },
     async execute(args) {
-      return json(await run(analyzer.expandType(args.symbol, args.package)));
+      return json(await analyzer.expandType(args.symbol, args.package));
     }
   }),
   type_related: tool({
@@ -62,7 +60,7 @@ var createDiscoveryTools = (analyzer) => ({
       package: optionalPackageArg
     },
     async execute(args) {
-      return json(await run(analyzer.findRelated(args.symbol, args.package)));
+      return json(await analyzer.findRelated(args.symbol, args.package));
     }
   }),
   type_search: tool({
@@ -76,14 +74,14 @@ var createDiscoveryTools = (analyzer) => ({
       limit: limitArg
     },
     async execute(args) {
-      return json(await run(analyzer.searchTypes({
+      return json(await analyzer.searchTypes({
         query: args.query,
         ...optionalOption("pattern", args.pattern),
         ...optionalOption("hasProperty", args.hasProperty),
         ...optionalOption("extends", args.extends),
         ...packageOption(args.package),
         ...optionalOption("limit", args.limit)
-      })));
+      }));
     }
   })
 });
@@ -95,7 +93,7 @@ var createAnalysisTools = (analyzer) => ({
       package: optionalPackageArg
     },
     async execute(args) {
-      return json(await run(analyzer.evalType(args.expression, args.package)));
+      return json(await analyzer.evalType(args.expression, args.package));
     }
   }),
   type_diagnostics: tool({
@@ -105,10 +103,10 @@ var createAnalysisTools = (analyzer) => ({
       explain: tool.schema.boolean().optional().describe("Include explanations for diagnostics")
     },
     async execute(args) {
-      return json(await run(analyzer.getDiagnostics({
+      return json(await analyzer.getDiagnostics({
         ...packageOption(args.package),
         ...optionalOption("explain", args.explain)
-      })));
+      }));
     }
   }),
   type_check_snippet: tool({
@@ -118,7 +116,7 @@ var createAnalysisTools = (analyzer) => ({
       package: optionalPackageArg
     },
     async execute(args) {
-      return json(await run(analyzer.checkSnippet(args.code, args.package)));
+      return json(await analyzer.checkSnippet(args.code, args.package));
     }
   }),
   type_at_position: tool({
@@ -130,7 +128,7 @@ var createAnalysisTools = (analyzer) => ({
       package: optionalPackageArg
     },
     async execute(args) {
-      return json(await run(analyzer.getTypeAtPosition(args.file, args.line, args.column, args.package)));
+      return json(await analyzer.getTypeAtPosition(args.file, args.line, args.column, args.package));
     }
   }),
   type_file: tool({
@@ -142,11 +140,11 @@ var createAnalysisTools = (analyzer) => ({
       package: optionalPackageArg
     },
     async execute(args) {
-      return json(await run(analyzer.getFileDeclarations(args.file, {
+      return json(await analyzer.getFileDeclarations(args.file, {
         ...packageOption(args.package),
         ...optionalOption("symbol", args.symbol),
         ...optionalOption("includePrivate", args.includePrivate)
-      })));
+      }));
     }
   }),
   type_refresh: tool({
@@ -155,7 +153,7 @@ var createAnalysisTools = (analyzer) => ({
       package: optionalPackageArg
     },
     async execute(args) {
-      return await run(analyzer.refresh(args.package));
+      return await analyzer.refresh(args.package);
     }
   })
 });
@@ -176,7 +174,7 @@ var createCompatibilityTools = (analyzer) => ({
       package: optionalPackageArg
     },
     async execute(args) {
-      return json(await run(analyzer.checkCompatibility(args.from, args.to, args.package)));
+      return json(await analyzer.checkCompatibility(args.from, args.to, args.package));
     }
   })
 });
@@ -190,11 +188,11 @@ var createGraphTools = (analyzer) => ({
       package: optionalPackageArg
     },
     async execute(args) {
-      return json(await run(analyzer.generateGraph(args.symbol, {
+      return json(await analyzer.generateGraph(args.symbol, {
         ...packageOption(args.package),
         ...optionalOption("depth", args.depth),
         ...optionalOption("format", args.format)
-      })));
+      }));
     }
   })
 });
@@ -207,12 +205,12 @@ var createRefactorTools = (analyzer) => ({
       package: optionalPackageArg
     },
     async execute(args) {
-      return json(await run(analyzer.previewRefactor({
+      return json(await analyzer.previewRefactor({
         action: "rename",
         symbol: args.symbol,
         to: args.to,
         ...packageOption(args.package)
-      })));
+      }));
     }
   })
 });
@@ -227,13 +225,13 @@ var createExplanationTools = (analyzer) => ({
       package: optionalPackageArg
     },
     async execute(args) {
-      return json(await run(analyzer.explainError({
+      return json(await analyzer.explainError({
         ...packageOption(args.package),
         ...optionalOption("code", args.code),
         ...optionalOption("message", args.message),
         ...optionalOption("file", args.file),
         ...optionalOption("line", args.line)
-      })));
+      }));
     }
   }),
   type_explain: tool({
@@ -243,7 +241,7 @@ var createExplanationTools = (analyzer) => ({
       package: optionalPackageArg
     },
     async execute(args) {
-      return json(await run(analyzer.explainType(args.expression, args.package)));
+      return json(await analyzer.explainType(args.expression, args.package));
     }
   })
 });
@@ -266,7 +264,7 @@ var createTransformSearchTools = (analyzer) => ({
       package: optionalPackageArg
     },
     async execute(args) {
-      return await run(analyzer.transformSearch({
+      return json(await analyzer.transformSearch({
         ...packageOption(args.package),
         ...optionalOption("from", args.from),
         ...optionalOption("to", args.to),
@@ -298,7 +296,7 @@ var createVerifyContractTools = (analyzer) => ({
       package: optionalPackageArg
     },
     async execute(args) {
-      return json(await run(analyzer.verifyContract({
+      return json(await analyzer.verifyContract({
         ...packageOption(args.package),
         ...optionalOption("from", args.from),
         ...optionalOption("to", args.to),
@@ -307,7 +305,7 @@ var createVerifyContractTools = (analyzer) => ({
         ...optionalOption("includeDiagnostics", args.includeDiagnostics),
         ...optionalOption("includeTransformEvidence", args.includeTransformEvidence),
         ...optionalOption("transformLimit", args.transformLimit)
-      })));
+      }));
     }
   })
 });
@@ -317,9 +315,34 @@ var createToolDefinitions = (analyzer) => ({
   ...createRelationshipTools(analyzer)
 });
 var QuartzPlugin = async (ctx) => {
-  const runtime = ManagedRuntime.make(CoreLayer(ctx.directory));
-  const analyzer = runtime.runSync(TypeAnalyzerService);
+  const analyzer = await createTypeAnalyzer(ctx.directory, { collectTiming: true });
   const client = ctx.client;
+  let disposePromise = null;
+  const disposeAnalyzer = (reason) => {
+    disposePromise ??= (async () => {
+      try {
+        await analyzer.dispose();
+        await client.app?.log?.({
+          body: {
+            service: "quartz",
+            level: "debug",
+            message: "quartz analyzer disposed",
+            extra: { reason }
+          }
+        });
+      } catch (cause) {
+        await client.app?.log?.({
+          body: {
+            service: "quartz",
+            level: "warn",
+            message: "quartz analyzer dispose failed",
+            extra: { reason, cause: cause instanceof Error ? cause.message : String(cause) }
+          }
+        });
+      }
+    })();
+    return disposePromise;
+  };
   return {
     event: async ({ event }) => {
       if (event.type === "session.idle") {
@@ -328,17 +351,24 @@ var QuartzPlugin = async (ctx) => {
             service: "quartz",
             level: "debug",
             message: "session idle observed by quartz plugin",
-            extra: { sessionID: event.properties.sessionID }
+            extra: { sessionID: event.properties?.sessionID }
           }
         });
       }
+      if (event.type === "file.edited" || event.type === "file.watcher.updated") {
+        await analyzer.markDirty();
+      }
+      if (event.type === "server.instance.disposed" && event.properties.directory === ctx.directory) {
+        await disposeAnalyzer(event.type);
+      }
     },
     "tool.execute.after": async (input) => {
       if (FILE_MODIFYING_TOOLS.has(input.tool)) {
-        await run(analyzer.markDirty());
+        await analyzer.markDirty();
       }
     },
-    tool: createToolDefinitions(analyzer)
+    tool: createToolDefinitions(analyzer),
+    dispose: () => disposeAnalyzer("explicit")
   };
 };
 var server_default = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skastr0/quartz-opencode-plugin",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "type": "module",
   "main": "./dist/server.js",
   "types": "./dist/server.d.ts",
@@ -17,12 +17,11 @@
     "README.md"
   ],
   "scripts": {
-    "build": "rm -rf dist && bun build ./src/server.ts --outdir ./dist --target bun --format esm --external @opencode-ai/plugin --external @skastr0/quartz-core --external effect && tsc -p tsconfig.build.json",
+    "build": "bun ../../scripts/clean-build-output.ts opencode-plugin && bun build ./src/server.ts --outdir ./dist --target bun --format esm --external @opencode-ai/plugin --external @skastr0/quartz-engine && tsc -p tsconfig.build.json",
     "prepack": "bun run build"
   },
   "dependencies": {
-    "@skastr0/quartz-core": "0.1.0",
-    "effect": "^3.21.2"
+    "@skastr0/quartz-engine": "0.2.1"
   },
   "peerDependencies": {
     "@opencode-ai/plugin": ">=1.4.0"