@ashlr/hub 2.2.0

package/dist/core/swarm/store.js

@@ -0,0 +1,195 @@
+/**
+ * Swarm persistence store.
+ *
+ * Provides atomic-ish read/write for SwarmRun records to ~/.ashlr/swarms/.
+ * All functions are synchronous (matching the RunState/config store pattern),
+ * never throw, and never carry secret values in any logged/persisted output.
+ *
+ * Layout:
+ *   ~/.ashlr/swarms/<id>.json   — pretty-printed SwarmRun (one file per run)
+ *
+ * Atomic-ish write strategy: write to a .tmp sibling, then rename over the
+ * target.  On POSIX this is an atomic rename; on Windows it is best-effort
+ * (rename over existing file may fail, in which case we fall back to a direct
+ * write).  Avoids leaving a partially-written record visible to readers.
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, writeFileSync, } from 'node:fs';
+// ---------------------------------------------------------------------------
+// Bounded list cap — never read more than this many swarm files at once.
+// Prevents pathological I/O if the directory grows very large.
+// ---------------------------------------------------------------------------
+const MAX_LIST = 200;
+// ---------------------------------------------------------------------------
+// swarmsDir
+// ---------------------------------------------------------------------------
+/**
+ * Absolute path to the swarms persistence directory: `~/.ashlr/swarms`.
+ * Re-resolved from `homedir()` on every call so tests that mutate HOME work.
+ */
+export function swarmsDir() {
+    return join(homedir(), '.ashlr', 'swarms');
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/** Ensure the swarms directory exists, silently creating it if needed. */
+function ensureDir(dir) {
+    try {
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+    }
+    catch {
+        // Best-effort; if we can't create the dir the subsequent write will fail
+        // gracefully in saveSwarm's try/catch.
+    }
+}
+/**
+ * Return the absolute path for a swarm record by id.
+ *
+ * Validates the id charset (mirrors orchestrator.ts runFilePath) so the store
+ * is self-defending against path traversal / separator injection regardless of
+ * how a caller derived the id (e.g. GET /api/swarm/:id). Allowed: word chars,
+ * dot, hyphen. Anything else throws.
+ */
+function swarmPath(dir, id) {
+    if (!/^[\w.-]+$/.test(id)) {
+        throw new Error('Invalid swarm id');
+    }
+    return join(dir, `${id}.json`);
+}
+// ---------------------------------------------------------------------------
+// saveSwarm
+// ---------------------------------------------------------------------------
+/**
+ * Persist a SwarmRun record to disk.
+ *
+ * Strategy:
+ *   1. Ensure the swarms directory exists.
+ *   2. Serialize to pretty-printed JSON (trailing newline for POSIX hygiene).
+ *   3. Write to a `.tmp` sibling file.
+ *   4. Rename the `.tmp` over the target path (atomic on POSIX).
+ *   5. If the rename fails (e.g. Windows cross-device), fall back to a direct
+ *      overwrite.
+ *
+ * Never throws; failures are silently swallowed so a persistence error never
+ * crashes the swarm runner mid-execution.
+ */
+export function saveSwarm(s) {
+    try {
+        const dir = swarmsDir();
+        ensureDir(dir);
+        const target = swarmPath(dir, s.id);
+        const tmp = `${target}.tmp`;
+        const json = JSON.stringify(s, null, 2) + '\n';
+        writeFileSync(tmp, json, 'utf8');
+        try {
+            renameSync(tmp, target);
+        }
+        catch {
+            // Rename failed (Windows cross-device, or race) — direct overwrite.
+            try {
+                writeFileSync(target, json, 'utf8');
+            }
+            catch {
+                // Last-resort: swallow; the .tmp may be readable for recovery.
+            }
+        }
+    }
+    catch {
+        // Never propagate persistence failures to the caller.
+    }
+}
+// ---------------------------------------------------------------------------
+// loadSwarm
+// ---------------------------------------------------------------------------
+/**
+ * Load and deserialise a single SwarmRun by id.
+ *
+ * Returns `null` when the record does not exist, cannot be read, or fails to
+ * parse as a valid-looking SwarmRun.  Never throws.
+ */
+export function loadSwarm(id) {
+    try {
+        const dir = swarmsDir();
+        const path = swarmPath(dir, id);
+        if (!existsSync(path))
+            return null;
+        const raw = readFileSync(path, 'utf8');
+        const parsed = JSON.parse(raw);
+        // Basic shape guard: must be an object with a matching id field.
+        if (typeof parsed !== 'object' ||
+            parsed === null ||
+            Array.isArray(parsed) ||
+            parsed['id'] !== id) {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// listSwarms
+// ---------------------------------------------------------------------------
+/**
+ * List all persisted SwarmRun records, sorted by `updatedAt` descending
+ * (most-recent first).
+ *
+ * - Reads at most `MAX_LIST` (200) files to bound I/O on large directories.
+ * - Skips `.tmp` sidecars and any file that fails to parse.
+ * - Never throws.
+ */
+export function listSwarms() {
+    try {
+        const dir = swarmsDir();
+        if (!existsSync(dir))
+            return [];
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return [];
+        }
+        // Filter to *.json (exclude .tmp sidecars and other artefacts), then cap.
+        const jsonFiles = entries
+            .filter((f) => f.endsWith('.json') && !f.endsWith('.tmp.json'))
+            .slice(0, MAX_LIST);
+        const swarms = [];
+        for (const file of jsonFiles) {
+            try {
+                const raw = readFileSync(join(dir, file), 'utf8');
+                const parsed = JSON.parse(raw);
+                if (typeof parsed !== 'object' ||
+                    parsed === null ||
+                    Array.isArray(parsed)) {
+                    continue;
+                }
+                swarms.push(parsed);
+            }
+            catch {
+                // Skip unreadable / malformed records silently.
+            }
+        }
+        // Sort: most-recently-updated first.
+        swarms.sort((a, b) => {
+            const ta = a.updatedAt ?? '';
+            const tb = b.updatedAt ?? '';
+            // ISO timestamps sort lexicographically; descending = b before a.
+            if (tb > ta)
+                return 1;
+            if (tb < ta)
+                return -1;
+            return 0;
+        });
+        return swarms;
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/core/swarm/store.js.map

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

package/dist/core/tidy.d.ts

@@ -0,0 +1,32 @@
+/**
+ * src/core/tidy.ts
+ *
+ * Plan and apply tidy moves for loose top-level files on the Desktop root.
+ *
+ * planTidy()  — dry-run; examines only direct children of the Desktop root
+ *               (the root in cfg.roots that is NOT under github/).
+ *               Never plans to move: keepers, category folders, symlinks,
+ *               the github/ dir, or git repos.
+ *
+ * applyTidy() — execute plan.moves; collision-safe (skip if dest exists or
+ *               source is already gone); mkdir -p dest dirs as needed.
+ */
+import type { AshlrConfig, TidyPlan } from './types.js';
+/**
+ * Plan a tidy pass over the Desktop root.
+ *
+ * Only direct children of the root are examined (depth 1).
+ * Moves are first-match-wins against cfg.tidyRules.
+ * Items with no matching rule are recorded in skipped[].
+ */
+export declare function planTidy(cfg: AshlrConfig): TidyPlan;
+/**
+ * Execute a previously computed TidyPlan.
+ *
+ * For each move:
+ *  - Create the destination directory (mkdir -p) if needed.
+ *  - Skip (safe) if the source no longer exists.
+ *  - Skip (safe) if the destination path already exists (collision).
+ *  - Use fs.renameSync; falls back to copy+unlink if cross-device.
+ */
+export declare function applyTidy(plan: TidyPlan): void;

package/dist/core/tidy.js

@@ -0,0 +1,354 @@
+/**
+ * src/core/tidy.ts
+ *
+ * Plan and apply tidy moves for loose top-level files on the Desktop root.
+ *
+ * planTidy()  — dry-run; examines only direct children of the Desktop root
+ *               (the root in cfg.roots that is NOT under github/).
+ *               Never plans to move: keepers, category folders, symlinks,
+ *               the github/ dir, or git repos.
+ *
+ * applyTidy() — execute plan.moves; collision-safe (skip if dest exists or
+ *               source is already gone); mkdir -p dest dirs as needed.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the Desktop root from cfg.roots.
+ * We want the root that is NOT inside a github/ subtree — i.e. the Desktop
+ * itself, not the github scan root that may also be listed.
+ */
+function isGithubPath(p) {
+    const normalized = path.normalize(p);
+    if (path.basename(normalized) === 'github')
+        return true;
+    return normalized.split(path.sep).includes('github');
+}
+function desktopRoot(cfg) {
+    for (const r of cfg.roots) {
+        // If this root is NOT the github/ dir itself (and not inside one), treat
+        // it as the Desktop root.
+        if (!isGithubPath(r)) {
+            return r;
+        }
+    }
+    // No non-github root exists — refuse to operate (do NOT fall back to
+    // cfg.roots[0], which would be the github container and risk moving the
+    // category dirs). Caller treats null as "empty plan".
+    return null;
+}
+/**
+ * Detect a git repo without importing git.ts (which may be an unimplemented
+ * stub in early build stages). A directory is a repo when it contains a
+ * `.git` entry (directory OR file — the latter covers worktrees/submodules).
+ */
+function isGitRepo(dir) {
+    try {
+        const gitPath = path.join(dir, '.git');
+        fs.accessSync(gitPath); // throws if absent
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolve whether `name` (or `fullPath`) is a keeper.
+ * Keepers may be stored as absolute paths OR bare basenames.
+ */
+function isKeeper(fullPath, name, keepers) {
+    for (const k of keepers) {
+        if (k === name || k === fullPath)
+            return true;
+        // Treat entries like "Rent Application.pdf" as basename matchers.
+        if (path.basename(k) === name)
+            return true;
+    }
+    return false;
+}
+/**
+ * Test whether `name` is a known category folder (the folder itself, not
+ * contents — we never move the category container).
+ */
+function isCategoryFolder(fullPath, categories) {
+    return Object.values(categories).some((catPath) => catPath === fullPath);
+}
+// ---------------------------------------------------------------------------
+// Glob / regex / ext matching
+// ---------------------------------------------------------------------------
+/**
+ * Convert a shell glob pattern to a RegExp.
+ * Supports: * (any chars except /), ** (any chars incl /), ? (single char),
+ * and character classes [abc].
+ * For tidy purposes we match against the basename only when the glob has
+ * no path separator, or against the full path when it does.
+ */
+function globToRegex(glob) {
+    let src = '';
+    let i = 0;
+    while (i < glob.length) {
+        const ch = glob[i];
+        if (ch === '*' && glob[i + 1] === '*') {
+            src += '.*';
+            i += 2;
+            // Consume optional trailing /
+            if (glob[i] === '/')
+                i++;
+        }
+        else if (ch === '*') {
+            src += '[^/]*';
+            i++;
+        }
+        else if (ch === '?') {
+            src += '[^/]';
+            i++;
+        }
+        else if (ch === '[') {
+            // Pass character class through verbatim until ]
+            const end = glob.indexOf(']', i + 1);
+            if (end === -1) {
+                src += '\\[';
+                i++;
+            }
+            else {
+                src += glob.slice(i, end + 1);
+                i = end + 1;
+            }
+        }
+        else {
+            // Escape regex meta chars
+            src += ch.replace(/[.+^${}()|\\]/g, '\\$&');
+            i++;
+        }
+    }
+    return new RegExp(`^${src}$`, 'i');
+}
+/**
+ * Return true if `itemPath` matches a TidyRule.
+ * For 'ext'  → compare lowercased extension (with leading dot).
+ * For 'glob' → match against basename (no separator in glob) or full path.
+ * For 'regex'→ match against basename.
+ */
+function matchesRule(itemPath, rule) {
+    const name = path.basename(itemPath);
+    const ext = path.extname(name).toLowerCase();
+    switch (rule.matchType) {
+        case 'ext': {
+            // Normalise: accept ".pdf" or "pdf"
+            const ruleExt = rule.match.startsWith('.') ? rule.match.toLowerCase() : `.${rule.match.toLowerCase()}`;
+            return ext === ruleExt;
+        }
+        case 'glob': {
+            const globHasPath = rule.match.includes('/');
+            if (globHasPath) {
+                return globToRegex(rule.match).test(itemPath);
+            }
+            return globToRegex(rule.match).test(name);
+        }
+        case 'regex': {
+            try {
+                return new RegExp(rule.match, 'i').test(name);
+            }
+            catch {
+                // Malformed regex — never match, don't crash.
+                return false;
+            }
+        }
+        default:
+            return false;
+    }
+}
+/**
+ * Resolve a destination directory from a TidyRule.
+ * If `dest` is relative, resolve it relative to `root`.
+ * If `dest` is absolute, use it as-is.
+ */
+function resolveDest(dest, root) {
+    return path.isAbsolute(dest) ? dest : path.resolve(root, dest);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Plan a tidy pass over the Desktop root.
+ *
+ * Only direct children of the root are examined (depth 1).
+ * Moves are first-match-wins against cfg.tidyRules.
+ * Items with no matching rule are recorded in skipped[].
+ */
+export function planTidy(cfg) {
+    const moves = [];
+    const skipped = [];
+    const root = desktopRoot(cfg);
+    if (!root) {
+        return { moves, skipped };
+    }
+    // Unconditional github protection: never operate when the resolved root is
+    // (or is under) a github container. desktopRoot() already excludes these,
+    // but assert it here so the invariant holds even if selection logic changes.
+    if (isGithubPath(root)) {
+        return { moves, skipped };
+    }
+    let entries;
+    try {
+        entries = fs.readdirSync(root, { withFileTypes: true });
+    }
+    catch {
+        // Root unreadable — return empty plan.
+        return { moves, skipped };
+    }
+    for (const entry of entries) {
+        const fullPath = path.join(root, entry.name);
+        // 1. Skip symlinks — never plan to move them.
+        if (entry.isSymbolicLink()) {
+            skipped.push({ path: fullPath, reason: 'symlink' });
+            continue;
+        }
+        // 2. Skip the github/ directory itself.
+        if (entry.name === 'github' && entry.isDirectory()) {
+            skipped.push({ path: fullPath, reason: 'github directory' });
+            continue;
+        }
+        // 3. Skip keepers.
+        if (isKeeper(fullPath, entry.name, cfg.keepers)) {
+            skipped.push({ path: fullPath, reason: 'keeper' });
+            continue;
+        }
+        // 4. Skip category folders themselves (don't move the container).
+        if (entry.isDirectory() && isCategoryFolder(fullPath, cfg.categories)) {
+            skipped.push({ path: fullPath, reason: 'category folder' });
+            continue;
+        }
+        // 5. Skip git repos — they are managed by the index, not tidy.
+        if (entry.isDirectory() && isGitRepo(fullPath)) {
+            skipped.push({ path: fullPath, reason: 'git repo' });
+            continue;
+        }
+        // Tidy rules only apply to regular files. A loose top-level DIRECTORY that
+        // passed the keeper/category/repo guards must never be moved wholesale by
+        // a basename glob like 'Screenshot*' or '*Contract*' (which would relocate
+        // an entire 'Contracts' or 'Q1 Invoices' folder). Record it as skipped.
+        if (!entry.isFile()) {
+            skipped.push({ path: fullPath, reason: 'directory — tidy rules apply to files only' });
+            continue;
+        }
+        // 6. Find first matching tidy rule.
+        let matched = false;
+        for (const rule of cfg.tidyRules) {
+            if (matchesRule(fullPath, rule)) {
+                const destDir = resolveDest(rule.dest, root);
+                const destPath = path.join(destDir, entry.name);
+                const ruleLabel = rule.description ?? `${rule.matchType}:${rule.match} → ${rule.dest}`;
+                matched = true;
+                // Destination safety: never let a (possibly custom) rule write into a
+                // github/ subtree or onto a keeper path. Skip with a clear reason.
+                if (isGithubPath(destDir) || isKeeper(destPath, entry.name, cfg.keepers)) {
+                    skipped.push({ path: fullPath, reason: `unsafe destination: ${destDir}` });
+                    break;
+                }
+                // Collision: a file already exists at the destination. Surface this in
+                // the dry-run plan as a skip rather than planning a move applyTidy()
+                // would later refuse to perform (it never overwrites).
+                if (fs.existsSync(destPath)) {
+                    skipped.push({ path: fullPath, reason: `collision: ${destPath} already exists` });
+                    break;
+                }
+                moves.push({ from: fullPath, to: destPath, rule: ruleLabel });
+                break; // first-match-wins
+            }
+        }
+        if (!matched) {
+            skipped.push({ path: fullPath, reason: 'no matching rule' });
+        }
+    }
+    return { moves, skipped };
+}
+/**
+ * Execute a previously computed TidyPlan.
+ *
+ * For each move:
+ *  - Create the destination directory (mkdir -p) if needed.
+ *  - Skip (safe) if the source no longer exists.
+ *  - Skip (safe) if the destination path already exists (collision).
+ *  - Use fs.renameSync; falls back to copy+unlink if cross-device.
+ */
+export function applyTidy(plan) {
+    for (const move of plan.moves) {
+        // Safety: never write a move into a github/ subtree, even if a custom rule
+        // produced one. planTidy already guards this, but applyTidy is the last
+        // line of defense before an irreversible rename.
+        if (isGithubPath(path.dirname(move.to))) {
+            continue;
+        }
+        // Safety: re-check source exists.
+        if (!fs.existsSync(move.from)) {
+            continue; // Already gone — idempotent skip.
+        }
+        // Safety: skip if destination already occupied.
+        if (fs.existsSync(move.to)) {
+            continue; // Collision — do not overwrite.
+        }
+        // Ensure destination directory exists.
+        const destDir = path.dirname(move.to);
+        try {
+            fs.mkdirSync(destDir, { recursive: true });
+        }
+        catch {
+            // If we can't create the dir, skip this move rather than crashing.
+            continue;
+        }
+        // Attempt atomic rename.
+        try {
+            fs.renameSync(move.from, move.to);
+        }
+        catch (err) {
+            // EXDEV = cross-device link — copy then unlink.
+            if (isCrossDevice(err)) {
+                try {
+                    fsCopyRecursive(move.from, move.to);
+                    fsRemoveRecursive(move.from);
+                }
+                catch {
+                    // Best-effort; if copy/remove fails, leave source in place.
+                }
+            }
+            // Other errors: silently skip rather than crashing.
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Cross-device fallback helpers (Node builtins only)
+// ---------------------------------------------------------------------------
+function isCrossDevice(err) {
+    return (typeof err === 'object' &&
+        err !== null &&
+        'code' in err &&
+        err.code === 'EXDEV');
+}
+/**
+ * Recursively copy a file or directory tree to `dest`.
+ * Simple implementation using Node builtins — no third-party deps.
+ */
+function fsCopyRecursive(src, dest) {
+    const stat = fs.statSync(src);
+    if (stat.isDirectory()) {
+        fs.mkdirSync(dest, { recursive: true });
+        for (const child of fs.readdirSync(src)) {
+            fsCopyRecursive(path.join(src, child), path.join(dest, child));
+        }
+    }
+    else {
+        fs.copyFileSync(src, dest);
+    }
+}
+/**
+ * Recursively remove a file or directory tree.
+ * Uses rm with recursive + force (Node 14.14+).
+ */
+function fsRemoveRecursive(p) {
+    fs.rmSync(p, { recursive: true, force: true });
+}
+//# sourceMappingURL=tidy.js.map

package/dist/core/tidy.js.map

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

package/dist/core/tools-registry.d.ts

@@ -0,0 +1,16 @@
+/**
+ * core/tools-registry.ts — Detect installed ashlr ecosystem tools + versions.
+ *
+ * Probes each known tool via `which` (binary presence) + a `--version` invocation
+ * (version string). Fast, synchronous, and NEVER throws — a missing or broken
+ * tool yields { installed: false, version: null, path: null }.
+ */
+import type { ToolsRegistry } from './types.js';
+/**
+ * Detect installed ecosystem tools + versions via PATH (which + --version) or
+ * filesystem presence for desktop app tools (e.g. ashlr-md .app bundle).
+ * Fast and NEVER throws — a missing tool yields { installed:false, version:null,
+ * path:null }. Detects: phantom, ashlr/ashlr-plugin, stack, pulse/pulse-agent,
+ * ashlrcode, aw (ashlr-workbench), morphkit, binshield, ashlr-md (app), ashlr-hub.
+ */
+export declare function getToolsRegistry(): ToolsRegistry;