@tiinex/app 0.1.1

package/src/schemas/workspace/workspace.add.views.jsx

@@ -0,0 +1,327 @@
+import React, { useRef, useState } from 'react';
+import { Button } from '../../ui/primitives/Button.jsx';
+import { TextField } from '../../ui/primitives/Field.jsx';
+import { Icon } from '../../ui/primitives/Icon.jsx';
+import { Modal } from '../../ui/primitives/Modal.jsx';
+import { TiinexAdapterRegistry } from '../../adapters/registry.js';
+import { collectLocalFilesFromDataTransfer } from '../../adapters/local/local.adapter.js';
+import { importConflictSummary } from '../../workspaces/workspace.importConflicts.js';
+
+export function AddToWorkspaceDialog({ workspace, sourceContinuation = null, onDismiss, onAddFiles, onAddPastedTrace, onAddGitHubSource, onAddUrls, githubBusy = false }) {
+  const githubContinuation = isGitHubSourceContinuation(sourceContinuation) ? sourceContinuation : null;
+  const [mode, setMode] = useState(githubContinuation ? 'git' : '');
+  const [stagedFiles, setStagedFiles] = useState([]);
+  const title = `Add to ${workspace.title || workspace.name || 'workspace'}`;
+  const modalClass = mode ? 'tx-add-flow-modal tx-add-mode-modal' : 'tx-add-flow-modal';
+
+  return (
+    <Modal title={modeTitle(mode, title)} onDismiss={onDismiss} className={modalClass}>
+      {!mode ? (
+        <AddChoiceGrid onMode={setMode} onAddFiles={onAddFiles} title={title} />
+      ) : null}
+      {mode === 'git' ? (
+        <GitHubSourceForm sourceContinuation={githubContinuation} onBack={() => githubContinuation ? onDismiss?.() : setMode('')} onSubmit={onAddGitHubSource} busy={githubBusy} />
+      ) : null}
+      {mode === 'urls' ? (
+        <ExplicitUrlsForm onBack={() => setMode('')} onSubmit={onAddUrls} />
+      ) : null}
+      {mode === 'drop' ? (
+        <DropMode stagedFiles={stagedFiles} setStagedFiles={setStagedFiles} onBack={() => setMode('')} onSubmit={() => onAddFiles(stagedFiles, { sourceMode: 'drop' })} />
+      ) : null}
+      {mode === 'paste-trace' ? (
+        <PasteTraceForm onBack={() => setMode('')} onSubmit={onAddPastedTrace} />
+      ) : null}
+    </Modal>
+  );
+}
+
+
+function isGitHubSourceContinuation(source = null) {
+  if (!source || source.id === 'local' || source.recoveryOnly === true || source.originReferenceSource === true) return false;
+  const kind = String(source.adapterId || source.sourceKind || source.kind || '').toLowerCase();
+  return kind.includes('github') && source.loadable !== false;
+}
+
+function AddChoiceGrid({ onMode, onAddFiles, title }) {
+  const hasGithub = Boolean(TiinexAdapterRegistry.forSourceKind('github.repo'));
+  const hasLocal = Boolean(TiinexAdapterRegistry.forSourceKind('local.files'));
+  return (
+    <div className="tx-add-flow" data-flow="old-like-add-menu">
+      <div className="tx-add-choice-grid">
+        {hasLocal ? <label className="tx-add-choice-card tx-add-choice-file">
+          <span className="tx-add-choice-icon"><Icon name="manualFiles" /></span>
+          <span className="tx-add-choice-copy"><strong>Manual files</strong><small>Markdown / zip</small></span>
+          <Icon name="upload" />
+          <input className="tx-visually-hidden-file" type="file" multiple accept=".md,.markdown,.trace.md,.schema.md,.validator.md,.workspace.md,.zip" onChange={(event) => onAddFiles(event.target.files, { sourceMode: 'manual-files' })} />
+        </label> : null}
+        <label className="tx-add-choice-card tx-add-choice-folder">
+          <span className="tx-add-choice-icon"><Icon name="folderOpen" /></span>
+          <span className="tx-add-choice-copy"><strong>Manual folder</strong><small>Folder / zip paths</small></span>
+          <Icon name="folderPlus" />
+          <input className="tx-visually-hidden-file" type="file" multiple webkitdirectory="" directory="" onChange={(event) => onAddFiles(event.target.files, { sourceMode: 'manual-folder' })} />
+        </label>
+        {hasGithub ? <button type="button" className="tx-add-choice-card" onClick={() => onMode('git')}>
+          <span className="tx-add-choice-icon"><Icon name="github" /></span>
+          <span className="tx-add-choice-copy"><strong>GitHub source</strong><small>Repo boundary</small></span>
+          <Icon name="source" />
+        </button> : null}
+        <button type="button" className="tx-add-choice-card" onClick={() => onMode('urls')}>
+          <span className="tx-add-choice-icon"><Icon name="source" /></span>
+          <span className="tx-add-choice-copy"><strong>Explicit URLs</strong><small>Raw / blob URLs</small></span>
+          <Icon name="source" />
+        </button>
+        <button type="button" className="tx-add-choice-card tx-desktop-only-choice" onClick={() => onMode('drop')}>
+          <span className="tx-add-choice-icon"><Icon name="handPointer" /></span>
+          <span className="tx-add-choice-copy"><strong>Drag and drop</strong><small>Files, folders, zip</small></span>
+          <Icon name="drop" />
+        </button>
+      </div>
+      <details className="tx-add-advanced-imports">
+        <summary>Advanced imports</summary>
+        <div className="tx-add-choice-grid tx-add-choice-grid-secondary">
+          <button type="button" className="tx-add-choice-card" onClick={() => onMode('paste-trace')}>
+            <span className="tx-add-choice-icon"><Icon name="markdown" /></span>
+            <span className="tx-add-choice-copy"><strong>Paste trace</strong><small>Paste existing trace Markdown</small></span>
+            <Icon name="continue" />
+          </button>
+        </div>
+      </details>
+    </div>
+  );
+}
+
+function GitHubSourceForm({ sourceContinuation = null, onBack, onSubmit, busy = false }) {
+  const continuation = sourceContinuation || null;
+  const [repository, setRepository] = useState(continuation?.repo || continuation?.config?.repo || '');
+  const [ref, setRef] = useState(continuation?.ref || continuation?.config?.ref || '');
+  const [rootPath, setRootPath] = useState(continuation?.rootPath || continuation?.config?.rootPath || '.topics');
+  const repoRequested = Boolean(continuation?.repoDiscovery);
+  const issueRequested = Boolean(continuation?.issueDiscovery);
+  // Broad discovery is a user-owned source setting. Requested/loaded issue surfaces may also come from explicit targets and must not re-enable it.
+  const [repoDiscovery, setRepoDiscovery] = useState(continuation ? repoRequested : true);
+  const [issueDiscovery, setIssueDiscovery] = useState(continuation ? issueRequested : false);
+  const [issueUrls, setIssueUrls] = useState(continuation?.issueUrls || continuation?.config?.issueUrls || '');
+  const [fileRefs, setFileRefs] = useState(() => (Array.isArray(continuation?.explicitFileRefs || continuation?.config?.explicitFileRefs) ? Array.from(continuation?.explicitFileRefs || continuation?.config?.explicitFileRefs).join('\n') : String(continuation?.explicitFileRefs || continuation?.config?.explicitFileRefs || '')));
+  const [error, setError] = useState('');
+
+  function send(intent = 'load') {
+    if (busy) return;
+    setError('');
+    const cleanRepo = String(repository || '').trim();
+    const explicitRefs = String(fileRefs || '').trim();
+    const explicitIssues = String(issueUrls || '').trim();
+    if (!cleanRepo) {
+      setError('Repo URL or owner/name is required.');
+      return;
+    }
+    const registerOnly = intent === 'register';
+    const shouldLoadIssues = !registerOnly && (issueDiscovery || Boolean(explicitIssues));
+    const wantsLoad = !registerOnly && (repoDiscovery || Boolean(explicitRefs) || shouldLoadIssues);
+    if (!registerOnly && !wantsLoad) {
+      setError('Choose at least one discovery surface, add explicit paths, or use Save source.');
+      return;
+    }
+    onSubmit({
+      repository,
+      ref,
+      rootPath,
+      operation: registerOnly ? 'register' : 'materialize',
+      repoDiscovery: Boolean(repoDiscovery),
+      issueDiscovery: Boolean(issueDiscovery),
+      issueUrls,
+      label: repository,
+      explicitFileRefs: fileRefs,
+      fileRefs: wantsLoad ? fileRefs : '',
+      sourceId: continuation?.id || ''
+    });
+  }
+
+  function submit(event) {
+    event.preventDefault();
+    send('load');
+  }
+
+  const explicitRefs = String(fileRefs || '').trim();
+  const explicitIssues = String(issueUrls || '').trim();
+  const activeSurfaces = [
+    repoDiscovery ? 'repo files' : '',
+    explicitRefs ? 'explicit paths' : '',
+    issueDiscovery ? 'public issues' : '',
+    explicitIssues ? 'specific issue targets' : ''
+  ].filter(Boolean);
+  const primaryLabel = activeSurfaces.length === 0
+    ? 'Choose material to load'
+    : activeSurfaces.length === 1 && activeSurfaces[0] === 'repo files'
+      ? (continuation ? 'Reload repo Markdown' : 'Discover repo Markdown')
+      : `${continuation ? 'Reload' : 'Load'} material`;
+  const sourceLabel = continuation?.label || repository || 'GitHub source';
+  const backLabel = continuation ? 'Cancel' : 'Back';
+  const saveLabel = 'Save source';
+
+  return (
+    <form className="tx-add-source-form tx-github-source-form tx-github-source-plan-form" onSubmit={submit} data-operation={continuation ? "source-edit" : "source-plan"}>
+      {continuation ? (
+        <div className="tx-source-continuation-banner" role="status">
+          <Icon name="source" />
+          <span><strong>Continue {sourceLabel}</strong><small>{continuation.count || 0} loaded · {sourceContinuationSummary(continuation)}</small></span>
+        </div>
+      ) : null}
+      <p className="tx-github-source-intro">Read-only GitHub source. Saving the source and loading material are separate.</p>
+      <div className="tx-github-source-field-grid">
+        <TextField id="source-repo" label="Repository" value={repository} onChange={setRepository} placeholder="Tiinex/docs" />
+        <TextField id="source-ref" label="Ref" value={ref} onChange={setRef} placeholder="default branch" />
+      </div>
+      <label className="tx-textarea-field">
+        <span>Root paths</span>
+        <textarea value={rootPath} onChange={(event) => setRootPath(event.target.value)} placeholder=".topics&#10;.github/agents/.topics" />
+      </label>
+      <fieldset className="tx-github-discovery-surfaces" aria-label="Discover broadly">
+        <legend>Discover broadly</legend>
+        <label className={`tx-github-discovery-card ${repoDiscovery ? 'is-active' : ''}`}>
+          <input type="checkbox" checked={repoDiscovery} onChange={(event) => setRepoDiscovery(event.target.checked)} />
+          <span><strong>Repo Markdown under root paths</strong><small>Discover bounded Markdown material under the configured roots.</small></span>
+        </label>
+        <label className={`tx-github-discovery-card ${issueDiscovery ? 'is-active' : ''}`}>
+          <input type="checkbox" checked={issueDiscovery} onChange={(event) => setIssueDiscovery(event.target.checked)} />
+          <span><strong>Public issues</strong><small>Discover a bounded set of public issues. Specific targets below are independent and always included.</small></span>
+        </label>
+      </fieldset>
+      <label className="tx-textarea-field">
+        <span>Include specific targets · Markdown paths / URLs <small>optional; always included</small></span>
+        <textarea value={fileRefs} onChange={(event) => setFileRefs(event.target.value)} placeholder="One path or URL per line, e.g. .topics/foo.md or https://raw.githubusercontent.com/owner/repo/main/.topics/foo.md" />
+      </label>
+      <label className="tx-textarea-field">
+        <span>Issue / Discussion URLs <small>optional; exact targets are included independently of broad discovery</small></span>
+        <textarea value={issueUrls} onChange={(event) => setIssueUrls(event.target.value)} placeholder="https://github.com/Tiinex/docs/issues/123&#10;https://github.com/Tiinex/docs/discussions/123" />
+      </label>
+      <details className="tx-github-technical-details">
+        <summary>Technical details</summary>
+        <p>Transport tries available cache, mirror, proxy, then direct tiers. Operation results are shown after loading.</p>
+      </details>
+      {error ? <p className="tx-form-error" role="alert">{error}</p> : null}
+      <div className="tx-dialog-actions tx-github-dialog-actions">
+        <Button type="button" variant="ghost" icon="previous" onClick={onBack}>{backLabel}</Button>
+        <Button type="button" variant={continuation ? 'primary' : 'ghost'} icon="source" disabled={busy} onClick={() => send('register')}>{saveLabel}</Button>
+        <Button type="submit" variant={continuation ? 'ghost' : 'primary'} icon="github" disabled={busy || activeSurfaces.length === 0}>{busy ? 'GitHub operation running…' : primaryLabel}</Button>
+      </div>
+    </form>
+  );
+}
+
+
+
+function sourceContinuationSummary(source = {}) {
+  const surfaces = source.surfaces || source.requestedSurfaces || {};
+  const repo = surfaces.repoFiles || {};
+  const issues = surfaces.issueSnapshots || {};
+  const parts = [];
+  if (repo.requested) parts.push(Number(repo.loaded || 0) ? 'repo files loaded' : 'repo files requested');
+  if (issues.requested) parts.push(Number(issues.loaded || 0) ? 'issues loaded' : issues.deferred || issues.unavailable ? 'issue snapshots deferred' : 'issue snapshots requested');
+  if (!parts.length) parts.push(source.discoveryState || 'deferred');
+  return `${parts.join(' · ')} · continue the existing source plan.`;
+}
+
+function ExplicitUrlsForm({ onBack, onSubmit }) {
+  const [urls, setUrls] = useState('');
+  function submit(event) {
+    event.preventDefault();
+    onSubmit(urls);
+  }
+  return (
+    <form className="tx-add-source-form" onSubmit={submit}>
+      <label className="tx-textarea-field">
+        <span>URLs</span>
+        <textarea value={urls} onChange={(event) => setUrls(event.target.value)} placeholder="https://github.com/Tiinex/docs/blob/master/.topics/.../001.trace.md&#10;https://raw.githubusercontent.com/Tiinex/docs/master/.topics/.../001.trace.md" />
+      </label>
+      <div className="tx-dialog-actions">
+        <Button type="button" variant="ghost" icon="previous" onClick={onBack}>Back</Button>
+        <Button type="submit" variant="primary" icon="source">Add URLs</Button>
+      </div>
+    </form>
+  );
+}
+
+function DropMode({ stagedFiles, setStagedFiles, onBack, onSubmit }) {
+  const inputRef = useRef(null);
+  const count = stagedFiles.length;
+  const handleFiles = (files) => setStagedFiles(Array.from(files || []));
+  async function handleDataTransfer(dataTransfer) {
+    const files = await collectLocalFilesFromDataTransfer(dataTransfer);
+    setStagedFiles(files);
+  }
+  return (
+    <div className="tx-add-source-form">
+      <div
+        className="tx-source-dropzone tx-add-full-dropzone"
+        tabIndex="0"
+        role="button"
+        aria-label="Drop Markdown, folders, or zip archives here"
+        onDragOver={(event) => event.preventDefault()}
+        onDrop={(event) => {
+          event.preventDefault();
+          handleDataTransfer(event.dataTransfer);
+        }}
+        onClick={() => inputRef.current?.click()}
+      >
+        <div className="tx-source-drop-icon"><Icon name="drop" /></div>
+        <div>
+          <strong>Drop folder, trace files, or markdown</strong>
+          <small>{count ? `${count} file${count === 1 ? '' : 's'} staged` : 'No files staged yet.'}</small>
+        </div>
+      </div>
+      <input ref={inputRef} className="tx-visually-hidden-file" type="file" multiple webkitdirectory="" directory="" accept=".md,.markdown,.trace.md,.schema.md,.validator.md,.workspace.md,.zip" onChange={(event) => handleFiles(event.target.files)} />
+      <div className="tx-dialog-actions">
+        <Button type="button" variant="ghost" icon="previous" onClick={onBack}>Back</Button>
+        <Button type="button" variant="ghost" icon="manualFiles" onClick={() => inputRef.current?.click()}>Choose files</Button>
+        <Button type="button" variant="primary" icon="fileUpload" onClick={onSubmit} disabled={!count}>Add staged material</Button>
+      </div>
+    </div>
+  );
+}
+
+function modeTitle(mode, title) {
+  if (mode === 'git') return 'GitHub source';
+  if (mode === 'urls') return 'Explicit URLs';
+  if (mode === 'drop') return 'Drag and drop';
+  return title;
+}
+
+
+
+export function ImportConflictDialog({ conflicts = [], onResolve, onDismiss }) {
+  const examples = conflicts.slice(0, 5);
+  return (
+    <Modal title="Incoming material overlaps this workspace" onDismiss={onDismiss} className="tx-import-conflict-modal">
+      <div className="tx-import-conflict-copy">
+        <p>{importConflictSummary(conflicts)}</p>
+        <p><strong>.trace.md conflicts use lineage slot numbers.</strong> Different slugs in the same numbered slot still conflict.</p>
+        {examples.length ? <ul>{examples.map((item, index) => <li key={`${item.type}:${item.incoming}:${index}`}><strong>{item.type === 'trace-slot' ? 'Same lineage slot' : 'Same file path'}</strong><br /><span>{item.incoming} → {item.existing}</span></li>)}</ul> : null}
+      </div>
+      <div className="tx-dialog-actions">
+        <Button variant="primary" onClick={() => onResolve?.('sibling')}>Import as sibling</Button>
+        <Button onClick={() => onResolve?.('replace')}>Replace existing</Button>
+        <Button variant="subtle" onClick={onDismiss}>Cancel import</Button>
+      </div>
+    </Modal>
+  );
+}
+
+function PasteTraceForm({ onBack, onSubmit }) {
+  const [text, setText] = useState('');
+  const [error, setError] = useState('');
+  function submit(event) {
+    event.preventDefault();
+    if (!String(text || '').trim()) { setError('Paste trace Markdown first.'); return; }
+    const ok = onSubmit?.(text);
+    if (ok === false) setError('Clipboard text does not look like Tiinex trace Markdown.');
+  }
+  return (
+    <form className="tx-add-source-form tx-paste-trace-form" onSubmit={submit}>
+      <p className="tx-boundary-note">Paste an existing Tiinex trace. It stays local/session material until explicitly published.</p>
+      <label><span>Trace Markdown</span><textarea rows="14" value={text} onChange={(event) => setText(event.target.value)} placeholder="# Continuity Context
+..." /></label>
+      {error ? <p role="alert" className="tx-field-error">{error}</p> : null}
+      <div className="tx-dialog-actions"><Button onClick={onBack}>Back</Button><Button variant="primary" type="submit">Add trace</Button></div>
+    </form>
+  );
+}

package/src/schemas/workspace/workspace.audit.views.jsx

@@ -0,0 +1,160 @@
+import React from 'react';
+import { Badge } from '../../ui/primitives/Badge.jsx';
+import { Icon } from '../../ui/primitives/Icon.jsx';
+import { buildWorkspaceAuditView } from '../../workspaces/workspace.auditView.js';
+import { buildWorkspaceRecoverabilityView } from '../../workspaces/workspace.recoverabilityView.js';
+import { compactPath, validationStateLabel } from './workspace.viewFormatting.js';
+
+export function WorkspaceAuditState({ workspace, query = '', records = [], assets = [], onOpenRecord }) {
+  const audit = buildWorkspaceAuditView(workspace, { records, query });
+  const recovery = buildWorkspaceRecoverabilityView(workspace, { records, assets });
+  const counts = audit.visibleCounts || audit.counts || {};
+  return (
+    <section className="tx-workspace-audit-state" aria-label="Loaded audit">
+      <header className="tx-audit-header">
+        <div>
+          <strong><Icon name="audit" /> {audit.title}</strong>
+          <small>{audit.boundary}</small>
+        </div>
+        <div className="tx-audit-stats" aria-label="Audit stats">
+          <span><strong>{counts.records || 0}</strong><small>records</small></span>
+          <span><strong>{counts.invalid || 0}</strong><small>invalid</small></span>
+          <span><strong>{counts.degraded || 0}</strong><small>degraded</small></span>
+          {counts.supporting ? <span><strong>{counts.supporting}</strong><small>supporting</small></span> : null}
+          {counts.validationPartial ? <span><strong>{counts.validationPartial}</strong><small>partial validation</small></span> : null}
+          <span><strong>{counts.missingLineage || 0}</strong><small>missing lineage</small></span>
+        </div>
+      </header>
+      <div className="tx-audit-finding-summary" aria-label="Audit finding summary">
+        <span><Icon name={counts.errors ? 'warning' : 'check'} /> {counts.errors || 0} errors</span>
+        <span><Icon name={counts.warnings ? 'warning' : 'check'} /> {counts.warnings || 0} warnings</span>
+        <span><Icon name="audit" /> {counts.rootFallback || counts.fallbackUsed || 0} root fallback</span>
+        <span><Icon name="open" /> {counts.rootReadable || 0} root-readable</span>
+        {counts.unavailableBody ? <span><Icon name="warning" /> {counts.unavailableBody} body unavailable</span> : null}
+        {counts.childValidatorUnavailable ? <span><Icon name="warning" /> {counts.childValidatorUnavailable} validator unavailable</span> : null}
+        {counts.integrityV2 ? <span><Icon name="check" /> {counts.integrityV2} v2 integrity methods</span> : null}
+        <span><Icon name="lineage" /> {counts.lineageFindings || 0} lineage findings</span>
+      </div>
+      {audit.lineage.findings.length ? (
+        <div className="tx-audit-lineage-findings" aria-label="Loaded lineage audit findings">
+          {audit.lineage.findings.slice(0, 6).map((finding, index) => (
+            <span key={`${finding.code}-${finding.nodeId}-${index}`} className={`tx-lineage-finding tx-${finding.severity || 'info'}`} title={finding.message}>
+              <Icon name={(finding.severity === 'warning' || finding.severity === 'error') ? 'warning' : 'check'} /> {finding.code}
+            </span>
+          ))}
+        </div>
+      ) : null}
+      <AuditRecoverabilitySummary recovery={recovery} />
+      <div className="tx-audit-record-list" role="list" aria-label="Loaded audit records">
+        {audit.items.map((item) => <AuditRecordRow key={item.id} item={item} onOpenRecord={onOpenRecord} />)}
+      </div>
+      {audit.empty ? <p className="tx-tree-empty">No loaded records match this audit view.</p> : null}
+    </section>
+  );
+}
+
+function AuditRecoverabilitySummary({ recovery }) {
+  if (!recovery) return null;
+  const counts = recovery.counts || {};
+  const latest = recovery.latestImport;
+  return (
+    <section className={`tx-audit-recovery-summary tx-recovery-${recovery.status || 'recoverable'}`} aria-label="Recoverability summary">
+      <header>
+        <strong><Icon name={recovery.status === 'needs-attention' ? 'warning' : 'check'} /> {recovery.status || 'recoverable'}</strong>
+        <small>{recovery.boundary}</small>
+      </header>
+      <div className="tx-audit-recovery-grid">
+        <span><strong>{counts.localRecords || 0}</strong><small>local records</small></span>
+        <span><strong>{counts.sourceBackedRecords || 0}</strong><small>source-backed</small></span>
+        <span><strong>{counts.assets || 0}</strong><small>assets</small></span>
+        <span><strong>{counts.workspaceArtifacts || 0}</strong><small>workspaces</small></span>
+        <span><strong>{counts.previewOmitted || 0}</strong><small>preview omitted</small></span>
+      </div>
+      {latest ? <p className="tx-audit-recovery-latest"><Icon name={latest.ok ? 'check' : 'warning'} /> {latest.message}</p> : null}
+      {recovery.publicationPreflight ? <AuditPublicationPreflight preflight={recovery.publicationPreflight} /> : null}
+      {recovery.reingestPlan ? <AuditReingestPlan plan={recovery.reingestPlan} /> : null}
+      {recovery.exportPackagePreflight ? <AuditExportPackagePreflight preflight={recovery.exportPackagePreflight} /> : null}
+      {recovery.exportPackageManifest ? <AuditExportPackageManifest manifest={recovery.exportPackageManifest} receipt={recovery.exportPackageReceipt} /> : null}
+      <ul className="tx-audit-recovery-guarantees">
+        {(recovery.guarantees || []).slice(0, 4).map((item) => <li key={item}>{item}</li>)}
+      </ul>
+      {(recovery.errors?.length || recovery.warnings?.length) ? (
+        <div className="tx-audit-recovery-issues">
+          {[...(recovery.errors || []), ...(recovery.warnings || [])].slice(0, 6).map((issue, index) => (
+            <span key={`${issue.code}-${issue.path}-${index}`} title={issue.message || issue.code}><Icon name="warning" /> {issue.code}{issue.path ? ` · ${compactPath(issue.path)}` : ''}</span>
+          ))}
+        </div>
+      ) : null}
+    </section>
+  );
+}
+
+function AuditPublicationPreflight({ preflight }) {
+  const counts = preflight.counts || {};
+  return (
+    <div className={`tx-audit-publication-preflight tx-preflight-${preflight.status || 'unknown'}`} aria-label="Publication preflight">
+      <span><Icon name={preflight.status === 'blocked' ? 'warning' : 'check'} /> publication preflight: <strong>{preflight.status || 'unknown'}</strong></span>
+      <span>{counts.publishableLocalDrafts || 0} publishable local draft{(counts.publishableLocalDrafts || 0) === 1 ? '' : 's'}</span>
+      <span>{counts.sourceReferences || 0} source reference{(counts.sourceReferences || 0) === 1 ? '' : 's'}</span>
+      {(counts.errors || counts.warnings) ? <span>{counts.errors || 0} errors · {counts.warnings || 0} warnings</span> : null}
+    </div>
+  );
+}
+
+function AuditExportPackagePreflight({ preflight }) {
+  const counts = preflight.counts || {};
+  return (
+    <div className={`tx-audit-publication-preflight tx-export-package-${preflight.status || 'unknown'}`} aria-label="Export package preflight">
+      <span><Icon name={preflight.status === 'blocked' ? 'warning' : 'check'} /> export package: <strong>{preflight.status || 'unknown'}</strong></span>
+      <span>{counts.packageEntries || 0} package entr{(counts.packageEntries || 0) === 1 ? 'y' : 'ies'}</span>
+      <span>{counts.localDraftEntries || 0} local draft{(counts.localDraftEntries || 0) === 1 ? '' : 's'} · {counts.sourceReferenceEntries || 0} source ref{(counts.sourceReferenceEntries || 0) === 1 ? '' : 's'}</span>
+      {(counts.errors || counts.warnings) ? <span>{counts.errors || 0} errors · {counts.warnings || 0} warnings</span> : null}
+    </div>
+  );
+}
+
+function AuditExportPackageManifest({ manifest, receipt }) {
+  const counts = manifest.counts || {};
+  return (
+    <div className={`tx-audit-publication-preflight tx-export-manifest-${manifest.status || 'unknown'}`} aria-label="Export package manifest">
+      <span><Icon name={manifest.status === 'blocked' ? 'warning' : 'check'} /> package manifest: <strong>{manifest.status || 'unknown'}</strong></span>
+      <span>{counts.entries || 0} planned entr{(counts.entries || 0) === 1 ? 'y' : 'ies'} · {counts.blocked || 0} blocked</span>
+      <span>{manifest.integrity?.fingerprint || 'no fingerprint'}</span>
+      {receipt ? <span>receipt: {receipt.state || 'unknown'}</span> : null}
+    </div>
+  );
+}
+
+function AuditReingestPlan({ plan }) {
+  const counts = plan.counts || {};
+  return (
+    <div className={`tx-audit-publication-preflight tx-reingest-${plan.status || 'unknown'}`} aria-label="Re-ingest plan">
+      <span><Icon name={plan.status === 'blocked' ? 'warning' : 'check'} /> re-ingest plan: <strong>{plan.status || 'unknown'}</strong></span>
+      <span>{counts.pinnedSourceTargets || 0}/{counts.sourceTargets || 0} pinned source target{(counts.sourceTargets || 0) === 1 ? '' : 's'}</span>
+      <span>{counts.localDraftTargets || 0} local draft target{(counts.localDraftTargets || 0) === 1 ? '' : 's'}</span>
+      {(counts.errors || counts.warnings) ? <span>{counts.errors || 0} errors · {counts.warnings || 0} warnings</span> : null}
+    </div>
+  );
+}
+
+function AuditRecordRow({ item, onOpenRecord }) {
+  const findings = item.findings || [];
+  return (
+    <button type="button" className={`tx-audit-record-row tx-audit-status-${item.status || 'unknown'}`} role="listitem" onClick={() => onOpenRecord?.(item.id)} title={item.path || ''}>
+      <span className="tx-audit-record-main">
+        <Icon name={item.status === 'readable' ? 'check' : 'warning'} />
+        <strong>{item.title}</strong>
+      </span>
+      <span className="tx-audit-record-meta">
+        <Badge>{item.status}</Badge>
+        <Badge>{item.readState || 'read-state unknown'}</Badge>
+        <Badge>{validationStateLabel(item.validationState)}</Badge>
+        <Badge>{item.schemaId || 'markdown'}</Badge>
+        <Badge>{item.sourceBacked ? 'source-backed' : 'local/session'}</Badge>
+        {item.fallbackUsed ? <Badge>root fallback</Badge> : null}
+        {item.path ? <small>{compactPath(item.path)}</small> : null}
+      </span>
+      {findings.length ? <small className="tx-audit-record-findings">{findings.slice(0, 3).map((finding) => finding.code).join(' · ')}</small> : null}
+    </button>
+  );
+}

package/src/schemas/workspace/workspace.auditBadge.views.jsx

@@ -0,0 +1,98 @@
+import React, { useState } from 'react';
+import { Badge } from '../../ui/primitives/Badge.jsx';
+import { Modal } from '../../ui/primitives/Modal.jsx';
+import { resolveFindingMessage } from '../../validation/i18n.js';
+import { readStateLabel, schemaCoverageLabel, validationStateLabel, validatorLabel } from './workspace.viewFormatting.js';
+
+export function auditBadgeForRecord(record = {}, auditItem = null) {
+  const item = auditItem || null;
+  const status = String(item?.status || '').toLowerCase();
+  const readState = String(item?.readState || '').toLowerCase();
+  const bodyAvailability = String(item?.bodyAvailability || '').toLowerCase();
+  if (status === 'readable') {
+    if (readState === 'root-readable') return { label: 'root ok', tone: 'ok', title: 'Root envelope is readable through the Root companion.' };
+    if (item?.fallbackUsed || readState === 'root-fallback') return { label: 'fallback', tone: 'fallback', title: 'Readable through Root fallback; exact child schema companion did not validate this card.' };
+    return { label: 'schema ok', tone: 'ok', title: 'Loaded leaf passed schema/audit checks; byte-level integrity is not claimed.' };
+  }
+  if (status === 'supporting-material') return { label: 'doc', tone: 'open', title: 'Plain Markdown supporting material; not an invalid Tiinex leaf.' };
+  if (status === 'pending-unavailable' || readState === 'unavailable-body' || bodyAvailability === 'unavailable-body') return { label: 'body missing', tone: 'pending', title: 'The route/session preserved metadata, but the Markdown body is not loaded.' };
+  if (status === 'degraded') return { label: (item?.fallbackUsed || readState === 'root-fallback') ? 'fallback' : 'open', tone: (item?.fallbackUsed || readState === 'root-fallback') ? 'fallback' : 'pending', title: (item?.fallbackUsed || readState === 'root-fallback') ? 'Readable through Root fallback with warnings; child-specific companion is not available.' : 'Readable with warnings; review lineage/source confidence.' };
+  if (status) return { label: 'mismatch', tone: 'mismatch', title: 'Audit found errors or incomplete Tiinex leaf structure.' };
+  if (record?.hasIntegrity || record?.hasContinuityContext || record?.schemaId) return { label: 'open', tone: 'pending', title: 'Lineage/audit status is not fully resolved yet.' };
+  return { label: 'doc', tone: 'open', title: 'Supporting material.' };
+}
+
+export function AuditStatusBadge({ record, item }) {
+  const [open, setOpen] = useState(false);
+  const badge = auditBadgeForRecord(record, item);
+  const title = record?.title || item?.title || 'Artifact';
+  return (
+    <>
+      <button type="button" className={`tx-badge tx-audit-badge tx-audit-badge-${badge.tone} tx-audit-badge-button`} title={`${badge.title} Open compact status explainer.`} aria-label={`Explain ${badge.label} status for ${title}`} onClick={(event) => { event.preventDefault(); event.stopPropagation(); setOpen(true); }}>{badge.label}</button>
+      {open ? <AuditBadgeDialog record={record} item={item} badge={badge} onDismiss={() => setOpen(false)} /> : null}
+    </>
+  );
+}
+
+export function AuditBadgeDialog({ record = {}, item = null, badge = {}, onDismiss }) {
+  const status = String(item?.status || 'not audited');
+  const readState = String(item?.readState || (record?.markdown ? 'not indexed' : 'unknown'));
+  const coverage = String(item?.schemaCoverage || 'unknown');
+  const body = String(item?.bodyAvailability || (record?.markdown ? 'available' : 'unknown'));
+  const validationState = String(item?.validationState || item?.validation?.state || 'validation unknown');
+  const validationCoverage = String(item?.validationCoverage || item?.validation?.coverage || 'unknown');
+  const childValidator = String(item?.childValidator || item?.validation?.childValidator || 'unknown');
+  const integrityVersions = Array.isArray(item?.integrityMethodVersions) ? item.integrityMethodVersions : (Array.isArray(item?.validation?.integrityMethodVersions) ? item.validation.integrityMethodVersions : []);
+  const findings = Array.isArray(item?.findings) ? item.findings : [];
+  const summary = item?.summary || {};
+  const hasFindings = findings.length > 0;
+  return (
+    <Modal title={`${badge.label || 'Status'} · ${record.title || item?.title || 'Artifact'}`} onDismiss={onDismiss} className="tx-audit-badge-dialog">
+      <div className="tx-badge-diagnostic-summary">
+        <Badge className={`tx-audit-badge tx-audit-badge-${badge.tone || 'open'}`}>{badge.label || 'status'}</Badge>
+        <span>{badge.title || 'Compact status explanation.'}</span>
+      </div>
+      <div className="tx-badge-diagnostic-grid" aria-label="Badge diagnostic facts">
+        <span><strong>Audit</strong><small>{status}</small></span>
+        <span><strong>Read state</strong><small>{readStateLabel(readState)}</small></span>
+        <span><strong>Schema coverage</strong><small>{schemaCoverageLabel(coverage)}</small></span>
+        <span><strong>Body</strong><small>{body === 'unavailable-body' ? 'body unavailable' : body}</small></span>
+        <span><strong>Validation</strong><small>{validationStateLabel(validationState)}</small></span>
+        <span><strong>Validator</strong><small>{validatorLabel(childValidator, validationCoverage)}</small></span>
+        {integrityVersions.length ? <span><strong>Integrity method</strong><small>{integrityVersions.join(', ')}</small></span> : null}
+        {record?.schemaId || item?.schemaId ? <span><strong>Schema</strong><small>{record.schemaId || item?.schemaId}</small></span> : null}
+        {record?.source?.label || item?.sourceLabel ? <span><strong>Source</strong><small>{record.source?.label || item?.sourceLabel}</small></span> : null}
+      </div>
+      <div className="tx-badge-diagnostic-panels">
+        <section>
+          <strong>What this means</strong>
+          <ul>
+            {badge.tone === 'ok' ? <li>The loaded material passed this card's current validation/read check.</li> : null}
+            {badge.tone === 'fallback' ? <li>The artifact is readable through Root fallback, but no exact child companion owns the read view yet.</li> : null}
+            {childValidator === 'unavailable' ? <li>Root v1 validation ran, but the child schema-specific validator did not run because no exact validator is registered.</li> : null}
+            {validationState === 'exact-schema-validated' ? <li>The exact schema companion validator ran for this loaded material.</li> : null}
+            {body === 'unavailable-body' ? <li>The source boundary or route shell is known, but the Markdown body is not loaded in this session.</li> : null}
+            {badge.tone === 'mismatch' ? <li>Audit found errors or incomplete Tiinex leaf structure.</li> : null}
+            {badge.tone === 'pending' || badge.tone === 'open' ? <li>The card remains inspectable, but one or more checks are incomplete, degraded, or awaiting material.</li> : null}
+          </ul>
+        </section>
+        <section>
+          <strong>What this does not verify</strong>
+          <ul>
+            <li>It does not prove authorship, consent, or semantic correctness.</li>
+            <li>It does not fetch missing remote material or repair stale lineage.</li>
+            <li>It does not turn Root fallback into a schema-owned companion.</li>
+            <li>It does not claim child-schema validation when the validator is unavailable.</li>
+          </ul>
+        </section>
+      </div>
+      <details className="tx-badge-diagnostic-findings">
+        <summary>Findings · {findings.length}</summary>
+        {hasFindings ? findings.slice(0, 8).map((finding, index) => (
+          <p key={`${finding.code || 'finding'}-${index}`}><strong>{finding.code || finding.severity || 'finding'}</strong><span>{resolveFindingMessage(finding, { locale: 'en', schemaId: record.schemaId || item?.schemaId })}</span></p>
+        )) : <p>No findings attached to this card status.</p>}
+        <p className="tx-muted">Summary: {Number(summary.error || 0)} errors · {Number(summary.warning || 0)} warnings · {Number(summary.info || 0)} info</p>
+      </details>
+    </Modal>
+  );
+}