@tea-agent/loop-agent 0.35.0-beta.2 → 0.35.1-beta.0

package/docs/templates/worker-dogfood-setup.md

@@ -1,68 +1,68 @@
-# Worker Dogfood Setup Template
-
-Use this template to create a disposable target repository for a real `agent-worker` sample. It is deliberately a target-repo recipe, not a substitute for product requirements.
-
-## Preconditions
-
-- Install one published controller version and record it:
-
-  ```bash
-  npm install -g @tea-agent/loop-agent@<version>
-  npm list -g @tea-agent/loop-agent --depth=0
-  loop-agent --version
-  agent-worker --version
-  agent-worker --help
-  ```
-
-- Before any write-capable Worker command, resolve one controller identity for the batch. Record its package version, absolute launch entry, binary SHA-256, and portable package fingerprint. If the run is part of a release or self-hosting train, carry the expected version/fingerprint as explicit CLI gates.
-- Create a clean, disposable target repository. Do not use `npm link`, `npm run dev`, or a workspace controller for a real-evidence run.
-- Put requirement, acceptance, design, test plan, and QA case matrix next to the TaskSpec. `agent-worker` materializes immutable copies into the harness task source before DAG generation.
-
-## Setup checklist
-
-- [ ] Target has a committed baseline and a passing `loop-agent init --profile full --merge` preflight.
-- [ ] Existing test demonstrates the desired behavior is missing or unimplemented.
-- [ ] TaskSpec has narrow `allowed_paths` and explicit `forbidden_paths`.
-- [ ] Task Pool dependencies are either backed by real prior runs or intentionally recorded as pre-existing evidence.
-- [ ] The chosen model/provider and `--pi-model` smoke override, if any, are recorded.
-- [ ] `--loop-agent-bin` resolves to the intended published package, and expected controller version/fingerprint are recorded before target writes.
-- [ ] If this is a self-hosting run, published N remains fixed for the whole batch; candidate N+1 is installed and verified in a separate slot.
-
-## Execute
-
-```bash
-agent-worker batch run-ready \
-  --feature-dir <feature-dir> \
-  --repo <target-repo> \
-  --loop-agent-bin <published-loop-agent-entry> \
-  --expected-controller-version <version> \
-  --expected-controller-fingerprint <sha256:value> \
-  --limit 1 \
-  --check-repo \
-  [--pi-model <model>]
-
-agent-worker observe snapshot --repo <target-repo> > <evidence-dir>/observe-snapshot.json
-agent-worker report morning --repo <target-repo> --output <evidence-dir>/morning-report.md
-```
-
-For a failed task, do not delete state or alter JSONL evidence. Fix the external/root cause, then make the retry explicit:
-
-```bash
-agent-worker task retry <task-id> --repo <target-repo> --reason "<root cause corrected>"
-agent-worker batch run-ready --feature-dir <feature-dir> --repo <target-repo> --limit 1 --check-repo
-```
-
-The retry run must have a distinct `workerRunId` and retain `retryOfWorkerRunId` in its Task Pool evidence.
-
-## Versioned self-hosting takeover
-
-From a source checkout, use the repo-maintainer deterministic canary after building or packing candidate N+1:
-
-```bash
-npm run self-host:canary -- \
-  --deterministic \
-  --tarball <candidate.tgz> \
-  --output <candidate-canary-evidence.json>
-```
-
-The deterministic canary must prove isolated-slot containment, both candidate bin identities, package fingerprint, full init/governance checks, a zero-execution Feature dry-run, static/shell-only observed DAG executors, and no PATH controller fallback. It does not claim to trap every possible Pi SDK/absolute path and does not replace a separately authorized live Pi run or the DAG skill-snapshot tests.
+# Worker Dogfood Setup Template
+
+Use this template to create a disposable target repository for a real `agent-worker` sample. It is deliberately a target-repo recipe, not a substitute for product requirements.
+
+## Preconditions
+
+- Install one published controller version and record it:
+
+  ```bash
+  npm install -g @tea-agent/loop-agent@<version>
+  npm list -g @tea-agent/loop-agent --depth=0
+  loop-agent --version
+  agent-worker --version
+  agent-worker --help
+  ```
+
+- Before any write-capable Worker command, resolve one controller identity for the batch. Record its package version, absolute launch entry, binary SHA-256, and portable package fingerprint. If the run is part of a release or self-hosting train, carry the expected version/fingerprint as explicit CLI gates.
+- Create a clean, disposable target repository. Do not use `npm link`, `npm run dev`, or a workspace controller for a real-evidence run.
+- Put requirement, acceptance, design, test plan, and QA case matrix next to the TaskSpec. `agent-worker` materializes immutable copies into the harness task source before DAG generation.
+
+## Setup checklist
+
+- [ ] Target has a committed baseline and a passing `loop-agent init --profile full --merge` preflight.
+- [ ] Existing test demonstrates the desired behavior is missing or unimplemented.
+- [ ] TaskSpec has narrow `allowed_paths` and explicit `forbidden_paths`.
+- [ ] Task Pool dependencies are either backed by real prior runs or intentionally recorded as pre-existing evidence.
+- [ ] The chosen model/provider and `--pi-model` smoke override, if any, are recorded.
+- [ ] `--loop-agent-bin` resolves to the intended published package, and expected controller version/fingerprint are recorded before target writes.
+- [ ] If this is a self-hosting run, published N remains fixed for the whole batch; candidate N+1 is installed and verified in a separate slot.
+
+## Execute
+
+```bash
+agent-worker batch run-ready \
+  --feature-dir <feature-dir> \
+  --repo <target-repo> \
+  --loop-agent-bin <published-loop-agent-entry> \
+  --expected-controller-version <version> \
+  --expected-controller-fingerprint <sha256:value> \
+  --limit 1 \
+  --check-repo \
+  [--pi-model <model>]
+
+agent-worker observe snapshot --repo <target-repo> > <evidence-dir>/observe-snapshot.json
+agent-worker report morning --repo <target-repo> --output <evidence-dir>/morning-report.md
+```
+
+For a failed task, do not delete state or alter JSONL evidence. Fix the external/root cause, then make the retry explicit:
+
+```bash
+agent-worker task retry <task-id> --repo <target-repo> --reason "<root cause corrected>"
+agent-worker batch run-ready --feature-dir <feature-dir> --repo <target-repo> --limit 1 --check-repo
+```
+
+The retry run must have a distinct `workerRunId` and retain `retryOfWorkerRunId` in its Task Pool evidence.
+
+## Versioned self-hosting takeover
+
+From a source checkout, use the repo-maintainer deterministic canary after building or packing candidate N+1:
+
+```bash
+npm run self-host:canary -- \
+  --deterministic \
+  --tarball <candidate.tgz> \
+  --output <candidate-canary-evidence.json>
+```
+
+The deterministic canary must prove isolated-slot containment, both candidate bin identities, package fingerprint, full init/governance checks, a zero-execution Feature dry-run, static/shell-only observed DAG executors, and no PATH controller fallback. It does not claim to trap every possible Pi SDK/absolute path and does not replace a separately authorized live Pi run or the DAG skill-snapshot tests.

package/harness.json

@@ -79,9 +79,12 @@
   },
   "executors": {
     "pi": {
-      "description": "Pi 负责规划、评审、诊断；当 DAG toolProfile=write 时也可做有界写入。模型按复杂度三档配置，格式为 provider/model 字符串（例：wizard-local/grok-4.5）；斜杠前为 Pi provider，后为 modelId，勿只写裸 modelId。",
+      "description": "Pi 负责规划、评审、诊断；当 DAG toolProfile=write 时也可做有界写入。模型按复杂度三档配置，支持 provider/model 字符串或带 thinking 的对象；斜杠前为 Pi provider，后为 modelId，勿只写裸 modelId。",
       "LOW": "wizard-local/minimax-m3",
-      "MED": "wizard-local/grok-4.5",
+      "MED": {
+        "model": "wizard-local/deepseek-v4-flash",
+        "thinking": "max"
+      },
       "HIGH": "wizard-local/gpt-5.6-sol"
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tea-agent/loop-agent",
-  "version": "0.35.0-beta.2",
+  "version": "0.35.1-beta.0",
   "type": "module",
   "bin": {
     "loop-agent": "bin/loop-agent.js",

package/scripts/kb-graph-materialize.mjs

@@ -1,105 +1,105 @@
-#!/usr/bin/env node
-/**
- * Standalone B6-ish materialize: rebuild knowledge/graph/entities-index.yaml
- * and edges.yaml from formal trees + edges.manual.yaml.
- */
-import fs from "node:fs";
-import path from "node:path";
-import process from "node:process";
-
-function parseArgs(argv) {
-	let root = process.cwd();
-	for (let i = 0; i < argv.length; i++) {
-		if (argv[i] === "--root") root = path.resolve(argv[++i]);
-		else if (argv[i] === "-h" || argv[i] === "--help") {
-			console.log("Usage: node scripts/kb-graph-materialize.mjs [--root <dir>]");
-			process.exit(0);
-		}
-	}
-	return { root };
-}
-
-function walk(dir, acc = []) {
-	if (!fs.existsSync(dir)) return acc;
-	for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
-		const p = path.join(dir, ent.name);
-		if (ent.isDirectory()) walk(p, acc);
-		else acc.push(p);
-	}
-	return acc;
-}
-
-function main() {
-	const { root } = parseArgs(process.argv.slice(2));
-	const entities = [];
-	for (const base of ["knowledge/domains", "knowledge/services", "knowledge/modules"]) {
-		for (const f of walk(path.join(root, base))) {
-			if (!f.endsWith("meta.yaml") && !f.endsWith("meta.yml")) continue;
-			const rel = path.relative(root, f).split(path.sep).join("/");
-			const text = fs.readFileSync(f, "utf8");
-			const id = (text.match(/^id:\s*(\S+)/m) || [])[1];
-			const kind = (text.match(/^kind:\s*(\S+)/m) || [])[1] || "unknown";
-			if (id) entities.push({ kind, id, path: rel });
-		}
-	}
-	const featRoot = path.join(root, "features");
-	if (fs.existsSync(featRoot)) {
-		for (const name of fs.readdirSync(featRoot)) {
-			if (!/^F-/.test(name)) continue;
-			const dir = path.join(featRoot, name);
-			if (!fs.statSync(dir).isDirectory()) continue;
-			entities.push({ kind: "feature", id: name, path: `features/${name}/` });
-			const links = path.join(dir, "knowledge-links.yaml");
-			if (fs.existsSync(links)) {
-				entities.push({
-					kind: "knowledge-links",
-					id: `${name}:links`,
-					path: `features/${name}/knowledge-links.yaml`,
-				});
-			}
-		}
-	}
-
-	const graphDir = path.join(root, "knowledge/graph");
-	fs.mkdirSync(graphDir, { recursive: true });
-	const generatedAt = new Date().toISOString();
-	const indexBody = [
-		"# generated by kb-graph-materialize",
-		"schema_version: 1",
-		`generated_at: ${generatedAt}`,
-		"entities:",
-		...entities.flatMap((e) => [
-			`  - kind: ${e.kind}`,
-			`    id: ${e.id}`,
-			`    path: ${e.path}`,
-		]),
-		"",
-	].join("\n");
-	fs.writeFileSync(path.join(graphDir, "entities-index.yaml"), indexBody);
-
-	const manual = path.join(graphDir, "edges.manual.yaml");
-	const edgesOut = path.join(graphDir, "edges.yaml");
-	if (fs.existsSync(manual)) {
-		fs.copyFileSync(manual, edgesOut);
-	} else if (!fs.existsSync(edgesOut)) {
-		fs.writeFileSync(
-			edgesOut,
-			`schema_version: 1\nupdated_at: ${generatedAt}\nedges: []\n`,
-		);
-	}
-
-	console.log(
-		JSON.stringify(
-			{
-				ok: true,
-				entities: entities.length,
-				entities_index: "knowledge/graph/entities-index.yaml",
-				edges: "knowledge/graph/edges.yaml",
-			},
-			null,
-			2,
-		),
-	);
-}
-
-main();
+#!/usr/bin/env node
+/**
+ * Standalone B6-ish materialize: rebuild knowledge/graph/entities-index.yaml
+ * and edges.yaml from formal trees + edges.manual.yaml.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import process from "node:process";
+
+function parseArgs(argv) {
+	let root = process.cwd();
+	for (let i = 0; i < argv.length; i++) {
+		if (argv[i] === "--root") root = path.resolve(argv[++i]);
+		else if (argv[i] === "-h" || argv[i] === "--help") {
+			console.log("Usage: node scripts/kb-graph-materialize.mjs [--root <dir>]");
+			process.exit(0);
+		}
+	}
+	return { root };
+}
+
+function walk(dir, acc = []) {
+	if (!fs.existsSync(dir)) return acc;
+	for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
+		const p = path.join(dir, ent.name);
+		if (ent.isDirectory()) walk(p, acc);
+		else acc.push(p);
+	}
+	return acc;
+}
+
+function main() {
+	const { root } = parseArgs(process.argv.slice(2));
+	const entities = [];
+	for (const base of ["knowledge/domains", "knowledge/services", "knowledge/modules"]) {
+		for (const f of walk(path.join(root, base))) {
+			if (!f.endsWith("meta.yaml") && !f.endsWith("meta.yml")) continue;
+			const rel = path.relative(root, f).split(path.sep).join("/");
+			const text = fs.readFileSync(f, "utf8");
+			const id = (text.match(/^id:\s*(\S+)/m) || [])[1];
+			const kind = (text.match(/^kind:\s*(\S+)/m) || [])[1] || "unknown";
+			if (id) entities.push({ kind, id, path: rel });
+		}
+	}
+	const featRoot = path.join(root, "features");
+	if (fs.existsSync(featRoot)) {
+		for (const name of fs.readdirSync(featRoot)) {
+			if (!/^F-/.test(name)) continue;
+			const dir = path.join(featRoot, name);
+			if (!fs.statSync(dir).isDirectory()) continue;
+			entities.push({ kind: "feature", id: name, path: `features/${name}/` });
+			const links = path.join(dir, "knowledge-links.yaml");
+			if (fs.existsSync(links)) {
+				entities.push({
+					kind: "knowledge-links",
+					id: `${name}:links`,
+					path: `features/${name}/knowledge-links.yaml`,
+				});
+			}
+		}
+	}
+
+	const graphDir = path.join(root, "knowledge/graph");
+	fs.mkdirSync(graphDir, { recursive: true });
+	const generatedAt = new Date().toISOString();
+	const indexBody = [
+		"# generated by kb-graph-materialize",
+		"schema_version: 1",
+		`generated_at: ${generatedAt}`,
+		"entities:",
+		...entities.flatMap((e) => [
+			`  - kind: ${e.kind}`,
+			`    id: ${e.id}`,
+			`    path: ${e.path}`,
+		]),
+		"",
+	].join("\n");
+	fs.writeFileSync(path.join(graphDir, "entities-index.yaml"), indexBody);
+
+	const manual = path.join(graphDir, "edges.manual.yaml");
+	const edgesOut = path.join(graphDir, "edges.yaml");
+	if (fs.existsSync(manual)) {
+		fs.copyFileSync(manual, edgesOut);
+	} else if (!fs.existsSync(edgesOut)) {
+		fs.writeFileSync(
+			edgesOut,
+			`schema_version: 1\nupdated_at: ${generatedAt}\nedges: []\n`,
+		);
+	}
+
+	console.log(
+		JSON.stringify(
+			{
+				ok: true,
+				entities: entities.length,
+				entities_index: "knowledge/graph/entities-index.yaml",
+				edges: "knowledge/graph/edges.yaml",
+			},
+			null,
+			2,
+		),
+	);
+}
+
+main();