@h-rig/standard-plugin 0.0.6-alpha.8 → 0.0.6-alpha.81

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

@@ -1,7 +1,7 @@
 // @bun
 // packages/standard-plugin/src/files-source.ts
 import { readFileSync, readdirSync, existsSync, statSync, writeFileSync } from "fs";
-import { join, basename } from "path";
+import { join, basename, isAbsolute, resolve } from "path";
 var DEFAULT_PATTERN = /\.(task\.)?json$/;
 function readTaskFile(file, pattern) {
   const raw = JSON.parse(readFileSync(file, "utf-8"));
@@ -22,10 +22,11 @@ function readTaskFile(file, pattern) {
 }
 function createFilesTaskSource(opts) {
   const pattern = opts.pattern ?? DEFAULT_PATTERN;
-  const directory = opts.path ?? opts.dir;
-  if (!directory) {
+  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;

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

@@ -0,0 +1,67 @@
+import { spawnSync } from "node:child_process";
+import type { RegisteredTaskSource, TaskRecord } from "@rig/contracts";
+export type GitHubCredentialPurpose = "selected-repo" | "admin-fallback";
+export interface GitHubCredentialProvider {
+    resolveGitHubToken(input: {
+        owner: string;
+        repo: string;
+        workspaceId: string;
+        userId?: string;
+        purpose: GitHubCredentialPurpose;
+    }): Promise<{
+        token: string;
+        source: "signed-in-user" | "host-admin-fallback";
+    }>;
+}
+export interface GitHubIssuesOptions {
+    owner: string;
+    repo: string;
+    labels?: readonly string[];
+    state?: "open" | "closed" | "all";
+    assignee?: string;
+    ghBinary?: string;
+    workspaceId?: string;
+    userId?: string;
+    credentialProvider?: GitHubCredentialProvider;
+    /** 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;
+}
+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 function createEnvGitHubCredentialProvider(): GitHubCredentialProvider;
+export declare function createStateGitHubCredentialProvider(options?: {
+    stateFile?: string;
+    stateDir?: string;
+}): GitHubCredentialProvider;
+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;

package/dist/src/index.d.ts

@@ -0,0 +1,14 @@
+import { type RigPluginWithRuntime } from "@rig/core";
+import { createEnvGitHubCredentialProvider, createStateGitHubCredentialProvider, createGitHubIssuesTaskSource, type GitHubCredentialProvider, type GitHubIssuesOptions } from "./github-issues-source";
+import { createFilesTaskSource } from "./files-source";
+export { createGitHubIssuesTaskSource, createEnvGitHubCredentialProvider, createStateGitHubCredentialProvider, createFilesTaskSource };
+export type { GitHubIssuesOptions } from "./github-issues-source";
+export type { FilesTaskSourceOptions } from "./files-source";
+export interface StandardPluginOptions {
+    githubCredentialProvider?: GitHubCredentialProvider;
+    githubWorkspaceId?: string;
+    githubUserId?: string;
+    githubSpawn?: GitHubIssuesOptions["spawn"];
+    onGitHubTaskChanged?: GitHubIssuesOptions["onTaskChanged"];
+}
+export default function standardPlugin(opts?: StandardPluginOptions): RigPluginWithRuntime;

package/dist/src/index.js

@@ -476,7 +476,7 @@ function createGitHubIssuesTaskSource(opts) {
 
 // packages/standard-plugin/src/files-source.ts
 import { readFileSync as readFileSync2, readdirSync, existsSync as existsSync2, statSync, writeFileSync } from "fs";
-import { join, basename } from "path";
+import { join, basename, isAbsolute, resolve as resolve2 } from "path";
 var DEFAULT_PATTERN = /\.(task\.)?json$/;
 function readTaskFile(file, pattern) {
   const raw = JSON.parse(readFileSync2(file, "utf-8"));
@@ -497,10 +497,11 @@ function readTaskFile(file, pattern) {
 }
 function createFilesTaskSource(opts) {
   const pattern = opts.pattern ?? DEFAULT_PATTERN;
-  const directory = opts.path ?? opts.dir;
-  if (!directory) {
+  const configured = opts.path ?? opts.dir;
+  if (!configured) {
     throw new Error("createFilesTaskSource: either `path` or `dir` must be provided");
   }
+  const directory = isAbsolute(configured) ? configured : resolve2(opts.projectRoot ?? process.cwd(), configured);
   const findTaskFile = (id) => {
     if (!existsSync2(directory))
       return;
@@ -644,9 +645,10 @@ function standardPlugin(opts = {}) {
         id: "std:files",
         kind: "files",
         description: "JSON files in a local directory",
-        factory(config) {
+        factory(config, context) {
           return createFilesTaskSource({
-            path: requireStringField(config, "path", "files")
+            path: requireStringField(config, "path", "files"),
+            ...context?.projectRoot ? { projectRoot: context.projectRoot } : {}
           });
         }
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h-rig/standard-plugin",
-  "version": "0.0.6-alpha.8",
+  "version": "0.0.6-alpha.81",
   "type": "module",
   "description": "Rig package",
   "license": "UNLICENSED",
@@ -10,6 +10,7 @@
   ],
   "exports": {
     ".": {
+      "types": "./dist/src/index.d.ts",
       "import": "./dist/src/index.js"
     }
   },
@@ -18,9 +19,10 @@
   },
   "main": "./dist/src/index.js",
   "module": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
   "dependencies": {
-    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.8",
-    "@rig/core": "npm:@h-rig/core@0.0.6-alpha.8",
+    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.81",
+    "@rig/core": "npm:@h-rig/core@0.0.6-alpha.81",
     "effect": "4.0.0-beta.78"
   }
 }