@coralai/sps-cli 0.58.40 → 0.58.42

package/dist/services/promptPreview.d.ts

@@ -0,0 +1,31 @@
+export interface PromptPreviewCard {
+    seq: number | string;
+    title: string;
+    desc: string;
+    skills?: string[];
+}
+export interface PromptPreviewResult {
+    /** 拼好的完整提示词字符串。 */
+    prompt: string;
+    meta: {
+        /** 'actual'=派发时落盘的真实那份;'preview'=按当前状态重建。 */
+        source: 'actual' | 'preview';
+        /** source=actual 时:派发时间(ISO);preview 时 null。 */
+        dispatchedAt?: string | null;
+        /** 本卡解析出的 skill 名(空=无)。 */
+        skills: string[];
+        /** 是否注入了记忆块。 */
+        memoryIncluded: boolean;
+        /** 是否把 CLAUDE.md/AGENTS.md 拼进了字符串(claude 后端为 false——它原生读)。 */
+        projectRulesIncluded: boolean;
+        /** git 模式(影响 How to Run:commit/push vs 完成/自检)。 */
+        git: boolean;
+        /** claude 原生读、**不在**字符串里但等于进了 context 的部分。 */
+        nativeContext: string[];
+        /** 阅读提示。 */
+        notes: string[];
+    };
+}
+/** 重建某卡的 worker 提示词预览。project 无效/配置缺失时抛,由调用方转 Result。 */
+export declare function buildWorkerPromptPreview(project: string, card: PromptPreviewCard): PromptPreviewResult;
+//# sourceMappingURL=promptPreview.d.ts.map

package/dist/services/promptPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptPreview.d.ts","sourceRoot":"","sources":["../../src/services/promptPreview.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE;QACJ,6CAA6C;QAC7C,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;QAC7B,gDAAgD;QAChD,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,2BAA2B;QAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,gBAAgB;QAChB,cAAc,EAAE,OAAO,CAAC;QACxB,8DAA8D;QAC9D,oBAAoB,EAAE,OAAO,CAAC;QAC9B,kDAAkD;QAClD,GAAG,EAAE,OAAO,CAAC;QACb,8CAA8C;QAC9C,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,YAAY;QACZ,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;CACH;AAED,yDAAyD;AACzD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,mBAAmB,CAkFtG"}

package/dist/services/promptPreview.js

@@ -0,0 +1,88 @@
+/**
+ * @module        services/promptPreview
+ * @description   重建"派卡时注入 worker 的完整提示词",供控制台**预览**(不 dispatch、不落库)。
+ *                忠实镜像 StageEngine.buildStagePrompt + worker-manager.withMemoryInjection 的拼装:
+ *                记忆块(project+global,以卡片标题召回)→ `# Required Skills`(skill 名)→
+ *                projectRules(仅非 claude 后端)→ `# Task`(title/seq/描述)→ `# How to Run`。
+ *                运行时才定的量(真实 worktree 路径 / 分支 / cardId)用占位;memory 用当前库状态。
+ * @layer         services
+ * @boundedContext worker
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { loadProjectConf, resolveGitlabProjectId, resolveWorkflowTransport } from '../core/config.js';
+import { buildMemoryInjection } from '../core/memory2/inject.js';
+import { ProjectPipelineAdapter } from '../core/projectPipelineAdapter.js';
+import { buildPhasePrompt, buildTaskPrompt } from '../core/taskPrompts.js';
+import { formatSkillRequirement, resolveRequiredSkills } from '../engines/StageEngine.js';
+import { findProjectRepoDir } from '../shared/projectRepo.js';
+/** 重建某卡的 worker 提示词预览。project 无效/配置缺失时抛,由调用方转 Result。 */
+export function buildWorkerPromptPreview(project, card) {
+    const config = loadProjectConf(project);
+    const repoDir = findProjectRepoDir(project) ?? config.PROJECT_DIR ?? `<repo:${project}>`;
+    const adapter = new ProjectPipelineAdapter(config, repoDir);
+    const stage = adapter.firstStage;
+    const gitEnabled = adapter.gitEnabled;
+    // ① skills —— card.skills → stage.profile → DEFAULT_WORKER_SKILLS
+    const skills = resolveRequiredSkills({ skills: card.skills }, { profile: stage?.profile }, config.raw.DEFAULT_WORKER_SKILLS);
+    const skillContent = skills.length ? formatSkillRequirement(skills) : '';
+    // ② projectRules —— claude(acp-sdk)原生读 CLAUDE.md,跳过拼接;非 claude 后端才读文件拼进去
+    const nativeReadsClaudeMd = resolveWorkflowTransport(config) === 'acp-sdk';
+    let projectRules = '';
+    if (!nativeReadsClaudeMd) {
+        for (const f of ['CLAUDE.md', 'AGENTS.md']) {
+            const p = resolve(repoDir, f);
+            if (existsSync(p)) {
+                const txt = readFileSync(p, 'utf-8').trim();
+                if (txt)
+                    projectRules = projectRules ? `${projectRules}\n\n${txt}` : txt;
+            }
+        }
+    }
+    // 运行时才定的量用占位(真实值在 dispatch 时由 worktree/taskId 决定)
+    const worktreePath = `${config.WORKTREE_DIR || `~/.coral/worktrees/${project}`}/<task-branch>`;
+    const promptCtx = {
+        taskSeq: String(card.seq),
+        taskTitle: card.title,
+        taskDescription: card.desc || '(no description)',
+        cardId: '<runtime>',
+        worktreePath,
+        branchName: '<task-branch>',
+        targetBranch: config.GITLAB_MERGE_BRANCH || 'main',
+        mergeMode: config.MR_MODE,
+        gitlabProjectId: resolveGitlabProjectId(config),
+        skillContent,
+        projectRules: projectRules || undefined,
+        completionSignal: config.raw.COMPLETION_SIGNAL || undefined,
+    };
+    const core = gitEnabled
+        ? buildPhasePrompt({ ...promptCtx, phase: 'development' })
+        : buildTaskPrompt(promptCtx);
+    // ③ 记忆块 prepend(worker-manager.withMemoryInjection)——project + global,query=卡片标题
+    const memoryBlock = buildMemoryInjection([
+        { scope: 'project', project },
+        { scope: 'global' },
+    ], card.title || core, {});
+    const prompt = memoryBlock ? `${memoryBlock}\n\n${core}` : core;
+    const nativeContext = [];
+    if (nativeReadsClaudeMd) {
+        nativeContext.push('CLAUDE.md(项目规则)—— claude 原生读进 system prompt,故未拼进本串');
+        nativeContext.push('.claude/skills/ —— skill 的 SOP 正文由 claude 原生发现(本串只点名)');
+    }
+    return {
+        prompt,
+        meta: {
+            source: 'preview',
+            skills,
+            memoryIncluded: !!memoryBlock,
+            projectRulesIncluded: !!projectRules,
+            git: gitEnabled,
+            nativeContext,
+            notes: [
+                '预览:按当前卡片 + 项目配置 + 记忆库状态重建,与真实派卡基本一致。',
+                '运行时才确定的量(真实 worktree 路径 / 分支 / cardId)以占位符表示。',
+            ],
+        },
+    };
+}
+//# sourceMappingURL=promptPreview.js.map

package/dist/services/promptPreview.js.map

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

package/package.json

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