@selvakumaresra/specship 0.1.1 → 0.1.3

package/dist/workflows/defaults/spec-relink.yaml

@@ -1,81 +0,0 @@
-name: spec-relink
-description: Re-attach an orphaned spec link after a refactor. Search for the moved/renamed symbol → approve → assert new link.
-tags: [spec, default]
-requires: [specship]
-
-worktree:
-  enabled: false
-
-inputs:
-  - name: SPEC_ID
-    description: The spec ID with an orphaned link
-    required: true
-
-systemPromptAppend: |
-  You are reattaching a spec link whose target symbol has moved or been
-  renamed. Use specship_search and specship_explore to locate the new
-  symbol; do NOT edit code in this workflow.
-
-nodes:
-  - id: present_orphan
-    kind: prompt
-    output_type: orphan_summary
-    allowed_tools:
-      - mcp__specship__specship_spec
-    prompt: |
-      Spec ID: $INPUT.SPEC_ID
-
-      Call specship_spec to find the orphaned link(s). For each:
-      output its old target_file_path and target_qualified_name plus
-      a short description of what the spec asks for.
-
-  - id: search_candidates
-    kind: prompt
-    depends_on: [present_orphan]
-    output_type: candidates
-    allowed_tools:
-      - mcp__specship__specship_search
-      - mcp__specship__specship_explore
-      - mcp__specship__specship_node
-    prompt: |
-      The orphan(s):
-      $present_orphan.output
-
-      For each orphaned target_qualified_name, use specship_search to
-      see if a symbol by that name (or a closely related name) exists
-      anywhere in the current codebase. Then call specship_explore on
-      the most likely matches to see if their bodies match the spec's
-      intent.
-
-      Output: a numbered list of CANDIDATES with file:symbol and a
-      one-line justification.
-
-  - id: approve_relink
-    kind: approval
-    depends_on: [search_candidates]
-    message: |
-      Candidates for $INPUT.SPEC_ID:
-
-      $search_candidates.output
-
-      Reply with the number of the correct candidate (or "none" to
-      abandon and leave the link orphaned).
-    capture_response: true
-
-  - id: assert_link
-    kind: prompt
-    depends_on: [approve_relink]
-    output_type: link_summary
-    allowed_tools:
-      - mcp__specship__specship_link_assert
-    prompt: |
-      The reviewer chose candidate #$approve_relink.output for spec
-      $INPUT.SPEC_ID.
-
-      Candidates were:
-      $search_candidates.output
-
-      Call specship_link_assert with the chosen candidate's path and
-      qualified_name (and the original kind, default "implements").
-
-      Output: confirmation of the new link.

package/dist/workflows/defaults/spec-verify.yaml

@@ -1,51 +0,0 @@
-name: spec-verify
-description: Run verification across all 'implemented' spec links. Use as a CI gate or pre-commit check.
-tags: [spec, default, ci]
-requires: [specship, tests]
-
-# No worktree — runs in-place against the current checkout.
-worktree:
-  enabled: false
-
-nodes:
-  - id: run_tests
-    kind: bash
-    output_type: test_results
-    timeout: 600000
-    bash: |
-      if [ -f package.json ]; then
-        npm test
-      elif [ -f Cargo.toml ]; then
-        cargo test
-      elif [ -f pyproject.toml ] || [ -f requirements.txt ]; then
-        python -m pytest
-      else
-        echo "no recognised test framework; skipping" >&2
-        exit 0
-      fi
-
-  - id: summarize
-    kind: prompt
-    depends_on: [run_tests]
-    output_type: link_summary
-    trigger_rule: all_done
-    allowed_tools:
-      - mcp__specship__specship_drifted
-      - mcp__specship__specship_spec
-      - mcp__specship__specship_link_verify
-    prompt: |
-      Test run completed. Output (truncated):
-
-      $run_tests.output
-
-      1. Call specship_drifted to see any drifted/broken/orphaned links.
-      2. If tests passed (no failures reported), iterate over each
-         'implemented' link and call specship_link_verify(result: "pass")
-         to promote them to "verified". (Skip links that are already
-         verified.)
-      3. If tests failed, identify which specs the failing tests are
-         tied to and call specship_link_verify(result: "fail", reason:
-         "<test name>") on those links.
-
-      Output: a short summary of how many links moved to verified,
-      how many to broken, and which specs are still drifted.

package/dist/workflows/discovery.d.ts

@@ -1,46 +0,0 @@
-/**
- * Workflow discovery — three-tier precedence loader.
- *
- * Inspired by Archon's `packages/workflows/src/workflow-discovery.ts:205-361`.
- *
- * Precedence (highest wins on filename collision):
- *   1. Bundled defaults  (compiled-in, see ./defaults/index.ts)
- *   2. Global   `~/.specship/workflows/`
- *   3. Project  `<projectRoot>/.specship/workflows/`
- *
- * One level of nesting (`subdir/foo.yaml`) is allowed; deeper paths are
- * silently ignored to keep discovery cheap and predictable. Per-file YAML
- * parse or validation failures are isolated — one broken workflow does
- * not abort discovery of its peers.
- */
-import { WorkflowDefinition, ValidationError } from './schemas/workflow';
-export type WorkflowScope = 'bundled' | 'global' | 'project';
-export interface WorkflowWithSource {
-    workflow: WorkflowDefinition;
-    scope: WorkflowScope;
-    sourcePath: string;
-}
-export interface WorkflowLoadError {
-    scope: WorkflowScope;
-    sourcePath: string;
-    errors: ValidationError[];
-}
-export interface WorkflowLoadResult {
-    /** Discovered workflows, after precedence resolution. */
-    workflows: WorkflowWithSource[];
-    /** Errors per failed workflow file. */
-    errors: WorkflowLoadError[];
-}
-/**
- * Discover workflows from bundled defaults + global + project scopes.
- * Project overrides global; global overrides bundled. Matching is by
- * filename stem (e.g. `spec-implement.yaml` at project level overrides
- * any `spec-implement.yaml` from bundled).
- */
-export declare function discoverWorkflows(projectRoot: string): WorkflowLoadResult;
-/**
- * Load a single workflow by name from the resolved discovery layer.
- * Returns null if no workflow with that name exists in any scope.
- */
-export declare function loadWorkflowByName(projectRoot: string, name: string): WorkflowWithSource | null;
-//# sourceMappingURL=discovery.d.ts.map

package/dist/workflows/discovery.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/workflows/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,EACL,kBAAkB,EAElB,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAG5B,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,uCAAuC;IACvC,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,CAoCzE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX,kBAAkB,GAAG,IAAI,CAG3B"}

package/dist/workflows/discovery.js

@@ -1,193 +0,0 @@
-"use strict";
-/**
- * Workflow discovery — three-tier precedence loader.
- *
- * Inspired by Archon's `packages/workflows/src/workflow-discovery.ts:205-361`.
- *
- * Precedence (highest wins on filename collision):
- *   1. Bundled defaults  (compiled-in, see ./defaults/index.ts)
- *   2. Global   `~/.specship/workflows/`
- *   3. Project  `<projectRoot>/.specship/workflows/`
- *
- * One level of nesting (`subdir/foo.yaml`) is allowed; deeper paths are
- * silently ignored to keep discovery cheap and predictable. Per-file YAML
- * parse or validation failures are isolated — one broken workflow does
- * not abort discovery of its peers.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.discoverWorkflows = discoverWorkflows;
-exports.loadWorkflowByName = loadWorkflowByName;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const os = __importStar(require("os"));
-const yaml = __importStar(require("yaml"));
-const workflow_1 = require("./schemas/workflow");
-const defaults_1 = require("./defaults");
-/**
- * Discover workflows from bundled defaults + global + project scopes.
- * Project overrides global; global overrides bundled. Matching is by
- * filename stem (e.g. `spec-implement.yaml` at project level overrides
- * any `spec-implement.yaml` from bundled).
- */
-function discoverWorkflows(projectRoot) {
-    const byName = new Map();
-    const errors = [];
-    // 1. Bundled (lowest precedence)
-    for (const entry of defaults_1.bundledDefaults) {
-        const result = parseAndValidate(entry.yaml);
-        if (result.workflow) {
-            byName.set(entry.name, {
-                workflow: result.workflow,
-                scope: 'bundled',
-                sourcePath: `bundled:${entry.name}.yaml`,
-            });
-        }
-        else {
-            errors.push({
-                scope: 'bundled',
-                sourcePath: `bundled:${entry.name}.yaml`,
-                errors: result.errors,
-            });
-        }
-    }
-    // 2. Global
-    const globalDir = path.join(os.homedir(), '.specship', 'workflows');
-    loadFromDir(globalDir, 'global', byName, errors);
-    // 3. Project (highest precedence)
-    const projectDir = path.join(projectRoot, '.specship', 'workflows');
-    loadFromDir(projectDir, 'project', byName, errors);
-    return {
-        workflows: [...byName.values()].sort((a, b) => a.workflow.name.localeCompare(b.workflow.name)),
-        errors,
-    };
-}
-/**
- * Load a single workflow by name from the resolved discovery layer.
- * Returns null if no workflow with that name exists in any scope.
- */
-function loadWorkflowByName(projectRoot, name) {
-    const all = discoverWorkflows(projectRoot);
-    return all.workflows.find((w) => w.workflow.name === name) ?? null;
-}
-// =============================================================================
-// internal
-// =============================================================================
-function loadFromDir(dir, scope, byName, errors) {
-    let entries;
-    try {
-        entries = fs.readdirSync(dir, { withFileTypes: true });
-    }
-    catch {
-        return; // directory doesn't exist — fine, scope is empty
-    }
-    const filesToLoad = [];
-    for (const entry of entries) {
-        const full = path.join(dir, entry.name);
-        if (entry.isFile() && isYamlFile(entry.name)) {
-            filesToLoad.push(full);
-        }
-        else if (entry.isDirectory() && !entry.name.startsWith('.')) {
-            // One level of nesting only.
-            try {
-                const nested = fs.readdirSync(full, { withFileTypes: true });
-                for (const n of nested) {
-                    if (n.isFile() && isYamlFile(n.name)) {
-                        filesToLoad.push(path.join(full, n.name));
-                    }
-                }
-            }
-            catch {
-                // ignore
-            }
-        }
-    }
-    for (const file of filesToLoad) {
-        let source;
-        try {
-            source = fs.readFileSync(file, 'utf-8');
-        }
-        catch (err) {
-            errors.push({
-                scope,
-                sourcePath: file,
-                errors: [
-                    {
-                        path: '$',
-                        message: `read failed: ${err instanceof Error ? err.message : String(err)}`,
-                    },
-                ],
-            });
-            continue;
-        }
-        const result = parseAndValidate(source);
-        if (result.workflow) {
-            byName.set(result.workflow.name, {
-                workflow: result.workflow,
-                scope,
-                sourcePath: file,
-            });
-        }
-        else {
-            errors.push({ scope, sourcePath: file, errors: result.errors });
-        }
-    }
-}
-function isYamlFile(name) {
-    const lower = name.toLowerCase();
-    return lower.endsWith('.yaml') || lower.endsWith('.yml');
-}
-function parseAndValidate(source) {
-    let parsed;
-    try {
-        parsed = yaml.parse(source);
-    }
-    catch (err) {
-        return {
-            errors: [
-                {
-                    path: '$',
-                    message: `YAML parse error: ${err instanceof Error ? err.message : String(err)}`,
-                },
-            ],
-        };
-    }
-    const validation = (0, workflow_1.validateWorkflow)(parsed);
-    if (!validation.ok || !validation.workflow) {
-        return { errors: validation.errors };
-    }
-    return { workflow: validation.workflow, errors: [] };
-}
-//# sourceMappingURL=discovery.js.map

package/dist/workflows/discovery.js.map

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

package/dist/workflows/executor.d.ts

@@ -1,83 +0,0 @@
-/**
- * DAG workflow executor.
- *
- * Orchestrates a `WorkflowDefinition` end-to-end:
- *   1. Topological sort of nodes (`depends_on` edges).
- *   2. For each node, check its `trigger_rule` against upstream states +
- *      its `when:` condition. Skip when gates fail.
- *   3. Dispatch to the right runner (prompt / bash / script / approval / cancel).
- *   4. On `paused` → persist state and return; resume() picks up later.
- *   5. On `failed` → respect `retry` config (transient vs all).
- *   6. On `cancelled` → mark all unstarted downstreams as skipped and stop.
- *
- * Persisted state: workflow_runs row tracks lifecycle status, completed
- * node IDs, and approval context. workflow_events rows form an append-only
- * audit trail. Artifacts go to `<artifactsDir>/nodes/<id>.{md,meta.json}`.
- */
-import { WorkflowDefinition, DagNode } from './schemas/workflow';
-import { WorkflowRun, WorkflowNodeState } from '../types';
-import { SpecQueries } from '../db/spec-queries';
-import { WorktreeProvider } from '../isolation/worktree';
-import { NodeOutput } from './condition-evaluator';
-export interface ExecuteOptions {
-    /** Project root (used to derive default cwd + spawn the worktree). */
-    projectRoot: string;
-    /** Workflow inputs (e.g., SPEC_ID). */
-    inputs?: Record<string, string>;
-    /** Additional variables ($CONTEXT, etc.). */
-    variables?: Record<string, string>;
-    /** Verbose logging. */
-    verbose?: boolean;
-    /** Override the run ID (mostly for resume). Defaults to a fresh UUID. */
-    runId?: string;
-}
-export interface ExecuteResult {
-    run: WorkflowRun;
-    /** Final node states (id → state). */
-    nodeStates: Map<string, WorkflowNodeState>;
-    /** Node outputs (for caller inspection). */
-    outputs: Map<string, NodeOutput>;
-}
-export declare class WorkflowExecutor {
-    private specQueries;
-    private worktrees;
-    private runners;
-    constructor(specQueries: SpecQueries, worktrees: WorktreeProvider);
-    start(workflow: WorkflowDefinition, opts: ExecuteOptions): Promise<ExecuteResult>;
-    /**
-     * Resume a paused (approved) or failed run. Skips already-completed nodes.
-     */
-    resume(workflow: WorkflowDefinition, runId: string, opts: Omit<ExecuteOptions, 'runId'>): Promise<ExecuteResult>;
-    cancel(runId: string, reason?: string): void;
-    /**
-     * Approve a paused run. The caller is expected to call `resume` afterwards
-     * to actually continue execution. This separation matches Archon's pattern
-     * (manage_run.approve only transitions state; resume drives the next step).
-     */
-    approve(runId: string, comment?: string): void;
-    reject(runId: string, reason?: string): void;
-    private driveExecution;
-    private runWithRetry;
-    private checkTrigger;
-    /**
-     * Walk a node's string fields and substitute `$nodeId.output[.field]` /
-     * `$INPUT.X` / `$VAR` references. Returns a shallow clone with substituted
-     * values; the original is untouched.
-     *
-     * For prompt nodes we substitute `prompt` and `systemPromptAppend`.
-     * For bash/script nodes we substitute `bash` / `script` (with bash-safe
-     * shell escaping). For approval nodes we substitute `message`.
-     * cancel: substitute `cancel` reason.
-     */
-    private resolveNodeRefs;
-    private makeSubstitutionContext;
-    private finalize;
-    private writeArtifact;
-    private event;
-}
-/**
- * Kahn's algorithm topological sort. Cycles fail loudly — the executor
- * refuses to run a workflow that doesn't form a DAG.
- */
-export declare function topoSort(nodes: DagNode[]): string[];
-//# sourceMappingURL=executor.d.ts.map

package/dist/workflows/executor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/workflows/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,OAAO,EACL,kBAAkB,EAClB,OAAO,EAOR,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,WAAW,EACX,iBAAiB,EAGlB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EACL,UAAU,EAIX,MAAM,uBAAuB,CAAC;AAQ/B,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,uBAAuB;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,WAAW,CAAC;IACjB,sCAAsC;IACtC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC3C,4CAA4C;IAC5C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAClC;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,OAAO,CAAmC;gBAEtC,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB;IAgB3D,KAAK,CACT,QAAQ,EAAE,kBAAkB,EAC5B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,aAAa,CAAC;IA8EzB;;OAEG;IACG,MAAM,CACV,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,aAAa,CAAC;IAqCzB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAA4B,GAAG,IAAI;IA8BjE;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAuC9C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;YA6B9B,cAAc;YA0Id,YAAY;IA2B1B,OAAO,CAAC,YAAY;IAuBpB;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;IAiDvB,OAAO,CAAC,uBAAuB;YAajB,QAAQ;YA4CR,aAAa;IAyB3B,OAAO,CAAC,KAAK;CA0Bd;AAMD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CA6BnD"}