@openrig/cli 0.2.0 → 0.3.0

package/daemon/dist/domain/context-packs/context-pack-library-service.d.ts

@@ -0,0 +1,41 @@
+import { type ContextPackEntry, type ContextPackSourceType } from "./context-pack-types.js";
+export interface ContextPackLibraryRoot {
+    /** Absolute path to a directory whose immediate children are pack dirs. */
+    path: string;
+    sourceType: ContextPackSourceType;
+}
+export interface ContextPackLibraryOpts {
+    roots: ContextPackLibraryRoot[];
+}
+/** Stable id format: context-pack:<name>:<version>. */
+export declare function contextPackId(name: string, version: string): string;
+export declare function parseContextPackId(id: string): {
+    name: string;
+    version: string;
+} | null;
+/** Daemon-derived per-file token estimate. Same heuristic the existing
+ *  context-usage-store uses (≈4 chars/token); cheap, stable, no
+ *  dependency on a tokenizer library. */
+export declare function estimateTokensFromBytes(bytes: number): number;
+export declare class ContextPackLibraryService {
+    private entries;
+    private readonly roots;
+    constructor(opts: ContextPackLibraryOpts);
+    /** Re-walk all roots, replace the in-memory index, return a count. */
+    scan(): {
+        count: number;
+        errors: Array<{
+            source: string;
+            error: string;
+        }>;
+    };
+    list(): ContextPackEntry[];
+    get(id: string): ContextPackEntry | null;
+    getByNameVersion(name: string, version: string): ContextPackEntry | null;
+    /** Resolve the absolute file path for a pack entry's file, with a
+     *  containment check that prevents path-traversal escaping the pack
+     *  directory. */
+    resolveFileWithinPack(packEntry: ContextPackEntry, relPath: string): string;
+    private readPackEntry;
+}
+//# sourceMappingURL=context-pack-library-service.d.ts.map

package/daemon/dist/domain/context-packs/context-pack-library-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pack-library-service.d.ts","sourceRoot":"","sources":["../../../src/domain/context-packs/context-pack-library-service.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,gBAAgB,EAErB,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,sBAAsB;IACrC,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,qBAAqB,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,sBAAsB,EAAE,CAAC;CACjC;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAMvF;AAED;;yCAEyC;AACzC,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,qBAAa,yBAAyB;IACpC,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;gBAErC,IAAI,EAAE,sBAAsB;IAIxC,sEAAsE;IACtE,IAAI,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE;IAqC3E,IAAI,IAAI,gBAAgB,EAAE;IAI1B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAIxC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAIxE;;qBAEiB;IACjB,qBAAqB,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAmB3E,OAAO,CAAC,aAAa;CAoDtB"}

package/daemon/dist/domain/context-packs/context-pack-library-service.js

@@ -0,0 +1,148 @@
+// Rig Context / Composable Context Injection v0 (PL-014) — library
+// service.
+//
+// Walks the configured discovery roots, parses each pack's
+// manifest.yaml, and emits ContextPackEntry records ready for the
+// daemon HTTP routes + UI library + send mechanism. Workspace-surface
+// reconciliation: the operator's filesystem edit always wins on next
+// scan() (matches PL-004 Phase D's contract for workflow_specs).
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
+import { parseManifest } from "./manifest-parser.js";
+import { ContextPackError, } from "./context-pack-types.js";
+/** Stable id format: context-pack:<name>:<version>. */
+export function contextPackId(name, version) {
+    return `context-pack:${name}:${version}`;
+}
+export function parseContextPackId(id) {
+    if (!id.startsWith("context-pack:"))
+        return null;
+    const rest = id.slice("context-pack:".length);
+    const last = rest.lastIndexOf(":");
+    if (last === -1)
+        return null;
+    return { name: rest.slice(0, last), version: rest.slice(last + 1) };
+}
+/** Daemon-derived per-file token estimate. Same heuristic the existing
+ *  context-usage-store uses (≈4 chars/token); cheap, stable, no
+ *  dependency on a tokenizer library. */
+export function estimateTokensFromBytes(bytes) {
+    return Math.ceil(bytes / 4);
+}
+export class ContextPackLibraryService {
+    entries = new Map();
+    roots;
+    constructor(opts) {
+        this.roots = opts.roots;
+    }
+    /** Re-walk all roots, replace the in-memory index, return a count. */
+    scan() {
+        const next = new Map();
+        const errors = [];
+        for (const root of this.roots) {
+            let dirents;
+            try {
+                dirents = existsSync(root.path)
+                    ? readdirSync(root.path, { withFileTypes: true })
+                    : [];
+            }
+            catch {
+                continue;
+            }
+            for (const dirent of dirents) {
+                if (!dirent.isDirectory())
+                    continue;
+                const packDir = join(root.path, dirent.name);
+                const manifestPath = join(packDir, "manifest.yaml");
+                if (!existsSync(manifestPath))
+                    continue;
+                try {
+                    const entry = this.readPackEntry(packDir, manifestPath, root);
+                    // Last-wins: workspace > user_file > builtin in the discovery
+                    // order configured by startup.
+                    next.set(entry.id, entry);
+                }
+                catch (err) {
+                    errors.push({
+                        source: packDir,
+                        error: err instanceof ContextPackError
+                            ? `${err.code}: ${err.message}`
+                            : err.message,
+                    });
+                }
+            }
+        }
+        this.entries = next;
+        return { count: next.size, errors };
+    }
+    list() {
+        return Array.from(this.entries.values()).sort((a, b) => a.name.localeCompare(b.name) || a.version.localeCompare(b.version));
+    }
+    get(id) {
+        return this.entries.get(id) ?? null;
+    }
+    getByNameVersion(name, version) {
+        return this.entries.get(contextPackId(name, version)) ?? null;
+    }
+    /** Resolve the absolute file path for a pack entry's file, with a
+     *  containment check that prevents path-traversal escaping the pack
+     *  directory. */
+    resolveFileWithinPack(packEntry, relPath) {
+        if (relPath.includes("..") || relPath.startsWith("/")) {
+            throw new ContextPackError("file_outside_pack", `relative path '${relPath}' must be inside the pack directory (no '..', no leading '/')`, { packId: packEntry.id, relPath });
+        }
+        const abs = join(packEntry.sourcePath, relPath);
+        if (!abs.startsWith(packEntry.sourcePath + "/") && abs !== packEntry.sourcePath) {
+            throw new ContextPackError("file_outside_pack", `resolved path '${abs}' falls outside pack '${packEntry.sourcePath}'`, { packId: packEntry.id, relPath, resolved: abs });
+        }
+        return abs;
+    }
+    readPackEntry(packDir, manifestPath, root) {
+        const raw = readFileSync(manifestPath, "utf-8");
+        const manifest = parseManifest(raw, manifestPath);
+        let mostRecentMtime = 0;
+        try {
+            mostRecentMtime = statSync(manifestPath).mtimeMs;
+        }
+        catch { /* unreadable manifest stat → fall back to 0 */ }
+        const files = manifest.files.map((mf) => {
+            const abs = join(packDir, mf.path);
+            let bytes = null;
+            let mtime = 0;
+            try {
+                const st = statSync(abs);
+                bytes = st.size;
+                mtime = st.mtimeMs;
+            }
+            catch {
+                bytes = null;
+            }
+            if (mtime > mostRecentMtime)
+                mostRecentMtime = mtime;
+            return {
+                path: mf.path,
+                role: mf.role,
+                summary: mf.summary ?? null,
+                absolutePath: bytes === null ? null : abs,
+                bytes,
+                estimatedTokens: bytes === null ? null : estimateTokensFromBytes(bytes),
+            };
+        });
+        const derivedEstimatedTokens = files.reduce((acc, f) => acc + (f.estimatedTokens ?? 0), 0);
+        return {
+            id: contextPackId(manifest.name, manifest.version),
+            kind: "context-pack",
+            name: manifest.name,
+            version: manifest.version,
+            purpose: manifest.purpose ?? null,
+            sourceType: root.sourceType,
+            sourcePath: packDir,
+            relativePath: relative(root.path, packDir) || ".",
+            updatedAt: new Date(mostRecentMtime || Date.now()).toISOString(),
+            manifestEstimatedTokens: typeof manifest.estimatedTokens === "number" ? manifest.estimatedTokens : null,
+            derivedEstimatedTokens,
+            files,
+        };
+    }
+}
+//# sourceMappingURL=context-pack-library-service.js.map

package/daemon/dist/domain/context-packs/context-pack-library-service.js.map

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

package/daemon/dist/domain/context-packs/context-pack-types.d.ts

@@ -0,0 +1,64 @@
+export interface ContextPackManifestFile {
+    /** Relative path within the pack directory. */
+    path: string;
+    /** Free-form operator-defined role (e.g., "prd", "proof-packet",
+     *  "architecture-brief"); closed enum at v1+ if patterns emerge. */
+    role: string;
+    /** One-line description rendered in the review pane and bundle frame. */
+    summary?: string;
+}
+export interface ContextPackManifest {
+    name: string;
+    version: string;
+    purpose?: string;
+    files: ContextPackManifestFile[];
+    /** Operator-supplied estimate (used as a hint when no per-file
+     *  estimate is available); the library service computes a derived
+     *  `derivedEstimatedTokens` from actual file sizes for display. */
+    estimatedTokens?: number;
+}
+export type ContextPackSourceType = "builtin" | "user_file" | "workspace";
+/** Library-shaped record emitted by ContextPackLibraryService. */
+export interface ContextPackEntry {
+    /** Stable identifier for routes / UI navigation:
+     *  `context-pack:<name>:<version>`. */
+    id: string;
+    kind: "context-pack";
+    name: string;
+    version: string;
+    purpose: string | null;
+    sourceType: ContextPackSourceType;
+    /** Absolute path to the pack directory. */
+    sourcePath: string;
+    /** Path relative to the discovery root that found this pack. */
+    relativePath: string;
+    /** ISO timestamp of the most recent mtime under the pack dir
+     *  (manifest.yaml or any included file — whichever is newer). */
+    updatedAt: string;
+    /** Operator-supplied estimate from the manifest, or null. */
+    manifestEstimatedTokens: number | null;
+    /** Daemon-derived estimate from actual file sizes (chars / 4
+     *  rounded — matches the existing context-usage convention). */
+    derivedEstimatedTokens: number;
+    /** Per-file metadata projected from the manifest + on-disk reads. */
+    files: ContextPackEntryFile[];
+}
+export interface ContextPackEntryFile {
+    path: string;
+    role: string;
+    summary: string | null;
+    /** Absolute path to the file on disk; null when manifest references
+     *  a file that doesn't exist (the entry surfaces honestly with
+     *  bytes=null instead of refusing to index). */
+    absolutePath: string | null;
+    /** File size in bytes; null when missing or unreadable. */
+    bytes: number | null;
+    /** Daemon-derived per-file token estimate (chars / 4 rounded). */
+    estimatedTokens: number | null;
+}
+export declare class ContextPackError extends Error {
+    readonly code: "manifest_missing" | "manifest_parse_error" | "manifest_invalid" | "pack_not_found" | "file_outside_pack" | "file_read_failed";
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(code: "manifest_missing" | "manifest_parse_error" | "manifest_invalid" | "pack_not_found" | "file_outside_pack" | "file_read_failed", message: string, details?: Record<string, unknown> | undefined);
+}
+//# sourceMappingURL=context-pack-types.d.ts.map

package/daemon/dist/domain/context-packs/context-pack-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pack-types.d.ts","sourceRoot":"","sources":["../../../src/domain/context-packs/context-pack-types.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb;wEACoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACjC;;uEAEmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC;AAE1E,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B;2CACuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,qBAAqB,CAAC;IAClC,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAC;IACrB;qEACiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC;oEACgE;IAChE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,qEAAqE;IACrE,KAAK,EAAE,oBAAoB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;oDAEgD;IAChD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,2DAA2D;IAC3D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,kEAAkE;IAClE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aAEvB,IAAI,EAChB,kBAAkB,GAClB,sBAAsB,GACtB,kBAAkB,GAClB,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB;aAEN,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBARjC,IAAI,EAChB,kBAAkB,GAClB,sBAAsB,GACtB,kBAAkB,GAClB,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,EACtB,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD"}

package/daemon/dist/domain/context-packs/context-pack-types.js

@@ -0,0 +1,22 @@
+// Rig Context / Composable Context Injection v0 (PL-014) — typed primitive
+// shared types.
+//
+// A context_pack is a directory containing `manifest.yaml` + included
+// markdown / yaml / txt files. Operator-authored, library-discoverable,
+// reviewable, sendable. Parallel to skills + workflow_specs in shape.
+//
+// MVP single-host context: storage filesystem-canonical at
+// ~/.openrig/context-packs/<name>/ (host) + workspace-local
+// .openrig/context-packs/<name>/. NO new SQLite tables; library cache
+// is in-memory at the daemon scope.
+export class ContextPackError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "ContextPackError";
+    }
+}
+//# sourceMappingURL=context-pack-types.js.map

package/daemon/dist/domain/context-packs/context-pack-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pack-types.js","sourceRoot":"","sources":["../../../src/domain/context-packs/context-pack-types.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,gBAAgB;AAChB,EAAE;AACF,sEAAsE;AACtE,wEAAwE;AACxE,sEAAsE;AACtE,EAAE;AACF,2DAA2D;AAC3D,4DAA4D;AAC5D,sEAAsE;AACtE,oCAAoC;AAiEpC,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAEvB;IAQA;IATlB,YACkB,IAMM,EACtB,OAAe,EACC,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QAVC,SAAI,GAAJ,IAAI,CAME;QAEN,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF"}

package/daemon/dist/domain/context-packs/manifest-parser.d.ts

@@ -0,0 +1,3 @@
+import { type ContextPackManifest } from "./context-pack-types.js";
+export declare function parseManifest(rawYaml: string, sourcePath: string): ContextPackManifest;
+//# sourceMappingURL=manifest-parser.d.ts.map

package/daemon/dist/domain/context-packs/manifest-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-parser.d.ts","sourceRoot":"","sources":["../../../src/domain/context-packs/manifest-parser.ts"],"names":[],"mappings":"AAQA,OAAO,EAAoB,KAAK,mBAAmB,EAAgC,MAAM,yBAAyB,CAAC;AAInH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,mBAAmB,CA4GtF"}

package/daemon/dist/domain/context-packs/manifest-parser.js

@@ -0,0 +1,74 @@
+// Rig Context / Composable Context Injection v0 (PL-014) — manifest
+// parser.
+//
+// Parses ~/.openrig/context-packs/<name>/manifest.yaml into a typed
+// shape with structured-error rejects on malformed input. Pure
+// (no fs touches in the parser itself; caller hands in raw YAML).
+import { parse as parseYaml } from "yaml";
+import { ContextPackError } from "./context-pack-types.js";
+const ALLOWED_FILE_SUFFIXES = [".md", ".markdown", ".yaml", ".yml", ".txt"];
+export function parseManifest(rawYaml, sourcePath) {
+    let parsed;
+    try {
+        parsed = parseYaml(rawYaml);
+    }
+    catch (err) {
+        throw new ContextPackError("manifest_parse_error", `manifest at ${sourcePath} is not valid YAML: ${err.message}`, { sourcePath });
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new ContextPackError("manifest_invalid", `manifest at ${sourcePath} must be a YAML object at the root`, { sourcePath });
+    }
+    const obj = parsed;
+    const name = obj["name"];
+    if (typeof name !== "string" || name.length === 0) {
+        throw new ContextPackError("manifest_invalid", `manifest at ${sourcePath} is missing required field 'name' (string)`, { sourcePath });
+    }
+    // Version may be a number or string in YAML; normalize to string for
+    // round-tripping with library ids and `<name>:<version>` formatting.
+    const versionRaw = obj["version"];
+    if (versionRaw === undefined || versionRaw === null) {
+        throw new ContextPackError("manifest_invalid", `manifest at ${sourcePath} is missing required field 'version'`, { sourcePath });
+    }
+    const version = String(versionRaw);
+    const purpose = typeof obj["purpose"] === "string" ? obj["purpose"] : undefined;
+    const filesRaw = obj["files"];
+    if (!Array.isArray(filesRaw)) {
+        throw new ContextPackError("manifest_invalid", `manifest at ${sourcePath} must declare 'files: [...]' (got: ${typeof filesRaw})`, { sourcePath });
+    }
+    const files = [];
+    for (let i = 0; i < filesRaw.length; i++) {
+        const f = filesRaw[i];
+        if (!f || typeof f !== "object" || Array.isArray(f)) {
+            throw new ContextPackError("manifest_invalid", `manifest at ${sourcePath} has malformed entry at files[${i}] (must be an object with 'path' + 'role')`, { sourcePath, index: i });
+        }
+        const fr = f;
+        const path = fr["path"];
+        if (typeof path !== "string" || path.length === 0) {
+            throw new ContextPackError("manifest_invalid", `manifest at ${sourcePath} files[${i}] missing 'path' (string)`, { sourcePath, index: i });
+        }
+        if (path.includes("..") || path.startsWith("/")) {
+            throw new ContextPackError("manifest_invalid", `manifest at ${sourcePath} files[${i}].path '${path}' must be a relative path inside the pack (no '..' segments, no leading '/')`, { sourcePath, index: i, path });
+        }
+        const role = fr["role"];
+        if (typeof role !== "string" || role.length === 0) {
+            throw new ContextPackError("manifest_invalid", `manifest at ${sourcePath} files[${i}] missing 'role' (string)`, { sourcePath, index: i, path });
+        }
+        if (!ALLOWED_FILE_SUFFIXES.some((s) => path.endsWith(s))) {
+            throw new ContextPackError("manifest_invalid", `manifest at ${sourcePath} files[${i}].path '${path}' has an unsupported suffix; allowed: ${ALLOWED_FILE_SUFFIXES.join(", ")}`, { sourcePath, index: i, path });
+        }
+        const summary = typeof fr["summary"] === "string" ? fr["summary"] : undefined;
+        files.push(summary === undefined ? { path, role } : { path, role, summary });
+    }
+    const estimatedTokensRaw = obj["estimated_tokens"] ?? obj["estimatedTokens"];
+    const estimatedTokens = typeof estimatedTokensRaw === "number" && Number.isFinite(estimatedTokensRaw)
+        ? Math.max(0, Math.floor(estimatedTokensRaw))
+        : undefined;
+    return {
+        name,
+        version,
+        ...(purpose !== undefined ? { purpose } : {}),
+        files,
+        ...(estimatedTokens !== undefined ? { estimatedTokens } : {}),
+    };
+}
+//# sourceMappingURL=manifest-parser.js.map

package/daemon/dist/domain/context-packs/manifest-parser.js.map

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

package/daemon/dist/domain/context-usage-store.d.ts

@@ -1,9 +1,10 @@
-import type Database from "better-sqlite3";
+import Database from "better-sqlite3";
 import type { ContextUsage, ContextUnknownReason } from "./types.js";
 /** Freshness threshold: samples older than this are considered stale for compact displays. */
 export declare const FRESHNESS_THRESHOLD_MS = 600000;
 export interface ContextUsageStoreOpts {
     stateDir: string;
+    codexHomeDir?: string | null;
 }
 interface SidecarRaw {
     context_window?: {
@@ -22,6 +23,7 @@ interface SidecarRaw {
 export declare class ContextUsageStore {
     readonly db: Database.Database;
     private stateDir;
+    private codexHomeDir;
     constructor(db: Database.Database, opts: ContextUsageStoreOpts);
     /** Get the sidecar file path for a session. */
     getSidecarPath(sessionName: string): string;
@@ -35,8 +37,15 @@ export declare class ContextUsageStore {
     };
     /** Read sidecar and normalize into ContextUsage in one step. */
     readAndNormalize(sessionName: string): ContextUsage;
+    /** Read the latest Codex token_count event for a thread and normalize it. */
+    readCodexAndNormalize(input: {
+        threadId: string | null | undefined;
+        sessionName: string;
+    }): ContextUsage;
     /** Normalize raw sidecar data into a ContextUsage record. */
     normalizeSample(raw: SidecarRaw | null): ContextUsage;
+    /** Normalize a Codex token_count JSONL event into ContextUsage. */
+    private normalizeCodexTokenCount;
     /** Persist a context usage record for a node. Upserts. */
     persist(nodeId: string, usage: ContextUsage): void;
     /** Get context usage for a single node. Session-aware: mismatched session returns unknown. */
@@ -53,6 +62,10 @@ export declare class ContextUsageStore {
     /** Convert a DB row to a ContextUsage, applying freshness. */
     private rowToUsage;
     private normalizeCurrentUsage;
+    private readCodexThread;
+    private resolveCodexStateDbPaths;
+    private readLatestCodexTokenCount;
+    private readTail;
 }
 export {};
 //# sourceMappingURL=context-usage-store.d.ts.map

package/daemon/dist/domain/context-usage-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-usage-store.d.ts","sourceRoot":"","sources":["../../src/domain/context-usage-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAErE,8FAA8F;AAC9F,eAAO,MAAM,sBAAsB,SAAU,CAAC;AAE9C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,UAAU;IAClB,cAAc,CAAC,EAAE;QACf,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAoBD,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAS;gBAEb,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,qBAAqB;IAK9D,+CAA+C;IAC/C,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAM3C,wEAAwE;IACxE,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,iBAAiB,GAAG,aAAa,CAAA;KAAE;IAY3H,gEAAgE;IAChE,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY;IAMnD,6DAA6D;IAC7D,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,GAAG,YAAY;IA+BrD,0DAA0D;IAC1D,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAyClD,8FAA8F;IAC9F,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY;IAc3E,2EAA2E;IAC3E,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;IAoC7G,4DAA4D;IAC5D,YAAY,CAAC,MAAM,EAAE,oBAAoB,GAAG,YAAY;IAmBxD,4CAA4C;IAC5C,OAAO,CAAC,OAAO;IASf,8DAA8D;IAC9D,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,qBAAqB;CAS9B"}
+{"version":3,"file":"context-usage-store.d.ts","sourceRoot":"","sources":["../../src/domain/context-usage-store.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAItC,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAErE,8FAA8F;AAC9F,eAAO,MAAM,sBAAsB,SAAU,CAAC;AAE9C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,UAAU,UAAU;IAClB,cAAc,CAAC,EAAE;QACf,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA0CD,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAgB;gBAExB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,qBAAqB;IAM9D,+CAA+C;IAC/C,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAM3C,wEAAwE;IACxE,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,iBAAiB,GAAG,aAAa,CAAA;KAAE;IAY3H,gEAAgE;IAChE,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY;IAMnD,6EAA6E;IAC7E,qBAAqB,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY;IAkBxG,6DAA6D;IAC7D,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,GAAG,YAAY;IA+BrD,mEAAmE;IACnE,OAAO,CAAC,wBAAwB;IA4ChC,0DAA0D;IAC1D,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAyClD,8FAA8F;IAC9F,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY;IAc3E,2EAA2E;IAC3E,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;IAoC7G,4DAA4D;IAC5D,YAAY,CAAC,MAAM,EAAE,oBAAoB,GAAG,YAAY;IAmBxD,4CAA4C;IAC5C,OAAO,CAAC,OAAO;IASf,8DAA8D;IAC9D,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,wBAAwB;IA8BhC,OAAO,CAAC,yBAAyB;IAsBjC,OAAO,CAAC,QAAQ;CAajB"}

package/daemon/dist/domain/context-usage-store.js

@@ -1,13 +1,17 @@
+import Database from "better-sqlite3";
 import { join } from "node:path";
-import { readFileSync, existsSync } from "node:fs";
+import os from "node:os";
+import { closeSync, existsSync, openSync, readFileSync, readSync, readdirSync, statSync } from "node:fs";
 /** Freshness threshold: samples older than this are considered stale for compact displays. */
 export const FRESHNESS_THRESHOLD_MS = 600_000; // 10 minutes per PM spec
 export class ContextUsageStore {
     db;
     stateDir;
+    codexHomeDir;
     constructor(db, opts) {
         this.db = db;
         this.stateDir = opts.stateDir;
+        this.codexHomeDir = opts.codexHomeDir ?? safeHomeDir();
     }
     /** Get the sidecar file path for a session. */
     getSidecarPath(sessionName) {
@@ -36,6 +40,24 @@ export class ContextUsageStore {
             return this.unknownUsage(result.reason);
         return this.normalizeSample(result.data);
     }
+    /** Read the latest Codex token_count event for a thread and normalize it. */
+    readCodexAndNormalize(input) {
+        const threadId = input.threadId?.trim();
+        if (!threadId)
+            return this.unknownUsage("no_data");
+        const thread = this.readCodexThread(threadId);
+        if (!thread?.rollout_path)
+            return this.unknownUsage("no_data");
+        const tokenEvent = this.readLatestCodexTokenCount(thread.rollout_path);
+        if (!tokenEvent)
+            return this.unknownUsage("no_data");
+        return this.normalizeCodexTokenCount({
+            event: tokenEvent,
+            sessionName: input.sessionName,
+            threadId,
+            transcriptPath: thread.rollout_path,
+        });
+    }
     /** Normalize raw sidecar data into a ContextUsage record. */
     normalizeSample(raw) {
         if (!raw) {
@@ -64,6 +86,42 @@ export class ContextUsageStore {
             fresh,
         };
     }
+    /** Normalize a Codex token_count JSONL event into ContextUsage. */
+    normalizeCodexTokenCount(input) {
+        const info = input.event.payload?.info;
+        const usage = info?.last_token_usage;
+        const contextWindowSize = info?.model_context_window;
+        if (!usage || typeof contextWindowSize !== "number" || contextWindowSize <= 0) {
+            return this.unknownUsage("parse_error");
+        }
+        const inputTokens = typeof usage.input_tokens === "number" ? usage.input_tokens : null;
+        const outputTokens = typeof usage.output_tokens === "number" ? usage.output_tokens : null;
+        const totalTokens = typeof usage.total_tokens === "number"
+            ? usage.total_tokens
+            : (inputTokens ?? 0) + (outputTokens ?? 0);
+        const usedPercentage = clampPercentage(Math.round((totalTokens / contextWindowSize) * 100));
+        const remainingPercentage = clampPercentage(100 - usedPercentage);
+        const sampledAt = input.event.timestamp ?? null;
+        return {
+            availability: "known",
+            reason: null,
+            source: "codex_token_count_jsonl",
+            usedPercentage,
+            remainingPercentage,
+            contextWindowSize,
+            totalInputTokens: inputTokens,
+            totalOutputTokens: outputTokens,
+            currentUsage: this.normalizeCurrentUsage({
+                last_token_usage: usage,
+                model_context_window: contextWindowSize,
+            }),
+            transcriptPath: input.transcriptPath,
+            sessionId: input.threadId,
+            sessionName: input.sessionName,
+            sampledAt,
+            fresh: sampledAt ? this.isFresh(sampledAt) : false,
+        };
+    }
     /** Persist a context usage record for a node. Upserts. */
     persist(nodeId, usage) {
         this.db.prepare(`
@@ -191,5 +249,102 @@ export class ContextUsageStore {
             return String(value);
         }
     }
+    readCodexThread(threadId) {
+        for (const dbPath of this.resolveCodexStateDbPaths()) {
+            try {
+                const codexDb = new Database(dbPath, { readonly: true });
+                try {
+                    const row = codexDb.prepare("SELECT id, rollout_path FROM threads WHERE id = ? LIMIT 1").get(threadId);
+                    if (row?.rollout_path)
+                        return row;
+                }
+                finally {
+                    codexDb.close();
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return null;
+    }
+    resolveCodexStateDbPaths() {
+        if (!this.codexHomeDir)
+            return [];
+        const codexDir = join(this.codexHomeDir, ".codex");
+        const discovered = [];
+        try {
+            for (const entry of readdirSync(codexDir)) {
+                const match = entry.match(/^state_(\d+)\.sqlite$/);
+                if (!match)
+                    continue;
+                discovered.push({
+                    version: Number(match[1]),
+                    path: join(codexDir, entry),
+                });
+            }
+        }
+        catch {
+            // Best-effort only; fall back to the current common filename below.
+        }
+        if (discovered.length === 0) {
+            discovered.push({ version: 5, path: join(codexDir, "state_5.sqlite") });
+        }
+        return discovered
+            .sort((a, b) => b.version - a.version)
+            .map((entry) => entry.path)
+            .filter((path, index, paths) => paths.indexOf(path) === index)
+            .filter((path) => existsSync(path));
+    }
+    readLatestCodexTokenCount(rolloutPath) {
+        let content;
+        try {
+            content = this.readTail(rolloutPath, 4_000_000);
+        }
+        catch {
+            return null;
+        }
+        const lines = content.trimEnd().split("\n").reverse();
+        for (const line of lines) {
+            if (!line.includes("\"token_count\""))
+                continue;
+            try {
+                const parsed = JSON.parse(line);
+                if (parsed.payload?.type === "token_count")
+                    return parsed;
+            }
+            catch {
+                continue;
+            }
+        }
+        return null;
+    }
+    readTail(filePath, maxBytes) {
+        const stat = statSync(filePath);
+        const start = Math.max(0, stat.size - maxBytes);
+        const length = stat.size - start;
+        const fd = openSync(filePath, "r");
+        try {
+            const buffer = Buffer.alloc(length);
+            readSync(fd, buffer, 0, length, start);
+            return buffer.toString("utf-8");
+        }
+        finally {
+            closeSync(fd);
+        }
+    }
+}
+function clampPercentage(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.min(100, Math.max(0, value));
+}
+function safeHomeDir() {
+    try {
+        return os.homedir();
+    }
+    catch {
+        return null;
+    }
 }
 //# sourceMappingURL=context-usage-store.js.map