@booklib/core 2.0.0

package/lib/paths.js

@@ -0,0 +1,57 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { fileURLToPath } from 'url';
+
+const PACKAGE_ROOT = path.resolve(fileURLToPath(import.meta.url), '..', '..');
+
+/**
+ * Resolves the three-tier path hierarchy for BookLib:
+ *   1. Project-local  — <cwd>/.booklib/
+ *   2. Global user    — ~/.booklib/
+ *   3. Package install — <npm package root>/.booklib/
+ *
+ * Returns the highest-priority paths that exist, falling back to
+ * project-local as the write target when nothing exists yet.
+ */
+export function resolveBookLibPaths(projectCwd = process.cwd()) {
+  const projectLocal  = path.join(projectCwd, '.booklib');
+  const globalUser    = path.join(os.homedir(), '.booklib');
+  const packageBuiltin = path.join(PACKAGE_ROOT, '.booklib');
+
+  // Index: use the first location that already has an index
+  const indexCandidates = [
+    path.join(projectLocal, 'index'),
+    path.join(globalUser, 'index'),
+    path.join(packageBuiltin, 'index'),
+  ];
+  const existingIndex = indexCandidates.find(p => fs.existsSync(p));
+  const indexPath = existingIndex ?? indexCandidates[0]; // default write target = project-local
+
+  // Skills: use the first location that contains .md files
+  const skillsCandidates = [
+    path.join(projectCwd, 'skills'),
+    path.join(globalUser, 'skills'),
+    path.join(PACKAGE_ROOT, 'skills'),
+  ];
+  const existingSkills = skillsCandidates.find(p => {
+    if (!fs.existsSync(p)) return false;
+    try { return fs.readdirSync(p).length > 0; } catch { return false; }
+  });
+  const skillsPath = existingSkills ?? skillsCandidates[2]; // default = package bundled
+
+  // Sessions: always project-local
+  const sessionsPath = path.join(projectLocal, 'sessions');
+
+  // Cache: always global user dir (downloaded skills land here)
+  const cachePath = globalUser;
+
+  // Config: project-local first, then global
+  const configCandidates = [
+    path.join(projectCwd, 'booklib.config.json'),
+    path.join(globalUser, 'booklib.config.json'),
+  ];
+  const configPath = configCandidates.find(p => fs.existsSync(p)) ?? configCandidates[0];
+
+  return { indexPath, skillsPath, sessionsPath, cachePath, configPath };
+}

package/lib/profiles/design.md

@@ -0,0 +1,19 @@
+## Overview
+<!-- Describe the design project -->
+
+## Design System
+<!-- Colors, typography, spacing, component library -->
+
+## Component Patterns
+<!-- Naming, file structure, composition rules -->
+
+## Accessibility
+<!-- WCAG level, screen reader support, keyboard navigation -->
+
+## BookLib Agent Behaviors
+{{agent_behaviors}}
+
+## Active Skills
+{{skills_table}}
+
+{{references}}

package/lib/profiles/general.md

@@ -0,0 +1,16 @@
+## Overview
+<!-- Describe this project -->
+
+## Goals
+<!-- What you're trying to achieve -->
+
+## Preferences
+<!-- Working style, tools, constraints -->
+
+## BookLib Agent Behaviors
+{{agent_behaviors}}
+
+## Active Skills
+{{skills_table}}
+
+{{references}}

package/lib/profiles/research-analysis.md

@@ -0,0 +1,22 @@
+## Overview
+<!-- Describe the research project -->
+
+## Research Questions
+<!-- Key questions being investigated -->
+
+## Methodology
+<!-- Approach, tools, data sources -->
+
+## Citation Style
+<!-- APA, IEEE, informal, etc. -->
+
+## Output Format
+<!-- Reports, papers, presentations -->
+
+## BookLib Agent Behaviors
+{{agent_behaviors}}
+
+## Active Skills
+{{skills_table}}
+
+{{references}}

package/lib/profiles/software-development.md

@@ -0,0 +1,23 @@
+## Overview
+<!-- Describe what this project does -->
+
+## Stack
+{{stack}}
+
+## Conventions
+<!-- Define your naming conventions, file structure, commit message style -->
+<!-- See references below for how to customize this file -->
+
+## Architecture Decisions
+<!-- Key technical decisions and rationale -->
+
+## Testing
+<!-- How to run tests, what to test, coverage expectations -->
+
+## BookLib Agent Behaviors
+{{agent_behaviors}}
+
+## Active Skills
+{{skills_table}}
+
+{{references}}

package/lib/profiles/writing-content.md

@@ -0,0 +1,19 @@
+## Overview
+<!-- Describe the content project -->
+
+## Audience
+<!-- Who is reading this content? -->
+
+## Tone & Style
+<!-- Formal/informal, voice, terminology preferences -->
+
+## Format Preferences
+<!-- Markdown conventions, heading structure, link style -->
+
+## BookLib Agent Behaviors
+{{agent_behaviors}}
+
+## Active Skills
+{{skills_table}}
+
+{{references}}