@ikarmic/forge-core 4.4.0 → 5.0.0

package/dist/index.js

@@ -1,4 +1,10 @@
 export { Agent, applySandbox } from './agent/agent.js';
+export { LoopGuard } from './agent/loop-guard.js';
+export { enhancePrompt } from './agent/enhance-prompt.js';
+export { stripThinkTags } from './agent/think-tags.js';
+export { createGitHubCreateTool, createGitHubReadTool, createGitHubTools, githubFromEnv, parseRemote, } from './github/github-tools.js';
+export { createWebSearchTool, searchWeb, WEB_SEARCH_PROVIDERS, webSearchFromEnv, webSearchProblem, } from './tools/web-search.js';
+export { attachmentKind, attachmentBytes, attachmentParts, attachmentProblem, describeAttachment, detectMediaType, loadAttachment, makeAttachment, mediaPartTokens, MAX_ATTACHMENT_BYTES, MAX_IMAGE_ATTACHMENT_BYTES, } from './attachments.js';
 export { CREDENTIAL_SERVICE_NAME, credentialAccountKey } from './credentials/index.js';
 export { loadToolSandboxConfig, saveToolSandboxConfig } from './tools/sandbox-loader.js';
 export { validateToolSandboxConfig } from './hooks/config.js';
@@ -10,13 +16,17 @@ export { expandModelAlias, formatAliasTable, resolveModelAlias, splitModelRef }
 export { ARCHITECT_PROMPT, CONTINUE_PROMPT, DEFAULT_SYSTEM_PROMPT } from './agent/prompts.js';
 export { architectPhaseConfig, editorLimits, editorPhaseConfig, editorTask, isUsableArchitectPlan, runArchitect } from './agent/architect.js';
 export { lookupPricing, computeCostUsd, formatCost, costFor, knownModelIds, } from './pricing.js';
-export { buildMemoryBlock, composeSectionUpdate, findProjectMemoryRoot, globalMemoryPath, injectMemory, loadMemory, parseMemory, projectMemoryPath, readMemoryFile, trimToBytes, writeMemoryFile, DEFAULT_INJECTION_BUDGET, DEFAULT_MAX_BYTES, GLOBAL_MEMORY_DIR, GLOBAL_MEMORY_FILE, PROJECT_MEMORY_DIR, PROJECT_MEMORY_FILE, } from './memory/memory-store.js';
+export { buildMemoryBlock, composeSectionUpdate, findProjectMemoryRoot, globalMemoryPath, injectMemory, loadMemory, normalizeHeading, parseMemory, projectMemoryPath, readMemoryFile, trimToBytes, capMemory, removeSection, writeMemoryFile, DEFAULT_INJECTION_BUDGET, DEFAULT_MAX_BYTES, GLOBAL_MEMORY_DIR, GLOBAL_MEMORY_FILE, PROJECT_MEMORY_DIR, PROJECT_MEMORY_FILE, } from './memory/memory-store.js';
+export { scoreSections, tokenize } from './memory/rank.js';
+export { checkStale, staleKey } from './memory/stale.js';
+export { MAX_BODY_CHARS } from './tools/memory.js';
 export { buildLlmSummarizer, compactMessages, estimateMessageTokens, estimateTokens, getModelWindowTokens, shouldCompact, } from './context/compaction.js';
 export { defaultModelFor, detectProvider, envVarForProvider, fastDefaultFor, hasProviderKey, readModelConfigFromEnv, resolveApiKey, SUPPORTED_PROVIDERS, } from './config.js';
 export { loadMcpConfig, parseMcpConfig, connectAll, connectOne, closeAll, mcpResultToValue, jsonSchemaToZod, } from './mcp/index.js';
 export { createLanguageModel, formatModelId, pickAvailableProvider, resolveModelFromEnv, resolveModelFromEnvAsync } from './providers.js';
-export { defaultSessionDir, generateSessionId, saveSession, loadSession, deleteSession, listSessions, findLatestSession, formatSessionMarkdown, formatSessionJson, appendedSince, summarizeMessage, watchSession, } from './sessions/index.js';
-export { BUILTIN_TOOLS, editFileTool, fetchUrlTool, findSymbolTool, listFilesTool, memoryReadTool, memoryWriteTool, readFileTool, runCommandTool, searchFilesTool, subAgentTool, writeFileTool, checkPolicyViolation, globToRegex, mergeToolSandbox, normalizePathPattern, pathMatchesAny, redact, countRedactions, buildRules, ToolResultCache, buildCacheKey, cachedExecute, } from './tools/index.js';
+export { defaultSessionDir, generateSessionId, saveSession, loadSession, deleteSession, listSessions, findLatestSession, formatSessionMarkdown, formatSessionJson, appendedSince, summarizeMessage, watchSession, searchSessions, sessionText, pruneSessions, pruneByRetention, } from './sessions/index.js';
+export { commandDirs, expandCustomCommand, formatCustomCommands, loadCustomCommands, parseCommandFile, } from './commands/custom-commands.js';
+export { BUILTIN_TOOLS, editFileTool, fetchUrlTool, findSymbolTool, listFilesTool, memoryReadTool, memoryForgetTool, memoryWriteTool, readFileTool, runCommandTool, searchFilesTool, subAgentTool, writeFileTool, checkPolicyViolation, globToRegex, mergeToolSandbox, normalizePathPattern, pathMatchesAny, redact, countRedactions, buildRules, ToolResultCache, buildCacheKey, cachedExecute, } from './tools/index.js';
 // Skills system
 export { buildSkillsBlock, composeSkillsPrompt, discoverSkills, fetchSkillsCatalog, installSkillFromCatalog, loadSkillsRegistry, loadSkillsRegistryAsync, parseSkill, parseSkillsDir, resolveSkillRoots, scoreSkill, searchSkills, selectSkills, skillsRegistryFromList, DEFAULT_SKILL_CATALOG_URL, GLOBAL_SKILLS_DIR, LOCAL_SKILLS_DIR, PROJECT_SKILLS_DIR, SKILL_CATALOG_VERSION, } from './skills/index.js';
 export { cosine, embedderFromEnv, hashingEmbedder, openAiCompatibleEmbedder, } from './semantic/embedder.js';
@@ -40,7 +50,7 @@ export { MARKETPLACE_CATALOG_VERSION } from './mcp/marketplace-types.js';
 // Checkpoint system
 export { CheckpointStore } from './checkpoints/index.js';
 // Specs system (spec-driven planning mode)
-export { SpecStore, isSafeSpecId, runKey, slugifyTaskForSpecId, SPEC_READONLY_TOOLS, splitSpecSections, convertToCheckboxes, parseTasks, setTaskDone } from './specs/index.js';
+export { SpecStore, isSafeSpecId, runKey, slugifyTaskForSpecId, SPEC_READONLY_TOOLS, splitSpecSections, convertToCheckboxes, parseTasks, setTaskDone, changedSince, changeSize, keepDoneTasks, referencedPaths, specDrift, syncSpecTask } from './specs/index.js';
 // Orchestrator system
 export { BUILTIN_SPECIALISTS, defaultConfigPath, effectiveToolsFor, BOARD_TOOL_NAMES, createBoardTools, DEFAULT_BOARD_CAP, getRegisteredSpecialist, getSpecialist, MessageBoard, listSpecialists, loadSpecialistsFromConfig, parseRouterOutput, registerSpecialist, resolveEffectiveModel, ROUTER_SYSTEM_PROMPT, runOrchestrator, runRouter, saveSpecialistsToConfig, unregisterSpecialist, validateSpecialistConfig, _resetSpecialistsForTests, _customSpecialistCount, } from './orchestrator/index.js';
 // Diff utilities (line-level unified diff)
@@ -78,4 +88,5 @@ export { READ_ONLY_TOOLS, resolveAutoApprove } from './tools/read-only.js';
 // Project check detection (typecheck / lint / test commands) for verify-by-default.
 export { autoRunCommands, autoRunFingerprint, detectProjectChecks, formatProjectCommandsBlock, projectScriptsFingerprint } from './verify/index.js';
 export { isAlwaysAllowable, isListedCommand, needsScriptFingerprint, normalizeCommand } from './tools/command-allow.js';
-//# sourceMappingURL=index.js.map
+// Git-style ignore rules (.gitignore, .forgeignore) used by the file tools and indexes.
+export { IgnoreRules, IGNORE_FILE_NAMES, findGitRoot } from './tools/ignore-rules.js';

package/dist/lazy-model.d.ts

@@ -11,4 +11,3 @@ export declare function lazyLanguageModel(meta: {
     provider: string;
     modelId: string;
 }, load: () => Promise<LanguageModelV4>): LanguageModelV4;
-//# sourceMappingURL=lazy-model.d.ts.map

package/dist/lazy-model.js

@@ -13,4 +13,3 @@ export function lazyLanguageModel(meta, load) {
         doStream: (options) => get().then((m) => m.doStream(options)),
     };
 }
-//# sourceMappingURL=lazy-model.js.map

package/dist/lint/auto-lint.d.ts

@@ -23,4 +23,3 @@ export declare function commandFor(relPath: string, commands: Record<string, str
 export declare function lintFile(relPath: string, config: AutoLintConfig, ctx: ToolContext): Promise<LintReport>;
 /** The note appended to the tool result when lint found problems. */
 export declare function lintMessage(report: LintReport): string;
-//# sourceMappingURL=auto-lint.d.ts.map

package/dist/lint/auto-lint.js

@@ -58,4 +58,3 @@ export async function lintFile(relPath, config, ctx) {
 export function lintMessage(report) {
     return `[auto-lint] ${report.problems.length} problem${report.problems.length === 1 ? '' : 's'} in ${report.path}. Fix them:\n${report.problems.join('\n')}`;
 }
-//# sourceMappingURL=auto-lint.js.map

package/dist/lint/index.d.ts

@@ -1,3 +1,2 @@
 export { commandFor, lintFile, lintMessage, shellQuote } from './auto-lint.js';
 export type { AutoLintConfig, LintReport } from './auto-lint.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/lint/index.js

@@ -1,2 +1 @@
 export { commandFor, lintFile, lintMessage, shellQuote } from './auto-lint.js';
-//# sourceMappingURL=index.js.map

package/dist/lsp/client.d.ts

@@ -37,4 +37,3 @@ export declare class LspClient {
     private onData;
     private onMessage;
 }
-//# sourceMappingURL=client.d.ts.map

package/dist/lsp/client.js

@@ -206,4 +206,3 @@ function toDiagnostic(d) {
         ...(d.code !== undefined ? { code: d.code } : {}),
     };
 }
-//# sourceMappingURL=client.js.map

package/dist/lsp/diagnostics.d.ts

@@ -19,4 +19,3 @@ export interface LspReport {
 export declare function collectErrors(files: string[], cwd: string, config?: LspConfig): Promise<LspReport>;
 /** Plain-text rendering fed to the model, in `file:line:col: message` form. */
 export declare function formatErrors(errors: FileDiagnostics[]): string;
-//# sourceMappingURL=diagnostics.d.ts.map

package/dist/lsp/diagnostics.js

@@ -79,4 +79,3 @@ export function formatErrors(errors) {
     })
         .join('\n');
 }
-//# sourceMappingURL=diagnostics.js.map

package/dist/lsp/index.d.ts

@@ -2,4 +2,3 @@ export { LspClient } from './client.js';
 export type { LspDiagnostic, LspServerSpec, LspSeverity } from './client.js';
 export { collectErrors, formatErrors } from './diagnostics.js';
 export type { FileDiagnostics, LspConfig, LspReport } from './diagnostics.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/lsp/index.js

@@ -1,3 +1,2 @@
 export { LspClient } from './client.js';
 export { collectErrors, formatErrors } from './diagnostics.js';
-//# sourceMappingURL=index.js.map

package/dist/mcp/catalog.d.ts

@@ -20,4 +20,3 @@ export declare function loadMcpCatalog(options?: {
     servers: MarketplaceEntry[];
     warning?: string;
 }>;
-//# sourceMappingURL=catalog.d.ts.map

package/dist/mcp/catalog.js

@@ -109,4 +109,3 @@ export async function loadMcpCatalog(options = {}) {
         return { servers: [...byName.values()], warning: `Could not load catalog ${url}: ${err.message}` };
     }
 }
-//# sourceMappingURL=catalog.js.map

package/dist/mcp/index.d.ts

@@ -10,4 +10,3 @@ export type { ConnectedMcpServer } from './mcp-client.js';
 export { defaultCacheRoot, defaultUserMcpPath, installMcpServer, installDirNameFor, listInstalledServers, normalizeGithubSource, probeRepoForServer, readUserMcpRegistry, uninstallMcpServer, writeUserMcpRegistry, } from './marketplace.js';
 export type { InstalledMcpServer, InstalledServerMetadata, MarketplaceCatalog, MarketplaceEntry, } from './marketplace-types.js';
 export { MARKETPLACE_CATALOG_VERSION } from './marketplace-types.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.js

@@ -7,4 +7,3 @@ export { assertValidServerName, registerMcpServer, setMcpServerDisabled } from '
 // MCP marketplace
 export { defaultCacheRoot, defaultUserMcpPath, installMcpServer, installDirNameFor, listInstalledServers, normalizeGithubSource, probeRepoForServer, readUserMcpRegistry, uninstallMcpServer, writeUserMcpRegistry, } from './marketplace.js';
 export { MARKETPLACE_CATALOG_VERSION } from './marketplace-types.js';
-//# sourceMappingURL=index.js.map

package/dist/mcp/json-schema-to-zod.d.ts

@@ -10,4 +10,3 @@ import { z } from 'zod';
  * generation hint rather than a security boundary.
  */
 export declare function jsonSchemaToZod(schema: unknown): z.ZodTypeAny;
-//# sourceMappingURL=json-schema-to-zod.d.ts.map

package/dist/mcp/json-schema-to-zod.js

@@ -89,4 +89,3 @@ function combineOneOf(branches) {
 function isNullSchema(node) {
     return typeof node === 'object' && node !== null && node.type === 'null';
 }
-//# sourceMappingURL=json-schema-to-zod.js.map

package/dist/mcp/manager.d.ts

@@ -48,4 +48,3 @@ export declare class McpManager {
     private readScope;
     private load;
 }
-//# sourceMappingURL=manager.d.ts.map

package/dist/mcp/manager.js

@@ -121,4 +121,3 @@ export class McpManager {
         this.statuses = [...statuses, ...results.map((r) => r.status)];
     }
 }
-//# sourceMappingURL=manager.js.map

package/dist/mcp/marketplace-types.d.ts

@@ -80,4 +80,3 @@ export interface InstalledServerMetadata {
     installedAt: string;
     displayName?: string;
 }
-//# sourceMappingURL=marketplace-types.d.ts.map

package/dist/mcp/marketplace-types.js

@@ -10,4 +10,3 @@
  */
 /** Version of the catalog JSON format. Bumped on backwards-incompatible changes. */
 export const MARKETPLACE_CATALOG_VERSION = 1;
-//# sourceMappingURL=marketplace-types.js.map

package/dist/mcp/marketplace.d.ts

@@ -95,4 +95,3 @@ export declare function listInstalledServers(params?: {
     cacheRoot?: string;
     userMcpPath?: string;
 }): Promise<InstalledMcpServer[]>;
-//# sourceMappingURL=marketplace.d.ts.map

package/dist/mcp/marketplace.js

@@ -319,4 +319,3 @@ export async function listInstalledServers(params) {
     }
     return out;
 }
-//# sourceMappingURL=marketplace.js.map

package/dist/mcp/mcp-client.d.ts

@@ -24,4 +24,3 @@ export declare function closeAll(servers: ConnectedMcpServer[]): Promise<void>;
  * single string and keep the structured content for any embedded resources.
  */
 export declare function mcpResultToValue(result: unknown): unknown;
-//# sourceMappingURL=mcp-client.d.ts.map

package/dist/mcp/mcp-client.js

@@ -185,4 +185,3 @@ export function mcpResultToValue(result) {
     }
     return { text, content: r.content, isError: r.isError };
 }
-//# sourceMappingURL=mcp-client.js.map

package/dist/mcp/mcp-config.d.ts

@@ -56,4 +56,3 @@ export declare function loadMcpConfig(configPath: string): Promise<McpConfigFile
  * that already have the file contents (e.g. embedded configs).
  */
 export declare function parseMcpConfig(raw: string, sourcePath?: string): McpConfigFile;
-//# sourceMappingURL=mcp-config.d.ts.map

package/dist/mcp/mcp-config.js

@@ -60,4 +60,3 @@ export function parseMcpConfig(raw, sourcePath = '<inline>') {
     }
     return result.data;
 }
-//# sourceMappingURL=mcp-config.js.map

package/dist/mcp/registry.d.ts

@@ -12,4 +12,3 @@ export declare function setMcpServerDisabled(params: {
     disabled: boolean;
     userMcpPath?: string;
 }): Promise<boolean>;
-//# sourceMappingURL=registry.d.ts.map

package/dist/mcp/registry.js

@@ -33,4 +33,3 @@ export async function setMcpServerDisabled(params) {
     await writeUserMcpRegistry(file, registry);
     return true;
 }
-//# sourceMappingURL=registry.js.map

package/dist/memory/memory-store.d.ts

@@ -37,16 +37,34 @@ export interface LoadedMemory {
     /** Total raw bytes from disk before truncation. */
     totalBytes: number;
 }
+/** What kind of fact a section holds. Sections without metadata are `convention`. */
+export type MemoryType = 'convention' | 'decision' | 'correction' | 'reference';
 export interface MemorySection {
     /** Section heading, exactly as written (e.g. "Build commands"). */
     heading: string;
-    /** Markdown body under the heading (excluding the heading line). */
+    /** Markdown body under the heading (excluding the heading line and metadata comment). */
     body: string;
     /** Source identifier (`global` | `project` | absolute path). */
     source: string;
-    /** Last-modified epoch ms. Inferred from disk stat() per source. */
+    /** Last-modified epoch ms: the section's `updated=` date, else the file's mtime. */
     updatedAt: number;
+    /** Kind of fact; `convention` when the section has no metadata. */
+    type: MemoryType;
+    /** Paths (or `path#symbol`) the section depends on; used by the staleness check. */
+    refs: string[];
+    /** Always injected into the system prompt when true. */
+    pinned: boolean;
 }
+/** Metadata stamped on a section by `composeSectionUpdate`. */
+export interface SectionMeta {
+    type?: MemoryType;
+    refs?: string[];
+    pinned?: boolean;
+    /** Clock override for tests; defaults to the current time. */
+    now?: Date;
+}
+/** Lowercase, NFKC-normalize and whitespace-collapse a heading so near-duplicates compare equal. */
+export declare function normalizeHeading(h: string): string;
 export interface MemorySource {
     /** Absolute path to the file this section came from. */
     path: string;
@@ -92,17 +110,28 @@ export declare function parseMemory(text: string, source: string, updatedAt: num
  * sections appear last (closest to the prompt).
  */
 export declare function loadMemory(cwd: string): Promise<LoadedMemory>;
+export interface InjectOptions {
+    /** The run's first user message; sections are ranked against it. */
+    task?: string;
+    /** Dead-ref reasons keyed by `staleKey`; matching sections get a visible marker. */
+    stale?: Map<string, string[]>;
+}
 /**
- * Compose a memory injection for the system prompt. Truncates to fit the
- * budget by dropping the OLDEST sections first (lowest updatedAt). Returns
- * the assembled markdown plus diagnostics.
+ * Compose a memory injection for the system prompt.
+ *
+ * When every section fits the budget, all are injected in file order. When
+ * not: pinned sections first (capped), a one-line-per-section index so the
+ * model knows what else exists (`memory_read` fetches it), then the sections
+ * most relevant to `opts.task` that still fit, best last (closest to the
+ * prompt). Everything left out lands in `dropped`. Output never exceeds
+ * `budgetBytes`.
  */
-export declare function injectMemory(loaded: LoadedMemory, budgetBytes?: number): MemoryInjection;
+export declare function injectMemory(loaded: LoadedMemory, budgetBytes?: number, opts?: InjectOptions): MemoryInjection;
 /**
  * Compose the system-prompt block for memory injection. Returns the empty
  * string when no memory is found (so the caller can skip the block).
  */
-export declare function buildMemoryBlock(cwd: string, budgetBytes?: number): Promise<string>;
+export declare function buildMemoryBlock(cwd: string, budgetBytes?: number, opts?: InjectOptions): Promise<string>;
 /**
  * Read a single memory file from disk (raw markdown, not parsed).
  */
@@ -116,12 +145,29 @@ export declare function writeMemoryFile(absPath: string, content: string): Promi
  * Append a new section (or replace an existing section with the same
  * heading) inside a memory file. Returns the new file contents.
  */
-export declare function composeSectionUpdate(current: string, heading: string, body: string): string;
+export declare function composeSectionUpdate(current: string, heading: string, body: string, meta?: SectionMeta): string;
+/**
+ * Remove the section whose heading matches `heading` (case and spacing
+ * ignored). Returns the file unchanged with `removed: false` when absent.
+ */
+export declare function removeSection(current: string, heading: string): {
+    content: string;
+    removed: boolean;
+};
+/**
+ * Bring a memory file under `maxBytes` by dropping whole sections, lowest
+ * ranked first: lowest type weight, then oldest `updated`, then earliest in
+ * the file. Pinned sections and `keepHeading` are never dropped. If only
+ * those remain, the file is returned over the cap rather than losing them.
+ */
+export declare function capMemory(content: string, maxBytes: number, keepHeading: string): {
+    content: string;
+    dropped: string[];
+};
 /**
  * Truncate a memory file to fit under `maxBytes` by dropping the oldest
- * sections. Returns the new content. Used by an auto-trim job (not yet
- * wired into the agent: see docs/ROADMAP.md).
+ * sections (file order). Sections are kept verbatim, metadata comment
+ * included. Returns the new content.
  */
 export declare function trimToBytes(content: string, maxBytes: number): string;
 export { PROJECT_MEMORY_DIR as _PROJECT_MEMORY_DIR, PROJECT_MEMORY_FILE as _PROJECT_MEMORY_FILE };
-//# sourceMappingURL=memory-store.d.ts.map