@mc1global/opencode-jarvis 0.1.0

package/dist/tools/environment-tools.d.ts

@@ -0,0 +1,85 @@
+import type { EnvironmentUseCases } from "../application/environment/use-cases.js";
+export interface EnvironmentToolsDeps {
+    readonly environmentUseCases: EnvironmentUseCases;
+}
+export declare function createEnvironmentTools(deps: EnvironmentToolsDeps): {
+    "env-init": {
+        description: string;
+        args: {
+            directory: import("zod").ZodString;
+        };
+        execute(args: {
+            directory: string;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    "env-create": {
+        description: string;
+        args: {
+            name: import("zod").ZodString;
+            purpose: import("zod").ZodString;
+            description: import("zod").ZodString;
+            card_id: import("zod").ZodOptional<import("zod").ZodString>;
+            base_image: import("zod").ZodOptional<import("zod").ZodString>;
+            setup_commands: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            install_commands: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            env_vars: import("zod").ZodOptional<import("zod").ZodString>;
+            merge_strategy: import("zod").ZodOptional<import("zod").ZodString>;
+        };
+        execute(args: {
+            name: string;
+            purpose: string;
+            description: string;
+            card_id?: string | undefined;
+            base_image?: string | undefined;
+            setup_commands?: string[] | undefined;
+            install_commands?: string[] | undefined;
+            env_vars?: string | undefined;
+            merge_strategy?: string | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    "env-list": {
+        description: string;
+        args: {
+            filter: import("zod").ZodOptional<import("zod").ZodString>;
+        };
+        execute(args: {
+            filter?: string | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    "env-status": {
+        description: string;
+        args: {
+            env_id: import("zod").ZodString;
+            action: import("zod").ZodOptional<import("zod").ZodString>;
+            commit_sha: import("zod").ZodOptional<import("zod").ZodString>;
+            reason: import("zod").ZodOptional<import("zod").ZodString>;
+            card_id: import("zod").ZodOptional<import("zod").ZodString>;
+        };
+        execute(args: {
+            env_id: string;
+            action?: string | undefined;
+            commit_sha?: string | undefined;
+            reason?: string | undefined;
+            card_id?: string | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    "env-merge": {
+        description: string;
+        args: {
+            env_id: import("zod").ZodString;
+        };
+        execute(args: {
+            env_id: string;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    "env-delete": {
+        description: string;
+        args: {
+            env_id: import("zod").ZodString;
+        };
+        execute(args: {
+            env_id: string;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+};
+//# sourceMappingURL=environment-tools.d.ts.map

package/dist/tools/environment-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-tools.d.ts","sourceRoot":"","sources":["../../src/tools/environment-tools.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAMnF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;CACnD;AAID,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiOhE"}

package/dist/tools/environment-tools.js

@@ -0,0 +1,223 @@
+/**
+ * Environment Management Tools
+ *
+ * OpenCode tool definitions for the environment bounded context.
+ * Creates isolated containerized dev environments via container-use.
+ * The plugin tracks metadata; the agent invokes container-use MCP tools directly.
+ *
+ * Tools defined (6):
+ *   env-init   - Analyze project for environment configuration
+ *   env-create - Create a new environment record and get MCP instructions
+ *   env-list   - List all environments
+ *   env-status - Get/update environment status and card linkage
+ *   env-merge  - Start merge process and get MCP instructions
+ *   env-delete - Mark environment for deletion
+ *
+ * SOLID: SRP - environment tool exposure only
+ * SOLID: DIP - depends on use case abstractions
+ */
+import { tool } from "@opencode-ai/plugin";
+const z = tool.schema;
+// ── Tool Factory ──────────────────────────────────────────────────────
+export function createEnvironmentTools(deps) {
+    const { environmentUseCases } = deps;
+    // ── env-init ─────────────────────────────────────────────────────
+    const envInit = tool({
+        description: "Analyze a project directory to determine optimal container-use environment " +
+            "configuration. Detects primary language, frameworks, and suggests a base " +
+            "Docker image. Use this before env-create to auto-detect settings.",
+        args: {
+            directory: z
+                .string()
+                .describe("Absolute path to the project root directory"),
+        },
+        async execute(args) {
+            const result = await environmentUseCases.init({
+                directory: args.directory,
+            });
+            if (!result.success) {
+                return result.error;
+            }
+            return result.data.summary;
+        },
+    });
+    // ── env-create ───────────────────────────────────────────────────
+    const envCreate = tool({
+        description: "Create a new isolated container-use environment. Returns MCP tool " +
+            "instructions for the agent to create the actual container. " +
+            "Optionally links to a kanban card for tracking.",
+        args: {
+            name: z
+                .string()
+                .describe("Environment name (lowercase, hyphens, e.g. 'feature-auth')"),
+            purpose: z
+                .string()
+                .describe("Purpose: feature, bugfix, experiment, refactor, spike, or hotfix"),
+            description: z
+                .string()
+                .describe("Brief description of what this environment is for"),
+            card_id: z
+                .string()
+                .optional()
+                .describe("Kanban card ID to link (e.g. 'CD-005')"),
+            base_image: z
+                .string()
+                .optional()
+                .describe("Docker base image (e.g. 'node:20-slim')"),
+            setup_commands: z
+                .array(z.string())
+                .optional()
+                .describe("Shell commands to run during setup"),
+            install_commands: z
+                .array(z.string())
+                .optional()
+                .describe("Commands to install dependencies"),
+            env_vars: z
+                .string()
+                .optional()
+                .describe('Environment variables as JSON object, e.g. \'{"NODE_ENV":"development"}\''),
+            merge_strategy: z
+                .string()
+                .optional()
+                .describe("Merge strategy: merge-commit, squash (default), or rebase"),
+        },
+        async execute(args) {
+            // Parse env_vars JSON string if provided
+            let envVars;
+            if (args.env_vars !== undefined) {
+                try {
+                    envVars = JSON.parse(args.env_vars);
+                }
+                catch {
+                    return `Invalid env_vars JSON: ${args.env_vars}`;
+                }
+            }
+            const result = await environmentUseCases.create({
+                name: args.name,
+                purpose: args.purpose,
+                description: args.description,
+                ...(args.card_id !== undefined ? { cardId: args.card_id } : {}),
+                ...(args.base_image !== undefined
+                    ? { baseImage: args.base_image }
+                    : {}),
+                ...(args.setup_commands !== undefined
+                    ? { setupCommands: args.setup_commands }
+                    : {}),
+                ...(args.install_commands !== undefined
+                    ? { installCommands: args.install_commands }
+                    : {}),
+                ...(envVars !== undefined ? { envVars } : {}),
+                ...(args.merge_strategy !== undefined
+                    ? { mergeStrategy: args.merge_strategy }
+                    : {}),
+            });
+            if (!result.success) {
+                return result.error;
+            }
+            return result.data.instructions;
+        },
+    });
+    // ── env-list ─────────────────────────────────────────────────────
+    const envList = tool({
+        description: "List all environments for the current workspace. " +
+            "Shows ID, name, status, purpose, and linked card.",
+        args: {
+            filter: z
+                .string()
+                .optional()
+                .describe("Filter: 'active' to show only non-terminal environments"),
+        },
+        async execute(args) {
+            const result = await environmentUseCases.list({
+                ...(args.filter !== undefined ? { filter: args.filter } : {}),
+            });
+            if (!result.success) {
+                return result.error;
+            }
+            return result.data.summary;
+        },
+    });
+    // ── env-status ───────────────────────────────────────────────────
+    const envStatus = tool({
+        description: "Get or update environment status. Without an action, shows full details. " +
+            "Actions: info, activate, fail, complete-merge, revert-merge, link-card, unlink-card.",
+        args: {
+            env_id: z.string().describe("Environment ID (e.g. 'ENV-001')"),
+            action: z
+                .string()
+                .optional()
+                .describe("Action: info (default), activate, fail, complete-merge, revert-merge, link-card, unlink-card"),
+            commit_sha: z
+                .string()
+                .optional()
+                .describe("Merge commit SHA (for complete-merge action)"),
+            reason: z
+                .string()
+                .optional()
+                .describe("Reason (for fail or revert-merge actions)"),
+            card_id: z
+                .string()
+                .optional()
+                .describe("Card ID (for link-card action, e.g. 'CD-005')"),
+        },
+        async execute(args) {
+            const result = await environmentUseCases.status({
+                envId: args.env_id,
+                ...(args.action !== undefined ? { action: args.action } : {}),
+                ...(args.commit_sha !== undefined
+                    ? { commitSha: args.commit_sha }
+                    : {}),
+                ...(args.reason !== undefined ? { reason: args.reason } : {}),
+                ...(args.card_id !== undefined ? { cardId: args.card_id } : {}),
+            });
+            if (!result.success) {
+                return result.error;
+            }
+            return result.data.summary;
+        },
+    });
+    // ── env-merge ────────────────────────────────────────────────────
+    const envMerge = tool({
+        description: "Start merging an environment back to the main branch. " +
+            "Returns container-use MCP instructions for the agent to execute the merge. " +
+            "After merge completes, call env-status with action 'complete-merge'.",
+        args: {
+            env_id: z.string().describe("Environment ID to merge (e.g. 'ENV-001')"),
+        },
+        async execute(args) {
+            const result = await environmentUseCases.merge({
+                envId: args.env_id,
+            });
+            if (!result.success) {
+                return result.error;
+            }
+            return result.data.instructions;
+        },
+    });
+    // ── env-delete ───────────────────────────────────────────────────
+    const envDelete = tool({
+        description: "Mark an environment for deletion. Returns container-use instructions " +
+            "for the agent to delete the actual container and git worktree.",
+        args: {
+            env_id: z.string().describe("Environment ID to delete (e.g. 'ENV-001')"),
+        },
+        async execute(args) {
+            const result = await environmentUseCases.delete({
+                envId: args.env_id,
+            });
+            if (!result.success) {
+                return result.error;
+            }
+            return result.data.message;
+        },
+    });
+    return {
+        "env-init": envInit,
+        "env-create": envCreate,
+        "env-list": envList,
+        "env-status": envStatus,
+        "env-merge": envMerge,
+        "env-delete": envDelete,
+    };
+}
+//# sourceMappingURL=environment-tools.js.map

package/dist/tools/environment-tools.js.map

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

package/dist/tools/governance-tools.d.ts

@@ -0,0 +1,7 @@
+import type { GovernanceUseCases } from "../application/governance/validation-use-cases.js";
+import type { ToolDefinition } from "@opencode-ai/plugin";
+export interface GovernanceToolsDeps {
+    readonly governanceUseCases: GovernanceUseCases;
+}
+export declare function createGovernanceTools(deps: GovernanceToolsDeps): Record<string, ToolDefinition>;
+//# sourceMappingURL=governance-tools.d.ts.map

package/dist/tools/governance-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance-tools.d.ts","sourceRoot":"","sources":["../../src/tools/governance-tools.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AAC5F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAM1D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;CACjD;AAID,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,mBAAmB,GACxB,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA8DhC"}

package/dist/tools/governance-tools.js

@@ -0,0 +1,73 @@
+/**
+ * Governance Tools
+ *
+ * OpenCode tool definitions for governance introspection.
+ * These tools allow agents to check governance policies and
+ * validate operations before executing them.
+ *
+ * Tools defined:
+ *   governance-validate, governance-policies
+ *
+ * SOLID: SRP - governance tool exposure only
+ * SOLID: DIP - depends on use case abstractions
+ */
+import { tool } from "@opencode-ai/plugin";
+const z = tool.schema;
+// ── Tool Factory ──────────────────────────────────────────────────────
+export function createGovernanceTools(deps) {
+    const { governanceUseCases } = deps;
+    const validate = tool({
+        description: "Validate a tool invocation against governance policies. " +
+            "Use this to pre-check if an operation is allowed before executing it.",
+        args: {
+            tool_name: z.string().describe("Name of the tool to validate"),
+            tool_args: z.string().describe("JSON string of the tool arguments"),
+        },
+        async execute(args) {
+            let parsedArgs;
+            try {
+                parsedArgs = JSON.parse(args.tool_args);
+            }
+            catch {
+                return "ERROR: Invalid JSON in tool_args";
+            }
+            const result = await governanceUseCases.validateTool({
+                toolName: args.tool_name,
+                args: parsedArgs,
+            });
+            if (!result.success)
+                return `ERROR: ${result.error}`;
+            const data = result.data;
+            if (data.allowed && data.violations.length === 0) {
+                return "ALLOWED: No governance violations detected.";
+            }
+            const lines = [];
+            lines.push(data.allowed ? "ALLOWED (with warnings):" : "BLOCKED:");
+            for (const v of data.violations) {
+                lines.push(`  [${v.severity.toUpperCase()}] ${v.rule}: ${v.message}`);
+            }
+            return lines.join("\n");
+        },
+    });
+    const policies = tool({
+        description: "List all active governance policies. " +
+            "Shows the rules that are enforced on tool invocations.",
+        args: {},
+        async execute() {
+            const result = await governanceUseCases.listPolicies();
+            if (!result.success)
+                return `ERROR: ${result.error}`;
+            const data = result.data;
+            const lines = [
+                `Active Governance Policies (${data.totalPolicies}):`,
+                ...data.policyIds.map((id) => `  - ${id}`),
+            ];
+            return lines.join("\n");
+        },
+    });
+    return {
+        "governance-validate": validate,
+        "governance-policies": policies,
+    };
+}
+//# sourceMappingURL=governance-tools.js.map

package/dist/tools/governance-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance-tools.js","sourceRoot":"","sources":["../../src/tools/governance-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAK3C,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;AAQtB,yEAAyE;AAEzE,MAAM,UAAU,qBAAqB,CACnC,IAAyB;IAEzB,MAAM,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;IAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC;QACpB,WAAW,EACT,0DAA0D;YAC1D,uEAAuE;QACzE,IAAI,EAAE;YACJ,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;YAC9D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;SACpE;QACD,KAAK,CAAC,OAAO,CAAC,IAAI;YAChB,IAAI,UAAmC,CAAC;YACxC,IAAI,CAAC;gBACH,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAA4B,CAAC;YACrE,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,kCAAkC,CAAC;YAC5C,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,YAAY,CAAC;gBACnD,QAAQ,EAAE,IAAI,CAAC,SAAS;gBACxB,IAAI,EAAE,UAAU;aACjB,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO,UAAU,MAAM,CAAC,KAAK,EAAE,CAAC;YAErD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACzB,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACjD,OAAO,6CAA6C,CAAC;YACvD,CAAC;YAED,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;YACnE,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YACxE,CAAC;YACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,IAAI,CAAC;QACpB,WAAW,EACT,uCAAuC;YACvC,wDAAwD;QAC1D,IAAI,EAAE,EAAE;QACR,KAAK,CAAC,OAAO;YACX,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,YAAY,EAAE,CAAC;YACvD,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO,UAAU,MAAM,CAAC,KAAK,EAAE,CAAC;YAErD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACzB,MAAM,KAAK,GAAG;gBACZ,+BAA+B,IAAI,CAAC,aAAa,IAAI;gBACrD,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;aAC3C,CAAC;YACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;KACF,CAAC,CAAC;IAEH,OAAO;QACL,qBAAqB,EAAE,QAAQ;QAC/B,qBAAqB,EAAE,QAAQ;KAChC,CAAC;AACJ,CAAC"}

package/dist/tools/kanban-board-tools.d.ts

@@ -0,0 +1,11 @@
+import type { SprintUseCases, EpicUseCases } from "../application/kanban/sprint-use-cases.js";
+import type { BoardUseCases } from "../application/kanban/board-use-cases.js";
+import type { ToolDefinition } from "@opencode-ai/plugin";
+export interface KanbanBoardToolsDeps {
+    readonly sprintUseCases: SprintUseCases;
+    readonly epicUseCases: EpicUseCases;
+    readonly boardUseCases: BoardUseCases;
+    readonly getWorkspace: (directory: string) => string;
+}
+export declare function createKanbanBoardTools(deps: KanbanBoardToolsDeps): Record<string, ToolDefinition>;
+//# sourceMappingURL=kanban-board-tools.d.ts.map

package/dist/tools/kanban-board-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kanban-board-tools.d.ts","sourceRoot":"","sources":["../../src/tools/kanban-board-tools.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACb,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAU1D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CACtD;AAwCD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,oBAAoB,GACzB,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA0UhC"}