javi-forge 1.0.0 → 1.2.0

package/dist/index.js

@@ -2,18 +2,26 @@
 import React from 'react';
 import { render } from 'ink';
 import meow from 'meow';
+import updateNotifier from 'update-notifier';
+import { createRequire } from 'module';
 import App from './ui/App.js';
 import Doctor from './ui/Doctor.js';
 import AnalyzeUI from './ui/AnalyzeUI.js';
 import Plugin from './ui/Plugin.js';
 import LlmsTxt from './ui/LlmsTxt.js';
+import CI from './ui/CI.js';
 import { CIProvider as CIContextProvider } from './ui/CIContext.js';
+// Check for updates in background (non-blocking, cached 24h)
+const _require = createRequire(import.meta.url);
+const pkg = _require('../package.json');
+updateNotifier({ pkg, updateCheckInterval: 1000 * 60 * 60 * 24 }).notify();
 const cli = meow(`
   Usage
     $ javi-forge [command] [options]
 
   Commands
     init              Bootstrap a new project (default)
+    ci                Run CI simulation (lint + compile + test + security + ghagga)
     analyze           Run repoforge skills analysis
     doctor            Show health report
     plugin add        Install a plugin from GitHub (org/repo)
@@ -35,19 +43,28 @@ const cli = meow(`
     --version       Show version
     --help          Show this help
 
+  CI options (javi-forge ci)
+    --quick         Lint + compile only (fast, for pre-commit)
+    --shell         Open interactive shell in CI container
+    --detect        Show detected stack and exit
+    --no-docker     Run commands natively (no Docker)
+    --no-ghagga     Skip GHAGGA review
+    --no-security   Skip Semgrep security scan
+    --timeout N     Per-step timeout in seconds (default: 600)
+
   Examples
     $ javi-forge
     $ javi-forge init --dry-run
     $ javi-forge init --stack node --ci github
-    $ javi-forge init --dry-run --project-name app --stack node --ci github --batch
+    $ javi-forge ci
+    $ javi-forge ci --quick
+    $ javi-forge ci --no-ghagga --no-security
+    $ javi-forge ci --no-docker
+    $ javi-forge ci --shell
     $ javi-forge analyze
-    $ javi-forge analyze --dry-run
     $ javi-forge doctor
     $ javi-forge plugin add mapbox/agent-skills
     $ javi-forge plugin list
-    $ javi-forge plugin search ai
-    $ javi-forge plugin validate ./my-plugin
-    $ javi-forge plugin remove my-plugin
 `, {
     importMeta: import.meta,
     flags: {
@@ -59,6 +76,14 @@ const cli = meow(`
         ghagga: { type: 'boolean', default: false },
         mock: { type: 'boolean', default: false },
         batch: { type: 'boolean', default: false },
+        // CI flags
+        quick: { type: 'boolean', default: false },
+        shell: { type: 'boolean', default: false },
+        detect: { type: 'boolean', default: false },
+        noDocker: { type: 'boolean', default: false },
+        noGhagga: { type: 'boolean', default: false },
+        noSecurity: { type: 'boolean', default: false },
+        timeout: { type: 'number', default: 600 },
     }
 });
 const subcommand = cli.input[0] ?? 'init';
@@ -67,6 +92,15 @@ const VALID_CI = ['github', 'gitlab', 'woodpecker'];
 const VALID_MEMORY = ['engram', 'obsidian-brain', 'memory-simple', 'none'];
 const isCI = cli.flags.batch || process.env['CI'] === '1' || process.env['CI'] === 'true';
 switch (subcommand) {
+    case 'ci': {
+        const ciMode = cli.flags.detect ? 'detect'
+            : cli.flags.shell ? 'shell'
+                : cli.flags.quick ? 'quick'
+                    : 'full';
+        render(React.createElement(CIContextProvider, { isCI: true },
+            React.createElement(CI, { projectDir: process.cwd(), mode: ciMode, noDocker: cli.flags.noDocker, noGhagga: cli.flags.noGhagga, noSecurity: cli.flags.noSecurity, timeout: cli.flags.timeout })));
+        break;
+    }
     case 'doctor': {
         render(React.createElement(CIContextProvider, { isCI: isCI },
             React.createElement(Doctor, null)));

package/dist/lib/docker.d.ts

@@ -0,0 +1,43 @@
+import type { Stack } from '../types/index.js';
+export interface DockerRunOptions {
+    /** Absolute path to mount as /home/runner/work */
+    projectDir: string;
+    /** Command to run inside the container */
+    command: string;
+    /** Timeout in seconds (default: 600) */
+    timeout?: number;
+    /** Stream output to stdout/stderr (default: true) */
+    stream?: boolean;
+}
+export interface DockerRunResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export interface DockerImageOptions {
+    stack: Stack;
+    /** Java version override (only for java-* stacks) */
+    javaVersion?: string;
+    /** Directory where Dockerfiles are stored (defaults to package-bundled dir) */
+    dockerfilesDir?: string;
+}
+export declare function getImageName(stack: Stack): string;
+export declare function getDockerfileContent(stack: Stack): string;
+export declare function isDockerAvailable(): Promise<boolean>;
+/**
+ * Ensure a CI Docker image exists and is up-to-date.
+ * Rebuilds only if the Dockerfile content has changed (hash-based staleness check).
+ * Returns the image name.
+ */
+export declare function ensureImage(options: DockerImageOptions): Promise<string>;
+/**
+ * Run a shell command inside the CI Docker container.
+ * Mounts projectDir as /home/runner/work.
+ * Streams output to process.stdout/stderr by default.
+ */
+export declare function runInContainer(options: DockerRunOptions): Promise<DockerRunResult>;
+/**
+ * Open an interactive shell inside the CI container.
+ */
+export declare function openShell(projectDir: string): Promise<void>;
+//# sourceMappingURL=docker.d.ts.map

package/dist/lib/docker.js

@@ -0,0 +1,223 @@
+import { execFile, spawn } from 'child_process';
+import { promisify } from 'util';
+import crypto from 'crypto';
+import fs from 'fs-extra';
+import path from 'path';
+const execFileAsync = promisify(execFile);
+// =============================================================================
+// Image name
+// =============================================================================
+export function getImageName(stack) {
+    return `javi-forge-ci-${stack}`;
+}
+// =============================================================================
+// Dockerfile content per stack
+// =============================================================================
+export function getDockerfileContent(stack) {
+    switch (stack) {
+        case 'java-gradle':
+        case 'java-maven':
+            return [
+                'ARG JAVA_VERSION=21',
+                'FROM eclipse-temurin:${JAVA_VERSION}-jdk-noble',
+                'RUN apt-get update && apt-get install -y git curl unzip && rm -rf /var/lib/apt/lists/*',
+                'RUN useradd -m -s /bin/bash runner',
+                'USER runner',
+                'WORKDIR /home/runner/work',
+                'ENTRYPOINT ["/bin/bash", "-c"]',
+            ].join('\n');
+        case 'node':
+            return [
+                'FROM node:22-slim',
+                'RUN apt-get update && apt-get install -y git && rm -rf /var/lib/apt/lists/*',
+                'RUN npm install -g pnpm',
+                'RUN useradd -m -s /bin/bash runner',
+                'USER runner',
+                'WORKDIR /home/runner/work',
+                'ENTRYPOINT ["/bin/bash", "-c"]',
+            ].join('\n');
+        case 'python':
+            return [
+                'FROM python:3.12-slim',
+                'RUN apt-get update && apt-get install -y git && rm -rf /var/lib/apt/lists/*',
+                'RUN pip install --no-cache-dir pytest ruff pylint poetry',
+                'RUN useradd -m -s /bin/bash runner',
+                'USER runner',
+                'WORKDIR /home/runner/work',
+                'ENTRYPOINT ["/bin/bash", "-c"]',
+            ].join('\n');
+        case 'go':
+            return [
+                'FROM golang:1.23-bookworm',
+                'RUN apt-get update && apt-get install -y git && rm -rf /var/lib/apt/lists/*',
+                'RUN go install github.com/golangci/golangci-lint/cmd/golangci-lint@v1.62.0 && mv /root/go/bin/golangci-lint /usr/local/bin/',
+                'RUN useradd -m -s /bin/bash runner',
+                'USER runner',
+                'WORKDIR /home/runner/work',
+                'ENTRYPOINT ["/bin/bash", "-c"]',
+            ].join('\n');
+        case 'rust':
+            return [
+                'FROM rust:1.83-slim',
+                'RUN apt-get update && apt-get install -y git pkg-config libssl-dev && rm -rf /var/lib/apt/lists/*',
+                'RUN rustup component add clippy rustfmt',
+                'RUN useradd -m -s /bin/bash runner',
+                'USER runner',
+                'WORKDIR /home/runner/work',
+                'ENTRYPOINT ["/bin/bash", "-c"]',
+            ].join('\n');
+        default:
+            return [
+                'FROM ubuntu:24.04',
+                'RUN apt-get update && apt-get install -y git curl && rm -rf /var/lib/apt/lists/*',
+                'RUN useradd -m -s /bin/bash runner',
+                'USER runner',
+                'WORKDIR /home/runner/work',
+                'ENTRYPOINT ["/bin/bash", "-c"]',
+            ].join('\n');
+    }
+}
+// =============================================================================
+// Docker availability
+// =============================================================================
+export async function isDockerAvailable() {
+    try {
+        await execFileAsync('docker', ['info'], { timeout: 5000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// =============================================================================
+// Image management
+// =============================================================================
+/**
+ * Ensure a CI Docker image exists and is up-to-date.
+ * Rebuilds only if the Dockerfile content has changed (hash-based staleness check).
+ * Returns the image name.
+ */
+export async function ensureImage(options) {
+    const { stack, javaVersion, dockerfilesDir } = options;
+    const imageName = getImageName(stack);
+    // Resolve Dockerfile path
+    const dockerDir = dockerfilesDir ?? path.join(path.dirname(new URL(import.meta.url).pathname), '../../ci-local/docker');
+    const dockerfilePath = path.join(dockerDir, `${stack}.Dockerfile`);
+    // Write Dockerfile if it doesn't exist yet (first run)
+    if (!await fs.pathExists(dockerfilePath)) {
+        await fs.ensureDir(dockerDir);
+        await fs.writeFile(dockerfilePath, getDockerfileContent(stack), 'utf-8');
+    }
+    // Staleness check: compare Dockerfile hash with the one embedded in the image label
+    const content = await fs.readFile(dockerfilePath, 'utf-8');
+    const currentHash = crypto.createHash('sha256').update(content).digest('hex');
+    let imageHash = '';
+    try {
+        const { stdout } = await execFileAsync('docker', [
+            'inspect', '--format', '{{index .Config.Labels "dockerfile-hash"}}', imageName,
+        ]);
+        imageHash = stdout.trim();
+    }
+    catch {
+        // Image doesn't exist yet
+    }
+    if (currentHash === imageHash) {
+        return imageName;
+    }
+    // Build image
+    const buildArgs = [
+        'build',
+        '--label', `dockerfile-hash=${currentHash}`,
+        '-f', dockerfilePath,
+        '-t', imageName,
+    ];
+    if (javaVersion && (stack === 'java-gradle' || stack === 'java-maven')) {
+        buildArgs.push('--build-arg', `JAVA_VERSION=${javaVersion}`);
+    }
+    buildArgs.push(dockerDir);
+    await new Promise((resolve, reject) => {
+        const proc = spawn('docker', buildArgs, { stdio: 'inherit' });
+        proc.on('close', code => code === 0 ? resolve() : reject(new Error(`docker build exited with code ${code}`)));
+        proc.on('error', reject);
+    });
+    return imageName;
+}
+// =============================================================================
+// Run command in container
+// =============================================================================
+/**
+ * Run a shell command inside the CI Docker container.
+ * Mounts projectDir as /home/runner/work.
+ * Streams output to process.stdout/stderr by default.
+ */
+export async function runInContainer(options) {
+    const { projectDir, command, timeout = 600, stream = true } = options;
+    const stack = await detectStackFromDir(projectDir);
+    const imageName = getImageName(stack);
+    const isInteractive = process.stdin.isTTY && stream;
+    const dockerArgs = [
+        'run', '--rm',
+        ...(isInteractive ? ['-it'] : []),
+        '--stop-timeout', '30',
+        '--entrypoint', '',
+        '-v', `${projectDir}:/home/runner/work`,
+        '-e', 'CI=true',
+        imageName,
+        'timeout', String(timeout), 'bash', '-c', command,
+    ];
+    return new Promise((resolve, reject) => {
+        const proc = spawn('docker', dockerArgs, {
+            stdio: stream ? 'inherit' : 'pipe',
+        });
+        let stdout = '';
+        let stderr = '';
+        if (!stream) {
+            proc.stdout?.on('data', (d) => { stdout += d.toString(); });
+            proc.stderr?.on('data', (d) => { stderr += d.toString(); });
+        }
+        proc.on('close', code => resolve({ exitCode: code ?? 1, stdout, stderr }));
+        proc.on('error', reject);
+    });
+}
+/**
+ * Open an interactive shell inside the CI container.
+ */
+export async function openShell(projectDir) {
+    const stack = await detectStackFromDir(projectDir);
+    const imageName = getImageName(stack);
+    await new Promise((resolve, reject) => {
+        const proc = spawn('docker', [
+            'run', '--rm', '-it',
+            '--entrypoint', '',
+            '-v', `${projectDir}:/home/runner/work`,
+            '-e', 'CI=true',
+            imageName,
+            'bash', '-c', 'cd /home/runner/work && exec bash',
+        ], { stdio: 'inherit' });
+        proc.on('close', () => resolve());
+        proc.on('error', reject);
+    });
+}
+// =============================================================================
+// Internal helpers
+// =============================================================================
+async function detectStackFromDir(projectDir) {
+    if (await fs.pathExists(path.join(projectDir, 'build.gradle.kts')))
+        return 'java-gradle';
+    if (await fs.pathExists(path.join(projectDir, 'build.gradle')))
+        return 'java-gradle';
+    if (await fs.pathExists(path.join(projectDir, 'pom.xml')))
+        return 'java-maven';
+    if (await fs.pathExists(path.join(projectDir, 'package.json')))
+        return 'node';
+    if (await fs.pathExists(path.join(projectDir, 'go.mod')))
+        return 'go';
+    if (await fs.pathExists(path.join(projectDir, 'Cargo.toml')))
+        return 'rust';
+    if (await fs.pathExists(path.join(projectDir, 'pyproject.toml')) ||
+        await fs.pathExists(path.join(projectDir, 'requirements.txt')) ||
+        await fs.pathExists(path.join(projectDir, 'setup.py')))
+        return 'python';
+    return 'node'; // fallback
+}
+//# sourceMappingURL=docker.js.map

package/dist/ui/CI.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { CIOptions } from '../commands/ci.js';
+interface CIProps extends CIOptions {
+    /** Called when CI finishes (success or failure) */
+    onDone?: (success: boolean) => void;
+}
+export default function CI(props: CIProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=CI.d.ts.map

package/dist/ui/CI.js

@@ -0,0 +1,91 @@
+import React, { useEffect, useState, useRef } from 'react';
+import { Box, Text, useApp } from 'ink';
+import Spinner from 'ink-spinner';
+import { runCI } from '../commands/ci.js';
+import Header from './Header.js';
+import { theme } from './theme.js';
+// =============================================================================
+// Icons
+// =============================================================================
+const STATUS_ICON = {
+    pending: '○',
+    running: '●',
+    done: '✓',
+    error: '✗',
+    skipped: '–',
+};
+const STATUS_COLOR = {
+    pending: theme.muted,
+    running: theme.warning,
+    done: theme.success,
+    error: theme.error,
+    skipped: theme.muted,
+};
+// =============================================================================
+// Component
+// =============================================================================
+export default function CI(props) {
+    const { exit } = useApp();
+    const [steps, setSteps] = useState([]);
+    const [done, setDone] = useState(false);
+    const [success, setSuccess] = useState(null);
+    const started = useRef(false);
+    useEffect(() => {
+        if (started.current)
+            return;
+        started.current = true;
+        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];
+            });
+        };
+        runCI(props, onStep)
+            .then(() => {
+            setSuccess(true);
+            setDone(true);
+            props.onDone?.(true);
+            setTimeout(() => exit(), 200);
+        })
+            .catch(() => {
+            setSuccess(false);
+            setDone(true);
+            props.onDone?.(false);
+            // Give user time to read the error before exiting with failure code
+            setTimeout(() => {
+                exit();
+                process.exitCode = 1;
+            }, 300);
+        });
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    const mode = props.mode ?? 'full';
+    const subtitle = mode === 'quick' ? 'ci — quick' : mode === 'shell' ? 'ci — shell' : 'ci';
+    return (React.createElement(Box, { flexDirection: "column", padding: 1 },
+        React.createElement(Header, { subtitle: subtitle }),
+        React.createElement(Box, { flexDirection: "column", marginBottom: 1 }, steps.map(step => (React.createElement(Box, { key: step.id },
+            React.createElement(Text, { color: STATUS_COLOR[step.status] },
+                step.status === 'running'
+                    ? React.createElement(Spinner, { type: "dots" })
+                    : `${STATUS_ICON[step.status]} `,
+                step.label,
+                step.detail
+                    ? React.createElement(Text, { color: theme.muted, dimColor: true },
+                        '  ',
+                        step.detail)
+                    : null))))),
+        done && success === true && (React.createElement(Box, { marginTop: 1, flexDirection: "column" },
+            React.createElement(Text, { color: theme.success, bold: true }, "\u2713 CI passed \u2014 safe to push!"))),
+        done && success === false && (React.createElement(Box, { marginTop: 1, flexDirection: "column" },
+            React.createElement(Text, { color: theme.error, bold: true }, "\u2717 CI failed \u2014 fix the issues above before pushing."),
+            React.createElement(Text, { color: theme.muted, dimColor: true }, "  To skip: git push --no-verify"))),
+        !done && steps.length === 0 && (React.createElement(Text, { color: theme.warning },
+            React.createElement(Spinner, { type: "dots" }),
+            ' Starting CI...'))));
+}
+//# sourceMappingURL=CI.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/.obsidian/plugins/dataview/data.json

@@ -0,0 +1,25 @@
+{
+  "renderNullAs": "\\-",
+  "taskCompletionTracking": true,
+  "taskCompletionUseEmojiShorthand": false,
+  "taskCompletionText": "completion",
+  "taskCompletionDateFormat": "yyyy-MM-dd",
+  "recursiveSubTaskCompletion": false,
+  "warnOnEmptyResult": true,
+  "refreshEnabled": true,
+  "refreshInterval": 2500,
+  "defaultDateFormat": "MMMM dd, yyyy",
+  "defaultDateTimeFormat": "h:mm a - MMMM dd, yyyy",
+  "maxRecursiveRenderDepth": 4,
+  "tableIdColumnName": "File",
+  "tableGroupColumnName": "Group",
+  "showResultCount": true,
+  "allowHtml": false,
+  "inlineQueryPrefix": "=",
+  "inlineJsQueryPrefix": "$=",
+  "inlineQueriesInCodeblocks": true,
+  "enableDataviewJs": false,
+  "enableInlineDataviewJs": false,
+  "prettyRenderInlineFields": true,
+  "prettyRenderInlineFieldsInLivePreview": true
+}