@mc1global/opencode-jarvis 0.13.0 → 0.14.0

package/dist/tools/workspace-registry-tools.d.ts

@@ -1,93 +1,25 @@
+/**
+ * Workspace Registry Tools
+ *
+ * OpenCode tool definitions for workspace registration and management.
+ * These tools allow agents to discover, register, and manage workspaces
+ * in the project ecosystem, as well as track inter-workspace dependencies.
+ *
+ * Tools (3):
+ *   workspace-info   — Get detailed information about a workspace
+ *   workspace-list   — List all registered workspaces with optional filtering
+ *   workspace-update — Update workspace metadata, status, dependencies
+ *
+ * SOLID: SRP - workspace tool exposure only
+ * SOLID: DIP - depends on use case abstractions
+ */
 import type { WorkspaceRegistryUseCases } from "../application/workspace-registry/use-cases.js";
+import type { ToolDefinition } from "@opencode-ai/plugin";
 export interface WorkspaceRegistryToolsDeps {
     readonly workspaceRegistryUseCases: WorkspaceRegistryUseCases;
 }
-export declare function createWorkspaceRegistryTools(deps: WorkspaceRegistryToolsDeps): {
-    "workspace-info": {
-        description: string;
-        args: {
-            identifier: import("zod").ZodString;
-            by_directory: import("zod").ZodOptional<import("zod").ZodBoolean>;
-        };
-        execute(args: {
-            identifier: string;
-            by_directory?: boolean | undefined;
-        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
-    };
-    "workspace-list": {
-        description: string;
-        args: {
-            status: import("zod").ZodOptional<import("zod").ZodEnum<{
-                active: "active";
-                template: "template";
-                archived: "archived";
-            }>>;
-        };
-        execute(args: {
-            status?: "active" | "template" | "archived" | undefined;
-        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
-    };
-    "workspace-update": {
-        description: string;
-        args: {
-            id: import("zod").ZodString;
-            description: import("zod").ZodOptional<import("zod").ZodString>;
-            primary_language: import("zod").ZodOptional<import("zod").ZodString>;
-            tech_stack: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-            add_tech: import("zod").ZodOptional<import("zod").ZodString>;
-            remove_tech: import("zod").ZodOptional<import("zod").ZodString>;
-            status: import("zod").ZodOptional<import("zod").ZodEnum<{
-                active: "active";
-                template: "template";
-                archived: "archived";
-            }>>;
-            set_metadata_key: import("zod").ZodOptional<import("zod").ZodString>;
-            set_metadata_value: import("zod").ZodOptional<import("zod").ZodString>;
-            remove_metadata_key: import("zod").ZodOptional<import("zod").ZodString>;
-        };
-        execute(args: {
-            id: string;
-            description?: string | undefined;
-            primary_language?: string | undefined;
-            tech_stack?: string[] | undefined;
-            add_tech?: string | undefined;
-            remove_tech?: string | undefined;
-            status?: "active" | "template" | "archived" | undefined;
-            set_metadata_key?: string | undefined;
-            set_metadata_value?: string | undefined;
-            remove_metadata_key?: string | undefined;
-        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
-    };
-    "workspace-link": {
-        description: string;
-        args: {
-            action: import("zod").ZodEnum<{
-                add: "add";
-                remove: "remove";
-                list: "list";
-            }>;
-            source_id: import("zod").ZodOptional<import("zod").ZodString>;
-            target_id: import("zod").ZodOptional<import("zod").ZodString>;
-            dependency_type: import("zod").ZodOptional<import("zod").ZodEnum<{
-                other: "other";
-                "api-consumer": "api-consumer";
-                "api-provider": "api-provider";
-                "shared-lib": "shared-lib";
-                "monorepo-package": "monorepo-package";
-                "data-source": "data-source";
-                "deployment-target": "deployment-target";
-            }>>;
-            description: import("zod").ZodOptional<import("zod").ZodString>;
-            workspace_id: import("zod").ZodOptional<import("zod").ZodString>;
-        };
-        execute(args: {
-            action: "add" | "remove" | "list";
-            source_id?: string | undefined;
-            target_id?: string | undefined;
-            dependency_type?: "other" | "api-consumer" | "api-provider" | "shared-lib" | "monorepo-package" | "data-source" | "deployment-target" | undefined;
-            description?: string | undefined;
-            workspace_id?: string | undefined;
-        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
-    };
-};
+/**
+ * Creates workspace registry tools for managing the workspace ecosystem.
+ */
+export declare function createWorkspaceRegistryTools(deps: WorkspaceRegistryToolsDeps): Record<string, ToolDefinition>;
 //# sourceMappingURL=workspace-registry-tools.d.ts.map

package/dist/tools/workspace-registry-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-registry-tools.d.ts","sourceRoot":"","sources":["../../src/tools/workspace-registry-tools.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAMhG,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,yBAAyB,EAAE,yBAAyB,CAAC;CAC/D;AAID,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmO5E"}
+{"version":3,"file":"workspace-registry-tools.d.ts","sourceRoot":"","sources":["../../src/tools/workspace-registry-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAYhG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAK1D,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,yBAAyB,EAAE,yBAAyB,CAAC;CAC/D;AAgBD;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,0BAA0B,GAC/B,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAwMhC"}

package/dist/tools/workspace-registry-tools.js

@@ -1,119 +1,124 @@
 /**
  * Workspace Registry Tools
  *
- * OpenCode tool definitions for the workspace registry bounded context.
- * Manages cross-project workspace registration, metadata, and dependencies.
+ * OpenCode tool definitions for workspace registration and management.
+ * These tools allow agents to discover, register, and manage workspaces
+ * in the project ecosystem, as well as track inter-workspace dependencies.
  *
- * Tools defined (4):
- *   workspace-info   - Get detailed info about a registered workspace
- *   workspace-list   - List all registered workspaces
- *   workspace-update - Update workspace metadata (language, tech stack, etc.)
- *   workspace-link   - Manage cross-workspace dependencies
+ * Tools (3):
+ *   workspace-info   — Get detailed information about a workspace
+ *   workspace-list   — List all registered workspaces with optional filtering
+ *   workspace-update — Update workspace metadata, status, dependencies
  *
- * SOLID: SRP — workspace registry tool exposure only
- * SOLID: DIP — depends on use case abstractions
+ * SOLID: SRP - workspace tool exposure only
+ * SOLID: DIP - depends on use case abstractions
  */
+import { WORKSPACE_STATUS_VALUES, DEPENDENCY_TYPE_VALUES, WORKSPACE_LINK_ACTION_VALUES, } from "../domain/workspace-registry/enum-values.js";
 import { tool } from "@opencode-ai/plugin";
 const z = tool.schema;
+// ── Result Formatting ─────────────────────────────────────────────────
+function formatResult(result, formatter) {
+    if (!result.success) {
+        return `ERROR: ${result.error}`;
+    }
+    return formatter(result.data);
+}
 // ── Tool Factory ──────────────────────────────────────────────────────
+/**
+ * Creates workspace registry tools for managing the workspace ecosystem.
+ */
 export function createWorkspaceRegistryTools(deps) {
     const { workspaceRegistryUseCases } = deps;
-    // ── workspace-info ────────────────────────────────────────────────
+    // ── workspace-info ──────────────────────────────────────────────
     const workspaceInfo = tool({
-        description: "Get detailed information about a registered workspace. " +
-            "Look up by workspace ID (e.g. 'MY-APP') or by directory path. " +
-            "Shows metadata, tech stack, dependencies, and dependents.",
+        description: "Get detailed information about a specific workspace by ID or directory path. " +
+            "Returns workspace metadata, tech stack, dependencies, and a formatted summary.",
         args: {
             identifier: z
                 .string()
-                .describe("Workspace ID (e.g. 'MY-APP') or absolute directory path"),
+                .describe("Workspace ID (e.g., 'api-service') or directory path"),
             by_directory: z
                 .boolean()
                 .optional()
-                .describe("Set true to look up by directory path instead of ID"),
+                .describe("Set to true if identifier is a directory path (default: false)"),
         },
         async execute(args) {
             const result = await workspaceRegistryUseCases.getInfo({
                 identifier: args.identifier,
                 byDirectory: args.by_directory ?? false,
             });
-            if (!result.success) {
-                return `ERROR: ${result.error}`;
-            }
-            return result.data.summary;
+            return formatResult(result, (info) => info.summary);
         },
     });
-    // ── workspace-list ────────────────────────────────────────────────
+    // ── workspace-list ──────────────────────────────────────────────
     const workspaceList = tool({
-        description: "List all registered workspaces in the JARVIS registry. " +
-            "Optionally filter by status (active, archived, template). " +
-            "Shows workspace ID, name, directory, status, and language.",
+        description: "List all registered workspaces in the ecosystem. " +
+            "Optionally filter by status (active, archived, template).",
         args: {
             status: z
-                .enum(["active", "archived", "template"])
+                .enum(WORKSPACE_STATUS_VALUES)
                 .optional()
-                .describe("Filter by workspace status"),
+                .describe("Filter workspaces by status"),
         },
         async execute(args) {
             const result = await workspaceRegistryUseCases.list({
                 ...(args.status !== undefined ? { status: args.status } : {}),
             });
-            if (!result.success) {
-                return `ERROR: ${result.error}`;
-            }
-            const { workspaces, total } = result.data;
-            if (total === 0) {
-                const filter = args.status !== undefined ? ` with status "${args.status}"` : "";
-                return `No workspaces registered${filter}.`;
-            }
-            const lines = [`Registered Workspaces (${total}):`, ""];
-            for (const ws of workspaces) {
-                lines.push(`  ${ws.id} | ${ws.name} | ${ws.status} | ${ws.primaryLanguage} | ${ws.directory}`);
-            }
-            return lines.join("\n");
+            return formatResult(result, (data) => {
+                if (data.total === 0)
+                    return "No workspaces found.";
+                const lines = [`Workspaces (${data.total}):`];
+                for (const ws of data.workspaces) {
+                    lines.push(`  ${ws.id}: ${ws.name} [${ws.primaryLanguage}] (${ws.status})`);
+                    lines.push(`    Directory: ${ws.directory}`);
+                }
+                return lines.join("\n");
+            });
         },
     });
-    // ── workspace-update ──────────────────────────────────────────────
+    // ── workspace-update ────────────────────────────────────────────
     const workspaceUpdate = tool({
-        description: "Update workspace metadata in the JARVIS registry. " +
-            "Can update description, primary language, tech stack, or status. " +
-            "Multiple fields can be updated in a single call.",
+        description: "Update workspace metadata, status, tech stack, or dependencies. " +
+            "Supports multiple update operations: description, language, tech stack, " +
+            "status changes, metadata key-value pairs, and dependency links.",
         args: {
-            id: z.string().describe("Workspace ID to update (e.g. 'MY-APP')"),
-            description: z.string().optional().describe("New project description"),
+            id: z.string().describe("Workspace ID to update"),
+            description: z
+                .string()
+                .optional()
+                .describe("New description text"),
             primary_language: z
                 .string()
                 .optional()
-                .describe("Primary programming language (e.g. 'typescript', 'python')"),
+                .describe("Primary programming language (e.g., 'typescript', 'python')"),
             tech_stack: z
                 .array(z.string())
                 .optional()
-                .describe("Replace entire tech stack with this list"),
+                .describe("Complete tech stack array (replaces existing)"),
             add_tech: z
                 .string()
                 .optional()
-                .describe("Add a single technology to the tech stack"),
+                .describe("Add a single technology to the stack"),
             remove_tech: z
                 .string()
                 .optional()
-                .describe("Remove a single technology from the tech stack"),
+                .describe("Remove a single technology from the stack"),
             status: z
-                .enum(["active", "archived", "template"])
+                .enum(WORKSPACE_STATUS_VALUES)
                 .optional()
                 .describe("Change workspace status"),
             set_metadata_key: z
                 .string()
                 .optional()
-                .describe("Set a metadata key (use with set_metadata_value). " +
-                "Example keys: llm.analysisProviderID, llm.analysisModelID"),
+                .describe("Metadata key to set"),
             set_metadata_value: z
                 .string()
                 .optional()
-                .describe("Value for set_metadata_key"),
+                .describe("Metadata value (required if set_metadata_key is provided)"),
             remove_metadata_key: z
                 .string()
                 .optional()
-                .describe("Remove a metadata key"),
+                .describe("Metadata key to remove"),
         },
         async execute(args) {
             const result = await workspaceRegistryUseCases.update({
@@ -124,9 +129,7 @@ export function createWorkspaceRegistryTools(deps) {
                 ...(args.primary_language !== undefined
                     ? { primaryLanguage: args.primary_language }
                     : {}),
-                ...(args.tech_stack !== undefined
-                    ? { techStack: args.tech_stack }
-                    : {}),
+                ...(args.tech_stack !== undefined ? { techStack: args.tech_stack } : {}),
                 ...(args.add_tech !== undefined ? { addTech: args.add_tech } : {}),
                 ...(args.remove_tech !== undefined
                     ? { removeTech: args.remove_tech }
@@ -142,21 +145,24 @@ export function createWorkspaceRegistryTools(deps) {
                     ? { removeMetadataKey: args.remove_metadata_key }
                     : {}),
             });
-            if (!result.success) {
-                return `ERROR: ${result.error}`;
-            }
-            return `${result.data.message}\n\n${result.data.summary}`;
+            return formatResult(result, (data) => {
+                const lines = [data.message];
+                if (data.summary) {
+                    lines.push("", data.summary);
+                }
+                return lines.join("\n");
+            });
         },
     });
-    // ── workspace-link ────────────────────────────────────────────────
+    // ── workspace-link ──────────────────────────────────────────────
     const workspaceLink = tool({
-        description: "Manage cross-workspace dependencies in the JARVIS registry. " +
-            "Actions: 'add' (create dependency), 'remove' (delete dependency), " +
-            "'list' (show all dependencies for a workspace). " +
-            "Dependency types: api-consumer, api-provider, shared-lib, " +
-            "monorepo-package, data-source, deployment-target, other.",
+        description: "Manage workspace dependencies. Add, remove, or list dependency links " +
+            "between workspaces. Supports various dependency types: api-consumer, " +
+            "api-provider, shared-lib, monorepo-package, data-source, deployment-target, other.",
         args: {
-            action: z.enum(["add", "remove", "list"]).describe("Action to perform"),
+            action: z
+                .enum(WORKSPACE_LINK_ACTION_VALUES)
+                .describe("Dependency operation: add, remove, or list"),
             source_id: z
                 .string()
                 .optional()
@@ -166,21 +172,13 @@ export function createWorkspaceRegistryTools(deps) {
                 .optional()
                 .describe("Target workspace ID (required for add/remove)"),
             dependency_type: z
-                .enum([
-                "api-consumer",
-                "api-provider",
-                "shared-lib",
-                "monorepo-package",
-                "data-source",
-                "deployment-target",
-                "other",
-            ])
-                .optional()
-                .describe("Dependency type (required for add)"),
+                .enum(DEPENDENCY_TYPE_VALUES)
+                .optional()
+                .describe("Type of dependency (required for add)"),
             description: z
                 .string()
                 .optional()
-                .describe("Description of the dependency relationship"),
+                .describe("Optional description of the dependency relationship"),
             workspace_id: z
                 .string()
                 .optional()
@@ -201,10 +199,7 @@ export function createWorkspaceRegistryTools(deps) {
                     ? { workspaceId: args.workspace_id }
                     : {}),
             });
-            if (!result.success) {
-                return `ERROR: ${result.error}`;
-            }
-            return result.data.message;
+            return formatResult(result, (data) => data.message);
         },
     });
     return {

package/dist/tools/workspace-registry-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-registry-tools.js","sourceRoot":"","sources":["../../src/tools/workspace-registry-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workspace-registry-tools.js","sourceRoot":"","sources":["../../src/tools/workspace-registry-tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mc1global/opencode-jarvis",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "JARVIS Framework - OpenCode native plugin for multi-agent development with DDD architecture",
   "author": "Julio Fabio de O. Chagas <julio.fabio@mc1global.com>",
   "license": "SEE LICENSE IN LICENSE",
@@ -24,18 +24,21 @@
     "scripts/setup/",
     "LICENSE",
     "README.md",
+    "CHANGELOG.md",
     "QUICK-GUIDE.md"
   ],
   "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "node --experimental-vm-modules node_modules/.bin/jest",
-    "test:watch": "node --experimental-vm-modules node_modules/.bin/jest --watch",
-    "lint": "tsc --noEmit",
+    "build": "node node_modules/typescript/bin/tsc",
+    "dev": "node node_modules/typescript/bin/tsc --watch",
+    "test": "node node_modules/jest/bin/jest.js --config jest.config.cjs",
+    "test:watch": "node node_modules/jest/bin/jest.js --config jest.config.cjs --watch",
+    "lint": "node node_modules/typescript/bin/tsc --noEmit",
     "clean": "rm -rf dist",
     "prepack": "npm run clean && npm run build",
     "check:lines": "find src -name '*.ts' ! -path '*/tests/*' -exec wc -l {} + | sort -rn | head -20",
-    "mcp:start": "bun run src/mcp-server.ts"
+    "mcp:start": "bun run src/mcp-server.ts",
+    "link:local": "npm run build && node scripts/setup/link-local.js",
+    "unlink:local": "node scripts/setup/link-local.js --unlink"
   },
   "engines": {
     "node": ">=20.0.0"
@@ -51,6 +54,7 @@
     "@clack/prompts": "^1.0.1",
     "@langchain/textsplitters": "^1.0.1",
     "@modelcontextprotocol/sdk": "^1.26.0",
+    "better-sqlite3": "^11.0.0",
     "js-yaml": "^4.1.1",
     "ollama": "^0.6.3",
     "vectra": "^0.12.3"
@@ -62,7 +66,6 @@
     "@types/jest": "^29.5.12",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.11.0",
-    "better-sqlite3": "^11.0.0",
     "jest": "^29.7.0",
     "ts-jest": "^29.1.2",
     "typescript": "^5.5.0"

package/scripts/setup/link-local.js

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+/**
+ * link-local.js — Local development helper for @mc1global/opencode-jarvis
+ *
+ * Creates (or removes) a symlink in the OpenCode global plugins directory
+ * so the plugin can be tested locally without publishing to npm.
+ *
+ * How it works:
+ *   - The OpenCode global plugins dir (~/.config/opencode/plugins/) is
+ *     automatically scanned at startup. Any .js file there is loaded as a plugin.
+ *   - We symlink dist/index.js → ~/.config/opencode/plugins/jarvis.js
+ *   - Bun follows the symlink, resolves relative imports from dist/, and
+ *     finds external deps (vectra, js-yaml, etc.) in this repo's node_modules/.
+ *
+ * Usage:
+ *   node scripts/setup/link-local.js           # create symlink
+ *   node scripts/setup/link-local.js --unlink  # remove symlink
+ *
+ * Or via npm:
+ *   npm run link:local
+ *   npm run unlink:local
+ */
+
+import { symlinkSync, unlinkSync, mkdirSync, existsSync, realpathSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { homedir, platform } from "node:os";
+import { fileURLToPath } from "node:url";
+
+const __dirname = fileURLToPath(new URL(".", import.meta.url));
+const UNLINK = process.argv.includes("--unlink");
+
+// ── Paths ──────────────────────────────────────────────────────────────────
+
+const repoRoot = resolve(__dirname, "../..");
+const distEntry = join(repoRoot, "dist", "index.js");
+
+// OpenCode global plugins directory
+// Consistent across macOS, Linux, and WSL
+const pluginsDir = join(homedir(), ".config", "opencode", "plugins");
+const symlinkTarget = join(pluginsDir, "jarvis.js");
+
+// ── Helpers ────────────────────────────────────────────────────────────────
+
+const GREEN = "\x1b[32m";
+const YELLOW = "\x1b[33m";
+const RED = "\x1b[31m";
+const BOLD = "\x1b[1m";
+const RESET = "\x1b[0m";
+
+function ok(msg) { console.log(`${GREEN}[OK]${RESET}    ${msg}`); }
+function info(msg) { console.log(`${BOLD}[INFO]${RESET}  ${msg}`); }
+function warn(msg) { console.log(`${YELLOW}[WARN]${RESET}  ${msg}`); }
+function fail(msg) { console.error(`${RED}[FAIL]${RESET}  ${msg}`); process.exit(1); }
+
+// ── Unlink ─────────────────────────────────────────────────────────────────
+
+if (UNLINK) {
+  if (!existsSync(symlinkTarget)) {
+    warn(`Symlink not found: ${symlinkTarget}`);
+    warn("Nothing to remove.");
+    process.exit(0);
+  }
+  unlinkSync(symlinkTarget);
+  ok(`Removed symlink: ${symlinkTarget}`);
+  info("Plugin unlinked. Restart OpenCode for changes to take effect.");
+  process.exit(0);
+}
+
+// ── Link ───────────────────────────────────────────────────────────────────
+
+// Verify dist/index.js exists (must build first)
+if (!existsSync(distEntry)) {
+  fail(
+    `dist/index.js not found.\n` +
+    `       Run 'npm run build' before linking.\n` +
+    `       (npm run link:local does this automatically)`
+  );
+}
+
+// Create plugins dir if needed
+if (!existsSync(pluginsDir)) {
+  mkdirSync(pluginsDir, { recursive: true });
+  info(`Created directory: ${pluginsDir}`);
+}
+
+// Remove existing symlink/file at target path
+if (existsSync(symlinkTarget)) {
+  info(`Replacing existing entry at ${symlinkTarget}`);
+  unlinkSync(symlinkTarget);
+}
+
+// Create symlink
+// On Windows (non-WSL) symlinks may require elevated privileges or Developer Mode.
+// The plugin is designed for macOS/Linux/WSL — Windows native is not supported.
+if (platform() === "win32") {
+  fail(
+    "Windows native is not supported for local plugin development.\n" +
+    "       Use WSL 2 instead. See: https://opencode.ai/docs/windows-wsl"
+  );
+}
+
+symlinkSync(distEntry, symlinkTarget);
+
+// Verify
+const resolved = realpathSync(symlinkTarget);
+if (resolved !== realpathSync(distEntry)) {
+  fail(`Symlink verification failed.\n  Expected: ${distEntry}\n  Got: ${resolved}`);
+}
+
+console.log();
+ok(`Symlink created:`);
+console.log(`       ${symlinkTarget}`);
+console.log(`       → ${distEntry}`);
+console.log();
+info("Plugin linked globally. No opencode.json changes needed.");
+info("Restart OpenCode in any project to activate JARVIS.");
+console.log();
+console.log(`${BOLD}Tip:${RESET} After each rebuild, the symlink stays valid.`);
+console.log(`     Just run 'npm run build' and restart OpenCode.`);
+console.log();

package/scripts/setup/setup-linux.sh

@@ -110,15 +110,25 @@ echo -e "${BOLD}─────────────────────
 echo -e "${GREEN}${BOLD}JARVIS prerequisites installed!${RESET}"
 echo ""
 echo "Next steps:"
-echo "  1. Add the plugin to your project:"
 echo ""
-echo "     # In your project root:"
-echo '     echo '"'"'{ "plugin": ["@mc1global/opencode-jarvis"] }'"'"' > opencode.json'
+echo "  Option A — Install from npm (production):"
 echo ""
-echo "  2. Launch OpenCode:"
+echo "     In your project's opencode.json:"
+echo '     { "plugin": ["@mc1global/opencode-jarvis"] }'
+echo ""
+echo "  Option B — Local development (before npm publish):"
+echo ""
+echo "     cd /path/to/jarvis-opencode-clean"
+echo "     npm install"
+echo "     npm run link:local    # builds + creates symlink in ~/.config/opencode/plugins/"
+echo ""
+echo "     The plugin loads globally in ALL projects without any opencode.json change."
+echo "     After each code change: npm run build  (symlink stays valid)"
+echo "     To remove the link:    npm run unlink:local"
+echo ""
+echo "  Then launch OpenCode in any project:"
 echo ""
-echo "     cd /path/to/your/project"
 echo "     opencode"
 echo ""
-echo "  3. JARVIS will auto-bootstrap on first launch."
+echo "  JARVIS will auto-bootstrap on first launch."
 echo -e "${BOLD}──────────────────────────────────────────${RESET}"