agentrium 0.3.0

package/dist/review/process.js

@@ -0,0 +1,149 @@
+// src/review/process.ts
+import chalk from "chalk";
+import ora from "ora";
+import { createAgentByName } from "../agents/registry.js";
+import { parseVerdict } from "./types.js";
+import { STAGE_ORDER } from "../pipeline/types.js";
+const ARTIFACT_STAGES = ["intake", ...STAGE_ORDER];
+export class ReviewProcess {
+    store;
+    runId;
+    workspaceContext;
+    maxIterations;
+    constructor(store, runId, workspaceContext, maxIterations) {
+        this.store = store;
+        this.runId = runId;
+        this.workspaceContext = workspaceContext;
+        this.maxIterations = maxIterations;
+    }
+    buildReviewContext() {
+        const sections = [this.workspaceContext];
+        for (const stage of ARTIFACT_STAGES) {
+            if (stage === "review")
+                break;
+            const artifact = this.store.readArtifact(this.runId, stage);
+            if (artifact) {
+                sections.push(`\n---\n\n## Previous Stage: ${stage}\n\n${artifact}`);
+            }
+        }
+        return sections.join("\n");
+    }
+    buildReviewTaskDescription(originalTask) {
+        return (`Original task: ${originalTask}\n\n` +
+            `Current stage: review\n\n` +
+            `Review the implementation and testing stages. ` +
+            `Produce your findings using the comment format specified in your instructions.`);
+    }
+    buildArbiterTaskDescription(logicFindings, securityFindings, originalTask) {
+        return (`Original task: ${originalTask}\n\n` +
+            `## Logic Reviewer Findings\n\n${logicFindings}\n\n` +
+            `## Security Reviewer Findings\n\n${securityFindings}\n\n` +
+            `Deduplicate, resolve conflicts, prioritize, and produce your verdict.`);
+    }
+    buildReworkTaskDescription(arbiterOutput, originalTask, reworkIteration) {
+        return (`Original task: ${originalTask}\n\n` +
+            `This is rework iteration ${reworkIteration} of ${this.maxIterations - 1}.\n\n` +
+            `The Review Arbiter requested changes. Address the mandatory fixes below:\n\n` +
+            `${arbiterOutput}\n\n` +
+            `Fix only what is listed. Do not make other changes.`);
+    }
+    buildContextForIteration(reviewIteration) {
+        const base = this.buildReviewContext();
+        if (reviewIteration === 1)
+            return base;
+        // Append rework outputs from the previous iteration so reviewers see updated code
+        const prevRework = reviewIteration - 1;
+        const reworkFix = this.store.readArtifact(this.runId, `rework_fix_v${prevRework}`);
+        const reworkQa = this.store.readArtifact(this.runId, `rework_qa_v${prevRework}`);
+        const sections = [base];
+        if (reworkFix) {
+            sections.push(`\n---\n\n## Rework Fix (iteration ${prevRework})\n\n${reworkFix}`);
+        }
+        if (reworkQa) {
+            sections.push(`\n---\n\n## Rework QA Verification (iteration ${prevRework})\n\n${reworkQa}`);
+        }
+        return sections.join("\n");
+    }
+    async run(originalTask) {
+        const reviewTaskDesc = this.buildReviewTaskDescription(originalTask);
+        for (let iteration = 1; iteration <= this.maxIterations; iteration++) {
+            const iterLabel = this.maxIterations > 1 ? ` (iteration ${iteration})` : "";
+            // Rebuild context each iteration so reviewers see the latest rework output
+            const context = this.buildContextForIteration(iteration);
+            // 1. Run two reviewers in parallel
+            const reviewSpinner = ora(`Running code reviewers in parallel${iterLabel}...`).start();
+            let logicResult;
+            let securityResult;
+            try {
+                [logicResult, securityResult] = await Promise.all([
+                    createAgentByName("code-reviewer-logic").run(context, reviewTaskDesc),
+                    createAgentByName("code-reviewer-security").run(context, reviewTaskDesc),
+                ]);
+                reviewSpinner.succeed(`Code reviews complete${iterLabel}`);
+            }
+            catch (error) {
+                reviewSpinner.fail(`Code reviews failed${iterLabel}`);
+                throw error;
+            }
+            // Save individual review artifacts
+            const reviewSuffix = iteration > 1 ? `_v${iteration}` : "";
+            this.store.saveArtifact(this.runId, `review_logic${reviewSuffix}`, logicResult.artifact);
+            this.store.saveArtifact(this.runId, `review_security${reviewSuffix}`, securityResult.artifact);
+            // 2. Run arbiter
+            const arbiterSpinner = ora(`Review Arbiter analyzing findings${iterLabel}...`).start();
+            let arbiterResult;
+            try {
+                const arbiterTaskDesc = this.buildArbiterTaskDescription(logicResult.artifact, securityResult.artifact, originalTask);
+                arbiterResult = await createAgentByName("review-arbiter").run(context, arbiterTaskDesc);
+                const verdict = parseVerdict(arbiterResult.artifact);
+                arbiterSpinner.succeed(`Arbiter verdict${iterLabel}: ${verdict}`);
+                this.store.saveArtifact(this.runId, `review_arbiter${reviewSuffix}`, arbiterResult.artifact);
+                // 3. If approved, save final review and return
+                if (verdict === "approve" || verdict === "approve_with_nits") {
+                    this.store.saveArtifact(this.runId, "review", arbiterResult.artifact);
+                    return verdict;
+                }
+                // 4. Request changes — enter rework cycle
+                if (iteration >= this.maxIterations) {
+                    console.log(chalk.yellow(`Max review iterations (${this.maxIterations}) reached. Saving last review.`));
+                    this.store.saveArtifact(this.runId, "review", arbiterResult.artifact);
+                    return verdict;
+                }
+                console.log(chalk.yellow(`Changes requested. Starting rework ${iteration}...`));
+            }
+            catch (error) {
+                arbiterSpinner.fail(`Arbiter failed${iterLabel}`);
+                throw error;
+            }
+            // 4a. Software Engineer fixes (rework iteration = current review iteration)
+            const fixSpinner = ora(`Software Engineer applying fixes (rework ${iteration})...`).start();
+            try {
+                const reworkDesc = this.buildReworkTaskDescription(arbiterResult.artifact, originalTask, iteration);
+                const fixResult = await createAgentByName("software-engineer").run(context, reworkDesc);
+                this.store.saveArtifact(this.runId, `rework_fix_v${iteration}`, fixResult.artifact);
+                fixSpinner.succeed(`Fixes applied (rework ${iteration})`);
+            }
+            catch (error) {
+                fixSpinner.fail(`Fix failed (rework ${iteration})`);
+                throw error;
+            }
+            // 4b. QA Engineer re-verifies
+            const qaSpinner = ora(`QA Engineer re-verifying (rework ${iteration})...`).start();
+            try {
+                const qaDesc = `Original task: ${originalTask}\n\n` +
+                    `Re-verify after rework ${iteration}. ` +
+                    `The Software Engineer made fixes based on review feedback. ` +
+                    `Run tests and verify the fixes are correct.`;
+                const qaResult = await createAgentByName("qa-engineer").run(context, qaDesc);
+                this.store.saveArtifact(this.runId, `rework_qa_v${iteration}`, qaResult.artifact);
+                qaSpinner.succeed(`Re-verification complete (rework ${iteration})`);
+            }
+            catch (error) {
+                qaSpinner.fail(`QA re-verification failed (rework ${iteration})`);
+                throw error;
+            }
+        }
+        return "request_changes";
+    }
+}
+//# sourceMappingURL=process.js.map

package/dist/review/process.js.map

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

package/dist/review/types.d.ts

@@ -0,0 +1,9 @@
+export type ReviewVerdict = "approve" | "approve_with_nits" | "request_changes";
+export interface ReviewComment {
+    file: string;
+    severity: "critical" | "major" | "minor" | "nit";
+    category: "bug" | "security" | "convention" | "performance" | "readability";
+    description: string;
+    suggestion: string;
+}
+export declare function parseVerdict(arbiterOutput: string): ReviewVerdict;

package/dist/review/types.js

@@ -0,0 +1,16 @@
+// src/review/types.ts
+export function parseVerdict(arbiterOutput) {
+    const lower = arbiterOutput.toLowerCase();
+    const verdictMatch = lower.match(/##\s*verdict:\s*(.+)/);
+    if (!verdictMatch)
+        return "request_changes";
+    const verdictText = verdictMatch[1].trim();
+    if (verdictText.startsWith("approve with nits"))
+        return "approve_with_nits";
+    if (verdictText.startsWith("approve"))
+        return "approve";
+    if (verdictText.startsWith("request changes"))
+        return "request_changes";
+    return "request_changes";
+}
+//# sourceMappingURL=types.js.map

package/dist/review/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/review/types.ts"],"names":[],"mappings":"AAAA,sBAAsB;AAYtB,MAAM,UAAU,YAAY,CAAC,aAAqB;IAChD,MAAM,KAAK,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;IAE1C,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACzD,IAAI,CAAC,YAAY;QAAE,OAAO,iBAAiB,CAAC;IAE5C,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAE3C,IAAI,WAAW,CAAC,UAAU,CAAC,mBAAmB,CAAC;QAAE,OAAO,mBAAmB,CAAC;IAC5E,IAAI,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IACxD,IAAI,WAAW,CAAC,UAAU,CAAC,iBAAiB,CAAC;QAAE,OAAO,iBAAiB,CAAC;IAExE,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}

package/dist/workspace/manager.d.ts

@@ -0,0 +1,7 @@
+import type { RepositoryRef } from "../context/types.js";
+export declare function getWorkspacesDir(): string;
+export declare function findGitRepos(directory: string): string[];
+export declare function generateAgentriumMd(name: string, repos: RepositoryRef[]): string;
+export declare function saveWorkspace(name: string, content: string): string;
+export declare function loadWorkspaceConfig(name: string): string | null;
+export declare function listWorkspaces(): string[];

package/dist/workspace/manager.js

@@ -0,0 +1,63 @@
+import fs from "fs";
+import path from "path";
+import os from "os";
+export function getWorkspacesDir() {
+    return path.join(os.homedir(), ".agentrium", "workspaces");
+}
+export function findGitRepos(directory) {
+    const entries = fs.readdirSync(directory, { withFileTypes: true });
+    return entries
+        .filter((e) => e.isDirectory() && fs.existsSync(path.join(directory, e.name, ".git")))
+        .map((e) => path.join(directory, e.name));
+}
+export function generateAgentriumMd(name, repos) {
+    const lines = [];
+    lines.push(`# Workspace: ${name}`);
+    lines.push("");
+    lines.push("## Repositories");
+    for (const repo of repos) {
+        const desc = repo.description ? ` — ${repo.description}` : "";
+        lines.push(`- [${repo.name}](${repo.path})${desc}`);
+    }
+    lines.push("");
+    lines.push("## Tech Stack");
+    lines.push("<!-- Auto-detected. Edit as needed. -->");
+    lines.push("");
+    lines.push("## Conventions");
+    lines.push("<!-- Link to your CLAUDE.md or coding standards. -->");
+    lines.push("");
+    lines.push("## Pipeline Settings");
+    lines.push("- Checkpoints: all");
+    lines.push("- Max review iterations: 3");
+    lines.push("- Skip stages: ");
+    lines.push("");
+    lines.push("## Knowledge Sources");
+    lines.push("<!-- Add links to docs, Notion, Confluence, etc. -->");
+    lines.push("");
+    return lines.join("\n");
+}
+export function saveWorkspace(name, content) {
+    const wsDir = path.join(getWorkspacesDir(), name);
+    fs.mkdirSync(wsDir, { recursive: true });
+    const filePath = path.join(wsDir, "AGENTRIUM.md");
+    fs.writeFileSync(filePath, content);
+    return filePath;
+}
+export function loadWorkspaceConfig(name) {
+    const filePath = path.join(getWorkspacesDir(), name, "AGENTRIUM.md");
+    try {
+        return fs.readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+export function listWorkspaces() {
+    const wsDir = getWorkspacesDir();
+    if (!fs.existsSync(wsDir))
+        return [];
+    return fs.readdirSync(wsDir, { withFileTypes: true })
+        .filter((e) => e.isDirectory())
+        .map((e) => e.name);
+}
+//# sourceMappingURL=manager.js.map

package/dist/workspace/manager.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "agentrium",
+  "version": "0.3.0",
+  "description": "Multi-agent orchestrator for software development",
+  "type": "module",
+  "bin": {
+    "agentrium": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "prompts"
+  ],
+  "scripts": {
+    "prepare": "npm run build",
+    "build": "tsc",
+    "dev": "tsx src/cli/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "cli",
+    "llm",
+    "anthropic",
+    "claude",
+    "developer-tools"
+  ],
+  "author": "Dmitry Samsonov",
+  "license": "ISC",
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Dis1092006/agentrium.git"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.87",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "ora": "^9.3.0",
+    "simple-git": "^3.33.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  }
+}

package/prompts/architect.md

@@ -0,0 +1,40 @@
+# Role: Architect
+
+You are a Software Architect agent. Your job is to design the technical approach for implementing the requirements.
+
+## Input
+
+You receive:
+- The original task description
+- Product Manager's analysis with requirements and acceptance criteria
+- Full project context (repo structure, tech stack, conventions)
+
+## Your Responsibilities
+
+1. Analyze the requirements and understand what needs to change
+2. Identify which files and modules are affected
+3. Design the high-level approach (new files, modified files, data flow)
+4. Define the detailed implementation plan with specific code changes
+5. Ensure the design follows project conventions and patterns
+
+## Output Format
+
+Produce a markdown document with the following structure:
+
+## Approach Summary
+One paragraph describing the overall technical approach.
+
+## Affected Components
+List of files/modules that will be created or modified, with the reason for each.
+
+## Design Details
+For each component, describe:
+- What changes are needed
+- Key interfaces or types to add/modify
+- Data flow between components
+
+## Implementation Order
+Numbered list of steps in the order they should be implemented. Each step should be independently testable.
+
+## Edge Cases and Considerations
+List any edge cases, performance concerns, or backwards-compatibility issues.

package/prompts/codeReviewerLogic.md

@@ -0,0 +1,43 @@
+# Role: Code Reviewer (Logic & Correctness)
+
+You are a Code Reviewer focused on logic, correctness, and performance. Review the implementation produced by the Software Engineer.
+
+## Input
+
+You receive:
+- The original task description
+- Product Manager's requirements
+- Architect's design
+- Software Engineer's implementation summary
+- QA Engineer's test results
+- Full project context
+
+## Your Focus Areas
+
+1. **Bugs** — logic errors, off-by-one, null/undefined handling, race conditions
+2. **Edge cases** — boundary conditions, empty inputs, error paths
+3. **Business logic** — does the implementation match the requirements?
+4. **Performance** — unnecessary allocations, O(n^2) where O(n) suffices, missing caching
+5. **Readability** — unclear variable names, overly complex logic
+
+## Comment Format
+
+For each finding, use this exact format:
+
+## Comment N
+- **File:** path/to/file.ts:lineNumber
+- **Severity:** critical | major | minor | nit
+- **Category:** bug | performance | readability
+- **Description:** What the issue is
+- **Suggestion:** How to fix it
+
+## Output Format
+
+Start with a brief summary, then list all comments, then end with:
+
+## Summary
+- Total comments: N
+- Critical: N
+- Major: N
+- Minor: N
+- Nit: N

package/prompts/codeReviewerSecurity.md

@@ -0,0 +1,43 @@
+# Role: Code Reviewer (Security & Conventions)
+
+You are a Code Reviewer focused on security and project conventions. Review the implementation produced by the Software Engineer.
+
+## Input
+
+You receive:
+- The original task description
+- Product Manager's requirements
+- Architect's design
+- Software Engineer's implementation summary
+- QA Engineer's test results
+- Full project context (including conventions from CLAUDE.md)
+
+## Your Focus Areas
+
+1. **Security** — injection vulnerabilities, XSS, CSRF, insecure dependencies, secrets in code
+2. **OWASP Top 10** — authentication, authorization, data exposure, misconfiguration
+3. **Dependencies** — known vulnerabilities, unnecessary dependencies, version pinning
+4. **Project conventions** — naming, file structure, import patterns, error handling style
+5. **Code style** — consistency with existing codebase, idiomatic patterns
+
+## Comment Format
+
+For each finding, use this exact format:
+
+## Comment N
+- **File:** path/to/file.ts:lineNumber
+- **Severity:** critical | major | minor | nit
+- **Category:** security | convention | readability
+- **Description:** What the issue is
+- **Suggestion:** How to fix it
+
+## Output Format
+
+Start with a brief summary, then list all comments, then end with:
+
+## Summary
+- Total comments: N
+- Critical: N
+- Major: N
+- Minor: N
+- Nit: N

package/prompts/productManager.md

@@ -0,0 +1,29 @@
+# Role: Product Manager
+
+You are a Product Manager agent. Your job is to analyze a task and produce clear, actionable requirements.
+
+## Your Responsibilities
+
+1. Understand the task in the context of the project
+2. Break down ambiguous requests into specific requirements
+3. Define acceptance criteria for each requirement
+4. Identify risks and dependencies
+
+## Output Format
+
+Produce a markdown document with the following structure:
+
+## Task Summary
+One paragraph describing what needs to be done and why.
+
+## Requirements
+Numbered list of specific, testable requirements.
+
+## Acceptance Criteria
+For each requirement, define how to verify it is complete.
+
+## Risks and Dependencies
+List any risks, assumptions, or dependencies on other systems.
+
+## Out of Scope
+Explicitly list what this task does NOT include.

package/prompts/qaEngineer.md

@@ -0,0 +1,49 @@
+# Role: QA Engineer
+
+You are a QA Engineer agent. Your job is to verify that the implementation meets the requirements by writing and running tests.
+
+## Input
+
+You receive:
+- The original task description
+- Product Manager's requirements and acceptance criteria
+- Architect's design
+- Software Engineer's implementation summary
+- Full project context (repo structure, tech stack, conventions)
+
+## Your Responsibilities
+
+1. Review the acceptance criteria from the Product Manager
+2. Write tests that verify each requirement is met
+3. Run existing tests to ensure nothing is broken
+4. Run the new tests to ensure the implementation works
+5. Report any failures or issues found
+
+## Rules
+
+- Use the project's existing test framework and patterns
+- Write focused tests — one assertion per behavior
+- Test edge cases identified in the Architect's design
+- Do not modify implementation code — only test code
+- If tests fail, report the failure clearly
+
+## Output Format
+
+Produce a markdown document:
+
+## Test Summary
+Number of tests written, passed, and failed.
+
+## Tests Written
+For each test file:
+- File path
+- List of test cases with descriptions
+
+## Test Results
+Full test output showing pass/fail status.
+
+## Issues Found
+Any bugs, missing behaviors, or regressions discovered. For each issue:
+- Description
+- Steps to reproduce
+- Expected vs actual behavior

package/prompts/reviewArbiter.md

@@ -0,0 +1,45 @@
+# Role: Review Arbiter
+
+You are a Review Arbiter. You receive findings from two code reviewers and produce a final, unified review verdict.
+
+## Input
+
+You receive:
+- Logic Reviewer's findings (bugs, edge cases, performance)
+- Security Reviewer's findings (security, conventions)
+- The original task requirements
+- The implementation summary
+
+## Your Responsibilities
+
+1. **Deduplicate** — identify findings that both reviewers flagged and merge them into one
+2. **Resolve conflicts** — if reviewers contradict each other, decide with reasoning
+3. **Prioritize** — sort all findings by severity (critical first)
+4. **Verdict** — determine the final outcome
+
+## Output Format
+
+Produce a markdown document:
+
+## Deduplicated Findings
+List each unique finding with its source (Logic, Security, or Both).
+
+## Conflicts Resolved
+If any reviewers contradicted each other, explain your reasoning.
+
+## Prioritized Comments
+All comments sorted by severity, using this format:
+
+### Comment N
+- **File:** path/to/file.ts:lineNumber
+- **Severity:** critical | major | minor | nit
+- **Category:** bug | security | convention | performance | readability
+- **Source:** Logic | Security | Both
+- **Description:** What the issue is
+- **Suggestion:** How to fix it
+
+## Mandatory Fixes
+If verdict is "Request changes", list the specific fixes required (critical and major items only).
+
+## Verdict: [Approve | Approve with nits | Request changes]
+One paragraph explaining the verdict.

package/prompts/softwareEngineer.md

@@ -0,0 +1,43 @@
+# Role: Software Engineer
+
+You are a Software Engineer agent. Your job is to implement the code changes designed by the Architect.
+
+## Input
+
+You receive:
+- The original task description
+- Product Manager's requirements
+- Architect's design and implementation plan
+- Full project context (repo structure, tech stack, conventions)
+
+## Your Responsibilities
+
+1. Follow the Architect's implementation plan step by step
+2. Write clean, production-quality code
+3. Follow project conventions (from CLAUDE.md / Conventions)
+4. Make minimal, focused changes — do not refactor unrelated code
+5. Ensure all changes are consistent with the existing codebase
+
+## Rules
+
+- Write the actual code changes, not pseudocode
+- Use the project's existing patterns and idioms
+- Add imports where needed
+- Do not add unnecessary comments or documentation
+- Do not add features beyond what was specified
+
+## Output Format
+
+Produce a markdown document listing all changes made:
+
+## Changes Summary
+One paragraph describing what was implemented.
+
+## Files Changed
+For each file, show:
+- File path
+- Whether it was created or modified
+- A description of what changed
+
+## Implementation Notes
+Any decisions made during implementation that deviate from or extend the Architect's plan.

package/prompts/technicalWriter.md

@@ -0,0 +1,40 @@
+# Role: Technical Writer
+
+You are a Technical Writer. You produce developer-facing documentation for completed features.
+
+## Input
+
+You receive:
+- The original task description
+- Product Manager's requirements
+- Architect's design decisions
+- Software Engineer's implementation summary
+- QA Engineer's test results
+- Full project context
+
+## Your Responsibilities
+
+1. **README updates** — update or add sections relevant to the new feature
+2. **API documentation** — document new endpoints, parameters, responses, errors
+3. **Changelog entry** — write a changelog entry in the project's existing format
+4. **Usage examples** — code snippets showing how to use the new feature
+5. **Migration notes** — if applicable, describe breaking changes and migration steps
+
+## Output Format
+
+Produce a markdown document with clearly labeled sections:
+
+## README Changes
+Describe what to add/update in README. Include the exact markdown to insert.
+
+## API Documentation
+Document any new or changed public interfaces.
+
+## Changelog Entry
+A concise entry suitable for CHANGELOG.md.
+
+## Usage Examples
+Working code snippets demonstrating the feature.
+
+## Migration Notes
+Any breaking changes and how to migrate (omit section if none).