godot-cli 0.2.0 → 0.4.0

package/dist/commands/create-project.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const createProjectCommand: Command;

package/dist/commands/create-project.js

@@ -0,0 +1,49 @@
+import { Command } from 'commander';
+import * as path from 'path';
+import * as ui from '../utils/ui.js';
+import { verbose } from '../utils/ui.js';
+import { createProject } from '../lib/create-project.js';
+export const createProjectCommand = new Command('create-project')
+    .description('Scaffold a minimal valid Godot 4.x project (project.godot + icon.svg). Pass --dotnet to also scaffold a Godot.NET.Sdk (C#) csproj. Refuses to overwrite an existing Godot/Unity/Unreal project.')
+    .argument('[path]', 'Target directory to scaffold the project into (defaults to current directory)')
+    .option('--path <path>', 'Target directory to scaffold the project into')
+    .option('--name <name>', 'Project name (defaults to a name derived from the folder name)')
+    .option('--dotnet', 'Also scaffold a Godot.NET.Sdk (C#) csproj')
+    .action(async (positionalPath, options) => {
+    const resolvedPath = positionalPath ?? options.path ?? process.cwd();
+    const projectPath = path.resolve(resolvedPath);
+    ui.heading('Creating Godot project');
+    verbose(`Target path: ${projectPath}`);
+    verbose(`--dotnet: ${options.dotnet === true}`);
+    const spinner = ui.startSpinner('Scaffolding project...');
+    const result = await createProject({
+        projectPath,
+        name: options.name,
+        dotnet: options.dotnet === true,
+    });
+    if (result.kind === 'failure') {
+        spinner.error('Failed to create project');
+        ui.error(result.errorMessage);
+        // Surface failure-shape diagnostics BEFORE exiting: leftover files a
+        // partial rollback could not remove, plus any rollback warnings.
+        if (result.filesWritten.length > 0) {
+            ui.label('Files left behind (cleanup failed)', result.filesWritten.join(', '));
+        }
+        for (const warning of result.warnings) {
+            console.log('');
+            ui.warn(warning);
+        }
+        process.exit(1);
+    }
+    spinner.success(`Created Godot project "${result.projectName}"`);
+    ui.label('Project path', result.projectPath);
+    ui.label('Files written', result.filesWritten.join(', '));
+    if (result.dotnet) {
+        ui.label('C# (.NET)', 'enabled');
+    }
+    for (const warning of result.warnings) {
+        console.log('');
+        ui.warn(warning);
+    }
+});
+//# sourceMappingURL=create-project.js.map

package/dist/commands/create-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-project.js","sourceRoot":"","sources":["../../src/commands/create-project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAQzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,OAAO,CAAC,gBAAgB,CAAC;KAC9D,WAAW,CACV,iMAAiM,CAClM;KACA,QAAQ,CAAC,QAAQ,EAAE,+EAA+E,CAAC;KACnG,MAAM,CAAC,eAAe,EAAE,+CAA+C,CAAC;KACxE,MAAM,CAAC,eAAe,EAAE,gEAAgE,CAAC;KACzF,MAAM,CAAC,UAAU,EAAE,2CAA2C,CAAC;KAC/D,MAAM,CAAC,KAAK,EAAE,cAAkC,EAAE,OAAgC,EAAE,EAAE;IACrF,MAAM,YAAY,GAAG,cAAc,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACrE,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAE/C,EAAE,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACrC,OAAO,CAAC,gBAAgB,WAAW,EAAE,CAAC,CAAC;IACvC,OAAO,CAAC,aAAa,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;IAEhD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,wBAAwB,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;QACjC,WAAW;QACX,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,IAAI;KAChC,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC1C,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC9B,qEAAqE;QACrE,iEAAiE;QACjE,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,EAAE,CAAC,KAAK,CAAC,oCAAoC,EAAE,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACjF,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,OAAO,CAAC,0BAA0B,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC;IACjE,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAC7C,EAAE,CAAC,KAAK,CAAC,eAAe,EAAE,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/index.js

@@ -7,6 +7,7 @@ import { statusCommand } from './commands/status.js';
 import { waitForReadyCommand } from './commands/wait-for-ready.js';
 import { setupMcpCommand } from './commands/setup-mcp.js';
 import { configureCommand } from './commands/configure.js';
+import { createProjectCommand } from './commands/create-project.js';
 import { closeCommand } from './commands/close.js';
 import { createUpdateCommand } from './commands/update.js';
 import { installPluginCommand } from './commands/install-plugin.js';
@@ -25,6 +26,7 @@ program
 const subcommands = [
     closeCommand,
     configureCommand,
+    createProjectCommand,
     installPluginCommand,
     openCommand,
     removePluginCommand,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,KAAK,IAAI,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEnG,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAE9D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,kDAAkD,CAAC;KAC/D,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;KACpB,MAAM,CAAC,eAAe,EAAE,kCAAkC,CAAC,CAAC;AAE/D,2BAA2B;AAC3B,MAAM,WAAW,GAAG;IAClB,YAAY;IACZ,gBAAgB;IAChB,oBAAoB;IACpB,WAAW;IACX,mBAAmB;IACnB,cAAc;IACd,oBAAoB;IACpB,eAAe;IACf,aAAa;IACb,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC;IAChC,mBAAmB;CACpB,CAAC;AAEF,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;IAC9B,GAAG,CAAC,MAAM,CAAC,eAAe,EAAE,kCAAkC,CAAC,CAAC;IAChE,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACzB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,2EAA2E;AAC3E,mBAAmB,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;AAE1C,gDAAgD;AAChD,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,EAAE;IACxD,MAAM,IAAI,GAAG,aAAa,CAAC,eAAe,EAA2B,CAAC;IACtE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,UAAU,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,qCAAqC;AACrC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE;IAClB,OAAO,CAAC,UAAU,EAAE,CAAC;AACvB,CAAC,CAAC,CAAC;AAEH,mFAAmF;AACnF,MAAM,kBAAkB,GAAG,eAAe,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAEnG,OAAO,CAAC,UAAU,EAAE;KACjB,IAAI,CAAC,KAAK,IAAI,EAAE;IACf,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC;IACxC,IAAI,MAAM,EAAE,CAAC;QACX,uBAAuB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACzD,CAAC;AACH,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACb,OAAO,CAAE,GAAa,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/create-project.d.ts

@@ -0,0 +1,88 @@
+import type { CreateProjectOptions, CreateProjectResult } from './types.js';
+/**
+ * `Godot.NET.Sdk` version pinned into a scaffolded `--dotnet` csproj. Matches
+ * the addon's own min-version floor (`Godot-MCP.csproj` pins `4.3.0`) and the
+ * `config/features` "4.3" floor written into `project.godot`. A consumer can
+ * bump this to their editor version freely; the scaffold targets the floor so
+ * the generated project opens in any Godot 4.3+ editor.
+ */
+export declare const GODOT_SDK_VERSION = "4.3.0";
+/**
+ * Default `icon.svg` written into a scaffolded project — a self-contained,
+ * valid SVG using Godot's signature rounded-rect blue background. Mirrors the
+ * shape of the icon Godot writes for a fresh project (the exact glyph differs;
+ * what matters is a valid default icon the editor can load at `res://icon.svg`).
+ */
+export declare const DEFAULT_ICON_SVG = "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"128\" height=\"128\" viewBox=\"0 0 128 128\">\n  <rect width=\"124\" height=\"124\" x=\"2\" y=\"2\" fill=\"#363d52\" stroke=\"#212532\" stroke-width=\"4\" rx=\"14\"/>\n  <g fill=\"#fff\">\n    <circle cx=\"48\" cy=\"58\" r=\"10\"/>\n    <circle cx=\"80\" cy=\"58\" r=\"10\"/>\n    <rect x=\"40\" y=\"82\" width=\"48\" height=\"8\" rx=\"4\"/>\n  </g>\n</svg>\n";
+/** Engine project marker detected when refusing to scaffold over an existing project. */
+export type ProjectMarkerEngine = 'godot' | 'unity' | 'unreal';
+/**
+ * Derive the project name from an explicit option, falling back to the target
+ * folder's base name. Returns `GodotProject` only when both are empty. Pure.
+ */
+export declare function deriveProjectName(projectPath: string, explicitName?: string): string;
+/**
+ * The `[dotnet] project/assembly_name` value AND the csproj filename. Godot
+ * itself permits hyphens here (the infra testbed uses `Godot-Test-Project`), so
+ * the name is kept verbatim apart from trimming; falls back when empty. Pure.
+ */
+export declare function toAssemblyName(projectName: string): string;
+/**
+ * The csproj `<RootNamespace>` — must be a valid C# identifier, so every char
+ * that is not a letter/digit/underscore is stripped and a leading digit is
+ * prefixed with `_`. Mirrors the testbed's `Godot-Test-Project` ->
+ * `GodotTestProject` derivation. Pure.
+ */
+export declare function toRootNamespace(projectName: string): string;
+/**
+ * Escape a string for embedding inside a double-quoted Godot `ConfigFile`
+ * value (the `project.godot` format): backslash -> `\\` and double-quote ->
+ * `\"`. Without this, a name containing `"` or `\` produces a `project.godot`
+ * Godot cannot parse — or, worse, lets a crafted name inject arbitrary config
+ * keys. Pure. Exported for unit tests.
+ */
+export declare function escapeGodotConfigString(value: string): string;
+/**
+ * Validate a project name before any filesystem write. Rejected when the name
+ * would corrupt the generated `project.godot` (line breaks inside a quoted
+ * `ConfigFile` string) or would escape / break the `--dotnet` csproj filename
+ * (path separators, `..` traversal, or characters illegal in a filename).
+ * Returns a human-readable reason when invalid, or `null` when safe. Pure.
+ */
+export declare function validateProjectName(projectName: string): string | null;
+/**
+ * Detect whether `dir` already hosts a project for any supported engine and, if
+ * so, which marker file proves it. Checks (in order) a Godot `project.godot`, a
+ * Unity `ProjectSettings/ProjectVersion.txt`, and any Unreal `*.uproject` file
+ * directly inside `dir`. Returns `null` when no marker is present (including
+ * when `dir` does not exist). Side-effect-free beyond read-only `fs` probing.
+ */
+export declare function detectExistingProjectMarker(dir: string): {
+    engine: ProjectMarkerEngine;
+    markerPath: string;
+} | null;
+/**
+ * Render the body of a minimal valid Godot 4.x `project.godot`
+ * (`config_version=5`). When `dotnet` is set, adds the `"C#"` feature and a
+ * `[dotnet]` section carrying the assembly name. Pure. Exported for unit tests.
+ */
+export declare function renderProjectGodot(projectName: string, dotnet: boolean): string;
+/**
+ * Render a `Godot.NET.Sdk` csproj matching the infra `Godot-Test-Project/`
+ * reference shape (Sdk + `net8.0` + `Nullable` + `RootNamespace`). The testbed's
+ * addon-specific `PackageReference`s are intentionally NOT included — a freshly
+ * scaffolded project is not necessarily an addon consumer. Pure. Exported for
+ * unit tests.
+ */
+export declare function renderCsproj(projectName: string): string;
+/**
+ * Scaffold a minimal valid Godot 4.x project — the library-callable equivalent
+ * of the `create-project` CLI command. Library-safe: never calls
+ * `process.exit`, never prints, never throws past the public boundary.
+ *
+ * Writes `project.godot` (`config_version=5`) + `icon.svg`, plus a
+ * `Godot.NET.Sdk` csproj when `dotnet` is set. Refuses (structured failure, no
+ * writes) when the target already contains a Godot/Unity/Unreal project marker.
+ * Pure `fs` operations only — no Godot binary required.
+ */
+export declare function createProject(options: CreateProjectOptions): Promise<CreateProjectResult>;

package/dist/lib/create-project.js

@@ -0,0 +1,314 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { resolveProjectPath } from './open.js';
+import { emitProgress } from './progress.js';
+/**
+ * `Godot.NET.Sdk` version pinned into a scaffolded `--dotnet` csproj. Matches
+ * the addon's own min-version floor (`Godot-MCP.csproj` pins `4.3.0`) and the
+ * `config/features` "4.3" floor written into `project.godot`. A consumer can
+ * bump this to their editor version freely; the scaffold targets the floor so
+ * the generated project opens in any Godot 4.3+ editor.
+ */
+export const GODOT_SDK_VERSION = '4.3.0';
+/**
+ * Default `icon.svg` written into a scaffolded project — a self-contained,
+ * valid SVG using Godot's signature rounded-rect blue background. Mirrors the
+ * shape of the icon Godot writes for a fresh project (the exact glyph differs;
+ * what matters is a valid default icon the editor can load at `res://icon.svg`).
+ */
+export const DEFAULT_ICON_SVG = `<svg xmlns="http://www.w3.org/2000/svg" width="128" height="128" viewBox="0 0 128 128">
+  <rect width="124" height="124" x="2" y="2" fill="#363d52" stroke="#212532" stroke-width="4" rx="14"/>
+  <g fill="#fff">
+    <circle cx="48" cy="58" r="10"/>
+    <circle cx="80" cy="58" r="10"/>
+    <rect x="40" y="82" width="48" height="8" rx="4"/>
+  </g>
+</svg>
+`;
+/**
+ * Derive the project name from an explicit option, falling back to the target
+ * folder's base name. Returns `GodotProject` only when both are empty. Pure.
+ */
+export function deriveProjectName(projectPath, explicitName) {
+    const trimmed = explicitName?.trim();
+    if (trimmed)
+        return trimmed;
+    const base = path.basename(path.resolve(projectPath));
+    return base.length > 0 ? base : 'GodotProject';
+}
+/**
+ * The `[dotnet] project/assembly_name` value AND the csproj filename. Godot
+ * itself permits hyphens here (the infra testbed uses `Godot-Test-Project`), so
+ * the name is kept verbatim apart from trimming; falls back when empty. Pure.
+ */
+export function toAssemblyName(projectName) {
+    const cleaned = projectName.trim();
+    return cleaned.length > 0 ? cleaned : 'GodotProject';
+}
+/**
+ * The csproj `<RootNamespace>` — must be a valid C# identifier, so every char
+ * that is not a letter/digit/underscore is stripped and a leading digit is
+ * prefixed with `_`. Mirrors the testbed's `Godot-Test-Project` ->
+ * `GodotTestProject` derivation. Pure.
+ */
+export function toRootNamespace(projectName) {
+    const cleaned = projectName.replace(/[^A-Za-z0-9_]/g, '');
+    if (cleaned.length === 0)
+        return 'GodotProject';
+    return /^[0-9]/.test(cleaned) ? `_${cleaned}` : cleaned;
+}
+/**
+ * Escape a string for embedding inside a double-quoted Godot `ConfigFile`
+ * value (the `project.godot` format): backslash -> `\\` and double-quote ->
+ * `\"`. Without this, a name containing `"` or `\` produces a `project.godot`
+ * Godot cannot parse — or, worse, lets a crafted name inject arbitrary config
+ * keys. Pure. Exported for unit tests.
+ */
+export function escapeGodotConfigString(value) {
+    return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+/**
+ * Validate a project name before any filesystem write. Rejected when the name
+ * would corrupt the generated `project.godot` (line breaks inside a quoted
+ * `ConfigFile` string) or would escape / break the `--dotnet` csproj filename
+ * (path separators, `..` traversal, or characters illegal in a filename).
+ * Returns a human-readable reason when invalid, or `null` when safe. Pure.
+ */
+export function validateProjectName(projectName) {
+    if (/[\r\n]/.test(projectName))
+        return 'must not contain line breaks';
+    if (/[/\\]/.test(projectName))
+        return 'must not contain path separators ("/" or "\\")';
+    if (projectName.includes('..'))
+        return 'must not contain ".." path segments';
+    if (/[<>:"|?*]/.test(projectName))
+        return 'must not contain reserved characters (< > : " | ? *)';
+    return null;
+}
+/**
+ * Detect whether `dir` already hosts a project for any supported engine and, if
+ * so, which marker file proves it. Checks (in order) a Godot `project.godot`, a
+ * Unity `ProjectSettings/ProjectVersion.txt`, and any Unreal `*.uproject` file
+ * directly inside `dir`. Returns `null` when no marker is present (including
+ * when `dir` does not exist). Side-effect-free beyond read-only `fs` probing.
+ */
+export function detectExistingProjectMarker(dir) {
+    const godot = path.join(dir, 'project.godot');
+    if (fs.existsSync(godot))
+        return { engine: 'godot', markerPath: godot };
+    const unity = path.join(dir, 'ProjectSettings', 'ProjectVersion.txt');
+    if (fs.existsSync(unity))
+        return { engine: 'unity', markerPath: unity };
+    if (fs.existsSync(dir)) {
+        try {
+            const uproject = fs
+                .readdirSync(dir)
+                .find((entry) => entry.toLowerCase().endsWith('.uproject'));
+            if (uproject)
+                return { engine: 'unreal', markerPath: path.join(dir, uproject) };
+        }
+        catch {
+            // A readdir failure here is not a marker; the scaffold's own mkdir/write
+            // below will surface any real filesystem error as a structured failure.
+        }
+    }
+    return null;
+}
+/**
+ * Render the body of a minimal valid Godot 4.x `project.godot`
+ * (`config_version=5`). When `dotnet` is set, adds the `"C#"` feature and a
+ * `[dotnet]` section carrying the assembly name. Pure. Exported for unit tests.
+ */
+export function renderProjectGodot(projectName, dotnet) {
+    const features = dotnet ? 'PackedStringArray("4.3", "C#")' : 'PackedStringArray("4.3")';
+    const dotnetSection = dotnet
+        ? `\n[dotnet]\n\nproject/assembly_name="${escapeGodotConfigString(toAssemblyName(projectName))}"\n`
+        : '';
+    return `; Engine configuration file.
+; It's best edited using the editor UI and not directly,
+; since the parameters that go here are not all obvious.
+;
+; Format:
+;   [section] ; section goes between []
+;   param=value ; assign values to parameters
+
+config_version=5
+
+[application]
+
+config/name="${escapeGodotConfigString(projectName)}"
+config/features=${features}
+config/icon="res://icon.svg"
+${dotnetSection}`;
+}
+/**
+ * Render a `Godot.NET.Sdk` csproj matching the infra `Godot-Test-Project/`
+ * reference shape (Sdk + `net8.0` + `Nullable` + `RootNamespace`). The testbed's
+ * addon-specific `PackageReference`s are intentionally NOT included — a freshly
+ * scaffolded project is not necessarily an addon consumer. Pure. Exported for
+ * unit tests.
+ */
+export function renderCsproj(projectName) {
+    return `<Project Sdk="Godot.NET.Sdk/${GODOT_SDK_VERSION}">
+
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <EnableDynamicLoading>true</EnableDynamicLoading>
+    <Nullable>enable</Nullable>
+    <RootNamespace>${toRootNamespace(projectName)}</RootNamespace>
+  </PropertyGroup>
+
+</Project>
+`;
+}
+/**
+ * Scaffold a minimal valid Godot 4.x project — the library-callable equivalent
+ * of the `create-project` CLI command. Library-safe: never calls
+ * `process.exit`, never prints, never throws past the public boundary.
+ *
+ * Writes `project.godot` (`config_version=5`) + `icon.svg`, plus a
+ * `Godot.NET.Sdk` csproj when `dotnet` is set. Refuses (structured failure, no
+ * writes) when the target already contains a Godot/Unity/Unreal project marker.
+ * Pure `fs` operations only — no Godot binary required.
+ */
+export async function createProject(options) {
+    const warnings = [];
+    const filesWritten = [];
+    // Original bytes of any pre-existing file we overwrite, so a failed scaffold
+    // can RESTORE the caller's file rather than delete it during rollback.
+    const overwrittenOriginals = new Map();
+    let resolvedProjectPath;
+    let projectDirExistedBefore = true;
+    try {
+        const { projectPath } = resolveProjectPath(options.projectPath, process.cwd());
+        resolvedProjectPath = projectPath;
+        const dotnet = options.dotnet === true;
+        const projectName = deriveProjectName(projectPath, options.name);
+        // Validate the name BEFORE any writes — line breaks would corrupt the
+        // quoted `project.godot` strings, and path separators / `..` / reserved
+        // chars would let a crafted `--dotnet` csproj filename escape the target.
+        const nameError = validateProjectName(projectName);
+        if (nameError) {
+            const hint = options.name?.trim()
+                ? ''
+                : ' (derived from the target folder name — pass --name to override)';
+            throw new Error(`Invalid project name "${projectName}": ${nameError}.${hint}`);
+        }
+        emitProgress(options.onProgress, {
+            phase: 'start',
+            message: `Creating Godot project at ${projectPath}`,
+        });
+        // Refuse to scaffold over an existing project of ANY engine BEFORE writing.
+        const existing = detectExistingProjectMarker(projectPath);
+        if (existing) {
+            throw new Error(`Refusing to scaffold: target already contains a ${existing.engine} project marker (${existing.markerPath}).`);
+        }
+        // Create the target directory (and any parents) if absent. Record whether
+        // it pre-existed so a failed scaffold can remove a directory it created
+        // (but never one the caller already had).
+        projectDirExistedBefore = fs.existsSync(projectPath);
+        fs.mkdirSync(projectPath, { recursive: true });
+        // Write one file, recording it for rollback and warning when an existing
+        // non-marker file is clobbered.
+        const writeFile = (filePath, contents) => {
+            // Only a pre-existing regular FILE is an overwrite worth warning about /
+            // snapshotting; a directory at this path isn't a file we can clobber (the
+            // write below will throw), so it must not produce a phantom warning.
+            if (fs.existsSync(filePath) && fs.statSync(filePath).isFile()) {
+                warnings.push(`Overwrote existing file: ${filePath}`);
+                // Snapshot the caller's original bytes (once) so rollback restores them
+                // instead of deleting a file they already had. If the read fails, fall
+                // back to delete-on-rollback (best-effort).
+                if (!overwrittenOriginals.has(filePath)) {
+                    try {
+                        overwrittenOriginals.set(filePath, fs.readFileSync(filePath));
+                    }
+                    catch {
+                        // Unreadable: treat as freshly-written (rmSync on rollback).
+                    }
+                }
+            }
+            fs.writeFileSync(filePath, contents);
+            filesWritten.push(filePath);
+        };
+        // Write the icon and (optional) csproj first, then `project.godot` LAST so
+        // the engine marker only exists once the scaffold fully succeeds — a
+        // mid-write failure leaves no marker to brick a corrected retry.
+        const iconPath = path.join(projectPath, 'icon.svg');
+        writeFile(iconPath, DEFAULT_ICON_SVG);
+        if (dotnet) {
+            const csprojPath = path.join(projectPath, `${toAssemblyName(projectName)}.csproj`);
+            writeFile(csprojPath, renderCsproj(projectName));
+        }
+        const projectGodotPath = path.join(projectPath, 'project.godot');
+        writeFile(projectGodotPath, renderProjectGodot(projectName, dotnet));
+        emitProgress(options.onProgress, {
+            phase: 'project-scaffolded',
+            message: `Scaffolded ${filesWritten.length} file(s)`,
+            projectPath,
+        });
+        emitProgress(options.onProgress, { phase: 'done', message: 'Project created.' });
+        return {
+            kind: 'success',
+            success: true,
+            projectPath,
+            projectName,
+            dotnet,
+            filesWritten,
+            warnings,
+        };
+    }
+    catch (err) {
+        // Roll back any files written before the failure (best-effort, reverse
+        // order) so a failed/refused scaffold leaves the target as it was found.
+        // A file we OVERWROTE is restored to its original bytes (never deleted —
+        // that would leave the caller with less than they started with); a file we
+        // freshly created is removed. Only entries whose cleanup FAILED stay in
+        // `leftover` — honouring the CreateProjectFailure.filesWritten contract
+        // (non-empty only when a partial scaffold could not be fully cleaned up).
+        const leftover = [];
+        for (const filePath of [...filesWritten].reverse()) {
+            try {
+                const original = overwrittenOriginals.get(filePath);
+                if (original !== undefined) {
+                    fs.writeFileSync(filePath, original);
+                    // The overwrite was reverted, so drop the now-inaccurate warning.
+                    const idx = warnings.indexOf(`Overwrote existing file: ${filePath}`);
+                    if (idx !== -1)
+                        warnings.splice(idx, 1);
+                }
+                else {
+                    fs.rmSync(filePath, { force: true });
+                }
+            }
+            catch {
+                warnings.push(`Failed to roll back partially-written file: ${filePath}`);
+                leftover.push(filePath);
+            }
+        }
+        // We iterated in reverse for cleanup; restore write order for the contract.
+        leftover.reverse();
+        // If we created the target directory and rollback emptied it, remove it too
+        // so a failed scaffold leaves the target as it was found. Best-effort: a
+        // non-empty dir (pre-existing sibling content) keeps the rmdir from firing.
+        if (resolvedProjectPath && !projectDirExistedBefore && leftover.length === 0) {
+            try {
+                fs.rmdirSync(resolvedProjectPath);
+            }
+            catch {
+                // Directory not empty or already gone — leave it; cleanup is best-effort.
+            }
+        }
+        const errorObj = err instanceof Error ? err : new Error(String(err));
+        return {
+            kind: 'failure',
+            success: false,
+            projectPath: resolvedProjectPath,
+            warnings,
+            filesWritten: leftover,
+            errorMessage: errorObj.message,
+            error: errorObj,
+        };
+    }
+}
+//# sourceMappingURL=create-project.js.map

package/dist/lib/create-project.js.map

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

package/dist/lib/types.d.ts

@@ -9,6 +9,10 @@ export type ProgressEvent = {
     phase: 'manifest-patched';
     message: string;
     manifestPath: string;
+} | {
+    phase: 'project-scaffolded';
+    message: string;
+    projectPath: string;
 } | {
     phase: 'editor-resolved';
     message: string;
@@ -118,6 +122,47 @@ export interface OpenEnvInputs {
     mode?: OpenProjectOptions['mode'];
     logLevel?: OpenProjectOptions['logLevel'];
 }
+export interface CreateProjectOptions {
+    /** Target directory to scaffold the project into. Defaults to `process.cwd()`. */
+    projectPath?: string;
+    /**
+     * Project name written to `config/name` (and the `[dotnet]` assembly name /
+     * csproj filename when `dotnet` is set). Defaults to a name derived from the
+     * target folder name.
+     */
+    name?: string;
+    /** When `true`, additionally scaffold a `Godot.NET.Sdk` (C#) csproj. */
+    dotnet?: boolean;
+    onProgress?: ProgressCallback;
+}
+export interface CreateProjectSuccess {
+    kind: 'success';
+    success: true;
+    projectPath: string;
+    /** The resolved project name (explicit arg or folder-name derivation). */
+    projectName: string;
+    /** Whether the C# (`--dotnet`) csproj was scaffolded. */
+    dotnet: boolean;
+    /** Absolute paths of every file written, in write order. */
+    filesWritten: string[];
+    warnings: string[];
+}
+export interface CreateProjectFailure {
+    kind: 'failure';
+    success: false;
+    projectPath?: string;
+    warnings: string[];
+    /**
+     * Absolute paths of any files written before the failure, in write order.
+     * Empty when the scaffold was refused before writing or after a successful
+     * best-effort rollback; non-empty only when cleanup of a partial scaffold
+     * could not be completed — lets the consumer finish the cleanup.
+     */
+    filesWritten: string[];
+    errorMessage: string;
+    error: Error;
+}
+export type CreateProjectResult = CreateProjectSuccess | CreateProjectFailure;
 export type RunToolFailureReason = 'invalid-input' | 'connection-refused' | 'connection-reset' | 'network-error' | 'timeout' | 'http-error' | 'unknown';
 /**
  * Options accepted by both {@link runTool} and {@link runSystemTool}.

package/dist/lib.d.ts

@@ -1,5 +1,6 @@
 export { openProject } from './lib/open.js';
+export { createProject } from './lib/create-project.js';
 export { runTool, runSystemTool } from './lib/run-tool.js';
 export { setupMcp, listAgentIds } from './lib/setup-mcp.js';
 export { installPlugin, removePlugin } from './lib/install-plugin.js';
-export type { ProgressEvent, ProgressCallback, ResultKind, OpenProjectOptions, OpenProjectResult, OpenProjectSuccess, OpenProjectFailure, OpenProjectAuthOption, OpenProjectConnectionMode, RunToolOptions, RunToolResult, RunToolSuccess, RunToolFailure, RunToolFailureReason, RunSystemToolOptions, RunSystemToolResult, RunSystemToolSuccess, RunSystemToolFailure, SetupMcpOptions, SetupMcpResult, SetupMcpSuccess, SetupMcpFailure, InstallPluginOptions, InstallPluginResult, InstallPluginSuccess, InstallPluginFailure, RemovePluginOptions, RemovePluginResult, RemovePluginSuccess, RemovePluginFailure, } from './lib/types.js';
+export type { ProgressEvent, ProgressCallback, ResultKind, OpenProjectOptions, OpenProjectResult, OpenProjectSuccess, OpenProjectFailure, OpenProjectAuthOption, OpenProjectConnectionMode, CreateProjectOptions, CreateProjectResult, CreateProjectSuccess, CreateProjectFailure, RunToolOptions, RunToolResult, RunToolSuccess, RunToolFailure, RunToolFailureReason, RunSystemToolOptions, RunSystemToolResult, RunSystemToolSuccess, RunSystemToolFailure, SetupMcpOptions, SetupMcpResult, SetupMcpSuccess, SetupMcpFailure, InstallPluginOptions, InstallPluginResult, InstallPluginSuccess, InstallPluginFailure, RemovePluginOptions, RemovePluginResult, RemovePluginSuccess, RemovePluginFailure, } from './lib/types.js';

package/dist/lib.js

@@ -13,6 +13,7 @@
 // Consumers: `import { openProject } from 'godot-cli'` (maps to this file
 // via the `exports` field in package.json).
 export { openProject } from './lib/open.js';
+export { createProject } from './lib/create-project.js';
 export { runTool, runSystemTool } from './lib/run-tool.js';
 export { setupMcp, listAgentIds } from './lib/setup-mcp.js';
 export { installPlugin, removePlugin } from './lib/install-plugin.js';

package/dist/lib.js.map

@@ -1 +1 @@
-{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,eAAe;AACf,+EAA+E;AAC/E,wDAAwD;AACxD,oDAAoD;AACpD,yEAAyE;AACzE,4DAA4D;AAC5D,+EAA+E;AAC/E,gEAAgE;AAChE,6EAA6E;AAC7E,EAAE;AACF,0EAA0E;AAC1E,4CAA4C;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,eAAe;AACf,+EAA+E;AAC/E,wDAAwD;AACxD,oDAAoD;AACpD,yEAAyE;AACzE,4DAA4D;AAC5D,+EAA+E;AAC/E,gEAAgE;AAChE,6EAA6E;AAC7E,EAAE;AACF,0EAA0E;AAC1E,4CAA4C;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "godot-cli",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Cross-platform CLI tool for Godot-MCP (Skills & MCP). Resolves and launches the Godot editor with MCP connection env vars, runs MCP/system tools over HTTP, probes server health, configures AI agents (Claude Code, Cursor, VS Code, …), and enables/disables the godot_mcp addon. Works with Claude Code, Cursor, Copilot, and any MCP client.",
   "type": "module",
   "main": "dist/lib.js",