K/bootstrap repo by kcargile · Pull Request #1 · openendurance/core

kcargile · 2026-09-25T03:56:28Z

This pull request introduces several new configuration and documentation files to improve project management, contribution workflow, and quality assurance processes. The changes add support for changeset-based versioning, provide standardized templates for issues and pull requests, enforce consistent code formatting, and document the QA preflight pipeline.

Project management and versioning:

Added .changeset/config.json to configure changeset-based versioning and publishing for the repository.
Added .changeset/README.md with an introduction and links to changeset documentation.

Contribution workflow improvements:

Added standardized GitHub issue templates for bugs (bug.md) and feature requests (feature.md) to guide contributors in reporting issues and requesting features. [1] [2]
Added a pull request template (pull_request.md) to ensure consistency and completeness in PR submissions.

Code quality and formatting:

Introduced .editorconfig to enforce consistent code style and formatting across different editors and file types.

Documentation:

Added a detailed operator guide for the QA preflight pipeline in .github/agents/docs/qa-preflight-pipeline.README.md, outlining its usage, scope resolution, decision rules, and output.

…nto k/bootstrap-repo

changeset-bot · 2026-09-25T03:56:31Z

⚠️ No Changeset found

Latest commit: d426073

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Copilot

Copilot review overview

🟡 Changes recommended

Critical package, build, QA-contract, and dependency issues remain unresolved.

Get a fresh assessment by requesting another Copilot review.

Review effort: Lite
Findings: 8 · 2 · 9

Open (19)

Required trusted governance documents are missing · New
Core validation workspace lacks a package manifest · New
Advertised core-validation package lacks build configuration · New
Publishable core package is incorrectly marked private · New
ES module output is incompatible with package configuration · New
Core package omits ulidx runtime dependency · New
STATUSES must be readonly to preserve the Status union · New
TypeScript build output is not Node-compatible · New
Root package lacks the documented test:watch script · New
Documented type-check script name is incorrect · New
Template incorrectly identifies the project as FKT · New
Feature template incorrectly identifies the project as FKT · New
Operator guide omits the conditional endpoint compliance lane · New
Bug issue link references nonexistent ISSUE.md · New
Feature links reference nonexistent FEATURE_REQUEST.md · New
README commands anchor does not exist · New
Badges reference the unrelated FKT repository · New
Status documentation uses incorrect lowercase examples · New
OeiErrorCode lacks public API documentation · New

What changed in this PR

Bootstraps OEI Core as a pnpm/Turborepo TypeScript monorepo with package scaffolding, release tooling, contributor workflows, documentation, and QA automation.

Changes:

Adds workspace, build, lint, formatting, Renovate, and Changesets configuration.
Introduces initial core APIs and package scaffolding.
Adds documentation, templates, agent skills, prompts, and QA guidance.

File	Description
`turbo.json`	Root task configuration.
`tsconfig.json`	Shared TypeScript settings.
`SECURITY.md`	Security reporting policy.
`scripts/README.md`	Scripts documentation.
`scripts/copilot-agent-mcp-config.json`	MCP configuration backup.
`renovate.json`	Dependency update configuration.
`README.md`	Project overview and development guide.
`pnpm-workspace.yaml`	Workspace configuration.
`packages/core/turbo.json`	Core task configuration.
`packages/core/tsconfig.json`	Core TypeScript settings.
`packages/core/tsconfig.build.json`	Core build configuration.
`packages/core/src/status.ts`	Status constants and type.
`packages/core/src/oeiError.ts`	Domain error type.
`packages/core/src/oeiEntity.ts`	Entity interface.
`packages/core/src/index.ts`	Core barrel export.
`packages/core/src/identity.ts`	Identity utilities.
`packages/core/README.md`	Core package documentation.
`packages/core/package.json`	Core package metadata.
`packages/core/AGENTS.md`	Package guidance.
`packages/core-validation/src/index.ts`	Validation package placeholder.
`packages/core-validation/README.md`	Validation package documentation.
`package.json`	Root scripts and dependencies.
`lint-staged.config.mjs`	Pre-commit configuration.
`fixtures/.gitkeep`	Fixtures placeholder.
`docs/TOC.md`	Documentation index.
`docs/registry/README.md`	Registry documentation placeholder.
`docs/README.md`	Documentation root.
`docs/ops/README.md`	Operations documentation placeholder.
`docs/generated/README.md`	Generated documentation placeholder.
`docs/arch/README.md`	Architecture documentation placeholder.
`docs/adr/README.md`	ADR documentation placeholder.
`CONTRIBUTING.md`	Contribution workflow.
`CODEOWNERS`	Repository ownership.
`CODE_OF_CONDUCT.md`	Community conduct policy.
`CLAUDE.md`	Agent guidance reference.
`biome.json`	Formatting and linting rules.
`apps/.gitkeep`	Apps directory placeholder.
`AGENTS.md`	Repository guidance.
`.vscode/settings.json`	Editor settings.
`.vscode/mcp.json`	Local MCP configuration.
`.vscode/extensions.json`	Recommended extensions.
`.nvmrc`	Node.js version selection.
`.npmignore`	Package publishing exclusions.
`.husky/pre-commit`	Pre-commit hook.
`.gitignore`	Repository ignore rules.
`.github/skills/create-inline-tsdocs/SKILL.md`	TSDoc authoring skill.
`.github/skills/code-review-privacy-check/SKILL.md`	Privacy review skill.
`.github/skills/code-review-privacy-check/assets/rubric-taxonomy.md`	Privacy review rubric.
`.github/skills/code-review-docs-check/SKILL.md`	Documentation review skill.
`.github/skills/adr-review/SKILL.md`	ADR review skill.
`.github/skills/adr-review/assets/rubric.md`	ADR review rubric.
`.github/skills/adr-review/assets/example.md`	ADR review example.
`.github/skills/adr-create/SKILL.md`	ADR creation skill.
`.github/skills/adr-create/assets/template.md`	ADR template.
`.github/skills/adr-create/assets/example.md`	ADR example.
`.github/PULL_REQUEST_TEMPLATE/pull_request.md`	Pull request template.
`.github/prompts/find-bloated-typescript.prompt.md`	TypeScript review prompt.
`.github/prompts/create-inline-tsdocs.prompt.md`	TSDoc prompt.
`.github/prompts/code-review-privacy-check.prompt.md`	Privacy review prompt.
`.github/prompts/code-review-docs-check.prompt.md`	Documentation review prompt.
`.github/ISSUE_TEMPLATE/feature.md`	Feature request template.
`.github/ISSUE_TEMPLATE/bug.md`	Bug report template.
`.github/instructions/.gitkeep`	Instructions placeholder.
`.github/hooks/.gitkeep`	Hooks placeholder.
`.github/agents/qa-preflight-pipeline.agent.md`	QA preflight agent.
`.github/agents/playbooks/.gitkeep`	Playbooks placeholder.
`.github/agents/docs/qa-preflight-pipeline.README.md`	QA preflight guide.
`.editorconfig`	Editor conventions.
`.devcontainer/.gitkeep`	Devcontainer placeholder.
`.changeset/README.md`	Changesets documentation.
`.changeset/config.json`	Changesets configuration.

+- `docs/ops/standards-coding.md`
+- `docs/ops/standards-tsdoc.md`
+- `docs/ops/standards-testing.md`
+- `docs/ops/standards-ci.md`
+- `docs/ops/qa-project-test-strategy.md`


+| Package | Description |
+|---|---|
+| [`@openendurance/core`](packages/core) |  Domain models and other common utilities. |
+| [`@openendurance/core-validation`](packages/core-validation) | Validation logic. |


@@ -0,0 +1 @@
+export {};


+	"description": "Open Endurance Initiative (OEI) core components.",
+	"repository": "https://github.com/openendurance/core",
+	"author": "The OEI Team <[email protected]>",
+	"private": true,


+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",


+Otherwise, [request a feature](https://github.com/openendurance/core/issues/new?template=FEATURE_REQUEST.md).
+
+## Proposing a change
+
+If you intend to build new functionality, add a significant amount of code, change a public API, or any other non-trivial changes, [we recommend filing an issue](https://github.com/openendurance/core/issues/new?template=FEATURE_REQUEST.md). This lets us all discuss and reach an agreement on the proposal before you put in significant time and effort.


+
+## Development workflow
+
+See the [README.md](README.md#commands) file for documentation on the development workflow.


+[![Release](https://github.com/openendurance/fkt/actions/workflows/release.yml/badge.svg)](https://github.com/openendurance/fkt/actions/workflows/release.yml)&nbsp;
+[![Build & Test](https://github.com/openendurance/fkt/actions/workflows/build.yml/badge.svg)](https://github.com/openendurance/fkt/actions/workflows/build.yml)&nbsp;
+[![CodeQL](https://github.com/openendurance/fkt/actions/workflows/codeql.yml/badge.svg)](https://github.com/openendurance/fkt/actions/workflows/codeql-analysis.yml)&nbsp;
+[![FOSSA Status](https://app.fossa.com/api/projects/custom%2B33512%2Fgithub.com%2Fopenendurance%2Ffkt.svg?type=small)](https://app.fossa.com/projects/custom%2B33512%2Fgithub.com%2Fopenendurance%2Ffkt?ref=badge_small)


+	/**
+	 * Entity status, e.g. "approved", "pending", "rejected", etc.
+	 */
+	status: Status;


+// SPDX-FileCopyrightText: 2026 Algorythmic
+// SPDX-License-Identifier: Apache-2.0
+
+export type OeiErrorCode =


kcargile added 3 commits September 24, 2026 08:08

first pass bootstrap repo

4d4735b

first pass bootstrap repo

9b0a877

Merge remote-tracking branch 'refs/remotes/origin/k/bootstrap-repo' i…

d426073

…nto k/bootstrap-repo

kcargile self-assigned this Sep 25, 2026

Copilot AI lite review requested due to automatic review settings September 25, 2026 03:56

kcargile added the chore Chore not related to feature development. label Sep 25, 2026

Copilot started reviewing on behalf of kcargile September 25, 2026 03:57 View session

kcargile merged commit bb3e888 into develop Sep 25, 2026
1 check passed

kcargile deleted the k/bootstrap-repo branch September 25, 2026 04:06

Copilot AI reviewed Sep 25, 2026

View reviewed changes

Navigation Menu

K/bootstrap repo - #1

K/bootstrap repo#1
kcargile merged 3 commits into
developfrom
k/bootstrap-repo

kcargile commented Sep 25, 2026

Uh oh!

changeset-bot Bot commented Sep 25, 2026

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants


		## Development workflow

		See the [README.md](README.md#commands) file for documentation on the development workflow.

Conversation

kcargile commented Sep 25, 2026

Uh oh!

changeset-bot Bot commented Sep 25, 2026

⚠️ No Changeset found

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot review overview

🟡 Changes recommended

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants