team 0.1.2 → 0.2.0

package/dist/watch/screen.js

@@ -4,10 +4,10 @@
 // runs on the plain form, and the styling tells a greyed suggestion from typed text.
 import { readFileSync } from 'node:fs';
 import { stripSgr } from "../ansi.js";
-import { classifyLines, composeLines, statusRowOf } from "./screen-core.js";
+import { classifyLines, composerBox, composeLines, foldMarked, foldOf, statusRowOf } from "./screen-core.js";
 import { loadScreen } from "./screen-file.js";
 function load(name) {
-    return loadScreen(readFileSync(new URL(`../profiles/${name}.yaml`, import.meta.url), 'utf8'));
+    return loadScreen(readFileSync(new URL(`../profiles/${name}.yaml`, import.meta.url), 'utf8'), undefined, `${name}.yaml`);
 }
 // Every shipped CLI is data. The core owns the order.
 const DATA = {
@@ -16,21 +16,29 @@ const DATA = {
     cursor: load('cursor'),
     antigravity: load('antigravity'),
 };
+/** The shipped screen for a CLI, or null when this version has none. */
+export function screenData(cli) {
+    return DATA[cli] ?? null;
+}
 // The window every pattern sees: the pane's last 20 lines. Styled lines are trimmed only past
 // their last escape; the core trims each line's plain form for matching.
 function windowOf(lines) {
     return lines.map((line) => line.trimEnd()).slice(-20);
 }
+/** The same classification `classify` runs, against a screen that may carry added patterns. */
+export function classifyData(data, lines) {
+    return classifyLines(data, windowOf(lines));
+}
 /** Every stage, in the core's order. The first one that matches wins. */
 export function classify(cli, lines) {
-    const data = DATA[cli];
+    const data = typeof cli === 'string' ? DATA[cli] : cli;
     if (!data)
         return { kind: 'unknown' };
     return classifyLines(data, windowOf(lines));
 }
 /** The composer alone. A running turn would otherwise hide an empty input box. */
 export function classifyComposer(cli, lines) {
-    const data = DATA[cli];
+    const data = typeof cli === 'string' ? DATA[cli] : cli;
     if (!data)
         return { kind: 'unknown' };
     return composeLines(data, windowOf(lines));
@@ -40,12 +48,38 @@ export function readScreen(cli, screen) {
         return { kind: 'unknown' };
     return classify(cli, screen.split('\n'));
 }
+/** The folded form of a paste the pane's composer shows, or null. The shape only; the caller
+ *  verifies it holds the text it typed before trusting it. */
+export function readFold(cli, screen) {
+    const data = typeof cli === 'string' ? DATA[cli] : cli;
+    if (data === undefined || screen === undefined)
+        return null;
+    return foldOf(data, windowOf(screen.split('\n')));
+}
+/** Whether the pane shows a fold marker at all, whatever count it names. The case `readFold`
+ *  cannot report — a marker claiming zero hidden rows — must still keep an Enter from taking the
+ *  box for an ordinary unsent one. */
+export function readFoldMark(cli, screen) {
+    const data = DATA[cli];
+    if (data === undefined || screen === undefined)
+        return false;
+    return foldMarked(data, windowOf(screen.split('\n')));
+}
+/** The input box the composer draws for its current text, or null when it does not read `unsent`.
+ *  The box's rows are the rows the pane drew for the text; the caller compares them to the text
+ *  it typed before any Enter. */
+export function readBox(cli, screen) {
+    const data = DATA[cli];
+    if (data === undefined || screen === undefined)
+        return null;
+    return composerBox(data, windowOf(screen.split('\n')));
+}
 /** The one line a quota figure may come from: the composer's own status row, in the pane's last
  * 20 lines, read plain — a figure is never styled. Null for a CLI with no status line, and for
  * a window that shows no status row — a dialog, a question, a trust screen, a shell or an
  * unknown one reads no figures. */
 export function statusRow(cli, screen) {
-    const data = DATA[cli];
+    const data = typeof cli === 'string' ? DATA[cli] : cli;
     if (data === undefined || screen === undefined)
         return null;
     return statusRowOf(data, windowOf(stripSgr(screen).split('\n')));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "team",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Set up, change and watch a project's team of AI agents from one file",
   "keywords": [
     "ai-agents",
@@ -16,7 +16,7 @@
   "type": "module",
   "bin": { "team": "dist/cli.js" },
   "exports": { ".": { "types": "./dist/index.d.ts", "default": "./dist/index.js" } },
-  "files": ["dist", "examples", "README.md", "LICENSE"],
+  "files": ["dist", "examples", "schema", "README.md", "LICENSE"],
   "engines": { "node": ">=22" },
   "repository": { "type": "git", "url": "git+https://github.com/floor/team.git" },
   "scripts": {
@@ -24,7 +24,13 @@
     "test": "bun test",
     "e2e": "bun scripts/e2e.ts",
     "build": "bun scripts/build.ts",
-    "ci": "bun run typecheck && bun test && bun run build && node dist/cli.js --version"
+    "conformance": "bun scripts/conformance.ts --impl \"node dist/cli.js conformance-adapter\"",
+    "coverage": "bun scripts/coverage.ts",
+    "coverage:check": "bun scripts/coverage.ts --check",
+    "schema:check": "bun scripts/schema.ts",
+    "contract": "bun scripts/contract.ts",
+    "contract:check": "bun scripts/contract.ts --check",
+    "ci": "bun run typecheck && bun test && bun run build && node dist/cli.js --version && bun run conformance && bun run schema:check && bun run contract:check && bun run coverage:check"
   },
   "devDependencies": {
     "@types/bun": "^1.2.0",

package/schema/team.schema.json

@@ -0,0 +1,498 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/floor/team/blob/main/schema/team.schema.json",
+  "title": "A team file",
+  "$comment": "generated from the section modules by scripts/schema.ts: the validator is the source of truth",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "format",
+    "project",
+    "coordinator",
+    "operator",
+    "seats"
+  ],
+  "properties": {
+    "format": {
+      "const": 1,
+      "$comment": "unquoted: this version of team reads no other"
+    },
+    "project": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"
+    },
+    "trust": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "$comment": "paths outside the project the seats may still work in, as the validator reads them"
+    },
+    "limits": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "seats": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "temporary": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "vendors": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "integer",
+            "minimum": 0
+          }
+        }
+      },
+      "$comment": "seats defaults to the declared seats plus temporary"
+    },
+    "machine": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "load_start": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        },
+        "load_max": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        },
+        "memory_start": {
+          "type": "string",
+          "pattern": "^[0-9]+(?:\\.[0-9]+)?(%)$"
+        },
+        "memory_min": {
+          "type": "string",
+          "pattern": "^[0-9]+(?:\\.[0-9]+)?(%)$"
+        },
+        "disk_min": {
+          "type": "string",
+          "pattern": "^[0-9]+(?:\\.[0-9]+)?(MB|GB|TB)$"
+        },
+        "swap_free_min": {
+          "type": "string",
+          "pattern": "^[0-9]+(?:\\.[0-9]+)?(MB|GB|TB)$"
+        },
+        "swap_growth_max": {
+          "type": "string",
+          "pattern": "^[0-9]+(?:\\.[0-9]+)?(MB|GB|TB)$"
+        },
+        "swap_growth_window": {
+          "type": "string",
+          "pattern": "^[0-9]+(?:\\.[0-9]+)?(s|m|h)$"
+        }
+      }
+    },
+    "rules": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "identity": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "signature": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "template": {
+              "type": "string"
+            },
+            "commits": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "template": {
+                  "type": "string"
+                },
+                "position": {
+                  "enum": [
+                    "last-line",
+                    "trailer",
+                    "anywhere"
+                  ]
+                },
+                "exempt": {
+                  "type": "array",
+                  "items": {
+                    "const": "merge"
+                  }
+                }
+              }
+            },
+            "pull_requests": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "template": {
+                  "type": "string"
+                },
+                "position": {
+                  "enum": [
+                    "last-line",
+                    "trailer",
+                    "anywhere"
+                  ]
+                }
+              }
+            }
+          }
+        },
+        "humans": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "since": {
+          "type": "string"
+        },
+        "forbidden": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "forbidden_public": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "$comment": "forbidden and forbidden_public are regular expressions; a template in the position \"trailer\" must read as a git trailer"
+    },
+    "workspace": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "mode": {
+          "enum": [
+            "worktree",
+            "shared"
+          ]
+        },
+        "path": {
+          "type": "string",
+          "pattern": "(^|/)\\{task\\}$"
+        },
+        "branch": {
+          "type": "string"
+        },
+        "base": {
+          "type": "string"
+        },
+        "setup": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "remove": {
+          "enum": [
+            "on-merge",
+            "manual"
+          ]
+        },
+        "protected": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "limit": {
+          "type": "integer",
+          "minimum": 1
+        }
+      },
+      "$comment": "path ends with the segment {task} under a fixed folder of its own, inside a trust pattern; branch defaults to {task}, base and path are required when a seat works in worktrees — the validator checks what a pattern cannot say"
+    },
+    "coordinator": {
+      "type": "string",
+      "minLength": 1,
+      "$comment": "must name a declared seat: one, without count, neither parked nor stopped"
+    },
+    "operator": {
+      "type": "string",
+      "minLength": 1,
+      "$comment": "must name a declared seat: one, without count, neither parked nor stopped"
+    },
+    "session": {
+      "type": "string",
+      "not": {
+        "const": "default"
+      }
+    },
+    "visibility": {
+      "enum": [
+        "public",
+        "private"
+      ]
+    },
+    "tools": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "kind": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "kind"
+        ],
+        "additionalProperties": {
+          "type": "string"
+        }
+      },
+      "$comment": "a tool is a name, then its kind and where it is; every field but the kind is text"
+    },
+    "budgets": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "stale_after": {
+          "type": "string",
+          "pattern": "^[0-9]+(?:\\.[0-9]+)?(s|m|h)$"
+        },
+        "check_every": {
+          "type": "string",
+          "pattern": "^[0-9]+(?:\\.[0-9]+)?(s|m|h)$"
+        },
+        "marks": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "number",
+            "exclusiveMinimum": 0,
+            "maximum": 100
+          }
+        },
+        "accounts": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "kind": {
+                "enum": [
+                  "subscription",
+                  "spend"
+                ]
+              },
+              "shared": {
+                "type": "boolean"
+              },
+              "reserve": {
+                "type": "string",
+                "pattern": "^[0-9]+(?:\\.[0-9]+)?(%)$"
+              },
+              "floor": {
+                "type": "string",
+                "pattern": "^[0-9]+(?:\\.[0-9]{1,4})? [A-Z]{3}$"
+              },
+              "sources": {
+                "type": "array",
+                "minItems": 1,
+                "items": {
+                  "enum": [
+                    "check",
+                    "status_line"
+                  ]
+                }
+              },
+              "check": {
+                "type": "string",
+                "pattern": "^\\S+$"
+              }
+            },
+            "required": [
+              "kind"
+            ],
+            "allOf": [
+              {
+                "if": {
+                  "properties": {
+                    "kind": {
+                      "const": "subscription"
+                    }
+                  },
+                  "required": [
+                    "kind"
+                  ]
+                },
+                "then": {
+                  "required": [
+                    "reserve"
+                  ]
+                },
+                "else": {
+                  "required": [
+                    "floor"
+                  ]
+                }
+              }
+            ]
+          },
+          "$comment": "a subscription has a reserve, a spend account a floor; a spend account never reads a screen"
+        }
+      }
+    },
+    "watch": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "interval": {
+          "type": "string",
+          "pattern": "^[0-9]+(?:\\.[0-9]+)?(s|m|h)$"
+        },
+        "idle_first": {
+          "type": "string",
+          "pattern": "^[0-9]+(?:\\.[0-9]+)?(s|m|h)$"
+        },
+        "idle_repeat": {
+          "type": "string",
+          "pattern": "^[0-9]+(?:\\.[0-9]+)?(s|m|h)$"
+        },
+        "team_idle": {
+          "type": "string",
+          "pattern": "^[0-9]+(?:\\.[0-9]+)?(s|m|h)$"
+        },
+        "nudge_wait": {
+          "type": "string",
+          "pattern": "^[0-9]+(?:\\.[0-9]+)?(s|m|h)$"
+        },
+        "unsent_after": {
+          "type": "string",
+          "pattern": "^[0-9]+(?:\\.[0-9]+)?(s|m|h)$"
+        },
+        "quota_marks": {
+          "type": "array",
+          "items": {
+            "type": "number",
+            "exclusiveMinimum": 0,
+            "maximum": 100
+          },
+          "deprecated": true,
+          "$comment": "now budgets.marks, and still read"
+        },
+        "checks": {
+          "type": "object",
+          "propertyNames": {
+            "enum": [
+              "unsent",
+              "idle",
+              "extra",
+              "team-idle",
+              "load",
+              "memory",
+              "disk",
+              "swap-free",
+              "swap-growth",
+              "budget"
+            ]
+          },
+          "additionalProperties": {
+            "const": "off"
+          },
+          "$comment": "the four that always run (attention, missing, model-drift, approval) are refused here too"
+        }
+      }
+    },
+    "seats": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "role": {
+            "type": "string",
+            "minLength": 1
+          },
+          "name": {
+            "type": "string",
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"
+          },
+          "cli": {
+            "enum": [
+              "claude-code",
+              "codex",
+              "cursor",
+              "grok",
+              "antigravity"
+            ]
+          },
+          "vendor": {
+            "type": "string",
+            "minLength": 1
+          },
+          "account": {
+            "type": "string"
+          },
+          "model": {
+            "type": "string",
+            "minLength": 1
+          },
+          "version": {
+            "type": "string",
+            "$comment": "quoted: unquoted, YAML reads 4.10 as the number 4.1"
+          },
+          "display": {
+            "type": "string",
+            "$comment": "defaults to \"model version\"; must contain the version as a token of its own"
+          },
+          "launch": {
+            "type": "string",
+            "minLength": 1
+          },
+          "cwd": {
+            "type": "string",
+            "$comment": "relative to the project, or a trust path"
+          },
+          "label": {
+            "type": "string"
+          },
+          "mode": {
+            "enum": [
+              "worktree",
+              "shared"
+            ]
+          },
+          "parked": {
+            "type": "boolean"
+          },
+          "stopped": {
+            "type": "boolean"
+          },
+          "count": {
+            "type": "integer",
+            "minimum": 1
+          }
+        },
+        "required": [
+          "role",
+          "name",
+          "cli",
+          "vendor",
+          "model",
+          "version",
+          "launch"
+        ],
+        "$comment": "account must name a key of budgets.accounts; label defaults to the model and version; a seat with count is neither lead"
+      }
+    }
+  }
+}