@agentxm/client-core 0.4.5 → 0.5.1

package/dist/src/unstable/workspace/read-model/__fixtures__/occurrences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"occurrences.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/workspace/read-model/__fixtures__/occurrences.ts"],"names":[],"mappings":"AAcA,OAAO,EAA2B,KAAK,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE5F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,4BAA4B,EAC5B,4BAA4B,EAC5B,4BAA4B,EAC7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAuDzC,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAClC,OAAO,4BAA4B,KAClC,4BAmBF,CAAC;AAMF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,2BAA2B,KAAG,kBAqB3E,CAAC;AAMF,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,eAAO,MAAM,gCAAgC,GAC3C,OAAO,qCAAqC,KAC3C,4BAMD,CAAC;AAEH,eAAO,MAAM,4BAA4B,GACvC,OAAO,iCAAiC,KACvC,wBAOD,CAAC;AAMH,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,eAAO,MAAM,2BAA2B,GACtC,OAAO,gCAAgC,KACtC,uBAKD,CAAC"}

package/dist/src/unstable/workspace/read-model/__fixtures__/occurrences.js

@@ -0,0 +1,131 @@
+/**
+ * Test fixture builders for scanner occurrences.
+ *
+ * Per the Wave 1A scanner contract, every `CanonicalExtensionOccurrence` and
+ * `AgentDirOccurrence` carries `pathSegments`, `subjectFile`, and
+ * `subjectFileExists` in addition to its identifying fields. These factories
+ * compute those derived fields from minimal inputs so test sites supply only
+ * the discriminators they care about.
+ *
+ * `McpConfigOccurrence` is now a discriminated union on `origin`. The
+ * `makeMcpConfigOccurrence` factory accepts the variant tag and returns the
+ * correct shape — workspace omits `agentId`; agent carries it non-null.
+ */
+import * as Option from "effect/Option";
+import { decodeExtensionNameSync } from "../../../extensions/common.js";
+import { decodeHandleSync } from "../../../extensions/handle.js";
+// ---------------------------------------------------------------------------
+// Path helpers (POSIX, since fixtures synthesize POSIX paths)
+// ---------------------------------------------------------------------------
+const POSIX_SEP = "/";
+const splitSegments = (absolute) => absolute.split(POSIX_SEP);
+const join = (parent, child) => parent.endsWith(POSIX_SEP) ? `${parent}${child}` : `${parent}${POSIX_SEP}${child}`;
+const normalizeFileBackedName = (name) => {
+    const normalized = name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 64)
+        .replace(/-+$/g, "");
+    return normalized === "" ? "unnamed" : normalized;
+};
+// ---------------------------------------------------------------------------
+// Subject file mapping (must match scanners/canonical-extensions.ts /
+// scanners/agent-dir.ts)
+// ---------------------------------------------------------------------------
+const subjectFileNameForExtensionType = (type, name) => {
+    switch (type) {
+        case "skill":
+            return "SKILL.md";
+        case "command":
+        case "subagent":
+            return `${name}.md`;
+        default:
+            return null;
+    }
+};
+const subjectFileNameForAgentDir = (type, name) => {
+    switch (type) {
+        case "skill":
+            return "SKILL.md";
+        case "command":
+        case "subagent":
+            return `${name}.md`;
+    }
+};
+/**
+ * Build a `CanonicalExtensionOccurrence` with the new structural fields
+ * populated. `pathSegments` is computed from `contentLocation` (POSIX split).
+ * `subjectFile` is `Some(<dir>/<name>.md)` for skill/command/subagent; `None`
+ * for mcp-server/file/rule/pack. `subjectFileExists` defaults to `true` when
+ * the subject has a canonical primary file; pass `false` to model absence.
+ */
+export const makeCanonicalOccurrence = (input) => {
+    const subjectFileName = subjectFileNameForExtensionType(input.type, input.name);
+    const subjectFile = subjectFileName === null
+        ? Option.none()
+        : Option.some(join(input.contentLocation, subjectFileName));
+    const subjectFileExists = input.subjectFileExists ?? (subjectFileName === null ? false : true);
+    return {
+        _tag: "canonical-extension",
+        scope: input.scope,
+        type: input.type,
+        origin: input.origin,
+        name: decodeExtensionNameSync(input.name),
+        owner: input.owner === null ? null : decodeHandleSync(input.owner),
+        contentLocation: input.contentLocation,
+        pathSegments: splitSegments(input.contentLocation),
+        subjectFile,
+        subjectFileExists,
+    };
+};
+/**
+ * Build an `AgentDirOccurrence` with the new structural fields populated.
+ * `pathSegments` is computed from `contentLocation` (POSIX split).
+ * `subjectFile` is `<contentLocation>/<canonical-file>` for directory
+ * occurrences and the `contentLocation` itself for single-file subagent
+ * surfaces. `subjectFileExists` defaults to `true`.
+ */
+export const makeAgentDirOccurrence = (input) => {
+    const resolvedName = input.singleFile === true ? normalizeFileBackedName(input.name) : input.name;
+    const subjectFileName = subjectFileNameForAgentDir(input.type, resolvedName);
+    const subjectFile = input.singleFile === true
+        ? Option.some(input.contentLocation)
+        : subjectFileName === null
+            ? Option.none()
+            : Option.some(join(input.contentLocation, subjectFileName));
+    const subjectFileExists = input.subjectFileExists ?? true;
+    return {
+        _tag: "agent-dir",
+        scope: input.scope,
+        type: input.type,
+        agentId: input.agentId,
+        name: resolvedName,
+        contentLocation: input.contentLocation,
+        pathSegments: splitSegments(input.contentLocation),
+        subjectFile,
+        subjectFileExists,
+    };
+};
+export const makeWorkspaceMcpConfigOccurrence = (input) => ({
+    _tag: "mcp-config",
+    scope: input.scope,
+    origin: "workspace",
+    name: decodeExtensionNameSync(input.name),
+    contentLocation: input.contentLocation,
+});
+export const makeAgentMcpConfigOccurrence = (input) => ({
+    _tag: "mcp-config",
+    scope: input.scope,
+    origin: "agent",
+    agentId: input.agentId,
+    name: decodeExtensionNameSync(input.name),
+    contentLocation: input.contentLocation,
+});
+export const makeAgentSettingsOccurrence = (input) => ({
+    _tag: "agent-settings",
+    scope: input.scope,
+    agentId: input.agentId,
+    contentLocation: input.contentLocation,
+});
+//# sourceMappingURL=occurrences.js.map

package/dist/src/unstable/workspace/read-model/__fixtures__/occurrences.js.map

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

package/dist/src/unstable/workspace/read-model/__fixtures__/test-layer.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Workspace read-model test layer.
+ *
+ * Provides {@link WorkspaceReadModelConfig}, {@link AgentRootResolver},
+ * `FileSystem`, and `Path` against fixture-built deps. Test bodies call
+ * {@link makeWorkspaceReadModel} directly to obtain a per-scope read model.
+ *
+ * The layer accepts an optional `options.allowedRoot`; when omitted, the
+ * filesystem root (`/`) is used so any `workspaceRoot` / `userHome` from the
+ * spec is allowed. Tests that want to verify root-escape failure pass an
+ * `allowedRoot` outside the spec's `workspaceRoot`.
+ *
+ * Tests that need to inject filesystem-level faults (e.g. simulate read
+ * failures) provide `options.wrapFileSystem` to wrap the fixture's
+ * `FileSystem` before it is composed into the layer.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import { AgentRootResolver } from "../agent-root-resolver.js";
+import { WorkspaceReadModelConfig } from "../service.js";
+import { type FixtureSpec, type PathEscapeError } from "./builder.js";
+/**
+ * Optional layer-construction options for {@link WorkspaceReadModelTest}.
+ *
+ * - `allowedRoot` — workspace-root containment boundary used by
+ *   {@link makeWorkspaceReadModel} to validate `projectRoot` and `userHome`.
+ *   Defaults to the filesystem root so tests opt into root-escape behaviour
+ *   explicitly.
+ * - `wrapFileSystem` — optional adapter applied to the fixture's
+ *   `FileSystem` before it is provided. Tests that simulate IO faults (e.g.
+ *   read failures on specific paths) wrap the underlying filesystem here
+ *   without forking the test layer.
+ */
+export interface WorkspaceReadModelTestOptions {
+    readonly allowedRoot?: string;
+    readonly wrapFileSystem?: (fs: FileSystem.FileSystem) => FileSystem.FileSystem;
+}
+/**
+ * Test layer for the workspace read model. Composes the fixture-built
+ * `FileSystem` / `Path` with {@link WorkspaceReadModelConfig} and
+ * {@link AgentRootResolver}, the dependencies callers need to invoke
+ * {@link makeWorkspaceReadModel}.
+ *
+ * The error channel covers:
+ *
+ *   - `PathEscapeError` — fixture builder rejection (escapes the
+ *     synthesized tree). Tests that need to assert this branch pass a
+ *     spec with a `..`-laden tree entry.
+ *
+ * Workspace-root escape (`WorkspaceRootEscape`) surfaces from
+ * {@link makeWorkspaceReadModel} itself, not the layer.
+ */
+export declare const WorkspaceReadModelTest: (spec: FixtureSpec, options?: WorkspaceReadModelTestOptions) => Layer.Layer<FileSystem.FileSystem | Path.Path | WorkspaceReadModelConfig | AgentRootResolver, PathEscapeError>;
+//# sourceMappingURL=test-layer.d.ts.map

package/dist/src/unstable/workspace/read-model/__fixtures__/test-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-layer.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/workspace/read-model/__fixtures__/test-layer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAyB,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAgB,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpF;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,UAAU,CAAC,UAAU,KAAK,UAAU,CAAC,UAAU,CAAC;CAChF;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,WAAW,EACjB,UAAS,6BAAkC,KAC1C,KAAK,CAAC,KAAK,CACZ,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,wBAAwB,GAAG,iBAAiB,EAChF,eAAe,CAqBd,CAAC"}

package/dist/src/unstable/workspace/read-model/__fixtures__/test-layer.js

@@ -0,0 +1,52 @@
+/**
+ * Workspace read-model test layer.
+ *
+ * Provides {@link WorkspaceReadModelConfig}, {@link AgentRootResolver},
+ * `FileSystem`, and `Path` against fixture-built deps. Test bodies call
+ * {@link makeWorkspaceReadModel} directly to obtain a per-scope read model.
+ *
+ * The layer accepts an optional `options.allowedRoot`; when omitted, the
+ * filesystem root (`/`) is used so any `workspaceRoot` / `userHome` from the
+ * spec is allowed. Tests that want to verify root-escape failure pass an
+ * `allowedRoot` outside the spec's `workspaceRoot`.
+ *
+ * Tests that need to inject filesystem-level faults (e.g. simulate read
+ * failures) provide `options.wrapFileSystem` to wrap the fixture's
+ * `FileSystem` before it is composed into the layer.
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import { AgentRootResolver, AgentRootResolverLive } from "../agent-root-resolver.js";
+import { WorkspaceReadModelConfig } from "../service.js";
+import { buildFixture } from "./builder.js";
+/**
+ * Test layer for the workspace read model. Composes the fixture-built
+ * `FileSystem` / `Path` with {@link WorkspaceReadModelConfig} and
+ * {@link AgentRootResolver}, the dependencies callers need to invoke
+ * {@link makeWorkspaceReadModel}.
+ *
+ * The error channel covers:
+ *
+ *   - `PathEscapeError` — fixture builder rejection (escapes the
+ *     synthesized tree). Tests that need to assert this branch pass a
+ *     spec with a `..`-laden tree entry.
+ *
+ * Workspace-root escape (`WorkspaceRootEscape`) surfaces from
+ * {@link makeWorkspaceReadModel} itself, not the layer.
+ */
+export const WorkspaceReadModelTest = (spec, options = {}) => Layer.unwrap(Effect.gen(function* () {
+    const deps = yield* buildFixture(spec);
+    const fs = options.wrapFileSystem === undefined ? deps.fs : options.wrapFileSystem(deps.fs);
+    const fsLayer = Layer.succeed(FileSystem.FileSystem, fs);
+    const pathLayer = Layer.succeed(Path.Path, deps.path);
+    const allowedRoot = options.allowedRoot ?? "/";
+    const configLayer = Layer.succeed(WorkspaceReadModelConfig, {
+        projectRoot: deps.workspaceRoot,
+        userHome: deps.userHome,
+        allowedRoot,
+    });
+    return Layer.mergeAll(fsLayer, pathLayer, configLayer, AgentRootResolverLive.pipe(Layer.provide(pathLayer)));
+}));
+//# sourceMappingURL=test-layer.js.map

package/dist/src/unstable/workspace/read-model/__fixtures__/test-layer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-layer.js","sourceRoot":"","sources":["../../../../../../src/unstable/workspace/read-model/__fixtures__/test-layer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,YAAY,EAA0C,MAAM,cAAc,CAAC;AAmBpF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,IAAiB,EACjB,UAAyC,EAAE,EAI3C,EAAE,CACF,KAAK,CAAC,MAAM,CACV,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5F,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,GAAG,CAAC;IAC/C,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,wBAAwB,EAAE;QAC1D,WAAW,EAAE,IAAI,CAAC,aAAa;QAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,WAAW;KACZ,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,QAAQ,CACnB,OAAO,EACP,SAAS,EACT,WAAW,EACX,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CACrD,CAAC;AACJ,CAAC,CAAC,CACH,CAAC"}

package/dist/src/unstable/workspace/read-model/__tests__/scenarios/_harness.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Scenario-test harness for the workspace read-model capability.
+ *
+ * Each scenario file under `__tests__/scenarios/` consumes this harness:
+ *
+ * - `runScenario(spec, body)` builds both scopes via
+ *   {@link makeWorkspaceReadModel} against the in-memory fixture FS, exposes
+ *   them through a thin `ctx.scope(scope)` selector so scenarios can yield
+ *   from either scope, and runs `body` with the result.
+ * - `expectFirst(arr)` asserts the array is non-empty and returns its first
+ *   element, replacing the silent `if (entry === undefined) return` pattern.
+ * - `expectDiagnostics(ctx, scope, predicate)` reads the scoped diagnostics
+ *   buffer once and asserts at least one warning matches `predicate`.
+ * - `tagsOf(cause)` extracts the tagged-error `_tag` set from an `Effect.Cause`
+ *   so the ≤3-tag assertion in 10.2 stays compact.
+ *
+ * The harness is a leading-underscore module so vitest does not pick it up as
+ * a test file.
+ */
+import * as Cause from "effect/Cause";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Result from "effect/Result";
+import type { WorkspaceReadModelTestOptions } from "../../__fixtures__/test-layer.js";
+import type { FixtureSpec, PathEscapeError } from "../../__fixtures__/builder.js";
+import type { Warning } from "../../diagnostics.js";
+import type { WorkspaceRootEscape } from "../../errors.js";
+import { type WorkspaceReadModel } from "../../service.js";
+import type { Scope } from "../../types.js";
+/**
+ * Scenario-side wrapper exposing both scopes through a `scope(scope)`
+ * selector. Both scopes are pre-built via {@link makeWorkspaceReadModel} so
+ * scenarios can yield from either scope freely. The selector returns a
+ * memoized {@link WorkspaceReadModel} per scope.
+ */
+export interface WorkspaceReadModelScenarioCtx {
+    readonly scope: (scope: Scope) => WorkspaceReadModel;
+}
+/**
+ * Default workspace and user-home roots used by scenario specs. Tests may
+ * override per-spec by passing different values when constructing a
+ * `FixtureSpec`.
+ */
+export declare const SCENARIO_WORKSPACE_ROOT = "/scenario/workspace";
+export declare const SCENARIO_USER_HOME = "/scenario/home";
+/**
+ * Build per-scope read models against the supplied fixture spec, provide them
+ * to `body`, and run the resulting effect. Both scopes are constructed
+ * eagerly so the body can yield from either scope without re-running the
+ * factory.
+ *
+ * The body's `E` channel is preserved through to the harness's return type
+ * so scenario tests can `yield*` source-backed cells (which fail with
+ * `SettingsReadError` / `LockfileReadError`) directly without wrapping every
+ * call site in `Effect.result`.
+ */
+export declare const runScenario: <A, E = never>(spec: FixtureSpec, body: (ctx: WorkspaceReadModelScenarioCtx) => Effect.Effect<A, E>, options?: WorkspaceReadModelTestOptions) => Effect.Effect<A, E | WorkspaceRootEscape | PathEscapeError>;
+/**
+ * Assert that `arr` is non-empty and return its first element. Replaces the
+ * silent `if (entry === undefined) return` pattern that lets a misshapen
+ * array silently pass a test.
+ */
+export declare const expectFirst: <T>(arr: ReadonlyArray<T>, message?: string) => T;
+/**
+ * Assert that `option` is `Option.Some` and return its inner value. Replaces
+ * the `expect(Option.isSome(opt)).toBe(true); if (!Option.isSome(opt)) return;`
+ * pattern that loses the failure message and lets misshapen values silently
+ * pass a test.
+ */
+export declare const expectSome: <T>(option: Option.Option<T>, message?: string) => T;
+/**
+ * Assert that `result` is a `Result.Success` and return its success value.
+ * Replaces `expect(result._tag).toBe("Success"); if (result._tag === ...)`
+ * narrowing chains.
+ */
+export declare const expectSuccess: <A, E>(result: Result.Result<A, E>, message?: string) => A;
+/**
+ * Assert that `result` is a `Result.Failure` and return its failure value.
+ * Replaces `expect(result._tag).toBe("Failure"); if (result._tag === ...)`
+ * narrowing chains.
+ */
+export declare const expectFailure: <A, E>(result: Result.Result<A, E>, message?: string) => E;
+/**
+ * Extract the set of tagged-error `_tag` values reachable inside a `Cause`.
+ * Used for the ≤3-tag-per-cell quality constraint assertion.
+ */
+export declare const tagsOf: <E>(cause: Cause.Cause<E>) => ReadonlySet<string>;
+/**
+ * Read the scoped diagnostics buffer once and assert at least one warning
+ * matches `predicate`. Returns the matching warnings so callers can chain
+ * additional assertions.
+ */
+export declare const expectDiagnostics: (ctx: WorkspaceReadModelScenarioCtx, scope: Scope, predicate: (warning: Warning) => boolean) => Effect.Effect<ReadonlyArray<Warning>>;
+/**
+ * Snapshot the scoped diagnostics buffer without asserting. Useful when a
+ * scenario wants to verify the absence of a warning class.
+ */
+export declare const readDiagnostics: (ctx: WorkspaceReadModelScenarioCtx, scope: Scope) => Effect.Effect<ReadonlyArray<Warning>>;
+//# sourceMappingURL=_harness.d.ts.map

package/dist/src/unstable/workspace/read-model/__tests__/scenarios/_harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_harness.d.ts","sourceRoot":"","sources":["../../../../../../../src/unstable/workspace/read-model/__tests__/scenarios/_harness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AAEtF,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAA0B,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,kBAAkB,CAAC;CACtD;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAC7D,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,CAAC,GAAG,KAAK,EACtC,MAAM,WAAW,EACjB,MAAM,CAAC,GAAG,EAAE,6BAA6B,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EACjE,UAAU,6BAA6B,KACtC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,mBAAmB,GAAG,eAAe,CAQG,CAAC;AAEjE;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,UAAU,MAAM,KAAG,CAMxE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,MAAM,KAAG,CAK1E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,MAAM,KAAG,CAKnF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,MAAM,KAAG,CAKnF,CAAC;AAWF;;;GAGG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAG,WAAW,CAAC,MAAM,CAUnE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,KAAK,6BAA6B,EAClC,OAAO,KAAK,EACZ,WAAW,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,KACvC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAMnC,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,KAAK,6BAA6B,EAClC,OAAO,KAAK,KACX,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAiC,CAAC"}

package/dist/src/unstable/workspace/read-model/__tests__/scenarios/_harness.js

@@ -0,0 +1,141 @@
+/**
+ * Scenario-test harness for the workspace read-model capability.
+ *
+ * Each scenario file under `__tests__/scenarios/` consumes this harness:
+ *
+ * - `runScenario(spec, body)` builds both scopes via
+ *   {@link makeWorkspaceReadModel} against the in-memory fixture FS, exposes
+ *   them through a thin `ctx.scope(scope)` selector so scenarios can yield
+ *   from either scope, and runs `body` with the result.
+ * - `expectFirst(arr)` asserts the array is non-empty and returns its first
+ *   element, replacing the silent `if (entry === undefined) return` pattern.
+ * - `expectDiagnostics(ctx, scope, predicate)` reads the scoped diagnostics
+ *   buffer once and asserts at least one warning matches `predicate`.
+ * - `tagsOf(cause)` extracts the tagged-error `_tag` set from an `Effect.Cause`
+ *   so the ≤3-tag assertion in 10.2 stays compact.
+ *
+ * The harness is a leading-underscore module so vitest does not pick it up as
+ * a test file.
+ */
+import { expect } from "@effect/vitest";
+import * as Cause from "effect/Cause";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Result from "effect/Result";
+import { WorkspaceReadModelTest } from "../../__fixtures__/test-layer.js";
+import { makeWorkspaceReadModel } from "../../service.js";
+/**
+ * Default workspace and user-home roots used by scenario specs. Tests may
+ * override per-spec by passing different values when constructing a
+ * `FixtureSpec`.
+ */
+export const SCENARIO_WORKSPACE_ROOT = "/scenario/workspace";
+export const SCENARIO_USER_HOME = "/scenario/home";
+/**
+ * Build per-scope read models against the supplied fixture spec, provide them
+ * to `body`, and run the resulting effect. Both scopes are constructed
+ * eagerly so the body can yield from either scope without re-running the
+ * factory.
+ *
+ * The body's `E` channel is preserved through to the harness's return type
+ * so scenario tests can `yield*` source-backed cells (which fail with
+ * `SettingsReadError` / `LockfileReadError`) directly without wrapping every
+ * call site in `Effect.result`.
+ */
+export const runScenario = (spec, body, options) => Effect.gen(function* () {
+    const project = yield* makeWorkspaceReadModel("project");
+    const user = yield* makeWorkspaceReadModel("user");
+    const ctx = {
+        scope: (scope) => (scope === "project" ? project : user),
+    };
+    return yield* body(ctx);
+}).pipe(Effect.provide(WorkspaceReadModelTest(spec, options)));
+/**
+ * Assert that `arr` is non-empty and return its first element. Replaces the
+ * silent `if (entry === undefined) return` pattern that lets a misshapen
+ * array silently pass a test.
+ */
+export const expectFirst = (arr, message) => {
+    const value = arr[0];
+    if (value === undefined) {
+        throw new Error(message ?? "expectFirst: array is empty");
+    }
+    return value;
+};
+/**
+ * Assert that `option` is `Option.Some` and return its inner value. Replaces
+ * the `expect(Option.isSome(opt)).toBe(true); if (!Option.isSome(opt)) return;`
+ * pattern that loses the failure message and lets misshapen values silently
+ * pass a test.
+ */
+export const expectSome = (option, message) => {
+    if (!Option.isSome(option)) {
+        throw new Error(message ?? "expectSome: option is None");
+    }
+    return option.value;
+};
+/**
+ * Assert that `result` is a `Result.Success` and return its success value.
+ * Replaces `expect(result._tag).toBe("Success"); if (result._tag === ...)`
+ * narrowing chains.
+ */
+export const expectSuccess = (result, message) => {
+    if (!Result.isSuccess(result)) {
+        throw new Error(message ?? `expectSuccess: result is Failure`);
+    }
+    return result.success;
+};
+/**
+ * Assert that `result` is a `Result.Failure` and return its failure value.
+ * Replaces `expect(result._tag).toBe("Failure"); if (result._tag === ...)`
+ * narrowing chains.
+ */
+export const expectFailure = (result, message) => {
+    if (!Result.isFailure(result)) {
+        throw new Error(message ?? `expectFailure: result is Success`);
+    }
+    return result.failure;
+};
+const hasStringTag = (value) => {
+    if (typeof value !== "object" || value === null)
+        return false;
+    if (!("_tag" in value))
+        return false;
+    // After the `in` narrowing, `value._tag` exists with type `unknown`.
+    // Compare its dynamic type without an assertion.
+    const tagValue = value._tag;
+    return typeof tagValue === "string";
+};
+/**
+ * Extract the set of tagged-error `_tag` values reachable inside a `Cause`.
+ * Used for the ≤3-tag-per-cell quality constraint assertion.
+ */
+export const tagsOf = (cause) => {
+    const tags = new Set();
+    for (const reason of cause.reasons) {
+        if (!Cause.isFailReason(reason))
+            continue;
+        const candidate = reason.error;
+        if (hasStringTag(candidate)) {
+            tags.add(candidate._tag);
+        }
+    }
+    return tags;
+};
+/**
+ * Read the scoped diagnostics buffer once and assert at least one warning
+ * matches `predicate`. Returns the matching warnings so callers can chain
+ * additional assertions.
+ */
+export const expectDiagnostics = (ctx, scope, predicate) => Effect.gen(function* () {
+    const warnings = yield* ctx.scope(scope).diagnostics;
+    const matches = warnings.filter(predicate);
+    expect(matches.length, `expected at least one warning matching predicate`).toBeGreaterThan(0);
+    return matches;
+});
+/**
+ * Snapshot the scoped diagnostics buffer without asserting. Useful when a
+ * scenario wants to verify the absence of a warning class.
+ */
+export const readDiagnostics = (ctx, scope) => ctx.scope(scope).diagnostics;
+//# sourceMappingURL=_harness.js.map

package/dist/src/unstable/workspace/read-model/__tests__/scenarios/_harness.js.map

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

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

@@ -0,0 +1,38 @@
+/**
+ * Cross-scope agent-root resolver service.
+ *
+ * Wraps the {@link AgentRootResolverState} and the snapshot of warnings
+ * emitted by {@link detectAgentRootCollisions}. Sharing one resolver across
+ * the per-scope factory ensures the heuristic-fallback warning fires at most
+ * once per agent across both scopes and both `mcp-config` / `agent-settings`
+ * scanners. Collision detection runs once at layer construction and exposes
+ * its warnings as an eager snapshot the project-scope read model seeds into
+ * its diagnostics buffer.
+ */
+import * as ServiceMap from "effect/Context";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import { type Warning } from "./diagnostics.js";
+import { type AgentRootResolverState } from "./scanners/agent-root.js";
+/** Public shape of the {@link AgentRootResolver} service. */
+export interface AgentRootResolverShape {
+    /** Shared resolver state passed to scanners that resolve agent roots. */
+    readonly state: AgentRootResolverState;
+    /**
+     * Snapshot of `scanner-config` warnings produced by
+     * {@link detectAgentRootCollisions} at layer construction. The project
+     * scope seeds these into its diagnostics buffer; the user scope does not.
+     */
+    readonly collisionWarnings: ReadonlyArray<Warning>;
+}
+declare const AgentRootResolver_base: ServiceMap.ServiceClass<AgentRootResolver, "@agentxm/client-core/unstable/workspace/read-model/agent-root-resolver/AgentRootResolver", AgentRootResolverShape>;
+/** Service tag for the cross-scope agent-root resolver. */
+export declare class AgentRootResolver extends AgentRootResolver_base {
+}
+/**
+ * Live layer for {@link AgentRootResolver}. Allocates the shared state and
+ * runs collision detection once when the layer is built.
+ */
+export declare const AgentRootResolverLive: Layer.Layer<AgentRootResolver, never, Path.Path>;
+export {};
+//# sourceMappingURL=agent-root-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-root-resolver.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/workspace/read-model/agent-root-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,UAAU,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAGpC,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,0BAA0B,CAAC;AAElC,6DAA6D;AAC7D,MAAM,WAAW,sBAAsB;IACrC,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;IACvC;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACpD;;AAED,2DAA2D;AAC3D,qBAAa,iBAAkB,SAAQ,sBAGwD;CAAG;AAElG;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAUlF,CAAC"}

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

@@ -0,0 +1,35 @@
+/**
+ * Cross-scope agent-root resolver service.
+ *
+ * Wraps the {@link AgentRootResolverState} and the snapshot of warnings
+ * emitted by {@link detectAgentRootCollisions}. Sharing one resolver across
+ * the per-scope factory ensures the heuristic-fallback warning fires at most
+ * once per agent across both scopes and both `mcp-config` / `agent-settings`
+ * scanners. Collision detection runs once at layer construction and exposes
+ * its warnings as an eager snapshot the project-scope read model seeds into
+ * its diagnostics buffer.
+ */
+import * as ServiceMap from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import * as Ref from "effect/Ref";
+import { AGENTS } from "../../agents/registry.js";
+import { makeDiagnostics } from "./diagnostics.js";
+import { detectAgentRootCollisions, makeAgentRootResolverState, } from "./scanners/agent-root.js";
+/** Service tag for the cross-scope agent-root resolver. */
+export class AgentRootResolver extends ServiceMap.Service()("@agentxm/client-core/unstable/workspace/read-model/agent-root-resolver/AgentRootResolver") {
+}
+/**
+ * Live layer for {@link AgentRootResolver}. Allocates the shared state and
+ * runs collision detection once when the layer is built.
+ */
+export const AgentRootResolverLive = Layer.effect(AgentRootResolver, Effect.gen(function* () {
+    const path = yield* Path.Path;
+    const state = makeAgentRootResolverState();
+    const ref = yield* Ref.make([]);
+    yield* detectAgentRootCollisions(path, Object.values(AGENTS), makeDiagnostics(ref));
+    const collisionWarnings = yield* Ref.get(ref);
+    return AgentRootResolver.of({ state, collisionWarnings });
+}).pipe(Effect.withSpan("workspace.read-model.agent-root-resolver.build")));
+//# sourceMappingURL=agent-root-resolver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-root-resolver.js","sourceRoot":"","sources":["../../../../../src/unstable/workspace/read-model/agent-root-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,UAAU,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,eAAe,EAAgB,MAAM,kBAAkB,CAAC;AACjE,OAAO,EACL,yBAAyB,EACzB,0BAA0B,GAE3B,MAAM,0BAA0B,CAAC;AAclC,2DAA2D;AAC3D,MAAM,OAAO,iBAAkB,SAAQ,UAAU,CAAC,OAAO,EAGtD,CAAC,0FAA0F,CAAC;CAAG;AAElG;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAqD,KAAK,CAAC,MAAM,CACjG,iBAAiB,EACjB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,MAAM,KAAK,GAAG,0BAA0B,EAAE,CAAC;IAC3C,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAyB,EAAE,CAAC,CAAC;IACxD,KAAK,CAAC,CAAC,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;IACpF,MAAM,iBAAiB,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9C,OAAO,iBAAiB,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;AAC5D,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,gDAAgD,CAAC,CAAC,CAC3E,CAAC"}

package/dist/src/unstable/workspace/read-model/agents/adal.d.ts

@@ -0,0 +1,12 @@
+/**
+ * adal agent module: typed `nativeConfig` placeholder + projectors.
+ *
+ * Per design Decision 3 + Decision 10 of the workspace read-model change. v1
+ * ships a placeholder `nativeConfig` shape; later changes can tighten the
+ * post-decode native-settings shape without touching `WorkspaceReadModel`.
+ */
+export interface AdalNativeConfig {
+    readonly agentId: "adal";
+}
+export declare const agentModule: import("./types.js").AgentModule<AdalNativeConfig, "adal">;
+//# sourceMappingURL=adal.d.ts.map

package/dist/src/unstable/workspace/read-model/agents/adal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adal.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/workspace/read-model/agents/adal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,WAAW,4DAGtB,CAAC"}

package/dist/src/unstable/workspace/read-model/agents/adal.js

@@ -0,0 +1,14 @@
+/**
+ * adal agent module: typed `nativeConfig` placeholder + projectors.
+ *
+ * Per design Decision 3 + Decision 10 of the workspace read-model change. v1
+ * ships a placeholder `nativeConfig` shape; later changes can tighten the
+ * post-decode native-settings shape without touching `WorkspaceReadModel`.
+ */
+import { descriptor } from "../../../agents/adal/descriptor.js";
+import { defineAgentModule } from "./types.js";
+export const agentModule = defineAgentModule({
+    agentId: "adal",
+    descriptor,
+});
+//# sourceMappingURL=adal.js.map

package/dist/src/unstable/workspace/read-model/agents/adal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adal.js","sourceRoot":"","sources":["../../../../../../src/unstable/workspace/read-model/agents/adal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAM/C,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAA2B;IACrE,OAAO,EAAE,MAAM;IACf,UAAU;CACX,CAAC,CAAC"}