can1357
b8e82008e3
- Added `toExtensionId()` method to all capability types for granular extension identification and disabling. - Added `disabledExtensions` and `includeDisabled` options to LoadOptions for filtering disabled capabilities by extension ID. - Added plugin manifest support for `extensions` entry points with automatic discovery from installed plugins. - Fixed skill loading to properly respect disabled skill names from custom directories. - Improved cross-platform path handling by using `path.basename()` instead of string splitting in context file and state manager. - Refactored capability index loading to validate source metadata and filter disabled extensions before processing.
45 lines
1.7 KiB
TypeScript
45 lines
1.7 KiB
TypeScript
/**
|
|
* Context Files Capability
|
|
*
|
|
* System instruction files (CLAUDE.md, AGENTS.md, GEMINI.md, etc.) that provide
|
|
* persistent guidance to the agent.
|
|
*/
|
|
import * as path from "node:path";
|
|
import { defineCapability } from ".";
|
|
import type { SourceMeta } from "./types";
|
|
|
|
/**
|
|
* A context file that provides persistent instructions to the agent.
|
|
*/
|
|
export interface ContextFile {
|
|
/** Absolute path to the file */
|
|
path: string;
|
|
/** File content */
|
|
content: string;
|
|
/** Which level this came from */
|
|
level: "user" | "project";
|
|
/** Distance from cwd (0 = in cwd, 1 = parent, etc.) for project files */
|
|
depth?: number;
|
|
/** Source metadata */
|
|
_source: SourceMeta;
|
|
}
|
|
|
|
export const contextFileCapability = defineCapability<ContextFile>({
|
|
id: "context-files",
|
|
displayName: "Context Files",
|
|
description: "Persistent instruction files (CLAUDE.md, AGENTS.md, etc.) that guide agent behavior",
|
|
// Deduplicate by scope: one user-level file, and one project-level file per directory depth.
|
|
// Within each depth level, higher-priority providers shadow lower-priority ones.
|
|
// This supports monorepo hierarchies where AGENTS.md exists at multiple ancestor levels.
|
|
// Clamp depth >= 0: files inside config subdirectories of an ancestor (e.g. .claude/, .github/)
|
|
// are same-scope as the ancestor itself.
|
|
key: file => (file.level === "user" ? "user" : `project:${Math.max(0, file.depth ?? 0)}`),
|
|
toExtensionId: file => `context-file:${file.level}:${path.basename(file.path)}`,
|
|
validate: file => {
|
|
if (!file.path) return "Missing path";
|
|
if (file.content === undefined) return "Missing content";
|
|
if (file.level !== "user" && file.level !== "project") return "Invalid level: must be 'user' or 'project'";
|
|
return undefined;
|
|
},
|
|
});
|