@freetesh/canon 0.15.0 → 0.17.0

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
     {
       "name": "canon",
       "source": "./",
-      "version": "0.15.0",
+      "version": "0.17.0",
       "description": "Keeps your domain knowledge and AI rules in your repos and enforces them, so Claude hallucinates less."
     }
   ],

package/.claude-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "canon",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "Keeps your domain knowledge and AI rules in your repos and enforces them, so Claude hallucinates less."
 }

package/README.md

@@ -47,9 +47,11 @@ is a separate paid product built on this CLI.
   listing tree, dead `.context/` paths, prices with no canonical home, shared
   files, the import architecture, pipeline gates, and every checker your config
   declares. `canon hooks install` makes every push run it.
-- **Standards with one home.** canon ships defaults; an estate adds or replaces
-  them from its own folder; a repo can override again. `canon standards` shows
-  what applies.
+- **Standards with one home.** canon ships defaults every repo follows, and a
+  library a repo imports by name (`standards: [design-sets, pipeline]`): design
+  sets, the build pipeline, Expo, frontend, performance, secrets, store listings.
+  A repo's own rules can sit in a folder it adds. `canon standards` shows what
+  applies.
 - **A repo names only what it uses.** Modules, packs and shared-file sets are
   opt-in; there is no skip list and no setting that turns a check off.
 
@@ -97,9 +99,9 @@ repo whose `canon.yaml` says `estate: true`, or `CANON_ESTATE`.
 ```yaml
 # <estate>/.claude/canon.yaml — shared by every repo below it
 estate: true
-standards: [.canon/standards]       # estate rules; same name replaces a canon default
 commands:                           # your own checkers, run by `canon check`
-  - { id: designs, run: ./scripts/check-designs.sh, if: .context/designs, module: design }
+  - { id: lint-copy, run: ./scripts/lint-copy.sh, if: .context/designs, module: design }
+  - { id: designs-first, run: test -d .context/designs, kinds: [mobile, web] }   # only repos that ship screens
 copies:                             # files products copy from one source repo, in named sets
   source: design-system
   sets:
@@ -110,8 +112,9 @@ copies:                             # files products copy from one source repo,
 
 ```yaml
 # <repo>/.claude/canon.yaml — written by `canon init`
-canon: 0.14.0
-kind: expo-app                      # expo-app | web | content
+canon: 0.17.0
+kind: mobile                        # mobile | web | mobile-and-web | package | content
+standards: [design-sets, pipeline, expo]   # canon's library standards this repo follows; ./rules adds a folder of its own
 modules: [docs, knowledge, code, listing, refs]
 packs: [expo]
 name: Acme                          # how the product is written; `named` copies swap it in
@@ -138,6 +141,20 @@ evals/            plugin evals and the fixture product
 cli/              the canon CLI (TypeScript, vitest); `@freetesh/canon/api` for tools built on it
 ```
 
+Inside `cli/src/`:
+
+```
+index.ts          the program: registers every command
+api.ts            what other tools import (`@freetesh/canon/api`)
+commands/         one file per command — options and output only
+checks/           one file per check, named by its id; index.ts lists them
+config/           .claude/canon.yaml: schema, layered loading, estate discovery
+lib/              shared helpers: files, frontmatter, env, qmd, system calls
+<name>.ts         the logic the commands call: check (+ format for its output), init, packs (add), sync, …
+```
+
+Tests mirror it in `cli/test/`.
+
 ## Develop
 
 `pnpm check` runs `canon check` on this repo, the typecheck and every test.

package/cli/dist/api.d.ts

@@ -1,3 +1,3 @@
 export { findEstate } from "./config/load.ts";
-export { findProducts } from "./run.ts";
-export { qmdQuery, qmdRefresh } from "./search/qmd.ts";
+export { findProducts } from "./check.ts";
+export { qmdQuery, qmdRefresh } from "./lib/qmd.ts";

package/cli/dist/api.js

@@ -1,4 +1,4 @@
 // What other tools build on: the canon knowledge site reads repos the way `canon check --all` finds them.
 export { findEstate } from "./config/load.js";
-export { findProducts } from "./run.js";
-export { qmdQuery, qmdRefresh } from "./search/qmd.js";
+export { findProducts } from "./check.js";
+export { qmdQuery, qmdRefresh } from "./lib/qmd.js";

package/cli/dist/checks/{external.js → commands.js}

@@ -1,6 +1,7 @@
 import { spawnSync } from "node:child_process";
 import { existsSync } from "node:fs";
 import { join } from "node:path";
+import { kindCovers } from "../config/schema.js";
 const MAX_OUTPUT_LINES = 15;
 function tail(text) {
     return text.trim().split("\n").slice(-MAX_OUTPUT_LINES).join("\n");
@@ -18,6 +19,7 @@ export const commandChecks = {
         return config.commands
             .filter((command) => !command.if || existsSync(join(repo, command.if)))
             .filter((command) => !command.module || config.modules.includes(command.module))
+            .filter((command) => !command.kinds || command.kinds.some((kind) => kindCovers(config.kind, kind)))
             .flatMap((command) => {
             const result = spawnSync("sh", ["-c", command.run], { cwd: repo, encoding: "utf8" });
             if (result.error) {

package/cli/dist/checks/designs.d.ts

@@ -0,0 +1,5 @@
+import type { Check } from "./types.ts";
+/** Every drawn surface: a folder under .context/designs/ with a routes.js manifest. */
+export declare function designSurfaces(repo: string): string[];
+/** Runs canon's design-set checker (scripts/check-designs.py) once per drawn surface. */
+export declare const designs: Check;

package/cli/dist/checks/designs.js

@@ -0,0 +1,33 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+const DESIGNS = ".context/designs";
+const MAX_OUTPUT_LINES = 15;
+/** Every drawn surface: a folder under .context/designs/ with a routes.js manifest. */
+export function designSurfaces(repo) {
+    const root = join(repo, DESIGNS);
+    if (!existsSync(root))
+        return [];
+    return readdirSync(root, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory() && existsSync(join(root, entry.name, "routes.js")))
+        .map((entry) => `${DESIGNS}/${entry.name}`)
+        .sort();
+}
+/** Runs canon's design-set checker (scripts/check-designs.py) once per drawn surface. */
+export const designs = {
+    id: "designs",
+    module: "design",
+    description: "every drawn surface follows the design-sets standard (scripts/check-designs.py)",
+    run({ repo, canonRoot }) {
+        const script = join(canonRoot, "scripts", "check-designs.py");
+        return designSurfaces(repo).flatMap((surface) => {
+            const result = spawnSync("python3", [script, surface], { cwd: repo, encoding: "utf8" });
+            if (result.error)
+                return [{ check: "designs", level: "error", file: surface, message: `could not run python3: ${result.error.message}` }];
+            if (result.status === 0)
+                return [];
+            const output = `${result.stdout}\n${result.stderr}`.trim().split("\n").slice(-MAX_OUTPUT_LINES).join("\n");
+            return [{ check: "designs", level: "error", file: surface, message: output }];
+        });
+    },
+};

package/cli/dist/checks/index.js

@@ -2,11 +2,13 @@ import { architecture } from "./architecture.js";
 import { canonicalValues } from "./canonical-values.js";
 import { contextLayout } from "./context-layout.js";
 import { contextSize } from "./context-size.js";
-import { staleCopies, standardsCopies } from "./copies.js";
-import { commandChecks } from "./external.js";
+import { staleCopies } from "./stale-copies.js";
+import { standardsCopies } from "./standards-copies.js";
+import { commandChecks } from "./commands.js";
+import { designs } from "./designs.js";
 import { features } from "./features.js";
 import { listing } from "./listing.js";
-import { metricsDefinitions } from "./metrics.js";
+import { metricsDefinitions } from "./metrics-definitions.js";
 import { pipeline } from "./pipeline.js";
 import { refs } from "./refs.js";
 import { sharedFiles } from "./shared-files.js";
@@ -29,5 +31,6 @@ export const ALL_CHECKS = [
     metricsDefinitions,
     sources,
     pipeline,
+    designs,
     commandChecks,
 ];

package/cli/dist/checks/stale-copies.d.ts

@@ -0,0 +1,2 @@
+import type { Check } from "./types.ts";
+export declare const staleCopies: Check;

package/cli/dist/checks/stale-copies.js

@@ -0,0 +1,18 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+// Instruction files for agents other than Claude Code. They are copies of
+// AGENTS.md that nobody reads, so they only drift.
+const OTHER_AGENT_FILES = [".github/copilot-instructions.md", ".cursorrules", ".windsurfrules"];
+export const staleCopies = {
+    id: "stale-copies",
+    module: null,
+    description: "no instruction files for agents that are not used (Copilot, Cursor, Windsurf)",
+    run({ repo }) {
+        return OTHER_AGENT_FILES.filter((file) => existsSync(join(repo, file))).map((file) => ({
+            check: "stale-copies",
+            level: "warn",
+            file,
+            message: "instructions for an agent not in use — delete, Claude reads AGENTS.md",
+        }));
+    },
+};

package/cli/dist/checks/{copies.d.ts → standards-copies.d.ts}

@@ -1,3 +1,2 @@
 import type { Check } from "./types.ts";
-export declare const staleCopies: Check;
 export declare const standardsCopies: Check;

package/cli/dist/checks/{copies.js → standards-copies.js}

@@ -1,25 +1,9 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
-// Instruction files for agents other than Claude Code. They are copies of
-// AGENTS.md that nobody reads, so they only drift.
-const OTHER_AGENT_FILES = [".github/copilot-instructions.md", ".cursorrules", ".windsurfrules"];
 // Fraction of a shared standard's lines that must appear in a product file
 // before it counts as a copy rather than a reference.
 const COPY_THRESHOLD = 0.6;
 const STANDARD_COPIES = [{ file: ".context/wiki/CLAUDE.md", standard: "standards/wiki-schema.md" }];
-export const staleCopies = {
-    id: "stale-copies",
-    module: null,
-    description: "no instruction files for agents that are not used (Copilot, Cursor, Windsurf)",
-    run({ repo }) {
-        return OTHER_AGENT_FILES.filter((file) => existsSync(join(repo, file))).map((file) => ({
-            check: "stale-copies",
-            level: "warn",
-            file,
-            message: "instructions for an agent not in use — delete, Claude reads AGENTS.md",
-        }));
-    },
-};
 function meaningfulLines(text) {
     return new Set(text
         .split("\n")

package/cli/dist/commands/add.d.ts

@@ -1,3 +1,3 @@
 import type { Command } from "commander";
-import { type Env } from "./env.ts";
+import { type Env } from "../lib/env.ts";
 export declare function registerAdd(program: Command, env: Env): void;

package/cli/dist/commands/add.js

@@ -1,7 +1,7 @@
 import { resolve } from "node:path";
 import { CACHE_DIR, fetchText, runCommand } from "../lib/system.js";
 import { addPack, fetchPackDocs, findPack, listPacks } from "../packs.js";
-import { requireEstate } from "./env.js";
+import { requireEstate } from "../lib/env.js";
 export function registerAdd(program, env) {
     program
         .command("add")

package/cli/dist/commands/check.d.ts

@@ -1,3 +1,3 @@
 import type { Command } from "commander";
-import { type Env } from "./env.ts";
+import { type Env } from "../lib/env.ts";
 export declare function registerCheck(program: Command, env: Env): void;

package/cli/dist/commands/check.js

@@ -1,7 +1,7 @@
 import { resolve } from "node:path";
 import { exitCode, formatReports } from "../format.js";
-import { findProducts, runChecks } from "../run.js";
-import { requireEstate } from "./env.js";
+import { findProducts, runChecks } from "../check.js";
+import { requireEstate } from "../lib/env.js";
 export function registerCheck(program, env) {
     program
         .command("check")

package/cli/dist/commands/copies.d.ts

@@ -1,3 +1,3 @@
 import type { Command } from "commander";
-import type { Env } from "./env.ts";
+import type { Env } from "../lib/env.ts";
 export declare function registerCopies(program: Command, env: Env): void;

package/cli/dist/commands/hooks.d.ts

@@ -1,5 +1,5 @@
 import type { Command } from "commander";
-import { type Env } from "./env.ts";
+import { type Env } from "../lib/env.ts";
 export declare const HOOK = "#!/bin/sh\n# installed by `canon hooks install` \u2014 run it again rather than editing this file.\n# A machine without canon pushes unchecked, as it would without any hook.\ncommand -v canon >/dev/null 2>&1 || exit 0\n# The product is the folder that owns .git, not the folder being pushed from: a worktree shares these hooks.\nroot=$(cd \"$(git rev-parse --git-common-dir)/..\" && pwd) || exit 0\nexec canon check \"$root\"\n";
 /** Writes the pre-push hook into one repo. Returns a one-line outcome. */
 export declare function installHook(repo: string): string;

package/cli/dist/commands/hooks.js

@@ -1,8 +1,8 @@
 import { spawnSync } from "node:child_process";
 import { chmodSync, existsSync, lstatSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { join, resolve } from "node:path";
-import { findProducts } from "../run.js";
-import { requireEstate } from "./env.js";
+import { findProducts } from "../check.js";
+import { requireEstate } from "../lib/env.js";
 const MARK = "installed by `canon hooks install`";
 // Hooks written by the tools this command replaced (the estate script, then zeno); they are ours to overwrite.
 const OLD_MARKS = [MARK, "installed by ~/git/bin/install-hooks", "installed by `zeno hooks install`"];

package/cli/dist/commands/init.d.ts

@@ -1,3 +1,3 @@
 import { type Command } from "commander";
-import type { Env } from "./env.ts";
+import type { Env } from "../lib/env.ts";
 export declare function registerInit(program: Command, env: Env): void;

package/cli/dist/commands/init.js

@@ -1,7 +1,7 @@
 import { basename, resolve } from "node:path";
 import * as prompts from "@clack/prompts";
 import { Option } from "commander";
-import { KINDS, MODULES } from "../config/schema.js";
+import { KINDS, kindCovers, MODULES } from "../config/schema.js";
 import { RULES_FILES } from "../checks/architecture.js";
 import { applyInit, parseChoices, planInit } from "../init.js";
 import { listPacks } from "../packs.js";
@@ -29,7 +29,7 @@ async function askAnswers(inferred, packs) {
     });
     if (cancelled(modules))
         return null;
-    const forKind = packs.filter((pack) => pack.kinds.includes(kind));
+    const forKind = packs.filter((pack) => pack.kinds.some((wanted) => kindCovers(kind, wanted)));
     if (forKind.length === 0)
         return { kind, modules, packs: [] };
     const chosen = await prompts.multiselect({

package/cli/dist/commands/learn.d.ts

@@ -1,3 +1,3 @@
 import type { Command } from "commander";
-import { type Env } from "./env.ts";
+import { type Env } from "../lib/env.ts";
 export declare function registerLearn(program: Command, env: Env): void;

package/cli/dist/commands/learn.js

@@ -1,6 +1,6 @@
 import { proposals, readDecisions, readVerdicts, recordDecision, summarise } from "../learn.js";
-import { findProducts } from "../run.js";
-import { requireEstate } from "./env.js";
+import { findProducts } from "../check.js";
+import { requireEstate } from "../lib/env.js";
 const DEFAULT_THRESHOLD = 3;
 export function registerLearn(program, env) {
     program

package/cli/dist/commands/pipeline.d.ts

@@ -1,3 +1,3 @@
 import type { Command } from "commander";
-import type { Env } from "./env.ts";
+import type { Env } from "../lib/env.ts";
 export declare function registerPipeline(program: Command, env: Env): void;

package/cli/dist/{search → commands}/search.js

@@ -1,4 +1,4 @@
-import { qmdQuery } from './qmd.js';
+import { qmdQuery } from '../lib/qmd.js';
 export function registerSearch(program) {
     program
         .command('search')

package/cli/dist/commands/standards.d.ts

@@ -1,3 +1,3 @@
 import type { Command } from "commander";
-import type { Env } from "./env.ts";
+import type { Env } from "../lib/env.ts";
 export declare function registerStandards(program: Command, env: Env): void;

package/cli/dist/commands/status.d.ts

@@ -1,3 +1,3 @@
 import type { Command } from "commander";
-import type { Env } from "./env.ts";
+import type { Env } from "../lib/env.ts";
 export declare function registerStatus(program: Command, env: Env): void;

package/cli/dist/commands/sync.d.ts

@@ -1,3 +1,3 @@
 import type { Command } from "commander";
-import type { Env } from "./env.ts";
+import type { Env } from "../lib/env.ts";
 export declare function registerSync(program: Command, env: Env): void;

package/cli/dist/commands/sync.js

@@ -1,7 +1,7 @@
 import { resolve } from "node:path";
 import { exitCode, formatReports } from "../format.js";
 import { CACHE_DIR, fetchText, runCommand } from "../lib/system.js";
-import { runChecks } from "../run.js";
+import { runChecks } from "../check.js";
 import { syncRepo } from "../sync.js";
 export function registerSync(program, env) {
     program

package/cli/dist/commands/ui.d.ts

@@ -1,3 +1,3 @@
 import type { Command } from "commander";
-import { type Env } from "./env.ts";
+import { type Env } from "../lib/env.ts";
 export declare function registerUi(program: Command, env: Env): void;

package/cli/dist/commands/ui.js

@@ -4,9 +4,9 @@ import { join } from "node:path";
 import { architectureGraph } from "../checks/architecture.js";
 import { formatReports } from "../format.js";
 import { CACHE_DIR } from "../lib/system.js";
-import { findProducts, runChecks } from "../run.js";
+import { findProducts, runChecks } from "../check.js";
 import { buildSite, quartzConfig } from "../ui.js";
-import { requireEstate } from "./env.js";
+import { requireEstate } from "../lib/env.js";
 // Quartz v5 has no tagged release yet, so pin the exact commit: an unpinned
 // clone could change the site under us on the next fresh install.
 const QUARTZ_REPO = "https://github.com/jackyzha0/quartz";

package/cli/dist/config/load.js

@@ -1,7 +1,7 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { parse } from "yaml";
-import { MODULES_BY_KIND, layerSchema } from "./schema.js";
+import { isStandardName, MODULES_BY_KIND, layerSchema } from "./schema.js";
 const EXPO_MARKERS = ["app.config.ts", "app.config.js", "app.json"];
 const WEB_MARKERS = ["next.config.ts", "next.config.js", "next.config.mjs", "vite.config.ts"];
 function configPath(folder) {
@@ -36,14 +36,26 @@ function appRoots(repo) {
     const children = readdirSync(apps, { withFileTypes: true }).filter((entry) => entry.isDirectory());
     return [repo, ...children.map((entry) => join(apps, entry.name))];
 }
+/** A root package.json that ships a CLI or exports a library. */
+function isPackage(repo) {
+    const file = join(repo, "package.json");
+    if (!existsSync(file))
+        return false;
+    const pkg = JSON.parse(readFileSync(file, "utf8"));
+    return Boolean(pkg.bin || pkg.exports || pkg.main) && !pkg.private;
+}
 export function inferKind(repo) {
     const roots = appRoots(repo);
     const anyHas = (markers) => roots.some((root) => markers.some((file) => existsSync(join(root, file))));
-    if (anyHas(EXPO_MARKERS))
-        return "expo-app";
-    if (anyHas(WEB_MARKERS))
+    const mobile = anyHas(EXPO_MARKERS);
+    const web = anyHas(WEB_MARKERS);
+    if (mobile && web)
+        return "mobile-and-web";
+    if (mobile)
+        return "mobile";
+    if (web)
         return "web";
-    return "content";
+    return isPackage(repo) ? "package" : "content";
 }
 export function inferModules(repo, kind) {
     const modules = MODULES_BY_KIND[kind];
@@ -82,7 +94,7 @@ export function loadConfig(repo, options = {}) {
         modules: lastDefined(pick("modules")) ?? inferModules(repo, kind),
         expo: Object.assign({}, ...pick("expo")),
         packs: [...new Set(pick("packs").flatMap((packs) => packs ?? []))].sort(),
-        standards: [...new Set(layers.flatMap((layer) => (layer.data.standards ?? []).map((dir) => resolve(layer.base, dir))))],
+        standards: [...new Set(layers.flatMap((layer) => (layer.data.standards ?? []).map((entry) => (isStandardName(entry) ? entry : resolve(layer.base, entry)))))],
         commands: mergeBy(pick("commands").map((list) => list ?? []), (command) => command.id),
         doctor: { tools: mergeBy(pick("doctor").map((doctor) => doctor?.tools ?? []), (tool) => tool.tool) },
         weigh: { weights: Object.assign({}, ...pick("weigh").map((weigh) => weigh?.weights)) },

package/cli/dist/config/schema.d.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
-export declare const KINDS: readonly ["expo-app", "web", "content"];
+/** What a repo ships: an app to the stores, a site to the web, both, a package to a registry, or no code at all. */
+export declare const KINDS: readonly ["mobile", "web", "mobile-and-web", "package", "content"];
 export declare const MODULES: readonly ["docs", "design", "knowledge", "metrics", "code", "architecture", "listing", "refs"];
 /**
  * The wiki page types every repo has, and the folder each lives in. A repo adds more under `wiki.types`.
@@ -10,6 +11,8 @@ export declare const WIKI_FOLDER_BY_TYPE: Record<string, string>;
 export declare const REMOVED_WIKI_FOLDERS: Record<string, string>;
 /** The `.context/` folders every repo may have. A repo adds more under `context.folders`. */
 export declare const CONTEXT_FOLDERS: string[];
+/** A `standards:` entry naming a library standard rather than a folder path. */
+export declare function isStandardName(entry: string): boolean;
 export type Kind = (typeof KINDS)[number];
 export type Module = (typeof MODULES)[number];
 declare const command: z.ZodObject<{
@@ -26,6 +29,13 @@ declare const command: z.ZodObject<{
         metrics: "metrics";
         refs: "refs";
     }>>;
+    kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        content: "content";
+        mobile: "mobile";
+        "mobile-and-web": "mobile-and-web";
+        package: "package";
+        web: "web";
+    }>>>;
 }, z.core.$strict>;
 declare const wikiType: z.ZodObject<{
     type: z.ZodString;
@@ -60,7 +70,9 @@ export declare const layerSchema: z.ZodObject<{
     canon: z.ZodOptional<z.ZodString>;
     kind: z.ZodOptional<z.ZodEnum<{
         content: "content";
-        "expo-app": "expo-app";
+        mobile: "mobile";
+        "mobile-and-web": "mobile-and-web";
+        package: "package";
         web: "web";
     }>>;
     modules: z.ZodOptional<z.ZodArray<z.ZodEnum<{
@@ -92,6 +104,13 @@ export declare const layerSchema: z.ZodObject<{
             metrics: "metrics";
             refs: "refs";
         }>>;
+        kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            content: "content";
+            mobile: "mobile";
+            "mobile-and-web": "mobile-and-web";
+            package: "package";
+            web: "web";
+        }>>>;
     }, z.core.$strict>>>;
     doctor: z.ZodOptional<z.ZodObject<{
         tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -150,7 +169,7 @@ export interface Config {
         sdk?: number;
     };
     packs: string[];
-    /** Absolute standards folders, estate first; a later file of the same name wins. */
+    /** Library standard names and absolute folders, estate first; a later file of the same name wins. */
     standards: string[];
     commands: CommandSpec[];
     doctor: {
@@ -178,4 +197,6 @@ export interface Config {
     };
 }
 export declare const MODULES_BY_KIND: Record<Kind, Module[]>;
+/** A repo that ships both counts as mobile and as web: it gets both kinds' packs. */
+export declare function kindCovers(kind: Kind, wanted: Kind): boolean;
 export {};

package/cli/dist/config/schema.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
-export const KINDS = ["expo-app", "web", "content"];
+/** What a repo ships: an app to the stores, a site to the web, both, a package to a registry, or no code at all. */
+export const KINDS = ["mobile", "web", "mobile-and-web", "package", "content"];
 export const MODULES = ["docs", "design", "knowledge", "metrics", "code", "architecture", "listing", "refs"];
 /**
  * The wiki page types every repo has, and the folder each lives in. A repo adds more under `wiki.types`.
@@ -18,6 +19,10 @@ export const REMOVED_WIKI_FOLDERS = {
 };
 /** The `.context/` folders every repo may have. A repo adds more under `context.folders`. */
 export const CONTEXT_FOLDERS = ["raw", "wiki", "features", "designs", "listing", "marketing", "metrics", "support", "legal", "ops"];
+/** A `standards:` entry naming a library standard rather than a folder path. */
+export function isStandardName(entry) {
+    return /^[a-z0-9-]+$/.test(entry);
+}
 const principleId = z.string().regex(/^C-\d{2}$/, "principle IDs look like C-07");
 const command = z
     .object({
@@ -28,6 +33,8 @@ const command = z
     if: z.string().optional(),
     /** Only run in a repo that uses this module. */
     module: z.enum(MODULES).optional(),
+    /** Only run in a repo of one of these kinds. */
+    kinds: z.array(z.enum(KINDS)).optional(),
 })
     .strict();
 const kebab = z.string().regex(/^[a-z0-9-]+$/, "use lowercase-kebab");
@@ -80,7 +87,7 @@ export const layerSchema = z
     modules: z.array(z.enum(MODULES)),
     expo: z.object({ sdk: z.number().int().positive() }).partial(),
     packs: z.array(z.string().regex(/^[a-z0-9-]+$/, "pack names are lowercase-kebab")),
-    /** Folders of extra standards, relative to the folder that holds `.claude/`. */
+    /** Standards to add: a bare name imports canon's library standard (`design-sets`); a path (`./rules`) is a folder of the repo's own. */
     standards: z.array(z.string()),
     commands: z.array(command),
     doctor: z.object({ tools: z.array(tool) }).partial(),
@@ -100,7 +107,14 @@ export const layerSchema = z
     .partial()
     .strict();
 export const MODULES_BY_KIND = {
-    "expo-app": ["docs", "knowledge", "code", "listing", "refs"],
+    mobile: ["docs", "knowledge", "code", "listing", "refs"],
     web: ["docs", "knowledge", "code", "refs"],
+    "mobile-and-web": ["docs", "knowledge", "code", "listing", "refs"],
+    // A package's docs describe other repos' .context/ paths, so refs would flag them.
+    package: ["docs", "knowledge", "code"],
     content: ["docs", "knowledge", "refs"],
 };
+/** A repo that ships both counts as mobile and as web: it gets both kinds' packs. */
+export function kindCovers(kind, wanted) {
+    return kind === wanted || (kind === "mobile-and-web" && (wanted === "mobile" || wanted === "web"));
+}

package/cli/dist/format.d.ts

@@ -1,4 +1,4 @@
-import type { Report } from "./run.ts";
+import type { Report } from "./check.ts";
 /** Compact, rtk-style text: one header per product, one line per finding, one total line. */
 export declare function formatReports(reports: Report[], options?: {
     quiet?: boolean;

package/cli/dist/index.js

@@ -16,8 +16,8 @@ import { registerSync } from "./commands/sync.js";
 import { registerUi } from "./commands/ui.js";
 import { registerWeigh } from "./commands/weigh.js";
 import { findEstate } from "./config/load.js";
-import { registerMcp } from "./search/mcp.js";
-import { registerSearch } from "./search/search.js";
+import { registerMcp } from "./commands/mcp.js";
+import { registerSearch } from "./commands/search.js";
 import { canonVersion } from "./status.js";
 const env = {
     canonRoot: resolve(import.meta.dirname, "..", ".."),

package/cli/dist/init.js

@@ -4,7 +4,7 @@ import { stringify } from "yaml";
 import { RULES_FILES } from "./checks/architecture.js";
 import { requiredContext } from "./checks/context-layout.js";
 import { inferKind, inferModules } from "./config/load.js";
-import { MODULES_BY_KIND } from "./config/schema.js";
+import { kindCovers, MODULES_BY_KIND } from "./config/schema.js";
 export const ARCHITECTURE_BASE = ".dependency-cruiser.base.cjs";
 const ARCHITECTURE_TEMPLATES = join("templates", "dependency-cruiser");
 const WORKSPACE_PARENTS = ["apps", "packages"];
@@ -86,7 +86,7 @@ export function planInit(repo, answers) {
     }
     const kind = answers.kind ?? inferKind(repo);
     const modules = answers.modules ?? (answers.kind ? MODULES_BY_KIND[kind] : inferModules(repo, kind));
-    const sdk = kind === "expo-app" ? detectExpoSdk(repo) : undefined;
+    const sdk = kindCovers(kind, "mobile") ? detectExpoSdk(repo) : undefined;
     const packs = answers.packs?.length ? { packs: answers.packs } : {};
     const config = { canon: answers.canonVersion, kind, modules, ...(sdk ? { expo: { sdk } } : {}), ...packs };
     const create = requiredContext(modules).filter((name) => !existsSync(join(repo, ".context", name))).map((name) => FIRST_FILE[name]);

package/cli/dist/packs.d.ts

@@ -4,7 +4,9 @@ declare const packSchema: z.ZodObject<{
     description: z.ZodString;
     kinds: z.ZodArray<z.ZodEnum<{
         content: "content";
-        "expo-app": "expo-app";
+        mobile: "mobile";
+        "mobile-and-web": "mobile-and-web";
+        package: "package";
         web: "web";
     }>>;
     skill: z.ZodOptional<z.ZodString>;