@promptci/core 0.0.1

package/dist/ci-alignment.js

@@ -0,0 +1,343 @@
+import * as crypto from 'node:crypto';
+/**
+ * CI and Workflow Alignment Detector
+ *
+ * Compares what GitHub Actions workflows actually run against what instruction
+ * files tell agents to run locally.  Surfaces drift between the CI gate and
+ * the agent verification loop so agents know which steps must pass before
+ * declaring work complete.
+ *
+ * Findings are heuristic — wording is intentionally cautious.
+ */
+function issueId(key) {
+    const hash = crypto.createHash('sha1').update(key).digest('hex').slice(0, 12);
+    return `ci-align-${hash}`;
+}
+/**
+ * Split a raw CI command that may contain multiple sub-commands joined with
+ * `&&` or newlines (multi-line `run:` blocks) into individual segments.
+ */
+function splitCommand(command) {
+    return command
+        .split(/&&|\n/)
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+/**
+ * Normalizes a single command segment to identify a CommonTask.
+ * Returns the task name if recognised, otherwise null.
+ */
+function identifyTaskInSegment(segment) {
+    const cmd = segment.toLowerCase();
+    // Package-manager run patterns: "pnpm run lint", "npm test", "yarn build", etc.
+    const pmRunMatch = /\b(?:pnpm|npm|yarn|bun)\s+(?:run\s+)?(test|lint|build|typecheck|format)\b/.exec(cmd);
+    if (pmRunMatch)
+        return pmRunMatch[1];
+    // Direct tool invocations
+    if (/\bjest\b|\bvitest\b|\bmocha\b|\bplaywright\s+test\b/.test(cmd))
+        return 'test';
+    if (/\beslint\b|\bprettier\s+--check\b/.test(cmd))
+        return 'lint';
+    // CI1: `\b` immediately before `--noemit` can never match — `\b` requires a
+    // word-char/non-word-char transition, but "--noemit" is always preceded by
+    // whitespace (non-word char before a non-word `-`), so `/\b--noemit\b/`
+    // never matched real input like "tsc --noEmit". This made `tsc --noEmit`
+    // in CI ALWAYS classify as 'build', never 'typecheck'. No leading boundary
+    // is needed — "--noemit" is unambiguous on its own.
+    if (/\btsc\b/.test(cmd) && /--noemit\b/i.test(cmd))
+        return 'typecheck';
+    if (/\btsc\b/.test(cmd) && !/--noemit\b/i.test(cmd))
+        return 'build';
+    if (/\bprettier\s+--write\b/.test(cmd))
+        return 'format';
+    return null;
+}
+/**
+ * Returns all CommonTasks found in a (possibly multi-command) CI run: string.
+ * Handles `&&`-joined lines and multi-line blocks.
+ */
+function identifyTasksInCommand(command) {
+    const tasks = [];
+    for (const segment of splitCommand(command)) {
+        const t = identifyTaskInSegment(segment);
+        if (t && !tasks.includes(t))
+            tasks.push(t);
+    }
+    return tasks;
+}
+// ── Instruction-file task matching ────────────────────────────────────────────
+/**
+ * Patterns that indicate an instruction file is actively directing the agent
+ * to run a given task.  We look for command-like contexts to avoid matching
+ * the word "test" in prose like "make sure to test your assumptions".
+ *
+ * For each task we accept:
+ *  - An explicit package-manager command  (`pnpm lint`, `npm run lint`, …)
+ *  - A heading or list item that names the task  (## Lint, - Run lint)
+ *  - The word in a run/execute/check context
+ */
+const TASK_INSTRUCTION_PATTERNS = {
+    lint: /\b(?:(?:pnpm|npm|yarn|bun)\s+(?:run\s+)?lint|eslint\b|run\s+lint|lint\s+the\s+code|linting)\b/i,
+    typecheck: /\b(?:(?:pnpm|npm|yarn|bun)\s+(?:run\s+)?typecheck|tsc\b|type.?check|run\s+typecheck)\b/i,
+    test: /\b(?:(?:pnpm|npm|yarn|bun)\s+(?:run\s+)?test|vitest\b|jest\b|run\s+(?:the\s+)?tests?|pnpm\s+test)\b/i,
+    build: /\b(?:(?:pnpm|npm|yarn|bun)\s+(?:run\s+)?build|tsc\b(?!\s+--noemit)|run\s+(?:the\s+)?build)\b/i,
+    format: /\b(?:(?:pnpm|npm|yarn|bun)\s+(?:run\s+)?format|prettier\b|run\s+format)\b/i,
+};
+/**
+ * Returns true when any scanned instruction file directs the agent to run the
+ * given task in a command-like context (not just mentions the word in prose).
+ */
+function isTaskInstructed(task, files) {
+    const pattern = TASK_INSTRUCTION_PATTERNS[task];
+    return files.some((f) => pattern.test(f.content));
+}
+// ── Package manager extraction ────────────────────────────────────────────────
+/** Returns the package manager name used in a single command segment, or null. */
+function extractPackageManager(command) {
+    const match = /\b(pnpm|npm|yarn|bun)\b/.exec(command.toLowerCase());
+    return match ? match[1] : null;
+}
+/** Collects all distinct package managers mentioned across all CI commands. */
+function collectCiPackageManagers(commands) {
+    const pms = new Set();
+    for (const wc of commands) {
+        for (const segment of splitCommand(wc.command)) {
+            const pm = extractPackageManager(segment);
+            if (pm)
+                pms.add(pm);
+        }
+    }
+    return pms;
+}
+// ── Script normalisation ──────────────────────────────────────────────────────
+/** Standard pm subcommands that are not user-defined package scripts. */
+const STANDARD_SUBCOMMANDS = new Set([
+    'install', 'i', 'add', 'remove', 'uninstall', 'init', 'help',
+    'test', 'start', 'stop', 'restart', 'exec', 'dlx', 'run',
+    'workspace', 'workspaces',
+]);
+/**
+ * CI2: common English words that follow a package-manager name in ordinary
+ * PROSE, not a command invocation — "use pnpm instead of npm" and "npm
+ * packages are pinned" both matched the extraction regex below (which
+ * accepts ANY following alphanumeric word as a candidate script name),
+ * producing bogus orphan-script findings for "instead" and "packages".
+ * pnpm/yarn support a real bare `pnpm <script>` invocation (no "run"
+ * needed), so this can't be fixed by requiring "run" — only by excluding
+ * words that are clearly prose continuations, not script names.
+ */
+const ENGLISH_FILLER_WORDS = new Set([
+    'instead', 'of', 'packages', 'package', 'are', 'is', 'the', 'a', 'an',
+    'that', 'this', 'for', 'to', 'and', 'or', 'not', 'with', 'without', 'via',
+    'because', 'since', 'before', 'after', 'than', 'as', 'like', 'but', 'so',
+]);
+/** Extracts a user-defined script name from a pm run command, or null. */
+function extractScriptName(command) {
+    const match = /\b(?:pnpm|npm|yarn|bun)\s+(?:run\s+)?([a-z0-9][a-z0-9:_-]*)\b/i.exec(command);
+    if (!match)
+        return null;
+    const name = match[1].toLowerCase();
+    if (STANDARD_SUBCOMMANDS.has(name) || ENGLISH_FILLER_WORDS.has(name))
+        return null;
+    return name;
+}
+// ── Check 1: CI runs a task that instructions do not mention ──────────────────
+/**
+ * Flags tasks that CI enforces (lint, typecheck, test, build) but that no
+ * instruction file directs the agent to run.
+ *
+ * Only emits findings when at least one workflow file exists.
+ */
+function checkMissingCiTasks(context) {
+    const { workflows, files } = context;
+    if (workflows.files.length === 0)
+        return [];
+    // Collect tasks from ALL CI commands, handling && and multi-line blocks.
+    const ciTasks = new Map();
+    for (const wc of workflows.commands) {
+        for (const task of identifyTasksInCommand(wc.command)) {
+            if (!ciTasks.has(task))
+                ciTasks.set(task, []);
+            ciTasks.get(task).push(wc);
+        }
+    }
+    const issues = [];
+    for (const [task, wcs] of ciTasks.entries()) {
+        if (isTaskInstructed(task, files))
+            continue;
+        const sourceFiles = [...new Set(wcs.map((wc) => wc.filePath))];
+        issues.push({
+            id: issueId(`missing-ci-task:${task}`),
+            severity: 'warning',
+            category: 'missing_context',
+            title: `CI runs \`${task}\` but no instruction file appears to include it`,
+            summary: `The GitHub workflow${sourceFiles.length > 1 ? 's' : ''} (${sourceFiles.join(', ')}) ` +
+                `run \`${task}\`, but no instruction file appears to direct the agent to run this step ` +
+                `locally. Agents that follow only the instruction files may skip \`${task}\` and miss ` +
+                `failures before declaring work complete.`,
+            filePaths: files.map((f) => f.path),
+            locations: wcs.map((wc) => ({ filePath: wc.filePath, startLine: wc.line })),
+            evidence: wcs.map((wc) => `CI command: \`${wc.command}\` in ${wc.filePath} (line ${wc.line})`),
+            recommendation: `Consider adding \`${task}\` to the verification loop in the relevant instruction ` +
+                `file (e.g., AGENTS.md or CLAUDE.md) so agents run the same checks as CI.`,
+            confidence: 0.8,
+        });
+    }
+    return issues;
+}
+// ── Check 2: CI uses a different package manager than instructions ─────────────
+/**
+ * Flags when instruction files direct the agent to use a different package
+ * manager than the one CI workflows actually use.
+ *
+ * Only emits findings when at least one workflow file exists and CI commands
+ * mention a package manager.
+ */
+function checkCiPackageManagerMismatch(context) {
+    const { workflows, files, packageJson } = context;
+    if (workflows.files.length === 0)
+        return [];
+    const ciPms = collectCiPackageManagers(workflows.commands);
+    if (ciPms.size === 0)
+        return [];
+    // Determine the project's preferred PM: package.json field > lockfile > CI
+    const preferredPm = packageJson.packageManagerName !== 'unknown'
+        ? packageJson.packageManagerName
+        : Array.from(ciPms)[0];
+    if (!ciPms.has(preferredPm))
+        return [];
+    const issues = [];
+    for (const file of files) {
+        for (const pm of ['npm', 'pnpm', 'yarn', 'bun']) {
+            if (pm === preferredPm)
+                continue;
+            // Only match positive command usage (not negation lines)
+            const re = new RegExp(`\\b${pm}\\s+(?:install|add|run|exec|dlx|i)\\b`, 'gi');
+            let match;
+            let positiveHit = false;
+            while ((match = re.exec(file.content)) !== null) {
+                const lineStart = file.content.lastIndexOf('\n', match.index - 1) + 1;
+                const lineEnd = file.content.indexOf('\n', match.index);
+                const line = file.content.slice(lineStart, lineEnd === -1 ? undefined : lineEnd);
+                const isNegation = /\b(?:do\s+not|don'?t|avoid|never|not\s+use|refrain)\b/i.test(line);
+                if (!isNegation) {
+                    positiveHit = true;
+                    break;
+                }
+            }
+            if (!positiveHit)
+                continue;
+            issues.push({
+                id: issueId(`pm-mismatch-ci:${file.path}:${pm}`),
+                severity: 'warning',
+                category: 'conflict',
+                title: `Possible package manager mismatch: instructions use \`${pm}\` but CI uses \`${preferredPm}\``,
+                summary: `The instruction file appears to direct the agent to use \`${pm}\`, but the CI ` +
+                    `workflows use \`${preferredPm}\`. This may lead to lockfile conflicts or unexpected ` +
+                    `installation behaviour. Consider reviewing whether the instructions match the CI setup.`,
+                filePaths: [file.path],
+                locations: [{ filePath: file.path }],
+                evidence: [
+                    `CI workflows use: ${Array.from(ciPms).join(', ')}`,
+                    `Instruction file appears to use \`${pm}\``,
+                ],
+                recommendation: `Update the instruction file to use \`${preferredPm}\` commands to align with CI.`,
+                confidence: 0.85,
+            });
+        }
+    }
+    return issues;
+}
+// ── Check 3: Instructions reference a script absent from CI and manifest ────────
+/**
+ * Flags when an instruction file tells the agent to run a named package script
+ * that appears in neither package.json nor any CI workflow.  These commands
+ * would fail immediately if executed.
+ *
+ * Only applied when at least one workflow file exists (otherwise the CI-absent
+ * half of the signal is meaningless).
+ */
+function checkOrphanedInstructionScripts(context) {
+    const { workflows, files, packageJson, manifests } = context;
+    if (workflows.files.length === 0)
+        return [];
+    // CI3: manifest-consistency.ts's checkMissingScripts already flags any
+    // instruction reference to a script missing from package.json — regardless
+    // of whether the script is used in CI — and it runs whenever
+    // manifests.packageJson is present. Every finding THIS check produces
+    // requires that same "missing from package.json" condition (see the
+    // `!packageScripts.has(scriptName)` check below), so whenever
+    // manifest-consistency.ts is active, its check is a strict superset of
+    // this one — the same underlying gap was reported TWICE (different ids,
+    // both 'stale_instruction') whenever a workflow file also existed. Defer
+    // entirely to manifest-consistency.ts in that case; this check only adds
+    // value when there's no package.json for that detector to compare against.
+    if (manifests.packageJson)
+        return [];
+    const packageScripts = new Set(Object.keys(packageJson.scripts));
+    // Collect all script names CI actually runs
+    const ciScriptNames = new Set();
+    for (const wc of workflows.commands) {
+        for (const segment of splitCommand(wc.command)) {
+            const name = extractScriptName(segment);
+            if (name)
+                ciScriptNames.add(name);
+        }
+    }
+    const reported = new Set();
+    const issues = [];
+    for (const file of files) {
+        const runRe = /\b(?:npm|pnpm|yarn|bun)\s+(?:run\s+)?([a-z0-9][a-z0-9:_-]*)\b/gi;
+        let match;
+        while ((match = runRe.exec(file.content)) !== null) {
+            const scriptName = match[1].toLowerCase();
+            // CI2: also exclude common English prose continuations — see
+            // ENGLISH_FILLER_WORDS for why this can't be fixed by requiring "run".
+            if (STANDARD_SUBCOMMANDS.has(scriptName) || ENGLISH_FILLER_WORDS.has(scriptName))
+                continue;
+            if (!packageScripts.has(scriptName) && !ciScriptNames.has(scriptName)) {
+                const dedupeKey = `${file.path}:${scriptName}`;
+                if (reported.has(dedupeKey))
+                    continue;
+                reported.add(dedupeKey);
+                issues.push({
+                    id: issueId(`orphan-script:${file.path}:${scriptName}`),
+                    severity: 'warning',
+                    category: 'stale_instruction',
+                    title: `Possible reference to missing script: \`${scriptName}\` (not in CI or package.json)`,
+                    summary: `The instruction file appears to tell the agent to run \`${scriptName}\`, but this ` +
+                        `script does not appear in package.json and is not used in any CI workflow. ` +
+                        `This command may fail if executed. Consider reviewing whether the script name is current.`,
+                    filePaths: [file.path],
+                    locations: [{ filePath: file.path }],
+                    evidence: [
+                        `Found reference to \`${scriptName}\` in ${file.path}`,
+                        `Script not found in package.json scripts`,
+                        `Script not found in .github/workflows/*.yml`,
+                    ],
+                    recommendation: `Verify the script name. If it was renamed, update the instruction file. ` +
+                        `If it is a new script, add it to package.json.`,
+                    confidence: 0.8,
+                });
+            }
+        }
+    }
+    return issues;
+}
+// ── Public detector ───────────────────────────────────────────────────────────
+/**
+ * Entry point for the CI and Workflow Alignment detector.
+ *
+ * Returns an empty array when no workflow files exist so the detector never
+ * creates noise in repos without GitHub Actions.
+ */
+export function detectCiAlignment(context) {
+    if (context.workflows.files.length === 0)
+        return [];
+    return [
+        ...checkMissingCiTasks(context),
+        ...checkCiPackageManagerMismatch(context),
+        ...checkOrphanedInstructionScripts(context),
+    ];
+}
+//# sourceMappingURL=ci-alignment.js.map

package/dist/ci-alignment.js.map

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

package/dist/cli-output-filter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * CLI output filter detector for PromptCI.
+ *
+ * Checks whether instruction files include guidance on filtering verbose CLI
+ * output before it reaches the LLM context. Tools like RTK (Rust Token Killer)
+ * transparently proxy commands such as `npm test`, `git diff`, and `cargo test`,
+ * stripping boilerplate and keeping only signal — typically 60-90% token reduction
+ * on those commands.
+ *
+ * Only fires for non-trivial projects (>500 estimated instruction tokens) that
+ * have no existing output-filter guidance in any instruction file.
+ */
+import type { RepoContext } from './repo-context.js';
+import type { PromptCiIssue } from './types.js';
+export declare function detectCliOutputFilter(context: RepoContext): PromptCiIssue[];
+//# sourceMappingURL=cli-output-filter.d.ts.map

package/dist/cli-output-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-output-filter.d.ts","sourceRoot":"","sources":["../src/cli-output-filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA0BhD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,aAAa,EAAE,CA6D3E"}

package/dist/cli-output-filter.js

@@ -0,0 +1,88 @@
+/**
+ * CLI output filter detector for PromptCI.
+ *
+ * Checks whether instruction files include guidance on filtering verbose CLI
+ * output before it reaches the LLM context. Tools like RTK (Rust Token Killer)
+ * transparently proxy commands such as `npm test`, `git diff`, and `cargo test`,
+ * stripping boilerplate and keeping only signal — typically 60-90% token reduction
+ * on those commands.
+ *
+ * Only fires for non-trivial projects (>500 estimated instruction tokens) that
+ * have no existing output-filter guidance in any instruction file.
+ */
+// Signals that output-filter guidance already exists somewhere in the instructions.
+const FILTER_SIGNALS = [
+    /\brtk\b/i,
+    /rust\s+token\s+killer/i,
+    /output\s+filter/i,
+    /token[- ]optimized\s+(cli|command|output)/i,
+    /cli\s+proxy/i,
+    /filter.*command.*output/i,
+    /compact.*output/i,
+    /--failures[- ]only/i,
+];
+// Commands that produce high-token output and benefit most from filtering.
+// Used only to improve the evidence message — not a gate condition.
+const NOISY_COMMANDS = [
+    'npm test', 'npm run test', 'yarn test', 'pnpm test',
+    'jest', 'vitest', 'pytest', 'cargo test', 'go test', 'rspec',
+    'git diff', 'git log', 'git status',
+    'next build', 'npm run build', 'tsc',
+    'eslint', 'ruff check', 'cargo clippy', 'golangci-lint',
+    'docker logs', 'kubectl logs',
+    'gh pr list', 'gh run list',
+];
+export function detectCliOutputFilter(context) {
+    const { files, metrics } = context;
+    if (files.length === 0)
+        return [];
+    // Skip trivially small instruction sets — not worth the noise.
+    if (metrics.estimatedInstructionTokens < 500)
+        return [];
+    const combinedContent = files.map((f) => f.content).join('\n');
+    const hasFilterGuidance = FILTER_SIGNALS.some((pat) => pat.test(combinedContent));
+    if (hasFilterGuidance)
+        return [];
+    // Surface whichever noisy commands are referenced in instructions (for evidence).
+    const referencedNoisyCommands = NOISY_COMMANDS.filter((cmd) => combinedContent.toLowerCase().includes(cmd.toLowerCase()));
+    const evidenceLine = referencedNoisyCommands.length > 0
+        ? `Noisy commands referenced in instructions: ${referencedNoisyCommands.slice(0, 5).join(', ')}${referencedNoisyCommands.length > 5 ? ` (+${referencedNoisyCommands.length - 5} more)` : ''}.`
+        : 'No output-filter signals found across all instruction files.';
+    return [
+        {
+            id: 'cli-output-filter-missing',
+            severity: 'info',
+            category: 'agent_practices',
+            title: 'No CLI output filtering guidance',
+            summary: 'Instruction files contain no guidance on filtering verbose CLI output before it reaches ' +
+                'the LLM context. Commands like `npm test`, `git diff`, and `cargo test` can produce ' +
+                'hundreds of boilerplate lines. A CLI proxy such as RTK (Rust Token Killer) intercepts ' +
+                'these transparently and reduces token consumption by 60-90% on affected commands.',
+            filePaths: files.map((f) => f.path),
+            locations: [],
+            evidence: [evidenceLine],
+            recommendation: 'Install a CLI output filter (e.g. RTK: github.com/rtk-ai/rtk) and document it in your ' +
+                'instruction files. For Claude Code, `rtk init -g` installs a PreToolUse hook that ' +
+                'transparently rewrites Bash commands — no per-command changes needed.',
+            fixRecipe: [
+                '## CLI Output Filtering',
+                '',
+                'Use [RTK](https://github.com/rtk-ai/rtk) to reduce token consumption from verbose commands:',
+                '',
+                '```bash',
+                'brew install rtk                    # macOS',
+                '# or: cargo install --git https://github.com/rtk-ai/rtk',
+                'rtk init -g                         # Claude Code (PreToolUse hook)',
+                'rtk init -g --codex                 # Codex (AGENTS.md)',
+                'rtk init --agent antigravity        # Antigravity (project-scoped rules)',
+                '```',
+                '',
+                'The hook transparently rewrites `npm test` → `rtk npm test` (failures only),',
+                '`git diff` → `rtk git diff` (condensed), etc. Run `rtk gain` to see token savings.',
+            ].join('\n'),
+            confidence: 0.75,
+            impact: 'medium',
+        },
+    ];
+}
+//# sourceMappingURL=cli-output-filter.js.map

package/dist/cli-output-filter.js.map

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

package/dist/command-validity.d.ts

@@ -0,0 +1,12 @@
+import type { RepoContext } from './repo-context.js';
+import type { PromptCiIssue } from './types.js';
+/**
+ * Validates commands documented in instruction files against the repository's
+ * actual scripts and file structure.
+ *
+ * Returns findings only for high-confidence breakages — missing package
+ * scripts and missing file references.  Executable binary availability is
+ * out of scope.
+ */
+export declare function detectCommandValidity(context: RepoContext): PromptCiIssue[];
+//# sourceMappingURL=command-validity.d.ts.map

package/dist/command-validity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-validity.d.ts","sourceRoot":"","sources":["../src/command-validity.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA4hBhD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,aAAa,EAAE,CAkC3E"}