ariadnev docs

Search this edition

    Language · VI
    Version · 1.0.0

    Ghi chú phát hành

    Những gì thay đổi trong bản phát hành này, đúng như bản phát hành đóng gói.

    On this page
    1. 1.0.0
    2. Major Changes
    3. Minor Changes
    4. Patch Changes

    Ghi chú phát hành được công bố bằng tiếng Anh cùng mỗi bản phát hành.

    1.0.0

    Major Changes

    • Rename the whole product to ariadnev (short alias av) and cut 1.0.0.

      Every identifier moves: the binary and package name, the ARIADNEV_* env prefix, the av:/av- skill and agent namespaces, the ~/.ariadnev and .ariadnev/ state directories, the ~/.cache/ariadnev cache, the .claude/hooks/av/ hook directory, the ariadnev@X release tag grammar, the ariadnev-{os}-{arch} asset names, and the base URL, now ariadnev.com. A CI gate (check-brand-drift.mjs) fails the build if an old identifier reappears outside an explicit historical-record allowlist.

      Breaking — installs made before the rename are not adopted. Files written under the old name into .claude/, .codex/, and .cursor/, plus ~/.vcskill/ and ~/.cache/vcskill/, are not recognized and will not be removed by ariadnev uninstall. Delete them by hand; a fresh ariadnev install writes a clean tree beside them.

      Two readers stay backward compatible, because both touch data that already exists on the user's disk:

      • An AGENTS.md managed block written with the old markers is replaced rather than duplicated, and is still stripped on uninstall.
      • A schema-1 receipt is still readable, so doctor and uninstall keep working against it.

      The release pipeline resolves a previous stable release across the rename, so 1.0.0 correctly sees the last pre-rename release as its predecessor instead of reporting no history at all.

    • The kit is now the full upstream corpus, and the CLI grew the surfaces it needs.

      Content. 101 ported skills beside the two this repo owns, 16 agents under their upstream names, 10 rules, 14 hooks across 8 events, and a statusline. Ported artifacts are marked as such and judged by validity rather than by this project's authoring style — see ADR 0008.

      Configuration. ~/.ariadnev/config.json and a project file, with a permission split: a project may set workspace-shaped keys, never the ones that protect the user (privacy blocking, trust, script execution policy, notification destinations, per-hook switches). ariadnev config prefs resolve shows what took effect and what was rejected; a configured destination prints as <redacted>.

      New commands. plan use|show, kit install-path|refresh, mcp list|show|add|remove|verify (verify starts each server and checks the MCP initialize handshake), adapters regenerate. Commands added from here on use one exit-code table; doctor and the other pre-existing commands keep theirs, because CI gates on them.

      Fixes. Uninstall hashed files as utf8, so every binary looked user-modified and was preserved — a full uninstall left 55 fonts and images behind. Hooks resolved their shared library and the provider config dir by hard-coded relative paths that are wrong in this layout, which silently disabled the scout guard. Hook bindings now install in a declared order rather than alphabetically.

      Breaking. Agents are renamed to their upstream names (av-reviewercode-reviewer, av-developerfullstack-developer, av-exploreexplore, and so on). State from before the rename is not migrated; see docs/migration-from-the-old-name.md.

    Minor Changes

    • Skill Python environments are now real: declared, locked, and installable.

      Every skill that ships Python states what it needs. The 17 that import only the standard library say so; the five that do not — cti-expert, design, document-skills, excalidraw, mcp-builder — carry a pinned, hash-verified ariadnev-lock.json generated once by scripts/generate-skill-lock.ts and replayed by ariadnev skill install with --require-hashes --no-deps. ariadnev skill verify reports ok for all 22, and --deep imports the packages in a child process.

      Locks are universal. One file covers every platform and interpreter, carrying PEP 508 markers. This is not a refinement: mcp resolves pywin32 ; sys_platform == 'win32', and a lock that drops the marker asks pip for a Windows-only distribution on macOS, which fails and takes the whole environment with it. The same evaluator decides what pip installs and what verify requires, so a marker-excluded package is not reported missing.

      Fixes found by running it:

      • --deep derived import names by replacing hyphens with underscores, which is wrong for python-docx (docx), pillow (PIL) and scikit-learn (sklearn). Module names now come from each package's RECORD.
      • A requirements.txt under tests/ was read as a runtime declaration, so databases was reported as needing an environment for mongomock — a mock library no script imports. The directory a file sits in now says what it is.
      • The thorough check required every path in RECORD, including the .pyc files Python discards and regenerates, so an interpreter upgrade would have reported every package as corrupt.
      • ariadnev skill install answered "no runtime dependencies — nothing to install" for a skill that plainly had some but no lock. It now names the generator.
      • The deep-import timeout was 30s, which a first import of numpy, scipy and scikit-learn exceeds on a cold install and clears in under 3s afterwards. It bounds a hang, so it is now 120s.

      ariadnev skill install reports the size of what it built and warns past 400 MB per environment; verify reports the total and warns past 1.5 GB. All five together are 659 MB.

    • 35acc7d: CLI "xịn" program — a branded terminal UI plus six capability upgrades (brainstorm → plan → 4-reviewer red-team → TDD build):

      • Branded terminal UI + av short alias. Output is colored/branded on a TTY and plain when piped/CI/NO_COLOR, cohesive with the ariadnev.com landing page (coral wordmark, ✓/skip/◆ glyphs). contract renders a terminal matrix grid on a TTY. The installer links a guarded av alias (never clobbers an existing av; ARIADNEV_ALIAS=off to skip).
      • ariadnev doctor scored audit. A 0–100 health bar, per-check tri-state (pass/skip/warning/fail), and an exact remediation command per finding. The score is informational only — the exit-code contract is unchanged.
      • Credential sanitizer + SECURITY.md. GitHub/OpenAI token shapes, URL userinfo, and secret-shaped env values are redacted from all output at a single boundary (empty/short values never shred output).
      • ariadnev eval. Cost-tiered skill-quality gate: tier-1 static (free, always)
        • tier-3 LLM judge when ARIADNEV_EVAL_CMD is set.
      • contract --json machine envelope (protocol_version, capabilities[], schema range; legacy version preserved) + CI now runs the .mjs/.cjs test suites.
      • ariadnev query. A local, append-only JSONL history (~/.ariadnev/history.jsonl) of installs, doctor runs, and updates; recording is best-effort and allowlist-scrubbed (no free-form/secret data persisted).
      • Anonymous, opt-out telemetry facility (ariadnev telemetry status) — stateless, categorical-only, and off by default (nothing is transmitted until an endpoint is configured). Opt out with ARIADNEV_TELEMETRY_DISABLED=1 / DO_NOT_TRACK=1.

    Patch Changes

    • 335399f: Publish a deterministic public docs bundle with matching manifest/schema sidecars and release checksums. Retain independently attested candidate artifacts, and hold drafts for protected immutable/latest finalization.
    Open Markdown source
    Open heading link