@agentxm/client-core 0.13.1 → 0.14.0

package/dist/src/unstable/hooks/manifest-schema.js

@@ -0,0 +1,85 @@
+/**
+ * Hook manifest schema definition.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+import { CommonManifestBaseFields, ExtensionNameSchema, NonPackManifestFields, } from "../extensions/common.js";
+export const HOOK_MANIFEST_FILENAME = "hook.json";
+export const HOOK_EXTENSION_DIR = "hooks";
+export const HOOK_MANIFEST_SCHEMA_URL = "https://axm.sh/schemas/hook.schema.json";
+export const HookRuntimeSchema = Schema.Literals(["bash", "node", "python"]).annotate({
+    identifier: "HookRuntime",
+    title: "Hook Runtime",
+    description: "Interpreter family used to execute the materialized hook entrypoint.",
+});
+export const HookEventSchema = Schema.Literals([
+    "PreToolUse",
+    "PostToolUse",
+    "UserPromptSubmit",
+    "SessionStart",
+    "Stop",
+    "SubagentStop",
+    "PreCompact",
+]).annotate({
+    identifier: "HookEvent",
+    title: "Hook Event",
+    description: "Agent hook event this extension binds to.",
+});
+export const HookBindingSchema = Schema.Struct({
+    event: HookEventSchema,
+    matcher: Schema.optional(Schema.NonEmptyString),
+})
+    .pipe(Schema.check(Schema.makeFilter((value) => value.matcher !== undefined && value.event !== "PreToolUse" && value.event !== "PostToolUse"
+    ? "matcher is only valid for PreToolUse and PostToolUse bindings"
+    : undefined)))
+    .annotate({
+    identifier: "HookBinding",
+    title: "Hook Binding",
+    description: "Universal hook event binding with an optional tool matcher.",
+});
+export const HookCapabilitiesSchema = Schema.Struct({
+    network: Schema.optional(Schema.Boolean),
+    filesystemWrite: Schema.optional(Schema.Boolean),
+    exec: Schema.optional(Schema.Array(Schema.NonEmptyString)),
+    env: Schema.optional(Schema.Array(Schema.NonEmptyString)),
+}).annotate({
+    identifier: "HookCapabilities",
+    title: "Hook Capabilities",
+    description: "Advisory author-declared hook capability surface. v1 does not enforce it.",
+});
+/**
+ * Schema for hook manifest files (hook.json).
+ *
+ * Hooks distribute an executable body plus agent event bindings. Install
+ * materializes the body under .axm/extensions and registers native agent hook
+ * settings that invoke the materialized entrypoint.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const HookManifestSchema = Schema.Struct({
+    $schema: Schema.optional(Schema.String),
+    ...CommonManifestBaseFields,
+    ...NonPackManifestFields,
+    type: Schema.Literal("hook"),
+    name: ExtensionNameSchema.pipe(Schema.annotateKey({ messageMissingKey: "hook name is required" }), Schema.annotate({
+        description: "Short name for this hook within its owner namespace. Combined with owner, forms the FQN @owner/hooks/<name>.",
+    })),
+    title: Schema.optional(Schema.NonEmptyString.annotate({
+        description: "Optional display title for this hook.",
+    })),
+    runtime: HookRuntimeSchema.pipe(Schema.annotateKey({ messageMissingKey: "runtime is required" })),
+    entrypoint: Schema.NonEmptyString.pipe(Schema.annotateKey({ messageMissingKey: "entrypoint is required" }), Schema.annotate({
+        description: "Hook body entrypoint path, relative to the hook manifest directory.",
+        examples: ["src/hook.sh", "src/hook.js", "src/hook.py"],
+    })),
+    bindings: Schema.Array(HookBindingSchema).pipe(Schema.annotateKey({ messageMissingKey: "bindings are required" })),
+    timeoutMs: Schema.optional(Schema.Int.pipe(Schema.check(Schema.isGreaterThan(0)))),
+    blocking: Schema.optional(Schema.Boolean),
+    capabilities: Schema.optional(HookCapabilitiesSchema),
+}).annotate({
+    identifier: "HookManifest",
+    title: "Hook Manifest",
+    description: "Hook manifest for managed agent hooks. The executable body lives under src/ and is invoked from native agent settings.",
+});
+//# sourceMappingURL=manifest-schema.js.map

package/dist/src/unstable/hooks/manifest-schema.js.map

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

package/dist/src/unstable/hooks/operations/publish.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Publish hook executor — reads a hook manifest, runs publish lint, builds a
+ * zip archive, computes the SRI integrity hash, and publishes to a target registry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import { type AppError } from "../../app-error/index.js";
+import type { JobStepResult, Operation } from "../../plan/plan.js";
+import { WorkspaceMutations } from "../../workspace/service-interface.js";
+/** @experimental */
+export type PublishHookOperationArgs = {
+    readonly name: string;
+    readonly registryName: string;
+};
+/** @experimental */
+export type PublishHookOperation = Operation<"publish-hook", PublishHookOperationArgs>;
+/** @experimental */
+export declare const publishHook: (op: PublishHookOperation) => Effect.Effect<JobStepResult, AppError, FileSystem.FileSystem | Path.Path | WorkspaceMutations>;
+//# sourceMappingURL=publish.d.ts.map

package/dist/src/unstable/hooks/operations/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/hooks/operations/publish.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAGpC,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAMvE,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAKnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAQ1E,oBAAoB;AACpB,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,oBAAoB;AACpB,MAAM,MAAM,oBAAoB,GAAG,SAAS,CAAC,cAAc,EAAE,wBAAwB,CAAC,CAAC;AAEvF,oBAAoB;AACpB,eAAO,MAAM,WAAW,EAAE,CACxB,EAAE,EAAE,oBAAoB,KACrB,MAAM,CAAC,MAAM,CAChB,aAAa,EACb,QAAQ,EACR,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAuGpD,CAAC"}

package/dist/src/unstable/hooks/operations/publish.js

@@ -0,0 +1,95 @@
+/**
+ * Publish hook executor — reads a hook manifest, runs publish lint, builds a
+ * zip archive, computes the SRI integrity hash, and publishes to a target registry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import { makeAppError } from "../../app-error/index.js";
+import { fqnInvalidErrorToAppError, parseFqn, REGISTRY_EXTENSIONS_DIR, } from "../../extensions/index.js";
+import { runPublishLintGate } from "../../publish/lint-gate.js";
+import { createRegistryClient } from "../../registry/index.js";
+import { buildZipArchive, computeIntegrity } from "../../utils/index.js";
+import { WorkspaceMutations } from "../../workspace/service-interface.js";
+import { HOOK_EXTENSION_DIR, HOOK_MANIFEST_FILENAME, HookManifestSchema, } from "../manifest-schema.js";
+/** @experimental */
+export const publishHook = (op) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const ws = yield* WorkspaceMutations;
+    const fqn = yield* Result.mapError(parseFqn(op.args.name), fqnInvalidErrorToAppError);
+    const extensionDir = path.join(ws.baseDir, REGISTRY_EXTENSIONS_DIR, fqn.owner, HOOK_EXTENSION_DIR, fqn.name);
+    const extensionDirExists = yield* fs
+        .exists(extensionDir)
+        .pipe(Effect.orElseSucceed(() => false));
+    if (!extensionDirExists) {
+        return yield* makeAppError({
+            code: "not_found",
+            detail: `Managed hook not found: ${extensionDir}`,
+        });
+    }
+    const manifestPath = path.join(extensionDir, HOOK_MANIFEST_FILENAME);
+    const manifestContent = yield* fs.readFileString(manifestPath).pipe(Effect.mapError((cause) => makeAppError({
+        code: "internal",
+        detail: `Failed to read manifest: ${manifestPath}`,
+        cause,
+    })));
+    const manifestJson = yield* Effect.try({
+        try: () => JSON.parse(manifestContent),
+        catch: (cause) => makeAppError({
+            code: "validation",
+            detail: `Invalid JSON in manifest: ${manifestPath}`,
+            cause,
+        }),
+    });
+    const manifest = yield* Schema.decodeUnknownEffect(HookManifestSchema)(manifestJson).pipe(Effect.mapError((cause) => makeAppError({
+        code: "validation",
+        detail: `Invalid manifest schema: ${manifestPath}`,
+        cause,
+    })));
+    yield* runPublishLintGate({
+        type: "hook",
+        extensionDir,
+        manifestJson,
+        platform: { fs, path },
+    });
+    const archive = yield* buildZipArchive(extensionDir);
+    const integrity = yield* computeIntegrity(archive);
+    const registrySource = yield* ws.getConfiguredSourceByName(op.args.registryName).pipe(Effect.mapError((cause) => makeAppError({
+        code: "internal",
+        detail: `Failed to lookup registry source "${op.args.registryName}"`,
+        cause,
+    })));
+    if (Option.isNone(registrySource) || registrySource.value.type !== "registry") {
+        return yield* makeAppError({
+            code: "not_found",
+            detail: `Registry source "${op.args.registryName}" not found or not a registry source`,
+        });
+    }
+    const client = yield* createRegistryClient(registrySource.value.location.href);
+    const metadata = {
+        version: manifest.version,
+        published: new Date().toISOString(),
+        integrity,
+        ...(manifest.packages !== undefined ? { packages: manifest.packages } : {}),
+    };
+    const response = yield* client.publishExtension({
+        owner: fqn.owner,
+        type: "hook",
+        name: fqn.name,
+        version: manifest.version,
+        archive,
+        metadata,
+    });
+    return {
+        result: "success",
+        message: `Published ${op.args.name}@${manifest.version}`,
+        ...(response.links !== undefined ? { links: response.links } : {}),
+    };
+});
+//# sourceMappingURL=publish.js.map

package/dist/src/unstable/hooks/operations/publish.js.map

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

package/dist/src/unstable/hooks/refs.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Concrete hook ref types.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { ExtensionName } from "../extensions/common.js";
+import type { ExtensionRefBase } from "../extensions/ref-base.js";
+import type { GitHostedRefDetails, LocalRefDetails, RegistryRefDetails } from "../extensions/ref-base.js";
+import type { GitBasedSource, LocalSource, RegistrySource } from "../sources/types.js";
+type HookExtensionRefBase<TRefType, TSource> = ExtensionRefBase<"hook", Extract<TRefType, "git-hosted" | "registry" | "local">, Extract<TSource, GitBasedSource | RegistrySource | LocalSource>> & {
+    readonly hook: {
+        readonly name: ExtensionName;
+    };
+};
+/** @experimental */
+export type GitHostedHookRef = HookExtensionRefBase<"git-hosted", GitBasedSource> & GitHostedRefDetails;
+/** @experimental */
+export type RegistryHookRef = HookExtensionRefBase<"registry", RegistrySource> & RegistryRefDetails;
+/** @experimental */
+export type LocalHookRef = HookExtensionRefBase<"local", LocalSource> & LocalRefDetails;
+/** @experimental */
+export type HookExtensionRef = GitHostedHookRef | RegistryHookRef | LocalHookRef;
+export {};
+//# sourceMappingURL=refs.d.ts.map

package/dist/src/unstable/hooks/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../../../src/unstable/hooks/refs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEvF,KAAK,oBAAoB,CAAC,QAAQ,EAAE,OAAO,IAAI,gBAAgB,CAC7D,MAAM,EACN,OAAO,CAAC,QAAQ,EAAE,YAAY,GAAG,UAAU,GAAG,OAAO,CAAC,EACtD,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,GAAG,WAAW,CAAC,CAChE,GAAG;IACF,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;KAAE,CAAC;CACjD,CAAC;AAEF,oBAAoB;AACpB,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,YAAY,EAAE,cAAc,CAAC,GAC/E,mBAAmB,CAAC;AACtB,oBAAoB;AACpB,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC,UAAU,EAAE,cAAc,CAAC,GAAG,kBAAkB,CAAC;AACpG,oBAAoB;AACpB,MAAM,MAAM,YAAY,GAAG,oBAAoB,CAAC,OAAO,EAAE,WAAW,CAAC,GAAG,eAAe,CAAC;AAExF,oBAAoB;AACpB,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,eAAe,GAAG,YAAY,CAAC"}

package/dist/src/unstable/{docs → hooks}/refs.js

@@ -1,5 +1,5 @@
 /**
- * Concrete docs package ref types.
+ * Concrete hook ref types.
  *
  * @experimental This API is unstable and may change without notice.
  * @packageDocumentation

package/dist/src/unstable/hooks/refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../../../../src/unstable/hooks/refs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/src/unstable/hooks/registry-ref-builder.d.ts

@@ -0,0 +1,7 @@
+import type { ExtensionName, Handle } from "../extensions/index.js";
+import type { PackageUrlParts } from "../packaging/package-url.js";
+import type { RegistrySource } from "../sources/index.js";
+import type { Version } from "../version-constraints/version-constraints.js";
+import type { RegistryHookRef } from "./refs.js";
+export declare const buildRegistryHookRef: (owner: Handle, name: ExtensionName, version: Version, source: RegistrySource, packages: ReadonlyArray<PackageUrlParts>) => RegistryHookRef;
+//# sourceMappingURL=registry-ref-builder.d.ts.map

package/dist/src/unstable/hooks/registry-ref-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-ref-builder.d.ts","sourceRoot":"","sources":["../../../../src/unstable/hooks/registry-ref-builder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,eAAO,MAAM,oBAAoB,GAC/B,OAAO,MAAM,EACb,MAAM,aAAa,EACnB,SAAS,OAAO,EAChB,QAAQ,cAAc,EACtB,UAAU,aAAa,CAAC,eAAe,CAAC,KACvC,eAUD,CAAC"}

package/dist/src/unstable/hooks/registry-ref-builder.js

@@ -0,0 +1,13 @@
+import * as Option from "effect/Option";
+export const buildRegistryHookRef = (owner, name, version, source, packages) => ({
+    type: "hook",
+    refType: "registry",
+    hook: { name },
+    source,
+    owner,
+    name,
+    version,
+    integrity: Option.none(),
+    packages,
+});
+//# sourceMappingURL=registry-ref-builder.js.map

package/dist/src/unstable/hooks/registry-ref-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-ref-builder.js","sourceRoot":"","sources":["../../../../src/unstable/hooks/registry-ref-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAOxC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,KAAa,EACb,IAAmB,EACnB,OAAgB,EAChB,MAAsB,EACtB,QAAwC,EACvB,EAAE,CAAC,CAAC;IACrB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,UAAU;IACnB,IAAI,EAAE,EAAE,IAAI,EAAE;IACd,MAAM;IACN,KAAK;IACL,IAAI;IACJ,OAAO;IACP,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE;IACxB,QAAQ;CACT,CAAC,CAAC"}

package/dist/src/unstable/lint/catalog/files/generator-valid.d.ts

@@ -0,0 +1,4 @@
+import type { FilesRuleContext } from "../../context.js";
+import type { AdvisoryRule } from "../../rule.js";
+export declare const generatorValidRule: AdvisoryRule<FilesRuleContext>;
+//# sourceMappingURL=generator-valid.d.ts.map

package/dist/src/unstable/lint/catalog/files/generator-valid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-valid.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/files/generator-valid.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,eAAe,CAAC;AAenE,eAAO,MAAM,kBAAkB,EAAE,YAAY,CAAC,gBAAgB,CAuB7D,CAAC"}

package/dist/src/unstable/lint/catalog/{docs → files}/generator-valid.js

@@ -1,8 +1,8 @@
 import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
-import { isFileIndexColumn } from "../../../docs/generators.js";
-import { advisory, decodeDocsManifest, DOCS_JSON, isUnsafeWorkspaceTarget } from "./helpers.js";
-const RULE_ID = "docs/generator-valid";
+import { isFileIndexColumn } from "../../../files/generators.js";
+import { advisory, decodeFilesManifest, FILES_JSON, isUnsafeWorkspaceTarget } from "./helpers.js";
+const RULE_ID = "files/generator-valid";
 const tocOptions = new Set(["source", "region"]);
 const fileIndexOptions = new Set([
     "format",
@@ -18,8 +18,8 @@ export const generatorValidRule = {
     description: "Generated file contents use supported generators and option shapes.",
     kind: "advisory",
     severity: "error",
-    check: (docs) => Effect.succeed((() => {
-        const manifest = decodeDocsManifest(docs.subject.docsJson);
+    check: (files) => Effect.succeed((() => {
+        const manifest = decodeFilesManifest(files.subject.filesJson);
         if (Option.isNone(manifest)) {
             return [];
         }
@@ -107,5 +107,5 @@ const unknownOptionFindings = (entryNumber, generator, allowed) => {
     }
     return findings;
 };
-const optionFinding = (entryNumber, generator, option, detail) => advisory(RULE_ID, "error", `File contents entry ${entryNumber} uses generator '${generator}' with invalid option '${option}': ${detail}`, DOCS_JSON);
+const optionFinding = (entryNumber, generator, option, detail) => advisory(RULE_ID, "error", `File contents entry ${entryNumber} uses generator '${generator}' with invalid option '${option}': ${detail}`, FILES_JSON);
 //# sourceMappingURL=generator-valid.js.map

package/dist/src/unstable/lint/catalog/files/generator-valid.js.map

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

package/dist/src/unstable/lint/catalog/{docs → files}/helpers.d.ts

@@ -1,18 +1,18 @@
 import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
-import { type FileCommentStyle } from "../../../docs/markers.js";
-import { type FileContentSource, type DocsManifest } from "../../../docs/manifest-schema.js";
-import type { DocsRuleContext } from "../../context.js";
+import { type FileCommentStyle } from "../../../files/markers.js";
+import { type FileContentSource, type FilesManifest } from "../../../files/manifest-schema.js";
+import type { FilesRuleContext } from "../../context.js";
 import type { AdvisoryFinding, Severity } from "../../rule.js";
-export declare const DOCS_JSON = "docs.json";
+export declare const FILES_JSON = "files.json";
 export declare const SRC_ROOT = "src";
-export declare const decodeDocsManifest: (input: unknown) => Option.Option<DocsManifest>;
+export declare const decodeFilesManifest: (input: unknown) => Option.Option<FilesManifest>;
 export declare const sourcePaths: (source: Extract<FileContentSource, {
     readonly kind: "static" | "template";
 }>) => ReadonlyArray<string>;
 export declare const srcPath: (payloadPath: string) => string;
 export declare const advisory: (ruleId: string, severity: Severity, message: string, file?: string) => AdvisoryFinding;
-export declare const readPayloadString: (docs: DocsRuleContext, payloadPath: string) => Effect.Effect<Option.Option<string>>;
+export declare const readPayloadString: (files: FilesRuleContext, payloadPath: string) => Effect.Effect<Option.Option<string>>;
 export declare const isUnsafeWorkspaceTarget: (target: string) => boolean;
 export declare const markerStyleForTarget: (target: string) => Option.Option<FileCommentStyle>;
 export declare const containsAxmRegionMarker: (content: string, target: string) => boolean;

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/files/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE/D,eAAO,MAAM,UAAU,eAAe,CAAC;AACvC,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAI9B,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAM/E,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,QAAQ,OAAO,CAAC,iBAAiB,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAA;CAAE,CAAC,KAC3E,aAAa,CAAC,MAAM,CAAoE,CAAC;AAE5F,eAAO,MAAM,OAAO,GAAI,aAAa,MAAM,KAAG,MAAsC,CAAC;AAErF,eAAO,MAAM,QAAQ,GACnB,QAAQ,MAAM,EACd,UAAU,QAAQ,EAClB,SAAS,MAAM,EACf,OAAM,MAAmB,KACxB,eAMD,CAAC;AAEH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,gBAAgB,EACvB,aAAa,MAAM,KAClB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAInC,CAAC;AAEJ,eAAO,MAAM,uBAAuB,GAAI,QAAQ,MAAM,KAAG,OAaxD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,QAAQ,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CACrD,CAAC;AAEhC,eAAO,MAAM,uBAAuB,GAAI,SAAS,MAAM,EAAE,QAAQ,MAAM,KAAG,OAMzE,CAAC"}

package/dist/src/unstable/lint/catalog/{docs → files}/helpers.js

@@ -2,13 +2,13 @@ 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 { commentStyleForTarget, parseRegionMarker, } from "../../../docs/markers.js";
-import { DocsManifestSchema, } from "../../../docs/manifest-schema.js";
-export const DOCS_JSON = "docs.json";
+import { commentStyleForTarget, parseRegionMarker, } from "../../../files/markers.js";
+import { FilesManifestSchema, } from "../../../files/manifest-schema.js";
+export const FILES_JSON = "files.json";
 export const SRC_ROOT = "src";
 const decoder = new TextDecoder();
-export const decodeDocsManifest = (input) => {
-    const result = Schema.decodeUnknownResult(DocsManifestSchema)(input, {
+export const decodeFilesManifest = (input) => {
+    const result = Schema.decodeUnknownResult(FilesManifestSchema)(input, {
         onExcessProperty: "ignore",
         errors: "all",
     });
@@ -16,14 +16,14 @@ export const decodeDocsManifest = (input) => {
 };
 export const sourcePaths = (source) => (typeof source.path === "string" ? [source.path] : source.path);
 export const srcPath = (payloadPath) => `${SRC_ROOT}/${payloadPath}`;
-export const advisory = (ruleId, severity, message, file = DOCS_JSON) => ({
+export const advisory = (ruleId, severity, message, file = FILES_JSON) => ({
     kind: "advisory",
     ruleId,
     severity,
     message,
     location: { file },
 });
-export const readPayloadString = (docs, payloadPath) => docs.files.readBytes(srcPath(payloadPath)).pipe(Effect.map((bytes) => Option.some(decoder.decode(bytes))), Effect.catch(() => Effect.succeed(Option.none())));
+export const readPayloadString = (files, payloadPath) => files.files.readBytes(srcPath(payloadPath)).pipe(Effect.map((bytes) => Option.some(decoder.decode(bytes))), Effect.catch(() => Effect.succeed(Option.none())));
 export const isUnsafeWorkspaceTarget = (target) => {
     if (target === "" ||
         /^[a-z]:[\\/]/i.test(target) ||

package/dist/src/unstable/lint/catalog/files/helpers.js.map

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

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

@@ -0,0 +1,4 @@
+import type { FilesRuleContext } from "../../context.js";
+import type { AdvisoryRule } from "../../rule.js";
+export declare const manifestKeysRecognizedRule: AdvisoryRule<FilesRuleContext>;
+//# sourceMappingURL=manifest-keys-recognized.d.ts.map

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

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

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

@@ -0,0 +1,14 @@
+import * as Effect from "effect/Effect";
+import { FilesManifestSchema } from "../../../files/manifest-schema.js";
+import { enumerateUnknownTopLevelKeys, structFieldKeys } from "../shared/schema-rule.js";
+import { FILES_JSON } from "./helpers.js";
+const RULE_ID = "files/manifest-keys-recognized";
+const allowedKeys = structFieldKeys(FilesManifestSchema);
+export const manifestKeysRecognizedRule = {
+    id: RULE_ID,
+    description: "files.json uses only supported top-level fields.",
+    kind: "advisory",
+    severity: "error",
+    check: (files) => Effect.succeed(enumerateUnknownTopLevelKeys(RULE_ID, "error", FILES_JSON, allowedKeys, files.subject.filesJson)),
+};
+//# sourceMappingURL=manifest-keys-recognized.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-keys-recognized.js","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/files/manifest-keys-recognized.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAGxE,OAAO,EAAE,4BAA4B,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACzF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,OAAO,GAAG,gCAAgC,CAAC;AACjD,MAAM,WAAW,GAAG,eAAe,CAAC,mBAAmB,CAAC,CAAC;AAEzD,MAAM,CAAC,MAAM,0BAA0B,GAAmC;IACxE,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,kDAAkD;IAC/D,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,MAAM,CAAC,OAAO,CACZ,4BAA4B,CAC1B,OAAO,EACP,OAAO,EACP,UAAU,EACV,WAAW,EACX,KAAK,CAAC,OAAO,CAAC,SAAS,CACxB,CACF;CACJ,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { FilesRuleContext } from "../../context.js";
+import type { AdvisoryRule } from "../../rule.js";
+export declare const manifestPresentRule: AdvisoryRule<FilesRuleContext>;
+//# sourceMappingURL=manifest-present.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-present.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/files/manifest-present.ts"],"names":[],"mappings":"AACA,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,CAqB9D,CAAC"}

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

@@ -0,0 +1,24 @@
+import * as Effect from "effect/Effect";
+import { FILES_JSON } from "./helpers.js";
+const RULE_ID = "files/manifest-present";
+export const manifestPresentRule = {
+    id: RULE_ID,
+    description: "files packages include a root files.json manifest.",
+    kind: "advisory",
+    severity: "error",
+    check: (files) => Effect.map(files.files.exists(FILES_JSON), (present) => {
+        if (present) {
+            return [];
+        }
+        return [
+            {
+                kind: "advisory",
+                ruleId: RULE_ID,
+                severity: "error",
+                message: "files.json is missing. Create files.json with the required manifest fields (`owner`, `type`, `name`, `version`, `contents`).",
+                location: { file: FILES_JSON },
+            },
+        ];
+    }),
+};
+//# sourceMappingURL=manifest-present.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-present.js","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/files/manifest-present.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,OAAO,GAAG,wBAAwB,CAAC;AAEzC,MAAM,CAAC,MAAM,mBAAmB,GAAmC;IACjE,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,oDAAoD;IACjE,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAkC,EAAE;QACrF,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO;YACL;gBACE,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,OAAO;gBACf,QAAQ,EAAE,OAAO;gBACjB,OAAO,EACL,8HAA8H;gBAChI,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;aAC/B;SACF,CAAC;IACJ,CAAC,CAAC;CACL,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { FilesRuleContext } from "../../context.js";
+import type { AdvisoryRule } from "../../rule.js";
+export declare const manifestSchemaValidRule: AdvisoryRule<FilesRuleContext>;
+//# sourceMappingURL=manifest-schema-valid.d.ts.map

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

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

package/dist/src/unstable/lint/catalog/files/manifest-schema-valid.js

@@ -0,0 +1,12 @@
+import { FilesManifestSchema } from "../../../files/manifest-schema.js";
+import { schemaDecodeFindings } from "../shared/schema-rule.js";
+import { FILES_JSON } from "./helpers.js";
+const RULE_ID = "files/manifest-schema-valid";
+export const manifestSchemaValidRule = {
+    id: RULE_ID,
+    description: "files.json defines a valid files manifest.",
+    kind: "advisory",
+    severity: "error",
+    check: (files) => schemaDecodeFindings(RULE_ID, "error", FILES_JSON, FilesManifestSchema, files.subject.filesJson),
+};
+//# sourceMappingURL=manifest-schema-valid.js.map

package/dist/src/unstable/lint/catalog/files/manifest-schema-valid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-schema-valid.js","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/files/manifest-schema-valid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAGxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,OAAO,GAAG,6BAA6B,CAAC;AAE9C,MAAM,CAAC,MAAM,uBAAuB,GAAmC;IACrE,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,4CAA4C;IACzD,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,oBAAoB,CAClB,OAAO,EACP,OAAO,EACP,UAAU,EACV,mBAAmB,EACnB,KAAK,CAAC,OAAO,CAAC,SAAS,CACxB;CACJ,CAAC"}

package/dist/src/unstable/lint/catalog/files/marker-valid.d.ts

@@ -0,0 +1,4 @@
+import type { FilesRuleContext } from "../../context.js";
+import type { AdvisoryRule } from "../../rule.js";
+export declare const markerValidRule: AdvisoryRule<FilesRuleContext>;
+//# sourceMappingURL=marker-valid.d.ts.map

package/dist/src/unstable/lint/catalog/files/marker-valid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marker-valid.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/files/marker-valid.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,eAAe,CAAC;AAcnE,eAAO,MAAM,eAAe,EAAE,YAAY,CAAC,gBAAgB,CA+C1D,CAAC"}

package/dist/src/unstable/lint/catalog/{docs → files}/marker-valid.js

@@ -1,27 +1,27 @@
 import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
-import { advisory, containsAxmRegionMarker, decodeDocsManifest, DOCS_JSON, markerStyleForTarget, readPayloadString, sourcePaths, srcPath, } from "./helpers.js";
-const RULE_ID = "docs/marker-valid";
+import { advisory, containsAxmRegionMarker, decodeFilesManifest, FILES_JSON, markerStyleForTarget, readPayloadString, sourcePaths, srcPath, } from "./helpers.js";
+const RULE_ID = "files/marker-valid";
 export const markerValidRule = {
     id: RULE_ID,
     description: "Managed-region entries use comment-capable targets and whole-file payloads do not embed AXM markers.",
     kind: "advisory",
     severity: "error",
-    check: (docs) => Effect.gen(function* () {
-        const manifest = decodeDocsManifest(docs.subject.docsJson);
+    check: (files) => Effect.gen(function* () {
+        const manifest = decodeFilesManifest(files.subject.filesJson);
         if (Option.isNone(manifest)) {
             return [];
         }
         const findings = [];
         for (const [index, entry] of manifest.value.contents.entries()) {
             if (entry.mode === "managed-region" && Option.isNone(markerStyleForTarget(entry.target))) {
-                findings.push(advisory(RULE_ID, "error", `File contents entry ${index + 1} uses managed-region mode for comment-less target '${entry.target}'. Use a comment-capable target or whole-file mode.`, DOCS_JSON));
+                findings.push(advisory(RULE_ID, "error", `File contents entry ${index + 1} uses managed-region mode for comment-less target '${entry.target}'. Use a comment-capable target or whole-file mode.`, FILES_JSON));
             }
             if (entry.mode !== "sync-always" || entry.source.kind === "generated") {
                 continue;
             }
             for (const payloadPath of sourcePaths(entry.source)) {
-                const content = yield* readPayloadString(docs, payloadPath);
+                const content = yield* readPayloadString(files, payloadPath);
                 if (Option.isNone(content) || !containsAxmRegionMarker(content.value, entry.target)) {
                     continue;
                 }

package/dist/src/unstable/lint/catalog/files/marker-valid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marker-valid.js","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/files/marker-valid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EACL,QAAQ,EACR,uBAAuB,EACvB,mBAAmB,EACnB,UAAU,EACV,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,OAAO,GACR,MAAM,cAAc,CAAC;AAEtB,MAAM,OAAO,GAAG,oBAAoB,CAAC;AAErC,MAAM,CAAC,MAAM,eAAe,GAAmC;IAC7D,EAAE,EAAE,OAAO;IACX,WAAW,EACT,sGAAsG;IACxG,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,QAAQ,GAAG,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9D,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,QAAQ,GAA2B,EAAE,CAAC;QAC5C,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YAC/D,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,IAAI,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;gBACzF,QAAQ,CAAC,IAAI,CACX,QAAQ,CACN,OAAO,EACP,OAAO,EACP,uBAAuB,KAAK,GAAG,CAAC,sDAAsD,KAAK,CAAC,MAAM,qDAAqD,EACvJ,UAAU,CACX,CACF,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACtE,SAAS;YACX,CAAC;YACD,KAAK,MAAM,WAAW,IAAI,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,iBAAiB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;gBAC7D,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;oBACpF,SAAS;gBACX,CAAC;gBACD,QAAQ,CAAC,IAAI,CACX,QAAQ,CACN,OAAO,EACP,OAAO,EACP,wBAAwB,WAAW,0GAA0G,EAC7I,OAAO,CAAC,WAAW,CAAC,CACrB,CACF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;CACL,CAAC"}

package/dist/src/unstable/lint/catalog/files/package-valid.d.ts

@@ -0,0 +1,4 @@
+import type { FilesRuleContext } from "../../context.js";
+import type { AdvisoryRule } from "../../rule.js";
+export declare const packageValidRule: AdvisoryRule<FilesRuleContext>;
+//# sourceMappingURL=package-valid.d.ts.map

package/dist/src/unstable/lint/catalog/files/package-valid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-valid.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/files/package-valid.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,eAAe,CAAC;AAYnE,eAAO,MAAM,gBAAgB,EAAE,YAAY,CAAC,gBAAgB,CAsD3D,CAAC"}