@lingxiao-office/sdk 1.0.0

package/dist/core/ProjectContracts.js

@@ -0,0 +1,97 @@
+/**
+ * ProjectContracts — 项目级契约 loader(跨会话复用)。
+ *
+ * 契约真相源是黑板 contract 节点;ContractPack 是投影。本模块从项目级
+ * `.lingxiao/contracts/contract-pack.json` 加载契约 entries,让凌霄生成的契约
+ * 跨会话复用:新会话启动时 `LeaderBlackboard.seedProjectContracts` 调本模块 load
+ * → 灌入黑板 contract 节点(`provenance:declared`)→ `refreshContractPack` 自动包含。
+ *
+ * 路径权威在 `ContractPack.ts`(`getProjectContractsDir`/`getProjectContractPackPath`);
+ * 本模块单向 import,只做 load(读),避免循环依赖。persist(写项目级)在 ContractPack.ts。
+ *
+ * 范式复刻 `CustomCommandLoader`:确定性文件读取 + stat-mtime 5s TTL 缓存 +
+ * 容错(缺失/损坏返回 [],契约缺失时退化为"从零建",不阻断启动)。
+ *
+ * 改契约走正规流程(leader 派 architect / 改源码);人类不直接编辑本目录文件。
+ */
+import { existsSync, readFileSync, statSync } from 'fs';
+import { getProjectContractPackPath, } from './ContractPack.js';
+const PROJECT_CACHE_TTL_MS = Number(process.env.LINGXIAO_PROJECT_CONTRACT_CACHE_TTL_MS || 5_000);
+const projectContractsCache = new Map();
+function isValidEntry(raw) {
+    if (!raw || typeof raw !== 'object')
+        return false;
+    const e = raw;
+    return typeof e.surface === 'string' && e.surface.trim() !== ''
+        && typeof e.content === 'string'
+        && typeof e.sha256 === 'string';
+}
+/**
+ * 从项目级 `.lingxiao/contracts/contract-pack.json` 加载契约 entries(跨会话复用)。
+ * 文件签名(mtime/ctime/size) + 5s TTL 缓存:文件未变且未过期则复用。容错:缺失/损坏/格式错返回 []。
+ */
+export function loadProjectContractEntries(workspace) {
+    const path = getProjectContractPackPath(workspace);
+    if (!existsSync(path))
+        return [];
+    let signature;
+    try {
+        const stat = statSync(path);
+        signature = { mtimeMs: stat.mtimeMs, ctimeMs: stat.ctimeMs, size: stat.size };
+    }
+    catch {
+        projectContractsCache.delete(path);
+        return [];
+    }
+    const cached = projectContractsCache.get(path);
+    const now = Date.now();
+    if (cached
+        && cached.mtimeMs === signature.mtimeMs
+        && cached.ctimeMs === signature.ctimeMs
+        && cached.size === signature.size
+        && now - cached.createdAt < PROJECT_CACHE_TTL_MS) {
+        return cached.entries;
+    }
+    try {
+        const raw = readFileSync(path, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object')
+            return [];
+        const entriesRaw = parsed.entries;
+        if (!Array.isArray(entriesRaw))
+            return [];
+        const entries = entriesRaw.filter(isValidEntry);
+        projectContractsCache.set(path, { ...signature, createdAt: now, entries });
+        return entries;
+    }
+    catch {
+        return [];
+    }
+}
+/** 清除项目级契约缓存(测试 / 强制刷新用)。 */
+export function clearProjectContractsCache() {
+    projectContractsCache.clear();
+}
+/**
+ * 持久化单个契约到项目级 contracts 目录。
+ * 用于 Leader 的 write_contract 工具——直接写契约而不经过 BlackboardGraph。
+ * 内部走 ContractPack 的合并逻辑，保证跨会话一致性。
+ */
+export async function persistContractToProjectDir(workspace, contract) {
+    const { persistProjectContractEntry } = await import('./ContractPack.js');
+    const { createHash } = await import('crypto');
+    const entry = {
+        surface: contract.surface,
+        title: contract.title,
+        content: contract.content,
+        sha256: createHash('sha256').update(contract.content).digest('hex'),
+        version: contract.version ?? 1,
+        createdBy: contract.createdBy ?? 'leader',
+        createdAt: contract.createdAt ? new Date(contract.createdAt).getTime() : Date.now(),
+        tags: [],
+    };
+    persistProjectContractEntry(workspace, entry);
+    // 清除缓存让下次 load 立即看到新契约
+    projectContractsCache.delete(getProjectContractPackPath(workspace));
+}
+//# sourceMappingURL=ProjectContracts.js.map

package/dist/core/ProjectContracts.js.map

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

package/dist/core/ProjectRetentionPolicy.d.ts

@@ -0,0 +1,31 @@
+export type ProjectRetentionState = 'active' | 'archived' | 'retained' | 'compacted' | 'prunable';
+export interface ProjectRetentionInput {
+    completedAt?: number;
+    archivedAt?: number;
+    now?: number;
+    transferCount: number;
+    auditCount: number;
+    trendSamples: number;
+}
+export interface ProjectRetentionDecision {
+    state: ProjectRetentionState;
+    shouldCompactTransfers: boolean;
+    shouldCompactAudit: boolean;
+    shouldPrune: boolean;
+    reason: string;
+}
+export interface ProjectRetentionPolicyConfig {
+    archiveAfterMs?: number;
+    compactAfterMs?: number;
+    pruneAfterMs?: number;
+    maxTransfersBeforeCompact?: number;
+    maxAuditEntriesBeforeCompact?: number;
+    maxTrendSamplesBeforeCompact?: number;
+}
+export declare class ProjectRetentionPolicy {
+    readonly config: Required<ProjectRetentionPolicyConfig>;
+    constructor(config?: ProjectRetentionPolicyConfig);
+    evaluate(input: ProjectRetentionInput): ProjectRetentionDecision;
+}
+export default ProjectRetentionPolicy;
+//# sourceMappingURL=ProjectRetentionPolicy.d.ts.map

package/dist/core/ProjectRetentionPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectRetentionPolicy.d.ts","sourceRoot":"","sources":["../../src/core/ProjectRetentionPolicy.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;AAElG,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,qBAAqB,CAAC;IAC7B,sBAAsB,EAAE,OAAO,CAAC;IAChC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,4BAA4B;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,4BAA4B,CAAC,EAAE,MAAM,CAAC;CACvC;AAWD,qBAAa,sBAAsB;IACjC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,4BAA4B,CAAC,CAAC;gBAE5C,MAAM,GAAE,4BAAiC;IAIrD,QAAQ,CAAC,KAAK,EAAE,qBAAqB,GAAG,wBAAwB;CAoDjE;AAED,eAAe,sBAAsB,CAAC"}

package/dist/core/ProjectRetentionPolicy.js

@@ -0,0 +1,68 @@
+const DEFAULTS = {
+    archiveAfterMs: 24 * 60 * 60 * 1000,
+    compactAfterMs: 7 * 24 * 60 * 60 * 1000,
+    pruneAfterMs: 30 * 24 * 60 * 60 * 1000,
+    maxTransfersBeforeCompact: 50,
+    maxAuditEntriesBeforeCompact: 200,
+    maxTrendSamplesBeforeCompact: 500,
+};
+export class ProjectRetentionPolicy {
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULTS, ...config };
+    }
+    evaluate(input) {
+        const now = input.now ?? Date.now();
+        if (input.completedAt === undefined && input.archivedAt === undefined) {
+            return {
+                state: 'active',
+                shouldCompactTransfers: false,
+                shouldCompactAudit: false,
+                shouldPrune: false,
+                reason: 'project_active',
+            };
+        }
+        const referenceAt = input.archivedAt ?? input.completedAt;
+        const ageMs = now - referenceAt;
+        const shouldCompact = ageMs >= this.config.compactAfterMs
+            || input.transferCount >= this.config.maxTransfersBeforeCompact
+            || input.auditCount >= this.config.maxAuditEntriesBeforeCompact
+            || input.trendSamples >= this.config.maxTrendSamplesBeforeCompact;
+        if (ageMs >= this.config.pruneAfterMs) {
+            return {
+                state: 'prunable',
+                shouldCompactTransfers: true,
+                shouldCompactAudit: true,
+                shouldPrune: true,
+                reason: 'retention_prune_due',
+            };
+        }
+        if (shouldCompact) {
+            return {
+                state: 'compacted',
+                shouldCompactTransfers: true,
+                shouldCompactAudit: true,
+                shouldPrune: false,
+                reason: 'retention_compaction_due',
+            };
+        }
+        if (ageMs >= this.config.archiveAfterMs) {
+            return {
+                state: 'archived',
+                shouldCompactTransfers: false,
+                shouldCompactAudit: false,
+                shouldPrune: false,
+                reason: 'retention_archive_due',
+            };
+        }
+        return {
+            state: 'retained',
+            shouldCompactTransfers: false,
+            shouldCompactAudit: false,
+            shouldPrune: false,
+            reason: 'retention_keep',
+        };
+    }
+}
+export default ProjectRetentionPolicy;
+//# sourceMappingURL=ProjectRetentionPolicy.js.map

package/dist/core/ProjectRetentionPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectRetentionPolicy.js","sourceRoot":"","sources":["../../src/core/ProjectRetentionPolicy.ts"],"names":[],"mappings":"AA4BA,MAAM,QAAQ,GAA2C;IACvD,cAAc,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;IACnC,cAAc,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;IACvC,YAAY,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;IACtC,yBAAyB,EAAE,EAAE;IAC7B,4BAA4B,EAAE,GAAG;IACjC,4BAA4B,EAAE,GAAG;CAClC,CAAC;AAEF,MAAM,OAAO,sBAAsB;IACxB,MAAM,CAAyC;IAExD,YAAY,SAAuC,EAAE;QACnD,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC;IAC3C,CAAC;IAED,QAAQ,CAAC,KAA4B;QACnC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACtE,OAAO;gBACL,KAAK,EAAE,QAAQ;gBACf,sBAAsB,EAAE,KAAK;gBAC7B,kBAAkB,EAAE,KAAK;gBACzB,WAAW,EAAE,KAAK;gBAClB,MAAM,EAAE,gBAAgB;aACzB,CAAC;QACJ,CAAC;QACD,MAAM,WAAW,GAAG,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,WAAY,CAAC;QAC3D,MAAM,KAAK,GAAG,GAAG,GAAG,WAAW,CAAC;QAChC,MAAM,aAAa,GAAG,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc;eACpD,KAAK,CAAC,aAAa,IAAI,IAAI,CAAC,MAAM,CAAC,yBAAyB;eAC5D,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,4BAA4B;eAC5D,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,4BAA4B,CAAC;QACpE,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YACtC,OAAO;gBACL,KAAK,EAAE,UAAU;gBACjB,sBAAsB,EAAE,IAAI;gBAC5B,kBAAkB,EAAE,IAAI;gBACxB,WAAW,EAAE,IAAI;gBACjB,MAAM,EAAE,qBAAqB;aAC9B,CAAC;QACJ,CAAC;QACD,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO;gBACL,KAAK,EAAE,WAAW;gBAClB,sBAAsB,EAAE,IAAI;gBAC5B,kBAAkB,EAAE,IAAI;gBACxB,WAAW,EAAE,KAAK;gBAClB,MAAM,EAAE,0BAA0B;aACnC,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YACxC,OAAO;gBACL,KAAK,EAAE,UAAU;gBACjB,sBAAsB,EAAE,KAAK;gBAC7B,kBAAkB,EAAE,KAAK;gBACzB,WAAW,EAAE,KAAK;gBAClB,MAAM,EAAE,uBAAuB;aAChC,CAAC;QACJ,CAAC;QACD,OAAO;YACL,KAAK,EAAE,UAAU;YACjB,sBAAsB,EAAE,KAAK;YAC7B,kBAAkB,EAAE,KAAK;YACzB,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE,gBAAgB;SACzB,CAAC;IACJ,CAAC;CACF;AAED,eAAe,sBAAsB,CAAC"}

package/dist/core/ProjectRuntimeManager.d.ts

@@ -0,0 +1,91 @@
+import { type ProjectDependencyEntry, type ProjectDependencyStatus, type ProjectRuntimeMode, type ProjectRuntimeRecord, type ProjectSpecReference } from './ProjectRuntimeState.js';
+export interface ProjectRuntimePaths {
+    projectDir: string;
+    runtimePath: string;
+    dependencyLedgerPath: string;
+    decisionLogPath: string;
+}
+export interface CreateProjectRuntimeInput {
+    projectId: string;
+    projectName: string;
+    description?: string;
+    specReference?: ProjectSpecReference;
+    backlog?: ProjectRuntimeRecord['backlog'];
+    milestones?: ProjectRuntimeRecord['milestones'];
+    unresolvedRisks?: ProjectRuntimeRecord['unresolvedRisks'];
+    initialMode?: ProjectRuntimeMode;
+    metadata?: Record<string, unknown>;
+}
+export interface RecordProjectDecisionInput {
+    id?: string;
+    at?: number;
+    actor: string;
+    type: string;
+    summary: string;
+    details?: Record<string, unknown>;
+    modeAfter?: ProjectRuntimeMode;
+    relatedDependencyId?: string;
+    relatedSprintId?: string;
+}
+export interface UpsertDependencyInput extends Omit<ProjectDependencyEntry, 'requestedAt' | 'blockingTasks'> {
+    requestedAt?: number;
+    blockingTasks?: string[];
+}
+export interface UpdateDependencyStatusInput {
+    status: ProjectDependencyStatus;
+    at?: number;
+    actor?: string;
+    summary?: string;
+    lastPingedAt?: number;
+    details?: Record<string, string | number | boolean | null>;
+}
+export interface ProjectStateStore {
+    load(projectId: string): ProjectRuntimeRecord | null;
+    save(record: ProjectRuntimeRecord): ProjectRuntimeRecord;
+    listProjectIds(): string[];
+    getPaths(projectId: string): ProjectRuntimePaths;
+    /**
+     * 可选：返回 per-projectId 的 RMW 串行化锁文件路径。
+     * DiskProjectStateStore 提供文件锁；内存/测试 store 可不实现（退回进程内锁）。
+     */
+    lockPathFor?(projectId: string): string;
+}
+export declare class DiskProjectStateStore implements ProjectStateStore {
+    private readonly projectsRoot;
+    constructor(workspaceRoot: string);
+    getPaths(projectId: string): ProjectRuntimePaths;
+    /** 同一 projectId 的 RMW 串行化锁路径。 */
+    lockPathFor(projectId: string): string;
+    load(projectId: string): ProjectRuntimeRecord | null;
+    save(record: ProjectRuntimeRecord): ProjectRuntimeRecord;
+    listProjectIds(): string[];
+}
+export declare class ProjectRuntimeManager {
+    private readonly store;
+    private readonly now;
+    /** 同进程内同 projectId 的重入计数，配合文件锁防止 RMW 嵌套自死锁。 */
+    private readonly heldLocks;
+    constructor(workspaceRoot: string, options?: {
+        store?: ProjectStateStore;
+        now?: () => number;
+    });
+    /**
+     * 串行化同一 projectId 的 read-modify-write，防止 lost update。
+     * 若 store 提供 lockPathFor 则用跨进程文件锁；同进程已持有该锁时直接执行（重入），
+     * 避免 recordDecision 嵌套调用 updateProject 时自死锁。
+     */
+    private withProjectLock;
+    getPaths(projectId: string): ProjectRuntimePaths;
+    listProjectIds(): string[];
+    loadProject(projectId: string): ProjectRuntimeRecord | null;
+    saveProject(record: ProjectRuntimeRecord): ProjectRuntimeRecord;
+    createProject(input: CreateProjectRuntimeInput): ProjectRuntimeRecord;
+    ensureProject(input: CreateProjectRuntimeInput): ProjectRuntimeRecord;
+    updateProject(projectId: string, updater: (record: ProjectRuntimeRecord) => ProjectRuntimeRecord): ProjectRuntimeRecord;
+    setProjectMode(projectId: string, mode: ProjectRuntimeMode, input?: Omit<RecordProjectDecisionInput, 'modeAfter'>): ProjectRuntimeRecord;
+    recordDecision(projectId: string, input: RecordProjectDecisionInput): ProjectRuntimeRecord;
+    upsertDependency(projectId: string, input: UpsertDependencyInput): ProjectRuntimeRecord;
+    updateDependencyStatus(projectId: string, dependencyId: string, input: UpdateDependencyStatusInput): ProjectRuntimeRecord;
+}
+export default ProjectRuntimeManager;
+//# sourceMappingURL=ProjectRuntimeManager.d.ts.map

package/dist/core/ProjectRuntimeManager.d.ts.map

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