@futurelastic/colab-handbook 1.13.0-rc.56 → 1.13.0-rc.58
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/README.md +2 -2
- package/README.vi.md +2 -2
- package/audit/audit.mjs +8 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -6,7 +6,7 @@ A small set of conventions and tools for running many repos — many coding
|
|
|
6
6
|
sessions in parallel, humans and AI agents alike — without stepping on each
|
|
7
7
|
other.
|
|
8
8
|
|
|
9
|
-
**If you are an AI agent, stop here and read [`
|
|
9
|
+
**If you are an AI agent, stop here and read [`AGENTS.md`](AGENTS.md).**
|
|
10
10
|
This file is for humans.
|
|
11
11
|
|
|
12
12
|
## Quick start
|
|
@@ -240,7 +240,7 @@ migration hold with or without it.
|
|
|
240
240
|
| Path | What it is |
|
|
241
241
|
|---|---|
|
|
242
242
|
| [`CONVENTIONS.md`](CONVENTIONS.md) | The rules. Normative, the single source of truth (EN). |
|
|
243
|
-
| [`
|
|
243
|
+
| [`AGENTS.md`](AGENTS.md) | The entry point for AI agents — the operational distillation (EN). |
|
|
244
244
|
| [`project.schema.md`](project.schema.md) | Field reference for `.github/project.yml`. |
|
|
245
245
|
| [`templates/`](templates/) | **Copy-and-own** starting points: CI, release, git hooks (a secret scan and an identity scan), and the `CLAUDE.md` block for adopting repos. Nothing is called remotely — copy it, edit it, own it. |
|
|
246
246
|
| [`tools/`](tools/) | `colab` — a small CLI (optional): adopt a repo, claim issues, allocate ports, manage worktrees, and merge a finished branch to trunk when the repo grants it. JSON state, zero dependencies. Command reference: [`tools/README.md`](tools/README.md). |
|
package/README.vi.md
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
Bộ quy ước và công cụ nhỏ để vận hành nhiều repo — nhiều phiên code song song,
|
|
6
6
|
người thật lẫn AI agent — mà không giẫm chân nhau.
|
|
7
7
|
|
|
8
|
-
**Nếu bạn là AI agent, dừng ở đây và đọc [`
|
|
8
|
+
**Nếu bạn là AI agent, dừng ở đây và đọc [`AGENTS.md`](AGENTS.md).**
|
|
9
9
|
File này dành cho con người.
|
|
10
10
|
|
|
11
11
|
## Bắt đầu nhanh
|
|
@@ -239,7 +239,7 @@ quyền cấp trước khi chạy migration vẫn đứng vững dù có nó hay
|
|
|
239
239
|
| Đường dẫn | Là gì |
|
|
240
240
|
|---|---|
|
|
241
241
|
| [`CONVENTIONS.md`](CONVENTIONS.md) | Luật. Chuẩn tắc, nguồn sự thật duy nhất (EN). |
|
|
242
|
-
| [`
|
|
242
|
+
| [`AGENTS.md`](AGENTS.md) | Cửa vào cho AI agent — bản chưng cất vận hành (EN). |
|
|
243
243
|
| [`project.schema.md`](project.schema.md) | Tham chiếu field của `.github/project.yml`. |
|
|
244
244
|
| [`templates/`](templates/) | Điểm khởi đầu **copy-về-là-của-bạn**: CI, release, git hook (một bản quét secret và một bản quét danh tính), và block `CLAUDE.md` cho repo adopt. Không có gì được gọi từ xa — copy, sửa, sở hữu. |
|
|
245
245
|
| [`tools/`](tools/) | `colab` — một CLI nhỏ (tùy chọn): adopt một repo, claim issue, cấp port, quản lý worktree, và merge nhánh đã xong vào trunk khi repo cho phép. State JSON, không dependency. Tham chiếu các lệnh: [`tools/README.md`](tools/README.md). |
|
package/audit/audit.mjs
CHANGED
|
@@ -1770,8 +1770,10 @@ function auditRepo(target, ctx) {
|
|
|
1770
1770
|
// the handbook's OWN CLAUDE.md too (not a stamp check, so it is not gated on !isSelf).
|
|
1771
1771
|
checkClaudeMdSize(src, warn, th.values);
|
|
1772
1772
|
// #417: same posture — a tool block loaded twice, or the Conventions block moved out of the
|
|
1773
|
-
// file tools look it up in, is a repo-doc concern on every repo, the handbook's own included
|
|
1774
|
-
|
|
1773
|
+
// file tools look it up in, is a repo-doc concern on every repo, the handbook's own included —
|
|
1774
|
+
// except the misplaced-Conventions-block half, which is a stamp check: the handbook has no
|
|
1775
|
+
// block to place, and its AGENTS.md says it "follows the colab-handbook" (#587).
|
|
1776
|
+
checkInstructionFileBlocks(src, warn, { self: isSelf });
|
|
1775
1777
|
// #419: and prose left in CLAUDE.md / no AGENTS.md at all — same posture, same reason.
|
|
1776
1778
|
checkInstructionFileShape(src, warn);
|
|
1777
1779
|
|
|
@@ -2621,7 +2623,7 @@ function checkClaudeMdSize(src, warn, limits = thresholdsLib.DEFAULTS) {
|
|
|
2621
2623
|
// Both WARN, never FAIL: neither stops anything working, they cost tokens or drift tracking.
|
|
2622
2624
|
// Byte-identical CLAUDE.md and AGENTS.md (a symlinked or copied pair) are ONE file here, or
|
|
2623
2625
|
// every symlinked repo would warn on a duplicate it does not have.
|
|
2624
|
-
function checkInstructionFileBlocks(src, warn) {
|
|
2626
|
+
function checkInstructionFileBlocks(src, warn, { self = false } = {}) {
|
|
2625
2627
|
const read = (p) => src.readFile(p);
|
|
2626
2628
|
const loaded = instructionFile.collectLoaded(read, "CLAUDE.md").files;
|
|
2627
2629
|
const claude = loaded.find((f) => f.path === "CLAUDE.md");
|
|
@@ -2644,6 +2646,9 @@ function checkInstructionFileBlocks(src, warn) {
|
|
|
2644
2646
|
}
|
|
2645
2647
|
}
|
|
2646
2648
|
|
|
2649
|
+
// The handbook source carries no Conventions block by design (it is X, nothing to copy from),
|
|
2650
|
+
// so "the block moved out of CLAUDE.md" cannot be true of it — skip, like every stamp check.
|
|
2651
|
+
if (self) return;
|
|
2647
2652
|
const hasBlock = (t) => !!(parseClaudeStamp(t) || looksLikeHandbookClaude(t));
|
|
2648
2653
|
if (!(claude && hasBlock(claude.text))) {
|
|
2649
2654
|
const elsewhere = scan.filter((f) => f.path !== "CLAUDE.md" && hasBlock(f.text)).map((f) => f.path);
|
package/package.json
CHANGED