Skip to content

Governed Monologue Publication

NUR does not replace a public monologue automatically. QLens detects research changes, marks linked publications stale, and can regenerate a review draft when policy allows. A human must approve and explicitly publish the draft.

Lifecycle

draft → needs_review → approved → published

Alternative states are rejected, superseded, and archived.

1. Create a publication contract

qlens publication new \
  --title "বি কী সম্পর্ক প্রকাশ করে?" \
  --space RSP-000001 \
  --source QST-000001 \
  --source EVD-000001 \
  --source RSN-000001 \
  --source UND-000001 \
  --format monologue \
  --language bn \
  --audience general \
  --voice first_person \
  --auto-generate

--auto-generate allows publication sync to regenerate a stale draft. It never enables automatic public publishing.

2. Generate the first draft

qlens publication generate PUB-000001 --actor Mamun

Draft revisions are retained under:

generated/publications/drafts/pub-000001/v1.md
generated/publications/drafts/pub-000001/v2.md

3. Inspect state and staleness

qlens publication status PUB-000001

Important fields:

  • publication_state: current governance state;
  • stale: whether source research changed after generation;
  • needs_review: whether human review is pending;
  • publishable: approved, current, and ready for explicit publishing;
  • draft_path: current review draft;
  • published_path: current NUR-visible public artifact.

4. Regenerate policy-enabled drafts

qlens publication sync --actor qlens-policy

The command scans every publication. A publication with auto_generate: true is regenerated when it has never been generated or its source digest is stale. Other stale publications are reported but not changed.

5. Review the draft

Approve:

qlens publication review PUB-000001 \
  --decision approve \
  --reviewer Mamun \
  --note "Research sources and narrative checked" \
  --signature "mamun-approved-v1"

Reject:

qlens publication review PUB-000001 \
  --decision reject \
  --reviewer Mamun \
  --note "The narrative overstates the current understanding"

When require_signature is enabled, approval without --signature fails.

6. Publish explicitly

qlens publication publish PUB-000001 \
  --publisher Mamun \
  --signature "mamun-published-v1"

Publishing requires an approved, non-stale draft. The command copies the reviewed artifact to:

docs/publications/pub-000001.md

That file becomes publishable by MkDocs/NUR. QLens refuses automatic public publishing even if a malformed policy attempts to enable it.

7. Archive a publication

qlens publication archive PUB-000001 \
  --actor Mamun \
  --note "Replaced by a new publication contract"

Archived publications cannot be regenerated.

Research-change behavior

When any linked question, evidence, reasoning, or current-understanding object changes:

  1. the current source digest differs from the stored digest;
  2. publication status reports stale: true;
  3. NUR displays Regenerate draft as the required action;
  4. publishing is blocked;
  5. a new draft must be generated and reviewed;
  6. the previously published artifact remains unchanged until explicit publication.

NUR behavior

Run:

qlens render

The Research Publications page shows publication state, staleness, required action, draft path, and published path. NUR is a static derived interface, so it displays the correct governance command instead of silently performing writes.