create-glosc 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 glosc-ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# Glosc CLI
+
+### 使用方法
+
+```sh
+npm create glosc@latest
+```
+
+也支持直接传入项目名：
+
+```sh
+npm create glosc@latest <your-project-name>
+```
+
+```sh
+Project name: <your-project-name>
+Description: A brief description of your project
+Author: Your Name
+Use Language: Python / TypeScript
+Main File Name: main.py / index.ts
+Readme: Y / N
+License: MIT
+```
+
+
+### Python结构
+
+```sh
+
+<your-project-name>/
+├── src/                # 源代码目录
+│   ├── main.py         # 主程序文件 (Python)
+│   ├── pyproject.toml   # 项目配置
+│   └── requirements.txt # 依赖文件
+├── config.yml          # 配置文件
+├── README.md           # 项目说明文件
+└── LICENSE             # 许可证文件
+```
+
+
+### TypeScript结构
+
+```sh
+<your-project-name>/
+├── src/                # 源代码目录
+│   ├── index.ts        # 主程序文件 (TypeScript)
+│   └── package.json    # 依赖文件
+├── config.yml          # 配置文件
+├── README.md           # 项目说明文件
+└── LICENSE             # 许可证文件
+```
+
+### 本地开发（维护此 CLI）
+
+```sh
+npm install
+npm run build
+node bin/index.js
+```
+
+非交互模式（方便 CI/自测，不会卡在交互输入）：
+
+```sh
+node bin/index.js my-app --defaults --language python
+node bin/index.js my-app --defaults --language typescript
+```

package/bin/index.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+
+"use strict";
+
+try {
+    require("../dist/index");
+} catch (err) {
+    console.error(
+        "Failed to load compiled CLI from dist/. Run `npm run build` first."
+    );
+    throw err;
+}

package/dist/index.js

@@ -0,0 +1,245 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const prompts_1 = __importDefault(require("prompts"));
+const path = __importStar(require("node:path"));
+const scaffold_1 = require("./scaffold");
+function parseArgs(argv) {
+    const result = {
+        defaults: false,
+        language: undefined,
+        mainFileName: undefined,
+        description: undefined,
+        author: undefined,
+        readme: undefined,
+        license: undefined,
+        projectName: undefined,
+    };
+    const args = Array.from(argv);
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (!a)
+            continue;
+        if (a === "--defaults" || a === "--yes" || a === "-y") {
+            result.defaults = true;
+            continue;
+        }
+        if (a === "--no-readme") {
+            result.readme = false;
+            continue;
+        }
+        if (a === "--readme") {
+            result.readme = true;
+            continue;
+        }
+        if (a === "--no-license") {
+            result.license = false;
+            continue;
+        }
+        if (a === "--license") {
+            result.license = true;
+            continue;
+        }
+        if (a === "--language" && i + 1 < args.length) {
+            result.language = args[++i];
+            continue;
+        }
+        if (a === "--main" && i + 1 < args.length) {
+            result.mainFileName = args[++i];
+            continue;
+        }
+        if (a === "--description" && i + 1 < args.length) {
+            result.description = args[++i];
+            continue;
+        }
+        if (a === "--author" && i + 1 < args.length) {
+            result.author = args[++i];
+            continue;
+        }
+        if (!a.startsWith("-") && !result.projectName) {
+            result.projectName = a;
+            continue;
+        }
+    }
+    return result;
+}
+function normalizeLanguage(value) {
+    const v = String(value || "")
+        .trim()
+        .toLowerCase();
+    if (v === "py" || v === "python")
+        return "python";
+    if (v === "ts" || v === "typescript")
+        return "typescript";
+    if (v === "js" || v === "javascript") {
+        throw new Error("JavaScript template has been removed. Use --language typescript (or omit --language) instead.");
+    }
+    return undefined;
+}
+function normalizeMainFileName(language, mainFileNameRaw) {
+    const trimmed = String(mainFileNameRaw || "").trim();
+    const defaultExt = language === "python" ? ".py" : ".ts";
+    const base = trimmed.length > 0
+        ? trimmed
+        : language === "python"
+            ? "main.py"
+            : "index.ts";
+    if (path.extname(base))
+        return base;
+    return `${base}${defaultExt}`;
+}
+async function run() {
+    const argv = process.argv.slice(2);
+    const args = parseArgs(argv);
+    if (args.defaults) {
+        if (!args.projectName) {
+            throw new Error("Project name is required (e.g. `npm create glosc-cli@latest my-app -- --defaults`)");
+        }
+        const language = normalizeLanguage(args.language) || "typescript";
+        const options = {
+            projectName: String(args.projectName).trim(),
+            description: String(args.description || "A brief description of your project").trim(),
+            author: String(args.author || "Your Name").trim(),
+            language,
+            mainFileName: normalizeMainFileName(language, args.mainFileName),
+            readme: args.readme !== undefined ? Boolean(args.readme) : true,
+            license: args.license !== undefined ? Boolean(args.license) : true,
+        };
+        await (0, scaffold_1.scaffoldProject)(options);
+        return;
+    }
+    // allow `npm create ... <name>` to prefill
+    prompts_1.default.override({
+        projectName: args.projectName,
+    });
+    let selectedLanguage;
+    const response = await (0, prompts_1.default)([
+        {
+            type: "text",
+            name: "projectName",
+            message: "Project name:",
+            validate: (value) => {
+                const name = String(value || "").trim();
+                if (!name)
+                    return "Project name is required";
+                if (name.includes("/") || name.includes("\\"))
+                    return "Project name cannot include path separators";
+                return true;
+            },
+        },
+        {
+            type: "text",
+            name: "description",
+            message: "Description:",
+            initial: "A brief description of your project",
+        },
+        {
+            type: "text",
+            name: "author",
+            message: "Author:",
+            initial: "Your Name",
+        },
+        {
+            type: "select",
+            name: "language",
+            message: "Use Language:",
+            choices: [
+                { title: "Python", value: "python" },
+                { title: "TypeScript", value: "typescript" },
+            ],
+            onState: (state) => {
+                selectedLanguage = state.value;
+            },
+        },
+        {
+            type: (prev) => (prev ? "text" : null),
+            name: "mainFileName",
+            message: "Main File Name:",
+            initial: (prev) => prev === "python" ? "main.py" : "index.ts",
+            validate: (value, values) => {
+                const name = String(value || "").trim();
+                if (!name)
+                    return "Main file name is required";
+                const ext = path.extname(name);
+                const currentLanguage = values?.language || selectedLanguage;
+                if (!currentLanguage)
+                    return true;
+                const expected = currentLanguage === "python" ? ".py" : ".ts";
+                if (ext && ext !== expected)
+                    return `Main file should end with ${expected}`;
+                return true;
+            },
+        },
+        {
+            type: "confirm",
+            name: "readme",
+            message: "Readme:",
+            initial: true,
+        },
+        {
+            type: "confirm",
+            name: "license",
+            message: "License (MIT):",
+            initial: true,
+        },
+    ], {
+        onCancel: () => {
+            process.exitCode = 1;
+            return false;
+        },
+    });
+    if (!response || !response.projectName) {
+        process.exitCode = 1;
+        return;
+    }
+    const options = {
+        projectName: String(response.projectName).trim(),
+        description: String(response.description || "").trim(),
+        author: String(response.author || "").trim(),
+        language: response.language,
+        mainFileName: normalizeMainFileName(response.language, response.mainFileName),
+        readme: Boolean(response.readme),
+        license: Boolean(response.license),
+    };
+    await (0, scaffold_1.scaffoldProject)(options);
+}
+run().catch((err) => {
+    // eslint-disable-next-line no-console
+    console.error(err);
+    process.exitCode = 1;
+});

package/dist/scaffold.js

@@ -0,0 +1,69 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scaffoldProject = scaffoldProject;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const templates_1 = require("./templates");
+async function pathExists(p) {
+    try {
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function ensureDir(dirPath) {
+    await fs.mkdir(dirPath, { recursive: true });
+}
+async function writeFileEnsuringDir(filePath, content) {
+    await ensureDir(path.dirname(filePath));
+    await fs.writeFile(filePath, content, "utf8");
+}
+async function scaffoldProject(options) {
+    const targetRoot = path.resolve(process.cwd(), options.projectName);
+    if (await pathExists(targetRoot)) {
+        throw new Error(`Target directory already exists: ${targetRoot}`);
+    }
+    const files = (0, templates_1.getProjectFiles)(options);
+    await ensureDir(targetRoot);
+    for (const file of files) {
+        const absPath = path.join(targetRoot, file.relativePath);
+        await writeFileEnsuringDir(absPath, file.content);
+    }
+    // eslint-disable-next-line no-console
+    console.log(`\nCreated project at: ${targetRoot}`);
+}

package/dist/templates.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProjectFiles = getProjectFiles;
+function escapeYamlString(value) {
+    const s = String(value ?? "");
+    const escaped = s.replace(/"/g, '\\"');
+    return `"${escaped}"`;
+}
+function mitLicenseText({ author }) {
+    const year = new Date().getFullYear();
+    const owner = String(author || "").trim() || "Copyright Holder";
+    return `MIT License\n\nCopyright (c) ${year} ${owner}\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n`;
+}
+function projectReadme(options) {
+    const { projectName, description, author, language, mainFileName } = options;
+    const langLabel = language === "python" ? "Python" : "TypeScript";
+    return `# ${projectName}\n\n${description || ""}\n\n## Author\n\n${author || ""}\n\n## Language\n\n${langLabel}\n\n## Entry\n\n- src/${mainFileName}\n\n## Config\n\n- config.yml\n`;
+}
+function configYml(options) {
+    const { projectName, description, author, language, mainFileName } = options;
+    return [
+        `name: ${escapeYamlString(projectName)}`,
+        `description: ${escapeYamlString(description)}`,
+        `author: ${escapeYamlString(author)}`,
+        `language: ${escapeYamlString(language)}`,
+        `entry: ${escapeYamlString(`src/${mainFileName}`)}`,
+        "",
+    ].join("\n");
+}
+function pythonMain({ projectName, description, }) {
+    const safeName = String(projectName).replace(/"/g, '\\"');
+    const safeDesc = String(description || "").replace(/"/g, '\\"');
+    return `def main():\n    print("${safeName}")\n    ${description ? `print("${safeDesc}")` : "pass"}\n\n\nif __name__ == "__main__":\n    main()\n`;
+}
+function pythonRequirements() {
+    return `# Add your Python dependencies here\n`;
+}
+function pythonPyproject({ projectName, author, }) {
+    const safeName = String(projectName || "glosc-project")
+        .trim()
+        .replace(/\s+/g, "-");
+    const safeAuthor = String(author || "").replace(/"/g, '\\"');
+    return `# Minimal pyproject.toml (adjust as needed)\n\n[project]\nname = "${safeName}"\nversion = "0.1.0"\ndescription = ""\nauthors = [{ name = "${safeAuthor}" }]\nrequires-python = ">=3.10"\n\n[build-system]\nrequires = ["setuptools>=61.0"]\nbuild-backend = "setuptools.build_meta"\n`;
+}
+function nodePackageJson(options) {
+    const { projectName, description, author, mainFileName } = options;
+    const main = mainFileName.replace(/\.ts$/i, ".js");
+    const pkg = {
+        name: projectName,
+        version: "0.1.0",
+        description: description || "",
+        author: author || "",
+        private: true,
+        scripts: {
+            build: "tsc -p .",
+            start: `node ${main}`,
+        },
+        devDependencies: {
+            typescript: "^5.3.3",
+        },
+    };
+    return JSON.stringify(pkg, null, 2) + "\n";
+}
+function tsConfig() {
+    return (JSON.stringify({
+        compilerOptions: {
+            target: "ES2020",
+            module: "CommonJS",
+            strict: true,
+            outDir: ".",
+            rootDir: ".",
+            esModuleInterop: true,
+        },
+        include: ["*.ts"],
+    }, null, 2) + "\n");
+}
+function tsMain({ projectName, description, }) {
+    const safeName = String(projectName).replace(/`/g, "\\`");
+    const safeDesc = String(description || "").replace(/`/g, "\\`");
+    return `console.log("${safeName}");\n${description ? `console.log("${safeDesc}");\n` : ""}`;
+}
+function getProjectFiles(options) {
+    const files = [];
+    files.push({ relativePath: "config.yml", content: configYml(options) });
+    if (options.readme) {
+        files.push({
+            relativePath: "README.md",
+            content: projectReadme(options),
+        });
+    }
+    if (options.license) {
+        files.push({
+            relativePath: "LICENSE",
+            content: mitLicenseText(options),
+        });
+    }
+    if (options.language === "python") {
+        files.push({
+            relativePath: `src/${options.mainFileName}`,
+            content: pythonMain(options),
+        });
+        files.push({
+            relativePath: "src/requirements.txt",
+            content: pythonRequirements(),
+        });
+        files.push({
+            relativePath: "src/pyproject.toml",
+            content: pythonPyproject(options),
+        });
+    }
+    if (options.language === "typescript") {
+        files.push({
+            relativePath: `src/${options.mainFileName}`,
+            content: tsMain(options),
+        });
+        files.push({
+            relativePath: "src/package.json",
+            content: nodePackageJson(options),
+        });
+        files.push({ relativePath: "src/tsconfig.json", content: tsConfig() });
+    }
+    return files;
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+    "name": "create-glosc",
+    "version": "0.1.0",
+    "description": "Scaffold Glosc projects (Python/TypeScript/JavaScript) via npm create",
+    "author": "glosc-ai",
+    "license": "MIT",
+    "bin": {
+        "glosc": "bin/index.js"
+    },
+    "type": "commonjs",
+    "engines": {
+        "node": ">=18"
+    },
+    "scripts": {
+        "build": "tsc -p tsconfig.json",
+        "start": "npm run build && node bin/index.js",
+        "lint": "npm run build --silent",
+        "prepublishOnly": "npm run build"
+    },
+    "dependencies": {
+        "prompts": "^2.4.2"
+    },
+    "devDependencies": {
+        "@types/node": "^22.10.7",
+        "@types/prompts": "^2.4.9",
+        "typescript": "^5.4.5"
+    },
+    "files": [
+        "bin/",
+        "dist/",
+        "src/",
+        "README.md",
+        "LICENSE"
+    ],
+    "keywords": [
+        "create",
+        "scaffold",
+        "cli",
+        "glosc"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/glosc-ai/Glosc-cli"
+    }
+}

package/src/index.ts

@@ -0,0 +1,271 @@
+import prompts from "prompts";
+import * as path from "node:path";
+import { scaffoldProject } from "./scaffold";
+
+type Language = "python" | "typescript";
+
+type ProjectOptions = {
+    projectName: string;
+    description: string;
+    author: string;
+    language: Language;
+    mainFileName: string;
+    readme: boolean;
+    license: boolean;
+};
+
+type ParsedArgs = {
+    defaults: boolean;
+    language?: string;
+    mainFileName?: string;
+    description?: string;
+    author?: string;
+    readme?: boolean;
+    license?: boolean;
+    projectName?: string;
+};
+
+function parseArgs(argv: string[]): ParsedArgs {
+    const result: ParsedArgs = {
+        defaults: false,
+        language: undefined,
+        mainFileName: undefined,
+        description: undefined,
+        author: undefined,
+        readme: undefined,
+        license: undefined,
+        projectName: undefined,
+    };
+
+    const args = Array.from(argv);
+
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (!a) continue;
+
+        if (a === "--defaults" || a === "--yes" || a === "-y") {
+            result.defaults = true;
+            continue;
+        }
+
+        if (a === "--no-readme") {
+            result.readme = false;
+            continue;
+        }
+
+        if (a === "--readme") {
+            result.readme = true;
+            continue;
+        }
+
+        if (a === "--no-license") {
+            result.license = false;
+            continue;
+        }
+
+        if (a === "--license") {
+            result.license = true;
+            continue;
+        }
+
+        if (a === "--language" && i + 1 < args.length) {
+            result.language = args[++i];
+            continue;
+        }
+
+        if (a === "--main" && i + 1 < args.length) {
+            result.mainFileName = args[++i];
+            continue;
+        }
+
+        if (a === "--description" && i + 1 < args.length) {
+            result.description = args[++i];
+            continue;
+        }
+
+        if (a === "--author" && i + 1 < args.length) {
+            result.author = args[++i];
+            continue;
+        }
+
+        if (!a.startsWith("-") && !result.projectName) {
+            result.projectName = a;
+            continue;
+        }
+    }
+
+    return result;
+}
+
+function normalizeLanguage(value: unknown): Language | undefined {
+    const v = String(value || "")
+        .trim()
+        .toLowerCase();
+    if (v === "py" || v === "python") return "python";
+    if (v === "ts" || v === "typescript") return "typescript";
+    if (v === "js" || v === "javascript") {
+        throw new Error(
+            "JavaScript template has been removed. Use --language typescript (or omit --language) instead."
+        );
+    }
+    return undefined;
+}
+
+function normalizeMainFileName(
+    language: Language,
+    mainFileNameRaw: unknown
+): string {
+    const trimmed = String(mainFileNameRaw || "").trim();
+    const defaultExt = language === "python" ? ".py" : ".ts";
+    const base =
+        trimmed.length > 0
+            ? trimmed
+            : language === "python"
+            ? "main.py"
+            : "index.ts";
+
+    if (path.extname(base)) return base;
+    return `${base}${defaultExt}`;
+}
+
+async function run(): Promise<void> {
+    const argv = process.argv.slice(2);
+    const args = parseArgs(argv);
+
+    if (args.defaults) {
+        if (!args.projectName) {
+            throw new Error(
+                "Project name is required (e.g. `npm create glosc-cli@latest my-app -- --defaults`)"
+            );
+        }
+
+        const language = normalizeLanguage(args.language) || "typescript";
+
+        const options: ProjectOptions = {
+            projectName: String(args.projectName).trim(),
+            description: String(
+                args.description || "A brief description of your project"
+            ).trim(),
+            author: String(args.author || "Your Name").trim(),
+            language,
+            mainFileName: normalizeMainFileName(language, args.mainFileName),
+            readme: args.readme !== undefined ? Boolean(args.readme) : true,
+            license: args.license !== undefined ? Boolean(args.license) : true,
+        };
+
+        await scaffoldProject(options);
+        return;
+    }
+
+    // allow `npm create ... <name>` to prefill
+    prompts.override({
+        projectName: args.projectName,
+    });
+
+    let selectedLanguage: Language | undefined;
+
+    const response = await prompts(
+        [
+            {
+                type: "text",
+                name: "projectName",
+                message: "Project name:",
+                validate: (value: string) => {
+                    const name = String(value || "").trim();
+                    if (!name) return "Project name is required";
+                    if (name.includes("/") || name.includes("\\"))
+                        return "Project name cannot include path separators";
+                    return true;
+                },
+            },
+            {
+                type: "text",
+                name: "description",
+                message: "Description:",
+                initial: "A brief description of your project",
+            },
+            {
+                type: "text",
+                name: "author",
+                message: "Author:",
+                initial: "Your Name",
+            },
+            {
+                type: "select",
+                name: "language",
+                message: "Use Language:",
+                choices: [
+                    { title: "Python", value: "python" },
+                    { title: "TypeScript", value: "typescript" },
+                ],
+                onState: (state: { value: Language }) => {
+                    selectedLanguage = state.value;
+                },
+            },
+            {
+                type: (prev: Language) => (prev ? "text" : null),
+                name: "mainFileName",
+                message: "Main File Name:",
+                initial: (prev: Language) =>
+                    prev === "python" ? "main.py" : "index.ts",
+                validate: (value: string, values?: { language?: Language }) => {
+                    const name = String(value || "").trim();
+                    if (!name) return "Main file name is required";
+                    const ext = path.extname(name);
+                    const currentLanguage =
+                        values?.language || selectedLanguage;
+                    if (!currentLanguage) return true;
+                    const expected =
+                        currentLanguage === "python" ? ".py" : ".ts";
+                    if (ext && ext !== expected)
+                        return `Main file should end with ${expected}`;
+                    return true;
+                },
+            },
+            {
+                type: "confirm",
+                name: "readme",
+                message: "Readme:",
+                initial: true,
+            },
+            {
+                type: "confirm",
+                name: "license",
+                message: "License (MIT):",
+                initial: true,
+            },
+        ],
+        {
+            onCancel: () => {
+                process.exitCode = 1;
+                return false;
+            },
+        }
+    );
+
+    if (!response || !response.projectName) {
+        process.exitCode = 1;
+        return;
+    }
+
+    const options: ProjectOptions = {
+        projectName: String(response.projectName).trim(),
+        description: String(response.description || "").trim(),
+        author: String(response.author || "").trim(),
+        language: response.language as Language,
+        mainFileName: normalizeMainFileName(
+            response.language as Language,
+            response.mainFileName
+        ),
+        readme: Boolean(response.readme),
+        license: Boolean(response.license),
+    };
+
+    await scaffoldProject(options);
+}
+
+run().catch((err) => {
+    // eslint-disable-next-line no-console
+    console.error(err);
+    process.exitCode = 1;
+});

package/src/scaffold.ts

@@ -0,0 +1,44 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { getProjectFiles, type ProjectOptions } from "./templates";
+
+async function pathExists(p: string): Promise<boolean> {
+    try {
+        await fs.access(p);
+        return true;
+    } catch {
+        return false;
+    }
+}
+
+async function ensureDir(dirPath: string): Promise<void> {
+    await fs.mkdir(dirPath, { recursive: true });
+}
+
+async function writeFileEnsuringDir(
+    filePath: string,
+    content: string
+): Promise<void> {
+    await ensureDir(path.dirname(filePath));
+    await fs.writeFile(filePath, content, "utf8");
+}
+
+export async function scaffoldProject(options: ProjectOptions): Promise<void> {
+    const targetRoot = path.resolve(process.cwd(), options.projectName);
+
+    if (await pathExists(targetRoot)) {
+        throw new Error(`Target directory already exists: ${targetRoot}`);
+    }
+
+    const files = getProjectFiles(options);
+
+    await ensureDir(targetRoot);
+
+    for (const file of files) {
+        const absPath = path.join(targetRoot, file.relativePath);
+        await writeFileEnsuringDir(absPath, file.content);
+    }
+
+    // eslint-disable-next-line no-console
+    console.log(`\nCreated project at: ${targetRoot}`);
+}

package/src/templates.ts

@@ -0,0 +1,182 @@
+export type Language = "python" | "typescript";
+
+export type ProjectOptions = {
+    projectName: string;
+    description: string;
+    author: string;
+    language: Language;
+    mainFileName: string;
+    readme: boolean;
+    license: boolean;
+};
+
+export type ProjectFile = {
+    relativePath: string;
+    content: string;
+};
+
+function escapeYamlString(value: unknown): string {
+    const s = String(value ?? "");
+    const escaped = s.replace(/"/g, '\\"');
+    return `"${escaped}"`;
+}
+
+function mitLicenseText({ author }: Pick<ProjectOptions, "author">): string {
+    const year = new Date().getFullYear();
+    const owner = String(author || "").trim() || "Copyright Holder";
+    return `MIT License\n\nCopyright (c) ${year} ${owner}\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n`;
+}
+
+function projectReadme(options: ProjectOptions): string {
+    const { projectName, description, author, language, mainFileName } =
+        options;
+    const langLabel = language === "python" ? "Python" : "TypeScript";
+
+    return `# ${projectName}\n\n${description || ""}\n\n## Author\n\n${
+        author || ""
+    }\n\n## Language\n\n${langLabel}\n\n## Entry\n\n- src/${mainFileName}\n\n## Config\n\n- config.yml\n`;
+}
+
+function configYml(options: ProjectOptions): string {
+    const { projectName, description, author, language, mainFileName } =
+        options;
+    return [
+        `name: ${escapeYamlString(projectName)}`,
+        `description: ${escapeYamlString(description)}`,
+        `author: ${escapeYamlString(author)}`,
+        `language: ${escapeYamlString(language)}`,
+        `entry: ${escapeYamlString(`src/${mainFileName}`)}`,
+        "",
+    ].join("\n");
+}
+
+function pythonMain({
+    projectName,
+    description,
+}: Pick<ProjectOptions, "projectName" | "description">): string {
+    const safeName = String(projectName).replace(/"/g, '\\"');
+    const safeDesc = String(description || "").replace(/"/g, '\\"');
+
+    return `def main():\n    print("${safeName}")\n    ${
+        description ? `print("${safeDesc}")` : "pass"
+    }\n\n\nif __name__ == "__main__":\n    main()\n`;
+}
+
+function pythonRequirements(): string {
+    return `# Add your Python dependencies here\n`;
+}
+
+function pythonPyproject({
+    projectName,
+    author,
+}: Pick<ProjectOptions, "projectName" | "author">): string {
+    const safeName = String(projectName || "glosc-project")
+        .trim()
+        .replace(/\s+/g, "-");
+
+    const safeAuthor = String(author || "").replace(/"/g, '\\"');
+
+    return `# Minimal pyproject.toml (adjust as needed)\n\n[project]\nname = "${safeName}"\nversion = "0.1.0"\ndescription = ""\nauthors = [{ name = "${safeAuthor}" }]\nrequires-python = ">=3.10"\n\n[build-system]\nrequires = ["setuptools>=61.0"]\nbuild-backend = "setuptools.build_meta"\n`;
+}
+
+function nodePackageJson(options: ProjectOptions): string {
+    const { projectName, description, author, mainFileName } = options;
+    const main = mainFileName.replace(/\.ts$/i, ".js");
+
+    const pkg: Record<string, unknown> = {
+        name: projectName,
+        version: "0.1.0",
+        description: description || "",
+        author: author || "",
+        private: true,
+        scripts: {
+            build: "tsc -p .",
+            start: `node ${main}`,
+        },
+        devDependencies: {
+            typescript: "^5.3.3",
+        },
+    };
+
+    return JSON.stringify(pkg, null, 2) + "\n";
+}
+
+function tsConfig(): string {
+    return (
+        JSON.stringify(
+            {
+                compilerOptions: {
+                    target: "ES2020",
+                    module: "CommonJS",
+                    strict: true,
+                    outDir: ".",
+                    rootDir: ".",
+                    esModuleInterop: true,
+                },
+                include: ["*.ts"],
+            },
+            null,
+            2
+        ) + "\n"
+    );
+}
+
+function tsMain({
+    projectName,
+    description,
+}: Pick<ProjectOptions, "projectName" | "description">): string {
+    const safeName = String(projectName).replace(/`/g, "\\`");
+    const safeDesc = String(description || "").replace(/`/g, "\\`");
+    return `console.log("${safeName}");\n${
+        description ? `console.log("${safeDesc}");\n` : ""
+    }`;
+}
+
+export function getProjectFiles(options: ProjectOptions): ProjectFile[] {
+    const files: ProjectFile[] = [];
+
+    files.push({ relativePath: "config.yml", content: configYml(options) });
+
+    if (options.readme) {
+        files.push({
+            relativePath: "README.md",
+            content: projectReadme(options),
+        });
+    }
+
+    if (options.license) {
+        files.push({
+            relativePath: "LICENSE",
+            content: mitLicenseText(options),
+        });
+    }
+
+    if (options.language === "python") {
+        files.push({
+            relativePath: `src/${options.mainFileName}`,
+            content: pythonMain(options),
+        });
+        files.push({
+            relativePath: "src/requirements.txt",
+            content: pythonRequirements(),
+        });
+        files.push({
+            relativePath: "src/pyproject.toml",
+            content: pythonPyproject(options),
+        });
+    }
+
+    if (options.language === "typescript") {
+        files.push({
+            relativePath: `src/${options.mainFileName}`,
+            content: tsMain(options),
+        });
+        files.push({
+            relativePath: "src/package.json",
+            content: nodePackageJson(options),
+        });
+        files.push({ relativePath: "src/tsconfig.json", content: tsConfig() });
+    }
+
+    return files;
+}