prjct-cli 2.22.0 → 2.22.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,12 @@
1
1
  # Changelog
2
2
 
3
+ ## [2.22.1] - 2026-05-18
4
+
5
+ ### Bug Fixes
6
+
7
+ - changelog generator PROMOTES [Unreleased] instead of stranding it (mem_2895 root cause) (#352)
8
+
9
+
3
10
  ## [2.22.0] - 2026-05-18
4
11
 
5
12
  ### Features
@@ -803,10 +803,30 @@ All notable changes to this project will be documented in this file.
803
803
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
804
804
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
805
805
  `,Wa=class{static{c(this,"ChangelogService")}projectPath;constructor(e){this.projectPath=e}async detect(){for(let n of Qx){let r=Bw.join(this.projectPath,n);if(await E(r)){let o=await Tt(r),i=this.detectFormat(o);return{filePath:r,fileName:n,format:i,created:!1}}}let e="CHANGELOG.md",t=Bw.join(this.projectPath,e);return await kn(t,`${Zx}
806
- `),{filePath:t,fileName:e,format:"keepachangelog",created:!0}}async addEntry(e){let t=await this.detect(),n=await Tt(t.filePath);if(this.hasVersionEntry(n,e.version,t.format))return;let r=e.date||Qm(new Date),o;t.format==="keepachangelog"?o=this.insertKeepAChangelogEntry(n,e,r):o=this.insertMarkdownEntry(n,e,r),await kn(t.filePath,o)}hasVersionEntry(e,t,n){let r=t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&");return(n==="keepachangelog"?new RegExp(`^## \\[${r}\\]`,"m"):new RegExp(`^## ${r}\\b`,"m")).test(e)}async addFeature(e,t){await this.addEntry({version:e,sections:{Added:[t]}})}detectFormat(e){return e.includes("Keep a Changelog")||e.includes("keepachangelog.com")||/^### (?:Added|Changed|Deprecated|Removed|Fixed|Security)\s*$/m.test(e)?"keepachangelog":"markdown"}insertKeepAChangelogEntry(e,t,n){let r=this.formatKeepAChangelogEntry(t,n),o=e.search(/^## /m);if(o!==-1){let i=e.slice(0,o),a=e.slice(o);return`${i+r}
807
- ${a}`}return`${e.trimEnd()}
806
+ `),{filePath:t,fileName:e,format:"keepachangelog",created:!0}}async addEntry(e){let t=await this.detect(),n=await Tt(t.filePath);if(this.hasVersionEntry(n,e.version,t.format))return;let r=e.date||Qm(new Date),o;t.format==="keepachangelog"?o=this.insertKeepAChangelogEntry(n,e,r):o=this.insertMarkdownEntry(n,e,r),await kn(t.filePath,o)}hasVersionEntry(e,t,n){let r=t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&");return(n==="keepachangelog"?new RegExp(`^## \\[${r}\\]`,"m"):new RegExp(`^## ${r}\\b`,"m")).test(e)}async addFeature(e,t){await this.addEntry({version:e,sections:{Added:[t]}})}detectFormat(e){return e.includes("Keep a Changelog")||e.includes("keepachangelog.com")||/^### (?:Added|Changed|Deprecated|Removed|Fixed|Security)\s*$/m.test(e)?"keepachangelog":"markdown"}insertKeepAChangelogEntry(e,t,n){let r=e.split(`
807
+ `),o=r.findIndex(l=>/^##\s*\[Unreleased\]\s*$/i.test(l));if(o!==-1){let l=r.length;for(let m=o+1;m<r.length;m++)if(/^##\s/.test(r[m])){l=m;break}let u=r.slice(o+1,l).join(`
808
+ `).trim(),d=this.promoteUnreleasedBody(u,t,n);return`${[...r.slice(0,o),"## [Unreleased]","",d,"",...r.slice(l)].join(`
809
+ `).replace(/\n{3,}/g,`
808
810
 
809
- ${r}`}insertMarkdownEntry(e,t,n){let r=this.formatMarkdownEntry(t,n),o=e.indexOf(`
811
+ `).trimEnd()}
812
+ `}let i=this.formatKeepAChangelogEntry(t,n),a=e.search(/^## /m);if(a!==-1){let l=e.slice(0,a),u=e.slice(a);return`${l}## [Unreleased]
813
+
814
+ ${i}
815
+ ${u}`}return`${e.trimEnd()}
816
+
817
+ ## [Unreleased]
818
+
819
+ ${i}
820
+ `}promoteUnreleasedBody(e,t,n){if(!e)return this.formatKeepAChangelogEntry(t,n);let r=`## [${t.version}] - ${n}`,i=(t.sections?.Added??(t.description?[t.description]:[])).filter(u=>!e.includes(u));if(i.length===0)return`${r}
821
+
822
+ ${e}`;let a=i.map(u=>`- ${u}`).join(`
823
+ `),l=/^###\s+Added\s*$/im.test(e)?e.replace(/^###\s+Added\s*$/im,u=>`${u}
824
+ ${a}`):`### Added
825
+ ${a}
826
+
827
+ ${e}`;return`${r}
828
+
829
+ ${l}`}insertMarkdownEntry(e,t,n){let r=this.formatMarkdownEntry(t,n),o=e.indexOf(`
810
830
  `);if(o!==-1){let i=e.slice(0,o+1),a=e.slice(o+1);return`${i}
811
831
  ${r}
812
832
  ${a}`}return`${r}
@@ -1610,7 +1630,7 @@ ${Q.yellow(`Command '${s}' not found.`)}
1610
1630
 
1611
1631
  Run 'prjct help' to see all available commands.
1612
1632
  `}function aD(){let s=[];s.push(""),s.push(Q.cyan.bold("All Commands")),s.push("");let e=Object.entries(ao).sort((t,n)=>t[1].order-n[1].order);for(let[t,n]of e){let r=Ln.filter(o=>o.group===t);if(r.length!==0){s.push(`${Q.bold(n.title)} ${Q.dim(`(${r.length} commands)`)}`),s.push(Q.dim(n.description)),s.push("");for(let o of r){let i=`p. ${o.name}`.padEnd(18),a=o.description.length>45?`${o.description.slice(0,42)}...`:o.description;s.push(` ${i} ${a}`)}s.push("")}}return s.push(Q.dim("Run 'prjct help <command>' for detailed help on a specific command.")),s.push(""),s.join(`
1613
- `)}function cD(s){return s?s==="commands"||s==="all"?aD():iD(s):sD()}var XT,nD,KT=h(()=>{"use strict";li();We();XT=[{name:"start",description:"First-time setup wizard",example:"prjct start"},{name:"init",description:"Initialize project in current directory",example:"prjct init"},{name:"sync",description:"Sync project state and update context files",example:"prjct sync"},{name:"watch",description:"Auto-sync on file changes",example:"prjct watch",options:["--verbose","--debounce=<ms>","--interval=<sec>"]},{name:"hooks",description:"Manage git hooks for auto-sync",example:"prjct hooks install",subcommands:["install","uninstall","status"]},{name:"doctor",description:"Check system health and dependencies",example:"prjct doctor"},{name:"context",description:"Smart context filtering tools for AI",example:'prjct context files "add auth"',subcommands:["files","signatures","imports","recent","summary"]},{name:"stop",description:"Stop the background daemon",example:"prjct stop",options:["--force"]},{name:"restart",description:"Restart the background daemon",example:"prjct restart"},{name:"uninstall",description:"Complete system removal of prjct",example:"prjct uninstall --backup",options:["--force","--backup","--dry-run","--keep-package"]}],nD=[{flag:"-q, --quiet",description:"Suppress all output (errors to stderr only)"},{flag:"-v, --version",description:"Show version and provider status"},{flag:"-h, --help",description:"Show this help message"}];c(sD,"formatMainHelp");c(rD,"formatTerminalCommandHelp");c(oD,"formatAgentCommandHelp");c(iD,"formatCommandHelp");c(aD,"formatCommandList");c(cD,"getHelp")});var YT=cE((zQ,lD)=>{lD.exports={name:"prjct-cli",version:"2.22.0",description:"Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",main:"dist/bin/prjct.mjs",bin:{prjct:"bin/prjct"},publishConfig:{access:"public",registry:"https://registry.npmjs.org"},scripts:{build:"node scripts/build.js","build:node":"node scripts/build.js",release:"node scripts/release.js","release:patch":"node scripts/release.js patch","release:minor":"node scripts/release.js minor","release:major":"node scripts/release.js major",postinstall:"node scripts/postinstall.js",prepare:"lefthook install","update-commands":`bun -e "const installer = require('./core/infrastructure/command-installer'); installer.syncCommands().then(r => console.log('Commands updated:', r)).catch(e => console.error('Error:', e.message))"`,"install-global":"./scripts/install.sh",update:"./scripts/update.sh",test:"bun test","test:watch":"bun test --watch","test:coverage":"bun test --coverage",typecheck:"tsc --noEmit -p core/tsconfig.json","typecheck:watch":"tsc --noEmit -p core/tsconfig.json --watch",validate:"bun scripts/validate-commands.js",lint:"biome lint .","lint:fix":"biome lint --write .",knip:"knip","lint:meta":"bun core/cli/lint-meta-commentary.ts",format:"biome format --write .","format:check":"biome format .",check:"biome check .","check:fix":"biome check --write .","test:e2e":"bun test core/__tests__/e2e/"},keywords:["claude-code","gemini-cli","ai-agents","context-layer","developer-tools","ai-assistant","productivity","mcp","llm","coding-agents"],author:"prjct.app",license:"MIT",dependencies:{"@clack/prompts":"1.0.0","@modelcontextprotocol/sdk":"1.29.0","better-sqlite3":"12.9.0",chalk:"4.1.2",chokidar:"5.0.0","date-fns":"4.1.0",glob:"13.0.1","jsonc-parser":"3.3.1",zod:"3.25.76"},overrides:{"path-to-regexp":"8.4.0","brace-expansion":"5.0.5","fast-uri":">=3.1.2",hono:">=4.12.18","ip-address":">=10.1.1"},devDependencies:{"@biomejs/biome":"2.3.13","@types/better-sqlite3":"7.6.13","@types/bun":"latest","@types/chokidar":"2.1.7",esbuild:"0.25.0",knip:"6.3.1",lefthook:"2.1.0",typescript:"5.9.3"},repository:{type:"git",url:"git+https://github.com/jlopezlira/prjct-cli.git"},bugs:{url:"https://github.com/jlopezlira/prjct-cli/issues"},homepage:"https://prjct.app",packageManager:"bun@1.2.23",engines:{bun:">=1.0.0",node:">=22.22.2"},files:["assets/","bin/prjct","dist/","templates/","scripts/postinstall.js","scripts/ensure-bun.sh","scripts/install.sh","LICENSE","README.md","CHANGELOG.md"],prepublishOnly:"node scripts/build.js",trustedDependencies:["chalk"]}});var hD={};import QT from"node:os";import Ic from"node:path";import Oe from"chalk";async function uD(){let[s,...e]=process.argv.slice(2);if(["-v","--version","version"].includes(s)){let n=await Promise.resolve().then(()=>lE(YT()));await gD(n.version),process.exit(0)}if(["-h","--help",void 0].includes(s)&&(fD(),process.exit(0)),s&&bc(s)&&!ct.getByName(s)){let n=Sc[s];n&&(f.failWithHint({message:`'prjct ${s}' was removed in v2. ${n.note}`,hint:`Use: ${n.replacement}`}),process.exit(1))}if(s&&!ct.getByName(s)&&!(e.length===0&&ei(s)!==null)){let r=[s,...e.filter(i=>!i.startsWith("-"))].join(" "),o=e.filter(i=>i.startsWith("-"));s="capture",e=[r,...o]}let t=e.includes("--md");t||f.start();try{let n=ct.getByName(s);if(!n){let m=ei(s),g=m?`Did you mean 'prjct ${m}'? Run 'prjct --help' for all commands`:"Run 'prjct --help' to see available commands";f.failWithHint(vo("UNKNOWN_COMMAND",{message:`Unknown command: ${s}`,hint:g})),t||f.end(),process.exit(1)}if(n.deprecated){let m=n.replacedBy?`Use 'prjct ${n.replacedBy}' instead`:"Run 'prjct --help' to see available commands";f.failWithHint({message:`Command '${s}' is deprecated`,hint:m}),t||f.end(),process.exit(1)}n.implemented||(f.failWithHint({message:`Command '${s}' is not yet implemented`,hint:"Run 'prjct --help' to see available commands",docs:"https://github.com/jlopezlira/prjct-cli"}),t||f.end(),process.exit(1));let{parsedArgs:r,options:o}=mD(n,e),i=!process.stdin.isTTY||o.md===!0||o.json===!0;n.requiresLlm&&!i&&(f.failWithHint({message:`'prjct ${s}' requires an AI agent to process its output`,hint:`Use 'p. ${s}' inside Claude/Cursor, or add --md flag`}),t||f.end(),process.exit(1));let a=pD(n,r);a&&(f.failWithHint(a),t||f.end(),process.exit(1));let l=null,u=Date.now();try{l=await _.getProjectId(process.cwd()),l&&(await ir.expireIfStale(l),await ir.touch(l))}catch{}let d=new rs,p;if(s==="analyze")p=await d.analyze(o);else if(s==="setup")p=await d.setup(o);else if(s==="update"||s==="upgrade")p=await d.update(o);else{let m=r.join(" ")||null,g=o.md===!0,R={task:c(y=>d.task(y,process.cwd(),{md:g,spec:o.spec?String(o.spec):void 0}),"task"),spec:c(y=>dD(d,y,o),"spec"),"audit-spec":c(y=>y?d.specAudit(y,process.cwd(),{md:g}):Promise.resolve({success:!1,error:"audit-spec requires a spec id"}),"audit-spec"),init:c(y=>d.init({idea:y,yes:o.yes===!0,pack:o.pack?String(o.pack):void 0,persona:o.persona?String(o.persona):void 0}),"init"),ship:c(y=>d.ship(y,process.cwd(),{md:g,noSpecGate:o["no-spec-gate"]===!0}),"ship"),workflow:c(y=>d.workflowPrefs(y,process.cwd(),{md:g}),"workflow"),sync:c(()=>d.sync(process.cwd(),{preview:o.preview===!0||o["dry-run"]===!0,yes:o.yes===!0,json:o.json===!0,md:g,package:o.package?String(o.package):void 0,full:o.full===!0}),"sync"),"analysis-save-llm":c(y=>y?d.saveLlmAnalysis(y,process.cwd(),{md:g}):Promise.resolve({success:!1,error:"analysis-save-llm requires a JSON payload as positional arg"}),"analysis-save-llm"),regen:c(()=>d.regenVault(process.cwd(),{md:g}),"regen"),start:c(()=>d.start(),"start"),context:c(y=>d.context(y),"context"),status:c(y=>d.status(y,process.cwd(),{md:g}),"status"),tag:c(y=>d.tag(y,process.cwd(),{md:g}),"tag"),remember:c(y=>d.remember(y,process.cwd(),{md:g,tags:o.tags?String(o.tags):void 0}),"remember"),login:c(()=>d.login({md:g,url:o.url?String(o.url):void 0}),"login"),logout:c(()=>d.logout(),"logout"),auth:c(y=>d.auth(y,{md:g}),"auth"),seed:c(y=>d.seed(y,process.cwd(),{md:g}),"seed"),install:c(()=>d.install(null,process.cwd(),{md:g}),"install"),capture:c(y=>d.capture(y,process.cwd(),{md:g,tags:o.tags?String(o.tags):void 0,force:o.force===!0}),"capture"),mcp:c(y=>d.mcp(y,process.cwd(),{md:g}),"mcp")}[s];if(R)p=await R(m);else throw new Error(`Command '${s}' has no handler`)}if(l){let m=Date.now()-u;try{await ir.trackCommand(l,s,m)}catch{}try{await So.recordTiming(l,"command_duration",m,{command:s});let g=globalThis.__perfStartNs;if(g){let S=Number(process.hrtime.bigint()-g)/1e6;await So.recordTiming(l,"startup_time",S)}await So.recordMemory(l,{command:s})}catch{}}p?.message&&console.log(p.message),t||f.end(),process.exit(p?.success?0:1)}catch(n){console.error("Error:",v(n)),process.env.DEBUG&&console.error(Wc(n)),t||f.end(),process.exit(1)}}async function dD(s,e,t){let n=t.md===!0,r=(e??"").trim().split(/\s+/).filter(Boolean),o=r[0],i=r.slice(1).join(" ")||null,a=new Set(["list","show","update","set-status","record-review","link-task","ship","audit","inventory"]);if(o&&new Set(["draft","new","create"]).has(o))return s.spec(i,process.cwd(),{md:n,goal:t.goal?String(t.goal):void 0,tags:t.tags?String(t.tags):void 0});if(!o||!a.has(o))return s.spec(e,process.cwd(),{md:n,goal:t.goal?String(t.goal):void 0,tags:t.tags?String(t.tags):void 0});let u=process.cwd();switch(o){case"list":return s.specList(u,{md:n,status:t.status?String(t.status):void 0});case"show":return s.specShow(i,u,{md:n});case"update":return s.specUpdate(i,u,{md:n,json:t.json?String(t.json):void 0});case"set-status":return s.specSetStatus(i,u,{md:n,status:t.status?String(t.status):void 0});case"record-review":return s.specRecordReview(i,u,{md:n,reviewer:t.reviewer?String(t.reviewer):void 0,verdict:t.verdict?String(t.verdict):void 0,notes:t.notes?String(t.notes):void 0});case"link-task":return s.specLinkTask(i,u,{md:n,taskId:t["task-id"]?String(t["task-id"]):void 0});case"ship":return s.specShip(i,u,{md:n,pr:t.pr?String(t.pr):void 0});case"audit":return s.specAudit(i,u,{md:n});case"breakdown":return s.specBreakdown(i,u,{md:n,force:t.force===!0});case"inventory":return s.specInventory(u,{md:n,json:t.json===!0});default:return{success:!1,message:`unknown spec subverb: ${o}`}}}function pD(s,e){if(!s.params)return null;let t=s.params.match(/<[^>]+>/g);if(!t||t.length===0)return null;if(e.length<t.length){let n=t.map(o=>o.slice(1,-1)).join(", "),r=s.usage.terminal||`prjct ${s.name} ${s.params}`;return vo("MISSING_PARAM",{message:`Missing required parameter: ${n}`,hint:`Usage: ${r}`})}return null}function mD(s,e){let t=[],n={};for(let r=0;r<e.length;r++){let o=e[r];if(o.startsWith("--")){let i=o.slice(2);r+1<e.length&&!e[r+1].startsWith("--")?n[i]=e[++r]:n[i]=!0}else t.push(o)}return{parsedArgs:t,options:n}}async function gD(s){let e=await Tn(),t=Ic.join(QT.homedir(),".claude","commands","p.md"),n=Ic.join(QT.homedir(),".gemini","commands","p.toml"),[r,o,i,a]=await Promise.all([E(t),E(n),E(Ic.join(process.cwd(),".cursor","commands","sync.md")),E(Ic.join(process.cwd(),".cursor"))]),l=await go();if(console.log(`
1633
+ `)}function cD(s){return s?s==="commands"||s==="all"?aD():iD(s):sD()}var XT,nD,KT=h(()=>{"use strict";li();We();XT=[{name:"start",description:"First-time setup wizard",example:"prjct start"},{name:"init",description:"Initialize project in current directory",example:"prjct init"},{name:"sync",description:"Sync project state and update context files",example:"prjct sync"},{name:"watch",description:"Auto-sync on file changes",example:"prjct watch",options:["--verbose","--debounce=<ms>","--interval=<sec>"]},{name:"hooks",description:"Manage git hooks for auto-sync",example:"prjct hooks install",subcommands:["install","uninstall","status"]},{name:"doctor",description:"Check system health and dependencies",example:"prjct doctor"},{name:"context",description:"Smart context filtering tools for AI",example:'prjct context files "add auth"',subcommands:["files","signatures","imports","recent","summary"]},{name:"stop",description:"Stop the background daemon",example:"prjct stop",options:["--force"]},{name:"restart",description:"Restart the background daemon",example:"prjct restart"},{name:"uninstall",description:"Complete system removal of prjct",example:"prjct uninstall --backup",options:["--force","--backup","--dry-run","--keep-package"]}],nD=[{flag:"-q, --quiet",description:"Suppress all output (errors to stderr only)"},{flag:"-v, --version",description:"Show version and provider status"},{flag:"-h, --help",description:"Show this help message"}];c(sD,"formatMainHelp");c(rD,"formatTerminalCommandHelp");c(oD,"formatAgentCommandHelp");c(iD,"formatCommandHelp");c(aD,"formatCommandList");c(cD,"getHelp")});var YT=cE((zQ,lD)=>{lD.exports={name:"prjct-cli",version:"2.22.1",description:"Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",main:"dist/bin/prjct.mjs",bin:{prjct:"bin/prjct"},publishConfig:{access:"public",registry:"https://registry.npmjs.org"},scripts:{build:"node scripts/build.js","build:node":"node scripts/build.js",release:"node scripts/release.js","release:patch":"node scripts/release.js patch","release:minor":"node scripts/release.js minor","release:major":"node scripts/release.js major",postinstall:"node scripts/postinstall.js",prepare:"lefthook install","update-commands":`bun -e "const installer = require('./core/infrastructure/command-installer'); installer.syncCommands().then(r => console.log('Commands updated:', r)).catch(e => console.error('Error:', e.message))"`,"install-global":"./scripts/install.sh",update:"./scripts/update.sh",test:"bun test","test:watch":"bun test --watch","test:coverage":"bun test --coverage",typecheck:"tsc --noEmit -p core/tsconfig.json","typecheck:watch":"tsc --noEmit -p core/tsconfig.json --watch",validate:"bun scripts/validate-commands.js",lint:"biome lint .","lint:fix":"biome lint --write .",knip:"knip","lint:meta":"bun core/cli/lint-meta-commentary.ts",format:"biome format --write .","format:check":"biome format .",check:"biome check .","check:fix":"biome check --write .","test:e2e":"bun test core/__tests__/e2e/"},keywords:["claude-code","gemini-cli","ai-agents","context-layer","developer-tools","ai-assistant","productivity","mcp","llm","coding-agents"],author:"prjct.app",license:"MIT",dependencies:{"@clack/prompts":"1.0.0","@modelcontextprotocol/sdk":"1.29.0","better-sqlite3":"12.9.0",chalk:"4.1.2",chokidar:"5.0.0","date-fns":"4.1.0",glob:"13.0.1","jsonc-parser":"3.3.1",zod:"3.25.76"},overrides:{"path-to-regexp":"8.4.0","brace-expansion":"5.0.5","fast-uri":">=3.1.2",hono:">=4.12.18","ip-address":">=10.1.1"},devDependencies:{"@biomejs/biome":"2.3.13","@types/better-sqlite3":"7.6.13","@types/bun":"latest","@types/chokidar":"2.1.7",esbuild:"0.25.0",knip:"6.3.1",lefthook:"2.1.0",typescript:"5.9.3"},repository:{type:"git",url:"git+https://github.com/jlopezlira/prjct-cli.git"},bugs:{url:"https://github.com/jlopezlira/prjct-cli/issues"},homepage:"https://prjct.app",packageManager:"bun@1.2.23",engines:{bun:">=1.0.0",node:">=22.22.2"},files:["assets/","bin/prjct","dist/","templates/","scripts/postinstall.js","scripts/ensure-bun.sh","scripts/install.sh","LICENSE","README.md","CHANGELOG.md"],prepublishOnly:"node scripts/build.js",trustedDependencies:["chalk"]}});var hD={};import QT from"node:os";import Ic from"node:path";import Oe from"chalk";async function uD(){let[s,...e]=process.argv.slice(2);if(["-v","--version","version"].includes(s)){let n=await Promise.resolve().then(()=>lE(YT()));await gD(n.version),process.exit(0)}if(["-h","--help",void 0].includes(s)&&(fD(),process.exit(0)),s&&bc(s)&&!ct.getByName(s)){let n=Sc[s];n&&(f.failWithHint({message:`'prjct ${s}' was removed in v2. ${n.note}`,hint:`Use: ${n.replacement}`}),process.exit(1))}if(s&&!ct.getByName(s)&&!(e.length===0&&ei(s)!==null)){let r=[s,...e.filter(i=>!i.startsWith("-"))].join(" "),o=e.filter(i=>i.startsWith("-"));s="capture",e=[r,...o]}let t=e.includes("--md");t||f.start();try{let n=ct.getByName(s);if(!n){let m=ei(s),g=m?`Did you mean 'prjct ${m}'? Run 'prjct --help' for all commands`:"Run 'prjct --help' to see available commands";f.failWithHint(vo("UNKNOWN_COMMAND",{message:`Unknown command: ${s}`,hint:g})),t||f.end(),process.exit(1)}if(n.deprecated){let m=n.replacedBy?`Use 'prjct ${n.replacedBy}' instead`:"Run 'prjct --help' to see available commands";f.failWithHint({message:`Command '${s}' is deprecated`,hint:m}),t||f.end(),process.exit(1)}n.implemented||(f.failWithHint({message:`Command '${s}' is not yet implemented`,hint:"Run 'prjct --help' to see available commands",docs:"https://github.com/jlopezlira/prjct-cli"}),t||f.end(),process.exit(1));let{parsedArgs:r,options:o}=mD(n,e),i=!process.stdin.isTTY||o.md===!0||o.json===!0;n.requiresLlm&&!i&&(f.failWithHint({message:`'prjct ${s}' requires an AI agent to process its output`,hint:`Use 'p. ${s}' inside Claude/Cursor, or add --md flag`}),t||f.end(),process.exit(1));let a=pD(n,r);a&&(f.failWithHint(a),t||f.end(),process.exit(1));let l=null,u=Date.now();try{l=await _.getProjectId(process.cwd()),l&&(await ir.expireIfStale(l),await ir.touch(l))}catch{}let d=new rs,p;if(s==="analyze")p=await d.analyze(o);else if(s==="setup")p=await d.setup(o);else if(s==="update"||s==="upgrade")p=await d.update(o);else{let m=r.join(" ")||null,g=o.md===!0,R={task:c(y=>d.task(y,process.cwd(),{md:g,spec:o.spec?String(o.spec):void 0}),"task"),spec:c(y=>dD(d,y,o),"spec"),"audit-spec":c(y=>y?d.specAudit(y,process.cwd(),{md:g}):Promise.resolve({success:!1,error:"audit-spec requires a spec id"}),"audit-spec"),init:c(y=>d.init({idea:y,yes:o.yes===!0,pack:o.pack?String(o.pack):void 0,persona:o.persona?String(o.persona):void 0}),"init"),ship:c(y=>d.ship(y,process.cwd(),{md:g,noSpecGate:o["no-spec-gate"]===!0}),"ship"),workflow:c(y=>d.workflowPrefs(y,process.cwd(),{md:g}),"workflow"),sync:c(()=>d.sync(process.cwd(),{preview:o.preview===!0||o["dry-run"]===!0,yes:o.yes===!0,json:o.json===!0,md:g,package:o.package?String(o.package):void 0,full:o.full===!0}),"sync"),"analysis-save-llm":c(y=>y?d.saveLlmAnalysis(y,process.cwd(),{md:g}):Promise.resolve({success:!1,error:"analysis-save-llm requires a JSON payload as positional arg"}),"analysis-save-llm"),regen:c(()=>d.regenVault(process.cwd(),{md:g}),"regen"),start:c(()=>d.start(),"start"),context:c(y=>d.context(y),"context"),status:c(y=>d.status(y,process.cwd(),{md:g}),"status"),tag:c(y=>d.tag(y,process.cwd(),{md:g}),"tag"),remember:c(y=>d.remember(y,process.cwd(),{md:g,tags:o.tags?String(o.tags):void 0}),"remember"),login:c(()=>d.login({md:g,url:o.url?String(o.url):void 0}),"login"),logout:c(()=>d.logout(),"logout"),auth:c(y=>d.auth(y,{md:g}),"auth"),seed:c(y=>d.seed(y,process.cwd(),{md:g}),"seed"),install:c(()=>d.install(null,process.cwd(),{md:g}),"install"),capture:c(y=>d.capture(y,process.cwd(),{md:g,tags:o.tags?String(o.tags):void 0,force:o.force===!0}),"capture"),mcp:c(y=>d.mcp(y,process.cwd(),{md:g}),"mcp")}[s];if(R)p=await R(m);else throw new Error(`Command '${s}' has no handler`)}if(l){let m=Date.now()-u;try{await ir.trackCommand(l,s,m)}catch{}try{await So.recordTiming(l,"command_duration",m,{command:s});let g=globalThis.__perfStartNs;if(g){let S=Number(process.hrtime.bigint()-g)/1e6;await So.recordTiming(l,"startup_time",S)}await So.recordMemory(l,{command:s})}catch{}}p?.message&&console.log(p.message),t||f.end(),process.exit(p?.success?0:1)}catch(n){console.error("Error:",v(n)),process.env.DEBUG&&console.error(Wc(n)),t||f.end(),process.exit(1)}}async function dD(s,e,t){let n=t.md===!0,r=(e??"").trim().split(/\s+/).filter(Boolean),o=r[0],i=r.slice(1).join(" ")||null,a=new Set(["list","show","update","set-status","record-review","link-task","ship","audit","inventory"]);if(o&&new Set(["draft","new","create"]).has(o))return s.spec(i,process.cwd(),{md:n,goal:t.goal?String(t.goal):void 0,tags:t.tags?String(t.tags):void 0});if(!o||!a.has(o))return s.spec(e,process.cwd(),{md:n,goal:t.goal?String(t.goal):void 0,tags:t.tags?String(t.tags):void 0});let u=process.cwd();switch(o){case"list":return s.specList(u,{md:n,status:t.status?String(t.status):void 0});case"show":return s.specShow(i,u,{md:n});case"update":return s.specUpdate(i,u,{md:n,json:t.json?String(t.json):void 0});case"set-status":return s.specSetStatus(i,u,{md:n,status:t.status?String(t.status):void 0});case"record-review":return s.specRecordReview(i,u,{md:n,reviewer:t.reviewer?String(t.reviewer):void 0,verdict:t.verdict?String(t.verdict):void 0,notes:t.notes?String(t.notes):void 0});case"link-task":return s.specLinkTask(i,u,{md:n,taskId:t["task-id"]?String(t["task-id"]):void 0});case"ship":return s.specShip(i,u,{md:n,pr:t.pr?String(t.pr):void 0});case"audit":return s.specAudit(i,u,{md:n});case"breakdown":return s.specBreakdown(i,u,{md:n,force:t.force===!0});case"inventory":return s.specInventory(u,{md:n,json:t.json===!0});default:return{success:!1,message:`unknown spec subverb: ${o}`}}}function pD(s,e){if(!s.params)return null;let t=s.params.match(/<[^>]+>/g);if(!t||t.length===0)return null;if(e.length<t.length){let n=t.map(o=>o.slice(1,-1)).join(", "),r=s.usage.terminal||`prjct ${s.name} ${s.params}`;return vo("MISSING_PARAM",{message:`Missing required parameter: ${n}`,hint:`Usage: ${r}`})}return null}function mD(s,e){let t=[],n={};for(let r=0;r<e.length;r++){let o=e[r];if(o.startsWith("--")){let i=o.slice(2);r+1<e.length&&!e[r+1].startsWith("--")?n[i]=e[++r]:n[i]=!0}else t.push(o)}return{parsedArgs:t,options:n}}async function gD(s){let e=await Tn(),t=Ic.join(QT.homedir(),".claude","commands","p.md"),n=Ic.join(QT.homedir(),".gemini","commands","p.toml"),[r,o,i,a]=await Promise.all([E(t),E(n),E(Ic.join(process.cwd(),".cursor","commands","sync.md")),E(Ic.join(process.cwd(),".cursor"))]),l=await go();if(console.log(`
1614
1634
  ${Oe.cyan("p/")} prjct v${s}
1615
1635
  ${Oe.dim("Context layer for AI coding agents")}
1616
1636
 
@@ -793,10 +793,30 @@ All notable changes to this project will be documented in this file.
793
793
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
794
794
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
795
795
  `,Pi=class{static{c(this,"ChangelogService")}projectPath;constructor(e){this.projectPath=e}async detect(){for(let n of fT){let r=Af.join(this.projectPath,n);if(await T(r)){let o=await lt(r),i=this.detectFormat(o);return{filePath:r,fileName:n,format:i,created:!1}}}let e="CHANGELOG.md",t=Af.join(this.projectPath,e);return await nn(t,`${hT}
796
- `),{filePath:t,fileName:e,format:"keepachangelog",created:!0}}async addEntry(e){let t=await this.detect(),n=await lt(t.filePath);if(this.hasVersionEntry(n,e.version,t.format))return;let r=e.date||Qu(new Date),o;t.format==="keepachangelog"?o=this.insertKeepAChangelogEntry(n,e,r):o=this.insertMarkdownEntry(n,e,r),await nn(t.filePath,o)}hasVersionEntry(e,t,n){let r=t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&");return(n==="keepachangelog"?new RegExp(`^## \\[${r}\\]`,"m"):new RegExp(`^## ${r}\\b`,"m")).test(e)}async addFeature(e,t){await this.addEntry({version:e,sections:{Added:[t]}})}detectFormat(e){return e.includes("Keep a Changelog")||e.includes("keepachangelog.com")||/^### (?:Added|Changed|Deprecated|Removed|Fixed|Security)\s*$/m.test(e)?"keepachangelog":"markdown"}insertKeepAChangelogEntry(e,t,n){let r=this.formatKeepAChangelogEntry(t,n),o=e.search(/^## /m);if(o!==-1){let i=e.slice(0,o),a=e.slice(o);return`${i+r}
797
- ${a}`}return`${e.trimEnd()}
796
+ `),{filePath:t,fileName:e,format:"keepachangelog",created:!0}}async addEntry(e){let t=await this.detect(),n=await lt(t.filePath);if(this.hasVersionEntry(n,e.version,t.format))return;let r=e.date||Qu(new Date),o;t.format==="keepachangelog"?o=this.insertKeepAChangelogEntry(n,e,r):o=this.insertMarkdownEntry(n,e,r),await nn(t.filePath,o)}hasVersionEntry(e,t,n){let r=t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&");return(n==="keepachangelog"?new RegExp(`^## \\[${r}\\]`,"m"):new RegExp(`^## ${r}\\b`,"m")).test(e)}async addFeature(e,t){await this.addEntry({version:e,sections:{Added:[t]}})}detectFormat(e){return e.includes("Keep a Changelog")||e.includes("keepachangelog.com")||/^### (?:Added|Changed|Deprecated|Removed|Fixed|Security)\s*$/m.test(e)?"keepachangelog":"markdown"}insertKeepAChangelogEntry(e,t,n){let r=e.split(`
797
+ `),o=r.findIndex(l=>/^##\s*\[Unreleased\]\s*$/i.test(l));if(o!==-1){let l=r.length;for(let m=o+1;m<r.length;m++)if(/^##\s/.test(r[m])){l=m;break}let u=r.slice(o+1,l).join(`
798
+ `).trim(),d=this.promoteUnreleasedBody(u,t,n);return`${[...r.slice(0,o),"## [Unreleased]","",d,"",...r.slice(l)].join(`
799
+ `).replace(/\n{3,}/g,`
798
800
 
799
- ${r}`}insertMarkdownEntry(e,t,n){let r=this.formatMarkdownEntry(t,n),o=e.indexOf(`
801
+ `).trimEnd()}
802
+ `}let i=this.formatKeepAChangelogEntry(t,n),a=e.search(/^## /m);if(a!==-1){let l=e.slice(0,a),u=e.slice(a);return`${l}## [Unreleased]
803
+
804
+ ${i}
805
+ ${u}`}return`${e.trimEnd()}
806
+
807
+ ## [Unreleased]
808
+
809
+ ${i}
810
+ `}promoteUnreleasedBody(e,t,n){if(!e)return this.formatKeepAChangelogEntry(t,n);let r=`## [${t.version}] - ${n}`,i=(t.sections?.Added??(t.description?[t.description]:[])).filter(u=>!e.includes(u));if(i.length===0)return`${r}
811
+
812
+ ${e}`;let a=i.map(u=>`- ${u}`).join(`
813
+ `),l=/^###\s+Added\s*$/im.test(e)?e.replace(/^###\s+Added\s*$/im,u=>`${u}
814
+ ${a}`):`### Added
815
+ ${a}
816
+
817
+ ${e}`;return`${r}
818
+
819
+ ${l}`}insertMarkdownEntry(e,t,n){let r=this.formatMarkdownEntry(t,n),o=e.indexOf(`
800
820
  `);if(o!==-1){let i=e.slice(0,o+1),a=e.slice(o+1);return`${i}
801
821
  ${r}
802
822
  ${a}`}return`${r}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "prjct-cli",
3
- "version": "2.22.0",
3
+ "version": "2.22.1",
4
4
  "description": "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
5
5
  "main": "dist/bin/prjct.mjs",
6
6
  "bin": {