@thiagodiogo/pastelsdd 1.0.0-beta.1

package/dist/core/collections/runtime.d.ts

@@ -0,0 +1,46 @@
+export type CollectionMetadata = Readonly<Record<string, unknown>>;
+export type CollectionHooks = Readonly<Record<string, unknown>>;
+export interface CollectionDefinition<THandle = unknown> {
+    id: string;
+    mount: string;
+    metadata?: CollectionMetadata;
+    hooks?: CollectionHooks;
+    createHandle?: (context: MountedCollectionContext) => THandle;
+}
+export interface CollectionRegistry {
+    list(): readonly CollectionDefinition[];
+    get<THandle = unknown>(collectionId: string): CollectionDefinition<THandle> | undefined;
+    require<THandle = unknown>(collectionId: string): CollectionDefinition<THandle>;
+}
+export interface MountedCollectionContext {
+    storeRoot: string;
+    collectionId: string;
+    mount: string;
+    mountRoot: string;
+    resolvePath(relativePath?: string): string;
+    toStorePath(relativePath?: string): string;
+}
+export interface MountedCollection<THandle = unknown> {
+    collectionId: string;
+    mount: string;
+    mountRoot: string;
+    context: MountedCollectionContext;
+    handle: THandle | undefined;
+    resolvePath(relativePath?: string): string;
+    toStorePath(relativePath?: string): string;
+}
+export interface MountedCollectionRegistry {
+    list(): readonly MountedCollection[];
+    get<THandle = unknown>(collectionId: string): MountedCollection<THandle> | undefined;
+    require<THandle = unknown>(collectionId: string): MountedCollection<THandle>;
+}
+export interface MountCollectionsInput {
+    storeRoot: string;
+    collections: CollectionRegistry;
+}
+export declare function validateCollectionId(id: string): string;
+export declare function validateMount(mount: string): string;
+export declare function parseCollectionPath(input?: string): string;
+export declare function createCollectionRegistry(definitions: readonly CollectionDefinition[]): CollectionRegistry;
+export declare function mountCollections(input: MountCollectionsInput): MountedCollectionRegistry;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/core/collections/runtime.js

@@ -0,0 +1,194 @@
+import * as path from 'node:path';
+import { FileSystemUtils } from '../../utils/file-system.js';
+function assertNoNul(value, label) {
+    if (value.includes('\0')) {
+        throw new Error(`${label} must not contain NUL bytes`);
+    }
+}
+function validateKebabSegment(value, label) {
+    assertNoNul(value, label);
+    if (value.length === 0) {
+        throw new Error(`${label} must not be empty`);
+    }
+    if (value === '.' || value === '..') {
+        throw new Error(`${label} must not be '${value}'`);
+    }
+    if (/[\\/]/u.test(value)) {
+        throw new Error(`${label} must not contain path separators`);
+    }
+    if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(value)) {
+        throw new Error(`${label} must be kebab-case with lowercase letters, numbers, and single hyphen separators`);
+    }
+    return value;
+}
+export function validateCollectionId(id) {
+    return validateKebabSegment(id, 'Collection id');
+}
+export function validateMount(mount) {
+    assertNoNul(mount, 'Collection mount');
+    if (mount.startsWith('.')) {
+        throw new Error(`Collection mount '${mount}' is reserved`);
+    }
+    return validateKebabSegment(mount, 'Collection mount');
+}
+function isWindowsDrivePath(value) {
+    return /^[A-Za-z]:/u.test(value);
+}
+function isUncPath(value) {
+    return value.startsWith('\\\\') || value.startsWith('//');
+}
+export function parseCollectionPath(input = '') {
+    assertNoNul(input, 'Collection path');
+    if (input.length === 0) {
+        return '';
+    }
+    if (input.includes('\\')) {
+        throw new Error('Collection path must use forward slashes');
+    }
+    if (isWindowsDrivePath(input)) {
+        throw new Error('Collection path must not be a Windows drive path');
+    }
+    if (isUncPath(input) || path.posix.isAbsolute(input)) {
+        throw new Error('Collection path must be relative');
+    }
+    const segments = input.split('/');
+    for (const segment of segments) {
+        if (segment.length === 0) {
+            throw new Error('Collection path must not contain empty segments');
+        }
+        if (segment === '.' || segment === '..') {
+            throw new Error('Collection path must not contain dot segments');
+        }
+    }
+    return segments.join('/');
+}
+function compareCollectionDefinitions(a, b) {
+    return a.id.localeCompare(b.id);
+}
+export function createCollectionRegistry(definitions) {
+    const byId = new Map();
+    const mountOwners = new Map();
+    for (const definition of definitions) {
+        const id = validateCollectionId(definition.id);
+        const mount = validateMount(definition.mount);
+        if (byId.has(id)) {
+            throw new Error(`Duplicate collection id '${id}'`);
+        }
+        const existingMountOwner = mountOwners.get(mount);
+        if (existingMountOwner) {
+            throw new Error(`Duplicate collection mount '${mount}' for '${existingMountOwner}' and '${id}'`);
+        }
+        const normalizedDefinition = {
+            ...definition,
+            id,
+            mount,
+        };
+        byId.set(id, normalizedDefinition);
+        mountOwners.set(mount, id);
+    }
+    const sortedDefinitions = Array.from(byId.values()).sort(compareCollectionDefinitions);
+    return {
+        list() {
+            return [...sortedDefinitions];
+        },
+        get(collectionId) {
+            const id = validateCollectionId(collectionId);
+            return byId.get(id);
+        },
+        require(collectionId) {
+            const definition = this.get(collectionId);
+            if (!definition) {
+                throw new Error(`Unknown collection '${collectionId}'`);
+            }
+            return definition;
+        },
+    };
+}
+function isWindowsLikePath(candidatePath) {
+    return /^[A-Za-z]:[\\/]/u.test(candidatePath) || candidatePath.startsWith('\\\\');
+}
+function relativePath(fromPath, toPath) {
+    if (isWindowsLikePath(fromPath) || isWindowsLikePath(toPath)) {
+        return path.win32.relative(path.win32.normalize(fromPath), path.win32.normalize(toPath));
+    }
+    return path.posix.relative(fromPath.replace(/\\/g, '/'), toPath.replace(/\\/g, '/'));
+}
+function isRelativePathAbsolute(value, windowsLike) {
+    return windowsLike ? path.win32.isAbsolute(value) : path.posix.isAbsolute(value);
+}
+function isSameOrDescendant(rootPath, candidatePath) {
+    const windowsLike = isWindowsLikePath(rootPath) || isWindowsLikePath(candidatePath);
+    const relative = relativePath(rootPath, candidatePath);
+    const escapesRoot = /^\.\.(?:[\\/]|$)/u.test(relative);
+    return (relative === '' ||
+        (!escapesRoot && !isRelativePathAbsolute(relative, windowsLike)));
+}
+function getMountRoot(storeRoot, mount) {
+    return FileSystemUtils.joinPath(storeRoot, validateMount(mount));
+}
+function resolvePathInsideMount(mountRoot, relativePath) {
+    const collectionPath = parseCollectionPath(relativePath);
+    const resolvedPath = collectionPath.length > 0
+        ? FileSystemUtils.joinPath(mountRoot, collectionPath)
+        : mountRoot;
+    if (!isSameOrDescendant(mountRoot, resolvedPath)) {
+        throw new Error(`Collection path escapes mount: ${relativePath ?? ''}`);
+    }
+    return resolvedPath;
+}
+function toStorePath(mount, relativePath) {
+    const collectionPath = parseCollectionPath(relativePath);
+    return collectionPath.length > 0
+        ? `${validateMount(mount)}/${collectionPath}`
+        : validateMount(mount);
+}
+function createMountedCollection(storeRoot, definition) {
+    const mountRoot = getMountRoot(storeRoot, definition.mount);
+    const resolveMountedPath = (relativePath) => resolvePathInsideMount(mountRoot, relativePath);
+    const resolveStorePath = (relativePath) => toStorePath(definition.mount, relativePath);
+    const context = {
+        storeRoot,
+        collectionId: definition.id,
+        mount: definition.mount,
+        mountRoot,
+        resolvePath: resolveMountedPath,
+        toStorePath: resolveStorePath,
+    };
+    return {
+        collectionId: definition.id,
+        mount: definition.mount,
+        mountRoot,
+        context,
+        handle: definition.createHandle?.(context),
+        resolvePath: resolveMountedPath,
+        toStorePath: resolveStorePath,
+    };
+}
+export function mountCollections(input) {
+    if (input.storeRoot.length === 0) {
+        throw new Error('Context store root must not be empty');
+    }
+    const byId = new Map();
+    for (const definition of input.collections.list()) {
+        const mountedCollection = createMountedCollection(input.storeRoot, definition);
+        byId.set(mountedCollection.collectionId, mountedCollection);
+    }
+    const sortedCollections = Array.from(byId.values()).sort((a, b) => a.collectionId.localeCompare(b.collectionId));
+    return {
+        list() {
+            return [...sortedCollections];
+        },
+        get(collectionId) {
+            const id = validateCollectionId(collectionId);
+            return byId.get(id);
+        },
+        require(collectionId) {
+            const mountedCollection = this.get(collectionId);
+            if (!mountedCollection) {
+                throw new Error(`Unknown mounted collection '${collectionId}'`);
+            }
+            return mountedCollection;
+        },
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/core/command-generation/adapters/amazon-q.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Amazon Q Developer Command Adapter
+ *
+ * Formats commands for Amazon Q Developer following its frontmatter specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Amazon Q adapter for command generation.
+ * File path: .amazonq/prompts/pastel-<id>.md
+ * Frontmatter: description
+ */
+export declare const amazonQAdapter: ToolCommandAdapter;
+//# sourceMappingURL=amazon-q.d.ts.map

package/dist/core/command-generation/adapters/amazon-q.js

@@ -0,0 +1,26 @@
+/**
+ * Amazon Q Developer Command Adapter
+ *
+ * Formats commands for Amazon Q Developer following its frontmatter specification.
+ */
+import path from 'path';
+/**
+ * Amazon Q adapter for command generation.
+ * File path: .amazonq/prompts/pastel-<id>.md
+ * Frontmatter: description
+ */
+export const amazonQAdapter = {
+    toolId: 'amazon-q',
+    getFilePath(commandId) {
+        return path.join('.amazonq', 'prompts', `pastel-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+description: ${content.description}
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=amazon-q.js.map

package/dist/core/command-generation/adapters/antigravity.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Antigravity Command Adapter
+ *
+ * Formats commands for Antigravity following its frontmatter specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Antigravity adapter for command generation.
+ * File path: .agent/workflows/pastel-<id>.md
+ * Frontmatter: description
+ */
+export declare const antigravityAdapter: ToolCommandAdapter;
+//# sourceMappingURL=antigravity.d.ts.map

package/dist/core/command-generation/adapters/antigravity.js

@@ -0,0 +1,26 @@
+/**
+ * Antigravity Command Adapter
+ *
+ * Formats commands for Antigravity following its frontmatter specification.
+ */
+import path from 'path';
+/**
+ * Antigravity adapter for command generation.
+ * File path: .agent/workflows/pastel-<id>.md
+ * Frontmatter: description
+ */
+export const antigravityAdapter = {
+    toolId: 'antigravity',
+    getFilePath(commandId) {
+        return path.join('.agent', 'workflows', `pastel-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+description: ${content.description}
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=antigravity.js.map

package/dist/core/command-generation/adapters/auggie.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Auggie (Augment CLI) Command Adapter
+ *
+ * Formats commands for Auggie following its frontmatter specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Auggie adapter for command generation.
+ * File path: .augment/commands/pastel-<id>.md
+ * Frontmatter: description, argument-hint
+ */
+export declare const auggieAdapter: ToolCommandAdapter;
+//# sourceMappingURL=auggie.d.ts.map

package/dist/core/command-generation/adapters/auggie.js

@@ -0,0 +1,27 @@
+/**
+ * Auggie (Augment CLI) Command Adapter
+ *
+ * Formats commands for Auggie following its frontmatter specification.
+ */
+import path from 'path';
+/**
+ * Auggie adapter for command generation.
+ * File path: .augment/commands/pastel-<id>.md
+ * Frontmatter: description, argument-hint
+ */
+export const auggieAdapter = {
+    toolId: 'auggie',
+    getFilePath(commandId) {
+        return path.join('.augment', 'commands', `pastel-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+description: ${content.description}
+argument-hint: command arguments
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=auggie.js.map

package/dist/core/command-generation/adapters/bob.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Bob Shell Command Adapter
+ *
+ * Formats commands for Bob Shell following its markdown specification.
+ * Commands are stored in .bob/commands/ directory.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Bob Shell adapter for command generation.
+ * File path: .bob/commands/pastel-<id>.md
+ * Frontmatter: description, argument-hint
+ */
+export declare const bobAdapter: ToolCommandAdapter;
+//# sourceMappingURL=bob.d.ts.map

package/dist/core/command-generation/adapters/bob.js

@@ -0,0 +1,45 @@
+/**
+ * Bob Shell Command Adapter
+ *
+ * Formats commands for Bob Shell following its markdown specification.
+ * Commands are stored in .bob/commands/ directory.
+ */
+import path from 'path';
+import { transformToHyphenCommands } from '../../../utils/command-references.js';
+/**
+ * Escapes a string value for safe YAML output.
+ * Quotes the string if it contains special YAML characters.
+ */
+function escapeYamlValue(value) {
+    // Check if value needs quoting (contains special YAML characters or starts/ends with whitespace)
+    const needsQuoting = /[:\n\r#{}[\],&*!|>'"%@`]|^\s|\s$/.test(value);
+    if (needsQuoting) {
+        // Use double quotes and escape internal double quotes and backslashes
+        const escaped = value.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n');
+        return `"${escaped}"`;
+    }
+    return value;
+}
+/**
+ * Bob Shell adapter for command generation.
+ * File path: .bob/commands/pastel-<id>.md
+ * Frontmatter: description, argument-hint
+ */
+export const bobAdapter = {
+    toolId: 'bob',
+    getFilePath(commandId) {
+        return path.join('.bob', 'commands', `pastel-${commandId}.md`);
+    },
+    formatFile(content) {
+        // Transform command references from colon to hyphen format for Bob
+        const transformedBody = transformToHyphenCommands(content.body);
+        return `---
+description: ${escapeYamlValue(content.description)}
+argument-hint: command arguments
+---
+
+${transformedBody}
+`;
+    },
+};
+//# sourceMappingURL=bob.js.map

package/dist/core/command-generation/adapters/claude.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Claude Code Command Adapter
+ *
+ * Formats commands for Claude Code following its frontmatter specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Claude Code adapter for command generation.
+ * File path: .claude/commands/pastel/<id>.md
+ * Frontmatter: name, description, category, tags
+ */
+export declare const claudeAdapter: ToolCommandAdapter;
+//# sourceMappingURL=claude.d.ts.map

package/dist/core/command-generation/adapters/claude.js

@@ -0,0 +1,50 @@
+/**
+ * Claude Code Command Adapter
+ *
+ * Formats commands for Claude Code following its frontmatter specification.
+ */
+import path from 'path';
+/**
+ * Escapes a string value for safe YAML output.
+ * Quotes the string if it contains special YAML characters.
+ */
+function escapeYamlValue(value) {
+    // Check if value needs quoting (contains special YAML characters or starts/ends with whitespace)
+    const needsQuoting = /[:\n\r#{}[\],&*!|>'"%@`]|^\s|\s$/.test(value);
+    if (needsQuoting) {
+        // Use double quotes and escape internal double quotes and backslashes
+        const escaped = value.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n');
+        return `"${escaped}"`;
+    }
+    return value;
+}
+/**
+ * Formats a tags array as a YAML array with proper escaping.
+ */
+function formatTagsArray(tags) {
+    const escapedTags = tags.map((tag) => escapeYamlValue(tag));
+    return `[${escapedTags.join(', ')}]`;
+}
+/**
+ * Claude Code adapter for command generation.
+ * File path: .claude/commands/pastel/<id>.md
+ * Frontmatter: name, description, category, tags
+ */
+export const claudeAdapter = {
+    toolId: 'claude',
+    getFilePath(commandId) {
+        return path.join('.claude', 'commands', 'pastel', `${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+name: ${escapeYamlValue(content.name)}
+description: ${escapeYamlValue(content.description)}
+category: ${escapeYamlValue(content.category)}
+tags: ${formatTagsArray(content.tags)}
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=claude.js.map

package/dist/core/command-generation/adapters/cline.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Cline Command Adapter
+ *
+ * Formats commands for Cline following its workflow specification.
+ * Cline uses markdown headers instead of YAML frontmatter.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Cline adapter for command generation.
+ * File path: .clinerules/workflows/pastel-<id>.md
+ * Format: Markdown header with description
+ */
+export declare const clineAdapter: ToolCommandAdapter;
+//# sourceMappingURL=cline.d.ts.map

package/dist/core/command-generation/adapters/cline.js

@@ -0,0 +1,27 @@
+/**
+ * Cline Command Adapter
+ *
+ * Formats commands for Cline following its workflow specification.
+ * Cline uses markdown headers instead of YAML frontmatter.
+ */
+import path from 'path';
+/**
+ * Cline adapter for command generation.
+ * File path: .clinerules/workflows/pastel-<id>.md
+ * Format: Markdown header with description
+ */
+export const clineAdapter = {
+    toolId: 'cline',
+    getFilePath(commandId) {
+        return path.join('.clinerules', 'workflows', `pastel-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `# ${content.name}
+
+${content.description}
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=cline.js.map

package/dist/core/command-generation/adapters/codebuddy.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CodeBuddy Command Adapter
+ *
+ * Formats commands for CodeBuddy following its frontmatter specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * CodeBuddy adapter for command generation.
+ * File path: .codebuddy/commands/pastel/<id>.md
+ * Frontmatter: name, description, argument-hint
+ */
+export declare const codebuddyAdapter: ToolCommandAdapter;
+//# sourceMappingURL=codebuddy.d.ts.map

package/dist/core/command-generation/adapters/codebuddy.js

@@ -0,0 +1,28 @@
+/**
+ * CodeBuddy Command Adapter
+ *
+ * Formats commands for CodeBuddy following its frontmatter specification.
+ */
+import path from 'path';
+/**
+ * CodeBuddy adapter for command generation.
+ * File path: .codebuddy/commands/pastel/<id>.md
+ * Frontmatter: name, description, argument-hint
+ */
+export const codebuddyAdapter = {
+    toolId: 'codebuddy',
+    getFilePath(commandId) {
+        return path.join('.codebuddy', 'commands', 'pastel', `${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+name: ${content.name}
+description: "${content.description}"
+argument-hint: "[command arguments]"
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=codebuddy.js.map

package/dist/core/command-generation/adapters/codex.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Codex Command Adapter
+ *
+ * Formats commands for Codex following its frontmatter specification.
+ * Codex custom prompts live in the global home directory (~/.codex/prompts/)
+ * and are not shared through the repository. The CODEX_HOME env var can
+ * override the default ~/.codex location.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Codex adapter for command generation.
+ * File path: <CODEX_HOME>/prompts/pastel-<id>.md (absolute, global)
+ * Frontmatter: description, argument-hint
+ */
+export declare const codexAdapter: ToolCommandAdapter;
+//# sourceMappingURL=codex.d.ts.map

package/dist/core/command-generation/adapters/codex.js

@@ -0,0 +1,39 @@
+/**
+ * Codex Command Adapter
+ *
+ * Formats commands for Codex following its frontmatter specification.
+ * Codex custom prompts live in the global home directory (~/.codex/prompts/)
+ * and are not shared through the repository. The CODEX_HOME env var can
+ * override the default ~/.codex location.
+ */
+import os from 'os';
+import path from 'path';
+/**
+ * Returns the Codex home directory.
+ * Respects the CODEX_HOME env var, defaulting to ~/.codex.
+ */
+function getCodexHome() {
+    const envHome = process.env.CODEX_HOME?.trim();
+    return path.resolve(envHome ? envHome : path.join(os.homedir(), '.codex'));
+}
+/**
+ * Codex adapter for command generation.
+ * File path: <CODEX_HOME>/prompts/pastel-<id>.md (absolute, global)
+ * Frontmatter: description, argument-hint
+ */
+export const codexAdapter = {
+    toolId: 'codex',
+    getFilePath(commandId) {
+        return path.join(getCodexHome(), 'prompts', `pastel-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+description: ${content.description}
+argument-hint: command arguments
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=codex.js.map

package/dist/core/command-generation/adapters/continue.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Continue Command Adapter
+ *
+ * Formats commands for Continue following its .prompt specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Continue adapter for command generation.
+ * File path: .continue/prompts/pastel-<id>.prompt
+ * Frontmatter: name, description, invokable
+ */
+export declare const continueAdapter: ToolCommandAdapter;
+//# sourceMappingURL=continue.d.ts.map

package/dist/core/command-generation/adapters/continue.js

@@ -0,0 +1,28 @@
+/**
+ * Continue Command Adapter
+ *
+ * Formats commands for Continue following its .prompt specification.
+ */
+import path from 'path';
+/**
+ * Continue adapter for command generation.
+ * File path: .continue/prompts/pastel-<id>.prompt
+ * Frontmatter: name, description, invokable
+ */
+export const continueAdapter = {
+    toolId: 'continue',
+    getFilePath(commandId) {
+        return path.join('.continue', 'prompts', `pastel-${commandId}.prompt`);
+    },
+    formatFile(content) {
+        return `---
+name: pastel-${content.id}
+description: ${content.description}
+invokable: true
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=continue.js.map