@wrongstack/core 0.306.4 → 0.307.1

package/dist/coordination/agents/project-agent-capture.d.ts

@@ -0,0 +1,48 @@
+import { type ConsolidationMetadata } from './project-agent-consolidation.js';
+import type { LearnedCaptureResult } from './project-agent-identity-types.js';
+import { type ProjectAgentLearningPolicy } from './project-agent-learning-policy.js';
+import { type StructuredLearnedEntry } from './project-agent-learning-structured.js';
+export declare function loadProjectAgentLearned(role: string, projectRoot?: string): string;
+export declare function listProjectAgentLearnedEntries(role: string, projectRoot?: string): string[];
+export declare function parseStructuredLearnedEntries(role: string, projectRoot?: string): StructuredLearnedEntry[];
+export declare function resolveCaptureKey(role: string, projectRoot?: string): string;
+export declare function canCaptureNewLearned(role: string, _existingSize: number, isManual: boolean, projectRoot?: string): string | undefined;
+export interface ProjectAgentLearnStats {
+    role: string;
+    exists: boolean;
+    entryCount: number;
+    totalBytes: number;
+    lastCapture: string | null;
+    lastCaptureTimestamp: number | null;
+    cooldownRemainingMs: number;
+    sessionCaptureCount: number;
+    needsSummarization: boolean;
+    learnedPath: string | null;
+    identityPath: string | null;
+    hasIdentity: boolean;
+    hasConfig: boolean;
+    hasKnowledge: boolean;
+    learningEnabled: boolean;
+    lifetimeCaptureCount: number;
+    lastCaptureSource: ProjectAgentLearningPolicy['lastCaptureSource'] | null;
+    isConsolidated: boolean;
+    consolidation?: ConsolidationMetadata | undefined;
+    skills: string[];
+    skilledEntryCount: number;
+    appliedEntryCount: number;
+    deadEntryCount: number;
+    directiveHitRate: number | null;
+}
+export declare function getProjectAgentLearnStats(role: string, projectRoot?: string): ProjectAgentLearnStats;
+export declare function detectLearnedConflicts(projectRoot?: string): Array<{
+    roleA: string;
+    roleB: string;
+    snippetA: string;
+    snippetB: string;
+    similarity: number;
+    detectedAt: string;
+}>;
+export declare function captureLearnedFromAgentOutput(output: string, role: string, projectRoot?: string, isManual?: boolean): number;
+export declare function captureLearnedFromAgentOutputDetailed(output: string, role: string, projectRoot?: string, isManual?: boolean): LearnedCaptureResult;
+export declare function hintLearnedNeedsSummarization(role: string, projectRoot?: string): string;
+//# sourceMappingURL=project-agent-capture.d.ts.map

package/dist/coordination/agents/project-agent-identity.d.ts

@@ -18,12 +18,8 @@
  *   knowledge.md  — current-needs checklist (what versions to verify today)
  */
 import { existsSync } from 'node:fs';
-import type { SubagentConfig } from '../../types/multi-agent.js';
 import { CAPTURE_COOLDOWN_MS, CAPTURE_MAX_PER_SESSION } from './project-agent-capture-window.js';
-import { type ConsolidationMetadata } from './project-agent-consolidation.js';
-import type { LearnedCaptureResult, ProjectAgentConfig, RoleKnowledgeManifest } from './project-agent-identity-types.js';
-import { type ProjectAgentLearningPolicy } from './project-agent-learning-policy.js';
-import { type StructuredLearnedEntry } from './project-agent-learning-structured.js';
+import type { RoleKnowledgeManifest } from './project-agent-identity-types.js';
 export { type AutoOptimizeDecision, type AutoOptimizeEvent, type AutoOptimizePolicy, type AutoOptimizePolicyOverrides, DEFAULT_AUTO_OPTIMIZE_POLICY, evaluateAutoOptimize, LearningOptimizationScheduler, type LearningOptimizationSchedulerOptions, resolveAutoOptimizePolicy, } from './project-agent-auto-optimize.js';
 export { CAPTURE_SESSION_WINDOW_MS, resetCaptureWindow, resetCaptureWindows, } from './project-agent-capture-window.js';
 export { loadProjectAgentConfig } from './project-agent-config-io.js';
@@ -42,26 +38,14 @@ export { buildSkillDistillInstruction, clearProjectSkillAugmentation, DEFAULT_EA
 export { CAPTURE_COOLDOWN_MS, CAPTURE_MAX_PER_SESSION };
 export { listProjectAgentRoles, refreshProjectAgentIdentity, resetProjectAgentIdentity, updateProjectAgentConfig, updateProjectAgentIdentity, updateProjectAgentKnowledge, updateProjectAgentLearned, } from './project-agent-files.js';
 export { createProjectAgent, loadProjectAgentProfile, slugifyProjectAgentRole, } from './project-agent-profile.js';
-/**
- * Live roster overlay. Project policy is resolved lazily for both built-in and
- * project-created roles, so WebUI changes take effect on the next spawn without
- * rebuilding the Director. Built-in roles keep their safety floors; custom
- * roles may opt into a deliberately narrow runtime.
- */
-export declare function createProjectAgentRoster(baseRoster: Record<string, SubagentConfig>, projectRoot?: string): Record<string, SubagentConfig>;
+export { applyProjectAgentConfig, createProjectAgentRoster, } from './project-agent-roster.js';
+export { canCaptureNewLearned, captureLearnedFromAgentOutput, captureLearnedFromAgentOutputDetailed, detectLearnedConflicts, getProjectAgentLearnStats, hintLearnedNeedsSummarization, listProjectAgentLearnedEntries, loadProjectAgentLearned, parseStructuredLearnedEntries, type ProjectAgentLearnStats, } from './project-agent-capture.js';
 /**
  * Load the project-level identity appendix for a given role.
  * Appended to the subagent prompt after the base role prompt and policy.
  * Returns the empty string when no identity file exists.
  */
 export declare function loadProjectAgentIdentity(role: string, projectRoot?: string): string;
-/**
- * Load the learning-derived wisdom for a given role.
- * Appended to the subagent prompt as a "knowledge from past sessions" block.
- * The learning file is auto-generated by the `memory-curator` or
- * `self-improving` agent roles and contains de-duplicated, curated findings.
- */
-export declare function loadProjectAgentLearned(role: string, projectRoot?: string): string;
 /**
  * Load the current-knowledge checklist for a given role.
  * Returns the built-in directive if no project override exists.
@@ -69,13 +53,6 @@ export declare function loadProjectAgentLearned(role: string, projectRoot?: stri
  * before answering questions in its domain.
  */
 export declare function loadRoleKnowledgeManifest(role: string, projectRoot?: string): RoleKnowledgeManifest | undefined;
-/**
- * Merge a project agent config onto a base `SubagentConfig`.
- * Returns a new config; does not mutate either input.
- */
-export declare function applyProjectAgentConfig(base: SubagentConfig, projectConfig: ProjectAgentConfig | undefined, options?: {
-    protectSystemRole?: boolean | undefined;
-}): SubagentConfig;
 /**
  * Build the full project-contextualized prompt for a given role.
  *
@@ -89,108 +66,5 @@ export declare function applyProjectAgentConfig(base: SubagentConfig, projectCon
 export declare function buildProjectContextualizedPrompt(basePrompt: string, role: string, projectRoot?: string, options?: {
     identityOverride?: string | undefined;
 }): string;
-/**
- * Check whether a new capture is allowed for this role. Returns a rejection
- * reason string when blocked, or undefined when capture may proceed.
- *
- * `existingSize` is accepted for call-site compatibility but no longer gates
- * anything: an over-budget buffer is now trimmed at write time
- * (`enforceLearnedBudget`) instead of blocking every future capture. The old
- * size gate had no self-clearing path, so the roles with the most learning
- * were the ones that had silently stopped learning.
- */
-export declare function canCaptureNewLearned(role: string, _existingSize: number, isManual: boolean, projectRoot?: string): string | undefined;
-/**
- * Per-role learning stats for monitoring UIs.
- */
-export interface ProjectAgentLearnStats {
-    role: string;
-    exists: boolean;
-    entryCount: number;
-    totalBytes: number;
-    lastCapture: string | null;
-    lastCaptureTimestamp: number | null;
-    cooldownRemainingMs: number;
-    sessionCaptureCount: number;
-    needsSummarization: boolean;
-    learnedPath: string | null;
-    identityPath: string | null;
-    hasIdentity: boolean;
-    hasConfig: boolean;
-    hasKnowledge: boolean;
-    learningEnabled: boolean;
-    lifetimeCaptureCount: number;
-    lastCaptureSource: ProjectAgentLearningPolicy['lastCaptureSource'] | null;
-    /** Whether a consolidated document exists for this role. */
-    isConsolidated: boolean;
-    /** Consolidation metadata, if a consolidation has been performed. */
-    consolidation?: ConsolidationMetadata | undefined;
-    /** Skills this project has developed a dedicated addendum for. */
-    skills: string[];
-    /** Directives already routed to a skill and awaiting distillation. */
-    skilledEntryCount: number;
-    /**
-     * How the buffer is actually performing, not just how big it is.
-     *
-     * `lifetimeCaptureCount` measures volume, which says nothing about whether
-     * the role is learning the right things. These three do:
-     * `provenEntryCount` is directives with a real track record, `deadEntryCount`
-     * is directives that have never been exercised at all (a high share means the
-     * agent is writing things nobody uses), and `directiveHitRate` is the share
-     * of applications that ended in a successful task.
-     */
-    appliedEntryCount: number;
-    deadEntryCount: number;
-    /** `null` until at least one directive has been exercised. */
-    directiveHitRate: number | null;
-}
-export declare function getProjectAgentLearnStats(role: string, projectRoot?: string): ProjectAgentLearnStats;
-/**
- * Re-export existsSync so callers can check file existence without importing fs.
- */
 export { existsSync };
-/**
- * Detect semantic conflicts between different roles' learned wisdom.
- * Returns entries where token overlap ≥ 0.60, which suggests the two
- * roles have learned about the same topic — potentially contradicting.
- */
-export declare function detectLearnedConflicts(projectRoot?: string): Array<{
-    roleA: string;
-    roleB: string;
-    snippetA: string;
-    snippetB: string;
-    similarity: number;
-    detectedAt: string;
-}>;
-export declare function listProjectAgentLearnedEntries(role: string, projectRoot?: string): string[];
-export declare function parseStructuredLearnedEntries(role: string, projectRoot?: string): StructuredLearnedEntry[];
-/**
- * Learned-wisdom capture from agent output.
- *
- * Scans `output` for `## LEARNED` blocks and persists each unique,
- * quality-passing block to the role's `learned.md`.  Each block is run
- * through `normalizeLearnedEntry` so the buffer only accumulates instructive
- * directives — narrative session logs are rejected at capture time. Near-
- * duplicate entries (token overlap ≥ 0.55) are silently skipped.
- *
- * When the resulting file would exceed `LEARNED_HARD_LIMIT` (16 KB)
- * the oldest entries are rotated out before writing.
- *
- * @returns the number of **new** items actually persisted (0 if none).
- */
-export declare function captureLearnedFromAgentOutput(output: string, role: string, projectRoot?: string, isManual?: boolean): number;
-export declare function captureLearnedFromAgentOutputDetailed(output: string, role: string, projectRoot?: string, isManual?: boolean): LearnedCaptureResult;
-/**
- * Signal the host that a background summarisation pass is warranted.
- * Called by `captureLearnedFromAgentOutput` when the **new** learned size
- * crosses `LEARNED_SOFT_LIMIT`.  The host is responsible for scheduling a
- * low-priority consolidation task (typically via the Brain or a shadow agent).
- *
- * The summary _mechanism_ is intentionally shallow here — the real
- * summarisation is an LLM call that should run as a deferred, uncritical
- * fleet task so it never blocks a user-facing operation.
- *
- * @returns a summary brief for the host, or '' when no action is needed.
- */
-export declare function hintLearnedNeedsSummarization(role: string, projectRoot?: string): string;
 //# sourceMappingURL=project-agent-identity.d.ts.map

package/dist/coordination/agents/project-agent-roster.d.ts

@@ -0,0 +1,17 @@
+import type { SubagentConfig } from '../../types/multi-agent.js';
+import type { ProjectAgentConfig } from './project-agent-identity-types.js';
+/**
+ * Merge a project agent config onto a base `SubagentConfig`.
+ * Returns a new config; does not mutate either input.
+ */
+export declare function applyProjectAgentConfig(base: SubagentConfig, projectConfig: ProjectAgentConfig | undefined, options?: {
+    protectSystemRole?: boolean | undefined;
+}): SubagentConfig;
+/**
+ * Live roster overlay. Project policy is resolved lazily for both built-in and
+ * project-created roles, so WebUI changes take effect on the next spawn without
+ * rebuilding the Director. Built-in roles keep their safety floors; custom
+ * roles may opt into a deliberately narrow runtime.
+ */
+export declare function createProjectAgentRoster(baseRoster: Record<string, SubagentConfig>, projectRoot?: string): Record<string, SubagentConfig>;
+//# sourceMappingURL=project-agent-roster.d.ts.map

package/dist/coordination/agents/types.d.ts

@@ -77,20 +77,17 @@ export interface AgentDefinition {
 export declare const LIGHT_BUDGET: AgentBudgetTier;
 export declare const MEDIUM_BUDGET: AgentBudgetTier;
 export declare const HEAVY_BUDGET: AgentBudgetTier;
-/**
- * Tool allowlist presets. Agents pass the smallest set that covers their job —
- * a planning agent should not hold `write`/`bash`, a reviewer should be
- * read-only. Spread + extend per-agent where a role needs one extra tool.
- */
 export declare const TOOLS: {
+    /** Index-backed code discovery. Spread onto code-facing presets, not browser. */
+    readonly index: readonly ["codebase-stats", "codebase-search", "codebase-skeleton", "codebase-repo-map", "codebase-incoming-calls", "codebase-outgoing-calls"];
     /** Pure read/inspect — safe for analysis and review agents. */
     readonly read: readonly ["read", "grep", "glob", "search", "tree", "mailbox"];
     /** Read + structured inspection (logs, diffs, json, dependency audit). */
-    readonly inspect: readonly ["read", "grep", "glob", "search", "tree", "json", "diff", "logs", "audit", "mailbox"];
+    readonly inspect: readonly ["read", "grep", "glob", "search", "tree", "codebase-stats", "codebase-search", "codebase-skeleton", "codebase-repo-map", "codebase-incoming-calls", "codebase-outgoing-calls", "json", "diff", "logs", "audit", "mailbox"];
     /** Read + edit (no shell). For agents that write code/docs but don't run it. */
-    readonly write: readonly ["read", "grep", "glob", "search", "tree", "write", "edit", "replace", "patch", "mailbox"];
+    readonly write: readonly ["read", "grep", "glob", "search", "tree", "codebase-stats", "codebase-search", "codebase-skeleton", "codebase-repo-map", "codebase-incoming-calls", "codebase-outgoing-calls", "codebase-impact-analysis", "codebase-ast-replace", "codebase-invariant-check", "write", "edit", "replace", "patch", "mailbox"];
     /** Full build loop: edit + run (lint/format/typecheck/test/bash). */
-    readonly build: readonly ["read", "grep", "glob", "search", "tree", "diff", "write", "edit", "replace", "patch", "bash", "exec", "lint", "format", "typecheck", "test", "mailbox"];
+    readonly build: readonly ["read", "grep", "glob", "search", "tree", "codebase-stats", "codebase-search", "codebase-skeleton", "codebase-repo-map", "codebase-incoming-calls", "codebase-outgoing-calls", "codebase-impact-analysis", "codebase-ast-replace", "codebase-invariant-check", "codebase-targeted-test", "diff", "write", "edit", "replace", "patch", "bash", "exec", "lint", "format", "typecheck", "test", "mailbox"];
     /**
      * Version control.
      *
@@ -104,7 +101,7 @@ export declare const TOOLS: {
     /** Dependency management + CVE audit. */
     readonly deps: readonly ["read", "grep", "glob", "install", "outdated", "audit", "json", "mailbox"];
     /** Documentation authoring. */
-    readonly docs: readonly ["read", "grep", "glob", "search", "tree", "write", "edit", "document", "mailbox"];
+    readonly docs: readonly ["read", "grep", "glob", "search", "tree", "codebase-stats", "codebase-search", "codebase-skeleton", "codebase-repo-map", "codebase-incoming-calls", "codebase-outgoing-calls", "write", "edit", "document", "mailbox"];
     /** Web research. */
     readonly research: readonly ["read", "grep", "glob", "search", "fetch", "mailbox"];
 };