@agentxm/client-core 0.4.3 → 0.5.0

package/dist/src/unstable/workspace/read-model/scanners/canonical-extensions.js

@@ -0,0 +1,180 @@
+/**
+ * Canonical-extensions scanner: enumerates `.axm/extensions/<owner>/<type-plural>/src/<name>`
+ * (canonical AXM) and `.axm/extensions/external/<type-plural>/<name>`
+ * (external AXM) materializations across all extension types.
+ *
+ * Per Decision 5 of the workspace read-model design, scanner output is
+ * occurrence-shaped. Each emitted occurrence carries the scanner-tier origin
+ * discriminator (`canonical-axm` | `external-axm`) plus the extension type;
+ * Phase 7 maps these into per-subject origin unions.
+ *
+ * Each occurrence carries structural fields the subject modules need for
+ * cross-platform path handling — `pathSegments` (the absolute path split via
+ * the `Path` service) and `subjectFile` (the canonical primary content file
+ * for the subject type, e.g., `<dir>/SKILL.md` for skills) — plus a probed
+ * `subjectFileExists` flag so subject modules do not hardcode presence.
+ *
+ * Scanner contract:
+ *
+ * - Public effect carries no `FileSystem | Path` requirement. Construction
+ *   takes a deps record and returns an `Effect<ReadonlyArray<…>>`.
+ * - Per-file partial failures (a directory we cannot enumerate) become
+ *   diagnostic warnings, not errors. The error channel stays empty.
+ * - WorkspaceMutations-root path-escape is checked at provider construction (Phase 9),
+ *   not inside the scanner.
+ *
+ * The scanner avoids `fs.stat` and uses only `fs.exists` / `fs.readDirectory`
+ * so it remains compatible with the fixture builder's in-memory `FileSystem`.
+ * "Is this a directory" is decided by whether `readDirectory` returns
+ * successfully; non-directory entries are silently ignored.
+ */
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { decodeExtensionNameSync, isExtensionTypePlural, toExtensionType, } from "../../../extensions/common.js";
+import { decodeHandleSync } from "../../../extensions/handle.js";
+import { childEntries, fileExists, filterDirectories, splitAbsolutePathSegments, } from "./fs-helpers.js";
+const SCANNER_NAME = "canonical-extensions";
+/**
+ * Closure helper: returns the dependency-closed scanner effect.
+ */
+export const makeCanonicalExtensionsScanner = (deps) => scanCanonicalExtensions(deps);
+// ---------------------------------------------------------------------------
+// Subject file mapping
+// ---------------------------------------------------------------------------
+/**
+ * Map an extension type to the canonical primary content file name inside
+ * the subject's directory, when the subject has one. Subject types without a
+ * fixed primary file return `null`.
+ */
+const subjectFileNameFor = (type) => {
+    switch (type) {
+        case "skill":
+            return "SKILL.md";
+        case "command":
+            return "command.md";
+        case "subagent":
+            return "subagent.md";
+        default:
+            return null;
+    }
+};
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+const EXTERNAL_OWNER_SEGMENT = "external";
+const isOwnerSegment = (entry) => entry.length > 0 && entry !== EXTERNAL_OWNER_SEGMENT;
+const asExtensionTypePlural = (entry) => isExtensionTypePlural(entry) ? entry : null;
+/**
+ * Build one occurrence record from a discovered subject directory. Probes
+ * the canonical subject file (e.g., `SKILL.md`) when applicable.
+ */
+const buildOccurrence = (deps, args) => Effect.gen(function* () {
+    const { fs, path, scope, diagnostics } = deps;
+    const subjectFileName = subjectFileNameFor(args.extensionType);
+    const subjectFile = subjectFileName === null
+        ? Option.none()
+        : Option.some(path.join(args.nameDir, subjectFileName));
+    const subjectFileExists = Option.isSome(subjectFile)
+        ? yield* fileExists(SCANNER_NAME, fs, diagnostics, subjectFile.value)
+        : false;
+    const occurrence = {
+        _tag: "canonical-extension",
+        scope,
+        type: args.extensionType,
+        origin: args.origin,
+        name: decodeExtensionNameSync(args.name ?? path.basename(args.nameDir)),
+        owner: args.owner,
+        contentLocation: args.nameDir,
+        pathSegments: splitAbsolutePathSegments(path, args.nameDir),
+        subjectFile,
+        subjectFileExists,
+    };
+    return occurrence;
+});
+const scanCanonicalForOwner = (deps, ownerDirAbsolute, ownerName) => Effect.gen(function* () {
+    const { fs, path, diagnostics } = deps;
+    const typeCandidates = yield* childEntries(SCANNER_NAME, fs, diagnostics, path, ownerDirAbsolute);
+    const typeDirs = yield* filterDirectories(fs, typeCandidates);
+    const occurrences = yield* Effect.forEach(typeDirs, (typeDirAbsolute) => Effect.gen(function* () {
+        const typePlural = asExtensionTypePlural(path.basename(typeDirAbsolute));
+        if (typePlural === null) {
+            const empty = [];
+            return empty;
+        }
+        const extensionType = toExtensionType(typePlural);
+        const directSrcDir = path.join(typeDirAbsolute, "src");
+        const directNameCandidates = yield* childEntries(SCANNER_NAME, fs, diagnostics, path, directSrcDir);
+        const directNameDirs = yield* filterDirectories(fs, directNameCandidates);
+        const directOccurrences = yield* Effect.forEach(directNameDirs, (nameDir) => buildOccurrence(deps, {
+            extensionType,
+            origin: "canonical-axm",
+            nameDir,
+            owner: ownerName,
+        }), { concurrency: "unbounded" });
+        const packageChildCandidates = yield* childEntries(SCANNER_NAME, fs, diagnostics, path, typeDirAbsolute);
+        const packageDirs = yield* filterDirectories(fs, packageChildCandidates);
+        const packageCandidates = packageDirs.filter((candidate) => path.basename(candidate) !== "src");
+        const packageOccurrences = yield* Effect.forEach(packageCandidates, (packageDir) => Effect.gen(function* () {
+            const nameDir = extensionType === "pack" ? packageDir : path.join(packageDir, "src");
+            const nameDirExists = yield* fs.readDirectory(nameDir).pipe(Effect.as(true), Effect.catch(() => Effect.succeed(false)));
+            if (!nameDirExists) {
+                const empty = [];
+                return empty;
+            }
+            const occurrence = yield* buildOccurrence(deps, {
+                extensionType,
+                origin: "canonical-axm",
+                nameDir,
+                name: path.basename(packageDir),
+                owner: ownerName,
+            });
+            return [occurrence];
+        }), { concurrency: "unbounded" });
+        return [...directOccurrences, ...packageOccurrences.flat()];
+    }), { concurrency: "unbounded" });
+    return occurrences.flat();
+});
+const scanExternal = (deps, externalDirAbsolute) => Effect.gen(function* () {
+    const { fs, path, diagnostics } = deps;
+    const typeCandidates = yield* childEntries(SCANNER_NAME, fs, diagnostics, path, externalDirAbsolute);
+    const typeDirs = yield* filterDirectories(fs, typeCandidates);
+    const occurrences = yield* Effect.forEach(typeDirs, (typeDirAbsolute) => Effect.gen(function* () {
+        const typePlural = asExtensionTypePlural(path.basename(typeDirAbsolute));
+        if (typePlural === null) {
+            const empty = [];
+            return empty;
+        }
+        const extensionType = toExtensionType(typePlural);
+        const nameCandidates = yield* childEntries(SCANNER_NAME, fs, diagnostics, path, typeDirAbsolute);
+        const nameDirs = yield* filterDirectories(fs, nameCandidates);
+        return yield* Effect.forEach(nameDirs, (nameDir) => buildOccurrence(deps, {
+            extensionType,
+            origin: "external-axm",
+            nameDir,
+            owner: null,
+        }), { concurrency: "unbounded" });
+    }), { concurrency: "unbounded" });
+    return occurrences.flat();
+});
+// ---------------------------------------------------------------------------
+// Scanner body
+// ---------------------------------------------------------------------------
+const scanCanonicalExtensions = Effect.fn("workspace.read-model.scanner.canonical-extensions")(function* (deps) {
+    const { fs, path, workspaceRoot, diagnostics } = deps;
+    const extensionsRoot = path.join(workspaceRoot, ".axm", "extensions");
+    const ownerCandidates = yield* childEntries(SCANNER_NAME, fs, diagnostics, path, extensionsRoot);
+    const ownerDirs = yield* filterDirectories(fs, ownerCandidates);
+    const occurrences = yield* Effect.forEach(ownerDirs, (ownerDir) => {
+        const ownerName = path.basename(ownerDir);
+        if (ownerName === EXTERNAL_OWNER_SEGMENT) {
+            return scanExternal(deps, ownerDir);
+        }
+        if (!isOwnerSegment(ownerName)) {
+            const empty = [];
+            return Effect.succeed(empty);
+        }
+        return scanCanonicalForOwner(deps, ownerDir, decodeHandleSync(ownerName));
+    }, { concurrency: "unbounded" });
+    return occurrences.flat();
+});
+//# sourceMappingURL=canonical-extensions.js.map

package/dist/src/unstable/workspace/read-model/scanners/canonical-extensions.js.map

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

package/dist/src/unstable/workspace/read-model/scanners/fs-helpers.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Shared filesystem helpers used by the workspace read-model scanners.
+ *
+ * Each scanner needs the same handful of resilient `FileSystem` probes:
+ * "does this file exist", "list this directory's children", "filter to
+ * subdirectories only", and "split an absolute path by the platform
+ * separator". Before this module they were duplicated nearly verbatim across
+ * `agent-dir.ts`, `agent-settings.ts`, and `canonical-extensions.ts`, with
+ * subtle drift in their diagnostic-message prefixes and in whether
+ * `filterDirectories` accepted a `diagnostics` argument.
+ *
+ * Helpers in this module:
+ *
+ * - Take a `scannerName` so each scanner's diagnostics carry its own prefix
+ *   (`canonical-extensions:`, `agent-dir:`, etc.) — matching the call-site
+ *   strings the existing scanner tests assert on.
+ * - Return `Option<T>` from probe-style helpers (`fileExists`,
+ *   `directoryCandidate`) so callers can compose with `Array.getSomes`
+ *   instead of `null` sentinels. Boolean wrappers stay available where the
+ *   caller cares about presence directly.
+ * - Carry no `R` requirement: each helper takes `fs` / `path` / `diagnostics`
+ *   directly as arguments and the resulting `Effect` is dependency-closed.
+ */
+import * as Effect from "effect/Effect";
+import type * as FileSystem from "effect/FileSystem";
+import type * as Path from "effect/Path";
+import type { Diagnostics } from "../diagnostics.js";
+/**
+ * Probe a path with `fs.exists`. Returns `true` when the file exists,
+ * `false` when it does not, and emits a `scanner-io` diagnostic and returns
+ * `false` when the probe itself errors.
+ */
+export declare const fileExists: (scannerName: string, fs: FileSystem.FileSystem, diagnostics: Diagnostics, filePath: string) => Effect.Effect<boolean>;
+/**
+ * Enumerate the immediate children of `parent` and return their absolute
+ * paths. When `parent` is absent, returns `[]`. When `parent` exists but
+ * cannot be enumerated, emits a `scanner-io` diagnostic and returns `[]`.
+ *
+ * Callers feed the result into `filterDirectories` to keep only
+ * subdirectories, or treat each entry as a candidate file to probe.
+ */
+export declare const childEntries: (scannerName: string, fs: FileSystem.FileSystem, diagnostics: Diagnostics, path: Path.Path, parent: string) => Effect.Effect<ReadonlyArray<string>>;
+/**
+ * Filter `candidates` down to entries that are directories. Directory
+ * detection uses a successful `readDirectory` call so the helper stays
+ * compatible with the v1 fixture builder's in-memory `FileSystem`, which
+ * does not implement `fs.stat`.
+ *
+ * Failures (file or unreadable directory) are silently dropped: an explicit
+ * warning here would fire on every regular file inside a scanned tree
+ * (`README.md`, `SKILL.md`, etc.). The shared scanner test still asserts
+ * that failing-fs cases surface warnings via the parent `readDirectory`.
+ */
+export declare const filterDirectories: (fs: FileSystem.FileSystem, candidates: ReadonlyArray<string>) => Effect.Effect<ReadonlyArray<string>>;
+/**
+ * Split an absolute path into its constituent segments using the `Path`
+ * service's platform separator. Subject modules consume the array so they do
+ * not re-parse the string with a hard-coded `/` separator. POSIX
+ * `/ws/.claude/skills/x` → `["", "ws", ".claude", "skills", "x"]`; Windows
+ * `C:\\ws\\.claude\\skills\\x` → `["C:", "ws", ".claude", "skills", "x"]`.
+ */
+export declare const splitAbsolutePathSegments: (path: Path.Path, absolute: string) => ReadonlyArray<string>;
+//# sourceMappingURL=fs-helpers.d.ts.map

package/dist/src/unstable/workspace/read-model/scanners/fs-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/workspace/read-model/scanners/fs-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,KAAK,IAAI,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,UAAU,GACrB,aAAa,MAAM,EACnB,IAAI,UAAU,CAAC,UAAU,EACzB,aAAa,WAAW,EACxB,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CAAC,OAAO,CAapB,CAAC;AAEL;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GACvB,aAAa,MAAM,EACnB,IAAI,UAAU,CAAC,UAAU,EACzB,aAAa,WAAW,EACxB,MAAM,IAAI,CAAC,IAAI,EACf,QAAQ,MAAM,KACb,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAyBlC,CAAC;AAEL;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,GAC5B,IAAI,UAAU,CAAC,UAAU,EACzB,YAAY,aAAa,CAAC,MAAM,CAAC,KAChC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAalC,CAAC;AAEL;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GACpC,MAAM,IAAI,CAAC,IAAI,EACf,UAAU,MAAM,KACf,aAAa,CAAC,MAAM,CAA6B,CAAC"}

package/dist/src/unstable/workspace/read-model/scanners/fs-helpers.js

@@ -0,0 +1,106 @@
+/**
+ * Shared filesystem helpers used by the workspace read-model scanners.
+ *
+ * Each scanner needs the same handful of resilient `FileSystem` probes:
+ * "does this file exist", "list this directory's children", "filter to
+ * subdirectories only", and "split an absolute path by the platform
+ * separator". Before this module they were duplicated nearly verbatim across
+ * `agent-dir.ts`, `agent-settings.ts`, and `canonical-extensions.ts`, with
+ * subtle drift in their diagnostic-message prefixes and in whether
+ * `filterDirectories` accepted a `diagnostics` argument.
+ *
+ * Helpers in this module:
+ *
+ * - Take a `scannerName` so each scanner's diagnostics carry its own prefix
+ *   (`canonical-extensions:`, `agent-dir:`, etc.) — matching the call-site
+ *   strings the existing scanner tests assert on.
+ * - Return `Option<T>` from probe-style helpers (`fileExists`,
+ *   `directoryCandidate`) so callers can compose with `Array.getSomes`
+ *   instead of `null` sentinels. Boolean wrappers stay available where the
+ *   caller cares about presence directly.
+ * - Carry no `R` requirement: each helper takes `fs` / `path` / `diagnostics`
+ *   directly as arguments and the resulting `Effect` is dependency-closed.
+ */
+import * as Array from "effect/Array";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+/**
+ * Probe a path with `fs.exists`. Returns `true` when the file exists,
+ * `false` when it does not, and emits a `scanner-io` diagnostic and returns
+ * `false` when the probe itself errors.
+ */
+export const fileExists = (scannerName, fs, diagnostics, filePath) => Effect.gen(function* () {
+    const exists = yield* Effect.result(fs.exists(filePath));
+    if (exists._tag === "Failure") {
+        yield* diagnostics.append({
+            source: "scanner",
+            message: `${scannerName}: cannot stat ${filePath}`,
+            path: filePath,
+            code: "scanner-io",
+        });
+        return false;
+    }
+    return exists.success;
+});
+/**
+ * Enumerate the immediate children of `parent` and return their absolute
+ * paths. When `parent` is absent, returns `[]`. When `parent` exists but
+ * cannot be enumerated, emits a `scanner-io` diagnostic and returns `[]`.
+ *
+ * Callers feed the result into `filterDirectories` to keep only
+ * subdirectories, or treat each entry as a candidate file to probe.
+ */
+export const childEntries = (scannerName, fs, diagnostics, path, parent) => Effect.gen(function* () {
+    const exists = yield* Effect.result(fs.exists(parent));
+    if (exists._tag === "Failure") {
+        yield* diagnostics.append({
+            source: "scanner",
+            message: `${scannerName}: cannot stat ${parent}`,
+            path: parent,
+            code: "scanner-io",
+        });
+        return [];
+    }
+    if (!exists.success)
+        return [];
+    const entries = yield* Effect.result(fs.readDirectory(parent));
+    if (entries._tag === "Failure") {
+        yield* diagnostics.append({
+            source: "scanner",
+            message: `${scannerName}: cannot read directory ${parent}`,
+            path: parent,
+            code: "scanner-io",
+        });
+        return [];
+    }
+    return entries.success.map((entry) => path.join(parent, entry));
+});
+/**
+ * Filter `candidates` down to entries that are directories. Directory
+ * detection uses a successful `readDirectory` call so the helper stays
+ * compatible with the v1 fixture builder's in-memory `FileSystem`, which
+ * does not implement `fs.stat`.
+ *
+ * Failures (file or unreadable directory) are silently dropped: an explicit
+ * warning here would fire on every regular file inside a scanned tree
+ * (`README.md`, `SKILL.md`, etc.). The shared scanner test still asserts
+ * that failing-fs cases surface warnings via the parent `readDirectory`.
+ */
+export const filterDirectories = (fs, candidates) => Effect.gen(function* () {
+    const checks = yield* Effect.forEach(candidates, (candidate) => Effect.gen(function* () {
+        const result = yield* Effect.result(fs.readDirectory(candidate));
+        if (result._tag === "Failure")
+            return Option.none();
+        return Option.some(candidate);
+    }), { concurrency: "unbounded" });
+    return Array.getSomes(checks);
+});
+/**
+ * Split an absolute path into its constituent segments using the `Path`
+ * service's platform separator. Subject modules consume the array so they do
+ * not re-parse the string with a hard-coded `/` separator. POSIX
+ * `/ws/.claude/skills/x` → `["", "ws", ".claude", "skills", "x"]`; Windows
+ * `C:\\ws\\.claude\\skills\\x` → `["C:", "ws", ".claude", "skills", "x"]`.
+ */
+export const splitAbsolutePathSegments = (path, absolute) => absolute.split(path.sep);
+//# sourceMappingURL=fs-helpers.js.map

package/dist/src/unstable/workspace/read-model/scanners/fs-helpers.js.map

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

package/dist/src/unstable/workspace/read-model/scanners/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Scanner barrel: re-exports every per-scanner factory and the shared
+ * occurrence-shape types from one entry point so `context.ts` can pull
+ * scanner wiring from a single module.
+ *
+ * Each scanner module owns its own deps interface, occurrence shape, and
+ * partial-failure semantics; this barrel only re-exports — no logic.
+ */
+export { makeCanonicalExtensionsScanner, type CanonicalExtensionsScannerDeps, } from "./canonical-extensions.js";
+export { makeAgentDirScanner, type AgentDirScannerDeps } from "./agent-dir.js";
+export { makeMcpConfigScanner, type McpConfigScannerDeps } from "./mcp-config.js";
+export { makeAgentSettingsScanner, type AgentSettingsScannerDeps } from "./agent-settings.js";
+export { agentRootSegment, detectAgentRootCollisions, makeAgentRootResolverState, type AgentRootResolverState, } from "./agent-root.js";
+export { dedupeByIdentity, occurrenceIdentity, occurrenceIdentityKey, type AgentDirOccurrence, type AgentDirSubjectType, type AgentMcpConfigOccurrence, type AgentSettingsOccurrence, type CanonicalExtensionOccurrence, type CanonicalExtensionOriginKind, type McpConfigOccurrence, type McpConfigOriginKind, type OccurrenceIdentity, type ScannerOccurrence, type WorkspaceMcpConfigOccurrence, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/unstable/workspace/read-model/scanners/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/workspace/read-model/scanners/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EACL,8BAA8B,EAC9B,KAAK,8BAA8B,GACpC,MAAM,2BAA2B,CAAC;AAMnC,OAAO,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAM/E,OAAO,EAAE,oBAAoB,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAMlF,OAAO,EAAE,wBAAwB,EAAE,KAAK,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAO9F,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,0BAA0B,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,GAClC,MAAM,YAAY,CAAC"}

package/dist/src/unstable/workspace/read-model/scanners/index.js

@@ -0,0 +1,34 @@
+/**
+ * Scanner barrel: re-exports every per-scanner factory and the shared
+ * occurrence-shape types from one entry point so `context.ts` can pull
+ * scanner wiring from a single module.
+ *
+ * Each scanner module owns its own deps interface, occurrence shape, and
+ * partial-failure semantics; this barrel only re-exports — no logic.
+ */
+// ---------------------------------------------------------------------------
+// Canonical-extensions scanner
+// ---------------------------------------------------------------------------
+export { makeCanonicalExtensionsScanner, } from "./canonical-extensions.js";
+// ---------------------------------------------------------------------------
+// Agent-directory scanner
+// ---------------------------------------------------------------------------
+export { makeAgentDirScanner } from "./agent-dir.js";
+// ---------------------------------------------------------------------------
+// MCP-config scanner (workspace + per-agent)
+// ---------------------------------------------------------------------------
+export { makeMcpConfigScanner } from "./mcp-config.js";
+// ---------------------------------------------------------------------------
+// Agent-settings scanner
+// ---------------------------------------------------------------------------
+export { makeAgentSettingsScanner } from "./agent-settings.js";
+// ---------------------------------------------------------------------------
+// Shared agent-root resolver used by both the agent-settings and mcp-config
+// scanners.
+// ---------------------------------------------------------------------------
+export { agentRootSegment, detectAgentRootCollisions, makeAgentRootResolverState, } from "./agent-root.js";
+// ---------------------------------------------------------------------------
+// Shared occurrence-shape types and identity helpers
+// ---------------------------------------------------------------------------
+export { dedupeByIdentity, occurrenceIdentity, occurrenceIdentityKey, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/src/unstable/workspace/read-model/scanners/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/unstable/workspace/read-model/scanners/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E,OAAO,EACL,8BAA8B,GAE/B,MAAM,2BAA2B,CAAC;AAEnC,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,OAAO,EAAE,mBAAmB,EAA4B,MAAM,gBAAgB,CAAC;AAE/E,8EAA8E;AAC9E,6CAA6C;AAC7C,8EAA8E;AAE9E,OAAO,EAAE,oBAAoB,EAA6B,MAAM,iBAAiB,CAAC;AAElF,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,OAAO,EAAE,wBAAwB,EAAiC,MAAM,qBAAqB,CAAC;AAE9F,8EAA8E;AAC9E,4EAA4E;AAC5E,YAAY;AACZ,8EAA8E;AAE9E,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,0BAA0B,GAE3B,MAAM,iBAAiB,CAAC;AAEzB,8EAA8E;AAC9E,qDAAqD;AACrD,8EAA8E;AAE9E,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,GAYtB,MAAM,YAAY,CAAC"}

package/dist/src/unstable/workspace/read-model/scanners/mcp-config.d.ts

@@ -0,0 +1,61 @@
+/**
+ * MCP-config scanner: parses the workspace `.mcp.json` plus per-agent native
+ * MCP config files (`.cursor/mcp.json`, `.codex/mcp.json`, etc.) and emits one
+ * occurrence per declared server.
+ *
+ * Per Decision 5, scanner output is occurrence-shaped; the discriminator
+ * `origin: "workspace" | "agent"` distinguishes the two surfaces, and the
+ * agent surface carries its `agentId` so per-subject modules can map cleanly
+ * into agent-scoped origins. The two variants are a discriminated union over
+ * `origin`: `WorkspaceMcpConfigOccurrence` omits `agentId` entirely;
+ * `AgentMcpConfigOccurrence` carries it non-nullable.
+ *
+ * Per-file partial failures (unreadable config, bad JSON, schema-incompatible
+ * payload) become diagnostic warnings rather than errors. The error channel
+ * stays empty.
+ *
+ * MCP config layout:
+ *
+ * ```json
+ * {
+ *   "mcpServers": {
+ *     "<server-name>": { ... }
+ *   }
+ * }
+ * ```
+ *
+ * The scanner emits one occurrence per `<server-name>`. The per-server payload
+ * (command, args, env, etc.) is intentionally not parsed here — Phase 7's MCP
+ * server subject module decodes it through its own schema. The scanner's
+ * contract is "this server name is observed at this surface", not "this
+ * server is well-formed".
+ */
+import * as Effect from "effect/Effect";
+import type * as FileSystem from "effect/FileSystem";
+import type * as Path from "effect/Path";
+import type { AgentDescriptor, AgentId } from "../../../agents/types.js";
+import type { Diagnostics } from "../diagnostics.js";
+import type { Scope } from "../types.js";
+import { type AgentRootResolverState } from "./agent-root.js";
+import type { McpConfigOccurrence } from "./types.js";
+/**
+ * Inputs the live layer captures before invoking the scanner. The optional
+ * `agentRegistry` mirrors the agent-dir scanner. `rootResolverState` lets
+ * the live layer share heuristic-warning state across `mcp-config` and
+ * `agent-settings`; when omitted, a fresh state is used (one warning per
+ * scanner invocation per agent).
+ */
+export interface McpConfigScannerDeps {
+    readonly fs: FileSystem.FileSystem;
+    readonly path: Path.Path;
+    readonly workspaceRoot: string;
+    readonly scope: Scope;
+    readonly diagnostics: Diagnostics;
+    readonly agentRegistry?: Readonly<Record<AgentId, AgentDescriptor>>;
+    readonly rootResolverState?: AgentRootResolverState;
+}
+/**
+ * Closure helper: returns the dependency-closed scanner effect.
+ */
+export declare const makeMcpConfigScanner: (deps: McpConfigScannerDeps) => Effect.Effect<ReadonlyArray<McpConfigOccurrence>>;
+//# sourceMappingURL=mcp-config.d.ts.map

package/dist/src/unstable/workspace/read-model/scanners/mcp-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/workspace/read-model/scanners/mcp-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,KAAK,IAAI,MAAM,aAAa,CAAC;AAGzC,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAEV,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAQpB;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,UAAU,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;IACpE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;CACrD;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,oBAAoB,KACzB,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAwB,CAAC"}