From 0499cf68b348e98e31173ec98c53175985e4fed5 Mon Sep 17 00:00:00 2001 From: David Schultz Date: Fri, 1 Apr 2022 19:12:17 -0500 Subject: [PATCH 1/3] create `draft/oper-tag` spec --- extensions/oper-tag.md | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 extensions/oper-tag.md diff --git a/extensions/oper-tag.md b/extensions/oper-tag.md new file mode 100644 index 000000000..0dd7bc85c --- /dev/null +++ b/extensions/oper-tag.md @@ -0,0 +1,40 @@ +--- +title: "`oper-tag` Extension" +layout: spec +work-in-progress: true +copyrights: + - + name: "David Schultz" + period: "2022" + email: "me@zpld.me" +--- + +## Notes for implementing work-in-progress version + +This is a work-in-progress specification. + +Software implementing this work-in-progress specification MUST NOT use the +unprefixed `oper` tag name. Instead, implementations SHOULD use the +`draft/oper` tag name to be interoperable with other software +implementing a compatible work-in-progress version. + +## Description + +The `draft/oper` capability causes the server to add a [message tag][] to messages sent by a user who is currently an IRC operator. + +The tag MUST be named `draft/oper`. The value of the tag, if specified, MUST identify the operator. + +The tag MUST be added by the ircd to all commands sent by a user (e.g. PRIVMSG, +MODE, NOTICE, and all others) and numeric replies sent on behalf of the user. + +Servers supporting this capabilty MAY be configured to restrict visibility of this tag or its value. + +## Example + +Consider that I am identified to the `launchd` operator account while chatting with the `lunchd` nickname. I will send messages to three users with different configured levels of visibility. + + @draft/oper=launchd :lunchd PRIVMSG full_access_friend :it's me! + @draft/oper :lunchd PRIVMSG partial_access_friend :you can see I'm an oper + :lunchd PRIVMSG unprivileged_friend :don't mind me + +[message tag]: ../extensions/message-tags From 1a508a26c051b68eccda9ffefffd819d975c2362 Mon Sep 17 00:00:00 2001 From: David Schultz Date: Tue, 4 Oct 2022 15:37:52 -0500 Subject: [PATCH 2/3] fix typo --- extensions/oper-tag.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/extensions/oper-tag.md b/extensions/oper-tag.md index 0dd7bc85c..28c7868b2 100644 --- a/extensions/oper-tag.md +++ b/extensions/oper-tag.md @@ -27,7 +27,7 @@ The tag MUST be named `draft/oper`. The value of the tag, if specified, MUST ide The tag MUST be added by the ircd to all commands sent by a user (e.g. PRIVMSG, MODE, NOTICE, and all others) and numeric replies sent on behalf of the user. -Servers supporting this capabilty MAY be configured to restrict visibility of this tag or its value. +Servers supporting this capability MAY be configured to restrict visibility of this tag or its value. ## Example From 68850bc2ed2d7a3e13d6a30c5c6bb7dd6efb9c2e Mon Sep 17 00:00:00 2001 From: David Schultz Date: Tue, 25 Oct 2022 19:16:01 -0500 Subject: [PATCH 3/3] use SHOULD for numerics --- extensions/oper-tag.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/extensions/oper-tag.md b/extensions/oper-tag.md index 28c7868b2..c9e731618 100644 --- a/extensions/oper-tag.md +++ b/extensions/oper-tag.md @@ -25,7 +25,7 @@ The `draft/oper` capability causes the server to add a [message tag][] to messag The tag MUST be named `draft/oper`. The value of the tag, if specified, MUST identify the operator. The tag MUST be added by the ircd to all commands sent by a user (e.g. PRIVMSG, -MODE, NOTICE, and all others) and numeric replies sent on behalf of the user. +MODE, NOTICE, and all others) and SHOULD be added to any numeric replies sent on behalf of the user. Servers supporting this capability MAY be configured to restrict visibility of this tag or its value.