@mouryaamit/nx-polystack 0.0.0-stage → 1.0.1

package/dist/bin/cli.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/bin/cli.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+"use strict";
+// pstack — @mouryaamit/nx-polystack CLI. Run `pstack --help` for usage.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const path = tslib_1.__importStar(require("path"));
+const args_1 = require("../src/cli/args");
+const commands_1 = require("../src/cli/commands");
+const context_1 = require("../src/cli/context");
+const help_1 = require("../src/cli/help");
+const launcher_1 = require("../src/cli/launcher");
+const types_1 = require("../src/cli/types");
+async function main(argv) {
+    const { command, positionals, flags } = (0, args_1.parseArgs)(argv);
+    const selfRoot = (0, context_1.selfPackageRoot)(__dirname);
+    const selfVersion = (0, context_1.readPackageVersion)(path.join(selfRoot, 'package.json'));
+    const cwd = process.cwd();
+    const wsRoot = (0, context_1.findWorkspaceRoot)(cwd);
+    const local = wsRoot ? (0, context_1.resolveLocalPlugin)(wsRoot) : null;
+    if (flags['v'] || flags['version']) {
+        console.log(selfVersion);
+        if (local && local.root !== selfRoot && local.version !== selfVersion) {
+            console.log(`workspace plugin: ${local.version}`);
+        }
+        return 0;
+    }
+    if (!command || command === 'help' || flags['h'] || flags['help']) {
+        console.log((0, help_1.helpText)(selfVersion));
+        return 0;
+    }
+    if (local && wsRoot && (0, launcher_1.shouldDelegate)({ command, flags, env: process.env, selfRoot, local })) {
+        try {
+            (0, launcher_1.assertLocalSupports)(command, local.version, flags);
+        }
+        catch (err) {
+            console.error(`\nError: ${err instanceof Error ? err.message : String(err)}`);
+            return 1;
+        }
+        const hint = (0, launcher_1.upgradeHint)(local.version, selfVersion);
+        if (hint)
+            console.error(hint);
+        // Older local CLIs only look for nx.json in their cwd, so app/env/lib/llm run from the workspace root.
+        const delegateCwd = launcher_1.WORKSPACE_COMMANDS.has(command) ? wsRoot : cwd;
+        return (0, launcher_1.delegate)(local.cliPath, (0, launcher_1.delegationArgs)(command, argv, cwd, delegateCwd), delegateCwd);
+    }
+    if (wsRoot && !local && launcher_1.WORKSPACE_COMMANDS.has(command)) {
+        console.error('pstack: this workspace does not have @mouryaamit/nx-polystack installed; ' +
+            `using global v${selfVersion}.`);
+    }
+    const handler = commands_1.COMMANDS[command];
+    if (!handler) {
+        console.error(`Unknown command: "${command}"\n\nRun "pstack --help" to see available commands.`);
+        return 1;
+    }
+    let verbose;
+    let dryRun;
+    try {
+        verbose = (0, args_1.flagBoolean)(flags, 'verbose');
+        dryRun = !!flags['d'] || (0, args_1.flagBoolean)(flags, 'dryRun');
+    }
+    catch (err) {
+        console.error(`\nError: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+    const ctx = {
+        cwd,
+        positionals,
+        flags,
+        dryRun,
+        verbose,
+        selfVersion,
+        selfRoot,
+    };
+    try {
+        return await handler(ctx);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`\nError: ${message}`);
+        if (verbose && !(err instanceof types_1.CliError) && err instanceof Error && err.stack) {
+            console.error(err.stack);
+        }
+        return 1;
+    }
+}
+main(process.argv.slice(2)).then((code) => {
+    process.exitCode = code;
+}, (err) => {
+    console.error(err);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../bin/cli.ts"],"names":[],"mappings":";AAAA,wEAAwE;;;AAExE,mDAA6B;AAE7B,0CAAyD;AACzD,kDAA+C;AAC/C,gDAK4B;AAC5B,0CAA2C;AAC3C,kDAO6B;AAC7B,4CAA4D;AAE5D,KAAK,UAAU,IAAI,CAAC,IAAc;IAChC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,IAAA,gBAAS,EAAC,IAAI,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,IAAA,yBAAe,EAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,IAAA,4BAAkB,EAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;IAC5E,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,IAAA,2BAAiB,EAAC,GAAG,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAA,4BAAkB,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEzD,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE;QAClC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzB,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,KAAK,WAAW,EAAE;YACrE,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;SACnD;QACD,OAAO,CAAC,CAAC;KACV;IAED,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE;QACjE,OAAO,CAAC,GAAG,CAAC,IAAA,eAAQ,EAAC,WAAW,CAAC,CAAC,CAAC;QACnC,OAAO,CAAC,CAAC;KACV;IAED,IAAI,KAAK,IAAI,MAAM,IAAI,IAAA,yBAAc,EAAC,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE;QAC5F,IAAI;YACF,IAAA,8BAAmB,EAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;SACpD;QAAC,OAAO,GAAY,EAAE;YACrB,OAAO,CAAC,KAAK,CAAC,YAAY,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9E,OAAO,CAAC,CAAC;SACV;QACD,MAAM,IAAI,GAAG,IAAA,sBAAW,EAAC,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACrD,IAAI,IAAI;YAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9B,uGAAuG;QACvG,MAAM,WAAW,GAAG,6BAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;QACnE,OAAO,IAAA,mBAAQ,EAAC,KAAK,CAAC,OAAO,EAAE,IAAA,yBAAc,EAAC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC;KAC9F;IAED,IAAI,MAAM,IAAI,CAAC,KAAK,IAAI,6BAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;QACvD,OAAO,CAAC,KAAK,CACX,2EAA2E;YACzE,iBAAiB,WAAW,GAAG,CAClC,CAAC;KACH;IAED,MAAM,OAAO,GAAG,mBAAQ,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,OAAO,EAAE;QACZ,OAAO,CAAC,KAAK,CACX,qBAAqB,OAAO,qDAAqD,CAClF,CAAC;QACF,OAAO,CAAC,CAAC;KACV;IAED,IAAI,OAAgB,CAAC;IACrB,IAAI,MAAe,CAAC;IACpB,IAAI;QACF,OAAO,GAAG,IAAA,kBAAW,EAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACxC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,IAAA,kBAAW,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;KACvD;IAAC,OAAO,GAAY,EAAE;QACrB,OAAO,CAAC,KAAK,CAAC,YAAY,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9E,OAAO,CAAC,CAAC;KACV;IACD,MAAM,GAAG,GAAmB;QAC1B,GAAG;QACH,WAAW;QACX,KAAK;QACL,MAAM;QACN,OAAO;QACP,WAAW;QACX,QAAQ;KACT,CAAC;IAEF,IAAI;QACF,OAAO,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;KAC3B;IAAC,OAAO,GAAY,EAAE;QACrB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,KAAK,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC;QACrC,IAAI,OAAO,IAAI,CAAC,CAAC,GAAG,YAAY,gBAAQ,CAAC,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE;YAC9E,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;SAC1B;QACD,OAAO,CAAC,CAAC;KACV;AACH,CAAC;AAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAC9B,CAAC,IAAI,EAAE,EAAE;IACP,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC,EACD,CAAC,GAAG,EAAE,EAAE;IACN,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CACF,CAAC"}

package/dist/executors.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "./node_modules/nx/schemas/nx-devkit-executors.json",
+  "name": "@mouryaamit/nx-polystack",
+  "version": "0.1.0",
+  "executors": {
+    "build": {
+      "implementation": "./src/executors/build/executor",
+      "schema": "./src/executors/build/schema.json",
+      "description": "Full build pipeline for Angular/Ionic apps: encrypt-env \u2192 nx build \u2192 strip-exif \u2192 inject-meta, with optional CSP nonce, SRI hash, and hardening steps."
+    },
+    "flutter-build": {
+      "implementation": "./src/executors/flutter-build/executor",
+      "schema": "./src/executors/flutter-build/schema.json",
+      "description": "Build or serve a Flutter application (web, APK, iOS). Wraps the Flutter CLI with --dart-define-from-file env wiring and optional --obfuscate support."
+    },
+    "flutter-export": {
+      "implementation": "./src/executors/flutter-export/executor",
+      "schema": "./src/executors/flutter-export/schema.json",
+      "description": "Export a FlutterFlow project into the local app directory via the FlutterFlow CLI."
+    },
+    "capacitor": {
+      "implementation": "./src/executors/capacitor/executor",
+      "schema": "./src/executors/capacitor/schema.json",
+      "description": "Run a Capacitor command (sync, open, add, copy) for android or ios inside an Ionic app folder."
+    },
+    "clean": {
+      "implementation": "./src/executors/clean/executor",
+      "schema": "./src/executors/clean/schema.json",
+      "description": "Remove a project's build outputs (dist, coverage) and, for Flutter apps, run flutter clean."
+    }
+  }
+}

package/dist/generators.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "./node_modules/nx/schemas/nx-devkit-generators.json",
+  "name": "@mouryaamit/nx-polystack",
+  "version": "0.1.0",
+  "generators": {
+    "app": {
+      "factory": "./src/generators/app/generator",
+      "schema": "./src/generators/app/schema.json",
+      "description": "Scaffold a new application. --type=flutter supported in Phase 2; angular/ionic/native in later phases."
+    },
+    "preset": {
+      "factory": "./src/generators/preset/generator",
+      "schema": "./src/generators/preset/schema.json",
+      "description": "Generate the root workspace skeleton: config files, repo infrastructure (via :infra), AI-assistant instructions (via :llm)."
+    },
+    "lib": {
+      "factory": "./src/generators/lib/generator",
+      "schema": "./src/generators/lib/schema.json",
+      "description": "Scaffold a shared library under libs/<scope>/<name>: ts, angular, ionic, flutter, assets, styles, state or design-tokens."
+    },
+    "env": {
+      "factory": "./src/generators/env/generator",
+      "schema": "./src/generators/env/schema.json",
+      "description": "Provision a named environment (e.g. qa, sit, staging) across all workspace apps: env files, project.json configurations, npm scripts."
+    },
+    "llm": {
+      "factory": "./src/generators/llm/generator",
+      "schema": "./src/generators/llm/schema.json",
+      "description": "Write a generated description of the workspace (apps, environments, libs, commands, rules) into CLAUDE.md, AGENTS.md and .github/copilot-instructions.md, between nx-polystack markers."
+    },
+    "infra": {
+      "factory": "./src/generators/infra/generator",
+      "schema": "./src/generators/infra/schema.json",
+      "description": "Add repo docs (CONTRIBUTING, CODE_OF_CONDUCT, SECURITY, PR and issue templates), CI gates (GitHub Actions / Jenkins, dependency-cycle check), quality checks (knip, pre-push audit + secretlint) and a scheduled dependency-upgrade workflow. Existing files are kept unless --force."
+    },
+    "migrate": {
+      "factory": "./src/generators/migrate/generator",
+      "schema": "./src/generators/migrate/schema.json",
+      "description": "Bring existing code into the workspace, the source never modified: a standalone Angular CLI or Flutter app as apps/<name>, or the Angular and Flutter projects of an Nx 15-17 workspace at their own paths."
+    },
+    "shared-libs": {
+      "factory": "./src/generators/shared-libs/generator",
+      "schema": "./src/generators/shared-libs/schema.json",
+      "description": "Create the shared assets and styles folders and wire them into Angular/Ionic apps."
+    }
+  }
+}

package/dist/migrations.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "./node_modules/nx/schemas/migrations.json",
+  "name": "@mouryaamit/nx-polystack migrations",
+  "version": "0.1.0",
+  "generators": {
+    "add-executor-peers": {
+      "version": "0.3.0",
+      "description": "Add sharp and crypto-js to devDependencies (no longer auto-installed peers)",
+      "implementation": "./src/migrations/add-executor-peers/add-executor-peers"
+    },
+    "angular-release-target": {
+      "version": "0.4.0",
+      "description": "Give generated Angular apps a real Angular build target and move the pipeline to release",
+      "implementation": "./src/migrations/angular-release-target/angular-release-target"
+    },
+    "add-lint-dependencies": {
+      "version": "0.4.1",
+      "description": "Add the ESLint packages (and Angular lint packages for Angular 15 workspaces) that are missing",
+      "implementation": "./src/migrations/add-lint-dependencies/add-lint-dependencies"
+    },
+    "add-lib-build-dependencies": {
+      "version": "0.6.1",
+      "description": "Add the PostCSS packages (and ng-packagr) that buildable/publishable Angular libs need to build",
+      "implementation": "./src/migrations/add-lib-build-dependencies/add-lib-build-dependencies"
+    },
+    "fix-lint-script": {
+      "version": "0.8.0",
+      "description": "Replace the self-calling \"lint\": \"npm run lint\" script written by earlier pstack new with nx run-many -t lint",
+      "implementation": "./src/migrations/fix-lint-script/fix-lint-script"
+    },
+    "prepush-audit-warn-only": {
+      "version": "0.9.1",
+      "description": "Make the pre-push dependency audit warn-only (secret scan first and still blocking) and add a strict check:audit script",
+      "implementation": "./src/migrations/prepush-audit-warn-only/prepush-audit-warn-only"
+    },
+    "add-lint-staged-config": {
+      "version": "0.18.1",
+      "description": "Add the lint-staged config that the pre-commit hook of pstack new workspaces runs (it was missing, so commits failed)",
+      "implementation": "./src/migrations/add-lint-staged-config/add-lint-staged-config"
+    },
+    "add-csp-nonce-import": {
+      "version": "0.24.0",
+      "description": "Import the library's CSP nonce patch first in main.ts of Angular and Ionic apps (local nonce patch imports are kept)",
+      "implementation": "./src/migrations/add-csp-nonce-import/add-csp-nonce-import"
+    },
+    "env-encryption-config": {
+      "version": "0.25.0",
+      "description": "Move env encryption settings into nx.json (pstack.envEncryption, mode listed with the keys of tools/config/encrypt-keys.json) and ignore .env.local",
+      "implementation": "./src/migrations/env-encryption-config/env-encryption-config"
+    },
+    "env-encryption-key-sources": {
+      "version": "0.28.0",
+      "description": "Rename nx.json pstack.envEncryption.keySource to keySources (aes-gcm key factors)",
+      "implementation": "./src/migrations/env-encryption-key-sources/env-encryption-key-sources"
+    },
+    "release-hardening": {
+      "version": "0.29.0",
+      "description": "Turn on the leak check, source-map guard, comment stripping and console removal for UAT/PROD release configurations, remove the replaced harden option, add terser",
+      "implementation": "./src/migrations/release-hardening/release-hardening"
+    },
+    "app-clean-and-port": {
+      "version": "0.35.0",
+      "description": "Add a clean target to apps without one and give apps that all served on port 4200 distinct dev-server ports",
+      "implementation": "./src/migrations/app-clean-and-port/app-clean-and-port"
+    },
+    "quality-checks": {
+      "version": "0.36.0",
+      "description": "Add typecheck targets (tsc --noEmit) and the CI typecheck step, and the import/no-unresolved and unused-imports ESLint rules as warnings",
+      "implementation": "./src/migrations/quality-checks/quality-checks"
+    },
+    "plugin-repo-dev": {
+      "version": "0.38.2",
+      "description": "Point GitHub workflows that name the plugin's earlier repo at its current repo",
+      "implementation": "./src/migrations/plugin-repo-dev/plugin-repo-dev"
+    },
+    "sharp-security-update": {
+      "version": "0.39.3",
+      "description": "Move sharp to ^0.35.5, the first version without the bundled libvips, libheif and librsvg vulnerabilities",
+      "implementation": "./src/migrations/sharp-security-update/sharp-security-update"
+    },
+    "flutter-web-platform": {
+      "version": "1.0.0",
+      "description": "Add the web/ folder (index.html, manifest.json) that flutter build web needs to Flutter apps generated without one",
+      "implementation": "./src/migrations/flutter-web-platform/flutter-web-platform"
+    }
+  }
+}