@chem-x/starter-kit 26.9.20-1318 → 26.9.20-1340

package/cli/create.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 
+import fs from 'node:fs';
 import { runScaffold } from './scaffold.js';
 import { runAudit } from './index.js';
 import { sanitizeOutputStreams } from './terminal.js';
@@ -9,6 +10,43 @@ sanitizeOutputStreams();
 installGlobalErrorCatcher();
 
 const rawArgs = process.argv.slice(2);
+
+if (rawArgs.includes('--help') || rawArgs.includes('-h')) {
+  process.stdout.write(`
+Chemical X Protocol: Project Scaffolder
+
+USAGE
+  npm create chemx [directory] [options]
+  npx create-chemx [directory] [options]
+
+OPTIONS
+  --yes, -y       Skip interactive prompts and scaffold Community Edition immediately
+  --headless      Run in headless mode for CI/CD and AI agent automation
+  -h, --help      Show this help message
+  -v, --version   Show version number
+
+EXAMPLES
+  npm create chemx my-molecular-app
+  npx create-chemx my-molecular-app --yes
+  pnpm create chemx my-app
+
+DOCUMENTATION
+  https://chemicalx.xophz.com
+\n`);
+  process.exit(0);
+}
+
+if (rawArgs.includes('--version') || rawArgs.includes('-v')) {
+  try {
+    const pkgPath = new URL('../package.json', import.meta.url);
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    process.stdout.write(`create-chemx v${pkg.version || 'unknown'}\n`);
+  } catch {
+    process.stdout.write('create-chemx\n');
+  }
+  process.exit(0);
+}
+
 const nonFlagArgs = rawArgs.filter((arg) => !arg.startsWith('-'));
 const dirArg = (nonFlagArgs[0] === 'create' || nonFlagArgs[0] === 'init' || nonFlagArgs[0] === 'scaffold')
   ? nonFlagArgs[1]

package/cli/create.spec.js

@@ -56,6 +56,36 @@ describe('Scaffolding Entrypoint Invocations', () => {
     assert.ok(fs.existsSync(path.join(defaultTarget, 'package.json')), 'package.json should exist in default directory');
   });
 
+  test('node cli/create.js --help prints usage and does not scaffold', () => {
+    const tmpBase = fs.mkdtempSync(path.join(os.tmpdir(), 'chemx-test-'));
+    cleanupDirs.push(tmpBase);
+
+    const result = spawnSync('node', [CREATE_BIN, '--help'], {
+      encoding: 'utf-8',
+      cwd: tmpBase,
+      timeout: 5000
+    });
+
+    assert.equal(result.status, 0, 'Should exit with code 0 on --help');
+    assert.match(result.stdout, /Chemical X Protocol: Project Scaffolder/, 'Should show scaffolder help');
+    assert.ok(!fs.existsSync(path.join(tmpBase, 'my-molecular-app')), 'Must not scaffold any directory on --help');
+  });
+
+  test('node cli/create.js --version prints version and does not scaffold', () => {
+    const tmpBase = fs.mkdtempSync(path.join(os.tmpdir(), 'chemx-test-'));
+    cleanupDirs.push(tmpBase);
+
+    const result = spawnSync('node', [CREATE_BIN, '--version'], {
+      encoding: 'utf-8',
+      cwd: tmpBase,
+      timeout: 5000
+    });
+
+    assert.equal(result.status, 0, 'Should exit with code 0 on --version');
+    assert.match(result.stdout, /create-chemx v/, 'Should print create-chemx version');
+    assert.ok(!fs.existsSync(path.join(tmpBase, 'my-molecular-app')), 'Must not scaffold any directory on --version');
+  });
+
   test('node cli/create.js create <dir> --yes tolerates redundant create argument', () => {
     const tmpBase = fs.mkdtempSync(path.join(os.tmpdir(), 'chemx-test-'));
     cleanupDirs.push(tmpBase);
@@ -133,14 +163,38 @@ describe('Scaffolding Entrypoint Invocations', () => {
     assert.ok(fs.existsSync(path.join(targetDir, 'package.json')), 'package.json should exist');
   });
 
-  test('node cli/index.js config still fails fast as unknown command', () => {
+  test('node cli/index.js config fails fast as unknown command without creating directory', () => {
+    const tmpBase = fs.mkdtempSync(path.join(os.tmpdir(), 'chemx-test-'));
+    cleanupDirs.push(tmpBase);
+
     const result = spawnSync('node', [INDEX_BIN, 'config'], {
       encoding: 'utf-8',
+      cwd: tmpBase,
       timeout: 5000
     });
 
     assert.equal(result.status, 1, 'Unknown command should exit with code 1');
     assert.match(result.stderr, /Unknown command "config"/, 'Should report unknown command');
+    assert.ok(!fs.existsSync(path.join(tmpBase, 'config')), 'Must NOT create a config directory');
   });
-});
 
+  test('node cli/index.js under create-chemx path STILL fails fast on unknown command (regression test)', () => {
+    const tmpBase = fs.mkdtempSync(path.join(os.tmpdir(), 'chemx-test-'));
+    cleanupDirs.push(tmpBase);
+    // Simulate being installed inside a path with "create-chemx" in its name
+    const pkgDir = path.join(tmpBase, 'node_modules', '@chemx', 'create-chemx', 'cli');
+    fs.mkdirSync(pkgDir, { recursive: true });
+    const fakeIndex = path.join(pkgDir, 'index.js');
+    fs.symlinkSync(INDEX_BIN, fakeIndex);
+
+    const result = spawnSync('node', [fakeIndex, 'config'], {
+      encoding: 'utf-8',
+      cwd: tmpBase,
+      timeout: 5000
+    });
+
+    assert.equal(result.status, 1, 'Unknown command should exit with code 1');
+    assert.match(result.stderr, /Unknown command "config"/, 'Should report unknown command');
+    assert.ok(!fs.existsSync(path.join(tmpBase, 'config')), 'Must NOT create a config directory when installed under create-chemx path');
+  });
+});

package/cli/index.js

@@ -83,11 +83,6 @@ const loadProjectConfig = () => {
     return {};
   }
 };
-const isCreateInvoked =
-  invokedBin.includes('create') ||
-  Boolean(process.argv[1] && process.argv[1].includes('create-chemx')) ||
-  Boolean(process.env.npm_lifecycle_event && process.env.npm_lifecycle_event.includes('create')) ||
-  Boolean(rawArgs[0] && (rawArgs[0] === 'create' || rawArgs[0] === 'init' || rawArgs[0] === 'scaffold'));
 
 export const runAudit = async (customDir = null, isCli = false) => {
   const projectConfig = loadProjectConfig();
@@ -296,15 +291,6 @@ export {
 const main = async () => {
   const firstArg = rawArgs[0];
 
-  if (isCreateInvoked) {
-    const nonFlagArgs = rawArgs.filter((arg) => !arg.startsWith('-'));
-    const dirArg = (nonFlagArgs[0] === 'create' || nonFlagArgs[0] === 'init' || nonFlagArgs[0] === 'scaffold')
-      ? nonFlagArgs[1]
-      : nonFlagArgs[0];
-    await runScaffold(dirArg, rawArgs, runAudit);
-    return;
-  }
-
   switch (firstArg) {
     case 'team':
     case 'swarm':
@@ -346,7 +332,8 @@ const main = async () => {
     case 'init':
       await runInit(rawArgs[1] || 'src/chemical-x', rawArgs, runAudit);
       break;
-    case 'create': {
+    case 'create':
+    case 'scaffold': {
       const nonFlagArgs = rawArgs.slice(1).filter((arg) => !arg.startsWith('-'));
       await runScaffold(nonFlagArgs[0], rawArgs, runAudit);
       break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chem-x/starter-kit",
-  "version": "26.9.20-1318",
+  "version": "26.9.20-1340",
   "description": "Chemical X Protocol: Private drop-in architecture starter kit and capsule generator",
   "type": "module",
   "bin": {