meto-cli 0.10.0 → 0.11.1

package/dist/cli/audit/detect-stack.js

@@ -0,0 +1,154 @@
+import { readFile, stat } from "node:fs/promises";
+import { join } from "node:path";
+/**
+ * Checks whether a file exists at the given path.
+ */
+async function fileExists(filePath) {
+    try {
+        const stats = await stat(filePath);
+        return stats.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Reads and parses a package.json file. Returns null if the file
+ * does not exist or cannot be parsed.
+ */
+async function readPackageJson(projectDir) {
+    const pkgPath = join(projectDir, "package.json");
+    try {
+        const content = await readFile(pkgPath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Checks whether a dependency exists in package.json dependencies
+ * or devDependencies.
+ */
+function hasDependency(pkg, depName) {
+    const deps = pkg["dependencies"];
+    const devDeps = pkg["devDependencies"];
+    if (deps !== null && deps !== undefined && typeof deps === "object") {
+        if (depName in deps) {
+            return true;
+        }
+    }
+    if (devDeps !== null && devDeps !== undefined && typeof devDeps === "object") {
+        if (depName in devDeps) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Determines the most specific Node.js stack from package.json contents.
+ * Checks for framework-specific dependencies to distinguish between
+ * Next.js, React Native, Vite+React, and generic Node.js CLI.
+ */
+function detectNodeStack(pkg) {
+    // Next.js detection (maps to nextjs-supabase preset)
+    if (hasDependency(pkg, "next")) {
+        return {
+            stack: "nextjs-supabase",
+            detectedVia: "package.json",
+            label: "Next.js",
+        };
+    }
+    // React Native detection
+    if (hasDependency(pkg, "react-native")) {
+        return {
+            stack: "react-native",
+            detectedVia: "package.json",
+            label: "React Native",
+        };
+    }
+    // Vite + React detection (check vite first, then confirm React)
+    if (hasDependency(pkg, "vite") && hasDependency(pkg, "react")) {
+        return {
+            stack: "vite-react",
+            detectedVia: "package.json",
+            label: "Vite + React",
+        };
+    }
+    // Generic Node.js CLI fallback for package.json projects
+    return {
+        stack: "nodejs-cli",
+        detectedVia: "package.json",
+        label: "Node.js",
+    };
+}
+/**
+ * Auto-detects the tech stack of a project by examining manifest files
+ * in the project root directory.
+ *
+ * Detection order:
+ * 1. package.json — inspects dependencies for Next.js, React Native,
+ *    Vite+React, or falls back to Node.js CLI
+ * 2. go.mod — Go
+ * 3. pyproject.toml or requirements.txt — Python (FastAPI preset)
+ * 4. pubspec.yaml — Flutter
+ * 5. Cargo.toml — Rust (returns "custom" since no Rust preset exists)
+ *
+ * Root-level manifests only. Does not recurse into subdirectories.
+ *
+ * @param projectDir - Absolute path to the project root directory
+ * @returns The detected stack result, or a "custom" fallback if no manifest is found
+ */
+export async function detectStack(projectDir) {
+    // 1. Check package.json first (most common, and allows sub-detection)
+    const pkg = await readPackageJson(projectDir);
+    if (pkg !== null) {
+        return detectNodeStack(pkg);
+    }
+    // 2. Check go.mod
+    if (await fileExists(join(projectDir, "go.mod"))) {
+        return {
+            stack: "go",
+            detectedVia: "go.mod",
+            label: "Go",
+        };
+    }
+    // 3. Check Python manifests
+    if (await fileExists(join(projectDir, "pyproject.toml"))) {
+        return {
+            stack: "python-fastapi",
+            detectedVia: "pyproject.toml",
+            label: "Python",
+        };
+    }
+    if (await fileExists(join(projectDir, "requirements.txt"))) {
+        return {
+            stack: "python-fastapi",
+            detectedVia: "requirements.txt",
+            label: "Python",
+        };
+    }
+    // 4. Check Flutter
+    if (await fileExists(join(projectDir, "pubspec.yaml"))) {
+        return {
+            stack: "flutter",
+            detectedVia: "pubspec.yaml",
+            label: "Flutter",
+        };
+    }
+    // 5. Check Rust (no preset — returns "custom")
+    if (await fileExists(join(projectDir, "Cargo.toml"))) {
+        return {
+            stack: "custom",
+            detectedVia: "Cargo.toml",
+            label: "Rust",
+        };
+    }
+    // No manifest detected
+    return {
+        stack: "custom",
+        detectedVia: "none",
+        label: "Unknown",
+    };
+}
+//# sourceMappingURL=detect-stack.js.map

package/dist/cli/audit/detect-stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-stack.js","sourceRoot":"","sources":["../../../src/cli/audit/detect-stack.ts"],"names":[],"mappings":"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"}

package/dist/cli/audit/fixer.d.ts

@@ -0,0 +1,75 @@
+import type { TokenMap } from "../renderer.js";
+import type { ScanResult, LayerScanResult } from "./scanner.js";
+/** Outcome of a single fix attempt. */
+export type FixOutcome = "created" | "declined" | "skipped" | "error";
+/**
+ * Result of attempting to fix a single failed expectation.
+ */
+export interface FixResult {
+    /** The scan result that triggered this fix */
+    scanResult: ScanResult;
+    /** What happened during the fix attempt */
+    outcome: FixOutcome;
+    /** Human-readable message about the fix */
+    message: string;
+}
+/**
+ * Result of running the fixer on an entire layer.
+ */
+export interface LayerFixResult {
+    /** Layer ID that was fixed */
+    layerId: number;
+    /** Individual fix results */
+    fixes: FixResult[];
+}
+/**
+ * Runs the interactive fixer for all failed expectations in a layer scan result.
+ * Prompts the user for each missing file/directory and creates it from templates.
+ *
+ * This function is layer-agnostic -- it works with any LayerScanResult.
+ * The fixer never overwrites existing files -- only creates missing ones.
+ *
+ * @param projectDir - Absolute path to the project root
+ * @param layerResult - The scan result containing failures to fix
+ * @param tokens - Token map for template rendering
+ * @returns Fix results for each failed expectation
+ */
+export declare function fixLayer(projectDir: string, layerResult: LayerScanResult, tokens: TokenMap): Promise<LayerFixResult>;
+/**
+ * Runs the interactive fixer for Layer 2 (Agents).
+ *
+ * Layer 2 differs from other layers because:
+ * - When creating agent files from scratch, the user is asked to choose
+ *   Sprint vs Swarm workflow mode.
+ * - The workflow choice affects the WORKFLOW_AGENTS_SECTION token in CLAUDE.md
+ *   (CLAUDE.md is Layer 1, but the token content depends on the Layer 2 choice).
+ * - Agent memory directories are created with a MEMORY.md file from templates.
+ *
+ * The fixer never overwrites existing agent definitions or settings.
+ *
+ * @param projectDir - Absolute path to the project root
+ * @param layerResult - The Layer 2 scan result containing failures to fix
+ * @param tokens - Token map for template rendering
+ * @returns Fix results for each failed expectation
+ */
+export declare function fixLayerTwo(projectDir: string, layerResult: LayerScanResult, tokens: TokenMap): Promise<LayerFixResult>;
+/**
+ * Runs the interactive fixer for Layer 3 (Governance).
+ *
+ * Layer 3 differs from other layers because it has three fix strategies:
+ * 1. Missing governance files (definition-of-done, session-checkpoint):
+ *    created from templates, same as Layer 1.
+ * 2. CLAUDE.md missing commit conventions section:
+ *    appends a commit format section to the existing file.
+ * 3. Agent definitions missing governance references:
+ *    appends reference sections to existing agent files.
+ *
+ * All fixes are additive -- existing content is never modified or removed.
+ *
+ * @param projectDir - Absolute path to the project root
+ * @param layerResult - The Layer 3 scan result containing failures to fix
+ * @param tokens - Token map for template rendering
+ * @returns Fix results for each failed expectation
+ */
+export declare function fixLayerThree(projectDir: string, layerResult: LayerScanResult, tokens: TokenMap): Promise<LayerFixResult>;
+//# sourceMappingURL=fixer.d.ts.map

package/dist/cli/audit/fixer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixer.d.ts","sourceRoot":"","sources":["../../../src/cli/audit/fixer.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAMhE,uCAAuC;AACvC,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,8CAA8C;IAC9C,UAAU,EAAE,UAAU,CAAC;IACvB,2CAA2C;IAC3C,OAAO,EAAE,UAAU,CAAC;IACpB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AA8LD;;;;;;;;;;;GAWG;AACH,wBAAsB,QAAQ,CAC5B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,eAAe,EAC5B,MAAM,EAAE,QAAQ,GACf,OAAO,CAAC,cAAc,CAAC,CAwCzB;AAiED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,eAAe,EAC5B,MAAM,EAAE,QAAQ,GACf,OAAO,CAAC,cAAc,CAAC,CA0LzB;AA6GD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,eAAe,EAC5B,MAAM,EAAE,QAAQ,GACf,OAAO,CAAC,cAAc,CAAC,CA6PzB"}