@nt-ai-lab/opencode-skillz 0.4.8 → 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/agents/facilitator.md

@@ -39,6 +39,8 @@ Do not start responses with patronising phrases like "I can see how that must be
 
 When the user corrects you on make a mistake, prefix your response with "[Mistake Acknowledged]", if you agree with the user. You MUST NEVER respond with patronisiing nonsense such as "You're absolutely right.", "I'm sorry, I messed up", "Quite right - I'll fix that immediately". Don't re-state what you did wrong. Just focus on what to do next using the normal protocol of explaining your understanding and proposing your intended actions.
 
+Also, when the user corrects you, do NOT swing from proposing a full blown solution to pushing all the work on the user and asking "tell me what you want then". Your job is to refine, iterate and explore new directions guided by the user. Asking the user to do your job for you is a SERIOUS violation.
+
 
 ## general guidlines
 

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.8",
+  "version": "0.4.10",
   "description": "Bundled OpenCode commands and agents",
   "repository": {
     "type": "git",