portable-agent-layer 0.38.0 → 0.40.0

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

@@ -0,0 +1,20 @@
+interface TemplateBlockProps {
+  label?: string;
+  children: React.ReactNode;
+}
+
+export function TemplateBlock({
+  label = "Copy this template for each opportunity",
+  children,
+}: TemplateBlockProps) {
+  return (
+    <div className="border border-dashed border-border-emphasis rounded-lg p-4 my-6 bg-background-secondary break-inside-avoid">
+      <div className="font-sans text-[0.68rem] font-bold uppercase tracking-widest text-primary mb-3">
+        {label}
+      </div>
+      <pre className="font-mono text-[0.78rem] leading-relaxed text-foreground whitespace-pre-wrap break-words m-0 bg-transparent">
+        <code>{children}</code>
+      </pre>
+    </div>
+  );
+}

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

@@ -1,4 +1,4 @@
-import type { TimelinePhase } from "@/lib/report-data";
+import type { TimelinePhase } from "@/lib/types";
 
 interface TimelineProps {
   phases: TimelinePhase[];
@@ -6,12 +6,31 @@ interface TimelineProps {
 
 export function Timeline({ phases }: TimelineProps) {
   return (
-    <div className="timeline">
+    <div
+      className={[
+        "relative pl-8",
+        // Vertical gradient line down the left edge.
+        "before:content-[''] before:absolute before:left-2 before:top-0 before:bottom-0",
+        "before:w-[2px] before:bg-gradient-to-b before:from-primary before:to-accent",
+      ].join(" ")}
+    >
       {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
+          key={`${phase.phase}-${phase.title}`}
+          className={[
+            "relative pb-6",
+            // Dot on the vertical line.
+            "before:content-[''] before:absolute before:left-[-1.8125rem] before:top-2",
+            "before:w-3 before:h-3 before:rounded-full before:bg-primary",
+          ].join(" ")}
+        >
+          <div className="font-sans font-semibold text-primary text-sm uppercase tracking-widest">
+            {phase.phase}
+          </div>
+          <div className="font-heading font-semibold text-foreground mt-1">
+            {phase.title}
+          </div>
+          <div className="text-muted text-[0.9375rem] mt-1">{phase.description}</div>
           <div className="text-xs text-primary font-medium mt-1">{phase.duration}</div>
         </div>
       ))}

package/assets/skills/consulting-report/template/components/tuning-log.tsx

@@ -0,0 +1,87 @@
+import type { TuningLogEntry } from "@/lib/types";
+
+export type TuningLogColumn = {
+  /** Property of `TuningLogEntry` to read for this column. */
+  key: keyof TuningLogEntry;
+  /** Header text shown in the table. */
+  header: string;
+  /** Optional className applied to all body cells in this column. */
+  cellClassName?: string;
+};
+
+const defaultColumns: TuningLogColumn[] = [
+  {
+    key: "date",
+    header: "Date",
+    cellClassName: "font-sans text-[0.75rem] text-muted whitespace-nowrap",
+  },
+  { key: "parameter", header: "Parameter" },
+  { key: "oldValue", header: "Old value" },
+  { key: "newValue", header: "New value" },
+  { key: "rationale", header: "Rationale" },
+  { key: "approver", header: "Approver" },
+];
+
+interface TuningLogProps {
+  entries: TuningLogEntry[];
+  /**
+   * Override the default 6-column layout. Provide your own columns to add /
+   * remove / reorder fields. Defaults to:
+   * Date, Parameter, Old value, New value, Rationale, Approver.
+   */
+  columns?: TuningLogColumn[];
+  /**
+   * Number of empty rows to render after the entries (useful for printable
+   * forms where future entries are filled in by hand). Defaults to 4.
+   */
+  emptyRows?: number;
+}
+
+export function TuningLog({
+  entries,
+  columns = defaultColumns,
+  emptyRows = 4,
+}: TuningLogProps) {
+  const thClass =
+    "font-sans text-[0.65rem] font-bold uppercase tracking-widest text-primary px-2 py-2 border-b-2 border-primary text-left bg-background-secondary";
+  const tdClass = "px-2 py-2 border-b border-border-subtle align-top";
+
+  return (
+    <table className="w-full border-collapse my-4 font-body text-[0.82rem] break-inside-avoid">
+      <thead>
+        <tr>
+          {columns.map((c) => (
+            <th key={String(c.key)} className={thClass}>
+              {c.header}
+            </th>
+          ))}
+        </tr>
+      </thead>
+      <tbody>
+        {entries.map((entry) => (
+          <tr key={`${entry.date}-${entry.parameter}`}>
+            {columns.map((c) => (
+              <td key={String(c.key)} className={`${tdClass} ${c.cellClassName ?? ""}`}>
+                {entry[c.key]}
+              </td>
+            ))}
+          </tr>
+        ))}
+        {Array.from({ length: emptyRows }, (_, i) => {
+          const row = (
+            // biome-ignore lint/suspicious/noArrayIndexKey: static padding rows, order is fixed
+            <tr key={`empty-${i}`}>
+              <td
+                colSpan={columns.length}
+                className="h-6 bg-background-secondary border-b border-border-subtle"
+              >
+                &nbsp;
+              </td>
+            </tr>
+          );
+          return row;
+        })}
+      </tbody>
+    </table>
+  );
+}

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

@@ -1,77 +1,29 @@
-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;
-  };
-}
+// Default placeholder report data.
+//
+// Each scaffolded project should REPLACE the contents of this file with its
+// own data. The shapes are defined in ./types.ts — only the data lives here.
+//
+// The scaffold tool substitutes [CLIENT NAME] and "Strategic Assessment &
+// Transformation Roadmap" when --client and --title are provided.
+//
+// Re-export the types from ./types here as well, so reports that import from
+// "@/lib/report-data" continue to work.
+
+export type {
+  ConfigurationParameter,
+  Dimension,
+  Finding,
+  Recommendation,
+  ReportData,
+  RubricLevel,
+  Scorecard,
+  ScorecardGate,
+  ScorecardScore,
+  TimelinePhase,
+  TuningLogEntry,
+} from "./types";
+
+import type { ReportData } from "./types";
 
 export const reportData: ReportData = {
   clientName: "[CLIENT NAME]",

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

@@ -0,0 +1,190 @@
+// Type definitions for the consulting-report template.
+//
+// This file is the contract between the template (primitives + types) and the
+// project (the report instance that supplies the actual data). Projects import
+// the types they need; they do NOT edit this file.
+//
+// Two families of types:
+//
+//   1. Strategic-assessment shapes — Finding, Recommendation, TimelinePhase,
+//      and the ReportData interface composed of them. These power the default
+//      scaffolded layout (executive summary, findings, recommendations, etc.).
+//
+//   2. Scoring-playbook shapes — RubricLevel, Dimension, Scorecard, etc. These
+//      power rubric-style deliverables (an opportunity scoring playbook is one
+//      example). Each is optional; projects use whichever apply.
+//
+// Adding a new section type? Add its interface here so all reports share the
+// same vocabulary.
+
+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;
+  };
+}
+
+// --- Scoring-playbook shapes ---
+
+export interface RubricLevel {
+  /** Numeric label for this level (typically 1..N, but free-form). */
+  score: number;
+  label: string;
+  anchor: string;
+  /**
+   * If true, the row renders with a saturated-color border to draw attention
+   * (e.g., flagging a veto-trigger score).
+   */
+  highlight?: boolean;
+}
+
+export interface Dimension {
+  id: string;
+  name: string;
+  parenthetical?: string;
+  definition: string;
+  levels: RubricLevel[];
+  scoringGuidance?: string[];
+  /**
+   * Optional note about who tunes this dimension's anchors and when.
+   * Surfaced by the project's layout (often next to a "TUNABLE" marker).
+   */
+  tuningNote?: string;
+}
+
+export interface ScorecardGate {
+  name: string;
+  verdict: "pass" | "fail" | "n/a" | "flag";
+  note?: string;
+}
+
+export interface ScorecardScore {
+  dimensionId: string;
+  dimensionLabel: string;
+  /** Score for this dimension. Typically 1..N matching the rubric. */
+  score: number;
+  justification: string;
+}
+
+export interface Scorecard {
+  id: string;
+  index: number;
+  name: string;
+  outcome: string;
+  inventoryRef?: string;
+  gates: ScorecardGate[];
+  scores: ScorecardScore[];
+  total: number;
+  /**
+   * Free-form band label. The default `BandBadge` style map covers
+   * "Strong" | "Promising" | "Park" | "Decline"; projects can use any
+   * string and supply their own style map.
+   */
+  band: string;
+  /**
+   * Maximum possible score (used by Scorecard to render "total / maxTotal").
+   * Defaults to 20 when omitted.
+   */
+  maxTotal?: number;
+  weightingNote?: string;
+  vetoTriggered: boolean;
+  vetoNote?: string;
+  recommendation: string;
+  firstAction: string;
+  owner: string;
+  nextReview: string;
+}
+
+export interface ConfigurationParameter {
+  name: string;
+  currentValue: string;
+  location: string;
+  rationale?: string;
+  /**
+   * If true, this parameter is tunable by the report's owner. Renders a
+   * marker next to the parameter name.
+   */
+  tunable?: boolean;
+  /**
+   * Optional label for the tunable marker (e.g., "Owner edit", "Tune at sync").
+   * Defaults to "TUNABLE" when omitted.
+   */
+  tunableLabel?: string;
+}
+
+export interface TuningLogEntry {
+  date: string;
+  parameter: string;
+  oldValue: string;
+  newValue: string;
+  rationale: string;
+  approver: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portable-agent-layer",
-  "version": "0.38.0",
+  "version": "0.40.0",
   "description": "PAL — Portable Agent Layer: persistent personal context for AI coding assistants",
   "type": "module",
   "bin": {
@@ -41,8 +41,7 @@
     "check": "biome check",
     "check-write": "biome check --write",
     "knip": "knip-bun",
-    "arch-check": "bun klint/cli.ts",
-    "klint:schema": "bun klint/tools/generate-schema.ts",
+    "klint": "klint",
     "lint-staged": "lint-staged",
     "prepare": "bun .husky/install.mjs",
     "install:all": "bun run src/cli/index.ts cli install",
@@ -79,9 +78,9 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.3.0",
+    "@konvert7/klint": "^0.2.0",
     "adm-zip": "^0.5.17",
     "marked": "^15.0.12",
-    "playwright": "^1.59.1",
-    "zod": "^4.4.3"
+    "playwright": "^1.59.1"
   }
 }