@h-rig/core 0.0.6-alpha.15 → 0.0.6-alpha.151

package/dist/src/config.d.ts

@@ -0,0 +1,3 @@
+export { defineConfig, type RigConfigInput } from "./define-config";
+export { definePlugin } from "./define-plugin";
+export type { RegisteredValidator, RigPluginRuntime, RigPluginWithRuntime, RuntimeCliCommand, RuntimeCliContext, RuntimePanelProducer, TaskSourceFactoryContext, TaskSourceFactoryEntry, ValidatorContext, ValidatorResult, } from "./plugin-runtime";

package/dist/src/config.js

@@ -0,0 +1,136 @@
+// @bun
+// packages/core/src/define-config.ts
+import { Schema } from "effect";
+import { RigConfig } from "@rig/contracts";
+function normalizeWorkspaceConfig(raw) {
+  const workspace = raw && typeof raw === "object" && !Array.isArray(raw) ? { ...raw } : { mainRepo: "." };
+  workspace.checkout = workspace.checkout ?? workspace.isolation ?? "worktree";
+  workspace.isolation = workspace.isolation ?? workspace.checkout;
+  workspace.sandbox = workspace.sandbox ?? "enforce";
+  return workspace;
+}
+function applyConfigDefaults(raw) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw))
+    return raw;
+  const record = raw;
+  return {
+    ...record,
+    plugins: Array.isArray(record.plugins) ? record.plugins : [],
+    workspace: normalizeWorkspaceConfig(record.workspace)
+  };
+}
+function defineConfig(cfg) {
+  const runtimeByName = new Map;
+  const plugins = cfg.plugins ?? [];
+  for (const plugin of plugins) {
+    if (plugin?.__runtime) {
+      runtimeByName.set(plugin.name, plugin.__runtime);
+    }
+  }
+  const decoded = Schema.decodeUnknownSync(RigConfig)(applyConfigDefaults(cfg));
+  const decodedPlugins = decoded.plugins.map((p) => {
+    const runtime = runtimeByName.get(p.name);
+    if (!runtime)
+      return p;
+    return { ...p, __runtime: runtime };
+  });
+  return { ...decoded, plugins: decodedPlugins };
+}
+// packages/core/src/define-plugin.ts
+import { Schema as Schema2 } from "effect";
+import { RigPlugin } from "@rig/contracts";
+function definePlugin(meta, runtime) {
+  const validated = Schema2.decodeUnknownSync(RigPlugin)(meta);
+  if (!runtime) {
+    return validated;
+  }
+  const declaredValidators = new Map((validated.contributes?.validators ?? []).map((v) => [v.id, v]));
+  const runtimeValidators = new Map((runtime.validators ?? []).map((v) => [v.id, v]));
+  for (const v of runtimeValidators.values()) {
+    const metadata = declaredValidators.get(v.id);
+    if (!metadata) {
+      throw new Error(`definePlugin(${validated.name}): executable validator "${v.id}" has no matching metadata entry in contributes.validators`);
+    }
+    if (metadata.category !== v.category) {
+      throw new Error(`definePlugin(${validated.name}): executable validator "${v.id}" category "${v.category}" does not match metadata category "${metadata.category}"`);
+    }
+  }
+  if (runtime.validators) {
+    for (const v of declaredValidators.values()) {
+      if (!runtimeValidators.has(v.id)) {
+        throw new Error(`definePlugin(${validated.name}): validator metadata "${v.id}" has no runtime implementation`);
+      }
+    }
+  }
+  const declaredSources = new Map((validated.contributes?.taskSources ?? []).map((s) => [s.id, s]));
+  const runtimeSources = new Map((runtime.taskSources ?? []).map((s) => [s.id, s]));
+  for (const s of runtimeSources.values()) {
+    const metadata = declaredSources.get(s.id);
+    if (!metadata) {
+      throw new Error(`definePlugin(${validated.name}): executable task source "${s.id}" has no matching metadata entry in contributes.taskSources`);
+    }
+    if (metadata.kind !== s.kind) {
+      throw new Error(`definePlugin(${validated.name}): executable task source "${s.id}" kind "${s.kind}" does not match metadata kind "${metadata.kind}"`);
+    }
+  }
+  if (runtime.taskSources) {
+    for (const s of declaredSources.values()) {
+      if (!runtimeSources.has(s.id)) {
+        throw new Error(`definePlugin(${validated.name}): task source metadata "${s.id}" has no runtime implementation`);
+      }
+    }
+  }
+  const declaredHooks = new Map((validated.contributes?.hooks ?? []).map((h) => [h.id, h]));
+  for (const hookId of Object.keys(runtime.hooks ?? {})) {
+    const metadata = declaredHooks.get(hookId);
+    if (!metadata) {
+      throw new Error(`definePlugin(${validated.name}): typed hook "${hookId}" has no matching metadata entry in contributes.hooks`);
+    }
+    if (metadata.command) {
+      throw new Error(`definePlugin(${validated.name}): hook "${hookId}" has both a typed implementation and a command string \u2014 pick one`);
+    }
+  }
+  if (runtime.hooks) {
+    for (const h of declaredHooks.values()) {
+      if (!runtime.hooks[h.id] && !h.command) {
+        throw new Error(`definePlugin(${validated.name}): hook metadata "${h.id}" has no implementation (typed function or command)`);
+      }
+    }
+  }
+  const declaredCapabilities = new Map((validated.contributes?.capabilities ?? []).map((capability) => [capability.id, capability]));
+  for (const capability of runtime.featureCapabilities ?? []) {
+    if (!declaredCapabilities.has(capability.id)) {
+      throw new Error(`definePlugin(${validated.name}): executable capability "${capability.id}" has no matching metadata entry in contributes.capabilities`);
+    }
+  }
+  const declaredPanels = new Map((validated.contributes?.panels ?? []).map((panel) => [panel.id, panel]));
+  for (const panel of runtime.panels ?? []) {
+    const metadata = declaredPanels.get(panel.id);
+    if (!metadata) {
+      throw new Error(`definePlugin(${validated.name}): executable panel "${panel.id}" has no matching metadata entry in contributes.panels`);
+    }
+    if (metadata.slot !== panel.slot) {
+      throw new Error(`definePlugin(${validated.name}): executable panel "${panel.id}" slot "${panel.slot}" does not match metadata slot "${metadata.slot}"`);
+    }
+    if (metadata.capabilityId !== panel.capabilityId) {
+      throw new Error(`definePlugin(${validated.name}): executable panel "${panel.id}" capabilityId "${panel.capabilityId ?? "(none)"}" does not match metadata capabilityId "${metadata.capabilityId ?? "(none)"}"`);
+    }
+  }
+  const declaredBlockerClassifiers = new Map((validated.contributes?.blockerClassifiers ?? []).map((classifier) => [classifier.id, classifier]));
+  for (const classifier of runtime.blockerClassifiers ?? []) {
+    if (!declaredBlockerClassifiers.has(classifier.id)) {
+      throw new Error(`definePlugin(${validated.name}): executable blocker classifier "${classifier.id}" has no matching metadata entry in contributes.blockerClassifiers`);
+    }
+  }
+  const declaredCliCommands = new Map((validated.contributes?.cliCommands ?? []).map((command) => [command.id, command]));
+  for (const command of runtime.cliCommands ?? []) {
+    if (!declaredCliCommands.has(command.id)) {
+      throw new Error(`definePlugin(${validated.name}): executable cli command "${command.id}" has no matching metadata entry in contributes.cliCommands`);
+    }
+  }
+  return { ...validated, __runtime: runtime };
+}
+export {
+  definePlugin,
+  defineConfig
+};

package/dist/src/define-config.d.ts

@@ -0,0 +1,18 @@
+import { RigConfig } from "@rig/contracts";
+/**
+ * Author-facing config input: `plugins` and `workspace` are optional and
+ * default to a plugin-less worktree setup, so the minimal documented config
+ * (project + taskSource) works out of the box.
+ */
+export type RigConfigInput = Omit<RigConfig, "plugins" | "workspace"> & {
+    plugins?: RigConfig["plugins"];
+    workspace?: RigConfig["workspace"];
+};
+/** Fill optional top-level sections before Schema decode (which requires them). */
+export declare function applyConfigDefaults(raw: unknown): unknown;
+/**
+ * Validate a Rig config and decode through Schema, preserving each plugin's
+ * `__runtime` channel. Schema decode strips unknown fields, so we capture
+ * the runtime objects before decoding and re-attach them after.
+ */
+export declare function defineConfig(cfg: RigConfigInput): RigConfig;

package/dist/src/define-config.js

@@ -2,6 +2,23 @@
 // packages/core/src/define-config.ts
 import { Schema } from "effect";
 import { RigConfig } from "@rig/contracts";
+function normalizeWorkspaceConfig(raw) {
+  const workspace = raw && typeof raw === "object" && !Array.isArray(raw) ? { ...raw } : { mainRepo: "." };
+  workspace.checkout = workspace.checkout ?? workspace.isolation ?? "worktree";
+  workspace.isolation = workspace.isolation ?? workspace.checkout;
+  workspace.sandbox = workspace.sandbox ?? "enforce";
+  return workspace;
+}
+function applyConfigDefaults(raw) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw))
+    return raw;
+  const record = raw;
+  return {
+    ...record,
+    plugins: Array.isArray(record.plugins) ? record.plugins : [],
+    workspace: normalizeWorkspaceConfig(record.workspace)
+  };
+}
 function defineConfig(cfg) {
   const runtimeByName = new Map;
   const plugins = cfg.plugins ?? [];
@@ -10,7 +27,7 @@ function defineConfig(cfg) {
       runtimeByName.set(plugin.name, plugin.__runtime);
     }
   }
-  const decoded = Schema.decodeUnknownSync(RigConfig)(cfg);
+  const decoded = Schema.decodeUnknownSync(RigConfig)(applyConfigDefaults(cfg));
   const decodedPlugins = decoded.plugins.map((p) => {
     const runtime = runtimeByName.get(p.name);
     if (!runtime)
@@ -20,5 +37,6 @@ function defineConfig(cfg) {
   return { ...decoded, plugins: decodedPlugins };
 }
 export {
-  defineConfig
+  defineConfig,
+  applyConfigDefaults
 };

package/dist/src/define-plugin.d.ts

@@ -0,0 +1,9 @@
+import { RigPlugin } from "@rig/contracts";
+import type { RigPluginRuntime, RigPluginWithRuntime } from "./plugin-runtime";
+/**
+ * Define a Rig plugin. The first argument is the schema-validated metadata
+ * (id strings, version, contributions). The optional second argument carries
+ * executable bits (validator `run` functions, etc.) that Schema cannot
+ * represent — they travel alongside the validated metadata as `__runtime`.
+ */
+export declare function definePlugin(meta: RigPlugin, runtime?: RigPluginRuntime): RigPluginWithRuntime;

package/dist/src/define-plugin.js

@@ -43,6 +43,54 @@ function definePlugin(meta, runtime) {
       }
     }
   }
+  const declaredHooks = new Map((validated.contributes?.hooks ?? []).map((h) => [h.id, h]));
+  for (const hookId of Object.keys(runtime.hooks ?? {})) {
+    const metadata = declaredHooks.get(hookId);
+    if (!metadata) {
+      throw new Error(`definePlugin(${validated.name}): typed hook "${hookId}" has no matching metadata entry in contributes.hooks`);
+    }
+    if (metadata.command) {
+      throw new Error(`definePlugin(${validated.name}): hook "${hookId}" has both a typed implementation and a command string \u2014 pick one`);
+    }
+  }
+  if (runtime.hooks) {
+    for (const h of declaredHooks.values()) {
+      if (!runtime.hooks[h.id] && !h.command) {
+        throw new Error(`definePlugin(${validated.name}): hook metadata "${h.id}" has no implementation (typed function or command)`);
+      }
+    }
+  }
+  const declaredCapabilities = new Map((validated.contributes?.capabilities ?? []).map((capability) => [capability.id, capability]));
+  for (const capability of runtime.featureCapabilities ?? []) {
+    if (!declaredCapabilities.has(capability.id)) {
+      throw new Error(`definePlugin(${validated.name}): executable capability "${capability.id}" has no matching metadata entry in contributes.capabilities`);
+    }
+  }
+  const declaredPanels = new Map((validated.contributes?.panels ?? []).map((panel) => [panel.id, panel]));
+  for (const panel of runtime.panels ?? []) {
+    const metadata = declaredPanels.get(panel.id);
+    if (!metadata) {
+      throw new Error(`definePlugin(${validated.name}): executable panel "${panel.id}" has no matching metadata entry in contributes.panels`);
+    }
+    if (metadata.slot !== panel.slot) {
+      throw new Error(`definePlugin(${validated.name}): executable panel "${panel.id}" slot "${panel.slot}" does not match metadata slot "${metadata.slot}"`);
+    }
+    if (metadata.capabilityId !== panel.capabilityId) {
+      throw new Error(`definePlugin(${validated.name}): executable panel "${panel.id}" capabilityId "${panel.capabilityId ?? "(none)"}" does not match metadata capabilityId "${metadata.capabilityId ?? "(none)"}"`);
+    }
+  }
+  const declaredBlockerClassifiers = new Map((validated.contributes?.blockerClassifiers ?? []).map((classifier) => [classifier.id, classifier]));
+  for (const classifier of runtime.blockerClassifiers ?? []) {
+    if (!declaredBlockerClassifiers.has(classifier.id)) {
+      throw new Error(`definePlugin(${validated.name}): executable blocker classifier "${classifier.id}" has no matching metadata entry in contributes.blockerClassifiers`);
+    }
+  }
+  const declaredCliCommands = new Map((validated.contributes?.cliCommands ?? []).map((command) => [command.id, command]));
+  for (const command of runtime.cliCommands ?? []) {
+    if (!declaredCliCommands.has(command.id)) {
+      throw new Error(`definePlugin(${validated.name}): executable cli command "${command.id}" has no matching metadata entry in contributes.cliCommands`);
+    }
+  }
   return { ...validated, __runtime: runtime };
 }
 export {

package/dist/src/dependencyGraph.d.ts

@@ -0,0 +1,43 @@
+import type { DependencyEdge as ContractDependencyEdge, DependencyNode as ContractDependencyNode, EngineReadModel, TaskSummary } from "@rig/contracts";
+import { type TaskGraphLayout } from "./taskGraphLayout";
+export type DependencyEdgeType = ContractDependencyEdge["type"];
+export interface DependencyEdge {
+    readonly fromTaskId: string;
+    readonly toTaskId: string;
+    readonly type: DependencyEdgeType;
+}
+export interface DependencyNode {
+    readonly taskId: string;
+    readonly title: string;
+    readonly status: ContractDependencyNode["status"];
+    readonly priority: ContractDependencyNode["priority"];
+    readonly assignee: string | null;
+    readonly blockedBy: readonly string[];
+    readonly blocks: readonly string[];
+    readonly blockingDepth: number;
+    readonly blockerClass: null;
+    readonly actionRiskTier: null;
+    readonly epicKey: string | null;
+    readonly groupKey?: string | null;
+    readonly externalId?: string | null;
+    readonly sourceIssueId?: string | null;
+    readonly scope?: readonly string[];
+    readonly validationKeys?: readonly string[];
+}
+export interface DependencyGraphModel {
+    readonly graphId: string;
+    readonly nodes: readonly DependencyNode[];
+    readonly edges: readonly DependencyEdge[];
+    readonly layout: TaskGraphLayout;
+    readonly cycles: readonly (readonly string[])[];
+    readonly unresolvedRefs: readonly string[];
+    readonly degraded: boolean;
+    readonly generatedAt: string;
+}
+export interface BuildDependencyGraphModelOptions {
+    readonly snapshot?: EngineReadModel | null;
+    readonly generatedAt?: string;
+    readonly graphId?: string;
+    readonly showParentChild?: boolean;
+}
+export declare function buildDependencyGraphModel(tasks: readonly TaskSummary[], options?: BuildDependencyGraphModelOptions): DependencyGraphModel;