pi-braid 0.43.35 → 0.43.37
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +30 -0
- package/build-info.json +4 -4
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +1 -1
- package/dist/extensions/core/prompt-builder/project-docs-section.js +2 -2
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +1 -1
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +1 -1
- package/package.json +1 -1
- package/skills/skill-usage/SKILL.md +3 -3
- package/skills/subagent-orchestration/SKILL.md +5 -6
- package/src/extensions/core/prompt-builder/project-docs-section.ts +2 -2
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -96,6 +96,36 @@ record; the tag scheme above applies unchanged.
|
|
|
96
96
|
note that a clean disable releases it, because a refusal an operator cannot act on
|
|
97
97
|
is a support ticket.
|
|
98
98
|
|
|
99
|
+
## Core — 0.43.37 (2026-11-08: the shapes were rare, and the instrument policed the wrong text)
|
|
100
|
+
|
|
101
|
+
- **Measured over the shipped corpus, the seven sentence shapes fired in 8 of 61 files.** 21 hits in
|
|
102
|
+
41,575 words — and 11 of those were the catalogue quoting the shapes it forbids, so the file that defines
|
|
103
|
+
the failure was the file that scored worst. The prose that makes the complaint is not built out of those
|
|
104
|
+
seven shapes; it is built out of long sentences, asides and em-dashes, which the instrument counts
|
|
105
|
+
separately and which nothing has yet acted on.
|
|
106
|
+
- **The instrument read comments, not prompts.** Over `packages/*/src/**/*.ts` the voice check scores the
|
|
107
|
+
comments beside a prompt; the strings the agent actually reads were outside its reach until they were
|
|
108
|
+
extracted, and over extracted strings its empty-sentence counter collapses into fragments. A gate placed
|
|
109
|
+
on that path would have policed documentation and passed the prompt.
|
|
110
|
+
- **`check-voice.mjs` stays advisory, and the reason is a number.** After the rewrite the only files with a
|
|
111
|
+
hit are the three that must not change — the catalogue, the identity, and a skill whose before/after
|
|
112
|
+
example is deliberate. A threshold low enough to catch a regression fires on honest prose; a threshold
|
|
113
|
+
above the catalogue catches nothing. The band between those two numbers is empty.
|
|
114
|
+
- **Eight files rewritten anyway**, each removing the shape it carries rather than paraphrasing it:
|
|
115
|
+
`skill-usage`'s process narration, `paper-writer`'s importance paragraph, `subagent-orchestration`,
|
|
116
|
+
`adversarial-engagement`, `socratic-irony`, the shared engagement fundamentals, and two prompt-builder
|
|
117
|
+
sections.
|
|
118
|
+
|
|
119
|
+
## Core — 0.43.36 (2026-11-08: the digest reads the window it prints)
|
|
120
|
+
|
|
121
|
+
- **Two readers of one file disagreed about the same intention.** The checker treats a past
|
|
122
|
+
`expires_at` as a line that aged where it sits, while `--digest` still listed that intention as open
|
|
123
|
+
work — the one surface a successor reads first. The digest now drops an intention whose window closed
|
|
124
|
+
before the reading and prints the stamp on one whose window is still live, because when it closes is
|
|
125
|
+
part of what the next seat has to act on.
|
|
126
|
+
- **The window stays the owner's**: nothing here writes a stamp or changes a status; it reads the one
|
|
127
|
+
the writer already recorded.
|
|
128
|
+
|
|
99
129
|
## Core — 0.43.35 (2026-11-08: a merge report that leads with its own verdict)
|
|
100
130
|
|
|
101
131
|
- **Two paths merged nothing and told a reader two different stories.** The refusal family opened with
|
package/build-info.json
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pi-braid",
|
|
3
|
-
"version": "0.43.
|
|
4
|
-
"sha": "
|
|
5
|
-
"shaShort": "
|
|
3
|
+
"version": "0.43.37",
|
|
4
|
+
"sha": "7f456b784fa2259feec41d77d6c81c4bb7e64de9",
|
|
5
|
+
"shaShort": "7f456b78",
|
|
6
6
|
"branch": "detached",
|
|
7
7
|
"dirty": false,
|
|
8
|
-
"packedAt": "2026-11-
|
|
8
|
+
"packedAt": "2026-11-08T21:09:34.250Z"
|
|
9
9
|
}
|
|
@@ -22,7 +22,7 @@ export interface ProjectContextFile {
|
|
|
22
22
|
*
|
|
23
23
|
* Shape:
|
|
24
24
|
* Read the project docs in full before editing the areas they cover: the
|
|
25
|
-
* AGENTS.md / CLAUDE.md files below are this project's authoritative contract
|
|
25
|
+
* AGENTS.md / CLAUDE.md files below are this project's authoritative contract;
|
|
26
26
|
* cross-check references against source.
|
|
27
27
|
*
|
|
28
28
|
* - AGENTS.md at /abs/path/AGENTS.md
|
|
@@ -21,7 +21,7 @@ function basename(p) {
|
|
|
21
21
|
*
|
|
22
22
|
* Shape:
|
|
23
23
|
* Read the project docs in full before editing the areas they cover: the
|
|
24
|
-
* AGENTS.md / CLAUDE.md files below are this project's authoritative contract
|
|
24
|
+
* AGENTS.md / CLAUDE.md files below are this project's authoritative contract;
|
|
25
25
|
* cross-check references against source.
|
|
26
26
|
*
|
|
27
27
|
* - AGENTS.md at /abs/path/AGENTS.md
|
|
@@ -36,7 +36,7 @@ export async function projectDocsSection(contextFiles) {
|
|
|
36
36
|
return "";
|
|
37
37
|
}
|
|
38
38
|
const lines = [
|
|
39
|
-
"Read the project docs in full before editing the areas they cover: the AGENTS.md / CLAUDE.md files below are this project's authoritative contract
|
|
39
|
+
"Read the project docs in full before editing the areas they cover: the AGENTS.md / CLAUDE.md files below are this project's authoritative contract; cross-check references against source.",
|
|
40
40
|
"",
|
|
41
41
|
];
|
|
42
42
|
for (const file of contextFiles) {
|
|
@@ -8,7 +8,7 @@ import { type PromptSection } from "./section.js";
|
|
|
8
8
|
* instead of a prohibition list. The text is pinned verbatim by the lockstep
|
|
9
9
|
* test — no paraphrasing here either.
|
|
10
10
|
*/
|
|
11
|
-
export declare const SURFACE_DISCIPLINE = "Signal discipline binds every surface you produce: code comments, commit messages, tests, docs, reports, logs. A comment earns its place only by explaining why
|
|
11
|
+
export declare const SURFACE_DISCIPLINE = "Signal discipline binds every surface you produce: code comments, commit messages, tests, docs, reports, logs. A comment earns its place only by explaining why; if the code needs a what-narration, rewrite the code. Never commit internal task IDs, wave or phase labels, or session-ephemeral figures: a future reader has no context for them. Internal labels present in task text or briefs are never copied into code, tests, comments, docs, or commit messages. A report's filename and title carry wave context; a branch name may carry an operator handle, but not the commit subject, because git derives it and a reader keeps it. Write any spec or brief so a teammate with zero context can act on it.";
|
|
12
12
|
/**
|
|
13
13
|
* Its own section: the handler places it between the identity block and the
|
|
14
14
|
* identity-core block — render order: COMMUNICATION ��� SURFACE_DISCIPLINE
|
|
@@ -8,7 +8,7 @@ import { simpleSection } from "./section.js";
|
|
|
8
8
|
* instead of a prohibition list. The text is pinned verbatim by the lockstep
|
|
9
9
|
* test — no paraphrasing here either.
|
|
10
10
|
*/
|
|
11
|
-
export const SURFACE_DISCIPLINE = `Signal discipline binds every surface you produce: code comments, commit messages, tests, docs, reports, logs. A comment earns its place only by explaining why
|
|
11
|
+
export const SURFACE_DISCIPLINE = `Signal discipline binds every surface you produce: code comments, commit messages, tests, docs, reports, logs. A comment earns its place only by explaining why; if the code needs a what-narration, rewrite the code. Never commit internal task IDs, wave or phase labels, or session-ephemeral figures: a future reader has no context for them. Internal labels present in task text or briefs are never copied into code, tests, comments, docs, or commit messages. A report's filename and title carry wave context; a branch name may carry an operator handle, but not the commit subject, because git derives it and a reader keeps it. Write any spec or brief so a teammate with zero context can act on it.`;
|
|
12
12
|
/**
|
|
13
13
|
* Its own section: the handler places it between the identity block and the
|
|
14
14
|
* identity-core block — render order: COMMUNICATION ��� SURFACE_DISCIPLINE
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pi-braid",
|
|
3
|
-
"version": "0.43.
|
|
3
|
+
"version": "0.43.37",
|
|
4
4
|
"description": "🥨 Braid - Metacognitive extension suite for pi coding agent: Adds memory, plan tracking, structured cognitive signals and completion checks on top of pi core loop, so long sessions keep their context and stop claiming unfinished work.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -13,7 +13,7 @@ verdict: KEEP
|
|
|
13
13
|
|
|
14
14
|
# Skill Usage: Measuring Skill Adoption
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
Skill loading is unmeasured. This skill turns "skills are barely used" from an owner observation into a number you can act on. No new runtime code is needed: the table is per skill, computed from telemetry already on disk.
|
|
17
17
|
|
|
18
18
|
The validation-first stance: **a zero-evidence skill must NOT be KEEP.** Every skill is suspect until measured. This skill is the measurement instrument; `meta-improvement` is the evolution engine. Run this first, feed the result to `meta-improvement`.
|
|
19
19
|
|
|
@@ -26,7 +26,7 @@ The validation-first stance: **a zero-evidence skill must NOT be KEEP.** Every s
|
|
|
26
26
|
|
|
27
27
|
## Step 1: Read the session counters (exact, per-session)
|
|
28
28
|
|
|
29
|
-
Call the `skill_stats` tool.
|
|
29
|
+
Call the `skill_stats` tool. The reply carries `sessionHasSkillLoad` plus a per-skill map:
|
|
30
30
|
|
|
31
31
|
```json
|
|
32
32
|
{
|
|
@@ -57,7 +57,7 @@ Fallback / cross-check: scan session files under `~/.pi/agent/sessions/` for:
|
|
|
57
57
|
|
|
58
58
|
## Step 4: Join with an outcome proxy (where available)
|
|
59
59
|
|
|
60
|
-
Where a turn's reasoning metrics exist (`measureStability`: topic anchor, bigram entropy, self-contradiction), tag each skill-loading turn with a coarse outcome: `stable` (no self-contradiction, anchored) or `unstable`.
|
|
60
|
+
Where a turn's reasoning metrics exist (`measureStability`: topic anchor, bigram entropy, self-contradiction), tag each skill-loading turn with a coarse outcome: `stable` (no self-contradiction, anchored) or `unstable`. What matters is the **delta between two runs**, because that is what a change is compared against.
|
|
61
61
|
|
|
62
62
|
## Step 5: Emit the table and bucket
|
|
63
63
|
|
|
@@ -231,7 +231,7 @@ When a worker signals completion, review critically before closing the pane.
|
|
|
231
231
|
|
|
232
232
|
- **APPROVED** - `herdr action=send pane=<worker-pane> text="[agent:orchestrator→worker] APPROVED. Close your pane."` Then close the worker pane and capture knowledge to memory.
|
|
233
233
|
- **REVISION** - `herdr action=send pane=<worker-pane> text="[agent:orchestrator→worker] REVISION: <specific feedback>."` Set a timer to check back.
|
|
234
|
-
- **REJECTED** - If
|
|
234
|
+
- **REJECTED** - If the output fails the task: send rejection and close the pane manually.
|
|
235
235
|
|
|
236
236
|
### Failure modes
|
|
237
237
|
|
|
@@ -415,11 +415,10 @@ node scripts/workers.mjs --json # machine-readable
|
|
|
415
415
|
node scripts/workers.mjs --stale 30 # age at which 'working' is flagged (default 15m)
|
|
416
416
|
```
|
|
417
417
|
|
|
418
|
-
One row per worker: session age, event count, commits ahead, dirty count, deliverable size.
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
worker that has been running for an hour.
|
|
418
|
+
One row per worker: session age, event count, commits ahead, dirty count, deliverable size. Four sources
|
|
419
|
+
back the row, none trustworthy alone: the registry is only the _claim_, session mtime proves motion,
|
|
420
|
+
git proves commits and dirty state, the filesystem proves the deliverable exists. The registry reports
|
|
421
|
+
`working` long after a pane has died, and `admitted` for a worker that has been running for an hour.
|
|
423
422
|
|
|
424
423
|
The flags name the failure modes worth acting on:
|
|
425
424
|
|
|
@@ -31,7 +31,7 @@ function basename(p: string): string {
|
|
|
31
31
|
*
|
|
32
32
|
* Shape:
|
|
33
33
|
* Read the project docs in full before editing the areas they cover: the
|
|
34
|
-
* AGENTS.md / CLAUDE.md files below are this project's authoritative contract
|
|
34
|
+
* AGENTS.md / CLAUDE.md files below are this project's authoritative contract;
|
|
35
35
|
* cross-check references against source.
|
|
36
36
|
*
|
|
37
37
|
* - AGENTS.md at /abs/path/AGENTS.md
|
|
@@ -49,7 +49,7 @@ export async function projectDocsSection(
|
|
|
49
49
|
}
|
|
50
50
|
|
|
51
51
|
const lines: string[] = [
|
|
52
|
-
"Read the project docs in full before editing the areas they cover: the AGENTS.md / CLAUDE.md files below are this project's authoritative contract
|
|
52
|
+
"Read the project docs in full before editing the areas they cover: the AGENTS.md / CLAUDE.md files below are this project's authoritative contract; cross-check references against source.",
|
|
53
53
|
"",
|
|
54
54
|
];
|
|
55
55
|
|
|
@@ -9,7 +9,7 @@ import { simpleSection, type PromptSection } from "./section.js";
|
|
|
9
9
|
* instead of a prohibition list. The text is pinned verbatim by the lockstep
|
|
10
10
|
* test — no paraphrasing here either.
|
|
11
11
|
*/
|
|
12
|
-
export const SURFACE_DISCIPLINE = `Signal discipline binds every surface you produce: code comments, commit messages, tests, docs, reports, logs. A comment earns its place only by explaining why
|
|
12
|
+
export const SURFACE_DISCIPLINE = `Signal discipline binds every surface you produce: code comments, commit messages, tests, docs, reports, logs. A comment earns its place only by explaining why; if the code needs a what-narration, rewrite the code. Never commit internal task IDs, wave or phase labels, or session-ephemeral figures: a future reader has no context for them. Internal labels present in task text or briefs are never copied into code, tests, comments, docs, or commit messages. A report's filename and title carry wave context; a branch name may carry an operator handle, but not the commit subject, because git derives it and a reader keeps it. Write any spec or brief so a teammate with zero context can act on it.`;
|
|
13
13
|
|
|
14
14
|
/**
|
|
15
15
|
* Its own section: the handler places it between the identity block and the
|