prjct-cli 0.35.3 → 0.36.1

package/CLAUDE.md

@@ -1,211 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code when working with prjct-cli.
-
-## Project Overview
-
-**prjct-cli** is a developer momentum tool. Track progress through natural language commands (`p. <command>`) without meetings or traditional PM overhead.
-
-## HOW PRJCT WORKS
-
-When user types `p. <command>`, load the template from `templates/commands/{command}.md` and execute it **intelligently** - templates are GUIDANCE, not rigid scripts.
-
-```
-p. sync     → Analyze project, generate domain agents
-p. task X   → Start task with classification + breakdown
-p. done     → Complete current subtask
-p. ship X   → Ship feature with PR + version bump
-```
-
----
-
-## CRITICAL RULES
-
-### 1. Path Resolution (MOST IMPORTANT)
-**ALL writes go to global storage**: `~/.prjct-cli/projects/{projectId}/`
-- **NEVER** write to `.prjct/` (config only, read-only)
-- **NEVER** write to `./` (current directory)
-
-### 2. Before Any Command
-```
-1. Read .prjct/prjct.config.json → get projectId
-2. Set globalPath = ~/.prjct-cli/projects/{projectId}
-3. Execute using globalPath for all writes
-4. Log to {globalPath}/memory/events.jsonl
-```
-
-### 3. Timestamps & UUIDs
-```bash
-# Timestamp (NEVER hardcode)
-bun -e "console.log(new Date().toISOString())" 2>/dev/null || node -e "console.log(new Date().toISOString())"
-
-# UUID
-bun -e "console.log(crypto.randomUUID())" 2>/dev/null || node -e "console.log(require('crypto').randomUUID())"
-```
-
-### 4. Git Commit Footer (CRITICAL - ALWAYS INCLUDE)
-
-**Every commit MUST include the prjct signature:**
-
-```
-🤖 Generated with [p/](https://www.prjct.app/)
-Designed for [Claude](https://www.anthropic.com/claude)
-
-```
-
-**NON-NEGOTIABLE: The `🤖 Generated with [p/]` line identifies prjct-powered commits.**
-
----
-
-## ARCHITECTURE: Write-Through Pattern
-
-```
-User Action → Storage (JSON) → Context (MD) → Sync Events
-```
-
-| Layer | Path | Purpose |
-|-------|------|---------|
-| **Storage** | `storage/*.json` | Source of truth |
-| **Context** | `context/*.md` | Claude-readable summaries |
-| **Memory** | `memory/events.jsonl` | Audit trail (append-only) |
-| **Agents** | `agents/*.md` | Domain specialists |
-
-### File Structure
-```
-~/.prjct-cli/projects/{projectId}/
-├── storage/
-│   ├── state.json      # Current task (SOURCE OF TRUTH)
-│   ├── queue.json      # Task queue
-│   └── shipped.json    # Shipped features
-├── context/
-│   ├── now.md          # Current task (generated)
-│   └── next.md         # Queue (generated)
-├── memory/
-│   └── events.jsonl    # Audit trail
-├── agents/             # Domain specialists
-└── sync/
-    └── pending.json    # Backend events
-```
-
----
-
-## COMMANDS
-
-### Core Workflow
-| Trigger | Purpose |
-|---------|---------|
-| `p. init` | Initialize project with deep analysis |
-| `p. sync` | Analyze repo, generate agents |
-| `p. task <desc>` | Start task with agentic classification |
-| `p. done` | Complete current subtask |
-| `p. ship [name]` | Ship with PR + version bump |
-| `p. pause` | Pause active task |
-| `p. resume` | Resume paused task |
-| `p. bug <desc>` | Report bug with auto-priority |
-
-### Issue Tracker Integrations
-| Trigger | Purpose |
-|---------|---------|
-| `p. linear` | Linear issues (OAuth via MCP) |
-| `p. jira` | JIRA issues (OAuth/SSO via MCP) |
-| `p. github` | GitHub Issues (token via MCP) |
-| `p. monday` | Monday.com boards (OAuth via MCP) |
-| `p. enrich <ID>` | **AI-powered ticket enrichment** |
-
-### Ticket Enrichment (`p. enrich`)
-
-Transform vague PM tickets into technical PRDs:
-
-```
-PM creates: "Add user auth"
-            ↓
-p. enrich PRJ-59
-            ↓
-Architect analyzes codebase:
-- Similar implementations found
-- 5 files affected
-- OAuth2 approach recommended
-- 8 story points (not PM's guess of 2)
-            ↓
-Publishes PRD to tracker:
-- Technical approach
-- Acceptance criteria
-- LLM-ready prompt (for any AI tool)
-```
-
-**Subcommands:**
-- `p. enrich <ID>` - Enrich specific ticket
-- `p. enrich setup` - Configure team preferences (estimation, output)
-- `p. enrich batch` - Enrich all assigned tickets (backlog grooming)
-
-### Workflow
-```
-p. sync → p. task "description" → [work] → p. done → p. ship
-```
-
-### With Issue Tracker
-```
-p. linear → p. enrich PRJ-59 → p. linear start PRJ-59 → [work] → p. done → p. ship
-```
-
----
-
-## INTELLIGENT BEHAVIOR
-
-Templates provide guidance. Use your intelligence to:
-
-1. **Read before write** - Always read existing files first
-2. **Explore before coding** - Use Task(Explore) to understand codebase
-3. **Ask when uncertain** - Use AskUserQuestion to clarify
-4. **Load agents** - Read from `{globalPath}/agents/` for domain expertise
-5. **Adapt templates** - They're guidance, not rigid scripts
-6. **Log everything** - Append to memory/events.jsonl
-
----
-
-## OUTPUT FORMAT
-
-Concise responses (< 4 lines):
-```
-✅ [What was done]
-
-[Key metrics]
-Next: [suggested action]
-```
-
----
-
-## KEY RULES
-
-1. **Read files before editing** - Never assume structure
-2. **Use node/bun for timestamps** - Never hardcode dates
-3. **Follow template guidance** - But adapt intelligently
-4. **Log to memory** - Append to `memory/events.jsonl`
-5. **Suggest next actions** - Maintain user momentum
-6. **Use linked skills** - Agents have skills in frontmatter
-
----
-
-## SKILL INTEGRATION (v0.27)
-
-Agents are linked to Claude Code skills from claude-plugins.dev.
-
-### Agent → Skill Mapping
-
-| Agent | Skill |
-|-------|-------|
-| `frontend.md` | `frontend-design` |
-| `uxui.md` | `frontend-design` |
-| `backend.md` | `javascript-typescript` |
-| `testing.md` | `developer-kit` |
-| `devops.md` | `developer-kit` |
-| `prjct-planner.md` | `feature-dev` |
-| `prjct-shipper.md` | `code-review` |
-
-### Usage
-
-- `p. sync` installs required skills automatically
-- `p. task` invokes skills based on task type
-- Skills config: `{globalPath}/config/skills.json`
-
-See `templates/agentic/skill-integration.md` for details.

package/packages/shared/package.json

@@ -1,29 +0,0 @@
-{
-  "name": "@prjct/shared",
-  "version": "0.1.0",
-  "description": "Shared types and utilities for prjct",
-  "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "scripts": {
-    "build": "bun build src/index.ts --outdir ./dist --target bun && bun run build:types",
-    "build:types": "tsc --emitDeclarationOnly --declaration --outDir dist",
-    "dev": "bun build src/index.ts --outdir ./dist --target bun --watch",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint src"
-  },
-  "dependencies": {
-    "zod": "^3.23.8"
-  },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.4.5"
-  }
-}

package/packages/shared/src/index.ts

@@ -1,10 +0,0 @@
-/**
- * @prjct/shared - Shared Types and Utilities
- *
- * Types and schemas shared between CLI, server, and web.
- */
-
-export * from './types'
-export * from './schemas'
-export * from './utils'
-export * from './unified'

package/packages/shared/src/schemas.ts

@@ -1,124 +0,0 @@
-/**
- * Zod Schemas for validation
- */
-
-import { z } from 'zod'
-
-// Session Schemas
-export const SessionMetricsSchema = z.object({
-  filesChanged: z.number().default(0),
-  linesAdded: z.number().default(0),
-  linesRemoved: z.number().default(0),
-  commits: z.number().default(0),
-  snapshots: z.array(z.string()).default([])
-})
-
-export const TimelineEventSchema = z.object({
-  type: z.enum(['start', 'pause', 'resume', 'complete', 'snapshot']),
-  at: z.string().datetime(),
-  data: z.record(z.unknown()).optional()
-})
-
-export const SessionSchema = z.object({
-  id: z.string().regex(/^sess_[a-z0-9]{8}$/),
-  projectId: z.string(),
-  task: z.string().min(1),
-  status: z.enum(['active', 'paused', 'completed']),
-  startedAt: z.string().datetime(),
-  pausedAt: z.string().datetime().nullable(),
-  completedAt: z.string().datetime().nullable(),
-  duration: z.number().min(0),
-  metrics: SessionMetricsSchema,
-  timeline: z.array(TimelineEventSchema)
-})
-
-// Task Schemas
-export const TaskSchema = z.object({
-  id: z.string(),
-  title: z.string().min(1),
-  description: z.string().optional(),
-  status: z.enum(['pending', 'in_progress', 'completed', 'blocked']),
-  priority: z.enum(['low', 'medium', 'high', 'critical']),
-  createdAt: z.string().datetime(),
-  completedAt: z.string().datetime().optional(),
-  duration: z.number().optional(),
-  tags: z.array(z.string()).optional()
-})
-
-// Idea Schemas
-export const IdeaSchema = z.object({
-  id: z.string(),
-  content: z.string().min(1),
-  capturedAt: z.string().datetime(),
-  source: z.string().optional(),
-  promoted: z.boolean().optional(),
-  promotedTo: z.string().optional()
-})
-
-// Feature Schemas
-export const FeatureSchema = z.object({
-  id: z.string(),
-  title: z.string().min(1),
-  description: z.string().optional(),
-  status: z.enum(['planned', 'in_progress', 'shipped', 'cancelled']),
-  priority: z.number().min(1),
-  createdAt: z.string().datetime(),
-  shippedAt: z.string().datetime().optional(),
-  tasks: z.array(TaskSchema).optional(),
-  version: z.string().optional()
-})
-
-// Project Config Schema
-export const ProjectConfigSchema = z.object({
-  projectId: z.string(),
-  name: z.string().optional(),
-  plugins: z.array(z.string()).optional()
-}).passthrough()
-
-// WebSocket Message Schemas
-export const WSInputMessageSchema = z.object({
-  type: z.literal('input'),
-  payload: z.object({
-    data: z.string()
-  }),
-  timestamp: z.string().datetime()
-})
-
-export const WSResizeMessageSchema = z.object({
-  type: z.literal('resize'),
-  payload: z.object({
-    cols: z.number().min(1),
-    rows: z.number().min(1)
-  }),
-  timestamp: z.string().datetime()
-})
-
-export const WSMessageSchema = z.discriminatedUnion('type', [
-  WSInputMessageSchema,
-  WSResizeMessageSchema
-])
-
-// API Request Schemas
-export const CreateSessionRequestSchema = z.object({
-  task: z.string().min(1).max(200),
-  projectId: z.string()
-})
-
-export const CreateTaskRequestSchema = z.object({
-  title: z.string().min(1).max(200),
-  description: z.string().max(1000).optional(),
-  priority: z.enum(['low', 'medium', 'high', 'critical']).default('medium')
-})
-
-export const CaptureIdeaRequestSchema = z.object({
-  content: z.string().min(1).max(500),
-  source: z.string().optional()
-})
-
-// Inferred Types
-export type SessionInput = z.infer<typeof SessionSchema>
-export type TaskInput = z.infer<typeof TaskSchema>
-export type IdeaInput = z.infer<typeof IdeaSchema>
-export type FeatureInput = z.infer<typeof FeatureSchema>
-export type ProjectConfigInput = z.infer<typeof ProjectConfigSchema>
-export type WSMessageInput = z.infer<typeof WSMessageSchema>

package/packages/shared/src/types.ts

@@ -1,187 +0,0 @@
-/**
- * Core Types for prjct
- */
-
-// Session Types
-export interface Session {
-  id: string
-  projectId: string
-  task: string
-  status: 'active' | 'paused' | 'completed'
-  startedAt: string
-  pausedAt: string | null
-  completedAt: string | null
-  duration: number
-  metrics: SessionMetrics
-  timeline: TimelineEvent[]
-}
-
-export interface SessionMetrics {
-  filesChanged: number
-  linesAdded: number
-  linesRemoved: number
-  commits: number
-  snapshots: string[]
-}
-
-export interface TimelineEvent {
-  type: 'start' | 'pause' | 'resume' | 'complete' | 'snapshot'
-  at: string
-  data?: Record<string, unknown>
-}
-
-// Snapshot Types
-export interface Snapshot {
-  hash: string
-  shortHash: string
-  message: string
-  timestamp: string
-  files: string[]
-}
-
-// Task Types
-export interface Task {
-  id: string
-  title: string
-  description?: string
-  status: 'pending' | 'in_progress' | 'completed' | 'blocked'
-  priority: 'low' | 'medium' | 'high' | 'critical'
-  createdAt: string
-  completedAt?: string
-  duration?: number
-  tags?: string[]
-}
-
-// Idea Types
-export interface Idea {
-  id: string
-  content: string
-  capturedAt: string
-  source?: string
-  promoted?: boolean
-  promotedTo?: string
-}
-
-// Feature Types
-export interface Feature {
-  id: string
-  title: string
-  description?: string
-  status: 'planned' | 'in_progress' | 'shipped' | 'cancelled'
-  priority: number
-  createdAt: string
-  shippedAt?: string
-  tasks?: Task[]
-  version?: string
-}
-
-// Project Types
-export interface Project {
-  id: string
-  name: string
-  path: string
-  createdAt: string
-  lastActiveAt: string
-  config: ProjectConfig
-}
-
-export interface ProjectConfig {
-  projectId: string
-  name?: string
-  plugins?: string[]
-  [key: string]: unknown
-}
-
-// Metrics Types
-export interface DailyMetrics {
-  date: string
-  sessions: number
-  duration: number
-  commits: number
-  filesChanged: number
-  linesAdded: number
-  linesRemoved: number
-}
-
-export interface WeeklyMetrics {
-  weekStart: string
-  weekEnd: string
-  totalSessions: number
-  totalDuration: number
-  averageDuration: number
-  tasksCompleted: number
-  featuresShipped: number
-  productivityScore: number
-  streak: number
-  byDay: Record<string, DailyMetrics>
-}
-
-// WebSocket Message Types
-export interface WSMessage {
-  type: string
-  payload?: unknown
-  timestamp: string
-}
-
-export interface WSInputMessage extends WSMessage {
-  type: 'input'
-  payload: {
-    data: string
-  }
-}
-
-export interface WSOutputMessage extends WSMessage {
-  type: 'output'
-  payload: {
-    data: string
-  }
-}
-
-export interface WSResizeMessage extends WSMessage {
-  type: 'resize'
-  payload: {
-    cols: number
-    rows: number
-  }
-}
-
-export interface WSStatusMessage extends WSMessage {
-  type: 'status'
-  payload: {
-    status: 'connected' | 'disconnected' | 'error'
-    message?: string
-  }
-}
-
-// API Response Types
-export interface ApiResponse<T = unknown> {
-  success: boolean
-  data?: T
-  error?: string
-  timestamp: string
-}
-
-// Event Types (for event bus)
-export type EventType =
-  | 'session.started'
-  | 'session.paused'
-  | 'session.resumed'
-  | 'session.completed'
-  | 'task.created'
-  | 'task.completed'
-  | 'feature.added'
-  | 'feature.shipped'
-  | 'idea.captured'
-  | 'snapshot.created'
-  | 'snapshot.restored'
-  | 'git.commit'
-  | 'git.push'
-  | 'project.init'
-  | 'project.sync'
-
-export interface EventPayload {
-  type: EventType
-  timestamp: string
-  projectId: string
-  data: Record<string, unknown>
-}