@agentxm/client-core 0.1.6 → 0.3.1

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"}

package/dist/src/unstable/lint/catalog/workspace/helpers/install-ops.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Helpers for emitting the 14 per-extension Operation values used by the
+ * workspace autofix rules.
+ *
+ * Autofix `fix` methods MUST compose from the 14-Operation vocabulary per
+ * `docs/design/lint-engine.md §6`. Wiring to the canonical `OperationHandler`
+ * registry (which expects fully-resolved `SkillExtensionRef` / `PackRef`
+ * values) happens at the CLI layer (Phase 5); at the lint layer we emit the
+ * Operation **intent** — minimal args capturing what reinstall / uninstall /
+ * enable / disable means for a named extension. The determinism harness
+ * interprets these intents against an in-memory state model.
+ *
+ * Shape consistency matters: the args shape below is the contract the
+ * harness interprets. Phase 5's CLI adapter lowers these intents into the
+ * fully-resolved Operation values the handlers expect.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { Operation } from "../../../../plan/plan.js";
+import type { Settings } from "../../../../settings/schema.js";
+/**
+ * Install-skill intent emitted by an autofixing workspace rule.
+ *
+ * - `name` — lockfile key (and sanitized filesystem name).
+ * - `source` — source string from settings (e.g. `@acme/skills/axm`).
+ * - `force` — when `true`, the handler reinstalls unconditionally (used by
+ *   integrity + artifact-clean dangling arms).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface InstallSkillIntent {
+    readonly name: string;
+    readonly source: string;
+    readonly force: boolean;
+}
+/** @experimental */
+export interface UninstallSkillIntent {
+    readonly name: string;
+}
+/** @experimental */
+export interface EnableSkillIntent {
+    readonly name: string;
+}
+/** @experimental */
+export interface DisableSkillIntent {
+    readonly name: string;
+}
+/** @experimental */
+export interface InstallPackIntent {
+    readonly name: string;
+    readonly source: string;
+    readonly force: boolean;
+}
+/** @experimental */
+export interface UninstallPackIntent {
+    readonly name: string;
+}
+/** @experimental */
+export interface InstallCommandIntent {
+    readonly name: string;
+    readonly source: string;
+    readonly force: boolean;
+}
+/** @experimental */
+export interface UninstallCommandIntent {
+    readonly name: string;
+}
+/** @experimental */
+export interface EnableCommandIntent {
+    readonly name: string;
+}
+/** @experimental */
+export interface DisableCommandIntent {
+    readonly name: string;
+}
+/** @experimental */
+export interface InstallMcpServerIntent {
+    readonly name: string;
+    readonly source: string;
+    readonly force: boolean;
+}
+/** @experimental */
+export interface UninstallMcpServerIntent {
+    readonly name: string;
+}
+/** @experimental */
+export interface EnableSubagentIntent {
+    readonly name: string;
+}
+/** @experimental */
+export interface DisableSubagentIntent {
+    readonly name: string;
+}
+export declare const installSkillOp: (intent: InstallSkillIntent) => Operation<"install-skill", InstallSkillIntent>;
+export declare const uninstallSkillOp: (intent: UninstallSkillIntent) => Operation<"uninstall-skill", UninstallSkillIntent>;
+export declare const enableSkillOp: (intent: EnableSkillIntent) => Operation<"enable-skill", EnableSkillIntent>;
+export declare const disableSkillOp: (intent: DisableSkillIntent) => Operation<"disable-skill", DisableSkillIntent>;
+export declare const installPackOp: (intent: InstallPackIntent) => Operation<"install-pack", InstallPackIntent>;
+export declare const uninstallPackOp: (intent: UninstallPackIntent) => Operation<"uninstall-pack", UninstallPackIntent>;
+export declare const installCommandOp: (intent: InstallCommandIntent) => Operation<"install-command", InstallCommandIntent>;
+export declare const uninstallCommandOp: (intent: UninstallCommandIntent) => Operation<"uninstall-command", UninstallCommandIntent>;
+export declare const enableCommandOp: (intent: EnableCommandIntent) => Operation<"enable-command", EnableCommandIntent>;
+export declare const disableCommandOp: (intent: DisableCommandIntent) => Operation<"disable-command", DisableCommandIntent>;
+export declare const installMcpServerOp: (intent: InstallMcpServerIntent) => Operation<"install-mcp-server", InstallMcpServerIntent>;
+export declare const uninstallMcpServerOp: (intent: UninstallMcpServerIntent) => Operation<"uninstall-mcp-server", UninstallMcpServerIntent>;
+export declare const enableSubagentOp: (intent: EnableSubagentIntent) => Operation<"enable-subagent", EnableSubagentIntent>;
+export declare const disableSubagentOp: (intent: DisableSubagentIntent) => Operation<"disable-subagent", DisableSubagentIntent>;
+/**
+ * The 14 per-extension Operation names lint autofix is allowed to emit.
+ *
+ * The guard test (`workspace-guard.test.ts`, task 3c.29) asserts no
+ * autofixing workspace rule emits an Operation outside this set and that
+ * no rule body references `syncWorkspace()` or a similar top-level
+ * reconcile entry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const PER_EXTENSION_OPERATION_NAMES: readonly ["install-skill", "uninstall-skill", "enable-skill", "disable-skill", "install-pack", "uninstall-pack", "install-command", "uninstall-command", "enable-command", "disable-command", "install-mcp-server", "uninstall-mcp-server", "enable-subagent", "disable-subagent"];
+/** @experimental */
+export type PerExtensionOperationName = (typeof PER_EXTENSION_OPERATION_NAMES)[number];
+/** @experimental */
+export declare const isPerExtensionOperationName: (name: string) => name is PerExtensionOperationName;
+/**
+ * Emit one `install-{type}` Operation per declared entry in `settings`,
+ * across all five installable types. Used by
+ * `workspace/lockfile-valid` missing-arm autofix — each declaration produces
+ * a reinstall intent, and the handler side-effects recreate the lockfile.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const collectMissingLockfileInstallOps: (settings: Settings) => ReadonlyArray<Operation<string, unknown>>;
+//# sourceMappingURL=install-ops.d.ts.map

package/dist/src/unstable/lint/catalog/workspace/helpers/install-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-ops.d.ts","sourceRoot":"","sources":["../../../../../../../src/unstable/lint/catalog/workspace/helpers/install-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAM/D;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,oBAAoB;AACpB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,oBAAoB;AACpB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,oBAAoB;AACpB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,oBAAoB;AACpB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,oBAAoB;AACpB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,oBAAoB;AACpB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,oBAAoB;AACpB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,oBAAoB;AACpB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,oBAAoB;AACpB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,oBAAoB;AACpB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,oBAAoB;AACpB,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,oBAAoB;AACpB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,oBAAoB;AACpB,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAMD,eAAO,MAAM,cAAc,GACzB,QAAQ,kBAAkB,KACzB,SAAS,CAAC,eAAe,EAAE,kBAAkB,CAG9C,CAAC;AAEH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,oBAAoB,KAC3B,SAAS,CAAC,iBAAiB,EAAE,oBAAoB,CAGlD,CAAC;AAEH,eAAO,MAAM,aAAa,GACxB,QAAQ,iBAAiB,KACxB,SAAS,CAAC,cAAc,EAAE,iBAAiB,CAG5C,CAAC;AAEH,eAAO,MAAM,cAAc,GACzB,QAAQ,kBAAkB,KACzB,SAAS,CAAC,eAAe,EAAE,kBAAkB,CAG9C,CAAC;AAEH,eAAO,MAAM,aAAa,GACxB,QAAQ,iBAAiB,KACxB,SAAS,CAAC,cAAc,EAAE,iBAAiB,CAG5C,CAAC;AAEH,eAAO,MAAM,eAAe,GAC1B,QAAQ,mBAAmB,KAC1B,SAAS,CAAC,gBAAgB,EAAE,mBAAmB,CAGhD,CAAC;AAEH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,oBAAoB,KAC3B,SAAS,CAAC,iBAAiB,EAAE,oBAAoB,CAGlD,CAAC;AAEH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,sBAAsB,KAC7B,SAAS,CAAC,mBAAmB,EAAE,sBAAsB,CAGtD,CAAC;AAEH,eAAO,MAAM,eAAe,GAC1B,QAAQ,mBAAmB,KAC1B,SAAS,CAAC,gBAAgB,EAAE,mBAAmB,CAGhD,CAAC;AAEH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,oBAAoB,KAC3B,SAAS,CAAC,iBAAiB,EAAE,oBAAoB,CAGlD,CAAC;AAEH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,sBAAsB,KAC7B,SAAS,CAAC,oBAAoB,EAAE,sBAAsB,CAGvD,CAAC;AAEH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,wBAAwB,KAC/B,SAAS,CAAC,sBAAsB,EAAE,wBAAwB,CAG3D,CAAC;AAEH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,oBAAoB,KAC3B,SAAS,CAAC,iBAAiB,EAAE,oBAAoB,CAGlD,CAAC;AAEH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,qBAAqB,KAC5B,SAAS,CAAC,kBAAkB,EAAE,qBAAqB,CAGpD,CAAC;AAMH;;;;;;;;;GASG;AACH,eAAO,MAAM,6BAA6B,oRAehC,CAAC;AAEX,oBAAoB;AACpB,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAIvF,oBAAoB;AACpB,eAAO,MAAM,2BAA2B,GAAI,MAAM,MAAM,KAAG,IAAI,IAAI,yBAC5B,CAAC;AAMxC;;;;;;;GAOG;AACH,eAAO,MAAM,gCAAgC,GAC3C,UAAU,QAAQ,KACjB,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CA0B1C,CAAC"}

package/dist/src/unstable/lint/catalog/workspace/helpers/install-ops.js

@@ -0,0 +1,149 @@
+/**
+ * Helpers for emitting the 14 per-extension Operation values used by the
+ * workspace autofix rules.
+ *
+ * Autofix `fix` methods MUST compose from the 14-Operation vocabulary per
+ * `docs/design/lint-engine.md §6`. Wiring to the canonical `OperationHandler`
+ * registry (which expects fully-resolved `SkillExtensionRef` / `PackRef`
+ * values) happens at the CLI layer (Phase 5); at the lint layer we emit the
+ * Operation **intent** — minimal args capturing what reinstall / uninstall /
+ * enable / disable means for a named extension. The determinism harness
+ * interprets these intents against an in-memory state model.
+ *
+ * Shape consistency matters: the args shape below is the contract the
+ * harness interprets. Phase 5's CLI adapter lowers these intents into the
+ * fully-resolved Operation values the handlers expect.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+// -----------------------------------------------------------------------------
+// Emit helpers
+// -----------------------------------------------------------------------------
+export const installSkillOp = (intent) => ({
+    name: "install-skill",
+    args: intent,
+});
+export const uninstallSkillOp = (intent) => ({
+    name: "uninstall-skill",
+    args: intent,
+});
+export const enableSkillOp = (intent) => ({
+    name: "enable-skill",
+    args: intent,
+});
+export const disableSkillOp = (intent) => ({
+    name: "disable-skill",
+    args: intent,
+});
+export const installPackOp = (intent) => ({
+    name: "install-pack",
+    args: intent,
+});
+export const uninstallPackOp = (intent) => ({
+    name: "uninstall-pack",
+    args: intent,
+});
+export const installCommandOp = (intent) => ({
+    name: "install-command",
+    args: intent,
+});
+export const uninstallCommandOp = (intent) => ({
+    name: "uninstall-command",
+    args: intent,
+});
+export const enableCommandOp = (intent) => ({
+    name: "enable-command",
+    args: intent,
+});
+export const disableCommandOp = (intent) => ({
+    name: "disable-command",
+    args: intent,
+});
+export const installMcpServerOp = (intent) => ({
+    name: "install-mcp-server",
+    args: intent,
+});
+export const uninstallMcpServerOp = (intent) => ({
+    name: "uninstall-mcp-server",
+    args: intent,
+});
+export const enableSubagentOp = (intent) => ({
+    name: "enable-subagent",
+    args: intent,
+});
+export const disableSubagentOp = (intent) => ({
+    name: "disable-subagent",
+    args: intent,
+});
+// -----------------------------------------------------------------------------
+// Vocabulary guard — the canonical 14-operation vocabulary.
+// -----------------------------------------------------------------------------
+/**
+ * The 14 per-extension Operation names lint autofix is allowed to emit.
+ *
+ * The guard test (`workspace-guard.test.ts`, task 3c.29) asserts no
+ * autofixing workspace rule emits an Operation outside this set and that
+ * no rule body references `syncWorkspace()` or a similar top-level
+ * reconcile entry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const PER_EXTENSION_OPERATION_NAMES = [
+    "install-skill",
+    "uninstall-skill",
+    "enable-skill",
+    "disable-skill",
+    "install-pack",
+    "uninstall-pack",
+    "install-command",
+    "uninstall-command",
+    "enable-command",
+    "disable-command",
+    "install-mcp-server",
+    "uninstall-mcp-server",
+    "enable-subagent",
+    "disable-subagent",
+];
+const PER_EXTENSION_OPERATION_SET = new Set(PER_EXTENSION_OPERATION_NAMES);
+/** @experimental */
+export const isPerExtensionOperationName = (name) => PER_EXTENSION_OPERATION_SET.has(name);
+// -----------------------------------------------------------------------------
+// Bulk emitters
+// -----------------------------------------------------------------------------
+/**
+ * Emit one `install-{type}` Operation per declared entry in `settings`,
+ * across all five installable types. Used by
+ * `workspace/lockfile-valid` missing-arm autofix — each declaration produces
+ * a reinstall intent, and the handler side-effects recreate the lockfile.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const collectMissingLockfileInstallOps = (settings) => {
+    const ops = [];
+    for (const [name, entry] of Object.entries(settings.skills ?? {})) {
+        ops.push(installSkillOp({ name, source: entry.source, force: false }));
+    }
+    for (const [name, entry] of Object.entries(settings.packs ?? {})) {
+        ops.push(installPackOp({ name, source: entry.source, force: false }));
+    }
+    for (const [name, entry] of Object.entries(settings.commands ?? {})) {
+        ops.push(installCommandOp({ name, source: entry.source, force: false }));
+    }
+    for (const [name, entry] of Object.entries(settings.subagents ?? {})) {
+        // Subagents install-handler ships in a later install family; v1 emits a
+        // no-op install-command for consistency… Actually, per the 14-op
+        // vocabulary subagents have only enable/disable Operations at v1 (their
+        // install family defers); emitting only enable here would be wrong.
+        // Skip subagents in the missing-arm autofix for now — the lockfile
+        // recreation is approximate, and subagent install is tracked as a v1.5+
+        // item.
+        void name;
+        void entry;
+    }
+    for (const [name, entry] of Object.entries(settings.mcpServers ?? {})) {
+        ops.push(installMcpServerOp({ name, source: entry.source, force: false }));
+    }
+    return ops;
+};
+//# sourceMappingURL=install-ops.js.map

package/dist/src/unstable/lint/catalog/workspace/helpers/install-ops.js.map

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

package/dist/src/unstable/lint/catalog/workspace/helpers/registry-source.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Registry-source parsing helper for workspace rules.
+ *
+ * Thin re-export over `parseRegistrySourceRef` so workspace rule bodies don't
+ * depend directly on the extensions module's internal layout. When the
+ * canonical parser changes, this shim stays.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+/** @experimental */
+export interface RegistrySourceParts {
+    readonly owner: string;
+    readonly type: string;
+    readonly name: string;
+    readonly versionConstraint: string | undefined;
+}
+/**
+ * Parse a source string into its registry parts, or `undefined` when the
+ * source doesn't look like a registry ref.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const parseRegistrySource: (source: string) => RegistrySourceParts | undefined;
+//# sourceMappingURL=registry-source.d.ts.map

package/dist/src/unstable/lint/catalog/workspace/helpers/registry-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-source.d.ts","sourceRoot":"","sources":["../../../../../../../src/unstable/lint/catalog/workspace/helpers/registry-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,oBAAoB;AACpB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;CAChD;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,MAAM,KAAG,mBAAmB,GAAG,SAW1E,CAAC"}

package/dist/src/unstable/lint/catalog/workspace/helpers/registry-source.js

@@ -0,0 +1,30 @@
+/**
+ * Registry-source parsing helper for workspace rules.
+ *
+ * Thin re-export over `parseRegistrySourceRef` so workspace rule bodies don't
+ * depend directly on the extensions module's internal layout. When the
+ * canonical parser changes, this shim stays.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import { parseRegistrySourceRef } from "../../../../extensions/registry-source.js";
+/**
+ * Parse a source string into its registry parts, or `undefined` when the
+ * source doesn't look like a registry ref.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const parseRegistrySource = (source) => {
+    const parsed = parseRegistrySourceRef(source);
+    if (parsed === undefined) {
+        return undefined;
+    }
+    return {
+        owner: parsed.owner,
+        type: parsed.type,
+        name: parsed.name,
+        versionConstraint: parsed.versionConstraint,
+    };
+};
+//# sourceMappingURL=registry-source.js.map

package/dist/src/unstable/lint/catalog/workspace/helpers/registry-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-source.js","sourceRoot":"","sources":["../../../../../../../src/unstable/lint/catalog/workspace/helpers/registry-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAUnF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAc,EAAmC,EAAE;IACrF,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;KAC5C,CAAC;AACJ,CAAC,CAAC"}