@aitne/daemon 0.1.0

package/dist/core/git-project-docs.d.ts

@@ -0,0 +1,77 @@
+import type Database from "better-sqlite3";
+import type { GitWatchedRepoSettingInput } from "../settings/runtime-settings.js";
+import type { GitEventClassification } from "../observers/git-event-classifier.js";
+export type GitRepoClassification = "project" | "repo-only";
+export type GitRepoCategory = "work" | "personal" | "research" | "client" | "other";
+export interface NormalizedGitWatchedRepo {
+    path: string;
+    slug: string;
+    classification: GitRepoClassification;
+    category: GitRepoCategory;
+    org?: string;
+    accountAlias?: string;
+    pollPriority: "high" | "normal";
+    /**
+     * Per-row poll cadence override (seconds). Null when the row should
+     * fall back to the global default.
+     */
+    pollIntervalSec?: number | null;
+    /**
+     * `owner/repo` for rows that have a GitHub side. Null for local-only rows,
+     * undefined for legacy test-only config inputs.
+     */
+    githubRepo?: string | null;
+    /**
+     * Stable id from the unified `repositories` table. Optional only for
+     * the legacy `gitRepos` (string-array) path, which post-cutover is
+     * exercised solely from tests; production callers always come through
+     * `selectGitWatchedRepos(db)` and carry an id.
+     */
+    repositoryId?: string;
+}
+/**
+ * Input shape for `normalizeGitWatchedRepos`. Production callers pass
+ * `{ gitWatchedRepos: selectGitWatchedRepos(db) }`. Tests retain the
+ * pre-cutover shape (including the legacy `gitRepos: string[]`
+ * fallback) so test-only paths don't churn — see
+ * `docs/design/appendices/unified-repositories.md` §3.4.
+ */
+export interface NormalizeGitWatchedReposInput {
+    gitWatchedRepos?: readonly GitWatchedRepoSettingInput[];
+    gitRepos?: readonly string[];
+}
+interface GitProjectScheduleDeps {
+    db: Database.Database;
+    dataDir: string;
+    workspaceDir: string;
+    now?: () => Date;
+}
+export interface QueueMissingGitProjectInitsOptions extends GitProjectScheduleDeps {
+    contextDir: string;
+    repos: NormalizedGitWatchedRepo[];
+}
+export interface QueueGitProjectUpdateOptions extends GitProjectScheduleDeps {
+    repo: NormalizedGitWatchedRepo;
+    event: Extract<GitEventClassification, {
+        kind: "observe";
+    }>;
+    debounceMinutes: number;
+}
+export declare function slugifyRepoPath(repoPath: string): string;
+export declare function normalizeGitWatchedRepos(input: NormalizeGitWatchedReposInput): NormalizedGitWatchedRepo[];
+export declare function repoDocContextFilePath(repo: NormalizedGitWatchedRepo): string;
+export declare function repoDocContextPath(repo: NormalizedGitWatchedRepo): string;
+export declare function repoDocTemplateName(repo: Pick<NormalizedGitWatchedRepo, "classification">): string;
+export declare function resolveGitProjectTemplateRoot(workspaceDir: string): string;
+export declare function seedGitProjectDocTemplates(dataDir: string, workspaceDir: string): void;
+export declare function readGitProjectDocTemplate(dataDir: string, workspaceDir: string, classification: GitRepoClassification): string;
+/**
+ * Bundled-only resolver — skips the `<dataDir>/templates/` override
+ * layer. Used by the dashboard's template editor to render the "bundled"
+ * column independently of whatever override the user may have written.
+ */
+export declare function readBundledGitProjectDocTemplate(workspaceDir: string, classification: GitRepoClassification): string;
+export declare function queueMissingGitProjectInits(options: QueueMissingGitProjectInitsOptions): number;
+export declare function queueGitProjectUpdate(options: QueueGitProjectUpdateOptions): "queued" | "merged" | "debounced" | "skipped";
+export {};
+//# sourceMappingURL=git-project-docs.d.ts.map

package/dist/core/git-project-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-project-docs.d.ts","sourceRoot":"","sources":["../../src/core/git-project-docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAgB3C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAuBnF,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,WAAW,CAAC;AAC5D,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,UAAU,GACV,UAAU,GACV,QAAQ,GACR,OAAO,CAAC;AAEZ,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,qBAAqB,CAAC;IACtC,QAAQ,EAAE,eAAe,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,QAAQ,CAAC;IAChC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,6BAA6B;IAC5C,eAAe,CAAC,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACxD,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAED,UAAU,sBAAsB;IAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,kCAAmC,SAAQ,sBAAsB;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,wBAAwB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,4BAA6B,SAAQ,sBAAsB;IAC1E,IAAI,EAAE,wBAAwB,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC,sBAAsB,EAAE;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAC5D,eAAe,EAAE,MAAM,CAAC;CACzB;AAsFD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKxD;AAwBD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,6BAA6B,GACnC,wBAAwB,EAAE,CAkD5B;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,wBAAwB,GAAG,MAAM,CAE7E;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,wBAAwB,GAAG,MAAM,CAEzE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,wBAAwB,EAAE,gBAAgB,CAAC,GAAG,MAAM,CAIlG;AAED,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAmB1E;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,IAAI,CAcN;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,qBAAqB,GACpC,MAAM,CASR;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC9C,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,qBAAqB,GACpC,MAAM,CASR;AAwCD,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,kCAAkC,GAC1C,MAAM,CA+DR;AAMD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAyE/C"}

package/dist/core/git-project-docs.js

@@ -0,0 +1,439 @@
+import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync, } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { homedir } from "node:os";
+import { randomUUID } from "node:crypto";
+import { fileURLToPath } from "node:url";
+import { formatSqliteDatetime, parseSqliteUtcMs, } from "@aitne/shared";
+import { gitRepoJournalPath, gitRepoOverviewPath, gitRepoPath, projectPath, } from "./context-paths.js";
+import { createLogger } from "../logging.js";
+const logger = createLogger("git-project-docs");
+const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
+const PROJECT_TEMPLATE_NAME = "project.md";
+const GIT_REPO_TEMPLATE_NAME = "git-repo.md";
+/**
+ * Cap on `events` array carried in a pending `git.project.update` task_context.
+ * The array lands in the prompt verbatim; an unbounded array (a force-push /
+ * rebase loop within the debounce window) would erode the token budget. We
+ * keep the most recent N entries — a tag/merge that fired earlier and was
+ * displaced is still recoverable from `git log` / `git ls-remote --tags`,
+ * which the task-flow already permits.
+ */
+const MAX_PENDING_EVENT_SUMMARIES = 50;
+const FALLBACK_PROJECT_TEMPLATE = `---
+type: project
+owner: shared
+updated: {updated}
+slug: {repo_slug}
+category: {category}
+status: active
+org: {org}
+git_repo: {repo_path}
+default_branch: {default_branch}
+remote: {origin_url}
+account_alias: {account_alias}
+created: {first_commit_date}
+last_activity: {last_commit_date}
+---
+# {repo_name}
+
+## Overview
+- Purpose:
+- Current state:
+- Primary owner:
+
+## Git Activity
+- Last reviewed: {updated}
+- Default branch: {default_branch}
+- Remote: {origin_url}
+
+## Lifecycle Phases
+- Initial documentation created from Git history.
+
+## Notable Changes
+- Add durable project milestones and important merges here.
+
+## Open Threads
+- Add follow-ups that should remain visible across sessions.
+
+## History (compressed)
+- Summarize older activity here as the file grows.
+`;
+const FALLBACK_GIT_REPO_TEMPLATE = `---
+type: git-repo
+owner: shared
+updated: {updated}
+slug: {repo_slug}
+classification: repo-only
+git_repo: {repo_path}
+default_branch: {default_branch}
+remote: {origin_url}
+account_alias: {account_alias}
+last_activity: {last_commit_date}
+---
+# {repo_name}
+
+## Activity
+- Last reviewed: {updated}
+- Default branch: {default_branch}
+- Remote: {origin_url}
+
+## Recent Pushes
+- Add notable remote changes here.
+`;
+function expandHome(p) {
+    if (p.startsWith("~/") || p.startsWith("~\\")) {
+        return resolve(homedir(), p.slice(2));
+    }
+    return resolve(p);
+}
+export function slugifyRepoPath(repoPath) {
+    const trimmed = repoPath.replace(/[\\/]+$/g, "");
+    const segments = trimmed.split(/[\\/]+/).filter((s) => s.length > 0);
+    const name = (segments[segments.length - 1] ?? trimmed).replace(/\.git$/i, "");
+    return slugifySegment(name);
+}
+function slugifySegment(value) {
+    const slug = value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 80)
+        .replace(/-+$/g, "");
+    return slug || "repo";
+}
+function makeUniqueSlug(baseSlug, used) {
+    let candidate = baseSlug;
+    let suffix = 2;
+    while (used.has(candidate)) {
+        const suffixText = `-${suffix}`;
+        candidate = `${baseSlug.slice(0, Math.max(1, 80 - suffixText.length)).replace(/-+$/g, "")}${suffixText}`;
+        suffix++;
+    }
+    used.add(candidate);
+    return candidate;
+}
+export function normalizeGitWatchedRepos(input) {
+    const usedSlugs = new Set();
+    const explicitPaths = new Set();
+    const repos = [];
+    const add = (raw, legacyDefaults = {
+        classification: "repo-only",
+        category: "other",
+        pollPriority: "normal",
+    }) => {
+        const rawPath = typeof raw === "string" ? raw : raw.path;
+        const path = expandHome(rawPath);
+        const rawSlug = typeof raw === "string" ? undefined : raw.slug;
+        const slugBase = slugifySegment(rawSlug ?? slugifyRepoPath(path));
+        const isLegacy = typeof raw === "string";
+        repos.push({
+            path,
+            slug: makeUniqueSlug(slugBase, usedSlugs),
+            classification: isLegacy
+                ? legacyDefaults.classification
+                : raw.classification ?? legacyDefaults.classification,
+            category: isLegacy ? legacyDefaults.category : raw.category ?? legacyDefaults.category,
+            org: isLegacy ? undefined : raw.org,
+            accountAlias: isLegacy ? undefined : raw.accountAlias,
+            pollPriority: isLegacy
+                ? legacyDefaults.pollPriority
+                : raw.pollPriority ?? legacyDefaults.pollPriority,
+            pollIntervalSec: isLegacy ? null : raw.pollIntervalSec ?? null,
+            githubRepo: isLegacy ? null : raw.githubRepo ?? null,
+            repositoryId: isLegacy ? undefined : raw.repositoryId,
+        });
+        explicitPaths.add(path);
+    };
+    for (const repo of input.gitWatchedRepos ?? []) {
+        add(repo);
+    }
+    for (const legacyPath of input.gitRepos ?? []) {
+        const normalizedPath = expandHome(legacyPath);
+        if (explicitPaths.has(normalizedPath))
+            continue;
+        add(normalizedPath);
+    }
+    return repos;
+}
+export function repoDocContextFilePath(repo) {
+    return gitRepoOverviewPath(repo.slug);
+}
+export function repoDocContextPath(repo) {
+    return repoDocContextFilePath(repo).replace(/\.md$/, "");
+}
+export function repoDocTemplateName(repo) {
+    return repo.classification === "project"
+        ? PROJECT_TEMPLATE_NAME
+        : GIT_REPO_TEMPLATE_NAME;
+}
+export function resolveGitProjectTemplateRoot(workspaceDir) {
+    if (process.env.PA_GIT_PROJECT_TEMPLATES_DIR) {
+        return expandHome(process.env.PA_GIT_PROJECT_TEMPLATES_DIR);
+    }
+    const workspaceCandidate = join(workspaceDir, "agent-assets", "project-doc-templates");
+    if (existsSync(workspaceCandidate))
+        return workspaceCandidate;
+    return join(MODULE_DIR, "..", "..", "..", "..", "agent-assets", "project-doc-templates");
+}
+export function seedGitProjectDocTemplates(dataDir, workspaceDir) {
+    const templatesDir = join(dataDir, "templates");
+    mkdirSync(templatesDir, { recursive: true });
+    const bundledRoot = resolveGitProjectTemplateRoot(workspaceDir);
+    for (const name of [PROJECT_TEMPLATE_NAME, GIT_REPO_TEMPLATE_NAME]) {
+        const target = join(templatesDir, name);
+        if (existsSync(target))
+            continue;
+        const bundled = join(bundledRoot, name);
+        if (existsSync(bundled)) {
+            copyFileSync(bundled, target);
+        }
+        else {
+            writeFileSync(target, fallbackTemplateForName(name), "utf-8");
+        }
+    }
+}
+export function readGitProjectDocTemplate(dataDir, workspaceDir, classification) {
+    const name = classification === "project"
+        ? PROJECT_TEMPLATE_NAME
+        : GIT_REPO_TEMPLATE_NAME;
+    const userTemplate = join(dataDir, "templates", name);
+    if (existsSync(userTemplate)) {
+        return readFileSync(userTemplate, "utf-8");
+    }
+    return readBundledGitProjectDocTemplate(workspaceDir, classification);
+}
+/**
+ * Bundled-only resolver — skips the `<dataDir>/templates/` override
+ * layer. Used by the dashboard's template editor to render the "bundled"
+ * column independently of whatever override the user may have written.
+ */
+export function readBundledGitProjectDocTemplate(workspaceDir, classification) {
+    const name = classification === "project"
+        ? PROJECT_TEMPLATE_NAME
+        : GIT_REPO_TEMPLATE_NAME;
+    const bundled = join(resolveGitProjectTemplateRoot(workspaceDir), name);
+    if (existsSync(bundled)) {
+        return readFileSync(bundled, "utf-8");
+    }
+    return fallbackTemplateForName(name);
+}
+function fallbackTemplateForName(name) {
+    return name === PROJECT_TEMPLATE_NAME
+        ? FALLBACK_PROJECT_TEMPLATE
+        : FALLBACK_GIT_REPO_TEMPLATE;
+}
+function buildBaseTaskContext(repo, now) {
+    const overviewPath = repoDocContextFilePath(repo);
+    const journalPath = gitRepoJournalPath(repo.slug, now.toISOString().slice(0, 10));
+    const repository = {
+        id: repo.repositoryId ?? null,
+        slug: repo.slug,
+        localPath: repo.path,
+        githubRepo: repo.githubRepo ?? null,
+        classification: repo.classification,
+        category: repo.category,
+        org: repo.org ?? null,
+        accountAlias: repo.accountAlias ?? null,
+        pollPriority: repo.pollPriority,
+    };
+    return {
+        repository,
+        ...(repo.repositoryId ? { repositoryId: repo.repositoryId } : {}),
+        slug: repo.slug,
+        localPath: repo.path,
+        githubRepo: repo.githubRepo ?? null,
+        classification: repo.classification,
+        category: repo.category,
+        overviewPath,
+        journalPath,
+        lookbackHours: 24,
+        importance: "low",
+    };
+}
+export function queueMissingGitProjectInits(options) {
+    const now = options.now?.() ?? new Date();
+    let inserted = 0;
+    // Hoisted out of the loop: GitWatcher.start() fires `onRepoBaseline` once
+    // per repo and each callback invokes this function over every repo, so
+    // a per-iteration query was N² across baseline fan-out. Pending/running
+    // paths for `task_type='git.project.init'` are repo-scoped and do not
+    // change between iterations except via `insert.run` below — track newly
+    // inserted repo paths in a local set instead of re-reading the DB.
+    const existingRepoKeys = new Set(options.db
+        .prepare(`SELECT task_context
+             FROM agent_schedule
+            WHERE task_type = 'git.project.init'
+              AND status IN ('pending', 'running')`)
+        .all()
+        .flatMap((row) => scheduleRepoKeys(parseTaskContext(row.task_context))));
+    const insert = options.db.prepare(`INSERT INTO agent_schedule
+       (scheduled_for, task_type, task_description, task_context, correlation_id, model, status)
+     VALUES (?, 'git.project.init', ?, ?, ?, NULL, 'pending')`);
+    for (const repo of options.repos) {
+        const contextFile = repoDocContextFilePath(repo);
+        if (existsSync(join(options.contextDir, contextFile)))
+            continue;
+        const legacyFile = legacyClassificationFilePaths(repo).find((file) => existsSync(join(options.contextDir, file)));
+        if (legacyFile) {
+            logger.warn({
+                repo: repo.path,
+                slug: repo.slug,
+                classification: repo.classification,
+                legacyFile,
+                target: contextFile,
+            }, "Legacy git project context file exists; unified repository init will create git/<slug>/overview.md and leave the legacy file in place");
+        }
+        if (hasExistingScheduleForRepo(existingRepoKeys, repo))
+            continue;
+        const taskContext = {
+            triggerSource: "git_watcher_baseline",
+            processKey: "git.project.init",
+            ...buildBaseTaskContext(repo, now),
+        };
+        insert.run(formatSqliteDatetime(now), `Initialize git project documentation for ${repo.slug}.`, JSON.stringify(taskContext), randomUUID());
+        addScheduleKeysForRepo(existingRepoKeys, repo);
+        inserted++;
+    }
+    return inserted;
+}
+function legacyClassificationFilePaths(repo) {
+    return [projectPath(repo.slug), gitRepoPath(repo.slug)];
+}
+export function queueGitProjectUpdate(options) {
+    if (!shouldScheduleGitProjectUpdate(options.event)) {
+        return "skipped";
+    }
+    const now = options.now?.() ?? new Date();
+    const rows = options.db.prepare(`SELECT id, scheduled_for, task_context, status
+       FROM agent_schedule
+      WHERE task_type = 'git.project.update'
+        AND status IN ('pending', 'running', 'completed')
+      ORDER BY id DESC
+      LIMIT 50`).all();
+    const matching = rows
+        .map((row) => ({ row, ctx: parseTaskContext(row.task_context) }))
+        .filter(({ ctx }) => matchesScheduleForRepo(ctx, options.repo));
+    if (matching.some(({ row }) => row.status === "running")) {
+        return "debounced";
+    }
+    const pending = matching.find(({ row }) => row.status === "pending");
+    const eventSummary = summarizeGitProjectEvent(options.event, now);
+    if (pending) {
+        const nextContext = mergeGitProjectEvent(pending.ctx, options.repo, now, eventSummary);
+        const result = options.db.prepare(`UPDATE agent_schedule
+          SET task_context = ?
+        WHERE id = ? AND status = 'pending'`).run(JSON.stringify(nextContext), pending.row.id);
+        if (result.changes > 0) {
+            return "merged";
+        }
+        // Race: the scheduler claimed the pending row between the SELECT and the
+        // UPDATE (status flipped to 'running'). The running session now carries
+        // the pre-merge context; if we returned here the new event would be
+        // silently lost (`recentlyCompleted` would short-circuit any later
+        // attempt within the debounce window). Fall through to insert a fresh
+        // pending row so the next debounce window re-runs with this event.
+    }
+    const cutoffMs = now.getTime() - options.debounceMinutes * 60_000;
+    const recentlyCompleted = matching.some(({ row }) => row.status === "completed" && parseSqliteUtcMs(row.scheduled_for) >= cutoffMs);
+    if (recentlyCompleted) {
+        return "debounced";
+    }
+    const taskContext = {
+        triggerSource: "git_watcher_lifecycle",
+        processKey: "git.project.update",
+        ...buildBaseTaskContext(options.repo, now),
+        events: [eventSummary],
+    };
+    options.db.prepare(`INSERT INTO agent_schedule
+       (scheduled_for, task_type, task_description, task_context, correlation_id, model, status)
+     VALUES (?, 'git.project.update', ?, ?, ?, NULL, 'pending')`).run(formatSqliteDatetime(now), `Update git project documentation for ${options.repo.slug}.`, JSON.stringify(taskContext), randomUUID());
+    return "queued";
+}
+function parseTaskContext(raw) {
+    if (!raw)
+        return {};
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed)
+            ? parsed
+            : {};
+    }
+    catch (err) {
+        logger.debug({ err }, "Failed to parse git project schedule context");
+        return {};
+    }
+}
+function shouldScheduleGitProjectUpdate(event) {
+    if (event.eventType === "git.merge_to_default" || event.eventType === "git.tag.created") {
+        return true;
+    }
+    if (event.eventType !== "git.push.detected")
+        return false;
+    const branch = event.payload.branch;
+    const defaultBranch = event.payload.defaultBranch;
+    return (typeof branch === "string"
+        && typeof defaultBranch === "string"
+        && branch === defaultBranch);
+}
+function summarizeGitProjectEvent(event, now) {
+    return {
+        eventType: event.eventType,
+        ref: event.ref,
+        payload: event.payload,
+        observedAt: now.toISOString(),
+    };
+}
+function mergeGitProjectEvent(existing, repo, now, event) {
+    const base = {
+        triggerSource: "git_watcher_lifecycle",
+        processKey: "git.project.update",
+        ...buildBaseTaskContext(repo, now),
+        ...existing,
+    };
+    const currentEvents = Array.isArray(existing.events)
+        ? existing.events.filter(isGitProjectEventSummary)
+        : [];
+    const alreadyPresent = currentEvents.some((item) => item.eventType === event.eventType && item.ref === event.ref);
+    const merged = alreadyPresent ? currentEvents : [...currentEvents, event];
+    // Cap the array — a force-push / rebase loop within a 15min debounce
+    // window can accumulate dozens of summaries, and the array lands in the
+    // prompt as JSON. Drop the oldest first; the agent re-reads `git log`
+    // for definitive history anyway.
+    const capped = merged.length > MAX_PENDING_EVENT_SUMMARIES
+        ? merged.slice(merged.length - MAX_PENDING_EVENT_SUMMARIES)
+        : merged;
+    return { ...base, events: capped };
+}
+function scheduleRepoKeys(ctx) {
+    return [
+        typeof ctx.repositoryId === "string" ? ctx.repositoryId : null,
+        typeof ctx.localPath === "string" ? ctx.localPath : null,
+        typeof ctx.repoPath === "string" ? ctx.repoPath : null,
+    ].filter((value) => Boolean(value));
+}
+function hasExistingScheduleForRepo(keys, repo) {
+    return ((repo.repositoryId ? keys.has(repo.repositoryId) : false)
+        || keys.has(repo.path));
+}
+function addScheduleKeysForRepo(keys, repo) {
+    if (repo.repositoryId)
+        keys.add(repo.repositoryId);
+    keys.add(repo.path);
+}
+function matchesScheduleForRepo(ctx, repo) {
+    if (repo.repositoryId && ctx.repositoryId === repo.repositoryId)
+        return true;
+    return ctx.localPath === repo.path || ctx.repoPath === repo.path;
+}
+function isGitProjectEventSummary(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const record = value;
+    return (typeof record.eventType === "string"
+        && typeof record.ref === "string"
+        && typeof record.observedAt === "string"
+        && !!record.payload
+        && typeof record.payload === "object"
+        && !Array.isArray(record.payload));
+}
+//# sourceMappingURL=git-project-docs.js.map

package/dist/core/git-project-docs.js.map

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

package/dist/core/health-monitor.d.ts

@@ -0,0 +1,57 @@
+import type Database from "better-sqlite3";
+import type { AgentConfig } from "../config.js";
+import type { EventBus } from "./event-bus.js";
+import type { MessageHub } from "../adapters/message-hub.js";
+import type { ObserverManager } from "../observers/manager.js";
+export interface HealthStatus {
+    daemonUptime: number;
+    eventBusSize: number;
+    activeSessions: number;
+    dbConnected: boolean;
+    connectedPlatforms: string[];
+    registeredObservers: string[];
+    todaySessions: number;
+    todayCostUsd: number;
+    contextFilesOk: boolean;
+    missingContextFiles: string[];
+    lastCheckAt: string;
+}
+export interface HealthMonitorDependencies {
+    db: Database.Database;
+    config: AgentConfig;
+    eventBus: EventBus;
+    messageHub: MessageHub;
+    observerManager: ObserverManager;
+    startedAt: Date;
+}
+/**
+ * HealthMonitor splits two concerns that used to share a cache:
+ *  - `getStatus()` always returns a fresh `check()` so the dashboard
+ *    cannot see a snapshot from up to 5 minutes ago.
+ *  - The 5-min interval drives anomaly detection only, comparing each
+ *    tick against `anomalyBaseline` and emitting `health.anomaly` on
+ *    transitions (db lost, platform dropped, context file vanished).
+ */
+export declare class HealthMonitor {
+    private readonly db;
+    private readonly config;
+    private readonly eventBus;
+    private readonly messageHub;
+    private readonly observerManager;
+    private readonly startedAt;
+    private timer;
+    private anomalyBaseline;
+    /** Required context files (relative to context dir). B-007 §5.1. */
+    private static readonly REQUIRED_FILES;
+    constructor(deps: HealthMonitorDependencies);
+    start(): void;
+    stop(): void;
+    getStatus(): HealthStatus;
+    /** Run all health checks and return status */
+    check(): HealthStatus;
+    /** Compare previous and current status, emit events for anomalies.
+     *  Only emits on *transitions* (prev OK → curr bad) to avoid flooding. */
+    private detectAnomalies;
+    private emitAnomaly;
+}
+//# sourceMappingURL=health-monitor.d.ts.map

package/dist/core/health-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-monitor.d.ts","sourceRoot":"","sources":["../../src/core/health-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAI3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAO/D,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe,EAAE,eAAe,CAAC;IACjC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAO;IAEjC,OAAO,CAAC,KAAK,CAA+C;IAI5D,OAAO,CAAC,eAAe,CAA6B;IAEpD,oEAAoE;IACpE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAmC;gBAE7D,IAAI,EAAE,yBAAyB;IAS3C,KAAK,IAAI,IAAI;IAeb,IAAI,IAAI,IAAI;IAOZ,SAAS,IAAI,YAAY;IAIzB,8CAA8C;IAC9C,KAAK,IAAI,YAAY;IAoDrB;8EAC0E;IAC1E,OAAO,CAAC,eAAe;IAgCvB,OAAO,CAAC,WAAW;CAqBpB"}