@solaqua/skul 0.1.0 → 0.1.1

package/dist/utils/testing.d.ts

@@ -0,0 +1,38 @@
+/** Formats one expected root-instruction bundle block with Skul boundary markers. */
+export declare function formatRootInstructionBundleBlock(bundle: string, content: string, source?: string): string;
+/** Formats one expected tracked root-instruction shadow block. */
+export declare function formatTrackedRootInstructionShadowBlock(bundle: string, content: string): string;
+/** Joins expected root-instruction document parts using the production document layout. */
+export declare function formatExpectedRootInstructionDocument(...parts: string[]): string;
+/** Writes one root-instruction test bundle fixture into the local cache layout. */
+export declare function writeRootInstructionBundleFixture(homeDir: string, options: {
+    bundle: string;
+    content: string;
+    source?: string;
+    agent?: "codex" | "claude-code";
+    filePath?: string;
+    extraTools?: Record<string, object>;
+    extraFiles?: Record<string, string>;
+}, helpers: {
+    writeManifest: (homeDir: string, source: string, bundle: string, manifest: object) => void;
+    writeBundleFile: (homeDir: string, source: string | undefined, bundle: string, relativePath: string, content: string) => void;
+}): void;
+/** Writes multiple shared root-instruction test bundle fixtures into the local cache layout. */
+export declare function setupSharedRootInstructionBundles(homeDir: string, bundles: Array<{
+    bundle: string;
+    content: string;
+    source?: string;
+    agent?: "codex" | "claude-code";
+    filePath?: string;
+    extraTools?: Record<string, object>;
+    extraFiles?: Record<string, string>;
+}>, helpers: {
+    writeManifest: (homeDir: string, source: string, bundle: string, manifest: object) => void;
+    writeBundleFile: (homeDir: string, source: string | undefined, bundle: string, relativePath: string, content: string) => void;
+}): void;
+/** Asserts the exact rendered contents of one managed root-instruction file. */
+export declare function expectRootInstructionDocument(repoRoot: string, fileName: "AGENTS.md" | "CLAUDE.md", ...parts: string[]): void;
+/** Asserts the exact rendered contents of `AGENTS.md`. */
+export declare function expectAgentsDocument(repoRoot: string, ...parts: string[]): void;
+/** Asserts the exact rendered contents of `CLAUDE.md`. */
+export declare function expectClaudeDocument(repoRoot: string, ...parts: string[]): void;

package/dist/utils/testing.js

@@ -0,0 +1,70 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatRootInstructionBundleBlock = formatRootInstructionBundleBlock;
+exports.formatTrackedRootInstructionShadowBlock = formatTrackedRootInstructionShadowBlock;
+exports.formatExpectedRootInstructionDocument = formatExpectedRootInstructionDocument;
+exports.writeRootInstructionBundleFixture = writeRootInstructionBundleFixture;
+exports.setupSharedRootInstructionBundles = setupSharedRootInstructionBundles;
+exports.expectRootInstructionDocument = expectRootInstructionDocument;
+exports.expectAgentsDocument = expectAgentsDocument;
+exports.expectClaudeDocument = expectClaudeDocument;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const vitest_1 = require("vitest");
+/** Formats one expected root-instruction bundle block with Skul boundary markers. */
+function formatRootInstructionBundleBlock(bundle, content, source) {
+    const label = source ? `${bundle} (${source})` : bundle;
+    const normalizedContent = content.replace(/\s+$/, "");
+    return `<!-- BEGIN SKUL BUNDLE: ${label} -->\n${normalizedContent}\n<!-- END SKUL BUNDLE: ${label} -->`;
+}
+/** Formats one expected tracked root-instruction shadow block. */
+function formatTrackedRootInstructionShadowBlock(bundle, content) {
+    const normalizedContent = content.replace(/\s+$/, "");
+    return `<!-- SKUL SHADOW START bundle=${bundle} -->\n${normalizedContent}\n<!-- SKUL SHADOW END -->`;
+}
+/** Joins expected root-instruction document parts using the production document layout. */
+function formatExpectedRootInstructionDocument(...parts) {
+    return `${parts
+        .map((part) => part.replace(/\s+$/, ""))
+        .filter((part) => part.length > 0)
+        .join("\n\n")}\n`;
+}
+/** Writes one root-instruction test bundle fixture into the local cache layout. */
+function writeRootInstructionBundleFixture(homeDir, options, helpers) {
+    const source = options.source ?? "github.com/user/ai-vault";
+    const agent = options.agent ?? "codex";
+    const filePath = options.filePath ?? (agent === "codex" ? "AGENTS.md" : "CLAUDE.md");
+    helpers.writeManifest(homeDir, source, options.bundle, {
+        name: options.bundle,
+        tools: {
+            ...options.extraTools,
+            [agent]: { root_instruction: { path: filePath } },
+        },
+    });
+    helpers.writeBundleFile(homeDir, source, options.bundle, filePath, options.content);
+    for (const [relativePath, content] of Object.entries(options.extraFiles ?? {})) {
+        helpers.writeBundleFile(homeDir, source, options.bundle, relativePath, content);
+    }
+}
+/** Writes multiple shared root-instruction test bundle fixtures into the local cache layout. */
+function setupSharedRootInstructionBundles(homeDir, bundles, helpers) {
+    for (const bundle of bundles) {
+        writeRootInstructionBundleFixture(homeDir, bundle, helpers);
+    }
+}
+/** Asserts the exact rendered contents of one managed root-instruction file. */
+function expectRootInstructionDocument(repoRoot, fileName, ...parts) {
+    (0, vitest_1.expect)(node_fs_1.default.readFileSync(node_path_1.default.join(repoRoot, fileName), "utf8")).toBe(formatExpectedRootInstructionDocument(...parts));
+}
+/** Asserts the exact rendered contents of `AGENTS.md`. */
+function expectAgentsDocument(repoRoot, ...parts) {
+    expectRootInstructionDocument(repoRoot, "AGENTS.md", ...parts);
+}
+/** Asserts the exact rendered contents of `CLAUDE.md`. */
+function expectClaudeDocument(repoRoot, ...parts) {
+    expectRootInstructionDocument(repoRoot, "CLAUDE.md", ...parts);
+}
+//# sourceMappingURL=testing.js.map

package/dist/utils/testing.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solaqua/skul",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "AI configuration layer manager for project-scoped bundles (project setup only)",
   "homepage": "https://sjquant.github.io/skul/",
   "bugs": {