@amsterdamdatalabs/enact-operator 0.1.2

package/dist/shared/workflow/delivery/reviewStaleness.js

@@ -0,0 +1,94 @@
+/**
+ * D2 — Review convergence / staleness logic.
+ *
+ * computeReviewStaleState implements the three-predicate model from Phase 5 Q1:
+ *   P1: newer run post-dates review evidenceHorizon.verificationRunTimestamp AND commit hash differs → stale
+ *   P2: newer run on same OR different commit explicitly passes gates the review flagged failing → superseded
+ *   P3: same commit, ≥2 newer runs all agree previously-failing gates now pass → stale (flake guard)
+ *
+ * Priority: P2 > P1 > P3 (first match wins in priority order).
+ */
+/**
+ * Extract the set of gate IDs that the review flagged as failing.
+ * A review has no explicit gate-level data by default; callers may pass
+ * gate IDs embedded in notes as 'gate:<id>:failed' tags, or provide
+ * them via the `failingGateIds` option.
+ */
+function extractFailingGateIds(review, failingGateIds) {
+    if (failingGateIds)
+        return failingGateIds;
+    // Parse gate IDs from notes using convention: 'gate:<id>:failed'
+    const ids = [];
+    for (const note of review.notes) {
+        const match = /gate:([^:]+):failed/.exec(note);
+        if (match) {
+            ids.push(match[1]);
+        }
+    }
+    return ids;
+}
+/**
+ * Compute whether a review is current, stale, or superseded relative to
+ * a list of verification runs that happened after the review was created.
+ *
+ * @param review  The review item to assess.
+ * @param runs    All verification runs to compare against (order irrelevant).
+ * @param failingGateIds  Optional explicit list of gate IDs the review flagged failing.
+ *                        If omitted, gate IDs are parsed from review.notes.
+ */
+export function computeReviewStaleState(review, runs, failingGateIds) {
+    const horizon = review.evidenceHorizon;
+    // No horizon means the review predates evidence tracking — treat as current.
+    if (!horizon) {
+        return { staleState: 'current', trigger: null };
+    }
+    const reviewTimestamp = horizon.verificationRunTimestamp;
+    const reviewCommit = horizon.commitHash;
+    const citedGates = extractFailingGateIds(review, failingGateIds);
+    // Collect only runs that are strictly newer than the review's horizon timestamp.
+    const newerRuns = runs.filter((r) => r.runTimestamp > reviewTimestamp);
+    if (newerRuns.length === 0) {
+        return { staleState: 'current', trigger: null };
+    }
+    // ── P2 check (strongest) ─────────────────────────────────────────────────
+    // A newer run (any commit) explicitly passes ALL gates the review flagged failing.
+    if (citedGates.length > 0) {
+        for (const run of newerRuns) {
+            const allCitedGatesPass = citedGates.every((gateId) => {
+                const result = run.gateResults.find((g) => g.gateId === gateId);
+                return result?.passed === true;
+            });
+            if (allCitedGatesPass) {
+                return { staleState: 'superseded', trigger: 'P2' };
+            }
+        }
+    }
+    // ── P1 check ─────────────────────────────────────────────────────────────
+    // A newer run post-dates the review AND the commit hash differs.
+    for (const run of newerRuns) {
+        if (run.commitHash !== reviewCommit) {
+            return { staleState: 'stale', trigger: 'P1' };
+        }
+    }
+    // ── P3 check (flake guard) ────────────────────────────────────────────────
+    // Same commit, ≥2 distinct newer runs all agree previously-failing gates now pass.
+    // Single re-run with different result = flake, not signal.
+    if (citedGates.length > 0) {
+        const sameCommitNewerRuns = newerRuns.filter((r) => r.commitHash === reviewCommit);
+        // Require quorum of 2 distinct runs.
+        const distinctRunIds = new Set(sameCommitNewerRuns.map((r) => r.runId));
+        if (distinctRunIds.size >= 2) {
+            const allAgree = sameCommitNewerRuns.every((run) => {
+                return citedGates.every((gateId) => {
+                    const result = run.gateResults.find((g) => g.gateId === gateId);
+                    return result?.passed === true;
+                });
+            });
+            if (allAgree) {
+                return { staleState: 'stale', trigger: 'P3' };
+            }
+        }
+    }
+    return { staleState: 'current', trigger: null };
+}
+//# sourceMappingURL=reviewStaleness.js.map

package/dist/shared/workflow/delivery/reviewStaleness.js.map

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

package/dist/shared/workflow/planning/hyperplan.d.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+import { type OperatorTeamState } from '../../../lanes/team/index.js';
+declare const HyperplanRoundSchema: z.ZodObject<{
+    round: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
+    content: z.ZodString;
+}, z.core.$strip>;
+export type HyperplanRound = z.infer<typeof HyperplanRoundSchema>;
+export declare function startHyperplan(sessionId: string, root?: string): {
+    sessionId: string;
+    teamId: string;
+    roundPaths: string[];
+    statePath: string;
+    team: OperatorTeamState;
+    roundTaskIds: string[];
+    currentRound: 1;
+};
+export declare function completeHyperplanRound(input: {
+    sessionId: string;
+    round: 1 | 2 | 3;
+    content: string;
+}, root?: string): {
+    sessionId: string;
+    currentRound: 1 | 2 | 3;
+    completedRounds: number[];
+    readyForPlan: boolean;
+    roundPath: string;
+};
+export declare function prepareHyperplan(input: {
+    sessionId: string;
+    rounds: HyperplanRound[];
+    distilledBundle: string;
+}, root?: string): {
+    sessionId: string;
+    roundPaths: string[];
+    bundlePath: string;
+    handoffPath: string;
+    nextSkill: 'plan';
+};
+export {};
+//# sourceMappingURL=hyperplan.d.ts.map

package/dist/shared/workflow/planning/hyperplan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperplan.d.ts","sourceRoot":"","sources":["../../../../src/shared/workflow/planning/hyperplan.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAGrF,QAAA,MAAM,oBAAoB;;;iBAGxB,CAAC;AAQH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAiClE,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,IAAI,SAAwB,GAC3B;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,iBAAiB,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,CAAC,CAAC;CACjB,CA0CA;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC/D,IAAI,SAAwB,GAC3B;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,CA2BA;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE;IACL,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB,EACD,IAAI,SAAwB,GAC3B;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,CAoCA"}

package/dist/shared/workflow/planning/hyperplan.js

@@ -0,0 +1,133 @@
+import { join } from 'node:path';
+import { z } from 'zod';
+import { layoutPath, resolveOperatorRoot } from '../../../shared/core/contract.js';
+import { readJson, writeJson } from '../../../shared/core/json.js';
+import { ensureDir } from '../../../shared/core/json.js';
+import { writeFileSync } from 'node:fs';
+import { createTeam, readTeam } from '../../../lanes/team/index.js';
+import { queueTeamTask } from '../../../lanes/team/index.js';
+const HyperplanRoundSchema = z.object({
+    round: z.union([z.literal(1), z.literal(2), z.literal(3)]),
+    content: z.string().min(1),
+});
+const HyperplanPrepareInputSchema = z.object({
+    sessionId: z.string().min(1),
+    rounds: z.array(HyperplanRoundSchema).length(3),
+    distilledBundle: z.string().min(1),
+});
+function hyperplanDir(root, sessionId) {
+    return layoutPath(root, 'hyperplan', sessionId);
+}
+function hyperplanRoundPath(root, sessionId, round) {
+    return join(hyperplanDir(root, sessionId), `round-${round}.md`);
+}
+function hyperplanBundlePath(root, sessionId) {
+    return join(hyperplanDir(root, sessionId), 'distilled-bundle.md');
+}
+function hyperplanHandoffPath(root, sessionId) {
+    return join(hyperplanDir(root, sessionId), 'handoff.json');
+}
+function hyperplanStatePath(root, sessionId) {
+    return join(hyperplanDir(root, sessionId), 'state.json');
+}
+export function startHyperplan(sessionId, root = resolveOperatorRoot()) {
+    const safeSessionId = z.string().min(1).parse(sessionId);
+    const team = createTeam(root, `hyperplan-${safeSessionId}`, [
+        { id: 'critic-a', role: 'critic' },
+        { id: 'critic-b', role: 'critic' },
+        { id: 'architect', role: 'architect' },
+        { id: 'explore', role: 'explore' },
+    ]);
+    ensureDir(hyperplanDir(root, safeSessionId));
+    const roundPaths = [1, 2, 3].map((round) => {
+        const path = hyperplanRoundPath(root, safeSessionId, round);
+        writeFileSync(path, `# Round ${round}\n\nPending ${round === 1 ? 'independent analysis' : round === 2 ? 'cross-attack' : 'defend/refine/concede'}.\n`, 'utf8');
+        return path;
+    });
+    const roundTaskIds = [
+        queueTeamTask(root, 'Hyperplan round 1: independent analysis').id,
+        queueTeamTask(root, 'Hyperplan round 2: cross-attack').id,
+        queueTeamTask(root, 'Hyperplan round 3: defend/refine/concede').id,
+    ];
+    const statePath = hyperplanStatePath(root, safeSessionId);
+    writeJson(statePath, {
+        sessionId: safeSessionId,
+        teamId: team.id,
+        roundPaths,
+        roundTaskIds,
+        currentRound: 1,
+        createdAt: new Date().toISOString(),
+    });
+    const liveTeam = readTeam(root) ?? team;
+    return {
+        sessionId: safeSessionId,
+        teamId: team.id,
+        roundPaths,
+        statePath,
+        team: liveTeam,
+        roundTaskIds,
+        currentRound: 1,
+    };
+}
+export function completeHyperplanRound(input, root = resolveOperatorRoot()) {
+    const statePath = hyperplanStatePath(root, input.sessionId);
+    const state = readJson(statePath, null);
+    if (!state) {
+        throw new Error(`Hyperplan session "${input.sessionId}" not found.`);
+    }
+    if (state.currentRound !== input.round) {
+        throw new Error(`Hyperplan session "${input.sessionId}" expected round ${state.currentRound}, received round ${input.round}.`);
+    }
+    const roundPath = hyperplanRoundPath(root, input.sessionId, input.round);
+    writeFileSync(roundPath, input.content, 'utf8');
+    const completedRounds = [...new Set([...(state.completedRounds ?? []), input.round])].sort((a, b) => a - b);
+    const readyForPlan = input.round === 3;
+    const currentRound = input.round === 1 ? 2 : input.round === 2 ? 3 : 3;
+    writeJson(statePath, {
+        ...state,
+        currentRound,
+        completedRounds,
+        readyForPlan,
+    });
+    return {
+        sessionId: input.sessionId,
+        currentRound,
+        completedRounds,
+        readyForPlan,
+        roundPath,
+    };
+}
+export function prepareHyperplan(input, root = resolveOperatorRoot()) {
+    const parsed = HyperplanPrepareInputSchema.parse(input);
+    const seen = new Set(parsed.rounds.map((round) => round.round));
+    for (const required of [1, 2, 3]) {
+        if (!seen.has(required)) {
+            throw new Error(`hyperplan requires round-${required} content before handoff`);
+        }
+    }
+    ensureDir(hyperplanDir(root, parsed.sessionId));
+    const sortedRounds = [...parsed.rounds].sort((a, b) => a.round - b.round);
+    const roundPaths = sortedRounds.map((round) => {
+        const path = hyperplanRoundPath(root, parsed.sessionId, round.round);
+        writeFileSync(path, round.content, 'utf8');
+        return path;
+    });
+    const bundlePath = hyperplanBundlePath(root, parsed.sessionId);
+    writeFileSync(bundlePath, parsed.distilledBundle, 'utf8');
+    const handoffPath = hyperplanHandoffPath(root, parsed.sessionId);
+    writeJson(handoffPath, {
+        sessionId: parsed.sessionId,
+        nextSkill: 'plan',
+        roundPaths,
+        bundlePath,
+        createdAt: new Date().toISOString(),
+    });
+    return {
+        sessionId: parsed.sessionId,
+        roundPaths,
+        bundlePath,
+        handoffPath,
+        nextSkill: 'plan',
+    };
+}
+//# sourceMappingURL=hyperplan.js.map

package/dist/shared/workflow/planning/hyperplan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperplan.js","sourceRoot":"","sources":["../../../../src/shared/workflow/planning/hyperplan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAA0B,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC3B,CAAC,CAAC;AAEH,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACnC,CAAC,CAAC;AAIH,SAAS,YAAY,CAAC,IAAY,EAAE,SAAiB;IACnD,OAAO,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY,EAAE,SAAiB,EAAE,KAAgB;IAC3E,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,SAAS,KAAK,KAAK,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY,EAAE,SAAiB;IAC1D,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,qBAAqB,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY,EAAE,SAAiB;IAC3D,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,cAAc,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY,EAAE,SAAiB;IACzD,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,YAAY,CAAC,CAAC;AAC3D,CAAC;AAaD,MAAM,UAAU,cAAc,CAC5B,SAAiB,EACjB,IAAI,GAAG,mBAAmB,EAAE;IAU5B,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,UAAU,CACrB,IAAI,EACJ,aAAa,aAAa,EAAE,EAC5B;QACE,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;QAClC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;QAClC,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE;QACtC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;KACnC,CACF,CAAC;IACF,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACpD,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;QAC5D,aAAa,CAAC,IAAI,EAAE,WAAW,KAAK,eAAe,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,uBAAuB,KAAK,EAAE,MAAM,CAAC,CAAC;QAC/J,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IACH,MAAM,YAAY,GAAG;QACnB,aAAa,CAAC,IAAI,EAAE,yCAAyC,CAAC,CAAC,EAAE;QACjE,aAAa,CAAC,IAAI,EAAE,iCAAiC,CAAC,CAAC,EAAE;QACzD,aAAa,CAAC,IAAI,EAAE,0CAA0C,CAAC,CAAC,EAAE;KACnE,CAAC;IACF,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAC1D,SAAS,CAAC,SAAS,EAAE;QACnB,SAAS,EAAE,aAAa;QACxB,MAAM,EAAE,IAAI,CAAC,EAAE;QACf,UAAU;QACV,YAAY;QACZ,YAAY,EAAE,CAAC;QACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IACxC,OAAO;QACL,SAAS,EAAE,aAAa;QACxB,MAAM,EAAE,IAAI,CAAC,EAAE;QACf,UAAU;QACV,SAAS;QACT,IAAI,EAAE,QAAQ;QACd,YAAY;QACZ,YAAY,EAAE,CAAC;KAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,KAA+D,EAC/D,IAAI,GAAG,mBAAmB,EAAE;IAQ5B,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,QAAQ,CAA+B,SAAS,EAAE,IAAI,CAAC,CAAC;IACtE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,CAAC,SAAS,cAAc,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,CAAC,SAAS,oBAAoB,KAAK,CAAC,YAAY,oBAAoB,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;IACjI,CAAC;IACD,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACzE,aAAa,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5G,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC;IACvC,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,SAAS,CAAC,SAAS,EAAE;QACnB,GAAG,KAAK;QACR,YAAY;QACZ,eAAe;QACf,YAAY;KACmB,CAAC,CAAC;IACnC,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,YAAY;QACZ,eAAe;QACf,YAAY;QACZ,SAAS;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAIC,EACD,IAAI,GAAG,mBAAmB,EAAE;IAQ5B,MAAM,MAAM,GAAG,2BAA2B,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,KAAK,MAAM,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU,EAAE,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,yBAAyB,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAED,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1E,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC5C,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACrE,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/D,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IAE1D,MAAM,WAAW,GAAG,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACjE,SAAS,CAAC,WAAW,EAAE;QACrB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM;QACjB,UAAU;QACV,UAAU;QACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,CAAC;IAEH,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU;QACV,UAAU;QACV,WAAW;QACX,SAAS,EAAE,MAAM;KAClB,CAAC;AACJ,CAAC"}

package/dist/shared/workflow/planning/notepad.d.ts

@@ -0,0 +1,17 @@
+export declare const NOTEPAD_FILES: readonly ["learnings", "decisions", "issues", "problems"];
+export type NotepadFile = (typeof NOTEPAD_FILES)[number];
+export interface NotepadEntry {
+    path: string;
+    content: string;
+    exists: boolean;
+}
+export interface NotepadBundle {
+    lane: string;
+    sessionId: string;
+    dir: string;
+    files: Record<NotepadFile, NotepadEntry>;
+}
+export declare function renderNotepadContextSection(bundle: NotepadBundle): string;
+export declare function readNotepad(lane: string, sessionId: string, root?: string): NotepadBundle;
+export declare function appendNotepad(lane: string, sessionId: string, file: NotepadFile, entry: string, root?: string): void;
+//# sourceMappingURL=notepad.d.ts.map

package/dist/shared/workflow/planning/notepad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notepad.d.ts","sourceRoot":"","sources":["../../../../src/shared/workflow/planning/notepad.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,aAAa,2DAA4D,CAAC;AACvF,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;CAC1C;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAczE;AAgCD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,SAAwB,GAAG,aAAa,CAuBxG;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,SAAwB,GAC3B,IAAI,CAiBN"}

package/dist/shared/workflow/planning/notepad.js

@@ -0,0 +1,84 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { resolveOperatorRoot } from '../../../shared/core/contract.js';
+import { layoutPath } from '../../../shared/core/contract.js';
+import { ensureDir } from '../../../shared/core/json.js';
+export const NOTEPAD_FILES = ['learnings', 'decisions', 'issues', 'problems'];
+export function renderNotepadContextSection(bundle) {
+    const sections = NOTEPAD_FILES
+        .map((file) => {
+        const content = bundle.files[file].content.trim();
+        if (!content)
+            return null;
+        return `### ${file}\n${content}`;
+    })
+        .filter((section) => section !== null);
+    if (sections.length === 0) {
+        return `## CONTEXT\nNotepad lane=${bundle.lane} session=${bundle.sessionId}\n(no notepad entries)\n`;
+    }
+    return `## CONTEXT\nNotepad lane=${bundle.lane} session=${bundle.sessionId}\n\n${sections.join('\n\n')}\n`;
+}
+function validateSegment(value, name) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        throw new Error(`notepad ${name} must be a non-empty string`);
+    }
+    if (trimmed.includes('/') || trimmed.includes('\\') || trimmed.includes('..')) {
+        throw new Error(`notepad ${name} must be a single safe path segment`);
+    }
+    return trimmed;
+}
+function notepadDir(root, lane, sessionId) {
+    return layoutPath(root, lane, sessionId, 'notepad');
+}
+function notepadFilePath(root, lane, sessionId, file) {
+    return join(notepadDir(root, lane, sessionId), `${file}.md`);
+}
+function ensureCanonicalLayout(root, lane, sessionId) {
+    const dir = notepadDir(root, lane, sessionId);
+    ensureDir(dir);
+    for (const file of NOTEPAD_FILES) {
+        const path = notepadFilePath(root, lane, sessionId, file);
+        if (!existsSync(path)) {
+            writeFileSync(path, '', 'utf8');
+        }
+    }
+}
+export function readNotepad(lane, sessionId, root = resolveOperatorRoot()) {
+    const safeLane = validateSegment(lane, 'lane');
+    const safeSessionId = validateSegment(sessionId, 'sessionId');
+    const dir = notepadDir(root, safeLane, safeSessionId);
+    const files = Object.fromEntries(NOTEPAD_FILES.map((file) => {
+        const path = notepadFilePath(root, safeLane, safeSessionId, file);
+        const exists = existsSync(path);
+        return [file, {
+                path,
+                content: exists ? readFileSync(path, 'utf8') : '',
+                exists,
+            }];
+    }));
+    return {
+        lane: safeLane,
+        sessionId: safeSessionId,
+        dir,
+        files,
+    };
+}
+export function appendNotepad(lane, sessionId, file, entry, root = resolveOperatorRoot()) {
+    const safeLane = validateSegment(lane, 'lane');
+    const safeSessionId = validateSegment(sessionId, 'sessionId');
+    if (!NOTEPAD_FILES.includes(file)) {
+        throw new Error(`notepad file must be one of: ${NOTEPAD_FILES.join(', ')}`);
+    }
+    const trimmedEntry = entry.trim();
+    if (!trimmedEntry) {
+        throw new Error('notepad entry must be a non-empty string');
+    }
+    ensureCanonicalLayout(root, safeLane, safeSessionId);
+    const path = notepadFilePath(root, safeLane, safeSessionId, file);
+    const timestamp = new Date().toISOString();
+    const block = `## ${timestamp}\n${trimmedEntry}\n\n`;
+    const prefix = existsSync(path) ? readFileSync(path, 'utf8') : '';
+    writeFileSync(path, `${prefix}${block}`, 'utf8');
+}
+//# sourceMappingURL=notepad.js.map

package/dist/shared/workflow/planning/notepad.js.map

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

package/dist/shared/workflow/planning/planFormat.d.ts

@@ -0,0 +1,3 @@
+export type PlanFormatKind = 'ralph' | 'ultragoal';
+export declare function validatePlanFormat(planPath: string, kind: PlanFormatKind): void;
+//# sourceMappingURL=planFormat.d.ts.map

package/dist/shared/workflow/planning/planFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planFormat.d.ts","sourceRoot":"","sources":["../../../../src/shared/workflow/planning/planFormat.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,WAAW,CAAC;AAOnD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAO/E"}

package/dist/shared/workflow/planning/planFormat.js

@@ -0,0 +1,14 @@
+import { readFileSync } from 'node:fs';
+const REQUIRED_HEADERS = {
+    ralph: ['## TL;DR', '## Waves', '## Must Have', '## Must NOT Have', '## Final Verification Wave'],
+    ultragoal: ['## TL;DR', '## Waves', '## Must Have', '## Must NOT Have', '## Final Verification Wave'],
+};
+export function validatePlanFormat(planPath, kind) {
+    const requiredHeaders = REQUIRED_HEADERS[kind];
+    const content = readFileSync(planPath, 'utf8');
+    const missing = requiredHeaders.filter((header) => !content.includes(header));
+    if (missing.length > 0) {
+        throw new Error(`Invalid ${kind} plan format at "${planPath}": missing section(s): ${missing.join(', ')}.`);
+    }
+}
+//# sourceMappingURL=planFormat.js.map

package/dist/shared/workflow/planning/planFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planFormat.js","sourceRoot":"","sources":["../../../../src/shared/workflow/planning/planFormat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAIvC,MAAM,gBAAgB,GAAqC;IACzD,KAAK,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,4BAA4B,CAAC;IACjG,SAAS,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,4BAA4B,CAAC;CACtG,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,IAAoB;IACvE,MAAM,eAAe,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,oBAAoB,QAAQ,0BAA0B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9G,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,155 @@
+{
+  "name": "@amsterdamdatalabs/enact-operator",
+  "version": "0.1.2",
+  "description": "Enact Operator package — runtime CLI, MCP server, and hook handlers",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "https://dev.azure.com/amsterdamdatalabs/Enact/_git/enact-operator"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./autopilot": {
+      "types": "./dist/lanes/autopilot/index.d.ts",
+      "default": "./dist/lanes/autopilot/index.js"
+    },
+    "./activeSkill": {
+      "types": "./dist/shared/workflow/activation/activeSkill.d.ts",
+      "default": "./dist/shared/workflow/activation/activeSkill.js"
+    },
+    "./authority": {
+      "types": "./dist/shared/workflow/authority/authority.d.ts",
+      "default": "./dist/shared/workflow/authority/authority.js"
+    },
+    "./continuation": {
+      "types": "./dist/shared/workflow/continuation/continuation.d.ts",
+      "default": "./dist/shared/workflow/continuation/continuation.js"
+    },
+    "./continuationEventReservations": {
+      "types": "./dist/shared/workflow/continuation/continuationEventReservations.d.ts",
+      "default": "./dist/shared/workflow/continuation/continuationEventReservations.js"
+    },
+    "./continuationFollowUp": {
+      "types": "./dist/shared/workflow/continuation/continuationFollowUp.d.ts",
+      "default": "./dist/shared/workflow/continuation/continuationFollowUp.js"
+    },
+    "./subagentRuntime": {
+      "types": "./dist/shared/workflow/delegation/subagentRuntime.d.ts",
+      "default": "./dist/shared/workflow/delegation/subagentRuntime.js"
+    },
+    "./delegatedSession": {
+      "types": "./dist/shared/workflow/delegation/delegatedSession.d.ts",
+      "default": "./dist/shared/workflow/delegation/delegatedSession.js"
+    },
+    "./delegationPrompt": {
+      "types": "./dist/shared/workflow/delegation/delegationPrompt.d.ts",
+      "default": "./dist/shared/workflow/delegation/delegationPrompt.js"
+    },
+    "./hostRollout": {
+      "types": "./dist/shared/diagnostics/hostRollout.d.ts",
+      "default": "./dist/shared/diagnostics/hostRollout.js"
+    },
+    "./hookContinuation": {
+      "types": "./dist/shared/workflow/continuation/hookContinuation.d.ts",
+      "default": "./dist/shared/workflow/continuation/hookContinuation.js"
+    },
+    "./hooks": {
+      "types": "./dist/operator/hooks/hooks.d.ts",
+      "default": "./dist/operator/hooks/hooks.js"
+    },
+    "./hud": {
+      "types": "./dist/operator/hud.d.ts",
+      "default": "./dist/operator/hud.js"
+    },
+    "./modeMatrix": {
+      "types": "./dist/shared/workflow/activation/modeMatrix.d.ts",
+      "default": "./dist/shared/workflow/activation/modeMatrix.js"
+    },
+    "./runtime": {
+      "types": "./dist/operator/runtime.d.ts",
+      "default": "./dist/operator/runtime.js"
+    },
+    "./ralph": {
+      "types": "./dist/lanes/ralph/index.d.ts",
+      "default": "./dist/lanes/ralph/index.js"
+    },
+    "./skillActivation": {
+      "types": "./dist/shared/workflow/activation/skillActivation.d.ts",
+      "default": "./dist/shared/workflow/activation/skillActivation.js"
+    },
+    "./skillVariant": {
+      "types": "./dist/shared/workflow/activation/skillVariant.d.ts",
+      "default": "./dist/shared/workflow/activation/skillVariant.js"
+    },
+    "./stopPolicy": {
+      "types": "./dist/shared/workflow/continuation/stopPolicy.d.ts",
+      "default": "./dist/shared/workflow/continuation/stopPolicy.js"
+    },
+    "./stopVerdict": {
+      "types": "./dist/shared/workflow/continuation/stopVerdict.d.ts",
+      "default": "./dist/shared/workflow/continuation/stopVerdict.js"
+    },
+    "./team": {
+      "types": "./dist/lanes/team/index.d.ts",
+      "default": "./dist/lanes/team/index.js"
+    },
+    "./ultrawork": {
+      "types": "./dist/lanes/ultrawork/index.d.ts",
+      "default": "./dist/lanes/ultrawork/index.js"
+    },
+    "./operatorCore": {
+      "types": "./dist/operator/operatorCore.d.ts",
+      "default": "./dist/operator/operatorCore.js"
+    },
+    "./operatorRuntimeCore": {
+      "types": "./dist/operator/operatorRuntimeCore.d.ts",
+      "default": "./dist/operator/operatorRuntimeCore.js"
+    },
+    "./hookGating": {
+      "types": "./dist/operator/hooks/hookGating.d.ts",
+      "default": "./dist/operator/hooks/hookGating.js"
+    }
+  },
+  "bin": {
+    "enact-operator": "dist/mcp/server.js"
+  },
+  "files": [
+    "dist",
+    "runtime"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test:vitest": "node --experimental-vm-modules node_modules/vitest/vitest.mjs run",
+    "test:hooks": "node tests/hooks/run-all.mjs",
+    "build": "rm -rf dist && tsc -p tsconfig.json --noEmitOnError false && tsc-alias -p tsconfig.json && chmod +x dist/mcp/server.js",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run test:vitest && npm run test:hooks",
+    "test:parity-proof": "node --experimental-vm-modules node_modules/vitest/vitest.mjs run src/parityProof.test.ts",
+    "test:watch": "node --experimental-vm-modules node_modules/vitest/vitest.mjs"
+  },
+  "dependencies": {
+    "@iarna/toml": "^2.2.5",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "yaml": "^2.9.0",
+    "zod": "4.3.6"
+  },
+  "devDependencies": {
+    "@emnapi/core": "1.11.1",
+    "@emnapi/runtime": "1.11.1",
+    "@types/node": "^22.0.0",
+    "tsc-alias": "^1.8.10",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.7"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}

package/runtime/hooks/_continuation.mjs

@@ -0,0 +1,2 @@
+export * from "./shared/_continuation.mjs";
+

package/runtime/hooks/_lib.mjs

@@ -0,0 +1,2 @@
+export * from "./shared/_lib.mjs";
+

package/runtime/hooks/_toolGuards.mjs

@@ -0,0 +1,2 @@
+export * from "./shared/_toolGuards.mjs";
+