create-justscale 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JustScale
+
+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,82 @@
+# create-justscale
+
+Project scaffolder for `pnpm create justscale` / `npm create justscale@latest` / `yarn create justscale`. Interactive prompt, detects your environment (OS, package manager, installed IDEs, AI tools, git hosting), then writes a minimal JustScale app with matching IDE + CI config.
+
+Not a package you import — it's a CLI. Run it to bootstrap a new project.
+
+## Usage
+
+```bash
+pnpm create justscale
+# or
+npm create justscale@latest
+# or
+yarn create justscale
+```
+
+You can also invoke it directly:
+
+```bash
+pnpm dlx create-justscale
+```
+
+The CLI asks for a project name (default: current directory name). If the name matches the current directory, it scaffolds in place; otherwise it creates a subdirectory. It refuses to run in a directory that already has a `package.json` — use `just init` for that case.
+
+## What gets generated
+
+Always:
+
+- `package.json` with `@justscale/core` and `@justscale/typescript` pinned
+- `tsconfig.json` (NodeNext, ES2022, strict)
+- `justscale.config.ts` with `defineProject` and `serve` / `cli` mode entries
+- `src/app.ts`, `src/serve.ts`, `src/cli.ts` stubs
+- `.gitignore`
+
+Based on detected environment:
+
+- JetBrains IDE (WebStorm / IntelliJ): `.idea/typescript.xml` pointing at `@justscale/typescript`'s tsserver, plus `just dev` / `just build` / `just test` run configurations.
+- VS Code / Cursor: `.vscode/settings.json` with `typescript.tsdk` pointed at the workspace JustScale TypeScript, plus a `launch.json` for `just dev`.
+- Claude CLI on PATH: `.claude/settings.json` wiring the JustScale MCP server (`just mcp serve`) and a starter `CLAUDE.md`.
+- GitHub remote: `.github/workflows/ci.yml` matching the detected package manager.
+- GitLab remote: `.gitlab-ci.yml` equivalent.
+
+After scaffolding, the CLI runs `<pm> install`, initialises git, and optionally opens your detected editor / Claude session.
+
+## Detection
+
+Detection is best-effort and purely read-only:
+
+- **OS / arch** from `process.platform`
+- **Package manager** via `which pnpm` / `yarn` (falls back to `npm`)
+- **IDEs** by scanning app locations on macOS/Linux plus `code` / `cursor` on PATH
+- **AI tools** by `claude` / `cursor` on PATH
+- **Git hosting** from `.git/config` (github.com, gitlab.com)
+
+No network calls, no telemetry.
+
+## Starter app shape
+
+The generated `app.ts` is intentionally empty — a `JustScale()` builder with comments showing where to `.add(...)` services / features:
+
+```ts
+import JustScale from '@justscale/core'
+
+export const app = JustScale()
+  // Add services, features, and adapters here
+  // .add(PostgresClient)
+  // .add(AuthFeature)
+```
+
+`serve.ts` and `cli.ts` each `.build()` it for their respective modes; `justscale.config.ts` wires the modes together. From there you follow the docs to add controllers, features, and an adapter.
+
+## Next steps
+
+```bash
+cd your-project-name
+just dev                 # boots the app
+just install <plugin>    # installs and wires a JustScale plugin
+```
+
+## Docs
+
+https://justscale.sh/overview/quick-start

package/bin/create-justscale.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { main } from '../dist/index.js';
+main();

package/dist/detect.d.ts

@@ -0,0 +1,11 @@
+export interface SystemInfo {
+    os: 'macos' | 'linux' | 'windows';
+    arch: string;
+    nodeVersion: string;
+    packageManager: 'pnpm' | 'yarn' | 'npm';
+    ides: ('jetbrains' | 'vscode' | 'cursor')[];
+    aiTools: ('claude' | 'cursor')[];
+    gitHosting: 'github' | 'gitlab' | null;
+}
+export declare function detectSystem(projectRoot: string): SystemInfo;
+//# sourceMappingURL=detect.d.ts.map

package/dist/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAA;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;IACvC,IAAI,EAAE,CAAC,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC,EAAE,CAAA;IAC3C,OAAO,EAAE,CAAC,QAAQ,GAAG,QAAQ,CAAC,EAAE,CAAA;IAChC,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAAA;CACvC;AAYD,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAgD5D"}

package/dist/detect.js

@@ -0,0 +1,68 @@
+import { execSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+function which(bin) {
+    try {
+        const cmd = process.platform === 'win32' ? `where.exe ${bin}` : `which ${bin}`;
+        execSync(cmd, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function detectSystem(projectRoot) {
+    const ides = [];
+    const aiTools = [];
+    // IDE detection
+    if (process.platform === 'darwin') {
+        if (existsSync(join(process.env.HOME ?? '', 'Library/Application Support/JetBrains/Toolbox')) ||
+            existsSync('/Applications/WebStorm.app') ||
+            existsSync('/Applications/IntelliJ IDEA.app')) {
+            ides.push('jetbrains');
+        }
+    }
+    else if (existsSync(join(process.env.HOME ?? '', '.local/share/JetBrains/Toolbox'))) {
+        ides.push('jetbrains');
+    }
+    if (which('code') || which('code-insiders'))
+        ides.push('vscode');
+    if (which('cursor'))
+        ides.push('cursor');
+    // AI tools
+    if (which('claude'))
+        aiTools.push('claude');
+    if (which('cursor'))
+        aiTools.push('cursor');
+    // Git hosting
+    let gitHosting = null;
+    const gitConfigPath = join(projectRoot, '.git', 'config');
+    if (existsSync(gitConfigPath)) {
+        try {
+            const config = readFileSync(gitConfigPath, 'utf-8');
+            if (config.includes('github.com'))
+                gitHosting = 'github';
+            else if (config.includes('gitlab.com'))
+                gitHosting = 'gitlab';
+        }
+        catch {
+            /* optional - unreadable git config means unknown hosting */
+        }
+    }
+    // Package manager
+    let packageManager = 'npm';
+    if (which('pnpm'))
+        packageManager = 'pnpm';
+    else if (which('yarn'))
+        packageManager = 'yarn';
+    return {
+        os: process.platform === 'darwin' ? 'macos' : process.platform === 'win32' ? 'windows' : 'linux',
+        arch: process.arch,
+        nodeVersion: process.version,
+        packageManager,
+        ides,
+        aiTools,
+        gitHosting,
+    };
+}
+//# sourceMappingURL=detect.js.map

package/dist/detect.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @justscale/install - project scaffolder
+ *
+ * Usage: npx @justscale/install
+ *        pnpm dlx @justscale/install
+ */
+export declare function main(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+BH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ1C"}

package/dist/index.js

@@ -0,0 +1,157 @@
+/**
+ * @justscale/install - project scaffolder
+ *
+ * Usage: npx @justscale/install
+ *        pnpm dlx @justscale/install
+ */
+import { createInterface } from 'node:readline';
+import { execSync, execFileSync } from 'node:child_process';
+import { basename, join, resolve, sep } from 'node:path';
+import { existsSync, readdirSync } from 'node:fs';
+import { detectSystem } from './detect.js';
+import { scaffoldProject } from './scaffold.js';
+const rl = createInterface({ input: process.stdin, output: process.stdout });
+function ask(question, defaultValue) {
+    const prompt = defaultValue ? `${question} [${defaultValue}]: ` : `${question}: `;
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => {
+            resolve(answer.trim() || defaultValue || '');
+        });
+    });
+}
+function confirm(question, defaultYes = false) {
+    const hint = defaultYes ? '[Y/n]' : '[y/N]';
+    return new Promise((resolve) => {
+        rl.question(`${question} ${hint}: `, (answer) => {
+            const a = answer.trim().toLowerCase();
+            if (a === '')
+                resolve(defaultYes);
+            else
+                resolve(a === 'y' || a === 'yes');
+        });
+    });
+}
+export async function main() {
+    console.log('\n  JustScale - Project Setup\n');
+    try {
+        await run();
+    }
+    finally {
+        rl.close();
+    }
+}
+async function run() {
+    const cwd = process.cwd();
+    const system = detectSystem(cwd);
+    console.log('  Detected:');
+    console.log(`    OS:              ${system.os} (${system.arch})`);
+    console.log(`    Node:            ${system.nodeVersion}`);
+    console.log(`    Package manager: ${system.packageManager}`);
+    console.log(`    IDEs:            ${system.ides.length ? system.ides.join(', ') : 'none detected'}`);
+    console.log(`    AI tools:        ${system.aiTools.length ? system.aiTools.join(', ') : 'none detected'}`);
+    console.log(`    Git hosting:     ${system.gitHosting ?? 'not detected'}`);
+    console.log('');
+    const defaultName = basename(cwd) === '.' ? 'my-app' : basename(cwd);
+    const projectName = await ask('  Project name', defaultName);
+    // If the project name matches the current directory name, scaffold here. Otherwise create a subdirectory.
+    const scaffoldInPlace = projectName === basename(cwd);
+    const projectDir = scaffoldInPlace ? cwd : resolve(cwd, projectName);
+    // Refuse to scaffold outside cwd. Catches malicious or accidental project
+    // names like '../etc' or absolute paths.
+    if (!scaffoldInPlace && !projectDir.startsWith(cwd + sep)) {
+        console.log(`\n  Project name "${projectName}" resolves outside the current directory. Refusing for safety.\n`);
+        process.exit(1);
+    }
+    if (existsSync(join(projectDir, 'package.json'))) {
+        console.log('\n  Directory already has a package.json. Use \'just init\' to set up an existing project.\n');
+        process.exit(1);
+    }
+    // Refuse to silently overwrite a non-empty directory. Without this,
+    // scaffolding into a dir that already has a .gitignore / README /
+    // CLAUDE.md / .git would clobber files. The package.json check above
+    // catches the common case but not these.
+    if (existsSync(projectDir)) {
+        const existing = readdirSync(projectDir).filter(
+        // .git is fine to coexist (this is how `init in current dir`
+        // workflows look); other dotfiles and source files are not.
+        (n) => n !== '.git');
+        if (existing.length > 0) {
+            const sample = existing.slice(0, 5).join(', ');
+            const more = existing.length > 5 ? `, +${existing.length - 5} more` : '';
+            const proceed = await ask(`  Directory ${projectDir} is not empty (${sample}${more}). Files may be overwritten. Continue? (y/N)`, 'N');
+            if (!/^y(es)?$/i.test(proceed.trim())) {
+                console.log('\n  Aborted.\n');
+                process.exit(1);
+            }
+        }
+    }
+    console.log('\n  Scaffolding project...');
+    const generated = scaffoldProject({
+        projectDir,
+        projectName,
+        system,
+    });
+    for (const file of generated) {
+        console.log(`    [x] ${file}`);
+    }
+    console.log('\n  Installing dependencies...');
+    try {
+        const pm = system.packageManager;
+        execSync(`${pm} install`, { cwd: projectDir, stdio: 'inherit' });
+        console.log('    [x] Dependencies installed');
+    }
+    catch {
+        console.log('    [!] Failed to install dependencies. Run it manually.');
+    }
+    if (!existsSync(join(projectDir, '.git'))) {
+        try {
+            execSync('git init', { cwd: projectDir, stdio: 'ignore' });
+            console.log('    [x] Git initialized');
+        }
+        catch {
+            /* optional - git init is a nicety; user can run it manually */
+        }
+    }
+    const relPath = projectDir === cwd ? '.' : projectName;
+    console.log('\n  Done! Next steps:\n');
+    if (relPath !== '.') {
+        console.log(`    cd ${relPath}`);
+    }
+    console.log('    just dev              # Start development server');
+    console.log('    just install <pkg>    # Add a plugin');
+    console.log('');
+    if (system.ides.includes('jetbrains')) {
+        const open = await confirm('  Open in WebStorm?', true);
+        if (open) {
+            try {
+                execFileSync('webstorm', [projectDir], { stdio: 'ignore' });
+            }
+            catch {
+                /* optional - editor launch is best-effort */
+            }
+        }
+    }
+    else if (system.ides.includes('vscode')) {
+        const open = await confirm('  Open in VS Code?', true);
+        if (open) {
+            try {
+                execFileSync('code', [projectDir], { stdio: 'ignore' });
+            }
+            catch {
+                /* optional - editor launch is best-effort */
+            }
+        }
+    }
+    if (system.aiTools.includes('claude')) {
+        const start = await confirm('  Start Claude Code in this project?', true);
+        if (start) {
+            try {
+                execFileSync('claude', [projectDir], { stdio: 'ignore' });
+            }
+            catch {
+                /* optional - AI tool launch is best-effort */
+            }
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/scaffold.d.ts

@@ -0,0 +1,19 @@
+import type { SystemInfo } from './detect.js';
+export interface ScaffoldOptions {
+    projectDir: string;
+    projectName: string;
+    system: SystemInfo;
+    coreVersion?: string;
+}
+export declare function scaffoldProject(options: ScaffoldOptions): string[];
+/**
+ * Defense-in-depth against a compromised template package: returns false
+ * for any entry whose name contains path separators, parent traversal, or
+ * is a hidden-dot reference. readdirSync should never return such names on
+ * a real filesystem, but if a malicious npm package or symlink injects one,
+ * a naive `join(dir, name, ...)` would escape the intended destination.
+ *
+ * Exported for unit-testing.
+ */
+export declare function isSafePathSegment(name: string): boolean;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAS9C,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,UAAU,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,EAAE,CAgHlE;AAgJD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOvD"}