@applica-software-guru/sdd-core 1.3.3 → 1.4.0

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEvE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,KAAK;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;QACX,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;QACjD,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,SAAS,CAAC;AAEtD,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,wBAAwB,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAE5C,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,GAAG;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,cAAc,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEjF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,KAAK;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;QACX,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,eAAe,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAElE,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,wBAAwB,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,GAAG;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,cAAc,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@applica-software-guru/sdd-core",
-  "version": "1.3.3",
+  "version": "1.4.0",
   "description": "Core library for Story Driven Development",
   "author": "Bruno Fortunato <bruno.fortunato@applica.guru>",
   "main": "dist/index.js",

package/src/errors.ts

@@ -25,3 +25,19 @@ export class ProjectNotInitializedError extends SDDError {
     this.name = 'ProjectNotInitializedError';
   }
 }
+
+export class RemoteError extends SDDError {
+  public statusCode: number;
+  constructor(statusCode: number, message: string) {
+    super(`Remote error (${statusCode}): ${message}`);
+    this.name = 'RemoteError';
+    this.statusCode = statusCode;
+  }
+}
+
+export class RemoteNotConfiguredError extends SDDError {
+  constructor() {
+    super('Remote not configured. Run "sdd remote init" first.');
+    this.name = 'RemoteNotConfiguredError';
+  }
+}

package/src/index.ts

@@ -16,8 +16,9 @@ export type {
   Bug,
   BugFrontmatter,
   BugStatus,
+  RemoteConfig,
 } from "./types.js";
-export { SDDError, LockFileNotFoundError, ParseError, ProjectNotInitializedError } from "./errors.js";
+export { SDDError, LockFileNotFoundError, ParseError, ProjectNotInitializedError, RemoteError, RemoteNotConfiguredError } from "./errors.js";
 export type { ProjectInfo } from "./scaffold/templates.js";
 export { isSDDProject, readConfig, writeConfig } from "./config/config-manager.js";
 export { runAgent } from "./agent/agent-runner.js";
@@ -32,3 +33,24 @@ export type {
   AdapterFileChange,
   SyncAdaptersResult,
 } from "./scaffold/skill-adapters.js";
+
+// Remote sync
+export { generateDraftEnrichmentPrompt } from "./prompt/draft-prompt-generator.js";
+export type { DraftElements } from "./prompt/draft-prompt-generator.js";
+export { resolveApiKey, buildApiConfig, pullDocs, pushDocs, fetchPendingCRs, fetchOpenBugs, markCRAppliedRemote, markBugResolvedRemote, markDocEnriched, markCREnriched, markBugEnriched } from "./remote/api-client.js";
+export type { ApiClientConfig } from "./remote/api-client.js";
+export { readRemoteState, writeRemoteState } from "./remote/state.js";
+export { pushToRemote, pullFromRemote, pullCRsFromRemote, pullBugsFromRemote, getRemoteStatus } from "./remote/sync-engine.js";
+export type {
+  RemoteDocResponse,
+  RemoteDocBulkResponse,
+  RemoteCRResponse,
+  RemoteBugResponse,
+  RemoteState,
+  RemoteDocState,
+  PushResult,
+  PullResult,
+  PullConflict,
+  PullEntitiesResult,
+  RemoteStatusResult,
+} from "./remote/types.js";

package/src/prompt/apply-prompt-generator.ts

@@ -1,18 +1,77 @@
 import type { Bug, ChangeRequest, StoryFile } from '../types.js';
 import { getFileDiff } from '../git/git.js';
+import type { DraftElements } from './draft-prompt-generator.js';
 
 export function generateApplyPrompt(
   bugs: Bug[],
   changeRequests: ChangeRequest[],
   pendingFiles: StoryFile[],
-  root: string
+  root: string,
+  drafts?: DraftElements,
+  projectContext?: StoryFile[],
+  projectDescription?: string,
 ): string | null {
-  if (bugs.length === 0 && changeRequests.length === 0 && pendingFiles.length === 0) {
+  const hasDrafts = drafts && (drafts.docs.length > 0 || drafts.crs.length > 0 || drafts.bugs.length > 0);
+  if (bugs.length === 0 && changeRequests.length === 0 && pendingFiles.length === 0 && !hasDrafts) {
     return null;
   }
 
   const sections: string[] = [];
 
+  // Draft enrichment section (takes priority)
+  if (hasDrafts) {
+    sections.push(`# Draft Enrichment\n`);
+
+    if (projectDescription) {
+      sections.push(`## Project\n\n${projectDescription}\n`);
+    }
+
+    // Global context for enrichment
+    if (projectContext && projectContext.length > 0) {
+      const ctxLines = [`## Project context (${projectContext.length} documents)\n`];
+      ctxLines.push('Use the following existing documents as context to produce complete, coherent documentation.\n');
+      for (const f of projectContext) {
+        ctxLines.push(`### \`${f.relativePath}\` — ${f.frontmatter.title}\n`);
+        ctxLines.push(f.body.trim());
+        ctxLines.push('');
+      }
+      sections.push(ctxLines.join('\n'));
+    }
+
+    if (drafts!.docs.length > 0) {
+      const lines = [`## Draft documents to enrich (${drafts!.docs.length})\n`];
+      lines.push('Each draft below contains incomplete human-written content. Produce a complete version for each document, preserving the original intent while adding missing details based on project context.\n');
+      for (const f of drafts!.docs) {
+        lines.push(`### \`${f.relativePath}\` — ${f.frontmatter.title}\n`);
+        lines.push(f.body.trim());
+        lines.push('');
+      }
+      sections.push(lines.join('\n'));
+    }
+
+    if (drafts!.crs.length > 0) {
+      const lines = [`## Draft change requests to enrich (${drafts!.crs.length})\n`];
+      lines.push('Each draft CR contains a rough description of requested changes. Produce a complete, actionable change request for each.\n');
+      for (const cr of drafts!.crs) {
+        lines.push(`### \`${cr.relativePath}\` — ${cr.frontmatter.title}\n`);
+        lines.push(cr.body.trim());
+        lines.push('');
+      }
+      sections.push(lines.join('\n'));
+    }
+
+    if (drafts!.bugs.length > 0) {
+      const lines = [`## Draft bugs to enrich (${drafts!.bugs.length})\n`];
+      lines.push('Each draft bug contains a rough description of an issue. Produce a complete bug report for each.\n');
+      for (const bug of drafts!.bugs) {
+        lines.push(`### \`${bug.relativePath}\` — ${bug.frontmatter.title}\n`);
+        lines.push(bug.body.trim());
+        lines.push('');
+      }
+      sections.push(lines.join('\n'));
+    }
+  }
+
   // Bugs
   if (bugs.length > 0) {
     const lines = [`## Open bugs (${bugs.length})\n`];

package/src/prompt/draft-prompt-generator.ts

@@ -0,0 +1,74 @@
+import type { Bug, ChangeRequest, StoryFile } from '../types.js';
+
+export interface DraftElements {
+  docs: StoryFile[];
+  crs: ChangeRequest[];
+  bugs: Bug[];
+}
+
+export function generateDraftEnrichmentPrompt(
+  drafts: DraftElements,
+  projectContext: StoryFile[],
+  projectDescription: string,
+): string | null {
+  const totalDrafts = drafts.docs.length + drafts.crs.length + drafts.bugs.length;
+  if (totalDrafts === 0) {
+    return null;
+  }
+
+  const sections: string[] = [];
+
+  // Project context header
+  sections.push(`# Draft Enrichment\n`);
+  sections.push(`## Project\n\n${projectDescription}\n`);
+
+  // Global context: all non-draft documents
+  if (projectContext.length > 0) {
+    const ctxLines = [`## Project context (${projectContext.length} documents)\n`];
+    ctxLines.push('Use the following existing documents as context to produce complete, coherent documentation.\n');
+    for (const f of projectContext) {
+      ctxLines.push(`### \`${f.relativePath}\` — ${f.frontmatter.title}\n`);
+      ctxLines.push(f.body.trim());
+      ctxLines.push('');
+    }
+    sections.push(ctxLines.join('\n'));
+  }
+
+  // Draft documents
+  if (drafts.docs.length > 0) {
+    const lines = [`## Draft documents to enrich (${drafts.docs.length})\n`];
+    lines.push('Each draft below contains incomplete human-written content. Produce a complete version for each document, preserving the original intent while adding missing details based on project context.\n');
+    for (const f of drafts.docs) {
+      lines.push(`### \`${f.relativePath}\` — ${f.frontmatter.title}\n`);
+      lines.push(f.body.trim());
+      lines.push('');
+    }
+    sections.push(lines.join('\n'));
+  }
+
+  // Draft change requests
+  if (drafts.crs.length > 0) {
+    const lines = [`## Draft change requests to enrich (${drafts.crs.length})\n`];
+    lines.push('Each draft CR contains a rough description of requested changes. Produce a complete, actionable change request for each, specifying which documents are affected and what changes should be made.\n');
+    for (const cr of drafts.crs) {
+      lines.push(`### \`${cr.relativePath}\` — ${cr.frontmatter.title}\n`);
+      lines.push(cr.body.trim());
+      lines.push('');
+    }
+    sections.push(lines.join('\n'));
+  }
+
+  // Draft bugs
+  if (drafts.bugs.length > 0) {
+    const lines = [`## Draft bugs to enrich (${drafts.bugs.length})\n`];
+    lines.push('Each draft bug contains a rough description of an issue. Produce a complete bug report for each, including affected components, expected vs actual behavior, and steps to reproduce when possible.\n');
+    for (const bug of drafts.bugs) {
+      lines.push(`### \`${bug.relativePath}\` — ${bug.frontmatter.title}\n`);
+      lines.push(bug.body.trim());
+      lines.push('');
+    }
+    sections.push(lines.join('\n'));
+  }
+
+  return sections.join('\n\n');
+}

package/src/remote/api-client.ts

@@ -0,0 +1,138 @@
+import type { SDDConfig } from '../types.js';
+import { RemoteError, RemoteNotConfiguredError } from '../errors.js';
+import type {
+  RemoteDocResponse,
+  RemoteDocBulkResponse,
+  RemoteCRResponse,
+  RemoteBugResponse,
+} from './types.js';
+
+export interface ApiClientConfig {
+  baseUrl: string;
+  apiKey: string;
+}
+
+/**
+ * Resolve API key: SDD_API_KEY env var > config.remote.api-key > null
+ */
+export function resolveApiKey(config: SDDConfig): string | null {
+  const envKey = process.env.SDD_API_KEY;
+  if (envKey) return envKey;
+  return config.remote?.['api-key'] ?? null;
+}
+
+/**
+ * Build an ApiClientConfig from the SDD project config.
+ * Throws RemoteNotConfiguredError if URL or API key is missing.
+ */
+export function buildApiConfig(config: SDDConfig): ApiClientConfig {
+  if (!config.remote?.url) {
+    throw new RemoteNotConfiguredError();
+  }
+  const apiKey = resolveApiKey(config);
+  if (!apiKey) {
+    throw new RemoteNotConfiguredError();
+  }
+  return {
+    baseUrl: config.remote.url.replace(/\/+$/, ''),
+    apiKey,
+  };
+}
+
+async function request<T>(
+  config: ApiClientConfig,
+  method: string,
+  path: string,
+  body?: unknown,
+): Promise<T> {
+  const url = `${config.baseUrl}${path}`;
+  const headers: Record<string, string> = {
+    Authorization: `Bearer ${config.apiKey}`,
+    'Content-Type': 'application/json',
+  };
+
+  const res = await fetch(url, {
+    method,
+    headers,
+    body: body != null ? JSON.stringify(body) : undefined,
+  });
+
+  if (!res.ok) {
+    let message: string;
+    try {
+      const err = (await res.json()) as { detail?: string };
+      message = err.detail ?? res.statusText;
+    } catch {
+      message = res.statusText;
+    }
+    throw new RemoteError(res.status, message);
+  }
+
+  return (await res.json()) as T;
+}
+
+/** GET /cli/pull-docs */
+export async function pullDocs(config: ApiClientConfig): Promise<RemoteDocResponse[]> {
+  return request<RemoteDocResponse[]>(config, 'GET', '/cli/pull-docs');
+}
+
+/** POST /cli/push-docs */
+export async function pushDocs(
+  config: ApiClientConfig,
+  documents: Array<{ path: string; title: string; content: string }>,
+): Promise<RemoteDocBulkResponse> {
+  return request<RemoteDocBulkResponse>(config, 'POST', '/cli/push-docs', { documents });
+}
+
+/** GET /cli/pending-crs */
+export async function fetchPendingCRs(config: ApiClientConfig): Promise<RemoteCRResponse[]> {
+  return request<RemoteCRResponse[]>(config, 'GET', '/cli/pending-crs');
+}
+
+/** GET /cli/open-bugs */
+export async function fetchOpenBugs(config: ApiClientConfig): Promise<RemoteBugResponse[]> {
+  return request<RemoteBugResponse[]>(config, 'GET', '/cli/open-bugs');
+}
+
+/** POST /cli/crs/:crId/applied */
+export async function markCRAppliedRemote(
+  config: ApiClientConfig,
+  crId: string,
+): Promise<RemoteCRResponse> {
+  return request<RemoteCRResponse>(config, 'POST', `/cli/crs/${crId}/applied`);
+}
+
+/** POST /cli/bugs/:bugId/resolved */
+export async function markBugResolvedRemote(
+  config: ApiClientConfig,
+  bugId: string,
+): Promise<RemoteBugResponse> {
+  return request<RemoteBugResponse>(config, 'POST', `/cli/bugs/${bugId}/resolved`);
+}
+
+/** POST /cli/docs/:docId/enriched — Notify remote that a draft doc has been enriched */
+export async function markDocEnriched(
+  config: ApiClientConfig,
+  docId: string,
+  content: string,
+): Promise<RemoteDocResponse> {
+  return request<RemoteDocResponse>(config, 'POST', `/cli/docs/${docId}/enriched`, { content });
+}
+
+/** POST /cli/crs/:crId/enriched — Notify remote that a draft CR has been enriched */
+export async function markCREnriched(
+  config: ApiClientConfig,
+  crId: string,
+  body: string,
+): Promise<RemoteCRResponse> {
+  return request<RemoteCRResponse>(config, 'POST', `/cli/crs/${crId}/enriched`, { body });
+}
+
+/** POST /cli/bugs/:bugId/enriched — Notify remote that a draft bug has been enriched */
+export async function markBugEnriched(
+  config: ApiClientConfig,
+  bugId: string,
+  body: string,
+): Promise<RemoteBugResponse> {
+  return request<RemoteBugResponse>(config, 'POST', `/cli/bugs/${bugId}/enriched`, { body });
+}

package/src/remote/state.ts

@@ -0,0 +1,35 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import type { RemoteState } from './types.js';
+
+const REMOTE_STATE_FILE = 'remote-state.json';
+
+function stateFilePath(root: string): string {
+  return resolve(root, '.sdd', REMOTE_STATE_FILE);
+}
+
+function emptyState(): RemoteState {
+  return { documents: {} };
+}
+
+export async function readRemoteState(root: string): Promise<RemoteState> {
+  const path = stateFilePath(root);
+  if (!existsSync(path)) {
+    return emptyState();
+  }
+  const content = await readFile(path, 'utf-8');
+  try {
+    return JSON.parse(content) as RemoteState;
+  } catch {
+    return emptyState();
+  }
+}
+
+export async function writeRemoteState(root: string, state: RemoteState): Promise<void> {
+  const dir = resolve(root, '.sdd');
+  if (!existsSync(dir)) {
+    await mkdir(dir, { recursive: true });
+  }
+  await writeFile(stateFilePath(root), JSON.stringify(state, null, 2), 'utf-8');
+}