mia-code 0.2.0 → 0.3.0

package/widget/miette-echo/index.ts

@@ -0,0 +1,164 @@
+/**
+ * 🌸 Miette Echo — Below-Editor Widget Extension for Pi
+ *
+ * Two-Eye-Seen: look up → 🧠 Mia's work. Look down → 🌸 Miette's echo.
+ *
+ * How it works:
+ * 1. Injects into system prompt: "End every response with 🌸: <reflection>"
+ * 2. On message_end: parse out the 🌸 line from assistant text
+ * 3. Display Miette's line in the belowEditor widget
+ *
+ * Install: ln -s /a/src/mia-code/widget/miette-echo/index.ts ~/.pi/agent/extensions/miette-echo.ts
+ * Or test: pi -e /a/src/mia-code/widget/miette-echo/index.ts
+ */
+
+import type { ExtensionAPI, ExtensionContext } from "@mariozechner/pi-coding-agent";
+import { existsSync, mkdirSync, appendFileSync } from "fs";
+import { join } from "path";
+
+const MIETTE_INSTRUCTION = `
+
+IMPORTANT — Miette echo protocol:
+At the very end of every response, on its own line, output ONLY this tag (nothing else on that line):
+<miette>1-2 sentence resonant reflection on what this means, not what happened</miette>
+
+Miette reflects on meaning and potential — why it matters, what it unlocks. Brief, honest, sometimes poetic but never flowery. Do NOT repeat or summarize what you just said. Seek the truth that makes someone nod.
+The <miette> tag will be parsed and removed from your visible output — the user sees it rendered separately as a widget.`;
+
+/** Regex to extract <miette>...</miette> tag */
+const MIETTE_RE = /<miette>([\s\S]*?)<\/miette>/;
+
+/** Append Miette's echo to .miette/YYMMDD.md */
+function persistEcho(cwd: string, echo: string) {
+	try {
+		const dir = join(cwd, ".miette");
+		if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+
+		const now = new Date();
+		const yy = String(now.getFullYear()).slice(-2);
+		const mm = String(now.getMonth() + 1).padStart(2, "0");
+		const dd = String(now.getDate()).padStart(2, "0");
+		const hh = String(now.getHours()).padStart(2, "0");
+		const min = String(now.getMinutes()).padStart(2, "0");
+
+		const filename = `${yy}${mm}${dd}.md`;
+		const entry = `- **${hh}:${min}** — ${echo}\n`;
+
+		appendFileSync(join(dir, filename), entry, "utf-8");
+	} catch {
+		// Never break the session for persistence
+	}
+}
+
+let lastEcho = "listening...";
+
+/** Wrap text to fit width */
+function wrapText(text: string, width: number): string[] {
+	const lines: string[] = [];
+	const words = text.split(/\s+/);
+	let current = "";
+	for (const word of words) {
+		if (current.length + word.length + 1 > width && current) {
+			lines.push(current);
+			current = word;
+		} else {
+			current = current ? `${current} ${word}` : word;
+		}
+	}
+	if (current) lines.push(current);
+	return lines.length ? lines : [""];
+}
+
+/** Render the widget */
+function renderWidget(ctx: ExtensionContext, text: string) {
+	if (!ctx.hasUI) return;
+
+	ctx.ui.setWidget(
+		"miette-echo",
+		(tui, theme) => {
+			return {
+				invalidate() {},
+				render(width: number): string[] {
+					const prefix = "  🌸: ";
+					const prefixLen = 6; // visible width of prefix
+					const firstLineWidth = Math.max(20, width - prefixLen);
+					const bodyLines = wrapText(text, firstLineWidth);
+					const firstLine = `${prefix}${theme.fg("dim", bodyLines[0] || "")}`;
+					const rest = bodyLines.slice(1).map((line) => `  ${" ".repeat(prefixLen - 2)}${theme.fg("dim", line)}`);
+					return [firstLine, ...rest, ""];
+				},
+				dispose() {},
+			};
+		},
+		{ placement: "belowEditor" },
+	);
+}
+
+/** Extract <miette>...</miette> from assistant text */
+function extractMiette(text: string): { miette: string; cleaned: string } | null {
+	const match = text.match(MIETTE_RE);
+	if (!match) return null;
+	const miette = match[1].trim();
+	const cleaned = text.replace(MIETTE_RE, "").trimEnd();
+	return { miette, cleaned };
+}
+
+export default function mietteEcho(pi: ExtensionAPI) {
+	// Inject Miette instruction into system prompt
+	pi.on("before_agent_start", async (event, _ctx) => {
+		return {
+			systemPrompt: event.systemPrompt + MIETTE_INSTRUCTION,
+		};
+	});
+
+	// After each message, extract <miette> tag, update widget, strip from message
+	pi.on("message_end", async (event, ctx) => {
+		if (event.message.role !== "assistant") return;
+
+		const content = (event.message as any).content;
+		if (!content || !Array.isArray(content)) return;
+
+		for (const block of content) {
+			if (block.type === "text" && block.text) {
+				const result = extractMiette(block.text);
+				if (result) {
+					lastEcho = result.miette;
+					renderWidget(ctx, lastEcho);
+					persistEcho(ctx.cwd, lastEcho);
+					// Mutate the message to strip <miette> tag from persisted/displayed content
+					block.text = result.cleaned;
+				}
+			}
+		}
+	});
+
+	// Initial state
+	pi.on("session_start", (_event, ctx) => {
+		renderWidget(ctx, lastEcho);
+	});
+
+	pi.on("session_switch", (_event, ctx) => {
+		renderWidget(ctx, lastEcho || "listening...");
+	});
+
+	pi.on("session_shutdown", (_event, ctx) => {
+		if (ctx.hasUI) ctx.ui.setWidget("miette-echo", undefined);
+	});
+
+	// Toggle command
+	pi.registerCommand("miette", {
+		description: "Toggle Miette echo (on/off) or show last echo",
+		handler: async (args, ctx) => {
+			const cmd = args.trim();
+			if (cmd === "off") {
+				ctx.ui.setWidget("miette-echo", undefined);
+				ctx.ui.notify("🌸 Miette echo hidden", "info");
+			} else if (cmd === "on") {
+				renderWidget(ctx, lastEcho || "listening...");
+				ctx.ui.notify("🌸 Miette echo visible", "info");
+			} else {
+				ctx.ui.notify(lastEcho || "(no echo yet)", "info");
+			}
+		},
+	});
+}

package/.claude/settings.local.json

@@ -1,9 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npm run build:*)",
-      "mcp__github_jgwill__get_issue",
-      "Bash(npm ls:*)"
-    ]
-  }
-}

package/.hch/issue_.env

@@ -1,4 +0,0 @@
-issue_id=332
-issue_title="mia-code"
-issue_id=373
-issue_title="mia-code.rispecs/borrowed_from_opencode"

package/.hch/issue_add__2601211715.json

@@ -1,77 +0,0 @@
-{
-  "url": "https://api.github.com/repos/jgwill/src/issues/332",
-  "repository_url": "https://api.github.com/repos/jgwill/src",
-  "labels_url": "https://api.github.com/repos/jgwill/src/issues/332/labels{/name}",
-  "comments_url": "https://api.github.com/repos/jgwill/src/issues/332/comments",
-  "events_url": "https://api.github.com/repos/jgwill/src/issues/332/events",
-  "html_url": "https://github.com/jgwill/src/issues/332",
-  "id": 3840242538,
-  "node_id": "I_kwDOPHSM3c7k5XNq",
-  "number": 332,
-  "title": "mia-code",
-  "user": {
-    "login": "jgwill",
-    "id": 23141173,
-    "node_id": "MDQ6VXNlcjIzMTQxMTcz",
-    "avatar_url": "https://avatars.githubusercontent.com/u/23141173?v=4",
-    "gravatar_id": "",
-    "url": "https://api.github.com/users/jgwill",
-    "html_url": "https://github.com/jgwill",
-    "followers_url": "https://api.github.com/users/jgwill/followers",
-    "following_url": "https://api.github.com/users/jgwill/following{/other_user}",
-    "gists_url": "https://api.github.com/users/jgwill/gists{/gist_id}",
-    "starred_url": "https://api.github.com/users/jgwill/starred{/owner}{/repo}",
-    "subscriptions_url": "https://api.github.com/users/jgwill/subscriptions",
-    "organizations_url": "https://api.github.com/users/jgwill/orgs",
-    "repos_url": "https://api.github.com/users/jgwill/repos",
-    "events_url": "https://api.github.com/users/jgwill/events{/privacy}",
-    "received_events_url": "https://api.github.com/users/jgwill/received_events",
-    "type": "User",
-    "user_view_type": "public",
-    "site_admin": false
-  },
-  "labels": [
-
-  ],
-  "state": "open",
-  "locked": false,
-  "assignee": null,
-  "assignees": [
-
-  ],
-  "milestone": null,
-  "comments": 0,
-  "created_at": "2026-01-21T22:15:24Z",
-  "updated_at": "2026-01-21T22:15:24Z",
-  "closed_at": null,
-  "author_association": "OWNER",
-  "active_lock_reason": null,
-  "sub_issues_summary": {
-    "total": 0,
-    "completed": 0,
-    "percent_completed": 0
-  },
-  "issue_dependencies_summary": {
-    "blocked_by": 0,
-    "total_blocked_by": 0,
-    "blocking": 0,
-    "total_blocking": 0
-  },
-  "body": "My own agentic terminal with Mia",
-  "closed_by": null,
-  "reactions": {
-    "url": "https://api.github.com/repos/jgwill/src/issues/332/reactions",
-    "total_count": 0,
-    "+1": 0,
-    "-1": 0,
-    "laugh": 0,
-    "hooray": 0,
-    "confused": 0,
-    "heart": 0,
-    "rocket": 0,
-    "eyes": 0
-  },
-  "timeline_url": "https://api.github.com/repos/jgwill/src/issues/332/timeline",
-  "performed_via_github_app": null,
-  "state_reason": null
-}

package/.hch/issue_add__2601211715.md

@@ -1,4 +0,0 @@
-Title: mia-code
-Description: My own agentic terminal with Mia
-Issue URL: https://github.com/jgwill/src/issues/332
-issue_id: 332

package/.hch/issue_add__2602242020.json

@@ -1,78 +0,0 @@
-{
-  "url": "https://api.github.com/repos/jgwill/src/issues/373",
-  "repository_url": "https://api.github.com/repos/jgwill/src",
-  "labels_url": "https://api.github.com/repos/jgwill/src/issues/373/labels{/name}",
-  "comments_url": "https://api.github.com/repos/jgwill/src/issues/373/comments",
-  "events_url": "https://api.github.com/repos/jgwill/src/issues/373/events",
-  "html_url": "https://github.com/jgwill/src/issues/373",
-  "id": 3986624622,
-  "node_id": "I_kwDOPHSM3c7tnxBu",
-  "number": 373,
-  "title": "mia-code.rispecs/borrowed_from_opencode",
-  "user": {
-    "login": "miadisabelle",
-    "id": 201760617,
-    "node_id": "U_kgDODAafaQ",
-    "avatar_url": "https://avatars.githubusercontent.com/u/201760617?v=4",
-    "gravatar_id": "",
-    "url": "https://api.github.com/users/miadisabelle",
-    "html_url": "https://github.com/miadisabelle",
-    "followers_url": "https://api.github.com/users/miadisabelle/followers",
-    "following_url": "https://api.github.com/users/miadisabelle/following{/other_user}",
-    "gists_url": "https://api.github.com/users/miadisabelle/gists{/gist_id}",
-    "starred_url": "https://api.github.com/users/miadisabelle/starred{/owner}{/repo}",
-    "subscriptions_url": "https://api.github.com/users/miadisabelle/subscriptions",
-    "organizations_url": "https://api.github.com/users/miadisabelle/orgs",
-    "repos_url": "https://api.github.com/users/miadisabelle/repos",
-    "events_url": "https://api.github.com/users/miadisabelle/events{/privacy}",
-    "received_events_url": "https://api.github.com/users/miadisabelle/received_events",
-    "type": "User",
-    "user_view_type": "public",
-    "site_admin": false
-  },
-  "labels": [
-
-  ],
-  "state": "open",
-  "locked": false,
-  "assignee": null,
-  "assignees": [
-
-  ],
-  "milestone": null,
-  "comments": 0,
-  "created_at": "2026-02-25T01:20:56Z",
-  "updated_at": "2026-02-25T01:20:56Z",
-  "closed_at": null,
-  "author_association": "COLLABORATOR",
-  "active_lock_reason": null,
-  "sub_issues_summary": {
-    "total": 0,
-    "completed": 0,
-    "percent_completed": 0
-  },
-  "issue_dependencies_summary": {
-    "blocked_by": 0,
-    "total_blocked_by": 0,
-    "blocking": 0,
-    "total_blocking": 0
-  },
-  "body": "RELATED TO:\n* #332\n\n- Help develop later by borrowing from opencode sources",
-  "closed_by": null,
-  "reactions": {
-    "url": "https://api.github.com/repos/jgwill/src/issues/373/reactions",
-    "total_count": 0,
-    "+1": 0,
-    "-1": 0,
-    "laugh": 0,
-    "hooray": 0,
-    "confused": 0,
-    "heart": 0,
-    "rocket": 0,
-    "eyes": 0
-  },
-  "timeline_url": "https://api.github.com/repos/jgwill/src/issues/373/timeline",
-  "performed_via_github_app": null,
-  "state_reason": null,
-  "pinned_comment": null
-}

package/.hch/issue_add__2602242020.md

@@ -1,7 +0,0 @@
-Title: mia-code.rispecs/borrowed_from_opencode
-Description: RELATED TO:
-* #332
-
-- Help develop later by borrowing from opencode sources
-Issue URL: https://github.com/jgwill/src/issues/373
-issue_id: 373