cognitive-core 0.1.0 → 0.1.2

package/dist/search/refinement-loop.js

@@ -7,6 +7,7 @@
  * 2. If not acceptable, injects failure context and retries
  * 3. Continues until acceptable or max iterations reached
  */
+import { refinementAnalysisTemplate } from '../workspace/templates/refinement-analysis.js';
 import { SolutionEvaluator } from './evaluator.js';
 /**
  * Default refinement configuration
@@ -26,6 +27,7 @@ const DEFAULT_CONFIG = {
 export class RefinementLoop {
     agentManager;
     memory;
+    taskRunner = null;
     evaluator;
     config;
     constructor(agentManager, memory, config = {}) {
@@ -34,6 +36,15 @@ export class RefinementLoop {
         this.config = { ...DEFAULT_CONFIG, ...config };
         this.evaluator = new SolutionEvaluator(agentManager, this.config.evaluatorConfig);
     }
+    /**
+     * Set the task runner for workspace-based analysis.
+     * Enables structured refinement plans via refinementAnalysisTemplate,
+     * and delegates evaluation to solutionEvaluationTemplate.
+     */
+    setTaskRunner(runner) {
+        this.taskRunner = runner;
+        this.evaluator.setTaskRunner(runner);
+    }
     /**
      * Get the evaluator for registering domain verifiers
      */
@@ -88,13 +99,21 @@ export class RefinementLoop {
                 stepsAttempted: currentTrajectory.steps.length,
                 previousAttempts: iteration + 1,
             };
-            // Query memory for similar failures if enabled
-            let failureMemory;
-            if (this.config.queryFailureMemory) {
-                failureMemory = await this.queryFailurePatterns(spawnConfig.task, failureContext);
+            // Get refinement strategy: workspace-based when runner available
+            let refinementAdditions;
+            const plan = await this.getRefinementPlan(currentTrajectory, spawnConfig.task, evaluations[evaluations.length - 1], iteration + 1);
+            if (plan) {
+                // Use structured plan from template
+                refinementAdditions = this.formatRefinementPlan(plan, failureContext);
+            }
+            else {
+                // Fallback: build prompt with memory-based context
+                let failureMemory;
+                if (this.config.queryFailureMemory) {
+                    failureMemory = await this.queryFailurePatterns(spawnConfig.task, failureContext);
+                }
+                refinementAdditions = this.buildRefinementPrompt(failureContext, failureMemory);
             }
-            // Build refinement prompt
-            const refinementAdditions = this.buildRefinementPrompt(failureContext, failureMemory);
             // Spawn refined agent
             const refinedConfig = {
                 ...spawnConfig,
@@ -138,6 +157,58 @@ export class RefinementLoop {
             bestScore,
         };
     }
+    /**
+     * Get a structured refinement plan via the workspace template.
+     * Returns null if taskRunner is unavailable or the template fails.
+     */
+    async getRefinementPlan(trajectory, task, evaluation, previousAttempts) {
+        if (!this.taskRunner)
+            return null;
+        try {
+            const result = await this.taskRunner.run(refinementAnalysisTemplate, {
+                trajectory,
+                task,
+                evaluation,
+                previousAttempts,
+            });
+            return result.output;
+        }
+        catch (error) {
+            console.warn('Workspace-based refinement analysis failed, falling back to heuristic:', error instanceof Error ? error.message : String(error));
+            return null;
+        }
+    }
+    /**
+     * Format a structured RefinementPlan into prompt additions for the retry agent.
+     */
+    formatRefinementPlan(plan, failureContext) {
+        const parts = [];
+        parts.push('## Root Cause Analysis');
+        parts.push('');
+        parts.push(`Previous attempt #${failureContext.previousAttempts} failed. Root causes identified:`);
+        for (const cause of plan.rootCauses) {
+            parts.push(`- ${cause}`);
+        }
+        parts.push('');
+        parts.push('## Recommended Strategy');
+        parts.push('');
+        parts.push(plan.strategy);
+        if (plan.steps.length > 0) {
+            parts.push('');
+            parts.push('## Specific Steps');
+            for (let i = 0; i < plan.steps.length; i++) {
+                parts.push(`${i + 1}. ${plan.steps[i]}`);
+            }
+        }
+        if (plan.avoidPatterns.length > 0) {
+            parts.push('');
+            parts.push('## Patterns to Avoid');
+            for (const pattern of plan.avoidPatterns) {
+                parts.push(`- DO NOT: ${pattern}`);
+            }
+        }
+        return parts.join('\n');
+    }
     /**
      * Query memory for similar failure patterns
      */

package/dist/search/refinement-loop.js.map

@@ -1 +1 @@
-{"version":3,"file":"refinement-loop.js","sourceRoot":"","sources":["../../src/search/refinement-loop.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"refinement-loop.js","sourceRoot":"","sources":["../../src/search/refinement-loop.ts"],"names":[],"mappings":"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"}

package/dist/search/refinement-types.d.ts

@@ -85,8 +85,8 @@ export declare const EvaluationResultSchema: z.ZodObject<{
     }[];
     acceptable: boolean;
     score: number;
+    method: "verification" | "heuristic" | "agent";
     quality: "excellent" | "good" | "poor" | "needs_work";
-    method: "verification" | "agent" | "heuristic";
     rawResponse?: string | undefined;
 }, {
     issues: {
@@ -97,8 +97,8 @@ export declare const EvaluationResultSchema: z.ZodObject<{
     }[];
     acceptable: boolean;
     score: number;
+    method: "verification" | "heuristic" | "agent";
     quality: "excellent" | "good" | "poor" | "needs_work";
-    method: "verification" | "agent" | "heuristic";
     rawResponse?: string | undefined;
 }>;
 export type EvaluationResult = z.infer<typeof EvaluationResultSchema>;

package/dist/search/team-router.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Team Router
+ *
+ * Recommends team composition for a given task description.
+ * Queries team playbooks and experiences from memory, scores matches,
+ * and applies team meta-strategies to adjust recommendations.
+ *
+ * The team-level analog of TaskRouter.
+ */
+import type { TeamPlaybook, RolePlaybook, TeamCompositionGuidance, TeamCoordinationGuidance } from '../types/index.js';
+import type { TeamExperienceMemory } from '../memory/team-experience.js';
+import type { TeamMetaLearner } from '../learning/team-meta-learner.js';
+export interface TeamRouterConfig {
+    /** Minimum playbook confidence to use directly */
+    minPlaybookConfidence: number;
+    /** How many playbook candidates to retrieve */
+    maxCandidates: number;
+    /** How many role playbooks to include per role */
+    maxRolePlaybooksPerRole: number;
+    /** Whether to include similar experiences in reasoning */
+    includeSimilarExperiences: boolean;
+}
+/**
+ * Result from team recommendation.
+ */
+export interface TeamRecommendation {
+    /** Matched team playbook (if any) */
+    playbook?: TeamPlaybook;
+    /** Recommended composition */
+    composition: TeamCompositionGuidance;
+    /** Recommended coordination */
+    coordination: TeamCoordinationGuidance;
+    /** Role playbooks for each recommended role */
+    rolePlaybooks: RolePlaybook[];
+    /** Confidence in this recommendation (0-1) */
+    confidence: number;
+    /** Reasoning for this recommendation */
+    reasoning: string;
+    /** Meta-strategies that were applied */
+    appliedMetaStrategies: string[];
+    /** Export as OpenTeams team.yaml format */
+    asTeamYaml(): string;
+}
+/**
+ * Task input for team recommendation.
+ */
+export interface TeamRecommendationInput {
+    description: string;
+    domain: string;
+    complexity: 'simple' | 'moderate' | 'complex' | 'epic';
+    constraints?: {
+        maxAgents?: number;
+        maxTokenBudget?: number;
+        preferredTopology?: string;
+    };
+}
+export declare class TeamRouter {
+    private memory;
+    private config;
+    private metaLearner?;
+    constructor(memory: TeamExperienceMemory, config?: Partial<TeamRouterConfig>, metaLearner?: TeamMetaLearner);
+    /**
+     * Set the team meta learner (can be set after construction).
+     */
+    setMetaLearner(metaLearner: TeamMetaLearner): void;
+    /**
+     * Recommend a team composition for a given task.
+     */
+    recommend(input: TeamRecommendationInput): Promise<TeamRecommendation>;
+    /**
+     * Compute base recommendation from playbook matches.
+     */
+    private computeBaseRecommendation;
+    /**
+     * Apply user constraints to the recommendation.
+     */
+    private applyConstraints;
+    /**
+     * Find role playbooks for each role in the recommendation.
+     */
+    private findRolePlaybooks;
+    /**
+     * Update configuration.
+     */
+    updateConfig(config: Partial<TeamRouterConfig>): void;
+}
+/**
+ * Create a TeamRouter instance.
+ */
+export declare function createTeamRouter(memory: TeamExperienceMemory, config?: Partial<TeamRouterConfig>, metaLearner?: TeamMetaLearner): TeamRouter;
+//# sourceMappingURL=team-router.d.ts.map

package/dist/search/team-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-router.d.ts","sourceRoot":"","sources":["../../src/search/team-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,uBAAuB,EACvB,wBAAwB,EAEzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAMxE,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,uBAAuB,EAAE,MAAM,CAAC;IAChC,0DAA0D;IAC1D,yBAAyB,EAAE,OAAO,CAAC;CACpC;AAaD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,8BAA8B;IAC9B,WAAW,EAAE,uBAAuB,CAAC;IACrC,+BAA+B;IAC/B,YAAY,EAAE,wBAAwB,CAAC;IACvC,+CAA+C;IAC/C,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,2CAA2C;IAC3C,UAAU,IAAI,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;IACvD,WAAW,CAAC,EAAE;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAiKD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,WAAW,CAAC,CAAkB;gBAGpC,MAAM,EAAE,oBAAoB,EAC5B,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,WAAW,CAAC,EAAE,eAAe;IAO/B;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,eAAe,GAAG,IAAI;IAIlD;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAsC5E;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAyCjC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgExB;;OAEG;YACW,iBAAiB;IAuB/B;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;CAGtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,oBAAoB,EAC5B,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,WAAW,CAAC,EAAE,eAAe,GAC5B,UAAU,CAEZ"}

package/dist/search/team-router.js

@@ -0,0 +1,315 @@
+/**
+ * Team Router
+ *
+ * Recommends team composition for a given task description.
+ * Queries team playbooks and experiences from memory, scores matches,
+ * and applies team meta-strategies to adjust recommendations.
+ *
+ * The team-level analog of TaskRouter.
+ */
+const DEFAULT_CONFIG = {
+    minPlaybookConfidence: 0.4,
+    maxCandidates: 5,
+    maxRolePlaybooksPerRole: 2,
+    includeSimilarExperiences: true,
+};
+// ============================================================
+// Default fallback composition
+// ============================================================
+function defaultComposition(input) {
+    // Simple tasks → flat 2-agent team, complex → wave with planner
+    if (input.complexity === 'simple') {
+        return {
+            topology: 'flat',
+            roles: [
+                {
+                    role: 'executor',
+                    rationale: 'Execute the task directly',
+                    capabilities: ['task execution'],
+                    optional: false,
+                    modelTier: 'balanced',
+                    spawnAs: 'root',
+                },
+            ],
+            spawnRules: {},
+            enforcement: 'permissive',
+        };
+    }
+    const roles = [
+        {
+            role: 'planner',
+            rationale: 'Decompose and plan the work',
+            capabilities: ['planning', 'decomposition'],
+            optional: false,
+            modelTier: 'capable',
+            spawnAs: 'root',
+        },
+        {
+            role: 'executor',
+            rationale: 'Execute planned tasks',
+            capabilities: ['task execution'],
+            optional: false,
+            modelTier: 'balanced',
+            spawnAs: 'companion',
+        },
+    ];
+    if (input.complexity === 'complex' || input.complexity === 'epic') {
+        roles.push({
+            role: 'reviewer',
+            rationale: 'Verify completed work',
+            capabilities: ['review', 'verification'],
+            optional: true,
+            modelTier: 'capable',
+            spawnAs: 'on-demand',
+        });
+    }
+    return {
+        topology: input.complexity === 'epic' ? 'hierarchical' : 'wave',
+        roles,
+        spawnRules: { planner: ['executor', 'reviewer'] },
+        enforcement: 'permissive',
+    };
+}
+function defaultCoordination(input) {
+    return {
+        executionModel: input.complexity === 'simple'
+            ? 'sequential'
+            : 'wave-parallel',
+        channels: [],
+        interactionPatterns: [],
+        delegationStrategy: 'auto',
+    };
+}
+// ============================================================
+// YAML export
+// ============================================================
+function compositionToYaml(rec) {
+    const lines = [
+        '# Team configuration generated by cognitive-core',
+        `# Confidence: ${rec.confidence.toFixed(2)}`,
+        '',
+        'team:',
+        `  topology: ${rec.composition.topology}`,
+        `  enforcement: ${rec.composition.enforcement}`,
+        '',
+        '  roles:',
+    ];
+    for (const role of rec.composition.roles) {
+        lines.push(`    - name: ${role.role}`);
+        lines.push(`      rationale: "${role.rationale}"`);
+        lines.push(`      optional: ${role.optional}`);
+        if (role.modelTier) {
+            lines.push(`      model_tier: ${role.modelTier}`);
+        }
+        lines.push(`      spawn_as: ${role.spawnAs}`);
+        if (role.capabilities.length > 0) {
+            lines.push(`      capabilities:`);
+            for (const cap of role.capabilities) {
+                lines.push(`        - ${cap}`);
+            }
+        }
+    }
+    if (Object.keys(rec.composition.spawnRules).length > 0) {
+        lines.push('');
+        lines.push('  spawn_rules:');
+        for (const [parent, children] of Object.entries(rec.composition.spawnRules)) {
+            lines.push(`    ${parent}: [${children.join(', ')}]`);
+        }
+    }
+    lines.push('');
+    lines.push('  coordination:');
+    lines.push(`    execution_model: ${rec.coordination.executionModel}`);
+    lines.push(`    delegation_strategy: ${rec.coordination.delegationStrategy}`);
+    if (rec.coordination.channels.length > 0) {
+        lines.push('    channels:');
+        for (const ch of rec.coordination.channels) {
+            lines.push(`      - name: ${ch.name}`);
+            lines.push(`        signals: [${ch.signals.join(', ')}]`);
+            lines.push(`        subscribers: [${ch.subscribers.join(', ')}]`);
+            lines.push(`        emitters: [${ch.emitters.join(', ')}]`);
+        }
+    }
+    if (rec.coordination.interactionPatterns.length > 0) {
+        lines.push('    interaction_patterns:');
+        for (const pat of rec.coordination.interactionPatterns) {
+            lines.push(`      - name: ${pat.name}`);
+            lines.push(`        roles: [${pat.roles.join(', ')}]`);
+            lines.push(`        frequency: ${pat.frequency}`);
+        }
+    }
+    if (rec.coordination.checkpoints && rec.coordination.checkpoints.length > 0) {
+        lines.push('    checkpoints:');
+        for (const cp of rec.coordination.checkpoints) {
+            lines.push(`      - ${cp}`);
+        }
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+// ============================================================
+// Team Router
+// ============================================================
+export class TeamRouter {
+    memory;
+    config;
+    metaLearner;
+    constructor(memory, config, metaLearner) {
+        this.memory = memory;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.metaLearner = metaLearner;
+    }
+    /**
+     * Set the team meta learner (can be set after construction).
+     */
+    setMetaLearner(metaLearner) {
+        this.metaLearner = metaLearner;
+    }
+    /**
+     * Recommend a team composition for a given task.
+     */
+    async recommend(input) {
+        // 1. Find matching team playbooks
+        const playbookMatches = await this.memory.findMatchingTeamPlaybooks({
+            taskType: input.description,
+            domain: input.domain,
+            complexity: input.complexity,
+            topology: input.constraints?.preferredTopology,
+            k: this.config.maxCandidates,
+        });
+        // 2. Compute base recommendation
+        let recommendation = this.computeBaseRecommendation(input, playbookMatches);
+        // 3. Apply constraints
+        recommendation = this.applyConstraints(recommendation, input);
+        // 4. Attach role playbooks for each recommended role
+        const rolePlaybooks = await this.findRolePlaybooks(recommendation, input);
+        recommendation.rolePlaybooks = rolePlaybooks;
+        // 5. Apply meta-learning adjustments
+        if (this.metaLearner) {
+            try {
+                recommendation = await this.metaLearner.adjustRecommendation(recommendation, input);
+            }
+            catch (error) {
+                console.error('[TeamRouter] Meta-learning adjustment failed, using base recommendation:', error instanceof Error ? error.message : String(error));
+            }
+        }
+        return recommendation;
+    }
+    /**
+     * Compute base recommendation from playbook matches.
+     */
+    computeBaseRecommendation(input, playbookMatches) {
+        // Filter to playbooks above minimum confidence
+        const viable = playbookMatches.filter((m) => m.playbook.confidence >= this.config.minPlaybookConfidence);
+        if (viable.length > 0) {
+            // Use the best matching playbook
+            const best = viable[0];
+            const rec = {
+                playbook: best.playbook,
+                composition: best.playbook.composition,
+                coordination: best.playbook.coordination,
+                rolePlaybooks: [],
+                confidence: Math.min(best.score * best.playbook.confidence, 0.95),
+                reasoning: `Matched team playbook "${best.playbook.name}" (score: ${best.score.toFixed(2)}, confidence: ${best.playbook.confidence.toFixed(2)})`,
+                appliedMetaStrategies: [],
+            };
+            return { ...rec, asTeamYaml: () => compositionToYaml(rec) };
+        }
+        // No viable playbook — build a default recommendation
+        const composition = defaultComposition(input);
+        const coordination = defaultCoordination(input);
+        const rec = {
+            composition,
+            coordination,
+            rolePlaybooks: [],
+            confidence: 0.3,
+            reasoning: 'No matching team playbook found; using default composition based on complexity',
+            appliedMetaStrategies: [],
+        };
+        return { ...rec, asTeamYaml: () => compositionToYaml(rec) };
+    }
+    /**
+     * Apply user constraints to the recommendation.
+     */
+    applyConstraints(recommendation, input) {
+        const constraints = input.constraints;
+        if (!constraints)
+            return recommendation;
+        let modified = false;
+        const reasons = [];
+        // Apply max agents constraint
+        if (constraints.maxAgents &&
+            recommendation.composition.roles.length > constraints.maxAgents) {
+            // Keep only essential (non-optional) roles, then trim to fit
+            const essential = recommendation.composition.roles.filter((r) => !r.optional);
+            const optional = recommendation.composition.roles.filter((r) => r.optional);
+            let roles;
+            if (essential.length >= constraints.maxAgents) {
+                roles = essential.slice(0, constraints.maxAgents);
+            }
+            else {
+                const remaining = constraints.maxAgents - essential.length;
+                roles = [...essential, ...optional.slice(0, remaining)];
+            }
+            recommendation = {
+                ...recommendation,
+                composition: { ...recommendation.composition, roles },
+            };
+            reasons.push(`Trimmed to ${constraints.maxAgents} agents`);
+            modified = true;
+        }
+        // Apply preferred topology
+        if (constraints.preferredTopology &&
+            recommendation.composition.topology !== constraints.preferredTopology) {
+            recommendation = {
+                ...recommendation,
+                composition: {
+                    ...recommendation.composition,
+                    topology: constraints.preferredTopology,
+                },
+            };
+            reasons.push(`Topology set to ${constraints.preferredTopology}`);
+            modified = true;
+        }
+        if (modified) {
+            recommendation.reasoning += `. Constraints applied: ${reasons.join('; ')}`;
+            // Slightly lower confidence when constraints override
+            recommendation.confidence = Math.max(0.15, recommendation.confidence * 0.9);
+            // Rebuild asTeamYaml with updated data
+            const rec = recommendation;
+            recommendation.asTeamYaml = () => compositionToYaml(rec);
+        }
+        return recommendation;
+    }
+    /**
+     * Find role playbooks for each role in the recommendation.
+     */
+    async findRolePlaybooks(recommendation, input) {
+        const rolePlaybooks = [];
+        for (const roleSpec of recommendation.composition.roles) {
+            const matches = await this.memory.findMatchingRolePlaybooks({
+                role: roleSpec.role,
+                topology: recommendation.composition.topology,
+                domain: input.domain,
+                taskType: input.description,
+                k: this.config.maxRolePlaybooksPerRole,
+            });
+            for (const match of matches) {
+                rolePlaybooks.push(match.playbook);
+            }
+        }
+        return rolePlaybooks;
+    }
+    /**
+     * Update configuration.
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+}
+/**
+ * Create a TeamRouter instance.
+ */
+export function createTeamRouter(memory, config, metaLearner) {
+    return new TeamRouter(memory, config, metaLearner);
+}
+//# sourceMappingURL=team-router.js.map

package/dist/search/team-router.js.map

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

package/dist/session-bank/git-reader.d.ts

@@ -0,0 +1,39 @@
+export interface GitReaderOptions {
+    repoPath: string;
+    branch?: string;
+}
+export declare class EntireGitReader {
+    private repoPath;
+    private branch;
+    constructor(options: GitReaderOptions);
+    /** Check if the orphan branch exists in this repo */
+    branchExists(): Promise<boolean>;
+    /**
+     * List all checkpoint directories.
+     * Returns paths like ["a3/b2c4d5e6f7", "f1/0a9b8c7d6e5f", ...]
+     */
+    listCheckpoints(): Promise<string[]>;
+    /**
+     * List session subdirectories within a checkpoint.
+     * Returns numeric session indices like ["0", "1"].
+     */
+    listSessions(checkpointPath: string): Promise<string[]>;
+    /** Read a single file from the orphan branch */
+    readFile(path: string): Promise<string>;
+    /**
+     * Read multiple files in batch.
+     * Returns Map<path, content>. Missing files are omitted.
+     */
+    readFiles(paths: string[]): Promise<Map<string, string>>;
+    /** Read a file, returning null if it doesn't exist */
+    readFileOrNull(path: string): Promise<string | null>;
+    /** Get the HEAD commit SHA of the orphan branch */
+    getBranchHead(): Promise<string | null>;
+    /**
+     * Find the Entire-Checkpoint trailer value for a given commit.
+     * Returns the checkpoint ID or null.
+     */
+    getCheckpointTrailer(commitSha: string): Promise<string | null>;
+    private git;
+}
+//# sourceMappingURL=git-reader.d.ts.map

package/dist/session-bank/git-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-reader.d.ts","sourceRoot":"","sources":["../../src/session-bank/git-reader.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,gBAAgB;IAKrC,qDAAqD;IAC/C,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAStC;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAyC1C;;;OAGG;IACG,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwB7D,gDAAgD;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7C;;;OAGG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAoB9D,sDAAsD;IAChD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQ1D,mDAAmD;IAC7C,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAS7C;;;OAGG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiBrE,OAAO,CAAC,GAAG;CAgBZ"}