用图尔敏论证模型写入判定·执行图。这是 GEUL 用 GEUL 描述自身规则并自我修订的核心系列。

分组Codec
声明CASE-DECLARE(案件), PREDICATE-DECLARE(谓词), SPEC-DECLARE(判断标准), RULE-DECLARE(主张), COUNTER-DECLARE(反驳), EXCEPT-DECLARE(例外) — NODE
关系ATTACKS(攻击), SUPERSEDES(排除) — LINK, SUPERSEDE-CHAIN(优先级链,布局未定)
执行RUN, DO, DO-ONCE, UNDO, CHECKING — LINK, ENTRY, TRIGGER — NODE
结果VERDICT(判定结果:Pass·Review·Fail), EVIDENCE(判定的证据) — 布局未定
  • 原文·分段·辅助节点与关系是 TOULMIN 形式系列的直接码 0x120L~0x134L(SOURCE 与分段、TOULMIN)。
  • 判定结果放在与判定对象不同的文档中。结果文档导入对象文档并指向它。因此即使做出判定,对象文档的内容哈希也不会改变。

TOULMIN 系列 Edge(直接码 0x100L~0x11BL,辅助记录属于 TOULMIN 形式系列 0x120L~0x134L)用图尔敏论证模型写入判定·执行图。主张·反驳·例外的声明、攻击·排除关系、执行连接、判定结果全都是 Edge。一个 TANGEUL 文档(toulmin 引擎的规则语言)成为一个 GEUL 文档。文件扩展名与其他文档相同,为 .geul。

本文档未规定的内容遵循 Edge 的公共规则和记录与 TAG WORD。

元认知与自我修订

TOULMIN 之所以是 GEUL Codec,是为了让 GEUL 对自身进行元认知。判定·执行规则也必须用 GEUL 描述,TOULMIN 才能以这些规则为对象进行自我修订。因此 TOULMIN 不是应用 Profile,而是 GEUL 运作的核心,置于 Edge 直接码空间(0x100L~0x11BL)。

  • 自我描述使自我改进成为可能,但也承担循环错误的风险。如果规则自己判定自己的修订,放宽判断标准的修订也可能通过(通过率上升而实际准确率下降)。
  • 循环作为风险接受,但用结构切断。
    • 固定核心:判定的语义(Pass·Review·Fail,攻击·排除·优先级,以及下文在未知之上做判定的三值求值与 U → Review)固定在本规范中。不能用 TOULMIN 文档更改。与内置于解码器的规则(公布地址与版本列表的第 0 层)处于同一位置。
    • 版本分离:规则文档 v(n) 的修订,用 v(n−1) 规则和外部检查来判定。规则不判定自身。判定结果放在与对象不同的文档中(对象的内容哈希不变)。
    • 不可变历史:修订作为新版本累积(PARENT、内容哈希、签名)。旧版本保留,因此可以事后找出循环错误并回退。自我修订的安全网是 GEUL 的版本模型(文档)。
    • 外部基准:另设一组修订路径无法触及的测试案例。修订是否采纳,以这一组的结果确认。
  • 证伪测试:故意植入一条错误规则。如果系统修正了它且外部基准得分上升,则自我改进有效。如果只有通过率上升而外部基准得分下降,则是循环错误。

编码

TOULMIN 记录使用三种布局之一。布局由 Codec 决定。

布局用途页面
NODE案件·规则·定义·入口等图节点NODE
LINK节点之间的关系(攻击、排除、执行、定义)LINK
EXPR条件式(谓词)EXPR

原文与分段记录(SOURCE、TEXT、SECTION、CASE-BEGIN·CASE-END、PROSE)由 SOURCE 与分段规定。

直接码

Codec名称布局TANGEUL含义
0x100LCASE-DECLARENODEin case of案件声明。承载节点与关系的判定图
0x101LPREDICATE-DECLAREEXPRRules 的条件式谓词声明。判定式
0x102LSPEC-DECLARENODEDefinitions 条目判断标准声明(Backing)。role 位表示定义种类
0x103LRULE-DECLARENODEgeneral rule, Rules 的规则名主张声明(Warrant)。可被攻击
0x104LCOUNTER-DECLARENODEcounter rule反驳声明。带着自己的结论发起攻击。默认 Level 为 Fail
0x105LEXCEPT-DECLARENODEexcept rule例外声明。不带自己的结论发起攻击。默认 Level 为 Review
0x108LATTACKSLINKdon't X when Y攻击关系。攻击者的判定按攻击强度(0~1,默认 1)逐步削减对象的判定
0x109LSUPERSEDESLINKX supersedes Y排除关系。攻击者为 Active 时,在汇总中确定性地剔除对象。链(A > B > C)每一对写一条
0x10ALSUPERSEDE-CHAIN—优先级链 A > B > C。逐对 SUPERSEDES 的缩写。只分配了代码,尚无布局
0x110LRUNLINKrun c when n执行组合。节点为 Active 时执行下级案件(DAG)
0x111LDOLINKdo fn when n节点为 Active 时执行的动作
0x112LDO-ONCELINKdo fn once when n即使重试也只执行一次的动作
0x113LUNDOLINKundo fn when nDO 的补偿动作(saga)。后续步骤失败时按逆序执行
0x114LCHECKINGLINKchecking c只做判定、无副作用的连接
0x115LENTRYNODEprovides x外部入口。执行或判定案件
0x116LTRIGGERNODEon, every, until无需外部调用的事件·周期入口
0x118LVERDICT—节点·记录的判定结果。结果(Pass、Review、Fail)、判定值、Activated、Excluded、Level。只分配了代码,尚无布局
0x119LEVIDENCE—判定的证据。位置、期望值、实际值(Fact)。只分配了代码,尚无布局
0x11CL~0x11FLReserved
  • 表中没有的直接码(0x106L·0x107L、0x10BL~0x10FL、0x117L、0x11AL·0x11BL)为 Reserved。
  • 分组为:0x100L~0x107L 声明,0x108L~0x10FL 关系,0x110L~0x117L 执行,0x118L~0x11FL 结果(0x11CL~0x11FL 为 Reserved)。
  • 整个文档的判定由 Meta VERDICT(0x1E9L)负责,节点·记录的判定由 TOULMIN VERDICT(Edge 0x118L)负责。两者的 Kind 不同,是各自独立的 Codec。

TOULMIN 形式

原文·分段·辅助节点与关系置于 Edge TOULMIN 形式系列直接码 0x120L~0x134L。没有 Issuer 和 Codec 编号栏,TAG 之后直接是 Payload。

TAG WORD          0001 0010 0000 LLLL      Edge, Codec 0x120L (SOURCE)。其他代码位置相同
[Length 扩展 TAG]
Edge Id           LOCAL Reference 记录
组成部分           由形式规定的布局
Codec名称布局含义
0x120LSOURCEID, SPAN 宽度 WORD, UTF8 Value撰写原文
0x121LTEXTID, UTF8 Value名称·字符串
0x122LSECTIONID, 章节代码 1 WORD章节开始
0x123LCASE-BEGINID, REF(案件)案件范围开始
0x124LCASE-ENDID, REF(案件)案件范围结束
0x125LPROSEID, SPAN叙述段落
0x126LNAMESPACENODEthis document is
0x127LFUNCNODE函数引用
0x128LFIELDNODEis required
0x129LALIASNODEsee … from
0x12ALGROUPNODE有序执行分组
0x12BLREQUIRESLINK案件 → 字段
0x12CLMEANSLINK定义条目 → 值·类型
0x12DLHASLINK定义条目 → 字段
0x12ELRUNSLINK入口 → 案件,执行
0x12FLEVALUATESLINK入口 → 案件,判定
0x130LTRIGGERSLINK触发器 → 案件
0x131LUNTILLINK触发器 → 案件(every … until)
0x132LSAME-ASLINK节点 → 全局标识符
0x133LIMPORTED-FROMLINK别名 → 路径(TEXT)
0x134LLABELLINK节点 → TEXT,名称标记

文档

一个 .geul 文件就是一个 DOC。DOC 之外不放其他字节。

DOC-1WORD/2WORD/4WORD     总长度
  SPEC-VERSION            0x0001 (v1, 无内置 Value 的整数)
  PROFILE                 UTF8 Value "tangeul-<major>.<minor>"。当前为 "tangeul-1.0"
  [DEFAULT-LANGUAGE]      LANGUAGE-BCP47-CODE Value。撰写区域设置("en", "ko")
BODY
  SOURCE                  撰写原文。BODY 的第一条记录
  语句记录 …               文档声明顺序
END
  • HEAD:SPEC-VERSION、PROFILE,可选 DEFAULT-LANGUAGE。
  • SPEC-VERSION 不同或 PROFILE 的 major 不同时,解码器拒绝。minor 不同时仍可读取。
  • BODY 的第一条记录是 SOURCE。所有 SPAN 都是此原文内的范围。
  • 语句记录的顺序与文档声明顺序相同。执行顺序(do·run 触发,undo 逆序补偿)依赖此顺序。TOULMIN 文档中 Edge 的顺序有意义(Edge 布局顺序规则的例外)。
  • BODY 的所有记录都是 Edge。不设独立的 Value 记录。值内置于 Edge Payload 中。
  • 案件的身份与导入使用 Meta DOC-ID·IMPORT-DOC(TANGEUL 的 Subject·See)。

公共字段

字段宽度说明
IDLOCAL Reference 记录记录的 Edge Id。所有记录 Payload 的第一个元素
REFLOCAL Reference 记录指向本文档其他记录的 Edge Id。0 表示没有
SPAN由 SOURCE 决定的宽度 × 2撰写原文内的范围。起始字节、字节数
  • ID 和 REF 是内置的 LOCAL Reference 记录(0000 0000 0101 LLLL + 最短宽度的 ID)。宽度由该记录的 Length 决定,不以文档为单位声明。
  • REF 0(LOCAL 0)表示"没有"。这是把 LOCAL 0 用作"没有"的 Codec 规则(LOCAL)。
  • Edge Id 从 1 开始分配,在文档内不重复。0 是 REF 的"没有",因此不用作 Edge Id。
  • 节点会被其他记录前向引用,因此按文档声明顺序先取得编号。其余记录(SOURCE、TEXT、LINK、FUNC、分段记录)由编码器从节点之后的编号开始分配。
  • 解码器只检查 Edge Id 不为 0 且无重复。分配顺序不用于解释。
  • 节点和关系通过 Edge Id 指向。
  • 内置 Value 就是包含 TAG WORD 的 Value 记录本身。长度由其 TAG 决定。

数值

  • 判定值(−1~1)、Qualifier(0~1)、攻击强度(0~1)是 SIGNED-DECIMAL Value。不另设定点数格式。
  • 编码器去掉系数末尾的 0。0.8 为 C=8, E=−1。解码器接受到小数点后 4 位。
  • 置信度门(例:at least 75%)用比较运算符 1 WORD 和百分比 UNSIGNED-DECIMAL Value(E=0)写入(LINK F_GATE)。
  • 攻击强度是 ATTACKS 的 F_FORCE 字段(LINK)。超出范围则拒绝。

节点声明的轴

  • 节点声明(RULE·COUNTER·EXCEPT-DECLARE)具有角色(主张·反驳·例外)、Qualifier(0~1)、Level(Unset、Fail、Review)。角色由 Codec 和 NODE 头部的 role 承载,Qualifier 由 F_QUAL 承载,Level 由头部的 level 承载(NODE)。
  • 刚度(Strict、Defeasible、Defeater)是与角色无关的另一个轴。刚度的布局尚未确定。
  • 攻击强度(Force)不是节点的值,而是 ATTACKS 边的值(LINK F_FORCE)。与刚度是不同的轴。

在未知之上做判定

当判定图接收 GEUL 事实作为输入时,占位标记的三个概念(未写出、未知、无)按不同方式求值。EXPR 比较运算符的求值如下。

输入is emptyis not emptyequals / is in / 大小比较
值 v假真按 v 求值
NO-VALUE (无)真假假
UNKNOWN-VALUE (未知)假真未定(U)
ABSENT (未写出) / 无陈述U (开放世界)UU
  • 逻辑使用 Kleene 强三值。NOT U = U,假 AND U = 假,真 OR U = 真。其余组合的 U 仍为 U。
  • EXISTS any 在元素中有一个为真时为真。没有真而有 U 时为 U,全部为假时为假。
  • 谓词为 U 时,该节点的判定不是 Pass·Fail,而是 Review。 不知道就交给人(或下一阶段)。
  • 要把 ABSENT 看作 empty 而非 U,输入一侧必须声明封闭世界(作为判断标准 SPEC 注入,例:“此案件的输入是完整的”)。没有声明则为 U。
  • 此表和 U → Review 的对应是判定的语义,属于固定核心。不能用 TOULMIN 文档更改。
  • 例:“只统计现在仍有效的国境”(P582 is empty)规则:P582 = UNKNOWN-VALUE 时为假而排除,P582 = NO-VALUE 时为真而纳入,没有 P582 时为 U,因此交给 Review。

判定结果

  • 判定结果(VERDICT、EVIDENCE)放在与判定对象不同的文档中。结果文档用 IMPORT-DOC 导入对象文档,并用 EXTERNAL-POINTER-* 指向它。因此即使做出判定,对象文档的内容哈希也不会改变。
  • 整个文档的判定是 Meta VERDICT,节点·记录的判定是 TOULMIN VERDICT。
  • 选择修订适用版本的规则(过渡规定、行为时法与新法的选择)以及解释例·判例,也用作判定规则(文档)。

未决问题

  • SUPERSEDE-CHAIN(0x10AL)、VERDICT(0x118L)、EVIDENCE(0x119L)的布局。以目前每一对写一条 SUPERSEDES 的方式是否足以表达链。
  • 节点刚度(Strict、Defeasible、Defeater)的布局。
  • 写了攻击强度 1 的 ATTACKS 与没写的 ATTACKS,判定相同但字节不同。判定是否相同,必须比较解释后的值而不是字节。
  • EXPR 中的节点数、标签数、标签索引为 1 WORD,子节点数为 13 位。上限是固定的。
  • PROVENANCE(规则出处·前提)布局。
  • 反引号名称是否用陈述 LABEL·BIND,而不是 TEXT + LABEL(0x134L)。
  • Claim 的 predicate·mode 代码值和 FuncRef 的 VerbCode 代码值表。
  • 封闭世界声明(把 ABSENT 读作 empty)是以判断标准(SPEC)为单位,还是以案件为单位。
  • TOULMIN Codec 的 Codec 规格文档。NODE·LINK 的条件字段以及由 SOURCE 决定的 SPAN 宽度,属于无法用 FIELD 声明的布局。

相关页面

NODE

NODE 是用于写入 TOULMIN 判定·执行图节点的布局。节点种类由 Codec 决定,头部 1 WORD 决定角色、Level、Claim 形态和条件字段。

Codec

Codec名称TANGEUL节点
0x100LCASE-DECLAREin case of案件
0x102LSPEC-DECLAREDefinitions 条目(means, has)判断标准(Backing)。role 表示定义种类
0x103LRULE-DECLAREgeneral rule主张(Warrant)
0x104LCOUNTER-DECLAREcounter rule反驳(Rebuttal)
0x105LEXCEPT-DECLAREexcept rule例外(Defeater)
0x115LENTRYprovides x外部入口
0x116LTRIGGERon, every, until事件·周期入口
0x126LNAMESPACEthis document is文档命名空间
0x127LFUNC函数引用外部函数(例:bank.withdraw)
0x128LFIELDx is required [as Type]必填字段
0x129LALIASsee a from path导入的包别名
0x12ALGROUP1. 有序列表有序执行分组

0x126L~0x12AL 是 Edge TOULMIN 形式系列的直接码(TOULMIN)。

布局

ID               LOCAL Reference 记录 (Edge Id)
头部 1 WORD      role 2b | Reserved 2b | F_GROUNDS 1b | level 2b | object 种类 2b | flags 7b
[F_FUNC]         FuncRef: REF(ALIAS, 没有则为 0) + VerbCode 1 WORD
[F_QUAL]         SIGNED-DECIMAL Value。Qualifier
[F_CHECK]        REF(案件)
[F_CLAIM]        Claim: REF(subject) + predicate 1 WORD + object + mode 1 WORD
[F_VERDICT]      SIGNED-DECIMAL Value。判定值初始值
[F_WITH]         个数(UNSIGNED-INTEGER Value) + REF(TEXT) × 个数
[F_GROUNDS]      个数(UNSIGNED-INTEGER Value) + REF(TEXT) × 个数
SPAN             由 SOURCE 决定的宽度 × 2 (起始字节, 字节数)

头部 WORD

位字段值
15–14role0 general, 1 counter, 2 except
13–12Reserved0
11F_GROUNDS有依据列表
10–9level0 Unset, 1 Fail, 2 Review (3 Reserved)
8–7object 种类Claim object 的形态。0 REF, 1 UNSIGNED-INTEGER Value, 2 SPAN
6–0flags见下表
位flag含义
b0F_FUNC有 FuncRef 字段
b1F_QUAL有 Qualifier 字段
b2F_CHECK有 checking 对象案件字段
b3F_CLAIM有 Claim 字段
b4F_VERDICT有判定值初始值字段
b5F_STRIKE以删除线划掉的声明。没有字段
b6F_WITH有基准列表字段
  • 条件字段按 flag 顺序(F_FUNC、F_QUAL、F_CHECK、F_CLAIM、F_VERDICT、F_WITH、F_GROUNDS)排列。flag 关闭的字段不占位置。
  • flag 已开启但没有字段时拒绝。依次读完字段后的位置,在 SPAN 之后必须与记录末尾恰好吻合。

字段

字段说明
FuncRef函数位。REF 是导入该函数的 ALIAS 记录,若是本文档的函数则为 0。VerbCode 是 1 WORD 代码,尚未分配(允许 0x0000)。函数的原文写法另用 TEXT + LABEL 书写
Qualifier节点的置信度(0~1)
案件F_CHECK:此节点只做判定的案件(checking c)
Claim节点承载的命题。subject REF、predicate 1 WORD、object、mode 1 WORD。object 的形态由头部的 object 种类决定
判定值判定值的初始值(−1~1)
F_WITH声明时点的判断标准(기준으로 하는,“以……为基准的”)。TEXT 记录 REF 列表
F_GROUNDS求值时点解析的外部事实名称(근거로 하는,“以……为依据的”)。TEXT 记录 REF 列表
SPAN此声明出自的原文范围
  • 判定值·Qualifier 的写法遵循 TOULMIN 数值规则。
  • 列表的个数是内置的 UNSIGNED-INTEGER Value 记录。
  • 陈述 Claim 的基本形态是 subject·predicate 为 0,object 为 SPAN(object 种类 2)。固定于原文写法。

解释与有效性

  • role 在 RULE·COUNTER·EXCEPT-DECLARE 中必须与 Codec 一致(0 general, 1 counter, 2 except)。在 SPEC-DECLARE 中是定义种类。在其他 Codec 中为 0。
  • level 为 0(Unset)时使用引擎的默认值:COUNTER-DECLARE 为 Fail,EXCEPT-DECLARE 为 Review。
  • TANGEUL tangl:규칙 的宿主函数规则(쓰는 규칙이다,“使用的规则”)写成案件之外的 RULE-DECLARE NODE。函数为 F_FUNC,基准为 F_WITH,依据为 F_GROUNDS。只有条件式规则才在前面放 PREDICATE-DECLARE。
  • Reserved 位(13–12)必须为 0。Reserved 位开启或 role 与 Codec 不符时拒绝。

相关页面

LINK 是用于写入 TOULMIN 图中节点之间关系的布局。关系的种类由 Codec 决定。

Codec

Codec名称TANGEULsrc → dst
0x108LATTACKSdon't X when Y规则 → 规则。按攻击强度逐步削减判定
0x109LSUPERSEDESX supersedes Y规则 → 规则。为 Active 时在汇总中剔除对象
0x110LRUNrun c when n规则 → 案件
0x111LDOdo fn when n规则 → FuncRef
0x112LDO-ONCEdo fn once when n规则 → FuncRef
0x113LUNDOundo fn when n规则 → FuncRef
0x114LCHECKINGchecking c规则 → 案件。无副作用的判定
0x12BLREQUIRESf is required案件 → 字段
0x12CLMEANSDefinitions means定义条目 → 值·类型
0x12DLHASDefinitions has定义条目 → 字段
0x12ELRUNS入口 run c入口 → 案件(执行)
0x12FLEVALUATES入口 check c入口 → 案件(判定)
0x130LTRIGGERS触发器 run c触发器 → 案件
0x131LUNTILevery … until c触发器 → 案件
0x132LSAME-AS节点 → 全局标识符
0x133LIMPORTED-FROMsee a from path别名 → 路径(TEXT)
0x134LLABEL反引号名称节点 → TEXT。名称标记

布局

ID               LOCAL Reference 记录 (Edge Id)
src              REF
dst              REF。DO·DO-ONCE·UNDO 为 FuncRef
flags 1 WORD     b0 F_ONCE, b1 F_GATE, b2 F_STRIKE, b3 F_ORDERED, b4 F_FORCE
[F_GATE]         运算符 1 WORD(高 2 位) + UNSIGNED-DECIMAL Value(百分比)
[F_FORCE]        SIGNED-DECIMAL Value。攻击强度(0~1)。仅 ATTACKS
SPAN             由 SOURCE 决定的宽度 × 2
flag含义
b0 F_ONCE只执行一次(UNDO 的 once)
b1 F_GATE有置信度门字段
b2 F_STRIKE以删除线划掉的关系
b3 F_ORDERED属于 1. 有序列表
b4 F_FORCE有攻击强度字段。仅 ATTACKS
门运算符含义
0at least
1above
2less than
3at most
  • 条件字段按 flag 顺序(F_GATE、F_FORCE)排列。flag 关闭的字段不占位置。

攻击强度

攻击强度(F_FORCE)仅由 ATTACKS 使用。判定式、写法、示例见该页。

解释与有效性

  • REF 是本文档记录的 Edge Id(TOULMIN 公共字段)。
  • dst 的形态由 Codec 决定。DO·DO-ONCE·UNDO 为 FuncRef(REF(ALIAS,没有则为 0) + VerbCode 1 WORD,NODE),LABEL·IMPORTED-FROM 为 TEXT 记录的 REF,其余为节点的 REF。
  • do … once 由 DO-ONCE Codec 表示。DO-ONCE 的 flags 不使用 F_ONCE(若已开启则拒绝)。UNDO 的 once 用 F_ONCE 表示。
  • 门运算符是运算符 WORD 的高 2 位,其余 14 位为 0。百分比是 E=0 的 UNSIGNED-DECIMAL Value,范围 0~100。
  • flags 的 b5~b15 为 Reserved,必须为 0。否则拒绝。
  • F_FORCE 仅在 ATTACKS 中使用。在其他 Codec(SUPERSEDES、执行·判定连接、TOULMIN 形式关系)中开启则拒绝。
  • 攻击强度不是 SIGNED-DECIMAL Value、超出 0~1 范围或无法用小数点后 4 位精确表示时,拒绝。
  • SUPERSEDES 的链 A > B > C 每一对写一条 SUPERSEDES。

相关页面

SOURCE 与分段

写入 TOULMIN 文档原文与分段的记录。全部是 Edge TOULMIN 形式系列直接码 0x120L~0x125L(TOULMIN)。没有 Issuer 和 Codec 编号栏,TAG 之后是 Payload。

形式

Codec名称布局
0x120LSOURCEID, SPAN 宽度 WORD, UTF8 Value
0x121LTEXTID, UTF8 Value
0x122LSECTIONID, 章节代码 1 WORD
0x123LCASE-BEGINID, REF(案件)
0x124LCASE-ENDID, REF(案件)
0x125LPROSEID, SPAN
  • ID 是 Edge Id,REF 是本文档记录的 Edge Id(TOULMIN 公共字段)。
  • UTF8 Value 是 UTF8-TEXT Value 记录。原样存放字节。

各形式的页面

布局、章节代码表、解释在每种形式各自的页面中。

相关页面