sillyspec 3.23.5 → 3.23.6

package/.npm-publish-userconfig.tmp

@@ -0,0 +1 @@
+//registry.npmjs.org/:_authToken=${NPM_TOKEN}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sillyspec",
-  "version": "3.23.5",
+  "version": "3.23.6",
   "description": "SillySpec CLI — 流程状态机，让 AI 严格按步骤来",
   "icon": "logo.jpg",
   "homepage": "https://sillyspec.ppdmq.top/",

package/src/contract-matrix.js

@@ -134,8 +134,10 @@ function parseTaskDependencies(planContent) {
  * @param {string} taskName - task-04
  * @returns {{ ok: boolean, endpoints: Array, artifactPath: string|null }}
  */
-export function extractProviderArtifact(changeDir, worktreePath, specBase, taskName) {
-  const artifactDir = join(specBase, '.runtime', 'contract-artifacts', taskName)
+export function extractProviderArtifact(changeDir, worktreePath, specBase, taskName, runtimeRoot) {
+  // 平台模式 contract-artifacts 落 runtimeRoot；否则落 specBase/.runtime
+  const artifactRoot = runtimeRoot || join(specBase, '.runtime')
+  const artifactDir = join(artifactRoot, 'contract-artifacts', taskName)
   const artifactPath = join(artifactDir, 'endpoints.json')
 
   if (!worktreePath || !existsSync(worktreePath)) {
@@ -179,13 +181,15 @@ export function extractProviderArtifact(changeDir, worktreePath, specBase, taskN
  * @param {Array<{ provider: string, consumer: string, type: string }>} contracts
  * @returns {string|null} 注入到 prompt 的契约文本，无契约时返回 null
  */
-export function buildConsumerInjection(changeDir, specBase, taskName, contracts) {
+export function buildConsumerInjection(changeDir, specBase, taskName, contracts, runtimeRoot) {
+  // 平台模式 contract-artifacts 落 runtimeRoot；否则落 specBase/.runtime
+  const artifactRoot = runtimeRoot || join(specBase, '.runtime')
   const myContracts = contracts.filter(c => c.consumer === taskName)
   if (myContracts.length === 0) return null
 
   const parts = []
   for (const contract of myContracts) {
-    const artifactDir = join(specBase, '.runtime', 'contract-artifacts', contract.provider)
+    const artifactDir = join(artifactRoot, 'contract-artifacts', contract.provider)
     const artifactFile = join(artifactDir, 'endpoints.json')
 
     let endpoints = []
@@ -293,11 +297,13 @@ export function buildContractFieldInjection(changeDir, taskName) {
  * @param {string} worktreePath - worktree 路径
  * @returns {{ ok: boolean, missingBackend: Array, unusedBackend: Array, summary: string }}
  */
-export function verifyApiParity(specBase, worktreePath) {
+export function verifyApiParity(specBase, worktreePath, runtimeRoot) {
   const { diffApiParity } = require('./endpoint-extractor.js')
 
+  // 平台模式 contract-artifacts 落 runtimeRoot；否则落 specBase/.runtime
+  const artifactRoot = runtimeRoot || join(specBase, '.runtime')
   // 读取所有 provider artifacts
-  const artifactBase = join(specBase, '.runtime', 'contract-artifacts')
+  const artifactBase = join(artifactRoot, 'contract-artifacts')
   const allProviderEndpoints = []
 
   if (existsSync(artifactBase)) {

package/src/progress.js

@@ -731,7 +731,11 @@ export class ProgressManager {
       console.warn('⚠️  initChange: changeName 为空，跳过');
       return null;
     }
-    this._ensureChangeDir(cwd, changeName);
+    // quick 会话 id（quick-<uuid8>，见 run.js QUICK_SID_RE）只作 progress 的跨进程 session key，
+    // 进度存 SQL 不需要实体 change 目录——跳过避免 changes/quick-<uuid>/ 空目录残留。
+    if (!/^quick-[0-9a-f]{8}$/.test(changeName)) {
+      this._ensureChangeDir(cwd, changeName);
+    }
 
     const db = await this._ensureDB(cwd);
     db.transaction((sqlDb) => {

package/src/run.js

@@ -1511,6 +1511,15 @@ export async function runCommand(args, cwd, specDir = null) {
     }
   }
 
+  // execute 阶段必须带 --change：不允许自动检测或默认值，变更名必须由 agent 显式传入
+  // --status 豁免（纯查看不需要指定变更）
+  if (stageName === 'execute' && !changeName && !isStatus) {
+    console.error('❌ execute 阶段必须用 --change <变更名> 指定要操作的变更。')
+    console.error('   agent 必须传参，不设默认值、不做自动检测。')
+    console.error('   请加 --change <变更名> 重新执行。')
+    process.exit(1)
+  }
+
   let progress = await pm.read(cwd, changeName)
 
   if (!progress) {
@@ -1844,7 +1853,7 @@ async function runStage(pm, progress, stageName, cwd, changeName, skipApproval =
   if (stageName === 'execute') {
     const { generateExecuteRunId } = await import('./task-review.js')
     const execSpecBase = platformOpts?.specRoot || join(cwd, '.sillyspec')
-    const runtimeRoot = join(execSpecBase, '.runtime')
+    const runtimeRoot = platformOpts?.runtimeRoot || join(execSpecBase, '.runtime')
     const runIdFile = join(runtimeRoot, `current-execute-run-id-${changeName}`)
     mkdirSync(runtimeRoot, { recursive: true })
     // 优先读取已有的变更专属标记文件
@@ -3315,7 +3324,7 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
 
           if (planPath && existsSync(planPath)) {
             const planContent = readFileSync(planPath, 'utf8')
-            const runtimeRoot = join(effectiveSpecBase, '.runtime')
+            const runtimeRoot = platformOpts?.runtimeRoot || join(effectiveSpecBase, '.runtime')
 
             // execute run id：从变更专属标记文件读取
             const runIdFile = join(runtimeRoot, `current-execute-run-id-${changeName}`)