pasika 0.1.6 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pasika",
-  "version": "0.1.6",
+  "version": "0.3.0",
   "description": "Reusable agent setup package",
   "repository": {
     "type": "git",
@@ -14,35 +14,41 @@
       "import": "./dist/eslint/pasika/index.js"
     }
   },
-  "bin": {
-    "pasika": "dist/scripts/pasika.js"
-  },
   "files": [
-    "claude",
-    "docs",
     "dist",
-    "AGENTS.md",
-    "CLAUDE.md",
-    "README.md"
+    "enforcement/registry.json"
   ],
   "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",
+    "coverage": "tsx cli/index.ts coverage",
+    "docs": "tsx cli/index.ts docs",
+    "test": "node --import tsx --test 'eslint/**/*.test.ts' 'enforcement/**/*.test.ts'"
   },
   "devDependencies": {
+    "@types/estree": "^1.0.9",
     "@types/node": "^24.12.2",
+    "@typescript-eslint/parser": "^8.68.0",
     "eslint": "^9.39.4",
     "prettier": "^3.8.1",
+    "tsx": "^4.23.12",
     "typescript": "^5.9.2",
-    "vulyk": "github:Bredansky/vulyk#829cac4a244add961304070474db3e978db01d2a",
-    "zirka": "^0.0.28"
+    "zirka": "^0.0.38"
   },
   "engines": {
     "node": ">=22"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "zod": "^4.4.3"
+  },
+  "bin": {
+    "pasika": "dist/cli/index.js"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
   }
 }

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"
-  }
-}

package/dist/claude/scripts/render-settings.js

@@ -1,145 +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);
-const isRecord = (value) => typeof value === "object" && value !== null;
-const fileExists = async (filePath) => {
-    try {
-        await access(filePath, constants.F_OK);
-        return true;
-    }
-    catch {
-        return false;
-    }
-};
-const isClaudeSettings = (value) => {
-    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) => {
-    const templateRaw = await readFile(templatePath, "utf8");
-    const parsed = JSON.parse(templateRaw);
-    if (!isClaudeSettings(parsed)) {
-        throw new Error("Claude settings template has an invalid shape.");
-    }
-    return parsed;
-};
-const mergeStringArrays = (left = [], right = []) => Array.from(new Set([...left, ...right]));
-const upsertHookMatcherEntry = (entries, matcher, command) => {
-    const nextEntries = [...(entries ?? [])];
-    const existingIndex = nextEntries.findIndex((entry) => (entry.matcher ?? "") === matcher);
-    const hook = { 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, baseSettings, packagePath) => {
-    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, force, packageRoot) => {
-    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 = {
-        ...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"];
-    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) => {
-        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/dist/eslint/pasika/rules/organization-imports.d.ts

@@ -1,2 +0,0 @@
-import type { Rule } from "eslint";
-export declare const organizationImportsRule: Rule.RuleModule;

package/dist/eslint.config.js

@@ -1,7 +0,0 @@
-import { RuleSeverity, styleguide } from "zirka";
-const { eslintConfig } = styleguide({
-    node: RuleSeverity.Error,
-    typescript: RuleSeverity.Error,
-    ignores: ["dist/**", "node_modules/**", "prettier.config.mjs"],
-});
-export default eslintConfig;