@component-compass/cli 0.0.3 → 0.0.5

package/dist/scan/meta.js

@@ -0,0 +1,58 @@
+import { readFileSync } from "node:fs";
+import { basename, dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { ulid } from "ulid";
+import { readGitCommit, readGitRemote, readGitBranch, readInitialCommit } from "../util/git.js";
+import { readToolVersion } from "../envelope/index.js";
+export async function stampMeta(opts) {
+    const commit = await readGitCommit(opts.cwd);
+    if (!commit)
+        throw new Error(`not a git repository: ${opts.cwd}`);
+    const rawInitialCommit = await readInitialCommit(opts.cwd);
+    const initialCommit = rawInitialCommit ?? null;
+    if (!initialCommit) {
+        process.stderr.write("warn: initial commit unavailable (shallow clone?) — set fetch-depth: 0 in CI for stable repo identity\n");
+    }
+    const gitRemote = await readGitRemote(opts.cwd);
+    const branch = await readGitBranch(opts.cwd);
+    const id = opts.repoIdOverride ?? deriveId(gitRemote, opts.cwd);
+    return {
+        ccVersion: readToolVersion(findCliPackageRoot()),
+        scanId: ulid(),
+        scannedAt: new Date().toISOString(),
+        repo: { id, gitRemote, commit, initialCommit, branch },
+    };
+}
+function deriveId(remote, cwd) {
+    if (remote) {
+        const match = remote.match(/[/:]([^/]+?)(\.git)?$/);
+        if (match?.[1])
+            return match[1];
+    }
+    return basename(cwd);
+}
+/**
+ * Walk up from this module's directory until we find the @component-compass/cli
+ * package.json. Robust to running from dist/ or src/ (vitest) without
+ * hardcoding a relative depth. Mirrors the pattern in envelope/index.ts.
+ */
+function findCliPackageRoot() {
+    let dir = dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 6; i++) {
+        const candidate = join(dir, "package.json");
+        try {
+            const parsed = JSON.parse(readFileSync(candidate, "utf8"));
+            if (parsed.name === "@component-compass/cli")
+                return dir;
+        }
+        catch {
+            // continue walking
+        }
+        const parent = resolve(dir, "..");
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return dirname(fileURLToPath(import.meta.url));
+}
+//# sourceMappingURL=meta.js.map

package/dist/scan/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/scan/meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAChG,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAA8C;IAC5E,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAClE,MAAM,gBAAgB,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3D,MAAM,aAAa,GAAG,gBAAgB,IAAI,IAAI,CAAC;IAC/C,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,yGAAyG,CAC1G,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,EAAE,GAAG,IAAI,CAAC,cAAc,IAAI,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAChE,OAAO;QACL,SAAS,EAAE,eAAe,CAAC,kBAAkB,EAAE,CAAC;QAChD,MAAM,EAAE,IAAI,EAAE;QACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE;KACvD,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,MAAqB,EAAE,GAAW;IAClD,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QACpD,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB;IACzB,IAAI,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAuB,CAAC;YACjF,IAAI,MAAM,CAAC,IAAI,KAAK,wBAAwB;gBAAE,OAAO,GAAG,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,mBAAmB;QACrB,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAClC,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,OAAO,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/scan/stamp-deprecated.d.ts

@@ -0,0 +1,16 @@
+import type { OutputComponent } from "@component-compass/plugin-core";
+import type { CemIndex } from "./cem-index.js";
+/**
+ * Stamp `deprecated: true` onto each custom-element component whose CEM
+ * declaration carries `deprecated: true` (or a reason string). All other
+ * components keep the default `deprecated: false` set during rollup.
+ *
+ * Sources checked, in priority order:
+ *   1. Global CEM index (built from node_modules at scan startup) — covers
+ *      custom-elements resolved via the HTML/Lit/Vue tag-name path.
+ *   2. component.manifest?.data?.lifecycle?.status — covers components whose
+ *      manifest was loaded via the lazy-resolver path.
+ *
+ * A component is deprecated when EITHER source says so.
+ */
+export declare function stampDeprecated(components: OutputComponent[], cemIndex: CemIndex): void;

package/dist/scan/stamp-deprecated.js

@@ -0,0 +1,33 @@
+/**
+ * Stamp `deprecated: true` onto each custom-element component whose CEM
+ * declaration carries `deprecated: true` (or a reason string). All other
+ * components keep the default `deprecated: false` set during rollup.
+ *
+ * Sources checked, in priority order:
+ *   1. Global CEM index (built from node_modules at scan startup) — covers
+ *      custom-elements resolved via the HTML/Lit/Vue tag-name path.
+ *   2. component.manifest?.data?.lifecycle?.status — covers components whose
+ *      manifest was loaded via the lazy-resolver path.
+ *
+ * A component is deprecated when EITHER source says so.
+ */
+export function stampDeprecated(components, cemIndex) {
+    for (const c of components) {
+        // Manifest-lifecycle path: already captured via lazy-resolver enrichment.
+        if (c.manifest?.data?.lifecycle?.status === "deprecated") {
+            c.deprecated = true;
+            continue;
+        }
+        // CEM-index path: look up the tag name in the global CEM index.
+        if (c.identity.kind === "custom-element" && c.identity.tagName) {
+            const entry = cemIndex.byTag.get(c.identity.tagName);
+            if (entry) {
+                const rawDecl = entry.manifest;
+                if (rawDecl && rawDecl.deprecated !== undefined && rawDecl.deprecated !== false) {
+                    c.deprecated = true;
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=stamp-deprecated.js.map

package/dist/scan/stamp-deprecated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp-deprecated.js","sourceRoot":"","sources":["../../src/scan/stamp-deprecated.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAC7B,UAA6B,EAC7B,QAAkB;IAElB,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,0EAA0E;QAC1E,IAAI,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,KAAK,YAAY,EAAE,CAAC;YACzD,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC;YACpB,SAAS;QACX,CAAC;QAED,gEAAgE;QAChE,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,gBAAgB,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC/D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACrD,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,OAAO,GAAG,KAAK,CAAC,QAAoD,CAAC;gBAC3E,IAAI,OAAO,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC;oBAChF,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/scan/stamp-version.d.ts

@@ -0,0 +1,18 @@
+import type { OutputComponent, OutputOccurrence } from "@component-compass/plugin-core";
+/**
+ * Reads each external/workspace package's `version` from its installed
+ * `package.json` and stamps it onto every component from that package.
+ * Local components keep `version: null`.
+ *
+ * Uses Node-style module resolution: walks upward from a representative
+ * occurrence's file directory through ancestor `node_modules` directories
+ * until the package is found. Starting from inside the sub-app that uses
+ * the package handles multi-app monorepos where deps are installed per-app
+ * (e.g. `pie-aperture/nextjs-app-v14/node_modules/`) rather than hoisted
+ * to the workspace root. Falls back to `startDir` for packages with no
+ * occurrences.
+ *
+ * Batches IO: one package.json read per unique external package name, not
+ * per component.
+ */
+export declare function stampVersion(startDir: string, components: OutputComponent[], occurrences?: OutputOccurrence[]): Promise<void>;

package/dist/scan/stamp-version.js

@@ -0,0 +1,94 @@
+import { readFile } from "node:fs/promises";
+import { join, dirname, resolve } from "node:path";
+/**
+ * Reads each external/workspace package's `version` from its installed
+ * `package.json` and stamps it onto every component from that package.
+ * Local components keep `version: null`.
+ *
+ * Uses Node-style module resolution: walks upward from a representative
+ * occurrence's file directory through ancestor `node_modules` directories
+ * until the package is found. Starting from inside the sub-app that uses
+ * the package handles multi-app monorepos where deps are installed per-app
+ * (e.g. `pie-aperture/nextjs-app-v14/node_modules/`) rather than hoisted
+ * to the workspace root. Falls back to `startDir` for packages with no
+ * occurrences.
+ *
+ * Batches IO: one package.json read per unique external package name, not
+ * per component.
+ */
+export async function stampVersion(startDir, components, occurrences = []) {
+    // Collect unique external package names.
+    const packageNames = new Set();
+    for (const c of components) {
+        if (c.identity.scope !== "local" && c.identity.packageName) {
+            packageNames.add(c.identity.packageName);
+        }
+    }
+    // componentId → packageName for fast occurrence → package lookup.
+    const pkgByComponentId = new Map();
+    for (const c of components) {
+        if (c.identity.scope !== "local" && c.identity.packageName) {
+            pkgByComponentId.set(c.id, c.identity.packageName);
+        }
+    }
+    // packageName → directory to start the walk-up from. Use the parent dir of
+    // any occurrence's file path (resolved relative to startDir). Multi-app
+    // monorepos install deps per-app, so walking up from inside the sub-app
+    // hits the per-app node_modules. Falls back to startDir for packages with
+    // no occurrences.
+    const starterDirByPackage = new Map();
+    for (const o of occurrences) {
+        const pkg = pkgByComponentId.get(o.componentId);
+        if (pkg && !starterDirByPackage.has(pkg)) {
+            starterDirByPackage.set(pkg, dirname(resolve(startDir, o.filePath)));
+        }
+    }
+    // Read each package.json once. Store null when not found / no version field.
+    const versionByPackage = new Map();
+    await Promise.all([...packageNames].map(async (name) => {
+        const searchFrom = starterDirByPackage.get(name) ?? startDir;
+        const version = await resolvePackageVersion(searchFrom, name);
+        versionByPackage.set(name, version);
+    }));
+    // Stamp each component.
+    for (const c of components) {
+        if (c.identity.scope !== "local" && c.identity.packageName) {
+            c.version = versionByPackage.get(c.identity.packageName) ?? null;
+        }
+        else {
+            c.version = null;
+        }
+    }
+}
+/**
+ * Walk up the directory tree from `startDir`, trying
+ * `<dir>/node_modules/<packageName>/package.json` at each level.
+ * Returns the `version` string, or null when not found anywhere.
+ */
+async function resolvePackageVersion(startDir, packageName) {
+    let dir = startDir;
+    while (true) {
+        const pkgPath = join(dir, "node_modules", packageName, "package.json");
+        try {
+            const raw = await readFile(pkgPath, "utf8");
+            try {
+                const pkg = JSON.parse(raw);
+                return pkg.version ?? null;
+            }
+            catch {
+                // Malformed JSON — file exists, version unreadable.
+                return null;
+            }
+        }
+        catch {
+            // File not found or unreadable — try parent.
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            // Reached filesystem root.
+            return null;
+        }
+        dir = parent;
+    }
+}
+//# sourceMappingURL=stamp-version.js.map

package/dist/scan/stamp-version.js.map

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

package/dist/seeds.d.ts

@@ -1,14 +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 type { IndexedComponent, LocalDefinitionIndex, ParseResult } from "@component-compass/plugin-core";
-import type { TagRule } from "./config/schema.js";
 import type { ComponentSeed } from "./rollup.js";
 import type { WorkspaceGraph } from "./workspace/types.js";
 /**
@@ -25,17 +23,19 @@ export type SnapshotEntry = {
  * 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 declare function buildComponentSeeds(snapshot: SnapshotEntry[], parseResults: ParseResult[], tagRules: TagRule[] | undefined, localIndex?: LocalDefinitionIndex, repoRoot?: string, workspaceGraph?: WorkspaceGraph): ComponentSeed[];
+export declare function buildComponentSeeds(snapshot: SnapshotEntry[], parseResults: ParseResult[], localIndex?: LocalDefinitionIndex, repoRoot?: string, workspaceGraph?: WorkspaceGraph): ComponentSeed[];

package/dist/seeds.js

@@ -1,14 +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 { relative, isAbsolute } from "node:path";
-import { evaluateTagRules } from "./config/tag-rules.js";
 import { manifestComponentToOutput } from "./reporter/index.js";
 import { computeOutputIdentity, computeStableId, computeStableIdFromComponentId, } from "./identity.js";
 /**
@@ -16,40 +14,25 @@ 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, localIndex, repoRoot, workspaceGraph) {
+export function buildComponentSeeds(snapshot, parseResults, localIndex, repoRoot, workspaceGraph) {
     const seedsById = new Map();
-    // 1. Resolver-snapshotted components first (so they win on dedupe).
-    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 identity = computeOutputIdentity({
-            componentId,
-            derivedTags,
-            repoId: "",
-            ...(workspaceGraph !== undefined ? { workspaceGraph } : {}),
-        });
-        const id = computeStableId(identity);
-        const manifest = manifestComponentToOutput(entry.component, entry.enrichmentSource);
-        seedsById.set(id, { id, identity, derivedTags, manifest });
-    }
-    // 2. Components observed in parser walks but not yet seeded.
-    //    Emitted with manifest: null per the realignment principle.
+    // 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
@@ -67,10 +50,6 @@ export function buildComponentSeeds(snapshot, parseResults, tagRules, localIndex
             const id = computeStableIdFromComponentId(componentId);
             if (seedsById.has(id))
                 continue;
-            const packageName = componentId.source.type === "external"
-                ? componentId.source.package
-                : null;
-            const derivedTags = evaluateTagRules(packageName, tagRules);
             const isLocal = componentId.source.type === "local";
             let definitionLoc;
             if (isLocal && localIndex) {
@@ -90,14 +69,39 @@ export function buildComponentSeeds(snapshot, parseResults, tagRules, localIndex
             }
             const identity = computeOutputIdentity({
                 componentId,
-                derivedTags,
                 repoId: "",
                 ...(workspaceGraph !== undefined ? { workspaceGraph } : {}),
                 ...(definitionLoc !== undefined ? { definitionLoc } : {}),
             });
-            seedsById.set(id, { id, identity, derivedTags, manifest: null });
+            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 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,
+            repoId: "",
+            ...(workspaceGraph !== undefined ? { workspaceGraph } : {}),
+        });
+        const id = computeStableId(identity);
+        if (seedsById.has(id))
+            continue;
+        seedsById.set(id, { id, identity, manifest, deprecated: false });
+    }
     // 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.
@@ -112,17 +116,50 @@ export function buildComponentSeeds(snapshot, parseResults, tagRules, localIndex
                     : undefined;
                 const identity = computeOutputIdentity({
                     componentId: def.componentId,
-                    derivedTags: [],
                     repoId: "",
                     ...(workspaceGraph !== undefined ? { workspaceGraph } : {}),
                     ...(definitionLoc !== undefined ? { definitionLoc } : {}),
                 });
-                seedsById.set(id, { id, identity, derivedTags: [], manifest: null });
+                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`

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":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AASjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,8BAA8B,GAC/B,MAAM,eAAe,CAAC;AAcvB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAyB,EACzB,YAA2B,EAC3B,UAAiC,EACjC,QAAiB,EACjB,cAA+B;IAE/B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEnD,mEAAmE;IACnE,0EAA0E;IAC1E,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QAClC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACrC,0EAA0E;YAC1E,wEAAwE;YACxE,iEAAiE;YACjE,MAAM,WAAW,GACf,QAAQ,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC;gBAChG,CAAC,CAAC;oBACE,GAAG,GAAG,CAAC,WAAW;oBAClB,MAAM,EAAE;wBACN,IAAI,EAAE,OAAO;wBACb,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;qBAClF;iBACF;gBACH,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC;YAEtB,MAAM,EAAE,GAAG,8BAA8B,CAAC,WAAW,CAAC,CAAC;YACvD,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,SAAS;YAEhC,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC;YACpD,IAAI,aAA2D,CAAC;YAChE,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;gBAC1B,IAAI,KAAkC,CAAC;gBACvC,IAAI,WAAW,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;oBAC1C,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;gBACpD,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;oBACpF,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;oBAC/C,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC;oBACtC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;gBACxD,CAAC;gBACD,IAAI,KAAK,EAAE,GAAG,EAAE,CAAC;oBACf,aAAa,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;gBACrE,CAAC;YACH,CAAC;YAED,MAAM,QAAQ,GAAG,qBAAqB,CAAC;gBACrC,WAAW;gBACX,MAAM,EAAE,EAAE;gBACV,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3D,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1D,CAAC,CAAC;YAEH,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,yEAAyE;IACzE,yEAAyE;IACzE,0EAA0E;IAC1E,wEAAwE;IACxE,uEAAuE;IACvE,wEAAwE;IACxE,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAG,oBAAoB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAE1D,MAAM,QAAQ,GAAG,yBAAyB,CACxC,KAAK,CAAC,SAA8B,EACpC,KAAK,CAAC,gBAAgB,CACvB,CAAC;QAEF,MAAM,WAAW,GAAG,0BAA0B,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACvE,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,WAAW,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAChC,WAAW,CAAC,UAAU,GAAG,KAAK,CAAC;YAC/B,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,qBAAqB,CAAC;YACrC,WAAW;YACX,MAAM,EAAE,EAAE;YACV,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5D,CAAC,CAAC;QAEH,MAAM,EAAE,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QAChC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,qEAAqE;IACrE,kEAAkE;IAClE,kDAAkD;IAClD,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACzC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,MAAM,EAAE,GAAG,8BAA8B,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBAC3D,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;oBAAE,SAAS;gBAEhC,MAAM,aAAa,GACjB,GAAG,CAAC,GAAG,KAAK,SAAS;oBACnB,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE;oBAChD,CAAC,CAAC,SAAS,CAAC;gBAEhB,MAAM,QAAQ,GAAG,qBAAqB,CAAC;oBACrC,WAAW,EAAE,GAAG,CAAC,WAAW;oBAC5B,MAAM,EAAE,EAAE;oBACV,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC3D,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC1D,CAAC,CAAC;gBAEH,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,0BAA0B,CACjC,KAAiC,EACjC,SAAsB;IAEtB,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,gBAAgB,GAAG,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;IAElD,IAAI,KAAK,GAAyB,IAAI,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI;YAAE,SAAS;QACpD,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,KAAK,gBAAgB;YAAE,SAAS;QAC7D,IAAI,SAAS,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACxC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,OAAO;gBAAE,SAAS;QAC5D,CAAC;aAAM,CAAC;YACN,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,KAAK,SAAS,CAAC,MAAM;gBAAE,SAAS;QAC9D,CAAC;QACD,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,CAAC,uBAAuB;QACxD,KAAK,GAAG,IAAI,CAAC;IACf,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,SAAS,oBAAoB,CAAC,CAAmB;IAC/C,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QAChC,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,MAAM,EAAE,CAAC,CAAC,MAAM;SACjB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM;KACjB,CAAC;AACJ,CAAC"}

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;