@tomingtoming/kioq 0.9.0 → 0.9.1

package/dist/src/index.js

@@ -118,7 +118,10 @@ function appendScopeLabel(lines, scopeLabel) {
     lines.push(`scope_label: ${scopeLabel}`);
 }
 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 +266,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 +279,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 +291,11 @@ async function main() {
     const store = new LocalNoteStore(config, storage);
     const signalLog = new SignalLog(storage);
     const engagementIndex = new EngagementIndex();
+    let storageContextEmitted = false;
     const appendStorageContext = (lines) => {
+        if (storageContextEmitted)
+            return;
+        storageContextEmitted = true;
         lines.push(`storage_backend: ${config.github ? "github" : "filesystem"}`);
         lines.push(`storage_root: ${config.root}`);
         if (config.github) {
@@ -299,16 +303,34 @@ 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 [
+            `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({
@@ -423,11 +445,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(", ")}`);
                 }
             });
         }
@@ -466,8 +490,7 @@ async function main() {
             const lines = [
                 `identifier: ${identifier}`,
                 `project: ${result.project}`,
-                `storage_backend: ${config.github ? "github" : "filesystem"}`,
-                `storage_root: ${config.root}`,
+                ...storageContextLines(),
                 `scope_label: ${TOOL_SCOPE_LABELS.read_note}`,
                 `response_mode: ${responseMode}`,
                 `primary_navigation_signal: ${summary.primaryNavigationSignal}`,
@@ -476,9 +499,6 @@ async function main() {
                 `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}`);
             }
@@ -488,7 +508,8 @@ async function main() {
             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 +549,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"));
@@ -715,9 +737,10 @@ 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 (flowResult.orphanWarning)
+                flowLines.push(`orphan_warning: yes`);
+            flowLines.splice(2, 0, ...storageContextLines());
             if (flowSummary.nextRecommendedTarget) {
                 insertBeforeLine(flowLines, "next_recommended_action:", `next_recommended_target: ${flowSummary.nextRecommendedTarget}`);
             }
@@ -763,15 +786,8 @@ async function main() {
             `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}`]
-                : []),
-        ]);
+        lines.splice(2, 0, ...storageContextLines());
         if (summary.nextRecommendedTarget) {
             insertBeforeLine(lines, "next_recommended_action:", `next_recommended_target: ${summary.nextRecommendedTarget}`);
         }
@@ -780,12 +796,14 @@ async function main() {
         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);
@@ -825,13 +843,7 @@ 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}`]
-                : []),
-        ]);
+        lines.splice(2, 0, ...storageContextLines());
         if (summary.nextRecommendedTarget) {
             insertBeforeLine(lines, "next_recommended_action:", `next_recommended_target: ${summary.nextRecommendedTarget}`);
         }
@@ -882,15 +894,8 @@ async function main() {
             `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}`]
-                : []),
-        ]);
+        lines.splice(2, 0, ...storageContextLines());
         if (summary.nextRecommendedTarget) {
             insertBeforeLine(lines, "next_recommended_action:", `next_recommended_target: ${summary.nextRecommendedTarget}`);
         }
@@ -899,7 +904,7 @@ async function main() {
         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"],
@@ -945,13 +950,7 @@ 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}`]
-                : []),
-        ]);
+        lines.splice(2, 0, ...storageContextLines());
         if (summary.nextRecommendedTarget) {
             insertBeforeLine(lines, "next_recommended_action:", `next_recommended_target: ${summary.nextRecommendedTarget}`);
         }
@@ -1007,18 +1006,11 @@ async function main() {
             `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}`]
-                : []),
-        ]);
+        lines.splice(2, 0, ...storageContextLines());
         if (summary.nextRecommendedTarget) {
             insertBeforeLine(lines, "next_recommended_action:", `next_recommended_target: ${summary.nextRecommendedTarget}`);
         }

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.1",
   "description": "Japanese-first local markdown MCP server",
   "type": "module",
   "bin": {