@m8i-51/shoal 0.1.21 → 0.1.22

package/.env.example

@@ -19,6 +19,14 @@
 # LLM_PROVIDER=codex
 # LLM_MODEL=gpt-5.1-codex-mini          # 省略可
 
+# --- Amazon Bedrock ---
+# AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY / AWS_REGION は AWS SDK が自動で読み取ります
+# LLM_PROVIDER=bedrock
+# AWS_ACCESS_KEY_ID=
+# AWS_SECRET_ACCESS_KEY=
+# AWS_REGION=us-east-1
+# LLM_MODEL=anthropic.claude-3-5-haiku-20241022-v1:0  # 省略可 / クロスリージョン推論プロファイルも対応
+
 # --- Groq (無料枠あり・高速) ---
 # https://console.groq.com でキー取得
 # LLM_PROVIDER=groq
@@ -100,6 +108,9 @@ GITHUB_REPO=owner/repo
 MAX_EXPLORERS=4
 MAX_BROWSERS=2
 
+# 1 に設定するとキャッシュ済みの product spec を無視し product discovery を再実行します
+# REFRESH_SPEC=1
+
 # Persona templates (optional)
 # Path to a local YAML/JSON file, or an npm package name.
 # If omitted, shoal auto-discovers personas.yaml / personas.yml / personas.json in the project root.

package/README.md

@@ -119,6 +119,7 @@ Opens at `http://localhost:4000`. From there you can:
 - **Generate an Agent Diary** — after a run completes, one LLM call turns the raw log into a story-style narrative of the exploration, readable by anyone on the team
 - **Hall of Issues** — browse all findings across every run with full-text search and category filter. Export as JSON to share, or paste a community findings URL to import findings from other projects.
 - **Edit app goals** — guide the goal-gap detector by defining what the app should achieve
+- **Schedule a weekly run** — pick a day and time directly in the dashboard for automatic recurring runs (the `shoal serve` process must stay running; for a serverless alternative see [Scheduled runs](#scheduled-runs) below)
 
 ---
 
@@ -246,6 +247,8 @@ shoal defaults to Anthropic Claude. To use a different provider, set these varia
 | Amazon Bedrock | `LLM_PROVIDER=bedrock`, `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_REGION` |
 | OpenAI | `LLM_PROVIDER=openai`, `LLM_API_KEY`, `LLM_MODEL` |
 | OpenRouter | `LLM_PROVIDER=openrouter`, `LLM_API_KEY`, `LLM_MODEL` |
+| Groq | `LLM_PROVIDER=groq`, `LLM_API_KEY`, `LLM_MODEL` |
+| Gemini | `LLM_PROVIDER=gemini`, `LLM_API_KEY`, `LLM_MODEL` |
 | Codex (ChatGPT subscription) | run `npm run auth:codex` once, then `LLM_PROVIDER=codex` |
 | Ollama | `LLM_BASE_URL=http://localhost:11434/v1`, `LLM_MODEL` |
 | LM Studio | `LLM_BASE_URL=http://localhost:1234/v1`, `LLM_MODEL` |

package/framework/coverage.ts

@@ -1,6 +1,6 @@
 import * as fs from "fs";
 import * as path from "path";
-import type { Finding } from "./types";
+import { isFinding, type Finding } from "./types";
 import type { Scenario } from "./scenario-designer";
 
 export interface RunCoverage {
@@ -233,8 +233,8 @@ export function getFindingHotspots(topN = 12): FindingHotspot[] {
       for (const file of fs.readdirSync(dir)) {
         if (!file.endsWith(".json") || file === "triage_result.json") continue;
         try {
-          const f: Finding = JSON.parse(fs.readFileSync(path.join(dir, file), "utf-8"));
-          if (typeof f.category !== "string") continue;
+          const f: unknown = JSON.parse(fs.readFileSync(path.join(dir, file), "utf-8"));
+          if (!isFinding(f)) continue;
           const p = extractPath(f);
           const entry = counts.get(p) ?? { total: 0, categories: {} };
           entry.total++;

package/framework/diary.ts

@@ -1,7 +1,7 @@
 import * as fs from "fs";
 import * as path from "path";
 import { createLLMClient } from "./llm-client.js";
-import type { Finding } from "./types.js";
+import { isFinding, type Finding } from "./types.js";
 
 function loadFindings(runId: string): Finding[] {
   const dir = path.join(process.cwd(), "findings", runId);
@@ -10,8 +10,8 @@ function loadFindings(runId: string): Finding[] {
   for (const file of fs.readdirSync(dir)) {
     if (!file.endsWith(".json") || file === "triage_result.json") continue;
     try {
-      const f: Finding = JSON.parse(fs.readFileSync(path.join(dir, file), "utf-8"));
-      if (typeof f.timestamp !== "string") continue;
+      const f: unknown = JSON.parse(fs.readFileSync(path.join(dir, file), "utf-8"));
+      if (!isFinding(f)) continue;
       out.push(f);
     } catch { /* skip */ }
   }

package/framework/llm-client.ts

@@ -200,7 +200,10 @@ class OpenAICompatClient {
   private defaultModel: string;
 
   constructor(apiKey: string, baseURL?: string, defaultModel?: string) {
-    this.client = new OpenAI({ apiKey, baseURL });
+    // ローカルプロバイダ（Ollama/LM Studio）は空のキーで使われることがある。
+    // openai SDK は空文字列のキーをコンストラクタで拒否するバージョンがあるため、
+    // ダミー値で代替する（API互換エンドポイント側はキーを検証しない）。
+    this.client = new OpenAI({ apiKey: apiKey || "not-needed", baseURL });
     this.defaultModel = defaultModel ?? "gpt-4o-mini";
   }
 

package/framework/types.ts

@@ -25,6 +25,17 @@ export interface Finding {
   screenshotPath?: string;
 }
 
+/**
+ * findings/run_<id>/ ディレクトリには各 finding の JSON と並んで
+ * triage_result.json（集計ファイル、Finding ではない）が置かれる。
+ * 読み込んだ JSON が実際に Finding かどうかをここで一括判定する。
+ */
+export function isFinding(v: unknown): v is Finding {
+  if (typeof v !== "object" || v === null) return false;
+  const o = v as Record<string, unknown>;
+  return typeof o.id === "string" && typeof o.category === "string" && typeof o.timestamp === "string";
+}
+
 export interface RegressionCheck {
   issueNumber: number;
   issueTitle: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m8i-51/shoal",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "type": "module",
   "description": "Multi-agent web exploration framework — finds bugs, UX issues, and missing features by running AI agents against your app",
   "repository": {
@@ -18,7 +18,8 @@
     "web/dist/",
     "run.ts",
     "triage-only.ts",
-    ".env.example"
+    ".env.example",
+    "!**/__tests__/**"
   ],
   "scripts": {
     "prepublishOnly": "npm run build:web",
@@ -31,7 +32,8 @@
     "build:web": "vite build web",
     "auth:codex": "tsx scripts/auth-codex.ts",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
     "@anthropic-ai/bedrock-sdk": "^0.29.1",

package/server/index.ts

@@ -9,7 +9,7 @@ import { activeSessions, spawnRun, cancelSession } from "./runner.js";
 import { loadSchedule, saveSchedule, startScheduler, type ScheduleConfig } from "./scheduler.js";
 import { generateDiary, getDiaryPath } from "../framework/diary.js";
 import { findCrossRunDuplicates } from "../framework/cross-run-dedup.js";
-import type { Finding } from "../framework/types.js";
+import { isFinding, type Finding } from "../framework/types.js";
 
 function specFilePath(baseUrl: string): string {
   try {
@@ -144,8 +144,8 @@ function loadAllFindings(): (Finding & { runId: string })[] {
       for (const file of readdirSync(dir)) {
         if (!file.endsWith(".json") || file === "triage_result.json") continue;
         try {
-          const f: Finding = JSON.parse(readFileSync(join(dir, file), "utf-8"));
-          if (typeof f.timestamp !== "string") continue;
+          const f: unknown = JSON.parse(readFileSync(join(dir, file), "utf-8"));
+          if (!isFinding(f)) continue;
           all.push({ ...f, runId: runDir });
         } catch { /* skip */ }
       }

package/server/runs.ts

@@ -1,6 +1,6 @@
 import * as fs from "fs";
 import * as path from "path";
-import type { RunLog, Finding } from "../framework/types";
+import { isFinding, type RunLog } from "../framework/types";
 
 export interface RunSummary {
   runId: string;
@@ -27,8 +27,8 @@ function countFindings(runId: string): { total: number; byCategory: Record<strin
   for (const file of fs.readdirSync(dir)) {
     if (!file.endsWith(".json") || file === "triage_result.json") continue;
     try {
-      const f: Finding = JSON.parse(fs.readFileSync(path.join(dir, file), "utf-8"));
-      if (typeof f.category !== "string") continue;
+      const f: unknown = JSON.parse(fs.readFileSync(path.join(dir, file), "utf-8"));
+      if (!isFinding(f)) continue;
       byCategory[f.category] = (byCategory[f.category] ?? 0) + 1;
       total++;
     } catch {