@aitne/daemon 0.1.0

package/dist/core/management-md.d.ts

@@ -0,0 +1,186 @@
+import type Database from "better-sqlite3";
+import { type BackendId, type IntegrationKey, type IntegrationState } from "@aitne/shared";
+import { type IntegrationsRecord } from "../db/integrations-store.js";
+/**
+ * Integration Delegation Framework — `integrations.md` render + parse + watch
+ * (Phase 1).
+ *
+ * `integrations.md` lives at `<dataDir>/integrations.md` (top-level, alongside
+ * `.env` and `data.db`). It is the human-editable view of the integrations
+ * map; the DB (`settings` table, key `"integrations"`) is the authoritative
+ * source for the daemon.
+ *
+ * Write paths:
+ *   - `PATCH /api/integrations/:key` → DB update → `renderManagementMd()`
+ *     rewrites the file.
+ *   - User hand-edits → chokidar fires → `parseManagementMd()` → DB update.
+ *
+ * Self-write suppression: every file write through `writeManagementMd()`
+ * stamps the absolute path in a module-scoped Set cleared on the next tick.
+ * The watcher checks this before re-parsing, so the PATCH-then-rewrite
+ * flow doesn't loop back into itself.
+ *
+ * The file is fully idempotent: booting re-renders it from the DB state
+ * unconditionally, so hand-edits that round-trip cleanly through the
+ * parser produce identical bytes on the next render (no churn).
+ */
+export declare function getManagementMdPath(dataDir: string): string;
+export declare function getLegacyManagementMdPath(dataDir: string): string;
+export type LegacyManagementMdMigrationResult = {
+    migrated: true;
+    from: string;
+    to: string;
+} | {
+    migrated: false;
+    from: string;
+    to: string;
+    reason: "legacy_missing" | "target_exists";
+};
+/**
+ * One-shot compatibility migration for installs that predate the
+ * `integrations.md` rename. If both files exist, keep `integrations.md` as
+ * authoritative and leave the legacy file untouched for manual inspection.
+ */
+export declare function migrateLegacyManagementMd(dataDir: string): LegacyManagementMdMigrationResult;
+/**
+ * SETUP-FLOW-REDESIGN-PLAN §6.2 — declarative "where do the user's notes
+ * live" routing for the agent. The body is regenerated from the
+ * integrations record (notion mode + delegated backend) plus runtime
+ * settings (`externalObsidianVaultPath`, `externalObsidianWatch`). The
+ * file remains a renderer-only surface — `parseManagementMd` ignores
+ * this section and hand-edits are silently overwritten on the next
+ * render, matching the read-only contract used by the connector-support
+ * snapshot.
+ */
+export interface NoteSourcesInput {
+    externalObsidianVaultPath: string | null;
+    externalObsidianWatch: boolean;
+}
+export declare function renderNoteSourcesSection(integrations: IntegrationsRecord, notes: NoteSourcesInput): string;
+export declare function renderManagementMd(integrations: IntegrationsRecord, notes?: NoteSourcesInput): string;
+export interface ParsedCurrentStateRow {
+    key: string;
+    mode: string;
+    backend: string;
+    lastChanged: string;
+}
+export interface ParseResult {
+    ok: boolean;
+    /** Validated per-key states, keyed by recognized IntegrationKey only. */
+    integrations: Partial<Record<IntegrationKey, IntegrationState>>;
+    /** Non-fatal issues (unknown keys, malformed rows) — logged, not an abort. */
+    warnings: string[];
+    /** Fatal issues (invalid mode value, missing column) — caller should revert. */
+    errors: string[];
+}
+/**
+ * Parse the "Current state" table from an `integrations.md` body. Free prose,
+ * `Modes`, `Active today`, `Planned`, and the connector-support snapshot are
+ * all ignored — the Current-state table is authoritative. `Last changed` is
+ * written by the daemon; user edits to that column are tolerated and
+ * preserved only when valid ISO-8601.
+ */
+export declare function parseManagementMd(body: string): ParseResult;
+/**
+ * Write the rendered body to disk, creating parent directories if needed.
+ * Stamps the path as a self-write so the watcher skips the resulting event.
+ *
+ * `notes` is optional for backward compatibility — callers that have not
+ * yet been wired to surface external-vault state pass nothing and the
+ * section renders the "—" placeholder. The dashboard config PATCH
+ * handler is wired (SETUP-FLOW-REDESIGN-PLAN §6.2) so any user edit
+ * round-trips through the proper inputs.
+ */
+export declare function writeManagementMd(dataDir: string, integrations: IntegrationsRecord, notes?: NoteSourcesInput): Promise<string>;
+/**
+ * Read + parse the file from disk. Returns `null` when the file does not
+ * exist — callers treat that as "first run, write defaults and move on".
+ */
+export declare function readAndParseManagementMd(dataDir: string): Promise<ParseResult | null>;
+export interface ManagementMdBootResult {
+    path: string;
+    /** True if the file was missing and just created from DB state. */
+    created: boolean;
+    /** Integrations record after reconciliation with any user-edited file. */
+    integrations: IntegrationsRecord;
+    /** Delegated flips rejected for missing variants (§4.7). */
+    rejections: VariantRejection[];
+}
+/**
+ * First-start reconciliation:
+ *   1. If the file is missing → render it from the DB and return.
+ *   2. If the file is present and parses clean → merge user-visible fields
+ *      (mode + delegatedBackend) back into the DB. Any delegated flip
+ *      whose required variant files are missing is reverted per
+ *      `enforceVariantAvailability` (§4.7 symmetry with the PATCH edge).
+ *      Then re-render so daemon-owned columns (lastChanged adjustments,
+ *      reverted rows) round-trip cleanly.
+ *   3. If parse fails → log, leave the DB alone, re-render from DB so the
+ *      file moves back to a known-good state. The owner-DM branch is
+ *      Phase 2+; for now we only log.
+ */
+export declare function bootstrapManagementMd(dataDir: string, db: Database.Database, workspaceDir?: string, notes?: NoteSourcesInput): Promise<ManagementMdBootResult>;
+export interface VariantRejection {
+    key: IntegrationKey;
+    backend: BackendId;
+    missing: string[];
+}
+/**
+ * §4.7 "Missing-variant policy" enforcement on the integrations.md side.
+ *
+ * For every delegated flip introduced by the merge, verify the target
+ * backend's skill + task-flow variants exist on disk. Any key with a
+ * missing variant is reverted to its previous DB state; accepted keys
+ * pass through untouched. The returned `rejections` list lets the caller
+ * log / DM / re-render to surface the rollback.
+ *
+ * This mirrors the 400 `missing_variants` response on
+ * `PATCH /api/integrations/:key` — both the API edge and the file-edit
+ * edge now refuse to commit a delegated state the agent would silently
+ * fall back out of.
+ */
+export declare function enforceVariantAvailability(merged: IntegrationsRecord, dbState: IntegrationsRecord, workspaceDir: string): {
+    filtered: IntegrationsRecord;
+    rejections: VariantRejection[];
+};
+export interface ManagementMdWatcherHandle {
+    stop(): Promise<void>;
+}
+export interface ManagementMdWatcherOptions {
+    /**
+     * Repo root — used to locate `agent-assets/skills/` and
+     * `agent-assets/task-flows/` for the §4.7 variant-availability check.
+     * When omitted, the check is a no-op (legacy behavior).
+     */
+    workspaceDir?: string;
+    /**
+     * Optional owner-DM hook. Called with the reverted-delegated-flip list
+     * whenever the watcher rejects a hand-edit. Leave undefined to skip;
+     * the log line is always written either way.
+     */
+    sendNotification?: (params: {
+        message: string;
+        notificationType?: string;
+        priority?: "low" | "normal" | "high";
+    }) => Promise<unknown>;
+    /**
+     * SETUP-FLOW-REDESIGN-PLAN §6.2 — live external-vault state. Each
+     * reconcile re-renders `integrations.md` with the current Note Sources
+     * section; the callback gives chokidar the latest values without us
+     * having to invalidate `AgentConfig` snapshots through the watcher.
+     * Returning null/true defaults preserves legacy boot behavior.
+     */
+    getNoteSources?: () => NoteSourcesInput;
+}
+/**
+ * Watch `integrations.md` for out-of-band edits and reconcile them into the
+ * DB. Self-writes stamped via `writeManagementMd()` are ignored; bad parses
+ * trigger a rewrite from the DB state.
+ *
+ * §4.7 symmetry: delegated flips whose skill or task-flow variant files
+ * are absent on disk are reverted to the previous DB state, the file is
+ * re-rendered to show the rollback, and (if `sendNotification` is wired)
+ * the owner gets a DM explaining which files need to be authored.
+ */
+export declare function startManagementMdWatcher(dataDir: string, db: Database.Database, options?: ManagementMdWatcherOptions): ManagementMdWatcherHandle;
+//# sourceMappingURL=management-md.d.ts.map

package/dist/core/management-md.d.ts.map

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