@ashlr/hub 2.2.0

package/dist/core/classify.js

@@ -0,0 +1,450 @@
+/**
+ * classify.ts — cheap, synchronous heuristics for categorising Desktop items.
+ *
+ * Rules:
+ *  - Never throw; return null / 'other' on any error.
+ *  - Zero runtime deps (Node builtins only).
+ *  - Synchronous everywhere — called in a tight scan loop.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { loadConfig } from './config.js';
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the active config. We intentionally do NOT cache across calls:
+ * `loadConfig()` reads a tiny JSON file and a stale cache would yield wrong
+ * categories if the config changes between scans (or between tests). The cost
+ * is negligible relative to the filesystem work each classify call already does.
+ */
+function cfg() {
+    try {
+        return loadConfig();
+    }
+    catch {
+        // loadConfig unavailable / config missing — return a minimal default.
+        return {
+            version: 1,
+            roots: [path.join(process.env['HOME'] ?? os.homedir(), 'Desktop')],
+            editor: 'cursor',
+            staleDays: 30,
+            categories: {},
+            tidyRules: [],
+            keepers: [],
+            models: { lmstudio: '', ollama: '', providerChain: [] },
+            telemetry: {},
+            tools: {},
+        };
+    }
+}
+/**
+ * Inline `.git` detection — avoids a circular dep on git.ts (which may not
+ * exist when classify.ts is compiled in isolation).
+ */
+function hasGitDir(dir) {
+    try {
+        const gitPath = path.join(dir, '.git');
+        const st = fs.lstatSync(gitPath);
+        // .git is either a directory (normal clone) or a file (worktree/submodule)
+        return st.isDirectory() || st.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/** Read a file as UTF-8 text, return null on any error. */
+function readText(filePath) {
+    try {
+        return fs.readFileSync(filePath, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+/** Truncate a string to at most `max` characters (full words not required). */
+function cap(s, max = 160) {
+    return s.length <= max ? s : s.slice(0, max - 1) + '…';
+}
+// ---------------------------------------------------------------------------
+// Known doc-category folder basenames (top-level Desktop directories that
+// are NOT git repos and are NOT under github/).
+// ---------------------------------------------------------------------------
+const DOC_CATEGORY_FOLDERS = new Set([
+    'Business',
+    'Client-Work',
+    'Product-Docs',
+    'Knowledge',
+    'Assets',
+    'archive',
+    // sub-folders users commonly have
+    'CMP',
+    'RDE',
+    'Aether',
+    'Chaos-Engine',
+]);
+// File extensions considered "documents".
+const DOC_EXTENSIONS = new Set([
+    '.md', '.markdown', '.txt', '.rst', '.pdf', '.docx', '.doc',
+    '.pages', '.rtf', '.tex', '.org', '.adoc', '.asciidoc',
+    '.html', '.htm', '.csv', '.xlsx', '.xls', '.json', '.yaml', '.yml',
+    '.toml', '.ini', '.conf', '.env',
+]);
+// File extensions considered "assets" (images, media, fonts, …).
+const ASSET_EXTENSIONS = new Set([
+    '.png', '.jpg', '.jpeg', '.gif', '.svg', '.webp', '.ico', '.bmp', '.tiff',
+    '.mp4', '.mov', '.avi', '.mkv', '.webm', '.mp3', '.wav', '.flac', '.aac',
+    '.m4a', '.ogg', '.otf', '.ttf', '.woff', '.woff2', '.eot',
+    '.zip', '.tar', '.gz', '.bz2', '.7z', '.rar',
+    '.sketch', '.fig', '.xd', '.psd', '.ai',
+]);
+// ---------------------------------------------------------------------------
+// categoryOf
+// ---------------------------------------------------------------------------
+/**
+ * Return the category bucket for `itemPath`:
+ *  - For a path under `github/<category>/<repo>` → the category name
+ *    (e.g. "dev-tools", "side-projects").
+ *  - For a path directly under the Desktop (or its known doc folders) →
+ *    the top-level folder name (e.g. "Business", "Client-Work").
+ *  - Otherwise → null.
+ */
+export function categoryOf(itemPath) {
+    try {
+        const config = cfg();
+        // 1. Check against configured categories map (category → absolute dir).
+        //    A repo at /…/github/dev-tools/my-repo has itemPath that starts with
+        //    the category dir.
+        for (const [name, catDir] of Object.entries(config.categories)) {
+            const normalCat = catDir.endsWith('/') ? catDir : catDir + '/';
+            if (itemPath.startsWith(normalCat) || itemPath === catDir) {
+                return name;
+            }
+        }
+        // 2. Heuristic: detect github/<category> in path segments.
+        //    Works even when categories map is empty (e.g. during first run).
+        const parts = itemPath.split(path.sep);
+        const githubIdx = parts.lastIndexOf('github');
+        if (githubIdx !== -1 && githubIdx + 1 < parts.length) {
+            const category = parts[githubIdx + 1];
+            // Must be a known-style category (not a repo name) — the item itself
+            // is at githubIdx+2 or deeper.
+            if (category && githubIdx + 2 <= parts.length - 1) {
+                return category;
+            }
+        }
+        // 3. Top-level Desktop folder: if the item's parent matches a doc folder.
+        //    Resolve the Desktop root explicitly rather than assuming roots[0] is
+        //    the Desktop — roots[0] is typically '.../Desktop/github', which would
+        //    make every relative path start with '..' and silently disable this
+        //    heuristic. Prefer a root whose basename is 'Desktop', else strip a
+        //    trailing '/github' from a github root, else fall back to HOME/Desktop.
+        const desktop = config.roots.find((r) => path.basename(r) === 'Desktop') ??
+            (() => {
+                const gh = config.roots.find((r) => path.basename(r) === 'github');
+                if (gh)
+                    return path.dirname(gh);
+                return path.join(process.env['HOME'] ?? '', 'Desktop');
+            })();
+        const rel = path.relative(desktop, itemPath);
+        if (!rel.startsWith('..') && rel !== '') {
+            const topSegment = rel.split(path.sep)[0];
+            if (topSegment && DOC_CATEGORY_FOLDERS.has(topSegment)) {
+                return topSegment;
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// describe
+// ---------------------------------------------------------------------------
+/**
+ * Return a one-line description for `itemPath` (a directory or file):
+ *  1. package.json "description" field (if present and non-empty).
+ *  2. First H1 (`# …`) in README.md / README.markdown / README (stripped of `#`).
+ *  3. First non-empty non-heading line in the README.
+ *  4. null if none found.
+ *
+ * Capped at 160 characters.
+ */
+export function describe(itemPath) {
+    try {
+        // Determine directory to search
+        let dir;
+        try {
+            const st = fs.lstatSync(itemPath);
+            dir = st.isDirectory() ? itemPath : path.dirname(itemPath);
+        }
+        catch {
+            return null;
+        }
+        // 1. README first H1 (highest priority per contract).
+        const readmeCandidates = [
+            'README.md', 'README.markdown', 'README.txt', 'README.rst', 'README',
+            'readme.md', 'Readme.md',
+        ];
+        for (const fname of readmeCandidates) {
+            const text = readText(path.join(dir, fname));
+            if (!text)
+                continue;
+            const lines = text.split('\n');
+            for (const line of lines) {
+                // Markdown H1: # Title
+                const h1Match = line.match(/^#\s+(.+)/);
+                if (h1Match && h1Match[1]) {
+                    const title = h1Match[1].trim();
+                    if (title)
+                        return cap(title);
+                }
+                // HTML H1: <h1>Title</h1> or <h1>Title (unclosed)
+                const htmlH1Match = line.match(/<h1[^>]*>(.*?)<\/h1>/i)
+                    ?? line.match(/<h1[^>]*>([^<]+)/i);
+                if (htmlH1Match && htmlH1Match[1]) {
+                    const title = htmlH1Match[1].trim();
+                    if (title)
+                        return cap(title);
+                }
+            }
+            // README present but no H1 — stop scanning further README candidates;
+            // fall through to package.json. (No body-line fallback by design.)
+            break;
+        }
+        // 2. package.json "description" fallback.
+        const pkgText = readText(path.join(dir, 'package.json'));
+        if (pkgText) {
+            try {
+                const pkg = JSON.parse(pkgText);
+                if (typeof pkg['description'] === 'string' && pkg['description'].trim()) {
+                    return cap(pkg['description'].trim());
+                }
+            }
+            catch {
+                // malformed JSON — fall through
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// primaryLanguage
+// ---------------------------------------------------------------------------
+/** Extension → language name map for source-counting fallback. */
+const EXT_LANGUAGE = {
+    '.ts': 'TypeScript',
+    '.tsx': 'TypeScript',
+    '.js': 'JavaScript',
+    '.jsx': 'JavaScript',
+    '.mjs': 'JavaScript',
+    '.cjs': 'JavaScript',
+    '.py': 'Python',
+    '.rs': 'Rust',
+    '.go': 'Go',
+    '.swift': 'Swift',
+    '.rb': 'Ruby',
+    '.java': 'Java',
+    '.kt': 'Kotlin',
+    '.cs': 'C#',
+    '.cpp': 'C++',
+    '.cc': 'C++',
+    '.cxx': 'C++',
+    '.c': 'C',
+    '.h': 'C',
+    '.hpp': 'C++',
+    '.php': 'PHP',
+    '.lua': 'Lua',
+    '.r': 'R',
+    '.R': 'R',
+    '.sh': 'Shell',
+    '.bash': 'Shell',
+    '.zsh': 'Shell',
+    '.fish': 'Shell',
+    '.dart': 'Dart',
+    '.ex': 'Elixir',
+    '.exs': 'Elixir',
+    '.elm': 'Elm',
+    '.hs': 'Haskell',
+    '.clj': 'Clojure',
+    '.scala': 'Scala',
+    '.vue': 'Vue',
+    '.svelte': 'Svelte',
+};
+/**
+ * Cheap heuristic language detection (no AST, no external tools):
+ *  1. package.json present → JavaScript or TypeScript (check for .ts devDeps).
+ *  2. Cargo.toml → Rust.
+ *  3. pyproject.toml | requirements.txt | setup.py → Python.
+ *  4. Package.swift → Swift.
+ *  5. go.mod → Go.
+ *  6. Gemfile | *.gemspec → Ruby.
+ *  7. pom.xml | build.gradle → Java/Kotlin.
+ *  8. Shallow directory scan — most common source extension wins.
+ *  9. null if undetermined.
+ */
+export function primaryLanguage(itemPath) {
+    try {
+        let dir;
+        try {
+            const st = fs.lstatSync(itemPath);
+            if (st.isSymbolicLink())
+                return null;
+            dir = st.isDirectory() ? itemPath : path.dirname(itemPath);
+        }
+        catch {
+            return null;
+        }
+        // Helper: does a file exist in dir?
+        const has = (fname) => {
+            try {
+                fs.accessSync(path.join(dir, fname));
+                return true;
+            }
+            catch {
+                return false;
+            }
+        };
+        // 1. package.json → JS or TS
+        if (has('package.json')) {
+            // If there are .ts files or typescript in devDeps → TypeScript
+            if (has('tsconfig.json') || has('tsconfig.base.json'))
+                return 'TypeScript';
+            const pkgText = readText(path.join(dir, 'package.json'));
+            if (pkgText) {
+                try {
+                    const pkg = JSON.parse(pkgText);
+                    const allDeps = {
+                        ...(pkg['dependencies'] ?? {}),
+                        ...(pkg['devDependencies'] ?? {}),
+                    };
+                    if ('typescript' in allDeps)
+                        return 'TypeScript';
+                }
+                catch { /* fall through */ }
+            }
+            return 'JavaScript';
+        }
+        // 2. Rust
+        if (has('Cargo.toml'))
+            return 'Rust';
+        // 3. Python
+        if (has('pyproject.toml') || has('requirements.txt') || has('setup.py') || has('setup.cfg')) {
+            return 'Python';
+        }
+        // 4. Swift
+        if (has('Package.swift'))
+            return 'Swift';
+        // 5. Go
+        if (has('go.mod'))
+            return 'Go';
+        // 6. Ruby
+        if (has('Gemfile') || has('.gemspec'))
+            return 'Ruby';
+        // 7. Java / Kotlin
+        if (has('pom.xml'))
+            return 'Java';
+        if (has('build.gradle') || has('build.gradle.kts')) {
+            // build.gradle.kts → likely Kotlin
+            return has('build.gradle.kts') ? 'Kotlin' : 'Java';
+        }
+        // 8. Shallow extension-frequency scan
+        return dominantLanguageFromEntries(dir);
+    }
+    catch {
+        return null;
+    }
+}
+/** Count source extensions in a shallow directory listing and return the winner. */
+function dominantLanguageFromEntries(dir) {
+    try {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        const counts = {};
+        for (const entry of entries) {
+            if (!entry.isFile())
+                continue;
+            const ext = path.extname(entry.name).toLowerCase();
+            if (!ext || !(ext in EXT_LANGUAGE))
+                continue;
+            counts[ext] = (counts[ext] ?? 0) + 1;
+        }
+        // Also do one level deeper (src/)
+        const srcDir = path.join(dir, 'src');
+        try {
+            const srcEntries = fs.readdirSync(srcDir, { withFileTypes: true });
+            for (const entry of srcEntries) {
+                if (!entry.isFile())
+                    continue;
+                const ext = path.extname(entry.name).toLowerCase();
+                if (!ext || !(ext in EXT_LANGUAGE))
+                    continue;
+                // Weight src/ files slightly higher
+                counts[ext] = (counts[ext] ?? 0) + 2;
+            }
+        }
+        catch { /* src/ may not exist */ }
+        let bestExt = null;
+        let bestCount = 0;
+        for (const [ext, count] of Object.entries(counts)) {
+            if (count > bestCount) {
+                bestCount = count;
+                bestExt = ext;
+            }
+        }
+        return bestExt ? (EXT_LANGUAGE[bestExt] ?? null) : null;
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// kindOf
+// ---------------------------------------------------------------------------
+/**
+ * Determine the fundamental kind of `itemPath`:
+ *  - 'symlink'    — lstat shows it's a symbolic link (checked first).
+ *  - 'repo'       — directory that contains a .git entry.
+ *  - 'doc-folder' — directory whose basename is a known doc-category folder.
+ *  - 'doc'        — file with a document extension.
+ *  - 'asset'      — file with an image/media/archive extension.
+ *  - 'other'      — anything else.
+ */
+export function kindOf(itemPath) {
+    try {
+        // Use lstat so we inspect the link itself, not its target.
+        const st = fs.lstatSync(itemPath);
+        // 1. Symlink — highest priority
+        if (st.isSymbolicLink())
+            return 'symlink';
+        if (st.isDirectory()) {
+            // 2. Repo — has .git dir or file
+            if (hasGitDir(itemPath))
+                return 'repo';
+            // 3. Known doc-category folder
+            const base = path.basename(itemPath);
+            if (DOC_CATEGORY_FOLDERS.has(base))
+                return 'doc-folder';
+            return 'other';
+        }
+        if (st.isFile()) {
+            const ext = path.extname(itemPath).toLowerCase();
+            // 4. Document
+            if (DOC_EXTENSIONS.has(ext))
+                return 'doc';
+            // 5. Asset
+            if (ASSET_EXTENSIONS.has(ext))
+                return 'asset';
+            return 'other';
+        }
+        return 'other';
+    }
+    catch {
+        return 'other';
+    }
+}
+//# sourceMappingURL=classify.js.map

package/dist/core/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../src/core/classify.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;GAKG;AACH,SAAS,GAAG;IACV,IAAI,CAAC;QACH,OAAO,UAAU,EAAE,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,sEAAsE;QACtE,OAAO;YACL,OAAO,EAAE,CAAC;YACV,KAAK,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;YAClE,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,EAAE;YACb,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE;YACvD,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,EAAE;SACV,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,SAAS,CAAC,GAAW;IAC5B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACvC,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACjC,2EAA2E;QAC3E,OAAO,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,2DAA2D;AAC3D,SAAS,QAAQ,CAAC,QAAgB;IAChC,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,SAAS,GAAG,CAAC,CAAS,EAAE,GAAG,GAAG,GAAG;IAC/B,OAAO,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;AACzD,CAAC;AAED,8EAA8E;AAC9E,0EAA0E;AAC1E,gDAAgD;AAChD,8EAA8E;AAC9E,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,UAAU;IACV,aAAa;IACb,cAAc;IACd,WAAW;IACX,QAAQ;IACR,SAAS;IACT,kCAAkC;IAClC,KAAK;IACL,KAAK;IACL,QAAQ;IACR,cAAc;CACf,CAAC,CAAC;AAEH,0CAA0C;AAC1C,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAC3D,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW;IACtD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM;IAClE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CACjC,CAAC,CAAC;AAEH,iEAAiE;AACjE,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IAC/B,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;IACzE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IACxE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM;IACzD,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAC5C,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK;CACxC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC;QAErB,wEAAwE;QACxE,yEAAyE;QACzE,uBAAuB;QACvB,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/D,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC;YAC/D,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBAC1D,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,2DAA2D;QAC3D,sEAAsE;QACtE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,SAAS,KAAK,CAAC,CAAC,IAAI,SAAS,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACrD,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;YACtC,qEAAqE;YACrE,+BAA+B;YAC/B,IAAI,QAAQ,IAAI,SAAS,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClD,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAED,0EAA0E;QAC1E,0EAA0E;QAC1E,2EAA2E;QAC3E,wEAAwE;QACxE,wEAAwE;QACxE,4EAA4E;QAC5E,MAAM,OAAO,GACX,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;YACxD,CAAC,GAAG,EAAE;gBACJ,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC;gBACnE,IAAI,EAAE;oBAAE,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAChC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC;YACzD,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;YACxC,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1C,IAAI,UAAU,IAAI,oBAAoB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBACvD,OAAO,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,IAAI,CAAC;QACH,gCAAgC;QAChC,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAClC,GAAG,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC7D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;QAED,sDAAsD;QACtD,MAAM,gBAAgB,GAAG;YACvB,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ;YACpE,WAAW,EAAE,WAAW;SACzB,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;YAC7C,IAAI,CAAC,IAAI;gBAAE,SAAS;YAEpB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,uBAAuB;gBACvB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBACxC,IAAI,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBAChC,IAAI,KAAK;wBAAE,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;gBACD,kDAAkD;gBAClD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC;uBAClD,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;gBACrC,IAAI,WAAW,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;oBAClC,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBACpC,IAAI,KAAK;wBAAE,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;YACD,sEAAsE;YACtE,mEAAmE;YACnE,MAAM;QACR,CAAC;QAED,0CAA0C;QAC1C,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;QACzD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;gBAC3D,IAAI,OAAO,GAAG,CAAC,aAAa,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;oBACxE,OAAO,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,gCAAgC;YAClC,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,kEAAkE;AAClE,MAAM,YAAY,GAA2B;IAC3C,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,IAAI;IACX,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,MAAM;IACb,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;IACT,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,OAAO;IACf,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,OAAO;IACjB,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,QAAQ;CACpB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,IAAI,CAAC;QACH,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAClC,IAAI,EAAE,CAAC,cAAc,EAAE;gBAAE,OAAO,IAAI,CAAC;YACrC,GAAG,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC7D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;QAED,oCAAoC;QACpC,MAAM,GAAG,GAAG,CAAC,KAAa,EAAW,EAAE;YACrC,IAAI,CAAC;gBAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;gBAAC,OAAO,IAAI,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,OAAO,KAAK,CAAC;YAAC,CAAC;QACpF,CAAC,CAAC;QAEF,6BAA6B;QAC7B,IAAI,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;YACxB,+DAA+D;YAC/D,IAAI,GAAG,CAAC,eAAe,CAAC,IAAI,GAAG,CAAC,oBAAoB,CAAC;gBAAE,OAAO,YAAY,CAAC;YAC3E,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;YACzD,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;oBAC3D,MAAM,OAAO,GAAG;wBACd,GAAG,CAAC,GAAG,CAAC,cAAc,CAAwC,IAAI,EAAE,CAAC;wBACrE,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAwC,IAAI,EAAE,CAAC;qBACzE,CAAC;oBACF,IAAI,YAAY,IAAI,OAAO;wBAAE,OAAO,YAAY,CAAC;gBACnD,CAAC;gBAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;YAChC,CAAC;YACD,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,UAAU;QACV,IAAI,GAAG,CAAC,YAAY,CAAC;YAAE,OAAO,MAAM,CAAC;QAErC,YAAY;QACZ,IAAI,GAAG,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,kBAAkB,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5F,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,WAAW;QACX,IAAI,GAAG,CAAC,eAAe,CAAC;YAAE,OAAO,OAAO,CAAC;QAEzC,QAAQ;QACR,IAAI,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAE/B,UAAU;QACV,IAAI,GAAG,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC;YAAE,OAAO,MAAM,CAAC;QAErD,mBAAmB;QACnB,IAAI,GAAG,CAAC,SAAS,CAAC;YAAE,OAAO,MAAM,CAAC;QAClC,IAAI,GAAG,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACnD,mCAAmC;YACnC,OAAO,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;QACrD,CAAC;QAED,sCAAsC;QACtC,OAAO,2BAA2B,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,SAAS,2BAA2B,CAAC,GAAW;IAC9C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,MAAM,MAAM,GAA2B,EAAE,CAAC;QAE1C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;gBAAE,SAAS;YAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YACnD,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,YAAY,CAAC;gBAAE,SAAS;YAC7C,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;QAED,kCAAkC;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YACnE,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;gBAC/B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;oBAAE,SAAS;gBAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;gBACnD,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,YAAY,CAAC;oBAAE,SAAS;gBAC7C,oCAAoC;gBACpC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,wBAAwB,CAAC,CAAC;QAEpC,IAAI,OAAO,GAAkB,IAAI,CAAC;QAClC,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;gBACtB,SAAS,GAAG,KAAK,CAAC;gBAClB,OAAO,GAAG,GAAG,CAAC;YAChB,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CAAC,QAAgB;IACrC,IAAI,CAAC;QACH,2DAA2D;QAC3D,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAElC,gCAAgC;QAChC,IAAI,EAAE,CAAC,cAAc,EAAE;YAAE,OAAO,SAAS,CAAC;QAE1C,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;YACrB,iCAAiC;YACjC,IAAI,SAAS,CAAC,QAAQ,CAAC;gBAAE,OAAO,MAAM,CAAC;YAEvC,+BAA+B;YAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACrC,IAAI,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,YAAY,CAAC;YAExD,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;YAChB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;YAEjD,cAAc;YACd,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO,KAAK,CAAC;YAE1C,WAAW;YACX,IAAI,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO,OAAO,CAAC;YAE9C,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/core/config.d.ts

@@ -0,0 +1,63 @@
+import type { AshlrConfig } from './types.js';
+/** Absolute path to the hub's config/index home: ~/.ashlr */
+export declare const CONFIG_DIR: string;
+/** Absolute path to the config file: ~/.ashlr/config.json */
+export declare const CONFIG_PATH: string;
+/** Absolute path to the index file: ~/.ashlr/index.json */
+export declare const INDEX_PATH: string;
+/**
+ * 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 declare function learnDir(): string;
+/**
+ * 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 declare function qualityDir(): string;
+/**
+ * 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 declare function goalsDir(): string;
+/**
+ * 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 declare function digestsDir(): string;
+/**
+ * Produce a sensible default AshlrConfig for a fresh install.
+ * All paths are resolved to absolute values (no ~ remaining).
+ */
+export declare function defaultConfig(): AshlrConfig;
+/**
+ * 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 declare function loadConfig(): AshlrConfig;
+/**
+ * Persist `c` to CONFIG_PATH as pretty-printed JSON.
+ * Creates CONFIG_DIR if it does not yet exist.
+ */
+export declare function saveConfig(c: AshlrConfig): void;