gemiterm 2.0.0 → 2.1.1

package/src/infrastructure/cli-parser.ts

@@ -0,0 +1,77 @@
+import { Command, CommanderError } from "commander";
+import type { CommandRegistry } from "../cli/command-registry.ts";
+import { showHelp } from "../cli/commands/help.ts";
+
+export interface ParsedFlags {
+  verbose: boolean;
+  version: boolean;
+  help: boolean;
+}
+
+export interface ParsedArgs {
+  flags: ParsedFlags;
+  subcommand: string | null;
+  subcommandArgs: string[];
+}
+
+function splitAtFirstNonFlag(argv: string[]): { pre: string[]; post: string[] } {
+  const pre: string[] = [];
+  const post: string[] = [];
+  let found = false;
+  for (const arg of argv) {
+    if (!found && !arg.startsWith("-")) {
+      found = true;
+      post.push(arg);
+      continue;
+    }
+    if (found) {
+      post.push(arg);
+    } else {
+      pre.push(arg);
+    }
+  }
+  return { pre, post };
+}
+
+export function parseGlobalArgs(argv: string[]): ParsedArgs {
+  const { pre, post } = splitAtFirstNonFlag(argv);
+  const subcommand = post[0] ?? null;
+  const subcommandArgs = post.slice(1);
+
+  const program = new Command();
+  program
+    .exitOverride()
+    .allowUnknownOption(false)
+    .allowExcessArguments(true)
+    .helpOption(false)
+    .configureOutput({ writeErr: () => {} })
+    .option("-v, --verbose", "enable verbose output")
+    .option("--version", "show version number")
+    .option("-h, --help", "show help");
+
+  try {
+    program.parse(pre, { from: "user" });
+  } catch (error) {
+    if (error instanceof CommanderError) {
+      throw new Error("gemiterm: " + error.message);
+    }
+    throw error;
+  }
+
+  const opts = program.opts<{ verbose?: boolean; version?: boolean; help?: boolean }>();
+  const flags: ParsedFlags = {
+    verbose: Boolean(opts.verbose),
+    version: Boolean(opts.version),
+    help: Boolean(opts.help),
+  };
+
+  return { flags, subcommand, subcommandArgs };
+}
+
+export function printVersion(pkgVersion: string): void {
+  console.log(`gemiterm v${pkgVersion}`);
+}
+
+export function printHelp(registry: CommandRegistry): void {
+  showHelp(registry);
+}

package/src/infrastructure/io.ts

@@ -114,6 +114,14 @@ function removeDir(path: string): void {
   }
 }
 
+function removeFile(path: string): void {
+  try {
+    rmSync(path, { force: true });
+  } catch (err) {
+    throw wrap("removeFile", path, err instanceof Error ? err : undefined);
+  }
+}
+
 function renameDir(src: string, dest: string): void {
   try {
     renameSync(src, dest);
@@ -155,6 +163,7 @@ export {
   readJsonFile,
   writeJsonFile,
   removeDir,
+  removeFile,
   renameDir,
   isDirectory,
   listSubdirectories,

package/src/services/skills-cli-driver.ts

@@ -0,0 +1,58 @@
+import { Logger } from "../infrastructure/logger.ts";
+
+export class SkillsCliError extends Error {
+  constructor(command: string, exitCode: number, stderr: string) {
+    super(`skills '${command}' exited with code ${exitCode}: ${stderr}`);
+    this.name = "SkillsCliError";
+  }
+}
+
+export interface SkillsRunnerResult {
+  exitCode: number;
+  stdout: string;
+  stderr: string;
+}
+
+export interface SkillsRunner {
+  run(args: string[]): Promise<SkillsRunnerResult>;
+}
+
+export class BunSkillsRunner implements SkillsRunner {
+  async run(args: string[]): Promise<SkillsRunnerResult> {
+    const proc = Bun.spawn(["npx", "skills", ...args], {
+      stdout: "pipe",
+      stderr: "pipe",
+      stdin: "ignore",
+    });
+    const [stdout, stderr, exitCode] = await Promise.all([
+      new Response(proc.stdout).text(),
+      new Response(proc.stderr).text(),
+      proc.exited,
+    ]);
+    return { exitCode: exitCode ?? -1, stdout: stdout.trim(), stderr: stderr.trim() };
+  }
+}
+
+export interface SkillsCliDriverOptions {
+  logger?: Logger;
+  runner?: SkillsRunner;
+}
+
+export class SkillsCliDriver {
+  private readonly logger: Logger;
+  private readonly runner: SkillsRunner;
+
+  constructor(opts: SkillsCliDriverOptions = {}) {
+    this.logger = opts.logger ?? new Logger("skills-cli-driver");
+    this.runner = opts.runner ?? new BunSkillsRunner();
+  }
+
+  async run(args: string[]): Promise<string> {
+    this.logger.debug(`Running: npx skills ${args.join(" ")}`);
+    const result = await this.runner.run(args);
+    if (result.exitCode !== 0) {
+      throw new SkillsCliError(args.join(" "), result.exitCode, result.stderr);
+    }
+    return result.stdout;
+  }
+}

package/src/services/skills-service.ts

@@ -0,0 +1,52 @@
+import { Logger } from "../infrastructure/logger.ts";
+import { SkillsCliDriver, SkillsCliDriverOptions, SkillsCliError } from "./skills-cli-driver.ts";
+
+export class SkillsInstallError extends Error {
+  constructor(message: string, public readonly cause?: Error) {
+    super(message);
+    this.name = "SkillsInstallError";
+  }
+}
+
+export interface InstallSkillsServiceOptions {
+  logger?: Logger;
+  driver?: SkillsCliDriver;
+  repo?: string;
+  skills?: string[];
+}
+
+export class InstallSkillsService {
+  private readonly logger: Logger;
+  private readonly driver: SkillsCliDriver;
+  private readonly repo: string;
+  private readonly skills: string[];
+
+  constructor(opts: InstallSkillsServiceOptions = {}) {
+    this.logger = opts.logger ?? new Logger("install-skills-service");
+    this.repo = opts.repo ?? "expert-vision-software/opencode-gemiterm-skills";
+    this.skills = opts.skills ?? ["gemiterm", "debate-with-gemini"];
+    this.driver = opts.driver ?? new SkillsCliDriver({ logger: this.logger });
+  }
+
+  async install(): Promise<string> {
+    this.logger.info(`Installing skills from ${this.repo}: ${this.skills.join(", ")}`);
+    const args = ["add", this.repo];
+    for (const skill of this.skills) {
+      args.push("--skill", skill);
+    }
+
+    try {
+      const output = await this.driver.run(args);
+      this.logger.info(`Skills installed successfully: ${output}`);
+      return output;
+    } catch (error) {
+      if (error instanceof SkillsCliError) {
+        throw new SkillsInstallError(error.message, error);
+      }
+      throw new SkillsInstallError(
+        `Failed to install skills: ${error instanceof Error ? error.message : String(error)}`,
+        error instanceof Error ? error : undefined,
+      );
+    }
+  }
+}

package/.env

@@ -1,2 +0,0 @@
-GEMITERM_CONFIG_DIR=./.gemiterm
-GEMITERM_VERBOSE=true

package/.github/workflows/manual-release.yml

@@ -1,34 +0,0 @@
-name: Manual Release
-
-on:
-  workflow_dispatch:
-    inputs:
-      ref:
-        description: 'Commit hash, branch, or tag to build'
-        required: true
-        type: string
-      draft:
-        description: 'Create a draft release (recommended for testing)'
-        required: true
-        type: boolean
-        default: true
-      pre_release:
-        description: 'Mark as pre-release'
-        required: true
-        type: boolean
-        default: true
-      publish:
-        description: 'Publish to npm (DANGEROUS — only enable if you mean it)'
-        required: true
-        type: boolean
-        default: false
-
-jobs:
-  build:
-    uses: ./.github/workflows/release.yml
-    with:
-      ref: ${{ inputs.ref }}
-      tag_name: manual-${{ inputs.ref }}-${{ github.run_id }}
-      publish: ${{ inputs.publish }}
-      draft: ${{ inputs.draft }}
-      prerelease: ${{ inputs.pre_release }}

package/.github/workflows/release.yml

@@ -1,198 +0,0 @@
-name: Release
-
-on:
-  push:
-    tags: ['v*']
-  workflow_call:
-    inputs:
-      ref:
-        description: 'Git ref (commit hash, branch, or tag) to build'
-        type: string
-        default: ${{ github.ref }}
-      tag_name:
-        description: 'Tag name to attach the GitHub Release to'
-        type: string
-        default: ${{ github.ref_name }}
-      publish:
-        description: 'Whether to publish to npm'
-        type: string
-        default: 'true'
-      draft:
-        description: 'Whether to create the release as a draft'
-        type: string
-        default: 'false'
-      prerelease:
-        description: 'Whether to mark the release as a pre-release'
-        type: string
-        default: 'true'
-
-concurrency:
-  group: release
-  cancel-in-progress: true
-
-permissions:
-  contents: write
-
-jobs:
-  build-linux:
-    name: Build Linux
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: ${{ inputs.ref || github.ref }}
-      - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: 1.3.13
-      - run: bun install --frozen-lockfile
-      - run: bun run build:linux
-      - name: Verify binary
-        run: test -f dist/gemiterm
-      - name: Fail if binary < 20MB
-        run: |
-          size=$(stat -c%s dist/gemiterm)
-          minsize=$((20 * 1024 * 1024))
-          if [ "$size" -lt "$minsize" ]; then
-            echo "Binary too small: $size bytes (expected at least 20MB)"
-            exit 1
-          fi
-      - uses: actions/upload-artifact@v4
-        with:
-          name: GemiTerm-linux
-          path: dist/gemiterm
-
-  build-windows:
-    name: Build Windows
-    runs-on: windows-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: ${{ inputs.ref || github.ref }}
-      - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: 1.3.13
-      - run: bun install --frozen-lockfile
-      - run: bun run build:windows
-      - name: Verify binary
-        run: Test-Path dist/gemiterm.exe
-      - name: Fail if binary < 20MB
-        shell: pwsh
-        run: |
-          $size = (Get-Item dist/gemiterm.exe).Length
-          $minsize = 20 * 1024 * 1024
-          if ($size -lt $minsize) {
-            Write-Host "Binary too small: $size bytes (expected at least 20MB)"
-            exit 1
-          }
-      - uses: actions/upload-artifact@v4
-        with:
-          name: GemiTerm-windows
-          path: dist/gemiterm.exe
-
-  release:
-    name: Create GitHub Release
-    runs-on: ubuntu-latest
-    needs: [build-linux, build-windows]
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: ${{ inputs.ref || github.ref }}
-      - uses: actions/download-artifact@v4
-        with:
-          name: GemiTerm-linux
-          path: dist
-      - uses: actions/download-artifact@v4
-        with:
-          name: GemiTerm-windows
-          path: dist
-      - name: Make Linux binary executable
-        run: chmod +x dist/gemiterm
-      - name: Extract CHANGELOG entry for release
-        id: changelog
-        run: |
-          node -e "
-            const version = '${TAG}'.replace(/^v/, '');
-            const fs = require('fs');
-            const content = fs.readFileSync('CHANGELOG.md', 'utf8');
-            const sections = content.split(/(?=^## )/m);
-            let found = false;
-            let notes = '';
-            for (const section of sections) {
-              const m = section.match(/^## \[([^\]]+)\].*?-\s*(\d{4}-\d{2}-\d{2})/s);
-              if (m && m[1].replace(/^v/, '') === version) {
-                notes = section.replace(/^## \[[^\]]+\].*?-\s*\d{4}-\d{2}-\d{2}\n/, '').trim();
-                found = true;
-                break;
-              }
-            }
-            if (!found) {
-              console.error('No changelog section found for version:', version);
-              process.exit(1);
-            }
-            fs.writeFileSync('release_body.md', notes);
-            console.log('Extracted', notes.split('\n').length, 'lines for version', version);
-          "
-        env:
-          TAG: ${{ inputs.tag_name || github.ref_name }}
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v2
-        with:
-          tag_name: ${{ inputs.tag_name || github.ref_name }}
-          body_path: release_body.md
-          draft: false
-          prerelease: ${{ contains(inputs.tag_name || github.ref_name, '-') }}
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      - name: Upload Linux binary
-        run: |
-          TAG="${{ inputs.tag_name || github.ref_name }}"
-          gh release upload "$TAG" dist/gemiterm --clobber || true
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      - name: Upload Windows binary
-        run: |
-          TAG="${{ inputs.tag_name || github.ref_name }}"
-          gh release upload "$TAG" dist/gemiterm.exe --clobber || true
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      - name: Set asset labels
-        run: |
-          TAG="${{ inputs.tag_name || github.ref_name }}"
-          LINUX_ASSET_ID=$(gh release view "$TAG" --json assets -q '.assets[] | select(.name == "gemiterm") | .id')
-          if [[ -n "$LINUX_ASSET_ID" ]]; then
-            gh api -X PATCH /repos/${{ github.repository }}/releases/assets/$LINUX_ASSET_ID \
-              -f name='GemiTerm' \
-              -f label="GemiTerm $TAG - Linux x64 binary" || true
-          fi
-          WINDOWS_ASSET_ID=$(gh release view "$TAG" --json assets -q '.assets[] | select(.name == "gemiterm.exe") | .id')
-          if [[ -n "$WINDOWS_ASSET_ID" ]]; then
-            gh api -X PATCH /repos/${{ github.repository }}/releases/assets/$WINDOWS_ASSET_ID \
-              -f name='GemiTerm' \
-              -f label="GemiTerm $TAG - Windows x64 binary" || true
-          fi
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-
-  publish:
-    name: Publish to npm
-    runs-on: ubuntu-latest
-    needs: [release]
-    if: ${{ inputs.publish != 'false' }}
-    permissions:
-      contents: read
-      id-token: write
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: ${{ inputs.ref || github.ref }}
-      - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: 1.3.13
-      - run: bun install
-      - name: Publish to npm
-        run: |
-          echo "//registry.npmjs.org/:_authToken=${NPM_TOKEN}" > ~/.npmrc
-          npm publish --provenance --access public
-        env:
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.github/workflows/test.yml

@@ -1,29 +0,0 @@
-name: Test
-
-on:
-  pull_request: {}
-  push:
-    branches: [main]
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: 1.3.13
-      - run: bun install --frozen-lockfile
-      - run: bun test
-      - run: bun run typecheck
-      - name: Enforce path-utils mediation
-        run: |
-          ! grep -rn --include='*.ts' "from \"node:\\(fs\\|path\\|os\\)\"" src/ \
-            | grep -v "src/infrastructure/path-utils.ts" \
-            | grep -v "src/infrastructure/io.ts" \
-            | grep -v "src/services/install-browser-service.ts" \
-            | grep -q .

package/.opencode/commands/opsx-apply.md

@@ -1,152 +0,0 @@
----
-description: Implement tasks from an OpenSpec change (Experimental)
----
-
-Implement tasks from an OpenSpec change.
-
-**Input**: Optionally specify a change name (e.g., `/opsx-apply add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
-
-**Steps**
-
-1. **Select the change**
-
-   If a name is provided, use it. Otherwise:
-   - Infer from conversation context if the user mentioned a change
-   - Auto-select if only one active change exists
-   - If ambiguous, run `openspec list --json` to get available changes and use the **AskUserQuestion tool** to let the user select
-
-   Always announce: "Using change: <name>" and how to override (e.g., `/opsx-apply <other>`).
-
-2. **Check status to understand the schema**
-   ```bash
-   openspec status --change "<name>" --json
-   ```
-   Parse the JSON to understand:
-   - `schemaName`: The workflow being used (e.g., "spec-driven")
-   - `planningHome`, `changeRoot`, and `actionContext`: planning scope and edit constraints
-   - Which artifact contains the tasks (typically "tasks" for spec-driven, check status for others)
-
-3. **Get apply instructions**
-
-   ```bash
-   openspec instructions apply --change "<name>" --json
-   ```
-
-   This returns:
-   - `contextFiles`: artifact ID -> array of concrete file paths (varies by schema)
-   - Progress (total, complete, remaining)
-   - Task list with status
-   - Dynamic instruction based on current state
-
-   **Handle states:**
-   - If `state: "blocked"` (missing artifacts): show message, suggest using `/opsx-continue`
-   - If `state: "all_done"`: congratulate, suggest archive
-   - Otherwise: proceed to implementation
-
-   **Workspace guard:** If status JSON reports `actionContext.mode: "workspace-planning"` and `allowedEditRoots` is empty, explain that full workspace apply is not supported in this slice. Treat linked repos and folders as read-only context, ask the user to select an affected area through an explicit implementation workflow, and STOP before editing files.
-
-4. **Read context files**
-
-   Read every file path listed under `contextFiles` from the apply instructions output.
-   The files depend on the schema being used:
-   - **spec-driven**: proposal, specs, design, tasks
-   - Other schemas: follow the contextFiles from CLI output
-
-5. **Show current progress**
-
-   Display:
-   - Schema being used
-   - Progress: "N/M tasks complete"
-   - Remaining tasks overview
-   - Dynamic instruction from CLI
-
-6. **Implement tasks (loop until done or blocked)**
-
-   For each pending task:
-   - Show which task is being worked on
-   - Make the code changes required
-   - Keep changes minimal and focused
-   - Mark task complete in the tasks file: `- [ ]` → `- [x]`
-   - Continue to next task
-
-   **Pause if:**
-   - Task is unclear → ask for clarification
-   - Implementation reveals a design issue → suggest updating artifacts
-   - Error or blocker encountered → report and wait for guidance
-   - User interrupts
-
-7. **On completion or pause, show status**
-
-   Display:
-   - Tasks completed this session
-   - Overall progress: "N/M tasks complete"
-   - If all done: suggest archive
-   - If paused: explain why and wait for guidance
-
-**Output During Implementation**
-
-```
-## Implementing: <change-name> (schema: <schema-name>)
-
-Working on task 3/7: <task description>
-[...implementation happening...]
-✓ Task complete
-
-Working on task 4/7: <task description>
-[...implementation happening...]
-✓ Task complete
-```
-
-**Output On Completion**
-
-```
-## Implementation Complete
-
-**Change:** <change-name>
-**Schema:** <schema-name>
-**Progress:** 7/7 tasks complete ✓
-
-### Completed This Session
-- [x] Task 1
-- [x] Task 2
-...
-
-All tasks complete! You can archive this change with `/opsx-archive`.
-```
-
-**Output On Pause (Issue Encountered)**
-
-```
-## Implementation Paused
-
-**Change:** <change-name>
-**Schema:** <schema-name>
-**Progress:** 4/7 tasks complete
-
-### Issue Encountered
-<description of the issue>
-
-**Options:**
-1. <option 1>
-2. <option 2>
-3. Other approach
-
-What would you like to do?
-```
-
-**Guardrails**
-- Keep going through tasks until done or blocked
-- Always read context files before starting (from the apply instructions output)
-- If task is ambiguous, pause and ask before implementing
-- If implementation reveals issues, pause and suggest artifact updates
-- Keep code changes minimal and scoped to each task
-- Update task checkbox immediately after completing each task
-- Pause on errors, blockers, or unclear requirements - don't guess
-- Use contextFiles from CLI output, don't assume specific file names
-
-**Fluid Workflow Integration**
-
-This skill supports the "actions on a change" model:
-
-- **Can be invoked anytime**: Before all artifacts are done (if tasks exist), after partial implementation, interleaved with other actions
-- **Allows artifact updates**: If implementation reveals design issues, suggest updating artifacts - not phase-locked, work fluidly