@ankhorage/devtools 1.12.0 → 1.12.1

package/README.md

@@ -188,7 +188,7 @@ The canonical workflow, VS Code, and skill files are packaged with `@ankhorage/d
 
 ## Managed agent instructions
 
-`ankh devtools agents sync` owns the repository-root `AGENTS.md`. The shared instructions are intentionally small and stable. The target repository's package name and description are rendered from `package.json`; the remaining content defines the unconditional current-architecture policy and directs structural work to the managed project-structure skill.
+`ankh devtools agents sync` owns the repository-root `AGENTS.md`. The shared instructions are intentionally small and stable. The target repository's package name and description are rendered from `package.json`; the remaining content defines the unconditional current-architecture policy, directs structural work to the managed project-structure skill, and requires the canonical build, type, lint, Knip, Changeset, and formatting commands before pull request creation.
 
 Only the current Ankhorage architecture is supported. Managed instructions reject deprecated APIs, compatibility aliases, shims, dual old/new paths, historical-state fallbacks, and migrations whose sole purpose is obsolete state. A canonical cross-package change requires affected repositories to update to the latest released public API.
 

package/dist/tools/agents/index.js

@@ -39,6 +39,19 @@ For directory ownership, package boundaries, architectural profiles, ports and a
 entrypoints, or cross-repository structural work, load and follow
 \`.agents/skills/ankhorage-project-structure/SKILL.md\`.
 
+## Pull requests
+
+Before creating a pull request, run all of these commands in this order and resolve every failure:
+
+\`\`\`sh
+bun run build
+bun run check-types
+bun run lint
+bun run knip:test
+bun run changeset
+bun run format
+\`\`\`
+
 ## Skill scripts
 
 Scripts inside an Agent Skill must always be TypeScript files with the \`.ts\` extension.

package/dist/tools/skills/assets/ankhorage-project-structure/SKILL.md

@@ -76,6 +76,7 @@ src/
       utils/
   types/
     <topic>.ts
+  constants.ts
   utils/
 ```
 
@@ -154,6 +155,26 @@ For example, `selectRoute.ts` can own a non-exported `SelectRouteInput` directly
 Types used by several local navigation operations belong together in `src/types/navigation.ts`.
 A navigation binding exchanged by Studio and Navigator belongs in `@ankhorage/contracts/navigator`.
 
+## Constant ownership
+
+Constants are static declarations, not utility implementations. Do not create one exported
+constant per constant-named file under `utils/`.
+
+1. **Used by one implementation module:** keep the constant private in the module that owns it.
+2. **Reused only inside a feature:** group related constants in that feature's `constants.ts`.
+3. **Shared across features in one package:** group related package metadata, static policy values,
+   and other constants in `src/constants.ts`.
+
+A `constants.ts` module may export multiple related constants. Keep it cohesive by ownership and
+purpose; it is not a package-wide catch-all. Split constants when they have different owners, not
+merely to create one file per export.
+
+For example, Navigator's
+[`src/utils/NAVIGATOR_PACKAGE_METADATA.ts`](https://github.com/ankhorage/navigator/blob/main/src/utils/NAVIGATOR_PACKAGE_METADATA.ts)
+and
+[`src/utils/NAVIGATOR_ROUTER_POLICY.ts`](https://github.com/ankhorage/navigator/blob/main/src/utils/NAVIGATOR_ROUTER_POLICY.ts)
+belong together in `ankhorage/navigator/src/constants.ts`.
+
 ## Utilities
 
 `utils/` is the only utility directory name. Do not create `shared/`, `helper/`, `helpers/`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/devtools",
-  "version": "1.12.0",
+  "version": "1.12.1",
   "description": "Shared development tools and repository standards for Ankhorage",
   "license": "MIT",
   "homepage": "https://github.com/ankhorage/devtools#readme",