@nt-ai-lab/opencode-skillz 0.4.9 → 0.4.10

package/README.md

@@ -17,6 +17,32 @@ Add the package name to the plugin list:
 
 This is the simplest update path for consumers: declare the plugin once and keep your package pinning strategy up to date.
 
+### Lint mode
+
+`lint.mode` controls the bundled `nt_skillz_lint` tool and its commit gate. It defaults to `"auto"`.
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [
+    [
+      "@nt-ai-lab/opencode-skillz",
+      {
+        "lint": {
+          "mode": "manual"
+        }
+      }
+    ]
+  ]
+}
+```
+
+- `"auto"`: provides the lint tool and requires it before committing changed TypeScript files.
+- `"manual"`: provides the lint tool without the commit requirement.
+- `"disabled"`: does not provide the lint tool or the lint commit requirement.
+
+An unsupported mode prevents the plugin from starting and reports the accepted values.
+
 ### Option B: local typed wrapper plugin file
 
 If a consumer prefers local TypeScript wiring, create a file in `.opencode/plugins/`:

package/dist/git-workflow-gates.d.ts

@@ -18,4 +18,4 @@ export interface GitWorkflowGate {
     recordLintedFiles(filePaths: string[]): void;
 }
 export declare const directPullRequestCreationBlockedMessage: string;
-export declare function createGitWorkflowGate(repositoryRoot: string, commandRunner: CommandRunner): GitWorkflowGate;
+export declare function createGitWorkflowGate(repositoryRoot: string, commandRunner: CommandRunner, requireLintBeforeCommit?: boolean): GitWorkflowGate;

package/dist/git-workflow-gates.js

@@ -49,7 +49,7 @@ function createUnlintedCommitMessage(filePaths) {
         "Then retry the commit.",
     ].join("\n");
 }
-export function createGitWorkflowGate(repositoryRoot, commandRunner) {
+export function createGitWorkflowGate(repositoryRoot, commandRunner, requireLintBeforeCommit = true) {
     const lintedFingerprints = new Map();
     function runGit(commandArguments, description) {
         return normalizeCommandOutput(commandRunner.run("git", commandArguments, repositoryRoot), description);
@@ -73,6 +73,9 @@ export function createGitWorkflowGate(repositoryRoot, commandRunner) {
         return output.split("\n").map((filePath) => filePath.trim()).filter(Boolean);
     }
     function ensureStagedTypeScriptFilesAreLinted() {
+        if (!requireLintBeforeCommit) {
+            return;
+        }
         const stagedFilePaths = readStagedTypeScriptFilePaths();
         const unlintedFilePaths = stagedFilePaths.filter((filePath) => lintedFingerprints.get(filePath) !== readStagedFingerprint(filePath));
         if (unlintedFilePaths.length === 0) {

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-import type { PluginInput } from "./types.js";
-export declare const opencodeSkillzPlugin: (input: PluginInput) => Promise<import("./types.js").PluginHooks>;
+import type { PluginInput, PluginOptions } from "./types.js";
+export declare const opencodeSkillzPlugin: (input: PluginInput, options?: PluginOptions) => Promise<import("./types.js").PluginHooks>;
 export default opencodeSkillzPlugin;

package/dist/index.js

@@ -3,5 +3,5 @@ import { fileURLToPath } from "node:url";
 import { createPluginRegistry } from "./plugin-registry/index.js";
 const currentDirectory = path.dirname(fileURLToPath(import.meta.url));
 const pluginRoot = path.resolve(currentDirectory, "..");
-export const opencodeSkillzPlugin = async (input) => createPluginRegistry(input, pluginRoot);
+export const opencodeSkillzPlugin = async (input, options) => createPluginRegistry(input, pluginRoot, options);
 export default opencodeSkillzPlugin;

package/dist/plugin-registry/index.d.ts

@@ -1,2 +1,3 @@
-import type { PluginHooks, PluginInput } from "../types.js";
-export declare function createPluginRegistry(input: PluginInput, pluginRoot: string): PluginHooks;
+import type { PluginHooks, PluginInput, PluginOptions } from "../types.js";
+export type LintMode = "auto" | "manual" | "disabled";
+export declare function createPluginRegistry(input: PluginInput, pluginRoot: string, options?: PluginOptions): PluginHooks;

package/dist/plugin-registry/index.js

@@ -14,6 +14,21 @@ function readLintedFilePaths(request) {
     }
     return request.files.filter((filePath) => typeof filePath === "string");
 }
+class InvalidLintModeError extends Error {
+    constructor(mode) {
+        super(`Expected lint.mode to be 'auto', 'manual', or 'disabled'. Got ${String(mode)}.`);
+    }
+}
+function resolveLintMode(options) {
+    const mode = options?.lint?.mode;
+    if (mode === undefined) {
+        return "auto";
+    }
+    if (mode === "auto" || mode === "manual" || mode === "disabled") {
+        return mode;
+    }
+    throw new InvalidLintModeError(mode);
+}
 function createGateAwareLintTool(gate) {
     return {
         ...lintTool,
@@ -24,17 +39,21 @@ function createGateAwareLintTool(gate) {
         },
     };
 }
-export function createPluginRegistry(input, pluginRoot) {
+export function createPluginRegistry(input, pluginRoot, options) {
+    const lintMode = resolveLintMode(options);
     const dontStopHooks = createDontStopHooks(input.client);
-    const gitWorkflowGate = createGitWorkflowGate(input.worktree ?? process.cwd(), childProcessCommandRunner);
+    const gitWorkflowGate = createGitWorkflowGate(input.worktree ?? process.cwd(), childProcessCommandRunner, lintMode === "auto");
+    const tools = {
+        nt_skillz_create_pr: createPullRequestTool,
+        [PULL_REQUEST_FEEDBACK_TOOL_NAME]: pullRequestFeedbackTool,
+        [VITEST_COVERAGE_TOOL_NAME]: vitestCoverageTool,
+    };
+    if (lintMode !== "disabled") {
+        tools[LINT_TOOL_NAME] = lintMode === "auto" ? createGateAwareLintTool(gitWorkflowGate) : lintTool;
+    }
     return {
         ...dontStopHooks,
-        tool: {
-            nt_skillz_create_pr: createPullRequestTool,
-            [LINT_TOOL_NAME]: createGateAwareLintTool(gitWorkflowGate),
-            [PULL_REQUEST_FEEDBACK_TOOL_NAME]: pullRequestFeedbackTool,
-            [VITEST_COVERAGE_TOOL_NAME]: vitestCoverageTool,
-        },
+        tool: tools,
         "tool.execute.before": async (hookInput, hookOutput) => {
             gitWorkflowGate.beforeToolExecution(hookInput, hookOutput);
         },

package/dist/types.d.ts

@@ -20,6 +20,11 @@ export interface PluginConfig {
     agent?: Record<string, AgentDefinition>;
     default_agent?: string;
 }
+export interface PluginOptions {
+    lint?: {
+        mode?: unknown;
+    };
+}
 export interface CommandExecuteBeforeInput {
     command: string;
     sessionID: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nt-ai-lab/opencode-skillz",
-  "version": "0.4.9",
+  "version": "0.4.10",
   "description": "Bundled OpenCode commands and agents",
   "repository": {
     "type": "git",