@mandible-ai/mandible 0.2.0

package/dist/src/environments/github/adapter.js

@@ -0,0 +1,324 @@
+// PURPOSE: GitHub environment adapter — GitHub Issues as a stigmergy substrate
+// PURPOSE: Polling with ETag caching, concentration reinforcement, advisory claims
+import { matchesQuery, isClaimExpired } from '../../core/signal.js';
+import { validateSignalInput } from '../../core/validation.js';
+import { GitHubClient } from './client.js';
+import { defaultTypeMapper, defaultPayloadMapper, defaultConcentrationMapper, defaultDependencyMapper, computeDependencyBoosts, } from './mapper.js';
+export class GitHubEnvironment {
+    name;
+    config;
+    client;
+    typeMapper;
+    payloadMapper;
+    concentrationMapper;
+    dependencyMapper;
+    issueFilter;
+    decayRate;
+    concentrationFloor;
+    // In-memory signal cache — GitHub API is source of truth
+    signals = new Map();
+    withdrawn = new Map();
+    // Tracking for decay
+    lastSyncAt = Date.now();
+    lastDecayAt = Date.now();
+    initialized = false;
+    constructor(config) {
+        this.config = config;
+        this.name = config.name ?? `gh:${config.owner}/${config.repo}`;
+        this.client = new GitHubClient(config);
+        this.typeMapper = config.typeMapper ?? defaultTypeMapper;
+        this.payloadMapper = config.payloadMapper ?? defaultPayloadMapper;
+        this.concentrationMapper = config.concentrationMapper ?? defaultConcentrationMapper;
+        this.dependencyMapper = config.dependencyMapper ?? defaultDependencyMapper;
+        this.issueFilter = config.issueFilter;
+        this.decayRate = config.decayRate ?? 0.001;
+        this.concentrationFloor = config.concentrationFloor ?? 0.05;
+    }
+    // ----------------------------------------------------------
+    // Signal ID — deterministic mapping from issue number
+    // ----------------------------------------------------------
+    signalId(issueNumber) {
+        return `gh:${this.config.owner}/${this.config.repo}#${issueNumber}`;
+    }
+    issueNumberFromSignalId(signalId) {
+        const match = signalId.match(/#(\d+)$/);
+        return match ? parseInt(match[1], 10) : null;
+    }
+    // ----------------------------------------------------------
+    // Issue → Signal conversion
+    // ----------------------------------------------------------
+    issueToSignal(issue) {
+        const id = this.signalId(issue.number);
+        const type = this.typeMapper(issue);
+        const payload = this.payloadMapper(issue);
+        const concentration = this.concentrationMapper(issue, this.config);
+        const tags = issue.labels.map(l => l.name);
+        const signal = {
+            id,
+            type,
+            payload,
+            meta: {
+                deposited_at: new Date(issue.created_at).getTime(),
+                deposited_by: 'github',
+                concentration,
+                tags,
+            },
+        };
+        // Wire dependency edges via pluggable mapper
+        const depIds = this.dependencyMapper(issue, this.config);
+        if (depIds.length > 0) {
+            signal.meta.caused_by = depIds;
+        }
+        return signal;
+    }
+    // ----------------------------------------------------------
+    // Sync from GitHub API
+    // ----------------------------------------------------------
+    async ensureInit() {
+        if (this.initialized)
+            return;
+        await this.syncFromGitHub();
+        this.initialized = true;
+    }
+    /**
+     * Core sync method. Fetches issues from GitHub and updates local cache.
+     * Returns the list of new signal IDs that appeared since last sync.
+     */
+    async syncFromGitHub() {
+        const result = await this.client.fetchIssues();
+        // 304 Not Modified — no changes since last poll
+        if (result.issues === null) {
+            this.lastSyncAt = Date.now();
+            return [];
+        }
+        const newSignalIds = [];
+        const seenIds = new Set();
+        for (const issue of result.issues) {
+            // Skip pull requests (GitHub returns PRs in the issues endpoint)
+            if (issue.pull_request)
+                continue;
+            // Apply custom filter
+            if (this.issueFilter && !this.issueFilter(issue))
+                continue;
+            const freshSignal = this.issueToSignal(issue);
+            seenIds.add(freshSignal.id);
+            const existing = this.signals.get(freshSignal.id);
+            if (existing) {
+                // Reinforcement: take the max of current and fresh concentration
+                // Preserve claim state from local cache
+                freshSignal.meta.concentration = Math.max(existing.meta.concentration, freshSignal.meta.concentration);
+                freshSignal.meta.claimed_by = existing.meta.claimed_by;
+                freshSignal.meta.claimed_at = existing.meta.claimed_at;
+                freshSignal.meta.claim_lease = existing.meta.claim_lease;
+            }
+            else {
+                newSignalIds.push(freshSignal.id);
+            }
+            this.signals.set(freshSignal.id, freshSignal);
+        }
+        // Issues that disappeared from the API (closed externally) are NOT removed.
+        // They stop being reinforced and natural decay handles evaporation.
+        // This is the stigmergy way: absence of reinforcement = signal fades.
+        // Apply dependency-aware concentration adjustments (boosts and penalties)
+        const boosts = computeDependencyBoosts(this.signals, {
+            rootBoost: this.config.dependencyBoost?.rootBoost,
+            dependentBoost: this.config.dependencyBoost?.dependentBoost,
+            maxBoost: this.config.dependencyBoost?.maxBoost,
+            leafPenalty: this.config.dependencyBoost?.leafPenalty,
+        });
+        for (const [id, adjustment] of boosts) {
+            const signal = this.signals.get(id);
+            if (signal) {
+                signal.meta.concentration = Math.max(this.concentrationFloor, Math.min(1.0, signal.meta.concentration + adjustment));
+            }
+        }
+        this.lastSyncAt = Date.now();
+        return newSignalIds;
+    }
+    /**
+     * Public method to force a manual refresh. Useful for testing.
+     */
+    async sync() {
+        await this.syncFromGitHub();
+        this.initialized = true;
+    }
+    // ----------------------------------------------------------
+    // Environment interface implementation
+    // ----------------------------------------------------------
+    async observe(query) {
+        await this.ensureInit();
+        let matched = Array.from(this.signals.values()).filter(s => matchesQuery(s, query));
+        if (query.limit) {
+            matched = matched.slice(0, query.limit);
+        }
+        return matched;
+    }
+    async deposit(input) {
+        await this.ensureInit();
+        validateSignalInput(input);
+        if (this.config.allowDeposit === false) {
+            throw new Error('GitHubEnvironment: deposit (issue creation) is disabled via config');
+        }
+        // Create a real GitHub issue
+        const labels = input.meta?.tags ?? [];
+        const issue = await this.client.createIssue(input.payload.title ?? input.type, input.payload.body, labels);
+        const signal = this.issueToSignal(issue);
+        // Override with caller's meta if provided
+        if (input.meta?.deposited_by)
+            signal.meta.deposited_by = input.meta.deposited_by;
+        if (input.meta?.ttl)
+            signal.meta.ttl = input.meta.ttl;
+        if (input.meta?.caused_by)
+            signal.meta.caused_by = input.meta.caused_by;
+        if (input.meta?.concentration !== undefined)
+            signal.meta.concentration = input.meta.concentration;
+        this.signals.set(signal.id, signal);
+        return signal;
+    }
+    async withdraw(signalId) {
+        await this.ensureInit();
+        if (this.config.allowWithdraw === false) {
+            throw new Error('GitHubEnvironment: withdraw (issue closing) is disabled via config');
+        }
+        const issueNumber = this.issueNumberFromSignalId(signalId);
+        if (issueNumber !== null) {
+            await this.client.closeIssue(issueNumber);
+        }
+        const signal = this.signals.get(signalId);
+        if (signal) {
+            this.withdrawn.set(signalId, signal);
+            this.signals.delete(signalId);
+        }
+    }
+    async claim(signalId, claimant, leaseDuration = 60_000) {
+        await this.ensureInit();
+        const signal = this.signals.get(signalId);
+        if (!signal)
+            return false;
+        // Check existing claim
+        if (signal.meta.claimed_by) {
+            if (!isClaimExpired(signal)) {
+                return false; // Already claimed and not expired
+            }
+            // Expired claim — allow takeover
+        }
+        signal.meta.claimed_by = claimant;
+        signal.meta.claimed_at = Date.now();
+        signal.meta.claim_lease = leaseDuration;
+        return true;
+    }
+    async release(signalId) {
+        await this.ensureInit();
+        const signal = this.signals.get(signalId);
+        if (!signal)
+            return;
+        signal.meta.claimed_by = undefined;
+        signal.meta.claimed_at = undefined;
+        signal.meta.claim_lease = undefined;
+    }
+    watch(query, callback) {
+        const seen = new Set();
+        let active = true;
+        let pollTimer;
+        const pollInterval = this.config.pollInterval ?? 30_000;
+        const emitMatches = async () => {
+            if (!active)
+                return;
+            try {
+                const newIds = await this.syncFromGitHub();
+                if (!this.initialized)
+                    this.initialized = true;
+                for (const [id, signal] of this.signals) {
+                    if (!active)
+                        return;
+                    if (seen.has(id))
+                        continue;
+                    if (matchesQuery(signal, query)) {
+                        seen.add(id);
+                        callback(signal);
+                    }
+                }
+            }
+            catch {
+                // Swallow errors during poll — will retry next cycle
+            }
+        };
+        // Initial sync + emit
+        const setup = async () => {
+            await emitMatches();
+            if (!active)
+                return;
+            pollTimer = setInterval(emitMatches, pollInterval);
+        };
+        setup();
+        return {
+            unsubscribe() {
+                active = false;
+                if (pollTimer)
+                    clearInterval(pollTimer);
+            },
+        };
+    }
+    async history(query) {
+        await this.ensureInit();
+        const active = Array.from(this.signals.values());
+        let all = active;
+        if (query.includeWithdrawn) {
+            const withdrawnSignals = Array.from(this.withdrawn.values());
+            all = [...active, ...withdrawnSignals];
+        }
+        let matched = all.filter(s => matchesQuery(s, query));
+        if (query.limit)
+            matched = matched.slice(0, query.limit);
+        return matched;
+    }
+    async decay() {
+        await this.ensureInit();
+        const now = Date.now();
+        const result = { decayed: 0, evaporated: 0, claimsReleased: 0 };
+        // Elapsed since LAST DECAY (not last sync) — prevents quadratic compounding
+        const elapsedSeconds = (now - this.lastDecayAt) / 1000;
+        // Only apply concentration decay if meaningful time has passed
+        // (guards against multiple runtimes sharing this environment)
+        const shouldDecayConcentration = elapsedSeconds >= 0.1;
+        if (shouldDecayConcentration) {
+            this.lastDecayAt = now;
+        }
+        const decayAmount = shouldDecayConcentration ? this.decayRate * elapsedSeconds : 0;
+        for (const [id, signal] of this.signals) {
+            let changed = false;
+            // Always check claim lease expiration regardless of elapsed time
+            if (isClaimExpired(signal, now)) {
+                signal.meta.claimed_by = undefined;
+                signal.meta.claimed_at = undefined;
+                signal.meta.claim_lease = undefined;
+                result.claimsReleased++;
+                changed = true;
+            }
+            // Linear decay — same amount for all signals this sweep
+            const newConcentration = signal.meta.concentration - decayAmount;
+            if (newConcentration < this.concentrationFloor) {
+                // Below floor — evaporate
+                this.withdrawn.set(id, signal);
+                this.signals.delete(id);
+                result.evaporated++;
+                continue;
+            }
+            if (Math.abs(newConcentration - signal.meta.concentration) > 0.0001) {
+                signal.meta.concentration = newConcentration;
+                changed = true;
+                result.decayed++;
+            }
+            // We don't write to disk — in-memory cache only
+            if (changed) {
+                this.signals.set(id, signal);
+            }
+        }
+        return result;
+    }
+    async snapshot() {
+        await this.ensureInit();
+        return Array.from(this.signals.values());
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/src/environments/github/adapter.js.map

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

package/dist/src/environments/github/client.d.ts

@@ -0,0 +1,48 @@
+import type { GitHubIssue, GitHubEnvConfig } from './types.js';
+export interface RateLimitInfo {
+    remaining: number;
+    limit: number;
+    reset: number;
+}
+export interface FetchResult {
+    issues: GitHubIssue[] | null;
+    etag: string | null;
+    rateLimit: RateLimitInfo;
+}
+export declare class GitHubClient {
+    private readonly baseUrl;
+    private readonly owner;
+    private readonly repo;
+    private readonly token;
+    private readonly labels;
+    private _etag;
+    private _rateLimit;
+    constructor(config: GitHubEnvConfig);
+    get rateLimitInfo(): RateLimitInfo;
+    private headers;
+    private updateRateLimit;
+    /**
+     * Parse the Link header to get the next page URL.
+     * Format: <url>; rel="next", <url>; rel="last"
+     */
+    private parseNextLink;
+    /**
+     * Fetch open issues from the repository.
+     * Returns null if the server responds with 304 (no changes since last ETag).
+     * Handles pagination automatically for repos with >100 issues.
+     */
+    fetchIssues(): Promise<FetchResult>;
+    /**
+     * Create a new issue in the repository.
+     */
+    createIssue(title: string, body?: string, labels?: string[]): Promise<GitHubIssue>;
+    /**
+     * Close an issue by number.
+     */
+    closeIssue(issueNumber: number): Promise<void>;
+    /**
+     * Reset the stored ETag (forces a fresh fetch on next call).
+     */
+    resetETag(): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/src/environments/github/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/environments/github/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,aAAa,CAAC;CAC1B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,UAAU,CAA6D;gBAEnE,MAAM,EAAE,eAAe;IAQnC,IAAI,aAAa,IAAI,aAAa,CAEjC;IAED,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,eAAe;IAUvB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAMrB;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IA+DzC;;OAEG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,WAAW,CAAC;IAuBvB;;OAEG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBpD;;OAEG;IACH,SAAS,IAAI,IAAI;CAGlB"}

package/dist/src/environments/github/client.js

@@ -0,0 +1,151 @@
+// PURPOSE: Thin HTTP client for the GitHub Issues API
+// PURPOSE: ETag caching, pagination via Link header, rate limit tracking
+export class GitHubClient {
+    baseUrl;
+    owner;
+    repo;
+    token;
+    labels;
+    _etag = null;
+    _rateLimit = { remaining: 5000, limit: 5000, reset: 0 };
+    constructor(config) {
+        this.baseUrl = (config.apiBase ?? 'https://api.github.com').replace(/\/$/, '');
+        this.owner = config.owner;
+        this.repo = config.repo;
+        this.token = config.token ?? process.env.GITHUB_TOKEN;
+        this.labels = config.labels ?? [];
+    }
+    get rateLimitInfo() {
+        return { ...this._rateLimit };
+    }
+    headers(extraHeaders) {
+        const h = {
+            'Accept': 'application/vnd.github+json',
+            'User-Agent': 'mandible-stigmergy',
+            ...extraHeaders,
+        };
+        if (this.token) {
+            h['Authorization'] = `Bearer ${this.token}`;
+        }
+        return h;
+    }
+    updateRateLimit(headers) {
+        const remaining = headers.get('x-ratelimit-remaining');
+        const limit = headers.get('x-ratelimit-limit');
+        const reset = headers.get('x-ratelimit-reset');
+        if (remaining !== null)
+            this._rateLimit.remaining = parseInt(remaining, 10);
+        if (limit !== null)
+            this._rateLimit.limit = parseInt(limit, 10);
+        if (reset !== null)
+            this._rateLimit.reset = parseInt(reset, 10);
+    }
+    /**
+     * Parse the Link header to get the next page URL.
+     * Format: <url>; rel="next", <url>; rel="last"
+     */
+    parseNextLink(linkHeader) {
+        if (!linkHeader)
+            return null;
+        const match = linkHeader.match(/<([^>]+)>;\s*rel="next"/);
+        return match ? match[1] : null;
+    }
+    /**
+     * Fetch open issues from the repository.
+     * Returns null if the server responds with 304 (no changes since last ETag).
+     * Handles pagination automatically for repos with >100 issues.
+     */
+    async fetchIssues() {
+        const params = new URLSearchParams({
+            state: 'open',
+            per_page: '100',
+            sort: 'updated',
+            direction: 'desc',
+        });
+        if (this.labels.length > 0) {
+            params.set('labels', this.labels.join(','));
+        }
+        const url = `${this.baseUrl}/repos/${this.owner}/${this.repo}/issues?${params}`;
+        const extraHeaders = {};
+        if (this._etag) {
+            extraHeaders['If-None-Match'] = this._etag;
+        }
+        const response = await fetch(url, { headers: this.headers(extraHeaders) });
+        this.updateRateLimit(response.headers);
+        // 304 Not Modified — no changes
+        if (response.status === 304) {
+            return {
+                issues: null,
+                etag: this._etag,
+                rateLimit: this.rateLimitInfo,
+            };
+        }
+        if (!response.ok) {
+            throw new Error(`GitHub API error: ${response.status} ${response.statusText} for ${url}`);
+        }
+        // Store ETag for next request
+        const etag = response.headers.get('etag');
+        if (etag)
+            this._etag = etag;
+        let issues = await response.json();
+        // Handle pagination
+        let nextUrl = this.parseNextLink(response.headers.get('link'));
+        while (nextUrl) {
+            const pageResponse = await fetch(nextUrl, { headers: this.headers() });
+            this.updateRateLimit(pageResponse.headers);
+            if (!pageResponse.ok)
+                break;
+            const pageIssues = await pageResponse.json();
+            issues = issues.concat(pageIssues);
+            nextUrl = this.parseNextLink(pageResponse.headers.get('link'));
+        }
+        return {
+            issues,
+            etag: this._etag,
+            rateLimit: this.rateLimitInfo,
+        };
+    }
+    /**
+     * Create a new issue in the repository.
+     */
+    async createIssue(title, body, labels) {
+        const url = `${this.baseUrl}/repos/${this.owner}/${this.repo}/issues`;
+        const payload = { title };
+        if (body)
+            payload.body = body;
+        if (labels && labels.length > 0)
+            payload.labels = labels;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: this.headers({ 'Content-Type': 'application/json' }),
+            body: JSON.stringify(payload),
+        });
+        this.updateRateLimit(response.headers);
+        if (!response.ok) {
+            throw new Error(`GitHub API error creating issue: ${response.status} ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Close an issue by number.
+     */
+    async closeIssue(issueNumber) {
+        const url = `${this.baseUrl}/repos/${this.owner}/${this.repo}/issues/${issueNumber}`;
+        const response = await fetch(url, {
+            method: 'PATCH',
+            headers: this.headers({ 'Content-Type': 'application/json' }),
+            body: JSON.stringify({ state: 'closed' }),
+        });
+        this.updateRateLimit(response.headers);
+        if (!response.ok) {
+            throw new Error(`GitHub API error closing issue #${issueNumber}: ${response.status} ${response.statusText}`);
+        }
+    }
+    /**
+     * Reset the stored ETag (forces a fresh fetch on next call).
+     */
+    resetETag() {
+        this._etag = null;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/environments/github/client.js.map

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

package/dist/src/environments/github/index.d.ts

@@ -0,0 +1,5 @@
+export { GitHubEnvironment } from './adapter.js';
+export type { GitHubEnvConfig, GitHubIssue, ConcentrationMapper } from './types.js';
+export { defaultTypeMapper, defaultPayloadMapper, defaultConcentrationMapper, defaultDependencyMapper, parseDependencyIds, computeFreshness, parseGolemBody, } from './mapper.js';
+export type { GolemBodySections } from './mapper.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/environments/github/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/environments/github/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,EAC1B,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/environments/github/index.js

@@ -0,0 +1,5 @@
+// PURPOSE: Barrel export for the GitHub environment adapter
+// PURPOSE: Re-exports adapter, types, and mapper utilities
+export { GitHubEnvironment } from './adapter.js';
+export { defaultTypeMapper, defaultPayloadMapper, defaultConcentrationMapper, defaultDependencyMapper, parseDependencyIds, computeFreshness, parseGolemBody, } from './mapper.js';
+//# sourceMappingURL=index.js.map

package/dist/src/environments/github/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/environments/github/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,2DAA2D;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,EAC1B,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/src/environments/github/mapper.d.ts

@@ -0,0 +1,66 @@
+import type { GitHubIssue, GitHubEnvConfig } from './types.js';
+import type { Signal } from '../../core/types.js';
+/**
+ * Derives a signal type from issue labels.
+ * Priority order:
+ *   1. golem + tablet labels → 'golem:tablet'
+ *   2. First recognized category label → 'issue:{category}'
+ *   3. Fallback → 'issue:open'
+ */
+export declare function defaultTypeMapper(issue: GitHubIssue): string;
+export interface GolemBodySections {
+    acceptanceCriteria?: string[];
+    files?: string[];
+    dependencies?: string[];
+    risk?: string;
+    effort?: string;
+    description?: string;
+}
+/**
+ * Parse structured Golem tablet body markdown.
+ * Extracts sections like acceptance criteria, files, dependencies, risk/effort.
+ */
+export declare function parseGolemBody(body: string | null): GolemBodySections;
+/**
+ * Extract signal IDs from golem dependency strings.
+ * Recognizes beadId format: bd-{prefix}.{number} → gh:{owner}/{repo}#{number}
+ * Skips headers ("Blocked by:"), separators ("---"), and unrecognized text.
+ */
+export declare function parseDependencyIds(dependencies: string[], owner: string, repo: string): string[];
+/**
+ * Default dependency mapper — Golem-aware.
+ * Parses the Golem body's dependencies section for beadId references.
+ * Returns empty array for non-Golem issues or issues without dependencies.
+ */
+export declare function defaultDependencyMapper(issue: GitHubIssue, config: GitHubEnvConfig): string[];
+/**
+ * Extracts issue fields and parsed Golem body into a signal payload.
+ */
+export declare function defaultPayloadMapper(issue: GitHubIssue): Record<string, unknown>;
+/**
+ * Compute base freshness from issue updated_at.
+ * Returns 1.0 for just-updated issues, decays linearly to 0 at maxStaleHours.
+ */
+export declare function computeFreshness(issue: GitHubIssue, maxStaleHours: number, floor: number): number;
+/**
+ * Default concentration mapper using composite score:
+ *   base_freshness + comment_boost + assigned_boost + milestone_boost
+ *
+ * All data comes from the issue object — zero extra API calls.
+ */
+export declare function defaultConcentrationMapper(issue: GitHubIssue, config: GitHubEnvConfig): number;
+/**
+ * Compute concentration adjustments based on the dependency graph.
+ * Signals that unblock more downstream work get higher concentration.
+ * Leaf nodes (depend on others, nothing depends on them) get penalized.
+ *
+ * Returns positive values (boosts) and negative values (penalties).
+ * Does NOT mutate the input signals.
+ */
+export declare function computeDependencyBoosts(signals: Map<string, Signal>, options?: {
+    rootBoost?: number;
+    dependentBoost?: number;
+    maxBoost?: number;
+    leafPenalty?: number;
+}): Map<string, number>;
+//# sourceMappingURL=mapper.d.ts.map

package/dist/src/environments/github/mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../../../src/environments/github/mapper.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAMlD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAiB5D;AAMD,MAAM,WAAW,iBAAiB;IAChC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,CAqErE;AAMD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EAAE,EACtB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,MAAM,EAAE,CASV;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,eAAe,GACtB,MAAM,EAAE,CAQV;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyBhF;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAClB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,GACZ,MAAM,CAKR;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,eAAe,GACtB,MAAM,CAWR;AAMD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACjG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAyCrB"}