@pennixrv/trellis 0.7.1 → 0.7.2-beta.2

package/dist/commands/teamwork/coordination.d.ts

@@ -0,0 +1,88 @@
+import { z } from "zod";
+export declare const COORDINATION_MODES: readonly ["general", "advisor", "committee"];
+export type CoordinationMode = (typeof COORDINATION_MODES)[number];
+export declare const TEAMWORK_CONFIG_PATH = ".trellis/teamwork.json";
+declare const configSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<2>;
+    default_mode: z.ZodEnum<{
+        general: "general";
+        advisor: "advisor";
+        committee: "committee";
+    }>;
+    modes: z.ZodObject<{
+        general: z.ZodType<{
+            default_members: number;
+            max_concurrency: number;
+        }, unknown, z.core.$ZodTypeInternals<{
+            default_members: number;
+            max_concurrency: number;
+        }, unknown>>;
+        advisor: z.ZodType<{
+            default_members: number;
+            max_concurrency: number;
+        }, unknown, z.core.$ZodTypeInternals<{
+            default_members: number;
+            max_concurrency: number;
+        }, unknown>>;
+        committee: z.ZodType<{
+            default_members: number;
+            max_concurrency: number;
+        }, unknown, z.core.$ZodTypeInternals<{
+            default_members: number;
+            max_concurrency: number;
+        }, unknown>>;
+    }, z.core.$strict>;
+    resources: z.ZodObject<{
+        max_live_teammates: z.ZodNumber;
+        non_batch_reserved: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const DEFAULT_TEAMWORK_CONFIG: {
+    schema_version: 2;
+    default_mode: "general";
+    modes: {
+        general: {
+            default_members: number;
+            max_concurrency: number;
+        };
+        advisor: {
+            default_members: number;
+            max_concurrency: number;
+        };
+        committee: {
+            default_members: number;
+            max_concurrency: number;
+        };
+    };
+    resources: {
+        max_live_teammates: number;
+        non_batch_reserved: number;
+    };
+};
+export declare function readCoordinationConfig(cwd: string): {
+    config: z.infer<typeof configSchema>;
+    legacy: boolean;
+    configDigest: string;
+    source: string;
+};
+export declare function resolveCoordination(cwd: string, mode?: CoordinationMode): {
+    mode: CoordinationMode;
+    defaultMembers: number;
+    maxConcurrency: number;
+    configDigest: string;
+    snapshot: ReturnType<typeof readCoordinationConfig>["config"];
+};
+/** Resource policy may tighten after freezing; semantic defaults may not drift. */
+export declare function assertFrozenCoordination(cwd: string, digest: string, snapshot?: unknown, runtime?: {
+    mode: CoordinationMode;
+    maxConcurrency: number;
+    guard?: {
+        maxLiveTeammates: number;
+        nonBatchReserved: number;
+    };
+}): void;
+export declare function assertCoordinationMembers(mode: CoordinationMode, members: readonly {
+    lens?: string;
+}[]): void;
+export {};
+//# sourceMappingURL=coordination.d.ts.map

package/dist/commands/teamwork/coordination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordination.d.ts","sourceRoot":"","sources":["../../../src/commands/teamwork/coordination.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,kBAAkB,8CAA+C,CAAC;AAC/E,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AACnE,eAAO,MAAM,oBAAoB,2BAA2B,CAAC;AA8B7D,QAAA,MAAM,YAAY;;;;;;;;;6BAPc,MAAM;6BAAmB,MAAM;;6BAA/B,MAAM;6BAAmB,MAAM;;;6BAA/B,MAAM;6BAAmB,MAAM;;6BAA/B,MAAM;6BAAmB,MAAM;;;6BAA/B,MAAM;6BAAmB,MAAM;;6BAA/B,MAAM;6BAAmB,MAAM;;;;;;;kBA+B5D,CAAC;AAEJ,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;CASnC,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG;IACnD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,CAqCA;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,gBAAgB,GACtB;IACD,IAAI,EAAE,gBAAgB,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,QAAQ,CAAC,CAAC;CAC/D,CAUA;AAED,mFAAmF;AACnF,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,OAAO,EAClB,OAAO,CAAC,EAAE;IACR,IAAI,EAAE,gBAAgB,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE,GACA,IAAI,CAuCN;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GACpC,IAAI,CAcN"}

package/dist/commands/teamwork/coordination.js

@@ -0,0 +1,153 @@
+import crypto from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+import { readTeamworkAsset } from "./profiles.js";
+export const COORDINATION_MODES = ["general", "advisor", "committee"];
+export const TEAMWORK_CONFIG_PATH = ".trellis/teamwork.json";
+const legacySchema = z
+    .object({
+    schema_version: z.literal(1),
+    default_mode: z.enum(COORDINATION_MODES),
+    modes: z
+        .object({
+        general: z
+            .object({ default_members: z.number().int().min(1).max(32) })
+            .strict(),
+        advisor: z.object({ default_members: z.literal(1) }).strict(),
+        committee: z
+            .object({ default_members: z.number().int().min(2).max(3) })
+            .strict(),
+    })
+        .strict(),
+})
+    .strict();
+const modeSchema = (min, max) => z
+    .object({
+    default_members: z.number().int().min(min).max(max),
+    max_concurrency: z.number().int().positive().max(32),
+})
+    .strict();
+const configSchema = z
+    .object({
+    schema_version: z.literal(2),
+    default_mode: z.enum(COORDINATION_MODES),
+    modes: z
+        .object({
+        general: modeSchema(1, 32),
+        advisor: modeSchema(1, 3),
+        committee: modeSchema(2, 3),
+    })
+        .strict(),
+    resources: z
+        .object({
+        max_live_teammates: z.number().int().nonnegative(),
+        non_batch_reserved: z.number().int().nonnegative(),
+    })
+        .strict(),
+})
+    .strict()
+    .refine((c) => c.resources.max_live_teammates === 0 ||
+    c.resources.non_batch_reserved < c.resources.max_live_teammates, "reserved capacity must be below the live budget");
+export const DEFAULT_TEAMWORK_CONFIG = {
+    schema_version: 2,
+    default_mode: "general",
+    modes: {
+        general: { default_members: 1, max_concurrency: 8 },
+        advisor: { default_members: 3, max_concurrency: 3 },
+        committee: { default_members: 3, max_concurrency: 3 },
+    },
+    resources: { max_live_teammates: 8, non_batch_reserved: 0 },
+};
+export function readCoordinationConfig(cwd) {
+    const file = path.join(cwd, TEAMWORK_CONFIG_PATH);
+    const exists = fs.existsSync(file);
+    const raw = exists
+        ? readTeamworkAsset(cwd, TEAMWORK_CONFIG_PATH)
+        : JSON.stringify(DEFAULT_TEAMWORK_CONFIG);
+    const input = JSON.parse(raw);
+    const legacy = input.schema_version === 1;
+    const config = legacy
+        ? (() => {
+            const old = legacySchema.parse(input);
+            return {
+                ...DEFAULT_TEAMWORK_CONFIG,
+                default_mode: old.default_mode,
+                modes: {
+                    general: {
+                        ...DEFAULT_TEAMWORK_CONFIG.modes.general,
+                        default_members: old.modes.general.default_members,
+                    },
+                    advisor: {
+                        ...DEFAULT_TEAMWORK_CONFIG.modes.advisor,
+                        default_members: old.modes.advisor.default_members,
+                    },
+                    committee: {
+                        ...DEFAULT_TEAMWORK_CONFIG.modes.committee,
+                        default_members: old.modes.committee.default_members,
+                    },
+                },
+            };
+        })()
+        : configSchema.parse(input);
+    return {
+        config,
+        legacy: legacy || !exists,
+        configDigest: crypto.createHash("sha256").update(raw).digest("hex"),
+        source: exists ? TEAMWORK_CONFIG_PATH : "built-in",
+    };
+}
+export function resolveCoordination(cwd, mode) {
+    const { config, configDigest } = readCoordinationConfig(cwd);
+    const selected = mode ?? config.default_mode;
+    return {
+        mode: selected,
+        defaultMembers: config.modes[selected].default_members,
+        maxConcurrency: config.modes[selected].max_concurrency,
+        configDigest,
+        snapshot: config,
+    };
+}
+/** Resource policy may tighten after freezing; semantic defaults may not drift. */
+export function assertFrozenCoordination(cwd, digest, snapshot, runtime) {
+    const current = readCoordinationConfig(cwd);
+    const live = (value) => (value === 0 ? Infinity : value);
+    if (snapshot &&
+        runtime &&
+        (runtime.maxConcurrency >
+            configSchema.parse(snapshot).modes[runtime.mode].max_concurrency ||
+            (runtime.guard &&
+                (live(runtime.guard.maxLiveTeammates) >
+                    live(configSchema.parse(snapshot).resources.max_live_teammates) ||
+                    runtime.guard.nonBatchReserved <
+                        configSchema.parse(snapshot).resources.non_batch_reserved))))
+        throw new Error("Runtime override expands frozen capacity policy; construct a new plan");
+    if (current.configDigest === digest)
+        return;
+    if (!snapshot)
+        throw new Error("Frozen coordination configuration changed; construct a new plan");
+    const frozen = configSchema.parse(snapshot);
+    const next = current.config;
+    if (next.default_mode !== frozen.default_mode ||
+        COORDINATION_MODES.some((mode) => next.modes[mode].default_members !==
+            frozen.modes[mode].default_members ||
+            next.modes[mode].max_concurrency > frozen.modes[mode].max_concurrency) ||
+        live(next.resources.max_live_teammates) >
+            live(frozen.resources.max_live_teammates) ||
+        next.resources.non_batch_reserved < frozen.resources.non_batch_reserved)
+        throw new Error("Frozen coordination configuration changed or resource policy expanded; construct a new plan");
+}
+export function assertCoordinationMembers(mode, members) {
+    if (members.length === 0)
+        throw new Error("Teamwork requires at least one assignment");
+    if (mode === "advisor" && members.length > 3)
+        throw new Error("advisor requires one to three assignments");
+    if (mode === "committee") {
+        if (members.length < 2 || members.length > 3)
+            throw new Error("committee requires two or three assignments");
+        const lenses = members.map((member) => member.lens?.trim());
+        if (lenses.some((lens) => !lens) || new Set(lenses).size !== members.length)
+            throw new Error("committee requires distinct lenses (本次关注点), each nonempty");
+    }
+}
+//# sourceMappingURL=coordination.js.map

package/dist/commands/teamwork/coordination.js.map

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

package/dist/commands/teamwork/coordinator.d.ts

@@ -1,7 +1,7 @@
 import { type TeamworkPlan } from "./artifact.js";
 import { type TeammateHostCapabilities } from "./teammate-adapters.js";
 import { type TeammateRuntimeConfig } from "./teammate-config.js";
-import { resolveTeammateProfile } from "./profiles.js";
+import type { resolveTeammateProfile } from "./profiles.js";
 import { type TeammateLaunchSpec } from "./teammate-launch.js";
 export type AttemptWaitResult = {
     kind: "report";
@@ -49,13 +49,13 @@ export interface TeammateGuard {
     }): Promise<void>;
 }
 export interface CoordinatorRuntime {
+    prepare?(context: TeammateDispatchContext): void;
     dispatch(context: TeammateDispatchContext): Promise<undefined | {
         providerSessionId?: string;
     }>;
     wait(context: TeammateDispatchContext): Promise<AttemptWaitResult>;
     continue(context: TeammateDispatchContext): Promise<AttemptWaitResult>;
     cancel?(context: TeammateDispatchContext): Promise<AttemptWaitResult>;
-    validateReport?(context: TeammateDispatchContext, report: unknown): Promise<boolean> | boolean;
 }
 export interface TeamworkCoordinatorInput {
     plan: unknown;
@@ -67,13 +67,15 @@ export interface TeamworkCoordinatorInput {
     guard: TeammateGuard;
     config?: TeammateRuntimeConfig;
 }
+export declare class TeamworkPolicyChangedError extends Error {
+}
 export interface TeamworkReceipt {
     schemaVersion: 1;
     batchId: string;
-    status: "ALL_ACCEPTED" | "SETTLED_WITH_FAILURE" | "RECONCILIATION_REQUIRED";
+    status: "AWAITING_REVIEW" | "ALL_ACCEPTED" | "SETTLED_WITH_FAILURE" | "RECONCILIATION_REQUIRED";
     assignments: {
         assignmentId: string;
-        status: "ACCEPTED" | "FINAL_FAILED" | "UNKNOWN";
+        status: "AWAITING_REVIEW" | "ACCEPTED" | "FINAL_FAILED" | "UNKNOWN";
     }[];
     capacity: number;
     retryCounts: Record<string, number>;
@@ -82,8 +84,33 @@ export interface TeamworkReceipt {
         status: "COMPLETE" | "INCOMPLETE";
     }[];
 }
-export declare function assertTeamworkPlanCurrent(plan: TeamworkPlan, taskRoot: string): void;
+export declare function assertTeamworkPlanCurrent(plan: Pick<TeamworkPlan, "taskId" | "phaseId" | "taskRouteRevision" | "inputRevision">, taskRoot: string): void;
+export declare function readPlanFile(planPath: string): unknown;
 export declare function loadTeamworkPlan(planPath: string, taskRoot: string): TeamworkPlan;
 export declare function runTeamworkCoordinator(input: TeamworkCoordinatorInput): Promise<TeamworkReceipt>;
-export declare function assertTeamworkReceiptDurable(sessionId: string, batchId: string, planHash: string, cwd?: string): Promise<void>;
+export declare function assertTeamworkReceiptDurable(plan: TeamworkPlan, receipt: TeamworkReceipt, cwd?: string): Promise<void>;
+/** Retire uncertain work only from associated terminal or process-birth evidence. */
+export declare function reconcileTeamworkBatch(input: {
+    plan: TeamworkPlan;
+    cwd: string;
+    execute?: boolean;
+    reason?: string;
+    confirmUnknownProcessExit?: boolean;
+}): Promise<TeamworkReceipt | {
+    status: "ready" | "blocked";
+    blockers: string[];
+}>;
+/** Read settled facts without admitting work or consulting current resource policy. */
+export declare function readSettledTeamworkReceipt(plan: TeamworkPlan, cwd: string): Promise<TeamworkReceipt | undefined>;
+/** Main-agent review starts only after the CLI has drained the entire batch. */
+export declare function reviewTeamworkReport(input: {
+    plan: TeamworkPlan;
+    taskRoot: string;
+    cwd: string;
+    assignmentId: string;
+    reportSha256: string;
+    decision: "accepted" | "final_failed";
+    reason: string;
+    by?: string;
+}): Promise<TeamworkReceipt>;
 //# sourceMappingURL=coordinator.d.ts.map

package/dist/commands/teamwork/coordinator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../../src/commands/teamwork/coordinator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../../src/commands/teamwork/coordinator.ts"],"names":[],"mappings":"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"}