@agent-native/core 0.79.27 → 0.80.1

package/dist/application-state/handlers.js

@@ -17,7 +17,7 @@ async function getSessionId(event) {
     return session.email;
 }
 function safeKey(key) {
-    return key.replace(/[^a-zA-Z0-9_:\-]/g, "");
+    return key.replace(/[^a-zA-Z0-9_:-]/g, "");
 }
 // --- Generic state handlers ---
 export const getState = defineEventHandler(async (event) => {

package/dist/application-state/handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/application-state/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,SAAS,EACT,iBAAiB,GAElB,MAAM,IAAI,CAAC;AAEZ,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EACL,WAAW,EACX,WAAW,EACX,cAAc,EACd,YAAY,EACZ,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,KAAK,UAAU,YAAY,CAAC,KAAc;IACxC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QACpB,MAAM,WAAW,CAAC;YAChB,UAAU,EAAE,GAAG;YACf,aAAa,EAAE,iBAAiB;SACjC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAC;AACvB,CAAC;AAED,SAAS,OAAO,CAAC,GAAW;IAC1B,OAAO,GAAG,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,iCAAiC;AAEjC,MAAM,CAAC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;IAClE,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAChD,OAAO,KAAK,IAAI,IAAI,CAAC;AACvB,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;IAClE,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,aAAa,GAAG,SAAS,CAAC,KAAK,EAAE,kBAAkB,CAAC,IAAI,SAAS,CAAC;IACxE,MAAM,WAAW,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC;AACd,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;IACrE,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1D,MAAM,aAAa,GAAG,SAAS,CAAC,KAAK,EAAE,kBAAkB,CAAC,IAAI,SAAS,CAAC;IACxE,MAAM,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;IACxD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC,CAAC,CAAC;AAEH,uCAAuC;AAEvC,SAAS,eAAe,CAAC,EAAU;IACjC,OAAO,WAAW,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;AAClC,CAAC;AAED,8BAA8B;AAC9B,MAAM,CAAC,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;IAC3E,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACxD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC,CAAC,CAAC;AAEH,iCAAiC;AACjC,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;IACzE,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,EAAE,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,CAAW,CAAC;IACjD,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC;IAChE,OAAO,KAAK,IAAI,IAAI,CAAC;AACvB,CAAC,CAAC,CAAC;AAEH,uCAAuC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;IACzE,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,EAAE,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,CAAW,CAAC;IACjD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAEzC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAChE,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC9B,OAAO,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC;IAC5D,CAAC;IAED,MAAM,KAAK,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC;IAC9B,MAAM,aAAa,GAAG,SAAS,CAAC,KAAK,EAAE,kBAAkB,CAAC,IAAI,SAAS,CAAC;IACxE,MAAM,WAAW,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;IAC5E,OAAO,KAAK,CAAC;AACf,CAAC,CAAC,CAAC;AAEH,oCAAoC;AACpC,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;IAC5E,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,EAAE,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,CAAW,CAAC;IACjD,MAAM,aAAa,GAAG,SAAS,CAAC,KAAK,EAAE,kBAAkB,CAAC,IAAI,SAAS,CAAC;IACxE,MAAM,cAAc,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;IACxE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC,CAAC,CAAC;AAEH,gCAAgC;AAChC,MAAM,CAAC,MAAM,sBAAsB,GAAG,kBAAkB,CACtD,KAAK,EAAE,KAAc,EAAE,EAAE;IACvB,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,aAAa,GAAG,SAAS,CAAC,KAAK,EAAE,kBAAkB,CAAC,IAAI,SAAS,CAAC;IACxE,MAAM,sBAAsB,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;IACvE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC,CACF,CAAC","sourcesContent":["import {\n  createError,\n  defineEventHandler,\n  getRouterParam,\n  getHeader,\n  setResponseStatus,\n  type H3Event,\n} from \"h3\";\n\nimport { getSession } from \"../server/auth.js\";\nimport { readBody } from \"../server/h3-helpers.js\";\nimport {\n  appStateGet,\n  appStatePut,\n  appStateDelete,\n  appStateList,\n  appStateDeleteByPrefix,\n} from \"./store.js\";\n\n/**\n * Resolve the session ID for app state scoping. Returns the authenticated\n * user's email; throws 401 when the request has no session.\n */\nasync function getSessionId(event: H3Event): Promise<string> {\n  const session = await getSession(event);\n  if (!session?.email) {\n    throw createError({\n      statusCode: 401,\n      statusMessage: \"Unauthenticated\",\n    });\n  }\n  return session.email;\n}\n\nfunction safeKey(key: string): string {\n  return key.replace(/[^a-zA-Z0-9_:\\-]/g, \"\");\n}\n\n// --- Generic state handlers ---\n\nexport const getState = defineEventHandler(async (event: H3Event) => {\n  const sessionId = await getSessionId(event);\n  const key = safeKey(String(getRouterParam(event, \"key\")));\n  const value = await appStateGet(sessionId, key);\n  return value ?? null;\n});\n\nexport const putState = defineEventHandler(async (event: H3Event) => {\n  const sessionId = await getSessionId(event);\n  const key = safeKey(String(getRouterParam(event, \"key\")));\n  const body = await readBody(event);\n  const requestSource = getHeader(event, \"x-request-source\") || undefined;\n  await appStatePut(sessionId, key, body, { requestSource });\n  return body;\n});\n\nexport const deleteState = defineEventHandler(async (event: H3Event) => {\n  const sessionId = await getSessionId(event);\n  const key = safeKey(String(getRouterParam(event, \"key\")));\n  const requestSource = getHeader(event, \"x-request-source\") || undefined;\n  await appStateDelete(sessionId, key, { requestSource });\n  return { ok: true };\n});\n\n// --- Multi-draft compose handlers ---\n\nfunction composeDraftKey(id: string): string {\n  return `compose-${safeKey(id)}`;\n}\n\n/** List all compose drafts */\nexport const listComposeDrafts = defineEventHandler(async (event: H3Event) => {\n  const sessionId = await getSessionId(event);\n  const items = await appStateList(sessionId, \"compose-\");\n  return items.map((item) => item.value);\n});\n\n/** Get a single compose draft */\nexport const getComposeDraft = defineEventHandler(async (event: H3Event) => {\n  const sessionId = await getSessionId(event);\n  const id = getRouterParam(event, \"id\") as string;\n  const value = await appStateGet(sessionId, composeDraftKey(id));\n  return value ?? null;\n});\n\n/** Create or update a compose draft */\nexport const putComposeDraft = defineEventHandler(async (event: H3Event) => {\n  const sessionId = await getSessionId(event);\n  const id = getRouterParam(event, \"id\") as string;\n  const body = await readBody(event);\n  const { subject, body: bodyText } = body;\n\n  if (typeof subject !== \"string\" || typeof bodyText !== \"string\") {\n    setResponseStatus(event, 400);\n    return { error: \"subject and body are required strings\" };\n  }\n\n  const state = { ...body, id };\n  const requestSource = getHeader(event, \"x-request-source\") || undefined;\n  await appStatePut(sessionId, composeDraftKey(id), state, { requestSource });\n  return state;\n});\n\n/** Delete a single compose draft */\nexport const deleteComposeDraft = defineEventHandler(async (event: H3Event) => {\n  const sessionId = await getSessionId(event);\n  const id = getRouterParam(event, \"id\") as string;\n  const requestSource = getHeader(event, \"x-request-source\") || undefined;\n  await appStateDelete(sessionId, composeDraftKey(id), { requestSource });\n  return { ok: true };\n});\n\n/** Delete all compose drafts */\nexport const deleteAllComposeDrafts = defineEventHandler(\n  async (event: H3Event) => {\n    const sessionId = await getSessionId(event);\n    const requestSource = getHeader(event, \"x-request-source\") || undefined;\n    await appStateDeleteByPrefix(sessionId, \"compose-\", { requestSource });\n    return { ok: true };\n  },\n);\n"]}
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/application-state/handlers.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  createError,\n  defineEventHandler,\n  getRouterParam,\n  getHeader,\n  setResponseStatus,\n  type H3Event,\n} from \"h3\";\n\nimport { getSession } from \"../server/auth.js\";\nimport { readBody } from \"../server/h3-helpers.js\";\nimport {\n  appStateGet,\n  appStatePut,\n  appStateDelete,\n  appStateList,\n  appStateDeleteByPrefix,\n} from \"./store.js\";\n\n/**\n * Resolve the session ID for app state scoping. Returns the authenticated\n * user's email; throws 401 when the request has no session.\n */\nasync function getSessionId(event: H3Event): Promise<string> {\n  const session = await getSession(event);\n  if (!session?.email) {\n    throw createError({\n      statusCode: 401,\n      statusMessage: \"Unauthenticated\",\n    });\n  }\n  return session.email;\n}\n\nfunction safeKey(key: string): string {\n  return key.replace(/[^a-zA-Z0-9_:-]/g, \"\");\n}\n\n// --- Generic state handlers ---\n\nexport const getState = defineEventHandler(async (event: H3Event) => {\n  const sessionId = await getSessionId(event);\n  const key = safeKey(String(getRouterParam(event, \"key\")));\n  const value = await appStateGet(sessionId, key);\n  return value ?? null;\n});\n\nexport const putState = defineEventHandler(async (event: H3Event) => {\n  const sessionId = await getSessionId(event);\n  const key = safeKey(String(getRouterParam(event, \"key\")));\n  const body = await readBody(event);\n  const requestSource = getHeader(event, \"x-request-source\") || undefined;\n  await appStatePut(sessionId, key, body, { requestSource });\n  return body;\n});\n\nexport const deleteState = defineEventHandler(async (event: H3Event) => {\n  const sessionId = await getSessionId(event);\n  const key = safeKey(String(getRouterParam(event, \"key\")));\n  const requestSource = getHeader(event, \"x-request-source\") || undefined;\n  await appStateDelete(sessionId, key, { requestSource });\n  return { ok: true };\n});\n\n// --- Multi-draft compose handlers ---\n\nfunction composeDraftKey(id: string): string {\n  return `compose-${safeKey(id)}`;\n}\n\n/** List all compose drafts */\nexport const listComposeDrafts = defineEventHandler(async (event: H3Event) => {\n  const sessionId = await getSessionId(event);\n  const items = await appStateList(sessionId, \"compose-\");\n  return items.map((item) => item.value);\n});\n\n/** Get a single compose draft */\nexport const getComposeDraft = defineEventHandler(async (event: H3Event) => {\n  const sessionId = await getSessionId(event);\n  const id = getRouterParam(event, \"id\") as string;\n  const value = await appStateGet(sessionId, composeDraftKey(id));\n  return value ?? null;\n});\n\n/** Create or update a compose draft */\nexport const putComposeDraft = defineEventHandler(async (event: H3Event) => {\n  const sessionId = await getSessionId(event);\n  const id = getRouterParam(event, \"id\") as string;\n  const body = await readBody(event);\n  const { subject, body: bodyText } = body;\n\n  if (typeof subject !== \"string\" || typeof bodyText !== \"string\") {\n    setResponseStatus(event, 400);\n    return { error: \"subject and body are required strings\" };\n  }\n\n  const state = { ...body, id };\n  const requestSource = getHeader(event, \"x-request-source\") || undefined;\n  await appStatePut(sessionId, composeDraftKey(id), state, { requestSource });\n  return state;\n});\n\n/** Delete a single compose draft */\nexport const deleteComposeDraft = defineEventHandler(async (event: H3Event) => {\n  const sessionId = await getSessionId(event);\n  const id = getRouterParam(event, \"id\") as string;\n  const requestSource = getHeader(event, \"x-request-source\") || undefined;\n  await appStateDelete(sessionId, composeDraftKey(id), { requestSource });\n  return { ok: true };\n});\n\n/** Delete all compose drafts */\nexport const deleteAllComposeDrafts = defineEventHandler(\n  async (event: H3Event) => {\n    const sessionId = await getSessionId(event);\n    const requestSource = getHeader(event, \"x-request-source\") || undefined;\n    await appStateDeleteByPrefix(sessionId, \"compose-\", { requestSource });\n    return { ok: true };\n  },\n);\n"]}

package/dist/brand-kit/index.d.ts

@@ -3,7 +3,7 @@
  *
  * The shared, template-agnostic Brand Kit surface. A Brand Kit unifies what
  * `design` and `slides` previously copy-pasted as a "design system": design
- * tokens + brand assets + custom instructions, extractable from Figma, code,
+ * tokens + brand assets + custom instructions, extractable from code,
  * GitHub, a URL, or documents, and used to generate on-brand content.
  *
  * This module is pure (no `defineAction`, no DB, no template imports). Templates

package/dist/brand-kit/index.js

@@ -3,7 +3,7 @@
  *
  * The shared, template-agnostic Brand Kit surface. A Brand Kit unifies what
  * `design` and `slides` previously copy-pasted as a "design system": design
- * tokens + brand assets + custom instructions, extractable from Figma, code,
+ * tokens + brand assets + custom instructions, extractable from code,
  * GitHub, a URL, or documents, and used to generate on-brand content.
  *
  * This module is pure (no `defineAction`, no DB, no template imports). Templates

package/dist/brand-kit/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/brand-kit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AAEnC,8EAA8E;AAC9E,6EAA6E;AAC7E,OAAO;AACL,iBAAiB;AACjB,0BAA0B,EAC1B,WAAW;AACX,iBAAiB;AACjB,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,cAAc;AACd,yBAAyB;AACzB,mBAAmB,EACnB,QAAQ,EACR,sBAAsB;AACtB,qBAAqB;AACrB,uBAAuB,EACvB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,OAAO,EACP,cAAc,EACd,iBAAiB,EACjB,gBAAgB;AAChB,oBAAoB;AACpB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,MAAM;AACN,YAAY;AACZ,SAAS,EACT,aAAa,EACb,aAAa,EACb,aAAa,EACb,eAAe,EACf,cAAc,EACd,oBAAoB,GACrB,MAAM,iCAAiC,CAAC","sourcesContent":["/**\n * `@agent-native/core/brand-kit`\n *\n * The shared, template-agnostic Brand Kit surface. A Brand Kit unifies what\n * `design` and `slides` previously copy-pasted as a \"design system\": design\n * tokens + brand assets + custom instructions, extractable from Figma, code,\n * GitHub, a URL, or documents, and used to generate on-brand content.\n *\n * This module is pure (no `defineAction`, no DB, no template imports). Templates\n * keep their own `design_systems` schema table and thin `defineAction` wrappers\n * (which handle DB access + auto-registration), and import the reusable types\n * and helpers from here.\n *\n * Re-exports the lower-level import/token-extraction helpers from\n * `design-token-utils` so callers have a single Brand Kit entry point.\n */\n\nexport * from \"./types.js\";\nexport * from \"./brand-signals.js\";\n\n// Import-source parsing + token extraction (Tailwind/CSS/GitHub/URL/document/\n// code analysis). These already power the import-* actions across templates.\nexport {\n  // URL extraction\n  extractDesignTokensFromUrl,\n  validateUrl,\n  // GitHub helpers\n  parseOwnerRepo,\n  fetchGitHubJson,\n  fetchGitHubJsonResult,\n  fetchGitHubRaw,\n  // Tailwind / CSS parsing\n  parseTailwindConfig,\n  parseCss,\n  detectStylingFramework,\n  // Code-file analysis\n  createCodeAnalysisState,\n  analyzeCodeFile,\n  analyzeCssFile,\n  analyzeTailwindConfig,\n  analyzeJsonTheme,\n  analyzePackageJson,\n  analyzeThemeSourceFile,\n  addFont,\n  extractCssVars,\n  extractCodeColors,\n  extractCodeFonts,\n  // Document analysis\n  extractDocumentColors,\n  extractDocumentFonts,\n  classifyFile,\n  suggestionsForType,\n  unique,\n  // Constants\n  MAX_FILES,\n  MAX_FILE_SIZE,\n  FETCH_TIMEOUT,\n  ROOT_PATTERNS,\n  SECONDARY_PATHS,\n  CODE_MAX_FILES,\n  CODE_MAX_TOTAL_BYTES,\n} from \"../server/design-token-utils.js\";\n\nexport type {\n  ContentType,\n  ParsedCss,\n  ParsedTailwindConfig,\n  CodeAnalysisState,\n  UrlExtractionResult,\n  GitHubFetchOptions,\n  GitHubJsonResult,\n} from \"../server/design-token-utils.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/brand-kit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AAEnC,8EAA8E;AAC9E,6EAA6E;AAC7E,OAAO;AACL,iBAAiB;AACjB,0BAA0B,EAC1B,WAAW;AACX,iBAAiB;AACjB,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,cAAc;AACd,yBAAyB;AACzB,mBAAmB,EACnB,QAAQ,EACR,sBAAsB;AACtB,qBAAqB;AACrB,uBAAuB,EACvB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,OAAO,EACP,cAAc,EACd,iBAAiB,EACjB,gBAAgB;AAChB,oBAAoB;AACpB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,MAAM;AACN,YAAY;AACZ,SAAS,EACT,aAAa,EACb,aAAa,EACb,aAAa,EACb,eAAe,EACf,cAAc,EACd,oBAAoB,GACrB,MAAM,iCAAiC,CAAC","sourcesContent":["/**\n * `@agent-native/core/brand-kit`\n *\n * The shared, template-agnostic Brand Kit surface. A Brand Kit unifies what\n * `design` and `slides` previously copy-pasted as a \"design system\": design\n * tokens + brand assets + custom instructions, extractable from code,\n * GitHub, a URL, or documents, and used to generate on-brand content.\n *\n * This module is pure (no `defineAction`, no DB, no template imports). Templates\n * keep their own `design_systems` schema table and thin `defineAction` wrappers\n * (which handle DB access + auto-registration), and import the reusable types\n * and helpers from here.\n *\n * Re-exports the lower-level import/token-extraction helpers from\n * `design-token-utils` so callers have a single Brand Kit entry point.\n */\n\nexport * from \"./types.js\";\nexport * from \"./brand-signals.js\";\n\n// Import-source parsing + token extraction (Tailwind/CSS/GitHub/URL/document/\n// code analysis). These already power the import-* actions across templates.\nexport {\n  // URL extraction\n  extractDesignTokensFromUrl,\n  validateUrl,\n  // GitHub helpers\n  parseOwnerRepo,\n  fetchGitHubJson,\n  fetchGitHubJsonResult,\n  fetchGitHubRaw,\n  // Tailwind / CSS parsing\n  parseTailwindConfig,\n  parseCss,\n  detectStylingFramework,\n  // Code-file analysis\n  createCodeAnalysisState,\n  analyzeCodeFile,\n  analyzeCssFile,\n  analyzeTailwindConfig,\n  analyzeJsonTheme,\n  analyzePackageJson,\n  analyzeThemeSourceFile,\n  addFont,\n  extractCssVars,\n  extractCodeColors,\n  extractCodeFonts,\n  // Document analysis\n  extractDocumentColors,\n  extractDocumentFonts,\n  classifyFile,\n  suggestionsForType,\n  unique,\n  // Constants\n  MAX_FILES,\n  MAX_FILE_SIZE,\n  FETCH_TIMEOUT,\n  ROOT_PATTERNS,\n  SECONDARY_PATHS,\n  CODE_MAX_FILES,\n  CODE_MAX_TOTAL_BYTES,\n} from \"../server/design-token-utils.js\";\n\nexport type {\n  ContentType,\n  ParsedCss,\n  ParsedTailwindConfig,\n  CodeAnalysisState,\n  UrlExtractionResult,\n  GitHubFetchOptions,\n  GitHubJsonResult,\n} from \"../server/design-token-utils.js\";\n"]}

package/dist/cli/design-connect.d.ts

@@ -0,0 +1,52 @@
+import { type Server } from "node:http";
+declare const BRIDGE_OPERATIONS: readonly ["select", "resolveNodeToFile", "readFile", "applyEdit", "writeFile", "captureSnapshot", "captureState"];
+type BridgeOperation = (typeof BRIDGE_OPERATIONS)[number];
+export interface DesignConnectArgs {
+    url?: string;
+    port: number;
+    root: string;
+    routeManifest?: string;
+    json: boolean;
+    once: boolean;
+    dryRun: boolean;
+    help: boolean;
+}
+export interface DesignConnectRoute {
+    id: string;
+    path: string;
+    title: string;
+    sourceFile?: string;
+    sourceKind: "react-router" | "html" | "manual";
+}
+export interface DesignConnectManifest {
+    version: 1;
+    source: "agent-native-design-connect";
+    sourceType: "localhost";
+    localOnly: true;
+    devServerUrl: string;
+    bridgeUrl: string;
+    rootPath: string;
+    routeManifestPath: string;
+    routeManifestCreated: boolean;
+    routes: DesignConnectRoute[];
+    routeCount: number;
+    generatedAt: string;
+    capabilities: Array<{
+        operation: BridgeOperation;
+        status: "available" | "planned" | "disabled";
+        reason?: string;
+    }>;
+}
+export interface DesignConnectBridge {
+    server: Server;
+    manifest: DesignConnectManifest;
+}
+export declare function parseDesignConnectArgs(argv: string[]): DesignConnectArgs;
+export declare function discoverDesignRoutes(root: string): DesignConnectRoute[];
+export declare function prepareDesignConnectManifest(options?: Partial<DesignConnectArgs> & {
+    root?: string;
+}): Promise<DesignConnectManifest>;
+export declare function startDesignConnectBridge(manifest: DesignConnectManifest): Promise<DesignConnectBridge>;
+export declare function runDesign(argv: string[]): Promise<number>;
+export {};
+//# sourceMappingURL=design-connect.d.ts.map

package/dist/cli/design-connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-connect.d.ts","sourceRoot":"","sources":["../../src/cli/design-connect.ts"],"names":[],"mappings":"AAEA,OAAa,EAEX,KAAK,MAAM,EAEZ,MAAM,WAAW,CAAC;AAcnB,QAAA,MAAM,iBAAiB,YACrB,QAAQ,EACR,mBAAmB,EACnB,UAAU,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,cAAc,CACN,CAAC;AAEX,KAAK,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,cAAc,GAAG,MAAM,GAAG,QAAQ,CAAC;CAChD;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,6BAA6B,CAAC;IACtC,UAAU,EAAE,WAAW,CAAC;IACxB,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,KAAK,CAAC;QAClB,SAAS,EAAE,eAAe,CAAC;QAC3B,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;QAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,qBAAqB,CAAC;CACjC;AAyBD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAwDxE;AAiED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,EAAE,CA+CvE;AA6DD,wBAAsB,4BAA4B,CAChD,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3D,OAAO,CAAC,qBAAqB,CAAC,CA0ChC;AAiBD,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CAwC9B;AAgBD,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,mBA0C7C"}

package/dist/cli/design-connect.js

@@ -0,0 +1,409 @@
+import fsSync from "node:fs";
+import fs from "node:fs/promises";
+import http from "node:http";
+import path from "node:path";
+const DEFAULT_BRIDGE_PORT = 7331;
+const ROUTE_MANIFEST_FILE = path.join(".agent-native", "design-routes.json");
+const DEFAULT_DEV_SERVER_CANDIDATES = [
+    "http://127.0.0.1:5173",
+    "http://localhost:5173",
+    "http://127.0.0.1:3000",
+    "http://localhost:3000",
+    "http://127.0.0.1:8080",
+    "http://localhost:8080",
+];
+const BRIDGE_OPERATIONS = [
+    "select",
+    "resolveNodeToFile",
+    "readFile",
+    "applyEdit",
+    "writeFile",
+    "captureSnapshot",
+    "captureState",
+];
+function stringFlagValue(argv, index, flag) {
+    const value = argv[index + 1];
+    if (!value || value.startsWith("-")) {
+        throw new Error(`${flag} requires a value`);
+    }
+    return value;
+}
+function normalizeSlash(value) {
+    return value.replace(/\\/g, "/");
+}
+function normalizeHttpUrl(value) {
+    const raw = value.trim();
+    const withProtocol = /^[a-z]+:\/\//i.test(raw) ? raw : `http://${raw}`;
+    const parsed = new URL(withProtocol);
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new Error("--url must be an http(s) URL");
+    }
+    parsed.hash = "";
+    return parsed.toString().replace(/\/$/, "");
+}
+export function parseDesignConnectArgs(argv) {
+    const args = argv[0] === "connect" ? argv.slice(1) : argv;
+    const parsed = {
+        port: DEFAULT_BRIDGE_PORT,
+        root: process.cwd(),
+        json: false,
+        once: false,
+        dryRun: false,
+        help: false,
+    };
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "help" || arg === "--help" || arg === "-h") {
+            parsed.help = true;
+        }
+        else if (arg === "--url") {
+            parsed.url = stringFlagValue(args, index, arg);
+            index += 1;
+        }
+        else if (arg.startsWith("--url=")) {
+            parsed.url = arg.slice("--url=".length);
+        }
+        else if (arg === "--port") {
+            parsed.port = Number.parseInt(stringFlagValue(args, index, arg), 10);
+            index += 1;
+        }
+        else if (arg.startsWith("--port=")) {
+            parsed.port = Number.parseInt(arg.slice("--port=".length), 10);
+        }
+        else if (arg === "--root") {
+            parsed.root = stringFlagValue(args, index, arg);
+            index += 1;
+        }
+        else if (arg.startsWith("--root=")) {
+            parsed.root = arg.slice("--root=".length);
+        }
+        else if (arg === "--route-manifest") {
+            parsed.routeManifest = stringFlagValue(args, index, arg);
+            index += 1;
+        }
+        else if (arg.startsWith("--route-manifest=")) {
+            parsed.routeManifest = arg.slice("--route-manifest=".length);
+        }
+        else if (arg === "--json") {
+            parsed.json = true;
+            parsed.once = true;
+        }
+        else if (arg === "--once") {
+            parsed.once = true;
+        }
+        else if (arg === "--dry-run") {
+            parsed.dryRun = true;
+            parsed.once = true;
+        }
+        else if (arg.startsWith("-")) {
+            throw new Error(`Unknown option: ${arg}`);
+        }
+        else {
+            throw new Error(`Unexpected argument: ${arg}`);
+        }
+    }
+    if (!Number.isInteger(parsed.port) || parsed.port <= 0) {
+        throw new Error("--port must be a positive integer");
+    }
+    parsed.root = path.resolve(parsed.root);
+    parsed.url = parsed.url ? normalizeHttpUrl(parsed.url) : undefined;
+    return parsed;
+}
+function routeId(routePath) {
+    if (routePath === "/")
+        return "route-root";
+    const slug = routePath
+        .replace(/^\/+/, "")
+        .replace(/[^a-zA-Z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .toLowerCase();
+    return slug ? `route-${slug}` : "route-wildcard";
+}
+function titleFromRoutePath(routePath) {
+    if (routePath === "/")
+        return "Home";
+    if (routePath === "/*" || routePath === "*")
+        return "Wildcard";
+    return (routePath
+        .replace(/^\/+/, "")
+        .replace(/[:$]/g, "")
+        .replace(/[-_/]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+        .replace(/\b\w/g, (char) => char.toUpperCase()) || "Screen");
+}
+function walkFiles(dir, files = []) {
+    if (!fsSync.existsSync(dir))
+        return files;
+    for (const entry of fsSync.readdirSync(dir, { withFileTypes: true })) {
+        if (entry.name === "node_modules" || entry.name === ".git")
+            continue;
+        const absolute = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            walkFiles(absolute, files);
+        }
+        else {
+            files.push(absolute);
+        }
+    }
+    return files;
+}
+function routePathFromReactRouterFile(filePath, routesDir) {
+    const withoutExt = normalizeSlash(path.relative(routesDir, filePath)).replace(/\.[cm]?[jt]sx?$/, "");
+    const parts = [];
+    for (const segment of withoutExt.split("/")) {
+        for (const token of segment.split(".")) {
+            if (!token || token === "route" || token === "index")
+                continue;
+            if (token === "_index")
+                continue;
+            if (token.startsWith("_"))
+                continue;
+            const pathToken = token.endsWith("_") ? token.slice(0, -1) : token;
+            if (pathToken === "$") {
+                parts.push("*");
+            }
+            else if (pathToken.startsWith("$")) {
+                const param = pathToken.slice(1) || "param";
+                parts.push(`:${param}`);
+            }
+            else {
+                parts.push(pathToken);
+            }
+        }
+    }
+    return `/${parts.join("/")}`.replace(/\/+/g, "/");
+}
+export function discoverDesignRoutes(root) {
+    const absoluteRoot = path.resolve(root);
+    const routeDirs = [
+        path.join(absoluteRoot, "app", "routes"),
+        path.join(absoluteRoot, "src", "routes"),
+        path.join(absoluteRoot, "pages"),
+    ].filter((dir) => fsSync.existsSync(dir));
+    const routes = new Map();
+    for (const routeDir of routeDirs) {
+        for (const file of walkFiles(routeDir)) {
+            if (!/\.[cm]?[jt]sx?$/.test(file))
+                continue;
+            if (/\.test\.|\.spec\./.test(file))
+                continue;
+            const pathName = routePathFromReactRouterFile(file, routeDir);
+            routes.set(pathName, {
+                id: routeId(pathName),
+                path: pathName,
+                title: titleFromRoutePath(pathName),
+                sourceFile: normalizeSlash(path.relative(absoluteRoot, file)),
+                sourceKind: "react-router",
+            });
+        }
+    }
+    if (routes.size === 0) {
+        for (const dir of [absoluteRoot, path.join(absoluteRoot, "public")]) {
+            for (const file of walkFiles(dir)) {
+                if (!file.endsWith(".html"))
+                    continue;
+                const rel = normalizeSlash(path.relative(dir, file));
+                const pathName = rel === "index.html" ? "/" : `/${rel.replace(/\.html$/, "")}`;
+                routes.set(pathName, {
+                    id: routeId(pathName),
+                    path: pathName,
+                    title: titleFromRoutePath(pathName),
+                    sourceFile: normalizeSlash(path.relative(absoluteRoot, file)),
+                    sourceKind: "html",
+                });
+            }
+        }
+    }
+    return [...routes.values()].sort((a, b) => {
+        if (a.path === "/")
+            return -1;
+        if (b.path === "/")
+            return 1;
+        return a.path.localeCompare(b.path);
+    });
+}
+async function probeDevServer(url) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 800);
+    try {
+        const response = await fetch(url, {
+            method: "GET",
+            signal: controller.signal,
+        });
+        return response.status < 500;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+async function resolveDevServerUrl(url) {
+    if (url)
+        return normalizeHttpUrl(url);
+    for (const candidate of DEFAULT_DEV_SERVER_CANDIDATES) {
+        if (await probeDevServer(candidate))
+            return candidate;
+    }
+    return DEFAULT_DEV_SERVER_CANDIDATES[0];
+}
+async function ensureRouteManifest(options) {
+    const manifestPath = path.isAbsolute(options.routeManifestPath)
+        ? options.routeManifestPath
+        : path.join(options.root, options.routeManifestPath);
+    if (fsSync.existsSync(manifestPath)) {
+        return { path: manifestPath, created: false };
+    }
+    if (!options.dryRun) {
+        await fs.mkdir(path.dirname(manifestPath), { recursive: true });
+        await fs.writeFile(manifestPath, `${JSON.stringify({
+            version: 1,
+            sourceType: "localhost",
+            devServerUrl: options.devServerUrl,
+            rootPath: options.root,
+            routes: options.routes,
+            generatedAt: new Date().toISOString(),
+        }, null, 2)}\n`, "utf8");
+    }
+    return { path: manifestPath, created: !options.dryRun };
+}
+export async function prepareDesignConnectManifest(options = {}) {
+    const root = path.resolve(options.root ?? process.cwd());
+    const port = options.port ?? DEFAULT_BRIDGE_PORT;
+    const devServerUrl = await resolveDevServerUrl(options.url);
+    const bridgeUrl = `http://127.0.0.1:${port}`;
+    const routes = discoverDesignRoutes(root);
+    const routeManifest = await ensureRouteManifest({
+        root,
+        routeManifestPath: options.routeManifest ?? ROUTE_MANIFEST_FILE,
+        routes,
+        devServerUrl,
+        dryRun: Boolean(options.dryRun),
+    });
+    const generatedAt = new Date().toISOString();
+    return {
+        version: 1,
+        source: "agent-native-design-connect",
+        sourceType: "localhost",
+        localOnly: true,
+        devServerUrl,
+        bridgeUrl,
+        rootPath: root,
+        routeManifestPath: routeManifest.path,
+        routeManifestCreated: routeManifest.created,
+        routes,
+        routeCount: routes.length,
+        generatedAt,
+        capabilities: BRIDGE_OPERATIONS.map((operation) => ({
+            operation,
+            status: operation === "readFile" ||
+                operation === "applyEdit" ||
+                operation === "writeFile"
+                ? "planned"
+                : "available",
+            reason: operation === "writeFile"
+                ? "The bridge advertises the contract before enabling local file writes."
+                : undefined,
+        })),
+    };
+}
+function sendJson(res, statusCode, body) {
+    res.writeHead(statusCode, {
+        "content-type": "application/json; charset=utf-8",
+        "access-control-allow-origin": "*",
+        "access-control-allow-methods": "GET, OPTIONS",
+        "access-control-allow-headers": "content-type",
+        "access-control-allow-private-network": "true",
+    });
+    res.end(`${JSON.stringify(body, null, 2)}\n`);
+}
+export async function startDesignConnectBridge(manifest) {
+    const server = http.createServer((req, res) => {
+        if (req.method === "OPTIONS") {
+            sendJson(res, 204, {});
+            return;
+        }
+        const pathname = new URL(req.url ?? "/", manifest.bridgeUrl).pathname;
+        if (pathname === "/" || pathname === "/manifest.json") {
+            sendJson(res, 200, manifest);
+            return;
+        }
+        if (pathname === "/routes.json") {
+            sendJson(res, 200, {
+                version: 1,
+                sourceType: "localhost",
+                devServerUrl: manifest.devServerUrl,
+                rootPath: manifest.rootPath,
+                routes: manifest.routes,
+                generatedAt: manifest.generatedAt,
+            });
+            return;
+        }
+        if (pathname === "/health") {
+            sendJson(res, 200, { ok: true, source: manifest.source });
+            return;
+        }
+        sendJson(res, 404, { ok: false, error: "not found" });
+    });
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(new URL(manifest.bridgeUrl).port, "127.0.0.1", () => {
+            server.off("error", reject);
+            resolve();
+        });
+    });
+    return { server, manifest };
+}
+function printHelp() {
+    console.log(`Usage:
+  agent-native design connect [options]
+
+Options:
+  --url <url>             Dev server URL to inspect (auto-detected if omitted)
+  --port <number>         Local bridge port (default ${DEFAULT_BRIDGE_PORT})
+  --root <path>           App/repo root for route discovery (default cwd)
+  --route-manifest <path> Non-destructive route manifest output path
+  --json                  Print the manifest JSON and exit
+  --once                  Prepare/scaffold the manifest and exit
+  --dry-run               Print what would be exposed without writing files`);
+}
+export async function runDesign(argv) {
+    const subcommand = argv[0];
+    if (subcommand !== "connect") {
+        if (subcommand === "help" ||
+            subcommand === "--help" ||
+            subcommand === "-h") {
+            printHelp();
+            return 0;
+        }
+        console.error("Usage: agent-native design connect [options]");
+        return 1;
+    }
+    const parsed = parseDesignConnectArgs(argv);
+    if (parsed.help) {
+        printHelp();
+        return 0;
+    }
+    const manifest = await prepareDesignConnectManifest(parsed);
+    if (parsed.json || parsed.once || parsed.dryRun) {
+        console.log(JSON.stringify(manifest, null, 2));
+        return 0;
+    }
+    const bridge = await startDesignConnectBridge(manifest);
+    console.error("Design localhost bridge running");
+    console.error(`Bridge:   ${manifest.bridgeUrl}`);
+    console.error(`Manifest: ${manifest.bridgeUrl}/manifest.json`);
+    console.error(`Routes:   ${manifest.routeCount}`);
+    console.error(`Dev URL:  ${manifest.devServerUrl}`);
+    return await new Promise((resolve) => {
+        const stop = () => {
+            bridge.server.close(() => resolve(0));
+        };
+        for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+            process.once(signal, stop);
+        }
+    });
+}
+//# sourceMappingURL=design-connect.js.map

package/dist/cli/design-connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-connect.js","sourceRoot":"","sources":["../../src/cli/design-connect.ts"],"names":[],"mappings":"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","sourcesContent":["import fsSync from \"node:fs\";\nimport fs from \"node:fs/promises\";\nimport http, {\n  type IncomingMessage,\n  type Server,\n  type ServerResponse,\n} from \"node:http\";\nimport path from \"node:path\";\n\nconst DEFAULT_BRIDGE_PORT = 7331;\nconst ROUTE_MANIFEST_FILE = path.join(\".agent-native\", \"design-routes.json\");\nconst DEFAULT_DEV_SERVER_CANDIDATES = [\n  \"http://127.0.0.1:5173\",\n  \"http://localhost:5173\",\n  \"http://127.0.0.1:3000\",\n  \"http://localhost:3000\",\n  \"http://127.0.0.1:8080\",\n  \"http://localhost:8080\",\n];\n\nconst BRIDGE_OPERATIONS = [\n  \"select\",\n  \"resolveNodeToFile\",\n  \"readFile\",\n  \"applyEdit\",\n  \"writeFile\",\n  \"captureSnapshot\",\n  \"captureState\",\n] as const;\n\ntype BridgeOperation = (typeof BRIDGE_OPERATIONS)[number];\n\nexport interface DesignConnectArgs {\n  url?: string;\n  port: number;\n  root: string;\n  routeManifest?: string;\n  json: boolean;\n  once: boolean;\n  dryRun: boolean;\n  help: boolean;\n}\n\nexport interface DesignConnectRoute {\n  id: string;\n  path: string;\n  title: string;\n  sourceFile?: string;\n  sourceKind: \"react-router\" | \"html\" | \"manual\";\n}\n\nexport interface DesignConnectManifest {\n  version: 1;\n  source: \"agent-native-design-connect\";\n  sourceType: \"localhost\";\n  localOnly: true;\n  devServerUrl: string;\n  bridgeUrl: string;\n  rootPath: string;\n  routeManifestPath: string;\n  routeManifestCreated: boolean;\n  routes: DesignConnectRoute[];\n  routeCount: number;\n  generatedAt: string;\n  capabilities: Array<{\n    operation: BridgeOperation;\n    status: \"available\" | \"planned\" | \"disabled\";\n    reason?: string;\n  }>;\n}\n\nexport interface DesignConnectBridge {\n  server: Server;\n  manifest: DesignConnectManifest;\n}\n\nfunction stringFlagValue(argv: string[], index: number, flag: string) {\n  const value = argv[index + 1];\n  if (!value || value.startsWith(\"-\")) {\n    throw new Error(`${flag} requires a value`);\n  }\n  return value;\n}\n\nfunction normalizeSlash(value: string) {\n  return value.replace(/\\\\/g, \"/\");\n}\n\nfunction normalizeHttpUrl(value: string): string {\n  const raw = value.trim();\n  const withProtocol = /^[a-z]+:\\/\\//i.test(raw) ? raw : `http://${raw}`;\n  const parsed = new URL(withProtocol);\n  if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n    throw new Error(\"--url must be an http(s) URL\");\n  }\n  parsed.hash = \"\";\n  return parsed.toString().replace(/\\/$/, \"\");\n}\n\nexport function parseDesignConnectArgs(argv: string[]): DesignConnectArgs {\n  const args = argv[0] === \"connect\" ? argv.slice(1) : argv;\n  const parsed: DesignConnectArgs = {\n    port: DEFAULT_BRIDGE_PORT,\n    root: process.cwd(),\n    json: false,\n    once: false,\n    dryRun: false,\n    help: false,\n  };\n\n  for (let index = 0; index < args.length; index += 1) {\n    const arg = args[index]!;\n    if (arg === \"help\" || arg === \"--help\" || arg === \"-h\") {\n      parsed.help = true;\n    } else if (arg === \"--url\") {\n      parsed.url = stringFlagValue(args, index, arg);\n      index += 1;\n    } else if (arg.startsWith(\"--url=\")) {\n      parsed.url = arg.slice(\"--url=\".length);\n    } else if (arg === \"--port\") {\n      parsed.port = Number.parseInt(stringFlagValue(args, index, arg), 10);\n      index += 1;\n    } else if (arg.startsWith(\"--port=\")) {\n      parsed.port = Number.parseInt(arg.slice(\"--port=\".length), 10);\n    } else if (arg === \"--root\") {\n      parsed.root = stringFlagValue(args, index, arg);\n      index += 1;\n    } else if (arg.startsWith(\"--root=\")) {\n      parsed.root = arg.slice(\"--root=\".length);\n    } else if (arg === \"--route-manifest\") {\n      parsed.routeManifest = stringFlagValue(args, index, arg);\n      index += 1;\n    } else if (arg.startsWith(\"--route-manifest=\")) {\n      parsed.routeManifest = arg.slice(\"--route-manifest=\".length);\n    } else if (arg === \"--json\") {\n      parsed.json = true;\n      parsed.once = true;\n    } else if (arg === \"--once\") {\n      parsed.once = true;\n    } else if (arg === \"--dry-run\") {\n      parsed.dryRun = true;\n      parsed.once = true;\n    } else if (arg.startsWith(\"-\")) {\n      throw new Error(`Unknown option: ${arg}`);\n    } else {\n      throw new Error(`Unexpected argument: ${arg}`);\n    }\n  }\n\n  if (!Number.isInteger(parsed.port) || parsed.port <= 0) {\n    throw new Error(\"--port must be a positive integer\");\n  }\n  parsed.root = path.resolve(parsed.root);\n  parsed.url = parsed.url ? normalizeHttpUrl(parsed.url) : undefined;\n  return parsed;\n}\n\nfunction routeId(routePath: string): string {\n  if (routePath === \"/\") return \"route-root\";\n  const slug = routePath\n    .replace(/^\\/+/, \"\")\n    .replace(/[^a-zA-Z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\")\n    .toLowerCase();\n  return slug ? `route-${slug}` : \"route-wildcard\";\n}\n\nfunction titleFromRoutePath(routePath: string): string {\n  if (routePath === \"/\") return \"Home\";\n  if (routePath === \"/*\" || routePath === \"*\") return \"Wildcard\";\n  return (\n    routePath\n      .replace(/^\\/+/, \"\")\n      .replace(/[:$]/g, \"\")\n      .replace(/[-_/]+/g, \" \")\n      .replace(/\\s+/g, \" \")\n      .trim()\n      .replace(/\\b\\w/g, (char) => char.toUpperCase()) || \"Screen\"\n  );\n}\n\nfunction walkFiles(dir: string, files: string[] = []): string[] {\n  if (!fsSync.existsSync(dir)) return files;\n  for (const entry of fsSync.readdirSync(dir, { withFileTypes: true })) {\n    if (entry.name === \"node_modules\" || entry.name === \".git\") continue;\n    const absolute = path.join(dir, entry.name);\n    if (entry.isDirectory()) {\n      walkFiles(absolute, files);\n    } else {\n      files.push(absolute);\n    }\n  }\n  return files;\n}\n\nfunction routePathFromReactRouterFile(filePath: string, routesDir: string) {\n  const withoutExt = normalizeSlash(path.relative(routesDir, filePath)).replace(\n    /\\.[cm]?[jt]sx?$/,\n    \"\",\n  );\n  const parts: string[] = [];\n  for (const segment of withoutExt.split(\"/\")) {\n    for (const token of segment.split(\".\")) {\n      if (!token || token === \"route\" || token === \"index\") continue;\n      if (token === \"_index\") continue;\n      if (token.startsWith(\"_\")) continue;\n      const pathToken = token.endsWith(\"_\") ? token.slice(0, -1) : token;\n      if (pathToken === \"$\") {\n        parts.push(\"*\");\n      } else if (pathToken.startsWith(\"$\")) {\n        const param = pathToken.slice(1) || \"param\";\n        parts.push(`:${param}`);\n      } else {\n        parts.push(pathToken);\n      }\n    }\n  }\n  return `/${parts.join(\"/\")}`.replace(/\\/+/g, \"/\");\n}\n\nexport function discoverDesignRoutes(root: string): DesignConnectRoute[] {\n  const absoluteRoot = path.resolve(root);\n  const routeDirs = [\n    path.join(absoluteRoot, \"app\", \"routes\"),\n    path.join(absoluteRoot, \"src\", \"routes\"),\n    path.join(absoluteRoot, \"pages\"),\n  ].filter((dir) => fsSync.existsSync(dir));\n  const routes = new Map<string, DesignConnectRoute>();\n\n  for (const routeDir of routeDirs) {\n    for (const file of walkFiles(routeDir)) {\n      if (!/\\.[cm]?[jt]sx?$/.test(file)) continue;\n      if (/\\.test\\.|\\.spec\\./.test(file)) continue;\n      const pathName = routePathFromReactRouterFile(file, routeDir);\n      routes.set(pathName, {\n        id: routeId(pathName),\n        path: pathName,\n        title: titleFromRoutePath(pathName),\n        sourceFile: normalizeSlash(path.relative(absoluteRoot, file)),\n        sourceKind: \"react-router\",\n      });\n    }\n  }\n\n  if (routes.size === 0) {\n    for (const dir of [absoluteRoot, path.join(absoluteRoot, \"public\")]) {\n      for (const file of walkFiles(dir)) {\n        if (!file.endsWith(\".html\")) continue;\n        const rel = normalizeSlash(path.relative(dir, file));\n        const pathName =\n          rel === \"index.html\" ? \"/\" : `/${rel.replace(/\\.html$/, \"\")}`;\n        routes.set(pathName, {\n          id: routeId(pathName),\n          path: pathName,\n          title: titleFromRoutePath(pathName),\n          sourceFile: normalizeSlash(path.relative(absoluteRoot, file)),\n          sourceKind: \"html\",\n        });\n      }\n    }\n  }\n\n  return [...routes.values()].sort((a, b) => {\n    if (a.path === \"/\") return -1;\n    if (b.path === \"/\") return 1;\n    return a.path.localeCompare(b.path);\n  });\n}\n\nasync function probeDevServer(url: string): Promise<boolean> {\n  const controller = new AbortController();\n  const timeout = setTimeout(() => controller.abort(), 800);\n  try {\n    const response = await fetch(url, {\n      method: \"GET\",\n      signal: controller.signal,\n    });\n    return response.status < 500;\n  } catch {\n    return false;\n  } finally {\n    clearTimeout(timeout);\n  }\n}\n\nasync function resolveDevServerUrl(url?: string): Promise<string> {\n  if (url) return normalizeHttpUrl(url);\n  for (const candidate of DEFAULT_DEV_SERVER_CANDIDATES) {\n    if (await probeDevServer(candidate)) return candidate;\n  }\n  return DEFAULT_DEV_SERVER_CANDIDATES[0]!;\n}\n\nasync function ensureRouteManifest(options: {\n  root: string;\n  routeManifestPath: string;\n  routes: DesignConnectRoute[];\n  devServerUrl: string;\n  dryRun: boolean;\n}): Promise<{ path: string; created: boolean }> {\n  const manifestPath = path.isAbsolute(options.routeManifestPath)\n    ? options.routeManifestPath\n    : path.join(options.root, options.routeManifestPath);\n  if (fsSync.existsSync(manifestPath)) {\n    return { path: manifestPath, created: false };\n  }\n  if (!options.dryRun) {\n    await fs.mkdir(path.dirname(manifestPath), { recursive: true });\n    await fs.writeFile(\n      manifestPath,\n      `${JSON.stringify(\n        {\n          version: 1,\n          sourceType: \"localhost\",\n          devServerUrl: options.devServerUrl,\n          rootPath: options.root,\n          routes: options.routes,\n          generatedAt: new Date().toISOString(),\n        },\n        null,\n        2,\n      )}\\n`,\n      \"utf8\",\n    );\n  }\n  return { path: manifestPath, created: !options.dryRun };\n}\n\nexport async function prepareDesignConnectManifest(\n  options: Partial<DesignConnectArgs> & { root?: string } = {},\n): Promise<DesignConnectManifest> {\n  const root = path.resolve(options.root ?? process.cwd());\n  const port = options.port ?? DEFAULT_BRIDGE_PORT;\n  const devServerUrl = await resolveDevServerUrl(options.url);\n  const bridgeUrl = `http://127.0.0.1:${port}`;\n  const routes = discoverDesignRoutes(root);\n  const routeManifest = await ensureRouteManifest({\n    root,\n    routeManifestPath: options.routeManifest ?? ROUTE_MANIFEST_FILE,\n    routes,\n    devServerUrl,\n    dryRun: Boolean(options.dryRun),\n  });\n  const generatedAt = new Date().toISOString();\n\n  return {\n    version: 1,\n    source: \"agent-native-design-connect\",\n    sourceType: \"localhost\",\n    localOnly: true,\n    devServerUrl,\n    bridgeUrl,\n    rootPath: root,\n    routeManifestPath: routeManifest.path,\n    routeManifestCreated: routeManifest.created,\n    routes,\n    routeCount: routes.length,\n    generatedAt,\n    capabilities: BRIDGE_OPERATIONS.map((operation) => ({\n      operation,\n      status:\n        operation === \"readFile\" ||\n        operation === \"applyEdit\" ||\n        operation === \"writeFile\"\n          ? \"planned\"\n          : \"available\",\n      reason:\n        operation === \"writeFile\"\n          ? \"The bridge advertises the contract before enabling local file writes.\"\n          : undefined,\n    })),\n  };\n}\n\nfunction sendJson(\n  res: ServerResponse,\n  statusCode: number,\n  body: Record<string, unknown>,\n) {\n  res.writeHead(statusCode, {\n    \"content-type\": \"application/json; charset=utf-8\",\n    \"access-control-allow-origin\": \"*\",\n    \"access-control-allow-methods\": \"GET, OPTIONS\",\n    \"access-control-allow-headers\": \"content-type\",\n    \"access-control-allow-private-network\": \"true\",\n  });\n  res.end(`${JSON.stringify(body, null, 2)}\\n`);\n}\n\nexport async function startDesignConnectBridge(\n  manifest: DesignConnectManifest,\n): Promise<DesignConnectBridge> {\n  const server = http.createServer(\n    (req: IncomingMessage, res: ServerResponse) => {\n      if (req.method === \"OPTIONS\") {\n        sendJson(res, 204, {});\n        return;\n      }\n      const pathname = new URL(req.url ?? \"/\", manifest.bridgeUrl).pathname;\n      if (pathname === \"/\" || pathname === \"/manifest.json\") {\n        sendJson(res, 200, manifest as unknown as Record<string, unknown>);\n        return;\n      }\n      if (pathname === \"/routes.json\") {\n        sendJson(res, 200, {\n          version: 1,\n          sourceType: \"localhost\",\n          devServerUrl: manifest.devServerUrl,\n          rootPath: manifest.rootPath,\n          routes: manifest.routes,\n          generatedAt: manifest.generatedAt,\n        });\n        return;\n      }\n      if (pathname === \"/health\") {\n        sendJson(res, 200, { ok: true, source: manifest.source });\n        return;\n      }\n      sendJson(res, 404, { ok: false, error: \"not found\" });\n    },\n  );\n\n  await new Promise<void>((resolve, reject) => {\n    server.once(\"error\", reject);\n    server.listen(new URL(manifest.bridgeUrl).port, \"127.0.0.1\", () => {\n      server.off(\"error\", reject);\n      resolve();\n    });\n  });\n\n  return { server, manifest };\n}\n\nfunction printHelp() {\n  console.log(`Usage:\n  agent-native design connect [options]\n\nOptions:\n  --url <url>             Dev server URL to inspect (auto-detected if omitted)\n  --port <number>         Local bridge port (default ${DEFAULT_BRIDGE_PORT})\n  --root <path>           App/repo root for route discovery (default cwd)\n  --route-manifest <path> Non-destructive route manifest output path\n  --json                  Print the manifest JSON and exit\n  --once                  Prepare/scaffold the manifest and exit\n  --dry-run               Print what would be exposed without writing files`);\n}\n\nexport async function runDesign(argv: string[]) {\n  const subcommand = argv[0];\n  if (subcommand !== \"connect\") {\n    if (\n      subcommand === \"help\" ||\n      subcommand === \"--help\" ||\n      subcommand === \"-h\"\n    ) {\n      printHelp();\n      return 0;\n    }\n    console.error(\"Usage: agent-native design connect [options]\");\n    return 1;\n  }\n\n  const parsed = parseDesignConnectArgs(argv);\n  if (parsed.help) {\n    printHelp();\n    return 0;\n  }\n\n  const manifest = await prepareDesignConnectManifest(parsed);\n  if (parsed.json || parsed.once || parsed.dryRun) {\n    console.log(JSON.stringify(manifest, null, 2));\n    return 0;\n  }\n\n  const bridge = await startDesignConnectBridge(manifest);\n  console.error(\"Design localhost bridge running\");\n  console.error(`Bridge:   ${manifest.bridgeUrl}`);\n  console.error(`Manifest: ${manifest.bridgeUrl}/manifest.json`);\n  console.error(`Routes:   ${manifest.routeCount}`);\n  console.error(`Dev URL:  ${manifest.devServerUrl}`);\n\n  return await new Promise<number>((resolve) => {\n    const stop = () => {\n      bridge.server.close(() => resolve(0));\n    };\n    for (const signal of [\"SIGINT\", \"SIGTERM\", \"SIGHUP\"] as const) {\n      process.once(signal, stop);\n    }\n  });\n}\n"]}

package/dist/cli/index.js

@@ -651,6 +651,18 @@ switch (command) {
         });
         break;
     }
+    case "design": {
+        import("./design-connect.js")
+            .then(async (m) => {
+            const code = await m.runDesign(args);
+            process.exit(code);
+        })
+            .catch((err) => {
+            console.error(err?.message ?? err);
+            process.exit(1);
+        });
+        break;
+    }
     case "recap": {
         // PR visual recap helpers used by the GitHub Action. Promoted to the CLI
         // so an installed repo's workflow can call `agent-native recap …` instead
@@ -822,6 +834,9 @@ Usage:
                                 Launch Content in local-file mode for a local
                                 docs/content folder. Use --no-open, --port N,
                                 or --profile docs/no-bookkeeping as needed.
+  agent-native design connect  Start a localhost Design bridge for a running
+                                dev server. Use --url, --port, --root, or
+                                --json to print the route/source manifest.
   agent-native recap <cmd>      PR visual recap setup and GitHub Action helpers.
                                 Run 'agent-native recap help' for subcommands.
   agent-native plan <cmd>       Plan helpers for block catalogs and local files.