opencode-swarm 7.108.0 → 7.109.0

package/dist/sdd/effective-spec.d.ts

@@ -203,6 +203,21 @@ export interface ReadEffectiveSpecOpts {
  * `.specify/` a non-competing source, matching both citations.
  */
 export declare function readEffectiveSpecSync(directory: string, opts?: ReadEffectiveSpecOpts): EffectiveSpec | null;
+/**
+ * Write an SDD projection to `.swarm/spec.md`.
+ *
+ * **Overwrite enforcement (FR-004, TOCTOU-safe):**
+ * When `overwrite` is `false` (default), the write uses `O_EXCL` exclusive
+ * creation (`fs.writeFileSync(target, data, { flag: 'wx' })`).  If the
+ * target already exists the kernel returns `EEXIST` and the function
+ * returns `written: false` with an `error` field — no archive, no replace.
+ * This closes the TOCTOU race at the write boundary: a native spec that
+ * appears between a pre-check and this call cannot be silently replaced.
+ *
+ * When `overwrite` is `true`, the existing archive-then-replace path runs.
+ *
+ * The `--dry-run` early-return remains untouched (before any write).
+ */
 export declare function writeProjectedSpecSync(directory: string, options?: {
     changeId?: string;
     dryRun?: boolean;
@@ -210,11 +225,17 @@ export declare function writeProjectedSpecSync(directory: string, options?: {
     source?: 'openspec' | 'speckit';
     /** Feature selector forwarded to buildSpeckitProjectionSync when source is speckit. */
     feature?: string;
+    /**
+     * When true, archive the existing spec and overwrite.
+     * When false (default), use O_EXCL (wx flag) — refuse if target exists.
+     */
+    overwrite?: boolean;
 }): {
     written: boolean;
     projection: EffectiveSpec | null;
     archivePath?: string;
     path: string;
+    error?: string;
 };
 /**
  * Validate Spec-Kit artifacts READ-ONLY (FR-007, task 2.3).

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.108.0",
+	"version": "7.109.0",
 	"description": "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",