bc-atlas 0.5.0 → 0.7.0

package/.bca.example.json

@@ -1,32 +1,60 @@
 {
   "view": "project",
+  "projectRoot": ".",
   "direction": "right",
   "title": "Business Central architecture",
   "groupBy": "role",
-  "namespaces": ["Contoso.**"],
-  "exclude": ["**/test/**"],
+  "roleMappings": {
+    "Domain": [
+      "Contoso.Sales:table:*",
+      "Contoso.Sales:codeunit:*"
+    ]
+  },
+  "namespaces": [
+    "Contoso.**"
+  ],
+  "exclude": [
+    "**/test/**"
+  ],
   "moduleDepth": "auto",
   "folderDepth": 1,
   "includeUnresolvedCalls": false,
   "maxEdges": 500,
   "workflow": {
-    "entries": ["ProcessDocument"],
+    "entries": [
+      "ProcessDocument"
+    ],
     "depth": 8,
     "maxNodes": 100,
     "maxEdges": 250,
-    "edgeTypes": ["calls", "events", "writes"],
+    "edgeTypes": [
+      "calls",
+      "events",
+      "writes"
+    ],
     "phases": {
-      "Validation": ["Validate*"],
-      "Processing": ["Process*", "Post*"]
+      "Validation": [
+        "Validate*"
+      ],
+      "Processing": [
+        "Process*",
+        "Post*"
+      ]
     },
-    "stop": ["Finalize*"],
-    "collapse": ["*Telemetry*"]
+    "stop": [
+      "Finalize*"
+    ],
+    "collapse": [
+      "*Telemetry*"
+    ]
   },
   "details": false,
   "noExternal": false,
   "layout": "elk",
   "theme": 0,
-  "sourceUrl": "https://github.com/example/repo/blob/main/{file}#L{line}",
+  "sourceUrl": "https://github.com/example/repo/blob/{ref}/{file}#L{line}",
+  "sourceRef": "main",
+  "sourcePathPrefix": "apps/Sales",
   "forbiddenDependencies": [
     {
       "from": "Contoso.Core:**",
@@ -34,5 +62,25 @@
       "severity": "warning",
       "message": "Core must not depend on UI"
     }
-  ]
+  ],
+  "check": {
+    "failOn": "error",
+    "cycles": "warning",
+    "maxFanIn": 25,
+    "maxFanOut": 25
+  },
+  "report": {
+    "outputDir": "docs/atlas",
+    "views": [
+      "project",
+      "module",
+      "data",
+      "contracts",
+      "events",
+      "ui"
+    ],
+    "format": "svg",
+    "codegraph": false,
+    "json": false
+  }
 }

package/CHANGELOG.md

@@ -0,0 +1,137 @@
+# Changelog
+
+All notable changes to BC Atlas will be documented here. The format is based on
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project
+follows [Semantic Versioning](https://semver.org/).
+
+## Unreleased
+
+## 0.7.0 - 2026-10-04
+
+### Added
+
+- Documentation website on GitHub Pages
+  (https://schulzoli.github.io/BC-Atlas/), built with VitePress from the
+  repository Markdown, with search, a sidebar by feature area, and the
+  generated examples.
+- `bca setup`: guided setup of features, Git hooks (Husky or plain Git),
+  pipelines (GitHub Actions or Azure Pipelines), cron schedules, and sync of
+  generated files, as a terminal wizard or with `--yes`.
+- `bca setup plan` and `bca setup apply`: the same setup as detectable facts,
+  questions with recommendations, and a validated, idempotent apply with
+  `--dry-run`.
+- `bca setup --editor vscode`: VS Code tasks for the local loop: health check
+  with findings in the Problems panel, report and docs builds, hook dry runs,
+  a live architecture diagram, and the setup wizard. Existing tasks are kept.
+- `bca setup agent --agent claude|copilot|cursor`: a `/bca-setup` command that
+  lets the user's AI agent guide the setup through the CLI.
+- `bca run --trigger pre-commit|pre-push|ci|schedule`: one entry point for
+  every trigger, configured in the new `automation` section of `.bca.json`,
+  with `verify` and `stage` sync and `docs`, `codegraph`, and `diagrams` tasks.
+- A GitHub Action (`uses: SchulzOli/BC-Atlas@v0.7.0`) with `outputs` and
+  `passed` outputs.
+- MCP tools `bc_atlas_setup_plan`, `bc_atlas_setup_apply`, `bc_atlas_run`, and
+  `bc_atlas_update_check`.
+- Update cycle: interactive commands show a notice when a newer version is
+  available (checked at most once a day in the background, off in CI, hooks,
+  `bca run`, and JSON output, or with `BCA_NO_UPDATE_CHECK`).
+- `bca update`: release notes since the installed version, a confirmed update
+  of the global or project installation, and regenerated hooks, VS Code tasks,
+  pipelines, and agent commands. `--check` exits with `1` when an update exists.
+- `bca setup --updates dependabot`: Dependabot pull requests for new
+  `bc-atlas` versions; `bca setup apply --from-config` reproduces an existing
+  setup.
+- With a `package.json` that declares `bc-atlas`, generated pipelines and VS
+  Code tasks use that version (`npm ci`, `npx --no-install bca`).
+
+### Added
+
+- `bca docs generate` presents scenarios in the structure of an OASIS DITA 1.3
+  task topic (prerequisites, steps, step results, result, related links).
+  The AL tags are unchanged.
+- `--export markdown,html,dita,ado-csv`: Markdown, one self-contained HTML
+  file, DITA 1.3 task topics with a map, and an Azure DevOps Test Plans CSV.
+- `--as testcase`: test case specification with preconditions, an
+  action/expected result/pass-fail table, and a sign-off block.
+- `--app`: real page, field, part, and action captions and tooltips from the
+  app's AL source, plus page and action coverage in the index.
+- `--language`: German and English wording; captions and tooltips from the
+  app's XLIFF translations.
+- Use-case pages per `[FEATURE]`, a journey diagram of scenario links, and
+  indexes by page and permission set.
+- `[THEN]` between two `[WHEN]` phases becomes the result of that phase.
+- The MCP tool `bc_atlas_docs_generate` accepts formats, mode, app, and
+  language.
+- Generated example documentation in `examples/docs`.
+
+### Changed
+
+- Instructions follow Business Central help conventions ("Choose the 🔍
+  icon, enter ...", "In the **Field** field, enter ...", "Choose the
+  **Action** action."). Scenarios with one `[WHEN]` phase list their
+  instructions as top-level steps; repeated blocks become sub-steps.
+- Node.js 22 or later is required; Node.js 20 reached end of life in April 2026.
+  The Docker image and generated pipelines use Node.js 24.
+- CI runs once per pull request instead of twice, starts with one fast check
+  job, then tests Node.js 22 and 24 on Linux and Node.js 24 on Windows.
+
+## 0.6.0 - 2026-10-04
+
+### Added
+
+- `bca init` creates a `.bca.json` tailored to the project: app title, excluded
+  test folders, and source links for GitHub, GitLab, or Azure DevOps remotes.
+- `bca report` writes a static Markdown architecture report with an
+  at-a-glance table, diagrams for six views, the health summary, and optional
+  object catalog and JSON model.
+- `bca check` evaluates architecture health (diagnostics, forbidden
+  dependencies, cycles, fan-in/fan-out hot spots, orphans, unresolved
+  references) with `--fail-on` levels and text, JSON, or Markdown output.
+- `bca mcp` starts the MCP server; new MCP tools `bc_atlas_check` and
+  `bc_atlas_report`.
+- `bca help <command>` and per-command `--help` with grouped options and
+  examples; `bca` without arguments shows all features by area.
+- Feature areas and views in the `bca capabilities` contract.
+- `check` and `report` sections in `.bca.json`.
+- Example report in `examples/report`, regenerated by `npm run examples`.
+- Public contribution, support, conduct, and security policies.
+- Reproducible example project, generated diagrams, and feature screenshots.
+
+### Changed
+
+- Every command is defined once in `src/capabilities.js`; help, parsing, enum
+  validation, the JSON contract, and generated docs derive from it.
+- Commands only accept their own options and validate enum values; invalid
+  usage exits with code `2`, failed operations and checks with `1`.
+- `[app-root]` defaults to the current directory.
+- Clearer errors for missing paths, empty results, and unknown commands.
+- Several views of one project share a single parse.
+- Documentation reorganized by feature area; repository URLs point to
+  `SchulzOli/BC-Atlas`.
+- The npm package ships only runtime files.
+- Updated `@modelcontextprotocol/server`, `zod`, and `web-tree-sitter` (0.27).
+
+### Removed
+
+- The local web Control Center: `bca serve`, `bca docs serve`, and the
+  `marked` and `dompurify` dependencies. Use `bca report` for a browsable
+  overview.
+
+### Fixed
+
+- Rendering more than one SVG in a single process could exit early because the
+  D2 worker was unreferenced between renders.
+- `bca-mcp` did not start when invoked through an npm bin symlink.
+- `codegraph` no longer deletes a non-empty output directory that it did not
+  generate.
+
+## 0.5.0 - 2026-07-30
+
+### Added
+
+- Project, module, object, data, call, boundary, contracts, events, UI, and
+  workflow diagram views.
+- D2, JSON, and WebAssembly-rendered SVG output.
+- AL UI-test-to-Markdown documentation generation.
+- Configuration, watch mode, diagnostics, dependency policies, and Docker
+  support.

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 BC Atlas contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 BC Atlas contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.