@xdxer/dingtalk-agent 0.1.4-beta.8 → 0.1.4

package/dist/src/memory/candidates.js

@@ -0,0 +1,451 @@
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync, } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join, relative, resolve } from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { digest, stableStringify } from '../events.js';
+import { acquireLease } from '../lease.js';
+import * as dws from '../dws.js';
+export function proposeMemoryCandidate(root, value, options = {}) {
+    const proposal = validateProposal(value);
+    const run = proposerContext(root, options.runPath);
+    if (run && proposal.scopeId !== run.contextId) {
+        throw new Error(`Memory Candidate scopeId=${proposal.scopeId} 与 Prepared Run contextId=${run.contextId} 不一致`);
+    }
+    const id = `memcand_${digest(stableStringify(proposal)).slice(0, 24)}`;
+    const rootPath = candidateRoot(root, options.stateDir, Boolean(run));
+    const path = join(rootPath, `${id}.json`);
+    const release = acquireLease(`${path}.lock`, `Memory Candidate ${id} 正在创建`, {
+        waitMs: 3_000, staleAfterMs: 2 * 60_000,
+    });
+    try {
+        if (existsSync(path)) {
+            const existing = readCandidate(path);
+            return { $schema: 'dingtalk-agent/memory-candidate-result@1', duplicate: true,
+                path, candidate: existing };
+        }
+        const now = new Date().toISOString();
+        const unsigned = {
+            $schema: 'dingtalk-agent/memory-candidate@1',
+            id,
+            revision: 1,
+            kind: proposal.kind,
+            scopeId: proposal.scopeId,
+            title: proposal.title,
+            content: proposal.content,
+            sourceRefs: proposal.sourceRefs,
+            confidence: proposal.confidence,
+            supersedes: proposal.supersedes,
+            status: 'proposed',
+            proposedAt: now,
+            proposer: run ? {
+                mode: 'prepared', runId: run.id, eventId: run.eventId,
+                definitionHash: run.definition?.hash || '',
+            } : { mode: 'direct', runId: '', eventId: '', definitionHash: '' },
+            review: null,
+            publication: null,
+        };
+        const candidate = signCandidate(unsigned);
+        writeJsonAtomic(path, candidate);
+        return { $schema: 'dingtalk-agent/memory-candidate-result@1', duplicate: false,
+            path, candidate: readCandidate(path) };
+    }
+    finally {
+        release();
+    }
+}
+export function showMemoryCandidate(root, id, options = {}) {
+    const path = candidatePath(root, id, options.stateDir);
+    if (!existsSync(path))
+        throw new Error(`找不到 Memory Candidate: ${id}`);
+    return { $schema: 'dingtalk-agent/memory-candidate-result@1', duplicate: false,
+        path, candidate: readCandidate(path) };
+}
+export function reviewMemoryCandidate(root, id, decision, reviewer, reason, expectedRevision, options = {}) {
+    assertOffline('review', options.runPath);
+    if (!['approve', 'reject'].includes(decision))
+        throw new Error('review decision 只能是 approve/reject');
+    if (!clean(reviewer) || !clean(reason))
+        throw new Error('review 需要 reviewer 和 reason');
+    const path = candidatePath(root, id, options.stateDir);
+    const release = acquireLease(`${path}.lock`, `Memory Candidate ${id} 正在评审`, {
+        waitMs: 3_000, staleAfterMs: 2 * 60_000,
+    });
+    try {
+        const current = readCandidate(path);
+        assertCandidateRevision(current, expectedRevision);
+        if (current.status !== 'proposed') {
+            throw new Error(`Memory Candidate ${id} 当前状态是 ${current.status}，不能再次评审`);
+        }
+        const unsigned = {
+            ...withoutHash(current),
+            revision: current.revision + 1,
+            status: decision === 'approve' ? 'approved' : 'rejected',
+            review: {
+                decision,
+                reviewer: clean(reviewer),
+                reason: clean(reason),
+                reviewedAt: new Date().toISOString(),
+            },
+        };
+        const candidate = signCandidate(unsigned);
+        writeJsonAtomic(path, candidate);
+        return { $schema: 'dingtalk-agent/memory-candidate-result@1', duplicate: false,
+            path, candidate: readCandidate(path) };
+    }
+    finally {
+        release();
+    }
+}
+export function publishMemoryCandidate(root, id, targetValue, expectedRevision, expectedTargetHash = '', options = {}) {
+    if (options.execute)
+        assertOffline('publish', options.runPath);
+    const target = validateTarget(targetValue);
+    const path = candidatePath(root, id, options.stateDir);
+    const release = acquireLease(`${path}.lock`, `Memory Candidate ${id} 正在发布`, {
+        waitMs: 3_000, staleAfterMs: 10 * 60_000,
+    });
+    try {
+        const current = readCandidate(path);
+        assertCandidateRevision(current, expectedRevision);
+        if (!['approved', 'published'].includes(current.status)) {
+            throw new Error(`Memory Candidate ${id} 状态为 ${current.status}，必须先 approve`);
+        }
+        if (current.status === 'published' && current.publication?.uri !== target.uri) {
+            throw new Error(`Memory Candidate ${id} 已发布到 ${current.publication?.uri || '-'}，不能静默换目标`);
+        }
+        const targetContext = readPublishTarget(root, target);
+        const block = renderCandidate(current);
+        const markerCount = countMarker(targetContext.content, current.id);
+        const concurrency = target.provider === 'local-md'
+            ? 'atomic-local-cas' : 'best-effort-read-check-append';
+        const base = {
+            $schema: 'dingtalk-agent/memory-publish-result@1',
+            sideEffect: false,
+            verified: false,
+            duplicate: false,
+            candidateId: current.id,
+            candidateRevision: current.revision,
+            provider: target.provider,
+            uri: target.uri,
+            currentTargetHash: targetContext.hash,
+            targetHashAfter: '',
+            markerCount,
+            verification: 'dry-run-target-inspected',
+            concurrency,
+            candidate: current,
+        };
+        if (!options.execute)
+            return { ...base, mode: 'dry-run' };
+        if (!options.yes)
+            throw new Error('Memory Candidate 发布必须显式 --yes');
+        if (!expectedTargetHash || expectedTargetHash !== targetContext.hash) {
+            throw new Error(`发布目标 hash 冲突：expected=${expectedTargetHash || '-'}, actual=${targetContext.hash}；` +
+                '请重新 dry-run 并人工检查差异');
+        }
+        if (markerCount > 1) {
+            return { ...base, mode: 'uncertain', verification: 'duplicate-candidate-markers' };
+        }
+        let published;
+        if (target.provider === 'local-md') {
+            published = publishLocal(targetContext.path, targetContext.content, block, current.id);
+        }
+        else {
+            if (!options.live)
+                throw new Error('钉钉文档发布必须显式 --live --yes');
+            published = publishDingTalkDoc(target, targetContext.content, block, current.id);
+        }
+        if (!published.verified) {
+            return {
+                ...base,
+                mode: 'uncertain',
+                sideEffect: published.sideEffect,
+                duplicate: published.duplicate,
+                targetHashAfter: published.hash,
+                markerCount: published.markerCount,
+                verification: published.verification,
+            };
+        }
+        const publication = {
+            provider: target.provider,
+            uri: target.uri,
+            targetHashBefore: targetContext.hash,
+            targetHashAfter: published.hash,
+            verification: published.verification,
+            concurrency,
+            publishedAt: new Date().toISOString(),
+            gitHead: target.provider === 'local-md' ? readGitHead(root) : '',
+        };
+        const candidate = current.status === 'published'
+            ? current
+            : signCandidate({
+                ...withoutHash(current),
+                revision: current.revision + 1,
+                status: 'published',
+                publication,
+            });
+        if (current.status !== 'published')
+            writeJsonAtomic(path, candidate);
+        return {
+            ...base,
+            mode: 'published',
+            sideEffect: published.sideEffect,
+            verified: true,
+            duplicate: published.duplicate,
+            candidateRevision: candidate.revision,
+            targetHashAfter: published.hash,
+            markerCount: published.markerCount,
+            verification: published.verification,
+            candidate: readCandidate(path),
+        };
+    }
+    finally {
+        release();
+    }
+}
+function publishLocal(path, content, block, candidateId) {
+    const release = acquireLease(`${path}.dta-publish.lock`, `发布目标 ${path} 正在更新`, {
+        waitMs: 3_000, staleAfterMs: 10 * 60_000,
+    });
+    try {
+        const latest = readFileSync(path, 'utf8');
+        if (latest !== content)
+            throw new Error('本地发布目标在加锁前发生漂移，请重新 dry-run');
+        const existing = countMarker(latest, candidateId);
+        const next = existing === 1 ? latest : appendBlock(latest, block);
+        if (!existing)
+            writeTextAtomic(path, next);
+        const readback = readFileSync(path, 'utf8');
+        const markerCount = countMarker(readback, candidateId);
+        const verified = markerCount === 1 && readback.includes(block.trim());
+        return {
+            verified,
+            sideEffect: !existing,
+            duplicate: existing === 1,
+            hash: digest(readback),
+            markerCount,
+            verification: verified ? 'local-atomic-write-readback' : 'local-readback-mismatch',
+        };
+    }
+    finally {
+        release();
+    }
+}
+function publishDingTalkDoc(target, content, block, candidateId) {
+    const profile = clean(target.profile || process.env.DTA_DWS_PROFILE);
+    const expectedUserId = clean(target.expectedUserId || process.env.DTA_EXPECTED_USER_ID);
+    if (!profile || profile.includes(',') || !expectedUserId) {
+        throw new Error('dingtalk-doc 发布必须固定单一 profile 和 expectedUserId');
+    }
+    const identity = dws.getSelf(profile);
+    const actualUserId = String(findValue(identity, ['userId', 'user_id', 'userid']) || '');
+    if (!actualUserId || actualUserId !== expectedUserId) {
+        throw new Error(`DWS 执行身份不符：expected=${expectedUserId}, actual=${actualUserId || '-'}`);
+    }
+    const existing = countMarker(content, candidateId);
+    let sideEffect = false;
+    if (!existing) {
+        const directory = mkdtempSync(join(tmpdir(), 'dta-memory-publish-'));
+        const file = join(directory, 'candidate.md');
+        try {
+            writeFileSync(file, block);
+            dws.appendDoc(target.uri.slice('dingtalk-doc:'.length), file, profile);
+            sideEffect = true;
+        }
+        finally {
+            rmSync(directory, { recursive: true, force: true });
+        }
+    }
+    const readback = String(dws.readDoc(target.uri.slice('dingtalk-doc:'.length), profile));
+    const markerCount = countMarker(readback, candidateId);
+    const verified = markerCount === 1 && dws.words(readback).includes(dws.words(block));
+    return {
+        verified,
+        sideEffect,
+        duplicate: existing === 1,
+        hash: digest(readback),
+        markerCount,
+        verification: verified
+            ? 'dingtalk-doc-append-full-readback' : 'dingtalk-doc-readback-mismatch',
+    };
+}
+function readPublishTarget(root, target) {
+    if (target.provider === 'local-md') {
+        const ref = target.uri.slice('local-md:'.length);
+        const rootReal = realpathSync(resolve(root));
+        const path = realpathSync(resolve(rootReal, ref));
+        assertInside(rootReal, path, 'local-md 发布目标');
+        const content = readFileSync(path, 'utf8');
+        return { path, content, hash: digest(content) };
+    }
+    const ref = target.uri.slice('dingtalk-doc:'.length);
+    const profile = clean(target.profile || process.env.DTA_DWS_PROFILE);
+    if (!ref)
+        throw new Error('dingtalk-doc 发布目标缺少 node/url');
+    const info = dws.docInfo(ref, profile);
+    if (String(info?.contentType || '').toUpperCase() !== 'ALIDOC' ||
+        String(info?.extension || '').toLowerCase() !== 'adoc') {
+        throw new Error('dingtalk-doc 发布目标必须是在线文档 adoc');
+    }
+    const content = String(dws.readDoc(ref, profile));
+    return { path: '', content, hash: digest(content) };
+}
+function renderCandidate(candidate) {
+    return `\n> DTA Candidate: \`${candidate.id}\`\n\n` +
+        `## ${candidate.title}\n\n` +
+        `- Kind: ${candidate.kind}\n` +
+        `- Scope: ${candidate.scopeId}\n` +
+        `- Confidence: ${candidate.confidence}\n` +
+        `- Sources: ${candidate.sourceRefs.join(', ')}\n` +
+        `- Supersedes: ${candidate.supersedes.join(', ') || '-'}\n\n` +
+        `${candidate.content.trim()}\n`;
+}
+function appendBlock(content, block) {
+    return `${content.trimEnd()}\n${block.startsWith('\n') ? block : `\n${block}`}`;
+}
+function countMarker(content, candidateId) {
+    return content.split(candidateId).length - 1;
+}
+function validateProposal(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Memory Candidate proposal 必须是 JSON object');
+    }
+    const input = value;
+    const allowed = new Set([
+        '$schema', 'kind', 'scopeId', 'title', 'content', 'sourceRefs', 'confidence', 'supersedes',
+    ]);
+    const extra = Object.keys(input).filter((key) => !allowed.has(key));
+    if (extra.length)
+        throw new Error(`Memory Candidate proposal 含未知字段: ${extra.join(', ')}`);
+    if (input.$schema !== 'dingtalk-agent/memory-candidate-proposal@1' ||
+        !['semantic', 'procedural'].includes(input.kind)) {
+        throw new Error('Memory Candidate proposal schema/kind 非法');
+    }
+    for (const key of ['scopeId', 'title', 'content']) {
+        if (!clean(input[key]))
+            throw new Error(`Memory Candidate proposal 缺少 ${key}`);
+    }
+    if (Buffer.byteLength(input.content, 'utf8') > 32 * 1024) {
+        throw new Error('Memory Candidate content 超过 32 KiB');
+    }
+    for (const key of ['sourceRefs', 'supersedes']) {
+        if (!Array.isArray(input[key]) || input[key].some((item) => !clean(item))) {
+            throw new Error(`Memory Candidate ${key} 必须是非空字符串数组`);
+        }
+    }
+    if (!input.sourceRefs.length)
+        throw new Error('Memory Candidate 至少需要一条 sourceRef');
+    if (typeof input.confidence !== 'number' || input.confidence < 0 || input.confidence > 1) {
+        throw new Error('Memory Candidate confidence 必须在 0..1');
+    }
+    return JSON.parse(JSON.stringify(input));
+}
+function validateTarget(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Memory publish target 必须是 JSON object');
+    }
+    const input = value;
+    const allowed = new Set(['$schema', 'provider', 'uri', 'profile', 'expectedUserId']);
+    const extra = Object.keys(input).filter((key) => !allowed.has(key));
+    if (extra.length)
+        throw new Error(`Memory publish target 含未知字段: ${extra.join(', ')}`);
+    if (input.$schema !== 'dingtalk-agent/memory-publish-target@1' ||
+        !['local-md', 'dingtalk-doc'].includes(input.provider)) {
+        throw new Error('Memory publish target schema/provider 非法');
+    }
+    if (!clean(input.uri) || !input.uri.startsWith(`${input.provider}:`)) {
+        throw new Error(`Memory publish target uri 必须以 ${input.provider}: 开头`);
+    }
+    return JSON.parse(JSON.stringify(input));
+}
+function candidateRoot(root, stateDir = '', prepared = false) {
+    const base = resolve(root, stateDir || process.env.DTA_STATE_DIR || '.dingtalk-agent');
+    if (prepared)
+        assertInside(resolve(root, '.dingtalk-agent'), base, 'Prepared candidate stateDir');
+    const path = join(base, 'memory', 'candidates');
+    mkdirSync(path, { recursive: true });
+    return path;
+}
+function candidatePath(root, id, stateDir = '') {
+    if (!/^memcand_[a-f0-9]{24}$/.test(id))
+        throw new Error(`Memory Candidate ID 非法: ${id}`);
+    return join(candidateRoot(root, stateDir, false), `${id}.json`);
+}
+function proposerContext(root, runInput = '') {
+    const value = clean(runInput || process.env.DTA_RUN);
+    if (!value)
+        return null;
+    const rootReal = realpathSync(resolve(root));
+    const runPath = realpathSync(resolve(value));
+    assertInside(rootReal, runPath, 'Prepared Run');
+    const run = JSON.parse(readFileSync(join(runPath, 'run.json'), 'utf8'));
+    if (!run.id || !run.contextId || !run.definition?.hash) {
+        throw new Error('Prepared Run 缺少 id/contextId/definition hash');
+    }
+    return run;
+}
+function readCandidate(path) {
+    if (!existsSync(path))
+        throw new Error(`找不到 Memory Candidate: ${path}`);
+    const value = JSON.parse(readFileSync(path, 'utf8'));
+    const { hash, ...unsigned } = value;
+    if (!hash || hash !== digest(stableStringify(unsigned))) {
+        throw new Error(`Memory Candidate hash 不一致: ${value.id || path}`);
+    }
+    return value;
+}
+function signCandidate(unsigned) {
+    return { ...unsigned, hash: digest(stableStringify(unsigned)) };
+}
+function withoutHash(candidate) {
+    const { hash: _hash, ...unsigned } = candidate;
+    return unsigned;
+}
+function assertCandidateRevision(candidate, expected) {
+    if (!Number.isInteger(expected) || expected < 1 || candidate.revision !== expected) {
+        throw new Error(`Memory Candidate revision 冲突：expected=${expected}, actual=${candidate.revision}`);
+    }
+}
+function assertOffline(action, runPath = '') {
+    if (process.env.DTA_RUN || runPath) {
+        throw new Error(`在线 Prepared Run 只能 propose，不能 ${action} Memory Candidate`);
+    }
+}
+function assertInside(root, path, label) {
+    const rel = relative(resolve(root), resolve(path));
+    if (rel === '..' || rel.startsWith(`..${process.platform === 'win32' ? '\\' : '/'}`)) {
+        throw new Error(`${label} 必须位于允许的 root 内`);
+    }
+}
+function readGitHead(root) {
+    const run = spawnSync('git', ['-C', root, 'rev-parse', 'HEAD'], {
+        encoding: 'utf8', timeout: 2_000,
+    });
+    return run.status === 0 ? String(run.stdout || '').trim() : '';
+}
+function findValue(value, keys) {
+    if (!value || typeof value !== 'object')
+        return null;
+    for (const [key, child] of Object.entries(value)) {
+        if (keys.includes(key) && child !== undefined && child !== null && child !== '')
+            return child;
+    }
+    for (const child of Object.values(value)) {
+        const found = findValue(child, keys);
+        if (found !== null)
+            return found;
+    }
+    return null;
+}
+function writeJsonAtomic(path, value) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeTextAtomic(path, JSON.stringify(value, null, 2) + '\n');
+}
+function writeTextAtomic(path, value) {
+    const temp = `${path}.${process.pid}.${Date.now()}.tmp`;
+    writeFileSync(temp, value, { flag: 'wx' });
+    renameSync(temp, path);
+}
+function clean(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+//# sourceMappingURL=candidates.js.map

package/dist/src/memory/candidates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidates.js","sourceRoot":"","sources":["../../../src/memory/candidates.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  existsSync, mkdirSync, mkdtempSync, readFileSync, realpathSync, renameSync, rmSync,\n  writeFileSync,\n} from 'node:fs'\nimport { tmpdir } from 'node:os'\nimport { dirname, join, relative, resolve } from 'node:path'\nimport { spawnSync } from 'node:child_process'\nimport { digest, stableStringify } from '../events.js'\nimport { acquireLease } from '../lease.js'\nimport * as dws from '../dws.js'\n\nexport interface MemoryCandidateProposal {\n  $schema: 'dingtalk-agent/memory-candidate-proposal@1'\n  kind: 'semantic' | 'procedural'\n  scopeId: string\n  title: string\n  content: string\n  sourceRefs: string[]\n  confidence: number\n  supersedes: string[]\n}\n\nexport interface MemoryCandidate {\n  $schema: 'dingtalk-agent/memory-candidate@1'\n  id: string\n  revision: number\n  kind: 'semantic' | 'procedural'\n  scopeId: string\n  title: string\n  content: string\n  sourceRefs: string[]\n  confidence: number\n  supersedes: string[]\n  status: 'proposed' | 'approved' | 'rejected' | 'published'\n  proposedAt: string\n  proposer: {\n    mode: 'prepared' | 'direct'\n    runId: string\n    eventId: string\n    definitionHash: string\n  }\n  review: null | {\n    decision: 'approve' | 'reject'\n    reviewer: string\n    reason: string\n    reviewedAt: string\n  }\n  publication: null | {\n    provider: 'local-md' | 'dingtalk-doc'\n    uri: string\n    targetHashBefore: string\n    targetHashAfter: string\n    verification: string\n    concurrency: 'atomic-local-cas' | 'best-effort-read-check-append'\n    publishedAt: string\n    gitHead: string\n  }\n  hash: string\n}\n\nexport interface MemoryPublishTarget {\n  $schema: 'dingtalk-agent/memory-publish-target@1'\n  provider: 'local-md' | 'dingtalk-doc'\n  uri: string\n  profile?: string\n  expectedUserId?: string\n}\n\nexport interface CandidateOptions {\n  stateDir?: string\n  runPath?: string\n}\n\nexport interface CandidateResult {\n  $schema: 'dingtalk-agent/memory-candidate-result@1'\n  duplicate: boolean\n  path: string\n  candidate: MemoryCandidate\n}\n\nexport interface CandidatePublishResult {\n  $schema: 'dingtalk-agent/memory-publish-result@1'\n  mode: 'dry-run' | 'published' | 'uncertain'\n  sideEffect: boolean\n  verified: boolean\n  duplicate: boolean\n  candidateId: string\n  candidateRevision: number\n  provider: 'local-md' | 'dingtalk-doc'\n  uri: string\n  currentTargetHash: string\n  targetHashAfter: string\n  markerCount: number\n  verification: string\n  concurrency: 'atomic-local-cas' | 'best-effort-read-check-append'\n  candidate: MemoryCandidate\n}\n\nexport function proposeMemoryCandidate(\n  root: string,\n  value: unknown,\n  options: CandidateOptions = {},\n): CandidateResult {\n  const proposal = validateProposal(value)\n  const run = proposerContext(root, options.runPath)\n  if (run && proposal.scopeId !== run.contextId) {\n    throw new Error(\n      `Memory Candidate scopeId=${proposal.scopeId} 与 Prepared Run contextId=${run.contextId} 不一致`,\n    )\n  }\n  const id = `memcand_${digest(stableStringify(proposal)).slice(0, 24)}`\n  const rootPath = candidateRoot(root, options.stateDir, Boolean(run))\n  const path = join(rootPath, `${id}.json`)\n  const release = acquireLease(`${path}.lock`, `Memory Candidate ${id} 正在创建`, {\n    waitMs: 3_000, staleAfterMs: 2 * 60_000,\n  })\n  try {\n    if (existsSync(path)) {\n      const existing = readCandidate(path)\n      return { $schema: 'dingtalk-agent/memory-candidate-result@1', duplicate: true,\n        path, candidate: existing }\n    }\n    const now = new Date().toISOString()\n    const unsigned: Omit<MemoryCandidate, 'hash'> = {\n      $schema: 'dingtalk-agent/memory-candidate@1',\n      id,\n      revision: 1,\n      kind: proposal.kind,\n      scopeId: proposal.scopeId,\n      title: proposal.title,\n      content: proposal.content,\n      sourceRefs: proposal.sourceRefs,\n      confidence: proposal.confidence,\n      supersedes: proposal.supersedes,\n      status: 'proposed',\n      proposedAt: now,\n      proposer: run ? {\n        mode: 'prepared', runId: run.id, eventId: run.eventId,\n        definitionHash: run.definition?.hash || '',\n      } : { mode: 'direct', runId: '', eventId: '', definitionHash: '' },\n      review: null,\n      publication: null,\n    }\n    const candidate = signCandidate(unsigned)\n    writeJsonAtomic(path, candidate)\n    return { $schema: 'dingtalk-agent/memory-candidate-result@1', duplicate: false,\n      path, candidate: readCandidate(path) }\n  } finally {\n    release()\n  }\n}\n\nexport function showMemoryCandidate(\n  root: string,\n  id: string,\n  options: CandidateOptions = {},\n): CandidateResult {\n  const path = candidatePath(root, id, options.stateDir)\n  if (!existsSync(path)) throw new Error(`找不到 Memory Candidate: ${id}`)\n  return { $schema: 'dingtalk-agent/memory-candidate-result@1', duplicate: false,\n    path, candidate: readCandidate(path) }\n}\n\nexport function reviewMemoryCandidate(\n  root: string,\n  id: string,\n  decision: 'approve' | 'reject',\n  reviewer: string,\n  reason: string,\n  expectedRevision: number,\n  options: CandidateOptions = {},\n): CandidateResult {\n  assertOffline('review', options.runPath)\n  if (!['approve', 'reject'].includes(decision)) throw new Error('review decision 只能是 approve/reject')\n  if (!clean(reviewer) || !clean(reason)) throw new Error('review 需要 reviewer 和 reason')\n  const path = candidatePath(root, id, options.stateDir)\n  const release = acquireLease(`${path}.lock`, `Memory Candidate ${id} 正在评审`, {\n    waitMs: 3_000, staleAfterMs: 2 * 60_000,\n  })\n  try {\n    const current = readCandidate(path)\n    assertCandidateRevision(current, expectedRevision)\n    if (current.status !== 'proposed') {\n      throw new Error(`Memory Candidate ${id} 当前状态是 ${current.status}，不能再次评审`)\n    }\n    const unsigned: Omit<MemoryCandidate, 'hash'> = {\n      ...withoutHash(current),\n      revision: current.revision + 1,\n      status: decision === 'approve' ? 'approved' : 'rejected',\n      review: {\n        decision,\n        reviewer: clean(reviewer),\n        reason: clean(reason),\n        reviewedAt: new Date().toISOString(),\n      },\n    }\n    const candidate = signCandidate(unsigned)\n    writeJsonAtomic(path, candidate)\n    return { $schema: 'dingtalk-agent/memory-candidate-result@1', duplicate: false,\n      path, candidate: readCandidate(path) }\n  } finally {\n    release()\n  }\n}\n\nexport function publishMemoryCandidate(\n  root: string,\n  id: string,\n  targetValue: unknown,\n  expectedRevision: number,\n  expectedTargetHash = '',\n  options: CandidateOptions & { execute?: boolean; yes?: boolean; live?: boolean } = {},\n): CandidatePublishResult {\n  if (options.execute) assertOffline('publish', options.runPath)\n  const target = validateTarget(targetValue)\n  const path = candidatePath(root, id, options.stateDir)\n  const release = acquireLease(`${path}.lock`, `Memory Candidate ${id} 正在发布`, {\n    waitMs: 3_000, staleAfterMs: 10 * 60_000,\n  })\n  try {\n    const current = readCandidate(path)\n    assertCandidateRevision(current, expectedRevision)\n    if (!['approved', 'published'].includes(current.status)) {\n      throw new Error(`Memory Candidate ${id} 状态为 ${current.status}，必须先 approve`)\n    }\n    if (current.status === 'published' && current.publication?.uri !== target.uri) {\n      throw new Error(\n        `Memory Candidate ${id} 已发布到 ${current.publication?.uri || '-'}，不能静默换目标`,\n      )\n    }\n    const targetContext = readPublishTarget(root, target)\n    const block = renderCandidate(current)\n    const markerCount = countMarker(targetContext.content, current.id)\n    const concurrency = target.provider === 'local-md'\n      ? 'atomic-local-cas' as const : 'best-effort-read-check-append' as const\n    const base = {\n      $schema: 'dingtalk-agent/memory-publish-result@1' as const,\n      sideEffect: false,\n      verified: false,\n      duplicate: false,\n      candidateId: current.id,\n      candidateRevision: current.revision,\n      provider: target.provider,\n      uri: target.uri,\n      currentTargetHash: targetContext.hash,\n      targetHashAfter: '',\n      markerCount,\n      verification: 'dry-run-target-inspected',\n      concurrency,\n      candidate: current,\n    }\n    if (!options.execute) return { ...base, mode: 'dry-run' }\n    if (!options.yes) throw new Error('Memory Candidate 发布必须显式 --yes')\n    if (!expectedTargetHash || expectedTargetHash !== targetContext.hash) {\n      throw new Error(\n        `发布目标 hash 冲突：expected=${expectedTargetHash || '-'}, actual=${targetContext.hash}；` +\n        '请重新 dry-run 并人工检查差异',\n      )\n    }\n    if (markerCount > 1) {\n      return { ...base, mode: 'uncertain', verification: 'duplicate-candidate-markers' }\n    }\n    let published\n    if (target.provider === 'local-md') {\n      published = publishLocal(targetContext.path, targetContext.content, block, current.id)\n    } else {\n      if (!options.live) throw new Error('钉钉文档发布必须显式 --live --yes')\n      published = publishDingTalkDoc(target, targetContext.content, block, current.id)\n    }\n    if (!published.verified) {\n      return {\n        ...base,\n        mode: 'uncertain',\n        sideEffect: published.sideEffect,\n        duplicate: published.duplicate,\n        targetHashAfter: published.hash,\n        markerCount: published.markerCount,\n        verification: published.verification,\n      }\n    }\n    const publication = {\n      provider: target.provider,\n      uri: target.uri,\n      targetHashBefore: targetContext.hash,\n      targetHashAfter: published.hash,\n      verification: published.verification,\n      concurrency,\n      publishedAt: new Date().toISOString(),\n      gitHead: target.provider === 'local-md' ? readGitHead(root) : '',\n    }\n    const candidate = current.status === 'published'\n      ? current\n      : signCandidate({\n        ...withoutHash(current),\n        revision: current.revision + 1,\n        status: 'published',\n        publication,\n      })\n    if (current.status !== 'published') writeJsonAtomic(path, candidate)\n    return {\n      ...base,\n      mode: 'published',\n      sideEffect: published.sideEffect,\n      verified: true,\n      duplicate: published.duplicate,\n      candidateRevision: candidate.revision,\n      targetHashAfter: published.hash,\n      markerCount: published.markerCount,\n      verification: published.verification,\n      candidate: readCandidate(path),\n    }\n  } finally {\n    release()\n  }\n}\n\nfunction publishLocal(\n  path: string,\n  content: string,\n  block: string,\n  candidateId: string,\n): { verified: boolean; sideEffect: boolean; duplicate: boolean; hash: string;\n  markerCount: number; verification: string } {\n  const release = acquireLease(`${path}.dta-publish.lock`, `发布目标 ${path} 正在更新`, {\n    waitMs: 3_000, staleAfterMs: 10 * 60_000,\n  })\n  try {\n    const latest = readFileSync(path, 'utf8')\n    if (latest !== content) throw new Error('本地发布目标在加锁前发生漂移，请重新 dry-run')\n    const existing = countMarker(latest, candidateId)\n    const next = existing === 1 ? latest : appendBlock(latest, block)\n    if (!existing) writeTextAtomic(path, next)\n    const readback = readFileSync(path, 'utf8')\n    const markerCount = countMarker(readback, candidateId)\n    const verified = markerCount === 1 && readback.includes(block.trim())\n    return {\n      verified,\n      sideEffect: !existing,\n      duplicate: existing === 1,\n      hash: digest(readback),\n      markerCount,\n      verification: verified ? 'local-atomic-write-readback' : 'local-readback-mismatch',\n    }\n  } finally {\n    release()\n  }\n}\n\nfunction publishDingTalkDoc(\n  target: MemoryPublishTarget,\n  content: string,\n  block: string,\n  candidateId: string,\n): { verified: boolean; sideEffect: boolean; duplicate: boolean; hash: string;\n  markerCount: number; verification: string } {\n  const profile = clean(target.profile || process.env.DTA_DWS_PROFILE)\n  const expectedUserId = clean(target.expectedUserId || process.env.DTA_EXPECTED_USER_ID)\n  if (!profile || profile.includes(',') || !expectedUserId) {\n    throw new Error('dingtalk-doc 发布必须固定单一 profile 和 expectedUserId')\n  }\n  const identity = dws.getSelf(profile)\n  const actualUserId = String(findValue(identity, ['userId', 'user_id', 'userid']) || '')\n  if (!actualUserId || actualUserId !== expectedUserId) {\n    throw new Error(`DWS 执行身份不符：expected=${expectedUserId}, actual=${actualUserId || '-'}`)\n  }\n  const existing = countMarker(content, candidateId)\n  let sideEffect = false\n  if (!existing) {\n    const directory = mkdtempSync(join(tmpdir(), 'dta-memory-publish-'))\n    const file = join(directory, 'candidate.md')\n    try {\n      writeFileSync(file, block)\n      dws.appendDoc(target.uri.slice('dingtalk-doc:'.length), file, profile)\n      sideEffect = true\n    } finally {\n      rmSync(directory, { recursive: true, force: true })\n    }\n  }\n  const readback = String(dws.readDoc(target.uri.slice('dingtalk-doc:'.length), profile))\n  const markerCount = countMarker(readback, candidateId)\n  const verified = markerCount === 1 && dws.words(readback).includes(dws.words(block))\n  return {\n    verified,\n    sideEffect,\n    duplicate: existing === 1,\n    hash: digest(readback),\n    markerCount,\n    verification: verified\n      ? 'dingtalk-doc-append-full-readback' : 'dingtalk-doc-readback-mismatch',\n  }\n}\n\nfunction readPublishTarget(\n  root: string,\n  target: MemoryPublishTarget,\n): { path: string; content: string; hash: string } {\n  if (target.provider === 'local-md') {\n    const ref = target.uri.slice('local-md:'.length)\n    const rootReal = realpathSync(resolve(root))\n    const path = realpathSync(resolve(rootReal, ref))\n    assertInside(rootReal, path, 'local-md 发布目标')\n    const content = readFileSync(path, 'utf8')\n    return { path, content, hash: digest(content) }\n  }\n  const ref = target.uri.slice('dingtalk-doc:'.length)\n  const profile = clean(target.profile || process.env.DTA_DWS_PROFILE)\n  if (!ref) throw new Error('dingtalk-doc 发布目标缺少 node/url')\n  const info = dws.docInfo(ref, profile)\n  if (String(info?.contentType || '').toUpperCase() !== 'ALIDOC' ||\n      String(info?.extension || '').toLowerCase() !== 'adoc') {\n    throw new Error('dingtalk-doc 发布目标必须是在线文档 adoc')\n  }\n  const content = String(dws.readDoc(ref, profile))\n  return { path: '', content, hash: digest(content) }\n}\n\nfunction renderCandidate(candidate: MemoryCandidate): string {\n  return `\\n> DTA Candidate: \\`${candidate.id}\\`\\n\\n` +\n    `## ${candidate.title}\\n\\n` +\n    `- Kind: ${candidate.kind}\\n` +\n    `- Scope: ${candidate.scopeId}\\n` +\n    `- Confidence: ${candidate.confidence}\\n` +\n    `- Sources: ${candidate.sourceRefs.join(', ')}\\n` +\n    `- Supersedes: ${candidate.supersedes.join(', ') || '-'}\\n\\n` +\n    `${candidate.content.trim()}\\n`\n}\n\nfunction appendBlock(content: string, block: string): string {\n  return `${content.trimEnd()}\\n${block.startsWith('\\n') ? block : `\\n${block}`}`\n}\n\nfunction countMarker(content: string, candidateId: string): number {\n  return content.split(candidateId).length - 1\n}\n\nfunction validateProposal(value: unknown): MemoryCandidateProposal {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    throw new Error('Memory Candidate proposal 必须是 JSON object')\n  }\n  const input = value as Record<string, any>\n  const allowed = new Set([\n    '$schema', 'kind', 'scopeId', 'title', 'content', 'sourceRefs', 'confidence', 'supersedes',\n  ])\n  const extra = Object.keys(input).filter((key) => !allowed.has(key))\n  if (extra.length) throw new Error(`Memory Candidate proposal 含未知字段: ${extra.join(', ')}`)\n  if (input.$schema !== 'dingtalk-agent/memory-candidate-proposal@1' ||\n      !['semantic', 'procedural'].includes(input.kind)) {\n    throw new Error('Memory Candidate proposal schema/kind 非法')\n  }\n  for (const key of ['scopeId', 'title', 'content']) {\n    if (!clean(input[key])) throw new Error(`Memory Candidate proposal 缺少 ${key}`)\n  }\n  if (Buffer.byteLength(input.content, 'utf8') > 32 * 1024) {\n    throw new Error('Memory Candidate content 超过 32 KiB')\n  }\n  for (const key of ['sourceRefs', 'supersedes']) {\n    if (!Array.isArray(input[key]) || input[key].some((item: unknown) => !clean(item))) {\n      throw new Error(`Memory Candidate ${key} 必须是非空字符串数组`)\n    }\n  }\n  if (!input.sourceRefs.length) throw new Error('Memory Candidate 至少需要一条 sourceRef')\n  if (typeof input.confidence !== 'number' || input.confidence < 0 || input.confidence > 1) {\n    throw new Error('Memory Candidate confidence 必须在 0..1')\n  }\n  return JSON.parse(JSON.stringify(input)) as MemoryCandidateProposal\n}\n\nfunction validateTarget(value: unknown): MemoryPublishTarget {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    throw new Error('Memory publish target 必须是 JSON object')\n  }\n  const input = value as Record<string, any>\n  const allowed = new Set(['$schema', 'provider', 'uri', 'profile', 'expectedUserId'])\n  const extra = Object.keys(input).filter((key) => !allowed.has(key))\n  if (extra.length) throw new Error(`Memory publish target 含未知字段: ${extra.join(', ')}`)\n  if (input.$schema !== 'dingtalk-agent/memory-publish-target@1' ||\n      !['local-md', 'dingtalk-doc'].includes(input.provider)) {\n    throw new Error('Memory publish target schema/provider 非法')\n  }\n  if (!clean(input.uri) || !input.uri.startsWith(`${input.provider}:`)) {\n    throw new Error(`Memory publish target uri 必须以 ${input.provider}: 开头`)\n  }\n  return JSON.parse(JSON.stringify(input)) as MemoryPublishTarget\n}\n\nfunction candidateRoot(root: string, stateDir = '', prepared = false): string {\n  const base = resolve(root, stateDir || process.env.DTA_STATE_DIR || '.dingtalk-agent')\n  if (prepared) assertInside(resolve(root, '.dingtalk-agent'), base, 'Prepared candidate stateDir')\n  const path = join(base, 'memory', 'candidates')\n  mkdirSync(path, { recursive: true })\n  return path\n}\n\nfunction candidatePath(root: string, id: string, stateDir = ''): string {\n  if (!/^memcand_[a-f0-9]{24}$/.test(id)) throw new Error(`Memory Candidate ID 非法: ${id}`)\n  return join(candidateRoot(root, stateDir, false), `${id}.json`)\n}\n\nfunction proposerContext(root: string, runInput = ''): Record<string, any> | null {\n  const value = clean(runInput || process.env.DTA_RUN)\n  if (!value) return null\n  const rootReal = realpathSync(resolve(root))\n  const runPath = realpathSync(resolve(value))\n  assertInside(rootReal, runPath, 'Prepared Run')\n  const run = JSON.parse(readFileSync(join(runPath, 'run.json'), 'utf8'))\n  if (!run.id || !run.contextId || !run.definition?.hash) {\n    throw new Error('Prepared Run 缺少 id/contextId/definition hash')\n  }\n  return run\n}\n\nfunction readCandidate(path: string): MemoryCandidate {\n  if (!existsSync(path)) throw new Error(`找不到 Memory Candidate: ${path}`)\n  const value = JSON.parse(readFileSync(path, 'utf8')) as MemoryCandidate\n  const { hash, ...unsigned } = value\n  if (!hash || hash !== digest(stableStringify(unsigned))) {\n    throw new Error(`Memory Candidate hash 不一致: ${value.id || path}`)\n  }\n  return value\n}\n\nfunction signCandidate(unsigned: Omit<MemoryCandidate, 'hash'>): MemoryCandidate {\n  return { ...unsigned, hash: digest(stableStringify(unsigned)) }\n}\n\nfunction withoutHash(candidate: MemoryCandidate): Omit<MemoryCandidate, 'hash'> {\n  const { hash: _hash, ...unsigned } = candidate\n  return unsigned\n}\n\nfunction assertCandidateRevision(candidate: MemoryCandidate, expected: number): void {\n  if (!Number.isInteger(expected) || expected < 1 || candidate.revision !== expected) {\n    throw new Error(\n      `Memory Candidate revision 冲突：expected=${expected}, actual=${candidate.revision}`,\n    )\n  }\n}\n\nfunction assertOffline(action: string, runPath = ''): void {\n  if (process.env.DTA_RUN || runPath) {\n    throw new Error(`在线 Prepared Run 只能 propose，不能 ${action} Memory Candidate`)\n  }\n}\n\nfunction assertInside(root: string, path: string, label: string): void {\n  const rel = relative(resolve(root), resolve(path))\n  if (rel === '..' || rel.startsWith(`..${process.platform === 'win32' ? '\\\\' : '/'}`)) {\n    throw new Error(`${label} 必须位于允许的 root 内`)\n  }\n}\n\nfunction readGitHead(root: string): string {\n  const run = spawnSync('git', ['-C', root, 'rev-parse', 'HEAD'], {\n    encoding: 'utf8', timeout: 2_000,\n  })\n  return run.status === 0 ? String(run.stdout || '').trim() : ''\n}\n\nfunction findValue(value: unknown, keys: string[]): unknown {\n  if (!value || typeof value !== 'object') return null\n  for (const [key, child] of Object.entries(value)) {\n    if (keys.includes(key) && child !== undefined && child !== null && child !== '') return child\n  }\n  for (const child of Object.values(value)) {\n    const found = findValue(child, keys)\n    if (found !== null) return found\n  }\n  return null\n}\n\nfunction writeJsonAtomic(path: string, value: unknown): void {\n  mkdirSync(dirname(path), { recursive: true })\n  writeTextAtomic(path, JSON.stringify(value, null, 2) + '\\n')\n}\n\nfunction writeTextAtomic(path: string, value: string): void {\n  const temp = `${path}.${process.pid}.${Date.now()}.tmp`\n  writeFileSync(temp, value, { flag: 'wx' })\n  renameSync(temp, path)\n}\n\nfunction clean(value: unknown): string {\n  return typeof value === 'string' ? value.trim() : ''\n}\n"]}