wotann 0.5.0

package/dist/magic/handlers/merge-conflict.d.ts

@@ -0,0 +1,27 @@
+/**
+ * .merge-conflict — helps resolve merge conflicts by analyzing both
+ * sides of each conflict block and suggesting a resolution.
+ *
+ * WHAT: a Jean-style dev-workflow magic command that takes a path with
+ *       merge-conflict markers and produces a structured resolution.
+ *
+ * WHY:  merge conflicts are dangerous — a wrong resolution can revert
+ *       a feature, drop a fix, or corrupt the repository. The shortcut
+ *       forces the agent to walk through each conflict block
+ *       deliberately, surface the semantic intent of both sides, and
+ *       propose a resolution the user can review.
+ *
+ * WHERE: invoked via `.merge-conflict <file>`. The handler shapes a
+ *        prompt that walks the agent through reading both sides and
+ *        proposing a merged version.
+ *
+ * HOW:  pure prompt-shaper. The systemAugment instructs the agent to
+ *       read the file with conflict markers in place, identify each
+ *       `<<<<<<<` ... `=======` ... `>>>>>>>` block, analyze both sides
+ *       (using `git log` to understand each side's history), and
+ *       propose a resolution. Honest-stubs: if the file is not in a
+ *       conflict state, the handler reports that and exits.
+ */
+import type { MagicCommandHandler } from "../types.js";
+export declare const handleMergeConflict: MagicCommandHandler;
+//# sourceMappingURL=merge-conflict.d.ts.map

package/dist/magic/handlers/merge-conflict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-conflict.d.ts","sourceRoot":"","sources":["../../../src/magic/handlers/merge-conflict.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,mBAAmB,EAAE,mBA4CjC,CAAC"}

package/dist/magic/handlers/merge-conflict.js

@@ -0,0 +1,68 @@
+/**
+ * .merge-conflict — helps resolve merge conflicts by analyzing both
+ * sides of each conflict block and suggesting a resolution.
+ *
+ * WHAT: a Jean-style dev-workflow magic command that takes a path with
+ *       merge-conflict markers and produces a structured resolution.
+ *
+ * WHY:  merge conflicts are dangerous — a wrong resolution can revert
+ *       a feature, drop a fix, or corrupt the repository. The shortcut
+ *       forces the agent to walk through each conflict block
+ *       deliberately, surface the semantic intent of both sides, and
+ *       propose a resolution the user can review.
+ *
+ * WHERE: invoked via `.merge-conflict <file>`. The handler shapes a
+ *        prompt that walks the agent through reading both sides and
+ *        proposing a merged version.
+ *
+ * HOW:  pure prompt-shaper. The systemAugment instructs the agent to
+ *       read the file with conflict markers in place, identify each
+ *       `<<<<<<<` ... `=======` ... `>>>>>>>` block, analyze both sides
+ *       (using `git log` to understand each side's history), and
+ *       propose a resolution. Honest-stubs: if the file is not in a
+ *       conflict state, the handler reports that and exits.
+ */
+export const handleMergeConflict = (input) => {
+    const trimmed = input.trim();
+    if (trimmed.length === 0) {
+        return {
+            ok: true,
+            prompt: "Ask the user for the file path with merge-conflict markers they want resolved. Example: .merge-conflict src/auth/login.ts. Once they reply, analyze both sides of each <<<<<<< / ======= / >>>>>>> block and propose a resolution.",
+            systemAugment: "The .merge-conflict command requires a target file. Prompt the user for it and don't fabricate one. When provided, read the file, analyze the conflict markers, propose a resolution that preserves the intent of BOTH sides where they don't actually conflict.",
+        };
+    }
+    return {
+        ok: true,
+        prompt: [
+            `Resolve merge conflicts in the file: ${trimmed}`,
+            "",
+            "Workflow:",
+            "  1. Read the file. Verify it actually contains `<<<<<<<` / `=======` / `>>>>>>>` markers.",
+            "  2. If no markers are found, report that the file has no active conflicts and exit.",
+            "  3. For each conflict block:",
+            "       a. Identify the OURS side and the THEIRS side.",
+            "       b. Run `git log --oneline -5 HEAD -- " +
+                trimmed +
+                "` and `git log --oneline -5 MERGE_HEAD -- " +
+                trimmed +
+                "` to learn the recent history of each side.",
+            "       c. Describe what each side is trying to accomplish (semantic intent, not just diff).",
+            "       d. Propose a resolution that preserves both intents. If the intents are mutually exclusive, surface the conflict to the user and stop.",
+            "       e. Note any tests that should be added or run after the resolution.",
+            "  4. Output a unified resolution proposal with the conflict markers removed.",
+            "  5. DO NOT write the resolution to disk until the user approves.",
+            "",
+            "Quality bar: never silently choose one side. Every block needs a justified resolution.",
+        ].join("\n"),
+        systemAugment: [
+            "When resolving merge conflicts:",
+            "  - Read both branches' history before choosing — recent intent beats raw diff.",
+            "  - If the conflict involves tests, run the tests both ways to learn what each side proves.",
+            "  - Preserve immutability: if both sides add a field, include both. If both sides remove a field, ask the user.",
+            "  - For binary conflicts, refuse to auto-resolve; surface to the user.",
+            "  - After applying the resolution, re-run the project's typecheck + tests before claiming done.",
+            "  - Save the resolution rationale to memory with `topic_key=merges/<file-or-branch>`.",
+        ].join("\n"),
+    };
+};
+//# sourceMappingURL=merge-conflict.js.map

package/dist/magic/handlers/merge-conflict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-conflict.js","sourceRoot":"","sources":["../../../src/magic/handlers/merge-conflict.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,MAAM,CAAC,MAAM,mBAAmB,GAAwB,CAAC,KAAK,EAAE,EAAE;IAChE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,EAAE,EAAE,IAAI;YACR,MAAM,EACJ,oOAAoO;YACtO,aAAa,EACX,kQAAkQ;SACrQ,CAAC;IACJ,CAAC;IACD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM,EAAE;YACN,wCAAwC,OAAO,EAAE;YACjD,EAAE;YACF,WAAW;YACX,4FAA4F;YAC5F,sFAAsF;YACtF,+BAA+B;YAC/B,uDAAuD;YACvD,8CAA8C;gBAC5C,OAAO;gBACP,4CAA4C;gBAC5C,OAAO;gBACP,6CAA6C;YAC/C,6FAA6F;YAC7F,+IAA+I;YAC/I,4EAA4E;YAC5E,8EAA8E;YAC9E,mEAAmE;YACnE,EAAE;YACF,wFAAwF;SACzF,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,aAAa,EAAE;YACb,iCAAiC;YACjC,iFAAiF;YACjF,6FAA6F;YAC7F,iHAAiH;YACjH,wEAAwE;YACxE,iGAAiG;YACjG,uFAAuF;SACxF,CAAC,IAAI,CAAC,IAAI,CAAC;KACb,CAAC;AACJ,CAAC,CAAC"}

package/dist/magic/handlers/optimize.d.ts

@@ -0,0 +1,3 @@
+import type { MagicCommandHandler } from "../types.js";
+export declare const handleOptimize: MagicCommandHandler;
+//# sourceMappingURL=optimize.d.ts.map

package/dist/magic/handlers/optimize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimize.d.ts","sourceRoot":"","sources":["../../../src/magic/handlers/optimize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,cAAc,EAAE,mBAW5B,CAAC"}

package/dist/magic/handlers/optimize.js

@@ -0,0 +1,11 @@
+export const handleOptimize = (input) => {
+    const trimmed = input.trim();
+    return {
+        ok: true,
+        prompt: trimmed.length === 0
+            ? "Optimize the most recently shared code for performance. Identify the hot path, propose specific changes, and explain the expected complexity / wall-clock improvement."
+            : `Optimize the following for performance:\n\n${trimmed}`,
+        systemAugment: "When optimizing: profile first (or describe how to profile). Improve algorithmic complexity before micro-optimizations. State BEFORE → AFTER complexity for each change. Preserve behavior; never trade correctness for speed.",
+    };
+};
+//# sourceMappingURL=optimize.js.map

package/dist/magic/handlers/optimize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimize.js","sourceRoot":"","sources":["../../../src/magic/handlers/optimize.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAwB,CAAC,KAAK,EAAE,EAAE;IAC3D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM,EACJ,OAAO,CAAC,MAAM,KAAK,CAAC;YAClB,CAAC,CAAC,wKAAwK;YAC1K,CAAC,CAAC,8CAA8C,OAAO,EAAE;QAC7D,aAAa,EACX,gOAAgO;KACnO,CAAC;AACJ,CAAC,CAAC"}

package/dist/magic/handlers/pr-content.d.ts

@@ -0,0 +1,23 @@
+/**
+ * .pr-content — writes a PR title + summary + test plan from the diff.
+ *
+ * WHAT: a Jean-style dev-workflow magic command that produces the
+ *       narrative content for a pull request: a concise title, a
+ *       motivated summary, and a test-plan checklist.
+ *
+ * WHY:  the body of a PR is where reviewers form their first impression.
+ *       Letting the agent draft a high-quality body lifts the floor on
+ *       PR quality across the project.
+ *
+ * WHERE: invoked via `.pr-content` (defaults base to `main`) or
+ *        `.pr-content base=<branch>` to compute the diff against a
+ *        non-default base branch.
+ *
+ * HOW:  pure prompt-shaper. The systemAugment instructs the agent to
+ *       compute the diff via `git diff <base>...HEAD`, the commit log
+ *       via `git log <base>..HEAD`, and to produce structured content
+ *       in the canonical format the project uses (summary + test plan).
+ */
+import type { MagicCommandHandler } from "../types.js";
+export declare const handlePrContent: MagicCommandHandler;
+//# sourceMappingURL=pr-content.d.ts.map

package/dist/magic/handlers/pr-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-content.d.ts","sourceRoot":"","sources":["../../../src/magic/handlers/pr-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAavD,eAAO,MAAM,eAAe,EAAE,mBAkC7B,CAAC"}

package/dist/magic/handlers/pr-content.js

@@ -0,0 +1,67 @@
+/**
+ * .pr-content — writes a PR title + summary + test plan from the diff.
+ *
+ * WHAT: a Jean-style dev-workflow magic command that produces the
+ *       narrative content for a pull request: a concise title, a
+ *       motivated summary, and a test-plan checklist.
+ *
+ * WHY:  the body of a PR is where reviewers form their first impression.
+ *       Letting the agent draft a high-quality body lifts the floor on
+ *       PR quality across the project.
+ *
+ * WHERE: invoked via `.pr-content` (defaults base to `main`) or
+ *        `.pr-content base=<branch>` to compute the diff against a
+ *        non-default base branch.
+ *
+ * HOW:  pure prompt-shaper. The systemAugment instructs the agent to
+ *       compute the diff via `git diff <base>...HEAD`, the commit log
+ *       via `git log <base>..HEAD`, and to produce structured content
+ *       in the canonical format the project uses (summary + test plan).
+ */
+const DEFAULT_BASE = "main";
+function parseBaseFromInput(raw) {
+    // Accepts "base=<branch>" or just "<branch>" or "" (for default).
+    const trimmed = raw.trim();
+    if (trimmed.length === 0)
+        return DEFAULT_BASE;
+    const eq = trimmed.match(/^base\s*=\s*(\S+)/);
+    if (eq && eq[1])
+        return eq[1];
+    return trimmed.split(/\s+/)[0] ?? DEFAULT_BASE;
+}
+export const handlePrContent = (input) => {
+    const base = parseBaseFromInput(input);
+    return {
+        ok: true,
+        prompt: [
+            `Generate pull-request content for the current branch against base \`${base}\`.`,
+            "",
+            "Workflow:",
+            `  1. Run \`git diff ${base}...HEAD\` to read the full diff.`,
+            `  2. Run \`git log ${base}..HEAD --oneline\` to read the commit history.`,
+            "  3. Synthesize a PR title under 72 characters (Conventional Commit style).",
+            "  4. Compose a PR body using this canonical structure:",
+            "",
+            "       ## Summary",
+            "       <2-4 bullet points describing what changed and WHY it changed>",
+            "",
+            "       ## Test plan",
+            "       - [ ] <concrete verification step>",
+            "       - [ ] <another step>",
+            "",
+            "  5. Output the title and body. DO NOT run `gh pr create` until the user approves.",
+            "",
+            "If the diff is too large to summarize in 4 bullets, group changes by theme and suggest splitting into multiple PRs.",
+        ].join("\n"),
+        systemAugment: [
+            "When writing PR content:",
+            "  - The summary captures WHY each change was made, not just what.",
+            "  - The test plan must be actionable — each item should be verifiable in 1-2 minutes.",
+            "  - Mention any breaking changes prominently; never hide them in the body.",
+            "  - If the diff suggests follow-up work (TODOs, missing tests), note it explicitly.",
+            "  - Use `gh pr create --draft --title <t> --body <b>` only after the user approves the content.",
+            "  - Save the proposed content to memory with `topic_key=prs/<branch-name>` so the user can edit and re-use.",
+        ].join("\n"),
+    };
+};
+//# sourceMappingURL=pr-content.js.map

package/dist/magic/handlers/pr-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-content.js","sourceRoot":"","sources":["../../../src/magic/handlers/pr-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,MAAM,YAAY,GAAG,MAAM,CAAC;AAE5B,SAAS,kBAAkB,CAAC,GAAW;IACrC,kEAAkE;IAClE,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,YAAY,CAAC;IAC9C,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC9C,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9B,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAwB,CAAC,KAAK,EAAE,EAAE;IAC5D,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACvC,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM,EAAE;YACN,uEAAuE,IAAI,KAAK;YAChF,EAAE;YACF,WAAW;YACX,uBAAuB,IAAI,kCAAkC;YAC7D,sBAAsB,IAAI,gDAAgD;YAC1E,6EAA6E;YAC7E,wDAAwD;YACxD,EAAE;YACF,mBAAmB;YACnB,uEAAuE;YACvE,EAAE;YACF,qBAAqB;YACrB,2CAA2C;YAC3C,6BAA6B;YAC7B,EAAE;YACF,oFAAoF;YACpF,EAAE;YACF,qHAAqH;SACtH,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,aAAa,EAAE;YACb,0BAA0B;YAC1B,mEAAmE;YACnE,uFAAuF;YACvF,4EAA4E;YAC5E,qFAAqF;YACrF,iGAAiG;YACjG,6GAA6G;SAC9G,CAAC,IAAI,CAAC,IAAI,CAAC;KACb,CAAC;AACJ,CAAC,CAAC"}

package/dist/magic/handlers/refactor.d.ts

@@ -0,0 +1,3 @@
+import type { MagicCommandHandler } from "../types.js";
+export declare const handleRefactor: MagicCommandHandler;
+//# sourceMappingURL=refactor.d.ts.map

package/dist/magic/handlers/refactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refactor.d.ts","sourceRoot":"","sources":["../../../src/magic/handlers/refactor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,cAAc,EAAE,mBAW5B,CAAC"}

package/dist/magic/handlers/refactor.js

@@ -0,0 +1,11 @@
+export const handleRefactor = (input) => {
+    const trimmed = input.trim();
+    return {
+        ok: true,
+        prompt: trimmed.length === 0
+            ? "Refactor the most recently shared code for clarity and maintainability. Preserve behavior; document each change."
+            : `Refactor the following for clarity:\n\n${trimmed}`,
+        systemAugment: "When refactoring: preserve observable behavior. Prefer immutable data, small functions, and meaningful names. Run tests after each change. Document each refactor in the commit message.",
+    };
+};
+//# sourceMappingURL=refactor.js.map

package/dist/magic/handlers/refactor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refactor.js","sourceRoot":"","sources":["../../../src/magic/handlers/refactor.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAwB,CAAC,KAAK,EAAE,EAAE;IAC3D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM,EACJ,OAAO,CAAC,MAAM,KAAK,CAAC;YAClB,CAAC,CAAC,kHAAkH;YACpH,CAAC,CAAC,0CAA0C,OAAO,EAAE;QACzD,aAAa,EACX,0LAA0L;KAC7L,CAAC;AACJ,CAAC,CAAC"}

package/dist/magic/handlers/release-notes.d.ts

@@ -0,0 +1,28 @@
+/**
+ * .release-notes — generates release notes from a commit range.
+ *
+ * WHAT: a Jean-style dev-workflow magic command that turns the commit
+ *       range between two tags into a structured release-notes
+ *       document grouped by category (feat, fix, refactor, docs, ...).
+ *
+ * WHY:  release notes are the user-facing record of every shipped
+ *       version. Hand-writing them is slow and inconsistent. A
+ *       deterministic handler that consumes Conventional Commit
+ *       history produces consistent, readable notes the maintainer
+ *       can polish in minutes.
+ *
+ * WHERE: invoked via:
+ *          .release-notes                    — from latest tag -> HEAD
+ *          .release-notes from=<tag>         — from <tag> -> HEAD
+ *          .release-notes from=<tag> to=<tag> — explicit range
+ *
+ * HOW:  pure prompt-shaper. The systemAugment instructs the agent to
+ *       use `git tag --list --sort=-version:refname` for tag
+ *       discovery, `git log <from>..<to>` to enumerate commits, and
+ *       to group by Conventional Commit type. Honest-stubs: if no
+ *       tags exist, report and ask the user to provide an explicit
+ *       range.
+ */
+import type { MagicCommandHandler } from "../types.js";
+export declare const handleReleaseNotes: MagicCommandHandler;
+//# sourceMappingURL=release-notes.d.ts.map

package/dist/magic/handlers/release-notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-notes.d.ts","sourceRoot":"","sources":["../../../src/magic/handlers/release-notes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAoBvD,eAAO,MAAM,kBAAkB,EAAE,mBA0ChC,CAAC"}

package/dist/magic/handlers/release-notes.js

@@ -0,0 +1,85 @@
+/**
+ * .release-notes — generates release notes from a commit range.
+ *
+ * WHAT: a Jean-style dev-workflow magic command that turns the commit
+ *       range between two tags into a structured release-notes
+ *       document grouped by category (feat, fix, refactor, docs, ...).
+ *
+ * WHY:  release notes are the user-facing record of every shipped
+ *       version. Hand-writing them is slow and inconsistent. A
+ *       deterministic handler that consumes Conventional Commit
+ *       history produces consistent, readable notes the maintainer
+ *       can polish in minutes.
+ *
+ * WHERE: invoked via:
+ *          .release-notes                    — from latest tag -> HEAD
+ *          .release-notes from=<tag>         — from <tag> -> HEAD
+ *          .release-notes from=<tag> to=<tag> — explicit range
+ *
+ * HOW:  pure prompt-shaper. The systemAugment instructs the agent to
+ *       use `git tag --list --sort=-version:refname` for tag
+ *       discovery, `git log <from>..<to>` to enumerate commits, and
+ *       to group by Conventional Commit type. Honest-stubs: if no
+ *       tags exist, report and ask the user to provide an explicit
+ *       range.
+ */
+function parseRange(raw) {
+    // Accepts "from=<X>", "to=<Y>", whitespace-separated, in any order.
+    const args = {};
+    for (const tok of raw.trim().split(/\s+/)) {
+        if (tok.length === 0)
+            continue;
+        const m = tok.match(/^(from|to)\s*=\s*(\S+)$/);
+        if (!m)
+            continue;
+        if (m[1] === "from")
+            args.from = m[2];
+        else if (m[1] === "to")
+            args.to = m[2];
+    }
+    return args;
+}
+export const handleReleaseNotes = (input) => {
+    const range = parseRange(input);
+    const fromLabel = range.from ?? "<latest tag>";
+    const toLabel = range.to ?? "HEAD";
+    return {
+        ok: true,
+        prompt: [
+            `Generate release notes for the commit range ${fromLabel}..${toLabel}.`,
+            "",
+            "Workflow:",
+            `  1. Determine the FROM tag:`,
+            range.from
+                ? `       Use the user-supplied tag: ${range.from}.`
+                : "       Run `git tag --list --sort=-version:refname` and pick the most recent tag. If no tags exist, ask the user for an explicit FROM commit and stop.",
+            "  2. Determine the TO ref:",
+            range.to ? `       Use the user-supplied ref: ${range.to}.` : "       Use HEAD by default.",
+            "  3. Run `git log <from>..<to> --pretty=format:%H%x09%s%x09%an` to enumerate commits.",
+            "  4. Parse each commit message. Group by Conventional Commit type:",
+            "       - feat   -> ## New Features",
+            "       - fix    -> ## Bug Fixes",
+            "       - perf   -> ## Performance",
+            "       - refactor -> ## Refactors",
+            "       - docs   -> ## Documentation",
+            "       - test   -> ## Tests",
+            "       - chore  -> ## Chores (skip if empty)",
+            "       - other  -> ## Other Changes",
+            "  5. Within each section, list one bullet per commit:",
+            "       - <subject> (<short-sha> by <author>)",
+            "  6. At the top, write a 2-3 sentence narrative summary of the release.",
+            "  7. At the bottom, list breaking changes if any commits include `BREAKING CHANGE:` in their body.",
+            "  8. Output the markdown. DO NOT publish until the user approves.",
+        ].join("\n"),
+        systemAugment: [
+            "When generating release notes:",
+            "  - Read `BREAKING CHANGE:` footers from commit bodies, not just the subject line.",
+            "  - If a commit message is non-Conventional, include it under `## Other Changes` rather than guessing the type.",
+            "  - Skip merge commits unless they introduce new content not present in the merged commits.",
+            "  - Surface contributor names; thank-yous improve community feel.",
+            "  - If `git log` returns zero commits in the range, report that and ask whether the wrong tags were chosen.",
+            "  - Save the proposed notes to memory with `topic_key=releases/<to>` so they can be edited and re-used.",
+        ].join("\n"),
+    };
+};
+//# sourceMappingURL=release-notes.js.map

package/dist/magic/handlers/release-notes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-notes.js","sourceRoot":"","sources":["../../../src/magic/handlers/release-notes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AASH,SAAS,UAAU,CAAC,GAAW;IAC7B,oEAAoE;IACpE,MAAM,IAAI,GAAmC,EAAE,CAAC;IAChD,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAC/B,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC/C,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM;YAAE,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;aACjC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAwB,CAAC,KAAK,EAAE,EAAE;IAC/D,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,IAAI,cAAc,CAAC;IAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,EAAE,IAAI,MAAM,CAAC;IACnC,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM,EAAE;YACN,+CAA+C,SAAS,KAAK,OAAO,GAAG;YACvE,EAAE;YACF,WAAW;YACX,8BAA8B;YAC9B,KAAK,CAAC,IAAI;gBACR,CAAC,CAAC,qCAAqC,KAAK,CAAC,IAAI,GAAG;gBACpD,CAAC,CAAC,wJAAwJ;YAC5J,4BAA4B;YAC5B,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,qCAAqC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,6BAA6B;YAC3F,uFAAuF;YACvF,oEAAoE;YACpE,oCAAoC;YACpC,iCAAiC;YACjC,mCAAmC;YACnC,mCAAmC;YACnC,qCAAqC;YACrC,6BAA6B;YAC7B,8CAA8C;YAC9C,qCAAqC;YACrC,uDAAuD;YACvD,8CAA8C;YAC9C,yEAAyE;YACzE,oGAAoG;YACpG,mEAAmE;SACpE,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,aAAa,EAAE;YACb,gCAAgC;YAChC,oFAAoF;YACpF,iHAAiH;YACjH,6FAA6F;YAC7F,mEAAmE;YACnE,6GAA6G;YAC7G,yGAAyG;SAC1G,CAAC,IAAI,CAAC,IAAI,CAAC;KACb,CAAC;AACJ,CAAC,CAAC"}

package/dist/magic/handlers/review.d.ts

@@ -0,0 +1,3 @@
+import type { MagicCommandHandler } from "../types.js";
+export declare const handleReview: MagicCommandHandler;
+//# sourceMappingURL=review.d.ts.map

package/dist/magic/handlers/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../../src/magic/handlers/review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,YAAY,EAAE,mBAW1B,CAAC"}

package/dist/magic/handlers/review.js

@@ -0,0 +1,11 @@
+export const handleReview = (input) => {
+    const trimmed = input.trim();
+    return {
+        ok: true,
+        prompt: trimmed.length === 0
+            ? "Review the most recently shared code with severity-tiered findings (CRITICAL / HIGH / MEDIUM / LOW). Cite line numbers. Skip nits unless asked."
+            : `Review the following code with severity-tiered findings:\n\n${trimmed}`,
+        systemAugment: "When reviewing: focus on correctness, security, error handling, immutability, and test coverage. Categorize findings as CRITICAL / HIGH / MEDIUM / LOW. Cite specific lines and explain WHY each finding matters.",
+    };
+};
+//# sourceMappingURL=review.js.map

package/dist/magic/handlers/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../../src/magic/handlers/review.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAwB,CAAC,KAAK,EAAE,EAAE;IACzD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM,EACJ,OAAO,CAAC,MAAM,KAAK,CAAC;YAClB,CAAC,CAAC,iJAAiJ;YACnJ,CAAC,CAAC,+DAA+D,OAAO,EAAE;QAC9E,aAAa,EACX,mNAAmN;KACtN,CAAC;AACJ,CAAC,CAAC"}

package/dist/magic/handlers/test.d.ts

@@ -0,0 +1,3 @@
+import type { MagicCommandHandler } from "../types.js";
+export declare const handleTest: MagicCommandHandler;
+//# sourceMappingURL=test.d.ts.map

package/dist/magic/handlers/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../../src/magic/handlers/test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,UAAU,EAAE,mBAWxB,CAAC"}

package/dist/magic/handlers/test.js

@@ -0,0 +1,11 @@
+export const handleTest = (input) => {
+    const trimmed = input.trim();
+    return {
+        ok: true,
+        prompt: trimmed.length === 0
+            ? "Generate a comprehensive test suite for the most recently shared code. Cover the happy path plus 3-5 edge cases."
+            : `Generate tests for the following:\n\n${trimmed}`,
+        systemAugment: "When generating tests: prefer the project's existing test framework (vitest / jest / pytest / go test) and naming conventions. Cover happy path, error paths, boundary cases, and (when applicable) async timing.",
+    };
+};
+//# sourceMappingURL=test.js.map

package/dist/magic/handlers/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../../src/magic/handlers/test.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAwB,CAAC,KAAK,EAAE,EAAE;IACvD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM,EACJ,OAAO,CAAC,MAAM,KAAK,CAAC;YAClB,CAAC,CAAC,kHAAkH;YACpH,CAAC,CAAC,wCAAwC,OAAO,EAAE;QACvD,aAAa,EACX,mNAAmN;KACtN,CAAC;AACJ,CAAC,CAAC"}

package/dist/magic/magic-commands.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Magic Commands registry — V9 Tier 12 T12.17.
+ *
+ * Maps the dot-prefixed shortcuts to handlers. Pure module — no
+ * runtime state, no env reads.
+ *
+ * Two cohorts:
+ *   1. Utility commands (fix, test, review, refactor, explain, docstring,
+ *      format, optimize) — operate on a code blob the user shares.
+ *   2. Dev-workflow commands (investigate-issue/pr/workflow, ai-commit,
+ *      pr-content, merge-conflict, release-notes) — operate on the
+ *      project's git/GH state to produce structured workflow output.
+ */
+import type { MagicCommand, MagicCommandHandler, MagicCommandId } from "./types.js";
+export declare const MAGIC_COMMANDS: readonly MagicCommand[];
+export declare function getHandler(id: MagicCommandId): MagicCommandHandler;
+//# sourceMappingURL=magic-commands.d.ts.map

package/dist/magic/magic-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"magic-commands.d.ts","sourceRoot":"","sources":["../../src/magic/magic-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAiBpF,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EA4FjD,CAAC;AAqBF,wBAAgB,UAAU,CAAC,EAAE,EAAE,cAAc,GAAG,mBAAmB,CAElE"}

package/dist/magic/magic-commands.js

@@ -0,0 +1,143 @@
+/**
+ * Magic Commands registry — V9 Tier 12 T12.17.
+ *
+ * Maps the dot-prefixed shortcuts to handlers. Pure module — no
+ * runtime state, no env reads.
+ *
+ * Two cohorts:
+ *   1. Utility commands (fix, test, review, refactor, explain, docstring,
+ *      format, optimize) — operate on a code blob the user shares.
+ *   2. Dev-workflow commands (investigate-issue/pr/workflow, ai-commit,
+ *      pr-content, merge-conflict, release-notes) — operate on the
+ *      project's git/GH state to produce structured workflow output.
+ */
+import { handleFix } from "./handlers/fix.js";
+import { handleTest } from "./handlers/test.js";
+import { handleReview } from "./handlers/review.js";
+import { handleRefactor } from "./handlers/refactor.js";
+import { handleExplain } from "./handlers/explain.js";
+import { handleDocstring } from "./handlers/docstring.js";
+import { handleFormat } from "./handlers/format.js";
+import { handleOptimize } from "./handlers/optimize.js";
+import { handleInvestigateIssue } from "./handlers/investigate-issue.js";
+import { handleInvestigatePr } from "./handlers/investigate-pr.js";
+import { handleInvestigateWorkflow } from "./handlers/investigate-workflow.js";
+import { handleAiCommit } from "./handlers/ai-commit.js";
+import { handlePrContent } from "./handlers/pr-content.js";
+import { handleMergeConflict } from "./handlers/merge-conflict.js";
+import { handleReleaseNotes } from "./handlers/release-notes.js";
+export const MAGIC_COMMANDS = [
+    {
+        id: "fix",
+        trigger: ".fix",
+        description: "Fix bugs in the supplied code or context",
+        category: "fix",
+    },
+    {
+        id: "test",
+        trigger: ".test",
+        description: "Generate tests for the supplied code",
+        category: "review",
+    },
+    {
+        id: "review",
+        trigger: ".review",
+        description: "Review the supplied code for quality + correctness",
+        category: "review",
+    },
+    {
+        id: "refactor",
+        trigger: ".refactor",
+        description: "Refactor the supplied code for clarity",
+        category: "refactor",
+    },
+    {
+        id: "explain",
+        trigger: ".explain",
+        description: "Explain how the supplied code works",
+        category: "explain",
+    },
+    {
+        id: "docstring",
+        trigger: ".docstring",
+        description: "Add documentation comments to the supplied code",
+        category: "explain",
+    },
+    {
+        id: "format",
+        trigger: ".format",
+        description: "Format the supplied code per project style",
+        category: "format",
+    },
+    {
+        id: "optimize",
+        trigger: ".optimize",
+        description: "Optimize the supplied code for performance",
+        category: "refactor",
+    },
+    // V9 Tier 12 T12.17 — Jean dev-workflow commands.
+    {
+        id: "investigate-issue",
+        trigger: ".investigate-issue",
+        description: "Triage a GitHub issue: summary, impacted files, hypothesis, next steps",
+        category: "investigate",
+    },
+    {
+        id: "investigate-pr",
+        trigger: ".investigate-pr",
+        description: "Review a GitHub PR: diff, tests, comments, severity-tagged concerns",
+        category: "investigate",
+    },
+    {
+        id: "investigate-workflow",
+        trigger: ".investigate-workflow",
+        description: "Root-cause a GitHub Actions workflow failure from its logs",
+        category: "investigate",
+    },
+    {
+        id: "ai-commit",
+        trigger: ".ai-commit",
+        description: "Stage relevant files and write a Conventional Commit message",
+        category: "git",
+    },
+    {
+        id: "pr-content",
+        trigger: ".pr-content",
+        description: "Draft a PR title, summary, and test plan from the current branch diff",
+        category: "git",
+    },
+    {
+        id: "merge-conflict",
+        trigger: ".merge-conflict",
+        description: "Walk merge-conflict blocks in a file and propose justified resolutions",
+        category: "git",
+    },
+    {
+        id: "release-notes",
+        trigger: ".release-notes",
+        description: "Generate release notes from a commit range (defaults to latest tag..HEAD)",
+        category: "release",
+    },
+];
+const HANDLERS = {
+    fix: handleFix,
+    test: handleTest,
+    review: handleReview,
+    refactor: handleRefactor,
+    explain: handleExplain,
+    docstring: handleDocstring,
+    format: handleFormat,
+    optimize: handleOptimize,
+    // V9 Tier 12 T12.17 — Jean dev-workflow handlers.
+    "investigate-issue": handleInvestigateIssue,
+    "investigate-pr": handleInvestigatePr,
+    "investigate-workflow": handleInvestigateWorkflow,
+    "ai-commit": handleAiCommit,
+    "pr-content": handlePrContent,
+    "merge-conflict": handleMergeConflict,
+    "release-notes": handleReleaseNotes,
+};
+export function getHandler(id) {
+    return HANDLERS[id];
+}
+//# sourceMappingURL=magic-commands.js.map

package/dist/magic/magic-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"magic-commands.js","sourceRoot":"","sources":["../../src/magic/magic-commands.ts"],"names":[],"mappings":"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"}