portable-agent-layer 0.30.1 → 0.31.0

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();
+}