Skip to content

docs: add community Code of Conduct with collaboration etiquette - #224

Open
soleil-colza wants to merge 5 commits into
mainfrom
eng-1050
Open

docs: add community Code of Conduct with collaboration etiquette#224
soleil-colza wants to merge 5 commits into
mainfrom
eng-1050

Conversation

@soleil-colza

@soleil-colza soleil-colza commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a bilingual Code of Conduct (CODE_OF_CONDUCT.md / CODE_OF_CONDUCT.ja.md) at the repo root. GitHub picks up the root file for the community profile automatically.

The document has two parts:

  1. Conduct baseline: adapted from Contributor Covenant 2.1, with the required attribution.
  2. Collaboration etiquette (Arkor-specific):
    • Issues: comment to claim, then wait for a maintainer to assign (outside collaborators cannot self-assign on GitHub). Issues assigned to someone else are off limits. Stalled issues (~2 weeks of no visible activity) can be politely checked on, but only maintainers unassign. Letting go of an issue is explicitly no-penalty, and stockpiling unworked claims is discouraged.
    • Pull requests: one issue, one PR, no duplicates. Contribute to an existing PR instead of racing it; discuss alternative approaches on the issue first; link the issue the PR addresses with a closing keyword.
    • Communication: maintainers and contributors volunteer their time and are not a personal support desk. Keep questions public and on-topic, no DM review/merge/assignment requests, no nagging (one polite bump after about a week), reactions instead of "+1" comments.

Also links the new document from the Code of conduct sections of CONTRIBUTING.md and CONTRIBUTING.ja.md, and ships both Code of Conduct files in the published arkor / create-arkor tarballs (copy-root-files.mjs + files) so the packaged CONTRIBUTING.md link resolves.

Review feedback applied

  • Reviewer suggestions on the Japanese documents (long-vowel katakana, full-width punctuation, discord.arkor.ai vanity URL; the English document mirrors the URL change).
  • Japanese harassment wording broadened to cover unwelcome sexual attention, matching the English policy.
  • Code of Conduct files now included in the published tarballs.
  • Skipped: splitting the pledge sentence in CODE_OF_CONDUCT.md (it is the Contributor Covenant's canonical single-sentence pledge, and the Japanese review kept the same structure).

Open question

The enforcement section names conduct@arkor.ai as the report address. That alias does not exist yet; we need to either create it or switch the document to another contact before merging.

Checks

  • pnpm check:no-em-dash and pnpm format:check pass.
  • English and Japanese versions land in the same PR per the bilingual docs convention.

Summary by CodeRabbit

  • New Features

    • Added English and Japanese Codes of Conduct covering community standards, collaboration, reporting, and enforcement.
    • Published contributor and conduct documentation with the relevant packages.
  • Documentation

    • Improved contribution guidelines with collaboration practices and direct links to testing resources.
    • Added Japanese documentation links and guidance for avoiding duplicate contributions.

Adds CODE_OF_CONDUCT.md and CODE_OF_CONDUCT.ja.md at the repo root. The
conduct baseline is adapted from Contributor Covenant 2.1 (with the
required attribution); the collaboration etiquette section is
Arkor-specific: issue claiming/assignment flow, no working on issues
assigned to others, no duplicate PRs, and communication ground rules
for interacting with maintainers and contributors.

Links the new document from the Code of conduct sections of
CONTRIBUTING.md and CONTRIBUTING.ja.md.
@drift-check

drift-check Bot commented Aug 12, 2026

Copy link
Copy Markdown

Code Review Bot

No comment/code divergences or documentation drift detected. Reviewed 11 file(s); skipped 0.

@coderabbitai

coderabbitai Bot commented Aug 12, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 7a66db83-800a-43f6-9637-6a9d5a2865bf

📥 Commits

Reviewing files that changed from the base of the PR and between ce19ecf and 81029c6.

📒 Files selected for processing (4)
  • CODE_OF_CONDUCT.ja.md
  • CODE_OF_CONDUCT.md
  • CONTRIBUTING.ja.md
  • CONTRIBUTING.md
📜 Recent review details
⏰ Context from checks skipped due to timeout. (198)
  • GitHub Check: install · yarn · windows-latest · node >=26.0.0 <27
  • GitHub Check: install · yarn-berry · macos-latest · node >=22.22.0 <23
  • GitHub Check: install · yarn-berry · windows-latest · node 24.12.0
  • GitHub Check: install · pnpm-9 · macos-latest · node 24.12.0
  • GitHub Check: install · pnpm-9 · macos-latest · node >=22.22.0 <23
  • GitHub Check: install · bun · windows-latest · node >=26.0.0 <27
  • GitHub Check: install · yarn-berry · macos-latest · node 24.0.0
  • GitHub Check: install · yarn · windows-latest · node 26.0.0
  • GitHub Check: install · pnpm-10 · macos-latest · node 24.0.0
  • GitHub Check: install · yarn · windows-latest · node >=24.12.0 <25
  • GitHub Check: install · yarn · macos-latest · node >=22.22.0 <23
  • GitHub Check: install · pnpm-11 · macos-latest · node 24.0.0
  • GitHub Check: install · pnpm-11 · windows-latest · node >=26.0.0 <27
  • GitHub Check: install · npm · windows-latest · node >=24.12.0 <25
  • GitHub Check: install · yarn-berry · macos-latest · node 22.22.0
  • GitHub Check: install · npm · windows-latest · node 26.0.0
  • GitHub Check: install · yarn-berry · windows-latest · node >=26.0.0 <27
  • GitHub Check: install · pnpm-11 · windows-latest · node 26.0.0
  • GitHub Check: install · pnpm-10 · windows-latest · node >=24.12.0 <25
  • GitHub Check: install · pnpm-10 · windows-latest · node >=26.0.0 <27
  • GitHub Check: install · pnpm-11 · windows-latest · node 24.0.0
  • GitHub Check: install · pnpm-11 · macos-latest · node 22.22.0
  • GitHub Check: install · bun · windows-latest · node 26.0.0
  • GitHub Check: install · bun · windows-latest · node >=24.12.0 <25
  • GitHub Check: install · npm · windows-latest · node >=26.0.0 <27
  • GitHub Check: install · yarn · windows-latest · node 24.0.0
  • GitHub Check: install · pnpm-9 · windows-latest · node >=26.0.0 <27
  • GitHub Check: install · bun · windows-latest · node 24.12.0
  • GitHub Check: install · pnpm-11 · windows-latest · node >=24.12.0 <25
  • GitHub Check: install · npm · windows-latest · node 24.12.0
  • GitHub Check: install · pnpm-11 · windows-latest · node 24.12.0
  • GitHub Check: install · yarn-berry · windows-latest · node >=24.12.0 <25
  • GitHub Check: install · yarn-berry · windows-latest · node 26.0.0
  • GitHub Check: install · npm · windows-latest · node 24.0.0
  • GitHub Check: install · yarn · windows-latest · node 24.12.0
  • GitHub Check: install · pnpm-9 · windows-latest · node 26.0.0
  • GitHub Check: install · pnpm-10 · windows-latest · node 24.0.0
  • GitHub Check: install · pnpm-10 · windows-latest · node 24.12.0
  • GitHub Check: install · pnpm-10 · windows-latest · node 26.0.0
  • GitHub Check: install · pnpm-9 · windows-latest · node >=24.12.0 <25
  • GitHub Check: install · pnpm-9 · windows-latest · node 24.12.0
  • GitHub Check: install · bun · windows-latest · node 24.0.0
  • GitHub Check: install · yarn-berry · windows-latest · node 24.0.0
  • GitHub Check: cubic · AI code reviewer
  • GitHub Check: install · yarn-berry · windows-latest · node 22.22.0
  • GitHub Check: install · pnpm-10 · windows-latest · node >=22.22.0 <23
  • GitHub Check: install · pnpm-11 · windows-latest · node 22.22.0
  • GitHub Check: install · yarn · windows-latest · node >=22.22.0 <23
  • GitHub Check: install · pnpm-10 · windows-latest · node 22.22.0
  • GitHub Check: install · pnpm-9 · windows-latest · node 24.0.0
  • GitHub Check: install · pnpm-11 · windows-latest · node >=22.22.0 <23
  • GitHub Check: install · yarn-berry · windows-latest · node >=22.22.0 <23
  • GitHub Check: install · bun · windows-latest · node 22.22.0
  • GitHub Check: install · npm · windows-latest · node 22.22.0
  • GitHub Check: install · bun · windows-latest · node >=22.22.0 <23
  • GitHub Check: install · npm · windows-latest · node >=22.22.0 <23
  • GitHub Check: install · yarn · windows-latest · node 22.22.0
  • GitHub Check: install · pnpm-9 · windows-latest · node >=22.22.0 <23
  • GitHub Check: install · pnpm-9 · windows-latest · node 22.22.0
  • GitHub Check: install · bun · macos-latest · node >=26.0.0 <27
  • GitHub Check: install · yarn · macos-latest · node 26.0.0
  • GitHub Check: install · pnpm-11 · macos-latest · node >=24.12.0 <25
  • GitHub Check: install · yarn · macos-latest · node >=24.12.0 <25
  • GitHub Check: install · bun · windows-latest · node >=24.12.0 <25
  • GitHub Check: install · pnpm-9 · macos-latest · node 24.0.0
  • GitHub Check: install · pnpm-11 · macos-latest · node 22.22.0
  • GitHub Check: install · pnpm-9 · macos-latest · node 24.12.0
  • GitHub Check: install · pnpm-11 · windows-latest · node 24.0.0
  • GitHub Check: install · bun · macos-latest · node >=22.22.0 <23
  • GitHub Check: install · yarn-berry · windows-latest · node >=26.0.0 <27
  • GitHub Check: install · bun · windows-latest · node 26.0.0
  • GitHub Check: install · bun · windows-latest · node >=26.0.0 <27
  • GitHub Check: install · yarn-berry · macos-latest · node >=22.22.0 <23
  • GitHub Check: install · yarn · macos-latest · node 22.22.0
  • GitHub Check: install · bun · macos-latest · node 24.12.0
  • GitHub Check: install · pnpm-9 · macos-latest · node >=22.22.0 <23
  • GitHub Check: install · npm · windows-latest · node 26.0.0
  • GitHub Check: install · pnpm-10 · windows-latest · node 26.0.0
  • GitHub Check: install · pnpm-10 · macos-latest · node 24.12.0
  • GitHub Check: install · yarn · macos-latest · node 24.0.0
  • GitHub Check: install · pnpm-10 · windows-latest · node >=26.0.0 <27
  • GitHub Check: install · yarn-berry · macos-latest · node 24.12.0
  • GitHub Check: install · pnpm-10 · windows-latest · node 24.12.0
  • GitHub Check: install · npm · macos-latest · node 22.22.0
  • GitHub Check: install · pnpm-10 · windows-latest · node >=24.12.0 <25
  • GitHub Check: install · yarn · windows-latest · node >=24.12.0 <25
  • GitHub Check: install · yarn-berry · windows-latest · node 24.12.0
  • GitHub Check: install · pnpm-11 · windows-latest · node 26.0.0
  • GitHub Check: install · yarn · windows-latest · node >=26.0.0 <27
  • GitHub Check: install · npm · windows-latest · node >=24.12.0 <25
  • GitHub Check: install · npm · windows-latest · node 24.12.0
  • GitHub Check: install · bun · windows-latest · node 24.12.0
  • GitHub Check: install · yarn · windows-latest · node 24.12.0
  • GitHub Check: install · yarn-berry · windows-latest · node 26.0.0
  • GitHub Check: install · pnpm-9 · windows-latest · node >=26.0.0 <27
  • GitHub Check: install · pnpm-9 · windows-latest · node >=24.12.0 <25
  • GitHub Check: install · pnpm-11 · windows-latest · node 24.12.0
  • GitHub Check: install · yarn · windows-latest · node 26.0.0
  • GitHub Check: install · pnpm-11 · windows-latest · node >=26.0.0 <27
  • GitHub Check: install · pnpm-11 · windows-latest · node >=24.12.0 <25
  • GitHub Check: install · yarn-berry · windows-latest · node >=24.12.0 <25
  • GitHub Check: install · pnpm-9 · windows-latest · node 26.0.0
  • GitHub Check: install · npm · windows-latest · node >=26.0.0 <27
  • GitHub Check: install · pnpm-9 · windows-latest · node 24.12.0
  • GitHub Check: install · yarn-berry · windows-latest · node 24.0.0
  • GitHub Check: install · pnpm-10 · windows-latest · node 24.0.0
  • GitHub Check: install · npm · windows-latest · node 24.0.0
  • GitHub Check: install · bun · windows-latest · node 24.0.0
  • GitHub Check: install · yarn · windows-latest · node 24.0.0
  • GitHub Check: install · pnpm-10 · windows-latest · node 22.22.0
  • GitHub Check: install · yarn · windows-latest · node >=22.22.0 <23
  • GitHub Check: install · yarn-berry · windows-latest · node 22.22.0
  • GitHub Check: install · pnpm-10 · windows-latest · node >=22.22.0 <23
  • GitHub Check: install · npm · windows-latest · node >=22.22.0 <23
  • GitHub Check: install · pnpm-11 · windows-latest · node >=22.22.0 <23
  • GitHub Check: install · pnpm-9 · windows-latest · node 22.22.0
  • GitHub Check: install · pnpm-9 · windows-latest · node 24.0.0
  • GitHub Check: install · bun · windows-latest · node 22.22.0
  • GitHub Check: install · yarn · windows-latest · node 22.22.0
  • GitHub Check: install · yarn-berry · windows-latest · node >=22.22.0 <23
  • GitHub Check: install · pnpm-11 · windows-latest · node 22.22.0
  • GitHub Check: install · npm · windows-latest · node 22.22.0
  • GitHub Check: install · bun · windows-latest · node >=22.22.0 <23
  • GitHub Check: install · pnpm-9 · windows-latest · node >=22.22.0 <23
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=24.5.0 <24.8.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node 24.12.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node 26.0.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=24.0.0 <24.1.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=24.10.0 <24.12.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=24.12.0 <25
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=24.3.0 <24.5.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=26.0.0 <27
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=24.8.0 <24.10.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.8.0 <24.10.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.1.0 <24.3.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node 24.12.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node 26.0.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node 22.22.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node 24.12.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.0.0 <24.1.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=24.1.0 <24.3.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node 22.22.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=22.22.0 <23
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.10.0 <24.12.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.5.0 <24.8.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=24.10.0 <24.12.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=26.0.0 <27
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=26.0.0 <27
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node 26.0.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=24.0.0 <24.1.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=22.22.0 <23
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.12.0 <25
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.3.0 <24.5.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=24.8.0 <24.10.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=24.12.0 <25
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=24.1.0 <24.3.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=22.22.0 <23
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node 22.22.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=24.3.0 <24.5.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=24.5.0 <24.8.0
  • GitHub Check: coverage · upload to Codecov
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node 24.12.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.0.0 <24.1.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node 26.0.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node 24.12.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=24.5.0 <24.8.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=22.22.0 <23
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=26.0.0 <27
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=24.12.0 <25
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=24.10.0 <24.12.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.10.0 <24.12.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.1.0 <24.3.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=24.0.0 <24.1.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=24.5.0 <24.8.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=24.12.0 <25
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.3.0 <24.5.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=24.8.0 <24.10.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.8.0 <24.10.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=24.3.0 <24.5.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=22.22.0 <23
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.12.0 <25
  • GitHub Check: typecheck · lint · test · build · windows-latest · node 26.0.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=26.0.0 <27
  • GitHub Check: typecheck · lint · test · build · macos-latest · node 24.12.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=24.1.0 <24.3.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=24.8.0 <24.10.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=24.0.0 <24.1.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=24.10.0 <24.12.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=24.1.0 <24.3.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node 22.22.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node 22.22.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=24.3.0 <24.5.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=22.22.0 <23
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=26.0.0 <27
  • GitHub Check: typecheck · lint · test · build · macos-latest · node 22.22.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node 26.0.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.5.0 <24.8.0
  • GitHub Check: coverage · upload to Codecov
🧰 Additional context used
📓 Path-based instructions (4)
**/{*.md,*.mdx,*.yaml,*.yml}

📄 CodeRabbit inference engine (AGENTS.md)

Do not format Markdown, MDX, YAML, or YML files with oxfmt; these are excluded because documentation anchors and deliberate YAML layout must remain hand-managed.

Files:

  • CODE_OF_CONDUCT.md
  • CONTRIBUTING.md
  • CODE_OF_CONDUCT.ja.md
  • CONTRIBUTING.ja.md
**/*.{yaml,yml,md,json,html}

📄 CodeRabbit inference engine (CONTRIBUTING.ja.md)

Markdown (このファイルを含む) は ESLint ルールの対象外です。

Files:

  • CODE_OF_CONDUCT.md
  • CONTRIBUTING.md
  • CODE_OF_CONDUCT.ja.md
  • CONTRIBUTING.ja.md
**/*

📄 CodeRabbit inference engine (CONTRIBUTING.md)

To extend the same convention to yaml, md, json, html, and root-level config, the scripts/check-no-em-dash.mts repo-wide guard scans every tracked file via git grep and fails on the em-dash glyph or its HTML entity.

Files:

  • CODE_OF_CONDUCT.md
  • CONTRIBUTING.md
  • CODE_OF_CONDUCT.ja.md
  • CONTRIBUTING.ja.md
CONTRIBUTING{,.ja}.md

📄 CodeRabbit inference engine (AGENTS.md)

When editing CONTRIBUTING.md, update the paired CONTRIBUTING.ja.md in the same change.

Files:

  • CONTRIBUTING.md
  • CONTRIBUTING.ja.md
🧠 Learnings (3)
📓 Common learnings
Learnt from: CR
Repo: arkorlab/arkor

Timestamp: 2026-08-14T09:01:18.474Z
Learning: If you have an idea for a non-trivial change (new SDK factory, CLI command, Studio view), please open an issue first so we can align on the API shape before you write code.
📚 Learning: 2026-08-07T08:54:17.077Z
Learnt from: CR
Repo: arkorlab/arkor PR: 0
File: CONTRIBUTING.md:0-0
Timestamp: 2026-08-07T08:54:17.077Z
Learning: Applies to **/*.{yaml,yml,json,html,md,mdx} : Do not use the em dash character (U+2014) or its HTML entity in repository files outside the lint targets.

Applied to files:

  • CONTRIBUTING.md
📚 Learning: 2026-08-07T08:54:24.838Z
Learnt from: CR
Repo: arkorlab/arkor PR: 0
File: CONTRIBUTING.ja.md:0-0
Timestamp: 2026-08-07T08:54:24.838Z
Learning: Applies to **/* : リポジトリ内の追跡対象ファイルでは、エムダッシュまたはその HTML エンティティを使用しない。Markdown、YAML、JSON、HTML、設定ファイル、生成テンプレートも含む。

Applied to files:

  • CONTRIBUTING.md
🔇 Additional comments (4)
CODE_OF_CONDUCT.md (1)

3-3: LGTM!

CODE_OF_CONDUCT.ja.md (1)

3-3: LGTM!

CONTRIBUTING.md (1)

11-11: LGTM!

Also applies to: 64-65, 107-107, 131-131

CONTRIBUTING.ja.md (1)

11-11: LGTM!

Also applies to: 63-64, 106-106, 130-130


Walkthrough

Added English and Japanese Code of Conduct documents, updated contribution guidance and repository links, and included the documents in package publication and copying scripts.

Changes

Community conduct documentation

Layer / File(s) Summary
Conduct policy documents
CODE_OF_CONDUCT.md, CODE_OF_CONDUCT.ja.md
Added conduct, collaboration, communication, enforcement, reporting, confidentiality, and attribution sections in English and Japanese.
Contribution guidance and links
CONTRIBUTING.md, CONTRIBUTING.ja.md
Updated repository links and added guidance for issue ownership, duplicate pull requests, and maintainer communication.
Package documentation distribution
.gitignore, packages/arkor/..., packages/create-arkor/...
Added contribution and Code of Conduct files to package manifests and copy scripts. Added ignore rules for generated Code of Conduct files.

Estimated code review effort: 2 (Simple) | ~10 minutes

Merge Risk: 🟡 Moderate · up to 81029

The new Code of Conduct directs reports to conduct@arkor.ai, but that address does not yet exist. Merge should wait until the alias is created or the documents name a working contact.

Suggested reviewers: k-taro56

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the main change: adding community Code of Conduct documents with collaboration etiquette.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch eng-1050
✨ Simplify code
  • Create PR with simplified code
  • Commit simplified code in branch eng-1050

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@qodo-free-for-open-source-projects

Copy link
Copy Markdown

PR Summary by Qodo

Add bilingual Code of Conduct and link it from contributing docs

📝 Documentation 🕐 10-20 Minutes

Grey Divider

AI Description

• Add bilingual Code of Conduct files at repo root (EN/JA) for GitHub community profile.
• Document Arkor-specific collaboration etiquette for issues, PRs, and maintainer communication.
• Link CONTRIBUTING (EN/JA) to the new Code of Conduct for a single source of truth.
Diagram

graph TD
  A((Contributors)) --> B["CONTRIBUTING.md"] --> C["CODE_OF_CONDUCT.md"]
  A --> D["CONTRIBUTING.ja.md"] --> E["CODE_OF_CONDUCT.ja.md"]
  C --> F["GitHub community profile"]

  subgraph Legend
    direction LR
    _p((Person)) ~~~ _d["Doc file"] ~~~ _g["GitHub surface"]
  end
Loading
High-Level Assessment

The following are alternative approaches to this PR:

1. Move collaboration etiquette to CONTRIBUTING only
  • ➕ Keeps Code of Conduct closer to the standard Contributor Covenant scope
  • ➕ Reduces chance of policy duplication if CONTRIBUTING already describes contribution flow
  • ➖ Makes the CoC less effective as a single, enforceable reference for collaboration norms
  • ➖ Harder for GitHub/community profile readers to discover etiquette expectations quickly
2. Use .github/ for the Code of Conduct location
  • ➕ Centralizes community health files under .github/ if the repo already follows that convention
  • ➖ Root-level CODE_OF_CONDUCT.md is equally supported and more discoverable when browsing the repo
  • ➖ Would require adjusting links and any existing documentation conventions
3. Use an existing monitored contact (or GitHub-native reporting) for enforcement
  • ➕ Avoids publishing an email alias that is not yet provisioned
  • ➕ Reduces risk of missed reports due to misrouted email
  • ➖ May be less purpose-specific than a dedicated conduct alias
  • ➖ Might require additional internal process alignment for handling reports

Recommendation: The PR’s approach (root-level bilingual CoC + explicit Arkor etiquette + CONTRIBUTING links) is solid and reviewer-friendly. The main pre-merge requirement is to ensure the enforcement contact is actionable: either create/confirm the conduct@ alias and ownership/rotation, or swap to an already-monitored address (and optionally document the internal handling process).

Files changed (4) +142 / -2

Documentation (4) +142 / -2
CODE_OF_CONDUCT.ja.mdAdd Japanese Code of Conduct with collaboration etiquette and enforcement details +70/-0

Add Japanese Code of Conduct with collaboration etiquette and enforcement details

• Introduces a Japanese Code of Conduct at the repo root, including a conduct baseline adapted from Contributor Covenant 2.1 and Arkor-specific collaboration etiquette for issues, PRs, and communication norms. Includes enforcement guidance and reporting contact details, plus attribution.

CODE_OF_CONDUCT.ja.md

CODE_OF_CONDUCT.mdAdd English Code of Conduct with collaboration etiquette and enforcement details +70/-0

Add English Code of Conduct with collaboration etiquette and enforcement details

• Introduces an English Code of Conduct at the repo root, combining a Contributor Covenant 2.1-derived baseline with project-specific etiquette rules for claiming issues, avoiding duplicate PRs, and interacting with maintainers. Includes enforcement actions, reporting contact, and required attribution.

CODE_OF_CONDUCT.md

CONTRIBUTING.ja.mdLink Japanese contributing guide to the new Code of Conduct +1/-1

Link Japanese contributing guide to the new Code of Conduct

• Replaces the inline Code of Conduct summary with a link to CODE_OF_CONDUCT.ja.md and clarifies that collaboration etiquette is defined there, while keeping a short behavioral summary in place.

CONTRIBUTING.ja.md

CONTRIBUTING.mdLink English contributing guide to the new Code of Conduct +1/-1

Link English contributing guide to the new Code of Conduct

• Updates the Code of conduct section to link to CODE_OF_CONDUCT.md and notes that collaboration etiquette is covered there, while retaining a concise behavioral summary.

CONTRIBUTING.md

@greptile-apps

greptile-apps Bot commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

Adds bilingual Codes of Conduct and includes them with the contribution guides in both published packages.

  • Defines community conduct, collaboration, and enforcement expectations in English and Japanese.
  • Links the new policies from both contribution guides.
  • Extends package build scripts and allowlists to ship the bilingual policy documents.

Confidence Score: 5/5

The PR appears safe to merge with no blocking failure remaining from the reviewed follow-up scope.

No blocking failure remains.

Important Files Changed

Filename Overview
CODE_OF_CONDUCT.md Adds the English community conduct, collaboration, reporting, and enforcement policy.
CODE_OF_CONDUCT.ja.md Adds the corresponding Japanese community policy.
packages/arkor/scripts/copy-root-files.mjs Copies both contribution guides and Codes of Conduct into the package during supported builds.
packages/create-arkor/scripts/copy-root-files.mjs Mirrors the package-document copy behavior for create-arkor.
packages/arkor/package.json Adds the bilingual contribution and conduct documents to the published package allowlist.
packages/create-arkor/package.json Adds the bilingual contribution and conduct documents to the published package allowlist.

Reviews (4): Last reviewed commit: "docs: absolutize repo-only links in CONT..." | Re-trigger Greptile

@qodo-free-for-open-source-projects

qodo-free-for-open-source-projects Bot commented Aug 12, 2026

Copy link
Copy Markdown

Code Review by Qodo

🐞 Bugs (2) 📘 Rule violations (0) 📜 Skill insights (0)

Grey Divider


Remediation recommended

1. No fallback CoC contact 🐞 Bug ☼ Reliability
Description
The new Code of Conduct files define **conduct@arkor.ai** as the sole non-security reporting
channel, but do not document any fallback/private alternative if that mailbox is unavailable. This
can leave contributors with no effective way to report Code of Conduct violations, blocking
enforcement.
Code

CODE_OF_CONDUCT.md[66]

+To report a violation, email **conduct@arkor.ai**. For anything security-related, use security@arkor.ai instead (see [CONTRIBUTING.md](CONTRIBUTING.md)). All reports will be reviewed promptly and handled with as much confidentiality as the situation allows. Maintainers who do not enforce this Code of Conduct in good faith face the same consequences as anyone else.
Evidence
Both new CoC documents explicitly direct general conduct reports to conduct@arkor.ai, and they do
not provide any other general CoC reporting path besides the security-only exception; this makes CoC
reporting depend entirely on that mailbox.

CODE_OF_CONDUCT.md[60-66]
CODE_OF_CONDUCT.ja.md[60-66]

Agent prompt
The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

## Issue description
`CODE_OF_CONDUCT.md` / `CODE_OF_CONDUCT.ja.md` instruct reporters to email `conduct@arkor.ai`, but the repository does not document any fallback reporting route if that address is not reachable/monitored.
### Issue Context
Because this is community safety/reporting infrastructure, the repo should not publish a single-point-of-failure contact channel without either (a) ensuring it is definitely monitored, or (b) documenting a backup option.
### Fix Focus Areas
- CODE_OF_CONDUCT.md[60-66]
- CODE_OF_CONDUCT.ja.md[60-66]
### Expected change
- Either confirm `conduct@arkor.ai` is actively monitored and add a documented fallback (e.g., alternate email or another private reporting mechanism), **or** replace `conduct@arkor.ai` with an already-established monitored contact and keep the security-specific route as-is.

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools



Informational

2. Hardcoded main branch links 🐞 Bug ⚙ Maintainability ⭐ New
Description
CONTRIBUTING.md and CONTRIBUTING.ja.md now hardcode GitHub URLs to arkorlab/arkor on main
(tree/blob), which no longer tracks the viewer’s current ref (forks, release tags, or older
checkouts) and can send readers to mismatched versions of the referenced content.
Code

CONTRIBUTING.md[R64-65]

+| [`e2e/cli`](https://github.com/arkorlab/arkor/tree/main/e2e/cli) | The `arkor` and `create-arkor` CLI surfaces: spawning, scaffolding, build, exit codes, stdout/stderr | vitest spawning the built `dist/bin.mjs` |
+| [`e2e/studio`](https://github.com/arkorlab/arkor/tree/main/e2e/studio) | The Studio SPA served by `arkor dev`: `<meta>` token injection, `/api/*` auth contract, page-level rendering, SSE streaming | Playwright driving Chromium against a real `arkor dev` + an in-process fake cloud-api |
Evidence
The current CONTRIBUTING docs contain absolute links pinned to .../tree/main/... and
.../blob/main/..., which do not vary with the reader’s fork/ref and therefore can diverge from the
version of the document being read.

CONTRIBUTING.md[60-66]
CONTRIBUTING.md[105-108]
CONTRIBUTING.ja.md[59-65]
CONTRIBUTING.ja.md[104-107]

Agent prompt
The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

### Issue description
`CONTRIBUTING.md` / `CONTRIBUTING.ja.md` changed previously-repo-relative links to absolute GitHub URLs pinned to `arkorlab/arkor` and `main`. This breaks “follow the same ref” navigation when the docs are read in a fork or at a tag/older commit.

### Issue Context
The problematic links include both the E2E suite directory references and the `scripts/check-no-em-dash.mts` reference.

### Fix Focus Areas
- CONTRIBUTING.md[60-66]
- CONTRIBUTING.md[105-108]
- CONTRIBUTING.ja.md[59-65]
- CONTRIBUTING.ja.md[104-107]

### Suggested fix
- Prefer restoring relative links (e.g. `(e2e/cli)`, `(scripts/check-no-em-dash.mts)`) so GitHub resolves them against the current repo + ref.
- If the intent is to always point to the canonical upstream repo while avoiding a branch-name pin, consider switching `.../tree/main/...` and `.../blob/main/...` to GitHub’s ref-agnostic `.../tree/HEAD/...` and `.../blob/HEAD/...`.

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools


Grey Divider

Tip of the day
💡 Did you know, you can describe a rule in plain language on the Rules page and Qodo drafts it for you

More tips ↗ | Customize Qodo ↗ | Qodo docs ↗

Grey Divider

Previous review results

Review updated until commit 81029c6 ⚖️ Balanced

Results up to commit ce19ecf


🐞 Bugs (1) 📘 Rule violations (0) 📜 Skill insights (0)


Remediation recommended
1. No fallback CoC contact 🐞 Bug ☼ Reliability
Description
The new Code of Conduct files define **conduct@arkor.ai** as the sole non-security reporting
channel, but do not document any fallback/private alternative if that mailbox is unavailable. This
can leave contributors with no effective way to report Code of Conduct violations, blocking
enforcement.
Code

CODE_OF_CONDUCT.md[66]

+To report a violation, email **conduct@arkor.ai**. For anything security-related, use security@arkor.ai instead (see [CONTRIBUTING.md](CONTRIBUTING.md)). All reports will be reviewed promptly and handled with as much confidentiality as the situation allows. Maintainers who do not enforce this Code of Conduct in good faith face the same consequences as anyone else.
Evidence
Both new CoC documents explicitly direct general conduct reports to conduct@arkor.ai, and they do
not provide any other general CoC reporting path besides the security-only exception; this makes CoC
reporting depend entirely on that mailbox.

CODE_OF_CONDUCT.md[60-66]
CODE_OF_CONDUCT.ja.md[60-66]

Agent prompt
The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

## Issue description
`CODE_OF_CONDUCT.md` / `CODE_OF_CONDUCT.ja.md` instruct reporters to email `conduct@arkor.ai`, but the repository does not document any fallback reporting route if that address is not reachable/monitored.
### Issue Context
Because this is community safety/reporting infrastructure, the repo should not publish a single-point-of-failure contact channel without either (a) ensuring it is definitely monitored, or (b) documenting a backup option.
### Fix Focus Areas
- CODE_OF_CONDUCT.md[60-66]
- CODE_OF_CONDUCT.ja.md[60-66]
### Expected change
- Either confirm `conduct@arkor.ai` is actively monitored and add a documented fallback (e.g., alternate email or another private reporting mechanism), **or** replace `conduct@arkor.ai` with an already-established monitored contact and keep the security-specific route as-is.

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools


Results up to commit 968e285


🐞 Bugs (1) 📘 Rule violations (0) 📜 Skill insights (0)


Remediation recommended
1. No fallback CoC contact 🐞 Bug ☼ Reliability
Description
The new Code of Conduct files define **conduct@arkor.ai** as the sole non-security reporting
channel, but do not document any fallback/private alternative if that mailbox is unavailable. This
can leave contributors with no effective way to report Code of Conduct violations, blocking
enforcement.
Code

CODE_OF_CONDUCT.md[66]

+To report a violation, email **conduct@arkor.ai**. For anything security-related, use security@arkor.ai instead (see [CONTRIBUTING.md](CONTRIBUTING.md)). All reports will be reviewed promptly and handled with as much confidentiality as the situation allows. Maintainers who do not enforce this Code of Conduct in good faith face the same consequences as anyone else.
Evidence
Both new CoC documents explicitly direct general conduct reports to conduct@arkor.ai, and they do
not provide any other general CoC reporting path besides the security-only exception; this makes CoC
reporting depend entirely on that mailbox.

CODE_OF_CONDUCT.md[60-66]
CODE_OF_CONDUCT.ja.md[60-66]

Agent prompt
The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

## Issue description
`CODE_OF_CONDUCT.md` / `CODE_OF_CONDUCT.ja.md` instruct reporters to email `conduct@arkor.ai`, but the repository does not document any fallback reporting route if that address is not reachable/monitored.
### Issue Context
Because this is community safety/reporting infrastructure, the repo should not publish a single-point-of-failure contact channel without either (a) ensuring it is definitely monitored, or (b) documenting a backup option.
### Fix Focus Areas
- CODE_OF_CONDUCT.md[60-66]
- CODE_OF_CONDUCT.ja.md[60-66]
### Expected change
- Either confirm `conduct@arkor.ai` is actively monitored and add a documented fallback (e.g., alternate email or another private reporting mechanism), **or** replace `conduct@arkor.ai` with an already-established monitored contact and keep the security-specific route as-is.

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools


Results up to commit 96b133c


🐞 Bugs (1) 📘 Rule violations (0) 📜 Skill insights (0)


Remediation recommended
1. No fallback CoC contact 🐞 Bug ☼ Reliability
Description
The new Code of Conduct files define **conduct@arkor.ai** as the sole non-security reporting
channel, but do not document any fallback/private alternative if that mailbox is unavailable. This
can leave contributors with no effective way to report Code of Conduct violations, blocking
enforcement.
Code

CODE_OF_CONDUCT.md[66]

+To report a violation, email **conduct@arkor.ai**. For anything security-related, use security@arkor.ai instead (see [CONTRIBUTING.md](CONTRIBUTING.md)). All reports will be reviewed promptly and handled with as much confidentiality as the situation allows. Maintainers who do not enforce this Code of Conduct in good faith face the same consequences as anyone else.
Evidence
Both new CoC documents explicitly direct general conduct reports to conduct@arkor.ai, and they do
not provide any other general CoC reporting path besides the security-only exception; this makes CoC
reporting depend entirely on that mailbox.

CODE_OF_CONDUCT.md[60-66]
CODE_OF_CONDUCT.ja.md[60-66]

Agent prompt
The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

### Issue description
`CODE_OF_CONDUCT.md` / `CODE_OF_CONDUCT.ja.md` instruct reporters to email `conduct@arkor.ai`, but the repository does not document any fallback reporting route if that address is not reachable/monitored.

### Issue Context
Because this is community safety/reporting infrastructure, the repo should not publish a single-point-of-failure contact channel without either (a) ensuring it is definitely monitored, or (b) documenting a backup option.

### Fix Focus Areas
- CODE_OF_CONDUCT.md[60-66]
- CODE_OF_CONDUCT.ja.md[60-66]

### Expected change
- Either confirm `conduct@arkor.ai` is actively monitored and add a documented fallback (e.g., alternate email or another private reporting mechanism), **or** replace `conduct@arkor.ai` with an already-established monitored contact and keep the security-specific route as-is.

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools


Qodo Logo

Comment thread CODE_OF_CONDUCT.md

Depending on severity and history, that action ranges from a private reminder of these rules, through removal of comments, unassignment of issues, or closing of PRs, up to temporary or permanent bans from project spaces. The maintainers' call is final.

To report a violation, email **conduct@arkor.ai**. For anything security-related, use security@arkor.ai instead (see [CONTRIBUTING.md](CONTRIBUTING.md)). All reports will be reviewed promptly and handled with as much confidentiality as the situation allows. Maintainers who do not enforce this Code of Conduct in good faith face the same consequences as anyone else.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remediation recommended

1. No fallback coc contact 🐞 Bug ☼ Reliability

The new Code of Conduct files define **conduct@arkor.ai** as the sole non-security reporting
channel, but do not document any fallback/private alternative if that mailbox is unavailable. This
can leave contributors with no effective way to report Code of Conduct violations, blocking
enforcement.
Agent Prompt
### Issue description
`CODE_OF_CONDUCT.md` / `CODE_OF_CONDUCT.ja.md` instruct reporters to email `conduct@arkor.ai`, but the repository does not document any fallback reporting route if that address is not reachable/monitored.

### Issue Context
Because this is community safety/reporting infrastructure, the repo should not publish a single-point-of-failure contact channel without either (a) ensuring it is definitely monitored, or (b) documenting a backup option.

### Fix Focus Areas
- CODE_OF_CONDUCT.md[60-66]
- CODE_OF_CONDUCT.ja.md[60-66]

### Expected change
- Either confirm `conduct@arkor.ai` is actively monitored and add a documented fallback (e.g., alternate email or another private reporting mechanism), **or** replace `conduct@arkor.ai` with an already-established monitored contact and keep the security-specific route as-is.

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools

@github-code-quality

github-code-quality Bot commented Aug 12, 2026

Copy link
Copy Markdown

Code Coverage Overview

Languages: TypeScript

TypeScript / code-coverage/arkor

The overall coverage in commit 81029c6 in the eng-1050 branch remains at 98%, unchanged from commit 314c6e3 in the main branch.

TypeScript / code-coverage/create-arkor

The overall coverage in commit 81029c6 in the eng-1050 branch remains at 60%, unchanged from commit 314c6e3 in the main branch.

TypeScript / code-coverage/cli-internal

The overall coverage in commit 81029c6 in the eng-1050 branch remains at 97%, unchanged from commit 314c6e3 in the main branch.

TypeScript / code-coverage/studio-app

The overall coverage in commit 81029c6 in the eng-1050 branch remains at 53%, unchanged from commit 314c6e3 in the main branch.


Updated August 14, 2026 09:02 UTC

@codecov

codecov Bot commented Aug 12, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

📢 Thoughts on this report? Let us know!

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 96b133c167

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread CODE_OF_CONDUCT.md

Depending on severity and history, that action ranges from a private reminder of these rules, through removal of comments, unassignment of issues, or closing of PRs, up to temporary or permanent bans from project spaces. The maintainers' call is final.

To report a violation, email **conduct@arkor.ai**. For anything security-related, use security@arkor.ai instead (see [CONTRIBUTING.md](CONTRIBUTING.md)). All reports will be reviewed promptly and handled with as much confidentiality as the situation allows. Maintainers who do not enforce this Code of Conduct in good faith face the same consequences as anyone else.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Provide a working conduct-report address

When someone follows this enforcement instruction to report harassment or another violation, the message will not reach the maintainers because the commit's own open question confirms that conduct@arkor.ai does not exist yet. Provision the alias or replace it with a monitored address before publishing this document; the same unavailable address also appears in the Japanese version.

Useful? React with 👍 / 👎.

Comment thread CONTRIBUTING.md
## Code of conduct

Be kind, assume good faith, and keep technical disagreement technical. Anything else (harassment, personal attacks, exclusionary behavior) is grounds for being asked to leave. The maintainers' call is final.
All Arkor community spaces follow our [Code of Conduct](CODE_OF_CONDUCT.md). It also covers collaboration etiquette: how issues get claimed and assigned, how to avoid duplicate PRs, and how to communicate with maintainers. The short version: be kind, assume good faith, and keep technical disagreement technical. Anything else (harassment, personal attacks, exclusionary behavior) is grounds for being asked to leave. The maintainers' call is final.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Preserve the link in generated package copies

During either published-package build, packages/*/scripts/copy-root-files.mjs copies this file into the package root, while both package manifests ship that copy without CODE_OF_CONDUCT.md. Consumers reading the packaged CONTRIBUTING.md therefore get a relative link whose target is absent; use a repository-absolute URL or include the target in both packages.

AGENTS.md reference: AGENTS.md:L118-L118

Useful? React with 👍 / 👎.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 4

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@CODE_OF_CONDUCT.ja.md`:
- Line 25: Update the Japanese harassment statement around 「望まれない性的な誘い」 to
explicitly cover both unwanted sexual advances and unwelcome sexual attention,
matching the broader scope of the English policy in CODE_OF_CONDUCT.md. Keep the
existing examples and surrounding wording unchanged.
- Line 66: Provide a working mailbox for Code of Conduct reports by creating
conduct@arkor.ai or selecting its replacement, then apply the finalized
reporting address consistently in both CODE_OF_CONDUCT documents and their
referenced contributing guidance.

In `@CODE_OF_CONDUCT.md`:
- Line 9: Split the pledge sentence in the Code of Conduct after “everyone,”
then begin the protected-characteristics list as a second sentence while
preserving the existing Contributor Covenant wording and content.
- Line 66: Provide a working Code of Conduct reporting mailbox by creating
conduct@arkor.ai or selecting its replacement, then apply the final reporting
address consistently in both Code of Conduct documents, including the
violation-reporting guidance.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: dfc0c1ec-e048-4b5b-a86e-ae5a94d1f2f1

📥 Commits

Reviewing files that changed from the base of the PR and between 314c6e3 and 96b133c.

📒 Files selected for processing (4)
  • CODE_OF_CONDUCT.ja.md
  • CODE_OF_CONDUCT.md
  • CONTRIBUTING.ja.md
  • CONTRIBUTING.md
📜 Review details
⏰ Context from checks skipped due to timeout. (165)
  • GitHub Check: cubic · AI code reviewer
  • GitHub Check: install · pnpm-11 · macos-latest · node >=26.0.0 <27
  • GitHub Check: install · pnpm-9 · macos-latest · node 26.0.0
  • GitHub Check: install · npm · macos-latest · node >=24.12.0 <25
  • GitHub Check: install · yarn · macos-latest · node >=26.0.0 <27
  • GitHub Check: install · yarn-berry · macos-latest · node >=26.0.0 <27
  • GitHub Check: install · bun · macos-latest · node >=26.0.0 <27
  • GitHub Check: install · pnpm-11 · macos-latest · node 26.0.0
  • GitHub Check: install · yarn · macos-latest · node 26.0.0
  • GitHub Check: install · npm · macos-latest · node 24.12.0
  • GitHub Check: install · bun · macos-latest · node 24.12.0
  • GitHub Check: install · pnpm-11 · macos-latest · node 24.0.0
  • GitHub Check: install · pnpm-11 · macos-latest · node 24.12.0
  • GitHub Check: install · pnpm-9 · macos-latest · node >=24.12.0 <25
  • GitHub Check: install · pnpm-10 · macos-latest · node >=24.12.0 <25
  • GitHub Check: install · bun · macos-latest · node 24.0.0
  • GitHub Check: install · pnpm-10 · macos-latest · node 24.12.0
  • GitHub Check: install · pnpm-10 · macos-latest · node >=22.22.0 <23
  • GitHub Check: install · yarn-berry · macos-latest · node 24.12.0
  • GitHub Check: install · yarn · macos-latest · node >=22.22.0 <23
  • GitHub Check: install · yarn · macos-latest · node 24.12.0
  • GitHub Check: install · pnpm-11 · windows-latest · node 26.0.0
  • GitHub Check: install · yarn-berry · macos-latest · node 22.22.0
  • GitHub Check: install · pnpm-9 · macos-latest · node 24.12.0
  • GitHub Check: install · pnpm-10 · macos-latest · node 24.0.0
  • GitHub Check: install · yarn · macos-latest · node 22.22.0
  • GitHub Check: install · bun · windows-latest · node 24.12.0
  • GitHub Check: install · npm · macos-latest · node 24.0.0
  • GitHub Check: install · yarn-berry · macos-latest · node >=22.22.0 <23
  • GitHub Check: install · npm · macos-latest · node >=22.22.0 <23
  • GitHub Check: install · pnpm-9 · macos-latest · node 24.0.0
  • GitHub Check: install · pnpm-9 · windows-latest · node 24.12.0
  • GitHub Check: install · bun · macos-latest · node 22.22.0
  • GitHub Check: install · bun · macos-latest · node >=22.22.0 <23
  • GitHub Check: install · npm · macos-latest · node 22.22.0
  • GitHub Check: install · yarn · windows-latest · node 24.12.0
  • GitHub Check: install · pnpm-11 · windows-latest · node 24.12.0
  • GitHub Check: install · pnpm-11 · windows-latest · node >=26.0.0 <27
  • GitHub Check: install · yarn-berry · windows-latest · node >=24.12.0 <25
  • GitHub Check: install · yarn-berry · windows-latest · node >=26.0.0 <27
  • GitHub Check: install · pnpm-10 · macos-latest · node 22.22.0
  • GitHub Check: install · bun · windows-latest · node >=26.0.0 <27
  • GitHub Check: install · yarn · macos-latest · node 24.0.0
  • GitHub Check: install · yarn-berry · macos-latest · node 24.0.0
  • GitHub Check: install · pnpm-11 · macos-latest · node >=22.22.0 <23
  • GitHub Check: install · pnpm-9 · windows-latest · node >=26.0.0 <27
  • GitHub Check: install · bun · windows-latest · node >=24.12.0 <25
  • GitHub Check: install · pnpm-11 · windows-latest · node >=24.12.0 <25
  • GitHub Check: install · npm · windows-latest · node >=26.0.0 <27
  • GitHub Check: install · pnpm-11 · windows-latest · node 24.0.0
  • GitHub Check: install · pnpm-9 · macos-latest · node >=22.22.0 <23
  • GitHub Check: install · npm · windows-latest · node >=24.12.0 <25
  • GitHub Check: install · pnpm-9 · windows-latest · node >=24.12.0 <25
  • GitHub Check: install · pnpm-10 · windows-latest · node 24.12.0
  • GitHub Check: install · pnpm-11 · macos-latest · node 22.22.0
  • GitHub Check: install · yarn-berry · windows-latest · node 24.0.0
  • GitHub Check: install · yarn · windows-latest · node >=26.0.0 <27
  • GitHub Check: install · bun · windows-latest · node 26.0.0
  • GitHub Check: install · pnpm-9 · macos-latest · node 22.22.0
  • GitHub Check: install · pnpm-10 · windows-latest · node 24.0.0
  • GitHub Check: install · pnpm-10 · windows-latest · node 26.0.0
  • GitHub Check: install · npm · windows-latest · node 26.0.0
  • GitHub Check: install · pnpm-9 · windows-latest · node 26.0.0
  • GitHub Check: install · pnpm-10 · windows-latest · node >=26.0.0 <27
  • GitHub Check: install · yarn · windows-latest · node 26.0.0
  • GitHub Check: install · npm · windows-latest · node 24.12.0
  • GitHub Check: install · yarn-berry · windows-latest · node 26.0.0
  • GitHub Check: install · npm · windows-latest · node 24.0.0
  • GitHub Check: install · yarn · windows-latest · node >=24.12.0 <25
  • GitHub Check: install · pnpm-10 · windows-latest · node >=24.12.0 <25
  • GitHub Check: install · yarn-berry · windows-latest · node 24.12.0
  • GitHub Check: install · bun · windows-latest · node 24.0.0
  • GitHub Check: install · yarn · windows-latest · node 24.0.0
  • GitHub Check: install · bun · windows-latest · node >=22.22.0 <23
  • GitHub Check: install · npm · windows-latest · node 22.22.0
  • GitHub Check: install · bun · windows-latest · node 22.22.0
  • GitHub Check: install · pnpm-9 · windows-latest · node >=22.22.0 <23
  • GitHub Check: install · yarn · ubuntu-latest · node 26.0.0
  • GitHub Check: install · yarn · ubuntu-latest · node 22.22.0
  • GitHub Check: install · pnpm-11 · windows-latest · node >=22.22.0 <23
  • GitHub Check: install · yarn · windows-latest · node 22.22.0
  • GitHub Check: install · yarn · windows-latest · node >=22.22.0 <23
  • GitHub Check: install · yarn-berry · windows-latest · node 22.22.0
  • GitHub Check: install · yarn · ubuntu-latest · node >=26.0.0 <27
  • GitHub Check: install · pnpm-11 · windows-latest · node 22.22.0
  • GitHub Check: install · pnpm-10 · windows-latest · node 22.22.0
  • GitHub Check: install · pnpm-10 · ubuntu-latest · node 24.12.0
  • GitHub Check: install · npm · ubuntu-latest · node >=26.0.0 <27
  • GitHub Check: install · pnpm-9 · windows-latest · node 22.22.0
  • GitHub Check: install · yarn-berry · windows-latest · node >=22.22.0 <23
  • GitHub Check: install · bun · ubuntu-latest · node >=26.0.0 <27
  • GitHub Check: install · yarn-berry · ubuntu-latest · node 26.0.0
  • GitHub Check: install · yarn-berry · ubuntu-latest · node >=26.0.0 <27
  • GitHub Check: install · pnpm-9 · windows-latest · node 24.0.0
  • GitHub Check: install · bun · ubuntu-latest · node 26.0.0
  • GitHub Check: install · pnpm-10 · windows-latest · node >=22.22.0 <23
  • GitHub Check: install · pnpm-9 · ubuntu-latest · node >=22.22.0 <23
  • GitHub Check: install · npm · windows-latest · node >=22.22.0 <23
  • GitHub Check: install · bun · ubuntu-latest · node >=24.12.0 <25
  • GitHub Check: install · pnpm-9 · ubuntu-latest · node >=26.0.0 <27
  • GitHub Check: install · pnpm-10 · ubuntu-latest · node >=26.0.0 <27
  • GitHub Check: install · pnpm-11 · ubuntu-latest · node >=26.0.0 <27
  • GitHub Check: install · yarn · ubuntu-latest · node >=24.12.0 <25
  • GitHub Check: install · yarn · ubuntu-latest · node 24.0.0
  • GitHub Check: install · npm · ubuntu-latest · node 26.0.0
  • GitHub Check: install · yarn · ubuntu-latest · node 24.12.0
  • GitHub Check: install · pnpm-9 · ubuntu-latest · node >=24.12.0 <25
  • GitHub Check: install · yarn-berry · ubuntu-latest · node 24.12.0
  • GitHub Check: install · npm · ubuntu-latest · node 24.0.0
  • GitHub Check: install · pnpm-9 · ubuntu-latest · node 24.0.0
  • GitHub Check: install · pnpm-9 · ubuntu-latest · node 24.12.0
  • GitHub Check: install · pnpm-10 · ubuntu-latest · node 24.0.0
  • GitHub Check: install · pnpm-11 · ubuntu-latest · node 24.0.0
  • GitHub Check: install · pnpm-10 · ubuntu-latest · node 26.0.0
  • GitHub Check: install · pnpm-9 · ubuntu-latest · node 26.0.0
  • GitHub Check: install · bun · ubuntu-latest · node 22.22.0
  • GitHub Check: install · npm · ubuntu-latest · node 22.22.0
  • GitHub Check: install · yarn-berry · ubuntu-latest · node 24.0.0
  • GitHub Check: install · npm · ubuntu-latest · node >=24.12.0 <25
  • GitHub Check: install · pnpm-10 · ubuntu-latest · node 22.22.0
  • GitHub Check: install · pnpm-9 · ubuntu-latest · node 22.22.0
  • GitHub Check: install · yarn · ubuntu-latest · node >=22.22.0 <23
  • GitHub Check: install · pnpm-11 · ubuntu-latest · node 22.22.0
  • GitHub Check: install · pnpm-10 · ubuntu-latest · node >=22.22.0 <23
  • GitHub Check: install · yarn-berry · ubuntu-latest · node 22.22.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=24.12.0 <25
  • GitHub Check: typecheck · lint · test · build · macos-latest · node 22.22.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=24.8.0 <24.10.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.5.0 <24.8.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node 26.0.0
  • GitHub Check: coverage · upload to Codecov
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=24.12.0 <25
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=24.8.0 <24.10.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=24.1.0 <24.3.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=24.10.0 <24.12.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node 26.0.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.10.0 <24.12.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.3.0 <24.5.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=26.0.0 <27
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.1.0 <24.3.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=24.10.0 <24.12.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=24.0.0 <24.1.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=26.0.0 <27
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.0.0 <24.1.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node 24.12.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.12.0 <25
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=22.22.0 <23
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=24.5.0 <24.8.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node 26.0.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node >=24.3.0 <24.5.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.8.0 <24.10.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=24.3.0 <24.5.0
  • GitHub Check: typecheck · lint · test · build · macos-latest · node 24.12.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node 22.22.0
  • GitHub Check: typecheck · lint · test · build · windows-latest · node 22.22.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=26.0.0 <27
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=22.22.0 <23
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node 24.12.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=24.1.0 <24.3.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=24.0.0 <24.1.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=24.5.0 <24.8.0
  • GitHub Check: typecheck · lint · test · build · ubuntu-latest · node >=22.22.0 <23
  • GitHub Check: Analyze (javascript-typescript)
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=22.22.0 <23
  • GitHub Check: typecheck · lint · test · build · windows-latest · node >=24.1.0 <24.3.0
🧰 Additional context used
📓 Path-based instructions (4)
CONTRIBUTING{,.ja}.md

📄 CodeRabbit inference engine (AGENTS.md)

When editing CONTRIBUTING.md, update the paired CONTRIBUTING.ja.md in the same change.

Files:

  • CONTRIBUTING.md
  • CONTRIBUTING.ja.md
**/{*.md,*.mdx,*.yaml,*.yml}

📄 CodeRabbit inference engine (AGENTS.md)

Do not format Markdown, MDX, YAML, or YML files with oxfmt; these are excluded because documentation anchors and deliberate YAML layout must remain hand-managed.

Files:

  • CONTRIBUTING.md
  • CONTRIBUTING.ja.md
  • CODE_OF_CONDUCT.md
  • CODE_OF_CONDUCT.ja.md
**/*

📄 CodeRabbit inference engine (CONTRIBUTING.ja.md)

**/*: コードのどこでもエムダッシュ (U+2014) は使いません。
Markdown (このファイルを含む) は ESLint ルールの対象外です。

Files:

  • CONTRIBUTING.md
  • CONTRIBUTING.ja.md
  • CODE_OF_CONDUCT.md
  • CODE_OF_CONDUCT.ja.md
**/*.{yaml,yml,md,json,html}

📄 CodeRabbit inference engine (CONTRIBUTING.md)

To extend the same convention to yaml, md, json, html, and root-level config, the scripts/check-no-em-dash.mts repo-wide guard scans every tracked file via git grep and fails on the em-dash glyph or its HTML entity.

Files:

  • CONTRIBUTING.md
  • CONTRIBUTING.ja.md
  • CODE_OF_CONDUCT.md
  • CODE_OF_CONDUCT.ja.md
🧠 Learnings (5)
📓 Common learnings
Learnt from: CR
Repo: arkorlab/arkor PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-07-24T09:55:04.181Z
Learning: Applies to CONTRIBUTING{,.ja}.md : When editing `CONTRIBUTING.md`, update the paired `CONTRIBUTING.ja.md` in the same change.
Learnt from: CR
Repo: arkorlab/arkor PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-07-24T09:55:04.181Z
Learning: Applies to README{,.ja}.md : When editing `README.md`, update the paired `README.ja.md` in the same change.
Learnt from: CR
Repo: arkorlab/arkor PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-07-24T09:55:04.181Z
Learning: Applies to docs/**/*.mdx : Keep English and Japanese documentation paired: changes under `docs/` must also update the corresponding files under `docs/ja/`. Verify Mintlify-generated anchors before adding cross-page links; preserve `/`, `=`, and full-width parentheses while accounting for stripped ASCII punctuation and backticks.
Learnt from: CR
Repo: arkorlab/arkor

Timestamp: 2026-08-12T03:43:42.646Z
Learning: If you have an idea for a non-trivial change (new SDK factory, CLI command, Studio view), please open an issue first so we can align on the API shape before you write code.
📚 Learning: 2026-07-24T09:55:04.181Z
Learnt from: CR
Repo: arkorlab/arkor PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-07-24T09:55:04.181Z
Learning: Applies to CONTRIBUTING{,.ja}.md : When editing `CONTRIBUTING.md`, update the paired `CONTRIBUTING.ja.md` in the same change.

Applied to files:

  • CONTRIBUTING.ja.md
  • CODE_OF_CONDUCT.ja.md
📚 Learning: 2026-07-24T09:55:04.181Z
Learnt from: CR
Repo: arkorlab/arkor PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-07-24T09:55:04.181Z
Learning: Applies to README{,.ja}.md : When editing `README.md`, update the paired `README.ja.md` in the same change.

Applied to files:

  • CONTRIBUTING.ja.md
  • CODE_OF_CONDUCT.ja.md
📚 Learning: 2026-08-07T08:54:24.838Z
Learnt from: CR
Repo: arkorlab/arkor PR: 0
File: CONTRIBUTING.ja.md:0-0
Timestamp: 2026-08-07T08:54:24.838Z
Learning: 新しい SDK ファクトリ、CLI コマンド、Studio ビューなどの非自明な変更は、実装前に Issue で API の形について合意を得る。

Applied to files:

  • CONTRIBUTING.ja.md
📚 Learning: 2026-08-07T08:54:24.838Z
Learnt from: CR
Repo: arkorlab/arkor PR: 0
File: CONTRIBUTING.ja.md:0-0
Timestamp: 2026-08-07T08:54:24.838Z
Learning: 貢献物はリポジトリの LICENSE.md に定めるライセンスの下で公開されることに同意する。

Applied to files:

  • CONTRIBUTING.ja.md
🪛 LanguageTool
CODE_OF_CONDUCT.md

[style] ~8-~8: This sentence is over 40 words long. Consider splitting it up, as shorter sentences make the text easier to read.
Context: ...ers). Both are binding. ## Our pledge We as members, contributors, and maintainers pledge to make participation in the Arkor community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation. We pledge to act and interact in ways ...

(TOO_LONG_SENTENCE)


[style] ~26-~26: Try using a synonym here to strengthen your wording.
Context: ...on. - Trolling, insulting or derogatory comments, and personal or political attacks. - P...

(COMMENT_REMARK)


[style] ~45-~45: Since ownership is already implied, this phrasing may be redundant.
Context: ... weigh in. Do not silently race it with your own PR. - Link the issue. Reference the...

(PRP_OWN)

🔇 Additional comments (5)
CODE_OF_CONDUCT.md (2)

1-8: LGTM!

Also applies to: 10-65, 68-70


66-66: 🔒 Security & Privacy | 🟠 Major | ⚡ Quick win

Use one confirmed reporting channel in both conduct policies.

The same unavailable conduct@arkor.ai address appears in both documents. Contributors cannot report violations until the mailbox exists or the address is replaced.

  • CODE_OF_CONDUCT.md#L66-L66: create conduct@arkor.ai or replace it with a working address.
  • CODE_OF_CONDUCT.ja.md#L66-L66: apply the same contact change in the Japanese policy.

The PR objective states that conduct@arkor.ai must be created or replaced before merge.

⛔ Skipped due to learnings
Learnt from: CR
Repo: arkorlab/arkor PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-07-24T09:55:04.181Z
Learning: Applies to CONTRIBUTING{,.ja}.md : When editing `CONTRIBUTING.md`, update the paired `CONTRIBUTING.ja.md` in the same change.
Learnt from: CR
Repo: arkorlab/arkor PR: 0
File: CONTRIBUTING.md:0-0
Timestamp: 2026-08-07T08:54:17.077Z
Learning: Report security issues privately by emailing securityarkor.ai instead of filing a public issue.
Learnt from: CR
Repo: arkorlab/arkor PR: 0
File: CONTRIBUTING.ja.md:0-0
Timestamp: 2026-08-07T08:54:24.838Z
Learning: セキュリティ問題は公開 GitHub Issue ではなく securityarkor.ai に報告する。
CODE_OF_CONDUCT.ja.md (1)

1-24: LGTM!

Also applies to: 26-65, 68-70

CONTRIBUTING.md (1)

131-131: LGTM!

CONTRIBUTING.ja.md (1)

130-130: LGTM!

Comment thread CODE_OF_CONDUCT.ja.md Outdated
Comment thread CODE_OF_CONDUCT.ja.md Outdated

深刻度と経緯に応じて、その措置は、このルールの非公開でのリマインドから、コメントの削除、Issue のアサイン解除、PR のクローズ、そしてプロジェクトスペースからの一時的または恒久的な追放までの範囲に及びます。メンテナーの判断が最終です。

違反を報告するには、**conduct@arkor.ai** へメールしてください。セキュリティに関わる内容は代わりに security@arkor.ai を使ってください ([CONTRIBUTING.ja.md](CONTRIBUTING.ja.md) を参照)。すべての報告は速やかに確認され、状況が許す限りの機密性をもって扱われます。この行動規範を誠実に執行しないメンテナーも、他の全員と同じ措置の対象になります。

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔒 Security & Privacy | 🟠 Major | ⚡ Quick win

Provide a working conduct-reporting address before merge.

conduct@arkor.ai is the only reporting channel for Code of Conduct violations, but the PR objective states that this address does not yet exist. Create the mailbox or replace the address, then apply the final value in both conduct documents.

The PR objective states that conduct@arkor.ai must be created or replaced before merge.

[skip_comment]

⛔ Skipped due to learnings
Learnt from: CR
Repo: arkorlab/arkor PR: 0
File: CONTRIBUTING.md:0-0
Timestamp: 2026-08-07T08:54:17.077Z
Learning: Report security issues privately by emailing securityarkor.ai instead of filing a public issue.
Learnt from: CR
Repo: arkorlab/arkor PR: 0
File: CONTRIBUTING.ja.md:0-0
Timestamp: 2026-08-07T08:54:24.838Z
Learning: セキュリティ問題は公開 GitHub Issue ではなく securityarkor.ai に報告する。
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@CODE_OF_CONDUCT.ja.md` at line 66, Provide a working mailbox for Code of
Conduct reports by creating conduct@arkor.ai or selecting its replacement, then
apply the finalized reporting address consistently in both CODE_OF_CONDUCT
documents and their referenced contributing guidance.

Comment thread CODE_OF_CONDUCT.md

## Our pledge

We as members, contributors, and maintainers pledge to make participation in the Arkor community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Split the pledge sentence for readability.

Line 9 contains a long list of protected characteristics in one sentence. Split the sentence after everyone and place the list in a second sentence. Preserve the Contributor Covenant wording.

LanguageTool flagged this sentence as longer than 40 words.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@CODE_OF_CONDUCT.md` at line 9, Split the pledge sentence in the Code of
Conduct after “everyone,” then begin the protected-characteristics list as a
second sentence while preserving the existing Contributor Covenant wording and
content.

Source: Linters/SAST tools

Comment thread CODE_OF_CONDUCT.md

Depending on severity and history, that action ranges from a private reminder of these rules, through removal of comments, unassignment of issues, or closing of PRs, up to temporary or permanent bans from project spaces. The maintainers' call is final.

To report a violation, email **conduct@arkor.ai**. For anything security-related, use security@arkor.ai instead (see [CONTRIBUTING.md](CONTRIBUTING.md)). All reports will be reviewed promptly and handled with as much confidentiality as the situation allows. Maintainers who do not enforce this Code of Conduct in good faith face the same consequences as anyone else.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔒 Security & Privacy | 🟠 Major | ⚡ Quick win

Provide a working conduct-reporting address before merge.

conduct@arkor.ai is the only reporting channel for Code of Conduct violations, but the PR objective states that this address does not yet exist. Create the mailbox or replace the address, then apply the final value in both conduct documents.

The PR objective states that conduct@arkor.ai must be created or replaced before merge.

[skip_comment]

⛔ Skipped due to learnings
Learnt from: CR
Repo: arkorlab/arkor PR: 0
File: CONTRIBUTING.md:0-0
Timestamp: 2026-08-07T08:54:17.077Z
Learning: Report security issues privately by emailing securityarkor.ai instead of filing a public issue.
Learnt from: CR
Repo: arkorlab/arkor PR: 0
File: CONTRIBUTING.ja.md:0-0
Timestamp: 2026-08-07T08:54:24.838Z
Learning: セキュリティ問題は公開 GitHub Issue ではなく securityarkor.ai に報告する。
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@CODE_OF_CONDUCT.md` at line 66, Provide a working Code of Conduct reporting
mailbox by creating conduct@arkor.ai or selecting its replacement, then apply
the final reporting address consistently in both Code of Conduct documents,
including the violation-reporting guidance.

@soleil-colza
soleil-colza requested a review from k-taro56 August 12, 2026 03:47

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 issues found across 4 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="CODE_OF_CONDUCT.md">

<violation number="1" location="CODE_OF_CONDUCT.md:66">
P1: The enforcement section instructs users to report violations to conduct@arkor.ai, which does not exist yet (acknowledged in the PR description). Reports to a bouncing address are silently lost, defeating the Code of Conduct's reporting mechanism; create the alias or point to an existing contact before merging.</violation>
</file>

<file name="CODE_OF_CONDUCT.ja.md">

<violation number="1" location="CODE_OF_CONDUCT.ja.md:66">
P2: The report address conduct@arkor.ai does not exist — violations reported there would go nowhere, breaking the CoC's only enforcement channel. Create the alias or point to a working contact before merging.</violation>
</file>

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment thread CODE_OF_CONDUCT.md

Depending on severity and history, that action ranges from a private reminder of these rules, through removal of comments, unassignment of issues, or closing of PRs, up to temporary or permanent bans from project spaces. The maintainers' call is final.

To report a violation, email **conduct@arkor.ai**. For anything security-related, use security@arkor.ai instead (see [CONTRIBUTING.md](CONTRIBUTING.md)). All reports will be reviewed promptly and handled with as much confidentiality as the situation allows. Maintainers who do not enforce this Code of Conduct in good faith face the same consequences as anyone else.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1: The enforcement section instructs users to report violations to conduct@arkor.ai, which does not exist yet (acknowledged in the PR description). Reports to a bouncing address are silently lost, defeating the Code of Conduct's reporting mechanism; create the alias or point to an existing contact before merging.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At CODE_OF_CONDUCT.md, line 66:

<comment>The enforcement section instructs users to report violations to conduct@arkor.ai, which does not exist yet (acknowledged in the PR description). Reports to a bouncing address are silently lost, defeating the Code of Conduct's reporting mechanism; create the alias or point to an existing contact before merging.</comment>

<file context>
@@ -0,0 +1,70 @@
+
+Depending on severity and history, that action ranges from a private reminder of these rules, through removal of comments, unassignment of issues, or closing of PRs, up to temporary or permanent bans from project spaces. The maintainers' call is final.
+
+To report a violation, email **conduct@arkor.ai**. For anything security-related, use security@arkor.ai instead (see [CONTRIBUTING.md](CONTRIBUTING.md)). All reports will be reviewed promptly and handled with as much confidentiality as the situation allows. Maintainers who do not enforce this Code of Conduct in good faith face the same consequences as anyone else.
+
+## Attribution
</file context>

Comment thread CODE_OF_CONDUCT.ja.md Outdated

深刻度と経緯に応じて、その措置は、このルールの非公開でのリマインドから、コメントの削除、Issue のアサイン解除、PR のクローズ、そしてプロジェクトスペースからの一時的または恒久的な追放までの範囲に及びます。メンテナーの判断が最終です。

違反を報告するには、**conduct@arkor.ai** へメールしてください。セキュリティに関わる内容は代わりに security@arkor.ai を使ってください ([CONTRIBUTING.ja.md](CONTRIBUTING.ja.md) を参照)。すべての報告は速やかに確認され、状況が許す限りの機密性をもって扱われます。この行動規範を誠実に執行しないメンテナーも、他の全員と同じ措置の対象になります。

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: The report address conduct@arkor.ai does not exist — violations reported there would go nowhere, breaking the CoC's only enforcement channel. Create the alias or point to a working contact before merging.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At CODE_OF_CONDUCT.ja.md, line 66:

<comment>The report address conduct@arkor.ai does not exist — violations reported there would go nowhere, breaking the CoC's only enforcement channel. Create the alias or point to a working contact before merging.</comment>

<file context>
@@ -0,0 +1,70 @@
+
+深刻度と経緯に応じて、その措置は、このルールの非公開でのリマインドから、コメントの削除、Issue のアサイン解除、PR のクローズ、そしてプロジェクトスペースからの一時的または恒久的な追放までの範囲に及びます。メンテナーの判断が最終です。
+
+違反を報告するには、**conduct@arkor.ai** へメールしてください。セキュリティに関わる内容は代わりに security@arkor.ai を使ってください ([CONTRIBUTING.ja.md](CONTRIBUTING.ja.md) を参照)。すべての報告は速やかに確認され、状況が許す限りの機密性をもって扱われます。この行動規範を誠実に執行しないメンテナーも、他の全員と同じ措置の対象になります。
+
+## 帰属 (Attribution)
</file context>

@k-taro56 k-taro56 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it would be good to clarify that an issue isn’t necessarily required before creating a PR

Comment thread CODE_OF_CONDUCT.ja.md Outdated
@@ -0,0 +1,70 @@
# 行動規範 (Code of Conduct)

Arkor はオープンに開発されています。TypeScript ネイティブなファインチューニングを実現したい人たちと一緒に、その人たちのために作られています。このドキュメントは、Arkor のすべてのコミュニティスペースでお互いにどう接するかを定めたものです: この GitHub リポジトリ (Issue、プルリクエスト、Discussions)、[Discord サーバー](https://discord.gg/YujCZYGrEZ)、そしてプロジェクトを代表して発信・参加するすべての公式アカウントやイベントが対象です。

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Arkor はオープンに開発されています。TypeScript ネイティブなファインチューニングを実現したい人たちと一緒に、その人たちのために作られています。このドキュメントは、Arkor のすべてのコミュニティスペースでお互いにどう接するかを定めたものです: この GitHub リポジトリ (Issue、プルリクエスト、Discussions)[Discord サーバー](https://discord.gg/YujCZYGrEZ)、そしてプロジェクトを代表して発信・参加するすべての公式アカウントやイベントが対象です。
Arkor はオープンに開発されています。TypeScript ネイティブなファインチューニングを実現したい人たちと一緒に、その人たちのために作られています。このドキュメントは、Arkor のすべてのコミュニティースペースでお互いにどう接するかを定めたものです。この GitHub リポジトリー(Issue、プルリクエスト、Discussions[Discord サーバー](https://discord.arkor.ai)、そしてプロジェクトを代表して発信・参加するすべての公式アカウントやイベントが対象です。

Comment thread CODE_OF_CONDUCT.ja.md Outdated

## 私たちの誓い

メンバー、コントリビューター、メンテナーである私たちは、年齢、体格、目に見える・見えない障害、民族、性的特徴、性自認と性表現、経験の程度、学歴、社会経済的地位、国籍、外見、人種、宗教、性的アイデンティティと性的指向にかかわらず、すべての人にとってハラスメントのない参加体験を Arkor コミュニティで実現することを誓います。

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
メンバー、コントリビューター、メンテナーである私たちは、年齢、体格、目に見える・見えない障害、民族、性的特徴、性自認と性表現、経験の程度、学歴、社会経済的地位、国籍、外見、人種、宗教、性的アイデンティティと性的指向にかかわらず、すべての人にとってハラスメントのない参加体験を Arkor コミュニティで実現することを誓います
メンバー、コントリビューター、メンテナーである私たちは、年齢、体格、目に見える・見えない障害、民族、性的特徴、性自認と性表現、経験の程度、学歴、社会経済的地位、国籍、外見、人種、宗教、性的アイデンティティーと性的指向にかかわらず、すべての人にとってハラスメントのない参加体験を Arkor コミュニティーで実現することを誓います

Comment thread CODE_OF_CONDUCT.ja.md Outdated

メンバー、コントリビューター、メンテナーである私たちは、年齢、体格、目に見える・見えない障害、民族、性的特徴、性自認と性表現、経験の程度、学歴、社会経済的地位、国籍、外見、人種、宗教、性的アイデンティティと性的指向にかかわらず、すべての人にとってハラスメントのない参加体験を Arkor コミュニティで実現することを誓います。

私たちは、オープンで、歓迎的で、多様で、インクルーシブで、健全なコミュニティに貢献するように行動し、交流することを誓います。

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
私たちは、オープンで、歓迎的で、多様で、インクルーシブで、健全なコミュニティに貢献するように行動し、交流することを誓います。
私たちは、オープンで、歓迎的で、多様で、インクルーシブで、健全なコミュニティーに貢献するように行動し、交流することを誓います。

Comment thread CODE_OF_CONDUCT.ja.md Outdated
- 誠実さを仮定し、技術的な意見の相違を技術的なまま保つこと。
- 建設的なフィードバックを与え、また素直に受け入れること。
- 責任を受け入れ、自分の間違いによって影響を受けた人に謝罪し、その経験から学ぶこと。
- 自分だけでなく、コミュニティとプロジェクトにとって何が最善かに目を向けること。

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- 自分だけでなく、コミュニティとプロジェクトにとって何が最善かに目を向けること
- 自分だけでなく、コミュニティーとプロジェクトにとって何が最善かに目を向けること

Comment thread CODE_OF_CONDUCT.ja.md Outdated
メンテナーとコントリビューターは、自分の時間を提供している人たちです。協働する仲間であって、あなた専属のサポート窓口ではなく、友達になる義務もありません。

- **公開の場で、本題に沿って。** 質問は Issue、Discussions、または Discord の公開チャンネルでしてください。招待されていない限り、コードレビュー、マージの依頼、アサインの依頼、一般的なサポートを目的としてメンテナーやコントリビューターに DM を送らないでください。
- **スパムと催促の連投はしない。** 同じ人への繰り返しのメンション、毎日の「進捗どうですか?」、プロジェクトの場と無関係な雑談・自己宣伝・仕事の勧誘はやめてください。1 週間ほど動きがなければ、該当スレッドで丁寧に一度だけリマインドするのは問題ありません。

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- **スパムと催促の連投はしない。** 同じ人への繰り返しのメンション、毎日の「進捗どうですか?」、プロジェクトの場と無関係な雑談・自己宣伝・仕事の勧誘はやめてください。1 週間ほど動きがなければ、該当スレッドで丁寧に一度だけリマインドするのは問題ありません。
- **スパムと催促の連投はしない。** 同じ人への繰り返しのメンション、毎日の「進捗どうですか」、プロジェクトの場と無関係な雑談・自己宣伝・仕事の勧誘はやめてください。1 週間ほど動きがなければ、該当スレッドで丁寧に一度だけリマインドするのは問題ありません。

Comment thread CODE_OF_CONDUCT.ja.md Outdated

- **1 Issue に 1 PR、重複は作らない。** PR を開く前に、同じ Issue や同じ変更に対するオープンな PR がないか検索してください。既に存在する場合は、競合する PR を新しく開くのではなく、そちらに協力してください (レビューする、コメントする、動作確認する)。重複した PR は、最も早くからアクティブなものを優先してクローズします。
- **別のアプローチがあるなら、まず議論。** 既存の PR の方向性が間違っていると思う場合は、その Issue または PR 上で代替案を説明し、メンテナーの判断を仰いでください。黙って自分の PR で追い抜こうとしないでください。
- **Issue をリンクする。** PR が対応する Issue を参照してください (`Closes #123`)。アサインと重複のチェックが容易になります。

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- **Issue をリンクする。** PR が対応する Issue を参照してください (`Closes #123`)。アサインと重複のチェックが容易になります。
- **Issue をリンクする。** PR が対応する Issue を参照してください`Closes #123`。アサインと重複のチェックが容易になります。

Comment thread CODE_OF_CONDUCT.ja.md Outdated

### プルリクエスト

- **1 Issue に 1 PR、重複は作らない。** PR を開く前に、同じ Issue や同じ変更に対するオープンな PR がないか検索してください。既に存在する場合は、競合する PR を新しく開くのではなく、そちらに協力してください (レビューする、コメントする、動作確認する)。重複した PR は、最も早くからアクティブなものを優先してクローズします。

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- **1 Issue に 1 PR、重複は作らない。** PR を開く前に、同じ Issue や同じ変更に対するオープンな PR がないか検索してください。既に存在する場合は、競合する PR を新しく開くのではなく、そちらに協力してください (レビューする、コメントする、動作確認する)。重複した PR は、最も早くからアクティブなものを優先してクローズします。
- **1 Issue に 1 PR、重複は作らない。** PR を開く前に、同じ Issue や同じ変更に対するオープンな PR がないか検索してください。既に存在する場合は、競合する PR を新しく開くのではなく、そちらに協力してくださいレビューする、コメントする、動作確認する。重複した PR は、最も早くからアクティブなものを優先してクローズします。

Comment thread CODE_OF_CONDUCT.ja.md Outdated

- 公開・非公開を問わず、あらゆる形のハラスメント。性的な言葉や画像の使用、望まれない性的な誘いを含みます。
- トローリング、侮辱的・軽蔑的なコメント、個人攻撃や政治的な攻撃。
- 明示的な許可のない、他者の個人情報 (住所やメールアドレスなど) の公開。

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- 明示的な許可のない、他者の個人情報 (住所やメールアドレスなど) の公開。
- 明示的な許可のない、他者の個人情報住所やメールアドレスなどの公開。

Comment thread CODE_OF_CONDUCT.ja.md Outdated

Arkor はオープンに開発されています。TypeScript ネイティブなファインチューニングを実現したい人たちと一緒に、その人たちのために作られています。このドキュメントは、Arkor のすべてのコミュニティスペースでお互いにどう接するかを定めたものです: この GitHub リポジトリ (Issue、プルリクエスト、Discussions)、[Discord サーバー](https://discord.gg/YujCZYGrEZ)、そしてプロジェクトを代表して発信・参加するすべての公式アカウントやイベントが対象です。

この文書は 2 つの部分からなります: **どう振る舞うか** (行動の基準) と、**どう協働するか** (Issue・プルリクエスト・メンテナーとのやりとりのエチケット) です。どちらも守るべきルールです。

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
この文書は 2 つの部分からなります: **どう振る舞うか** (行動の基準) と、**どう協働するか** (Issue・プルリクエスト・メンテナーとのやりとりのエチケット) です。どちらも守るべきルールです。
この文書は 2 つの部分からなります: **どう振る舞うか**行動の基準と、**どう協働するか**Issue・プルリクエスト・メンテナーとのやりとりのエチケットです。どちらも守るべきルールです。

Comment thread CODE_OF_CONDUCT.ja.md Outdated
@@ -0,0 +1,70 @@
# 行動規範 (Code of Conduct)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
# 行動規範 (Code of Conduct)
# 行動規範Code of Conduct

- Apply reviewer suggestions on the Japanese documents: long-vowel
  katakana forms, full-width parentheses and question mark, sentence
  punctuation, and the discord.arkor.ai vanity URL (mirrored in the
  English document so the pair stays in sync).
- Broaden the Japanese harassment wording to cover unwelcome sexual
  attention as well as advances, matching the English policy.
- Ship CODE_OF_CONDUCT.md and CODE_OF_CONDUCT.ja.md in both published
  tarballs via copy-root-files.mjs, package.json files, and .gitignore,
  so the packaged CONTRIBUTING.md link resolves.

@drift-check drift-check Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Documentation drift

Code Review Bot flagged 1 possible documentation drift(s). These are advisory.

  • AGENTS.md (info): The 'Generated files' bullet in the 'Non-obvious gotchas' section lists 'packages/*/CONTRIBUTING.md' and 'packages/arkor/docs/', but it omits 'packages/*/CODE_OF_CONDUCT.md' and 'packages/*/CODE_OF_CONDUCT.ja.md' which are now copied to package directories as seen in 'packages/arkor/scripts/copy-root-files.mjs'. — suggested: Update the 'Generated files' bullet in the 'Non-obvious gotchas' section to: "- **Generated files** copied into package dirs are gitignored: 'packages/*/CONTRIBUTING.md' (from root), 'packages/*/README.ja.md' (from root), 'packages/*/CODE_OF_CONDUCT.md' (from root), and 'packages/*/CODE_OF_CONDUCT.ja.md' (from root). Edit the source under repo root, not the copies."

Results are for commit 968e285. On newer commits, the bot's summary comment reflects the latest run.

@qodo-free-for-open-source-projects

Copy link
Copy Markdown

Code review by qodo was updated up to the latest commit 968e285

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 968e2851ec

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

"README.ja.md"
"README.ja.md",
"CODE_OF_CONDUCT.md",
"CODE_OF_CONDUCT.ja.md"

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Ship the Japanese contribution guide alongside this file

When either package is published, CODE_OF_CONDUCT.ja.md is included but its three relative links to CONTRIBUTING.ja.md are broken because neither copy-root-files.mjs nor either package's files list includes that target. Add CONTRIBUTING.ja.md to both copy/package lists, or make those links repository-absolute.

Useful? React with 👍 / 👎.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 issues found across 8 files (changes from recent commits).

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="CODE_OF_CONDUCT.md">

<violation number="1" location="CODE_OF_CONDUCT.md:3">
P3: This change points the Code of Conduct's Discord link to https://discord.arkor.ai (which resolves to invite code WjpUu5QsGZ), while every other Discord reference in the repo — README.md, README.ja.md, CONTRIBUTING.md, and CONTRIBUTING.ja.md — still uses https://discord.gg/YujCZYGrEZ. The community now sees two different invite links depending on which doc they read. Align them: either keep the existing discord.gg/YujCZYGrEZ here or, if discord.arkor.ai is the intended branded link, update the other four files in this same PR.</violation>
</file>

<file name="packages/arkor/package.json">

<violation number="1" location="packages/arkor/package.json:41">
P3: THE Japanese Code of Conduct is now shipped in the published tarball, but it contains three relative links to `CONTRIBUTING.ja.md` (lines 49, 58, 66), which is not included in either copy-root-files.mjs FILES list or the package `files` array. In the npm tarball those links resolve to a file that does not exist. Add `CONTRIBUTING.ja.md` to the copy script and both packages' `files` arrays (and .gitignore) so the shipped Japanese CoC links stay valid, or the links will be broken in node_modules.</violation>
</file>

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment thread CODE_OF_CONDUCT.md Outdated
@@ -0,0 +1,70 @@
# Code of Conduct

Arkor is built in the open, with and for people who want TypeScript-native fine-tuning to exist. This document describes how we treat each other in every Arkor community space: this GitHub repository (issues, pull requests, discussions), the [Discord server](https://discord.arkor.ai), and any official account or event where someone represents the project.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P3: This change points the Code of Conduct's Discord link to https://discord.arkor.ai (which resolves to invite code WjpUu5QsGZ), while every other Discord reference in the repo — README.md, README.ja.md, CONTRIBUTING.md, and CONTRIBUTING.ja.md — still uses https://discord.gg/YujCZYGrEZ. The community now sees two different invite links depending on which doc they read. Align them: either keep the existing discord.gg/YujCZYGrEZ here or, if discord.arkor.ai is the intended branded link, update the other four files in this same PR.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At CODE_OF_CONDUCT.md, line 3:

<comment>This change points the Code of Conduct's Discord link to https://discord.arkor.ai (which resolves to invite code WjpUu5QsGZ), while every other Discord reference in the repo — README.md, README.ja.md, CONTRIBUTING.md, and CONTRIBUTING.ja.md — still uses https://discord.gg/YujCZYGrEZ. The community now sees two different invite links depending on which doc they read. Align them: either keep the existing discord.gg/YujCZYGrEZ here or, if discord.arkor.ai is the intended branded link, update the other four files in this same PR.</comment>

<file context>
@@ -1,6 +1,6 @@
 # Code of Conduct
 
-Arkor is built in the open, with and for people who want TypeScript-native fine-tuning to exist. This document describes how we treat each other in every Arkor community space: this GitHub repository (issues, pull requests, discussions), the [Discord server](https://discord.gg/YujCZYGrEZ), and any official account or event where someone represents the project.
+Arkor is built in the open, with and for people who want TypeScript-native fine-tuning to exist. This document describes how we treat each other in every Arkor community space: this GitHub repository (issues, pull requests, discussions), the [Discord server](https://discord.arkor.ai), and any official account or event where someone represents the project.
 
 It has two parts: **how we behave** (the conduct baseline) and **how we collaborate** (etiquette for issues, pull requests, and talking to maintainers). Both are binding.
</file context>

"README.ja.md"
"README.ja.md",
"CODE_OF_CONDUCT.md",
"CODE_OF_CONDUCT.ja.md"

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P3: THE Japanese Code of Conduct is now shipped in the published tarball, but it contains three relative links to CONTRIBUTING.ja.md (lines 49, 58, 66), which is not included in either copy-root-files.mjs FILES list or the package files array. In the npm tarball those links resolve to a file that does not exist. Add CONTRIBUTING.ja.md to the copy script and both packages' files arrays (and .gitignore) so the shipped Japanese CoC links stay valid, or the links will be broken in node_modules.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At packages/arkor/package.json, line 41:

<comment>THE Japanese Code of Conduct is now shipped in the published tarball, but it contains three relative links to `CONTRIBUTING.ja.md` (lines 49, 58, 66), which is not included in either copy-root-files.mjs FILES list or the package `files` array. In the npm tarball those links resolve to a file that does not exist. Add `CONTRIBUTING.ja.md` to the copy script and both packages' `files` arrays (and .gitignore) so the shipped Japanese CoC links stay valid, or the links will be broken in node_modules.</comment>

<file context>
@@ -36,7 +36,9 @@
-    "README.ja.md"
+    "README.ja.md",
+    "CODE_OF_CONDUCT.md",
+    "CODE_OF_CONDUCT.ja.md"
   ],
   "engines": {
</file context>

@soleil-colza soleil-colza self-assigned this Aug 13, 2026
- Point every Discord reference (README, README.ja, CONTRIBUTING,
  CONTRIBUTING.ja) at the discord.arkor.ai vanity URL so the repo no
  longer mixes two invite links.
- Ship CONTRIBUTING.ja.md in both published tarballs so the relative
  links from the packaged CODE_OF_CONDUCT.ja.md resolve.
@qodo-free-for-open-source-projects

Copy link
Copy Markdown

Code review by qodo was updated up to the latest commit ce19ecf

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ce19ecf4fe

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

"docs",
"CONTRIBUTING.md",
"README.ja.md"
"CONTRIBUTING.ja.md",

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Make repository-only links work in the packaged guide

When either published package is built and packed, the newly included CONTRIBUTING.ja.md still links relatively to e2e/cli, e2e/studio, and scripts/check-no-em-dash.mts (lines 63–64 and 106), none of which is included in either tarball. Consumers following those links from the packaged guide therefore reach nonexistent paths; make the repository-only links absolute or avoid shipping this guide by using an absolute link from the Japanese Code of Conduct.

Useful? React with 👍 / 👎.

e2e/cli, e2e/studio, and scripts/check-no-em-dash.mts exist only in the
repository, so the copies of CONTRIBUTING.md / CONTRIBUTING.ja.md that
ship in the published tarballs pointed at nonexistent paths. Link them
to github.com instead (README.md and LICENSE.md stay relative: both
packages ship their own). Also align the Code of Conduct Discord links
with the trailing-slash form main adopted.
@soleil-colza
soleil-colza requested a review from k-taro56 August 14, 2026 09:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants