@planu/cli 0.44.0 → 0.45.1

package/dist/types/spec-registry.d.ts

@@ -0,0 +1,194 @@
+/** Metadata for a published spec in the registry. */
+export interface RegistrySpecMeta {
+    /** Unique name in org/name format. */
+    name: string;
+    /** Organization or user that published the spec. */
+    org: string;
+    /** Semver version string. */
+    version: string;
+    /** Short description of what the spec does. */
+    description: string;
+    /** Category ID from registry-categories.json. */
+    category: string;
+    /** Technology stack tags (e.g. ["next.js", "prisma"]). */
+    stack: string[];
+    /** Difficulty level 1-5. */
+    difficulty: number;
+    /** Estimated implementation hours. */
+    estimatedHours: number;
+    /** Searchable tags. */
+    tags: string[];
+    /** Total download count. */
+    downloads: number;
+    /** Average rating (0-5). */
+    rating: number;
+    /** Number of ratings received. */
+    ratingCount: number;
+    /** ISO 8601 creation timestamp. */
+    createdAt: string;
+    /** ISO 8601 last update timestamp. */
+    updatedAt: string;
+    /** Whether this spec is deprecated. */
+    deprecated?: boolean;
+    /** Message explaining why the spec was deprecated. */
+    deprecationMessage?: string;
+}
+/** A single item in search results, extends meta with completeness score. */
+export interface RegistrySearchItem extends RegistrySpecMeta {
+    /** Completeness score 0-100 based on spec quality metrics. */
+    completenessScore: number;
+}
+/** Paginated search result from the registry. */
+export interface RegistrySearchResult {
+    /** Array of matching specs. */
+    data: RegistrySearchItem[];
+    /** Pagination metadata. */
+    meta: {
+        page: number;
+        limit: number;
+        total: number;
+    };
+}
+/** Result of installing a spec from the registry. */
+export interface RegistryInstallResult {
+    /** Local spec ID assigned after install. */
+    specId: string;
+    /** Slug used for the local spec directory. */
+    slug: string;
+    /** Absolute path to the installed spec directory. */
+    specDir: string;
+    /** Source identifier (org/name). */
+    source: string;
+    /** Installed version. */
+    version: string;
+    /** Whether stack adaptation was applied. */
+    adapted: boolean;
+}
+/** Result of publishing a spec to the registry. */
+export interface RegistryPublishResult {
+    /** Whether the publish succeeded. */
+    success: boolean;
+    /** Organization the spec was published under. */
+    org: string;
+    /** Spec name in the registry. */
+    name: string;
+    /** Published version. */
+    version: string;
+    /** URL to view the published spec. */
+    url: string;
+}
+/** Stored credentials for registry authentication. */
+export interface RegistryCredentials {
+    /** API token for registry access. */
+    token: string;
+    /** Username associated with the token. */
+    user: string;
+    /** Email associated with the account. */
+    email: string;
+    /** License plan level. */
+    plan: 'free' | 'pro';
+    /** ISO 8601 token expiration timestamp. */
+    expiresAt: string;
+}
+/** Shape of the planu-registry.json manifest file included in published specs. */
+export interface RegistryPackageManifest {
+    /** Spec name (without org prefix). */
+    name: string;
+    /** Organization or user. */
+    org: string;
+    /** Semver version. */
+    version: string;
+    /** Short description. */
+    description: string;
+    /** Category ID. */
+    category: string;
+    /** Technology stack tags. */
+    stack: string[];
+    /** Difficulty level 1-5. */
+    difficulty: number;
+    /** Estimated implementation hours. */
+    estimatedHours: number;
+    /** Searchable tags. */
+    tags: string[];
+    /** Stack-specific adaptations: { marker: { targetValue: replacement } }. */
+    adaptable?: Record<string, Record<string, string>>;
+}
+/** Filters for searching the registry. */
+export interface RegistrySearchFilters {
+    /** Free-text search query. */
+    query?: string;
+    /** Filter by stack (e.g. "next.js"). */
+    stack?: string;
+    /** Filter by category ID. */
+    category?: string;
+    /** Filter by difficulty range. */
+    difficulty?: {
+        min?: number;
+        max?: number;
+    };
+    /** Sort order for results. */
+    sort?: 'downloads' | 'rating' | 'recent';
+    /** Page number (1-based). */
+    page?: number;
+    /** Results per page. */
+    limit?: number;
+}
+/** Result of detecting the project's technology stack. */
+export interface StackDetectionResult {
+    /** Primary programming language. */
+    language: string;
+    /** Primary framework. */
+    framework: string;
+    /** ORM or database library, if detected. */
+    orm?: string;
+    /** Test runner, if detected. */
+    testRunner?: string;
+    /** Build tool, if detected. */
+    buildTool?: string;
+    /** Package manager, if detected. */
+    packageManager?: string;
+}
+/** Options for creating a registry API client. */
+export interface RegistryClientOptions {
+    token?: string;
+    baseUrl?: string;
+}
+/** Registry API client interface returned by createRegistryClient. */
+export interface RegistryClient {
+    searchSpecs(filters: RegistrySearchFilters): Promise<RegistrySearchResult>;
+    getSpec(org: string, name: string, version?: string): Promise<RegistrySpecMeta>;
+    downloadSpec(org: string, name: string, version: string): Promise<Buffer>;
+    publishSpec(tarball: Buffer, meta: Record<string, unknown>): Promise<RegistryPublishResult>;
+    rateSpec(org: string, name: string, rating: number): Promise<void>;
+}
+/** Internal archive format: JSON with file contents keyed by relative path. */
+export interface SpecArchive {
+    files: Record<string, string>;
+}
+/** A single file adaptation applied during spec install. */
+export interface StackAdaptation {
+    /** File path relative to spec directory. */
+    file: string;
+    /** Original content before adaptation. */
+    original: string;
+    /** Adapted content after stack replacement. */
+    adapted: string;
+    /** Adaptation marker that was matched. */
+    marker?: string;
+}
+/** Breakdown of a spec's completeness score by category. */
+export interface ScoreBreakdown {
+    /** Score for acceptance criteria (0-20). */
+    acceptanceCriteria: number;
+    /** Score for risk documentation (0-15). */
+    risksDocumented: number;
+    /** Score for testing strategy (0-15). */
+    testingStrategy: number;
+    /** Score for key files listing (0-15). */
+    keyFiles: number;
+    /** Score for technical.md completeness (0-20). */
+    technicalCompleteness: number;
+    /** Score for frontmatter fields (0-15). */
+    frontmatterFields: number;
+}
+//# sourceMappingURL=spec-registry.d.ts.map

package/dist/types/spec-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-registry.d.ts","sourceRoot":"","sources":["../../src/types/spec-registry.ts"],"names":[],"mappings":"AAEA,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,6EAA6E;AAC7E,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,8DAA8D;IAC9D,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAC3B,2BAA2B;IAC3B,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,mDAAmD;AACnD,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,sDAAsD;AACtD,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kFAAkF;AAClF,MAAM,WAAW,uBAAuB;IACtC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD;AAED,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACpC,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,UAAU,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,8BAA8B;IAC9B,IAAI,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACzC,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,kDAAkD;AAClD,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC3E,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChF,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1E,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC5F,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE;AAED,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,2CAA2C;IAC3C,iBAAiB,EAAE,MAAM,CAAC;CAC3B"}

package/dist/types/spec-registry.js

@@ -0,0 +1,3 @@
+// types/spec-registry.ts — SPEC-127: Spec Registry (marketplace) domain types
+export {};
+//# sourceMappingURL=spec-registry.js.map

package/dist/types/spec-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-registry.js","sourceRoot":"","sources":["../../src/types/spec-registry.ts"],"names":[],"mappings":"AAAA,8EAA8E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "0.44.0",
+  "version": "0.45.1",
   "description": "Planu — MCP Server for Spec Driven Development. Manages specs, estimations, reverse engineering, and auto-learning across any language/framework.",
   "type": "module",
   "main": "dist/index.js",

package/src/config/license-plans.json

@@ -47,7 +47,9 @@
     "manage_trash",
     "worker_status",
     "token_usage",
-    "pr_status"
+    "pr_status",
+    "registry_search",
+    "registry_install"
   ],
   "proTools": [
     "audit",
@@ -140,7 +142,11 @@
     "living_spec_coverage",
     "sync_spec_to_code",
     "sync_code_to_spec",
-    "resolve_sync_conflict"
+    "resolve_sync_conflict",
+    "registry_publish",
+    "registry_login",
+    "registry_logout",
+    "registry_whoami"
   ],
   "alwaysAllowed": [
     "activate_license",

package/src/config/registry-categories.json

@@ -0,0 +1,20 @@
+[
+  { "id": "auth", "label": "Authentication", "description": "Login, signup, OAuth, SSO, session management" },
+  { "id": "payments", "label": "Payments", "description": "Stripe, PayPal, billing, subscriptions, invoicing" },
+  { "id": "crud", "label": "CRUD", "description": "Create-read-update-delete resource management" },
+  { "id": "api", "label": "API Design", "description": "REST, GraphQL, tRPC, API gateway patterns" },
+  { "id": "database", "label": "Database", "description": "Schema design, migrations, seeding, indexing" },
+  { "id": "testing", "label": "Testing", "description": "Unit, integration, E2E, load testing strategies" },
+  { "id": "ci-cd", "label": "CI/CD", "description": "Continuous integration, deployment pipelines" },
+  { "id": "deployment", "label": "Deployment", "description": "Docker, Kubernetes, serverless, platform configs" },
+  { "id": "monitoring", "label": "Monitoring", "description": "Logging, alerting, APM, health checks" },
+  { "id": "notifications", "label": "Notifications", "description": "Email, push, SMS, in-app notification systems" },
+  { "id": "file-upload", "label": "File Upload", "description": "Upload, storage, CDN, image processing" },
+  { "id": "search", "label": "Search", "description": "Full-text search, Elasticsearch, Algolia, filters" },
+  { "id": "caching", "label": "Caching", "description": "Redis, Memcached, CDN caching, invalidation" },
+  { "id": "i18n", "label": "Internationalization", "description": "Multi-language support, locale management" },
+  { "id": "seo", "label": "SEO", "description": "Meta tags, sitemap, structured data, Open Graph" },
+  { "id": "analytics", "label": "Analytics", "description": "Event tracking, dashboards, user analytics" },
+  { "id": "security", "label": "Security", "description": "CSRF, XSS prevention, rate limiting, RBAC" },
+  { "id": "performance", "label": "Performance", "description": "Optimization, lazy loading, bundle analysis" }
+]

package/src/config/registry-stacks.json

@@ -0,0 +1,16 @@
+[
+  { "id": "next.js", "label": "Next.js", "ecosystem": "typescript" },
+  { "id": "express", "label": "Express", "ecosystem": "typescript" },
+  { "id": "fastapi", "label": "FastAPI", "ecosystem": "python" },
+  { "id": "django", "label": "Django", "ecosystem": "python" },
+  { "id": "rails", "label": "Ruby on Rails", "ecosystem": "ruby" },
+  { "id": "spring-boot", "label": "Spring Boot", "ecosystem": "java" },
+  { "id": "laravel", "label": "Laravel", "ecosystem": "php" },
+  { "id": "gin", "label": "Gin", "ecosystem": "go" },
+  { "id": "actix-web", "label": "Actix Web", "ecosystem": "rust" },
+  { "id": "phoenix", "label": "Phoenix", "ecosystem": "elixir" },
+  { "id": "sveltekit", "label": "SvelteKit", "ecosystem": "typescript" },
+  { "id": "nuxt", "label": "Nuxt", "ecosystem": "typescript" },
+  { "id": "remix", "label": "Remix", "ecosystem": "typescript" },
+  { "id": "astro", "label": "Astro", "ecosystem": "typescript" }
+]