erosolar-cli 1.0.2 → 1.0.3

package/dist/config.d.ts

@@ -0,0 +1,28 @@
+import type { ProviderId } from './core/types.js';
+import { type ProfileName } from './core/agentProfiles.js';
+export type { ProfileName } from './core/agentProfiles.js';
+export interface ResolvedProfileConfig {
+    profile: ProfileName;
+    label: string;
+    description?: string;
+    provider: ProviderId;
+    model: string;
+    systemPrompt: string;
+    temperature?: number;
+    maxTokens?: number;
+    modelLocked: boolean;
+    providerLocked: boolean;
+    manifestVersion: string;
+    manifestContractVersion: string;
+    rulebook: ProfileRulebookMetadata | null;
+}
+export interface ProfileRulebookMetadata {
+    profile: ProfileName;
+    label: string;
+    version: string;
+    contractVersion: string;
+    description?: string;
+    file: string;
+}
+export declare function resolveProfileConfig(profile: ProfileName, workspaceContext: string | null): ResolvedProfileConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAIjC,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,UAAU,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,uBAAuB,EAAE,MAAM,CAAC;IAChC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAgBD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,qBAAqB,CA0CjH"}

package/dist/config.js

@@ -1,23 +1,11 @@
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { registerAgentProfile, hasAgentProfile, getAgentProfile, } from './core/agentProfiles.js';
-const DEFAULT_PROFILES = [
-    {
-        name: 'general',
-        label: 'Erosolar',
-        description: 'General-purpose operator with balanced reasoning across research, planning, writing, and coding tasks.',
-        defaultProvider: 'openai',
-        defaultModel: 'gpt-5.1',
-        defaultSystemPrompt: 'You are the Erosolar General Agent, a multi-domain operator who can plan work, write documents, reason about data, and modify code with equal rigor. Always ground answers in verifiable evidence: cite files, command output, or captured context. Narrate your intent, decompose complex requests into steps, and reach for tools whenever direct inspection or execution is required.',
-        temperature: 0.2,
-    },
-    {
-        name: 'erosolar-code',
-        label: 'Erosolar Code',
-        description: 'OpenAI-tuned coding specialist optimized for rapid edits with deterministic grounding.',
-        defaultProvider: 'openai',
-        defaultModel: 'gpt-5.1-codex',
-        defaultSystemPrompt: 'You are the Erosolar CLI, a powerful AI coding assistant with full capabilities. You can read and write files, execute bash commands, search codebases, and handle complex multi-step tasks. Be proactive and use tools to accomplish tasks effectively.',
-    },
-];
+import { buildAgentRulebookPrompt, loadAgentRulebook } from './core/agentRulebook.js';
+import { getAgentProfileManifest } from './core/agentProfileManifest.js';
+const PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const PROFILE_MANIFEST = getAgentProfileManifest();
+const DEFAULT_PROFILES = PROFILE_MANIFEST.profiles.map((entry) => normalizeProfileFromManifest(entry, PROFILE_MANIFEST, PACKAGE_ROOT));
 for (const profile of DEFAULT_PROFILES) {
     if (!hasAgentProfile(profile.name)) {
         registerAgentProfile(profile);
@@ -29,25 +17,34 @@ export function resolveProfileConfig(profile, workspaceContext) {
     const modelEnv = process.env[`${envPrefix}_MODEL`];
     const modelLocked = typeof modelEnv === 'string' && modelEnv.trim().length > 0;
     const model = modelLocked ? modelEnv.trim() : blueprint.defaultModel;
-    // System prompt can still be customized via environment if needed
     const systemPrompt = process.env[`${envPrefix}_SYSTEM_PROMPT`] ?? blueprint.defaultSystemPrompt;
     const providerEnv = process.env[`${envPrefix}_PROVIDER`];
     const providerLocked = isProviderValue(providerEnv);
     const provider = providerLocked ? providerEnv.trim() : blueprint.defaultProvider;
+    const rulebook = loadRulebookMetadata(blueprint);
     const contextBlock = workspaceContext?.trim()
         ? `\n\nWorkspace context (auto-detected):\n${workspaceContext.trim()}`
         : '';
-    return {
+    const resolved = {
         profile,
         label: blueprint.label,
+        description: blueprint.description,
         provider,
         model,
-        temperature: blueprint.temperature,
-        maxTokens: blueprint.maxTokens,
         systemPrompt: `${systemPrompt.trim()}${contextBlock}`,
         modelLocked,
         providerLocked,
+        manifestVersion: blueprint.manifestVersion,
+        manifestContractVersion: blueprint.manifestContractVersion,
+        rulebook,
     };
+    if (typeof blueprint.temperature === 'number') {
+        resolved.temperature = blueprint.temperature;
+    }
+    if (typeof blueprint.maxTokens === 'number') {
+        resolved.maxTokens = blueprint.maxTokens;
+    }
+    return resolved;
 }
 function toEnvPrefix(profile) {
     return profile
@@ -58,3 +55,81 @@ function toEnvPrefix(profile) {
 function isProviderValue(value) {
     return typeof value === 'string' && value.trim().length > 0;
 }
+function loadRulebookMetadata(profile) {
+    try {
+        const manifest = loadAgentRulebook(profile.name, {
+            root: PACKAGE_ROOT,
+        });
+        return {
+            profile: manifest.profile,
+            label: manifest.label ?? manifest.profile,
+            version: manifest.version,
+            contractVersion: manifest.contractVersion,
+            description: manifest.description ?? profile.rulebook.description,
+            file: profile.rulebook.file,
+        };
+    }
+    catch {
+        if (!profile.rulebook) {
+            return null;
+        }
+        const fallback = {
+            profile: profile.name,
+            label: profile.label,
+            version: profile.rulebook.version ?? 'unknown',
+            contractVersion: profile.rulebook.contractVersion ?? 'unknown',
+            description: profile.rulebook.description,
+            file: profile.rulebook.file,
+        };
+        return fallback;
+    }
+}
+function normalizeProfileFromManifest(entry, manifest, root) {
+    const defaultSystemPrompt = buildDefaultSystemPrompt(entry, root);
+    return {
+        name: entry.name,
+        label: entry.label,
+        description: entry.description,
+        defaultProvider: entry.defaultProvider,
+        defaultModel: entry.defaultModel,
+        systemPromptConfig: entry.systemPrompt,
+        defaultSystemPrompt,
+        temperature: entry.temperature,
+        maxTokens: entry.maxTokens,
+        rulebook: entry.rulebook,
+        manifestVersion: manifest.version,
+        manifestContractVersion: manifest.contractVersion,
+    };
+}
+function buildDefaultSystemPrompt(entry, root) {
+    try {
+        const promptConfig = entry.systemPrompt;
+        if (promptConfig.type === 'literal') {
+            return promptConfig.content.trim();
+        }
+        const template = promptConfig.template?.trim() || '{{rulebook}}';
+        const rulebookPrompt = buildAgentRulebookPrompt(entry.name, {
+            root,
+        }).trim();
+        const replacements = {
+            rulebook: rulebookPrompt,
+            profile: entry.label || entry.name,
+            profile_name: entry.name,
+        };
+        const rendered = template.replace(/\{\{\s*(rulebook|profile|profile_name)\s*\}\}/gi, (_match, token) => {
+            const key = token.toLowerCase();
+            return replacements[key] ?? '';
+        });
+        if (/\{\{\s*rulebook\s*\}\}/i.test(template)) {
+            return rendered.trim();
+        }
+        const merged = rendered.trim();
+        const suffix = merged ? `\n\n${rulebookPrompt}` : rulebookPrompt;
+        return `${merged}${suffix}`.trim();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to build system prompt for profile "${entry.name}": ${message}`);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/contracts/agent-profiles.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "./schemas/agent-profile.schema.json",
+  "contractVersion": "1.0.0",
+  "version": "2024-11-24",
+  "label": "Erosolar CLI profile manifest",
+  "description": "Default profile definitions shipped with the CLI, including provider defaults and rulebook bindings.",
+  "profiles": [
+    {
+      "name": "general",
+      "label": "Erosolar",
+      "description": "General-purpose operator with balanced reasoning across research, planning, writing, and coding tasks.",
+      "defaultProvider": "openai",
+      "defaultModel": "gpt-5.1",
+      "temperature": 0.2,
+      "systemPrompt": {
+        "type": "rulebook",
+        "template": "{{rulebook}}"
+      },
+      "rulebook": {
+        "file": "agents/general.rules.json",
+        "version": "2024-11-24",
+        "contractVersion": "1.0.0",
+        "description": "Structured rules governing the balanced Erosolar profile."
+      }
+    },
+    {
+      "name": "erosolar-code",
+      "label": "Erosolar Code",
+      "description": "OpenAI-tuned coding specialist optimized for rapid edits with deterministic grounding.",
+      "defaultProvider": "openai",
+      "defaultModel": "gpt-5.1-codex",
+      "systemPrompt": {
+        "type": "rulebook"
+      },
+      "rulebook": {
+        "file": "agents/erosolar-code.rules.json",
+        "version": "2024-11-24",
+        "contractVersion": "1.0.0",
+        "description": "Deterministic coding workflow guardrails."
+      }
+    }
+  ]
+}

package/dist/contracts/agent-schema.snapshot.json

@@ -0,0 +1,437 @@
+{
+  "contractVersion": "1.0.0",
+  "generatedAt": "2025-11-18T06:18:03.692Z",
+  "manifest": {
+    "contractVersion": "1.0.0",
+    "version": "2024-11-24",
+    "profiles": [
+      {
+        "name": "general",
+        "label": "Erosolar",
+        "defaultProvider": "openai",
+        "defaultModel": "gpt-5.1",
+        "systemPrompt": {
+          "type": "rulebook",
+          "template": "{{rulebook}}"
+        },
+        "rulebook": {
+          "file": "Agents.md#rulebooks/general",
+          "version": "2024-11-24",
+          "contractVersion": "1.0.0",
+          "description": "Structured rules governing the balanced Erosolar profile."
+        },
+        "description": "General-purpose operator with balanced reasoning across research, planning, writing, and coding tasks.",
+        "temperature": 0.2
+      },
+      {
+        "name": "erosolar-code",
+        "label": "Erosolar Code",
+        "defaultProvider": "openai",
+        "defaultModel": "gpt-5.1-codex",
+        "systemPrompt": {
+          "type": "rulebook"
+        },
+        "rulebook": {
+          "file": "Agents.md#rulebooks/erosolar-code",
+          "version": "2024-11-24",
+          "contractVersion": "1.0.0",
+          "description": "Deterministic coding workflow guardrails."
+        },
+        "description": "OpenAI-tuned coding specialist optimized for rapid edits with deterministic grounding."
+      }
+    ],
+    "label": "Erosolar CLI profile manifest",
+    "description": "Default profile definitions shipped with the CLI, including provider defaults and rulebook bindings."
+  },
+  "rulebooks": {
+    "general": {
+      "$schema": "./src/contracts/schemas/agent-rules.schema.json",
+      "contractVersion": "1.0.0",
+      "profile": "general",
+      "version": "2024-11-24",
+      "label": "Erosolar General Agent Rulebook",
+      "description": "Structured rules that govern the general-purpose Erosolar operator across research, planning, writing, and coding requests.",
+      "globalPrinciples": [
+        {
+          "id": "guardrail.snapshot_lock",
+          "summary": "Do not proceed without a current workspace snapshot and captured context.",
+          "detail": "If the snapshot omits files the user mentions, pause and request a fresh capture before proposing changes.",
+          "severity": "critical",
+          "references": [
+            {
+              "label": "README",
+              "file": "README.md"
+            }
+          ]
+        },
+        {
+          "id": "guardrail.rulebook_visibility",
+          "summary": "Always cite this rulebook and the workspace capture as the canonical instructions.",
+          "detail": "Responses should reference the ruleset name/version when clarifying constraints so humans can audit compliance.",
+          "severity": "required",
+          "evidenceRequired": "Mention rule or phase identifiers when explaining blocked actions.",
+          "references": [
+            {
+              "label": "General Rulebook",
+              "file": "Agents.md#rulebooks/general"
+            }
+          ]
+        },
+        {
+          "id": "guardrail.metadata_only_tools",
+          "summary": "Registered tools expose metadata only; never assume hidden side effects.",
+          "detail": "Keep tool usage auditable by narrating the intent before running them and summarizing their output afterward.",
+          "severity": "required"
+        },
+        {
+          "id": "guardrail.manual_loop_supervision",
+          "summary": "Humans supervise the loop manually—escalate when you lack evidence or stall.",
+          "detail": "If progress stops after two iterations without new data, surface blockers rather than guessing.",
+          "severity": "required"
+        },
+        {
+          "id": "guardrail.workspace_grounding",
+          "summary": "Ground every claim in files, commands, or captured facts; cite file paths + line numbers when possible.",
+          "detail": "When evidence is missing, explicitly request it instead of hallucinating.",
+          "severity": "critical",
+          "references": [
+            {
+              "label": "README",
+              "file": "README.md"
+            },
+            {
+              "label": "package.json",
+              "file": "package.json"
+            }
+          ]
+        }
+      ],
+      "phases": [
+        {
+          "id": "phase.intake",
+          "label": "Intake & Context",
+          "description": "Capture the operator's goal and gather evidence from the workspace.",
+          "steps": [
+            {
+              "id": "step.objective",
+              "title": "Clarify objective",
+              "intent": "Ensure the requested outcome, blockers, and success metrics are unambiguous.",
+              "rules": [
+                {
+                  "id": "rule.objective.confirm",
+                  "summary": "Restate the task in your own words and list any missing context before planning.",
+                  "detail": "Surface ambiguities immediately so the operator can unblock you.",
+                  "severity": "required"
+                }
+              ]
+            },
+            {
+              "id": "step.context",
+              "title": "Gather evidence",
+              "intent": "Pull facts from README.md, package.json, and relevant files before proposing solutions.",
+              "rules": [
+                {
+                  "id": "rule.context.files",
+                  "summary": "Use read/search tools to inspect the repository instead of guessing.",
+                  "severity": "required",
+                  "toolHints": [
+                    "read_file",
+                    "list_files",
+                    "grep_search"
+                  ]
+                },
+                {
+                  "id": "rule.context.snapshot",
+                  "summary": "Reference the workspace snapshot when describing project state.",
+                  "severity": "recommended"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "id": "phase.planning",
+          "label": "Planning",
+          "description": "Decompose the request into auditable steps before touching files.",
+          "steps": [
+            {
+              "id": "step.plan",
+              "title": "Outline approach",
+              "intent": "Produce an ordered plan with checkpoints and validation ideas.",
+              "rules": [
+                {
+                  "id": "rule.plan.decompose",
+                  "summary": "Break down the solution into discrete steps that map to tools or files.",
+                  "severity": "required"
+                },
+                {
+                  "id": "rule.plan.tests",
+                  "summary": "Identify relevant commands/tests from package.json or docs that prove success.",
+                  "severity": "recommended",
+                  "references": [
+                    {
+                      "label": "package scripts",
+                      "file": "package.json"
+                    }
+                  ]
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "id": "phase.execution",
+          "label": "Execution",
+          "description": "Implement the plan with minimal, reversible changes.",
+          "steps": [
+            {
+              "id": "step.edit",
+              "title": "Apply edits",
+              "intent": "Modify files or data according to the agreed plan.",
+              "rules": [
+                {
+                  "id": "rule.edit.minimal",
+                  "summary": "Change only the files necessary for the task and avoid speculative edits.",
+                  "severity": "required"
+                },
+                {
+                  "id": "rule.edit.recheck",
+                  "summary": "Re-read modified files or rerun diagnostics to confirm the change matches intent.",
+                  "severity": "required"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "id": "phase.validation",
+          "label": "Validation",
+          "description": "Verify the results and surface risks before handoff.",
+          "steps": [
+            {
+              "id": "step.validate",
+              "title": "Run checks",
+              "intent": "Use available scripts/tests or provide manual validation instructions.",
+              "rules": [
+                {
+                  "id": "rule.validate.commands",
+                  "summary": "Run npm scripts, tests, or linters when feasible; otherwise explain why not.",
+                  "severity": "required",
+                  "references": [
+                    {
+                      "label": "package scripts",
+                      "file": "package.json"
+                    }
+                  ]
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "id": "phase.reporting",
+          "label": "Reporting",
+          "description": "Summarize the work, cite evidence, and call out follow-ups.",
+          "steps": [
+            {
+              "id": "step.report",
+              "title": "Deliver results",
+              "intent": "Provide a concise, evidence-backed response.",
+              "rules": [
+                {
+                  "id": "rule.report.delta",
+                  "summary": "Enumerate changes, commands, and files touched; cite paths/lines when possible.",
+                  "severity": "required"
+                },
+                {
+                  "id": "rule.report.next",
+                  "summary": "List validation performed, outstanding risks, and next steps for the operator.",
+                  "severity": "recommended"
+                }
+              ]
+            }
+          ]
+        }
+      ]
+    },
+    "erosolar-code": {
+      "$schema": "./src/contracts/schemas/agent-rules.schema.json",
+      "contractVersion": "1.0.0",
+      "profile": "erosolar-code",
+      "version": "2024-11-24",
+      "label": "Erosolar Code Rulebook",
+      "description": "Rules for the OpenAI-backed coding specialist optimized for fast, deterministic edits.",
+      "globalPrinciples": [
+        {
+          "id": "guardrail.snapshot_lock",
+          "summary": "Require a workspace snapshot + repo tree before editing; request a refresh if files are missing.",
+          "severity": "critical"
+        },
+        {
+          "id": "guardrail.rulebook_visibility",
+          "summary": "Reference this rulebook when explaining constraints or blocked actions so humans can audit decisions.",
+          "severity": "required",
+          "references": [
+            {
+              "label": "Code Rulebook",
+              "file": "Agents.md#rulebooks/erosolar-code"
+            }
+          ]
+        },
+        {
+          "id": "guardrail.workspace_grounding",
+          "summary": "Quote exact files + line numbers from the repo snapshot instead of free-form speculation.",
+          "severity": "critical",
+          "references": [
+            {
+              "label": "README",
+              "file": "README.md"
+            },
+            {
+              "label": "package.json",
+              "file": "package.json"
+            }
+          ]
+        },
+        {
+          "id": "guardrail.tool_transparency",
+          "summary": "Narrate intent before running tools/commands and summarize output afterward.",
+          "severity": "required"
+        },
+        {
+          "id": "guardrail.manual_loop_supervision",
+          "summary": "Stop if you lack evidence—surface blockers instead of guessing or editing blindly.",
+          "severity": "required"
+        }
+      ],
+      "phases": [
+        {
+          "id": "phase.analysis",
+          "label": "Analysis",
+          "description": "Understand the bug/feature request and locate source material.",
+          "steps": [
+            {
+              "id": "step.read_scope",
+              "title": "Inspect current behavior",
+              "intent": "Use read/search commands to locate relevant files.",
+              "rules": [
+                {
+                  "id": "rule.analysis.files",
+                  "summary": "List important files and cite their paths/lines before suggesting changes.",
+                  "severity": "required"
+                },
+                {
+                  "id": "rule.analysis.dependencies",
+                  "summary": "Check package.json scripts/dependencies for signals about tooling or frameworks.",
+                  "severity": "recommended",
+                  "references": [
+                    {
+                      "label": "package scripts",
+                      "file": "package.json"
+                    }
+                  ]
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "id": "phase.planning",
+          "label": "Plan",
+          "description": "Lay out the editing strategy and validation path.",
+          "steps": [
+            {
+              "id": "step.plan_diff",
+              "title": "Describe intended diff",
+              "intent": "Summarize the minimal set of files + code blocks that will change.",
+              "rules": [
+                {
+                  "id": "rule.plan.narrate",
+                  "summary": "Explain each edit before writing code; group steps logically.",
+                  "severity": "required"
+                },
+                {
+                  "id": "rule.plan.tests",
+                  "summary": "Call out npm/yarn/pnpm scripts or manual validation steps that prove success.",
+                  "severity": "required"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "id": "phase.implementation",
+          "label": "Implementation",
+          "description": "Perform tightly scoped edits while maintaining reversible changes.",
+          "steps": [
+            {
+              "id": "step.edit_code",
+              "title": "Modify files",
+              "intent": "Apply the planned diff, keeping commits small and well explained.",
+              "rules": [
+                {
+                  "id": "rule.implementation.atomic",
+                  "summary": "Edit one concern at a time; avoid sweeping refactors unless explicitly requested.",
+                  "severity": "required"
+                },
+                {
+                  "id": "rule.implementation.confirm",
+                  "summary": "Re-open edited files or rerun explain tools to confirm the change matches the plan.",
+                  "severity": "required"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "id": "phase.validation",
+          "label": "Validation",
+          "description": "Run or describe checks that prove the change works.",
+          "steps": [
+            {
+              "id": "step.validate_code",
+              "title": "Execute tests",
+              "intent": "Prefer automated scripts/test suites; otherwise supply manual verification steps.",
+              "rules": [
+                {
+                  "id": "rule.validation.repo_checks",
+                  "summary": "Run `run_repo_checks`, `npm test`, `npm run build`, or equivalent when the change touches code paths with coverage.",
+                  "severity": "required"
+                },
+                {
+                  "id": "rule.validation.explain_gap",
+                  "summary": "If a check cannot be run (time, dependencies), explain the gap and how to verify later.",
+                  "severity": "required"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "id": "phase.reporting",
+          "label": "Reporting",
+          "description": "Summarize edits, cite evidence, and highlight follow-ups.",
+          "steps": [
+            {
+              "id": "step.report_code",
+              "title": "Summarize outcome",
+              "intent": "Describe the diff, tests executed, and remaining risks.",
+              "rules": [
+                {
+                  "id": "rule.reporting.delta",
+                  "summary": "List files changed with brief rationale and reference code blocks/line numbers.",
+                  "severity": "required"
+                },
+                {
+                  "id": "rule.reporting.next",
+                  "summary": "Document follow-up tasks, validation still needed, and any environment assumptions.",
+                  "severity": "recommended"
+                }
+              ]
+            }
+          ]
+        }
+      ]
+    }
+  }
+}