@draekien/create-d9-app 0.0.0-stage → 0.0.1

package/templates/base/.intent/hooks/intent-codex-gate.mjs

@@ -0,0 +1,278 @@
+#!/usr/bin/env node
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs'
+import { execFileSync } from 'node:child_process'
+import { tmpdir } from 'node:os'
+import { dirname, join, relative, sep } from 'node:path'
+import { createHash } from 'node:crypto'
+import { performance } from 'node:perf_hooks'
+
+const AGENT = "codex"
+const CATALOG_COMMAND = "pnpm exec intent list --json --no-notices"
+const LOAD_COMMAND = "pnpm exec intent load <package>#<skill>"
+const EDIT_TOOLS = new Set(["Edit","Write","apply_patch"])
+const GATE_DENY_REASON = "Blocked: check TanStack guidance before editing. If a listed skill matches, load it, then retry the edit."
+const INTENT_INVOCATION_PATTERN = /(?:^|&&|\|\||;|\|)\s*((?:bunx\s+--no-install\s+--package\s+@tanstack\/intent\s+intent)|(?:npm\s+exec\s+--no\s+--\s+intent)|(?:yarn\s+exec\s+intent)|(?:bunx\s+@tanstack\/intent(?:@latest)?)|(?:pnpm\s+exec\s+intent)|(?:pnpm\s+dlx\s+@tanstack\/intent(?:@latest)?)|(?:npx\s+@tanstack\/intent(?:@latest)?)|(?:yarn\s+dlx\s+@tanstack\/intent(?:@latest)?)|(?:(?:[^\s|;&]*[\\/])?intent))\s+(list|load)(?:\s+([^\s|;&]+))?/i
+
+try {
+  await main()
+} catch {
+}
+
+process.exit(0)
+
+async function main() {
+  const event = readEventFromStdin()
+
+  if (isSessionStartEvent(event)) {
+    const stateFile = stateFileForEvent(event)
+    const additionalContext = await createSessionCatalogContext(rootForEvent(event))
+    appendObservation(stateFile, { action: 'list', raw: CATALOG_COMMAND })
+    if (additionalContext) {
+      process.stdout.write(JSON.stringify(sessionStartOutput(additionalContext)))
+    }
+    return
+  }
+
+  const stateFile = stateFileForEvent(event)
+  const observation = observationFromEvent(event)
+
+  if (observation) {
+    appendObservation(stateFile, observation)
+  }
+
+  const toolName = event?.tool_name ?? event?.toolName
+  if (typeof toolName === 'string' && EDIT_TOOLS.has(toolName) && !hasIntentCheck(stateFile)) {
+    process.stdout.write(JSON.stringify(denyOutput()))
+  }
+}
+
+function readEventFromStdin() {
+  try {
+    return JSON.parse(readFileSync(0, 'utf8'))
+  } catch {
+    return {}
+  }
+}
+
+function isSessionStartEvent(event) {
+  return (event?.hook_event_name ?? event?.hookEventName) === 'SessionStart'
+}
+
+function rootForEvent(event) {
+  return typeof event?.cwd === 'string' && event.cwd ? event.cwd : process.cwd()
+}
+
+async function createSessionCatalogContext(root) {
+  try {
+    const start = performance.now()
+    const localCli = resolveLocalIntentCli(root)
+    const result = readIntentList(root, localCli)
+    const durationMs = performance.now() - start
+    console.error(
+      `[intent-${AGENT}-session-catalog] listIntentSkills found ${result.skills.length} skills from ${result.packages.length} packages in ${formatDuration(durationMs)} (packageJsonReadCount=${result.debug?.scan.packageJsonReadCount ?? 'unknown'})`,
+    )
+    return formatSessionCatalog(result, loadCommandForLocalCli(root, localCli))
+  } catch {
+    return ''
+  }
+}
+
+// The package-manager runner in CATALOG_COMMAND (npx, pnpm dlx, ...) resolves
+// @tanstack/intent@latest against the registry on every run, which costs one
+// to four seconds per session start. When the project has the package
+// installed, run its CLI directly with this Node binary instead. Returns the
+// CLI path and the node_modules directory it was found in, or null.
+function resolveLocalIntentCli(root) {
+  let dir = root
+  let prev
+  while (dir !== prev) {
+    const nodeModulesDir = join(dir, 'node_modules')
+    const packageJsonPath = join(nodeModulesDir, '@tanstack', 'intent', 'package.json')
+    if (existsSync(packageJsonPath)) {
+      try {
+        const bin = JSON.parse(readFileSync(packageJsonPath, 'utf8')).bin
+        const relativeBin = typeof bin === 'string' ? bin : bin && bin.intent
+        if (typeof relativeBin === 'string') {
+          const cli = join(dirname(packageJsonPath), relativeBin)
+          if (existsSync(cli)) return { cli, nodeModulesDir }
+        }
+      } catch {
+      }
+      return null
+    }
+    prev = dir
+    dir = dirname(dir)
+  }
+  return null
+}
+
+// The load command shown to the agent. When the catalog came from a local
+// install that also has a bin shim, suggest that shim (same installation, no
+// registry lookup); otherwise suggest the package-manager runner.
+function loadCommandForLocalCli(root, localCli) {
+  if (!localCli) return LOAD_COMMAND
+  const bin = join(localCli.nodeModulesDir, '.bin', 'intent')
+  if (!existsSync(bin)) return LOAD_COMMAND
+  return relative(root, bin).split(sep).join('/') + ' load <package>#<skill>'
+}
+
+function readIntentList(root, localCli) {
+  const options = {
+    cwd: root,
+    encoding: 'utf8',
+    env: { ...process.env, INTENT_AUDIENCE: 'agent' },
+    maxBuffer: 1024 * 1024,
+    stdio: ['ignore', 'pipe', 'pipe'],
+    timeout: 9000,
+  }
+  const output = localCli
+    ? execFileSync(process.execPath, [localCli.cli, 'list', '--json', '--no-notices'], options)
+    : execFileSync(CATALOG_COMMAND, { ...options, shell: true })
+  return JSON.parse(output)
+}
+
+function formatDuration(durationMs) {
+  return `${durationMs.toFixed(1)}ms`
+}
+
+function formatSessionCatalog(result, loadCommand) {
+  if (!Array.isArray(result.skills) || result.skills.length === 0) return ''
+
+  return [
+    'TanStack Intent skills are available in this repository.',
+    '',
+    'These are Intent skills, not native agent skills.',
+    'Load a matching skill with: `' + loadCommand + '`.',
+    '',
+    'Before substantial work, check whether one listed skill clearly matches the user task. If one clearly matches, load that full skill guidance with the Intent CLI before proceeding.',
+    '',
+    'If no skill clearly matches, continue normally. Do not load a skill just to improve phrasing or gather nonessential context.',
+    '',
+    'Available local Intent skills:',
+    formatSkillCatalog(result.skills),
+    formatWarnings(result),
+  ]
+    .filter(Boolean)
+    .join('\n')
+}
+
+function formatSkillCatalog(skills) {
+  return skills
+    .map((skill) => `- ${skill.use}: ${normalizeDescription(skill.description)}`)
+    .join('\n')
+}
+
+function normalizeDescription(description) {
+  return typeof description === 'string' ? description.replace(/\s+/g, ' ').trim() : ''
+}
+
+function formatWarnings(result) {
+  const warnings = [
+    ...(Array.isArray(result.warnings) ? result.warnings : []),
+    ...(Array.isArray(result.conflicts)
+      ? result.conflicts.map(
+          (conflict) =>
+            `Version conflict for ${conflict.packageName}; using ${conflict.chosen.version}`,
+        )
+      : []),
+  ]
+
+  if (warnings.length === 0) return ''
+  return `\nWarnings:\n${warnings.map((warning) => `- ${warning}`).join('\n')}`
+}
+
+function sessionStartOutput(additionalContext) {
+  if (AGENT === 'copilot') {
+    return { additionalContext }
+  }
+
+  return {
+    hookSpecificOutput: {
+      hookEventName: 'SessionStart',
+      additionalContext,
+    },
+  }
+}
+
+function stateFileForEvent(event) {
+  const sessionId = typeof event?.session_id === 'string' ? event.session_id : 'unknown'
+  const cwd = typeof event?.cwd === 'string' ? event.cwd : process.cwd()
+  const key = createHash('sha256').update(AGENT + '\0' + cwd + '\0' + sessionId).digest('hex')
+  return join(tmpdir(), 'tanstack-intent-hooks', key + '.jsonl')
+}
+
+function parseIntentInvocation(command) {
+  if (typeof command !== 'string') return undefined
+  const match = command.match(INTENT_INVOCATION_PATTERN)
+  if (!match?.[1] || !match[2]) return undefined
+  const action = match[2].toLowerCase()
+  if (action !== 'list' && action !== 'load') return undefined
+  const skillUse = action === 'load' ? match[3] : undefined
+  if (action === 'load' && !skillUse) return undefined
+  return action === 'load' ? { action, skillUse } : { action }
+}
+
+function observationFromEvent(event) {
+  if (!event || typeof event !== 'object') return undefined
+  const toolName = event.tool_name ?? event.toolName
+  const toolInput = event.tool_input ?? event.toolArgs
+  if (toolName !== 'Bash') return undefined
+  const command = typeof toolInput === 'string' ? safeCommandFromString(toolInput) : commandFromObject(toolInput)
+  const parsed = parseIntentInvocation(command)
+  if (!parsed || typeof command !== 'string') return undefined
+  return { action: parsed.action, skillUse: parsed.skillUse, raw: command }
+}
+
+function commandFromObject(value) {
+  return value && typeof value === 'object' ? value.command : undefined
+}
+
+function safeCommandFromString(value) {
+  try {
+    const command = commandFromObject(JSON.parse(value))
+    return typeof command === 'string' ? command : value
+  } catch {
+    return value
+  }
+}
+
+function appendObservation(stateFile, observation) {
+  try {
+    mkdirSync(dirname(stateFile), { recursive: true })
+    appendFileSync(stateFile, JSON.stringify({ ts: new Date().toISOString(), ...observation }) + '\n')
+  } catch {
+  }
+}
+
+function hasIntentCheck(stateFile) {
+  if (!existsSync(stateFile)) return false
+  try {
+    return readFileSync(stateFile, 'utf8')
+      .split('\n')
+      .filter(Boolean)
+      .some((line) => {
+        try {
+          const action = JSON.parse(line).action
+          return action === 'list' || action === 'load'
+        } catch {
+          return false
+        }
+      })
+  } catch {
+    return false
+  }
+}
+
+function denyOutput() {
+  if (AGENT === 'copilot') {
+    return { permissionDecision: 'deny', permissionDecisionReason: GATE_DENY_REASON }
+  }
+
+  return {
+    hookSpecificOutput: {
+      hookEventName: 'PreToolUse',
+      permissionDecision: 'deny',
+      permissionDecisionReason: GATE_DENY_REASON,
+    },
+  }
+}

package/templates/base/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- intent-skills:start -->
+## Skill Loading
+
+Use the repository’s installed Intent. If it is unavailable, report the missing dependency instead of downloading a replacement.
+Before editing files for a substantial task:
+- Run `pnpm exec intent list` from the workspace root to see available local skills.
+- If a listed skill matches the task, run `pnpm exec intent load <package>#<skill>` before changing files.
+- Use the loaded `SKILL.md` guidance while making the change.
+- Monorepos: when working across packages, run the skill check from the workspace root and prefer the local skill for the package being changed.
+- Multiple matches: prefer the most specific local skill for the package or concern you are changing; load additional skills only when the task spans multiple packages or concerns.
+<!-- intent-skills:end -->
+
+# Project
+
+- Turborepo monorepo managed with pnpm. Apps in `apps/`, shared packages in `packages/`.
+- `apps/web`: TanStack Start on Vite, React, TypeScript, Vitest.
+- Run tasks from the repo root: `pnpm build`, `pnpm check`, `pnpm typecheck`, `pnpm test`, `pnpm dev`.
+- Dependency versions are exact. Never use `^`, `~` or `latest`.
+- Routes live in `apps/web/src/routes`. `routeTree.gen.ts` is generated; do not edit it.
+
+<!-- BEGIN:turborepo-agent-rules -->
+
+# This is NOT the Turborepo you know
+
+Turborepo configuration, task behavior, and CLI commands can vary between installed versions and may differ from your training data. Resolve the `turbo` package from this file's directory or relevant workspace; in monorepos, it may not be visible from the repository root. For example, run `node -p "require.resolve('turbo/package.json')"` from a workspace that depends on `turbo`.
+
+Read `docs/README.md` inside that installed package first, then read the relevant pages from its `docs/` directory before changing Turborepo configuration or commands. Heed deprecation notices. These bundled docs match the installed package version and are available without network access.
+<!-- END:turborepo-agent-rules -->

package/templates/base/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

package/templates/base/_gitignore

@@ -0,0 +1,7 @@
+node_modules
+dist
+.turbo
+.output
+.nitro
+.tanstack
+*.log

package/templates/base/apps/web/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "web",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite dev",
+    "build": "vite build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@tailwindcss/vite": "4.3.3",
+    "@tanstack/react-form": "1.33.5",
+    "@tanstack/react-hotkeys": "0.13.0",
+    "@tanstack/react-query": "5.104.1",
+    "@tanstack/react-router": "1.170.41",
+    "@tanstack/react-router-ssr-query": "1.167.3",
+    "@tanstack/react-start": "1.168.60",
+    "@tanstack/react-table": "9.2.8",
+    "@workspace/ui": "workspace:*",
+    "motion": "14.0.0",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "tailwindcss": "4.3.3"
+  },
+  "devDependencies": {
+    "@babel/core": "8.0.7",
+    "@rolldown/plugin-babel": "0.2.4",
+    "@types/node": "22.20.5",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
+    "@vitejs/plugin-react": "6.1.2",
+    "babel-plugin-react-compiler": "1.0.0",
+    "typescript": "7.0.2",
+    "vite": "8.3.4",
+    "vitest": "5.0.3"
+  }
+}

package/templates/base/apps/web/src/examples/form.test.tsx

@@ -0,0 +1,10 @@
+import { renderToString } from "react-dom/server"
+import { expect, it } from "vitest"
+import { FormExample } from "./form.tsx"
+
+it("renders the name field and submit button", () => {
+  const html = renderToString(<FormExample />)
+
+  expect(html).toContain('name="name"')
+  expect(html).toContain("Submit")
+})

package/templates/base/apps/web/src/examples/form.tsx

@@ -0,0 +1,35 @@
+import { useForm } from "@tanstack/react-form"
+import { useState } from "react"
+
+export function FormExample() {
+  const [submitted, setSubmitted] = useState("")
+  const form = useForm({
+    defaultValues: { name: "" },
+    onSubmit: ({ value }) => setSubmitted(value.name),
+  })
+
+  const handleSubmit = (event: React.SubmitEvent<HTMLFormElement>) => {
+    event.preventDefault()
+    form.handleSubmit()
+  }
+
+  return (
+    <form onSubmit={handleSubmit} className="flex flex-col items-center gap-2">
+      <form.Field name="name">
+        {(field) => (
+          <label className="flex gap-2">
+            Name
+            <input
+              name={field.name}
+              value={field.state.value}
+              onChange={(event) => field.handleChange(event.target.value)}
+              className="border"
+            />
+          </label>
+        )}
+      </form.Field>
+      <button type="submit">Submit</button>
+      {submitted ? <p>Submitted {submitted}</p> : null}
+    </form>
+  )
+}

package/templates/base/apps/web/src/examples/greeting.ts

@@ -0,0 +1,11 @@
+import { queryOptions } from "@tanstack/react-query"
+
+export const greetingKeys = {
+  all: ["greeting"] as const,
+  detail: (name: string) => [...greetingKeys.all, name] as const,
+}
+
+export const greetingOptions = queryOptions({
+  queryKey: greetingKeys.detail("query"),
+  queryFn: () => Promise.resolve("Hello, query"),
+})

package/templates/base/apps/web/src/examples/hotkeys.test.tsx

@@ -0,0 +1,7 @@
+import { renderToString } from "react-dom/server"
+import { expect, it } from "vitest"
+import { HotkeysExample } from "./hotkeys.tsx"
+
+it("renders the hotkey hint", () => {
+  expect(renderToString(<HotkeysExample />)).toContain("Press Ctrl+K or Cmd+K")
+})

package/templates/base/apps/web/src/examples/hotkeys.tsx

@@ -0,0 +1,10 @@
+import { useHotkey } from "@tanstack/react-hotkeys"
+import { useState } from "react"
+
+export function HotkeysExample() {
+  const [count, setCount] = useState(0)
+
+  useHotkey("Mod+K", () => setCount((current) => current + 1))
+
+  return <p>Press Ctrl+K or Cmd+K ({count} presses)</p>
+}

package/templates/base/apps/web/src/examples/query.test.tsx

@@ -0,0 +1,18 @@
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query"
+import { renderToString } from "react-dom/server"
+import { expect, it } from "vitest"
+import { greetingOptions } from "./greeting.ts"
+import { QueryExample } from "./query.tsx"
+
+it("renders the prefetched greeting", async () => {
+  const queryClient = new QueryClient({ defaultOptions: { queries: { staleTime: 60_000 } } })
+  await queryClient.prefetchQuery(greetingOptions)
+
+  const html = renderToString(
+    <QueryClientProvider client={queryClient}>
+      <QueryExample />
+    </QueryClientProvider>
+  )
+
+  expect(html).toContain("Hello, query")
+})

package/templates/base/apps/web/src/examples/query.tsx

@@ -0,0 +1,8 @@
+import { useSuspenseQuery } from "@tanstack/react-query"
+import { greetingOptions } from "./greeting.ts"
+
+export function QueryExample() {
+  const { data } = useSuspenseQuery(greetingOptions)
+
+  return <p>{data}</p>
+}

package/templates/base/apps/web/src/examples/table.test.tsx

@@ -0,0 +1,7 @@
+import { renderToString } from "react-dom/server"
+import { expect, it } from "vitest"
+import { TableExample } from "./table.tsx"
+
+it("renders a cell value from the row data", () => {
+  expect(renderToString(<TableExample />)).toContain("Grace Hopper")
+})

package/templates/base/apps/web/src/examples/table.tsx

@@ -0,0 +1,47 @@
+import type { ColumnDef } from "@tanstack/react-table"
+import { tableFeatures, useTable } from "@tanstack/react-table"
+
+type Person = { name: string; role: string }
+
+const features = tableFeatures({})
+
+const data: Array<Person> = [
+  { name: "Ada Lovelace", role: "Mathematician" },
+  { name: "Grace Hopper", role: "Admiral" },
+]
+
+const columns: Array<ColumnDef<typeof features, Person>> = [
+  { accessorKey: "name", header: "Name" },
+  { accessorKey: "role", header: "Role" },
+]
+
+export function TableExample() {
+  const table = useTable({ features, columns, data })
+
+  return (
+    <table>
+      <thead>
+        {table.getHeaderGroups().map((headerGroup) => (
+          <tr key={headerGroup.id}>
+            {headerGroup.headers.map((header) => (
+              <th key={header.id}>
+                <table.FlexRender header={header} />
+              </th>
+            ))}
+          </tr>
+        ))}
+      </thead>
+      <tbody>
+        {table.getRowModel().rows.map((row) => (
+          <tr key={row.id}>
+            {row.getAllCells().map((cell) => (
+              <td key={cell.id}>
+                <table.FlexRender cell={cell} />
+              </td>
+            ))}
+          </tr>
+        ))}
+      </tbody>
+    </table>
+  )
+}

package/templates/base/apps/web/src/home.test.tsx

@@ -0,0 +1,18 @@
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query"
+import { renderToString } from "react-dom/server"
+import { expect, it } from "vitest"
+import { greetingOptions } from "./examples/greeting.ts"
+import { Home } from "./home.tsx"
+
+it("renders the greeting", async () => {
+  const queryClient = new QueryClient({ defaultOptions: { queries: { staleTime: 60_000 } } })
+  await queryClient.prefetchQuery(greetingOptions)
+
+  const html = renderToString(
+    <QueryClientProvider client={queryClient}>
+      <Home />
+    </QueryClientProvider>
+  )
+
+  expect(html).toContain("Hello from your new app")
+})

package/templates/base/apps/web/src/home.tsx

@@ -0,0 +1,21 @@
+import { Button } from "@workspace/ui/components/button.tsx"
+import { motion } from "motion/react"
+import { FormExample } from "./examples/form.tsx"
+import { HotkeysExample } from "./examples/hotkeys.tsx"
+import { QueryExample } from "./examples/query.tsx"
+import { TableExample } from "./examples/table.tsx"
+
+export function Home() {
+  return (
+    <main className="flex min-h-screen flex-col items-center justify-center gap-6">
+      <h1 className="text-3xl font-semibold">Hello from your new app</h1>
+      <motion.div initial={{ opacity: 0, y: 12 }} animate={{ opacity: 1, y: 0 }}>
+        <Button>Get started</Button>
+      </motion.div>
+      <QueryExample />
+      <FormExample />
+      <TableExample />
+      <HotkeysExample />
+    </main>
+  )
+}

package/templates/base/apps/web/src/routeTree.gen.ts

@@ -0,0 +1,68 @@
+/* eslint-disable */
+
+// @ts-nocheck
+
+// noinspection JSUnusedGlobalSymbols
+
+// This file was automatically generated by TanStack Router.
+// You should NOT make any changes in this file as it will be overwritten.
+// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified.
+
+import { Route as rootRouteImport } from './routes/__root'
+import { Route as IndexRouteImport } from './routes/index'
+
+const IndexRoute = IndexRouteImport.update({
+  id: '/',
+  path: '/',
+  getParentRoute: () => rootRouteImport,
+} as any)
+
+export interface FileRoutesByFullPath {
+  '/': typeof IndexRoute
+}
+export interface FileRoutesByTo {
+  '/': typeof IndexRoute
+}
+export interface FileRoutesById {
+  __root__: typeof rootRouteImport
+  '/': typeof IndexRoute
+}
+export interface FileRouteTypes {
+  fileRoutesByFullPath: FileRoutesByFullPath
+  fullPaths: '/'
+  fileRoutesByTo: FileRoutesByTo
+  to: '/'
+  id: '__root__' | '/'
+  fileRoutesById: FileRoutesById
+}
+export interface RootRouteChildren {
+  IndexRoute: typeof IndexRoute
+}
+
+declare module '@tanstack/react-router' {
+  interface FileRoutesByPath {
+    '/': {
+      id: '/'
+      path: '/'
+      fullPath: '/'
+      preLoaderRoute: typeof IndexRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+  }
+}
+
+const rootRouteChildren: RootRouteChildren = {
+  IndexRoute: IndexRoute,
+}
+export const routeTree = rootRouteImport
+  ._addFileChildren(rootRouteChildren)
+  ._addFileTypes<FileRouteTypes>()
+
+import type { getRouter } from './router.tsx'
+import type { createStart } from '@tanstack/react-start'
+declare module '@tanstack/react-start' {
+  interface Register {
+    ssr: true
+    router: Awaited<ReturnType<typeof getRouter>>
+  }
+}

package/templates/base/apps/web/src/router.tsx

@@ -0,0 +1,20 @@
+import { QueryClient } from "@tanstack/react-query"
+import { createRouter } from "@tanstack/react-router"
+import { setupRouterSsrQueryIntegration } from "@tanstack/react-router-ssr-query"
+import { routeTree } from "./routeTree.gen.ts"
+
+export function getRouter() {
+  const queryClient = new QueryClient({
+    defaultOptions: { queries: { staleTime: 30_000 } },
+  })
+  const router = createRouter({
+    routeTree,
+    context: { queryClient },
+    scrollRestoration: true,
+    defaultPreload: "intent",
+    defaultPreloadStaleTime: 0,
+  })
+
+  setupRouterSsrQueryIntegration({ router, queryClient })
+  return router
+}