javi-forge 0.1.0 → 1.1.0

package/dist/ui/Plugin.js

@@ -0,0 +1,96 @@
+import React, { useState, useEffect } from 'react';
+import { Box, Text } from 'ink';
+import Spinner from 'ink-spinner';
+import { runPluginAdd, runPluginRemove, runPluginList, runPluginSearch, runPluginValidate } from '../commands/plugin.js';
+import { theme } from './theme.js';
+const STATUS_ICON = {
+    pending: '\u25cb',
+    done: '\u2713',
+    error: '\u2717',
+    skipped: '\u2013',
+};
+const STATUS_COLOR = {
+    pending: theme.muted,
+    running: theme.warning,
+    done: theme.success,
+    error: theme.error,
+    skipped: theme.muted,
+};
+export default function Plugin({ action, target, dryRun }) {
+    const [steps, setSteps] = useState([]);
+    const [done, setDone] = useState(false);
+    const onStep = (step) => {
+        setSteps(prev => {
+            const idx = prev.findIndex(s => s.id === step.id);
+            if (idx >= 0) {
+                const next = [...prev];
+                next[idx] = step;
+                return next;
+            }
+            return [...prev, step];
+        });
+    };
+    useEffect(() => {
+        const run = async () => {
+            try {
+                switch (action) {
+                    case 'add':
+                        if (!target) {
+                            onStep({ id: 'err', label: 'Error', status: 'error', detail: 'source required: javi-forge plugin add <org/repo>' });
+                            break;
+                        }
+                        await runPluginAdd(target, dryRun, onStep);
+                        break;
+                    case 'remove':
+                        if (!target) {
+                            onStep({ id: 'err', label: 'Error', status: 'error', detail: 'name required: javi-forge plugin remove <name>' });
+                            break;
+                        }
+                        await runPluginRemove(target, dryRun, onStep);
+                        break;
+                    case 'list':
+                        await runPluginList(onStep);
+                        break;
+                    case 'search':
+                        await runPluginSearch(target, onStep);
+                        break;
+                    case 'validate':
+                        if (!target) {
+                            onStep({ id: 'err', label: 'Error', status: 'error', detail: 'path required: javi-forge plugin validate <dir>' });
+                            break;
+                        }
+                        await runPluginValidate(target, onStep);
+                        break;
+                }
+            }
+            catch (e) {
+                onStep({ id: 'fatal', label: 'Fatal error', status: 'error', detail: String(e) });
+            }
+            setDone(true);
+        };
+        run();
+    }, [action, target, dryRun]);
+    return (React.createElement(Box, { flexDirection: "column", padding: 1 },
+        React.createElement(Box, { marginBottom: 1 },
+            React.createElement(Text, { bold: true, color: theme.primary }, "javi-forge"),
+            React.createElement(Text, null,
+                " plugin ",
+                action),
+            dryRun && React.createElement(Text, { color: theme.warning }, " (dry-run)")),
+        steps.map(step => (React.createElement(Box, { key: step.id, marginLeft: 2 }, step.status === 'running' ? (React.createElement(Text, { color: theme.warning },
+            React.createElement(Spinner, { type: "dots" }),
+            ' ',
+            step.label,
+            step.detail ? React.createElement(Text, { color: theme.muted, dimColor: true },
+                "  ",
+                step.detail) : null)) : (React.createElement(Text, { color: STATUS_COLOR[step.status] },
+            STATUS_ICON[step.status],
+            " ",
+            step.label,
+            step.detail ? React.createElement(Text, { color: theme.muted, dimColor: true },
+                "  ",
+                step.detail) : null))))),
+        done && (React.createElement(Box, { marginTop: 1 },
+            React.createElement(Text, { color: theme.muted }, "Done.")))));
+}
+//# sourceMappingURL=Plugin.js.map

package/lib/common.sh

@@ -0,0 +1,183 @@
+#!/bin/bash
+# =============================================================================
+# lib/common.sh - Shared functions for project-starter-framework
+# =============================================================================
+# Source from scripts:   source "$(dirname "$0")/../lib/common.sh"
+# Source from ci-local:  source "$(dirname "$0")/../lib/common.sh"
+# Source from hooks:     source "$(dirname "$0")/../../lib/common.sh"
+# =============================================================================
+
+# Guard against double-sourcing
+if [[ -n "${_COMMON_SH_LOADED:-}" ]]; then
+    return 0 2>/dev/null || true
+fi
+_COMMON_SH_LOADED=1
+
+# =============================================================================
+# Colors (exported for callers via source)
+# =============================================================================
+# shellcheck disable=SC2034
+RED='\033[0;31m'
+# shellcheck disable=SC2034
+GREEN='\033[0;32m'
+# shellcheck disable=SC2034
+YELLOW='\033[1;33m'
+# shellcheck disable=SC2034
+CYAN='\033[0;36m'
+# shellcheck disable=SC2034
+BLUE='\033[0;34m'
+# shellcheck disable=SC2034
+NC='\033[0m'
+
+# =============================================================================
+# Shared logging helpers
+# =============================================================================
+log_ok()   { echo -e "  ${GREEN}[OK]${NC}   $1"; }
+log_warn() { echo -e "  ${YELLOW}[WARN]${NC} $1"; }
+log_fail() { echo -e "  ${RED}[FAIL]${NC} $1"; }
+log_info() { echo -e "  ${CYAN}[INFO]${NC} $1"; }
+log_step() { echo -e "${YELLOW}$1${NC}"; }
+
+# =============================================================================
+# sed_inplace - Portable sed -i (works on both GNU and BSD/macOS sed)
+# =============================================================================
+# Usage: sed_inplace "s/foo/bar/" file.txt
+# =============================================================================
+sed_inplace() {
+    if sed --version 2>/dev/null | grep -q GNU; then
+        sed -i "$@"
+    else
+        sed -i '' "$@"
+    fi
+}
+
+# =============================================================================
+# escape_sed - Escape special characters for safe use in sed replacement
+# =============================================================================
+# Usage: escaped=$(escape_sed "$raw_string")
+# Note: This escapes replacement-side characters (backslash, ampersand, slash).
+# =============================================================================
+escape_sed() {
+    printf '%s\n' "$1" | sed -e 's/[\\&/]/\\&/g'
+}
+
+# =============================================================================
+# backup_if_exists - Create a .bak copy of a file before overwriting
+# =============================================================================
+# Usage: backup_if_exists "path/to/file"
+# =============================================================================
+backup_if_exists() {
+    local file="$1"
+    if [[ -f "$file" ]]; then
+        cp "$file" "${file}.bak"
+        echo -e "${YELLOW}  Backed up existing ${file}${NC}"
+    fi
+}
+
+# =============================================================================
+# detect_stack - Auto-detect project technology stack
+# =============================================================================
+# Sets: STACK_TYPE, BUILD_TOOL, JAVA_VERSION
+# Detects: java-gradle, java-maven, node, python, go, rust
+#
+# Usage:
+#   detect_stack                  # Detects from current directory
+#   detect_stack "/path/to/project"  # Detects from given directory
+#
+# NOTE: Does NOT set LINT_CMD/COMPILE_CMD/TEST_CMD. Those are CI-specific
+#       and should be configured by the caller (e.g., ci-local.sh).
+# =============================================================================
+# shellcheck disable=SC2034  # STACK_TYPE, BUILD_TOOL, JAVA_VERSION used by callers
+detect_stack() {
+    local project_dir="${1:-.}"
+
+    STACK_TYPE="unknown"
+    BUILD_TOOL=""
+    JAVA_VERSION="21"
+
+    # Java + Gradle
+    if [[ -f "$project_dir/build.gradle" || -f "$project_dir/build.gradle.kts" ]]; then
+        STACK_TYPE="java-gradle"
+        BUILD_TOOL="gradle"
+
+        # Detect Java version from build files (compatible with macOS and Linux)
+        if [[ -f "$project_dir/build.gradle.kts" ]]; then
+            JAVA_VERSION=$(grep -E 'languageVersion\s*=\s*JavaLanguageVersion\.of\(' "$project_dir/build.gradle.kts" 2>/dev/null | grep -o '[0-9]\+' | head -1 || echo "21")
+        elif [[ -f "$project_dir/build.gradle" ]]; then
+            JAVA_VERSION=$(grep -E 'sourceCompatibility\s*=' "$project_dir/build.gradle" 2>/dev/null | grep -o '[0-9]\+' | head -1 || echo "21")
+        fi
+        [[ -z "$JAVA_VERSION" ]] && JAVA_VERSION="21"
+        return
+    fi
+
+    # Java + Maven
+    if [[ -f "$project_dir/pom.xml" ]]; then
+        STACK_TYPE="java-maven"
+        BUILD_TOOL="maven"
+        return
+    fi
+
+    # Node.js
+    if [[ -f "$project_dir/package.json" ]]; then
+        STACK_TYPE="node"
+        if [[ -f "$project_dir/pnpm-lock.yaml" ]]; then
+            BUILD_TOOL="pnpm"
+        elif [[ -f "$project_dir/yarn.lock" ]]; then
+            BUILD_TOOL="yarn"
+        else
+            BUILD_TOOL="npm"
+        fi
+        return
+    fi
+
+    # Python (detection order: uv > poetry > pipenv > pip)
+    if [[ -f "$project_dir/pyproject.toml" || -f "$project_dir/setup.py" || -f "$project_dir/requirements.txt" ]]; then
+        STACK_TYPE="python"
+        if [[ -f "$project_dir/uv.lock" ]]; then
+            BUILD_TOOL="uv"
+        elif [[ -f "$project_dir/poetry.lock" ]]; then
+            BUILD_TOOL="poetry"
+        elif [[ -f "$project_dir/Pipfile" ]]; then
+            BUILD_TOOL="pipenv"
+        else
+            BUILD_TOOL="pip"
+        fi
+        return
+    fi
+
+    # Go
+    if [[ -f "$project_dir/go.mod" ]]; then
+        STACK_TYPE="go"
+        BUILD_TOOL="go"
+        return
+    fi
+
+    # Rust
+    if [[ -f "$project_dir/Cargo.toml" ]]; then
+        STACK_TYPE="rust"
+        BUILD_TOOL="cargo"
+        return
+    fi
+}
+
+# =============================================================================
+# detect_framework - Locate the project-starter-framework directory
+# =============================================================================
+# Sets: FRAMEWORK_DIR (path to framework root, or empty string)
+#       HAS_OPTIONAL  (true/false if optional/ dir exists)
+#
+# Usage: detect_framework
+# =============================================================================
+# shellcheck disable=SC2034  # FRAMEWORK_DIR, HAS_OPTIONAL used by callers
+detect_framework() {
+    FRAMEWORK_DIR=""
+    HAS_OPTIONAL=false
+    if [[ -d "templates" && -d ".ai-config" ]]; then
+        FRAMEWORK_DIR="."
+    elif [[ -d "../templates" && -d "../.ai-config" ]]; then
+        FRAMEWORK_DIR=".."
+    fi
+    if [[ -n "$FRAMEWORK_DIR" && -d "$FRAMEWORK_DIR/optional" ]]; then
+        HAS_OPTIONAL=true
+    fi
+}

package/modules/obsidian-brain/README.md

@@ -266,3 +266,35 @@ Si ya usas vibekanban:
 3. Agregar frontmatter YAML a archivos existentes (CONTEXT, DECISIONS, etc.)
 4. Agregar inline fields Dataview a ADRs y blockers existentes
 5. Actualizar `.gitignore` con el snippet de Obsidian
+
+## Role-Based Templates
+
+Obsidian Brain includes role-based templates organized by persona, sourced from vault/Javi.Dots:
+
+### Core Templates (`core/templates/`)
+| Template | Purpose |
+|----------|---------|
+| `daily-note.md` | Daily focus, notes, reflections |
+| `braindump.md` | Quick unstructured idea capture |
+| `consolidation.md` | Weekly knowledge consolidation |
+| `resource-capture.md` | Annotated resource bookmarking |
+
+### Developer Templates (`developer/templates/`)
+| Template | Purpose |
+|----------|---------|
+| `coding-session.md` | Goal, work log, blockers, decisions, next steps |
+| `adr.md` | Architecture Decision Record with decision map |
+| `debug-journal.md` | Structured debugging sessions |
+| `sdd-feedback.md` | Spec-Driven Development feedback |
+| `tech-debt.md` | Technical debt tracking |
+
+### PM/Lead Templates (`pm-lead/templates/`)
+| Template | Purpose |
+|----------|---------|
+| `daily-brief.md` | Daily standup summary |
+| `weekly-brief.md` | Weekly progress report |
+| `sprint-review.md` | Sprint retrospective |
+| `meeting-notes.md` | Structured meeting notes |
+| `risk-registry.md` | Risk tracking and mitigation |
+| `stakeholder-update.md` | Stakeholder communication |
+| `team-intelligence.md` | Team performance patterns |

package/modules/obsidian-brain/core/templates/braindump.md

@@ -0,0 +1,15 @@
+---
+title:
+date: "{{date}} {{time}}"
+tags:
+  - braindump
+  - inbox
+---
+
+## Thought
+
+## Context
+
+## Related Notes
+
+- 

package/modules/obsidian-brain/core/templates/consolidation.md

@@ -0,0 +1,42 @@
+---
+title:
+date: "{{date}}"
+tags:
+  - consolidation
+  - weekly
+---
+
+## Period
+
+## Top Insights
+
+- 
+
+## Connections Made
+
+- 
+
+## Open Questions
+
+- 
+
+## Action Items
+
+- [ ] 
+
+## Mind Map
+
+```markmap
+# Weekly Insights
+
+## Theme A
+- [[entity-1]]
+- [[entity-2]]
+
+## Theme B
+- [[entity-3]]
+- [[entity-4]]
+
+## Connections
+- [[entity-1]] ↔ [[entity-3]]
+```

package/modules/obsidian-brain/core/templates/daily-note.md

@@ -0,0 +1,18 @@
+---
+title:
+date: "{{date}}"
+tags:
+  - daily
+---
+
+## Today's Focus
+
+- 
+
+## Notes
+
+## Reflections
+
+## Tomorrow
+
+- [ ] 

package/modules/obsidian-brain/core/templates/resource-capture.md

@@ -0,0 +1,14 @@
+---
+title:
+date: "{{date}} {{time}}"
+tags:
+  - resource
+---
+
+## Source
+
+## Summary
+
+## Key Takeaways
+
+- 

package/modules/obsidian-brain/developer/templates/adr.md

@@ -0,0 +1,40 @@
+---
+title:
+date: "{{date}}"
+tags:
+  - adr
+  - architecture
+status:
+---
+
+## Context
+
+## Decision
+
+## Consequences
+
+- 
+
+## Alternatives Considered
+
+| Alternative | Pros | Cons |
+|-------------|------|------|
+|             |      |      |
+
+## Decision Map
+
+```markmap
+# Decision Title
+
+## Option A
+### Pros
+- Low complexity
+### Cons
+- Limited scalability
+
+## Option B
+### Pros
+- Future-proof
+### Cons
+- Higher effort
+```

package/modules/obsidian-brain/developer/templates/coding-session.md

@@ -0,0 +1,24 @@
+---
+title:
+date: "{{date}} {{time}}"
+tags:
+  - coding-session
+---
+
+## Goal
+
+## What I Did
+
+- 
+
+## Blockers
+
+- 
+
+## Decisions Made
+
+- 
+
+## Next Steps
+
+- [ ] 

package/modules/obsidian-brain/developer/templates/debug-journal.md

@@ -0,0 +1,22 @@
+---
+title:
+date: "{{date}} {{time}}"
+tags:
+  - debug
+---
+
+## Symptom
+
+## Hypothesis
+
+- 
+
+## Investigation
+
+## Root Cause
+
+## Fix
+
+## Lessons Learned
+
+- 

package/modules/obsidian-brain/developer/templates/sdd-feedback.md

@@ -0,0 +1,27 @@
+---
+title:
+date: "{{date}}"
+tags:
+  - sdd
+  - feedback
+---
+
+## Change Name
+
+## Phase Completed
+
+## What Worked
+
+- 
+
+## What Didn't
+
+- 
+
+## Improvements
+
+- 
+
+## Link to Engram
+
+<!-- Optional: engram:// link -->

package/modules/obsidian-brain/developer/templates/tech-debt.md

@@ -0,0 +1,20 @@
+---
+title:
+date: "{{date}}"
+tags:
+  - tech-debt
+---
+
+## Area
+
+## Description
+
+## Impact
+
+## Effort Estimate
+
+## Priority
+
+## Plan
+
+- [ ] 

package/modules/obsidian-brain/pm-lead/templates/daily-brief.md

@@ -0,0 +1,25 @@
+---
+title:
+date: "{{date}}"
+tags:
+  - brief
+  - daily
+---
+
+## Top 3 Priorities
+
+1. 
+2. 
+3. 
+
+## Blockers
+
+- 
+
+## Key Decisions Needed
+
+- 
+
+## FYI
+
+- 

package/modules/obsidian-brain/pm-lead/templates/meeting-notes.md

@@ -0,0 +1,24 @@
+---
+title:
+date: "{{date}} {{time}}"
+tags:
+  - meeting
+---
+
+## Attendees
+
+- 
+
+## Agenda
+
+1. 
+
+## Discussion
+
+## Decisions
+
+- 
+
+## Action Items
+
+- [ ] 

package/modules/obsidian-brain/pm-lead/templates/risk-registry.md

@@ -0,0 +1,12 @@
+---
+title:
+date: "{{date}}"
+tags:
+  - risk
+---
+
+## Risk Registry
+
+| ID | Description | Likelihood | Impact | Mitigation | Owner | Status |
+|----|-------------|------------|--------|------------|-------|--------|
+|    |             |            |        |            |       |        |

package/modules/obsidian-brain/pm-lead/templates/sprint-review.md

@@ -0,0 +1,27 @@
+---
+title:
+date: "{{date}}"
+tags:
+  - sprint
+  - review
+---
+
+## Sprint Goal
+
+## Completed
+
+- 
+
+## Not Completed
+
+- 
+
+## Metrics
+
+| Metric | Value |
+|--------|-------|
+|        |       |
+
+## Retrospective Notes
+
+- 

package/modules/obsidian-brain/pm-lead/templates/stakeholder-update.md

@@ -0,0 +1,24 @@
+---
+title:
+date: "{{date}}"
+tags:
+  - stakeholder
+  - update
+---
+
+## Summary
+
+## Progress
+
+- 
+
+## Risks
+
+- 
+
+## Next Steps
+
+- 
+
+## Ask
+

package/modules/obsidian-brain/pm-lead/templates/team-intelligence.md

@@ -0,0 +1,19 @@
+---
+title:
+date: "{{date}}"
+tags:
+  - team
+  - intelligence
+---
+
+## Observation
+
+## Context
+
+## Pattern
+
+## Recommendation
+
+## Shared With
+
+-