@agentxm/client-core 0.1.6 → 0.3.1

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"pack.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/lint/catalog/pack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAKrD;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,eAAe,CAAC,CAI9D,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"pack.js","sourceRoot":"","sources":["../../../../../src/unstable/lint/catalog/pack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAEhF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAA6C;IACjE,mBAAmB;IACnB,uBAAuB;IACvB,0BAA0B;CAC3B,CAAC;AAEF,+EAA+E;AAC/E,+EAA+E;AAC/E,4EAA4E;AAC5E,mBAAmB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/dist/src/unstable/lint/catalog/shared/schema-rule.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Shared schema-delegation plumbing for `-schema-valid` rules.
+ *
+ * Per `docs/design/lint-engine.md §4` ("Schema-valid rules delegate to Effect
+ * Schema"), every rule whose id ends in `-schema-valid` implements `check` by
+ * running the canonical schema through `Schema.decodeUnknownResult` with
+ * `onExcessProperty: "ignore"` and `errors: "all"`, then mapping the issues
+ * through `issuesToFindings`.
+ *
+ * Phase 3a is the first catalog; landing the helper now keeps the Phase 3b
+ * pack catalog from duplicating the composition when it arrives. The helper is
+ * intentionally narrow — only the surface the `-schema-valid` rules need.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import type { AdvisoryFinding, Severity } from "../../rule.js";
+/**
+ * Decode `input` against `schema` (excess keys ignored, all issues collected)
+ * and return one advisory finding per leaf issue. Success produces `[]`.
+ *
+ * `input` of `undefined` short-circuits to `[]` — the caller is expected to
+ * have already guarded on "manifest exists" via the complementary
+ * `-present` rule.
+ *
+ * @param ruleId   - `<namespace>/<name>` id of the calling rule.
+ * @param severity - Severity to stamp on each emitted finding.
+ * @param file     - Accessor-relative file path to stamp on `location.file`.
+ * @param schema   - Canonical Effect schema; `Schema.decodeUnknownResult`
+ *                   runs with `onExcessProperty: "ignore"` and `errors: "all"`.
+ * @param input    - Raw decoded JSON value to check (typically `subject.*Json`).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const schemaDecodeFindings: <A, I>(ruleId: string, severity: Severity, file: string, schema: Schema.Codec<A, I>, input: unknown) => Effect.Effect<ReadonlyArray<AdvisoryFinding>>;
+/**
+ * Read the top-level field names of a `Schema.Struct` value.
+ *
+ * Callers produce an `allowedKeys` set in one place, driven by the schema
+ * itself — no copy-paste of field names into rule bodies. If the schema
+ * gains a field the allowed-keys set grows by construction.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const structFieldKeys: (struct: {
+    readonly fields: Readonly<Record<string, unknown>>;
+}) => ReadonlySet<string>;
+/**
+ * Enumerate top-level keys present on `input` that are not declared by
+ * `allowedKeys`. Returns one advisory finding per unknown key.
+ *
+ * `input` of `undefined` or non-object short-circuits to `[]`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const enumerateUnknownTopLevelKeys: (ruleId: string, severity: Severity, file: string, allowedKeys: ReadonlySet<string>, input: unknown) => ReadonlyArray<AdvisoryFinding>;
+//# sourceMappingURL=schema-rule.d.ts.map

package/dist/src/unstable/lint/catalog/shared/schema-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-rule.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/shared/schema-rule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAM/D;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,EAAE,CAAC,EACvC,QAAQ,MAAM,EACd,UAAU,QAAQ,EAClB,MAAM,MAAM,EACZ,QAAQ,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAC1B,OAAO,OAAO,KACb,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,CAY9C,CAAC;AAMF;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ;IACtC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACpD,KAAG,WAAW,CAAC,MAAM,CAAwC,CAAC;AAE/D;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,GACvC,QAAQ,MAAM,EACd,UAAU,QAAQ,EAClB,MAAM,MAAM,EACZ,aAAa,WAAW,CAAC,MAAM,CAAC,EAChC,OAAO,OAAO,KACb,aAAa,CAAC,eAAe,CAsB/B,CAAC"}

package/dist/src/unstable/lint/catalog/shared/schema-rule.js

@@ -0,0 +1,99 @@
+/**
+ * Shared schema-delegation plumbing for `-schema-valid` rules.
+ *
+ * Per `docs/design/lint-engine.md §4` ("Schema-valid rules delegate to Effect
+ * Schema"), every rule whose id ends in `-schema-valid` implements `check` by
+ * running the canonical schema through `Schema.decodeUnknownResult` with
+ * `onExcessProperty: "ignore"` and `errors: "all"`, then mapping the issues
+ * through `issuesToFindings`.
+ *
+ * Phase 3a is the first catalog; landing the helper now keeps the Phase 3b
+ * pack catalog from duplicating the composition when it arrives. The helper is
+ * intentionally narrow — only the surface the `-schema-valid` rules need.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import { issuesToFindings } from "../../issues-to-findings.js";
+// -----------------------------------------------------------------------------
+// schemaDecodeFindings
+// -----------------------------------------------------------------------------
+/**
+ * Decode `input` against `schema` (excess keys ignored, all issues collected)
+ * and return one advisory finding per leaf issue. Success produces `[]`.
+ *
+ * `input` of `undefined` short-circuits to `[]` — the caller is expected to
+ * have already guarded on "manifest exists" via the complementary
+ * `-present` rule.
+ *
+ * @param ruleId   - `<namespace>/<name>` id of the calling rule.
+ * @param severity - Severity to stamp on each emitted finding.
+ * @param file     - Accessor-relative file path to stamp on `location.file`.
+ * @param schema   - Canonical Effect schema; `Schema.decodeUnknownResult`
+ *                   runs with `onExcessProperty: "ignore"` and `errors: "all"`.
+ * @param input    - Raw decoded JSON value to check (typically `subject.*Json`).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const schemaDecodeFindings = (ruleId, severity, file, schema, input) => {
+    if (input === undefined) {
+        return Effect.succeed([]);
+    }
+    const result = Schema.decodeUnknownResult(schema)(input, {
+        onExcessProperty: "ignore",
+        errors: "all",
+    });
+    if (Result.isSuccess(result)) {
+        return Effect.succeed([]);
+    }
+    return Effect.succeed(issuesToFindings(ruleId, severity, file, result.failure));
+};
+// -----------------------------------------------------------------------------
+// enumerateUnknownTopLevelKeys
+// -----------------------------------------------------------------------------
+/**
+ * Read the top-level field names of a `Schema.Struct` value.
+ *
+ * Callers produce an `allowedKeys` set in one place, driven by the schema
+ * itself — no copy-paste of field names into rule bodies. If the schema
+ * gains a field the allowed-keys set grows by construction.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const structFieldKeys = (struct) => new Set(Object.keys(struct.fields));
+/**
+ * Enumerate top-level keys present on `input` that are not declared by
+ * `allowedKeys`. Returns one advisory finding per unknown key.
+ *
+ * `input` of `undefined` or non-object short-circuits to `[]`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const enumerateUnknownTopLevelKeys = (ruleId, severity, file, allowedKeys, input) => {
+    if (!isPlainRecord(input)) {
+        return [];
+    }
+    const findings = [];
+    for (const key of Object.keys(input)) {
+        if (allowedKeys.has(key)) {
+            continue;
+        }
+        findings.push({
+            kind: "advisory",
+            ruleId,
+            severity,
+            message: `unrecognized top-level key '${key}'; remove it or rename to a canonical field.`,
+            suggestions: [
+                `Remove the '${key}' key from the manifest.`,
+                `Rename '${key}' to the intended canonical field.`,
+            ],
+            location: { file },
+        });
+    }
+    return findings;
+};
+const isPlainRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+//# sourceMappingURL=schema-rule.js.map

package/dist/src/unstable/lint/catalog/shared/schema-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-rule.js","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/shared/schema-rule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG/D,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,MAAc,EACd,QAAkB,EAClB,IAAY,EACZ,MAA0B,EAC1B,KAAc,EACiC,EAAE;IACjD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE;QACvD,gBAAgB,EAAE,QAAQ;QAC1B,MAAM,EAAE,KAAK;KACd,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AAClF,CAAC,CAAC;AAEF,gFAAgF;AAChF,+BAA+B;AAC/B,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAE/B,EAAuB,EAAE,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;AAE/D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,MAAc,EACd,QAAkB,EAClB,IAAY,EACZ,WAAgC,EAChC,KAAc,EACkB,EAAE;IAClC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,SAAS;QACX,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,UAAU;YAChB,MAAM;YACN,QAAQ;YACR,OAAO,EAAE,+BAA+B,GAAG,8CAA8C;YACzF,WAAW,EAAE;gBACX,eAAe,GAAG,0BAA0B;gBAC5C,WAAW,GAAG,oCAAoC;aACnD;YACD,QAAQ,EAAE,EAAE,IAAI,EAAE;SACnB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,KAAc,EAA8C,EAAE,CACnF,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/src/unstable/lint/catalog/skill/frontmatter-parseable.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `skill/frontmatter-parseable` — SKILL.md frontmatter parses as a YAML
+ * mapping.
+ *
+ * Cascade (reports the first failure in the order below; later arms
+ * short-circuit):
+ *
+ * 1. SKILL.md begins with `---` at byte 0 (no BOM, no leading whitespace, no
+ *    leading HTML comment). This is the arm that caught the
+ *    `@agentxm/skills/axm` regression — an HTML comment preceded the
+ *    frontmatter delimiter, so YAML parsers silently treated the content as
+ *    body.
+ * 2. Frontmatter YAML parses without error.
+ * 3. Parsed frontmatter is a mapping (not a list, not a scalar).
+ *
+ * Presence is handled by `skill/skill-md-present`; this rule early-returns
+ * `[]` when `SKILL.md` is absent.
+ *
+ * Advisory-only — the cascade mixes one mechanically-fixable arm
+ * (strip-leading-bytes) with arms requiring human judgment (fix YAML
+ * syntax). Per `docs/design/lint-engine.md §10.skill (Notes)`, splitting by
+ * kind or adding a byte-range mutation Operation is deferred until a second
+ * mechanical arm justifies it.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { SkillRuleContext } from "../../context.js";
+import type { AdvisoryRule } from "../../rule.js";
+export declare const frontmatterParseableRule: AdvisoryRule<SkillRuleContext>;
+//# sourceMappingURL=frontmatter-parseable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-parseable.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/skill/frontmatter-parseable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,eAAe,CAAC;AAanE,eAAO,MAAM,wBAAwB,EAAE,YAAY,CAAC,gBAAgB,CAyBnE,CAAC"}

package/dist/src/unstable/lint/catalog/skill/frontmatter-parseable.js

@@ -0,0 +1,151 @@
+/**
+ * `skill/frontmatter-parseable` — SKILL.md frontmatter parses as a YAML
+ * mapping.
+ *
+ * Cascade (reports the first failure in the order below; later arms
+ * short-circuit):
+ *
+ * 1. SKILL.md begins with `---` at byte 0 (no BOM, no leading whitespace, no
+ *    leading HTML comment). This is the arm that caught the
+ *    `@agentxm/skills/axm` regression — an HTML comment preceded the
+ *    frontmatter delimiter, so YAML parsers silently treated the content as
+ *    body.
+ * 2. Frontmatter YAML parses without error.
+ * 3. Parsed frontmatter is a mapping (not a list, not a scalar).
+ *
+ * Presence is handled by `skill/skill-md-present`; this rule early-returns
+ * `[]` when `SKILL.md` is absent.
+ *
+ * Advisory-only — the cascade mixes one mechanically-fixable arm
+ * (strip-leading-bytes) with arms requiring human judgment (fix YAML
+ * syntax). Per `docs/design/lint-engine.md §10.skill (Notes)`, splitting by
+ * kind or adding a byte-range mutation Operation is deferred until a second
+ * mechanical arm justifies it.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import YAML from "yaml";
+const RULE_ID = "skill/frontmatter-parseable";
+const SKILL_MD = "SKILL.md";
+const DELIMITER = "---";
+// U+FEFF — UTF-8 BOM as a single code point. Escape form so the editor /
+// formatter can't silently strip the literal.
+const UTF8_BOM = "\uFEFF";
+// `ignoreBOM: true` here means "pass the BOM through to the decoded string,
+// don't strip it" — cascade arm 1 must see the BOM to flag it.
+const decoder = new TextDecoder("utf-8", { fatal: false, ignoreBOM: true });
+export const frontmatterParseableRule = {
+    id: RULE_ID,
+    description: "SKILL.md frontmatter parses as a YAML mapping.",
+    kind: "advisory",
+    severity: "error",
+    check: (context) => Effect.gen(function* () {
+        const exists = yield* context.files.exists(SKILL_MD);
+        if (!exists) {
+            // Presence is covered by `skill/skill-md-present`.
+            return [];
+        }
+        const bytesResult = yield* context.files.readBytes(SKILL_MD).pipe(Effect.map((bytes) => ({ kind: "ok", bytes })), 
+        // Treat read errors the same as absence — presence rule already owns
+        // that path. If `exists` said true but read fails, the cascade can't
+        // run anyway; silence here keeps the finding count at one.
+        Effect.catch(() => Effect.succeed({ kind: "none" })));
+        if (bytesResult.kind === "none") {
+            return [];
+        }
+        const content = decoder.decode(bytesResult.bytes);
+        return evaluateCascade(content);
+    }),
+};
+// -----------------------------------------------------------------------------
+// Cascade
+// -----------------------------------------------------------------------------
+const evaluateCascade = (content) => {
+    const leading = detectLeadingBytes(content);
+    if (leading !== undefined) {
+        return [leading];
+    }
+    const parsed = parseFrontmatterYaml(content);
+    if (parsed === undefined) {
+        // No frontmatter block. Treat as bad (cascade arm 1 "begins with ---"
+        // already handled the "literally no ---" case; reaching here means the
+        // delimiter was found but the closing delimiter is missing).
+        return [
+            finding("SKILL.md frontmatter is malformed: opening `---` found but closing `---` is missing.", ["Add a closing `---` after the frontmatter YAML block."]),
+        ];
+    }
+    if (parsed.kind === "parse-error") {
+        return [
+            finding(`SKILL.md frontmatter YAML is invalid: ${parsed.message}`, [
+                "Fix YAML syntax at the referenced location.",
+            ]),
+        ];
+    }
+    if (!isMapping(parsed.value)) {
+        return [
+            finding("SKILL.md frontmatter must be a YAML mapping (key: value pairs), not a list or scalar.", ["Rewrite the frontmatter block as `key: value` pairs."]),
+        ];
+    }
+    return [];
+};
+// -----------------------------------------------------------------------------
+// Arm 1: leading bytes before `---`
+// -----------------------------------------------------------------------------
+const detectLeadingBytes = (content) => {
+    if (content.startsWith(UTF8_BOM)) {
+        return finding("SKILL.md begins with a UTF-8 BOM; frontmatter `---` must appear at byte 0.", ["Strip the UTF-8 BOM from the start of SKILL.md."], { line: 1 });
+    }
+    if (content.startsWith(DELIMITER)) {
+        return undefined;
+    }
+    // Any non-`---` leading content is a cascade-arm-1 violation. Detect the
+    // common HTML-comment case explicitly so the finding message is clear.
+    if (/^\s*<!--/.test(content)) {
+        return finding("SKILL.md begins with an HTML comment before the frontmatter `---`; the delimiter must appear at byte 0.", ["Strip leading bytes before the first `---`."], { line: 1 });
+    }
+    return finding("SKILL.md frontmatter `---` must appear at byte 0; leading whitespace or other content is not allowed.", ["Strip leading bytes before the first `---`."], { line: 1 });
+};
+const parseFrontmatterYaml = (content) => {
+    // content starts with `---` (arm 1 guaranteed). Find closing delimiter on a
+    // new line.
+    const afterOpening = content.indexOf("\n");
+    if (afterOpening === -1) {
+        return undefined;
+    }
+    const closingIndex = content.indexOf(`\n${DELIMITER}`, afterOpening);
+    if (closingIndex === -1) {
+        return undefined;
+    }
+    const yamlContent = content.slice(afterOpening + 1, closingIndex);
+    try {
+        // YAML.parse returns `null | undefined` for empty input; we care about
+        // shape, not emptiness at this arm.
+        const value = YAML.parse(yamlContent);
+        return { kind: "parsed", value };
+    }
+    catch (error) {
+        return {
+            kind: "parse-error",
+            message: error instanceof Error ? error.message : String(error),
+        };
+    }
+};
+const isMapping = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+// -----------------------------------------------------------------------------
+// Finding helpers
+// -----------------------------------------------------------------------------
+const finding = (message, suggestions, position) => ({
+    kind: "advisory",
+    ruleId: RULE_ID,
+    severity: "error",
+    message,
+    suggestions,
+    location: {
+        file: SKILL_MD,
+        ...(position?.line !== undefined ? { line: position.line } : {}),
+        ...(position?.column !== undefined ? { column: position.column } : {}),
+    },
+});
+//# sourceMappingURL=frontmatter-parseable.js.map

package/dist/src/unstable/lint/catalog/skill/frontmatter-parseable.js.map

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

package/dist/src/unstable/lint/catalog/skill/manifest-keys-recognized.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `skill/manifest-keys-recognized` — `skill.json` contains only keys
+ * declared by `SkillManifestSchema`.
+ *
+ * The paired `-schema-valid` rule ignores excess properties by construction
+ * (`onExcessProperty: "ignore"`); this rule surfaces them at warning severity
+ * so newer-schema manifests can roll out ahead of registry deploys.
+ *
+ * Allowed-keys set is derived from `SkillManifestSchema.fields` — no
+ * copy-paste of field names. A schema gain (or rename) automatically updates
+ * the allowlist.
+ *
+ * Early-return arms (no findings):
+ *
+ * - `subject.isNative === false` — non-native skills have no manifest to
+ *   check.
+ * - `subject.skillJson === undefined` / non-object — nothing to enumerate;
+ *   `skill/manifest-present` owns the absence case.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { SkillRuleContext } from "../../context.js";
+import type { AdvisoryRule } from "../../rule.js";
+export declare const manifestKeysRecognizedRule: AdvisoryRule<SkillRuleContext>;
+//# sourceMappingURL=manifest-keys-recognized.d.ts.map

package/dist/src/unstable/lint/catalog/skill/manifest-keys-recognized.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-keys-recognized.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/skill/manifest-keys-recognized.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AASlD,eAAO,MAAM,0BAA0B,EAAE,YAAY,CAAC,gBAAgB,CAmBrE,CAAC"}

package/dist/src/unstable/lint/catalog/skill/manifest-keys-recognized.js

@@ -0,0 +1,41 @@
+/**
+ * `skill/manifest-keys-recognized` — `skill.json` contains only keys
+ * declared by `SkillManifestSchema`.
+ *
+ * The paired `-schema-valid` rule ignores excess properties by construction
+ * (`onExcessProperty: "ignore"`); this rule surfaces them at warning severity
+ * so newer-schema manifests can roll out ahead of registry deploys.
+ *
+ * Allowed-keys set is derived from `SkillManifestSchema.fields` — no
+ * copy-paste of field names. A schema gain (or rename) automatically updates
+ * the allowlist.
+ *
+ * Early-return arms (no findings):
+ *
+ * - `subject.isNative === false` — non-native skills have no manifest to
+ *   check.
+ * - `subject.skillJson === undefined` / non-object — nothing to enumerate;
+ *   `skill/manifest-present` owns the absence case.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import { SkillManifestSchema } from "../../../skills/manifest-schema.js";
+import { enumerateUnknownTopLevelKeys, structFieldKeys } from "../shared/schema-rule.js";
+const RULE_ID = "skill/manifest-keys-recognized";
+const SKILL_JSON = "skill.json";
+const allowedKeys = structFieldKeys(SkillManifestSchema);
+export const manifestKeysRecognizedRule = {
+    id: RULE_ID,
+    description: "skill.json contains only keys recognized by SkillManifestSchema.",
+    kind: "advisory",
+    severity: "warning",
+    check: (context) => {
+        if (!context.subject.isNative) {
+            return Effect.succeed([]);
+        }
+        return Effect.succeed(enumerateUnknownTopLevelKeys(RULE_ID, "warning", SKILL_JSON, allowedKeys, context.subject.skillJson));
+    },
+};
+//# sourceMappingURL=manifest-keys-recognized.js.map

package/dist/src/unstable/lint/catalog/skill/manifest-keys-recognized.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-keys-recognized.js","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/skill/manifest-keys-recognized.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,4BAA4B,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEzF,MAAM,OAAO,GAAG,gCAAgC,CAAC;AACjD,MAAM,UAAU,GAAG,YAAY,CAAC;AAEhC,MAAM,WAAW,GAAG,eAAe,CAAC,mBAAmB,CAAC,CAAC;AAEzD,MAAM,CAAC,MAAM,0BAA0B,GAAmC;IACxE,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,kEAAkE;IAC/E,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;QACjB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,MAAM,CAAC,OAAO,CACnB,4BAA4B,CAC1B,OAAO,EACP,SAAS,EACT,UAAU,EACV,WAAW,EACX,OAAO,CAAC,OAAO,CAAC,SAAS,CAC1B,CACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/src/unstable/lint/catalog/skill/manifest-present.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `skill/manifest-present` — native skills must have a `skill.json` at the
+ * skill root.
+ *
+ * Native-only via `check` early-return: when `subject.isNative === false`
+ * (managed-external skills without a declared manifest), the rule produces
+ * no findings. No separate `applies` predicate per
+ * `docs/design/lint-engine.md §3`.
+ *
+ * Advisory-only — scaffolding a manifest is a user-authored action.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { SkillRuleContext } from "../../context.js";
+import type { AdvisoryRule } from "../../rule.js";
+export declare const manifestPresentRule: AdvisoryRule<SkillRuleContext>;
+//# sourceMappingURL=manifest-present.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-present.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/skill/manifest-present.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,eAAe,CAAC;AAKnE,eAAO,MAAM,mBAAmB,EAAE,YAAY,CAAC,gBAAgB,CA+B9D,CAAC"}

package/dist/src/unstable/lint/catalog/skill/manifest-present.js

@@ -0,0 +1,46 @@
+/**
+ * `skill/manifest-present` — native skills must have a `skill.json` at the
+ * skill root.
+ *
+ * Native-only via `check` early-return: when `subject.isNative === false`
+ * (managed-external skills without a declared manifest), the rule produces
+ * no findings. No separate `applies` predicate per
+ * `docs/design/lint-engine.md §3`.
+ *
+ * Advisory-only — scaffolding a manifest is a user-authored action.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+const RULE_ID = "skill/manifest-present";
+const SKILL_JSON = "skill.json";
+export const manifestPresentRule = {
+    id: RULE_ID,
+    description: "Native skill has a skill.json manifest at its root.",
+    kind: "advisory",
+    severity: "error",
+    check: (context) => {
+        if (!context.subject.isNative) {
+            return Effect.succeed([]);
+        }
+        return Effect.map(context.files.exists(SKILL_JSON), (present) => {
+            if (present) {
+                return [];
+            }
+            return [
+                {
+                    kind: "advisory",
+                    ruleId: RULE_ID,
+                    severity: "error",
+                    message: "skill.json is missing; native skills must expose a manifest at the skill root.",
+                    suggestions: [
+                        `Create ${SKILL_JSON} with the required manifest fields (owner, type, name, version).`,
+                    ],
+                    location: { file: SKILL_JSON },
+                },
+            ];
+        });
+    },
+};
+//# sourceMappingURL=manifest-present.js.map

package/dist/src/unstable/lint/catalog/skill/manifest-present.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-present.js","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/skill/manifest-present.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,MAAM,OAAO,GAAG,wBAAwB,CAAC;AACzC,MAAM,UAAU,GAAG,YAAY,CAAC;AAEhC,MAAM,CAAC,MAAM,mBAAmB,GAAmC;IACjE,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,qDAAqD;IAClE,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;QACjB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,MAAM,CAAC,GAAG,CACf,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,EAChC,CAAC,OAAO,EAAkC,EAAE;YAC1C,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,OAAO;gBACL;oBACE,IAAI,EAAE,UAAU;oBAChB,MAAM,EAAE,OAAO;oBACf,QAAQ,EAAE,OAAO;oBACjB,OAAO,EACL,gFAAgF;oBAClF,WAAW,EAAE;wBACX,UAAU,UAAU,kEAAkE;qBACvF;oBACD,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;iBAC/B;aACF,CAAC;QACJ,CAAC,CACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/src/unstable/lint/catalog/skill/manifest-schema-valid.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `skill/manifest-schema-valid` — `skill.json` conforms to
+ * `SkillManifestSchema`.
+ *
+ * Delegates to Effect Schema per `docs/design/lint-engine.md §4`
+ * ("Schema-valid rules delegate to Effect Schema"). Issues map 1:1 to
+ * findings via `issuesToFindings`.
+ *
+ * Early-return arms (no findings):
+ *
+ * - `subject.isNative === false` — non-native skills have no manifest to
+ *   check (complement of `skill/manifest-present`).
+ * - `subject.skillJson === undefined` — manifest is absent (covered by
+ *   `skill/manifest-present`).
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { SkillRuleContext } from "../../context.js";
+import type { AdvisoryRule } from "../../rule.js";
+export declare const manifestSchemaValidRule: AdvisoryRule<SkillRuleContext>;
+//# sourceMappingURL=manifest-schema-valid.d.ts.map

package/dist/src/unstable/lint/catalog/skill/manifest-schema-valid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-schema-valid.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/skill/manifest-schema-valid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAOlD,eAAO,MAAM,uBAAuB,EAAE,YAAY,CAAC,gBAAgB,CAmBlE,CAAC"}