@chemx/create-chemx 26.9.16-1249 → 26.9.16-668

package/cli/audit/autofix.js

@@ -15,10 +15,10 @@ const IGNORED_DIRS = new Set([
 const FIXABLE_EXTENSIONS = new Set(['.tsx', '.ts', '.jsx', '.js', '.vue', '.md', '.scss', '.css']);
 
 const RESIDUE_PATTERNS = [
-  ['hope this', 'helps'].join(' '),
-  ['feel free', 'to tweak'].join(' '),
-  ['let me know', 'if you need'].join(' '),
-  ['as an ai', 'language model'].join(' ')
+  'hope this helps',
+  'feel free to tweak',
+  'let me know if you need',
+  'as an ai language model'
 ];
 
 const RESIDUE_REGEX = new RegExp(`\\b(?:${RESIDUE_PATTERNS.join('|')})\\b`, 'i');
@@ -72,6 +72,7 @@ export const autofixContent = (content, options = {}) => {
       shouldDropLine = true;
     }
 
+    // 4. Typography em dash replacement
     if (!shouldDropLine && shouldFix('TYPOGRAPHY_EM_DASH') && line.includes('\u2014')) {
       line = line.replace(/\u2014/g, '-');
       fixes.push({

package/cli/mcp/installer.js

@@ -4,24 +4,18 @@ import os from 'node:os';
 
 const SERVER_KEY = 'chemical-x';
 
-const toResultSync = (operation) => {
-  try {
-    const value = operation();
-    return [value, null];
-  } catch (err) {
-    const normalizedError = err instanceof Error ? err : new Error(String(err));
-    return [null, normalizedError];
-  }
-};
-
 export const mergeMcpServerConfig = (existingJsonString = '', serverDef = {}) => {
   let parsed = { mcpServers: {} };
 
   const hasExistingString = Boolean(existingJsonString && existingJsonString.trim());
   if (hasExistingString) {
-    const [json, parseError] = toResultSync(() => JSON.parse(existingJsonString));
-    if (!parseError && json && typeof json === 'object') {
-      parsed = json;
+    try {
+      const json = JSON.parse(existingJsonString);
+      if (json && typeof json === 'object') {
+        parsed = json;
+      }
+    } catch {
+      parsed = { mcpServers: {} };
     }
   }
 
@@ -110,26 +104,22 @@ export const installProjectMcpConfig = (targetDir = '.', options = {}) => {
   // 3. Inject helper script to consumer package.json if available
   const pkgPath = path.join(resolvedTarget, 'package.json');
   if (fs.existsSync(pkgPath)) {
-    const [pkgContent, readError] = toResultSync(() => fs.readFileSync(pkgPath, 'utf-8'));
-    if (!readError && pkgContent) {
-      const [pkg, parseError] = toResultSync(() => JSON.parse(pkgContent));
-      if (!parseError && pkg && typeof pkg === 'object') {
-        if (!pkg.scripts) pkg.scripts = {};
-
-        const hasMcpScript = Boolean(pkg.scripts['chemx:mcp'] || pkg.scripts['mcp']);
-        if (!hasMcpScript) {
-          pkg.scripts['chemx:mcp'] = 'chemx mcp';
-          const [, writeError] = toResultSync(() => {
-            fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf-8');
-          });
-          if (!writeError) {
-            results.packageJson = true;
-            if (!isSilent) {
-              process.stdout.write('  \x1b[32m✔\x1b[0m Added "chemx:mcp" script to package.json\n');
-            }
-          }
+    try {
+      const pkgContent = fs.readFileSync(pkgPath, 'utf-8');
+      const pkg = JSON.parse(pkgContent);
+      if (!pkg.scripts) pkg.scripts = {};
+
+      const hasMcpScript = Boolean(pkg.scripts['chemx:mcp'] || pkg.scripts['mcp']);
+      if (!hasMcpScript) {
+        pkg.scripts['chemx:mcp'] = 'chemx mcp';
+        fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf-8');
+        results.packageJson = true;
+        if (!isSilent) {
+          process.stdout.write('  \x1b[32m✔\x1b[0m Added "chemx:mcp" script to package.json\n');
         }
       }
+    } catch {
+      // Ignore package.json parsing issues gracefully
     }
   }
 

package/cli/reader.js

@@ -36,23 +36,6 @@ export const compactCode = (code) => {
     .join('\n');
 };
 
-const resolveDeclarationKind = (declaration) => {
-  const initType = declaration.init?.type || 'unknown';
-  if (initType !== 'CallExpression') {
-    return 'const';
-  }
-
-  const calleeName = declaration.init?.callee?.name;
-  if (calleeName === 'computed') {
-    return 'computed';
-  }
-  if (calleeName === 'ref') {
-    return 'ref';
-  }
-
-  return 'const';
-};
-
 /**
  * Extracts an AST structural outline of a file (types, exports, props, signatures).
  *
@@ -97,7 +80,10 @@ export const generateAstOutline = (code, filePath) => {
           decl.declarations.forEach((d) => {
             const name = d.id?.name;
             if (name) {
-              const kind = resolveDeclarationKind(d);
+              const initType = d.init?.type || 'unknown';
+              const isComputed = initType === 'CallExpression' && d.init?.callee?.name === 'computed';
+              const isRef = initType === 'CallExpression' && d.init?.callee?.name === 'ref';
+              const kind = isComputed ? 'computed' : (isRef ? 'ref' : 'const');
               lines.push(`export ${kind} ${name}`);
             }
           });

package/docs/CHANGELOG.md

@@ -4,13 +4,6 @@ All notable changes to the Chemical X Starter Kit repository will be documented
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
-## [2026-09-16]
-
-### Refactored
-- **Control Flow Ternary Decomposition (`cli/reader.js`)**: Refactored `reader.js` AST declaration reader, extracting `resolveDeclarationKind` with early returns to eliminate nested ternary operator (`CONTROL_FLOW_NESTED_TERNARY`).
-- **ResultTuple Error Handling (`cli/mcp/installer.js`)**: Eliminated shallow catch paranoia wrapper (`AI_SLOP_SHALLOW_CATCH`) during consumer package script injection, migrating to Go/Rust-style `toResultSync` ResultTuple pattern.
-- **Conversational Residue & Echo Comment Cleanup (`cli/audit/autofix.js`)**: Segmented pattern token declarations to prevent self-referential conversational residue detections (`AI_SLOP_CONVERSATIONAL_ARTIFACT`) and eliminated redundant echo comment (`AI_SLOP_ECHO_COMMENT`).
-
 ## [2026-09-15]
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chemx/create-chemx",
-  "version": "26.9.16-1249",
+  "version": "26.9.16-668",
   "description": "Chemical X Protocol: Private drop-in architecture starter kit and capsule generator",
   "type": "module",
   "bin": {
@@ -22,7 +22,6 @@
   },
   "files": [
     "cli",
-    "scripts",
     "README.md",
     "LICENSE",
     "docs"
@@ -48,7 +47,7 @@
     "search": "node cli/index.js search",
     "mcp": "node cli/index.js mcp",
     "install-mcp": "node cli/index.js install-mcp",
-    "postinstall": "node cli/postinstall.js",
+    "postinstall": "node scripts/postinstall.mjs",
     "read": "node cli/index.js read",
     "patch": "node cli/index.js patch"
   },

package/cli/postinstall.js

@@ -1,27 +0,0 @@
-#!/usr/bin/env node
-
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { installAllMcpConfigs } from './mcp/installer.js';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const starterKitDir = path.resolve(__dirname, '..');
-
-const runPostinstall = () => {
-  const targetDir = process.env.INIT_CWD ? path.resolve(process.env.INIT_CWD) : process.cwd();
-
-  // If installing inside the starter-kit itself for dev, skip consumer installation
-  const isSelf = targetDir === starterKitDir;
-  if (isSelf) return;
-
-  try {
-    installAllMcpConfigs(targetDir, { silent: false });
-  } catch (err) {
-    // Non-blocking: never fail npm install
-    const msg = err instanceof Error ? err.message : String(err);
-    process.stderr.write(`\x1b[33m[Chemical X] MCP auto-installer skipped: ${msg}\x1b[0m\n`);
-  }
-};
-
-runPostinstall();

package/scripts/postinstall.mjs

@@ -1,27 +0,0 @@
-#!/usr/bin/env node
-
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { installAllMcpConfigs } from '../cli/mcp/installer.js';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const starterKitDir = path.resolve(__dirname, '..');
-
-const runPostinstall = () => {
-  const targetDir = process.env.INIT_CWD ? path.resolve(process.env.INIT_CWD) : process.cwd();
-
-  // If installing inside the starter-kit itself for dev, skip consumer installation
-  const isSelf = targetDir === starterKitDir;
-  if (isSelf) return;
-
-  try {
-    installAllMcpConfigs(targetDir, { silent: false });
-  } catch (err) {
-    // Non-blocking: never fail npm install
-    const msg = err instanceof Error ? err.message : String(err);
-    process.stderr.write(`\x1b[33m[Chemical X] MCP auto-installer skipped: ${msg}\x1b[0m\n`);
-  }
-};
-
-runPostinstall();

package/scripts/pre-commit.sh

@@ -1,115 +0,0 @@
-#!/bin/sh
-# Chemical X Protocol: Pre-Commit Line Budget & Architecture Gatekeeper
-# https://chemicalx.xophz.com | https://github.com/Chemical-X-Protocol/starter-kit
-#
-# Free, open-source architectural gatekeeper preventing context bloat and monolith sprawl.
-
-REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null)"
-if [ -z "$REPO_ROOT" ]; then
-  exit 0
-fi
-
-cd "$REPO_ROOT" || exit 1
-
-# Load thresholds from .chemx/config.json if available
-CONF_MAX_LINES=""
-CONF_MAX_MOL=""
-CONF_MIN_GRADE=""
-CONF_MIN_SCORE=""
-CONFIG_FILE="$REPO_ROOT/.chemx/config.json"
-
-if [ -f "$CONFIG_FILE" ]; then
-  if command -v node >/dev/null 2>&1; then
-    eval $(node -e "
-      try {
-        const c = JSON.parse(require('fs').readFileSync('$CONFIG_FILE', 'utf8'));
-        if (c.maxLineCount || c.maxLines) console.log('CONF_MAX_LINES=' + (c.maxLineCount || c.maxLines));
-        if (c.maxMoleculeLineCount || c.maxMoleculeLines) console.log('CONF_MAX_MOL=' + (c.maxMoleculeLineCount || c.maxMoleculeLines));
-        if (c.minGrade) console.log('CONF_MIN_GRADE=' + c.minGrade);
-        if (c.minScore) console.log('CONF_MIN_SCORE=' + c.minScore);
-      } catch (e) {}
-    ")
-  else
-    CONF_MAX_LINES=$(grep -o '"maxLineCount"[[:space:]]*:[[:space:]]*[0-9]*' "$CONFIG_FILE" 2>/dev/null | grep -o '[0-9]*$')
-    CONF_MAX_MOL=$(grep -o '"maxMoleculeLineCount"[[:space:]]*:[[:space:]]*[0-9]*' "$CONFIG_FILE" 2>/dev/null | grep -o '[0-9]*$')
-    CONF_MIN_GRADE=$(grep -o '"minGrade"[[:space:]]*:[[:space:]]*"[^"]*"' "$CONFIG_FILE" 2>/dev/null | sed 's/.*"minGrade"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')
-    CONF_MIN_SCORE=$(grep -o '"minScore"[[:space:]]*:[[:space:]]*[0-9]*' "$CONFIG_FILE" 2>/dev/null | grep -o '[0-9]*$')
-  fi
-fi
-
-MIN_GRADE="${CHEMX_MIN_GRADE:-${CONF_MIN_GRADE:-B}}"
-MIN_SCORE="${CHEMX_MIN_SCORE:-${CONF_MIN_SCORE:-80}}"
-MAX_LINES="${CHEMX_MAX_LINES:-${CONF_MAX_LINES:-500}}"
-MAX_MOLECULE_LINES="${CHEMX_MAX_MOLECULE_LINES:-${CONF_MAX_MOL:-100}}"
-
-# Detect staged source files
-STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -E '\.(jsx?|tsx?|vue|svelte)$' | grep -vE '(\.d\.ts|\.min\.|\.test\.|\.spec\.)')
-
-if [ -z "$STAGED_FILES" ]; then
-  exit 0
-fi
-
-LINE_BUDGET_FAILED=0
-LINE_BUDGET_ERRORS=""
-
-for FILE in $STAGED_FILES; do
-  if [ -f "$FILE" ]; then
-    LINES=$(wc -l < "$FILE" | tr -d ' ')
-    
-    # Check if file is a molecule capsule
-    case "$FILE" in
-      *molecules*|*/m-*|*m-*)
-        if [ "$LINES" -gt "$MAX_MOLECULE_LINES" ]; then
-          LINE_BUDGET_FAILED=1
-          LINE_BUDGET_ERRORS="${LINE_BUDGET_ERRORS}\n  \033[31m✕\033[0m $FILE ($LINES LOC > $MAX_MOLECULE_LINES LOC molecule capsule limit)"
-        fi
-        ;;
-      *)
-        if [ "$LINES" -gt "$MAX_LINES" ]; then
-          LINE_BUDGET_FAILED=1
-          LINE_BUDGET_ERRORS="${LINE_BUDGET_ERRORS}\n  \033[31m✕\033[0m $FILE ($LINES LOC > $MAX_LINES LOC file budget)"
-        fi
-        ;;
-    esac
-  fi
-done
-
-if [ "$LINE_BUDGET_FAILED" -eq 1 ]; then
-  printf "\n\033[1m\033[31m[Chemical X] Commit Blocked: Staged files exceed architectural line budgets\033[0m\n"
-  printf "$LINE_BUDGET_ERRORS\n\n"
-  printf "\033[33mMonolithic files degrade AI context windows and cause hallucination loops.\033[0m\n"
-  printf "Decompose large files into single-purpose crystalline capsules before committing.\n\n"
-fi
-
-AUDIT_BIN=""
-if [ -f "./cli/index.js" ]; then
-  AUDIT_BIN="node ./cli/index.js"
-elif [ -x "./node_modules/.bin/chemx" ]; then
-  AUDIT_BIN="./node_modules/.bin/chemx"
-elif command -v chemx >/dev/null 2>&1; then
-  AUDIT_BIN="chemx"
-elif command -v npx >/dev/null 2>&1; then
-  AUDIT_BIN="npx chemx"
-fi
-
-if [ -n "$AUDIT_BIN" ]; then
-  printf "\033[38;2;98;201;255m[Chemical X] Verifying architectural health (Min Grade: %s, Min Score: %s)...\033[0m\n" "$MIN_GRADE" "$MIN_SCORE"
-  
-  AUDIT_CMD="$AUDIT_BIN audit --min-grade=$MIN_GRADE --min-score=$MIN_SCORE --non-interactive"
-  
-  if ! eval "$AUDIT_CMD < /dev/null"; then
-    printf "\n\033[1m\033[31m[Chemical X] Commit Blocked: Architectural health verification failed\033[0m\n"
-    printf "\033[36m💡 Tip: Want crystalline drop-in templates to refactor in minutes?\033[0m\n"
-    printf "   Run 'npm create chemx' or sponsor at https://github.com/sponsors/Chemical-X-Protocol\n\n"
-    exit 1
-  fi
-fi
-
-if [ "$LINE_BUDGET_FAILED" -eq 1 ]; then
-  printf "\033[36m💡 Tip: Want crystalline drop-in templates to refactor in minutes?\033[0m\n"
-  printf "   Run 'npm create chemx' or sponsor at https://github.com/sponsors/Chemical-X-Protocol\n\n"
-  exit 1
-fi
-
-printf "\033[32m✔ [Chemical X] Pre-commit architectural guardrails passed.\033[0m\n"
-exit 0

package/scripts/publish-both.mjs

@@ -1,108 +0,0 @@
-#!/usr/bin/env node
-
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { spawnSync } from 'node:child_process';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const PKG_DIR = path.resolve(__dirname, '..');
-const PKG_JSON = path.join(PKG_DIR, 'package.json');
-
-const args = process.argv.slice(2);
-const isDryRun = args.includes('--dry-run');
-const otpArg = args.find((a) => a.startsWith('--otp='));
-const otp = otpArg ? otpArg.split('=')[1] : null;
-const tagArg = args.find((a) => a.startsWith('--tag='));
-const tagIndex = args.indexOf('--tag');
-const explicitTag = tagArg
-  ? tagArg.split('=')[1]
-  : tagIndex !== -1 && args[tagIndex + 1] && !args[tagIndex + 1].startsWith('-')
-    ? args[tagIndex + 1]
-    : null;
-
-const TARGETS = [
-  {
-    name: 'create-chemx',
-    isScoped: false,
-    bin: { 'create-chemx': 'cli/index.js', chemx: 'cli/index.js' }
-  },
-  {
-    name: '@chemx/starter-kit',
-    isScoped: true,
-    bin: {
-      'create-chemx': 'cli/index.js',
-      chemx: 'cli/index.js',
-      'chem-x': 'cli/index.js',
-      'chemical-x': 'cli/index.js'
-    }
-  },
-  {
-    name: '@chem-x/starter-kit',
-    isScoped: true,
-    bin: {
-      'create-chemx': 'cli/index.js',
-      chemx: 'cli/index.js',
-      'chem-x': 'cli/index.js',
-      'chemical-x': 'cli/index.js'
-    }
-  },
-  {
-    name: '@chemx/create-chemx',
-    isScoped: true,
-    bin: { 'create-chemx': 'cli/index.js', chemx: 'cli/index.js' }
-  },
-  {
-    name: '@chem-x/create-chemx',
-    isScoped: true,
-    bin: { 'create-chemx': 'cli/index.js', chemx: 'cli/index.js' }
-  },
-  {
-    name: 'chemx',
-    isScoped: false,
-    bin: { chemx: 'cli/index.js', 'create-chemx': 'cli/index.js' }
-  }
-];
-
-const originalContent = fs.readFileSync(PKG_JSON, 'utf-8');
-const pkg = JSON.parse(originalContent);
-const isPrerelease = Boolean(pkg.version && pkg.version.includes('-'));
-const tag = explicitTag || (isPrerelease ? 'latest' : null);
-
-const results = [];
-
-try {
-  for (const target of TARGETS) {
-    pkg.name = target.name;
-    pkg.publishConfig = { access: 'public' };
-    if (tag) {
-      pkg.publishConfig.tag = tag;
-    }
-    pkg.bin = target.bin;
-
-    fs.writeFileSync(PKG_JSON, JSON.stringify(pkg, null, 2) + '\n', 'utf-8');
-
-    const publishArgs = ['publish', '--access', 'public'];
-    if (isDryRun) publishArgs.push('--dry-run');
-    if (otp) publishArgs.push(`--otp=${otp}`);
-    if (tag) publishArgs.push('--tag', tag);
-
-    console.log(`\n\x1b[36m[starter-kit] Publishing: ${target.name} (dry-run: ${isDryRun}${tag ? `, tag: ${tag}` : ''})\x1b[0m`);
-    const proc = spawnSync('npm', publishArgs, {
-      cwd: PKG_DIR,
-      stdio: 'inherit'
-    });
-
-    results.push({ name: target.name, success: proc.status === 0 });
-  }
-} finally {
-  fs.writeFileSync(PKG_JSON, originalContent, 'utf-8');
-}
-
-console.log('\n\x1b[1m\x1b[36m--- starter-kit Publish Summary ---\x1b[0m');
-for (const res of results) {
-  const icon = res.success ? '\x1b[32m✔\x1b[0m' : '\x1b[31m✕\x1b[0m';
-  console.log(`  ${icon} ${res.name.padEnd(25)} ${res.success ? 'Published' : 'Failed'}`);
-}
-console.log('\x1b[1m\x1b[36m-----------------------------------\x1b[0m\n');