devendra-skill-package 1.0.2

package/.github/skills/boiler-project-generator/references/react-native.md

@@ -0,0 +1,103 @@
+# React Native — Reference Guide
+
+## Direct Script Invocation
+
+For React Native projects, call the generator script directly with all flags:
+
+```powershell
+node .github/skills/boiler-project-generator/scripts/react-native.js \
+  --project MyApp \
+  --language typescript \
+  --enableNavigation yes \
+  --enableRedux yes \
+  --enableEnv yes \
+  --verificationTarget none
+```
+
+The script handles everything end-to-end: scaffold, dependencies, templates, compatibility verification, and summary.
+
+## Progress Steps
+
+The script prints numbered progress steps so you know it is still running:
+
+1. `[1/6]` Installing core packages (axios, react-native-config)
+2. `[2/6]` Installing navigation packages (or skipped)
+3. `[3/6]` Installing Redux Toolkit (or skipped)
+4. `[4/6]` Installing environment config (or skipped)
+5. `[5/6]` Applying templates and wiring entry point
+6. `[6/6]` Verifying dependency compatibility
+
+Do NOT interrupt the script between these steps. Package installs can take several minutes.
+
+## Navigation and Reanimated Compatibility
+
+| React Native | Reanimated | Gesture Handler | Screens | Safe Area Context | Worklets |
+|---|---|---|---|---|---|
+| 0.79.x | 3.16.1 | 2.20.2 | 4.4.0 | 4.14.0 | N/A |
+| 0.80+ / latest | 4.x | latest | latest | latest | Required |
+
+- For RN 0.80+, always install `react-native-worklets` explicitly alongside `react-native-reanimated@4`.
+- Do NOT use the 0.79.x pinned versions on 0.80+ — they cause Android build failures due to removed APIs (`LayoutAnimationController`, `UIManagerModuleListener`, `ChoreographerCompat`).
+- The script automatically resolves the actual installed RN version (handles `latest` input) and selects the correct package set.
+
+## Dependency Compatibility
+
+After all packages are installed, the script runs `npm ls --depth=0` to detect peer dependency issues.
+
+- If issues are found, it attempts a clean reinstall (`rm node_modules + npm install`).
+- If version-pinned packages cause ERESOLVE conflicts during install, the script retries with unpinned versions to auto-resolve compatible ones.
+- Remaining issues are reported as warnings in the final summary.
+
+## Generated Project Structure
+
+```
+<ProjectName>/
+  src/
+    assets/image/
+    components/PrimaryButton.tsx
+    features/
+      auth/AuthScreen.tsx
+      dashboard/DashboardScreen.tsx
+      profile/ProfileScreen.tsx
+    hooks/useAppBoot.ts
+    navigation/RootNavigator.tsx      (if enableNavigation=yes)
+    services/api.ts
+    store/                            (if enableRedux=yes)
+      store.ts
+      hooks.ts
+      sessionSlice.ts
+    theme/index.ts
+    utils/helpers.ts
+  .env.uat                            (if enableEnv=yes)
+  .env.staging                        (if enableEnv=yes)
+  .env.prod                           (if enableEnv=yes)
+  App.tsx
+  babel.config.js
+```
+
+## Post-Generation
+
+- Replace placeholder API URLs in `.env.*` with real endpoints.
+- Add app icons and splash screen assets to `src/assets/image/`.
+- Extend `RootNavigator.tsx` with additional screens.
+- Wire auth token logic into `useAppBoot.ts`.
+
+## Verification
+
+The script runs lint, typecheck, and tests automatically after generation. Platform builds (Android/iOS) run only when `--verificationTarget` is set.
+
+To manually verify TypeScript:
+
+```bash
+cd <ProjectName>
+npx tsc --noEmit
+```
+
+## Troubleshooting
+
+| Error | Fix |
+|-------|-----|
+| `ERESOLVE` dependency conflict | Script auto-retries with unpinned versions, then clean reinstall |
+| Android build fails with reanimated/worklets error | Script auto-adds `react-native-worklets` and retries |
+| `pod install` fails | Run `cd ios && pod install --repo-update` manually (macOS only) |
+| Terminal appears stuck during init | The `react-native init` step takes several minutes — wait for it |

package/.github/skills/boiler-project-generator/references/react.md

@@ -0,0 +1,17 @@
+# React Reference: Post-generation Validation and Notes
+
+This reference contains React-specific guidance for the `boiler-project-generator` skill. Use these steps when `framework=react` or generating React projects.
+
+1. After the generator finishes, change directory into the generated project: `cd <projectName>`.
+2. Install dependencies: `npm install` or `yarn`.
+3. Run static analysis and linting: `npm run lint` (ensure an ESLint config exists).
+4. Run tests: `npm test`.
+5. Build the production bundle: `npm run build` and verify the `build/` output.
+
+Validation notes
+- Capture lint warnings/errors and test failures into the skill report JSON.
+- Verify the project includes a README, license, and CI workflow for common platforms (GitHub Actions, Azure Pipelines, etc.).
+
+CI guidance
+- Use Node.js official runner images and cache `node_modules` between runs.
+- For static hosting, ensure build artifacts are uploaded to the expected artifact path.

package/.github/skills/boiler-project-generator/scripts/angular.js

@@ -0,0 +1,43 @@
+const { execSync } = require('node:child_process');
+
+function getFlag(name) {
+  const idx = process.argv.indexOf(name);
+  if (idx === -1) return null;
+  return process.argv[idx + 1] || null;
+}
+
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+  console.log('Usage: node angular.js <projectName> <language> [--template <name>]');
+  process.exit(0);
+}
+
+const projectName = getFlag('--project') || process.argv[2] || 'my-angular-app';
+const language = getFlag('--language') || process.argv[3] || 'typescript';
+const template = getFlag('--template');
+const buildEnv = { ...process.env, NG_CLI_ANALYTICS: 'false' };
+
+console.log('Creating Angular project...');
+
+if (language === 'javascript') {
+  console.log('Angular CLI generates TypeScript projects. Proceeding with TypeScript.');
+}
+
+const templateArg = '';
+// template currently not used for Angular CLI, reserved for future templates
+
+execSync(
+  `npx @angular/cli@latest new ${projectName} --routing --style=scss --defaults ${templateArg}`,
+  { stdio: 'inherit', env: buildEnv }
+);
+
+console.log(`Validating Angular project in ${projectName}...`);
+
+try {
+  execSync('npm run build', { cwd: projectName, stdio: 'inherit', env: buildEnv });
+} catch (err) {
+  console.error('Build failed during validation:', err.message);
+  process.exit(2);
+}
+
+console.log('Angular project ready!');
+console.log(`Run future Angular commands from inside ${projectName}.`);

package/.github/skills/boiler-project-generator/scripts/generate-project.mjs

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+function parseFlag(name) {
+  const idx = process.argv.indexOf(name);
+  if (idx === -1) return null;
+  return process.argv[idx + 1] || null;
+}
+
+function hasFlag(name) {
+  return process.argv.includes(name);
+}
+
+function showHelp() {
+  console.log('Usage: node generate-project.mjs --framework <angular|react|react-native|other> --language <javascript|typescript> --project <name> [--template <name>] [--dry-run] [--force]');
+}
+
+if (hasFlag('--help') || hasFlag('-h')) {
+  showHelp();
+  process.exit(0);
+}
+
+const framework = parseFlag('--framework') || 'angular';
+const language = parseFlag('--language') || 'javascript';
+const project = parseFlag('--project') || `my-${framework}-app`;
+const template = parseFlag('--template') || 'minimal';
+const dryRun = hasFlag('--dry-run');
+const force = hasFlag('--force');
+
+const reportDir = path.join(process.cwd(), 'artifacts', 'boiler-generator');
+if (!fs.existsSync(reportDir)) fs.mkdirSync(reportDir, { recursive: true });
+const reportPath = path.join(reportDir, `${project}-report.json`);
+
+const report = {
+  projectName: project,
+  framework,
+  language,
+  template,
+  dryRun,
+  force,
+  timestamp: new Date().toISOString(),
+  status: 'pending',
+  steps: []
+};
+
+function writeReportAndExit(code) {
+  try {
+    // Deterministic fields ordering
+    const out = {
+      projectName: report.projectName,
+      framework: report.framework,
+      language: report.language,
+      template: report.template,
+      dryRun: report.dryRun,
+      force: report.force,
+      timestamp: report.timestamp,
+      status: report.status,
+      steps: report.steps
+    };
+    fs.writeFileSync(reportPath, JSON.stringify(out, null, 2));
+    console.log('Wrote report to', reportPath);
+  } catch (err) {
+    console.error('Failed to write report:', err.message);
+  }
+  process.exit(code);
+}
+
+report.steps.push({ step: 'validate-inputs', ok: true, details: 'Inputs parsed' });
+
+if (dryRun) {
+  report.status = 'dry-run';
+  report.steps.push({ step: 'dry-run', ok: true, details: `Would invoke framework script for ${framework} with template ${template}` });
+  writeReportAndExit(0);
+}
+
+// Invoke the existing init.js orchestrator with flags for deterministic execution
+const node = process.execPath;
+const initScript = path.join(__dirname, 'init.js');
+const args = [initScript, '--framework', framework, '--language', language, '--project', project];
+if (template) args.push('--template', template);
+if (force) args.push('--force');
+
+report.steps.push({ step: 'invoke-orchestrator', ok: null, details: `Running: ${node} ${args.join(' ')}` });
+
+const res = spawnSync(node, args, { stdio: 'inherit' });
+
+if (res.error) {
+  report.status = 'failed';
+  report.steps.push({ step: 'invoke-orchestrator', ok: false, details: res.error.message });
+  writeReportAndExit(2);
+}
+
+if (res.status !== 0) {
+  report.status = 'failed';
+  report.steps.push({ step: 'orchestrator-exit', ok: false, details: `exitCode=${res.status}` });
+  writeReportAndExit(res.status);
+}
+
+report.status = 'success';
+report.steps.push({ step: 'orchestrator-exit', ok: true, details: 'orchestrator completed successfully' });
+writeReportAndExit(0);

package/.github/skills/boiler-project-generator/scripts/init.js

@@ -0,0 +1,105 @@
+const path = require('node:path');
+const readline = require('node:readline');
+const { execFileSync } = require('node:child_process');
+
+function parseFlag(name) {
+  const idx = process.argv.indexOf(name);
+  if (idx === -1) return null;
+  return process.argv[idx + 1] || null;
+}
+
+function showHelp() {
+  console.log('Usage: node init.js [--framework <angular|react|react-native|other>] [--language <javascript|typescript>] [--project <name>] [--template <name>] [-- additional flags]');
+  console.log('Additional framework-specific flags (e.g. --enableNavigation, --enableRedux) are forwarded to the child script.');
+  console.log('If no flags provided, runs interactive prompt.');
+}
+
+function runScript(scriptName, projectName, language, template) {
+  const args = [path.join(__dirname, scriptName)];
+  if (projectName) args.push(projectName);
+  if (language) args.push(language);
+  if (template) args.push('--template', template);
+
+  // Forward any additional CLI flags not consumed by init.js to the child script
+  const consumed = new Set(['--framework', '--language', '--project', '--template', '--help', '-h']);
+  for (let i = 2; i < process.argv.length; i += 1) {
+    const token = process.argv[i];
+    if (!token.startsWith('--')) continue;
+    if (consumed.has(token)) {
+      if (process.argv[i + 1] && !process.argv[i + 1].startsWith('--')) i += 1;
+      continue;
+    }
+    args.push(token);
+    if (process.argv[i + 1] && !process.argv[i + 1].startsWith('--')) {
+      i += 1;
+      args.push(process.argv[i]);
+    }
+  }
+
+  execFileSync(process.execPath, args, { stdio: 'inherit' });
+}
+
+const frameworkFlag = parseFlag('--framework');
+const languageFlag = parseFlag('--language');
+const projectFlag = parseFlag('--project');
+const templateFlag = parseFlag('--template');
+
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+  showHelp();
+  process.exit(0);
+}
+
+if (frameworkFlag) {
+  const framework = frameworkFlag.toLowerCase();
+  const language = languageFlag || 'javascript';
+  const projectName = projectFlag || 'my-app';
+
+  switch (framework) {
+    case 'angular':
+      runScript('angular.js', projectName, language, templateFlag);
+      break;
+    case 'react':
+      runScript('react.js', projectName, language, templateFlag);
+      break;
+    case 'react-native':
+      runScript('react-native.js', projectName, language, templateFlag);
+      break;
+    default:
+      console.log(`Custom framework selected: ${framework}. Extend script here.`);
+  }
+
+  process.exit(0);
+}
+
+// Interactive fallback
+const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+rl.question(
+  `Select technology:\n1. Angular\n2. React\n3. React Native\n4. Other\n\nEnter choice: `,
+  (choice) => {
+    rl.question(`Select language:\n1. JavaScript\n2. TypeScript\n\nEnter choice: `, (languageChoice) => {
+      const language = languageChoice === '2' ? 'typescript' : 'javascript';
+
+      rl.question('Enter project name: ', (projectName) => {
+        switch (choice) {
+          case '1':
+            runScript('angular.js', projectName, language, templateFlag);
+            break;
+          case '2':
+            runScript('react.js', projectName, language, templateFlag);
+            break;
+          case '3':
+            runScript('react-native.js', projectName, language, templateFlag);
+            break;
+          case '4':
+            console.log(`Custom framework selected with ${language}. Extend script here.`);
+            break;
+          default:
+            console.log('Invalid choice');
+        }
+
+        rl.close();
+      });
+    });
+  }
+);