@neriros/ralphy 3.3.2 → 3.5.0

package/dist/mcp/index.js

@@ -25106,22 +25106,6 @@ ${existing.trimStart()}` : `${message}
     await mkdir(dirname3(tasksPath), { recursive: true });
     await Bun.write(tasksPath, next);
   }
-  async readSection(name, artifact, heading) {
-    const file = Bun.file(join4("openspec", "changes", name, artifact));
-    if (!await file.exists())
-      return "";
-    const content = await file.text();
-    const headingIndex = content.indexOf(heading);
-    if (headingIndex === -1)
-      return "";
-    const afterHeading = content.slice(headingIndex + heading.length);
-    const levelMatch = heading.match(/^(#+)/);
-    const level = levelMatch ? levelMatch[1].length : 2;
-    const nextHeadingPattern = new RegExp(`\\n#{1,${level}} `);
-    const nextMatch = afterHeading.match(nextHeadingPattern);
-    const sectionContent = nextMatch ? afterHeading.slice(0, nextMatch.index) : afterHeading;
-    return sectionContent.trim();
-  }
   async validateChange(name) {
     const result = runOpenspec(["validate", name, "--json", "--no-interactive"]);
     if (result.stdout) {
@@ -25140,8 +25124,71 @@ ${existing.trimStart()}` : `${message}
       errors: result.stderr ? [result.stderr] : []
     };
   }
+  async getStatus(name) {
+    const result = runOpenspec(["status", "--change", name, "--json"]);
+    if (result.stdout) {
+      try {
+        const parsed = JSON.parse(result.stdout);
+        const status = {
+          changeName: parsed.changeName ?? name,
+          isComplete: parsed.isComplete ?? false,
+          applyRequires: parsed.applyRequires ?? [],
+          artifacts: parsed.artifacts ?? []
+        };
+        if (parsed.schemaName !== undefined)
+          status.schemaName = parsed.schemaName;
+        return status;
+      } catch {}
+    }
+    return {
+      changeName: name,
+      isComplete: false,
+      applyRequires: [],
+      artifacts: []
+    };
+  }
+  async getInstructions(name, artifact) {
+    const result = runOpenspec(["instructions", artifact, "--change", name, "--json"]);
+    if (result.stdout) {
+      try {
+        const parsed = JSON.parse(result.stdout);
+        const out = {
+          changeName: parsed.changeName ?? name,
+          artifactId: parsed.artifactId ?? artifact,
+          instruction: parsed.instruction ?? ""
+        };
+        if (parsed.outputPath !== undefined)
+          out.outputPath = parsed.outputPath;
+        if (parsed.description !== undefined)
+          out.description = parsed.description;
+        if (parsed.template !== undefined)
+          out.template = parsed.template;
+        if (parsed.dependencies !== undefined)
+          out.dependencies = parsed.dependencies;
+        return out;
+      } catch {}
+    }
+    return { changeName: name, artifactId: artifact, instruction: "" };
+  }
+  async showChange(name) {
+    const result = runOpenspec(["show", name, "--json", "--type", "change"]);
+    if (result.stdout) {
+      try {
+        const parsed = JSON.parse(result.stdout);
+        const out = {
+          id: parsed.id ?? name,
+          deltaCount: parsed.deltaCount ?? 0,
+          deltas: parsed.deltas ?? []
+        };
+        if (parsed.title !== undefined)
+          out.title = parsed.title;
+        return out;
+      } catch {}
+    }
+    return { id: name, deltaCount: 0, deltas: [] };
+  }
   async archiveChange(name) {
-    const result = runOpenspec(["archive", name, "-y", "--skip-specs"], { inherit: true });
+    const result = runOpenspec(["archive", name, "-y"], { inherit: true });
     if (result.status !== 0) {
       throw new Error("openspec archive failed");
     }

package/dist/shell/index.js

@@ -18928,8 +18928,8 @@ import { readFileSync } from "fs";
 import { resolve } from "path";
 function getVersion() {
   try {
-    if ("3.3.2")
-      return "3.3.2";
+    if ("3.5.0")
+      return "3.5.0";
   } catch {}
   const dirsToTry = [];
   try {
@@ -59558,22 +59558,6 @@ ${existing.trimStart()}` : `${message}
     await mkdir(dirname4(tasksPath), { recursive: true });
     await Bun.write(tasksPath, next);
   }
-  async readSection(name, artifact, heading) {
-    const file = Bun.file(join6("openspec", "changes", name, artifact));
-    if (!await file.exists())
-      return "";
-    const content = await file.text();
-    const headingIndex = content.indexOf(heading);
-    if (headingIndex === -1)
-      return "";
-    const afterHeading = content.slice(headingIndex + heading.length);
-    const levelMatch = heading.match(/^(#+)/);
-    const level = levelMatch ? levelMatch[1].length : 2;
-    const nextHeadingPattern = new RegExp(`\\n#{1,${level}} `);
-    const nextMatch = afterHeading.match(nextHeadingPattern);
-    const sectionContent = nextMatch ? afterHeading.slice(0, nextMatch.index) : afterHeading;
-    return sectionContent.trim();
-  }
   async validateChange(name) {
     const result2 = runOpenspec(["validate", name, "--json", "--no-interactive"]);
     if (result2.stdout) {
@@ -59592,8 +59576,71 @@ ${existing.trimStart()}` : `${message}
       errors: result2.stderr ? [result2.stderr] : []
     };
   }
+  async getStatus(name) {
+    const result2 = runOpenspec(["status", "--change", name, "--json"]);
+    if (result2.stdout) {
+      try {
+        const parsed = JSON.parse(result2.stdout);
+        const status = {
+          changeName: parsed.changeName ?? name,
+          isComplete: parsed.isComplete ?? false,
+          applyRequires: parsed.applyRequires ?? [],
+          artifacts: parsed.artifacts ?? []
+        };
+        if (parsed.schemaName !== undefined)
+          status.schemaName = parsed.schemaName;
+        return status;
+      } catch {}
+    }
+    return {
+      changeName: name,
+      isComplete: false,
+      applyRequires: [],
+      artifacts: []
+    };
+  }
+  async getInstructions(name, artifact) {
+    const result2 = runOpenspec(["instructions", artifact, "--change", name, "--json"]);
+    if (result2.stdout) {
+      try {
+        const parsed = JSON.parse(result2.stdout);
+        const out = {
+          changeName: parsed.changeName ?? name,
+          artifactId: parsed.artifactId ?? artifact,
+          instruction: parsed.instruction ?? ""
+        };
+        if (parsed.outputPath !== undefined)
+          out.outputPath = parsed.outputPath;
+        if (parsed.description !== undefined)
+          out.description = parsed.description;
+        if (parsed.template !== undefined)
+          out.template = parsed.template;
+        if (parsed.dependencies !== undefined)
+          out.dependencies = parsed.dependencies;
+        return out;
+      } catch {}
+    }
+    return { changeName: name, artifactId: artifact, instruction: "" };
+  }
+  async showChange(name) {
+    const result2 = runOpenspec(["show", name, "--json", "--type", "change"]);
+    if (result2.stdout) {
+      try {
+        const parsed = JSON.parse(result2.stdout);
+        const out = {
+          id: parsed.id ?? name,
+          deltaCount: parsed.deltaCount ?? 0,
+          deltas: parsed.deltas ?? []
+        };
+        if (parsed.title !== undefined)
+          out.title = parsed.title;
+        return out;
+      } catch {}
+    }
+    return { id: name, deltaCount: 0, deltas: [] };
+  }
   async archiveChange(name) {
-    const result2 = runOpenspec(["archive", name, "-y", "--skip-specs"], { inherit: true });
+    const result2 = runOpenspec(["archive", name, "-y"], { inherit: true });
     if (result2.status !== 0) {
       throw new Error("openspec archive failed");
     }
@@ -70726,6 +70773,14 @@ function useLoop(opts) {
           writeState(stateDir, currentState);
           setState(currentState);
           try {
+            if (typeof opts.changeStore.getStatus === "function") {
+              const status = await opts.changeStore.getStatus(opts.name);
+              if (!status.isComplete) {
+                const blocked = status.artifacts.filter((a) => a.status !== "done").map((a) => `${a.id}=${a.status}`).join(", ");
+                addInfo(`Archive skipped: openspec status reports change incomplete (${blocked || "no artifacts"}).`);
+                throw new Error("openspec status: change not complete");
+              }
+            }
             await opts.changeStore.archiveChange(opts.name);
             addInfo("Change archived.");
           } catch (err) {
@@ -92613,6 +92668,7 @@ var init_schema = __esm(() => {
       codeReviewTrigger: exports_external2.boolean().default(true),
       codeReviewStaleHours: exports_external2.number().nonnegative().default(24),
       syncTasksToComment: exports_external2.boolean().default(true),
+      syncSpecsAsAttachments: exports_external2.boolean().default(true),
       indicators: IndicatorsSchema.default({})
     }).strict().default({
       postComments: true,
@@ -92622,6 +92678,7 @@ var init_schema = __esm(() => {
       codeReviewTrigger: true,
       codeReviewStaleHours: 24,
       syncTasksToComment: true,
+      syncSpecsAsAttachments: true,
       indicators: {}
     }),
     github: exports_external2.object({
@@ -92776,6 +92833,11 @@ linear:
   # cadence as updateEveryIterations, and on done-transition.
   syncTasksToComment: true
 
+  # Upload openspec proposal.md and design.md as Linear attachments on the
+  # parent issue. Refreshed when file contents change, no-op otherwise.
+  # Requires syncTasksToComment.
+  syncSpecsAsAttachments: true
+
   # Indicators map Ralph lifecycle events to Linear labels/statuses.
   #
   # Filter semantics (per indicator's \`filter:\` list):
@@ -93763,10 +93825,45 @@ function buildIssueFilter(spec) {
   }
   return where;
 }
+function clauseFromMarkers(markers) {
+  if (markers.length === 0)
+    return null;
+  const { statuses, labels, attachmentSubtitles, projects } = partition2(markers);
+  const parts = {};
+  if (statuses.length > 0)
+    parts.state = { name: { in: statuses } };
+  if (labels.length > 0)
+    parts.labels = { some: { name: { in: labels } } };
+  if (attachmentSubtitles.length > 0) {
+    parts.attachments = {
+      some: {
+        title: { eq: RALPHY_ATTACHMENT_TITLE_FILTER },
+        subtitle: { in: attachmentSubtitles }
+      }
+    };
+  }
+  if (projects.length > 0)
+    parts.project = { name: { in: projects } };
+  return Object.keys(parts).length > 0 ? parts : null;
+}
 async function fetchMentionScanIssues(apiKey, spec) {
-  const where = {
-    state: { type: { in: ["unstarted", "started", "backlog", "triage", "completed"] } }
-  };
+  const branches = [];
+  const { getTodo, getInProgress, setDone } = spec.indicators;
+  for (const ind of [getTodo, getInProgress]) {
+    if (!ind)
+      continue;
+    const c = clauseFromMarkers(ind.filter);
+    if (c)
+      branches.push(c);
+  }
+  if (setDone) {
+    const c = clauseFromMarkers(markersOf(setDone));
+    if (c)
+      branches.push(c);
+  }
+  if (branches.length === 0)
+    return [];
+  const where = branches.length === 1 ? { ...branches[0] } : { or: branches };
   if (spec.team)
     where.team = { key: { eq: spec.team } };
   if (spec.assignee) {
@@ -93949,6 +94046,66 @@ async function linearRequest(apiKey, query, variables) {
   }
   throw lastHttpError ?? new Error("Linear API request failed");
 }
+async function uploadFileToLinear(apiKey, input) {
+  const mutation = `mutation FileUpload($filename: String!, $contentType: String!, $size: Int!) {
+    fileUpload(filename: $filename, contentType: $contentType, size: $size) {
+      uploadFile { uploadUrl assetUrl headers { key value } }
+    }
+  }`;
+  const data = await linearRequest(apiKey, mutation, {
+    filename: input.filename,
+    contentType: input.contentType,
+    size: input.bytes.byteLength
+  });
+  const up = data.uploadFile;
+  if (!up)
+    throw new Error("fileUpload returned no uploadFile payload");
+  const headers = { "Content-Type": input.contentType };
+  for (const h of up.headers)
+    headers[h.key] = h.value;
+  const res = await fetch(up.uploadUrl, {
+    method: "PUT",
+    headers,
+    body: input.bytes
+  });
+  if (!res.ok) {
+    const body = await res.text().catch(() => "");
+    const err = new Error("Linear file upload PUT failed");
+    err.status = res.status;
+    err.body = body;
+    throw err;
+  }
+  return { assetUrl: up.assetUrl };
+}
+async function createAttachmentForUrl(apiKey, input) {
+  const mutation = `mutation CreateAttachment(
+    $issueId: String!, $url: String!, $title: String!, $subtitle: String
+  ) {
+    attachmentCreate(input: { issueId: $issueId, url: $url, title: $title, subtitle: $subtitle }) {
+      success
+      attachment { id }
+    }
+  }`;
+  const data = await linearRequest(apiKey, mutation, {
+    issueId: input.issueId,
+    url: input.url,
+    title: input.title,
+    subtitle: input.subtitle ?? null
+  });
+  const id = data.attachmentCreate.attachment?.id;
+  if (!id)
+    throw new Error("attachmentCreate returned no attachment id");
+  return id;
+}
+async function updateAttachmentUrl(apiKey, attachmentId, url2, subtitle) {
+  const mutation = subtitle === undefined ? `mutation UpdateAttachmentUrl($id: String!, $url: String!) {
+    attachmentUpdate(id: $id, input: { url: $url }) { success }
+  }` : `mutation UpdateAttachmentUrl($id: String!, $url: String!, $subtitle: String!) {
+    attachmentUpdate(id: $id, input: { url: $url, subtitle: $subtitle }) { success }
+  }`;
+  const variables = subtitle === undefined ? { id: attachmentId, url: url2 } : { id: attachmentId, url: url2, subtitle };
+  await linearRequest(apiKey, mutation, variables);
+}
 async function addReactionToComment(apiKey, commentId, emoji3) {
   const mutation = `mutation Reaction($commentId: String!, $emoji: String!) {
     reactionCreate(input: { commentId: $commentId, emoji: $emoji }) { success }
@@ -94277,6 +94434,7 @@ async function removeLabelFromIssue(apiKey, issueId, labelId) {
 }
 var LINEAR_API = "https://api.linear.app/graphql", RALPHY_ATTACHMENT_TITLE_FILTER = "Ralphy", linearRequestInternals, MAX_LINEAR_ATTEMPTS = 3, MAX_RETRY_AFTER_MS = 2000, RALPHY_ATTACHMENT_TITLE = "Ralphy", BRANCH_LABEL_PREFIX = "ralph:branch:";
 var init_linear = __esm(() => {
+  init_types2();
   linearRequestInternals = {
     sleep: (ms) => Bun.sleep(ms)
   };
@@ -94471,6 +94629,7 @@ class AgentCoordinator {
     this.spawnNext();
     const prStatus = await this.scanDoneForConflicts();
     await this.reportProgress();
+    await this.syncWorkerTasks();
     const buckets = {
       todo: todo.length,
       inProgress: inProgress.length,
@@ -94525,12 +94684,26 @@ class AgentCoordinator {
       } catch (err) {
         this.deps.onLog(`! Linear progress comment failed for ${w.issueIdentifier}: ${err.message}`, "red");
       }
-      if (this.deps.syncTasks) {
-        try {
-          await this.deps.syncTasks(w, count);
-        } catch (err) {
-          this.deps.onLog(`! sync-tasks (progress) failed for ${w.issueIdentifier}: ${err.message}`, "yellow");
-        }
+    }
+  }
+  async syncWorkerTasks() {
+    if (!this.deps.syncTasks || !this.deps.getIterationCount)
+      return;
+    for (const w of this.workers) {
+      let count;
+      try {
+        count = await this.deps.getIterationCount(w.changeName);
+      } catch (err) {
+        this.deps.onLog(`! iteration count read failed for ${w.issueIdentifier}: ${err.message}`, "yellow");
+        continue;
+      }
+      if (count === w.lastSyncedIteration)
+        continue;
+      try {
+        await this.deps.syncTasks(w, count);
+        w.lastSyncedIteration = count;
+      } catch (err) {
+        this.deps.onLog(`! sync-tasks (poll) failed for ${w.issueIdentifier}: ${err.message}`, "yellow");
       }
     }
   }
@@ -94690,6 +94863,7 @@ class AgentCoordinator {
       mode,
       kill: handle.kill,
       lastReportedIteration: 0,
+      lastSyncedIteration: 0,
       restarting: false
     };
     this.workers.push(worker);
@@ -94773,6 +94947,7 @@ class AgentCoordinator {
         mode,
         kill: () => {},
         lastReportedIteration: 0,
+        lastSyncedIteration: 0,
         restarting: false
       };
       try {
@@ -94880,7 +95055,7 @@ var init_coordinator = __esm(() => {
 import { join as join18 } from "path";
 import { mkdir as mkdir5 } from "fs/promises";
 function changeNameForIssue(issue2) {
-  const slug = issue2.title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 40);
+  const slug = issue2.title.toLowerCase().replace(/[^a-z0-9]+/g, "-").slice(0, 40).replace(/^-+|-+$/g, "");
   return slug ? `${issue2.identifier.toLowerCase()}-${slug}` : issue2.identifier.toLowerCase();
 }
 async function scaffoldChangeForIssue(tasksDir, statesDir, issue2, comments = [], appendPrompt = "") {
@@ -96235,24 +96410,28 @@ function truncate4(s, max2) {
 \u2026(truncated)`;
 }
 function renderTasksBlock(tasksMd, meta3) {
-  const sections = parseTasksMd(tasksMd);
+  const sections = parseTasksMd(tasksMd).filter((s) => s.heading.trim().toLowerCase() !== "planning");
   const out = [];
   out.push(RALPHY_TASKS_START);
   out.push("### Ralph progress");
   out.push("");
-  for (const section of sections) {
-    if (section.items.length === 0)
-      continue;
-    out.push(`**${section.heading}**`);
+  const renderable = sections.filter((s) => s.items.length > 0);
+  if (renderable.length === 0) {
+    out.push("_No mission tasks yet \u2014 planning in progress._");
     out.push("");
-    for (const item of section.items) {
-      out.push(item.bullet);
-      if (item.code !== undefined) {
-        const inner = truncate4(item.code, MAX_CODE_BLOCK_BYTES);
-        out.push(`  <details><summary>output</summary><pre>${inner}</pre></details>`);
+  } else {
+    for (const section of renderable) {
+      out.push(`**${section.heading}**`);
+      out.push("");
+      for (const item of section.items) {
+        out.push(item.bullet);
+        if (item.code !== undefined) {
+          const inner = truncate4(item.code, MAX_CODE_BLOCK_BYTES);
+          out.push(`  <details><summary>output</summary><pre>${inner}</pre></details>`);
+        }
       }
+      out.push("");
     }
-    out.push("");
   }
   out.push(`<sub>\`${meta3.changeName}\` \xB7 iteration ${meta3.iteration}</sub>`);
   out.push(RALPHY_TASKS_END);
@@ -96485,9 +96664,139 @@ var init_comment_sync = __esm(() => {
   init_linear_sync();
 });
 
-// apps/agent/src/agent/wire.ts
-import { join as join22 } from "path";
+// apps/agent/src/agent/linear-sync/spec-attachments.ts
+import { dirname as dirname8, join as join22 } from "path";
 import { mkdir as mkdir7 } from "fs/promises";
+async function readStateJson2(statePath) {
+  const file2 = Bun.file(statePath);
+  if (!await file2.exists())
+    return null;
+  try {
+    return await file2.json();
+  } catch {
+    return null;
+  }
+}
+async function writeStateJson2(statePath, state) {
+  await mkdir7(dirname8(statePath), { recursive: true });
+  await Bun.write(statePath, JSON.stringify(state, null, 2) + `
+`);
+}
+function readSpecState(state) {
+  const raw = state?.specAttachments ?? {};
+  return {
+    proposal: {
+      attachmentId: raw?.proposal?.attachmentId ?? null,
+      sha256: raw?.proposal?.sha256 ?? null
+    },
+    design: {
+      attachmentId: raw?.design?.attachmentId ?? null,
+      sha256: raw?.design?.sha256 ?? null
+    }
+  };
+}
+async function patchSpecState(statePath, patch) {
+  const existing = await readStateJson2(statePath) ?? {};
+  const current = readSpecState(existing);
+  const next = { ...current, [patch.slot]: patch.value };
+  await writeStateJson2(statePath, { ...existing, specAttachments: next });
+}
+function sha256Hex(bytes) {
+  const hasher = new Bun.CryptoHasher("sha256");
+  hasher.update(bytes);
+  return hasher.digest("hex");
+}
+async function syncSlot(deps, slot) {
+  const filename = SLOT_FILES[slot];
+  const path = join22(deps.changeDir, filename);
+  const file2 = Bun.file(path);
+  if (!await file2.exists()) {
+    deps.log(`  spec-attachments: ${filename} missing, skipping`, "gray");
+    return;
+  }
+  let bytes;
+  try {
+    bytes = await file2.bytes();
+  } catch (err) {
+    deps.log(`! spec-attachments: read ${filename} failed: ${err.message}`, "yellow");
+    return;
+  }
+  const hash2 = sha256Hex(bytes);
+  const state = await readStateJson2(deps.statePath);
+  const current = readSpecState(state)[slot] ?? EMPTY_SLOT;
+  if (current.attachmentId && current.sha256 === hash2) {
+    deps.log(`  spec-attachments: ${filename} unchanged, skipping`, "gray");
+    return;
+  }
+  const subtitle = `iteration ${deps.iteration}`;
+  let assetUrl;
+  try {
+    const uploaded = await deps.mutations.uploadFileToLinear(deps.apiKey, {
+      filename,
+      contentType: "text/markdown",
+      bytes
+    });
+    assetUrl = uploaded.assetUrl;
+  } catch (err) {
+    deps.log(`! spec-attachments: upload ${filename} failed: ${err.message}`, "yellow");
+    return;
+  }
+  if (current.attachmentId) {
+    try {
+      await deps.mutations.updateAttachmentUrl(deps.apiKey, current.attachmentId, assetUrl, subtitle);
+      await patchSpecState(deps.statePath, {
+        slot,
+        value: { attachmentId: current.attachmentId, sha256: hash2 }
+      });
+      deps.log(`  spec-attachments: refreshed ${filename}`, "gray");
+      return;
+    } catch (err) {
+      if (!isCommentNotFoundError(err)) {
+        deps.log(`! spec-attachments: updateAttachmentUrl ${filename} failed: ${err.message}`, "yellow");
+        return;
+      }
+      deps.log(`  spec-attachments: attachment ${current.attachmentId} not found \u2014 recreating`, "gray");
+    }
+  }
+  let newId;
+  try {
+    newId = await deps.mutations.createAttachmentForUrl(deps.apiKey, {
+      issueId: deps.issueId,
+      url: assetUrl,
+      title: ATTACHMENT_TITLES[slot],
+      subtitle
+    });
+  } catch (err) {
+    deps.log(`! spec-attachments: createAttachmentForUrl ${filename} failed: ${err.message}`, "yellow");
+    return;
+  }
+  await patchSpecState(deps.statePath, {
+    slot,
+    value: { attachmentId: newId, sha256: hash2 }
+  });
+  deps.log(`  spec-attachments: created ${filename} attachment`, "gray");
+}
+async function syncSpecAttachments(deps) {
+  await syncSlot(deps, "proposal");
+  await syncSlot(deps, "design");
+}
+var ATTACHMENT_TITLES, SLOT_FILES, EMPTY_SLOT;
+var init_spec_attachments = __esm(() => {
+  init_comment_sync();
+  ATTACHMENT_TITLES = {
+    proposal: "Ralph proposal",
+    design: "Ralph design"
+  };
+  SLOT_FILES = {
+    proposal: "proposal.md",
+    design: "design.md"
+  };
+  EMPTY_SLOT = { attachmentId: null, sha256: null };
+});
+
+// apps/agent/src/agent/wire.ts
+import { join as join23 } from "path";
+import { mkdir as mkdir8 } from "fs/promises";
 async function pickOpenPrUrlFromAttachments(urls, issueIdent, cmd, cwd2, onLog) {
   const candidates = urls.filter((url2) => GITHUB_PR_URL_RE.test(url2));
   let sawNonOpenPr = false;
@@ -96691,7 +97000,7 @@ function buildAgentCoordinator(input) {
     onWorkerOutput,
     onWorkerCmd
   } = input;
-  const logsDir = join22(projectRoot, ".ralph", "logs");
+  const logsDir = join23(projectRoot, ".ralph", "logs");
   const concurrency = args.concurrency || cfg.concurrency;
   const pollInterval = args.pollInterval || cfg.pollIntervalSeconds;
   const indicators = mergeIndicators(cfg.linear.indicators, args.indicators);
@@ -96883,7 +97192,15 @@ function buildAgentCoordinator(input) {
   async function prepare(issue2, mode, trigger) {
     const { workerCwd, scaffoldTasksDir, scaffoldStatesDir, branch } = await setupWorktree(issue2);
     let changeName;
-    const isFresh = mode === "fresh";
+    const wtLayoutPre = projectLayout(workerCwd);
+    const derivedName = changeNameForIssue(issue2);
+    const tasksMdPath = join23(wtLayoutPre.changeDir(derivedName), "tasks.md");
+    const tasksMdExists = await Bun.file(tasksMdPath).exists();
+    const needsScaffold = !tasksMdExists;
+    if (mode !== "fresh" && needsScaffold) {
+      onLog(`  ${issue2.identifier}: tasks.md missing at ${tasksMdPath} \u2014 rescaffolding`, "yellow");
+    }
+    const isFresh = mode === "fresh" || needsScaffold;
     if (isFresh) {
       let comments = [];
       try {
@@ -96913,10 +97230,9 @@ function buildAgentCoordinator(input) {
 `);
       changeName = await scaffoldChangeForIssue(scaffoldTasksDir, scaffoldStatesDir, issue2, comments, appendPrompt);
     } else {
-      changeName = changeNameForIssue(issue2);
-      const wtLayout = projectLayout(workerCwd);
-      await mkdir7(wtLayout.changeDir(changeName), { recursive: true });
-      await mkdir7(wtLayout.taskStateDir(changeName), { recursive: true });
+      changeName = derivedName;
+      await mkdir8(wtLayoutPre.changeDir(changeName), { recursive: true });
+      await mkdir8(wtLayoutPre.taskStateDir(changeName), { recursive: true });
     }
     cwdByChange.set(changeName, workerCwd);
     statesDirByChange.set(changeName, scaffoldStatesDir);
@@ -96925,7 +97241,7 @@ function buildAgentCoordinator(input) {
       branchByChange.set(changeName, branch);
     if (mode === "review") {
       const wtLayout = projectLayout(workerCwd);
-      const tasksFile = join22(wtLayout.changeDir(changeName), AGENT_TASKS_FILENAME);
+      const tasksFile = join23(wtLayout.changeDir(changeName), AGENT_TASKS_FILENAME);
       let body;
       let heading;
       if (trigger) {
@@ -96950,7 +97266,7 @@ function buildAgentCoordinator(input) {
       await reactivateState2(wtLayout.stateFile(changeName), changeName);
     } else if (mode === "conflict-fix") {
       const wtLayout = projectLayout(workerCwd);
-      const tasksFile = join22(wtLayout.changeDir(changeName), AGENT_TASKS_FILENAME);
+      const tasksFile = join23(wtLayout.changeDir(changeName), AGENT_TASKS_FILENAME);
       const prUrl = prByChange.get(changeName);
       const body = [
         `The PR for this change has merge conflicts with \`${cfg.prBaseBranch}\`.`,
@@ -97030,7 +97346,7 @@ PR: ${prUrl}` : ""
     return c;
   }
   function defaultSpawn(changeName, cmd, cwd2, note) {
-    const logFilePath = join22(logsDir, `${changeName}.log`);
+    const logFilePath = join23(logsDir, `${changeName}.log`);
     const ANSI_RE2 = /\x1b(?:\[[0-9;]*[A-Za-z]|\][^\x07\x1b]*(?:\x07|\x1b\\)|.)/g;
     const BOX_ONLY_RE = /^[\s\u2500\u2502\u256D\u256E\u2570\u256F\u254C\u2504\u2501\u2503]+$/;
     const STATUS_BAR_LINE_RE = /^[\u280B\u2819\u2839\u2838\u283C\u2834\u2826\u2827\u2807\u280F\u2713\u2717]\s+iter\s+\d+/;
@@ -97089,7 +97405,7 @@ PR: ${prUrl}` : ""
   function spawnWorker(changeName) {
     const cwd2 = cwdByChange.get(changeName) ?? projectRoot;
     const injected = input.runners?.spawnWorker;
-    const missionTasksPath = join22(projectLayout(cwd2).changeDir(changeName), MISSION_TASKS_FILENAME);
+    const missionTasksPath = join23(projectLayout(cwd2).changeDir(changeName), MISSION_TASKS_FILENAME);
     const prevTasksPromise = (async () => {
       const f2 = Bun.file(missionTasksPath);
       return await f2.exists() ? await f2.text() : "";
@@ -97097,7 +97413,7 @@ PR: ${prUrl}` : ""
     let logFilePath;
     let handle;
     if (injected) {
-      logFilePath = join22(logsDir, `${changeName}.log`);
+      logFilePath = join23(logsDir, `${changeName}.log`);
       handle = injected(buildTaskCmdFor(changeName), cwd2);
     } else {
       const r = defaultSpawn(changeName, buildTaskCmdFor(changeName), cwd2, `spawn at ${new Date().toISOString()}`);
@@ -97313,7 +97629,15 @@ PR: ${prUrl}` : ""
     const handle = cfg.linear.mentionHandle;
     let candidates = [];
     try {
-      candidates = await fetchMentionScanIssues(apiKey, { team, assignee });
+      candidates = await fetchMentionScanIssues(apiKey, {
+        team,
+        assignee,
+        indicators: {
+          ...indicators.getTodo !== undefined ? { getTodo: indicators.getTodo } : {},
+          ...indicators.getInProgress !== undefined ? { getInProgress: indicators.getInProgress } : {},
+          ...indicators.setDone !== undefined ? { setDone: indicators.setDone } : {}
+        }
+      });
     } catch (err) {
       if (isRateLimitedError(err)) {
         onLog(`! mention scan: rate limited, deferring rest of scan to next poll`, "yellow");
@@ -97604,6 +97928,12 @@ PR: ${prUrl}` : ""
     updateIssueComment,
     deleteIssueComment
   };
+  const specAttachmentsEnabled = Boolean(commentSyncEnabled && cfg.linear.syncSpecsAsAttachments);
+  const specAttachmentMutations = {
+    uploadFileToLinear,
+    createAttachmentForUrl,
+    updateAttachmentUrl
+  };
   const coord = new AgentCoordinator({
     fetchTodo: () => fetchByGet(indicators.getTodo, excludeFromTodo),
     fetchInProgress: () => fetchByGet(indicators.getInProgress, []),
@@ -97657,6 +97987,17 @@ PR: ${prUrl}` : ""
           log: onLog,
           mutations: commentMutations
         });
+        if (specAttachmentsEnabled) {
+          await syncSpecAttachments({
+            apiKey,
+            issueId: worker.issueId,
+            statePath,
+            changeDir,
+            iteration,
+            log: onLog,
+            mutations: specAttachmentMutations
+          });
+        }
       },
       onSteeringAppended: async (changeName, message) => {
         const root = cwdByChange.get(changeName) ?? projectRoot;
@@ -97794,6 +98135,7 @@ var init_wire = __esm(() => {
   init_gate();
   init_workflow();
   init_comment_sync();
+  init_spec_attachments();
   GITHUB_PR_URL_RE = /^https:\/\/github\.com\/[^/]+\/[^/]+\/pull\/\d+/;
   bunGitRunner = {
     run: async (args, cwd2) => {
@@ -98121,7 +98463,7 @@ var init_SteeringField = __esm(async () => {
 });
 
 // apps/agent/src/components/AgentMode.tsx
-import { join as join23 } from "path";
+import { join as join24 } from "path";
 async function appendSteeringImpl(changeDir, message) {
   await runWithContext(createDefaultContext(), async () => {
     appendSteeringMessage(changeDir, message);
@@ -98576,7 +98918,7 @@ function AgentMode({
       (async () => {
         for (const [changeName, meta3] of workerMetaRef.current) {
           try {
-            const file2 = Bun.file(join23(meta3.statesDir, changeName, ".ralph-state.json"));
+            const file2 = Bun.file(join24(meta3.statesDir, changeName, ".ralph-state.json"));
             if (await file2.exists()) {
               const json2 = await file2.json();
               meta3.iter = json2.iteration ?? meta3.iter;
@@ -98586,9 +98928,9 @@ function AgentMode({
           }
           if (meta3.changeDir) {
             try {
-              const tasksFile = Bun.file(join23(meta3.changeDir, "tasks.md"));
-              const proposalFile = Bun.file(join23(meta3.changeDir, "proposal.md"));
-              const designFile = Bun.file(join23(meta3.changeDir, "design.md"));
+              const tasksFile = Bun.file(join24(meta3.changeDir, "tasks.md"));
+              const proposalFile = Bun.file(join24(meta3.changeDir, "proposal.md"));
+              const designFile = Bun.file(join24(meta3.changeDir, "design.md"));
               const [tasksText, proposalText, designText] = await Promise.all([
                 tasksFile.exists().then((ok) => ok ? tasksFile.text() : null),
                 proposalFile.exists().then((ok) => ok ? proposalFile.text() : null),
@@ -98636,7 +98978,7 @@ function AgentMode({
   use_input_default((input, key) => {
     if (steeringFocusedRef.current)
       return;
-    if (key.ctrl && key.meta && (input === "t" || input === "T")) {
+    if (key.ctrl && (input === "l" || input === "L")) {
       if (activeCount > 0)
         setShowAllSubtasks((v) => !v);
       return;
@@ -99397,7 +99739,7 @@ function AgentMode({
                     }),
                     !showAllSubtasks && subtasks.length > MAX_PENDING_DISPLAY && /* @__PURE__ */ jsx_dev_runtime10.jsxDEV(Text, {
                       dimColor: true,
-                      children: `    \u2026 +${subtasks.length - MAX_PENDING_DISPLAY} more (CTRL+ALT+T to expand)`
+                      children: `    \u2026 +${subtasks.length - MAX_PENDING_DISPLAY} more (CTRL+L to expand)`
                     }, undefined, false, undefined, this)
                   ]
                 }, undefined, true, undefined, this),
@@ -99419,7 +99761,7 @@ function AgentMode({
                     },
                     onSubmit: async (message) => {
                       try {
-                        await appendSteering(join23(tasksDir, w.changeName), message);
+                        await appendSteering(join24(tasksDir, w.changeName), message);
                       } catch (err) {
                         appendLog(`! steering append failed for ${w.changeName}: ${err.message}`, "red");
                         throw err;
@@ -99629,7 +99971,7 @@ var exports_list = {};
 __export(exports_list, {
   runList: () => runList
 });
-import { join as join24 } from "path";
+import { join as join25 } from "path";
 function countTaskItems(content) {
   const checked = (content.match(/^- \[x\]/gm) ?? []).length;
   const unchecked = (content.match(/^- \[ \]/gm) ?? []).length;
@@ -99642,13 +99984,13 @@ function buildLocalRows(statesDir, projectRoot) {
   const sources = [{ dir: statesDir, label: "main" }];
   const worktreesRoot = worktreesDir2(projectRoot);
   for (const wt of storage.list(worktreesRoot)) {
-    sources.push({ dir: join24(worktreesRoot, wt, ".ralph", "tasks"), label: `wt:${wt}` });
+    sources.push({ dir: join25(worktreesRoot, wt, ".ralph", "tasks"), label: `wt:${wt}` });
   }
   for (const { dir, label } of sources) {
     for (const entry of storage.list(dir)) {
       if (seen.has(entry))
         continue;
-      const raw = storage.read(join24(dir, entry, ".ralph-state.json"));
+      const raw = storage.read(join25(dir, entry, ".ralph-state.json"));
       if (raw === null)
         continue;
       let state;
@@ -99663,7 +100005,7 @@ function buildLocalRows(statesDir, projectRoot) {
       const firstLine = promptRaw.split(`
 `).find((l) => l.trim() !== "") ?? "";
       let progress = "\u2014";
-      const tasksContent = storage.read(join24(dir, entry, "tasks.md"));
+      const tasksContent = storage.read(join25(dir, entry, "tasks.md"));
       if (tasksContent !== null) {
         const { checked, unchecked } = countTaskItems(tasksContent);
         const total = checked + unchecked;
@@ -100090,8 +100432,8 @@ var exports_json_runner = {};
 __export(exports_json_runner, {
   runAgentJson: () => runAgentJson
 });
-import { join as join25 } from "path";
-import { mkdir as mkdir8 } from "fs/promises";
+import { join as join26 } from "path";
+import { mkdir as mkdir9 } from "fs/promises";
 import { homedir as homedir5 } from "os";
 function cleanOutputLine2(raw) {
   const clean = raw.replace(ANSI_STRIP_RE2, "").trim();
@@ -100115,7 +100457,7 @@ async function runAgentJson({
   statesDir,
   tasksDir
 }) {
-  await mkdir8(join25(homedir5(), ".ralph"), { recursive: true }).catch(() => {
+  await mkdir9(join26(homedir5(), ".ralph"), { recursive: true }).catch(() => {
     return;
   });
   const cfgPath = await ensureRalphyConfig(projectRoot);
@@ -100269,8 +100611,8 @@ var exports_src2 = {};
 __export(exports_src2, {
   main: () => main2
 });
-import { mkdir as mkdir9 } from "fs/promises";
-import { join as join26 } from "path";
+import { mkdir as mkdir10 } from "fs/promises";
+import { join as join27 } from "path";
 async function main2(argv) {
   if (argv.includes("--help") || argv.includes("-h")) {
     printHelp2();
@@ -100304,9 +100646,9 @@ async function main2(argv) {
     });
     return typeof process.exitCode === "number" ? process.exitCode : 0;
   }
-  await mkdir9(statesDir, { recursive: true });
-  await mkdir9(tasksDir, { recursive: true });
-  await mkdir9(join26(projectRoot, ".ralph"), { recursive: true });
+  await mkdir10(statesDir, { recursive: true });
+  await mkdir10(tasksDir, { recursive: true });
+  await mkdir10(join27(projectRoot, ".ralph"), { recursive: true });
   if (args.jsonOutput) {
     const { runAgentJson: runAgentJson2 } = await Promise.resolve().then(() => (init_json_runner(), exports_json_runner));
     await runAgentJson2({ args, projectRoot, statesDir, tasksDir });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neriros/ralphy",
-  "version": "3.3.2",
+  "version": "3.5.0",
   "description": "An iterative AI task execution framework. Orchestrates multi-phase autonomous work using Claude or Codex engines.",
   "keywords": [
     "agent",