wicked-crew-api-types 0.5.1 → 0.7.0

package/index.d.ts

@@ -288,6 +288,39 @@ export interface OpenPathBody {
   runId?: string;
 }
 
+/**
+ * Response of `GET /runs/:id/files?path=<abs>` (DES-FEEDBACK-002 CREW-1) — a capped, read-only
+ * file read contained against the SAME root set `POST /open` validates (run workdir + extra
+ * write roots + registered repo roots). 404 unknown run / missing file; 400 non-absolute path;
+ * 403 outside every allowed root (fail-closed, symlink-safe).
+ */
+export interface RunFileContent {
+  /** The resolved absolute path that was served. */
+  path: string;
+  /** UTF-8 file text — the first 512 KB when `truncated`, `""` when `binary`. */
+  content: string;
+  /** The file's FULL size in bytes (not the served slice's). */
+  size: number;
+  /** The file exceeds the 512 KB cap and `content` holds only the first 512 KB. */
+  truncated: boolean;
+  /** NUL byte in the first 8 KB — render "binary file · open externally", never the content. */
+  binary: boolean;
+}
+
+/**
+ * Response of `GET /runs/:id/diff` / `GET /runs/:id/diff?path=<abs>` (DES-FEEDBACK-002 CREW-1) —
+ * the run worktree's unified diff against HEAD (staged + unstaged), with untracked files appended
+ * as all-addition `--no-index` hunks. `diff: ""` = clean tree (a real answer, not an error).
+ * 404 unknown run; 409 when the run has no workdir or it no longer exists; with `path`, the same
+ * 400/403 containment as `RunFileContent`.
+ */
+export interface RunDiff {
+  /** Unified diff text (`git diff --no-color --no-ext-diff HEAD`), cut at 1 MB when `truncated`. */
+  diff: string;
+  /** The diff exceeded the 1 MB output cap and was cut. */
+  truncated: boolean;
+}
+
 /** The daemon's cached open-gate record (`GET /runs/:id/gate`, DES-STUDIO-001 §3.3). */
 export interface GateInfo {
   runId: string;
@@ -886,6 +919,18 @@ export interface LaunchRunBody {
    * (4xx) — never a silent unfiled run. Omit for an unfiled run (the synthesized `default`).
    */
   projectId?: string;
+  /**
+   * Delivery mode (crew#293). `"pr"` ⇒ the daemon appends a hardened deliver Tool phase (push
+   * the run's branch, rebase onto origin's default branch, `gh pr create`; the PR URL is the
+   * phase output's last line) to a PER-RUN copy of the selected workflow def — the shared def
+   * is never mutated, and merge stays human. Requires `workflow`; sending `deliver` without it
+   * is a 400. Omit ⇒ no delivery phase.
+   *
+   * NOTE for the next api-types release: added daemon-side first (workspace copy, 0.6.0 +
+   * crew#293) — fold into the published `LaunchRunBody` when 0.7.0 cuts. Optional, so the
+   * field is forward-additive on the wire (DES-STUDIO-001 §5.1).
+   */
+  deliver?: 'pr';
 }
 
 // ── Governance types (crew#40/41) ──────────────────────────────────────────────
@@ -1172,6 +1217,12 @@ export interface Project {
   created_at: number;
   /** Unix millis. */
   updated_at: number;
+  /**
+   * DES-MERGE-001 §7.1 — the wicked-interactive docs root this project speaks to; `null` ⇒
+   * the shared default root (ADR-0025). Held crew-side and merged onto the engine's row at the
+   * route boundary, so the wire carries ONE project shape. Always present on a read.
+   */
+  interactiveRoot?: string | null;
   [k: string]: unknown;
 }
 
@@ -1215,6 +1266,9 @@ export interface UpdateProjectBody {
   /** `""` clears the description. */
   description?: string;
   status?: ProjectLifecycle;
+  /** DES-MERGE-001 §7.1 — bind this project to a wicked-interactive docs root.
+   *  `null` clears the binding back to the shared default root. */
+  interactiveRoot?: string | null;
 }
 
 /** `POST /projects/:id/members` body. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "wicked-crew-api-types",
-  "version": "0.5.1",
-  "description": "The wire contract of the wicked-crew daemon's /api/v1 REST surface and /ws CoreEvent frames — types only, zero runtime",
+  "version": "0.7.0",
+  "description": "The wire contract of the wicked-crew daemon's /api/v1 REST surface and /ws CoreEvent frames \u2014 types only, zero runtime",
   "type": "module",
   "types": "./index.d.ts",
   "exports": {