opencode-snippets 1.4.2 → 1.5.0

package/dist/src/shell.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Executes shell commands in text using !`command` syntax
+ *
+ * @param text - The text containing shell commands to execute
+ * @param ctx - The plugin context (with Bun shell)
+ * @returns The text with shell commands replaced by their output
+ */
+export type ShellContext = {
+    $: (template: TemplateStringsArray, ...args: unknown[]) => {
+        quiet: () => {
+            nothrow: () => {
+                text: () => Promise<string>;
+            };
+        };
+    };
+};
+export declare function executeShellCommands(text: string, ctx: ShellContext): Promise<string>;
+//# sourceMappingURL=shell.d.ts.map

package/dist/src/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/shell.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,CAAC,EAAE,CACD,QAAQ,EAAE,oBAAoB,EAC9B,GAAG,IAAI,EAAE,OAAO,EAAE,KACf;QACH,KAAK,EAAE,MAAM;YAAE,OAAO,EAAE,MAAM;gBAAE,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;aAAE,CAAA;SAAE,CAAC;KACjE,CAAC;CACH,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CA8B3F"}

package/dist/src/shell.js

@@ -0,0 +1,30 @@
+import { PATTERNS } from "./constants.js";
+import { logger } from "./logger.js";
+export async function executeShellCommands(text, ctx) {
+    let result = text;
+    // Reset regex state (global flag requires this)
+    PATTERNS.SHELL_COMMAND.lastIndex = 0;
+    // Find all shell command matches
+    const matches = [...text.matchAll(PATTERNS.SHELL_COMMAND)];
+    // Execute each command and replace in text
+    for (const match of matches) {
+        const cmd = match[1];
+        const _placeholder = match[0];
+        try {
+            const output = await ctx.$ `${{ raw: cmd }}`.quiet().nothrow().text();
+            // Deviate from slash commands' substitution mechanism: print command first, then output
+            const replacement = `$ ${cmd}\n--> ${output.trim()}`;
+            result = result.replace(_placeholder, replacement);
+        }
+        catch (error) {
+            // If shell command fails, leave it as-is
+            // This preserves the original syntax for debugging
+            logger.warn("Shell command execution failed", {
+                command: cmd,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=shell.js.map

package/dist/src/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../src/shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAkBrC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY,EAAE,GAAiB;IACxE,IAAI,MAAM,GAAG,IAAI,CAAC;IAElB,gDAAgD;IAChD,QAAQ,CAAC,aAAa,CAAC,SAAS,GAAG,CAAC,CAAC;IAErC,iCAAiC;IACjC,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;IAE3D,2CAA2C;IAC3C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAE9B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,CAAA,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC;YACrE,wFAAwF;YACxF,MAAM,WAAW,GAAG,KAAK,GAAG,SAAS,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YACrD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,yCAAyC;YACzC,mDAAmD;YACnD,MAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE;gBAC5C,OAAO,EAAE,GAAG;gBACZ,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,65 @@
+import type { createOpencodeClient } from "@opencode-ai/sdk";
+/**
+ * OpenCode client type from the SDK
+ */
+export type OpencodeClient = ReturnType<typeof createOpencodeClient>;
+/**
+ * A snippet with its content and metadata
+ */
+export interface Snippet {
+    /** The primary name/key of the snippet */
+    name: string;
+    /** The content of the snippet (without frontmatter) */
+    content: string;
+    /** Alternative names that also trigger this snippet */
+    aliases: string[];
+}
+/**
+ * Extended snippet info with file metadata
+ */
+export interface SnippetInfo {
+    name: string;
+    content: string;
+    aliases: string[];
+    description?: string;
+    filePath: string;
+    source: "global" | "project";
+}
+/**
+ * Snippet registry that maps keys to snippet info
+ */
+export type SnippetRegistry = Map<string, SnippetInfo>;
+/**
+ * Frontmatter data from snippet files
+ */
+export interface SnippetFrontmatter {
+    /** Alternative hashtags for this snippet (plural form, preferred) */
+    aliases?: string | string[];
+    /** Alternative hashtags for this snippet (singular form, also accepted) */
+    alias?: string | string[];
+    /** Optional description of what this snippet does */
+    description?: string;
+}
+/**
+ * Parsed snippet content with inline text and prepend/append blocks
+ */
+export interface ParsedSnippetContent {
+    /** Content outside blocks (replaces hashtag inline) */
+    inline: string;
+    /** <prepend> block contents in document order */
+    prepend: string[];
+    /** <append> block contents in document order */
+    append: string[];
+}
+/**
+ * Result of expanding hashtags, including collected prepend/append blocks
+ */
+export interface ExpansionResult {
+    /** The inline-expanded text */
+    text: string;
+    /** Collected prepend blocks from all expanded snippets */
+    prepend: string[];
+    /** Collected append blocks from all expanded snippets */
+    append: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gDAAgD;IAChD,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yDAAyD;IACzD,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "opencode-snippets",
-  "version": "1.4.2",
+  "version": "1.5.0",
   "description": "Hashtag-based snippet expansion plugin for OpenCode - instant inline text shortcuts",
-  "main": "index.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "type": "module",
   "engines": {
     "bun": ">=1.0.0"
@@ -28,7 +29,8 @@
   },
   "homepage": "https://github.com/JosXa/opencode-snippets#readme",
   "dependencies": {
-    "gray-matter": "^4.0.3"
+    "gray-matter": "^4.0.3",
+    "jsonc-parser": "^3.3.1"
   },
   "peerDependencies": {
     "@opencode-ai/plugin": ">=1.0.0"
@@ -42,11 +44,13 @@
     "typescript": "^5"
   },
   "scripts": {
-    "build": "tsgo --noEmit",
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsgo --noEmit",
     "format:check": "biome check .",
     "format:fix": "biome check --write .",
     "ai:check": "bun run format:fix",
-    "prepare": "husky"
+    "prepare": "husky",
+    "prepublishOnly": "bun run build"
   },
-  "files": ["index.ts", "src/**/*.ts"]
+  "files": ["dist", "skill"]
 }

package/skill/snippets/SKILL.md

@@ -0,0 +1,148 @@
+---
+name: snippets
+description: MUST use when user asks to create, edit, manage, or share snippets, or asks how snippets work
+---
+
+# Snippets
+
+Reusable text blocks expanded via `#hashtag` in messages.
+
+## Locations
+
+### Snippets
+- **Global**: `~/.config/opencode/snippet/*.md`
+- **Project**: `.opencode/snippet/*.md` (overrides global)
+
+### Configuration
+- **Global**: `~/.config/opencode/snippet/config.jsonc`
+- **Project**: `.opencode/snippet/config.jsonc` (merges with global, project takes priority)
+
+### Logs
+- **Debug logs**: `~/.config/opencode/logs/snippets/daily/YYYY-MM-DD.log`
+
+## Configuration
+
+All boolean settings accept: `true`, `false`, `"enabled"`, `"disabled"`
+
+Full config example with all options:
+
+```jsonc
+{
+  // JSON Schema for editor autocompletion
+  "$schema": "https://raw.githubusercontent.com/JosXa/opencode-snippets/main/schema/config.schema.json",
+
+  // Logging settings
+  "logging": {
+    // Enable debug logging to file
+    // Logs are written to ~/.config/opencode/logs/snippets/daily/
+    // Default: false
+    "debug": false
+  },
+
+  // Automatically install SKILL.md to global skill directory
+  // When enabled, the snippets skill is copied to ~/.config/opencode/skill/snippets/
+  // This enables the LLM to understand how to use snippets
+  // Default: true
+  "installSkill": true
+}
+```
+
+## Snippet Format
+
+```md
+---
+aliases:
+  - short
+  - alt
+description: Optional
+---
+Content here
+```
+
+Frontmatter optional. Filename (minus .md) = primary hashtag.
+
+## Features
+
+- `#other` - include another snippet (recursive, max 15 depth)
+- `` !`cmd` `` - shell substitution, output injected
+
+### Prepend/Append Blocks
+
+Move content to message start/end instead of inline. Best for long reference material that breaks writing flow.
+
+```md
+---
+aliases: jira
+---
+Jira MCP
+<prepend>
+## Jira Field Mappings
+
+- customfield_16570 => Acceptance Criteria
+- customfield_11401 => Team
+</prepend>
+```
+
+Input: `Create bug in #jira about leak`
+Output: Prepended section at top + `Create bug in Jira MCP about leak`.
+
+Use `<append>` for reference material at end. Content inside blocks should use `##` headings.
+
+## Commands
+
+- `/snippet add <name> [content]` - create global snippet
+- `/snippet add --project <name>` - create project snippet
+- `/snippet list` - show all available
+- `/snippet delete <name>` - remove snippet
+
+## Good Snippets
+
+Short, focused, single-purpose. Examples:
+
+```md
+# careful.md
+---
+aliases: safe
+---
+Be careful, autonomous, and ONLY do what I asked.
+```
+
+```md
+# context.md
+---
+aliases: ctx
+---
+Project: !`basename $(pwd)`
+Branch: !`git branch --show-current`
+```
+
+Compose via includes: `#base-rules` inside `#project-config`.
+
+## Sharing Snippets
+
+Share to GitHub Discussions: https://github.com/JosXa/opencode-snippets/discussions/categories/snippets
+
+When user wants to share:
+
+1. Check `gh --version` works
+2. **If gh available**: MUST use question tool to ask user to confirm posting + ask "When do you use it?". Then:
+   ```bash
+   gh api graphql -f query='mutation($repoId: ID!, $catId: ID!, $title: String!, $body: String!) { createDiscussion(input: {repositoryId: $repoId, categoryId: $catId, title: $title, body: $body}) { discussion { url } } }' -f repoId="R_kgDOQ968oA" -f catId="DIC_kwDOQ968oM4C1Qcv" -f title="filename.md" -f body="<body>"
+   ```
+   Body format:
+   ```
+   ## Snippet Content
+   
+   \`\`\`markdown
+   <full snippet file content>
+   \`\`\`
+   
+   ## When do you use it?
+   
+   <user's answer>
+   ```
+3. **If gh unavailable**: Open browser:
+   ```
+   https://github.com/JosXa/opencode-snippets/discussions/new?category=snippets&title=<url-encoded-filename>.md
+   ```
+   Ask user (without question tool) for "When do you use it?" info. Tell them to paste snippet in markdown fence.

package/index.ts

@@ -1,81 +0,0 @@
-import type { Plugin } from "@opencode-ai/plugin";
-import { createCommandExecuteHandler } from "./src/commands.js";
-import { assembleMessage, expandHashtags } from "./src/expander.js";
-import { loadSnippets } from "./src/loader.js";
-import { logger } from "./src/logger.js";
-import { executeShellCommands, type ShellContext } from "./src/shell.js";
-
-/**
- * Snippets Plugin for OpenCode
- *
- * Expands hashtag-based shortcuts in user messages into predefined text snippets.
- * Also provides /snippet command for managing snippets.
- *
- * @see https://github.com/JosXa/opencode-snippets for full documentation
- */
-export const SnippetsPlugin: Plugin = async (ctx) => {
-  // Load all snippets at startup (global + project directory)
-  const startupStart = performance.now();
-  const snippets = await loadSnippets(ctx.directory);
-  const startupTime = performance.now() - startupStart;
-
-  logger.debug("Plugin startup complete", {
-    startupTimeMs: startupTime.toFixed(2),
-    snippetCount: snippets.size,
-  });
-
-  // Create command handler
-  const commandHandler = createCommandExecuteHandler(ctx.client, snippets, ctx.directory);
-
-  return {
-    // Register /snippet command
-    config: async (opencodeConfig) => {
-      opencodeConfig.command ??= {};
-      opencodeConfig.command.snippet = {
-        template: "",
-        description: "Manage text snippets (add, delete, list, help)",
-      };
-    },
-
-    // Handle /snippet command execution
-    "command.execute.before": commandHandler,
-
-    "chat.message": async (_input, output) => {
-      // Only process user messages, never assistant messages
-      if (output.message.role !== "user") return;
-
-      const messageStart = performance.now();
-      let expandTimeTotal = 0;
-      let shellTimeTotal = 0;
-      let processedParts = 0;
-
-      for (const part of output.parts) {
-        if (part.type === "text" && part.text) {
-          // 1. Expand hashtags recursively with loop detection
-          const expandStart = performance.now();
-          const expansionResult = expandHashtags(part.text, snippets);
-          part.text = assembleMessage(expansionResult);
-          const expandTime = performance.now() - expandStart;
-          expandTimeTotal += expandTime;
-
-          // 2. Execute shell commands: !`command`
-          const shellStart = performance.now();
-          part.text = await executeShellCommands(part.text, ctx as unknown as ShellContext);
-          const shellTime = performance.now() - shellStart;
-          shellTimeTotal += shellTime;
-          processedParts += 1;
-        }
-      }
-
-      const totalTime = performance.now() - messageStart;
-      if (processedParts > 0) {
-        logger.debug("Message processing complete", {
-          totalTimeMs: totalTime.toFixed(2),
-          snippetExpandTimeMs: expandTimeTotal.toFixed(2),
-          shellTimeMs: shellTimeTotal.toFixed(2),
-          processedParts,
-        });
-      }
-    },
-  };
-};

package/src/arg-parser.test.ts

@@ -1,177 +0,0 @@
-import { describe, expect, it } from "bun:test";
-import { parseCommandArgs } from "./arg-parser.js";
-
-describe("parseCommandArgs", () => {
-  // Basic splitting
-  describe("basic argument splitting", () => {
-    it("splits simple space-separated args", () => {
-      expect(parseCommandArgs("add test")).toEqual(["add", "test"]);
-    });
-
-    it("handles empty input", () => {
-      expect(parseCommandArgs("")).toEqual([]);
-    });
-
-    it("handles whitespace-only input", () => {
-      expect(parseCommandArgs("   ")).toEqual([]);
-    });
-
-    it("handles multiple spaces between args", () => {
-      expect(parseCommandArgs("add   test")).toEqual(["add", "test"]);
-    });
-
-    it("handles leading and trailing spaces", () => {
-      expect(parseCommandArgs("  add test  ")).toEqual(["add", "test"]);
-    });
-
-    it("handles tabs and mixed whitespace", () => {
-      expect(parseCommandArgs("add\t\ttest")).toEqual(["add", "test"]);
-    });
-  });
-
-  // Double quote handling
-  describe("double quote handling", () => {
-    it("preserves double-quoted strings with spaces", () => {
-      expect(parseCommandArgs('add "hello world"')).toEqual(["add", "hello world"]);
-    });
-
-    it("handles single quote inside double quotes", () => {
-      // THE MAIN BUG - apostrophe in description
-      expect(parseCommandArgs('--desc="don\'t do this"')).toEqual(["--desc=don't do this"]);
-    });
-
-    it("handles empty double-quoted string", () => {
-      expect(parseCommandArgs('add ""')).toEqual(["add", ""]);
-    });
-
-    it("handles double-quoted string at start", () => {
-      expect(parseCommandArgs('"hello world" test')).toEqual(["hello world", "test"]);
-    });
-
-    it("handles multiple double-quoted strings", () => {
-      expect(parseCommandArgs('"first" "second"')).toEqual(["first", "second"]);
-    });
-  });
-
-  // Single quote handling
-  describe("single quote handling", () => {
-    it("preserves single-quoted strings with spaces", () => {
-      expect(parseCommandArgs("add 'hello world'")).toEqual(["add", "hello world"]);
-    });
-
-    it("handles double quote inside single quotes", () => {
-      expect(parseCommandArgs("--desc='say \"hello\"'")).toEqual(['--desc=say "hello"']);
-    });
-
-    it("handles empty single-quoted string", () => {
-      expect(parseCommandArgs("add ''")).toEqual(["add", ""]);
-    });
-  });
-
-  // --key=value syntax
-  describe("--key=value syntax", () => {
-    it("handles --key=value without quotes", () => {
-      expect(parseCommandArgs("--desc=hello")).toEqual(["--desc=hello"]);
-    });
-
-    it('handles --key="value" with quotes stripped from value', () => {
-      expect(parseCommandArgs('--desc="hello world"')).toEqual(["--desc=hello world"]);
-    });
-
-    it("handles --key='value' with quotes stripped from value", () => {
-      expect(parseCommandArgs("--key='hello world'")).toEqual(["--key=hello world"]);
-    });
-
-    it("handles --key=value with special characters", () => {
-      expect(parseCommandArgs("--desc=hello,world")).toEqual(["--desc=hello,world"]);
-    });
-
-    it("preserves = inside quoted value", () => {
-      expect(parseCommandArgs('--desc="a=b"')).toEqual(["--desc=a=b"]);
-    });
-  });
-
-  // Multiline content (critical for snippet bodies)
-  describe("multiline content", () => {
-    it("handles multiline content in double quotes", () => {
-      expect(parseCommandArgs('add test "line1\nline2\nline3"')).toEqual([
-        "add",
-        "test",
-        "line1\nline2\nline3",
-      ]);
-    });
-
-    it("handles multiline content in single quotes", () => {
-      expect(parseCommandArgs("add test 'line1\nline2'")).toEqual(["add", "test", "line1\nline2"]);
-    });
-
-    it("handles multiline content with --key=value syntax", () => {
-      expect(parseCommandArgs('--desc="line1\nline2"')).toEqual(["--desc=line1\nline2"]);
-    });
-
-    it("preserves indentation in multiline content", () => {
-      const input = 'add test "line1\n  indented\n    more indented"';
-      expect(parseCommandArgs(input)).toEqual([
-        "add",
-        "test",
-        "line1\n  indented\n    more indented",
-      ]);
-    });
-  });
-
-  // Mixed scenarios
-  describe("mixed scenarios", () => {
-    it("handles mixed quoted and unquoted args", () => {
-      expect(parseCommandArgs('add test "hello world" --project')).toEqual([
-        "add",
-        "test",
-        "hello world",
-        "--project",
-      ]);
-    });
-
-    it("handles complex command with all option types", () => {
-      const input = 'add mysnippet "content here" --aliases=a,b --desc="don\'t forget" --project';
-      expect(parseCommandArgs(input)).toEqual([
-        "add",
-        "mysnippet",
-        "content here",
-        "--aliases=a,b",
-        "--desc=don't forget",
-        "--project",
-      ]);
-    });
-
-    it("handles --key value syntax (space-separated)", () => {
-      expect(parseCommandArgs("--desc hello")).toEqual(["--desc", "hello"]);
-    });
-
-    it("handles --key followed by quoted value", () => {
-      expect(parseCommandArgs('--desc "hello world"')).toEqual(["--desc", "hello world"]);
-    });
-  });
-
-  // Edge cases
-  describe("edge cases", () => {
-    it("handles unclosed double quote by including rest of string", () => {
-      // Graceful handling: treat unclosed quote as extending to end
-      expect(parseCommandArgs('add "unclosed')).toEqual(["add", "unclosed"]);
-    });
-
-    it("handles unclosed single quote by including rest of string", () => {
-      expect(parseCommandArgs("add 'unclosed")).toEqual(["add", "unclosed"]);
-    });
-
-    it("handles backslash-escaped quotes inside double quotes", () => {
-      expect(parseCommandArgs('--desc="say \\"hello\\""')).toEqual(['--desc=say "hello"']);
-    });
-
-    it("handles backslash-escaped quotes inside single quotes", () => {
-      expect(parseCommandArgs("--desc='it\\'s fine'")).toEqual(["--desc=it's fine"]);
-    });
-
-    it("handles literal backslash", () => {
-      expect(parseCommandArgs('--path="C:\\\\Users"')).toEqual(["--path=C:\\Users"]);
-    });
-  });
-});

package/src/arg-parser.ts

@@ -1,87 +0,0 @@
-/**
- * Shell-like argument parser that handles quoted strings correctly.
- *
- * Supports:
- * - Space-separated arguments
- * - Double-quoted strings (preserves spaces, allows single quotes inside)
- * - Single-quoted strings (preserves spaces, allows double quotes inside)
- * - --key=value syntax with quoted values
- * - Multiline content inside quotes
- * - Backslash escapes for quotes inside quoted strings
- *
- * @param input - The raw argument string to parse
- * @returns Array of parsed arguments with quotes stripped
- */
-export function parseCommandArgs(input: string): string[] {
-  const args: string[] = [];
-  let current = "";
-  let state: "normal" | "double" | "single" = "normal";
-  let hasQuotedContent = false; // Track if we've entered a quoted section
-  let i = 0;
-
-  while (i < input.length) {
-    const char = input[i];
-
-    if (state === "normal") {
-      if (char === " " || char === "\t") {
-        // Whitespace in normal mode: finish current token
-        if (current.length > 0 || hasQuotedContent) {
-          args.push(current);
-          current = "";
-          hasQuotedContent = false;
-        }
-      } else if (char === '"') {
-        // Enter double-quote mode
-        state = "double";
-        hasQuotedContent = true;
-      } else if (char === "'") {
-        // Enter single-quote mode
-        state = "single";
-        hasQuotedContent = true;
-      } else {
-        current += char;
-      }
-    } else if (state === "double") {
-      if (char === "\\") {
-        // Check for escape sequences
-        const next = input[i + 1];
-        if (next === '"' || next === "\\") {
-          current += next;
-          i++; // Skip the escaped character
-        } else {
-          current += char;
-        }
-      } else if (char === '"') {
-        // Exit double-quote mode
-        state = "normal";
-      } else {
-        current += char;
-      }
-    } else if (state === "single") {
-      if (char === "\\") {
-        // Check for escape sequences
-        const next = input[i + 1];
-        if (next === "'" || next === "\\") {
-          current += next;
-          i++; // Skip the escaped character
-        } else {
-          current += char;
-        }
-      } else if (char === "'") {
-        // Exit single-quote mode
-        state = "normal";
-      } else {
-        current += char;
-      }
-    }
-
-    i++;
-  }
-
-  // Handle any remaining content (including unclosed quotes or empty quoted strings)
-  if (current.length > 0 || hasQuotedContent) {
-    args.push(current);
-  }
-
-  return args;
-}