@bpmsoftwaresolutions/ai-engine-client 1.1.63 → 1.1.66

package/README.md

@@ -143,6 +143,8 @@ console.log(claimed.claim_id, claimed.context_session_id);
 
 This complements the lower-level flow exposed by `openContextSession()`, `acknowledgeReminder()`, `completeOrientation()`, `lockContextSessionClaim()`, `claimWorkItem()`, and `signoffClaim()`.
 
+For closure and write preflights, call `claimIsValid(claimId)` before you attempt roadmap mutations. The client does not yet expose a project-scoped `getActiveClaim(projectId)` helper because the backend currently only offers claim reads by claim id or by context session.
+
 ### Text and Binary Downloads
 
 Some methods do not return plain JSON:
@@ -422,8 +424,8 @@ const packet = await client.downloadExternalWorkflowRunArtifact('run-123', 'pack
 | `ping()` | Health check + current workflow name/status. |
 | `startSessionGovernance(body)` | Start a governed external session and return the `session_key` required for mutation-capable assistant turns. |
 | `claimWorkItem(body)` | Bind an oriented, claim-locked context session to a concrete work item and return the active claim envelope. |
+| `claimIsValid(claimId)` | Read a claim by id and confirm that it is still active before attempting a governed write. |
 | `persistAssistantTurn(body)` | Persist an assistant turn to durable SQL through the API and return refreshed status projections. |
-| `resumeProjectWork({ projectIdentifier, actorMode, executionIntent, requireClaim, workflowRunLimit })` | Canonical project startup and hydration call that resolves the continuation brief, active item, required tools, allowed scope, and next governed action from a project identifier. |
 | `createExternalAudioRender({ text, voice, model, speed, file })` | Create a client-scoped external audio render using inline text or multipart upload. |
 | `getExternalAudioRender(audioRenderRunId)` | Read external audio render status for the authenticated client. |
 | `downloadExternalAudioRender(audioRenderRunId)` | Download the rendered MP3 artifact for the authenticated client. |
@@ -593,6 +595,7 @@ Generated scripts are ephemeral helpers, not source-of-truth. The server keeps S
 | `downloadProjectMarkdownReport(projectId, reportType)` | Download a rendered markdown report as text plus filename metadata. |
 | `downloadProjectCharterReportMarkdown(projectId)` | Download the charter markdown report. |
 | `getProjectBundle(projectId)` | Get current status, charter report, and roadmap report in one payload. |
+| `resumeProjectWork({ projectIdentifier, actorMode, executionIntent, requireClaim, workflowRunLimit })` | Resume the governed continuation brief for a project. |
 
 ### Roadmaps
 | Method | Description |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmsoftwaresolutions/ai-engine-client",
-  "version": "1.1.63",
+  "version": "1.1.66",
   "description": "Thin npm client for the AI Engine operator and retrieval APIs",
   "type": "module",
   "main": "./src/index.js",

package/src/index.js

@@ -3558,6 +3558,11 @@ export class AIEngineClient {
     return this._request(`/api/governance/claims/${encodeURIComponent(claimId)}`);
   }
 
+  async claimIsValid(claimId) {
+    const claim = await this.getClaim(claimId);
+    return cleanText(claim?.status) === 'active';
+  }
+
   async getExecutionEligibility(body = {}) {
     return this._request('/api/governance/execution-eligibility', {
       method: 'POST',
@@ -4368,6 +4373,28 @@ export class AIEngineClient {
     return this._request(`/api/operator/projects/${projectId}/bundle`);
   }
 
+  async resumeProjectWork({
+    projectIdentifier,
+    projectId,
+    actorMode,
+    executionIntent,
+    requireClaim,
+    workflowRunLimit,
+  } = {}) {
+    const normalizedProjectIdentifier = cleanText(projectIdentifier) || cleanText(projectId);
+    if (!normalizedProjectIdentifier) {
+      throw new Error('projectIdentifier is required.');
+    }
+    return this._request(`/api/operator/projects/${encodeURIComponent(normalizedProjectIdentifier)}/resume-context`, {
+      query: {
+        actor_mode: actorMode,
+        execution_intent: executionIntent,
+        require_claim: requireClaim,
+        workflow_run_limit: workflowRunLimit,
+      },
+    });
+  }
+
   // LOGA projections are governed runtime documents, not static reports.
 
   async getLogaOperatorHomeProjection() {
@@ -5680,6 +5707,45 @@ export class AIEngineClient {
     });
   }
 
+  async checkGitShipReadiness({
+    claimId,
+    actorId,
+    targetBranch,
+    shipCommand,
+    packageName,
+    declaredScopeFiles,
+    stagedFiles,
+    dirtyFiles,
+    branch,
+    headSha,
+    packageJsonVersion,
+    facadeMinClientVersion,
+    packageRelease,
+    packageJsonHash,
+    sdkVersionHash,
+  } = {}) {
+    return this._request('/api/commit-governance/ship-readiness', {
+      method: 'POST',
+      body: {
+        claim_id: claimId,
+        actor_id: actorId,
+        target_branch: targetBranch,
+        ship_command: shipCommand,
+        package_name: packageName,
+        declared_scope_files: declaredScopeFiles,
+        staged_files: stagedFiles,
+        dirty_files: dirtyFiles,
+        branch,
+        head_sha: headSha,
+        package_json_version: packageJsonVersion,
+        facade_min_client_version: facadeMinClientVersion,
+        package_release: packageRelease,
+        package_json_hash: packageJsonHash,
+        sdk_version_hash: sdkVersionHash,
+      },
+    });
+  }
+
   async getCommitGovernanceEvaluation(evaluationId) {
     return this._request(`/api/commit-governance/evaluations/${encodeURIComponent(evaluationId)}`);
   }