@sentropic/track 0.85.16 → 0.85.17

package/dist/report/snapshot.js

@@ -0,0 +1,203 @@
+import { canonicalize } from '../events/canonical.js';
+import { fold } from '../state/fold.js';
+import { buildReport, } from './build.js';
+import { buildDirectives } from './directive.js';
+import { directivePhrase, wpTotals } from './format.js';
+export const SNAPSHOT_SCHEMA = 'track.snapshot/v1';
+export const SNAPSHOT_EVENT_LIMIT = 200;
+/** Locale/ICU-independent JS UTF-16 code-unit ordering for canonical snapshot arrays. */
+export function ordinalCompare(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+function stableWpTree(tree) {
+    return tree
+        .map((node) => ({
+        ...node,
+        leaves: [...node.leaves].sort((a, b) => ordinalCompare(a.id, b.id)),
+        children: stableWpTree(node.children),
+    }))
+        .sort((a, b) => ordinalCompare(a.id, b.id));
+}
+function stableReport(report) {
+    const tree = stableWpTree(report.wpTree ?? []);
+    return {
+        buckets: {
+            AWAITED: [...report.buckets.AWAITED].sort((a, b) => ordinalCompare(a.id, b.id)),
+            DROPPED: [...report.buckets.DROPPED].sort((a, b) => ordinalCompare(a.id, b.id)),
+            DONE: [...report.buckets.DONE].sort((a, b) => ordinalCompare(a.id, b.id)),
+            'TO-DO': [...report.buckets['TO-DO']].sort((a, b) => ordinalCompare(a.id, b.id)),
+        },
+        decisions: [...(report.decisions ?? [])].sort((a, b) => ordinalCompare(a.id, b.id)),
+        wpTree: tree,
+    };
+}
+function projectRow(row) {
+    return {
+        id: row.id,
+        title: row.title,
+        kind: row.kind,
+        workspace: row.workspace,
+        bucket: row.bucket,
+        realization: row.realization,
+        acceptance: row.acceptance,
+        ...(row.priority !== undefined ? { priority: row.priority } : {}),
+        ...(row.accountable !== undefined ? { accountable: row.accountable } : {}),
+        ...(row.engagementRef !== undefined ? { engagementRef: row.engagementRef } : {}),
+        ...(row.role !== undefined ? { role: row.role } : {}),
+        ...(row.wpId !== undefined ? { wpId: row.wpId } : {}),
+        ...(row.wpLabel !== undefined ? { wpLabel: row.wpLabel } : {}),
+        detail: { acceptanceLabel: row.detail.acceptanceLabel },
+    };
+}
+function projectDecision(decision) {
+    return {
+        id: decision.id,
+        title: decision.title,
+        workspace: decision.workspace,
+        decisionKind: decision.decisionKind,
+        realization: decision.realization,
+        outcome: decision.outcome,
+        ...(decision.accountable !== undefined ? { accountable: decision.accountable } : {}),
+        ...(decision.optionCount !== undefined ? { optionCount: decision.optionCount } : {}),
+        ...(decision.openQuestionCount !== undefined ? { openQuestionCount: decision.openQuestionCount } : {}),
+        ...(decision.hasRecommendation !== undefined ? { hasRecommendation: decision.hasRecommendation } : {}),
+    };
+}
+function projectBlocker(blocker) {
+    return {
+        blockerId: blocker.blockerId,
+        kind: blocker.kind,
+        reason: blocker.reason,
+        ...(blocker.ref !== undefined ? { ref: blocker.ref } : {}),
+        ...(blocker.scope !== undefined ? { scope: blocker.scope } : {}),
+        ...(blocker.resolutionRule !== undefined ? { resolutionRule: blocker.resolutionRule } : {}),
+        ...(blocker.engagementRef !== undefined ? { engagementRef: blocker.engagementRef } : {}),
+    };
+}
+function projectLeaf(leaf) {
+    return {
+        id: leaf.id,
+        title: leaf.title,
+        bucket: leaf.bucket,
+        kind: leaf.kind,
+        workspace: leaf.workspace,
+        realization: leaf.realization,
+        acceptance: leaf.acceptance,
+        specStatus: leaf.specStatus,
+        openBlockers: leaf.openBlockers.map(projectBlocker),
+        ...(leaf.priority !== undefined ? { priority: leaf.priority } : {}),
+        ...(leaf.accountable !== undefined ? { accountable: leaf.accountable } : {}),
+        ...(leaf.engagementRef !== undefined ? { engagementRef: leaf.engagementRef } : {}),
+        ...(leaf.awaitedOnDecision !== undefined ? { awaitedOnDecision: leaf.awaitedOnDecision } : {}),
+    };
+}
+function projectNode(node) {
+    return {
+        id: node.id,
+        title: node.title,
+        label: node.label,
+        done: node.done,
+        active: node.active,
+        dropped: node.dropped,
+        pct: node.pct,
+        leaves: node.leaves.map(projectLeaf),
+        children: node.children.map(projectNode),
+        ...(node.code !== undefined ? { code: node.code } : {}),
+        ...(node.role !== undefined ? { role: node.role } : {}),
+        ...(node.terminal !== undefined ? { terminal: node.terminal } : {}),
+        ...(node.partial !== undefined ? { partial: node.partial } : {}),
+    };
+}
+function projectReport(report) {
+    return {
+        buckets: {
+            AWAITED: report.buckets.AWAITED.map(projectRow),
+            DROPPED: report.buckets.DROPPED.map(projectRow),
+            DONE: report.buckets.DONE.map(projectRow),
+            'TO-DO': report.buckets['TO-DO'].map(projectRow),
+        },
+        decisions: (report.decisions ?? []).map(projectDecision),
+        wpTree: (report.wpTree ?? []).map(projectNode),
+    };
+}
+/**
+ * A deliberately narrow event summary. Never copy arbitrary prose-bearing payload fields: the event kind,
+ * aggregate id, and append position already carry the useful change signal for the AI context.
+ */
+function recentEvents(events) {
+    const start = Math.max(0, events.length - SNAPSHOT_EVENT_LIMIT);
+    return events.slice(start).map((event, offset) => ({
+        position: start + offset + 1,
+        eventId: event.id,
+        kind: event.type,
+        aggregateId: event.aggregateId,
+    }));
+}
+export function buildSnapshot(events, options) {
+    const report = stableReport(buildReport(fold(events), {
+        baselineCommit: options.resolvedCommit,
+        requireAccepted: options.requireAccepted ?? false,
+        decisions: true,
+        wpTree: true,
+        activeRoster: false,
+    }, ordinalCompare));
+    const directives = buildDirectives(report.wpTree ?? [], report.decisions ?? [], ordinalCompare)
+        .map((directive) => ({
+        id: directive.id,
+        source: 'rule-derived',
+        kind: directive.step.code,
+        aggregateId: directive.target.id,
+        text: directivePhrase(directive),
+    }))
+        .sort((a, b) => ordinalCompare(a.id, b.id));
+    return {
+        schema: SNAPSHOT_SCHEMA,
+        baseline: { input: options.baselineInput, resolvedCommit: options.resolvedCommit },
+        report: projectReport(report),
+        wpTotals: wpTotals(report.wpTree ?? []),
+        directives,
+        recentEvents: recentEvents(events),
+    };
+}
+export function snapshotJson(snapshot) {
+    return `${canonicalize(snapshot)}\n`;
+}
+function clean(value) {
+    return value
+        .replace(/[\u0000-\u001f\u007f-\u009f\u2028\u2029\u202a-\u202e\u2066-\u2069]/gu, ' ')
+        .replace(/\s+/gu, ' ')
+        .trim();
+}
+function markdown(value) {
+    return clean(value).replace(/([\\`*_{}\[\]()#+\-.!|<>~])/gu, '\\$1');
+}
+export function snapshotDiagnostic(snapshot, format) {
+    const h = (value) => (format === 'md' ? `## ${value}` : value);
+    const esc = format === 'md' ? markdown : clean;
+    const lines = [
+        format === 'md' ? '# Track factual snapshot' : 'TRACK FACTUAL SNAPSHOT',
+        `schema: ${snapshot.schema}`,
+        `baseline: ${esc(snapshot.baseline.resolvedCommit)}`,
+        '',
+        h('BUCKETS'),
+        `AWAITED ${snapshot.report.buckets.AWAITED.length} · DROPPED ${snapshot.report.buckets.DROPPED.length} · DONE ${snapshot.report.buckets.DONE.length} · TO-DO ${snapshot.report.buckets['TO-DO'].length}`,
+        '',
+        h('RULE-DERIVED FACTS (NOT AI ADVICE)'),
+    ];
+    for (const directive of snapshot.directives) {
+        lines.push(`- [${esc(directive.kind)}] ${esc(directive.text)} (${esc(directive.id)})`);
+    }
+    if (snapshot.directives.length === 0)
+        lines.push('- none');
+    lines.push('', h('RECENT EVENTS'));
+    for (const event of snapshot.recentEvents) {
+        lines.push(`- #${event.position} ${esc(event.kind)} · ${esc(event.aggregateId ?? '-')}`);
+    }
+    if (snapshot.recentEvents.length === 0)
+        lines.push('- none');
+    return `${lines.join('\n').trimEnd()}\n`;
+}
+export function renderSnapshot(snapshot, format) {
+    return format === 'json' ? snapshotJson(snapshot) : snapshotDiagnostic(snapshot, format);
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/report/snapshot.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentropic/track",
-  "version": "0.85.16",
+  "version": "0.85.17",
   "description": "Typed product-backlog and spec/plan/UAT system of record for the sentropic ecosystem (record-only MVP).",
   "license": "MIT",
   "author": "Fabien Antoine",

package/skills/track-operation/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: track-operation
-description: "Use when the user asks for a track report, a status, an advancement/progress report, or says 'fais-moi un track report' / 'un track report' — run the CLI `track report` (default table) from the repo root and paste its FAIT/À-FAIRE/DÉCISIONS-ACTIONS table verbatim; NEVER use the `track_report` MCP tool to render a human report (it returns machine JSON). Also use when an agent needs to read, update, import, or verify track state in a repo; when a BRANCH.md or plan/NN-BRANCH_*.md file changed; when a session reports that track write/import is not exposed; or when deciding whether to use track MCP versus the track CLI. The skill enforces the contract: MCP is read-only, writes/imports use the track CLI from the target repo root, and .track is append-only/single-writer."
+description: "Use when the user asks for a track report, status, or advancement/progress report — run the CLI `track report` from the repo root and return its AI-prepared, cited output verbatim; never substitute the deterministic `track_report` MCP projection for a human AI report. Also use when an agent needs to read, update, import, or verify track state; when a BRANCH.md or plan/NN-BRANCH_*.md changed; or when deciding between Track MCP and CLI. MCP remains read-only, writes/imports use the CLI, and .track is append-only/single-writer."
 ---
 
 # Track Operation
@@ -9,17 +9,21 @@ Use this for ordinary track hygiene: reading status, importing BRANCH files, rec
 updates, and verifying that the sidecar is current. This is the general operational skill; use
 `present-decision` for human decision dossiers and `propose-workpackages` for backlog restructuring.
 
-## Human report/status — DO THIS FIRST
+## Human AI report/status — DO THIS FIRST
 
 For ANY human-facing track report or status (including "fais-moi un track report", "un track report",
-"a status", "an advancement/progress report"): run the CLI `track report` (default table, or
-`track report --format md`) from the repo root and PASTE THE OUTPUT VERBATIM in a fenced code block.
-
-- NEVER call the `track_report` MCP tool to render a human report — it returns machine JSON, and hand
-  reformatting that JSON is exactly what produces the verbose bullet lists this rule exists to prevent.
-- NEVER reformat the report into bullets or numbered lists, and never drop the table layout.
-- `track report --flat` is DEPRECATED for human reporting (flat buckets only); the default table is the
-  FAIT / À-FAIRE (%·WP) / DÉCISIONS-ACTIONS conductor view.
+"a status", "an advancement/progress report"): run the CLI `track report` (or
+`track report --format md`) from the repo root and paste its AI-prepared, cited output verbatim.
+
+- NEVER call the `track_report` MCP tool to render a human AI report. It is the frozen legacy,
+  deterministic projection; `track_snapshot` is the canonical factual context projection.
+- NEVER invent a report by interpreting MCP JSON or snapshot facts yourself.
+- If `track report` fails because no adapter is configured, times out, or returns invalid output, say that
+  the AI report is unavailable and preserve the command's honest error. You MAY run
+  `track snapshot --format text`, but label it exactly as a **factual snapshot (not an AI report)**. Do not
+  turn rule-derived snapshot directives into AI advice.
+- `--wp`, `--flat`, `--decisions`, and `--active-roster` are emphasis/context controls for the AI adapter;
+  they no longer select a deterministic human renderer.
 
 ## Contract
 
@@ -54,7 +58,7 @@ When progress is represented by a `BRANCH.md` or `plan/NN-BRANCH_*.md` file:
 3. Verify immediately:
 
    ```bash
-   track report --format text
+   track snapshot --format text
    track validate
    ```
 
@@ -75,13 +79,14 @@ Use direct CLI writes only for the event they actually represent:
 
 Report track results from the verified state, not from memory:
 
-- Use `track report --format text` for human status. Since track 0.19.1 this prefers the WP/table
-  conductor view (FAIT / À-FAIRE %·WP / ATTENDUS) when workpackages exist, and falls back to flat buckets
-  in unstructured repos. **When the user asks for a report/status, paste the raw command output verbatim in
-  a fenced code block; do not summarize it, do not convert it to bullets, and do not drop the table layout.**
-- Use `track report --wp` only to force the conductor table explicitly. Use legacy `track report --flat`
-  only when the user asks for flat buckets or a downstream script still needs them; treat `--flat` as
-  deprecated for human reporting.
+- Use `track report --format text` for a human AI status and paste its raw, cited output verbatim.
+- Use `track report --format md` when Markdown is explicitly useful, and `--wp` or `--flat` only to request
+  a workpackage or flat emphasis from the adapter.
+- Use `track snapshot` or the exact alias `track report --raw` for canonical deterministic facts. Its text
+  and Markdown renderers are diagnostics; always label them **factual snapshot (not an AI report)** when
+  returning them to a human.
+- `track report --format json` and the MCP `track_report` tool remain frozen legacy compatibility surfaces;
+  do not present either as the new human AI report.
 - Mention if `.track/` was intentionally not written because the current checkout is not the designated
   writer.