@theihtisham/agent-shadow-brain 7.1.3 → 7.1.4

package/dist/dashboard/project-kit-html.js

@@ -0,0 +1,359 @@
+/** Project Kit uses the same local workspace shell and HTTP helpers. */
+import { PROJECT_FEEDBACK_MARKUP, PROJECT_FEEDBACK_SCRIPT, PROJECT_FEEDBACK_STYLE } from './project-feedback-html.js';
+export const PROJECT_KIT_STYLE = String.raw `
+  html[data-project-local="true"] .advanced-link { display: none; }
+  .project-local-notice { display: none; }
+  html[data-project-local="true"] .project-local-notice { display: flex; flex-wrap: wrap; align-items: baseline; gap: 4px 10px; padding: 8px 12px; margin-bottom: 16px; border-radius: 7px; background: var(--tint); color: var(--project); font-size: .83rem; }
+  .project-local-notice a { font-weight: 680; text-decoration: underline; text-underline-offset: 3px; }
+  .kit-identity { display: grid; grid-template-columns: minmax(150px,.8fr) minmax(0,1.2fr); align-items: center; gap: 16px; padding: 18px 20px; border-radius: 10px; color: var(--instrument-ink); background: var(--instrument); }
+  .kit-identity p { color: var(--instrument-muted); margin-top: 5px; }
+  .kit-identity .mono { color: var(--instrument-ink); }
+  .kit-identity dl { display: grid; gap: 6px; min-width: 0; }
+  .kit-identity dt { color: var(--instrument-muted); font-size: .78rem; }
+  .kit-identity dd { margin-top: 1px; }
+  .kit-identity summary { cursor: pointer; color: var(--signal); margin-top: 5px; }
+  .kit-identity details[open] > summary { margin-bottom: 6px; }
+  .kit-layout { grid-template-columns: minmax(280px,.88fr) minmax(0,1.25fr); }
+  .kit-form { display: grid; gap: 12px; }
+  .kit-form .button { justify-self: start; }
+  .kit-fields { display: grid; grid-template-columns: repeat(2,minmax(0,1fr)); gap: 8px; }
+  .kit-form-status { min-width: 0; }
+  .kit-form-status:empty { display: none; }
+  .kit-profile { display: grid; gap: 11px; }
+  .kit-profile summary { cursor: pointer; color: var(--teal); font-weight: 650; }
+  .kit-profile details[open] > summary { margin-bottom: 6px; }
+  .kit-evidence, .kit-checks { max-height: 300px; overflow: auto; }
+  .kit-evidence li, .kit-checks li { padding: 7px 0; }
+  .kit-evidence .tags { margin-top: 4px; }
+  .kit-checks .form-actions { margin-top: 3px; }
+  .kit-preview { border-top: 1px solid var(--line); min-width: 0; }
+  .kit-preview > .panel-head { background: var(--inset); }
+  .kit-preview-file { display: grid; gap: 8px; min-width: 0; }
+  .kit-file-header { display: flex; justify-content: space-between; flex-wrap: wrap; gap: 6px; }
+  .kit-preview-file .context-preview { max-height: 440px; }
+  .kit-apply-controls { border-top: 1px solid var(--line); }
+  .kit-apply-controls .form-actions { margin-bottom: 6px; }
+  .kit-applied-list { padding-left: 18px; margin-top: 5px; }
+  @media (max-width: 985px) { .kit-layout { grid-template-columns: minmax(0,1fr); } }
+  @media (max-width: 690px) {
+    .kit-identity { grid-template-columns: minmax(0,1fr); gap: 10px; padding: 13px 14px; }
+    .kit-preview { scroll-margin-top: 55px; }
+  }
+${PROJECT_FEEDBACK_STYLE}
+`;
+export const PROJECT_KIT_MARKUP = String.raw `
+      <section id="page-project-kit" aria-labelledby="title-project-kit" hidden>
+        <div class="page-head">
+          <div><h1 id="title-project-kit" tabindex="-1">Project Kit</h1><p class="muted">Inspect this project, save knowledge, and prepare a skill for a coding agent.</p></div>
+          <button class="button" type="button" id="kit-refresh" hidden><span data-icon="refresh"></span>Refresh profile</button>
+        </div>
+        <div id="kit-gate" class="panel" role="status"></div>
+        <div id="kit-workbench" class="stack" hidden>
+          <section id="kit-identity" class="kit-identity" aria-label="Pinned project and storage"></section>
+          <div class="split kit-layout">
+            <div class="stack">
+              <section class="panel" aria-labelledby="kit-profile-heading">
+                <div class="panel-head"><h2 id="kit-profile-heading">Observed project profile</h2></div>
+                <div id="kit-profile" aria-busy="true"></div>
+              </section>
+              <section class="panel" aria-labelledby="kit-knowledge-heading">
+                <div class="panel-head"><div><h2 id="kit-knowledge-heading">Project knowledge</h2><p class="small muted">Record a decision, constraint, or lesson you want agents to recall.</p></div></div>
+                <form class="panel-body kit-form" id="kit-knowledge-form">
+                  <label class="label" for="kit-knowledge-title">Title<input id="kit-knowledge-title" maxlength="160" required placeholder="Retry rules for checkout"></label>
+                  <label class="label" for="kit-knowledge-content">Knowledge<textarea id="kit-knowledge-content" maxlength="8000" rows="4" required placeholder="Describe the rule and when it applies."></textarea></label>
+                  <div class="kit-fields">
+                    <label class="label" for="kit-knowledge-category">Category <span class="small muted">Optional</span><input id="kit-knowledge-category" maxlength="64" pattern="[A-Za-z0-9][A-Za-z0-9 _.\-]*" placeholder="knowledge"></label>
+                    <label class="label" for="kit-knowledge-source">Source reference <span class="small muted">Optional</span><input id="kit-knowledge-source" maxlength="500" placeholder="docs/checkout.md"></label>
+                  </div>
+                  <button class="button primary" type="submit" id="kit-knowledge-save"><span data-icon="memory"></span>Save knowledge</button>
+                  <div class="kit-form-status" id="kit-knowledge-status" role="status"></div>
+                </form>
+              </section>
+            </div>
+            <section class="panel" aria-labelledby="kit-skill-heading">
+              <div class="panel-head"><div><h2 id="kit-skill-heading">Skill builder</h2><p class="small muted">Describe the workflow, then review the generated file before applying it.</p></div></div>
+              <form class="panel-body kit-form" id="kit-skill-form">
+                <label class="label" for="kit-requirement">Requirement<textarea id="kit-requirement" rows="4" maxlength="8000" required placeholder="When a checkout retry changes, verify idempotency and add a regression case."></textarea></label>
+                <div class="kit-fields">
+                  <label class="label" for="kit-target">Agent target<select id="kit-target"><option value="codex">Codex</option><option value="claude-code">Claude Code</option><option value="opencode">OpenCode</option><option value="deepseek-harness">DeepSeek Harness</option><option value="portable">Portable</option></select></label>
+                  <label class="label" for="kit-skill-name">Skill name<input id="kit-skill-name" maxlength="63" pattern="[a-z0-9]+(?:-[a-z0-9]+)*" placeholder="Generated from requirement"></label>
+                </div>
+                <label class="label" for="kit-skill-knowledge">Supporting knowledge <span class="small muted">Optional reference material</span><textarea id="kit-skill-knowledge" maxlength="8000" rows="3" placeholder="Add the project rule or evidence the skill should carry."></textarea></label>
+                <button class="button primary" type="submit" id="kit-preview-submit"><span data-icon="context"></span>Preview skill</button>
+              </form>
+              <section class="kit-preview" id="kit-preview" aria-labelledby="kit-preview-heading">
+                <div class="panel-head"><h3 id="kit-preview-heading" tabindex="-1">Skill preview</h3><span id="kit-preview-state" class="small muted" role="status"></span></div>
+                <div id="kit-preview-body"></div>
+                <div class="panel-body kit-apply-controls" id="kit-apply-controls" hidden>
+                  <div class="form-actions"><button class="button primary" type="button" id="kit-apply"><span data-icon="plus"></span>Apply local skill</button></div>
+                  <p class="small muted">Writes the displayed project-relative file. Confirm the path and content above.</p>
+                  <div class="kit-form-status" id="kit-apply-status" role="status"></div>
+                </div>
+              </section>
+            </section>
+          </div>
+${PROJECT_FEEDBACK_MARKUP}
+        </div>
+      </section>
+`;
+export const PROJECT_KIT_SCRIPT = String.raw `
+const kit = { profile: null, profileLoading: false, saving: false, savedKnowledge: '', preview: null, previewInput: null,
+  previewing: false, applying: false, dirty: false, previewError: '', applied: null };
+
+function renderKitIdentity(info) {
+  const root = String(info.root || '').replace(/\\/g, '/').replace(/\/$/, '') + '/';
+  const storage = String(info.storagePath || '').replace(/\\/g, '/');
+  const relativeStorage = storage.startsWith(root) ? storage.slice(root.length) : 'Project-local store';
+  $('kit-identity').innerHTML = '<div><h2>' + esc(info.projectName || info.projectId) + '</h2><p class="small">Project-local memory and skills</p>' +
+    '<button class="button quiet kit-outcomes-jump" type="button" id="kit-outcomes-jump">Record a memory outcome ' + icon('chevron', true) + '</button></div>' +
+    '<div><p class="small">Memory store</p><code class="mono">' + esc(relativeStorage) + '</code><details><summary class="small">Show full paths</summary>' +
+    '<dl><div><dt>Project root</dt><dd class="mono">' + esc(info.root) + '</dd></div><div><dt>Memory store</dt><dd class="mono">' +
+    esc(info.storagePath) + '</dd></div></dl></details></div>';
+}
+
+function renderKitProfile(profile) {
+  const coverage = profile.coverage || {};
+  const entries = list(profile.evidence);
+  const checks = list(profile.checks);
+  const findings = entries.map((entry) => '<li><strong class="mono">' + esc(entry.path) + '</strong>' +
+    tags([['project', nice(entry.kind)], ...list(entry.signals).map((signal) => ['memory', signal])]) + '</li>').join('');
+  const commands = checks.map((check) => '<li><strong>' + esc(check.label) + '</strong><p class="small muted">' +
+    esc(check.source) + '</p>' + commandMarkup(check.command) + '</li>').join('');
+  $('kit-profile').innerHTML = '<div class="panel-body kit-profile"><p class="small muted">Observed ' + dateMarkup(profile.observedAt, true) +
+    ' · ' + number(coverage.entries) + ' entries inspected' + (coverage.truncated ? ' (inspection limit reached)' : '') + '.</p>' +
+    '<div><h3>Detected stack</h3>' + (list(profile.stack).length ? tags(profile.stack.map((value) => ['project', value])) :
+      '<p class="small muted">No supported stack markers found.</p>') + '</div>' +
+    (list(profile.packageManagers).length ? '<div><h3>Package managers</h3>' + tags(profile.packageManagers.map((value) => ['memory', value])) + '</div>' : '') +
+    (findings ? '<details open><summary>File evidence · ' + number(entries.length) + '</summary><ul class="list kit-evidence">' + findings + '</ul></details>' : '') +
+    (commands ? '<details><summary>Suggested project checks · ' + number(checks.length) + '</summary><ul class="list kit-checks">' + commands + '</ul></details>' : '') +
+    list(profile.warnings).map((warning) => '<p class="small muted">' + esc(warning) + '</p>').join('') + '</div>';
+}
+
+async function loadProjectKit(force = false) {
+  const gate = $('kit-gate');
+  const workbench = $('kit-workbench');
+  if (!state.overviewLoaded) {
+    gate.hidden = false;
+    gate.innerHTML = skeleton('Checking project workspace…');
+    await loadOverview();
+  }
+  if (!state.overviewLoaded) {
+    gate.innerHTML = errorMarkup('Could not check the project workspace.', 'kit-profile');
+    return;
+  }
+  const info = state.projectKit;
+  const enabled = info?.available === true;
+  workbench.hidden = !enabled;
+  $('kit-refresh').hidden = !enabled;
+  gate.hidden = enabled;
+  if (!enabled) {
+    gate.innerHTML = blank('project', 'Start a project workspace', 'Run this command from the project folder to use Project Kit with a project-local store.',
+      commandMarkup('shadow-brain project workspace .'));
+    return;
+  }
+  renderKitIdentity(info);
+  void loadProjectFeedback();
+  const focusMemory = state.view === 'project-kit' ? routeParams().get('memory') || '' : '';
+  if (focusMemory || outcomes.project !== info.projectId) void loadFeedbackMemories(focusMemory);
+  if (focusMemory && (document.activeElement === $('title-project-kit') || document.activeElement === document.body)) openOutcomeEditor();
+  if (kit.profileLoading || kit.profile && !force) return;
+  kit.profileLoading = true;
+  const target = $('kit-profile');
+  $('kit-refresh').disabled = true;
+  target.innerHTML = skeleton('Inspecting the pinned project…');
+  setBusy(target, true);
+  try {
+    const profile = await api('project-profile');
+    if (profile.projectId !== info.projectId) throw new Error('The server returned a different project profile.');
+    kit.profile = profile;
+    renderKitProfile(profile);
+  } catch (error) {
+    kit.profile = null;
+    target.innerHTML = errorMarkup(error.message, 'kit-profile');
+  } finally {
+    kit.profileLoading = false;
+    $('kit-refresh').disabled = false;
+    setBusy(target, false);
+  }
+}
+
+async function saveKitKnowledge() {
+  if (kit.saving || state.projectKit?.available !== true) return;
+  const title = $('kit-knowledge-title').value.trim();
+  const content = $('kit-knowledge-content').value;
+  const category = $('kit-knowledge-category').value.trim();
+  const source = $('kit-knowledge-source').value.trim();
+  if (!title || !content.trim()) {
+    $('kit-knowledge-status').innerHTML = errorMarkup('Enter a title and knowledge text.');
+    return;
+  }
+  const form = $('kit-knowledge-form');
+  const status = $('kit-knowledge-status');
+  const button = $('kit-knowledge-save');
+  kit.saving = true;
+  button.disabled = true;
+  status.textContent = 'Saving to the project store…';
+  try {
+    const result = await api('project-knowledge', { body: { title, content, ...(category ? { category } : {}), ...(source ? { source } : {}) } });
+    if (!result.ok || !result.memoryId || result.projectId !== state.projectKit.projectId) throw new Error('The server returned an unreadable saved memory.');
+    kit.savedKnowledge = [title, content, source ? 'Recorded reference: ' + source : ''].filter(Boolean).join('\n\n');
+    if ($('kit-knowledge-title').value.trim() === title && $('kit-knowledge-content').value === content &&
+      $('kit-knowledge-category').value.trim() === category && $('kit-knowledge-source').value.trim() === source) form.reset();
+    state.overviewLoaded = false;
+    state.graph.snapshot = null;
+    void loadFeedbackMemories();
+    if (state.context.pack || state.context.pending) {
+      state.context.dirty = true;
+      if (!state.context.pending) renderContext();
+    }
+    status.innerHTML = '<div class="stack"><p class="small">Saved as user-provided project knowledge.</p><div class="form-actions">' +
+      memoryLink(result.memoryId, result.projectId, 'View saved memory') + '<button class="button quiet" type="button" id="kit-use-knowledge">Use in skill</button>' +
+      '<a class="button quiet" href="' + esc(routeLink('context', { project: result.projectId })) + '">Open Context Lab ' + icon('chevron', true) +
+      '</a></div><p class="small muted" id="kit-use-status" role="status"></p></div>';
+  } catch (error) {
+    status.innerHTML = errorMarkup(error.message);
+  } finally {
+    kit.saving = false;
+    button.disabled = false;
+  }
+}
+
+function useKitKnowledge() {
+  const status = $('kit-use-status');
+  const field = $('kit-skill-knowledge');
+  if (!status || !kit.savedKnowledge) return;
+  if (field.value.includes(kit.savedKnowledge)) {
+    status.textContent = 'This knowledge is already in the skill draft.';
+    field.focus();
+    return;
+  }
+  const next = [field.value, kit.savedKnowledge].filter((value) => value.trim()).join('\n\n');
+  if (next.length > field.maxLength) {
+    status.textContent = 'The skill draft exceeds 8,000 characters. Use a shorter excerpt from the saved memory.';
+    return;
+  }
+  field.value = next;
+  field.dispatchEvent(new Event('input', { bubbles: true }));
+  status.textContent = 'Added to the skill draft as reference material.';
+  field.focus();
+}
+
+const kitFileStates = { create: ['ok', 'Ready to create'], update: ['ok', 'Ready to update'], unchanged: ['', 'Already current'], conflict: ['warn', 'Protected file'] };
+const kitApplyStates = { created: 'Created', updated: 'Updated', unchanged: 'Already current' };
+
+function renderKitPreview() {
+  const target = $('kit-preview-body');
+  const status = $('kit-preview-state');
+  const files = list(kit.preview?.files);
+  const conflict = files.some((file) => file.status === 'conflict');
+  const ready = !!kit.preview && files.length > 0;
+  const controls = $('kit-apply-controls');
+  controls.hidden = !ready;
+  $('kit-apply').disabled = !ready || conflict || kit.dirty || kit.applying || !!kit.applied;
+  $('kit-preview-submit').disabled = kit.previewing || kit.applying;
+  $('kit-preview').setAttribute('aria-busy', String(kit.previewing || kit.applying));
+  if (kit.previewing) {
+    status.textContent = 'Generating preview';
+    target.innerHTML = skeleton('Building the exact file preview…');
+    return;
+  }
+  if (kit.previewError) {
+    status.textContent = 'Preview failed';
+    target.innerHTML = errorMarkup(kit.previewError);
+    return;
+  }
+  if (!ready) {
+    status.textContent = '';
+    target.innerHTML = blank('context', 'Ready to preview', 'Enter a requirement and choose an agent target.');
+    return;
+  }
+  status.textContent = kit.dirty ? 'Preview out of date' : conflict ? 'Protected file' : kit.applied ? 'Applied locally' : kit.applying ? 'Applying' : 'Ready to review';
+  const preview = kit.preview;
+  const warnings = list(preview.warnings).map((warning) => '<p class="small muted">' + esc(warning) + '</p>').join('');
+  const stale = kit.dirty ? '<p class="status small" role="status">Preview again to review the current file plan.</p>' : '';
+  target.innerHTML = '<div class="panel-body stack">' + stale + warnings + files.map((file) => {
+    const [tone, label] = kitFileStates[file.status] || ['', 'Review'];
+    return '<div class="kit-preview-file"><div class="kit-file-header"><strong class="mono">' + esc(file.relativePath) +
+      '</strong><span class="tag check-' + tone + '">' + label + '</span></div>' +
+      (file.reason ? '<p class="small muted">' + esc(file.reason) + '</p>' : '') +
+      '<pre class="context-preview mono" tabindex="0" aria-label="Generated skill file">' + esc(file.content) + '</pre></div>';
+  }).join('') + '</div>';
+}
+
+async function previewKitSkill() {
+  if (kit.previewing || kit.applying || state.projectKit?.available !== true) return;
+  const requirement = $('kit-requirement').value;
+  const target = $('kit-target').value;
+  const name = $('kit-skill-name').value.trim();
+  const knowledge = $('kit-skill-knowledge').value;
+  if (!requirement.trim()) {
+    kit.previewError = 'Enter a requirement for the skill.';
+    renderKitPreview();
+    return;
+  }
+  const body = { requirement, target, ...(name ? { name } : {}), ...(knowledge.trim() ? { knowledge } : {}) };
+  kit.previewing = true;
+  kit.preview = null;
+  kit.previewInput = body;
+  kit.previewError = '';
+  kit.applied = null;
+  kit.dirty = false;
+  $('kit-apply-status').replaceChildren();
+  renderKitPreview();
+  try {
+    const preview = await api('project-skill-preview', { body });
+    if (preview.projectId !== state.projectKit.projectId || !preview.planHash || !list(preview.files).length) {
+      throw new Error('The server returned an unreadable skill preview.');
+    }
+    kit.preview = preview;
+  } catch (error) {
+    kit.previewError = error.message;
+  } finally {
+    kit.previewing = false;
+    renderKitPreview();
+  }
+}
+
+async function applyKitSkill() {
+  if (!kit.preview || !kit.previewInput || kit.dirty || kit.applying || kit.applied ||
+    list(kit.preview.files).some((file) => file.status === 'conflict') || state.projectKit?.available !== true) return;
+  const status = $('kit-apply-status');
+  kit.applying = true;
+  status.textContent = 'Applying the reviewed plan…';
+  renderKitPreview();
+  try {
+    const result = await api('project-skill-apply', { body: { ...kit.previewInput, expectedPlanHash: kit.preview.planHash } });
+    if (result.projectId !== state.projectKit.projectId || !list(result.files).length) throw new Error('The server returned an unreadable apply result.');
+    kit.applied = result;
+    status.innerHTML = '<p class="small">Skill saved in this project.</p><ul class="kit-applied-list small">' + result.files.map((file) =>
+      '<li>' + esc(kitApplyStates[file.status] || nice(file.status)) + ' <code class="mono">' + esc(file.relativePath) + '</code></li>').join('') + '</ul>' +
+      list(result.warnings).map((warning) => '<p class="small muted">' + esc(warning) + '</p>').join('');
+  } catch (error) {
+    if (error.status === 409) kit.dirty = true;
+    status.innerHTML = errorMarkup(error.message);
+  } finally {
+    kit.applying = false;
+    renderKitPreview();
+  }
+}
+
+$('kit-refresh').addEventListener('click', () => { void loadProjectKit(true); });
+$('kit-identity').addEventListener('click', (event) => {
+  if (event.target.closest('#kit-outcomes-jump')) openOutcomeEditor();
+});
+$('kit-knowledge-form').addEventListener('submit', (event) => { event.preventDefault(); void saveKitKnowledge(); });
+$('kit-knowledge-status').addEventListener('click', (event) => {
+  if (event.target.closest('#kit-use-knowledge')) useKitKnowledge();
+});
+$('kit-skill-form').addEventListener('submit', (event) => { event.preventDefault(); void previewKitSkill(); });
+$('kit-skill-form').addEventListener('input', () => {
+  if (kit.previewInput && !kit.dirty) {
+    kit.dirty = true;
+    renderKitPreview();
+  }
+});
+$('kit-apply').addEventListener('click', () => { void applyKitSkill(); });
+${PROJECT_FEEDBACK_SCRIPT}
+renderKitPreview();
+`;
+//# sourceMappingURL=project-kit-html.js.map

package/dist/dashboard/project-kit-html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-kit-html.js","sourceRoot":"","sources":["../../src/dashboard/project-kit-html.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEtH,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuCzC,sBAAsB;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmD1C,uBAAuB;;;CAGxB,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiQ1C,uBAAuB;;CAExB,CAAC"}

package/dist/dashboard/project-workspace.d.ts

@@ -0,0 +1,16 @@
+/** Persistent, provider-free project portal. Closing never deletes project files. */
+export declare function startProjectWorkspace(directory: string, options?: {
+    port?: number;
+}): Promise<{
+    url: string;
+    close: () => Promise<void>;
+    root: string;
+    projectId: string;
+    projectName: string;
+    storagePath: string;
+    settingsPath: string;
+    annotationsPath: string;
+    journalPath: string;
+    feedbackPath: string;
+}>;
+//# sourceMappingURL=project-workspace.d.ts.map

package/dist/dashboard/project-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-workspace.d.ts","sourceRoot":"","sources":["../../src/dashboard/project-workspace.ts"],"names":[],"mappings":"AAaA,qFAAqF;AACrF,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO;;;;;;;;;;;GA4D7F"}

package/dist/dashboard/project-workspace.js

@@ -0,0 +1,106 @@
+import * as http from 'node:http';
+import { GlobalBrain } from '../brain/global-brain.js';
+import { projectStorage } from '../brain/project-memory.js';
+import { FeatureSettingsStore } from '../brain/feature-settings.js';
+import { memoryAnnotationsFor } from '../brain/memory-annotations.js';
+import { ActivityJournal } from '../brain/activity-journal.js';
+import { handleWorkspaceRequest } from './workspace-api.js';
+import { WORKSPACE_HTML } from './workspace-html.js';
+import { LIVE_WORKSPACE_HTML } from './live-workspace-html.js';
+import { BRAIN_HUB_HTML } from './brain-hub-html.js';
+import { WorkspaceRuntime } from './workspace-status.js';
+import { ProjectHubService } from '../brain/project-hub.js';
+/** Persistent, provider-free project portal. Closing never deletes project files. */
+export async function startProjectWorkspace(directory, options = {}) {
+    const port = options.port ?? 0;
+    if (!Number.isSafeInteger(port) || port < 0 || port > 65535)
+        throw new TypeError('Project port must be an integer from 0 to 65535.');
+    const store = projectStorage(directory);
+    const brain = GlobalBrain.createIsolated({ dbPath: store.storagePath });
+    const settings = new FeatureSettingsStore({ filePath: store.settingsPath });
+    const journal = new ActivityJournal({ filePath: store.journalPath });
+    const annotations = memoryAnnotationsFor(brain);
+    const requests = new Set();
+    const runtime = new WorkspaceRuntime('project', { id: store.projectId, name: store.projectName, root: store.root });
+    let hub;
+    const prepareStorage = async () => {
+        try {
+            await brain.init();
+            brain.refresh();
+            if (brain.getStorageHealth().lastError)
+                return 'Project memory could not be read. Repair the project store, then retry.';
+            hub ?? (hub = new ProjectHubService(store.root, brain));
+            hub.checkStorage();
+            return null;
+        }
+        catch {
+            return 'Project storage could not be opened. Check its files and permissions, then retry.';
+        }
+    };
+    let listener;
+    let closing;
+    const close = () => closing ?? (closing = (async () => {
+        if (listener?.listening) {
+            listener.closeAllConnections();
+            await new Promise((resolve, reject) => listener.close(error => error ? reject(error) : resolve()));
+        }
+        await Promise.allSettled([...requests]);
+        hub?.close();
+        await brain.shutdown();
+    })());
+    try {
+        await prepareStorage();
+        listener = http.createServer((req, res) => {
+            const actualPort = listener.address().port;
+            if (!['127.0.0.1:' + actualPort, 'localhost:' + actualPort].includes(req.headers.host ?? '')) {
+                res.writeHead(403);
+                res.end('Unsupported host.');
+                return;
+            }
+            if (req.url?.startsWith('/api/workspace/')) {
+                const task = handleWorkspaceRequest(req, res, { brain, settings, annotations, journal, projectDir: store.root, localProject: true,
+                    runtime, get hub() { return hub; }, prepareStorage });
+                requests.add(task);
+                void task.finally(() => requests.delete(task));
+                return;
+            }
+            if (req.method !== 'GET') {
+                res.writeHead(405);
+                res.end('Method not allowed.');
+                return;
+            }
+            let pathname;
+            try {
+                pathname = new URL(req.url ?? '/', 'http://localhost').pathname;
+            }
+            catch {
+                res.writeHead(400);
+                res.end('Invalid request URL.');
+                return;
+            }
+            if (pathname === '/favicon.ico') {
+                res.writeHead(204);
+                res.end();
+                return;
+            }
+            const html = pathname === '/' || pathname === '/hub' ? BRAIN_HUB_HTML : pathname === '/workspace' || pathname === '/memory-workspace' ? WORKSPACE_HTML : pathname === '/live' ? LIVE_WORKSPACE_HTML : null;
+            if (!html) {
+                res.writeHead(404);
+                res.end('This project portal serves /hub, /workspace and /live.');
+                return;
+            }
+            res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8', 'Cache-Control': 'no-store', 'X-Content-Type-Options': 'nosniff', 'Referrer-Policy': 'no-referrer' });
+            res.end(html.replace('<html ', '<html data-project-local="true" '));
+        });
+        await new Promise((resolve, reject) => {
+            listener.once('error', reject);
+            listener.listen(port, '127.0.0.1', () => { listener.off('error', reject); resolve(); });
+        });
+        return { ...store, url: 'http://127.0.0.1:' + listener.address().port, close };
+    }
+    catch (error) {
+        await close();
+        throw error;
+    }
+}
+//# sourceMappingURL=project-workspace.js.map

package/dist/dashboard/project-workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-workspace.js","sourceRoot":"","sources":["../../src/dashboard/project-workspace.ts"],"names":[],"mappings":"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"}

package/dist/dashboard/server.d.ts

@@ -5,6 +5,7 @@ export interface DashboardOptions {
     openBrowser?: boolean;
 }
 export declare class DashboardServer {
+    private readonly workspaceRuntime;
     private server;
     private wss;
     private clients;

package/dist/dashboard/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/dashboard/server.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAYxD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAmYD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,GAAG,CAAkB;IAC7B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,iBAAiB,CAA+B;gBAE5C,YAAY,EAAE,YAAY,EAAE,OAAO,GAAE,gBAAqB;IAmBtE,gFAAgF;IAChF,OAAO,CAAC,mBAAmB;IAM3B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAoB7B,OAAO,CAAC,iBAAiB;IAQzB,yEAAyE;IACzE,OAAO,CAAC,aAAa;IAuDrB,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,aAAa;YA2DP,eAAe;IAwvB7B,kFAAkF;YACpE,kBAAkB;YAkFlB,YAAY;IAY1B,OAAO,CAAC,cAAc;IA+CtB,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,iBAAiB;IAkDzB,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,4BAA4B;YAQtB,UAAU;YASV,sBAAsB;IAuCpC,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,CAAC,cAAc;IA4CtB,OAAO,CAAC,uBAAuB;IA2C/B,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,SAAS;IAWX,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAYxB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB3B,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/dashboard/server.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAcxD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAmYD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkC;IACnE,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,GAAG,CAAkB;IAC7B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,iBAAiB,CAA+B;gBAE5C,YAAY,EAAE,YAAY,EAAE,OAAO,GAAE,gBAAqB;IAmBtE,gFAAgF;IAChF,OAAO,CAAC,mBAAmB;IAM3B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAoB7B,OAAO,CAAC,iBAAiB;IAQzB,yEAAyE;IACzE,OAAO,CAAC,aAAa;IAuDrB,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,aAAa;YA8DP,eAAe;IA4vB7B,kFAAkF;YACpE,kBAAkB;YAkFlB,YAAY;IAY1B,OAAO,CAAC,cAAc;IA+CtB,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,iBAAiB;IAkDzB,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,4BAA4B;YAQtB,UAAU;YASV,sBAAsB;IAuCpC,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,CAAC,cAAc;IA4CtB,OAAO,CAAC,uBAAuB;IA2C/B,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,SAAS;IAWX,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAYxB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB3B,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/dashboard/server.js

@@ -14,6 +14,8 @@ import { WORKSPACE_HTML } from './workspace-html.js';
 import { LIVE_WORKSPACE_HTML } from './live-workspace-html.js';
 import { handleWorkspaceRequest } from './workspace-api.js';
 import { getFeatureSettings } from '../brain/feature-settings.js';
+import { BRAIN_HUB_HTML } from './brain-hub-html.js';
+import { WorkspaceRuntime } from './workspace-status.js';
 // ── Embedded HTML Client ──────────────────────────────────────────────────────
 const HTML_CLIENT = `<!DOCTYPE html>
 <html lang="en">
@@ -400,6 +402,7 @@ connect();
 // ── Dashboard Server ──────────────────────────────────────────────────────────
 export class DashboardServer {
     constructor(orchestrator, options = {}) {
+        this.workspaceRuntime = new WorkspaceRuntime('shared');
         this.clients = new Set();
         this.brainBusUnsub = null;
         this.brainWatcher = null;
@@ -539,7 +542,11 @@ export class DashboardServer {
             res.writeHead(status, { 'Content-Type': 'application/json' });
             res.end(JSON.stringify(data, null, 2));
         };
-        if (url === '/' || url === '/index.html' || url === '/workspace') {
+        if (url === '/' || url === '/index.html' || url === '/hub') {
+            res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8', 'Cache-Control': 'no-store' });
+            res.end(BRAIN_HUB_HTML);
+        }
+        else if (url === '/workspace' || url === '/memory-workspace') {
             res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8', 'Cache-Control': 'no-cache' });
             res.end(WORKSPACE_HTML);
         }
@@ -548,7 +555,7 @@ export class DashboardServer {
             res.end(LIVE_WORKSPACE_HTML);
         }
         else if (url.startsWith('/api/workspace/')) {
-            void handleWorkspaceRequest(req, res, { projectDir: this.orchestrator.getStatus().projectDir });
+            void handleWorkspaceRequest(req, res, { projectDir: this.orchestrator.getStatus().projectDir, runtime: this.workspaceRuntime });
         }
         else if (url === '/advanced' || url === '/hive' || url === '/v6' || url === '/hive.html') {
             // Existing advanced tools remain available with their original routes.
@@ -643,10 +650,12 @@ export class DashboardServer {
                 const tokenReport = await tokens.report();
                 const runtime = this.getRuntimeContext();
                 return send({
-                    version: '7.1.3',
+                    version: '7.1.4',
                     localFirst: true,
                     runtime,
                     totalAgentsConnected: brain.getStats().totalAgents,
+                    totalRecordedAgents: brain.getStats().totalAgents,
+                    agentCountEvidence: 'Historical tools recorded in memory; not current connections.',
                     totalMemoriesStored: brain.getStats().totalEntries,
                     modules: {
                         sabb: sabb.getStats(),
@@ -1405,7 +1414,9 @@ export class DashboardServer {
                 const agents = knownAgents.map(name => ({
                     id: name,
                     displayName: displayNames[name] ?? name,
-                    connected: !!hooks.find((h) => h.agent === name) || !!detected.find((d) => d.name === name),
+                    connected: false,
+                    configurationDetected: !!hooks.find((h) => h.agent === name) || !!detected.find((d) => d.name === name),
+                    connectionStatus: 'not-verified',
                 }));
                 // Sub-agents — pull from recent SABB spawn log
                 const sabb = getSubAgentBridge();