@aitne/daemon 0.1.0

package/dist/core/context-paths.js

@@ -0,0 +1,241 @@
+import { join } from "node:path";
+/**
+ * Canonical path constants for the vault layout (B-007 §5.1, shipped).
+ * Every daemon module that references files inside `~/.personal-agent/context/`
+ * imports from here instead of hardcoding strings. The full tree is
+ * documented in `docs/design/06-memory.md`.
+ *
+ * Two layers:
+ *  - `CONTEXT_RELATIVE_PATHS` — relative paths for DB / API / wikilink uses
+ *    (no leading slash, kept stable across clean reinstall).
+ *  - Helper `fullPath(contextDir, relativePath)` — joins against runtime
+ *    `contextDir` (usually `~/.personal-agent/context`).
+ */
+export const CONTEXT_RELATIVE_PATHS = {
+    rootIndex: "_index.md",
+    today: "today.md",
+    yesterday: "yesterday.md",
+    roadmap: "roadmap.md",
+    contextIndex: "context-index.md",
+    user: {
+        index: "user/_index.md",
+        profile: "user/profile.md",
+        people: "user/people.md",
+        work: "user/work.md",
+        expertise: "user/expertise.md",
+        personal: "user/personal.md",
+        goals: "user/goals.md",
+    },
+    rules: {
+        index: "rules/_index.md",
+        management: "rules/management.md",
+        mcp: "rules/mcp.md",
+        journalFormat: "rules/journal-format.md",
+        journalExport: "rules/journal-export.md",
+        redaction: "rules/redaction.md",
+        policiesDir: "rules/policies",
+        policiesIndex: "rules/policies/_index.md",
+    },
+    routines: {
+        index: "routines/_index.md",
+        hourly: "routines/hourly.md",
+        morning: "routines/morning.md",
+        evening: "routines/evening.md",
+        weekly: "routines/weekly.md",
+        monthly: "routines/monthly.md",
+        customDir: "routines/custom",
+    },
+    projects: {
+        index: "projects/_index.md",
+        activeBase: "projects/_active.base",
+        dir: "projects",
+    },
+    /**
+     * @deprecated Legacy lightweight git-repo registry path. Replaced by the
+     * `git/<slug>/overview.md` layout (docs/design/appendices/unified-repositories.md
+     * §4.5). Kept as a const for transitional reads only — new writes go to
+     * `git/<slug>/`.
+     */
+    gitRepos: {
+        dir: "git-repos",
+    },
+    /**
+     * Unified repositories — per-repo project overview + per-day journal.
+     * See `docs/design/appendices/unified-repositories.md` §4.5.
+     */
+    git: {
+        dir: "git",
+    },
+    daily: { dir: "daily" },
+    weekly: { dir: "weekly" },
+    monthly: { dir: "monthly" },
+    dossiers: {
+        index: "dossiers/_index.md",
+        dir: "dossiers",
+    },
+    inbox: { dir: "inbox" },
+    agent: {
+        journal: "agent/journal.md",
+        scratchDir: "agent/scratch",
+    },
+};
+/**
+ * Directory names (no trailing slash) allowed under context/ for listing /
+ * validation. Used by API route whitelists and reinstall planner.
+ */
+export const CONTEXT_DIR_NAMES = [
+    "user",
+    "rules",
+    "rules/policies",
+    "routines",
+    "routines/custom",
+    "projects",
+    "git-repos",
+    "git",
+    "daily",
+    "weekly",
+    "monthly",
+    "dossiers",
+    "inbox",
+    "agent",
+    "agent/scratch",
+];
+/**
+ * File types permitted inside context/. `.md` for all human-editable prose;
+ * `.base` for Obsidian Bases views (B-007 §11).
+ */
+export const CONTEXT_FILE_EXTENSIONS = [".md", ".base"];
+/**
+ * Relative paths that are stored on disk as `.base` files. The context API
+ * accepts these with or without the trailing extension and must never
+ * silently fall back to a `.md` sibling.
+ */
+export const CONTEXT_BASE_FILE_STEMS = [
+    CONTEXT_RELATIVE_PATHS.projects.activeBase.replace(/\.base$/, ""),
+];
+/**
+ * Relative path to a daily synthesized journal file. The morning routine
+ * writes this every 04:00 (B-007 §5.9).
+ */
+export function dailyJournalPath(dateStr) {
+    return `daily/${dateStr}.md`;
+}
+/**
+ * Relative path to a weekly review file (ISO year-week format, e.g. 2026-W16).
+ */
+export function weeklyReviewPath(isoYearWeek) {
+    return `weekly/${isoYearWeek}.md`;
+}
+/**
+ * Relative path to a monthly review file (YYYY-MM).
+ */
+export function monthlyReviewPath(yearMonth) {
+    return `monthly/${yearMonth}.md`;
+}
+/**
+ * Relative path to a project file by slug (kebab-case, no extension).
+ */
+export function projectPath(slug) {
+    return `projects/${slug}.md`;
+}
+/**
+ * Relative path to a lightweight git repository registry file.
+ *
+ * @deprecated Use `gitRepoOverviewPath(slug)` from the unified-repositories
+ * layout. This helper is retained transitionally for reading legacy files
+ * left behind in pre-cutover vaults.
+ */
+export function gitRepoPath(slug) {
+    return `git-repos/${slug}.md`;
+}
+/**
+ * Relative path to the project-level overview MD for a unified repository.
+ * Written by `git.project.init` and updated when something durable
+ * changes during a daily scan. See appendix §4.5.
+ */
+export function gitRepoOverviewPath(slug) {
+    return `git/${slug}/overview.md`;
+}
+/**
+ * Relative path to the per-day git journal entry for a unified repository.
+ * Written by `git.project.update` (daily scan) when the day had activity.
+ */
+export function gitRepoJournalPath(slug, dateStr) {
+    return `git/${slug}/journal/${dateStr}.md`;
+}
+/**
+ * Relative path to a custom routine definition.
+ */
+export function customRoutinePath(slug) {
+    return `routines/custom/${slug}.md`;
+}
+/**
+ * Relative path to a dossier file for a given flow slug.
+ */
+export function dossierPath(flowSlug) {
+    return `dossiers/${flowSlug}.md`;
+}
+/**
+ * Relative path to a management policy file
+ * (MANAGEMENT-POLICY-CAPTURE-PLAN §4.1). Slug must match the validator's
+ * kebab-case pattern; this helper does not re-validate.
+ */
+export function policyPath(slug) {
+    return `rules/policies/${slug}.md`;
+}
+/**
+ * Relative path for an agent scratch file (ephemeral, 48h TTL — B-007 §5.3).
+ */
+export function agentScratchPath(dateStr, slug) {
+    return `agent/scratch/${dateStr}-${slug}.md`;
+}
+/**
+ * Relative path for an inbox dump file (user-pasted memo, morning triage).
+ */
+export function inboxPath(dateStr, slug) {
+    return `inbox/${dateStr}-${slug}.md`;
+}
+/**
+ * Join a relative context path with the runtime contextDir to produce an
+ * absolute filesystem path.
+ */
+export function fullPath(contextDir, relativePath) {
+    return join(contextDir, relativePath);
+}
+/**
+ * Return true if the relative path is one of the user-area files B-006/B-007
+ * expect to exist post-setup. Used by validators and dashboard tree views.
+ */
+export const USER_AREA_FILE_PATHS = [
+    CONTEXT_RELATIVE_PATHS.user.profile,
+    CONTEXT_RELATIVE_PATHS.user.people,
+    CONTEXT_RELATIVE_PATHS.user.work,
+    CONTEXT_RELATIVE_PATHS.user.expertise,
+    CONTEXT_RELATIVE_PATHS.user.personal,
+    CONTEXT_RELATIVE_PATHS.user.goals,
+];
+const USER_AREA_FILES = new Set(USER_AREA_FILE_PATHS);
+export function isKnownUserAreaFile(relativePath) {
+    return USER_AREA_FILES.has(relativePath);
+}
+/**
+ * B-007 §6 — type field values for common frontmatter. Used by schema
+ * validators and Bases view definitions.
+ */
+export const CONTEXT_FRONTMATTER_TYPES = [
+    "project",
+    "git-repo",
+    "git-project",
+    "git-journal",
+    "user",
+    "rule",
+    "index",
+    "daily",
+    "weekly",
+    "monthly",
+    "dossier",
+    "journal-entry",
+    "scratch",
+    "inbox",
+];
+//# sourceMappingURL=context-paths.js.map

package/dist/core/context-paths.js.map

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

package/dist/core/context-staleness.d.ts

@@ -0,0 +1,45 @@
+export type StalenessTier = "loud" | "quiet";
+export interface PromptContextChangeMetadata {
+    tierReason?: string;
+}
+export type PromptContextChangedCallback = (path: string, reason: string, tier?: StalenessTier, metadata?: PromptContextChangeMetadata) => void;
+export interface ContextStalenessClassification {
+    tier: StalenessTier;
+    tierReason: string;
+}
+export interface ContextWriteStalenessInput {
+    path: string;
+    method: "PUT" | "PATCH" | "RESTORE" | "REPAIR";
+    mode?: string;
+    section?: string;
+    content?: string;
+    previousContent?: string;
+}
+export interface PromptContextStalenessDecision {
+    requestedTier: StalenessTier;
+    effectiveTier: StalenessTier;
+    invalidatesDmSessions: boolean;
+    skippedForSetup: boolean;
+}
+export interface PromptContextStalenessInput {
+    path: string;
+    reason: string;
+    tier?: StalenessTier;
+    metadata?: PromptContextChangeMetadata;
+}
+export interface ApplyPromptContextStalenessOptions {
+    dmStalenessStrict: boolean;
+    setupInProgress: boolean;
+    markContextChanged: () => void;
+    markActiveDmSessionsStale: (reason: string) => void;
+}
+export declare function normalizeContextWritePath(path: string): string;
+export declare function normalizeContextSection(section: string | undefined): string;
+export declare function classifyContextWriteStaleness(input: ContextWriteStalenessInput): ContextStalenessClassification;
+export declare function resolvePromptContextStaleness(input: {
+    tier?: StalenessTier;
+    dmStalenessStrict: boolean;
+    setupInProgress: boolean;
+}): PromptContextStalenessDecision;
+export declare function applyPromptContextStaleness(input: PromptContextStalenessInput, opts: ApplyPromptContextStalenessOptions): PromptContextStalenessDecision;
+//# sourceMappingURL=context-staleness.d.ts.map

package/dist/core/context-staleness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-staleness.d.ts","sourceRoot":"","sources":["../../src/core/context-staleness.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,CAAC;AAE7C,MAAM,WAAW,2BAA2B;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,4BAA4B,GAAG,CACzC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,aAAa,EACpB,QAAQ,CAAC,EAAE,2BAA2B,KACnC,IAAI,CAAC;AAEV,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,8BAA8B;IAC7C,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,EAAE,aAAa,CAAC;IAC7B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,QAAQ,CAAC,EAAE,2BAA2B,CAAC;CACxC;AAED,MAAM,WAAW,kCAAkC;IACjD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,OAAO,CAAC;IACzB,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,yBAAyB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACrD;AAOD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAK3E;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,0BAA0B,GAChC,8BAA8B,CAuChC;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE;IACL,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,OAAO,CAAC;CAC1B,GACA,8BAA8B,CAUhC;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,2BAA2B,EAClC,IAAI,EAAE,kCAAkC,GACvC,8BAA8B,CAahC"}

package/dist/core/context-staleness.js

@@ -0,0 +1,88 @@
+const QUIET_PROJECT_ACTIVITY_SECTIONS = new Set([
+    "activity_log",
+    "daily_activity_log",
+]);
+export function normalizeContextWritePath(path) {
+    return path.replace(/\.(md|base)$/i, "");
+}
+export function normalizeContextSection(section) {
+    return (section ?? "")
+        .replace(/^#+\s*/, "")
+        .toLowerCase()
+        .replace(/\s+/g, "_");
+}
+export function classifyContextWriteStaleness(input) {
+    const path = normalizeContextWritePath(input.path);
+    const section = normalizeContextSection(input.section);
+    if (path === "today" && input.method === "PATCH") {
+        if (section === "agent_log") {
+            return {
+                tier: "quiet",
+                tierReason: "today_agent_log_section",
+            };
+        }
+        if (!section
+            && input.mode === "append_to_file"
+            && appendWouldLandInAgentLog(input.previousContent)
+            && looksLikeAgentLogEntry(input.content)) {
+            return {
+                tier: "quiet",
+                tierReason: "today_agent_log_append_to_file",
+            };
+        }
+    }
+    if (path.startsWith("projects/")
+        && input.method === "PATCH"
+        && QUIET_PROJECT_ACTIVITY_SECTIONS.has(section)) {
+        return {
+            tier: "quiet",
+            tierReason: "project_activity_log_section",
+        };
+    }
+    return {
+        tier: "loud",
+        tierReason: "default_loud",
+    };
+}
+export function resolvePromptContextStaleness(input) {
+    const requestedTier = input.tier ?? "loud";
+    const effectiveTier = input.dmStalenessStrict ? "loud" : requestedTier;
+    const skippedForSetup = input.setupInProgress;
+    return {
+        requestedTier,
+        effectiveTier,
+        skippedForSetup,
+        invalidatesDmSessions: !skippedForSetup && effectiveTier === "loud",
+    };
+}
+export function applyPromptContextStaleness(input, opts) {
+    const decision = resolvePromptContextStaleness({
+        tier: input.tier,
+        dmStalenessStrict: opts.dmStalenessStrict,
+        setupInProgress: opts.setupInProgress,
+    });
+    if (decision.invalidatesDmSessions) {
+        opts.markContextChanged();
+        opts.markActiveDmSessionsStale(`${input.reason}:${input.path}`);
+    }
+    return decision;
+}
+function appendWouldLandInAgentLog(content) {
+    if (!content)
+        return false;
+    const headings = [...content.matchAll(/^##\s+(.+)$/gm)];
+    if (headings.length === 0)
+        return false;
+    const lastHeading = headings[headings.length - 1]?.[1];
+    return normalizeContextSection(lastHeading) === "agent_log";
+}
+function looksLikeAgentLogEntry(content) {
+    const firstLine = content
+        ?.split(/\r?\n/)
+        .find((line) => line.trim().length > 0)
+        ?.trim();
+    if (!firstLine)
+        return false;
+    return /^-\s*(?:\d{2}:\d{2}\b|\[[a-z0-9_.:-]+\s+\d{2}:\d{2}\])/i.test(firstLine);
+}
+//# sourceMappingURL=context-staleness.js.map

package/dist/core/context-staleness.js.map

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

package/dist/core/custom-routine-scheduler.d.ts

@@ -0,0 +1,151 @@
+import { type ScheduledTask } from "node-cron";
+import { customRoutineSlugFromKey } from "@aitne/shared";
+import type { EventBus } from "./event-bus.js";
+/**
+ * B-007 §5.8 Q3 — user-defined routines registered under
+ * `context/routines/custom/<slug>.md`. Each file's YAML frontmatter
+ * describes the cadence and the runtime budget; `CustomRoutineScheduler`
+ * enumerates them at startup, wires a `node-cron` job per enabled
+ * routine, and pushes a `routine.custom.<slug>` event into the EventBus
+ * on each firing. The routine file's `## Checks` body is injected into
+ * the task-flow prompt by `policy-files.ts` — this class only drives
+ * scheduling.
+ *
+ * Lifecycle:
+ *   new → start() → running
+ *   running → reload() → running (re-diffs registered vs on-disk)
+ *   running → stop() → stopped (all cron jobs cleared)
+ *
+ * No fs.watch is used. The context API route (`src/api/routes/context.ts`)
+ * calls `reload()` after every PUT/PATCH/DELETE under `routines/custom/`.
+ */
+export interface CustomRoutineSpec {
+    slug: string;
+    cron: string;
+    enabled: boolean;
+    /**
+     * Canonical model tier. Normalized from frontmatter — both legacy
+     * `light`/`heavy` and current `lite`/`medium`/`high` strings are
+     * accepted at parse time (`light → medium`, `heavy → high`).
+     */
+    backendTier: "lite" | "medium" | "high";
+    maxBudgetUsd: number;
+    processKey: string;
+}
+export type CustomRoutineParseError = {
+    kind: "missing_field";
+    field: string;
+} | {
+    kind: "invalid_cron";
+    value: string;
+} | {
+    kind: "invalid_slug";
+    value: string;
+} | {
+    kind: "invalid_type";
+    value: string;
+} | {
+    kind: "invalid_process_key";
+    value: string;
+} | {
+    kind: "invalid_enabled";
+    value: string;
+} | {
+    kind: "invalid_tier";
+    value: string;
+} | {
+    kind: "invalid_budget";
+    value: string;
+} | {
+    kind: "missing_checks_section";
+} | {
+    kind: "no_frontmatter";
+};
+export interface CustomRoutineEnumerationResult {
+    specs: CustomRoutineSpec[];
+    errors: {
+        slug: string;
+        error: CustomRoutineParseError;
+    }[];
+}
+/**
+ * Parse a `routines/custom/<slug>.md` file body into a validated spec.
+ * Pure function — safe to unit-test exhaustively. Returns a discriminated
+ * result so callers can log structured errors without throwing.
+ */
+export declare function parseCustomRoutineSpec(slug: string, body: string): {
+    ok: true;
+    spec: CustomRoutineSpec;
+} | {
+    ok: false;
+    error: CustomRoutineParseError;
+};
+/**
+ * Enumerate every `routines/custom/*.md` file under `contextDir` and
+ * parse each into a spec. Errors are returned alongside the successful
+ * specs so the scheduler can log them without aborting startup.
+ *
+ * `readCustomRoutineDir` is injectable for tests — by default it reads
+ * from disk. Passing null makes the helper return empty results, used
+ * when the context directory has not yet been materialised.
+ */
+export declare function enumerateCustomRoutines(contextDir: string, options?: {
+    readDir?: (dir: string) => string[];
+    readFile?: (path: string) => string;
+}): CustomRoutineEnumerationResult;
+/**
+ * Compute which slugs to (un)register when reloading from disk. Pure
+ * diff helper so the orchestrator class stays thin and the gate logic
+ * is covered by unit tests without touching `cron.schedule`.
+ */
+export declare function diffRegistrations(current: Map<string, CustomRoutineSpec>, next: CustomRoutineSpec[]): {
+    toAdd: CustomRoutineSpec[];
+    toReplace: CustomRoutineSpec[];
+    toRemove: string[];
+};
+export interface CustomRoutineSchedulerOptions {
+    contextDir: string;
+    eventBus: EventBus;
+    timezone?: string;
+    /** Injected by tests to skip real cron scheduling. */
+    schedule?: (expr: string, callback: () => void, timezone?: string) => ScheduledTask;
+}
+/**
+ * Orchestrates custom routine cron registration. Thin wrapper around
+ * `node-cron` so the heavy lifting (parsing, diffing) lives in the
+ * pure helpers above.
+ */
+export declare class CustomRoutineScheduler {
+    private readonly contextDir;
+    private readonly eventBus;
+    private readonly timezone;
+    private readonly scheduleFn;
+    private readonly jobs;
+    private started;
+    constructor(opts: CustomRoutineSchedulerOptions);
+    start(): void;
+    stop(): void;
+    /**
+     * Re-enumerate the custom routines on disk and apply the diff.
+     * Safe to call from any thread (API route hooks, startup).
+     */
+    reload(): {
+        added: number;
+        replaced: number;
+        removed: number;
+        errors: number;
+    };
+    /** Snapshot of currently registered specs — used by dashboard / tests. */
+    listRegistered(): CustomRoutineSpec[];
+    private register;
+    private unregister;
+    private fire;
+}
+/**
+ * Convenience: extract the slug from a `routines/custom/<slug>.md` path.
+ * Returns null if the path is outside the custom-routine directory.
+ * Used by the context API route when deciding whether to call `reload()`.
+ */
+export declare function slugFromCustomRoutinePath(relativePath: string): string | null;
+export { customRoutineSlugFromKey };
+//# sourceMappingURL=custom-routine-scheduler.d.ts.map

package/dist/core/custom-routine-scheduler.d.ts.map

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