Spaces

Spaces is the structural WHERE of work in the YounndAI™ stack. The @younndai/lyt-spaces package provides the deterministic lyt-spaces CLI for creating, adopting, inspecting, indexing, and diagnosing complete Space roots.

Alpha: the CLI and its contracts may change while distributed team testing is underway.

Install

npm install --global @younndai/lyt-spaces@alpha
lyt-spaces --version
lyt-spaces --help

Spaces can work with a registered Lyt (Link Your Think™) vault through Lyt's public CLI, or against an explicitly supplied standalone vault fixture. Lyt remains the federated vault/Git substrate; it does not discover, invoke, or understand Spaces.

What it does

This package creates, adopts, scans, indexes, and diagnoses complete Space roots. A Space keeps its card, context, arcs, supporting documents, history, and insights together. arcs/ is useful scaffolding but is not required for an existing Space to remain valid.

lyt-spaces init --vault personal/ideas --path ba-example --slug ba-example --title "Example" --system-type build
lyt-spaces adopt --vault personal/ideas --path existing-project --slug ba-existing-project --title "Existing Project" --system-type project
lyt-spaces info ba-example --vault personal/ideas --json
lyt-spaces reindex --vault personal/ideas
lyt-spaces doctor --vault personal/ideas

For an isolated fixture without Lyt, replace --vault with both --vault-root <absolute-path> and --vault-rid <uuidv7>.

UUIDv7 input accepts both legacy compact and standard dashed text. New output is always normalized to lowercase RFC 9562 8-4-4-4-12 form; this changes representation, never identity.

New and adopted cards are schema v2 drafts with real UUIDv7 identity and no key material. adopt accepts either the exact historical bootstrap card or a plain existing folder; plain-folder adoption requires slug, title, and system type, creates only missing Space scaffolding, and leaves existing content untouched. A foreign or near-match space-card.md still fails closed. This package does not mint keys, activate Spaces, realize Mounts, create derived boards/inboxes/memory, or modify Lyt. Normal mode reads only the public lyt vault info --json surface to resolve a vault; all domain behavior remains package-local and identical in standalone mode.

License and trademarks

Copyright 2026 MARLINK TRADING SRL (YounndAI).

This package is source-available, not open source. It is licensed under the unmodified PolyForm Noncommercial License 1.0.0. Genuine noncommercial uses and the institutional uses named in that license are permitted automatically. Uses not already permitted by the public license may require separate commercial terms; contact [email protected] and see COMMERCIAL-LICENSE.md.

Changes and new works are limited to purposes permitted by the license. If you redistribute Spaces or a modified version, keep the PolyForm license (or its URL) and the applicable notices, as required by the license.

Access to this package does not include a hosted service, cloud account, support commitment, service level, or additional commercial rights.

YounndAI™ and Lyt (Link Your Think™) are trademarks of MARLINK TRADING SRL. The software license does not grant trademark rights. Forks and modified distributions must use a different name and branding; truthful nominative attribution remains permitted. See TRADEMARK.md and NOTICE.

Security reports should follow SECURITY.md. The current inbound-IP policy is described in CONTRIBUTING.md.