@aitne/daemon 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,136 @@
+import { z } from "zod";
+import { type RuntimeSettings } from "./settings/runtime-settings.js";
+import type Database from "better-sqlite3";
+declare const bootstrapConfigSchema: z.ZodObject<{
+    dataDir: z.ZodDefault<z.ZodString>;
+    workspaceDir: z.ZodDefault<z.ZodString>;
+    apiPort: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type BootstrapConfig = z.infer<typeof bootstrapConfigSchema>;
+export type AgentConfig = BootstrapConfig & RuntimeSettings;
+export declare function loadBootstrapConfig(): BootstrapConfig;
+export declare function loadDefaultRuntimeSettings(): RuntimeSettings;
+export declare function loadConfig(): AgentConfig;
+export declare function pickRuntimeSettings(config: AgentConfig): RuntimeSettings;
+export declare function mergeRuntimeSettingsFromDb(config: AgentConfig, persistedSettings: Partial<RuntimeSettings>): AgentConfig;
+/**
+ * Resolve the primary vault location on disk (plan §5.3).
+ *
+ * - `vaultMode === "obsidian"` + `primaryVaultPath` set + daemon NOT in
+ *   degraded mode → returns the user-chosen path.
+ * - Otherwise → returns `<dataDir>/context`.
+ *
+ * Degraded-mode awareness is opt-in via the second argument: pass `db`
+ * to get the safe fallback behavior, omit it to get the mode-only
+ * resolution. Callers that read files for the agent (context-builder,
+ * health monitor, retention sweeps) should pass `db` — reading a stale
+ * primary vault during degraded mode is worse than reading the fallback
+ * because the primary may be an unmounted network share that throws
+ * ENOENT at every access. Callers that only need the configured target
+ * (e.g. the dashboard banner surfacing "your vault lives at…") pass
+ * nothing.
+ *
+ * Accepts either a full `AgentConfig` or a minimal `{ dataDir }` shape.
+ * The `Partial<...>` on the runtime slice keeps existing narrow callers
+ * (e.g. `system-reset.ts`) working while letting new code pass the full
+ * config to pick up the obsidian branch.
+ */
+export declare function getContextDir(config: Pick<BootstrapConfig, "dataDir"> & Partial<Pick<RuntimeSettings, "vaultMode" | "primaryVaultPath">>, db?: Database.Database): string;
+export type VaultValidationError = "not_absolute" | "path_traversal" | "overlaps_data_dir" | "overlaps_external_vault" | "system_path" | "parent_missing" | "not_directory" | "not_writable" | "overlaps_primary_vault";
+export interface VaultValidationResult {
+    ok: boolean;
+    error?: VaultValidationError;
+    message?: string;
+    fsInfo?: FsInfo;
+}
+export interface FsInfo {
+    caseSensitive: boolean;
+    network: boolean;
+    readonly: boolean;
+    isCloudSync: "icloud" | "dropbox" | "onedrive" | "gdrive" | null;
+}
+/**
+ * Inspect filesystem characteristics for a given path.
+ * All detections are best-effort and non-blocking; callers use this to
+ * surface an informational banner to the user (plan §4.3).
+ */
+export declare function getFsInfo(p: string): FsInfo;
+/**
+ * Validate a candidate primary-vault path per plan §4.1.
+ *
+ * Accepts a raw user-facing path string:
+ * - absolute paths (`/Users/me/Vault`)
+ * - `~/...` home-relative paths
+ *
+ * Relative paths are rejected before normalization so callers cannot
+ * accidentally turn `vault` into `<cwd>/vault` and persist it as if the
+ * user had chosen an absolute path.
+ */
+export interface ValidatePrimaryVaultPathOptions {
+    /**
+     * When true (default), the validator auto-creates the leaf directory if
+     * the parent exists. This matches the env-writer / startup semantics —
+     * the user is declaring this path IS the vault and the daemon should
+     * treat it as writable.
+     *
+     * When false, the validator is read-only: it checks reachability and
+     * writability but does NOT mkdir. This is what the 30-second health
+     * probe uses; without the flag the probe would silently re-create a
+     * vault directory the user just deleted.
+     */
+    autoCreate?: boolean;
+    /**
+     * When true, a missing leaf directory is treated as a valid candidate
+     * as long as its parent exists and is writable. Used by the Management
+     * Mode settings dialog, where the user may point at a brand-new target
+     * directory that should not be created until the migration actually
+     * runs. The health probe intentionally leaves this false so a deleted
+     * configured vault still degrades.
+     */
+    allowMissingLeaf?: boolean;
+    /**
+     * Whether to probe the filesystem for case sensitivity, network mount,
+     * cloud sync, etc. Default false because the probe writes a test file
+     * into the vault directory (minor pollution) and the result is rarely
+     * needed. Opt in at PATCH / setup time when the dashboard wants to
+     * surface an "iCloud sync detected" banner.
+     */
+    collectFsInfo?: boolean;
+}
+export declare function validatePrimaryVaultPath(rawPath: string, config: Pick<BootstrapConfig, "dataDir"> & Partial<Pick<RuntimeSettings, "externalObsidianVaultPath">>, options?: ValidatePrimaryVaultPathOptions): VaultValidationResult;
+/**
+ * Validate a candidate external Obsidian vault path per plan §4.2.
+ *
+ * Applies all primary-vault checks plus overlap with the primary vault
+ * itself — the external watcher must never observe agent writes.
+ */
+export declare function validateExternalObsidianVaultPath(rawPath: string, config: Pick<BootstrapConfig, "dataDir"> & Pick<RuntimeSettings, "primaryVaultPath">, options?: ValidatePrimaryVaultPathOptions): VaultValidationResult;
+/**
+ * Run one tick of the Management Mode health probe.
+ *
+ * Exposed as a testable named function so integration tests can simulate
+ * the 30-second timer without spinning up `setInterval`. Read-only by
+ * design: `autoCreate: false` means if the user deletes the vault
+ * directory, the probe flips to degraded rather than silently re-creating
+ * it. The degraded-mode banner then tells them what happened. Lifting
+ * degraded mode is intentionally stricter than "directory exists": the
+ * vault must also contain at least one canonical context marker so the
+ * daemon does not resume writes into an empty or wrong directory.
+ *
+ * Bootstrapping bypass: if `rules/management.md` doesn't exist yet, setup
+ * hasn't run; honoring a null primaryVaultPath would break the initial-DM
+ * setup flow (which writes via `/api/context/*`, gated by the 503
+ * middleware). Skip degraded-mode entirely until setup completes. This
+ * matches the CLAUDE.md intuition that `isAutonomousAllowed()` already
+ * treats pre-setup as a special state.
+ */
+export declare function runVaultHealthProbe(config: Pick<BootstrapConfig, "dataDir"> & Pick<RuntimeSettings, "vaultMode" | "primaryVaultPath">, db: Database.Database): {
+    action: "noop" | "entered" | "lifted";
+    reason?: string;
+};
+export declare function isRoadmapStale(contextDir: string, maxAgeDays?: number): boolean;
+export declare function getDbPath(config: Pick<BootstrapConfig, "dataDir">): string;
+export declare function getLogsDir(config: Pick<BootstrapConfig, "dataDir">): string;
+export declare function getTmpDir(config: Pick<BootstrapConfig, "dataDir">): string;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

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