daftari 1.18.0 → 1.19.0
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/CHANGELOG.md +38 -0
- package/dist/index.js +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,44 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [1.19.0] - 2026-06-10
|
|
11
|
+
|
|
12
|
+
### Added
|
|
13
|
+
|
|
14
|
+
- **Code coherence: doc-to-code bindings across the audit and eval** ([#117],
|
|
15
|
+
[#118], [#119], [#120], [#121]). Vault docs can now declare which code they
|
|
16
|
+
document, and the audit can verify those bindings still hold.
|
|
17
|
+
- **`describes` frontmatter field** ([#117]) — a built-in optional string
|
|
18
|
+
array of doc-to-code bindings, each `repo:path` or `repo:path::symbol` (a
|
|
19
|
+
bare `path` resolves against the doc's own repo; the `::symbol` suffix is
|
|
20
|
+
retained but resolved at file level in v1). A first-class relationship like
|
|
21
|
+
`sources` / `superseded_by`; defaults to `[]`.
|
|
22
|
+
- **`type: docs | code` repo discriminant for the audit** ([#118]) — code
|
|
23
|
+
repos join the coherence audit as reference targets, indexed by path only
|
|
24
|
+
(no frontmatter parsing, no content read) and excluded from staleness.
|
|
25
|
+
Adds the `--code-repo` flag; a code repo's glob defaults to `**/*`.
|
|
26
|
+
- **Doc-to-code reference integrity** ([#119]) — the audit classifies
|
|
27
|
+
`describes` entries as cross-repo edges and flags any whose target file is
|
|
28
|
+
missing, in a new report section with a `brokenDescribes` total and a
|
|
29
|
+
`fail_on.broken_describes` threshold (default 1).
|
|
30
|
+
- **`--semantic` drift check** ([#120]) — opt-in LLM pass that reads each
|
|
31
|
+
resolvable binding's doc and code and judges whether the doc still
|
|
32
|
+
accurately describes the code (`coherent` / `drifted` / `contradicted` /
|
|
33
|
+
`skipped`). `--auto-tension` logs drift as a tension in the docs vault;
|
|
34
|
+
`--max-semantic` caps LLM calls. Every non-markdown read is guarded (size
|
|
35
|
+
cap, binary sniff, strict UTF-8). Advisory — does not gate the exit code,
|
|
36
|
+
and the default audit needs no API key and makes no network calls.
|
|
37
|
+
- **`describes` as a subgraph edge kind in eval** ([#121]) — the cortex
|
|
38
|
+
quality sampler records doc-to-code edges and loads vault-resident code as
|
|
39
|
+
separate, non-citable context nodes (the answerer is never asked to
|
|
40
|
+
retrieve code). External-repo code-content loading in eval is deferred.
|
|
41
|
+
|
|
42
|
+
[#117]: https://github.com/mavaali/daftari/issues/117
|
|
43
|
+
[#118]: https://github.com/mavaali/daftari/issues/118
|
|
44
|
+
[#119]: https://github.com/mavaali/daftari/issues/119
|
|
45
|
+
[#120]: https://github.com/mavaali/daftari/issues/120
|
|
46
|
+
[#121]: https://github.com/mavaali/daftari/issues/121
|
|
47
|
+
|
|
10
48
|
## [1.18.0] - 2026-06-09
|
|
11
49
|
|
|
12
50
|
### Added
|
package/dist/index.js
CHANGED
|
@@ -28,7 +28,7 @@ import { directoryExists } from "./storage/local.js";
|
|
|
28
28
|
import { loadConfig } from "./utils/config.js";
|
|
29
29
|
// Kept in sync with package.json. Surfaced in the process lockfile for
|
|
30
30
|
// operator diagnostics. Bump both together on a release.
|
|
31
|
-
const DAFTARI_VERSION = "1.
|
|
31
|
+
const DAFTARI_VERSION = "1.19.0";
|
|
32
32
|
// Reads `--name value` or `--name=value` from argv; null if absent.
|
|
33
33
|
export function parseFlag(argv, name) {
|
|
34
34
|
const flag = `--${name}`;
|