meto-cli 0.10.0 → 0.11.0

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

@@ -0,0 +1,53 @@
+/**
+ * Declarative blueprint that defines what each audit layer expects.
+ * The scanner reads this data structure to determine which checks to run.
+ * Adding new checks is data-driven: add an entry here, the scanner picks it up.
+ */
+/** The kind of filesystem check the scanner should perform. */
+export type CheckType = "file-exists" | "dir-exists" | "file-contains" | "custom";
+/**
+ * A single expectation within a layer.
+ * Describes one thing the scanner should verify.
+ */
+export interface BlueprintExpectation {
+    /** Unique identifier (e.g. "L0-git", "L1-claude-md") */
+    id: string;
+    /** Human-readable description shown in reports */
+    description: string;
+    /** What kind of check the scanner should perform */
+    checkType: CheckType;
+    /**
+     * Relative path (from project root) the check targets.
+     * For "custom" checks this may be a hint or pattern rather than a literal path.
+     */
+    path: string;
+    /** Which layer this expectation belongs to (0, 1, 2, 3) */
+    layer: number;
+    /** Whether the fixer can automatically resolve a failure */
+    fixable: boolean;
+    /**
+     * For "file-contains" checks: the pattern (substring or heading) expected
+     * inside the file. Ignored for other check types.
+     */
+    containsPattern?: string;
+}
+/**
+ * A layer groups related expectations under a name and numeric id.
+ * Layers are ordered: higher layers gate on lower layers passing.
+ */
+export interface BlueprintLayer {
+    /** Numeric layer identifier (0, 1, 2, 3) */
+    id: number;
+    /** Human-readable layer name */
+    name: string;
+    /** Ordered list of expectations for this layer */
+    expectations: BlueprintExpectation[];
+}
+/**
+ * The complete audit blueprint. Layers are ordered; the scanner should
+ * evaluate them sequentially and gate higher layers on lower ones passing.
+ *
+ * Exported as a constant -- no runtime construction.
+ */
+export declare const AUDIT_BLUEPRINT: readonly BlueprintLayer[];
+//# sourceMappingURL=blueprint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint.d.ts","sourceRoot":"","sources":["../../../src/cli/audit/blueprint.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,+DAA+D;AAC/D,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,YAAY,GACZ,eAAe,GACf,QAAQ,CAAC;AAEb;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,SAAS,EAAE,SAAS,CAAC;IACrB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,YAAY,EAAE,oBAAoB,EAAE,CAAC;CACtC;AA2WD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,cAAc,EAqB3C,CAAC"}

package/dist/cli/audit/blueprint.js

@@ -0,0 +1,386 @@
+/**
+ * Declarative blueprint that defines what each audit layer expects.
+ * The scanner reads this data structure to determine which checks to run.
+ * Adding new checks is data-driven: add an entry here, the scanner picks it up.
+ */
+// ---------------------------------------------------------------------------
+// Layer 0 -- Project Prerequisites
+// ---------------------------------------------------------------------------
+const LAYER_0_EXPECTATIONS = [
+    {
+        id: "L0-git",
+        description: "Git initialized",
+        checkType: "dir-exists",
+        path: ".git",
+        layer: 0,
+        fixable: false,
+    },
+    {
+        id: "L0-readme",
+        description: "README exists",
+        checkType: "custom",
+        path: "README*",
+        layer: 0,
+        fixable: false,
+    },
+    {
+        id: "L0-source-dir",
+        description: "Source code directory exists",
+        checkType: "custom",
+        path: "src|lib|app|pkg|cmd|internal",
+        layer: 0,
+        fixable: false,
+    },
+];
+// ---------------------------------------------------------------------------
+// Layer 1 -- Methodology
+// ---------------------------------------------------------------------------
+const LAYER_1_EXPECTATIONS = [
+    {
+        id: "L1-claude-md",
+        description: "CLAUDE.md project instructions",
+        checkType: "file-exists",
+        path: "CLAUDE.md",
+        layer: 1,
+        fixable: true,
+    },
+    {
+        id: "L1-ai-dir",
+        description: "ai/ directory",
+        checkType: "dir-exists",
+        path: "ai",
+        layer: 1,
+        fixable: true,
+    },
+    {
+        id: "L1-context-dir",
+        description: "ai/context/ directory",
+        checkType: "dir-exists",
+        path: "ai/context",
+        layer: 1,
+        fixable: true,
+    },
+    {
+        id: "L1-product-vision",
+        description: "Product vision document",
+        checkType: "file-exists",
+        path: "ai/context/product-vision.md",
+        layer: 1,
+        fixable: true,
+    },
+    {
+        id: "L1-tech-stack",
+        description: "Tech stack document",
+        checkType: "file-exists",
+        path: "ai/context/tech-stack.md",
+        layer: 1,
+        fixable: true,
+    },
+    {
+        id: "L1-decisions",
+        description: "Decisions log",
+        checkType: "file-exists",
+        path: "ai/context/decisions.md",
+        layer: 1,
+        fixable: true,
+    },
+    {
+        id: "L1-tasks-dir",
+        description: "ai/tasks/ directory",
+        checkType: "dir-exists",
+        path: "ai/tasks",
+        layer: 1,
+        fixable: true,
+    },
+    {
+        id: "L1-tasks-backlog",
+        description: "Task board: backlog",
+        checkType: "file-exists",
+        path: "ai/tasks/tasks-backlog.md",
+        layer: 1,
+        fixable: true,
+    },
+    {
+        id: "L1-tasks-todo",
+        description: "Task board: todo",
+        checkType: "file-exists",
+        path: "ai/tasks/tasks-todo.md",
+        layer: 1,
+        fixable: true,
+    },
+    {
+        id: "L1-tasks-in-progress",
+        description: "Task board: in-progress",
+        checkType: "file-exists",
+        path: "ai/tasks/tasks-in-progress.md",
+        layer: 1,
+        fixable: true,
+    },
+    {
+        id: "L1-tasks-in-testing",
+        description: "Task board: in-testing",
+        checkType: "file-exists",
+        path: "ai/tasks/tasks-in-testing.md",
+        layer: 1,
+        fixable: true,
+    },
+    {
+        id: "L1-tasks-done",
+        description: "Task board: done",
+        checkType: "file-exists",
+        path: "ai/tasks/tasks-done.md",
+        layer: 1,
+        fixable: true,
+    },
+    {
+        id: "L1-workflows-dir",
+        description: "ai/workflows/ directory",
+        checkType: "dir-exists",
+        path: "ai/workflows",
+        layer: 1,
+        fixable: true,
+    },
+    {
+        id: "L1-definition-of-done",
+        description: "Definition of done workflow",
+        checkType: "file-exists",
+        path: "ai/workflows/definition-of-done.md",
+        layer: 1,
+        fixable: true,
+    },
+    {
+        id: "L1-commit-conventions",
+        description: "Commit conventions workflow",
+        checkType: "file-exists",
+        path: "ai/workflows/commit-conventions.md",
+        layer: 1,
+        fixable: true,
+    },
+];
+// ---------------------------------------------------------------------------
+// Layer 2 -- Agents
+// ---------------------------------------------------------------------------
+const LAYER_2_EXPECTATIONS = [
+    {
+        id: "L2-claude-dir",
+        description: ".claude/ directory",
+        checkType: "dir-exists",
+        path: ".claude",
+        layer: 2,
+        fixable: true,
+    },
+    {
+        id: "L2-settings-json",
+        description: "Agent settings (.claude/settings.json)",
+        checkType: "file-exists",
+        path: ".claude/settings.json",
+        layer: 2,
+        fixable: true,
+    },
+    {
+        id: "L2-agents-dir",
+        description: ".claude/agents/ directory",
+        checkType: "dir-exists",
+        path: ".claude/agents",
+        layer: 2,
+        fixable: true,
+    },
+    {
+        id: "L2-pm-agent",
+        description: "PM agent definition",
+        checkType: "file-exists",
+        path: ".claude/agents/pm-agent.md",
+        layer: 2,
+        fixable: true,
+    },
+    {
+        id: "L2-developer-agent",
+        description: "Developer agent definition",
+        checkType: "file-exists",
+        path: ".claude/agents/developer-agent.md",
+        layer: 2,
+        fixable: true,
+    },
+    {
+        id: "L2-tester-agent",
+        description: "Tester agent definition",
+        checkType: "file-exists",
+        path: ".claude/agents/tester-agent.md",
+        layer: 2,
+        fixable: true,
+    },
+    {
+        id: "L2-agent-memory-dir",
+        description: ".claude/agent-memory/ directory",
+        checkType: "dir-exists",
+        path: ".claude/agent-memory",
+        layer: 2,
+        fixable: true,
+    },
+    {
+        id: "L2-pm-memory",
+        description: "PM agent memory directory",
+        checkType: "dir-exists",
+        path: ".claude/agent-memory/meto-pm",
+        layer: 2,
+        fixable: true,
+    },
+    {
+        id: "L2-developer-memory",
+        description: "Developer agent memory directory",
+        checkType: "dir-exists",
+        path: ".claude/agent-memory/meto-developer",
+        layer: 2,
+        fixable: true,
+    },
+    {
+        id: "L2-tester-memory",
+        description: "Tester agent memory directory",
+        checkType: "dir-exists",
+        path: ".claude/agent-memory/meto-tester",
+        layer: 2,
+        fixable: true,
+    },
+];
+// ---------------------------------------------------------------------------
+// Layer 3 -- Governance
+// ---------------------------------------------------------------------------
+const LAYER_3_EXPECTATIONS = [
+    {
+        id: "L3-dod-exists",
+        description: "Definition of done workflow exists",
+        checkType: "file-exists",
+        path: "ai/workflows/definition-of-done.md",
+        layer: 3,
+        fixable: true,
+    },
+    {
+        id: "L3-code-guidelines-exists",
+        description: "Code guidelines workflow exists",
+        checkType: "file-exists",
+        path: "ai/workflows/code-guidelines.md",
+        layer: 3,
+        fixable: true,
+    },
+    {
+        id: "L3-developer-agent-refs-guidelines",
+        description: "Developer agent references code guidelines",
+        checkType: "file-contains",
+        path: ".claude/agents/developer-agent.md",
+        layer: 3,
+        fixable: true,
+        containsPattern: "code-guidelines",
+    },
+    {
+        id: "L3-tester-agent-refs-guidelines",
+        description: "Tester agent references code guidelines",
+        checkType: "file-contains",
+        path: ".claude/agents/tester-agent.md",
+        layer: 3,
+        fixable: true,
+        containsPattern: "code-guidelines",
+    },
+    {
+        id: "L3-commit-conventions-defined",
+        description: "Commit conventions defined",
+        checkType: "file-contains",
+        path: "CLAUDE.md",
+        layer: 3,
+        fixable: true,
+        containsPattern: "Commit",
+    },
+    {
+        id: "L3-session-checkpoint",
+        description: "Session checkpoint workflow present",
+        checkType: "file-exists",
+        path: "ai/workflows/session-checkpoint.md",
+        layer: 3,
+        fixable: true,
+    },
+    {
+        id: "L3-pm-agent-refs-dod",
+        description: "PM agent references definition of done",
+        checkType: "file-contains",
+        path: ".claude/agents/pm-agent.md",
+        layer: 3,
+        fixable: true,
+        containsPattern: "definition-of-done",
+    },
+    {
+        id: "L3-developer-agent-refs-commit",
+        description: "Developer agent references commit conventions",
+        checkType: "file-contains",
+        path: ".claude/agents/developer-agent.md",
+        layer: 3,
+        fixable: true,
+        containsPattern: "commit",
+    },
+    {
+        id: "L3-tester-agent-refs-dod",
+        description: "Tester agent references definition of done",
+        checkType: "file-contains",
+        path: ".claude/agents/tester-agent.md",
+        layer: 3,
+        fixable: true,
+        containsPattern: "definition-of-done",
+    },
+    {
+        id: "L3-pm-agent-refs-memory",
+        description: "PM agent references memory file",
+        checkType: "file-contains",
+        path: ".claude/agents/pm-agent.md",
+        layer: 3,
+        fixable: true,
+        containsPattern: "agent-memory",
+    },
+    {
+        id: "L3-developer-agent-refs-memory",
+        description: "Developer agent references memory file",
+        checkType: "file-contains",
+        path: ".claude/agents/developer-agent.md",
+        layer: 3,
+        fixable: true,
+        containsPattern: "agent-memory",
+    },
+    {
+        id: "L3-tester-agent-refs-memory",
+        description: "Tester agent references memory file",
+        checkType: "file-contains",
+        path: ".claude/agents/tester-agent.md",
+        layer: 3,
+        fixable: true,
+        containsPattern: "agent-memory",
+    },
+];
+// ---------------------------------------------------------------------------
+// Blueprint (all layers)
+// ---------------------------------------------------------------------------
+/**
+ * The complete audit blueprint. Layers are ordered; the scanner should
+ * evaluate them sequentially and gate higher layers on lower ones passing.
+ *
+ * Exported as a constant -- no runtime construction.
+ */
+export const AUDIT_BLUEPRINT = [
+    {
+        id: 0,
+        name: "Project Prerequisites",
+        expectations: LAYER_0_EXPECTATIONS,
+    },
+    {
+        id: 1,
+        name: "Methodology",
+        expectations: LAYER_1_EXPECTATIONS,
+    },
+    {
+        id: 2,
+        name: "Agents",
+        expectations: LAYER_2_EXPECTATIONS,
+    },
+    {
+        id: 3,
+        name: "Governance",
+        expectations: LAYER_3_EXPECTATIONS,
+    },
+];
+//# sourceMappingURL=blueprint.js.map

package/dist/cli/audit/blueprint.js.map

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

package/dist/cli/audit/detect-stack.d.ts

@@ -0,0 +1,31 @@
+import type { TechStack } from "../types.js";
+/**
+ * Result of tech stack auto-detection.
+ */
+export interface DetectedStack {
+    /** The detected stack identifier matching TechStack presets, or "custom" */
+    stack: TechStack;
+    /** The manifest file that was used for detection */
+    detectedVia: string;
+    /** Human-readable label for the detected stack */
+    label: string;
+}
+/**
+ * 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 declare function detectStack(projectDir: string): Promise<DetectedStack>;
+//# sourceMappingURL=detect-stack.d.ts.map

package/dist/cli/audit/detect-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-stack.d.ts","sourceRoot":"","sources":["../../../src/cli/audit/detect-stack.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,KAAK,EAAE,SAAS,CAAC;IACjB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;CACf;AAiGD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAyD5E"}

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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"}