@sentry/warden 0.0.0 → 0.1.0

package/dist/skills/loader.test.js

@@ -0,0 +1,241 @@
+import { describe, it, expect, beforeEach, afterAll } from 'vitest';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { writeFileSync, unlinkSync, mkdtempSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { clearSkillsCache, loadSkillFromFile, loadSkillFromMarkdown, loadSkillsFromDirectory, resolveSkillAsync, resolveSkillPath, SkillLoaderError, SKILL_DIRECTORIES, } from './loader.js';
+describe('loadSkillFromFile', () => {
+    it('rejects unsupported file types', async () => {
+        await expect(loadSkillFromFile('/path/to/skill.json')).rejects.toThrow(SkillLoaderError);
+        await expect(loadSkillFromFile('/path/to/skill.json')).rejects.toThrow('Unsupported skill file');
+    });
+    it('throws for missing files', async () => {
+        await expect(loadSkillFromFile('/nonexistent/skill.md')).rejects.toThrow(SkillLoaderError);
+    });
+});
+describe('resolveSkillAsync', () => {
+    it('resolves skills from conventional directories', async () => {
+        const repoRoot = new URL('../..', import.meta.url).pathname;
+        const skill = await resolveSkillAsync('testing-guidelines', repoRoot);
+        expect(skill.name).toBe('testing-guidelines');
+        expect(skill.description).toBeDefined();
+    });
+    it('throws for unknown skills', async () => {
+        await expect(resolveSkillAsync('nonexistent-skill')).rejects.toThrow(SkillLoaderError);
+        await expect(resolveSkillAsync('nonexistent-skill')).rejects.toThrow('Skill not found');
+    });
+});
+describe('skills caching', () => {
+    const skillsDir = new URL('../../.claude/skills', import.meta.url).pathname;
+    beforeEach(() => {
+        clearSkillsCache();
+    });
+    it('caches directory loads', async () => {
+        const skills1 = await loadSkillsFromDirectory(skillsDir);
+        expect(skills1.size).toBeGreaterThan(0);
+        // Second load should return cached result (same reference)
+        const skills2 = await loadSkillsFromDirectory(skillsDir);
+        expect(skills2).toBe(skills1);
+    });
+    it('clearSkillsCache clears the cache', async () => {
+        const skills1 = await loadSkillsFromDirectory(skillsDir);
+        clearSkillsCache();
+        const skills2 = await loadSkillsFromDirectory(skillsDir);
+        // After clearing, should be a new Map instance
+        expect(skills2).not.toBe(skills1);
+    });
+});
+describe('rootDir tracking', () => {
+    const skillsDir = new URL('../../.claude/skills', import.meta.url).pathname;
+    it('sets rootDir when loading from markdown', async () => {
+        const skillPath = join(skillsDir, 'testing-guidelines', 'SKILL.md');
+        const skill = await loadSkillFromMarkdown(skillPath);
+        expect(skill.rootDir).toBe(join(skillsDir, 'testing-guidelines'));
+    });
+    it('sets rootDir for skills from conventional directories', async () => {
+        const repoRoot = new URL('../..', import.meta.url).pathname;
+        const skill = await resolveSkillAsync('testing-guidelines', repoRoot);
+        expect(skill).toBeDefined();
+        expect(skill.rootDir).toContain('skills');
+        expect(skill.rootDir).toContain('testing-guidelines');
+    });
+});
+describe('direct path resolution', () => {
+    const skillsDir = new URL('../../.claude/skills', import.meta.url).pathname;
+    it('resolves skill from directory path with SKILL.md', async () => {
+        const skillDir = join(skillsDir, 'testing-guidelines');
+        const skill = await resolveSkillAsync(skillDir);
+        expect(skill.name).toBe('testing-guidelines');
+        expect(skill.rootDir).toBe(skillDir);
+    });
+    it('resolves skill from file path', async () => {
+        const skillPath = join(skillsDir, 'testing-guidelines', 'SKILL.md');
+        const skill = await resolveSkillAsync(skillPath);
+        expect(skill.name).toBe('testing-guidelines');
+    });
+    it('resolves relative path with repoRoot', async () => {
+        const repoRoot = new URL('../..', import.meta.url).pathname;
+        const skill = await resolveSkillAsync('./.claude/skills/testing-guidelines', repoRoot);
+        expect(skill.name).toBe('testing-guidelines');
+    });
+    it('throws for nonexistent path', async () => {
+        await expect(resolveSkillAsync('./nonexistent/skill')).rejects.toThrow(SkillLoaderError);
+        await expect(resolveSkillAsync('./nonexistent/skill')).rejects.toThrow('Skill not found at path');
+    });
+});
+describe('SKILL_DIRECTORIES', () => {
+    it('contains expected directories in order', () => {
+        expect(SKILL_DIRECTORIES).toEqual([
+            '.warden/skills',
+            '.agents/skills',
+            '.claude/skills',
+        ]);
+    });
+});
+describe('resolveSkillPath', () => {
+    it('expands ~ to home directory', () => {
+        const result = resolveSkillPath('~/code/skills/my-skill');
+        expect(result).toBe(join(homedir(), 'code/skills/my-skill'));
+    });
+    it('expands lone ~ to home directory', () => {
+        const result = resolveSkillPath('~');
+        expect(result).toBe(homedir());
+    });
+    it('preserves absolute paths', () => {
+        const absolutePath = '/Users/test/code/skills/my-skill';
+        const result = resolveSkillPath(absolutePath, '/some/repo');
+        expect(result).toBe(absolutePath);
+    });
+    it('joins relative paths with repoRoot', () => {
+        const result = resolveSkillPath('./skills/my-skill', '/repo/root');
+        expect(result).toBe('/repo/root/skills/my-skill');
+    });
+    it('returns relative path as-is when no repoRoot', () => {
+        const result = resolveSkillPath('./skills/my-skill');
+        expect(result).toBe('./skills/my-skill');
+    });
+});
+describe('resolveSkillAsync with absolute and tilde paths', () => {
+    const skillsDir = new URL('../../.claude/skills', import.meta.url).pathname;
+    it('resolves absolute path to skill directory', async () => {
+        const absolutePath = join(skillsDir, 'testing-guidelines');
+        const skill = await resolveSkillAsync(absolutePath, '/different/repo');
+        expect(skill.name).toBe('testing-guidelines');
+    });
+    it('resolves absolute path to skill file', async () => {
+        const absolutePath = join(skillsDir, 'testing-guidelines', 'SKILL.md');
+        const skill = await resolveSkillAsync(absolutePath, '/different/repo');
+        expect(skill.name).toBe('testing-guidelines');
+    });
+    it('resolves tilde path to skill directory', async () => {
+        // Create a path using ~ that points to the skills dir
+        const homeRelativePath = skillsDir.replace(homedir(), '~');
+        // Only run this test if the skills dir is under home
+        if (homeRelativePath.startsWith('~/')) {
+            const skill = await resolveSkillAsync(`${homeRelativePath}/testing-guidelines`, '/different/repo');
+            expect(skill.name).toBe('testing-guidelines');
+        }
+    });
+});
+describe('flat markdown skill files', () => {
+    const tempDir = mkdtempSync(join(tmpdir(), 'warden-test-'));
+    const tempSkillPath = join(tempDir, 'my-custom-skill.md');
+    // Create a flat .md skill file with non-SKILL.md filename
+    writeFileSync(tempSkillPath, `---
+name: my-custom-skill
+description: A test skill with custom filename
+---
+
+This is the prompt content.
+`);
+    afterAll(() => {
+        try {
+            unlinkSync(tempSkillPath);
+        }
+        catch {
+            // ignore cleanup errors
+        }
+    });
+    it('loads flat .md files with any filename (not just SKILL.md)', async () => {
+        const skill = await loadSkillFromFile(tempSkillPath);
+        expect(skill.name).toBe('my-custom-skill');
+        expect(skill.description).toBe('A test skill with custom filename');
+        expect(skill.prompt).toBe('This is the prompt content.');
+    });
+    it('loadSkillFromFile accepts .md extension', async () => {
+        // A flat .md file should be loaded using loadSkillFromMarkdown
+        // (same as SKILL.md format with frontmatter)
+        const skillsDir = new URL('../../.claude/skills', import.meta.url).pathname;
+        const skillMdPath = join(skillsDir, 'testing-guidelines', 'SKILL.md');
+        const skill = await loadSkillFromFile(skillMdPath);
+        expect(skill.name).toBe('testing-guidelines');
+    });
+    it('loadSkillsFromDirectory returns entry paths for tracking', async () => {
+        const skillsDir = new URL('../../.claude/skills', import.meta.url).pathname;
+        clearSkillsCache();
+        const skills = await loadSkillsFromDirectory(skillsDir);
+        // Each loaded skill should have an entry field matching the directory name
+        const skillWriter = skills.get('testing-guidelines');
+        expect(skillWriter).toBeDefined();
+        expect(skillWriter.skill.name).toBe('testing-guidelines');
+        expect(skillWriter.entry).toBe('testing-guidelines');
+    });
+    it('loadSkillsFromDirectory calls onWarning for malformed skills', async () => {
+        const warnings = [];
+        const onWarning = (message) => warnings.push(message);
+        // Create a temp directory with a malformed skill
+        const tempDir = join(import.meta.dirname, '.test-malformed-skills');
+        const { mkdirSync, writeFileSync, rmSync } = await import('node:fs');
+        try {
+            mkdirSync(tempDir, { recursive: true });
+            // Create a .md file with frontmatter but missing required name field
+            writeFileSync(join(tempDir, 'bad-skill.md'), `---
+description: Missing name field
+---
+Content here
+`);
+            clearSkillsCache();
+            await loadSkillsFromDirectory(tempDir, { onWarning });
+            expect(warnings.length).toBe(1);
+            expect(warnings[0]).toContain('bad-skill.md');
+            expect(warnings[0]).toContain("missing 'name'");
+        }
+        finally {
+            rmSync(tempDir, { recursive: true, force: true });
+        }
+    });
+    it('warns when invalid tool names are filtered from allowed-tools', async () => {
+        const warnings = [];
+        const onWarning = (message) => warnings.push(message);
+        // Create a temp directory with a skill containing invalid tool names
+        const tempDir = join(import.meta.dirname, '.test-invalid-tools');
+        const { mkdirSync, writeFileSync, rmSync } = await import('node:fs');
+        try {
+            mkdirSync(tempDir, { recursive: true });
+            // Create a skill with a mix of valid and invalid tool names
+            writeFileSync(join(tempDir, 'test-skill.md'), `---
+name: test-skill
+description: A test skill with invalid tools
+allowed-tools: Read InvalidTool Grep FakeTool
+---
+Test prompt content.
+`);
+            clearSkillsCache();
+            const skills = await loadSkillsFromDirectory(tempDir, { onWarning });
+            // Skill should still load with only valid tools
+            const skill = skills.get('test-skill');
+            expect(skill).toBeDefined();
+            expect(skill.skill.tools?.allowed).toEqual(['Read', 'Grep']);
+            // Should have warnings for each invalid tool
+            expect(warnings.length).toBe(2);
+            expect(warnings[0]).toContain("Invalid tool name 'InvalidTool'");
+            expect(warnings[0]).toContain('ignored');
+            expect(warnings[0]).toContain('Valid tools:');
+            expect(warnings[1]).toContain("Invalid tool name 'FakeTool'");
+        }
+        finally {
+            rmSync(tempDir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=loader.test.js.map

package/dist/skills/loader.test.js.map

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

package/dist/skills/remote.d.ts

@@ -0,0 +1,117 @@
+import { z } from 'zod';
+import type { SkillDefinition } from '../config/schema.js';
+/** Schema for a single remote entry in state.json */
+declare const RemoteEntrySchema: z.ZodObject<{
+    sha: z.ZodString;
+    fetchedAt: z.ZodString;
+}, z.core.$strip>;
+/** Schema for the entire state.json file */
+declare const RemoteStateSchema: z.ZodObject<{
+    remotes: z.ZodRecord<z.ZodString, z.ZodObject<{
+        sha: z.ZodString;
+        fetchedAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type RemoteEntry = z.infer<typeof RemoteEntrySchema>;
+export type RemoteState = z.infer<typeof RemoteStateSchema>;
+/** Parsed remote reference */
+export interface ParsedRemoteRef {
+    owner: string;
+    repo: string;
+    sha?: string;
+}
+/**
+ * Parse a remote reference string into its components.
+ * Supports formats:
+ * - "owner/repo" or "owner/repo@sha"
+ * - "https://github.com/owner/repo" or "https://github.com/owner/repo@sha"
+ * - "https://github.com/owner/repo.git" or "https://github.com/owner/repo.git@sha"
+ * - "git@github.com:owner/repo.git" or "git@github.com:owner/repo.git@sha"
+ */
+export declare function parseRemoteRef(ref: string): ParsedRemoteRef;
+/**
+ * Format a parsed remote ref back to string format.
+ */
+export declare function formatRemoteRef(parsed: ParsedRemoteRef): string;
+/**
+ * Get the base directory for caching remote skills.
+ * Respects WARDEN_STATE_DIR environment variable.
+ * Default: ~/.local/warden/skills/
+ */
+export declare function getSkillsCacheDir(): string;
+/**
+ * Get the cache path for a specific remote ref.
+ * - Unpinned: ~/.local/warden/skills/owner/repo/
+ * - Pinned: ~/.local/warden/skills/owner/repo@sha/
+ */
+export declare function getRemotePath(ref: string): string;
+/**
+ * Get the path to the state.json file.
+ */
+export declare function getStatePath(): string;
+/**
+ * Load the remote state from state.json.
+ * Returns an empty state if the file doesn't exist.
+ */
+export declare function loadState(): RemoteState;
+/**
+ * Save the remote state to state.json.
+ * Uses atomic write (write to temp, then rename).
+ */
+export declare function saveState(state: RemoteState): void;
+/**
+ * Get the TTL for remote skill cache in seconds.
+ * Respects WARDEN_SKILL_CACHE_TTL environment variable.
+ */
+export declare function getCacheTtlSeconds(): number;
+/**
+ * Check if an unpinned remote ref needs to be refreshed.
+ * Pinned refs (with @sha) never need refresh.
+ */
+export declare function shouldRefresh(ref: string, state: RemoteState): boolean;
+export interface FetchRemoteOptions {
+    /** Force refresh even if cache is valid */
+    force?: boolean;
+    /** Skip network operations - only use cache */
+    offline?: boolean;
+    /** Callback for progress messages */
+    onProgress?: (message: string) => void;
+}
+/**
+ * Clone or update a remote repository to the cache.
+ * Returns the SHA of the fetched commit.
+ */
+export declare function fetchRemote(ref: string, options?: FetchRemoteOptions): Promise<string>;
+export interface DiscoveredRemoteSkill {
+    name: string;
+    description: string;
+    path: string;
+    /** Plugin name for marketplace format skills */
+    pluginName?: string;
+}
+/**
+ * Discover all skills in a cached remote repository.
+ * Detects format and delegates to appropriate discovery function:
+ * - If .claude-plugin/marketplace.json exists, uses marketplace discovery
+ * - Otherwise, uses traditional discovery (root, skills/, .warden/skills, etc.)
+ */
+export declare function discoverRemoteSkills(ref: string): Promise<DiscoveredRemoteSkill[]>;
+/**
+ * Resolve a skill from a remote repository.
+ * Ensures the remote is fetched/cached, then loads the skill.
+ * Matches by skill name (from SKILL.md), not directory name.
+ */
+export declare function resolveRemoteSkill(ref: string, skillName: string, options?: FetchRemoteOptions): Promise<SkillDefinition>;
+/**
+ * Remove a remote from the cache.
+ */
+export declare function removeRemote(ref: string): void;
+/**
+ * List all cached remotes with their metadata.
+ */
+export declare function listCachedRemotes(): {
+    ref: string;
+    entry: RemoteEntry;
+}[];
+export {};
+//# sourceMappingURL=remote.d.ts.map

package/dist/skills/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/skills/remote.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D,qDAAqD;AACrD,QAAA,MAAM,iBAAiB;;;iBAGrB,CAAC;AAEH,4CAA4C;AAC5C,QAAA,MAAM,iBAAiB;;;;;iBAErB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAoB5D,8BAA8B;AAC9B,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AA2BD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CA+D3D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,WAAW,CAiBvC;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAelD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAS3C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAkBtE;AAED,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qCAAqC;IACrC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAoBD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwFhG;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAiID;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAexF;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,eAAe,CAAC,CAiB1B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAW9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,EAAE,CAGzE"}