clawspec 1.0.6 → 1.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawspec",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "type": "module",
   "description": "OpenClaw plugin that orchestrates OpenSpec project workflows with visible main-agent execution.",
   "keywords": [

package/src/orchestrator/service.ts

@@ -587,6 +587,7 @@ export class ClawSpecService {
         scaffoldOnly: planningContext.scaffoldOnly,
         mode: "sync",
         prefetchedInstructions: instructionResults.map((result) => result.parsed!).filter(Boolean),
+        prefetchedInstructionCommands: instructionResults.map((result) => result.command).filter(Boolean),
       }),
     };
   }

package/src/worker/prompts.ts

@@ -179,6 +179,7 @@ export function buildPlanningPrependContext(params: {
   mode: "discussion" | "sync";
   nextActionHint?: "plan" | "work";
   prefetchedInstructions?: OpenSpecInstructionsResponse[];
+  prefetchedInstructionCommands?: string[];
 }): string {
   const project = params.project;
 
@@ -198,6 +199,7 @@ export function buildPlanningPrependContext(params: {
         "10. Stop after planning artifacts are refreshed and apply-ready. Do not implement code in this turn.",
         "11. End with a concise summary and a mandatory final line exactly in this shape: `Next: run `cs-work` to start implementation.`",
         "12. Never scan sibling directories under `openspec/changes`, never switch to another change, and never restore or rewrite unrelated files.",
+        "13. Do not claim that OpenSpec instructions were skipped in this sync turn. The plugin already executed those commands before this turn began.",
       ]
     : [
         "Discussion rules for this turn:",
@@ -243,6 +245,15 @@ export function buildPlanningPrependContext(params: {
           `- ${instruction.artifactId}: ${displayPath(resolveProjectScopedPath(project, instruction.outputPath))}`,
         )
       : []),
+    ...(params.mode === "sync"
+      ? (params.prefetchedInstructions ?? []).flatMap((instruction) => [
+        "",
+        formatPrefetchedInstructionBlock(project, instruction),
+      ])
+      : []),
+    params.mode === "sync" ? "" : "",
+    params.mode === "sync" ? "OpenSpec commands already executed by the plugin before this turn:" : "",
+    ...(params.mode === "sync" ? (params.prefetchedInstructionCommands ?? []).map((command) => `- ${command}`) : []),
     params.scaffoldOnly ? "" : "",
     params.scaffoldOnly ? "Only the change scaffold exists right now. That is expected before planning sync generates the first artifacts." : "",
     "",
@@ -503,3 +514,17 @@ function relativeChangeFile(project: ProjectState, targetPath: string): string {
 function displayPath(targetPath: string): string {
   return targetPath.split(path.sep).join("/");
 }
+
+function formatPrefetchedInstructionBlock(
+  project: ProjectState,
+  instruction: OpenSpecInstructionsResponse,
+): string {
+  const outputPath = displayPath(resolveProjectScopedPath(project, instruction.outputPath));
+  return [
+    `Artifact ${instruction.artifactId} (output: ${outputPath})`,
+    "Instruction:",
+    fence(instruction.instruction || "(empty)", "markdown"),
+    "Template:",
+    fence(instruction.template || "(empty)", "markdown"),
+  ].join("\n");
+}

package/test/queue-planning.test.ts

@@ -133,7 +133,7 @@ test("apply reports no new planning notes when the chat context is detached", as
 
 test("cs-plan runs visible planning sync and writes a fresh snapshot", async () => {
   const harness = await createServiceHarness("clawspec-visible-plan-");
-  const { service, stateStore, repoPath } = harness;
+  const { service, stateStore, repoPath, openSpec } = harness;
   const channelKey = "discord:visible-plan:default:main";
   const promptContext = {
     trigger: "user",
@@ -149,6 +149,13 @@ test("cs-plan runs visible planning sync and writes a fresh snapshot", async ()
   await service.proposalProject(channelKey, "demo-change Demo change");
   await service.recordPlanningMessageFromContext(promptContext, "add another API endpoint");
 
+  const instructionCalls: string[] = [];
+  const originalInstructionsArtifact = openSpec.instructionsArtifact;
+  openSpec.instructionsArtifact = async (...args: unknown[]) => {
+    instructionCalls.push(String(args[1]));
+    return await originalInstructionsArtifact(...args);
+  };
+
   const injected = await service.handleBeforePromptBuild(
     { prompt: "cs-plan", messages: [] },
     promptContext,
@@ -157,7 +164,10 @@ test("cs-plan runs visible planning sync and writes a fresh snapshot", async ()
 
   assert.match(injected?.prependContext ?? "", /ClawSpec planning sync is active for this turn/);
   assert.match(injected?.prependContext ?? "", /Prefetched OpenSpec instructions for this turn/);
+  assert.match(injected?.prependContext ?? "", /OpenSpec commands already executed by the plugin before this turn/);
+  assert.match(injected?.prependContext ?? "", /openspec instructions proposal --change demo-change --json/);
   assert.match(injected?.prependContext ?? "", /planning-instructions[\\/]+proposal\.json/);
+  assert.deepEqual(instructionCalls, ["proposal", "specs", "design", "tasks"]);
   assert.match(injected?.prependContext ?? "", /mandatory final line exactly in this shape/i);
   assert.equal(runningProject?.status, "planning");
   assert.equal(runningProject?.phase, "planning_sync");