@agentxm/client-core 0.1.6 → 0.3.1

package/dist/src/unstable/lint/catalog/workspace-accessor/interpret-ops.js

@@ -0,0 +1,311 @@
+/* eslint-disable @typescript-eslint/consistent-type-assertions */
+/**
+ * Apply per-extension `Operation` intents to a `WorkspaceState` test double.
+ *
+ * The lint determinism harness (task 3c.19) needs: given a `WorkspaceState`
+ * plus a set of autofix Operations, produce the post-apply state and re-run
+ * the rule's `check`. This module is the pure reducer that maps an
+ * Operation intent onto state mutations that approximate what the canonical
+ * `OperationHandler` would do:
+ *
+ * - `install-skill` — add a skills lock entry, ensure the canonical
+ *   `src/SKILL.md` probe exists, ensure per-declared-agent artifact paths
+ *   exist (if the skill is enabled).
+ * - `uninstall-skill` — remove the lock entry, remove the install-dir
+ *   probes, remove per-agent artifacts.
+ * - `enable-skill` / `disable-skill` — toggle per-agent artifact presence.
+ * - `install-pack` / `uninstall-pack` — add/remove the pack lock entry.
+ * - Other families (`-command`, `-mcp-server`, `-subagent`) are stubs for
+ *   the harness; today no v1 rule emits those.
+ *
+ * The reducer writes **raw JSON-compatible shapes** into
+ * `state.lockfile` — the accessor returns `LockfileDocument = unknown`, so
+ * rules decode via `LockfileSchema` locally and the harness only needs to
+ * satisfy the schema post-apply.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import { getAllAgents } from "../../../agents/registry.js";
+import { parseRegistrySource } from "../workspace/helpers/registry-source.js";
+// -----------------------------------------------------------------------------
+// Fixed-at-test-time now() — keeps lockfile `installedAt`/`updatedAt` stable.
+// -----------------------------------------------------------------------------
+const FIXED_NOW_ISO = "2026-04-21T00:00:00.000Z";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const asLockfile = (doc) => {
+    if (!isRecord(doc) || !("lockfileVersion" in doc)) {
+        return { lockfileVersion: 1, skills: {} };
+    }
+    const version = doc["lockfileVersion"];
+    const skills = doc["skills"];
+    const commands = doc["commands"];
+    const subagents = doc["subagents"];
+    const mcpServers = doc["mcpServers"];
+    const packs = doc["packs"];
+    const result = {
+        lockfileVersion: typeof version === "number" ? version : 1,
+        skills: isRecord(skills) ? { ...skills } : {},
+        ...(isRecord(commands) ? { commands: { ...commands } } : {}),
+        ...(isRecord(subagents) ? { subagents: { ...subagents } } : {}),
+        ...(isRecord(mcpServers) ? { mcpServers: { ...mcpServers } } : {}),
+        ...(isRecord(packs) ? { packs: { ...packs } } : {}),
+    };
+    return result;
+};
+const asSettings = (doc) => isRecord(doc) ? doc : undefined;
+const declaredAgents = (settings) => {
+    if (settings === undefined || settings.agents === undefined) {
+        return [];
+    }
+    const ids = new Set(settings.agents);
+    return getAllAgents().filter((a) => ids.has(a.id));
+};
+const artifactPath = (agent, skillName) => `${agent.skills.dir}/${skillName}`;
+const registrySkillProbe = (owner, name) => `.axm/extensions/${owner}/skills/${name}/src/SKILL.md`;
+const externalSkillProbe = (name) => `.axm/extensions/external/skills/${name}/SKILL.md`;
+const registryPackProbe = (owner, name) => `.axm/extensions/${owner}/packs/${name}/extension-pack.json`;
+const readEnabled = (settings, skillName) => {
+    const skills = settings?.skills;
+    if (skills === undefined) {
+        return true;
+    }
+    const entry = skills[skillName];
+    if (entry === undefined) {
+        return true;
+    }
+    if (typeof entry === "string") {
+        return true;
+    }
+    if (typeof entry === "object" && entry !== null && "enabled" in entry) {
+        const value = entry.enabled;
+        return value === undefined ? true : value === true;
+    }
+    return true;
+};
+// -----------------------------------------------------------------------------
+// Intent → state reducers
+// -----------------------------------------------------------------------------
+export const applyInstallSkill = (state, intent) => {
+    const parsed = parseRegistrySource(intent.source);
+    const settings = asSettings(state.settings);
+    const agents = declaredAgents(settings);
+    const enabled = readEnabled(settings, intent.name);
+    const lockfile = asLockfile(state.lockfile);
+    const newSkills = { ...lockfile.skills };
+    if (parsed !== undefined) {
+        newSkills[intent.name] = {
+            type: "registry",
+            owner: parsed.owner,
+            name: parsed.name,
+            resolvedVersion: parsed.versionConstraint ?? "0.0.0",
+            integrity: "sha512-stub",
+            sourceName: "default",
+            agents: agents.map((a) => a.id),
+            installedAt: FIXED_NOW_ISO,
+            updatedAt: FIXED_NOW_ISO,
+            sourceHash: "stub-source-hash",
+        };
+        state.existingPaths.add(registrySkillProbe(parsed.owner, parsed.name));
+    }
+    else {
+        newSkills[intent.name] = {
+            type: "local",
+            path: intent.source,
+            agents: agents.map((a) => a.id),
+            installedAt: FIXED_NOW_ISO,
+            updatedAt: FIXED_NOW_ISO,
+            sourceHash: "stub-source-hash",
+        };
+        state.existingPaths.add(externalSkillProbe(intent.name));
+    }
+    state.lockfile = { ...lockfile, skills: newSkills };
+    if (enabled) {
+        for (const agent of agents) {
+            const path = artifactPath(agent, intent.name);
+            state.existingPaths.add(path);
+            pushListing(state, agent.skills.dir, intent.name);
+        }
+    }
+};
+export const applyUninstallSkill = (state, intent) => {
+    const lockfile = asLockfile(state.lockfile);
+    const entry = lockfile.skills[intent.name];
+    const agents = declaredAgents(asSettings(state.settings));
+    const newSkills = { ...lockfile.skills };
+    delete newSkills[intent.name];
+    state.lockfile = { ...lockfile, skills: newSkills };
+    if (entry !== undefined && entry.type === "registry") {
+        state.existingPaths.delete(registrySkillProbe(entry.owner, intent.name));
+    }
+    else {
+        state.existingPaths.delete(externalSkillProbe(intent.name));
+    }
+    for (const agent of agents) {
+        const path = artifactPath(agent, intent.name);
+        state.existingPaths.delete(path);
+        removeFromListing(state, agent.skills.dir, intent.name);
+    }
+};
+export const applyEnableSkill = (state, intent) => {
+    const agents = declaredAgents(asSettings(state.settings));
+    for (const agent of agents) {
+        const path = artifactPath(agent, intent.name);
+        state.existingPaths.add(path);
+        pushListing(state, agent.skills.dir, intent.name);
+    }
+    setEnabled(state, intent.name, true);
+};
+export const applyDisableSkill = (state, intent) => {
+    const agents = declaredAgents(asSettings(state.settings));
+    for (const agent of agents) {
+        const path = artifactPath(agent, intent.name);
+        state.existingPaths.delete(path);
+        removeFromListing(state, agent.skills.dir, intent.name);
+    }
+    setEnabled(state, intent.name, false);
+};
+const setEnabled = (state, name, enabled) => {
+    const settings = asSettings(state.settings);
+    if (settings?.skills === undefined) {
+        return;
+    }
+    const entry = settings.skills[name];
+    if (entry === undefined) {
+        return;
+    }
+    const newEntry = typeof entry === "string"
+        ? enabled
+            ? entry
+            : { source: entry, enabled: false }
+        : {
+            ...entry,
+            enabled,
+        };
+    const nextSkills = { ...settings.skills, [name]: newEntry };
+    state.settings = { ...settings, skills: nextSkills };
+};
+export const applyInstallPack = (state, intent) => {
+    const parsed = parseRegistrySource(intent.source);
+    if (parsed === undefined) {
+        return;
+    }
+    const lockfile = asLockfile(state.lockfile);
+    const nextPacks = {
+        ...(lockfile.packs ?? {}),
+        [intent.name]: {
+            type: "registry",
+            owner: parsed.owner,
+            name: parsed.name,
+            resolvedVersion: parsed.versionConstraint ?? "0.0.0",
+            integrity: "sha512-stub",
+            sourceName: "default",
+            installedAt: FIXED_NOW_ISO,
+            updatedAt: FIXED_NOW_ISO,
+            resolvedSkills: {},
+            resolvedCommands: {},
+            resolvedMcpServers: {},
+            resolvedSubagents: {},
+        },
+    };
+    state.lockfile = { ...lockfile, packs: nextPacks };
+    state.existingPaths.add(registryPackProbe(parsed.owner, parsed.name));
+};
+export const applyUninstallPack = (state, intent) => {
+    const lockfile = asLockfile(state.lockfile);
+    const packs = lockfile.packs ?? {};
+    const entry = packs[intent.name];
+    const nextPacks = { ...packs };
+    delete nextPacks[intent.name];
+    state.lockfile = { ...lockfile, packs: nextPacks };
+    if (entry !== undefined && entry.type === "registry") {
+        state.existingPaths.delete(registryPackProbe(entry.owner, intent.name));
+    }
+};
+// -----------------------------------------------------------------------------
+// Bulk dispatcher
+// -----------------------------------------------------------------------------
+// Narrow-by-predicate helpers — keep the `op.args` cast colocated with
+// runtime validation so the rest of the reducer can trust the narrowed
+// shape without further assertions.
+const isInstallSkillIntent = (args) => typeof args === "object" &&
+    args !== null &&
+    typeof args.name === "string" &&
+    typeof args.source === "string" &&
+    typeof args.force === "boolean";
+const isUninstallSkillIntent = (args) => typeof args === "object" &&
+    args !== null &&
+    typeof args.name === "string";
+const isEnableSkillIntent = (args) => isUninstallSkillIntent(args);
+const isDisableSkillIntent = (args) => isUninstallSkillIntent(args);
+const isInstallPackIntent = (args) => isInstallSkillIntent(args);
+const isUninstallPackIntent = (args) => isUninstallSkillIntent(args);
+export const applyOperationIntent = (state, op) => {
+    switch (op.name) {
+        case "install-skill":
+            if (isInstallSkillIntent(op.args)) {
+                applyInstallSkill(state, op.args);
+            }
+            return;
+        case "uninstall-skill":
+            if (isUninstallSkillIntent(op.args)) {
+                applyUninstallSkill(state, op.args);
+            }
+            return;
+        case "enable-skill":
+            if (isEnableSkillIntent(op.args)) {
+                applyEnableSkill(state, op.args);
+            }
+            return;
+        case "disable-skill":
+            if (isDisableSkillIntent(op.args)) {
+                applyDisableSkill(state, op.args);
+            }
+            return;
+        case "install-pack":
+            if (isInstallPackIntent(op.args)) {
+                applyInstallPack(state, op.args);
+            }
+            return;
+        case "uninstall-pack":
+            if (isUninstallPackIntent(op.args)) {
+                applyUninstallPack(state, op.args);
+            }
+            return;
+        case "install-command":
+        case "uninstall-command":
+        case "enable-command":
+        case "disable-command":
+        case "install-mcp-server":
+        case "uninstall-mcp-server":
+        case "enable-subagent":
+        case "disable-subagent":
+            return;
+        default:
+            throw new Error(`applyOperationIntent: unknown operation '${op.name}'`);
+    }
+};
+// -----------------------------------------------------------------------------
+// Listing helpers
+// -----------------------------------------------------------------------------
+const pushListing = (state, dir, child) => {
+    const existing = state.listings.get(dir);
+    if (existing === undefined) {
+        state.listings.set(dir, [child]);
+        return;
+    }
+    if (!existing.includes(child)) {
+        existing.push(child);
+    }
+};
+const removeFromListing = (state, dir, child) => {
+    const existing = state.listings.get(dir);
+    if (existing === undefined) {
+        return;
+    }
+    const idx = existing.indexOf(child);
+    if (idx !== -1) {
+        existing.splice(idx, 1);
+    }
+};
+//# sourceMappingURL=interpret-ops.js.map

package/dist/src/unstable/lint/catalog/workspace-accessor/interpret-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpret-ops.js","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/workspace-accessor/interpret-ops.ts"],"names":[],"mappings":"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"}

package/dist/src/unstable/lint/catalog/workspace-accessor/platform.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Platform-backed `WorkspaceLintAccessor`.
+ *
+ * Reads `.axm/settings.json`, `.axm/axm-lock.yaml`, and workspace-relative
+ * filesystem probes from a caller-supplied workspace root. Surfaces ONLY the
+ * nine documented methods (task 3c.2):
+ *
+ *   `settings`, `lockfile`, `installedSkills`, `installedPacks`,
+ *   `knownAgents`, `detectAgents`, `exists`, `isWritable`, `list`.
+ *
+ * No Layer wiring at rule-evaluation time — the factory captures
+ * `FileSystem.FileSystem` + `Path.Path` plus the provided `WorkspaceIndex`.
+ *
+ * Agent-detection derives probes from the existing `AgentDescriptor`
+ * catalog (`packages/core/src/unstable/agents/types.ts`); the rule does not
+ * re-invent probe derivation.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import type * as FileSystem from "effect/FileSystem";
+import type * as Path from "effect/Path";
+import type { PackRuleContext, SkillRuleContext, WorkspaceLintAccessor } from "../../context.js";
+/**
+ * Minimal shape the workspace accessor requires to compute `installedSkills`
+ * and `installedPacks`. Phase 3c's `WorkspaceIndex` (see `./contexts.ts`)
+ * satisfies this by construction.
+ */
+export interface WorkspaceIndexView {
+    readonly installedSkills: Effect.Effect<ReadonlyArray<SkillRuleContext>>;
+    readonly installedPacks: Effect.Effect<ReadonlyArray<PackRuleContext>>;
+}
+/**
+ * Platform services required by `makePlatformWorkspaceLintAccessor`.
+ */
+export interface WorkspaceAccessorPlatform {
+    readonly fs: FileSystem.FileSystem;
+    readonly path: Path.Path;
+}
+/** Factory arguments. */
+export interface PlatformWorkspaceLintAccessorArgs {
+    readonly platform: WorkspaceAccessorPlatform;
+    /** Absolute path to the workspace root (directory containing `.axm/`). */
+    readonly workspaceRoot: string;
+    /**
+     * Workspace index exposing `installedSkills` and `installedPacks` rule
+     * contexts. Usually produced by `buildWorkspaceIndex` in `./contexts.ts`.
+     */
+    readonly index: WorkspaceIndexView;
+    /** Scope of the accessor for `detectAgents` routing. */
+    readonly scope: "project" | "user";
+}
+/**
+ * Build a platform-backed `WorkspaceLintAccessor` rooted at `workspaceRoot`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const makePlatformWorkspaceLintAccessor: (args: PlatformWorkspaceLintAccessorArgs) => WorkspaceLintAccessor;
+//# sourceMappingURL=platform.d.ts.map

package/dist/src/unstable/lint/catalog/workspace-accessor/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/workspace-accessor/platform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;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,EAKV,eAAe,EAGf,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,kBAAkB,CAAC;AAQ1B;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACzE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC;CACxE;AAMD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,UAAU,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;CAC1B;AAED,yBAAyB;AACzB,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAC7C,0EAA0E;IAC1E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;CACpC;AASD;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,GAC5C,MAAM,iCAAiC,KACtC,qBA8LF,CAAC"}

package/dist/src/unstable/lint/catalog/workspace-accessor/platform.js

@@ -0,0 +1,201 @@
+/**
+ * Platform-backed `WorkspaceLintAccessor`.
+ *
+ * Reads `.axm/settings.json`, `.axm/axm-lock.yaml`, and workspace-relative
+ * filesystem probes from a caller-supplied workspace root. Surfaces ONLY the
+ * nine documented methods (task 3c.2):
+ *
+ *   `settings`, `lockfile`, `installedSkills`, `installedPacks`,
+ *   `knownAgents`, `detectAgents`, `exists`, `isWritable`, `list`.
+ *
+ * No Layer wiring at rule-evaluation time — the factory captures
+ * `FileSystem.FileSystem` + `Path.Path` plus the provided `WorkspaceIndex`.
+ *
+ * Agent-detection derives probes from the existing `AgentDescriptor`
+ * catalog (`packages/core/src/unstable/agents/types.ts`); the rule does not
+ * re-invent probe derivation.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import YAML from "yaml";
+import { getAllAgents } from "../../../agents/registry.js";
+const SETTINGS_REL_PATH = ".axm/settings.json";
+const LOCKFILE_REL_PATH = ".axm/axm-lock.yaml";
+/**
+ * Build a platform-backed `WorkspaceLintAccessor` rooted at `workspaceRoot`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const makePlatformWorkspaceLintAccessor = (args) => {
+    const { platform, workspaceRoot, index, scope } = args;
+    const { fs, path } = platform;
+    const root = path.resolve(workspaceRoot);
+    const resolveWithinRoot = (input) => {
+        if (input === "" || input === "." || input === "./") {
+            return { kind: "ok", absolute: root };
+        }
+        if (/^[a-z]:[\\/]/i.test(input) || input.startsWith("/") || input.startsWith("\\")) {
+            return { kind: "escape" };
+        }
+        const normalized = input.replace(/\\/g, "/").replace(/^\.\//, "");
+        for (const segment of normalized.split("/")) {
+            if (segment === "..") {
+                return { kind: "escape" };
+            }
+        }
+        const absolute = path.resolve(root, normalized);
+        if (absolute !== root && !absolute.startsWith(`${root}${path.sep}`)) {
+            return { kind: "escape" };
+        }
+        return { kind: "ok", absolute };
+    };
+    const makeAccessError = (p, reason, message) => ({
+        _tag: "FileAccessError",
+        path: p,
+        reason,
+        message,
+    });
+    const exists = (relative) => {
+        const resolved = resolveWithinRoot(relative);
+        if (resolved.kind !== "ok") {
+            return Effect.succeed(false);
+        }
+        return fs.exists(resolved.absolute).pipe(Effect.catch(() => Effect.succeed(false)));
+    };
+    const isWritable = (relative) => {
+        const resolved = resolveWithinRoot(relative);
+        if (resolved.kind !== "ok") {
+            return Effect.succeed(false);
+        }
+        return fs.access(resolved.absolute, { writable: true }).pipe(Effect.map(() => true), Effect.catch(() => Effect.succeed(false)));
+    };
+    const list = (relative) => {
+        const resolved = resolveWithinRoot(relative);
+        if (resolved.kind === "escape") {
+            return Effect.fail(makeAccessError(relative, "path-escape", `path escapes the accessor root: ${relative}`));
+        }
+        return fs
+            .readDirectory(resolved.absolute)
+            .pipe(Effect.mapError((cause) => makeAccessError(relative, "read-error", `directory list failed at ${relative}: ${String(cause)}`)));
+    };
+    const parseSettingsRaw = (raw) => Effect.try({
+        try: () => JSON.parse(raw),
+        catch: (cause) => ({
+            _tag: "SettingsReadError",
+            message: `JSON parse failed: ${String(cause)}`,
+        }),
+    });
+    const settings = Effect.gen(function* () {
+        const resolved = resolveWithinRoot(SETTINGS_REL_PATH);
+        if (resolved.kind !== "ok") {
+            return yield* Effect.fail({
+                _tag: "SettingsReadError",
+                message: "settings.json path is outside the workspace root",
+            });
+        }
+        const raw = yield* fs.readFileString(resolved.absolute).pipe(Effect.mapError((cause) => ({
+            _tag: "SettingsReadError",
+            message: `read failed: ${String(cause)}`,
+        })));
+        return yield* parseSettingsRaw(raw);
+    });
+    const parseLockfileRaw = (raw) => Effect.try({
+        try: () => Option.some(YAML.parse(raw)),
+        catch: (cause) => ({
+            _tag: "LockfileReadError",
+            message: `YAML parse failed: ${String(cause)}`,
+        }),
+    });
+    const lockfile = Effect.gen(function* () {
+        const resolved = resolveWithinRoot(LOCKFILE_REL_PATH);
+        if (resolved.kind !== "ok") {
+            return yield* Effect.fail({
+                _tag: "LockfileReadError",
+                message: "axm-lock.yaml path is outside the workspace root",
+            });
+        }
+        const lockExists = yield* fs
+            .exists(resolved.absolute)
+            .pipe(Effect.catch(() => Effect.succeed(false)));
+        if (!lockExists) {
+            return Option.none();
+        }
+        const raw = yield* fs.readFileString(resolved.absolute).pipe(Effect.mapError((cause) => ({
+            _tag: "LockfileReadError",
+            message: `read failed: ${String(cause)}`,
+        })));
+        return yield* parseLockfileRaw(raw);
+    });
+    const knownAgents = Effect.sync(() => getAllAgents());
+    const detectAgents = (detectScope) => {
+        if (detectScope !== scope) {
+            // Honor the caller's requested scope even when the accessor was
+            // bound to a different one — this is informational only.
+            return Effect.succeed([]);
+        }
+        const agents = getAllAgents();
+        return Effect.all(agents.map((agent) => detectOne(agent).pipe(Effect.map((detection) => detection === undefined ? [] : [detection]))), { concurrency: "unbounded" }).pipe(Effect.map((results) => results.flat()));
+    };
+    const detectOne = (agent) => Effect.gen(function* () {
+        for (const segment of detectionProbes(agent)) {
+            const probeAbs = path.resolve(root, segment);
+            const present = yield* fs.exists(probeAbs).pipe(Effect.catch(() => Effect.succeed(false)));
+            if (present) {
+                return { id: agent.id, markerPath: segment };
+            }
+        }
+        return undefined;
+    });
+    return {
+        settings,
+        lockfile,
+        installedSkills: index.installedSkills,
+        installedPacks: index.installedPacks,
+        knownAgents,
+        detectAgents,
+        exists,
+        isWritable,
+        list,
+    };
+};
+// -----------------------------------------------------------------------------
+// Probe derivation
+// -----------------------------------------------------------------------------
+const firstPathSegment = (dir) => {
+    if (dir === undefined || dir === "") {
+        return undefined;
+    }
+    const segment = dir.split("/")[0];
+    return segment === undefined || segment.length === 0 ? undefined : segment;
+};
+/**
+ * Derive detection probes for an agent by taking the first path segment of
+ * its `skills.dir` / `commands.dir` / `subagents.dir`, plus the single-file
+ * probe when `subagents.isFile === true`.
+ *
+ * Mirrors axm `agents/detection.ts:35-44` — staying in lockstep with the
+ * canonical detection so the rule and the CLI detector agree.
+ */
+const detectionProbes = (agent) => {
+    const segments = new Set();
+    const skills = firstPathSegment(agent.skills.dir);
+    if (skills !== undefined) {
+        segments.add(skills);
+    }
+    const commands = firstPathSegment(agent.commands?.dir);
+    if (commands !== undefined) {
+        segments.add(commands);
+    }
+    const subagents = firstPathSegment(agent.subagents?.dir);
+    if (subagents !== undefined) {
+        segments.add(subagents);
+    }
+    if (agent.subagents?.isFile === true && agent.subagents.dir !== undefined) {
+        segments.add(agent.subagents.dir);
+    }
+    return Array.from(segments);
+};
+//# sourceMappingURL=platform.js.map

package/dist/src/unstable/lint/catalog/workspace-accessor/platform.js.map

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