opensoma 0.1.0

package/.claude-plugin/README.md

@@ -0,0 +1,145 @@
+# OpenSoma
+
+SWMaestro MyPage CLI & SDK for AI agents.
+
+## Overview
+
+OpenSoma wraps the SWMaestro MyPage platform (swmaestro.ai) to provide programmatic access to:
+
+- **Mentoring sessions** - List, create, apply, cancel, and manage mentoring sessions
+- **Meeting room reservations** - Reserve rooms at the SWMaestro center
+- **Dashboard** - View upcoming events, notices, and personal information
+- **Team info** - Access team details and member information
+- **Notices** - Read official announcements
+- **Events** - Browse and apply for program events
+
+## Installation
+
+```bash
+npm install -g opensoma
+```
+
+## Authentication
+
+### Browser Session Extraction
+
+Extract existing session from Chromium-based browsers:
+
+```bash
+opensoma auth extract
+```
+
+### Login with Credentials
+
+```bash
+opensoma auth login --username <email> --password <password>
+```
+
+Or use environment variables:
+
+```bash
+export OPENSOMA_USERNAME=<email>
+export OPENSOMA_PASSWORD=<password>
+opensoma auth login
+```
+
+## Commands
+
+All commands output JSON. Add `--pretty` for formatted output.
+
+### Dashboard
+
+```bash
+opensoma dashboard show
+```
+
+### Mentoring
+
+```bash
+# List sessions
+opensoma mentoring list
+opensoma mentoring list --status open --type public
+
+# Search
+opensoma mentoring list --search "keyword"
+
+# Get details
+opensoma mentoring get <id>
+
+# Create session
+opensoma mentoring create \
+  --title "Title" \
+  --type public \
+  --date 2025-01-15 \
+  --start 14:00 \
+  --end 16:00 \
+  --venue "스페이스 A1"
+
+# Apply to session
+opensoma mentoring apply <id>
+
+# Cancel application
+opensoma mentoring cancel --apply-sn <number> --qustnr-sn <number>
+
+# View history
+opensoma mentoring history
+```
+
+### Meeting Rooms
+
+```bash
+# List rooms
+opensoma room list --date 2025-01-15
+
+# Check availability
+opensoma room available <roomId> --date 2025-01-15
+
+# Reserve
+opensoma room reserve \
+  --room A1 \
+  --date 2025-01-15 \
+  --slots "14:00,14:30,15:00" \
+  --title "Team Meeting"
+```
+
+### Notices
+
+```bash
+opensoma notice list
+opensoma notice get <id>
+```
+
+### Team & Member
+
+```bash
+opensoma team show
+opensoma member show
+```
+
+### Events
+
+```bash
+opensoma event list
+opensoma event get <id>
+opensoma event apply <id>
+```
+
+## SDK
+
+```typescript
+import { SomaClient } from 'opensoma'
+
+const client = new SomaClient({
+  username: process.env.OPENSOMA_USERNAME,
+  password: process.env.OPENSOMA_PASSWORD,
+})
+await client.login()
+
+// Use the SDK
+const dashboard = await client.dashboard.get()
+const { items } = await client.mentoring.list({ status: 'open' })
+```
+
+## License
+
+MIT

package/.claude-plugin/plugin.json

@@ -0,0 +1,23 @@
+{
+  "name": "opensoma",
+  "version": "0.1.0",
+  "description": "SWMaestro MyPage CLI & SDK for AI agents - manage mentoring sessions, reserve meeting rooms, view dashboard, team info, notices, and member profiles",
+  "author": {
+    "name": "devxoul",
+    "url": "https://github.com/devxoul"
+  },
+  "license": "MIT",
+  "keywords": [
+    "swmaestro",
+    "software-maestro",
+    "mentoring",
+    "meeting-room",
+    "kr",
+    "korean"
+  ],
+  "homepage": "https://github.com/devxoul/opensoma",
+  "repository": "https://github.com/devxoul/opensoma",
+  "skills": [
+    "./skills/opensoma"
+  ]
+}

package/.github/workflows/release.yml

@@ -0,0 +1,86 @@
+name: Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Version (x.y.z)"
+        required: true
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Typecheck
+        run: bun run typecheck
+
+      - name: Lint
+        run: bun run lint
+
+      - name: Test
+        run: bun run test
+
+      - name: Build
+        run: bun run build
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Bump version
+        run: |
+          npm version ${{ inputs.version }} --no-git-tag-version --allow-same-version
+          bun -e "
+            const fs = require('fs');
+            const v = '${{ inputs.version }}';
+            let readme = fs.readFileSync('README.md', 'utf8');
+            readme = readme.replace(/opensoma@[\d.]+/g, 'opensoma@' + v);
+            fs.writeFileSync('README.md', readme);
+            const pluginJson = JSON.parse(fs.readFileSync('.claude-plugin/plugin.json', 'utf8'));
+            pluginJson.version = v;
+            fs.writeFileSync('.claude-plugin/plugin.json', JSON.stringify(pluginJson, null, 2) + '\n');
+            for (const dir of fs.readdirSync('skills')) {
+              const p = 'skills/' + dir + '/SKILL.md';
+              if (fs.existsSync(p)) {
+                let s = fs.readFileSync(p, 'utf8');
+                s = s.replace(/^version: .+$/m, 'version: ' + v);
+                fs.writeFileSync(p, s);
+              }
+            }
+          "
+
+      - name: Commit and tag
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add package.json README.md skills/*/SKILL.md .claude-plugin/plugin.json
+          git diff --staged --quiet || git commit -m "${{ inputs.version }}"
+          git tag "${{ inputs.version }}"
+          git push origin HEAD --tags
+
+      - name: Publish to npm
+        run: npm publish --provenance --access public
+
+      - name: Create GitHub Release
+        run: gh release create "${{ inputs.version }}" --generate-notes
+        env:
+          GH_TOKEN: ${{ github.token }}

package/.oxfmtrc.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "./node_modules/oxfmt/configuration_schema.json",
+  "printWidth": 120,
+  "useTabs": false,
+  "semi": false,
+  "singleQuote": true,
+  "sortImports": {},
+  "ignorePatterns": ["dist/**", ".github/**", "**/*.md"]
+}

package/.oxlintrc.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "ignorePatterns": ["dist/**", ".github/**", "**/*.md"]
+}

package/AGENTS.md

@@ -0,0 +1,78 @@
+# AGENTS.md
+
+## Project Overview
+
+SWMaestro MyPage CLI & SDK for AI agents. Wraps the SWMaestro platform (swmaestro.ai) to provide programmatic access to mentoring sessions, meeting room reservations, dashboard, notices, team info, member profiles, and events.
+
+Runtime: Bun for development, Node.js-compatible output for npm distribution.
+
+## Commands
+
+```bash
+# Install dependencies
+bun install
+
+# Run all unit tests
+bun test
+
+# Type checking
+bun run typecheck
+
+# Lint (oxlint)
+bun run lint
+bun run lint:fix
+
+# Format (oxfmt)
+bun run format
+```
+
+Always use `bun` — never `node`, `npm`, `npx`, `yarn`, or `pnpm`. Bun loads `.env` automatically; do not use dotenv.
+
+## TypeScript Execution Model
+
+### Local Development
+
+Bun runs TypeScript directly — no compilation step needed.
+
+- `bin` entry in `package.json` points to `./src/cli.ts`
+- CLI entry point uses `#!/usr/bin/env bun` shebang
+- Run directly: `bun src/cli.ts`
+
+### Production Build (Publish)
+
+`bun run build` compiles to `dist/` for npm consumers who don't have Bun.
+
+1. `tsc` compiles `src/` → `dist/src/` (JS + declarations + source maps)
+2. `tsc-alias` resolves `@/*` path aliases in the compiled output
+3. `scripts/postbuild.ts` replaces `#!/usr/bin/env bun` → `#!/usr/bin/env node` in CLI file
+4. `module` and `main` in `package.json` point to `dist/src/index.js`
+
+npm consumers run compiled JS via Node.js. The `prepublishOnly` script runs the build, then `scripts/prepublish.ts` rewrites `bin` paths from `./src/*.ts` to `dist/src/*.js`. After publish, `postpublish` restores `package.json` via `git checkout`.
+
+### Key Distinction
+
+|             | Local (dev)       | Published (npm)          |
+| ----------- | ----------------- | ------------------------ |
+| Runtime     | Bun               | Node.js                  |
+| Entry files | `src/cli.ts`      | `dist/src/cli.js`        |
+| Shebang     | `#!/usr/bin/env bun` | `#!/usr/bin/env node` |
+| Compilation | None (Bun runs TS) | `tsc` → `dist/`         |
+
+## Release
+
+To publish a new version to npm:
+
+1. Bump version in `package.json`
+2. Run `bun run build` to verify the build succeeds
+3. Run `npm publish` (triggers `prepublishOnly` → build + rewrite bin paths, then `postpublish` → restore `package.json`)
+
+Tags have no `v` prefix.
+
+### Version Decision
+
+When asked to release without a specific version:
+
+- **Patch** (x.y.Z) — bug fixes, docs, refactors, non-breaking changes
+- **Minor** (x.Y.0) — new features, new commands, new options, expanded capabilities
+
+Decide automatically based on commits since last release. Do not ask the user. Never bump major unless the user explicitly requests it. If the user specifies a version, use it as-is.

package/README.md

@@ -0,0 +1,249 @@
+# opensoma
+
+소프트웨어 마에스트로(SWMaestro) 마이페이지 CLI & SDK. 멘토링, 회의실 예약, 공지사항, 행사 등 마이페이지 기능을 커맨드라인과 프로그래밍 방식으로 사용할 수 있습니다.
+
+AI 에이전트가 SWMaestro 플랫폼과 상호작용할 수 있도록 설계되었습니다. 모든 출력은 JSON 형식입니다.
+
+## 설치
+
+```bash
+npm install opensoma
+```
+
+## 인증
+
+### 브라우저 세션 추출
+
+Chromium 계열 브라우저(Chrome, Edge, Brave, Arc, Vivaldi)에서 swmaestro.ai에 로그인된 세션을 자동으로 추출합니다.
+
+```bash
+opensoma auth extract
+```
+
+### 아이디/비밀번호 로그인
+
+```bash
+opensoma auth login --username <아이디> --password <비밀번호>
+```
+
+환경변수로도 전달 가능합니다:
+
+```bash
+export OPENSOMA_USERNAME=<아이디>
+export OPENSOMA_PASSWORD=<비밀번호>
+opensoma auth login
+```
+
+### 인증 상태 확인
+
+```bash
+opensoma auth status
+```
+
+### 로그아웃
+
+```bash
+opensoma auth logout
+```
+
+인증 정보는 `~/.config/opensoma/credentials.json`에 저장되며, 파일 권한은 `0600`으로 설정됩니다.
+
+## CLI 명령어
+
+모든 명령어에 `--pretty` 옵션을 추가하면 JSON 출력을 보기 좋게 포맷합니다.
+
+### 대시보드
+
+```bash
+opensoma dashboard show
+```
+
+### 멘토링
+
+```bash
+# 목록 조회
+opensoma mentoring list
+opensoma mentoring list --status open --type public --page 2
+
+# 검색
+opensoma mentoring list --search "OpenCode"
+opensoma mentoring list --search "author:@me"
+opensoma mentoring list --search "author:@me" --status open --type lecture
+
+# 상세 조회
+opensoma mentoring get <id>
+
+# 멘토링 생성
+opensoma mentoring create \
+  --title "멘토링 제목" \
+  --type public \
+  --date 2025-01-15 \
+  --start 14:00 \
+  --end 16:00 \
+  --venue "스페이스 A1"
+
+# 멘토링 삭제
+opensoma mentoring delete <id>
+
+# 멘토링 신청
+opensoma mentoring apply <id>
+
+# 신청 취소
+opensoma mentoring cancel --apply-sn <신청번호> --qustnr-sn <멘토링번호>
+
+# 신청 내역 조회
+opensoma mentoring history
+```
+
+### 회의실
+
+```bash
+# 회의실 목록
+opensoma room list
+opensoma room list --date 2025-01-15 --room A1
+
+# 예약 가능 시간 조회
+opensoma room available <roomId> --date 2025-01-15
+
+# 회의실 예약
+opensoma room reserve \
+  --room A1 \
+  --date 2025-01-15 \
+  --slots "14:00,14:30,15:00" \
+  --title "팀 회의"
+```
+
+### 공지사항
+
+```bash
+opensoma notice list
+opensoma notice get <id>
+```
+
+### 팀
+
+```bash
+opensoma team show
+```
+
+### 회원 정보
+
+```bash
+opensoma member show
+```
+
+### 행사
+
+```bash
+# 행사 목록
+opensoma event list
+
+# 행사 상세
+opensoma event get <id>
+
+# 행사 신청
+opensoma event apply <id>
+```
+
+## SDK
+
+TypeScript/JavaScript에서 프로그래밍 방식으로 사용할 수 있습니다.
+
+```typescript
+import { SomaClient } from 'opensoma'
+
+const client = new SomaClient({
+  username: process.env.OPENSOMA_USERNAME,
+  password: process.env.OPENSOMA_PASSWORD,
+})
+await client.login()
+
+// 대시보드
+const dashboard = await client.dashboard.get()
+
+// 멘토링 목록
+const { items, pagination } = await client.mentoring.list({ status: 'open' })
+
+// 멘토링 상세
+const detail = await client.mentoring.get(123)
+
+// 멘토링 생성
+await client.mentoring.create({
+  title: '멘토링 제목',
+  type: 'public',
+  date: '2025-01-15',
+  startTime: '14:00',
+  endTime: '16:00',
+  venue: '스페이스 A1',
+})
+
+// 회의실 목록
+const rooms = await client.room.list({ date: '2025-01-15' })
+
+// 회의실 예약
+await client.room.reserve({
+  roomId: 17,
+  date: '2025-01-15',
+  slots: ['14:00', '14:30'],
+  title: '팀 회의',
+})
+
+// 공지사항
+const notices = await client.notice.list()
+const notice = await client.notice.get(456)
+
+// 팀 정보
+const team = await client.team.show()
+
+// 회원 정보
+const member = await client.member.show()
+
+// 행사
+const events = await client.event.list()
+await client.event.apply(789)
+```
+
+세션 쿠키로 직접 인증할 수도 있습니다:
+
+```typescript
+const client = new SomaClient({
+  sessionCookie: '<세션쿠키>',
+  csrfToken: '<CSRF토큰>',
+})
+```
+
+## 회의실 코드
+
+| 코드 | 회의실 |
+|------|--------|
+| A1 | 스페이스 A1 |
+| A2 | 스페이스 A2 |
+| A3 | 스페이스 A3 |
+| A4 | 스페이스 A4 |
+| A5 | 스페이스 A5 |
+| A6 | 스페이스 A6 |
+| A7 | 스페이스 A7 |
+| A8 | 스페이스 A8 |
+
+## 개발
+
+```bash
+# 의존성 설치
+bun install
+
+# 테스트
+bun test
+
+# 타입 체크
+bun run typecheck
+
+# 린트
+bun run lint
+
+# 포맷
+bun run format
+```
+
+## 라이선스
+
+MIT