@hasna/skills 0.1.51 → 0.1.52

package/bin/index.js

@@ -36860,7 +36860,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/skills",
-    version: "0.1.51",
+    version: "0.1.52",
     description: "Skills library for AI coding agents",
     type: "module",
     bin: {
@@ -40146,6 +40146,13 @@ var init_project_management = __esm(() => {
       description: "Facilitate project retrospectives with structured reflection and action items",
       category: "Project Management",
       tags: ["retrospective", "project", "feedback", "improvement"]
+    },
+    {
+      name: "project-dashboard-reports",
+      displayName: "Project Dashboard Reports",
+      description: "Create, validate, and serve standardized Hasna project dashboard reports",
+      category: "Project Management",
+      tags: ["projects", "dashboard", "reports", "json-render"]
     }
   ];
 });

package/bin/mcp.js

@@ -21819,7 +21819,7 @@ class StdioServerTransport {
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.1.51",
+  version: "0.1.52",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {
@@ -31143,6 +31143,13 @@ var PROJECT_MANAGEMENT_SKILLS = [
     description: "Facilitate project retrospectives with structured reflection and action items",
     category: "Project Management",
     tags: ["retrospective", "project", "feedback", "improvement"]
+  },
+  {
+    name: "project-dashboard-reports",
+    displayName: "Project Dashboard Reports",
+    description: "Create, validate, and serve standardized Hasna project dashboard reports",
+    category: "Project Management",
+    tags: ["projects", "dashboard", "reports", "json-render"]
   }
 ];
 

package/dist/index.js

@@ -2346,6 +2346,13 @@ var PROJECT_MANAGEMENT_SKILLS = [
     description: "Facilitate project retrospectives with structured reflection and action items",
     category: "Project Management",
     tags: ["retrospective", "project", "feedback", "improvement"]
+  },
+  {
+    name: "project-dashboard-reports",
+    displayName: "Project Dashboard Reports",
+    description: "Create, validate, and serve standardized Hasna project dashboard reports",
+    category: "Project Management",
+    tags: ["projects", "dashboard", "reports", "json-render"]
   }
 ];
 
@@ -18833,7 +18840,7 @@ import { dirname as dirname4, relative as relative3 } from "path";
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.1.51",
+  version: "0.1.52",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/skills",
-  "version": "0.1.51",
+  "version": "0.1.52",
   "description": "Skills library for AI coding agents",
   "type": "module",
   "bin": {

package/skills/project-dashboard-reports/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: project-dashboard-reports
+description: Use when creating, validating, serving, or documenting Hasna agent-managed project dashboards and JSON Render reports with the Projects CLI, provider panels, .hasna/project layout, or #iproj-* project channels.
+---
+
+# Project Dashboard Reports
+
+Use the Projects-owned dashboard surface for agent-managed project folders.
+Do not build a one-off app or chat UI unless `open-projects` cannot express the
+surface.
+
+## Canonical Layout
+
+- Project folder: `Workspace/<division>/project/<project-slug>`
+- Dashboard root: `.hasna/project/`
+- Render manifest: `.hasna/project/dashboard/render.json`
+- Latest snapshot: `.hasna/project/dashboard/snapshots/latest.snapshot.json`
+- Conversation channel: CLI name `iproj-<project-slug>`, human display
+  `#iproj-<project-slug>`
+
+Project folders may contain private documents. Dashboard JSON should use ids,
+counts, statuses, resource refs, evidence refs, and redacted summaries rather
+than raw emails, contract clauses, account numbers, identity documents, or
+credentials.
+
+## Viewer Workflow
+
+Use the explicit dashboard namespace:
+
+```bash
+projects dashboard snapshot <project> --write --json
+projects dashboard render <project> --json
+projects dashboard validate <project> --json
+PROJECTS_DASHBOARD_TOKEN=<token> projects dashboard serve <project> --host 0.0.0.0 --port <port>
+```
+
+`snapshot`, `render`, and `validate` are read-only unless `--write` is passed.
+For non-loopback serving, use `--token`, `PROJECTS_DASHBOARD_TOKEN`, or an
+explicit `--trust-network` choice. Do not put dashboard access tokens in URLs,
+tasks, reports, render specs, or chat messages.
+
+## Provider Panels
+
+Provider CLIs should emit bounded `hasna.project_panel.v1` JSON:
+
+```bash
+todos project-panel --project <project> --json --contract
+files project-panel --project <project> --json --contract
+mailery status project-panel --project <project> --limit 20 --json --contract
+conversations project-panel --project <project> --limit 30 --json --contract
+knowledge project-panel --project <project> --scope project --limit 30 --json --contract
+mementos --json project-panel --project <project> --contract
+reports project-panel --project <project> --json --contract
+```
+
+Run provider commands from the project cwd when project-local stores matter.
+Mailery remains workspace-scoped until explicit project-email mapping exists.
+Providers should degrade to unavailable/error panels instead of dumping raw
+content.
+
+## Agent Workflow
+
+- Track work in `todos`; use messages only for coordination.
+- Use durable Codewith goals or goal plans for long-running project work.
+- Route new implementation and verification through fresh task-triggered agents,
+  not existing tmux panes.
+- Record evidence as task ids, project ids, commit ids, local artifact paths, and
+  dashboard URLs.
+- Update durable knowledge with stable architecture or policy decisions, but do
+  not store secrets or raw private document text as knowledge.
+
+## Done Criteria
+
+- `projects dashboard validate <project> --json` passes.
+- Dashboard render is a React Flow/JSON Render canvas from `open-projects`.
+- Provider failures are visible as bounded error/unavailable panels.
+- Sensitive content appears only as redacted summaries and ids.
+- The task has validation evidence and the served dashboard URL when requested.

package/skills/project-dashboard-reports/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "project-dashboard-reports",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Project dashboard and JSON Render reporting guidance for agent-managed Hasna projects",
+  "type": "module",
+  "bin": {
+    "project-dashboard-reports": "./src/index.ts"
+  },
+  "scripts": {
+    "dev": "bun run src/index.ts",
+    "build": "bun build src/index.ts --outdir dist --target node",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.7.0"
+  },
+  "files": [
+    "src",
+    "SKILL.md",
+    "tsconfig.json"
+  ]
+}

package/skills/project-dashboard-reports/src/index.ts

@@ -0,0 +1,67 @@
+#!/usr/bin/env bun
+
+type GuideSection = {
+  title: string;
+  items: string[];
+};
+
+const sections: GuideSection[] = [
+  {
+    title: "layout",
+    items: [
+      "Keep dashboard assets under .hasna/project/.",
+      "Use .hasna/project/dashboard/render.json as the render manifest.",
+      "Write snapshots under .hasna/project/dashboard/snapshots/.",
+      "Use iproj-<project-slug> for the conversation channel name.",
+    ],
+  },
+  {
+    title: "commands",
+    items: [
+      "projects dashboard snapshot <project> --write --json",
+      "projects dashboard render <project> --json",
+      "projects dashboard validate <project> --json",
+      "PROJECTS_DASHBOARD_TOKEN=<token> projects dashboard serve <project> --host 0.0.0.0 --port <port>",
+    ],
+  },
+  {
+    title: "provider-panels",
+    items: [
+      "todos project-panel --project <project> --json --contract",
+      "files project-panel --project <project> --json --contract",
+      "mailery status project-panel --project <project> --json --contract",
+      "conversations project-panel --project <project> --json --contract",
+      "knowledge project-panel --project <project> --json --contract",
+      "mementos --json project-panel --project <project> --contract",
+      "reports project-panel --project <project> --json --contract",
+    ],
+  },
+];
+
+function printHelp() {
+  console.log(`project-dashboard-reports
+
+Prints the Hasna project dashboard reporting checklist.
+
+Usage:
+  project-dashboard-reports [--json]
+
+The full agent-facing guidance lives in SKILL.md.`);
+}
+
+function printText() {
+  for (const section of sections) {
+    console.log(`${section.title}:`);
+    for (const item of section.items) {
+      console.log(`  - ${item}`);
+    }
+  }
+}
+
+if (Bun.argv.includes("--help") || Bun.argv.includes("-h")) {
+  printHelp();
+} else if (Bun.argv.includes("--json")) {
+  console.log(JSON.stringify({ skill: "project-dashboard-reports", sections }, null, 2));
+} else {
+  printText();
+}