@merchantduo/code 0.1.0-beta.0 → 0.2.0-beta.0

package/dist/backend.js

@@ -1,103 +0,0 @@
-import { spawn } from "node:child_process";
-import { relative, resolve } from "node:path";
-const MAX_OUTPUT = 64 * 1024;
-export function contain(root, candidate) {
-    const full = resolve(root, candidate);
-    if (relative(root, full).startsWith(".."))
-        throw new Error(`Path escapes configured root: ${candidate}`);
-    return full;
-}
-export class Backend {
-    environment;
-    localRoot;
-    constructor(environment, localRoot) {
-        this.environment = environment;
-        this.localRoot = localRoot;
-    }
-    path(path) {
-        if (this.environment.type === "local")
-            return contain(resolve(this.localRoot, this.environment.root), path);
-        if (!path.startsWith("/"))
-            return `${this.environment.root}/${path}`;
-        return contain(this.environment.root, path);
-    }
-    command(argv, target) {
-        if (this.environment.type === "local")
-            return {
-                file: argv[0],
-                args: argv.slice(1),
-                cwd: resolve(this.localRoot, this.environment.root),
-            };
-        if (this.environment.type === "warden") {
-            const service = target
-                ? this.environment.targets[target]
-                : this.environment.filesService;
-            if (!service)
-                throw new Error(`Unknown Warden target: ${target}`);
-            return {
-                file: "warden",
-                args: ["env", "exec", "-T", service, ...argv],
-                cwd: resolve(this.localRoot, this.environment.projectRoot),
-            };
-        }
-        return {
-            file: "ssh",
-            args: [
-                this.environment.host,
-                `cd ${shell(this.environment.root)} && ${argv.map(shell).join(" ")}`,
-            ],
-        };
-    }
-    async run(argv, options = {}) {
-        const spec = this.command(argv, options.target);
-        return new Promise((resolveResult) => {
-            const child = spawn(spec.file, spec.args, {
-                cwd: spec.cwd,
-                signal: options.signal,
-                detached: process.platform !== "win32",
-            });
-            let out = "", err = "", truncated = false, settled = false;
-            const finish = (result) => {
-                if (!settled) {
-                    settled = true;
-                    resolveResult(result);
-                }
-            };
-            const add = (old, buf) => {
-                const next = old + buf.toString();
-                if (next.length > MAX_OUTPUT) {
-                    truncated = true;
-                    return next.slice(0, MAX_OUTPUT);
-                }
-                return next;
-            };
-            child.stdout.on("data", (b) => {
-                out = add(out, b);
-            });
-            child.stderr.on("data", (b) => {
-                err = add(err, b);
-            });
-            const timer = options.timeoutMs
-                ? setTimeout(() => child.kill("SIGTERM"), options.timeoutMs)
-                : undefined;
-            child.on("error", (error) => {
-                if (timer)
-                    clearTimeout(timer);
-                finish({
-                    stdout: out,
-                    stderr: error.message,
-                    exitCode: 127,
-                    truncated,
-                });
-            });
-            child.on("close", (code) => {
-                if (timer)
-                    clearTimeout(timer);
-                finish({ stdout: out, stderr: err, exitCode: code ?? 1, truncated });
-            });
-        });
-    }
-}
-function shell(value) {
-    return `'${value.replace(/'/g, "'\\''")}'`;
-}

package/dist/cli.js

@@ -1,89 +0,0 @@
-#!/usr/bin/env node
-import { spawn } from "node:child_process";
-import { access, mkdir, writeFile } from "node:fs/promises";
-import { dirname, resolve } from "node:path";
-import { Backend } from "./backend.js";
-import { isTrusted, loadConfig, merchantHome, selectEnvironment, starterYaml, trustProject, } from "./config.js";
-import { snapshot } from "./magento.js";
-import { KNOWLEDGE_MCP_URL } from "./constants.js";
-const args = process.argv.slice(2);
-const command = args[0];
-const flag = (name) => {
-    const i = args.indexOf(name);
-    return i >= 0 ? args[i + 1] : undefined;
-};
-async function main() {
-    if (command === "init") {
-        const path = resolve(process.cwd(), ".merchantduo.yaml");
-        try {
-            await access(path);
-            throw new Error(`${path} already exists`);
-        }
-        catch (e) {
-            if (!e.code || e.code !== "ENOENT")
-                throw e;
-        }
-        await writeFile(path, starterYaml(), { mode: 0o600 });
-        console.log(`Created ${path}`);
-        return;
-    }
-    const { config, configPath } = await loadConfig(process.cwd(), {
-        config: flag("--config"),
-    });
-    const chosen = selectEnvironment(config, process.cwd(), flag("--env"));
-    if (configPath && !(await isTrusted(configPath))) {
-        if (process.env.MERCHANTDUO_TRUST_CONFIG === "1")
-            await trustProject(configPath);
-        else if (!process.stdin.isTTY)
-            throw new Error(`Untrusted MerchantDuo configuration: ${configPath}. Review it and run with MERCHANTDUO_TRUST_CONFIG=1 once.`);
-        else {
-            process.stderr.write(`Trust MerchantDuo config ${configPath}? Set MERCHANTDUO_TRUST_CONFIG=1 to approve.\n`);
-            process.exitCode = 2;
-            return;
-        }
-    }
-    const backend = new Backend(chosen.environment, process.cwd());
-    if (command === "doctor") {
-        const magento = await snapshot(backend);
-        const diagnostics = {
-            environment: chosen.name,
-            type: chosen.environment.type,
-            writable: chosen.environment.type !== "ssh" || chosen.environment.writable,
-            magento,
-            activeTheme: config.activeTheme,
-            mcp: {
-                url: KNOWLEDGE_MCP_URL,
-                tokenConfigured: Boolean(process.env.MERCHANTDUO_MCP_TOKEN),
-            },
-        };
-        console.log(JSON.stringify(diagnostics, null, 2));
-        return;
-    }
-    const extension = resolve(dirname(new URL(import.meta.url).pathname), "../extensions/merchantduo.js");
-    const piArgs = args.filter((_, i) => args[i - 1] !== "--env" &&
-        args[i - 1] !== "--config" &&
-        !["--env", "--config"].includes(args[i]));
-    const state = merchantHome();
-    await mkdir(state, { recursive: true, mode: 0o700 });
-    const child = spawn("npx", [
-        "--yes",
-        `@earendil-works/pi-coding-agent@0.84.1`,
-        "--extension",
-        extension,
-        ...piArgs,
-    ], {
-        stdio: "inherit",
-        env: {
-            ...process.env,
-            PI_CODING_AGENT_DIR: resolve(state, "pi"),
-            MERCHANTDUO_SELECTED_ENV: chosen.name,
-            MERCHANTDUO_CONFIG_PATH: configPath ?? "",
-            MERCHANTDUO_PACKAGE_VERSION: "0.1.0-beta.0",
-        },
-    });
-    child.on("exit", (code) => process.exit(code ?? 1));
-}
-main().catch((error) => {
-    console.error(`merchantduo: ${error.message}`);
-    process.exitCode = 1;
-});

package/dist/config.d.ts

@@ -1,127 +0,0 @@
-import { z } from "zod";
-export declare const ConfigSchema: z.ZodObject<{
-    version: z.ZodLiteral<1>;
-    defaultEnvironment: z.ZodOptional<z.ZodString>;
-    activeTheme: z.ZodDefault<z.ZodString>;
-    automation: z.ZodDefault<z.ZodObject<{
-        syntaxChecks: z.ZodDefault<z.ZodEnum<["auto", "off"]>>;
-        cacheClean: z.ZodDefault<z.ZodEnum<["auto", "off"]>>;
-    }, "strict", z.ZodTypeAny, {
-        syntaxChecks: "auto" | "off";
-        cacheClean: "auto" | "off";
-    }, {
-        syntaxChecks?: "auto" | "off" | undefined;
-        cacheClean?: "auto" | "off" | undefined;
-    }>>;
-    environments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodObject<{
-        type: z.ZodLiteral<"local">;
-        root: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        type: "local";
-        root: string;
-    }, {
-        type: "local";
-        root: string;
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"warden">;
-        projectRoot: z.ZodString;
-        root: z.ZodString;
-        filesService: z.ZodDefault<z.ZodString>;
-        targets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strict", z.ZodTypeAny, {
-        type: "warden";
-        root: string;
-        projectRoot: string;
-        filesService: string;
-        targets: Record<string, string>;
-    }, {
-        type: "warden";
-        root: string;
-        projectRoot: string;
-        filesService?: string | undefined;
-        targets?: Record<string, string> | undefined;
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"ssh">;
-        host: z.ZodString;
-        root: z.ZodString;
-        writable: z.ZodDefault<z.ZodBoolean>;
-    }, "strict", z.ZodTypeAny, {
-        type: "ssh";
-        root: string;
-        host: string;
-        writable: boolean;
-    }, {
-        type: "ssh";
-        root: string;
-        host: string;
-        writable?: boolean | undefined;
-    }>]>>>;
-}, "strict", z.ZodTypeAny, {
-    version: 1;
-    activeTheme: string;
-    automation: {
-        syntaxChecks: "auto" | "off";
-        cacheClean: "auto" | "off";
-    };
-    environments: Record<string, {
-        type: "local";
-        root: string;
-    } | {
-        type: "warden";
-        root: string;
-        projectRoot: string;
-        filesService: string;
-        targets: Record<string, string>;
-    } | {
-        type: "ssh";
-        root: string;
-        host: string;
-        writable: boolean;
-    }>;
-    defaultEnvironment?: string | undefined;
-}, {
-    version: 1;
-    defaultEnvironment?: string | undefined;
-    activeTheme?: string | undefined;
-    automation?: {
-        syntaxChecks?: "auto" | "off" | undefined;
-        cacheClean?: "auto" | "off" | undefined;
-    } | undefined;
-    environments?: Record<string, {
-        type: "local";
-        root: string;
-    } | {
-        type: "warden";
-        root: string;
-        projectRoot: string;
-        filesService?: string | undefined;
-        targets?: Record<string, string> | undefined;
-    } | {
-        type: "ssh";
-        root: string;
-        host: string;
-        writable?: boolean | undefined;
-    }> | undefined;
-}>;
-export type MerchantConfig = z.infer<typeof ConfigSchema>;
-export type Environment = MerchantConfig["environments"][string];
-export declare const template: MerchantConfig;
-export declare function merchantHome(env?: NodeJS.ProcessEnv): string;
-export declare function interpolate(value: string, env?: NodeJS.ProcessEnv): string;
-export declare function loadConfig(cwd: string, options?: {
-    config?: string;
-    env?: NodeJS.ProcessEnv;
-}): Promise<{
-    config: MerchantConfig;
-    configPath?: string;
-}>;
-/** Persist only the project-scoped theme selection and preserve all other YAML data. */
-export declare function setActiveTheme(configPath: string, activeTheme: string, env?: NodeJS.ProcessEnv): Promise<MerchantConfig>;
-export declare function selectEnvironment(config: MerchantConfig, cwd: string, requested?: string, env?: NodeJS.ProcessEnv): {
-    name: string;
-    environment: Environment;
-};
-export declare function configDigest(content: string): string;
-export declare function trustProject(configPath: string, env?: NodeJS.ProcessEnv): Promise<void>;
-export declare function isTrusted(configPath: string, env?: NodeJS.ProcessEnv): Promise<boolean>;
-export declare function starterYaml(): string;

package/dist/config.js

@@ -1,170 +0,0 @@
-import { createHash } from "node:crypto";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { homedir } from "node:os";
-import { dirname, resolve } from "node:path";
-import { parse, stringify } from "yaml";
-import { z } from "zod";
-const automation = z
-    .object({
-    syntaxChecks: z.enum(["auto", "off"]).default("auto"),
-    cacheClean: z.enum(["auto", "off"]).default("auto"),
-})
-    .strict()
-    .default({});
-const local = z.object({ type: z.literal("local"), root: z.string() }).strict();
-const warden = z
-    .object({
-    type: z.literal("warden"),
-    projectRoot: z.string(),
-    root: z.string(),
-    filesService: z.string().default("php-fpm"),
-    targets: z.record(z.string()).default({ default: "php-fpm" }),
-})
-    .strict();
-const ssh = z
-    .object({
-    type: z.literal("ssh"),
-    host: z.string().min(1),
-    root: z.string(),
-    writable: z.boolean().default(false),
-})
-    .strict();
-export const ConfigSchema = z
-    .object({
-    version: z.literal(1),
-    defaultEnvironment: z.string().optional(),
-    activeTheme: z.string().default("all"),
-    automation,
-    environments: z.record(z.union([local, warden, ssh])).default({}),
-})
-    .strict();
-export const template = {
-    version: 1,
-    defaultEnvironment: "default",
-    activeTheme: "all",
-    automation: { syntaxChecks: "auto", cacheClean: "auto" },
-    environments: {
-        default: { type: "local", root: "." },
-        warden: {
-            type: "warden",
-            projectRoot: ".",
-            root: "/var/www/html",
-            filesService: "php-fpm",
-            targets: { default: "php-fpm", debug: "php-debug" },
-        },
-        remote: {
-            type: "ssh",
-            host: "example1-stage",
-            root: "/var/www/html",
-            writable: false,
-        },
-    },
-};
-export function merchantHome(env = process.env) {
-    return env.MERCHANTDUO_HOME
-        ? resolve(env.MERCHANTDUO_HOME)
-        : resolve(homedir(), ".merchantduo");
-}
-export function interpolate(value, env = process.env) {
-    return value.replace(/\$\{([A-Z][A-Z0-9_]*)\}/g, (_, name) => {
-        if (!env[name])
-            throw new Error(`Missing required environment variable: ${name}`);
-        return env[name];
-    });
-}
-function expand(value, env) {
-    if (typeof value === "string")
-        return interpolate(value, env);
-    if (Array.isArray(value))
-        return value.map((v) => expand(v, env));
-    if (value && typeof value === "object")
-        return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, expand(v, env)]));
-    return value;
-}
-async function readYaml(path, env) {
-    try {
-        return parse(await readFile(path, "utf8"));
-    }
-    catch (e) {
-        if (e.code === "ENOENT")
-            return undefined;
-        throw new Error(`Cannot load ${path}: ${e.message}`);
-    }
-}
-export async function loadConfig(cwd, options = {}) {
-    const env = options.env ?? process.env;
-    const home = merchantHome(env);
-    const global = await readYaml(resolve(home, "config.yaml"), env);
-    const configPath = options.config ??
-        env.MERCHANTDUO_CONFIG ??
-        resolve(cwd, ".merchantduo.yaml");
-    const project = await readYaml(configPath, env);
-    const raw = {
-        ...(global ?? {}),
-        ...(project ?? {}),
-        environments: {
-            ...(global?.environments ?? {}),
-            ...(project?.environments ?? {}),
-        },
-    };
-    if (!project && !global)
-        return {
-            config: ConfigSchema.parse({
-                version: 1,
-                environments: { local: { type: "local", root: "." } },
-            }),
-        };
-    return {
-        config: ConfigSchema.parse(expand(raw, env)),
-        configPath: project ? resolve(configPath) : undefined,
-    };
-}
-/** Persist only the project-scoped theme selection and preserve all other YAML data. */
-export async function setActiveTheme(configPath, activeTheme, env = process.env) {
-    const source = await readFile(configPath, "utf8");
-    const raw = parse(source);
-    if (!raw || typeof raw !== "object" || Array.isArray(raw))
-        throw new Error(`Cannot update ${configPath}: expected a YAML object`);
-    const updated = { ...raw, activeTheme };
-    const config = ConfigSchema.parse(expand(updated, env));
-    await writeFile(configPath, stringify(updated), { mode: 0o600 });
-    return config;
-}
-export function selectEnvironment(config, cwd, requested, env = process.env) {
-    const name = requested ?? env.MERCHANTDUO_ENV ?? config.defaultEnvironment;
-    if (name) {
-        const environment = config.environments[name];
-        if (!environment)
-            throw new Error(`Unknown MerchantDuo environment: ${name}`);
-        return { name, environment };
-    }
-    return { name: "local", environment: { type: "local", root: cwd } };
-}
-export function configDigest(content) {
-    return createHash("sha256").update(content).digest("hex");
-}
-export async function trustProject(configPath, env = process.env) {
-    const digest = configDigest(await readFile(configPath, "utf8"));
-    const path = resolve(merchantHome(env), "trust.json");
-    await mkdir(dirname(path), { recursive: true, mode: 0o700 });
-    let trust = {};
-    try {
-        trust = JSON.parse(await readFile(path, "utf8"));
-    }
-    catch { }
-    trust[resolve(configPath)] = digest;
-    await writeFile(path, JSON.stringify(trust, null, 2), { mode: 0o600 });
-}
-export async function isTrusted(configPath, env = process.env) {
-    try {
-        const trust = JSON.parse(await readFile(resolve(merchantHome(env), "trust.json"), "utf8"));
-        return (trust[resolve(configPath)] ===
-            configDigest(await readFile(configPath, "utf8")));
-    }
-    catch {
-        return false;
-    }
-}
-export function starterYaml() {
-    return stringify(template);
-}

package/dist/config.test.js

@@ -1,51 +0,0 @@
-import assert from "node:assert/strict";
-import test from "node:test";
-import { mkdtemp, writeFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { configDigest, loadConfig, selectEnvironment, setActiveTheme } from "./config.js";
-import { contain, Backend } from "./backend.js";
-test("project environments replace global names and environment precedence is deterministic", async () => {
-    const root = await mkdtemp(join(tmpdir(), "merchantduo-"));
-    const home = join(root, "home");
-    await writeFile(join(root, ".merchantduo.yaml"), "version: 1\ndefaultEnvironment: stage\nenvironments:\n  stage:\n    type: local\n    root: app\n");
-    const { config } = await loadConfig(root, {
-        env: { MERCHANTDUO_HOME: home },
-    });
-    assert.equal(selectEnvironment(config, root, "stage").environment.type, "local");
-    assert.equal(selectEnvironment(config, root, undefined, { MERCHANTDUO_ENV: "stage" })
-        .name, "stage");
-});
-test("activeTheme defaults to all and persists without dropping other project settings", async () => {
-    const root = await mkdtemp(join(tmpdir(), "merchantduo-"));
-    const path = join(root, ".merchantduo.yaml");
-    await writeFile(path, "version: 1\ndefaultEnvironment: default\nenvironments:\n  default:\n    type: local\n    root: .\n");
-    assert.equal((await loadConfig(root)).config.activeTheme, "all");
-    const updated = await setActiveTheme(path, "Acme/store");
-    assert.equal(updated.activeTheme, "Acme/store");
-    assert.equal((await loadConfig(root)).config.defaultEnvironment, "default");
-});
-test("interpolation rejects missing variables and config digests are stable", async () => {
-    const root = await mkdtemp(join(tmpdir(), "merchantduo-"));
-    await writeFile(join(root, ".merchantduo.yaml"), "version: 1\nenvironments:\n  default:\n    type: local\n    root: ${MISSING}\n");
-    await assert.rejects(() => loadConfig(root, { env: {} }), /Missing required/);
-    assert.equal(configDigest("x"), configDigest("x"));
-    assert.notEqual(configDigest("x"), configDigest("y"));
-});
-test("backend contains local paths and constructs Warden target execution", () => {
-    assert.throws(() => contain("/project", "../outside"));
-    const b = new Backend({
-        type: "warden",
-        projectRoot: ".",
-        root: "/var/www/html",
-        filesService: "php-fpm",
-        targets: { debug: "php-debug" },
-    }, "/project");
-    assert.deepEqual(b.command(["php", "-v"], "debug").args.slice(0, 5), [
-        "env",
-        "exec",
-        "-T",
-        "php-debug",
-        "php",
-    ]);
-});

package/dist/constants.d.ts

@@ -1,20 +0,0 @@
-/** The only v1 location for intentionally non-production provider values. */
-export declare const PROVIDER: {
-    readonly id: "merchantduo";
-    readonly baseUrl: "https://merchantduo.invalid/v1";
-    readonly model: "merchantduo-mock";
-    readonly contextWindow: 32768;
-    readonly maxTokens: 4096;
-    readonly input: readonly ["text"];
-    readonly reasoning: false;
-    readonly cost: {
-        readonly input: 0;
-        readonly output: 0;
-        readonly cacheRead: 0;
-        readonly cacheWrite: 0;
-    };
-};
-export declare const PI_VERSION = "0.84.1";
-/** Replace this single beta placeholder with the production knowledge MCP endpoint. */
-export declare const KNOWLEDGE_MCP_URL = "https://merchantduo.invalid/mcp";
-export declare const KNOWLEDGE_MCP_TOKEN_ENV = "MERCHANTDUO_MCP_TOKEN";

package/dist/constants.js

@@ -1,15 +0,0 @@
-/** The only v1 location for intentionally non-production provider values. */
-export const PROVIDER = {
-    id: "merchantduo",
-    baseUrl: "https://merchantduo.invalid/v1",
-    model: "merchantduo-mock",
-    contextWindow: 32_768,
-    maxTokens: 4_096,
-    input: ["text"],
-    reasoning: false,
-    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
-};
-export const PI_VERSION = "0.84.1";
-/** Replace this single beta placeholder with the production knowledge MCP endpoint. */
-export const KNOWLEDGE_MCP_URL = "https://merchantduo.invalid/mcp";
-export const KNOWLEDGE_MCP_TOKEN_ENV = "MERCHANTDUO_MCP_TOKEN";

package/dist/mage2gen.test.js

@@ -1,6 +0,0 @@
-import assert from "node:assert/strict";
-import test from "node:test";
-import { mage2genDestination } from "./mage2gen.js";
-test("Mage2Gen module destinations stay under the selected project app/code root", () => {
-    assert.equal(mage2genDestination("/project", "Perspective", "FreshStocks"), "/project/app/code/Perspective/FreshStocks");
-});

package/dist/magento.d.ts

@@ -1,40 +0,0 @@
-import type { Backend } from "./backend.js";
-export type MagentoSnapshot = {
-    version?: string;
-    edition?: "Open Source" | "Adobe Commerce";
-    phpVersion?: string;
-    mode?: MagentoDeployMode;
-    cacheTypes: string[];
-    modulesEnabled?: number;
-    warnings: string[];
-    evidence: string[];
-    themes: MagentoTheme[];
-};
-export type MagentoDeployMode = "default" | "developer" | "production";
-export type MagentoTheme = {
-    code: string;
-    title?: string;
-    path: string;
-    parentChain: string[];
-    kind: "luma" | "hyva" | "other";
-};
-type RawTheme = {
-    code: string;
-    path: string;
-    title?: string;
-    parent?: string;
-};
-/**
- * Build a registered-theme graph. Metadata is accepted only from registration.php
- * locations and theme.xml values; malformed/missing parents remain non-fatal.
- */
-export declare function resolveThemes(themes: RawTheme[]): MagentoTheme[];
-export declare function parseRegisteredThemes(output: string): RawTheme[];
-/**
- * Accept only successful Magento CLI output that names one known deployment mode.
- * A failed or unrecognised probe must not influence operational recommendations.
- */
-export declare function parseDeployMode(output: string, exitCode: number): MagentoDeployMode | undefined;
-export declare function snapshot(backend: Backend): Promise<MagentoSnapshot>;
-export declare function snapshotPrompt(envName: string, writable: boolean, status: string, s: MagentoSnapshot): string;
-export {};