@csark0812/skeleton 1.1.3 → 1.5.0

package/dist/hooks/customize-on-skill-read.js

@@ -13241,7 +13241,13 @@ import { readFileSync as readFileSync4 } from "node:fs";
 var REGISTRY_REL_PATH = ".skeleton/registry.md";
 var REGISTRY_DIR_REL = ".skeleton";
 function normalizeRelPath(p) {
-  return p.replace(/\\/g, "/");
+  let out = p.replace(/\\/g, "/");
+  if (out.startsWith("/"))
+    return out;
+  while (out.startsWith("./")) {
+    out = out.slice(2);
+  }
+  return out;
 }
 
 // src/audit/core/skill-roots.ts
@@ -13354,6 +13360,23 @@ var $stringify = publicApi.stringify;
 var $visit = visit.visit;
 var $visitAsync = visit.visitAsync;
 
+// src/audit/core/draft.ts
+function normalizeDraftPrefix(prefix) {
+  const normalized = normalizeRelPath(prefix);
+  const withSlash = normalized.endsWith("/") ? normalized : `${normalized}/`;
+  if (withSlash === "/" || withSlash === "./") {
+    throw new Error(`Invalid draftPathPrefixes entry ${JSON.stringify(prefix)}: must be a repo-relative directory (e.g. drafts/), not ${JSON.stringify(prefix)}`);
+  }
+  return withSlash;
+}
+function validateDraftPathPrefixes(prefixes) {
+  if (!prefixes)
+    return;
+  for (const prefix of prefixes) {
+    normalizeDraftPrefix(prefix);
+  }
+}
+
 // src/audit/config/load.ts
 var SCHEMA_CANDIDATES = [
   join2(dirname(fileURLToPath(import.meta.url)), "../../../schemas/config.schema.json"),
@@ -13394,7 +13417,9 @@ function validateConfig(raw) {
     const detail = validate.errors?.map((e) => `${e.instancePath || "/"} ${e.message}`).join("; ");
     throw new Error(`Invalid .skeleton/config.yaml: ${detail ?? "schema validation failed"}`);
   }
-  return raw;
+  const config = raw;
+  validateDraftPathPrefixes(config.draftPathPrefixes);
+  return config;
 }
 function loadConfig(root) {
   const configPath = join2(root, ".skeleton", "config.yaml");

package/dist/plugin-types.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Public types for `@csark0812/skeleton/plugin-types`.
+ * Kept hand-written so publishes stay independent of `.ts` extension emit quirks.
+ */
+
+export type Severity = "error" | "warning";
+
+export interface Issue {
+	rule: string;
+	file: string;
+	link?: string;
+	message: string;
+	severity: Severity;
+}
+
+export declare function issue(
+	rule: string,
+	file: string,
+	message: string,
+	opts?: { link?: string; severity?: Severity },
+): Issue;
+
+export type AuditSuite = "docs" | "skills";
+
+export interface AuditRule {
+	id: string;
+	global?: boolean;
+	suites?: AuditSuite[];
+	run: (ctx: AuditContext) => Issue[];
+}
+
+export type PolicyEntry =
+	| {
+			id: string;
+			message: string;
+			mode?: "pattern";
+			pattern: string;
+			scope?: string;
+			severity?: Severity;
+			canonical?: string;
+	  }
+	| {
+			id: string;
+			message: string;
+			mode: "fingerprint";
+			pattern?: string;
+			scope?: string;
+			severity?: Severity;
+			canonical?: string;
+	  };
+
+export interface CompiledPolicyEntry {
+	id: string;
+	message: string;
+	mode: "pattern" | "fingerprint";
+	pattern?: string;
+	scope?: string;
+	severity?: Severity;
+	canonical?: 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 interface ScanConfig {
+	include: string[];
+	exclude: string[];
+	banned: string[];
+	retiredSkills?: string[];
+	nonPublicSkills?: string[];
+}
+
+export interface CustomizeConfig {
+	alwaysInclude?: string[];
+}
+
+export interface SkeletonConfig {
+	scan: ScanConfig;
+	daysUntilStale: number;
+	customize?: CustomizeConfig;
+	plugins?: string[];
+	draftPathPrefixes?: string[];
+}
+
+export interface SkillRoot {
+	kind: "nested" | "flat";
+	relPath: string;
+}
+
+export interface SkillIndex {
+	roots: SkillRoot[];
+	slugs: string[];
+}
+
+export interface AuditContext {
+	root: string;
+	config: SkeletonConfig;
+	files: string[];
+	docMetaPaths: string[];
+	registryPaths: string[];
+	registryHasTableHeader: boolean;
+	retiredSkills: Set<string>;
+	skillIndex: SkillIndex;
+	policies: PolicyFile[];
+}
+
+export declare function matchesGlobScope(relPath: string, scope: string | undefined): boolean;

package/dist/plugin-types.js

@@ -0,0 +1,41 @@
+// src/audit/core/report.ts
+function issue(rule, file, message, opts) {
+  return {
+    rule,
+    file,
+    link: opts?.link,
+    message,
+    severity: opts?.severity ?? "error"
+  };
+}
+// src/audit/core/shared.ts
+function normalizeRelPath(p) {
+  let out = p.replace(/\\/g, "/");
+  if (out.startsWith("/"))
+    return out;
+  while (out.startsWith("./")) {
+    out = out.slice(2);
+  }
+  return out;
+}
+function escapeRegexLiteral(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function globToRegex(glob) {
+  let pattern = glob.replace(/\\/g, "/");
+  pattern = pattern.replace(/\{([^}]+)\}/g, (_, inner) => {
+    const parts = inner.split(",").map((p) => escapeRegexLiteral(p.trim()));
+    return `(${parts.join("|")})`;
+  });
+  pattern = pattern.replace(/\*\*/g, "§§").replace(/\*/g, "[^/]*").replace(/§§/g, ".*").replace(/\?/g, "[^/]");
+  return new RegExp(`^${pattern}$`);
+}
+function matchesGlobScope(relPath, scope) {
+  if (!scope)
+    return true;
+  return globToRegex(scope).test(normalizeRelPath(relPath));
+}
+export {
+  matchesGlobScope,
+  issue
+};

package/package.json

@@ -1,23 +1,35 @@
 {
 	"name": "@csark0812/skeleton",
-	"version": "1.1.3",
+	"version": "1.5.0",
 	"description": "SSOT audit CLI for agent harness repos",
 	"type": "module",
 	"bin": {
 		"skeleton": "./dist/cli.js"
 	},
+	"exports": {
+		"./plugin-types": {
+			"types": "./dist/plugin-types.d.ts",
+			"default": "./dist/plugin-types.js"
+		},
+		"./schemas/config.schema.json": "./schemas/config.schema.json",
+		"./schemas/policy-file.schema.json": "./schemas/policy-file.schema.json"
+	},
 	"files": [
 		"dist",
 		"templates",
 		"schemas"
 	],
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/csark0812/skeleton.git"
+	},
 	"license": "MIT",
 	"engines": {
 		"node": ">=22"
 	},
 	"packageManager": "bun@1.2.21",
 	"scripts": {
-		"build": "bun build src/cli.ts --target=node --outfile=dist/cli.js && bun build src/hooks/customize-on-skill-read.ts --target=node --outfile=dist/hooks/customize-on-skill-read.js",
+		"build": "bun build src/cli.ts --target=node --outfile=dist/cli.js && bun build src/hooks/customize-on-skill-read.ts --target=node --outfile=dist/hooks/customize-on-skill-read.js && bun build src/plugin-types.ts --target=node --format=esm --outfile=dist/plugin-types.js --packages=external && cp types/plugin-types.d.ts dist/plugin-types.d.ts",
 		"test": "bun test",
 		"test:audit": "bun test src/audit/__tests__",
 		"test:cli": "bun test src/__tests__/cli",

package/schemas/config.schema.json

@@ -24,7 +24,7 @@
 					"type": "array",
 					"items": { "type": "string" }
 				},
-	"retiredSkills": {
+				"retiredSkills": {
 					"type": "array",
 					"items": { "type": "string", "pattern": "^[a-z0-9-]+$" }
 				},
@@ -58,7 +58,12 @@
 		"plugins": {
 			"type": "array",
 			"items": { "type": "string", "minLength": 1 },
-			"description": "Plugin entry paths relative to .skeleton/ (v1.5 — unused in v1)"
+			"description": "Plugin entry paths relative to .skeleton/; each entry must have a built sibling .mjs (run skeleton build-plugin)"
+		},
+		"draftPathPrefixes": {
+			"type": "array",
+			"items": { "type": "string", "minLength": 1 },
+			"description": "Allow-list directory prefixes for draft-marker prose-policy placement (plus _draft-*.md filenames). Trailing / is implied. Repo-relative only (e.g. drafts/) — not ., ./, or /. Not scan.exclude."
 		}
 	}
 }

package/schemas/policy-file.schema.json

@@ -0,0 +1,41 @@
+{
+	"$schema": "http://json-schema.org/draft-07/schema#",
+	"$id": "https://github.com/csark0812/skeleton/schemas/policy-file.schema.json",
+	"title": "Policy File",
+	"type": "object",
+	"required": ["name", "entries"],
+	"additionalProperties": false,
+	"properties": {
+		"name": {
+			"type": "string",
+			"description": "Policy set id (matches filename stem)"
+		},
+		"entries": {
+			"type": "array",
+			"minItems": 1,
+			"items": { "$ref": "#/$defs/policyEntry" }
+		}
+	},
+	"$defs": {
+		"policyEntry": {
+			"type": "object",
+			"required": ["id", "message"],
+			"additionalProperties": false,
+			"properties": {
+				"id": { "type": "string" },
+				"mode": { "enum": ["pattern", "fingerprint"] },
+				"pattern": { "type": "string" },
+				"message": { "type": "string" },
+				"scope": { "type": "string" },
+				"severity": { "enum": ["error", "warning"] },
+				"canonical": { "type": "string" }
+			},
+			"if": {
+				"properties": { "mode": { "const": "fingerprint" } },
+				"required": ["mode"]
+			},
+			"then": true,
+			"else": { "required": ["pattern"] }
+		}
+	}
+}

package/templates/skeleton-init/config.yaml

@@ -18,3 +18,7 @@ daysUntilStale: 180
 #   alwaysInclude:
 #     - shared-agent-references.md
 
+# Optional: plugin `.ts` entries relative to .skeleton/ (built sibling `.mjs` required)
+# plugins: []
+# Optional: draft-marker allow-list prefixes (plus `_draft-*.md` filenames)
+# draftPathPrefixes: []