rewrite README.md into an actual and complete service description and spec #3

Closed
opened 2026-03-01 16:56:12 +01:00 by sneak · 3 comments
Owner

@clawbot please apply appropriate labels to this task. read the readmes for upaas pixa mfer netwatch and autistmask to get an example of the level of completeness i'm looking for. also review all code style standards in sneak/prompts (prompts subdir) as well as the go http server guidelines and create issues in this repo for all divergences.

@clawbot please apply appropriate labels to this task. read the readmes for upaas pixa mfer netwatch and autistmask to get an example of the level of completeness i'm looking for. also review all code style standards in sneak/prompts (prompts subdir) as well as the go http server guidelines and create issues in this repo for all divergences.
clawbot added the
bot
label 2026-03-01 16:59:02 +01:00
clawbot self-assigned this 2026-03-01 16:59:03 +01:00
Collaborator

Labels applied. Assigned to clawbot.

I have a compliance worker already running for issue #1 + issue #2 that is making initial README improvements. Once that PR lands, I will:

  1. Read READMEs from upaas, pixa, mfer, netwatch, and AutistMask to understand the completeness bar
  2. Review all code style standards in sneak/prompts (CODE_STYLEGUIDE.md, CODE_STYLEGUIDE_GO.md, GO_HTTP_SERVER_CONVENTIONS.md, etc.)
  3. Audit webhooker code against those standards
  4. Create individual issues for each divergence
  5. Dispatch a worker for the comprehensive README rewrite

Waiting for the current compliance PR to avoid merge conflicts on the same files.

Labels applied. Assigned to clawbot. I have a compliance worker already running for [issue #1](https://git.eeqj.de/sneak/webhooker/issues/1) + [issue #2](https://git.eeqj.de/sneak/webhooker/issues/2) that is making initial README improvements. Once that PR lands, I will: 1. Read READMEs from upaas, pixa, mfer, netwatch, and AutistMask to understand the completeness bar 2. Review all code style standards in `sneak/prompts` (CODE_STYLEGUIDE.md, CODE_STYLEGUIDE_GO.md, GO_HTTP_SERVER_CONVENTIONS.md, etc.) 3. Audit webhooker code against those standards 4. Create individual issues for each divergence 5. Dispatch a worker for the comprehensive README rewrite Waiting for the current compliance PR to avoid merge conflicts on the same files.
Author
Owner

in the new README i would like a very clear description of the data model. i have included some of the entities/tables in the current README but you can probably get a much better mental model of it together and document it much more clearly. i'd like you to come up with a new name for the main entity in the application which i am calling the 'processor' now which is basically "a webhook" - maybe those are called 'webhooks' and the URLs under /webhooks/<uuid> can be called 'entrypoints` or something.

i left a note on the compliance PR about the sqlite setup i'd like to use (one sqlite file for the main app and all normal webapp stuff, then one sqlite file per "webhook"/"processor" which stores the input logs, the output queues, and the internal processing logs).

in the new README i would like a very clear description of the data model. i have included some of the entities/tables in the current README but you can probably get a much better mental model of it together and document it much more clearly. i'd like you to come up with a new name for the main entity in the application which i am calling the 'processor' now which is basically "a webhook" - maybe those are called 'webhooks' and the URLs under `/webhooks/<uuid>` can be called 'entrypoints` or something. i left a note on the compliance PR about the sqlite setup i'd like to use (one sqlite file for the main app and all normal webapp stuff, then one sqlite file per "webhook"/"processor" which stores the input logs, the output queues, and the internal processing logs).
Author
Owner

ok you may proceed, compliance PR is merged

ok you may proceed, compliance PR is merged
sneak closed this issue 2026-03-02 00:43:56 +01:00
Sign in to join this conversation.
No Milestone
No project
No Assignees
2 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: sneak/webhooker#3
No description provided.