npm - @prmichaelsen/acp-visualizer - Versions diffs - 0.1.0 → 0.1.2 - Mend

@prmichaelsen/acp-visualizer 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (159) hide show

package/package.json +8 -10
package/src/components/ExtraFieldsBadge.tsx +1 -1
package/src/components/FilterBar.tsx +1 -1
package/src/components/Header.tsx +1 -1
package/src/components/MilestoneTable.tsx +1 -1
package/src/components/MilestoneTree.tsx +2 -2
package/src/components/StatusBadge.tsx +1 -1
package/src/components/StatusDot.tsx +1 -1
package/src/components/TaskList.tsx +1 -1
package/src/routes/__root.tsx +5 -5
package/src/routes/api/watch.ts +1 -1
package/src/routes/index.tsx +2 -2
package/src/routes/milestones.tsx +7 -7
package/src/routes/search.tsx +4 -4
package/src/routes/tasks.tsx +3 -3
package/src/services/progress-database.service.ts +3 -3
package/agent/commands/acp.clarification-address.md +0 -417
package/agent/commands/acp.clarification-capture.md +0 -386
package/agent/commands/acp.clarification-create.md +0 -437
package/agent/commands/acp.clarifications-research.md +0 -326
package/agent/commands/acp.command-create.md +0 -432
package/agent/commands/acp.design-create.md +0 -286
package/agent/commands/acp.design-reference.md +0 -355
package/agent/commands/acp.handoff.md +0 -270
package/agent/commands/acp.index.md +0 -423
package/agent/commands/acp.init.md +0 -546
package/agent/commands/acp.package-create.md +0 -895
package/agent/commands/acp.package-info.md +0 -212
package/agent/commands/acp.package-install.md +0 -539
package/agent/commands/acp.package-list.md +0 -280
package/agent/commands/acp.package-publish.md +0 -541
package/agent/commands/acp.package-remove.md +0 -293
package/agent/commands/acp.package-search.md +0 -307
package/agent/commands/acp.package-update.md +0 -361
package/agent/commands/acp.package-validate.md +0 -540
package/agent/commands/acp.pattern-create.md +0 -386
package/agent/commands/acp.plan.md +0 -587
package/agent/commands/acp.proceed.md +0 -882
package/agent/commands/acp.project-create.md +0 -675
package/agent/commands/acp.project-info.md +0 -312
package/agent/commands/acp.project-list.md +0 -226
package/agent/commands/acp.project-remove.md +0 -379
package/agent/commands/acp.project-set.md +0 -227
package/agent/commands/acp.project-update.md +0 -307
package/agent/commands/acp.projects-restore.md +0 -228
package/agent/commands/acp.projects-sync.md +0 -347
package/agent/commands/acp.report.md +0 -407
package/agent/commands/acp.resume.md +0 -239
package/agent/commands/acp.sessions.md +0 -301
package/agent/commands/acp.status.md +0 -293
package/agent/commands/acp.sync.md +0 -364
package/agent/commands/acp.task-create.md +0 -500
package/agent/commands/acp.update.md +0 -302
package/agent/commands/acp.validate.md +0 -466
package/agent/commands/acp.version-check-for-updates.md +0 -276
package/agent/commands/acp.version-check.md +0 -191
package/agent/commands/acp.version-update.md +0 -289
package/agent/commands/command.template.md +0 -339
package/agent/commands/git.commit.md +0 -526
package/agent/commands/git.init.md +0 -514
package/agent/commands/tanstack-cloudflare.deploy.md +0 -272
package/agent/commands/tanstack-cloudflare.tail.md +0 -275
package/agent/design/.gitkeep +0 -0
package/agent/design/design.template.md +0 -154
package/agent/design/local.dashboard-layout-routing.md +0 -288
package/agent/design/local.data-model-yaml-parsing.md +0 -310
package/agent/design/local.search-filtering.md +0 -331
package/agent/design/local.server-api-auto-refresh.md +0 -235
package/agent/design/local.table-tree-views.md +0 -299
package/agent/design/local.visualizer-requirements.md +0 -349
package/agent/design/requirements.template.md +0 -387
package/agent/index/.gitkeep +0 -0
package/agent/index/acp.core.yaml +0 -137
package/agent/index/local.main.template.yaml +0 -37
package/agent/manifest.template.yaml +0 -13
package/agent/manifest.yaml +0 -302
package/agent/milestones/.gitkeep +0 -0
package/agent/milestones/milestone-1-project-scaffold-data-pipeline.md +0 -67
package/agent/milestones/milestone-1-{title}.template.md +0 -206
package/agent/milestones/milestone-2-dashboard-views-interaction.md +0 -79
package/agent/package.template.yaml +0 -86
package/agent/patterns/.gitkeep +0 -0
package/agent/patterns/bootstrap.template.md +0 -1237
package/agent/patterns/pattern.template.md +0 -382
package/agent/patterns/tanstack-cloudflare.acl-permissions.md +0 -332
package/agent/patterns/tanstack-cloudflare.action-bar-item.md +0 -416
package/agent/patterns/tanstack-cloudflare.api-route-handlers.md +0 -401
package/agent/patterns/tanstack-cloudflare.auth-session-management.md +0 -387
package/agent/patterns/tanstack-cloudflare.card-and-list.md +0 -271
package/agent/patterns/tanstack-cloudflare.chat-engine.md +0 -353
package/agent/patterns/tanstack-cloudflare.confirmation-tokens.md +0 -346
package/agent/patterns/tanstack-cloudflare.durable-objects-websocket.md +0 -516
package/agent/patterns/tanstack-cloudflare.email-service.md +0 -431
package/agent/patterns/tanstack-cloudflare.expander.md +0 -98
package/agent/patterns/tanstack-cloudflare.fcm-push.md +0 -115
package/agent/patterns/tanstack-cloudflare.firebase-anonymous-sessions.md +0 -441
package/agent/patterns/tanstack-cloudflare.firebase-auth.md +0 -348
package/agent/patterns/tanstack-cloudflare.firebase-firestore.md +0 -550
package/agent/patterns/tanstack-cloudflare.firebase-storage.md +0 -369
package/agent/patterns/tanstack-cloudflare.form-controls.md +0 -145
package/agent/patterns/tanstack-cloudflare.global-search-context.md +0 -93
package/agent/patterns/tanstack-cloudflare.image-carousel.md +0 -126
package/agent/patterns/tanstack-cloudflare.library-services.md +0 -553
package/agent/patterns/tanstack-cloudflare.lightbox.md +0 -169
package/agent/patterns/tanstack-cloudflare.markdown-content.md +0 -115
package/agent/patterns/tanstack-cloudflare.mention-suggestions.md +0 -98
package/agent/patterns/tanstack-cloudflare.modal.md +0 -156
package/agent/patterns/tanstack-cloudflare.nextjs-to-tanstack-routing.md +0 -461
package/agent/patterns/tanstack-cloudflare.notifications-engine.md +0 -151
package/agent/patterns/tanstack-cloudflare.oauth-token-refresh.md +0 -90
package/agent/patterns/tanstack-cloudflare.og-metadata.md +0 -296
package/agent/patterns/tanstack-cloudflare.pagination.md +0 -442
package/agent/patterns/tanstack-cloudflare.pill-input.md +0 -220
package/agent/patterns/tanstack-cloudflare.provider-adapter.md +0 -401
package/agent/patterns/tanstack-cloudflare.rate-limiting.md +0 -323
package/agent/patterns/tanstack-cloudflare.scheduled-tasks.md +0 -338
package/agent/patterns/tanstack-cloudflare.searchable-settings.md +0 -375
package/agent/patterns/tanstack-cloudflare.slide-over.md +0 -129
package/agent/patterns/tanstack-cloudflare.ssr-preload.md +0 -571
package/agent/patterns/tanstack-cloudflare.third-party-api-integration.md +0 -508
package/agent/patterns/tanstack-cloudflare.toast-system.md +0 -142
package/agent/patterns/tanstack-cloudflare.unified-header.md +0 -280
package/agent/patterns/tanstack-cloudflare.user-scoped-collections.md +0 -628
package/agent/patterns/tanstack-cloudflare.websocket-manager.md +0 -237
package/agent/patterns/tanstack-cloudflare.wrangler-configuration.md +0 -358
package/agent/patterns/tanstack-cloudflare.zod-schema-validation.md +0 -336
package/agent/progress.template.yaml +0 -161
package/agent/progress.yaml +0 -145
package/agent/schemas/package.schema.yaml +0 -276
package/agent/scripts/acp.common.sh +0 -1781
package/agent/scripts/acp.install.sh +0 -333
package/agent/scripts/acp.package-create.sh +0 -924
package/agent/scripts/acp.package-info.sh +0 -288
package/agent/scripts/acp.package-install.sh +0 -893
package/agent/scripts/acp.package-list.sh +0 -311
package/agent/scripts/acp.package-publish.sh +0 -420
package/agent/scripts/acp.package-remove.sh +0 -348
package/agent/scripts/acp.package-search.sh +0 -156
package/agent/scripts/acp.package-update.sh +0 -517
package/agent/scripts/acp.package-validate.sh +0 -1018
package/agent/scripts/acp.uninstall.sh +0 -85
package/agent/scripts/acp.version-check-for-updates.sh +0 -98
package/agent/scripts/acp.version-check.sh +0 -47
package/agent/scripts/acp.version-update.sh +0 -176
package/agent/scripts/acp.yaml-parser.sh +0 -985
package/agent/scripts/acp.yaml-validate.sh +0 -205
package/agent/tasks/.gitkeep +0 -0
package/agent/tasks/milestone-1-project-scaffold-data-pipeline/task-1-initialize-tanstack-start-project.md +0 -210
package/agent/tasks/milestone-1-project-scaffold-data-pipeline/task-2-implement-data-model-yaml-parser.md +0 -294
package/agent/tasks/milestone-1-project-scaffold-data-pipeline/task-3-build-server-api-data-loading.md +0 -193
package/agent/tasks/milestone-1-project-scaffold-data-pipeline/task-4-add-auto-refresh-sse.md +0 -262
package/agent/tasks/milestone-2-dashboard-views-interaction/task-10-polish-integration-testing.md +0 -156
package/agent/tasks/milestone-2-dashboard-views-interaction/task-5-build-dashboard-layout-routing.md +0 -178
package/agent/tasks/milestone-2-dashboard-views-interaction/task-6-build-overview-page.md +0 -141
package/agent/tasks/milestone-2-dashboard-views-interaction/task-7-implement-milestone-table-view.md +0 -153
package/agent/tasks/milestone-2-dashboard-views-interaction/task-8-implement-milestone-tree-view.md +0 -174
package/agent/tasks/milestone-2-dashboard-views-interaction/task-9-implement-search-filtering.md +0 -233
package/agent/tasks/task-1-{title}.template.md +0 -244
package/vitest.config.ts +0 -27

package/agent/patterns/tanstack-cloudflare.og-metadata.md DELETED Viewed

@@ -1,296 +0,0 @@
-# OG Metadata Pattern
-**Category**: Code
-**Applicable To**: TanStack Start routes that need social media link previews (Open Graph + Twitter Cards)
-**Status**: Stable
----
-## Overview
-Every route that can be shared on social media (iMessage, Slack, Discord, Twitter/X, Facebook) needs server-rendered Open Graph and Twitter Card meta tags in the HTML `<head>`. TanStack Start provides a `head()` function on route definitions that runs during SSR — this is the only mechanism that works for social crawlers, which do not execute JavaScript.
-This pattern documents how to add OG metadata to routes, covering static pages, dynamic content pages with SSR loader data, and the global defaults that all routes inherit.
----
-## When to Use This Pattern
-**Use this pattern when:**
-- Adding a new route that users might share (link previews)
-- Adding SSR data to a route that already has OG tags
-- Creating shareable content pages (memories, profiles, invite links)
-- Debugging why a shared link shows the wrong preview
-**Don't use this pattern when:**
-- The route is behind authentication with no public preview needed
-- The route is an API endpoint (`/api/*`)
----
-## Core Principles
-1. **SSR-Only**: Social crawlers don't run JS — `head()` runs server-side so tags appear in the initial HTML response
-2. **Route-Level Overrides**: Child route `head()` tags override parent (root) defaults by property
-3. **Graceful Fallback**: If loader data fails, return generic site-level OG tags — never render a page with no OG
-4. **Auth After Meta**: For shareable links (invite codes), check auth in the component, not `beforeLoad`, so crawlers see meta tags without being redirected
----
-## Implementation
-### Global Defaults (Root Route)
-`src/routes/__root.tsx` defines site-wide fallback OG tags via `createRootRoute({ head() })`:
-```typescript
-export const Route = createRootRoute({
-  head: () => ({
-    meta: [
-      { charSet: 'utf-8' },
-      { name: 'viewport', content: 'width=device-width, initial-scale=1, ...' },
-      { title: 'agentbase — social AI with memory, ghosts, and shared spaces' },
-      { name: 'description', content: 'A social AI platform with persistent memory...' },
-      { property: 'og:type', content: 'website' },
-      { property: 'og:site_name', content: 'agentbase' },
-      { property: 'og:title', content: 'agentbase — social AI with memory, ghosts, and shared spaces' },
-      { property: 'og:description', content: 'A social AI platform with persistent memory...' },
-      { property: 'og:image', content: 'https://agentbase.me/icon-512x512.png' },
-      { name: 'twitter:card', content: 'summary_large_image' },
-      { name: 'twitter:title', content: 'agentbase — ...' },
-      { name: 'twitter:description', content: '...' },
-      { name: 'twitter:image', content: 'https://agentbase.me/icon-512x512.png' },
-    ],
-  }),
-  component: RootComponent,
-})
-```
-The root also renders `<HeadContent />` inside `<head>` to inject these tags into the HTML.
-### Static Page OG
-For pages with fixed content (terms, privacy, homepage, invite links):
-```typescript
-export const Route = createFileRoute('/terms')({
-  head: () => ({
-    meta: [
-      { title: 'Terms of Service — agentbase' },
-      { name: 'description', content: 'Terms of service for agentbase.' },
-      { property: 'og:title', content: 'Terms of Service — agentbase' },
-      { property: 'og:description', content: 'Terms of service for agentbase.' },
-      { property: 'og:type', content: 'website' },
-      { property: 'og:site_name', content: 'agentbase' },
-      { property: 'og:image', content: 'https://agentbase.me/icon-512x512.png' },
-      { name: 'twitter:card', content: 'summary' },
-      { name: 'twitter:title', content: 'Terms of Service — agentbase' },
-      { name: 'twitter:description', content: 'Terms of service for agentbase.' },
-      { name: 'twitter:image', content: 'https://agentbase.me/icon-512x512.png' },
-    ],
-  }),
-  component: TermsPage,
-})
-```
-### Dynamic Content OG (SSR Loader)
-For pages where OG tags depend on data (memory detail, profile), use `createServerFn` + `loader` + `head(loaderData)`:
-```typescript
-// 1. Server function fetches data during SSR
-const fetchMemoryDetail = createServerFn({ method: 'GET' })
-  .inputValidator((data: { memoryId: string }) => data)
-  .handler(async ({ data }) => {
-    // Fetch memory from backend
-    const memory = await svc.memories.get(userId, data.memoryId)
-    return { memory }
-  })
-// 2. Route loader calls server function
-export const Route = createFileRoute('/memories/$memoryId')({
-  loader: async ({ params }) => {
-    const memoryData = await fetchMemoryDetail({ data: { memoryId: params.memoryId } })
-    return { memoryData }
-  },
-  // 3. head() receives loader data and generates dynamic tags
-  head: (({ loaderData }: any) => {
-    const memory = loaderData?.memoryData?.memory
-    if (!memory) {
-      return {
-        meta: [
-          { title: 'Memory — agentbase' },
-          { property: 'og:title', content: 'Memory — agentbase' },
-          { property: 'og:image', content: 'https://agentbase.me/icon-512x512.png' },
-          // ... fallback tags
-        ],
-      }
-    }
-    const rawTitle = memory.title || memory.content?.split('\n')[0] || 'Memory'
-    const title = rawTitle.length > 60 ? rawTitle.substring(0, 57) + '...' : rawTitle
-    const description = (memory.content ?? '').substring(0, 200)
-    return {
-      meta: [
-        { title: `${title} — agentbase` },
-        { name: 'description', content: description },
-        { property: 'og:title', content: title },
-        { property: 'og:description', content: description },
-        { property: 'og:type', content: 'article' },
-        { property: 'og:site_name', content: 'agentbase' },
-        { property: 'og:image', content: 'https://agentbase.me/icon-512x512.png' },
-        { name: 'twitter:card', content: 'summary' },
-        { name: 'twitter:title', content: title },
-        { name: 'twitter:description', content: description },
-        { name: 'twitter:image', content: 'https://agentbase.me/icon-512x512.png' },
-      ],
-    }
-  }) as any,
-  component: MemoryDetailPage,
-})
-```
-### Dynamic OG Image (Profile Pages)
-Profile pages use the `/api/storage/image` proxy to serve user-uploaded profile pictures as OG images:
-```typescript
-head: (({ loaderData }: any) => {
-  const profile = loaderData?.profileForHead
-  if (profile && profile.is_published) {
-    const image = profile.profile_picture_path
-      ? `https://agentbase.me/api/storage/image?path=${encodeURIComponent(profile.profile_picture_path)}&context=profile`
-      : 'https://agentbase.me/icon-512x512.png'
-    return {
-      meta: [
-        { property: 'og:image', content: image },
-        { name: 'twitter:image', content: image },
-        // ... other tags
-      ],
-    }
-  }
-  // fallback for unpublished profiles
-}) as any
-```
-### Shareable Invite Links (Auth After Meta)
-For pages like `/friend-links/$code`, `/group-links/$code`, `/dm-links/$code` — use **static OG** and defer auth to the component:
-```typescript
-export const Route = createFileRoute('/friend-links/$code')({
-  // Static head — no loader needed, crawlers see this immediately
-  head: () => ({
-    meta: [
-      { title: 'Friend Invite — agentbase' },
-      { property: 'og:title', content: 'Friend Invite — agentbase' },
-      { property: 'og:description', content: "You've been invited to connect on agentbase." },
-      // ...
-    ],
-  }),
-  // Auth check happens HERE, not in beforeLoad — crawlers never hit this
-  component: FriendLinkPage,
-})
-```
----
-## Required Meta Tags Checklist
-Every route with OG metadata should include all of these:
-| Tag | Property | Notes |
-|-----|----------|-------|
-| `<title>` | `{ title: '...' }` | Browser tab title |
-| `description` | `{ name: 'description', content: '...' }` | Search engine description |
-| `og:title` | `{ property: 'og:title', content: '...' }` | Social card title |
-| `og:description` | `{ property: 'og:description', content: '...' }` | Social card description |
-| `og:type` | `{ property: 'og:type', content: '...' }` | `website` or `article` |
-| `og:site_name` | `{ property: 'og:site_name', content: 'agentbase' }` | Always `agentbase` |
-| `og:image` | `{ property: 'og:image', content: '...' }` | Absolute URL, min 200x200 |
-| `twitter:card` | `{ name: 'twitter:card', content: '...' }` | `summary` or `summary_large_image` |
-| `twitter:title` | `{ name: 'twitter:title', content: '...' }` | Same as `og:title` |
-| `twitter:description` | `{ name: 'twitter:description', content: '...' }` | Same as `og:description` |
-| `twitter:image` | `{ name: 'twitter:image', content: '...' }` | Same as `og:image` |
----
-## OG Type Reference
-| Route Type | `og:type` | `twitter:card` |
-|------------|-----------|----------------|
-| Homepage / static pages | `website` | `summary_large_image` |
-| Memory detail | `article` | `summary` |
-| Profile page | `profile` | `summary` |
-| Space / group pages | `website` | `summary` |
-| Invite links | `website` | `summary` |
----
-## Anti-Patterns
-### Auth in beforeLoad for shareable pages
-**Description**: Redirecting unauthenticated users in `beforeLoad` before `head()` runs.
-**Why it's bad**: Social crawlers are unauthenticated — they get redirected to login and never see OG tags.
-**Instead**: Check auth in the component, not `beforeLoad`. The `head()` function runs regardless.
-### Missing fallback when loader fails
-**Description**: Not handling the case where `loaderData` is undefined in `head()`.
-**Why it's bad**: A failed fetch produces a page with no OG tags — shared links show a blank preview.
-**Instead**: Always return fallback OG tags when data is missing.
-### Relative OG image URLs
-**Description**: Using `/icon-512x512.png` instead of `https://agentbase.me/icon-512x512.png`.
-**Why it's bad**: Some social crawlers don't resolve relative URLs.
-**Instead**: Always use absolute URLs for `og:image` and `twitter:image`.
----
-## Implementation References
-- **Root defaults**: `src/routes/__root.tsx` (lines 56-108)
-- **Memory detail (dynamic)**: `src/routes/memories/$memoryId.tsx` (lines 131-160)
-- **Profile (dynamic image)**: `src/routes/profile/$userId.tsx` (lines 90-127)
-- **Spaces (conditional image)**: `src/routes/spaces/$spaceId.tsx` (lines 41-53)
-- **Invite links (static, auth-deferred)**: `src/routes/friend-links/$code.tsx` (lines 15-29)
-- **Image proxy**: `src/routes/api/storage/image.tsx`
-- **Static assets**: `public/icon-512x512.png`, `public/the_void_02-512.png`
-## Related Patterns
-- **[SSR Preload](./ssr-preload.md)**: Server-side data loading that feeds into `head()` for dynamic OG
-- **[Firebase Auth](./tanstack-cloudflare.firebase-auth.md)**: Auth patterns — important to understand which routes gate auth in `beforeLoad` vs component
-- **[Firebase Storage](./tanstack-cloudflare.firebase-storage.md)**: Image proxy endpoint used for dynamic OG images
----
-## Checklist for Implementation
-- [ ] `head()` function defined on route with all required meta tags
-- [ ] `og:image` and `twitter:image` use absolute URLs
-- [ ] Dynamic pages have server function + loader feeding `head(loaderData)`
-- [ ] `head()` handles missing/failed loader data with fallback tags
-- [ ] Shareable pages defer auth to component (not `beforeLoad`)
-- [ ] Title truncated to 60 chars max, description to 200 chars max
-- [ ] `og:type` is appropriate (`website` vs `article` vs `profile`)
-- [ ] `og:site_name` is `agentbase`
----
-**Status**: Stable
-**Recommendation**: Follow this pattern for every new route. Verify OG tags by pasting the URL into the Twitter Card Validator or Facebook Sharing Debugger.
-**Last Updated**: 2026-03-14
-**Contributors**: Community