@indigoai-us/hq-cli 5.226.0 → 5.227.1

package/dist/commands/lanes-tracker.js

@@ -6,6 +6,7 @@ import { LanesError } from "../lib/lanes/errors.js";
 import { resolveProjectStoryLedger } from "../lib/lanes/story-ledger.js";
 import { assertNoSecretText } from "../lib/lanes/text-scan.js";
 import { createLocalTrackerStore } from "../lib/lanes/tracker-store.js";
+import { createWorkMeshTrackerStore } from "../lib/lanes/tracker-mesh.js";
 import { peekIdToken } from "../utils/id-token.js";
 export const LANES_TRACKER_FLAG = "lanes.tracker";
 export const LANES_TRACKER_MESH_FLAG = "lanes.tracker-mesh";
@@ -72,9 +73,7 @@ async function target(deps, options) {
     if (!await deps.trackerEnabled(company)) {
         fail("tracker_disabled", "hq lanes tracker commands require the lanes.tracker flag", { company: company.slug });
     }
-    if (await deps.trackerMeshEnabled(company)) {
-        fail("tracker_mesh_unavailable", "Work Mesh tracker storage is not available in this CLI version", { company: company.slug });
-    }
+    const useMesh = await deps.trackerMeshEnabled(company);
     const project = validSegment(options.project, "project");
     const ledger = resolveProjectStoryLedger(deps.hqRoot(), project, company.slug);
     const projectCompany = readProjectCompany(ledger.path);
@@ -106,7 +105,10 @@ async function target(deps, options) {
     return {
         company,
         project,
-        store: (deps.store ?? ((dir) => createLocalTrackerStore(dir, deps.now)))(realDirectory),
+        usesMesh: useMesh,
+        store: useMesh
+            ? (deps.meshStore ?? ((resolvedCompany, resolvedProject) => createWorkMeshTrackerStore({ company: resolvedCompany, projectId: resolvedProject, now: deps.now })))(company, project)
+            : deps.store?.(realDirectory) ?? createLocalTrackerStore(realDirectory, deps.now),
     };
 }
 function requireActor(deps) {
@@ -184,8 +186,8 @@ function addProjectOptions(command) {
         .requiredOption("--project <slug>", "HQ team project slug")
         .option("--company <slug>", "Select the company by slug");
 }
-function createRecord(store, kind, company, project, fields) {
-    return store.create({ kind, id: randomUUID(), company, project_id: project, ...fields });
+async function createRecord(store, kind, company, project, fields) {
+    return await store.create({ kind, id: randomUUID(), company, project_id: project, ...fields });
 }
 export function registerLaneTrackerCommands(parent, deps, wrap) {
     const blocker = parent.command("blocker").description("Record and manage project blockers");
@@ -200,7 +202,7 @@ export function registerLaneTrackerCommands(parent, deps, wrap) {
             fail("tracker_input_invalid", "story must not be empty", { field: "story" });
         for (const [field, value] of [["what", options.what], ["waiting_on", options.waitingOn], ["next_step", options.nextStep]])
             checkedText(field, value);
-        const record = createRecord(store, "blocker", company.slug, project, {
+        const record = await createRecord(store, "blocker", company.slug, project, {
             story_id: options.story.trim(), what: options.what, waiting_on: options.waitingOn,
             next_step: options.nextStep, opened_at: deps.now().toISOString(), resolved_at: null, resolution: null,
         });
@@ -217,12 +219,12 @@ export function registerLaneTrackerCommands(parent, deps, wrap) {
             checkedText("waiting_on", options.waitingOn);
         if (options.nextStep !== undefined)
             checkedText("next_step", options.nextStep);
-        const current = store.read("blocker", id);
+        const current = await store.read("blocker", id);
         if (!current)
             fail("tracker_record_not_found", `Tracker blocker record ${id} was not found`, { kind: "blocker", id });
         if (current.resolved_at !== null)
             fail("tracker_already_resolved", "Blocker is already resolved", { id });
-        const record = store.update("blocker", id, current.version, (value) => ({
+        const record = await store.update("blocker", id, current.version, (value) => ({
             ...value,
             ...(options.waitingOn === undefined ? {} : { waiting_on: options.waitingOn }),
             ...(options.nextStep === undefined ? {} : { next_step: options.nextStep }),
@@ -234,18 +236,18 @@ export function registerLaneTrackerCommands(parent, deps, wrap) {
         .action(wrap(async (id, options) => {
         const { store } = await target(deps, options);
         checkedText("resolution", options.resolution);
-        const current = store.read("blocker", id);
+        const current = await store.read("blocker", id);
         if (!current)
             fail("tracker_record_not_found", `Tracker blocker record ${id} was not found`, { kind: "blocker", id });
         if (current.resolved_at !== null)
             fail("tracker_already_resolved", "Blocker is already resolved", { id });
-        const record = store.update("blocker", id, current.version, (value) => ({ ...value, resolved_at: deps.now().toISOString(), resolution: options.resolution }));
+        const record = await store.update("blocker", id, current.version, (value) => ({ ...value, resolved_at: deps.now().toISOString(), resolution: options.resolution }));
         console.log(JSON.stringify({ ok: true, action: "blocker.resolve", record }, null, 2));
     }));
     addProjectOptions(blocker.command("list").description("List blockers")).option("--all", "Include resolved blockers")
         .action(wrap(async (options) => {
         const { store } = await target(deps, options);
-        const records = store.list("blocker").filter((record) => options.all || record.resolved_at === null);
+        const records = (await store.list("blocker")).filter((record) => options.all || record.resolved_at === null);
         console.log(JSON.stringify({ ok: true, action: "blocker.list", records }, null, 2));
     }));
     const kpi = parent.command("kpi").description("Define KPIs and record values");
@@ -262,7 +264,7 @@ export function registerLaneTrackerCommands(parent, deps, wrap) {
         checkedText("name", options.name);
         checkedText("definition", options.definition);
         requiredText("unit", options.unit);
-        const record = createRecord(store, "kpi", company.slug, project, {
+        const record = await createRecord(store, "kpi", company.slug, project, {
             name: options.name, definition: options.definition, unit: options.unit,
             target: numberValue(options.target, "target"), direction: options.direction,
             status: "proposed", approved_by: null, approved_at: null, values: [],
@@ -278,31 +280,34 @@ export function registerLaneTrackerCommands(parent, deps, wrap) {
         checkedText("source", options.source);
         const value = numberValue(options.value, "value");
         const at = options.at === undefined ? deps.now() : validTimestamp(options.at);
-        const current = store.read("kpi", id);
+        const current = await store.read("kpi", id);
         if (!current)
             fail("tracker_record_not_found", `Tracker KPI record ${id} was not found`, { kind: "kpi", id });
         const values = current.values;
         if (!Array.isArray(values))
             fail("tracker_record_invalid", "KPI values must be an array", { id });
-        const record = store.update("kpi", id, current.version, (record) => ({ ...record, values: [...values, { at: at.toISOString(), value, source: options.source }] }));
+        const record = await store.update("kpi", id, current.version, (record) => ({ ...record, values: [...values, { at: at.toISOString(), value, source: options.source }] }));
         console.log(JSON.stringify({ ok: true, action: "kpi.record", record }, null, 2));
     }));
     addProjectOptions(kpi.command("approve").description("Approve a KPI proposal").argument("<kpi-id>", "KPI id"))
+        .option("--question <id>", "Answered owner question authorizing this approval")
         .action(wrap(async (id, options) => {
-        const { store } = await target(deps, options);
-        const current = store.read("kpi", id);
+        const { store, usesMesh } = await target(deps, options);
+        if (usesMesh && !options.question)
+            fail("tracker_approval_question_required", "Work Mesh KPI approval requires --question <answered-owner-question-id>", { id });
+        const current = await store.read("kpi", id);
         if (!current)
             fail("tracker_record_not_found", `Tracker KPI record ${id} was not found`, { kind: "kpi", id });
-        const record = store.update("kpi", id, current.version, (value) => {
+        const record = await store.update("kpi", id, current.version, (value) => {
             if (value.status === "approved")
                 fail("tracker_already_approved", "KPI is already approved", { id });
             return { ...value, status: "approved", approved_by: requireActor(deps), approved_at: deps.now().toISOString() };
-        });
+        }, options.question ? { approvalQuestionId: options.question } : undefined);
         console.log(JSON.stringify({ ok: true, action: "kpi.approve", record }, null, 2));
     }));
     addProjectOptions(kpi.command("list").description("List KPIs")).action(wrap(async (options) => {
         const { store } = await target(deps, options);
-        console.log(JSON.stringify({ ok: true, action: "kpi.list", records: store.list("kpi") }, null, 2));
+        console.log(JSON.stringify({ ok: true, action: "kpi.list", records: await store.list("kpi") }, null, 2));
     }));
     const okr = parent.command("okr").description("Set and approve OKRs");
     addProjectOptions(okr.command("set").description("Create a proposed OKR"))
@@ -319,11 +324,11 @@ export function registerLaneTrackerCommands(parent, deps, wrap) {
         for (const keyResult of keyResults)
             checkedText("key_result", keyResult.text);
         for (const keyResult of keyResults) {
-            if (!store.read("kpi", keyResult.kpi_id)) {
+            if (!await store.read("kpi", keyResult.kpi_id)) {
                 fail("tracker_kpi_not_found", `Referenced KPI ${keyResult.kpi_id} was not found in this project`, { kpi_id: keyResult.kpi_id, project_id: project });
             }
         }
-        const record = createRecord(store, "okr", company.slug, project, {
+        const record = await createRecord(store, "okr", company.slug, project, {
             objective: options.objective, period: options.period,
             key_results: keyResults.map((value) => ({ kr_id: randomUUID(), ...value })),
             status: "proposed", approved_by: null, approved_at: null,
@@ -331,21 +336,24 @@ export function registerLaneTrackerCommands(parent, deps, wrap) {
         console.log(JSON.stringify({ ok: true, action: "okr.set", record }, null, 2));
     }));
     addProjectOptions(okr.command("approve").description("Approve an OKR proposal").argument("<okr-id>", "OKR id"))
+        .option("--question <id>", "Answered owner question authorizing this approval")
         .action(wrap(async (id, options) => {
-        const { store } = await target(deps, options);
-        const current = store.read("okr", id);
+        const { store, usesMesh } = await target(deps, options);
+        if (usesMesh && !options.question)
+            fail("tracker_approval_question_required", "Work Mesh OKR approval requires --question <answered-owner-question-id>", { id });
+        const current = await store.read("okr", id);
         if (!current)
             fail("tracker_record_not_found", `Tracker OKR record ${id} was not found`, { kind: "okr", id });
-        const record = store.update("okr", id, current.version, (value) => {
+        const record = await store.update("okr", id, current.version, (value) => {
             if (value.status === "approved")
                 fail("tracker_already_approved", "OKR is already approved", { id });
             return { ...value, status: "approved", approved_by: requireActor(deps), approved_at: deps.now().toISOString() };
-        });
+        }, options.question ? { approvalQuestionId: options.question } : undefined);
         console.log(JSON.stringify({ ok: true, action: "okr.approve", record }, null, 2));
     }));
     addProjectOptions(okr.command("list").description("List OKRs")).action(wrap(async (options) => {
         const { store } = await target(deps, options);
-        console.log(JSON.stringify({ ok: true, action: "okr.list", records: store.list("okr") }, null, 2));
+        console.log(JSON.stringify({ ok: true, action: "okr.list", records: await store.list("okr") }, null, 2));
     }));
     const directive = parent.command("directive").description("Record directives and acknowledgements");
     addProjectOptions(directive.command("record").description("Record a directive"))
@@ -373,7 +381,7 @@ export function registerLaneTrackerCommands(parent, deps, wrap) {
         }
         if (url.protocol !== "https:" && url.protocol !== "http:")
             fail("tracker_source_url_invalid", "Source URL must use HTTP or HTTPS", {});
-        const record = createRecord(store, "directive", company.slug, project, {
+        const record = await createRecord(store, "directive", company.slug, project, {
             text: options.text, date: validDate(options.date), source_url: options.sourceUrl,
             teams: [...new Set(teams)].sort(), policy_path: policyPath, acknowledgements: [],
         });
@@ -386,7 +394,7 @@ export function registerLaneTrackerCommands(parent, deps, wrap) {
         const { store } = await target(deps, options);
         const team = validSegment(options.team, "team");
         const lane = validSegment(options.lane, "lane");
-        const current = store.read("directive", id);
+        const current = await store.read("directive", id);
         if (!current)
             fail("tracker_record_not_found", `Tracker directive record ${id} was not found`, { kind: "directive", id });
         const teams = current.teams;
@@ -395,7 +403,7 @@ export function registerLaneTrackerCommands(parent, deps, wrap) {
             fail("tracker_team_not_targeted", "Team is not listed on this directive", { id, team });
         if (!Array.isArray(acknowledgements))
             fail("tracker_record_invalid", "Directive acknowledgements must be an array", { id });
-        const record = store.update("directive", id, current.version, (value) => ({
+        const record = await store.update("directive", id, current.version, (value) => ({
             ...value,
             acknowledgements: [...acknowledgements.filter((ack) => !(ack && typeof ack === "object" && ack.team === team && ack.lane_id === lane)), { team, lane_id: lane, at: deps.now().toISOString() }],
         }));
@@ -403,7 +411,7 @@ export function registerLaneTrackerCommands(parent, deps, wrap) {
     }));
     addProjectOptions(directive.command("list").description("List directives")).action(wrap(async (options) => {
         const { store } = await target(deps, options);
-        console.log(JSON.stringify({ ok: true, action: "directive.list", records: store.list("directive") }, null, 2));
+        console.log(JSON.stringify({ ok: true, action: "directive.list", records: await store.list("directive") }, null, 2));
     }));
 }
 export function defaultTrackerActor() {

package/dist/commands/lanes.d.ts

@@ -6,6 +6,7 @@
  * `watch` and the monitor reminder are the line-oriented text surfaces.
  */
 import { Command } from "commander";
+import { type TrackerMeshRequest } from "../lib/lanes/tracker-mesh.js";
 import type { OutpostIdentity } from "../lib/lanes/admission-host.js";
 export { OUTPOST_DIR, OUTPOST_ID_PATH, readOutpostIdentity } from "../lib/lanes/admission-host.js";
 export type { OutpostIdentity } from "../lib/lanes/admission-host.js";
@@ -102,6 +103,8 @@ export interface LanesCommandDeps {
     laneTrackerEnabled?: (company: LaneCompanyRef) => boolean | Promise<boolean>;
     /** The local-only PR 2 implementation refuses if mesh storage is enabled. */
     laneTrackerMeshEnabled?: (company: LaneCompanyRef) => boolean | Promise<boolean>;
+    /** Fake transport seam used by the disposable-root Work Mesh contract check. */
+    trackerMeshRequest?: TrackerMeshRequest;
     /** Test seam for the default-off host-scoped account-home writer gate. */
     laneHostScopedAccountHomesEnabled?: (company?: LaneCompanyRef | null) => boolean | Promise<boolean>;
     /** Test seam for recording approvals against the active identity. */