safetygence-mad 0.1.0__tar.gz

safetygence_mad-0.1.0/.gitignore

@@ -0,0 +1,11 @@
+.pixi/*
+!.pixi/config.toml
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.idea/
+/dist/
+/output/
+/templates/*/output/

safetygence_mad-0.1.0/.gitlab-ci.yml

@@ -0,0 +1,44 @@
+image: ghcr.io/prefix-dev/pixi:0.80.0@sha256:4cb073300e2c5eaee287bb3bcbadd3ddb7bce4ce36b27c41a19aad74c297c2f3
+
+stages:
+  - test
+  - publish
+
+verify:
+  stage: test
+  before_script:
+    # Pixi needs Git to fetch source packages; this minimal image omits it.
+    - apt-get update && apt-get install -y --no-install-recommends git
+  script:
+    - pixi run --locked lint
+    - pixi run --locked test
+    - pixi run --locked package
+    - pixi exec --spec uv==0.12.19 -- uvx --from twine==7.0.0 twine check --strict output/packages/*.whl output/packages/*.tar.gz
+    - pixi run --locked python -m venv "$HOME/.cache/mad-ci/wheel"
+    - pixi exec --spec uv==0.12.19 -- uv pip install --python "$HOME/.cache/mad-ci/wheel/bin/python" output/packages/*.whl
+    - '"$HOME/.cache/mad-ci/wheel/bin/python" -I ci/check_installation.py --command "$HOME/.cache/mad-ci/wheel/bin/mad"'
+    - pixi exec --spec uv==0.12.19 -- uv pip install --reinstall --python "$HOME/.cache/mad-ci/wheel/bin/python" output/packages/*.tar.gz
+    - '"$HOME/.cache/mad-ci/wheel/bin/python" -I ci/check_installation.py --command "$HOME/.cache/mad-ci/wheel/bin/mad"'
+    - pixi publish --target-dir output/packages --build-dir "$HOME/.cache/mad-ci/build"
+    - PIXI_HOME="$HOME/.cache/mad-ci/global" pixi global install --git "file://$CI_PROJECT_DIR" --rev "$CI_COMMIT_SHA"
+    - '"$HOME/.cache/mad-ci/global/envs/safetygence-mad/bin/python" -I ci/check_installation.py --command "$HOME/.cache/mad-ci/global/bin/mad"'
+  artifacts:
+    paths:
+      - output/packages/
+    expire_in: 1 week
+
+publish-pypi:
+  stage: publish
+  needs:
+    - job: verify
+      artifacts: true
+  rules:
+    - if: '$CI_PROJECT_PATH == "exida-oss/stig/mad" && $CI_COMMIT_TAG =~ /^v[0-9]+\.[0-9]+\.[0-9]+$/ && $CI_COMMIT_REF_PROTECTED == "true"'
+  environment:
+    name: pypi
+    url: https://pypi.org/project/safetygence-mad/
+  id_tokens:
+    PYPI_ID_TOKEN:
+      aud: pypi
+  script:
+    - pixi exec --spec uv==0.12.19 -- uv publish --trusted-publishing always output/packages/*.whl output/packages/*.tar.gz

safetygence_mad-0.1.0/AGENTS.md

@@ -0,0 +1,27 @@
+# MAD
+
+Read README.md for the public command and project contracts.
+
+- The command is `mad`, the distribution is `safetygence-mad`, and project branding
+  belongs to SAFETYGENCE. Keep the actual hosting URL when linking the repository.
+- Keep a single Typer API for documents and presentations.
+- Use `report` and `slides` as project types and bundled template names. Keep
+  paths as operands and type, format, provider and behavior choices as options.
+- Documents use Quarto and its embedded Typst; never add a LaTeX backend or a
+  second Typst installation.
+- Authored projects contain sources and configuration. All environments,
+  dependencies, browser binaries and intermediates belong in shared user caches.
+- Keep the tool's location independent from the selected authored project's path.
+- Preserve source edits and previously released artifacts. Clean only MAD-owned
+  generated output; publishing uses a temporary worktree and normal Git pushes.
+- Keep public templates neutral and synthetic. Never import private customer
+  content, company artwork without suitable redistribution rights, or credentials.
+- Pin native dependencies in pixi.toml/pixi.lock and Node dependencies in the
+  bundled Slidev package manifest and pnpm lockfile.
+- Run `pixi run --locked lint` and `pixi run --locked test`. For renderer, path,
+  staging or dependency changes, also run `pixi run --locked integration` and
+  inspect real HTML/PDF renders. Check packaging after resource changes.
+- Preview releases do not promise API stability; maintain one coherent
+  implementation and update its callers, templates and documentation together.
+- Published release tags and package versions are immutable. Use a new version
+  for changes to a published distribution.

safetygence_mad-0.1.0/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+## 0.1.0 — 2026-10-16
+
+First public preview of MAD — Markdown Authoring and Delivery, by SAFETYGENCE.
+
+- One CLI for Markdown reports and Vue presentations: create, build, serve,
+  publish, clean and manage templates.
+- Professional PDF documents through Quarto and its embedded Typst, with HTML
+  output from the same project.
+- Slidev/Vue presentations as HTML slides and PDF exports, with single-file or
+  chapter-based sources and reusable components.
+- Pixi-managed runtimes and shared caches outside authored projects; no
+  project-local virtual environments or Node installations.
+- Incremental HTML/PDF builds with input and output tracking, explicit cleanup,
+  and preservation of the last successful output when rendering fails.
+- Local and Git templates, configurable metadata, version history and a common
+  `src/` structure for both project types.
+- GitLab Pages and GitHub Pages publishing with configurable deployment branches
+  and paths.
+- Installation directly from a Git tag with Pixi; Python wheel and source archive
+  distributed as `safetygence-mad`, exposing the `mad` command.
+
+Rendering currently supports Linux x86-64. macOS and native Windows renderer
+lockfiles are not yet supported. Live preview rebuilds production HTML after
+changes; it does not provide Slidev's editor or Vue component hot replacement.
+External URLs and host fonts are outside the local build dependency graph.

safetygence_mad-0.1.0/LICENSE

@@ -0,0 +1,14 @@
+Zero-Clause BSD
+
+Copyright (C) 2026 SAFETYGENCE
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

safetygence_mad-0.1.0/NOTICE

@@ -0,0 +1,14 @@
+MAD source code and original generic template adaptations: Copyright 2026 SAFETYGENCE, licensed under 0BSD (LICENSE).
+
+Bundled third-party assets:
+
+* templates/report/src/ieee.csl is the IEEE citation style from the Citation
+  Style Language styles project (https://github.com/citation-style-language/styles).
+  Its author and contributor list, attribution, and Creative Commons
+  Attribution-ShareAlike 3.0 license URL are preserved in its <info> element.
+  The citation style has not been modified.
+* templates/slides/src/fonts contains Manrope fonts. Their copyright and
+  SIL Open Font License 1.1 text are in that directory's OFL.txt.
+
+Quarto, Typst, Slidev, Vue, Chromium and other dependencies are downloaded by the
+locked toolchain. They remain subject to their respective upstream licenses.