@detergent-software/conductor 3.0.0-dev.3 → 3.0.0-dev.30

package/build/profile-fields.js

@@ -0,0 +1,149 @@
+import { gt, lt, valid } from 'semver';
+import { z } from 'zod';
+import { parseJsonc } from "./jsonc.js";
+// The first conductor that reads protocol 2: one older refuses the profile on `protocol` first, so
+// a field it already read needs no minimum.
+export const PROTOCOL_2 = '2.0.0';
+// The conductor that first read each profile field as it is written today (ATK-577): a reshaped
+// field takes the version of its new shape. A profile that writes a field newer than PROTOCOL_2
+// needs its `conductor` minimum at or above that version. The type makes a new field a typecheck
+// error until it has a version; the README (On PATH) says which one a new field takes. A key
+// two tracker kinds share takes the newer kind's (Linear's releaseWait is 2.0.0's).
+export const FIELD_SINCE = {
+    approvers: PROTOCOL_2,
+    areaRelease: '2.2.0-dev.2',
+    baseBranch: PROTOCOL_2,
+    ci: PROTOCOL_2,
+    'ci.kind': PROTOCOL_2,
+    codeHost: PROTOCOL_2,
+    'codeHost.kind': PROTOCOL_2,
+    'codeHost.organization': PROTOCOL_2,
+    'codeHost.owner': PROTOCOL_2,
+    'codeHost.project': PROTOCOL_2,
+    'codeHost.repo': PROTOCOL_2,
+    'codeHost.repository': PROTOCOL_2,
+    conductor: '3.0.0-dev.9',
+    gates: PROTOCOL_2,
+    health: PROTOCOL_2,
+    localFilesFrom: '3.0.0-dev.4',
+    name: PROTOCOL_2,
+    npm: PROTOCOL_2,
+    'npm.package': PROTOCOL_2,
+    ports: '3.0.0-dev.4',
+    protocol: PROTOCOL_2,
+    release: PROTOCOL_2,
+    'release.handoff': PROTOCOL_2,
+    releases: PROTOCOL_2,
+    'releases.key': PROTOCOL_2,
+    'releases.kind': PROTOCOL_2,
+    'releases.package': PROTOCOL_2,
+    'releases.pipeline': PROTOCOL_2,
+    rules: PROTOCOL_2,
+    'rules.do': PROTOCOL_2,
+    'rules.id': PROTOCOL_2,
+    'rules.note': PROTOCOL_2,
+    'rules.when': PROTOCOL_2,
+    setup: '3.0.0-dev.4',
+    skills: PROTOCOL_2,
+    'skills.aliases': PROTOCOL_2,
+    'skills.verify': PROTOCOL_2,
+    'skills.work': PROTOCOL_2,
+    slots: PROTOCOL_2,
+    tracker: PROTOCOL_2,
+    'tracker.areaLabelGroup': PROTOCOL_2,
+    'tracker.areaPrefix': PROTOCOL_2,
+    'tracker.areaRoot': PROTOCOL_2,
+    'tracker.humanLabel': PROTOCOL_2,
+    'tracker.key': PROTOCOL_2,
+    'tracker.kind': PROTOCOL_2,
+    'tracker.organization': PROTOCOL_2,
+    'tracker.owner': PROTOCOL_2,
+    'tracker.priority': PROTOCOL_2,
+    'tracker.project': PROTOCOL_2,
+    'tracker.query': PROTOCOL_2,
+    'tracker.queue': PROTOCOL_2,
+    'tracker.queueLabel': PROTOCOL_2,
+    'tracker.releaseWait': '2.2.0-dev.3',
+    'tracker.releaseWait.label': '2.2.0-dev.3',
+    'tracker.releaseWait.shipped': '2.2.0-dev.3',
+    'tracker.repo': PROTOCOL_2,
+    'tracker.states': PROTOCOL_2,
+    'tracker.team': PROTOCOL_2,
+    'tracker.transitions': PROTOCOL_2,
+    'tracker.transitions.landed': PROTOCOL_2,
+    'tracker.transitions.pr-opened': PROTOCOL_2,
+    'tracker.transitions.started': PROTOCOL_2,
+    'tracker.triageLabel': PROTOCOL_2,
+    'tracker.workItemType': PROTOCOL_2,
+    train: PROTOCOL_2,
+    'train.maxHours': PROTOCOL_2,
+    'train.minimum': PROTOCOL_2,
+    'train.repo': PROTOCOL_2,
+    weight: PROTOCOL_2,
+    work: PROTOCOL_2,
+    'work.hooks': PROTOCOL_2,
+    'work.landing': PROTOCOL_2,
+    'work.landing.review': PROTOCOL_2,
+    'work.landing.reviewTiers': PROTOCOL_2,
+    workers: PROTOCOL_2,
+    'workers.tab': PROTOCOL_2,
+};
+// minimumProblems with the version that clears them, for `conduct project check`'s fix (ATK-580).
+export function minimumCheck(text, source, since = FIELD_SINCE) {
+    const profile = parseJsonc(text, z.unknown(), source);
+    const conductor = typeof profile === 'object' && profile !== null && 'conductor' in profile ? profile.conductor : undefined;
+    const minimum = typeof conductor === 'string' ? valid(conductor) : null;
+    const theirs = minimum !== null
+        ? `the profile's minimum is ${minimum}`
+        : conductor === undefined
+            ? 'the profile sets no "conductor" minimum'
+            : `the profile's minimum ${JSON.stringify(conductor)} is not a version`;
+    // `tracker` and `tracker.releaseWait` for `tracker.releaseWait.label`.
+    const parents = new Set();
+    for (const path of Object.keys(since))
+        for (let dot = path.indexOf('.'); dot !== -1; dot = path.indexOf('.', dot + 1))
+            parents.add(path.slice(0, dot));
+    const problems = [];
+    let needs = null;
+    for (const path of new Set(writtenFields(profile, parents))) {
+        const version = since[path];
+        if (version === undefined)
+            problems.push(`${path}: no conductor version recorded for it in profile-fields.ts`);
+        else if (lt(minimum ?? PROTOCOL_2, version)) {
+            problems.push(`${path}: needs conductor ${version} or newer; ${theirs}`);
+            if (needs === null || gt(version, needs))
+                needs = version;
+        }
+    }
+    // Raising the minimum writes `conductor`, so the version also covers the conductor that reads it.
+    const key = since.conductor;
+    if (needs !== null && key !== undefined && gt(key, needs))
+        needs = key;
+    return { needs, problems };
+}
+// Where a profile's `conductor` minimum is below a field it writes, one line each: a field newer
+// than the minimum, or than PROTOCOL_2 when it sets none, and a field with no recorded version. A
+// conductor test holds ATK's profile to it, so a PR that writes a new field raises the minimum too.
+export function minimumProblems(text, source, since = FIELD_SINCE) {
+    return minimumCheck(text, source, since).problems;
+}
+// The fields a profile writes, by their paths in FIELD_SINCE, in the order it writes them. Fields
+// a default fills in aren't written, so they need nothing. It looks inside a key only when it is
+// one of `parents`, the paths FIELD_SINCE records fields below, so a record's own names (health's
+// environments) aren't fields.
+function* writtenFields(value, parents, prefix = '') {
+    if (Array.isArray(value)) {
+        for (const item of value)
+            yield* writtenFields(item, parents, prefix);
+        return;
+    }
+    if (value === null || typeof value !== 'object')
+        return;
+    for (const [key, child] of Object.entries(value)) {
+        const path = prefix === '' ? key : `${prefix}.${key}`;
+        yield path;
+        if (parents.has(path))
+            yield* writtenFields(child, parents, path);
+    }
+}
+//# sourceMappingURL=profile-fields.js.map

package/build/profile-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-fields.js","sourceRoot":"","sources":["../src/profile-fields.ts"],"names":[],"mappings":"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"}

package/build/profile-layers.js

@@ -0,0 +1,264 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { lt, valid } from 'semver';
+import { z } from 'zod';
+import { ConductorError, isMissing } from "./errors.js";
+import { issueLines, parseJsonc } from "./jsonc.js";
+import { packageInfo } from "./package-info.js";
+import { PROJECT_NAME, projectOfPath, projectPaths } from "./paths.js";
+import { PROFILE_FILE, profileSchema, ProfileTooNewError } from "./profile.js";
+import { PROTOCOL } from "./protocol.js";
+// A project's profile in layers (design note v2, section 7): the machine's
+// <home>/projects/<name>.json over the repo's optional .claude/conductor.json. Objects merge key by
+// key with the machine winning, arrays are replaced whole, and `rules` stack: the machine's first,
+// so one of its rules shadows a repo rule with the same id. The merge runs on the files as written,
+// before the schema reads them, so a machine file beside a repo profile can be partial.
+export const LAYERS = ['machine', 'repo'];
+export const profileSourcesSchema = z.object({
+    // Each field's source by its dotted path, an array counting as one value; `default` when neither
+    // file writes it. `rules` is listed rule by rule instead.
+    fields: z.record(z.string(), z.enum(['default', ...LAYERS])),
+    // The machine profile, when there is one.
+    machine: z.string().nullable(),
+    // Where the repo layer was read, when there is one: `.claude/conductor.json at origin/<base>`.
+    repo: z.string().nullable(),
+    // The layer of each rule of the profile's `rules`, in order.
+    rules: z.array(z.enum(LAYERS)),
+});
+export const gitSync = (args, cwd) => {
+    const result = spawnSync('git', args, { cwd, encoding: 'utf8', timeout: 30_000, windowsHide: true });
+    return {
+        code: result.status ?? 1,
+        stderr: result.stderr ?? (result.error ? String(result.error) : ''),
+        stdout: result.stdout ?? '',
+    };
+};
+// The repo layer's path inside a commit: git spells it with forward slashes on every platform.
+const PROFILE_IN_GIT = '.claude/conductor.json';
+const rawSchema = z.record(z.string(), z.unknown());
+// The profile the worker verbs read where they run, without the daemon: the checkout's own
+// .claude/conductor.json (the branch's, as a worker's change to it would be) under the project's
+// machine file. The project is the one whose folder the checkout is in (<home>/projects/<name>/…),
+// else the one its own profile names, so a person's worktree of their own checkout reads too.
+// Null when neither layer exists: no project's checkout.
+export function checkoutProfile(paths, checkout) {
+    const repo = readLayer(join(checkout, PROFILE_FILE));
+    const name = projectOfPath(paths, checkout) ?? (typeof repo?.raw.name === 'string' ? repo.raw.name : null);
+    // A name the schema will refuse names no machine file either.
+    const machine = name !== null && PROJECT_NAME.test(name) ? readLayer(projectPaths(paths, name).profile) : null;
+    if (name === null || (machine === null && repo === null))
+        return null;
+    return layerProfile(name, { machine, repo });
+}
+// The layers merged and read: each layer's `conductor` minimum first, then the protocol, then the
+// schema, so a profile written for another version gets one clear message. `name` is the project's
+// registered name, which a machine file may repeat but not change.
+export function layerProfile(name, layers, running) {
+    const { machine, repo } = layers;
+    const present = [machine, repo].filter((l) => l !== null);
+    const source = present.map((l) => l.label).join(' over ');
+    if (machine !== null && machine.raw.name !== undefined && machine.raw.name !== name) {
+        throw new ConductorError(`${machine.label} renames the project`, [
+            `name: ${JSON.stringify(machine.raw.name)} is not "${name}", the name its file and folder give it; drop it, or put "${name}" back`,
+        ]);
+    }
+    for (const layer of present) {
+        const minimum = typeof layer.raw.conductor === 'string' ? valid(layer.raw.conductor) : null;
+        if (minimum === null)
+            continue;
+        const version = running ?? packageInfo().version;
+        if (lt(version, minimum))
+            throw new ProfileTooNewError(layer.label, minimum, version);
+    }
+    const merged = mergeLayers(machine?.raw ?? {}, repo?.raw ?? {});
+    merged.name = name;
+    if (merged.protocol !== PROTOCOL) {
+        throw new ConductorError(`${source} is invalid`, [
+            `protocol: ${JSON.stringify(merged.protocol ?? null)} is not supported; this conductor speaks protocol ${PROTOCOL}`,
+        ]);
+    }
+    const parsed = profileSchema.safeParse(merged);
+    if (!parsed.success)
+        throw new ConductorError(`${source} is invalid`, issueLines(parsed.error));
+    const machineRules = Array.isArray(machine?.raw.rules) ? machine.raw.rules.length : 0;
+    return {
+        layers,
+        profile: parsed.data,
+        sources: {
+            fields: fieldSources(parsed.data, machine?.raw ?? null, repo?.raw ?? null),
+            machine: machine?.label ?? null,
+            repo: repo?.label ?? null,
+            rules: parsed.data.rules.map((_rule, i) => (i < machineRules ? 'machine' : 'repo')),
+        },
+    };
+}
+// The repo layer over which the machine layer goes, key by key; `rules` stack, the machine's first.
+export function mergeLayers(machine, repo) {
+    const merged = mergeValue(repo, machine);
+    if (!isRecord(merged))
+        return {};
+    const rules = [...listOf(machine.rules), ...listOf(repo.rules)];
+    if (machine.rules !== undefined || repo.rules !== undefined)
+        merged.rules = rules;
+    return merged;
+}
+// The profile of the checkout a verb runs in, as checkoutProfile reads it, under the conductor home
+// `paths` names. Throws a ConductorError when it is no project's checkout or the profile doesn't read.
+export function profileHere(checkout, paths) {
+    const layered = checkoutProfile(paths, checkout);
+    if (layered === null) {
+        throw new ConductorError(`no ${PROFILE_FILE} in ${checkout}`, [
+            "run it in a project's worktree or checkout; a project with no committed profile keeps it in ~/.conductor/projects/<name>.json",
+        ]);
+    }
+    return layered.profile;
+}
+// `conduct profile <name>`: the files, each field with its value and source, then the rules in the
+// order they are checked, each with its layer.
+export function profileLines(name, { profile, sources }) {
+    const rows = Object.keys(sources.fields)
+        .sort()
+        .map((path) => [path, show(valueAt(profile, path)), sources.fields[path] ?? 'default']);
+    const width = Math.max(0, ...rows.map(([path]) => path.length));
+    const lines = [
+        `profile ${name}`,
+        `  machine: ${sources.machine ?? '(no machine profile)'}`,
+        `  repo:    ${sources.repo ?? '(no repo profile)'}`,
+        '',
+        ...rows.map(([path, value, source]) => `  ${path.padEnd(width)}  ${source.padEnd(7)}  ${value}`),
+    ];
+    if (profile.rules.length > 0) {
+        lines.push('', "rules (the machine's first: a rule shadows a later one with its id):");
+        profile.rules.forEach((rule, i) => {
+            const does = typeof rule.do === 'string' ? rule.do : rule.do.join('; ');
+            const when = rule.when === undefined ? '' : `when ${rule.when} → `;
+            lines.push(`  ${(sources.rules[i] ?? 'repo').padEnd(7)}  ${rule.id ?? `#${i + 1}`}: ${when}${does}`);
+        });
+    }
+    return lines;
+}
+// The profile a daemon-owned clone conducts: the machine file over .claude/conductor.json at
+// origin/<base> in <home>/projects/<name>/repo. The base is the machine's baseBranch, else
+// origin/HEAD's branch; when the repo's file there names another baseBranch, the file is read once
+// more at that one. `running` is this conductor's version, for the layers' `conductor` minimums.
+export function projectProfile(paths, name, git = gitSync, running) {
+    const { clone, profile: file } = projectPaths(paths, name);
+    if (!existsSync(join(clone, '.git')))
+        throw new ConductorError(`${name} has no clone at ${clone}`, ['add it with `conduct project add <url | path>`']);
+    const machine = readLayer(file);
+    const machineBase = typeof machine?.raw.baseBranch === 'string' ? machine.raw.baseBranch : null;
+    let base = machineBase ?? originHead(git, clone);
+    let repo = repoLayerAt(git, clone, base);
+    const named = typeof repo?.raw.baseBranch === 'string' ? repo.raw.baseBranch : null;
+    if (machineBase === null && named !== null && named !== base) {
+        base = named;
+        repo = repoLayerAt(git, clone, base);
+    }
+    if (machine === null && repo === null) {
+        throw new ConductorError(`${name} has no profile`, [
+            `neither ${file} nor ${PROFILE_IN_GIT} at origin/${base} in ${clone}`,
+            `write ${file} (a whole profile), or commit ${PROFILE_IN_GIT} to the repo`,
+        ]);
+    }
+    return layerProfile(name, { machine, repo }, running);
+}
+// A profile file's text as a layer. Throws a ConductorError naming the file when it isn't a JSONC
+// object.
+export function rawLayer(text, label) {
+    return { label, raw: parseJsonc(text, rawSchema, label) };
+}
+// A profile file as a layer; null when there is no file.
+export function readLayer(file) {
+    let text;
+    try {
+        text = readFileSync(file, 'utf8');
+    }
+    catch (error) {
+        if (isMissing(error))
+            return null;
+        throw new ConductorError(`could not read ${file}`, [String(error)]);
+    }
+    return rawLayer(text, file);
+}
+// .claude/conductor.json at origin/<base> in a clone, or null when that commit has none.
+export function repoLayerAt(git, clone, base) {
+    const ref = `origin/${base}`;
+    if (git(['rev-parse', '--verify', '--quiet', `${ref}^{commit}`], clone).code !== 0) {
+        throw new ConductorError(`${clone} has no ${ref}`, [
+            `check baseBranch ("${base}"); the conductor fetches the clone every few minutes`,
+        ]);
+    }
+    const spec = `${ref}:${PROFILE_IN_GIT}`;
+    if (git(['cat-file', '-e', spec], clone).code !== 0)
+        return null;
+    const shown = git(['show', spec], clone);
+    if (shown.code !== 0)
+        throw new ConductorError(`git show ${spec} failed in ${clone}`, [shown.stderr.trim()]);
+    return rawLayer(shown.stdout, `${PROFILE_IN_GIT} at ${ref} in ${clone}`);
+}
+// Each field's source, by its dotted path in the profile as read: the machine's when its file
+// writes the field, else the repo's, else the default's. Arrays and `rules` count as one value;
+// `name` is the registration's, which only a repo file of the same name can claim.
+function fieldSources(profile, machine, repo) {
+    const fields = {};
+    const walk = (value, path) => {
+        if (isRecord(value) && Object.keys(value).length > 0) {
+            for (const [key, child] of Object.entries(value))
+                walk(child, [...path, key]);
+            return;
+        }
+        fields[path.join('.')] = has(machine, path) ? 'machine' : has(repo, path) ? 'repo' : 'default';
+    };
+    for (const [key, value] of Object.entries(profile))
+        if (key !== 'rules')
+            walk(value, [key]);
+    fields.name = repo?.name === profile.name && machine?.name === undefined ? 'repo' : 'machine';
+    return fields;
+}
+function has(raw, path) {
+    let at = raw;
+    for (const key of path) {
+        if (!isRecord(at) || !Object.hasOwn(at, key))
+            return false;
+        at = at[key];
+    }
+    return at !== undefined;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function listOf(value) {
+    return Array.isArray(value) ? value : [];
+}
+function mergeValue(under, over) {
+    if (over === undefined)
+        return under;
+    if (!isRecord(under) || !isRecord(over))
+        return over;
+    const merged = { ...under };
+    for (const [key, value] of Object.entries(over))
+        merged[key] = mergeValue(under[key], value);
+    return merged;
+}
+// origin/HEAD's branch in a clone: the remote's default branch, which a clone records.
+function originHead(git, clone) {
+    const head = git(['symbolic-ref', '--short', 'refs/remotes/origin/HEAD'], clone);
+    const branch = head.code === 0 ? head.stdout.trim().replace(/^origin\//, '') : '';
+    if (branch === '') {
+        throw new ConductorError(`${clone} has no origin/HEAD`, [
+            `run git -C "${clone}" remote set-head origin --auto, or set baseBranch in the machine profile`,
+        ]);
+    }
+    return branch;
+}
+function show(value) {
+    return typeof value === 'string' ? value : (JSON.stringify(value) ?? '(unset)');
+}
+function valueAt(profile, path) {
+    let at = profile;
+    for (const key of path.split('.'))
+        at = isRecord(at) ? at[key] : undefined;
+    return at;
+}
+//# sourceMappingURL=profile-layers.js.map

package/build/profile-layers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-layers.js","sourceRoot":"","sources":["../src/profile-layers.ts"],"names":[],"mappings":"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"}

package/build/profile.js

@@ -1,15 +1,18 @@
-import { readFileSync } from 'node:fs';
-import { join } from 'node:path';
+import { isAbsolute, join } from 'node:path';
+import { lt, valid } from 'semver';
 import { z } from 'zod';
-import { ConductorError, isMissing } from "./errors.js";
+import { ConductorError } from "./errors.js";
 import { parseJsonc } from "./jsonc.js";
+import { packageInfo } from "./package-info.js";
+import { PROJECT_NAME } from "./paths.js";
 import { noteName } from "./plugin.js";
 import { PROTOCOL } from "./protocol.js";
+import { GATES } from "./release-kinds.js";
 import { ruleInputSchema } from "./rule-input.js";
+import { defaultTag } from "./upgrade.js";
 export const PROFILE_FILE = join('.claude', 'conductor.json');
-const name = z.string().regex(/^[a-z][a-z0-9-]*$/, 'lowercase letters, digits and dashes, starting with a letter');
+const name = z.string().regex(PROJECT_NAME, 'lowercase letters, digits and dashes, starting with a letter');
 const text = z.string().trim().min(1);
-const port = z.int().min(1).max(65535);
 // The state each phase note moves an item to, over the tracker kind's defaults (tracker-writes.ts);
 // null leaves it as it is.
 const transitions = z
@@ -48,33 +51,50 @@ const profileFields = z.strictObject({
             repo: z.string().regex(/^[\w.-]+$/, 'a GitHub repo name, without the owner'),
         }),
     ]),
-    // The kinds of note that wait on a person in this project.
-    gates: z.array(z.enum(['merge', 'npm-otp', 'plan'])).min(1),
+    // The oldest conductor that reads this profile (ATK-573): the version that first read its newest
+    // field (profile-fields.ts records each one's), a -dev.N while that is only on `dev`. parseProfile
+    // checks it before the rest, so an older conductor says which version to upgrade to instead of
+    // listing fields it doesn't know.
+    conductor: z
+        .string()
+        .refine((v) => valid(v) !== null, 'a version, such as 3.0.0-dev.8')
+        .optional(),
+    // The kinds of item that wait on a person in this project: plan, merge and each release kind's gate
+    // (release-kinds.ts: npm-otp for an npm-stage), which `conduct project check` looks for.
+    gates: z.array(z.enum(GATES)).min(1),
     // Each environment's /health URL, for `conduct wait health <env>`.
     health: z.record(name, z.url()).optional(),
+    // A checkout the operator keeps whose gitignored files matching its .worktreeinclude are copied
+    // into each new worktree (design note v2, section 2), for local files `setup` can't build. An
+    // absolute path; off when absent.
+    localFilesFrom: text.refine((path) => isAbsolute(path), 'an absolute path to a checkout').optional(),
     name,
     // The package `conduct wait npm <version>` means.
     npm: z.strictObject({ package: text }).optional(),
-    // The dev servers' base ports by name, such as { "web": 3000, "api": 7071 }: the main checkout
-    // serves on them, and the worktree the port broker gives offset N on each base + N, up to maxSlot.
+    // The ports a worktree's dev servers need, by name, such as ["web", "api"]. The port broker gives
+    // each worktree its own from the machine's pool, as CONDUCTOR_PORT_<NAME> to `setup` and the worker.
     ports: z
-        .object({ maxSlot: z.int().min(0).max(1000).default(50) })
-        .catchall(port)
-        .refine((ports) => Object.keys(ports).some((key) => key !== 'maxSlot'), 'declare at least one base port, such as "web": 3000')
-        // A misspelt maxSlot would otherwise read as a port named "maxslot".
-        .refine((ports) => Object.keys(ports).every((key) => key === 'maxSlot' || !key.toLowerCase().replace(/[-_]/g, '').startsWith('maxslot')), 'maxSlot is spelt "maxSlot"'),
+        .array(z.string().regex(/^[a-z][a-z0-9_]*$/, 'lowercase letters, digits and _, starting with a letter'))
+        .refine((names) => new Set(names).size === names.length, 'each port name once')
+        .default([]),
     // The worker protocol the project's work skill speaks (protocol.ts); only this conductor's.
     protocol: z.literal(PROTOCOL),
     release: z.strictObject({ handoff: text }),
-    // The pipelines that stage a release for a merge (`conduct runs`, `wait merge`): `npm-stage` stages
-    // `package` on npm for a person's `npm stage approve`. `pipeline` names it as --for does: its YAML
-    // file name (release-cli), path or own name.
+    // The pipelines that stage a release for a merge (`conduct runs`, `wait merge`), each of a kind
+    // release-kinds.ts reads: `npm-stage` stages `package` on npm for a person's `npm stage approve`.
+    // `pipeline` names it as --for does: its YAML file name (release-cli), path or own name.
     releases: z
-        .array(z.strictObject({ key: name, kind: z.literal('npm-stage'), package: text, pipeline: text }))
+        .array(z.discriminatedUnion('kind', [
+        z.strictObject({ key: name, kind: z.literal('npm-stage'), package: text, pipeline: text }),
+    ]))
         .default([]),
     // Project rules (design note, section 9): checked before the machine's and the defaults, for
     // this project's items only. They change by PR, and the daemon reloads them on save.
     rules: z.array(ruleInputSchema).default([]),
+    // Shell commands run in order in each new worktree, after `localFilesFrom`'s copy (design note v2,
+    // section 2): they build its gitignored files (installs, local settings) from what the repo commits.
+    // The first that fails fails the launch.
+    setup: z.array(text).default([]),
     // `aliases`: older names of the work skill. Notes headed with one still count, so an item in
     // flight when the work skill is renamed keeps its phases, approvals and review threads.
     skills: z.strictObject({ aliases: z.array(text).default([]), verify: text, work: text }),
@@ -176,8 +196,8 @@ const profileFields = z.strictObject({
             .prefault({}),
     })
         .prefault({}),
-    // How the daemon starts this project's workers. `tab` opens each in a Windows Terminal tab
-    // attached to its background session.
+    // Moved to the machine's config.json (workers.tab, ATK-529), and ignored here. Still read, so a
+    // profile written for an older conductor isn't refused; `conduct project check` warns about it.
     workers: z.strictObject({ tab: z.boolean().default(false) }).prefault({}),
 });
 // ADO Boards takes its organization and project from an Azure DevOps code host, and GitHub Issues
@@ -215,11 +235,6 @@ export function adoOrganization(profile) {
         return profile.codeHost.organization;
     return profile.tracker.kind === 'ado-boards' ? (profile.tracker.organization ?? null) : null;
 }
-// The profile's base ports by name, without maxSlot.
-export function basePorts(profile) {
-    const { maxSlot: _maxSlot, ...ports } = profile.ports;
-    return ports;
-}
 // The `<skill> · ` headings that mark a project's notes: its work skill's, then each alias's.
 // Without a profile, work-issue's, which every project used before profiles named their own. The
 // conductor plugin's skills head their notes with the bare name: `work-item · `, not
@@ -233,11 +248,30 @@ export function notePrefixes(profile) {
 export function trackerKey(profile) {
     return profile.tracker.kind === 'linear' ? profile.tracker.team : profile.tracker.key;
 }
-const protocolOnly = z.looseObject({ protocol: z.unknown().optional() });
-// The protocol is checked first, so a profile written for another version gets one clear message
-// instead of a list of schema differences.
-export function parseProfile(text, source) {
-    const { protocol } = parseJsonc(text, protocolOnly, source);
+const versionsOnly = z.looseObject({ conductor: z.unknown().optional(), protocol: z.unknown().optional() });
+// A profile whose `conductor` minimum is newer than this conductor. `upgrade` brings the machine up
+// to it: from `dev` for a -dev.N minimum, else from `latest`.
+export class ProfileTooNewError extends ConductorError {
+    upgrade;
+    constructor(source, minimum, running) {
+        const upgrade = `conduct upgrade --tag ${defaultTag(minimum)}`;
+        super(`${source} is invalid`, [`conductor: needs ${minimum} or newer; this is ${running}: run \`${upgrade}\``]);
+        this.name = 'ProfileTooNewError';
+        this.upgrade = upgrade;
+    }
+}
+// The conductor minimum, then the protocol, are checked first, so a profile written for another
+// version gets one clear message instead of a list of schema differences. `running` is this
+// conductor's version, read only for a profile with a minimum.
+export function parseProfile(text, source, running) {
+    const { conductor, protocol } = parseJsonc(text, versionsOnly, source);
+    // As semver reads it: `v3.0.0-dev.9` and `3.0.0-dev.9+abc` both mean 3.0.0-dev.9.
+    const minimum = typeof conductor === 'string' ? valid(conductor) : null;
+    if (minimum !== null) {
+        const version = running ?? packageInfo().version;
+        if (lt(version, minimum))
+            throw new ProfileTooNewError(source, minimum, version);
+    }
     if (protocol !== PROTOCOL) {
         throw new ConductorError(`${source} is invalid`, [
             `protocol: ${JSON.stringify(protocol ?? null)} is not supported; this conductor speaks protocol ${PROTOCOL}`,
@@ -245,19 +279,11 @@ export function parseProfile(text, source) {
     }
     return parseJsonc(text, profileSchema, source);
 }
-export function readProfile(root) {
-    const path = join(root, PROFILE_FILE);
-    let source;
-    try {
-        source = readFileSync(path, 'utf8');
-    }
-    catch (error) {
-        if (!isMissing(error))
-            throw error;
-        throw new ConductorError(`no ${PROFILE_FILE} in ${root}`, [
-            'a conducted project commits its profile at .claude/conductor.json',
-        ]);
-    }
-    return { path, profile: parseProfile(source, path) };
+// Why a profile didn't read, in one line: a ConductorError's problems after its file line (the
+// version it needs, the fields), so a verb that turns it into its own refusal keeps them.
+export function profileProblem(error) {
+    if (!(error instanceof ConductorError))
+        return error instanceof Error ? error.message : String(error);
+    return error.details.length > 0 ? error.details.join('; ') : error.message;
 }
 //# sourceMappingURL=profile.js.map