@xgjktech/xg-openclaw-shared 0.2.1 → 0.2.2

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export type { Plan, Task, Step, TaskStatus, StepStatus, PlanOrigin } from "./plan-types.js";
-export { assertPlanInvariants, PlanInvariantError } from "./plan-types.js";
+export { assertPlanInvariants, isPlanCancelled, PlanInvariantError } from "./plan-types.js";
 export type { PlanStore, PlanSummary } from "./plan-store.js";
 export { SqlitePlanStore, openPlanStoreReadonly, resolvePlanDbPath, PlanStoreError } from "./plan-store.js";
 export type { PlanEventPayload, PlanEventSummary } from "./plan-events.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE3E,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE5G,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE5F,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE5G,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,4 +1,4 @@
 // 桶文件：xg-shared 的唯一公开面。两插件（本插件 + IM 插件）均只从此入口 import。
-export { assertPlanInvariants, PlanInvariantError } from "./plan-types.js";
+export { assertPlanInvariants, isPlanCancelled, PlanInvariantError } from "./plan-types.js";
 export { SqlitePlanStore, openPlanStoreReadonly, resolvePlanDbPath, PlanStoreError } from "./plan-store.js";
 export { planEventStream, isPlanEventPayload } from "./plan-events.js";

package/dist/plan-types.d.ts

@@ -34,17 +34,20 @@ export interface Plan {
     updatedAt: string;
     tasks: Task[];
     origin?: PlanOrigin;
+    status?: "active" | "cancelled";
+    cancelledAt?: string;
 }
 export declare class PlanInvariantError extends Error {
     constructor(message: string);
 }
+export declare function isPlanCancelled(plan: Plan): boolean;
 /**
  * 校验 Plan 是否满足全部领域不变量，违反则抛出 PlanInvariantError。
  * 写入方落库前调用；共享函数签名保持稳定，供旧消费者继续复用。
  *
  * 仅校验持久化文档的基础形状：planId / goal 非空、tasks 至少一项，
- * task.status / step.status 取值在枚举内。执行纪律由工具 description 引导，
- * 不在共享层阻断草稿计划落库。
+ * plan.status / task.status / step.status 取值在枚举内。执行纪律由工具
+ * description 引导，不在共享层阻断草稿计划落库。
  */
 export declare function assertPlanInvariants(plan: Plan): void;
 //# sourceMappingURL=plan-types.d.ts.map

package/dist/plan-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-types.d.ts","sourceRoot":"","sources":["../src/plan-types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;AAC7E,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;AAUjE,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAUD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CA8BrD"}
+{"version":3,"file":"plan-types.d.ts","sourceRoot":"","sources":["../src/plan-types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;AAC7E,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;AAUjE,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAUD,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAiCrD"}

package/dist/plan-types.js

@@ -18,13 +18,16 @@ function isTaskStatus(value) {
 function isStepStatus(value) {
     return STEP_STATUSES.includes(value);
 }
+export function isPlanCancelled(plan) {
+    return plan.status === "cancelled";
+}
 /**
  * 校验 Plan 是否满足全部领域不变量，违反则抛出 PlanInvariantError。
  * 写入方落库前调用；共享函数签名保持稳定，供旧消费者继续复用。
  *
  * 仅校验持久化文档的基础形状：planId / goal 非空、tasks 至少一项，
- * task.status / step.status 取值在枚举内。执行纪律由工具 description 引导，
- * 不在共享层阻断草稿计划落库。
+ * plan.status / task.status / step.status 取值在枚举内。执行纪律由工具
+ * description 引导，不在共享层阻断草稿计划落库。
  */
 export function assertPlanInvariants(plan) {
     if (plan.planId.trim() === "") {
@@ -36,6 +39,9 @@ export function assertPlanInvariants(plan) {
     if (plan.tasks.length === 0) {
         throw new PlanInvariantError("tasks 至少一项");
     }
+    if (plan.status !== undefined && plan.status !== "active" && plan.status !== "cancelled") {
+        throw new PlanInvariantError(`status 取值非法: ${plan.status}`);
+    }
     plan.tasks.forEach((task, taskIndex) => {
         if (!isTaskStatus(task.status)) {
             throw new PlanInvariantError(`tasks[${taskIndex}].status 取值非法: ${task.status}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xgjktech/xg-openclaw-shared",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "xgjktech OpenClaw 插件共享层：Plan 数据模型/不变量、SQLite PlanStore、计划事件契约",
   "license": "MIT",
   "type": "module",