@tonycasey/lisa 1.0.6 → 1.1.1

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonycasey/lisa",
-  "version": "1.0.6",
+  "version": "1.1.1",
   "description": "Long-term memory for Claude Code. Automatic context persistence, task tracking, and knowledge capture across coding sessions.",
   "bin": {
     "remember": "cli.js",
@@ -38,6 +38,7 @@
     "commander": "^11.1.0",
     "execa": "^8.0.1",
     "fs-extra": "^11.2.0",
+    "glob": "^10.3.10",
     "yaml": "^2.4.2"
   }
 }

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.6",
+  "version": "1.1.1",
   "description": "Long-term memory for Claude Code. Automatic context persistence, task tracking, and knowledge capture across coding sessions.",
   "bin": {
     "lisa": "dist/cli.js",
@@ -55,6 +55,7 @@
     "commander": "^11.1.0",
     "execa": "^8.0.1",
     "fs-extra": "^11.2.0",
+    "glob": "^10.3.10",
     "yaml": "^2.4.2"
   },
   "devDependencies": {

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,69 @@ 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)
+  // Use trailing slash to match only directories (glob doesn't support onlyDirectories option)
+  const localDirMatches = await glob('**/*.local/', { cwd: targetDir });
+  const localDirs = localDirMatches.map(d => d.replace(/\/$/, '')); // Remove trailing slash
+  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)) {
@@ -367,17 +431,17 @@ async function copyDockerFiles(agentsDir) {
     await fs.copy(composeSrc, composeDest, { overwrite: false });
   }
 
-  // Copy .env.lisa.example to project root (if no .env exists)
-  const envSrc = path.join(dockerSrc, '.env.lisa.example');
+  // Copy .env to project root (if no .env exists)
+  const envSrc = path.join(dockerSrc, '.env');
   const rootEnv = path.join(path.dirname(agentsDir), '.env');
-  const envExampleDest = path.join(path.dirname(agentsDir), '.env.lisa.example');
+  const envExampleDest = path.join(path.dirname(agentsDir), '.env');
   if (await fs.pathExists(envSrc)) {
     // Always copy the example file for reference
     await fs.copy(envSrc, envExampleDest, { overwrite: false });
     // If no .env exists, create one from the example
     if (!(await fs.pathExists(rootEnv))) {
       await fs.copy(envSrc, rootEnv);
-      console.log('  Created .env from .env.lisa.example');
+      console.log('  Created .env from .env');
     }
   }
 
@@ -499,10 +563,10 @@ async function setupDocker(agentsDir) {
   // Check if .env exists in project root, if not copy from example
   const projectRoot = path.dirname(agentsDir);
   const envFile = path.join(projectRoot, '.env');
-  const envExample = path.join(projectRoot, '.env.lisa.example');
+  const envExample = path.join(projectRoot, '.env');
   if (!(await fs.pathExists(envFile)) && (await fs.pathExists(envExample))) {
     await fs.copy(envExample, envFile);
-    console.log('  Created .env from .env.lisa.example');
+    console.log('  Created .env from .env');
     console.log('  IMPORTANT: Edit .env and add your OPENAI_API_KEY');
   }
 
@@ -641,6 +705,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 +725,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)) {