@sentropic/track 0.19.4 → 0.20.0

package/dist/report/directive.js

@@ -0,0 +1,312 @@
+// preconisation-actionnable (DESIGN LOCKED) — the DIRECTIVE selector. Replaces the constant
+// `préconisation` (which took `leaves[0]` and emitted one frozen phrase per WP) with a DIRECTIVE
+// DERIVED from each item's real state, langue-neutre, and DELEGABLE as-is to a subagent.
+//
+// PURE & ADDITIVE: every fact a directive needs is already on `WpLeaf` (enriched in rollup.ts via
+// `acceptanceStatus` + `effectiveOpenBlockersForItem`) — the selector recomputes NOTHING. No new event,
+// INGEST unchanged. The enums are a GOVERNED vocabulary (additive only, never renamed; an unknown
+// `step.code` degrades to `inspect-fallback` at the renderer — forward-compat, see §3/§7 of the DESIGN).
+// ---- record-only commandHint allowlist (DESIGN §5) -------------------------------------------------
+// `commandHint` = verbs of MEASURE / ATTENTION / FOCUS only. A directive NEVER hints at fabricating an
+// outcome (`item realize <id> done`, `accept … pass|waived`). `affordances` say what is LEGAL; the hint
+// never presumes a write. A runtime guard fails closed so a future edit cannot leak a write/pass verb.
+const SAFE_HINT = /^track (focus|accept run|blocker raise|priority assess|query|report)\b/;
+const FORBIDDEN_HINT = /\b(realize|done|pass|waived)\b/;
+export function assertSafeCommandHint(hint) {
+    if (hint === undefined)
+        return;
+    if (!SAFE_HINT.test(hint) || FORBIDDEN_HINT.test(hint)) {
+        throw new Error(`unsafe commandHint (record-only allowlist violated, DESIGN §5): ${hint}`);
+    }
+}
+// The LEGAL next writes per step (a curated affordance set — what the human/AI MAY submit, never a
+// presumed write). Mirrors the monotone facade machines coarsely; the facade re-checks legality.
+const AFFORDANCES = {
+    'focus-decision': ['decision.outcome'],
+    'settle-decision': ['decision.outcome'],
+    'resume-engagement': ['blocker.resolve-external'],
+    'resolve-external-blocker': ['blocker.resolve', 'blocker.resolve-external'],
+    'amend-spec': ['item.spec', 'item.spec-amend'],
+    'fix-acceptance': ['acceptance.run'],
+    'rerun-acceptance': ['acceptance.run'],
+    'finish-increment': ['item.realize'],
+    'start-increment': ['item.realize'],
+    'prioritize-backlog': ['priority.assess'],
+    'inspect-fallback': [],
+};
+/**
+ * Presentation heuristic (NOT a directive field): a decision is "complex enough to warrant a focus
+ * session" when it has ≥3 open questions / ≥3 options / any dossier artifact, or simply lacks a
+ * recommendation. Drives `focus-decision` vs `settle-decision`. Shared with the renderer (format.ts).
+ */
+export function decisionNeedsFocus(d) {
+    return ((d.openQuestionCount ?? 0) >= 3 ||
+        (d.optionCount ?? 0) >= 3 ||
+        (d.artifacts?.length ?? 0) > 0 ||
+        d.hasRecommendation !== true);
+}
+function gateCodeOfDep(b) {
+    if (b.scope === 'extra')
+        return 'external-dependency'; // (extra deps are engagement-routed; defensive)
+    if (b.resolutionRule === 'manual')
+        return 'manual-blocker';
+    return 'linked-dependency';
+}
+function tierOf(l) {
+    const depBlocker = l.openBlockers.find((b) => b.kind === 'dependency');
+    const blockerRefs = l.openBlockers.map((b) => b.blockerId);
+    // 1. real blocking gate (dependency/manual blocker open) on a NON-in-progress leaf — P1_GATE.
+    if (depBlocker !== undefined && l.realization !== 'in-progress') {
+        return { order: 10, rank: 'P1_GATE', step: 'resolve-external-blocker', gateCode: gateCodeOfDep(depBlocker), gateRef: depBlocker.blockerId, blockerRefs };
+    }
+    // 2. acceptance == 'fail' — P2_ACCEPTANCE (fail sub-rank, primes in-progress).
+    if (l.acceptance === 'fail') {
+        return { order: 20, rank: 'P2_ACCEPTANCE', step: 'fix-acceptance', gateCode: 'acceptance-failed', blockerRefs: [] };
+    }
+    // 3. in-progress + open dependency blocker (WIP coincé) — P3_IN_PROGRESS.
+    if (depBlocker !== undefined && l.realization === 'in-progress') {
+        return { order: 30, rank: 'P3_IN_PROGRESS', step: 'finish-increment', gateCode: gateCodeOfDep(depBlocker), gateRef: depBlocker.blockerId, blockerRefs };
+    }
+    // 4. in-progress (flux — finish before starting new).
+    if (l.realization === 'in-progress') {
+        return { order: 40, rank: 'P3_IN_PROGRESS', step: 'finish-increment', blockerRefs: [] };
+    }
+    // 5. acceptance == 'stale' — P2_ACCEPTANCE (stale sub-rank < fail; soft debt, after WIP). D1.
+    if (l.acceptance === 'stale') {
+        return { order: 50, rank: 'P2_ACCEPTANCE', step: 'rerun-acceptance', gateCode: 'acceptance-stale', blockerRefs: [] };
+    }
+    // 6. specStatus demands a spec — spec gate.
+    if (l.specStatus === 'to-specify') {
+        return { order: 60, rank: 'P1_GATE', step: 'amend-spec', gateCode: 'spec-not-ready', blockerRefs: [] };
+    }
+    // 7. to-do, ordered by WSJF desc (the value proxy lives in the global tie-break).
+    if (l.realization === 'to-do') {
+        return { order: 70, rank: 'P4_TODO_WSJF', step: 'start-increment', blockerRefs: [] };
+    }
+    // 8. fallback — NEVER id-only (the facts always carry bucket/realization/acceptance/specStatus).
+    return { order: 90, rank: 'P5_FALLBACK', step: 'inspect-fallback', blockerRefs: [] };
+}
+function factsOf(l, blockerRefs) {
+    return {
+        bucket: l.bucket,
+        realization: l.realization,
+        acceptance: l.acceptance,
+        specStatus: l.specStatus,
+        ...(l.priority !== undefined ? { wsjf: l.priority } : {}),
+        ...(l.accountable !== undefined ? { accountable: l.accountable } : {}),
+        ...(blockerRefs.length > 0 ? { blockerRefs } : {}),
+    };
+}
+/** Stable directive id (deterministic — no flicker): each (kind,target) yields at most one directive. */
+function directiveId(target) {
+    return `${target.kind}:${target.id}`;
+}
+function makeDirective(d) {
+    assertSafeCommandHint(d.commandHint);
+    return {
+        id: directiveId(d.target),
+        affordances: d.affordances ?? AFFORDANCES[d.step.code],
+        ...d,
+    };
+}
+// In-WP urgency comparator: order asc, then WSJF desc (undefined LAST), then id (deterministic).
+function leafCompare(a, b) {
+    if (a.order !== b.order)
+        return a.order - b.order;
+    const aw = a.l.priority;
+    const bw = b.l.priority;
+    if (aw !== bw) {
+        if (aw === undefined)
+            return 1;
+        if (bw === undefined)
+            return -1;
+        return bw - aw;
+    }
+    return a.l.id.localeCompare(b.l.id);
+}
+// Global directive comparator (DESIGN §2.B item 8): urgency `order`, then WSJF desc (undefined LAST),
+// then wp.id, then target.id. STRICT determinism — two identical runs yield identical output.
+function directiveCompare(a, b) {
+    if (a.order !== b.order)
+        return a.order - b.order;
+    const aw = a.directive.facts.wsjf;
+    const bw = b.directive.facts.wsjf;
+    if (aw !== bw) {
+        if (aw === undefined)
+            return 1;
+        if (bw === undefined)
+            return -1;
+        return bw - aw;
+    }
+    const aWp = a.directive.scope.wpId ?? '';
+    const bWp = b.directive.scope.wpId ?? '';
+    if (aWp !== bWp)
+        return aWp.localeCompare(bWp);
+    return a.directive.target.id.localeCompare(b.directive.target.id);
+}
+/** Is this leaf in the DELEGABLE scope: open, OR done-but-acceptance∈{fail,stale} (the invisible debt). */
+function inDelegableScope(l) {
+    if (l.bucket === 'TO-DO' || l.bucket === 'AWAITED')
+        return true;
+    // A `done` leaf with fail/stale acceptance is the most precious deletable debt (invisible in DONE when
+    // requireAccepted=false). `unknown`/`waived`/`n-a` short-circuit (nothing to re-run / intentional waiver).
+    return l.bucket === 'DONE' && (l.acceptance === 'fail' || l.acceptance === 'stale');
+}
+/**
+ * Build the DIRECTIVE set over the WP forest + the decision rows (DESIGN §2/§3). Two ORTHOGONAL axes:
+ *   ROUTAGE (mode, per leaf): open `decision` blocker ⇒ `human-decision` (ref=decisionId); an
+ *     `engagementRef` on a non-DONE leaf ⇒ `h2a-engagement`; else ⇒ `subagent`.
+ *   URGENCE (which leaf, on the delegable subset of each WP): the DESIGN §2.B ladder (`tierOf`).
+ *
+ * Each leaf is attributed to its OWNING node (`node.leaves` — `directLeaves` already stops at sub-WP
+ * boundaries) so a directive maps 1:1 to a leaf with no parent/child double-count. One WORK directive per
+ * WP node (its most-urgent delegable leaf), PLUS one directive per decision-wait / engagement-wait /
+ * pending decision. The returned array is GLOBALLY sorted (deterministic).
+ */
+export function buildDirectives(tree, decisions = []) {
+    const decisionById = new Map(decisions.map((d) => [d.id, d]));
+    const flat = [];
+    const collect = (n) => {
+        flat.push(n);
+        for (const c of n.children)
+            collect(c);
+    };
+    for (const n of tree)
+        collect(n);
+    const entries = [];
+    const seenDecisionRef = new Set(); // decisionIds already surfaced via a decision-wait leaf
+    for (const node of flat) {
+        const scope = { wpId: node.id, wpLabel: node.label };
+        const work = [];
+        for (const l of node.leaves) {
+            if (!inDelegableScope(l))
+                continue;
+            // ROUTAGE — decision wait first, then engagement wait; both leave as their OWN line (not in URGENCE).
+            const decisionBlocker = l.openBlockers.find((b) => b.kind === 'decision');
+            if (decisionBlocker !== undefined) {
+                const decisionId = decisionBlocker.ref ?? '';
+                const d = decisionId !== '' ? decisionById.get(decisionId) : undefined;
+                const focus = d !== undefined ? decisionNeedsFocus(d) : false;
+                entries.push({
+                    order: 0,
+                    directive: makeDirective({
+                        target: { kind: 'item', id: l.id, title: l.title, workspace: l.workspace },
+                        scope,
+                        mode: 'human-decision',
+                        ...(decisionId !== '' ? { gate: { code: 'decision-pending', ref: decisionId } } : { gate: { code: 'decision-pending' } }),
+                        step: { code: focus ? 'focus-decision' : 'settle-decision' },
+                        rank: 'P1_GATE',
+                        facts: factsOf(l, decisionId !== '' ? [decisionId] : []),
+                        ...(decisionId !== '' ? { commandHint: `track focus ${decisionId}` } : {}),
+                    }),
+                });
+                if (decisionId !== '')
+                    seenDecisionRef.add(decisionId);
+                continue;
+            }
+            const extraEng = l.openBlockers.find((b) => b.engagementRef !== undefined);
+            const engRef = extraEng?.engagementRef ?? (l.bucket !== 'DONE' ? l.engagementRef : undefined);
+            if (engRef !== undefined) {
+                entries.push({
+                    order: 1,
+                    directive: makeDirective({
+                        target: { kind: 'engagement', id: engRef, title: l.title, workspace: l.workspace },
+                        scope,
+                        mode: 'h2a-engagement',
+                        gate: { code: 'engagement-pending', ref: engRef },
+                        step: { code: 'resume-engagement' },
+                        rank: 'P1_GATE',
+                        facts: factsOf(l, extraEng !== undefined ? [extraEng.blockerId] : []),
+                    }),
+                });
+                continue;
+            }
+            work.push(l);
+        }
+        if (work.length === 0)
+            continue;
+        // Priorité mix (c) (DESIGN §6): when the WP's whole delegable subset is "all to-do, no WSJF, no
+        // discriminant", the to-do/WSJF tier degenerates ⇒ the MISSING priority becomes a delegable action.
+        const allPlainTodoNoWsjf = work.every((l) => l.realization === 'to-do' &&
+            l.specStatus !== 'to-specify' &&
+            l.acceptance !== 'fail' &&
+            l.acceptance !== 'stale' &&
+            l.openBlockers.length === 0 &&
+            l.priority === undefined);
+        if (allPlainTodoNoWsjf) {
+            const rep = [...work].sort((a, b) => a.id.localeCompare(b.id))[0];
+            entries.push({
+                order: 70,
+                directive: makeDirective({
+                    target: { kind: 'item', id: rep.id, title: rep.title, workspace: rep.workspace },
+                    scope,
+                    mode: 'subagent',
+                    gate: { code: 'priority-missing' },
+                    step: { code: 'prioritize-backlog' },
+                    rank: 'P4_TODO_WSJF',
+                    facts: factsOf(rep, []),
+                    commandHint: `track priority assess ${rep.id}`,
+                }),
+            });
+            continue;
+        }
+        // Most-urgent delegable leaf of this WP (URGENCE ladder + in-WP tie-break).
+        const ranked = work.map((l) => ({ l, ...tierOf(l) }));
+        ranked.sort(leafCompare);
+        const top = ranked[0];
+        entries.push({
+            order: top.order,
+            directive: makeDirective({
+                target: { kind: 'item', id: top.l.id, title: top.l.title, workspace: top.l.workspace },
+                scope,
+                mode: 'subagent',
+                ...(top.gateCode !== undefined
+                    ? { gate: { code: top.gateCode, ...(top.gateRef !== undefined ? { ref: top.gateRef } : {}) } }
+                    : {}),
+                step: { code: top.step },
+                rank: top.rank,
+                facts: factsOf(top.l, top.blockerRefs),
+            }),
+        });
+    }
+    // Pending DecisionRows NOT already surfaced as a decision-wait (a decision blocking a leaf is covered by
+    // that leaf's line). A pending decision with no blocked leaf still needs its own human-decision line.
+    for (const d of decisions) {
+        if (d.outcome !== 'pending')
+            continue;
+        if (seenDecisionRef.has(d.id))
+            continue;
+        const focus = decisionNeedsFocus(d);
+        entries.push({
+            order: 0,
+            directive: makeDirective({
+                target: { kind: 'decision', id: d.id, title: d.title, workspace: d.workspace },
+                scope: {},
+                mode: 'human-decision',
+                gate: { code: 'decision-pending', ref: d.id },
+                step: { code: focus ? 'focus-decision' : 'settle-decision' },
+                rank: 'P1_GATE',
+                facts: {
+                    bucket: 'AWAITED',
+                    realization: d.realization,
+                    acceptance: 'n/a',
+                    specStatus: 'n/a',
+                    ...(d.accountable !== undefined ? { accountable: d.accountable } : {}),
+                    blockerRefs: [d.id],
+                },
+                commandHint: `track focus ${d.id}`,
+            }),
+        });
+    }
+    entries.sort(directiveCompare);
+    return entries.map((e) => e.directive);
+}
+/**
+ * The flat, prioritized SUBAGENT dispatch queue (DESIGN §4): the directive ids that are delegable to a
+ * subagent, in urgency order. `human-decision` / `h2a-engagement` directives are surfaced in `directives[]`
+ * but NOT here — they need a human / an h2a peer, not a subagent. Input is already globally sorted.
+ */
+export function dispatchQueueOf(directives) {
+    return directives.filter((d) => d.mode === 'subagent' || d.mode === 'local').map((d) => d.id);
+}
+//# sourceMappingURL=directive.js.map

package/dist/report/directive.js.map

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

package/dist/report/format.d.ts

@@ -1,5 +1,6 @@
 import type { DecisionRow, Report, ReportRow } from './build.js';
 import type { WpNode } from './rollup.js';
+import { type Directive } from './directive.js';
 export type Format = 'json' | 'text' | 'md';
 export declare function formatReport(report: Report, format: Format): string;
 /**
@@ -55,7 +56,20 @@ export interface ReportView {
     locale: 'fr';
     tables: readonly ReportViewTable[];
     generalRecommendation: string;
+    /**
+     * preconisation-actionnable (DESIGN §4) — the langue-neutre DIRECTIVES the tables are DERIVED from
+     * (machine surface). `dispatchQueue` is the flat, prioritized list of SUBAGENT directive ids (the real
+     * delegation payload). Both are additive; the rendered tables + `generalRecommendation` stay back-compat.
+     */
+    directives: readonly Directive[];
+    dispatchQueue: readonly string[];
 }
+/**
+ * Render ONE directive to a human FR phrase — RENDER-ONLY (no phrase is ever stored as data, DESIGN §3).
+ * Maps the langue-neutre `(mode, step, gate)` to a sentence. An UNKNOWN `step.code` (a future vocabulary
+ * entry this renderer predates) degrades to the `inspect-fallback` phrasing — forward-compat (DESIGN §7).
+ */
+export declare function directivePhrase(d: Directive): string;
 export declare function buildWpConductorView(tree: readonly WpNode[], decisions?: readonly DecisionRow[]): ReportView;
 export declare function formatWpConductor(tree: readonly WpNode[], format: Format, decisions?: readonly DecisionRow[]): string;
 export declare function formatRows(rows: ReportRow[], format: Format): string;

package/dist/report/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/report/format.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;AAoD3C,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAwBnE;AAsFD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA6CzE;AAaD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,GAAE,MAAa,GAAG,MAAM,CAenF;AAED,+GAA+G;AAC/G,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,GAAG,KAAK,CAAA;CACpB;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,QAAQ,CAiB1D;AAwBD;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACjD,IAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;CACxC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,qBAAqB,CAAA;IAC3B,MAAM,EAAE,IAAI,CAAA;IACZ,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;IAClC,qBAAqB,EAAE,MAAM,CAAA;CAC9B;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,GAAE,SAAS,WAAW,EAAO,GAAG,UAAU,CAqEhH;AAgBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,SAAS,WAAW,EAAO,GAAG,MAAM,CAEzH;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAYpE"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/report/format.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAIL,KAAK,SAAS,EAEf,MAAM,gBAAgB,CAAA;AAEvB,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;AAoD3C,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAwBnE;AAkFD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA6CzE;AAaD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,GAAE,MAAa,GAAG,MAAM,CAenF;AAED,+GAA+G;AAC/G,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,GAAG,KAAK,CAAA;CACpB;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,QAAQ,CAiB1D;AAwBD;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACjD,IAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;CACxC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,qBAAqB,CAAA;IAC3B,MAAM,EAAE,IAAI,CAAA;IACZ,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;IAClC,qBAAqB,EAAE,MAAM,CAAA;IAC7B;;;;OAIG;IACH,UAAU,EAAE,SAAS,SAAS,EAAE,CAAA;IAChC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;CACjC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CA2BpD;AAOD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,GAAE,SAAS,WAAW,EAAO,GAAG,UAAU,CAyDhH;AAoBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,SAAS,WAAW,EAAO,GAAG,MAAM,CAEzH;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAYpE"}

package/dist/report/format.js

@@ -1,4 +1,5 @@
 import { BUCKETS } from './buckets.js';
+import { buildDirectives, decisionNeedsFocus, dispatchQueueOf, } from './directive.js';
 const BACKSLASH = String.fromCharCode(92);
 // Markdown metacharacters escaped in `md` titles so a user title can't inject formatting.
 const MD_META = new Set([
@@ -80,9 +81,6 @@ function actionDisposition(r) {
         return 'terminer ou expliciter blocage';
     return 'exécuter prochain incrément';
 }
-function decisionNeedsFocus(d) {
-    return (d.openQuestionCount ?? 0) >= 3 || (d.optionCount ?? 0) >= 3 || (d.artifacts?.length ?? 0) > 0 || d.hasRecommendation !== true;
-}
 function decisionDisposition(d) {
     if (decisionNeedsFocus(d)) {
         return `focus décision HTML conseillé: track focus ${d.id} --format html`;
@@ -305,60 +303,82 @@ function droppedLeaves(node) {
     walk(node);
     return out;
 }
+/**
+ * Render ONE directive to a human FR phrase — RENDER-ONLY (no phrase is ever stored as data, DESIGN §3).
+ * Maps the langue-neutre `(mode, step, gate)` to a sentence. An UNKNOWN `step.code` (a future vocabulary
+ * entry this renderer predates) degrades to the `inspect-fallback` phrasing — forward-compat (DESIGN §7).
+ */
+export function directivePhrase(d) {
+    if (d.mode === 'human-decision') {
+        const who = d.facts.accountable ?? 'owner';
+        return d.step.code === 'focus-decision'
+            ? `décision (${who}): focus dossier (questions/options) puis trancher outcome`
+            : `décision (${who}): trancher outcome`;
+    }
+    if (d.mode === 'h2a-engagement') {
+        return 'engagement (h2a): relancer engagement puis intégrer le retour';
+    }
+    const mode = d.mode === 'local' ? 'local' : 'subagent';
+    const phrase = {
+        'focus-decision': `action (${mode}): focus dossier puis trancher outcome`,
+        'settle-decision': `action (${mode}): trancher outcome`,
+        'resume-engagement': `action (${mode}): relancer engagement puis intégrer le retour`,
+        'resolve-external-blocker': `action (${mode}): lever le blocage puis reprendre`,
+        'amend-spec': `action (${mode}): spécifier avant de démarrer`,
+        'fix-acceptance': `action (${mode}): corriger puis revalider acceptance (fail)`,
+        'rerun-acceptance': `action (${mode}): relancer acceptance (stale) sur le commit courant`,
+        'finish-increment': `action (${mode}): terminer l'incrément en cours`,
+        'start-increment': `action (${mode}): continuer le premier item ouvert puis enregistrer preuve/acceptance`,
+        'prioritize-backlog': `action (${mode}): prioriser le backlog (WSJF absent) puis reprendre`,
+        'inspect-fallback': `action (${mode}): inspecter l'état puis décider la suite`,
+    };
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition — `step.code` may be an UNKNOWN
+    // future vocabulary entry (governed/additive enums): fall back rather than render `undefined`.
+    return phrase[d.step.code] ?? `action (${mode}): inspecter l'état puis décider la suite`;
+}
+/** The `scope/gate` cell for a directive row: its gate code if any, else the WP label, else `-`. */
+function directiveScopeLabel(d) {
+    return d.gate?.code ?? d.scope.wpLabel ?? '-';
+}
 export function buildWpConductorView(tree, decisions = []) {
     const wpName = (n) => `${n.label} · ${clean(stripWpPrefix(n.title))}`;
-    const flat = [];
-    const collect = (n) => {
-        flat.push(n);
-        for (const c of n.children)
-            collect(c);
-    };
-    for (const n of tree)
-        collect(n);
     const totals = wpTotals(tree);
-    const pendingDecisions = decisions.filter((d) => d.outcome === 'pending');
-    const complexDecisionCount = pendingDecisions.filter(decisionNeedsFocus).length;
-    const generalRecommendation = complexDecisionCount >= 2 || pendingDecisions.length >= 4
+    // preconisation-actionnable (DESIGN §4): the DÉCISIONS/ACTIONS table + generalRecommendation are now
+    // DERIVED from the directive set (each directive ⇒ one row, phrase rendered, never stored). FAIT/À-FAIRE
+    // stay the same rollup-driven tables (unchanged back-compat).
+    const directives = buildDirectives(tree, decisions);
+    const dispatchQueue = dispatchQueueOf(directives);
+    const humanDecisions = directives.filter((d) => d.mode === 'human-decision');
+    const focusNeeded = humanDecisions.filter((d) => d.step.code === 'focus-decision').length;
+    const generalRecommendation = focusNeeded >= 2 || humanDecisions.length >= 4
         ? 'Prévoir un temps de focus HTML pour trancher les décisions accumulées, puis reprendre les WP par premier item ouvert.'
         : 'Avancer par premier item ouvert, enregistrer preuve/acceptance, et escalader uniquement les décisions réellement bloquantes.';
     const doneRows = [
         { scope: 'global', progress: `${totals.done}/${totals.active} (${pctStr(totals.pct)})`, lastActions: `${totals.done} items faits; poursuivre les WP ouverts` },
         ...tree.filter((n) => n.pct === 100).map((n) => ({ scope: wpName(n), progress: `${n.done}/${n.active} (100%)`, lastActions: 'WP clos; preuve/acceptance enregistrée' })),
     ];
-    const todoRows = tree.filter((n) => n.pct !== 100).map((n) => ({
-        wp: wpName(n),
-        progress: `${n.done}/${n.active} (${pctStr(n.pct)})`,
-        todo: openLeaves(n).slice(0, 2).map((l) => clean(l.title)).join(' / ') || 'aucun item ouvert direct',
-    }));
-    const attendus = flat.flatMap((n) => n.leaves
-        .filter((l) => l.bucket === 'AWAITED' || (l.engagementRef !== undefined && l.bucket !== 'DONE' && l.bucket !== 'DROPPED'))
-        .map((l) => ({ wp: n, leaf: l })));
-    const decisionWaits = attendus.filter(({ leaf }) => leaf.awaitedOnDecision === true || leaf.engagementRef !== undefined);
+    const todoRows = tree.filter((n) => n.pct !== 100).map((n) => {
+        const open = openLeaves(n);
+        const shown = open.slice(0, 2).map((l) => clean(l.title)).join(' / ');
+        // NEVER truncate silently: surface the count of items not shown so the report can't read as complete.
+        const more = open.length > 2 ? `${shown} (+${open.length - 2} autres)` : shown;
+        return { wp: wpName(n), progress: `${n.done}/${n.active} (${pctStr(n.pct)})`, todo: more || 'aucun item ouvert direct' };
+    });
+    // DÉCISIONS/ACTIONS rows — derived from the directives. Decisions first (capped at 8 + an omission count
+    // so the table never reads as complete when it isn't), then engagement/work directives.
     const actionRows = [];
-    if (decisionWaits.length >= 3 || pendingDecisions.length >= 4 || complexDecisionCount >= 2) {
+    if (focusNeeded >= 2 || humanDecisions.length >= 4) {
         actionRows.push({ scope: '-', subject: 'décisions accumulées', recommendation: 'focus (humain+MCP): lancer focus HTML local; retour outcome via vue interactive/MCP' });
     }
-    for (const d of pendingDecisions.slice(0, 8)) {
-        actionRows.push({ scope: d.decisionKind, subject: clean(d.title), recommendation: `décision (${d.accountable ?? 'owner'}): ${decisionDisposition(d)}` });
+    for (const d of humanDecisions.slice(0, 8)) {
+        actionRows.push({ scope: directiveScopeLabel(d), subject: clean(d.target.title ?? d.target.id), recommendation: directivePhrase(d) });
     }
-    for (const { wp, leaf } of decisionWaits.slice(0, 8)) {
-        const focus = leaf.awaitedOnDecision === true ? 'focus décision si dossier/questions non évidents; sinon trancher outcome' : 'relancer engagement/subagent puis intégrer retour';
-        actionRows.push({ scope: wp.label, subject: clean(leaf.title), recommendation: `décision (owner/subagent): ${focus}` });
+    for (const d of directives.filter((x) => x.mode !== 'human-decision')) {
+        actionRows.push({ scope: directiveScopeLabel(d), subject: clean(d.target.title ?? d.target.id), recommendation: directivePhrase(d) });
     }
-    const decisionWaitIds = new Set(decisionWaits.map(({ leaf }) => leaf.id));
-    const candidates = flat
-        .filter((n) => n.pct !== 100)
-        .map((n) => ({ wp: n, leaves: openLeaves(n).filter((l) => !decisionWaitIds.has(l.id)) }))
-        .filter((x) => x.leaves.length > 0);
-    for (const { wp, leaves } of candidates) {
-        const first = leaves[0];
-        const mode = first.awaitedOnDecision === true ? 'human decision' : first.engagementRef !== undefined ? 'h2a/subagent' : 'local/subagent';
-        const action = first.awaitedOnDecision === true
-            ? 'trancher décision bloquante puis relancer WP'
-            : first.engagementRef !== undefined
-                ? 'relancer engagement/subagent et suivre retour'
-                : 'continuer premier item ouvert puis enregistrer preuve/acceptance';
-        actionRows.push({ scope: wpName(wp), subject: clean(first.title), recommendation: `action (${mode}): ${action}` });
+    const omitted = Math.max(0, humanDecisions.length - 8);
+    if (omitted > 0) {
+        actionRows.push({ scope: '-', subject: `+${omitted} entrées non listées`, recommendation: 'voir `track query` / `track report --flat` pour le détail complet' });
     }
     return {
         kind: 'wp-conductor-report',
@@ -369,20 +389,26 @@ export function buildWpConductorView(tree, decisions = []) {
             { id: 'decisions-actions', title: 'DÉCISIONS/ACTIONS', columns: [{ id: 'scope', label: 'scope/gate' }, { id: 'subject', label: 'sujet' }, { id: 'recommendation', label: 'préconisation' }], rows: actionRows.length > 0 ? actionRows : [{ scope: '-', subject: 'aucune action ouverte dans les WP actifs', recommendation: '-' }] },
         ],
         generalRecommendation,
+        directives,
+        dispatchQueue,
     };
 }
 function renderReportView(view, format) {
     if (format === 'json')
         return JSON.stringify(view, null, 2) + '\n';
+    // User-originated cell content (titles) is escaped per-format: `md` escapes markdown metacharacters so a
+    // crafted item title cannot inject formatting (parity with the legacy `formatReport`/`title` path); `text`
+    // is clean. The view model itself stays RAW (escaping is a render-only concern).
+    const esc = (s) => title(s, format);
     const h = (label) => (format === 'md' ? `## ${label}` : label);
     const lines = [];
     for (const section of view.tables) {
         lines.push(h(section.title));
-        lines.push(...table(section.columns.map((c) => c.label), section.rows.map((row) => section.columns.map((c) => row[c.id] ?? ''))));
+        lines.push(...table(section.columns.map((c) => c.label), section.rows.map((row) => section.columns.map((c) => esc(row[c.id] ?? '')))));
         lines.push('');
     }
     lines.push(h('RECOMMANDATION'));
-    lines.push(view.generalRecommendation);
+    lines.push(esc(view.generalRecommendation));
     return lines.join('\n').trimEnd() + '\n';
 }
 export function formatWpConductor(tree, format, decisions = []) {