@ekroon/opencode-copilot-instructions 0.1.0

package/README.md

@@ -0,0 +1,103 @@
+# @ekroon/opencode-copilot-instructions
+
+An OpenCode plugin that automatically loads GitHub Copilot custom instruction files and injects them into OpenCode's context.
+
+## Installation
+
+### From npm (recommended)
+
+Add the plugin to your `opencode.json`:
+
+```json
+{
+  "plugin": ["@ekroon/opencode-copilot-instructions"]
+}
+```
+
+OpenCode will automatically install the package from npm on startup.
+
+### From local files
+
+For development or customization, you can use the local plugin approach:
+
+1. Create `.opencode/plugin/` directory in your project
+2. Bundle the plugin: `bun build ./src/index.ts --outfile=.opencode/plugin/copilot.js --target=node --external:@opencode-ai/plugin`
+3. Create `.opencode/package.json` with dependencies:
+
+```json
+{
+  "dependencies": {
+    "front-matter": "^4.0.2",
+    "picomatch": "^4.0.0"
+  }
+}
+```
+
+4. Run `bun install` in the `.opencode/` directory
+
+## Usage
+
+This plugin supports two types of GitHub Copilot instruction files:
+
+### Repository-wide Instructions
+
+Create `.github/copilot-instructions.md` in your repository root. These instructions apply to all files and are included in every session.
+
+```markdown
+# Project Guidelines
+
+- Use TypeScript strict mode
+- Prefer functional programming patterns
+- Write comprehensive tests for all new code
+```
+
+### Path-specific Instructions
+
+Create files matching `.github/instructions/*.instructions.md`. These instructions only apply when working with files that match the specified glob patterns.
+
+Each file requires YAML frontmatter with an `applyTo` field:
+
+```markdown
+---
+applyTo: "**/*.ts,**/*.tsx"
+---
+
+When writing TypeScript code:
+
+- Always use explicit return types
+- Prefer interfaces over type aliases for object shapes
+- Use branded types for IDs
+```
+
+The `applyTo` field accepts a comma-separated list of glob patterns.
+
+## How it Works
+
+### Loading
+
+Instructions are loaded once when the plugin initializes (at OpenCode startup). To reload instructions after changes, restart OpenCode.
+
+### Injection
+
+- **Repository-wide instructions**: Injected via the `experimental.session.compacting` hook, ensuring they persist across session compaction.
+
+- **Path-specific instructions**: Injected via the `tool.execute.before` hook when file operations (read, edit, write) target files matching the `applyTo` patterns.
+
+## Supported Glob Patterns
+
+The plugin uses [picomatch](https://github.com/micromatch/picomatch) for pattern matching. Supported patterns include:
+
+| Pattern | Description |
+|---------|-------------|
+| `*` | All files in current directory |
+| `**` or `**/*` | All files in all directories |
+| `*.py` | All `.py` files in current directory |
+| `**/*.py` | All `.py` files recursively |
+| `src/**/*.py` | All `.py` files in `src` directory recursively |
+| `**/*.{ts,tsx}` | All `.ts` and `.tsx` files recursively |
+
+Multiple patterns can be combined with commas: `**/*.ts,**/*.tsx,**/*.js`
+
+## License
+
+MIT

package/dist/frontmatter.d.ts

@@ -0,0 +1,14 @@
+export interface Frontmatter {
+    applyTo?: string | string[];
+    excludeAgent?: "code-review" | "coding-agent";
+}
+export interface ParsedContent {
+    frontmatter: Frontmatter;
+    body: string;
+}
+/**
+ * Parses YAML frontmatter from markdown-style content.
+ * Frontmatter must be delimited by --- at the start of the file.
+ */
+export declare function parseFrontmatter(content: string): ParsedContent;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC3B,YAAY,CAAC,EAAE,aAAa,GAAG,cAAc,CAAA;CAC9C;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,WAAW,CAAA;IACxB,IAAI,EAAE,MAAM,CAAA;CACb;AAOD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CA8C/D"}

package/dist/frontmatter.js

@@ -0,0 +1,51 @@
+import * as frontMatter from 'front-matter';
+// Handle both ESM and CommonJS module formats
+const fm = frontMatter.default ?? frontMatter;
+/**
+ * Parses YAML frontmatter from markdown-style content.
+ * Frontmatter must be delimited by --- at the start of the file.
+ */
+export function parseFrontmatter(content) {
+    // Normalize line endings to \n for consistent parsing
+    const normalized = content.replace(/\r\n/g, '\n');
+    // Check if content has frontmatter
+    if (!fm.test(normalized)) {
+        return {
+            frontmatter: {},
+            body: content
+        };
+    }
+    try {
+        const parsed = fm(normalized);
+        const attrs = parsed.attributes;
+        // Extract only known properties with validation
+        const result = {};
+        if (attrs.applyTo !== undefined) {
+            // Accept string or array of strings
+            if (typeof attrs.applyTo === 'string') {
+                result.applyTo = attrs.applyTo;
+            }
+            else if (Array.isArray(attrs.applyTo)) {
+                result.applyTo = attrs.applyTo.filter((item) => typeof item === 'string');
+            }
+        }
+        if (attrs.excludeAgent !== undefined) {
+            const agent = attrs.excludeAgent;
+            if (agent === 'code-review' || agent === 'coding-agent') {
+                result.excludeAgent = agent;
+            }
+        }
+        return {
+            frontmatter: result,
+            body: parsed.body
+        };
+    }
+    catch {
+        // Malformed YAML - return original content as body
+        return {
+            frontmatter: {},
+            body: content
+        };
+    }
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,cAAc,CAAA;AAE3C,8CAA8C;AAC9C,MAAM,EAAE,GAAI,WAAmB,CAAC,OAAO,IAAI,WAAW,CAAA;AAiBtD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,sDAAsD;IACtD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IAEjD,mCAAmC;IACnC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,WAAW,EAAE,EAAE;YACf,IAAI,EAAE,OAAO;SACd,CAAA;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,CAAiD,CAAA;QAC7E,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAA;QAE/B,gDAAgD;QAChD,MAAM,MAAM,GAAgB,EAAE,CAAA;QAE9B,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAChC,oCAAoC;YACpC,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACtC,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;YAChC,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxC,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAa,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAA;YACpG,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAA;YAChC,IAAI,KAAK,KAAK,aAAa,IAAI,KAAK,KAAK,cAAc,EAAE,CAAC;gBACxD,MAAM,CAAC,YAAY,GAAG,KAAK,CAAA;YAC7B,CAAC;QACH,CAAC;QAED,OAAO;YACL,WAAW,EAAE,MAAM;YACnB,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,mDAAmD;QACnD,OAAO;YACL,WAAW,EAAE,EAAE;YACf,IAAI,EAAE,OAAO;SACd,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from '@opencode-ai/plugin';
+export declare const CopilotInstructionsPlugin: Plugin;
+export default CopilotInstructionsPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAwBjD,eAAO,MAAM,yBAAyB,EAAE,MAwGvC,CAAA;AAGD,eAAe,yBAAyB,CAAA"}

package/dist/index.js

@@ -0,0 +1,110 @@
+import * as path from 'node:path';
+import { loadRepoInstructions, loadPathInstructions } from './loader.js';
+/**
+ * Convert an absolute path to a relative path from the given directory.
+ * If the path is already relative, returns it as-is.
+ * Note: This is intentionally NOT exported to avoid OpenCode treating it as a plugin
+ */
+function getRelativePath(directory, filePath) {
+    // Normalize directory path (remove trailing slash)
+    const normalizedDir = directory.endsWith('/') ? directory.slice(0, -1) : directory;
+    // If path is already relative (doesn't start with /), return as-is
+    if (!path.isAbsolute(filePath)) {
+        return filePath;
+    }
+    // Use path.relative to compute relative path
+    return path.relative(normalizedDir, filePath);
+}
+// Tools that work with file paths
+const FILE_TOOLS = new Set(['read', 'edit', 'write']);
+export const CopilotInstructionsPlugin = async (ctx) => {
+    const { directory, client } = ctx;
+    // Validate directory is provided and is a string
+    if (!directory || typeof directory !== 'string') {
+        console.error('[copilot-instructions] Invalid directory:', directory, 'ctx:', Object.keys(ctx));
+        throw new Error(`Plugin requires a valid directory string, got: ${typeof directory}`);
+    }
+    // Store directory in a local const to ensure closure captures it properly
+    const projectDir = directory;
+    // Load instructions at startup
+    const repoInstructions = loadRepoInstructions(projectDir);
+    const pathInstructions = loadPathInstructions(projectDir);
+    // Helper to log messages
+    const log = (message) => {
+        client.app.log({
+            body: {
+                service: 'copilot-instructions',
+                level: 'info',
+                message
+            }
+        });
+    };
+    // Log what was loaded
+    if (repoInstructions) {
+        log('Loaded repo instructions from .github/copilot-instructions.md');
+    }
+    if (pathInstructions.length > 0) {
+        for (const instruction of pathInstructions) {
+            const filename = path.basename(instruction.file);
+            log(`Loaded path instructions from ${filename}`);
+        }
+    }
+    if (!repoInstructions && pathInstructions.length === 0) {
+        log('No Copilot instructions found');
+    }
+    // Track injected instructions per session
+    // Map<sessionID, Set<instructionFile>>
+    const injectedPerSession = new Map();
+    return {
+        'experimental.session.compacting': async (_input, output) => {
+            if (repoInstructions) {
+                output.context.push(`## Copilot Custom Instructions\n\n${repoInstructions}`);
+            }
+        },
+        'tool.execute.before': async (input, output) => {
+            // Only handle file tools
+            if (!FILE_TOOLS.has(input.tool)) {
+                return;
+            }
+            // Get file path from args
+            const filePath = output.args?.filePath;
+            if (!filePath || typeof filePath !== 'string') {
+                return;
+            }
+            // Convert to relative path for matching
+            const relativePath = getRelativePath(projectDir, filePath);
+            // Find matching instructions that haven't been injected yet
+            const sessionInjected = injectedPerSession.get(input.sessionID) ?? new Set();
+            injectedPerSession.set(input.sessionID, sessionInjected);
+            const matchingInstructions = [];
+            for (const instruction of pathInstructions) {
+                // Skip if already injected in this session
+                if (sessionInjected.has(instruction.file)) {
+                    continue;
+                }
+                // Check if file matches this instruction's patterns
+                if (instruction.matcher(relativePath)) {
+                    matchingInstructions.push(instruction);
+                    sessionInjected.add(instruction.file);
+                }
+            }
+            // Inject matching instructions
+            if (matchingInstructions.length > 0) {
+                const instructionText = matchingInstructions
+                    .map(i => i.content)
+                    .join('\n\n');
+                // Prepend to existing toolMessage if any
+                const existingMessage = output.toolMessage;
+                if (existingMessage) {
+                    output.toolMessage = `${instructionText}\n\n${existingMessage}`;
+                }
+                else {
+                    output.toolMessage = instructionText;
+                }
+            }
+        }
+    };
+};
+// Default export for easier loading
+export default CopilotInstructionsPlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/loader.d.ts

@@ -0,0 +1,22 @@
+import { type Matcher } from './matcher.js';
+export interface PathInstruction {
+    file: string;
+    applyTo: string[];
+    content: string;
+    matcher: Matcher;
+}
+/**
+ * Load repository-wide Copilot instructions from .github/copilot-instructions.md
+ *
+ * @param directory - The root directory to search in
+ * @returns The file content as a string if found, null otherwise
+ */
+export declare function loadRepoInstructions(directory: string): string | null;
+/**
+ * Load path-specific Copilot instructions from .github/instructions/*.instructions.md
+ *
+ * @param directory - The root directory to search in
+ * @returns Array of PathInstruction objects for each valid instruction file
+ */
+export declare function loadPathInstructions(directory: string): PathInstruction[];
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoC,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AAE7E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQrE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,EAAE,CA4CzE"}

package/dist/loader.js

@@ -0,0 +1,64 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { parseFrontmatter } from './frontmatter.js';
+import { createMatcher, normalizePatterns } from './matcher.js';
+/**
+ * Load repository-wide Copilot instructions from .github/copilot-instructions.md
+ *
+ * @param directory - The root directory to search in
+ * @returns The file content as a string if found, null otherwise
+ */
+export function loadRepoInstructions(directory) {
+    const filePath = path.join(directory, '.github', 'copilot-instructions.md');
+    try {
+        return fs.readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Load path-specific Copilot instructions from .github/instructions/*.instructions.md
+ *
+ * @param directory - The root directory to search in
+ * @returns Array of PathInstruction objects for each valid instruction file
+ */
+export function loadPathInstructions(directory) {
+    const instructionsDir = path.join(directory, '.github', 'instructions');
+    let files;
+    try {
+        files = fs.readdirSync(instructionsDir);
+    }
+    catch {
+        return [];
+    }
+    const result = [];
+    for (const filename of files) {
+        // Only process *.instructions.md files
+        if (!filename.endsWith('.instructions.md')) {
+            continue;
+        }
+        const filePath = path.join(instructionsDir, filename);
+        let content;
+        try {
+            content = fs.readFileSync(filePath, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const parsed = parseFrontmatter(content);
+        const patterns = normalizePatterns(parsed.frontmatter.applyTo);
+        // Skip files without applyTo patterns
+        if (patterns.length === 0) {
+            continue;
+        }
+        result.push({
+            file: filePath,
+            applyTo: patterns,
+            content: parsed.body,
+            matcher: createMatcher(patterns)
+        });
+    }
+    return result;
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAgB,MAAM,cAAc,CAAA;AAS7E;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,yBAAyB,CAAC,CAAA;IAE3E,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,cAAc,CAAC,CAAA;IAEvE,IAAI,KAAe,CAAA;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,eAAe,CAAC,CAAA;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,MAAM,GAAsB,EAAE,CAAA;IAEpC,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,uCAAuC;QACvC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC3C,SAAQ;QACV,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAA;QAErD,IAAI,OAAe,CAAA;QACnB,IAAI,CAAC;YACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,SAAQ;QACV,CAAC;QAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAA;QACxC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;QAE9D,sCAAsC;QACtC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,SAAQ;QACV,CAAC;QAED,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,MAAM,CAAC,IAAI;YACpB,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC;SACjC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/matcher.d.ts

@@ -0,0 +1,18 @@
+export type Matcher = (path: string) => boolean;
+/**
+ * Creates a matcher function that tests paths against glob patterns.
+ * Returns a function that returns true if the path matches any of the patterns.
+ *
+ * @param patterns - Array of glob patterns to match against
+ * @returns A function that tests if a path matches any pattern
+ */
+export declare function createMatcher(patterns: string[]): Matcher;
+/**
+ * Normalizes the applyTo field from frontmatter into an array of patterns.
+ * Handles undefined, single strings, comma-separated strings, and arrays.
+ *
+ * @param applyTo - The applyTo value from frontmatter
+ * @returns Normalized array of patterns
+ */
+export declare function normalizePatterns(applyTo: string | string[] | undefined): string[];
+//# sourceMappingURL=matcher.d.ts.map

package/dist/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../src/matcher.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;AAE/C;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAOzD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAclF"}

package/dist/matcher.js

@@ -0,0 +1,36 @@
+import picomatch from 'picomatch';
+/**
+ * Creates a matcher function that tests paths against glob patterns.
+ * Returns a function that returns true if the path matches any of the patterns.
+ *
+ * @param patterns - Array of glob patterns to match against
+ * @returns A function that tests if a path matches any pattern
+ */
+export function createMatcher(patterns) {
+    if (patterns.length === 0) {
+        return () => false;
+    }
+    const isMatch = picomatch(patterns);
+    return (path) => isMatch(path);
+}
+/**
+ * Normalizes the applyTo field from frontmatter into an array of patterns.
+ * Handles undefined, single strings, comma-separated strings, and arrays.
+ *
+ * @param applyTo - The applyTo value from frontmatter
+ * @returns Normalized array of patterns
+ */
+export function normalizePatterns(applyTo) {
+    if (applyTo === undefined) {
+        return [];
+    }
+    if (Array.isArray(applyTo)) {
+        return applyTo;
+    }
+    // Handle string input - split by comma and trim whitespace
+    return applyTo
+        .split(',')
+        .map((pattern) => pattern.trim())
+        .filter((pattern) => pattern.length > 0);
+}
+//# sourceMappingURL=matcher.js.map

package/dist/matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.js","sourceRoot":"","sources":["../src/matcher.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,WAAW,CAAA;AAIjC;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,QAAkB;IAC9C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,GAAG,EAAE,CAAC,KAAK,CAAA;IACpB,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;IACnC,OAAO,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;AACxC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAsC;IACtE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAA;IACX,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,2DAA2D;IAC3D,OAAO,OAAO;SACX,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;SAChC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;AAC5C,CAAC"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@ekroon/opencode-copilot-instructions",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "front-matter": "^4.0.2",
+    "picomatch": "^4.0.0"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": "*"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "latest",
+    "@types/node": "^22.0.0",
+    "@types/picomatch": "^3.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^3.0.0"
+  }
+}