Merge pull request #1 from lnflash/fix/regenerate-spec-remove-banner

fix: regenerate spec.html each build; remove dev notice; unrot spectaql

Author: islandbitcoin

.github/workflows/deploy.yml

@@ -25,7 +25,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '18'
+          node-version: '20'
           cache: 'npm'
 
       - name: Install dependencies

.github/workflows/update-docs.yml

@@ -15,7 +15,7 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@v3
         with:
-          node-version: '16'
+          node-version: '20'
           cache: 'npm'
 
       - name: Install dependencies
@@ -49,5 +49,5 @@ jobs:
           git config --local user.email "action@github.com"
           git config --local user.name "GitHub Action"
           git add schema.graphql public/
-          git commit -m "Update API documentation based on schema changes [skip ci]"
+          git commit -m "Update API documentation based on schema changes"
           git push

docs/index.html

@@ -11,7 +11,7 @@
     "generate-docs": "spectaql spectaql-config.yml",
     "patch-spec": "node src/spec-patch.js",
     "copy-assets": "cp -r src/css public/css && cp -r src/js public/js && cp -r src/images public/images && cp -f src/index.html public/index.html && cp -f src/stylesheets/* public/stylesheets/",
-    "build": "npm run fetch-schema && npm run generate-docs && cp -r docs/* public/ && npm run copy-assets && npm run patch-spec",
+    "build": "npm run fetch-schema && npm run generate-docs && cp -r docs/* public/ && cp docs/index.html public/spec.html && npm run copy-assets && npm run patch-spec",
     "build:versions": "npm run build && node build-versions.js",
     "start": "serve public",
     "dev": "serve public --cors -l 3000"
@@ -31,7 +31,7 @@
     "get-graphql-schema": "^2.1.2",
     "graphql": "^16.11.0",
     "node-fetch": "^2.7.0",
-    "spectaql": "^3.0.4"
+    "spectaql": "^3.0.9"
   },
   "devDependencies": {
     "serve": "^14.2.4"

package-lock.json

@@ -267,9 +267,6 @@ <h2>Endpoints</h2>
     </div>
 
     <div class="content">
-      <div class="notice">
-        <strong>⚠️ Development Notice:</strong> The Flash API is currently under active development. All endpoints, parameters, and responses are subject to change and improvement. This documentation will be updated as the API evolves.
-      </div>
 
       <h1>Flash GraphQL API</h1>
       <p>This API provides access to Flash's Bitcoin and Lightning Network payment services for the Caribbean region.</p>
@@ -454,73 +451,7 @@ <h2 id="error-handling">Error Handling</h2>
     <div class="footer-content">
       <p>&copy; 2024 Flash. All rights reserved.</p>
 
-      <details class="footer-note">
-        <summary>Absolute Zero Method</summary>
-        <div class="footer-note-content">
-          <p>The Flash API documentation implementation uses the Absolute Zero methodology for continuous improvement. This revolutionary approach, based on reinforced self-play reasoning with zero data, ensures our API and its documentation evolve with minimal human intervention.</p>
-
-          <div class="auth-diagram">
-            <img src="images/diagrams/absolute-zero.svg" alt="Absolute Zero Method Diagram" style="max-width: 100%;">
-          </div>
-
-          <h4>Core Principles</h4>
-          <p>The Absolute Zero methodology operates on three fundamental components:</p>
-
-          <ul>
-            <li>
-              <strong>Task Proposer (πpropose):</strong> This component autonomously generates tasks optimized for learning and improvement, creating challenges specifically designed to enhance the system's capabilities.
-            </li>
-            <li>
-              <strong>Environment (e):</strong> Provides verifiable feedback and ground truth validation, ensuring all improvements are measured against reliable metrics without relying on external validation.
-            </li>
-            <li>
-              <strong>Solution Generator (πsolve):</strong> Solves the self-generated tasks and learns from outcomes, continuously enhancing its capabilities through reinforced self-learning.
-            </li>
-          </ul>
-
-          <h4>Implementation Benefits</h4>
-          <p>By implementing the Absolute Zero method in our documentation system, we achieve:</p>
-
-          <ul>
-            <li><strong>Self-Improving Documentation:</strong> The documentation evolves automatically based on usage patterns and identified pain points</li>
-            <li><strong>Zero Training Data Requirements:</strong> No need for extensive manually labeled datasets or examples</li>
-            <li><strong>Continuous Enhancement:</strong> The system perpetually refines itself through reinforced feedback loops</li>
-            <li><strong>Cross-Domain Learning:</strong> Improvements in one area benefit the entire system through knowledge transfer</li>
-          </ul>
-
-          <div class="code-sample" data-language="javascript">
-            <pre>// Absolute Zero implementation pseudocode
-class AbsoluteZeroReasoner {
-  constructor() {
-    this.model = new UnifiedModel();
-    this.metrics = new PerformanceMetrics();
-    this.environment = new VerifiableEnvironment();
-  }
-
-  async improveSystem() {
-    // Task proposal phase
-    const task = this.model.proposeTask();
-
-    // Environment verification
-    const { verifiedTask, groundTruth } =
-      this.environment.validate(task);
-
-    // Solution generation
-    const solution = this.model.solveTask(verifiedTask);
-
-    // Learning from outcomes
-    const feedback = this.metrics.evaluate(solution, groundTruth);
-    await this.model.learn(feedback);
-
-    return feedback.improvements;
-  }
-}</pre>
-          </div>
-
-          <p>For more information on the Absolute Zero methodology, refer to the research paper: <a href="https://arxiv.org/abs/2505.03335" target="_blank">Absolute Zero: Reinforced Self-play Reasoning with Zero Data</a>.</p>
-        </div>
-      </details>
-    </div>
+      </div>
 
     <style>
       .footer-content {