Files
R8Forge/asm/raw_inc_nc.r8asm
dsh b4ea79ba91 %synth: the cost model is a run option, not a per block metric line
`metric chars|flat|blocks` inside %synth meant the same truth table could be
searched twice for two call sites, and every library block had to spell out
`metric flat` to avoid the default.  The cost model belongs to the whole
assembly, so it is one now:

    r8forge <file.r8asm>                  flat (layout free), the default
    r8forge --synth-chars <file.r8asm>    charge the real .tp walk

flat stays the default because a library block is expanded at dozens of call
sites with different layouts: only a layout free result can share one cache
entry, and it is usually within a few percent (full_add: 95 vs 90 characters).
The chars search is far more expensive (full_add: 415M states, ~21 minutes,
~10 GB), which is exactly why it should be asked for on the command line.

`metric blocks` goes with it: block count is a poor proxy for tape length (and
it was only another way to ask for mode layers).

Implementation: the metric lives in the assembler (ast::synth_metric, default
1) and is set through r8asm::set_synth_metric() before import_file; the CLI in
tests/asm_test.cc parses --synth-chars / --synth-flat.  The cache key already
carried metric, so the committed entries still hit: assembling the library and
asm/test.r8asm gives byte identical tapes (28729 characters, byte_op_test all
green, all 13 examples green, synth_test still 8/8).

A `metric` line now fails with a message that names the flag instead of being
silently ignored.  examples/full_add_flat.r8asm and full_add_flat_spaced.r8asm
are removed: they only existed to demonstrate the per block metric (the flat
default makes them copies of full_add.r8asm).

Also repairs the mojibake in README's metric section: an earlier tool wrote
\x0c / \x08 / \x0d where \f, \b and \r belonged, which ate characters out of
"flat", "blocks", "biz/flb/rnz" and "rnz".  The section is rewritten for the
flag, and the %synth numbers in README/SPEC/AGENTS now match what the tree
prints.

New cache entry c16bf083bb0ccbc8.txt is full_add's stat table with mode layers
+ flat, which full_add_stat.r8asm now produces.
2026-11-07 23:44:01 +08:00

57 lines
1.8 KiB
Plaintext

%include "asm/lib.r8asm"
; 忽略独立进位的自增切片:一个操作数 + 一个"进->出"的进位 cell + 和。
;
; 和 clb_bit_add_nc 的关系:自增就是"加一个 1",但 1 不用 cell 装,所以少一个参数。
; 切片占 3 个 cell:A、进位、S。A 被吃掉(结束为 0),进位就地在自己的 cell 里更新。
;
; 两条要知道的:
; 1. %synth 出来的程序只碰每个 cell 的低 K 位,高位不追踪 —— 这是个位级切片,
; 喂进来的 A、进位都必须是 0/1;
; 2. set_0 清的是最低位(`biz`/`rnz` 判 `cell & 1`,见 AGENTS),不会碰 S 的其余位。
;
; 它也**能**配轮转式字节级驱动(读走最低位、丢掉、再 ror),`clb_inc_nc` 就是
; 这么拼的:A 被吃干净、结果在 S、进位进->出。想在自增之后还留着 A 的用 `raw_inc`
; (保留 A 的 bit_raw_inc,5 cell)。
; Macro clb_bit_inc_nc
; %1: CellBit A
; %2: CellBit Ci
; %3: CellBit S
;
; 三个 cell 都有意义、没有草稿 cell(所以不带 `raw`),A 被吃掉(所以带 `clb`)。
; 表:S = A^Ci,进位 = A&Ci;A 结束为 0。
%synth clb_bit_inc_nc_synth
params 3
stat 0 4 4 2 0 4 4 2
mode tape
%endsynth
%macro clb_bit_inc_nc 3
.tp %3
set_0
clb_bit_inc_nc_synth %1 %2 %3
%endmacro
; Macro clb_inc_nc
; %1: Cell A
; %2: Cell S
; %3: CellBit Ci
;
; 字节级"加一个 0/1":S = A + Ci,A 被吃干净。进位 cell 是**真正的进位输入** ——
; 要自增就由调用者先 `set_1`(那一位就是"加 1"),要加 0 就 `set_0`。
; 宏自己不碰初值,所以多字节可以串起来:上一字节的进位输出直接当下一字节的进位输入。
%macro clb_inc_nc 3
.anchor before_clb_inc_nc
%rep _CELL_SIZE
clb_bit_inc_nc %1 %3 %2
.tp %1
ror
.tp %2
ror
%endrep
.tp before_clb_inc_nc
%endmacro