@tomingtoming/kioq 0.7.0

package/dist/src/operationImpact.js

@@ -0,0 +1,68 @@
+export function summarizeDeleteImpact(args) {
+    const reasons = [];
+    if (args.projectUnresolvedDelta > 0) {
+        reasons.push("broken_links_after_delete");
+    }
+    if (args.backlinksToDeleted >= 10) {
+        reasons.push("heavily_referenced_note");
+    }
+    else if (args.backlinksToDeleted > 0) {
+        reasons.push("referenced_by_other_notes");
+    }
+    if (args.projectUnresolvedDelta > 0 || args.backlinksToDeleted >= 10) {
+        return {
+            impactScore: "high",
+            requiresBackup: true,
+            reasons,
+        };
+    }
+    if (args.backlinksToDeleted > 0) {
+        return {
+            impactScore: "medium",
+            requiresBackup: true,
+            reasons,
+        };
+    }
+    return {
+        impactScore: "low",
+        requiresBackup: false,
+        reasons: ["isolated_note"],
+    };
+}
+export function summarizeRenameImpact(args) {
+    const reasons = [];
+    if (args.projectUnresolvedDelta > 0) {
+        reasons.push("broken_links_after_rename");
+    }
+    if (args.updatedLinks >= 25 || args.updatedFiles >= 10) {
+        reasons.push("wide_link_propagation");
+    }
+    else if (args.updatedLinks > 0 || args.updatedFiles > 0) {
+        reasons.push("link_propagation");
+    }
+    if (args.backlinkCount >= 10) {
+        reasons.push("heavily_referenced_note");
+    }
+    else if (args.backlinkCount > 0) {
+        reasons.push("referenced_note");
+    }
+    if (args.projectUnresolvedDelta > 0 || args.updatedLinks >= 25 || args.updatedFiles >= 10) {
+        return {
+            impactScore: "high",
+            requiresBackup: true,
+            reasons,
+        };
+    }
+    if (args.updatedLinks > 0 || args.updatedFiles > 0 || args.backlinkCount > 0) {
+        return {
+            impactScore: "medium",
+            requiresBackup: args.updatedLinks >= 15 || args.updatedFiles >= 5 || args.backlinkCount >= 10,
+            reasons,
+        };
+    }
+    return {
+        impactScore: "low",
+        requiresBackup: false,
+        reasons: ["local_rename_only"],
+    };
+}

package/dist/src/readResponseSummary.js

@@ -0,0 +1,252 @@
+function summarizeListResponse(args) {
+    if (args.resultCount === 0) {
+        return {
+            primaryNavigationSignal: "no_results",
+            primaryQualitySignal: "no_results",
+            nextRecommendedAction: args.emptyAction,
+        };
+    }
+    if (args.indexCandidateCount > 0) {
+        return {
+            primaryNavigationSignal: "index_candidates_available",
+            primaryQualitySignal: "results_available",
+            nextRecommendedAction: "open_index_candidate",
+            nextRecommendedTarget: args.firstIndexCandidateTitle,
+        };
+    }
+    if (args.hasIndexLikeResult) {
+        return {
+            primaryNavigationSignal: "index_result_in_list",
+            primaryQualitySignal: "results_available",
+            nextRecommendedAction: "open_index_result",
+            nextRecommendedTarget: args.firstIndexLikeTitle,
+        };
+    }
+    return {
+        primaryNavigationSignal: "direct_results_available",
+        primaryQualitySignal: "results_available",
+        nextRecommendedAction: "open_note",
+        nextRecommendedTarget: args.firstResultTitle,
+    };
+}
+export function summarizeRecentResponse(args) {
+    return summarizeListResponse({
+        ...args,
+        emptyAction: "adjust_directory_or_write_note",
+    });
+}
+export function summarizeSearchResponse(args) {
+    return summarizeListResponse({
+        ...args,
+        emptyAction: "refine_query",
+    });
+}
+export function summarizeReadNoteResponse(args) {
+    const qualitySignal = args.unresolvedWikiLinkCount > 0
+        ? "unresolved_wikilinks_present"
+        : args.boundaryWarningCount > 0
+            ? "boundary_warning_present"
+            : args.orphanWarning
+                ? "orphan_warning"
+                : args.clarityAttention
+                    ? "clarity_attention_present"
+                    : args.backlinkCount === 0
+                        ? "low_backlink_support"
+                        : "note_health_ok";
+    if (args.unresolvedWikiLinkCount > 0) {
+        return {
+            primaryNavigationSignal: args.indexLike
+                ? "current_note_is_index"
+                : args.indexCandidateTitle
+                    ? "index_candidate_available"
+                    : "direct_note_read",
+            primaryQualitySignal: qualitySignal,
+            nextRecommendedAction: "resolve_unresolved_links",
+        };
+    }
+    if (args.boundaryWarningCount > 0) {
+        return {
+            primaryNavigationSignal: args.indexLike
+                ? "current_note_is_index"
+                : args.indexCandidateTitle
+                    ? "index_candidate_available"
+                    : "direct_note_read",
+            primaryQualitySignal: qualitySignal,
+            nextRecommendedAction: "review_boundary_warnings",
+        };
+    }
+    if (args.clarityAttention) {
+        return {
+            primaryNavigationSignal: args.indexLike
+                ? "current_note_is_index"
+                : args.indexCandidateTitle
+                    ? "index_candidate_available"
+                    : "direct_note_read",
+            primaryQualitySignal: qualitySignal,
+            nextRecommendedAction: "review_document_clarity",
+        };
+    }
+    if (args.indexLike) {
+        return {
+            primaryNavigationSignal: "current_note_is_index",
+            primaryQualitySignal: qualitySignal,
+            nextRecommendedAction: "continue_from_index",
+        };
+    }
+    if (args.indexCandidateTitle) {
+        return {
+            primaryNavigationSignal: "index_candidate_available",
+            primaryQualitySignal: qualitySignal,
+            nextRecommendedAction: "open_index_candidate",
+            nextRecommendedTarget: args.indexCandidateTitle,
+        };
+    }
+    return {
+        primaryNavigationSignal: "direct_note_read",
+        primaryQualitySignal: qualitySignal,
+        nextRecommendedAction: "continue_reading_note",
+    };
+}
+export function summarizeResolveLinksResponse(args) {
+    const qualitySignal = args.unresolvedLinkCount > 0
+        ? "unresolved_links_present"
+        : args.boundaryWarningCount > 0
+            ? "boundary_warning_present"
+            : "all_links_resolved";
+    if (args.unresolvedLinkCount > 0) {
+        return {
+            primaryNavigationSignal: args.indexLike
+                ? "current_note_is_index"
+                : args.indexCandidateTitle
+                    ? "index_candidate_available"
+                    : "direct_link_audit",
+            primaryQualitySignal: qualitySignal,
+            nextRecommendedAction: "resolve_unresolved_links",
+        };
+    }
+    if (args.boundaryWarningCount > 0) {
+        return {
+            primaryNavigationSignal: args.indexLike
+                ? "current_note_is_index"
+                : args.indexCandidateTitle
+                    ? "index_candidate_available"
+                    : "direct_link_audit",
+            primaryQualitySignal: qualitySignal,
+            nextRecommendedAction: "review_boundary_warnings",
+        };
+    }
+    if (args.indexLike) {
+        return {
+            primaryNavigationSignal: "current_note_is_index",
+            primaryQualitySignal: qualitySignal,
+            nextRecommendedAction: "continue_from_index",
+        };
+    }
+    if (args.indexCandidateTitle) {
+        return {
+            primaryNavigationSignal: "index_candidate_available",
+            primaryQualitySignal: qualitySignal,
+            nextRecommendedAction: "open_index_candidate",
+            nextRecommendedTarget: args.indexCandidateTitle,
+        };
+    }
+    return {
+        primaryNavigationSignal: "direct_link_audit",
+        primaryQualitySignal: qualitySignal,
+        nextRecommendedAction: "review_link_targets",
+    };
+}
+export function summarizeBacklinksResponse(args) {
+    const qualitySignal = args.boundaryWarningCount > 0
+        ? "boundary_warning_present"
+        : args.backlinkCount > 0
+            ? "backlinks_available"
+            : "no_backlinks";
+    if (args.boundaryWarningCount > 0) {
+        return {
+            primaryNavigationSignal: args.indexLike
+                ? "current_note_is_index"
+                : args.indexCandidateTitle
+                    ? "index_candidate_available"
+                    : "backlink_view",
+            primaryQualitySignal: qualitySignal,
+            nextRecommendedAction: "review_boundary_warnings",
+        };
+    }
+    if (args.indexLike) {
+        return {
+            primaryNavigationSignal: "current_note_is_index",
+            primaryQualitySignal: qualitySignal,
+            nextRecommendedAction: args.backlinkCount > 0 ? "open_backlink" : "continue_from_index",
+            nextRecommendedTarget: args.backlinkCount > 0 ? args.firstBacklinkTitle : undefined,
+        };
+    }
+    if (args.backlinkCount > 0) {
+        return {
+            primaryNavigationSignal: args.indexCandidateTitle ? "index_candidate_available" : "backlink_view",
+            primaryQualitySignal: qualitySignal,
+            nextRecommendedAction: "open_backlink",
+            nextRecommendedTarget: args.firstBacklinkTitle,
+        };
+    }
+    if (args.indexCandidateTitle) {
+        return {
+            primaryNavigationSignal: "index_candidate_available",
+            primaryQualitySignal: qualitySignal,
+            nextRecommendedAction: "open_index_candidate",
+            nextRecommendedTarget: args.indexCandidateTitle,
+        };
+    }
+    return {
+        primaryNavigationSignal: "backlink_view",
+        primaryQualitySignal: qualitySignal,
+        nextRecommendedAction: "add_or_check_references",
+    };
+}
+export function summarizeContextBundleResponse(args) {
+    const qualitySignal = args.boundaryWarningCount > 0
+        ? "boundary_warning_present"
+        : args.bundleItemCount > 0
+            ? "related_context_available"
+            : "no_related_context";
+    if (args.boundaryWarningCount > 0) {
+        return {
+            primaryNavigationSignal: args.sourceIndexLike
+                ? "source_note_is_index"
+                : args.indexCandidateTitle
+                    ? "index_candidate_available"
+                    : "bundle_context_ready",
+            primaryQualitySignal: qualitySignal,
+            nextRecommendedAction: "review_boundary_warnings",
+        };
+    }
+    if (args.sourceIndexLike) {
+        return {
+            primaryNavigationSignal: "source_note_is_index",
+            primaryQualitySignal: qualitySignal,
+            nextRecommendedAction: args.bundleItemCount > 0 ? "open_bundle_item" : "continue_from_index",
+            nextRecommendedTarget: args.bundleItemCount > 0 ? args.firstBundleItemTitle : undefined,
+        };
+    }
+    if (args.bundleItemCount > 0) {
+        return {
+            primaryNavigationSignal: args.indexCandidateTitle ? "index_candidate_available" : "bundle_context_ready",
+            primaryQualitySignal: qualitySignal,
+            nextRecommendedAction: "open_bundle_item",
+            nextRecommendedTarget: args.firstBundleItemTitle,
+        };
+    }
+    if (args.indexCandidateTitle) {
+        return {
+            primaryNavigationSignal: "index_candidate_available",
+            primaryQualitySignal: qualitySignal,
+            nextRecommendedAction: "open_index_candidate",
+            nextRecommendedTarget: args.indexCandidateTitle,
+        };
+    }
+    return {
+        primaryNavigationSignal: "bundle_context_ready",
+        primaryQualitySignal: qualitySignal,
+        nextRecommendedAction: "broaden_context",
+    };
+}

package/dist/src/responseMode.js

@@ -0,0 +1,12 @@
+export const RESPONSE_MODE_VALUES = ["minimal", "standard", "verbose"];
+const RESPONSE_MODE_RANK = {
+    minimal: 0,
+    standard: 1,
+    verbose: 2,
+};
+export function normalizeResponseMode(mode) {
+    return mode ?? "standard";
+}
+export function responseModeAtLeast(mode, threshold) {
+    return RESPONSE_MODE_RANK[mode] >= RESPONSE_MODE_RANK[threshold];
+}