Skip to content

feat(docs): documentation intelligence layer — tickets, ARM, doc feedback, transcript→KB - #54

Merged
mdheller merged 1 commit into
mainfrom
feat/transcript-kb-extract
Aug 4, 2026
Merged

feat(docs): documentation intelligence layer — tickets, ARM, doc feedback, transcript→KB#54
mdheller merged 1 commit into
mainfrom
feat/transcript-kb-extract

Conversation

@mdheller

@mdheller mdheller commented Aug 4, 2026

Copy link
Copy Markdown

Summary

Closes the full documentation intelligence loop: chat → feedback → FAQ distillation → ARM synthesis → support tickets — all surfaced from TurtleTerm shell and via !qes in Matrix.

New binaries

turtle-ticket — sovereign support ticket / case record system

tko "k3s tunnel drops on VPN change" --priority p1   # open
tkl --open                                            # list open
tks "k3s tunnel"                                      # search
tkn abc12345 "reproduced with wg0 + cloudshell"       # comment
tkc abc12345 --resolution "fixed in #1409"            # close
ticket summary                                        # counts by status/priority

Stores in ~/.local/state/sourceos/tickets/tickets.jsonl + events.jsonl. No external deps.

turtle-doc-feedback — feedback receipts → Noetica FAQ distillation

docfb ADR-031 👍                                       # thumbs-up
docfb ADR-031 ❓ "What happens when the tunnel drops?" # question
docfaq ADR-031                                        # show derived FAQ stubs
docdistill                                            # run Noetica distillation

Groups questions/negatives by doc_ref, runs Noetica over them, writes FAQ stubs.

turtle-arm-generate — Architecture Reference Manual from ADRs

arm-gen                          # read all ADR-*.md → ~/.local/state/sourceos/arm/ARM.md
arm-show --section "ADR-031"    # print a section
arm-search "tunnel"              # grep ARM for context

Matrix surface (companion PRs pending merge of dispatch.py)

  • !qes ticket open/list/close/comment/search/summary
  • !qes doc feedback/list/faq/distill
  • !qes arm generate/show/search/status
  • !qes transcript extract/list/commit (transcript → KB claims)

Full doc intelligence loop

Matrix chat → !qes → reply in thread
         ↓
   turtle-transcript-extract → KB claims (systems-learning-loops/kb/claims/)
         ↓
   docfb ADR-031 ❓ "question" → doc-feedback/receipts.jsonl
         ↓
   docdistill → Noetica → doc-feedback/faq-stubs.jsonl
         ↓
   arm-gen → synthesizes ADRs + FAQ context → ARM.md

…back, KB distillation

turtle-ticket — sovereign support ticket / case record system:
  - open/list/show/comment/close/reopen/tag/search/summary/status
  - JSONL storage at ~/.local/state/sourceos/tickets/
  - Shell: tko/tkl/tks/tkc/tkn shorthands + ticket() full access
  - Palette: 6 ticket entries (open, list, search, close, comment, summary)

turtle-doc-feedback — doc feedback receipts → FAQ distillation:
  - submit <doc_ref> <sentiment> [comment] (up/down/neutral/question)
  - list/faq/distill/status subcommands
  - JSONL receipts + FAQ stubs under ~/.local/state/sourceos/doc-feedback/
  - distill: groups by doc_ref → Noetica → FAQ stubs
  - Shell: docfb/docfaq/docdistill with emoji shortcuts (👍👎❓)

turtle-arm-generate — Architecture Reference Manual synthesis:
  - generate: reads all ADR-*.md → consolidated ARM.md + index.json
  - show/search/watch/status subcommands
  - Default ADR dir: ~/dev/prophet-platform/adr/
  - Shell: arm-gen/arm-show/arm-search
  - Palette: 3 ARM entries

All three binaries + shell functions + palette entries. Companion !qes verbs
(ticket/doc/arm/transcript) landing in prophet-platform PRs after dispatch.py merges.
@mdheller
mdheller merged commit 7744907 into main Aug 4, 2026
14 checks passed
@mdheller
mdheller deleted the feat/transcript-kb-extract branch August 4, 2026 15:39
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