Skip to content

Align World Knowledge with CHIM/ALMSIVI Oghma parity - #69

Merged
RANGROO merged 23 commits into
unstablefrom
codex/worldknowledge-parity-v1
Aug 15, 2026
Merged

Align World Knowledge with CHIM/ALMSIVI Oghma parity#69
RANGROO merged 23 commits into
unstablefrom
codex/worldknowledge-parity-v1

Conversation

@RANGROO

@RANGROO RANGROO commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Aligns Fallout 3/New Vegas/TTW World Knowledge with the CHIM and ALMSIVI Oghma contract.
  • Uses the shared eight-field article shape, canonical topics and aliases, flat advanced/basic classes, negative-first access, grounded retrieval, forced context, bounded fallback, and immutable catalog versions.
  • Keeps Fallout-specific factions, regions, species, identities, and catalog content independent.
  • The Python catalog-generation toolchain is intentionally excluded; the PR retains only the finalized catalog, integrity/provenance data, runtime code, and tests.
  • Aligns the World Knowledge editor and audit pages with Herika's compact dark/orange UI while retaining DIALECTIC terminology and typography.

Final parity

  • common is an article-only public-basic marker and is never assigned to NPCs.
  • Persisted NPC tags now contain only frozen Fallout roles, specialist domains, factions, races, regions, and reviewed localities.
  • NPC names are no longer stored as profile knowledge classes. The NPC's own subject is inferred only during the in-memory access check for self-knowledge.
  • Runtime access strips legacy blocked and common policy markers before evaluating NPC knowledge.
  • knowall is never inferred for factory biographies but remains available as a deliberate user override.
  • Public basic access works with no NPC knowledge tags; negative exclusions still deny first.
  • Connector fallback is opt-in by default.
  • Article tags only rank already grounded topics.
  • Unresolved referential follow-ups can carry one prior grounded topic, scoped to the current NPC.

NPC tag audit

  • Factory NPC rows: 1,250
  • Valid assignments: 4,439
  • Persisted self-name classes: 0
  • Factory policy-marker assignments: 0
  • Tags outside the frozen vocabulary: 0
  • Empty profiles: 15, retained intentionally when no evidence-backed class exists
  • Migration worldknowledge_npc_class_cleanup version 20260814005 reprojects recognized factory seeds and removes exact persisted NPC subjects from factory, custom, active, and history records while preserving every other user-authored tag.

Catalog

  • Factory articles: 1,169
  • Hidden/blocked basic tiers: 93
  • Location articles: 451
  • Catalog version: parity-v1.8-2026-08-14
  • Catalog SHA-256: 668643b70ebc932603e730a754d972733a1c0c380c8e4ae3e4c67199535e22f1
  • Catalog activation now fails closed unless the installed factory-row count matches the manifest.
  • Migration worldknowledge_catalog_integrity version 20260814006 automatically repairs incomplete installations before activation.

Factory article editing

  • Factory rows now use the same Edit action as custom rows.
  • Saving a factory edit creates a custom override for the same canonical topic and leaves the shipped row unchanged.
  • The modal explains the override, locks the factory topic, hides Delete until a custom article exists, and labels the save action Save as Custom Article.
  • The server determines factory/custom ownership from the effective database row rather than trusting the browser.
  • Focused PostgreSQL checks passed: 2 tests and 18 assertions covering custom-over-factory preservation and factory reprovisioning.

Validation

  • Forced-context/access/retrieval suite: 23 tests, 111 assertions passed.
  • Dataset contract: 1 test, 16,657 assertions passed.
  • Factory reprovision and custom-data preservation: 1 test, 8 assertions passed.
  • Catalog integrity regression: focused 2 tests, 12 assertions passed.
  • Canonicalizer check: 1,169 articles and zero pending article, source, expansion, or NPC changes.
  • NPC projection audit: 1,250 rows, 4,439 valid assignments, zero self names, zero policy markers, and zero invalid classes.
  • Live PostgreSQL verification now reports 1,169 installed and 1,169 effective factory articles for active v1.8.
  • Migration 20260814006 is applied locally; an incomplete catalog cannot displace the current active catalog.
  • Changed PHP lint and git diff --check passed.

Companion parity PRs

Local deployment

  • Commit 6f54ef5b5f7d9ba80cbb430e8e6692c8f22f1024 is deployed to /var/www/html/DialecticServer.
  • Migration worldknowledge_catalog_integrity version 20260814006 repaired the active local catalog from 151 to 1,169 effective factory articles.
  • HTTP health returned 200 and Apache voice-directory write access passed.
  • The latest factory-edit and referential follow-up commits are not deployed locally.
  • Local configuration, logs, caches, backups, uploads, and voice samples remain preserved.

Limits

  • No new in-game Fallout conversation was run.
  • The two focused factory/custom catalog regressions passed. The broader legacy World Knowledge test class was stopped after entering an unrelated mocked dialogue/TTS path.

Shared retrieval priority update

  • Order: conversation -> exact location -> worldspace/region -> race -> faction.
  • One shared result budget: default 3, configurable from 1 through 5.
  • Topic extraction remains default 1 and maximum 3.
  • Conversation owns duplicates. Forced context only fills unused slots, and a full conversation budget skips all forced database lookups.
  • Validation: 23 focused tests and 111 assertions passed, including referential follow-up coverage.
  • Commit 6f54ef5b5f7d9ba80cbb430e8e6692c8f22f1024 is deployed to /var/www/html/DialecticServer; changed runtime hashes match, Apache write access passed, and HTTP returned 200.

Current dataset lifecycle

  • Treats the checked-in Fallout package as the sole factory source of truth.
  • Validates checksums before one transactional factory replacement; custom articles and canonical overrides are preserved.
  • Keeps one current integrity record and removes catalog activation/version-history controls. Rollback is Git revert plus redeploy.
  • Local WSL verification: parity-v1.8-2026-08-14, 1,169 factory articles, database in sync.

Fixed catalog pagination

  • The World Knowledge catalog now loads exactly 500 articles per page.
  • The former 25/50/100 selector and per_page URL behavior were removed.
  • Existing filters, page clamping, result ranges, and Previous/Next navigation are preserved.
  • Validation: PHP lint, static pagination checks, and diff checks passed.
  • Not deployed; browser and in-game verification remain outstanding.

@RANGROO RANGROO changed the title Upgrade World Knowledge to parity v1 Upgrade World Knowledge to parity v1 with 1,221 articles Aug 13, 2026
@RANGROO RANGROO changed the title Upgrade World Knowledge to parity v1 with 1,221 articles Upgrade World Knowledge to parity v1.2 with audited access gating Aug 14, 2026
@RANGROO RANGROO changed the title Upgrade World Knowledge to parity v1.2 with audited access gating Upgrade World Knowledge to parity v1.3 with canonical access tags Aug 14, 2026
@RANGROO RANGROO changed the title Upgrade World Knowledge to parity v1.3 with canonical access tags Align World Knowledge with CHIM/ALMSIVI Oghma parity Aug 14, 2026
@RANGROO
RANGROO marked this pull request as ready for review August 15, 2026 22:25
@RANGROO
RANGROO merged commit 0972ef6 into unstable Aug 15, 2026
@RANGROO
RANGROO deleted the codex/worldknowledge-parity-v1 branch August 15, 2026 22:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant