@opensip-cli/targeting 0.1.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,8 @@
+OpenSIP CLI
+Copyright 2026 opensip-ai
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this software except in compliance with the License. A copy of the License is
+included in the LICENSE file and is also available at:
+
+    http://www.apache.org/licenses/LICENSE-2.0

package/README.md

@@ -0,0 +1,31 @@
+<!-- Generated by scripts/build-package-readmes.mjs — do not edit by hand.
+     Change the package's "description" (or the generator template) and run
+     `pnpm docs:readmes`. CI enforces sync via `pnpm docs:readmes:check`. -->
+
+# @opensip-cli/targeting
+
+> Host file-targeting runtime substrate for OpenSIP CLI — the generic TargetRegistry, uniform glob expansion (resolveTargets/preResolveAllTargets), and globalExcludes filtering any tool consumes via scope.targets
+
+This is an **internal library** of the opensip-cli toolkit. It is published so the CLI and tools can depend on it; most users will not install it directly.
+
+Part of [**opensip-cli**](https://github.com/opensip-ai/opensip-cli) — an open-source codebase-analysis toolkit: fitness checks (`fit`), static call-graph analysis (`graph`), and simulation (`sim`).
+
+## Install
+
+Most users install the CLI, which bundles the first-party tools:
+
+```bash
+curl -fsSL https://opensip.ai/cli/install.sh | bash
+```
+
+This package is published for the CLI and advanced plugin authors; most users should not install `@opensip-cli/targeting` directly.
+
+## Documentation
+
+- 📚 Project docs: https://opensip.ai/docs/opensip-cli/
+- 🧭 Package catalog (what every package does): https://github.com/opensip-ai/opensip-cli/blob/v0.1.0/docs/public/70-reference/02-package-catalog.md
+- 📦 Source: https://github.com/opensip-ai/opensip-cli/tree/v0.1.0/packages/targeting
+
+## License
+
+Apache-2.0 © opensip-ai

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { TargetRegistry } from './target-registry.js';
+export { resolveTargets, preResolveAllTargets, applyGlobalExcludes } from './resolve.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { TargetRegistry } from './target-registry.js';
+export { resolveTargets, preResolveAllTargets, applyGlobalExcludes } from './resolve.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/resolve.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @fileoverview Uniform target glob expansion (host substrate)
+ *
+ * The generic glob mechanics any tool consumes via `scope.targets` (ADR-0037):
+ * expand a target's `include` globs to absolute paths, then apply per-target
+ * `exclude` AND the project `globalExcludes` uniformly, dedup + sort.
+ *
+ * There is ONE resolution path. The historical fitness `resolveTargetFiles`
+ * (which omitted `globalExcludes`) is gone — both excludes always apply.
+ */
+import type { TargetRegistry } from './target-registry.js';
+import type { Target } from '@opensip-cli/config';
+/**
+ * Filter a file list against the project `globalExcludes` globs (rootDir-relative,
+ * `dot: true`). A no-op when there are no excludes.
+ */
+export declare function applyGlobalExcludes(files: readonly string[], rootDir: string, globalExcludes: readonly string[]): readonly string[];
+/**
+ * Resolve a set of targets to a deduplicated, sorted list of absolute file
+ * paths. Expands each target's `include` globs, then filters out per-target
+ * `exclude` AND the project `globalExcludes` uniformly.
+ *
+ * This is the single resolution path that replaces the dead `resolveTargetFiles`
+ * (which omitted `globalExcludes`) and the single-check `resolveTargetGlobs`
+ * fallback — both excludes always apply.
+ *
+ * @param targets - Targets to resolve
+ * @param rootDir - Project root for glob resolution
+ * @param globalExcludes - Project-wide exclusion globs, applied to every target
+ * @returns Sorted, deduplicated array of absolute file paths
+ */
+export declare function resolveTargets(targets: readonly Target[], rootDir: string, globalExcludes: readonly string[]): readonly string[];
+/**
+ * Collect all unique glob patterns from every registered target, run a single
+ * deduplicated glob pass, then partition results per target — applying both
+ * per-target `exclude` and the project `globalExcludes` so that downstream
+ * per-unit lookups are pure in-memory.
+ *
+ * This avoids redundant filesystem traversals when targets share common
+ * patterns (e.g. multiple targets sharing the same `packages` source glob).
+ *
+ * @param registry - The target registry to expand
+ * @param globalExcludes - Project-wide exclusion globs, applied to every target
+ * @param rootDir - Project root for glob resolution
+ * @returns Map of target name → sorted, deduplicated absolute file paths
+ */
+export declare function preResolveAllTargets(registry: TargetRegistry, globalExcludes: readonly string[], rootDir: string): Map<string, readonly string[]>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AASlD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,SAAS,MAAM,EAAE,GAChC,SAAS,MAAM,EAAE,CAUnB;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,SAAS,MAAM,EAAE,GAChC,SAAS,MAAM,EAAE,CAkCnB;AA8DD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,cAAc,EACxB,cAAc,EAAE,SAAS,MAAM,EAAE,EACjC,OAAO,EAAE,MAAM,GACd,GAAG,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAiDhC"}

package/dist/resolve.js

@@ -0,0 +1,177 @@
+// @fitness-ignore-file batch-operation-limits -- iterates bounded collections (config entries, registry items, or small analysis results)
+/**
+ * @fileoverview Uniform target glob expansion (host substrate)
+ *
+ * The generic glob mechanics any tool consumes via `scope.targets` (ADR-0037):
+ * expand a target's `include` globs to absolute paths, then apply per-target
+ * `exclude` AND the project `globalExcludes` uniformly, dedup + sort.
+ *
+ * There is ONE resolution path. The historical fitness `resolveTargetFiles`
+ * (which omitted `globalExcludes`) is gone — both excludes always apply.
+ */
+import { relative, resolve } from 'node:path';
+import { isPathInside } from '@opensip-cli/core';
+import { globSync } from 'glob';
+import { minimatch, Minimatch } from 'minimatch';
+// Common infrastructure dirs are always ignored to prevent expensive traversals.
+const COMMON_IGNORE = ['**/node_modules/**', '**/dist/**', '**/.git/**'];
+// =============================================================================
+// Global excludes
+// =============================================================================
+/**
+ * Filter a file list against the project `globalExcludes` globs (rootDir-relative,
+ * `dot: true`). A no-op when there are no excludes.
+ */
+export function applyGlobalExcludes(files, rootDir, globalExcludes) {
+    return files.filter((filePath) => {
+        // Hard guard: anything not inside the project root after realpath resolution
+        // is never returned, regardless of globalExcludes patterns. This closes
+        // symlink / ../include / absolute-outside escape vectors.
+        if (!isPathInside(filePath, rootDir))
+            return false;
+        if (globalExcludes.length === 0)
+            return true;
+        const relativePath = relative(rootDir, filePath);
+        return !globalExcludes.some((pattern) => minimatch(relativePath, pattern, { dot: true }));
+    });
+}
+// =============================================================================
+// Single-pass resolver (the ONE public resolveTargets)
+// =============================================================================
+/**
+ * Resolve a set of targets to a deduplicated, sorted list of absolute file
+ * paths. Expands each target's `include` globs, then filters out per-target
+ * `exclude` AND the project `globalExcludes` uniformly.
+ *
+ * This is the single resolution path that replaces the dead `resolveTargetFiles`
+ * (which omitted `globalExcludes`) and the single-check `resolveTargetGlobs`
+ * fallback — both excludes always apply.
+ *
+ * @param targets - Targets to resolve
+ * @param rootDir - Project root for glob resolution
+ * @param globalExcludes - Project-wide exclusion globs, applied to every target
+ * @returns Sorted, deduplicated array of absolute file paths
+ */
+export function resolveTargets(targets, rootDir, globalExcludes) {
+    const files = new Set();
+    // Pre-compile globals once for the whole call (mirrors preResolveAllTargets).
+    const compiledGlobalExcludes = globalExcludes.map((pattern) => new Minimatch(pattern, { dot: true }));
+    for (const target of targets) {
+        const { include, exclude } = target.config;
+        for (const pattern of include) {
+            const matches = globSync(pattern, {
+                cwd: rootDir,
+                absolute: true,
+                nodir: true,
+                ignore: [...COMMON_IGNORE, ...exclude],
+            });
+            // Use the *exact same* post-glob filter as the pre-resolve assemble path
+            // (inside-root + target exclude + globalExcludes, dedup+sort) to guarantee
+            // identical output sets for equivalent inputs.
+            const filtered = filterOneTargetFiles(matches.map((m) => resolve(m)), exclude, compiledGlobalExcludes, rootDir);
+            for (const f of filtered)
+                files.add(f);
+        }
+    }
+    // applyGlobalExcludes is still used by the legacy direct-file-cache fallback
+    // paths and external callers; keep it, but the per-target results above have
+    // already folded globals for the main resolveTargets contract.
+    return [...files].sort();
+}
+// =============================================================================
+// Shared post-glob filtering (used by both resolve paths for exact parity)
+// =============================================================================
+/**
+ * Filter a raw list of (already inside-root) absolute paths for one target:
+ * - apply the target's own `exclude` globs
+ * - apply the project `globalExcludes`
+ * - dedup + sort
+ *
+ * This helper is the single source of truth for "after glob, apply this target's
+ * exclude + globals" so that the single-pass `resolveTargets` and the
+ * optimized `preResolveAllTargets` (which does a cross-target deduped glob then
+ * per-target re-filter) produce byte-identical results for the same inputs.
+ */
+function filterOneTargetFiles(rawMatches, targetExclude, compiledGlobalExcludes, rootDir) {
+    const files = new Set();
+    for (const m of rawMatches) {
+        if (isPathInside(m, rootDir))
+            files.add(m);
+    }
+    const hasTargetExcludes = targetExclude.length > 0;
+    const hasGlobals = compiledGlobalExcludes.length > 0;
+    if (hasTargetExcludes || hasGlobals) {
+        const compiledTargetExcludes = hasTargetExcludes
+            ? targetExclude.map((ex) => new Minimatch(ex, { dot: true }))
+            : [];
+        const allExcludes = [...compiledTargetExcludes, ...compiledGlobalExcludes];
+        return [...files]
+            .filter((filePath) => !allExcludes.some((m) => m.match(relative(rootDir, filePath))))
+            .sort();
+    }
+    return [...files].sort();
+}
+/** Assemble a single target's file list from pre-resolved pattern results, applying excludes. */
+function assembleTargetFiles(targetConfig, patternResults, compiledGlobalExcludes, rootDir) {
+    // Collect raw matches for this target's includes (the shared glob may have
+    // over-collected for shared patterns; we filter precisely here).
+    const raw = [];
+    for (const pattern of targetConfig.include) {
+        const matches = patternResults.get(pattern) ?? [];
+        raw.push(...matches);
+    }
+    return filterOneTargetFiles(raw, targetConfig.exclude, compiledGlobalExcludes, rootDir);
+}
+/**
+ * Collect all unique glob patterns from every registered target, run a single
+ * deduplicated glob pass, then partition results per target — applying both
+ * per-target `exclude` and the project `globalExcludes` so that downstream
+ * per-unit lookups are pure in-memory.
+ *
+ * This avoids redundant filesystem traversals when targets share common
+ * patterns (e.g. multiple targets sharing the same `packages` source glob).
+ *
+ * @param registry - The target registry to expand
+ * @param globalExcludes - Project-wide exclusion globs, applied to every target
+ * @param rootDir - Project root for glob resolution
+ * @returns Map of target name → sorted, deduplicated absolute file paths
+ */
+export function preResolveAllTargets(registry, globalExcludes, rootDir) {
+    const targets = registry.getAll();
+    if (targets.length === 0)
+        return new Map();
+    // Collect all unique include patterns across targets
+    const allPatterns = new Set();
+    for (const target of targets) {
+        for (const pattern of target.config.include) {
+            allPatterns.add(pattern);
+        }
+    }
+    // Single glob pass for each unique pattern — deduplicated across targets.
+    const patternResults = new Map();
+    for (const pattern of allPatterns) {
+        const matches = globSync(pattern, {
+            cwd: rootDir,
+            absolute: true,
+            nodir: true,
+            ignore: COMMON_IGNORE,
+        });
+        patternResults.set(pattern, matches.map((m) => resolve(m)));
+    }
+    // Pre-compile globalExcludes matchers for reuse across all targets
+    const compiledExcludes = globalExcludes.map((pattern) => new Minimatch(pattern, { dot: true }));
+    // Assemble per-target file lists by combining pattern results and filtering excludes.
+    // Both target-specific excludes AND globalExcludes are applied here so that
+    // per-unit resolution is a pure in-memory lookup with no minimatch calls.
+    const result = new Map();
+    for (const target of targets) {
+        const files = assembleTargetFiles({
+            include: target.config.include,
+            exclude: target.config.exclude,
+            name: target.config.name,
+        }, patternResults, compiledExcludes, rootDir);
+        result.set(target.config.name, files);
+    }
+    return result;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

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

package/dist/target-registry.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview Target Registry (host substrate)
+ *
+ * Registry for target definitions. Provides lookup by name and tags.
+ *
+ * Built on the kernel's unified `Registry<T>` with `silent-skip` —
+ * registering a target with a name that's already taken is a no-op
+ * (the historical behaviour).
+ *
+ * The entire targets module uses a synchronous API because target definitions
+ * are loaded once at startup from a small YAML config file and then held
+ * in-memory for fast, repeated lookups throughout the process lifetime. The
+ * resolver (resolve.ts) similarly uses synchronous glob expansion. Since the
+ * data set is small and bounded by project configuration, async I/O offers no
+ * practical benefit and would complicate every call site that queries targets.
+ *
+ * This is the **generic** half of file targeting (ADR-0037): register/get/byTag
+ * over the host-owned `Target` shape. The scope-matching `findByScope`
+ * (languages + concerns) stays in `@opensip-cli/fitness` — `concerns` is a
+ * check-scope concept, so the substrate carries no language-canonicalizing path
+ * and never reads the run scope.
+ */
+import type { Target } from '@opensip-cli/config';
+/** Registry for target definitions with lookup by name and tags. */
+export declare class TargetRegistry {
+    private readonly inner;
+    /**
+     * Register a target. Silently skips if a target with the same name already exists.
+     * @param target - Target definition to register
+     * @returns This registry instance for chaining
+     */
+    register(target: Target): this;
+    /**
+     * Look up a target by its config name.
+     * @param name - Target name to find
+     * @returns The matching target, or undefined if not found
+     */
+    getByName(name: string): Target | undefined;
+    /** Return all registered targets. */
+    getAll(): readonly Target[];
+    /**
+     * Return all targets that include the given tag.
+     * @param tag - Tag string to filter by
+     * @returns Targets whose config.tags contain the tag
+     */
+    getByTag(tag: string): readonly Target[];
+    /**
+     * Check whether a target with the given name is registered.
+     * @param name - Target name to check
+     * @returns True if the target exists in the registry
+     */
+    has(name: string): boolean;
+    /** Number of registered targets. */
+    get size(): number;
+    /** Remove all targets from the registry. */
+    clear(): void;
+}
+//# sourceMappingURL=target-registry.d.ts.map

package/dist/target-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-registry.d.ts","sourceRoot":"","sources":["../src/target-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AASlD,oEAAoE;AACpE,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAInB;IAEH;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAW9B;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI3C,qCAAqC;IACrC,MAAM,IAAI,SAAS,MAAM,EAAE;IAI3B;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE;IAIxC;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,oCAAoC;IACpC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,4CAA4C;IAC5C,KAAK,IAAI,IAAI;CAGd"}

package/dist/target-registry.js

@@ -0,0 +1,83 @@
+/**
+ * @fileoverview Target Registry (host substrate)
+ *
+ * Registry for target definitions. Provides lookup by name and tags.
+ *
+ * Built on the kernel's unified `Registry<T>` with `silent-skip` —
+ * registering a target with a name that's already taken is a no-op
+ * (the historical behaviour).
+ *
+ * The entire targets module uses a synchronous API because target definitions
+ * are loaded once at startup from a small YAML config file and then held
+ * in-memory for fast, repeated lookups throughout the process lifetime. The
+ * resolver (resolve.ts) similarly uses synchronous glob expansion. Since the
+ * data set is small and bounded by project configuration, async I/O offers no
+ * practical benefit and would complicate every call site that queries targets.
+ *
+ * This is the **generic** half of file targeting (ADR-0037): register/get/byTag
+ * over the host-owned `Target` shape. The scope-matching `findByScope`
+ * (languages + concerns) stays in `@opensip-cli/fitness` — `concerns` is a
+ * check-scope concept, so the substrate carries no language-canonicalizing path
+ * and never reads the run scope.
+ */
+import { Registry } from '@opensip-cli/core';
+/** Registry for target definitions with lookup by name and tags. */
+export class TargetRegistry {
+    inner = new Registry({
+        module: 'targeting',
+        duplicatePolicy: 'silent-skip',
+        evtPrefix: 'target.registry',
+    });
+    /**
+     * Register a target. Silently skips if a target with the same name already exists.
+     * @param target - Target definition to register
+     * @returns This registry instance for chaining
+     */
+    register(target) {
+        const name = target.config.name;
+        this.inner.register({
+            id: name,
+            name,
+            target,
+            tags: target.config.tags,
+        });
+        return this;
+    }
+    /**
+     * Look up a target by its config name.
+     * @param name - Target name to find
+     * @returns The matching target, or undefined if not found
+     */
+    getByName(name) {
+        return this.inner.getById(name)?.target;
+    }
+    /** Return all registered targets. */
+    getAll() {
+        return this.inner.getAll().map((r) => r.target);
+    }
+    /**
+     * Return all targets that include the given tag.
+     * @param tag - Tag string to filter by
+     * @returns Targets whose config.tags contain the tag
+     */
+    getByTag(tag) {
+        return this.inner.getByTag(tag).map((r) => r.target);
+    }
+    /**
+     * Check whether a target with the given name is registered.
+     * @param name - Target name to check
+     * @returns True if the target exists in the registry
+     */
+    has(name) {
+        return this.inner.has(name);
+    }
+    /** Number of registered targets. */
+    get size() {
+        return this.inner.size;
+    }
+    /** Remove all targets from the registry. */
+    clear() {
+        this.inner.clear();
+    }
+}
+//# sourceMappingURL=target-registry.js.map

package/dist/target-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-registry.js","sourceRoot":"","sources":["../src/target-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,QAAQ,EAAqB,MAAM,mBAAmB,CAAC;AAWhE,oEAAoE;AACpE,MAAM,OAAO,cAAc;IACR,KAAK,GAAG,IAAI,QAAQ,CAAqB;QACxD,MAAM,EAAE,WAAW;QACnB,eAAe,EAAE,aAAa;QAC9B,SAAS,EAAE,iBAAiB;KAC7B,CAAC,CAAC;IAEH;;;;OAIG;IACH,QAAQ,CAAC,MAAc;QACrB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YAClB,EAAE,EAAE,IAAI;YACR,IAAI;YACJ,MAAM;YACN,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI;SACzB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAC1C,CAAC;IAED,qCAAqC;IACrC,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,GAAW;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,oCAAoC;IACpC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,4CAA4C;IAC5C,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@opensip-cli/targeting",
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "description": "Host file-targeting runtime substrate for OpenSIP CLI — the generic TargetRegistry, uniform glob expansion (resolveTargets/preResolveAllTargets), and globalExcludes filtering any tool consumes via scope.targets",
+  "keywords": [
+    "opensip-cli",
+    "static-analysis",
+    "code-quality"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/opensip-ai/opensip-cli.git",
+    "directory": "packages/targeting"
+  },
+  "homepage": "https://github.com/opensip-ai/opensip-cli",
+  "bugs": {
+    "url": "https://github.com/opensip-ai/opensip-cli/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "dependencies": {
+    "glob": "^13.0.0",
+    "minimatch": "^10.2.5",
+    "@opensip-cli/config": "0.1.0",
+    "@opensip-cli/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.2",
+    "typescript": "~6.0.3",
+    "vitest": "^4.1.8"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}