@kynetic-ai/spec 0.1.0

package/dist/strings/errors.js

@@ -0,0 +1,282 @@
+/**
+ * Centralized error messages for CLI commands
+ *
+ * Organizes error messages by category to improve maintainability and consistency.
+ * Each category corresponds to a common error pattern across command files.
+ */
+/**
+ * Reference resolution errors (not found, ambiguous, wrong type)
+ */
+export const referenceErrors = {
+    // Not found
+    itemNotFound: (ref) => `Item not found: ${ref}`,
+    taskNotFound: (ref) => `Task not found: ${ref}`,
+    specNotFound: (ref) => `Spec item not found: ${ref}`,
+    metaNotFound: (ref) => `Meta item not found: ${ref}`,
+    inboxNotFound: (ref) => `Inbox item not found: ${ref}`,
+    observationNotFound: (ref) => `Observation not found: ${ref}`,
+    depNotFound: (ref) => `Dependency reference not found: ${ref}`,
+    acNotFound: (acId, itemRef) => `Acceptance criterion "${acId}" not found on @${itemRef}`,
+    // Ambiguous references
+    ambiguous: (ref) => `Reference "${ref}" is ambiguous. Matches:`,
+    slugMapsToMultiple: (ref) => `Slug "${ref}" maps to multiple items. Use ULID instead:`,
+    // Wrong type
+    notTask: (ref) => `Reference "${ref}" is not a task (it's a spec item)`,
+    notItem: (ref) => `"${ref}" is a task, not a spec item. Use 'kspec task get' instead.`,
+    taskUseTaskCommands: (ref) => `"${ref}" is a task. Use 'kspec task' commands instead.`,
+    itemUseTaskCancel: (ref) => `"${ref}" is a task. Use 'kspec task cancel' instead.`,
+    parentIsTask: (ref) => `"${ref}" is a task. Items can only be added under spec items.`,
+    notSpecItem: (ref) => `Reference "${ref}" is a task, not a spec item. Derive only works on spec items.`,
+    // Meta reference errors
+    metaRefNotFound: (ref) => `meta_ref '${ref}' not found`,
+    metaRefPointsToSpec: (ref) => `meta_ref '${ref}' points to a spec item; use --spec-ref for product spec references`,
+    // Spec reference errors
+    specRefNotFound: (ref) => `Spec reference not found: ${ref}`,
+    specRefIsTask: (ref) => `Reference "${ref}" is a task, not a spec item`,
+    // Reference not found (generic)
+    refNotFound: (ref) => `Reference not found: ${ref}`,
+};
+/**
+ * Slug validation errors
+ */
+export const slugErrors = {
+    alreadyExists: (slug, existingUlid) => `Slug '${slug}' already exists (used by ${existingUlid})`,
+    notFound: (slug) => `Slug '${slug}' not found on item`,
+    cannotRemoveLast: (slug) => `Cannot remove last slug '${slug}' - items must have at least one slug`,
+};
+/**
+ * Validation errors (JSON, data format, constraints)
+ */
+export const validationErrors = {
+    // JSON parsing
+    invalidJson: 'Invalid JSON syntax',
+    invalidJsonInData: (err) => `Invalid JSON in --data${err ? `: ${err}` : ''}`,
+    invalidJsonFromStdin: (err) => `Invalid JSON from stdin${err ? `: ${err}` : ''}`,
+    invalidPatchData: (err) => `Invalid patch data${err ? `: ${err}` : ''}`,
+    // Data validation
+    noPatchesProvided: 'No patches provided',
+    noPatchData: 'No patch data. Use --data or pipe JSON to stdin.',
+    noInputProvided: 'No input provided. Use --data for single item or pipe JSONL/JSON for bulk.',
+    failedToParseBulk: (err) => `Failed to parse bulk input${err ? `: ${err}` : ''}`,
+    expectedJsonArray: 'Expected JSON array',
+    patchMustBeObject: (index) => `Item ${index + 1}: Patch must be an object`,
+    patchMustHaveRef: (index) => `Item ${index + 1}: Patch must have "ref" string`,
+    patchMustHaveData: (index) => `Item ${index + 1}: Patch must have "data" object`,
+    jsonLineError: (line, message) => `Line ${line}: ${message}`,
+    // Field validation
+    unknownFields: (fields) => `Unknown field(s): ${fields.join(', ')}`,
+    invalidPatchDataWithIssues: (issues) => `Invalid patch data: ${issues}`,
+    // Constraint validation
+    priorityOutOfRange: 'Priority must be between 1 and 5',
+    invalidObservationType: (type) => `Invalid observation type: ${type}`,
+    invalidType: (type, validTypes) => `Invalid type: ${type}. Must be one of: ${validTypes.join(', ')}`,
+    invalidTodoId: (id) => `Invalid todo ID: ${id}`,
+    // Required fields
+    titleRequired: 'Task title is required',
+    resolutionRequired: 'Resolution text is required',
+    agentRequiresId: 'Agent requires --id',
+    agentRequiresName: 'Agent requires --name',
+    workflowRequiresId: 'Workflow requires --id',
+    workflowRequiresTrigger: 'Workflow requires --trigger',
+    conventionRequiresDomain: 'Convention requires --domain',
+};
+/**
+ * Status/state errors (wrong status for operation)
+ */
+export const statusErrors = {
+    cannotStart: (status) => `Cannot start task with status: ${status}`,
+    cannotComplete: (status) => `Cannot complete task with status: ${status}`,
+    cannotBlock: (status) => `Cannot block task with status: ${status}`,
+    // AC: @spec-completion-enforcement ac-2
+    completeRequiresReview: 'Task must be submitted for review first. Use: kspec task submit @ref',
+    // AC: @spec-completion-enforcement ac-3
+    completeRequiresStart: 'Task must be started and submitted first',
+    // AC: @spec-completion-enforcement ac-4
+    completeBlockedTask: 'Cannot complete blocked task',
+    // AC: @spec-completion-enforcement ac-5
+    completeCancelledTask: 'Cannot complete cancelled task. Use: kspec task reset @ref first',
+    // AC: @spec-completion-enforcement ac-6
+    completeAlreadyCompleted: 'Task is already completed',
+    // AC: @spec-completion-enforcement ac-8
+    skipReviewRequiresReason: '--skip-review requires --reason to document why',
+};
+/**
+ * Duplicate/conflict errors
+ */
+export const conflictErrors = {
+    acAlreadyExists: (acId, itemRef) => `Acceptance criterion "${acId}" already exists on @${itemRef}`,
+    acIdAlreadyExists: (acId) => `Acceptance criterion "${acId}" already exists`,
+    observationAlreadyPromoted: (taskRef) => `Observation already promoted to task ${taskRef}; resolve or delete the task first`,
+    observationAlreadyResolved: (date, reason) => `Observation already resolved on ${date}: '${reason}'`,
+    specDirExists: (dir) => `spec/ directory already exists in ${dir}`,
+    moduleFileExists: (path) => `Module file already exists: ${path}`,
+};
+/**
+ * Operation not allowed errors
+ */
+export const operationErrors = {
+    cannotDeleteNoSource: 'Cannot delete item: no source file tracked',
+    cannotPromoteResolved: 'Cannot promote resolved observation; use --force to override',
+    tasksNoAcceptanceCriteria: (ref) => `Tasks don't have acceptance criteria; "${ref}" is a task`,
+    confirmRequired: (itemLabel) => `Warning: This will delete ${itemLabel}. Use --confirm to skip this prompt`,
+    cannotDeleteReferencedByTasks: (itemLabel, count, taskRefs) => `Cannot delete ${itemLabel}: Referenced by ${count} task(s): ${taskRefs}. Use --confirm to override.`,
+    cannotDeleteReferencedByObservations: (itemLabel, count, obsRefs) => `Cannot delete ${itemLabel}: Referenced by ${count} observation(s): ${obsRefs}. Use --confirm to override.`,
+    deleteItemFailed: (itemLabel) => `Failed to delete ${itemLabel}`,
+};
+/**
+ * Git-related errors
+ */
+export const gitErrors = {
+    notGitRepo: 'Not a git repository',
+    couldNotDetermineRoot: 'Could not determine git root directory',
+};
+/**
+ * Project/initialization errors
+ */
+export const projectErrors = {
+    noKspecProject: 'No kspec project found',
+    shadowInitFailed: (error) => `Shadow initialization failed: ${error}`,
+    couldNotGetImplSummary: 'Could not get implementation summary',
+    runningFromShadow: 'Cannot run kspec from inside .kspec/ directory',
+    runningFromShadowHint: (projectRoot) => `The .kspec/ directory is a git worktree. Run from project root: ${projectRoot}`,
+};
+/**
+ * Usage/argument errors
+ */
+export const usageErrors = {
+    // Derive command
+    deriveNeedRefOrAll: 'Either provide a spec reference or use --all',
+    deriveCannotUseBoth: 'Cannot use both a specific reference and --all',
+    deriveUsageHelp: {
+        header: 'Usage:',
+        examples: [
+            '  kspec derive @spec-ref',
+            '  kspec derive @spec-ref --flat',
+            '  kspec derive --all',
+        ],
+    },
+    // Patch command
+    patchNeedRef: 'Reference required for single item patch. Use: kspec item patch <ref> --data <json>',
+    // Log command
+    logNeedRef: 'Provide a reference or use --spec/--task',
+    // Ralph command
+    maxLoopsPositive: '--max-loops must be a positive integer',
+    maxRetriesNonNegative: '--max-retries must be a non-negative integer',
+    maxFailuresPositive: '--max-failures must be a positive integer',
+    agentPromptCancelled: 'Agent prompt was cancelled',
+    // Derive command
+    deriveNoRef: 'Either provide a spec reference or use --all',
+    deriveRefAndAll: 'Cannot use both a specific reference and --all',
+};
+/**
+ * Generic operation failures (with err object)
+ */
+export const operationFailures = {
+    // Item operations
+    listItems: 'Failed to list items',
+    getItem: 'Failed to get item',
+    createItem: 'Failed to create item',
+    updateItem: 'Failed to update item',
+    deleteItem: 'Failed to delete item',
+    patchItems: 'Failed to patch item(s)',
+    getItemStatus: 'Failed to get item status',
+    getTypes: 'Failed to get types',
+    getTags: 'Failed to get tags',
+    listAc: 'Failed to list acceptance criteria',
+    addAc: 'Failed to add acceptance criterion',
+    updateAc: 'Failed to update acceptance criterion',
+    removeAc: 'Failed to remove acceptance criterion',
+    // Task operations
+    getTask: 'Failed to get task',
+    createTask: 'Failed to create task',
+    updateTask: 'Failed to update task',
+    patchTask: 'Failed to patch task',
+    startTask: 'Failed to start task',
+    completeTask: 'Failed to complete task',
+    blockTask: 'Failed to block task',
+    unblockTask: 'Failed to unblock task',
+    cancelTask: 'Failed to cancel task',
+    deleteTask: 'Failed to delete task',
+    addNote: 'Failed to add note',
+    getNotes: 'Failed to get notes',
+    getTodos: 'Failed to get todos',
+    addTodo: 'Failed to add todo',
+    markTodoDone: 'Failed to mark todo as done',
+    markTodoNotDone: 'Failed to mark todo as not done',
+    listTasks: 'Failed to list tasks',
+    getReadyTasks: 'Failed to get ready tasks',
+    getNextTask: 'Failed to get next task',
+    getBlockedTasks: 'Failed to get blocked tasks',
+    getActiveTasks: 'Failed to get active tasks',
+    // Meta operations
+    showMeta: 'Failed to show meta',
+    listAgents: 'Failed to list agents',
+    listWorkflows: 'Failed to list workflows',
+    listConventions: 'Failed to list conventions',
+    getMetaItem: 'Failed to get meta item',
+    listMetaItems: 'Failed to list meta items',
+    createObservation: 'Failed to create observation',
+    listObservations: 'Failed to list observations',
+    promoteObservation: 'Failed to promote observation',
+    resolveObservation: 'Failed to resolve observation',
+    createMeta: (type) => `Failed to create ${type}`,
+    updateMetaItem: 'Failed to update meta item',
+    deleteMetaItem: 'Failed to delete meta item',
+    // Inbox operations
+    addInboxItem: 'Failed to add inbox item',
+    listInboxItems: 'Failed to list inbox items',
+    promoteInboxItem: 'Failed to promote inbox item',
+    deleteInboxItem: 'Failed to delete inbox item',
+    getInboxItem: 'Failed to get inbox item',
+    // Session operations
+    gatherSessionContext: 'Failed to gather session context',
+    runCheckpoint: 'Failed to run checkpoint',
+    updateSessionContext: 'Failed to update session context',
+    // Search operations
+    search: 'Failed to search',
+    searchCommits: 'Failed to search commits',
+    // Init operations
+    initProject: 'Failed to initialize project',
+    // Setup operations
+    installConfig: (agentType) => `Failed to install config for ${agentType}`,
+    setupFailed: 'Setup failed',
+    // Derive operations
+    deriveTasks: 'Failed to derive tasks',
+    // Ralph operations
+    ralphLoop: 'Ralph loop failed',
+    iterationFailed: (err) => `Iteration failed: ${err}`,
+    iterationFailedAfterRetries: (iteration, maxRetries, consecutiveFailures, maxFailures) => `Iteration ${iteration} failed after ${maxRetries + 1} attempts (${consecutiveFailures}/${maxFailures} consecutive failures)`,
+    lastError: (err) => `Last error: ${err}`,
+    reachedMaxFailures: (maxFailures) => `Reached ${maxFailures} consecutive failures. Exiting loop.`,
+};
+/**
+ * Todo-specific errors
+ */
+export const todoErrors = {
+    notFound: (id) => `Todo #${id} not found`,
+    invalidId: (id) => `Invalid todo ID: ${id}`,
+};
+/**
+ * Relationship/link errors
+ */
+export const relationshipErrors = {
+    invalidType: (type, validTypes) => `Invalid relationship type: ${type}. Must be one of: ${validTypes}`,
+};
+/**
+ * Re-export all error categories as a single object for convenience
+ */
+export const errors = {
+    reference: referenceErrors,
+    slug: slugErrors,
+    validation: validationErrors,
+    status: statusErrors,
+    conflict: conflictErrors,
+    operation: operationErrors,
+    git: gitErrors,
+    project: projectErrors,
+    usage: usageErrors,
+    failures: operationFailures,
+    todo: todoErrors,
+    relationship: relationshipErrors,
+};
+//# sourceMappingURL=errors.js.map

package/dist/strings/errors.js.map

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

package/dist/strings/guidance.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Guidance and instructional text shown to users and agents
+ */
+/**
+ * Alignment check guidance (shown when adding task notes)
+ */
+export declare const alignmentCheck: {
+    readonly header: string;
+    readonly beyondSpec: string;
+    readonly updateSpec: (specRef: string) => string;
+    readonly addAC: string;
+    readonly testCoverage: (count: number) => string;
+};
+/**
+ * Commit guidance (shown after task completion)
+ */
+export declare const commitGuidance: {
+    readonly header: string;
+    readonly message: (msg: string) => string;
+    readonly trailers: (trailers: string) => string;
+    readonly noSpecRef: {
+        readonly warning: string;
+        readonly consider: string;
+        readonly intentional: string;
+    };
+};
+/**
+ * Session checkpoint instructions
+ */
+export declare const checkpoint: {
+    readonly intro: string;
+    readonly inProgressTasks: {
+        readonly header: string;
+        readonly action: string;
+        readonly noteCommand: (ref: string) => string;
+    };
+    readonly incompleteTodos: {
+        readonly header: string;
+        readonly action: string;
+        readonly command: string;
+    };
+    readonly uncommittedChanges: {
+        readonly header: string;
+        readonly action: string;
+        readonly wipCommit: string;
+        readonly wipGuidance: string;
+    };
+    readonly hints: {
+        readonly header: string;
+        readonly taskNote: string;
+        readonly taskComplete: string;
+    };
+    readonly messages: {
+        readonly retry: (count: number) => string;
+        readonly success: string;
+        readonly issues: (count: number) => string;
+    };
+};
+/**
+ * Session prompt check (hook message)
+ */
+export declare const sessionPrompt: {
+    readonly specCheck: "[kspec] Before implementing behavior changes, check spec coverage. Update spec first if needed.";
+};
+//# sourceMappingURL=guidance.d.ts.map

package/dist/strings/guidance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidance.d.ts","sourceRoot":"","sources":["../../src/strings/guidance.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,eAAO,MAAM,cAAc;;;mCAGH,MAAM;;mCAGN,MAAM;CAEpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;;4BAEV,MAAM;kCACA,MAAM;;;;;;CAMnB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;oCAMA,MAAM;;;;;;;;;;;;;;;;;;;gCAwBV,MAAM;;iCAGL,MAAM;;CAGhB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa;;CAEhB,CAAC"}

package/dist/strings/guidance.js

@@ -0,0 +1,66 @@
+/**
+ * Guidance and instructional text shown to users and agents
+ */
+import chalk from 'chalk';
+/**
+ * Alignment check guidance (shown when adding task notes)
+ */
+export const alignmentCheck = {
+    header: chalk.gray('--- Alignment Check ---'),
+    beyondSpec: chalk.gray('Did your implementation add anything beyond the original spec?'),
+    updateSpec: (specRef) => chalk.gray(`If so, consider updating the spec:\n  kspec item set ${specRef} --description "Updated description"`),
+    addAC: chalk.gray('Or add acceptance criteria for new features.'),
+    testCoverage: (count) => chalk.gray(`Linked spec has ${count} acceptance criteria - consider test coverage.`),
+};
+/**
+ * Commit guidance (shown after task completion)
+ */
+export const commitGuidance = {
+    header: chalk.gray('--- Suggested Commit ---'),
+    message: (msg) => chalk.cyan(msg),
+    trailers: (trailers) => chalk.gray(trailers),
+    noSpecRef: {
+        warning: chalk.yellow("This task has no spec_ref."),
+        consider: chalk.gray("Is this a spec gap? Consider: kspec item add --under @parent ..."),
+        intentional: chalk.gray("Or is this intentional (infra/cleanup)?"),
+    },
+};
+/**
+ * Session checkpoint instructions
+ */
+export const checkpoint = {
+    intro: chalk.yellow('Before ending this session, please:'),
+    inProgressTasks: {
+        header: chalk.yellow('\n1. In-Progress Tasks:'),
+        action: chalk.gray('   Complete them or add a note explaining current state:'),
+        noteCommand: (ref) => chalk.gray(`   kspec task note ${ref} "WIP: what's done, what remains"`),
+    },
+    incompleteTodos: {
+        header: chalk.yellow('\n2. Incomplete Todos:'),
+        action: chalk.gray('   Complete them or convert to tasks:'),
+        command: chalk.gray('   kspec task add --title "..." --spec-ref "@..."'),
+    },
+    uncommittedChanges: {
+        header: chalk.yellow('\n3. Uncommitted Changes:'),
+        action: chalk.gray('   Commit your work or create a WIP commit:'),
+        wipCommit: chalk.gray(`   git add -A && git commit -m "WIP: describe state\n\n   Task: @task-ref"`),
+        wipGuidance: chalk.gray('   WIP commits are fine - they show progress and can be squashed later.'),
+    },
+    hints: {
+        header: chalk.gray('\nHelpful commands:'),
+        taskNote: chalk.gray('Use: kspec task note @task "Progress notes..." to document state'),
+        taskComplete: chalk.gray('Use: kspec task complete @task --reason "Summary" if task is done'),
+    },
+    messages: {
+        retry: (count) => chalk.yellow(`[kspec] Session checkpoint: ${count} issue(s) acknowledged - allowing stop`),
+        success: chalk.green('[kspec] Session checkpoint passed - ready to end session'),
+        issues: (count) => chalk.yellow(`[kspec] Session checkpoint: ${count} issue(s) need attention`),
+    },
+};
+/**
+ * Session prompt check (hook message)
+ */
+export const sessionPrompt = {
+    specCheck: '[kspec] Before implementing behavior changes, check spec coverage. Update spec first if needed.',
+};
+//# sourceMappingURL=guidance.js.map

package/dist/strings/guidance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidance.js","sourceRoot":"","sources":["../../src/strings/guidance.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC;IAC7C,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,gEAAgE,CAAC;IACxF,UAAU,EAAE,CAAC,OAAe,EAAE,EAAE,CAC9B,KAAK,CAAC,IAAI,CAAC,wDAAwD,OAAO,sCAAsC,CAAC;IACnH,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC;IACjE,YAAY,EAAE,CAAC,KAAa,EAAE,EAAE,CAC9B,KAAK,CAAC,IAAI,CAAC,mBAAmB,KAAK,gDAAgD,CAAC;CAC9E,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC;IAC9C,OAAO,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;IACzC,QAAQ,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;IACpD,SAAS,EAAE;QACT,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,4BAA4B,CAAC;QACnD,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,kEAAkE,CAAC;QACxF,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC;KACnE;CACO,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,qCAAqC,CAAC;IAE1D,eAAe,EAAE;QACf,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,yBAAyB,CAAC;QAC/C,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,0DAA0D,CAAC;QAC9E,WAAW,EAAE,CAAC,GAAW,EAAE,EAAE,CAC3B,KAAK,CAAC,IAAI,CAAC,sBAAsB,GAAG,mCAAmC,CAAC;KAC3E;IAED,eAAe,EAAE;QACf,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,wBAAwB,CAAC;QAC9C,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC;QAC3D,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC;KACzE;IAED,kBAAkB,EAAE;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,2BAA2B,CAAC;QACjD,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC;QACjE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,4EAA4E,CAAC;QACnG,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,yEAAyE,CAAC;KACnG;IAED,KAAK,EAAE;QACL,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC;QACzC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,kEAAkE,CAAC;QACxF,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,mEAAmE,CAAC;KAC9F;IAED,QAAQ,EAAE;QACR,KAAK,EAAE,CAAC,KAAa,EAAE,EAAE,CACvB,KAAK,CAAC,MAAM,CAAC,+BAA+B,KAAK,wCAAwC,CAAC;QAC5F,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,0DAA0D,CAAC;QAChF,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CACxB,KAAK,CAAC,MAAM,CAAC,+BAA+B,KAAK,0BAA0B,CAAC;KAC/E;CACO,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,SAAS,EAAE,iGAAiG;CACpG,CAAC"}

package/dist/strings/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Centralized strings and messages for user-facing text
+ *
+ * This module provides a single source of truth for all user-facing text,
+ * making it easier to maintain consistent tone, support i18n in the future,
+ * and review/update messaging across the entire CLI.
+ */
+export * from './labels.js';
+export * from './guidance.js';
+export * from './validation.js';
+export * from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/strings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/strings/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}

package/dist/strings/index.js

@@ -0,0 +1,12 @@
+/**
+ * Centralized strings and messages for user-facing text
+ *
+ * This module provides a single source of truth for all user-facing text,
+ * making it easier to maintain consistent tone, support i18n in the future,
+ * and review/update messaging across the entire CLI.
+ */
+export * from './labels.js';
+export * from './guidance.js';
+export * from './validation.js';
+export * from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/strings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/strings/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}

package/dist/strings/labels.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Field labels and section headers used throughout the CLI output
+ */
+/**
+ * Session context section headers
+ */
+export declare const sessionHeaders: {
+    readonly title: string;
+    readonly activeWork: string;
+    readonly noActiveWork: string;
+    readonly awaitingReview: string;
+    readonly recentlyCompleted: string;
+    readonly recentNotes: string;
+    readonly incompleteTodos: string;
+    readonly readyTasks: string;
+    readonly blocked: string;
+    readonly recentCommits: string;
+    readonly inbox: string;
+    readonly workingTree: string;
+    readonly workingTreeClean: string;
+    readonly quickCommands: string;
+};
+/**
+ * Task/Item detail field labels
+ */
+export declare const fieldLabels: {
+    readonly ulid: "ULID:";
+    readonly slugs: "Slugs:";
+    readonly type: "Type:";
+    readonly status: "Status:";
+    readonly priority: "Priority:";
+    readonly automation: "Automation:";
+    readonly maturity: "Maturity:";
+    readonly specRef: "Spec ref:";
+    readonly metaRef: "Meta ref:";
+    readonly depends: "Depends:";
+    readonly blocked: "Blocked:";
+    readonly tags: "Tags:";
+    readonly created: "Created:";
+    readonly started: "Started:";
+    readonly completed: "Completed:";
+    readonly implementation: "Implementation: ";
+    readonly description: "Description:";
+    readonly acceptanceCriteria: "Acceptance Criteria:";
+    readonly traceability: "Traceability:";
+};
+/**
+ * Output section separators
+ */
+export declare const sectionHeaders: {
+    readonly specContext: string;
+    readonly description: string;
+    readonly acceptanceCriteria: string;
+    readonly notes: string;
+    readonly todos: string;
+};
+/**
+ * Common CLI hints/suggestions
+ */
+export declare const hints: {
+    readonly inboxPromote: string;
+    readonly taskNote: (ref: string) => string;
+    readonly taskComplete: (ref: string) => string;
+    readonly taskStart: (ref: string) => string;
+    readonly gitCommit: string;
+};
+/**
+ * Summary/count messages
+ */
+export declare const summaries: {
+    readonly noTasks: string;
+    readonly taskCount: (count: number) => string;
+};
+//# sourceMappingURL=labels.d.ts.map

package/dist/strings/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/strings/labels.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;CAejB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;CAoBd,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,KAAK;;6BAEA,MAAM;iCAEF,MAAM;8BAET,MAAM;;CAGf,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,SAAS;;gCAED,MAAM;CACjB,CAAC"}

package/dist/strings/labels.js

@@ -0,0 +1,75 @@
+/**
+ * Field labels and section headers used throughout the CLI output
+ */
+import chalk from 'chalk';
+/**
+ * Session context section headers
+ */
+export const sessionHeaders = {
+    title: chalk.blue.bold('=== Session Context ==='),
+    activeWork: chalk.cyan.bold('--- Active Work ---'),
+    noActiveWork: chalk.gray('--- No Active Work ---'),
+    awaitingReview: chalk.yellow.bold('--- Awaiting Review ---'),
+    recentlyCompleted: chalk.green.bold('--- Recently Completed ---'),
+    recentNotes: chalk.cyan.bold('--- Recent Notes ---'),
+    incompleteTodos: chalk.yellow.bold('--- Incomplete Todos ---'),
+    readyTasks: chalk.cyan.bold('--- Ready to Pick Up ---'),
+    blocked: chalk.red.bold('--- Blocked ---'),
+    recentCommits: chalk.cyan.bold('--- Recent Commits ---'),
+    inbox: chalk.magenta.bold('--- Inbox (oldest first) ---'),
+    workingTree: chalk.yellow.bold('--- Working Tree ---'),
+    workingTreeClean: chalk.gray('--- Working Tree: Clean ---'),
+    quickCommands: chalk.gray.bold('--- Quick Commands ---'),
+};
+/**
+ * Task/Item detail field labels
+ */
+export const fieldLabels = {
+    ulid: 'ULID:',
+    slugs: 'Slugs:',
+    type: 'Type:',
+    status: 'Status:',
+    priority: 'Priority:',
+    automation: 'Automation:',
+    maturity: 'Maturity:',
+    specRef: 'Spec ref:',
+    metaRef: 'Meta ref:',
+    depends: 'Depends:',
+    blocked: 'Blocked:',
+    tags: 'Tags:',
+    created: 'Created:',
+    started: 'Started:',
+    completed: 'Completed:',
+    implementation: 'Implementation: ',
+    description: 'Description:',
+    acceptanceCriteria: 'Acceptance Criteria:',
+    traceability: 'Traceability:',
+};
+/**
+ * Output section separators
+ */
+export const sectionHeaders = {
+    specContext: chalk.gray('─── Spec Context ───'),
+    description: chalk.gray('─── Description ───'),
+    acceptanceCriteria: chalk.gray('─── Acceptance Criteria ───'),
+    notes: chalk.gray('─── Notes ───'),
+    todos: chalk.gray('─── Todos ───'),
+};
+/**
+ * Common CLI hints/suggestions
+ */
+export const hints = {
+    inboxPromote: chalk.gray('Use: kspec inbox promote <ref> to convert to task'),
+    taskNote: (ref) => chalk.gray(`Use: kspec task note ${ref} "<note>" to add context`),
+    taskComplete: (ref) => chalk.gray(`Use: kspec task complete ${ref} --reason "<summary>" when done`),
+    taskStart: (ref) => chalk.gray(`Use: kspec task start ${ref} to begin work`),
+    gitCommit: chalk.gray('Use: git add -A && git commit -m "..." to commit changes'),
+};
+/**
+ * Summary/count messages
+ */
+export const summaries = {
+    noTasks: chalk.gray('No tasks found'),
+    taskCount: (count) => chalk.gray(`${count} task(s)`),
+};
+//# sourceMappingURL=labels.js.map

package/dist/strings/labels.js.map

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