@csark0812/skeleton 1.5.7 → 1.6.0

package/dist/plugin-types.d.ts

@@ -75,19 +75,32 @@ export type MatchedPolicyEntry = CompiledPolicyEntry & { policyName: string };
 export interface ScanConfig {
 	include: string[];
 	exclude: string[];
-	banned: string[];
-	retiredSkills?: string[];
 	nonPublicSkills?: string[];
 }
 
+export interface DenyConfig {
+	paths?: string[];
+}
+
 export interface CustomizeConfig {
 	alwaysInclude?: string[];
 }
 
+export interface DocsLintConfig {
+	nearDuplicateThreshold?: number;
+	ssotOverlapMin?: number;
+	ssotBetterMatchMargin?: number;
+	ssotPhraseCheck?: boolean;
+	ignorePairs?: [string, string][];
+	ignoreGlobs?: string[];
+}
+
 export interface SkeletonConfig {
 	scan: ScanConfig;
 	daysUntilStale: number;
+	deny?: DenyConfig;
 	customize?: CustomizeConfig;
+	docsLint?: DocsLintConfig;
 	plugins?: string[];
 	draftPathPrefixes?: string[];
 }
@@ -107,9 +120,12 @@ export interface AuditContext {
 	config: SkeletonConfig;
 	files: string[];
 	docMetaPaths: string[];
+	ssotEntries: Array<{ path: string; summary: string; form: string }>;
+	ssotErrors: Array<{ path: string; kind: string; detail: string }>;
+	/** @deprecated Prefer ssotEntries */
 	registryPaths: string[];
+	/** @deprecated Always false */
 	registryHasTableHeader: boolean;
-	retiredSkills: Set<string>;
 	skillIndex: SkillIndex;
 	policies: PolicyFile[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@csark0812/skeleton",
-	"version": "1.5.7",
+	"version": "1.6.0",
 	"description": "SSOT audit CLI for agent harness repos",
 	"type": "module",
 	"bin": {
@@ -63,20 +63,17 @@
 		"github-slugger": "^2.0.0",
 		"remark": "^15.0.1",
 		"remark-gfm": "^4.0.1",
+		"smol-toml": "^1.8.0",
 		"tinyglobby": "^0.2.14",
 		"unist-util-visit": "^5.0.0",
 		"yaml": "^2.8.0"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "2.5.6",
+		"@biomejs/biome": "^2.5.3",
 		"@cursor/sdk": "^1.0.23",
 		"@post-print/agent-test": "^0.2.7",
 		"@types/bun": "^1.3.8",
 		"@types/github-slugger": "^2.0.0",
 		"typescript": "~7.0.2"
-	},
-	"overrides": {
-		"undici": ">=6.23.0",
-		"fast-uri": ">=3.1.4"
 	}
 }

package/schemas/config.schema.json

@@ -9,7 +9,7 @@
 		"scan": {
 			"type": "object",
 			"additionalProperties": false,
-			"required": ["include", "exclude", "banned"],
+			"required": ["include", "exclude"],
 			"properties": {
 				"include": {
 					"type": "array",
@@ -20,14 +20,6 @@
 					"type": "array",
 					"items": { "type": "string" }
 				},
-				"banned": {
-					"type": "array",
-					"items": { "type": "string" }
-				},
-				"retiredSkills": {
-					"type": "array",
-					"items": { "type": "string", "pattern": "^[a-z0-9-]+$" }
-				},
 				"nonPublicSkills": {
 					"type": "array",
 					"items": { "type": "string", "pattern": "^[a-z0-9-]+$" },
@@ -35,10 +27,66 @@
 				}
 			}
 		},
+		"deny": {
+			"type": "object",
+			"additionalProperties": false,
+			"description": "Path denylist — matching files must not exist in the repo",
+			"properties": {
+				"paths": {
+					"type": "array",
+					"items": { "type": "string" },
+					"description": "Repo-wide globs that must not exist (often outside scan.include)"
+				}
+			}
+		},
 		"daysUntilStale": {
 			"type": "integer",
 			"minimum": 1
 		},
+		"docsLint": {
+			"type": "object",
+			"additionalProperties": false,
+			"description": "Near-duplicate and SSOT-summary lint tunables",
+			"properties": {
+				"nearDuplicateThreshold": {
+					"type": "number",
+					"minimum": 0,
+					"maximum": 1,
+					"description": "Jaccard threshold on word shingles (default 0.72)"
+				},
+				"ssotOverlapMin": {
+					"type": "number",
+					"minimum": 0,
+					"maximum": 1,
+					"description": "Min fraction of SSOT tokens that must appear in H1/lead/body evidence (default 0.35)"
+				},
+				"ssotBetterMatchMargin": {
+					"type": "number",
+					"minimum": 0,
+					"maximum": 1,
+					"description": "Margin by which another file must beat own overlap for better-match warn (default 0.15)"
+				},
+				"ssotPhraseCheck": {
+					"type": "boolean",
+					"description": "When overlap fails, mention missing SSOT phrase in the message (default true)"
+				},
+				"ignorePairs": {
+					"type": "array",
+					"items": {
+						"type": "array",
+						"items": { "type": "string", "minLength": 1 },
+						"minItems": 2,
+						"maxItems": 2
+					},
+					"description": "Repo-relative path pairs skipped by near-dupe / duplicate-SSOT checks"
+				},
+				"ignoreGlobs": {
+					"type": "array",
+					"items": { "type": "string", "minLength": 1 },
+					"description": "Globs excluded from near-dupe / duplicate-SSOT"
+				}
+			}
+		},
 		"customize": {
 			"type": "object",
 			"additionalProperties": false,

package/templates/skeleton-init/config.yaml

@@ -1,17 +1,18 @@
 # yaml-language-server: $schema=node_modules/@csark0812/skeleton/schemas/config.schema.json
+# Legacy path — prefer skeleton.toml at repo root.
 
 scan:
   include:
     - "docs/**"
     - "README.md"
-    - ".skeleton/registry.md"
     - "AGENTS.md"
   exclude:
     - "refs/**"
-  banned: []
-  retiredSkills: []
 
-daysUntilStale: 180
+deny:
+  paths: []
+
+daysUntilStale: 365
 
 # Optional: basenames under .skeleton/customize/ appended on every skill inject
 # customize:

package/templates/skeleton-init/skeleton.toml

@@ -0,0 +1,37 @@
+# https://github.com/csark0812/skeleton — root config (preferred over .skeleton/config.yaml)
+
+daysUntilStale = 365
+
+[scan]
+include = [
+  "docs/**",
+  "README.md",
+  "AGENTS.md",
+]
+exclude = [
+  "refs/**",
+]
+
+[deny]
+paths = []
+
+# Optional: basenames under .skeleton/customize/ appended on every skill inject
+# [customize]
+# alwaysInclude = ["shared-agent-references.md"]
+
+# Optional: near-dupe / SSOT-summary tunables
+# [docsLint]
+# nearDuplicateThreshold = 0.72
+# ssotOverlapMin = 0.35
+# ignoreGlobs = ["docs/changelog/**"]
+
+# Optional: skill body ownership (skills-lock.json github entries are foreign by default)
+# [skillOwnership]
+# lockfile = "skills-lock.json"
+# ownedSlugs = []
+# foreignSlugs = []
+
+# Optional: plugin `.ts` entries relative to .skeleton/ (built sibling `.mjs` required)
+# plugins = []
+# Optional: draft-marker allow-list prefixes (plus `_draft-*.md` filenames)
+# draftPathPrefixes = []

package/templates/skeleton-init/registry.md

@@ -1,10 +0,0 @@
-# Registry
-
-<!-- doc-meta: owner=eng | last-reviewed=2026-07-11 -->
-
-**Source of truth for** topic routing in this repo. Edit rows here; edit content in canonical files only.
-
-## Documentation
-
-| Topic | Canonical file |
-|-------|------------------|