@freetesh/canon 0.15.0 → 0.17.0

package/cli/dist/standards.d.ts

@@ -4,11 +4,16 @@ export interface Standard {
     /** "canon" for a built-in default, else the configured folder it came from. */
     from: string;
 }
-/** canon's default standards, then each configured folder in order; a later file of the same name replaces an earlier one. */
-export declare function resolveStandards(canonRoot: string, folders: string[]): Standard[];
+/** The opt-in standards canon ships; a repo imports one by name under `standards:`. */
+export declare function libraryStandards(canonRoot: string): string[];
 /**
- * Principle headings from canon's constitution and every configured one. A
- * constitution in a folder extends rather than replaces: it adds principles,
- * and restating an ID rewords it.
+ * canon's defaults, then each `standards:` entry in order: a name imports canon's library
+ * standard, a folder adds its files. A later file of the same name replaces an earlier one.
  */
-export declare function constitutionTitles(canonRoot: string, folders: string[]): string[];
+export declare function resolveStandards(canonRoot: string, entries: string[]): Standard[];
+/**
+ * Principle headings from canon's constitution, every imported library standard
+ * and every configured folder's constitution. They extend rather than replace:
+ * each adds principles, and restating an ID rewords it.
+ */
+export declare function constitutionTitles(canonRoot: string, entries: string[]): string[];

package/cli/dist/standards.js

@@ -1,35 +1,55 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
+import { isStandardName } from "./config/schema.js";
 const NOT_STANDARDS = new Set(["README.md"]);
 const PRINCIPLE = /^### (C-\d{2}) (.+)$/;
 function markdownIn(dir) {
     return readdirSync(dir).filter((file) => file.endsWith(".md") && !NOT_STANDARDS.has(file));
 }
-/** canon's default standards, then each configured folder in order; a later file of the same name replaces an earlier one. */
-export function resolveStandards(canonRoot, folders) {
+/** The opt-in standards canon ships; a repo imports one by name under `standards:`. */
+export function libraryStandards(canonRoot) {
+    const dir = join(canonRoot, "standards", "library");
+    return existsSync(dir) ? markdownIn(dir).map((file) => file.replace(/\.md$/, "")).sort() : [];
+}
+function libraryFile(canonRoot, name) {
+    const path = join(canonRoot, "standards", "library", `${name}.md`);
+    if (!existsSync(path))
+        throw new Error(`no canon standard named ${name} — canon has: ${libraryStandards(canonRoot).join(", ")}`);
+    return path;
+}
+/**
+ * canon's defaults, then each `standards:` entry in order: a name imports canon's library
+ * standard, a folder adds its files. A later file of the same name replaces an earlier one.
+ */
+export function resolveStandards(canonRoot, entries) {
     const byName = new Map();
-    const sources = [{ dir: join(canonRoot, "standards"), from: "canon" }, ...folders.map((dir) => ({ dir, from: dir }))];
-    for (const { dir, from } of sources) {
-        if (!existsSync(dir))
-            throw new Error(`standards folder not found: ${dir}`);
-        for (const file of markdownIn(dir)) {
-            const name = file.replace(/\.md$/, "");
-            // Constitutions add up (see constitutionTitles), so each one keeps its own entry.
-            const key = name === "constitution" ? `${name}:${from}` : name;
-            byName.set(key, { name, path: join(dir, file), from });
+    const add = (name, path, from) => {
+        // Constitutions add up (see constitutionTitles), so each one keeps its own entry.
+        byName.set(name === "constitution" ? `${name}:${from}` : name, { name, path, from });
+    };
+    const defaults = join(canonRoot, "standards");
+    for (const entry of [defaults, ...entries]) {
+        if (isStandardName(entry)) {
+            add(entry, libraryFile(canonRoot, entry), "canon library");
+            continue;
         }
+        if (!existsSync(entry))
+            throw new Error(`standards folder not found: ${entry}`);
+        const from = entry === defaults ? "canon" : entry;
+        for (const file of markdownIn(entry))
+            add(file.replace(/\.md$/, ""), join(entry, file), from);
     }
     return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name) || Number(a.from !== "canon") - Number(b.from !== "canon"));
 }
 /**
- * Principle headings from canon's constitution and every configured one. A
- * constitution in a folder extends rather than replaces: it adds principles,
- * and restating an ID rewords it.
+ * Principle headings from canon's constitution, every imported library standard
+ * and every configured folder's constitution. They extend rather than replace:
+ * each adds principles, and restating an ID rewords it.
  */
-export function constitutionTitles(canonRoot, folders) {
+export function constitutionTitles(canonRoot, entries) {
     const titles = new Map();
-    for (const dir of [join(canonRoot, "standards"), ...folders]) {
-        const file = join(dir, "constitution.md");
+    const files = [join(canonRoot, "standards"), ...entries].map((entry) => isStandardName(entry) ? libraryFile(canonRoot, entry) : join(entry, "constitution.md"));
+    for (const file of files) {
         if (!existsSync(file))
             continue;
         for (const line of readFileSync(file, "utf8").split("\n")) {

package/cli/dist/status.d.ts

@@ -1,3 +1,3 @@
-import { type RunOptions } from "./run.ts";
+import { type RunOptions } from "./check.ts";
 export declare function canonVersion(canonRoot: string): string;
 export declare function buildStatus(repo: string, options: RunOptions): string;

package/cli/dist/status.js

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { loadConfig } from "./config/load.js";
-import { runChecks } from "./run.js";
+import { runChecks } from "./check.js";
 export function canonVersion(canonRoot) {
     const manifest = join(canonRoot, ".claude-plugin", "plugin.json");
     if (!existsSync(manifest))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@freetesh/canon",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "canon CLI: keep your domain knowledge and AI rules in your repo, and enforce them.",
   "license": "MIT",
   "author": "Ritesh Firodiya",
@@ -22,6 +22,7 @@
     "packs",
     "templates",
     "scripts/log-verdict.mjs",
+    "scripts/check-designs.py",
     ".claude-plugin"
   ],
   "engines": {
@@ -35,8 +36,7 @@
     "test": "vitest run --root cli",
     "coverage": "vitest run --root cli --coverage",
     "typecheck": "tsc -p cli",
-    "prepack": "pnpm build",
-    "release": "bash scripts/publish.sh"
+    "prepack": "pnpm build"
   },
   "dependencies": {
     "@clack/prompts": "^1.8.1",

package/packs/expo/pack.yaml

@@ -1,5 +1,5 @@
 name: expo
 description: Expo / React Native — versioned SDK docs
-kinds: [expo-app]
+kinds: [mobile]
 docs:
   - https://docs.expo.dev/llms.txt

package/packs/firebase/pack.yaml

@@ -1,5 +1,5 @@
 name: firebase
 description: Firebase — auth, Firestore, rules, functions
-kinds: [expo-app, web]
+kinds: [mobile, web]
 docs:
   - https://firebase.google.com/docs/llms.txt

package/packs/react/pack.yaml

@@ -1,5 +1,5 @@
 name: react
 description: React — components, hooks, rendering
-kinds: [expo-app, web]
+kinds: [mobile, web]
 docs:
   - https://react.dev/llms.txt

package/packs/revenuecat/pack.yaml

@@ -1,5 +1,5 @@
 name: revenuecat
 description: RevenueCat — subscriptions, paywalls, entitlements
-kinds: [expo-app, web]
+kinds: [mobile, web]
 docs:
   - https://www.revenuecat.com/docs/llms.txt

package/packs/uniwind/pack.yaml

@@ -1,5 +1,5 @@
 name: uniwind
 description: UniWind — Tailwind classes for React Native
-kinds: [expo-app]
+kinds: [mobile]
 docs:
   - https://docs.uniwind.dev/llms.txt