pray-cli 1.16.0 → 1.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5950b63f50e919bd5864874919afde95413ed095954046604d570d4c3daf090a
-  data.tar.gz: 82056f753f0d244afd54de70b7528d1e5d98b0c67f0da18538eb5d906986f12b
+  metadata.gz: f7499680372bceb27c55d6d182225ea43870e4bfd94a431a085e42198ff90557
+  data.tar.gz: 32af3f08b8ea05718970b3283f04e81552ff8355ad0ca260d3b1c61b3ab05619
 SHA512:
-  metadata.gz: e3289cc2a08751a1358c37ddfb692d042c2d522374b02ed370dd25e703f5c5fe3be66996bbd008a7e6dfbe26a9ea6b278b87f640035a55a235ef7e1ed1d00967
-  data.tar.gz: a54b4dbed546b3f301d42692033552c3878b2281f25fee70e647e02634c19541a7440542bddbade45619a2e6dd4cac8bcefc05ff89b035645195ce90a3bffad6
+  metadata.gz: 1ea412c96b4c0d3cb766f75bec70dcd9e29c368594bf67d4438f8464703dbe4cd781dff6b093eefa8f46269de3886d09ff4bf27c8c02503a6e61650413439667
+  data.tar.gz: 389eb906dbdae17bf789290a450e10c5a6ccae9064f707d4f494e444e4efdaf62283103adf3f0bc335d705a99292efb1885c87da4c1daab40677a6a0fbd9e0d0

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # CHANGELOG
 
+## 1.17.0 (2026-09-16)
+
+- Locate local prayers through a path source of any directory name (RFC 0117). `pray prayer init` adds `source "local"` when needed and declares `pray "local/project"` once. Version is optional until `pray package` or `pray publish`. `.agents/project.md` remains a compose shortcut for one local file.
+- Copy upstream files into an empty path-fork tree on `pray install` and `pray update` (RFC 0116). Extra listed overlay files stay. `pray outdated` lists fork files that differ from the locked upstream. An identity-only fork uses empty `spec.files`; refresh lists content paths, not the prayspec file.
+- Refuse a local path with `file:` and a local path inside `tree`. Compose still embeds local fragments. Package `file:` and package `tree` stay.
+- Name dest versus lock on `pray verify`, dest versus a fresh render on `pray drift`, and dest write on `pray render`. Dry-run of a write is `pray plan`. Listed local compose files stay on `pray install`.
+- Write `.praytorrent.json` when `v1/distribution.json` lists `protocols: ["torrent"]` (RFC 0062). `pray repo init` writes empty protocols.
+- Parse `spec.maintainers` as a string array, and accept `spec.pray_version` as an alias for `spec.prayfile_version`.
+- Re-embed a changed local compose source on `pray install`, `pray update`, and `pray plan`, and print its `sha256` as `checked` or `was`. List local checksum drift under `pray outdated`.
+
 ## 1.16.0 (2026-09-15)
 
 - Rewrite a two-component pessimistic Prayfile pin on `pray update --latest` (`~> 2.2` to `~> 2.4` when registry latest is 2.4.0), matching the Rust and TypeScript CLIs. Install a newer version that the current constraint already allows.

data/lib/pray/apply_report.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Pray
+  module ApplyReport
+    module_function
+
+    def local_summary_lines(previous, project)
+      previous_checksums = previous_local_checksums(previous)
+      project.local_files.filter_map do |local|
+        next if local.content.empty? && local.optional
+
+        checksum = local.source_checksum
+        previous_checksum = previous_checksums[local.manifest_path]
+        if previous_checksum.nil?
+          "Installing #{local.manifest_path} (#{checksum})"
+        elsif previous_checksum == checksum
+          "Using #{local.manifest_path} (#{checksum} checked)"
+        else
+          "Updating #{local.manifest_path} (#{checksum} was #{previous_checksum})"
+        end
+      end
+    end
+
+    def outdated_local_lines(previous, project)
+      previous_checksums = previous_local_checksums(previous)
+      project.local_files.filter_map do |local|
+        next if local.content.empty? && local.optional
+
+        checksum = local.source_checksum
+        previous_checksum = previous_checksums[local.manifest_path]
+        if previous_checksum && previous_checksum != checksum
+          "#{local.manifest_path} #{previous_checksum} -> #{checksum}"
+        elsif previous && previous_checksum.nil?
+          "#{local.manifest_path} (new) -> #{checksum}"
+        end
+      end
+    end
+
+    def previous_local_checksums(previous)
+      return {} unless previous
+
+      previous.managed_span.each_with_object({}) do |span, checksums|
+        next unless span.package == LOCAL_EMBED_PACKAGE
+
+        checksums[span.export] = span.source_checksum
+      end
+    end
+  end
+end

data/lib/pray/cli/commands/init.rb

@@ -25,26 +25,6 @@ module Pray
       File.write(path, "#{lines.join("\n")}\n")
     end
 
-    def prayer_init_command
-      root = Dir.pwd
-      package_name = File.basename(root)
-      package_name = "prayer-package" if package_name.strip.empty?
-      prayspec_path = File.join(root, "#{package_name}.prayspec")
-      raise Error.manifest("package spec already exists: #{prayspec_path}") if File.exist?(prayspec_path)
-
-      File.write(
-        prayspec_path,
-        <<~SPEC
-          Package::Specification.new do |spec|
-            spec.name = "#{package_name}"
-            spec.version = "0.1.0"
-            spec.summary = "Prayer package"
-            spec.files = []
-          end
-        SPEC
-      )
-    end
-
     def repo_init_command
       distribution_root = repo_distribution_root(Dir.pwd)
       index_path = File.join(distribution_root, "v1", "index.json")
@@ -53,6 +33,7 @@ module Pray
       FileUtils.mkdir_p(File.join(distribution_root, "v1", "packages"))
       FileUtils.mkdir_p(File.join(distribution_root, "v1", "artifacts"))
       Publish.write_registry_index(distribution_root, RegistryIndex.new)
+      Distribution.write_settings(distribution_root)
     end
 
     def repo_distribution_root(root)

data/lib/pray/cli/commands/init_prayer.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require "fileutils"
+
+module Pray
+  module CLI
+    def prayer_init_command(name = nil, directory = nil)
+      if File.exist?(manifest_path)
+        scaffold_local_prayer(name, directory)
+      else
+        scaffold_standalone_package(name)
+      end
+    end
+
+    def scaffold_local_prayer(name, directory)
+      requested = name.to_s.strip
+      package_name = LocalPrayer.validate_name!(requested.empty? ? DEFAULT_LOCAL_PRAYER_NAME : requested)
+      source_name, source_directory = resolve_local_prayer_directory(directory)
+      root = File.join(project_root, source_directory, package_name)
+      prayspec_path = File.join(root, "#{package_name}.prayspec")
+      raise Error.manifest("package spec already exists: #{prayspec_path}") if File.exist?(prayspec_path)
+      raise Error.manifest("prayer directory already exists: #{root}") if File.exist?(root)
+
+      FileUtils.mkdir_p(File.join(root, "exports"))
+      File.write(prayspec_path, local_prayspec(source_name, package_name))
+      File.write(File.join(root, "README.md"), "# #{package_name}\n")
+      File.write(File.join(root, "exports", "#{package_name}.md"), "# #{package_name}\n")
+      declare_local_prayer("#{source_name}/#{package_name}")
+    end
+
+    def scaffold_standalone_package(name)
+      root = Dir.pwd
+      package_name = if name.nil? || name.strip.empty?
+        basename = File.basename(root)
+        basename.strip.empty? ? "prayer-package" : basename
+      else
+        LocalPrayer.validate_name!(name)
+      end
+      prayspec_path = File.join(root, "#{package_name}.prayspec")
+      raise Error.manifest("package spec already exists: #{prayspec_path}") if File.exist?(prayspec_path)
+
+      File.write(prayspec_path, standalone_prayspec(package_name))
+      readme = File.join(root, "README.md")
+      File.write(readme, "# #{package_name}\n") unless File.exist?(readme)
+      FileUtils.mkdir_p(File.join(root, "exports"))
+    end
+
+    def local_prayspec(source_name, name)
+      <<~SPEC
+        Package::Specification.new do |spec|
+          spec.name = "#{source_name}/#{name}"
+          spec.summary = "Describe this package"
+          spec.files = ["README.md", "exports/#{name}.md"]
+          spec.exports = {
+            "#{name}" => {
+              type: "fragment",
+              path: "exports/#{name}.md"
+            }
+          }
+        end
+      SPEC
+    end
+
+    def standalone_prayspec(name)
+      <<~SPEC
+        Package::Specification.new do |spec|
+          spec.name = "#{name}"
+          spec.version = "0.1.0"
+          spec.summary = "Describe this package"
+          spec.files = ["README.md"]
+          spec.exports = {}
+        end
+      SPEC
+    end
+  end
+end

data/lib/pray/cli/commands/init_prayer_manifest.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+module Pray
+  module CLI
+    def resolve_local_prayer_directory(requested)
+      manifest = Pray.parse_manifest(Pray.read_manifest_text(manifest_path))
+      path_sources = path_sources_for(manifest)
+      if requested
+        directory = requested.to_s.strip
+        raise Error.usage("--path requires a directory") if directory.empty?
+
+        matching = path_sources.find { |source| source.url == directory }
+        return [matching.name, matching.url] if matching
+        if path_sources.length == 1
+          raise Error.usage("path source already uses #{path_sources.first.url}")
+        end
+
+        name = ensure_path_source(directory)
+        return [name, directory]
+      end
+
+      case path_sources.length
+      when 0
+        name = ensure_path_source(DEFAULT_PATH_SOURCE_DIRECTORY)
+        [name, DEFAULT_PATH_SOURCE_DIRECTORY]
+      when 1
+        [path_sources.first.name, path_sources.first.url]
+      else
+        raise Error.usage("say which directory with --path")
+      end
+    end
+
+    def declare_local_prayer(package_name)
+      manifest_text = Pray.read_manifest_text(manifest_path)
+      manifest = Pray.parse_manifest(manifest_text)
+      return if manifest.packages.any? { |package| package.name == package_name }
+
+      statement = "pray \"#{package_name}\""
+      updated = insert_into_first_compose(manifest_text, statement) ||
+        insert_manifest_statement(manifest_text, statement)
+      Transaction.write_file(manifest_path, updated)
+    end
+
+    def path_sources_for(manifest)
+      manifest.sources.select { |source| source.kind == "path" }
+    end
+
+    def ensure_path_source(directory)
+      manifest_text = Pray.read_manifest_text(manifest_path)
+      manifest = Pray.parse_manifest(manifest_text)
+      existing = manifest.sources.find { |source| source.kind == "path" && source.url == directory }
+      return existing.name if existing
+
+      name = unused_source_name(manifest, directory)
+      statement = "source \"#{name}\", path: \"#{directory}\""
+      Transaction.write_file(manifest_path, insert_source_statement(manifest_text, statement))
+      name
+    end
+
+    def unused_source_name(manifest, directory)
+      taken = manifest.sources.map(&:name)
+      return DEFAULT_PATH_SOURCE_NAME unless taken.include?(DEFAULT_PATH_SOURCE_NAME)
+
+      fallback = directory.to_s.split(%r{[/\\]}).reject(&:empty?).last || DEFAULT_PATH_SOURCE_NAME
+      raise Error.manifest("source name #{fallback} is already used") if taken.include?(fallback)
+
+      fallback
+    end
+
+    def insert_source_statement(text, statement)
+      lines = text.lines.map(&:chomp)
+      last_source = lines.rindex { |line| line.lstrip.start_with?("source ") }
+      insertion_index = if last_source
+        last_source + 1
+      else
+        prayfile = lines.index { |line| line.lstrip.start_with?("prayfile ") }
+        prayfile ? prayfile + 1 : 0
+      end
+      lines.insert(insertion_index, statement)
+      join_manifest_lines(lines)
+    end
+
+    def insert_into_first_compose(text, statement)
+      lines = text.lines.map(&:chomp)
+      index = lines.index do |line|
+        trimmed = line.lstrip
+        trimmed.start_with?("compose ") && trimmed.end_with?(" do")
+      end
+      return unless index
+
+      indent = lines[index][/\A\s*/].to_s
+      lines.insert(index + 1, "#{indent}  #{statement}")
+      join_manifest_lines(lines)
+    end
+
+    def join_manifest_lines(lines)
+      output = lines.join("\n")
+      output += "\n" unless output.end_with?("\n")
+      output
+    end
+  end
+end

data/lib/pray/cli/commands/packages.rb

@@ -36,7 +36,7 @@ module Pray
       project = resolve_current_project
       lines = ["Package list"]
       project.packages.each do |package|
-        lines << "#{package.declaration.name} #{package.spec.version} source=#{package_source_summary(package)} exports=#{format_list(package.selected_exports)}"
+        lines << "#{package.declaration.name} #{package.spec.recorded_version} source=#{package_source_summary(package)} exports=#{format_list(package.selected_exports)}"
       end
       puts lines.join("\n")
     end
@@ -54,6 +54,7 @@ module Pray
     def package_command
       project = resolve_current_project
       project.packages.each do |package|
+        package.spec.require_release_version!
         output_path = Archive.package_archive_path(package.declaration.name, package.spec.version)
         Archive.write_package_archive(package, output_path)
       end
@@ -72,7 +73,7 @@ module Pray
       lines = ["Package explanation"]
       lines << "name: #{package.declaration.name}"
       lines << "constraint: #{package.declaration.constraint}"
-      lines << "resolved version: #{package.spec.version}"
+      lines << "resolved version: #{package.spec.recorded_version}"
       if package.registry_latest_version
         lines << "registry latest: #{package.registry_latest_version}"
       end
@@ -102,6 +103,16 @@ module Pray
       else
         Plan.package_summary_lines(previous_lockfile, latest_lockfile, project).each { |line| puts line }
       end
+      local_lines = ApplyReport.outdated_local_lines(previous_lockfile, project)
+      unless local_lines.empty?
+        puts "Outdated local files"
+        local_lines.each { |line| puts line }
+      end
+      fork_lines = Upstream.path_fork_drift_lines(project, previous_lockfile, ResolveOptions.new)
+      unless fork_lines.empty?
+        puts "Outdated path forks"
+        fork_lines.each { |line| puts line }
+      end
     end
   end
 end

data/lib/pray/cli/commands/workflow.rb

@@ -5,6 +5,7 @@ require "fileutils"
 module Pray
   module CLI
     def install_command(flags)
+      previous_lockfile = File.exist?(lockfile_path) ? Pray.read_lockfile(lockfile_path) : nil
       Pray.materialize_project(
         manifest_path: manifest_path,
         frozen: flags[:frozen],
@@ -14,6 +15,10 @@ module Pray
         ignore_locked_versions: flags[:ignore_locked_versions],
         unlocked_packages: flags[:unlocked_packages]
       )
+      return if flags[:frozen] || flags[:locked]
+
+      project = resolve_current_project
+      ApplyReport.local_summary_lines(previous_lockfile, project).each { |line| puts line }
     end
 
     def render_command(flags)

data/lib/pray/cli/help.rb

@@ -4,19 +4,19 @@ module Pray
   module CLI
     module Help
       WORKFLOW_COMMANDS = [
-        "install [--locked|--frozen|--offline]  resolve, render, and write Prayfile.lock",
-        "plan [--remote]                        preview materialization changes",
+        "install [--locked|--frozen|--offline]  keep locked versions, re-embed listed locals",
+        "plan [--remote]                        dry-run of install: dest after patch",
         "apply                                  apply the current plan",
-        "verify [--strict]                      check rendered output against the lockfile",
-        "drift [--semantic]                     compare lockfile to current resolution",
-        "render [--check]                       render targets without updating the lockfile",
+        "verify [--strict]                      dest managed spans versus Prayfile.lock",
+        "drift [--semantic]                     dest versus lock, then dest versus a fresh render",
+        "render [--check]                       write dest from current inputs",
         "format, fmt                            rewrite Prayfile to recommended destination DSL"
       ].freeze
 
       PACKAGE_COMMANDS = [
         "add <name> [constraint] [--path PATH]  declare a package in Prayfile",
         "remove <name>                          remove a package from Prayfile",
-        "update [package]",
+        "update [package]                       re-resolve packages and git sources within constraints",
         "unlock <package>                       clear a locked package pin",
         "vendor                                 copy resolved packages locally",
         "clean                                  remove local cache and vendor trees"
@@ -43,7 +43,7 @@ module Pray
 
       META_COMMANDS = [
         "init [--targets tool_a,tool_b]         create a starter Prayfile",
-        "prayer init                            scaffold a prayer package",
+        "prayer init [name] [--path DIR]       scaffold a local prayer",
         "repo init                              scaffold a distribution root",
         "manifest                               print canonical Prayfile JSON",
         "package                                build a distributable prayer archive",
@@ -58,33 +58,49 @@ module Pray
 
       COMMAND_HELP = {
         "install" => <<~TEXT.strip,
-          resolve packages, render targets, and update Prayfile.lock
+          keep locked package versions and re-embed listed local compose sources
 
           Usage: pray install [--locked|--frozen|--offline]
 
+          Install renders dest and writes Prayfile.lock. Package versions stay at the lock.
+          Listed local compose files are re-embedded and their span checksums refresh.
+          A path package with spec.upstream copies upstream files when the path tree has no content yet.
+          Use pray update to re-resolve package versions and git sources.
+          Use pray plan to preview a write.
+
           --locked   require an existing lockfile
-          --frozen   require lockfile to match Prayfile exactly
+          --frozen   fail if dest or lock would change
           --offline  use cache only
         TEXT
         "verify" => <<~TEXT.strip,
-          check rendered files against Prayfile.lock
+          compare dest managed spans versus Prayfile.lock
 
           Usage: pray verify [--strict]
 
+          Read-only integrity check. It does not compare dest to a fresh render from current sources.
+          A changed local compose file is clean here when dest and lock still match.
+          Use pray drift to compare dest with a fresh render. Use pray plan to preview a write.
+
           Without --strict, orphan-marker warnings print to stderr but exit 0.
           With --strict, any finding fails with exit code 6.
         TEXT
         "drift" => <<~TEXT.strip,
-          report differences between lockfile and current resolution
+          compare dest versus Prayfile.lock, then dest versus a fresh render
 
           Usage: pray drift [--semantic]
 
+          Read-only finding report from current packages and listed local files. Not a line diff.
           Exits with code 6 when drift is found.
+          Use pray plan to preview a write. Use pray verify for dest versus lock alone.
         TEXT
         "render" => <<~TEXT.strip,
-          render targets without updating the lockfile
+          write dest from current inputs
 
           Usage: pray render [--check]
+
+          Without --check, render writes dest. It does not write Prayfile.lock.
+          Use pray plan to preview a write.
+          --check writes nothing. It fails unless dest already matches a fresh render from current inputs.
         TEXT
         "format" => <<~TEXT.strip,
           rewrite Prayfile to recommended destination DSL
@@ -99,18 +115,25 @@ module Pray
                  pray fmt
         TEXT
         "update" => <<~TEXT.strip,
-          refresh package versions within constraints
+          re-resolve package versions and git sources within current constraints
 
           Usage: pray update [package] [--latest] [--latest --dry-run]
 
+          With no package name, update re-resolves the whole graph within constraints
+          and refreshes git source revisions. A package name unlocks that package only.
+          Path-fork packages can refresh from upstream.
+          Listed local compose files are re-embedded by pray install, not by update.
+
           --latest adjusts constraints to allow the latest package versions.
           --latest also rewrites exact spec.upstream pins in path packages, then refreshes those trees.
           --latest --dry-run prints the planned rewrite and does not write.
         TEXT
         "plan" => <<~TEXT.strip,
-          preview install/apply changes
+          preview what install or apply would write after patch
 
           Usage: pray plan [--remote]
+
+          This is the dry-run of a write. It does not write dest or the lock.
         TEXT
         "apply" => "materialize the current resolution plan\n\nUsage: pray apply",
         "add" => <<~TEXT.strip,
@@ -159,6 +182,8 @@ module Pray
           show constraint vs resolved versions
 
           Usage: pray outdated [--remote]
+
+          Path-fork files that differ from the locked upstream are listed.
         TEXT
         "explain" => <<~TEXT.strip,
           show why a package was selected
@@ -171,7 +196,19 @@ module Pray
 
           Usage: pray init [--targets tool_a,tool_b]
         TEXT
-        "prayer" => "scaffold a prayer package\n\nUsage: pray prayer init",
+        "prayer" => <<~TEXT.strip,
+          scaffold a local prayer under a path source
+
+          Usage: pray prayer init [name] [--path DIR]
+
+          With a Prayfile, writes <name>/ under the path source directory without a version.
+          The default directory is prayers/. Use --path to choose another.
+          Declares pray "<source>/<name>" once, such as pray "local/project", inside compose when a compose block exists.
+          The default name is project. The name v1 is reserved for the distribution layout.
+          Without a Prayfile, writes a versioned package spec in the current directory.
+          Add spec.version before pray package or pray publish.
+          A compose file such as .agents/project.md remains a shortcut for one local file.
+        TEXT
         "repo" => "scaffold a distribution root\n\nUsage: pray repo init",
         "manifest" => "print canonical Prayfile JSON\n\nUsage: pray manifest",
         "package" => "build a distributable prayer archive\n\nUsage: pray package",

data/lib/pray/cli/helpers.rb

@@ -80,11 +80,19 @@ module Pray
 
     def remove_manifest_statement(text, name)
       lines = text.lines.map(&:chomp)
-      package_prefix = "agent \"#{name}\""
-      alternate_prefix = "agent '#{name}'"
+      prefixes = [
+        %(pray "#{name}"),
+        %(pray '#{name}'),
+        %(use "#{name}"),
+        %(include "#{name}"),
+        %(agent "#{name}"),
+        %(agent '#{name}'),
+        %(package "#{name}"),
+        %(package '#{name}')
+      ]
       index = lines.index do |line|
         trimmed = line.lstrip
-        trimmed.start_with?(package_prefix, alternate_prefix)
+        prefixes.any? { |prefix| trimmed.start_with?(prefix) }
       end
       if index
         lines.delete_at(index)
@@ -141,14 +149,14 @@ module Pray
 
     def render_tree_node(package, package_map, depth, ancestry, lines)
       indent = "  " * depth
-      lines << "#{indent}#{package.declaration.name} #{package.spec.version}"
+      lines << "#{indent}#{package.declaration.name} #{package.spec.recorded_version}"
       return unless ancestry.add?(package.declaration.name)
 
       package.spec.dependencies.each do |dependency|
         resolved = package_map[dependency.name]
         if resolved
           if ancestry.include?(resolved.declaration.name)
-            lines << "#{indent}  #{resolved.declaration.name} #{resolved.spec.version} (cycle)"
+            lines << "#{indent}  #{resolved.declaration.name} #{resolved.spec.recorded_version} (cycle)"
           else
             render_tree_node(resolved, package_map, depth + 1, ancestry, lines)
           end

data/lib/pray/cli/parse.rb

@@ -42,7 +42,7 @@ module Pray
       when "prayer"
         raise Error.unsupported("prayer requires init") unless arguments.shift == "init"
 
-        [:prayer_init]
+        [:prayer_init, *parse_prayer_init_arguments(arguments)]
       when "repo"
         raise Error.unsupported("repo requires init") unless arguments.shift == "init"
 
@@ -77,6 +77,26 @@ module Pray
       end
     end
 
+    def parse_prayer_init_arguments(arguments)
+      name = nil
+      directory = nil
+      while (argument = arguments.shift)
+        if argument == "--path"
+          directory = arguments.shift
+          if directory.nil? || directory.start_with?("-")
+            raise Error.usage("--path requires a directory")
+          end
+        elsif argument.start_with?("-")
+          raise Error.unsupported("unexpected prayer argument: #{argument}")
+        elsif name.nil?
+          name = argument
+        else
+          raise Error.unsupported("unexpected prayer argument: #{argument}")
+        end
+      end
+      [name, directory]
+    end
+
     def extract_flag!(arguments, flag)
       found = arguments.include?(flag)
       arguments.reject! { |argument| argument == flag }

data/lib/pray/cli.rb

@@ -9,6 +9,8 @@ require_relative "cli/help"
 require_relative "cli/suggest"
 require_relative "cli/helpers"
 require_relative "cli/commands/init"
+require_relative "cli/commands/init_prayer_manifest"
+require_relative "cli/commands/init_prayer"
 require_relative "cli/commands/workflow"
 require_relative "cli/commands/update_latest"
 require_relative "cli/commands/packages"
@@ -82,7 +84,7 @@ module Pray
       case command
       in [:manifest] then manifest_command
       in [:init, targets] then init_command(targets)
-      in [:prayer_init] then prayer_init_command
+      in [:prayer_init, name, directory] then prayer_init_command(name, directory)
       in [:repo_init] then repo_init_command
       in [:install, flags] then install_command(flags)
       in [:add, add_args] then add_command(**add_args)

data/lib/pray/destination.rb

@@ -16,8 +16,7 @@ module Pray
 
     def local_path_form?(value)
       value.start_with?(".", "/") ||
-        value.end_with?(".md", ".txt", ".markdown") ||
-        !value.include?("/")
+        value.end_with?(".md", ".txt", ".markdown")
     end
 
     def destination_target_name(mode, path)
@@ -106,6 +105,7 @@ module Pray
       if existing.position == "after" && local.position != "after"
         existing.position = local.position
       end
+      existing.file ||= local.file
     end
 
     def bind_package_entry(target, package_name)
@@ -154,5 +154,35 @@ module Pray
       else false
       end
     end
+
+    def local_compose_embed?(manifest, local)
+      return false if local.file
+
+      manifest.targets.none? do |target|
+        target.mode == "tree" &&
+          target.entries.any? { |entry| entry.kind == "local" && entry.path == local.path }
+      end
+    end
+
+    def try_apply_local_pray(manifest, path, file_dest, other_package_signal, destination_index)
+      return false unless local_path_form?(path)
+
+      if file_dest
+        return false if other_package_signal
+        raise Error.parse("manifest", "a local file cannot use file:")
+      end
+      return false if other_package_signal
+      unless destination_index
+        raise Error.parse("manifest", "local pray paths are only valid inside compose")
+      end
+      mode = manifest.targets[destination_index].mode
+      unless mode == "compose"
+        raise Error.parse("manifest", "local pray paths are only valid inside compose")
+      end
+      local = ManifestLocal.new(path: path, bound: true)
+      bind_local_entry(manifest.targets[destination_index], local.path)
+      upsert_local(manifest, local)
+      true
+    end
   end
 end