@openrig/cli 0.5.0 → 0.5.1

package/node_modules/@openrig/daemon/dist/domain/files/file-write-service.js

@@ -0,0 +1,259 @@
+// UI Enhancement Pack v0 — atomic file write + JSONL audit.
+//
+// Item 4: operator-actionable write surface for STEERING.md /
+// PROGRESS.md / spec YAML / any allowlisted file. Honors the dashboard
+// precedent's mtime + content-hash invariants (cited as retired-but-
+// instructive from `services/dashboard/bin/server.py:1269-1289`;
+// reimplemented fresh in TypeScript per current OpenRig conventions).
+//
+// Atomic-write semantics:
+//   1. Resolve target path under allowlist root (path-safety from
+//      file-allowlist.ts).
+//   2. Re-stat file: if mtime != expectedMtime OR contentHash !=
+//      expectedContentHash, reject with WriteConflictError carrying
+//      the current mtime + contentHash for the UI to surface.
+//   3. Write content to a temp file in the same directory.
+//   4. fsync the temp file so the write is durable before the rename.
+//   5. Atomic rename over the target path. On POSIX this is a single
+//      inode swap, so other readers either see the old file or the
+//      new file — never a partial write.
+//   6. Compute new mtime + contentHash from the rename'd target.
+//   7. Append one JSONL row to the audit file.
+//
+// The audit file is `~/.openrig/file-edit-audit.jsonl` by default
+// (operator-overridable via env). Append-only; never rotates at v0
+// per PRD § Item 4 (rotation is a future concern).
+import { createHash } from "node:crypto";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { resolveAllowedPath } from "./path-safety.js";
+export class WriteConflictError extends Error {
+    currentMtime;
+    currentContentHash;
+    details;
+    constructor(currentMtime, currentContentHash, details) {
+        super("file changed externally; refresh required before writing");
+        this.currentMtime = currentMtime;
+        this.currentContentHash = currentContentHash;
+        this.details = details;
+        this.name = "WriteConflictError";
+    }
+}
+export class FileWriteError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "FileWriteError";
+    }
+}
+const DEFAULT_AUDIT_FILE = path.join(process.env.HOME ?? process.env.USERPROFILE ?? "/tmp", ".openrig", "file-edit-audit.jsonl");
+export class FileWriteService {
+    allowlist;
+    auditFilePath;
+    now;
+    constructor(opts) {
+        this.allowlist = opts.allowlist;
+        this.auditFilePath = opts.auditFilePath ?? DEFAULT_AUDIT_FILE;
+        this.now = opts.now ?? (() => new Date());
+    }
+    /**
+     * Atomically write content to an allowlisted file. Throws
+     * WriteConflictError on mtime/contentHash mismatch; throws
+     * FileWriteError on stat / temp-write / rename / audit failures.
+     * Returns FileWriteResult with the new mtime + contentHash on
+     * success.
+     */
+    writeAtomic(req) {
+        const target = resolveAllowedPath(this.allowlist, req.rootName, req.path);
+        // Pre-write checks: re-stat + re-hash for conflict detection.
+        let prevStat;
+        let prevContent;
+        try {
+            prevStat = fs.statSync(target);
+            prevContent = fs.readFileSync(target);
+        }
+        catch (err) {
+            throw new FileWriteError("stat_failed", `failed to read '${target}' for conflict detection: ${err instanceof Error ? err.message : String(err)}`, { target });
+        }
+        const prevMtime = prevStat.mtime.toISOString();
+        const prevContentHash = sha256Hex(prevContent);
+        if (prevMtime !== req.expectedMtime || prevContentHash !== req.expectedContentHash) {
+            throw new WriteConflictError(prevMtime, prevContentHash, {
+                target,
+                expectedMtime: req.expectedMtime,
+                expectedContentHash: req.expectedContentHash,
+            });
+        }
+        // Write to temp file in the SAME directory (so atomic rename
+        // works across the same filesystem). Suffix with PID + random
+        // so concurrent writes don't collide.
+        const tmpName = `.openrig-write-${process.pid}-${Math.random().toString(36).slice(2, 10)}-${path.basename(target)}`;
+        const tmpPath = path.join(path.dirname(target), tmpName);
+        let tmpFd = null;
+        try {
+            tmpFd = fs.openSync(tmpPath, "w");
+            fs.writeFileSync(tmpFd, req.content);
+            fs.fsyncSync(tmpFd);
+        }
+        catch (err) {
+            // Clean up temp file if it was partially created.
+            try {
+                if (tmpFd !== null)
+                    fs.closeSync(tmpFd);
+            }
+            catch { /* ignore */ }
+            try {
+                fs.unlinkSync(tmpPath);
+            }
+            catch { /* ignore */ }
+            throw new FileWriteError("tmp_write_failed", `failed to write+fsync temp file at '${tmpPath}': ${err instanceof Error ? err.message : String(err)}`, { target, tmpPath });
+        }
+        finally {
+            try {
+                if (tmpFd !== null)
+                    fs.closeSync(tmpFd);
+            }
+            catch { /* ignore */ }
+        }
+        try {
+            fs.renameSync(tmpPath, target);
+        }
+        catch (err) {
+            // Best-effort cleanup of the orphan temp file. We don't try to
+            // restore the previous content because we never touched the
+            // target (rename failed atomically).
+            try {
+                fs.unlinkSync(tmpPath);
+            }
+            catch { /* ignore */ }
+            throw new FileWriteError("rename_failed", `failed to atomically rename '${tmpPath}' over '${target}': ${err instanceof Error ? err.message : String(err)}`, { target, tmpPath });
+        }
+        // Re-stat to get the new mtime + content hash.
+        const newStat = fs.statSync(target);
+        const newContent = fs.readFileSync(target);
+        const newMtime = newStat.mtime.toISOString();
+        const newContentHash = sha256Hex(newContent);
+        const byteCountDelta = newContent.byteLength - prevContent.byteLength;
+        // Append the audit JSONL row. Failure here is logged but does
+        // NOT undo the write — the user's edit landed; we don't want
+        // audit-system flakes to revert canon edits.
+        const auditRow = {
+            ts: this.now().toISOString(),
+            actor: req.actor,
+            identity_provenance: req.identityProvenance ?? null, // P21 §4 era-stamp (null = claimed-era / UI deferral)
+            root: req.rootName,
+            path: req.path,
+            absolutePath: target,
+            prevMtime,
+            newMtime,
+            prevContentHash,
+            newContentHash,
+            byteCountDelta,
+        };
+        try {
+            this.appendAuditRow(auditRow);
+        }
+        catch (err) {
+            throw new FileWriteError("audit_write_failed", `write succeeded but audit append failed: ${err instanceof Error ? err.message : String(err)}`, { target, auditFilePath: this.auditFilePath, ...auditRow });
+        }
+        return {
+            absolutePath: target,
+            newMtime,
+            newContentHash,
+            byteCountDelta,
+        };
+    }
+    /**
+     * Atomically CREATE a new allowlisted file (OPR.0.4.4.20 FR-6 — the frozen
+     * review export). Exclusive: throws `target_exists` when the file is
+     * already there (frozen exports are point-in-time snapshots, never
+     * rewritten; re-invoking the freeze for the same approval is an idempotent
+     * no-op at the caller). Same temp-write + fsync + audit-row machinery as
+     * writeAtomic — one writer family, no parallel write path.
+     */
+    createAtomic(req) {
+        const target = resolveAllowedPath(this.allowlist, req.rootName, req.path);
+        if (fs.existsSync(target)) {
+            throw new FileWriteError("target_exists", `refusing to overwrite existing file '${target}'`, { target });
+        }
+        const tmpName = `.openrig-write-${process.pid}-${Math.random().toString(36).slice(2, 10)}-${path.basename(target)}`;
+        const tmpPath = path.join(path.dirname(target), tmpName);
+        let tmpFd = null;
+        try {
+            tmpFd = fs.openSync(tmpPath, "w");
+            fs.writeFileSync(tmpFd, req.content);
+            fs.fsyncSync(tmpFd);
+        }
+        catch (err) {
+            try {
+                if (tmpFd !== null)
+                    fs.closeSync(tmpFd);
+            }
+            catch { /* ignore */ }
+            try {
+                fs.unlinkSync(tmpPath);
+            }
+            catch { /* ignore */ }
+            throw new FileWriteError("tmp_write_failed", `failed to write+fsync temp file at '${tmpPath}': ${err instanceof Error ? err.message : String(err)}`, { target, tmpPath });
+        }
+        finally {
+            try {
+                if (tmpFd !== null)
+                    fs.closeSync(tmpFd);
+            }
+            catch { /* ignore */ }
+        }
+        try {
+            // linkSync fails if the target appeared meanwhile — true exclusive create.
+            fs.linkSync(tmpPath, target);
+            fs.unlinkSync(tmpPath);
+        }
+        catch (err) {
+            try {
+                fs.unlinkSync(tmpPath);
+            }
+            catch { /* ignore */ }
+            const code = err.code === "EEXIST" ? "target_exists" : "rename_failed";
+            throw new FileWriteError(code, `failed to atomically create '${target}': ${err instanceof Error ? err.message : String(err)}`, { target, tmpPath });
+        }
+        const newStat = fs.statSync(target);
+        const newContent = fs.readFileSync(target);
+        const newMtime = newStat.mtime.toISOString();
+        const newContentHash = sha256Hex(newContent);
+        const auditRow = {
+            ts: this.now().toISOString(),
+            actor: req.actor,
+            identity_provenance: req.identityProvenance ?? null, // P21 §4 era-stamp (null = claimed-era / UI deferral)
+            root: req.rootName,
+            path: req.path,
+            absolutePath: target,
+            prevMtime: null,
+            newMtime,
+            prevContentHash: null,
+            newContentHash,
+            byteCountDelta: newContent.byteLength,
+        };
+        try {
+            this.appendAuditRow(auditRow);
+        }
+        catch (err) {
+            throw new FileWriteError("audit_write_failed", `create succeeded but audit append failed: ${err instanceof Error ? err.message : String(err)}`, { target, auditFilePath: this.auditFilePath, ...auditRow });
+        }
+        return { absolutePath: target, newMtime, newContentHash, byteCountDelta: newContent.byteLength };
+    }
+    appendAuditRow(row) {
+        fs.mkdirSync(path.dirname(this.auditFilePath), { recursive: true });
+        fs.appendFileSync(this.auditFilePath, `${JSON.stringify(row)}\n`);
+    }
+    /** Test/debug helper: returns the configured audit file path. */
+    getAuditFilePath() {
+        return this.auditFilePath;
+    }
+}
+export function sha256Hex(content) {
+    return createHash("sha256").update(content).digest("hex");
+}
+//# sourceMappingURL=file-write-service.js.map

package/node_modules/@openrig/daemon/dist/domain/files/file-write-service.js.map

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

package/node_modules/@openrig/daemon/dist/domain/files/path-safety.d.ts

@@ -0,0 +1,47 @@
+export interface AllowlistRoot {
+    /** Operator-supplied display name (e.g., "workspace"). */
+    name: string;
+    /** Canonical absolute path on disk. */
+    canonicalPath: string;
+}
+export declare class FilePathSafetyError extends Error {
+    readonly code: "root_unknown" | "path_escape" | "path_invalid" | "stat_failed" | "not_a_file" | "not_a_directory";
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(code: "root_unknown" | "path_escape" | "path_invalid" | "stat_failed" | "not_a_file" | "not_a_directory", message: string, details?: Record<string, unknown> | undefined);
+}
+/**
+ * Decodes a raw `name:/abs/path,name:/abs/path` allowlist string into
+ * canonical AllowlistRoot[]. Whitespace around delimiters trimmed.
+ * Invalid pairs (no colon, empty name, non-absolute path) silently
+ * skipped. Duplicate names: last wins. Same shape both env-var and
+ * settings-file-resolved values produce.
+ */
+export declare function decodeAllowlist(raw: string): AllowlistRoot[];
+/**
+ * Reads the allowlist env var directly and returns the parsed root list.
+ * Preserved for backward-compat callers; v0 callers prefer the resolved
+ * settings-store path which honors env > settings-file > empty.
+ */
+export declare function readAllowlistFromEnv(env?: NodeJS.ProcessEnv): AllowlistRoot[];
+/**
+ * Resolves a relative path against an allowlist root. Throws
+ * FilePathSafetyError on any unsafe condition. Returns the
+ * canonical absolute path on success. Caller is expected to stat
+ * the result to distinguish file/directory.
+ *
+ * Path-safety algorithm:
+ *   1. Validate the root exists in the allowlist (reject "root_unknown").
+ *   2. Reject relative paths that look absolute or contain `..`
+ *      segments (reject "path_invalid" / "path_escape").
+ *   3. Resolve the relative path against the canonical root.
+ *   4. Resolve symlinks: if the realpath does not start with the
+ *      canonical root + path separator, reject "path_escape".
+ *   5. The base case `path = ""` resolves to the root itself (allowed
+ *      so callers can list the root directory).
+ */
+export declare function resolveAllowedPath(allowlist: AllowlistRoot[], rootName: string, relativePath: string): string;
+/** Convenience: resolve + assert the result is an existing regular file. */
+export declare function resolveAllowedFile(allowlist: AllowlistRoot[], rootName: string, relativePath: string): string;
+/** Convenience: resolve + assert the result is an existing directory. */
+export declare function resolveAllowedDirectory(allowlist: AllowlistRoot[], rootName: string, relativePath: string): string;
+//# sourceMappingURL=path-safety.d.ts.map

package/node_modules/@openrig/daemon/dist/domain/files/path-safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-safety.d.ts","sourceRoot":"","sources":["../../../src/domain/files/path-safety.ts"],"names":[],"mappings":"AA+BA,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,mBAAoB,SAAQ,KAAK;aAE1B,IAAI,EAAE,cAAc,GAAG,aAAa,GAAG,cAAc,GAAG,aAAa,GAAG,YAAY,GAAG,iBAAiB;aAExG,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjC,IAAI,EAAE,cAAc,GAAG,aAAa,GAAG,cAAc,GAAG,aAAa,GAAG,YAAY,GAAG,iBAAiB,EACxH,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAKD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,CAqB5D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,aAAa,EAAE,CAK1F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,aAAa,EAAE,EAC1B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,MAAM,CAwDR;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,aAAa,EAAE,EAC1B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,MAAM,CAoBR;AAED,yEAAyE;AACzE,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,aAAa,EAAE,EAC1B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,MAAM,CAoBR"}

package/node_modules/@openrig/daemon/dist/domain/files/path-safety.js

@@ -0,0 +1,176 @@
+// UI Enhancement Pack v0 — file allowlist + path-safety helpers.
+//
+// Daemon-enforced fail-closed path-safety for the operator-allowlisted
+// file browser surface (item 3 + item 4). Reused by all four
+// /api/files/* routes.
+//
+// Allowlist source (driver pivot from PRD's suggested ConfigStore key
+// family — see handoff): OPENRIG_FILES_ALLOWLIST env var, comma-
+// separated `<name>:<absolute-path>` pairs. Operator sets via shell
+// (or via `~/.openrig` env file). Empty / unset → no allowlist roots
+// → routes return empty roots list with a structured "configure
+// OPENRIG_FILES_ALLOWLIST" hint. Default after fresh install: nothing
+// (the safe default per PRD § Item 3).
+//
+// Path-safety contract:
+//   - Each request resolves <relativePath> against <rootName>'s
+//     canonical absolute path.
+//   - Any escape attempt (.., absolute-path passed as relativePath,
+//     symlink whose realpath escapes the root) is rejected with a
+//     structured error.
+//   - Symlinks INSIDE the allowlisted tree resolve normally; symlinks
+//     pointing OUTSIDE the tree are treated as escape attempts.
+//   - Reads/lists never return content from outside the resolved root.
+//
+// MVP single-host context: no per-rig overrides, no remote allowlist
+// management, no audit at allowlist-resolution time (allowlist
+// resolution is read-only). Audit applies to writes only (item 4).
+import * as fs from "node:fs";
+import * as path from "node:path";
+export class FilePathSafetyError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "FilePathSafetyError";
+    }
+}
+const ENV_VAR = "OPENRIG_FILES_ALLOWLIST";
+const LEGACY_ENV_VAR = "RIGGED_FILES_ALLOWLIST";
+/**
+ * Decodes a raw `name:/abs/path,name:/abs/path` allowlist string into
+ * canonical AllowlistRoot[]. Whitespace around delimiters trimmed.
+ * Invalid pairs (no colon, empty name, non-absolute path) silently
+ * skipped. Duplicate names: last wins. Same shape both env-var and
+ * settings-file-resolved values produce.
+ */
+export function decodeAllowlist(raw) {
+    if (!raw.trim())
+        return [];
+    const out = new Map();
+    for (const pair of raw.split(",")) {
+        const trimmed = pair.trim();
+        if (!trimmed)
+            continue;
+        const colon = trimmed.indexOf(":");
+        if (colon === -1)
+            continue;
+        const name = trimmed.slice(0, colon).trim();
+        const rawPath = trimmed.slice(colon + 1).trim();
+        if (!name || !rawPath)
+            continue;
+        if (!path.isAbsolute(rawPath))
+            continue;
+        let canonical;
+        try {
+            canonical = fs.realpathSync(rawPath);
+        }
+        catch {
+            canonical = path.resolve(rawPath);
+        }
+        out.set(name, canonical);
+    }
+    return Array.from(out.entries()).map(([name, canonicalPath]) => ({ name, canonicalPath }));
+}
+/**
+ * Reads the allowlist env var directly and returns the parsed root list.
+ * Preserved for backward-compat callers; v0 callers prefer the resolved
+ * settings-store path which honors env > settings-file > empty.
+ */
+export function readAllowlistFromEnv(env = process.env) {
+    // Use || (not ??) so an empty-string OPENRIG_FILES_ALLOWLIST falls
+    // back to the legacy var. ?? only handles null/undefined.
+    const raw = (env[ENV_VAR] || env[LEGACY_ENV_VAR] || "").toString();
+    return decodeAllowlist(raw);
+}
+/**
+ * Resolves a relative path against an allowlist root. Throws
+ * FilePathSafetyError on any unsafe condition. Returns the
+ * canonical absolute path on success. Caller is expected to stat
+ * the result to distinguish file/directory.
+ *
+ * Path-safety algorithm:
+ *   1. Validate the root exists in the allowlist (reject "root_unknown").
+ *   2. Reject relative paths that look absolute or contain `..`
+ *      segments (reject "path_invalid" / "path_escape").
+ *   3. Resolve the relative path against the canonical root.
+ *   4. Resolve symlinks: if the realpath does not start with the
+ *      canonical root + path separator, reject "path_escape".
+ *   5. The base case `path = ""` resolves to the root itself (allowed
+ *      so callers can list the root directory).
+ */
+export function resolveAllowedPath(allowlist, rootName, relativePath) {
+    const root = allowlist.find((r) => r.name === rootName);
+    if (!root) {
+        throw new FilePathSafetyError("root_unknown", `allowlist root '${rootName}' is not configured. Allowlist configured roots: ${allowlist.map((r) => r.name).join(", ") || "(none)"}.`, { rootName, configuredRoots: allowlist.map((r) => r.name) });
+    }
+    // Reject ../ escape attempts BEFORE filesystem resolution. Even
+    // though step 4 catches realpath escapes, this rejects the
+    // expressed-intent-to-escape with a clearer error code.
+    if (relativePath.includes("..")) {
+        // Distinguish a literal ".." segment from a filename like "foo..bar"
+        // — split on path.sep and `/` and inspect each segment.
+        const segments = relativePath.split(/[\\/]/).filter((s) => s.length > 0);
+        for (const seg of segments) {
+            if (seg === "..") {
+                throw new FilePathSafetyError("path_escape", `relative path '${relativePath}' contains a '..' segment; reject.`, { rootName, relativePath });
+            }
+        }
+    }
+    if (path.isAbsolute(relativePath)) {
+        throw new FilePathSafetyError("path_invalid", `relative path '${relativePath}' must not be absolute (reject).`, { rootName, relativePath });
+    }
+    const candidate = path.resolve(root.canonicalPath, relativePath);
+    let realpath;
+    try {
+        realpath = fs.realpathSync(candidate);
+    }
+    catch {
+        // If the candidate doesn't exist on disk yet, fall back to the
+        // unresolved candidate. Subsequent stat will surface the absence
+        // with a more specific error code.
+        realpath = candidate;
+    }
+    // Containment check with path.sep boundary to avoid the
+    // /foo/bar matching /foo/bar-other false-positive.
+    const rootWithSep = root.canonicalPath.endsWith(path.sep)
+        ? root.canonicalPath
+        : `${root.canonicalPath}${path.sep}`;
+    if (realpath !== root.canonicalPath && !realpath.startsWith(rootWithSep)) {
+        throw new FilePathSafetyError("path_escape", `resolved path '${realpath}' falls outside allowlist root '${rootName}' (${root.canonicalPath}).`, { rootName, relativePath, resolved: realpath, rootCanonical: root.canonicalPath });
+    }
+    return realpath;
+}
+/** Convenience: resolve + assert the result is an existing regular file. */
+export function resolveAllowedFile(allowlist, rootName, relativePath) {
+    const resolved = resolveAllowedPath(allowlist, rootName, relativePath);
+    let stat;
+    try {
+        stat = fs.statSync(resolved);
+    }
+    catch (err) {
+        throw new FilePathSafetyError("stat_failed", `failed to stat '${resolved}': ${err instanceof Error ? err.message : String(err)}`, { rootName, relativePath, resolved });
+    }
+    if (!stat.isFile()) {
+        throw new FilePathSafetyError("not_a_file", `resolved path '${resolved}' is not a regular file.`, { rootName, relativePath, resolved });
+    }
+    return resolved;
+}
+/** Convenience: resolve + assert the result is an existing directory. */
+export function resolveAllowedDirectory(allowlist, rootName, relativePath) {
+    const resolved = resolveAllowedPath(allowlist, rootName, relativePath);
+    let stat;
+    try {
+        stat = fs.statSync(resolved);
+    }
+    catch (err) {
+        throw new FilePathSafetyError("stat_failed", `failed to stat '${resolved}': ${err instanceof Error ? err.message : String(err)}`, { rootName, relativePath, resolved });
+    }
+    if (!stat.isDirectory()) {
+        throw new FilePathSafetyError("not_a_directory", `resolved path '${resolved}' is not a directory.`, { rootName, relativePath, resolved });
+    }
+    return resolved;
+}
+//# sourceMappingURL=path-safety.js.map

package/node_modules/@openrig/daemon/dist/domain/files/path-safety.js.map

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

package/node_modules/@openrig/daemon/dist/domain/gate-predicate.d.ts

@@ -0,0 +1,29 @@
+/** Tag namespace that marks gate work. */
+export declare const GATE_TAG_PREFIX = "gate:";
+/**
+ * Known gate roles. Guidance / documentation only — the predicate accepts
+ * ANY `gate:<role>` so new gate-holder roles need no code change.
+ */
+export declare const GATE_ROLES: readonly ["guard", "spec-review", "pm-lead", "review-r1", "review-r2", "qa", "human"];
+export type GateRole = (typeof GATE_ROLES)[number];
+/** The human-approval tier that maps to the `gate:human` role (fallback). */
+export declare const HUMAN_GATE_TIER = "human-gate";
+/** True if `tag` is a well-formed `gate:<role>` tag. */
+export declare function isGateTag(tag: string): boolean;
+/** Gate roles declared by a qitem's tags (order-preserving, de-duplicated). */
+export declare function gateRolesOf(tags: readonly string[] | null | undefined): string[];
+export interface GatePredicateInput {
+    tags: readonly string[] | null | undefined;
+    tier?: string | null;
+}
+/**
+ * THE predicate: is this qitem gate work?
+ * Primary: any `gate:<role>` tag. Secondary fallback: tier === "human-gate".
+ */
+export declare function qitemIsGated(input: GatePredicateInput): boolean;
+/**
+ * Effective gate roles for a qitem, including the human-gate tier fallback
+ * surfaced as the `human` role. Empty iff the qitem is not gate work.
+ */
+export declare function effectiveGateRoles(input: GatePredicateInput): string[];
+//# sourceMappingURL=gate-predicate.d.ts.map

package/node_modules/@openrig/daemon/dist/domain/gate-predicate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-predicate.d.ts","sourceRoot":"","sources":["../../src/domain/gate-predicate.ts"],"names":[],"mappings":"AAcA,0CAA0C;AAC1C,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,UAAU,uFAQb,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,6EAA6E;AAC7E,eAAO,MAAM,eAAe,eAAe,CAAC;AAE5C,wDAAwD;AACxD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAchF;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAI/D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAItE"}

package/node_modules/@openrig/daemon/dist/domain/gate-predicate.js

@@ -0,0 +1,73 @@
+// OPR.0.4.3.16 — centralized queue gate-predicate.
+//
+// Convention: conventions/queue-gate-predicate/README.md (frozen by
+// pm-lead 2026-07-03). This is the ONE config point that decides whether a
+// queue qitem is "gate work" — a review/approval step a specific role must
+// act on to clear, and which can STALL. Consumers (the idle-gate watchdog
+// policy) read the predicate from HERE; they never scatter tag-checks or
+// body-parse the qitem (slice-16 PRD Business Rule 4).
+//
+// Predicate = a qitem carrying ANY `gate:<role>` tag. SECONDARY fallback:
+// tier === "human-gate" maps to the `gate:human` role (subsumes the legacy
+// human-gate tier for the predicate; it is NOT sufficient on its own to
+// catch the guard / spec-review targets).
+/** Tag namespace that marks gate work. */
+export const GATE_TAG_PREFIX = "gate:";
+/**
+ * Known gate roles. Guidance / documentation only — the predicate accepts
+ * ANY `gate:<role>` so new gate-holder roles need no code change.
+ */
+export const GATE_ROLES = [
+    "guard",
+    "spec-review",
+    "pm-lead",
+    "review-r1",
+    "review-r2",
+    "qa",
+    "human",
+];
+/** The human-approval tier that maps to the `gate:human` role (fallback). */
+export const HUMAN_GATE_TIER = "human-gate";
+/** True if `tag` is a well-formed `gate:<role>` tag. */
+export function isGateTag(tag) {
+    return tag.startsWith(GATE_TAG_PREFIX) && tag.length > GATE_TAG_PREFIX.length;
+}
+/** Gate roles declared by a qitem's tags (order-preserving, de-duplicated). */
+export function gateRolesOf(tags) {
+    if (!tags)
+        return [];
+    const seen = new Set();
+    const roles = [];
+    for (const t of tags) {
+        if (isGateTag(t)) {
+            const role = t.slice(GATE_TAG_PREFIX.length);
+            if (!seen.has(role)) {
+                seen.add(role);
+                roles.push(role);
+            }
+        }
+    }
+    return roles;
+}
+/**
+ * THE predicate: is this qitem gate work?
+ * Primary: any `gate:<role>` tag. Secondary fallback: tier === "human-gate".
+ */
+export function qitemIsGated(input) {
+    if (gateRolesOf(input.tags).length > 0)
+        return true;
+    if (input.tier === HUMAN_GATE_TIER)
+        return true; // → gate:human
+    return false;
+}
+/**
+ * Effective gate roles for a qitem, including the human-gate tier fallback
+ * surfaced as the `human` role. Empty iff the qitem is not gate work.
+ */
+export function effectiveGateRoles(input) {
+    const roles = gateRolesOf(input.tags);
+    if (input.tier === HUMAN_GATE_TIER && !roles.includes("human"))
+        roles.push("human");
+    return roles;
+}
+//# sourceMappingURL=gate-predicate.js.map

package/node_modules/@openrig/daemon/dist/domain/gate-predicate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-predicate.js","sourceRoot":"","sources":["../../src/domain/gate-predicate.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,oEAAoE;AACpE,2EAA2E;AAC3E,2EAA2E;AAC3E,0EAA0E;AAC1E,yEAAyE;AACzE,uDAAuD;AACvD,EAAE;AACF,0EAA0E;AAC1E,2EAA2E;AAC3E,wEAAwE;AACxE,0CAA0C;AAE1C,0CAA0C;AAC1C,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AAEvC;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO;IACP,aAAa;IACb,SAAS;IACT,WAAW;IACX,WAAW;IACX,IAAI;IACJ,OAAO;CACC,CAAC;AAGX,6EAA6E;AAC7E,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC;AAE5C,wDAAwD;AACxD,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC;AAChF,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CAAC,IAA0C;IACpE,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;YAC7C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAOD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAyB;IACpD,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe;QAAE,OAAO,IAAI,CAAC,CAAC,eAAe;IAChE,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAyB;IAC1D,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/node_modules/@openrig/daemon/dist/domain/gateway/dispatch-buffer.d.ts

@@ -0,0 +1,15 @@
+import type { OutboundDecision } from "./protocol.js";
+export declare function dispatchBufferPath(home?: string): string;
+/** The durable gateway dispatch buffer. Restart-surviving: `pending()` reads from disk.
+ *  Idempotent on decisionId — enqueuing the same decisionId twice keeps ONE record. */
+export declare class DispatchBuffer {
+    private readonly path;
+    constructor(home?: string);
+    /** Persist a decision BEFORE dispatch (durable-first). Idempotent by decisionId. */
+    enqueue(decision: OutboundDecision): void;
+    /** Ack-gated DRAIN: remove a decision only once the connector has Acked it. */
+    ack(decisionId: string): void;
+    /** The un-Acked decisions (restart-surviving) — what a re-dispatch replays on recovery. */
+    pending(): OutboundDecision[];
+}
+//# sourceMappingURL=dispatch-buffer.d.ts.map

package/node_modules/@openrig/daemon/dist/domain/gateway/dispatch-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-buffer.d.ts","sourceRoot":"","sources":["../../../src/domain/gateway/dispatch-buffer.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,MAAyB,GAAG,MAAM,CAE1E;AA2BD;uFACuF;AACvF,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAClB,IAAI,GAAE,MAAyB;IAI3C,oFAAoF;IACpF,OAAO,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAOzC,+EAA+E;IAC/E,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAM7B,2FAA2F;IAC3F,OAAO,IAAI,gBAAgB,EAAE;CAG9B"}