domagic-turbopack-plugin 1.1.25 → 1.1.27

package/dist/cli.js

@@ -1,16 +1,76 @@
 #!/usr/bin/env node
+import { initDomagicTurbopackProject } from './init.js';
 import { startDomagicTurbopackServer } from './server.js';
-const port = parseNumberArg('--port') ?? parseNumberEnv('DOMAGIC_TURBOPACK_PORT');
-const host = parseStringArg('--host') ?? process.env.DOMAGIC_TURBOPACK_HOST;
-startDomagicTurbopackServer({
-    host,
-    port,
-    agent: {
-        provider: parseProviderArg('--provider') ?? parseProviderEnv('DOMAGIC_AGENT_PROVIDER'),
-        command: parseStringArg('--command'),
-        cwd: parseStringArg('--cwd'),
-    },
-});
+void main();
+async function main() {
+    const command = getCliCommand();
+    if (command === 'init') {
+        await runInitCommand();
+        return;
+    }
+    if (command === 'help' || command === '--help' || command === '-h') {
+        printHelp();
+        return;
+    }
+    if (command && command !== 'server') {
+        console.error(`[domagic] Unknown command: ${command}`);
+        printHelp();
+        process.exitCode = 1;
+        return;
+    }
+    startServerCommand();
+}
+async function runInitCommand() {
+    try {
+        const result = await initDomagicTurbopackProject({
+            cwd: parseStringArg('--cwd'),
+        });
+        const scriptAction = result.scriptStatus === 'added'
+            ? '已写入 package.json script'
+            : 'package.json 已存在 script，未覆盖';
+        console.log(`[domagic] ${scriptAction}: domagic-server -> ${result.scriptCommand}`);
+        if (result.agent) {
+            console.log(`[domagic] 已自动检测本地 agent: ${result.agent.provider}`);
+            console.log(`[domagic] agent command: ${result.agent.command}`);
+            console.log(`[domagic] 已写入配置: ${result.configPath}`);
+        }
+        else {
+            console.log('[domagic] 未检测到可用的本地 agent，可稍后在 DOMagic 面板中配置。');
+        }
+        console.log('[domagic] 启动服务: npm run domagic-server');
+    }
+    catch (error) {
+        console.error(`[domagic] init failed: ${formatError(error)}`);
+        process.exitCode = 1;
+    }
+}
+function startServerCommand() {
+    const port = parseNumberArg('--port') ?? parseNumberEnv('DOMAGIC_TURBOPACK_PORT');
+    const host = parseStringArg('--host') ?? process.env.DOMAGIC_TURBOPACK_HOST;
+    startDomagicTurbopackServer({
+        host,
+        port,
+        agent: {
+            provider: parseProviderArg('--provider') ?? parseProviderEnv('DOMAGIC_AGENT_PROVIDER'),
+            command: parseStringArg('--command'),
+            cwd: parseStringArg('--cwd'),
+        },
+    });
+}
+function getCliCommand() {
+    const firstArg = process.argv[2];
+    return firstArg && !firstArg.startsWith('-') ? firstArg : undefined;
+}
+function printHelp() {
+    console.log([
+        'Usage:',
+        '  domagic-turbopack-plugin init [--cwd <project-root>]',
+        '  domagic-turbopack-plugin server [--host <host>] [--port <port>] [--provider <provider>] [--command <agent-command>] [--cwd <project-root>]',
+        '',
+        'Compatibility:',
+        '  domagic-turbopack-server [options]  # starts the server',
+    ].join('\n'));
+}
 function parseNumberArg(name) {
     const index = process.argv.indexOf(name);
     const value = index >= 0 ? process.argv[index + 1] : undefined;
@@ -49,3 +109,6 @@ function parseNumberEnv(name) {
     const parsed = Number(value);
     return Number.isFinite(parsed) ? parsed : undefined;
 }
+function formatError(error) {
+    return error instanceof Error ? error.message : String(error);
+}

package/dist/init.d.ts

@@ -0,0 +1,20 @@
+type AgentProvider = 'codex' | 'claude-code' | 'gemini' | 'generic-cli';
+export type DomagicTurbopackInitResult = {
+    projectRoot: string;
+    packageJsonPath: string;
+    scriptStatus: 'added' | 'exists';
+    scriptCommand: string;
+    configPath: string;
+    agent?: {
+        provider: AgentProvider;
+        command: string;
+        cwd: string;
+    };
+};
+type CommandLookup = (command: string) => string | null;
+export declare function initDomagicTurbopackProject(input?: {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    lookupCommand?: CommandLookup;
+}): Promise<DomagicTurbopackInitResult>;
+export {};

package/dist/init.js

@@ -0,0 +1,179 @@
+import path from 'node:path';
+import { accessSync, constants } from 'node:fs';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+const DOMAGIC_SERVER_SCRIPT_NAME = 'domagic-server';
+const DOMAGIC_SERVER_SCRIPT_COMMAND = 'domagic-turbopack-plugin server';
+const DOMAGIC_CONFIG_DIRECTORY_NAME = '.domagic';
+const DOMAGIC_AGENT_CONFIG_FILE_NAME = 'agent-config.json';
+const DEFAULT_PROVIDER_PRIORITY = [
+    'codex',
+    'claude-code',
+    'gemini',
+];
+export async function initDomagicTurbopackProject(input = {}) {
+    const projectRoot = path.resolve(input.cwd ?? process.cwd());
+    const packageJsonPath = path.join(projectRoot, 'package.json');
+    const packageJson = await readPackageJson(packageJsonPath);
+    const scriptStatus = writeDomagicServerScript(packageJson);
+    await writeFile(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`, 'utf8');
+    const configPath = path.join(projectRoot, DOMAGIC_CONFIG_DIRECTORY_NAME, DOMAGIC_AGENT_CONFIG_FILE_NAME);
+    const agent = await detectLocalAgent({
+        projectRoot,
+        env: input.env ?? process.env,
+        lookupCommand: input.lookupCommand ?? createPathLookup(input.env ?? process.env),
+    });
+    if (agent) {
+        await writeAgentConfig(configPath, agent);
+    }
+    else {
+        await mkdir(path.dirname(configPath), { recursive: true });
+    }
+    return {
+        projectRoot,
+        packageJsonPath,
+        scriptStatus,
+        scriptCommand: DOMAGIC_SERVER_SCRIPT_COMMAND,
+        configPath,
+        agent,
+    };
+}
+async function readPackageJson(packageJsonPath) {
+    let source;
+    try {
+        source = await readFile(packageJsonPath, 'utf8');
+    }
+    catch (error) {
+        throw new Error(`DOMagic init 未找到 package.json：${packageJsonPath}，请在 Next.js 项目根目录执行。`, {
+            cause: error,
+        });
+    }
+    try {
+        const parsed = JSON.parse(source);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new Error('package.json root must be an object');
+        }
+        return parsed;
+    }
+    catch (error) {
+        throw new Error(`DOMagic init 无法解析 package.json：${formatError(error)}`);
+    }
+}
+function writeDomagicServerScript(packageJson) {
+    const scripts = packageJson.scripts && typeof packageJson.scripts === 'object'
+        ? packageJson.scripts
+        : {};
+    packageJson.scripts = scripts;
+    if (typeof scripts[DOMAGIC_SERVER_SCRIPT_NAME] === 'string' && scripts[DOMAGIC_SERVER_SCRIPT_NAME].trim()) {
+        return 'exists';
+    }
+    scripts[DOMAGIC_SERVER_SCRIPT_NAME] = DOMAGIC_SERVER_SCRIPT_COMMAND;
+    return 'added';
+}
+async function detectLocalAgent(input) {
+    const explicit = detectExplicitAgent(input.env, input.lookupCommand);
+    if (explicit) {
+        return {
+            ...explicit,
+            cwd: input.projectRoot,
+        };
+    }
+    for (const provider of DEFAULT_PROVIDER_PRIORITY) {
+        for (const command of getProviderCommandCandidates(provider)) {
+            const resolved = input.lookupCommand(command);
+            if (resolved) {
+                return {
+                    provider,
+                    command: resolved,
+                    cwd: input.projectRoot,
+                };
+            }
+        }
+    }
+    return undefined;
+}
+function detectExplicitAgent(env, lookupCommand) {
+    const genericCommand = env.DOMAGIC_AGENT_CMD?.trim();
+    if (genericCommand) {
+        return {
+            provider: 'generic-cli',
+            command: genericCommand,
+        };
+    }
+    for (const [provider, envName] of [
+        ['codex', 'DOMAGIC_CODEX_CMD'],
+        ['claude-code', 'DOMAGIC_CLAUDE_CODE_CMD'],
+        ['gemini', 'DOMAGIC_GEMINI_CMD'],
+    ]) {
+        const configured = env[envName]?.trim();
+        if (configured) {
+            return {
+                provider,
+                command: configured,
+            };
+        }
+    }
+    const provider = parseAgentProvider(env.DOMAGIC_AGENT_PROVIDER);
+    if (!provider || provider === 'generic-cli') {
+        return undefined;
+    }
+    for (const command of getProviderCommandCandidates(provider)) {
+        const resolved = lookupCommand(command);
+        if (resolved) {
+            return {
+                provider,
+                command: resolved,
+            };
+        }
+    }
+    return undefined;
+}
+function parseAgentProvider(value) {
+    const provider = value?.trim();
+    if (provider === 'codex' ||
+        provider === 'claude-code' ||
+        provider === 'gemini' ||
+        provider === 'generic-cli') {
+        return provider;
+    }
+    return undefined;
+}
+function getProviderCommandCandidates(provider) {
+    if (provider === 'codex') {
+        return ['codex'];
+    }
+    if (provider === 'claude-code') {
+        return ['claude', 'claude-code'];
+    }
+    return ['gemini', 'gemini-cli'];
+}
+function createPathLookup(env) {
+    const pathEntries = (env.PATH ?? '').split(path.delimiter).filter(Boolean);
+    return (command) => {
+        if (command.includes(path.sep)) {
+            return command;
+        }
+        for (const entry of pathEntries) {
+            const candidate = path.join(entry, command);
+            if (isExecutable(candidate)) {
+                return candidate;
+            }
+        }
+        return null;
+    };
+}
+function isExecutable(file) {
+    try {
+        accessSync(file, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function writeAgentConfig(configPath, agent) {
+    await mkdir(path.dirname(configPath), { recursive: true });
+    await writeFile(configPath, `${JSON.stringify({ agent }, null, 2)}\n`, 'utf8');
+}
+function formatError(error) {
+    return error instanceof Error ? error.message : String(error);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "domagic-turbopack-plugin",
-  "version": "1.1.25",
+  "version": "1.1.27",
   "description": "A development-only Turbopack adapter for DOM source mapping and AI-assisted style edits.",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,6 +25,7 @@
     }
   },
   "bin": {
+    "domagic-turbopack-plugin": "dist/cli.js",
     "domagic-turbopack-server": "dist/cli.js"
   },
   "files": [
@@ -48,7 +49,7 @@
     "test": "vitest run --config vitest.config.ts"
   },
   "dependencies": {
-    "domagic-vite-plugin": "1.1.25",
+    "domagic-vite-plugin": "1.1.27",
     "typescript": "^5.9.3"
   },
   "peerDependencies": {