joycraft 0.7.12 → 0.7.14
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/README.md +30 -16
- package/dist/chunk-7BPB2IKY.js +255 -0
- package/dist/chunk-7BPB2IKY.js.map +1 -0
- package/dist/chunk-B73DPYYC.js +377 -0
- package/dist/chunk-B73DPYYC.js.map +1 -0
- package/dist/{chunk-DSVGHVYM.js → chunk-JYPBXPGD.js} +117 -90
- package/dist/chunk-JYPBXPGD.js.map +1 -0
- package/dist/{chunk-OAC5CVHJ.js → chunk-K4AI6FKB.js} +12 -2
- package/dist/chunk-K4AI6FKB.js.map +1 -0
- package/dist/{chunk-PBOICMDE.js → chunk-KKDKC4FM.js} +11 -73
- package/dist/chunk-KKDKC4FM.js.map +1 -0
- package/dist/chunk-OMFGDJW4.js +97 -0
- package/dist/chunk-OMFGDJW4.js.map +1 -0
- package/dist/chunk-PR4QDKPL.js +3755 -0
- package/dist/chunk-PR4QDKPL.js.map +1 -0
- package/dist/chunk-Z5JFEGWG.js +563 -0
- package/dist/chunk-Z5JFEGWG.js.map +1 -0
- package/dist/cli.js +389 -56
- package/dist/cli.js.map +1 -1
- package/dist/index.d.ts +235 -1
- package/dist/index.js +691 -1
- package/dist/index.js.map +1 -1
- package/dist/init-S5JU5BHL.js +60 -0
- package/dist/init-S5JU5BHL.js.map +1 -0
- package/dist/{init-autofix-YCSDK5ZR.js → init-autofix-WSKUT2HN.js} +4 -3
- package/dist/{init-autofix-YCSDK5ZR.js.map → init-autofix-WSKUT2HN.js.map} +1 -1
- package/dist/install-manifest-EQHT4474.js +37 -0
- package/dist/joycraft-release.json +8 -0
- package/dist/release-artifact-4TL5L2ZY.js +14 -0
- package/dist/release-resolver-P2H46QTU.js +293 -0
- package/dist/release-resolver-P2H46QTU.js.map +1 -0
- package/dist/{telemetry-store-X7K5NYWD.js → telemetry-store-IBO5GRTA.js} +2 -2
- package/dist/telemetry-store-IBO5GRTA.js.map +1 -0
- package/dist/update-HNTXCEKB.js +19 -0
- package/dist/update-HNTXCEKB.js.map +1 -0
- package/dist/update-check-YT765NE7.js +36 -0
- package/dist/update-check-YT765NE7.js.map +1 -0
- package/dist/upgrade-LZOND7OZ.js +28 -0
- package/dist/upgrade-LZOND7OZ.js.map +1 -0
- package/package.json +5 -2
- package/dist/chunk-BZW5DR3O.js +0 -91
- package/dist/chunk-BZW5DR3O.js.map +0 -1
- package/dist/chunk-DSVGHVYM.js.map +0 -1
- package/dist/chunk-OAC5CVHJ.js.map +0 -1
- package/dist/chunk-PBOICMDE.js.map +0 -1
- package/dist/chunk-Q2ZQ6RGD.js +0 -243
- package/dist/chunk-Q2ZQ6RGD.js.map +0 -1
- package/dist/init-J5Q6RX3K.js +0 -1307
- package/dist/init-J5Q6RX3K.js.map +0 -1
- package/dist/upgrade-AHUSQZEQ.js +0 -643
- package/dist/upgrade-AHUSQZEQ.js.map +0 -1
- package/dist/version-B2CCAEMC.js +0 -28
- /package/dist/{telemetry-store-X7K5NYWD.js.map → install-manifest-EQHT4474.js.map} +0 -0
- /package/dist/{version-B2CCAEMC.js.map → release-artifact-4TL5L2ZY.js.map} +0 -0
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/telemetry-store.ts","../src/telemetry.ts"],"sourcesContent":["// Persistence for the read-telemetry scanner (src/telemetry.ts).\n//\n// Accumulates scan results into a machine-local, gitignored store at\n// docs/.joycraft/telemetry.json — repo-relative doc paths, counters, and\n// namespaced scanned-session ids only, never transcript content. Sessions\n// already in the scanned list are skipped, so each transcript file is parsed\n// once and counters accumulate across invocations.\n\nimport { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport {\n scanTranscripts,\n defaultClaudeTranscriptDir,\n defaultPiTranscriptDir,\n defaultCodexTranscriptDir,\n type DocCounts,\n} from './telemetry.js';\n\n/** Repo-relative store location, beside docs/.joycraft/state.json. Gitignored under every profile. */\nexport const TELEMETRY_PATH = 'docs/.joycraft/telemetry.json';\n\nexport interface TelemetryStore {\n version: 1;\n /** Namespaced ids (`claude:<id>`, `pi:<id>`, `codex:<id>`) of sessions already counted. */\n scannedSessions: string[];\n docs: Record<string, DocCounts>;\n}\n\nexport interface TelemetryScanOptions {\n claudeDir?: string;\n piDir?: string;\n codexDir?: string;\n /** Store file location. Defaults to `<projectDir>/docs/.joycraft/telemetry.json`. */\n storePath?: string;\n}\n\nexport interface TelemetryScanResult {\n status: 'ok' | 'nothing-to-scan';\n newSessions: number;\n docCount: number;\n storePath: string;\n /** True when an existing store was unreadable and replaced. */\n rebuiltStore?: boolean;\n}\n\n/** Parse an existing store, or null when absent or malformed. */\nexport function loadTelemetryStore(storePath: string): TelemetryStore | null {\n try {\n const parsed = JSON.parse(readFileSync(storePath, 'utf-8'));\n if (!parsed || typeof parsed !== 'object') return null;\n if (parsed.version !== 1 || !Array.isArray(parsed.scannedSessions) || typeof parsed.docs !== 'object') {\n return null;\n }\n return parsed as TelemetryStore;\n } catch {\n return null;\n }\n}\n\nfunction emptyStore(): TelemetryStore {\n return { version: 1, scannedSessions: [], docs: {} };\n}\n\nfunction mergeDocCounts(into: TelemetryStore, docs: Record<string, DocCounts>): void {\n for (const [path, counts] of Object.entries(docs)) {\n const existing = into.docs[path];\n if (!existing) {\n into.docs[path] = {\n reads: counts.reads,\n mandatedReads: counts.mandatedReads,\n voluntaryReads: counts.voluntaryReads,\n writes: counts.writes,\n sessions: [...counts.sessions],\n ...(counts.fidelity ? { fidelity: counts.fidelity } : {}),\n };\n continue;\n }\n existing.reads += counts.reads;\n existing.mandatedReads += counts.mandatedReads;\n existing.voluntaryReads += counts.voluntaryReads;\n existing.writes += counts.writes;\n for (const session of counts.sessions) {\n if (!existing.sessions.includes(session)) existing.sessions.push(session);\n }\n if (counts.fidelity) existing.fidelity = counts.fidelity;\n }\n}\n\n/** Write temp + rename so concurrent runs are last-writer-wins, never torn JSON. */\nfunction saveStore(storePath: string, store: TelemetryStore): void {\n mkdirSync(dirname(storePath), { recursive: true });\n const sortedDocs: Record<string, DocCounts> = {};\n for (const key of Object.keys(store.docs).sort()) sortedDocs[key] = store.docs[key];\n const payload = { version: store.version, scannedSessions: [...store.scannedSessions].sort(), docs: sortedDocs };\n const tmp = `${storePath}.tmp-${process.pid}`;\n writeFileSync(tmp, JSON.stringify(payload, null, 2) + '\\n', 'utf-8');\n renameSync(tmp, storePath);\n}\n\n/**\n * Scan this project's transcripts and accumulate the result into the store.\n * Missing transcript dirs report `nothing-to-scan`; a malformed store is\n * rebuilt rather than crashed on.\n */\nexport async function runTelemetryScan(\n projectDir: string,\n opts: TelemetryScanOptions = {},\n): Promise<TelemetryScanResult> {\n const storePath = opts.storePath ?? join(projectDir, TELEMETRY_PATH);\n\n const claudeDir = opts.claudeDir ?? defaultClaudeTranscriptDir(projectDir);\n const piDir = opts.piDir ?? defaultPiTranscriptDir(projectDir);\n const codexDir = opts.codexDir ?? defaultCodexTranscriptDir();\n\n const existing = loadTelemetryStore(storePath);\n const rebuiltStore = existing === null && existsSync(storePath);\n const store = existing ?? emptyStore();\n\n if (![claudeDir, piDir, codexDir].some((dir) => existsSync(dir))) {\n return { status: 'nothing-to-scan', newSessions: 0, docCount: Object.keys(store.docs).length, storePath };\n }\n\n const scan = await scanTranscripts(projectDir, {\n claudeDir,\n piDir,\n codexDir,\n namespaceSessions: true,\n excludeSessions: new Set(store.scannedSessions),\n });\n\n mergeDocCounts(store, scan.docs);\n for (const session of scan.sessions) {\n if (!store.scannedSessions.includes(session)) store.scannedSessions.push(session);\n }\n saveStore(storePath, store);\n\n return {\n status: 'ok',\n newSessions: scan.sessions.length,\n docCount: Object.keys(store.docs).length,\n storePath,\n ...(rebuiltStore ? { rebuiltStore: true } : {}),\n };\n}\n\n/** One-line summary for the CLI. */\nexport function formatTelemetrySummary(result: TelemetryScanResult): string {\n if (result.status === 'nothing-to-scan') {\n return 'Telemetry: nothing to scan — no transcript directories found for this project.';\n }\n const rebuilt = result.rebuiltStore ? ' (previous store was malformed and rebuilt)' : '';\n return `Telemetry: ${result.newSessions} new session(s) scanned, ${result.docCount} doc(s) tracked → ${TELEMETRY_PATH}${rebuilt}`;\n}\n","// Read-telemetry scanner for the knowledge layer.\n//\n// Parses AI-harness session transcripts into per-document read/write counts so\n// optimize's Reaper pass can cite evidence instead of judgment. Read-only and\n// network-free: nothing here writes a file, and no transcript content ever\n// reaches the result — paths and counters only.\n//\n// Transcript layouts (derived at runtime from $HOME + dash-encoded cwd, never\n// shipped as literal absolute paths — the src/frontmatter.ts defaultMemoryDir idiom):\n// Claude Code: $HOME/.claude/projects/<cwd-with-slashes-as-dashes>/*.jsonl\n// Pi: $HOME/.pi/agent/sessions/--<cwd-with-slashes-as-dashes>--/*.jsonl\n\nimport { existsSync, readdirSync, readFileSync } from 'node:fs';\nimport { join, relative, isAbsolute, sep } from 'node:path';\n\nexport type FileOpKind = 'read' | 'write';\n\nexport interface FileOp {\n kind: FileOpKind;\n path: string;\n}\n\n/** What one transcript line contributes: file ops, a session id, an active-skill change. */\nexport interface ParsedLine {\n ops: FileOp[];\n sessionId: string | null;\n skill: string | null;\n /** The session's working directory, when the transcript records one (Codex session_meta). */\n cwd?: string;\n}\n\nexport interface DocCounts {\n reads: number;\n mandatedReads: number;\n voluntaryReads: number;\n writes: number;\n sessions: string[];\n /** Present when any contribution came from a shell-string parse (Codex) — counts are best-effort. */\n fidelity?: 'degraded';\n}\n\nexport interface ScanResult {\n docs: Record<string, DocCounts>;\n sessions: string[];\n}\n\nexport interface ScanOptions {\n /** Claude Code transcript directory. Defaults to the $HOME-derived path. */\n claudeDir?: string;\n /** Pi transcript directory. Defaults to the $HOME-derived path. */\n piDir?: string;\n /** Codex transcript directory (rollout-*.jsonl). Defaults to the $HOME-derived path. */\n codexDir?: string;\n /** Prefix session ids per harness (`claude:<id>`, `pi:<id>`, `codex:<id>`) in the result. */\n namespaceSessions?: boolean;\n /** Sessions to skip entirely (matched against ids as they appear in the result). */\n excludeSessions?: ReadonlySet<string>;\n}\n\n// --- knowledge-layer filter -------------------------------------------------\n\nconst KNOWLEDGE_PREFIXES = ['docs/context/', 'docs/discoveries/', 'docs/reference/'];\nconst KNOWLEDGE_FILES = ['AGENTS.md', 'CLAUDE.md'];\n\n/** True for the five knowledge-layer shapes, given a repo-relative POSIX path. */\nexport function isKnowledgeLayerPath(relPath: string): boolean {\n if (KNOWLEDGE_FILES.includes(relPath)) return true;\n return KNOWLEDGE_PREFIXES.some((prefix) => relPath.startsWith(prefix) && relPath.length > prefix.length);\n}\n\n// --- mandated/voluntary classification --------------------------------------\n\n// A read is `mandated` when the active skill's own text opens that doc: session-end\n// Step 1b routes to the context docs, add-fact Step 2b overlap-greps them, optimize's\n// Reaper pass reads the whole knowledge layer. Everything else is `voluntary` — the\n// agent followed a pointer mid-task, which is the only evidence that earns keep/retire.\nconst MANDATING_SKILLS: Record<string, (relPath: string) => boolean> = {\n 'joycraft-session-end': (p) => p.startsWith('docs/context/') || p.startsWith('docs/discoveries/'),\n 'joycraft-add-fact': (p) => p.startsWith('docs/context/'),\n 'joycraft-optimize': () => true,\n};\n\nfunction isMandated(activeSkill: string | null, relPath: string): boolean {\n if (!activeSkill) return false;\n const predicate = MANDATING_SKILLS[activeSkill];\n return predicate ? predicate(relPath) : false;\n}\n\n// --- per-harness line parsers -----------------------------------------------\n\nfunction parseJson(line: string): any | null {\n const trimmed = line.trim();\n if (!trimmed) return null;\n try {\n return JSON.parse(trimmed);\n } catch {\n return null;\n }\n}\n\nfunction result(ops: FileOp[], sessionId: string | null, skill: string | null): ParsedLine | null {\n if (ops.length === 0 && !sessionId && !skill) return null;\n return { ops, sessionId, skill };\n}\n\nconst CLAUDE_READ_TOOLS = new Set(['Read', 'NotebookRead']);\nconst CLAUDE_WRITE_TOOLS = new Set(['Write', 'Edit', 'MultiEdit', 'NotebookEdit']);\n\n/**\n * Claude Code JSONL: `tool_use` blocks inside `message.content`, with the path on\n * `input.file_path`, and skill invocations as a `Skill` tool_use.\n */\nexport function parseClaudeSessionLine(line: string): ParsedLine | null {\n const record = parseJson(line);\n if (!record || typeof record !== 'object') return null;\n\n const sessionId = typeof record.sessionId === 'string' ? record.sessionId : null;\n const content = record.message?.content;\n const ops: FileOp[] = [];\n let skill: string | null = null;\n\n if (Array.isArray(content)) {\n for (const block of content) {\n if (!block || typeof block !== 'object' || block.type !== 'tool_use') continue;\n const name = block.name;\n if (name === 'Skill') {\n const invoked = block.input?.skill;\n if (typeof invoked === 'string') skill = invoked;\n continue;\n }\n const filePath = block.input?.file_path;\n if (typeof filePath !== 'string' || !filePath) continue;\n if (CLAUDE_READ_TOOLS.has(name)) ops.push({ kind: 'read', path: filePath });\n else if (CLAUDE_WRITE_TOOLS.has(name)) ops.push({ kind: 'write', path: filePath });\n }\n }\n\n return result(ops, sessionId, skill);\n}\n\nconst PI_READ_TOOLS = new Set(['read']);\nconst PI_WRITE_TOOLS = new Set(['write', 'edit', 'multi_edit']);\nconst PI_SKILL_RE = /^\\s*\\/skill:([A-Za-z0-9._-]+)/;\n\n/**\n * Pi JSONL: typed events. `session` carries the id; `message` events hold\n * `toolCall` blocks whose path lives on `arguments.path` (or `arguments.o[].p`\n * for `batch_read`). Skills are invoked by a `/skill:<name>` user message.\n */\nexport function parsePiSessionLine(line: string): ParsedLine | null {\n const record = parseJson(line);\n if (!record || typeof record !== 'object') return null;\n\n if (record.type === 'session') {\n const id = typeof record.id === 'string' ? record.id : null;\n return result([], id, null);\n }\n if (record.type !== 'message') return null;\n\n const message = record.message;\n const content = message?.content;\n const ops: FileOp[] = [];\n let skill: string | null = null;\n\n if (Array.isArray(content)) {\n for (const block of content) {\n if (!block || typeof block !== 'object') continue;\n\n if (block.type === 'text' && message?.role === 'user' && typeof block.text === 'string') {\n const match = block.text.match(PI_SKILL_RE);\n if (match) skill = match[1];\n continue;\n }\n\n if (block.type !== 'toolCall') continue;\n const name = block.name;\n const args = block.arguments;\n\n if (name === 'batch_read' && Array.isArray(args?.o)) {\n for (const entry of args.o) {\n if (entry && typeof entry === 'object' && typeof entry.p === 'string' && entry.p) {\n ops.push({ kind: entry.o === 'write' || entry.o === 'edit' ? 'write' : 'read', path: entry.p });\n }\n }\n continue;\n }\n\n const filePath = args?.path;\n if (typeof filePath !== 'string' || !filePath) continue;\n if (PI_READ_TOOLS.has(name)) ops.push({ kind: 'read', path: filePath });\n else if (PI_WRITE_TOOLS.has(name)) ops.push({ kind: 'write', path: filePath });\n }\n }\n\n return result(ops, null, skill);\n}\n\n// --- Codex parser (degraded fidelity) ----------------------------------------\n//\n// Codex rollout-*.jsonl records file operations only as `exec_command` shell\n// strings, so this parser tokenizes command text and keeps only high-confidence\n// patterns: a recognized command with an explicit literal path argument, or an\n// output redirect. Anything with variables, substitutions, or unbalanced quoting\n// is dropped rather than guessed — best-effort by design, no parity claim.\n\nconst CODEX_READ_COMMANDS = new Set(['cat', 'head', 'tail', 'sed', 'grep', 'less', 'more']);\n\n/** Split a shell string into tokens, honoring quotes. Null on unbalanced quoting. */\nfunction tokenizeShell(cmd: string): string[] | null {\n const tokens: string[] = [];\n let current = '';\n let started = false;\n let quote: '\"' | \"'\" | null = null;\n for (const ch of cmd) {\n if (quote) {\n if (ch === quote) quote = null;\n else current += ch;\n continue;\n }\n if (ch === '\"' || ch === \"'\") {\n quote = ch;\n started = true;\n continue;\n }\n if (/\\s/.test(ch)) {\n if (started) tokens.push(current);\n current = '';\n started = false;\n continue;\n }\n current += ch;\n started = true;\n }\n if (quote) return null;\n if (started) tokens.push(current);\n return tokens;\n}\n\n/** File ops recognized in one pipeline segment; empty when nothing is high-confidence. */\nfunction opsFromSegment(tokens: string[]): FileOp[] {\n if (tokens.length === 0) return [];\n // Variables and substitutions anywhere make the segment untrustworthy.\n if (tokens.some((t) => t.includes('$') || t.includes('`'))) return [];\n\n const writes: string[] = [];\n const args: string[] = [];\n for (let i = 1; i < tokens.length; i++) {\n const token = tokens[i];\n const redirect = token.match(/^\\d*(>{1,2})(.*)$/);\n if (redirect) {\n const target = redirect[2] || tokens[++i];\n if (target) writes.push(target);\n continue;\n }\n if (!token.startsWith('-')) args.push(token);\n }\n\n const ops: FileOp[] = [];\n const command = tokens[0];\n if (CODEX_READ_COMMANDS.has(command)) {\n // grep's first non-flag argument is the pattern, sed's is the script — skip it.\n const paths = command === 'grep' || command === 'sed' ? args.slice(1) : args;\n for (const path of paths) ops.push({ kind: 'read', path });\n }\n for (const path of writes) ops.push({ kind: 'write', path });\n return ops;\n}\n\n/**\n * Codex JSONL: `session_meta` carries the id and cwd; `response_item` lines hold\n * `function_call` payloads whose `arguments` is a JSON string with the `cmd` text.\n */\nexport function parseCodexSessionLine(line: string): ParsedLine | null {\n const record = parseJson(line);\n if (!record || typeof record !== 'object') return null;\n\n if (record.type === 'session_meta') {\n const payload = record.payload;\n const id = typeof payload?.id === 'string' ? payload.id : null;\n const cwd = typeof payload?.cwd === 'string' ? payload.cwd : undefined;\n if (!id && !cwd) return null;\n return { ops: [], sessionId: id, skill: null, cwd };\n }\n\n const payload = record.payload;\n if (record.type !== 'response_item' || payload?.type !== 'function_call') return null;\n if (payload.name !== 'exec_command' && payload.name !== 'shell') return null;\n const parsedArgs = typeof payload.arguments === 'string' ? parseJson(payload.arguments) : payload.arguments;\n const cmd = parsedArgs?.cmd ?? (Array.isArray(parsedArgs?.command) ? parsedArgs.command.join(' ') : null);\n if (typeof cmd !== 'string' || !cmd) return null;\n\n // Compound structures (loops, conditionals) are beyond conservative parsing.\n if (/\\b(for|while|if|do|done|fi)\\b/.test(cmd)) return result([], null, null);\n\n const ops: FileOp[] = [];\n for (const segment of cmd.split(/\\||&&|;/)) {\n const tokens = tokenizeShell(segment.trim());\n if (!tokens) continue;\n ops.push(...opsFromSegment(tokens));\n }\n return result(ops, null, null);\n}\n\n// --- default transcript locations -------------------------------------------\n\nfunction encodedCwd(projectDir: string): string {\n return projectDir.replace(/\\//g, '-');\n}\n\nexport function defaultClaudeTranscriptDir(projectDir: string): string {\n const home = process.env.HOME ?? '';\n return join(home, '.claude', 'projects', encodedCwd(projectDir));\n}\n\nexport function defaultPiTranscriptDir(projectDir: string): string {\n const home = process.env.HOME ?? '';\n return join(home, '.pi', 'agent', 'sessions', `-${encodedCwd(projectDir)}--`);\n}\n\n/** Codex sessions are global (date-nested, not per-project) — the scan guards on session_meta cwd. */\nexport function defaultCodexTranscriptDir(): string {\n const home = process.env.HOME ?? '';\n return join(home, '.codex', 'sessions');\n}\n\n// --- scan -------------------------------------------------------------------\n\n/** Repo-relative POSIX path, or null when the op is outside the project. */\nfunction toRepoRelative(projectDir: string, filePath: string): string | null {\n const absolute = isAbsolute(filePath) ? filePath : join(projectDir, filePath);\n const rel = relative(projectDir, absolute);\n if (!rel || rel.startsWith('..') || isAbsolute(rel)) return null;\n return rel.split(sep).join('/');\n}\n\nfunction listSessionFiles(dir: string): string[] {\n try {\n if (!existsSync(dir)) return [];\n return readdirSync(dir)\n .filter((name) => name.endsWith('.jsonl'))\n .sort()\n .map((name) => join(dir, name));\n } catch {\n return [];\n }\n}\n\n/** Recursive rollout-*.jsonl listing for Codex's date-nested layout. Depth-capped. */\nfunction listRolloutFiles(dir: string, depth = 0): string[] {\n if (depth > 4) return [];\n try {\n if (!existsSync(dir)) return [];\n const files: string[] = [];\n for (const entry of readdirSync(dir, { withFileTypes: true })) {\n const full = join(dir, entry.name);\n if (entry.isDirectory()) files.push(...listRolloutFiles(full, depth + 1));\n else if (entry.name.startsWith('rollout-') && entry.name.endsWith('.jsonl')) files.push(full);\n }\n return files.sort();\n } catch {\n return [];\n }\n}\n\ninterface Accumulator {\n docs: Map<string, DocCounts>;\n sessions: Set<string>;\n}\n\nfunction record(\n acc: Accumulator,\n sessionId: string,\n relPath: string,\n op: FileOp,\n mandated: boolean,\n fidelity?: 'degraded',\n): void {\n let counts = acc.docs.get(relPath);\n if (!counts) {\n counts = { reads: 0, mandatedReads: 0, voluntaryReads: 0, writes: 0, sessions: [] };\n acc.docs.set(relPath, counts);\n }\n if (fidelity) counts.fidelity = fidelity;\n if (op.kind === 'write') {\n counts.writes += 1;\n } else {\n counts.reads += 1;\n if (mandated) counts.mandatedReads += 1;\n else counts.voluntaryReads += 1;\n }\n if (!counts.sessions.includes(sessionId)) counts.sessions.push(sessionId);\n}\n\ninterface SourceProfile {\n /** Codex: skill attribution is unavailable from shell strings — default reads to mandated. */\n forceMandated?: boolean;\n fidelity?: 'degraded';\n /** Codex: sessions are global, so count a file only when its session_meta cwd names this project. */\n requireCwdMatch?: boolean;\n /** Harness namespace prepended to session ids (`claude:<id>`). */\n prefix?: string;\n /** Sessions (as namespaced when a prefix is set) whose files are skipped. */\n exclude?: ReadonlySet<string>;\n}\n\nfunction scanFile(\n acc: Accumulator,\n projectDir: string,\n filePath: string,\n parse: (line: string) => ParsedLine | null,\n source: SourceProfile = {},\n): void {\n let content: string;\n try {\n content = readFileSync(filePath, 'utf-8');\n } catch {\n return;\n }\n\n // Fall back to the file's own name as the session id — Pi names its files\n // <timestamp>_<uuid>.jsonl and Claude names them <sessionId>.jsonl, so a\n // transcript whose id line is missing or truncated still attributes.\n const fallbackId = filePath.split(sep).pop()!.replace(/\\.jsonl$/, '');\n let sessionId: string | null = null;\n let activeSkill: string | null = null;\n let cwdMatched = !source.requireCwdMatch;\n const pending: Array<{ op: FileOp; mandated: boolean }> = [];\n\n for (const line of content.split('\\n')) {\n const parsed = parse(line);\n if (!parsed) continue;\n if (parsed.sessionId) sessionId = parsed.sessionId;\n if (parsed.skill) activeSkill = parsed.skill;\n if (source.requireCwdMatch && parsed.cwd) {\n if (parsed.cwd !== projectDir) return;\n cwdMatched = true;\n }\n\n for (const op of parsed.ops) {\n const rel = toRepoRelative(projectDir, op.path);\n if (!rel || !isKnowledgeLayerPath(rel)) continue;\n const mandated = source.forceMandated ? op.kind === 'read' : isMandated(activeSkill, rel);\n pending.push({ op: { kind: op.kind, path: rel }, mandated });\n }\n }\n\n if (pending.length === 0 || !cwdMatched) return;\n const bareId = sessionId ?? fallbackId;\n const id = source.prefix ? `${source.prefix}:${bareId}` : bareId;\n if (source.exclude?.has(id)) return;\n acc.sessions.add(id);\n for (const { op, mandated } of pending) {\n record(acc, id, op.path, op, mandated, source.fidelity);\n }\n}\n\n/**\n * Scan a project's Claude and Pi transcripts into per-document counts for the\n * knowledge layer. Missing transcript directories yield an empty contribution;\n * malformed lines and unreadable files are skipped, never thrown.\n */\nexport async function scanTranscripts(projectDir: string, opts: ScanOptions = {}): Promise<ScanResult> {\n const acc: Accumulator = { docs: new Map(), sessions: new Set() };\n\n const prefix = (harness: string): string | undefined => (opts.namespaceSessions ? harness : undefined);\n const exclude = opts.excludeSessions;\n\n const claudeDir = opts.claudeDir ?? defaultClaudeTranscriptDir(projectDir);\n for (const file of listSessionFiles(claudeDir)) {\n scanFile(acc, projectDir, file, parseClaudeSessionLine, { prefix: prefix('claude'), exclude });\n }\n\n const piDir = opts.piDir ?? defaultPiTranscriptDir(projectDir);\n for (const file of listSessionFiles(piDir)) {\n scanFile(acc, projectDir, file, parsePiSessionLine, { prefix: prefix('pi'), exclude });\n }\n\n const codexDir = opts.codexDir ?? defaultCodexTranscriptDir();\n for (const file of listRolloutFiles(codexDir)) {\n scanFile(acc, projectDir, file, parseCodexSessionLine, {\n forceMandated: true,\n fidelity: 'degraded',\n requireCwdMatch: true,\n prefix: prefix('codex'),\n exclude,\n });\n }\n\n const docs: Record<string, DocCounts> = {};\n for (const key of [...acc.docs.keys()].sort()) {\n docs[key] = acc.docs.get(key)!;\n }\n return { docs, sessions: [...acc.sessions] };\n}\n"],"mappings":"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","names":["existsSync","readFileSync","join","record","payload","readFileSync","join","existsSync","result"]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/version.ts","../src/harness.ts"],"sourcesContent":["import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';\nimport { join, dirname } from 'node:path';\nimport { createHash } from 'node:crypto';\nimport { sanitizeHarnesses, type Harness } from './harness.js';\n\n/**\n * Project-relative path to Joycraft's upgrade-state file.\n *\n * Hidden inside `docs/` — the one directory `init` always creates regardless of\n * which harnesses are selected — so a single-harness install carries no\n * foreign-harness footprint (a Codex-only project has no `.claude/`, etc.). The\n * state is Joycraft's own bookkeeping (version, file hashes, gitignore profile),\n * not a harness artifact, so it lives in a harness-neutral home. Never at the\n * repo root, never committed (init/upgrade gitignore it).\n *\n * Two legacy locations are migrated on upgrade: the original repo-root\n * `.joycraft-version` (see LEGACY_VERSION_FILE) and the later\n * `.claude/.joycraft/state.json` (see LEGACY_CLAUDE_STATE_PATH).\n */\nexport const STATE_PATH = join('docs', '.joycraft', 'state.json');\n\n/** The original repo-root state path. Kept only so `upgrade` can migrate it. */\nexport const LEGACY_VERSION_FILE = '.joycraft-version';\n\n/**\n * The interim `.claude/`-nested state path, used before state moved to a\n * harness-neutral `docs/` home. Kept only so `upgrade` can migrate it (and so a\n * Codex/Pi-only re-init stops leaving a stray `.claude/` behind).\n */\nexport const LEGACY_CLAUDE_STATE_PATH = join('.claude', '.joycraft', 'state.json');\n\n/**\n * Length we truncate stored hashes to. Full SHA-256 is 64 hex chars; 16 hex\n * (64 bits) is ample to detect customization across ~100 managed files and\n * shrinks the state ~4×. Compare truncated-on-both-sides (see upgrade.ts).\n */\nconst HASH_LENGTH = 16;\n\n/**\n * How much of the Joycraft harness is tracked in git.\n * - `shared` — commit skills/agents/pi so teammates get the workflow (default).\n * - `private` — gitignore .claude/, .agents/, .pi/; track only CLAUDE.md,\n * AGENTS.md, and docs/.\n */\nexport type GitignoreProfile = 'shared' | 'private';\n\nexport const DEFAULT_GITIGNORE_PROFILE: GitignoreProfile = 'shared';\n\n/**\n * Narrow an arbitrary value to a GitignoreProfile, or null if unrecognized.\n * Strings are normalized (trim + lowercase) here so every call site — flag,\n * prompt, persisted state — gets the same case-insensitivity for free.\n */\nexport function parseGitignoreProfile(value: unknown): GitignoreProfile | null {\n const v = typeof value === 'string' ? value.trim().toLowerCase() : value;\n return v === 'shared' || v === 'private' ? v : null;\n}\n\nexport interface VersionInfo {\n version: string;\n files: Record<string, string>;\n /**\n * The gitignore profile chosen at init/upgrade. Absent on state written by\n * Joycraft versions before this field existed — treat absent as `shared`.\n */\n gitignoreProfile?: GitignoreProfile;\n /**\n * The harnesses installed at init (claude/codex/pi). `upgrade` reads this so\n * it only refreshes the harnesses the project actually uses. Absent on state\n * written before harness selection existed — callers treat absent as \"all\n * three\" for backward compatibility.\n */\n harnesses?: Harness[];\n /**\n * Whether gate skills auto-open rendered HTML artifacts (`open`/`xdg-open`).\n * Absent means true — auto-open was unconditional before this field existed.\n * Persisted here (not a new file) per D12; tune offers the toggle.\n */\n autoOpen?: boolean;\n}\n\nexport function hashContent(content: string): string {\n return createHash('sha256').update(content).digest('hex');\n}\n\n/** Truncate a (full) content hash to the stored length. Idempotent for already-short input. */\nexport function truncateHash(hash: string): string {\n return hash.slice(0, HASH_LENGTH);\n}\n\nexport function readVersion(dir: string): VersionInfo | null {\n const filePath = join(dir, STATE_PATH);\n if (!existsSync(filePath)) return null;\n try {\n const raw = readFileSync(filePath, 'utf-8');\n const parsed = JSON.parse(raw);\n if (typeof parsed.version === 'string' && typeof parsed.files === 'object') {\n // Sanitize the profile: ignore unknown/legacy values rather than\n // returning them (absent or bogus → undefined, callers default to shared).\n const profile = parseGitignoreProfile(parsed.gitignoreProfile);\n // Sanitize harnesses similarly: drop unknown tokens; null (not an array)\n // means \"no recorded selection\" → callers default to all available.\n const harnesses = sanitizeHarnesses(parsed.harnesses);\n return {\n version: parsed.version,\n files: parsed.files,\n ...(profile ? { gitignoreProfile: profile } : {}),\n ...(harnesses ? { harnesses } : {}),\n // Only a real boolean counts; anything else is treated as absent\n // (and absent means true at every call site).\n ...(typeof parsed.autoOpen === 'boolean' ? { autoOpen: parsed.autoOpen } : {}),\n };\n }\n return null;\n } catch {\n return null;\n }\n}\n\nexport function writeVersion(\n dir: string,\n version: string,\n files: Record<string, string>,\n gitignoreProfile?: GitignoreProfile,\n harnesses?: Harness[],\n autoOpen?: boolean\n): void {\n const filePath = join(dir, STATE_PATH);\n // An omitted profile/harness-list/autoOpen means \"no new decision\", not\n // \"clear it\": preserve whatever is already persisted so call sites that only\n // refresh version/hashes can never silently strip a saved choice.\n const existing = readVersion(dir);\n const profile = gitignoreProfile ?? existing?.gitignoreProfile;\n const selectedHarnesses = harnesses ?? existing?.harnesses;\n const openSetting = autoOpen ?? existing?.autoOpen;\n // Unknown keys survive rewrites (D12): a newer Joycraft may have stamped\n // fields this version doesn't know about. Known keys are stripped from the\n // raw pass-through so the sanitized values above stay authoritative.\n let unknownKeys: Record<string, unknown> = {};\n if (existsSync(filePath)) {\n try {\n const raw = JSON.parse(readFileSync(filePath, 'utf-8'));\n if (raw && typeof raw === 'object' && !Array.isArray(raw)) {\n const {\n version: _v,\n files: _f,\n gitignoreProfile: _g,\n harnesses: _h,\n autoOpen: _a,\n ...rest\n } = raw as Record<string, unknown>;\n unknownKeys = rest;\n }\n } catch {\n // Unreadable state is rewritten from scratch — same as readVersion's null.\n }\n }\n // Store truncated hashes — single source of truth for the on-disk shape.\n const truncated: Record<string, string> = {};\n for (const [path, hash] of Object.entries(files)) {\n truncated[path] = truncateHash(hash);\n }\n const data: VersionInfo = {\n version,\n files: truncated,\n ...(profile ? { gitignoreProfile: profile } : {}),\n ...(selectedHarnesses ? { harnesses: selectedHarnesses } : {}),\n ...(openSetting !== undefined ? { autoOpen: openSetting } : {}),\n ...unknownKeys,\n };\n mkdirSync(dirname(filePath), { recursive: true });\n writeFileSync(filePath, JSON.stringify(data, null, 2) + '\\n', 'utf-8');\n}\n\n/**\n * The persisted auto-open setting for gate HTML renders. Missing state file or\n * missing/invalid key both mean true — auto-open was unconditional before the\n * setting existed, and that stays the default.\n */\nexport function getAutoOpen(dir: string): boolean {\n return readVersion(dir)?.autoOpen ?? true;\n}\n\n/**\n * Detect the current Joycraft harness level for a project directory.\n * Returns 5 if Level 5 artifacts (autofix workflow + External Validation) are present, 4 otherwise.\n */\nexport function getLevel(dir: string): number {\n const hasAutofix = existsSync(join(dir, '.github', 'workflows', 'autofix.yml'));\n if (!hasAutofix) return 4;\n const claudeMdPath = join(dir, 'CLAUDE.md');\n if (!existsSync(claudeMdPath)) return 4;\n const content = readFileSync(claudeMdPath, 'utf-8');\n return content.includes('## External Validation') ? 5 : 4;\n}\n","import { createInterface } from 'node:readline';\n\n/**\n * The AI coding harnesses Joycraft can install into a project. Each maps to a\n * config dir:\n * - claude → .claude/ (Claude Code)\n * - codex → .agents/ (OpenAI Codex)\n * - pi → .pi/ (Pi)\n * - copilot → .github/ (GitHub Copilot)\n *\n * Single source of truth: the menu, the parser, and the install gates in\n * init.ts all derive from this list so a new harness can't leave a path stale.\n */\nexport const HARNESSES = ['claude', 'codex', 'pi', 'copilot'] as const;\nexport type Harness = (typeof HARNESSES)[number];\n\n/** Human-readable one-liner per harness, shown in the interactive menu. */\nconst HARNESS_LABELS: Record<Harness, string> = {\n claude: 'Claude Code (.claude/)',\n codex: 'OpenAI Codex (.agents/)',\n pi: 'Pi (.pi/)',\n copilot: 'GitHub Copilot (.github/)',\n};\n\nfunction isHarness(value: string): value is Harness {\n return (HARNESSES as readonly string[]).includes(value);\n}\n\n/**\n * Sanitize an arbitrary value (e.g. parsed from state.json) into a harness list,\n * dropping anything unrecognized rather than rejecting the whole list — old or\n * hand-edited state must degrade gracefully. Returns null when the input isn't\n * an array at all (caller treats null as \"no recorded selection\"). Order follows\n * the canonical HARNESSES order and is deduped.\n */\nexport function sanitizeHarnesses(value: unknown): Harness[] | null {\n if (!Array.isArray(value)) return null;\n const present = new Set(\n value.filter((v): v is string => typeof v === 'string').map((v) => v.trim().toLowerCase())\n );\n return HARNESSES.filter((h) => present.has(h));\n}\n\n/**\n * Parse a comma/space-separated answer into a deduped, validated harness list.\n * Returns null when any token is unrecognized so the caller can re-ask rather\n * than silently dropping a typo. An empty answer yields an empty array (the\n * \"install nothing\" case the caller handles explicitly).\n */\nexport function parseHarnessSelection(answer: string): Harness[] | null {\n const tokens = answer\n .split(/[,\\s]+/)\n .map((t) => t.trim().toLowerCase())\n .filter((t) => t.length > 0);\n\n // \"all\" is a convenience alias for every harness.\n if (tokens.length === 1 && tokens[0] === 'all') {\n return [...HARNESSES];\n }\n\n const selected: Harness[] = [];\n for (const token of tokens) {\n if (!isHarness(token)) return null;\n if (!selected.includes(token)) selected.push(token);\n }\n return selected;\n}\n\n/**\n * Interactive multi-select for which harnesses to install. An empty answer is a\n * deliberate \"none\" — the caller prints the run-again message and bails. An\n * unrecognized token re-asks instead of being coerced.\n */\nasync function promptHarnesses(): Promise<Harness[]> {\n const rl = createInterface({ input: process.stdin, output: process.stdout });\n console.log('\\nWhich AI harnesses should Joycraft install?');\n for (const h of HARNESSES) {\n console.log(` ${h.padEnd(7)} — ${HARNESS_LABELS[h]}`);\n }\n return new Promise((resolve) => {\n const ask = (): void => {\n rl.question('Harnesses [comma-separated, or \"all\"] (none): ', (answer) => {\n const parsed = parseHarnessSelection(answer);\n if (parsed !== null) {\n rl.close();\n resolve(parsed);\n return;\n }\n console.log(\n `Unrecognized harness in '${answer.trim()}' — choose from ${HARNESSES.join(', ')} (comma-separated), or leave empty for none.`\n );\n ask();\n });\n };\n ask();\n });\n}\n\n/**\n * Resolve which harnesses to install:\n * - interactive (TTY): show the multi-select menu; honor an empty \"none\"\n * - non-interactive: install all available harnesses, preserving long-standing init behavior\n * for scripted/CI runs that can't answer a prompt.\n */\nexport async function resolveHarnesses(interactive: boolean): Promise<Harness[]> {\n if (interactive) {\n return promptHarnesses();\n }\n return [...HARNESSES];\n}\n"],"mappings":"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","names":[]}
|
package/dist/chunk-Q2ZQ6RGD.js
DELETED
|
@@ -1,243 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
|
|
3
|
-
// src/folder-map.ts
|
|
4
|
-
import { readdirSync } from "fs";
|
|
5
|
-
import { join } from "path";
|
|
6
|
-
var FOLDER_MAP_OPEN = "<!-- joycraft:folder-map -->";
|
|
7
|
-
var FOLDER_MAP_CLOSE = "<!-- /joycraft:folder-map -->";
|
|
8
|
-
var FOLDER_MAP_PLACEHOLDER = "_TODO: one line on what lives here_";
|
|
9
|
-
var MAX_ROWS = 30;
|
|
10
|
-
var SKIPPED_DIRS = /* @__PURE__ */ new Set([
|
|
11
|
-
"node_modules",
|
|
12
|
-
"dist",
|
|
13
|
-
"build",
|
|
14
|
-
"out",
|
|
15
|
-
"coverage",
|
|
16
|
-
"target",
|
|
17
|
-
"vendor",
|
|
18
|
-
"__pycache__",
|
|
19
|
-
"venv",
|
|
20
|
-
".venv",
|
|
21
|
-
"tmp",
|
|
22
|
-
"temp"
|
|
23
|
-
]);
|
|
24
|
-
var KEY_PARENTS = /* @__PURE__ */ new Set(["src", "docs"]);
|
|
25
|
-
var KNOWN_DESCRIPTIONS = {
|
|
26
|
-
"src/": "Source code",
|
|
27
|
-
"docs/": "Documentation",
|
|
28
|
-
"tests/": "Test suite",
|
|
29
|
-
"test/": "Test suite",
|
|
30
|
-
"scripts/": "Maintenance and build scripts",
|
|
31
|
-
"templates/": "Templates",
|
|
32
|
-
"public/": "Static assets served as-is",
|
|
33
|
-
"assets/": "Static assets",
|
|
34
|
-
"examples/": "Usage examples",
|
|
35
|
-
"packages/": "Monorepo packages",
|
|
36
|
-
"apps/": "Monorepo applications",
|
|
37
|
-
"config/": "Configuration",
|
|
38
|
-
"docs/context/": "Knowledge layer \u2014 operational fact-docs and reference",
|
|
39
|
-
"docs/features/": "Per-feature briefs, designs, and atomic specs",
|
|
40
|
-
"docs/discoveries/": "Session surprises worth remembering",
|
|
41
|
-
"docs/templates/": "Bundled output and reference templates",
|
|
42
|
-
"docs/backlog/": "Deferred work, one file per item",
|
|
43
|
-
"docs/research/": "Research notes and findings"
|
|
44
|
-
};
|
|
45
|
-
function listDirs(dir) {
|
|
46
|
-
try {
|
|
47
|
-
return readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory() && !e.name.startsWith(".") && !SKIPPED_DIRS.has(e.name)).map((e) => e.name).sort();
|
|
48
|
-
} catch {
|
|
49
|
-
return [];
|
|
50
|
-
}
|
|
51
|
-
}
|
|
52
|
-
function walkFolders(dir) {
|
|
53
|
-
const tops = listDirs(dir);
|
|
54
|
-
const folders = tops.map((top) => `${top}/`);
|
|
55
|
-
for (const top of tops) {
|
|
56
|
-
if (KEY_PARENTS.has(top)) {
|
|
57
|
-
for (const sub of listDirs(join(dir, top))) {
|
|
58
|
-
folders.push(`${top}/${sub}/`);
|
|
59
|
-
}
|
|
60
|
-
}
|
|
61
|
-
}
|
|
62
|
-
const capped = folders.length > MAX_ROWS;
|
|
63
|
-
return { folders: capped ? folders.slice(0, MAX_ROWS) : folders, capped };
|
|
64
|
-
}
|
|
65
|
-
function parseRows(block) {
|
|
66
|
-
const rows = /* @__PURE__ */ new Map();
|
|
67
|
-
for (const line of block.split("\n")) {
|
|
68
|
-
const match = line.match(/^\| `([^`]+)` \| (.*) \|$/);
|
|
69
|
-
if (match) rows.set(match[1], match[2]);
|
|
70
|
-
}
|
|
71
|
-
return rows;
|
|
72
|
-
}
|
|
73
|
-
function renderFolderMap(dir, existingBlock) {
|
|
74
|
-
const { folders, capped } = walkFolders(dir);
|
|
75
|
-
const previous = existingBlock ? parseRows(existingBlock) : /* @__PURE__ */ new Map();
|
|
76
|
-
const lines = [FOLDER_MAP_OPEN, "| Folder | What lives here |", "|--------|-----------------|"];
|
|
77
|
-
for (const folder of folders) {
|
|
78
|
-
const description = previous.get(folder) ?? KNOWN_DESCRIPTIONS[folder] ?? FOLDER_MAP_PLACEHOLDER;
|
|
79
|
-
lines.push(`| \`${folder}\` | ${description} |`);
|
|
80
|
-
}
|
|
81
|
-
if (capped) {
|
|
82
|
-
lines.push("", `_Capped at ${MAX_ROWS} rows \u2014 this tree is past root-map scale; use the growth path below._`);
|
|
83
|
-
}
|
|
84
|
-
lines.push(
|
|
85
|
-
"",
|
|
86
|
-
"Past multi-team scale, replace this root map with nested per-directory instruction files (`joycraft-collaborative-setup`) \u2014 never a bigger tree.",
|
|
87
|
-
FOLDER_MAP_CLOSE
|
|
88
|
-
);
|
|
89
|
-
return lines.join("\n");
|
|
90
|
-
}
|
|
91
|
-
var BLOCK_RE = new RegExp(`${FOLDER_MAP_OPEN}[\\s\\S]*?${FOLDER_MAP_CLOSE}`);
|
|
92
|
-
function ensureFolderMapSection(markdown, dir) {
|
|
93
|
-
const existingBlock = markdown.match(BLOCK_RE)?.[0];
|
|
94
|
-
if (existingBlock) {
|
|
95
|
-
return markdown.replace(BLOCK_RE, renderFolderMap(dir, existingBlock));
|
|
96
|
-
}
|
|
97
|
-
if (/^## .*architecture/im.test(markdown)) return markdown;
|
|
98
|
-
return `${markdown.trimEnd()}
|
|
99
|
-
|
|
100
|
-
## Architecture
|
|
101
|
-
|
|
102
|
-
${renderFolderMap(dir)}
|
|
103
|
-
`;
|
|
104
|
-
}
|
|
105
|
-
|
|
106
|
-
// src/execution-profile.ts
|
|
107
|
-
import { createInterface } from "readline";
|
|
108
|
-
var EXECUTION_PROFILE_OPEN = "<!-- joycraft:execution-profile -->";
|
|
109
|
-
var EXECUTION_PROFILE_CLOSE = "<!-- /joycraft:execution-profile -->";
|
|
110
|
-
var EXECUTION_PROFILE_HEADING = "## Execution Profile";
|
|
111
|
-
var SESSION_DEFAULT = "session default";
|
|
112
|
-
function defaultExecutionProfile(harnesses) {
|
|
113
|
-
return {
|
|
114
|
-
entries: harnesses.map((harness) => ({
|
|
115
|
-
harness,
|
|
116
|
-
swarmDecompose: false,
|
|
117
|
-
swarmImplement: false,
|
|
118
|
-
model: SESSION_DEFAULT,
|
|
119
|
-
effort: SESSION_DEFAULT
|
|
120
|
-
}))
|
|
121
|
-
};
|
|
122
|
-
}
|
|
123
|
-
function yn(value) {
|
|
124
|
-
return value ? "yes" : "no";
|
|
125
|
-
}
|
|
126
|
-
function hasExecutionProfile(content) {
|
|
127
|
-
return content.includes(EXECUTION_PROFILE_OPEN);
|
|
128
|
-
}
|
|
129
|
-
function renderExecutionProfileSection(profile) {
|
|
130
|
-
const lines = [EXECUTION_PROFILE_HEADING, "", EXECUTION_PROFILE_OPEN];
|
|
131
|
-
for (const e of profile.entries) {
|
|
132
|
-
lines.push(
|
|
133
|
-
`- ${e.harness}: Swarms: decompose ${yn(e.swarmDecompose)} \xB7 implement ${yn(e.swarmImplement)} \xB7 model ${e.model} \xB7 effort ${e.effort}`
|
|
134
|
-
);
|
|
135
|
-
}
|
|
136
|
-
lines.push(EXECUTION_PROFILE_CLOSE);
|
|
137
|
-
return lines.join("\n");
|
|
138
|
-
}
|
|
139
|
-
function ensureExecutionProfileSection(existing, profile) {
|
|
140
|
-
if (!profile || hasExecutionProfile(existing)) return existing;
|
|
141
|
-
return existing.trimEnd() + "\n\n" + renderExecutionProfileSection(profile) + "\n";
|
|
142
|
-
}
|
|
143
|
-
function ask(question) {
|
|
144
|
-
return new Promise((resolve) => {
|
|
145
|
-
const input = process.stdin;
|
|
146
|
-
if (input.readableEnded === true || input.destroyed === true) {
|
|
147
|
-
resolve("");
|
|
148
|
-
return;
|
|
149
|
-
}
|
|
150
|
-
const rl = createInterface({ input, output: process.stdout });
|
|
151
|
-
let settled = false;
|
|
152
|
-
const done = (value) => {
|
|
153
|
-
if (settled) return;
|
|
154
|
-
settled = true;
|
|
155
|
-
rl.close();
|
|
156
|
-
resolve(value);
|
|
157
|
-
};
|
|
158
|
-
rl.once("close", () => done(""));
|
|
159
|
-
try {
|
|
160
|
-
rl.question(question, (answer) => done(answer.trim()));
|
|
161
|
-
} catch {
|
|
162
|
-
done("");
|
|
163
|
-
}
|
|
164
|
-
});
|
|
165
|
-
}
|
|
166
|
-
async function askYesNo(question) {
|
|
167
|
-
for (let attempt = 0; attempt < 5; attempt++) {
|
|
168
|
-
const answer = (await ask(`${question} [y/N]: `)).toLowerCase();
|
|
169
|
-
if (answer === "" || answer === "n" || answer === "no") return false;
|
|
170
|
-
if (answer === "y" || answer === "yes") return true;
|
|
171
|
-
console.log("Please answer 'y' or 'n'.");
|
|
172
|
-
}
|
|
173
|
-
return false;
|
|
174
|
-
}
|
|
175
|
-
async function promptExecutionProfileInteractive(harnesses) {
|
|
176
|
-
console.log("\nExecution profile \u2014 how should agents run on this project?");
|
|
177
|
-
console.log(" (Recorded in AGENTS.md as data. Press Enter to accept the default.)");
|
|
178
|
-
const entries = [];
|
|
179
|
-
for (const harness of harnesses) {
|
|
180
|
-
console.log(`
|
|
181
|
-
${harness}:`);
|
|
182
|
-
const swarmDecompose = await askYesNo(" Use swarms for decompose?");
|
|
183
|
-
const swarmImplement = await askYesNo(" Use swarms for implement?");
|
|
184
|
-
const model = await ask(` Model (${SESSION_DEFAULT}): `) || SESSION_DEFAULT;
|
|
185
|
-
const effort = await ask(` Effort (${SESSION_DEFAULT}): `) || SESSION_DEFAULT;
|
|
186
|
-
entries.push({ harness, swarmDecompose, swarmImplement, model, effort });
|
|
187
|
-
}
|
|
188
|
-
return { entries };
|
|
189
|
-
}
|
|
190
|
-
async function resolveExecutionProfile(harnesses, interactive) {
|
|
191
|
-
if (harnesses.length === 0) return { entries: [] };
|
|
192
|
-
if (interactive) return promptExecutionProfileInteractive(harnesses);
|
|
193
|
-
return defaultExecutionProfile(harnesses);
|
|
194
|
-
}
|
|
195
|
-
|
|
196
|
-
// src/gitattributes.ts
|
|
197
|
-
import { existsSync, readFileSync, writeFileSync } from "fs";
|
|
198
|
-
import { join as join2 } from "path";
|
|
199
|
-
var GITATTRIBUTES_COMMENT = "# Joycraft: collapse generated workflow docs in PR review (expand with one click)";
|
|
200
|
-
var GITATTRIBUTES_ENTRIES = [
|
|
201
|
-
"docs/features/** linguist-generated=true",
|
|
202
|
-
"docs/bugfixes/** linguist-generated=true",
|
|
203
|
-
"docs/discoveries/** linguist-generated=true",
|
|
204
|
-
"docs/templates/** linguist-generated=true"
|
|
205
|
-
];
|
|
206
|
-
function applyGitattributes(targetDir) {
|
|
207
|
-
const gitattributesPath = join2(targetDir, ".gitattributes");
|
|
208
|
-
const current = existsSync(gitattributesPath) ? readFileSync(gitattributesPath, "utf-8") : "";
|
|
209
|
-
const present = new Set(current.split("\n").map((l) => l.trim()));
|
|
210
|
-
const missing = GITATTRIBUTES_ENTRIES.filter((e) => !present.has(e.trim()));
|
|
211
|
-
if (missing.length === 0) return [];
|
|
212
|
-
const lines = present.has(GITATTRIBUTES_COMMENT) ? missing : [GITATTRIBUTES_COMMENT, ...missing];
|
|
213
|
-
const sep = current.length > 0 && !current.endsWith("\n") ? "\n" : "";
|
|
214
|
-
writeFileSync(gitattributesPath, current + sep + lines.join("\n") + "\n", "utf-8");
|
|
215
|
-
return missing;
|
|
216
|
-
}
|
|
217
|
-
|
|
218
|
-
// src/package-version.ts
|
|
219
|
-
import { readFileSync as readFileSync2 } from "fs";
|
|
220
|
-
import { fileURLToPath } from "url";
|
|
221
|
-
import { dirname, join as join3 } from "path";
|
|
222
|
-
var __dirname = dirname(fileURLToPath(import.meta.url));
|
|
223
|
-
function getPackageVersion() {
|
|
224
|
-
const pkgPath = join3(__dirname, "..", "package.json");
|
|
225
|
-
const raw = readFileSync2(pkgPath, "utf-8");
|
|
226
|
-
const pkg = JSON.parse(raw);
|
|
227
|
-
if (typeof pkg.version !== "string" || pkg.version.length === 0) {
|
|
228
|
-
throw new Error(`Joycraft package.json at ${pkgPath} is missing a version field`);
|
|
229
|
-
}
|
|
230
|
-
return pkg.version;
|
|
231
|
-
}
|
|
232
|
-
|
|
233
|
-
export {
|
|
234
|
-
renderFolderMap,
|
|
235
|
-
ensureFolderMapSection,
|
|
236
|
-
defaultExecutionProfile,
|
|
237
|
-
renderExecutionProfileSection,
|
|
238
|
-
ensureExecutionProfileSection,
|
|
239
|
-
resolveExecutionProfile,
|
|
240
|
-
applyGitattributes,
|
|
241
|
-
getPackageVersion
|
|
242
|
-
};
|
|
243
|
-
//# sourceMappingURL=chunk-Q2ZQ6RGD.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/folder-map.ts","../src/execution-profile.ts","../src/gitattributes.ts","../src/package-version.ts"],"sourcesContent":["// Check-shaped folder map (D6).\n//\n// The generated architecture section is derived from the real filesystem\n// instead of a hand-maintained tree: a pure walk emits top-level folders (plus\n// key subfolders) with one-line descriptions inside sentinel markers, so init\n// and upgrade can regenerate structure while preserving human wording, and\n// tune can diff the doc against the tree and report drift instead of letting a\n// stale map mislead an agent.\n\nimport { readdirSync } from 'node:fs';\nimport { join } from 'node:path';\n\nexport const FOLDER_MAP_OPEN = '<!-- joycraft:folder-map -->';\nexport const FOLDER_MAP_CLOSE = '<!-- /joycraft:folder-map -->';\nexport const FOLDER_MAP_PLACEHOLDER = '_TODO: one line on what lives here_';\n\n/** Row cap — past this scale the answer is nested instruction files, not a bigger map. */\nconst MAX_ROWS = 30;\n\n/** Dirs that are dependency, build-output, VCS, or cache noise — never mapped. */\nconst SKIPPED_DIRS = new Set([\n 'node_modules', 'dist', 'build', 'out', 'coverage', 'target', 'vendor',\n '__pycache__', 'venv', '.venv', 'tmp', 'temp',\n]);\n\n/** Top-level dirs whose immediate subfolders are worth a row of their own. */\nconst KEY_PARENTS = new Set(['src', 'docs']);\n\n/** Descriptions the generator can actually know — everything else gets the placeholder. */\nconst KNOWN_DESCRIPTIONS: Record<string, string> = {\n 'src/': 'Source code',\n 'docs/': 'Documentation',\n 'tests/': 'Test suite',\n 'test/': 'Test suite',\n 'scripts/': 'Maintenance and build scripts',\n 'templates/': 'Templates',\n 'public/': 'Static assets served as-is',\n 'assets/': 'Static assets',\n 'examples/': 'Usage examples',\n 'packages/': 'Monorepo packages',\n 'apps/': 'Monorepo applications',\n 'config/': 'Configuration',\n 'docs/context/': 'Knowledge layer — operational fact-docs and reference',\n 'docs/features/': 'Per-feature briefs, designs, and atomic specs',\n 'docs/discoveries/': 'Session surprises worth remembering',\n 'docs/templates/': 'Bundled output and reference templates',\n 'docs/backlog/': 'Deferred work, one file per item',\n 'docs/research/': 'Research notes and findings',\n};\n\nfunction listDirs(dir: string): string[] {\n try {\n return readdirSync(dir, { withFileTypes: true })\n .filter((e) => e.isDirectory() && !e.name.startsWith('.') && !SKIPPED_DIRS.has(e.name))\n .map((e) => e.name)\n .sort();\n } catch {\n return [];\n }\n}\n\n/** Folder paths (POSIX, trailing slash) the map covers, deterministic for a given tree. */\nexport function walkFolders(dir: string): { folders: string[]; capped: boolean } {\n // Top-level folders first, then key subfolders — so a cap cuts depth, never breadth.\n const tops = listDirs(dir);\n const folders = tops.map((top) => `${top}/`);\n for (const top of tops) {\n if (KEY_PARENTS.has(top)) {\n for (const sub of listDirs(join(dir, top))) {\n folders.push(`${top}/${sub}/`);\n }\n }\n }\n const capped = folders.length > MAX_ROWS;\n return { folders: capped ? folders.slice(0, MAX_ROWS) : folders, capped };\n}\n\nfunction parseRows(block: string): Map<string, string> {\n const rows = new Map<string, string>();\n for (const line of block.split('\\n')) {\n const match = line.match(/^\\| `([^`]+)` \\| (.*) \\|$/);\n if (match) rows.set(match[1], match[2]);\n }\n return rows;\n}\n\n/**\n * The sentinel-delimited map block. When `existingBlock` is given, human\n * descriptions for surviving folders are preserved — the machine owns\n * structure, the human owns wording.\n */\nexport function renderFolderMap(dir: string, existingBlock?: string): string {\n const { folders, capped } = walkFolders(dir);\n const previous = existingBlock ? parseRows(existingBlock) : new Map<string, string>();\n\n const lines = [FOLDER_MAP_OPEN, '| Folder | What lives here |', '|--------|-----------------|'];\n for (const folder of folders) {\n const description = previous.get(folder) ?? KNOWN_DESCRIPTIONS[folder] ?? FOLDER_MAP_PLACEHOLDER;\n lines.push(`| \\`${folder}\\` | ${description} |`);\n }\n if (capped) {\n lines.push('', `_Capped at ${MAX_ROWS} rows — this tree is past root-map scale; use the growth path below._`);\n }\n lines.push(\n '',\n 'Past multi-team scale, replace this root map with nested per-directory instruction files (`joycraft-collaborative-setup`) — never a bigger tree.',\n FOLDER_MAP_CLOSE,\n );\n return lines.join('\\n');\n}\n\nconst BLOCK_RE = new RegExp(`${FOLDER_MAP_OPEN}[\\\\s\\\\S]*?${FOLDER_MAP_CLOSE}`);\n\n/**\n * Regenerate the map block in place (preserving human wording), or append an\n * `## Architecture` section carrying it when the document has none. A\n * hand-written architecture section without markers is user prose — untouched.\n */\nexport function ensureFolderMapSection(markdown: string, dir: string): string {\n const existingBlock = markdown.match(BLOCK_RE)?.[0];\n if (existingBlock) {\n return markdown.replace(BLOCK_RE, renderFolderMap(dir, existingBlock));\n }\n if (/^## .*architecture/im.test(markdown)) return markdown;\n return `${markdown.trimEnd()}\\n\\n## Architecture\\n\\n${renderFolderMap(dir)}\\n`;\n}\n\n/**\n * Structure-only drift between the document's map block and the real tree —\n * description wording (including unfilled placeholders) never counts as drift.\n * Null when the document carries no map block.\n */\nexport function diffFolderMap(markdown: string, dir: string): { added: string[]; removed: string[] } | null {\n const block = markdown.match(BLOCK_RE)?.[0];\n if (!block) return null;\n const documented = new Set(parseRows(block).keys());\n const actual = new Set(walkFolders(dir).folders);\n return {\n added: [...actual].filter((f) => !documented.has(f)),\n removed: [...documented].filter((f) => !actual.has(f)),\n };\n}\n","import { createInterface } from 'node:readline';\nimport type { Harness } from './harness.js';\n\n/**\n * The per-project **Execution Profile** (decision D6 of the succinct-gates\n * feature): which harness agents may fan out into swarms, and which model +\n * effort those agents should run at.\n *\n * It lives in exactly one home — a sentinel-delimited `## Execution Profile`\n * section in AGENTS.md. No state.json mirror: the profile is team-shared data\n * the human owns and hand-edits, and two homes for one fact violate ONE_HOME.\n *\n * It is **data only**. Nothing here recommends a model, ranks tiers, or routes\n * a stage to an agent — opinionated defaults stay in the backlogged\n * model-tiering feature (`docs/backlog/2026-07-20-model-tiering.md`, D7).\n * That is also why model and effort are free text: model names age faster than\n * Joycraft releases, so an enum here would be wrong within a minor version.\n */\n\n/** Opening sentinel — the only machine contract; everything inside is user-owned. */\nexport const EXECUTION_PROFILE_OPEN = '<!-- joycraft:execution-profile -->';\n/** Closing sentinel. */\nexport const EXECUTION_PROFILE_CLOSE = '<!-- /joycraft:execution-profile -->';\n\n/** The markdown heading the section is written under. */\nexport const EXECUTION_PROFILE_HEADING = '## Execution Profile';\n\n/**\n * The value written for model/effort when nobody was asked (non-interactive\n * init). Deliberately not a model name — it tells downstream skills \"use\n * whatever the session is already running\", which is the only answer that\n * can't go stale.\n */\nexport const SESSION_DEFAULT = 'session default';\n\nexport interface ExecutionProfileEntry {\n harness: Harness;\n /** Fan out to a swarm of subagents during `/joycraft-decompose`? */\n swarmDecompose: boolean;\n /** Fan out to a swarm of subagents during `/joycraft-implement`? */\n swarmImplement: boolean;\n /** Free-text model name, or SESSION_DEFAULT. Never validated against a list. */\n model: string;\n /** Free-text reasoning effort, or SESSION_DEFAULT. */\n effort: string;\n}\n\nexport interface ExecutionProfile {\n entries: ExecutionProfileEntry[];\n}\n\n/**\n * The profile written when nobody could be asked: skipping is first-class, so\n * the section is still written — with explicit \"no\" answers — rather than being\n * omitted. Downstream skills then read an explicit answer, never an absence.\n */\nexport function defaultExecutionProfile(harnesses: readonly Harness[]): ExecutionProfile {\n return {\n entries: harnesses.map((harness) => ({\n harness,\n swarmDecompose: false,\n swarmImplement: false,\n model: SESSION_DEFAULT,\n effort: SESSION_DEFAULT,\n })),\n };\n}\n\nfunction yn(value: boolean): string {\n return value ? 'yes' : 'no';\n}\n\n/** True when the document already carries a profile region (matched on the sentinel, not the heading). */\nexport function hasExecutionProfile(content: string): boolean {\n return content.includes(EXECUTION_PROFILE_OPEN);\n}\n\n/**\n * Render the section. One line per selected harness, so a single-harness\n * project never sees rows it didn't ask for.\n */\nexport function renderExecutionProfileSection(profile: ExecutionProfile): string {\n const lines: string[] = [EXECUTION_PROFILE_HEADING, '', EXECUTION_PROFILE_OPEN];\n for (const e of profile.entries) {\n lines.push(\n `- ${e.harness}: Swarms: decompose ${yn(e.swarmDecompose)} · implement ${yn(e.swarmImplement)} · model ${e.model} · effort ${e.effort}`\n );\n }\n lines.push(EXECUTION_PROFILE_CLOSE);\n return lines.join('\\n');\n}\n\n/**\n * Insert the section into an existing document when absent; return the document\n * untouched when a profile is already there. The sentinels make the region\n * opaque — a hand-edit inside them (even a malformed one) is preserved verbatim,\n * because the content is the user's data, not our schema (D7).\n */\nexport function ensureExecutionProfileSection(\n existing: string,\n profile: ExecutionProfile | undefined\n): string {\n if (!profile || hasExecutionProfile(existing)) return existing;\n return existing.trimEnd() + '\\n\\n' + renderExecutionProfileSection(profile) + '\\n';\n}\n\n/**\n * Ask one question, following the one-interface-per-prompt idiom the rest of\n * the CLI uses (`harness.ts`, `gitignore.ts`): open readline, ask, close.\n *\n * EOF matters more here than for those one-shot prompts, because this\n * interview asks several questions in a row: a stdin that runs out mid-way\n * (piped input, a redirect, Ctrl-D) must degrade every remaining question to\n * its stated default rather than hang or throw. Configuration questions never\n * abort an init.\n */\nfunction ask(question: string): Promise<string> {\n return new Promise((resolve) => {\n const input = process.stdin;\n // A stream that already ended emits no further 'close' on a *new* readline\n // interface, so the close-guard below never fires and the question hangs\n // forever. Detect the spent stream up front instead: this is the path a\n // short piped answer list takes once it runs out, and every remaining\n // question must degrade to its default rather than block the init.\n if (input.readableEnded === true || input.destroyed === true) {\n resolve('');\n return;\n }\n const rl = createInterface({ input, output: process.stdout });\n let settled = false;\n const done = (value: string): void => {\n if (settled) return;\n settled = true;\n rl.close();\n resolve(value);\n };\n rl.once('close', () => done(''));\n try {\n rl.question(question, (answer) => done(answer.trim()));\n } catch {\n done('');\n }\n });\n}\n\nasync function askYesNo(question: string): Promise<boolean> {\n for (let attempt = 0; attempt < 5; attempt++) {\n const answer = (await ask(`${question} [y/N]: `)).toLowerCase();\n if (answer === '' || answer === 'n' || answer === 'no') return false;\n if (answer === 'y' || answer === 'yes') return true;\n console.log(\"Please answer 'y' or 'n'.\");\n }\n // Repeated unparseable input (or a closed stream): take the default rather\n // than looping forever.\n return false;\n}\n\n/**\n * Interactive capture, one small block per selected harness. Follows the\n * harness-selection idiom in `harness.ts`: same readline interface, empty\n * answer means the stated default, unrecognized input re-asks.\n */\nasync function promptExecutionProfileInteractive(\n harnesses: readonly Harness[]\n): Promise<ExecutionProfile> {\n console.log('\\nExecution profile — how should agents run on this project?');\n console.log(' (Recorded in AGENTS.md as data. Press Enter to accept the default.)');\n const entries: ExecutionProfileEntry[] = [];\n for (const harness of harnesses) {\n console.log(`\\n ${harness}:`);\n const swarmDecompose = await askYesNo(' Use swarms for decompose?');\n const swarmImplement = await askYesNo(' Use swarms for implement?');\n const model = (await ask(` Model (${SESSION_DEFAULT}): `)) || SESSION_DEFAULT;\n const effort = (await ask(` Effort (${SESSION_DEFAULT}): `)) || SESSION_DEFAULT;\n entries.push({ harness, swarmDecompose, swarmImplement, model, effort });\n }\n return { entries };\n}\n\n/**\n * Resolve the profile for an init run:\n * - interactive (TTY): ask per selected harness\n * - non-interactive: the explicit-no default — never blocks a scripted run\n */\nexport async function resolveExecutionProfile(\n harnesses: readonly Harness[],\n interactive: boolean\n): Promise<ExecutionProfile> {\n if (harnesses.length === 0) return { entries: [] };\n if (interactive) return promptExecutionProfileInteractive(harnesses);\n return defaultExecutionProfile(harnesses);\n}\n","import { existsSync, readFileSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\n/**\n * Paths Joycraft marks `linguist-generated=true` so GitHub collapses them in\n * PR review and drops them from diff stats. These are workflow exhaust —\n * briefs, specs, discoveries, installed templates — historical artifacts by\n * the time a PR is opened (the spec was reviewed conversationally when it was\n * written). Reviewers can still expand any of them with one click.\n *\n * Deliberately NOT listed (durable knowledge that deserves review eyes):\n * CLAUDE.md, AGENTS.md, docs/context/ (steers every future agent run), and\n * docs/backlog/ (human-authored idea capture).\n */\nexport const GITATTRIBUTES_COMMENT =\n '# Joycraft: collapse generated workflow docs in PR review (expand with one click)';\n\nexport const GITATTRIBUTES_ENTRIES = [\n 'docs/features/** linguist-generated=true',\n 'docs/bugfixes/** linguist-generated=true',\n 'docs/discoveries/** linguist-generated=true',\n 'docs/templates/** linguist-generated=true',\n];\n\n/**\n * Append-only, create-if-absent, idempotent .gitattributes writer — the same\n * contract as ensureGitignoreEntries: never rewrites, reorders, or removes\n * existing lines; only appends entries not already present (matched exactly,\n * after trimming). The comment header is only added when at least one entry\n * is missing, so a fully-applied file is never touched. Returns the entries\n * actually added (empty when everything was already present).\n */\nexport function applyGitattributes(targetDir: string): string[] {\n const gitattributesPath = join(targetDir, '.gitattributes');\n const current = existsSync(gitattributesPath) ? readFileSync(gitattributesPath, 'utf-8') : '';\n const present = new Set(current.split('\\n').map((l) => l.trim()));\n const missing = GITATTRIBUTES_ENTRIES.filter((e) => !present.has(e.trim()));\n if (missing.length === 0) return [];\n\n const lines = present.has(GITATTRIBUTES_COMMENT) ? missing : [GITATTRIBUTES_COMMENT, ...missing];\n const sep = current.length > 0 && !current.endsWith('\\n') ? '\\n' : '';\n writeFileSync(gitattributesPath, current + sep + lines.join('\\n') + '\\n', 'utf-8');\n return missing;\n}\n","import { readFileSync } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\nimport { dirname, join } from 'node:path';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nexport function getPackageVersion(): string {\n const pkgPath = join(__dirname, '..', 'package.json');\n const raw = readFileSync(pkgPath, 'utf-8');\n const pkg = JSON.parse(raw) as { version?: unknown };\n if (typeof pkg.version !== 'string' || pkg.version.length === 0) {\n throw new Error(`Joycraft package.json at ${pkgPath} is missing a version field`);\n }\n return pkg.version;\n}\n"],"mappings":"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","names":["join","readFileSync","join"]}
|