@scriptgun/workerc 0.1.0

package/dist/templates/hooks/session-start-compact.sh

@@ -0,0 +1,88 @@
+#!/bin/bash
+# SessionStart hook: Re-inject tracker + spec context after compaction
+# Fires on: compact (registered via matcher in settings.local.json)
+# Output: additionalContext with tracker content, spec content, and action instructions
+
+INPUT=$(cat)
+SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // empty')
+
+[ -z "$SESSION_ID" ] && exit 0
+
+TRACKER_DIR="$(cd "$(dirname "$0")/../progress" 2>/dev/null && pwd)"
+[ -z "$TRACKER_DIR" ] || [ ! -d "$TRACKER_DIR" ] && exit 0
+
+PROJECT_DIR="$(cd "$(dirname "$0")/../.." 2>/dev/null && pwd)"
+
+# Find this session's active tracker
+MY_TRACKER=""
+for t in "$TRACKER_DIR"/*.md; do
+	[ -f "$t" ] || continue
+	LINE1=$(head -1 "$t")
+	echo "$LINE1" | grep -q "\[DONE\]" && continue
+	echo "$LINE1" | grep -q "\[ABORTED\]" && continue
+	LINE2=$(sed -n '2p' "$t")
+	if echo "$LINE2" | grep -q "<!-- session: $SESSION_ID -->"; then
+		MY_TRACKER="$t"
+		break
+	fi
+done
+
+[ -z "$MY_TRACKER" ] && exit 0
+
+# Read tracker
+TRACKER_CONTENT=$(cat "$MY_TRACKER")
+TRACKER_NAME=$(basename "$MY_TRACKER")
+TRACKER_REL=".claude/progress/$TRACKER_NAME"
+
+# Extract spec path (line 3 format: <!-- spec: path -->)
+SPEC_PATH=""
+SPEC_CONTENT=""
+SPEC_LINE=$(sed -n '3p' "$MY_TRACKER")
+if echo "$SPEC_LINE" | grep -q "<!-- spec:"; then
+	SPEC_PATH=$(echo "$SPEC_LINE" | sed -n 's/<!-- spec: \(.*\) -->/\1/p')
+fi
+
+if [ -n "$SPEC_PATH" ] && [ "$SPEC_PATH" != "None" ]; then
+	FULL_SPEC="$PROJECT_DIR/$SPEC_PATH"
+	if [ -f "$FULL_SPEC" ]; then
+		SPEC_CONTENT=$(cat "$FULL_SPEC")
+	fi
+fi
+
+# Count completed entries to show progress
+DONE_COUNT=$(grep -c '^\- \[x\]' "$MY_TRACKER" 2>/dev/null || echo "0")
+
+# Build context
+CONTEXT="# SESSION CONTEXT RESTORED (post-compaction)
+
+You are CONTINUING an existing work session. You are NOT starting fresh.
+Your session ID: $SESSION_ID
+
+## Active Progress: $TRACKER_REL ($DONE_COUNT entries)
+$TRACKER_CONTENT
+
+## REQUIRED: After reading this, immediately:
+1. Re-read your progress file: Read file $PROJECT_DIR/$TRACKER_REL"
+
+if [ -n "$SPEC_PATH" ] && [ "$SPEC_PATH" != "None" ]; then
+	CONTEXT="$CONTEXT
+2. Re-read your spec: Read file $PROJECT_DIR/$SPEC_PATH"
+fi
+
+CONTEXT="$CONTEXT
+3. Review the last few log entries to understand where you left off
+4. Re-read files listed in ## Files to rebuild code context
+5. Continue working — do NOT ask the user what to do next unless genuinely stuck
+
+## Hooks still active:
+{{ACTIVE_HOOKS}}"
+
+if [ -n "$SPEC_CONTENT" ]; then
+	CONTEXT="$CONTEXT
+
+## Spec: $SPEC_PATH
+$SPEC_CONTENT"
+fi
+
+jq -n --arg ctx "$CONTEXT" '{"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":$ctx}}'
+exit 0

package/dist/write-files.d.ts

@@ -0,0 +1,16 @@
+export interface WriteOptions {
+    projectDir: string;
+    enableLint: boolean;
+    lintCommand: string;
+    lintExtensions: string;
+    lintHookFilename: string;
+    enableTypes: boolean;
+    typeCommand: string;
+    typeExtensions: string;
+    typesHookFilename: string;
+    activeHooksDescription: string;
+}
+export declare function writeFiles(options: WriteOptions): {
+    commands: string[];
+    hooks: string[];
+};

package/dist/write-files.js

@@ -0,0 +1,78 @@
+import { chmodSync, cpSync, existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+function getTemplateDir() {
+    const thisFile = fileURLToPath(import.meta.url);
+    /* In dist/write-files.js → templates are in dist/templates/ */
+    const dir = join(thisFile, "..", "templates");
+    if (existsSync(dir))
+        return dir;
+    /* Fallback: src layout (dev) */
+    return join(thisFile, "..", "..", "src", "templates");
+}
+function ensureDir(dir) {
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+function renderTemplate(content, vars) {
+    let result = content;
+    for (const [key, value] of Object.entries(vars)) {
+        result = result.replaceAll(`{{{${key}}}}`, value);
+        result = result.replaceAll(`{{${key}}}`, value);
+    }
+    return result;
+}
+export function writeFiles(options) {
+    const templateDir = getTemplateDir();
+    const claudeDir = join(options.projectDir, ".claude");
+    const commandsTarget = join(claudeDir, "commands", "workerc");
+    const hooksTarget = join(claudeDir, "hooks");
+    const progressDir = join(claudeDir, "progress");
+    ensureDir(commandsTarget);
+    ensureDir(hooksTarget);
+    ensureDir(progressDir);
+    /* Copy command templates verbatim */
+    const commandsSrc = join(templateDir, "commands");
+    const commandFiles = readdirSync(commandsSrc).filter((f) => f.endsWith(".md"));
+    for (const file of commandFiles) {
+        cpSync(join(commandsSrc, file), join(commandsTarget, file));
+    }
+    /* Copy/template hook files */
+    const writtenHooks = [];
+    /* Tracker — verbatim copy */
+    cpSync(join(templateDir, "hooks", "post-edit-tracker.sh"), join(hooksTarget, "post-edit-tracker.sh"));
+    chmodSync(join(hooksTarget, "post-edit-tracker.sh"), 0o755);
+    writtenHooks.push("post-edit-tracker.sh");
+    /* Session start compact — template {{ACTIVE_HOOKS}} */
+    const compactSrc = readFileSync(join(templateDir, "hooks", "session-start-compact.sh"), "utf-8");
+    const compactRendered = renderTemplate(compactSrc, {
+        ACTIVE_HOOKS: options.activeHooksDescription,
+    });
+    writeFileSync(join(hooksTarget, "session-start-compact.sh"), compactRendered);
+    chmodSync(join(hooksTarget, "session-start-compact.sh"), 0o755);
+    writtenHooks.push("session-start-compact.sh");
+    /* Lint hook — optional, from template */
+    if (options.enableLint) {
+        const lintTmpl = readFileSync(join(templateDir, "hooks", "post-edit-lint.sh.tmpl"), "utf-8");
+        const lintRendered = renderTemplate(lintTmpl, {
+            LINT_COMMAND: options.lintCommand,
+            EXTENSIONS: options.lintExtensions,
+        });
+        writeFileSync(join(hooksTarget, options.lintHookFilename), lintRendered);
+        chmodSync(join(hooksTarget, options.lintHookFilename), 0o755);
+        writtenHooks.push(options.lintHookFilename);
+    }
+    /* Types hook — optional, from template */
+    if (options.enableTypes) {
+        const typesTmpl = readFileSync(join(templateDir, "hooks", "post-edit-types.sh.tmpl"), "utf-8");
+        const typesRendered = renderTemplate(typesTmpl, {
+            TYPE_COMMAND: options.typeCommand,
+            EXTENSIONS: options.typeExtensions,
+        });
+        writeFileSync(join(hooksTarget, options.typesHookFilename), typesRendered);
+        chmodSync(join(hooksTarget, options.typesHookFilename), 0o755);
+        writtenHooks.push(options.typesHookFilename);
+    }
+    return { commands: commandFiles, hooks: writtenHooks };
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@scriptgun/workerc",
+  "version": "0.1.0",
+  "description": "Claude Code session management CLI — commands, hooks, and progress tracking",
+  "type": "module",
+  "bin": {
+    "workerc": "./dist/bin.js"
+  },
+  "main": "./dist/init.js",
+  "types": "./dist/init.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc && cp -r src/templates dist/templates",
+    "type:check": "tsc --noEmit"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "session",
+    "hooks",
+    "cli",
+    "workerc"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lovrozagar/workerc"
+  },
+  "dependencies": {
+    "@clack/prompts": "1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}