@h-rig/core 0.0.6-alpha.17 → 0.0.6-alpha.170

package/dist/src/plugin-host-context.d.ts

@@ -0,0 +1,66 @@
+/**
+ * plugin-host-context.ts
+ *
+ * Wires the new declarative plugin API into runtime startup.
+ *
+ * Calling flow:
+ *   buildPluginHostContext(projectRoot)
+ *     → loadConfig(projectRoot)          (from @rig/core)
+ *     → createPluginHost(cfg.plugins)    (from @rig/core)
+ *     → createValidatorRegistry()        + register plugin validators
+ *     → buildTaskSourceRegistry(config)
+ *     → createRepoRegistry(...)
+ *     → createAgentRoleRegistry(...)
+ *     → createTaskFieldRegistry(...)
+ *
+ * The function is intentionally non-throwing for the "no rig.config found" case
+ * so harness boot can choose between explicit legacy compatibility mode and a
+ * no-plugin mode without masking found-but-broken configs.
+ *
+ * NOTE: registries are instantiated here. The validatorRegistry is consumed
+ * by CLI/harness validation and completion verification. Task dispatch and
+ * closeout read/update the configured plugin task source directly, with
+ * materialized task-config kept only as an explicit compatibility export.
+ */
+import type { RepoRegistry, RigConfig } from "@rig/contracts";
+import type { PluginHost } from "./plugin-host";
+import { type TaskFieldRegistry, type TaskSourceRegistry } from "./plugin-host-registries";
+import type { AgentRoleRegistry } from "@rig/contracts";
+import { type ValidatorRegistry } from "./validator-registry";
+/** All registries populated from the declarative RigPlugin contributions. */
+export interface PluginHostContext {
+    /** The loaded rig.config — available for further config-driven decisions. */
+    config: RigConfig;
+    /** Flattened read-only index of all plugin contributions. */
+    pluginHost: PluginHost;
+    /** Validators contributed by plugins, ready for dispatch. */
+    validatorRegistry: ValidatorRegistry;
+    /** Task source adapter(s) configured in rig.config.taskSource. */
+    taskSourceRegistry: TaskSourceRegistry;
+    /** Repo source registrations contributed by plugins. */
+    repoRegistry: RepoRegistry;
+    /**
+     * Agent role registrations contributed by plugins, merged with
+     * config.runtime.agentRoles model overrides.
+     *
+     * NOTE: createAgentRoleRegistry throws when a role has no model.  If any
+     * plugin-contributed role lacks defaultModel and is not covered by a config
+     * override, registry construction fails.  The outer try/catch in
+     * buildPluginHostContext propagates this as-is so the operator sees the error
+     * rather than silently losing roles.
+     */
+    agentRoleRegistry: AgentRoleRegistry;
+    /** Task field schema extensions contributed by plugins. */
+    taskFieldRegistry: TaskFieldRegistry;
+}
+/**
+ * Load the project's rig.config, build a plugin host from its declared plugins,
+ * and instantiate all runtime registries from the plugin contributions.
+ *
+ * @returns The populated context, or `null` if no rig.config was found.
+ *
+ * @throws If a rig.config IS found but is invalid (schema error, duplicate
+ *         plugin ids, missing model on an agent role, etc.).  A found-but-broken
+ *         config should surface immediately rather than falling back silently.
+ */
+export declare function buildPluginHostContext(projectRoot: string): Promise<PluginHostContext | null>;