@anthara/pi-claude 0.0.0-stage → 0.1.0

package/dist/extensions/instructions/instruction-files.js

@@ -0,0 +1,51 @@
+import { readdirSync } from 'node:fs';
+import { basename, dirname, join, relative, sep } from 'node:path';
+import { isFile, isWithin } from './files.js';
+const MEMORY_FILE_NAME = 'CLAUDE.md';
+const LOCAL_MEMORY_FILE_NAME = 'CLAUDE.local.md';
+const PROJECT_CONFIG_DIRECTORY = '.claude';
+const RULES_DIRECTORY = 'rules';
+const MARKDOWN_SUFFIX = '.md';
+export function instructionFiles({ configDir, cwd, projectFolders }) {
+    const user = [memoryFile(join(configDir, MEMORY_FILE_NAME), 'user', cwd), ...ruleFiles(join(configDir, RULES_DIRECTORY), 'user', cwd)];
+    const project = [...projectFolders].reverse().flatMap(projectFolderFiles);
+    return existing([...user, ...project]);
+}
+export function nestedInstructionFiles(cwd, touchedFile) {
+    const touchedFolder = dirname(touchedFile);
+    if (touchedFolder === cwd || !isWithin(cwd, touchedFolder)) {
+        return [];
+    }
+    const names = relative(cwd, touchedFolder).split(sep);
+    const folders = names.map((_name, index) => join(cwd, ...names.slice(0, index + 1)));
+    return existing(folders.flatMap((folder) => [memoryFile(join(folder, MEMORY_FILE_NAME), 'project', folder), memoryFile(join(folder, LOCAL_MEMORY_FILE_NAME), 'project', folder)]));
+}
+export const memoryTypeOf = ({ origin, path }) => {
+    if (basename(path) === LOCAL_MEMORY_FILE_NAME) {
+        return 'Local';
+    }
+    return origin === 'user' ? 'User' : 'Project';
+};
+function projectFolderFiles(folder) {
+    return [
+        memoryFile(join(folder, MEMORY_FILE_NAME), 'project', folder),
+        memoryFile(join(folder, PROJECT_CONFIG_DIRECTORY, MEMORY_FILE_NAME), 'project', folder),
+        ...ruleFiles(join(folder, PROJECT_CONFIG_DIRECTORY, RULES_DIRECTORY), 'project', folder),
+        memoryFile(join(folder, LOCAL_MEMORY_FILE_NAME), 'project', folder),
+    ];
+}
+const memoryFile = (path, origin, root) => ({ path, origin, kind: 'memory', root });
+const ruleFiles = (directory, origin, root) => markdownFilesUnder(directory).map((path) => ({ path, origin, kind: 'rule', root }));
+const existing = (files) => files.filter(({ path }) => isFile(path));
+function markdownFilesUnder(directory) {
+    try {
+        return readdirSync(directory, { recursive: true, encoding: 'utf8' })
+            .filter((name) => name.endsWith(MARKDOWN_SUFFIX))
+            .map((name) => join(directory, name))
+            .sort((first, second) => first.localeCompare(second));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=instruction-files.js.map

package/dist/extensions/instructions/instruction-files.js.map

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

package/dist/extensions/instructions/instruction-set.d.ts

@@ -0,0 +1,26 @@
+import type { InstructionLoad, InstructionLoadReason } from '../../kernel/instruction-events/instruction-events.js';
+import { type InstructionFile, type InstructionPaths } from './instruction-files.js';
+import { type InstructionBlock } from './instruction-text.js';
+import { type ScopedRule } from './rules.js';
+export interface InstructionRequest {
+    readonly paths: InstructionPaths;
+    readonly home: string;
+    readonly injectedPaths: readonly string[];
+    readonly excludePatterns: readonly string[];
+    readonly externalImports: 'allowed' | 'refused';
+    readonly loadReason: InstructionLoadReason;
+}
+export interface InstructionEntry {
+    readonly block: InstructionBlock;
+    readonly load: InstructionLoad;
+}
+export interface InstructionSet {
+    readonly entries: readonly InstructionEntry[];
+    readonly blocks: readonly InstructionBlock[];
+    readonly loads: readonly InstructionLoad[];
+    readonly notLoaded: readonly string[];
+    readonly importsOutsideProject: readonly string[];
+    readonly scopedRules: readonly ScopedRule[];
+}
+export declare const buildInstructionSet: (request: InstructionRequest) => InstructionSet;
+export declare function loadInstructions(files: readonly InstructionFile[], request: InstructionRequest): InstructionSet;

package/dist/extensions/instructions/instruction-set.js

@@ -0,0 +1,97 @@
+import { isExcluded } from './excludes.js';
+import { readTextOrEmpty, realPathOf } from './files.js';
+import { createImportBudget, expandImports } from './imports.js';
+import { instructionFiles, memoryTypeOf } from './instruction-files.js';
+import { describeInstruction } from './instruction-text.js';
+import { classifyRule } from './rules.js';
+import { stripBlockComments } from './strip-comments.js';
+export const buildInstructionSet = (request) => loadInstructions(instructionFiles(request.paths), request);
+export function loadInstructions(files, request) {
+    const run = new InstructionRun(request);
+    for (const file of files) {
+        run.load(file);
+    }
+    return run.result();
+}
+class InstructionRun {
+    #request;
+    #injected;
+    #projectBoundary;
+    #budget = createImportBudget();
+    #seen = new Set();
+    #notLoaded = new Set();
+    #importsOutsideProject = new Set();
+    #entries = [];
+    #scopedRules = [];
+    constructor(request) {
+        this.#request = request;
+        this.#injected = new Set(request.injectedPaths.map(realPathOf));
+        this.#projectBoundary = request.externalImports === 'allowed' ? 'anywhere' : [request.paths.projectFolders.at(-1) ?? request.paths.cwd, request.paths.cwd].map(realPathOf);
+    }
+    result() {
+        return {
+            entries: this.#entries,
+            blocks: this.#entries.map(({ block }) => block),
+            loads: this.#entries.map(({ load }) => load),
+            notLoaded: [...this.#notLoaded],
+            importsOutsideProject: [...this.#importsOutsideProject],
+            scopedRules: this.#scopedRules,
+        };
+    }
+    load(file) {
+        const real = realPathOf(file.path);
+        if (this.#seen.has(real) || isExcluded(file.path, this.#request.excludePatterns)) {
+            return;
+        }
+        this.#seen.add(real);
+        const text = readTextOrEmpty(file.path);
+        if (file.kind === 'memory') {
+            this.#keep(file, stripBlockComments(text).trim());
+        }
+        else {
+            this.#loadRule(file, text);
+        }
+    }
+    #loadRule(file, text) {
+        const rule = classifyRule({ origin: file.origin, path: file.path, root: file.root, text });
+        if (rule.kind === 'scoped') {
+            this.#scopedRules.push(rule);
+        }
+        else if (rule.kind === 'unscoped') {
+            this.#keep(file, rule.body);
+        }
+    }
+    #keep(file, body) {
+        if (body === '') {
+            return;
+        }
+        if (!this.#injected.has(realPathOf(file.path))) {
+            this.#entries.push({
+                block: { path: file.path, description: describeInstruction(file), content: body },
+                load: { filePath: file.path, memoryType: memoryTypeOf(file), loadReason: this.#request.loadReason },
+            });
+        }
+        this.#keepImports(file, body);
+    }
+    #keepImports(file, body) {
+        const expanded = expandImports({ path: file.path, content: body }, this.#policyFor(file));
+        for (const imported of expanded.imported) {
+            this.#entries.push({
+                block: { path: imported.path, description: `imported by ${imported.parent}`, content: imported.content },
+                load: { filePath: imported.path, memoryType: memoryTypeOf(file), loadReason: 'include', parentFilePath: imported.parent },
+            });
+        }
+        expanded.notLoaded.forEach((target) => this.#notLoaded.add(target));
+        expanded.outsideProject.forEach((target) => this.#importsOutsideProject.add(target));
+    }
+    #policyFor(file) {
+        return {
+            home: this.#request.home,
+            boundary: file.origin === 'user' ? 'anywhere' : this.#projectBoundary,
+            isExcluded: (path) => isExcluded(path, this.#request.excludePatterns),
+            budget: this.#budget,
+            seen: this.#seen,
+        };
+    }
+}
+//# sourceMappingURL=instruction-set.js.map

package/dist/extensions/instructions/instruction-set.js.map

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

package/dist/extensions/instructions/instruction-text.d.ts

@@ -0,0 +1,9 @@
+import { type InstructionFile } from './instruction-files.js';
+export interface InstructionBlock {
+    readonly path: string;
+    readonly description: string;
+    readonly content: string;
+}
+export declare const renderBlock: ({ path, description, content }: InstructionBlock) => string;
+export declare function renderSection(blocks: readonly InstructionBlock[], notLoaded: readonly string[]): string;
+export declare function describeInstruction(file: Pick<InstructionFile, 'origin' | 'kind' | 'path'>): string;

package/dist/extensions/instructions/instruction-text.js

@@ -0,0 +1,20 @@
+import { memoryTypeOf } from './instruction-files.js';
+const INTRODUCTION = 'Codebase and user instructions are shown below. Be sure to adhere to these instructions.';
+const NOT_LOADED_NOTICE = 'These @imports were not loaded: they point outside the project (which is not trusted) or past the import limits:';
+export const renderBlock = ({ path, description, content }) => `Contents of ${path} (${description}):\n\n${content}`;
+export function renderSection(blocks, notLoaded) {
+    const introduction = blocks.length === 0 ? [] : [INTRODUCTION];
+    const notice = notLoaded.length === 0 ? [] : [[NOT_LOADED_NOTICE, ...notLoaded.map((target) => `- ${target}`)].join('\n')];
+    return [...introduction, ...blocks.map(renderBlock), ...notice].join('\n\n');
+}
+export function describeInstruction(file) {
+    const memoryType = memoryTypeOf(file);
+    if (memoryType === 'Local') {
+        return "user's private project instructions, not checked in";
+    }
+    if (file.kind === 'rule') {
+        return memoryType === 'User' ? "user's global rule" : 'project rule';
+    }
+    return memoryType === 'User' ? "user's private global instructions for all projects" : 'project instructions, checked into the codebase';
+}
+//# sourceMappingURL=instruction-text.js.map

package/dist/extensions/instructions/instruction-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruction-text.js","sourceRoot":"","sources":["../../../src/extensions/instructions/instruction-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAwB,MAAM,wBAAwB,CAAC;AAQ5E,MAAM,YAAY,GAAG,0FAA0F,CAAC;AAChH,MAAM,iBAAiB,GAAG,kHAAkH,CAAC;AAE7I,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAoB,EAAU,EAAE,CAAC,eAAe,IAAI,KAAK,WAAW,SAAS,OAAO,EAAE,CAAC;AAE/I,MAAM,UAAU,aAAa,CAAC,MAAmC,EAAE,SAA4B;IAC7F,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3H,OAAO,CAAC,GAAG,YAAY,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAuD;IACzF,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC3B,OAAO,qDAAqD,CAAC;IAC/D,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACzB,OAAO,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,cAAc,CAAC;IACvE,CAAC;IACD,OAAO,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,qDAAqD,CAAC,CAAC,CAAC,iDAAiD,CAAC;AAC3I,CAAC"}

package/dist/extensions/instructions/path-glob.d.ts

@@ -0,0 +1,2 @@
+export declare function compileGlob(pattern: string): (path: string) => boolean;
+export declare function compileRuleGlob(pattern: string): (relativePath: string) => boolean;

package/dist/extensions/instructions/path-glob.js

@@ -0,0 +1,44 @@
+const MAX_BRACE_ALTERNATIVES = 1000;
+const INNERMOST_BRACE_GROUP = /\{([^{},]*(?:,[^{},]*)+)\}/;
+const GLOB_TOKEN = /\*\*\/|\*\*|\*|\?|[^*?]+/g;
+const REGEXP_SPECIALS = /[.+^${}()|[\]\\]/g;
+export function compileGlob(pattern) {
+    const alternatives = expandBraces(pattern, MAX_BRACE_ALTERNATIVES).map(toRegExpSource);
+    const regexp = new RegExp(`^(?:${alternatives.join('|')})$`);
+    return (path) => regexp.test(path);
+}
+export function compileRuleGlob(pattern) {
+    const withoutRootMark = pattern.trim().replace(/^\.?\//, '');
+    return compileGlob(withoutRootMark.endsWith('/') ? `${withoutRootMark}**` : withoutRootMark);
+}
+function expandBraces(pattern, limit) {
+    const group = INNERMOST_BRACE_GROUP.exec(pattern);
+    if (group === null) {
+        return [pattern];
+    }
+    const expanded = [];
+    for (const option of (group[1] ?? '').split(',')) {
+        const choice = pattern.slice(0, group.index) + option + pattern.slice(group.index + group[0].length);
+        expanded.push(...expandBraces(choice, limit - expanded.length));
+        if (expanded.length >= limit) {
+            break;
+        }
+    }
+    return expanded;
+}
+const toRegExpSource = (pattern) => pattern.replace(GLOB_TOKEN, regexpFor);
+function regexpFor(token) {
+    switch (token) {
+        case '**/':
+            return '(?:.*/)?';
+        case '**':
+            return '.*';
+        case '*':
+            return '[^/]*';
+        case '?':
+            return '[^/]';
+        default:
+            return token.replace(REGEXP_SPECIALS, '\\$&');
+    }
+}
+//# sourceMappingURL=path-glob.js.map

package/dist/extensions/instructions/path-glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-glob.js","sourceRoot":"","sources":["../../../src/extensions/instructions/path-glob.ts"],"names":[],"mappings":"AAAA,MAAM,sBAAsB,GAAG,IAAI,CAAC;AACpC,MAAM,qBAAqB,GAAG,4BAA4B,CAAC;AAC3D,MAAM,UAAU,GAAG,2BAA2B,CAAC;AAC/C,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAE5C,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACvF,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC7D,OAAO,WAAW,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,eAAe,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;AAC/F,CAAC;AAED,SAAS,YAAY,CAAC,OAAe,EAAE,KAAa;IAClD,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;IACD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACrG,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAChE,IAAI,QAAQ,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;YAC7B,MAAM;QACR,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,cAAc,GAAG,CAAC,OAAe,EAAU,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AAE3F,SAAS,SAAS,CAAC,KAAa;IAC9B,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,KAAK;YACR,OAAO,UAAU,CAAC;QACpB,KAAK,IAAI;YACP,OAAO,IAAI,CAAC;QACd,KAAK,GAAG;YACN,OAAO,OAAO,CAAC;QACjB,KAAK,GAAG;YACN,OAAO,MAAM,CAAC;QAChB;YACE,OAAO,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;AACH,CAAC"}

package/dist/extensions/instructions/rules.d.ts

@@ -0,0 +1,25 @@
+import type { InstructionOrigin } from './instruction-files.js';
+export interface RuleFile {
+    readonly origin: InstructionOrigin;
+    readonly path: string;
+    readonly root: string;
+    readonly text: string;
+}
+export interface UnscopedRule {
+    readonly kind: 'unscoped';
+    readonly path: string;
+    readonly body: string;
+}
+export interface ScopedRule {
+    readonly kind: 'scoped';
+    readonly origin: InstructionOrigin;
+    readonly path: string;
+    readonly root: string;
+    readonly globs: readonly string[];
+    readonly body: string;
+}
+export interface EmptyRule {
+    readonly kind: 'empty';
+}
+export type ClassifiedRule = UnscopedRule | ScopedRule | EmptyRule;
+export declare function classifyRule(file: RuleFile): ClassifiedRule;

package/dist/extensions/instructions/rules.js

@@ -0,0 +1,43 @@
+import { listField } from '../../kernel/frontmatter/frontmatter-fields.js';
+import { readFrontmatter } from '../../kernel/frontmatter/read-frontmatter.js';
+import { stripBlockComments } from './strip-comments.js';
+const EMPTY_RULE = { kind: 'empty' };
+const PATHS_FIELD = 'paths';
+const BRACE_DEPTH_CHANGES = { '{': 1, '}': -1 };
+export function classifyRule(file) {
+    const { fields, body } = partsOf(file.text);
+    const text = stripBlockComments(body).trim();
+    if (text === '') {
+        return EMPTY_RULE;
+    }
+    const globs = globsOf(fields);
+    return globs.length === 0
+        ? { kind: 'unscoped', path: file.path, body: text }
+        : { kind: 'scoped', origin: file.origin, path: file.path, root: file.root, globs, body: text };
+}
+function partsOf(text) {
+    const read = readFrontmatter(text);
+    return read.kind === 'unreadable' ? { fields: {}, body: text } : read;
+}
+function globsOf(fields) {
+    const declared = fields[PATHS_FIELD];
+    const entries = typeof declared === 'string' ? splitOutsideBraces(declared) : listField(fields, PATHS_FIELD);
+    return entries.map((entry) => entry.trim().replace(/^["']|["']$/g, '')).filter((entry) => entry !== '');
+}
+function splitOutsideBraces(text) {
+    const entries = [];
+    let depth = 0;
+    let current = '';
+    for (const char of text) {
+        depth = Math.max(0, depth + (BRACE_DEPTH_CHANGES[char] ?? 0));
+        if (char === ',' && depth === 0) {
+            entries.push(current);
+            current = '';
+        }
+        else {
+            current += char;
+        }
+    }
+    return [...entries, current];
+}
+//# sourceMappingURL=rules.js.map

package/dist/extensions/instructions/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../../src/extensions/instructions/rules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA0B,MAAM,gDAAgD,CAAC;AACnG,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AA8BzD,MAAM,UAAU,GAAc,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAChD,MAAM,WAAW,GAAG,OAAO,CAAC;AAC5B,MAAM,mBAAmB,GAAqC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;AAElF,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QAChB,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;QACvB,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;QACnD,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACnG,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACxE,CAAC;AAED,SAAS,OAAO,CAAC,MAAyB;IACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC7G,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;AAC1G,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9D,IAAI,IAAI,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,IAAI,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,OAAO,EAAE,OAAO,CAAC,CAAC;AAC/B,CAAC"}

package/dist/extensions/instructions/session-instructions.d.ts

@@ -0,0 +1,13 @@
+import type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';
+import { AttachmentLedger } from './attachments.js';
+export interface ContextFile {
+    path: string;
+    content: string;
+}
+export interface SessionInstructions {
+    readonly section: string;
+    readonly excludePatterns: readonly string[];
+    readonly ledger: AttachmentLedger;
+}
+export declare function openSessionInstructions(pi: ExtensionAPI, ctx: ExtensionContext, contextFiles: readonly ContextFile[]): Promise<SessionInstructions>;
+export declare function tidyContextFiles(contextFiles: ContextFile[], excludePatterns: readonly string[]): void;

package/dist/extensions/instructions/session-instructions.js

@@ -0,0 +1,49 @@
+import { homedir } from 'node:os';
+import { claudeConfigDir } from '../../kernel/claude-home/config-dir.js';
+import { projectFolders } from '../../kernel/claude-home/project-folders.js';
+import { projectSettingsFiles } from '../../kernel/claude-home/project-settings.js';
+import { userSettingsPath } from '../../kernel/claude-home/user-settings.js';
+import { announceInstructionLoad } from '../../kernel/instruction-events/instruction-events.js';
+import { savedTrustDecisionFor, trustDecisionFor } from '../../kernel/project-trust/project-trust.js';
+import { AttachmentLedger, combineSources, nestedInstructionSource, scopedRuleSource } from './attachments.js';
+import { isExcluded, readClaudeMdExcludes } from './excludes.js';
+import { buildInstructionSet } from './instruction-set.js';
+import { renderSection } from './instruction-text.js';
+import { stripBlockComments } from './strip-comments.js';
+export async function openSessionInstructions(pi, ctx, contextFiles) {
+    const home = homedir();
+    const configDir = claudeConfigDir(process.env, home);
+    const folders = projectFolders(ctx.cwd, home);
+    const excludePatterns = readClaudeMdExcludes([userSettingsPath(configDir), ...projectSettingsFiles(folders)]);
+    const { set, request } = await decidedInstructions(ctx, {
+        paths: { configDir, cwd: ctx.cwd, projectFolders: folders },
+        home,
+        injectedPaths: contextFiles.map(({ path }) => path),
+        excludePatterns,
+        externalImports: 'refused',
+        loadReason: 'session_start',
+    });
+    set.loads.forEach((load) => {
+        announceInstructionLoad(pi.events, load);
+    });
+    const ledger = new AttachmentLedger(combineSources(scopedRuleSource(set.scopedRules), nestedInstructionSource(ctx.cwd, request)));
+    return { section: renderSection(set.blocks, set.notLoaded), excludePatterns, ledger };
+}
+async function decidedInstructions(ctx, refusing) {
+    const refused = buildInstructionSet(refusing);
+    const reachesOutside = refused.importsOutsideProject.length > 0;
+    // a CLAUDE.md attached later on a read never asks, so it follows a decision already made
+    const trust = reachesOutside ? await trustDecisionFor(ctx) : savedTrustDecisionFor(ctx);
+    if (trust === 'untrusted') {
+        return { set: refused, request: refusing };
+    }
+    const allowing = { ...refusing, externalImports: 'allowed' };
+    return { set: reachesOutside ? buildInstructionSet(allowing) : refused, request: allowing };
+}
+export function tidyContextFiles(contextFiles, excludePatterns) {
+    const kept = contextFiles
+        .filter(({ path }) => !isExcluded(path, excludePatterns))
+        .map(({ path, content }) => ({ path, content: stripBlockComments(content) }));
+    contextFiles.splice(0, contextFiles.length, ...kept);
+}
+//# sourceMappingURL=session-instructions.js.map

package/dist/extensions/instructions/session-instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-instructions.js","sourceRoot":"","sources":["../../../src/extensions/instructions/session-instructions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,uDAAuD,CAAC;AAChG,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AACtG,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC/G,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAgD,MAAM,sBAAsB,CAAC;AACzG,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAazD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,EAAgB,EAAE,GAAqB,EAAE,YAAoC;IACzH,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,MAAM,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC9C,MAAM,eAAe,GAAG,oBAAoB,CAAC,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9G,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,MAAM,mBAAmB,CAAC,GAAG,EAAE;QACtD,KAAK,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE;QAC3D,IAAI;QACJ,aAAa,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC;QACnD,eAAe;QACf,eAAe,EAAE,SAAS;QAC1B,UAAU,EAAE,eAAe;KAC5B,CAAC,CAAC;IACH,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACzB,uBAAuB,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,cAAc,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,uBAAuB,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAClI,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC;AACxF,CAAC;AAOD,KAAK,UAAU,mBAAmB,CAAC,GAAqB,EAAE,QAA4B;IACpF,MAAM,OAAO,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,cAAc,GAAG,OAAO,CAAC,qBAAqB,CAAC,MAAM,GAAG,CAAC,CAAC;IAChE,yFAAyF;IACzF,MAAM,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACxF,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;QAC1B,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC7C,CAAC;IACD,MAAM,QAAQ,GAAuB,EAAE,GAAG,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC;IACjF,OAAO,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,YAA2B,EAAE,eAAkC;IAC9F,MAAM,IAAI,GAAG,YAAY;SACtB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;SACxD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IAChF,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;AACvD,CAAC"}

package/dist/extensions/instructions/strip-comments.d.ts

@@ -0,0 +1,6 @@
+export interface ScannedLine {
+    readonly text: string;
+    readonly fenced: boolean;
+}
+export declare function scanFences(text: string): ScannedLine[];
+export declare function stripBlockComments(text: string): string;

package/dist/extensions/instructions/strip-comments.js

@@ -0,0 +1,58 @@
+const FENCE_RUN = /^(`{3,}|~{3,})/;
+const COMMENT_OPENING = '<!--';
+const COMMENT_CLOSING = '-->';
+export function scanFences(text) {
+    let open;
+    return text.split('\n').map((line) => {
+        const step = stepFence(open, line.trimStart());
+        open = step.open;
+        return { text: line, fenced: step.fenced };
+    });
+}
+function stepFence(open, trimmed) {
+    const run = FENCE_RUN.exec(trimmed)?.[1];
+    return open === undefined ? openingStep(run) : continuingStep(open, run);
+}
+const openingStep = (run) => run === undefined ? { open: undefined, fenced: false } : { open: { marker: run.charAt(0), length: run.length }, fenced: true };
+function continuingStep(open, run) {
+    const closes = run !== undefined && run.charAt(0) === open.marker && run.length >= open.length;
+    return { open: closes ? undefined : open, fenced: true };
+}
+export function stripBlockComments(text) {
+    let insideComment = false;
+    return scanFences(text)
+        .flatMap((line) => {
+        const outcome = outcomeOf(line, insideComment);
+        insideComment = outcome.insideComment;
+        return outcome.emitted;
+    })
+        .join('\n');
+}
+function outcomeOf(line, insideComment) {
+    if (insideComment) {
+        return continuedComment(line.text);
+    }
+    return line.fenced ? { insideComment: false, emitted: [line.text] } : startedLine(line.text);
+}
+function continuedComment(text) {
+    const closing = text.indexOf(COMMENT_CLOSING);
+    if (closing === -1) {
+        return { insideComment: true, emitted: [] };
+    }
+    const rest = text.slice(closing + COMMENT_CLOSING.length);
+    return { insideComment: false, emitted: rest.trim() === '' ? [] : [rest.trimStart()] };
+}
+function startedLine(text) {
+    let rest = text.trimStart();
+    let sawComment = false;
+    while (rest.startsWith(COMMENT_OPENING)) {
+        sawComment = true;
+        const closing = rest.indexOf(COMMENT_CLOSING);
+        if (closing === -1) {
+            return { insideComment: true, emitted: [] };
+        }
+        rest = rest.slice(closing + COMMENT_CLOSING.length).trimStart();
+    }
+    return { insideComment: false, emitted: sawComment && rest === '' ? [] : [text] };
+}
+//# sourceMappingURL=strip-comments.js.map

package/dist/extensions/instructions/strip-comments.js.map

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

package/dist/extensions/instructions/touched-file.d.ts

@@ -0,0 +1,6 @@
+export interface FileToolResult {
+    readonly toolName: string;
+    readonly input: unknown;
+    readonly isError: boolean;
+}
+export declare function touchedFiles(result: FileToolResult, cwd: string): readonly string[];

package/dist/extensions/instructions/touched-file.js

@@ -0,0 +1,31 @@
+// Portions adapted from pi-code (MIT, github.com/ilovepixelart/pi-code), extensions/internal/tool-target.ts.
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const FILE_TOOLS = new Set(['read', 'edit', 'write']);
+const UNICODE_SPACES = /\p{Zs}/gu;
+const FILE_URL_PREFIX = 'file://';
+export function touchedFiles(result, cwd) {
+    if (result.isError || !FILE_TOOLS.has(result.toolName)) {
+        return [];
+    }
+    const named = pathNamedBy(result.input);
+    return named === '' ? [] : [resolve(cwd, asPiReadsIt(named))];
+}
+function pathNamedBy(input) {
+    if (typeof input !== 'object' || input === null) {
+        return '';
+    }
+    const { path, file_path: filePath } = input;
+    const named = typeof path === 'string' ? path : filePath;
+    return typeof named === 'string' ? named : '';
+}
+function asPiReadsIt(target) {
+    const folded = target.replace(UNICODE_SPACES, ' ');
+    const bare = folded.startsWith('@') ? folded.slice(1) : folded;
+    if (bare.startsWith('~/')) {
+        return join(homedir(), bare.slice(2));
+    }
+    return bare.startsWith(FILE_URL_PREFIX) ? fileURLToPath(bare) : bare;
+}
+//# sourceMappingURL=touched-file.js.map

package/dist/extensions/instructions/touched-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"touched-file.js","sourceRoot":"","sources":["../../../src/extensions/instructions/touched-file.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAC7G,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAQzC,MAAM,UAAU,GAAwB,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAC3E,MAAM,cAAc,GAAG,UAAU,CAAC;AAClC,MAAM,eAAe,GAAG,SAAS,CAAC;AAElC,MAAM,UAAU,YAAY,CAAC,MAAsB,EAAE,GAAW;IAC9D,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAgD,CAAC;IACvF,MAAM,KAAK,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;IACzD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAChD,CAAC;AAED,SAAS,WAAW,CAAC,MAAc;IACjC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/D,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvE,CAAC"}

package/dist/extensions/mcp/claude-config/call-timeout.d.ts

@@ -0,0 +1,2 @@
+import type { JsonObject } from '../../../kernel/private-files/private-files.js';
+export declare function callTimeoutSeconds(config: JsonObject, environment: NodeJS.ProcessEnv): number;

package/dist/extensions/mcp/claude-config/call-timeout.js

@@ -0,0 +1,14 @@
+const MILLISECONDS_PER_SECOND = 1000;
+const MAX_TIMER_MILLISECONDS = 2_147_483_647;
+const MAX_TIMER_SECONDS = Math.floor(MAX_TIMER_MILLISECONDS / MILLISECONDS_PER_SECOND);
+const REMOTE_IDLE_SECONDS = 300;
+const STDIO_IDLE_SECONDS = 1800;
+export function callTimeoutSeconds(config, environment) {
+    const declared = declaredMilliseconds(config.timeout) ?? declaredMilliseconds(Number(environment.MCP_TOOL_TIMEOUT));
+    if (declared === undefined) {
+        return typeof config.url === 'string' ? REMOTE_IDLE_SECONDS : STDIO_IDLE_SECONDS;
+    }
+    return Math.min(Math.ceil(declared / MILLISECONDS_PER_SECOND), MAX_TIMER_SECONDS);
+}
+const declaredMilliseconds = (value) => typeof value === 'number' && Number.isFinite(value) && value >= MILLISECONDS_PER_SECOND ? value : undefined;
+//# sourceMappingURL=call-timeout.js.map

package/dist/extensions/mcp/claude-config/call-timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-timeout.js","sourceRoot":"","sources":["../../../../src/extensions/mcp/claude-config/call-timeout.ts"],"names":[],"mappings":"AAEA,MAAM,uBAAuB,GAAG,IAAI,CAAC;AACrC,MAAM,sBAAsB,GAAG,aAAa,CAAC;AAC7C,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,sBAAsB,GAAG,uBAAuB,CAAC,CAAC;AACvF,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAChC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC,MAAM,UAAU,kBAAkB,CAAC,MAAkB,EAAE,WAA8B;IACnF,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,CAAC,MAAM,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACpH,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,kBAAkB,CAAC;IACnF,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,uBAAuB,CAAC,EAAE,iBAAiB,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAsB,EAAE,CAClE,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,uBAAuB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC"}

package/dist/extensions/mcp/claude-config/claude-mcp-server.d.ts

@@ -0,0 +1,13 @@
+import type { CatalogPlugin } from '../../../kernel/plugin-catalog/plugin-catalog.js';
+import type { JsonObject } from '../../../kernel/private-files/private-files.js';
+export type ServerScope = {
+    readonly kind: 'plugin';
+    readonly plugin: CatalogPlugin;
+} | {
+    readonly kind: 'project';
+};
+export interface ClaudeMcpServer {
+    readonly scope: ServerScope;
+    readonly name: string;
+    readonly config: JsonObject;
+}

package/dist/extensions/mcp/claude-config/claude-mcp-server.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=claude-mcp-server.js.map

package/dist/extensions/mcp/claude-config/claude-mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-mcp-server.js","sourceRoot":"","sources":["../../../../src/extensions/mcp/claude-config/claude-mcp-server.ts"],"names":[],"mappings":""}

package/dist/extensions/mcp/claude-config/expand-variables.d.ts

@@ -0,0 +1,2 @@
+import { type Variables } from './variable-references.js';
+export declare function expandVariables(text: string, variables: Variables): string;

package/dist/extensions/mcp/claude-config/expand-variables.js

@@ -0,0 +1,8 @@
+import { valueOf, variableReferences } from './variable-references.js';
+export function expandVariables(text, variables) {
+    return text.replace(variableReferences(), (reference, name, hasDefault, fallback) => {
+        const value = valueOf(variables, name);
+        return hasDefault === undefined ? (value ?? reference) : value || (fallback ?? '');
+    });
+}
+//# sourceMappingURL=expand-variables.js.map

package/dist/extensions/mcp/claude-config/expand-variables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand-variables.js","sourceRoot":"","sources":["../../../../src/extensions/mcp/claude-config/expand-variables.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAkB,MAAM,0BAA0B,CAAC;AAEvF,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,SAAoB;IAChE,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,SAAS,EAAE,IAAY,EAAE,UAA8B,EAAE,QAA4B,EAAE,EAAE;QAClI,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACvC,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/extensions/mcp/claude-config/exposure.d.ts

@@ -0,0 +1,2 @@
+import type { ClaudeMcpServer } from './claude-mcp-server.js';
+export declare function exposureFor({ config }: ClaudeMcpServer, environment: NodeJS.ProcessEnv): 'direct' | 'deferred';