@h-rig/task-sources-plugin 0.0.6-alpha.156

package/README.md

@@ -0,0 +1 @@
+# @h-rig/task-sources-plugin

package/dist/src/files-source.d.ts

@@ -0,0 +1,18 @@
+import type { RegisteredTaskSource } from "@rig/contracts";
+export interface FilesTaskSourceOptions {
+    /**
+     * Directory containing one JSON file per task. Use either `path` (matches
+     * the `taskSource.path` field in rig.config.ts) or `dir` (back-compat).
+     */
+    path?: string;
+    dir?: string;
+    pattern?: RegExp;
+    /**
+     * Root a relative `path`/`dir` resolves against. The serving process's cwd
+     * is NOT the project (workspace-spawned servers run from the engine
+     * checkout), so without this a relative path silently reads the WRONG
+     * repo's tasks. Defaults to cwd for direct programmatic use.
+     */
+    projectRoot?: string;
+}
+export declare function createFilesTaskSource(opts: FilesTaskSourceOptions): RegisteredTaskSource;

package/dist/src/files-source.js

@@ -0,0 +1,107 @@
+// @bun
+// packages/task-sources-plugin/src/files-source.ts
+import { readFileSync, readdirSync, existsSync, statSync, writeFileSync } from "fs";
+import { join, basename, isAbsolute, resolve } from "path";
+var DEFAULT_PATTERN = /\.(task\.)?json$/;
+function readTaskFile(file, pattern) {
+  const raw = JSON.parse(readFileSync(file, "utf-8"));
+  const inferredId = basename(file).replace(pattern, "");
+  const labels = Array.isArray(raw.labels) ? raw.labels.filter((label) => typeof label === "string") : [];
+  const scope = labels.filter((label) => label.startsWith("scope:")).map((label) => label.slice("scope:".length));
+  const validators = labels.filter((label) => label.startsWith("validator:")).map((label) => label.slice("validator:".length));
+  const roleLabel = labels.find((label) => label.startsWith("role:"));
+  return {
+    id: raw["id"] ?? inferredId,
+    deps: raw["deps"] ?? raw["depends_on"] ?? [],
+    status: raw["status"] ?? "ready",
+    ...scope.length > 0 ? { scope } : {},
+    ...roleLabel ? { role: roleLabel.slice("role:".length) } : {},
+    ...validators.length > 0 ? { validators, validation: validators } : {},
+    ...raw
+  };
+}
+function createFilesTaskSource(opts) {
+  const pattern = opts.pattern ?? DEFAULT_PATTERN;
+  const configured = opts.path ?? opts.dir;
+  if (!configured) {
+    throw new Error("createFilesTaskSource: either `path` or `dir` must be provided");
+  }
+  const directory = isAbsolute(configured) ? configured : resolve(opts.projectRoot ?? process.cwd(), configured);
+  const findTaskFile = (id) => {
+    if (!existsSync(directory))
+      return;
+    for (const name of readdirSync(directory)) {
+      if (!pattern.test(name))
+        continue;
+      const p = join(directory, name);
+      try {
+        if (!statSync(p).isFile())
+          continue;
+        if (readTaskFile(p, pattern).id === id)
+          return p;
+      } catch {}
+    }
+    return;
+  };
+  const applyUpdate = (id, update) => {
+    const file = findTaskFile(id);
+    if (!file) {
+      throw new Error(`files task not found: ${id}`);
+    }
+    const raw = JSON.parse(readFileSync(file, "utf-8"));
+    if (update.status)
+      raw.status = update.status;
+    if (update.title !== undefined)
+      raw.title = update.title;
+    if (update.body !== undefined)
+      raw.body = update.body;
+    if (update.comment?.trim()) {
+      const existing = Array.isArray(raw.comments) ? raw.comments : [];
+      raw.comments = [
+        ...existing,
+        {
+          body: update.comment,
+          createdAt: new Date().toISOString(),
+          source: "rig"
+        }
+      ];
+    }
+    writeFileSync(file, `${JSON.stringify(raw, null, 2)}
+`, "utf-8");
+  };
+  return {
+    id: "std:files",
+    kind: "files",
+    async list() {
+      if (!existsSync(directory))
+        return [];
+      const out = [];
+      for (const name of readdirSync(directory)) {
+        if (!pattern.test(name))
+          continue;
+        const p = join(directory, name);
+        try {
+          if (!statSync(p).isFile())
+            continue;
+          out.push(readTaskFile(p, pattern));
+        } catch (err) {
+          console.warn(`[files-source] skipped ${name}: ${err.message}`);
+        }
+      }
+      return out;
+    },
+    async get(id) {
+      const all = await this.list();
+      return all.find((t) => t.id === id);
+    },
+    async updateStatus(id, status) {
+      applyUpdate(id, { status });
+    },
+    async updateTask(id, update) {
+      applyUpdate(id, update);
+    }
+  };
+}
+export {
+  createFilesTaskSource
+};

package/dist/src/github-issues-source.d.ts

@@ -0,0 +1,63 @@
+import { spawnSync } from "node:child_process";
+import type { GitHubCredentialProvider, RegisteredTaskSource, TaskRecord } from "@rig/contracts";
+export type { GitHubCredentialPurpose, GitHubCredentialProvider } from "@rig/contracts";
+export type GitHubIssueUpdatesMode = "lifecycle" | "minimal" | "off";
+export type GitHubProjectLifecycleStatus = "todo" | "running" | "prOpen" | "ciFixing" | "merging" | "done" | "needsAttention";
+export interface GitHubProjectsOptions {
+    enabled?: boolean;
+    projectId?: string;
+    statusFieldId?: string;
+    statuses?: Partial<Record<GitHubProjectLifecycleStatus, string>>;
+}
+export interface GitHubIssuesOptions {
+    owner: string;
+    repo: string;
+    labels?: readonly string[];
+    state?: "open" | "closed" | "all";
+    assignee?: string;
+    ghBinary?: string;
+    workspaceId?: string;
+    userId?: string;
+    credentialProvider?: GitHubCredentialProvider;
+    issueUpdates?: GitHubIssueUpdatesMode;
+    /** Timeout for every gh CLI call. Defaults to 15 seconds. */
+    timeoutMs?: number;
+    /** Maximum issue-list rows before Rig fails loudly instead of silently truncating. Defaults to 1,000. */
+    listLimit?: number;
+    /** @internal — for testing. Override the spawnSync used by the adapter. */
+    spawn?: typeof spawnSync;
+    /** Notify the host that issue-backed task state changed and snapshots should refresh. */
+    onTaskChanged?: (event: {
+        repo: string;
+        id: string;
+        status?: string;
+        reason: "github-issue-updated";
+    }) => void;
+    /** Optional GitHub Projects (v2) status-field sync mapped from Rig task status. */
+    projects?: GitHubProjectsOptions;
+    /** Opt into GitHub-native issue dependency reads; body parsing remains the fallback. */
+    useNativeDependencies?: boolean;
+}
+export interface GitHubIssueCreateInput {
+    title: string;
+    body?: string;
+    labels?: readonly string[];
+}
+export interface GitHubIssuesTaskSource extends RegisteredTaskSource {
+    addLabels(id: string, labels: readonly string[]): Promise<void>;
+    removeLabels(id: string, labels: readonly string[]): Promise<void>;
+    createIssue(input: GitHubIssueCreateInput): Promise<TaskRecord>;
+    getIssueBody(id: string): Promise<string | undefined>;
+}
+export declare const RIG_STATUS_COMMENT_MARKER = "<!-- rig:status-comment -->";
+export declare const RIG_METADATA_START = "<!-- rig:metadata:start -->";
+export declare const RIG_METADATA_END = "<!-- rig:metadata:end -->";
+export declare function updateRigOwnedMetadataBlock(body: string, metadata: Record<string, unknown>): string;
+export declare function buildRigStickyStatusComment(input: {
+    status: "running" | "prOpen" | "ciFixing" | "done" | "needsAttention" | string;
+    summary: string;
+    runId?: string;
+    prUrl?: string;
+    details?: readonly string[];
+}): string;
+export declare function createGitHubIssuesTaskSource(opts: GitHubIssuesOptions): GitHubIssuesTaskSource;