@planu/cli 0.63.6 → 0.64.0

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

@@ -0,0 +1,117 @@
+/** A tagged version snapshot of a spec (git-like versioning). */
+export interface SpecVersionSnapshot {
+    /** Semantic version tag, e.g. "v1.0.0", "v1.1.0" */
+    tag: string;
+    /** ISO 8601 timestamp when the snapshot was created */
+    timestamp: string;
+    /** Full spec content at time of snapshot */
+    content: string;
+    /** Optional human-readable message describing this version */
+    message?: string;
+    /** Optional author identifier */
+    author?: string;
+}
+/** Storage structure for all snapshots of a spec. */
+export interface SpecVersionSnapshotStore {
+    specId: string;
+    versions: SpecVersionSnapshot[];
+}
+/** A spec branch for experimental changes. */
+export interface SpecBranch {
+    /** Branch name (kebab-case) */
+    name: string;
+    /** The spec ID this branch belongs to */
+    specId: string;
+    /** ISO 8601 timestamp when the branch was created */
+    createdAt: string;
+    /** Version tag from which this branch was created */
+    fromVersion: string;
+    /** Full spec content on this branch */
+    content: string;
+}
+/** Diff result between two spec versions at AC-level granularity. */
+export interface SpecVersionDiff {
+    fromTag: string;
+    toTag: string;
+    specId: string;
+    /** Lines added in the "to" version */
+    added: string[];
+    /** Lines removed compared to "from" version */
+    removed: string[];
+    /** Acceptance criteria that changed (AC-level granularity) */
+    criteriaChanges: {
+        added: string[];
+        removed: string[];
+        modified: {
+            before: string;
+            after: string;
+        }[];
+    };
+    /** Summary of sections that changed */
+    sectionChanges: string[];
+}
+/** Conflict detected when merging a branch back into main. */
+export interface SpecMergeConflict {
+    type: 'content_diverged' | 'concurrent_edit';
+    description: string;
+    /** The conflicting lines or sections */
+    details: string[];
+}
+/** Result of a merge operation. */
+export interface SpecMergeResult {
+    success: boolean;
+    specId: string;
+    branchName: string;
+    newVersionTag?: string;
+    conflicts: SpecMergeConflict[];
+    message: string;
+}
+/** Input options for creating a spec version snapshot. */
+export interface CreateVersionSnapshotInput {
+    projectId: string;
+    specId: string;
+    tag: string;
+    content: string;
+    message?: string;
+    author?: string;
+}
+/** Input options for creating a spec branch. */
+export interface CreateSpecBranchInput {
+    projectId: string;
+    specId: string;
+    branchName: string;
+    fromVersion?: string;
+    content: string;
+}
+/** Input options for merging a spec branch. */
+export interface MergeSpecBranchInput {
+    projectId: string;
+    specId: string;
+    branchName: string;
+    /** Optional merged spec content (if pre-resolved). If absent, auto-merge is attempted. */
+    resolvedContent?: string;
+    newVersionTag?: string;
+    message?: string;
+}
+/** Input for the branch_spec tool. */
+export interface BranchSpecInput {
+    projectId: string;
+    specId: string;
+    branchName: string;
+    fromVersion?: string;
+    /** Path to the spec file to read content from */
+    specPath?: string;
+}
+/** Input for the version_spec tool. */
+export interface VersionSpecInput {
+    projectId: string;
+    specId: string;
+    tag?: string;
+    message?: string;
+    author?: string;
+    /** Absolute path to the spec's spec.md file. */
+    specPath?: string;
+}
+/** Input for the merge_spec_branch tool handler — alias for MergeSpecBranchInput. */
+export type MergeSpecBranchHandlerInput = MergeSpecBranchInput;
+//# sourceMappingURL=spec-versioning.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec-versioning.d.ts","sourceRoot":"","sources":["../../src/types/spec-versioning.ts"],"names":[],"mappings":"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"}

package/dist/types/spec-versioning.js

@@ -0,0 +1,3 @@
+// types/spec-versioning.ts — Types for spec versioning and branching (SPEC-168)
+export {};
+//# sourceMappingURL=spec-versioning.js.map

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

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

package/dist/types/well-known.d.ts

@@ -0,0 +1,70 @@
+import type { Spec } from './spec/core.js';
+/** Summary of a single spec included in the .well-known manifest. */
+export interface ManifestSpec {
+    /** Spec ID (e.g. "SPEC-001"). */
+    id: string;
+    /** Human-readable title. */
+    title: string;
+    /** Spec status. */
+    status: string;
+    /** Spec type (feature, bug, chore, etc.). */
+    type: string;
+    /** Short description (up to 200 characters). */
+    description: string;
+    /** Tags associated with the spec. */
+    tags: string[];
+    /** ISO 8601 creation date. */
+    created: string;
+}
+/** .well-known/planu.json manifest format v1. */
+export interface WellKnownManifest {
+    /** Manifest schema version. Always 1 for this format. */
+    version: 1;
+    /** Project display name. */
+    name: string;
+    /** Total number of specs included. */
+    specCount: number;
+    /** Spec summaries (public specs only, unless includePrivate=true). */
+    specs: ManifestSpec[];
+    /** Planu capabilities exported by this project. */
+    capabilities: string[];
+    /** ISO 8601 timestamp when this manifest was generated. */
+    generatedAt: string;
+}
+/** Input for the publish_registry tool handler. */
+export interface PublishRegistryInput {
+    /** Project ID (hash). */
+    projectId: string;
+    /** Absolute path where .well-known/planu.json will be written. */
+    outputPath?: string;
+    /** Whether to include specs with status "private". Default: false. */
+    includePrivate?: boolean;
+}
+/** Input for the discover_registry tool handler. */
+export interface DiscoverRegistryInput {
+    /** Absolute path to a .well-known/planu.json manifest file. */
+    manifestPath: string;
+}
+/** Options for generating a manifest. */
+export interface ManifestGeneratorOptions {
+    /** Project display name. */
+    projectName: string;
+    /** List of all specs for the project. */
+    specs: Spec[];
+    /** Whether to include specs with a private or draft status. */
+    includePrivate: boolean;
+}
+/** A capability identifier that a project can declare in its manifest. */
+export type KnownCapability = 'spec-registry' | 'federation' | 'living-spec' | 'ai-analysis' | 'estimation' | 'changelog';
+/** Result of parsing and validating a manifest. */
+export interface DiscoveryResult {
+    /** Whether the manifest was successfully parsed and validated. */
+    valid: boolean;
+    /** Parsed manifest (present when valid is true). */
+    manifest?: WellKnownManifest;
+    /** Validation errors (present when valid is false). */
+    errors?: string[];
+    /** Source path of the manifest. */
+    source: string;
+}
+//# sourceMappingURL=well-known.d.ts.map

package/dist/types/well-known.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"well-known.d.ts","sourceRoot":"","sources":["../../src/types/well-known.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,OAAO,EAAE,CAAC,CAAC;IACX,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,mDAAmD;IACnD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,mDAAmD;AACnD,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,oDAAoD;AACpD,MAAM,WAAW,qBAAqB;IACpC,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,yCAAyC;AACzC,MAAM,WAAW,wBAAwB;IACvC,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,+DAA+D;IAC/D,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,0EAA0E;AAC1E,MAAM,MAAM,eAAe,GACvB,eAAe,GACf,YAAY,GACZ,aAAa,GACb,aAAa,GACb,YAAY,GACZ,WAAW,CAAC;AAEhB,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,KAAK,EAAE,OAAO,CAAC;IACf,oDAAoD;IACpD,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/well-known.js

@@ -0,0 +1,3 @@
+// types/well-known.ts — SPEC-162: .well-known spec-registry discovery domain types
+export {};
+//# sourceMappingURL=well-known.js.map

package/dist/types/well-known.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"well-known.js","sourceRoot":"","sources":["../../src/types/well-known.ts"],"names":[],"mappings":"AAAA,mFAAmF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "0.63.6",
+  "version": "0.64.0",
   "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

@@ -122,10 +122,13 @@
     "export_session",
     "security_report",
     "configure_workers",
+    "configure_roles",
+    "assign_role",
     "orchestrate_runtime",
     "agent_swarm_status",
     "configure_llm_providers",
     "llm_provider_status",
+    "configure_observability",
     "manage_plugins",
     "scaffold_plugin",
     "create_pr_from_spec",
@@ -155,7 +158,19 @@
     "registry_logout",
     "registry_whoami",
     "scan_project",
-    "ecosystem_status"
+    "ecosystem_status",
+    "audit_trail",
+    "generate_attestation",
+    "branch_spec",
+    "merge_spec_branch",
+    "version_spec",
+    "decompose_spec",
+    "federate_specs",
+    "federation_status",
+    "discover_registry",
+    "publish_registry",
+    "generate_infrastructure",
+    "spec_usage_report"
   ],
   "alwaysAllowed": [
     "activate_license",