@manhd_d/ai-harness 0.8.0 → 0.10.0

package/docs/i18n/README.vi.md

@@ -0,0 +1,53 @@
+# AI Harness
+
+[English](../../README.md) · **Tiếng Việt**
+
+**Bộ hướng dẫn cho AI phát triển project theo workflow: Requirements → Code → Test → Review.**
+
+Cài bộ hướng dẫn vào project, rồi giao việc cho công cụ AI bạn đang dùng.
+
+## Hỗ trợ workflow nào?
+
+| Workflow | Outputs |
+| --- | --- |
+| **BA / PO — Business analysis & product** | Từ ý tưởng hoặc docs có sẵn đến BRD, PRD, SRS, user stories và acceptance criteria. |
+| **SA — Solution architecture** | Architecture, non-functional requirements, technical decisions và change-impact analysis. |
+| **PM — Delivery planning** | Delivery phases, dependencies, risks và scope changes. |
+| **Dev / QA — Implementation & testing** | Feature implementation, debugging, tests và code review theo project conventions. |
+| **UI/UX & DevOps** | UI design, CI/CD, deployment và operations guidance khi cần. |
+
+Hỗ trợ Spring Boot, React/Next.js, React Native/Expo, Python AI/RAG, Astro và Kubernetes.
+Chỉ chọn phần cần dùng; task nhỏ không cần đủ bộ docs hay spec. [Chọn stack & module](../../docs/getting-started.md).
+
+## Chạy ở đâu?
+
+| Công cụ AI | Cách sử dụng | Hướng dẫn |
+| --- | --- | --- |
+| **Codex** | CLI hoặc extension trong IDE | [Cài đặt & thiết lập](../../docs/tool-setup/codex.md) |
+| **Claude Code** | Chạy `claude` trong terminal của project | [Cài đặt & thiết lập](../../docs/tool-setup/claude-code.md) |
+| **Cursor** | Mở project, giao việc trong Agent | [Cài đặt & thiết lập](../../docs/tool-setup/cursor.md) |
+| **GitHub Copilot** | Agent trong IDE hoặc Copilot CLI | [Cài đặt & thiết lập](../../docs/tool-setup/copilot.md) |
+| **Gemini CLI** | Chạy `gemini` trong terminal của project | [Cài đặt & thiết lập](../../docs/tool-setup/gemini-cli.md) |
+
+Harness cài hướng dẫn; công cụ AI thực hiện công việc. Cách nạp hướng dẫn tùy công cụ, theo link trên.
+
+## Quick start
+
+Cần **Node.js 22+** và một công cụ AI ở bảng trên. Chạy trong thư mục project:
+
+```bash
+npx --yes @manhd_d/ai-harness init --detect
+```
+
+Mở công cụ AI tại cùng project, rồi gửi:
+
+> Đọc AGENTS.md, khảo sát project và ghi context cần thiết vào .harness/local.md.
+> Thực hiện yêu cầu: [mô tả công việc]. Chạy test phù hợp và báo cáo kết quả.
+
+Bạn giao việc bình thường, không cần gọi từng agent, skill hay mở chat riêng cho từng vai.
+Nếu `--detect` chưa nhận diện được stack, [chọn module thủ công](../../docs/getting-started.md).
+`aih check` chỉ kiểm tra file Harness; tính năng đúng hay chưa cần test của project và review.
+
+[Getting started](../../docs/getting-started.md) · [Docs & examples](../../docs/README.md) · [Input/output & integrations](../../docs/artifact-contract.md) · [Model/agent configuration](../../docs/agent-configuration.md)
+
+Đóng góp: [Contributing](../../CONTRIBUTING.md) · [Bảo trì Harness](../../docs/harness-maintenance.md) · [MIT](../../LICENSE).

package/docs/project-configuration.md

@@ -4,6 +4,8 @@
 | --- | --- | --- |
 | `.harness/project.json` | Adapter/capability | Commit |
 | `.harness/agents.json` | Provider/model/reasoning theo role, execution preferences và host mappings | Commit |
+| `.harness/artifacts.json` | Input/output/storage, canonical ownership và source-write policy | Commit |
+| `.harness/integrations.json` | Dynamic host connection aliases và scope; không chứa credentials | Commit |
 | `.harness/local.md` | Nghiệp vụ, kiến trúc, nguồn và quyết định chung | Commit |
 | `.harness/environment.json` | Công cụ, lệnh, file cần có | Commit |
 | `.harness/machine.json` | Đường dẫn riêng của máy, tùy chọn | Ignore |
@@ -84,3 +86,8 @@ tự chạy lệnh, đổi JAVA_HOME, sửa settings.xml hay tải dependency.
 Chạy `aih setup` rồi nhờ AI đọc workflow `project-setup`. Host đọc repo và câu trả lời cũ trước khi
 hỏi 1–3 câu A/B/C có đề xuất dựa trên bằng chứng. Các gợi ý JSON của CLI có thể được bỏ qua nếu
 local.md đã trả lời. Setup không phải wizard nhập liệu và không tự ghi lựa chọn.
+
+## Input/output và integrations
+Xem [Artifact contract](artifact-contract.md). `aih artifacts` báo khai báo; `aih setup` gợi ý hỏi
+nơi lưu docs/UI nếu chưa biết. Các file này project-owned và được bảo toàn khi update; chúng không
+kết nối MCP, cấp quyền hay chạy tool. Credentials và native host config nằm ngoài Git.

package/docs/skill-matrix.md

@@ -1,6 +1,6 @@
-# Skill matrix — 64 skills, 13 nhóm module
+# Skill matrix — 68 skills, 13 nhóm module
 
-Đây là bảng tra cứu **ID thật** theo `SKILL.md` trong source trên `main` (5 Core, 41 capability, 18 adapter). Dùng khi cần chuyển từ [Full SDLC](end-to-end-workflow.md) tới một skill cụ thể, không nạp toàn bộ 64 skill vào prompt.
+Đây là bảng tra cứu **ID thật** theo `SKILL.md` trong source trên `main` (5 Core, 41 capability, 22 adapter). Dùng khi cần chuyển từ [Full SDLC](end-to-end-workflow.md) tới một skill cụ thể, không nạp toàn bộ 68 skill vào prompt.
 
 **Cách dùng:** `aih skills` xem skills đã cài, sau đó `aih skill harness-...` lấy nội dung. Danh mục này mô tả chức năng; **không** có nghĩa `aih` thực thi skills hoặc agent. Tech adapters và capabilities chỉ xuất hiện trong consumer khi được chọn; Core dùng chung.
 
@@ -84,17 +84,21 @@
 | [`harness-java-spring-kafka-outbox`](../adapters/java-spring/skills/harness-java-spring-kafka-outbox/SKILL.md) | Async events | Outbox transaction và consumer dedupe | Event implementation + failure tests |
 | [`harness-java-spring-spring-api`](../adapters/java-spring/skills/harness-java-spring-spring-api/SKILL.md) | Backend API | Authorization resource scoped, API contract | Endpoint + auth/contract tests |
 
-## React / Next.js adapter (2)
+## React / Next.js adapter (4)
 
 | Skill ID (nguồn) | Khi nào dùng | Mục đích | Output mong đợi |
 | --- | --- | --- | --- |
+| [`harness-react-nextjs-feature-delivery`](../adapters/react-nextjs/skills/harness-react-nextjs-feature-delivery/SKILL.md) | Feature implementation | Reuse route/screen, UI/form and API/state boundaries | AC-linked diff/checks, actual results and explicit limits |
+| [`harness-react-nextjs-behavior-testing`](../adapters/react-nextjs/skills/harness-react-nextjs-behavior-testing/SKILL.md) | Behavior testing | Component/integration and actual browser/server evidence | AC-linked tests, actual results and explicit limits |
 | [`harness-react-nextjs-accessible-ui`](../adapters/react-nextjs/skills/harness-react-nextjs-accessible-ui/SKILL.md) | Frontend | UI states và semantic accessibility | UI + accessibility/browser evidence |
 | [`harness-react-nextjs-server-boundaries`](../adapters/react-nextjs/skills/harness-react-nextjs-server-boundaries/SKILL.md) | Frontend security | Server actions, auth/caching boundaries | Server/client diff + auth/cache tests |
 
-## React Native adapter (2)
+## React Native adapter (4)
 
 | Skill ID (nguồn) | Khi nào dùng | Mục đích | Output mong đợi |
 | --- | --- | --- | --- |
+| [`harness-react-native-screen-delivery`](../adapters/react-native/skills/harness-react-native-screen-delivery/SKILL.md) | Screen implementation | Reuse route/screen, UI/form and API/state boundaries | AC-linked diff/checks, actual results and explicit limits |
+| [`harness-react-native-behavior-testing`](../adapters/react-native/skills/harness-react-native-behavior-testing/SKILL.md) | Behavior testing | JS/navigation and separate platform/device evidence | AC-linked tests, actual results and blocked native checks |
 | [`harness-react-native-device-permissions`](../adapters/react-native/skills/harness-react-native-device-permissions/SKILL.md) | Mobile | Permissions + deep links theo OS | Permission/nav changes + platform tests |
 | [`harness-react-native-offline-sync`](../adapters/react-native/skills/harness-react-native-offline-sync/SKILL.md) | Mobile | Offline queue, retries, conflict resolution | Persistence/sync + edge-case tests |
 

package/docs/tool-setup/README.md

@@ -68,3 +68,8 @@ No logged-in host/MCP or live-agent smoke was run for these docs; follow each li
 Review [Agent configuration](../agent-configuration.md) and run `aih setup --host <id>` for a declared
 routing plan. Validate native model/effort in the actual picker/client; no account availability is
 probed or host config overwritten. Incompatible defaults need your explicit provider/model mapping.
+
+## Artifact destinations and connections
+After project setup, inspect artifacts.json/integrations.json and [Artifact contract](../artifact-contract.md).
+Resolve declared bindings against actual host tools; missing accounts/MCP/access remain unavailable.
+Reuse recorded storage and source-write scope, verify revisions and maintain docs/spec/UI with each change.

package/docs/versioning.md

@@ -131,3 +131,21 @@ bundles use the CLI canonical seed if necessary. Existing configs are validated
 role gaps inherit/report project defaults. Inspect new payload/update diff; re-export eval reports after
 bundle changes. Revert consumer installation commit for rollback. Release update tests use relative
 versions instead of hardcoded 0.7.0, preserving downgrade refusal on future release branches.
+
+## Frontend/mobile coding and onboarding (unreleased)
+
+React/Next.js and React Native module contracts advance from 1.1.0 to 1.2.0 additively: existing skill
+IDs remain, feature/screen and behavior-testing skills plus manual checks/unscored cases are added.
+Project/lock/agent schemas and the distribution version stay unchanged. Existing consumers run the
+usual reviewed update dry-run/update/check; local.md, agents.json, native host config and app files are
+project-owned and preserved. Re-export eval reports after bundle changes; revert the consumer install
+commit for rollback. See [Frontend/mobile coding](frontend-mobile.md).
+
+## Artifact contract and integrations (unreleased)
+New project-owned schema-1 artifacts.json/integrations.json are optional on legacy installs and
+seeded when absent; custom bytes, source docs and native host configs are preserved. Project/lock
+schemas remain 1. Product 1.3.0 and UIUX 1.0.1 connect routing/maintenance guidance. Configured docs
+outputs override new-doc routes; external destinations return a handoff without local/remote writes.
+Configured output contracts require artifact-impact.json in existing changes when using ready; copy
+the installed template and record reviewed impact. No automatic migration of source documents or
+external publication. Review update --dry-run/update/check; rollback through Git. See [Artifact contract](artifact-contract.md).

package/harness.yaml

@@ -1,7 +1,7 @@
 {
   "schema_version": 1,
   "name": "ai-harness",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "adapters": [
     "java-spring",
     "react-nextjs",

package/integrations/mcp/README.md

@@ -14,3 +14,8 @@ If a server is unavailable, report the missing capability rather than inventing
 
 The example inventory is deliberately not a host-specific runnable configuration. Translate it to the
 chosen client's supported schema and test permission denials before enabling write tools.
+
+Project-owned .harness/integrations.json declares dynamic connection aliases, access and scope;
+.harness/artifacts.json maps their input/output locations. See [Artifact contract](../../docs/artifact-contract.md).
+`aih artifacts` does not discover/start MCP servers or authorize tool calls. Resolve aliases against
+the actual host tools and keep native configs/credentials outside Git.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manhd_d/ai-harness",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Reusable AI development rules, skills and workflows with a safe local installer",
   "type": "module",
   "bin": {

package/templates/AGENTS.md

@@ -6,6 +6,8 @@
    For new projects or consequential changes, apply `.harness/core/workflows/solution-framing.md`;
    preserve approved MVP/architecture and use compact notes for small clear fixes.
 3. Read `.harness/local.md` and `.harness/environment.json` (if present) for project facts and commands.
+   Read project-owned `.harness/artifacts.json` and `.harness/integrations.json` when present;
+   apply `.harness/core/workflows/artifact-contract.md` before creating docs/UI or changing sources.
    Read project-owned `.harness/agents.json` when present and `.harness/core/workflows/agent-routing.md`.
    Model/execution settings are preferences: verify actual host support, keep simple work sequential,
    and never switch to premium automatically. Host/runtime permissions still apply.

package/templates/artifacts.json

@@ -0,0 +1,6 @@
+{
+  "schema_version": 1,
+  "mode": "unconfigured",
+  "inputs": {},
+  "outputs": {}
+}

package/templates/integrations.json

@@ -0,0 +1,4 @@
+{
+  "schema_version": 1,
+  "connections": {}
+}

package/templates/openspec/artifact-impact.json

@@ -0,0 +1,5 @@
+{
+  "schema_version": 1,
+  "reviewed": false,
+  "items": []
+}

package/templates/openspec/design.md

@@ -10,6 +10,9 @@ reusable public APIs, intended code placement and rationale for new components/d
 ## Solution Fit
 TODO: Link MVP/AC/NFR, affected modules/data/contracts, important failure flows, accepted ADRs or
 proportional decision notes, dependencies and rollout/rollback constraints.
+## Artifact Impact
+TODO: Input IDs and observed source revisions; affected output docs/spec/UI/code; canonical owners,
+destinations and permitted write scope. Link artifact-impact.json when configured; justify unchanged outputs.
 ## Decisions
 TODO: Chosen approach, alternatives and trade-offs.
 ## Risks / Trade-offs