agentic-orchestrator 0.1.6 → 0.1.8

package/eslint.config.mjs

@@ -15,8 +15,8 @@ export default tseslint.config(
       'agentic/features/**',
       'agentic/runtime/**',
       '**/*.d.ts',
-      'packages/web-dashboard/**'
-    ]
+      'packages/web-dashboard/**',
+    ],
   },
   js.configs.recommended,
   ...tseslint.configs.recommended,
@@ -24,23 +24,23 @@ export default tseslint.config(
     files: ['**/*.{js,mjs,cjs}'],
     languageOptions: {
       globals: {
-        ...globals.node
-      }
+        ...globals.node,
+      },
     },
     rules: {
-      'no-console': 'off'
-    }
+      'no-console': 'off',
+    },
   },
   {
     files: ['**/*.ts'],
     languageOptions: {
       globals: {
-        ...globals.node
+        ...globals.node,
       },
       parserOptions: {
         projectService: true,
-        tsconfigRootDir: import.meta.dirname
-      }
+        tsconfigRootDir: import.meta.dirname,
+      },
     },
     rules: {
       '@typescript-eslint/consistent-type-imports': 'error',
@@ -54,8 +54,8 @@ export default tseslint.config(
         {
           argsIgnorePattern: '^_',
           caughtErrorsIgnorePattern: '^_',
-          varsIgnorePattern: '^_'
-        }
+          varsIgnorePattern: '^_',
+        },
       ],
       '@typescript-eslint/require-await': 'error',
       '@typescript-eslint/return-await': 'off',
@@ -64,20 +64,20 @@ export default tseslint.config(
       'no-console': [
         'error',
         {
-          allow: ['warn', 'error']
-        }
+          allow: ['warn', 'error'],
+        },
       ],
       'no-debugger': 'error',
       'no-var': 'error',
       'object-shorthand': ['error', 'always'],
-      'prefer-const': 'error'
-    }
+      'prefer-const': 'error',
+    },
   },
   {
     files: ['apps/control-plane/scripts/**/*.{ts,mjs}', 'apps/control-plane/src/cli/aop.ts'],
     rules: {
-      'no-console': 'off'
-    }
+      'no-console': 'off',
+    },
   },
   {
     files: ['apps/control-plane/test/**/*.ts'],
@@ -88,7 +88,7 @@ export default tseslint.config(
       '@typescript-eslint/no-unsafe-member-access': 'off',
       '@typescript-eslint/no-unsafe-return': 'off',
       '@typescript-eslint/require-await': 'off',
-      '@typescript-eslint/unbound-method': 'off'
-    }
-  }
+      '@typescript-eslint/unbound-method': 'off',
+    },
+  },
 );

package/example-configurations/README.md

@@ -14,7 +14,7 @@ Each stack includes:
 Usage:
 
 1. Pick a stack folder.
-2. Copy its files into `agentic/orchestrator/`.
+2. Copy its files into `config/agentic/orchestrator/`.
 3. Adjust commands, paths, and thresholds to your repository.
 
 Important:

package/example-configurations/java/agents.yaml

@@ -1,11 +1,11 @@
 version: 1
 roles:
   planner:
-    system_prompt_path: agentic/orchestrator/prompts/planner.system.md
+    system_prompt_path: config/agentic/orchestrator/prompts/planner.system.md
   builder:
-    system_prompt_path: agentic/orchestrator/prompts/builder.system.md
+    system_prompt_path: config/agentic/orchestrator/prompts/builder.system.md
   qa:
-    system_prompt_path: agentic/orchestrator/prompts/qa.system.md
+    system_prompt_path: config/agentic/orchestrator/prompts/qa.system.md
 missing_prompt_behavior: ignore
 runtime:
   default_provider: custom

package/example-configurations/java/policy.yaml

@@ -24,7 +24,7 @@ locks:
     multiplier: 2
     jitter_ms: 150
 protected_areas:
-  - agentic/orchestrator/schemas
+  - config/agentic/orchestrator/schemas
   - pom.xml
 exclusive_areas:
   - src/main/java

package/example-configurations/node/agents.yaml

@@ -1,11 +1,11 @@
 version: 1
 roles:
   planner:
-    system_prompt_path: agentic/orchestrator/prompts/planner.system.md
+    system_prompt_path: config/agentic/orchestrator/prompts/planner.system.md
   builder:
-    system_prompt_path: agentic/orchestrator/prompts/builder.system.md
+    system_prompt_path: config/agentic/orchestrator/prompts/builder.system.md
   qa:
-    system_prompt_path: agentic/orchestrator/prompts/qa.system.md
+    system_prompt_path: config/agentic/orchestrator/prompts/qa.system.md
 missing_prompt_behavior: ignore
 runtime:
   default_provider: custom

package/example-configurations/node/policy.yaml

@@ -24,7 +24,7 @@ locks:
     multiplier: 2
     jitter_ms: 150
 protected_areas:
-  - agentic/orchestrator/schemas
+  - config/agentic/orchestrator/schemas
   - package-lock.json
 exclusive_areas:
   - apps/api

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-orchestrator",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "private": false,
   "workspaces": [
     "packages/*"
@@ -12,6 +12,7 @@
     "test": "npm run nx -- run control-plane:test",
     "run": "tsx apps/control-plane/src/cli/aop.ts",
     "build": "npm run lint && npm run nx -- run control-plane:build",
+    "verify": "npm run typecheck && npm run validate:all && npm run lint:fix && npm run format && npm run test && npm run nx -- run control-plane:build",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "validate:mcp-contracts": "tsx apps/control-plane/scripts/validate-mcp-contracts.ts",
     "validate:docker-mcp": "node apps/control-plane/scripts/validate-docker-mcp-contract.mjs",
@@ -19,7 +20,10 @@
     "validate:all": "npm run validate:mcp-contracts && npm run validate:docker-mcp && npm run validate:architecture",
     "lint": "eslint . --max-warnings 0",
     "lint:fix": "npm run lint -- --fix",
-    "publish:npm": "npm run typecheck && npm run validate:all && npm run test && npm run build && npm publish",
+    "format": "prettier . --cache --write --ignore-unknown",
+    "format:check": "prettier . --cache --check --ignore-unknown",
+    "publish:docker": "docker build -t agentic-orchestrator:latest . && docker push agentic-orchestrator:latest",
+    "publish:npm": "npm run verify && npm publish",
     "dashboard:dev": "npm run --workspace @aop/web-dashboard dev",
     "dashboard:build": "npm run --workspace @aop/web-dashboard build",
     "dashboard:start": "npm run --workspace @aop/web-dashboard start"
@@ -28,17 +32,18 @@
     "aop": "dist/apps/control-plane/cli/aop.js"
   },
   "devDependencies": {
-    "@testing-library/react": "^16.3.2",
     "@eslint/js": "^10.0.1",
+    "@testing-library/react": "^16.3.2",
     "@types/node": "^25.3.3",
     "@vitest/coverage-v8": "^4.0.18",
     "eslint": "^10.0.2",
     "globals": "^17.4.0",
+    "msw": "^2.12.10",
     "nx": "^22.5.3",
+    "prettier": "^3.8.1",
     "tsx": "^4.21.0",
-    "typescript-eslint": "^8.56.1",
     "typescript": "^5.9.3",
-    "msw": "^2.12.10",
+    "typescript-eslint": "^8.56.1",
     "vitest": "^4.0.18"
   },
   "dependencies": {

package/packages/web-dashboard/next.config.js

@@ -1,7 +1,7 @@
 /** @type {import('next').NextConfig} */
 const nextConfig = {
   experimental: {
-    externalDir: true
-  }
+    externalDir: true,
+  },
 };
 export default nextConfig;

package/packages/web-dashboard/src/app/api/actions/route.ts

@@ -1,4 +1,8 @@
-import { approveFeatureReview, denyFeatureReview, requestFeatureChanges } from '@/lib/orchestrator-tools.js';
+import {
+  approveFeatureReview,
+  denyFeatureReview,
+  requestFeatureChanges,
+} from '@/lib/orchestrator-tools.js';
 import { resolveProjectRoot } from '@/lib/aop-client.js';
 
 export const dynamic = 'force-dynamic';
@@ -20,15 +24,21 @@ export async function POST(req: Request): Promise<Response> {
   if (!body.feature_id) {
     return Response.json(
       { ok: false, error: { code: 'feature_id_required', message: 'feature_id is required' } },
-      { status: 400 }
+      { status: 400 },
     );
   }
 
   if (body.action === 'review.approve') {
     if (!body.approval_token) {
       return Response.json(
-        { ok: false, error: { code: 'approval_token_required', message: 'approval_token is required for approval' } },
-        { status: 400 }
+        {
+          ok: false,
+          error: {
+            code: 'approval_token_required',
+            message: 'approval_token is required for approval',
+          },
+        },
+        { status: 400 },
       );
     }
     const response = await approveFeatureReview(
@@ -36,7 +46,7 @@ export async function POST(req: Request): Promise<Response> {
       body.approval_token,
       body.merge_strategy ?? 'merge_commit',
       body.commit_message,
-      repoRoot
+      repoRoot,
     );
     return Response.json(response, { status: response.ok ? 200 : 409 });
   }
@@ -44,8 +54,11 @@ export async function POST(req: Request): Promise<Response> {
   if (body.action === 'review.deny') {
     if (!body.reason || body.reason.trim().length === 0) {
       return Response.json(
-        { ok: false, error: { code: 'reason_required', message: 'reason is required for deny action' } },
-        { status: 400 }
+        {
+          ok: false,
+          error: { code: 'reason_required', message: 'reason is required for deny action' },
+        },
+        { status: 400 },
       );
     }
     const response = await denyFeatureReview(body.feature_id, body.reason.trim(), repoRoot);
@@ -58,7 +71,10 @@ export async function POST(req: Request): Promise<Response> {
   }
 
   return Response.json(
-    { ok: false, error: { code: 'unsupported_action', message: `Unsupported action: ${String(body.action)}` } },
-    { status: 400 }
+    {
+      ok: false,
+      error: { code: 'unsupported_action', message: `Unsupported action: ${String(body.action)}` },
+    },
+    { status: 400 },
   );
 }

package/packages/web-dashboard/src/app/api/events/route.ts

@@ -15,13 +15,21 @@ export async function GET(req: Request): Promise<Response> {
       // Send initial snapshot
       void (async () => {
         const payload = await readDashboardStatus(repoRoot);
-        controller.enqueue(encoder.encode(`data: ${JSON.stringify({ type: 'snapshot', features: payload.index, payload })}\n\n`));
+        controller.enqueue(
+          encoder.encode(
+            `data: ${JSON.stringify({ type: 'snapshot', features: payload.index, payload })}\n\n`,
+          ),
+        );
       })();
 
       // Heartbeat every 15s
       heartbeatInterval = setInterval(() => {
-        try { controller.enqueue(encoder.encode(': heartbeat\n\n')); }
-        catch { clearInterval(heartbeatInterval); clearInterval(pollInterval); }
+        try {
+          controller.enqueue(encoder.encode(': heartbeat\n\n'));
+        } catch {
+          clearInterval(heartbeatInterval);
+          clearInterval(pollInterval);
+        }
       }, 15000);
 
       // Poll every 2s
@@ -29,8 +37,14 @@ export async function GET(req: Request): Promise<Response> {
         void (async () => {
           try {
             const payload = await readDashboardStatus(repoRoot);
-            controller.enqueue(encoder.encode(`data: ${JSON.stringify({ type: 'snapshot', features: payload.index, payload })}\n\n`));
-          } catch { /* ignore */ }
+            controller.enqueue(
+              encoder.encode(
+                `data: ${JSON.stringify({ type: 'snapshot', features: payload.index, payload })}\n\n`,
+              ),
+            );
+          } catch {
+            /* ignore */
+          }
         })();
       }, 2000);
     },
@@ -44,7 +58,7 @@ export async function GET(req: Request): Promise<Response> {
     headers: {
       'Content-Type': 'text/event-stream',
       'Cache-Control': 'no-cache',
-      'Connection': 'keep-alive',
+      Connection: 'keep-alive',
       'X-Accel-Buffering': 'no',
     },
   });

package/packages/web-dashboard/src/app/api/features/[id]/checkout/route.ts

@@ -29,11 +29,14 @@ async function git(repoRoot: string, args: string[]): Promise<{ stdout: string;
   const result = await execFileAsync('git', args, { cwd: repoRoot });
   return {
     stdout: result.stdout ?? '',
-    stderr: result.stderr ?? ''
+    stderr: result.stderr ?? '',
   };
 }
 
-async function gitTry(repoRoot: string, args: string[]): Promise<{ ok: boolean; stdout: string; stderr: string }> {
+async function gitTry(
+  repoRoot: string,
+  args: string[],
+): Promise<{ ok: boolean; stdout: string; stderr: string }> {
   try {
     const result = await git(repoRoot, args);
     return { ok: true, stdout: result.stdout, stderr: result.stderr };
@@ -42,7 +45,7 @@ async function gitTry(repoRoot: string, args: string[]): Promise<{ ok: boolean;
     return {
       ok: false,
       stdout: typed.stdout ?? '',
-      stderr: typed.stderr ?? ''
+      stderr: typed.stderr ?? '',
     };
   }
 }
@@ -61,7 +64,12 @@ async function branchExists(repoRoot: string, branch: string): Promise<boolean>
   if (local.ok) {
     return true;
   }
-  const remote = await gitTry(repoRoot, ['show-ref', '--verify', '--quiet', `refs/remotes/origin/${branch}`]);
+  const remote = await gitTry(repoRoot, [
+    'show-ref',
+    '--verify',
+    '--quiet',
+    `refs/remotes/origin/${branch}`,
+  ]);
   return remote.ok;
 }
 
@@ -84,11 +92,18 @@ async function currentBranch(repoRoot: string): Promise<string> {
   return result.stdout.trim();
 }
 
-async function checkoutFeature(repoRoot: string, featureId: string, stashChanges: boolean): Promise<Response> {
+async function checkoutFeature(
+  repoRoot: string,
+  featureId: string,
+  stashChanges: boolean,
+): Promise<Response> {
   if (await mergeInProgress(repoRoot)) {
     return Response.json(
-      { ok: false, error: { code: 'merge_in_progress', message: 'Cannot checkout while merge is in progress' } },
-      { status: 409 }
+      {
+        ok: false,
+        error: { code: 'merge_in_progress', message: 'Cannot checkout while merge is in progress' },
+      },
+      { status: 409 },
     );
   }
 
@@ -99,26 +114,32 @@ async function checkoutFeature(repoRoot: string, featureId: string, stashChanges
         ok: false,
         error: {
           code: 'checkout_already_active',
-          message: `Checkout already active for feature ${existing.checked_out_feature_id}; restore first`
-        }
+          message: `Checkout already active for feature ${existing.checked_out_feature_id}; restore first`,
+        },
       },
-      { status: 409 }
+      { status: 409 },
     );
   }
 
   const state = await readFeatureState(featureId, repoRoot);
   if (!state) {
     return Response.json(
-      { ok: false, error: { code: 'feature_not_found', message: `Feature ${featureId} not found` } },
-      { status: 404 }
+      {
+        ok: false,
+        error: { code: 'feature_not_found', message: `Feature ${featureId} not found` },
+      },
+      { status: 404 },
     );
   }
 
   const branch = state.branch ?? featureId;
   if (!(await branchExists(repoRoot, branch))) {
     return Response.json(
-      { ok: false, error: { code: 'branch_not_found', message: `Feature branch not found: ${branch}` } },
-      { status: 404 }
+      {
+        ok: false,
+        error: { code: 'branch_not_found', message: `Feature branch not found: ${branch}` },
+      },
+      { status: 404 },
     );
   }
 
@@ -127,8 +148,14 @@ async function checkoutFeature(repoRoot: string, featureId: string, stashChanges
     await access(worktreePath);
   } catch {
     return Response.json(
-      { ok: false, error: { code: 'worktree_not_found', message: `Feature worktree not found: ${worktreePath}` } },
-      { status: 404 }
+      {
+        ok: false,
+        error: {
+          code: 'worktree_not_found',
+          message: `Feature worktree not found: ${worktreePath}`,
+        },
+      },
+      { status: 404 },
     );
   }
 
@@ -137,9 +164,18 @@ async function checkoutFeature(repoRoot: string, featureId: string, stashChanges
 
   if (stashChanges && (await isDirtyWorkspace(repoRoot))) {
     const beforeStash = await gitTry(repoRoot, ['rev-parse', '--verify', '-q', 'refs/stash']);
-    await git(repoRoot, ['stash', 'push', '-u', '-m', `aop-dashboard-checkout:${featureId}:${Date.now()}`]);
+    await git(repoRoot, [
+      'stash',
+      'push',
+      '-u',
+      '-m',
+      `aop-dashboard-checkout:${featureId}:${Date.now()}`,
+    ]);
     const afterStash = await gitTry(repoRoot, ['rev-parse', '--verify', '-q', 'refs/stash']);
-    if (afterStash.ok && (!beforeStash.ok || beforeStash.stdout.trim() !== afterStash.stdout.trim())) {
+    if (
+      afterStash.ok &&
+      (!beforeStash.ok || beforeStash.stdout.trim() !== afterStash.stdout.trim())
+    ) {
       stashRef = afterStash.stdout.trim();
     }
   }
@@ -147,8 +183,14 @@ async function checkoutFeature(repoRoot: string, featureId: string, stashChanges
   const checkoutResult = await gitTry(repoRoot, ['checkout', branch]);
   if (!checkoutResult.ok) {
     return Response.json(
-      { ok: false, error: { code: 'checkout_failed', message: checkoutResult.stderr.trim() || 'git checkout failed' } },
-      { status: 409 }
+      {
+        ok: false,
+        error: {
+          code: 'checkout_failed',
+          message: checkoutResult.stderr.trim() || 'git checkout failed',
+        },
+      },
+      { status: 409 },
     );
   }
 
@@ -157,7 +199,7 @@ async function checkoutFeature(repoRoot: string, featureId: string, stashChanges
     checked_out_branch: branch,
     previous_branch: previous,
     stash_ref: stashRef,
-    created_at: new Date().toISOString()
+    created_at: new Date().toISOString(),
   };
   const restoreFile = restoreFilePath(repoRoot);
   await mkdir(path.dirname(restoreFile), { recursive: true });
@@ -170,8 +212,8 @@ async function checkoutFeature(repoRoot: string, featureId: string, stashChanges
       branch,
       previous_branch: previous,
       stashed: Boolean(stashRef),
-      stash_ref: stashRef ?? null
-    }
+      stash_ref: stashRef ?? null,
+    },
   });
 }
 
@@ -179,8 +221,14 @@ async function restoreCheckout(repoRoot: string, featureId: string): Promise<Res
   const saved = await readRestoreRecord(repoRoot);
   if (!saved) {
     return Response.json(
-      { ok: false, error: { code: 'restore_not_available', message: 'No active dashboard checkout to restore' } },
-      { status: 404 }
+      {
+        ok: false,
+        error: {
+          code: 'restore_not_available',
+          message: 'No active dashboard checkout to restore',
+        },
+      },
+      { status: 404 },
     );
   }
 
@@ -190,10 +238,10 @@ async function restoreCheckout(repoRoot: string, featureId: string): Promise<Res
         ok: false,
         error: {
           code: 'restore_feature_mismatch',
-          message: `Active checkout belongs to ${saved.checked_out_feature_id}; restore that feature first`
-        }
+          message: `Active checkout belongs to ${saved.checked_out_feature_id}; restore that feature first`,
+        },
       },
-      { status: 409 }
+      { status: 409 },
     );
   }
 
@@ -204,10 +252,10 @@ async function restoreCheckout(repoRoot: string, featureId: string): Promise<Res
         ok: false,
         error: {
           code: 'restore_checkout_failed',
-          message: checkoutResult.stderr.trim() || 'Failed to restore previous branch'
-        }
+          message: checkoutResult.stderr.trim() || 'Failed to restore previous branch',
+        },
       },
-      { status: 409 }
+      { status: 409 },
     );
   }
 
@@ -223,10 +271,10 @@ async function restoreCheckout(repoRoot: string, featureId: string): Promise<Res
           ok: false,
           error: {
             code: 'stash_restore_failed',
-            message: apply.stderr.trim() || 'Failed to restore stashed changes'
-          }
+            message: apply.stderr.trim() || 'Failed to restore stashed changes',
+          },
         },
-        { status: 409 }
+        { status: 409 },
       );
     }
   }
@@ -238,12 +286,15 @@ async function restoreCheckout(repoRoot: string, featureId: string): Promise<Res
     data: {
       restored_to: saved.previous_branch,
       stash_restored: stashRestored,
-      stash_ref: saved.stash_ref ?? null
-    }
+      stash_ref: saved.stash_ref ?? null,
+    },
   });
 }
 
-export async function POST(req: Request, { params }: { params: { id: string } }): Promise<Response> {
+export async function POST(
+  req: Request,
+  { params }: { params: { id: string } },
+): Promise<Response> {
   const url = new URL(req.url);
   const project = url.searchParams.get('project');
   const repoRoot = await resolveProjectRoot(project);

package/packages/web-dashboard/src/app/api/features/[id]/evidence/[artifact]/route.ts

@@ -4,22 +4,25 @@ export const dynamic = 'force-dynamic';
 
 export async function GET(
   req: Request,
-  { params }: { params: { id: string; artifact: string } }
+  { params }: { params: { id: string; artifact: string } },
 ): Promise<Response> {
   const project = new URL(req.url).searchParams.get('project');
   const repoRoot = await resolveProjectRoot(project);
   const content = await readEvidenceArtifact(params.id, params.artifact, repoRoot);
   if (content == null) {
     return Response.json(
-      { ok: false, error: { code: 'artifact_not_found', message: `Artifact not found: ${params.artifact}` } },
-      { status: 404 }
+      {
+        ok: false,
+        error: { code: 'artifact_not_found', message: `Artifact not found: ${params.artifact}` },
+      },
+      { status: 404 },
     );
   }
 
   return new Response(content, {
     headers: {
       'Content-Type': params.artifact.endsWith('.json') ? 'application/json' : 'text/plain',
-      'Content-Disposition': `attachment; filename="${params.artifact}"`
-    }
+      'Content-Disposition': `attachment; filename="${params.artifact}"`,
+    },
   });
 }