@agentxm/client-core 0.2.0 → 0.3.2

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

@@ -0,0 +1,89 @@
+/**
+ * Platform-backed `SkillFileAccessor` for `axm lint`.
+ *
+ * Maps accessor-relative posix paths to on-disk absolute paths rooted at
+ * the caller-supplied skill-root directory. Layout conventions per
+ * `docs/design/lint-engine.md §3` "Skill accessor root":
+ *
+ * - **Native (registry-installed):**
+ *   `<workspaceRoot>/.axm/extensions/<@owner>/skills/<sanitized-name>/src/`
+ * - **Non-native (managed external):**
+ *   `<workspaceRoot>/.axm/extensions/external/skills/<sanitized-name>/`
+ *
+ * The accessor is provenance-agnostic — rules see one uniform contract and
+ * never branch on native-vs-non-native. The caller (`buildSkillRuleContexts`
+ * or the CLI entry point) picks the root.
+ *
+ * Bounds enforcement:
+ *
+ * - No `..` segments in accessor-relative paths.
+ * - No absolute paths (posix or Windows drive letters).
+ * - Resolved absolute paths are verified to stay under the accessor root.
+ *
+ * The accessor is built via a factory that captures a pre-resolved
+ * `FileSystem.FileSystem` + `Path.Path` services and an absolute root, so
+ * `SkillFileAccessor` stays Layer-free at rule-evaluation time (per
+ * `lint-engine` spec "Rule contexts expose narrow caller-bound accessors").
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+/**
+ * Build a platform-backed `SkillFileAccessor` rooted at `absoluteRoot`.
+ *
+ * `absoluteRoot` SHOULD be the absolute path to the skill root directory
+ * (either `.../src/` for native, or `.../external/skills/<name>/` for
+ * non-native). The caller typically sources it from `computeSkillPaths` in
+ * `../../../skills/paths.ts`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const makePlatformSkillFileAccessor = (platform, absoluteRoot) => {
+    const { fs, path } = platform;
+    const normalizedRoot = path.resolve(absoluteRoot);
+    const resolveWithinRoot = (input) => {
+        if (input === "" || input === "." || input === "./") {
+            return { kind: "ok", absolute: normalizedRoot };
+        }
+        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(normalizedRoot, normalized);
+        if (absolute !== normalizedRoot && !absolute.startsWith(`${normalizedRoot}${path.sep}`)) {
+            return { kind: "escape" };
+        }
+        return { kind: "ok", absolute };
+    };
+    const makeAccessError = (p, reason, message) => ({
+        _tag: "FileAccessError",
+        path: p,
+        reason,
+        message,
+    });
+    return {
+        exists: (p) => {
+            const resolved = resolveWithinRoot(p);
+            if (resolved.kind !== "ok") {
+                return Effect.succeed(false);
+            }
+            return fs.exists(resolved.absolute).pipe(Effect.catch(() => Effect.succeed(false)));
+        },
+        readBytes: (p) => {
+            const resolved = resolveWithinRoot(p);
+            if (resolved.kind === "escape") {
+                return Effect.fail(makeAccessError(p, "path-escape", `path escapes the accessor root: ${p}`));
+            }
+            return fs
+                .readFile(resolved.absolute)
+                .pipe(Effect.mapError((cause) => makeAccessError(p, "read-error", `read failed at ${p}: ${String(cause)}`)));
+        },
+    };
+};
+//# sourceMappingURL=platform.js.map

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

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

package/dist/src/unstable/lint/catalog/skill-accessor/vft.d.ts

@@ -0,0 +1,58 @@
+/**
+ * VFT-backed `SkillFileAccessor` for publish callers.
+ *
+ * A Virtual File Tree (VFT) is an in-memory representation of an extracted
+ * archive — the registry publish pipeline extracts an upload into a VFT, then
+ * passes that tree into Phase 4 decode/lint. The VFT's schema and bounds
+ * (max size, file count, path depth) are owned by the registry extract phase
+ * (Phase 4 concern); this accessor treats the tree as a read-only
+ * `path -> Uint8Array` map and enforces its own rooted-read + no-`..`-escape
+ * invariants at the rule boundary.
+ *
+ * Bounds enforcement here:
+ *
+ * - Paths are normalized to posix, `./` prefixes are stripped.
+ * - Empty path resolves to the accessor root itself (useful for
+ *   `location.file = ""` findings but not currently exercised by the v1
+ *   catalog).
+ * - Any path containing a `..` segment raises `FileAccessError {
+ *   reason: "path-escape" }` from `readBytes` and resolves to `false` from
+ *   `exists`.
+ * - Absolute paths (starting with `/` or a Windows drive letter) are
+ *   treated as escape attempts.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { SkillFileAccessor } from "../../context.js";
+/**
+ * Minimal shape of a Virtual File Tree consumed by the accessor.
+ *
+ * The registry VFT (Phase 4, this-repo) MUST satisfy this interface. The
+ * registry may (and will) expose additional methods — file count, archive
+ * bounds, iteration — but those are the extract phase's concern.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface VFTNode {
+    /**
+     * Whether the given posix path points to a file within the tree.
+     */
+    readonly hasFile: (posixPath: string) => boolean;
+    /**
+     * Return the bytes for the given posix path, or `undefined` when the path
+     * does not resolve to a file (missing, directory, or outside the tree).
+     */
+    readonly getFile: (posixPath: string) => Uint8Array | undefined;
+}
+/**
+ * Build a VFT-backed `SkillFileAccessor` rooted at the tree's root.
+ *
+ * Callers that root the skill at a sub-path of the archive should pre-strip
+ * that sub-path before constructing the tree — the accessor enforces no
+ * `..` escape above the root it was given.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const makeVftSkillFileAccessor: (tree: VFTNode) => SkillFileAccessor;
+//# sourceMappingURL=vft.d.ts.map

package/dist/src/unstable/lint/catalog/skill-accessor/vft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vft.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/skill-accessor/vft.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,KAAK,EAAmB,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAM3E;;;;;;;;GAQG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACjD;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,UAAU,GAAG,SAAS,CAAC;CACjE;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,GAAI,MAAM,OAAO,KAAG,iBAqBxD,CAAC"}

package/dist/src/unstable/lint/catalog/skill-accessor/vft.js

@@ -0,0 +1,83 @@
+/**
+ * VFT-backed `SkillFileAccessor` for publish callers.
+ *
+ * A Virtual File Tree (VFT) is an in-memory representation of an extracted
+ * archive — the registry publish pipeline extracts an upload into a VFT, then
+ * passes that tree into Phase 4 decode/lint. The VFT's schema and bounds
+ * (max size, file count, path depth) are owned by the registry extract phase
+ * (Phase 4 concern); this accessor treats the tree as a read-only
+ * `path -> Uint8Array` map and enforces its own rooted-read + no-`..`-escape
+ * invariants at the rule boundary.
+ *
+ * Bounds enforcement here:
+ *
+ * - Paths are normalized to posix, `./` prefixes are stripped.
+ * - Empty path resolves to the accessor root itself (useful for
+ *   `location.file = ""` findings but not currently exercised by the v1
+ *   catalog).
+ * - Any path containing a `..` segment raises `FileAccessError {
+ *   reason: "path-escape" }` from `readBytes` and resolves to `false` from
+ *   `exists`.
+ * - Absolute paths (starting with `/` or a Windows drive letter) are
+ *   treated as escape attempts.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+/**
+ * Build a VFT-backed `SkillFileAccessor` rooted at the tree's root.
+ *
+ * Callers that root the skill at a sub-path of the archive should pre-strip
+ * that sub-path before constructing the tree — the accessor enforces no
+ * `..` escape above the root it was given.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const makeVftSkillFileAccessor = (tree) => {
+    return {
+        exists: (path) => {
+            const normalized = normalizeAndCheck(path);
+            if (normalized.kind !== "ok") {
+                return Effect.succeed(false);
+            }
+            return Effect.succeed(tree.hasFile(normalized.path));
+        },
+        readBytes: (path) => {
+            const normalized = normalizeAndCheck(path);
+            if (normalized.kind === "escape") {
+                return failFileAccess(path, "path-escape", `path escapes the accessor root: ${path}`);
+            }
+            const bytes = tree.getFile(normalized.path);
+            if (bytes === undefined) {
+                return failFileAccess(path, "read-error", `file not found at ${path}`);
+            }
+            return Effect.succeed(bytes);
+        },
+    };
+};
+const normalizeAndCheck = (path) => {
+    if (path === "" || path === "." || path === "./") {
+        return { kind: "ok", path: "" };
+    }
+    // Windows drive letters (`C:/`) and absolute posix paths both count as
+    // escape attempts at a skill-rooted accessor.
+    if (/^[a-z]:[\\/]/i.test(path) || path.startsWith("/") || path.startsWith("\\")) {
+        return { kind: "escape" };
+    }
+    const normalized = path.replace(/\\/g, "/").replace(/^\.\//, "");
+    const segments = normalized.split("/");
+    for (const segment of segments) {
+        if (segment === "..") {
+            return { kind: "escape" };
+        }
+    }
+    return { kind: "ok", path: normalized };
+};
+const failFileAccess = (path, reason, message) => Effect.fail({
+    _tag: "FileAccessError",
+    path,
+    reason,
+    message,
+});
+//# sourceMappingURL=vft.js.map

package/dist/src/unstable/lint/catalog/skill-accessor/vft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vft.js","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/skill-accessor/vft.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AA4BxC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,IAAa,EAAqB,EAAE;IAC3E,OAAO;QACL,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACf,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,UAAU,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBAC7B,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;YACD,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;YAClB,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACjC,OAAO,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,mCAAmC,IAAI,EAAE,CAAC,CAAC;YACxF,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,qBAAqB,IAAI,EAAE,CAAC,CAAC;YACzE,CAAC;YACD,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAQF,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAmB,EAAE;IAC1D,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QACjD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAClC,CAAC;IACD,uEAAuE;IACvE,8CAA8C;IAC9C,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAChF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5B,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAC1C,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CACrB,IAAY,EACZ,MAAiC,EACjC,OAAe,EAC6B,EAAE,CAC9C,MAAM,CAAC,IAAI,CAAC;IACV,IAAI,EAAE,iBAA0B;IAChC,IAAI;IACJ,MAAM;IACN,OAAO;CACR,CAAC,CAAC"}

package/dist/src/unstable/lint/catalog/skill.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `skill/*` rule catalog — the v1 five-rule set.
+ *
+ * Per `docs/design/lint-engine.md §10.skill`, registry publish and `axm lint`
+ * run exactly these rules against each skill context:
+ *
+ * | ID                               | Severity | Autofix |
+ * | -------------------------------- | -------- | ------- |
+ * | `skill/skill-md-present`         | error    | —       |
+ * | `skill/manifest-present`         | error    | —       |
+ * | `skill/frontmatter-parseable`    | error    | —       |
+ * | `skill/manifest-schema-valid`    | error    | —       |
+ * | `skill/manifest-keys-recognized` | warning  | —       |
+ *
+ * All five ship `kind: "advisory"`. Native-vs-non-native applicability is
+ * expressed via `check` early-return (no separate `applies` predicate); see
+ * each rule's module for the guard.
+ *
+ * Rule ids are **registered with the lint config allowlist at module-load
+ * time**, so importing this catalog extends the set of accepted
+ * `.axm/settings.json` `lint.rules` keys. Consumers that never import the
+ * catalog (the registry Worker bundle for `pack`-only routes, e.g.) don't pay
+ * the registration cost.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { LintRule } from "../rule.js";
+import type { SkillRuleContext } from "../context.js";
+/**
+ * Ordered v1 `skill/*` rule catalog. Declaration order is the evaluation
+ * order within a single `evaluateContexts` call (deterministic ordering is
+ * test-observable; see `evaluate.ts`).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const skillRules: ReadonlyArray<LintRule<SkillRuleContext>>;
+//# sourceMappingURL=skill.d.ts.map

package/dist/src/unstable/lint/catalog/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/lint/catalog/skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAOtD;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,aAAa,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAMhE,CAAC"}

package/dist/src/unstable/lint/catalog/skill.js

@@ -0,0 +1,52 @@
+/**
+ * `skill/*` rule catalog — the v1 five-rule set.
+ *
+ * Per `docs/design/lint-engine.md §10.skill`, registry publish and `axm lint`
+ * run exactly these rules against each skill context:
+ *
+ * | ID                               | Severity | Autofix |
+ * | -------------------------------- | -------- | ------- |
+ * | `skill/skill-md-present`         | error    | —       |
+ * | `skill/manifest-present`         | error    | —       |
+ * | `skill/frontmatter-parseable`    | error    | —       |
+ * | `skill/manifest-schema-valid`    | error    | —       |
+ * | `skill/manifest-keys-recognized` | warning  | —       |
+ *
+ * All five ship `kind: "advisory"`. Native-vs-non-native applicability is
+ * expressed via `check` early-return (no separate `applies` predicate); see
+ * each rule's module for the guard.
+ *
+ * Rule ids are **registered with the lint config allowlist at module-load
+ * time**, so importing this catalog extends the set of accepted
+ * `.axm/settings.json` `lint.rules` keys. Consumers that never import the
+ * catalog (the registry Worker bundle for `pack`-only routes, e.g.) don't pay
+ * the registration cost.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import { registerLintRuleIds } from "../config.js";
+import { skillMdPresentRule } from "./skill/skill-md-present.js";
+import { manifestPresentRule } from "./skill/manifest-present.js";
+import { frontmatterParseableRule } from "./skill/frontmatter-parseable.js";
+import { manifestSchemaValidRule } from "./skill/manifest-schema-valid.js";
+import { manifestKeysRecognizedRule } from "./skill/manifest-keys-recognized.js";
+/**
+ * Ordered v1 `skill/*` rule catalog. Declaration order is the evaluation
+ * order within a single `evaluateContexts` call (deterministic ordering is
+ * test-observable; see `evaluate.ts`).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const skillRules = [
+    skillMdPresentRule,
+    manifestPresentRule,
+    frontmatterParseableRule,
+    manifestSchemaValidRule,
+    manifestKeysRecognizedRule,
+];
+// Register ids into the `LintConfig.rules` allowlist. Module-load side effect:
+// a consumer that imports this catalog (or the `catalog/index` barrel) enables
+// `.axm/settings.json` `lint.rules` to reference any of the above rule ids.
+registerLintRuleIds(skillRules.map((r) => r.id));
+//# sourceMappingURL=skill.js.map

package/dist/src/unstable/lint/catalog/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../../../../src/unstable/lint/catalog/skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAEjF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAA8C;IACnE,kBAAkB;IAClB,mBAAmB;IACnB,wBAAwB;IACxB,uBAAuB;IACvB,0BAA0B;CAC3B,CAAC;AAEF,+EAA+E;AAC/E,+EAA+E;AAC/E,4EAA4E;AAC5E,mBAAmB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/dist/src/unstable/lint/catalog/workspace/agents-detected-declared.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `workspace/agents-detected-declared` — every agent footprint detected on
+ * disk appears in `settings.agents[]`.
+ *
+ * Per `docs/design/lint-engine.md §10.workspace`:
+ *
+ *   Project scope only (early-returns at user scope). For each detected
+ *   agent whose id is missing from settings.agents[], emit one finding.
+ *
+ * Project scope only: detection relies on scanning workspace-root-adjacent
+ * agent dirs (`.claude/`, `.cursor/`, …). At user scope the detection target
+ * is ambiguous, so the rule early-returns `[]`.
+ *
+ * Advisory, warning — the user may be intentionally using an agent AXM
+ * doesn't manage.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { WorkspaceRuleContext } from "../../context.js";
+import type { AdvisoryRule } from "../../rule.js";
+export declare const agentsDetectedDeclaredRule: AdvisoryRule<WorkspaceRuleContext>;
+//# sourceMappingURL=agents-detected-declared.d.ts.map

package/dist/src/unstable/lint/catalog/workspace/agents-detected-declared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-detected-declared.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/workspace/agents-detected-declared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,eAAe,CAAC;AAenE,eAAO,MAAM,0BAA0B,EAAE,YAAY,CAAC,oBAAoB,CA0CzE,CAAC"}

package/dist/src/unstable/lint/catalog/workspace/agents-detected-declared.js

@@ -0,0 +1,75 @@
+/**
+ * `workspace/agents-detected-declared` — every agent footprint detected on
+ * disk appears in `settings.agents[]`.
+ *
+ * Per `docs/design/lint-engine.md §10.workspace`:
+ *
+ *   Project scope only (early-returns at user scope). For each detected
+ *   agent whose id is missing from settings.agents[], emit one finding.
+ *
+ * Project scope only: detection relies on scanning workspace-root-adjacent
+ * agent dirs (`.claude/`, `.cursor/`, …). At user scope the detection target
+ * is ambiguous, so the rule early-returns `[]`.
+ *
+ * Advisory, warning — the user may be intentionally using an agent AXM
+ * doesn't manage.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import { SettingsSchema } from "../../../settings/schema.js";
+import { EMPTY_ADVISORY_FINDINGS } from "./helpers/empty.js";
+const RULE_ID = "workspace/agents-detected-declared";
+const SETTINGS_REL = ".axm/settings.json";
+const decodeSettings = (input) => {
+    const result = Schema.decodeUnknownResult(SettingsSchema)(input, {
+        onExcessProperty: "ignore",
+        errors: "all",
+    });
+    return Result.isSuccess(result) ? Option.some(result.success) : Option.none();
+};
+export const agentsDetectedDeclaredRule = {
+    id: RULE_ID,
+    description: "Every agent detected on disk appears in settings.agents[].",
+    kind: "advisory",
+    severity: "warning",
+    check: (context) => Effect.gen(function* () {
+        // Scope-aware early-return — detection only applies at project scope.
+        if (context.subject.scope === "user") {
+            return EMPTY_ADVISORY_FINDINGS;
+        }
+        const settingsResult = yield* Effect.result(context.workspace.settings);
+        if (Result.isFailure(settingsResult)) {
+            return EMPTY_ADVISORY_FINDINGS;
+        }
+        const decoded = decodeSettings(settingsResult.success);
+        if (Option.isNone(decoded)) {
+            return EMPTY_ADVISORY_FINDINGS;
+        }
+        const declared = new Set(decoded.value.agents ?? []);
+        const detected = yield* context.workspace.detectAgents("project");
+        const findings = [];
+        for (const detection of detected) {
+            if (declared.has(detection.id)) {
+                continue;
+            }
+            findings.push({
+                kind: "advisory",
+                ruleId: RULE_ID,
+                severity: "warning",
+                message: `Detected agent '${detection.id}' is not declared in settings.agents[].`,
+                suggestions: [
+                    `Add '${detection.id}' to settings.agents[] to manage this agent.`,
+                    `Set workspace/agents-detected-declared to 'off' in lint.rules to silence this rule.`,
+                ],
+                location: { file: SETTINGS_REL },
+            });
+        }
+        return findings;
+    }),
+};
+//# sourceMappingURL=agents-detected-declared.js.map

package/dist/src/unstable/lint/catalog/workspace/agents-detected-declared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-detected-declared.js","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/workspace/agents-detected-declared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,cAAc,EAAiB,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,OAAO,GAAG,oCAAoC,CAAC;AACrD,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAE1C,MAAM,cAAc,GAAG,CAAC,KAAc,EAA2B,EAAE;IACjE,MAAM,MAAM,GAAG,MAAM,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC,KAAK,EAAE;QAC/D,gBAAgB,EAAE,QAAQ;QAC1B,MAAM,EAAE,KAAK;KACd,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;AAChF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAuC;IAC5E,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,4DAA4D;IACzE,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CACjB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,sEAAsE;QACtE,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YACrC,OAAO,uBAAuB,CAAC;QACjC,CAAC;QAED,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACxE,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC;YACrC,OAAO,uBAAuB,CAAC;QACjC,CAAC;QACD,MAAM,OAAO,GAAG,cAAc,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,OAAO,uBAAuB,CAAC;QACjC,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QAErD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAClE,MAAM,QAAQ,GAA2B,EAAE,CAAC;QAC5C,KAAK,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;YACjC,IAAI,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC/B,SAAS;YACX,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,OAAO;gBACf,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,mBAAmB,SAAS,CAAC,EAAE,yCAAyC;gBACjF,WAAW,EAAE;oBACX,QAAQ,SAAS,CAAC,EAAE,8CAA8C;oBAClE,qFAAqF;iBACtF;gBACD,QAAQ,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE;aACjC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;CACL,CAAC"}

package/dist/src/unstable/lint/catalog/workspace/agents-recognized.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `workspace/agents-recognized` — every agent id in `settings.agents[]` is
+ * in AXM's known-agent catalog.
+ *
+ * Per `docs/design/lint-engine.md §10.workspace` "Foundation" row:
+ *
+ *   Agent recognition invariant — unknown IDs can't be materialized into.
+ *   Absorbs doctor `agents-configured.unrecognized`. Known-agent catalog
+ *   lives at `packages/core/src/unstable/agents/types.ts`.
+ *
+ * Cascade: the rule walks `settings.agents[]` and checks each id against
+ * the set returned by `workspace.knownAgents`. Unknown ids each emit one
+ * finding — the cascade is per-entity, not per-cascade-arm.
+ *
+ * Advisory — fixing an unrecognized id is a user-authored settings edit.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { WorkspaceRuleContext } from "../../context.js";
+import type { AdvisoryRule } from "../../rule.js";
+export declare const agentsRecognizedRule: AdvisoryRule<WorkspaceRuleContext>;
+//# sourceMappingURL=agents-recognized.d.ts.map

package/dist/src/unstable/lint/catalog/workspace/agents-recognized.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-recognized.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/workspace/agents-recognized.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,eAAe,CAAC;AAenE,eAAO,MAAM,oBAAoB,EAAE,YAAY,CAAC,oBAAoB,CA0CnE,CAAC"}

package/dist/src/unstable/lint/catalog/workspace/agents-recognized.js

@@ -0,0 +1,76 @@
+/**
+ * `workspace/agents-recognized` — every agent id in `settings.agents[]` is
+ * in AXM's known-agent catalog.
+ *
+ * Per `docs/design/lint-engine.md §10.workspace` "Foundation" row:
+ *
+ *   Agent recognition invariant — unknown IDs can't be materialized into.
+ *   Absorbs doctor `agents-configured.unrecognized`. Known-agent catalog
+ *   lives at `packages/core/src/unstable/agents/types.ts`.
+ *
+ * Cascade: the rule walks `settings.agents[]` and checks each id against
+ * the set returned by `workspace.knownAgents`. Unknown ids each emit one
+ * finding — the cascade is per-entity, not per-cascade-arm.
+ *
+ * Advisory — fixing an unrecognized id is a user-authored settings edit.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import { SettingsSchema } from "../../../settings/schema.js";
+import { EMPTY_ADVISORY_FINDINGS } from "./helpers/empty.js";
+const RULE_ID = "workspace/agents-recognized";
+const SETTINGS_REL = ".axm/settings.json";
+const decodeSettings = (input) => {
+    const result = Schema.decodeUnknownResult(SettingsSchema)(input, {
+        onExcessProperty: "ignore",
+        errors: "all",
+    });
+    return Result.isSuccess(result) ? Option.some(result.success) : Option.none();
+};
+export const agentsRecognizedRule = {
+    id: RULE_ID,
+    description: "Every agent id in settings.agents[] is in the known-agent catalog.",
+    kind: "advisory",
+    severity: "error",
+    check: (context) => Effect.gen(function* () {
+        const settingsResult = yield* Effect.result(context.workspace.settings);
+        if (Result.isFailure(settingsResult)) {
+            return EMPTY_ADVISORY_FINDINGS;
+        }
+        const decoded = decodeSettings(settingsResult.success);
+        if (Option.isNone(decoded)) {
+            // workspace/settings-schema-valid owns the decode arm.
+            return EMPTY_ADVISORY_FINDINGS;
+        }
+        const declared = decoded.value.agents ?? [];
+        if (declared.length === 0) {
+            return EMPTY_ADVISORY_FINDINGS;
+        }
+        const known = yield* context.workspace.knownAgents;
+        const knownIds = new Set(known.map((a) => a.id));
+        const findings = [];
+        for (const id of declared) {
+            if (knownIds.has(id)) {
+                continue;
+            }
+            findings.push({
+                kind: "advisory",
+                ruleId: RULE_ID,
+                severity: "error",
+                message: `Agent id '${id}' is not in the known-agent catalog.`,
+                suggestions: [
+                    `Remove '${id}' from settings.agents[].`,
+                    `Correct the typo if '${id}' was meant to be another agent id.`,
+                ],
+                location: { file: SETTINGS_REL },
+            });
+        }
+        return findings;
+    }),
+};
+//# sourceMappingURL=agents-recognized.js.map

package/dist/src/unstable/lint/catalog/workspace/agents-recognized.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-recognized.js","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/workspace/agents-recognized.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,cAAc,EAAiB,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,OAAO,GAAG,6BAA6B,CAAC;AAC9C,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAE1C,MAAM,cAAc,GAAG,CAAC,KAAc,EAA2B,EAAE;IACjE,MAAM,MAAM,GAAG,MAAM,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC,KAAK,EAAE;QAC/D,gBAAgB,EAAE,QAAQ;QAC1B,MAAM,EAAE,KAAK;KACd,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;AAChF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAuC;IACtE,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,oEAAoE;IACjF,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CACjB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACxE,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC;YACrC,OAAO,uBAAuB,CAAC;QACjC,CAAC;QACD,MAAM,OAAO,GAAG,cAAc,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,uDAAuD;YACvD,OAAO,uBAAuB,CAAC;QACjC,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;QAC5C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,uBAAuB,CAAC;QACjC,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAEjD,MAAM,QAAQ,GAA2B,EAAE,CAAC;QAC5C,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC1B,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACrB,SAAS;YACX,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,OAAO;gBACf,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,aAAa,EAAE,sCAAsC;gBAC9D,WAAW,EAAE;oBACX,WAAW,EAAE,2BAA2B;oBACxC,wBAAwB,EAAE,qCAAqC;iBAChE;gBACD,QAAQ,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE;aACjC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;CACL,CAAC"}

package/dist/src/unstable/lint/catalog/workspace/helpers/empty.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Typed empty constants used by workspace rules to satisfy return types
+ * without resorting to `[]` + type assertion. Using a shared `const` avoids
+ * repeated `as ReadonlyArray<T>` assertions (banned by the repo style guide)
+ * while keeping the inferred type stable.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { AdvisoryFinding, LintFinding } from "../../../rule.js";
+import type { Operation } from "../../../../plan/plan.js";
+/** Shared empty AdvisoryFinding array. */
+export declare const EMPTY_ADVISORY_FINDINGS: ReadonlyArray<AdvisoryFinding>;
+/** Shared empty LintFinding array. */
+export declare const EMPTY_LINT_FINDINGS: ReadonlyArray<LintFinding>;
+/** Shared empty Operation array. */
+export declare const EMPTY_OPERATIONS: ReadonlyArray<Operation<string, unknown>>;
+//# sourceMappingURL=empty.d.ts.map

package/dist/src/unstable/lint/catalog/workspace/helpers/empty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty.d.ts","sourceRoot":"","sources":["../../../../../../../src/unstable/lint/catalog/workspace/helpers/empty.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,0CAA0C;AAC1C,eAAO,MAAM,uBAAuB,EAAE,aAAa,CAAC,eAAe,CAAM,CAAC;AAE1E,sCAAsC;AACtC,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,WAAW,CAAM,CAAC;AAElE,oCAAoC;AACpC,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM,CAAC"}

package/dist/src/unstable/lint/catalog/workspace/helpers/empty.js

@@ -0,0 +1,16 @@
+/**
+ * Typed empty constants used by workspace rules to satisfy return types
+ * without resorting to `[]` + type assertion. Using a shared `const` avoids
+ * repeated `as ReadonlyArray<T>` assertions (banned by the repo style guide)
+ * while keeping the inferred type stable.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+/** Shared empty AdvisoryFinding array. */
+export const EMPTY_ADVISORY_FINDINGS = [];
+/** Shared empty LintFinding array. */
+export const EMPTY_LINT_FINDINGS = [];
+/** Shared empty Operation array. */
+export const EMPTY_OPERATIONS = [];
+//# sourceMappingURL=empty.js.map

package/dist/src/unstable/lint/catalog/workspace/helpers/empty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty.js","sourceRoot":"","sources":["../../../../../../../src/unstable/lint/catalog/workspace/helpers/empty.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,0CAA0C;AAC1C,MAAM,CAAC,MAAM,uBAAuB,GAAmC,EAAE,CAAC;AAE1E,sCAAsC;AACtC,MAAM,CAAC,MAAM,mBAAmB,GAA+B,EAAE,CAAC;AAElE,oCAAoC;AACpC,MAAM,CAAC,MAAM,gBAAgB,GAA8C,EAAE,CAAC"}