@weiping/wingline-core 0.1.0 → 0.2.0

package/dist/spec/edit.d.ts

@@ -1,4 +1,25 @@
 type Path = Array<string | number>;
 /** 把表单的一处修改写回 YAML：`value === null` 删除该字段。 */
 export declare function setField(text: string, path: Path, value: unknown): string;
+type SpecPost = {
+    id: string;
+    agent: string;
+    model?: string;
+    launch?: string;
+    worktree?: string;
+    brief?: string[];
+};
+export type SpecEditOp = {
+    op?: 'set';
+    path: Path;
+    value: unknown;
+} | {
+    op: 'add_post';
+    post: SpecPost;
+} | {
+    op: 'remove_post';
+    index: number;
+};
+/** 把团队编辑页的一处规格修改写回 YAML：op 缺省是 set（等价 setField），add_post / remove_post 增删岗位。 */
+export declare function applySpecOp(text: string, op: SpecEditOp): string;
 export {};

package/dist/spec/edit.js

@@ -198,3 +198,139 @@ function fillEmptySections(doc, path) {
         doc.setIn(path.slice(0, i), empty);
     }
 }
+/** 解析规格文本；语法错误按输入错误报告（与 setField 同一口径）。 */
+function specDoc(text) {
+    const doc = parseDocument(text);
+    const err = doc.errors[0];
+    if (err)
+        throw new WinglineError('input', 'spec_invalid', `YAML 有语法错误：${err.message}`);
+    return doc;
+}
+/** 岗位增删都靠按行定位：posts 必须是块序列（不能是 flow 或缺失）。 */
+function postsSeq(doc) {
+    const posts = doc.get('posts', true);
+    if (!isSeq(posts) || posts.flow)
+        throw new WinglineError('input', 'spec_invalid', 'posts 必须是块序列');
+    return posts;
+}
+/** 新岗位的节点：brief 保持模板的 flow 写法，undefined 与空数组字段不写入。 */
+function postNode(doc, post) {
+    const filled = Object.fromEntries(Object.entries(post).filter(([, v]) => v !== undefined && !(Array.isArray(v) && v.length === 0)));
+    const node = doc.createNode(filled);
+    const brief = isMap(node) ? node.get('brief', true) : null;
+    if (isSeq(brief))
+        brief.flow = true;
+    return node;
+}
+/** 在 posts 末尾按最后一项的既有缩进追加新岗位；插入点之后一个字节不动。定位不了缩进时返回 null。 */
+function appendPost(text, posts, node) {
+    const map = blockMap(posts.items[posts.items.length - 1]);
+    const keyStart = map ? map.items[0].key?.range?.[0] : undefined;
+    if (!map || keyStart === undefined)
+        return null;
+    const lineBegin = lineStart(text, keyStart);
+    const indent = /^(\s*)- /.exec(text.slice(lineBegin, keyStart));
+    if (!indent)
+        return null;
+    const eol = text.includes('\r\n') ? '\r\n' : '\n';
+    const pad = ' '.repeat(indent[1].length);
+    const body = new Document(node).toString(RENDER).trimEnd().split('\n')
+        .map((l, i) => (i === 0 ? `${pad}- ${l}` : `${pad}  ${l}`)).join(eol);
+    // 插在最后一项（含它的行尾注释）那行结束之后，原有的空行与注释留在新岗位后面
+    const at = pairEnd(text, map.items[map.items.length - 1]);
+    return text.slice(0, at) + body + eol + text.slice(at);
+}
+function addPost(text, post) {
+    const doc = specDoc(text);
+    const posts = postsSeq(doc);
+    if (posts.items.some((it) => isMap(it) && it.get('id') === post.id)) {
+        throw new WinglineError('input', 'spec_invalid', `岗位 id 重复：${post.id}`);
+    }
+    const node = postNode(doc, post);
+    const out = appendPost(text, posts, node);
+    if (out !== null)
+        return out;
+    posts.add(node); // 最后一项不是块映射、算不出缩进：整篇交给 Document API，宁可重排不写坏
+    return doc.toString();
+}
+/** 整段删除 posts 的第 index 个元素：从它首键所在行的行首删到内容结束（含换行）。 */
+function deleteSeqItem(text, posts, index) {
+    const map = blockMap(posts.items[index]);
+    const keyStart = map ? map.items[0].key?.range?.[0] : undefined;
+    if (!map || keyStart === undefined)
+        return null;
+    const lineBegin = lineStart(text, keyStart);
+    if (!/^\s*-\s+$/.test(text.slice(lineBegin, keyStart)))
+        return null;
+    return text.slice(0, lineBegin) + text.slice(pairEnd(text, map.items[map.items.length - 1]));
+}
+/** 删除一个键；父映射会因此变空时连父键一起删，一次删到能按行手术的层级，少触发 Document API 整篇重排。 */
+function pruneExisting(text, path) {
+    const doc = parseDocument(text);
+    if (!doc.hasIn(path))
+        return text;
+    let cut = path;
+    for (let i = path.length - 1; i > 0; i--) {
+        const parent = doc.getIn(path.slice(0, i), true);
+        if (!isMap(parent) || parent.items.length !== 1)
+            break;
+        cut = path.slice(0, i);
+    }
+    return setField(text, cut, null);
+}
+/** 从其余岗位的 links.*.(reviewed_by|hands_to|consults) 数组里剔除被删 id；剔空的数组连键清掉。 */
+function stripPostRefs(text, doc, removedId) {
+    const links = doc.get('links', true);
+    let out = text;
+    if (!isMap(links) || links.flow)
+        return out;
+    for (const pair of links.items) {
+        const postId = keyText(pair);
+        const rels = isMap(pair.value) && !pair.value.flow ? pair.value : null;
+        if (!postId || postId === removedId || !rels)
+            continue;
+        for (const rel of rels.items) {
+            const name = keyText(rel);
+            if (!name || !['reviewed_by', 'hands_to', 'consults'].includes(name) || !isSeq(rel.value))
+                continue;
+            const kept = rel.value.items.filter((n) => !(isScalar(n) && n.value === removedId)).map((n) => n.value);
+            if (kept.length === rel.value.items.length)
+                continue;
+            out = kept.length > 0 ? setField(out, ['links', postId, name], kept) : pruneExisting(out, ['links', postId, name]);
+        }
+    }
+    return out;
+}
+function removePost(text, index) {
+    const doc = specDoc(text);
+    const posts = postsSeq(doc);
+    if (posts.items.length <= 1)
+        throw new WinglineError('input', 'spec_invalid', '团队至少保留一个岗位');
+    if (!Number.isInteger(index) || !posts.items[index])
+        throw new WinglineError('input', 'spec_invalid', `岗位下标不合法：${index}`);
+    const removedId = isMap(posts.items[index]) ? posts.items[index].get('id') : undefined;
+    const firstLeft = posts.items[index === 0 ? 1 : 0];
+    const nextLead = isMap(firstLeft) ? firstLeft.get('id') : undefined;
+    const cut = deleteSeqItem(text, posts, index);
+    let out = cut;
+    if (out === null) {
+        doc.deleteIn(['posts', index]); // 被删项不是块映射、行定位不了：整篇交给 Document API，宁可重排不写坏
+        out = doc.toString();
+    }
+    if (typeof removedId === 'string') {
+        out = pruneExisting(out, ['links', removedId]);
+        out = pruneExisting(out, ['gates', removedId]);
+        out = stripPostRefs(out, doc, removedId);
+    }
+    if (typeof nextLead === 'string' && doc.get('lead') === removedId)
+        out = setField(out, ['lead'], nextLead);
+    return out;
+}
+/** 把团队编辑页的一处规格修改写回 YAML：op 缺省是 set（等价 setField），add_post / remove_post 增删岗位。 */
+export function applySpecOp(text, op) {
+    if (op.op === 'add_post')
+        return addPost(text, op.post);
+    if (op.op === 'remove_post')
+        return removePost(text, op.index);
+    return setField(text, op.path, op.value);
+}

package/dist/spec/facade.d.ts

@@ -0,0 +1,41 @@
+import { type SaveSpecArgs, type SpecEditResult, type SpecForEdit } from '../commands/spec.js';
+import type { CommandDeps } from '../commands/deps.js';
+import type { SpecEditOp } from '../spec/edit.js';
+import type { SpecPlan } from '../spec/plan-change.js';
+export type { SpecEditResult, SpecForEdit, SpecEditOp, SpecPlan, SaveSpecArgs };
+/** 一次 validate 的入参（不含 team，由调用方传入团队名）。 */
+export interface SpecValidateInput {
+    yaml: string;
+    set?: SpecEditOp;
+    files?: Record<string, string>;
+}
+/** 一次 save 的入参（不含 team）；审计走 audited save。 */
+export interface SpecSaveInput extends Omit<SaveSpecArgs, 'team'> {
+}
+/**
+ * 团队规格编辑门面：读盘走现有 command，写操作走审计包装。
+ * 由插件 worker、测试与后续 Phase 3 面板共用。
+ */
+export declare function createSpecFacade(deps: CommandDeps): {
+    /** 加载编辑器：YAML、草稿、哈希、引用文档正文。 */
+    readForEdit(team: string): SpecForEdit;
+    /** 校验并预演；不写任何文件。 */
+    validate(team: string, input: SpecValidateInput): SpecEditResult;
+    /** 保存规格（及文档）；写入审计（command: spec save）。 */
+    save(team: string, input: SpecSaveInput): Promise<{
+        wrote: "draft" | "spec";
+        path: string;
+        hash: string;
+        docsUpdated: string[];
+    }>;
+    /** 丢弃草稿。 */
+    discardDraft(team: string, retryRequest?: string): Promise<{
+        discarded: boolean;
+    }>;
+    /** 规格目录下某引用文档的绝对路径（越界路径会被 core 拒绝）。 */
+    resolveDoc(team: string, rel: string): string | null;
+    /** 读取 NORMS / brief 等引用文档正文。 */
+    readDoc(team: string, rel: string): string | null;
+    /** 写入引用文档（原子写）；一般由 save 一并处理。 */
+    writeDoc(team: string, rel: string, content: string): void;
+};

package/dist/spec/facade.js

@@ -0,0 +1,68 @@
+import path from 'node:path';
+import { auditedCommands } from '../audit.js';
+import { coreAuditTable } from '../audit-table.js';
+import { discardDraftCmd, readSpecForEdit, saveSpecCmd, validateSpecEdit, } from '../commands/spec.js';
+import { readDocText, resolveDocPath, writeDocAtomic } from '../spec/doc.js';
+const facaded = (deps) => auditedCommands({ saveSpecCmd, discardDraftCmd }, coreAuditTable(), { actor: 'human' });
+/**
+ * 团队规格编辑门面：读盘走现有 command，写操作走审计包装。
+ * 由插件 worker、测试与后续 Phase 3 面板共用。
+ */
+export function createSpecFacade(deps) {
+    const audited = facaded(deps);
+    function specDir(team) {
+        const row = deps.registry.getTeam(team);
+        if (!row)
+            return null;
+        return path.dirname(row.specPath);
+    }
+    return {
+        /** 加载编辑器：YAML、草稿、哈希、引用文档正文。 */
+        readForEdit(team) {
+            return readSpecForEdit(deps, team);
+        },
+        /** 校验并预演；不写任何文件。 */
+        validate(team, input) {
+            return validateSpecEdit(deps, { team, ...input });
+        },
+        /** 保存规格（及文档）；写入审计（command: spec save）。 */
+        async save(team, input) {
+            return audited.saveSpecCmd(deps, { team, ...input });
+        },
+        /** 丢弃草稿。 */
+        async discardDraft(team, retryRequest) {
+            return audited.discardDraftCmd(deps, { team, retryRequest });
+        },
+        /** 规格目录下某引用文档的绝对路径（越界路径会被 core 拒绝）。 */
+        resolveDoc(team, rel) {
+            const dir = specDir(team);
+            if (!dir)
+                return null;
+            try {
+                return resolveDocPath(dir, rel);
+            }
+            catch {
+                return null;
+            }
+        },
+        /** 读取 NORMS / brief 等引用文档正文。 */
+        readDoc(team, rel) {
+            const dir = specDir(team);
+            if (!dir)
+                return null;
+            try {
+                return readDocText(resolveDocPath(dir, rel));
+            }
+            catch {
+                return null;
+            }
+        },
+        /** 写入引用文档（原子写）；一般由 save 一并处理。 */
+        writeDoc(team, rel, content) {
+            const dir = specDir(team);
+            if (!dir)
+                throw new Error(`团队 ${team} 未登记`);
+            writeDocAtomic(resolveDocPath(dir, rel), content);
+        },
+    };
+}

package/dist/spec/load.d.ts

@@ -66,6 +66,7 @@ export type SpecError = {
 /** 从字符串校验团队规格；文件引用相对 specPath 所在目录解析。错误至多一条（遇到第一处即停）。 */
 export declare function validateSpecText(text: string, specPath: string, o?: {
     platform?: NodeJS.Platform;
+    virtualFiles?: ReadonlySet<string>;
 }): {
     spec: TeamSpec | null;
     parsed: unknown | null;

package/dist/spec/load.js

@@ -175,9 +175,10 @@ function launchOf(p, i, at) {
         return `${p.agent} --model ${p.model}`;
     return at.fail('launch_required', ['posts', i, 'model'], `agent ${p.agent} 指定了 model，请用 launch 指定完整启动命令`);
 }
-function resolveFile(dir, rel, at, p) {
+function resolveFile(dir, rel, at, p, virtualFiles) {
     const abs = path.resolve(dir, toPosix(rel));
-    if (!fs.existsSync(abs))
+    // 编辑器里新引用的文档还没落盘：以虚拟文件表的存在性为准（rel 按 YAML 原样归一到 / 后比较）
+    if (!fs.existsSync(abs) && !virtualFiles?.has(toPosix(rel)))
         at.fail('file_missing', p, `找不到文件 ${rel}（解析为 ${abs}）`);
     return abs;
 }
@@ -198,7 +199,7 @@ export function validateSpecText(text, specPath, o = {}) {
         return { spec: null, parsed: null, errors: [toError(e)] };
     }
     try {
-        return { spec: specFromRaw(parsed.raw, parsed.at, abs, o.platform ?? process.platform), parsed: parsed.raw, errors: [] };
+        return { spec: specFromRaw(parsed.raw, parsed.at, abs, o.platform ?? process.platform, o.virtualFiles), parsed: parsed.raw, errors: [] };
     }
     catch (e) {
         return { spec: null, parsed: parsed.raw, errors: [toError(e)] };
@@ -216,7 +217,7 @@ export function loadTeamSpec(specPath, o = {}) {
     const { raw, at } = parseYamlText(source, abs);
     return specFromRaw(raw, at, abs, o.platform ?? process.platform);
 }
-function specFromRaw(raw, at, abs, platform) {
+function specFromRaw(raw, at, abs, platform, virtualFiles) {
     const dir = path.dirname(abs);
     const team = validate(raw, at);
     crossCheck(team, at);
@@ -224,7 +225,7 @@ function specFromRaw(raw, at, abs, platform) {
         version: 1,
         name: team.name,
         repo: team.repo,
-        normsPath: resolveFile(dir, team.norms, at, ['norms']),
+        normsPath: resolveFile(dir, team.norms, at, ['norms'], virtualFiles),
         lead: team.lead,
         posts: team.posts.map((p, i) => ({
             id: p.id,
@@ -233,7 +234,7 @@ function specFromRaw(raw, at, abs, platform) {
             launch: launchOf(p, i, at),
             ...environmentOf(p, i, at),
             worktree: p.worktree,
-            briefPaths: p.brief.map((b, j) => resolveFile(dir, b, at, ['posts', i, 'brief', j])),
+            briefPaths: p.brief.map((b, j) => resolveFile(dir, b, at, ['posts', i, 'brief', j], virtualFiles)),
             selfClaim: p.self_claim,
             tags: p.tags,
             planFirst: p.plan_first,

package/dist/spec/plan-change.js

@@ -18,10 +18,11 @@ function snakeKeys(v) {
         return v;
     return Object.fromEntries(Object.entries(v).map(([k, x]) => [snake(k), snakeKeys(x)]));
 }
-/** 把 TeamSpec 还原成 YAML 里的字段形态，供按字段比较。 */
+/** 把 TeamSpec 还原成 YAML 里的字段形态，供按字段比较。岗位级字段（plan_first / self_claim / tags）也进哈希，预演必须同样列出。 */
 function fieldView(s) {
     const links = {};
     const gates = {};
+    const posts = {};
     for (const p of s.posts) {
         const l = { reviewed_by: p.reviewedBy, hands_to: p.handsTo, consults: p.consults ?? [] };
         const filled = Object.fromEntries(Object.entries(l).filter(([, v]) => v.length > 0));
@@ -29,8 +30,9 @@ function fieldView(s) {
             links[p.id] = filled;
         if (p.gate)
             gates[p.id] = p.gate;
+        posts[p.id] = { plan_first: p.planFirst, self_claim: p.selfClaim, tags: p.tags };
     }
-    return { lead: s.lead, links, gates, budgets: snakeKeys(s.budgets), patrol: snakeKeys(s.patrol) };
+    return { lead: s.lead, links, gates, budgets: snakeKeys(s.budgets), patrol: snakeKeys(s.patrol), posts };
 }
 function flatten(v, prefix, out) {
     if (v && typeof v === 'object' && !Array.isArray(v) && Object.keys(v).length > 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weiping/wingline-core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Wingline 核心：在 Orca 之上运行常驻 agent 团队的引擎（注册表、编排、巡查、恢复）",
   "license": "MIT",
   "type": "module",