AI Wikis / Agentic Web

NeuralWikis.com Publish Plan

Report summary

Do not upload the outer NeuralWikis.com-Publish folder as the app root. The app root should directly contain passenger wsgi.py, app.py, controllers, core, models, templates, and static.

Status
Research archive item
Category
AI Wikis / Agentic Web
Length
277 words
Reading time
2 minutes
Report type
strategy

Key topics

  • AI Wikis / Agentic Web
  • AI Wikis
  • Agentic Web
  • AI
  • Python
  • MySQL
  • Runtime
  • Audit
  • Architecture

Research provenance

Archive status
Research archive item
Content identity
sha256:10635b08250318de59d7e2bb8bfbaf4ca5cf45aeab0edd24ee7aedb9a9c6af8d

For citation, use the report title and canonical URL. Archival presence does not establish authorship or promote report statements into portfolio evidence.

This page renders the archived Markdown as safe, formatted HTML. It is background research and does not become a portfolio claim without evidence review.

Full report

On this page

Generated: 2026-05-25 Source repository: E:\NeuralWikis.com

What To Upload

Upload the contents of:

E:\NeuralWikis.com-Publish\deploy-root\

to the configured cPanel Passenger Python application root.

Do not upload the outer NeuralWikis.com-Publish folder as the app root. The app root should directly contain passenger_wsgi.py, app.py, controllers, core, models, templates, and static.

Bundle Layout

E:\NeuralWikis.com-Publish\
  deploy-root\       # cPanel/Passenger runtime upload set.
  project-record\    # architecture docs, active memory, exports, instructions.
  verification\      # tests for pre/post-publish verification.
  PUBLISH_PLAN.md    # this file.

Required Environment

Configure these in cPanel or the hosting environment:

  • DB_HOST
  • DB_USER
  • DB_PASS
  • DB_NAME

Install dependency from requirements.txt:

PyMySQL>=0.9.3

Pre-Publish Checks Run Locally

  • python -m unittest discover -s tests -> 49 OK
  • python -m pytest services\api\tests -> 7 OK
  • npm.cmd --workspace apps/web run test -- --run -> 5 OK
  • npm.cmd --workspace apps/web run build -> 16 routes generated
  • python -m json.tool memory\exports\manifest.json -> OK
  • targeted python -m py_compile -> OK
  • WSGI HTTP smoke routes -> canonical routes 200, removed legacy routes 404

Publish Steps

  1. Back up the current deployed application root.
  2. Upload only deploy-root\ contents to the cPanel app root.
  3. Confirm passenger_wsgi.py exposes Passenger callable application.
  4. Confirm dependencies from requirements.txt.
  5. Configure database environment variables.
  6. Restart the Python app in cPanel.
  7. Smoke test canonical and removed routes.
  8. If /exchange still returns 404, request /api/runtime-diagnostics and confirm the live route table includes /exchange.

Smoke Checks

Expected HTTP 200:

  • /
  • /exchange
  • /api/exchange
  • /api/adoption-preview
  • /api/adoption-events
  • /api/schemas
  • /api/health
  • /api/runtime-diagnostics
  • /ai-manifest.json
  • /llms.txt

Expected HTTP 404:

  • /workspace
  • /sandbox
  • /api/platform
  • /api/merge-preview

Rollback

If any critical smoke check fails:

  1. Restore the previous app root backup.
  2. Restart Passenger.
  3. Re-run smoke checks.
  4. Record the rollback in active memory.

Exclusions

The deploy root intentionally excludes generated Python caches, local logs, screenshots, memory/raw, memory/wiki, active dropped-file intake buckets, monorepo node_modules, and unreviewed handoff files.