@agentxm/client-core 0.2.0 → 0.3.2

package/dist/src/unstable/lint/cli.js.map

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

package/dist/src/unstable/lint/compose-path.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `composePath` — render a display path from a rule context's `displayRoot`
+ * and a finding's accessor-relative `location.file`.
+ *
+ * Rules emit accessor-relative `location.file` values only; messages carry no
+ * paths or coordinates. The format-time composition here lets the same rule
+ * render different paths for publish (`displayRoot: ""`), registry-installed
+ * skills, external skills, and workspace-scope findings.
+ *
+ * The rendered path is posix, prefixed with `./` so logs are unambiguous
+ * about relative-ness. `location.line` / `location.column` append as
+ * `:line:column` when present.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { FindingLocation } from "./rule.js";
+/**
+ * Compose the rendered path for a finding.
+ *
+ * @param displayRoot - Context-supplied posix-relative root (or `""`).
+ * @param location    - Accessor-relative file + optional coordinates.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const composePath: (displayRoot: string, location: FindingLocation | undefined) => string;
+//# sourceMappingURL=compose-path.d.ts.map

package/dist/src/unstable/lint/compose-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-path.d.ts","sourceRoot":"","sources":["../../../../src/unstable/lint/compose-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAMjD;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GAAI,aAAa,MAAM,EAAE,UAAU,eAAe,GAAG,SAAS,KAAG,MAOxF,CAAC"}

package/dist/src/unstable/lint/compose-path.js

@@ -0,0 +1,61 @@
+/**
+ * `composePath` — render a display path from a rule context's `displayRoot`
+ * and a finding's accessor-relative `location.file`.
+ *
+ * Rules emit accessor-relative `location.file` values only; messages carry no
+ * paths or coordinates. The format-time composition here lets the same rule
+ * render different paths for publish (`displayRoot: ""`), registry-installed
+ * skills, external skills, and workspace-scope findings.
+ *
+ * The rendered path is posix, prefixed with `./` so logs are unambiguous
+ * about relative-ness. `location.line` / `location.column` append as
+ * `:line:column` when present.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+// -----------------------------------------------------------------------------
+// composePath
+// -----------------------------------------------------------------------------
+/**
+ * Compose the rendered path for a finding.
+ *
+ * @param displayRoot - Context-supplied posix-relative root (or `""`).
+ * @param location    - Accessor-relative file + optional coordinates.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const composePath = (displayRoot, location) => {
+    const base = joinPosix(displayRoot, location?.file ?? "");
+    const withPrefix = base === "" ? "." : base.startsWith("./") ? base : `./${base}`;
+    if (location === undefined) {
+        return withPrefix;
+    }
+    return appendCoordinates(withPrefix, location);
+};
+const joinPosix = (left, right) => {
+    const l = stripTrailingSlash(left);
+    const r = stripLeadingSlash(right);
+    if (l === "" && r === "") {
+        return "";
+    }
+    if (l === "") {
+        return r;
+    }
+    if (r === "") {
+        return l;
+    }
+    return `${l}/${r}`;
+};
+const stripTrailingSlash = (s) => (s.endsWith("/") ? s.slice(0, -1) : s);
+const stripLeadingSlash = (s) => (s.startsWith("/") ? s.slice(1) : s);
+const appendCoordinates = (path, location) => {
+    if (location.line === undefined) {
+        return path;
+    }
+    if (location.column === undefined) {
+        return `${path}:${location.line}`;
+    }
+    return `${path}:${location.line}:${location.column}`;
+};
+//# sourceMappingURL=compose-path.js.map

package/dist/src/unstable/lint/compose-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-path.js","sourceRoot":"","sources":["../../../../src/unstable/lint/compose-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,WAAmB,EAAE,QAAqC,EAAU,EAAE;IAChG,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;IAClF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AACjD,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,KAAa,EAAU,EAAE;IACxD,MAAM,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QACb,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QACb,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;AACrB,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACzF,MAAM,iBAAiB,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEtF,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAE,QAAyB,EAAU,EAAE;IAC5E,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,GAAG,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;IACpC,CAAC;IACD,OAAO,GAAG,IAAI,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;AACvD,CAAC,CAAC"}

package/dist/src/unstable/lint/config.d.ts

@@ -0,0 +1,103 @@
+/**
+ * `LintConfig` — workspace-settings-level lint configuration.
+ *
+ * Workspace `.axm/settings.json` carries a `lint` section whose `rules` map
+ * binds rule ids to `"off" | "info" | "warn" | "error"`. The registry publish
+ * gate ignores workspace overrides; this config affects `axm lint` only.
+ *
+ * Keys are **exact** rule ids (`<namespace>/<name>`). No glob, wildcard, or
+ * regex syntax is accepted in v1. The accepted-key set is built at schema
+ * construction time from rule ids registered via `registerLintRuleIds` — the
+ * three v1 catalogs (`skill/*`, `pack/*`, `workspace/*`) each register their
+ * ids so adding a catalog in a later phase extends the set by construction.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Schema from "effect/Schema";
+/**
+ * Accepted values for a `lint.rules` entry.
+ *
+ * Note: `"warn"` is the config surface for `Severity` `"warning"`; mirror's
+ * ESLint convention. The evaluator treats `"warn"` as equivalent to `warning`
+ * severity; `"off"` suppresses emission.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const LintRuleSeveritySchema: Schema.Literals<readonly ["off", "info", "warn", "error"]>;
+/**
+ * Effective severity of a `lint.rules` entry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type LintRuleSeverity = Schema.Schema.Type<typeof LintRuleSeveritySchema>;
+/**
+ * Register one or more rule ids into the config allowlist.
+ *
+ * Each v1 rule catalog calls this once at module-load to extend the set of
+ * accepted `lint.rules` keys. Calls are additive and idempotent — registering
+ * an id twice is a no-op. A rule id that isn't registered will cause
+ * `SettingsSchema` decode to fail at the `lint.rules` key, surfacing the
+ * unknown id in the error path.
+ *
+ * Consumers (Phases 3a/3b/3c) should register from the catalog module by
+ * iterating the catalog's own rule array: no copy-paste of rule ids into this
+ * file.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const registerLintRuleIds: (ids: Iterable<string>) => void;
+/**
+ * Read-only view of the currently-registered rule ids.
+ *
+ * Mainly useful for tests and snapshots; production callers should not depend
+ * on ordering.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const registeredLintRuleIds: () => ReadonlySet<string>;
+/**
+ * Record of `<namespace>/<name>` ids to severity overrides.
+ *
+ * Unknown / wildcard / regex keys are rejected at decode by the filter — the
+ * filter walks the decoded record's keys and checks every key against the
+ * registered rule-id set. Wildcard patterns like `"skill/*"` fail the filter
+ * because they are not registered ids.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const LintRulesMapSchema: Schema.$Record<Schema.String, Schema.Literals<readonly ["off", "info", "warn", "error"]>>;
+/**
+ * Inferred type for `LintRulesMap`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type LintRulesMap = Schema.Schema.Type<typeof LintRulesMapSchema>;
+/**
+ * `lint` section of `.axm/settings.json`.
+ *
+ * Today only `rules` is defined; future fields (per-rule options, reporter
+ * selection) extend this struct. The schema rejects excess top-level keys so
+ * typos surface at decode.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const LintConfigSchema: Schema.Struct<{
+    readonly rules: Schema.optional<Schema.$Record<Schema.String, Schema.Literals<readonly ["off", "info", "warn", "error"]>>>;
+}>;
+/**
+ * Inferred type for `LintConfig`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type LintConfig = Schema.Schema.Type<typeof LintConfigSchema>;
+/**
+ * The platform-canonical `LintConfig` — empty rules, no overrides.
+ *
+ * Registry publish uses this config; it carries no overrides so every rule
+ * fires at its catalog severity.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const platformCanonicalLintConfig: LintConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/unstable/lint/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/unstable/lint/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAMxC;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,4DAKjC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAiBjF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,QAAQ,CAAC,MAAM,CAAC,KAAG,IAI3D,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,QAAO,WAAW,CAAC,MAAM,CAAsB,CAAC;AAqBlF;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,2FAM3B,CAAC;AAEL;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAMzE;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB;;EAM3B,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAErE;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,EAAE,UAA0B,CAAC"}

package/dist/src/unstable/lint/config.js

@@ -0,0 +1,137 @@
+/**
+ * `LintConfig` — workspace-settings-level lint configuration.
+ *
+ * Workspace `.axm/settings.json` carries a `lint` section whose `rules` map
+ * binds rule ids to `"off" | "info" | "warn" | "error"`. The registry publish
+ * gate ignores workspace overrides; this config affects `axm lint` only.
+ *
+ * Keys are **exact** rule ids (`<namespace>/<name>`). No glob, wildcard, or
+ * regex syntax is accepted in v1. The accepted-key set is built at schema
+ * construction time from rule ids registered via `registerLintRuleIds` — the
+ * three v1 catalogs (`skill/*`, `pack/*`, `workspace/*`) each register their
+ * ids so adding a catalog in a later phase extends the set by construction.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Schema from "effect/Schema";
+// -----------------------------------------------------------------------------
+// Config value schema
+// -----------------------------------------------------------------------------
+/**
+ * Accepted values for a `lint.rules` entry.
+ *
+ * Note: `"warn"` is the config surface for `Severity` `"warning"`; mirror's
+ * ESLint convention. The evaluator treats `"warn"` as equivalent to `warning`
+ * severity; `"off"` suppresses emission.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const LintRuleSeveritySchema = Schema.Literals(["off", "info", "warn", "error"]).annotate({
+    identifier: "LintRuleSeverity",
+    title: "Lint Rule Severity",
+    description: "Severity override for a lint rule: 'off' silences it, 'info'/'warn'/'error' raise or lower severity.",
+});
+// -----------------------------------------------------------------------------
+// Registered rule-id allowlist
+// -----------------------------------------------------------------------------
+/**
+ * Internal mutable registry of accepted rule ids, populated at module-load
+ * time by each rule catalog's side-effecting `registerLintRuleIds` call.
+ *
+ * The registry is module-local so callers in other packages can't extend it
+ * without going through `registerLintRuleIds`; the v1 catalogs register from
+ * `./catalog/skill.ts`, `./catalog/pack.ts`, and `./catalog/workspace.ts` in
+ * Phases 3a/3b/3c.
+ */
+const registeredRuleIds = new Set();
+/**
+ * Register one or more rule ids into the config allowlist.
+ *
+ * Each v1 rule catalog calls this once at module-load to extend the set of
+ * accepted `lint.rules` keys. Calls are additive and idempotent — registering
+ * an id twice is a no-op. A rule id that isn't registered will cause
+ * `SettingsSchema` decode to fail at the `lint.rules` key, surfacing the
+ * unknown id in the error path.
+ *
+ * Consumers (Phases 3a/3b/3c) should register from the catalog module by
+ * iterating the catalog's own rule array: no copy-paste of rule ids into this
+ * file.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const registerLintRuleIds = (ids) => {
+    for (const id of ids) {
+        registeredRuleIds.add(id);
+    }
+};
+/**
+ * Read-only view of the currently-registered rule ids.
+ *
+ * Mainly useful for tests and snapshots; production callers should not depend
+ * on ordering.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const registeredLintRuleIds = () => registeredRuleIds;
+// -----------------------------------------------------------------------------
+// Rules map schema
+// -----------------------------------------------------------------------------
+const ruleIdKeyFilter = Schema.makeFilter((input) => {
+    const invalid = [];
+    for (const key of Object.keys(input)) {
+        if (!registeredRuleIds.has(key)) {
+            invalid.push(key);
+        }
+    }
+    if (invalid.length === 0) {
+        return undefined;
+    }
+    return `Unknown lint rule id(s) in lint.rules: ${invalid.join(", ")}. Keys must be exact <namespace>/<name> ids; wildcards and globs are not supported.`;
+});
+/**
+ * Record of `<namespace>/<name>` ids to severity overrides.
+ *
+ * Unknown / wildcard / regex keys are rejected at decode by the filter — the
+ * filter walks the decoded record's keys and checks every key against the
+ * registered rule-id set. Wildcard patterns like `"skill/*"` fail the filter
+ * because they are not registered ids.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const LintRulesMapSchema = Schema.Record(Schema.String, LintRuleSeveritySchema)
+    .check(ruleIdKeyFilter)
+    .annotate({
+    identifier: "LintRulesMap",
+    title: "Lint Rules Map",
+    description: "Map of exact <namespace>/<name> rule ids to severity overrides for `axm lint`.",
+});
+// -----------------------------------------------------------------------------
+// LintConfig schema
+// -----------------------------------------------------------------------------
+/**
+ * `lint` section of `.axm/settings.json`.
+ *
+ * Today only `rules` is defined; future fields (per-rule options, reporter
+ * selection) extend this struct. The schema rejects excess top-level keys so
+ * typos surface at decode.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const LintConfigSchema = Schema.Struct({
+    rules: Schema.optional(LintRulesMapSchema),
+}).annotate({
+    identifier: "LintConfig",
+    title: "Lint Config",
+    description: "Workspace lint configuration under `lint` in `.axm/settings.json`.",
+});
+/**
+ * The platform-canonical `LintConfig` — empty rules, no overrides.
+ *
+ * Registry publish uses this config; it carries no overrides so every rule
+ * fires at its catalog severity.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const platformCanonicalLintConfig = { rules: {} };
+//# sourceMappingURL=config.js.map

package/dist/src/unstable/lint/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../src/unstable/lint/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC/F,UAAU,EAAE,kBAAkB;IAC9B,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EACT,sGAAsG;CACzG,CAAC,CAAC;AASH,gFAAgF;AAChF,+BAA+B;AAC/B,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;AAE5C;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAqB,EAAQ,EAAE;IACjE,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAwB,EAAE,CAAC,iBAAiB,CAAC;AAElF,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,MAAM,eAAe,GAAG,MAAM,CAAC,UAAU,CACvC,CAAC,KAAwC,EAAsB,EAAE;IAC/D,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,0CAA0C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,qFAAqF,CAAC;AAC3J,CAAC,CACF,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC;KACnF,KAAK,CAAC,eAAe,CAAC;KACtB,QAAQ,CAAC;IACR,UAAU,EAAE,cAAc;IAC1B,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE,gFAAgF;CAC9F,CAAC,CAAC;AASL,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC;CAC3C,CAAC,CAAC,QAAQ,CAAC;IACV,UAAU,EAAE,YAAY;IACxB,KAAK,EAAE,aAAa;IACpB,WAAW,EAAE,oEAAoE;CAClF,CAAC,CAAC;AASH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAe,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC"}

package/dist/src/unstable/lint/context.d.ts

@@ -0,0 +1,265 @@
+/**
+ * Rule-context types and narrow accessors.
+ *
+ * Each rule-context type bundles a caller-decoded `subject` with a narrow
+ * caller-bound accessor and a `displayRoot` used for path rendering. Rules
+ * consume accessors as ordinary property access (no Layer wiring); tests pass
+ * literal fakes.
+ *
+ * Phase 2 pins the context shapes and accessor interfaces. Phases 3a, 3b, and
+ * 3c land the concrete `subject` decoders and VFT-/platform-backed accessor
+ * implementations.
+ *
+ * Accessor surfaces are intentionally minimal — rules SHALL see only the
+ * methods the v1 catalog requires. Extending a surface is a Phase 3a/3b/3c
+ * action with a documented rule consumer, not a free action.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type * as Effect from "effect/Effect";
+import type * as Option from "effect/Option";
+import type { AgentDescriptor, AgentId } from "../agents/types.js";
+/**
+ * Tagged error surfaced by `SkillFileAccessor` / `PackFileAccessor` when a
+ * read fails for reasons other than "file not found" (which is represented
+ * by `exists -> false`).
+ *
+ * Concrete implementations live in Phases 3a/3b; this interface fixes the
+ * error shape rules can rely on.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface FileAccessError {
+    readonly _tag: "FileAccessError";
+    /** Accessor-relative posix path that failed. */
+    readonly path: string;
+    /** Machine-readable reason. */
+    readonly reason: "path-escape" | "read-error" | "io-error";
+    /** Human-readable detail; no rendered display path. */
+    readonly message: string;
+}
+/**
+ * Narrow skill-rooted file accessor.
+ *
+ * Root is the directory containing `SKILL.md`. Paths are posix and relative
+ * to the root; implementations MUST reject path-traversal attempts (`..`,
+ * absolute paths, symlink escapes) by returning `false` from `exists` or
+ * failing `readBytes` with `FileAccessError { reason: "path-escape" }`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface SkillFileAccessor {
+    readonly exists: (path: string) => Effect.Effect<boolean>;
+    readonly readBytes: (path: string) => Effect.Effect<Uint8Array, FileAccessError>;
+}
+/**
+ * Narrow pack-rooted file accessor.
+ *
+ * Root is the directory containing `extension-pack.json`. Same traversal
+ * constraints as `SkillFileAccessor`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface PackFileAccessor {
+    readonly exists: (path: string) => Effect.Effect<boolean>;
+    readonly readBytes: (path: string) => Effect.Effect<Uint8Array, FileAccessError>;
+}
+/**
+ * Raw workspace `settings.json` document as returned by the accessor.
+ *
+ * The accessor parses JSON but does NOT decode via `SettingsSchema` — the
+ * decode arm is the job of `workspace/settings-schema-valid`. Rules that
+ * need a typed shape call `Schema.decodeUnknown(SettingsSchema)` locally;
+ * those decodes produce no findings because `workspace/settings-schema-valid`
+ * already emits them.
+ *
+ * A `SettingsReadError` on the accessor's `settings` Effect means the bytes
+ * were unreadable or failed JSON.parse. Absence of the file surfaces via
+ * `exists(".axm/settings.json") -> false` and is owned by
+ * `workspace/initialized`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type SettingsDocument = unknown;
+/**
+ * Raw workspace `axm-lock.yaml` document as returned by the accessor.
+ *
+ * The accessor parses YAML but does NOT decode via `LockfileSchema` — the
+ * decode arm is the job of `workspace/lockfile-valid`. Rules that need a
+ * typed shape call `Schema.decodeUnknown(LockfileSchema)` locally; those
+ * decodes produce no findings because `workspace/lockfile-valid` already
+ * emits them.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type LockfileDocument = unknown;
+/**
+ * Tagged error surfaced by workspace-level reads.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface SettingsReadError {
+    readonly _tag: "SettingsReadError";
+    readonly message: string;
+}
+/**
+ * Tagged error surfaced by workspace lockfile reads.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface LockfileReadError {
+    readonly _tag: "LockfileReadError";
+    readonly message: string;
+}
+/**
+ * A detected-but-not-declared coding agent surfaced by
+ * `WorkspaceLintAccessor.detectAgents`. Phase 3c refines this if the detector
+ * lands additional probe metadata.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface AgentDetection {
+    readonly id: AgentId;
+    /** Path (posix, accessor-relative) that led to the detection. */
+    readonly markerPath: string;
+}
+/**
+ * Narrow workspace-rooted accessor.
+ *
+ * Exposes only the methods the v1 workspace catalog consumes; see `lint-engine`
+ * spec "Workspace accessor exposes only v1 methods." Extending this interface
+ * requires a concrete rule that needs the added method.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface WorkspaceLintAccessor {
+    readonly settings: Effect.Effect<SettingsDocument, SettingsReadError>;
+    readonly lockfile: Effect.Effect<Option.Option<LockfileDocument>, LockfileReadError>;
+    readonly installedSkills: Effect.Effect<ReadonlyArray<SkillRuleContext>>;
+    readonly installedPacks: Effect.Effect<ReadonlyArray<PackRuleContext>>;
+    readonly knownAgents: Effect.Effect<ReadonlyArray<AgentDescriptor>>;
+    readonly detectAgents: (scope: "project" | "user") => Effect.Effect<ReadonlyArray<AgentDetection>>;
+    readonly exists: (path: string) => Effect.Effect<boolean>;
+    readonly isWritable: (path: string) => Effect.Effect<boolean>;
+    readonly list: (path: string) => Effect.Effect<ReadonlyArray<string>, FileAccessError>;
+}
+/**
+ * Context passed to `skill/*` rules.
+ *
+ * `subject` is the caller-decoded skill content (SKILL.md frontmatter +
+ * optional skill.json). Phase 3a refines the `subject` type to the concrete
+ * `SkillContent` shape; Phase 2 leaves it structurally open so the rule
+ * primitives don't need a circular dependency on the skill module.
+ *
+ * `displayRoot` is posix and relative; `""` means the accessor root is the
+ * rendering base. See `./compose-path.ts` for the four documented cases.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface SkillRuleContext<S = SkillContent> {
+    readonly subject: S;
+    readonly files: SkillFileAccessor;
+    readonly displayRoot: string;
+}
+/**
+ * Concrete subject shape passed to `skill/*` rules.
+ *
+ * Rules read `SKILL.md` bytes through `context.files` (the authoritative
+ * source shared across publish and `axm lint`). The `subject` carries only
+ * what rules can't efficiently re-derive from bytes:
+ *
+ * - `isNative` — whether the caller expects this skill to carry a
+ *   `skill.json` manifest. Native (registry-installed) skills set this to
+ *   `true`; non-native (managed external) skills set it to `false`. Rules
+ *   that depend on `skill.json` (`skill/manifest-present`,
+ *   `skill/manifest-schema-valid`, `skill/manifest-keys-recognized`)
+ *   early-return `[]` when `isNative === false`, so the same catalog covers
+ *   both.
+ * - `skillJson` — the already-decoded `skill.json` contents when present
+ *   (caller decodes once, rules don't re-read + re-parse). `undefined` when
+ *   the file is absent. Schema-valid rules pipe this into
+ *   `Schema.decodeUnknownResult(SkillManifestSchema)`; keys-recognized
+ *   enumerates top-level keys after narrowing to `Record<string, unknown>`.
+ *
+ * Phase 3b and 3c consumers build `SkillContent` via
+ * `buildSkillRuleContexts` (this phase) against the `WorkspaceIndex`
+ * surface; publish (Phase 4, this-repo) builds one `SkillContent` per
+ * incoming archive.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface SkillContent {
+    readonly isNative: boolean;
+    readonly skillJson: unknown;
+}
+/**
+ * Context passed to `pack/*` rules.
+ *
+ * `subject` is the caller-decoded pack content — concrete `PackContent` shape
+ * defined below. Packs are registry-only at v1 (no non-native arm), so the
+ * subject carries only the already-decoded manifest and rules read
+ * `extension-pack.json` bytes through `context.files` as needed.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface PackRuleContext<S = PackContent> {
+    readonly subject: S;
+    readonly files: PackFileAccessor;
+    readonly displayRoot: string;
+}
+/**
+ * Concrete subject shape passed to `pack/*` rules.
+ *
+ * Rules read `extension-pack.json` bytes through `context.files` (the
+ * authoritative source shared across publish and `axm lint`). The `subject`
+ * carries only what rules can't efficiently re-derive from bytes:
+ *
+ * - `packJson` — the already-decoded `extension-pack.json` contents when
+ *   present (caller decodes once, rules don't re-read + re-parse).
+ *   `undefined` when the file is absent. Schema-valid rules pipe this into
+ *   `Schema.decodeUnknownResult(ExtensionPackManifestSchema)`;
+ *   keys-recognized enumerates top-level keys after narrowing to
+ *   `Record<string, unknown>`.
+ *
+ * Unlike `SkillContent`, there is no `isNative` discriminator — packs are
+ * registry-only and every pack context is expected to expose a manifest.
+ * The presence rule (`pack/manifest-present`) owns the absence arm.
+ *
+ * Phase 3c consumers build `PackContent` via `buildPackRuleContexts`
+ * against the `WorkspaceIndex` surface; publish (Phase 4, this-repo) builds
+ * one `PackContent` per incoming archive.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface PackContent {
+    readonly packJson: unknown;
+}
+/**
+ * Context passed to `workspace/*` rules.
+ *
+ * `subject.scope` is `"project"` (default) or `"user"` (user-level `.axm/`).
+ * Rules whose invariants apply at only one scope early-return `[]` via the
+ * `check` body.
+ *
+ * `subject.root` is an absolute filesystem path pinning the workspace root;
+ * typed as `string` in Phase 2 so the rule primitives don't depend on a
+ * platform-specific path brand.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface WorkspaceRuleContext {
+    readonly subject: WorkspaceSubject;
+    readonly workspace: WorkspaceLintAccessor;
+    readonly displayRoot: string;
+}
+/**
+ * Workspace subject: the rule-addressable identity of the workspace under lint.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface WorkspaceSubject {
+    readonly root: string;
+    readonly scope: "project" | "user";
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/src/unstable/lint/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../src/unstable/lint/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAMnE;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,GAAG,UAAU,CAAC;IAC3D,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAMD;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1D,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;CAClF;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1D,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;CAClF;AAMD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAEvC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAEvC;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;IACtE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,iBAAiB,CAAC,CAAC;IACrF,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACzE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC;IACvE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC;IACpE,QAAQ,CAAC,YAAY,EAAE,CACrB,KAAK,EAAE,SAAS,GAAG,MAAM,KACtB,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1D,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9D,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC,CAAC;CACxF;AAMD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,YAAY;IAChD,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,WAAW;IAC9C,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;CACpC"}

package/dist/src/unstable/lint/context.js

@@ -0,0 +1,21 @@
+/**
+ * Rule-context types and narrow accessors.
+ *
+ * Each rule-context type bundles a caller-decoded `subject` with a narrow
+ * caller-bound accessor and a `displayRoot` used for path rendering. Rules
+ * consume accessors as ordinary property access (no Layer wiring); tests pass
+ * literal fakes.
+ *
+ * Phase 2 pins the context shapes and accessor interfaces. Phases 3a, 3b, and
+ * 3c land the concrete `subject` decoders and VFT-/platform-backed accessor
+ * implementations.
+ *
+ * Accessor surfaces are intentionally minimal — rules SHALL see only the
+ * methods the v1 catalog requires. Extending a surface is a Phase 3a/3b/3c
+ * action with a documented rule consumer, not a free action.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=context.js.map