pasika 0.1.6 → 0.2.0

package/dist/eslint/pasika/rules/no-mixed-concerns.js

@@ -0,0 +1,84 @@
+/**
+ * ESLint rule: pasika/no-mixed-concerns
+ *
+ * Enforces the "No Mixed Concerns Rule" — one React component per .tsx file.
+ *
+ * @see docs/code-organization-guide/rules/no-mixed-concerns-rule.md
+ */
+/**
+ * Return the name of an export node so we can report it clearly.
+ * Handles:
+ *   export function Foo() { }
+ *   export const Foo = () => { }
+ *   export const Foo = function () { }
+ *   export default function Foo() { }
+ *   export default () => { }
+ */
+// biome-ignore lint/suspicious/noExplicitAny: AST node type from ESLint with dynamic property access
+function getExportName(declaration) {
+    if (declaration.type === "FunctionDeclaration" && declaration.id) {
+        return declaration.id.name;
+    }
+    if (declaration.type === "VariableDeclaration") {
+        const declarator = declaration.declarations[0];
+        if (declarator?.id.type === "Identifier" &&
+            (declarator.init?.type === "ArrowFunctionExpression" || declarator.init?.type === "FunctionExpression")) {
+            return declarator.id.name;
+        }
+    }
+    if (declaration.type === "ArrowFunctionExpression") {
+        return "default";
+    }
+    if (declaration.type === "FunctionExpression" && declaration.id) {
+        return declaration.id.name;
+    }
+    return null;
+}
+export const noMixedConcernsRule = {
+    meta: {
+        schema: [],
+        type: "problem",
+        docs: {
+            description: "Enforce one exported React component per .tsx file.",
+        },
+    },
+    create(context) {
+        if (!context.filename.endsWith(".tsx"))
+            return {};
+        let exportedComponentCount = 0;
+        const extraExports = [];
+        function registerExport(name) {
+            exportedComponentCount++;
+            if (exportedComponentCount > 1) {
+                extraExports.push({ name });
+            }
+        }
+        return {
+            ExportNamedDeclaration(node) {
+                if (!node.declaration)
+                    return;
+                const name = getExportName(node.declaration);
+                if (name)
+                    registerExport(name);
+            },
+            ExportDefaultDeclaration(node) {
+                const name = getExportName(node.declaration);
+                if (name)
+                    registerExport(name);
+            },
+            "Program:exit"() {
+                if (exportedComponentCount > 1) {
+                    for (const extra of extraExports) {
+                        context.report({
+                            loc: { line: 1, column: 0 },
+                            message: `File exports multiple components. "${extra.name}" is an extra component export. ` +
+                                "Move it to its own file. Each .tsx file MUST contain exactly one component. " +
+                                "See docs/code-organization-guide/rules/no-mixed-concerns-rule.md",
+                        });
+                    }
+                }
+            },
+        };
+    },
+};
+/* eslint-enable @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-return, @typescript-eslint/no-explicit-any -- re-enable after AST node access block */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pasika",
-  "version": "0.1.6",
+  "version": "0.2.0",
   "description": "Reusable agent setup package",
   "repository": {
     "type": "git",
@@ -14,33 +14,22 @@
       "import": "./dist/eslint/pasika/index.js"
     }
   },
-  "bin": {
-    "pasika": "dist/scripts/pasika.js"
-  },
   "files": [
-    "claude",
-    "docs",
-    "dist",
-    "AGENTS.md",
-    "CLAUDE.md",
-    "README.md"
+    "dist/eslint"
   ],
   "scripts": {
-    "build": "rm -rf dist && tsc -p tsconfig.json && tsc -p tsconfig.eslint.json",
-    "check": "npm run lint && npm run typecheck",
-    "docs:generate": "rm -f AGENTS.md CLAUDE.md && npx vulyk docs",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
     "fix": "eslint . --fix",
     "lint": "eslint .",
     "prepack": "npm run build",
-    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.eslint.json --noEmit"
+    "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
     "@types/node": "^24.12.2",
     "eslint": "^9.39.4",
     "prettier": "^3.8.1",
     "typescript": "^5.9.2",
-    "vulyk": "github:Bredansky/vulyk#829cac4a244add961304070474db3e978db01d2a",
-    "zirka": "^0.0.28"
+    "zirka": "^0.0.35"
   },
   "engines": {
     "node": ">=22"

package/claude/hooks/.vulyk

@@ -1,3 +0,0 @@
-🍯 AGENTS.md
-🍯 CLAUDE.md
-🍯 claude-hooks.md

package/claude/hooks/AGENTS.md

@@ -1,3 +0,0 @@
-# Claude Hooks
-Shared Claude hooks shipped by pasika.
-Full documentation: docs/claude/hooks.md

package/claude/hooks/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/claude/hooks/claude-hooks.md

@@ -1,30 +0,0 @@
-# Claude Hooks
-
-`pasika` ships the reusable shared Claude hooks.
-
-## `status-line/index.js`
-
-Displays a two-line status view with:
-
-- model name
-- current folder
-- git branch when available
-- used context percentage as a 10-segment bar
-- session cost
-- session duration
-
-## `notification.sh`
-
-Sends a desktop notification when Claude needs attention.
-
-- macOS: `terminal-notifier` with click-to-focus VS Code behavior, falls back to `osascript`
-- Linux: `notify-send`
-- Windows: PowerShell message box
-
-## `protect-files.sh`
-
-Blocks edits to:
-
-- `.env` files
-- `package-lock.json`
-- files inside `.git/`

package/claude/hooks/notification.sh

@@ -1,38 +0,0 @@
-#!/bin/bash
-# notification.sh - Cross-platform notification
-
-OS="$(uname -s)"
-
-case "$OS" in
-  Darwin*)
-    if command -v terminal-notifier &> /dev/null; then
-      PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
-      TEMP_SCRIPT=$(mktemp)
-
-      cat > "$TEMP_SCRIPT" <<SCRIPTEND
-#!/bin/bash
-/usr/local/bin/code -r "$PROJECT_DIR"
-sleep 0.5
-osascript -e 'tell application "Visual Studio Code" to activate'
-SCRIPTEND
-
-      chmod +x "$TEMP_SCRIPT"
-
-      terminal-notifier \
-        -message "Claude Code needs your attention - Click to focus terminal" \
-        -title "Claude Code" \
-        -sound Ping \
-        -execute "$TEMP_SCRIPT"
-
-      (sleep 60; rm -f "$TEMP_SCRIPT") &
-    else
-      osascript -e 'display notification "Claude Code needs your attention" with title "Claude Code"'
-    fi
-    ;;
-  Linux*)
-    notify-send 'Claude Code' 'Claude Code needs your attention'
-    ;;
-  MINGW*|MSYS*|CYGWIN*)
-    powershell.exe -Command "[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code')"
-    ;;
-esac

package/claude/hooks/protect-files.sh

@@ -1,21 +0,0 @@
-#!/bin/bash
-# protect-files.sh - Block edits to sensitive files
-
-INPUT=$(cat)
-FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
-
-PROTECTED_PATTERNS=(
-  "/\.env$|^\.env$"
-  "package-lock\.json$"
-  "/\.git/|^\.git/"
-)
-
-for pattern in "${PROTECTED_PATTERNS[@]}"; do
-  if echo "$FILE_PATH" | grep -qE "$pattern"; then
-    echo "Blocked: Cannot edit protected file '$FILE_PATH'" >&2
-    echo "Reason: This is a sensitive/generated file that should not be manually edited" >&2
-    exit 2
-  fi
-done
-
-exit 0

package/claude/hooks/status-line/index.js

@@ -1,57 +0,0 @@
-#!/usr/bin/env node
-
-import { execSync } from "node:child_process";
-import path from "node:path";
-
-let input = "";
-
-process.stdin.on("data", (chunk) => {
-  input += chunk;
-});
-
-process.stdin.on("end", () => {
-  try {
-    const data = JSON.parse(input || "{}");
-    const model = data.model?.display_name || data.model?.name || "Claude";
-    const dir = path.basename(data.workspace?.current_dir || process.cwd());
-    const cost = Number(data.cost?.total_cost_usd || 0);
-    const pct = Math.floor(Number(data.context_window?.used_percentage || 0));
-    const durationMs = Number(data.cost?.total_duration_ms || 0);
-
-    const CYAN = "\x1b[36m";
-    const GREEN = "\x1b[32m";
-    const YELLOW = "\x1b[33m";
-    const RED = "\x1b[31m";
-    const RESET = "\x1b[0m";
-
-    let barColor = GREEN;
-    if (pct >= 90) {
-      barColor = RED;
-    } else if (pct >= 70) {
-      barColor = YELLOW;
-    }
-
-    const filled = Math.max(0, Math.min(10, Math.floor(pct / 10)));
-    const bar = "█".repeat(filled) + "░".repeat(10 - filled);
-    const mins = Math.floor(durationMs / 60000);
-    const secs = Math.floor((durationMs % 60000) / 1000);
-
-    let branch = "";
-    try {
-      branch = execSync("git branch --show-current", {
-        encoding: "utf8",
-        stdio: ["pipe", "pipe", "ignore"],
-      }).trim();
-      branch = branch ? ` | 🌿 ${branch}` : "";
-    } catch {
-      branch = "";
-    }
-
-    process.stdout.write(`${CYAN}[${model}]${RESET} 📁 ${dir}${branch}\n`);
-    process.stdout.write(
-      `${barColor}${bar}${RESET} ${pct}% | ${YELLOW}$${cost.toFixed(2)}${RESET} | ⏱️ ${mins}m ${secs}s\n`,
-    );
-  } catch {
-    process.stdout.write("Claude\n");
-  }
-});

package/claude/scripts/render-settings.ts

@@ -1,223 +0,0 @@
-import { access, copyFile, mkdir, readFile, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { constants } from "node:fs";
-import { fileURLToPath } from "node:url";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-interface ClaudeSettings {
-  $schema?: string;
-  attribution?: Record<string, unknown>;
-  permissions?: {
-    ask?: string[];
-    deny?: string[];
-  };
-  hooks: {
-    Notification?: HookMatcherEntry[];
-    PreToolUse?: HookMatcherEntry[];
-    [key: string]: unknown;
-  };
-  statusLine: {
-    type?: string;
-    command: string;
-  };
-  [key: string]: unknown;
-}
-
-interface CommandHook {
-  type?: string;
-  command: string;
-  [key: string]: unknown;
-}
-
-interface HookMatcherEntry {
-  matcher?: string;
-  hooks: CommandHook[];
-  [key: string]: unknown;
-}
-
-const isRecord = (value: unknown): value is Record<string, unknown> => typeof value === "object" && value !== null;
-
-const fileExists = async (filePath: string): Promise<boolean> => {
-  try {
-    await access(filePath, constants.F_OK);
-    return true;
-  } catch {
-    return false;
-  }
-};
-
-const isClaudeSettings = (value: unknown): value is ClaudeSettings => {
-  if (!isRecord(value)) {
-    return false;
-  }
-
-  const hooks = value.hooks;
-  const statusLine = value.statusLine;
-
-  if (!isRecord(hooks) || !isRecord(statusLine) || typeof statusLine.command !== "string") {
-    return false;
-  }
-
-  const notification = hooks.Notification;
-  if (notification !== undefined && !Array.isArray(notification)) {
-    return false;
-  }
-
-  const preToolUse = hooks.PreToolUse;
-  return preToolUse === undefined || Array.isArray(preToolUse);
-};
-
-const readClaudeSettings = async (templatePath: string): Promise<ClaudeSettings> => {
-  const templateRaw = await readFile(templatePath, "utf8");
-  const parsed: unknown = JSON.parse(templateRaw);
-
-  if (!isClaudeSettings(parsed)) {
-    throw new Error("Claude settings template has an invalid shape.");
-  }
-
-  return parsed;
-};
-
-const mergeStringArrays = (left: string[] = [], right: string[] = []): string[] =>
-  Array.from(new Set([...left, ...right]));
-
-const upsertHookMatcherEntry = (
-  entries: HookMatcherEntry[] | undefined,
-  matcher: string,
-  command: string,
-): HookMatcherEntry[] => {
-  const nextEntries = [...(entries ?? [])];
-  const existingIndex = nextEntries.findIndex((entry) => (entry.matcher ?? "") === matcher);
-  const hook: CommandHook = { type: "command", command };
-
-  if (existingIndex === -1) {
-    nextEntries.push({ matcher, hooks: [hook] });
-    return nextEntries;
-  }
-
-  const existingEntry = nextEntries[existingIndex];
-  nextEntries[existingIndex] = { ...existingEntry, hooks: [hook] };
-  return nextEntries;
-};
-
-const mergeClaudeSettings = (
-  existingSettings: ClaudeSettings,
-  baseSettings: ClaudeSettings,
-  packagePath: string,
-): ClaudeSettings => {
-  const notificationCommand = `${packagePath}/hooks/notification.sh`;
-  const protectFilesCommand = `${packagePath}/hooks/protect-files.sh`;
-  const statusLineCommand = `node ${packagePath}/hooks/status-line/index.js`;
-
-  return {
-    ...existingSettings,
-    $schema: baseSettings.$schema ?? existingSettings.$schema,
-    attribution: { ...(baseSettings.attribution ?? {}), ...(existingSettings.attribution ?? {}) },
-    permissions: {
-      ...(existingSettings.permissions ?? {}),
-      ...(baseSettings.permissions ?? {}),
-      ask: mergeStringArrays(baseSettings.permissions?.ask, existingSettings.permissions?.ask),
-      deny: mergeStringArrays(baseSettings.permissions?.deny, existingSettings.permissions?.deny),
-    },
-    hooks: {
-      ...existingSettings.hooks,
-      Notification: upsertHookMatcherEntry(existingSettings.hooks.Notification, "", notificationCommand),
-      PreToolUse: upsertHookMatcherEntry(existingSettings.hooks.PreToolUse, "Edit|Write", protectFilesCommand),
-    },
-    statusLine: {
-      ...existingSettings.statusLine,
-      ...baseSettings.statusLine,
-      type: "command",
-      command: statusLineCommand,
-    },
-  };
-};
-
-export const renderClaude = async (targetDir: string, force: boolean, packageRoot: string): Promise<string[]> => {
-  const templatePath = path.join(packageRoot, "claude/settings.base.json");
-  const baseSettings = await readClaudeSettings(templatePath);
-  const packagePath = "./node_modules/pasika/claude";
-  const notificationEntries = upsertHookMatcherEntry(
-    baseSettings.hooks.Notification,
-    "",
-    `${packagePath}/hooks/notification.sh`,
-  );
-  const preToolUseEntries = upsertHookMatcherEntry(
-    baseSettings.hooks.PreToolUse,
-    "Edit|Write",
-    `${packagePath}/hooks/protect-files.sh`,
-  );
-  const settings: ClaudeSettings = {
-    ...baseSettings,
-    hooks: {
-      ...baseSettings.hooks,
-      Notification: notificationEntries,
-      PreToolUse: preToolUseEntries,
-    },
-    statusLine: {
-      ...baseSettings.statusLine,
-      type: "command",
-      command: `node ${packagePath}/hooks/status-line/index.js`,
-    },
-  };
-
-  const outputDir = path.join(targetDir, ".claude");
-  const outputPath = path.join(outputDir, "settings.json");
-  const hooksOutputDir = path.join(outputDir, "hooks");
-
-  await mkdir(outputDir, { recursive: true });
-  await mkdir(hooksOutputDir, { recursive: true });
-
-  const finalSettings =
-    !force && (await fileExists(outputPath))
-      ? mergeClaudeSettings(await readClaudeSettings(outputPath), settings, packagePath)
-      : settings;
-
-  await writeFile(outputPath, `${JSON.stringify(finalSettings, null, 2)}\n`, "utf8");
-
-  const outputs = [outputPath];
-  const hookDocFiles = ["AGENTS.md", "CLAUDE.md"] as const;
-
-  for (const fileName of hookDocFiles) {
-    const sourcePath = path.join(packageRoot, "claude/hooks", fileName);
-    if (!(await fileExists(sourcePath))) {
-      continue;
-    }
-
-    const destinationPath = path.join(hooksOutputDir, fileName);
-    await copyFile(sourcePath, destinationPath);
-    outputs.push(destinationPath);
-  }
-
-  return outputs;
-};
-
-const isDirectRun = process.argv[1] ? path.resolve(process.argv[1]) === __filename : false;
-
-if (isDirectRun) {
-  const args = process.argv.slice(2);
-  const getArgValue = (flag: string): string | undefined => {
-    const index = args.indexOf(flag);
-    if (index === -1) {
-      return undefined;
-    }
-
-    return args[index + 1];
-  };
-
-  const targetDir = path.resolve(process.cwd(), getArgValue("--target-dir") ?? ".");
-  const force = args.includes("--force");
-  const packageRoot = path.resolve(__dirname, "../..");
-
-  try {
-    const outputs = await renderClaude(targetDir, force, packageRoot);
-    for (const output of outputs) {
-      process.stdout.write(`Wrote ${output}\n`);
-    }
-  } catch (error) {
-    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
-    process.exit(1);
-  }
-}

package/claude/settings.base.json

@@ -1,38 +0,0 @@
-{
-  "$schema": "https://json.schemastore.org/claude-code-settings.json",
-  "attribution": {
-    "commit": "",
-    "pr": ""
-  },
-  "permissions": {
-    "ask": ["Bash(git commit:*)", "Bash(git push:*)"]
-  },
-  "hooks": {
-    "Notification": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/notification.sh"
-          }
-        ]
-      }
-    ],
-    "PreToolUse": [
-      {
-        "matcher": "Edit|Write",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/protect-files.sh"
-          }
-        ]
-      }
-    ]
-  },
-  "statusLine": {
-    "type": "command",
-    "command": "node $CLAUDE_PROJECT_DIR/.claude/hooks/status-line/index.js"
-  }
-}