prjct-cli 2.23.7 → 2.23.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "2.23.7",
+  "version": "2.23.10",
   "description": "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
   "main": "dist/bin/prjct.mjs",
   "bin": {
@@ -98,6 +98,7 @@
     "bin/prjct",
     "dist/",
     "templates/",
+    "scripts/ensure-native-deps.js",
     "scripts/postinstall.js",
     "scripts/ensure-bun.sh",
     "scripts/install.sh",
@@ -107,6 +108,7 @@
   ],
   "prepublishOnly": "node scripts/build.js",
   "trustedDependencies": [
+    "better-sqlite3",
     "chalk"
   ]
 }

package/scripts/ensure-native-deps.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+
+const { execFileSync } = require('node:child_process')
+const path = require('node:path')
+
+const ROOT = path.resolve(__dirname, '..')
+
+function npmCommand() {
+  return process.platform === 'win32' ? 'npm.cmd' : 'npm'
+}
+
+function hasBetterSqliteBinding() {
+  try {
+    const Database = require('better-sqlite3')
+    new Database(':memory:').close()
+    return true
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error)
+    if (
+      message.includes('Could not locate the bindings file') ||
+      message.includes('better_sqlite3.node')
+    ) {
+      return false
+    }
+    throw error
+  }
+}
+
+function ensureNativeDependencies(options = {}) {
+  if (process.env.PRJCT_SKIP_NATIVE_REBUILD === '1') {
+    return { rebuilt: false, skipped: true }
+  }
+  if (hasBetterSqliteBinding()) {
+    return { rebuilt: false, skipped: false }
+  }
+
+  const stdio = options.stdio || 'inherit'
+  execFileSync(npmCommand(), ['rebuild', 'better-sqlite3', '--foreground-scripts'], {
+    cwd: ROOT,
+    stdio,
+    timeout: 120000,
+  })
+
+  if (!hasBetterSqliteBinding()) {
+    throw new Error('better-sqlite3 native binding is still unavailable after rebuild')
+  }
+
+  return { rebuilt: true, skipped: false }
+}
+
+if (require.main === module) {
+  try {
+    ensureNativeDependencies()
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error)
+    console.error(`prjct native dependency install failed: ${message}`)
+    process.exit(1)
+  }
+}
+
+module.exports = {
+  ensureNativeDependencies,
+  hasBetterSqliteBinding,
+}

package/scripts/postinstall.js

@@ -6,11 +6,13 @@
  * NOTE: postinstall often doesn't run (npm quirks, --ignore-scripts, etc.)
  * The reliable setup path is `prjct start` which users run manually.
  *
- * This script just shows a helpful message.
+ * This script may repair required native dependencies, but it must never
+ * install optional tools, mutate shell config, or configure integrations.
  */
 
 const fs = require('node:fs')
 const path = require('node:path')
+const { ensureNativeDependencies } = require('./ensure-native-deps')
 
 const ROOT = path.resolve(__dirname, '..')
 const pkg = JSON.parse(fs.readFileSync(path.join(ROOT, 'package.json'), 'utf-8'))
@@ -23,6 +25,19 @@ const DIM = '\x1b[2m'
 const BOLD = '\x1b[1m'
 const RESET = '\x1b[0m'
 
+try {
+  const result = ensureNativeDependencies({ stdio: 'inherit' })
+  if (result.rebuilt) {
+    console.log(`   ${DIM}Built required SQLite native dependency.${RESET}`)
+  }
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error)
+  console.error(`\n${BOLD}prjct native dependency repair warning:${RESET} ${message}`)
+  console.error(
+    `${DIM}Install will continue. prjct will retry this repair before starting the daemon.${RESET}`
+  )
+}
+
 console.log(`
 ${CYAN}${BOLD}   prjct${RESET} ${DIM}v${VERSION}${RESET}
 
@@ -32,14 +47,3 @@ ${CYAN}${BOLD}   prjct${RESET} ${DIM}v${VERSION}${RESET}
 
    ${DIM}Supports: Claude Code, Gemini CLI, or both${RESET}
 `)
-
-// Auto-install Bun for optimal performance (best-effort)
-try {
-  const { execSync } = require('node:child_process')
-  const ensureBun = path.join(__dirname, 'ensure-bun.sh')
-  if (fs.existsSync(ensureBun)) {
-    execSync(`sh "${ensureBun}"`, { stdio: 'inherit', timeout: 30000 })
-  }
-} catch (_err) {
-  console.log(`   ${DIM}Bun not installed — using Node.js (slower)${RESET}`)
-}

package/templates/crew/CLAUDE-leader-mode.md

@@ -21,5 +21,9 @@ If you need durable state that outlives the session, persist via `prjct` CLI ver
 ### When this role does NOT apply
 
 - Pure exploratory / read-only questions about the repo → answer directly.
-- Edits to `.prjct/`, docs, configuration, or this file → you may edit directly.
+- Edits to docs, configuration files (e.g. `.prjct/prjct.config.json`), or this file → you may edit directly.
+
+### Hard persistence rule
+
+Never write audit, checkpoint, review, deploy, or report markdown into any new file or subdirectory under the prjct state folder, and no scratch `.md` anywhere else in the worktree. The ONLY hand-editable file in that folder is `.prjct/prjct.config.json`. Everything else — checkpoints, audits, decisions, learnings, deploy notes — lives in SQLite + the regenerated vault, written through `prjct` CLI verbs (`prjct crew checkpoints set`, `prjct remember`, `prjct capture`, `prjct spec record-review`). If a subagent reports findings, persist them via `prjct remember` and cite the returned mem id; never tell a subagent to write to disk.
 <!-- prjct:crew:end - DO NOT REMOVE THIS MARKER -->

package/templates/crew/agents/leader.md

@@ -91,4 +91,8 @@ If the reviewer replies `VERDICT: CHANGES_REQUESTED`, do not call `record-run` f
 ## When this role does NOT apply
 
 - Pure exploration / read-only questions about the repo → answer directly, no subagents.
-- Edits to `.prjct/`, docs, configuration, or this file itself → you may edit directly.
+- Edits to docs, configuration files (e.g. `.prjct/prjct.config.json`), or this file itself → you may edit directly.
+
+## Hard persistence rule
+
+Never write audit, checklist, review, deploy, or report markdown into any new file or subdirectory under the prjct state folder. The ONLY hand-editable file in that folder is `.prjct/prjct.config.json`. Durable state — checkpoints, audits, reviews, decisions, learnings — goes through `prjct` CLI verbs (`prjct crew checkpoints set`, `prjct remember`, `prjct capture`, `prjct spec record-review`). SQLite + the regenerated vault are the only allowed persistence surfaces.