@dzhechkov/harness-cli 0.8.9 → 0.8.10
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/.dz-manifest.json +8 -8
- package/README.md +27 -6
- package/dist/cli.d.ts +11 -0
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +598 -111
- package/dist/cli.js.map +1 -1
- package/package.json +9 -9
- package/sbom.json +7 -7
- package/src/cli.ts +647 -64
package/.dz-manifest.json
CHANGED
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
},
|
|
10
10
|
{
|
|
11
11
|
"path": "README.md",
|
|
12
|
-
"sha256": "
|
|
12
|
+
"sha256": "db656fad1737e98dc639d06388a5f4ac00fa4024b195c673c3deef2ede3a40d5"
|
|
13
13
|
},
|
|
14
14
|
{
|
|
15
15
|
"path": "dist/bin.d.ts",
|
|
@@ -45,19 +45,19 @@
|
|
|
45
45
|
},
|
|
46
46
|
{
|
|
47
47
|
"path": "dist/cli.d.ts",
|
|
48
|
-
"sha256": "
|
|
48
|
+
"sha256": "0969e281fe2684f4143a3bf4b8cfd42894809a29d0d7f59afe0b90447c1a0cd4"
|
|
49
49
|
},
|
|
50
50
|
{
|
|
51
51
|
"path": "dist/cli.d.ts.map",
|
|
52
|
-
"sha256": "
|
|
52
|
+
"sha256": "21b330f7ea9942f8356ca69990a7324b9441ac1247f0d8b45aafdc71b70b1ed6"
|
|
53
53
|
},
|
|
54
54
|
{
|
|
55
55
|
"path": "dist/cli.js",
|
|
56
|
-
"sha256": "
|
|
56
|
+
"sha256": "dcf63e22be659557cc6be3f3d339da93d31dcd2e7ed14e653de7d254e1f151c5"
|
|
57
57
|
},
|
|
58
58
|
{
|
|
59
59
|
"path": "dist/cli.js.map",
|
|
60
|
-
"sha256": "
|
|
60
|
+
"sha256": "e232d50c27c05c95d479db0d2b861a042355db56cb8f570d371b5f0a4766e05e"
|
|
61
61
|
},
|
|
62
62
|
{
|
|
63
63
|
"path": "dist/core-compat.d.ts",
|
|
@@ -133,7 +133,7 @@
|
|
|
133
133
|
},
|
|
134
134
|
{
|
|
135
135
|
"path": "package.json",
|
|
136
|
-
"sha256": "
|
|
136
|
+
"sha256": "8c3f7e57b7bd8fc7534c60ca0de986466095b9c09d526077cf81c8010afe30ba"
|
|
137
137
|
},
|
|
138
138
|
{
|
|
139
139
|
"path": "src/bin.ts",
|
|
@@ -145,7 +145,7 @@
|
|
|
145
145
|
},
|
|
146
146
|
{
|
|
147
147
|
"path": "src/cli.ts",
|
|
148
|
-
"sha256": "
|
|
148
|
+
"sha256": "d235206d3cc7989890de5f9b5374755bb0a729ed2bfb63050b51a7d11dad9a8c"
|
|
149
149
|
},
|
|
150
150
|
{
|
|
151
151
|
"path": "src/core-compat.ts",
|
|
@@ -165,5 +165,5 @@
|
|
|
165
165
|
}
|
|
166
166
|
]
|
|
167
167
|
},
|
|
168
|
-
"signature": "
|
|
168
|
+
"signature": "8YsvP0BnmZosr5jWsex+6d5UvqzGxIxzM4qBpf+iOO/E3xEcOV/DANFrklGs3XpMN+Vcgz/ult9JnixhAlK9Cw=="
|
|
169
169
|
}
|
package/README.md
CHANGED
|
@@ -344,7 +344,7 @@ npm install -g @dzhechkov/harness-cli # install the CLI
|
|
|
344
344
|
dz help # see all commands
|
|
345
345
|
dz pretrain # analyze project files → recommend by tech stack
|
|
346
346
|
dz recommend "build API and deploy to K8s" # keyword match → skills + toolkits
|
|
347
|
-
dz recommend "work on this project" #
|
|
347
|
+
dz recommend "work on this project" # unmatched? → labels suggestions as PROJECT-STACK, not task-derived
|
|
348
348
|
dz stats # 54 packages, 201 skills, 10 targets, 14 presets
|
|
349
349
|
dz dashboard # visual panel — packages, adapters, skill packs
|
|
350
350
|
dz registry # browse all 179 skills by category
|
|
@@ -353,6 +353,24 @@ dz registry --category devops # filter by domain
|
|
|
353
353
|
dz downloads # npm weekly download stats
|
|
354
354
|
```
|
|
355
355
|
|
|
356
|
+
Russian and English word forms share the same lexical search tier; both the query and the
|
|
357
|
+
catalogue text are normalized. The current workspace reproducer prints the same count for the
|
|
358
|
+
two Russian forms (the catalogue count may grow, but the pair must stay equal):
|
|
359
|
+
|
|
360
|
+
```console
|
|
361
|
+
$ dz registry search "анализы"
|
|
362
|
+
Search: "анализы" — 8 result(s)
|
|
363
|
+
$ dz registry search "анализ"
|
|
364
|
+
Search: "анализ" — 8 result(s)
|
|
365
|
+
|
|
366
|
+
$ dz recommend "пришли анализы крови, хочу разобраться"
|
|
367
|
+
║ Topics: health
|
|
368
|
+
```
|
|
369
|
+
|
|
370
|
+
`dz recommend --json` reports `topicSource` as `task`, `project-stack`, or `none`. When no topic
|
|
371
|
+
matches, human output explicitly says that any suggestions came from the project stack; if the
|
|
372
|
+
stack also yields nothing, it prints that no recommendations were found.
|
|
373
|
+
|
|
356
374
|
### Phase 2: Install (set up your workspace)
|
|
357
375
|
|
|
358
376
|
```bash
|
|
@@ -1864,7 +1882,7 @@ runs a command that MEASURES the declared artifacts itself. It refuses a null re
|
|
|
1864
1882
|
never recorded as done), an absent or partially-present artifact set, and a stage that declares nothing
|
|
1865
1883
|
to witness — so a stage that did not happen can no longer be recorded, which the old mechanism allowed.
|
|
1866
1884
|
|
|
1867
|
-
## All Commands (
|
|
1885
|
+
## All Commands (85)
|
|
1868
1886
|
|
|
1869
1887
|
*(84 MEASURED from the bounded command inventory below; rendered `dz --help` exposes 81 unique
|
|
1870
1888
|
top-level names, pinned by `test/command-count.test.ts`.)*
|
|
@@ -1891,6 +1909,7 @@ dz teach --harmonize [--apply] [--threshold <0..1>] # alias of `d
|
|
|
1891
1909
|
dz statusline [--json] [--install] # compact Claude Code statusline: live self-learning pattern count + brain sources
|
|
1892
1910
|
dz usage [--json] [--project <dir>] | --calibrate --session <pct> --weekly <pct> [--model fable=<pct>] # ESTIMATE Claude usage from fixed reset windows; optional per-model weekly binding; exit 0 ALWAYS
|
|
1893
1911
|
--by-stage [--run <id> | --slug <s>] [--epsilon <0..1>] [--write <file.jsonl>] [--json] # per-stage cost ledger for ONE feature-adr run + reconciliation invariant (BALANCED | DEFECT | INSUFFICIENT_DATA)
|
|
1912
|
+
dz chain [--project <dir>] [--json] # verify EVERY hash-chained journal in one command; coverage is DERIVED from the CHAINED_JOURNALS registry, so a journal cannot be chained and checked by nobody; an ABSENT journal is NAMED, never omitted; exit 1 on broken/unreadable
|
|
1894
1913
|
dz claim-check [paths...] [--json] [--fail-on high|medium|none] [--project <dir>] # enforce the Integrity Rule: flag untagged/overstated accuracy claims; default scan = READMEs + features' 08_qe_report.md; exit 1 only at/above --fail-on (default high)
|
|
1895
1914
|
dz lint [paths...] [--json] [--config <file>] [--registry <file>] [--project <dir>] # advisory EN/RU prose-style lint; findings exit 0, incomplete input/policy exits 1, usage exits 2
|
|
1896
1915
|
dz brain list [--json] # the durable cross-project knowledge brain
|
|
@@ -1903,7 +1922,7 @@ dz brain primer <slug> [--json] # print a so
|
|
|
1903
1922
|
dz brain export --source <slug> --out <file> # write a portable per-book KB slice (ships inside the pack, §8.1)
|
|
1904
1923
|
dz brain update <slug> [--project <dir>] [--json] # non-destructive refresh: re-mirror a re-ingested source, evict stale corpus
|
|
1905
1924
|
dz pretrain [--project <dir>]
|
|
1906
|
-
dz recommend "<task description>"
|
|
1925
|
+
dz recommend "<task description>" [--json] (RU/EN lexical topics; explicit task/project-stack/none provenance)
|
|
1907
1926
|
dz compose <preset1+preset2+...> [--target <name>]
|
|
1908
1927
|
dz diff <skill-dir>
|
|
1909
1928
|
dz upgrade [--target <name>] [--project <dir>]
|
|
@@ -3470,7 +3489,9 @@ dz registry search <query> # search by keyword
|
|
|
3470
3489
|
dz registry --category <cat> # browse one category
|
|
3471
3490
|
dz init --target claude-code --select skill-advisor # interactive advisor skill
|
|
3472
3491
|
```
|
|
3473
|
-
Verify: `dz registry` lists them. Gotcha: `recommend` is lexical/keyword ranking, not an LLM
|
|
3492
|
+
Verify: `dz registry` lists them. Gotcha: `recommend` is lexical/keyword ranking, not an LLM;
|
|
3493
|
+
word forms are normalized, but paraphrases still belong to `/skill-advisor`. A fallback is labeled
|
|
3494
|
+
`PROJECT-STACK SUGGESTIONS` and never presented as a match to the question.
|
|
3474
3495
|
|
|
3475
3496
|
**"Install just ONE skill, not a whole preset."**
|
|
3476
3497
|
```bash
|
|
@@ -4396,11 +4417,11 @@ refusal as the honest answer.
|
|
|
4396
4417
|
|
|
4397
4418
|
## Status
|
|
4398
4419
|
|
|
4399
|
-
`harness-core v0.8.10` · `harness-cli v0.8.
|
|
4420
|
+
`harness-core v0.8.10` · `harness-cli v0.8.10` — **staged, not published:** adds bounded
|
|
4400
4421
|
`volume-shadow/v1` publish observations with structured human/JSON/audit parity. All four remain
|
|
4401
4422
|
SOFT-only; incomplete evidence is unknown, and source-comment justification is out of scope.
|
|
4402
4423
|
|
|
4403
|
-
`harness-core v0.8.
|
|
4424
|
+
`harness-core v0.8.10` · `skills-feature-adr v1.5.9` — **staged, not published:** the packaged
|
|
4404
4425
|
feature-adr workflow performs advisory top-3 micro-recall at the live Step 3 ADR choice and Step 6
|
|
4405
4426
|
plan-route choice. Every failure is fail-open; versioned `.fa-state/decision-recall.jsonl` rows make
|
|
4406
4427
|
receipt coverage and repeat-related outcomes derivable offline. The hypothesis is external `[SRC],
|
package/dist/cli.d.ts
CHANGED
|
@@ -8,6 +8,15 @@ import { runSyncCodexHooks, type CodexHooksSyncReport, type BridgeFamily } from
|
|
|
8
8
|
import type { RecallPatternsOptions, TeachGuardResult, IntegrationOutcome } from '@dzhechkov/harness-core';
|
|
9
9
|
/** Literal command inventory, pinned against the main dispatch switch by a layer-1 test. */
|
|
10
10
|
export declare const DZ_COMMANDS: readonly string[];
|
|
11
|
+
export interface MutationGateRunnerObservation {
|
|
12
|
+
readonly exitCode: number | null;
|
|
13
|
+
readonly output: string;
|
|
14
|
+
readonly failureReason?: string;
|
|
15
|
+
}
|
|
16
|
+
export type MutationGateRunner = (command: string, options: {
|
|
17
|
+
readonly cwd: string;
|
|
18
|
+
readonly timeoutMs: number;
|
|
19
|
+
}) => MutationGateRunnerObservation;
|
|
11
20
|
/** Output sink + working directory — injectable so the CLI is testable. */
|
|
12
21
|
export interface CliIo {
|
|
13
22
|
readonly cwd?: string;
|
|
@@ -56,6 +65,8 @@ export interface CliIo {
|
|
|
56
65
|
* offline, hermetically — mirrors the {@link CliIo.releaseRunner} idiom.
|
|
57
66
|
*/
|
|
58
67
|
readonly installRunner?: (command: string, cwd: string) => void;
|
|
68
|
+
/** Fault seam for proving mutation-gate catches and retries thrown runner internals. */
|
|
69
|
+
readonly mutationGateRunner?: MutationGateRunner;
|
|
59
70
|
}
|
|
60
71
|
/** Injected subprocess runner used by `dz release` (see {@link CliIo.releaseRunner}). */
|
|
61
72
|
export type ReleaseExecRunner = (cmd: string, opts: {
|
package/dist/cli.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EAAoC,KAAK,EAAa,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAM3G,OAAO,
|
|
1
|
+
{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
|