@pixel-point/toolcraft 0.0.13 → 0.0.14

package/templates/starter/docs/toolcraft/workflow.md

@@ -17,22 +17,24 @@ Before planning or editing app code, runtime code, controls, canvas, panels, ren
 
 Do not edit implementation files until this preflight is complete.
 
+Core modules are required reading when listed by the routing table. Read each listed module fully. Do not rely on a truncated terminal excerpt; reopen the specific module or use a narrower range when a tool output is clipped.
+
 ## Task Routing
 
 Use the smallest reading set that covers the changed surface. If a task touches multiple surfaces, combine every matching row instead of picking only the closest one.
 
 | Task type | Read before editing |
 | --- | --- |
-| App assembly, route structure, generated app porting | `assembly-workflow.md`, `decision-contract.md` |
-| Reference app study, audit, or port | `assembly-workflow.md`, `schema-reference.md`, `acceptance-testing.md`, `decision-contract.md` |
-| Schema, controls, defaults, persistence, actions | `schema-reference.md`, `component-rules.md`, `acceptance-testing.md` |
-| Custom controls | `custom-controls.md`, `component-rules.md`, `acceptance-testing.md` |
-| Renderer, canvas output, visual technique | `renderer-technique.md`, `performance.md`, `acceptance-testing.md` |
-| Timeline, keyframes, animation transport | `decision-contract.md`, `component-rules.md`, `acceptance-testing.md`, `performance.md` |
-| Layers | `decision-contract.md`, `component-rules.md`, `acceptance-testing.md` |
-| Export, copy, media, background | `schema-reference.md`, `component-rules.md`, `acceptance-testing.md`, `performance.md` |
-| Broken control, visual mismatch, failed build, export bug, performance issue | `decision-contract.md`, the relevant component/runtime doc, and the failing test/log first |
-| Figma implementation | Use Figma MCP/design context, then `assembly-workflow.md` and the relevant component docs |
+| App assembly, route structure, generated app porting | `core/runtime-boundary.md`, `assembly-workflow.md`, `decision-contract.md` |
+| Reference app study, audit, or port | `core/reference-study.md`, `core/runtime-boundary.md`, `assembly-workflow.md`, `schema-reference.md`, `acceptance-testing.md`, `decision-contract.md` |
+| Schema, controls, defaults, persistence, actions | `core/control-selection.md`, `core/layout.md`, `schema-reference.md`, `component-rules.md`, `acceptance-testing.md` |
+| Custom controls | `core/control-selection.md`, `core/layout.md`, `custom-controls.md`, `component-rules.md`, `acceptance-testing.md` |
+| Renderer, canvas output, visual technique | `core/runtime-boundary.md`, `core/performance.md`, `renderer-technique.md`, `performance.md`, `acceptance-testing.md` |
+| Timeline, keyframes, animation transport | `core/timeline-animation.md`, `core/performance.md`, `decision-contract.md`, `component-rules.md`, `acceptance-testing.md` |
+| Layers | `core/runtime-boundary.md`, `core/layout.md`, `decision-contract.md`, `component-rules.md`, `acceptance-testing.md` |
+| Export, copy, media, background | `core/setup-export.md`, `core/media-upload.md`, `schema-reference.md`, `component-rules.md`, `acceptance-testing.md`, `performance.md` |
+| Broken control, visual mismatch, failed build, export bug, performance issue | `decision-contract.md`, the relevant `core/*` module, the relevant component/runtime doc, and the failing test/log first |
+| Figma implementation | Use Figma MCP/design context, then `core/reference-study.md`, `core/runtime-boundary.md`, `assembly-workflow.md`, and the relevant component docs |
 
 ## Worklog Gate
 

package/templates/starter/scripts/check-toolcraft-docs.mjs

@@ -19,6 +19,17 @@ const requiredDocs = [
   "component-rules.md",
 ];
 
+const requiredCoreDocs = [
+  "core/runtime-boundary.md",
+  "core/setup-export.md",
+  "core/control-selection.md",
+  "core/layout.md",
+  "core/media-upload.md",
+  "core/timeline-animation.md",
+  "core/performance.md",
+  "core/reference-study.md",
+];
+
 const requiredProjectFiles = ["LICENSE.md", "NOTICE.md"];
 
 const requiredRuleIds = [
@@ -43,17 +54,21 @@ const requiredRuleIds = [
   "workflow-required",
 ];
 
-const requiredAgentsLinks = [
+const requiredAgentsEntryLinks = [
   "workflow.md",
+  "core/",
+];
+
+const requiredWorkflowLinks = [
+  ...requiredCoreDocs,
   "assembly-workflow.md",
   "decision-contract.md",
   "schema-reference.md",
+  "component-rules.md",
   "acceptance-testing.md",
   "performance.md",
   "renderer-technique.md",
-  "agent-worklog.md",
   "custom-controls.md",
-  "component-rules.md",
 ];
 
 const requiredWorkflowTerms = [
@@ -90,7 +105,7 @@ async function fileExists(relativePath) {
 
 const failures = [];
 
-for (const fileName of requiredDocs) {
+for (const fileName of [...requiredDocs, ...requiredCoreDocs]) {
   const relativePath = `docs/toolcraft/${fileName}`;
 
   if (!(await fileExists(relativePath))) {
@@ -118,12 +133,13 @@ for (const ruleId of requiredRuleIds) {
   }
 }
 
-for (const fileName of requiredDocs) {
+for (const fileName of [...requiredDocs, ...requiredCoreDocs]) {
   const source = await readText(`docs/toolcraft/${fileName}`);
   docsSources.push(source);
 }
 
 const combinedSource = docsSources.join("\n");
+const workflowSource = await readText("docs/toolcraft/workflow.md");
 
 for (const pattern of forbiddenTextPatterns) {
   if (pattern.test(combinedSource)) {
@@ -131,12 +147,18 @@ for (const pattern of forbiddenTextPatterns) {
   }
 }
 
-for (const localDoc of requiredAgentsLinks) {
+for (const localDoc of requiredAgentsEntryLinks) {
   if (!agentsSource.includes(`docs/toolcraft/${localDoc}`)) {
     failures.push(`AGENTS.md must link docs/toolcraft/${localDoc}`);
   }
 }
 
+for (const localDoc of requiredWorkflowLinks) {
+  if (!workflowSource.includes(localDoc)) {
+    failures.push(`docs/toolcraft/workflow.md must route to ${localDoc}`);
+  }
+}
+
 for (const term of requiredWorkflowTerms) {
   if (!agentsSource.includes(term)) {
     failures.push(`AGENTS.md must mention "${term}"`);

package/templates/starter/src/app/starter-acceptance.test.ts

@@ -3190,19 +3190,20 @@ describe("Toolcraft template app acceptance coverage", () => {
   });
 
   it("documents control selection inventory and custom built-in fit checks", () => {
-    const schemaReference = readToolcraftDoc("schema-reference.md");
+    const coreControlSelection = readToolcraftDoc("core/control-selection.md");
     const componentRules = readToolcraftDoc("component-rules.md");
     const acceptanceTesting = readToolcraftDoc("acceptance-testing.md");
 
-    expect(schemaReference).toContain("Control Selection Inventory");
-    expect(schemaReference).toContain("Product need:");
-    expect(schemaReference).toContain("Candidate built-ins checked:");
-    expect(schemaReference).toContain("Rejected alternatives:");
+    expect(coreControlSelection).toContain("Control Selection Inventory");
+    expect(coreControlSelection).toContain("Product need:");
+    expect(coreControlSelection).toContain("Candidate built-ins checked:");
+    expect(coreControlSelection).toContain("Best built-in:");
+    expect(coreControlSelection).toContain("Rejected alternatives:");
+    expect(coreControlSelection).toContain("Target:");
+    expect(coreControlSelection).toContain("Custom Control Gate");
 
     expect(componentRules).toContain("Control Decision Catalog");
-    expect(componentRules).toContain("Exact owner");
-    expect(componentRules).toContain("Best fit");
-    expect(componentRules).toContain("Custom escape hatch");
+    expect(componentRules).toContain("core/control-selection.md");
 
     expect(acceptanceTesting).toContain("wrong-substitution");
     expect(acceptanceTesting).toContain("built-in fit check");