@agentxm/client-core 0.1.6

package/dist/src/unstable/packaging/cpan.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CPAN (Perl) package detector and reader for package-compatibility discovery.
+ *
+ * Parses `cpanfile` (`requires 'Name'` lines) and `Makefile.PL` (`PREREQ_PM`).
+ * Reads `x_axm` from `<lib-path>/.meta/<dist>/MYMETA.json`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { PackageDetector, PackageReader } from "./types.js";
+/**
+ * CPAN package detector.
+ *
+ * Scans `cpanfile` and `Makefile.PL` in the project directory and extracts
+ * dependencies.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const cpanDetector: PackageDetector;
+/**
+ * CPAN package reader.
+ *
+ * Reads `x_axm` from `<lib-path>/.meta/<dist>/MYMETA.json` for each
+ * detected CPAN package and extracts recommendation metadata.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const cpanReader: PackageReader;
+//# sourceMappingURL=cpan.d.ts.map

package/dist/src/unstable/packaging/cpan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpan.d.ts","sourceRoot":"","sources":["../../../../src/unstable/packaging/cpan.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,OAAO,KAAK,EAAmB,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA0IlF;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,EAAE,eAoC1B,CAAC;AAYF;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,EAAE,aAwCxB,CAAC"}

package/dist/src/unstable/packaging/cpan.js

@@ -0,0 +1,214 @@
+/**
+ * CPAN (Perl) package detector and reader for package-compatibility discovery.
+ *
+ * Parses `cpanfile` (`requires 'Name'` lines) and `Makefile.PL` (`PREREQ_PM`).
+ * Reads `x_axm` from `<lib-path>/.meta/<dist>/MYMETA.json`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import { AxmPackageMetaSchema } from "./axm-package-meta.js";
+import { PackageTypeSchema } from "./package-type.js";
+// eslint-disable-next-line no-restricted-properties -- Centralized env var access for packaging detectors
+const readEnv = (name) => process.env[name];
+const cpanType = Schema.decodeUnknownSync(PackageTypeSchema)("cpan");
+const decodeAxmMeta = Schema.decodeUnknownResult(AxmPackageMetaSchema);
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Read a file as string, returning Option.none for NotFound and other errors.
+ */
+const readFileOptional = (filePath) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const content = yield* fs.readFileString(filePath).pipe(Effect.option);
+    return content;
+});
+/**
+ * Parse JSON string, returning Option.none and logging a warning on failure.
+ */
+const parseJsonOptional = (content, context) => Effect.gen(function* () {
+    const result = yield* Effect.try({
+        try: () => JSON.parse(content),
+        catch: () => ({ _tag: "JsonParseError" }),
+    }).pipe(Effect.option);
+    if (Option.isNone(result)) {
+        yield* Effect.logWarning(`Malformed JSON in ${context}, skipping`);
+        return Option.none();
+    }
+    return Option.some(result.value);
+});
+/**
+ * Convert a Perl module name to a CPAN distribution-style name.
+ * Module names use :: as separator (e.g., Moose::Util),
+ * distribution names use - (e.g., Moose-Util).
+ */
+const moduleToDistName = (moduleName) => moduleName.replace(/::/g, "-");
+/**
+ * Parse a `cpanfile` and extract dependencies.
+ * Format: requires 'Module::Name', 'version';
+ *         requires 'Module::Name';
+ */
+const parseCpanfile = (content, source) => {
+    const results = [];
+    const seenNames = new Set();
+    // Match: requires 'Name' or requires 'Name', 'version'
+    // Also: requires "Name" or requires "Name", "version"
+    const requiresRegex = /requires\s+['"]([^'"]+)['"]\s*(?:,\s*['"]([^'"]*)['"]\s*)?;/g;
+    let match;
+    while ((match = requiresRegex.exec(content)) !== null) {
+        const moduleName = match[1];
+        if (moduleName === undefined)
+            continue;
+        const name = moduleToDistName(moduleName);
+        if (seenNames.has(name))
+            continue;
+        seenNames.add(name);
+        const versionSpec = match[2]?.trim();
+        // Only exact versions (no ranges)
+        const version = versionSpec !== undefined && /^\d+(?:\.\d+)*$/.test(versionSpec) ? versionSpec : undefined;
+        results.push({
+            purl: {
+                type: cpanType,
+                name,
+                ...(version !== undefined ? { version } : {}),
+            },
+            type: cpanType,
+            source,
+        });
+    }
+    return results;
+};
+/**
+ * Parse `Makefile.PL` and extract dependencies from PREREQ_PM.
+ * Format: PREREQ_PM => { 'Module::Name' => 'version', ... }
+ */
+const parseMakefilePL = (content, source) => {
+    const results = [];
+    const seenNames = new Set();
+    // Match PREREQ_PM => { ... } block
+    const prereqMatch = /PREREQ_PM\s*=>\s*\{([^}]*)}/s.exec(content);
+    if (!prereqMatch)
+        return [];
+    const block = prereqMatch[1] ?? "";
+    // Match 'Module::Name' => 'version' or "Module::Name" => "version"
+    const entryRegex = /['"]([^'"]+)['"]\s*=>\s*['"]?([^'",}]*?)['"]?\s*(?:,|$)/g;
+    let match;
+    while ((match = entryRegex.exec(block)) !== null) {
+        const moduleName = match[1];
+        if (moduleName === undefined)
+            continue;
+        const name = moduleToDistName(moduleName);
+        if (seenNames.has(name))
+            continue;
+        seenNames.add(name);
+        const versionSpec = match[2]?.trim();
+        const version = versionSpec !== undefined && versionSpec !== "" && /^\d+(?:\.\d+)*$/.test(versionSpec)
+            ? versionSpec
+            : undefined;
+        results.push({
+            purl: {
+                type: cpanType,
+                name,
+                ...(version !== undefined ? { version } : {}),
+            },
+            type: cpanType,
+            source,
+        });
+    }
+    return results;
+};
+// ---------------------------------------------------------------------------
+// Detector
+// ---------------------------------------------------------------------------
+/**
+ * CPAN package detector.
+ *
+ * Scans `cpanfile` and `Makefile.PL` in the project directory and extracts
+ * dependencies.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const cpanDetector = {
+    type: cpanType,
+    detect: Effect.fn("detect.cpan")(function* (projectDir) {
+        const path = yield* Path.Path;
+        const allPackages = [];
+        const seenNames = new Set();
+        const addUnique = (pkgs) => {
+            for (const pkg of pkgs) {
+                if (!seenNames.has(pkg.purl.name)) {
+                    seenNames.add(pkg.purl.name);
+                    allPackages.push(pkg);
+                }
+            }
+        };
+        // 1. cpanfile
+        const cpanfilePath = path.join(projectDir, "cpanfile");
+        const cpanfileContent = yield* readFileOptional(cpanfilePath);
+        if (Option.isSome(cpanfileContent)) {
+            addUnique(parseCpanfile(cpanfileContent.value, cpanfilePath));
+        }
+        // 2. Makefile.PL
+        const makefilePath = path.join(projectDir, "Makefile.PL");
+        const makefileContent = yield* readFileOptional(makefilePath);
+        if (Option.isSome(makefileContent)) {
+            addUnique(parseMakefilePL(makefileContent.value, makefilePath));
+        }
+        return allPackages;
+    }, Effect.annotateLogs({ detector: "cpan" }), Effect.withSpan("detect.cpan")),
+};
+// ---------------------------------------------------------------------------
+// Reader
+// ---------------------------------------------------------------------------
+/** Schema for extracting the x_axm field from MYMETA.json. */
+const MymetaAxmSchema = Schema.Struct({
+    x_axm: Schema.optional(Schema.Unknown),
+});
+const decodeMymetaAxm = Schema.decodeUnknownResult(MymetaAxmSchema);
+/**
+ * CPAN package reader.
+ *
+ * Reads `x_axm` from `<lib-path>/.meta/<dist>/MYMETA.json` for each
+ * detected CPAN package and extracts recommendation metadata.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const cpanReader = {
+    type: cpanType,
+    read: Effect.fn("read.cpan")(function* (pkg) {
+        const path = yield* Path.Path;
+        // Default Perl local::lib path
+        const libPath = yield* Effect.sync(() => readEnv("PERL5LIB") ?? readEnv("PERL_LOCAL_LIB_ROOT") ?? "local/lib/perl5");
+        const distName = pkg.purl.name;
+        const version = pkg.purl.version;
+        const metaDir = version !== undefined ? `${distName}-${version}` : distName;
+        const mymetaPath = path.join(libPath, ".meta", metaDir, "MYMETA.json");
+        const content = yield* readFileOptional(mymetaPath);
+        if (Option.isNone(content))
+            return Option.none();
+        const parsed = yield* parseJsonOptional(content.value, `${distName}/MYMETA.json`);
+        if (Option.isNone(parsed))
+            return Option.none();
+        // Extract x_axm metadata
+        const containerResult = decodeMymetaAxm(parsed.value);
+        if (Result.isFailure(containerResult))
+            return Option.none();
+        const axmRaw = containerResult.success.x_axm;
+        if (axmRaw === undefined)
+            return Option.none();
+        const metaResult = decodeAxmMeta(axmRaw);
+        if (Result.isFailure(metaResult)) {
+            yield* Effect.logWarning(`Invalid axm metadata in ${distName}: schema validation failed`);
+            return Option.none();
+        }
+        return Option.some(metaResult.success.recommendedExtensions);
+    }, Effect.annotateLogs({ reader: "cpan" }), Effect.withSpan("read.cpan")),
+};
+//# sourceMappingURL=cpan.js.map

package/dist/src/unstable/packaging/cpan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpan.js","sourceRoot":"","sources":["../../../../src/unstable/packaging/cpan.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,0GAA0G;AAC1G,MAAM,OAAO,GAAG,CAAC,IAAY,EAAsB,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAExE,MAAM,QAAQ,GAAG,MAAM,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AACrE,MAAM,aAAa,GAAG,MAAM,CAAC,mBAAmB,CAAC,oBAAoB,CAAC,CAAC;AAEvE,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;GAEG;AACH,MAAM,gBAAgB,GAAG,CAAC,QAAgB,EAAE,EAAE,CAC5C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACvE,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC,CAAC;AAEL;;GAEG;AACH,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAE,OAAe,EAAE,EAAE,CAC7D,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAC/B,GAAG,EAAE,GAAY,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACvC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAyB,EAAE,CAAC;KACnD,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEvB,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,qBAAqB,OAAO,YAAY,CAAC,CAAC;QACnE,OAAO,MAAM,CAAC,IAAI,EAAW,CAAC;IAChC,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC;AAEL;;;;GAIG;AACH,MAAM,gBAAgB,GAAG,CAAC,UAAkB,EAAU,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAExF;;;;GAIG;AACH,MAAM,aAAa,GAAG,CAAC,OAAe,EAAE,MAAc,EAAkC,EAAE;IACxF,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAEpC,uDAAuD;IACvD,sDAAsD;IACtD,MAAM,aAAa,GAAG,8DAA8D,CAAC;IACrF,IAAI,KAA6B,CAAC;IAElC,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACtD,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,UAAU,KAAK,SAAS;YAAE,SAAS;QAEvC,MAAM,IAAI,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC1C,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAClC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEpB,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACrC,kCAAkC;QAClC,MAAM,OAAO,GACX,WAAW,KAAK,SAAS,IAAI,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;QAE7F,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI;gBACJ,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9C;YACD,IAAI,EAAE,QAAQ;YACd,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,eAAe,GAAG,CAAC,OAAe,EAAE,MAAc,EAAkC,EAAE;IAC1F,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAEpC,mCAAmC;IACnC,MAAM,WAAW,GAAG,8BAA8B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjE,IAAI,CAAC,WAAW;QAAE,OAAO,EAAE,CAAC;IAE5B,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEnC,mEAAmE;IACnE,MAAM,UAAU,GAAG,0DAA0D,CAAC;IAC9E,IAAI,KAA6B,CAAC;IAElC,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACjD,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,UAAU,KAAK,SAAS;YAAE,SAAS;QAEvC,MAAM,IAAI,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC1C,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAClC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEpB,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACrC,MAAM,OAAO,GACX,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,EAAE,IAAI,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC;YACpF,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,SAAS,CAAC;QAEhB,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI;gBACJ,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9C;YACD,IAAI,EAAE,QAAQ;YACd,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAoB;IAC3C,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,aAAa,CAAC,CAC9B,QAAQ,CAAC,EAAE,UAAkB;QAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9B,MAAM,WAAW,GAA2B,EAAE,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QAEpC,MAAM,SAAS,GAAG,CAAC,IAAoC,EAAE,EAAE;YACzD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBAClC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC7B,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QAEF,cAAc;QACd,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACvD,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;QAC9D,IAAI,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;YACnC,SAAS,CAAC,aAAa,CAAC,eAAe,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC;QAChE,CAAC;QAED,iBAAiB;QACjB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QAC1D,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;QAC9D,IAAI,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;YACnC,SAAS,CAAC,eAAe,CAAC,eAAe,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC;QAClE,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC,EACD,MAAM,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EACzC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAC/B;CACF,CAAC;AAEF,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,8DAA8D;AAC9D,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;CACvC,CAAC,CAAC;AACH,MAAM,eAAe,GAAG,MAAM,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC;AAEpE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAkB;IACvC,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,WAAW,CAAC,CAC1B,QAAQ,CAAC,EAAE,GAAoB;QAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAE9B,+BAA+B;QAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAChC,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,qBAAqB,CAAC,IAAI,iBAAiB,CACjF,CAAC;QAEF,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;QAC/B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;QACjC,MAAM,OAAO,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC5E,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;QAEvE,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;YAAE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QAEjD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,QAAQ,cAAc,CAAC,CAAC;QAClF,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QAEhD,yBAAyB;QACzB,MAAM,eAAe,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtD,IAAI,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC;YAAE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QAE5D,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC;QAC7C,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QAE/C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;YACjC,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,2BAA2B,QAAQ,4BAA4B,CAAC,CAAC;YAC1F,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC/D,CAAC,EACD,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EACvC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAC7B;CACF,CAAC"}

package/dist/src/unstable/packaging/cran.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CRAN (R) package detector and reader for package-compatibility discovery.
+ *
+ * Parses `DESCRIPTION` files for `Depends`, `Imports`, and `Suggests` fields.
+ * Reads `Config/axm` prefixed fields from installed package DESCRIPTION files.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { PackageDetector, PackageReader } from "./types.js";
+/**
+ * CRAN package detector.
+ *
+ * Scans `DESCRIPTION` file in the project directory and extracts dependencies
+ * from `Depends`, `Imports`, and `Suggests` fields.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const cranDetector: PackageDetector;
+/**
+ * CRAN package reader.
+ *
+ * Reads `Config/axm` prefixed fields from `<lib-path>/<pkg>/DESCRIPTION`
+ * for each detected CRAN package and extracts recommendation metadata.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const cranReader: PackageReader;
+//# sourceMappingURL=cran.d.ts.map

package/dist/src/unstable/packaging/cran.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cran.d.ts","sourceRoot":"","sources":["../../../../src/unstable/packaging/cran.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAeH,OAAO,KAAK,EAAmB,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAgGlF;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,EAAE,eAoC1B,CAAC;AAaF;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,EAAE,aA0CxB,CAAC"}

package/dist/src/unstable/packaging/cran.js

@@ -0,0 +1,187 @@
+/**
+ * CRAN (R) package detector and reader for package-compatibility discovery.
+ *
+ * Parses `DESCRIPTION` files for `Depends`, `Imports`, and `Suggests` fields.
+ * Reads `Config/axm` prefixed fields from installed package DESCRIPTION files.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+// Intentional escape hatch: node:os homedir() has no @effect/platform equivalent.
+import * as os from "node:os";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import { AxmPackageMetaSchema } from "./axm-package-meta.js";
+import { PackageTypeSchema } from "./package-type.js";
+// eslint-disable-next-line no-restricted-properties -- Centralized env var access for packaging detectors
+const readEnv = (name) => process.env[name];
+const cranType = Schema.decodeUnknownSync(PackageTypeSchema)("cran");
+const decodeAxmMeta = Schema.decodeUnknownResult(AxmPackageMetaSchema);
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Read a file as string, returning Option.none for NotFound and other errors.
+ */
+const readFileOptional = (filePath) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const content = yield* fs.readFileString(filePath).pipe(Effect.option);
+    return content;
+});
+/**
+ * Parse a DESCRIPTION file into a key-value map.
+ * Handles continuation lines (lines starting with whitespace are appended
+ * to the previous field value).
+ */
+const parseDescriptionFile = (content) => {
+    const result = {};
+    let currentKey;
+    for (const line of content.split("\n")) {
+        // Continuation line: starts with whitespace
+        if (/^\s/.test(line) && currentKey !== undefined) {
+            const existing = result[currentKey];
+            if (existing !== undefined) {
+                result[currentKey] = existing + " " + line.trim();
+            }
+            continue;
+        }
+        // New field: Key: Value
+        const colonIdx = line.indexOf(":");
+        if (colonIdx > 0) {
+            currentKey = line.slice(0, colonIdx).trim();
+            result[currentKey] = line.slice(colonIdx + 1).trim();
+        }
+    }
+    return result;
+};
+/**
+ * Parse a comma-separated list of R package dependencies.
+ * Each entry is like "name (>= version)" or just "name".
+ * Filters out base R packages like "R" itself.
+ */
+const parseDependencyList = (value, source) => {
+    const results = [];
+    for (const entry of value.split(",")) {
+        const trimmed = entry.trim();
+        if (trimmed === "")
+            continue;
+        // Parse "name (>= version)" or "name"
+        const match = /^([A-Za-z][A-Za-z0-9.]*)(?:\s*\((.+)\))?$/.exec(trimmed);
+        if (!match)
+            continue;
+        const name = match[1];
+        if (name === undefined || name === "R")
+            continue;
+        // Only extract exact version constraints
+        const constraint = match[2]?.trim();
+        let version;
+        if (constraint !== undefined) {
+            const exactMatch = /^==\s*(.+)$/.exec(constraint);
+            if (exactMatch) {
+                version = exactMatch[1]?.trim();
+            }
+        }
+        results.push({
+            purl: {
+                type: cranType,
+                name,
+                ...(version !== undefined ? { version } : {}),
+            },
+            type: cranType,
+            source,
+        });
+    }
+    return results;
+};
+// ---------------------------------------------------------------------------
+// Detector
+// ---------------------------------------------------------------------------
+/**
+ * CRAN package detector.
+ *
+ * Scans `DESCRIPTION` file in the project directory and extracts dependencies
+ * from `Depends`, `Imports`, and `Suggests` fields.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const cranDetector = {
+    type: cranType,
+    detect: Effect.fn("detect.cran")(function* (projectDir) {
+        const path = yield* Path.Path;
+        const descriptionPath = path.join(projectDir, "DESCRIPTION");
+        const content = yield* readFileOptional(descriptionPath);
+        if (Option.isNone(content))
+            return [];
+        const fields = parseDescriptionFile(content.value);
+        const allPackages = [];
+        const seenNames = new Set();
+        const addUnique = (pkgs) => {
+            for (const pkg of pkgs) {
+                if (!seenNames.has(pkg.purl.name)) {
+                    seenNames.add(pkg.purl.name);
+                    allPackages.push(pkg);
+                }
+            }
+        };
+        // Extract from Depends, Imports, Suggests
+        for (const field of ["Depends", "Imports", "Suggests"]) {
+            const value = fields[field];
+            if (value !== undefined) {
+                addUnique(parseDependencyList(value, descriptionPath));
+            }
+        }
+        return allPackages;
+    }, Effect.annotateLogs({ detector: "cran" }), Effect.withSpan("detect.cran")),
+};
+// ---------------------------------------------------------------------------
+// Reader
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the R library path.
+ * Checks R_LIBS_USER, then defaults to ~/R/library.
+ */
+const resolveRLibPath = () => Effect.sync(() => readEnv("R_LIBS_USER") ?? `${os.homedir()}/R/library`);
+/**
+ * CRAN package reader.
+ *
+ * Reads `Config/axm` prefixed fields from `<lib-path>/<pkg>/DESCRIPTION`
+ * for each detected CRAN package and extracts recommendation metadata.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const cranReader = {
+    type: cranType,
+    read: Effect.fn("read.cran")(function* (pkg) {
+        const path = yield* Path.Path;
+        const libPath = yield* resolveRLibPath();
+        const descriptionPath = path.join(libPath, pkg.purl.name, "DESCRIPTION");
+        const content = yield* readFileOptional(descriptionPath);
+        if (Option.isNone(content))
+            return Option.none();
+        const fields = parseDescriptionFile(content.value);
+        // Look for Config/axm fields - the metadata is stored as JSON in Config/axm
+        const axmField = fields["Config/axm"];
+        if (axmField === undefined)
+            return Option.none();
+        // Parse the axm metadata JSON
+        const axmParsed = yield* Effect.try({
+            try: () => JSON.parse(axmField),
+            catch: () => ({ _tag: "JsonParseError" }),
+        }).pipe(Effect.option);
+        if (Option.isNone(axmParsed)) {
+            yield* Effect.logWarning(`Malformed Config/axm in ${pkg.purl.name}: invalid JSON`);
+            return Option.none();
+        }
+        const metaResult = decodeAxmMeta(axmParsed.value);
+        if (Result.isFailure(metaResult)) {
+            yield* Effect.logWarning(`Invalid axm metadata in ${pkg.purl.name}: schema validation failed`);
+            return Option.none();
+        }
+        return Option.some(metaResult.success.recommendedExtensions);
+    }, Effect.annotateLogs({ reader: "cran" }), Effect.withSpan("read.cran")),
+};
+//# sourceMappingURL=cran.js.map

package/dist/src/unstable/packaging/cran.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cran.js","sourceRoot":"","sources":["../../../../src/unstable/packaging/cran.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,kFAAkF;AAClF,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,0GAA0G;AAC1G,MAAM,OAAO,GAAG,CAAC,IAAY,EAAsB,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAGxE,MAAM,QAAQ,GAAG,MAAM,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AACrE,MAAM,aAAa,GAAG,MAAM,CAAC,mBAAmB,CAAC,oBAAoB,CAAC,CAAC;AAEvE,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;GAEG;AACH,MAAM,gBAAgB,GAAG,CAAC,QAAgB,EAAE,EAAE,CAC5C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IACxC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACvE,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC,CAAC;AAEL;;;;GAIG;AACH,MAAM,oBAAoB,GAAG,CAAC,OAAe,EAA0B,EAAE;IACvE,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,IAAI,UAA8B,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,4CAA4C;QAC5C,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;YACpC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,MAAM,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACpD,CAAC;YACD,SAAS;QACX,CAAC;QAED,wBAAwB;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5C,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACvD,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,mBAAmB,GAAG,CAAC,KAAa,EAAE,MAAc,EAAkC,EAAE;IAC5F,MAAM,OAAO,GAA2B,EAAE,CAAC;IAE3C,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,OAAO,KAAK,EAAE;YAAE,SAAS;QAE7B,sCAAsC;QACtC,MAAM,KAAK,GAAG,2CAA2C,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,IAAI,CAAC,KAAK;YAAE,SAAS;QAErB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,GAAG;YAAE,SAAS;QAEjD,yCAAyC;QACzC,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACpC,IAAI,OAA2B,CAAC;QAChC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAClD,IAAI,UAAU,EAAE,CAAC;gBACf,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;YAClC,CAAC;QACH,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI;gBACJ,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9C;YACD,IAAI,EAAE,QAAQ;YACd,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAoB;IAC3C,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,aAAa,CAAC,CAC9B,QAAQ,CAAC,EAAE,UAAkB;QAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9B,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QAE7D,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC;QACzD,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;YAAE,OAAO,EAAE,CAAC;QAEtC,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,WAAW,GAA2B,EAAE,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QAEpC,MAAM,SAAS,GAAG,CAAC,IAAoC,EAAE,EAAE;YACzD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBAClC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC7B,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QAEF,0CAA0C;QAC1C,KAAK,MAAM,KAAK,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAU,EAAE,CAAC;YAChE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,SAAS,CAAC,mBAAmB,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC,EACD,MAAM,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EACzC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAC/B;CACF,CAAC;AAEF,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,eAAe,GAAG,GAAG,EAAE,CAC3B,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AAE3E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAkB;IACvC,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,WAAW,CAAC,CAC1B,QAAQ,CAAC,EAAE,GAAoB;QAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,eAAe,EAAE,CAAC;QAEzC,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QAEzE,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC;QACzD,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;YAAE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QAEjD,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAEnD,4EAA4E;QAC5E,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;QACtC,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QAEjD,8BAA8B;QAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YAClC,GAAG,EAAE,GAAY,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YACxC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAyB,EAAE,CAAC;SACnD,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAEvB,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,2BAA2B,GAAG,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAC,CAAC;YACnF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;YACjC,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CACtB,2BAA2B,GAAG,CAAC,IAAI,CAAC,IAAI,4BAA4B,CACrE,CAAC;YACF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC/D,CAAC,EACD,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EACvC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAC7B;CACF,CAAC"}

package/dist/src/unstable/packaging/detect.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Detect orchestrator: runs all package detectors concurrently,
+ * flattens results, and deduplicates by purl equivalence.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import type { PackageDetector } from "./types.js";
+/**
+ * Run all detectors concurrently, flatten and deduplicate results.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const detectPackages: (projectDir: string, detectors: readonly PackageDetector[]) => Effect.Effect<import("./types.js").DetectedPackage[], never, import("effect/FileSystem").FileSystem | import("effect/Path").Path>;
+//# sourceMappingURL=detect.d.ts.map

package/dist/src/unstable/packaging/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../../src/unstable/packaging/detect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD;;;;GAIG;AACH,eAAO,MAAM,cAAc,kMASzB,CAAC"}

package/dist/src/unstable/packaging/detect.js

@@ -0,0 +1,25 @@
+/**
+ * Detect orchestrator: runs all package detectors concurrently,
+ * flattens results, and deduplicates by purl equivalence.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Array from "effect/Array";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { PackageUrlPartsSchema } from "./package-url.js";
+const purlEquivalence = Schema.toEquivalence(PackageUrlPartsSchema);
+/**
+ * Run all detectors concurrently, flatten and deduplicate results.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const detectPackages = Effect.fn("discover.detect")(function* (projectDir, detectors) {
+    const results = yield* Effect.forEach(detectors, (d) => d.detect(projectDir), {
+        concurrency: "unbounded",
+    });
+    const allDetected = Array.flatten(results);
+    return Array.dedupeWith(allDetected, (a, b) => purlEquivalence(a.purl, b.purl));
+});
+//# sourceMappingURL=detect.js.map

package/dist/src/unstable/packaging/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../../../src/unstable/packaging/detect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,MAAM,eAAe,GAAG,MAAM,CAAC,aAAa,CAAC,qBAAqB,CAAC,CAAC;AAEpE;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,QAAQ,CAAC,EAClE,UAAkB,EAClB,SAAyC;IAEzC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE;QAC5E,WAAW,EAAE,WAAW;KACzB,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAClF,CAAC,CAAC,CAAC"}

package/dist/src/unstable/packaging/docker.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Docker image detector and reader for package-compatibility discovery.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { PackageDetector, PackageReader } from "./types.js";
+/**
+ * Docker package detector.
+ *
+ * Scans `Dockerfile`, `docker-compose.yml`, and `docker-compose.yaml`
+ * for image dependencies.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const dockerDetector: PackageDetector;
+/**
+ * Docker package reader.
+ *
+ * Inspects local Docker image metadata for `sh.axm.recommended-extensions`
+ * annotation. Since inspecting Docker images requires the Docker CLI,
+ * this reader returns Option.none when Docker is not available.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const dockerReader: PackageReader;
+//# sourceMappingURL=docker.d.ts.map

package/dist/src/unstable/packaging/docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["../../../../src/unstable/packaging/docker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,OAAO,KAAK,EAAmB,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAyOlF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,eAoC5B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,EAAE,aA4C1B,CAAC"}