govon 0.1.0

package/README.md

@@ -0,0 +1,45 @@
+# govon (npm)
+
+npm wrapper for the [GovOn](https://github.com/umyunsang/GovOn) CLI.
+
+GovOn은 행정 지원 및 민원 처리 워크플로우를 위한 셸 퍼스트 로컬 에이전트 런타임입니다.
+
+## 요구 사항
+
+- **Node.js** 18 이상
+- **Python** 3.10 이상
+- **pip** (Python 패키지 관리자)
+
+## 설치
+
+```bash
+npm install -g govon
+```
+
+설치 후 Python 환경이 자동으로 확인됩니다.  
+`govon` Python 패키지가 설치되어 있지 않다면 아래 명령어로 설치하세요.
+
+```bash
+pip install govon
+```
+
+## 사용법
+
+```bash
+govon --help
+```
+
+## 동작 방식
+
+이 패키지는 Python CLI(`govon`)를 감싸는 thin wrapper입니다.
+
+1. `govon` 명령어 실행 시 Python 3.10+ 설치 여부를 확인합니다.
+2. `govon` CLI(`pip install govon`)가 설치되어 있는지 확인합니다.
+3. 조건이 충족되면 `child_process.spawn`을 통해 Python CLI에 실행을 위임합니다.
+4. 미충족 시 명확한 설치 안내 메시지를 출력하고 종료합니다.
+
+> Python 자동 설치는 보안 및 권한 이슈로 지원하지 않습니다.
+
+## 라이선스
+
+MIT

package/bin/govon.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+'use strict';
+
+const { spawn } = require('child_process');
+const { printEnvironmentStatus, isGovonInstalled } = require('../lib/python-check');
+
+const args = process.argv.slice(2);
+
+// postinstall 또는 직접 호출 시 환경 점검만 수행하고 종료
+if (args[0] === '--check-install') {
+  const ok = printEnvironmentStatus();
+  process.exit(ok ? 0 : 1);
+}
+
+// 실제 CLI 실행 경로: 환경이 올바르지 않으면 안내 메시지를 출력하고 종료
+if (!printEnvironmentStatus()) {
+  process.exit(1);
+}
+
+// govon CLI를 실제로 실행
+const child = spawn('govon', args, {
+  stdio: 'inherit',
+  shell: false,
+});
+
+child.on('error', (err) => {
+  if (err.code === 'ENOENT') {
+    console.error(
+      [
+        '',
+        '  [govon] govon 명령어를 실행할 수 없습니다.',
+        '  pip install govon 으로 설치되었는지 확인하세요.',
+        '',
+      ].join('\n')
+    );
+  } else {
+    console.error(`[govon] 실행 오류: ${err.message}`);
+  }
+  process.exit(1);
+});
+
+child.on('close', (code) => {
+  process.exit(code ?? 0);
+});

package/lib/python-check.js

@@ -0,0 +1,156 @@
+'use strict';
+
+const { execSync, spawnSync } = require('child_process');
+
+const MIN_PYTHON_MAJOR = 3;
+const MIN_PYTHON_MINOR = 10;
+
+/**
+ * Python 실행 파일 후보 목록 (우선순위 순)
+ */
+const PYTHON_CANDIDATES = ['python3', 'python'];
+
+/**
+ * 주어진 python 실행 파일의 버전을 반환합니다.
+ * 실행 불가능하거나 파싱 실패 시 null을 반환합니다.
+ * @param {string} cmd - 실행할 python 명령어
+ * @returns {{ major: number, minor: number } | null}
+ */
+function getPythonVersion(cmd) {
+  try {
+    const result = spawnSync(cmd, ['--version'], { encoding: 'utf8', timeout: 5000 });
+    if (result.status !== 0 || result.error) return null;
+
+    // "Python 3.11.4" 또는 stderr에 출력될 수 있음 (Python 2)
+    const output = (result.stdout || result.stderr || '').trim();
+    const match = output.match(/Python\s+(\d+)\.(\d+)/i);
+    if (!match) return null;
+
+    return { major: parseInt(match[1], 10), minor: parseInt(match[2], 10) };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 시스템에서 사용 가능한 Python 3.10+ 실행 파일을 찾습니다.
+ * @returns {{ cmd: string, major: number, minor: number } | null}
+ */
+function findPython() {
+  for (const candidate of PYTHON_CANDIDATES) {
+    const version = getPythonVersion(candidate);
+    if (
+      version &&
+      (version.major > MIN_PYTHON_MAJOR ||
+        (version.major === MIN_PYTHON_MAJOR && version.minor >= MIN_PYTHON_MINOR))
+    ) {
+      return { cmd: candidate, ...version };
+    }
+  }
+  return null;
+}
+
+/**
+ * `govon` CLI가 PATH에 설치되어 있는지 확인합니다.
+ * npm의 govon.js wrapper가 아닌 Python의 govon binary를 찾습니다.
+ * @returns {boolean}
+ */
+function isGovonInstalled() {
+  try {
+    // which/where로 govon 경로를 확인하여 Python binary인지 검증
+    const whichCmd = process.platform === 'win32' ? 'where' : 'which';
+    const which = spawnSync(whichCmd, ['govon'], { encoding: 'utf8', timeout: 5000 });
+    if (which.error || which.status !== 0) return false;
+
+    const govonPath = (which.stdout || '').trim().split('\n')[0];
+    // npm bin 경로(node_modules/.bin)에 있으면 npm wrapper이므로 무시
+    if (govonPath.includes('node_modules')) return false;
+
+    // Python module로 직접 확인
+    const python = findPython();
+    if (!python) return false;
+
+    const result = spawnSync(python.cmd, ['-m', 'govon', '--version'], {
+      encoding: 'utf8',
+      timeout: 5000,
+    });
+    return !result.error && result.status === 0;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Python 환경 전체를 검사하고 결과를 반환합니다.
+ * @returns {{
+ *   pythonFound: boolean,
+ *   pythonCmd: string | null,
+ *   pythonVersion: string | null,
+ *   govonInstalled: boolean
+ * }}
+ */
+function checkEnvironment() {
+  const python = findPython();
+  const govonInstalled = python ? isGovonInstalled() : false;
+
+  return {
+    pythonFound: python !== null,
+    pythonCmd: python ? python.cmd : null,
+    pythonVersion: python ? `${python.major}.${python.minor}` : null,
+    govonInstalled,
+  };
+}
+
+/**
+ * 환경 검사 결과를 stdout에 출력하고 문제가 있으면 안내 메시지를 표시합니다.
+ * @returns {boolean} - 모든 조건이 충족되면 true
+ */
+function printEnvironmentStatus() {
+  const { pythonFound, pythonCmd, pythonVersion, govonInstalled } = checkEnvironment();
+
+  if (!pythonFound) {
+    console.error(
+      [
+        '',
+        '  [govon] Python 3.10 이상이 필요합니다.',
+        '',
+        '  Python을 설치한 뒤 다시 시도해 주세요:',
+        '    https://www.python.org/downloads/',
+        '',
+        '  또는 패키지 관리자를 이용하세요:',
+        '    macOS:   brew install python@3.12',
+        '    Ubuntu:  sudo apt install python3.12',
+        '    Windows: winget install Python.Python.3.12',
+        '',
+      ].join('\n')
+    );
+    return false;
+  }
+
+  if (!govonInstalled) {
+    console.error(
+      [
+        '',
+        `  [govon] govon CLI가 설치되어 있지 않습니다. (Python ${pythonVersion} 감지됨)`,
+        '',
+        '  아래 명령어로 설치해 주세요:',
+        `    ${pythonCmd} -m pip install govon`,
+        '',
+        '  가상환경을 사용하는 경우:',
+        '    python -m venv .venv && source .venv/bin/activate',
+        `    pip install govon`,
+        '',
+      ].join('\n')
+    );
+    return false;
+  }
+
+  return true;
+}
+
+module.exports = {
+  findPython,
+  isGovonInstalled,
+  checkEnvironment,
+  printEnvironmentStatus,
+};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "govon",
+  "version": "0.1.0",
+  "description": "npm wrapper for the GovOn CLI — Shell-first local agentic runtime for administrative assistance and civil complaint workflows",
+  "keywords": [
+    "govon",
+    "agentic-shell",
+    "local-runtime",
+    "civil-complaint",
+    "korean-nlp",
+    "cli"
+  ],
+  "homepage": "https://github.com/GovOn-Org/GovOn#readme",
+  "bugs": {
+    "url": "https://github.com/GovOn-Org/GovOn/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GovOn-Org/GovOn.git",
+    "directory": "packages/npm"
+  },
+  "license": "MIT",
+  "bin": {
+    "govon": "./bin/govon.js"
+  },
+  "scripts": {
+    "postinstall": "node ./bin/govon.js --check-install || true"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "README.md"
+  ]
+}