@whispering233/ai-editor-db 0.0.57 → 0.0.59

package/dist/queries/practice.js

@@ -0,0 +1,339 @@
+// @whispering233/ai-editor-db 作家文风练习读写（practice_samples / practice_free_pieces /
+// practice_style_packs，2026-10 改版）
+//
+// 练习工作区（`kind = "practice"`，一位预置作家 = 一个工作区）专属数据：
+// **库写入唯一入口 = 本模块**（禁止绕过直接写表）。语义与不变式见 `docs/design/60-practice.md` §5、
+// 字段契约见 `docs/db/schema.md`「练习三表」、响应形状见 `docs/api/120-api-practice.md`。
+//
+// 口径（与文档逐条对应）：
+// - **物理删**：练习数据无回收站（无 deleted_at）；删除幂等（不存在 → null / false，不抛错）
+// - **范文不可变**：`text` 只在建样本时落库，无更新入口
+// - **每列只有一个写入口**：`draft` 只有用户（updatePracticeSampleDraft / updatePracticePieceDraft）、
+//   `feedback` 只有提交点评工具（updatePracticeFeedback / updatePracticePieceFeedback）、
+//   `topic` / `brief` 只有出题工具（updatePracticePieceTopic）
+// - **无外键、无索引**：`work_id` 的存在性由写入侧按 shared 预置作品清单守卫；单工作区数据量小、列表全扫
+// - **列表只出投影**：不回正文 / 稿件 / 卡体（`charCount` 走 SQL `length(...)`，不把长文拉进内存；
+//   `feedback` 只读出用于判定 `hasFeedback`，不进返回值）
+// - **JSON 列防御解析**：`feedback` text 模式（不用 drizzle `mode:'json'`），坏值按 null
+// - **素材包只存用户覆盖**：无覆盖 = 无行（读侧回退 shared 预置常量），删行 = 恢复预置
+//
+// 返回值形态沿用 db 包既有口径：**详情 / 写入 = 存储形态行（snake_case）**、
+// **列表 = API 投影形状（camelCase，同 EntitySummary 先例）**——列表投影是 db 侧派生
+// （charCount / hasDraft / hasFeedback），不由调用方复算。
+import { asc, desc, eq, sql } from "drizzle-orm";
+import { generateId } from "@whispering233/ai-editor-shared";
+import { withTransaction } from "../connection.js";
+import { nowIso } from "../storage/atomic.js";
+import { queryDb } from "../query-db.js";
+import { practiceFreePieces, practiceSamples, practiceStylePacks } from "../tables.js";
+/**
+ * 解析 `feedback` 列（防御解析，同 entity.ts parseDataColumn 先例）：
+ * 非法 JSON / 非对象（含数组 / JSON `null`）一律按 null——否则单条坏行会打挂读取；
+ * **合法 JSON 对象一律原样返回**（含 `{}`——**卡内形状校验在写入侧**，读侧不做形状特判）。
+ * 坏值不静默写回（修复入口 = 重跑点评，见 docs/api/120-api-practice.md）。
+ */
+function parseFeedbackColumn(value) {
+    if (typeof value !== "string")
+        return null;
+    try {
+        const parsed = JSON.parse(value);
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/** 行映射：列名直映射（同 DDL）+ `feedback` 防御解析 */
+function toSampleRow(row) {
+    return { ...row, feedback: parseFeedbackColumn(row.feedback) };
+}
+/** 行映射：列名直映射（同 DDL）+ `feedback` 防御解析 */
+function toPieceRow(row) {
+    return { ...row, topic_source: row.topic_source, feedback: parseFeedbackColumn(row.feedback) };
+}
+// ============ 范文样本（practice_samples） ============
+/**
+ * 全工作区样本列表（`GET /practice/samples`）：按 `updated_at` 倒序（同值用 id 升序作稳定次序，
+ * 避免同毫秒写入的列表顺序不稳定）、**只出投影列**——范文正文与卡体不进内存（charCount 走 SQL）。
+ *
+ * `hasDraft` = `draft <> ''`（SQL 判定）；`hasFeedback` = 点评卡**防御解析后非 null**——
+ * 与详情同口径：坏 JSON 行在列表与详情一致地呈现为「未点评」（故本查询读出 `feedback` 列但不进返回值）。
+ */
+export function listPracticeSamples(db) {
+    const rows = queryDb(db)
+        .select({
+        id: practiceSamples.id,
+        workId: practiceSamples.work_id,
+        excerptLabel: practiceSamples.excerpt_label,
+        charCount: sql `length(${practiceSamples.text})`,
+        hasDraft: sql `(${practiceSamples.draft} <> '')`,
+        feedback: practiceSamples.feedback,
+        createdAt: practiceSamples.created_at,
+        updatedAt: practiceSamples.updated_at,
+    })
+        .from(practiceSamples)
+        .orderBy(desc(practiceSamples.updated_at), asc(practiceSamples.id))
+        .all();
+    return rows.map((row) => ({
+        id: row.id,
+        workId: row.workId ?? null,
+        excerptLabel: row.excerptLabel,
+        charCount: row.charCount,
+        hasDraft: row.hasDraft === 1,
+        hasFeedback: parseFeedbackColumn(row.feedback) !== null,
+        createdAt: row.createdAt,
+        updatedAt: row.updatedAt,
+    }));
+}
+/** 按 id 取样本详情（`GET /practice/samples/:id`；含范文全文、稿件与防御解析后的点评卡）；不存在返回 null */
+export function getPracticeSample(db, id) {
+    const row = queryDb(db).select().from(practiceSamples).where(eq(practiceSamples.id, id)).get();
+    return row === undefined ? null : toSampleRow(row);
+}
+/**
+ * 新建样本（`POST /practice/samples`）：id = `ps-` + nanoid、`draft` = 空串、`feedback` = NULL、
+ * created_at = updated_at = 写入时刻。`work_id` 缺省 / null = 「其他」（存在性校验在写入侧 = 路由 schema）；
+ * `excerpt_label` 缺省 = 空串。**范文 `text` 落库后不可变**（无更新入口）。
+ * @returns 新行（存储形态）
+ */
+export function createPracticeSample(db, input) {
+    const now = nowIso();
+    const row = {
+        id: generateId("ps-"),
+        work_id: input.workId ?? null,
+        excerpt_label: input.excerptLabel ?? "",
+        text: input.text,
+        draft: "",
+        feedback: null,
+        created_at: now,
+        updated_at: now,
+    };
+    queryDb(db)
+        .insert(practiceSamples)
+        .values({
+        id: row.id,
+        work_id: row.work_id,
+        excerpt_label: row.excerpt_label,
+        text: row.text,
+        draft: row.draft,
+        feedback: null,
+        created_at: row.created_at,
+        updated_at: row.updated_at,
+    })
+        .run();
+    return row;
+}
+/**
+ * 保存仿写稿（`PUT /practice/samples/:id`）——样本侧**唯一的用户写稿入口**（AI 工具面没有写稿工具）。
+ * 整体覆盖 `draft`（允许空串 = 清空稿件），推进 `updated_at`；范文 `text` 与 `feedback` 一概不动。
+ * 并发口径 = 后写覆盖（不带版本戳，同结构化数据/参考资料）。
+ * @returns `{ updatedAt }`（版本戳）；样本不存在返回 null（路由层映射 404）
+ */
+export function updatePracticeSampleDraft(db, id, draft) {
+    return withTransaction(db, () => {
+        if (getPracticeSample(db, id) === null)
+            return null;
+        const updatedAt = nowIso();
+        queryDb(db)
+            .update(practiceSamples)
+            .set({ draft, updated_at: updatedAt })
+            .where(eq(practiceSamples.id, id))
+            .run();
+        return { updatedAt };
+    });
+}
+/**
+ * 写入仿写点评卡（`submit_style_feedback` 工具的唯一落库入口）——**只写 `feedback`**（JSON 序列化写入），
+ * 推进 `updated_at`；范文 `text` 与用户稿 `draft` 一概不动（**AI 能写它自己的产出，不能写用户的产出**）。
+ * 卡内形状（字段/引用子串校验）在写入侧 = 提交点评工具，本层只序列化（同 document 先例：库层不校验块体）。
+ * @returns `{ updatedAt }`（版本戳）；样本不存在返回 null
+ */
+export function updatePracticeFeedback(db, id, feedback) {
+    return withTransaction(db, () => {
+        if (getPracticeSample(db, id) === null)
+            return null;
+        const updatedAt = nowIso();
+        queryDb(db)
+            .update(practiceSamples)
+            .set({ feedback: JSON.stringify(feedback), updated_at: updatedAt })
+            .where(eq(practiceSamples.id, id))
+            .run();
+        return { updatedAt };
+    });
+}
+/**
+ * 删除样本（`DELETE /practice/samples/:id`）：物理删（练习数据无回收站），行随工作区存续独立。
+ * @returns 是否删掉了行（false = 样本不存在，路由层映射 404；重复删除仍返回 false 而不抛错）
+ */
+export function deletePracticeSample(db, id) {
+    return queryDb(db).delete(practiceSamples).where(eq(practiceSamples.id, id)).run().changes > 0;
+}
+// ============ 自由练习（practice_free_pieces） ============
+/**
+ * 全工作区自由练习列表（`GET /practice/free`）：按 `updated_at` 倒序（同值用 id 升序作稳定次序）、
+ * **只出投影列**（`charCount` 走 SQL `length(draft)`，稿件不进内存）；`hasFeedback` 口径同样本列表。
+ */
+export function listPracticePieces(db) {
+    const rows = queryDb(db)
+        .select({
+        id: practiceFreePieces.id,
+        topic: practiceFreePieces.topic,
+        brief: practiceFreePieces.brief,
+        topicSource: practiceFreePieces.topic_source,
+        charCount: sql `length(${practiceFreePieces.draft})`,
+        hasDraft: sql `(${practiceFreePieces.draft} <> '')`,
+        feedback: practiceFreePieces.feedback,
+        createdAt: practiceFreePieces.created_at,
+        updatedAt: practiceFreePieces.updated_at,
+    })
+        .from(practiceFreePieces)
+        .orderBy(desc(practiceFreePieces.updated_at), asc(practiceFreePieces.id))
+        .all();
+    return rows.map((row) => ({
+        id: row.id,
+        topic: row.topic,
+        brief: row.brief,
+        topicSource: row.topicSource,
+        charCount: row.charCount,
+        hasDraft: row.hasDraft === 1,
+        hasFeedback: parseFeedbackColumn(row.feedback) !== null,
+        createdAt: row.createdAt,
+        updatedAt: row.updatedAt,
+    }));
+}
+/** 按 id 取自由练习详情（`GET /practice/free/:id`；含稿件与防御解析后的点评卡）；不存在返回 null */
+export function getPracticePiece(db, id) {
+    const row = queryDb(db).select().from(practiceFreePieces).where(eq(practiceFreePieces.id, id)).get();
+    return row === undefined ? null : toPieceRow(row);
+}
+/**
+ * 新建自由练习篇（`POST /practice/free`）：id = `pf-` + nanoid、`draft` = 空串、`feedback` = NULL、
+ * created_at = updated_at = 写入时刻。`topic` / `brief` 缺省 = 空串（`topic_source = "ai"` 的空题目行
+ * 正是「待出题」状态，题目由出题工具补写）；`topic` 与 `topic_source` 的一致性校验在写入侧 = 路由 schema。
+ * @returns 新行（存储形态）
+ */
+export function createPracticePiece(db, input) {
+    const now = nowIso();
+    const row = {
+        id: generateId("pf-"),
+        topic: input.topic ?? "",
+        brief: input.brief ?? "",
+        topic_source: input.topicSource,
+        draft: "",
+        feedback: null,
+        created_at: now,
+        updated_at: now,
+    };
+    queryDb(db)
+        .insert(practiceFreePieces)
+        .values({
+        id: row.id,
+        topic: row.topic,
+        brief: row.brief,
+        topic_source: row.topic_source,
+        draft: row.draft,
+        feedback: null,
+        created_at: row.created_at,
+        updated_at: row.updated_at,
+    })
+        .run();
+    return row;
+}
+/**
+ * 保存自由练习稿（`PUT /practice/free/:id`）——自由练习侧**唯一的用户写稿入口**。
+ * 口径与仿写稿完全一致（整体覆盖、允许空串、后写覆盖）：`topic` / `brief` / `feedback` 一概不动。
+ * @returns `{ updatedAt }`（版本戳）；篇不存在返回 null（路由层映射 404）
+ */
+export function updatePracticePieceDraft(db, id, draft) {
+    return withTransaction(db, () => {
+        if (getPracticePiece(db, id) === null)
+            return null;
+        const updatedAt = nowIso();
+        queryDb(db)
+            .update(practiceFreePieces)
+            .set({ draft, updated_at: updatedAt })
+            .where(eq(practiceFreePieces.id, id))
+            .run();
+        return { updatedAt };
+    });
+}
+/**
+ * 写入题目与写作要求（`submit_practice_topic` 工具的唯一落库入口）——**只写 `topic` / `brief`**，
+ * 推进 `updated_at`；用户稿 `draft` 与 `feedback` 一概不动。
+ * `brief` 省略 = 不改（工具 schema 里 brief 可选；部分更新口径：省略的字段保持原值）。
+ * 「题目非空 → 抛错拒写」的守卫在工具层（写入侧），本层只落库。
+ * @returns `{ updatedAt }`（版本戳）；篇不存在返回 null
+ */
+export function updatePracticePieceTopic(db, id, patch) {
+    return withTransaction(db, () => {
+        const existing = getPracticePiece(db, id);
+        if (existing === null)
+            return null;
+        const updatedAt = nowIso();
+        queryDb(db)
+            .update(practiceFreePieces)
+            .set({ topic: patch.topic, brief: patch.brief ?? existing.brief, updated_at: updatedAt })
+            .where(eq(practiceFreePieces.id, id))
+            .run();
+        return { updatedAt };
+    });
+}
+/**
+ * 写入自由练习点评卡（`submit_free_feedback` 工具的唯一落库入口）——**只写 `feedback`**，
+ * 推进 `updated_at`；`topic` / `brief` / `draft` 一概不动。卡体形状校验同仿写（在写入侧）。
+ * @returns `{ updatedAt }`（版本戳）；篇不存在返回 null
+ */
+export function updatePracticePieceFeedback(db, id, feedback) {
+    return withTransaction(db, () => {
+        if (getPracticePiece(db, id) === null)
+            return null;
+        const updatedAt = nowIso();
+        queryDb(db)
+            .update(practiceFreePieces)
+            .set({ feedback: JSON.stringify(feedback), updated_at: updatedAt })
+            .where(eq(practiceFreePieces.id, id))
+            .run();
+        return { updatedAt };
+    });
+}
+/**
+ * 删除自由练习篇（`DELETE /practice/free/:id`）：物理删（不满意的 AI 出题 = 删掉重建，不做覆盖式换题）。
+ * @returns 是否删掉了行（false = 篇不存在，路由层映射 404；重复删除仍返回 false 而不抛错）
+ */
+export function deletePracticePiece(db, id) {
+    return queryDb(db).delete(practiceFreePieces).where(eq(practiceFreePieces.id, id)).run().changes > 0;
+}
+// ============ 风格说明素材包（practice_style_packs） ============
+/**
+ * 取某作家的用户覆盖（`GET /practice/style-pack` 的 `customized` / `updatedAt` 与生效内容来源）。
+ * **生效内容 = 覆盖 `??` shared 预置**（回退逻辑在调用侧）。无覆盖返回 null。
+ */
+export function getStylePack(db, authorId) {
+    return queryDb(db).select().from(practiceStylePacks).where(eq(practiceStylePacks.author_id, authorId)).get() ?? null;
+}
+/**
+ * 写入用户覆盖（`PUT /practice/style-pack`）：一作家一行，存在即覆盖，`updated_at` 推进。
+ * @returns 写入后的行（存储形态）
+ */
+export function upsertStylePack(db, authorId, content) {
+    const updatedAt = nowIso();
+    queryDb(db)
+        .insert(practiceStylePacks)
+        .values({ author_id: authorId, content, updated_at: updatedAt })
+        .onConflictDoUpdate({
+        target: practiceStylePacks.author_id,
+        set: { content, updated_at: updatedAt },
+    })
+        .run();
+    return { author_id: authorId, content, updated_at: updatedAt };
+}
+/**
+ * 删除用户覆盖（`DELETE /practice/style-pack`）= **恢复预置**。
+ * @returns 是否删掉了行（false = 本来就没有覆盖——幂等口径，路由层照常返回 200 与预置内容）
+ */
+export function deleteStylePack(db, authorId) {
+    return queryDb(db).delete(practiceStylePacks).where(eq(practiceStylePacks.author_id, authorId)).run().changes > 0;
+}
+//# sourceMappingURL=practice.js.map

package/dist/queries/practice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"practice.js","sourceRoot":"","sources":["../../src/queries/practice.ts"],"names":[],"mappings":"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"}

package/dist/schema.d.ts

@@ -22,8 +22,14 @@ import type Database from "better-sqlite3";
  * 创作根配置的快照；纯 DDL 无数据搬移，存量行回填 1，migrations/010_decompose_concurrency.ts）。
  * v10 → v11（拆解功能移除，2026-09）：DROP 上述两表（拆解整功能已移除，见 CHANGELOG——
  * 009/010 保留只为旧库升级链连续；纯 DDL 无数据搬移，migrations/011_drop_decompose.ts）。
+ * v11 → v12（文风仿写练习，2026-10）：新增 `practice_targets` / `practice_samples` 两表
+ * （练习工作区专属，纯 DDL 无数据搬移——旧项目没有练习行，migrations/012_practice.ts）。
+ * v12 → v13（作家文风练习改版，2026-10）：DROP 旧 `practice_targets` / 旧 `practice_samples`
+ * （含 `idx_practice_samples_target`）→ 建 `practice_samples` 新形状 / `practice_free_pieces` /
+ * `practice_style_packs` 三表（一位预置作家 = 一个工作区，旧目标模型被整体替换；
+ * 纯 DDL 无数据搬移，migrations/013_author_practice.ts）。
  */
-export declare const SCHEMA_VERSION = 11;
+export declare const SCHEMA_VERSION = 13;
 /**
  * 建表：执行全部 DDL（CREATE TABLE/INDEX IF NOT EXISTS，定义于 tables.ts），幂等，可重复调用。
  * 打开数据库后由 connection.openDatabase 自动调用。

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAExD;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAK3E"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAExD;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAK3E"}

package/dist/schema.js

@@ -27,8 +27,14 @@ import { CREATE_TABLES_SQL } from "./tables.js";
  * 创作根配置的快照；纯 DDL 无数据搬移，存量行回填 1，migrations/010_decompose_concurrency.ts）。
  * v10 → v11（拆解功能移除，2026-09）：DROP 上述两表（拆解整功能已移除，见 CHANGELOG——
  * 009/010 保留只为旧库升级链连续；纯 DDL 无数据搬移，migrations/011_drop_decompose.ts）。
+ * v11 → v12（文风仿写练习，2026-10）：新增 `practice_targets` / `practice_samples` 两表
+ * （练习工作区专属，纯 DDL 无数据搬移——旧项目没有练习行，migrations/012_practice.ts）。
+ * v12 → v13（作家文风练习改版，2026-10）：DROP 旧 `practice_targets` / 旧 `practice_samples`
+ * （含 `idx_practice_samples_target`）→ 建 `practice_samples` 新形状 / `practice_free_pieces` /
+ * `practice_style_packs` 三表（一位预置作家 = 一个工作区，旧目标模型被整体替换；
+ * 纯 DDL 无数据搬移，migrations/013_author_practice.ts）。
  */
-export const SCHEMA_VERSION = 11; // +移除拆解两表（011 纯 DDL DROP；009/010 保留服务旧库升级链）
+export const SCHEMA_VERSION = 13; // +练习三表（013 重建：旧两表 DROP，纯 DDL）
 /**
  * 建表：执行全部 DDL（CREATE TABLE/INDEX IF NOT EXISTS，定义于 tables.ts），幂等，可重复调用。
  * 打开数据库后由 connection.openDatabase 自动调用。

package/dist/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,EAAE;AACF,kDAAkD;AAClD,oCAAoC;AACpC,kFAAkF;AAGlF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC,CAAC,4CAA4C;AAE9E;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,EAAqB;IAChD,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;AAC7B,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,cAAc,CAAC,EAAqB;IAClD,OAAO,EAAE,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAW,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAqB,EAAE,OAAe;IACnE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,oCAAoC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,EAAE,CAAC,MAAM,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,EAAE;AACF,kDAAkD;AAClD,oCAAoC;AACpC,kFAAkF;AAGlF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC,CAAC,+BAA+B;AAEjE;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,EAAqB;IAChD,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;AAC7B,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,cAAc,CAAC,EAAqB;IAClD,OAAO,EAAE,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAW,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAqB,EAAE,OAAe;IACnE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,oCAAoC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,EAAE,CAAC,MAAM,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC;AACzC,CAAC"}

package/dist/storage/project.d.ts

@@ -12,6 +12,8 @@ export declare const AGENTS_FILE_NAME = "AGENTS.md";
  * 不存在则无法合成默认值（id 需生成、name 需取目录名，属初始化逻辑）。
  *
  * 文件存在但 JSON 损坏：**抛错**，不静默重建（同 readOutlineFile 的取舍）。
+ * 工作区类型（kind）读侧容忍：缺失 / 非字符串 / 未知值均不视为有效类型（缺失不在返回对象上补键，
+ * 避免被写回盘上），有效类型由 shared `resolveWorkspaceKind()` 在消费点兜底。
  *
  * @param dir 项目根目录
  * @returns 项目配置；文件不存在返回 null

package/dist/storage/project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/storage/project.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,8BAA8B;AAC9B,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAEhD,0CAA0C;AAC1C,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAE5C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAIrE;AAuBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAE7E;AAID;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEzD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAElE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO7D"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/storage/project.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAIzE,8BAA8B;AAC9B,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAEhD,0CAA0C;AAC1C,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAE5C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAIrE;AA8BD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAE7E;AAID;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEzD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAElE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO7D"}

package/dist/storage/project.js

@@ -6,6 +6,7 @@
 // 项目规则唯一事实源 = 项目目录 （取代 project.json `prompt` 字段，不再读写）。
 import { join } from "node:path";
 import { statSync } from "node:fs";
+import { resolveWorkspaceKind } from "@whispering233/ai-editor-shared";
 import { readTextFileOrNull, writeJsonAtomic, writeTextAtomic } from "./atomic.js";
 /** project.json 文件名（项目根目录） */
 export const PROJECT_FILE_NAME = "project.json";
@@ -20,6 +21,8 @@ export const AGENTS_FILE_NAME = "AGENTS.md";
  * 不存在则无法合成默认值（id 需生成、name 需取目录名，属初始化逻辑）。
  *
  * 文件存在但 JSON 损坏：**抛错**，不静默重建（同 readOutlineFile 的取舍）。
+ * 工作区类型（kind）读侧容忍：缺失 / 非字符串 / 未知值均不视为有效类型（缺失不在返回对象上补键，
+ * 避免被写回盘上），有效类型由 shared `resolveWorkspaceKind()` 在消费点兜底。
  *
  * @param dir 项目根目录
  * @returns 项目配置；文件不存在返回 null
@@ -47,7 +50,14 @@ function validateProjectFile(parsed) {
         typeof parsed.schema_version !== "number") {
         throw new Error("project.json 顶层结构不符（需 {id:string, name:string, schema_version:number, ...}）");
     }
-    return parsed;
+    const config = parsed;
+    // 工作区类型（kind）读侧容忍：非字符串 / 未知值 → 剔出（不在此补缺省值）——补键会被
+    // PUT /project/config 的 config 展开写回盘上，把「只读兜底」变成静默迁移；
+    // 有效类型由 shared 的 resolveWorkspaceKind() 在各消费点（API 输出 / 目录映射 / 守卫）唯一兜底
+    if (config.kind !== undefined && resolveWorkspaceKind(config.kind) !== config.kind) {
+        delete config.kind;
+    }
+    return config;
 }
 /**
  * 原子写 project.json（同款流程：临时文件 + fsync + rename）。

package/dist/storage/project.js.map

@@ -1 +1 @@
-{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/storage/project.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,iFAAiF;AACjF,+CAA+C;AAC/C,4BAA4B;AAC5B,uDAAuD;AAEvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnF,8BAA8B;AAC9B,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEhD,0CAA0C;AAC1C,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAE5C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,GAAG,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC7D,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,4BAA4B;AAC3E,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,mBAAmB,CAAC,MAAe;IAC1C,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,OAAQ,MAAkC,CAAC,EAAE,KAAK,QAAQ;QAC1D,OAAQ,MAAkC,CAAC,IAAI,KAAK,QAAQ;QAC5D,OAAQ,MAAkC,CAAC,cAAc,KAAK,QAAQ,EACtE,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,MAA2B,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,MAAyB;IACrE,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,CAAC;AACxD,CAAC;AAED,mCAAmC;AAEnC;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,OAAe;IAC1D,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IACnE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAClE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/storage/project.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,iFAAiF;AACjF,+CAA+C;AAC/C,4BAA4B;AAC5B,uDAAuD;AAEvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnF,8BAA8B;AAC9B,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEhD,0CAA0C;AAC1C,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAE5C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,GAAG,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC7D,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,4BAA4B;AAC3E,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,mBAAmB,CAAC,MAAe;IAC1C,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,OAAQ,MAAkC,CAAC,EAAE,KAAK,QAAQ;QAC1D,OAAQ,MAAkC,CAAC,IAAI,KAAK,QAAQ;QAC5D,OAAQ,MAAkC,CAAC,cAAc,KAAK,QAAQ,EACtE,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;IACjG,CAAC;IACD,MAAM,MAAM,GAAG,MAA2B,CAAC;IAC5C,iDAAiD;IACjD,qDAAqD;IACrD,sEAAsE;IACrE,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;QACnF,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,MAAyB;IACrE,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,CAAC;AACxD,CAAC;AAED,mCAAmC;AAEnC;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,OAAe;IAC1D,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IACnE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAClE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}