@opsee/mcp-server 0.8.2 → 0.8.4

package/gen/api/v1/initiative_pb.d.ts

@@ -608,6 +608,13 @@ export declare type DecomposeTaskInput = Message<"api.v1.DecomposeTaskInput"> &
    * @generated from field: optional uint32 board_column_id = 7;
    */
   boardColumnId?: number;
+
+  /**
+   * reconcile only: maps this node to an existing Task (kept). Omit for a new task.
+   *
+   * @generated from field: optional uint32 existing_task_id = 8;
+   */
+  existingTaskId?: number;
 };
 
 /**
@@ -689,6 +696,137 @@ export declare type DecomposeInitiativeResponse = Message<"api.v1.DecomposeIniti
  */
 export declare const DecomposeInitiativeResponseSchema: GenMessage<DecomposeInitiativeResponse>;
 
+/**
+ * @generated from message api.v1.ReconcileTaskChange
+ */
+export declare type ReconcileTaskChange = Message<"api.v1.ReconcileTaskChange"> & {
+  /**
+   * empty for not-yet-created added tasks on dry_run
+   *
+   * @generated from field: uint32 task_id = 1;
+   */
+  taskId: number;
+
+  /**
+   * empty likewise
+   *
+   * @generated from field: string identifier = 2;
+   */
+  identifier: string;
+
+  /**
+   * @generated from field: string title = 3;
+   */
+  title: string;
+
+  /**
+   * set only on flagged: why it carries execution state
+   *
+   * @generated from field: string reason = 4;
+   */
+  reason: string;
+};
+
+/**
+ * Describes the message api.v1.ReconcileTaskChange.
+ * Use `create(ReconcileTaskChangeSchema)` to create a new message.
+ */
+export declare const ReconcileTaskChangeSchema: GenMessage<ReconcileTaskChange>;
+
+/**
+ * @generated from message api.v1.ReconcileChangeset
+ */
+export declare type ReconcileChangeset = Message<"api.v1.ReconcileChangeset"> & {
+  /**
+   * @generated from field: repeated api.v1.ReconcileTaskChange added = 1;
+   */
+  added: ReconcileTaskChange[];
+
+  /**
+   * pristine drops (will be / were deleted)
+   *
+   * @generated from field: repeated api.v1.ReconcileTaskChange removed = 2;
+   */
+  removed: ReconcileTaskChange[];
+
+  /**
+   * execution-state drops — left untouched
+   *
+   * @generated from field: repeated api.v1.ReconcileTaskChange flagged = 3;
+   */
+  flagged: ReconcileTaskChange[];
+
+  /**
+   * @generated from field: repeated api.v1.InitiativeGraphEdge edges_added = 4;
+   */
+  edgesAdded: InitiativeGraphEdge[];
+
+  /**
+   * @generated from field: repeated api.v1.InitiativeGraphEdge edges_removed = 5;
+   */
+  edgesRemoved: InitiativeGraphEdge[];
+
+  /**
+   * resulting (apply) / projected (dry_run)
+   *
+   * @generated from field: api.v1.InitiativeGraph graph = 6;
+   */
+  graph?: InitiativeGraph;
+};
+
+/**
+ * Describes the message api.v1.ReconcileChangeset.
+ * Use `create(ReconcileChangesetSchema)` to create a new message.
+ */
+export declare const ReconcileChangesetSchema: GenMessage<ReconcileChangeset>;
+
+/**
+ * @generated from message api.v1.ReconcileInitiativeRequest
+ */
+export declare type ReconcileInitiativeRequest = Message<"api.v1.ReconcileInitiativeRequest"> & {
+  /**
+   * @generated from field: uint32 initiative_id = 1;
+   */
+  initiativeId: number;
+
+  /**
+   * @generated from field: repeated api.v1.DecomposeTaskInput tasks = 2;
+   */
+  tasks: DecomposeTaskInput[];
+
+  /**
+   * @generated from field: repeated api.v1.DecomposeEdgeInput edges = 3;
+   */
+  edges: DecomposeEdgeInput[];
+
+  /**
+   * @generated from field: bool dry_run = 4;
+   */
+  dryRun: boolean;
+};
+
+/**
+ * Describes the message api.v1.ReconcileInitiativeRequest.
+ * Use `create(ReconcileInitiativeRequestSchema)` to create a new message.
+ */
+export declare const ReconcileInitiativeRequestSchema: GenMessage<ReconcileInitiativeRequest>;
+
+/**
+ * @generated from message api.v1.ReconcileInitiativeResponse
+ */
+export declare type ReconcileInitiativeResponse = Message<"api.v1.ReconcileInitiativeResponse"> & {
+  /**
+   * @generated from field: api.v1.ReconcileChangeset changeset = 1;
+   */
+  changeset?: ReconcileChangeset;
+};
+
+/**
+ * Describes the message api.v1.ReconcileInitiativeResponse.
+ * Use `create(ReconcileInitiativeResponseSchema)` to create a new message.
+ */
+export declare const ReconcileInitiativeResponseSchema: GenMessage<ReconcileInitiativeResponse>;
+
 /**
  * @generated from service api.v1.InitiativeService
  */
@@ -781,5 +919,13 @@ export declare const InitiativeService: GenService<{
     input: typeof DecomposeInitiativeRequestSchema;
     output: typeof DecomposeInitiativeResponseSchema;
   },
+  /**
+   * @generated from rpc api.v1.InitiativeService.ReconcileInitiative
+   */
+  reconcileInitiative: {
+    methodKind: "unary";
+    input: typeof ReconcileInitiativeRequestSchema;
+    output: typeof ReconcileInitiativeResponseSchema;
+  },
 }>;
 

package/gen/api/v1/initiative_pb.js

@@ -14,7 +14,7 @@ import { file_api_v1_models } from "./models_pb";
  * Describes the file api/v1/initiative.proto.
  */
 export const file_api_v1_initiative = /*@__PURE__*/
-  fileDesc("ChdhcGkvdjEvaW5pdGlhdGl2ZS5wcm90bxIGYXBpLnYxItoCChRBZGRJbml0aWF0aXZlUmVxdWVzdBIZCgV0aXRsZRgBIAEoCUIK+kIHcgUQARjIARIUCgdzdW1tYXJ5GAIgASgJSACIAQESQgoGc3RhdHVzGAMgASgJQjL6Qi9yLVIFZHJhZnRSBmFjdGl2ZVIGcGF1c2VkUgljb21wbGV0ZWRSCWFiYW5kb25lZBIbCgpwcm9qZWN0X2lkGAQgASgNQgf6QgQqAigBEjgKC2FuY2hvcl90eXBlGAUgASgJQiP6QiByHlIEbm9uZVIEdGFza1IJbWlsZXN0b25lUgVjeWNsZRIWCglhbmNob3JfaWQYBiABKA1IAYgBARIWCgljb3JlX2lkZWEYByABKAlIAogBARIeChZjb3JlX2lkZWFfY29udGVudF90eXBlGAggASgJQgoKCF9zdW1tYXJ5QgwKCl9hbmNob3JfaWRCDAoKX2NvcmVfaWRlYSLzAgoVRWRpdEluaXRpYXRpdmVSZXF1ZXN0EhMKAmlkGAEgASgNQgf6QgQqAigBEhkKBXRpdGxlGAIgASgJQgr6QgdyBRABGMgBEhQKB3N1bW1hcnkYAyABKAlIAIgBARJCCgZzdGF0dXMYBCABKAlCMvpCL3ItUgVkcmFmdFIGYWN0aXZlUgZwYXVzZWRSCWNvbXBsZXRlZFIJYWJhbmRvbmVkEjgKC2FuY2hvcl90eXBlGAUgASgJQiP6QiByHlIEbm9uZVIEdGFza1IJbWlsZXN0b25lUgVjeWNsZRIWCglhbmNob3JfaWQYBiABKA1IAYgBARIWCgljb3JlX2lkZWEYByABKAlIAogBARIjChZjb3JlX2lkZWFfY29udGVudF90eXBlGAggASgJSAOIAQFCCgoIX3N1bW1hcnlCDAoKX2FuY2hvcl9pZEIMCgpfY29yZV9pZGVhQhkKF19jb3JlX2lkZWFfY29udGVudF90eXBlIiIKFEdldEluaXRpYXRpdmVSZXF1ZXN0EgoKAmlkGAEgASgNIjQKGkdldEluaXRpYXRpdmVCeVVVSURSZXF1ZXN0EhYKBHV1aWQYASABKAlCCPpCBXIDsAEBIpUBChVHZXRJbml0aWF0aXZlc1JlcXVlc3QSGwoKcHJvamVjdF9pZBgBIAEoDUIH+kIEKgIoARIwCgpwYWdpbmF0aW9uGAIgASgLMhIuYXBpLnYxLlBhZ2luYXRpb25CCPpCBYoBAhABEi0KDmZpbHRlcl9vcHRpb25zGAMgASgLMhUuYXBpLnYxLkZpbHRlck9wdGlvbnMiJQoXRGVsZXRlSW5pdGlhdGl2ZVJlcXVlc3QSCgoCaWQYASABKA0iPwoVQWRkSW5pdGlhdGl2ZVJlc3BvbnNlEiYKCmluaXRpYXRpdmUYASABKAsyEi5hcGkudjEuSW5pdGlhdGl2ZSJAChZFZGl0SW5pdGlhdGl2ZVJlc3BvbnNlEiYKCmluaXRpYXRpdmUYASABKAsyEi5hcGkudjEuSW5pdGlhdGl2ZSI/ChVHZXRJbml0aWF0aXZlUmVzcG9uc2USJgoKaW5pdGlhdGl2ZRgBIAEoCzISLmFwaS52MS5Jbml0aWF0aXZlImkKFkdldEluaXRpYXRpdmVzUmVzcG9uc2USJwoLaW5pdGlhdGl2ZXMYASADKAsyEi5hcGkudjEuSW5pdGlhdGl2ZRImCgpwYWdpbmF0aW9uGAIgASgLMhIuYXBpLnYxLlBhZ2luYXRpb24iTQoTSW5pdGlhdGl2ZUdyYXBoRWRnZRIUCgxmcm9tX3Rhc2tfaWQYASABKA0SEgoKdG9fdGFza19pZBgCIAEoDRIMCgR0eXBlGAMgASgJIjIKD0luaXRpYXRpdmVTbGljZRINCgVsYXllchgBIAEoBRIQCgh0YXNrX2lkcxgCIAMoDSKDAQoPSW5pdGlhdGl2ZUdyYXBoEhsKBXRhc2tzGAEgAygLMgwuYXBpLnYxLlRhc2sSKgoFZWRnZXMYAiADKAsyGy5hcGkudjEuSW5pdGlhdGl2ZUdyYXBoRWRnZRInCgZzbGljZXMYAyADKAsyFy5hcGkudjEuSW5pdGlhdGl2ZVNsaWNlIjsKGUdldEluaXRpYXRpdmVHcmFwaFJlcXVlc3QSHgoNaW5pdGlhdGl2ZV9pZBgBIAEoDUIH+kIEKgIoASJEChpHZXRJbml0aWF0aXZlR3JhcGhSZXNwb25zZRImCgVncmFwaBgBIAEoCzIXLmFwaS52MS5Jbml0aWF0aXZlR3JhcGgiUwobR2V0SW5pdGlhdGl2ZUNvbnRleHRSZXF1ZXN0Eh4KDWluaXRpYXRpdmVfaWQYASABKA1CB/pCBCoCKAESFAoMbWVtb3J5X2xpbWl0GAIgASgNIvgBChxHZXRJbml0aWF0aXZlQ29udGV4dFJlc3BvbnNlEiYKCmluaXRpYXRpdmUYASABKAsyEi5hcGkudjEuSW5pdGlhdGl2ZRImCgVncmFwaBgCIAEoCzIXLmFwaS52MS5Jbml0aWF0aXZlR3JhcGgSNQoObWVtb3J5X2VudHJpZXMYAyADKAsyHS5hcGkudjEuSW5pdGlhdGl2ZU1lbW9yeUVudHJ5Ei4KDXB1bGxfcmVxdWVzdHMYBCADKAsyFy5hcGkudjEuVGFza1B1bGxSZXF1ZXN0EiEKCGNvbW1lbnRzGAUgAygLMg8uYXBpLnYxLkNvbW1lbnQi2AIKH0FkZEluaXRpYXRpdmVNZW1vcnlFbnRyeVJlcXVlc3QSHgoNaW5pdGlhdGl2ZV9pZBgBIAEoDUIH+kIEKgIoARJCCgRraW5kGAIgASgJQjT6QjFyL1IIZGVjaXNpb25SB291dGNvbWVSCGxlYXJuaW5nUgdibG9ja2VyUgdjb250ZXh0EhUKBGJvZHkYAyABKAlCB/pCBHICEAESJwoMY29udGVudF90eXBlGAQgASgJQhH6Qg5yDFIEdGV4dFIEanNvbhJDCgtzb3VyY2VfdHlwZRgFIAEoCUIu+kIrcilSBG5vbmVSBHRhc2tSDHB1bGxfcmVxdWVzdFIDZG9jUgh3b3JrZmxvdxIWCglzb3VyY2VfaWQYBiABKA1IAIgBARIXCgpzb3VyY2VfdXJsGAcgASgJSAGIAQFCDAoKX3NvdXJjZV9pZEINCgtfc291cmNlX3VybCJXCiBBZGRJbml0aWF0aXZlTWVtb3J5RW50cnlSZXNwb25zZRIzCgxtZW1vcnlfZW50cnkYASABKAsyHS5hcGkudjEuSW5pdGlhdGl2ZU1lbW9yeUVudHJ5IrgBChpHZXRJbml0aWF0aXZlTWVtb3J5UmVxdWVzdBIeCg1pbml0aWF0aXZlX2lkGAEgASgNQgf6QgQqAigBEjAKCnBhZ2luYXRpb24YAiABKAsyEi5hcGkudjEuUGFnaW5hdGlvbkII+kIFigECEAESDQoFa2luZHMYAyADKAkSEwoLc291cmNlX3R5cGUYBCABKAkSFgoJc291cmNlX2lkGAUgASgNSACIAQFCDAoKX3NvdXJjZV9pZCJ8ChtHZXRJbml0aWF0aXZlTWVtb3J5UmVzcG9uc2USNQoObWVtb3J5X2VudHJpZXMYASADKAsyHS5hcGkudjEuSW5pdGlhdGl2ZU1lbW9yeUVudHJ5EiYKCnBhZ2luYXRpb24YAiABKAsyEi5hcGkudjEuUGFnaW5hdGlvbiKpAgoSRGVjb21wb3NlVGFza0lucHV0EhQKA3JlZhgBIAEoCUIH+kIEcgIQARIZCgV0aXRsZRgCIAEoCUIK+kIHcgUQARj/ARIYCgtkZXNjcmlwdGlvbhgDIAEoCUgAiAEBEhcKCnBhcmVudF9yZWYYBCABKAlIAYgBARIZCgx0YXNrX3R5cGVfaWQYBSABKA1IAogBARIdChB0YXNrX3ByaW9yaXR5X2lkGAYgASgNSAOIAQESHAoPYm9hcmRfY29sdW1uX2lkGAcgASgNSASIAQFCDgoMX2Rlc2NyaXB0aW9uQg0KC19wYXJlbnRfcmVmQg8KDV90YXNrX3R5cGVfaWRCEwoRX3Rhc2tfcHJpb3JpdHlfaWRCEgoQX2JvYXJkX2NvbHVtbl9pZCKJAQoSRGVjb21wb3NlRWRnZUlucHV0EhkKCGZyb21fcmVmGAEgASgJQgf6QgRyAhABEhcKBnRvX3JlZhgCIAEoCUIH+kIEcgIQARI/CgR0eXBlGAMgASgJQjH6Qi5yLFIGYmxvY2tzUgpibG9ja2VkX2J5UgpkdXBsaWNhdGVzUgpyZWxhdGVzX3RvIpwBChpEZWNvbXBvc2VJbml0aWF0aXZlUmVxdWVzdBIeCg1pbml0aWF0aXZlX2lkGAEgASgNQgf6QgQqAigBEjMKBXRhc2tzGAIgAygLMhouYXBpLnYxLkRlY29tcG9zZVRhc2tJbnB1dEII+kIFkgECCAESKQoFZWRnZXMYAyADKAsyGi5hcGkudjEuRGVjb21wb3NlRWRnZUlucHV0ImoKG0RlY29tcG9zZUluaXRpYXRpdmVSZXNwb25zZRIjCg1jcmVhdGVkX3Rhc2tzGAEgAygLMgwuYXBpLnYxLlRhc2sSJgoFZ3JhcGgYAiABKAsyFy5hcGkudjEuSW5pdGlhdGl2ZUdyYXBoMskLChFJbml0aWF0aXZlU2VydmljZRJsCg1BZGRJbml0aWF0aXZlEhwuYXBpLnYxLkFkZEluaXRpYXRpdmVSZXF1ZXN0Gh0uYXBpLnYxLkFkZEluaXRpYXRpdmVSZXNwb25zZSIegtPkkwIYOgEqIhMvYXBpL3YxL2luaXRpYXRpdmVzEnQKDkVkaXRJbml0aWF0aXZlEh0uYXBpLnYxLkVkaXRJbml0aWF0aXZlUmVxdWVzdBoeLmFwaS52MS5FZGl0SW5pdGlhdGl2ZVJlc3BvbnNlIiOC0+STAh06ASoaGC9hcGkvdjEvaW5pdGlhdGl2ZXMve2lkfRJuCg1HZXRJbml0aWF0aXZlEhwuYXBpLnYxLkdldEluaXRpYXRpdmVSZXF1ZXN0Gh0uYXBpLnYxLkdldEluaXRpYXRpdmVSZXNwb25zZSIggtPkkwIaEhgvYXBpL3YxL2luaXRpYXRpdmVzL3tpZH0SgQEKE0dldEluaXRpYXRpdmVCeVVVSUQSIi5hcGkudjEuR2V0SW5pdGlhdGl2ZUJ5VVVJRFJlcXVlc3QaHS5hcGkudjEuR2V0SW5pdGlhdGl2ZVJlc3BvbnNlIieC0+STAiESHy9hcGkvdjEvaW5pdGlhdGl2ZXMvdXVpZC97dXVpZH0SbAoOR2V0SW5pdGlhdGl2ZXMSHS5hcGkudjEuR2V0SW5pdGlhdGl2ZXNSZXF1ZXN0Gh4uYXBpLnYxLkdldEluaXRpYXRpdmVzUmVzcG9uc2UiG4LT5JMCFRITL2FwaS92MS9pbml0aWF0aXZlcxJtChBEZWxldGVJbml0aWF0aXZlEh8uYXBpLnYxLkRlbGV0ZUluaXRpYXRpdmVSZXF1ZXN0GhYuZ29vZ2xlLnByb3RvYnVmLkVtcHR5IiCC0+STAhoqGC9hcGkvdjEvaW5pdGlhdGl2ZXMve2lkfRKOAQoSR2V0SW5pdGlhdGl2ZUdyYXBoEiEuYXBpLnYxLkdldEluaXRpYXRpdmVHcmFwaFJlcXVlc3QaIi5hcGkudjEuR2V0SW5pdGlhdGl2ZUdyYXBoUmVzcG9uc2UiMYLT5JMCKxIpL2FwaS92MS9pbml0aWF0aXZlcy97aW5pdGlhdGl2ZV9pZH0vZ3JhcGgSlgEKFEdldEluaXRpYXRpdmVDb250ZXh0EiMuYXBpLnYxLkdldEluaXRpYXRpdmVDb250ZXh0UmVxdWVzdBokLmFwaS52MS5HZXRJbml0aWF0aXZlQ29udGV4dFJlc3BvbnNlIjOC0+STAi0SKy9hcGkvdjEvaW5pdGlhdGl2ZXMve2luaXRpYXRpdmVfaWR9L2NvbnRleHQSpAEKGEFkZEluaXRpYXRpdmVNZW1vcnlFbnRyeRInLmFwaS52MS5BZGRJbml0aWF0aXZlTWVtb3J5RW50cnlSZXF1ZXN0GiguYXBpLnYxLkFkZEluaXRpYXRpdmVNZW1vcnlFbnRyeVJlc3BvbnNlIjWC0+STAi86ASoiKi9hcGkvdjEvaW5pdGlhdGl2ZXMve2luaXRpYXRpdmVfaWR9L21lbW9yeRKSAQoTR2V0SW5pdGlhdGl2ZU1lbW9yeRIiLmFwaS52MS5HZXRJbml0aWF0aXZlTWVtb3J5UmVxdWVzdBojLmFwaS52MS5HZXRJbml0aWF0aXZlTWVtb3J5UmVzcG9uc2UiMoLT5JMCLBIqL2FwaS92MS9pbml0aWF0aXZlcy97aW5pdGlhdGl2ZV9pZH0vbWVtb3J5EpgBChNEZWNvbXBvc2VJbml0aWF0aXZlEiIuYXBpLnYxLkRlY29tcG9zZUluaXRpYXRpdmVSZXF1ZXN0GiMuYXBpLnYxLkRlY29tcG9zZUluaXRpYXRpdmVSZXNwb25zZSI4gtPkkwIyOgEqIi0vYXBpL3YxL2luaXRpYXRpdmVzL3tpbml0aWF0aXZlX2lkfS9kZWNvbXBvc2VCdAoKY29tLmFwaS52MUIPSW5pdGlhdGl2ZVByb3RvUAFaHG9wc2VlL2JhY2tlbmQvZ2VuL2FwaS92MTtnZW6iAgNBWFiqAgZBcGkuVjHKAgZBcGlcVjHiAhJBcGlcVjFcR1BCTWV0YWRhdGHqAgdBcGk6OlYxYgZwcm90bzM", [file_google_protobuf_empty, file_google_api_annotations, file_validate_validate, file_api_v1_pagination, file_api_v1_filter, file_api_v1_models]);
+  fileDesc("ChdhcGkvdjEvaW5pdGlhdGl2ZS5wcm90bxIGYXBpLnYxItoCChRBZGRJbml0aWF0aXZlUmVxdWVzdBIZCgV0aXRsZRgBIAEoCUIK+kIHcgUQARjIARIUCgdzdW1tYXJ5GAIgASgJSACIAQESQgoGc3RhdHVzGAMgASgJQjL6Qi9yLVIFZHJhZnRSBmFjdGl2ZVIGcGF1c2VkUgljb21wbGV0ZWRSCWFiYW5kb25lZBIbCgpwcm9qZWN0X2lkGAQgASgNQgf6QgQqAigBEjgKC2FuY2hvcl90eXBlGAUgASgJQiP6QiByHlIEbm9uZVIEdGFza1IJbWlsZXN0b25lUgVjeWNsZRIWCglhbmNob3JfaWQYBiABKA1IAYgBARIWCgljb3JlX2lkZWEYByABKAlIAogBARIeChZjb3JlX2lkZWFfY29udGVudF90eXBlGAggASgJQgoKCF9zdW1tYXJ5QgwKCl9hbmNob3JfaWRCDAoKX2NvcmVfaWRlYSLzAgoVRWRpdEluaXRpYXRpdmVSZXF1ZXN0EhMKAmlkGAEgASgNQgf6QgQqAigBEhkKBXRpdGxlGAIgASgJQgr6QgdyBRABGMgBEhQKB3N1bW1hcnkYAyABKAlIAIgBARJCCgZzdGF0dXMYBCABKAlCMvpCL3ItUgVkcmFmdFIGYWN0aXZlUgZwYXVzZWRSCWNvbXBsZXRlZFIJYWJhbmRvbmVkEjgKC2FuY2hvcl90eXBlGAUgASgJQiP6QiByHlIEbm9uZVIEdGFza1IJbWlsZXN0b25lUgVjeWNsZRIWCglhbmNob3JfaWQYBiABKA1IAYgBARIWCgljb3JlX2lkZWEYByABKAlIAogBARIjChZjb3JlX2lkZWFfY29udGVudF90eXBlGAggASgJSAOIAQFCCgoIX3N1bW1hcnlCDAoKX2FuY2hvcl9pZEIMCgpfY29yZV9pZGVhQhkKF19jb3JlX2lkZWFfY29udGVudF90eXBlIiIKFEdldEluaXRpYXRpdmVSZXF1ZXN0EgoKAmlkGAEgASgNIjQKGkdldEluaXRpYXRpdmVCeVVVSURSZXF1ZXN0EhYKBHV1aWQYASABKAlCCPpCBXIDsAEBIpUBChVHZXRJbml0aWF0aXZlc1JlcXVlc3QSGwoKcHJvamVjdF9pZBgBIAEoDUIH+kIEKgIoARIwCgpwYWdpbmF0aW9uGAIgASgLMhIuYXBpLnYxLlBhZ2luYXRpb25CCPpCBYoBAhABEi0KDmZpbHRlcl9vcHRpb25zGAMgASgLMhUuYXBpLnYxLkZpbHRlck9wdGlvbnMiJQoXRGVsZXRlSW5pdGlhdGl2ZVJlcXVlc3QSCgoCaWQYASABKA0iPwoVQWRkSW5pdGlhdGl2ZVJlc3BvbnNlEiYKCmluaXRpYXRpdmUYASABKAsyEi5hcGkudjEuSW5pdGlhdGl2ZSJAChZFZGl0SW5pdGlhdGl2ZVJlc3BvbnNlEiYKCmluaXRpYXRpdmUYASABKAsyEi5hcGkudjEuSW5pdGlhdGl2ZSI/ChVHZXRJbml0aWF0aXZlUmVzcG9uc2USJgoKaW5pdGlhdGl2ZRgBIAEoCzISLmFwaS52MS5Jbml0aWF0aXZlImkKFkdldEluaXRpYXRpdmVzUmVzcG9uc2USJwoLaW5pdGlhdGl2ZXMYASADKAsyEi5hcGkudjEuSW5pdGlhdGl2ZRImCgpwYWdpbmF0aW9uGAIgASgLMhIuYXBpLnYxLlBhZ2luYXRpb24iTQoTSW5pdGlhdGl2ZUdyYXBoRWRnZRIUCgxmcm9tX3Rhc2tfaWQYASABKA0SEgoKdG9fdGFza19pZBgCIAEoDRIMCgR0eXBlGAMgASgJIjIKD0luaXRpYXRpdmVTbGljZRINCgVsYXllchgBIAEoBRIQCgh0YXNrX2lkcxgCIAMoDSKDAQoPSW5pdGlhdGl2ZUdyYXBoEhsKBXRhc2tzGAEgAygLMgwuYXBpLnYxLlRhc2sSKgoFZWRnZXMYAiADKAsyGy5hcGkudjEuSW5pdGlhdGl2ZUdyYXBoRWRnZRInCgZzbGljZXMYAyADKAsyFy5hcGkudjEuSW5pdGlhdGl2ZVNsaWNlIjsKGUdldEluaXRpYXRpdmVHcmFwaFJlcXVlc3QSHgoNaW5pdGlhdGl2ZV9pZBgBIAEoDUIH+kIEKgIoASJEChpHZXRJbml0aWF0aXZlR3JhcGhSZXNwb25zZRImCgVncmFwaBgBIAEoCzIXLmFwaS52MS5Jbml0aWF0aXZlR3JhcGgiUwobR2V0SW5pdGlhdGl2ZUNvbnRleHRSZXF1ZXN0Eh4KDWluaXRpYXRpdmVfaWQYASABKA1CB/pCBCoCKAESFAoMbWVtb3J5X2xpbWl0GAIgASgNIvgBChxHZXRJbml0aWF0aXZlQ29udGV4dFJlc3BvbnNlEiYKCmluaXRpYXRpdmUYASABKAsyEi5hcGkudjEuSW5pdGlhdGl2ZRImCgVncmFwaBgCIAEoCzIXLmFwaS52MS5Jbml0aWF0aXZlR3JhcGgSNQoObWVtb3J5X2VudHJpZXMYAyADKAsyHS5hcGkudjEuSW5pdGlhdGl2ZU1lbW9yeUVudHJ5Ei4KDXB1bGxfcmVxdWVzdHMYBCADKAsyFy5hcGkudjEuVGFza1B1bGxSZXF1ZXN0EiEKCGNvbW1lbnRzGAUgAygLMg8uYXBpLnYxLkNvbW1lbnQi2AIKH0FkZEluaXRpYXRpdmVNZW1vcnlFbnRyeVJlcXVlc3QSHgoNaW5pdGlhdGl2ZV9pZBgBIAEoDUIH+kIEKgIoARJCCgRraW5kGAIgASgJQjT6QjFyL1IIZGVjaXNpb25SB291dGNvbWVSCGxlYXJuaW5nUgdibG9ja2VyUgdjb250ZXh0EhUKBGJvZHkYAyABKAlCB/pCBHICEAESJwoMY29udGVudF90eXBlGAQgASgJQhH6Qg5yDFIEdGV4dFIEanNvbhJDCgtzb3VyY2VfdHlwZRgFIAEoCUIu+kIrcilSBG5vbmVSBHRhc2tSDHB1bGxfcmVxdWVzdFIDZG9jUgh3b3JrZmxvdxIWCglzb3VyY2VfaWQYBiABKA1IAIgBARIXCgpzb3VyY2VfdXJsGAcgASgJSAGIAQFCDAoKX3NvdXJjZV9pZEINCgtfc291cmNlX3VybCJXCiBBZGRJbml0aWF0aXZlTWVtb3J5RW50cnlSZXNwb25zZRIzCgxtZW1vcnlfZW50cnkYASABKAsyHS5hcGkudjEuSW5pdGlhdGl2ZU1lbW9yeUVudHJ5IrgBChpHZXRJbml0aWF0aXZlTWVtb3J5UmVxdWVzdBIeCg1pbml0aWF0aXZlX2lkGAEgASgNQgf6QgQqAigBEjAKCnBhZ2luYXRpb24YAiABKAsyEi5hcGkudjEuUGFnaW5hdGlvbkII+kIFigECEAESDQoFa2luZHMYAyADKAkSEwoLc291cmNlX3R5cGUYBCABKAkSFgoJc291cmNlX2lkGAUgASgNSACIAQFCDAoKX3NvdXJjZV9pZCJ8ChtHZXRJbml0aWF0aXZlTWVtb3J5UmVzcG9uc2USNQoObWVtb3J5X2VudHJpZXMYASADKAsyHS5hcGkudjEuSW5pdGlhdGl2ZU1lbW9yeUVudHJ5EiYKCnBhZ2luYXRpb24YAiABKAsyEi5hcGkudjEuUGFnaW5hdGlvbiLdAgoSRGVjb21wb3NlVGFza0lucHV0EhQKA3JlZhgBIAEoCUIH+kIEcgIQARIZCgV0aXRsZRgCIAEoCUIK+kIHcgUQARj/ARIYCgtkZXNjcmlwdGlvbhgDIAEoCUgAiAEBEhcKCnBhcmVudF9yZWYYBCABKAlIAYgBARIZCgx0YXNrX3R5cGVfaWQYBSABKA1IAogBARIdChB0YXNrX3ByaW9yaXR5X2lkGAYgASgNSAOIAQESHAoPYm9hcmRfY29sdW1uX2lkGAcgASgNSASIAQESHQoQZXhpc3RpbmdfdGFza19pZBgIIAEoDUgFiAEBQg4KDF9kZXNjcmlwdGlvbkINCgtfcGFyZW50X3JlZkIPCg1fdGFza190eXBlX2lkQhMKEV90YXNrX3ByaW9yaXR5X2lkQhIKEF9ib2FyZF9jb2x1bW5faWRCEwoRX2V4aXN0aW5nX3Rhc2tfaWQiiQEKEkRlY29tcG9zZUVkZ2VJbnB1dBIZCghmcm9tX3JlZhgBIAEoCUIH+kIEcgIQARIXCgZ0b19yZWYYAiABKAlCB/pCBHICEAESPwoEdHlwZRgDIAEoCUIx+kIucixSBmJsb2Nrc1IKYmxvY2tlZF9ieVIKZHVwbGljYXRlc1IKcmVsYXRlc190byKcAQoaRGVjb21wb3NlSW5pdGlhdGl2ZVJlcXVlc3QSHgoNaW5pdGlhdGl2ZV9pZBgBIAEoDUIH+kIEKgIoARIzCgV0YXNrcxgCIAMoCzIaLmFwaS52MS5EZWNvbXBvc2VUYXNrSW5wdXRCCPpCBZIBAggBEikKBWVkZ2VzGAMgAygLMhouYXBpLnYxLkRlY29tcG9zZUVkZ2VJbnB1dCJqChtEZWNvbXBvc2VJbml0aWF0aXZlUmVzcG9uc2USIwoNY3JlYXRlZF90YXNrcxgBIAMoCzIMLmFwaS52MS5UYXNrEiYKBWdyYXBoGAIgASgLMhcuYXBpLnYxLkluaXRpYXRpdmVHcmFwaCJZChNSZWNvbmNpbGVUYXNrQ2hhbmdlEg8KB3Rhc2tfaWQYASABKA0SEgoKaWRlbnRpZmllchgCIAEoCRINCgV0aXRsZRgDIAEoCRIOCgZyZWFzb24YBCABKAkiqgIKElJlY29uY2lsZUNoYW5nZXNldBIqCgVhZGRlZBgBIAMoCzIbLmFwaS52MS5SZWNvbmNpbGVUYXNrQ2hhbmdlEiwKB3JlbW92ZWQYAiADKAsyGy5hcGkudjEuUmVjb25jaWxlVGFza0NoYW5nZRIsCgdmbGFnZ2VkGAMgAygLMhsuYXBpLnYxLlJlY29uY2lsZVRhc2tDaGFuZ2USMAoLZWRnZXNfYWRkZWQYBCADKAsyGy5hcGkudjEuSW5pdGlhdGl2ZUdyYXBoRWRnZRIyCg1lZGdlc19yZW1vdmVkGAUgAygLMhsuYXBpLnYxLkluaXRpYXRpdmVHcmFwaEVkZ2USJgoFZ3JhcGgYBiABKAsyFy5hcGkudjEuSW5pdGlhdGl2ZUdyYXBoIq0BChpSZWNvbmNpbGVJbml0aWF0aXZlUmVxdWVzdBIeCg1pbml0aWF0aXZlX2lkGAEgASgNQgf6QgQqAigBEjMKBXRhc2tzGAIgAygLMhouYXBpLnYxLkRlY29tcG9zZVRhc2tJbnB1dEII+kIFkgECCAESKQoFZWRnZXMYAyADKAsyGi5hcGkudjEuRGVjb21wb3NlRWRnZUlucHV0Eg8KB2RyeV9ydW4YBCABKAgiTAobUmVjb25jaWxlSW5pdGlhdGl2ZVJlc3BvbnNlEi0KCWNoYW5nZXNldBgBIAEoCzIaLmFwaS52MS5SZWNvbmNpbGVDaGFuZ2VzZXQy5AwKEUluaXRpYXRpdmVTZXJ2aWNlEmwKDUFkZEluaXRpYXRpdmUSHC5hcGkudjEuQWRkSW5pdGlhdGl2ZVJlcXVlc3QaHS5hcGkudjEuQWRkSW5pdGlhdGl2ZVJlc3BvbnNlIh6C0+STAhg6ASoiEy9hcGkvdjEvaW5pdGlhdGl2ZXMSdAoORWRpdEluaXRpYXRpdmUSHS5hcGkudjEuRWRpdEluaXRpYXRpdmVSZXF1ZXN0Gh4uYXBpLnYxLkVkaXRJbml0aWF0aXZlUmVzcG9uc2UiI4LT5JMCHToBKhoYL2FwaS92MS9pbml0aWF0aXZlcy97aWR9Em4KDUdldEluaXRpYXRpdmUSHC5hcGkudjEuR2V0SW5pdGlhdGl2ZVJlcXVlc3QaHS5hcGkudjEuR2V0SW5pdGlhdGl2ZVJlc3BvbnNlIiCC0+STAhoSGC9hcGkvdjEvaW5pdGlhdGl2ZXMve2lkfRKBAQoTR2V0SW5pdGlhdGl2ZUJ5VVVJRBIiLmFwaS52MS5HZXRJbml0aWF0aXZlQnlVVUlEUmVxdWVzdBodLmFwaS52MS5HZXRJbml0aWF0aXZlUmVzcG9uc2UiJ4LT5JMCIRIfL2FwaS92MS9pbml0aWF0aXZlcy91dWlkL3t1dWlkfRJsCg5HZXRJbml0aWF0aXZlcxIdLmFwaS52MS5HZXRJbml0aWF0aXZlc1JlcXVlc3QaHi5hcGkudjEuR2V0SW5pdGlhdGl2ZXNSZXNwb25zZSIbgtPkkwIVEhMvYXBpL3YxL2luaXRpYXRpdmVzEm0KEERlbGV0ZUluaXRpYXRpdmUSHy5hcGkudjEuRGVsZXRlSW5pdGlhdGl2ZVJlcXVlc3QaFi5nb29nbGUucHJvdG9idWYuRW1wdHkiIILT5JMCGioYL2FwaS92MS9pbml0aWF0aXZlcy97aWR9Eo4BChJHZXRJbml0aWF0aXZlR3JhcGgSIS5hcGkudjEuR2V0SW5pdGlhdGl2ZUdyYXBoUmVxdWVzdBoiLmFwaS52MS5HZXRJbml0aWF0aXZlR3JhcGhSZXNwb25zZSIxgtPkkwIrEikvYXBpL3YxL2luaXRpYXRpdmVzL3tpbml0aWF0aXZlX2lkfS9ncmFwaBKWAQoUR2V0SW5pdGlhdGl2ZUNvbnRleHQSIy5hcGkudjEuR2V0SW5pdGlhdGl2ZUNvbnRleHRSZXF1ZXN0GiQuYXBpLnYxLkdldEluaXRpYXRpdmVDb250ZXh0UmVzcG9uc2UiM4LT5JMCLRIrL2FwaS92MS9pbml0aWF0aXZlcy97aW5pdGlhdGl2ZV9pZH0vY29udGV4dBKkAQoYQWRkSW5pdGlhdGl2ZU1lbW9yeUVudHJ5EicuYXBpLnYxLkFkZEluaXRpYXRpdmVNZW1vcnlFbnRyeVJlcXVlc3QaKC5hcGkudjEuQWRkSW5pdGlhdGl2ZU1lbW9yeUVudHJ5UmVzcG9uc2UiNYLT5JMCLzoBKiIqL2FwaS92MS9pbml0aWF0aXZlcy97aW5pdGlhdGl2ZV9pZH0vbWVtb3J5EpIBChNHZXRJbml0aWF0aXZlTWVtb3J5EiIuYXBpLnYxLkdldEluaXRpYXRpdmVNZW1vcnlSZXF1ZXN0GiMuYXBpLnYxLkdldEluaXRpYXRpdmVNZW1vcnlSZXNwb25zZSIygtPkkwIsEiovYXBpL3YxL2luaXRpYXRpdmVzL3tpbml0aWF0aXZlX2lkfS9tZW1vcnkSmAEKE0RlY29tcG9zZUluaXRpYXRpdmUSIi5hcGkudjEuRGVjb21wb3NlSW5pdGlhdGl2ZVJlcXVlc3QaIy5hcGkudjEuRGVjb21wb3NlSW5pdGlhdGl2ZVJlc3BvbnNlIjiC0+STAjI6ASoiLS9hcGkvdjEvaW5pdGlhdGl2ZXMve2luaXRpYXRpdmVfaWR9L2RlY29tcG9zZRKYAQoTUmVjb25jaWxlSW5pdGlhdGl2ZRIiLmFwaS52MS5SZWNvbmNpbGVJbml0aWF0aXZlUmVxdWVzdBojLmFwaS52MS5SZWNvbmNpbGVJbml0aWF0aXZlUmVzcG9uc2UiOILT5JMCMjoBKiItL2FwaS92MS9pbml0aWF0aXZlcy97aW5pdGlhdGl2ZV9pZH0vcmVjb25jaWxlQnQKCmNvbS5hcGkudjFCD0luaXRpYXRpdmVQcm90b1ABWhxvcHNlZS9iYWNrZW5kL2dlbi9hcGkvdjE7Z2VuogIDQVhYqgIGQXBpLlYxygIGQXBpXFYx4gISQXBpXFYxXEdQQk1ldGFkYXRh6gIHQXBpOjpWMWIGcHJvdG8z", [file_google_protobuf_empty, file_google_api_annotations, file_validate_validate, file_api_v1_pagination, file_api_v1_filter, file_api_v1_models]);
 
 /**
  * Describes the message api.v1.AddInitiativeRequest.
@@ -191,6 +191,34 @@ export const DecomposeInitiativeRequestSchema = /*@__PURE__*/
 export const DecomposeInitiativeResponseSchema = /*@__PURE__*/
   messageDesc(file_api_v1_initiative, 24);
 
+/**
+ * Describes the message api.v1.ReconcileTaskChange.
+ * Use `create(ReconcileTaskChangeSchema)` to create a new message.
+ */
+export const ReconcileTaskChangeSchema = /*@__PURE__*/
+  messageDesc(file_api_v1_initiative, 25);
+
+/**
+ * Describes the message api.v1.ReconcileChangeset.
+ * Use `create(ReconcileChangesetSchema)` to create a new message.
+ */
+export const ReconcileChangesetSchema = /*@__PURE__*/
+  messageDesc(file_api_v1_initiative, 26);
+
+/**
+ * Describes the message api.v1.ReconcileInitiativeRequest.
+ * Use `create(ReconcileInitiativeRequestSchema)` to create a new message.
+ */
+export const ReconcileInitiativeRequestSchema = /*@__PURE__*/
+  messageDesc(file_api_v1_initiative, 27);
+
+/**
+ * Describes the message api.v1.ReconcileInitiativeResponse.
+ * Use `create(ReconcileInitiativeResponseSchema)` to create a new message.
+ */
+export const ReconcileInitiativeResponseSchema = /*@__PURE__*/
+  messageDesc(file_api_v1_initiative, 28);
+
 /**
  * @generated from service api.v1.InitiativeService
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opsee/mcp-server",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "description": "Opsee MCP server — manage projects, tasks, docs, and cycles from AI coding environments",
   "type": "module",
   "bin": {

package/src/__tests__/initiatives.test.ts

@@ -0,0 +1,188 @@
+import { describe, test, expect, beforeAll, afterAll, beforeEach } from "vitest";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
+import { createServer } from "../server.js";
+import type { ApiClients } from "../client/api.js";
+
+const mockInitiative = {
+  id: 2,
+  uuid: "u-2",
+  title: "Async brain",
+  status: "active",
+  anchorType: "none",
+  coreIdea: "",
+  projectId: 1,
+  createdByUserId: 7,
+};
+
+// Records the last addInitiativeMemoryEntry request so checkpoint tests can assert the mapping.
+export let lastMemoryReq: any = null;
+
+// Records the last getInitiatives request so list tests can assert the mapping.
+export let lastListReq: any = null;
+
+// Records the last reconcileInitiative request so reconcile tests can assert pass-through.
+export let lastReconcileReq: any = null;
+
+const mockListInitiative = {
+  id: 2, uuid: "u-2", title: "Auth refactor", status: "active",
+  anchorType: "none", coreIdea: "", projectId: 1, createdByUserId: 7,
+};
+
+function createMockClients(): ApiClients {
+  lastMemoryReq = null;
+  lastListReq = null;
+  lastReconcileReq = null;
+  return {
+    initiatives: {
+      getInitiatives: async (req: any) => {
+        lastListReq = req;
+        return { initiatives: [mockListInitiative], pagination: {} };
+      },
+      getInitiativeContext: async () => ({
+        initiative: mockInitiative,
+        graph: undefined,
+        memoryEntries: [],
+        pullRequests: [],
+        comments: [],
+      }),
+      reconcileInitiative: async (req: any) => {
+        lastReconcileReq = req;
+        return {
+          changeset: {
+            added: [{ taskId: 0, identifier: "", title: "New", reason: "" }],
+            removed: [],
+            flagged: [{ taskId: 3, identifier: "T-3", title: "InFlight", reason: "has linked PR" }],
+            edgesAdded: [],
+            edgesRemoved: [],
+          },
+        };
+      },
+      addInitiativeMemoryEntry: async (req: any) => {
+        lastMemoryReq = req;
+        return {
+          memoryEntry: {
+            id: 99,
+            initiativeId: req.initiativeId,
+            kind: req.kind,
+            body: req.body,
+            contentType: req.contentType,
+            sourceType: req.sourceType,
+            sourceId: req.sourceId,
+            sourceUrl: req.sourceUrl,
+          },
+        };
+      },
+    },
+  } as unknown as ApiClients;
+}
+
+describe("Initiative write-back discipline", () => {
+  let client: Client;
+  let cleanup: () => Promise<void>;
+
+  beforeAll(async () => {
+    const [ct, st] = InMemoryTransport.createLinkedPair();
+    const server = createServer(() => createMockClients());
+    await server.connect(st);
+    client = new Client({ name: "init-test", version: "1.0.0" });
+    await client.connect(ct);
+    cleanup = async () => { await client.close(); await server.close(); };
+  });
+
+  afterAll(async () => { await cleanup(); });
+
+  beforeEach(() => { lastMemoryReq = null; lastListReq = null; lastReconcileReq = null; });
+
+  test("get_initiative_context appends the working agreement", async () => {
+    const result = await client.callTool({
+      name: "opsee_get_initiative_context",
+      arguments: { initiativeId: 2 },
+    });
+    const text = (result.content as Array<{ type: string; text: string }>)[0].text;
+    expect(text).toContain("Working agreement");
+    expect(text).toContain("opsee_checkpoint");
+    expect(text).toContain("opsee_add_initiative_memory");
+  });
+
+  test("checkpoint writes an outcome entry by default with no source", async () => {
+    const result = await client.callTool({
+      name: "opsee_checkpoint",
+      arguments: { initiativeId: 2, summary: "Wired the parser" },
+    });
+    const text = (result.content as Array<{ type: string; text: string }>)[0].text;
+    expect(text).toContain("Checkpoint recorded");
+    expect(lastMemoryReq.kind).toBe("outcome");
+    expect(lastMemoryReq.body).toBe("Wired the parser");
+    expect(lastMemoryReq.sourceType).toBe("none");
+    // next-obligations nudge
+    expect(text).toContain("Link the PR");
+  });
+
+  test("checkpoint maps taskId to a task source", async () => {
+    await client.callTool({
+      name: "opsee_checkpoint",
+      arguments: { initiativeId: 2, summary: "done", taskId: 918 },
+    });
+    expect(lastMemoryReq.sourceType).toBe("task");
+    expect(lastMemoryReq.sourceId).toBe(918);
+    expect(lastMemoryReq.sourceUrl).toBeUndefined();
+  });
+
+  test("checkpoint maps prUrl to a pull_request source", async () => {
+    await client.callTool({
+      name: "opsee_checkpoint",
+      arguments: { initiativeId: 2, summary: "shipped", prUrl: "https://example.com/mr/94" },
+    });
+    expect(lastMemoryReq.sourceType).toBe("pull_request");
+    expect(lastMemoryReq.sourceUrl).toBe("https://example.com/mr/94");
+    expect(lastMemoryReq.sourceId).toBeUndefined();
+  });
+
+  test("checkpoint with both taskId and prUrl prefers task source and keeps the url", async () => {
+    await client.callTool({
+      name: "opsee_checkpoint",
+      arguments: { initiativeId: 2, summary: "both", taskId: 918, prUrl: "https://example.com/mr/94" },
+    });
+    expect(lastMemoryReq.sourceType).toBe("task");
+    expect(lastMemoryReq.sourceId).toBe(918);
+    expect(lastMemoryReq.sourceUrl).toBe("https://example.com/mr/94");
+  });
+
+  test("checkpoint honors an explicit kind", async () => {
+    await client.callTool({
+      name: "opsee_checkpoint",
+      arguments: { initiativeId: 2, summary: "learned a thing", kind: "learning" },
+    });
+    expect(lastMemoryReq.kind).toBe("learning");
+  });
+
+  test("list_initiatives passes search through filterOptions", async () => {
+    await client.callTool({
+      name: "opsee_list_initiatives",
+      arguments: { projectId: 1, search: "auth" },
+    });
+    expect(lastListReq.filterOptions?.search).toBe("auth");
+  });
+
+  test("list_initiatives omits filterOptions when no search", async () => {
+    await client.callTool({
+      name: "opsee_list_initiatives",
+      arguments: { projectId: 1 },
+    });
+    expect(lastListReq.filterOptions).toBeUndefined();
+  });
+
+  test("reconcile passes dryRun + existingTaskId and renders flagged drops", async () => {
+    const result = await client.callTool({
+      name: "opsee_reconcile_initiative",
+      arguments: { initiativeId: 2, dryRun: true, tasks: [{ ref: "a", title: "Keep", existingTaskId: 1 }], edges: [] },
+    });
+    expect(lastReconcileReq.dryRun).toBe(true);
+    expect(lastReconcileReq.tasks[0].existingTaskId).toBe(1);
+    const text = (result.content as Array<{ type: string; text: string }>)[0].text;
+    expect(text).toContain("[DRY RUN");
+    expect(text).toContain("flagged");
+    expect(text).toContain("has linked PR");
+  });
+});

package/src/tools/initiatives.ts

@@ -9,6 +9,7 @@ import {
   formatInitiativeMemoryList,
   formatInitiativeGraph,
   formatInitiativeContext,
+  formatReconcileChangeset,
   formatError,
 } from "../utils/format.js";
 
@@ -24,15 +25,19 @@ export function registerInitiativeTools(
 ): void {
   server.tool(
     "opsee_list_initiatives",
-    "List initiatives in an Opsee project.",
-    { projectId: z.number().describe("The project ID") },
+    "List initiatives in an Opsee project. Pass `search` to find a specific initiative by keyword — it matches the title and summary, tokenized, and ranks the best match first (most-recently-updated breaks ties). Use this to resume work by name, e.g. for \"resume the auth-refactor initiative\" call with search: \"auth\". Without `search`, returns all initiatives, most recent first.",
+    {
+      projectId: z.number().describe("The project ID"),
+      search: z.string().optional().describe("Keyword to match against initiative title + summary (ranked); omit to list all by recency"),
+    },
     { readOnlyHint: true, destructiveHint: false },
-    async ({ projectId }) => {
+    async ({ projectId, search }) => {
       try {
         const clients = getClients();
         const res = await clients.initiatives.getInitiatives({
           projectId,
           pagination: overridePagination(),
+          filterOptions: search ? { search } : undefined,
         });
         return { content: [{ type: "text", text: formatInitiativeList(res.initiatives) }] };
       } catch (error) {
@@ -43,7 +48,7 @@ export function registerInitiativeTools(
 
   server.tool(
     "opsee_get_initiative",
-    "Get details of a specific initiative by ID.",
+    "Get details of a specific initiative by ID (title, status, summary, core idea). To pick up or resume WORK on it — the task tree, memory log, and PRs together — call opsee_get_initiative_context instead.",
     { initiativeId: z.number().describe("The initiative ID") },
     { readOnlyHint: true, destructiveHint: false },
     async ({ initiativeId }) => {
@@ -60,7 +65,7 @@ export function registerInitiativeTools(
 
   server.tool(
     "opsee_create_initiative",
-    "Create a new initiative in an Opsee project.",
+    "Create a new initiative in an Opsee project. After creating, expand the plan in the core idea (the coreIdea field); when the plan is ready, propose a decomposition with opsee_decompose_initiative rather than creating tasks by hand.",
     {
       projectId: z.number().describe("The project ID"),
       title: z.string().describe("Initiative title"),
@@ -98,7 +103,7 @@ export function registerInitiativeTools(
 
   server.tool(
     "opsee_update_initiative",
-    "Update an initiative's fields. Fetches the current initiative first, then applies only the provided changes.",
+    "Update an initiative's fields. Fetches the current initiative first, then applies only the provided changes. Status lifecycle: draft → active (opsee_decompose_initiative flips this automatically) → completed when the work is done. For dropped work, set status to 'abandoned' WITH a reason (in the summary or a memory entry) rather than deleting — that preserves the shared brain.",
     {
       initiativeId: z.number().describe("The initiative ID to update"),
       title: z.string().optional().describe("New title"),
@@ -140,7 +145,7 @@ export function registerInitiativeTools(
 
   server.tool(
     "opsee_delete_initiative",
-    "Delete an initiative permanently.",
+    "Delete an initiative permanently. Prefer setting status to 'abandoned' (via opsee_update_initiative) with a reason — that preserves the initiative's memory/shared brain for later reference. Only hard-delete an initiative created in error.",
     { initiativeId: z.number().describe("The initiative ID to delete") },
     { readOnlyHint: false, destructiveHint: true },
     async ({ initiativeId }) => {
@@ -156,7 +161,7 @@ export function registerInitiativeTools(
 
   server.tool(
     "opsee_get_initiative_context",
-    "Load an entire Initiative work session in one call: the core-idea doc body, the execution task tree with parallel slices (what can run concurrently vs sequentially), the append-only memory log, and rolled-up PRs. Call this first when picking up or resuming work on an Initiative.",
+    "Load an entire Initiative work session in one call: the core-idea doc body, the execution task tree with parallel slices (what can run concurrently vs sequentially), the append-only memory log, and rolled-up PRs. Call this FIRST when picking up or resuming work on an Initiative. The response ends with a working agreement: treat this context as the source of truth, log decisions/blockers/learnings as you go with opsee_add_initiative_memory, and call opsee_checkpoint when you finish a unit of work.",
     {
       initiativeId: z.number().describe("The initiative ID"),
       memoryLimit: z.number().optional().describe("Cap on memory entries returned (most recent first); 0 or omitted = service default"),
@@ -186,7 +191,7 @@ export function registerInitiativeTools(
 
   server.tool(
     "opsee_get_initiative_graph",
-    "Get the task dependency graph for an initiative, including parallel execution batches (slices).",
+    "Get the task dependency graph for an initiative, including parallel execution batches (slices). Use the slices to choose the next batch of tasks that can be worked concurrently. (opsee_get_initiative_context already includes this graph — call this only when you need the graph on its own.)",
     { initiativeId: z.number().describe("The initiative ID") },
     { readOnlyHint: true, destructiveHint: false },
     async ({ initiativeId }) => {
@@ -203,7 +208,7 @@ export function registerInitiativeTools(
 
   server.tool(
     "opsee_decompose_initiative",
-    "Materialize a proposed breakdown as real Tasks under the Initiative in one atomic call. Wire the tree with temporary `ref` ids: set `parentRef` to nest a subtask, and add `edges` (from_ref blocks to_ref) to express sequencing — tasks with no blocking edge between them become parallel slices. All-or-nothing: a bad ref rolls the whole thing back.",
+    "Materialize a proposed breakdown as real Tasks under the Initiative. PROPOSE FIRST: present the proposed task tree (titles, structure, dependencies) to the human and get their approval BEFORE calling this — that approval is the \"confirm\" step. Nothing is created until you call it, so to let the human decline, simply don't call it. Calling it materializes the tasks onto the board in one atomic operation and moves a draft Initiative to active (the conclude→execute transition). Wire the tree with temporary `ref` ids: set `parentRef` to nest a subtask, and add `edges` (from_ref blocks to_ref) to express sequencing — tasks with no blocking edge between them become parallel slices. All-or-nothing: a bad ref rolls the whole thing back.",
     {
       initiativeId: z.number().describe("The initiative ID"),
       tasks: z.array(z.object({
@@ -256,9 +261,81 @@ export function registerInitiativeTools(
     },
   );
 
+  server.tool(
+    "opsee_reconcile_initiative",
+    [
+      "Reconcile a proposed task tree against the current Initiative — diff, flag, and optionally apply.",
+      "",
+      "Use this when the Initiative already has tasks (from opsee_decompose_initiative) and the plan has changed.",
+      "For first-time task creation on a fresh Initiative, use opsee_decompose_initiative instead.",
+      "",
+      "Workflow (follow this every time):",
+      "1. Call opsee_get_initiative_context to load the current task tree. Note each task's ID.",
+      "2. Build your proposed task list. For tasks that already exist and should be kept, set existingTaskId",
+      "   to the task's real ID (from the context). Omit existingTaskId for brand-new tasks.",
+      "3. Call opsee_reconcile_initiative with dryRun:true to preview the changeset.",
+      "4. Present the changeset to the human — ESPECIALLY the flagged items. Flagged tasks carry real",
+      "   execution state (linked PRs, worklogs, in-progress status) and will NOT be deleted. They stay",
+      "   on the board unchanged; the human must decide what to do with them.",
+      "5. Get explicit human approval before applying.",
+      "6. Call opsee_reconcile_initiative with dryRun:false to apply the approved plan.",
+    ].join("\n"),
+    {
+      initiativeId: z.number().describe("The initiative ID"),
+      tasks: z.array(z.object({
+        ref: z.string().describe("Temporary reference ID used to wire edges and parent relationships"),
+        title: z.string().describe("Task title"),
+        description: z.string().optional().describe("Task description"),
+        parentRef: z.string().optional().describe("Ref of the parent task (to nest this as a subtask)"),
+        taskTypeId: z.number().optional().describe("Task type ID"),
+        taskPriorityId: z.number().optional().describe("Task priority ID"),
+        boardColumnId: z.number().optional().describe("Board column ID (status)"),
+        existingTaskId: z.number().optional().describe("Real task ID from the current Initiative — tag kept tasks with this value (obtained from opsee_get_initiative_context). Omit for new tasks."),
+      })).describe("Proposed task tree — include kept tasks with existingTaskId, new tasks without"),
+      edges: z.array(z.object({
+        fromRef: z.string().describe("Ref of the source task"),
+        toRef: z.string().describe("Ref of the target task"),
+        type: z.enum(EDGE_TYPES).describe("Dependency type: blocks | blocked_by | duplicates | relates_to"),
+      })).describe("Dependency edges between tasks (by ref)"),
+      dryRun: z.boolean().optional().describe("When true, compute and return the changeset without writing anything. Always call with dryRun:true first to preview."),
+    },
+    { readOnlyHint: false, destructiveHint: true },
+    async ({ initiativeId, tasks, edges, dryRun }) => {
+      try {
+        const clients = getClients();
+        const res = await clients.initiatives.reconcileInitiative({
+          initiativeId,
+          tasks: tasks.map((t) => ({
+            ref: t.ref,
+            title: t.title,
+            description: t.description,
+            parentRef: t.parentRef,
+            taskTypeId: t.taskTypeId,
+            taskPriorityId: t.taskPriorityId,
+            boardColumnId: t.boardColumnId,
+            existingTaskId: t.existingTaskId,
+          })),
+          edges: edges.map((e) => ({
+            fromRef: e.fromRef,
+            toRef: e.toRef,
+            type: e.type,
+          })),
+          dryRun: dryRun ?? false,
+        });
+        if (!res.changeset) {
+          return { content: [{ type: "text", text: "Reconcile returned no changeset. Retry; if it persists, surface the call to the Opsee team." }], isError: true };
+        }
+        const preview = dryRun ?? false ? "[DRY RUN — no changes applied]\n\n" : "";
+        return { content: [{ type: "text", text: preview + formatReconcileChangeset(res.changeset) }] };
+      } catch (error) {
+        return { content: [{ type: "text", text: formatError(error) }], isError: true };
+      }
+    },
+  );
+
   server.tool(
     "opsee_add_initiative_memory",
-    "Record a decision, outcome, learning, blocker, or context entry to the Initiative's append-only memory log. Agents should record here as they work, citing the source task or PR where relevant.",
+    "Log a SINGLE decision, outcome, learning, blocker, or context entry to the Initiative's append-only memory the moment it happens — the as-you-go granular logger. Cite the source task or PR where relevant. For end-of-unit wrap-ups, use opsee_checkpoint instead.",
     {
       initiativeId: z.number().describe("The initiative ID"),
       kind: z.enum(MEMORY_KINDS).describe("Entry kind: decision | outcome | learning | blocker | context"),
@@ -292,6 +369,53 @@ export function registerInitiativeTools(
     },
   );
 
+  server.tool(
+    "opsee_checkpoint",
+    "End-of-unit wrap-up for an Initiative: records what a unit of work accomplished to the Initiative's memory and links what it touched. Call this when you finish a coherent chunk of work (a task, a PR, an investigation) — distinct from opsee_add_initiative_memory, which logs a single decision/blocker the moment it happens. Defaults the entry kind to 'outcome'.",
+    {
+      initiativeId: z.number().describe("The initiative ID"),
+      summary: z.string().describe("What this unit of work accomplished and what's next"),
+      kind: z.enum(MEMORY_KINDS).optional().describe("Memory entry kind. Defaults to 'outcome'"),
+      taskId: z.number().optional().describe("The task this work advanced (links the entry to it)"),
+      prUrl: z.string().optional().describe("The PR/MR this work produced (recorded as the entry's source URL)"),
+    },
+    { readOnlyHint: false, destructiveHint: false },
+    async ({ initiativeId, summary, kind, taskId, prUrl }) => {
+      try {
+        const clients = getClients();
+        let sourceType = "none";
+        let sourceId: number | undefined = undefined;
+        let sourceUrl: string | undefined = undefined;
+        if (taskId !== undefined) {
+          sourceType = "task";
+          sourceId = taskId;
+          if (prUrl !== undefined) sourceUrl = prUrl;
+        } else if (prUrl !== undefined) {
+          sourceType = "pull_request";
+          sourceUrl = prUrl;
+        }
+        const res = await clients.initiatives.addInitiativeMemoryEntry({
+          initiativeId,
+          kind: kind ?? "outcome",
+          body: summary,
+          contentType: "text",
+          sourceType,
+          sourceId,
+          sourceUrl,
+        });
+        if (!res.memoryEntry)
+          return { content: [{ type: "text", text: "Failed to record checkpoint. The backend returned an empty response (no error). Retry; if it persists, surface the call to the Opsee team." }], isError: true };
+        const nudge =
+          "\n\nNext: Link the PR to its task and advance the task's board column if you haven't — so this work rolls up on the Initiative.";
+        return {
+          content: [{ type: "text", text: `Checkpoint recorded:\n${formatInitiativeMemoryEntry(res.memoryEntry)}${nudge}` }],
+        };
+      } catch (error) {
+        return { content: [{ type: "text", text: formatError(error) }], isError: true };
+      }
+    },
+  );
+
   server.tool(
     "opsee_list_initiative_memory",
     "List memory entries for an initiative (newest first). Optionally filter by kind, source type, or source ID.",

package/src/tools/tasks.ts

@@ -574,7 +574,7 @@ export function registerTaskTools(
 
   server.tool(
     "opsee_link_task_to_initiative",
-    "Link an existing task to an Initiative. Fetches the task first so no other fields are blanked.",
+    "Link an existing task to an Initiative — use this to bring an already-existing task into an initiative's scope. To create NEW tasks under an initiative, use opsee_decompose_initiative (first time) or opsee_reconcile_initiative (re-planning) instead. Fetches the task first so no other fields are blanked.",
     {
       taskId: z.number().describe("The task ID to link"),
       initiativeId: z.number().int().min(1).describe("The initiative ID to link the task to"),

package/src/utils/format.ts

@@ -1,6 +1,6 @@
 import type { Task, Project, Cycle, DocPage, DocSpace, Milestone, MilestoneTask, User, Label, TaskLabel, Comment, TaskDependency, Initiative, InitiativeMemoryEntry, TaskPullRequest } from "../../gen/api/v1/models_pb.js";
 import { TaskDependencyType } from "../../gen/api/v1/models_pb.js";
-import type { InitiativeGraph, InitiativeSlice } from "../../gen/api/v1/initiative_pb.js";
+import type { InitiativeGraph, InitiativeSlice, ReconcileChangeset } from "../../gen/api/v1/initiative_pb.js";
 
 export function formatProject(p: Project): string {
   const lines = [
@@ -472,6 +472,15 @@ export function formatInitiativeGraph(graph: InitiativeGraph, taskMap?: Map<numb
   return lines.join("\n");
 }
 
+export const WORKING_AGREEMENT = [
+  "— Working agreement —",
+  "This Initiative is a shared brain that outlives this session. To keep it useful:",
+  "1. This context (core idea · task tree · memory · PRs) is the source of truth — read it before acting.",
+  "2. Log each decision / blocker / learning as it happens with opsee_add_initiative_memory (cite the task or PR).",
+  "3. When you finish a unit of work, call opsee_checkpoint to record what changed and what's next.",
+  "4. Link PRs to their tasks so they roll up here.",
+].join("\n");
+
 export function formatInitiativeContext(
   initiative: Initiative,
   graph: InitiativeGraph | undefined,
@@ -524,9 +533,63 @@ export function formatInitiativeContext(
     });
   }
 
+  sections.push("\n" + WORKING_AGREEMENT);
   return sections.join("\n");
 }
 
+export function formatReconcileChangeset(changeset: ReconcileChangeset): string {
+  const lines: string[] = [];
+
+  if (changeset.added.length > 0) {
+    lines.push(`Added (${changeset.added.length}):`);
+    changeset.added.forEach((t) => {
+      const id = t.identifier || (t.taskId ? `#${t.taskId}` : "(new)");
+      lines.push(`  + [${id}] ${t.title}`);
+    });
+  }
+
+  if (changeset.removed.length > 0) {
+    lines.push(`Removed — pristine, no work detected (${changeset.removed.length}):`);
+    changeset.removed.forEach((t) => {
+      const id = t.identifier || `#${t.taskId}`;
+      lines.push(`  − [${id}] ${t.title}`);
+    });
+  }
+
+  if (changeset.flagged.length > 0) {
+    lines.push(`Flagged — NOT removed, carries execution state (${changeset.flagged.length}):`);
+    lines.push("  These tasks have real work in progress and were left untouched.");
+    changeset.flagged.forEach((t) => {
+      const id = t.identifier || `#${t.taskId}`;
+      lines.push(`  ! [${id}] ${t.title} — flagged: ${t.reason}`);
+    });
+  }
+
+  if (changeset.edgesAdded.length > 0) {
+    lines.push(`Edges + (${changeset.edgesAdded.length}):`);
+    changeset.edgesAdded.forEach((e) => {
+      lines.push(`  + #${e.fromTaskId} ${e.type.toUpperCase()} #${e.toTaskId}`);
+    });
+  }
+
+  if (changeset.edgesRemoved.length > 0) {
+    lines.push(`Edges − (${changeset.edgesRemoved.length}):`);
+    changeset.edgesRemoved.forEach((e) => {
+      lines.push(`  − #${e.fromTaskId} ${e.type.toUpperCase()} #${e.toTaskId}`);
+    });
+  }
+
+  if (lines.length === 0) {
+    lines.push("No changes — the proposed plan matches the existing task tree.");
+  }
+
+  if (changeset.graph) {
+    lines.push("\n" + formatInitiativeGraph(changeset.graph));
+  }
+
+  return lines.join("\n");
+}
+
 export function formatError(error: unknown): string {
   if (error instanceof Error) {
     const msg = error.message;