@solaqua/skul 0.1.0

package/dist/bundle-manifest.d.ts

@@ -0,0 +1,26 @@
+import { type ToolName, type ToolTargetName } from "./tool-mapping";
+export declare const MANIFEST_FILE_NAME = "manifest.json";
+export interface BundleManifestTarget {
+    path: string;
+}
+export interface BundleManifest {
+    name?: string;
+    tools: Partial<Record<ToolName, Partial<Record<ToolTargetName, BundleManifestTarget>>>>;
+}
+export interface CachedBundleLayout {
+    sourceSegments: string[];
+    sourceDir: string;
+    bundleDir: string;
+    manifestFile: string;
+    resolveBundlePath(...segments: string[]): string;
+}
+/** Parses and validates a manifest JSON object into the internal bundle schema. */
+export declare function parseBundleManifest(input: unknown): BundleManifest;
+/** Infers a bundle manifest from canonical directories and native tool paths on disk. */
+export declare function inferBundleManifest(bundleDir: string): BundleManifest;
+/** Resolves the cache paths Skul uses for one source/bundle pair. */
+export declare function resolveCachedBundleLayout(options: {
+    libraryDir: string;
+    source: string;
+    bundle: string;
+}): CachedBundleLayout;

package/dist/bundle-manifest.js

@@ -0,0 +1,196 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MANIFEST_FILE_NAME = void 0;
+exports.parseBundleManifest = parseBundleManifest;
+exports.inferBundleManifest = inferBundleManifest;
+exports.resolveCachedBundleLayout = resolveCachedBundleLayout;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const tool_mapping_1 = require("./tool-mapping");
+exports.MANIFEST_FILE_NAME = "manifest.json";
+/** Parses and validates a manifest JSON object into the internal bundle schema. */
+function parseBundleManifest(input) {
+    const manifest = expectRecord(input, "manifest");
+    const toolsInput = expectRecord(manifest.tools, "tools");
+    const tools = Object.fromEntries(Object.entries(toolsInput).map(([toolName, targetsInput]) => {
+        const toolDef = parseToolDefinition(toolName, `tools.${toolName}`);
+        const toolTargetsInput = expectRecord(targetsInput, `tools.${toolName}`);
+        if (Object.keys(toolTargetsInput).length === 0) {
+            throw new Error(`tools.${toolName} must declare at least one target`);
+        }
+        const targets = Object.fromEntries(Object.entries(toolTargetsInput).map(([targetName, value]) => {
+            if (!(targetName in toolDef.targets)) {
+                throw new Error(`tools.${toolDef.name}.${targetName} is not supported for tool ${toolDef.name}`);
+            }
+            return [
+                targetName,
+                parseBundleManifestTarget(value, `tools.${toolDef.name}.${targetName}`),
+            ];
+        }));
+        return [toolDef.name, targets];
+    }));
+    if (Object.keys(tools).length === 0) {
+        throw new Error("tools must declare at least one tool");
+    }
+    return expandRootInstructionTargets({
+        ...(typeof manifest.name === "string" && manifest.name.trim() !== ""
+            ? { name: manifest.name }
+            : {}),
+        tools,
+    });
+}
+/** Infers a bundle manifest from canonical directories and native tool paths on disk. */
+function inferBundleManifest(bundleDir) {
+    const tools = {};
+    const allTools = (0, tool_mapping_1.listToolDefinitions)();
+    const canonicalTargetNames = [
+        "skills",
+        "commands",
+        "agents",
+    ];
+    // Process canonical directories (skills/, commands/, agents/) — Claude Code canonical format.
+    // These apply to all tools that support the given target.
+    for (const targetName of canonicalTargetNames) {
+        if (isExistingDirectory(node_path_1.default.join(bundleDir, targetName))) {
+            for (const toolDef of allTools) {
+                const targetDef = toolDef.targets[targetName];
+                if (targetDef?.kind === "directory") {
+                    if (!tools[toolDef.name])
+                        tools[toolDef.name] = {};
+                    tools[toolDef.name][targetName] = { path: targetName };
+                }
+            }
+        }
+    }
+    // Process native dotdirs (.claude/skills/, .cursor/commands/, etc.) — pre-authored native format.
+    // Native paths override canonical paths for the same tool + target.
+    for (const toolDef of allTools) {
+        for (const [targetName, targetDef] of Object.entries(toolDef.targets)) {
+            if (isExistingToolTarget(node_path_1.default.join(bundleDir, targetDef.path), targetDef.kind)) {
+                if (!tools[toolDef.name])
+                    tools[toolDef.name] = {};
+                tools[toolDef.name][targetName] = {
+                    path: targetDef.path,
+                };
+            }
+        }
+    }
+    return expandRootInstructionTargets({ tools });
+}
+function isExistingDirectory(dirPath) {
+    try {
+        return node_fs_1.default.statSync(dirPath).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function isExistingToolTarget(targetPath, kind) {
+    try {
+        const stat = node_fs_1.default.statSync(targetPath);
+        return kind === "directory" ? stat.isDirectory() : stat.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function expandRootInstructionTargets(manifest) {
+    const sourcePath = selectRootInstructionSourcePath(manifest.tools);
+    if (!sourcePath) {
+        return manifest;
+    }
+    const expandedTools = Object.fromEntries(Object.entries(manifest.tools).map(([toolName, targets]) => [
+        toolName,
+        { ...targets },
+    ]));
+    for (const toolDef of (0, tool_mapping_1.listToolDefinitions)()) {
+        if (!toolDef.targets.root_instruction) {
+            continue;
+        }
+        if (!expandedTools[toolDef.name]) {
+            expandedTools[toolDef.name] = {};
+        }
+        if (!expandedTools[toolDef.name].root_instruction) {
+            expandedTools[toolDef.name].root_instruction = { path: sourcePath };
+        }
+    }
+    return {
+        ...(manifest.name !== undefined ? { name: manifest.name } : {}),
+        tools: expandedTools,
+    };
+}
+function selectRootInstructionSourcePath(tools) {
+    for (const { name } of (0, tool_mapping_1.listToolDefinitions)()) {
+        const sourcePath = tools[name]?.root_instruction?.path;
+        if (sourcePath) {
+            return sourcePath;
+        }
+    }
+    return null;
+}
+/** Resolves the cache paths Skul uses for one source/bundle pair. */
+function resolveCachedBundleLayout(options) {
+    const libraryDir = expectNonEmptyString(options.libraryDir, "library directory");
+    const source = expectNonEmptyString(options.source, "source");
+    const bundle = expectSinglePathSegment(options.bundle, "bundle");
+    const sourceSegments = source
+        .split("/")
+        .map((segment) => expectSinglePathSegment(segment, "source"));
+    const sourceDir = node_path_1.default.join(libraryDir, ...sourceSegments);
+    const bundleDir = node_path_1.default.join(sourceDir, bundle);
+    return {
+        sourceSegments,
+        sourceDir,
+        bundleDir,
+        manifestFile: node_path_1.default.join(bundleDir, exports.MANIFEST_FILE_NAME),
+        resolveBundlePath: (...segments) => node_path_1.default.join(bundleDir, ...segments),
+    };
+}
+function parseBundleManifestTarget(input, label) {
+    const target = expectRecord(input, label);
+    return {
+        path: expectRelativePath(target.path, `${label}.path`),
+    };
+}
+function parseToolDefinition(input, label) {
+    const value = expectNonEmptyString(input, label);
+    const tools = (0, tool_mapping_1.listToolDefinitions)();
+    const toolDef = tools.find((t) => t.name === value);
+    if (toolDef) {
+        return toolDef;
+    }
+    throw new Error(`${label} must be one of: ${tools.map((t) => t.name).join(", ")}`);
+}
+function expectRecord(input, label) {
+    if (!input || typeof input !== "object" || Array.isArray(input)) {
+        throw new Error(`${label} must be an object`);
+    }
+    return input;
+}
+function expectNonEmptyString(input, label) {
+    if (typeof input !== "string" || input.trim() === "") {
+        throw new Error(`${label} is required`);
+    }
+    return input;
+}
+function expectSinglePathSegment(input, label) {
+    const value = expectNonEmptyString(input, label);
+    if (value.includes("/") || value === "." || value === "..") {
+        throw new Error(`${label} must be a single path segment`);
+    }
+    return value;
+}
+function expectRelativePath(input, label) {
+    const value = expectNonEmptyString(input, label);
+    const normalized = node_path_1.default.normalize(value);
+    if (node_path_1.default.isAbsolute(value) ||
+        normalized === "." ||
+        normalized.startsWith("..")) {
+        throw new Error(`${label} must be a relative path`);
+    }
+    return normalized;
+}
+//# sourceMappingURL=bundle-manifest.js.map

package/dist/bundle-manifest.js.map

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

package/dist/bundle-materialization.d.ts

@@ -0,0 +1,52 @@
+import { type BundleItemSelector } from "./bundle-items";
+import type { BundleManifest } from "./bundle-manifest";
+import type { FileConflictResolution } from "./cli";
+import { type ToolMaterializationLayout, type ToolName } from "./tool-mapping";
+export interface MaterializeBundleResult {
+    byTool: Partial<Record<ToolName, {
+        files: string[];
+        directories: string[];
+    }>>;
+}
+/**
+ * Predicts the initial repo-relative files a bundle targets before any
+ * conflict-resolution overwrites are applied.
+ *
+ * This is a side-effect-free preview used by higher-level safety checks such as
+ * root-instruction shadow protection, where Skul needs to know the exact
+ * root-instruction targets before it removes existing managed files or writes
+ * new content.
+ */
+export declare function previewMaterializeBundleWriteTargets(options: {
+    repoRoot: string;
+    bundleDir: string;
+    manifest: BundleManifest;
+    tools?: ToolName[];
+    itemSelectors?: BundleItemSelector[];
+    pathLayout?: ToolMaterializationLayout;
+    disableModelInvocation?: boolean;
+}): string[];
+/**
+ * Materializes a bundle into the repository, returning the files and
+ * directories that became owned by each tool.
+ *
+ * Callers may optionally provide `assertSafeWriteTarget` to veto individual
+ * writes before they happen and `resolveFileConflict` to overwrite or abort
+ * colliding outputs.
+ */
+export declare function materializeBundle(options: {
+    repoRoot: string;
+    bundleDir: string;
+    manifest: BundleManifest;
+    tools?: ToolName[];
+    itemSelectors?: BundleItemSelector[];
+    bundleName?: string;
+    bundleSource?: string;
+    assertSafeWriteTarget?: (repoRelativePath: string) => void;
+    allowFileOverwriteTargets?: Set<string>;
+    deferredWriteTargets?: Set<string>;
+    rootInstructionBaseContents?: Record<string, string>;
+    resolveFileConflict?: (conflictPath: string) => Promise<FileConflictResolution>;
+    pathLayout?: ToolMaterializationLayout;
+    disableModelInvocation?: boolean;
+}): Promise<MaterializeBundleResult>;