cdragon 0.1.0 → 0.2.0

package/README.md

@@ -91,6 +91,27 @@ cdragon --global --both tdd grill-me     # ~/.claude, ~/.agents 양쪽에 일부
 
 이미 존재하는 **실제 디렉터리**는 덮어쓰지 않고 건너뜁니다. 같은 대상을 가리키는 심링크는 그대로 두고, 다른 곳을 가리키면 다시 연결합니다.
 
+### 개발
+
+레포 루트에서 한 번 `npm link` 해두면, 이후 코드 수정은 재링크 없이 바로 반영됩니다.
+
+```bash
+npm link        # 최초 1회
+```
+
+### 배포
+
+스킬을 추가했거나 CLI를 수정했다면 버전을 올려 다시 배포합니다. **버전을 올리지 않으면 `npm publish`가 거부됩니다** (같은 버전 재배포 불가).
+
+```bash
+npm version patch          # 0.1.0 → 0.1.1 (버그픽스) — 커밋+태그 자동 생성
+# npm version minor        # 0.1.0 → 0.2.0 (기능 추가)
+git push --follow-tags     # 커밋과 태그를 함께 푸시
+npm publish --access public  # 게시 (보안키/OTP 인증)
+```
+
+`npm version`이 `package.json` 버전 변경·커밋·git 태그를 한 번에 처리합니다. 사용자는 `npm i -g cdragon@latest`로 갱신합니다.
+
 ## Getting Started
 
 ```bash

package/bin/cdragon.js

@@ -8,10 +8,20 @@ const pkg = require('../package.json')
 const c = require('../src/colors')
 const prompt = require('../src/prompt')
 const { SKILLS_DIR, discoverSkills } = require('../src/skills')
-const { linkSkills } = require('../src/link')
+const { linkSkills, isInstalledIn } = require('../src/link')
 
 const truncate = (s, n) => (s.length > n ? s.slice(0, n - 1) + '…' : s)
 
+// Split skills into ordered, non-empty groups by where they came from.
+function groupBySource(skills) {
+  return [
+    { key: 'mine', label: 'My skills' },
+    { key: 'installed', label: 'External' },
+  ]
+    .map((g) => ({ ...g, items: skills.filter((s) => s.source === g.key) }))
+    .filter((g) => g.items.length)
+}
+
 function parseArgs(args) {
   const opts = { scope: null, folders: [], all: false, skills: [], yes: false }
 
@@ -66,9 +76,12 @@ function listSkills() {
     return
   }
   const width = Math.max(...skills.map((s) => s.name.length))
-  console.log(`\n${c.bold(`Skills (${skills.length})`)}  ${c.dim(SKILLS_DIR)}\n`)
-  for (const s of skills) {
-    console.log(`  ${c.cyan(s.name.padEnd(width))}  ${c.dim(truncate(s.description, 80))}`)
+  console.log(`\n${c.bold(`Skills (${skills.length})`)}  ${c.dim(SKILLS_DIR)}`)
+  for (const group of groupBySource(skills)) {
+    console.log(`\n  ${c.bold(group.label)} ${c.dim(`(${group.items.length})`)}`)
+    for (const s of group.items) {
+      console.log(`    ${c.cyan(s.name.padEnd(width))}  ${c.dim(truncate(s.description, 74))}`)
+    }
   }
   console.log('')
 }
@@ -96,6 +109,8 @@ async function linkCommand(opts) {
   }
   if (!folders.length) throw new Error('No target folder selected.')
 
+  const base = scope === 'global' ? os.homedir() : process.cwd()
+
   // 3. Skills: all, named, or interactively picked.
   let chosen
   if (opts.all) {
@@ -107,16 +122,25 @@ async function linkCommand(opts) {
       return found
     })
   } else {
-    const picked = await prompt.multiselect(
-      'Which skills to link?',
-      skills.map((s) => ({ label: `${s.name}  ${c.dim(truncate(s.description, 56))}`, value: s.name }))
-    )
+    const choices = []
+    for (const group of groupBySource(skills)) {
+      choices.push({ header: true, label: `${group.label} (${group.items.length})` })
+      for (const s of group.items) {
+        // Pre-check skills already linked into the chosen target.
+        const installed = isInstalledIn(s, base, folders)
+        const tag = installed ? c.dim(' (linked)') : ''
+        choices.push({
+          value: s.name,
+          checked: installed,
+          label: `${s.name}  ${c.dim(truncate(s.description, 56))}${tag}`,
+        })
+      }
+    }
+    const picked = await prompt.multiselect('Which skills to link?', choices)
     chosen = picked.map((name) => skills.find((s) => s.name === name))
   }
   if (!chosen.length) throw new Error('No skills selected.')
 
-  const base = scope === 'global' ? os.homedir() : process.cwd()
-
   // Summary + confirm.
   console.log('')
   console.log(`  ${c.bold('scope')}    ${scope} ${c.dim(`(${base})`)}`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdragon",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Symlink this repo's agent skills into a project's or your global .claude/skills or .agents/skills",
   "bin": {
     "cdragon": "bin/cdragon.js"

package/skills/gws-sheets/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: gws-sheets
+description: "Google Sheets: Read and write spreadsheets."
+metadata:
+  version: 0.22.5
+  openclaw:
+    category: "productivity"
+    requires:
+      bins:
+        - gws
+    cliHelp: "gws sheets --help"
+---
+
+# sheets (v4)
+
+> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
+
+```bash
+gws sheets <resource> <method> [flags]
+```
+
+## Helper Commands
+
+| Command | Description |
+|---------|-------------|
+| [`+append`](../gws-sheets-append/SKILL.md) | Append a row to a spreadsheet |
+| [`+read`](../gws-sheets-read/SKILL.md) | Read values from a spreadsheet |
+
+## API Resources
+
+### spreadsheets
+
+  - `batchUpdate` — Applies one or more updates to the spreadsheet. Each request is validated before being applied. If any request is not valid then the entire request will fail and nothing will be applied. Some requests have replies to give you some information about how they are applied. The replies will mirror the requests. For example, if you applied 4 updates and the 3rd one had a reply, then the response will have 2 empty replies, the actual reply, and another empty reply, in that order.
+  - `create` — Creates a spreadsheet, returning the newly created spreadsheet.
+  - `get` — Returns the spreadsheet at the given ID. The caller must specify the spreadsheet ID. By default, data within grids is not returned. You can include grid data in one of 2 ways: * Specify a [field mask](https://developers.google.com/workspace/sheets/api/guides/field-masks) listing your desired fields using the `fields` URL parameter in HTTP * Set the includeGridData URL parameter to true.
+  - `getByDataFilter` — Returns the spreadsheet at the given ID. The caller must specify the spreadsheet ID. For more information, see [Read, write, and search metadata](https://developers.google.com/workspace/sheets/api/guides/metadata). This method differs from GetSpreadsheet in that it allows selecting which subsets of spreadsheet data to return by specifying a dataFilters parameter. Multiple DataFilters can be specified.
+  - `developerMetadata` — Operations on the 'developerMetadata' resource
+  - `sheets` — Operations on the 'sheets' resource
+  - `values` — Operations on the 'values' resource
+
+## Discovering Commands
+
+Before calling any API method, inspect it:
+
+```bash
+# Browse resources and methods
+gws sheets --help
+
+# Inspect a method's required params, types, and defaults
+gws schema sheets.<resource>.<method>
+```
+
+Use `gws schema` output to build your `--params` and `--json` flags.
+

package/skills/gws-sheets-append/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: gws-sheets-append
+description: "Google Sheets: Append a row to a spreadsheet."
+metadata:
+  version: 0.22.5
+  openclaw:
+    category: "productivity"
+    requires:
+      bins:
+        - gws
+    cliHelp: "gws sheets +append --help"
+---
+
+# sheets +append
+
+> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
+
+Append a row to a spreadsheet
+
+## Usage
+
+```bash
+gws sheets +append --spreadsheet <ID>
+```
+
+## Flags
+
+| Flag | Required | Default | Description |
+|------|----------|---------|-------------|
+| `--spreadsheet` | ✓ | — | Spreadsheet ID |
+| `--values` | — | — | Comma-separated values (simple strings) |
+| `--json-values` | — | — | JSON array of rows, e.g. '[["a","b"],["c","d"]]' |
+| `--range` | — | `A1` | Target range in A1 notation (e.g. 'Sheet2!A1') to select a specific tab |
+
+## Examples
+
+```bash
+gws sheets +append --spreadsheet ID --values 'Alice,100,true'
+gws sheets +append --spreadsheet ID --json-values '[["a","b"],["c","d"]]'
+gws sheets +append --spreadsheet ID --range "Sheet2!A1" --values 'Alice,100'
+```
+
+## Tips
+
+- Use --values for simple single-row appends.
+- Use --json-values for bulk multi-row inserts.
+- Use --range to append to a specific sheet tab (default: A1, i.e. first sheet).
+
+> [!CAUTION]
+> This is a **write** command — confirm with the user before executing.
+
+## See Also
+
+- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
+- [gws-sheets](../gws-sheets/SKILL.md) — All read and write spreadsheets commands

package/skills/gws-sheets-read/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: gws-sheets-read
+description: "Google Sheets: Read values from a spreadsheet."
+metadata:
+  version: 0.22.5
+  openclaw:
+    category: "productivity"
+    requires:
+      bins:
+        - gws
+    cliHelp: "gws sheets +read --help"
+---
+
+# sheets +read
+
+> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
+
+Read values from a spreadsheet
+
+## Usage
+
+```bash
+gws sheets +read --spreadsheet <ID> --range <RANGE>
+```
+
+## Flags
+
+| Flag | Required | Default | Description |
+|------|----------|---------|-------------|
+| `--spreadsheet` | ✓ | — | Spreadsheet ID |
+| `--range` | ✓ | — | Range to read (e.g. 'Sheet1!A1:B2') |
+
+## Examples
+
+```bash
+gws sheets +read --spreadsheet ID --range "Sheet1!A1:D10"
+gws sheets +read --spreadsheet ID --range Sheet1
+```
+
+## Tips
+
+- Read-only — never modifies the spreadsheet.
+- For advanced options, use the raw values.get API.
+
+## See Also
+
+- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
+- [gws-sheets](../gws-sheets/SKILL.md) — All read and write spreadsheets commands

package/src/link.js

@@ -29,6 +29,23 @@ function linkSkill(sourceDir, linkPath) {
   return 'exists'
 }
 
+// Is `sourceDir` already symlinked at linkPath? (true only for a symlink that
+// resolves to exactly this source — not a real dir, not a stale link.)
+function isLinked(sourceDir, linkPath) {
+  try {
+    if (!fs.lstatSync(linkPath).isSymbolicLink()) return false
+    return path.resolve(path.dirname(linkPath), fs.readlinkSync(linkPath)) === sourceDir
+  } catch {
+    return false
+  }
+}
+
+// Is the skill already linked into <base>/<folder>/skills for every folder?
+function isInstalledIn(skill, base, folders) {
+  const name = path.basename(skill.dir)
+  return folders.every((folder) => isLinked(skill.dir, path.join(base, folder, 'skills', name)))
+}
+
 // Link a set of skills into <base>/<folder>/skills, creating the dir if needed.
 function linkSkills(skills, base, folder) {
   const root = path.join(base, folder, 'skills')
@@ -44,4 +61,4 @@ function linkSkills(skills, base, folder) {
   })
 }
 
-module.exports = { linkSkill, linkSkills }
+module.exports = { linkSkill, linkSkills, isInstalledIn }

package/src/prompt.js

@@ -68,23 +68,33 @@ function select(message, choices) {
 }
 
 // Multi-choice checkbox list. Resolves an array of selected `value`s.
+// A choice with `{ header: true }` renders as a non-selectable group label
+// and is skipped during navigation.
 function multiselect(message, choices) {
   requireTTY()
   return new Promise((resolve) => {
-    let index = 0
-    const selected = new Set()
+    const selectable = choices.map((c, i) => (c.header ? -1 : i)).filter((i) => i >= 0)
+    // Pre-check any choice flagged `checked` (e.g. already installed).
+    const selected = new Set(selectable.filter((i) => choices[i].checked))
     const totalLines = choices.length + 1
+    let pos = 0 // index into `selectable`
     let drawn = false
 
+    const cursor = () => selectable[pos]
+
     const draw = () => {
       let out = drawn ? `\x1b[${totalLines}A` : ''
       const hint = c.dim('(↑↓ move · space toggle · a all · enter confirm)')
       out += `\x1b[2K${c.cyan('?')} ${c.bold(message)} ${hint}\n`
       choices.forEach((choice, i) => {
-        const active = i === index
+        if (choice.header) {
+          out += `\x1b[2K  ${c.bold(choice.label)}\n`
+          return
+        }
+        const active = i === cursor()
         const box = selected.has(i) ? c.green('◉') : '◯'
         const pointer = active ? c.cyan('❯') : ' '
-        out += `\x1b[2K${pointer} ${box} ${active ? c.cyan(choice.label) : choice.label}\n`
+        out += `\x1b[2K  ${pointer} ${box} ${active ? c.cyan(choice.label) : choice.label}\n`
       })
       process.stdout.write(out)
       drawn = true
@@ -93,17 +103,18 @@ function multiselect(message, choices) {
     const onKey = (str, key) => {
       if (!key) return
       if (key.name === 'up' || key.name === 'k') {
-        index = (index - 1 + choices.length) % choices.length
+        pos = (pos - 1 + selectable.length) % selectable.length
         draw()
       } else if (key.name === 'down' || key.name === 'j') {
-        index = (index + 1) % choices.length
+        pos = (pos + 1) % selectable.length
         draw()
       } else if (key.name === 'space' || str === ' ') {
-        selected.has(index) ? selected.delete(index) : selected.add(index)
+        const i = cursor()
+        selected.has(i) ? selected.delete(i) : selected.add(i)
         draw()
       } else if (key.name === 'a') {
-        if (selected.size === choices.length) selected.clear()
-        else choices.forEach((_, i) => selected.add(i))
+        if (selected.size === selectable.length) selected.clear()
+        else selectable.forEach((i) => selected.add(i))
         draw()
       } else if (key.name === 'return') {
         teardown(onKey)

package/src/skills.js

@@ -7,6 +7,19 @@ const path = require('node:path')
 // location so `cdragon` finds them no matter where it's invoked.
 const SKILLS_DIR = path.resolve(__dirname, '..', 'skills')
 
+// skills-lock.json (managed by the `skills` CLI) is the manifest of skills
+// pulled from external sources. Anything not listed there is authored locally.
+const LOCK_PATH = path.resolve(SKILLS_DIR, '..', 'skills-lock.json')
+
+function installedSkillNames() {
+  try {
+    const lock = JSON.parse(fs.readFileSync(LOCK_PATH, 'utf8'))
+    return new Set(Object.keys(lock.skills || {}))
+  } catch {
+    return new Set()
+  }
+}
+
 // Parse the YAML frontmatter of a SKILL.md into a flat key/value map.
 // Handles plain `key: value` and block scalars (`>`, `|`) used for long
 // descriptions, collapsing them into a single line.
@@ -55,6 +68,7 @@ function discoverSkills(dir) {
     return []
   }
 
+  const installed = installedSkillNames()
   const skills = []
   for (const entry of entries) {
     if (!entry.isDirectory()) continue
@@ -66,6 +80,7 @@ function discoverSkills(dir) {
       name: entry.name,
       dir: path.join(dir, entry.name),
       description: fm.description || '',
+      source: installed.has(entry.name) ? 'installed' : 'mine',
     })
   }