@tea-agent/loop-agent 0.13.0-beta.0 → 0.14.0

package/dist/workflows/dag/repair-artifact.js

@@ -13,12 +13,51 @@ export const repairArtifactSchema = z.object({
     schemaVersion: z.literal(1),
     verdict: z.enum(["pass", "request-revision"]),
     failureClass: repairFailureClassSchema,
-    rootCause: z.string().min(1),
+    rootCause: z
+        .string()
+        .min(1, { message: 'repair artifact field "rootCause" must be a non-empty string' }),
     fixScope: z.array(z.string().min(1)).default([]),
     invariant: z.string().min(1),
     evidenceRefs: z.array(z.string().min(1)).default([]),
     rawLogFallbackAllowed: z.boolean().default(false),
 });
+/**
+ * Canonical rootCause substituted when a `verdict: "pass"` repair artifact
+ * arrives with an empty or whitespace-only rootCause. Keeps the persisted
+ * RepairArtifact schema-valid without weakening request-revision diagnostics.
+ */
+export const PASS_VERDICT_DEFAULT_ROOT_CAUSE = "No repair required.";
+/**
+ * Normalize model-emitted repair artifacts deterministically at the parser
+ * boundary: a `verdict: "pass"` artifact with an empty/whitespace-only
+ * rootCause is rewritten to the canonical default so it still satisfies the
+ * strict schema. request-revision and other fields are left untouched so the
+ * strict diagnostics and write boundaries remain fail-closed.
+ */
+function normalizePassArtifactRootCause(parsed) {
+    if (parsed &&
+        typeof parsed === "object" &&
+        !Array.isArray(parsed) &&
+        parsed.verdict === "pass") {
+        const record = parsed;
+        const rootCause = record.rootCause;
+        if (typeof rootCause === "string" && rootCause.trim().length === 0) {
+            return { ...record, rootCause: PASS_VERDICT_DEFAULT_ROOT_CAUSE };
+        }
+    }
+    return parsed;
+}
+/**
+ * Render a single Zod issue as a field-path-aware message so callers can locate
+ * invalid repair-artifact fields instead of seeing bare min-length text.
+ */
+function describeZodIssue(issue) {
+    const path = issue.path && issue.path.length > 0 ? issue.path.join(".") : "(root)";
+    if (issue.message && !/^String must contain/.test(issue.message)) {
+        return `field "${path}": ${issue.message} (code ${issue.code})`;
+    }
+    return `field "${path}" is invalid (code ${issue.code})`;
+}
 const REPAIR_ARTIFACT_FENCE = /```(?:REPAIR_ARTIFACT_JSON|json)\s*([\s\S]*?)```/gi;
 function extractCandidateJsonBlocks(text) {
     const blocks = [];
@@ -42,11 +81,12 @@ export function parseRepairArtifactFromText(text) {
     for (const candidate of candidates) {
         try {
             const parsed = JSON.parse(candidate);
-            const result = repairArtifactSchema.safeParse(parsed);
+            const normalized = normalizePassArtifactRootCause(parsed);
+            const result = repairArtifactSchema.safeParse(normalized);
             if (result.success) {
                 return { ok: true, artifact: result.data };
             }
-            errors.push(result.error.issues.map((issue) => issue.message).join(", "));
+            errors.push(result.error.issues.map((issue) => describeZodIssue(issue)).join(", "));
         }
         catch (error) {
             errors.push(error instanceof Error ? error.message : String(error));

package/dist/workflows/dag/skill-instructions.js

@@ -3,8 +3,8 @@ import { access, readFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-export const DEFAULT_SKILL_INSTRUCTION_MAX_CHARS = 2_500;
-export const DEFAULT_SKILL_INSTRUCTION_TOTAL_MAX_CHARS = 10_000;
+export const DEFAULT_SKILL_INSTRUCTION_MAX_CHARS = 3_000;
+export const DEFAULT_SKILL_INSTRUCTION_TOTAL_MAX_CHARS = 12_000;
 const SKILL_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
 async function fileExists(filePath) {
     try {
@@ -413,7 +413,9 @@ async function findFirstExistingFile(candidates) {
 async function resolveLearnedPatternInstructions(input) {
     const repoSlug = path.basename(input.cwd).replace(/[^A-Za-z0-9_-]+/g, "-");
     const candidates = [
+        normalizeCandidate(path.join(input.cwd, ".agents", "skills", "loop-agent", "references", "learned", `${repoSlug}.md`)),
         normalizeCandidate(path.join(input.cwd, "skills", "loop-agent", "references", "learned", `${repoSlug}.md`)),
+        normalizeCandidate(path.join(input.cwd, ".agents", "skills", "loop-agent", "references", "learned", "default.md")),
         normalizeCandidate(path.join(input.cwd, "skills", "loop-agent", "references", "learned", "default.md")),
         normalizeCandidate(path.join(input.cwd, "tools", "loop-agent", "skill", "references", "learned", `${repoSlug}.md`)),
         normalizeCandidate(path.join(input.cwd, "tools", "loop-agent", "skill", "references", "learned", "default.md")),

package/dist/workflows/dag/types.js

@@ -63,13 +63,26 @@ export const dagVerdictGateSchema = z.object({
     label: z.string().min(1).optional(),
 });
 export const dagRequirementCoverageGateSchema = z.object({
-    fromNodeIds: z.array(z.string().regex(/^[a-z][a-z0-9-]*$/, "fromNodeIds must be kebab-case")).min(1),
-    requiredIds: z.array(z.string().regex(/^(?:REQ|BR|AC)-[A-Z0-9]+(?:-[A-Z0-9]+)*$/, "requiredIds must use REQ-*, BR-*, or AC-* identifiers")).min(1),
+    fromNodeIds: z
+        .array(z.string().regex(/^[a-z][a-z0-9-]*$/, "fromNodeIds must be kebab-case"))
+        .min(1),
+    requiredIds: z
+        .array(z
+        .string()
+        .regex(/^(?:REQ|BR|AC)-[A-Z0-9]+(?:-[A-Z0-9]+)*$/, "requiredIds must use REQ-*, BR-*, or AC-* identifiers"))
+        .min(1),
     label: z.string().min(1).optional(),
 });
+export const dagJsonArtifactSchemaIdSchema = z.enum([
+    "backend-test-analysis-v1",
+    "backend-test-execution-v1",
+    "backend-test-result-v1",
+    "backend-test-case-manifest-v1",
+    "frontend-implementation-contract-v1",
+]);
 export const dagJsonArtifactGateSchema = z.object({
     fromNodeId: z.string().regex(/^[a-z][a-z0-9-]*$/),
-    schemaId: z.literal("backend-test-analysis-v1"),
+    schemaId: dagJsonArtifactSchemaIdSchema,
     artifactName: z.string().regex(/^[a-z0-9][a-z0-9._-]*\.json$/),
     outputDir: z.string().regex(/^[a-z0-9][a-z0-9._-]*$/),
 });
@@ -117,6 +130,8 @@ export const dagShellConfigSchema = z.object({
     jsonArtifactGate: dagJsonArtifactGateSchema.optional(),
     verifyEvidence: dagShellVerifyEvidenceSchema.optional(),
     repairArtifactGate: dagRepairArtifactGateSchema.optional(),
+    /** fail (default): any nonzero command fails the node. record: finish node FINISHED with failure facts for downstream assess/repair. */
+    nonZeroExitPolicy: z.enum(["fail", "record"]).optional(),
     envAllowlist: z.array(z.string()).optional(),
     timeoutMs: z.number().optional(),
     cwd: z.string().optional(),
@@ -153,10 +168,12 @@ export const dagDynamicExpansionSchema = z.object({
         .string()
         .regex(/^[a-z][a-z0-9-]*$/, "childIdPrefix must be kebab-case"),
     childTask: dagDynamicExpansionChildTaskSchema,
-    tokenBudget: z.object({
+    tokenBudget: z
+        .object({
         maxTokensPerCase: z.number().int().positive().optional(),
         maxTotalTokens: z.number().int().positive().optional(),
-    }).optional(),
+    })
+        .optional(),
 });
 export const dagDynamicReductionSchema = z.object({
     type: z.literal("verified_findings_report"),
@@ -286,11 +303,15 @@ export const dagEvaluationBindingSchema = z
 export const dagSourceBindingSchema = z.object({
     schemaVersion: z.literal(1),
     taskId: z.string().min(1),
-    sources: z.array(z.object({
+    sources: z
+        .array(z.object({
         kind: z.enum(["requirement", "constraint", "reference"]),
         path: z.string().min(1),
-        sha256: z.string().regex(/^[a-f0-9]{64}$/, "sha256 must be lowercase hex"),
-    })).min(1),
+        sha256: z
+            .string()
+            .regex(/^[a-f0-9]{64}$/, "sha256 must be lowercase hex"),
+    }))
+        .min(1),
     requirementIds: z.array(z.string().regex(/^(?:REQ|BR|AC)-[A-Z0-9]+(?:-[A-Z0-9]+)*$/)),
 });
 export const dagSpecSchema = z

package/docs/README.md

@@ -34,6 +34,7 @@
 
 完整列表见 `exec-plans/completed/README.md`。近期高频入口：
 
+- `exec-plans/completed/2026-07-18-observe-ops-surface-and-rich-timeline.md` — Observe 运营面/执行面重排、检查器半屏与富执行过程
 - `exec-plans/completed/2026-07-14-website-docs-ia-and-converge.md` — Website IA、双树边界与 docs-converge
 - `exec-plans/completed/2026-07-13-versioned-self-hosting-bootstrap.md` — 版本化自举与 candidate canary
 - `exec-plans/completed/2026-07-12-pi-only-agent-runtime.md` — Pi-only 受治理 runtime
@@ -82,6 +83,7 @@
 - `templates/product-line/` — 可投影的 Feature/Task/QA/Links 产品线包；配合 `agent-worker task validate-feature` 做 docs CI
 - `templates/production-readiness-checklist.md` — 低/中风险单仓库 DAG readiness 检查清单
 - `templates/init-evolution-review.md` — 初始化能力演化审查报告模板
+- `templates/branch-merge-report.md` — 跨分支合并的功能保留、冲突解析、init/update 与 package surface 审计模板
 - `templates/adr.md` — 架构决策记录（ADR）
 
 ## 维护

package/docs/agent-dag-recovery-playbook.md

@@ -17,7 +17,7 @@ product_line_failure_category
 recommended_follow_up
 ```
 
-Product-line taxonomy 定义见 `docs/design/state-and-failure-taxonomy.md`。
+Product-line taxonomy 定义见 `ai_workspace/loop-agent/design/state-and-failure-taxonomy.md`。
 
 ### 前端设计门禁专用恢复路径
 
@@ -82,7 +82,7 @@ Decision Gate prompt 侧：`buildDagDecisionGateEvidence()`（`./src/core/dag-de
 
 ## `dag report --json` schema 锁定
 
-- **Schema 文件**：`docs/templates/agent-dag-report.schema.json`
+- **Schema 文件**：`ai_workspace/loop-agent/templates/agent-dag-report.schema.json`
 - **Envelope**：`{ schemaVersion: 1, runs: DagRunReportEntry[] }`
 - **稳定消费字段**（Decision Gate / tooling 应依赖）：`primaryFailure`、`primaryRecovery`、`downstreamSkippedNodes`、`recoveryRecommendation`、`normalizedFailureCategory`；node 级 `decisionEnvelope`、`artifacts`；paused 级 `pausedByNodeId`、`pauseReason`
 - **测试**：`./test/dag-report.test.ts` §`dag report JSON schema contract` 对 fixture run 做 schema 校验
@@ -146,7 +146,7 @@ Decision Gate prompt 侧：`buildDagDecisionGateEvidence()`（`./src/core/dag-de
 3. **Blocked Downstream / Skipped Nodes** — `downstreamSkippedNodes`
 4. **Recommended Operator Action** — 面向 operator 的步骤摘要
 
-保存 handoff 时重定向到平台临时目录或 `docs/reports/`，不要写入 `.harness/dag-runs/`。
+保存 handoff 时重定向到平台临时目录或 `ai_workspace/loop-agent/reports/`，不要写入 `.harness/dag-runs/`。
 
 ## Decision Gate 消费约定
 

package/docs/agent-dag-runner.md

@@ -46,11 +46,11 @@ planner/scout/reviewer/verifier/closeout 角色的只读 Pi 节点可声明 opt-
 
 ## Skills
 
-DAG spec 可声明 `defaults.skills`、`skillsByRole` 与节点级 `skills`。Runner 优先从目标项目 `.agents/skills/<skill-name>/SKILL.md` 解析本地指令，再回退到包内 `skills/`，并在各节点 `skills.json` artifact 中记录解析元数据。
+DAG spec 可声明 `defaults.skills`、`skillsByRole` 与节点级 `skills`。Runner 优先从目标项目 `.agents/skills/<skill-name>/SKILL.md` 解析本地指令，再回退到包内 `.agents/skills/`，并在各节点 `skills.json` artifact 中记录解析元数据。
 
-执行前可用 `dag validate --strict-skills` 做 opt-in skill audit；该门禁会在 missing/error/truncated skill 或 unresolved reference 出现时失败。默认 role skill 应来自 `docs/skills/vetted-skill-registry.md` 中记录的 repo-local wrapper。
+执行前可用 `dag validate --strict-skills` 做 opt-in skill audit；该门禁会在 missing/error/truncated skill 或 unresolved reference 出现时失败。默认 role skill 应来自 `ai_workspace/loop-agent/.agents/skills/vetted-skill-registry.md` 中记录的 repo-local wrapper。
 
-目标项目的 `loop-agent` skill 位于 `.agents/skills/loop-agent/SKILL.md`。loop-agent 源仓库和 npm 包内置版本仍位于 `skills/loop-agent/SKILL.md`；遗留根路径 `skill/SKILL.md` 仅为旧 worktree 保留兼容 fallback。
+目标项目的 `loop-agent` skill 位于 `.agents/skills/loop-agent/SKILL.md`。loop-agent 源仓库和 npm 包内置版本仍位于 `.agents/skills/loop-agent/SKILL.md`；遗留根路径 `skill/SKILL.md` 仅为旧 worktree 保留兼容 fallback。
 
 ## Artifacts
 

package/docs/architecture/README.md

@@ -15,12 +15,12 @@
 
 ## 事实与规划的区分
 
-- **当前事实源**：`src/` 源码、发布 CLI、`docs/exec-plans/completed/`、`docs/reports/current-capability-summary.md`、ADR 0001–0003。
-- **规划/设计输入**：`docs/design/`（含 `dynamic-workflow-dag-engine-roadmap.md`、`六个月规划.md`）。这些文件已带 2026-07-14 校准条；凡未兑现的 phase 段落是设计输入，**不是**已实现证明。
+- **当前事实源**：`src/` 源码、发布 CLI、`ai_workspace/loop-agent/exec-plans/completed/`、`ai_workspace/loop-agent/reports/current-capability-summary.md`、ADR 0001–0003。
+- **规划/设计输入**：`ai_workspace/loop-agent/design/`（含 `dynamic-workflow-dag-engine-roadmap.md`、`六个月规划.md`）。这些文件已带 2026-07-14 校准条；凡未兑现的 phase 段落是设计输入，**不是**已实现证明。
 - 凡本目录文档描述未来能力，一律使用「规划 / 未实现 / 前瞻」标签。
 
 ## 与其他文档的分工
 
 - 本目录不复制 `runtime-boundaries.md` 的 import 方向表、governance-hook 表与版本化自举边界表，只交叉引用。
 - 用法与操作说明在 `website/docs/`（使用者双树），不在本目录重复。
-- 本目录文档随发布包发布（npm `files` 显式条目 + `docs/init-surface.manifest.json` `packageRequired`），但 **不**投影到目标项目 init surface；目标项目 init 仍只投影语言无关的 `runtime-boundaries.md`。
+- 本目录文档随发布包发布（npm `files` 显式条目 + `ai_workspace/loop-agent/init-surface.manifest.json` `packageRequired`），但 **不**投影到目标项目 init surface；目标项目 init 仍只投影语言无关的 `runtime-boundaries.md`。

package/docs/architecture/dag-execution.md

@@ -137,4 +137,4 @@ WorkflowSpec (src/workflows/dynamic/spec.ts workflowSpecSchema)
 
 - 动态语义：`map_agent` / `verify_agent` / `reduce_agent` / `condition` / `loop_until` / `human_gate` / `command` / `artifact_transform`。
 - agent-like 节点 executor 仅 `pi` | `static`（schema 已不含 `cursor`）。
-- 未完全兑现的 runtime limits 强执法、更广 profile、Loop 原生 `workflow` action 深度编排等仍是**设计输入**，见 `docs/design/dynamic-workflow-dag-engine-roadmap.md`（带 2026-07-14 校准条）。
+- 未完全兑现的 runtime limits 强执法、更广 profile、Loop 原生 `workflow` action 深度编排等仍是**设计输入**，见 `ai_workspace/loop-agent/design/dynamic-workflow-dag-engine-roadmap.md`（带 2026-07-14 校准条）。

package/docs/architecture/evolution.md

@@ -1,6 +1,6 @@
 # 架构演进：当前 vs 未来
 
-本页区分 loop-agent **当前已实现**的架构能力与**未来规划**。当前事实以代码、发布 CLI、已完成计划为准；未来能力一律标「规划 / 未实现 / 前瞻」。权威源：`CHANGELOG.md`、`docs/reports/current-capability-summary.md`、ADR 0001–0004、`docs/exec-plans/completed/` 与 active identity plan 的 progress。
+本页区分 loop-agent **当前已实现**的架构能力与**未来规划**。当前事实以代码、发布 CLI、已完成计划为准；未来能力一律标「规划 / 未实现 / 前瞻」。权威源：`CHANGELOG.md`、`ai_workspace/loop-agent/reports/current-capability-summary.md`、ADR 0001–0004、`ai_workspace/loop-agent/exec-plans/completed/` 与 active identity plan 的 progress。
 
 ## 当前已实现（0.11.0）
 
@@ -9,14 +9,14 @@
 | 受治理 Agent runtime | **Pi-only**；`cursor-prompt` 仅显式 one-shot sidecar | ADR 0001、`CHANGELOG.md [0.10.0]` |
 | Agent DAG 主链 | `dag run-task` → generate → validate → `run-dag`；report/doctor/reconcile-run | `dag-execution.md`、`test/cli-contract.test.ts` |
 | Dynamic Workflow | `WorkflowSpec` → validate → compile → 同一 `run-dag`；agent-like 节点仅 `pi\|static` | `src/workflows/dynamic/{spec,validate,compile}.ts`、`website/docs/guides/dynamic-workflow.md` |
-| 版本化自举 | controller identity + run-owned skill snapshot + deterministic canary | `docs/reports/2026-07-13-versioned-self-hosting-bootstrap.md` |
-| Feature 交付（M2） | review/run/approve-followup/delivery/closeout/verify-final | `docs/reports/2026-07-12-m2-completion-audit.md` |
+| 版本化自举 | controller identity + run-owned skill snapshot + deterministic canary | `ai_workspace/loop-agent/reports/2026-07-13-versioned-self-hosting-bootstrap.md` |
+| Feature 交付（M2） | review/run/approve-followup/delivery/closeout/verify-final | `ai_workspace/loop-agent/reports/2026-07-12-m2-completion-audit.md` |
 | Task Pool | 唯一根 `.harness/task-pool/`；**feature-scoped** state v2（`TaskPoolTaskRef`） | ADR 0002、ADR 0004 |
-| 本地多 Feature 运营 | 同仓库多 Feature 可共用 Task ID；Ready / retry / Delivery / Observe 按 Feature 隔离 | ADR 0004、`docs/progress/2026-07-15-task-pool-v2-feature-scoped-task-identity.md` |
+| 本地多 Feature 运营 | 同仓库多 Feature 可共用 Task ID；Ready / retry / Delivery / Observe 按 Feature 隔离 | ADR 0004、`ai_workspace/loop-agent/progress/2026-07-15-task-pool-v2-feature-scoped-task-identity.md` |
 | Observe | 本地只读暖白运营控制台 R1–R5（derived）；canonical Task route 为 feature-scoped | `website/docs/guides/observe-ui.md`、`CHANGELOG.md [0.11.0]`、ADR 0004 |
 | DagSpec / repair | v3 + `runtimeContract`；显式 `repairNodeId` | `CHANGELOG.md [0.11.0]`、`dag-execution.md` |
-| 文档双树 | `website/docs/` 用法 vs `docs/` 治理；docs-converge | ADR 0003 |
-| 文档治理 | `docs/architecture/` 主题文档（本目录）+ package 可达 | 本目录 README |
+| 文档双树 | `website/docs/` 用法 vs `ai_workspace/loop-agent/` 治理；docs-converge | ADR 0003 |
+| 文档治理 | `ai_workspace/loop-agent/architecture/` 主题文档（本目录）+ package 可达 | 本目录 README |
 
 ### 受治理 runtime 的边界（已实现、不变式）
 
@@ -26,26 +26,26 @@
 
 ## 未来规划（第 3–6 月，**未实现**）
 
-以下能力来自 `docs/design/六个月规划.md` 与 `docs/design/dynamic-workflow-dag-engine-roadmap.md`（六个月规划页首 2026-07-15 / 0.11.0 校准；未交付 phase 为**设计输入**，不是已实现证明）。它们**当前不存在于代码或 CLI**：
+以下能力来自 `ai_workspace/loop-agent/design/六个月规划.md` 与 `ai_workspace/loop-agent/design/dynamic-workflow-dag-engine-roadmap.md`（六个月规划页首 2026-07-15 / 0.11.0 校准；未交付 phase 为**设计输入**，不是已实现证明）。它们**当前不存在于代码或 CLI**：
 
 | 未来方向 | 状态 | 规划来源 |
 | --- | --- | --- |
-| 远程 PR / CI | 规划 / 未实现 | `docs/design/六个月规划.md`（第 3 个月起） |
+| 远程 PR / CI | 规划 / 未实现 | `ai_workspace/loop-agent/design/六个月规划.md`（第 3 个月起） |
 | 线上 / 云 Worker | 规划 / 未实现 | 同上 |
 | 云 Task Pool / SQL / Orchestrator | 规划 / 未实现 | 同上（第 2 月原始设计已调整为本地 Feature 闭环） |
 | 多仓库平台 | 规划 / 未实现 | 同上 |
 | 组织级服务 | 规划 / 未实现 | 同上 |
 | Web Console（远端） | 规划 / 未实现 | 同上 |
-| Dynamic Workflow runtime limits 强执法、更广 profile | 设计输入 | `docs/design/dynamic-workflow-dag-engine-roadmap.md`（未勾选 phase） |
+| Dynamic Workflow runtime limits 强执法、更广 profile | 设计输入 | `ai_workspace/loop-agent/design/dynamic-workflow-dag-engine-roadmap.md`（未勾选 phase） |
 | Loop 与 Dynamic Workflow 更深的双向集成、稳定化与自动恢复 | 设计输入 | 同上；当前已有基础 `workflow` action，不应误写为完全缺失 |
 
-> 注意：`docs/design/dynamic-workflow-dag-engine-roadmap.md` 是 2026-07-04 历史叙述；文中凡把 Cursor 写成受治理 executor 或 `loop` 的 `cursor-fix` 动作，均为**历史叙述**，现状以 Pi-only + 显式 `cursor-prompt` sidecar 为准。
+> 注意：`ai_workspace/loop-agent/design/dynamic-workflow-dag-engine-roadmap.md` 是 2026-07-04 历史叙述；文中凡把 Cursor 写成受治理 executor 或 `loop` 的 `cursor-fix` 动作，均为**历史叙述**，现状以 Pi-only + 显式 `cursor-prompt` sidecar 为准。
 
 ## 已收敛为 archive / 历史基线（非未来）
 
-- 第 1–2 月规划已收敛为 archive/reports 指针，不在本文展开：`docs/design/archive/2026-07-12-第二月规划.md`。
-- `docs/reports/2026-07-02-repository-analysis.md` 自 2026-07-14 起冻结为**历史基线快照**，不再滚动追加 Unreleased 能力。
-- 活能力短摘要在 `docs/reports/current-capability-summary.md`。
+- 第 1–2 月规划已收敛为 archive/reports 指针，不在本文展开：`ai_workspace/loop-agent/design/archive/2026-07-12-第二月规划.md`。
+- `ai_workspace/loop-agent/reports/2026-07-02-repository-analysis.md` 自 2026-07-14 起冻结为**历史基线快照**，不再滚动追加 Unreleased 能力。
+- 活能力短摘要在 `ai_workspace/loop-agent/reports/current-capability-summary.md`。
 
 ## 文档本体的演进边界
 

package/docs/architecture/facts-and-state.md

@@ -68,4 +68,4 @@
 
 ## init 投影的 `.harness` 入口
 
-`init --profile full` 在目标项目创建 `.harness/tasks`（directory）、`.harness/dag-runs/active`（directory）、`.harness/prompts/analyze.md`（generated）、`.harness/init-surface.json`（state）。这些是 init surface，不在 `packageExcluded`/`initExcluded` 范围；详见 `docs/init-surface.manifest.json`。
+`init --profile full` 在目标项目创建 `.harness/tasks`（directory）、`.harness/dag-runs/active`（directory）、`.harness/prompts/analyze.md`（generated）、`.harness/init-surface.json`（state）。这些是 init surface，不在 `packageExcluded`/`initExcluded` 范围；详见 `ai_workspace/loop-agent/init-surface.manifest.json`。

package/docs/architecture/runtime-boundaries.md

@@ -6,8 +6,8 @@
 
 ```text
 Skill layer
-  ├─ DAG/runtime 入口策略（skills/loop-agent/）
-  └─ Feature/Task Pool 外层 operator 路由（skills/agent-worker/）
+  ├─ DAG/runtime 入口策略（.agents/skills/loop-agent/）
+  └─ Feature/Task Pool 外层 operator 路由（.agents/skills/agent-worker/）
 
 CLI layer (src/cli/)
   └─ argv 解析、adapter 解析、调用 application / command handler、格式化输出
@@ -39,7 +39,7 @@ Governance (scripts/check-*.sh, src/governance/)
 
 ### Skill layer
 
-- **位置**：`skills/loop-agent/**` 与 `skills/agent-worker/**`
+- **位置**：`.agents/skills/loop-agent/**` 与 `.agents/skills/agent-worker/**`
 - **职责**：`loop-agent` skill 定义单个 DAG/runtime 工作的入口、硬规则与 reference 路由；`agent-worker` skill 只定义 Feature Packet、TaskSpec、Task Pool、controller pinning、自举 release train 与失败恢复的外层 operator 路由。
 - **路由边界**：DAG leaf node 不得递归启动 `agent-worker`；`agent-worker` 不得加入 `DEFAULT_SKILLS_BY_ROLE`，也不实现 executor、scheduler、prompt 或 write guard。
 - **禁止**：在入口 skill 中重复维护 CLI command 列表或与 `src/cli/catalog.ts` 冲突的事实源。
@@ -83,7 +83,7 @@ Governance (scripts/check-*.sh, src/governance/)
 
 - **位置**：`src/worker/**`，独立 `agent-worker` CLI 为 `src/worker/cli.ts`。
 - **职责**：TaskSpec 校验与物化、Task Pool batch/retry/morning report under `.harness/task-pool/`、失败路由，以及只读 Observe 事件/快照/UI；实际 DAG 执行通过 `LoopAgentClient` 启动已发布的 `loop-agent` 子进程。自 0.8.0 起该目录是唯一受支持的 Task Pool runtime root，旧路径不读取、不迁移、不合并、不重映射。
-- **controller identity**：写入型 Feature/batch/Task/final verification 在任何目标仓库或 Task Pool 状态写入前解析并冻结 schemaVersion 1 identity，包括 package name/version、绝对 entry/real entry、直接可执行 launch spec、binary SHA-256 和覆盖 `package.json`、`bin/**`、`dist/**`、`skills/**` 的 portable fingerprint。expected version/fingerprint 不匹配时 fail-fast；后续 spawn 不重新查询 PATH。
+- **controller identity**：写入型 Feature/batch/Task/final verification 在任何目标仓库或 Task Pool 状态写入前解析并冻结 schemaVersion 1 identity，包括 package name/version、绝对 entry/real entry、直接可执行 launch spec、binary SHA-256 和覆盖 `package.json`、`bin/**`、`dist/**`、`.agents/skills/**` 的 portable fingerprint。expected version/fingerprint 不匹配时 fail-fast；后续 spawn 不重新查询 PATH。
 - **证据传播**：canonical Worker record、Task Pool run、batch/Feature、QA/final evidence 可选携带同一 identity；只有所有相关层都省略 identity 时才按 legacy evidence 接受，部分缺失或锚点不一致会拒绝。
 - **允许依赖**：TaskSpec、Task Pool、observability、Node filesystem/path 与明确的 shared/task contract；它不是第二套 executor 或 DAG kernel。
 - **禁止**：in-process import `src/cli/**`、`src/commands/**` 或 `src/application/**`。
@@ -145,7 +145,7 @@ Runner / Loop         ──(迁移中)──>  逐步改为仅经 Store / Appli
 | `src/executors/**` | shared, 外部 SDK | `src/commands/**`, `src/cli/**` |
 | `src/worker/**` | worker-local modules, task contracts, shared, Node APIs | `src/commands/**`, `src/cli/**`, `src/application/**` |
 | `src/cli/**` | commands, adapters, shared, application（目标） | — |
-| `skills/**` | （Markdown 引用，非 TS import） | 运行时 TS 模块 |
+| `.agents/skills/**` | （Markdown 引用，非 TS import） | 运行时 TS 模块 |
 
 ## 已知过渡耦合
 
@@ -161,10 +161,10 @@ Runner / Loop         ──(迁移中)──>  逐步改为仅经 Store / Appli
 |--------|----------|----------|
 | `scripts/check-architecture-boundaries.sh` | workflow/executor forbidden import，及 Worker → CLI/commands/application import | 新的未 allowlist violation |
 | `scripts/check-command-registry-drift.sh` | `command-reference.md` 中的 top-level command vs `src/cli/catalog.ts` | 文档引用未注册 command |
-| `scripts/check-exec-plan-index-sync.sh` | `docs/exec-plans/{active,completed}` 目录文件 vs 对应 `README.md` 索引 | 任一 plan 文件未在索引登记 |
+| `scripts/check-exec-plan-index-sync.sh` | `ai_workspace/loop-agent/exec-plans/{active,completed}` 目录文件 vs 对应 `README.md` 索引 | 任一 plan 文件未在索引登记 |
 | `scripts/check-skill-entry.sh` | `loop-agent` / `agent-worker` 的 frontmatter、required references、入口行数与 operator trigger vocabulary | 任一公共 skill 缺失、reference/trigger 漂移或入口超过 hard limit |
 
-版本化自举相关 exec plan：`docs/exec-plans/active/2026-07-13-versioned-self-hosting-bootstrap.md`。
+版本化自举相关 exec plan：`ai_workspace/loop-agent/exec-plans/active/2026-07-13-versioned-self-hosting-bootstrap.md`。
 
 `src/governance/exec-plans.ts` 是 exec-plan 创建、完成与索引校验的共享 TypeScript 事实源：`plan create`/`plan complete`/`plan check` 与 `dag run-task` 前置校验都调用它。`scripts/check-exec-plan-index-sync.sh` 是独立的 shell 最终防线，与 TypeScript checker 并存；两者均不删除或弱化。
 

package/docs/architecture/system-overview.md

@@ -18,7 +18,7 @@
 完整分层图、各层职责、允许/禁止的 import 方向见 `runtime-boundaries.md` §分层概览 与 §各层职责。一句话摘要：
 
 ```text
-Skill layer      skills/loop-agent、skills/agent-worker（Markdown，非 TS import）
+Skill layer      .agents/skills/loop-agent、.agents/skills/agent-worker（Markdown，非 TS import）
 CLI layer        src/cli/ — argv 解析、调用 application/handler、格式化输出
 Application      src/application/ — typed use-case（validate/run/generate DAG 等）
 Workflow runtime src/workflows/ — DAG / Dynamic / Loop 核心执行规则
@@ -86,8 +86,8 @@ workflow runtime（调度 Pi / shell / static 节点）
 | 位置 | 内容 | 权威性质 |
 | --- | --- | --- |
 | `.harness/` | 任务、DAG run、one-shot run、Task Pool、live state | 运行态事实（canonical + derived） |
-| 根目录 `docs/` | 原则、边界、计划、报告、模板 | 治理权威 |
+| 根目录 `ai_workspace/loop-agent/` | 原则、边界、计划、报告、模板 | 治理权威 |
 | `website/docs/` | 使用者/贡献者导读与操作说明 | 用法双树 |
-| `skills/` | agent 可加载的入口与 reference | 运行时可加载 |
+| `.agents/skills/` | agent 可加载的入口与 reference | 运行时可加载 |
 
 `.harness/` 内部哪些可写、哪些只读、哪些是 derived，详见 `facts-and-state.md`。

package/docs/architecture/worker-and-feature.md

@@ -27,7 +27,7 @@
 | `launch.command` / `launch.argsPrefix` | 直接可执行的绝对 launch spec |
 | `binarySha256` | `actualEntry` 二进制 hash |
 | `packageVersion` | `package.json` version |
-| `packageFingerprint` | 覆盖 `package.json`、`bin/**`、`dist/**`、`skills/**` 的 portable fingerprint（`computePackageFingerprint`） |
+| `packageFingerprint` | 覆盖 `package.json`、`bin/**`、`dist/**`、`.agents/skills/**` 的 portable fingerprint（`computePackageFingerprint`） |
 
 关键方法：
 
@@ -66,7 +66,7 @@ controller identity 与 DAG skill snapshot 是两个不同冻结层（前者跨
 - review/run/approve-followup/delivery/closeout/verify-final：`src/worker/feature/{review,run}.ts` 及相关。
 - Follow-up：`src/worker/` 下 draft-followup + approve-followup 事务，覆盖全部失败分类（可执行/Spec/Risk/Human/EnvFailure）。
 - Delivery / Closeout：clean Delivery HEAD 上生成 canonical QA/最终验证证据、Delivery Package、Acceptance Coverage、PR 草稿；Closeout 默认预览，显式 `--apply --owner` 才原子写回。
-- 权威证据：`CHANGELOG.md [0.10.0]`、`docs/reports/2026-07-12-m2-completion-audit.md`。
+- 权威证据：`CHANGELOG.md [0.10.0]`、`ai_workspace/loop-agent/reports/2026-07-12-m2-completion-audit.md`。
 
 ### Observe（只读 read model）
 
@@ -82,4 +82,4 @@ controller identity 与 DAG skill snapshot 是两个不同冻结层（前者跨
 
 - Worker 不得 in-process import `src/cli/**`、`src/commands/**` 或 `src/application/**`（governance 机器校验）。
 - Worker 不实现 executor、scheduler、prompt 或 write guard。
-- `agent-worker` skill（`skills/agent-worker/`）不加入 `DEFAULT_SKILLS_BY_ROLE`；DAG leaf node 不得递归启动 `agent-worker`（`runtime-boundaries.md` §Skill layer）。
+- `agent-worker` skill（`.agents/skills/agent-worker/`）不加入 `DEFAULT_SKILLS_BY_ROLE`；DAG leaf node 不得递归启动 `agent-worker`（`runtime-boundaries.md` §Skill layer）。

package/docs/design/README.md

@@ -158,10 +158,10 @@
 
 ## 维护规则
 
-1. 保持 TaskSpec 字段、status、failure category、命令示例与契约文档一致。  
-2. 未来平台组件标为目标架构，除非已存在于 `src/` 或 `scripts/`。  
-3. 命令示例只用 `agent-worker` / `loop-agent`。  
-4. `config-types` / profile routing 变更时更新 mapping 文档。  
-5. failure / Task Pool state 变更时更新 taxonomy。  
-6. **过期月规划 / 已关闭实现合同**迁入 `archive/`，并更新本 README。  
-7. 运行 `bash scripts/check-repo.sh`（或至少 check-doc-index / check-doc-links）。  
+1. 保持 TaskSpec 字段、status、failure category、命令示例与契约文档一致。
+2. 未来平台组件标为目标架构，除非已存在于 `src/` 或 `scripts/`。
+3. 命令示例只用 `agent-worker` / `loop-agent`。
+4. `config-types` / profile routing 变更时更新 mapping 文档。
+5. failure / Task Pool state 变更时更新 taxonomy。
+6. **过期月规划 / 已关闭实现合同**迁入 `archive/`，并更新本 README。
+7. 运行 `bash scripts/check-repo.sh`（或至少 check-doc-index / check-doc-links）。

package/docs/development-principles.md

@@ -9,7 +9,7 @@ loop-agent 是面向 agentic coding 的工作流 runtime。仓库应保持小而
 这个模型吸收了 Anthropic 长时运行 agent harness、OpenAI Codex harness engineering、腾讯端到端 Harness Engineering 和社区 agent harness 实践中的共同经验：用短入口文档导航长期知识，用结构化任务状态和 handoff artifact 跨 session 传递事实，用独立验证和评审回路约束 agent 输出，并把人类注意力集中在意图、边界、架构和反馈系统上。面向使用者的背景资料收录在 `website/docs/practices/`。
 
 - 仓库是记录系统。决策、契约、计划、测试、报告与交接属于 tracked files。
-- `AGENTS.md` 是操作地图，不是知识 dump。长期方法论与决策属于 `docs/`。
+- `AGENTS.md` 是操作地图，不是知识 dump。长期方法论与决策属于 `ai_workspace/loop-agent/`。
 - 工作以小步、可逆、可验证的增量推进。
 - 状态不确定时，先跑基线验证再开新工。
 - 完成由新鲜证据定义，而非意图或信心。
@@ -19,7 +19,7 @@ loop-agent 是面向 agentic coding 的工作流 runtime。仓库应保持小而
 1. 一次任务只推进一个有边界的工作块。
 2. 设计新行为前先搜索现有代码、文档、脚本与测试。
 3. Shell 验证是完成权威。
-4. Runtime 状态在 `.harness/`；持久决策在 `docs/`。
+4. Runtime 状态在 `.harness/`；持久决策在 `ai_workspace/loop-agent/`。
 5. Pi writer 节点必须由显式 allowed/forbidden paths 与 writeSet 约束；Cursor 仅可作为 `cursor-prompt` one-shot sidecar，不进入受治理 DAG/Loop 写入路径。
 6. Pi review/planning 路径是 advisory，除非后跟确定性验证。
 7. 反复出现的约束应固化为文档、测试、脚本、检查或模板。
@@ -31,9 +31,9 @@ loop-agent 是面向 agentic coding 的工作流 runtime。仓库应保持小而
 
 - 源码：`src/`
 - 测试：`test/`
-- Skill 指令：源码仓库和 npm 包内置在 `skills/`，目标项目 repo-local skills 在 `.agents/skills/`
+- Skill 指令：源码仓库和 npm 包内置在 `.agents/skills/`，目标项目 repo-local skills 在 `.agents/skills/`
 - 验证与维护脚本：`scripts/`
-- 治理与交接产物：`docs/`
+- 治理与交接产物：`ai_workspace/loop-agent/`
 
 ## 变更纪律
 

package/docs/exec-plans/active/README.md

@@ -6,10 +6,8 @@
 
 当前 active execution plan：
 
-- [`2026-07-17-frontend-implementation-capability-deepening.md`](2026-07-17-frontend-implementation-capability-deepening.md) — frontend-implementation 结构化合同、修复闭环与项目适配深化
-- [`2026-07-17-backend-test-capability-deepening.md`](2026-07-17-backend-test-capability-deepening.md) — backend-test 执行合同、结果分类与可验证追踪深化
+- [`2026-07-18-nightly-auto-release.md`](2026-07-18-nightly-auto-release.md) — 夜间自动发布：距上次 tag ≥3 commits → GitHub Release + npm（内部测试阶段复用人工发布规则；全自动执行、次日上午人工核对；**active**）
 - [`2026-07-16-recursive-self-improvement-eval-lab.md`](2026-07-16-recursive-self-improvement-eval-lab.md) — Eval Lab：**M0+M1+M2(W2.1–W2.3) done**；W2.4 alias/promotion 与 M3+ live campaign 仍 todo（设计真源 `docs/design/recursive-self-improvement-eval-lab.md`；CHANGELOG `[Unreleased]`）
 - [`2026-07-16-frontend-mock-node.md`](2026-07-16-frontend-mock-node.md) — 前端 DAG Mock 策略节点与安全验证
-- [`2026-07-16-fe-test-dag.md`](2026-07-16-fe-test-dag.md) — FE-test RAG：功能用例、Playwright CLI 浏览器执行与证据复盘链路
 
-- 已归档：`../completed/2026-07-17-frontend-beta-publish-guard.md`、`../completed/2026-07-16-backend-test-remediation.md`、`../completed/2026-07-16-frontend-demand-auto-routing.md`、`../completed/2026-07-16-frontend-mock-data-workflow.md`、`../completed/2026-07-14-knowledge-sync-and-graph.md`、`../completed/2026-07-15-repair-artifact-gate-runtime-contract.md`、`../completed/2026-07-14-observe-ui-r5.md`、`../completed/2026-07-14-observe-ui-r4.md`、`../completed/2026-07-14-observe-ui-r3.md`、`../completed/2026-07-14-observe-ui-r2.md`、`../completed/2026-07-14-observe-ui-r1.md`、`../completed/2026-07-14-init-canonical-layout.md`、`../completed/2026-07-12-observe-warm-console-redesign.md`、`../completed/2026-07-14-website-docs-ia-and-converge.md`、`../completed/2026-07-13-versioned-self-hosting-bootstrap.md`、`../completed/2026-07-12-pi-only-agent-runtime.md`、第二月 M2-01～M2-08、`../completed/2026-07-11-observe-dashboard-page-system.md`、`../completed/2026-07-11-observe-dashboard-detail-refinement.md`、`../completed/2026-07-11-observe-terminal-dag-kpi.md`、`../completed/2026-07-11-observe-polling-efficiency.md`、`../completed/2026-07-11-command-performance-guardrails.md` 及更早计划。
+- 已归档：`../completed/2026-07-18-observe-ops-surface-and-rich-timeline.md`、`../completed/2026-07-16-fe-test-dag.md`、`../completed/2026-07-17-frontend-implementation-capability-deepening.md`、`../completed/2026-07-17-backend-test-capability-deepening.md`、`../completed/2026-07-16-backend-test-remediation.md`、`../completed/2026-07-16-frontend-demand-auto-routing.md`、`../completed/2026-07-16-frontend-mock-data-workflow.md`、`../completed/2026-07-14-knowledge-sync-and-graph.md`、`../completed/2026-07-15-repair-artifact-gate-runtime-contract.md`、`../completed/2026-07-14-observe-ui-r5.md`、`../completed/2026-07-14-observe-ui-r4.md`、`../completed/2026-07-14-observe-ui-r3.md`、`../completed/2026-07-14-observe-ui-r2.md`、`../completed/2026-07-14-observe-ui-r1.md`、`../completed/2026-07-14-init-canonical-layout.md`、`../completed/2026-07-12-observe-warm-console-redesign.md`、`../completed/2026-07-14-website-docs-ia-and-converge.md`、`../completed/2026-07-13-versioned-self-hosting-bootstrap.md`、`../completed/2026-07-12-pi-only-agent-runtime.md`、第二月 M2-01～M2-08、`../completed/2026-07-11-observe-dashboard-page-system.md`、`../completed/2026-07-11-observe-dashboard-detail-refinement.md`、`../completed/2026-07-11-observe-terminal-dag-kpi.md`、`../completed/2026-07-11-observe-polling-efficiency.md`、`../completed/2026-07-11-command-performance-guardrails.md` 及更早计划。

package/docs/exec-plans/completed/README.md

@@ -4,10 +4,18 @@
 
 npm 包携带本 README 作为目录契约。具体 completed plan 属于目标仓库历史，不从 loop-agent 源码历史复制。
 
-- [`2026-07-17-frontend-beta-publish-guard.md`](2026-07-17-frontend-beta-publish-guard.md) — `frontend` 分支本地 npm 发布门禁，只允许 beta SemVer 与 beta dist-tag，避免预发布包误推 `latest`
-- [`2026-07-16-backend-test-remediation.md`](2026-07-16-backend-test-remediation.md) — 修正 backend-test 的 taskKind/profile 漂移、虚假 convergence、pytest write-guard/报告契约、pytest writer 边界、prompt 安全与 Observe events 失败可见性；analyze 结构化落盘拆为独立后续计划
-- [`2026-07-16-dag-source-binding-recovery.md`](2026-07-16-dag-source-binding-recovery.md) — 新生成 DAG 冻结任务源与需求编号，前端计划缺号在 writer 前阻断，v3 孤立 writer 严格拒绝二手摘要恢复
-- [`2026-07-14-knowledge-sync-and-graph.md`](2026-07-14-knowledge-sync-and-graph.md) — 知识库同步 DAG（featureId 硬化）+ 业务知识图谱开荒 / Phase A 查询 / 增量 prepare / `knowledge` CLI；随 0.12.0 发布并归档
+- [`2026-07-18-observe-ops-surface-and-rich-timeline.md`](2026-07-18-observe-ops-surface-and-rich-timeline.md) — Observe 资源池运营面、总览执行面重排、检查器半屏宽度与富执行过程时间线（含 `recordedAt`）
+- [`2026-07-16-fe-test-dag.md`](2026-07-16-fe-test-dag.md) — FE-test RAG：`taskKind: "frontend-test"` 串行浏览器用例/证据 DAG（MVP + PR #25；prompt 深度 / 真实 browser smoke 等 residual 另开）
+- [`2026-07-17-frontend-implementation-capability-deepening.md`](2026-07-17-frontend-implementation-capability-deepening.md) — frontend-implementation Contract/trace/repair、风险裁剪、React/Next/Vue capability、a11y/openSpec seed（M0–M6 核心完成；W2.7/W3.8/W6.8 residual）
+- [`2026-07-17-backend-test-capability-deepening.md`](2026-07-17-backend-test-capability-deepening.md) — backend-test 执行合同、结果分类、Case Manifest/Traceability 与 M4 docs/init/tmpdir smoke 收敛（M0–M4 全完成）
+- [`2026-07-17-review-findings-remediation.md`](2026-07-17-review-findings-remediation.md) — 收敛主干 review findings
+- [`2026-07-16-frontend-mock-data-workflow.md`](2026-07-16-frontend-mock-data-workflow.md) — 前端 Mock 数据治理链
+- [`2026-07-16-frontend-demand-auto-routing.md`](2026-07-16-frontend-demand-auto-routing.md) — 前端需求确定性自动路由
+- [`2026-07-16-dag-source-binding-recovery.md`](2026-07-16-dag-source-binding-recovery.md) — DAG 任务源绑定与恢复门禁
+- [`2026-07-16-backend-test-remediation.md`](2026-07-16-backend-test-remediation.md) — backend-test 报告、writeSet 与 prompt 修复
+- [`2026-07-14-knowledge-sync-and-graph.md`](2026-07-14-knowledge-sync-and-graph.md) — knowledge-sync 与知识图谱 MVP 完成归档
+- [`2026-07-16-target-agents-routing-observe.md`](2026-07-16-target-agents-routing-observe.md) — 让根与初始化目标 AGENTS 正确路由后端测试，并提供本地只读看板入口和安全更新回归
+- [`2026-07-16-init-upgrade-continuity.md`](2026-07-16-init-upgrade-continuity.md) — 修复 apply-safe 降级 recorded state、补齐 knowledge taskKind/公共 CLI 指引，并将 kb runtime scripts 纳入 packageRequired
 - [`2026-07-15-repair-artifact-gate-runtime-contract.md`](2026-07-15-repair-artifact-gate-runtime-contract.md) — 显式 `repairNodeId` + 严格 repair writer 契约、DagSpec `runtimeContract` capability preflight，以及 run-owned controller identity（resume 漂移 fail-closed）
 - [`2026-07-14-backend-test-dag-template.md`](2026-07-14-backend-test-dag-template.md) — 通过 `taskKind: "backend-test"` 生成需求分析、功能用例、pytest 自动化、执行与复盘的 Pi-only 专用 DAG
 - [`2026-07-14-observe-ui-r5.md`](2026-07-14-observe-ui-r5.md) — Observe 原生 ES module 拆分、四态 helper、Pool hash 筛选与入口 re-export
@@ -77,9 +85,24 @@ npm 包携带本 README 作为目录契约。具体 completed plan 属于目标
 - [`2026-07-15-init-update-surface-coverage.md`](2026-07-15-init-update-surface-coverage.md)
 - [`2026-07-15-readonly-node-retry.md`](2026-07-15-readonly-node-retry.md)
 
-- [`2026-07-16-frontend-demand-auto-routing.md`](2026-07-16-frontend-demand-auto-routing.md)
-- [`2026-07-16-frontend-mock-data-workflow.md`](2026-07-16-frontend-mock-data-workflow.md)
+- [`2026-07-16-init-natural-language-routing.md`](2026-07-16-init-natural-language-routing.md)
+
+- [`2026-07-16-observe-inspector-node-consistency.md`](2026-07-16-observe-inspector-node-consistency.md)
+
+- [`2026-07-16-repair-artifact-pass-normalization.md`](2026-07-16-repair-artifact-pass-normalization.md)
+
+- [`2026-07-16-decision-envelope-fence-tolerance.md`](2026-07-16-decision-envelope-fence-tolerance.md)
+
+- [`2026-07-16-decision-envelope-prompt-contract.md`](2026-07-16-decision-envelope-prompt-contract.md)
+
+- [`2026-07-17-source-target-structure-alignment.md`](2026-07-17-source-target-structure-alignment.md)
 
 - [`2026-07-17-review-findings-remediation.md`](2026-07-17-review-findings-remediation.md)
 
 - [`2026-07-16-backend-test-analysis-contract-artifact.md`](2026-07-16-backend-test-analysis-contract-artifact.md)
+
+- [`2026-07-17-release-0130-reconcile.md`](2026-07-17-release-0130-reconcile.md)
+
+- [`2026-07-17-observe-dashboard-incremental-polling.md`](2026-07-17-observe-dashboard-incremental-polling.md)
+
+- [`2026-07-18-origin-main-merge-43e86ad.md`](2026-07-18-origin-main-merge-43e86ad.md)