@component-compass/cli 0.0.2 → 0.0.4

package/dist/seeds.js

@@ -1,13 +1,12 @@
 /**
- * Builds per-component seeds from a resolver-emitted snapshot,
- * parser-emitted occurrences, and the workspace tag rules. Seeds are the
- * per-component input to `rollupOccurrencesToComponents`: they carry
- * identity, derivedTags, and manifest enrichment but no occurrence data
- * (that is merged separately during rollup).
+ * Builds per-component seeds from a resolver-emitted snapshot and
+ * parser-emitted occurrences. Seeds are the per-component input to
+ * `rollupOccurrencesToComponents`: they carry identity and manifest enrichment
+ * but no occurrence data (that is merged separately during rollup).
  *
  * Pure function; no I/O.
  */
-import { evaluateTagRules } from "./config/tag-rules.js";
+import { relative, isAbsolute } from "node:path";
 import { manifestComponentToOutput } from "./reporter/index.js";
 import { computeOutputIdentity, computeStableId, computeStableIdFromComponentId, } from "./identity.js";
 /**
@@ -15,61 +14,152 @@ import { computeOutputIdentity, computeStableId, computeStableIdFromComponentId,
  * ComponentSeeds.
  *
  * Two sources contribute:
- *   1. Snapshotted components — full enrichment via `manifestComponentToOutput`,
- *      labelled with the snapshot entry's `enrichmentSource`.
- *   2. Components observed in parser walks but absent from the snapshot —
- *      emitted with `manifest: null` so they surface in `components[]` per
- *      the realignment principle ("manifest is enrichment, not gate").
+ *   1. Components observed in parser walks — carry `modulePath` from the
+ *      resolver and surface with `manifest: null` initially.
+ *   2. Snapshotted components — full enrichment via `manifestComponentToOutput`,
+ *      labelled with the snapshot entry's `enrichmentSource`. Snapshot entries
+ *      have NO `modulePath` (manifests don't carry that info), so their stable
+ *      id differs from the parser-emitted seed for the same logical component.
+ *      To avoid emitting a ghost component, we attach the snapshot's manifest
+ *      enrichment to a matching parser-emitted seed when the match is
+ *      unambiguous (exactly one parser seed with `{kind, packageName,
+ *      exportName-or-tagName}`). Ambiguous matches fall through to a
+ *      snapshot-only seed.
  *
- * Dedupe by stable id; snapshotted seeds win.
- *
- * Scope derivation follows the three-lane model in identity.ts:
- *   - local  → source.type === "local"
- *   - ds     → external + derivedTags.length > 0
- *   - external → external + no matching tag rules
+ * Scope derivation: "local" for source.type === "local"; "external" otherwise.
+ * DS-grouping is the web app's responsibility — CC emits two scopes only.
  */
-export function buildComponentSeeds(snapshot, parseResults, tagRules) {
+export function buildComponentSeeds(snapshot, parseResults, localIndex, repoRoot, workspaceGraph) {
     const seedsById = new Map();
-    // 1. Resolver-snapshotted components first (so they win on dedupe).
+    // 1. Parser-emitted components first. These carry `modulePath` for
+    //    resolver-driven externals and are the ones occurrences hash against.
+    for (const result of parseResults) {
+        for (const occ of result.occurrences) {
+            // Normalise local filePaths: parsers emit absolute paths; the local index
+            // uses repo-root-relative POSIX paths. Relativise here so the stable id
+            // matches the one produced for seeds built from the local index.
+            const componentId = repoRoot && occ.componentId.source.type === "local" && isAbsolute(occ.componentId.source.filePath)
+                ? {
+                    ...occ.componentId,
+                    source: {
+                        type: "local",
+                        filePath: relative(repoRoot, occ.componentId.source.filePath).replace(/\\/g, "/"),
+                    },
+                }
+                : occ.componentId;
+            const id = computeStableIdFromComponentId(componentId);
+            if (seedsById.has(id))
+                continue;
+            const isLocal = componentId.source.type === "local";
+            let definitionLoc;
+            if (isLocal && localIndex) {
+                let match;
+                if (componentId.kind === "custom-element") {
+                    match = localIndex.byTag.get(componentId.tagName);
+                }
+                else {
+                    const path = componentId.source.type === "local" ? componentId.source.filePath : "";
+                    const defs = localIndex.byPath.get(path) ?? [];
+                    const exportName = componentId.export;
+                    match = defs.find((d) => d.exportName === exportName);
+                }
+                if (match?.loc) {
+                    definitionLoc = { line: match.loc.line, column: match.loc.column };
+                }
+            }
+            const identity = computeOutputIdentity({
+                componentId,
+                repoId: "",
+                ...(workspaceGraph !== undefined ? { workspaceGraph } : {}),
+                ...(definitionLoc !== undefined ? { definitionLoc } : {}),
+            });
+            seedsById.set(id, { id, identity, manifest: null, deprecated: false });
+        }
+    }
+    // 2. Snapshotted components. Snapshot entries lack `modulePath`, so their
+    //    stable id won't collide with the parser-emitted seed even when they
+    //    describe the same logical component. Instead of hashing, look up by
+    //    `{kind, packageName, exportName-or-tagName}` and attach the manifest
+    //    enrichment to that parser seed. Only merge when exactly one parser
+    //    seed matches — multiple matches (e.g. two subpaths both exporting
+    //    `default`) are ambiguous, so fall through to a snapshot-only seed.
     for (const entry of snapshot) {
         const componentId = indexedToComponentId(entry.component);
-        const packageName = entry.component.source.type === "external"
-            ? entry.component.source.package
-            : null;
-        const derivedTags = evaluateTagRules(packageName, tagRules);
-        const via = defaultVia(entry.component);
+        const manifest = manifestComponentToOutput(entry.component, entry.enrichmentSource);
+        const mergeTarget = findUnambiguousMergeTarget(seedsById, componentId);
+        if (mergeTarget !== null) {
+            mergeTarget.manifest = manifest;
+            mergeTarget.deprecated = false;
+            continue;
+        }
         const identity = computeOutputIdentity({
             componentId,
-            via,
-            derivedTags,
             repoId: "",
+            ...(workspaceGraph !== undefined ? { workspaceGraph } : {}),
         });
         const id = computeStableId(identity);
-        const manifest = manifestComponentToOutput(entry.component, entry.enrichmentSource);
-        seedsById.set(id, { id, identity, derivedTags, manifest });
+        if (seedsById.has(id))
+            continue;
+        seedsById.set(id, { id, identity, manifest, deprecated: false });
     }
-    // 2. Components observed in parser walks but not yet seeded.
-    //    Emitted with manifest: null per the realignment principle.
-    for (const result of parseResults) {
-        for (const occ of result.occurrences) {
-            const id = computeStableIdFromComponentId(occ.componentId);
-            if (seedsById.has(id))
-                continue;
-            const packageName = occ.componentId.source.type === "external"
-                ? occ.componentId.source.package
-                : null;
-            const derivedTags = evaluateTagRules(packageName, tagRules);
-            const identity = computeOutputIdentity({
-                componentId: occ.componentId,
-                via: defaultViaForKind(occ.componentId),
-                derivedTags,
-                repoId: "",
-            });
-            seedsById.set(id, { id, identity, derivedTags, manifest: null });
+    // 3. Local definitions that were never referenced in any occurrence.
+    //    These must still appear in components[] so they can serve as
+    //    owner-edge targets in the composition graph.
+    if (localIndex) {
+        for (const [, defs] of localIndex.byPath) {
+            for (const def of defs) {
+                const id = computeStableIdFromComponentId(def.componentId);
+                if (seedsById.has(id))
+                    continue;
+                const definitionLoc = def.loc !== undefined
+                    ? { line: def.loc.line, column: def.loc.column }
+                    : undefined;
+                const identity = computeOutputIdentity({
+                    componentId: def.componentId,
+                    repoId: "",
+                    ...(workspaceGraph !== undefined ? { workspaceGraph } : {}),
+                    ...(definitionLoc !== undefined ? { definitionLoc } : {}),
+                });
+                seedsById.set(id, { id, identity, manifest: null, deprecated: false });
+            }
         }
     }
     return [...seedsById.values()];
 }
+/**
+ * Find a parser-emitted seed whose logical identity matches the snapshot's
+ * `ComponentId`, ignoring `modulePath` (snapshot entries don't carry it).
+ *
+ * The match is intentionally narrowed to **unambiguous** cases: if two or more
+ * parser seeds share the same `{kind, packageName, exportName/tagName}` (e.g.
+ * two subpaths of one package both exporting `default`), we cannot safely pick
+ * one to enrich, so we return null and let the caller fall through to a
+ * snapshot-only seed.
+ */
+function findUnambiguousMergeTarget(seeds, candidate) {
+    if (candidate.source.type !== "external")
+        return null;
+    const candidatePackage = candidate.source.package;
+    let match = null;
+    for (const seed of seeds.values()) {
+        if (seed.identity.kind !== candidate.kind)
+            continue;
+        if (seed.identity.packageName !== candidatePackage)
+            continue;
+        if (candidate.kind === "custom-element") {
+            if (seed.identity.tagName !== candidate.tagName)
+                continue;
+        }
+        else {
+            if (seed.identity.exportName !== candidate.export)
+                continue;
+        }
+        if (match !== null)
+            return null; // ambiguous — bail out
+        match = seed;
+    }
+    return match;
+}
 /**
  * Convert an `IndexedComponent` to a `ComponentId` for use with
  * `computeOutputIdentity`. `IndexedComponent` extends `ManifestComponent`
@@ -89,26 +179,4 @@ function indexedToComponentId(c) {
         source: c.source,
     };
 }
-/**
- * Infer a default `via` for a snapshotted seed based on component kind.
- * Only `via.kind` is consumed by `computeOutputIdentity`; the required
- * `specifier`/`import` fields on `direct-import` are not meaningful for
- * zero-occurrence seeds and are left as empty strings.
- */
-function defaultVia(c) {
-    if (c.kind === "custom-element") {
-        return { kind: "html-tag" };
-    }
-    return { kind: "direct-import", specifier: "", import: "" };
-}
-/**
- * Infer a default `via` for an occurrence-observed seed based on the
- * component's kind. Used when seeding a component that has no snapshot entry.
- */
-function defaultViaForKind(c) {
-    if (c.kind === "custom-element") {
-        return { kind: "html-tag" };
-    }
-    return { kind: "direct-import", specifier: "", import: "" };
-}
 //# sourceMappingURL=seeds.js.map

package/dist/seeds.js.map

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

package/dist/types.d.ts

@@ -1,16 +1,13 @@
 export type { Loc, WarningCode, Warning } from "@component-compass/plugin-core";
-export type { TagRule } from "./config/schema.js";
-import type { TagRule } from "./config/schema.js";
 export type ResolvedConfig = {
     configPath: string;
     configDir: string;
-    repoId: string;
-    packageScopes: string[];
+    repoId?: string;
     include: string[];
     exclude: string[];
     captureValues: boolean;
     output: string;
+    gitignore: boolean;
     tsconfigPath?: string;
     aliases?: Record<string, string[]>;
-    tagRules?: TagRule[];
 };

package/dist/util/git.d.ts

@@ -1 +1,9 @@
+export type MTimeRange = {
+    firstCommitAt: string;
+    lastCommitAt: string;
+};
+export declare function readFileMTimes(root: string, paths: string[]): Promise<Map<string, MTimeRange>>;
 export declare function readGitCommit(root: string): Promise<string | undefined>;
+export declare function readInitialCommit(root: string): Promise<string | undefined>;
+export declare function readGitRemote(root: string): Promise<string | null>;
+export declare function readGitBranch(root: string): Promise<string | null>;

package/dist/util/git.js

@@ -1,6 +1,50 @@
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 const exec = promisify(execFile);
+export async function readFileMTimes(root, paths) {
+    if (paths.length === 0)
+        return new Map();
+    const out = new Map();
+    // git log --reverse interleaves commits oldest-first. Marker line precedes
+    // each commit's file list. Walk linearly: track currentDate, then bucket
+    // each named path into first (set once) / last (overwrite each commit).
+    // Known fidelity gaps: shallow clones cap firstCommitAt at the depth boundary;
+    // renames without --follow stop at the rename. Both documented in the spec.
+    try {
+        const args = [
+            "-c",
+            "core.quotePath=false",
+            "log",
+            "--reverse",
+            "--name-only",
+            "--format=__CC_COMMIT__ %aI",
+            "--",
+            ...paths,
+        ];
+        const { stdout } = await exec("git", args, {
+            cwd: root,
+            maxBuffer: 64 * 1024 * 1024,
+        });
+        let currentDate = null;
+        for (const line of stdout.split("\n")) {
+            if (line.startsWith("__CC_COMMIT__ ")) {
+                currentDate = line.slice("__CC_COMMIT__ ".length).trim();
+            }
+            else if (line.trim() && currentDate) {
+                const p = line.trim();
+                const existing = out.get(p);
+                if (existing)
+                    existing.lastCommitAt = currentDate;
+                else
+                    out.set(p, { firstCommitAt: currentDate, lastCommitAt: currentDate });
+            }
+        }
+    }
+    catch {
+        // git failure or buffer overflow — return whatever's accumulated (or empty).
+    }
+    return out;
+}
 export async function readGitCommit(root) {
     try {
         const { stdout } = await exec("git", ["rev-parse", "HEAD"], { cwd: root });
@@ -10,4 +54,33 @@ export async function readGitCommit(root) {
         return undefined;
     }
 }
+export async function readInitialCommit(root) {
+    try {
+        const { stdout } = await exec("git", ["rev-list", "--max-parents=0", "HEAD"], { cwd: root });
+        return stdout.trim().split("\n")[0];
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function readGitRemote(root) {
+    try {
+        const { stdout } = await exec("git", ["config", "--get", "remote.origin.url"], { cwd: root });
+        return stdout.trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function readGitBranch(root) {
+    try {
+        const { stdout } = await exec("git", ["rev-parse", "--abbrev-ref", "HEAD"], { cwd: root });
+        const branch = stdout.trim();
+        // "HEAD" means detached HEAD state — not a named branch.
+        return branch === "HEAD" ? null : branch || null;
+    }
+    catch {
+        return null;
+    }
+}
 //# sourceMappingURL=git.js.map

package/dist/util/git.js.map

@@ -1 +1 @@
-{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/util/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAEjC,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY;IAC9C,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3E,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/util/git.ts"],"names":[],"mappings":"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"}

package/dist/util/progress.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Rate-limited progress reporter for the scan loop. Emits a single line on
+ * stderr — rewriting in place when stderr is a TTY, appending one line per
+ * tick otherwise (CI logs).
+ *
+ * Rate limit: emit when either ≥50 ticks have happened since the last emit
+ * OR ≥250ms have elapsed. Tuned so the line moves smoothly on TTYs without
+ * spamming non-TTY logs.
+ */
+export type ProgressOptions = {
+    total: number;
+    writer: (s: string) => void;
+    isTTY: boolean;
+    /** Verb prefix in the rendered line (default: "Scanned"). */
+    label?: string;
+};
+export type Progress = {
+    tick(): void;
+    done(): void;
+};
+export declare function createProgress(opts: ProgressOptions): Progress;

package/dist/util/progress.js

@@ -0,0 +1,54 @@
+/**
+ * Rate-limited progress reporter for the scan loop. Emits a single line on
+ * stderr — rewriting in place when stderr is a TTY, appending one line per
+ * tick otherwise (CI logs).
+ *
+ * Rate limit: emit when either ≥50 ticks have happened since the last emit
+ * OR ≥250ms have elapsed. Tuned so the line moves smoothly on TTYs without
+ * spamming non-TTY logs.
+ */
+const COUNT_THRESHOLD = 50;
+const TIME_THRESHOLD_MS = 250;
+export function createProgress(opts) {
+    const start = Date.now();
+    let processed = 0;
+    let lastEmitCount = -1; // forces emission on the first tick
+    let lastEmitTime = 0;
+    const label = opts.label ?? "Scanned";
+    function emit() {
+        const pct = opts.total > 0 ? ((processed / opts.total) * 100).toFixed(1) : "0.0";
+        const elapsedS = ((Date.now() - start) / 1000).toFixed(1);
+        const body = `${label} ${processed} / ${opts.total} files (${pct}%) — ${elapsedS}s elapsed`;
+        if (opts.isTTY) {
+            opts.writer(`\r${body}\x1b[K`);
+        }
+        else {
+            opts.writer(`${body}\n`);
+        }
+        lastEmitCount = processed;
+        lastEmitTime = Date.now();
+    }
+    return {
+        tick() {
+            processed += 1;
+            // sinceEmit counts the current tick, so the COUNT_THRESHOLDth tick since
+            // the last emit fires this branch (e.g. with threshold 50: emit at the
+            // 1st tick, then at the 50th, 99th, …). Always emit on the final tick
+            // so the bar shows 100% before the next phase starts.
+            const sinceEmit = processed - lastEmitCount;
+            const elapsedSinceEmit = Date.now() - lastEmitTime;
+            if (lastEmitCount === -1 ||
+                sinceEmit >= COUNT_THRESHOLD - 1 ||
+                elapsedSinceEmit >= TIME_THRESHOLD_MS ||
+                processed === opts.total) {
+                emit();
+            }
+        },
+        done() {
+            if (opts.isTTY && lastEmitCount > 0) {
+                opts.writer("\r\x1b[K");
+            }
+        },
+    };
+}
+//# sourceMappingURL=progress.js.map

package/dist/util/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/util/progress.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAeH,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,MAAM,UAAU,cAAc,CAAC,IAAqB;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,oCAAoC;IAC5D,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC;IAEtC,SAAS,IAAI;QACX,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACjF,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,GAAG,KAAK,IAAI,SAAS,MAAM,IAAI,CAAC,KAAK,WAAW,GAAG,QAAQ,QAAQ,WAAW,CAAC;QAC5F,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,QAAQ,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,aAAa,GAAG,SAAS,CAAC;QAC1B,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC5B,CAAC;IAED,OAAO;QACL,IAAI;YACF,SAAS,IAAI,CAAC,CAAC;YACf,yEAAyE;YACzE,uEAAuE;YACvE,sEAAsE;YACtE,sDAAsD;YACtD,MAAM,SAAS,GAAG,SAAS,GAAG,aAAa,CAAC;YAC5C,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC;YACnD,IACE,aAAa,KAAK,CAAC,CAAC;gBACpB,SAAS,IAAI,eAAe,GAAG,CAAC;gBAChC,gBAAgB,IAAI,iBAAiB;gBACrC,SAAS,KAAK,IAAI,CAAC,KAAK,EACxB,CAAC;gBACD,IAAI,EAAE,CAAC;YACT,CAAC;QACH,CAAC;QACD,IAAI;YACF,IAAI,IAAI,CAAC,KAAK,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;gBACpC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/walker/files.d.ts

@@ -2,5 +2,6 @@ export type WalkOptions = {
     root: string;
     include: string[];
     exclude: string[];
+    gitignore: boolean;
 };
 export declare function walkFiles(opts: WalkOptions): Promise<string[]>;

package/dist/walker/files.js

@@ -1,12 +1,18 @@
-import { glob } from "glob";
+import { globby } from "globby";
 export async function walkFiles(opts) {
-    const matched = await glob(opts.include, {
+    // `dot: false` skips `.next/`, `.nuxt/`, `.turbo/`, etc. unless the user
+    // explicitly globs them in. `gitignore: true` is the default at the config
+    // layer; the explicit knob exists so users can opt out for WIP scans of
+    // untracked work. `suppressErrors` silences EACCES on unreadable dirs
+    // (vendored fixtures, transient OS turds) — the walker keeps going.
+    return globby(opts.include, {
         cwd: opts.root,
-        nodir: true,
-        absolute: true,
         ignore: opts.exclude,
+        gitignore: opts.gitignore,
         dot: false,
+        absolute: true,
+        onlyFiles: true,
+        suppressErrors: true,
     });
-    return matched;
 }
 //# sourceMappingURL=files.js.map

package/dist/walker/files.js.map

@@ -1 +1 @@
-{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/walker/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAQ5B,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAiB;IAC/C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;QACvC,GAAG,EAAE,IAAI,CAAC,IAAI;QACd,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,IAAI,CAAC,OAAO;QACpB,GAAG,EAAE,KAAK;KACX,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/walker/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAShC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAiB;IAC/C,yEAAyE;IACzE,2EAA2E;IAC3E,wEAAwE;IACxE,sEAAsE;IACtE,oEAAoE;IACpE,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;QAC1B,GAAG,EAAE,IAAI,CAAC,IAAI;QACd,MAAM,EAAE,IAAI,CAAC,OAAO;QACpB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,GAAG,EAAE,KAAK;QACV,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,IAAI;QACf,cAAc,EAAE,IAAI;KACrB,CAAC,CAAC;AACL,CAAC"}

package/dist/workspace/build-graph.d.ts

@@ -0,0 +1,2 @@
+import type { WorkspaceGraph } from "./types.js";
+export declare function buildWorkspaceGraph(rootPath: string): WorkspaceGraph;

package/dist/workspace/build-graph.js

@@ -0,0 +1,117 @@
+/**
+ * Build a workspace graph from a repository root.
+ *
+ * Two independent steps:
+ *   - sniffPackageManager: lockfile-based; sets graph.packageManager. Always
+ *     runs; returns "unknown" when no lockfile is found.
+ *   - detectWorkspacePackages: pnpm-workspace.yaml → package.json#workspaces →
+ *     empty array. Independent of step 1.
+ *
+ * Glob expansion uses globby (already a CLI dep).
+ * Pure; no I/O beyond config-file reads.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { globbySync } from "globby";
+import * as yaml from "js-yaml";
+export function buildWorkspaceGraph(rootPath) {
+    const absRoot = resolve(rootPath);
+    const rootPkgJsonPath = join(absRoot, "package.json");
+    const rootPkg = readJsonSafely(rootPkgJsonPath) ?? {};
+    const rootPackageName = typeof rootPkg.name === "string" ? rootPkg.name : "<unnamed>";
+    return {
+        packageManager: sniffPackageManager(absRoot),
+        rootPath: absRoot,
+        rootPackageName,
+        packages: detectWorkspacePackages(absRoot, rootPkg),
+    };
+}
+function sniffPackageManager(absRoot) {
+    if (existsSync(join(absRoot, "pnpm-lock.yaml")))
+        return "pnpm";
+    if (existsSync(join(absRoot, "package-lock.json")))
+        return "npm";
+    if (existsSync(join(absRoot, "yarn.lock")))
+        return "yarn";
+    return "unknown";
+}
+function detectWorkspacePackages(absRoot, rootPkg) {
+    // pnpm-workspace.yaml wins when both configs present.
+    const pnpmYamlPath = join(absRoot, "pnpm-workspace.yaml");
+    if (existsSync(pnpmYamlPath)) {
+        const yamlContent = readFileSync(pnpmYamlPath, "utf8");
+        let parsed;
+        try {
+            parsed = yaml.load(yamlContent);
+        }
+        catch {
+            parsed = null;
+        }
+        const globs = isWorkspaceYaml(parsed) ? parsed.packages : [];
+        return expandPackages(absRoot, globs);
+    }
+    // package.json#workspaces (array or object form).
+    const workspaces = rootPkg.workspaces;
+    if (Array.isArray(workspaces)) {
+        return expandPackages(absRoot, workspaces);
+    }
+    if (workspaces &&
+        typeof workspaces === "object" &&
+        Array.isArray(workspaces.packages)) {
+        return expandPackages(absRoot, workspaces.packages);
+    }
+    // No workspace config → single-package repo.
+    return [];
+}
+function expandPackages(absRoot, entries) {
+    if (entries.length === 0)
+        return [];
+    // Split literal paths from globs: globby (fast-glob) treats a bare "foo"
+    // as "foo/**" and returns subdirectories instead of foo itself, so literal
+    // workspace entries must be resolved directly.
+    const literals = [];
+    const globs = [];
+    for (const e of entries) {
+        if (/[*?[\]{}]/.test(e))
+            globs.push(e);
+        else
+            literals.push(e);
+    }
+    const matched = literals.map((p) => resolve(absRoot, p));
+    if (globs.length > 0) {
+        matched.push(...globbySync(globs, {
+            cwd: absRoot,
+            onlyDirectories: true,
+            absolute: true,
+            suppressErrors: true,
+        }));
+    }
+    const packages = [];
+    const seenNames = new Set();
+    for (const dir of matched) {
+        const pkgJson = readJsonSafely(join(dir, "package.json"));
+        if (!pkgJson)
+            continue;
+        if (typeof pkgJson.name !== "string" || pkgJson.name.length === 0)
+            continue;
+        if (seenNames.has(pkgJson.name))
+            continue;
+        seenNames.add(pkgJson.name);
+        packages.push({ name: pkgJson.name, absolutePath: dir, packageJson: pkgJson });
+    }
+    return packages;
+}
+function readJsonSafely(path) {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+function isWorkspaceYaml(p) {
+    return (typeof p === "object" &&
+        p !== null &&
+        Array.isArray(p.packages));
+}
+//# sourceMappingURL=build-graph.js.map

package/dist/workspace/build-graph.js.map

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