project-map 0.1.2

= project-map :toc: preamble

OpenShellOrg library and CLI for project-type detection and file-role grouping.

• Library (project-map) — D API consumed by DevCentr, GUIs, and CLIs (root dub.sdl, sources in lib/source)
• CLI (lsgrouped) — list a directory with entries grouped by role (not a drop-in for ls)
• Profiles — SDL corpus under profiles/stacks and profiles/roles
• Nushell module — modules/nu/lsgrouped.nu

Certification mark: {OSO} Certified - opensh.org

== Build

dub build

CLI:

cd apps/lsgrouped && dub build

== CI

GitHub Actions workflow ci.yml builds the library (repo root) and the CLI (apps/lsgrouped/) on pushes, PRs, and manual dispatch.

== Publish to DUB registry

Official dub has no publish command. Use https://github.com/dlang-supplemental/dub-publish[dlang-supplemental/dub-publish] to register with https://code.dlang.org[code.dlang.org].

Registered package name: `project-map` (root recipe).

dub-publish register \ --url https://github.com/openshellorg/project-map \ --package project-map \ --ignore-fork

CI workflow dub-publish runs on v* tags and workflow_dispatch (secrets: DUB_REGISTRY_USER, DUB_REGISTRY_PASSWORD).

== Docs

• link:docs/modules/ROOT/pages/index.adoc[Overview]
• link:CHANGELOG.adoc[Changelog]

== Related

• https://opensh.org/[opensh.org] (OSO public home)
• DevCentr consumes this library for workspace stack recognition