@cat-factory/app 0.23.1 → 0.25.0

package/app/components/board/AddTaskModal.vue

@@ -42,6 +42,9 @@ const container = computed(() =>
 const title = ref('')
 const description = ref('')
 const saving = ref(false)
+// Whether the user marks this as a purely technical task up front (a refactor /
+// non-functional change). Left off ⇒ the engine infers it from the spec phase.
+const technical = ref(false)
 
 // The kind of task being created. `recurring` is special: it is created through the
 // recurring-pipeline schedule flow (a schedule on the service frame), so picking it
@@ -276,6 +279,7 @@ watch(open, (isOpen) => {
   description.value = ''
   saving.value = false
   taskType.value = 'feature'
+  technical.value = false
   severity.value = ''
   stepsToReproduce.value = ''
   timeboxHours.value = undefined
@@ -339,6 +343,7 @@ async function add() {
       ...(Object.keys(agentConfigValues.value).length
         ? { agentConfig: agentConfigValues.value }
         : {}),
+      ...(technical.value ? { technical: true } : {}),
     })
     if (block) {
       const failed = await linkPending(block.id, pendingContext.value)
@@ -448,6 +453,19 @@ async function add() {
             />
           </UFormField>
 
+          <UCheckbox v-model="technical" name="technical">
+            <template #label>
+              <span class="text-sm text-slate-200">Technical task</span>
+            </template>
+            <template #description>
+              <span class="text-[11px] text-slate-500">
+                A refactor / non-functional / internal change. The implementer treats the task
+                definition as primary and the spec as a regression reference; leave off to let the
+                spec phase decide.
+              </span>
+            </template>
+          </UCheckbox>
+
           <!-- Per-type fields. -->
           <div v-if="taskType === 'bug'" class="grid grid-cols-2 gap-3">
             <UFormField label="Severity">

package/app/components/fragments/FragmentLibraryPanel.vue

@@ -4,10 +4,11 @@
 // + resync), and review the merged catalog (built-in ∪ account ∪ workspace) an
 // agent is selected from per run. Workspace-tier focused; the resolved view shows
 // every tier so the inheritance is visible.
-import type { ResolvedFragment } from '~/types/domain'
+import type { DocumentSourceKind, ResolvedFragment } from '~/types/domain'
 
 const ui = useUiStore()
 const library = useFragmentLibraryStore()
+const documents = useDocumentsStore()
 const toast = useToast()
 
 const open = computed({
@@ -18,10 +19,13 @@ const open = computed({
 })
 
 watch(open, (isOpen) => {
-  if (isOpen) void library.probe()
+  if (isOpen) {
+    void library.probe()
+    void documents.probe()
+  }
 })
 
-type Tab = 'catalog' | 'authored' | 'sources'
+type Tab = 'catalog' | 'authored' | 'documents' | 'sources'
 const tab = ref<Tab>('catalog')
 
 const tierLabel: Record<ResolvedFragment['tier'], string> = {
@@ -80,6 +84,42 @@ async function removeFragment(id: string) {
   }
 }
 
+// ---- document-backed (living) fragments -----------------------------------
+// Link a Confluence/Notion page or GitHub file as a fragment that is re-resolved
+// from the source at run time (a living source of truth, not a frozen snapshot).
+const docDraft = ref({ source: '' as DocumentSourceKind | '', ref: '', tags: '' })
+const docDraftValid = computed(() => docDraft.value.source && docDraft.value.ref.trim())
+
+/** The board's existing document-backed fragments (workspace tier). */
+const documentFragments = computed(() => library.fragments.filter((f) => f.documentRef))
+
+async function linkDocumentFragment() {
+  if (!docDraftValid.value) return
+  try {
+    await library.createDocumentFragment({
+      source: docDraft.value.source as DocumentSourceKind,
+      ref: docDraft.value.ref.trim(),
+      tags: docDraft.value.tags
+        .split(',')
+        .map((t) => t.trim())
+        .filter(Boolean),
+    })
+    docDraft.value = { source: '', ref: '', tags: '' }
+    toast.add({ title: 'Document linked as a living fragment', icon: 'i-lucide-link' })
+  } catch (e) {
+    notifyError('Could not link document', e)
+  }
+}
+
+async function refreshFragment(id: string) {
+  try {
+    await library.refreshDocumentFragment(id)
+    toast.add({ title: 'Fragment re-resolved from source', icon: 'i-lucide-refresh-cw' })
+  } catch (e) {
+    notifyError('Could not refresh fragment', e)
+  }
+}
+
 // ---- repo sources ----------------------------------------------------------
 const sourceDraft = ref({ repoOwner: '', repoName: '', dirPath: '', gitRef: '' })
 const sourceValid = computed(
@@ -150,7 +190,7 @@ async function unlinkSource(id: string) {
 
         <div class="flex gap-2">
           <UButton
-            v-for="t in ['catalog', 'authored', 'sources'] as Tab[]"
+            v-for="t in ['catalog', 'authored', 'documents', 'sources'] as Tab[]"
             :key="t"
             :color="tab === t ? 'primary' : 'neutral'"
             :variant="tab === t ? 'solid' : 'ghost'"
@@ -162,7 +202,9 @@ async function unlinkSource(id: string) {
                 ? 'Resolved catalog'
                 : t === 'authored'
                   ? 'This board'
-                  : 'Repo sources'
+                  : t === 'documents'
+                    ? 'Documents'
+                    : 'Repo sources'
             }}
           </UButton>
         </div>
@@ -183,6 +225,15 @@ async function unlinkSource(id: string) {
               <UBadge size="xs" :color="tierColor[f.tier]" variant="subtle">
                 {{ tierLabel[f.tier] }}
               </UBadge>
+              <UBadge
+                v-if="f.documentRef"
+                size="xs"
+                color="success"
+                variant="subtle"
+                icon="i-lucide-radio"
+              >
+                Live · {{ f.documentRef.source }}
+              </UBadge>
               <span class="ml-auto font-mono text-[11px] text-slate-500">{{ f.id }}</span>
             </div>
             <p class="mt-1 text-sm text-slate-400">{{ f.summary }}</p>
@@ -249,6 +300,91 @@ async function unlinkSource(id: string) {
           </div>
         </div>
 
+        <!-- Document-backed (living) fragments -->
+        <div v-else-if="tab === 'documents'" class="flex flex-col gap-3">
+          <p class="text-xs text-slate-500">
+            Link a Confluence/Notion page or a GitHub file as a best-practice fragment. Its guidance
+            is re-resolved from the source at run time — edit the doc and the next agent run follows
+            the new version (no re-import).
+          </p>
+
+          <div
+            v-for="f in documentFragments"
+            :key="f.id"
+            class="flex items-start gap-2 rounded-md border border-slate-800 bg-slate-900/60 p-3"
+          >
+            <UIcon name="i-lucide-radio" class="mt-0.5 h-4 w-4 text-emerald-400" />
+            <div class="min-w-0">
+              <div class="flex items-center gap-2">
+                <span class="font-medium text-slate-100">{{ f.title }}</span>
+                <UBadge size="xs" color="success" variant="subtle">
+                  {{ f.documentRef?.source }}
+                </UBadge>
+              </div>
+              <p class="text-sm text-slate-400">{{ f.summary }}</p>
+              <p v-if="f.resolvedAt" class="text-[11px] text-slate-500">
+                last resolved {{ new Date(f.resolvedAt).toLocaleString() }}
+              </p>
+            </div>
+            <div class="ml-auto flex gap-1">
+              <UButton
+                icon="i-lucide-refresh-cw"
+                size="xs"
+                variant="ghost"
+                :loading="library.loading"
+                title="Re-resolve from source now"
+                @click="refreshFragment(f.id)"
+              />
+              <UButton
+                icon="i-lucide-trash-2"
+                size="xs"
+                color="error"
+                variant="ghost"
+                @click="removeFragment(f.id)"
+              />
+            </div>
+          </div>
+          <p v-if="!documentFragments.length" class="text-sm text-slate-500">
+            No document-backed fragments yet. Link one below.
+          </p>
+
+          <div class="rounded-md border border-slate-800 p-3">
+            <p class="mb-2 text-sm font-medium">Link a document</p>
+            <div v-if="!documents.connectedSources.length" class="text-sm text-slate-500">
+              Connect a document source (Confluence, Notion or GitHub) under Integrations first.
+            </div>
+            <div v-else class="flex flex-col gap-2">
+              <div class="flex flex-wrap gap-2">
+                <UButton
+                  v-for="s in documents.connectedSources"
+                  :key="s.source"
+                  size="xs"
+                  :color="docDraft.source === s.source ? 'primary' : 'neutral'"
+                  :variant="docDraft.source === s.source ? 'solid' : 'outline'"
+                  @click="docDraft.source = s.source"
+                >
+                  {{ s.label }}
+                </UButton>
+              </div>
+              <UInput
+                v-model="docDraft.ref"
+                placeholder="Page id or URL (e.g. a Confluence/Notion page or GitHub file URL)"
+              />
+              <UInput v-model="docDraft.tags" placeholder="Tags, comma-separated (optional)" />
+              <UButton
+                icon="i-lucide-link"
+                size="sm"
+                :disabled="!docDraftValid"
+                :loading="library.loading"
+                class="self-start"
+                @click="linkDocumentFragment"
+              >
+                Link as living fragment
+              </UButton>
+            </div>
+          </div>
+        </div>
+
         <!-- Repo sources -->
         <div v-else class="flex flex-col gap-3">
           <div

package/app/components/panels/inspector/TaskRunSettings.vue

@@ -173,6 +173,31 @@ const commentOnPrOpenLabel = computed(() =>
 const resolveOnMergeLabel = computed(() =>
   writebackLabel(props.block.trackerResolveOnMerge, tracker.settings.writebackResolveOnMerge),
 )
+
+// ---- technical label (tri-state) -------------------------------------------
+// Whether this is a purely technical task (the implementer then treats the task
+// definition as primary and the spec as a regression reference). Tri-state: Unset lets
+// the engine infer it from the spec phase; Technical / Business are authoritative human
+// choices the engine never overrides. `null` clears back to Unset.
+function setTechnical(value: boolean | null) {
+  board.updateBlock(props.block.id, { technical: value })
+}
+const technicalMenu = [
+  [
+    {
+      label: 'Unset (auto-detect)',
+      icon: 'i-lucide-rotate-ccw',
+      onSelect: () => setTechnical(null),
+    },
+    { label: 'Technical', icon: 'i-lucide-wrench', onSelect: () => setTechnical(true) },
+    { label: 'Business', icon: 'i-lucide-briefcase', onSelect: () => setTechnical(false) },
+  ],
+]
+const technicalLabel = computed(() => {
+  if (props.block.technical === true) return 'Technical'
+  if (props.block.technical === false) return 'Business'
+  return 'Unset (auto-detect)'
+})
 </script>
 
 <template>
@@ -302,6 +327,38 @@ const resolveOnMergeLabel = computed(() =>
       </p>
     </div>
 
+    <!-- technical label (tri-state) -->
+    <div>
+      <div class="mb-1 flex items-center justify-between">
+        <span class="text-[11px] font-semibold uppercase tracking-wide text-slate-400">
+          Task kind
+        </span>
+        <UDropdownMenu :items="technicalMenu">
+          <UButton
+            size="xs"
+            variant="ghost"
+            color="neutral"
+            icon="i-lucide-wrench"
+            trailing-icon="i-lucide-chevron-down"
+          >
+            {{ technicalLabel }}
+          </UButton>
+        </UDropdownMenu>
+      </div>
+      <div class="text-[11px] text-slate-500">
+        <template v-if="block.technical === true">
+          Technical — the implementer treats the task definition as primary and the spec as a
+          regression reference; the spec-writer may produce no business specs.
+        </template>
+        <template v-else-if="block.technical === false">
+          Business — the specification leads, as usual.
+        </template>
+        <template v-else>
+          Auto-detect — inferred from the spec phase. Set it explicitly to override.
+        </template>
+      </div>
+    </div>
+
     <!-- issue-tracker writeback overrides -->
     <div>
       <div class="mb-1 flex items-center justify-between">

package/app/composables/api/board.ts

@@ -42,6 +42,7 @@ export function boardApi({ http, ws }: ApiContext) {
         modelPresetId?: string
         pipelineId?: string
         agentConfig?: Record<string, string>
+        technical?: boolean
       },
     ) => http<Block>(`${ws(workspaceId)}/blocks/${blockId}/tasks`, { method: 'POST', body }),
 

package/app/composables/api/fragments.ts

@@ -1,4 +1,5 @@
 import type {
+  CreateDocumentFragmentInput,
   CreatePromptFragmentInput,
   FragmentOwnerKind,
   FragmentSource,
@@ -45,6 +46,20 @@ export function fragmentsApi({ http, ws, scope }: ApiContext) {
         method: 'DELETE',
       }),
 
+    // Link an external document (Confluence/Notion/GitHub) as a living fragment.
+    createDocumentFragment: (
+      kind: FragmentOwnerKind,
+      id: string,
+      body: CreateDocumentFragmentInput,
+    ) => http<PromptFragment>(`${scope(kind, id)}/document-fragments`, { method: 'POST', body }),
+
+    // Force an immediate live re-resolve of a document-backed fragment.
+    refreshFragment: (kind: FragmentOwnerKind, id: string, fragmentId: string) =>
+      http<PromptFragment>(
+        `${scope(kind, id)}/prompt-fragments/${encodeURIComponent(fragmentId)}/refresh`,
+        { method: 'POST' },
+      ),
+
     // Repo sources of guideline Markdown.
     listFragmentSources: (kind: FragmentOwnerKind, id: string) =>
       http<FragmentSource[]>(`${scope(kind, id)}/fragment-sources`),

package/app/stores/board.ts

@@ -80,6 +80,7 @@ export const useBoardStore = defineStore('board', () => {
       modelPresetId?: string
       pipelineId?: string
       agentConfig?: Record<string, string>
+      technical?: boolean
     },
   ): Promise<Block | undefined> {
     if (!getBlock(containerId)) return
@@ -92,6 +93,7 @@ export const useBoardStore = defineStore('board', () => {
       ...(options?.modelPresetId ? { modelPresetId: options.modelPresetId } : {}),
       ...(options?.pipelineId ? { pipelineId: options.pipelineId } : {}),
       ...(options?.agentConfig ? { agentConfig: options.agentConfig } : {}),
+      ...(options?.technical ? { technical: true } : {}),
     })
     upsert(block)
     return block

package/app/stores/fragmentLibrary.ts

@@ -1,6 +1,7 @@
 import { defineStore } from 'pinia'
 import { computed, ref } from 'vue'
 import type {
+  CreateDocumentFragmentInput,
   CreatePromptFragmentInput,
   FragmentSource,
   LinkFragmentSourceInput,
@@ -77,6 +78,28 @@ export const useFragmentLibraryStore = defineStore('fragmentLibrary', () => {
     await Promise.all([reloadTier(), refreshResolved()])
   }
 
+  /** Link an external document as a living (dynamically-resolved) fragment. */
+  async function createDocumentFragment(input: CreateDocumentFragmentInput) {
+    loading.value = true
+    try {
+      await api.createDocumentFragment('workspace', workspace.requireId(), input)
+      await Promise.all([reloadTier(), refreshResolved()])
+    } finally {
+      loading.value = false
+    }
+  }
+
+  /** Force an immediate live re-resolve of a document-backed fragment. */
+  async function refreshDocumentFragment(fragmentId: string) {
+    loading.value = true
+    try {
+      await api.refreshFragment('workspace', workspace.requireId(), fragmentId)
+      await Promise.all([reloadTier(), refreshResolved()])
+    } finally {
+      loading.value = false
+    }
+  }
+
   /** Tombstone a fragment at the workspace tier (suppresses an inherited one). */
   async function remove(fragmentId: string) {
     await api.deleteFragment('workspace', workspace.requireId(), fragmentId)
@@ -137,6 +160,8 @@ export const useFragmentLibraryStore = defineStore('fragmentLibrary', () => {
     probe,
     refreshResolved,
     create,
+    createDocumentFragment,
+    refreshDocumentFragment,
     update,
     remove,
     linkSource,

package/app/types/domain.ts

@@ -132,6 +132,15 @@ export interface Block {
   taskType?: TaskType
   /** task-only: small per-type form fields (bug severity, spike timebox, …). */
   taskTypeFields?: TaskTypeFields | null
+  /**
+   * task-only: TECHNICAL label. `true` ⇒ a refactor / non-functional / internal change
+   * (the implementer treats the task definition as primary, specs as a regression
+   * reference; the spec-writer may produce no business specs). `false` ⇒ a business task.
+   * `null`/absent ⇒ not yet determined — the engine may infer it from the spec phase. A
+   * human-set value is authoritative and never overridden; the inspector toggle is
+   * tri-state (unset / technical / business) and sends `null` for "unset".
+   */
+  technical?: boolean | null
   /** ids of best-practice prompt fragments folded into this block's agent prompts. */
   fragmentIds?: string[]
   /**

package/app/types/fragments.ts

@@ -5,6 +5,7 @@
 // ---------------------------------------------------------------------------
 
 import type { AgentKind, BlockType } from './domain'
+import type { DocumentSourceKind } from './documents'
 import type { PromptFragment } from './models'
 
 /** Which scope owns a managed fragment / source. */
@@ -28,6 +29,21 @@ export interface CreatePromptFragmentInput {
 /** Partial patch for editing a fragment at a tier. */
 export type UpdatePromptFragmentInput = Partial<CreatePromptFragmentInput>
 
+/**
+ * Inputs for linking an external document (Confluence/Notion page or GitHub file)
+ * as a LIVING fragment at a tier. Title/summary/body are derived from the fetched
+ * document, not supplied here. `viaWorkspaceId` is only needed at the account tier.
+ */
+export interface CreateDocumentFragmentInput {
+  source: DocumentSourceKind
+  ref: string
+  id?: string
+  category?: string
+  tags?: string[]
+  appliesTo?: { blockTypes?: BlockType[]; agentKinds?: AgentKind[] }
+  viaWorkspaceId?: string
+}
+
 /** A fragment after the three tiers are merged for a workspace. */
 export interface ResolvedFragment extends PromptFragment {
   tier: FragmentTier

package/app/types/models.ts

@@ -4,6 +4,7 @@
 // ---------------------------------------------------------------------------
 
 import type { AgentKind, BlockType } from './domain'
+import type { DocumentSourceKind } from './documents'
 
 /** Subscription vendors whose pooled tokens drive the Claude Code / Codex harnesses. */
 export type SubscriptionVendor = 'claude' | 'codex' | 'glm' | 'kimi' | 'deepseek'
@@ -154,4 +155,14 @@ export interface PromptFragment {
     path: string
     sha: string
   }
+  /**
+   * Provenance when the body is a LIVING external document (Confluence/Notion/
+   * GitHub). The body is re-resolved from the source at run time, not frozen.
+   */
+  documentRef?: {
+    source: DocumentSourceKind
+    externalId: string
+  }
+  /** When the document-backed body was last resolved from the source (epoch ms). */
+  resolvedAt?: number
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.23.1",
+  "version": "0.25.0",
   "description": "Reusable Nuxt layer for the Agent Architecture Board SPA (components, stores, composables, pages). Consume it from a thin deployment app via `extends: ['@cat-factory/app']` and point it at your backend with NUXT_PUBLIC_API_BASE. See deploy/frontend for an example.",
   "repository": {
     "type": "git",