prjct-cli 2.60.0 → 2.63.0

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 ## [Unreleased]
 
+## [2.63.0] - 2026-06-23
+
+### Added
+- eval result publishing
+
+## [2.62.0] - 2026-06-23
+
+### Added
+- Point CLI metadata to cli site
+
+## [2.61.0] - 2026-06-23
+
+### Added
+- Improve prjct-cli maintainability performance and UX
+
 ## [2.60.0] - 2026-06-22
 
 ### Added

package/README.md

@@ -178,6 +178,24 @@ command is idempotent and reports what changed.
 prjct should justify itself with project evidence, not vague claims. These
 read-only commands show whether the project is actually compounding:
 
+### Version evals
+
+Use `prjct eval` to measure product readiness between versions and publish the
+evidence to GitHub:
+
+```bash
+prjct eval run --candidate 2.62.0
+prjct eval compare --baseline 2.61.0 --candidate 2.62.0 --md
+prjct eval run --candidate "$GITHUB_SHA" --publish --target github
+prjct eval compare --baseline "$BASELINE" --candidate "$CANDIDATE" --publish --target github
+```
+
+Local artifacts live under `$PRJCT_CLI_HOME/evals/<repo>/`. GitHub publishing
+writes JSON + Markdown to an `eval-results` branch, including
+`summary/latest.json` and `summary/latest-comparison.json`. See
+[EVALS.md](./EVALS.md) and `.github/workflows/prjct-evals.yml` for the
+CI workflow.
+
 | Command | What it proves |
 |---|---|
 | `prjct value --md` | Durable memory, preventive guardrails, shipped work, sync metrics, and detected agent coverage. |
@@ -609,7 +627,7 @@ tradeoffs: [docs/storage-and-paths.md](./docs/storage-and-paths.md).
 
 ## Links
 
-- [Website](https://prjct.app)
+- [Website](https://cli.prjct.app)
 - [GitHub](https://github.com/jlopezlira/prjct-cli)
 - [npm](https://www.npmjs.com/package/prjct-cli)
 - [Changelog](CHANGELOG.md)

package/bin/prjct.cjs

@@ -16,7 +16,11 @@ const path = require('node:path')
 const SCRIPT_PATH = fs.realpathSync(__filename)
 const SCRIPT_DIR = path.dirname(SCRIPT_PATH)
 const ROOT_DIR = path.resolve(SCRIPT_DIR, '..')
-const HOME = os.homedir()
+const HOME = process.env.HOME || process.env.USERPROFILE || os.homedir()
+const CLI_HOME = process.env.PRJCT_CLI_HOME
+  ? path.resolve(process.env.PRJCT_CLI_HOME)
+  : path.join(HOME, '.prjct-cli')
+const SETUP_STAMP_PATH = path.join(CLI_HOME, 'state', 'setup-version.json')
 
 function pathEntries() {
   return (process.env.PATH || '').split(path.delimiter).filter(Boolean)
@@ -114,12 +118,76 @@ function copyDirContents(srcDir, destDir) {
   }
 }
 
+function packageVersion() {
+  try {
+    return JSON.parse(fs.readFileSync(path.join(ROOT_DIR, 'package.json'), 'utf-8')).version || ''
+  } catch {
+    return ''
+  }
+}
+
+function fileMissingWhenSourceExists(src, dest) {
+  try {
+    return fs.existsSync(src) && !fs.existsSync(dest)
+  } catch {
+    return false
+  }
+}
+
+function readSetupStamp() {
+  try {
+    return JSON.parse(fs.readFileSync(SETUP_STAMP_PATH, 'utf-8'))
+  } catch {
+    return null
+  }
+}
+
+function writeSetupStamp(version) {
+  try {
+    fs.mkdirSync(path.dirname(SETUP_STAMP_PATH), { recursive: true })
+    fs.writeFileSync(
+      SETUP_STAMP_PATH,
+      `${JSON.stringify({ version, completedAt: new Date().toISOString() }, null, 2)}\n`,
+      'utf-8'
+    )
+  } catch {
+    /* best effort */
+  }
+}
+
+function shouldRunSetup(version) {
+  const stamp = readSetupStamp()
+  if (!stamp || stamp.version !== version) return true
+
+  if (fs.existsSync(path.join(HOME, '.claude', 'commands', 'p.md'))) return true
+  if (fs.existsSync(path.join(HOME, '.gemini', 'commands', 'p.toml'))) return true
+
+  const statuslineSrc = path.join(ROOT_DIR, 'assets', 'statusline', 'statusline.sh')
+  const statuslineDest = path.join(CLI_HOME, 'statusline', 'statusline.sh')
+  if (fileMissingWhenSourceExists(statuslineSrc, statuslineDest)) return true
+
+  const claudeSkillSrc = path.join(ROOT_DIR, 'templates', 'skills', 'prjct', 'SKILL.md')
+  const claudeSkillDest = path.join(HOME, '.claude', 'skills', 'prjct', 'SKILL.md')
+  if (fileMissingWhenSourceExists(claudeSkillSrc, claudeSkillDest)) return true
+
+  const codexSkillSrc = path.join(ROOT_DIR, 'templates', 'codex', 'SKILL.md')
+  const codexSkillDest = path.join(HOME, '.codex', 'skills', 'prjct', 'SKILL.md')
+  if (
+    fs.existsSync(path.join(HOME, '.codex')) &&
+    fileMissingWhenSourceExists(codexSkillSrc, codexSkillDest)
+  ) {
+    return true
+  }
+
+  return false
+}
+
 function ensureSetup() {
   removeIfExists(path.join(HOME, '.claude', 'commands', 'p.md'))
   removeIfExists(path.join(HOME, '.gemini', 'commands', 'p.toml'))
 
   const statuslineSrc = path.join(ROOT_DIR, 'assets', 'statusline', 'statusline.sh')
-  const statuslineDir = path.join(HOME, '.prjct-cli', 'statusline')
+  const statuslineDir = path.join(CLI_HOME, 'statusline')
   const statuslineDest = path.join(statuslineDir, 'statusline.sh')
   const claudeStatusline = path.join(HOME, '.claude', 'prjct-statusline.sh')
 
@@ -241,7 +309,23 @@ function main() {
   const args = process.argv.slice(2)
   if (args[0] === 'mcp-server') runMcpServer(args)
 
-  ensureSetup()
+  const setupSkipCommands = new Set([
+    '-v',
+    '--version',
+    'version',
+    '-h',
+    '--help',
+    'help',
+    'eval',
+    'hook',
+    '__internal-auto-update',
+    '__post-upgrade',
+  ])
+  const version = packageVersion()
+  if (!setupSkipCommands.has(args[0]) && shouldRunSetup(version)) {
+    ensureSetup()
+    writeSetupStamp(version)
+  }
 
   if (runWithBun(args)) return
   runWithNode(args)