trellis-hgl-core 0.6.0-beta.18

package/dist/channel/internal/store/lock.js

@@ -0,0 +1,88 @@
+/**
+ * File-based advisory lock primitive.
+ *
+ * Uses `open(path, "wx")` (O_EXCL) for atomic creation across processes.
+ * Each lockfile stores the holder's pid for forensic + stale-lock
+ * recovery. If a lock file exists but the owning pid is no longer alive,
+ * the next `acquireLock` will steal it.
+ */
+import fs from "node:fs";
+import path from "node:path";
+const DEFAULT_RETRY_INTERVAL_MS = 25;
+const DEFAULT_MAX_WAIT_MS = 5000;
+export async function acquireLock(lockFile, opts = {}) {
+    const interval = opts.retryIntervalMs ?? DEFAULT_RETRY_INTERVAL_MS;
+    const deadline = Date.now() + (opts.maxWaitMs ?? DEFAULT_MAX_WAIT_MS);
+    fs.mkdirSync(path.dirname(lockFile), { recursive: true });
+    while (true) {
+        try {
+            const fd = fs.openSync(lockFile, "wx");
+            fs.writeSync(fd, String(process.pid));
+            fs.closeSync(fd);
+            return;
+        }
+        catch (err) {
+            if (err.code !== "EEXIST")
+                throw err;
+        }
+        if (await checkAndStealStale(lockFile))
+            continue;
+        if (Date.now() >= deadline) {
+            throw new Error(`Failed to acquire lock ${lockFile} within ${opts.maxWaitMs ?? DEFAULT_MAX_WAIT_MS}ms`);
+        }
+        await sleep(interval);
+    }
+}
+export function releaseLock(lockFile) {
+    try {
+        const content = fs.readFileSync(lockFile, "utf-8").trim();
+        if (content === String(process.pid)) {
+            fs.unlinkSync(lockFile);
+        }
+    }
+    catch {
+        // already gone
+    }
+}
+export async function withLock(lockFile, fn, opts) {
+    await acquireLock(lockFile, opts);
+    try {
+        return await fn();
+    }
+    finally {
+        releaseLock(lockFile);
+    }
+}
+async function checkAndStealStale(lockFile) {
+    let holderPid = 0;
+    try {
+        holderPid = Number(fs.readFileSync(lockFile, "utf-8").trim());
+    }
+    catch {
+        return false;
+    }
+    if (!holderPid || !pidAlive(holderPid)) {
+        try {
+            fs.unlinkSync(lockFile);
+            process.stderr.write(`[channel lock] stale lock from dead pid ${holderPid} stolen at ${lockFile}\n`);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    return false;
+}
+function pidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=lock.js.map

package/dist/channel/internal/store/lock.js.map

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

package/dist/channel/internal/store/paths.d.ts

@@ -0,0 +1,43 @@
+import { type ChannelRef, type ChannelScope } from "./schema.js";
+/** Top-level Trellis channels directory. */
+export declare function channelRoot(): string;
+/**
+ * Derive a per-project bucket name from an absolute cwd, mirroring
+ * Claude Code's `~/.claude/projects/<sanitized-cwd>/` convention.
+ */
+export declare function projectKey(cwd: string): string;
+/**
+ * Project key for the current CLI invocation. Reads
+ * `TRELLIS_CHANNEL_PROJECT` env first, then falls back to deriving from
+ * `process.cwd()`.
+ */
+export declare function currentProjectKey(): string;
+export declare function projectDir(project?: string): string;
+export declare function channelDir(name: string, project?: string): string;
+export declare function eventsPath(name: string, project?: string): string;
+export declare function seqSidecarPath(name: string, project?: string): string;
+export declare function lockPath(name: string, project?: string): string;
+export declare function workerFile(name: string, worker: string, suffix: string, project?: string): string;
+export declare function workerLockPath(name: string, worker: string, project?: string): string;
+/**
+ * One-shot migration: move legacy flat channels at `<root>/<name>/` into
+ * a `_legacy/` bucket so the new project-scoped layout can use the top
+ * level. Idempotent.
+ */
+export declare function migrateLegacyChannels(): void;
+export declare function ensureBucketMarker(project: string): void;
+export declare function listProjects(): string[];
+/**
+ * List channel names inside a project bucket — subdirectories that
+ * contain an `events.jsonl` file. Used by the cross-channel watcher for
+ * dynamic channel discovery.
+ */
+export declare function listChannelNamesInProject(project: string): string[];
+export interface ResolveChannelOptions {
+    scope?: ChannelScope;
+    cwd?: string;
+}
+export declare function resolveChannelProjectForCreate(name: string, opts?: ResolveChannelOptions): ChannelRef;
+export declare function resolveExistingChannelRef(name: string, opts?: ResolveChannelOptions): ChannelRef;
+export declare function selectExistingChannelProject(name: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/channel/internal/store/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../../src/channel/internal/store/paths.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AAErB,4CAA4C;AAC5C,wBAAgB,WAAW,IAAI,MAAM,CAIpC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAI1C;AAED,wBAAgB,UAAU,CAAC,OAAO,GAAE,MAA4B,GAAG,MAAM,CAExE;AAID,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAA4B,GACpC,MAAM,CAER;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAA4B,GACpC,MAAM,CAER;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAA4B,GACpC,MAAM,CAER;AAED,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAA4B,GACpC,MAAM,CAER;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,MAA4B,GACpC,MAAM,CAER;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,MAA4B,GACpC,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CA2C5C;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAOxD;AAED,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAqBvC;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBnE;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,qBAA0B,GAC/B,UAAU,CAcZ;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,qBAA0B,GAC/B,UAAU,CAsEZ;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjE"}

package/dist/channel/internal/store/paths.js

@@ -0,0 +1,233 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { GLOBAL_PROJECT_KEY, } from "./schema.js";
+/** Top-level Trellis channels directory. */
+export function channelRoot() {
+    const env = process.env.TRELLIS_CHANNEL_ROOT;
+    if (env && env.length > 0)
+        return path.resolve(env);
+    return path.join(os.homedir(), ".trellis", "channels");
+}
+/**
+ * Derive a per-project bucket name from an absolute cwd, mirroring
+ * Claude Code's `~/.claude/projects/<sanitized-cwd>/` convention.
+ */
+export function projectKey(cwd) {
+    const abs = path.resolve(cwd);
+    const slashes = abs.replace(/[\\/_]/g, "-");
+    return slashes.replace(/[^A-Za-z0-9.-]/g, "-");
+}
+/**
+ * Project key for the current CLI invocation. Reads
+ * `TRELLIS_CHANNEL_PROJECT` env first, then falls back to deriving from
+ * `process.cwd()`.
+ */
+export function currentProjectKey() {
+    const env = process.env.TRELLIS_CHANNEL_PROJECT;
+    if (env && env.length > 0)
+        return env;
+    return projectKey(process.cwd());
+}
+export function projectDir(project = currentProjectKey()) {
+    return path.join(channelRoot(), project);
+}
+const BUCKET_MARKER = ".bucket";
+export function channelDir(name, project = currentProjectKey()) {
+    return path.join(projectDir(project), name);
+}
+export function eventsPath(name, project = currentProjectKey()) {
+    return path.join(channelDir(name, project), "events.jsonl");
+}
+export function seqSidecarPath(name, project = currentProjectKey()) {
+    return path.join(channelDir(name, project), ".seq");
+}
+export function lockPath(name, project = currentProjectKey()) {
+    return path.join(channelDir(name, project), `${name}.lock`);
+}
+export function workerFile(name, worker, suffix, project = currentProjectKey()) {
+    return path.join(channelDir(name, project), `${worker}.${suffix}`);
+}
+export function workerLockPath(name, worker, project = currentProjectKey()) {
+    return path.join(channelDir(name, project), `${worker}.spawnlock`);
+}
+/**
+ * One-shot migration: move legacy flat channels at `<root>/<name>/` into
+ * a `_legacy/` bucket so the new project-scoped layout can use the top
+ * level. Idempotent.
+ */
+export function migrateLegacyChannels() {
+    const root = channelRoot();
+    if (!fs.existsSync(root))
+        return;
+    const legacy = path.join(root, "_legacy");
+    let moved = 0;
+    let entries;
+    try {
+        entries = fs.readdirSync(root);
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry === "_legacy" || entry === "_default")
+            continue;
+        const dir = path.join(root, entry);
+        let stat;
+        try {
+            stat = fs.statSync(dir);
+        }
+        catch {
+            continue;
+        }
+        if (!stat.isDirectory())
+            continue;
+        if (fs.existsSync(path.join(dir, BUCKET_MARKER)))
+            continue;
+        if (!fs.existsSync(path.join(dir, "events.jsonl")))
+            continue;
+        fs.mkdirSync(legacy, { recursive: true });
+        const target = path.join(legacy, entry);
+        try {
+            fs.renameSync(dir, target);
+            moved++;
+        }
+        catch (err) {
+            process.stderr.write(`[channel migrate] failed to move ${entry} to _legacy/: ${err instanceof Error ? err.message : err}\n`);
+        }
+    }
+    if (moved > 0) {
+        fs.mkdirSync(legacy, { recursive: true });
+        fs.writeFileSync(path.join(legacy, BUCKET_MARKER), "");
+        process.stderr.write(`[channel migrate] moved ${moved} legacy channel(s) to ${legacy}\n`);
+    }
+}
+export function ensureBucketMarker(project) {
+    const dir = projectDir(project);
+    fs.mkdirSync(dir, { recursive: true });
+    const marker = path.join(dir, BUCKET_MARKER);
+    if (!fs.existsSync(marker)) {
+        fs.writeFileSync(marker, "");
+    }
+}
+export function listProjects() {
+    const root = channelRoot();
+    if (!fs.existsSync(root))
+        return [];
+    const out = [];
+    for (const entry of fs.readdirSync(root)) {
+        const dir = path.join(root, entry);
+        try {
+            if (!fs.statSync(dir).isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        if (fs.existsSync(path.join(dir, BUCKET_MARKER)) ||
+            entry === "_legacy" ||
+            entry === "_default" ||
+            entry === GLOBAL_PROJECT_KEY) {
+            out.push(entry);
+        }
+    }
+    return out;
+}
+/**
+ * List channel names inside a project bucket — subdirectories that
+ * contain an `events.jsonl` file. Used by the cross-channel watcher for
+ * dynamic channel discovery.
+ */
+export function listChannelNamesInProject(project) {
+    const dir = projectDir(project);
+    if (!fs.existsSync(dir))
+        return [];
+    const out = [];
+    let entries;
+    try {
+        entries = fs.readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    for (const entry of entries) {
+        if (entry.startsWith("."))
+            continue;
+        const channelEvents = path.join(dir, entry, "events.jsonl");
+        if (fs.existsSync(channelEvents))
+            out.push(entry);
+    }
+    return out;
+}
+export function resolveChannelProjectForCreate(name, opts = {}) {
+    const scope = opts.scope ?? "project";
+    const project = scope === "global"
+        ? GLOBAL_PROJECT_KEY
+        : opts.cwd
+            ? projectKey(opts.cwd)
+            : currentProjectKey();
+    return {
+        name,
+        scope,
+        project,
+        dir: channelDir(name, project),
+    };
+}
+export function resolveExistingChannelRef(name, opts = {}) {
+    migrateLegacyChannels();
+    if (opts.scope) {
+        const project = opts.scope === "global"
+            ? GLOBAL_PROJECT_KEY
+            : opts.cwd
+                ? projectKey(opts.cwd)
+                : currentProjectKey();
+        if (!fs.existsSync(eventsPath(name, project))) {
+            throw new Error(`Channel '${name}' not found in ${opts.scope} scope (${project})`);
+        }
+        process.env.TRELLIS_CHANNEL_PROJECT = project;
+        return { name, scope: opts.scope, project, dir: channelDir(name, project) };
+    }
+    const current = currentProjectKey();
+    const projectMatches = listProjects()
+        .filter((project) => project !== GLOBAL_PROJECT_KEY)
+        .filter((project) => fs.existsSync(eventsPath(name, project)));
+    const globalExists = fs.existsSync(eventsPath(name, GLOBAL_PROJECT_KEY));
+    if (globalExists && projectMatches.length > 0) {
+        throw new Error(`Channel '${name}' exists in global and project scopes. Use --scope global or --scope project.`);
+    }
+    if (globalExists) {
+        process.env.TRELLIS_CHANNEL_PROJECT = GLOBAL_PROJECT_KEY;
+        return {
+            name,
+            scope: "global",
+            project: GLOBAL_PROJECT_KEY,
+            dir: channelDir(name, GLOBAL_PROJECT_KEY),
+        };
+    }
+    if (fs.existsSync(eventsPath(name, current))) {
+        process.env.TRELLIS_CHANNEL_PROJECT = current;
+        return {
+            name,
+            scope: "project",
+            project: current,
+            dir: channelDir(name, current),
+        };
+    }
+    if (projectMatches.length === 1) {
+        process.env.TRELLIS_CHANNEL_PROJECT = projectMatches[0];
+        return {
+            name,
+            scope: "project",
+            project: projectMatches[0],
+            dir: channelDir(name, projectMatches[0]),
+        };
+    }
+    if (projectMatches.length > 1) {
+        throw new Error(`Channel '${name}' exists in multiple project buckets: ${projectMatches.join(", ")}. Run from the owning project cwd or use --scope.`);
+    }
+    throw new Error(`Channel '${name}' not found in current project bucket (${current}) or any known scope`);
+}
+export function selectExistingChannelProject(name) {
+    return resolveExistingChannelRef(name).project;
+}
+//# sourceMappingURL=paths.js.map

package/dist/channel/internal/store/paths.js.map

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

package/dist/channel/internal/store/schema.d.ts

@@ -0,0 +1,77 @@
+export declare const GLOBAL_PROJECT_KEY = "_global";
+export type ChannelScope = "project" | "global";
+/**
+ * Channel structural type. `chat` is timeline-first; `forum` is a topic
+ * area whose threads are individual topics. Legacy event logs may carry
+ * the old `"threads"` / `"thread"` values — readers do NOT normalize them
+ * to `forum`; they are treated as non-forum channels. New writes always
+ * emit `"forum"`.
+ */
+export type ChannelType = "chat" | "forum";
+export type ThreadAction = "opened" | "comment" | "status" | "labels" | "assignees" | "summary" | "processed" | "rename";
+export type ContextTarget = "channel" | "thread";
+export type ContextMutationAction = "add" | "delete";
+export type EventOrigin = "cli" | "api" | "worker";
+/**
+ * Worker inbox delivery policy. `explicitOnly` consumes only messages
+ * whose `to` targets the worker (current CLI behavior).
+ * `broadcastAndExplicit` also consumes broadcast messages (no `to`).
+ * Applies to `kind:"message"` events only.
+ */
+export type InboxPolicy = "explicitOnly" | "broadcastAndExplicit";
+export declare const INBOX_POLICIES: ReadonlySet<InboxPolicy>;
+export declare function parseInboxPolicy(v: string | undefined): InboxPolicy | undefined;
+export declare const CHANNEL_TYPES: ReadonlySet<ChannelType>;
+export declare const THREAD_ACTIONS: ReadonlySet<ThreadAction>;
+export declare const EVENT_ORIGINS: ReadonlySet<EventOrigin>;
+export interface FileContextEntry {
+    type: "file";
+    path: string;
+}
+export interface RawContextEntry {
+    type: "raw";
+    text: string;
+}
+export type ContextEntry = FileContextEntry | RawContextEntry;
+/**
+ * Legacy alias kept while old code spells the field "linkedContext". New
+ * APIs use `ContextEntry`.
+ *
+ * @deprecated Use {@link ContextEntry} instead.
+ */
+export type LinkedContextEntry = ContextEntry;
+export interface ChannelRef {
+    name: string;
+    scope: ChannelScope;
+    /** Storage project bucket key (not the metadata `project` slug). */
+    project: string;
+    dir: string;
+}
+export interface ChannelMetadata {
+    type: ChannelType;
+    title?: string;
+    description?: string;
+    context?: ContextEntry[];
+    labels?: string[];
+}
+export declare function parseChannelScope(v: string | undefined): ChannelScope | undefined;
+export declare function parseChannelType(v: string | undefined): ChannelType;
+export declare function parseThreadAction(v: string): ThreadAction;
+export declare function parseEventOrigin(v: string | undefined): EventOrigin | undefined;
+export declare function normalizeThreadKey(v: string): string;
+/**
+ * Build a context entry list from absolute file paths + raw strings. The
+ * inputs are typically a CLI flag list and a raw-text list. Returns
+ * `undefined` when both lists are empty so callers can spread the field
+ * only when present.
+ */
+export declare function buildContextEntries(files: string[] | undefined, raw: string[] | undefined): ContextEntry[] | undefined;
+export declare function asStringArray(value: unknown): string[] | undefined;
+export declare function asContextEntries(value: unknown): ContextEntry[] | undefined;
+/**
+ * Identity key for a context entry, used for add/delete projection.
+ * File entries identify by absolute path; raw entries identify by the
+ * full text body.
+ */
+export declare function contextEntryKey(entry: ContextEntry): string;
+//# sourceMappingURL=schema.d.ts.map

package/dist/channel/internal/store/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/channel/internal/store/schema.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAE5C,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;AAChD;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3C,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,SAAS,GACT,WAAW,GACX,QAAQ,CAAC;AAEb,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEjD,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,QAAQ,CAAC;AAErD,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,sBAAsB,CAAC;AAElE,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,WAAW,CAGlD,CAAC;AAEH,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,MAAM,GAAG,SAAS,GACpB,WAAW,GAAG,SAAS,CAQzB;AAED,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,WAAW,CAGjD,CAAC;AAEH,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,YAAY,CASnD,CAAC;AAEH,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,WAAW,CAIjD,CAAC;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC;AAE9C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,YAAY,CAAC;IACpB,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,MAAM,GAAG,SAAS,GACpB,YAAY,GAAG,SAAS,CAM1B;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CASnE;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,YAAY,CAOzD;AAED,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,MAAM,GAAG,SAAS,GACpB,WAAW,GAAG,SAAS,CAQzB;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CASpD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,EAC3B,GAAG,EAAE,MAAM,EAAE,GAAG,SAAS,GACxB,YAAY,EAAE,GAAG,SAAS,CAgB5B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAGlE;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,GACb,YAAY,EAAE,GAAG,SAAS,CAU5B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAE3D"}

package/dist/channel/internal/store/schema.js

@@ -0,0 +1,127 @@
+import path from "node:path";
+export const GLOBAL_PROJECT_KEY = "_global";
+export const INBOX_POLICIES = new Set([
+    "explicitOnly",
+    "broadcastAndExplicit",
+]);
+export function parseInboxPolicy(v) {
+    if (v === undefined)
+        return undefined;
+    if (!INBOX_POLICIES.has(v)) {
+        throw new Error(`Invalid inbox policy '${v}'. Must be one of: ${[...INBOX_POLICIES].join(", ")}`);
+    }
+    return v;
+}
+export const CHANNEL_TYPES = new Set([
+    "chat",
+    "forum",
+]);
+export const THREAD_ACTIONS = new Set([
+    "opened",
+    "comment",
+    "status",
+    "labels",
+    "assignees",
+    "summary",
+    "processed",
+    "rename",
+]);
+export const EVENT_ORIGINS = new Set([
+    "cli",
+    "api",
+    "worker",
+]);
+export function parseChannelScope(v) {
+    if (v === undefined)
+        return undefined;
+    if (v !== "project" && v !== "global") {
+        throw new Error("Invalid --scope. Must be one of: project, global");
+    }
+    return v;
+}
+export function parseChannelType(v) {
+    if (v === undefined)
+        return "chat";
+    if (v === "thread" || v === "threads") {
+        throw new Error(`Invalid --type '${v}'. Use '--type forum'.`);
+    }
+    if (!CHANNEL_TYPES.has(v)) {
+        throw new Error("Invalid --type. Must be one of: chat, forum");
+    }
+    return v;
+}
+export function parseThreadAction(v) {
+    if (!THREAD_ACTIONS.has(v)) {
+        throw new Error(`Invalid thread action '${v}'. Must be one of: ${[...THREAD_ACTIONS].join(", ")}`);
+    }
+    return v;
+}
+export function parseEventOrigin(v) {
+    if (v === undefined)
+        return undefined;
+    if (!EVENT_ORIGINS.has(v)) {
+        throw new Error(`Invalid origin '${v}'. Must be one of: ${[...EVENT_ORIGINS].join(", ")}`);
+    }
+    return v;
+}
+export function normalizeThreadKey(v) {
+    const trimmed = v.trim();
+    if (!trimmed)
+        throw new Error("Thread key must not be empty");
+    if (!/^[A-Za-z0-9._-]+$/.test(trimmed)) {
+        throw new Error("Thread key may only contain letters, numbers, '.', '_' and '-'");
+    }
+    return trimmed;
+}
+/**
+ * Build a context entry list from absolute file paths + raw strings. The
+ * inputs are typically a CLI flag list and a raw-text list. Returns
+ * `undefined` when both lists are empty so callers can spread the field
+ * only when present.
+ */
+export function buildContextEntries(files, raw) {
+    const entries = [];
+    for (const file of files ?? []) {
+        const value = file.trim();
+        if (!path.isAbsolute(value)) {
+            throw new Error(`context file must be absolute path: ${file}`);
+        }
+        entries.push({ type: "file", path: value });
+    }
+    for (const text of raw ?? []) {
+        if (!text.trim()) {
+            throw new Error("context raw text must not be empty");
+        }
+        entries.push({ type: "raw", text });
+    }
+    return entries.length > 0 ? entries : undefined;
+}
+export function asStringArray(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    return value.filter((item) => typeof item === "string");
+}
+export function asContextEntries(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const entries = value.filter((entry) => {
+        if (!entry || typeof entry !== "object")
+            return false;
+        const candidate = entry;
+        if (candidate.type === "file")
+            return typeof candidate.path === "string";
+        if (candidate.type === "raw")
+            return typeof candidate.text === "string";
+        return false;
+    });
+    return entries.length > 0 ? entries : undefined;
+}
+/**
+ * Identity key for a context entry, used for add/delete projection.
+ * File entries identify by absolute path; raw entries identify by the
+ * full text body.
+ */
+export function contextEntryKey(entry) {
+    return entry.type === "file" ? `file:${entry.path}` : `raw:${entry.text}`;
+}
+//# sourceMappingURL=schema.js.map

package/dist/channel/internal/store/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/channel/internal/store/schema.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAoC5C,MAAM,CAAC,MAAM,cAAc,GAA6B,IAAI,GAAG,CAAC;IAC9D,cAAc;IACd,sBAAsB;CACvB,CAAC,CAAC;AAEH,MAAM,UAAU,gBAAgB,CAC9B,CAAqB;IAErB,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACtC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAgB,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,yBAAyB,CAAC,sBAAsB,CAAC,GAAG,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACjF,CAAC;IACJ,CAAC;IACD,OAAO,CAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAA6B,IAAI,GAAG,CAAC;IAC7D,MAAM;IACN,OAAO;CACR,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAA8B,IAAI,GAAG,CAAC;IAC/D,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,SAAS;IACT,WAAW;IACX,QAAQ;CACT,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAA6B,IAAI,GAAG,CAAC;IAC7D,KAAK;IACL,KAAK;IACL,QAAQ;CACT,CAAC,CAAC;AAsCH,MAAM,UAAU,iBAAiB,CAC/B,CAAqB;IAErB,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACtC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,CAAqB;IACpD,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACnC,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,wBAAwB,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAgB,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,CAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,CAAS;IACzC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAiB,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,0BAA0B,CAAC,sBAAsB,CAAC,GAAG,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClF,CAAC;IACJ,CAAC;IACD,OAAO,CAAiB,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,CAAqB;IAErB,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACtC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAgB,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,mBAAmB,CAAC,sBAAsB,CAAC,GAAG,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC1E,CAAC;IACJ,CAAC;IACD,OAAO,CAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,CAAS;IAC1C,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC9D,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAA2B,EAC3B,GAAyB;IAEzB,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAa,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAc;IAEd,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAyB,EAAE;QAC5D,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACtD,MAAM,SAAS,GAAG,KAAgC,CAAC;QACnD,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,CAAC;QACzE,IAAI,SAAS,CAAC,IAAI,KAAK,KAAK;YAAE,OAAO,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,CAAC;QACxE,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAmB;IACjD,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AAC5E,CAAC"}

package/dist/channel/internal/store/seq.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Compute the next seq to assign by reconciling the `.seq` sidecar with
+ * the JSONL tail. Repairs the sidecar when it is missing, corrupted,
+ * lower than the JSONL tail, or ahead of the JSONL tail (for example,
+ * after manual corruption or a stale future reservation).
+ *
+ * Caller must hold the channel lock when invoking this and the
+ * subsequent JSONL append + sidecar write.
+ */
+export declare function reconcileSeq(jsonlPath: string, sidecarPath: string): Promise<number>;
+export declare function writeSidecar(sidecarPath: string, seq: number): Promise<void>;
+//# sourceMappingURL=seq.d.ts.map

package/dist/channel/internal/store/seq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seq.d.ts","sourceRoot":"","sources":["../../../../src/channel/internal/store/seq.ts"],"names":[],"mappings":"AA+FA;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAKf"}