@teammy/cli 0.0.0-stage → 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Teammy contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,48 @@
-# Temporary Holding Version
+# Teammy
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+团队 AI 协作共享和内容分发中枢。
+
+**当前版本是用于建立 npm 包和 CLI 入口的最小骨架，只提供帮助与版本查询。以下产品能力尚未实现。**
+
+## 安装
+
+需要 Node.js 22 或更新版本。
+
+```sh
+npm install -g @teammy/cli
+teammy --help
+teammy --version
+```
+
+也可以直接运行：
+
+```sh
+npx @teammy/cli --help
+```
+
+## 产品方向
+
+在 Git 项目目录注册并绑定项目，为团队提供：
+
+- **文件同步**：按项目约定同步 `spec/`、`plan/`、`review/` 等自定义目录，让进展及时共享。
+- **Session 共享**：通过项目级 hook 自动收集协作会话，支持检索、互相查阅和接力。
+- **AI 进展摘要**：由中枢连接的 LLM 为会话打标、汇总进度。
+- **简要看板**：集中展示文件同步信息、AI 工作摘要和团队进展。
+
+同步独立于 Git 提交和推送。交互以自动化为主，减少用户操作、上下文注入和对 skill 的依赖。后续接入以项目绑定时约定的共享范围为边界。
+
+## 本地开发
+
+当前使用原生 JavaScript ESM，无运行时依赖，无需构建。
+
+```sh
+npm install
+npm run check
+node bin/teammy.js --help
+```
+
+需要本地全局命令时运行 `npm link`。发布前使用 `npm pack` 生成 `.tgz`，完成包内容、安装和命令验收后，通过 `npm publish ./包名-版本号.tgz --access public --auth-type=web --registry=https://registry.npmjs.org` 发布同一份产物。
+
+## License
+
+MIT

package/bin/teammy.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+
+import { readFileSync } from 'node:fs';
+
+const { version } = JSON.parse(
+  readFileSync(new URL('../package.json', import.meta.url), 'utf8'),
+);
+
+const help = `teammy — a shared hub for team AI collaboration
+
+Usage:
+  teammy              Show this help
+  teammy --help       Show this help
+  teammy --version    Show the installed version
+
+This is an early scaffold. Project binding, file sync, session sharing,
+and the dashboard are planned and are not available yet.
+`;
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+if (args.length === 0 || (args.length === 1 && ['--help', '-h', 'help'].includes(command))) {
+  process.stdout.write(help);
+} else if (args.length === 1 && ['--version', '-v', 'version'].includes(command)) {
+  process.stdout.write(`${version}\n`);
+} else {
+  process.stderr.write('Unknown command or arguments. Run "teammy --help" for usage.\n');
+  process.exitCode = 1;
+}

package/package.json

@@ -1,6 +1,30 @@
 {
   "name": "@teammy/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "description": "A shared hub for team AI collaboration, project context, and session handoffs.",
+  "type": "module",
+  "bin": {
+    "teammy": "bin/teammy.js"
+  },
+  "files": [
+    "bin/"
+  ],
+  "scripts": {
+    "check": "node --check bin/teammy.js"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "keywords": [
+    "ai",
+    "team",
+    "collaboration",
+    "sessions",
+    "cli"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}