@hmharness/agent 0.14.4 → 0.14.6

package/dist/pipeline.d.ts

@@ -1,6 +1,6 @@
 import { runLoop, type LoopResult, type ProviderConfig, type Registry, type ToolContext } from '@hmharness/kernel';
 import type { DeviceTestOptions, DeviceTestStep } from '@hmharness/domain-harmony';
-export type PipelineStage = 'plan' | 'code' | 'test' | 'review' | 'judge' | 'device';
+export type PipelineStage = 'plan' | 'architect' | 'code' | 'test' | 'review' | 'judge' | 'device';
 /** stage labels used in runStage (repairer = the repair-loop role) */
 export type StageRole = PipelineStage | 'repairer';
 export interface StageRecord {

package/dist/pipeline.js

@@ -56,6 +56,7 @@ function stageMessages(opts, role, directive) {
 }
 const DIRECTIVES = {
     plan: (task) => `Goal: ${task}\nProduce the numbered implementation plan (each step names its verification). Do not execute anything.`,
+    architect: (task, extra) => `Goal: ${task}\n${extra}\nMake the structural decisions for this task: module boundaries, data flow, interface contracts, technology tradeoffs, risks. Numbered decisions with rationale; flag the riskiest one. No code.`,
     code: (task, extra) => `Goal: ${task}\n${extra}\nImplement the plan now (surgical edits, cheapest verification per step).`,
     test: (task, extra) => `Goal: ${task}\n${extra}\nRun the verifications from the plan; probe edge cases; report input -> actual vs expected for each probe.`,
     review: (_task, extra) => `Review the changes produced so far on disk.\n${extra}\nFindings first, severity-ordered, file:line evidence, no fixes.`,
@@ -144,13 +145,19 @@ export async function runPipeline(opts) {
             status = 'budget';
             return await finish();
         }
-        // 2. code (carries the plan)
-        await runStage('code', 1, DIRECTIVES.code(opts.task, `Approved plan:\n${plan.text.slice(0, 2000)}`));
+        // 2. architect (structural decisions between plan and code, V3 slice 4)
+        const arch = await runStage('architect', 1, DIRECTIVES.architect(opts.task, `Plan:\n${plan.text.slice(0, 1500)}`));
         if (spent >= totalBudget) {
             status = 'budget';
             return await finish();
         }
-        // 3. test + repair loop (code+test rerun carries the reviewer/judge findings)
+        // 3. code (carries plan + architecture)
+        await runStage('code', 1, DIRECTIVES.code(opts.task, `Approved plan:\n${plan.text.slice(0, 1500)}\nArchitecture decisions:\n${arch.text.slice(0, 1500)}`));
+        if (spent >= totalBudget) {
+            status = 'budget';
+            return await finish();
+        }
+        // 4. test + repair loop (code+test rerun carries the reviewer/judge findings)
         let testOut = await runStage('test', 1, DIRECTIVES.test(opts.task, `Plan:\n${plan.text.slice(0, 1500)}`));
         if (spent >= totalBudget) {
             status = 'budget';

package/dist/roles.js

@@ -1,4 +1,9 @@
 export const TEAM_ROLES = {
+    architect: {
+        name: 'architect',
+        charter: 'ARCHITECT duty: make structural decisions - module boundaries, data flow, interface contracts, technology tradeoffs, and key risks. Output a numbered decision list where each decision names its rationale and its blast radius (what breaks if wrong). Never write code, never execute steps - decisions only. Flag the single riskiest decision explicitly.',
+        goodFor: 'structural decisions between planning and coding',
+    },
     planner: {
         name: 'planner',
         charter: 'PLANNER duty: decompose the goal into ordered, verifiable steps. Output a numbered plan where every step names its verification (command/check). Never execute the steps yourself - plan only. Flag risks and unknowns explicitly.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hmharness/agent",
-  "version": "0.14.4",
+  "version": "0.14.6",
   "description": "hmharness agent execution layer: base tools, system prompt, sub-agent spawn, and the shared task runner that frontends (cli, web) drive.",
   "type": "module",
   "main": "dist/index.js",
@@ -17,7 +17,7 @@
   "dependencies": {
     "@hmharness/domain-harmony": "0.13.5",
     "@hmharness/domain-ops": "0.8.0",
-    "@hmharness/evolution": "0.14.4",
+    "@hmharness/evolution": "0.14.5",
     "@hmharness/kernel": "0.9.0",
     "@hmharness/observability": "0.7.0",
     "@hmharness/sandbox": "0.8.0"