Machine Codexthe source, read as a book ↩ back to the poetry site

archive/

wordclouds/

wordcloud-2026-06-24_16-33-30-200words.html wordcloud-2026-06-24_17-07-13-200words.html wordcloud-2026-06-24_17-12-16-200words.html wordcloud-2026-06-26_14-27-50-7082words.html wordcloud-2026-06-29_19-32-52-7082words.html wordcloud-2026-08-08_10-25-57-3words.html

first-published-wordcloud.html

demos/

1-demo.sh 2-demo.sh 3-demo.sh 4-demo.lua 5-demo.lua 6-demo.lua generate-site.lua

docs/

Your URL Is Your State.html centroids-for-hope-cards.md config-reference.md data-flow-architecture.md delta-guide.md design-audit-report.md effil-usage-patterns.md effil-vs-compute-shader-feasibility.md issue-consolidation-summary.md phase-2-completion-summary.md project-overview.md research-2d-embeddings.md research-tuple-embeddings.md roadmap.md similarity-algorithm-research.md similarity-algorithms-research-report.md similarity-matrix-generation-guide.md table-of-contents.md words-pdf-integration.md

issues/

completed/

phase-8/

8-014-configurable-asset-paths.md 8-014-generate-numeric-similarity-index.md 8-018-fix-embedding-directory-case-inconsistency.md 8-030-add-chronological-anchor-links.md

phase-9/

9-001a-setup-vulkan-development-environment.md 9-001b-implement-vulkan-compute-wrapper.md 9-001c-create-cosine-distance-shader.md 9-001d-implement-diversity-sequence-gpu-algorithm.md 9-001e-create-lua-c-integration.md 9-001g-batch-parallel-diversity-sequences.md 9-002a-design-similarity-matrix-shader.md 9-003a-remove-unnecessary-centroid-division.md 9-005b-url-switching-helper-script.md

1-001-setup-poem-extraction-system.md 1-002-configure-ollama-embedding-service.md 1-003-implement-data-validation-pipeline.md 1-004-create-project-utilities-and-scripts.md 1-005-standardize-ollama-port-configuration.md 1-006-morning-breakfast-dishes-cleanup.md 1-010-embeddinggemma-model-compatibility-issue.md 1-011-ollama-embedding-model-testing-documentation.md 10-003-consolidate-config-files-into-single-source.md 10-003a-initial-config-file-consolidation.md 10-003b-external-files-syncing-centralization.md 10-005-implement-cli-flag-support-for-all-functionality.md 10-006-identify-checkbox-conversion-opportunities.md 10-008-implement-multiline-command-wrapping.md 10-011-implement-pipeline-data-validation-utility.md 10-012-fix-pipeline-validation-counting-bugs.md 10-014-complete-config-migration-from-input-sources-json.md 10-015-unified-input-sources-config.md 10-015a-migrate-image-manager-to-sources-loader.md 10-016-tui-per-stage-regeneration-options.md 10-017-multi-ollama-server-configuration.md 10-018-animated-command-option-transitions.md 10-019-document-config-structure-and-field-usage.md 10-021-whitespace-preserving-word-wrap.md 10-022-fix-empty-embeddings-validation.md 10-023-fix-image-manager-shell-escaping-and-duplicates.md 10-024-force-flag-should-clear-output-directories.md 10-025-diversity-cache-includes-anchor-poem.md 10-026-merge-sources-and-external-files-config.md 10-027-fix-golden-poem-trailing-whitespace-detection.md 10-028-lower-pipeline-process-priority-for-ui-responsiveness.md 10-030-image-source-position-randomization.md 10-032-fix-shared-flag-prefix-collision-in-tui-sync.md 10-033-fix-html-generation-memory-exhaustion.md 10-034-lazy-loading-orchestrator-for-parallel-html.md 10-036-fix-word-page-chronological-links.md 10-037-blank-fediverse-boost-content.md 10-038-separate-fediverse-boost-id-iterator.md 10-039-render-external-boost-urls-as-links.md 10-040-boost-styling-inconsistency-across-page-types.md 10-041-malformed-boost-box-alignment.md 10-042a-gallery-pages.md 10-051-persistent-stage-timing-ring-buffer.md 10-053-exclude-content-and-strip-from-input.md 10-054-move-regenerable-caches-to-ram.md 10-059-split-wordcloud-into-its-own-stage-and-retire-numeric-index.md 11-005-externalize-explore-page-copy-into-editable-templates.md 13-001-extract-bluesky-car-archive-data.md 16-006-chronological-back-navigation.md 16-010-monospace-font-enforcement.md 16-010-wordcloud-display-colors-and-url-fixes.md 2-003-design-similarity-engine-architecture.md 2-004-implement-incremental-embedding-caching-system.md 2-005-always-retry-failed-embedding-entries.md 2-006-implement-network-error-timeout-termination.md 2-007-implement-cache-flush-option.md 2-008-implement-per-model-embedding-storage.md 2-009-fix-progress-bar-and-graceful-termination.md 2-010-implement-similarity-matrix-invalidation-on-embedding-changes.md 2-011-implement-per-model-similarity-matrices.md 2-012-implement-parallel-similarity-engine-with-individual-files.md 2-013-fix-effil-threading-library-compatibility.md 2-014-improve-script-execution-directory-handling.md 2-015-implement-local-project-file-server.md 3-001-implement-html-generation-system.md 3-001a-create-html-template-system.md 3-001b-implement-url-structure-design.md 3-001c-build-similarity-navigation.md 3-001d-responsive-design-implementation.md 3-005-implement-enhanced-fediverse-golden-poems-prioritization.md 3-005a-implement-golden-poem-similarity-bonus.md 3-005b-create-golden-poem-visual-indicators.md 3-005c-build-golden-poem-collection-pages.md 3-006-remove-javascript-dependencies-from-static-html.md 3-009-generate-embedding-based-similarity-and-diversity-lists.md 4-002-implement-per-model-similarity-matrix-generation.md 4-003-fix-character-counting-methodology-for-fediverse-golden-poems.md 4-004-verify-and-resolve-cross-category-id-mapping.md 5-002-implement-per-model-similarity-matrix-generation.md 5-007-replace-random-browsing-with-static-diverse-selection.md 5-010a-create-modular-similarity-calculator.md 5-010b-implement-validation-framework.md 5-010c-generate-validation-reports.md 5-011a-research-similarity-algorithms.md 5-013-implement-flat-html-compiled-txt-recreation.md 5-014-CONSOLIDATED-simple-navigation-and-discovery.md 5-014-implement-similarity-link-navigation.md 5-015-refactor-golden-poem-system-remove-prioritization.md 5-016-implement-full-similarity-matrix-storage.md 5-019-audit-tickets-for-design-consistency.md 5-023-improve-flat-html-formatting-and-content-warnings.md 5-025-optimize-similarity-matrix-to-triangular-storage.md 6-017-implement-image-integration-system.md 6-025-implement-true-chronological-sorting-by-post-dates.md 6-026-integrate-and-modernize-scripts-directory.md 6-026a-modernize-script-path-handling.md 6-026b-adapt-output-format-for-html-generation.md 6-026c-integrate-extraction-pipeline.md 6-026d-implement-zip-archive-access.md 6-027-implement-fediverse-privacy-and-boost-handling.md 6-027a-implement-privacy-aware-reply-anonymization.md 6-027b-add-boost-announce-activity-extraction.md 6-028-replace-css-with-hard-coded-html-generation.md 6-029-remove-reply-syntax-from-embedding-content.md 6-030-resolve-username-variation-anonymization-inconsistency.md 6-031-configurable-poem-exclusion-filter.md 6-032-fix-br-tag-variants-in-html-cleaning.md 7-001-fix-run-sh-warnings-and-errors.md 7-002-clean-up-run-sh-output.md 7-003-cleanup-run-sh-output-formatting.md 7-004-add-ignored-archives-config.md 7-005-select-most-recent-archive-per-type.md 7-006-implement-expanded-colorization.md 8-003-remove-remaining-css-from-html-generation.md 8-004-implement-embedding-validation-and-empty-poem-handling.md 8-005-integrate-images-into-html-output.md 8-006-fix-golden-poem-box-drawing-format.md 8-007-add-navigation-link-box-borders.md 8-008-implement-configurable-centroid-embedding-system.md 8-009-project-cleanup-and-organization.md 8-010-fix-note-filenames-in-html.md 8-011-scrape-fediverse-boost-content.md 8-012-implement-paginated-similarity-chapters.md 8-013-implement-txt-export-functionality.md 8-015-implement-zip-extraction-freshness-check.md 8-016-validate-poem-representation-in-pagination.md 8-017-preserve-generated-files-during-sync.md 8-019-implement-unique-poem-index-system.md 8-021-fix-embedding-progress-counter-overcounting.md 8-022-add-pagination-cli-flags-to-html-generation.md 8-023-fix-similarity-matrix-function-call.md 8-024-improve-similarity-matrix-progress-display.md 8-025-fix-diversity-cache-validation-order.md 8-026-add-diversity-computation-progress-display.md 8-027-implement-extendable-diversity-cache.md 8-028-clean-output-directory.md 8-029-consolidate-similarity-matrix-functions.md 8-032-fix-similarity-matrix-force-flag-and-filename-inconsistency.md 8-033-fix-run-sh-to-use-parallel-similarity-generation.md 8-035-colorize-nav-boxes-with-progress-bar.md 8-036-add-poem-identification-to-ranking-headers.md 8-037-fix-similar-different-box-alignment.md 8-038-center-poem-containers-on-page.md 8-039-move-chronological-files-to-subdirectory.md 8-040-add-images-to-similar-different-pages.md 8-041-escape-html-in-poem-content.md 8-042-sync-images-from-configurable-directories.md 8-043-generate-semantic-word-cloud-page.md 8-043b-integrate-wordcloud-into-pipeline.md 8-044-golden-poem-detection-and-formatting-parity.md 8-045-timeline-based-progress-bar-calculation.md 8-046-create-menu-navigation-page.md 8-047-implement-dark-mode-always-on.md 8-048-flatten-media-directory-for-deployment.md 8-049-implement-audio-and-video-playback.md 8-050-enhance-wordcloud-semantic-similarity-pages.md 8-050a-compute-semantic-color-for-wordcloud-words.md 8-050b-color-contextualized-similarity-ranking.md 8-050c-apply-word-color-to-wordpage-progress-bars.md 8-050d-configurable-poems-per-wordcloud-page.md 8-050e-centroid-chronological-link-for-word-pages.md 8-051-order-poem-index-categories-by-ascending-count.md 8-052-normalize-vertical-bar-characters-in-html-output.md 8-053-add-image-title-attribute-and-fix-alt-text-fallback.md 8-054-investigate-messages-image-png-poems.md 8-055-fix-golden-poem-formatting-on-similar-different-pages.md 8-056-preserve-whitespace-in-poem-rendering.md 8-057-boost-visual-formatting.md 8-059-unify-tmp-directories-into-symlinked-ramfs.md 9-005-integrate-gpu-diversity-cache-into-pipeline.md 9-006-poem-box-format-validator.md 9-010-fix-image-repetition-in-associated-posts.md 9-011-display-content-warnings-from-activitypub.md 9-012-use-archive-alt-text-for-images.md

000-next-issue-to-do.md

1-progress.md 10-001-integrate-tui-into-phase-demo.md 10-002-integrate-tui-into-generate-embeddings.md 10-009-DESIGN.md 10-009-optimize-incremental-centroid-updates-for-dataset-expansion.md 10-010-integrate-test-suites-into-development-pipeline.md 10-013-implement-tui-config-editor.md 10-029-tui-ollama-server-selector.md 10-031-embedding-model-evaluation-framework.md 10-035-parallelize-word-page-generation.md 10-042-integrate-standalone-images-into-site.md 10-042b-chronological-interleaving.md 10-042c-filename-embeddings.md 10-042d-gallery-chronological-image-list.md 10-043-dual-checkbox-pipeline-stage-selection.md 10-044-integrate-conversation-starters-as-unified-source.md 10-045-integrate-android-phone-pictures-as-source.md 10-046-interleave-poems-with-llm-transcripts.md 10-048-codebase-consolidation-sweep.md 10-049-replace-ollama-with-llamacpp.md 10-050-batched-embedding-generation-with-long-text-chunking.md 10-052-self-hosted-source-browser.md 10-055-source-browser-rendering-and-navigation.md 10-056-phase-demos-compute-stats-and-show-real-features.md 10-057-pipeline-memory-budgeter-and-similarity-cache-reduction.md 10-058-deterministic-seeded-randomization.md 10-060-retire-untethered-dead-code.md 10-062-chronological-image-viewer-reverse-and-pagination.md 10-063-view-archived-html-pages-in-source-browser.md 10-064-reverse-poem-ordering-flag.md 10-065-require-explicit-cli-values-no-defaults.md 10-066-word-pages-are-two-thirds-of-the-site.md 10-067-split-source-by-pipeline-stage.md 10-progress.md 11-001-implement-journey-style-similar-navigation.md 11-002-implement-maze-based-exploration-system.md 11-002a-build-dimension-extreme-index.md 11-002b-implement-similarity-filtered-choice-selection.md 11-002c-generate-maze-html-pages.md 11-002d-add-special-room-features.md 11-003-maze-pipeline-integration.md 11-004-rewrite-explore-page-and-add-deeper-math-page.md 11-006-wordcloud-splash-editable-gateway-page.md 11-007-wordcloud-word-strip-on-similar-different-pages.md 11-008-writing-cadence-histograms-on-the-explore-page.md 11-009-pure-black-backgrounds-for-oled.md 11-progress.md 12-001-implement-neural-navigation-llm.md 12-002-investigate-dual-axis-similarity-theme-and-style.md 12-progress.md 13-001-research-and-implement-tts-engine.md 13-001a-research-tts-options.md 13-001b-design-tts-integration-architecture.md 13-001c-implement-tts-integration.md 13-002-generate-tts-hypnotic-trance-from-wordcloud-flopsopoly.md 13-002a-build-frequency-weighted-word-pool.md 13-002b-implement-centroid-expansion-ordering.md 13-002c-generate-per-word-audio-cache.md 13-002d-assemble-trance-track-and-manifest.md 13-003-generate-stable-diffusion-visuals-from-flopsopoly.md 13-003a-implement-diameter-context-window-and-prompt-composition.md 13-003b-implement-stable-diffusion-api-integration.md 13-003c-implement-single-pass-image-generation-pipeline.md 13-003d-implement-multi-pass-refinement-mode.md 13-004-assemble-video-from-tts-audio-and-generated-images.md 13-004a-implement-manifest-parsing-and-concat-file-generation.md 13-004b-implement-ffmpeg-video-assembly.md 13-004c-implement-transition-effects.md 13-progress.md 14-001-book-tapestry-navigation-system.md 14-progress.md 15-001-chromatic-text-encoding-system.md 15-progress.md 16-001-termux-lua-server-implementation.md 16-002-native-android-app-implementation.md 16-003-network-file-type-integration.md 16-004-https-self-signed-certificates.md 16-005-trust-warning-intermediate-page.md 16-007-file-scanning-metadata-extraction.md 16-008-torrent-file-generation.md 16-009-webtorrent-in-browser-streaming.md 16-progress.md 17-001-poem-style-transfer-dropdown-interface.md 17-progress.md 2-progress.md 3-progress.md 4-progress.md 5-024-implement-multi-algorithm-similarity-selection-system.md 5-026-optimize-chronological-html-generation-performance.md 5-progress.md 6-012-DESIGN.md 6-012-PHASE1-COMPLETE.md 6-012-implement-words-pdf-styled-export-system.md 6-013-investigate-semantic-color-distribution-imbalance.md 6-033-enhance-embedding-content-preprocessing.md 6-progress.md 7-progress.md 8-001-integrate-complete-html-generation-into-pipeline.md 8-002-implement-multithreaded-html-generation.md 8-020-hybrid-pagination-strategy.md 8-031-convert-between-similarity-matrix-formats.md 8-034-refactor-to-triangular-individual-files-only.md 8-058-eliminate-main-thread-worker-code-duplication.md 8-progress.md 9-001-implement-vulkan-compute-infrastructure.md 9-001f-remove-effil-dependency.md 9-001f1-implement-pthreads-html-generation.md 9-002-port-similarity-matrix-to-vulkan.md 9-002b-validate-gpu-similarity-implementation.md 9-002c-parallelize-similarity-file-writing.md 9-003-optimize-centroid-calculation-and-parallelization.md 9-004-gpu-accelerate-maze-algorithm.md 9-007-c-shared-memory-for-html-generation.md 9-008-streaming-html-generation-with-progress.md 9-009-html-rendering-and-performance-fixes.md 9-013-image-post-similar-different-pages.md 9-014-tile-diversity-inner-loop-for-cache-locality.md 9-progress.md CRITICAL-PATH-DIFFERENT.md CRITICAL-PATH-SIMILAR.md ensure-hard-drive-integrity.md

libs/

html-threaded/

include/

lua/

src/

Makefile test.lua

vulkan-compute/

include/

vk_compute.h vk_diversity.h vk_similarity.h

lua/

test_ffi.lua vk_compute.lua vk_similarity.lua

src/

vk_compute.c vk_diversity.c vk_similarity.c

Makefile test-batch-full.lua test-ffi.sh test_buffers.c test_cosine.c test_diversity_simple.c test_init.c test_pipeline.c

config-loader.lua dkjson.lua embed-chunking-test.lua exclusion-filter.lua external-sync.lua fuzzy-computing-batch-test.lua fuzzy-computing.lua hope-card-formatter-test.lua hope-card-formatter.lua inference-server-config.lua json.lua markdown-test.lua markdown.info.md markdown.lua mastodon-typed-text-test.lua mastodon-typed-text.info.md mastodon-typed-text.lua memory-budgeter.info.md memory-budgeter.lua memory-budgeter.test.lua model-evaluator.info.md model-evaluator.lua neocities-api.lua neocities-sync.lua neocities-sync.test.lua pipeline-validator.lua progress-display.lua runtime-overrides.lua sources-loader.lua text-chunking-test.lua text-chunking.info.md text-chunking.lua text-formatter.lua triangular-similarity-access.lua utils.lua

notes/

HTML-file-format.png boost-post-image-style.png development-cadence-aug-7-through-9-2026 golden-poem-example next-steps ooouuuaaeeem vision

scripts/

build-deps.sh build-download-zip cache-dir check-inline-lua-quotes compile deploy-to-neocities ensure-tmp-symlink evaluate-embedding-models export-hope-cards extract-bluesky-data extract-fediverse.lua extract-messages.lua extract-notes.lua fsync-logger generate-corner-box-demo generate-diversity-cache.sh generate-hope-card-pdf generate-html-parallel generate-html-pthreads generate-similarity-rankings-cache install-deps.sh list-inference-choices migrate-to-triangular-files.lua precompute-diversity-sequences-gpu run-fediverse run-messages run-notes scrape-boost-content.lua stage-timing.sh stage-timing.test.sh start-llamacpp-server.sh start-ollama-cuda.sh strip-excluded sync-external-files sync-page-templates test-diversity-quick test-effil-simple test-html-generation test-model-propagation.sh test-seed-reproducibility.sh update update-words validate-diversity-cache validate-pipeline-data validate-poem-box-format validate-poem-representation write-run-overrides zip-extractor.lua

src/

html-generator/

embedding-list-generator.lua golden-poem-indicators.lua test-embedding-list-generator.lua url-manager.lua

augment-embeddings-with-images.lua augment-embeddings-with-images.test.lua boost-bars.info.md boost-bars.lua boost-bars.test.lua centroid-generator.lua centroid-html-generator.lua diversity-chaining.lua embedding-server-manager.lua flat-html-generator.chronological-links.test.lua flat-html-generator.download-links.test.lua flat-html-generator.lua generate-gallery-pages.lua generate-source-browser.info.md generate-source-browser.lua generate-word-pages.lua hubness-experiment.lua image-manager.lua image-pseudo-embeddings.info.md image-pseudo-embeddings.lua image-pseudo-embeddings.test.lua image-render-test.lua image-render.lua image-render.test.lua main.lua model-comparison.lua page-template.info.md page-template.lua page-template.test.lua poem-bars.lua poem-bars.test.lua poem-extractor.lua poem-validator.lua regenerate-clean-site.lua report-generator.lua run-validation-with-reports.lua run-validation.lua semantic-color-calculator.lua similarity-calculator.lua similarity-engine.lua test-diversity-chaining.lua test-report-generator.lua test-similarity-calculator.lua test-validation-engine.lua triangular-similarity-matrix.lua validation-engine.lua wordcloud-generator.lua

PHASE-1-COMPLETION-SUMMARY.md SESSION-SUMMARY-2026-01-12.md TODO-guide-me-tutorial-page.md compiled.txt config.lua generate-embeddings.sh phase-demo.sh run.sh

output/ → every generated page ⬇ download everything (site + source)

issues/000-next-issue-to-do.md

-- Quick Notes --

(Empty - add next quick ideas here)

-- Moved to Issue Files --

conversation starters → 10-044-integrate-conversation-starters-as-unified-source.md