@csark0812/skeleton 1.6.2 → 2.0.0

package/dist/audit/fix/doc-meta.d.ts

@@ -0,0 +1,4 @@
+import type { AuditContext } from "../core/context.ts";
+import type { FixEdit } from "../core/fix.ts";
+export declare function bumpDocMetaLastReviewed(content: string, gitDate: string): string | null;
+export declare function collectDocMetaFixes(ctx: AuditContext): FixEdit[];

package/dist/audit/fix/match-anchor.d.ts

@@ -0,0 +1,8 @@
+export declare const ANCHOR_MATCH_MIN_SCORE: number;
+export declare const ANCHOR_MATCH_MIN_MARGIN = 0.15;
+export interface AnchorMatch {
+    slug: string;
+    score: number;
+}
+export declare function scoreAnchorMatch(brokenSlug: string, candidateSlug: string): number;
+export declare function findBestAnchorMatch(brokenSlug: string, candidates: Iterable<string>): AnchorMatch | null;

package/dist/audit/fix/ssot.d.ts

@@ -0,0 +1,3 @@
+import type { AuditContext } from "../core/context.ts";
+import type { FixEdit } from "../core/fix.ts";
+export declare function collectSsotFixes(ctx: AuditContext): FixEdit[];

package/dist/audit/policies/load.d.ts

@@ -0,0 +1,13 @@
+import type { MatchedPolicyEntry, PolicyEntry, PolicyFile } from "./types.ts";
+/**
+ * Compile YAML entries. Matching is case-insensitive by default. The legacy
+ * `skill-hub-duplication` name remains case-sensitive for 1.x compatibility;
+ * new policies must use the explicit `caseSensitive` field.
+ */
+export declare function compilePolicy(name: string, raw: PolicyEntry[]): PolicyFile;
+/** Make sure that every non-regex policy has an installed evaluator. */
+export declare function assertPolicyHandlers(policies: PolicyFile[], rules: Array<{
+    id: string;
+}>): void;
+export declare function loadPolicyFile(absPath: string, content: string): PolicyFile;
+export declare function policiesForFile(policies: PolicyFile[], relPath: string): MatchedPolicyEntry[];

package/dist/audit/policies/types.d.ts

@@ -0,0 +1,46 @@
+import type { Severity } from "../core/report.ts";
+interface PolicyEntryBase {
+    id: string;
+    message: string;
+    scope?: string;
+    severity?: Severity;
+    canonical?: string;
+    /** Match regex bytes exactly when true. Default: false. */
+    caseSensitive?: boolean;
+    /** Restrict a matched marker to configured draft locations. */
+    placement?: "any" | "draft-only";
+}
+export type PolicyEntry = (PolicyEntryBase & {
+    mode?: "pattern";
+    pattern: string;
+}) | (PolicyEntryBase & {
+    mode: "fingerprint";
+    pattern?: string;
+    /** Audit rule id that evaluates this non-regex entry. */
+    handledBy: string;
+});
+export interface CompiledPolicyEntry {
+    id: string;
+    message: string;
+    mode: "pattern" | "fingerprint";
+    pattern?: string;
+    scope?: string;
+    severity?: Severity;
+    canonical?: string;
+    caseSensitive?: boolean;
+    placement?: "any" | "draft-only";
+    handledBy?: string;
+    regex: RegExp | null;
+}
+export interface PolicyFile {
+    name: string;
+    entries: CompiledPolicyEntry[];
+}
+export interface PolicyFileYaml {
+    name: string;
+    entries: PolicyEntry[];
+}
+export type MatchedPolicyEntry = CompiledPolicyEntry & {
+    policyName: string;
+};
+export {};

package/dist/audit/rules/banned.d.ts

@@ -0,0 +1,7 @@
+import type { AuditContext } from "../core/context.ts";
+import { type Issue } from "../core/report.ts";
+export declare function runBannedRule(ctx: AuditContext): Issue[];
+export declare const bannedRule: {
+    id: string;
+    run: typeof runBannedRule;
+};

package/dist/audit/rules/code-fit.d.ts

@@ -0,0 +1,13 @@
+import type { AuditContext } from "../core/context.ts";
+import { type Issue } from "../core/report.ts";
+/**
+ * Docs↔code surface fit. Always discovers marked docs across the full scan
+ * perimeter (ignores path-filtered ctx.files) so code drift is still caught.
+ */
+export declare function runCodeFitRule(ctx: AuditContext): Issue[];
+/** Path-scoped suite membership, but alwaysRun so --paths does not skip it. */
+export declare const codeFitRule: {
+    id: string;
+    alwaysRun: boolean;
+    run: typeof runCodeFitRule;
+};

package/dist/audit/rules/doc-meta.d.ts

@@ -0,0 +1,8 @@
+import type { AuditContext } from "../core/context.ts";
+import { type Issue } from "../core/report.ts";
+export declare function gitFreshnessMessage(reviewedStr: string, gitDate: string): string;
+export declare function runDocMetaRule(ctx: AuditContext): Issue[];
+export declare const docMetaRule: {
+    id: string;
+    run: typeof runDocMetaRule;
+};

package/dist/audit/rules/index.d.ts

@@ -0,0 +1,26 @@
+import type { AuditContext } from "../core/context.ts";
+import type { Issue } from "../core/report.ts";
+export type AuditSuite = "docs" | "skills";
+export interface AuditRule {
+    id: string;
+    global?: boolean;
+    /**
+     * When true, still run under `--paths` / path-scoped validate (globals are skipped).
+     * Used by rules that must re-check the full scan corpus (e.g. code-fit markers).
+     */
+    alwaysRun?: boolean;
+    /** Which audit suites include this rule. Default: `["docs"]`. */
+    suites?: AuditSuite[];
+    run: (ctx: AuditContext) => Issue[];
+}
+export declare const docsRules: AuditRule[];
+export declare const skillsRules: AuditRule[];
+export declare const allRules: AuditRule[];
+export declare function assembleRules(pluginRules?: AuditRule[]): {
+    docs: AuditRule[];
+    skills: AuditRule[];
+    self: AuditRule[];
+};
+export declare function rulesForSuite(suite: string, pluginRules?: AuditRule[]): AuditRule[];
+export declare function globalRulesForSuite(suite: string, pluginRules?: AuditRule[]): AuditRule[];
+export declare function pathScopedRulesForSuite(suite: string, pluginRules?: AuditRule[]): AuditRule[];

package/dist/audit/rules/links.d.ts

@@ -0,0 +1,7 @@
+import type { AuditContext } from "../core/context.ts";
+import { type Issue } from "../core/report.ts";
+export declare function runLinksRule(ctx: AuditContext): Issue[];
+export declare const linksRule: {
+    id: string;
+    run: typeof runLinksRule;
+};

package/dist/audit/rules/near-duplicate.d.ts

@@ -0,0 +1,8 @@
+import type { AuditContext } from "../core/context.ts";
+import { type Issue } from "../core/report.ts";
+export declare function jaccard(a: Set<string>, b: Set<string>): number;
+export declare function runNearDuplicateRule(ctx: AuditContext): Issue[];
+export declare const nearDuplicateRule: {
+    id: string;
+    run: typeof runNearDuplicateRule;
+};

package/dist/audit/rules/prose-policy.d.ts

@@ -0,0 +1,7 @@
+import type { AuditContext } from "../core/context.ts";
+import { type Issue } from "../core/report.ts";
+export declare function runProsePolicyRule(ctx: AuditContext): Issue[];
+export declare const prosePolicyRule: {
+    id: string;
+    run: typeof runProsePolicyRule;
+};

package/dist/audit/rules/review-proof.d.ts

@@ -0,0 +1 @@
+export { reviewProofRule, runReviewProofRule } from "../core/review-proof.ts";

package/dist/audit/rules/scan-gaps.d.ts

@@ -0,0 +1,7 @@
+import type { AuditContext } from "../core/context.ts";
+import { type Issue } from "../core/report.ts";
+export declare function runCoverageGapsRule(ctx: AuditContext): Issue[];
+export declare const coverageGapsRule: {
+    id: string;
+    run: typeof runCoverageGapsRule;
+};

package/dist/audit/rules/scan-roots.d.ts

@@ -0,0 +1,7 @@
+import type { AuditContext } from "../core/context.ts";
+import { type Issue } from "../core/report.ts";
+export declare function runScanRootsRule(ctx: AuditContext): Issue[];
+export declare const scanRootsRule: {
+    id: string;
+    run: typeof runScanRootsRule;
+};

package/dist/audit/rules/skill-index.d.ts

@@ -0,0 +1,10 @@
+import type { AuditContext } from "../core/context.ts";
+import { type Issue } from "../core/report.ts";
+export declare function runSkillIndexRule(ctx: AuditContext): Issue[];
+export declare const skillIndexRule: {
+    id: string;
+    run: typeof runSkillIndexRule;
+};
+export declare function skillCountOnDisk(ctx: AuditContext): number;
+/** Success-suffix detail: owned audited vs foreign ignored. */
+export declare function skillAuditSuffix(ctx: AuditContext): string;

package/dist/audit/rules/ssot-summary.d.ts

@@ -0,0 +1,8 @@
+import type { AuditContext } from "../core/context.ts";
+import { type Issue } from "../core/report.ts";
+export declare function runSsotSummaryRule(ctx: AuditContext): Issue[];
+export declare const ssotSummaryRule: {
+    id: string;
+    run: typeof runSsotSummaryRule;
+};
+export { buildEvidenceText, ssotBodyOverlap, ssotEvidenceOverlap, } from "../core/ssot-fit.ts";

package/dist/audit/rules/ssot.d.ts

@@ -0,0 +1,7 @@
+import type { AuditContext } from "../core/context.ts";
+import { type Issue } from "../core/report.ts";
+export declare function runSsotRule(ctx: AuditContext): Issue[];
+export declare const ssotRule: {
+    id: string;
+    run: typeof runSsotRule;
+};