@ddtcorex/dsh-maestro-memory 1.0.1

package/lib/skills-browser.js

@@ -0,0 +1,185 @@
+/**
+ * host/skills-browser.ts — M6 read-first skills browser
+ *
+ * Goal: expose existing Maestro skills without taking ownership.
+ * - Confirm boundary with maestro-skills and list metadata/origin only.
+ * - Read-only: no mutation, no write API.
+ * - Model suggestions cannot change skills.
+ * - Browser cannot alter maestro-skills discovery behavior (no provider registration, no writes).
+ *
+ * If later approved to edit, mutation must require explicit user action and
+ * symlink/path containment tests before any write support. This file prepares
+ * the containment helper (isPathContained) and documents the guard, but does
+ * not implement mutation in M6.
+ *
+ * NOTE for future mutation (NOT implemented in M6):
+ * Any future mutation endpoint must require an explicit user action
+ * (UI click with confirmation) and must verify path containment via
+ * isPathContained(targetPath, allowedRoot) including realpath resolution
+ * for symlinks, rejecting any traversal or symlink escape. Tests for
+ * symlink/path containment must pass before mutation is enabled.
+ */
+import { existsSync, readdirSync, statSync, lstatSync, readFileSync } from 'node:fs';
+import { join, resolve, relative } from 'node:path';
+/**
+ * Whether child is contained inside parent (no traversal escape).
+ * Uses resolved absolute paths and checks relative path does not start with "..".
+ * This helper prepares symlink/path containment tests required before any
+ * future mutation support — explicit user action + containment check.
+ */
+export function isPathContained(child, parent) {
+    const resolvedChild = resolve(child);
+    const resolvedParent = resolve(parent);
+    if (resolvedChild === resolvedParent)
+        return true;
+    const rel = relative(resolvedParent, resolvedChild);
+    // contained if rel does not start with ".." and is not absolute
+    return rel !== '' && !rel.startsWith('..') && !rel.startsWith('/');
+}
+function parseFrontmatter(rawContent) {
+    if (!rawContent.startsWith('---'))
+        return { metadata: {}, body: rawContent };
+    const endIdx = rawContent.indexOf('\n---', 3);
+    if (endIdx === -1)
+        return { metadata: {}, body: rawContent };
+    const yamlLines = rawContent.slice(3, endIdx).split('\n');
+    const body = rawContent.slice(endIdx + 4).trim();
+    const metadata = {};
+    let blockKey;
+    for (const line of yamlLines) {
+        const trimmed = line.trim();
+        const indent = line.length - trimmed.length;
+        if (blockKey !== undefined) {
+            if (trimmed === '') {
+                blockKey = undefined;
+                continue;
+            }
+            if (indent > 0) {
+                metadata[blockKey] = (metadata[blockKey] + ' ' + trimmed).replace(/\s+/g, ' ').trim();
+                continue;
+            }
+            blockKey = undefined;
+        }
+        const colonIdx = trimmed.indexOf(':');
+        if (colonIdx <= 0)
+            continue;
+        const key = trimmed.slice(0, colonIdx).trim();
+        const val = trimmed.slice(colonIdx + 1).trim();
+        if (val.startsWith('|') || val.startsWith('>')) {
+            metadata[key] = '';
+            blockKey = key;
+            continue;
+        }
+        metadata[key] = val.startsWith('"') && val.endsWith('"') ? val.slice(1, -1) : val;
+    }
+    return { metadata, body };
+}
+/**
+ * List skills from a single directory, read-only.
+ * - Scans <skillsDir>/* /SKILL.md
+ * - Parses frontmatter for name/description
+ * - Returns metadata/origin only, does not return body/content
+ * - Does not follow symlink escapes for future mutation; for listing we
+ *   report the logical path, but future mutation will verify containment via
+ *   isPathContained + realpath.
+ */
+export function listSkillsSync(skillsDir, origin = 'custom') {
+    if (!skillsDir)
+        return [];
+    let entries = [];
+    try {
+        entries = readdirSync(skillsDir);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const entry of entries) {
+        const skillFolder = join(skillsDir, entry);
+        let st = null;
+        try {
+            st = lstatSync(skillFolder);
+        }
+        catch {
+            continue;
+        }
+        // allow directory or symlink to directory
+        const isDir = st.isDirectory() || st.isSymbolicLink();
+        if (!isDir)
+            continue;
+        // verify it is a directory (follow symlink)
+        try {
+            const follow = statSync(skillFolder);
+            if (!follow.isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        const skillFilePath = join(skillFolder, 'SKILL.md');
+        try {
+            const fileSt = statSync(skillFilePath);
+            if (!fileSt.isFile())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        let rawContent = '';
+        try {
+            rawContent = readFileSync(skillFilePath, 'utf8');
+        }
+        catch {
+            continue;
+        }
+        const { metadata } = parseFrontmatter(rawContent);
+        const skillName = metadata.name || entry;
+        const description = metadata.description || `Skill for ${skillName}`;
+        out.push({
+            name: skillName,
+            description,
+            origin,
+            path: skillFilePath,
+            locator: skillFilePath,
+            metadata,
+        });
+    }
+    return out;
+}
+/**
+ * Async variant aggregating multiple roots.
+ * Each root is { dir, origin }. If only skillsDir is supplied, use that.
+ */
+export async function listSkills(opts = {}) {
+    if (opts.roots && opts.roots.length > 0) {
+        const all = [];
+        for (const r of opts.roots) {
+            const entries = listSkillsSync(r.dir, r.origin);
+            all.push(...entries);
+        }
+        return all;
+    }
+    if (opts.skillsDir) {
+        return listSkillsSync(opts.skillsDir, opts.origin ?? 'custom');
+    }
+    // default: no dir => empty (caller should supply maestro-skills dir explicitly)
+    return [];
+}
+/**
+ * Resolve default maestro-skills directory for browser (read-only).
+ * Tries well-known checkout location; returns null if not present.
+ * This does NOT alter maestro-skills discovery — it only reads the directory
+ * if it exists, for metadata/origin listing.
+ */
+export function resolveDefaultMaestroSkillsDir() {
+    const candidates = [
+        '/home/kai/Work/htdocs/maestro-harness/maestro-skills/skills',
+        join(process.cwd(), '../maestro-skills/skills'),
+    ];
+    for (const c of candidates) {
+        if (existsSync(c))
+            return c;
+    }
+    return null;
+}
+//# sourceMappingURL=skills-browser.js.map

package/lib/skills-browser.js.map

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

package/lib/storage/atomic-store.d.ts

@@ -0,0 +1,211 @@
+/**
+ * Atomic file store for Maestro memory — per-directory lock, temp-write/rename,
+ * reread validation, backups, duplicate detection.
+ *
+ * Each mutation:
+ *  1. Acquires a same-directory lock file (.maestro.lock) with stale detection
+ *     (mtime timeout + pid liveness via kill(pid,0)).
+ *  2. Validates the on-disk content round-trips through parseEntries/serializeEntries.
+ *     Non-canonical files are backed up to `<file>.bak.<timestamp>` before the
+ *     operation is refused (drift guard).
+ *  3. Checks for exact duplicates (ID-stripped) so re-adds are no-ops.
+ *  4. Writes to a same-directory temp file (`.<uuid>.tmp`, mode 0o600, flag wx),
+ *     fsyncs the temp, renames atomically over the target, fsyncs the parent
+ *     directory on POSIX, then rereads and validates the result.
+ *  5. Cleans up the temp file on any failure; the previous file is never
+ *     clobbered on error.
+ *
+ * Uses only `node:fs` / `node:fs/promises` atomic primitives: open(wx),
+ * writeFile, fsync, rename, unlink. No third-party dependencies.
+ *
+ * @module storage/atomic-store
+ */
+/** Entry delimiter, byte-compatible with Hermes MEMORY.md / USER.md. */
+export declare const ENTRY_DELIMITER = "\n\u00A7\n";
+/**
+ * Split raw file text into trimmed, non-empty entries.
+ * @param text - raw file content
+ * @returns entries
+ */
+export declare function parseEntries(text: string): string[];
+/**
+ * Serialize entries into canonical file text.
+ * @param entries - entries to serialize
+ * @returns canonical file content (entries joined by delimiter + trailing newline)
+ */
+export declare function serializeEntries(entries: string[]): string;
+/**
+ * Whether raw text is the canonical serialization of its own entries.
+ * Blank / whitespace-only text counts as canonical (empty store).
+ * @param text - raw file content
+ * @returns true when round-tripping preserves the text
+ */
+export declare function isCanonical(text: string): boolean;
+/**
+ * Strip the `[id:xxxxxxxx]` prefix from an entry, if present.
+ * @param entry - full entry text
+ * @returns text without the ID prefix
+ */
+export declare function stripEntryId(entry: string): string;
+/**
+ * Check whether `candidate` already exists in `entries`, comparing after
+ * stripping IDs so a re-add with a new random ID is still detected as a
+ * duplicate (IDs are random per write, direct includes would never hit).
+ * @param entries - existing entries
+ * @param candidate - new entry text
+ * @returns true when a duplicate exists
+ */
+export declare function isDuplicate(entries: string[], candidate: string): boolean;
+/**
+ * Find the exact index of `exact` in `entries`, ID-immune (strip-and-compare).
+ * Returns -1 when not found or when multiple hits make the match ambiguous.
+ * @param entries - existing entries
+ * @param exact - full entry text to find
+ * @returns index or -1
+ */
+export declare function findExactIndex(entries: string[], exact: string): number;
+/** A lock file older than this is considered abandoned (stale). */
+export declare const STALE_LOCK_MS = 10000;
+/** How long to keep waiting for the lock before failing. */
+export declare const LOCK_TIMEOUT_MS = 5000;
+/** Spin interval while waiting for the lock. */
+export declare const LOCK_RETRY_MS = 25;
+/** Lock file name inside each directory. */
+export declare const LOCK_FILE = ".maestro.lock";
+/**
+ * Determine whether a lock is stale (exported for tests): mtime timeout or
+ * the pid inside the lock file is no longer alive (killed / power loss ->
+ * stale immediately without waiting for timeout).
+ * @param lockPath - lock file path
+ * @returns true when stale
+ */
+export declare function isStaleLock(lockPath: string): boolean;
+/** Async variant of stale check for the async lock path. */
+export declare function isStaleLockAsync(lockPath: string): Promise<boolean>;
+/**
+ * Acquire the directory lock synchronously, run `fn`, release.
+ * Reentrant within this process (outer section remains exclusive vs others).
+ * @param dir - directory whose lock to take
+ * @param fn - critical section
+ * @returns section result
+ */
+export declare function withLockSync<T>(dir: string, fn: () => T): T;
+/**
+ * Acquire the directory lock asynchronously, run `fn`, release.
+ * Reentrant within this process.
+ * @param dir - directory whose lock to take
+ * @param fn - critical section (may be async)
+ * @returns section result
+ */
+export declare function withLock<T>(dir: string, fn: () => T | Promise<T>): Promise<T>;
+/**
+ * Create a backup of `filePath` at `<file>.bak.<timestamp>`.
+ * Returns the backup path, or null when the source does not exist.
+ * @param filePath - file to back up
+ * @returns backup path or null
+ */
+export declare function createBackupSync(filePath: string): string | null;
+/**
+ * Async backup.
+ * @param filePath - file to back up
+ * @returns backup path or null
+ */
+export declare function createBackup(filePath: string): Promise<string | null>;
+/**
+ * Durably replace `filePath` with `content` via same-directory temp file,
+ * fsync, atomic rename, directory fsync, and reread validation.
+ * @param filePath - absolute target file path
+ * @param content - full new file content
+ */
+export declare function writeAtomic(filePath: string, content: string): Promise<void>;
+/**
+ * Synchronous atomic write (same guarantees, blocking).
+ * @param filePath - absolute target file path
+ * @param content - full new file content
+ */
+export declare function writeAtomicSync(filePath: string, content: string): void;
+/**
+ * Read entries from `filePath`. Missing file yields [].
+ * @param filePath - file to read
+ * @returns parsed entries
+ */
+export declare function readEntriesSync(filePath: string): string[];
+/**
+ * Async read entries.
+ * @param filePath - file to read
+ * @returns parsed entries
+ */
+export declare function readEntries(filePath: string): Promise<string[]>;
+/**
+ * Append `entry` to `filePath` atomically, with duplicate detection and
+ * drift-guard backup.
+ *
+ * - Acquires per-directory lock.
+ * - Validates existing content is canonical; if not, backs up and throws.
+ * - Checks for duplicate (ID-stripped); returns `{duplicate:true}` without writing.
+ * - Writes via temp+rename+reread.
+ *
+ * @param filePath - target file
+ * @param entry - entry to append (already trimmed)
+ * @returns result
+ */
+export declare function appendEntryAtomic(filePath: string, entry: string): Promise<{
+    ok: true;
+    duplicate?: boolean;
+    entries: string[];
+} | {
+    ok: false;
+    error: string;
+    backup?: string;
+}>;
+/**
+ * Synchronous variant of appendEntryAtomic.
+ * @param filePath - target file
+ * @param entry - entry to append
+ * @returns result
+ */
+export declare function appendEntryAtomicSync(filePath: string, entry: string): {
+    ok: true;
+    duplicate?: boolean;
+    entries: string[];
+} | {
+    ok: false;
+    error: string;
+    backup?: string;
+};
+/**
+ * Replace or remove via atomic write with drift guard and backup.
+ * Caller provides the next entries array; this validates, backs up on drift, and writes.
+ * @param filePath - target file
+ * @param nextEntries - complete new entries array
+ * @returns result
+ */
+export declare function writeEntriesAtomic(filePath: string, nextEntries: string[]): Promise<{
+    ok: true;
+    entries: string[];
+} | {
+    ok: false;
+    error: string;
+    backup?: string;
+}>;
+/**
+ * Synchronous variant.
+ * @param filePath - target file
+ * @param nextEntries - complete new entries array
+ * @returns result
+ */
+export declare function writeEntriesAtomicSync(filePath: string, nextEntries: string[]): {
+    ok: true;
+    entries: string[];
+} | {
+    ok: false;
+    error: string;
+    backup?: string;
+};
+/**
+ * Stable 12-hex project hash for a cwd.
+ * @param cwd - working directory
+ * @returns 12-char hash
+ */
+export declare function projectHash(cwd: string): string;
+//# sourceMappingURL=atomic-store.d.ts.map

package/lib/storage/atomic-store.d.ts.map

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