@codazen/harmonica-mcp 3.7.1 → 3.8.0

package/dist/index.js

@@ -21972,9 +21972,9 @@ function formatActivity(a) {
 function registerActivityTools(server, ctx, client) {
   server.tool(
     "list_activities",
-    "List project activity audit trail \u2014 shows beat changes, revision transitions, note operations, merges, splits, and reassignments. Sorted newest-first.",
+    "List system activity audit trail \u2014 shows beat changes, revision transitions, note operations, merges, splits, and reassignments. Sorted newest-first.",
     {
-      systemId: external_exports.string().describe("The project ID"),
+      systemId: external_exports.string().describe("The system ID"),
       limit: external_exports.coerce.number().min(1).max(100).optional().describe("Max activities to return (default 30)"),
       importance: external_exports.enum(IMPORTANCE_VALUES).optional().describe("Filter by minimum importance level")
     },
@@ -22005,7 +22005,7 @@ function registerAnalysisTools(server, ctx, client) {
     "cluster_entities",
     "Cluster any embeddable entity type (notes, beats, revisions) by vector similarity using DBSCAN. Returns groups of related entities \u2014 useful for understanding subsystem boundaries, finding duplicates, and planning batched work.",
     {
-      systemId: external_exports.string().describe("The project ID"),
+      systemId: external_exports.string().describe("The system ID"),
       entityType: ENTITY_TYPE_SCHEMA.describe("Entity type to cluster. Default: revision"),
       threshold: external_exports.coerce.number().min(0).max(1).optional().default(0.75).describe("DBSCAN similarity threshold (0-1). Higher = tighter clusters. Default 0.75"),
       minClusterSize: external_exports.coerce.number().int().min(2).optional().default(3).describe("Minimum cluster size. Default 3")
@@ -22034,9 +22034,9 @@ Analyzed: ${result.totalAnalyzed} | Clusters: ${result.clusters.length} | Noise:
   );
   server.tool(
     "run_clustered_analysis",
-    "Run batched analysis on clustered project entities. Groups entities by vector similarity, then runs a specified analysis type (docs, completeness, tech_debt, security) per cluster. Returns aggregated results.",
+    "Run batched analysis on clustered system entities. Groups entities by vector similarity, then runs a specified analysis type (docs, completeness, tech_debt, security) per cluster. Returns aggregated results.",
     {
-      systemId: external_exports.string().describe("The project ID"),
+      systemId: external_exports.string().describe("The system ID"),
       analysisType: ANALYSIS_TYPE_SCHEMA.describe("Type of analysis to run"),
       entityType: ENTITY_TYPE_SCHEMA.describe("Entity type to cluster. Default: revision"),
       threshold: external_exports.coerce.number().min(0).max(1).optional().default(0.7).describe("DBSCAN similarity threshold (0-1). Default 0.7"),
@@ -22071,9 +22071,9 @@ ${result.noise.join(", ")}` : "");
 function registerAuditIntegrityTools(server, ctx, client) {
   server.tool(
     "verify_audit_integrity",
-    "Verify the cryptographic integrity of audit trail records for a project. Checks SHA-256 hashes on Activity and PromptLog records to detect any post-creation tampering.",
+    "Verify the cryptographic integrity of audit trail records for a system. Checks SHA-256 hashes on Activity and PromptLog records to detect any post-creation tampering.",
     {
-      systemId: external_exports.string().describe("The project ID to verify"),
+      systemId: external_exports.string().describe("The system ID to verify"),
       limit: external_exports.number().optional().describe("Max records to verify (default 100)")
     },
     async ({ systemId, limit }) => {
@@ -22287,7 +22287,7 @@ Rationale: ${rationale}`;
     "bulk_reassign_revisions",
     "Reassign multiple revisions to new home Beats in a single call. Each item names a revision and its target Beat (different items can target different Beats \u2014 e.g., redistributing one Beat's revisions across several after decomposition). Each reassignment archives the original revision and creates a copy on the target Beat, identical to reassign_revision. Returns per-item success/failure so partial failures don't abort the batch. Use when migrating many revisions at once after a Beat split.",
     {
-      systemId: external_exports.string().describe("The project ID (for access control \u2014 all revisions and target beats must belong to this project)"),
+      systemId: external_exports.string().describe("The system ID (for access control \u2014 all revisions and target beats must belong to this system)"),
       items: external_exports.array(external_exports.object({
         revisionId: external_exports.string().describe("The revision ID to reassign"),
         toBeatId: external_exports.string().describe("The target beat ID for this specific revision")
@@ -22328,7 +22328,7 @@ Rationale: ${rationale}`;
     "reassign_revision",
     "Reassign a misattributed revision from one Beat to another. Creates a copy on the target Beat and archives the original. Logs a revision_reassigned activity for audit trail.",
     {
-      systemId: external_exports.string().describe("The project ID (for access control)"),
+      systemId: external_exports.string().describe("The system ID (for access control)"),
       revisionId: external_exports.string().describe("The revision ID to reassign"),
       toBeatId: external_exports.string().describe("The target beat ID"),
       reason: external_exports.string().describe("Why this revision is being reassigned")
@@ -22434,7 +22434,7 @@ function registerBeatPlanningTools(server, ctx, client) {
     "Plan the implementation of a Beat Revision via a conversational turn. Uses the revision description and Beat notes as context. Use this during the planning or building stage to refine scope, explore implementation details, or assess readiness.",
     {
       revisionId: external_exports.string().describe("The revision ID to plan"),
-      systemId: external_exports.string().describe("The project ID"),
+      systemId: external_exports.string().describe("The system ID"),
       message: external_exports.string().describe(
         'Your planning message \u2014 e.g. "Review the revision scope", "What should we consider for the auth flow?", or "Does this cover the acceptance criteria?"'
       ),
@@ -22536,7 +22536,7 @@ ${d.rationale}${d.suggestions?.length ? `
 function registerBeatQualityTools(server, ctx, client) {
   const schema = {
     beatId: external_exports.string().describe("The beat ID (e.g., TF-B-001)"),
-    systemId: external_exports.string().describe("The project ID"),
+    systemId: external_exports.string().describe("The system ID"),
     wait: external_exports.boolean().optional().describe("If true, block until the check completes and return the scorecard inline. Default: false (returns taskId immediately).")
   };
   const handler = async ({ beatId, systemId, wait }) => {
@@ -22585,7 +22585,7 @@ function registerBeatReframeTools(server, ctx, client) {
     "Reframe a Beat's title and description to meet business-outcome quality rules \u2014 outcome-first, plain English, non-technical audience. Returns a proposed rewrite for review.",
     {
       beatId: external_exports.string().describe("The beat ID (e.g., TF-B-001)"),
-      systemId: external_exports.string().describe("The project ID")
+      systemId: external_exports.string().describe("The system ID")
     },
     async ({ beatId, systemId }) => {
       try {
@@ -23095,9 +23095,9 @@ function formatLayerDetail(layer) {
 function registerBeatTools(server, ctx, client) {
   server.tool(
     "list_beats",
-    "List beats in a project. Use offset/limit to paginate large result sets.",
+    "List beats in a system. Use offset/limit to paginate large result sets.",
     {
-      systemId: external_exports.string().describe("The project ID"),
+      systemId: external_exports.string().describe("The system ID"),
       offset: external_exports.coerce.number().int().min(0).default(0).describe("Number of beats to skip (for pagination)"),
       limit: external_exports.coerce.number().int().min(1).max(500).default(100).describe("Max beats to return (default 100, max 500)"),
       includeArchived: external_exports.boolean().optional().default(false).describe("Include archived and deprecated beats (excluded by default)")
@@ -23139,7 +23139,7 @@ function registerBeatTools(server, ctx, client) {
     "Get the full decision lineage timeline for a beat (revisions, status changes, edits, proposals)",
     {
       beatId: external_exports.string().describe("The beat ID"),
-      systemId: external_exports.string().optional().describe("Project ID (auto-resolved from beat if omitted)")
+      systemId: external_exports.string().optional().describe("System ID (auto-resolved from beat if omitted)")
     },
     async ({ beatId, systemId }) => {
       const beat = await fetchBeatInOrg(client, beatId, ctx.orgId);
@@ -23154,9 +23154,9 @@ function registerBeatTools(server, ctx, client) {
   );
   server.tool(
     "create_beat",
-    "Create a new beat in a project. Title must be outcome-first (what changes for the user, not what we build). Description is the Beat Coda \u2014 second-person resolved expression of the capability (1-3 sentences). Avoid jargon and user-story format. Read harmonica://guidelines/beat-quality for full rules. Auto-generates beat ID if not provided.",
+    "Create a new beat in a system. Title must be outcome-first (what changes for the user, not what we build). Description is the Beat Coda \u2014 second-person resolved expression of the capability (1-3 sentences). Avoid jargon and user-story format. Read harmonica://guidelines/beat-quality for full rules. Auto-generates beat ID if not provided.",
     {
-      systemId: external_exports.string().describe("The project ID"),
+      systemId: external_exports.string().describe("The system ID"),
       title: external_exports.string().describe('Beat title \u2014 outcome-first, e.g. "At-risk shipments screen used daily by Ops"'),
       description: external_exports.string().optional().describe("Beat Coda \u2014 second-person resolved expression of what the capability looks like when complete (1-3 sentences)"),
       tags: external_exports.array(external_exports.string()).optional().describe("Tags for categorization"),
@@ -23238,7 +23238,7 @@ ${formatBeatDetail(beat)}${similarityWarning}` }] };
         maxConcurrentRevisions: external_exports.coerce.number().min(0).describe("Recommended max active revisions (0 = no cap)"),
         allowOverlap: external_exports.boolean().describe("Whether overlapping work on this Beat is acceptable"),
         scopeOverlapStrategy: external_exports.enum(["block", "warn", "allow"]).describe("Advisory only \u2014 how the UI/MCP should react when limits are exceeded")
-      }).nullable().optional().describe("Per-Beat concurrency guidance (advisory, not a gate). Omit to leave unchanged; pass null to clear and use the project default.")
+      }).nullable().optional().describe("Per-Beat concurrency guidance (advisory, not a gate). Omit to leave unchanged; pass null to clear and use the system default.")
     },
     async ({ beatId, changeSummary, ...changes }) => {
       try {
@@ -23277,10 +23277,10 @@ ${formatBeatDetail(beat)}${similarityWarning}` }] };
   );
   server.tool(
     "list_revisions",
-    "List revisions for a project, optionally filtered by binary status (`active` or `archived`). Archived revisions are excluded by default. Use beatId to scope results to a single beat.",
+    "List revisions for a system, optionally filtered by binary status (`active` or `archived`). Archived revisions are excluded by default. Use beatId to scope results to a single beat.",
     {
-      systemId: external_exports.string().describe("The project ID"),
-      beatId: external_exports.string().optional().describe("Scope to a specific beat (omit for all project revisions)"),
+      systemId: external_exports.string().describe("The system ID"),
+      beatId: external_exports.string().optional().describe("Scope to a specific beat (omit for all system revisions)"),
       status: external_exports.enum(["active", "archived"]).optional().describe("Filter by binary Revision status (default: all non-archived)"),
       includeArchived: external_exports.boolean().optional().default(false).describe("Include archived revisions (excluded by default)")
     },
@@ -23397,10 +23397,10 @@ var PlanVersionsIdempotencyError = class extends Error {
 function registerBeatVersionTools(server, ctx, client) {
   server.tool(
     "list_beat_versions",
-    "List Beat Versions for a Beat or Project. Beat Versions are the shippable planning increments that advance a Beat toward its goal. Use beatId to scope to a specific Beat, or omit for all Beat Versions in the project. Status is binary (active | archived); by default excludes archived.",
+    "List Beat Versions for a Beat or System. Beat Versions are the shippable planning increments that advance a Beat toward its goal. Use beatId to scope to a specific Beat, or omit for all Beat Versions in the system. Status is binary (active | archived); by default excludes archived.",
     {
-      systemId: external_exports.string().describe("The project ID"),
-      beatId: external_exports.string().optional().describe("Filter to a specific Beat (omit for all Beat Versions in project)"),
+      systemId: external_exports.string().describe("The system ID"),
+      beatId: external_exports.string().optional().describe("Filter to a specific Beat (omit for all Beat Versions in system)"),
       status: external_exports.enum(BEAT_VERSION_STATUSES).optional().describe("Filter to a specific status (active | archived)"),
       includeTerminal: external_exports.boolean().optional().describe("Include archived Beat Versions. Default: false.")
     },
@@ -23672,10 +23672,10 @@ function registerBeatVersionTools(server, ctx, client) {
   );
   server.tool(
     "relocate_beat_version",
-    "Move a Beat Version from one parent Beat to another within the same project, re-parenting all child Revisions and keeping every DynamoDB index consistent. Use when a Beat Version was planned under the wrong Beat or the scope of a Beat has been reorganized. Dry-run by default (confirm=false): shows what would change without writing. Pass confirm=true to execute. Blocked on released Drops by default \u2014 pass overrideReleasedDropLock=true to proceed (preserves Drop membership for audit trail).",
+    "Move a Beat Version from one parent Beat to another within the same system, re-parenting all child Revisions and keeping every DynamoDB index consistent. Use when a Beat Version was planned under the wrong Beat or the scope of a Beat has been reorganized. Dry-run by default (confirm=false): shows what would change without writing. Pass confirm=true to execute. Blocked on released Drops by default \u2014 pass overrideReleasedDropLock=true to proceed (preserves Drop membership for audit trail).",
     {
       beatVersionId: external_exports.string().describe("The Beat Version ID to relocate (e.g., bv-abc123)"),
-      targetBeatId: external_exports.string().describe("The Beat ID to relocate the Beat Version to (must be in the same project)"),
+      targetBeatId: external_exports.string().describe("The Beat ID to relocate the Beat Version to (must be in the same system)"),
       reason: external_exports.string().min(1).describe("Why this relocation is being made (recorded in audit trail)"),
       confirm: external_exports.boolean().optional().describe("Set true to execute the relocation. Default false (dry-run describes the move)."),
       overrideReleasedDropLock: external_exports.boolean().optional().describe("Allow relocation even when the Beat Version belongs to a released Drop (preserves Drop membership). Default false.")
@@ -23829,9 +23829,9 @@ function registerCheckTools(server, ctx, client) {
   );
   server.tool(
     "list_checks",
-    "List persisted checks for a project, beat, beat version, or revision. Shows score trends over time. Filter by check type.",
+    "List persisted checks for a system, beat, beat version, or revision. Shows score trends over time. Filter by check type.",
     {
-      systemId: external_exports.string().describe("The project ID"),
+      systemId: external_exports.string().describe("The system ID"),
       beatId: external_exports.string().optional().describe("List checks for this specific beat"),
       beatVersionId: external_exports.string().optional().describe("List checks for this specific beat version"),
       revisionId: external_exports.string().optional().describe("List checks for this specific revision"),
@@ -23942,9 +23942,9 @@ function registerCheckTools(server, ctx, client) {
   );
   server.tool(
     "list_latest_checks",
-    "List the latest check per target (Beat, Beat Version, Revision) across a whole project in one call \u2014 the most recent score of each type for each entity. Use this for an at-a-glance quality snapshot of every capability; use list_checks when you need the full history of one target.",
+    "List the latest check per target (Beat, Beat Version, Revision) across a whole system in one call \u2014 the most recent score of each type for each entity. Use this for an at-a-glance quality snapshot of every capability; use list_checks when you need the full history of one target.",
     {
-      systemId: external_exports.string().describe("The project ID")
+      systemId: external_exports.string().describe("The system ID")
     },
     async ({ systemId }) => {
       try {
@@ -23966,8 +23966,8 @@ function registerCheckTools(server, ctx, client) {
     {
       checkType: external_exports.enum(["beat_coda_quality", "beat_quality", "beat_version_quality", "plan_quality", "build_quality"]).describe("Type of check to run. beat_quality is the deprecated alias of beat_coda_quality. plan_quality is the deprecated alias of beat_version_quality."),
       targetId: external_exports.string().describe("The target entity ID \u2014 a beatId for beat_coda_quality, or a Beat Version ID (bv-*) for beat_version_quality and build_quality"),
-      systemId: external_exports.string().describe("The project ID"),
-      branch: external_exports.string().optional().describe("Override the git branch for code checks (default: project default branch)"),
+      systemId: external_exports.string().describe("The system ID"),
+      branch: external_exports.string().optional().describe("Override the git branch for code checks (default: system default branch)"),
       localPath: external_exports.string().optional().describe("Absolute path to an already-cloned local copy of the repo \u2014 skips git clone entirely (useful for large repos or offline use)")
     },
     async ({ checkType, targetId, systemId, branch, localPath }) => {
@@ -24555,7 +24555,7 @@ function registerDropQualityTools(server, ctx, client) {
     "Run a five-dimension coherence check on a Drop (Substantial, Harmonious, Clear, Focused, Strategically Aligned), graded LLM-only on the Drop's Beat Versions and their parent Beats/Projects/Codas. By default returns a taskId immediately \u2014 set wait=true to block and receive the full scorecard inline.",
     {
       dropId: external_exports.string().min(1).describe("The Drop ID (e.g. drop-abc123) to grade"),
-      systemId: external_exports.string().min(1).describe("A project within this Drop \u2014 the check record is attributed to it (Drops span projects, so the result is recorded under one member project)"),
+      systemId: external_exports.string().min(1).describe("A system within this Drop \u2014 the check record is attributed to it (Drops span systems, so the result is recorded under one member system)"),
       wait: external_exports.boolean().optional().describe("Block until the check completes and return the scorecard inline. Default: false.")
     },
     async ({ dropId, systemId, wait }) => {
@@ -25004,7 +25004,7 @@ function registerEmbeddingTools(server, ctx, client) {
     "Find Notes semantically similar to one or more Notes. Accepts a single Note ID or an array of Note IDs for batch duplicate detection. Results are grouped by source Note.",
     {
       noteId: external_exports.union([external_exports.string(), external_exports.array(external_exports.string())]).describe("Note ID or array of Note IDs to find similar notes for"),
-      systemId: external_exports.string().describe("The project ID the notes belong to"),
+      systemId: external_exports.string().describe("The system ID the notes belong to"),
       threshold: external_exports.coerce.number().min(0).max(1).optional().default(0.7).describe("Minimum similarity score (0-1). Default 0.7"),
       limit: external_exports.coerce.number().int().min(1).max(50).optional().default(10).describe("Max results per source note. Default 10"),
       includeArchived: external_exports.boolean().optional().default(false).describe("Include archived/deprecated notes in results (excluded by default)"),
@@ -25031,7 +25031,7 @@ function registerEmbeddingTools(server, ctx, client) {
     "Find Beats semantically similar to a given Beat. Useful for detecting duplicates, dependencies, or related capabilities.",
     {
       beatId: external_exports.string().describe("The beat ID to find similar beats for"),
-      systemId: external_exports.string().describe("The project ID the beat belongs to"),
+      systemId: external_exports.string().describe("The system ID the beat belongs to"),
       threshold: external_exports.coerce.number().min(0).max(1).optional().default(0.7).describe("Minimum similarity score (0-1). Default 0.7"),
       limit: external_exports.coerce.number().int().min(1).max(50).optional().default(10).describe("Max results to return. Default 10"),
       includeArchived: external_exports.boolean().optional().default(false).describe("Include archived/deprecated beats in results (excluded by default)")
@@ -25048,7 +25048,7 @@ function registerEmbeddingTools(server, ctx, client) {
     "Find Beats semantically related to a given Note. Surfaces missing affectsBeats links and helps classify unassigned Notes.",
     {
       noteId: external_exports.string().describe("The note ID to find related beats for"),
-      systemId: external_exports.string().describe("The project ID the note belongs to"),
+      systemId: external_exports.string().describe("The system ID the note belongs to"),
       threshold: external_exports.coerce.number().min(0).max(1).optional().default(0.7).describe("Minimum similarity score (0-1). Default 0.7"),
       limit: external_exports.coerce.number().int().min(1).max(50).optional().default(10).describe("Max results to return. Default 10")
     },
@@ -25063,7 +25063,7 @@ function registerEmbeddingTools(server, ctx, client) {
     "cluster_notes",
     "Cluster semantically similar Notes using DBSCAN on vector embeddings. Returns clusters for review with member previews. Use this to discover natural groupings among notes and consolidate them under parent summary notes.",
     {
-      systemId: external_exports.string().describe("The project ID"),
+      systemId: external_exports.string().describe("The system ID"),
       threshold: external_exports.coerce.number().min(0).max(1).optional().default(0.75).describe("Cosine similarity threshold for clustering (0-1). Higher = tighter clusters. Default 0.75"),
       minClusterSize: external_exports.coerce.number().int().min(2).optional().default(3).describe("Minimum notes to form a cluster. Default 3"),
       includeLinked: external_exports.coerce.boolean().optional().default(false).describe("Include notes that already have dependsOnNotes links. Default false (excludes them). Set true for thematic grouping pass.")
@@ -25094,7 +25094,7 @@ ${members}`;
     "consolidate_notes",
     "Two-pass note consolidation: clusters notes via DBSCAN, then sends each cluster to an LLM for contextual analysis. Returns consolidation proposals (should these be grouped under a parent summary?) without modifying data. Use cluster_notes for a quick vector-only view; use this when ready to act on consolidation.",
     {
-      systemId: external_exports.string().describe("The project ID"),
+      systemId: external_exports.string().describe("The system ID"),
       threshold: external_exports.coerce.number().min(0).max(1).optional().default(0.65).describe("Cosine similarity threshold for clustering (0-1). Default 0.65"),
       minClusterSize: external_exports.coerce.number().int().min(2).optional().default(2).describe("Minimum notes to form a cluster. Default 2"),
       includeLinked: external_exports.coerce.boolean().optional().default(false).describe("Include notes that already have dependsOnNotes links. Default false.")
@@ -25821,9 +25821,9 @@ function formatNextActions(actions) {
 function registerNextActionsTools(server, ctx, client) {
   server.tool(
     "get_next_actions",
-    "Get prioritized list of recommended next actions for a project. Analyzes Beats, Revisions, and Notes to surface the highest-priority work: P0 (urgent bugs) \u2192 P1 (deploy) \u2192 P2 (build) \u2192 P3 (plan) \u2192 P4 (compose) \u2192 P5 (maintenance).",
+    "Get prioritized list of recommended next actions for a system. Analyzes Beats, Revisions, and Notes to surface the highest-priority work: P0 (urgent bugs) \u2192 P1 (deploy) \u2192 P2 (build) \u2192 P3 (plan) \u2192 P4 (compose) \u2192 P5 (maintenance).",
     {
-      systemId: external_exports.string().describe("The project ID"),
+      systemId: external_exports.string().describe("The system ID"),
       limit: external_exports.coerce.number().optional().default(10).describe("Max actions to return")
     },
     async ({ systemId, limit }) => {
@@ -25841,7 +25841,7 @@ function registerNextActionsTools(server, ctx, client) {
     "list_triage_actions",
     "List active triage actions from the ledger (open + acted). This is the stateful view of what needs attention \u2014 includes status tracking, task progress, and escalation state. Use this instead of get_next_actions when triage has been run.",
     {
-      systemId: external_exports.string().describe("The project ID")
+      systemId: external_exports.string().describe("The system ID")
     },
     async ({ systemId }) => {
       try {
@@ -25858,7 +25858,7 @@ function registerNextActionsTools(server, ctx, client) {
     "dismiss_triage_action",
     'Dismiss a triage action (human decides "not now"). The action will not be re-escalated until the underlying state changes.',
     {
-      systemId: external_exports.string().describe("The project ID"),
+      systemId: external_exports.string().describe("The system ID"),
       actionKey: external_exports.string().describe("The action key to dismiss (from list_triage_actions)")
     },
     async ({ systemId, actionKey }) => {
@@ -25905,6 +25905,126 @@ function formatTriageActions(actions) {
 // ../../libs/harmonica-services/src/mcp/tools/note-element-tools.ts
 var import_crypto3 = require("crypto");
 
+// ../../libs/harmonica-schemas/src/azure-marketplace.ts
+var AzureMarketplaceSubscriptionSchema = external_exports.object({
+  id: external_exports.string(),
+  publisherId: external_exports.string().optional(),
+  offerId: external_exports.string().optional(),
+  name: external_exports.string().optional(),
+  saasSubscriptionStatus: external_exports.string().optional(),
+  planId: external_exports.string().optional(),
+  quantity: external_exports.number().optional(),
+  beneficiary: external_exports.object({
+    emailId: external_exports.string().optional(),
+    objectId: external_exports.string().optional(),
+    tenantId: external_exports.string().optional()
+  }).optional(),
+  purchaser: external_exports.object({
+    emailId: external_exports.string().optional(),
+    objectId: external_exports.string().optional(),
+    tenantId: external_exports.string().optional()
+  }).optional()
+});
+var AzureSubscribedSchema = external_exports.object({
+  action: external_exports.literal("Subscribe"),
+  // Non-blank, not merely non-empty. A bare z.string() accepts "", which would
+  // derive the slug "az-" — 3 chars, trailing dash, invalid under the repository
+  // slug invariant. And .min(1) alone still admits "   ", which normalizes to
+  // nothing and falls through to the hash fallback, quietly provisioning an org
+  // under a hashed slug for input that is plainly garbage. Reject it at the
+  // boundary instead.
+  subscriptionId: external_exports.string().min(1).refine((v) => v.trim().length > 0, {
+    message: "subscriptionId must not be blank"
+  }),
+  offerId: external_exports.string(),
+  planId: external_exports.string(),
+  quantity: external_exports.number().optional(),
+  timeStamp: external_exports.string(),
+  operationId: external_exports.string(),
+  subscription: AzureMarketplaceSubscriptionSchema
+});
+var AzureUnsubscribedSchema = external_exports.object({
+  action: external_exports.literal("Unsubscribe"),
+  // Non-blank, not merely non-empty. A bare z.string() accepts "", which would
+  // derive the slug "az-" — 3 chars, trailing dash, invalid under the repository
+  // slug invariant. And .min(1) alone still admits "   ", which normalizes to
+  // nothing and falls through to the hash fallback, quietly provisioning an org
+  // under a hashed slug for input that is plainly garbage. Reject it at the
+  // boundary instead.
+  subscriptionId: external_exports.string().min(1).refine((v) => v.trim().length > 0, {
+    message: "subscriptionId must not be blank"
+  }),
+  offerId: external_exports.string(),
+  planId: external_exports.string(),
+  timeStamp: external_exports.string(),
+  operationId: external_exports.string(),
+  subscription: AzureMarketplaceSubscriptionSchema
+});
+var AzureChangePlanSchema = external_exports.object({
+  action: external_exports.literal("ChangePlan"),
+  // Non-blank, not merely non-empty. A bare z.string() accepts "", which would
+  // derive the slug "az-" — 3 chars, trailing dash, invalid under the repository
+  // slug invariant. And .min(1) alone still admits "   ", which normalizes to
+  // nothing and falls through to the hash fallback, quietly provisioning an org
+  // under a hashed slug for input that is plainly garbage. Reject it at the
+  // boundary instead.
+  subscriptionId: external_exports.string().min(1).refine((v) => v.trim().length > 0, {
+    message: "subscriptionId must not be blank"
+  }),
+  offerId: external_exports.string(),
+  planId: external_exports.string(),
+  timeStamp: external_exports.string(),
+  operationId: external_exports.string(),
+  subscription: AzureMarketplaceSubscriptionSchema
+});
+var AzureSuspendSchema = external_exports.object({
+  action: external_exports.literal("Suspend"),
+  // Non-blank, not merely non-empty. A bare z.string() accepts "", which would
+  // derive the slug "az-" — 3 chars, trailing dash, invalid under the repository
+  // slug invariant. And .min(1) alone still admits "   ", which normalizes to
+  // nothing and falls through to the hash fallback, quietly provisioning an org
+  // under a hashed slug for input that is plainly garbage. Reject it at the
+  // boundary instead.
+  subscriptionId: external_exports.string().min(1).refine((v) => v.trim().length > 0, {
+    message: "subscriptionId must not be blank"
+  }),
+  offerId: external_exports.string(),
+  planId: external_exports.string(),
+  timeStamp: external_exports.string(),
+  operationId: external_exports.string(),
+  subscription: AzureMarketplaceSubscriptionSchema
+});
+var AzureReinstateSchema = external_exports.object({
+  action: external_exports.literal("Reinstate"),
+  // Non-blank, not merely non-empty. A bare z.string() accepts "", which would
+  // derive the slug "az-" — 3 chars, trailing dash, invalid under the repository
+  // slug invariant. And .min(1) alone still admits "   ", which normalizes to
+  // nothing and falls through to the hash fallback, quietly provisioning an org
+  // under a hashed slug for input that is plainly garbage. Reject it at the
+  // boundary instead.
+  subscriptionId: external_exports.string().min(1).refine((v) => v.trim().length > 0, {
+    message: "subscriptionId must not be blank"
+  }),
+  offerId: external_exports.string(),
+  planId: external_exports.string(),
+  timeStamp: external_exports.string(),
+  operationId: external_exports.string(),
+  subscription: AzureMarketplaceSubscriptionSchema
+});
+var AzureMarketplaceWebhookEventSchema = external_exports.discriminatedUnion("action", [
+  AzureSubscribedSchema,
+  AzureUnsubscribedSchema,
+  AzureChangePlanSchema,
+  AzureSuspendSchema,
+  AzureReinstateSchema
+]);
+var AZURE_MARKETPLACE_WEBHOOK_ACTIONS = AzureMarketplaceWebhookEventSchema.options.map(
+  (o) => o.shape.action.value
+);
+var AzureMarketplaceActivateBodySchema = external_exports.object({
+  token: external_exports.string().min(1)
+});
+
 // ../../libs/harmonica-schemas/src/compose-beat-versions.ts
 var BeatVersionDraftSchema = external_exports.object({
   title: external_exports.string().min(1).max(300),
@@ -26504,7 +26624,7 @@ var CheckApiSchema = external_exports.object({
   createdAt: external_exports.string(),
   updatedAt: external_exports.string()
 }).passthrough();
-var ProjectCheckApiSchema = external_exports.object({
+var SystemCheckApiSchema = external_exports.object({
   checkId: external_exports.string(),
   checkType: CheckTypeSchema,
   targetType: CheckTargetTypeSchema,
@@ -26520,7 +26640,7 @@ var ProjectCheckApiSchema = external_exports.object({
   dimensions: external_exports.array(CheckDimensionScoreSchema).optional()
 }).passthrough();
 var CheckResponseSchema = external_exports.object({ check: CheckApiSchema }).passthrough();
-var ChecksResponseSchema = external_exports.object({ checks: external_exports.array(ProjectCheckApiSchema), nextCursor: external_exports.string().optional() }).passthrough();
+var ChecksResponseSchema = external_exports.object({ checks: external_exports.array(SystemCheckApiSchema), nextCursor: external_exports.string().optional() }).passthrough();
 var TaskStatusSchema2 = external_exports.enum(["pending", "running", "completed", "failed"]);
 var TaskProgressSchema = external_exports.object({
   current: external_exports.number(),
@@ -27273,10 +27393,10 @@ ${formatDeliveryPolicy(
 function registerNoteTools(server, ctx, client) {
   server.tool(
     "list_notes",
-    "List Notes for a project. Without beatId: returns all notes (project-level + beat-level). With beatId: returns only notes scoped to that beat. Filterable by type, status, revisionId, beatVersionId, and significance. Use offset/limit to paginate beat-scoped results; use cursor for project-wide results.",
+    "List Notes for a system. Without beatId: returns all notes (system-level + beat-level). With beatId: returns only notes scoped to that beat. Filterable by type, status, revisionId, beatVersionId, and significance. Use offset/limit to paginate beat-scoped results; use cursor for project-wide results.",
     {
-      systemId: external_exports.string().describe("The project ID"),
-      beatId: external_exports.string().optional().describe("Scope to a specific beat (omit for all project notes)"),
+      systemId: external_exports.string().describe("The system ID"),
+      beatId: external_exports.string().optional().describe("Scope to a specific beat (omit for all system notes)"),
       noteType: external_exports.union([external_exports.enum(NOTE_TYPE_VALUES), external_exports.array(external_exports.enum(NOTE_TYPE_VALUES)).min(1)]).optional().describe('Filter by note type \u2014 single value or array for multi-select (e.g. ["constraint", "assumption"])'),
       status: external_exports.enum(NOTE_STATUS_VALUES).optional().describe("Filter by status"),
       revisionId: external_exports.string().optional().describe("Filter to notes scoped to a specific revision"),
@@ -27441,9 +27561,9 @@ function registerNoteTools(server, ctx, client) {
   );
   server.tool(
     "list_documents",
-    "List uploaded documents for a project with processing status, filename, child note count, and AI summary. Use get_note with a document note ID for full details.",
+    "List uploaded documents for a system with processing status, filename, child note count, and AI summary. Use get_note with a document note ID for full details.",
     {
-      systemId: external_exports.string().describe("The project ID")
+      systemId: external_exports.string().describe("The system ID")
     },
     async ({ systemId }) => {
       await assertProjectInOrg(client, systemId, ctx.orgId);
@@ -27459,7 +27579,7 @@ function registerNoteTools(server, ctx, client) {
     "get_note",
     "Get full details of a single Note by ID",
     {
-      systemId: external_exports.string().optional().describe("The project ID (for access control). Provide systemId or orgId, not both."),
+      systemId: external_exports.string().optional().describe("The system ID (for access control). Provide systemId or orgId, not both."),
       orgId: external_exports.string().optional().describe("The org ID (for org-level notes). Provide orgId or systemId, not both."),
       noteId: external_exports.string().describe("The note ID")
     },
@@ -27496,9 +27616,9 @@ function registerNoteTools(server, ctx, client) {
   );
   server.tool(
     "create_note",
-    "Create a new Note. Provide exactly one of systemId, teamspaceId, movementId, or none (org-level): systemId scopes the note to a project (optionally with beatId), teamspaceId scopes it to a teamspace (no cascade to child projects), movementId scopes it to a Movement (commercial SOW container \u2014 engagement-level knowledge), and omitting all creates an org-level note that applies across all projects.",
+    "Create a new Note. Provide exactly one of systemId, teamspaceId, movementId, or none (org-level): systemId scopes the note to a system (optionally with beatId), teamspaceId scopes it to a teamspace (no cascade to child systems), movementId scopes it to a Movement (commercial SOW container \u2014 engagement-level knowledge), and omitting all creates an org-level note that applies across all systems.",
     {
-      systemId: external_exports.string().optional().describe("The project ID (omit for teamspace-, movement-, or org-level note)"),
+      systemId: external_exports.string().optional().describe("The system ID (omit for teamspace-, movement-, or org-level note)"),
       teamspaceId: external_exports.string().optional().describe("The teamspace ID (omit for project-, movement-, or org-level note)"),
       movementId: external_exports.string().min(1).optional().describe("The Movement ID (omit for project-, teamspace-, or org-level note)"),
       noteType: external_exports.enum(NOTE_TYPE_VALUES).describe("The type of note"),
@@ -27597,7 +27717,7 @@ ${text}` }] };
     "update_note",
     "Update a Note (status, content, response, etc.). humanAssignee and agentAssignee are independent fields \u2014 both can be set simultaneously (a note can have a human owner and an agent collaborator). Set either to null to clear it.",
     {
-      systemId: external_exports.string().optional().describe("The project ID (for access control). Provide systemId or orgId, not both."),
+      systemId: external_exports.string().optional().describe("The system ID (for access control). Provide systemId or orgId, not both."),
       orgId: external_exports.string().optional().describe("The org ID (for org-level notes). Provide orgId or systemId, not both."),
       noteId: external_exports.string().describe("The note ID to update"),
       noteType: external_exports.enum(NOTE_TYPE_VALUES).optional().describe("Reclassify the note type (e.g. assumption \u2192 guidance)"),
@@ -27679,7 +27799,7 @@ ${text}` }] };
     "bulk_update_notes",
     "Update multiple Notes in one call, applying the same fields to all. More efficient than calling update_note N times. Returns updated notes and any per-note failures.",
     {
-      systemId: external_exports.string().describe("The project ID (for access control)"),
+      systemId: external_exports.string().describe("The system ID (for access control)"),
       noteIds: external_exports.array(external_exports.string()).min(1).max(100).describe("Note IDs to update (max 100 per call)"),
       noteType: external_exports.enum(NOTE_TYPE_VALUES).optional().describe("Reclassify all notes to this type"),
       status: external_exports.enum(NOTE_STATUS_VALUES).optional().describe("New status for all notes"),
@@ -27721,7 +27841,7 @@ ${text}` }] };
     "reassign_note",
     "Reassign a misattributed note to a different beat (with audit trail)",
     {
-      systemId: external_exports.string().describe("The project ID (for access control)"),
+      systemId: external_exports.string().describe("The system ID (for access control)"),
       noteId: external_exports.string().describe("The note ID to reassign"),
       targetBeatId: external_exports.string().describe("The beat ID to move the note to"),
       targetRevisionId: external_exports.string().optional().describe("Optional revision ID to scope the note to"),
@@ -27745,7 +27865,7 @@ ${text}` }] };
     "remove_note",
     "Soft-remove a misattributed note by dismissing it (with audit trail)",
     {
-      systemId: external_exports.string().min(1).describe("The project ID (for access control)"),
+      systemId: external_exports.string().min(1).describe("The system ID (for access control)"),
       noteId: external_exports.string().min(1).describe("The note ID to remove"),
       reason: external_exports.string().min(1).max(500).optional().describe('Why this note is being removed (defaults to "Removed via remove_note")')
     },
@@ -27772,7 +27892,7 @@ ${text}` }] };
     "dismiss_document",
     "Soft-remove an uploaded document by dismissing it \u2014 it will no longer appear in list_documents output. Only works on document-type notes; use remove_note for non-document notes.",
     {
-      systemId: external_exports.string().min(1).describe("The project ID (for access control)"),
+      systemId: external_exports.string().min(1).describe("The system ID (for access control)"),
       noteId: external_exports.string().min(1).describe("The document note ID to dismiss"),
       reason: external_exports.string().min(1).max(500).optional().describe('Why this document is being dismissed (defaults to "Dismissed via dismiss_document")')
     },
@@ -27805,7 +27925,7 @@ ${text}` }] };
     "list_key_assumptions",
     "Get key assumptions sorted by criticality (highest risk first)",
     {
-      systemId: external_exports.string().describe("The project ID")
+      systemId: external_exports.string().describe("The system ID")
     },
     async ({ systemId }) => {
       await assertProjectInOrg(client, systemId, ctx.orgId);
@@ -27888,7 +28008,7 @@ function formatTree(node, depth = 0) {
 function registerNotebookTools(server, ctx, client) {
   server.tool(
     "create_notebook",
-    "Create a new Notebook in the configured organization. Optionally bind it to one or more scopes (org, teamspace, or project) at creation.",
+    "Create a new Notebook in the configured organization. Optionally bind it to one or more scopes (org, teamspace, or system) at creation.",
     {
       title: external_exports.string().min(1).max(300).describe("Notebook title (1\u2013300 characters)"),
       description: external_exports.string().max(2e4).optional().describe("Optional description (max 20 000 characters)"),
@@ -28065,7 +28185,7 @@ ${formatTree(tree.root)}` }] };
   );
   server.tool(
     "add_notebook_collection",
-    "Add a live-collection section to a Notebook page. Unlike a normal section, its members are resolved from a live query at read time (never hand-picked), so it stays current on its own as notes are created, edited, or retired. v1 supports the project Decision Log: every decision note in a project (including beat-scoped), newest first. Attach under a page (defaults to the notebook root).",
+    "Add a live-collection section to a Notebook page. Unlike a normal section, its members are resolved from a live query at read time (never hand-picked), so it stays current on its own as notes are created, edited, or retired. v1 supports the system Decision Log: every decision note in a system (including beat-scoped), newest first. Attach under a page (defaults to the notebook root).",
     {
       notebookId: external_exports.string().describe("The Notebook ID"),
       heading: external_exports.string().min(1).max(200).describe('Section label, e.g. "Decision Log"'),
@@ -28288,7 +28408,7 @@ ${scopeText}` }] };
   );
   server.tool(
     "list_notebooks",
-    "List Notebooks reachable from a scope (org, teamspace, or project). Returns all notebooks bound to that scope.",
+    "List Notebooks reachable from a scope (org, teamspace, or system). Returns all notebooks bound to that scope.",
     {
       scopeType: external_exports.enum(SCOPE_TYPE_VALUES).describe("Scope type \u2014 org, teamspace, or project"),
       scopeId: external_exports.string().min(1).describe("ID of the scope entity"),
@@ -28499,27 +28619,27 @@ function registerOnboardingTools(server, ctx, client) {
   server.tool(
     "draft_onboarding_beats",
     [
-      "Generate an initial Beat structure for a newly created project.",
-      "Call this after create_teamspace_onboarding_batch to draft 3\u20135 Beats based on the project context.",
+      "Generate an initial Beat structure for a newly created system.",
+      "Call this after create_teamspace_onboarding_batch to draft 3\u20135 Beats based on the system context.",
       "Returns Beat suggestions with titles, descriptions, and any Maya recommendations to convert a suggestion to a Note instead.",
       "The PM reviews and confirms \u2014 use create_beat for each approved Beat, create_note for any Note conversions."
     ].join(" "),
     {
-      systemId: external_exports.string().describe("The newly created project ID"),
-      projectTitle: external_exports.string().describe("The project title"),
+      systemId: external_exports.string().describe("The newly created system ID"),
+      systemTitle: external_exports.string().describe("The system title"),
       projectDescription: external_exports.string().optional().describe("Discovery context: pain points, goals, and constraints summary to inform the Beat structure"),
       analysisJson: external_exports.string().optional().describe("JSON-serialized DiscoveryAnalysis from initiate_teamspace_onboarding. Pass this to produce Beats grounded in the actual discovery data.")
     },
-    async ({ systemId, projectTitle, projectDescription, analysisJson }) => {
+    async ({ systemId, systemTitle, projectDescription, analysisJson }) => {
       await assertProjectInOrg(client, systemId, ctx.orgId);
-      const result = await client.draftOnboardingBeats(systemId, { projectTitle, projectDescription, analysisJson });
+      const result = await client.draftOnboardingBeats(systemId, { systemTitle, projectDescription, analysisJson });
       if (!result.suggestions || result.suggestions.length === 0) {
         return {
           content: [{ type: "text", text: "Failed to generate Beat suggestions. Try providing more project context." }]
         };
       }
       const lines = [
-        `## Beat Draft for "${projectTitle}" (${result.suggestions.length} suggestions)`,
+        `## Beat Draft for "${systemTitle}" (${result.suggestions.length} suggestions)`,
         "",
         ...result.suggestions.flatMap((s, i) => {
           const sug = s;
@@ -28816,7 +28936,7 @@ function registerOrganizationTools(server, ctx, client) {
       if (result.error) {
         return { content: [{ type: "text", text: result.error }], isError: true };
       }
-      const transferred = result.project;
+      const transferred = result.system;
       if (!transferred) {
         return { content: [{ type: "text", text: "Transfer succeeded but system data was not returned." }], isError: true };
       }
@@ -28946,11 +29066,11 @@ ${d.rationale}${d.suggestions?.length ? `
 function registerPlanQualityTools(server, ctx, client) {
   const schema = {
     beatVersionId: external_exports.string().describe("The Beat Version ID (e.g., bv-abc123). beat_version_quality targets Beat Versions only."),
-    systemId: external_exports.string().describe("The project ID"),
+    systemId: external_exports.string().describe("The system ID"),
     // The completeness dimension probes the codebase, so this tool accepts the
     // same repo overrides as run_check — without them the probe could only ever
     // read the default branch from this surface.
-    branch: external_exports.string().optional().describe("Override the git branch the completeness dimension probes (default: the branch of an open child Revision, else the project default branch)"),
+    branch: external_exports.string().optional().describe("Override the git branch the completeness dimension probes (default: the branch of an open child Revision, else the system default branch)"),
     localPath: external_exports.string().optional().describe("Absolute path to an already-cloned local copy of the repo \u2014 the completeness probe reads it instead of cloning"),
     wait: external_exports.boolean().optional().describe("If true, block until the check completes and return the scorecard inline. Default: false (returns taskId immediately).")
   };
@@ -29103,9 +29223,9 @@ function formatConsolidationResult(primaryId, primary, archivedBeatIds, notesRea
 function registerPortfolioCoherenceTools(server, ctx, client) {
   server.tool(
     "check_portfolio_coherence",
-    "Run a portfolio coherence check on a project. Clusters Beats by semantic similarity to surface fragmentation (merge candidates) and checks what fraction of Beats name an outcome their authoriser would recognise. By default returns a taskId immediately \u2014 set wait=true to block and receive the full report inline.",
+    "Run a portfolio coherence check on a system. Clusters Beats by semantic similarity to surface fragmentation (merge candidates) and checks what fraction of Beats name an outcome their authoriser would recognise. By default returns a taskId immediately \u2014 set wait=true to block and receive the full report inline.",
     {
-      systemId: external_exports.string().min(1).describe("The project ID"),
+      systemId: external_exports.string().min(1).describe("The system ID"),
       wait: external_exports.boolean().optional().describe("Block until the check completes and return the report inline. Default: false.")
     },
     async ({ systemId, wait }) => {
@@ -29137,7 +29257,7 @@ function registerPortfolioCoherenceTools(server, ctx, client) {
     "consolidate_beats",
     "Consolidate a fragmented Beat cluster \u2014 identified by check_portfolio_coherence \u2014 into a single VP-level capability. By default (confirm omitted or false) returns a dry-run preview: surviving Beat, Beats to archive, Notes to reassign, and any in-flight Beat Versions. Set confirm=true to execute the merge.",
     {
-      systemId: external_exports.string().min(1).describe("The project ID \u2014 all beatIds must belong to this project"),
+      systemId: external_exports.string().min(1).describe("The system ID \u2014 all beatIds must belong to this system"),
       beatIds: external_exports.array(external_exports.string().min(1)).min(2).max(50).describe("All Beat IDs in the cluster (including the one that will survive)"),
       primaryBeatId: external_exports.string().min(1).optional().describe("Beat ID that survives \u2014 defaults to beatIds[0] if omitted"),
       rationale: external_exports.string().max(2e3).optional().describe("Why these Beats are being merged \u2014 auto-generated if omitted"),
@@ -29321,14 +29441,14 @@ This is a deliberate choice by whoever configured the System, and \`confirm: tru
 function registerRevisionLifecycleTools(server, ctx, client) {
   server.tool(
     "create_revision",
-    "Create a new revision on a Beat. A Revision's canonical status starts `active`; PR progression is tracked separately on `scm.state` (`draft` \u2192 `open` \u2192 `merged` / `closed`). Environment progression (`in_staging`, `ready_for_production`, `live`) is tracked on the parent Beat Version, not the Revision. `beatVersionId` is optional \u2014 omit it for hotfixes, dep bumps, or other operational fixes that don't belong to a planning increment. Orphan Revisions (no BV) must carry their own `description` since there's no BV context to inherit. `baseRevisionId` stacks this Revision's PR/session checkout on another Revision's branch instead of the project default \u2014 for GitHub stacked PRs, must reference a Revision in the same project (validated server-side). Use this to add revisions alongside existing ones \u2014 no idempotency guard. AFTER creating a revision you intend to work on, call `create_claim` on it before writing any code \u2014 the claim signals to other agents/humans that the Revision is actively being worked, preventing duplicate work \u2014 and `release_claim` when you finish or hand off.",
+    "Create a new revision on a Beat. A Revision's canonical status starts `active`; PR progression is tracked separately on `scm.state` (`draft` \u2192 `open` \u2192 `merged` / `closed`). Environment progression (`in_staging`, `ready_for_production`, `live`) is tracked on the parent Beat Version, not the Revision. `beatVersionId` is optional \u2014 omit it for hotfixes, dep bumps, or other operational fixes that don't belong to a planning increment. Orphan Revisions (no BV) must carry their own `description` since there's no BV context to inherit. `baseRevisionId` stacks this Revision's PR/session checkout on another Revision's branch instead of the system default \u2014 for GitHub stacked PRs, must reference a Revision in the same system (validated server-side). Use this to add revisions alongside existing ones \u2014 no idempotency guard. AFTER creating a revision you intend to work on, call `create_claim` on it before writing any code \u2014 the claim signals to other agents/humans that the Revision is actively being worked, preventing duplicate work \u2014 and `release_claim` when you finish or hand off.",
     {
       beatId: external_exports.string().describe("The beat ID to create the revision on"),
       title: external_exports.string().describe("Title for this revision"),
       description: external_exports.string().describe("What this revision delivers. Required when beatVersionId is omitted (the description is the audit-trail floor for orphan Revisions)."),
       changeSummary: external_exports.string().describe("Brief summary of the change"),
       beatVersionId: external_exports.string().min(1).optional().describe("Beat Version ID to associate this revision with. Omit for hotfixes / orphan changes that don't fit a planning increment."),
-      baseRevisionId: external_exports.string().min(1).optional().describe("Existing Revision (same project) to stack this one on top of \u2014 its PR and agent session will target that Revision's branch instead of the project default (GitHub stacked PRs)."),
+      baseRevisionId: external_exports.string().min(1).optional().describe("Existing Revision (same system) to stack this one on top of \u2014 its PR and agent session will target that Revision's branch instead of the system default (GitHub stacked PRs)."),
       tags: external_exports.array(external_exports.string()).optional().describe("Tags for categorization"),
       priority: external_exports.coerce.number().optional().describe("Priority (lower = higher priority)"),
       estimatedEffort: external_exports.string().optional().describe("Estimated effort (e.g., S, M, L, XL)"),
@@ -29449,10 +29569,13 @@ function registerRevisionLifecycleTools(server, ctx, client) {
             return { content: [{ type: "text", text: `Beat Version not found: "${beatVersionId}"` }], isError: true };
           }
           const bvSystemId = bv.systemId ?? bv.projectId;
-          const revSystemId = revision.systemId ?? revision.projectId;
-          if (!bvSystemId || !revSystemId) {
+          if (!bvSystemId) {
             return { content: [{ type: "text", text: `Beat Version "${beatVersionId}" has no system identifier \u2014 record may be corrupt.` }], isError: true };
           }
+          const revSystemId = revision.systemId ?? revision.projectId;
+          if (!revSystemId) {
+            return { content: [{ type: "text", text: `Revision "${revisionId}" has no system identifier \u2014 record may be corrupt.` }], isError: true };
+          }
           if (bv.beatId !== revision.beatId || bvSystemId !== revSystemId) {
             return { content: [{ type: "text", text: `Beat Version "${beatVersionId}" belongs to a different Beat.` }], isError: true };
           }
@@ -29595,7 +29718,7 @@ Accepts the full PR metadata (number, url, branch, state, optional mergeSha). Fi
   );
   server.tool(
     "create_pr_for_revision",
-    "Open a Harmonica-initiated DRAFT pull request for a revision and link it back via revision.scm. Cuts a branch (agent/rev-<short>-<slug>), bootstraps it with an empty commit, opens a draft PR whose body starts with the `Harmonica: rev-<uuid>` marker, then records the PR on the revision. Rejects if the revision already has a linked PR, or if the project has no repo configured. Dry-run by default \u2014 call with `confirm: true` to actually create the branch and PR. Leaves the revision in `draft`; transition it to `open` when the PR is marked ready for review.",
+    "Open a Harmonica-initiated DRAFT pull request for a revision and link it back via revision.scm. Cuts a branch (agent/rev-<short>-<slug>), bootstraps it with an empty commit, opens a draft PR whose body starts with the `Harmonica: rev-<uuid>` marker, then records the PR on the revision. Rejects if the revision already has a linked PR, or if the system has no repo configured. Dry-run by default \u2014 call with `confirm: true` to actually create the branch and PR. Leaves the revision in `draft`; transition it to `open` when the PR is marked ready for review.",
     {
       revisionId: external_exports.string().describe("The revision ID (e.g., rev-abc123)"),
       confirm: external_exports.boolean().optional().describe("Set true to create the branch + draft PR. Omitted/false performs a dry-run that only describes what would happen \u2014 no GitHub or DB writes.")
@@ -29885,7 +30008,7 @@ function registerRevisionQualityTools(server, ctx, client) {
     "Run a five-dimension PR-readiness check on a Revision (Scoped, Traceable, Testable, Review-ready, Non-duplicating). Advisory only \u2014 no lifecycle transition or creation path gates on this score. By default returns a jobId immediately (fire-and-forget) \u2014 use get_job_status or list_checks to retrieve results. Set wait=true to block until the check completes and receive the scorecard inline. WARNING: wait=true holds the MCP session open for 30\u201360s \u2014 for bulk operations, omit wait and poll get_job_status separately.",
     {
       revisionId: external_exports.string().describe("The Revision ID (e.g., rev-abc123). revision_quality targets Revisions only."),
-      systemId: external_exports.string().describe("The project ID"),
+      systemId: external_exports.string().describe("The system ID"),
       wait: external_exports.boolean().optional().describe("If true, block until the check completes and return the scorecard inline. Default: false (returns taskId immediately).")
     },
     async ({ revisionId, systemId, wait }) => {
@@ -30446,8 +30569,8 @@ function registerSubscriptionTools(server, ctx, client) {
     "Follow a Project, Beat, or Revision to receive notifications when it changes. You are auto-subscribed to things you own \u2014 use this to follow additional entities.",
     {
       entityType: external_exports.enum(ENTITY_TYPES).describe("Type of entity to follow"),
-      entityId: external_exports.string().describe("The entity ID (project ID, beat ID, or revision ID)"),
-      systemId: external_exports.string().describe("The project ID (for access control)")
+      entityId: external_exports.string().describe("The entity ID (system ID, beat ID, or revision ID)"),
+      systemId: external_exports.string().describe("The system ID (for access control)")
     },
     async ({ entityType, entityId, systemId }) => {
       try {
@@ -30491,7 +30614,7 @@ function registerSubscriptionTools(server, ctx, client) {
   );
   server.tool(
     "list_subscriptions",
-    "List entities you are currently following. Optionally filter by entity type (project, beat, revision).",
+    "List entities you are currently following. Optionally filter by entity type (system, beat, revision).",
     {
       entityType: external_exports.enum(ENTITY_TYPES).optional().describe("Filter by entity type")
     },
@@ -30603,7 +30726,7 @@ function registerProjectTools(server, ctx, client) {
   };
   server.tool(
     "list_systems",
-    "List all systems (projects) in the configured organization",
+    "List all systems in the configured organization",
     {
       teamspaceId: external_exports.string().optional().describe("Filter to systems belonging to a specific teamspace. Empty or whitespace-only treated as no filter.")
     },
@@ -31104,9 +31227,9 @@ function registerValueVelocityTools(server, ctx, client) {
   );
   server.tool(
     "propose_enablement_edges",
-    'Propose directed enablement edges for a project \u2014 "Beat A accelerates Beat B". The LLM analyzes project Beats and proposes which ones unlock or accelerate others. Only proposed edges are created; a human must confirm before they affect Value Velocity scores. Pass beatId to scope the pass to edges FROM one Beat \u2014 strongly recommended on a large portfolio, where an unscoped pass can exceed the request timeout. If you already know the edge you want, skip proposing and use create_enablement_edge instead.',
+    'Propose directed enablement edges for a system \u2014 "Beat A accelerates Beat B". The LLM analyzes system Beats and proposes which ones unlock or accelerate others. Only proposed edges are created; a human must confirm before they affect Value Velocity scores. Pass beatId to scope the pass to edges FROM one Beat \u2014 strongly recommended on a large portfolio, where an unscoped pass can exceed the request timeout. If you already know the edge you want, skip proposing and use create_enablement_edge instead.',
     {
-      systemId: external_exports.string().describe("The project ID"),
+      systemId: external_exports.string().describe("The system ID"),
       beatId: external_exports.string().min(1).optional().describe("Scope the pass to edges FROM this Beat. Omit for a whole-project pass (slow on large portfolios).")
     },
     async ({ systemId, beatId }) => {
@@ -31492,9 +31615,9 @@ ${JSON.stringify(task.result, null, 2)}
   );
   server.tool(
     "list_tasks",
-    "DEPRECATED: use `list_jobs`. List background jobs for a project with optional status filter.",
+    "DEPRECATED: use `list_jobs`. List background jobs for a system with optional status filter.",
     {
-      systemId: external_exports.string().describe("The project ID"),
+      systemId: external_exports.string().describe("The system ID"),
       status: external_exports.enum(TASK_STATUSES).optional().describe("Filter by status"),
       limit: external_exports.coerce.number().optional().default(20).describe("Max number of jobs to return")
     },
@@ -31550,9 +31673,9 @@ ${JSON.stringify(task.result, null, 2)}
   );
   server.tool(
     "list_jobs",
-    "List background jobs for a project with optional status filter",
+    "List background jobs for a system with optional status filter",
     {
-      systemId: external_exports.string().describe("The project ID"),
+      systemId: external_exports.string().describe("The system ID"),
       status: external_exports.enum(TASK_STATUSES).optional().describe("Filter by status"),
       limit: external_exports.coerce.number().optional().default(20).describe("Max number of jobs to return")
     },
@@ -31576,7 +31699,7 @@ ${JSON.stringify(task.result, null, 2)}
     "draft_coda",
     "Generate and apply a Coda (description) for a Beat that has a title but no description. Uses project context, sibling Beats, related Notes, and codebase grep to write a resolved expression of the capability. The Coda is applied directly to the Beat, making it eligible for plan_beat_versions once a beat_quality check passes. An activity is logged so the Beat owner can review and edit. Returns a job ID \u2014 use get_job_status to track progress.",
     {
-      systemId: external_exports.string().describe("The project ID"),
+      systemId: external_exports.string().describe("The system ID"),
       beatId: external_exports.string().describe("The beat ID (must have a title but no description)")
     },
     async ({ systemId, beatId }) => {
@@ -31609,7 +31732,7 @@ ${JSON.stringify(task.result, null, 2)}
     "validate_assumptions",
     "Validate unvalidated assumption Notes against the codebase. Checks if assumptions are confirmed (validated), contradicted (invalidated), or have insufficient evidence (unvalidated). Low-criticality assumptions are auto-resolved; high-criticality are flagged for human review. Returns a job ID \u2014 use get_job_status to track progress.",
     {
-      systemId: external_exports.string().describe("The project ID"),
+      systemId: external_exports.string().describe("The system ID"),
       noteIds: external_exports.array(external_exports.string()).optional().describe("Specific assumption note IDs to validate. If omitted, validates all unvalidated assumptions.")
     },
     async ({ systemId, noteIds }) => {
@@ -31641,9 +31764,9 @@ ${JSON.stringify(task.result, null, 2)}
   );
   server.tool(
     "start_session",
-    'Start an agent session from a free-form message \u2014 like opening a Claude Code conversation pointed at your project. The message is the only instruction: describe what you want ("investigate why login fails", "implement revision rev-abc123", "what does the auth flow do?") and the agent resolves any entity references itself and does whatever the work needs \u2014 investigate and report findings, or change code and open a PR. A findings-only result with no PR is a valid outcome. Returns a job ID \u2014 use get_job_status to track progress. Requires agent sessions enabled on the project.',
+    'Start an agent session from a free-form message \u2014 like opening a Claude Code conversation pointed at your system. The message is the only instruction: describe what you want ("investigate why login fails", "implement revision rev-abc123", "what does the auth flow do?") and the agent resolves any entity references itself and does whatever the work needs \u2014 investigate and report findings, or change code and open a PR. A findings-only result with no PR is a valid outcome. Returns a job ID \u2014 use get_job_status to track progress. Requires agent sessions enabled on the system.',
     {
-      systemId: external_exports.string().min(1).describe("The project ID \u2014 the trusted scope the session is rooted at"),
+      systemId: external_exports.string().min(1).describe("The system ID \u2014 the trusted scope the session is rooted at"),
       message: external_exports.string().min(1).describe("Free-form first message describing what the session should do"),
       revisionId: external_exports.string().min(1).optional().describe("Optional Revision ID (rev-<uuid>). When provided, the Worker routes to the typed implementation session path (prepareRevisionImplementationSession), enabling file hint generation and richer session context. Omit for investigation, planning, or freeform sessions.")
     },
@@ -31681,7 +31804,7 @@ ${JSON.stringify(task.result, null, 2)}
     "plan_revision_batch",
     "Autonomously generate an implementation plan for planning Revisions. If revisionIds are omitted, discovers all unplanned planning Revisions and plans them all. Uses codebase-aware agent sessions when available, LLM-only fallback otherwise. Returns a job ID \u2014 use get_job_status to track progress.",
     {
-      systemId: external_exports.string().describe("The project ID"),
+      systemId: external_exports.string().describe("The system ID"),
       revisionIds: external_exports.array(external_exports.string()).optional().describe("Specific revision IDs to plan. If omitted, auto-discovers all unplanned planning revisions.")
     },
     async ({ systemId, revisionIds }) => {
@@ -31712,9 +31835,9 @@ ${JSON.stringify(task.result, null, 2)}
   );
   server.tool(
     "run_triage",
-    "Run the autonomous triage loop for a project. Analyzes next actions, auto-executes safe actions (draft_coda, plan_revision_batch), and escalates items that need human judgment. Requires agentCapabilities.triage enabled on the project. Returns a job ID \u2014 use get_job_status to track progress.",
+    "Run the autonomous triage loop for a system. Analyzes next actions, auto-executes safe actions (draft_coda, plan_revision_batch), and escalates items that need human judgment. Requires agentCapabilities.triage enabled on the system. Returns a job ID \u2014 use get_job_status to track progress.",
     {
-      systemId: external_exports.string().describe("The project ID")
+      systemId: external_exports.string().describe("The system ID")
     },
     async ({ systemId }) => {
       try {
@@ -31757,7 +31880,7 @@ ${JSON.stringify(task.result, null, 2)}
       "Returns a job ID \u2014 use `get_job_status` to track progress."
     ].join("\n"),
     {
-      systemId: external_exports.string().describe("The project ID"),
+      systemId: external_exports.string().describe("The system ID"),
       content: external_exports.string().describe('Document content \u2014 plain text (default) or base64-encoded binary (when encoding is "base64")'),
       filename: external_exports.string().optional().default("document.txt").describe('Original filename with extension (e.g., "sow.pdf", "spec.docx"). Used for format detection in binary mode.'),
       encoding: external_exports.enum(["base64"]).optional().describe('Set to "base64" when submitting binary files (DOCX, XLSX, PPTX, PDF). Omit for plain text.')
@@ -32207,13 +32330,13 @@ function createHttpClient(config2) {
           `/api/organizations/${encodeURIComponent(sourceOrgId)}/transfer-project`,
           { systemId: projectId, targetOrgId }
         );
-        const project = result?.project ? {
-          ...result.project,
-          systemId: result.project.id ?? result.project.systemId ?? result.project.projectId,
-          title: result.project.name ?? result.project.title,
-          orgId: result.project.organizationId ?? result.project.orgId
+        const system = result?.system ? {
+          ...result.system,
+          systemId: result.system.id ?? result.system.systemId ?? result.system.projectId,
+          title: result.system.name ?? result.system.title,
+          orgId: result.system.organizationId ?? result.system.orgId
         } : void 0;
-        return { success: result?.success ?? false, project };
+        return { success: result?.success ?? false, system };
       } catch (err) {
         if (err instanceof Error) return { success: false, error: err.message };
         return { success: false, error: String(err) };
@@ -34194,7 +34317,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"3.7.1"} starting\u2026`);
+  console.error(`[harmonica-mcp] v${"3.8.0"} starting\u2026`);
   const config2 = loadConfig();
   const client = createHttpClient({
     apiBaseUrl: config2.apiBaseUrl,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codazen/harmonica-mcp",
-  "version": "3.7.1",
+  "version": "3.8.0",
   "description": "MCP server for Harmonica — connect any MCP-compatible AI assistant to Harmonica",
   "license": "MIT",
   "bin": {