@ashlr/hub 2.2.0

package/dist/core/config.js

@@ -0,0 +1,474 @@
+/**
+ * Config + path constants for ashlr-hub.
+ *
+ * Handles reading, writing, and defaulting the ~/.ashlr/config.json file.
+ * All ~ paths are expanded to the real homedir at module load time.
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+// ---------------------------------------------------------------------------
+// Path constants (exported, resolved immediately)
+// ---------------------------------------------------------------------------
+const HOME = homedir();
+/** Absolute path to the hub's config/index home: ~/.ashlr */
+export const CONFIG_DIR = join(HOME, '.ashlr');
+/** Absolute path to the config file: ~/.ashlr/config.json */
+export const CONFIG_PATH = join(CONFIG_DIR, 'config.json');
+/** Absolute path to the index file: ~/.ashlr/index.json */
+export const INDEX_PATH = join(CONFIG_DIR, 'index.json');
+// ---------------------------------------------------------------------------
+// Runtime path resolution
+// ---------------------------------------------------------------------------
+// The exported constants above are resolved once at module load for external
+// consumers. The functions below re-resolve from homedir() at call time so a
+// changed HOME (e.g. in tests, or a relocated home dir) is always honored.
+// This keeps the public constants stable while making load/save correct under
+// a moving HOME.
+function resolveConfigDir() {
+    return join(homedir(), '.ashlr');
+}
+function resolveConfigPath() {
+    return join(resolveConfigDir(), 'config.json');
+}
+/**
+ * Absolute path to the M26 self-improvement / meta-learning home:
+ * `~/.ashlr/learn`. Re-resolved from `homedir()` at call time so tests that
+ * relocate HOME work. This is the ONLY directory `ashlr reflect` writes to for
+ * its reports/snapshots — it NEVER writes CONFIG_PATH / router policy / prompts.
+ * This function does NOT create the directory; the learn store creates it lazily.
+ */
+export function learnDir() {
+    return join(resolveConfigDir(), 'learn');
+}
+/**
+ * Absolute path to the M27 quality / health-review home: `~/.ashlr/quality`.
+ * Re-resolved from `homedir()` at call time so tests that relocate HOME work.
+ * This is the ONLY directory `ashlr health` writes to for its HealthReport
+ * snapshots (trend tracking) — it NEVER writes CONFIG_PATH / router policy /
+ * prompts, and NEVER touches a user repo working tree. This function does NOT
+ * create the directory; the quality store creates it lazily.
+ */
+export function qualityDir() {
+    return join(resolveConfigDir(), 'quality');
+}
+/**
+ * Absolute path to the M28 goal planning/tracking home: `~/.ashlr/goals`.
+ * Re-resolved from `homedir()` at call time so tests that relocate HOME work.
+ * This is the ONLY directory `ashlr goals` writes its planning/tracking data
+ * to — it NEVER writes CONFIG_PATH / router policy / prompts, and NEVER touches
+ * a user repo working tree. This function does NOT create the directory; the
+ * goals store creates it lazily. Single source of truth for the ~/.ashlr root.
+ */
+export function goalsDir() {
+    return join(resolveConfigDir(), 'goals');
+}
+/**
+ * Absolute path to the M29 portfolio-digest home: `~/.ashlr/digests`.
+ * Re-resolved from `homedir()` at call time so tests that relocate HOME work.
+ * This is the ONLY directory `ashlr digest` writes to (JSON + markdown digest
+ * artifacts for day-over-day trend) — it NEVER writes CONFIG_PATH / router
+ * policy / prompts, and NEVER touches a user repo working tree. This function
+ * does NOT create the directory; the digest store creates it lazily. Single
+ * source of truth for the ~/.ashlr root.
+ */
+export function digestsDir() {
+    return join(resolveConfigDir(), 'digests');
+}
+// ---------------------------------------------------------------------------
+// Default tidy rules
+// ---------------------------------------------------------------------------
+/**
+ * Conservative, opinionated rules for tidying loose top-level Desktop files.
+ * Rules are applied in order — first match wins (enforced by the tidy engine).
+ * Only moves clearly-typed files; ambiguous or structurally-important items
+ * should be added to `keepers` instead.
+ */
+const DEFAULT_TIDY_RULES = [
+    // ── Screenshots ──────────────────────────────────────────────────────────
+    {
+        match: 'Screenshot*',
+        matchType: 'glob',
+        dest: join(HOME, 'Desktop/Assets/Screenshots'),
+        description: 'macOS screenshot files captured to Desktop',
+    },
+    {
+        match: 'Screen Recording*',
+        matchType: 'glob',
+        dest: join(HOME, 'Desktop/Assets/Screenshots'),
+        description: 'macOS screen recordings captured to Desktop',
+    },
+    // ── Images ────────────────────────────────────────────────────────────────
+    {
+        match: 'png',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Assets'),
+        description: 'Loose PNG images',
+    },
+    {
+        match: 'jpg',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Assets'),
+        description: 'Loose JPEG images',
+    },
+    {
+        match: 'jpeg',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Assets'),
+        description: 'Loose JPEG images',
+    },
+    {
+        match: 'gif',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Assets'),
+        description: 'Loose GIF images',
+    },
+    {
+        match: 'webp',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Assets'),
+        description: 'Loose WebP images',
+    },
+    {
+        match: 'svg',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Assets'),
+        description: 'Loose SVG files',
+    },
+    {
+        match: 'heic',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Assets'),
+        description: 'Loose HEIC images (iPhone captures)',
+    },
+    // ── Documents — PDF ───────────────────────────────────────────────────────
+    {
+        match: '*Invoice*',
+        matchType: 'glob',
+        dest: join(HOME, 'Desktop/Business'),
+        description: 'Invoice PDFs and documents',
+    },
+    {
+        match: '*Receipt*',
+        matchType: 'glob',
+        dest: join(HOME, 'Desktop/Business'),
+        description: 'Receipt PDFs and documents',
+    },
+    {
+        match: '*Contract*',
+        matchType: 'glob',
+        dest: join(HOME, 'Desktop/Business'),
+        description: 'Contract documents',
+    },
+    {
+        match: 'pdf',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Business'),
+        description: 'Loose PDF documents (generic catch-all for PDFs not matched above)',
+    },
+    // ── Documents — Office / text ─────────────────────────────────────────────
+    {
+        match: 'docx',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Business'),
+        description: 'Loose Word documents',
+    },
+    {
+        match: 'doc',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Business'),
+        description: 'Loose Word documents (legacy format)',
+    },
+    {
+        match: 'xlsx',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Business'),
+        description: 'Loose Excel spreadsheets',
+    },
+    {
+        match: 'xls',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Business'),
+        description: 'Loose Excel spreadsheets (legacy format)',
+    },
+    {
+        match: 'pptx',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Business'),
+        description: 'Loose PowerPoint presentations',
+    },
+    {
+        match: 'ppt',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Business'),
+        description: 'Loose PowerPoint presentations (legacy format)',
+    },
+    {
+        match: 'numbers',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Business'),
+        description: 'Loose Numbers spreadsheets',
+    },
+    {
+        match: 'pages',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Business'),
+        description: 'Loose Pages documents',
+    },
+    {
+        match: 'keynote',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Business'),
+        description: 'Loose Keynote presentations',
+    },
+    // ── Notes / Markdown ──────────────────────────────────────────────────────
+    {
+        match: 'md',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Knowledge'),
+        description: 'Loose Markdown notes and documents',
+    },
+    {
+        match: 'txt',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Knowledge'),
+        description: 'Loose plain-text notes',
+    },
+    {
+        match: 'rtf',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Knowledge'),
+        description: 'Loose RTF notes',
+    },
+    // ── Archives / downloads ──────────────────────────────────────────────────
+    {
+        match: 'zip',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/archive'),
+        description: 'Loose ZIP archives (downloads, exports)',
+    },
+    {
+        match: 'tar',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/archive'),
+        description: 'Loose tar archives',
+    },
+    {
+        match: 'gz',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/archive'),
+        description: 'Loose gzip archives',
+    },
+    {
+        match: 'dmg',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/archive'),
+        description: 'Loose disk image installers',
+    },
+    {
+        match: 'pkg',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/archive'),
+        description: 'Loose macOS package installers',
+    },
+    // ── Audio / video ─────────────────────────────────────────────────────────
+    {
+        match: 'mp3',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Assets'),
+        description: 'Loose audio files',
+    },
+    {
+        match: 'wav',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Assets'),
+        description: 'Loose WAV audio files',
+    },
+    {
+        match: 'mp4',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Assets'),
+        description: 'Loose MP4 video files',
+    },
+    {
+        match: 'mov',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Assets'),
+        description: 'Loose QuickTime video files',
+    },
+    {
+        match: 'mkv',
+        matchType: 'ext',
+        dest: join(HOME, 'Desktop/Assets'),
+        description: 'Loose MKV video files',
+    },
+];
+// ---------------------------------------------------------------------------
+// Category map (Desktop doc-folder categories; git-category entries come from
+// the github/<category> subdirectory layout and are added dynamically in
+// the index engine, but we seed the doc-folder ones here for tidy purposes).
+// ---------------------------------------------------------------------------
+const DEFAULT_CATEGORIES = {
+    // Git repo categories (path-based; used by classify.ts to resolve category)
+    'dev-tools': join(HOME, 'Desktop/github/dev-tools'),
+    'side-projects': join(HOME, 'Desktop/github/side-projects'),
+    'professional-tools': join(HOME, 'Desktop/github/professional-tools'),
+    'artist-encyclopedias': join(HOME, 'Desktop/github/artist-encyclopedias'),
+    'client-engagements': join(HOME, 'Desktop/github/client-engagements'),
+    forks: join(HOME, 'Desktop/github/forks'),
+    ashlrai: join(HOME, 'Desktop/github/ashlrai'),
+    // Desktop document folders
+    Business: join(HOME, 'Desktop/Business'),
+    'Client-Work': join(HOME, 'Desktop/Client-Work'),
+    'Product-Docs': join(HOME, 'Desktop/Product-Docs'),
+    Knowledge: join(HOME, 'Desktop/Knowledge'),
+    Assets: join(HOME, 'Desktop/Assets'),
+    archive: join(HOME, 'Desktop/archive'),
+};
+// ---------------------------------------------------------------------------
+// Keeper list
+// These basenames / absolute paths must NEVER be moved or deleted by tidy.
+// ---------------------------------------------------------------------------
+const DEFAULT_KEEPERS = [
+    'Rent Application.pdf',
+    'ASHLRAI',
+    'rde-other',
+    'Keys & Recovery',
+    'github',
+    'Evero Notes',
+    'OneDrive - James Madison University',
+    // Top-level symlinks that happen to mirror github/ structure — never double-count
+    'tts agents',
+];
+// ---------------------------------------------------------------------------
+// defaultConfig()
+// ---------------------------------------------------------------------------
+/**
+ * Produce a sensible default AshlrConfig for a fresh install.
+ * All paths are resolved to absolute values (no ~ remaining).
+ */
+export function defaultConfig() {
+    return {
+        version: 1,
+        roots: [
+            join(HOME, 'Desktop/github'),
+            join(HOME, 'Desktop'),
+        ],
+        editor: 'cursor',
+        staleDays: 30,
+        categories: DEFAULT_CATEGORIES,
+        tidyRules: DEFAULT_TIDY_RULES,
+        keepers: DEFAULT_KEEPERS,
+        models: {
+            lmstudio: 'http://localhost:1234',
+            ollama: 'http://localhost:11434',
+            providerChain: ['lmstudio', 'ollama', 'anthropic'],
+        },
+        telemetry: {},
+        tools: {},
+        // M33: plugin system defaults — DEFAULT EMPTY (enabled:[] = no plugins load).
+        plugins: {
+            enabled: [],
+            settings: {},
+            integrity: {},
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Deep merge helper
+// ---------------------------------------------------------------------------
+/**
+ * Recursively merge `override` on top of `base`.
+ * Arrays from `override` replace those in `base` entirely (no concat) —
+ * this lets users fully replace roots/keepers/tidyRules in their config file.
+ * Plain objects are merged recursively; all other values override directly.
+ */
+function deepMerge(base, override) {
+    const result = { ...base };
+    for (const key of Object.keys(override)) {
+        const baseVal = base[key];
+        const overVal = override[key];
+        if (overVal !== null &&
+            overVal !== undefined &&
+            typeof overVal === 'object' &&
+            !Array.isArray(overVal) &&
+            typeof baseVal === 'object' &&
+            baseVal !== null &&
+            !Array.isArray(baseVal)) {
+            // Both sides are plain objects — recurse
+            result[key] = deepMerge(baseVal, overVal);
+        }
+        else if (overVal !== undefined) {
+            // Array, primitive, or null — take override's value
+            result[key] = overVal;
+        }
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// loadConfig()
+// ---------------------------------------------------------------------------
+/**
+ * Load config from CONFIG_PATH.
+ * - If CONFIG_DIR does not exist, creates it.
+ * - If CONFIG_PATH does not exist, writes the default config and returns it.
+ * - Otherwise, reads the file, JSON-parses it, deep-merges over defaultConfig()
+ *   (so new keys added in future versions are always present), and returns.
+ * - On parse error, logs a warning and falls back to the default config
+ *   (we intentionally do NOT overwrite the user's potentially-fixable file).
+ */
+export function loadConfig() {
+    const configDir = resolveConfigDir();
+    const configPath = resolveConfigPath();
+    // Ensure the config directory exists
+    if (!existsSync(configDir)) {
+        mkdirSync(configDir, { recursive: true });
+    }
+    // If the config file does not exist, bootstrap it with defaults
+    if (!existsSync(configPath)) {
+        const defaults = defaultConfig();
+        saveConfig(defaults);
+        return defaults;
+    }
+    // Read and parse the existing config file
+    let raw;
+    try {
+        raw = readFileSync(configPath, 'utf8');
+    }
+    catch (err) {
+        console.warn(`[ashlr] Warning: could not read config at ${configPath}: ${String(err)}. Using defaults.`);
+        return defaultConfig();
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        console.warn(`[ashlr] Warning: config file at ${configPath} is not valid JSON: ${String(err)}. Using defaults.`);
+        return defaultConfig();
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        console.warn(`[ashlr] Warning: config file at ${configPath} does not contain a JSON object. Using defaults.`);
+        return defaultConfig();
+    }
+    // Deep-merge the user's persisted config over the defaults so newly-added
+    // fields always have a value even on older config files.
+    return deepMerge(defaultConfig(), parsed);
+}
+// ---------------------------------------------------------------------------
+// saveConfig()
+// ---------------------------------------------------------------------------
+/**
+ * Persist `c` to CONFIG_PATH as pretty-printed JSON.
+ * Creates CONFIG_DIR if it does not yet exist.
+ */
+export function saveConfig(c) {
+    const configDir = resolveConfigDir();
+    const configPath = resolveConfigPath();
+    if (!existsSync(configDir)) {
+        mkdirSync(configDir, { recursive: true });
+    }
+    const json = JSON.stringify(c, null, 2) + '\n';
+    writeFileSync(configPath, json, 'utf8');
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/daemon/loop.d.ts

@@ -0,0 +1,74 @@
+/**
+ * loop.ts — The M24 daemon operator.
+ *
+ * Exports:
+ *  - tick(cfg, opts): one operator cycle — check guards, load backlog, dispatch
+ *    sandboxed swarms, create PENDING inbox proposals, record spend + state.
+ *  - runDaemon(cfg, opts): loop ticks on an interval (or once); REFUSES when
+ *    nested; marks running state; stops on kill switch / budget exhaustion.
+ *  - stopDaemon(): set kill switch + clear running state.
+ *
+ * NON-NEGOTIABLE GUARDRAILS (enforced here, grep-provable):
+ *  1. PROPOSAL-ONLY: this file has NO outward-action path whatsoever. Its ONLY
+ *     inbox output is a PENDING proposal, produced indirectly by the swarm
+ *     runner when this file passes { propose: true } to runSwarm. A PENDING
+ *     proposal is applied LATER only by an explicit human inbox approve.
+ *     This file imports no apply/push/PR/deploy primitive.
+ *  2. ENROLLMENT-ONLY: operates exclusively on listEnrolled() repos.
+ *     DEFAULT EMPTY => the daemon does NOTHING.
+ *  3. SANDBOXED: every runSwarm call sets opts.sandbox = true so all
+ *     swarm work runs in an isolated git-worktree (M21).
+ *  4. BOUNDED: hard daily USD cap + per-tick item cap + concurrency cap.
+ *     Resets per calendar day. NO unbounded loop — every iteration
+ *     re-checks kill switch + budget.
+ *  5. RE-ENTRANCY: runDaemon REFUSES if ASHLR_IN_DAEMON or ASHLR_IN_SWARM
+ *     is already set (no daemon-inside-daemon / daemon-inside-swarm fork bomb).
+ *     Sets ASHLR_IN_DAEMON=1 on this process so child spawns inherit it.
+ *
+ * No new runtime deps; node builtins only; never throws out of public API.
+ */
+import type { AshlrConfig, DaemonState, DaemonTick } from '../types.js';
+/**
+ * One operator cycle. In order:
+ *  1. Kill-switch check.
+ *  2. Load + resetDayIfNeeded state; budget exhaustion check.
+ *  3. Enrollment check (DEFAULT EMPTY => do nothing).
+ *  4. Build/load backlog for enrolled repos.
+ *  5. Select top-K items within remaining budget.
+ *  6a. dryRun: describe what WOULD be worked; create NO proposals.
+ *  6b. else: for each selected item (bounded concurrency):
+ *       runSwarm({ sandbox:true, propose:true }) => a PENDING inbox proposal
+ *       is produced by the runner + tally spend.
+ *  7. Persist updated state; return tick record.
+ *
+ * Has NO outward-action path (no apply, no push, no PR, no deploy).
+ * Never throws.
+ */
+export declare function tick(cfg: AshlrConfig, opts: {
+    dryRun: boolean;
+}): Promise<DaemonTick>;
+/**
+ * Start the daemon operator.
+ *
+ * REFUSES (returns unchanged state) if ASHLR_IN_DAEMON or ASHLR_IN_SWARM is
+ * set — prevents daemon-inside-daemon and daemon-inside-swarm fork bombs.
+ *
+ * Sets ASHLR_IN_DAEMON=1 on this process.env so all child spawns inherit it.
+ *
+ * opts.once = true  => run exactly one tick then stop.
+ * opts.once = false => loop: tick → sleep intervalMs → tick → ... until kill
+ *                      switch is set OR daily budget is exhausted.
+ *                      NO unbounded loop — every iteration re-checks both.
+ *
+ * Never throws.
+ */
+export declare function runDaemon(cfg: AshlrConfig, opts: {
+    once: boolean;
+    dryRun: boolean;
+}): Promise<DaemonState>;
+/**
+ * Set the kill switch (M21 ~/.ashlr/KILL) AND mark running=false, pid=null in
+ * persisted state. Idempotent; never throws. A running loop sees the kill
+ * switch on the next iteration and stops cleanly.
+ */
+export declare function stopDaemon(): void;