@agentxm/client-core 0.11.1 → 0.11.3

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

@@ -0,0 +1,94 @@
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { advisory, decodeContextFilesManifest, CONTEXT_FILES_JSON, isUnsafeWorkspaceTarget, } from "./helpers.js";
+const RULE_ID = "context-files/generator-valid";
+const tocOptions = new Set(["source", "region"]);
+const fileIndexOptions = new Set([
+    "format",
+    "include",
+    "exclude",
+    "maxDepth",
+    "includeHidden",
+    "respectGitignore",
+    "descriptors",
+]);
+export const generatorValidRule = {
+    id: RULE_ID,
+    description: "Generated file contents use supported generators and option shapes.",
+    kind: "advisory",
+    severity: "error",
+    check: (context) => Effect.succeed((() => {
+        const manifest = decodeContextFilesManifest(context.subject.contextFilesJson);
+        if (Option.isNone(manifest)) {
+            return [];
+        }
+        const findings = [];
+        for (const [index, entry] of manifest.value.contents.entries()) {
+            if (entry.source.kind !== "generated") {
+                continue;
+            }
+            findings.push(...validateGenerator(index + 1, entry.source.generator));
+        }
+        return findings;
+    })()),
+};
+const validateGenerator = (entryNumber, generator) => {
+    switch (generator.name) {
+        case "toc":
+            return validateTocGenerator(entryNumber, generator);
+        case "file-index":
+            return validateFileIndexGenerator(entryNumber, generator);
+    }
+};
+const validateTocGenerator = (entryNumber, generator) => {
+    const findings = unknownOptionFindings(entryNumber, generator, tocOptions);
+    const source = generator.options?.["source"];
+    if (typeof source !== "string" || source.trim() === "") {
+        findings.push(optionFinding(entryNumber, "toc", "source", "must be a non-empty string."));
+    }
+    else if (isUnsafeWorkspaceTarget(source)) {
+        findings.push(optionFinding(entryNumber, "toc", "source", "must be a relative workspace path."));
+    }
+    const region = generator.options?.["region"];
+    if (region !== undefined && typeof region !== "string") {
+        findings.push(optionFinding(entryNumber, "toc", "region", "must be a string when set."));
+    }
+    return findings;
+};
+const validateFileIndexGenerator = (entryNumber, generator) => {
+    const findings = unknownOptionFindings(entryNumber, generator, fileIndexOptions);
+    const format = generator.options?.["format"];
+    if (format !== undefined && format !== "list" && format !== "tree") {
+        findings.push(optionFinding(entryNumber, "file-index", "format", "must be 'list' or 'tree'."));
+    }
+    for (const key of ["include", "exclude"]) {
+        const value = generator.options?.[key];
+        if (value !== undefined && typeof value !== "string") {
+            findings.push(optionFinding(entryNumber, "file-index", key, "must be a comma-separated string."));
+        }
+    }
+    const maxDepth = generator.options?.["maxDepth"];
+    if (maxDepth !== undefined &&
+        (typeof maxDepth !== "number" || !Number.isInteger(maxDepth) || maxDepth < 0)) {
+        findings.push(optionFinding(entryNumber, "file-index", "maxDepth", "must be a non-negative integer."));
+    }
+    for (const key of ["includeHidden", "respectGitignore", "descriptors"]) {
+        const value = generator.options?.[key];
+        if (value !== undefined && typeof value !== "boolean") {
+            findings.push(optionFinding(entryNumber, "file-index", key, "must be a boolean."));
+        }
+    }
+    return findings;
+};
+const unknownOptionFindings = (entryNumber, generator, allowed) => {
+    const findings = [];
+    for (const key of Object.keys(generator.options ?? {})) {
+        if (allowed.has(key)) {
+            continue;
+        }
+        findings.push(optionFinding(entryNumber, generator.name, key, "is not a supported option."));
+    }
+    return findings;
+};
+const optionFinding = (entryNumber, generator, option, detail) => advisory(RULE_ID, "error", `File contents entry ${entryNumber} uses generator '${generator}' with invalid option '${option}': ${detail}`, CONTEXT_FILES_JSON);
+//# sourceMappingURL=generator-valid.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generator-valid.js","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/context-files/generator-valid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,EACL,QAAQ,EACR,0BAA0B,EAC1B,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAEtB,MAAM,OAAO,GAAG,+BAA+B,CAAC;AAChD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AACjD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IAC/B,QAAQ;IACR,SAAS;IACT,SAAS;IACT,UAAU;IACV,eAAe;IACf,kBAAkB;IAClB,aAAa;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAA0C;IACvE,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,qEAAqE;IAClF,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CACjB,MAAM,CAAC,OAAO,CACZ,CAAC,GAAmC,EAAE;QACpC,MAAM,QAAQ,GAAG,0BAA0B,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC9E,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,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACtC,SAAS;YACX,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC,EAAE,CACL;CACJ,CAAC;AAEF,MAAM,iBAAiB,GAAG,CACxB,WAAmB,EACnB,SAA4B,EACI,EAAE;IAClC,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;QACvB,KAAK,KAAK;YACR,OAAO,oBAAoB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACtD,KAAK,YAAY;YACf,OAAO,0BAA0B,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAC3B,WAAmB,EACnB,SAA4B,EACI,EAAE;IAClC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACvD,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,6BAA6B,CAAC,CAAC,CAAC;IAC5F,CAAC;SAAM,IAAI,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3C,QAAQ,CAAC,IAAI,CACX,aAAa,CAAC,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,oCAAoC,CAAC,CAClF,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACvD,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,4BAA4B,CAAC,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,0BAA0B,GAAG,CACjC,WAAmB,EACnB,SAA4B,EACI,EAAE;IAClC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,WAAW,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;IACjF,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACnE,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,2BAA2B,CAAC,CAAC,CAAC;IACjG,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACrD,QAAQ,CAAC,IAAI,CACX,aAAa,CAAC,WAAW,EAAE,YAAY,EAAE,GAAG,EAAE,mCAAmC,CAAC,CACnF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,CAAC;IACjD,IACE,QAAQ,KAAK,SAAS;QACtB,CAAC,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,EAC7E,CAAC;QACD,QAAQ,CAAC,IAAI,CACX,aAAa,CAAC,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,iCAAiC,CAAC,CACxF,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,kBAAkB,EAAE,aAAa,CAAC,EAAE,CAAC;QACvE,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YACtD,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,YAAY,EAAE,GAAG,EAAE,oBAAoB,CAAC,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAC5B,WAAmB,EACnB,SAA4B,EAC5B,OAA4B,EACJ,EAAE;IAC1B,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;QACvD,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,SAAS;QACX,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,4BAA4B,CAAC,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CACpB,WAAmB,EACnB,SAAiB,EACjB,MAAc,EACd,MAAc,EACG,EAAE,CACnB,QAAQ,CACN,OAAO,EACP,OAAO,EACP,uBAAuB,WAAW,oBAAoB,SAAS,0BAA0B,MAAM,MAAM,MAAM,EAAE,EAC7G,kBAAkB,CACnB,CAAC"}

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

@@ -0,0 +1,19 @@
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { type FileCommentStyle } from "../../../context-files/markers.js";
+import { type FileContentSource, type ContextFilesManifest } from "../../../context-files/manifest-schema.js";
+import type { ContextFilesRuleContext } from "../../context.js";
+import type { AdvisoryFinding, Severity } from "../../rule.js";
+export declare const CONTEXT_FILES_JSON = "context-files.json";
+export declare const SRC_ROOT = "src";
+export declare const decodeContextFilesManifest: (input: unknown) => Option.Option<ContextFilesManifest>;
+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: (context: ContextFilesRuleContext, 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;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/context-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,mCAAmC,CAAC;AAC3C,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EAC1B,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE/D,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AACvD,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAI9B,eAAO,MAAM,0BAA0B,GAAI,OAAO,OAAO,KAAG,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAM7F,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,MAA2B,KAChC,eAMD,CAAC;AAEH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,uBAAuB,EAChC,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/context-files/helpers.js

@@ -0,0 +1,45 @@
+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 "../../../context-files/markers.js";
+import { ContextFilesManifestSchema, } from "../../../context-files/manifest-schema.js";
+export const CONTEXT_FILES_JSON = "context-files.json";
+export const SRC_ROOT = "src";
+const decoder = new TextDecoder();
+export const decodeContextFilesManifest = (input) => {
+    const result = Schema.decodeUnknownResult(ContextFilesManifestSchema)(input, {
+        onExcessProperty: "ignore",
+        errors: "all",
+    });
+    return Result.isSuccess(result) ? Option.some(result.success) : Option.none();
+};
+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 = CONTEXT_FILES_JSON) => ({
+    kind: "advisory",
+    ruleId,
+    severity,
+    message,
+    location: { file },
+});
+export const readPayloadString = (context, payloadPath) => context.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) ||
+        target.startsWith("/") ||
+        target.startsWith("\\")) {
+        return true;
+    }
+    const normalized = target.replace(/\\/g, "/");
+    return (normalized.split("/").some((segment) => segment === "..") || normalized.startsWith(".axm/"));
+};
+export const markerStyleForTarget = (target) => commentStyleForTarget(target);
+export const containsAxmRegionMarker = (content, target) => {
+    const style = markerStyleForTarget(target);
+    if (Option.isNone(style)) {
+        return /axm:(?:start|end)\b/.test(content);
+    }
+    return content.split(/\r?\n/).some((line) => Option.isSome(parseRegionMarker(line, style.value)));
+};
+//# sourceMappingURL=helpers.js.map

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

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

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-keys-recognized.js","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/context-files/manifest-keys-recognized.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AAGvF,OAAO,EAAE,4BAA4B,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,OAAO,GAAG,wCAAwC,CAAC;AACzD,MAAM,WAAW,GAAG,eAAe,CAAC,0BAA0B,CAAC,CAAC;AAEhE,MAAM,CAAC,MAAM,0BAA0B,GAA0C;IAC/E,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,0DAA0D;IACvE,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CACjB,MAAM,CAAC,OAAO,CACZ,4BAA4B,CAC1B,OAAO,EACP,OAAO,EACP,kBAAkB,EAClB,WAAW,EACX,OAAO,CAAC,OAAO,CAAC,gBAAgB,CACjC,CACF;CACJ,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-present.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/context-files/manifest-present.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,eAAe,CAAC;AAKnE,eAAO,MAAM,mBAAmB,EAAE,YAAY,CAAC,uBAAuB,CAwBrE,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-present.js","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/context-files/manifest-present.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,OAAO,GAAG,gCAAgC,CAAC;AAEjD,MAAM,CAAC,MAAM,mBAAmB,GAA0C;IACxE,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,oEAAoE;IACjF,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CACjB,MAAM,CAAC,GAAG,CACR,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,kBAAkB,CAAC,EACxC,CAAC,OAAO,EAAkC,EAAE;QAC1C,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,8IAA8I;gBAChJ,QAAQ,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE;aACvC;SACF,CAAC;IACJ,CAAC,CACF;CACJ,CAAC"}

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-schema-valid.js","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/context-files/manifest-schema-valid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AAGvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,OAAO,GAAG,qCAAqC,CAAC;AAEtD,MAAM,CAAC,MAAM,uBAAuB,GAA0C;IAC5E,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,4DAA4D;IACzE,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CACjB,oBAAoB,CAClB,OAAO,EACP,OAAO,EACP,kBAAkB,EAClB,0BAA0B,EAC1B,OAAO,CAAC,OAAO,CAAC,gBAAgB,CACjC;CACJ,CAAC"}

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

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

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

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

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

@@ -0,0 +1,34 @@
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { advisory, containsAxmRegionMarker, decodeContextFilesManifest, CONTEXT_FILES_JSON, markerStyleForTarget, readPayloadString, sourcePaths, srcPath, } from "./helpers.js";
+const RULE_ID = "context-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: (context) => Effect.gen(function* () {
+        const manifest = decodeContextFilesManifest(context.subject.contextFilesJson);
+        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.`, CONTEXT_FILES_JSON));
+            }
+            if (entry.mode !== "sync-always" || entry.source.kind === "generated") {
+                continue;
+            }
+            for (const payloadPath of sourcePaths(entry.source)) {
+                const content = yield* readPayloadString(context, payloadPath);
+                if (Option.isNone(content) || !containsAxmRegionMarker(content.value, entry.target)) {
+                    continue;
+                }
+                findings.push(advisory(RULE_ID, "error", `Sync-always payload '${payloadPath}' embeds AXM managed-region markers. Remove markers from whole-file payloads or use managed-region mode.`, srcPath(payloadPath)));
+            }
+        }
+        return findings;
+    }),
+};
+//# sourceMappingURL=marker-valid.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"marker-valid.js","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/context-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,0BAA0B,EAC1B,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,OAAO,GACR,MAAM,cAAc,CAAC;AAEtB,MAAM,OAAO,GAAG,4BAA4B,CAAC;AAE7C,MAAM,CAAC,MAAM,eAAe,GAA0C;IACpE,EAAE,EAAE,OAAO;IACX,WAAW,EACT,sGAAsG;IACxG,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CACjB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,QAAQ,GAAG,0BAA0B,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC9E,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,kBAAkB,CACnB,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,OAAO,EAAE,WAAW,CAAC,CAAC;gBAC/D,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/context-files/package-valid.d.ts

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

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

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

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

@@ -0,0 +1,42 @@
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { advisory, decodeContextFilesManifest, CONTEXT_FILES_JSON, sourcePaths, SRC_ROOT, srcPath, } from "./helpers.js";
+const RULE_ID = "context-files/package-valid";
+export const packageValidRule = {
+    id: RULE_ID,
+    description: "context-files.json references existing payload files and no orphan src/ payloads.",
+    kind: "advisory",
+    severity: "error",
+    check: (context) => Effect.gen(function* () {
+        const manifest = decodeContextFilesManifest(context.subject.contextFilesJson);
+        if (Option.isNone(manifest)) {
+            return [];
+        }
+        const referenced = new Set();
+        const findings = [];
+        for (const entry of manifest.value.contents) {
+            if (entry.source.kind === "generated") {
+                continue;
+            }
+            for (const payloadPath of sourcePaths(entry.source)) {
+                const file = srcPath(payloadPath);
+                referenced.add(file);
+                const exists = yield* context.files.exists(file);
+                if (!exists) {
+                    findings.push(advisory(RULE_ID, "error", `File payload '${payloadPath}' is referenced by context-files.json but is missing under src/. Add \`${file}\` or update the contents entry.`, CONTEXT_FILES_JSON));
+                }
+            }
+        }
+        const payloadFiles = yield* context.files
+            .listFiles(SRC_ROOT)
+            .pipe(Effect.catch(() => Effect.succeed([])));
+        for (const payloadFile of payloadFiles) {
+            if (referenced.has(payloadFile)) {
+                continue;
+            }
+            findings.push(advisory(RULE_ID, "warning", `File payload '${payloadFile}' is present under src/ but no context-files.json contents entry references it. Remove the orphan payload or add it to contents.`, payloadFile));
+        }
+        return findings;
+    }),
+};
+//# sourceMappingURL=package-valid.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"package-valid.js","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/context-files/package-valid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EACL,QAAQ,EACR,0BAA0B,EAC1B,kBAAkB,EAClB,WAAW,EACX,QAAQ,EACR,OAAO,GACR,MAAM,cAAc,CAAC;AAEtB,MAAM,OAAO,GAAG,6BAA6B,CAAC;AAE9C,MAAM,CAAC,MAAM,gBAAgB,GAA0C;IACrE,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,mFAAmF;IAChG,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CACjB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,QAAQ,GAAG,0BAA0B,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC9E,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QACrC,MAAM,QAAQ,GAA2B,EAAE,CAAC;QAC5C,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC5C,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACtC,SAAS;YACX,CAAC;YACD,KAAK,MAAM,WAAW,IAAI,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpD,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;gBAClC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACrB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACjD,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,QAAQ,CAAC,IAAI,CACX,QAAQ,CACN,OAAO,EACP,OAAO,EACP,iBAAiB,WAAW,0EAA0E,IAAI,kCAAkC,EAC5I,kBAAkB,CACnB,CACF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK;aACtC,SAAS,CAAC,QAAQ,CAAC;aACnB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAChD,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;YACvC,IAAI,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;gBAChC,SAAS;YACX,CAAC;YACD,QAAQ,CAAC,IAAI,CACX,QAAQ,CACN,OAAO,EACP,SAAS,EACT,iBAAiB,WAAW,kIAAkI,EAC9J,WAAW,CACZ,CACF,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;CACL,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"target-valid.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/context-files/target-valid.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,eAAe,CAAC;AAUnE,eAAO,MAAM,eAAe,EAAE,YAAY,CAAC,uBAAuB,CAgDjE,CAAC"}

package/dist/src/unstable/lint/catalog/context-files/target-valid.js

@@ -0,0 +1,34 @@
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { advisory, decodeContextFilesManifest, CONTEXT_FILES_JSON, isUnsafeWorkspaceTarget, } from "./helpers.js";
+const RULE_ID = "context-files/target-valid";
+export const targetValidRule = {
+    id: RULE_ID,
+    description: "File contents targets stay within the workspace and avoid whole-file collisions.",
+    kind: "advisory",
+    severity: "error",
+    check: (context) => Effect.succeed((() => {
+        const manifest = decodeContextFilesManifest(context.subject.contextFilesJson);
+        if (Option.isNone(manifest)) {
+            return [];
+        }
+        const findings = [];
+        const wholeFileTargets = new Map();
+        for (const [index, entry] of manifest.value.contents.entries()) {
+            if (isUnsafeWorkspaceTarget(entry.target)) {
+                findings.push(advisory(RULE_ID, "error", `File contents entry ${index + 1} uses unsafe workspace target '${entry.target}'. Use a relative target that stays outside .axm/.`, CONTEXT_FILES_JSON));
+            }
+            if (entry.mode === "sync-always") {
+                wholeFileTargets.set(entry.target, (wholeFileTargets.get(entry.target) ?? 0) + 1);
+            }
+        }
+        for (const [target, count] of wholeFileTargets) {
+            if (count <= 1) {
+                continue;
+            }
+            findings.push(advisory(RULE_ID, "warning", `Multiple sync-always entries write whole-file target '${target}'. Keep only one owner for that target to avoid nondeterministic materialization.`, CONTEXT_FILES_JSON));
+        }
+        return findings;
+    })()),
+};
+//# sourceMappingURL=target-valid.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"target-valid.js","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/context-files/target-valid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EACL,QAAQ,EACR,0BAA0B,EAC1B,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAEtB,MAAM,OAAO,GAAG,4BAA4B,CAAC;AAE7C,MAAM,CAAC,MAAM,eAAe,GAA0C;IACpE,EAAE,EAAE,OAAO;IACX,WAAW,EAAE,kFAAkF;IAC/F,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CACjB,MAAM,CAAC,OAAO,CACZ,CAAC,GAAmC,EAAE;QACpC,MAAM,QAAQ,GAAG,0BAA0B,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC9E,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,QAAQ,GAA2B,EAAE,CAAC;QAC5C,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;QACnD,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YAC/D,IAAI,uBAAuB,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1C,QAAQ,CAAC,IAAI,CACX,QAAQ,CACN,OAAO,EACP,OAAO,EACP,uBAAuB,KAAK,GAAG,CAAC,kCAAkC,KAAK,CAAC,MAAM,oDAAoD,EAClI,kBAAkB,CACnB,CACF,CAAC;YACJ,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBACjC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACpF,CAAC;QACH,CAAC;QAED,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,gBAAgB,EAAE,CAAC;YAC/C,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,SAAS;YACX,CAAC;YACD,QAAQ,CAAC,IAAI,CACX,QAAQ,CACN,OAAO,EACP,SAAS,EACT,yDAAyD,MAAM,mFAAmF,EAClJ,kBAAkB,CACnB,CACF,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC,EAAE,CACL;CACJ,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"template-valid.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/context-files/template-valid.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,eAAe,CAAC;AAcnE,eAAO,MAAM,iBAAiB,EAAE,YAAY,CAAC,uBAAuB,CAwFnE,CAAC"}

package/dist/src/unstable/lint/catalog/context-files/template-valid.js

@@ -0,0 +1,69 @@
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import { advisory, decodeContextFilesManifest, CONTEXT_FILES_JSON, readPayloadString, sourcePaths, srcPath, } from "./helpers.js";
+const RULE_ID = "context-files/template-valid";
+const templateExpressionPattern = /\$\{([^}]+)\}/g;
+const secretNamePattern = /(?:secret|token|password|passwd|api[-_]?key|private[-_]?key)/i;
+export const templateValidRule = {
+    id: RULE_ID,
+    description: "File templates reference declared scalar inputs and avoid secret-shaped inputs.",
+    kind: "advisory",
+    severity: "error",
+    check: (context) => Effect.gen(function* () {
+        const manifest = decodeContextFilesManifest(context.subject.contextFilesJson);
+        if (Option.isNone(manifest)) {
+            return [];
+        }
+        const declaredInputs = new Set(Object.keys(manifest.value.inputs ?? {}));
+        const findings = [];
+        for (const inputName of declaredInputs) {
+            if (!secretNamePattern.test(inputName)) {
+                continue;
+            }
+            findings.push(advisory(RULE_ID, "warning", `File input '${inputName}' looks secret-shaped. File templates do not support secret templating; use non-secret scalar inputs only.`, CONTEXT_FILES_JSON));
+        }
+        for (const entry of manifest.value.contents) {
+            if (entry.source.kind !== "template") {
+                continue;
+            }
+            for (const payloadPath of sourcePaths(entry.source)) {
+                const content = yield* readPayloadString(context, payloadPath);
+                if (Option.isNone(content)) {
+                    continue;
+                }
+                for (const expression of templateExpressions(content.value)) {
+                    const [namespace, key, extra] = expression.split(".");
+                    if (namespace === undefined || key === undefined || extra !== undefined) {
+                        findings.push(advisory(RULE_ID, "error", `Template payload '${payloadPath}' contains unsupported expression '\${${expression}}'. Use \${inputs.*}, \${vars.*}, or \${workspace.root}.`, srcPath(payloadPath)));
+                        continue;
+                    }
+                    if (namespace === "inputs" && !declaredInputs.has(key)) {
+                        findings.push(advisory(RULE_ID, "error", `Template payload '${payloadPath}' references undeclared input '${key}'. Declare it in context-files.json inputs or remove the placeholder.`, srcPath(payloadPath)));
+                    }
+                    else if (namespace === "workspace" && key !== "root") {
+                        findings.push(advisory(RULE_ID, "error", `Template payload '${payloadPath}' references unsupported workspace value '${key}'. Only \${workspace.root} is supported.`, srcPath(payloadPath)));
+                    }
+                    else if (namespace !== "inputs" &&
+                        namespace !== "vars" &&
+                        namespace !== "workspace") {
+                        findings.push(advisory(RULE_ID, "error", `Template payload '${payloadPath}' references unsupported namespace '${namespace}'. Use inputs, vars, or workspace.`, srcPath(payloadPath)));
+                    }
+                }
+            }
+        }
+        return findings;
+    }),
+};
+const templateExpressions = (content) => {
+    const expressions = [];
+    let match = templateExpressionPattern.exec(content);
+    while (match !== null) {
+        const expression = match[1];
+        if (expression !== undefined) {
+            expressions.push(expression);
+        }
+        match = templateExpressionPattern.exec(content);
+    }
+    return expressions;
+};
+//# sourceMappingURL=template-valid.js.map

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

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

package/dist/src/unstable/lint/catalog/context-files-accessor/contexts.d.ts

@@ -0,0 +1,10 @@
+import type { ContextFilesAccessor, ContextFilesRuleContext } from "../../context.js";
+export interface InstalledContextFilesInfo {
+    readonly contextFilesJson: unknown;
+    readonly displayRoot: string;
+    readonly files: ContextFilesAccessor;
+}
+export declare const buildContextFilesRuleContexts: (input: {
+    readonly installedContextFiles: ReadonlyArray<InstalledContextFilesInfo>;
+}) => ReadonlyArray<ContextFilesRuleContext>;
+//# sourceMappingURL=contexts.d.ts.map

package/dist/src/unstable/lint/catalog/context-files-accessor/contexts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contexts.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/context-files-accessor/contexts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAEtF,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;CACtC;AAED,eAAO,MAAM,6BAA6B,GAAI,OAAO;IACnD,QAAQ,CAAC,qBAAqB,EAAE,aAAa,CAAC,yBAAyB,CAAC,CAAC;CAC1E,KAAG,aAAa,CAAC,uBAAuB,CAStC,CAAC"}

package/dist/src/unstable/lint/catalog/context-files-accessor/contexts.js

@@ -0,0 +1,8 @@
+export const buildContextFilesRuleContexts = (input) => input.installedContextFiles.map((info) => ({
+    subject: {
+        contextFilesJson: info.contextFilesJson,
+    },
+    files: info.files,
+    displayRoot: info.displayRoot,
+}));
+//# sourceMappingURL=contexts.js.map

package/dist/src/unstable/lint/catalog/context-files-accessor/contexts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contexts.js","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/context-files-accessor/contexts.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,KAE7C,EAA0C,EAAE,CAC3C,KAAK,CAAC,qBAAqB,CAAC,GAAG,CAC7B,CAAC,IAAI,EAA2B,EAAE,CAAC,CAAC;IAClC,OAAO,EAAE;QACP,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;KACxC;IACD,KAAK,EAAE,IAAI,CAAC,KAAK;IACjB,WAAW,EAAE,IAAI,CAAC,WAAW;CAC9B,CAAC,CACH,CAAC"}

package/dist/src/unstable/lint/catalog/context-files-accessor/platform.d.ts

@@ -0,0 +1,9 @@
+import type * as FileSystem from "effect/FileSystem";
+import type * as Path from "effect/Path";
+import type { ContextFilesAccessor } from "../../context.js";
+export interface ContextFilesAccessorPlatform {
+    readonly fs: FileSystem.FileSystem;
+    readonly path: Path.Path;
+}
+export declare const makePlatformContextFilesAccessor: (platform: ContextFilesAccessorPlatform, absoluteRoot: string) => ContextFilesAccessor;
+//# sourceMappingURL=platform.d.ts.map

package/dist/src/unstable/lint/catalog/context-files-accessor/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/lint/catalog/context-files-accessor/platform.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,UAAU,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,KAAK,IAAI,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAmB,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE9E,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,UAAU,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;CAC1B;AAMD,eAAO,MAAM,gCAAgC,GAC3C,UAAU,4BAA4B,EACtC,cAAc,MAAM,KACnB,oBA0GF,CAAC"}