@agentxm/client-core 0.4.3 → 0.5.0

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

@@ -0,0 +1,50 @@
+/**
+ * Agent-directory scanner: enumerates per-agent skill, command, and subagent
+ * directories declared by the existing `AgentRegistry`. Each occurrence
+ * carries an `agent-dir` discriminator parameterized by `agentId` and the
+ * subject `type`.
+ *
+ * Subject coverage in v1:
+ *
+ * - skill — every agent with `agent.skills.dir`.
+ * - command — every agent with `agent.commands?.dir`.
+ * - subagent — every agent with `agent.subagents?.dir`. Single-file
+ *   subagent surfaces (`isFile === true`, e.g., `roo`'s `.roomodes`) emit one
+ *   occurrence per file path; the file itself is the materialization.
+ *
+ * Rules: no agent in the v1 `AgentRegistry` exposes a rules directory, so the
+ * scanner emits no rule occurrences.
+ *
+ * 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 file inside
+ * the subject directory) — plus a probed `subjectFileExists` flag so subject
+ * modules do not hardcode presence.
+ *
+ * Per Decision 5, scanner output is occurrence-shaped. The public effect
+ * carries no `FileSystem | Path` requirement; per-file partial failures
+ * publish diagnostic warnings rather than failing the cell.
+ *
+ * The scanner avoids `fs.stat` and uses only `fs.exists` / `fs.readDirectory`
+ * so it remains compatible with the fixture builder's in-memory `FileSystem`.
+ */
+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 { AgentDirOccurrence } from "./types.js";
+export interface AgentDirScannerDeps {
+    readonly fs: FileSystem.FileSystem;
+    readonly path: Path.Path;
+    readonly workspaceRoot: string;
+    readonly scope: Scope;
+    readonly diagnostics: Diagnostics;
+    readonly agentRegistry?: Readonly<Record<AgentId, AgentDescriptor>>;
+}
+/**
+ * Closure helper: returns the dependency-closed scanner effect.
+ */
+export declare const makeAgentDirScanner: (deps: AgentDirScannerDeps) => Effect.Effect<ReadonlyArray<AgentDirOccurrence>>;
+//# sourceMappingURL=agent-dir.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-dir.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/workspace/read-model/scanners/agent-dir.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,KAAK,IAAI,MAAM,aAAa,CAAC;AAEzC,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAOzC,OAAO,KAAK,EAAE,kBAAkB,EAAuB,MAAM,YAAY,CAAC;AAmB1E,MAAM,WAAW,mBAAmB;IAClC,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;CACrE;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,MAAM,mBAAmB,KACxB,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAwB,CAAC"}

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

@@ -0,0 +1,145 @@
+/**
+ * Agent-directory scanner: enumerates per-agent skill, command, and subagent
+ * directories declared by the existing `AgentRegistry`. Each occurrence
+ * carries an `agent-dir` discriminator parameterized by `agentId` and the
+ * subject `type`.
+ *
+ * Subject coverage in v1:
+ *
+ * - skill — every agent with `agent.skills.dir`.
+ * - command — every agent with `agent.commands?.dir`.
+ * - subagent — every agent with `agent.subagents?.dir`. Single-file
+ *   subagent surfaces (`isFile === true`, e.g., `roo`'s `.roomodes`) emit one
+ *   occurrence per file path; the file itself is the materialization.
+ *
+ * Rules: no agent in the v1 `AgentRegistry` exposes a rules directory, so the
+ * scanner emits no rule occurrences.
+ *
+ * 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 file inside
+ * the subject directory) — plus a probed `subjectFileExists` flag so subject
+ * modules do not hardcode presence.
+ *
+ * Per Decision 5, scanner output is occurrence-shaped. The public effect
+ * carries no `FileSystem | Path` requirement; per-file partial failures
+ * publish diagnostic warnings rather than failing the cell.
+ *
+ * The scanner avoids `fs.stat` and uses only `fs.exists` / `fs.readDirectory`
+ * so it remains compatible with the fixture builder's in-memory `FileSystem`.
+ */
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { AGENTS } from "../../../agents/registry.js";
+import { childEntries, fileExists, filterDirectories, splitAbsolutePathSegments, } from "./fs-helpers.js";
+const SCANNER_NAME = "agent-dir";
+const normalizeFileBackedName = (name) => {
+    const normalized = name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 64)
+        .replace(/-+$/g, "");
+    return normalized === "" ? "unnamed" : normalized;
+};
+/**
+ * Closure helper: returns the dependency-closed scanner effect.
+ */
+export const makeAgentDirScanner = (deps) => scanAgentDirs(deps);
+const subjectsForAgent = (descriptor) => {
+    const out = [];
+    out.push({ type: "skill", relativeDir: descriptor.skills.dir, isFile: false });
+    if (descriptor.commands !== undefined) {
+        out.push({
+            type: "command",
+            relativeDir: descriptor.commands.dir,
+            isFile: false,
+        });
+    }
+    if (descriptor.subagents !== undefined) {
+        out.push({
+            type: "subagent",
+            relativeDir: descriptor.subagents.dir,
+            isFile: descriptor.subagents.isFile === true,
+        });
+    }
+    return out;
+};
+/**
+ * Map a directory-style subject to the canonical primary file inside its
+ * `<dir>/<name>/` content root. Mirrors the convention used by the
+ * canonical-extensions scanner.
+ */
+const subjectFileNameFor = (type) => {
+    switch (type) {
+        case "skill":
+            return "SKILL.md";
+        case "command":
+            return "command.md";
+        case "subagent":
+            return "subagent.md";
+    }
+};
+/**
+ * For directory-style subject roots: enumerate one level of subdirectories
+ * and treat each subdirectory as a subject occurrence. The Phase 7 subject
+ * module decides whether the directory is well-formed for its subject type.
+ *
+ * For each occurrence, probe the canonical subject file (e.g., `SKILL.md`)
+ * via `fs.exists` so subject modules can consume `subjectFileExists` rather
+ * than re-checking presence themselves.
+ */
+const scanSubjectDirectory = (deps, agentId, subject) => Effect.gen(function* () {
+    const { fs, path, scope, workspaceRoot, diagnostics } = deps;
+    const subjectAbsolute = path.join(workspaceRoot, subject.relativeDir);
+    if (subject.isFile) {
+        const present = yield* fileExists(SCANNER_NAME, fs, diagnostics, subjectAbsolute);
+        if (!present)
+            return [];
+        const occurrence = {
+            _tag: "agent-dir",
+            scope,
+            type: subject.type,
+            agentId,
+            name: normalizeFileBackedName(path.basename(subjectAbsolute)),
+            contentLocation: subjectAbsolute,
+            pathSegments: splitAbsolutePathSegments(path, subjectAbsolute),
+            // Single-file surfaces ARE the materialization; the file itself is
+            // the subject file and presence has already been confirmed.
+            subjectFile: Option.some(subjectAbsolute),
+            subjectFileExists: true,
+        };
+        return [occurrence];
+    }
+    const candidates = yield* childEntries(SCANNER_NAME, fs, diagnostics, path, subjectAbsolute);
+    const nameDirs = yield* filterDirectories(fs, candidates);
+    const subjectFileName = subjectFileNameFor(subject.type);
+    return yield* Effect.forEach(nameDirs, (nameDir) => Effect.gen(function* () {
+        const subjectFilePath = path.join(nameDir, subjectFileName);
+        const subjectFileExists = yield* fileExists(SCANNER_NAME, fs, diagnostics, subjectFilePath);
+        const occurrence = {
+            _tag: "agent-dir",
+            scope,
+            type: subject.type,
+            agentId,
+            name: path.basename(nameDir),
+            contentLocation: nameDir,
+            pathSegments: splitAbsolutePathSegments(path, nameDir),
+            subjectFile: Option.some(subjectFilePath),
+            subjectFileExists,
+        };
+        return occurrence;
+    }), { concurrency: "unbounded" });
+});
+// ---------------------------------------------------------------------------
+// Scanner body
+// ---------------------------------------------------------------------------
+const scanAgentDirs = Effect.fn("workspace.read-model.scanner.agent-dir")(function* (deps) {
+    const registry = deps.agentRegistry ?? AGENTS;
+    const occurrences = yield* Effect.forEach(Object.values(registry), (descriptor) => {
+        const subjects = subjectsForAgent(descriptor);
+        return Effect.forEach(subjects, (subject) => scanSubjectDirectory(deps, descriptor.id, subject), { concurrency: "unbounded" }).pipe(Effect.map((results) => results.flat()));
+    }, { concurrency: "unbounded" });
+    return occurrences.flat();
+});
+//# sourceMappingURL=agent-dir.js.map

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

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

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

@@ -0,0 +1,73 @@
+/**
+ * Shared agent-root resolution.
+ *
+ * `agent-settings.ts` and `mcp-config.ts` both need to resolve a per-agent
+ * root directory (e.g., `.claude` for `claude-code`, `.cursor` for `cursor`)
+ * to compose agent-specific config paths (`<rootDir>/settings.json`,
+ * `<rootDir>/mcp.json`).
+ *
+ * Resolution rules (with `exactOptionalPropertyTypes: true`, the descriptor
+ * shape `rootDir?: string | undefined` distinguishes three states):
+ *
+ * 1. `descriptor.rootDir` is a `string` — use it directly.
+ * 2. `descriptor.rootDir` is explicitly `undefined` (key present but
+ *    nullish) — the agent has opted out of native-config scanning. Return
+ *    `Option.none()` and the scanners SHALL skip this agent.
+ * 3. `descriptor.rootDir` is omitted entirely — fall back to the
+ *    first-segment heuristic over `descriptor.skills.dir`. This handles
+ *    platform-native separators and collapses `.` segments through the
+ *    Path service's normalization.
+ * 4. If the heuristic still produces nothing (empty `skills.dir` or first
+ *    segment empty), fall back to `.${descriptor.id}`.
+ *
+ * The heuristic-fallback path emits a one-time `scanner-config` diagnostic
+ * warning per scanner instance per agent so agent maintainers see a nudge
+ * to set `rootDir` explicitly. Collisions detected at construction time
+ * also warn through the same `scanner-config` code.
+ */
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import type * as Path from "effect/Path";
+import type { AgentDescriptor } from "../../../agents/types.js";
+import type { Diagnostics } from "../diagnostics.js";
+/**
+ * Per-instance state shared across the scanners that resolve agent roots.
+ * Both `mcp-config` and `agent-settings` share one tracker so a single
+ * heuristic-fallback warning per agent fires across both scanners (rather
+ * than once each).
+ *
+ * Construction is cheap: a `Set<string>` allocated by the live layer and
+ * passed to both scanners.
+ */
+export interface AgentRootResolverState {
+    readonly heuristicWarned: Set<string>;
+}
+export declare const makeAgentRootResolverState: () => AgentRootResolverState;
+/**
+ * Resolve the per-agent root directory for one descriptor. Returns
+ * `Option.none()` when the agent has explicitly opted out of native-config
+ * scanning (descriptor's `rootDir` is `undefined`); returns
+ * `Option.some(segment)` otherwise.
+ *
+ * The result is intentionally a relative segment, not an absolute path:
+ * each caller resolves the per-file path differently (`mcp.json` vs
+ * `settings.json`), and the join concern stays at the call site.
+ */
+export declare const agentRootSegment: (path: Path.Path, descriptor: AgentDescriptor, diagnostics: Diagnostics, state: AgentRootResolverState) => Effect.Effect<Option.Option<string>>;
+/**
+ * Detect cases where two or more registry descriptors resolve to the same
+ * `agentRootSegment`. The detection runs once at construction time (per
+ * `WorkspaceReadModelLive` instance); each collision emits a
+ * `scanner-config` diagnostic warning. The function does NOT throw and
+ * does NOT skip scanning — callers continue to scan; the warning is the
+ * signal.
+ *
+ * The check uses the same resolution rules as `agentRootSegment` but
+ * inlined to avoid producing fallback warnings during collision checking
+ * (the heuristic-fallback warning fires once per agent on first scanner
+ * use; running it during collision detection would race with normal
+ * scanner emission). Agents that opt out (`rootDir: undefined`) are
+ * excluded from collision checking entirely.
+ */
+export declare const detectAgentRootCollisions: (path: Path.Path, descriptors: ReadonlyArray<AgentDescriptor>, diagnostics: Diagnostics) => Effect.Effect<void>;
+//# sourceMappingURL=agent-root.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-root.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/workspace/read-model/scanners/agent-root.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,IAAI,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMrD;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACvC;AAED,eAAO,MAAM,0BAA0B,QAAO,sBAE5C,CAAC;AAMH;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,IAAI,CAAC,IAAI,EACf,YAAY,eAAe,EAC3B,aAAa,WAAW,EACxB,OAAO,sBAAsB,KAC5B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CA0BrC,CAAC;AAiCF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,yBAAyB,GACpC,MAAM,IAAI,CAAC,IAAI,EACf,aAAa,aAAa,CAAC,eAAe,CAAC,EAC3C,aAAa,WAAW,KACvB,MAAM,CAAC,MAAM,CAAC,IAAI,CAqBjB,CAAC"}

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

@@ -0,0 +1,146 @@
+/**
+ * Shared agent-root resolution.
+ *
+ * `agent-settings.ts` and `mcp-config.ts` both need to resolve a per-agent
+ * root directory (e.g., `.claude` for `claude-code`, `.cursor` for `cursor`)
+ * to compose agent-specific config paths (`<rootDir>/settings.json`,
+ * `<rootDir>/mcp.json`).
+ *
+ * Resolution rules (with `exactOptionalPropertyTypes: true`, the descriptor
+ * shape `rootDir?: string | undefined` distinguishes three states):
+ *
+ * 1. `descriptor.rootDir` is a `string` — use it directly.
+ * 2. `descriptor.rootDir` is explicitly `undefined` (key present but
+ *    nullish) — the agent has opted out of native-config scanning. Return
+ *    `Option.none()` and the scanners SHALL skip this agent.
+ * 3. `descriptor.rootDir` is omitted entirely — fall back to the
+ *    first-segment heuristic over `descriptor.skills.dir`. This handles
+ *    platform-native separators and collapses `.` segments through the
+ *    Path service's normalization.
+ * 4. If the heuristic still produces nothing (empty `skills.dir` or first
+ *    segment empty), fall back to `.${descriptor.id}`.
+ *
+ * The heuristic-fallback path emits a one-time `scanner-config` diagnostic
+ * warning per scanner instance per agent so agent maintainers see a nudge
+ * to set `rootDir` explicitly. Collisions detected at construction time
+ * also warn through the same `scanner-config` code.
+ */
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+export const makeAgentRootResolverState = () => ({
+    heuristicWarned: new Set(),
+});
+// ---------------------------------------------------------------------------
+// Public resolver
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the per-agent root directory for one descriptor. Returns
+ * `Option.none()` when the agent has explicitly opted out of native-config
+ * scanning (descriptor's `rootDir` is `undefined`); returns
+ * `Option.some(segment)` otherwise.
+ *
+ * The result is intentionally a relative segment, not an absolute path:
+ * each caller resolves the per-file path differently (`mcp.json` vs
+ * `settings.json`), and the join concern stays at the call site.
+ */
+export const agentRootSegment = (path, descriptor, diagnostics, state) => {
+    // 1. Explicit `string` rootDir wins.
+    if (typeof descriptor.rootDir === "string") {
+        return Effect.succeed(Option.some(descriptor.rootDir));
+    }
+    // 2. The descriptor key is present and set to `undefined` — explicit
+    // opt-out. With `exactOptionalPropertyTypes: true`, this is
+    // distinguishable from key omission via the runtime `in` check.
+    if ("rootDir" in descriptor && descriptor.rootDir === undefined) {
+        return Effect.succeed(Option.none());
+    }
+    // 3. Heuristic fallback. Emit a one-time scanner-config warning per
+    // agent so maintainers see the nudge to confirm `rootDir`.
+    return Effect.gen(function* () {
+        if (!state.heuristicWarned.has(descriptor.id)) {
+            state.heuristicWarned.add(descriptor.id);
+            yield* diagnostics.append({
+                source: "scanner",
+                message: `agent-root: descriptor for "${descriptor.id}" has no rootDir; falling back to first-segment heuristic over skills.dir`,
+                code: "scanner-config",
+            });
+        }
+        return Option.some(heuristicSegment(path, descriptor));
+    });
+};
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+const heuristicSegment = (path, descriptor) => {
+    const dir = descriptor.skills.dir;
+    if (dir.length === 0)
+        return `.${descriptor.id}`;
+    const segments = splitPathSegments(path, dir);
+    const first = segments[0];
+    if (first === undefined || first.length === 0)
+        return `.${descriptor.id}`;
+    return first;
+};
+/**
+ * Split a path into its constituent segments using the Path service. Honors
+ * the platform separator and skips empty segments produced by leading or
+ * duplicate separators.
+ */
+const splitPathSegments = (path, value) => {
+    // Normalize first so `.` and `..` segments collapse the way the platform
+    // expects, then split on the platform separator. Path.normalize preserves
+    // a trailing separator only if one was present, which we drop by filtering
+    // out empty segments.
+    const normalized = path.normalize(value);
+    return normalized.split(path.sep).filter((segment) => segment.length > 0);
+};
+// ---------------------------------------------------------------------------
+// Collision detection (called at scanner-set construction time)
+// ---------------------------------------------------------------------------
+/**
+ * Detect cases where two or more registry descriptors resolve to the same
+ * `agentRootSegment`. The detection runs once at construction time (per
+ * `WorkspaceReadModelLive` instance); each collision emits a
+ * `scanner-config` diagnostic warning. The function does NOT throw and
+ * does NOT skip scanning — callers continue to scan; the warning is the
+ * signal.
+ *
+ * The check uses the same resolution rules as `agentRootSegment` but
+ * inlined to avoid producing fallback warnings during collision checking
+ * (the heuristic-fallback warning fires once per agent on first scanner
+ * use; running it during collision detection would race with normal
+ * scanner emission). Agents that opt out (`rootDir: undefined`) are
+ * excluded from collision checking entirely.
+ */
+export const detectAgentRootCollisions = (path, descriptors, diagnostics) => Effect.gen(function* () {
+    const buckets = new Map();
+    for (const descriptor of descriptors) {
+        const segment = resolveCollisionSegment(path, descriptor);
+        if (Option.isNone(segment))
+            continue;
+        const existing = buckets.get(segment.value);
+        if (existing === undefined) {
+            buckets.set(segment.value, [descriptor.id]);
+        }
+        else {
+            existing.push(descriptor.id);
+        }
+    }
+    for (const [segment, ids] of buckets) {
+        if (ids.length < 2)
+            continue;
+        yield* diagnostics.append({
+            source: "scanner",
+            message: `agent-root: collision on "${segment}" across agents: ${ids.join(", ")}`,
+            code: "scanner-config",
+        });
+    }
+});
+const resolveCollisionSegment = (path, descriptor) => {
+    if (typeof descriptor.rootDir === "string")
+        return Option.some(descriptor.rootDir);
+    if ("rootDir" in descriptor && descriptor.rootDir === undefined)
+        return Option.none();
+    return Option.some(heuristicSegment(path, descriptor));
+};
+//# sourceMappingURL=agent-root.js.map

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

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

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

@@ -0,0 +1,43 @@
+/**
+ * Agent-settings scanner: enumerates per-agent native settings files (e.g.,
+ * `.claude/settings.json`, `.cursor/settings.json`).
+ *
+ * Per Decision 5, scanner output is occurrence-shaped. Each occurrence
+ * represents one observable settings file — present and readable on disk —
+ * keyed by `agentId`. The per-file payload is intentionally not parsed here:
+ * Phase 8's per-agent modules decode the typed `nativeConfig` shape through
+ * their own schemas. The scanner's contract is "this agent has a settings
+ * file at this absolute path", not "this settings file is well-formed".
+ *
+ * Per-file partial failures (e.g., unreadable directory) become diagnostic
+ * warnings rather than errors. The error channel stays empty.
+ */
+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 { AgentSettingsOccurrence } 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 AgentSettingsScannerDeps {
+    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 makeAgentSettingsScanner: (deps: AgentSettingsScannerDeps) => Effect.Effect<ReadonlyArray<AgentSettingsOccurrence>>;
+//# sourceMappingURL=agent-settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-settings.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/workspace/read-model/scanners/agent-settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,KAAK,IAAI,MAAM,aAAa,CAAC;AAEzC,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACzE,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;AAEzB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAQ1D;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,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,wBAAwB,GACnC,MAAM,wBAAwB,KAC7B,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,uBAAuB,CAAC,CAA4B,CAAC"}

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

@@ -0,0 +1,53 @@
+/**
+ * Agent-settings scanner: enumerates per-agent native settings files (e.g.,
+ * `.claude/settings.json`, `.cursor/settings.json`).
+ *
+ * Per Decision 5, scanner output is occurrence-shaped. Each occurrence
+ * represents one observable settings file — present and readable on disk —
+ * keyed by `agentId`. The per-file payload is intentionally not parsed here:
+ * Phase 8's per-agent modules decode the typed `nativeConfig` shape through
+ * their own schemas. The scanner's contract is "this agent has a settings
+ * file at this absolute path", not "this settings file is well-formed".
+ *
+ * Per-file partial failures (e.g., unreadable directory) become diagnostic
+ * warnings rather than errors. The error channel stays empty.
+ */
+import * as Array from "effect/Array";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { AGENTS } from "../../../agents/registry.js";
+import { agentRootSegment, makeAgentRootResolverState, } from "./agent-root.js";
+import { fileExists } from "./fs-helpers.js";
+const SCANNER_NAME = "agent-settings";
+/**
+ * Closure helper: returns the dependency-closed scanner effect.
+ */
+export const makeAgentSettingsScanner = (deps) => scanAgentSettings(deps);
+// ---------------------------------------------------------------------------
+// Scanner body
+// ---------------------------------------------------------------------------
+const scanAgentSettings = Effect.fn("workspace.read-model.scanner.agent-settings")(function* (deps) {
+    const { fs, path, workspaceRoot, scope, diagnostics } = deps;
+    const registry = deps.agentRegistry ?? AGENTS;
+    const rootResolverState = deps.rootResolverState ?? makeAgentRootResolverState();
+    const occurrences = yield* Effect.forEach(Object.values(registry), (descriptor) => Effect.gen(function* () {
+        // Resolve the per-agent root segment. `Option.none()` means the
+        // descriptor opts out of native-config scanning — skip it.
+        const rootSegmentOpt = yield* agentRootSegment(path, descriptor, diagnostics, rootResolverState);
+        if (Option.isNone(rootSegmentOpt)) {
+            return Option.none();
+        }
+        const filePath = path.join(workspaceRoot, rootSegmentOpt.value, "settings.json");
+        const present = yield* fileExists(SCANNER_NAME, fs, diagnostics, filePath);
+        if (!present)
+            return Option.none();
+        return Option.some({
+            _tag: "agent-settings",
+            scope,
+            agentId: descriptor.id,
+            contentLocation: filePath,
+        });
+    }), { concurrency: "unbounded" });
+    return Array.getSomes(occurrences);
+});
+//# sourceMappingURL=agent-settings.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-settings.js","sourceRoot":"","sources":["../../../../../../src/unstable/workspace/read-model/scanners/agent-settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAIrD,OAAO,EACL,gBAAgB,EAChB,0BAA0B,GAE3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAuBtC;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,IAA8B,EACyB,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;AAEpF,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,MAAM,iBAAiB,GAAG,MAAM,CAAC,EAAE,CAAC,6CAA6C,CAAC,CAAC,QAAQ,CAAC,EAC1F,IAA8B;IAE9B,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,IAAI,MAAM,CAAC;IAC9C,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,IAAI,0BAA0B,EAAE,CAAC;IAEjF,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CACvC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EACvB,CAAC,UAAU,EAAE,EAAE,CACb,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,gEAAgE;QAChE,2DAA2D;QAC3D,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAC5C,IAAI,EACJ,UAAU,EACV,WAAW,EACX,iBAAiB,CAClB,CAAC;QACF,IAAI,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;YAClC,OAAO,MAAM,CAAC,IAAI,EAA2B,CAAC;QAChD,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;QACjF,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC3E,IAAI,CAAC,OAAO;YAAE,OAAO,MAAM,CAAC,IAAI,EAA2B,CAAC;QAC5D,OAAO,MAAM,CAAC,IAAI,CAA0B;YAC1C,IAAI,EAAE,gBAAgB;YACtB,KAAK;YACL,OAAO,EAAE,UAAU,CAAC,EAAE;YACtB,eAAe,EAAE,QAAQ;SAC1B,CAAC,CAAC;IACL,CAAC,CAAC,EACJ,EAAE,WAAW,EAAE,WAAW,EAAE,CAC7B,CAAC;IAEF,OAAO,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACrC,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,48 @@
+/**
+ * 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 type * as FileSystem from "effect/FileSystem";
+import type * as Path from "effect/Path";
+import type { Diagnostics } from "../diagnostics.js";
+import type { Scope } from "../types.js";
+import type { CanonicalExtensionOccurrence } from "./types.js";
+export interface CanonicalExtensionsScannerDeps {
+    readonly fs: FileSystem.FileSystem;
+    readonly path: Path.Path;
+    readonly workspaceRoot: string;
+    readonly scope: Scope;
+    readonly diagnostics: Diagnostics;
+}
+/**
+ * Closure helper: returns the dependency-closed scanner effect.
+ */
+export declare const makeCanonicalExtensionsScanner: (deps: CanonicalExtensionsScannerDeps) => Effect.Effect<ReadonlyArray<CanonicalExtensionOccurrence>>;
+//# sourceMappingURL=canonical-extensions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-extensions.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/workspace/read-model/scanners/canonical-extensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,KAAK,IAAI,MAAM,aAAa,CAAC;AASzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAOzC,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAQ/D,MAAM,WAAW,8BAA8B;IAC7C,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;CACnC;AAED;;GAEG;AACH,eAAO,MAAM,8BAA8B,GACzC,MAAM,8BAA8B,KACnC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,4BAA4B,CAAC,CAAkC,CAAC"}