init

docs/steps/step-05.md

@@ -0,0 +1,67 @@
+# **File: COMMIT_05_LEXICON.md**
+
+## **Commit 5: ATproto Lexicon Definition**
+
+### **Objective**
+
+Define the custom ATproto Lexicon schema for com.ponderants.node. This JSON file
+is the "Source of Truth" schema, defining the exact data shape that will be
+published to the user's PDS.
+
+### **Implementation Specification**
+
+**1\. Create lexicon/com.ponderants.node.json**
+
+Create a file at /lexicon/com.ponderants.node.json. This file defines our
+application's primary data type within the ATproto ecosystem.16
+
+JSON
+
+{  
+ "lexicon": 1,  
+ "id": "com.ponderants.node",  
+ "defs": {  
+ "main": {  
+ "type": "record",  
+ "description": "A Ponderants thought node. It represents a single, captured
+idea, intended to be linked to other nodes to form a 'thought galaxy'.",  
+ "record": {  
+ "type": "object",  
+ "required": \["createdAt", "title", "body"\],  
+ "properties": {  
+ "createdAt": {  
+ "type": "string",  
+ "format": "datetime"  
+ },  
+ "title": {  
+ "type": "string",  
+ "maxLength": 256,  
+ "description": "The title of the thought node."  
+ },  
+ "body": {  
+ "type": "string",  
+ "maxLength": 3000,  
+ "description": "The main content of the thought node, often generated by the AI
+interviewer."  
+ },  
+ "links": {  
+ "type": "array",  
+ "description": "An array of AT-URIs (as strong refs) pointing to other nodes
+this node is linked to.",  
+ "items": {  
+ "type": "string",  
+ "format": "at-uri"  
+ },  
+ "maxLength": 50  
+ }  
+ }  
+ }  
+ }  
+ }  
+}
+
+### **Test Specification**
+
+This commit defines a static schema. It will be implicitly tested by the API in
+Commit 06, which must successfully publish a record conforming to this exact
+shape.