@planu/cli 0.63.6 → 0.64.0

package/dist/types/a2a.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Status of an A2A delegated task lifecycle.
+ * Transitions: pending -> running -> completed | failed | cancelled
+ */
+export type A2ATaskStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+/**
+ * A skill advertised in an A2A capability card — describes what the agent can do.
+ */
+export interface A2ASkill {
+    /** Machine-readable skill identifier (e.g. "generate-tests", "create-spec"). */
+    id: string;
+    /** Human-readable name for the skill. */
+    name: string;
+    /** Short description of what the skill does. */
+    description: string;
+}
+/**
+ * A2A Capability Card — advertises Planu's identity and capabilities to other A2A agents.
+ * Based on the Linux Foundation AAIF Agent Capability Card format.
+ */
+export interface A2ACapabilityCard {
+    /** Unique agent identifier (e.g. "planu-sdd-agent"). */
+    agentId: string;
+    /** Human-readable agent name. */
+    name: string;
+    /** Semantic version of this agent instance. */
+    version: string;
+    /** Short description of what this agent specializes in. */
+    description: string;
+    /** Skills this agent exposes to other A2A agents. */
+    skills: A2ASkill[];
+    /** Spec types this agent can process (e.g. ["feature", "bugfix", "refactor"]). */
+    supportedSpecTypes: string[];
+    /** ISO 8601 timestamp when this card was registered. */
+    registeredAt: string;
+    /** Optional project ID this card is scoped to. */
+    projectId?: string;
+}
+/**
+ * An endpoint descriptor for an external A2A agent.
+ */
+export interface A2AAgentEndpoint {
+    /** Logical name for this agent endpoint (e.g. "testing-specialist"). */
+    name: string;
+    /** HTTP/HTTPS URL where the agent accepts A2A task requests. */
+    url: string;
+    /** Optional API key or auth token for the endpoint. */
+    authToken?: string;
+}
+/**
+ * Result returned after an A2A task completes (or fails).
+ */
+export interface A2ATaskResult {
+    /** Whether the task completed successfully. */
+    success: boolean;
+    /** Output produced by the agent (JSON-serializable). */
+    output?: unknown;
+    /** Error message if the task failed. */
+    error?: string;
+    /** Whether the result was produced locally, by a remote agent, or is only guidance (not executed). */
+    source: 'local' | 'remote' | 'guidance';
+    /** ISO 8601 timestamp of completion. */
+    completedAt: string;
+}
+/**
+ * A delegated task managed by A2ATaskManager.
+ */
+export interface A2ATask {
+    /** Unique task identifier. */
+    taskId: string;
+    /** Project this task belongs to. */
+    projectId: string;
+    /** Optional spec ID this task is associated with. */
+    specId?: string;
+    /** Natural-language description of the work to be done. */
+    taskDescription: string;
+    /** Current lifecycle status. */
+    status: A2ATaskStatus;
+    /** ISO 8601 creation timestamp. */
+    createdAt: string;
+    /** ISO 8601 timestamp of last status update. */
+    updatedAt: string;
+    /** Endpoint of the agent this task was delegated to, if any. */
+    targetEndpoint?: A2AAgentEndpoint;
+    /** Result populated when status reaches completed | failed. */
+    result?: A2ATaskResult;
+}
+/**
+ * A record of a delegation attempt — used for audit trail.
+ */
+export interface A2ADelegation {
+    /** ID of the task that was delegated. */
+    taskId: string;
+    /** Agent endpoint targeted for delegation. */
+    targetEndpoint?: A2AAgentEndpoint;
+    /** Delegation outcome. */
+    outcome: 'delegated' | 'fallback';
+    /** Reason for fallback when outcome is "fallback". */
+    fallbackReason?: string;
+    /** Result produced by the fallback handler (guidance or local execution). */
+    fallbackResult?: A2ATaskResult;
+    /** ISO 8601 timestamp. */
+    delegatedAt: string;
+}
+/** Input for the a2a_register MCP tool. */
+export interface A2ARegisterInput {
+    /** Project ID for scoping the capability card. */
+    projectId: string;
+    /** Optional custom name for this agent. Defaults to "Planu SDD Agent". */
+    name?: string;
+    /** Optional subset of skills to advertise. Defaults to all built-in skills. */
+    skills?: string[];
+}
+/** Input for the a2a_delegate MCP tool. */
+export interface A2ADelegateInput {
+    /** Project ID for task persistence. */
+    projectId: string;
+    /** Optional spec ID to associate with this delegation. */
+    specId?: string;
+    /** Natural-language description of the task to delegate. */
+    taskDescription: string;
+    /** Optional external agent endpoint URL. If omitted, falls back to local execution. */
+    agentEndpoint?: string;
+}
+//# sourceMappingURL=a2a.d.ts.map

package/dist/types/a2a.d.ts.map

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

package/dist/types/a2a.js

@@ -0,0 +1,3 @@
+// Planu — A2A (Agent-to-Agent) protocol types (SPEC-169)
+export {};
+//# sourceMappingURL=a2a.js.map

package/dist/types/a2a.js.map

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

package/dist/types/ac-gap.d.ts

@@ -0,0 +1,57 @@
+/** Category of a missing or incomplete acceptance criterion. */
+export type AcGapCategory = 'error-handling' | 'edge-cases' | 'security' | 'performance' | 'accessibility' | 'data-validation' | 'observability' | 'rollback';
+/** Priority of a suggested AC gap. */
+export type AcGapPriority = 'critical' | 'high' | 'medium' | 'low';
+/** A single suggested acceptance criterion that appears to be missing from the spec. */
+export interface AcGapSuggestion {
+    /** Short unique identifier within the report (e.g. "EH-01"). */
+    id: string;
+    /** Category this suggestion belongs to. */
+    category: AcGapCategory;
+    /** Priority level for addressing this gap. */
+    priority: AcGapPriority;
+    /** Human-readable description of the missing AC (in BDD-friendly wording). */
+    suggestion: string;
+    /** Reason why this AC is recommended for this spec. */
+    rationale: string;
+    /** Example BDD-style criterion text. */
+    example: string;
+}
+/** Complete report returned by the AC gap detector. */
+export interface AcGapReport {
+    /** Spec ID that was analyzed. */
+    specId: string;
+    /** Total number of existing ACs found in the spec. */
+    existingAcCount: number;
+    /** Suggested missing ACs. */
+    gaps: AcGapSuggestion[];
+    /** Coverage score 0–100: how complete the existing ACs appear to be. */
+    coverageScore: number;
+    /** ISO timestamp of when the analysis ran. */
+    analyzedAt: string;
+}
+/** A gap rule returns a suggestion when a gap is found, or null otherwise. */
+export type GapRule = (ctx: GapRuleContext) => AcGapSuggestion | null;
+/** Context passed to each AC gap rule so it can make an informed decision. */
+export interface GapRuleContext {
+    /** Combined text of the spec (spec.md + technical.md), already lower-cased. */
+    fullText: string;
+    /** Existing AC lines extracted from the spec. */
+    acLines: string[];
+    /** Whether this spec appears to have a web UI component. */
+    hasWebUi: boolean;
+    /** Counter for generating unique suggestion IDs. */
+    idCounter: {
+        value: number;
+    };
+}
+/** Arguments for the detect_ac_gaps tool. */
+export interface DetectAcGapsArgs {
+    projectId: string;
+    specId: string;
+    /** Optional categories to focus on. If omitted, all categories are checked. */
+    categories?: AcGapCategory[];
+    /** Minimum priority to include in the output (default: medium). */
+    minPriority?: AcGapPriority;
+}
+//# sourceMappingURL=ac-gap.d.ts.map

package/dist/types/ac-gap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ac-gap.d.ts","sourceRoot":"","sources":["../../src/types/ac-gap.ts"],"names":[],"mappings":"AAEA,gEAAgE;AAChE,MAAM,MAAM,aAAa,GACrB,gBAAgB,GAChB,YAAY,GACZ,UAAU,GACV,aAAa,GACb,eAAe,GACf,iBAAiB,GACjB,eAAe,GACf,UAAU,CAAC;AAEf,sCAAsC;AACtC,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEnE,wFAAwF;AACxF,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,QAAQ,EAAE,aAAa,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,EAAE,aAAa,CAAC;IACxB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,8EAA8E;AAC9E,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,cAAc,KAAK,eAAe,GAAG,IAAI,CAAC;AAEtE,8EAA8E;AAC9E,MAAM,WAAW,cAAc;IAC7B,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4DAA4D;IAC5D,QAAQ,EAAE,OAAO,CAAC;IAClB,oDAAoD;IACpD,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B;AAED,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,mEAAmE;IACnE,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B"}

package/dist/types/ac-gap.js

@@ -0,0 +1,3 @@
+// types/ac-gap.ts — Types for the AC gap detection domain (SPEC-156)
+export {};
+//# sourceMappingURL=ac-gap.js.map

package/dist/types/ac-gap.js.map

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

package/dist/types/audit-trail.d.ts

@@ -0,0 +1,77 @@
+/** All spec lifecycle and tool event types captured in the audit log. */
+export type AuditEventType = 'spec.created' | 'spec.updated' | 'spec.status_changed' | 'spec.approved' | 'spec.drift_detected' | 'spec.reconciled' | 'tool.called' | 'role.assigned';
+/** A single immutable audit log entry. */
+export interface AuditEvent {
+    /** Unique identifier for this event (UUID-like). */
+    id: string;
+    /** ISO-8601 timestamp. */
+    timestamp: string;
+    /** Classification of what happened. */
+    eventType: AuditEventType;
+    /** Optional: which spec this event relates to. */
+    specId?: string;
+    /** Optional: who performed the action (user/agent identifier). */
+    userId?: string;
+    /** Short verb describing the action (e.g., "created", "status changed to approved"). */
+    action: string;
+    /** Arbitrary additional context (change summary, metadata, etc.). */
+    details: Record<string, unknown>;
+    /** SHA-256 hash of the previous JSONL line (hex). Empty string for first entry. */
+    previousHash: string;
+    /** SHA-256 hash of this entry's canonical JSON (excluding this field itself). */
+    hash: string;
+}
+/** Input filter for querying the audit log. */
+export interface AuditQuery {
+    projectId: string;
+    specId?: string;
+    userId?: string;
+    eventType?: AuditEventType;
+    from?: string;
+    to?: string;
+    limit?: number;
+}
+/** Result of an audit log query. */
+export interface AuditQueryResult {
+    events: AuditEvent[];
+    total: number;
+    truncated: boolean;
+}
+/** Payload passed to appendEvent (excludes hash chain fields). */
+export interface AppendEventInput {
+    eventType: AuditEventType;
+    specId?: string;
+    userId?: string;
+    action: string;
+    details?: Record<string, unknown>;
+}
+/** Result of verifying SHA-256 chain integrity. */
+export interface ChainVerificationResult {
+    valid: boolean;
+    totalEntries: number;
+    firstBrokenAt?: number;
+    message: string;
+}
+/** Input for audit_trail tool — alias for AuditQuery for tool-handler consumers. */
+export type AuditTrailInput = AuditQuery;
+/** Input for generate_attestation tool. */
+export interface GenerateAttestationInput {
+    projectId: string;
+    specId: string;
+}
+/** Structured attestation document (SPEC-167 — JSON, not actual PDF). */
+export interface AttestationData {
+    attestationId: string;
+    generatedAt: string;
+    projectId: string;
+    specId: string;
+    events: AuditEvent[];
+    chainValid: boolean;
+    summary: {
+        totalEvents: number;
+        firstEvent?: string;
+        lastEvent?: string;
+        eventTypes: Partial<Record<AuditEventType, number>>;
+    };
+}
+//# sourceMappingURL=audit-trail.d.ts.map

package/dist/types/audit-trail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-trail.d.ts","sourceRoot":"","sources":["../../src/types/audit-trail.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,cAAc,GACd,qBAAqB,GACrB,eAAe,GACf,qBAAqB,GACrB,iBAAiB,GACjB,aAAa,GACb,eAAe,CAAC;AAEpB,0CAA0C;AAC1C,MAAM,WAAW,UAAU;IACzB,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,SAAS,EAAE,cAAc,CAAC;IAC1B,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,mFAAmF;IACnF,YAAY,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+CAA+C;AAC/C,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,oCAAoC;AACpC,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,cAAc,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,mDAAmD;AACnD,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oFAAoF;AACpF,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC;AAEzC,2CAA2C;AAC3C,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;KACrD,CAAC;CACH"}

package/dist/types/audit-trail.js

@@ -0,0 +1,3 @@
+// types/audit-trail.ts — Audit trail domain types (SPEC-167)
+export {};
+//# sourceMappingURL=audit-trail.js.map

package/dist/types/audit-trail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-trail.js","sourceRoot":"","sources":["../../src/types/audit-trail.ts"],"names":[],"mappings":"AAAA,6DAA6D"}

package/dist/types/auth.d.ts

@@ -0,0 +1,82 @@
+/** OAuth 2.1 provider configuration (persisted to data/global/auth-config.json). */
+export interface AuthConfig {
+    /** OAuth 2.1 client ID registered with the provider. */
+    clientId: string;
+    /** Authorization endpoint URL (PKCE flow). */
+    authorizationUrl: string;
+    /** Token endpoint URL. */
+    tokenUrl: string;
+    /** Introspection endpoint URL (optional — used for opaque tokens). */
+    introspectionUrl?: string;
+    /** JWKS endpoint URL (optional — used for JWT validation). */
+    jwksUrl?: string;
+    /** Scopes requested at authorization time. */
+    scopes: string[];
+    /** Mapping of OAuth scope → list of tool names accessible. */
+    scopeMappings: Record<string, string[]>;
+    /** ISO 8601 timestamp when this config was last updated. */
+    updatedAt: string;
+}
+/** Result of validating an access token. */
+export interface TokenValidationResult {
+    /** Whether the token is valid and active. */
+    valid: boolean;
+    /** Subject identifier (user/client ID) from the token. */
+    subject?: string;
+    /** Scopes granted by this token. */
+    scopes: string[];
+    /** Unix timestamp (seconds) when the token expires. */
+    expiresAt?: number;
+    /** Reason for rejection (present when valid is false). */
+    reason?: string;
+}
+/** A single OAuth scope definition. */
+export interface OAuthScope {
+    /** Scope string as sent to the provider (e.g. "planu:write"). */
+    name: string;
+    /** Human-readable description of what this scope grants. */
+    description: string;
+}
+/** Maps an OAuth scope to a set of tool names. */
+export interface ScopeMapping {
+    /** The OAuth scope string. */
+    scope: string;
+    /** Tool names accessible when this scope is granted. */
+    tools: string[];
+}
+/** Input for the configure_auth tool. */
+export interface ConfigureAuthInput {
+    /** OAuth 2.1 client ID. */
+    clientId: string;
+    /** Authorization endpoint URL. */
+    authorizationUrl: string;
+    /** Token endpoint URL. */
+    tokenUrl: string;
+    /** Introspection endpoint URL (for opaque tokens). */
+    introspectionUrl?: string;
+    /** JWKS URI (for JWT validation). */
+    jwksUrl?: string;
+    /** Scopes to request. */
+    scopes: string[];
+    /** Optional scope → tools mapping. */
+    scopeMappings?: Record<string, string[]>;
+}
+/** Generated PKCE challenge parameters. */
+export interface PkceChallenge {
+    /** The code verifier (random secret, kept by client). */
+    codeVerifier: string;
+    /** The code challenge (S256 = BASE64URL(SHA-256(verifier))). */
+    codeChallenge: string;
+    /** Always "S256" for OAuth 2.1 compliance. */
+    codeChallengeMethod: 'S256';
+}
+/** Auth middleware context passed through the request pipeline. */
+export interface AuthContext {
+    /** Whether auth is configured and enforced. */
+    enabled: boolean;
+    /** Token validation result (present when a Bearer token was provided). */
+    validation?: TokenValidationResult;
+    /** Tool names the caller is authorized to use (empty = all allowed). */
+    allowedTools: string[];
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/types/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/types/auth.ts"],"names":[],"mappings":"AAEA,oFAAoF;AACpF,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,CAAC;IACzB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,4CAA4C;AAC5C,MAAM,WAAW,qBAAqB;IACpC,6CAA6C;IAC7C,KAAK,EAAE,OAAO,CAAC;IACf,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,uCAAuC;AACvC,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC1C;AAED,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,wEAAwE;IACxE,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB"}

package/dist/types/auth.js

@@ -0,0 +1,3 @@
+// types/auth.ts — OAuth 2.1 authentication domain types (SPEC-161)
+export {};
+//# sourceMappingURL=auth.js.map

package/dist/types/auth.js.map

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

package/dist/types/ci.d.ts

@@ -8,31 +8,6 @@ export type JavaBuildTool = 'maven' | 'gradle';
 export type CIJobType = 'lint' | 'test' | 'build' | 'deploy';
 /** GitHub Actions trigger events */
 export type CITriggerEvent = 'push' | 'pull_request' | 'workflow_dispatch' | 'schedule';
-/** Node.js version specifier for matrix or single version */
-export interface NodeVersionConfig {
-    version: string;
-    useMatrix: boolean;
-    matrixVersions?: string[];
-}
-/** Python version specifier */
-export interface PythonVersionConfig {
-    version: string;
-    useMatrix: boolean;
-    matrixVersions?: string[];
-}
-/** Go version specifier */
-export interface GoVersionConfig {
-    version: string;
-}
-/** Rust toolchain specifier */
-export interface RustToolchainConfig {
-    channel: 'stable' | 'beta' | 'nightly';
-}
-/** Java version specifier */
-export interface JavaVersionConfig {
-    version: string;
-    distribution: 'temurin' | 'zulu' | 'corretto' | 'microsoft';
-}
 /** Cache configuration for a CI job */
 export interface CICacheConfig {
     enabled: boolean;
@@ -42,6 +17,7 @@ export interface CICacheConfig {
 /** A single step in a CI job */
 export interface CIStep {
     name: string;
+    id?: string;
     uses?: string;
     run?: string;
     with?: Record<string, string | number | boolean>;
@@ -88,6 +64,7 @@ export interface GenerateCIResult {
     yamlContent: string;
     jobs: CIJobType[];
     stackContext: CIStackContext;
+    driftStepIncluded: boolean;
 }
 /** Input arguments for the generate_ci tool */
 export interface GenerateCIInput {
@@ -101,6 +78,9 @@ export interface GenerateCIInput {
     rustChannel?: 'stable' | 'beta' | 'nightly';
     javaVersion?: string;
     workflowName?: string;
+    includeDriftStep?: boolean;
+    specsDir?: string;
+    driftSeverityThreshold?: CISeverityThreshold;
 }
 /** Severity threshold for drift detection in CI */
 export type CISeverityThreshold = 'critical' | 'warning' | 'info';
@@ -142,6 +122,11 @@ export interface GeneratePlanuCIResult {
 }
 /** Features included in the generated planu CI workflow */
 export type PlanuCIFeature = 'validate' | 'detect-drift' | 'pr-comment' | 'fail-on-drift' | 'badge' | 'planu-config';
+/** Options for including a Planu drift detection job in the workflow. */
+export interface DriftJobOptions {
+    specsDir: string;
+    threshold: CISeverityThreshold;
+}
 /** Options for generating a .planu.yml config file */
 export interface PlanuConfigOptions {
     specsDir: string;

package/dist/types/ci.d.ts.map

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

package/dist/types/design-to-spec.d.ts

@@ -0,0 +1,89 @@
+/** Platform target for the design being analyzed */
+export type DesignPlatform = 'web' | 'mobile' | 'desktop';
+/** Responsive breakpoint definition */
+export interface DesignBreakpoint {
+    name: string;
+    minWidth: number;
+    maxWidth?: number;
+    description: string;
+}
+/** A single interaction state for a component */
+export interface DesignInteractionState {
+    name: string;
+    trigger: string;
+    visualChange: string;
+    dataChange?: string;
+}
+/** A UI component extracted from a design description */
+export interface DesignComponent {
+    id: string;
+    name: string;
+    type: 'container' | 'form' | 'button' | 'input' | 'list' | 'modal' | 'nav' | 'card' | 'text' | 'image' | 'other';
+    description: string;
+    props: DesignComponentProp[];
+    interactionStates: DesignInteractionState[];
+    a11yRequirements: string[];
+    children: DesignComponent[];
+}
+/** A prop/attribute of a design component */
+export interface DesignComponentProp {
+    name: string;
+    type: string;
+    required: boolean;
+    description: string;
+    exampleValue?: string;
+}
+/** A screen/view parsed from the design description */
+export interface DesignScreen {
+    id: string;
+    name: string;
+    description: string;
+    route?: string;
+    components: DesignComponent[];
+    breakpoints: DesignBreakpoint[];
+    acceptanceCriteria: string[];
+    a11yRequirements: string[];
+    dataBindings: DesignDataBinding[];
+}
+/** Represents a data binding between UI and data source */
+export interface DesignDataBinding {
+    componentId: string;
+    dataSource: string;
+    fieldMapping: string;
+    loadingState?: string;
+    errorState?: string;
+}
+/** Input arguments for the design_to_spec tool */
+export interface DesignToSpecArgs {
+    projectId: string;
+    designDescription: string;
+    screens?: string[];
+    platform?: DesignPlatform;
+    includeA11y?: boolean;
+}
+/** Parsed intermediate representation of the design */
+export interface ParsedDesign {
+    title: string;
+    platform: DesignPlatform;
+    screens: DesignScreen[];
+    globalComponents: DesignComponent[];
+    designTokens: DesignToken[];
+}
+/** A design token (color, spacing, typography) */
+export interface DesignToken {
+    name: string;
+    category: 'color' | 'spacing' | 'typography' | 'shadow' | 'border' | 'other';
+    value: string;
+    description?: string;
+}
+/** The generated spec content from design analysis */
+export interface DesignToSpecResult {
+    specMarkdown: string;
+    screens: DesignScreen[];
+    uiContractMarkdown: string;
+    acceptanceCriteria: string[];
+    a11yRequirements: string[];
+    breakpoints: DesignBreakpoint[];
+    generatedAt: string;
+}
+//# sourceMappingURL=design-to-spec.d.ts.map

package/dist/types/design-to-spec.d.ts.map

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

package/dist/types/design-to-spec.js

@@ -0,0 +1,3 @@
+// types/design-to-spec.ts — Domain types for design-to-spec generation (SPEC-159)
+export {};
+//# sourceMappingURL=design-to-spec.js.map

package/dist/types/design-to-spec.js.map

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