portable-agent-layer 0.30.1 → 0.32.0

package/assets/skills/consulting-report/template/components/exhibit.tsx

@@ -0,0 +1,21 @@
+interface ExhibitProps {
+  number: number | string;
+  title: string;
+  source?: string;
+  children: React.ReactNode;
+}
+
+export function Exhibit({ number, title, source, children }: ExhibitProps) {
+  return (
+    <div className="exhibit">
+      <div className="exhibit-header">
+        <div>
+          <span className="exhibit-number">Exhibit {number}</span>
+          <span className="exhibit-title ml-3">{title}</span>
+        </div>
+        {source && <span className="text-xs text-muted italic">Source: {source}</span>}
+      </div>
+      <div className="exhibit-content">{children}</div>
+    </div>
+  );
+}

package/assets/skills/consulting-report/template/components/finding-card.tsx

@@ -0,0 +1,28 @@
+import type { Finding } from "@/lib/report-data";
+import { SeverityBadge } from "./severity-badge";
+
+interface FindingCardProps {
+  finding: Finding;
+  index: number;
+}
+
+export function FindingCard({ finding, index }: FindingCardProps) {
+  return (
+    <div className="finding-card">
+      <div className="finding-header">
+        <div className="flex items-center gap-4">
+          <span className="text-primary font-bold font-sans text-2xl min-w-8">
+            {index + 1}.
+          </span>
+          <span className="finding-title">{finding.title}</span>
+        </div>
+        <SeverityBadge severity={finding.severity} />
+      </div>
+      <p className="text-foreground mb-2 ml-12">{finding.description}</p>
+      <p className="finding-evidence ml-12">
+        <span className="font-medium text-foreground">Evidence:</span> {finding.evidence}
+      </p>
+      <p className="text-xs text-muted mt-2 italic ml-12">Source: {finding.source}</p>
+    </div>
+  );
+}

package/assets/skills/consulting-report/template/components/quote-block.tsx

@@ -0,0 +1,17 @@
+interface QuoteBlockProps {
+  quote: string;
+  attribution: string;
+  role?: string;
+}
+
+export function QuoteBlock({ quote, attribution, role }: QuoteBlockProps) {
+  return (
+    <div className="quote-block">
+      <p className="quote-text">{quote}</p>
+      <p className="quote-attribution">
+        — {attribution}
+        {role && <span className="text-muted">, {role}</span>}
+      </p>
+    </div>
+  );
+}

package/assets/skills/consulting-report/template/components/recommendation-card.tsx

@@ -0,0 +1,52 @@
+import { ArrowRight, Clock, Zap } from "lucide-react";
+import type { Recommendation } from "@/lib/report-data";
+import { cn } from "@/lib/utils";
+
+interface RecommendationCardProps {
+  recommendation: Recommendation;
+  index: number;
+}
+
+const priorityConfig = {
+  immediate: {
+    icon: Zap,
+    label: "Immediate",
+    className: "bg-destructive/10 text-destructive border-destructive/20",
+  },
+  "short-term": {
+    icon: Clock,
+    label: "Short-term",
+    className: "bg-warning/10 text-warning border-warning/20",
+  },
+  "long-term": {
+    icon: ArrowRight,
+    label: "Long-term",
+    className: "bg-primary/10 text-primary border-primary/20",
+  },
+} as const;
+
+export function RecommendationCard({ recommendation, index }: RecommendationCardProps) {
+  const config = priorityConfig[recommendation.priority];
+  const Icon = config.icon;
+
+  return (
+    <div className="finding-card">
+      <div className="finding-header">
+        <div className="flex items-start gap-3">
+          <span className="text-primary font-bold font-sans text-lg">{index + 1}</span>
+          <span className="finding-title">{recommendation.title}</span>
+        </div>
+        <span
+          className={cn(
+            "inline-flex items-center gap-1.5 px-3 py-1 rounded-full text-xs font-semibold border",
+            config.className
+          )}
+        >
+          <Icon className="h-3 w-3" />
+          {config.label}
+        </span>
+      </div>
+      <p className="text-foreground ml-8">{recommendation.description}</p>
+    </div>
+  );
+}

package/assets/skills/consulting-report/template/components/section.tsx

@@ -0,0 +1,17 @@
+import { cn } from "@/lib/utils";
+
+interface SectionProps {
+  id?: string;
+  title: string;
+  children: React.ReactNode;
+  className?: string;
+}
+
+export function Section({ id, title, children, className }: SectionProps) {
+  return (
+    <section id={id} className={cn("report-section", className)}>
+      <h2>{title}</h2>
+      {children}
+    </section>
+  );
+}

package/assets/skills/consulting-report/template/components/severity-badge.tsx

@@ -0,0 +1,19 @@
+import { cn } from "@/lib/utils";
+
+type Severity = "critical" | "high" | "medium" | "low";
+
+interface SeverityBadgeProps {
+  severity: Severity;
+}
+
+const severityConfig: Record<Severity, { label: string; className: string }> = {
+  critical: { label: "Critical", className: "severity-critical" },
+  high: { label: "High", className: "severity-high" },
+  medium: { label: "Medium", className: "severity-medium" },
+  low: { label: "Low", className: "severity-low" },
+};
+
+export function SeverityBadge({ severity }: SeverityBadgeProps) {
+  const config = severityConfig[severity];
+  return <span className={cn("severity-badge", config.className)}>{config.label}</span>;
+}

package/assets/skills/consulting-report/template/components/stat-grid.tsx

@@ -0,0 +1,26 @@
+interface Stat {
+  value: string;
+  label: string;
+  caption?: string;
+}
+
+interface StatGridProps {
+  stats: Stat[];
+}
+
+export function StatGrid({ stats }: StatGridProps) {
+  return (
+    <div
+      className="stat-grid"
+      style={{ gridTemplateColumns: `repeat(${stats.length}, minmax(0, 1fr))` }}
+    >
+      {stats.map((s) => (
+        <div key={s.label} className="stat">
+          <div className="stat-value">{s.value}</div>
+          <div className="stat-label">{s.label}</div>
+          {s.caption && <div className="stat-caption">{s.caption}</div>}
+        </div>
+      ))}
+    </div>
+  );
+}

package/assets/skills/consulting-report/template/components/table-of-contents.tsx

@@ -0,0 +1,27 @@
+interface TocItem {
+  id: string;
+  title: string;
+}
+
+interface TableOfContentsProps {
+  items: TocItem[];
+  title?: string;
+}
+
+export function TableOfContents({ items, title = "Contents" }: TableOfContentsProps) {
+  return (
+    <nav className="toc">
+      <h2>{title}</h2>
+      <ol>
+        {items.map((item, i) => (
+          <li key={item.id}>
+            <a href={`#${item.id}`}>
+              <span className="toc-number">{(i + 1).toString().padStart(2, "0")}</span>
+              <span className="toc-title">{item.title}</span>
+            </a>
+          </li>
+        ))}
+      </ol>
+    </nav>
+  );
+}

package/assets/skills/consulting-report/template/components/timeline.tsx

@@ -0,0 +1,20 @@
+import type { TimelinePhase } from "@/lib/report-data";
+
+interface TimelineProps {
+  phases: TimelinePhase[];
+}
+
+export function Timeline({ phases }: TimelineProps) {
+  return (
+    <div className="timeline">
+      {phases.map((phase) => (
+        <div key={`${phase.phase}-${phase.title}`} className="timeline-item">
+          <div className="timeline-phase">{phase.phase}</div>
+          <div className="timeline-title">{phase.title}</div>
+          <div className="timeline-description">{phase.description}</div>
+          <div className="text-xs text-primary font-medium mt-1">{phase.duration}</div>
+        </div>
+      ))}
+    </div>
+  );
+}

package/assets/skills/consulting-report/template/lib/report-data.ts

@@ -0,0 +1,176 @@
+export interface Finding {
+  id: string;
+  title: string;
+  description: string;
+  evidence: string;
+  source: string;
+  severity: "critical" | "high" | "medium" | "low";
+}
+
+export interface Recommendation {
+  id: string;
+  title: string;
+  description: string;
+  priority: "immediate" | "short-term" | "long-term";
+}
+
+export interface TimelinePhase {
+  phase: string;
+  title: string;
+  description: string;
+  duration: string;
+}
+
+export interface ReportData {
+  clientName: string;
+  reportTitle: string;
+  reportDate: string;
+  classification: string;
+  consultancyName: string;
+  preTitle?: string;
+
+  executiveSummary: {
+    context: string;
+    methodology: { interviewCount: number; roles: string[] };
+    keyFindings: string[];
+    primaryRecommendation: string;
+    expectedOutcomes: string[];
+  };
+
+  situationAssessment: {
+    currentState: string;
+    clientAsk: string;
+    whyNow: string;
+  };
+
+  findings: Finding[];
+
+  riskAnalysis: {
+    existentialRisks: string[];
+    competitiveThreats: string[];
+    timelinePressures: string;
+  };
+
+  strategicOpportunity: {
+    goodNews: string;
+    requirements: string[];
+  };
+
+  recommendations: Recommendation[];
+
+  targetState: {
+    description: string;
+    keyCapabilities: string[];
+    successMetrics: string[];
+  };
+
+  roadmap: TimelinePhase[];
+
+  callToAction: {
+    immediateSteps: string[];
+    decisionPoints: string[];
+    commitmentRequired: string;
+  };
+}
+
+export const reportData: ReportData = {
+  clientName: "[CLIENT NAME]",
+  reportTitle: "Strategic Assessment & Transformation Roadmap",
+  reportDate: new Date().toLocaleDateString("en-US", {
+    year: "numeric",
+    month: "long",
+    day: "numeric",
+  }),
+  classification: "CONFIDENTIAL",
+  consultancyName: "[YOUR CONSULTANCY]",
+  preTitle: "Strategic Assessment",
+
+  executiveSummary: {
+    context:
+      "This report presents findings from a comprehensive assessment of [CLIENT], conducted to evaluate strategic readiness and identify transformation opportunities.",
+    methodology: {
+      interviewCount: 0,
+      roles: ["Executive Leadership", "Department Heads", "Team Leads"],
+    },
+    keyFindings: [
+      "Finding 1 — replace with actual finding",
+      "Finding 2 — replace with actual finding",
+      "Finding 3 — replace with actual finding",
+    ],
+    primaryRecommendation: "Based on this analysis, [PRIMARY RECOMMENDATION HERE]",
+    expectedOutcomes: ["Expected outcome 1", "Expected outcome 2", "Expected outcome 3"],
+  },
+
+  situationAssessment: {
+    currentState: "Replace with current state analysis.",
+    clientAsk: "Replace with what the client originally asked for.",
+    whyNow: "Replace with why this matters now — the underlying drivers.",
+  },
+
+  findings: [
+    {
+      id: "F1",
+      title: "Finding Title",
+      description: "Description of the finding.",
+      evidence: "Evidence supporting this finding.",
+      source: "Interview / data / observation",
+      severity: "critical",
+    },
+  ],
+
+  riskAnalysis: {
+    existentialRisks: ["Replace with existential risks"],
+    competitiveThreats: ["Replace with competitive threats"],
+    timelinePressures: "Replace with timeline pressures and urgency factors.",
+  },
+
+  strategicOpportunity: {
+    goodNews: "Replace with the strategic pivot — the path forward.",
+    requirements: ["Requirement 1", "Requirement 2", "Requirement 3"],
+  },
+
+  recommendations: [
+    {
+      id: "R1",
+      title: "Primary Recommendation",
+      description: "Description of the recommendation.",
+      priority: "immediate",
+    },
+  ],
+
+  targetState: {
+    description: "Replace with the vision description.",
+    keyCapabilities: ["Capability 1", "Capability 2", "Capability 3"],
+    successMetrics: ["Metric 1", "Metric 2", "Metric 3"],
+  },
+
+  roadmap: [
+    {
+      phase: "Phase 1",
+      title: "Foundation",
+      description: "Initial phase description.",
+      duration: "Weeks 1-4",
+    },
+    {
+      phase: "Phase 2",
+      title: "Implementation",
+      description: "Main implementation phase.",
+      duration: "Weeks 5-12",
+    },
+    {
+      phase: "Phase 3",
+      title: "Optimization",
+      description: "Optimization and scaling.",
+      duration: "Weeks 13-20",
+    },
+  ],
+
+  callToAction: {
+    immediateSteps: ["Immediate next step 1", "Immediate next step 2"],
+    decisionPoints: [
+      "Decision point 1 requiring leadership approval",
+      "Decision point 2",
+    ],
+    commitmentRequired: "Replace with the commitment required.",
+  },
+};

package/assets/skills/consulting-report/template/lib/utils.ts

@@ -0,0 +1,6 @@
+import { type ClassValue, clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}

package/assets/skills/consulting-report/template/next.config.js

@@ -0,0 +1,9 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  output: "export",
+  images: { unoptimized: true },
+  trailingSlash: true,
+  turbopack: { root: __dirname },
+};
+
+module.exports = nextConfig;

package/assets/skills/consulting-report/template/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "consulting-report",
+  "version": "0.0.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "next": "16.2.4",
+    "react": "19.2.5",
+    "react-dom": "19.2.5",
+    "lucide-react": "1.14.0",
+    "clsx": "2.1.1",
+    "tailwind-merge": "3.5.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "4.2.4",
+    "@types/node": "25.6.0",
+    "@types/react": "19.2.14",
+    "@types/react-dom": "19.2.3",
+    "postcss": "8.5.13",
+    "tailwindcss": "4.2.4",
+    "typescript": "6.0.3"
+  }
+}

package/assets/skills/consulting-report/template/postcss.config.mjs

@@ -0,0 +1,5 @@
+export default {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};

package/assets/skills/consulting-report/template/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "target": "ES2017",
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": { "@/*": ["./*"] }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts"
+  ],
+  "exclude": ["node_modules"]
+}

package/assets/skills/consulting-report/tools/dev.ts

@@ -0,0 +1,47 @@
+#!/usr/bin/env bun
+
+// consulting-report skill tool: launch the Next.js dev server for live preview.
+//
+// Usage:
+//   bun ~/.pal/skills/consulting-report/tools/dev.ts <report-dir>
+
+import { spawnSync } from "node:child_process";
+import { constants as fsConstants } from "node:fs";
+import { access } from "node:fs/promises";
+import { join, resolve } from "node:path";
+
+async function exists(p: string): Promise<boolean> {
+  try {
+    await access(p, fsConstants.F_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export async function dev(reportDir: string): Promise<number> {
+  const dir = resolve(reportDir);
+  const pkg = join(dir, "package.json");
+  if (!(await exists(pkg))) {
+    throw new Error(`not a scaffolded report (missing package.json): ${dir}`);
+  }
+  const result = spawnSync("bun", ["run", "dev"], {
+    cwd: dir,
+    stdio: "inherit",
+    shell: true,
+  });
+  return result.status ?? 1;
+}
+
+export async function run(argv: string[] = process.argv.slice(2)): Promise<void> {
+  if (argv.length === 0) {
+    console.error("usage: dev.ts <report-dir>");
+    process.exit(1);
+  }
+  const status = await dev(argv[0]);
+  process.exit(status);
+}
+
+if (import.meta.main) {
+  await run();
+}