@tomingtoming/kioq 0.9.0 → 0.9.2

package/dist/src/index.js

@@ -1,3 +1,4 @@
+import path from "node:path";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
@@ -114,11 +115,14 @@ function appendBoundaryWarnings(lines, warnings) {
         lines.push(`   suggestion: ${warning.suggestion}`);
     });
 }
-function appendScopeLabel(lines, scopeLabel) {
-    lines.push(`scope_label: ${scopeLabel}`);
+function appendScopeLabel(_lines, _scopeLabel) {
+    // Removed: scope_label duplicates tool name, adds no value for AI
 }
 function appendResponsibilityWarning(lines, warnings) {
-    lines.push(`responsibility_warning: ${responsibilityWarningCode(warnings)}`);
+    const code = responsibilityWarningCode(warnings);
+    if (code === "none")
+        return;
+    lines.push(`responsibility_warning: ${code}`);
 }
 function appendTemplateHints(lines, hints) {
     lines.push(`template_hint_primary: ${hints.primary}`);
@@ -263,10 +267,9 @@ function appendAuditResponseSummary(lines, summary) {
     }
 }
 function appendChangeTriggerSummary(lines, summary) {
-    lines.push(`change_trigger: ${summary.code}`);
-    if (summary.code === "none") {
+    if (summary.code === "none")
         return;
-    }
+    lines.push(`change_trigger: ${summary.code}`);
     lines.push(`trigger_confidence: ${summary.confidence}`);
     lines.push(`cascade_targets: ${summary.cascadeTargets?.join(", ") ?? "(none)"}`);
     lines.push(`noise_risk: ${summary.noiseRisk}`);
@@ -277,9 +280,7 @@ function appendOperationImpact(lines, impact) {
     lines.push(`impact_reasons: ${impact.reasons.join(", ")}`);
 }
 function appendConflictSummary(lines, summary) {
-    lines.push(`conflict_type: ${summary.conflictType}`);
     lines.push(`server_updated: ${summary.serverUpdated}`);
-    lines.push(`retry_hint: ${summary.retryHint}`);
 }
 const responseModeSchema = z.enum(RESPONSE_MODE_VALUES).optional().describe("default: standard");
 async function main() {
@@ -291,7 +292,13 @@ async function main() {
     const store = new LocalNoteStore(config, storage);
     const signalLog = new SignalLog(storage);
     const engagementIndex = new EngagementIndex();
+    let storageContextEmitted = false;
+    const projectName = path.basename(config.root);
     const appendStorageContext = (lines) => {
+        if (storageContextEmitted)
+            return;
+        storageContextEmitted = true;
+        lines.push(`project: ${projectName}`);
         lines.push(`storage_backend: ${config.github ? "github" : "filesystem"}`);
         lines.push(`storage_root: ${config.root}`);
         if (config.github) {
@@ -299,16 +306,35 @@ async function main() {
             lines.push(`storage_branch: ${config.github.branch}`);
         }
     };
+    /** Returns storage context lines only on first call, empty array after. */
+    const storageContextLines = () => {
+        if (storageContextEmitted)
+            return [];
+        storageContextEmitted = true;
+        return [
+            `project: ${projectName}`,
+            `storage_backend: ${config.github ? "github" : "filesystem"}`,
+            `storage_root: ${config.root}`,
+            ...(config.github
+                ? [`storage_repo: ${config.github.owner}/${config.github.repo}`, `storage_branch: ${config.github.branch}`]
+                : []),
+        ];
+    };
     const appendAutoProjectHealth = async (lines) => {
         try {
             const health = await store.lintStructure({
                 limit: 3,
             });
+            const hasAttention = health.unresolvedWikiLinkCount > 0
+                || health.duplicateWarningCount > 0
+                || health.technicalDebtSignals.dependencyDirectionViolationCount > 0
+                || health.orphanNoteCount > 0;
+            if (!hasAttention)
+                return;
             appendProjectHealthSummary(lines, health);
         }
-        catch (error) {
-            lines.push("");
-            lines.push(`project_health: unavailable (${normalizeError(error)})`);
+        catch {
+            // silently skip if lint fails
         }
     };
     const server = new McpServer({
@@ -335,9 +361,7 @@ async function main() {
         });
         await signalLog.flush();
         const lines = [];
-        lines.push(`project: ${result.project}`);
         appendStorageContext(lines);
-        lines.push(`scope_label: orient`);
         lines.push(`thought: ${thought.slice(0, 200)}`);
         lines.push("");
         if (result.relevant.length > 0) {
@@ -404,13 +428,10 @@ async function main() {
         });
         const lines = [];
         lines.push(`検索クエリ: ${query}`);
-        lines.push(`対象プロジェクト: ${result.project}`);
         appendStorageContext(lines);
-        appendScopeLabel(lines, TOOL_SCOPE_LABELS.search_notes);
-        lines.push(`response_mode: ${responseMode}`);
-        appendReadResponseSummary(lines, summary);
         lines.push(`ヒット件数: ${result.results.length}`);
-        lines.push(`exact_identifier_matches: ${result.exactIdentifierMatchCount}`);
+        if (result.exactIdentifierMatchCount > 0)
+            lines.push(`exact_identifier_matches: ${result.exactIdentifierMatchCount}`);
         lines.push("");
         if (result.results.length === 0) {
             lines.push("候補が見つかりませんでした。");
@@ -423,11 +444,13 @@ async function main() {
                 if (responseModeAtLeast(responseMode, "standard")) {
                     lines.push(`   permalink: ${item.permalink}`);
                     lines.push(`   file: ${item.filePath}`);
-                    lines.push(`   exact_identifier_match: ${item.exactIdentifierMatch ? "yes" : "no"}`);
-                    lines.push(`   index_like: ${item.indexLike ? "yes" : "no"}`);
+                    if (item.exactIdentifierMatch)
+                        lines.push(`   exact_identifier_match: yes`);
+                    if (item.indexLike)
+                        lines.push(`   index_like: yes`);
                 }
-                if (responseModeAtLeast(responseMode, "verbose")) {
-                    lines.push(`   index_like_reasons: ${item.indexLike && item.indexReasons.length > 0 ? item.indexReasons.join(", ") : "(none)"}`);
+                if (responseModeAtLeast(responseMode, "verbose") && item.indexLike && item.indexReasons.length > 0) {
+                    lines.push(`   index_like_reasons: ${item.indexReasons.join(", ")}`);
                 }
             });
         }
@@ -465,30 +488,18 @@ async function main() {
             });
             const lines = [
                 `identifier: ${identifier}`,
-                `project: ${result.project}`,
-                `storage_backend: ${config.github ? "github" : "filesystem"}`,
-                `storage_root: ${config.root}`,
-                `scope_label: ${TOOL_SCOPE_LABELS.read_note}`,
-                `response_mode: ${responseMode}`,
-                `primary_navigation_signal: ${summary.primaryNavigationSignal}`,
-                `primary_quality_signal: ${summary.primaryQualitySignal}`,
-                `next_recommended_action: ${summary.nextRecommendedAction}`,
+                ...storageContextLines(),
                 `file: ${result.note.relativePath}`,
                 `permalink: ${result.note.permalink}`,
             ];
-            if (config.github) {
-                lines.splice(4, 0, `storage_repo: ${config.github.owner}/${config.github.repo}`, `storage_branch: ${config.github.branch}`);
-            }
-            if (summary.nextRecommendedTarget) {
-                insertBeforeLine(lines, "next_recommended_action:", `next_recommended_target: ${summary.nextRecommendedTarget}`);
-            }
             appendChangeTriggerSummary(lines, changeTrigger);
             appendResponsibilityWarning(lines, result.boundaryWarnings);
             appendBoundaryWarnings(lines, result.boundaryWarnings);
             if (responseModeAtLeast(responseMode, "standard")) {
                 lines.push(`link_health: ${result.linkHealth.resolved}/${result.linkHealth.total} resolved`);
                 lines.push(`backlinks: ${result.backlinkCount}`);
-                lines.push(`orphan_warning: ${result.orphanWarning ? "yes" : "no"}`);
+                if (result.orphanWarning)
+                    lines.push(`orphan_warning: yes`);
                 appendDocumentClarity(lines, result.documentClarity, responseModeAtLeast(responseMode, "verbose"));
                 appendUnresolvedWikiLinks(lines, result.unresolvedWikiLinks);
             }
@@ -528,7 +539,8 @@ async function main() {
                     lines.push(`   score: ${item.score}`);
                     lines.push(`   permalink: ${item.permalink}`);
                     lines.push(`   file: ${item.filePath}`);
-                    lines.push(`   exact_identifier_match: ${item.exactIdentifierMatch ? "yes" : "no"}`);
+                    if (item.exactIdentifierMatch)
+                        lines.push(`   exact_identifier_match: yes`);
                 });
             }
             return textResult(lines.join("\n"));
@@ -582,10 +594,7 @@ async function main() {
             titleBodyMismatchCandidateCount: summaryBase.titleBodyMismatchCandidateCount,
         });
         const lines = [];
-        lines.push(`project: ${result.project}`);
         appendStorageContext(lines);
-        appendScopeLabel(lines, TOOL_SCOPE_LABELS.lint_structure);
-        lines.push(`response_mode: ${responseMode}`);
         appendAuditResponseSummary(lines, summary);
         appendChangeTriggerSummary(lines, changeTrigger);
         lines.push(`notes: ${result.noteCount}`);
@@ -701,11 +710,6 @@ async function main() {
             });
             const flowLines = [
                 "flow ノートを作成/更新しました。",
-                `project: ${flowResult.project}`,
-                `scope_label: ${TOOL_SCOPE_LABELS.write_flow_note}`,
-                `primary_navigation_signal: ${flowSummary.primaryNavigationSignal}`,
-                `primary_quality_signal: ${flowSummary.primaryQualitySignal}`,
-                `next_recommended_action: ${flowSummary.nextRecommendedAction}`,
                 `operation: ${flowResult.operation}`,
                 `file: ${flowResult.relativePath}`,
                 `permalink: ${flowResult.permalink}`,
@@ -715,12 +719,9 @@ async function main() {
                 `parent_stock_resolved: ${flowResult.parentStockResolved ? "yes" : "no"}`,
                 `link_health: ${flowResult.linkHealth.resolved}/${flowResult.linkHealth.total} resolved`,
                 `backlinks: ${flowResult.backlinkCount}`,
-                `orphan_warning: ${flowResult.orphanWarning ? "yes" : "no"}`,
             ];
-            flowLines.splice(2, 0, ...[`storage_backend: ${config.github ? "github" : "filesystem"}`, `storage_root: ${config.root}`, ...(config.github ? [`storage_repo: ${config.github.owner}/${config.github.repo}`, `storage_branch: ${config.github.branch}`] : [])]);
-            if (flowSummary.nextRecommendedTarget) {
-                insertBeforeLine(flowLines, "next_recommended_action:", `next_recommended_target: ${flowSummary.nextRecommendedTarget}`);
-            }
+            if (flowResult.orphanWarning)
+                flowLines.push(`orphan_warning: yes`);
             appendConflictSummary(flowLines, summarizeNoConflict({ serverUpdated: flowResult.serverUpdated }));
             appendResponsibilityWarning(flowLines, flowResult.boundaryWarnings);
             appendStructureScore(flowLines, flowResult.structureScore);
@@ -752,40 +753,26 @@ async function main() {
         });
         const lines = [
             "ノートを作成/更新しました。",
-            `project: ${result.project}`,
-            `scope_label: ${TOOL_SCOPE_LABELS.write_note}`,
-            `primary_navigation_signal: ${summary.primaryNavigationSignal}`,
-            `primary_quality_signal: ${summary.primaryQualitySignal}`,
-            `next_recommended_action: ${summary.nextRecommendedAction}`,
             `operation: ${result.operation}`,
             `file: ${result.relativePath}`,
             `permalink: ${result.permalink}`,
             `title: ${result.title}`,
             `link_health: ${result.linkHealth.resolved}/${result.linkHealth.total} resolved`,
             `backlinks: ${result.backlinkCount}`,
-            `orphan_warning: ${result.orphanWarning ? "yes" : "no"}`,
         ];
-        lines.splice(2, 0, ...[
-            `storage_backend: ${config.github ? "github" : "filesystem"}`,
-            `storage_root: ${config.root}`,
-            ...(config.github
-                ? [`storage_repo: ${config.github.owner}/${config.github.repo}`, `storage_branch: ${config.github.branch}`]
-                : []),
-        ]);
-        if (summary.nextRecommendedTarget) {
-            insertBeforeLine(lines, "next_recommended_action:", `next_recommended_target: ${summary.nextRecommendedTarget}`);
-        }
         appendConflictSummary(lines, summarizeNoConflict({ serverUpdated: result.serverUpdated }));
         appendResponsibilityWarning(lines, result.boundaryWarnings);
         appendStructureScore(lines, result.structureScore);
         appendMemoryContract(lines, result.memoryContract);
         appendBoundaryWarnings(lines, result.boundaryWarnings);
-        appendTemplateHints(lines, {
-            primary: "stock",
-            alternatives: ["index"],
-            reason: "通常ノートとして知識を残すときは stock template を基準にする",
-            whenToSwitch: "再訪導線を固定したい入口ノートなら index template に切り替える",
-        });
+        if (result.memoryContract.status === "fail") {
+            appendTemplateHints(lines, {
+                primary: "stock",
+                alternatives: ["index"],
+                reason: "通常ノートとして知識を残すときは stock template を基準にする",
+                whenToSwitch: "再訪導線を固定したい入口ノートなら index template に切り替える",
+            });
+        }
         appendUnresolvedWikiLinks(lines, result.unresolvedWikiLinks);
         appendUnresolvedLinkHints(lines, result.unresolvedLinkHints);
         appendDuplicateWarnings(lines, result.duplicateWarnings);
@@ -812,11 +799,6 @@ async function main() {
         });
         const lines = [
             "flow を stock に昇格しました。",
-            `project: ${result.project}`,
-            `scope_label: ${TOOL_SCOPE_LABELS.promote_to_stock}`,
-            `primary_navigation_signal: ${summary.primaryNavigationSignal}`,
-            `primary_quality_signal: ${summary.primaryQualitySignal}`,
-            `next_recommended_action: ${summary.nextRecommendedAction}`,
             `source_flow: ${result.sourceFlow.title}`,
             `source_file: ${result.sourceFlow.relativePath}`,
             `source_permalink: ${result.sourceFlow.permalink}`,
@@ -825,16 +807,6 @@ async function main() {
             `stock_permalink: ${result.stock.permalink}`,
             `flow_state: ${result.flowState}`,
         ];
-        lines.splice(2, 0, ...[
-            `storage_backend: ${config.github ? "github" : "filesystem"}`,
-            `storage_root: ${config.root}`,
-            ...(config.github
-                ? [`storage_repo: ${config.github.owner}/${config.github.repo}`, `storage_branch: ${config.github.branch}`]
-                : []),
-        ]);
-        if (summary.nextRecommendedTarget) {
-            insertBeforeLine(lines, "next_recommended_action:", `next_recommended_target: ${summary.nextRecommendedTarget}`);
-        }
         appendTemplateHints(lines, {
             primary: "stock",
             alternatives: ["index"],
@@ -871,35 +843,19 @@ async function main() {
         });
         const lines = [
             "ノートを処理しました。",
-            `project: ${result.project}`,
-            `scope_label: ${TOOL_SCOPE_LABELS.append_note}`,
-            `primary_navigation_signal: ${summary.primaryNavigationSignal}`,
-            `primary_quality_signal: ${summary.primaryQualitySignal}`,
-            `next_recommended_action: ${summary.nextRecommendedAction}`,
             `operation: ${result.operation}`,
             `file: ${result.relativePath}`,
             `permalink: ${result.permalink}`,
             `title: ${result.title}`,
             `link_health: ${result.linkHealth.resolved}/${result.linkHealth.total} resolved`,
             `backlinks: ${result.backlinkCount}`,
-            `orphan_warning: ${result.orphanWarning ? "yes" : "no"}`,
         ];
-        lines.splice(2, 0, ...[
-            `storage_backend: ${config.github ? "github" : "filesystem"}`,
-            `storage_root: ${config.root}`,
-            ...(config.github
-                ? [`storage_repo: ${config.github.owner}/${config.github.repo}`, `storage_branch: ${config.github.branch}`]
-                : []),
-        ]);
-        if (summary.nextRecommendedTarget) {
-            insertBeforeLine(lines, "next_recommended_action:", `next_recommended_target: ${summary.nextRecommendedTarget}`);
-        }
         appendConflictSummary(lines, summarizeNoConflict({ serverUpdated: result.serverUpdated }));
         appendResponsibilityWarning(lines, result.boundaryWarnings);
         appendStructureScore(lines, result.structureScore);
         appendMemoryContract(lines, result.memoryContract);
         appendBoundaryWarnings(lines, result.boundaryWarnings);
-        if (result.operation === "created") {
+        if (result.operation === "created" && result.memoryContract.status === "fail") {
             appendTemplateHints(lines, {
                 primary: "stock",
                 alternatives: ["index"],
@@ -932,11 +888,6 @@ async function main() {
         });
         const lines = [
             "ノートを削除しました。",
-            `project: ${result.project}`,
-            `scope_label: ${TOOL_SCOPE_LABELS.delete_note}`,
-            `primary_navigation_signal: ${summary.primaryNavigationSignal}`,
-            `primary_quality_signal: ${summary.primaryQualitySignal}`,
-            `next_recommended_action: ${summary.nextRecommendedAction}`,
             `deleted: ${result.title} (${result.relativePath})`,
             `permalink: ${result.permalink}`,
             `backlinks_to_deleted: ${result.backlinksToDeleted}`,
@@ -945,16 +896,6 @@ async function main() {
             `project_link_health_after: ${result.projectLinkHealthAfter.resolved}/${result.projectLinkHealthAfter.total}`,
             `project_unresolved_delta: ${projectUnresolvedDelta}`,
         ];
-        lines.splice(2, 0, ...[
-            `storage_backend: ${config.github ? "github" : "filesystem"}`,
-            `storage_root: ${config.root}`,
-            ...(config.github
-                ? [`storage_repo: ${config.github.owner}/${config.github.repo}`, `storage_branch: ${config.github.branch}`]
-                : []),
-        ]);
-        if (summary.nextRecommendedTarget) {
-            insertBeforeLine(lines, "next_recommended_action:", `next_recommended_target: ${summary.nextRecommendedTarget}`);
-        }
         appendConflictSummary(lines, summarizeNoConflict({ serverUpdated: result.serverUpdated }));
         appendOperationImpact(lines, impact);
         appendStructureScore(lines, result.structureScoreBeforeDelete);
@@ -996,32 +937,16 @@ async function main() {
         });
         const lines = [
             "ノートをリネームしました。",
-            `project: ${result.project}`,
-            `scope_label: ${TOOL_SCOPE_LABELS.rename_note}`,
-            `primary_navigation_signal: ${summary.primaryNavigationSignal}`,
-            `primary_quality_signal: ${summary.primaryQualitySignal}`,
-            `next_recommended_action: ${summary.nextRecommendedAction}`,
             `old: ${result.oldTitle} (${result.oldRelativePath})`,
             `new: ${result.newTitle} (${result.newRelativePath})`,
             `links_updated: ${result.updatedLinks}`,
             `files_updated: ${result.updatedFiles}`,
             `renamed_note_link_health: ${result.renamedNoteLinkHealth.resolved}/${result.renamedNoteLinkHealth.total}`,
             `backlinks: ${result.backlinkCount}`,
-            `orphan_warning: ${result.orphanWarning ? "yes" : "no"}`,
             `project_link_health_before: ${result.projectLinkHealthBefore.resolved}/${result.projectLinkHealthBefore.total}`,
             `project_link_health_after: ${result.projectLinkHealthAfter.resolved}/${result.projectLinkHealthAfter.total}`,
             `project_unresolved_delta: ${projectUnresolvedDelta}`,
         ];
-        lines.splice(2, 0, ...[
-            `storage_backend: ${config.github ? "github" : "filesystem"}`,
-            `storage_root: ${config.root}`,
-            ...(config.github
-                ? [`storage_repo: ${config.github.owner}/${config.github.repo}`, `storage_branch: ${config.github.branch}`]
-                : []),
-        ]);
-        if (summary.nextRecommendedTarget) {
-            insertBeforeLine(lines, "next_recommended_action:", `next_recommended_target: ${summary.nextRecommendedTarget}`);
-        }
         appendConflictSummary(lines, summarizeNoConflict({ serverUpdated: result.serverUpdated }));
         appendOperationImpact(lines, impact);
         appendStructureScore(lines, result.structureScore);

package/dist/src/storage/githubStorage.js

@@ -354,7 +354,7 @@ export class GitHubStorage {
     }
     async pullLocal(context) {
         try {
-            await this.execFileAsyncFn("git", ["pull", "--ff-only"], {
+            await this.execFileAsyncFn("git", ["pull", "--ff-only", "origin", this.branch], {
                 cwd: this.rootPath,
                 timeout: 30_000,
             });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomingtoming/kioq",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Japanese-first local markdown MCP server",
   "type": "module",
   "bin": {