openplanr 1.18.0 → 1.19.0

package/dist/services/operate/routes.d.ts

@@ -1,6 +1,57 @@
 import { type OperatingArtifactGeneratorAdapter, type StoredOperatingArtifactGeneration } from './artifact-route-generation.js';
 import { type OperatingConfig, type OperatingEventHead, type OperatingFinding, type OperatingRoutePlan, type OperatingWorkspaceManifest } from './types.js';
+/**
+ * A single member of a grouped-finding epic. Only the fields needed to render
+ * the epic markdown are carried; the shared v1.3 route-plan schema stays
+ * single-`findingId` (the anchor) — this list is an OpenPlanr-local planning
+ * detail recorded in the epic document, never a protocol-schema field.
+ */
+export interface EpicFindingMember {
+    id: string;
+    title: string;
+    problem: string;
+    proposal: string;
+    evidenceRefs: string[];
+}
+/**
+ * A consolidation-level grouping of 2+ related accepted findings that routes to
+ * one `create-epic` action. `anchorId` is the lexicographically-first member id
+ * (carried as the route action's single `findingId`); `members` (sorted by id)
+ * is embedded verbatim in the generated epic markdown so finding → epic → spec
+ * provenance stays traceable without a new protocol sidecar.
+ */
+export interface EpicFindingGroup {
+    anchorId: string;
+    memberIds: string[];
+    members: EpicFindingMember[];
+    category: string;
+    theme: string;
+    evidenceRefs: string[];
+}
+interface GroupableFinding {
+    id: string;
+    status?: unknown;
+    category?: unknown;
+    title?: unknown;
+    problem?: unknown;
+    proposal?: unknown;
+    fingerprint?: unknown;
+    sensitivity?: unknown;
+    evidenceRefs?: unknown;
+}
+/**
+ * Group related accepted findings into epic candidates. Two accepted findings
+ * are related when they share a non-empty normalized `category`, share the same
+ * evidence-derived `fingerprint` lineage, or are semantically equivalent per
+ * `consolidation.ts` (which subsumes the Chair merge-proposal source, since a
+ * merged finding keeps that shared category/fingerprint). Only components of 2+
+ * members become epic groups; every group is deterministic (union-find over
+ * id-sorted findings), so the FR7 report suggestion and the FR8 engine route
+ * elect exactly the same theme.
+ */
+export declare function groupRelatedAcceptedFindings(findings: GroupableFinding[]): EpicFindingGroup[];
 export declare function nextOperatingSpecOrdinal(projectRoot: string): Promise<number>;
+export declare function nextOperatingEpicOrdinal(projectRoot: string): Promise<number>;
 export declare function createOperatingRoutePlan(input: {
     projectRoot: string;
     cycleId: string;
@@ -12,9 +63,41 @@ export declare function createOperatingRoutePlan(input: {
     providerDigest: `sha256:${string}`;
     sequence: number;
     specId?: string;
+    epicId?: string;
     localRoot?: string;
     now?: string;
 }): Promise<OperatingRoutePlan>;
+/**
+ * Re-evaluate a cycle's accepted findings for epic election and PROPOSE + accept
+ * one governed `create-epic` route per themed 2+-member group that does not yet
+ * have one. This is the operator-reachable producer of FR8 epic routes: it runs
+ * right after a finding transitions to `accepted` through `governOperatingFinding`,
+ * so accepting a related group yields a `create-epic` route through the same
+ * journal-backed proposal path the engine uses for freshly-proposed findings —
+ * reusing T-006's `groupRelatedAcceptedFindings`/`resolveEpicGroupForAnchor`/
+ * `actionKind` so FR7's rendered suggestion and FR8's route always name the same
+ * theme.
+ *
+ * Election never writes the epic markdown and never applies the route (accept ≠
+ * apply): it only proposes the route and accepts it — mirroring exactly how
+ * governance accepts a finding's individual route — leaving the digest-bound,
+ * human-gated `routes apply` as the separate acting step. It is idempotent: a
+ * group whose anchor already heads a committed `create-epic` route is skipped, so
+ * re-electing (accepting further members of the same theme) never duplicates the
+ * epic route. Membership growth before apply fails CLOSED rather than silently
+ * writing a different epic: `resolveEpicGroupForAnchor` re-derives the member
+ * list from the then-current accepted findings, so a route proposed for {A,B}
+ * whose group has grown to {A,B,C} no longer matches its digest-bound preview
+ * and `applyOperatingRoute` rejects it with `E_OPERATE_ROUTE_DRIFT` — the same
+ * guard every other route kind carries. An individually-routed finding is never
+ * re-routed individually — only the group-level epic route is added.
+ */
+export declare function electAcceptedFindingEpicRoutes(input: {
+    projectRoot: string;
+    localRoot?: string;
+    cycleId: string;
+    now?: string;
+}): Promise<OperatingRoutePlan[]>;
 export declare function readOperatingRoute(projectRoot: string, routeId: string): Promise<OperatingRoutePlan>;
 export declare function applyOperatingRoute(input: {
     projectRoot: string;
@@ -46,4 +129,5 @@ export declare function rollbackOperatingRoute(input: {
     localRoot?: string;
 }): Promise<OperatingEventHead>;
 export declare function routeDestinationDigest(projectRoot: string, route: OperatingRoutePlan): Promise<`sha256:${string}`>;
+export {};
 //# sourceMappingURL=routes.d.ts.map

package/dist/services/operate/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/services/operate/routes.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,iCAAiC,EAGtC,KAAK,iCAAiC,EACvC,MAAM,gCAAgC,CAAC;AAuBxC,OAAO,EAML,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EAGrB,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAChC,MAAM,YAAY,CAAC;AAiDpB,wBAAsB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQnF;AA0BD,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,0BAA0B,CAAC;IACtC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,cAAc,EAAE,UAAU,MAAM,EAAE,CAAC;IACnC,cAAc,EAAE,UAAU,MAAM,EAAE,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoH9B;AAuBD,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,kBAAkB,CAAC,CAI7B;AA6kBD,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,MAAM,EAAE,eAAe,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,iCAAiC,CAAC;IACtD,aAAa,CAAC,EAAE,CACd,QAAQ,EACJ,yBAAyB,GACzB,oBAAoB,GACpB,iBAAiB,GACjB,aAAa,GACb,oBAAoB,GACpB,kBAAkB,KACnB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B,GAAG,OAAO,CAAC;IACV,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,KAAK,EAAE,0BAA0B,GAAG,eAAe,GAAG,SAAS,CAAC;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,UAAU,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,EAAE;QACT,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,UAAU,MAAM,EAAE,CAAC;QACjC,QAAQ,EAAE,iCAAiC,CAAC,UAAU,CAAC,CAAC;KACzD,CAAC;IACF,WAAW,EAAE,KAAK,CAAC;CACpB,CAAC,CA+aD;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8D9B;AAED,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,UAAU,MAAM,EAAE,CAAC,CAY7B"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/services/operate/routes.ts"],"names":[],"mappings":"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"}