@tonycasey/lisa 1.0.5 → 1.1.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonycasey/lisa",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "description": "Long-term memory for Claude Code. Automatic context persistence, task tracking, and knowledge capture across coding sessions.",
   "bin": {
     "remember": "cli.js",

package/dist/templates/agents/docs/EXTENDING-rules.md

@@ -0,0 +1,57 @@
+# Local Extensions
+
+This project supports local rule and skill extensions that persist across package updates.
+
+## How Local Extensions Work
+
+When loading any rule file (e.g., `git-rules.md`), **always check if a corresponding `.local.md` file exists** (e.g., `git-rules.local.md`). If it exists, apply both files with the local file taking precedence.
+
+## Extension Pattern
+
+Local files use inheritance semantics:
+
+- **Inherits**: All sections from the base file apply unless overridden
+- **Override**: A section with the same name in the local file replaces the base section
+- **Extend**: New sections in the local file add to the base rules
+
+## File Naming Convention
+
+| Base File | Local Extension |
+|-----------|-----------------|
+| `git-rules.md` | `git-rules.local.md` |
+| `coding-standards.md` | `coding-standards.local.md` |
+| `testing-principles.md` | `testing-principles.local.md` |
+
+## Local File Format
+
+Local extension files should include:
+
+1. A title indicating it's a local extension
+2. An `> Extends:` directive referencing the base file
+3. Sections that override or extend the base
+
+### Example: `git-rules.local.md`
+
+```markdown
+# Git Rules (Local Extensions)
+
+> Extends: git-rules.md
+
+## Commit Messages (Override)
+- Use format: `[JIRA-123] type: description`
+- All commits MUST reference a Jira ticket
+
+## Branch Naming (New Section)
+- Feature branches: `feature/JIRA-123-description`
+- Bugfix branches: `bugfix/JIRA-123-description`
+```
+
+## For Skills
+
+Custom skills use a `.local.md` file name suffix too:
+
+## Important
+
+- Local files are **preserved** during package updates
+- Local files are **not** created automatically - users create them manually when needed
+- Always apply local extensions when they exist

package/dist/templates/rules/shared/git-rules.local.md

@@ -0,0 +1,20 @@
+# Git Rules (Local Extensions)
+
+> Extends: git-rules.md
+
+<!--
+  This file extends the base git-rules.md with project-specific rules.
+
+  Add your custom git workflow rules here. They will be preserved
+  across package updates.
+
+  Example overrides:
+
+  ## Commit Messages (Override)
+  - Use format: `[JIRA-123] type: description`
+  - All commits MUST reference a ticket
+
+  ## Branch Naming (New Section)
+  - Feature: `feature/JIRA-123-description`
+  - Bugfix: `bugfix/JIRA-123-description`
+-->

package/dist/templates/rules/shared/git-rules.md

@@ -2,15 +2,24 @@
 
 ## Commit Memory Rule
 
-**IMPORTANT:** After every successful git commit, you MUST create a milestone memory summarizing what was committed.
+**IMPORTANT:** After every successful git commit, you MUST do TWO things:
+1. Create a milestone memory summarizing what was committed
+2. Update the task status if completing a Jira ticket
 
-### How to Create Commit Memory
+### Step 1: Create Commit Memory
 
 After a commit succeeds, run:
 ```bash
 node .agents/skills/memory/scripts/memory.js add "<summary>" --cache --type milestone
 ```
 
+### Step 2: Update Task Status (for tickets)
+
+If the commit completes ticket (JIRA-1234), also run:
+```bash
+node .agents/skills/tasks/scripts/tasks.js add "JIRA-1234: COMPLETED - <description>" --cache --status done
+```
+
 ### Summary Format
 
 The summary should be concise and describe:
@@ -20,9 +29,13 @@ The summary should be concise and describe:
 
 ### Examples
 
-**Feature commit:**
+**Feature commit (with Jira ticket):**
 ```bash
-node .agents/skills/memory/scripts/memory.js add "FEATURE: Added user authentication with JWT tokens and session management" --cache --type milestone
+# Step 1: Save milestone
+node .agents/skills/memory/scripts/memory.js add "FEATURE: [JIRA-1234] Added Excel brandlist parser with unit tests" --cache --type milestone
+
+# Step 2: Update task status
+node .agents/skills/tasks/scripts/tasks.js add "JIRA-1234: COMPLETED - Excel brandlist parser utility created, PR #XXXX" --cache --status done
 ```
 
 **Bug fix:**
@@ -38,7 +51,8 @@ node .agents/skills/memory/scripts/memory.js add "REFACTOR: Migrated API handler
 ### Why This Matters
 
 - Creates a searchable history of development progress
-- Helps future sessions understand what was accomplished
+- Keeps task status accurate across sessions
+- Helps future sessions understand what was achieved
 - Builds project context for AI assistants
 - Tracks milestones and features over time
 
@@ -62,3 +76,8 @@ node .agents/skills/memory/scripts/memory.js add "REFACTOR: Migrated API handler
 - Keep commits focused and atomic
 - Don't mix unrelated changes in one commit
 - Write meaningful commit messages
+
+
+## Pull Requests
+
+Follow generic guidelines for pull requests, ensuring all required information is provided in the description.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonycasey/lisa",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "description": "Long-term memory for Claude Code. Automatic context persistence, task tracking, and knowledge capture across coding sessions.",
   "bin": {
     "lisa": "dist/cli.js",
@@ -13,8 +13,7 @@
   },
   "files": [
     "dist",
-    "scripts/postinstall.js",
-    "assets"
+    "scripts/postinstall.js"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",

package/scripts/postinstall.js

@@ -12,6 +12,7 @@ const fs = require('fs-extra');
 const { execSync, spawn } = require('child_process');
 const readline = require('readline');
 const net = require('net');
+const { glob } = require('glob');
 
 // When installed as a dependency, the project root is four levels up from node_modules/@tonycasey/lisa/scripts
 // When running locally (development), use the current working directory
@@ -326,6 +327,67 @@ async function copyTemplates(src, dest, force = false) {
   return true;
 }
 
+/**
+ * Preserve local extensions (.local.md files and .local/ directories) before deployment.
+ * These are user-created files that should survive package updates.
+ */
+async function preserveLocalExtensions(targetDir) {
+  const preserved = { files: [], dirs: [] };
+
+  if (!(await fs.pathExists(targetDir))) {
+    return preserved;
+  }
+
+  // Find all .local.md files (rules extensions)
+  const localFiles = await glob('**/*.local.md', { cwd: targetDir, nodir: true });
+  for (const file of localFiles) {
+    const fullPath = path.join(targetDir, file);
+    const content = await fs.readFile(fullPath, 'utf8');
+    preserved.files.push({ path: file, content });
+  }
+
+  // Find all .local directories (skill extensions)
+  const localDirs = await glob('**/*.local', { cwd: targetDir, onlyDirectories: true });
+  for (const dir of localDirs) {
+    const fullPath = path.join(targetDir, dir);
+    const files = [];
+    const dirFiles = await glob('**/*', { cwd: fullPath, nodir: true });
+    for (const file of dirFiles) {
+      const filePath = path.join(fullPath, file);
+      const content = await fs.readFile(filePath, 'utf8');
+      files.push({ path: file, content });
+    }
+    preserved.dirs.push({ path: dir, files });
+  }
+
+  if (preserved.files.length > 0 || preserved.dirs.length > 0) {
+    console.log(`  Preserving ${preserved.files.length} local file(s) and ${preserved.dirs.length} local dir(s)`);
+  }
+
+  return preserved;
+}
+
+/**
+ * Restore preserved local extensions after deployment.
+ */
+async function restoreLocalExtensions(targetDir, preserved) {
+  for (const { path: filePath, content } of preserved.files) {
+    const fullPath = path.join(targetDir, filePath);
+    await fs.ensureDir(path.dirname(fullPath));
+    await fs.writeFile(fullPath, content, 'utf8');
+    console.log(`  ✓ Restored: ${filePath}`);
+  }
+
+  for (const { path: dirPath, files } of preserved.dirs) {
+    for (const { path: filePath, content } of files) {
+      const fullPath = path.join(targetDir, dirPath, filePath);
+      await fs.ensureDir(path.dirname(fullPath));
+      await fs.writeFile(fullPath, content, 'utf8');
+    }
+    console.log(`  ✓ Restored: ${dirPath}/`);
+  }
+}
+
 async function createSymlink(target, linkPath) {
   try {
     if (await fs.pathExists(linkPath)) {
@@ -641,6 +703,9 @@ async function main() {
   const agentsDir = path.join(projectRoot, '.agents');
   const claudeDir = path.join(projectRoot, '.claude');
 
+  // Preserve local extensions before copying (user-created .local.md files and .local/ directories)
+  const preservedExtensions = await preserveLocalExtensions(agentsDir);
+
   // Copy .agents templates
   const agentsSrc = path.join(templateRoot, 'agents');
   const rulesSrc = path.join(templateRoot, 'rules');
@@ -658,6 +723,9 @@ async function main() {
     console.log('  ✓ Copied .agents/rules/');
   }
 
+  // Restore local extensions after copying
+  await restoreLocalExtensions(agentsDir, preservedExtensions);
+
   // Copy .claude templates
   const claudeSrc = path.join(templateRoot, 'claude');
   if (await fs.pathExists(claudeSrc)) {