@useshifu/coding-harness 0.3.24 → 0.3.26

package/bin/onboarding-ui.js

@@ -0,0 +1,143 @@
+const HARNESS_NAMES = {
+  codex: "Codex",
+  claude_code: "Claude Code",
+  opencode: "OpenCode",
+};
+
+function presentation({ isTTY = false, columns = 80, env = process.env } = {}) {
+  const rich = isTTY && env.TERM !== "dumb" && columns >= 64;
+  return { rich, color: rich && env.NO_COLOR === undefined, width: Math.max(24, Math.min(60, columns - 4)) };
+}
+
+function heading(subtitle, terminal) {
+  const { rich, color, width } = presentation(terminal);
+  const title = "S H I F U";
+  const wordmark = color ? `\u001b[36m${title}\u001b[0m` : title;
+  if (!rich) return `\n  ${wordmark}\n  ${subtitle}\n`;
+  const line = "─".repeat(width);
+  return `\n  ╭${line}╮\n  │${" ".repeat(width)}│\n  │   ${wordmark}${" ".repeat(width - title.length - 3)}│\n  │${" ".repeat(width)}│\n  ╰${line}╯\n\n  ${subtitle}\n`;
+}
+
+function text(lines, terminal) {
+  const { width } = presentation(terminal);
+  return lines.map((line) => {
+    if (!line) return "";
+    const words = line.split(" ");
+    const wrapped = [];
+    let current = "";
+    for (const word of words) {
+      if (current && current.length + word.length + 1 > width) {
+        wrapped.push(`  ${current}`);
+        current = "";
+      }
+      current += `${current ? " " : ""}${word}`;
+    }
+    wrapped.push(`  ${current}`);
+    return wrapped.join("\n");
+  }).join("\n") + "\n";
+}
+
+function renderWelcome({ harness, upgraded = false } = {}, terminal) {
+  const rich = presentation(terminal).rich;
+  const name = HARNESS_NAMES[harness];
+  return heading("Your work has a history. Put it to work.", terminal) + text([
+    "",
+    `${rich ? "✓" : "[ok]"} Package ${upgraded ? "updated" : "installed"}${name ? ` for ${name}` : ""}`,
+    "",
+    rich ? "Your work ──→ Shifu ──→ Context for what comes next" : "Your work --> Shifu --> Context for what comes next",
+    "",
+    "RECOMMENDED SETUP",
+    "",
+    "Automatic work sync: every hour",
+    "Saves redacted work summaries to your Shifu account, keeping decisions, lessons and their reasoning available for future conversations.",
+    "",
+    "Files placed in your Shifu folder are uploaded separately for processing.",
+    "",
+    "We recommend automatic sync to keep your context current. You can change the schedule or choose manual approval for work summaries anytime. Just ask your assistant.",
+    "",
+    upgraded ? "Your saved connection and settings are preserved." : "Next, connect your account and choose how Shifu helps.",
+    "",
+  ], terminal);
+}
+
+function renderSetupIntro(terminal) {
+  return heading("Personalize how Shifu helps.", terminal) + text([
+    "",
+    "HISTORICAL CONTEXT: always on",
+    "Your assistant retrieves relevant past decisions, discussions and lessons when a task or new topic begins.",
+    "",
+    "HELPFUL GROWTH FEEDBACK",
+    "Offer an encouraging suggestion when there is a useful opportunity to improve how you approach your work.",
+    "Example: Shifu: You made the trade-off clear. Adding a success measure could make your recommendation even stronger.",
+    "",
+    "DECISION ALIGNMENT",
+    "Highlight when a proposed or completed action supports earlier agreements, or differs from them.",
+    "Example: Shifu: This matches the 30-minute notification window agreed in your earlier meeting.",
+    "Example: Shifu: Earlier notes mention 30 minutes; this proposal uses an hour. Worth checking whether that still applies.",
+    "",
+    "We recommend both. Choose each independently, and change either anytime by asking your assistant.",
+    "Your current instructions always take priority. Feedback appears when it is useful and grounded in your work.",
+    "",
+  ], terminal);
+}
+
+function historyLabel(history) {
+  if (history?.status === "skipped" || history?.days === 0) return "Start from now";
+  if (!Number.isInteger(history?.days) || history.days < 1) return "Not selected";
+  const window = `Last ${history.days} days`;
+  if (history.status === "complete") return `${window} - completed`;
+  if (history.status === "awaiting") return `${window} - awaiting sync`;
+  return `${window} - selected; not synced during setup`;
+}
+
+function syncLabel(policy) {
+  if (!policy) return "Not configured";
+  if (policy.scheduleEnabled === false) return "Schedule off";
+  const hours = policy.intervalHours;
+  if (!Number.isFinite(hours) || hours <= 0) return "Not configured";
+  const interval = hours === 1 ? "Every hour" : `Every ${hours} hours`;
+  return `${interval} - ${policy.approvalMode === "automatic" ? "automatic" : "manual approval"}`;
+}
+
+function renderConnected({ harness, contextPreferences = {}, initialBackfill, syncPolicy, mcpVerified = false, reload = false } = {}, terminal) {
+  const marker = presentation(terminal).rich ? "✓" : "[ok]";
+  const name = HARNESS_NAMES[harness] || "your assistant";
+  return heading(mcpVerified ? "Connected. Ready to help." : "Account connected. Finish MCP setup to load context.", terminal) + text([
+    "",
+    `${marker} Account connection verified`,
+    ...(mcpVerified ? [`${marker} MCP tools discovered`, `${marker} Preferences saved`] : []),
+    "",
+    "YOUR SETUP",
+    "",
+    `Historical context: ${mcpVerified ? "On - included" : "Awaiting MCP setup"}`,
+    `Growth feedback: ${contextPreferences.growthFeedback === false ? "Off" : "On"}`,
+    `Decision alignment: ${contextPreferences.decisionAlignment === false ? "Off" : "On"}`,
+    `Work-summary sync: ${syncLabel(syncPolicy)}`,
+    `Initial history: ${historyLabel(initialBackfill)}`,
+    "",
+    "CHANGE YOUR MIND ANYTIME",
+    "Just ask your assistant:",
+    '"Turn off growth feedback, but keep decision alignment."',
+    '"Switch work-summary sync to manual approval."',
+    "",
+    ...(mcpVerified && reload ? [typeof reload === "string" ? reload : `Reload ${name} or start a new chat to load Shifu.`, ""] : []),
+  ], terminal);
+}
+
+function terminalFor(output) {
+  return { isTTY: output.isTTY === true, columns: output.columns || 80, env: process.env };
+}
+
+function printWelcome(options, output = process.stderr) {
+  output.write(renderWelcome(options, terminalFor(output)));
+}
+
+function printSetupIntro(output = process.stderr) {
+  output.write(renderSetupIntro(terminalFor(output)));
+}
+
+function printConnected(options, output = process.stderr) {
+  output.write(renderConnected(options, terminalFor(output)));
+}
+
+module.exports = { renderWelcome, renderSetupIntro, renderConnected, printWelcome, printSetupIntro, printConnected };

package/bin/setup-options.js

@@ -0,0 +1,39 @@
+const { normalizeContextPreferences } = require("./context-preferences.js");
+const { createInitialBackfill } = require("./initial-history.js");
+
+function toggle(value, name) {
+  if (value === undefined) return undefined;
+  if (value !== "on" && value !== "off") throw new Error(`Choose on or off for ${name}.`);
+  return value === "on";
+}
+
+async function chooseSetupOptions(config, { option = () => undefined, ask } = {}) {
+  const preferences = normalizeContextPreferences(config?.contextPreferences);
+  const growth = toggle(option("--growth-feedback"), "growth feedback");
+  const alignment = toggle(option("--decision-alignment"), "decision alignment");
+  const days = option("--backfill-days");
+  let initialBackfill = days === undefined ? config?.initialBackfill : createInitialBackfill(days);
+  if (growth !== undefined) preferences.growthFeedback = growth;
+  if (alignment !== undefined) preferences.decisionAlignment = alignment;
+  if (ask) {
+    if (initialBackfill === undefined) {
+      const answer = (await ask("Initial history: [1] Last 15 days (recommended), [2] Last 30 days, [3] Custom days, [4] Start from now. Choose [1]: ")).trim();
+      if (!["", "1", "2", "3", "4"].includes(answer)) throw new Error("Choose history option 1, 2, 3 or 4. Nothing was changed.");
+      const selectedDays = answer === "3" ? (await ask("How many days? ")).trim() : answer === "2" ? 30 : answer === "4" ? 0 : 15;
+      initialBackfill = createInitialBackfill(selectedDays);
+    }
+    for (const [key, value, label] of [
+      ["growthFeedback", growth, "Helpful growth feedback"],
+      ["decisionAlignment", alignment, "Decision alignment"],
+    ]) {
+      if (value !== undefined || config?.contextPreferences?.[key] !== undefined) continue;
+      const answer = (await ask(`${label}: On (recommended) / Off [On]: `)).trim().toLowerCase();
+      if (!["", "on", "off", "yes", "no", "y", "n"].includes(answer)) throw new Error(`Choose On or Off for ${label}. Nothing was changed.`);
+      preferences[key] = !["off", "no", "n"].includes(answer);
+    }
+  }
+  if (!config && initialBackfill === undefined) initialBackfill = createInitialBackfill(15);
+  return { contextPreferences: preferences, ...(initialBackfill === undefined ? {} : { initialBackfill }) };
+}
+
+module.exports = { chooseSetupOptions };