@compilr-dev/sdk 0.12.0 → 0.14.0

package/dist/host/index.d.ts

@@ -11,3 +11,5 @@ export { ensureFreshToken } from './token.js';
 export type { EnsureFreshTokenOptions, FreshToken } from './token.js';
 export { runDeviceFlow, nextPollInterval } from './device-flow.js';
 export type { DeviceFlowStatus, DeviceFlowCallbacks, LoginResult, RunDeviceFlowOptions, } from './device-flow.js';
+export { loadProjectContextFiles, hasProjectContextFile, PROJECT_CONTEXT_FILES, } from './project-context.js';
+export type { ProjectContextResult, LoadProjectContextOptions } from './project-context.js';

package/dist/host/index.js

@@ -8,3 +8,5 @@ export { refreshToken, sendHeartbeat, getProfile, updateProfile, requestDeviceCo
 export { loadAuthData, saveAuthData, clearAuthData, updateSession, hasAuthData, checkAuthFilePermissions, readAuthFile, writeAuthFile, } from './auth-store.js';
 export { ensureFreshToken } from './token.js';
 export { runDeviceFlow, nextPollInterval } from './device-flow.js';
+// ── Project context files (COMPILR.md / CLAUDE.md → system prompt) ────────────
+export { loadProjectContextFiles, hasProjectContextFile, PROJECT_CONTEXT_FILES, } from './project-context.js';

package/dist/host/project-context.d.ts

@@ -0,0 +1,43 @@
+/**
+ * loadProjectContextFiles — read a project's instruction file (COMPILR.md etc.)
+ * for injection into the system prompt.
+ *
+ * Shared by CLI and Desktop: the CLI had this logic in utils/project-memory.ts
+ * and Desktop hand-rolled a thinner inline 2-file version. This is the single
+ * implementation — searches a priority-ordered list, size-guards/truncates large
+ * files, and reports metadata.
+ *
+ * Pure file read; no fs writes, no electron. `estimatedTokens` is a cheap
+ * chars/4 heuristic (callers that need a real count tokenize themselves).
+ */
+/** Instruction files searched, in priority order. */
+export declare const PROJECT_CONTEXT_FILES: readonly ["COMPILR.md", ".compilr/instructions.md", "CLAUDE.md", ".claude/instructions.md"];
+export interface ProjectContextResult {
+    /** Whether an instruction file was found. */
+    found: boolean;
+    /** Loaded content (possibly truncated); '' when not found. */
+    content: string;
+    /** Path of the file that was loaded, or null. */
+    filePath: string | null;
+    /** Original file size in bytes. */
+    originalSize: number;
+    /** Whether the content was truncated due to size. */
+    truncated: boolean;
+    /** Rough token estimate (chars / 4). */
+    estimatedTokens: number;
+}
+export interface LoadProjectContextOptions {
+    /** Directory to search (default: process.cwd()). */
+    cwd?: string;
+    /** Max content bytes before truncation (default: 100KB). */
+    maxSize?: number;
+    /** Override the filenames searched, in priority order. */
+    files?: readonly string[];
+}
+/**
+ * Load the first matching project instruction file from `cwd`. Returns a
+ * not-found result (never throws) if none exists or all are unreadable.
+ */
+export declare function loadProjectContextFiles(options?: LoadProjectContextOptions): ProjectContextResult;
+/** Quick existence check (no read) for any project instruction file. */
+export declare function hasProjectContextFile(cwd?: string): boolean;

package/dist/host/project-context.js

@@ -0,0 +1,76 @@
+/**
+ * loadProjectContextFiles — read a project's instruction file (COMPILR.md etc.)
+ * for injection into the system prompt.
+ *
+ * Shared by CLI and Desktop: the CLI had this logic in utils/project-memory.ts
+ * and Desktop hand-rolled a thinner inline 2-file version. This is the single
+ * implementation — searches a priority-ordered list, size-guards/truncates large
+ * files, and reports metadata.
+ *
+ * Pure file read; no fs writes, no electron. `estimatedTokens` is a cheap
+ * chars/4 heuristic (callers that need a real count tokenize themselves).
+ */
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+/** Instruction files searched, in priority order. */
+export const PROJECT_CONTEXT_FILES = [
+    'COMPILR.md',
+    '.compilr/instructions.md',
+    'CLAUDE.md',
+    '.claude/instructions.md',
+];
+/** Default max content size before truncation: 100KB. */
+const DEFAULT_MAX_SIZE = 100 * 1024;
+/**
+ * Load the first matching project instruction file from `cwd`. Returns a
+ * not-found result (never throws) if none exists or all are unreadable.
+ */
+export function loadProjectContextFiles(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const maxSize = options.maxSize ?? DEFAULT_MAX_SIZE;
+    const files = options.files ?? PROJECT_CONTEXT_FILES;
+    for (const filename of files) {
+        const filePath = join(cwd, filename);
+        if (!existsSync(filePath))
+            continue;
+        try {
+            const originalSize = statSync(filePath).size;
+            let content = readFileSync(filePath, 'utf-8');
+            let truncated = false;
+            if (content.length > maxSize) {
+                content = content.slice(0, maxSize);
+                // Prefer a line boundary if one is reasonably close to the cut.
+                const lastNewline = content.lastIndexOf('\n');
+                if (lastNewline > maxSize * 0.8) {
+                    content = content.slice(0, lastNewline);
+                }
+                content += '\n\n[... truncated due to size ...]';
+                truncated = true;
+            }
+            return {
+                found: true,
+                content,
+                filePath,
+                originalSize,
+                truncated,
+                estimatedTokens: Math.ceil(content.length / 4),
+            };
+        }
+        catch {
+            // Exists but unreadable — try the next candidate.
+            continue;
+        }
+    }
+    return {
+        found: false,
+        content: '',
+        filePath: null,
+        originalSize: 0,
+        truncated: false,
+        estimatedTokens: 0,
+    };
+}
+/** Quick existence check (no read) for any project instruction file. */
+export function hasProjectContextFile(cwd = process.cwd()) {
+    return PROJECT_CONTEXT_FILES.some((f) => existsSync(join(cwd, f)));
+}

package/dist/index.d.ts

@@ -83,8 +83,8 @@ export { DEFAULT_PERMISSION_RULES, WRITE_TOOLS, findMatchingRule, permissionMode
 export type { PermissionRule, PermissionMode, PermissionLevel } from './permissions.js';
 export { SHARED_DEFAULTS, migrateRawSettings } from './host/index.js';
 export type { HostSettings, SettingsProviderType, TextSize, NotificationMode, Verbosity, CompactMode, ProjectSessionMode, MascotSetting, StartupMode, ProjectStartupMode, StartupBehavior, DefaultLeftPanel, TipsProficiency, } from './host/index.js';
-export { refreshToken, sendHeartbeat, getProfile, updateProfile, requestDeviceCode, pollDeviceToken, getAuthorizationUrl, loadAuthData, saveAuthData, clearAuthData, updateSession, hasAuthData, checkAuthFilePermissions, readAuthFile, writeAuthFile, ensureFreshToken, runDeviceFlow, nextPollInterval, } from './host/index.js';
-export type { AccountType, AuthUser, AuthSession, AuthData, RefreshTokenResponse, ProfileData, HeartbeatData, DeviceCodeResponse, DeviceTokenResponse, DeviceTokenError, AuthEndpoints, EnsureFreshTokenOptions, FreshToken, DeviceFlowStatus, DeviceFlowCallbacks, LoginResult, RunDeviceFlowOptions, } from './host/index.js';
+export { refreshToken, sendHeartbeat, getProfile, updateProfile, requestDeviceCode, pollDeviceToken, getAuthorizationUrl, loadAuthData, saveAuthData, clearAuthData, updateSession, hasAuthData, checkAuthFilePermissions, readAuthFile, writeAuthFile, ensureFreshToken, runDeviceFlow, nextPollInterval, loadProjectContextFiles, hasProjectContextFile, PROJECT_CONTEXT_FILES, } from './host/index.js';
+export type { AccountType, AuthUser, AuthSession, AuthData, RefreshTokenResponse, ProfileData, HeartbeatData, DeviceCodeResponse, DeviceTokenResponse, DeviceTokenError, AuthEndpoints, EnsureFreshTokenOptions, FreshToken, DeviceFlowStatus, DeviceFlowCallbacks, LoginResult, RunDeviceFlowOptions, ProjectContextResult, LoadProjectContextOptions, } from './host/index.js';
 export { DEFAULT_DELEGATION_CONFIG } from './delegation.js';
 export { FileEpisodeStore, EpisodeRecorder, isSignificantWork, extractAffectedFiles, extractLinesChanged, queryWorkAtRisk, buildWorkSummaryContent, updateWorkSummaryAnchor, } from './episodes/index.js';
 export type { FileEpisodeStoreOptions, EpisodeRecorderConfig, WorkSummaryAnchorConfig, PendingToolSignal, EpisodeFile, } from './episodes/index.js';

package/dist/index.js

@@ -202,7 +202,7 @@ export { DEFAULT_PERMISSION_RULES, WRITE_TOOLS, findMatchingRule, permissionMode
 // =============================================================================
 export { SHARED_DEFAULTS, migrateRawSettings } from './host/index.js';
 // Auth: shared backend client, credential store, token refresh, device flow.
-export { refreshToken, sendHeartbeat, getProfile, updateProfile, requestDeviceCode, pollDeviceToken, getAuthorizationUrl, loadAuthData, saveAuthData, clearAuthData, updateSession, hasAuthData, checkAuthFilePermissions, readAuthFile, writeAuthFile, ensureFreshToken, runDeviceFlow, nextPollInterval, } from './host/index.js';
+export { refreshToken, sendHeartbeat, getProfile, updateProfile, requestDeviceCode, pollDeviceToken, getAuthorizationUrl, loadAuthData, saveAuthData, clearAuthData, updateSession, hasAuthData, checkAuthFilePermissions, readAuthFile, writeAuthFile, ensureFreshToken, runDeviceFlow, nextPollInterval, loadProjectContextFiles, hasProjectContextFile, PROJECT_CONTEXT_FILES, } from './host/index.js';
 // =============================================================================
 // Shared Delegation Config Defaults
 // =============================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",
@@ -64,7 +64,7 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
-    "@compilr-dev/agents": "^0.5.9",
+    "@compilr-dev/agents": "^0.6.0",
     "@compilr-dev/logger": "^0.1.0",
     "ajv": "^6.14.0",
     "yaml": "^2.8.4"