assess_create_idea
Capture and assess new ideas within the ADD framework, starting in the Assess realm to evaluate potential before decision-making.
Instructions
Capture a new idea (always starts in Assess realm).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ideaName | Yes | Idea name/details (max 1500 chars) | |
| collectionRecordName | No | Optional recordName of the parent collection. |
Implementation Reference
- src/index.ts:967-983 (handler)The core handler function `createIdea` that executes the tool logic: constructs a ZenTaskticIdea record with Assess realmId=1, generates UUIDs, sets timestamps and optional collection reference, and returns a mock success response (in production would save to CloudKit).private async createIdea(ideaName: string, collectionRecordName?: string) { const now = Date.now(); const ideaRecordName = `idea_ck_${uuidv4()}`; const idea: ZenTaskticIdea = { recordType: 'Ideas', recordName: ideaRecordName, fields: { ideaName: { value: ideaName }, realmId: { value: REALM_ASSESS_ID }, // Ideas always start in Assess uniqueId: { value: uuidv4() }, lastModified: { value: now }, ...(collectionRecordName && { collection: { value: { recordName: collectionRecordName, action: 'NONE' } } }), } }; // Mock save: console.log('Mock CloudKit: Creating Idea', idea); return { content: [{ type: 'text', text: `Idea "${ideaName}" captured in Assess realm with ID ${ideaRecordName}.` }] }; }
- src/index.ts:296-305 (schema)Input schema definition for the assess_create_idea tool, specifying required 'ideaName' string and optional 'collectionRecordName'.name: 'assess_create_idea', description: 'Capture a new idea (always starts in Assess realm).', inputSchema: { type: 'object', properties: { ideaName: { type: 'string', description: 'Idea name/details (max 1500 chars)' }, collectionRecordName: { type: 'string', description: 'Optional recordName of the parent collection.' } }, required: ['ideaName'] }
- src/index.ts:672-674 (registration)Tool registration in the CallToolRequestSchema switch statement: validates args and delegates to createIdea handler.this.validateArgs(args, ['ideaName']); return await this.createIdea(args.ideaName, args.collectionRecordName); case 'assess_edit_idea':
- src/index.ts:133-149 (schema)TypeScript interface defining the structure of Idea records for CloudKit/Core Data compatibility, used in the handler.export interface ZenTaskticIdea { recordName?: string; recordType: 'Ideas'; // Note: entity name is 'Ideas' in Core Data fields: { ideaName: { value: string }; // Max 1500 chars, combines original title & body realmId: { value: number }; // Integer 16, default 0 (usually REALM_ASSESS_ID) uniqueId: { value: string }; // UUID lastModified: { value: number }; // Timestamp // References (relationships in Core Data) collection?: { value: CKReference }; // Reference to Collections record realm?: { value: CKReference }; // Reference to Realms record tasks?: { value: CKReference[] }; // Tasks derived from this idea // removed createdAt, use lastModified or CloudKit system creationDate }; }
- src/index.ts:296-306 (registration)Tool registration entry in the ListToolsRequestSchema response array, exposing the tool with name, description, and schema.name: 'assess_create_idea', description: 'Capture a new idea (always starts in Assess realm).', inputSchema: { type: 'object', properties: { ideaName: { type: 'string', description: 'Idea name/details (max 1500 chars)' }, collectionRecordName: { type: 'string', description: 'Optional recordName of the parent collection.' } }, required: ['ideaName'] } },