infraweaver 0.1.0

package/dist/external.d.ts

@@ -0,0 +1,227 @@
+/**
+ * ⚠️ LIMITED IMPORTS - this file is imported by Next.js and must avoid pulling in backend code.
+ * All shared constants, types, and data used by both the Next.js app and the action runtime live here.
+ * Other files in action/ re-export from this file for backward compatibility.
+ */
+import type { PullRequest } from "@octokit/webhooks-types";
+export declare const infraweaverMcpName = "infraweaver";
+/** @see {@link file://./agents/shared.ts} Agent interface that uses this type */
+export type AgentId = "claude" | "opencode";
+/**
+ * format a tool name the way each agent's MCP client presents it to the model.
+ * claude code: mcp__infraweaver__select_mode
+ * opencode:    infraweaver_select_mode
+ */
+export declare function formatMcpToolRef(agentId: AgentId, toolName: string): string;
+export type { ModelAlias, ModelProvider, ProviderConfig } from "#app/models";
+export { DEFAULT_PROXY_MODEL, getAutoSelectHintModel, getModelEnvVars, getModelManagedCredentials, getModelProvider, getProviderDisplayName, modelAliases, parseModel, providers, resolveCliModel, resolveDisplayAlias, resolveModelSlug, resolveOpenRouterModel, } from "#app/models";
+export type ToolPermission = "disabled" | "enabled";
+export type ShellPermission = "disabled" | "restricted" | "enabled";
+export type PushPermission = "disabled" | "restricted" | "enabled";
+export type WorkflowPermissionValue = "read" | "write" | "none";
+export type WorkflowIdTokenPermissionValue = "write" | "none";
+export interface WorkflowPermissions {
+    actions?: WorkflowPermissionValue;
+    attestations?: WorkflowPermissionValue;
+    checks?: WorkflowPermissionValue;
+    contents?: WorkflowPermissionValue;
+    deployments?: WorkflowPermissionValue;
+    discussions?: WorkflowPermissionValue;
+    "id-token"?: WorkflowIdTokenPermissionValue;
+    issues?: WorkflowPermissionValue;
+    models?: WorkflowPermissionValue;
+    packages?: WorkflowPermissionValue;
+    pages?: WorkflowPermissionValue;
+    "pull-requests"?: WorkflowPermissionValue;
+    "repository-projects"?: WorkflowPermissionValue;
+    "security-events"?: WorkflowPermissionValue;
+    statuses?: WorkflowPermissionValue;
+}
+export type AuthorPermission = "admin" | "maintain" | "write" | "triage" | "read" | "none";
+interface BasePayloadEvent {
+    issue_number?: number;
+    is_pr?: boolean;
+    branch?: string;
+    /** title of the issue/PR (or contextual title for comments) */
+    title?: string;
+    /** primary content for this trigger (issue body, PR body, comment body, review body, etc.) */
+    body?: string | null;
+    comment_id?: number;
+    review_id?: number;
+    review_state?: string;
+    /** GraphQL review-thread context (shape owned by the backend producer; not read in-action) */
+    thread?: unknown;
+    pull_request?: PullRequest;
+    check_suite?: {
+        id: number;
+        head_sha: string;
+        head_branch: string | null;
+        status: string | null;
+        conclusion: string | null;
+        url: string;
+    };
+    comment_ids?: number[] | "all";
+    /** permission level of the user who triggered this event */
+    authorPermission?: AuthorPermission;
+    /** when true, runs silently without progress comments (e.g., auto-labeling) */
+    silent?: boolean;
+    [key: string]: unknown;
+}
+interface PullRequestOpenedEvent extends BasePayloadEvent {
+    trigger: "pull_request_opened";
+    issue_number: number;
+    is_pr: true;
+    title: string;
+    body: string | null;
+    branch: string;
+}
+interface PullRequestReadyForReviewEvent extends BasePayloadEvent {
+    trigger: "pull_request_ready_for_review";
+    issue_number: number;
+    is_pr: true;
+    title: string;
+    body: string | null;
+    branch: string;
+}
+interface PullRequestReviewRequestedEvent extends BasePayloadEvent {
+    trigger: "pull_request_review_requested";
+    issue_number: number;
+    is_pr: true;
+    title: string;
+    body: string | null;
+    branch: string;
+}
+interface PullRequestReviewSubmittedEvent extends BasePayloadEvent {
+    trigger: "pull_request_review_submitted";
+    issue_number: number;
+    is_pr: true;
+    review_id: number;
+    /** review body is the primary content */
+    body: string | null;
+    review_state: string;
+    branch: string;
+}
+interface PullRequestReviewCommentCreatedEvent extends BasePayloadEvent {
+    trigger: "pull_request_review_comment_created";
+    issue_number: number;
+    is_pr: true;
+    title: string;
+    comment_id: number;
+    /** comment body is the primary content (null if already in prompt) */
+    body: string | null;
+    thread?: unknown;
+    branch: string;
+}
+interface IssuesOpenedEvent extends BasePayloadEvent {
+    trigger: "issues_opened";
+    issue_number: number;
+    title: string;
+    body: string | null;
+}
+interface IssuesAssignedEvent extends BasePayloadEvent {
+    trigger: "issues_assigned";
+    issue_number: number;
+    title: string;
+    body: string | null;
+}
+interface IssuesLabeledEvent extends BasePayloadEvent {
+    trigger: "issues_labeled";
+    issue_number: number;
+    title: string;
+    body: string | null;
+}
+interface IssueCommentCreatedEvent extends BasePayloadEvent {
+    trigger: "issue_comment_created";
+    comment_id: number;
+    /** distinguishes this from PR review comments (which use pull_request_review_comment_created) */
+    comment_type: "issue";
+    /** comment body is the primary content (null if already in prompt) */
+    body: string | null;
+    issue_number: number;
+    is_pr?: true;
+    branch?: string;
+    title?: string;
+}
+interface CheckSuiteCompletedEvent extends BasePayloadEvent {
+    trigger: "check_suite_completed";
+    issue_number: number;
+    is_pr: true;
+    title: string;
+    body: string | null;
+    pull_request: PullRequest;
+    branch: string;
+    check_suite: {
+        id: number;
+        head_sha: string;
+        head_branch: string | null;
+        status: string | null;
+        conclusion: string | null;
+        url: string;
+    };
+}
+interface WorkflowDispatchEvent extends BasePayloadEvent {
+    trigger: "workflow_dispatch";
+}
+interface FixReviewEvent extends BasePayloadEvent {
+    trigger: "fix_review";
+    issue_number: number;
+    is_pr: true;
+    review_id: number;
+    /** when true, only address comments the triggerer approved with 👍 (vs all comments) */
+    approved_only?: boolean | undefined;
+}
+interface ImplementPlanEvent extends BasePayloadEvent {
+    trigger: "implement_plan";
+    issue_number: number;
+    plan_comment_id: number;
+    /** plan content is the primary content (null if already in prompt) */
+    body: string | null;
+}
+interface PullRequestSynchronizeEvent extends BasePayloadEvent {
+    trigger: "pull_request_synchronize";
+    issue_number: number;
+    is_pr: true;
+    title: string;
+    body: string | null;
+    branch: string;
+    /** SHA before the push -- used to compute incremental range-diff between PR versions */
+    before_sha: string;
+}
+interface UnknownEvent extends BasePayloadEvent {
+    trigger: "unknown";
+}
+export type PayloadEvent = PullRequestOpenedEvent | PullRequestReadyForReviewEvent | PullRequestSynchronizeEvent | PullRequestReviewRequestedEvent | PullRequestReviewSubmittedEvent | PullRequestReviewCommentCreatedEvent | IssuesOpenedEvent | IssuesAssignedEvent | IssuesLabeledEvent | IssueCommentCreatedEvent | CheckSuiteCompletedEvent | WorkflowDispatchEvent | FixReviewEvent | ImplementPlanEvent | UnknownEvent;
+export interface WriteablePayload {
+    "~infraweaver": true;
+    /** semantic version of the payload to ensure compatibility */
+    version: string;
+    /** provider/model slug (e.g. "anthropic/claude-opus") */
+    model?: string | undefined;
+    /** the user's actual request (body if @infraweaver tagged) */
+    prompt: string;
+    /** github username of the human who triggered this workflow run */
+    triggerer?: string | undefined;
+    /** event-level instructions for this trigger type (flag-expanded server-side) */
+    eventInstructions?: string | undefined;
+    /**
+     * system-injected note about prior superseded runs (e.g. when the
+     * triggering @infraweaver comment is edited). rendered alongside the user's
+     * prompt rather than via eventInstructions so it survives user-prompt
+     * precedence.
+     */
+    previousRunsNote?: string | undefined;
+    /** event data from webhook payload - discriminated union based on trigger field */
+    event: PayloadEvent;
+    /** timeout for agent run (e.g., "10m", "1h30m") - defaults to "1h" */
+    timeout?: string | undefined;
+    /** working directory for the agent */
+    cwd?: string | undefined;
+    /** pre-created progress comment (ID + type) for updating status */
+    progressComment?: {
+        id: string;
+        type: "issue" | "review";
+    } | undefined;
+    /** when true, seed the PR summary tmpfile + persist edits at run end */
+    generateSummary?: boolean | undefined;
+}
+export type Payload = Readonly<WriteablePayload>;

package/dist/i18n/scaffolding.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Fixed engine scaffolding strings, keyed by the run's user-facing `language`
+ * (the `language:` action input — see `utils/payload.ts`). This is the small
+ * message table the i18n plan (docs/I18N-AND-MULTI-REGION-PLAN.md A.5) calls for:
+ * the LLM-authored PROSE is localized by the vetted directive, but the fixed
+ * wrapper text a renderer emits (section headers, empty-state notes) lives here.
+ *
+ * Scope note: only the self-contained pure body renderer that reads it today is
+ * the Remediation Dashboard (`mcp/dashboard.ts`). Other scaffolding surfaces
+ * (comment.ts section labels) are intentionally NOT migrated yet — their prose is
+ * already localized by the run directive; extracting their labels is a follow-up.
+ *
+ * Translation provenance: the non-English entries are machine translations pending
+ * a native-speaker review pass (same posture as the website catalogs). The glossary
+ * is honoured — the product names Infraweaver / Remediate and the `@infraweaver fix`
+ * command, plus Terraform / PR, stay verbatim in every language.
+ */
+import type { UserFacingLanguage } from "#app/utils/payload";
+/** the fixed strings the Remediation Dashboard body renders around its data. */
+export interface DashboardStrings {
+    /** the italic blurb at the top of the issue. */
+    maintainedBy: string;
+    /** `## <openPrs> (N)` heading label. */
+    openPrs: string;
+    /** empty state under the open-PRs heading. */
+    noneOpen: string;
+    /** `## <waiting> (N)` heading label. */
+    waiting: string;
+    /** empty state under the waiting heading. */
+    nothingWaiting: string;
+    /** the "how to open one of these" line above the waiting list. */
+    openOnDemand: string;
+    /** `## <suppressed> (N)` heading label. */
+    suppressed: string;
+}
+/** the dashboard scaffolding pack for a language (English for an unknown code). */
+export declare function dashboardStrings(language: UserFacingLanguage | undefined): DashboardStrings;
+/**
+ * Fixed "chrome" labels Infraweaver renders around its comments/PRs/reviews: the
+ * footer's model prefix and the action-link labels (the `[… ➔](url)` buttons in a
+ * comment footer). The link TARGET and the `➔` glyph are the caller's; only the
+ * label text is localized. Model names and product names stay verbatim.
+ */
+export interface ChromeStrings {
+    /** footer: `<using> \`Model Name\``. */
+    using: string;
+    /** plan comment: open the implement-plan trigger. */
+    implementPlan: string;
+    /** error comment: re-dispatch the failed job. */
+    rerunFailedJob: string;
+    /** review footer: dispatch a fix for every finding. */
+    fixAll: string;
+    /** review footer: dispatch a fix for the 👍-approved findings only. */
+    fixApproved: string;
+    /** review footer: dispatch a fix for the single finding. */
+    fixIt: string;
+}
+/** the comment/PR/review chrome pack for a language (English for an unknown code). */
+export declare function chromeStrings(language: UserFacingLanguage | undefined): ChromeStrings;

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Library entry point for npm package
+ * This exports the main function for programmatic usage
+ */
+export type { Agent, AgentResult, AgentRunContext } from "#app/agents/shared";
+export { type Inputs as ExecutionInputs, type MainResult, main } from "#app/main";