@protoboxai/codeloop 0.3.0

package/dist/watch/signals.d.ts

@@ -0,0 +1,38 @@
+export type SignalType = 'file_change' | 'git_commit' | 'test_result' | 'build_status' | 'idle';
+export interface WatchSignal {
+    type: SignalType;
+    timestamp: string;
+    data: Record<string, unknown>;
+}
+export interface SignalConfig {
+    file_change: boolean;
+    git_commit: boolean;
+    test_result: boolean;
+    build_status: boolean;
+    idle: boolean;
+}
+/**
+ * Watch for file changes using fs.watch on the project directory.
+ * Fires a callback for each relevant file change.
+ */
+export declare function watchFiles(projectDir: string, ignore: string[], callback: (signal: WatchSignal) => void): {
+    close: () => void;
+};
+/**
+ * Poll .git/refs/heads for new commits.
+ * Returns the latest commit SHA, or null if not a git repo.
+ */
+export declare function getLatestCommitSha(projectDir: string): string | null;
+/**
+ * Poll for new git commits at a given interval.
+ */
+export declare function pollGitCommits(projectDir: string, intervalMs: number, callback: (signal: WatchSignal) => void): {
+    close: () => void;
+};
+/**
+ * Idle timer — fires after no file changes for the specified duration.
+ */
+export declare function createIdleTimer(timeoutMs: number, callback: (signal: WatchSignal) => void): {
+    reset: () => void;
+    close: () => void;
+};

package/dist/watch/signals.js

@@ -0,0 +1,119 @@
+import { watch } from 'fs';
+import { join, relative } from 'path';
+import { execSync } from 'child_process';
+const DEFAULT_IGNORE = ['node_modules', 'dist', '.git', '*.log', '.codeloop/.serve.pid', '.codeloop/.watch.pid'];
+/**
+ * Watch for file changes using fs.watch on the project directory.
+ * Fires a callback for each relevant file change.
+ */
+export function watchFiles(projectDir, ignore, callback) {
+    const ignoreSet = new Set([...DEFAULT_IGNORE, ...ignore]);
+    const watchers = [];
+    function shouldIgnore(filePath) {
+        const rel = relative(projectDir, filePath);
+        for (const pattern of ignoreSet) {
+            if (rel.startsWith(pattern) || rel.includes(`/${pattern}/`) || rel.includes(`/${pattern}`)) {
+                return true;
+            }
+            // Simple glob: *.log → endsWith .log
+            if (pattern.startsWith('*.') && rel.endsWith(pattern.slice(1))) {
+                return true;
+            }
+        }
+        return false;
+    }
+    try {
+        const watcher = watch(projectDir, { recursive: true }, (_event, filename) => {
+            if (!filename)
+                return;
+            const fullPath = join(projectDir, filename);
+            if (shouldIgnore(fullPath))
+                return;
+            callback({
+                type: 'file_change',
+                timestamp: new Date().toISOString(),
+                data: { file: filename },
+            });
+        });
+        watchers.push(watcher);
+    }
+    catch {
+        // fs.watch with recursive may not be supported on all platforms
+    }
+    return {
+        close: () => {
+            for (const w of watchers)
+                w.close();
+        },
+    };
+}
+/**
+ * Poll .git/refs/heads for new commits.
+ * Returns the latest commit SHA, or null if not a git repo.
+ */
+export function getLatestCommitSha(projectDir) {
+    try {
+        return execSync('git rev-parse --short HEAD', {
+            cwd: projectDir,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Poll for new git commits at a given interval.
+ */
+export function pollGitCommits(projectDir, intervalMs, callback) {
+    let lastSha = getLatestCommitSha(projectDir);
+    const timer = setInterval(() => {
+        const currentSha = getLatestCommitSha(projectDir);
+        if (currentSha && currentSha !== lastSha) {
+            // Get commit message
+            let message = '';
+            try {
+                message = execSync(`git log -1 --format=%s ${currentSha}`, {
+                    cwd: projectDir,
+                    encoding: 'utf-8',
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                }).trim();
+            }
+            catch { /* ignore */ }
+            callback({
+                type: 'git_commit',
+                timestamp: new Date().toISOString(),
+                data: { sha: currentSha, previousSha: lastSha, message },
+            });
+            lastSha = currentSha;
+        }
+    }, intervalMs);
+    return {
+        close: () => clearInterval(timer),
+    };
+}
+/**
+ * Idle timer — fires after no file changes for the specified duration.
+ */
+export function createIdleTimer(timeoutMs, callback) {
+    let timer = null;
+    function start() {
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            callback({
+                type: 'idle',
+                timestamp: new Date().toISOString(),
+                data: { idleSeconds: timeoutMs / 1000 },
+            });
+        }, timeoutMs);
+    }
+    start();
+    return {
+        reset: () => start(),
+        close: () => { if (timer)
+            clearTimeout(timer); },
+    };
+}
+//# sourceMappingURL=signals.js.map

package/dist/watch/signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.js","sourceRoot":"","sources":["../../src/watch/signals.ts"],"names":[],"mappings":"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"}

package/dist/watch/triggers.d.ts

@@ -0,0 +1,10 @@
+import type { WatchSignal } from './signals.js';
+export interface TriggerResult {
+    action: string;
+    details: string;
+}
+/**
+ * Process a signal and determine what actions to take.
+ * Returns a list of actions taken (for logging/reporting).
+ */
+export declare function processSignal(projectDir: string, signal: WatchSignal): TriggerResult[];

package/dist/watch/triggers.js

@@ -0,0 +1,67 @@
+import { loadBoard, saveBoard, updateTask } from '../lib/board.js';
+/**
+ * Process a signal and determine what actions to take.
+ * Returns a list of actions taken (for logging/reporting).
+ */
+export function processSignal(projectDir, signal) {
+    const results = [];
+    switch (signal.type) {
+        case 'file_change':
+            // File changes are primarily used to reset the idle timer.
+            // No board action needed for individual file saves.
+            results.push({
+                action: 'file_tracked',
+                details: `${signal.data.file}`,
+            });
+            break;
+        case 'git_commit': {
+            // Append commit SHA to the active board task
+            try {
+                let board = loadBoard(projectDir);
+                const activeTask = board.tasks.find(t => t.status === 'in_progress' || t.status === 'planned');
+                if (activeTask) {
+                    const commits = [...activeTask.commits, signal.data.sha];
+                    board = updateTask(board, activeTask.id, { commits });
+                    saveBoard(projectDir, board);
+                    results.push({
+                        action: 'commit_tracked',
+                        details: `${signal.data.sha} → task ${activeTask.id} (${signal.data.message})`,
+                    });
+                }
+                else {
+                    results.push({
+                        action: 'commit_untracked',
+                        details: `${signal.data.sha} — no active task on board`,
+                    });
+                }
+            }
+            catch {
+                results.push({
+                    action: 'commit_error',
+                    details: `Failed to update board with commit ${signal.data.sha}`,
+                });
+            }
+            break;
+        }
+        case 'idle':
+            results.push({
+                action: 'idle_timeout',
+                details: `No activity for ${signal.data.idleSeconds}s`,
+            });
+            break;
+        case 'test_result':
+            results.push({
+                action: 'test_tracked',
+                details: `Tests: ${signal.data.passed}/${signal.data.total} passed`,
+            });
+            break;
+        case 'build_status':
+            results.push({
+                action: 'build_tracked',
+                details: `Build: ${signal.data.status}`,
+            });
+            break;
+    }
+    return results;
+}
+//# sourceMappingURL=triggers.js.map

package/dist/watch/triggers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.js","sourceRoot":"","sources":["../../src/watch/triggers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAuB,MAAM,iBAAiB,CAAC;AAQxF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB,EAAE,MAAmB;IACnE,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,aAAa;YAChB,2DAA2D;YAC3D,oDAAoD;YACpD,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM,EAAE,cAAc;gBACtB,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;aAC/B,CAAC,CAAC;YACH,MAAM;QAER,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,6CAA6C;YAC7C,IAAI,CAAC;gBACH,IAAI,KAAK,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;gBAClC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CACjC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CAC1D,CAAC;gBAEF,IAAI,UAAU,EAAE,CAAC;oBACf,MAAM,OAAO,GAAG,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,GAAa,CAAC,CAAC;oBACnE,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;oBACtD,SAAS,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;oBAE7B,OAAO,CAAC,IAAI,CAAC;wBACX,MAAM,EAAE,gBAAgB;wBACxB,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,UAAU,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG;qBAC/E,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,IAAI,CAAC;wBACX,MAAM,EAAE,kBAAkB;wBAC1B,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,4BAA4B;qBACxD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,IAAI,CAAC;oBACX,MAAM,EAAE,cAAc;oBACtB,OAAO,EAAE,sCAAsC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;iBACjE,CAAC,CAAC;YACL,CAAC;YACD,MAAM;QACR,CAAC;QAED,KAAK,MAAM;YACT,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM,EAAE,cAAc;gBACtB,OAAO,EAAE,mBAAmB,MAAM,CAAC,IAAI,CAAC,WAAW,GAAG;aACvD,CAAC,CAAC;YACH,MAAM;QAER,KAAK,aAAa;YAChB,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM,EAAE,cAAc;gBACtB,OAAO,EAAE,UAAU,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS;aACpE,CAAC,CAAC;YACH,MAAM;QAER,KAAK,cAAc;YACjB,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM,EAAE,eAAe;gBACvB,OAAO,EAAE,UAAU,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE;aACxC,CAAC,CAAC;YACH,MAAM;IACV,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@protoboxai/codeloop",
+  "version": "0.3.0",
+  "description": "Self-improving development workflow for AI coding agents",
+  "homepage": "https://codeloop.protobox.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sixfactors/codeloop.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sixfactors/codeloop/issues"
+  },
+  "type": "module",
+  "bin": {
+    "codeloop": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:ui": "cd ui && npm run build",
+    "build:all": "tsc && cd ui && npm run build",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build:all"
+  },
+  "keywords": [
+    "claude-code",
+    "cursor",
+    "codex",
+    "workflow",
+    "developer-tools",
+    "cli",
+    "ai-coding"
+  ],
+  "author": "Dean Grover",
+  "license": "MIT",
+  "dependencies": {
+    "@hono/node-server": "^1.19.9",
+    "@modelcontextprotocol/sdk": "^1.31.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "fs-extra": "^11.2.0",
+    "hono": "^4.12.0",
+    "yaml": "^2.5.0",
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^20.14.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "typescript": "^5.5.0",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "starters",
+    "registry"
+  ]
+}

package/registry/index.json

@@ -0,0 +1,106 @@
+{
+  "version": 1,
+  "updatedAt": "2026-02-21T00:00:00Z",
+  "skills": [
+    {
+      "name": "design",
+      "version": "0.2.0",
+      "description": "Architecture before code — generate lightweight spec from codebase analysis",
+      "author": "sixfactors",
+      "tags": ["pipeline", "architecture", "planning"],
+      "stack": "generic",
+      "tier": "trusted",
+      "source": "builtin"
+    },
+    {
+      "name": "plan",
+      "version": "0.2.0",
+      "description": "Plan a task — write spec to tasks/todo.md, enter plan mode",
+      "author": "sixfactors",
+      "tags": ["pipeline", "planning", "tdd"],
+      "stack": "generic",
+      "tier": "trusted",
+      "source": "builtin"
+    },
+    {
+      "name": "manage",
+      "version": "0.2.0",
+      "description": "Track task progress — read/update tasks/todo.md",
+      "author": "sixfactors",
+      "tags": ["pipeline", "tasks", "tracking"],
+      "stack": "generic",
+      "tier": "trusted",
+      "source": "builtin"
+    },
+    {
+      "name": "test",
+      "version": "0.2.0",
+      "description": "Run tests, parse results, track coverage history",
+      "author": "sixfactors",
+      "tags": ["pipeline", "testing", "coverage"],
+      "stack": "generic",
+      "tier": "trusted",
+      "source": "builtin"
+    },
+    {
+      "name": "commit",
+      "version": "0.2.0",
+      "description": "Review + reflect + commit in one flow",
+      "author": "sixfactors",
+      "tags": ["pipeline", "git", "review"],
+      "stack": "generic",
+      "tier": "trusted",
+      "source": "builtin"
+    },
+    {
+      "name": "qa",
+      "version": "0.2.0",
+      "description": "Quality gate — run all checks before promoting a task",
+      "author": "sixfactors",
+      "tags": ["pipeline", "quality", "gate"],
+      "stack": "generic",
+      "tier": "trusted",
+      "source": "builtin"
+    },
+    {
+      "name": "deploy",
+      "version": "0.2.0",
+      "description": "Deploy to staging or production with verification gates",
+      "author": "sixfactors",
+      "tags": ["pipeline", "deploy", "staging", "production"],
+      "stack": "generic",
+      "tier": "trusted",
+      "source": "builtin"
+    },
+    {
+      "name": "debug",
+      "version": "0.2.0",
+      "description": "Investigate production issues — search logs, check health",
+      "author": "sixfactors",
+      "tags": ["pipeline", "debugging", "logs", "production"],
+      "stack": "generic",
+      "tier": "trusted",
+      "source": "builtin"
+    },
+    {
+      "name": "reflect",
+      "version": "0.1.0",
+      "description": "Session-end reflection — capture what you learned",
+      "author": "sixfactors",
+      "tags": ["pipeline", "reflection", "learning"],
+      "stack": "generic",
+      "tier": "trusted",
+      "source": "builtin"
+    },
+    {
+      "name": "ship",
+      "version": "0.2.0",
+      "description": "Close the loop — QA, deploy staging, deploy prod, verify, close task",
+      "author": "sixfactors",
+      "tags": ["pipeline", "deploy", "orchestration"],
+      "stack": "generic",
+      "tier": "trusted",
+      "source": "builtin"
+    }
+  ]
+}

package/starters/generic.yaml

@@ -0,0 +1,95 @@
+# Codeloop Configuration
+# Generic starter — minimal assumptions, works with any project.
+# Customize scopes, quality_checks, and diff_scan for your stack.
+
+project:
+  name: "my-project"
+
+# Scopes map file paths to knowledge sections.
+# /commit uses scopes to load only relevant gotchas and patterns.
+scopes:
+  all:
+    paths: ["**/*"]
+    gotcha_sections: []
+    pattern_sections: []
+
+# Quality checks run during /commit Phase 1.
+# Add build/lint/typecheck commands for your stack.
+quality_checks: {}
+  # all:
+  #   - name: "Lint"
+  #     command: "npm run lint 2>&1 | tail -20"
+
+# Diff scan rules check the actual diff for violations.
+# Each match is reported at the specified severity.
+diff_scan: []
+  # - pattern: "console\\.log"
+  #   files: "*.ts,*.js"
+  #   exclude: "*.test.*"
+  #   severity: CRITICAL
+  #   message: "console.log in production code"
+  # - pattern: "TODO"
+  #   files: "*"
+  #   severity: WARNING
+  #   message: "TODO comment found"
+
+# Testing — used by /test and /qa
+# test:
+#   command: "npm test"           # or pytest, go test ./..., cargo test
+#   coverage_threshold: 80        # optional, for /qa gate
+#   integrity_checks: true        # scan for fake-pass patterns
+
+# Deployment — used by /deploy and /ship
+# deploy:
+#   staging:
+#     command: ""                  # your staging deploy command
+#     verify: ""                   # post-deploy smoke test
+#   production:
+#     command: ""                  # your production deploy command
+#     verify: ""                   # post-deploy smoke test
+#     requires: staging            # must pass staging first
+
+# Debugging — used by /debug
+# debug:
+#   logs: ""                       # command to tail production logs
+#   health: ""                     # health check URL or command
+
+# Conventional commit types allowed.
+commit:
+  types: [feat, fix, refactor, docs, test, chore, perf]
+  format: "type(scope): message"
+
+# Watch mode — used by `codeloop watch`
+# watch:
+#   enabled: true
+#   idle_timeout: 300            # seconds before idle signal
+#   signals:
+#     file_change: true
+#     git_commit: true
+#     test_result: true
+#     build_status: true
+#     idle: true
+#   ignore:
+#     - node_modules
+#     - dist
+#     - .git
+#     - "*.log"
+
+# Unattended runs — used by `codeloop run --agent` and `codeloop schedule install`.
+# The command gets the stage brief; {brief} becomes the shell-quoted path to it.
+# agents:
+#   default: claude
+#   claude:
+#     cmd: "claude -p --permission-mode acceptEdits < {brief}"
+#     timeout_minutes: 20        # the agent is killed after this
+#     max_runs_per_day: 20       # agent starts across the project in any 24 hours
+#   codex:
+#     cmd: "codex exec - < {brief}"
+# run:
+#   agent: true                  # plain `codeloop run` starts agents too
+
+# Codeloop behavior settings.
+codeloop:
+  critical_frequency: 3      # Gotchas at this freq or higher → CRITICAL in review
+  promote_frequency: 10       # Suggest promoting to rules.md at this freq
+  max_knowledge_lines: 200    # Warn when knowledge files exceed this

package/starters/go.yaml

@@ -0,0 +1,99 @@
+# Codeloop Configuration
+# Go starter
+
+project:
+  name: "my-project"
+
+scopes:
+  backend:
+    paths: ["cmd/**", "internal/**", "pkg/**"]
+    gotcha_sections: ["Backend", "Database", "API"]
+    pattern_sections: ["Backend", "API"]
+  tests:
+    paths: ["**/*_test.go"]
+    gotcha_sections: ["Testing"]
+    pattern_sections: ["Testing"]
+  config:
+    paths: [".github/**", "Dockerfile*", "docker-compose*", "Makefile"]
+    gotcha_sections: ["CI", "Config"]
+    pattern_sections: ["CI"]
+
+quality_checks:
+  backend:
+    - name: "Vet"
+      command: "go vet ./... 2>&1 | tail -20"
+    - name: "Build"
+      command: "go build ./... 2>&1 | tail -20"
+
+diff_scan:
+  - pattern: "fmt\\.Print"
+    files: "*.go"
+    exclude: "*_test.go"
+    severity: WARNING
+    message: "fmt.Print in production code — use structured logging"
+  - pattern: "panic\\("
+    files: "*.go"
+    exclude: "*_test.go"
+    severity: WARNING
+    message: "panic() in production code — return errors instead"
+
+# Testing — used by /test and /qa
+test:
+  command: "go test ./..."
+  coverage_threshold: 70
+  integrity_checks: false
+
+# Deployment — used by /deploy and /ship
+# Uncomment and fill in your deploy commands:
+# deploy:
+#   staging:
+#     command: "make deploy-staging"
+#     verify: "curl -sf https://staging.example.com/health"
+#   production:
+#     command: "make deploy-prod"
+#     verify: "curl -sf https://example.com/health"
+#     requires: staging
+
+# Debugging — used by /debug
+# Uncomment and fill in your log/health commands:
+# debug:
+#   logs: "kubectl logs deployment/myapp --tail=50"
+#   health: "curl -sf https://example.com/health"
+
+commit:
+  types: [feat, fix, refactor, docs, test, chore, perf]
+  format: "type(scope): message"
+
+# Watch mode — used by `codeloop watch`
+watch:
+  enabled: true
+  idle_timeout: 300
+  signals:
+    file_change: true
+    git_commit: true
+    test_result: true
+    build_status: true
+    idle: true
+  ignore:
+    - vendor
+    - bin
+    - .git
+    - "*.log"
+
+# Unattended runs — used by `codeloop run --agent` and `codeloop schedule install`.
+# The command gets the stage brief; {brief} becomes the shell-quoted path to it.
+# agents:
+#   default: claude
+#   claude:
+#     cmd: "claude -p --permission-mode acceptEdits < {brief}"
+#     timeout_minutes: 20        # the agent is killed after this
+#     max_runs_per_day: 20       # agent starts across the project in any 24 hours
+#   codex:
+#     cmd: "codex exec - < {brief}"
+# run:
+#   agent: true                  # plain `codeloop run` starts agents too
+
+codeloop:
+  critical_frequency: 3
+  promote_frequency: 10
+  max_knowledge_lines: 200