@inixiative/foundry-core 0.5.7 → 0.5.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inixiative/foundry-core",
-  "version": "0.5.7",
+  "version": "0.5.9",
   "type": "module",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -33,7 +33,7 @@
     "bun": ">=1.4.2"
   },
   "peerDependencies": {
-    "@inixiative/archive": "^0.23.0"
+    "@inixiative/archive": "^0.24.0"
   },
   "peerDependenciesMeta": {
     "@inixiative/archive": {
@@ -41,6 +41,6 @@
     }
   },
   "devDependencies": {
-    "@inixiative/archive": "^0.23.0"
+    "@inixiative/archive": "^0.24.0"
   }
 }

package/src/feedback/archive-turns.ts

@@ -6,12 +6,31 @@ import type { TranscriptTurn } from './correction';
 // `foundry repeats` and Oracle's session miner; its own export, so the core root never loads Archive.
 
 const INTERRUPTED = /^\s*\[Request interrupted by user/;
-const COMMIT_BRACKET = /\[[^[\]\n]+\s([0-9a-f]{7,40})\]/g;
+const COMMIT_BRACKET = /\[([^[\]\n]+?)\s([0-9a-f]{7,40})\]/g;
+/** `git commit` adds this to the branch on a repository's first commit. */
+const ROOT_COMMIT = /\s+\(root-commit\)$/;
 const COMMIT_LINE = /^commit ([0-9a-f]{40})/gm;
 
+/** A commit a session made, as `git commit` printed it: the branch it was on, and its short SHA. */
+export interface MadeCommit {
+  /** As git printed it: `main`, `feat/x`, `detached HEAD`; `(root-commit)` dropped. */
+  readonly branch: string;
+  readonly sha: string;
+}
+
+/**
+ * Commits a tool result says were made: `git commit`'s `[branch sha]` line only, with the branch,
+ * so a reader can tell work on a PR's own branch (amended or rebased away later) from other work.
+ */
+export const commitsMade = (text: string): MadeCommit[] =>
+  [...text.matchAll(COMMIT_BRACKET)].map((m) => ({
+    branch: m[1]!.replace(ROOT_COMMIT, ''),
+    sha: m[2]!,
+  }));
+
 /** Commit SHAs a tool result printed: `git commit`'s `[branch sha]` line, `git log`'s `commit <sha>`. */
 export const commitsIn = (text: string) => [
-  ...[...text.matchAll(COMMIT_BRACKET)].map((m) => m[1]!),
+  ...commitsMade(text).map((made) => made.sha),
   ...[...text.matchAll(COMMIT_LINE)].map((m) => m[1]!),
 ];
 

package/src/index.ts

@@ -372,6 +372,19 @@ export {
   vendorOfProvider,
 } from './model-registry';
 export * from './native-evidence';
+// Native tools by what they do (tool gate, work items, Oracle's session reader)
+export {
+  DEFAULT_CONSUMED_TOOLS,
+  FETCH_TOOLS,
+  LINEAR_ISSUE_TOOLS,
+  READ_TOOLS,
+  SHELL_TOOLS,
+  toolCapability,
+  toolGlobMatcher,
+  WORK_ITEM_ID_KEYS,
+  WRITE_TOOLS,
+  workItemId,
+} from './native-tools';
 // Retry middleware
 export { type RetryConfig, retryMiddleware } from './retry';
 export { type Route, type RouteHandler, Router, type RouterConfig } from './router';

package/src/native-tools.ts

@@ -0,0 +1,76 @@
+import type { Capability } from './capability';
+
+// Native harness tools by what they do: one list for Foundry's tool gate and work items, and for
+// Oracle, which reads the same calls out of Archive sessions and never imports Foundry.
+
+/** Shell tools: Claude Code's Bash and its job tools, Codex's shell and exec_command. */
+export const SHELL_TOOLS: ReadonlySet<string> = new Set([
+  'Bash',
+  'BashOutput',
+  'KillShell',
+  'shell',
+  'exec_command',
+]);
+/** Tools whose path argument is a file the call writes: Claude Code's editors, Codex's patch. */
+export const WRITE_TOOLS: ReadonlySet<string> = new Set([
+  'Write',
+  'Edit',
+  'MultiEdit',
+  'NotebookEdit',
+  'apply_patch',
+]);
+export const READ_TOOLS: ReadonlySet<string> = new Set([
+  'Read',
+  'NotebookRead',
+  'LS',
+  'Glob',
+  'Grep',
+]);
+export const FETCH_TOOLS: ReadonlySet<string> = new Set(['WebFetch', 'WebSearch']);
+
+/** The capability a native tool call exercises, by its name alone. */
+export function toolCapability(toolName: string): Capability {
+  if (SHELL_TOOLS.has(toolName)) return 'exec:shell';
+  if (WRITE_TOOLS.has(toolName)) return 'file:write';
+  if (READ_TOOLS.has(toolName)) return 'file:read';
+  if (FETCH_TOOLS.has(toolName)) return 'net:fetch';
+  if (toolName.startsWith('mcp__')) return 'net:api';
+  return `tool:${toolName}`;
+}
+
+/** A Linear issue fetch under any MCP server name. Globs match case-insensitively (`toolGlobMatcher`). */
+export const LINEAR_ISSUE_TOOLS: readonly string[] = Object.freeze(['mcp__*linear*__get_issue']);
+
+/** Tools that fetch a work item: Linear issues and documents, Notion pages, under any MCP server name. */
+export const DEFAULT_CONSUMED_TOOLS: readonly string[] = Object.freeze([
+  ...LINEAR_ISSUE_TOOLS,
+  'mcp__*linear*__get_document',
+  'mcp__*notion*__*fetch*',
+]);
+
+/** Whether a tool name matches any of the globs, case-insensitively. */
+export function toolGlobMatcher(globs: readonly string[]): (toolName: string) => boolean {
+  const compiled = globs.map((glob) => new Bun.Glob(glob.toLowerCase()));
+  return (toolName) => {
+    const name = toolName.toLowerCase();
+    return compiled.some((glob) => glob.match(name));
+  };
+}
+
+/** Fields a fetch tool names its item by, in the order they are tried. */
+export const WORK_ITEM_ID_KEYS = [
+  'id',
+  'issueId',
+  'issue_id',
+  'documentId',
+  'pageId',
+  'page_id',
+  'url',
+] as const;
+
+/** The item a fetch call names: the first non-empty string among `WORK_ITEM_ID_KEYS`. */
+export function workItemId(input: Readonly<Record<string, unknown>>): string | undefined {
+  return WORK_ITEM_ID_KEYS.map((key) => input[key]).find(
+    (value): value is string => typeof value === 'string' && value.trim().length > 0,
+  );
+}