v0.50.0

Release Notes

Historical archive: workspai is the current package and command, with
wspai as an optional alias. Older entries intentionally preserve historical
rapidkit commands and .rapidkit paths. Use the CLI README and
Command Reference for current usage.

Latest Release: v0.50.0 (July 27, 2026)

Project-Native Workspace Intelligence

This minor release makes every registered project a reliable entry point into
its canonical workspace. Workspai now keeps machine-local resolution private,
publishes a portable bounded project lens for humans and agents, connects
Doctor findings to current graph evidence, and keeps downstream intelligence
artifacts synchronized after project lifecycle changes.

What's New:

• Work from an adopted or created project

  • Added a validated, gitignored machine-local workspace binding.
  • Added portable project grounding and
    .workspai/reports/project-context-agent.json.
  • Workspace-aware commands launched from a project resolve the governing
    workspace automatically.

• Deeper Doctor and Graph integration

  • Doctor reports evidence-backed project roots, structural paths, impact
    candidates, proofs, and verification targets.
  • Diagnosis distinguishes structural reachability from proven runtime
    causality and reports stale, missing, or mismatched graph evidence.
  • Model and Graph artifacts remain an atomic, hash-bound set with the Model
    as the canonical source of truth.

• Clearer creation and ingestion

  • Interactive Create can scaffold new software or ingest a local path, Git
    repository, project archive, or workspace archive through versioned plans.
  • The picker groups kits as Backend, Frontend, Desktop, and Extension.
  • Added Rust/Axum, Tauri, Electron Forge, VS Code Extension, and Laravel
    flows with latest-stable upstream policy and recorded resolution evidence.
  • Turning the current folder into a workspace is foundation-only and does not
    install Python or Poetry.

• Governed project coverage and archives

  • Added project coverage --run --target <percent> --strict --json.
  • Added explicit workspace archive capability, manifest, verification,
    diagnosis, import, and hydration contracts.
  • Successful create/adopt/import/connect/sync flows refresh the Model, Graph,
    project lenses, report index, grounding, and supported agent surfaces.

• Focused Help and documentation

  • Root Help now explains the shortest lifecycle and canonical
    Model-to-Graph architecture instead of repeating the complete catalog.
  • Command-specific Help stays scoped, while workspai commands --json
    provides exhaustive machine-readable discovery.
  • Main READMEs explain project-native usage and the new capabilities in plain
    language without moving detailed reference material into the quickstart.

Breaking changes: None.

Verification:

• Full CLI suite: 2,218 tests passed across 205 test files; 8 tests remain
  explicitly skipped.
• New suites cover project entry/resolution, portable grounding, graph-aware
  Doctor, ingestion, archives, categorized kits, latest-stable policy,
  project coverage, and Model/Graph artifact atomicity.
• Contract, artifact, documentation, TypeScript, lint, format, package, and
  cross-platform invariants remain part of release validation.
• Enterprise prepack creation and registry smoke runs in an isolated home and
  cannot alter the publisher's real Workspai registry.

Upgrade:

npm install -g workspai@0.50.0
workspai --version
workspai workspace intelligence run --for-agent generic --strict --json

Full Release Notes

v0.49.0

Release Notes

Historical archive: workspai is the current package and command, with
wspai as an optional alias. Older entries intentionally preserve historical
rapidkit commands and .rapidkit paths. Use the CLI README and
Command Reference for current usage.

Latest Release: v0.49.0 (July 25, 2026)

Live, Contract-Backed Workspace Graph Updates

This minor release gives IDEs and other long-running consumers a stable way to
follow Workspace Knowledge Graph changes as they happen. It also makes
existing-project onboarding shorter, completes the repository's move to
Chistiq, and prevents broken GitHub Release links from being published again.

What's New:

• Revision-safe graph streaming

  • Added the public workspace-graph-stream.v1 event contract.
  • Added workspace watch --graph-stream --json for an initial graph snapshot
    followed by bounded entity, relation, proof, provider, quality, and
    diagnostic deltas.
  • Every delta carries base and current revisions plus model and graph hashes,
    allowing consumers to detect gaps and request a complete resynchronization.

• One model, live derived views

  • The canonical Workspace Model remains the source of truth.
  • The watch engine passes its authoritative in-memory model to the
    graph-stream publisher; the publisher derives the matching graph revision
    without creating a competing model or persistence boundary.
  • Runtime, published-contract, extension-compatibility, and artifact
    inventories expose the same stream capability.

• Faster existing-project onboarding

  • Running workspai adopt . from a project creates or reuses the minimal
    default workspace when needed.
  • The command prints the exact workspace shell step and the canonical
    intelligence command to run next.
  • Documentation now starts with this direct path and uses generic for
    vendor-neutral agent context.

• Chistiq ownership and release integrity

  • Repository, issue, discussion, contribution, package, and image references
    now point to Chistiq.
  • Added a repository-wide brand contract.
  • Added GitHub Release body generation from the exact versioned source file.
  • Release validation now rejects relative, noncanonical, tag-mismatched, or
    missing-current-version links before publishing.

Breaking changes: None.

Verification:

• Full CLI suite: 2,088 tests passed across 194 test files; 8 tests remain
  explicitly skipped.
• Contract tests validate all graph-stream event families and revision rules.
• Publisher tests validate snapshots, deterministic hash-linked deltas, and
  stable proof comparison.
• Release tests validate tag-bound GitHub bodies and fail-closed aggregate
  links.
• Mirrored command and contract inventories expose the same graph-stream
  capability to CLI, CI, IDE, and extension consumers.

Upgrade:

npm install -g workspai@0.49.0
workspai --version
workspai workspace watch --graph-stream --json

Full Release Notes

v0.48.0

Release Notes

Historical archive: workspai is the current package and command, with
wspai as an optional alias. Older entries intentionally preserve historical
rapidkit commands and .rapidkit paths. Use the CLI README and
Command Reference for current usage.

Latest Release: v0.48.0 (July 22, 2026)

Measurable Workspace Intelligence and Portable Graph Interchange

This minor release makes Workspace Intelligence outcomes easier to measure,
exchange, and consume without weakening Workspai's evidence boundaries. Teams
can record retrieval and model-usage observations, compare governed evaluation
runs, and export the model-bound Knowledge Graph to standard ecosystem formats.

What's New:

• Governed evaluation workflow

  • Added workspace eval init, record, status, report, and compare.
  • Added versioned contracts for evaluation state, comparisons, and
    model-usage observations.
  • Kept token and payload claims scoped to recorded evidence instead of
    presenting fixture results as universal model savings.

• Portable and queryable graph

  • Added JSON-LD, GraphML, and GEXF exports alongside bounded search, typed
    entities, evidence lookup, path traversal, benchmarks, and change overlays.
  • Bound every representation to the canonical Workspace Model revision.
  • Published Graph and Evaluation capabilities through runtime, architecture,
    artifact, MCP, IDE, CI, and agent-facing contracts.

• Documentation and contract integrity

  • Reworked the root and CLI documentation around user goals, the canonical
    lifecycle, generated evidence, and consumer workflows.
  • Added a documentation content contract and stronger automated drift checks.
  • Clarified that the Model is the system source of truth and Graph is its
    evidence-backed, deterministic derived representation.

• Runtime correctness

  • Fixed validation of the documented graph search --limit and
    graph overlay --from options.
  • Made --skip-install avoid Maven, Go, and .NET host-tool probes so offline
    scaffolds remain deterministic across Linux, macOS, and Windows.
  • Pinned registry paths for the lifetime of each locked transaction so
    concurrent Windows workers cannot redirect or lose a registration.
  • Replaced clock-derived demo-kit fixture paths with atomic temporary
    directories and isolated template assertions from Git setup, removing a
    Windows coverage race while keeping a bounded timeout for the 28-file case.
  • Completed the machine-readable Graph command and Evaluation artifact
    inventories.

Breaking changes: None.

Verification:

• 2,076 CLI tests passed across 191 test files; 8 tests remain explicitly
  skipped.
• TypeScript, ESLint, documentation validation, README command smoke, generated
  contract checks, shared-contract parity, and diff hygiene passed.
• A real isolated workspace exercised Model/Graph generation, bounded search,
  all three portable graph exports, Evaluation init/status/report, and the
  strict unified Workspace Intelligence runner.

Upgrade:

npm install -g workspai@0.48.0
workspai workspace intelligence run --for-agent codex --strict --json
workspai workspace graph jsonld --output .workspai/reports/workspace-graph.jsonld
workspai workspace eval status --json

Full Release Notes

v0.47.0

Release Notes

Historical archive: workspai is the current package and command, with
wspai as an optional alias. Older entries intentionally preserve historical
rapidkit commands and .rapidkit paths. Use the CLI README and
Command Reference for current usage.

Latest Release: v0.47.0 (July 21, 2026)

Evidence-Backed Workspace Knowledge Graph

This minor release makes the current Workspace Model directly useful for
proof-backed retrieval across projects, code, packages, APIs, infrastructure,
delivery, documentation, decisions, tests, and ownership. The graph is derived
deterministically from the canonical model and bound to its exact SHA-256
revision.

What's New:

• Queryable workspace knowledge

  • Added bounded graph search, typed entity/evidence/path queries, complete
    portable emission, change/PR overlays, and retrieval payload benchmarks.
  • Added stable identities, proof paths, derivation/trust metadata, quality
    diagnostics, secret filtering, and deterministic query indexes.

• One graph revision for every consumer

  • The Model stage now publishes workspace-model.json and
    workspace-knowledge-graph.json atomically.
  • CLI, unified runner, context, Agent Sync, MCP, IDE capability discovery, CI,
    and workspace contract graph output consume the same model-bound revision.
  • Agents now start with bounded search and proof traversal instead of loading
    the complete graph into every prompt.

• Versioned public contracts

  • Added Knowledge Graph, change overlay, bounded search, and token-efficiency
    schemas.
  • Expanded the published catalog, artifact registry, runtime command surface,
    architecture contract, and semantic conformance gates.

• Clearer user documentation

  • Added a two-minute graph guide, reproducible benchmark methodology,
    Agent/IDE/MCP workflow, and plain-language glossary.
  • Separated deterministic Workspace Intelligence from the optional embedding
    module recommender and removed unqualified AI score/cost claims.

• Security and canonical paths

  • Updated vulnerable brace-expansion and fast-uri dependencies to their
    patched releases; the final online npm audit reports zero vulnerabilities.
  • Canonicalized bridged project metadata into .workspai while retaining
    legacy read compatibility.

Breaking changes: None.

Verification:

• 2,062 CLI tests passed with 8 explicit skips.
• All 11 runtime-conformance stages and required artifacts passed.
• Documentation links, examples, drift guard, README smoke, and live command
  surface parity passed.
• The measured 16-project fixture produced 1,738 entities, 2,244 relations, and
  2,106 portable proofs; fixture statistics are not universal product claims.

Upgrade:

npm install -g workspai@0.47.0
workspai workspace intelligence run --for-agent codex --strict --json
workspai workspace graph search "authentication endpoint" --limit 12 --json

Full Release Notes

v0.46.0

Release Notes

Historical archive: workspai is the current package and command, with
wspai as an optional alias. Older entries intentionally preserve historical
rapidkit commands and .rapidkit paths. Use the CLI README and
Command Reference for current usage.

Latest Release: v0.46.0 (July 18, 2026)

Contract-Backed Unified Workspace Intelligence Runner

This minor release turns the complete Workspace Intelligence lifecycle into a
single governed execution surface. Runtime behavior, ordered stage evidence,
artifacts, contracts, CLI help, CI guidance, and agent grounding now share the
same canonical source of truth.

What's New:

• Unified intelligence execution

  • Added workspace intelligence run for the mandatory sync-through-
    remediation lifecycle.
  • Added deterministic per-stage status, command, timing, artifact, and failure
    evidence for humans, CI systems, IDEs, portals, and agents.

• Semantic runner contract

  • Added the versioned workspai-workspace-intelligence-run-v1 report contract.
  • Linked the report through the runtime registry, artifact registry, published
    contract catalog, and producer-command inventory.
  • Added semantic enforcement for canonical stage ordering and blocking
    outcomes in addition to JSON Schema validation.

• Transactional project lifecycle

  • Added rollback protection for create, adopt, import, register, and mirror
    operations.
  • Hardened metadata path safety, registry consistency, archives, platform
    probes, runtime adapters, and polyglot project generators.
  • Added Windows-safe lifecycle journal durability handling and concurrent
    journal initialization recovery without weakening atomic writes.

• Release-gate integrity

  • Repaired the npm tree used by CycloneDX SBOM generation so Nunjucks, Tsup,
    ESLint, chokidar, and minimatch resolve without invalid nodes.
  • Preserved the 80% aggregate coverage target and made test, lint, and audit
    collection fail closed.
  • Expanded the suite to 2,042 passing tests, including targeted contract,
    Workspace Intelligence, Doctor, recovery, archive, runtime adapter, and
    platform-boundary coverage.
  • Verified 81.66% statement, 71.27% branch, 91.95% function, and 82.38% line
    coverage; the official metrics gate reports 82%.
  • Made test:coverage publish a machine-readable Vitest result for metrics,
    removing the duplicate suite execution and fragile console parsing that
    could report a passing run as invalid.
  • Hardened Linux, macOS, and Windows parity for project-local Python venvs,
    pip metadata, Doctor PowerShell remediation guards, Go adapter Makefile
    routing, npm runner paths and environment keys, and filesystem mode tests.

• Documentation and runtime alignment

  • Aligned CLI documentation, help, contracts, artifact catalogs, CI examples,
    and agent-grounding material around the mandatory lifecycle.
  • Removed accidental Python-version pins from config examples. Python 3.10
    remains the supported minimum, with automatic newer-version detection and
    optional explicit pins for reproducible CI.

Breaking changes: None.

Verification:

• Monorepo checks and CLI build/test gates.
• Generated/shared contract drift and documentation validation.
• Unified runner contract and CLI-chain suites.
• Lifecycle transaction, frontend execution, Python-engine state, registry,
  mirror, archive, runtime adapter, and package-publish suites.
• 2,042 tests passed, 8 tests were explicitly skipped, ESLint reported zero
  errors or warnings, and npm audit reported zero vulnerabilities.

Upgrade:

npm install -g workspai@0.46.0
workspai workspace intelligence run --for-agent codex --json

Full Release Notes

v0.45.0

Release Notes

Latest Release: v0.45.0 (July 15, 2026)

Contract-Backed Live Command Inventory and Release-Gate Consistency

This minor release makes the installed CLI command tree a verifiable source of
truth. Command discovery, published contracts, artifact producers, help output,
documentation, and Workspace Intelligence runtime behavior are now checked
against the same live inventory.

What's New:

• Live command inventory

  • Added workspai-cli-runtime-command-inventory-v1, generated from the live
    Commander tree and exposed by workspai commands --json.
  • Added drift gates for all registered and declared top-level/scoped command
    paths, including manual workspace dispatch and Core-backed ownership.

• Command, artifact, and contract linkage

  • Runtime command-surface contracts now include command documentation,
    package ownership, artifact schemas, and producer command mappings.
  • Command documentation publishes canonical argv and structured stdin,
    output-media, and exit-semantics metadata where the command requires it.
  • Workspace feedback is registered as a producer of the governed
    Workspace Intelligence history artifact.
  • Shared-contract generation and enterprise prepack now verify and publish the
    runtime inventory snapshot.

• Workspace Intelligence usability

  • workspace --help now enumerates every action family instead of hiding the
    manual dispatcher surface.
  • Feedback documentation now includes the required stdin JSON payload and
    history artifact behavior.
  • DOT and Mermaid graph renderers are explicitly documented as raw-text
    outputs; structured consumers use graph emit/explain JSON.
  • Contract verification, graph, watch, feedback, and MCP are now classified
    consistently as Workspace Intelligence capabilities for portal and IDE use.

• Gate correctness

  • Warning-only pipelines exit successfully by default and become blocking
    when --strict is supplied.
  • Failed pipeline stages remain blocking in both modes.

Breaking changes: None.

Verification:

• 45/45 installed command paths passed help smoke tests.
• Three real workspaces completed the Workspace Intelligence and governance
  loops; 66 generated artifact/schema validations passed.
• Workspace archives passed export, inspect, verify, doctor, hydrate, and
  project archive/restore checksum round trips.
• 1,776 tests were covered across two shards; 11 runtime steps, 15 artifacts,
  and 12 adversarial groups passed.
• Windows registry invariants passed and npm audit reported zero vulnerabilities.

Upgrade:

npm install -g workspai@0.45.0
npx wspai commands --json

Full Release Notes

v0.44.0

Release Notes

Latest Release: v0.44.0 (July 14, 2026)

Workspace Intelligence Contract Architecture and Stable CLI Gates

This minor release hardens Workspai's Workspace Intelligence foundation:
canonical contracts, command discovery, runtime conformance, archive safety,
agent grounding, and CLI gate behavior now align around the same source of
truth.

What's New:

• Workspace Intelligence contracts

  • Added first-class architecture and chain contracts for model, snapshot,
    diff, impact, contract verify, readiness, verify, context, agent sync, and
    explainability.
  • Published generated contracts for runtime command surfaces, command
    capabilities, operation result envelopes, version discovery, and contract
    catalogs.

• Runtime and artifact conformance

  • Added runtime conformance and adversarial validation checks for Workspace
    Intelligence command/artifact alignment.
  • Expanded generated schema coverage across autopilot, doctor, infra,
    product, workspace list/sync/watch/cache, archive, and Workspace
    Intelligence evidence.

• Archive and recovery hardening

  • Added ZIP64/streaming archive capability contracts and stable archive
    operation result schemas.
  • Hardened snapshot, archive inspect, verify, doctor, hydrate, and failure
    envelopes for large workspace workflows.

• CLI gate stability

  • readiness now supports --workspace <path>.
  • pipeline --no-agent-sync now correctly skips agent grounding writes.
  • workspace impact and workspace verify now accept
    --include-paths, --include-evidence, and --scan-depth <count>.
  • Windows artifact writes now tolerate runner-level fsync EPERM so
    workspace init, contract sync, and evidence writes do not fail after the
    payload has already been written.

• Package alignment

  • Bumped the monorepo root, workspai, and wspai to 0.44.0.
  • Updated the wspai alias dependency to workspai@0.44.0.

Breaking changes: None.

Verification:

• corepack npm run check
• corepack npm --workspace workspai run contracts:check
• corepack npm --workspace workspai run check:workspace-intelligence-runtime
• corepack npm --workspace workspai run check:workspace-intelligence-adversarial
• corepack npm --workspace workspai run docs:validate
• corepack npm test
• Real workspace smoke tests across my-new-wsp, my-works, my-workspace,
  and my-workspoly

Upgrade:

npm install -g workspai@0.44.0
npx wspai --help

Full Release Notes

v0.43.1

Release Notes

Latest Release: v0.43.1 (July 9, 2026)

Workspai Debug Alias, Doctor Repair, and Workspace Intelligence Chain Alignment

This patch release tightens the Workspai monorepo package surface after the
initial workspai/wspai publish, and hardens the Doctor and Workspace
Intelligence chain before the first stable Workspai CLI release.

What's New:

• Workspai-native debug environment

  • Added WORKSPAI_DEBUG_ARGS=1 for CLI argument and bridge diagnostics.
  • Preserved the legacy RAPIDKIT_NPM_DEBUG_ARGS=1 fallback for existing local
    debugging workflows.

• Release consistency

  • Keeps the private monorepo version, workspai package version, and wspai
    alias package version aligned on 0.43.1.
  • Keeps the wspai package dependency pinned to the matching workspai
    version.

• Doctor and repair artifact integrity

  • doctor project --fix now writes project-scope fix evidence under the
    project .workspai/reports directory instead of overwriting workspace-level
    Doctor fix evidence.
  • Doctor fix/apply flows now return failing exit codes when a fix attempt
    remains blocked or unresolved, including local-profile runs.
  • Python dependency sync repair is guarded by default and emits deterministic
    guidance unless explicit dependency-install opt-in is provided.

• Workspace Intelligence chain validation

  • Verified the full workspace chain across minimal and polyglot test
    workspaces: sync, contract verify, model, context, agent sync, graph, diff,
    impact, verify, trace, explain, run, share, export, and feedback history.
  • Confirmed wspai delegates to the canonical workspai CLI command surface.
  • Updated workspace E2E workflows to locate managed workspaces under
    ~/.workspai/workspaces while retaining legacy RapidKit fallbacks.
  • Improved Workspace Run diagnostics so Python wrapper failures such as
    No module named pytest are classified as setup failures instead of
    unknown.

Breaking changes: None.

Verification:

• corepack npm --workspace workspai run typecheck
• corepack npm --workspace workspai run lint
• corepack npm --workspace workspai run format:check
• corepack npm --workspace workspai run build
• corepack npm --workspace workspai run smoke:enterprise-package
• corepack npm --workspace wspai run smoke
• corepack npm --workspace workspai run test -- src/__tests__/index.test.ts src/__tests__/package-publish-contract.test.ts
• corepack npm --workspace workspai run test
• corepack npm --workspace workspai run test -- src/__tests__/doctor.test.ts
• corepack npm --workspace workspai run test -- src/__tests__/doctor-canary-matrix.test.ts
• corepack npm --workspace workspai run test -- src/__tests__/workspace-run.test.ts

Upgrade:

npm install -g workspai@0.43.1
npx wspai --help

Full Release Notes