tenhaw 1.0.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -2
- package/dist/{chunk-BKPOQVTM.js → chunk-XWI3643Z.js} +2 -2
- package/dist/index.js +9 -8
- package/dist/scaffold.js +1 -1
- package/instructions/ai-readiness-assessment/AGENTS.md +2 -2
- package/instructions/ai-roi-business-case/AGENTS.md +1 -1
- package/instructions/ai-usecase-register/AGENTS.md +1 -1
- package/instructions/build-ai-adoption-dashboard/AGENTS.md +1 -1
- package/instructions/delivery-metrics-dora/AGENTS.md +1 -1
- package/instructions/portfolio-tracking/AGENTS.md +1 -1
- package/instructions/product-operating-model/AGENTS.md +1 -1
- package/package.json +7 -7
- package/templates/ai-adoption-dashboard/package.json +3 -2
- package/templates/ai-adoption-dashboard/pnpm-workspace.yaml +3 -0
- package/templates/ai-readiness-assessment/package.json +4 -3
- package/templates/ai-readiness-assessment/pnpm-workspace.yaml +3 -0
- package/templates/ai-usecase-register/package.json +5 -4
- package/templates/ai-usecase-register/pnpm-workspace.yaml +3 -0
- package/templates/delivery-metrics-dashboard/package.json +4 -3
- package/templates/delivery-metrics-dashboard/pnpm-workspace.yaml +3 -0
- package/templates/product-operating-model/package.json +4 -3
- package/templates/product-operating-model/pnpm-workspace.yaml +3 -0
package/README.md
CHANGED
|
@@ -10,10 +10,10 @@ An agent-friendly CLI for building internal portfolio, product delivery and AI t
|
|
|
10
10
|
|
|
11
11
|
## Install
|
|
12
12
|
|
|
13
|
-
Release instructions target **1.0.
|
|
13
|
+
Release instructions target **1.0.1**. Verify that exact version has been published before running them. Requires Node.js 22.14 or later.
|
|
14
14
|
|
|
15
15
|
```sh
|
|
16
|
-
npm install --global tenhaw@1.0.
|
|
16
|
+
npm install --global tenhaw@1.0.1
|
|
17
17
|
```
|
|
18
18
|
|
|
19
19
|
## Quick start
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
// src/scaffold.ts
|
|
2
|
+
import { VERSION } from "@tenhaw/core";
|
|
2
3
|
import { cp, lstat, mkdir, readFile, readdir, realpath, rename, rm, writeFile } from "fs/promises";
|
|
3
4
|
import { dirname, isAbsolute, join, relative, resolve, sep } from "path";
|
|
4
5
|
import { fileURLToPath } from "url";
|
|
@@ -29,10 +30,9 @@ async function scaffold(template, directory, options = {}) {
|
|
|
29
30
|
const manifestPath = join(staging, "package.json");
|
|
30
31
|
const manifest = JSON.parse(await readFile(manifestPath, "utf8"));
|
|
31
32
|
manifest.name = target.split(sep).at(-1)?.toLowerCase().replace(/[^a-z0-9-]/g, "-") || "tenhaw-internal-tool";
|
|
32
|
-
delete manifest.packageManager;
|
|
33
33
|
for (const group of ["dependencies", "devDependencies"]) {
|
|
34
34
|
for (const [name, version] of Object.entries(manifest[group] ?? {})) {
|
|
35
|
-
if (String(version).startsWith("workspace:")) manifest[group][name] =
|
|
35
|
+
if (String(version).startsWith("workspace:")) manifest[group][name] = VERSION;
|
|
36
36
|
}
|
|
37
37
|
}
|
|
38
38
|
await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}
|
package/dist/index.js
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
import {
|
|
3
3
|
scaffold,
|
|
4
4
|
templates
|
|
5
|
-
} from "./chunk-
|
|
5
|
+
} from "./chunk-XWI3643Z.js";
|
|
6
6
|
|
|
7
7
|
// src/index.ts
|
|
8
8
|
import { readFile, writeFile, mkdir, lstat, realpath } from "fs/promises";
|
|
@@ -46,7 +46,7 @@ function parseArgs(argv) {
|
|
|
46
46
|
}
|
|
47
47
|
return { args, flags };
|
|
48
48
|
}
|
|
49
|
-
var help = `Tenhaw Kit
|
|
49
|
+
var help = `Tenhaw Kit ${core.VERSION}: building blocks for internal product, portfolio and transformation tools
|
|
50
50
|
|
|
51
51
|
tenhaw init <template> <new-dir> Scaffold an internal tool
|
|
52
52
|
tenhaw readiness --input answers.json Score evidence and response coverage
|
|
@@ -121,13 +121,13 @@ async function interactiveRoi() {
|
|
|
121
121
|
function installation() {
|
|
122
122
|
return {
|
|
123
123
|
claude: ["claude plugin marketplace add Tenhaw/tenhaw-kit", "claude plugin install tenhaw@tenhaw-kit"],
|
|
124
|
-
claudeMcp:
|
|
125
|
-
codex:
|
|
124
|
+
claudeMcp: `claude mcp add tenhaw -- npx -y @tenhaw/mcp@${core.VERSION}`,
|
|
125
|
+
codex: `codex mcp add tenhaw -- npx -y @tenhaw/mcp@${core.VERSION}`,
|
|
126
126
|
gemini: "gemini extensions install https://github.com/Tenhaw/tenhaw-gemini",
|
|
127
|
-
cursor: `cursor://anysphere.cursor-deeplink/mcp/install?name=tenhaw&config=${encodeURIComponent(Buffer.from(JSON.stringify({ command: "npx", args: ["-y",
|
|
128
|
-
vscode: `code --add-mcp '${JSON.stringify({ name: "tenhaw", command: "npx", args: ["-y",
|
|
127
|
+
cursor: `cursor://anysphere.cursor-deeplink/mcp/install?name=tenhaw&config=${encodeURIComponent(Buffer.from(JSON.stringify({ command: "npx", args: ["-y", `@tenhaw/mcp@${core.VERSION}`] })).toString("base64"))}`,
|
|
128
|
+
vscode: `code --add-mcp '${JSON.stringify({ name: "tenhaw", command: "npx", args: ["-y", `@tenhaw/mcp@${core.VERSION}`] })}'`,
|
|
129
129
|
remote: "https://mcp.tenhaw.com/mcp",
|
|
130
|
-
publication:
|
|
130
|
+
publication: `These public install commands require the verified ${core.VERSION} release. For a source checkout run pnpm build, then node packages/mcp/dist/index.js.`
|
|
131
131
|
};
|
|
132
132
|
}
|
|
133
133
|
async function writeAgentInstructions(directory = process.cwd()) {
|
|
@@ -220,7 +220,8 @@ async function usecases(action, flags) {
|
|
|
220
220
|
async function main(argv = process.argv.slice(2)) {
|
|
221
221
|
const { args, flags } = parseArgs(argv);
|
|
222
222
|
if (flags.version) {
|
|
223
|
-
process.stdout.write(
|
|
223
|
+
process.stdout.write(`${core.VERSION}
|
|
224
|
+
`);
|
|
224
225
|
return;
|
|
225
226
|
}
|
|
226
227
|
if (flags.help || !args.length) {
|
package/dist/scaffold.js
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# Tenhaw Kit: ai readiness assessment
|
|
2
2
|
|
|
3
|
-
Fetch the questionnaire with `npx -y tenhaw@1.0.
|
|
3
|
+
Fetch the questionnaire with `npx -y tenhaw@1.0.1 readiness --questionnaire --json`. Record explicit question IDs, scores and optional evidence in `{ "answers": [...] }`. Ask for missing evidence; never infer unanswered scores. Run the assessment and return the structured report. Show coverage beside every score and withhold maturity bands below 80% coverage. This framework supports internal self-assessment; the advisory audit separately examines real workflows.
|
|
4
4
|
|
|
5
|
-
Command: `npx -y tenhaw@1.0.
|
|
5
|
+
Command: `npx -y tenhaw@1.0.1 readiness --input answers.json --json`
|
|
6
6
|
|
|
7
7
|
Use package schemas to validate the host data model; run the host repository’s documented build, test and lint commands. No command here replaces existing repository instructions.
|
|
8
8
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Collect useCase, users, minutesPerTask, tasksPerUserPerMonth, savings low/base/high fractions, hourlyCost, buildCost, monthlyRunCost, adoptionMonths, horizonMonths, annualDiscountRate, cashRealisation and currency. Make cashRealisation explicit: retained staff capacity is not automatically cash. Report low/base/high cases, recovered capacity, cash benefits, NPV and payback separately. Defaults are editable assumptions, never quotes. Use `roi cost --stage poc --json` for a transparent project-cost range.
|
|
4
4
|
|
|
5
|
-
Command: `npx -y tenhaw@1.0.
|
|
5
|
+
Command: `npx -y tenhaw@1.0.1 roi --input roi.json --json`
|
|
6
6
|
|
|
7
7
|
Use package schemas to validate the host data model; run the host repository’s documented build, test and lint commands. No command here replaces existing repository instructions.
|
|
8
8
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Prepare `{ "useCases": [...] }` using the shared schema. Include accountable owner roles, problem, business unit, value and feasibility (0-5), status and an indicative risk tier. Add dependencies and outcome KPIs when known. Prioritise with governance gates ahead of numeric value-times-feasibility. Prohibited items remain blocked, high and unknown risk require review. Risk labels are indicative, not legal advice. Export with `usecases export --input usecases.json --format csv` when needed.
|
|
4
4
|
|
|
5
|
-
Command: `npx -y tenhaw@1.0.
|
|
5
|
+
Command: `npx -y tenhaw@1.0.1 usecases prioritise --input usecases.json --json`
|
|
6
6
|
|
|
7
7
|
Use package schemas to validate the host data model; run the host repository’s documented build, test and lint commands. No command here replaces existing repository instructions.
|
|
8
8
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Choose a new directory. Scaffolding preserves every existing path and never runs install scripts itself. Install dependencies with the user’s package manager, then run the project build and tests. The starter includes clearly synthetic examples and browser-local CSV/JSON data. Add authentication before introducing shared persistence or any server-side real-data routes. Explain the source and period of each metric. Never invent vendor usage data or add telemetry.
|
|
4
4
|
|
|
5
|
-
Command: `npx -y tenhaw@1.0.
|
|
5
|
+
Command: `npx -y tenhaw@1.0.1 init ai-adoption-dashboard internal-adoption --yes --json`
|
|
6
6
|
|
|
7
7
|
Use package schemas to validate the host data model; run the host repository’s documented build, test and lint commands. No command here replaces existing repository instructions.
|
|
8
8
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Prefer supplied normalised events for reproducible runs. Collect from GitHub/Jira only when requested, with credentials already configured in the local environment. Never ask the user to paste tokens into chat. Use one service per report and explicit timestamp boundaries. Five DORA metrics require production deployments and incident/commit linkage; unavailable values remain null. Use aggregate metrics only with the remote MCP, never upload repository events. Do not rank unrelated teams or invent industry bands.
|
|
4
4
|
|
|
5
|
-
Command: `npx -y tenhaw@1.0.
|
|
5
|
+
Command: `npx -y tenhaw@1.0.1 delivery-metrics --from-file events.json --since 2026-01-01T00:00:00Z --until 2026-02-01T00:00:00Z --json`
|
|
6
6
|
|
|
7
7
|
Use package schemas to validate the host data model; run the host repository’s documented build, test and lint commands. No command here replaces existing repository instructions.
|
|
8
8
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Start from the operating-model template for accountable teams, objectives and roadmap horizons. Compose @tenhaw/opmodel with @tenhaw/usecase-register and @tenhaw/ai-roi to connect initiatives, dependencies, outcome KPIs and realised cash assumptions. Keep service-level delivery metrics as separate evidence. Store user-defined portfolio fields in the host product; do not invent a universal portfolio score. Choose a persistence and access-control design appropriate to the organisation before moving beyond browser-local data.
|
|
4
4
|
|
|
5
|
-
Command: `npx -y tenhaw@1.0.
|
|
5
|
+
Command: `npx -y tenhaw@1.0.1 init product-operating-model internal-portfolio --yes --json`
|
|
6
6
|
|
|
7
7
|
Use package schemas to validate the host data model; run the host repository’s documented build, test and lint commands. No command here replaces existing repository instructions.
|
|
8
8
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Define teams with IDs, team types and accountable owners. Add measurable key results with baseline, target, current and confidence, roadmap items with now/next/later and intended outcomes, and team interactions. Validate ownership and dependency checks before rendering. Use `opmodel diagram --input model.json --format mermaid` for a topology map. Team Topologies is a cited model; the checks support a conversation, not organisational prescriptions.
|
|
4
4
|
|
|
5
|
-
Command: `npx -y tenhaw@1.0.
|
|
5
|
+
Command: `npx -y tenhaw@1.0.1 opmodel validate --input model.json --json`
|
|
6
6
|
|
|
7
7
|
Use package schemas to validate the host data model; run the host repository’s documented build, test and lint commands. No command here replaces existing repository instructions.
|
|
8
8
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "tenhaw",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1",
|
|
4
4
|
"description": "Agent-ready building blocks for internal product, portfolio, delivery and AI transformation tools",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -43,12 +43,12 @@
|
|
|
43
43
|
"ai-transformation"
|
|
44
44
|
],
|
|
45
45
|
"dependencies": {
|
|
46
|
-
"@tenhaw/core": "1.0.
|
|
47
|
-
"@tenhaw/ai-readiness": "1.0.
|
|
48
|
-
"@tenhaw/delivery-metrics": "1.0.
|
|
49
|
-
"@tenhaw/ai-roi": "1.0.
|
|
50
|
-
"@tenhaw/usecase-register": "1.0.
|
|
51
|
-
"@tenhaw/opmodel": "1.0.
|
|
46
|
+
"@tenhaw/core": "1.0.1",
|
|
47
|
+
"@tenhaw/ai-readiness": "1.0.1",
|
|
48
|
+
"@tenhaw/delivery-metrics": "1.0.1",
|
|
49
|
+
"@tenhaw/ai-roi": "1.0.1",
|
|
50
|
+
"@tenhaw/usecase-register": "1.0.1",
|
|
51
|
+
"@tenhaw/opmodel": "1.0.1"
|
|
52
52
|
},
|
|
53
53
|
"scripts": {
|
|
54
54
|
"build": "tsup src/index.ts src/scaffold.ts --format esm --dts",
|
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tenhaw-template/ai-adoption-dashboard",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1",
|
|
4
4
|
"private": true,
|
|
5
|
+
"packageManager": "pnpm@11.25.0",
|
|
5
6
|
"scripts": {
|
|
6
7
|
"dev": "next dev",
|
|
7
8
|
"build": "next build",
|
|
@@ -14,7 +15,7 @@
|
|
|
14
15
|
"next": "16.4.5",
|
|
15
16
|
"react": "19.2.4",
|
|
16
17
|
"react-dom": "19.2.4",
|
|
17
|
-
"@tenhaw/core": "1.0.
|
|
18
|
+
"@tenhaw/core": "1.0.1"
|
|
18
19
|
},
|
|
19
20
|
"devDependencies": {
|
|
20
21
|
"@types/node": "^22.0.0",
|
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tenhaw-template/ai-readiness-assessment",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1",
|
|
4
4
|
"private": true,
|
|
5
|
+
"packageManager": "pnpm@11.25.0",
|
|
5
6
|
"scripts": {
|
|
6
7
|
"dev": "next dev",
|
|
7
8
|
"build": "next build",
|
|
@@ -14,8 +15,8 @@
|
|
|
14
15
|
"next": "16.4.5",
|
|
15
16
|
"react": "19.2.4",
|
|
16
17
|
"react-dom": "19.2.4",
|
|
17
|
-
"@tenhaw/core": "1.0.
|
|
18
|
-
"@tenhaw/ai-readiness": "1.0.
|
|
18
|
+
"@tenhaw/core": "1.0.1",
|
|
19
|
+
"@tenhaw/ai-readiness": "1.0.1"
|
|
19
20
|
},
|
|
20
21
|
"devDependencies": {
|
|
21
22
|
"@types/node": "^22.0.0",
|
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tenhaw-template/ai-usecase-register",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1",
|
|
4
4
|
"private": true,
|
|
5
|
+
"packageManager": "pnpm@11.25.0",
|
|
5
6
|
"scripts": {
|
|
6
7
|
"dev": "next dev",
|
|
7
8
|
"build": "next build",
|
|
@@ -14,9 +15,9 @@
|
|
|
14
15
|
"next": "16.4.5",
|
|
15
16
|
"react": "19.2.4",
|
|
16
17
|
"react-dom": "19.2.4",
|
|
17
|
-
"@tenhaw/core": "1.0.
|
|
18
|
-
"@tenhaw/usecase-register": "1.0.
|
|
19
|
-
"@tenhaw/ai-roi": "1.0.
|
|
18
|
+
"@tenhaw/core": "1.0.1",
|
|
19
|
+
"@tenhaw/usecase-register": "1.0.1",
|
|
20
|
+
"@tenhaw/ai-roi": "1.0.1"
|
|
20
21
|
},
|
|
21
22
|
"devDependencies": {
|
|
22
23
|
"@types/node": "^22.0.0",
|
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tenhaw-template/delivery-metrics-dashboard",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1",
|
|
4
4
|
"private": true,
|
|
5
|
+
"packageManager": "pnpm@11.25.0",
|
|
5
6
|
"scripts": {
|
|
6
7
|
"dev": "next dev",
|
|
7
8
|
"build": "next build",
|
|
@@ -14,8 +15,8 @@
|
|
|
14
15
|
"next": "16.4.5",
|
|
15
16
|
"react": "19.2.4",
|
|
16
17
|
"react-dom": "19.2.4",
|
|
17
|
-
"@tenhaw/core": "1.0.
|
|
18
|
-
"@tenhaw/delivery-metrics": "1.0.
|
|
18
|
+
"@tenhaw/core": "1.0.1",
|
|
19
|
+
"@tenhaw/delivery-metrics": "1.0.1"
|
|
19
20
|
},
|
|
20
21
|
"devDependencies": {
|
|
21
22
|
"@types/node": "^22.0.0",
|
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tenhaw-template/product-operating-model",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1",
|
|
4
4
|
"private": true,
|
|
5
|
+
"packageManager": "pnpm@11.25.0",
|
|
5
6
|
"scripts": {
|
|
6
7
|
"dev": "next dev",
|
|
7
8
|
"build": "next build",
|
|
@@ -14,8 +15,8 @@
|
|
|
14
15
|
"next": "16.4.5",
|
|
15
16
|
"react": "19.2.4",
|
|
16
17
|
"react-dom": "19.2.4",
|
|
17
|
-
"@tenhaw/core": "1.0.
|
|
18
|
-
"@tenhaw/opmodel": "1.0.
|
|
18
|
+
"@tenhaw/core": "1.0.1",
|
|
19
|
+
"@tenhaw/opmodel": "1.0.1"
|
|
19
20
|
},
|
|
20
21
|
"devDependencies": {
|
|
21
22
|
"@types/node": "^22.0.0",
|