@polymorphism-tech/morph-spec 8.47.0 → 9.1.0

package/src/dashboard/app/components/CommandPalette.jsx

@@ -8,7 +8,7 @@ import { useMorphQuery } from '../hooks/useMorphQuery.js';
 import { apiBase, projectHref, featureHref } from '../lib/project.js';
 
 const KIND_LABEL = {
-  page: 'Página', project: 'Projeto', feature: 'Feature', task: 'Task', skill: 'Skill', persona: 'Persona',
+  page: 'Página', project: 'Projeto', feature: 'Feature', slice: 'Fatia', skill: 'Skill', persona: 'Persona',
   standard: 'Standard', rule: 'Rule', hook: 'Hook', guide: 'Guia',
 };
 
@@ -17,7 +17,6 @@ const PAGES = [
   ['Personas', '/agents'], ['Standards', '/standards'], ['Rules', '/rules'], ['Hooks', '/hooks'],
 ];
 
-/** Everything the framework knows that has a page — built once. */
 function knowledgeIndex() {
   const out = PAGES.map(([title, to]) => ({ kind: 'page', title, to, hay: title }));
   for (const s of morphData.skills || []) out.push({ kind: 'skill', title: s.id, hint: s.description, to: entityHref('skill', s.id), hay: `${s.id} ${s.description}` });
@@ -42,30 +41,24 @@ function projectIndex(portfolio) {
   return (portfolio?.projects || []).map((p) => ({ kind: 'project', title: p.name, hint: p.dir, to: projectHref(p.id), hay: `${p.name} ${p.dir}` }));
 }
 
-/**
- * Features and their tasks. `projectName` is set for another project's
- * features, so a hit says where it lives.
- */
 function featureIndex(project, features, projectName = null) {
   const out = [];
   const where = (text) => (projectName ? (text ? `${projectName}: ${text}` : projectName) : text);
   for (const f of features || []) {
     out.push({ kind: 'feature', title: f.name, hint: where(f.description), to: featureHref(project, f.name), hay: `${f.name} ${f.description || ''} ${projectName || ''}` });
-    for (const t of f.taskIndex || []) {
-      out.push({ kind: 'task', title: `${t.id} ${t.title}`, hint: where(f.name), to: featureHref(project, f.name, '?tab=tasks'), hay: `${t.id} ${t.title} ${f.name} ${projectName || ''}` });
+    for (const sl of f.sliceIndex || []) {
+      out.push({ kind: 'slice', title: `${sl.id} ${sl.title}`, hint: where(f.name), to: featureHref(project, f.name, '?tab=slices'), hay: `${sl.id} ${sl.title} ${f.name} ${projectName || ''}` });
     }
   }
   return out;
 }
 
-/** The active features of the other projects, from the portfolio's summaries. */
 function otherProjectsIndex(portfolio, project) {
   return (portfolio?.projects || [])
     .filter((p) => p.id !== project && p.summary)
     .flatMap((p) => featureIndex(p.id, p.summary.activeFeatures, p.name));
 }
 
-/** Every query word must appear; a title that starts with the query ranks first. */
 export function searchIndex(index, query, limit = 40) {
   const words = query.toLowerCase().split(/\s+/).filter(Boolean);
   if (!words.length) return [];
@@ -119,7 +112,7 @@ export default function CommandPalette({ open, onClose, portfolio, project }) {
               value={query}
               onChange={(e) => setQuery(e.target.value)}
               onKeyDown={onKey}
-              placeholder="Buscar features, tasks, skills, personas, standards, seções do guia…"
+              placeholder="Buscar features, fatias, skills, personas, standards, seções do guia…"
               className="w-full bg-transparent text-base text-[var(--color-fg)] outline-none focus-visible:outline-none placeholder:text-[var(--color-faint)]"
               aria-controls="palette-results"
               aria-activedescendant={results[active] ? `palette-${active}` : undefined}

package/src/dashboard/app/components/DetailPanel.jsx

@@ -1,11 +1,7 @@
 import { useEffect } from 'react';
 import { X } from '@phosphor-icons/react';
 
-/**
- * The reading drawer of the knowledge pages. Wide enough for rendered markdown,
- * closes on Escape, and sits over the graph without a backdrop so the graph
- * stays visible beside it.
- */
+/** No backdrop: the graph stays visible beside the drawer. */
 export default function DetailPanel({ open, title, subtitle, onClose, children }) {
   useEffect(() => {
     if (!open) return undefined;

package/src/dashboard/app/components/EntityLink.jsx

@@ -1,11 +1,6 @@
 import { Link, useSearchParams } from 'react-router-dom';
 import { useCallback } from 'react';
 
-/**
- * Where each kind of thing lives in the app. The ONE map of entity → URL, so a
- * persona, standard or skill reads as a link everywhere it is mentioned.
- * A feature belongs to a project: its links come from `featureHref` (lib/project.js).
- */
 export function entityHref(kind, id) {
   const q = (page) => `/${page}?sel=${encodeURIComponent(id)}`;
   switch (kind) {
@@ -20,7 +15,6 @@ export function entityHref(kind, id) {
   }
 }
 
-/** `standards/backend/dotnet/testing.md` (as tasks.json cites it) → the registry `path`. */
 export function standardKey(ref) {
   return String(ref).replace(/^\.?\/?(\.morph\/framework\/)?standards\//, '');
 }
@@ -34,12 +28,6 @@ export default function EntityLink({ kind, id, children, className = '', chip =
   return <Link to={entityHref(kind, id)} className={cls} title={title}>{children ?? id}</Link>;
 }
 
-/**
- * The selected item of a knowledge page, kept in `?sel=` so a panel can be
- * linked, bookmarked and reached from anywhere with EntityLink.
- *
- * @returns {[string|null, (id: string|null) => void]}
- */
 export function useSelection() {
   const [params, setParams] = useSearchParams();
   const sel = params.get('sel');

package/src/dashboard/app/components/ErrorBoundary.jsx

@@ -1,15 +1,8 @@
 import { Component } from 'react';
 
 /**
- * Catches a page that throws while rendering and shows the error in place of
- * the page, so the rest of the layout (the sidebar) keeps working.
- *
- * Without it one broken page unmounts the whole tree: 8.38.0 opened on
- * /agents, which threw a ReferenceError, and the dashboard was a black screen.
- *
  * Mount it with `key={location.pathname}`: a boundary that already caught an
- * error stays in fallback until it remounts, and the key remounts it when the
- * sidebar navigates to another page.
+ * error stays in fallback until it remounts.
  */
 export default class ErrorBoundary extends Component {
   constructor(props) {

package/src/dashboard/app/components/KnowledgeMarkdown.jsx

@@ -2,9 +2,6 @@ import morphData from 'virtual:morph-data';
 import Markdown from './Markdown.jsx';
 import EntityLink, { standardKey } from './EntityLink.jsx';
 
-/**
- * Names of things that have a page. Built once from the knowledge module.
- */
 const skillIds = new Set((morphData.skills || []).map((s) => s.id));
 const personaIds = new Set((morphData.agents?.list || []).map((a) => a.id));
 const standardByKey = new Map();
@@ -13,13 +10,6 @@ for (const s of morphData.standards?.list || []) {
   standardByKey.set(s.path, s.id);
 }
 
-/**
- * What an inline code span names, if it names something with a page:
- * `morph-plan` or `/morph-plan` → skill, `morph-dotnet-senior` → persona,
- * a standard id or path → standard.
- *
- * @returns {{ kind: string, id: string } | null}
- */
 export function resolveMention(text) {
   const t = String(text).trim();
   const bare = t.replace(/^\//, '');
@@ -47,7 +37,6 @@ function InlineCode({ className, children, node, ...rest }) {
   return <code className={className} {...rest}>{children}</code>;
 }
 
-/** Markdown for framework and feature text: code spans that name a skill, persona or standard become links. */
 export default function KnowledgeMarkdown({ components, ...props }) {
   return <Markdown {...props} components={{ code: InlineCode, ...components }} />;
 }

package/src/dashboard/app/components/Markdown.jsx

@@ -6,7 +6,6 @@ import { splitFrontmatter } from '../lib/format.js';
 const REMARK = [remarkGfm];
 const REHYPE = [rehypeSlug];
 
-/** Frontmatter keys worth showing, in the order a reader wants them. */
 const META_ORDER = ['name', 'description', 'when_to_use', 'user-invocable', 'stacks', 'version', 'cliVersion'];
 
 function MetaBlock({ meta }) {
@@ -26,14 +25,6 @@ function MetaBlock({ meta }) {
   );
 }
 
-/**
- * Rendered markdown for every long text in the app: feature artifacts, skills,
- * standards, the charter. Frontmatter is lifted into a metadata block instead
- * of being printed as text.
- *
- * @param {{ text: string, components?: object, className?: string, size?: 'md'|'sm' }} props
- *   `sm` is for side panels, where the reading column is narrower.
- */
 export default function Markdown({ text, components, className = '', size = 'md' }) {
   const { meta, body } = splitFrontmatter(text || '');
   return (

package/src/dashboard/app/components/PhaseRail.jsx

@@ -1,16 +1,5 @@
 import { PHASES, PHASE_INDEX, GATE_LABEL, phaseMeta } from '../lib/phases.js';
 
-/**
- * The phase rail: one segment per phase, a notch after each phase that ends in
- * an approval gate. The same motif is used in the feature list (sm) and in the
- * feature header (lg), so a feature's progress always reads the same way.
- *
- * Segment state is derived, never stored:
- *   done     — before the current phase, or the whole feature is completed
- *   current  — the derived phase of an active feature
- *   skipped  — an optional phase (uiux) the feature went past without its gate
- *   todo     — after the current phase
- */
 export function segmentStates(feature) {
   const idx = PHASE_INDEX[feature.phase] ?? 0;
   const finished = feature.status === 'completed';

package/src/dashboard/app/components/SearchFilter.jsx

@@ -1,10 +1,6 @@
 import { useState } from 'react';
 import { MagnifyingGlass } from '@phosphor-icons/react';
 
-/**
- * The toolbar of the knowledge pages: a search box and a few selects. The
- * `value` of each filter is controlled by the page; the search text is local.
- */
 export default function SearchFilter({ placeholder = 'Buscar', filters = [], onSearchChange, onFilterChange, children }) {
   const [search, setSearch] = useState('');
   function handleSearchChange(e) {

package/src/dashboard/app/components/Sidebar.jsx

@@ -30,10 +30,6 @@ const linkClass = ({ isActive }) => [
   isActive ? 'bg-white/[0.08] text-[var(--color-fg)] shadow-[inset_0_1px_0_rgb(255_255_255_/_0.06)]' : 'text-[var(--color-dim)] hover:bg-white/[0.04] hover:text-[var(--color-fg)]',
 ].join(' ');
 
-/**
- * Switching project keeps the page: from a feature's detail it lands on the
- * other project's feature list, from Activity on the other project's Activity.
- */
 function ProjectSwitcher({ portfolio, current }) {
   const navigate = useNavigate();
   const { pathname } = useLocation();
@@ -122,7 +118,6 @@ export default function Sidebar({ portfolio, current, pulse, onSearch }) {
   );
 }
 
-/** The same destinations as a compact bar for narrow screens. */
 export function MobileNav({ current, onSearch }) {
   const items = [
     { to: '/', label: 'Portfólio' },

package/src/dashboard/app/hooks/useMorphQuery.js

@@ -1,18 +1,8 @@
 import { useEffect, useRef, useState } from 'react';
 
 /**
- * Fetch a `/api/morph/*` resource and refetch it whenever the dev server
- * reports that the project's `.morph/` changed in the given scope.
- *
- * `scope` matches the server's invalidation: 'features' (feature.json,
- * tasks.json, artifacts) or 'activity' (events.jsonl). A refetch keeps the old
- * data on screen until the new one arrives — no flash of "loading" while an
- * agent is working.
- *
+ * A refetch keeps the old data on screen until the new one arrives.
  * @param {string|null} url - null skips the request
- * @param {{ scope?: string|string[], project?: string }} [opts] - `scope`: 'features',
- *   'activity' or 'projects'; `project`: only changes of this project refetch
- * @returns {{ data: any, error: string|null, loading: boolean, refreshedAt: number|null, refetch: () => void }}
  */
 export function useMorphQuery(url, { scope = 'features', project } = {}) {
   const [state, setState] = useState({ data: null, error: null, loading: Boolean(url), refreshedAt: null });

package/src/dashboard/app/hooks/usePref.js

@@ -11,10 +11,7 @@ function read(key, fallback) {
   }
 }
 
-/**
- * A per-browser preference (view mode, filters). Storage can be unavailable or
- * throw (private mode, SSR); the value then simply does not persist.
- */
+/** Storage can be unavailable or throw (private mode, SSR); the value then does not persist. */
 export function usePref(key, fallback) {
   const [value, setValue] = useState(() => (typeof window === 'undefined' ? fallback : read(key, fallback)));
   const set = useCallback((next) => {
@@ -27,7 +24,6 @@ export function usePref(key, fallback) {
   return [value, set];
 }
 
-/** Re-render every `ms` so relative times ("há 30 s") and "working now" stay true. */
 export function useNow(ms = 15_000) {
   const [now, setNow] = useState(() => Date.now());
   useEffect(() => {

package/src/dashboard/app/lib/format.js

@@ -8,7 +8,6 @@ const UNITS = [
   ['minute', 60],
 ];
 
-/** "há 12 minutos" — or an em dash when there is no date. */
 export function timeAgo(iso, now = Date.now()) {
   const t = Date.parse(iso || '');
   if (Number.isNaN(t)) return '—';
@@ -56,7 +55,6 @@ export function duration(seconds) {
   return `${Math.floor(m / 60)} h ${m % 60} min`;
 }
 
-/** Strip a leading YAML frontmatter block, returning both parts. */
 export function splitFrontmatter(text) {
   const m = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/.exec(text || '');
   if (!m) return { meta: null, body: text || '' };

package/src/dashboard/app/lib/phases.js

@@ -1,14 +1,9 @@
-/**
- * Display vocabulary for the phase pipeline. The ORDER and the optional flag
- * come from framework/phases.json (morphData.phases); this file only adds the
- * words and the colour token each phase is shown with.
- */
+/** The ORDER and the optional flag come from framework/phases.json; this file only adds words and colours. */
 import morphData from 'virtual:morph-data';
 
 const LABELS = {
-  proposal: 'Proposta',
-  uiux: 'UI/UX',
   plan: 'Plano',
+  uiux: 'UI/UX',
   implement: 'Implementação',
   review: 'Revisão',
 };
@@ -29,9 +24,8 @@ export function phaseMeta(id) {
 }
 
 export const GATE_LABEL = {
-  proposal: 'Gate 1 (proposta)',
+  plan: 'Gate do plano',
   uiux: 'Gate UI/UX',
-  plan: 'Gate 2 (plano)',
   review: 'Gate 3 (revisão)',
 };
 

package/src/dashboard/app/lib/project.js

@@ -3,10 +3,8 @@ import { useLocation } from 'react-router-dom';
 import { usePref } from '../hooks/usePref.js';
 import { useMorphQuery } from '../hooks/useMorphQuery.js';
 
-/** The live API of one project. */
 export const apiBase = (id) => `/api/morph/p/${encodeURIComponent(id)}`;
 
-/** A page of one project: `/p/{id}/features`, `/p/{id}/features/{name}`, `/p/{id}/activity`. */
 export const projectHref = (id, sub = 'features') => `/p/${encodeURIComponent(id)}/${sub}`;
 
 export const featureHref = (project, name, query = '') =>
@@ -14,10 +12,8 @@ export const featureHref = (project, name, query = '') =>
 
 const PROJECTS_CHANGED = 'morph:projects-changed';
 
-/** Tell every reader of the portfolio (page, sidebar, search) to read it again. */
 export const announceProjectsChanged = () => window.dispatchEvent(new Event(PROJECTS_CHANGED));
 
-/** The portfolio: registered projects, their summaries, and the ones found next to them. */
 export function useProjects() {
   const q = useMorphQuery('/api/morph/projects', { scope: 'projects' });
   const refetch = useRef(q.refetch);
@@ -30,14 +26,6 @@ export function useProjects() {
   return q;
 }
 
-/**
- * The project the person is looking at: the one in the URL, else the last one
- * they opened, else the one the dashboard was launched from. Knowledge pages
- * have no project in the URL but the sidebar still needs one to link to.
- *
- * @param {{ launch?: string|null, projects?: Array<{id: string}> }|null} portfolio
- * @returns {{ id: string|null, inUrl: boolean }}
- */
 export function useCurrentProject(portfolio) {
   const { pathname } = useLocation();
   const m = /^\/p\/([^/]+)/.exec(pathname);

package/src/dashboard/app/pages/Activity.jsx

@@ -13,7 +13,7 @@ export default function Activity() {
         <h1 className="mt-1 text-4xl font-semibold tracking-tight">Atividade</h1>
         <p className="mt-3 max-w-2xl text-sm leading-relaxed text-[var(--color-dim)]">
           O que o Claude fez no projeto, contado a partir da telemetria dos hooks: suas mensagens, as skills carregadas,
-          os sub-agents despachados, as tasks, os verifies e os gates. Atualiza sozinho enquanto ele trabalha.
+          os sub-agents despachados, os verifies e os gates. Atualiza sozinho enquanto ele trabalha.
         </p>
       </header>
       <div className="rise-2 bezel">

package/src/dashboard/app/pages/AgentMap.jsx

@@ -10,11 +10,7 @@ import Markdown from '../components/Markdown.jsx';
 import EntityLink, { useSelection } from '../components/EntityLink.jsx';
 import { phaseMeta } from '../lib/phases.js';
 
-/**
- * `agents.json → color` is a color NAME (blue, cyan…), the one Claude Code
- * paints the sub-agent with. The map reads the same name, so a persona looks
- * the same here and in the terminal.
- */
+/** Color NAMES, the ones Claude Code paints the sub-agent with. */
 const COLOR_HEX = {
   blue: '#60a5fa',
   cyan: '#22d3ee',
@@ -29,13 +25,11 @@ const COLOR_HEX = {
 };
 const FALLBACK_HEX = '#9ca3af';
 
-/** The ONE color lookup: nodes, edges, detail badge and legend all read it. */
 const personaColor = (agent) => COLOR_HEX[agent?.color] || FALLBACK_HEX;
 
 /** `'*'` in a persona's `stack` means "every stack" — it is not a stack of its own. */
 const UNIVERSAL_STACK = '*';
 
-/** The node of the human + main thread. Never a persona id. */
 const PRINCIPAL_ID = 'principal';
 
 const NODE_W = 220;
@@ -81,7 +75,6 @@ function buildLayout(nodes, edges) {
   });
 }
 
-/** Skills whose dispatch lines name this persona, or dispatch any implementer. */
 function dispatchingSkills(agent) {
   const implementer = (agent.activePhases || []).includes('implement');
   return (morphData.skills || []).filter((s) => (s.dispatches || []).some(