npm - mycontext-cli - Versions diffs - 4.2.0 → 4.2.2 - Mend

mycontext-cli 4.2.0 → 4.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (92) hide show

package/README.md +128 -133
package/dist/README.md +128 -133
package/dist/cli.js +76 -0
package/dist/cli.js.map +1 -1
package/dist/commands/doctor.d.ts +18 -0
package/dist/commands/doctor.d.ts.map +1 -0
package/dist/commands/doctor.js +53 -0
package/dist/commands/doctor.js.map +1 -0
package/dist/commands/init.d.ts.map +1 -1
package/dist/commands/init.js +99 -2
package/dist/commands/init.js.map +1 -1
package/dist/core/brain/BrainClient.d.ts +2 -0
package/dist/core/brain/BrainClient.d.ts.map +1 -1
package/dist/core/brain/BrainClient.js +19 -0
package/dist/core/brain/BrainClient.js.map +1 -1
package/dist/doctor/DoctorEngine.d.ts +5 -0
package/dist/doctor/DoctorEngine.d.ts.map +1 -0
package/dist/doctor/DoctorEngine.js +491 -0
package/dist/doctor/DoctorEngine.js.map +1 -0
package/dist/doctor/api.d.ts +4 -0
package/dist/doctor/api.d.ts.map +1 -0
package/dist/doctor/api.js +19 -0
package/dist/doctor/api.js.map +1 -0
package/dist/doctor/rules/dead-code-rules.d.ts +3 -0
package/dist/doctor/rules/dead-code-rules.d.ts.map +1 -0
package/dist/doctor/rules/dead-code-rules.js +269 -0
package/dist/doctor/rules/dead-code-rules.js.map +1 -0
package/dist/doctor/rules/index.d.ts +11 -0
package/dist/doctor/rules/index.d.ts.map +1 -0
package/dist/doctor/rules/index.js +21 -0
package/dist/doctor/rules/index.js.map +1 -0
package/dist/doctor/rules/nextjs-rules.d.ts +3 -0
package/dist/doctor/rules/nextjs-rules.d.ts.map +1 -0
package/dist/doctor/rules/nextjs-rules.js +357 -0
package/dist/doctor/rules/nextjs-rules.js.map +1 -0
package/dist/doctor/rules/node-rules.d.ts +3 -0
package/dist/doctor/rules/node-rules.d.ts.map +1 -0
package/dist/doctor/rules/node-rules.js +290 -0
package/dist/doctor/rules/node-rules.js.map +1 -0
package/dist/doctor/rules/turbo-rules.d.ts +3 -0
package/dist/doctor/rules/turbo-rules.d.ts.map +1 -0
package/dist/doctor/rules/turbo-rules.js +215 -0
package/dist/doctor/rules/turbo-rules.js.map +1 -0
package/dist/doctor/types.d.ts +87 -0
package/dist/doctor/types.d.ts.map +1 -0
package/dist/doctor/types.js +6 -0
package/dist/doctor/types.js.map +1 -0
package/dist/package.json +4 -4
package/dist/services/ContextSyncer.d.ts +40 -0
package/dist/services/ContextSyncer.d.ts.map +1 -0
package/dist/services/ContextSyncer.js +219 -0
package/dist/services/ContextSyncer.js.map +1 -0
package/dist/services/ProjectScanner.d.ts +74 -0
package/dist/services/ProjectScanner.d.ts.map +1 -0
package/dist/services/ProjectScanner.js +343 -0
package/dist/services/ProjectScanner.js.map +1 -0
package/dist/services/ScaffoldAgent.d.ts +35 -0
package/dist/services/ScaffoldAgent.d.ts.map +1 -0
package/dist/services/ScaffoldAgent.js +228 -0
package/dist/services/ScaffoldAgent.js.map +1 -0
package/dist/tui/PlanningMode.d.ts +42 -0
package/dist/tui/PlanningMode.d.ts.map +1 -0
package/dist/tui/PlanningMode.js +401 -0
package/dist/tui/PlanningMode.js.map +1 -0
package/dist/tui/TUIClient.d.ts +20 -0
package/dist/tui/TUIClient.d.ts.map +1 -0
package/dist/tui/TUIClient.js +50 -0
package/dist/tui/TUIClient.js.map +1 -0
package/dist/types/mega-context.d.ts +118 -0
package/dist/types/mega-context.d.ts.map +1 -0
package/dist/types/mega-context.js +3 -0
package/dist/types/mega-context.js.map +1 -0
package/dist/types/tui.d.ts +29 -0
package/dist/types/tui.d.ts.map +1 -0
package/dist/types/tui.js +8 -0
package/dist/types/tui.js.map +1 -0
package/dist/types/unified-context.d.ts +102 -0
package/dist/types/unified-context.d.ts.map +1 -0
package/dist/types/unified-context.js +50 -0
package/dist/types/unified-context.js.map +1 -0
package/dist/utils/FileGenerator.d.ts +5 -0
package/dist/utils/FileGenerator.d.ts.map +1 -1
package/dist/utils/FileGenerator.js +48 -0
package/dist/utils/FileGenerator.js.map +1 -1
package/dist/utils/deepMerge.d.ts +14 -0
package/dist/utils/deepMerge.d.ts.map +1 -0
package/dist/utils/deepMerge.js +87 -0
package/dist/utils/deepMerge.js.map +1 -0
package/dist/utils/fileSystem.d.ts.map +1 -1
package/dist/utils/fileSystem.js +32 -4
package/dist/utils/fileSystem.js.map +1 -1
package/package.json +24 -22

package/dist/doctor/rules/nextjs-rules.js ADDED Viewed

@@ -0,0 +1,357 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nextjsRules = void 0;
+/**
+ * Next.js Rules — Best practice checks for Next.js App Router projects
+ */
+const path = __importStar(require("path"));
+// ─── Helper ───────────────────────────────────────────────────────
+function diag(rule, filePath, message, opts = {}) {
+    return {
+        ruleId: rule.id,
+        filePath,
+        line: opts.line,
+        severity: rule.severity,
+        message,
+        help: opts.help || rule.help,
+        autoFixable: opts.autoFixable ?? false,
+    };
+}
+// ─── Rules ────────────────────────────────────────────────────────
+const missingRootLayout = {
+    id: "nextjs/missing-root-layout",
+    name: "Root Layout Required",
+    category: "nextjs",
+    severity: "error",
+    description: "Next.js App Router requires a root layout.tsx",
+    help: "Create app/layout.tsx with html and body tags wrapping {children}",
+    appliesTo: ["nextjs"],
+    async check(ctx) {
+        const results = [];
+        const hasLayout = await ctx.fileExists("app/layout.tsx") ||
+            await ctx.fileExists("app/layout.jsx") ||
+            await ctx.fileExists("src/app/layout.tsx") ||
+            await ctx.fileExists("src/app/layout.jsx");
+        if (!hasLayout) {
+            results.push(diag(this, "app/layout.tsx", "No root layout found — App Router requires app/layout.tsx"));
+        }
+        return results;
+    },
+};
+const layoutHasHtmlBody = {
+    id: "nextjs/layout-html-body",
+    name: "Layout Has HTML/Body",
+    category: "nextjs",
+    severity: "error",
+    description: "Root layout must wrap children in <html> and <body> tags",
+    help: "Add <html lang='en'><body>{children}</body></html> to root layout",
+    appliesTo: ["nextjs"],
+    async check(ctx) {
+        const results = [];
+        const layoutPaths = ["app/layout.tsx", "app/layout.jsx", "src/app/layout.tsx", "src/app/layout.jsx"];
+        for (const lp of layoutPaths) {
+            const content = await ctx.readFile(lp);
+            if (!content)
+                continue;
+            if (!content.includes("<html")) {
+                results.push(diag(this, lp, "Root layout missing <html> tag"));
+            }
+            if (!content.includes("<body")) {
+                results.push(diag(this, lp, "Root layout missing <body> tag"));
+            }
+            break; // only check the first layout found
+        }
+        return results;
+    },
+};
+const pageDefaultExport = {
+    id: "nextjs/page-default-export",
+    name: "Page Default Export",
+    category: "nextjs",
+    severity: "error",
+    description: "Page files must have a default export",
+    help: "Add 'export default function PageName()' to your page file",
+    appliesTo: ["nextjs"],
+    async check(ctx) {
+        const results = [];
+        const pages = await ctx.findFiles(/page\.(tsx|jsx|ts|js)$/);
+        for (const p of pages) {
+            const content = await ctx.readFile(p);
+            if (!content)
+                continue;
+            if (!content.includes("export default")) {
+                results.push(diag(this, p, `Page file missing default export`));
+            }
+        }
+        return results;
+    },
+};
+const clientDirective = {
+    id: "nextjs/client-directive",
+    name: "Client Directive Usage",
+    category: "nextjs",
+    severity: "warning",
+    description: "Files using hooks/browser APIs should have 'use client' directive",
+    help: "Add 'use client' at the top of files using useState, useEffect, onClick, etc.",
+    appliesTo: ["nextjs"],
+    async check(ctx) {
+        const results = [];
+        const clientSignals = [
+            /\buseState\b/, /\buseEffect\b/, /\buseRef\b/, /\buseReducer\b/,
+            /\buseCallback\b/, /\buseMemo\b/, /\buseContext\b/,
+            /\bonClick\b/, /\bonChange\b/, /\bonSubmit\b/,
+            /\bwindow\b/, /\bdocument\b/,
+        ];
+        const files = await ctx.findFiles(/\.(tsx|jsx)$/);
+        for (const f of files) {
+            // Skip layout/page files that could be server components
+            if (/layout\.(tsx|jsx)$/.test(f) && !f.includes("components"))
+                continue;
+            const content = await ctx.readFile(f);
+            if (!content)
+                continue;
+            if (content.includes('"use client"') || content.includes("'use client'"))
+                continue;
+            const needsClient = clientSignals.some(sig => sig.test(content));
+            if (needsClient) {
+                // Find which hook/API triggered it
+                const trigger = clientSignals.find(sig => sig.test(content));
+                const triggerName = trigger ? trigger.source.replace(/\\b/g, "") : "client API";
+                results.push(diag(this, f, `Uses ${triggerName} but missing "use client" directive`, {
+                    autoFixable: true,
+                }));
+            }
+        }
+        return results;
+    },
+    async fix(ctx, d) {
+        const content = await ctx.readFile(d.filePath);
+        if (!content)
+            return false;
+        const newContent = `"use client";\n\n${content}`;
+        const abs = path.join(ctx.root, d.filePath);
+        const { writeFile } = await Promise.resolve().then(() => __importStar(require("fs-extra")));
+        await writeFile(abs, newContent);
+        return true;
+    },
+};
+const serverComponentHooks = {
+    id: "nextjs/server-component-hooks",
+    name: "No Hooks in Server Components",
+    category: "nextjs",
+    severity: "error",
+    description: "Server components cannot use React hooks",
+    help: "Add 'use client' directive or move hooks to a client component",
+    appliesTo: ["nextjs"],
+    async check(ctx) {
+        const results = [];
+        const hookPattern = /\b(useState|useEffect|useRef|useReducer|useCallback|useMemo|useContext)\s*\(/;
+        const serverFiles = await ctx.findFiles(/(page|layout)\.(tsx|jsx)$/);
+        for (const f of serverFiles) {
+            const content = await ctx.readFile(f);
+            if (!content)
+                continue;
+            if (content.includes('"use client"') || content.includes("'use client'"))
+                continue;
+            const hookPatternLocal = /\b(useState|useEffect|useRef|useReducer|useCallback|useMemo|useContext)\s*\(/;
+            const lines = content.split("\n");
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                if (!line)
+                    continue;
+                const match = hookPatternLocal.exec(line);
+                if (match && match[1]) {
+                    results.push(diag(this, f, `Server component uses hook ${match[1]}()`, {
+                        line: i + 1,
+                    }));
+                }
+            }
+        }
+        return results;
+    },
+};
+const metadataExport = {
+    id: "nextjs/metadata-export",
+    name: "Metadata Export",
+    category: "nextjs",
+    severity: "warning",
+    description: "Pages/layouts should export metadata or generateMetadata for SEO",
+    help: "Add 'export const metadata = { title: ... }' or 'export async function generateMetadata()'",
+    appliesTo: ["nextjs"],
+    async check(ctx) {
+        const results = [];
+        const pages = await ctx.findFiles(/page\.(tsx|jsx|ts|js)$/);
+        for (const p of pages) {
+            const content = await ctx.readFile(p);
+            if (!content)
+                continue;
+            // Check if there's metadata or generateMetadata
+            const hasMetadata = content.includes("export const metadata") ||
+                content.includes("export async function generateMetadata") ||
+                content.includes("export function generateMetadata");
+            if (!hasMetadata) {
+                results.push(diag(this, p, "Page missing metadata export for SEO"));
+            }
+        }
+        return results;
+    },
+};
+const imageComponent = {
+    id: "nextjs/image-component",
+    name: "Use next/image",
+    category: "nextjs",
+    severity: "warning",
+    description: "Use next/image instead of <img> for optimized images",
+    help: "Import Image from 'next/image' and replace <img> tags",
+    appliesTo: ["nextjs"],
+    async check(ctx) {
+        const results = [];
+        const files = await ctx.findFiles(/\.(tsx|jsx)$/);
+        for (const f of files) {
+            const content = await ctx.readFile(f);
+            if (!content)
+                continue;
+            const lines = content.split("\n");
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                if (!line)
+                    continue;
+                if (/<img\s/i.test(line) && !line.includes("eslint-disable")) {
+                    results.push(diag(this, f, "Uses <img> instead of next/image", { line: i + 1 }));
+                }
+            }
+        }
+        return results;
+    },
+};
+const linkComponent = {
+    id: "nextjs/link-component",
+    name: "Use next/link",
+    category: "nextjs",
+    severity: "warning",
+    description: "Use next/link for internal navigation instead of <a> tags",
+    help: "Import Link from 'next/link' and replace <a href='/...'> with <Link href='/...'>",
+    appliesTo: ["nextjs"],
+    async check(ctx) {
+        const results = [];
+        const files = await ctx.findFiles(/\.(tsx|jsx)$/);
+        for (const f of files) {
+            const content = await ctx.readFile(f);
+            if (!content)
+                continue;
+            const lines = content.split("\n");
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                if (!line)
+                    continue;
+                // Match <a href="/something"> (internal links)
+                const match = /<a\s[^>]*href=["'](\/[^"']*)/i.exec(line);
+                if (match && !line.includes("eslint-disable")) {
+                    results.push(diag(this, f, `Uses <a> for internal link "${match[1] ?? ""}" instead of next/link`, { line: i + 1 }));
+                }
+            }
+        }
+        return results;
+    },
+};
+const routeHandlerMethods = {
+    id: "nextjs/route-handler-methods",
+    name: "Route Handler Exports",
+    category: "nextjs",
+    severity: "error",
+    description: "API route handlers must export named HTTP methods (GET, POST, etc.)",
+    help: "Export named functions: export async function GET(request) { ... }",
+    appliesTo: ["nextjs"],
+    async check(ctx) {
+        const results = [];
+        const routes = await ctx.findFiles(/route\.(ts|js|tsx|jsx)$/);
+        for (const r of routes) {
+            const content = await ctx.readFile(r);
+            if (!content)
+                continue;
+            const httpMethods = ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"];
+            const hasMethod = httpMethods.some(m => content.includes(`export async function ${m}`) ||
+                content.includes(`export function ${m}`) ||
+                content.includes(`export const ${m}`));
+            if (!hasMethod) {
+                results.push(diag(this, r, "Route handler doesn't export any HTTP methods (GET/POST/etc.)"));
+            }
+        }
+        return results;
+    },
+};
+const loadingFiles = {
+    id: "nextjs/loading-states",
+    name: "Loading States",
+    category: "nextjs",
+    severity: "warning",
+    description: "Route groups with data fetching should have loading.tsx for better UX",
+    help: "Create loading.tsx alongside page.tsx for Suspense-based loading states",
+    appliesTo: ["nextjs"],
+    async check(ctx) {
+        const results = [];
+        const pages = await ctx.findFiles(/page\.(tsx|jsx)$/);
+        for (const p of pages) {
+            const content = await ctx.readFile(p);
+            if (!content)
+                continue;
+            // Check if page has async data fetching
+            const hasAsyncData = content.includes("async function") && (content.includes("fetch(") || content.includes("await "));
+            if (!hasAsyncData)
+                continue;
+            const dir = path.dirname(p);
+            const hasLoading = await ctx.fileExists(path.join(dir, "loading.tsx")) ||
+                await ctx.fileExists(path.join(dir, "loading.jsx"));
+            if (!hasLoading) {
+                results.push(diag(this, p, "Page with async data has no loading.tsx for Suspense"));
+            }
+        }
+        return results;
+    },
+};
+exports.nextjsRules = [
+    missingRootLayout,
+    layoutHasHtmlBody,
+    pageDefaultExport,
+    clientDirective,
+    serverComponentHooks,
+    metadataExport,
+    imageComponent,
+    linkComponent,
+    routeHandlerMethods,
+    loadingFiles,
+];
+//# sourceMappingURL=nextjs-rules.js.map

package/dist/doctor/rules/nextjs-rules.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/doctor/rules/node-rules.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+import type { DoctorRule } from "../types";
+export declare const nodeRules: DoctorRule[];
+//# sourceMappingURL=node-rules.d.ts.map

package/dist/doctor/rules/node-rules.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"node-rules.d.ts","sourceRoot":"","sources":["../../../src/doctor/rules/node-rules.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAA2B,MAAM,UAAU,CAAC;AA6QpE,eAAO,MAAM,SAAS,EAAE,UAAU,EAQjC,CAAC"}

package/dist/doctor/rules/node-rules.js ADDED Viewed

@@ -0,0 +1,290 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nodeRules = void 0;
+/**
+ * Node.js / Structure Rules — General project health checks
+ */
+const path = __importStar(require("path"));
+function diag(rule, filePath, message, opts = {}) {
+    return {
+        ruleId: rule.id,
+        filePath,
+        line: opts.line,
+        severity: rule.severity,
+        message,
+        help: opts.help || rule.help,
+        autoFixable: opts.autoFixable ?? false,
+    };
+}
+// ─── Rules ────────────────────────────────────────────────────────
+const singleLockFile = {
+    id: "node/single-lock-file",
+    name: "Single Lock File",
+    category: "node",
+    severity: "error",
+    description: "Project should have only one package manager lock file",
+    help: "Delete the extra lock files and stick to one package manager",
+    appliesTo: ["node", "nextjs", "turbo"],
+    async check(ctx) {
+        const results = [];
+        if (ctx.isWorkspace)
+            return results; // Lock file belongs in root
+        const lockFiles = [
+            { file: "package-lock.json", pm: "npm" },
+            { file: "yarn.lock", pm: "yarn" },
+            { file: "pnpm-lock.yaml", pm: "pnpm" },
+            { file: "bun.lockb", pm: "bun" },
+        ];
+        const found = [];
+        for (const lf of lockFiles) {
+            if (await ctx.fileExists(lf.file))
+                found.push(lf.file);
+        }
+        if (found.length > 1) {
+            const firstFound = found[0];
+            if (firstFound) {
+                results.push(diag(this, firstFound, `Multiple lock files found: ${found.join(", ")}`, { autoFixable: true, help: "Keep only the one matching your package manager" }));
+            }
+        }
+        else if (found.length === 0) {
+            results.push(diag(this, "package.json", "No lock file found — run your package manager's install", { help: `Run \`${ctx.project.packageManager} install\` to generate a lock file` }));
+        }
+        return results;
+    },
+};
+const noNestedNodeModules = {
+    id: "node/no-nested-node-modules",
+    name: "No Nested node_modules",
+    category: "node",
+    severity: "warning",
+    description: "Nested node_modules directories can cause dependency resolution issues",
+    help: "Remove nested node_modules and use workspace hoisting",
+    appliesTo: ["node", "nextjs", "turbo"],
+    async check(ctx) {
+        const results = [];
+        // Check common nested locations
+        const suspectDirs = await ctx.findFiles(/node_modules\/.*\/node_modules/);
+        // findFiles looks at files, so let's check dirs manually
+        const commonNested = ["src/node_modules", "lib/node_modules", "app/node_modules"];
+        for (const nested of commonNested) {
+            if (await ctx.fileExists(nested)) {
+                results.push(diag(this, nested, `Nested node_modules at ${nested}`, {
+                    autoFixable: true,
+                    help: "Delete this directory — it was likely created by accident"
+                }));
+            }
+        }
+        return results;
+    },
+};
+const tsconfigStrict = {
+    id: "node/tsconfig-strict",
+    name: "TypeScript Strict Mode",
+    category: "node",
+    severity: "warning",
+    description: "TypeScript strict mode catches more bugs at compile time",
+    help: 'Enable "strict": true in tsconfig.json compilerOptions',
+    appliesTo: ["node", "nextjs"],
+    async check(ctx) {
+        const results = [];
+        if (!ctx.project.typescript)
+            return results;
+        const tsconfig = await ctx.readJson("tsconfig.json");
+        if (!tsconfig)
+            return results;
+        if (!tsconfig.compilerOptions?.strict) {
+            results.push(diag(this, "tsconfig.json", "TypeScript strict mode is disabled", {
+                autoFixable: true,
+            }));
+        }
+        return results;
+    },
+};
+const enginesField = {
+    id: "node/engines-field",
+    name: "Engines Field",
+    category: "node",
+    severity: "warning",
+    description: "package.json should specify Node.js engine version for consistency",
+    help: 'Add "engines": { "node": ">=18" } to package.json',
+    appliesTo: ["node", "nextjs", "turbo"],
+    async check(ctx) {
+        const results = [];
+        const pkg = await ctx.readJson("package.json");
+        if (!pkg)
+            return results;
+        if (!pkg.engines?.node) {
+            results.push(diag(this, "package.json", "Missing engines.node field", {
+                autoFixable: true,
+            }));
+        }
+        return results;
+    },
+    async fix(ctx, d) {
+        const pkg = await ctx.readJson("package.json");
+        if (!pkg)
+            return false;
+        pkg.engines = { ...pkg.engines, node: ">=18" };
+        const { writeJson } = await Promise.resolve().then(() => __importStar(require("fs-extra")));
+        await writeJson(path.join(ctx.root, "package.json"), pkg, { spaces: 2 });
+        return true;
+    },
+};
+const gitignoreComplete = {
+    id: "structure/gitignore",
+    name: "Complete .gitignore",
+    category: "node",
+    severity: "warning",
+    description: ".gitignore should cover common patterns",
+    help: "Add missing entries to .gitignore",
+    appliesTo: ["node", "nextjs", "turbo"],
+    async check(ctx) {
+        const results = [];
+        if (ctx.isWorkspace)
+            return results; // .gitignore belongs in root
+        const content = await ctx.readFile(".gitignore");
+        if (!content) {
+            results.push(diag(this, ".gitignore", "No .gitignore file found", {
+                autoFixable: true,
+            }));
+            return results;
+        }
+        const requiredPatterns = [
+            { pattern: "node_modules", label: "node_modules" },
+            { pattern: ".env", label: ".env files" },
+        ];
+        // Add Next.js-specific patterns
+        if (ctx.project.type === "nextjs") {
+            requiredPatterns.push({ pattern: ".next", label: ".next build dir" });
+        }
+        for (const { pattern, label } of requiredPatterns) {
+            if (!content.includes(pattern)) {
+                results.push(diag(this, ".gitignore", `Missing ${label} pattern in .gitignore`, {
+                    autoFixable: true,
+                }));
+            }
+        }
+        return results;
+    },
+};
+const envExample = {
+    id: "structure/env-example",
+    name: "Environment Example",
+    category: "node",
+    severity: "warning",
+    description: "If .env exists, .env.example should too for team onboarding",
+    help: "Create .env.example with placeholder values for all env vars",
+    appliesTo: ["node", "nextjs"],
+    async check(ctx) {
+        const results = [];
+        const envFiles = [".env", ".env.local"];
+        let hasEnv = false;
+        for (const ef of envFiles) {
+            if (await ctx.fileExists(ef)) {
+                hasEnv = true;
+                break;
+            }
+        }
+        if (hasEnv) {
+            const hasExample = await ctx.fileExists(".env.example") ||
+                await ctx.fileExists(".env.local.example");
+            if (!hasExample) {
+                results.push(diag(this, ".env.example", "Has .env but no .env.example — teammates won't know which vars are needed"));
+            }
+        }
+        return results;
+    },
+};
+const noUnusedDeps = {
+    id: "node/unused-deps",
+    name: "No Unused Dependencies",
+    category: "node",
+    severity: "warning",
+    description: "Dependencies in package.json should be actually imported in code",
+    help: "Remove unused dependencies with 'npm uninstall <pkg>'",
+    appliesTo: ["node", "nextjs"],
+    async check(ctx) {
+        const results = [];
+        const pkg = await ctx.readJson("package.json");
+        if (!pkg?.dependencies)
+            return results;
+        // Skip common deps that are used implicitly
+        const implicitDeps = new Set([
+            "typescript", "@types/node", "@types/react", "@types/react-dom",
+            "eslint", "prettier", "tailwindcss", "postcss", "autoprefixer",
+            "next", "react", "react-dom", "turbo", "@next/font",
+            "encoding", "bufferutil", "utf-8-validate",
+        ]);
+        const allSourceFiles = await ctx.findFiles(/\.(ts|tsx|js|jsx|mjs|cjs)$/);
+        // Read up to 200 source files to check imports
+        const filesToCheck = allSourceFiles.slice(0, 200);
+        let allContent = "";
+        for (const f of filesToCheck) {
+            const content = await ctx.readFile(f);
+            if (content)
+                allContent += content + "\n";
+        }
+        const unused = [];
+        for (const dep of Object.keys(pkg.dependencies)) {
+            if (implicitDeps.has(dep))
+                continue;
+            // Check if dep name appears anywhere in source (lazy but effective)
+            const depBase = dep.startsWith("@") ? dep : dep.split("/")[0];
+            if (!allContent.includes(`"${depBase}"`) &&
+                !allContent.includes(`'${depBase}'`) &&
+                !allContent.includes(`from "${depBase}`) &&
+                !allContent.includes(`from '${depBase}`) &&
+                !allContent.includes(`require("${depBase}`) &&
+                !allContent.includes(`require('${depBase}`)) {
+                unused.push(dep);
+            }
+        }
+        if (unused.length > 0) {
+            results.push(diag(this, "package.json", `${unused.length} potentially unused deps: ${unused.slice(0, 5).join(", ")}${unused.length > 5 ? "..." : ""}`, { help: `Check: ${unused.join(", ")}` }));
+        }
+        return results;
+    },
+};
+exports.nodeRules = [
+    singleLockFile,
+    noNestedNodeModules,
+    tsconfigStrict,
+    enginesField,
+    gitignoreComplete,
+    envExample,
+    noUnusedDeps,
+];
+//# sourceMappingURL=node-rules.js.map