@merchantduo/code 0.2.0-beta.2 → 0.2.0-beta.4

package/dist/integrations/pi/workflows.js

@@ -6,7 +6,7 @@ export default function workflows(pi) {
     pi.registerTool({ name: "magento_workflow", label: "Magento workflow", description: "Preview or explicitly execute a supported Magento operational action.", parameters: Type.Object({ action: Type.String(), execute: Type.Optional(Type.Boolean()) }), async execute(_id, params, _signal, _update, ctx) {
             const state = await runtime.boot(ctx.cwd);
             if (params.action === "status")
-                return text(JSON.stringify({ snapshot: state.magento, testing: state.testing, pendingFiles: runtime.changes.files(), workflows: builtInWorkflows.map(({ id, description }) => ({ id, description })) }, null, 2));
+                return text(JSON.stringify({ snapshot: state.magento, permissionMode: state.permissionMode, testing: state.testing, magerun2: state.magerun2, pendingFiles: runtime.changes.files(), workflows: builtInWorkflows.map(({ id, description }) => ({ id, description })) }, null, 2));
             if (params.action === "syntax-check")
                 return text((await syntaxCheck(state.backend, runtime.changes.files())).join("\n") || "No supported changed files require syntax checks.");
             const workflow = builtInWorkflows.find(({ id }) => id === params.action);

package/dist/magento/prompt.d.ts

@@ -1,2 +1,3 @@
 import type { MagentoSnapshot } from "#magento/model";
-export declare function snapshotPrompt(envName: string, writable: boolean, status: string, snapshot: MagentoSnapshot): string;
+import type { PermissionMode } from "#app/permission-mode";
+export declare function snapshotPrompt(envName: string, permissionMode: PermissionMode, status: string, snapshot: MagentoSnapshot): string;

package/dist/magento/prompt.js

@@ -1,3 +1,3 @@
-export function snapshotPrompt(envName, writable, status, snapshot) {
-    return `[MerchantDuo: environment=${envName}; write policy=${writable ? "writable" : "read-only"}; Magento=${snapshot.edition ?? "unknown"} ${snapshot.version ?? "unknown"}; PHP=${snapshot.phpVersion ?? "unknown"}; mode=${snapshot.mode ?? "unknown"}; knowledge=${status}; pending actions are controlled by magento_workflow. Do not inspect app/etc/env.php or credentials.${snapshot.warnings.length ? ` Warnings: ${snapshot.warnings.join("; ")}` : ""}]`;
+export function snapshotPrompt(envName, permissionMode, status, snapshot) {
+    return `[MerchantDuo: environment=${envName}; permission mode=${permissionMode}; Magento=${snapshot.edition ?? "unknown"} ${snapshot.version ?? "unknown"}; PHP=${snapshot.phpVersion ?? "unknown"}; mode=${snapshot.mode ?? "unknown"}; knowledge=${status}; pending actions are controlled by magento_workflow. Do not inspect app/etc/env.php or credentials.${snapshot.warnings.length ? ` Warnings: ${snapshot.warnings.join("; ")}` : ""}]`;
 }

package/dist/testing/discovery.d.ts

@@ -4,7 +4,6 @@ import type { TestingOptions, TestingSnapshot } from "#testing/model";
 export declare function discoverTesting(environment: Environment, backend: EnvironmentBackend, cwd: string, options: TestingOptions, tools?: {
     http?: string;
     browser?: string;
-    magerun?: string;
 }): Promise<TestingSnapshot>;
 export declare function wardenRouting(projectRoot: string): Promise<string | undefined>;
 export declare function findExecutable(candidates: string[]): Promise<string | undefined>;

package/dist/testing/discovery.js

@@ -32,16 +32,13 @@ export async function discoverTesting(environment, backend, cwd, options, tools
     const browser = tools.browser
         ? { available: true, executable: tools.browser }
         : { available: false, reason: "Install Chromium or Chrome." };
-    const phpRepl = tools.magerun
-        ? { available: true, executable: tools.magerun }
-        : { available: false, reason: "n98-magerun2 is unavailable." };
     if (!frontendUrl)
         diagnostics.push("Frontend URL unavailable.");
     if (!adminUrl)
         diagnostics.push("Admin URL unavailable.");
     diagnostics.push("URLs are discovered but unverified; no startup HTTP request was made.");
     const http = tools.http ? { available: true, executable: tools.http } : { available: false, reason: "Install curl." };
-    return { frontendUrl, adminUrl, http, browser, phpRepl, diagnostics };
+    return { frontendUrl, adminUrl, http, browser, diagnostics };
 }
 export async function wardenRouting(projectRoot) {
     try {

package/dist/testing/host.d.ts

@@ -1,6 +1,7 @@
 export type HostProcessResult = {
     output: string;
     code: number;
+    truncated?: boolean;
 };
 export interface HostProcessRunner {
     run(file: string, args: string[], options: {

package/dist/testing/host.js

@@ -7,16 +7,27 @@ export class NodeHostProcessRunner {
         return new Promise((done) => {
             const child = spawn(file, args, { cwd: options.cwd, signal: options.signal });
             let output = "";
+            let truncated = false;
             let settled = false;
             const finish = (result) => { if (!settled) {
                 settled = true;
                 done(result);
             } };
-            const add = (data) => { output = bound(output + data.toString()); };
+            const add = (data) => {
+                if (truncated)
+                    return;
+                const next = output + data.toString();
+                if (next.length > MAX_OUTPUT) {
+                    output = `${next.slice(0, MAX_OUTPUT)}\n[output truncated]`;
+                    truncated = true;
+                }
+                else
+                    output = next;
+            };
             child.stdout.on("data", add);
             child.stderr.on("data", add);
-            child.on("error", (error) => finish({ output: error.message, code: 127 }));
-            child.on("close", (code) => finish({ output, code: code ?? 1 }));
+            child.on("error", (error) => finish({ output: error.message, code: 127, truncated }));
+            child.on("close", (code) => finish({ output, code: code ?? 1, truncated }));
             if (options.input !== undefined)
                 child.stdin.end(options.input);
         });

package/dist/testing/index.d.ts

@@ -1,5 +1,4 @@
 export * from "#testing/model";
 export * from "#testing/url";
 export * from "#testing/discovery";
-export * from "#testing/magerun";
 export * from "#testing/host";

package/dist/testing/index.js

@@ -1,5 +1,4 @@
 export * from "#testing/model";
 export * from "#testing/url";
 export * from "#testing/discovery";
-export * from "#testing/magerun";
 export * from "#testing/host";

package/dist/testing/model.d.ts

@@ -8,7 +8,6 @@ export type TestingSnapshot = {
     adminUrl?: string;
     http: Capability;
     browser: Capability;
-    phpRepl: Capability;
     diagnostics: string[];
 };
 export type TestingOptions = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@merchantduo/code",
-  "version": "0.2.0-beta.2",
+  "version": "0.2.0-beta.4",
   "private": false,
   "description": "Magento-native Pi-based Coding Agent",
   "type": "module",
@@ -40,11 +40,14 @@
   "pi": {
     "extensions": [
       "./dist/integrations/pi/context.js",
+      "./dist/integrations/pi/optional-services.js",
       "./dist/integrations/pi/permissions.js",
       "./dist/integrations/pi/workspace.js",
+      "./dist/integrations/pi/environment.js",
       "./dist/integrations/pi/theme.js",
       "./dist/integrations/pi/mage2gen.js",
       "./dist/integrations/pi/workflows.js",
+      "./dist/integrations/pi/magerun2.js",
       "./dist/integrations/pi/testing.js"
     ],
     "skills": [
@@ -54,6 +57,7 @@
   },
   "dependencies": {
     "@earendil-works/pi-coding-agent": "0.84.1",
+    "@modelcontextprotocol/client": "2.0.0",
     "typebox": "1.3.7",
     "yaml": "^2.8.1",
     "zod": "^3.24.4"

package/skills/magerun2/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: magerun2
+description: Use structured n98-magerun2 commands for Magento operations that MerchantDuo does not model as a workflow.
+---
+
+# Universal magerun2
+
+MerchantDuo discovers magerun2 once for the selected environment. Local uses a project binary, PATH binary, or a verified official PHAR cache; Warden uses its PHP service; SSH uses its remote binary. The capability and diagnostic appear in `magento_workflow` status.
+
+Use `magento_workflow` for its supported cache, deployment, indexing, and test operations. Use `magerun2` only for a command that the workflow does not model. Pass exact structured arguments, never a shell command string. For example:
+
+```json
+{"args":["list"]}
+```
+
+```json
+{"args":["help","sys:cron:list"]}
+```
+
+Without `execute: true`, the tool returns an exact quoted preview. Set `execute: true` only after the user directly asks to run the command; MerchantDuo then provides its one confirmation dialog. `stdin` is optional for subcommands that require it.
+
+Do not call `dev:console` through this tool. Use `magento_php_repl` with its typed `snippet` and optional `area`. Generic magerun2 is refused on read-only SSH because arbitrary subcommands cannot be safely classified.

package/dist/testing/magerun.d.ts

@@ -1,8 +0,0 @@
-import type { EnvironmentBackend } from "#environments/backend";
-import type { Environment } from "#environments/model";
-export declare function discoverMagerun(environment: Environment, backend: EnvironmentBackend, cwd: string): Promise<{
-    executable?: string;
-    diagnostic?: string;
-}>;
-/** Install the official PHAR outside the Magento project; verify the release API SHA-256 digest before publishing it. */
-export declare function installMagerun(home: string, _cwd: string, request?: typeof fetch): Promise<string>;