vigiles 2.0.0

package/action.yml

@@ -0,0 +1,25 @@
+name: "vigiles"
+description: "Compile typed specs to instruction files and verify integrity"
+branding:
+  icon: "check-circle"
+  color: "orange"
+
+inputs:
+  command:
+    description: "Command to run: 'compile' or 'audit' (default: audit)"
+    required: false
+    default: "audit"
+  paths:
+    description: "Comma-separated paths to .spec.ts files (compile) or .md files (audit). Auto-discovers by default."
+    required: false
+  max-rules:
+    description: "Maximum number of rules per spec file"
+    required: false
+  catalog-only:
+    description: "Only check that linter rules exist, skip config-enabled checks (true/false)"
+    required: false
+    default: "false"
+
+runs:
+  using: "node20"
+  main: "dist/action.js"

package/dist/action.d.ts

@@ -0,0 +1,7 @@
+/**
+ * GitHub Action entry point for vigiles.
+ *
+ * Runs `compile` or `audit` depending on the action input.
+ */
+export {};
+//# sourceMappingURL=action.d.ts.map

package/dist/action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/action.js

@@ -0,0 +1,180 @@
+"use strict";
+/**
+ * GitHub Action entry point for vigiles.
+ *
+ * Runs `compile` or `audit` depending on the action input.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_child_process_1 = require("node:child_process");
+const glob_1 = require("glob");
+const compile_js_1 = require("./compile.js");
+// ---------------------------------------------------------------------------
+// Read action inputs
+// ---------------------------------------------------------------------------
+const command = process.env["INPUT_COMMAND"] ?? "audit";
+const pathsInput = process.env["INPUT_PATHS"];
+const maxRulesInput = process.env["INPUT_MAX-RULES"] ?? process.env["INPUT_MAX_RULES"];
+const catalogOnly = (process.env["INPUT_CATALOG-ONLY"] ??
+    process.env["INPUT_CATALOG_ONLY"] ??
+    "false") === "true";
+const maxRules = maxRulesInput ? Number(maxRulesInput) : undefined;
+// ---------------------------------------------------------------------------
+// Spec loading (from compiled dist/)
+// ---------------------------------------------------------------------------
+async function loadSpec(specPath) {
+    // Try several resolution strategies:
+    // 1. Replace /src/ with /dist/ (standard TS project layout)
+    // 2. Look under dist/ directly (root-level specs like CLAUDE.md.spec.ts)
+    // 3. Use the .js extension in-place (pre-compiled specs)
+    const jsName = specPath.replace(/\.ts$/, ".js");
+    const candidates = [
+        (0, node_path_1.resolve)(process.cwd(), jsName.replace(/\/src\//, "/dist/")),
+        (0, node_path_1.resolve)(process.cwd(), "dist", jsName),
+        (0, node_path_1.resolve)(process.cwd(), jsName),
+    ];
+    // Deduplicate (candidate 1 and 3 may match when there's no /src/)
+    const unique = [...new Set(candidates)];
+    for (const distPath of unique) {
+        if (!(0, node_fs_1.existsSync)(distPath))
+            continue;
+        try {
+            const mod = (await import(distPath));
+            // CJS modules (TypeScript with module: "Node16", no "type":
+            // "module") produce `exports["default"] = spec`, so dynamic
+            // import wraps it as `{ default: { default: spec } }`. Unwrap
+            // the double-default when present.
+            const raw = mod.default;
+            if (raw && typeof raw === "object" && "default" in raw) {
+                return raw.default;
+            }
+            return raw;
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Commands
+// ---------------------------------------------------------------------------
+async function runCompile() {
+    const specs = pathsInput
+        ? pathsInput
+            .split(",")
+            .map((p) => p.trim())
+            .filter(Boolean)
+        : (0, glob_1.globSync)("**/*.spec.ts", { ignore: ["node_modules/**", "dist/**"] });
+    if (specs.length === 0) {
+        console.log("No .spec.ts files found.");
+        return true;
+    }
+    let allValid = true;
+    const basePath = process.cwd();
+    for (const specPath of specs) {
+        const spec = await loadSpec(specPath);
+        if (!spec) {
+            console.log(`::error file=${specPath}::Failed to load spec`);
+            allValid = false;
+            continue;
+        }
+        if (spec._specType === "claude") {
+            const primaryOutput = specPath.replace(/\.spec\.ts$/, "");
+            const { markdown, errors, targets } = (0, compile_js_1.compileClaude)(spec, {
+                basePath,
+                specFile: specPath,
+                maxRules,
+                catalogOnly,
+            });
+            if (errors.length > 0) {
+                for (const err of errors) {
+                    console.log(`::error file=${specPath}::${err.message}`);
+                }
+                allValid = false;
+            }
+            // Write primary target
+            (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(basePath, primaryOutput), markdown);
+            const outputNames = [primaryOutput];
+            // Write additional targets with swapped heading + recomputed hash
+            for (const t of targets.slice(1)) {
+                const body = markdown
+                    .replace(/^<!-- vigiles:[^\n]+\n\n?/, "")
+                    .replace(/^# [^\n]+/, `# ${t}`);
+                const additional = (0, compile_js_1.addHash)(body, specPath);
+                const dir = primaryOutput.substring(0, primaryOutput.lastIndexOf("/") + 1);
+                const targetPath = dir + t;
+                (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(basePath, targetPath), additional);
+                outputNames.push(targetPath);
+            }
+            console.log(`Compiled: ${specPath} → ${outputNames.join(", ")}`);
+        }
+        else if (spec._specType === "skill") {
+            const outputPath = specPath.replace(/\.spec\.ts$/, "");
+            const { markdown, errors } = (0, compile_js_1.compileSkill)(spec, {
+                basePath,
+                specFile: specPath,
+            });
+            if (errors.length > 0) {
+                for (const err of errors) {
+                    console.log(`::error file=${specPath}::${err.message}`);
+                }
+                allValid = false;
+            }
+            (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(basePath, outputPath), markdown);
+            console.log(`Compiled: ${specPath} → ${outputPath}`);
+        }
+    }
+    return allValid;
+}
+function runAudit() {
+    // Delegate to the CLI so the action always runs the full audit flow
+    // (hash verification, spec validation, duplicate detection, coverage
+    // report, strengthen suggestions). Previously this only ran
+    // checkFileHash, which silently skipped everything else.
+    const files = pathsInput
+        ? pathsInput
+            .split(",")
+            .map((p) => p.trim())
+            .filter(Boolean)
+        : [];
+    const cliPath = (0, node_path_1.resolve)(__dirname, "cli.js");
+    const args = ["audit", ...files];
+    const result = (0, node_child_process_1.spawnSync)(process.execPath, [cliPath, ...args], {
+        stdio: "inherit",
+        env: {
+            ...process.env,
+            // Ensure the CLI emits GitHub annotations during the action run
+            GITHUB_ACTIONS: process.env.GITHUB_ACTIONS ?? "true",
+        },
+    });
+    if (result.error) {
+        console.log(`::error::Failed to run vigiles audit: ${result.error.message}`);
+        return false;
+    }
+    // Exit codes: 0 clean, 1 warnings, 2 hard errors.
+    return result.status === 0;
+}
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+void (async () => {
+    let valid;
+    if (command === "compile") {
+        valid = await runCompile();
+    }
+    else if (command === "audit") {
+        valid = runAudit();
+    }
+    else {
+        console.log(`::error::Unknown vigiles command "${command}". Valid commands: compile, audit.`);
+        process.exit(1);
+    }
+    console.log(`::set-output name=valid::${String(valid)}`);
+    if (!valid) {
+        console.log("::error::vigiles failed — see errors above");
+        process.exit(1);
+    }
+})();
+//# sourceMappingURL=action.js.map

package/dist/action.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * vigiles CLI — compile typed specs to instruction files.
+ *
+ * Commands:
+ *   vigiles init            — scaffold a spec from scratch
+ *   vigiles compile         — compile .spec.ts → .md with linter verification
+ *   vigiles audit           — verify hashes, report coverage, detect duplicates
+ *   vigiles generate-types  — emit .d.ts with types from project state
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG"}