@cementic/cementic-test 0.2.5 → 0.2.6

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,46 @@
+# Code of Conduct
+
+## Our Pledge
+
+We as contributors and maintainers pledge to make participation in the CementicTest 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 that contribute to an open, welcoming, diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for this project include:
+
+- demonstrating empathy and kindness toward other people
+- being respectful of differing opinions, viewpoints, and experiences
+- giving and gracefully accepting constructive feedback
+- taking responsibility and apologizing to those affected by our mistakes, and learning from the experience
+- focusing on what is best not just for us as individuals, but for the overall community
+
+Examples of unacceptable behavior include:
+
+- the use of sexualized language or imagery, and sexual attention or advances of any kind
+- trolling, insulting or derogatory comments, and personal or political attacks
+- public or private harassment
+- publishing others' private information, such as a physical or email address, without their explicit permission
+- other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Enforcement Responsibilities
+
+Project maintainers are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned with this Code of Conduct, and will communicate reasons for moderation decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all project spaces and also applies when an individual is officially representing the project in public spaces. Examples of representing the project include using an official email address, posting via an official social media account, or acting as an appointed representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the project maintainers through the repository hosting platform or the project contact channels. All complaints will be reviewed and investigated promptly and fairly.
+
+All project maintainers are obligated to respect the privacy and security of the reporter of any incident.
+
+## Attribution
+
+This Code of Conduct is adapted from the Contributor Covenant, version 2.1:
+https://www.contributor-covenant.org/version/2/1/code_of_conduct.html

package/CONTRIBUTING.md

@@ -0,0 +1,61 @@
+# Contributing
+
+Thanks for contributing to CementicTest CLI.
+
+## What to contribute
+
+Useful contributions include:
+
+- bug fixes
+- test coverage improvements
+- CLI workflow improvements
+- generator accuracy improvements
+- documentation updates
+- template updates for scaffolded projects
+
+If your change affects generated output, command behavior, or project scaffolding, include tests or a clear explanation of why tests are not practical.
+
+## Local setup
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+## Development workflow
+
+1. Create a branch for your change.
+2. Make the smallest coherent change that solves the problem.
+3. Run `npm test`.
+4. If your change affects generation, also verify a manual `tc -> normalize -> gen -> test` flow.
+5. Update docs when user-facing behavior changes.
+
+## Manual smoke flow
+
+```bash
+mkdir demo
+cd demo
+
+ct new sample --lang ts --no-browsers
+cd sample
+
+ct tc url https://mini-bank.testamplify.com/login --ai --feature "Login" --count 1
+ct normalize ./cases --and-gen --lang ts
+ct test
+```
+
+## Pull requests
+
+Please make sure your pull request includes:
+
+- a short summary of the behavior change
+- any relevant tests
+- documentation updates when needed
+- notes about manual verification if generation behavior changed
+
+## Issues and discussion
+
+- Bugs and feature requests: use the GitHub issue tracker
+- Community and product updates: https://t.me/+Wbx7oK7ivqgxZGJh
+- Website and upcoming web app: https://cementic.testamplify.io/

package/README.md

@@ -2,6 +2,12 @@
 
 CementicTest CLI (`ct`) turns plain-English test cases into runnable Playwright tests with a Page Object Model-oriented workflow.
 
+## Project links
+
+- Website: https://cementic.testamplify.io/
+- Community: https://t.me/+Wbx7oK7ivqgxZGJh
+- Web app: browser-based AI testing workflow coming soon
+
 Current pipeline:
 
 ```text
@@ -10,6 +16,12 @@ ct tc -> ct normalize -> ct gen -> ct test
 
 It can scaffold a project, write or AI-generate case files, normalize them into JSON, generate Playwright specs plus page objects, and run the resulting suite.
 
+## Project status
+
+This repository currently ships the CLI workflow.
+
+The browser-based web app is in progress and early product updates will be shared on the website and in the community channel.
+
 ## What this version does
 
 - Scaffolds new Playwright projects in JavaScript or TypeScript
@@ -443,6 +455,13 @@ templates/student-framework-ts/
 
 ## Changelog
 
+### v0.2.6
+
+- added an install-time banner with links to the website and community
+- surfaced project links and web app status near the top of the README
+- added a standalone `CONTRIBUTING.md`
+- added a `CODE_OF_CONDUCT.md`
+
 ### v0.2.5
 
 - replaced the legacy URL scraping path with full Playwright-based live page capture
@@ -462,7 +481,4 @@ templates/student-framework-ts/
 
 ## Contributing
 
-1. Create a branch
-2. Run `npm test`
-3. Verify a manual `tc -> normalize -> gen -> test` flow if your change affects generation
-4. Open a PR with the behavior change clearly described
+Contribution guidelines live in [CONTRIBUTING.md](./CONTRIBUTING.md).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cementic/cementic-test",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "CementicTest CLI (ct): capture pages, normalize cases, generate Playwright tests",
   "type": "module",
   "license": "Apache-2.0",
@@ -10,14 +10,18 @@
   },
   "files": [
     "dist/**/*",
+    "scripts/postinstall-banner.cjs",
     "LICENSE",
-    "README.md"
+    "README.md",
+    "CONTRIBUTING.md",
+    "CODE_OF_CONDUCT.md"
   ],
   "scripts": {
     "build": "tsup && node scripts/copy-templates.cjs",
     "dev": "tsup --watch",
     "test": "npm run build && node --test test/*.test.mjs",
     "lint": "echo \"(add linter later)\"",
+    "postinstall": "node scripts/postinstall-banner.cjs",
     "prepublishOnly": "npm run build"
   },
   "engines": {

package/scripts/postinstall-banner.cjs

@@ -0,0 +1,14 @@
+if (process.env.CI) {
+  process.exit(0);
+}
+
+console.log(`
+⚡ CementicTest CLI
+Turn plain English into test automation momentum
+
+🌐 Web app coming soon
+https://cementic.testamplify.io/
+
+💬 Join community
+https://t.me/+Wbx7oK7ivqgxZGJh
+`);