oss-pulse 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+## 0.1.0 - 2026-07-08
+
+Initial public release.
+
+- Added `oss-pulse scan` for local git repository health reports.
+- Added Markdown and JSON output formats.
+- Added maintainer readiness checks for README, license, contribution guide, issue and pull request templates, security policy, CI workflow, release workflow, changelog, funding metadata, contributor activity, code of conduct, and recent commits.
+- Added `--fail-under <score>` for CI score gates.
+- Added `--summary-only` for compact Markdown summaries.
+- Added GitHub Actions usage docs and composite action metadata.
+- Added strict TypeScript checks, Biome linting, and Node CLI tests.
+- Improved unsupported format errors with the accepted `json` and `markdown` values.
+- Added README examples for local audits and GitHub pull request summaries.
+- Added JSON report schema documentation for automation consumers.
+- Added fixture-based integration tests for complete, sparse, and nested repository scans.
+- Added public repository case studies for `octocat/Hello-World` and `sindresorhus/is`.
+- Added good first issue template detection for starter contribution readiness.
+- Split report scoring rules out of the report builder to keep the core report assembly small.
+- Added `--format release-notes` for paste-ready maintainer release note drafts.
+- Added `--format contributor-onboarding` for first-time contributor guidance.
+- Added `--format triage-suggestions` for issue and pull request triage guidance.
+- Hardened GitHub Action metadata and README input documentation.
+- Added `--format sarif` for GitHub code scanning and security dashboard integrations.
+- Added `--format github-annotations` for GitHub workflow annotations in CI logs.

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,7 @@
+# Code of Conduct
+
+This project follows the Contributor Covenant Code of Conduct.
+
+Be respectful, constructive, and specific. Harassment, personal attacks, and repeated disruptive behavior are not welcome.
+
+Maintainers may remove comments, close issues, or block participants to keep the project healthy.

package/CONTRIBUTING.md

@@ -0,0 +1,30 @@
+# Contributing
+
+Thanks for helping `oss-pulse` become useful for real maintainers.
+
+## Setup
+
+```bash
+npm install
+npm run check
+```
+
+## Development Loop
+
+1. Add or update a test for the behavior.
+2. Make the smallest implementation change.
+3. Run `npm run check`.
+4. Open a pull request with the behavior, verification command, and any follow-up work.
+
+## Good First Contributions
+
+Good starter issues are usually one of:
+
+- add a maintainer file detector
+- improve Markdown report wording
+- add a focused test case
+- document a real repository workflow
+
+Keep pull requests small. A reviewer should be able to understand the behavior in one pass.
+
+See [CONTRIBUTOR_BACKLOG.md](docs/CONTRIBUTOR_BACKLOG.md) for ready-to-file starter issues.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 oss-pulse 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.

package/README.md

@@ -0,0 +1,158 @@
+# oss-pulse
+
+`oss-pulse` turns local repository maintenance signals into a small health report that works in a terminal, CI job, or GitHub step summary.
+
+The first release is intentionally narrow: it checks whether a repository has the surfaces that help outside contributors succeed.
+
+## Install
+
+```bash
+npm install
+npm run build
+node dist/cli.js scan . --format markdown
+```
+
+After the package is published:
+
+```bash
+npx --yes oss-pulse@0.1.0 scan . --format markdown
+```
+
+## CLI
+
+```bash
+oss-pulse scan [path] --format markdown
+oss-pulse scan [path] --format json
+oss-pulse scan [path] --format release-notes
+oss-pulse scan [path] --format contributor-onboarding
+oss-pulse scan [path] --format triage-suggestions
+oss-pulse scan [path] --format sarif
+oss-pulse scan [path] --format github-annotations
+oss-pulse scan [path] --format markdown --output pulse.md
+oss-pulse scan [path] --format markdown --fail-under 80
+oss-pulse scan [path] --format markdown --summary-only
+```
+
+The report includes:
+
+- maintainer readiness score
+- README, license, contribution guide, issue templates, good first issue template, security policy, CI, release workflow, changelog, funding, and activity checks
+- ranked next actions
+- JSON output for automation
+- JSON Schema for automation consumers at `docs/report.schema.json`
+- Markdown output for GitHub summaries
+- release notes draft output for maintainer updates
+- contributor onboarding output for first-time contributors
+- triage suggestions for issue queues and pull request review
+- SARIF output for GitHub code scanning and security dashboards
+- GitHub workflow annotations for visible CI warnings and errors
+- optional CI failure when score is below `--fail-under`
+- compact Markdown output with `--summary-only`
+
+## Examples
+
+Local pre-release audit:
+
+```bash
+npm run build
+node dist/cli.js scan . --format markdown --fail-under 80
+```
+
+Pull request summary gate:
+
+```bash
+npx --yes oss-pulse@0.1.0 scan . --format markdown --summary-only --fail-under 80 >> "$GITHUB_STEP_SUMMARY"
+```
+
+Release notes draft:
+
+```bash
+npx --yes oss-pulse@0.1.0 scan . --format release-notes
+```
+
+Contributor onboarding report:
+
+```bash
+npx --yes oss-pulse@0.1.0 scan . --format contributor-onboarding
+```
+
+Issue and pull request triage:
+
+```bash
+npx --yes oss-pulse@0.1.0 scan . --format triage-suggestions
+```
+
+SARIF for code scanning:
+
+```bash
+npx --yes oss-pulse@0.1.0 scan . --format sarif --output oss-pulse.sarif
+```
+
+GitHub workflow annotations:
+
+```bash
+npx --yes oss-pulse@0.1.0 scan . --format github-annotations
+```
+
+## GitHub Actions
+
+```yaml
+name: OSS Pulse
+
+on:
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  pulse:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+      - run: npx --yes oss-pulse@0.1.0 scan . --format markdown --summary-only --fail-under 80 >> "$GITHUB_STEP_SUMMARY"
+```
+
+Repository Action usage after publishing:
+
+```yaml
+- uses: your-org/oss-pulse@v0.1.0
+  with:
+    path: "."
+    format: markdown
+    fail-under: "80"
+    summary-only: "true"
+```
+
+Action inputs:
+
+| Input | Default | Description |
+| --- | --- | --- |
+| `path` | `.` | Repository path to scan. |
+| `format` | `markdown` | One of `markdown`, `json`, `release-notes`, `contributor-onboarding`, `triage-suggestions`, `sarif`, or `github-annotations`. |
+| `fail-under` | `0` | Exit 1 when the score is below this threshold. |
+| `summary-only` | `false` | Emit compact Markdown with score and next actions. |
+
+After publishing the GitHub repository, prefer a pinned release tag for the repository Action instead of a branch name.
+
+When `format` is `github-annotations`, the Action prints workflow commands to stdout so GitHub can render annotations in the checks UI.
+
+## Why
+
+Most maintainer tools wait until a project is already busy. `oss-pulse` starts earlier: it makes missing contribution paths visible before a community arrives.
+
+This project is built for maintainers who want a practical route toward a healthier open source project and measurable public contribution history.
+
+## Roadmap
+
+See [ROADMAP.md](docs/ROADMAP.md) for the product path and [CONTRIBUTOR_BACKLOG.md](docs/CONTRIBUTOR_BACKLOG.md) for issues designed for first-time contributors.
+
+For automation consumers, see [REPORT_SCHEMA.md](docs/REPORT_SCHEMA.md). For real repository examples, see [docs/examples](docs/examples/README.md).
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Release
+
+See [RELEASE.md](docs/RELEASE.md) for the npm and GitHub release path.

package/SECURITY.md

@@ -0,0 +1,12 @@
+# Security Policy
+
+Please do not open public issues for vulnerabilities.
+
+Email the maintainers with:
+
+- affected version or commit
+- reproduction steps
+- expected impact
+- any safe workaround
+
+This early project does not yet have a fixed response SLA, but verified reports will be acknowledged before public disclosure.

package/action.yml

@@ -0,0 +1,45 @@
+name: OSS Pulse
+description: Turn repository maintenance signals into an actionable OSS health report.
+
+inputs:
+  path:
+    description: Repository path to scan.
+    required: false
+    default: "."
+  format:
+    description: Output format. Supported values are markdown, json, release-notes, contributor-onboarding, triage-suggestions, sarif, and github-annotations.
+    required: false
+    default: markdown
+  fail-under:
+    description: Exit 1 when the repository score is below this threshold.
+    required: false
+    default: "0"
+  summary-only:
+    description: Emit compact Markdown with score and next actions.
+    required: false
+    default: "false"
+
+runs:
+  using: composite
+  steps:
+    - shell: bash
+      run: npm ci && npm run build
+      working-directory: ${{ github.action_path }}
+    - shell: bash
+      run: |
+        args=(scan --format="$OSS_PULSE_FORMAT" --fail-under="$OSS_PULSE_FAIL_UNDER")
+        if [ "$OSS_PULSE_SUMMARY_ONLY" = "true" ]; then
+          args+=(--summary-only)
+        fi
+        args+=(-- "$OSS_PULSE_PATH")
+        if [ "$OSS_PULSE_FORMAT" = "github-annotations" ]; then
+          node "$OSS_PULSE_ACTION_PATH/dist/cli.js" "${args[@]}"
+        else
+          node "$OSS_PULSE_ACTION_PATH/dist/cli.js" "${args[@]}" >> "$GITHUB_STEP_SUMMARY"
+        fi
+      env:
+        OSS_PULSE_ACTION_PATH: ${{ github.action_path }}
+        OSS_PULSE_FAIL_UNDER: ${{ inputs.fail-under }}
+        OSS_PULSE_FORMAT: ${{ inputs.format }}
+        OSS_PULSE_PATH: ${{ inputs.path }}
+        OSS_PULSE_SUMMARY_ONLY: ${{ inputs.summary-only }}

package/dist/action-artifacts.d.ts

@@ -0,0 +1,3 @@
+import type { ActionId } from "./types.js";
+export declare function artifactUriForAction(actionId: ActionId): string;
+//# sourceMappingURL=action-artifacts.d.ts.map

package/dist/action-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-artifacts.d.ts","sourceRoot":"","sources":["../src/action-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1C,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAiC/D"}

package/dist/action-artifacts.js

@@ -0,0 +1,38 @@
+export function artifactUriForAction(actionId) {
+    switch (actionId) {
+        case "add-readme":
+            return "README.md";
+        case "add-license":
+            return "LICENSE";
+        case "add-contributing-guide":
+            return "CONTRIBUTING.md";
+        case "add-issue-template":
+            return ".github/ISSUE_TEMPLATE/bug_report.md";
+        case "add-good-first-issue-template":
+            return ".github/ISSUE_TEMPLATE/good_first_issue.md";
+        case "add-pull-request-template":
+            return ".github/PULL_REQUEST_TEMPLATE.md";
+        case "add-security-policy":
+            return "SECURITY.md";
+        case "add-ci-workflow":
+            return ".github/workflows/ci.yml";
+        case "add-release-workflow":
+            return ".github/workflows/release.yml";
+        case "add-changelog":
+            return "CHANGELOG.md";
+        case "add-funding":
+            return ".github/FUNDING.yml";
+        case "invite-contributors":
+            return ".github/ISSUE_TEMPLATE/good_first_issue.md";
+        case "add-code-of-conduct":
+            return "CODE_OF_CONDUCT.md";
+        case "resume-maintenance":
+            return "README.md";
+        default:
+            return assertNever(actionId);
+    }
+}
+function assertNever(value) {
+    throw new Error(`unexpected action id: ${value}`);
+}
+//# sourceMappingURL=action-artifacts.js.map

package/dist/action-artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-artifacts.js","sourceRoot":"","sources":["../src/action-artifacts.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,oBAAoB,CAAC,QAAkB;IACrD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,YAAY;YACf,OAAO,WAAW,CAAA;QACpB,KAAK,aAAa;YAChB,OAAO,SAAS,CAAA;QAClB,KAAK,wBAAwB;YAC3B,OAAO,iBAAiB,CAAA;QAC1B,KAAK,oBAAoB;YACvB,OAAO,sCAAsC,CAAA;QAC/C,KAAK,+BAA+B;YAClC,OAAO,4CAA4C,CAAA;QACrD,KAAK,2BAA2B;YAC9B,OAAO,kCAAkC,CAAA;QAC3C,KAAK,qBAAqB;YACxB,OAAO,aAAa,CAAA;QACtB,KAAK,iBAAiB;YACpB,OAAO,0BAA0B,CAAA;QACnC,KAAK,sBAAsB;YACzB,OAAO,+BAA+B,CAAA;QACxC,KAAK,eAAe;YAClB,OAAO,cAAc,CAAA;QACvB,KAAK,aAAa;YAChB,OAAO,qBAAqB,CAAA;QAC9B,KAAK,qBAAqB;YACxB,OAAO,4CAA4C,CAAA;QACrD,KAAK,qBAAqB;YACxB,OAAO,oBAAoB,CAAA;QAC7B,KAAK,oBAAoB;YACvB,OAAO,WAAW,CAAA;QACpB;YACE,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAA;IAChC,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAY;IAC/B,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,EAAE,CAAC,CAAA;AACnD,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+export declare function runScan(targetPath: string, rawOptions: unknown): Promise<string>;
+export declare function main(argv: readonly string[]): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAmCA,wBAAsB,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAGtF;AAkBD,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BjE"}

package/dist/cli.js

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+import { writeFile } from "node:fs/promises";
+import { pathToFileURL } from "node:url";
+import { Command } from "commander";
+import { z } from "zod";
+import { RepositoryPathError, UnexpectedOutputFormatError } from "./errors.js";
+import { formatContributorOnboarding, formatJson, formatMarkdown, formatMarkdownSummary, formatReleaseNotes, formatTriageSuggestions, } from "./format.js";
+import { scanRepository } from "./git.js";
+import { formatGithubAnnotations } from "./github-annotations.js";
+import { buildReport } from "./report.js";
+import { formatSarif } from "./sarif.js";
+import { OUTPUT_FORMATS } from "./types.js";
+const ScanOptionsSchema = z.object({
+    failUnder: z.coerce.number().int().min(0).max(100).optional(),
+    format: z.enum(OUTPUT_FORMATS).default("markdown"),
+    output: z.string().min(1).optional(),
+    summaryOnly: z.boolean().default(false),
+});
+export async function runScan(targetPath, rawOptions) {
+    const options = ScanOptionsSchema.parse(rawOptions);
+    return (await runScanWithOptions(targetPath, options)).output;
+}
+async function runScanWithOptions(targetPath, options) {
+    const signals = await scanRepository(targetPath);
+    const report = buildReport(signals);
+    const output = formatReport(report, options);
+    if (options.output !== undefined) {
+        await writeFile(options.output, output, "utf8");
+    }
+    return {
+        failedThreshold: options.failUnder !== undefined && report.score < options.failUnder,
+        output,
+        score: report.score,
+    };
+}
+export async function main(argv) {
+    const program = new Command();
+    program
+        .name("oss-pulse")
+        .description("Turn repository maintenance signals into an actionable OSS health report.")
+        .version("0.1.0");
+    program
+        .command("scan")
+        .argument("[path]", "repository path", ".")
+        .option("--fail-under <score>", "exit 1 when score is below this threshold")
+        .option("-f, --format <format>", "output format: markdown, json, release-notes, contributor-onboarding, triage-suggestions, sarif, or github-annotations", "markdown")
+        .option("-o, --output <path>", "write report to a file")
+        .option("--summary-only", "emit compact Markdown with score and next actions")
+        .action(async (targetPath, options) => {
+        const scanOptions = ScanOptionsSchema.parse(options);
+        const result = await runScanWithOptions(targetPath, scanOptions);
+        if (scanOptions.output === undefined) {
+            process.stdout.write(result.output);
+        }
+        if (result.failedThreshold) {
+            process.exitCode = 1;
+        }
+    });
+    await program.parseAsync([...argv], { from: "node" });
+}
+function formatReport(report, options) {
+    switch (options.format) {
+        case "json":
+            return formatJson(report);
+        case "markdown":
+            return options.summaryOnly ? formatMarkdownSummary(report) : formatMarkdown(report);
+        case "release-notes":
+            return formatReleaseNotes(report);
+        case "contributor-onboarding":
+            return formatContributorOnboarding(report);
+        case "triage-suggestions":
+            return formatTriageSuggestions(report);
+        case "sarif":
+            return formatSarif(report);
+        case "github-annotations":
+            return formatGithubAnnotations(report);
+        default:
+            return assertNever(options.format);
+    }
+}
+function assertNever(value) {
+    throw new UnexpectedOutputFormatError(value);
+}
+function isCliEntrypoint(argv) {
+    const scriptPath = argv[1];
+    return scriptPath !== undefined && import.meta.url === pathToFileURL(scriptPath).href;
+}
+if (isCliEntrypoint(process.argv)) {
+    main(process.argv).catch(handleCliFailure);
+}
+function handleCliFailure(error) {
+    if (error instanceof RepositoryPathError) {
+        process.stderr.write(`${error.message}\n`);
+        process.exitCode = 2;
+        return;
+    }
+    if (error instanceof z.ZodError) {
+        process.stderr.write(formatZodError(error));
+        process.exitCode = 2;
+        return;
+    }
+    throw error;
+}
+function formatZodError(error) {
+    const messages = error.issues.map(formatZodIssue);
+    return `invalid options: ${messages.join("; ")}\n`;
+}
+function formatZodIssue(issue) {
+    const path = issue.path.map(String).join(".") || "options";
+    switch (issue.code) {
+        case z.ZodIssueCode.invalid_enum_value:
+            return `${path}: expected one of ${issue.options.join(", ")}`;
+        default:
+            return `${path}: ${issue.message}`;
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,19 @@
+export declare class RepositoryPathError extends Error {
+    readonly path: string;
+    readonly reason: string;
+    readonly name = "RepositoryPathError";
+    constructor(path: string, reason: string);
+}
+export declare class GitCommandError extends Error {
+    readonly command: readonly string[];
+    readonly cwd: string;
+    readonly stderr: string;
+    readonly name = "GitCommandError";
+    constructor(command: readonly string[], cwd: string, stderr: string);
+}
+export declare class UnexpectedOutputFormatError extends Error {
+    readonly format: never;
+    readonly name = "UnexpectedOutputFormatError";
+    constructor(format: never);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAoB,SAAQ,KAAK;IAI1C,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM;IAJzB,QAAQ,CAAC,IAAI,yBAAwB;gBAG1B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM;CAI1B;AAED,qBAAa,eAAgB,SAAQ,KAAK;IAItC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM;IALzB,QAAQ,CAAC,IAAI,qBAAoB;gBAGtB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM;CAI1B;AAED,qBAAa,2BAA4B,SAAQ,KAAK;IAGxC,QAAQ,CAAC,MAAM,EAAE,KAAK;IAFlC,QAAQ,CAAC,IAAI,iCAAgC;gBAExB,MAAM,EAAE,KAAK;CAGnC"}

package/dist/errors.js

@@ -0,0 +1,31 @@
+export class RepositoryPathError extends Error {
+    path;
+    reason;
+    name = "RepositoryPathError";
+    constructor(path, reason) {
+        super(`cannot scan ${path}: ${reason}`);
+        this.path = path;
+        this.reason = reason;
+    }
+}
+export class GitCommandError extends Error {
+    command;
+    cwd;
+    stderr;
+    name = "GitCommandError";
+    constructor(command, cwd, stderr) {
+        super(`git ${command.join(" ")} failed in ${cwd}`);
+        this.command = command;
+        this.cwd = cwd;
+        this.stderr = stderr;
+    }
+}
+export class UnexpectedOutputFormatError extends Error {
+    format;
+    name = "UnexpectedOutputFormatError";
+    constructor(format) {
+        super(`unexpected output format: ${format}`);
+        this.format = format;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAIjC;IACA;IAJF,IAAI,GAAG,qBAAqB,CAAA;IAErC,YACW,IAAY,EACZ,MAAc;QAEvB,KAAK,CAAC,eAAe,IAAI,KAAK,MAAM,EAAE,CAAC,CAAA;QAH9B,SAAI,GAAJ,IAAI,CAAQ;QACZ,WAAM,GAAN,MAAM,CAAQ;IAGzB,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAI7B;IACA;IACA;IALF,IAAI,GAAG,iBAAiB,CAAA;IAEjC,YACW,OAA0B,EAC1B,GAAW,EACX,MAAc;QAEvB,KAAK,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,EAAE,CAAC,CAAA;QAJzC,YAAO,GAAP,OAAO,CAAmB;QAC1B,QAAG,GAAH,GAAG,CAAQ;QACX,WAAM,GAAN,MAAM,CAAQ;IAGzB,CAAC;CACF;AAED,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAG/B;IAFZ,IAAI,GAAG,6BAA6B,CAAA;IAE7C,YAAqB,MAAa;QAChC,KAAK,CAAC,6BAA6B,MAAM,EAAE,CAAC,CAAA;QADzB,WAAM,GAAN,MAAM,CAAO;IAElC,CAAC;CACF"}

package/dist/format.d.ts

@@ -0,0 +1,8 @@
+import type { PulseReport } from "./types.js";
+export declare function formatJson(report: PulseReport): string;
+export declare function formatMarkdown(report: PulseReport): string;
+export declare function formatMarkdownSummary(report: PulseReport): string;
+export declare function formatReleaseNotes(report: PulseReport): string;
+export declare function formatContributorOnboarding(report: PulseReport): string;
+export declare function formatTriageSuggestions(report: PulseReport): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAEtD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CA4B1D;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAcjE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAuB9D;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CA4BvE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CA2BnE"}