@coralai/sps-cli 0.80.0 → 0.81.0

package/assembly/base.yml

@@ -99,6 +99,14 @@
   # 🔴 真源是装配档那一行的 config,**不另起一份** —— 两个真源最难查。
   name: '@coralai/sps-cli/seams/settings'
 
+- id: cards
+  # 卡片(建/列):插件按自己的规则建卡,sps 不必认识那些规则。
+  # 🔴 起因是「manifest → 建几张卡」那段知识该住哪:住 sps 就要认识 gameforge 的概念,
+  #    住插件则 sps 零知识,而插件在进程内、连读口都不需要。
+  # ⚠️ 只有 create / list,不开 move/delete —— 那些是流水线在做的事,
+  #    掺进来就有两个写入方,"这张卡为什么动了"要翻两处。
+  name: '@coralai/sps-cli/seams/cards-builtin'
+
 - id: projects
   # 项目注册表(只读):插件能问"有哪些项目、这个项目在哪"。
   # 🔴 v1 不开"建项目" —— 那牵着注册边界那一摊(建项目会改写被认领的树)。

package/dist/seams/cards/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @module        seams/cards
+ * @description   **卡片 seam** —— 插件能建卡、能看现在有哪些卡。
+ *
+ * @layer         seam
+ *
+ * 类型:**甲 · 工厂型**(进程里一个实现)。
+ *
+ * 🔴 **它解决的是"知识住哪"的问题,不是"文件怎么传"。**
+ *    起因:studio 要按设计师写的 manifest 建卡(tier→1/2/4 张、资产清单→生图卡)。
+ *    四个位置摆过一遍:
+ *    ```
+ *    studio 后端   要读工作区文件 ⇒ sps 得开读口 + 白名单,而白名单只会变长
+ *    sps-cli       sps 得认识 manifest / tier / 生图卡 —— **破北极星**,否决
+ *    插件          gameforge 自己的代码装进 sps:进程内直接读文件,sps 零知识  ← 选它
+ *    agent 的 prompt  最便宜,但把"S=1/M=2/L=4"这种**确定性规则**交给 LLM
+ *    ```
+ *    选了插件,于是插件必须能建卡 —— `createContainer` 不在包导出里,它够不着。
+ *
+ * 🔴 **不需要新的 HTTP 读口。** 插件在进程内,有 fs;
+ *    "哪些文件、什么格式、建几张卡"全在插件代码里。
+ *    sps 既不认识 manifest,也不用维护一张会越长越长的文件白名单。
+ *
+ * ⚠️ **v1 只有 create / list。** 不开 move / delete / label ——
+ *    那些是流水线在做的事,插件掺进去会出现两个写入方,而"这张卡为什么动了"
+ *    要翻两处才算得出来。真有需求再按同样的方式反推着加。
+ *
+ * ⚠️ **幂等由插件负责。** 建卡这件事天然不幂等(建两次就是两张),
+ *    而"什么算重复"只有插件知道(同一个 manifest 重跑?同一个资产?)——
+ *    所以给 `list`,让它自己判,而不是我们编一个 dedup 规则。
+ */
+import { type Context, Service } from '@deepseek-ai/cordis';
+export declare const CARDS = "sps.cards";
+/** 建一张卡。形状照 `add_card`(MCP 面上跑了很久的那个),不另发明。 */
+export interface NewCard {
+    title: string;
+    description?: string;
+    skills?: string[];
+    /** 初始 labels —— `['AI-PIPELINE']` 让它走流水线;缺省不走。 */
+    labels?: string[];
+    /** 执行波次(正整数)。缺省 = seq(串行)。 */
+    order?: number;
+    /** 只接受 `'tool' | 'join'`;缺省(不传)即 worker。 */
+    kind?: 'tool' | 'join';
+    /** `kind:'tool'`:能力 id。 */
+    tool?: string;
+    /** `kind:'tool'`:结构化参数。 */
+    input?: Record<string, unknown>;
+    /** 验收清单。 */
+    checklist?: string[];
+}
+/** 卡片的身份 + 状态。**不带 checklist 统计**(那要扫盘)。 */
+export interface CardRef {
+    seq: number;
+    title: string;
+    state: string;
+    order: number;
+    labels: string[];
+    skills: string[];
+}
+export default abstract class CardsSeam extends Service {
+    constructor(ctx: Context);
+    /** 建一张卡,返回它的 seq。**失败抛** —— 建卡没成功而静默返回,插件会以为建好了。 */
+    abstract create(project: string, card: NewCard): Promise<CardRef>;
+    /** 这个项目现在有哪些卡。幂等判断靠它。 */
+    abstract list(project: string): Promise<CardRef[]>;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        'sps.cards': CardsSeam;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/seams/cards/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/seams/cards/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EAAE,KAAK,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE5D,eAAO,MAAM,KAAK,cAAc,CAAC;AAEjC,+CAA+C;AAC/C,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,YAAY;IACZ,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,4CAA4C;AAC5C,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,SAAU,SAAQ,OAAO;gBACzC,GAAG,EAAE,OAAO;IAIxB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAEjE,yBAAyB;IACzB,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CACnD;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,WAAW,EAAE,SAAS,CAAC;KACxB;CACF"}

package/dist/seams/cards/index.js

@@ -0,0 +1,39 @@
+/**
+ * @module        seams/cards
+ * @description   **卡片 seam** —— 插件能建卡、能看现在有哪些卡。
+ *
+ * @layer         seam
+ *
+ * 类型:**甲 · 工厂型**(进程里一个实现)。
+ *
+ * 🔴 **它解决的是"知识住哪"的问题,不是"文件怎么传"。**
+ *    起因:studio 要按设计师写的 manifest 建卡(tier→1/2/4 张、资产清单→生图卡)。
+ *    四个位置摆过一遍:
+ *    ```
+ *    studio 后端   要读工作区文件 ⇒ sps 得开读口 + 白名单,而白名单只会变长
+ *    sps-cli       sps 得认识 manifest / tier / 生图卡 —— **破北极星**,否决
+ *    插件          gameforge 自己的代码装进 sps:进程内直接读文件,sps 零知识  ← 选它
+ *    agent 的 prompt  最便宜,但把"S=1/M=2/L=4"这种**确定性规则**交给 LLM
+ *    ```
+ *    选了插件,于是插件必须能建卡 —— `createContainer` 不在包导出里,它够不着。
+ *
+ * 🔴 **不需要新的 HTTP 读口。** 插件在进程内,有 fs;
+ *    "哪些文件、什么格式、建几张卡"全在插件代码里。
+ *    sps 既不认识 manifest,也不用维护一张会越长越长的文件白名单。
+ *
+ * ⚠️ **v1 只有 create / list。** 不开 move / delete / label ——
+ *    那些是流水线在做的事,插件掺进去会出现两个写入方,而"这张卡为什么动了"
+ *    要翻两处才算得出来。真有需求再按同样的方式反推着加。
+ *
+ * ⚠️ **幂等由插件负责。** 建卡这件事天然不幂等(建两次就是两张),
+ *    而"什么算重复"只有插件知道(同一个 manifest 重跑?同一个资产?)——
+ *    所以给 `list`,让它自己判,而不是我们编一个 dedup 规则。
+ */
+import { Service } from '@deepseek-ai/cordis';
+export const CARDS = 'sps.cards';
+export default class CardsSeam extends Service {
+    constructor(ctx) {
+        super(ctx, CARDS);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/seams/cards/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/seams/cards/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EAAgB,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,CAAC,MAAM,KAAK,GAAG,WAAW,CAAC;AA+BjC,MAAM,CAAC,OAAO,OAAgB,SAAU,SAAQ,OAAO;IACrD,YAAY,GAAY;QACtB,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACpB,CAAC;CAOF"}

package/dist/seams/cards-builtin/index.d.ts

@@ -0,0 +1,8 @@
+import CardsSeam, { type CardRef, type NewCard } from '../cards/index.js';
+export declare const category = "\u5361\u7247";
+export declare const description = "\u5361\u7247(\u5EFA/\u5217):\u63D2\u4EF6\u6309\u81EA\u5DF1\u7684\u89C4\u5219\u5EFA\u5361,sps \u4E0D\u5FC5\u8BA4\u8BC6\u90A3\u4E9B\u89C4\u5219\u3002";
+export default class BuiltinCards extends CardsSeam {
+    create(project: string, card: NewCard): Promise<CardRef>;
+    list(project: string): Promise<CardRef[]>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/seams/cards-builtin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/seams/cards-builtin/index.ts"],"names":[],"mappings":"AAaA,OAAO,SAAS,EAAE,EAAE,KAAK,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE1E,eAAO,MAAM,QAAQ,iBAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,wJAAqC,CAAC;AAoB9D,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,SAAS;IAClC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAUxD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAIzD"}

package/dist/seams/cards-builtin/index.js

@@ -0,0 +1,30 @@
+import { createContainer } from '../../services/container.js';
+import CardsSeam from '../cards/index.js';
+export const category = '卡片';
+export const description = '卡片(建/列):插件按自己的规则建卡,sps 不必认识那些规则。';
+function toRef(c) {
+    return {
+        seq: c.seq,
+        title: c.title,
+        state: c.state,
+        order: c.order,
+        labels: c.labels,
+        skills: c.skills,
+    };
+}
+export default class BuiltinCards extends CardsSeam {
+    async create(project, card) {
+        const r = await createContainer(this.ctx).cards.create(project, card);
+        if (!r.ok) {
+            // 🔴 **抛,不静默** —— 建卡没成功而返回一个空壳,插件会以为建好了,
+            //    而"少了一张卡"没人会发现。
+            throw new Error(`建卡失败(${project}):${r.error.code ?? r.error.kind}`);
+        }
+        return toRef(r.value);
+    }
+    async list(project) {
+        const r = await createContainer(this.ctx).cards.list(project);
+        return r.ok ? r.value.map(toRef) : [];
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/seams/cards-builtin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/seams/cards-builtin/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,SAAyC,MAAM,mBAAmB,CAAC;AAE1E,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC;AAC7B,MAAM,CAAC,MAAM,WAAW,GAAG,kCAAkC,CAAC;AAE9D,SAAS,KAAK,CAAC,CAOd;IACC,OAAO;QACL,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,SAAS;IACxC,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,IAAa;QAClD,MAAM,CAAC,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACtE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACV,yCAAyC;YACzC,oBAAoB;YACpB,MAAM,IAAI,KAAK,CAAC,QAAQ,OAAO,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAEQ,KAAK,CAAC,IAAI,CAAC,OAAe;QACjC,MAAM,CAAC,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9D,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxC,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coralai/sps-cli",
-  "version": "0.80.0",
+  "version": "0.81.0",
   "description": "SPS CLI — AI-driven development pipeline orchestrator",
   "type": "module",
   "main": "dist/main.js",