@agentxm/client-core 0.1.6 → 0.3.1

package/dist/src/unstable/lint/catalog/workspace/packs-members-retained.js

@@ -0,0 +1,163 @@
+/**
+ * `workspace/packs-members-retained` — every member lock entry with
+ * `retainedByPack: true` is declared by an installed pack.
+ *
+ * For each member lock entry (skill, command, subagent, mcp-server) where
+ * `retainedByPack === true` AND the member is not directly declared in
+ * settings, at least one installed pack's lock entry lists the member's
+ * FQN in the appropriate resolved map. Entries directly declared in
+ * settings are exempt (covered by per-type declarations rules).
+ *
+ * Rule body walks every member lock entry type — not just skills — so
+ * adding non-skill install families in v1.5+ is test-surface-only.
+ *
+ * One finding per affected entity. Advisory, warning.
+ *
+ * @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 { LockfileSchema, } from "../../../lockfile/schema.js";
+import { SettingsSchema } from "../../../settings/schema.js";
+import { EMPTY_ADVISORY_FINDINGS } from "./helpers/empty.js";
+const RULE_ID = "workspace/packs-members-retained";
+const LOCKFILE_REL = ".axm/axm-lock.yaml";
+const decodeSettings = (input) => {
+    const result = Schema.decodeUnknownResult(SettingsSchema)(input, {
+        onExcessProperty: "ignore",
+        errors: "all",
+    });
+    return Result.isSuccess(result) ? Option.some(result.success) : Option.none();
+};
+const decodeLockfile = (input) => {
+    const result = Schema.decodeUnknownResult(LockfileSchema)(input, {
+        onExcessProperty: "ignore",
+        errors: "all",
+    });
+    return Result.isSuccess(result) ? Option.some(result.success) : Option.none();
+};
+const entryFqn = (entry, name, typeSegment) => {
+    if (entry.type !== "registry") {
+        // Non-registry lock entries don't carry an owner-qualified FQN. We
+        // conservatively exclude them: retention applies only to registry-ish
+        // pack dependencies.
+        return undefined;
+    }
+    const owner = entry.owner;
+    const regName = entry.name;
+    return `${owner}/${typeSegment}/${regName}`;
+};
+const buildPackRetainedFqns = (lockfile) => {
+    const declared = new Set();
+    const packs = lockfile.packs ?? {};
+    for (const entry of Object.values(packs)) {
+        for (const fqn of Object.keys(entry.resolvedSkills)) {
+            declared.add(fqn);
+        }
+        for (const fqn of Object.keys(entry.resolvedCommands)) {
+            declared.add(fqn);
+        }
+        for (const fqn of Object.keys(entry.resolvedSubagents)) {
+            declared.add(fqn);
+        }
+        for (const fqn of Object.keys(entry.resolvedMcpServers)) {
+            declared.add(fqn);
+        }
+    }
+    return declared;
+};
+const droppedFinding = (memberType, name, fqn) => ({
+    kind: "advisory",
+    ruleId: RULE_ID,
+    severity: "warning",
+    message: `${memberType} '${name}'${fqn === undefined ? "" : ` (FQN ${fqn})`} is retained by a pack but no installed pack declares it.`,
+    suggestions: [
+        `Declare '${name}' directly in settings.${memberType === "mcp-server" ? "mcpServers" : `${memberType}s`}.`,
+        `Uninstall '${name}' if the owning pack is no longer installed.`,
+    ],
+    location: { file: LOCKFILE_REL },
+});
+const collectMembers = (lockfile) => {
+    const result = [];
+    for (const [name, entry] of Object.entries(lockfile.skills)) {
+        result.push({ memberType: "skill", name, entry });
+    }
+    for (const [name, entry] of Object.entries(lockfile.commands ?? {})) {
+        result.push({ memberType: "command", name, entry });
+    }
+    for (const [name, entry] of Object.entries(lockfile.subagents ?? {})) {
+        result.push({ memberType: "subagent", name, entry });
+    }
+    for (const [name, entry] of Object.entries(lockfile.mcpServers ?? {})) {
+        result.push({ memberType: "mcp-server", name, entry });
+    }
+    return result;
+};
+const isDirectlyDeclared = (member, settings) => {
+    switch (member.memberType) {
+        case "skill":
+            return member.name in (settings.skills ?? {});
+        case "command":
+            return member.name in (settings.commands ?? {});
+        case "subagent":
+            return member.name in (settings.subagents ?? {});
+        case "mcp-server":
+            return member.name in (settings.mcpServers ?? {});
+    }
+};
+const typeSegment = (memberType) => {
+    switch (memberType) {
+        case "skill":
+            return "skills";
+        case "command":
+            return "commands";
+        case "subagent":
+            return "subagents";
+        case "mcp-server":
+            return "mcp-servers";
+    }
+};
+export const packsMembersRetainedRule = {
+    id: RULE_ID,
+    description: "Every member lock entry with retainedByPack is declared by an installed pack.",
+    kind: "advisory",
+    severity: "warning",
+    check: (context) => Effect.gen(function* () {
+        const settingsResult = yield* Effect.result(context.workspace.settings);
+        const lockfileResult = yield* Effect.result(context.workspace.lockfile);
+        if (Result.isFailure(settingsResult) || Result.isFailure(lockfileResult)) {
+            return EMPTY_ADVISORY_FINDINGS;
+        }
+        const settings = decodeSettings(settingsResult.success);
+        if (Option.isNone(settings)) {
+            return EMPTY_ADVISORY_FINDINGS;
+        }
+        const lockOption = lockfileResult.success;
+        if (Option.isNone(lockOption)) {
+            return EMPTY_ADVISORY_FINDINGS;
+        }
+        const lockfile = decodeLockfile(lockOption.value);
+        if (Option.isNone(lockfile)) {
+            return EMPTY_ADVISORY_FINDINGS;
+        }
+        const retainedByPacks = buildPackRetainedFqns(lockfile.value);
+        const findings = [];
+        for (const member of collectMembers(lockfile.value)) {
+            if (member.entry.retainedByPack !== true) {
+                continue;
+            }
+            if (isDirectlyDeclared(member, settings.value)) {
+                continue;
+            }
+            const fqn = entryFqn(member.entry, member.name, typeSegment(member.memberType));
+            if (fqn === undefined || !retainedByPacks.has(fqn)) {
+                findings.push(droppedFinding(member.memberType, member.name, fqn));
+            }
+        }
+        return findings;
+    }),
+};
+//# sourceMappingURL=packs-members-retained.js.map

package/dist/src/unstable/lint/catalog/workspace/packs-members-retained.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packs-members-retained.js","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/workspace/packs-members-retained.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;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,EACL,cAAc,GAMf,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,EAAiB,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,OAAO,GAAG,kCAAkC,CAAC;AACnD,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,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;AAIF,MAAM,QAAQ,GAAG,CAAC,KAAqB,EAAE,IAAY,EAAE,WAAmB,EAAsB,EAAE;IAChG,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC9B,mEAAmE;QACnE,sEAAsE;QACtE,qBAAqB;QACrB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC;IAC3B,OAAO,GAAG,KAAK,IAAI,WAAW,IAAI,OAAO,EAAE,CAAC;AAC9C,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,QAAkB,EAAuB,EAAE;IACxE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;YACpD,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACtD,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACvD,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACxD,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CACrB,UAAkB,EAClB,IAAY,EACZ,GAAuB,EACN,EAAE,CAAC,CAAC;IACrB,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,GAAG,UAAU,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG,2DAA2D;IACtI,WAAW,EAAE;QACX,YAAY,IAAI,0BAA0B,UAAU,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,UAAU,GAAG,GAAG;QAC1G,cAAc,IAAI,8CAA8C;KACjE;IACD,QAAQ,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE;CACjC,CAAC,CAAC;AAQH,MAAM,cAAc,GAAG,CAAC,QAAkB,EAA8B,EAAE;IACxE,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5D,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;QACpE,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;QACrE,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;QACtE,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,MAAmB,EAAE,QAAkB,EAAW,EAAE;IAC9E,QAAQ,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1B,KAAK,OAAO;YACV,OAAO,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QAChD,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QAClD,KAAK,UAAU;YACb,OAAO,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QACnD,KAAK,YAAY;YACf,OAAO,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,UAAqC,EAAU,EAAE;IACpE,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,UAAU,CAAC;QACpB,KAAK,UAAU;YACb,OAAO,WAAW,CAAC;QACrB,KAAK,YAAY;YACf,OAAO,aAAa,CAAC;IACzB,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAuC;IAC1E,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,+EAA+E;IAC5F,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,SAAS;IACnB,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,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,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC;YACzE,OAAO,uBAAuB,CAAC;QACjC,CAAC;QACD,MAAM,QAAQ,GAAG,cAAc,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,OAAO,uBAAuB,CAAC;QACjC,CAAC;QACD,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC;QAC1C,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,OAAO,uBAAuB,CAAC;QACjC,CAAC;QACD,MAAM,QAAQ,GAAG,cAAc,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,OAAO,uBAAuB,CAAC;QACjC,CAAC;QAED,MAAM,eAAe,GAAG,qBAAqB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAA2B,EAAE,CAAC;QAE5C,KAAK,MAAM,MAAM,IAAI,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,IAAI,MAAM,CAAC,KAAK,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;gBACzC,SAAS;YACX,CAAC;YACD,IAAI,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/C,SAAS;YACX,CAAC;YACD,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;YAChF,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnD,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;CACL,CAAC"}

package/dist/src/unstable/lint/catalog/workspace/settings-schema-valid.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `workspace/settings-schema-valid` — `.axm/settings.json` conforms to
+ * `SettingsSchema`.
+ *
+ * Cascade per `docs/design/lint-engine.md §10.workspace`:
+ *
+ * 1. `.axm/settings.json` is present (`workspace/initialized` owns the
+ *    absence arm; this rule early-returns when the file is missing).
+ * 2. The file parses as JSON (the accessor surfaces parse failures via
+ *    `SettingsReadError`; we emit one finding per read failure).
+ * 3. The parsed value is a JSON object (not an array or scalar) — enforced
+ *    by `Schema.decodeUnknownResult(SettingsSchema)` structurally.
+ * 4. `Schema.decodeUnknownResult(SettingsSchema)` with
+ *    `onExcessProperty: "ignore"` succeeds; `ParseResult` issues map 1:1 to
+ *    findings via `schemaDecodeFindings`.
+ *
+ * Reports the read-failure finding when arm 2 fails; otherwise reports the
+ * schema issues produced by arm 3/4. The design doc notes the unknown-key
+ * companion (`workspace/settings-keys-recognized`) defers to v1.5+ — this
+ * rule keeps schema validity as a single error-severity invariant.
+ *
+ * @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 settingsSchemaValidRule: AdvisoryRule<WorkspaceRuleContext>;
+//# sourceMappingURL=settings-schema-valid.d.ts.map

package/dist/src/unstable/lint/catalog/workspace/settings-schema-valid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-schema-valid.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/workspace/settings-schema-valid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAQlD,eAAO,MAAM,uBAAuB,EAAE,YAAY,CAAC,oBAAoB,CA2CtE,CAAC"}

package/dist/src/unstable/lint/catalog/workspace/settings-schema-valid.js

@@ -0,0 +1,67 @@
+/**
+ * `workspace/settings-schema-valid` — `.axm/settings.json` conforms to
+ * `SettingsSchema`.
+ *
+ * Cascade per `docs/design/lint-engine.md §10.workspace`:
+ *
+ * 1. `.axm/settings.json` is present (`workspace/initialized` owns the
+ *    absence arm; this rule early-returns when the file is missing).
+ * 2. The file parses as JSON (the accessor surfaces parse failures via
+ *    `SettingsReadError`; we emit one finding per read failure).
+ * 3. The parsed value is a JSON object (not an array or scalar) — enforced
+ *    by `Schema.decodeUnknownResult(SettingsSchema)` structurally.
+ * 4. `Schema.decodeUnknownResult(SettingsSchema)` with
+ *    `onExcessProperty: "ignore"` succeeds; `ParseResult` issues map 1:1 to
+ *    findings via `schemaDecodeFindings`.
+ *
+ * Reports the read-failure finding when arm 2 fails; otherwise reports the
+ * schema issues produced by arm 3/4. The design doc notes the unknown-key
+ * companion (`workspace/settings-keys-recognized`) defers to v1.5+ — this
+ * rule keeps schema validity as a single error-severity invariant.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import * as Result from "effect/Result";
+import { SettingsSchema } from "../../../settings/schema.js";
+import { schemaDecodeFindings } from "../shared/schema-rule.js";
+import { EMPTY_ADVISORY_FINDINGS } from "./helpers/empty.js";
+const RULE_ID = "workspace/settings-schema-valid";
+const SETTINGS_REL = ".axm/settings.json";
+export const settingsSchemaValidRule = {
+    id: RULE_ID,
+    description: ".axm/settings.json parses and conforms to SettingsSchema.",
+    kind: "advisory",
+    severity: "error",
+    check: (context) => Effect.gen(function* () {
+        // Early-return when settings.json is absent; workspace/initialized owns
+        // that arm so a fresh workspace surfaces exactly one finding.
+        const exists = yield* context.workspace.exists(SETTINGS_REL);
+        if (!exists) {
+            return EMPTY_ADVISORY_FINDINGS;
+        }
+        const read = yield* Effect.result(context.workspace.settings);
+        if (Result.isFailure(read)) {
+            const error = read.failure;
+            return [
+                {
+                    kind: "advisory",
+                    ruleId: RULE_ID,
+                    severity: "error",
+                    message: `Could not read settings.json: ${error.message}`,
+                    suggestions: [
+                        "Fix the JSON syntax error reported at the location above.",
+                        "Verify .axm/settings.json is valid JSON (quoted keys, no trailing commas).",
+                    ],
+                    location: { file: SETTINGS_REL },
+                },
+            ];
+        }
+        // The accessor returns the raw parsed JSON value; we run the schema
+        // decode here so issues surface 1:1 as findings.
+        const decodedFindings = yield* schemaDecodeFindings(RULE_ID, "error", SETTINGS_REL, SettingsSchema, read.success);
+        return decodedFindings;
+    }),
+};
+//# sourceMappingURL=settings-schema-valid.js.map

package/dist/src/unstable/lint/catalog/workspace/settings-schema-valid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-schema-valid.js","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/workspace/settings-schema-valid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,OAAO,GAAG,iCAAiC,CAAC;AAClD,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAE1C,MAAM,CAAC,MAAM,uBAAuB,GAAuC;IACzE,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,2DAA2D;IACxE,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CACjB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,wEAAwE;QACxE,8DAA8D;QAC9D,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC7D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,uBAAuB,CAAC;QACjC,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC9D,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC;YAC3B,OAAO;gBACL;oBACE,IAAI,EAAE,UAAmB;oBACzB,MAAM,EAAE,OAAO;oBACf,QAAQ,EAAE,OAAgB;oBAC1B,OAAO,EAAE,iCAAiC,KAAK,CAAC,OAAO,EAAE;oBACzD,WAAW,EAAE;wBACX,2DAA2D;wBAC3D,4EAA4E;qBAC7E;oBACD,QAAQ,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE;iBACjC;aACF,CAAC;QACJ,CAAC;QAED,oEAAoE;QACpE,iDAAiD;QACjD,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,oBAAoB,CACjD,OAAO,EACP,OAAO,EACP,YAAY,EACZ,cAAc,EACd,IAAI,CAAC,OAAO,CACb,CAAC;QACF,OAAO,eAAe,CAAC;IACzB,CAAC,CAAC;CACL,CAAC"}

package/dist/src/unstable/lint/catalog/workspace/skills-artifacts-clean.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `workspace/skills-artifacts-clean` — skill artifacts on disk are live,
+ * declared, and canonically named.
+ *
+ * Cascade per `docs/design/lint-engine.md §10.workspace.Skills` (first
+ * failing arm per affected entity):
+ *
+ * - **Dangling** (autofixing) — an artifact exists in a declared agent's
+ *   skills dir but the canonical source under `.axm/extensions/.../src/`
+ *   is missing. Autofix: `install-skill` with `force: true`.
+ * - **Stale** (advisory) — an artifact exists in a declared agent's skills
+ *   dir whose name doesn't correspond to any declared enabled skill. No
+ *   pre-sync Operation applies (the artifact isn't axm-owned after the
+ *   skill is no longer declared); emit an advisory CLI suggestion.
+ * - **Name-mismatch** (advisory) — an artifact exists with a name that
+ *   doesn't match the sanitized declared skill name (legacy casing,
+ *   pre-sanitization). Emit an advisory CLI suggestion.
+ *
+ * Listing per-agent skill targets uses `context.workspace.list(...)`.
+ *
+ * The rule emits at most one finding per artifact — cascade resolves per
+ * filesystem entry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { WorkspaceRuleContext } from "../../context.js";
+import type { AutofixingRule } from "../../rule.js";
+export declare const skillsArtifactsCleanRule: AutofixingRule<WorkspaceRuleContext>;
+//# sourceMappingURL=skills-artifacts-clean.d.ts.map

package/dist/src/unstable/lint/catalog/workspace/skills-artifacts-clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-artifacts-clean.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/workspace/skills-artifacts-clean.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAGV,cAAc,EAEf,MAAM,eAAe,CAAC;AAwHvB,eAAO,MAAM,wBAAwB,EAAE,cAAc,CAAC,oBAAoB,CAoHzE,CAAC"}

package/dist/src/unstable/lint/catalog/workspace/skills-artifacts-clean.js

@@ -0,0 +1,232 @@
+/**
+ * `workspace/skills-artifacts-clean` — skill artifacts on disk are live,
+ * declared, and canonically named.
+ *
+ * Cascade per `docs/design/lint-engine.md §10.workspace.Skills` (first
+ * failing arm per affected entity):
+ *
+ * - **Dangling** (autofixing) — an artifact exists in a declared agent's
+ *   skills dir but the canonical source under `.axm/extensions/.../src/`
+ *   is missing. Autofix: `install-skill` with `force: true`.
+ * - **Stale** (advisory) — an artifact exists in a declared agent's skills
+ *   dir whose name doesn't correspond to any declared enabled skill. No
+ *   pre-sync Operation applies (the artifact isn't axm-owned after the
+ *   skill is no longer declared); emit an advisory CLI suggestion.
+ * - **Name-mismatch** (advisory) — an artifact exists with a name that
+ *   doesn't match the sanitized declared skill name (legacy casing,
+ *   pre-sanitization). Emit an advisory CLI suggestion.
+ *
+ * Listing per-agent skill targets uses `context.workspace.list(...)`.
+ *
+ * The rule emits at most one finding per artifact — cascade resolves per
+ * filesystem entry.
+ *
+ * @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 { LockfileSchema } from "../../../lockfile/schema.js";
+import { SettingsSchema } from "../../../settings/schema.js";
+import { installSkillOp } from "./helpers/install-ops.js";
+import { parseRegistrySource } from "./helpers/registry-source.js";
+import { EMPTY_LINT_FINDINGS, EMPTY_OPERATIONS } from "./helpers/empty.js";
+const RULE_ID = "workspace/skills-artifacts-clean";
+const SUG_REINSTALL_PREFIX = "Reinstall skill ";
+const decodeSettings = (input) => {
+    const result = Schema.decodeUnknownResult(SettingsSchema)(input, {
+        onExcessProperty: "ignore",
+        errors: "all",
+    });
+    return Result.isSuccess(result) ? Option.some(result.success) : Option.none();
+};
+const decodeLockfile = (input) => {
+    const result = Schema.decodeUnknownResult(LockfileSchema)(input, {
+        onExcessProperty: "ignore",
+        errors: "all",
+    });
+    return Result.isSuccess(result) ? Option.some(result.success) : Option.none();
+};
+/**
+ * Names of skills retained by at least one installed declared pack. These
+ * skill artifacts are valid even though the skill isn't in `settings.skills`.
+ */
+const buildRetainedSkillNames = (settings, lockfile) => {
+    const declaredPackNames = new Set(Object.keys(settings.packs ?? {}));
+    const names = new Set();
+    const packLock = lockfile.packs ?? {};
+    for (const [packName, packEntry] of Object.entries(packLock)) {
+        if (!declaredPackNames.has(packName)) {
+            continue;
+        }
+        for (const fqn of Object.keys(packEntry.resolvedSkills)) {
+            // FQN is `@owner/skills/<name>`; last segment is the skill name.
+            const parts = fqn.split("/");
+            const last = parts[parts.length - 1];
+            if (last !== undefined) {
+                names.add(last);
+            }
+        }
+    }
+    // Also add lockfile-level skills with retainedByPack=true so accessor
+    // round-trips work even when the pack resolved map misnames them.
+    for (const [name, entry] of Object.entries(lockfile.skills)) {
+        if (entry.retainedByPack === true) {
+            names.add(name);
+        }
+    }
+    return names;
+};
+// Very narrow sanitization: lowercase, replace underscores with hyphens.
+// The authoritative sanitizer lives at axm extensions/utils.ts#sanitizeName;
+// v1 lint checks for exact match and surfaces any divergence as a
+// name-mismatch advisory arm.
+const isCanonicallyNamed = (artifact, declared) => artifact === declared;
+const danglingFinding = (name, agentId) => ({
+    kind: "autofixable",
+    ruleId: RULE_ID,
+    severity: "error",
+    message: `Agent '${agentId}' has a dangling artifact for skill '${name}' (canonical source missing).`,
+    suggestions: [`${SUG_REINSTALL_PREFIX}'${name}' to re-materialize canonical source.`],
+    location: { file: `${agentId}/skills/${name}` },
+});
+const staleFinding = (name, agentId) => ({
+    kind: "advisory",
+    ruleId: RULE_ID,
+    severity: "error",
+    message: `Agent '${agentId}' has a stale skill artifact '${name}' not backed by any declaration.`,
+    suggestions: [
+        `Remove the stale artifact manually if you no longer need skill '${name}'.`,
+        `Add '${name}' to settings.skills if it should be declared.`,
+    ],
+    location: { file: `${agentId}/skills/${name}` },
+});
+const nameMismatchFinding = (agentId, artifact, expected) => ({
+    kind: "advisory",
+    ruleId: RULE_ID,
+    severity: "error",
+    message: `Agent '${agentId}' has skill artifact '${artifact}' that doesn't match the sanitized name '${expected}'.`,
+    suggestions: [
+        `Remove '${artifact}' and reinstall to regenerate under the canonical name '${expected}'.`,
+    ],
+    location: { file: `${agentId}/skills/${artifact}` },
+});
+const NAME_FROM_SUGGESTION_RE = /'([^']+)'/;
+const extractSkillName = (suggestion) => NAME_FROM_SUGGESTION_RE.exec(suggestion)?.[1];
+/**
+ * Build candidate canonical `SKILL.md` probe paths for `name`, trying the
+ * settings-declared registry owner first (if any) and the external layout
+ * as a fallback. Non-registry sources fall through to the external probe.
+ */
+const canonicalSrcProbesForName = (name, settings) => {
+    const entry = settings.skills?.[name];
+    const parsed = entry === undefined ? undefined : parseRegistrySource(entry.source);
+    const probes = [];
+    if (parsed !== undefined) {
+        probes.push(`.axm/extensions/${parsed.owner}/skills/${name}/src/SKILL.md`);
+    }
+    probes.push(`.axm/extensions/external/skills/${name}/SKILL.md`);
+    return probes;
+};
+export const skillsArtifactsCleanRule = {
+    id: RULE_ID,
+    description: "Skill artifacts on disk are live, declared, and canonically named.",
+    kind: "autofixing",
+    severity: "error",
+    check: (context) => Effect.gen(function* () {
+        const settingsResult = yield* Effect.result(context.workspace.settings);
+        if (Result.isFailure(settingsResult)) {
+            return EMPTY_LINT_FINDINGS;
+        }
+        const settings = decodeSettings(settingsResult.success);
+        if (Option.isNone(settings)) {
+            return EMPTY_LINT_FINDINGS;
+        }
+        const declaredAgentIds = new Set(settings.value.agents ?? []);
+        if (declaredAgentIds.size === 0) {
+            return EMPTY_LINT_FINDINGS;
+        }
+        const knownAgents = yield* context.workspace.knownAgents;
+        const declaredAgents = knownAgents.filter((a) => declaredAgentIds.has(a.id));
+        const declaredSkills = settings.value.skills ?? {};
+        const declaredEnabledNames = new Set(Object.entries(declaredSkills)
+            .filter(([, v]) => v.enabled)
+            .map(([k]) => k));
+        // Pull in pack-retained skill names from the lockfile so retained
+        // artifacts aren't mis-classified as stale.
+        const lockfileResult = yield* Effect.result(context.workspace.lockfile);
+        const retainedNames = Result.isSuccess(lockfileResult)
+            ? Option.match(lockfileResult.success, {
+                onNone: () => new Set(),
+                onSome: (raw) => Option.match(decodeLockfile(raw), {
+                    onNone: () => new Set(),
+                    onSome: (lock) => buildRetainedSkillNames(settings.value, lock),
+                }),
+            })
+            : new Set();
+        const findings = [];
+        for (const agent of declaredAgents) {
+            const listResult = yield* Effect.result(context.workspace.list(agent.skills.dir));
+            if (Result.isFailure(listResult)) {
+                // Directory doesn't exist or isn't readable. Not an artifact-clean
+                // issue — the corresponding enabled arm surfaces missing dirs.
+                continue;
+            }
+            const artifacts = listResult.success;
+            for (const artifact of artifacts) {
+                // Retention carve-out: pack-retained skill artifacts are valid
+                // even when not in settings.skills.
+                if (retainedNames.has(artifact)) {
+                    continue;
+                }
+                // Cascade first-failure per artifact.
+                // Arm 1: dangling — artifact links back to a declared skill name
+                // but canonical src is missing.
+                if (declaredEnabledNames.has(artifact)) {
+                    const probes = canonicalSrcProbesForName(artifact, settings.value);
+                    const probeResults = yield* Effect.all(probes.map((probe) => context.workspace.exists(probe)), { concurrency: "unbounded" });
+                    if (probeResults.every((exists) => !exists)) {
+                        findings.push(danglingFinding(artifact, agent.id));
+                        continue;
+                    }
+                    continue;
+                }
+                // Arm 2/3: not a declared enabled name — name-mismatch or stale.
+                // Name-mismatch: artifact normalizes to a declared enabled name
+                // but differs in casing or similar. v1 check is case-insensitive.
+                const caseMatch = Array.from(declaredEnabledNames).find((d) => d.toLowerCase() === artifact.toLowerCase() && !isCanonicallyNamed(artifact, d));
+                if (caseMatch !== undefined) {
+                    findings.push(nameMismatchFinding(agent.id, artifact, caseMatch));
+                    continue;
+                }
+                findings.push(staleFinding(artifact, agent.id));
+            }
+        }
+        return findings;
+    }),
+    fix: (context, finding) => Effect.gen(function* () {
+        // Only the dangling arm emits AutofixableFinding; stale / name-mismatch
+        // arms ship AdvisoryFinding and never reach `fix`.
+        if (!finding.suggestions[0].startsWith(SUG_REINSTALL_PREFIX)) {
+            return EMPTY_OPERATIONS;
+        }
+        const name = extractSkillName(finding.suggestions[0]);
+        if (name === undefined) {
+            return EMPTY_OPERATIONS;
+        }
+        const settingsResult = yield* Effect.result(context.workspace.settings);
+        if (Result.isFailure(settingsResult)) {
+            return EMPTY_OPERATIONS;
+        }
+        const settings = decodeSettings(settingsResult.success);
+        if (Option.isNone(settings)) {
+            return EMPTY_OPERATIONS;
+        }
+        const entry = settings.value.skills?.[name];
+        const source = entry?.source ?? name;
+        return [installSkillOp({ name, source, force: true })];
+    }),
+};
+//# sourceMappingURL=skills-artifacts-clean.js.map

package/dist/src/unstable/lint/catalog/workspace/skills-artifacts-clean.js.map

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

package/dist/src/unstable/lint/catalog/workspace/skills-artifacts-correct.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `workspace/skills-artifacts-correct` — each enabled skill has artifacts in
+ * every declared agent's skill target; disabled skills have none.
+ *
+ * Three symptoms of the same invariant (§10.workspace.Skills note):
+ *
+ * - **Enabled-but-not-linked** — a skill declared `enabled: true` is missing
+ *   its per-agent artifact for at least one declared agent. Autofix:
+ *   `enable-skill` (the handler recreates symlinks across configured agents).
+ * - **Disabled-but-still-present** — a skill declared `enabled: false` still
+ *   has a per-agent artifact for at least one declared agent. Autofix:
+ *   `disable-skill`.
+ * - **Cross-agent-inconsistent** — an enabled skill has artifacts in some
+ *   declared agents but not others. Autofix: `enable-skill`.
+ *
+ * One finding per affected skill (per-entity cascade); the first arm that
+ * fires for a skill emits its finding and the other arms for the same skill
+ * do not.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { WorkspaceRuleContext } from "../../context.js";
+import type { AutofixingRule } from "../../rule.js";
+export declare const skillsArtifactsCorrectRule: AutofixingRule<WorkspaceRuleContext>;
+//# sourceMappingURL=skills-artifacts-correct.d.ts.map

package/dist/src/unstable/lint/catalog/workspace/skills-artifacts-correct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-artifacts-correct.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/workspace/skills-artifacts-correct.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAsB,cAAc,EAAe,MAAM,eAAe,CAAC;AAsDrF,eAAO,MAAM,0BAA0B,EAAE,cAAc,CAAC,oBAAoB,CA4E3E,CAAC"}