@massu/core 1.10.7 → 1.12.0

package/src/detect/source-dir-detector.ts

@@ -1,297 +0,0 @@
-// Copyright (c) 2026 Massu. All rights reserved.
-// Licensed under BSL 1.1 - see LICENSE file for details.
-
-/**
- * Source Directory Detector (P1-003)
- * ==================================
- *
- * For each detected language, glob files of that type repo-wide (honoring
- * .gitignore and a hard-coded ignore set), then cluster by common prefix
- * directory and pick the directory with the highest file density.
- *
- * Handles:
- *   - Colocated tests (src/**​/*.test.ts next to source). Sets `colocated: true`
- *     on the language entry when test files are <30% of a dir's file count
- *     AND no dedicated tests/__tests__/ dir exists.
- *   - Top-level `tests/` or `__tests__/` directories (honored as test_dirs).
- *   - Monorepo packages/apps/services/libs/modules subtrees (each treated as
- *     a workspace root).
- *
- * Security (CR-3, CR-9):
- *   - Glob roots strictly inside projectRoot. Symlinks escaping projectRoot
- *     are rejected.
- *   - Secret-ish files (.env*, *.pem, *.key, .aws/, .ssh/, credentials.json)
- *     are excluded from globs.
- *   - Only the filename is ever read — never file contents.
- *
- * Usage:
- * ```ts
- * import { detectSourceDirs } from './detect/source-dir-detector.ts';
- * const map = detectSourceDirs('/repo', ['python', 'typescript']);
- * ```
- */
-
-import { realpathSync } from 'fs';
-import { resolve } from 'path';
-import fg from 'fast-glob';
-import type { SupportedLanguage } from './package-detector.ts';
-
-export interface SourceDirInfo {
-  /** Source directories (relative to projectRoot, forward-slash). */
-  source_dirs: string[];
-  /** Test directories (relative to projectRoot, forward-slash). */
-  test_dirs: string[];
-  /** True when tests live next to source (no dedicated tests/ dir). */
-  colocated: boolean;
-  /** Number of source files detected for this language. */
-  file_count: number;
-}
-
-export type SourceDirMap = Partial<Record<SupportedLanguage, SourceDirInfo>>;
-
-const IGNORE_PATTERNS: string[] = [
-  '**/node_modules/**',
-  '**/.venv/**',
-  '**/venv/**',
-  '**/__pycache__/**',
-  '**/dist/**',
-  '**/build/**',
-  '**/.build/**',
-  '**/target/**',
-  '**/.next/**',
-  '**/.nuxt/**',
-  '**/coverage/**',
-  '**/.git/**',
-  '**/.massu/**',
-  '**/.turbo/**',
-  '**/.cache/**',
-  '**/.pytest_cache/**',
-  '**/.mypy_cache/**',
-  '**/DerivedData/**',
-  '**/Pods/**',
-  // Secret-ish patterns
-  '**/.env',
-  '**/.env.*',
-  '**/*.pem',
-  '**/*.key',
-  '**/.aws/**',
-  '**/.ssh/**',
-  '**/credentials.json',
-  '**/*.p12',
-  '**/*.pfx',
-];
-
-const EXTENSIONS: Record<SupportedLanguage, string[]> = {
-  python: ['py'],
-  typescript: ['ts', 'tsx'],
-  javascript: ['js', 'jsx', 'mjs', 'cjs'],
-  rust: ['rs'],
-  swift: ['swift'],
-  go: ['go'],
-  java: ['java', 'kt'],
-  ruby: ['rb'],
-  // Plan 1.5.1 — closing CR-39 init gap for Phoenix + ASP.NET projects.
-  elixir: ['ex', 'exs'],
-  csharp: ['cs'],
-};
-
-const TEST_FILE_PATTERNS: Record<SupportedLanguage, RegExp[]> = {
-  python: [/_test\.py$/, /test_[^/]*\.py$/],
-  typescript: [/\.test\.tsx?$/, /\.spec\.tsx?$/],
-  javascript: [/\.test\.[mc]?jsx?$/, /\.spec\.[mc]?jsx?$/],
-  rust: [/tests\/.*\.rs$/],
-  swift: [/Tests\//],
-  go: [/_test\.go$/],
-  java: [/Test[^/]*\.(java|kt)$/, /[^/]*Test\.(java|kt)$/],
-  ruby: [/_spec\.rb$/, /_test\.rb$/],
-  // Phoenix/ExUnit canonical: `test/**_test.exs`. ASP.NET / xUnit
-  // canonical: `*Tests.cs` or `*.Tests/...`.
-  elixir: [/_test\.exs$/, /\/test\//],
-  csharp: [/Tests?\.cs$/, /\.Tests?\//],
-};
-
-const TEST_DIR_KEYWORDS = ['tests', 'test', '__tests__', 'spec', 'specs'];
-
-function extsFor(language: SupportedLanguage): string[] {
-  return EXTENSIONS[language] ?? [];
-}
-
-/**
- * Extensions for a language, with optional fallback for javascript-only repos
- * that still contain `.ts`/`.tsx` files (no `typescript` manifest, no
- * `tsconfig.json`). Fixes the bug where `apps/web/page.tsx` in a plain-JS
- * monorepo is invisible to the javascript glob, causing `init --ci` to fall
- * back to the nonexistent `src/`. See plan item P1-001 and incident
- * `2026-04-20-massu-core-monorepo-paths-source.md`.
- */
-function extsWithFallback(
-  language: SupportedLanguage,
-  fallbackTsForJs: boolean
-): string[] {
-  const base = extsFor(language);
-  if (language === 'javascript' && fallbackTsForJs) {
-    return [...base, 'ts', 'tsx'];
-  }
-  return base;
-}
-
-function isTestPath(language: SupportedLanguage, path: string): boolean {
-  // Any dedicated test-dir keyword in the path segments
-  const segments = path.split('/');
-  for (const seg of segments) {
-    if (TEST_DIR_KEYWORDS.includes(seg)) return true;
-  }
-  const patterns = TEST_FILE_PATTERNS[language] ?? [];
-  return patterns.some((re) => re.test(path));
-}
-
-/** Get the top-level directory segment of a relative path (or '.' for root). */
-function topSegment(rel: string): string {
-  const parts = rel.split('/');
-  return parts.length > 1 ? parts[0] : '.';
-}
-
-/**
- * Check that a path (after realpath) is inside the projectRoot.
- * Symlinks escaping the tree are rejected.
- */
-function isInsideRoot(root: string, candidate: string): boolean {
-  try {
-    const realRoot = realpathSync(root);
-    const realCand = realpathSync(resolve(root, candidate));
-    return realCand === realRoot || realCand.startsWith(realRoot + '/');
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Detect source and test directories per language.
- *
- * @param projectRoot absolute path to repo root
- * @param languages   list of languages to probe (derived from P1-001 manifests)
- * @param opts        optional flags:
- *   - `fallbackTsForJs`: when true AND the language is `javascript` AND no
- *     `typescript` manifest was discovered, also glob `.ts`/`.tsx`. This is
- *     the P1-001 fix for plain-JS monorepos (e.g. turbo with `next` in a
- *     package.json that lacks a typescript dep) that still use `.tsx`.
- */
-export function detectSourceDirs(
-  projectRoot: string,
-  languages: SupportedLanguage[],
-  opts?: { fallbackTsForJs?: boolean }
-): SourceDirMap {
-  const fallbackTsForJs = opts?.fallbackTsForJs ?? false;
-  const out: SourceDirMap = {};
-  for (const lang of languages) {
-    const exts = extsWithFallback(lang, fallbackTsForJs);
-    if (exts.length === 0) continue;
-    const patterns = exts.map((e) => `**/*.${e}`);
-    let files: string[];
-    try {
-      files = fg.sync(patterns, {
-        cwd: projectRoot,
-        dot: false,
-        ignore: IGNORE_PATTERNS,
-        followSymbolicLinks: false,
-        suppressErrors: true,
-      });
-    } catch {
-      files = [];
-    }
-
-    // Drop any file whose resolved realpath escapes the root (defence in depth).
-    files = files.filter((f) => isInsideRoot(projectRoot, f));
-
-    if (files.length === 0) {
-      continue;
-    }
-
-    // Split into source vs test files.
-    const sourceFiles: string[] = [];
-    const testFiles: string[] = [];
-    for (const f of files) {
-      if (isTestPath(lang, f)) testFiles.push(f);
-      else sourceFiles.push(f);
-    }
-
-    // Cluster by top segment.
-    const srcCluster = new Map<string, number>();
-    for (const f of sourceFiles) {
-      const k = topSegment(f);
-      srcCluster.set(k, (srcCluster.get(k) ?? 0) + 1);
-    }
-    const testCluster = new Map<string, number>();
-    for (const f of testFiles) {
-      const k = topSegment(f);
-      testCluster.set(k, (testCluster.get(k) ?? 0) + 1);
-    }
-
-    const source_dirs: string[] = [];
-    const test_dirs: string[] = [];
-
-    // Any top segment with at least one source file counts.
-    // Sort by density desc, then name asc for determinism.
-    const srcSorted = [...srcCluster.entries()].sort((a, b) => {
-      if (b[1] !== a[1]) return b[1] - a[1];
-      return a[0].localeCompare(b[0]);
-    });
-    for (const [seg] of srcSorted) source_dirs.push(seg);
-
-    // Test dirs: any top-level dir named in TEST_DIR_KEYWORDS that accrued files,
-    // plus any top segment with test files.
-    const testSet = new Set<string>();
-    for (const [seg] of testCluster.entries()) {
-      if (TEST_DIR_KEYWORDS.includes(seg)) testSet.add(seg);
-    }
-    // Also pick up "tests/" under each source dir — e.g. apps/ai-service/tests/
-    // Glob again just for test dirs this language may have.
-    let testDirHits: string[] = [];
-    try {
-      testDirHits = fg.sync(
-        TEST_DIR_KEYWORDS.map((k) => `**/${k}/**/*.${exts[0]}`),
-        {
-          cwd: projectRoot,
-          dot: false,
-          ignore: IGNORE_PATTERNS,
-          followSymbolicLinks: false,
-          suppressErrors: true,
-        }
-      );
-    } catch {
-      testDirHits = [];
-    }
-    const testPrefixes = new Set<string>();
-    for (const f of testDirHits) {
-      // Keep the prefix up to and including the test keyword dir
-      const segs = f.split('/');
-      for (let i = 0; i < segs.length; i++) {
-        if (TEST_DIR_KEYWORDS.includes(segs[i])) {
-          testPrefixes.add(segs.slice(0, i + 1).join('/'));
-          break;
-        }
-      }
-    }
-    for (const p of testPrefixes) testSet.add(p);
-    for (const seg of testSet) test_dirs.push(seg);
-    test_dirs.sort();
-
-    // Colocated if test_dirs set is empty AND test files exist AND testFiles/(src+test) < 0.3
-    const totalFiles = sourceFiles.length + testFiles.length;
-    const testRatio = totalFiles === 0 ? 0 : testFiles.length / totalFiles;
-    const hasDedicatedTestDir = test_dirs.length > 0;
-    const colocated =
-      !hasDedicatedTestDir && testFiles.length > 0 && testRatio < 0.3;
-    if (colocated) {
-      for (const s of source_dirs) if (!test_dirs.includes(s)) test_dirs.push(s);
-    }
-
-    out[lang] = {
-      source_dirs,
-      test_dirs,
-      colocated,
-      file_count: files.length,
-    };
-  }
-  return out;
-}

package/src/detect/vr-command-map.ts

@@ -1,167 +0,0 @@
-// Copyright (c) 2026 Massu. All rights reserved.
-// Licensed under BSL 1.1 - see LICENSE file for details.
-
-/**
- * VR Command Map (P1-005)
- * =======================
- *
- * Given a language + framework info + workspace directory, produce the
- * verification command set (VR-TEST, VR-TYPE, VR-BUILD, VR-SYNTAX, VR-LINT)
- * that the skill runners should invoke.
- *
- * User overrides from `massu.config.yaml` `verification.<language>.*` take
- * precedence over the built-in mapping.
- *
- * Usage:
- * ```ts
- * import { getVRCommands } from './detect/vr-command-map.ts';
- * const cmds = getVRCommands('python', { test_framework: 'pytest', ... }, 'apps/ai-service');
- * // => { test: 'cd apps/ai-service && python3 -m pytest -q', ... }
- * ```
- */
-
-import type { SupportedLanguage } from './package-detector.ts';
-import type { FrameworkInfo } from './framework-detector.ts';
-
-export interface VRCommandSet {
-  /** VR-TEST command. */
-  test: string | null;
-  /** VR-TYPE command. */
-  type: string | null;
-  /** VR-BUILD command. */
-  build: string | null;
-  /** VR-SYNTAX command. */
-  syntax: string | null;
-  /** VR-LINT command. */
-  lint: string | null;
-}
-
-/** Shape read from `config.verification[<language>]`. */
-export interface UserVerificationEntry {
-  type?: string;
-  test?: string;
-  syntax?: string;
-  lint?: string;
-  build?: string;
-}
-
-function prefix(dir: string, cmd: string): string {
-  if (!dir || dir === '.') return cmd;
-  return `cd ${dir} && ${cmd}`;
-}
-
-function defaultsFor(
-  language: SupportedLanguage,
-  fw: FrameworkInfo,
-  dir: string
-): VRCommandSet {
-  switch (language) {
-    case 'python': {
-      const testFw = fw.test_framework ?? 'pytest';
-      return {
-        test:
-          testFw === 'unittest'
-            ? prefix(dir, 'python3 -m unittest')
-            : prefix(dir, 'python3 -m pytest -q'),
-        type: prefix(dir, 'python3 -m mypy .'),
-        build: null,
-        syntax: prefix(dir, 'python3 -m py_compile'),
-        lint: prefix(dir, 'python3 -m ruff check .'),
-      };
-    }
-    case 'typescript': {
-      const testFw = fw.test_framework ?? 'vitest';
-      // Test command uses npm test (respecting package.json script); fallback mapping
-      // is fine because npm test routes through whatever runner is wired.
-      return {
-        test: prefix(dir, 'npm test'),
-        type: prefix(dir, 'npx tsc --noEmit'),
-        build: prefix(dir, 'npm run build'),
-        syntax: null,
-        lint: prefix(dir, 'npx eslint .'),
-        // testFw currently only affects defaults; npm test is runner-agnostic
-        ...(testFw === 'mocha'
-          ? { test: prefix(dir, 'npx mocha') }
-          : {}),
-      };
-    }
-    case 'javascript': {
-      return {
-        test: prefix(dir, 'npm test'),
-        type: null,
-        build: prefix(dir, 'npm run build'),
-        syntax: null,
-        lint: prefix(dir, 'npx eslint .'),
-      };
-    }
-    case 'rust': {
-      return {
-        test: prefix(dir, 'cargo test'),
-        type: prefix(dir, 'cargo check'),
-        build: prefix(dir, 'cargo build'),
-        syntax: null,
-        lint: prefix(dir, 'cargo clippy -- -D warnings'),
-      };
-    }
-    case 'swift': {
-      return {
-        test: prefix(dir, 'swift test'),
-        type: prefix(dir, 'swift build'),
-        build: prefix(dir, 'xcodebuild build'),
-        syntax: null,
-        lint: prefix(dir, 'swiftlint'),
-      };
-    }
-    case 'go': {
-      return {
-        test: prefix(dir, 'go test ./...'),
-        type: prefix(dir, 'go vet ./...'),
-        build: prefix(dir, 'go build ./...'),
-        syntax: null,
-        lint: prefix(dir, 'golangci-lint run'),
-      };
-    }
-    case 'java': {
-      return {
-        test: prefix(dir, 'mvn test'),
-        type: prefix(dir, 'mvn compile'),
-        build: prefix(dir, 'mvn package'),
-        syntax: null,
-        lint: null,
-      };
-    }
-    case 'ruby': {
-      return {
-        test: prefix(dir, 'bundle exec rspec'),
-        type: null,
-        build: null,
-        syntax: prefix(dir, 'ruby -c'),
-        lint: prefix(dir, 'bundle exec rubocop'),
-      };
-    }
-    default:
-      return { test: null, type: null, build: null, syntax: null, lint: null };
-  }
-}
-
-/**
- * Produce the VR command set for a language.
- *
- * User-provided entries (if any) override built-ins key-by-key.
- */
-export function getVRCommands(
-  language: SupportedLanguage,
-  framework: FrameworkInfo,
-  dir: string,
-  userOverrides?: UserVerificationEntry
-): VRCommandSet {
-  const built = defaultsFor(language, framework, dir);
-  if (!userOverrides) return built;
-  return {
-    test: userOverrides.test ?? built.test,
-    type: userOverrides.type ?? built.type,
-    build: userOverrides.build ?? built.build,
-    syntax: userOverrides.syntax ?? built.syntax,
-    lint: userOverrides.lint ?? built.lint,
-  };
-}

package/src/docs-map.json

@@ -1,100 +0,0 @@
-{
-  "version": 1,
-  "description": "Maps app code (routes, routers, components) to help site pages. Used by massu_docs_audit to detect which docs need updating when code changes.",
-  "mappings": [
-    {
-      "id": "dashboard",
-      "helpPage": "pages/dashboard.mdx",
-      "appRoutes": ["src/app/dashboard/**"],
-      "routers": ["dashboard.ts", "analytics.ts"],
-      "components": ["src/components/dashboard/**", "src/components/analytics/**"],
-      "keywords": ["dashboard", "home", "overview", "analytics", "KPI"]
-    },
-    {
-      "id": "auth",
-      "helpPage": "pages/auth.mdx",
-      "appRoutes": ["src/app/auth/**", "src/app/login/**"],
-      "routers": ["auth.ts", "sessions.ts", "oauth.ts"],
-      "components": ["src/components/auth/**"],
-      "keywords": ["login", "signup", "authentication", "password", "SSO", "OAuth"]
-    },
-    {
-      "id": "users",
-      "helpPage": "pages/users.mdx",
-      "appRoutes": ["src/app/users/**", "src/app/profile/**"],
-      "routers": ["users.ts", "user-profiles.ts", "user-preferences.ts"],
-      "components": ["src/components/users/**", "src/components/profile/**"],
-      "keywords": ["user", "profile", "account", "preferences"]
-    },
-    {
-      "id": "teams",
-      "helpPage": "pages/teams.mdx",
-      "appRoutes": ["src/app/teams/**", "src/app/organizations/**"],
-      "routers": ["teams.ts", "team-members.ts", "organizations.ts", "invitations.ts"],
-      "components": ["src/components/teams/**", "src/components/organizations/**"],
-      "keywords": ["team", "organization", "member", "invite", "role"]
-    },
-    {
-      "id": "billing",
-      "helpPage": "pages/billing.mdx",
-      "appRoutes": ["src/app/billing/**", "src/app/subscriptions/**"],
-      "routers": ["billing.ts", "subscriptions.ts", "invoices.ts", "payment-methods.ts"],
-      "components": ["src/components/billing/**", "src/components/subscriptions/**"],
-      "keywords": ["billing", "subscription", "invoice", "payment", "plan", "pricing"]
-    },
-    {
-      "id": "settings",
-      "helpPage": "pages/settings.mdx",
-      "appRoutes": ["src/app/settings/**", "src/app/admin/**"],
-      "routers": ["settings.ts", "admin.ts", "feature-flags.ts"],
-      "components": ["src/components/settings/**", "src/components/admin/**"],
-      "keywords": ["settings", "configuration", "admin", "preferences", "feature flag"]
-    },
-    {
-      "id": "notifications",
-      "helpPage": "pages/notifications.mdx",
-      "appRoutes": ["src/app/notifications/**"],
-      "routers": ["notifications.ts", "notification-preferences.ts", "push-notifications.ts"],
-      "components": ["src/components/notifications/**"],
-      "keywords": ["notification", "alert", "email", "push", "webhook"]
-    },
-    {
-      "id": "projects",
-      "helpPage": "pages/projects.mdx",
-      "appRoutes": ["src/app/projects/**"],
-      "routers": ["projects.ts", "project-members.ts", "project-settings.ts"],
-      "components": ["src/components/projects/**"],
-      "keywords": ["project", "workspace", "task", "milestone"]
-    },
-    {
-      "id": "api-docs",
-      "helpPage": "pages/api-docs.mdx",
-      "appRoutes": ["src/app/api-docs/**"],
-      "routers": ["api-keys.ts", "webhooks.ts"],
-      "components": ["src/components/api-docs/**"],
-      "keywords": ["API", "key", "webhook", "endpoint", "documentation"]
-    },
-    {
-      "id": "integrations",
-      "helpPage": "pages/integrations.mdx",
-      "appRoutes": ["src/app/integrations/**"],
-      "routers": ["integrations.ts", "oauth-connections.ts", "sync.ts"],
-      "components": ["src/components/integrations/**"],
-      "keywords": ["integration", "connect", "sync", "OAuth", "third-party"]
-    }
-  ],
-  "userGuideInheritance": {
-    "description": "User guide pages inherit their parent feature's mapping. The guide name contains the feature keyword. For example, billing-guide inherits from the 'billing' mapping.",
-    "pattern": "pages/user-guides/{feature}-guide/**",
-    "examples": {
-      "dashboard-guide": "dashboard",
-      "billing-guide": "billing",
-      "team-management-guide": "teams",
-      "user-management-guide": "users",
-      "notifications-guide": "notifications",
-      "analytics-guide": "dashboard",
-      "project-setup-guide": "projects",
-      "api-integration-guide": "integrations"
-    }
-  }
-}