@indigoai-us/hq-cli 5.219.0 → 5.221.0

package/dist/lib/lanes/tracker-report.d.ts

@@ -0,0 +1,203 @@
+import type { QuestionBody } from "./questions.js";
+import type { QuestionRecord } from "./types.js";
+import type { TrackerRecord } from "./tracker-store.js";
+export type ReportStoryStatus = "queued" | "in_progress" | "review" | "done" | "dropped";
+export type ReportAudience = "owner" | "operator" | "lane";
+export type ApprovalState = "proposal" | "approved";
+export interface TrackerReportRecord extends TrackerRecord {
+    /** Absolute path of the validated on-disk record; used only in errors. */
+    source_path: string;
+}
+export interface TrackerReportStory {
+    id: string;
+    title: string;
+    status: ReportStoryStatus;
+    references?: string[];
+    updated_at?: string;
+    source_path: string;
+}
+export interface TrackerReportIssue {
+    path: string;
+    field: string;
+    message: string;
+    story_id?: string;
+    record_id?: string;
+    question_id?: string;
+}
+export interface TrackerReportPullRequest {
+    number: string;
+    title: string;
+    merged_at: string;
+    source_path: string;
+}
+export interface TrackerReportRelease {
+    version: string;
+    released_at: string;
+    source_path: string;
+}
+export interface TrackerReportQuestion {
+    record: QuestionRecord;
+    /** Loaded through the existing company-checked question body reader. */
+    body: QuestionBody;
+    current_audience: ReportAudience;
+    source_path: string;
+}
+export interface TrackerReportTeamInput {
+    company: string;
+    team: string;
+    project_id: string;
+    stories: readonly TrackerReportStory[];
+    pull_requests: readonly TrackerReportPullRequest[];
+    releases: readonly TrackerReportRelease[];
+    blockers: readonly TrackerReportRecord[];
+    kpis: readonly TrackerReportRecord[];
+    okrs: readonly TrackerReportRecord[];
+    directives: readonly TrackerReportRecord[];
+    questions: readonly TrackerReportQuestion[];
+    errors?: readonly TrackerReportIssue[];
+}
+export interface TrackerReportInput {
+    company: string;
+    generated_at: string;
+    since: string;
+    since_source: "explicit" | "previous_report" | "first_run";
+    teams: readonly TrackerReportTeamInput[];
+}
+export interface ReportTimedStory {
+    id: string;
+    title: string;
+    at: string;
+    references: string[];
+}
+export interface ReportPullRequest {
+    number: string;
+    title: string;
+    merged_at: string;
+}
+export interface ReportRelease {
+    version: string;
+    released_at: string;
+}
+export interface ReportKpiValue {
+    kpi_id: string;
+    name: string;
+    at: string;
+    value: number;
+    unit: string;
+    source: string;
+}
+export interface ReportQuestion {
+    question_id: string;
+    question: string;
+    asked_at: string;
+    audience: ReportAudience;
+    options: string[];
+    recommended?: string;
+    answer?: {
+        choice: string;
+        answered_at: string;
+        answered_by: string;
+    };
+}
+export interface ReportBlocker {
+    id: string;
+    story_id: string;
+    what: string;
+    waiting_on: string;
+    next_step: string;
+    opened_at: string;
+}
+export interface ReportDirective {
+    id: string;
+    text: string;
+    date: string;
+    acknowledgements: Array<{
+        team: string;
+        lane_id: string;
+        at: string;
+    }>;
+}
+export interface TrackerOwnerTeamReport {
+    team: string;
+    project_id: string;
+    errors: TrackerReportIssue[];
+    progress: {
+        stories_moved_to_done: ReportTimedStory[];
+        pull_requests_merged: ReportPullRequest[];
+        releases: ReportRelease[];
+        kpi_values: ReportKpiValue[];
+    };
+    questions_waiting_on_owner: ReportQuestion[];
+    open_blockers: ReportBlocker[];
+    decisions: {
+        directives: ReportDirective[];
+        answered_questions: ReportQuestion[];
+    };
+}
+export interface TrackerOwnerReport {
+    schema_version: "hq-lanes-owner-report.v1";
+    company: string;
+    generated_at: string;
+    since: string;
+    since_source: TrackerReportInput["since_source"];
+    teams: TrackerOwnerTeamReport[];
+}
+export interface TrackerTeamKpi {
+    id: string;
+    name: string;
+    definition: string;
+    unit: string;
+    target: number;
+    direction: "up" | "down";
+    status: ApprovalState;
+    latest_value: {
+        at: string;
+        value: number;
+        source: string;
+    } | null;
+    recent_values: Array<{
+        at: string;
+        value: number;
+        source: string;
+    }>;
+    trend: "improving" | "regressing" | "flat" | "insufficient_data";
+}
+export interface TrackerTeamOkr {
+    id: string;
+    objective: string;
+    period: string;
+    status: ApprovalState;
+    key_results: Array<{
+        text: string;
+        kpi_id: string;
+        target: number;
+    }>;
+}
+export interface TrackerTeamPage {
+    schema_version: "hq-lanes-team-page.v1";
+    company: string;
+    team: string;
+    project_id: string;
+    since: string;
+    errors: TrackerReportIssue[];
+    okrs: TrackerTeamOkr[];
+    kpis: TrackerTeamKpi[];
+    work_in_progress: Array<{
+        id: string;
+        title: string;
+        status: ReportStoryStatus;
+        references: string[];
+    }>;
+    work_done_since: ReportTimedStory[];
+    blockers: ReportBlocker[];
+    questions: ReportQuestion[];
+}
+/** Pure report projection. The caller owns loading, tenant checks, body reads and report-time persistence. */
+export declare function buildTrackerOwnerReport(input: TrackerReportInput): TrackerOwnerReport;
+/** Pure team page projection for already loaded, company-checked records. */
+export declare function buildTrackerTeamPage(team: TrackerReportTeamInput, company: string, sinceValue: string, generatedAtValue: string): TrackerTeamPage;
+/** Human-readable owner report, rendered without editing after the command runs. */
+export declare function renderTrackerOwnerReportText(report: TrackerOwnerReport): string;
+/** Human-readable team page, with proposal status visible beside each objective and KPI. */
+export declare function renderTrackerTeamPageText(page: TrackerTeamPage): string;
+//# sourceMappingURL=tracker-report.d.ts.map