huddle60 0.0.0-stage → 0.1.1

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "huddle60",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "huddle60: a 60-second huddle between PO, DEV and AI on GitHub. Gemini planning, hash-locked requirements and PR gates (AI-DLC).",
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "bin": {
+    "huddle60": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "ui"
+  ],
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "check": "npm run typecheck && npm test && npm run format:check",
+    "huddle60": "node dist/cli.js"
+  },
+  "dependencies": {
+    "@google/genai": "^2.32.0",
+    "@octokit/auth-app": "^8.3.1",
+    "@octokit/plugin-retry": "^8.1.1",
+    "@octokit/rest": "^22.0.1",
+    "yaml": "^2.9.1",
+    "zod": "^4.6.7"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.5",
+    "esbuild": "^0.28.2",
+    "prettier": "^3.9.10",
+    "typescript": "^5.9.3",
+    "vitest": "^5.0.5"
+  },
+  "optionalDependencies": {
+    "@rolldown/binding-darwin-arm64": "^1.2.16"
+  }
 }

package/templates/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

package/templates/.github/ISSUE_TEMPLATE/epic.yml

@@ -0,0 +1,35 @@
+name: Epic
+description: Chức năng lớn gồm nhiều Story.
+title: "[Epic] "
+labels: ["type:epic"]
+body:
+  - type: textarea
+    id: goal
+    attributes:
+      label: Mục tiêu và người dùng
+    validations:
+      required: true
+  - type: textarea
+    id: scope
+    attributes:
+      label: Phạm vi
+      value: |
+        - Trong phạm vi:
+        - Ngoài phạm vi:
+    validations:
+      required: true
+  - type: textarea
+    id: criteria
+    attributes:
+      label: Tiêu chí nghiệm thu Epic
+      description: "Mỗi dòng một tiêu chí: - EC-01: ..."
+    validations:
+      required: true
+  - type: textarea
+    id: technical_refs
+    attributes:
+      label: Tham chiếu kỹ thuật
+  - type: textarea
+    id: risks
+    attributes:
+      label: Câu hỏi và rủi ro

package/templates/.github/ISSUE_TEMPLATE/request.yml

@@ -0,0 +1,18 @@
+name: huddle60 Request
+description: Mô tả nhu cầu bằng một câu; AI đề xuất Epic/Story/Task để PO xác nhận.
+title: "[Request] "
+labels: ["huddle60:request"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Chỉ PO được cấu hình trong `.github/huddle60/policy.yml` mới kích hoạt AI planner.
+        AI chỉ đề xuất; chưa có Issue nào được tạo cho đến khi PO xác nhận.
+  - type: textarea
+    id: request
+    attributes:
+      label: Yêu cầu
+      description: Mô tả kết quả mong muốn bằng ngôn ngữ tự nhiên.
+      placeholder: Xây dựng tính năng đăng nhập Google OAuth
+    validations:
+      required: true

package/templates/.github/ISSUE_TEMPLATE/story.yml

@@ -0,0 +1,45 @@
+name: Story
+description: Một phần giá trị sử dụng có thể nghiệm thu.
+title: "[Story] "
+labels: ["type:story"]
+body:
+  - type: textarea
+    id: goal
+    attributes:
+      label: Mục tiêu và người dùng
+    validations:
+      required: true
+  - type: textarea
+    id: scope
+    attributes:
+      label: Phạm vi
+      value: |
+        - Trong phạm vi:
+        - Ngoài phạm vi:
+    validations:
+      required: true
+  - type: input
+    id: parent
+    attributes:
+      label: Issue cha
+      description: "Epic chứa Story này, ví dụ #10"
+  - type: input
+    id: blocked_by
+    attributes:
+      label: Blocked by
+      description: "Ví dụ #12, #13"
+  - type: textarea
+    id: acceptance_criteria
+    attributes:
+      label: Acceptance Criteria
+      description: "Mỗi dòng một AC: - AC-01: Given ... When ... Then ..."
+    validations:
+      required: true
+  - type: textarea
+    id: technical_refs
+    attributes:
+      label: Tham chiếu kỹ thuật
+  - type: textarea
+    id: risks
+    attributes:
+      label: Câu hỏi và rủi ro

package/templates/.github/ISSUE_TEMPLATE/task.yml

@@ -0,0 +1,43 @@
+name: Task
+description: Bước kỹ thuật thuộc một Story.
+title: "[Task] "
+labels: ["type:task"]
+body:
+  - type: textarea
+    id: goal
+    attributes:
+      label: Mục tiêu và người dùng
+      description: Đầu ra kỹ thuật của task.
+    validations:
+      required: true
+  - type: textarea
+    id: scope
+    attributes:
+      label: Phạm vi
+      description: File/module được phép thay đổi.
+    validations:
+      required: true
+  - type: input
+    id: parent
+    attributes:
+      label: Issue cha
+      description: "Story chứa task, ví dụ #11"
+    validations:
+      required: true
+  - type: input
+    id: blocked_by
+    attributes:
+      label: Blocked by
+  - type: input
+    id: ac_refs
+    attributes:
+      label: AC liên quan
+      description: "Ví dụ AC-01, AC-02"
+  - type: textarea
+    id: technical_refs
+    attributes:
+      label: Tham chiếu kỹ thuật
+  - type: textarea
+    id: risks
+    attributes:
+      label: Câu hỏi và rủi ro

package/templates/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,12 @@
+Refs #
+
+<!-- Dán khối từ reply của `/huddle60 ready` hoặc `npx huddle60 context --issue <n>`. -->
+<!-- Dùng "Refs #n", không dùng Closes/Fixes/Resolves cho Story/Epic. -->
+
+## Đã thay đổi / AC liên quan
+
+## Đã kiểm tra (lệnh, kết quả)
+
+## Chưa kiểm tra / giới hạn / giả định
+
+## Cần ai quyết định gì

package/templates/.github/huddle60/policy.yml

@@ -0,0 +1,38 @@
+# huddle60 policy (AI-DLC protocol). Changes must be reviewed by CODEOWNERS.
+# Roles use numeric GitHub user ids (https://api.github.com/users/<login>), which never change.
+# Accounts used only as AI tools must not hold a role.
+version: 1
+roles:
+  po:
+    - id: 1000001
+      login: replace-with-po-login
+  dev:
+    - id: 1000002
+      login: replace-with-dev-1
+    - id: 1000003
+      login: replace-with-dev-2
+  maintainer: []
+# Organization or user Project (v2) that receives Issues created by the planner. Remove to skip.
+project:
+  owner: your-org
+  number: 1
+lanes:
+  fast:
+    requires_po_approval: false
+  standard:
+    requires_po_approval: true
+  strict:
+    requires_po_approval: true
+# Pull requests in the fast lane may not touch these paths.
+sensitive_paths:
+  - ".github/**"
+  - "migrations/**"
+  - "src/auth/**"
+evidence:
+  branch: huddle60-evidence
+acceptance:
+  build_workflows:
+    - .github/workflows/build.yml
+planner:
+  max_nodes: 60
+  plan_ttl_days: 30

package/templates/.github/workflows/huddle60.yml

@@ -0,0 +1,26 @@
+# Deterministic huddle60 gates (AI-DLC protocol). Planning (Gemini) runs in `huddle60 ui` on the PO's machine
+# (or the optional planner service), never here.
+name: huddle60
+on:
+  issue_comment:
+    types: [created, edited, deleted]
+  pull_request_target:
+    types: [opened, edited, synchronize, reopened, ready_for_review]
+permissions: {}
+jobs:
+  huddle60:
+    # Never check out or run pull request code in this job: it holds a write token.
+    if: github.event_name == 'pull_request_target' || (github.event.issue.pull_request == null && github.event.sender.type != 'Bot' && (startsWith(github.event.comment.body, '/huddle60') || startsWith(github.event.comment.body, '/ai-dlc') || github.event.action != 'created'))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - id: app-token
+        uses: actions/create-github-app-token@v1
+        with:
+          app-id: ${{ vars.AI_DLC_APP_ID }}
+          private-key: ${{ secrets.AI_DLC_APP_PRIVATE_KEY }}
+      - uses: tadev999/huddle60@main
+        with:
+          token: ${{ steps.app-token.outputs.token }}
+          enabled: ${{ vars.AI_DLC_ENABLED || 'true' }}

package/templates/AGENTS.md

@@ -0,0 +1,12 @@
+# Hướng dẫn cho AI agent
+
+1. Trước khi code, lấy baseline đã chốt:
+   `npx huddle60 context --issue <số>` (hoặc DEV dán nội dung từ nút **context** trong `huddle60 ui`).
+   Chỉ làm theo nội dung trong đầu ra. Nếu lệnh báo chưa ready hoặc có cảnh báo WARNING, dừng lại và hỏi DEV.
+2. Chỉ sửa file trong phạm vi Task. Không sửa `.github/`, `AGENTS.md` hoặc policy trừ khi Task yêu cầu rõ.
+3. Gắn mã AC vào tên test, ví dụ `[AC-01] từ chối mật khẩu sai`.
+4. Mô tả PR phải chứa khối `<!-- huddle60:begin -->` do lệnh trên sinh ra. Dùng `Refs #<số>`,
+   không dùng `Closes`, `Fixes`, `Resolves`.
+5. Ghi rõ phần chưa kiểm tra và giả định. Không viết rằng CI đã pass khi chưa có kết quả CI.
+6. Không chạy `/huddle60 approve`, `ready`, `accept`, `create-plan` và không bấm các nút tương ứng trong `huddle60 ui`;
+   đó là quyết định của con người.